cc-codeconductor 0.4.0 → 0.4.2

package/README.md

@@ -40,6 +40,9 @@ contracts, task cards, and risk-based routing.
 >   (skills, subagents, commands) for the active or specified target
 > - `npx cc-codeconductor debt-harvest` (alias: `harvest`) — scans source files
 >   for `// defer` comments and writes `.codeconductor/debt-ledger.md`
+> - `npx cc-codeconductor goal "<objective>"` (alias: `cc-goal`) — decomposes an
+>   objective into a dependency-ordered task graph, writes
+>   `.codeconductor/current-goal.yml`
 > - `/cc-pagespeed --url <url>` — audits web performance using the PageSpeed
 >   Insights API; applies the 80/20 principle to produce a prioritized report of
 >   Core Web Vitals (LCP, TBT, CLS, FCP, TTFB) with framework-specific fixes;
@@ -120,21 +123,22 @@ Task Card → Risk Classification → Routing Policy → Conductor Agent → Del
 
 ---
 
-## Current Support (v0.2.0)
+## Current Support
 
 - OpenCode preset
 - Claude Code-compatible preset (see [Claude Environment Options & Best Practices](file:///c:/Users/R2D2/Documents/GitHub/codeconductor/docs/claude-env-options.md))
 - Codex preset
 - Spring Boot / Kotlin workflow
 - Python / Django workflow guidance
-- 10 core Conductor Agents
-- Routing Policy v0.2.0
+- 12 core Conductor Agents
+- Routing Policy v0.3.0
 - Task Card template
 - Scorecard template
 - End-to-end example
 - YAML-driven model configuration
 - Provider-agnostic `AgentContract` abstraction with target renderers for Claude, OpenCode, Codex, and Agy
 - Council consensus engine (`councilConsensus()`) for multi-agent governance with majority/unanimous algorithms and security veto
+- Phase 5 runtime modules — scoped context injection, TDD history compaction, concise inter-agent messaging, and token budget enforcement in the compile-fix loop
 
 ---
 
@@ -300,6 +304,20 @@ into `.codeconductor/debt-ledger.md`, grouped by optional tag
 Supported extensions: `.ts`, `.tsx`, `.js`, `.jsx`, `.go`, `.rs`, `.java`,
 `.kt`, `.swift`, `.cs`, `.php`, `.scala`, `.dart`, `.c`, `.cpp`, `.h`, `.hpp`.
 
+#### `goal` — decompose objective into task graph
+
+```bash
+npx cc-codeconductor goal "Add user authentication"
+npx cc-codeconductor goal "Implement CRUD for invoices"
+npx cc-codeconductor cc-goal "Add search with filters"   # alias
+npx cc-codeconductor goal "Add user authentication" --output json
+```
+
+Matches the objective against built-in templates (auth, crud, search,
+notification, migration) or falls back to a generic 4-task chain. Writes the
+resulting task graph to `.codeconductor/current-goal.yml` with dependency
+ordering. The orchestrator uses this file to delegate tasks in dependency order.
+
 
 ### Global options
 
@@ -404,9 +422,14 @@ codeconductor/
 ├── src/                    ← CLI source (TypeScript + Bun)
 │   ├── cli/                ← entry point, router, error codes
 │   ├── commands/           ← init, detect, install, doctor, update
-│   ├── core/               ← config, detection, filesystem, presets
+│   ├── core/               ← config, detection, filesystem, presets, goal
+│   │   ├── context/        ← scoped context injection (Phase 5)
+│   │   ├── compaction/     ← TDD history compaction hook (Phase 5)
+│   │   ├── messages/       ← concise inter-agent formatter (Phase 5)
+│   │   └── loop/           ← compile-fix loop controller (Phase 5)
 │   ├── adapters/           ← opencode, claude, codex generators
 │   ├── domain/council/     ← council spec, agent, contract
+│   ├── domain/loop/        ← loop state machine
 │   ├── validation/         ← Zod schemas
 │   ├── utils/              ← Result type, logger, invariant
 │   └── presets/council/    ← bundled council.yml preset

package/dist/index.js

@@ -11126,7 +11126,7 @@ function validateCouncilSpec(data) {
 function validateConfig(data) {
   return CodeConductorConfigSchema.parse(data);
 }
-var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, ContractTargetSchema, ContractFormatSchema, AgentContractSchema, CouncilFindingSchema, CouncilVerdictInputSchema, ConsensusConfigSchema, CouncilVerdictSchema, ClaudeAgentFileSchema, OpenCodeAgentFileSchema, SentryStackFrameSchema, SentryWebhookSchema;
+var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, ContractTargetSchema, ContractFormatSchema, AgentContractSchema, CouncilFindingSchema, CouncilVerdictInputSchema, ConsensusConfigSchema, CouncilVerdictSchema, ClaudeAgentFileSchema, OpenCodeAgentFileSchema, SentryStackFrameSchema, SentryWebhookSchema, GoalTaskSchema, GoalGraphSchema;
 var init_schemas = __esm(() => {
   init_zod();
   CouncilAgentSpecSchema = exports_external.object({
@@ -11167,7 +11167,11 @@ var init_schemas = __esm(() => {
   LoopConfigSchema = exports_external.object({
     enabled: exports_external.boolean().optional().default(true),
     maxIterations: exports_external.number().int().positive().optional().default(3),
-    maxTokenBudget: exports_external.number().nonnegative().optional().default(0)
+    maxTokenBudget: exports_external.number().nonnegative().optional().default(0),
+    compaction: exports_external.object({
+      enabled: exports_external.boolean().optional().default(true),
+      historyFile: exports_external.string().optional()
+    }).optional()
   });
   CodeConductorConfigSchema = exports_external.object({
     version: exports_external.string(),
@@ -11309,6 +11313,22 @@ var init_schemas = __esm(() => {
     environment: exports_external.string().optional(),
     release: exports_external.string().optional()
   });
+  GoalTaskSchema = exports_external.object({
+    id: exports_external.string(),
+    title: exports_external.string(),
+    type: exports_external.enum(["feature", "fix", "refactor", "test", "docs"]),
+    risk: exports_external.enum(["low", "medium", "high"]),
+    status: exports_external.enum(["pending", "in-progress", "done", "blocked"]),
+    depends_on: exports_external.array(exports_external.string()).optional().default([]),
+    acceptance_criteria: exports_external.array(exports_external.string()),
+    blocked_reason: exports_external.string().optional(),
+    context_scope: exports_external.enum(["isolated", "continuation", "full"]).optional().default("isolated")
+  });
+  GoalGraphSchema = exports_external.object({
+    objective: exports_external.string(),
+    tasks: exports_external.array(GoalTaskSchema),
+    created_at: exports_external.string()
+  });
 });
 
 // src/core/presets/package-paths.ts
@@ -12000,10 +12020,9 @@ var init_agy_installer = __esm(() => {
 
 // src/core/filesystem/credential-guard.ts
 import { readFile as readFile7 } from "node:fs/promises";
-import { resolve as resolve6 } from "node:path";
 async function loadPolicyPatterns() {
   try {
-    const content = await readFile7(POLICY_PATH2, "utf-8");
+    const content = await readFile7(POLICY_PATH, "utf-8");
     const parsed = $parse(content);
     if (Array.isArray(parsed.secretPatterns) && parsed.secretPatterns.length > 0) {
       return parsed.secretPatterns;
@@ -12035,9 +12054,10 @@ async function loadCredentialPatterns(config) {
   }
   return DEFAULT_SECRET_PATTERNS;
 }
-var DEFAULT_SECRET_PATTERNS, POLICY_PATH2;
+var DEFAULT_SECRET_PATTERNS;
 var init_credential_guard = __esm(() => {
   init_dist();
+  init_package_paths();
   DEFAULT_SECRET_PATTERNS = [
     "password",
     "secret",
@@ -12048,7 +12068,6 @@ var init_credential_guard = __esm(() => {
     "auth[_-]?token",
     "private[_-]?key"
   ];
-  POLICY_PATH2 = resolve6(import.meta.dir, "..", "..", "..", "policy.yml");
 });
 
 // src/core/filesystem/file-writer.ts
@@ -12135,7 +12154,7 @@ init_errors();
 // package.json
 var package_default = {
   name: "cc-codeconductor",
-  version: "0.4.0",
+  version: "0.4.2",
   description: "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
   keywords: [
     "ai",
@@ -13057,7 +13076,8 @@ function renderTemplate(content, modelConfig, filePath, locale = "en") {
     "tester",
     "reviewer",
     "docs",
-    "repo-explorer"
+    "repo-explorer",
+    "goal-planner"
   ];
   let result = templatedContent;
   for (const role of knownRoles) {
@@ -13145,8 +13165,20 @@ function injectMcpServers(jsonString, filePath) {
     if (isClaudeSettings || isAgyMcpConfig) {
       obj.mcpServers = mergeDeep(obj.mcpServers || {}, mcpServers);
     } else if (isOpencodeJsonc) {
-      obj.mcp = obj.mcp || {};
-      obj.mcp.servers = mergeDeep(obj.mcp.servers || {}, mcpServers);
+      const opencodeMcp = {};
+      for (const [key, server] of Object.entries(mcpServers)) {
+        const commandArray = typeof server.command === "string" ? [server.command, ...server.args || []] : server.command;
+        const formattedServer = {
+          type: "local",
+          command: commandArray,
+          enabled: true
+        };
+        if (server.env) {
+          formattedServer.environment = server.env;
+        }
+        opencodeMcp[key] = formattedServer;
+      }
+      obj.mcp = mergeDeep(obj.mcp || {}, opencodeMcp);
     }
     return JSON.stringify(obj, null, 2);
   } catch {
@@ -13800,13 +13832,13 @@ async function doctorCommand(options) {
 // src/commands/init.command.ts
 import { access as access3, mkdir as mkdir3, readFile as readFile8, writeFile as writeFile3 } from "node:fs/promises";
 import { homedir as homedir5 } from "node:os";
-import { basename, resolve as resolve8 } from "node:path";
+import { basename, resolve as resolve7 } from "node:path";
 
 // src/core/config/config-writer.ts
 init_dist();
 init_errors();
 import { access as access2, mkdir as mkdir2, writeFile as writeFile2 } from "node:fs/promises";
-import { resolve as resolve7 } from "node:path";
+import { resolve as resolve6 } from "node:path";
 
 // src/core/config/codeconductor-config.ts
 init_credential_guard();
@@ -13847,9 +13879,9 @@ var CONFIG_DIR = ".codeconductor";
 var CONFIG_FILE2 = "config.yml";
 async function writeConfig(projectRoot, config = {}, force = false) {
   try {
-    const configDir = resolve7(projectRoot, CONFIG_DIR);
+    const configDir = resolve6(projectRoot, CONFIG_DIR);
     await mkdir2(configDir, { recursive: true });
-    const configPath = resolve7(configDir, CONFIG_FILE2);
+    const configPath = resolve6(configDir, CONFIG_FILE2);
     if (!force) {
       try {
         await access2(configPath);
@@ -14075,7 +14107,7 @@ async function initCommand(options) {
 }
 async function resolvePresetsToCopy() {
   const sources = [];
-  const bundledCouncil = resolve8(SRC_PRESETS_DIR, "council", "council.yml");
+  const bundledCouncil = resolve7(SRC_PRESETS_DIR, "council", "council.yml");
   if (await fileExists2(bundledCouncil)) {
     sources.push({ name: "council.yml", sourcePath: bundledCouncil });
   }
@@ -14086,11 +14118,11 @@ async function resolvePresetsToCopy() {
   return sources;
 }
 async function copyPresets(baseDir, presets, force) {
-  const presetsDir = resolve8(baseDir, ".codeconductor", "presets");
+  const presetsDir = resolve7(baseDir, ".codeconductor", "presets");
   await mkdir3(presetsDir, { recursive: true });
   const copied = [];
   for (const preset of presets) {
-    const destPath = resolve8(presetsDir, preset.name);
+    const destPath = resolve7(presetsDir, preset.name);
     if (!force && await fileExists2(destPath)) {
       continue;
     }
@@ -14123,7 +14155,7 @@ init_claude_installer();
 init_codex_installer();
 init_opencode_installer();
 import { homedir as homedir6 } from "node:os";
-import { resolve as resolve9 } from "node:path";
+import { resolve as resolve8 } from "node:path";
 init_file_writer();
 init_preset_loader();
 
@@ -14193,12 +14225,12 @@ async function installCommand(options) {
         let targetPath = f.path;
         let targetBase = baseDir;
         if ((t === "agy" || t === "gemini") && isGlobal) {
-          targetBase = resolve9(homedir6(), ".gemini", "config");
+          targetBase = resolve8(homedir6(), ".gemini", "config");
           targetPath = targetPath.replace(/^\.agents\/?/, "");
         }
         return {
           ...f,
-          path: resolve9(targetBase, targetPath)
+          path: resolve8(targetBase, targetPath)
         };
       });
       const results = await writeGeneratedFiles(resolvedFiles, writeOptions);
@@ -14309,7 +14341,7 @@ async function installPresetCommand(options) {
 
 // src/commands/install-lsp.command.ts
 import { homedir as homedir8 } from "node:os";
-import { resolve as resolve10 } from "node:path";
+import { resolve as resolve9 } from "node:path";
 
 // src/core/lsp/lsp-config-utils.ts
 function getLanguageServerConfig(lspIds) {
@@ -14846,7 +14878,7 @@ async function installLspCommand(options) {
       const generatedFiles = generator.generate(installReport.results);
       const resolvedFiles = generatedFiles.map((f) => ({
         ...f,
-        path: resolve10(baseDir, f.path)
+        path: resolve9(baseDir, f.path)
       }));
       const results = await writeGeneratedFiles(resolvedFiles, writeOptions);
       for (const result of results) {
@@ -15081,6 +15113,522 @@ async function debtHarvestCommand(options) {
   }
 }
 
+// src/core/goal/goal-planner.ts
+var TEMPLATES = [
+  {
+    keywords: ["login", "auth", "authentication", "signin", "sign-in"],
+    tasks: [
+      {
+        id: "auth-schema",
+        title: "Define auth data model and DB schema",
+        type: "feature",
+        risk: "high",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: [],
+        acceptance_criteria: [
+          "User entity with email, password_hash, created_at fields",
+          "Migration script creates users table",
+          "Schema supports password reset token"
+        ]
+      },
+      {
+        id: "auth-api",
+        title: "Define auth API contract",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["auth-schema"],
+        acceptance_criteria: [
+          "POST /auth/register endpoint defined",
+          "POST /auth/login endpoint defined",
+          "POST /auth/logout endpoint defined",
+          "OpenAPI spec updated"
+        ]
+      },
+      {
+        id: "auth-impl",
+        title: "Implement auth endpoints",
+        type: "feature",
+        risk: "high",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["auth-api"],
+        acceptance_criteria: [
+          "Register endpoint hashes password and stores user",
+          "Login endpoint validates credentials and returns session",
+          "Logout endpoint invalidates session",
+          "Input validation on all endpoints"
+        ]
+      },
+      {
+        id: "auth-tests",
+        title: "Write auth tests",
+        type: "test",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["auth-impl"],
+        acceptance_criteria: [
+          "Unit tests for password hashing",
+          "Integration tests for register/login/logout flow",
+          "Edge cases: duplicate email, invalid password, expired token"
+        ]
+      }
+    ]
+  },
+  {
+    keywords: ["crud", "resource", "api", "endpoint", "rest"],
+    tasks: [
+      {
+        id: "crud-model",
+        title: "Define data model and schema",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: [],
+        acceptance_criteria: [
+          "Entity definition with required fields",
+          "Database migration script",
+          "Schema follows project conventions"
+        ]
+      },
+      {
+        id: "crud-service",
+        title: "Implement repository/service layer",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["crud-model"],
+        acceptance_criteria: [
+          "Create, Read (list + by id), Update, Delete operations",
+          "Input validation",
+          "Error handling for not-found and conflict"
+        ]
+      },
+      {
+        id: "crud-api",
+        title: "Implement API endpoints",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["crud-service"],
+        acceptance_criteria: [
+          "REST endpoints for all CRUD operations",
+          "Proper HTTP status codes",
+          "Request/response schemas"
+        ]
+      },
+      {
+        id: "crud-tests",
+        title: "Write tests",
+        type: "test",
+        risk: "low",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["crud-api"],
+        acceptance_criteria: [
+          "Unit tests for service layer",
+          "Integration tests for API endpoints",
+          "Edge cases covered"
+        ]
+      }
+    ]
+  },
+  {
+    keywords: ["search", "filter", "query", "full-text", "fts"],
+    tasks: [
+      {
+        id: "search-schema",
+        title: "Design search schema and indexing strategy",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: [],
+        acceptance_criteria: [
+          "Search index definition",
+          "Indexing strategy documented",
+          "Performance requirements defined"
+        ]
+      },
+      {
+        id: "search-service",
+        title: "Implement search service",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["search-schema"],
+        acceptance_criteria: [
+          "Full-text search with ranking",
+          "Filter support",
+          "Pagination"
+        ]
+      },
+      {
+        id: "search-api",
+        title: "Implement search API",
+        type: "feature",
+        risk: "low",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["search-service"],
+        acceptance_criteria: [
+          "GET /search endpoint with query params",
+          "Response includes results + metadata",
+          "Rate limiting applied"
+        ]
+      },
+      {
+        id: "search-tests",
+        title: "Write search tests",
+        type: "test",
+        risk: "low",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["search-api"],
+        acceptance_criteria: [
+          "Unit tests for search logic",
+          "Integration tests with sample data",
+          "Performance test for large datasets"
+        ]
+      }
+    ]
+  },
+  {
+    keywords: ["notification", "email", "alert", "push", "notify"],
+    tasks: [
+      {
+        id: "notif-model",
+        title: "Design notification data model",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: [],
+        acceptance_criteria: [
+          "Notification entity with type, payload, status, user_id",
+          "Database migration",
+          "Enum for notification types"
+        ]
+      },
+      {
+        id: "notif-service",
+        title: "Implement notification service",
+        type: "feature",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["notif-model"],
+        acceptance_criteria: [
+          "Send notification by type",
+          "Queue-based delivery",
+          "Retry logic for failed deliveries"
+        ]
+      },
+      {
+        id: "notif-api",
+        title: "Implement notification API",
+        type: "feature",
+        risk: "low",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["notif-service"],
+        acceptance_criteria: [
+          "POST /notifications endpoint",
+          "GET /notifications endpoint with read/unread filter",
+          "PATCH /notifications/:id/read endpoint"
+        ]
+      },
+      {
+        id: "notif-tests",
+        title: "Write notification tests",
+        type: "test",
+        risk: "low",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["notif-api"],
+        acceptance_criteria: [
+          "Unit tests for notification logic",
+          "Integration tests for API",
+          "Edge cases: invalid type, missing user"
+        ]
+      }
+    ]
+  },
+  {
+    keywords: ["migration", "migrate", "schema change", "database change", "column"],
+    tasks: [
+      {
+        id: "migrate-script",
+        title: "Write migration script",
+        type: "feature",
+        risk: "high",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: [],
+        acceptance_criteria: [
+          "Migration is reversible",
+          "Handles existing data gracefully",
+          "Rollback script included"
+        ]
+      },
+      {
+        id: "migrate-model",
+        title: "Update domain model",
+        type: "refactor",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["migrate-script"],
+        acceptance_criteria: [
+          "Domain model reflects new schema",
+          "Existing code paths updated",
+          "Backward compatibility maintained"
+        ]
+      },
+      {
+        id: "migrate-dal",
+        title: "Update data access layer",
+        type: "refactor",
+        risk: "medium",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["migrate-model"],
+        acceptance_criteria: [
+          "Repository/service reads/writes new schema",
+          "No broken queries",
+          "Performance not degraded"
+        ]
+      },
+      {
+        id: "migrate-tests",
+        title: "Write migration tests",
+        type: "test",
+        risk: "high",
+        status: "pending",
+        context_scope: "isolated",
+        depends_on: ["migrate-dal"],
+        acceptance_criteria: [
+          "Migration up/down test",
+          "Data integrity test",
+          "Integration tests with new schema"
+        ]
+      }
+    ]
+  }
+];
+var GENERIC_TEMPLATE = [
+  {
+    id: "plan-scope",
+    title: "Clarify requirements and scope",
+    type: "feature",
+    risk: "low",
+    status: "pending",
+    context_scope: "isolated",
+    depends_on: [],
+    acceptance_criteria: ["Objective is well-defined", "Scope boundaries identified"]
+  },
+  {
+    id: "plan-design",
+    title: "Design technical approach",
+    type: "feature",
+    risk: "medium",
+    status: "pending",
+    context_scope: "isolated",
+    depends_on: ["plan-scope"],
+    acceptance_criteria: ["Architecture decisions documented", "API contracts defined"]
+  },
+  {
+    id: "plan-impl",
+    title: "Implement solution",
+    type: "feature",
+    risk: "medium",
+    status: "pending",
+    context_scope: "isolated",
+    depends_on: ["plan-design"],
+    acceptance_criteria: ["Core functionality implemented", "Follows project conventions"]
+  },
+  {
+    id: "plan-tests",
+    title: "Write tests and verify",
+    type: "test",
+    risk: "low",
+    status: "pending",
+    context_scope: "isolated",
+    depends_on: ["plan-impl"],
+    acceptance_criteria: ["Unit tests pass", "Integration tests pass", "No regressions"]
+  }
+];
+function matchTemplate(objective) {
+  const lower = objective.toLowerCase();
+  for (const template of TEMPLATES) {
+    const matched = template.keywords.some((kw) => lower.includes(kw));
+    if (matched)
+      return template.tasks;
+  }
+  return GENERIC_TEMPLATE;
+}
+function planGoal(objective) {
+  const tasks = matchTemplate(objective);
+  return {
+    objective,
+    tasks: tasks.map((t) => ({ ...t, status: "pending" })),
+    created_at: new Date().toISOString()
+  };
+}
+
+// src/core/goal/goal-state.ts
+init_dist();
+init_schemas();
+import { mkdir as mkdir7, readFile as readFile10, writeFile as writeFile6 } from "node:fs/promises";
+import { resolve as resolve10 } from "node:path";
+function validateGoalGraph(graph) {
+  const ids = new Set(graph.tasks.map((t) => t.id));
+  if (ids.size !== graph.tasks.length) {
+    return err(new Error("Duplicate task IDs in goal graph"));
+  }
+  for (const task of graph.tasks) {
+    for (const dep of task.depends_on ?? []) {
+      if (!ids.has(dep)) {
+        return err(new Error(`Task "${task.id}" depends on unknown task "${dep}"`));
+      }
+    }
+  }
+  const visited = new Set;
+  const inStack = new Set;
+  function dfs(taskId) {
+    if (inStack.has(taskId))
+      return true;
+    if (visited.has(taskId))
+      return false;
+    visited.add(taskId);
+    inStack.add(taskId);
+    const task = graph.tasks.find((t) => t.id === taskId);
+    if (task) {
+      for (const dep of task.depends_on ?? []) {
+        if (dfs(dep))
+          return true;
+      }
+    }
+    inStack.delete(taskId);
+    return false;
+  }
+  for (const task of graph.tasks) {
+    if (dfs(task.id)) {
+      return err(new Error(`Cycle detected involving task "${task.id}"`));
+    }
+  }
+  return ok(graph);
+}
+async function writeGoal(projectRoot, graph) {
+  const validation = validateGoalGraph(graph);
+  if (!validation.success)
+    return validation;
+  const dir = resolve10(projectRoot, ".codeconductor");
+  await mkdir7(dir, { recursive: true });
+  const yaml = $stringify(graph);
+  await writeFile6(resolve10(dir, "current-goal.yml"), yaml, "utf-8");
+  return ok(undefined);
+}
+
+// src/commands/goal.command.ts
+function renderDependencyTree(tasks) {
+  const lines = [];
+  const taskMap = new Map(tasks.map((t) => [t.id, t]));
+  const roots = tasks.filter((t) => !t.depends_on || t.depends_on.length === 0);
+  function render(taskId, prefix, isLast) {
+    const task = taskMap.get(taskId);
+    if (!task)
+      return;
+    const connector = isLast ? "└── " : "├── ";
+    const label = `${task.id}: ${task.title}`;
+    lines.push(`${prefix}${connector}${label}`);
+    const children = tasks.filter((t) => t.depends_on && t.depends_on.includes(taskId));
+    const childPrefix = prefix + (isLast ? "    " : "│   ");
+    children.forEach((child, i) => {
+      render(child.id, childPrefix, i === children.length - 1);
+    });
+  }
+  roots.forEach((root, i) => {
+    render(root.id, "", i === roots.length - 1);
+  });
+  return lines.join(`
+`);
+}
+async function goalCommand(options) {
+  const { objective, projectRoot, output } = options;
+  if (!objective || objective.trim().length === 0) {
+    return {
+      code: 1,
+      data: {
+        success: false,
+        command: "goal",
+        errors: ['Objective is required. Usage: codeconductor goal "<objective>"']
+      }
+    };
+  }
+  try {
+    const graph = planGoal(objective);
+    const writeResult = await writeGoal(projectRoot, graph);
+    if (!writeResult.success) {
+      return {
+        code: 1,
+        data: {
+          success: false,
+          command: "goal",
+          errors: [`Failed to write goal: ${writeResult.error.message}`]
+        }
+      };
+    }
+    if (output === "json") {
+      return {
+        code: 0,
+        data: {
+          success: true,
+          command: "goal",
+          objective: graph.objective,
+          tasks: graph.tasks,
+          file: ".codeconductor/current-goal.yml"
+        }
+      };
+    }
+    const tree = renderDependencyTree(graph.tasks);
+    const lines = [
+      `Objective: ${graph.objective}`,
+      "",
+      "Task dependency graph:",
+      tree,
+      "",
+      `Tasks: ${graph.tasks.length} total`,
+      `File: .codeconductor/current-goal.yml`
+    ];
+    return {
+      code: 0,
+      data: {
+        success: true,
+        command: "goal",
+        output: lines.join(`
+`)
+      }
+    };
+  } catch (e) {
+    return {
+      code: 1,
+      data: {
+        success: false,
+        command: "goal",
+        errors: [e instanceof Error ? e.message : String(e)]
+      }
+    };
+  }
+}
+
 // src/commands/help.command.ts
 import { readdir as readdir3 } from "node:fs/promises";
 import { join as join8 } from "node:path";
@@ -15208,7 +15756,7 @@ async function helpCommand(options) {
 }
 
 // src/commands/seo-audit.command.ts
-import { writeFile as writeFile6, mkdir as mkdir7 } from "node:fs/promises";
+import { writeFile as writeFile7, mkdir as mkdir8 } from "node:fs/promises";
 import { dirname as dirname4, resolve as resolve11 } from "node:path";
 
 // src/infrastructure/http/safe-fetch.ts
@@ -16501,13 +17049,13 @@ async function seoAuditCommand(options) {
     }
     if (output) {
       const outputPath = resolve11(options.projectRoot, output);
-      await mkdir7(dirname4(outputPath), { recursive: true });
-      await writeFile6(outputPath, formattedOutput, "utf-8");
+      await mkdir8(dirname4(outputPath), { recursive: true });
+      await writeFile7(outputPath, formattedOutput, "utf-8");
     } else if (format === "markdown") {
       const timestamp = new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
       const defaultPath = resolve11(options.projectRoot, "seo-reports", `audit-report-${timestamp}.md`);
-      await mkdir7(dirname4(defaultPath), { recursive: true });
-      await writeFile6(defaultPath, formattedOutput, "utf-8");
+      await mkdir8(dirname4(defaultPath), { recursive: true });
+      await writeFile7(defaultPath, formattedOutput, "utf-8");
       process.stderr.write(`Report saved to: ${defaultPath}
 `);
     }
@@ -16535,7 +17083,7 @@ async function seoAuditCommand(options) {
 }
 
 // src/commands/seo-llms.command.ts
-import { writeFile as writeFile7, mkdir as mkdir8 } from "node:fs/promises";
+import { writeFile as writeFile8, mkdir as mkdir9 } from "node:fs/promises";
 import { dirname as dirname5, resolve as resolve12 } from "node:path";
 
 // src/domain/seo/llms-generator.ts
@@ -16680,8 +17228,8 @@ async function seoLlmsCommand(options) {
     }) : await generateLlmsTxtFromUrl(url);
     process.stderr.write("\r" + " ".repeat(80) + "\r");
     const outputPath = output ? resolve12(options.projectRoot, output) : resolve12(options.projectRoot, "llms.txt");
-    await mkdir8(dirname5(outputPath), { recursive: true });
-    await writeFile7(outputPath, result.content, "utf-8");
+    await mkdir9(dirname5(outputPath), { recursive: true });
+    await writeFile8(outputPath, result.content, "utf-8");
     process.stderr.write(`Generated: ${outputPath} (${result.entries.length} entries)
 `);
     return {
@@ -16709,7 +17257,7 @@ async function seoLlmsCommand(options) {
 // src/commands/update.command.ts
 import { homedir as homedir9 } from "node:os";
 import { resolve as resolve13, dirname as dirname6 } from "node:path";
-import { mkdir as mkdir9, readFile as readFile10, writeFile as writeFile8, stat as stat3 } from "node:fs/promises";
+import { mkdir as mkdir10, readFile as readFile11, writeFile as writeFile9, stat as stat3 } from "node:fs/promises";
 init_package_paths();
 async function updateCommand(options) {
   const { dryRun, force, global: isGlobal, output, projectRoot } = options;
@@ -16778,9 +17326,9 @@ async function updateCommand(options) {
       const localCouncil = resolve13(basePath, ".codeconductor", "presets", "council.yml");
       const bundledCouncil = resolve13(SRC_PRESETS_DIR, "council", "council.yml");
       try {
-        const content = await readFile10(bundledCouncil, "utf-8");
-        await mkdir9(dirname6(localCouncil), { recursive: true });
-        await writeFile8(localCouncil, content, "utf-8");
+        const content = await readFile11(bundledCouncil, "utf-8");
+        await mkdir10(dirname6(localCouncil), { recursive: true });
+        await writeFile9(localCouncil, content, "utf-8");
         updated.push(localCouncil);
       } catch (e) {
         throw new Error(`Failed to update council.yml: ${e}`);
@@ -16789,9 +17337,9 @@ async function updateCommand(options) {
     if (updateResults.policy) {
       const localPolicy = resolve13(basePath, ".codeconductor", "presets", "policy.yml");
       try {
-        const content = await readFile10(POLICY_PATH, "utf-8");
-        await mkdir9(dirname6(localPolicy), { recursive: true });
-        await writeFile8(localPolicy, content, "utf-8");
+        const content = await readFile11(POLICY_PATH, "utf-8");
+        await mkdir10(dirname6(localPolicy), { recursive: true });
+        await writeFile9(localPolicy, content, "utf-8");
         updated.push(localPolicy);
       } catch (e) {
         throw new Error(`Failed to update policy.yml: ${e}`);
@@ -16887,8 +17435,8 @@ async function updateCommand(options) {
         }
       } catch {}
       try {
-        await mkdir9(dirname6(lockDest), { recursive: true });
-        await writeFile8(lockDest, JSON.stringify(newSkillsLock, null, 2), "utf-8");
+        await mkdir10(dirname6(lockDest), { recursive: true });
+        await writeFile9(lockDest, JSON.stringify(newSkillsLock, null, 2), "utf-8");
         updated.push(lockDest);
       } catch (e) {
         throw new Error(`Failed to write skills-lock.json: ${e}`);
@@ -16999,6 +17547,7 @@ Commands:
   update                 Update installed presets
   help / cc-help         Show preset inventory (skills, subagents, commands)
   debt-harvest / harvest Scan source files for deferred debt items
+  goal / cc-goal        Plan goal into task graph with dependencies
 
 Options:
   --help, -h             Show this help message
@@ -17124,6 +17673,13 @@ async function routeCommand(args, projectRoot) {
         dir: options.dir,
         output: flags.output
       });
+    case "goal":
+    case "cc-goal":
+      return goalCommand({
+        objective: subcommand || options.objective || "",
+        projectRoot,
+        output: flags.output
+      });
     case "seo": {
       if (subcommand === "audit") {
         return seoAuditCommand({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-codeconductor",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
   "keywords": [
     "ai",

package/presets/agy/AGENTS.md

@@ -248,6 +248,30 @@ High-risk checkpoint: [yes | no — if yes, describe what triggers a stop]
 
 ---
 
+### goal-planner
+
+**Role:** Transforms an objective string into a YAML task graph with dependencies. Pure function: objective → GoalGraph. No side effects.
+
+**Use when:** User runs `codeconductor goal "<objective>"` or the orchestrator needs a multi-step plan before delegation.
+
+**Permissions:**
+- read: `allow`
+- edit: `deny`
+- bash: `deny`
+- network: `deny`
+
+**Model:** `{{MODEL_GEMINI}}`
+
+**Does not:** Write files. Execute commands. Make routing decisions.
+
+**Template matching:**
+The planner matches objective keywords against built-in templates (auth, crud, search, notification, migration) and falls back to a generic 4-task chain: task-coach → architect → implementer → tester.
+
+**Dependency order delegation (orchestrator):**
+When the orchestrator receives a GoalGraph, it delegates tasks in dependency order. A task is only routed after all its `depends_on` targets complete with status `done`. If a dependency is `blocked`, the dependent task remains `pending`. The orchestrator tracks the graph state in `.codeconductor/current-goal.yml`.
+
+---
+
 ### architect
 
 **Role:** Designs the technical approach. Produces ADRs, module boundaries, and API contracts.

package/presets/codex/AGENTS.md

@@ -790,6 +790,40 @@ module, or identifying the impact radius of a change.
 
 ---
 
+### goal-planner
+
+**Role:** Transforms an objective string into a YAML task graph with
+dependencies. Pure function: objective → GoalGraph. No side effects.
+
+**Use when:** User runs `codeconductor goal "<objective>"` or the orchestrator
+needs a multi-step plan before delegation.
+
+**Permissions:**
+
+- read: `allow`
+- edit: `deny`
+- bash: `deny`
+- network: `deny`
+
+**Does not:** Write files. Execute commands. Make routing decisions.
+
+**Template matching:**
+
+The planner matches objective keywords against built-in templates (auth, crud,
+search, notification, migration) and falls back to a generic 4-task chain:
+`task-coach → architect → implementer → tester`.
+
+**Dependency order delegation (orchestrator):**
+
+When the orchestrator receives a GoalGraph, it delegates tasks in dependency
+order. A task is only routed after all its `depends_on` targets complete with
+status `done`. If a dependency is `blocked`, the dependent task remains `pending`.
+The orchestrator tracks the graph state in `.codeconductor/current-goal.yml`.
+
+**Model:** `{{MODEL_CODEX}}`
+
+---
+
 ## Hard Rules (all agents)
 
 These apply regardless of agent or task.

package/src/presets/models/agy.yml

@@ -57,6 +57,13 @@ agents:
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
     agy: gemini-2.5-flash
+  goal-planner:
+    claude: claude-haiku-4-5-20251001
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4-mini
+    gemini: gemini-2.5-flash
+    cursor: gpt-5.4-mini
+    agy: gemini-2.5-flash
 tools:
   Read:
     agy: view_file

package/src/presets/models/claude.yml

@@ -51,6 +51,12 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  goal-planner:
+    claude: claude-haiku-4-5-20251001
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4-mini
+    gemini: gemini-2.5-flash
+    cursor: gpt-5.4-mini
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/codex.yml

@@ -52,6 +52,12 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  goal-planner:
+    claude: claude-haiku-4-5-20251001
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4-mini
+    gemini: gemini-2.5-flash
+    cursor: gpt-5.4-mini
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/cursor.yml

@@ -51,6 +51,12 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  goal-planner:
+    claude: claude-haiku-4-5-20251001
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4-mini
+    gemini: gemini-2.5-flash
+    cursor: gpt-5.4-mini
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/gemini.yml

@@ -51,6 +51,12 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  goal-planner:
+    claude: claude-haiku-4-5-20251001
+    opencode: opencode-go/qwen3.6-plus
+    codex: gpt-5.4-mini
+    gemini: gemini-2.5-flash
+    cursor: gpt-5.4-mini
 tools:
   Read:
     claude: ViewCodeItem / ReadFile

package/src/presets/models/opencode.yml

@@ -51,6 +51,12 @@ agents:
     codex: gpt-5.4-mini
     gemini: gemini-2.5-flash
     cursor: gpt-5.4-mini
+  goal-planner:
+    claude: claude-haiku-4-5-20251001
+    opencode: opencode-go/deepseek-v4-flash
+    codex: gpt-5.4-mini
+    gemini: gemini-2.5-flash
+    cursor: gpt-5.4-mini
 permissions:
   Read: read
   Write: edit