Cognotik | HierarchicalPlanningMode

⚙️ OrchestrationConfig.json


{
  "mode": "HierarchicalPlanningMode",
  "maxConcurrency": 4,
  "maxIterations": 200,
  "model_config": {
    "smart": "gpt-4-turbo",
    "fast": "gpt-4o-mini"
  }
}

→

🌳 Live Goal Tree

🟢 G1: Build Web Scraper

✅ G2: Research Target Site

⏳ G3: Implement Parser Waiting: G2

🏃 T1: Setup Project Running

[System] Iteration 4: Decomposing G3...
[System] Submitting T1 to FixedConcurrencyProcessor...

The Decompose-Delegate Loop

The mode operates in a continuous loop until the root goal is achieved or a stop is requested.

Decomposition: Active goals are sent to the LLM to be broken down into SubGoals or executable Tasks.
Dependency Resolution: The engine calculates the dependency graph. Tasks are only moved to PENDING once all prerequisite IDs are COMPLETED.
Parallel Execution: A FixedConcurrencyProcessor pulls pending tasks and executes them across available worker threads.
Reflection: As tasks complete, the engine re-evaluates the status of parent goals.

Status	Type	Description
`ACTIVE_DEPENDENCY_WAIT`	Both	The item is blocked by external dependencies (other IDs).
`ACTIVE`	Goal	Ready for decomposition or has active children.
`PENDING`	Task	Dependencies met; queued for execution.
`BLOCKED`	Goal	A child task failed or decomposition yielded no actions.
`SKIPPED`	Both	Automatically set if a circular dependency is detected.

Implementation Parameters


class HierarchicalPlanningMode(
    val maxConcurrency: Int = 4,   // Max parallel tasks
    val maxIterations: Int = 200,  // Safety cutoff
    val describer: TaskContextYamlDescriber
) : CognitiveMode(...)

Key Features:

Circular Dependency Detection: Uses a DFS-based cycle detector to prevent deadlocks.
State Persistence: Automatically saves planning_state.json to the session directory, allowing sessions to be resumed.
Tabbed Observability: Provides real-time views for the Goal Tree, Task Summaries, and a detailed Session Log.

The Decompose-Delegate Loop

Lifecycle Statuses

Implementation Parameters