cc-codeconductor 1.4.2 → 1.5.1

package/dist/index.js

@@ -72,7 +72,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "cc-codeconductor",
-    version: "1.4.2",
+    version: "1.5.1",
     description: "A multi-agent orchestration framework for AI-assisted software engineering workflows.",
     keywords: [
       "ai",
@@ -11216,9 +11216,11 @@ __export(exports_schemas, {
   ExecutionContextSchema: () => ExecutionContextSchema,
   ExecutionProfileNameSchema: () => ExecutionProfileNameSchema,
   ExecutionProfileSchema: () => ExecutionProfileSchema,
+  FixIntakeOutputSchema: () => FixIntakeOutputSchema,
   GoalGraphSchema: () => GoalGraphSchema,
   GoalTaskSchema: () => GoalTaskSchema,
   GraphRelationSchema: () => GraphRelationSchema,
+  HandoffEnvelopeSchema: () => HandoffEnvelopeSchema,
   HarnessCatalogEntrySchema: () => HarnessCatalogEntrySchema,
   HarnessCatalogSchema: () => HarnessCatalogSchema,
   HarnessComponentIdSchema: () => HarnessComponentIdSchema,
@@ -11439,7 +11441,7 @@ function validateProductEvent(data) {
 function validateSkillsRegistry(data) {
   return SkillsRegistrySchema.parse(data);
 }
-var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, SkillFrontmatterSchema, CommandFrontmatterSchema, TargetCapabilitiesSchema, ContractTargetSchema, ContractFormatSchema, AgentContractSchema, CouncilFindingSchema, CouncilVerdictInputSchema, ConsensusConfigSchema, CouncilVerdictSchema, ClaudeAgentFileSchema, OpenCodeAgentFileSchema, SentryStackFrameSchema, SentryWebhookSchema, MemoryPointerSchema, MemoryIndexSchema, GoalTaskSchema, GoalGraphSchema, ConfidenceLevelSchema, ProductNodeTypeSchema, GraphRelationSchema, KnowledgeEntitySchema, DecisionSchema, EvidenceSchema, CanonicalTaskCardStatusSchema, CanonicalTaskCardSchema, ProductGraphNodeSchema, ProductGraphEdgeSchema, ProductGraphSchema, ProductMetaSchema, ProductEventTypeSchema, ProductEventSchema, OperationalStateSchema, StrategicMemorySchema, ImpactReportSchema, BusinessReviewOutputSchema, VerificationReportSchema, BacklogStatusSchema, BacklogTypeSchema, BacklogPrioritySchema, BacklogGlobalSchema, BacklogItemSchema, BacklogDocumentSchema, OpenspecTaskCardPhaseSchema, OpenspecTaskCardStatusSchema, OpenspecTaskCardSchema, OpenspecStateSchema, SpecAnalyzeFindingSchema, SpecAnalyzeReportSchema, WorkflowCommandSchema, CcepOutputFormatSchema, CommandEnvelopeSchema, WorkflowPhaseSchema, WorkflowRiskRuleSchema, WorkflowProfileSchema, ExecutionContextSchema, PlannerOutputSchema, AgentArtifactSchema, AgentOutputSchema, ImplementerTestsSchema, ImplementerOutputSchema, ReviewAxisSchema, ReviewFindingSchema, ReviewerOutputSchema, TechnicalPlanOutputSchema, ScorecardVerdictSchema, ScorecardCriterionIdSchema, ScorecardCriterionSchema, ScorecardRecordSchema, TaskOutcomeSourceSchema, TaskOutcomeStatusSchema, DeliveryRouteSchema, TokenUsageSchema, DeliveryTelemetrySchema, DeliveryLedgerTaskSchema, DeliveryLedgerSchema, DeliveryLedgerRequestSchema, TaskOutcomeSchema, HarnessComponentIdSchema, HarnessComponentLayerSchema, HarnessToggleKindSchema, HarnessCatalogEntrySchema, HarnessCatalogSchema, HarnessOverlaySchema, HarnessExperimentSchema, HarnessSuiteTaskSchema, HarnessSuiteSchema, EvaluationIndexSchema, ExecutionProfileNameSchema, ExecutionProfileSchema, SkillsRegistrySchema;
+var CouncilAgentSpecSchema, CouncilSpecSchema, ProjectProfileSchema, CompileCheckConfigSchema, LoopConfigSchema, CodeConductorConfigSchema, RunnerTargetSchema, InstallStrategySchema, ManifestEntrySchema, InstallManifestSchema, ToolProviderNamesSchema, PermissionProviderNamesSchema, ModelConfigSchema, SkillFrontmatterSchema, CommandFrontmatterSchema, TargetCapabilitiesSchema, ContractTargetSchema, ContractFormatSchema, AgentContractSchema, CouncilFindingSchema, CouncilVerdictInputSchema, ConsensusConfigSchema, CouncilVerdictSchema, ClaudeAgentFileSchema, OpenCodeAgentFileSchema, SentryStackFrameSchema, SentryWebhookSchema, MemoryPointerSchema, MemoryIndexSchema, GoalTaskSchema, GoalGraphSchema, ConfidenceLevelSchema, ProductNodeTypeSchema, GraphRelationSchema, KnowledgeEntitySchema, DecisionSchema, EvidenceSchema, CanonicalTaskCardStatusSchema, CanonicalTaskCardSchema, ProductGraphNodeSchema, ProductGraphEdgeSchema, ProductGraphSchema, ProductMetaSchema, ProductEventTypeSchema, ProductEventSchema, OperationalStateSchema, StrategicMemorySchema, ImpactReportSchema, BusinessReviewOutputSchema, VerificationReportSchema, BacklogStatusSchema, BacklogTypeSchema, BacklogPrioritySchema, BacklogGlobalSchema, BacklogItemSchema, BacklogDocumentSchema, OpenspecTaskCardPhaseSchema, OpenspecTaskCardStatusSchema, OpenspecTaskCardSchema, OpenspecStateSchema, SpecAnalyzeFindingSchema, SpecAnalyzeReportSchema, WorkflowCommandSchema, CcepOutputFormatSchema, CommandEnvelopeSchema, WorkflowPhaseSchema, WorkflowRiskRuleSchema, WorkflowProfileSchema, ExecutionContextSchema, PlannerOutputSchema, AgentArtifactSchema, AgentOutputSchema, ImplementerTestsSchema, ImplementerOutputSchema, ReviewAxisSchema, ReviewFindingSchema, ReviewerOutputSchema, TechnicalPlanOutputSchema, FixIntakeOutputSchema, ScorecardVerdictSchema, ScorecardCriterionIdSchema, ScorecardCriterionSchema, ScorecardRecordSchema, TaskOutcomeSourceSchema, TaskOutcomeStatusSchema, DeliveryRouteSchema, TokenUsageSchema, DeliveryTelemetrySchema, DeliveryLedgerTaskSchema, DeliveryLedgerSchema, HandoffEnvelopeSchema, RepoRelativePathSchema, DeliveryLedgerRequestSchema, TaskOutcomeSchema, HarnessComponentIdSchema, HarnessComponentLayerSchema, HarnessToggleKindSchema, HarnessCatalogEntrySchema, HarnessCatalogSchema, HarnessOverlaySchema, HarnessExperimentSchema, HarnessSuiteTaskSchema, HarnessSuiteSchema, EvaluationIndexSchema, ExecutionProfileNameSchema, ExecutionProfileSchema, SkillsRegistrySchema;
 var init_schemas = __esm(() => {
   init_zod();
   init_runner_target();
@@ -11517,6 +11519,7 @@ var init_schemas = __esm(() => {
     "append",
     "merge-json",
     "merge-managed",
+    "create-only",
     "skip"
   ]);
   ManifestEntrySchema = exports_external.object({
@@ -11821,7 +11824,8 @@ var init_schemas = __esm(() => {
     "goal.updated",
     "blocker.detected",
     "verification.completed",
-    "feedback.processed"
+    "feedback.processed",
+    "context.compiled"
   ]);
   ProductEventSchema = exports_external.object({
     id: exports_external.string(),
@@ -12166,6 +12170,11 @@ var init_schemas = __esm(() => {
     risks: exports_external.array(exports_external.string()).default([]),
     openQuestions: exports_external.array(exports_external.string()).optional()
   });
+  FixIntakeOutputSchema = exports_external.object({
+    actualBehavior: exports_external.string(),
+    expectedBehavior: exports_external.string(),
+    reproductionSteps: exports_external.array(exports_external.string())
+  });
   ScorecardVerdictSchema = exports_external.enum(["PASS", "REVISE", "REJECT"]);
   ScorecardCriterionIdSchema = exports_external.enum([
     "acceptance",
@@ -12237,16 +12246,51 @@ var init_schemas = __esm(() => {
     nextStep: exports_external.string().min(1),
     memoryTopicKey: exports_external.string().min(1),
     workspace: exports_external.record(exports_external.string(), exports_external.string()),
+    technicalPlanPath: exports_external.string().min(1).optional(),
     createdAt: exports_external.string().datetime(),
     updatedAt: exports_external.string().datetime()
   });
+  HandoffEnvelopeSchema = exports_external.object({
+    version: exports_external.literal(1),
+    task: exports_external.object({
+      id: exports_external.string().min(1),
+      objective: exports_external.string().min(1),
+      acceptanceCriteria: exports_external.array(exports_external.string().min(1)),
+      status: CanonicalTaskCardStatusSchema
+    }),
+    decisions: exports_external.object({
+      constraints: exports_external.array(exports_external.string()),
+      unresolved: exports_external.array(exports_external.string())
+    }),
+    scope: exports_external.object({
+      relevantFiles: exports_external.array(exports_external.string()),
+      boundaries: exports_external.array(exports_external.string())
+    }),
+    verification: exports_external.object({
+      evidence: exports_external.array(exports_external.string())
+    }),
+    change: exports_external.object({
+      touchedFiles: exports_external.array(exports_external.string())
+    }),
+    next: exports_external.object({
+      role: exports_external.string().min(1),
+      objective: exports_external.string().min(1)
+    }),
+    sources: exports_external.object({
+      deliveryLedger: exports_external.string().min(1),
+      memoryTopicKey: exports_external.string().min(1),
+      technicalPlanPath: exports_external.string().min(1).optional()
+    })
+  });
+  RepoRelativePathSchema = exports_external.string().min(1).refine((path) => !/^([/\\]|[A-Za-z]:)/.test(path) && !path.split(/[/\\]/).includes(".."), 'Path must be relative to the repository and must not contain ".." segments');
   DeliveryLedgerRequestSchema = exports_external.object({
     id: exports_external.string().regex(/^[a-z0-9][a-z0-9-]{0,63}$/),
     authorized: exports_external.boolean(),
     route: DeliveryRouteSchema,
     taskCard: CanonicalTaskCardSchema,
     tasks: exports_external.array(DeliveryLedgerTaskSchema).min(1),
-    nextStep: exports_external.string().min(1)
+    nextStep: exports_external.string().min(1),
+    technicalPlanPath: RepoRelativePathSchema.optional()
   });
   TaskOutcomeSchema = exports_external.object({
     id: exports_external.string(),
@@ -12989,18 +13033,19 @@ var init_path_containment = __esm(() => {
 });
 
 // src/core/presets/complementary-detector.ts
-import { execFileSync } from "node:child_process";
+import { execFile } from "node:child_process";
 import { existsSync, readFileSync } from "node:fs";
 import { join as join3 } from "node:path";
 import { homedir } from "node:os";
-function detectComplementaryTools() {
+import { promisify } from "node:util";
+async function detectComplementaryTools() {
   if (cachedStatus) {
     return cachedStatus;
   }
-  const isCmdAvailable = (cmd) => {
+  const isCmdAvailable = async (cmd) => {
     try {
       const binary = process.platform === "win32" ? "where" : "which";
-      execFileSync(binary, [cmd], { stdio: "ignore", timeout: 1000 });
+      await execFileAsync(binary, [cmd], { timeout: 1000 });
       return true;
     } catch {
       return false;
@@ -13029,18 +13074,28 @@ function detectComplementaryTools() {
     } catch {}
     return false;
   };
+  const [rtk, codeReviewGraph, tokenSavior, tokenSaviorRecall, engram, gentleAi] = await Promise.all([
+    isCmdAvailable("rtk"),
+    isCmdAvailable("code-review-graph"),
+    isCmdAvailable("token-savior"),
+    isCmdAvailable("token-savior-recall"),
+    isCmdAvailable("engram"),
+    isCmdAvailable("gentle-ai")
+  ]);
   cachedStatus = {
-    rtk: isCmdAvailable("rtk"),
-    codeReviewGraph: isCmdAvailable("code-review-graph"),
-    tokenSavior: isCmdAvailable("token-savior") || isCmdAvailable("token-savior-recall"),
+    rtk,
+    codeReviewGraph,
+    tokenSavior: tokenSavior || tokenSaviorRecall,
     caveman: hasCaveman(),
-    engram: isCmdAvailable("engram"),
-    gentleAi: isCmdAvailable("gentle-ai")
+    engram,
+    gentleAi
   };
   return cachedStatus;
 }
-var cachedStatus = null;
-var init_complementary_detector = () => {};
+var execFileAsync, cachedStatus = null;
+var init_complementary_detector = __esm(() => {
+  execFileAsync = promisify(execFile);
+});
 
 // src/core/presets/file-copier.ts
 import { lstat as lstat2, readdir, readFile as readFile4, stat } from "node:fs/promises";
@@ -13133,9 +13188,9 @@ function extractAgentRole(filePath) {
   ];
   return knownRoles.includes(name) ? name : null;
 }
-function renderTemplate(content, modelConfig, filePath, locale = "en") {
+async function renderTemplate(content, modelConfig, filePath, locale = "en") {
   const cleanLocale = locale === "es" || locale === "en" ? locale : "en";
-  const tools = detectComplementaryTools();
+  const tools = await detectComplementaryTools();
   let complementaryRules = "";
   if (cleanLocale === "es") {
     if (tools.rtk) {
@@ -13258,7 +13313,7 @@ function substituteToolNames(content, modelConfig) {
   const eol = fmMatch[1];
   const frontmatter = fmMatch[2];
   if (target === "opencode" && modelConfig.permissions) {
-    const updatedFrontmatter2 = frontmatter.replace(/^tools:\s*(.+)\r?\n?/m, "");
+    const updatedFrontmatter2 = frontmatter.replace(/^tools:\s*(.+)\r?\n?/m, "").replace(/^(?:temperature|effort):[^\r\n]*\r?\n?/gm, "");
     return content.replace(fmMatch[0], `---${eol}${updatedFrontmatter2}${eol}---`);
   }
   if (!modelConfig.tools)
@@ -13276,11 +13331,10 @@ function substituteToolNames(content, modelConfig) {
   });
   return content.replace(fmMatch[0], `---${eol}${updatedFrontmatter}${eol}---`);
 }
-function injectMcpServers(jsonString, filePath) {
+async function injectMcpServers(jsonString, filePath) {
   const isAgyMcpConfig = filePath.endsWith("mcp_config.json");
-  const isClaudeSettings = filePath.endsWith("settings.json");
   const isOpencodeJsonc = filePath.endsWith("opencode.jsonc") || filePath.endsWith("opencode.json");
-  if (!isAgyMcpConfig && !isClaudeSettings && !isOpencodeJsonc) {
+  if (!isAgyMcpConfig && !isOpencodeJsonc) {
     return jsonString;
   }
   try {
@@ -13289,13 +13343,13 @@ function injectMcpServers(jsonString, filePath) {
       cleanJson = jsonString.replace(/\/\*[\s\S]*?\*\/|([^\\:]|^)\/\/.*$/gm, "$1");
     }
     const obj = JSON.parse(cleanJson);
-    const tools = detectComplementaryTools();
+    const tools = await detectComplementaryTools();
     const mcpServers = {};
     if (tools.tokenSavior) {
       mcpServers["token-savior-recall"] = {
         command: "token-savior",
         env: {
-          TOKEN_SAVIOR_CLIENT: isClaudeSettings ? "claude-code" : isOpencodeJsonc ? "opencode" : "agy"
+          TOKEN_SAVIOR_CLIENT: isOpencodeJsonc ? "opencode" : "agy"
         }
       };
     }
@@ -13308,7 +13362,7 @@ function injectMcpServers(jsonString, filePath) {
     if (Object.keys(mcpServers).length === 0) {
       return jsonString;
     }
-    if (isClaudeSettings || isAgyMcpConfig) {
+    if (isAgyMcpConfig) {
       obj.mcpServers = mergeDeep(obj.mcpServers || {}, mcpServers);
     } else if (isOpencodeJsonc) {
       const opencodeMcp = {};
@@ -13352,7 +13406,7 @@ async function applySingleFile(srcPath, destPath, strategy, force, dryRun, isTem
       return { src: srcPath, dest: destPath, action: "error", error: String(error) };
     }
   }
-  if (strategy === "overwrite" && !force && await fileExists2(destPath)) {
+  if ((strategy === "overwrite" && !force || strategy === "create-only") && await fileExists2(destPath)) {
     return { src: srcPath, dest: destPath, action: "skipped", dryRun };
   }
   let content;
@@ -13361,8 +13415,8 @@ async function applySingleFile(srcPath, destPath, strategy, force, dryRun, isTem
   } catch (e) {
     return { src: srcPath, dest: destPath, action: "error", error: `Cannot read source: ${e}` };
   }
-  let incomingContent = isTemplate && modelConfig ? renderTemplate(content, modelConfig, srcPath, locale) : content;
-  incomingContent = injectMcpServers(incomingContent, destPath);
+  let incomingContent = isTemplate && modelConfig ? await renderTemplate(content, modelConfig, srcPath, locale) : content;
+  incomingContent = await injectMcpServers(incomingContent, destPath);
   let finalContent = incomingContent;
   let action = "written";
   if (strategy === "append") {
@@ -13993,6 +14047,11 @@ ${spec.agents.map((a) => `- **${a.role}** (${a.id}): ${a.focus.join(", ")}`).joi
 
 ## Usage
 Use the council agents to get multi-perspective analysis on code changes, architecture decisions, and security reviews.
+Use Sonnet 5.5 for the routine council pass. Share one concise evidence summary and
+the relevant diff with the necessary roles. Invoke council-architect with
+\`model: opus\` only for
+one unresolved business-logic question; return its short decision to Sonnet for
+the verdict. Do not run every council role on Opus or repeat full context.
 
 ## Context
 ${spec.outputContract}
@@ -14107,7 +14166,8 @@ function generateCodexFiles(spec) {
   files.push({
     path: ".codex/config.toml",
     content: generateCodexConfig(spec),
-    overwrite: false
+    overwrite: false,
+    mergeExisting: (existing) => mergeCodexCouncilConfig(existing, spec)
   });
   for (const agent of spec.agents) {
     files.push({
@@ -14123,17 +14183,32 @@ function generateCodexFiles(spec) {
   });
   return files;
 }
-function generateCodexConfig(spec) {
-  const agentTables = spec.agents.map((agent) => {
-    const focusAreas = agent.focus.join(", ");
-    return `
+function agentTable(agent) {
+  const focusAreas = agent.focus.join(", ");
+  return `
 [agents.${agent.id}]
 description = "${agent.role} council agent. Focus: ${focusAreas}. Context: ${agent.context}. Model hint: ${agent.modelHint}."
+config_file = "agents/council_${agent.id}.toml"
 nickname_candidates = ["${agent.role}", "Council ${agent.role}"]`;
-  }).join(`
+}
+function mergeCodexCouncilConfig(existing, spec) {
+  const missing = spec.agents.filter((agent) => !existing.split(`
+`).some((line) => line.trim() === `[agents.${agent.id}]`));
+  if (missing.length === 0)
+    return existing;
+  return `${existing.trimEnd()}
+${missing.map(agentTable).join(`
+`)}
+`;
+}
+function generateCodexConfig(spec) {
+  const agentTables = spec.agents.map(agentTable).join(`
 `);
   return `# Codex Council Configuration
 
+model = "gpt-6.1-sol"
+model_reasoning_effort = "medium"
+
 [project]
 name = "council"
 version = "${spec.version}"
@@ -14143,7 +14218,9 @@ ${agentTables}
 function generateCodexAgent(agent) {
   const focusAreas = agent.focus.join(", ");
   const checklist = checklistFor(agent.id).join("; ");
-  return `name = "${agent.role}"
+  return `model = "gpt-6.1-sol"
+model_reasoning_effort = "medium"
+name = "${agent.role}"
 description = "${agent.role} council agent. Focus: ${focusAreas}. Context: ${agent.context}. Model hint: ${agent.modelHint}."
 nickname_candidates = ["${agent.role}", "Council ${agent.role}"]
 developer_instructions = "You are the ${agent.role} council agent. Your focus areas are: ${focusAreas}. Context: ${agent.context}. Apply ${agent.modelHint} reasoning to your analysis. Review checklist: ${checklist}. Categorize findings as CRITICAL (blocks the verdict), WARNING, or SUGGESTION."
@@ -14162,6 +14239,9 @@ ${spec.agents.map((a) => `- **${a.role}** (${a.id}): ${a.focus.join(", ")}`).joi
 
 ## Usage
 Use the council agents to get multi-perspective analysis on code changes, architecture decisions, and security reviews.
+Keep GPT-6.1 Sol at medium reasoning effort. Share a concise evidence summary
+and relevant diff with only the necessary council roles. Reuse findings in the
+final verdict instead of replaying the full transcript or repeating analysis.
 `;
 }
 var init_codex_council_generator = __esm(() => {
@@ -14629,7 +14709,7 @@ async function checkUpdates(basePath, isGlobal, includeConflicts = false) {
         let expectedContent;
         try {
           const srcContent = await readFile7(src, "utf-8");
-          expectedContent = isTemplate && modelConfig ? renderTemplate(srcContent, modelConfig, src, locale) : srcContent;
+          expectedContent = isTemplate && modelConfig ? await renderTemplate(srcContent, modelConfig, src, locale) : srcContent;
         } catch {
           continue;
         }
@@ -14714,7 +14794,8 @@ async function checkUpdates(basePath, isGlobal, includeConflicts = false) {
               let destContent;
               try {
                 destContent = await readFile7(dest, "utf-8");
-                if (destContent.trim() !== f.content.trim()) {
+                const expected = f.mergeExisting ? f.mergeExisting(destContent) : f.content;
+                if (destContent.trim() !== expected.trim()) {
                   changedFiles.push(dest);
                 }
               } catch {
@@ -15091,7 +15172,7 @@ async function doctorCommand(options) {
         message: "No product graph yet. Run `codeconductor ingest` to build product memory."
       });
     }
-    const compTools = detectComplementaryTools();
+    const compTools = await detectComplementaryTools();
     const toolDetails = [
       { name: "rtk", key: "rtk", label: "RTK", desc: "Run `brew install rtk` to compress command outputs" },
       { name: "code-review-graph", key: "codeReviewGraph", label: "code-review-graph", desc: "Run `pipx install code-review-graph` to navigate symbol graph" },
@@ -16899,7 +16980,7 @@ __export(exports_file_writer, {
   writeGeneratedFiles: () => writeGeneratedFiles,
   writeSingleFile: () => writeSingleFile
 });
-import { access as access5 } from "node:fs/promises";
+import { access as access5, readFile as readFile11 } from "node:fs/promises";
 import { relative as relative4 } from "node:path";
 async function writeGeneratedFiles(files, options) {
   const results = [];
@@ -16926,7 +17007,15 @@ async function writeGeneratedFiles(files, options) {
       });
       continue;
     }
-    if (!options.force) {
+    let content = file.content;
+    let merged = false;
+    if (file.mergeExisting) {
+      try {
+        content = file.mergeExisting(await readFile11(file.path, "utf-8"));
+        merged = true;
+      } catch {}
+    }
+    if (!options.force && !merged) {
       try {
         await access5(file.path);
         results.push({
@@ -16946,7 +17035,7 @@ async function writeGeneratedFiles(files, options) {
       continue;
     }
     try {
-      await writeContainedFile(options.projectRoot, relative4(options.projectRoot, file.path), file.content, { force: true });
+      await writeContainedFile(options.projectRoot, relative4(options.projectRoot, file.path), content, { force: true });
       results.push({
         path: file.path,
         success: true
@@ -16986,7 +17075,7 @@ __export(exports_install_command, {
   installPresetCommand: () => installPresetCommand,
   verifyRenderedFiles: () => verifyRenderedFiles
 });
-import { readFile as readFile11 } from "node:fs/promises";
+import { readFile as readFile12 } from "node:fs/promises";
 import { homedir as homedir7 } from "node:os";
 import { basename as basename5, dirname as dirname6, resolve as resolve12, sep as sep3 } from "node:path";
 async function installCommand(options) {
@@ -17119,7 +17208,7 @@ async function verifyRenderedFiles(manifest, baseDir, results) {
       continue;
     let content;
     try {
-      content = await readFile11(r.dest, "utf-8");
+      content = await readFile12(r.dest, "utf-8");
     } catch {
       continue;
     }
@@ -18373,13 +18462,13 @@ var init_binary_downloader = __esm(() => {
 });
 
 // src/core/lsp/lsp-installer.ts
-import { execFile } from "node:child_process";
+import { execFile as execFile2 } from "node:child_process";
 import { access as access6, mkdir as mkdir6, mkdtemp, rename as rename2, rm, writeFile as writeFile5 } from "node:fs/promises";
 import { homedir as homedir8, tmpdir } from "node:os";
 import { join as join9 } from "node:path";
-import { promisify } from "node:util";
+import { promisify as promisify2 } from "node:util";
 async function assertTarArchiveSafe(archivePath, destRoot) {
-  const { stdout } = await execFileAsync("tar", ["-tzf", archivePath], {
+  const { stdout } = await execFileAsync2("tar", ["-tzf", archivePath], {
     timeout: 60000,
     maxBuffer: 10 * 1024 * 1024
   });
@@ -18391,7 +18480,7 @@ async function assertTarArchiveSafe(archivePath, destRoot) {
 }
 async function extractHardenedTar(archivePath, destRoot) {
   await assertTarArchiveSafe(archivePath, destRoot);
-  await execFileAsync("tar", ["-xzf", archivePath, "-C", destRoot, ...TAR_EXTRACT_HARDENING_FLAGS], { timeout: 120000 });
+  await execFileAsync2("tar", ["-xzf", archivePath, "-C", destRoot, ...TAR_EXTRACT_HARDENING_FLAGS], { timeout: 120000 });
 }
 
 class LspInstaller {
@@ -18401,7 +18490,7 @@ class LspInstaller {
   }
   async checkInstalled(def) {
     try {
-      const { stdout } = await execFileAsync("which", [def.binaryName], { timeout: 5000 });
+      const { stdout } = await execFileAsync2("which", [def.binaryName], { timeout: 5000 });
       const path = stdout.trim();
       if (path) {
         const version = await this.getVersion(def);
@@ -18410,7 +18499,7 @@ class LspInstaller {
     } catch {}
     if (def.packageManager === "npm" && def.npmDetect) {
       try {
-        const { stdout } = await execFileAsync("npm", ["list", "-g", def.npmDetect, "--depth=0"], { timeout: 1e4 });
+        const { stdout } = await execFileAsync2("npm", ["list", "-g", def.npmDetect, "--depth=0"], { timeout: 1e4 });
         if (stdout.includes(def.npmDetect)) {
           const version = this.parseVersionFromNpmList(stdout, def.npmDetect);
           return { installed: true, version };
@@ -18419,7 +18508,7 @@ class LspInstaller {
     }
     if (def.packageManager === "pip" && def.pipDetect) {
       try {
-        const { stdout } = await execFileAsync("pip", ["show", def.pipDetect], { timeout: 1e4 });
+        const { stdout } = await execFileAsync2("pip", ["show", def.pipDetect], { timeout: 1e4 });
         if (stdout.includes("Version:")) {
           const version = this.parseVersionFromPipShow(stdout);
           return { installed: true, version };
@@ -18483,7 +18572,7 @@ class LspInstaller {
   }
   async getVersion(def) {
     try {
-      const { stdout } = await execFileAsync(def.binaryName, [def.versionFlag], { timeout: 5000 });
+      const { stdout } = await execFileAsync2(def.binaryName, [def.versionFlag], { timeout: 5000 });
       return stdout.trim().split(`
 `)[0];
     } catch {
@@ -18501,7 +18590,7 @@ class LspInstaller {
   async installNpm(def) {
     assertPinnedPackage(def);
     try {
-      await execFileAsync("npm", ["install", "-g", def.package], { timeout: 120000 });
+      await execFileAsync2("npm", ["install", "-g", def.package], { timeout: 120000 });
     } catch (error) {
       throw new Error(`Failed to install ${def.serverName}: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -18509,7 +18598,7 @@ class LspInstaller {
   async installPip(def) {
     assertPinnedPackage(def);
     try {
-      await execFileAsync("pip", ["install", "--user", def.package], { timeout: 120000 });
+      await execFileAsync2("pip", ["install", "--user", def.package], { timeout: 120000 });
     } catch (error) {
       throw new Error(`Failed to install ${def.serverName}: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -18551,7 +18640,7 @@ class LspInstaller {
         await access6(candidate);
         await rename2(candidate, destPath);
       } catch {
-        const { stdout: found } = await execFileAsync("find", [workDir, "-type", "f", "-name", def.binaryName], { timeout: 30000 });
+        const { stdout: found } = await execFileAsync2("find", [workDir, "-type", "f", "-name", def.binaryName], { timeout: 30000 });
         const first = found.split(`
 `).map((l) => l.trim()).find((l) => l.length > 0);
         if (!first) {
@@ -18561,7 +18650,7 @@ class LspInstaller {
         await rename2(first, destPath);
       }
       if (process.platform !== "win32") {
-        await execFileAsync("chmod", ["+x", destPath], { timeout: 5000 });
+        await execFileAsync2("chmod", ["+x", destPath], { timeout: 5000 });
       }
     } finally {
       await rm(workDir, { recursive: true, force: true });
@@ -18571,11 +18660,11 @@ class LspInstaller {
 function createLspInstaller() {
   return new LspInstaller;
 }
-var execFileAsync, TAR_EXTRACT_HARDENING_FLAGS;
+var execFileAsync2, TAR_EXTRACT_HARDENING_FLAGS;
 var init_lsp_installer = __esm(() => {
   init_binary_integrity();
   init_binary_downloader();
-  execFileAsync = promisify(execFile);
+  execFileAsync2 = promisify2(execFile2);
   TAR_EXTRACT_HARDENING_FLAGS = [
     "--no-same-owner",
     "--no-same-permissions"
@@ -18824,7 +18913,7 @@ var init_install_lsp_command = __esm(() => {
 });
 
 // src/core/install/update-transaction.ts
-import { mkdir as mkdir7, readFile as readFile12, rm as rm2, unlink, writeFile as writeFile6 } from "node:fs/promises";
+import { mkdir as mkdir7, readFile as readFile13, rm as rm2, unlink, writeFile as writeFile6 } from "node:fs/promises";
 import { dirname as dirname7, join as join10, relative as relative5, resolve as resolve16 } from "node:path";
 
 class UpdateTransaction {
@@ -18841,7 +18930,7 @@ class UpdateTransaction {
     const snapshots = [];
     for (const destination of unique) {
       try {
-        const content = await readFile12(destination);
+        const content = await readFile13(destination);
         snapshots.push({ path: destination, existed: true, content });
         const backupPath = join10(backupDir, relative5(basePath, destination));
         await mkdir7(dirname7(backupPath), { recursive: true });
@@ -18883,7 +18972,7 @@ __export(exports_update_command, {
 });
 import { homedir as homedir10 } from "node:os";
 import { resolve as resolve17, dirname as dirname8 } from "node:path";
-import { mkdir as mkdir8, readFile as readFile13, writeFile as writeFile7, stat as stat3 } from "node:fs/promises";
+import { mkdir as mkdir8, readFile as readFile14, writeFile as writeFile7, stat as stat3 } from "node:fs/promises";
 async function updateCommand(options) {
   const { dryRun, force, global: isGlobal, output, projectRoot, check = false } = options;
   const basePath = isGlobal ? homedir10() : projectRoot;
@@ -18992,7 +19081,7 @@ async function updateCommand(options) {
       const localCouncil = resolve17(basePath, ".codeconductor", "presets", "council.yml");
       const bundledCouncil = resolve17(SRC_PRESETS_DIR, "council", "council.yml");
       try {
-        const content = await readFile13(bundledCouncil, "utf-8");
+        const content = await readFile14(bundledCouncil, "utf-8");
         await mkdir8(dirname8(localCouncil), { recursive: true });
         await writeFile7(localCouncil, content, "utf-8");
         updated.push(localCouncil);
@@ -19003,7 +19092,7 @@ async function updateCommand(options) {
     if (updateResults.policy) {
       const localPolicy = resolve17(basePath, ".codeconductor", "presets", "policy.yml");
       try {
-        const content = await readFile13(POLICY_PATH, "utf-8");
+        const content = await readFile14(POLICY_PATH, "utf-8");
         await mkdir8(dirname8(localPolicy), { recursive: true });
         await writeFile7(localPolicy, content, "utf-8");
         updated.push(localPolicy);
@@ -19161,7 +19250,7 @@ __export(exports_migrate_command, {
   migrateCommand: () => migrateCommand,
   migratePermissionRules: () => migratePermissionRules
 });
-import { readFile as readFile14, readdir as readdir3, rm as rm3, writeFile as writeFile8 } from "node:fs/promises";
+import { readFile as readFile15, readdir as readdir3, rm as rm3, writeFile as writeFile8 } from "node:fs/promises";
 import { homedir as homedir11 } from "node:os";
 import { join as join11, resolve as resolve18 } from "node:path";
 function migratePermissionRules(settings) {
@@ -19244,7 +19333,7 @@ async function migrateCommand(options) {
   const settingsPath = resolveSettingsPath(options);
   let raw = null;
   try {
-    raw = await readFile14(settingsPath, "utf-8");
+    raw = await readFile15(settingsPath, "utf-8");
   } catch (error) {
     if (error.code !== "ENOENT") {
       return {
@@ -19657,7 +19746,7 @@ var exports_debt_harvest_command = {};
 __export(exports_debt_harvest_command, {
   debtHarvestCommand: () => debtHarvestCommand
 });
-import { readdir as readdir5, readFile as readFile15, writeFile as writeFile9, mkdir as mkdir9 } from "node:fs/promises";
+import { readdir as readdir5, readFile as readFile16, writeFile as writeFile9, mkdir as mkdir9 } from "node:fs/promises";
 import { join as join13, relative as relative6, extname } from "node:path";
 async function walkDir(dir, extensions) {
   const results = [];
@@ -19735,7 +19824,7 @@ async function debtHarvestCommand(options) {
     const files = await walkDir(targetDir, SOURCE_EXTENSIONS);
     const allEntries = [];
     for (const file of files) {
-      const content = await readFile15(file, "utf-8");
+      const content = await readFile16(file, "utf-8");
       const entries = extractDefers(content, relative6(projectRoot, file));
       allEntries.push(...entries);
     }
@@ -20213,11 +20302,11 @@ __export(exports_graph_store, {
   saveGraph: () => saveGraph,
   upsertNode: () => upsertNode
 });
-import { mkdir as mkdir10, readFile as readFile16, writeFile as writeFile10 } from "node:fs/promises";
+import { mkdir as mkdir10, readFile as readFile17, writeFile as writeFile10 } from "node:fs/promises";
 import { dirname as dirname9 } from "node:path";
 async function loadGraph(projectRoot) {
   try {
-    const raw = await readFile16(productGraphPath(projectRoot), "utf-8");
+    const raw = await readFile17(productGraphPath(projectRoot), "utf-8");
     return ok(ProductGraphSchema.parse(JSON.parse(raw)));
   } catch (e) {
     if (e.code === "ENOENT") {
@@ -20399,7 +20488,7 @@ __export(exports_goal_state, {
   markTaskBlocked: () => markTaskBlocked,
   writeGoal: () => writeGoal
 });
-import { mkdir as mkdir11, readFile as readFile17, writeFile as writeFile11 } from "node:fs/promises";
+import { mkdir as mkdir11, readFile as readFile18, writeFile as writeFile11 } from "node:fs/promises";
 import { resolve as resolve19 } from "node:path";
 function validateGoalGraph2(graph) {
   const ids = new Set(graph.tasks.map((t) => t.id));
@@ -20452,7 +20541,7 @@ async function writeGoal(projectRoot, graph) {
 async function loadGoal(projectRoot) {
   try {
     const filePath = resolve19(projectRoot, GOAL_FILE);
-    const content = await readFile17(filePath, "utf-8");
+    const content = await readFile18(filePath, "utf-8");
     const data = $parse(content);
     const validated = GoalGraphSchema.parse(data);
     return validateGoalGraph2(validated);
@@ -20614,7 +20703,7 @@ var init_goal_command = __esm(() => {
 });
 
 // src/core/openspec/backlog-parser.ts
-import { readFile as readFile18 } from "node:fs/promises";
+import { readFile as readFile19 } from "node:fs/promises";
 import { resolve as resolve20 } from "node:path";
 function parseBool(value) {
   const v = value.trim().toLowerCase();
@@ -20790,7 +20879,7 @@ function parseBacklogMarkdown(content) {
 async function loadBacklog(projectRoot) {
   try {
     const filePath = resolve20(projectRoot, BACKLOG_FILE);
-    const content = await readFile18(filePath, "utf-8");
+    const content = await readFile19(filePath, "utf-8");
     return parseBacklogMarkdown(content);
   } catch (e) {
     return err(e instanceof Error ? e : new Error(String(e)));
@@ -20839,14 +20928,14 @@ function slugify(text) {
 }
 
 // src/core/knowledge/source-parsers.ts
-import { readFile as readFile19 } from "node:fs/promises";
-import { join as join15 } from "node:path";
+import { readFile as readFile20 } from "node:fs/promises";
+import { basename as basename6, join as join15, relative as relative7, sep as sep5 } from "node:path";
 async function parseAdrFile(filePath) {
   try {
-    const content = await readFile19(filePath, "utf-8");
-    const basename6 = filePath.split("/").pop() ?? "";
-    const idMatch = basename6.match(/adr-(\d+)/i);
-    const id = idMatch ? `adr-${idMatch[1]}` : slugify(basename6);
+    const content = await readFile20(filePath, "utf-8");
+    const base = basename6(filePath);
+    const idMatch = base.match(/adr-(\d+)/i);
+    const id = idMatch ? `adr-${idMatch[1]}` : slugify(base);
     const titleMatch = content.match(/^#\s+ADR-\d+:\s*(.+)$/m);
     const statusMatch = content.match(/\*\*Status:\*\*\s*(\w+)/i);
     const contextSection = extractSection(content, "Context");
@@ -20856,7 +20945,7 @@ async function parseAdrFile(filePath) {
 `).filter((l) => l.trim().startsWith("-") || l.trim().startsWith("*")).map((l) => l.replace(/^[\s*-]+/, "").trim()).filter(Boolean);
     return {
       id,
-      title: titleMatch?.[1]?.trim() ?? basename6,
+      title: titleMatch?.[1]?.trim() ?? base,
       status: statusMatch?.[1]?.toLowerCase() ?? "unknown",
       context: contextSection.trim(),
       decision: decisionSection.trim(),
@@ -20892,7 +20981,7 @@ function adrToEntities(adr, source) {
 }
 async function parseReadmeEntities(projectRoot, productName) {
   try {
-    const content = await readFile19(join15(projectRoot, "README.md"), "utf-8");
+    const content = await readFile20(join15(projectRoot, "README.md"), "utf-8");
     const firstPara = content.split(`
 
 `).find((p) => p.trim() && !p.startsWith("#") && !p.startsWith(">")) ?? "";
@@ -20913,7 +21002,7 @@ async function parseReadmeEntities(projectRoot, productName) {
 }
 async function parseGraphifyEntities(projectRoot) {
   try {
-    const raw = await readFile19(join15(projectRoot, "graphify-out", "graph.json"), "utf-8");
+    const raw = await readFile20(join15(projectRoot, "graphify-out", "graph.json"), "utf-8");
     const graph = JSON.parse(raw);
     const entities = [];
     for (const node2 of graph.nodes ?? []) {
@@ -20956,7 +21045,7 @@ async function scanSrcComponents(projectRoot) {
             source: "src/",
             confidence: "medium",
             relations: [],
-            data: { path: full.replace(projectRoot + "/", "") }
+            data: { path: relative7(projectRoot, full).split(sep5).join("/") }
           });
           await walk(full, prefix ? `${prefix}-${domainSlug}` : domainSlug);
         }
@@ -20969,7 +21058,7 @@ async function scanSrcComponents(projectRoot) {
 var init_source_parsers = () => {};
 
 // src/core/memory/episodic-store.ts
-import { appendFile, mkdir as mkdir12, readFile as readFile20 } from "node:fs/promises";
+import { appendFile, mkdir as mkdir12, readFile as readFile21 } from "node:fs/promises";
 import { resolve as resolve21 } from "node:path";
 async function appendEvent(projectRoot, event) {
   try {
@@ -20988,7 +21077,7 @@ async function appendEvent(projectRoot, event) {
 }
 async function listEvents(projectRoot, since, type) {
   try {
-    const content = await readFile20(eventsPath(projectRoot), "utf-8");
+    const content = await readFile21(eventsPath(projectRoot), "utf-8");
     const events = [];
     for (const line of content.split(`
 `)) {
@@ -21016,8 +21105,8 @@ var init_episodic_store = __esm(() => {
 
 // src/core/knowledge/ingest-pipeline.ts
 import { createHash as createHash3 } from "node:crypto";
-import { readFile as readFile21 } from "node:fs/promises";
-import { join as join16 } from "node:path";
+import { readFile as readFile22 } from "node:fs/promises";
+import { join as join16, relative as relative8, sep as sep6 } from "node:path";
 import { mkdir as mkdir13, writeFile as writeFile12 } from "node:fs/promises";
 async function mapLimit(items, limit, fn) {
   if (items.length === 0)
@@ -21038,7 +21127,7 @@ async function mapLimit(items, limit, fn) {
 }
 async function hashFile(path) {
   try {
-    const content = await readFile21(path, "utf-8");
+    const content = await readFile22(path, "utf-8");
     return createHash3("sha256").update(content).digest("hex").slice(0, 16);
   } catch {
     return null;
@@ -21065,8 +21154,8 @@ async function collectDeferRisks(projectRoot) {
   await walk(join16(projectRoot, "src"));
   const perFile = await mapLimit(files, WALK_READ_CONCURRENCY, async (full) => {
     const entities = [];
-    const content = await readFile21(full, "utf-8");
-    const rel = full.replace(projectRoot + "/", "");
+    const content = await readFile22(full, "utf-8");
+    const rel = relative8(projectRoot, full).split(sep6).join("/");
     const deferRe = new RegExp(DEFER_REGEX_SOURCE, "gm");
     let match;
     while ((match = deferRe.exec(content)) !== null) {
@@ -21314,11 +21403,11 @@ var init_ingest_command = __esm(() => {
 });
 
 // src/core/memory/operational-state.ts
-import { mkdir as mkdir14, readFile as readFile22, writeFile as writeFile13 } from "node:fs/promises";
+import { mkdir as mkdir14, readFile as readFile23, writeFile as writeFile13 } from "node:fs/promises";
 import { resolve as resolve22 } from "node:path";
 async function loadOperationalState(projectRoot) {
   try {
-    const raw = await readFile22(operationalStatePath(projectRoot), "utf-8");
+    const raw = await readFile23(operationalStatePath(projectRoot), "utf-8");
     return ok(OperationalStateSchema.parse(JSON.parse(raw)));
   } catch (e) {
     if (e.code === "ENOENT") {
@@ -21375,11 +21464,11 @@ var init_operational_state = __esm(() => {
 });
 
 // src/core/memory/strategic-memory.ts
-import { mkdir as mkdir15, readFile as readFile23, writeFile as writeFile14 } from "node:fs/promises";
+import { mkdir as mkdir15, readFile as readFile24, writeFile as writeFile14 } from "node:fs/promises";
 import { resolve as resolve23 } from "node:path";
 async function loadStrategicMemory(projectRoot) {
   try {
-    const raw = await readFile23(strategicPath(projectRoot), "utf-8");
+    const raw = await readFile24(strategicPath(projectRoot), "utf-8");
     return ok(StrategicMemorySchema.parse(JSON.parse(raw)));
   } catch (e) {
     if (e.code === "ENOENT") {
@@ -21413,7 +21502,7 @@ var init_strategic_memory = __esm(() => {
 });
 
 // src/core/memory/memory-index.ts
-import { mkdir as mkdir16, readFile as readFile24, writeFile as writeFile15 } from "node:fs/promises";
+import { mkdir as mkdir16, readFile as readFile25, writeFile as writeFile15 } from "node:fs/promises";
 import { resolve as resolve24 } from "node:path";
 function parseMarkdown(content) {
   const startIdx = content.indexOf(SENTINEL_START);
@@ -21434,7 +21523,7 @@ function parseMarkdown(content) {
 async function loadMemoryIndex(projectRoot) {
   try {
     const filePath = resolve24(projectRoot, MEMORY_FILE);
-    const content = await readFile24(filePath, "utf-8");
+    const content = await readFile25(filePath, "utf-8");
     const parsed = parseMarkdown(content);
     if (!parsed) {
       return err(new Error("Failed to parse memory index from memory.md"));
@@ -21451,7 +21540,7 @@ var init_memory_index = __esm(() => {
 });
 
 // src/core/evaluation/outcome-store.ts
-import { appendFile as appendFile2, mkdir as mkdir17, readFile as readFile25, readdir as readdir6, writeFile as writeFile16 } from "node:fs/promises";
+import { appendFile as appendFile2, mkdir as mkdir17, readFile as readFile26, readdir as readdir6, writeFile as writeFile16 } from "node:fs/promises";
 import { resolve as resolve25 } from "node:path";
 async function ensureEvaluationDir(projectRoot) {
   const dir = resolve25(projectRoot, EVAL_DIR);
@@ -21468,7 +21557,7 @@ async function appendOutcome(projectRoot, outcome) {
     const indexPath = resolve25(dir, INDEX_FILE);
     let index = { version: 1, lastOutcomeId: validated.id };
     try {
-      const raw = await readFile25(indexPath, "utf-8");
+      const raw = await readFile26(indexPath, "utf-8");
       index = EvaluationIndexSchema.parse(JSON.parse(raw));
       index.lastOutcomeId = validated.id;
     } catch {}
@@ -21481,7 +21570,7 @@ async function appendOutcome(projectRoot, outcome) {
 async function listOutcomes(projectRoot, filter = {}) {
   try {
     const path = resolve25(projectRoot, EVAL_DIR, OUTCOMES_FILE);
-    const content = await readFile25(path, "utf-8");
+    const content = await readFile26(path, "utf-8");
     const lines = content.split(`
 `).filter((l) => l.trim().length > 0);
     const outcomes = [];
@@ -21541,7 +21630,7 @@ async function listScorecards(projectRoot, filter = {}) {
     for (const file of files) {
       if (!file.endsWith(".json"))
         continue;
-      const parsed = ScorecardRecordSchema.parse(JSON.parse(await readFile25(resolve25(dir, file), "utf-8")));
+      const parsed = ScorecardRecordSchema.parse(JSON.parse(await readFile26(resolve25(dir, file), "utf-8")));
       if (filter.backlogId && parsed.backlogId !== filter.backlogId)
         continue;
       if (filter.verdict && parsed.verdict !== filter.verdict)
@@ -21564,7 +21653,7 @@ async function hasPassingScorecard(projectRoot, backlogId) {
 async function loadScorecard(projectRoot, id) {
   try {
     const filePath = resolve25(projectRoot, EVAL_DIR, SCORECARDS_DIR, `${id}.json`);
-    const content = await readFile25(filePath, "utf-8");
+    const content = await readFile26(filePath, "utf-8");
     return ok(ScorecardRecordSchema.parse(JSON.parse(content)));
   } catch (e) {
     return err(e instanceof Error ? e : new Error(String(e)));
@@ -21656,11 +21745,11 @@ var init_outcome_store = __esm(() => {
 });
 
 // src/core/feedback/feedback-ingestor.ts
-import { readFile as readFile26 } from "node:fs/promises";
+import { readFile as readFile27 } from "node:fs/promises";
 import { join as join17 } from "node:path";
 async function parseChangelogLearnings(projectRoot) {
   try {
-    const content = await readFile26(join17(projectRoot, "CHANGELOG.md"), "utf-8");
+    const content = await readFile27(join17(projectRoot, "CHANGELOG.md"), "utf-8");
     const unreleased = content.match(/## \[Unreleased\]([\s\S]*?)(?=## \[|\n## )/i);
     if (!unreleased)
       return [];
@@ -22264,22 +22353,22 @@ __export(exports_rdd_receipt, {
   verifyReceipt: () => verifyReceipt
 });
 import { createHash as createHash4 } from "node:crypto";
-import { readdir as readdir7, readFile as readFile27 } from "node:fs/promises";
-import { join as join18, relative as relative7, resolve as resolve26, sep as sep5 } from "node:path";
+import { readdir as readdir7, readFile as readFile28 } from "node:fs/promises";
+import { join as join18, relative as relative9, resolve as resolve26, sep as sep7 } from "node:path";
 function sha2562(content) {
   return createHash4("sha256").update(content).digest("hex");
 }
 function canonicalPath(projectRoot, input) {
   const root = resolve26(projectRoot);
   const absolute = resolve26(root, input);
-  if (absolute !== root && !absolute.startsWith(`${root}${sep5}`)) {
+  if (absolute !== root && !absolute.startsWith(`${root}${sep7}`)) {
     throw new Error(`RDD receipt path "${input}" is outside the project root`);
   }
-  const normalized = relative7(root, absolute);
+  const normalized = relative9(root, absolute);
   if (!normalized || normalized === ".") {
     throw new Error("RDD receipts require file paths, not the project root");
   }
-  return { absolute, relative: normalized.split(sep5).join("/") };
+  return { absolute, relative: normalized.split(sep7).join("/") };
 }
 async function fingerprint(projectRoot, paths) {
   const deduplicated = new Map;
@@ -22289,7 +22378,7 @@ async function fingerprint(projectRoot, paths) {
   }
   const result = [];
   for (const [path, absolute] of [...deduplicated.entries()].sort(([left], [right]) => left.localeCompare(right))) {
-    result.push({ path, hash: sha2562(await readFile27(absolute)) });
+    result.push({ path, hash: sha2562(await readFile28(absolute)) });
   }
   return result;
 }
@@ -22334,7 +22423,7 @@ async function collectReceiptPaths(projectRoot) {
         continue;
       }
       if (entry.isFile())
-        paths.push(relative7(root, join18(current, entry.name)).split(sep5).join("/"));
+        paths.push(relative9(root, join18(current, entry.name)).split(sep7).join("/"));
     }
   }
   await visit2(root);
@@ -22349,7 +22438,7 @@ async function verifyReceipt(projectRoot, receipt) {
   for (const path of pathsToCheck) {
     try {
       const canonical = canonicalPath(projectRoot, path);
-      const hash = sha2562(await readFile27(canonical.absolute));
+      const hash = sha2562(await readFile28(canonical.absolute));
       const currentEntry = { path: canonical.relative, hash };
       current.push(currentEntry);
       currentByPath.set(currentEntry.path, currentEntry);
@@ -22386,7 +22475,7 @@ var init_rdd_receipt = __esm(() => {
 
 // src/core/verification/verification-runner.ts
 import { existsSync as existsSync3 } from "node:fs";
-import { readFile as readFile28 } from "node:fs/promises";
+import { readFile as readFile29 } from "node:fs/promises";
 import { dirname as dirname10, join as join19, resolve as resolve27 } from "node:path";
 import { mkdir as mkdir18, readdir as readdir8, writeFile as writeFile18 } from "node:fs/promises";
 function isPassingEvidence(ev) {
@@ -22449,7 +22538,7 @@ async function collectTaskEvidence(projectRoot, taskId) {
     if (!file.endsWith(".json"))
       continue;
     try {
-      const raw = await readFile28(join19(evDir, file), "utf-8");
+      const raw = await readFile29(join19(evDir, file), "utf-8");
       const ev = EvidenceSchema.parse(JSON.parse(raw));
       if (ev.relatedTask === taskId)
         records.push(ev);
@@ -22636,7 +22725,7 @@ async function loadTddSuiteEvidence(projectRoot, taskId, evidenceId) {
     return path;
   let raw;
   try {
-    raw = await readFile28(path.data, "utf-8");
+    raw = await readFile29(path.data, "utf-8");
   } catch (e) {
     return err(e instanceof Error ? e : new Error(String(e)));
   }
@@ -23037,8 +23126,8 @@ var init_loop_state = __esm(() => {
 });
 
 // src/core/loop/git-stats.ts
-import { execFile as execFile2 } from "node:child_process";
-import { promisify as promisify2 } from "node:util";
+import { execFile as execFile3 } from "node:child_process";
+import { promisify as promisify3 } from "node:util";
 function countPorcelain(output) {
   return output.split(`
 `).filter((line) => line.trim().length > 0).length;
@@ -23062,12 +23151,12 @@ function countNumstat(output) {
 async function fetchGitChangeStats(cwd) {
   try {
     const [status, diff] = await Promise.all([
-      execFileAsync2("git", ["status", "--porcelain"], {
+      execFileAsync3("git", ["status", "--porcelain"], {
         cwd,
         encoding: "utf-8",
         timeout: 15000
       }),
-      execFileAsync2("git", ["diff", "--numstat"], {
+      execFileAsync3("git", ["diff", "--numstat"], {
         cwd,
         encoding: "utf-8",
         timeout: 15000
@@ -23091,9 +23180,9 @@ async function readGitChangeStats(cwd, options) {
   cache = { cwd, at: now, stats };
   return stats;
 }
-var execFileAsync2, GIT_STATS_CACHE_TTL_MS = 3000, cache;
+var execFileAsync3, GIT_STATS_CACHE_TTL_MS = 3000, cache;
 var init_git_stats = __esm(() => {
-  execFileAsync2 = promisify2(execFile2);
+  execFileAsync3 = promisify3(execFile3);
 });
 
 // src/core/loop/loop-engine.ts
@@ -23826,11 +23915,11 @@ __export(exports_rdd_command, {
   rddCommand: () => rddCommand,
   rddStatus: () => rddStatus
 });
-import { execFile as execFile3 } from "node:child_process";
+import { execFile as execFile4 } from "node:child_process";
 import { existsSync as existsSync4 } from "node:fs";
-import { mkdir as mkdir19, readFile as readFile29, readdir as readdir9, rename as rename3, writeFile as writeFile19, chmod } from "node:fs/promises";
+import { mkdir as mkdir19, readFile as readFile30, readdir as readdir9, rename as rename3, writeFile as writeFile19, chmod } from "node:fs/promises";
 import { dirname as dirname11, resolve as resolve28 } from "node:path";
-import { promisify as promisify3 } from "node:util";
+import { promisify as promisify4 } from "node:util";
 function receiptPath(projectRoot, id) {
   const directory = resolve28(evidenceDir(projectRoot));
   const path = resolve28(directory, `${id.replace(/[^A-Za-z0-9_-]/g, "_")}.json`);
@@ -23839,7 +23928,7 @@ function receiptPath(projectRoot, id) {
   return path;
 }
 async function loadReceipt(projectRoot, id) {
-  const raw = await readFile29(receiptPath(projectRoot, id), "utf-8");
+  const raw = await readFile30(receiptPath(projectRoot, id), "utf-8");
   const evidence = EvidenceSchema.parse(JSON.parse(raw));
   if (evidence.type !== "rdd")
     throw new Error(`Evidence "${id}" is not an RDD receipt`);
@@ -23877,7 +23966,7 @@ async function rddStatus(projectRoot, taskId) {
   return receipts.sort((left, right) => right.timestamp.localeCompare(left.timestamp));
 }
 async function installHooks(projectRoot) {
-  const { stdout } = await execFileAsync3("git", ["rev-parse", "--git-path", "hooks"], {
+  const { stdout } = await execFileAsync4("git", ["rev-parse", "--git-path", "hooks"], {
     cwd: projectRoot,
     encoding: "utf8"
   });
@@ -23890,7 +23979,7 @@ async function installHooks(projectRoot) {
     const backup = resolve28(hooksDir, `${hook}.rdd-original`);
     const marker = "# codeconductor-rdd-hook";
     if (existsSync4(path)) {
-      const existing = await readFile29(path, "utf8");
+      const existing = await readFile30(path, "utf8");
       if (existing.includes(marker)) {
         skipped.push(hook);
         continue;
@@ -23969,12 +24058,12 @@ async function rddCommand(options) {
     return { code: 1, data: { success: false, errors: [error instanceof Error ? error.message : String(error)] } };
   }
 }
-var execFileAsync3;
+var execFileAsync4;
 var init_rdd_command = __esm(() => {
   init_schemas();
   init_paths();
   init_rdd_receipt();
-  execFileAsync3 = promisify3(execFile3);
+  execFileAsync4 = promisify4(execFile4);
 });
 
 // src/core/ccep/confirmation-gate.ts
@@ -24055,6 +24144,101 @@ function buildOpenspecPhaseContext(context, phase) {
   };
 }
 
+// src/core/ccep/output-validator.ts
+function resolveOutputSchemaName(schemaName, role) {
+  if (schemaName !== "agent-output" && SCHEMA_REGISTRY[schemaName]) {
+    return schemaName;
+  }
+  if (role === "implementer") {
+    return "implementer-output";
+  }
+  if (role === "reviewer") {
+    return "review-report";
+  }
+  if (role === "task-coach" || role === "architect") {
+    return schemaName === "technical-plan" ? "technical-plan" : "planner-output";
+  }
+  return schemaName;
+}
+function validateResolvedOutputSchema(schemaName, data) {
+  const schema = SCHEMA_REGISTRY[schemaName];
+  if (!schema) {
+    return {
+      valid: false,
+      schema: schemaName,
+      errors: [`Unknown output schema: ${schemaName}`]
+    };
+  }
+  const parsed = schema.safeParse(data);
+  if (parsed.success) {
+    return { valid: true, schema: schemaName, data: parsed.data };
+  }
+  return {
+    valid: false,
+    schema: schemaName,
+    errors: parsed.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+  };
+}
+function parseJsonInput(raw) {
+  return JSON.parse(raw);
+}
+function validateOutputForRole(role, outputSchema, data) {
+  const resolved = resolveOutputSchemaName(outputSchema, role);
+  if (resolved === "implementer-output") {
+    try {
+      return { valid: true, schema: "implementer-output", data: validateImplementerOutput(data) };
+    } catch (err3) {
+      return {
+        valid: false,
+        schema: "implementer-output",
+        errors: [String(err3)]
+      };
+    }
+  }
+  if (resolved === "review-report") {
+    try {
+      return { valid: true, schema: "review-report", data: validateReviewerOutput(data) };
+    } catch (err3) {
+      return {
+        valid: false,
+        schema: "review-report",
+        errors: [String(err3)]
+      };
+    }
+  }
+  if (resolved === "planner-output") {
+    try {
+      return { valid: true, schema: "planner-output", data: validatePlannerOutput(data) };
+    } catch (err3) {
+      return {
+        valid: false,
+        schema: "planner-output",
+        errors: [String(err3)]
+      };
+    }
+  }
+  return validateResolvedOutputSchema(resolved, data);
+}
+var SCHEMA_REGISTRY;
+var init_output_validator = __esm(() => {
+  init_schemas();
+  SCHEMA_REGISTRY = {
+    "planner-output": PlannerOutputSchema,
+    "implementer-output": ImplementerOutputSchema,
+    "review-report": ReviewerOutputSchema,
+    "technical-plan": TechnicalPlanOutputSchema,
+    "fix-intake-output": FixIntakeOutputSchema,
+    "council-verdict": CouncilVerdictSchema,
+    "agent-output": AgentOutputSchema,
+    taskcard: CanonicalTaskCardSchema,
+    "test-plan": AgentOutputSchema,
+    "complexity-audit": AgentOutputSchema,
+    "api-contract": AgentOutputSchema,
+    "pagespeed-report": AgentOutputSchema,
+    "scorecard-record": ScorecardRecordSchema
+  };
+});
+
 // src/core/ccep/prompt-compiler.ts
 function buildSystemLayer() {
   return [
@@ -24067,24 +24251,22 @@ function buildSystemLayer() {
   ].join(`
 `);
 }
-function buildAgentLayer(role, phase) {
+function buildAgentLayer(role, phase, outputSchema) {
   const label = ROLE_LABELS[role] ?? role;
+  let instruction;
   if (role === "task-coach" && phase === "intake") {
-    return `You are the Planner / ${label} of CodeConductor.
+    instruction = `You are the Planner / ${label} of CodeConductor.
 Convert product intent into a structured plan without writing code.`;
-  }
-  if (role === "implementer") {
-    return `You are the ${label}.
-Execute only your assigned phase: ${phase}.
-Write the minimal diff. Return implementer-output JSON only.`;
-  }
-  if (role === "reviewer") {
-    return `You are the ${label}.
+  } else if (role === "implementer") {
+    instruction = `You are the ${label}.
 Execute only your assigned phase: ${phase}.
-Return review-report JSON only.`;
-  }
-  return `You are the ${label}.
+Write the minimal diff.`;
+  } else {
+    instruction = `You are the ${label}.
 Execute only your assigned phase: ${phase}.`;
+  }
+  return `${instruction}
+Return ${outputSchema} JSON only.`;
 }
 function buildTaskLayer(context, phase) {
   if (context.envelope.command === "openspec") {
@@ -24094,19 +24276,28 @@ function buildTaskLayer(context, phase) {
     command: context.envelope.command,
     intent: context.intent,
     phase,
-    userRequest: context.envelope.userRequest,
     project: context.project.name
   }, null, 2);
 }
+function scopeKnowledgeForRole(knowledge, role) {
+  const keys = KNOWLEDGE_KEYS_BY_ROLE[role];
+  if (!keys)
+    return knowledge;
+  if (Object.keys(knowledge).some((key) => !PRODUCT_GRAPH_KNOWLEDGE_KEYS.has(key))) {
+    return knowledge;
+  }
+  return Object.fromEntries(keys.filter((key) => knowledge[key] !== undefined).map((key) => [key, knowledge[key]]));
+}
 function compilePrompt(options) {
   const { role, phase, context, promptVersion } = options;
   const phaseDef = context.profile.phases.find((p) => p.id === phase);
-  const schemaName = phaseDef?.outputSchema ?? context.outputSchema ?? "agent-output";
+  const configuredSchemaName = phaseDef?.outputSchema ?? context.outputSchema ?? "agent-output";
+  const schemaName = resolveOutputSchemaName(configuredSchemaName, role);
   const schemaBody = OUTPUT_SCHEMAS[schemaName] ?? OUTPUT_SCHEMAS["agent-output"];
-  const knowledge = context.envelope.command === "openspec" ? buildOpenspecPhaseContext(context, phase).knowledge : context.knowledge;
+  const knowledge = context.envelope.command === "openspec" ? buildOpenspecPhaseContext(context, phase).knowledge : scopeKnowledgeForRole(context.knowledge, role);
   const layers = [
     { name: "system", content: buildSystemLayer() },
-    { name: "agent", content: buildAgentLayer(role, phase) },
+    { name: "agent", content: buildAgentLayer(role, phase, schemaName) },
     {
       name: "policies",
       content: JSON.stringify({ ...context.policies, promptVersion }, null, 2)
@@ -24124,10 +24315,11 @@ ${schemaBody}`
 ${layer.content}`).join(`
 
 `);
-  return { layers, prompt };
+  return { layers, prompt, outputSchema: schemaName };
 }
-var ROLE_LABELS, OUTPUT_SCHEMAS;
+var ROLE_LABELS, OUTPUT_SCHEMAS, KNOWLEDGE_KEYS_BY_ROLE, PRODUCT_GRAPH_KNOWLEDGE_KEYS;
 var init_prompt_compiler = __esm(() => {
+  init_output_validator();
   ROLE_LABELS = {
     "task-coach": "Task Coach",
     architect: "Architect",
@@ -24182,108 +24374,50 @@ var init_prompt_compiler = __esm(() => {
   "filesChanged": [{ "path": "", "summary": "" }],
   "tests": { "runner": "", "result": "passed" | "failed" }
 }`,
-    "agent-output": '{ "status": "success", "artifacts": [], "next_actions": [] }'
-  };
-});
-
-// src/core/ccep/output-validator.ts
-function resolveOutputSchemaName(schemaName, role) {
-  if (schemaName !== "agent-output" && SCHEMA_REGISTRY[schemaName]) {
-    return schemaName;
-  }
-  if (role === "implementer") {
-    return "implementer-output";
-  }
-  if (role === "reviewer") {
-    return "review-report";
-  }
-  if (role === "task-coach" || role === "architect") {
-    return schemaName === "technical-plan" ? "technical-plan" : "planner-output";
-  }
-  return schemaName;
-}
-function validateAgentOutputBySchema(schemaName, data, role) {
-  const resolved = resolveOutputSchemaName(schemaName, role);
-  const schema = SCHEMA_REGISTRY[resolved];
-  if (!schema) {
-    return {
-      valid: false,
-      schema: resolved,
-      errors: [`Unknown output schema: ${resolved}`]
-    };
-  }
-  const parsed = schema.safeParse(data);
-  if (parsed.success) {
-    return { valid: true, schema: resolved, data: parsed.data };
-  }
-  return {
-    valid: false,
-    schema: resolved,
-    errors: parsed.error.issues.map((issue) => `${issue.path.join(".")}: ${issue.message}`)
-  };
-}
-function parseJsonInput(raw) {
-  return JSON.parse(raw);
-}
-function validateOutputForRole(role, outputSchema, data) {
-  if (role === "implementer") {
-    try {
-      return { valid: true, schema: "implementer-output", data: validateImplementerOutput(data) };
-    } catch (err3) {
-      return {
-        valid: false,
-        schema: "implementer-output",
-        errors: [String(err3)]
-      };
-    }
-  }
-  if (role === "reviewer") {
-    try {
-      return { valid: true, schema: "review-report", data: validateReviewerOutput(data) };
-    } catch (err3) {
-      return {
-        valid: false,
-        schema: "review-report",
-        errors: [String(err3)]
-      };
-    }
-  }
-  if (outputSchema === "planner-output" || role === "task-coach") {
-    try {
-      return { valid: true, schema: "planner-output", data: validatePlannerOutput(data) };
-    } catch (err3) {
-      return {
-        valid: false,
-        schema: "planner-output",
-        errors: [String(err3)]
-      };
-    }
-  }
-  return validateAgentOutputBySchema(outputSchema, data, role);
-}
-var SCHEMA_REGISTRY;
-var init_output_validator = __esm(() => {
-  init_schemas();
-  SCHEMA_REGISTRY = {
-    "planner-output": PlannerOutputSchema,
-    "implementer-output": ImplementerOutputSchema,
-    "review-report": ReviewerOutputSchema,
-    "technical-plan": TechnicalPlanOutputSchema,
-    "fix-intake-output": AgentOutputSchema,
-    "council-verdict": CouncilVerdictSchema,
-    "agent-output": AgentOutputSchema,
-    taskcard: CanonicalTaskCardSchema,
-    "test-plan": AgentOutputSchema,
-    "complexity-audit": AgentOutputSchema,
-    "api-contract": AgentOutputSchema,
-    "pagespeed-report": AgentOutputSchema,
-    "scorecard-record": ScorecardRecordSchema
-  };
+    "agent-output": `{
+  "status": "success" | "failure" | "blocked" | "needs_clarification",
+  "confidence": 0.0,
+  "warnings": [],
+  "artifacts": [],
+  "next_actions": []
+}`,
+    "scorecard-record": `{
+  "id": "",
+  "taskId": "",
+  "agent": "",
+  "contractVersion": "",
+  "criteria": [],
+  "weightedScore": 0.0,
+  "verdict": "PASS" | "REVISE" | "REJECT",
+  "findings": [],
+  "createdAt": ""
+}`
+  };
+  KNOWLEDGE_KEYS_BY_ROLE = {
+    "task-coach": ["productName", "domains", "requirements", "risks"],
+    architect: ["productName", "domains", "decisions", "requirements", "risks"],
+    tester: ["productName", "requirements", "risks"],
+    implementer: ["productName", "decisions", "requirements"],
+    reviewer: ["productName", "decisions", "requirements", "risks"],
+    docs: ["productName", "decisions", "requirements"],
+    "contract-builder": ["productName", "domains", "decisions", "requirements"],
+    "complexity-auditor": ["productName", "decisions", "requirements", "risks"],
+    orchestrator: ["productName", "domains", "decisions", "requirements", "risks"],
+    "repo-explorer": ["productName", "domains", "requirements"]
+  };
+  PRODUCT_GRAPH_KNOWLEDGE_KEYS = new Set([
+    "productName",
+    "domains",
+    "decisions",
+    "risks",
+    "requirements",
+    "nodeCount"
+  ]);
 });
 
 // src/core/ccep/command-parser.ts
 import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
-import { join as join20 } from "node:path";
+import { basename as basename7, join as join20 } from "node:path";
 function readProjectId(projectRoot) {
   const packageJsonPath = join20(projectRoot, "package.json");
   if (existsSync5(packageJsonPath)) {
@@ -24294,7 +24428,7 @@ function readProjectId(projectRoot) {
       }
     } catch {}
   }
-  return projectRoot.split("/").pop() ?? "unknown";
+  return basename7(projectRoot) || "unknown";
 }
 function parseCommand(command, userRequest, projectRoot) {
   const validatedCommand = WorkflowCommandSchema.parse(command);
@@ -24390,7 +24524,7 @@ var init_workflow_profile_loader = __esm(() => {
 // src/core/evaluation/harness-catalog.ts
 import { createHash as createHash5 } from "node:crypto";
 import { existsSync as existsSync6, readFileSync as readFileSync4 } from "node:fs";
-import { copyFile as copyFile2, mkdir as mkdir20, readFile as readFile30, readdir as readdir10, rm as rm4, writeFile as writeFile20 } from "node:fs/promises";
+import { copyFile as copyFile2, mkdir as mkdir20, readFile as readFile31, readdir as readdir10, rm as rm4, writeFile as writeFile20 } from "node:fs/promises";
 import { dirname as dirname12, join as join21, resolve as resolve29 } from "node:path";
 function catalogIds(catalog = DEFAULT_HARNESS_CATALOG) {
   return catalog.components.map((c) => c.id);
@@ -24446,7 +24580,7 @@ function harnessFingerprint(disabled, contractVersion, ccepProfile = "feature",
 async function loadHarnessCatalog(projectRoot) {
   const overridePath = resolve29(projectRoot, EVAL_DIR2, CATALOG_FILE);
   try {
-    const raw = await readFile30(overridePath, "utf-8");
+    const raw = await readFile31(overridePath, "utf-8");
     return HarnessCatalogSchema.parse($parse(raw));
   } catch {
     return DEFAULT_HARNESS_CATALOG;
@@ -24457,7 +24591,7 @@ function activeOverlayPath(projectRoot) {
 }
 async function readActiveOverlay(projectRoot) {
   try {
-    const raw = await readFile30(activeOverlayPath(projectRoot), "utf-8");
+    const raw = await readFile31(activeOverlayPath(projectRoot), "utf-8");
     return HarnessOverlaySchema.parse($parse(raw));
   } catch {
     return null;
@@ -24714,7 +24848,7 @@ var init_harness_catalog = __esm(() => {
 
 // src/core/openspec/openspec-state.ts
 import { createHash as createHash6 } from "node:crypto";
-import { mkdir as mkdir21, readFile as readFile31, rename as rename4, writeFile as writeFile21 } from "node:fs/promises";
+import { mkdir as mkdir21, readFile as readFile32, rename as rename4, writeFile as writeFile21 } from "node:fs/promises";
 import { resolve as resolve30 } from "node:path";
 function canTransition(from, to) {
   return ALLOWED_TRANSITIONS[from]?.includes(to) ?? false;
@@ -24742,7 +24876,7 @@ async function writeFileAtomic(path, content) {
 async function loadOpenspecState(projectRoot) {
   try {
     const filePath = resolve30(projectRoot, STATE_FILE);
-    const content = await readFile31(filePath, "utf-8");
+    const content = await readFile32(filePath, "utf-8");
     const data = JSON.parse(content);
     return ok(OpenspecStateSchema.parse(data));
   } catch (e) {
@@ -24867,7 +25001,7 @@ var init_openspec_state = __esm(() => {
 
 // src/core/ccep/context-resolver.ts
 import { existsSync as existsSync7 } from "node:fs";
-import { readFile as readFile32 } from "node:fs/promises";
+import { readFile as readFile33 } from "node:fs/promises";
 import { join as join22 } from "node:path";
 async function loadProductKnowledge(projectRoot) {
   if (isProductGraphDisabled(projectRoot)) {
@@ -24878,7 +25012,7 @@ async function loadProductKnowledge(projectRoot) {
     return {};
   }
   try {
-    const raw = await readFile32(graphPath, "utf-8");
+    const raw = await readFile33(graphPath, "utf-8");
     const graph = ProductGraphSchema.parse(JSON.parse(raw));
     return {
       productName: graph.productName,
@@ -25448,6 +25582,11 @@ async function ccepCommand(options) {
     input,
     contextPath,
     promptVersion = "v1.0.0",
+    view = "full",
+    recordTelemetry = false,
+    executionId,
+    taskId,
+    contextStrategy,
     config,
     rest
   } = options;
@@ -25498,6 +25637,28 @@ async function ccepCommand(options) {
       };
     }
     case "compile": {
+      if (!["prompt", "layers", "full"].includes(view)) {
+        return {
+          code: 1,
+          data: {
+            success: false,
+            command: "ccep compile",
+            errors: [`Unknown compile view: ${view}`]
+          }
+        };
+      }
+      if (contextStrategy !== undefined && !CONTEXT_STRATEGIES.includes(contextStrategy)) {
+        return {
+          code: 1,
+          data: {
+            success: false,
+            command: "ccep compile",
+            errors: [
+              `Invalid context strategy: ${contextStrategy}. Expected one of: ${CONTEXT_STRATEGIES.join(", ")}`
+            ]
+          }
+        };
+      }
       const parsed = parseWorkflowCommand(command);
       if (!parsed.ok) {
         return {
@@ -25548,12 +25709,69 @@ async function ccepCommand(options) {
           outputSchema: resolvedPhase.outputSchema
         };
       }
+      const compileStartedAt = Date.now();
       const compiled = compilePrompt({
         role: agentRole,
         phase: phaseId,
         context,
         promptVersion
       });
+      if (recordTelemetry) {
+        const event = await appendEvent(projectRoot, {
+          type: "context.compiled",
+          timestamp: new Date().toISOString(),
+          payload: {
+            workflow: parsed.command,
+            phase: phaseId,
+            agent: agentRole,
+            executionId: executionId ?? "unknown",
+            taskId: taskId ?? "unknown",
+            contextStrategy: contextStrategy ?? "unknown",
+            promptVersion,
+            view,
+            source: "compiler",
+            success: true,
+            provider: "unknown",
+            model: "unknown",
+            effort: "unknown",
+            sessionId: "unknown",
+            parentSessionId: "unknown",
+            requestedModel: "unknown",
+            effectiveModel: "unknown",
+            inputTokens: "unknown",
+            outputTokens: "unknown",
+            reasoningTokens: "unknown",
+            cacheReadTokens: "unknown",
+            cacheWriteTokens: "unknown",
+            cachedTokens: "unknown",
+            contextTokensEstimate: "unknown",
+            filesRead: "unknown",
+            uniqueFilesRead: "unknown",
+            repeatedFileReads: "unknown",
+            toolCalls: "unknown",
+            retries: "unknown",
+            compactions: "unknown",
+            modelSwitches: "unknown",
+            promptBytes: Buffer.byteLength(compiled.prompt, "utf-8"),
+            layerBytes: Object.fromEntries(compiled.layers.map((layer) => [
+              layer.name,
+              Buffer.byteLength(layer.content, "utf-8")
+            ])),
+            durationMs: Date.now() - compileStartedAt
+          }
+        });
+        if (!event.success) {
+          return {
+            code: 1,
+            data: {
+              success: false,
+              command: "ccep compile",
+              errors: [`Could not record compile telemetry: ${event.error.message}`]
+            }
+          };
+        }
+      }
+      const representation = view === "prompt" ? { prompt: compiled.prompt } : view === "layers" ? { layers: compiled.layers } : { layers: compiled.layers, prompt: compiled.prompt };
       return {
         code: 0,
         data: {
@@ -25561,10 +25779,9 @@ async function ccepCommand(options) {
           command: "ccep compile",
           phase: phaseId,
           role: agentRole,
-          outputSchema: resolvedPhase.outputSchema,
+          outputSchema: compiled.outputSchema,
           promptVersion,
-          layers: compiled.layers,
-          prompt: compiled.prompt
+          ...representation
         }
       };
     }
@@ -25818,9 +26035,11 @@ async function ccepCommand(options) {
       };
   }
 }
+var CONTEXT_STRATEGIES;
 var init_ccep_command = __esm(() => {
   init_path_containment();
   init_prompt_compiler();
+  init_episodic_store();
   init_output_validator();
   init_command_parser();
   init_context_resolver();
@@ -25828,6 +26047,7 @@ var init_ccep_command = __esm(() => {
   init_council_consensus();
   init_task_card_validator();
   init_schemas();
+  CONTEXT_STRATEGIES = ["sticky", "isolated", "artifact", "compact", "fork", "full"];
 });
 
 // src/core/openspec/backlog-validator.ts
@@ -25969,8 +26189,8 @@ var init_backlog_validator = __esm(() => {
 });
 
 // src/core/openspec/backlog-scanner.ts
-import { execFileSync as execFileSync2 } from "node:child_process";
-import { readFile as readFile33 } from "node:fs/promises";
+import { execFileSync } from "node:child_process";
+import { readFile as readFile34 } from "node:fs/promises";
 import { resolve as resolve31 } from "node:path";
 function itemSnapshot(items) {
   const snap = {};
@@ -25982,11 +26202,11 @@ function itemSnapshot(items) {
 async function scanBacklog(projectRoot, previousSnapshot = {}) {
   try {
     const filePath = resolve31(projectRoot, BACKLOG_FILENAME);
-    const content = await readFile33(filePath, "utf-8");
+    const content = await readFile34(filePath, "utf-8");
     const hash = hashContent(content);
     let fileChanged = true;
     try {
-      const diff = execFileSync2("git", ["diff", "--name-only", "--", BACKLOG_FILENAME], {
+      const diff = execFileSync("git", ["diff", "--name-only", "--", BACKLOG_FILENAME], {
         cwd: projectRoot,
         encoding: "utf-8",
         stdio: ["ignore", "pipe", "ignore"]
@@ -26220,7 +26440,7 @@ var init_backlog_planner = __esm(() => {
 
 // src/core/openspec/openspec-generator.ts
 import { mkdir as mkdir22, rename as rename5, writeFile as writeFile22 } from "node:fs/promises";
-import { basename as basename6, resolve as resolve32 } from "node:path";
+import { basename as basename8, resolve as resolve32 } from "node:path";
 function pad3(n) {
   return String(n).padStart(3, "0");
 }
@@ -26367,7 +26587,7 @@ capabilities:
 }
 async function archiveChangeFolder(projectRoot, changePath) {
   const src = resolve32(projectRoot, changePath);
-  const slug = basename6(changePath);
+  const slug = basename8(changePath);
   const destDir = resolve32(projectRoot, "openspec", "changes", "archive");
   await mkdir22(destDir, { recursive: true });
   const dest = resolve32(destDir, slug);
@@ -26392,8 +26612,8 @@ var init_openspec_generator = __esm(() => {
 });
 
 // src/core/openspec/spec-quality.ts
-import { readdir as readdir11, readFile as readFile34 } from "node:fs/promises";
-import { join as join23, relative as relative8, resolve as resolve33 } from "node:path";
+import { readdir as readdir11, readFile as readFile35 } from "node:fs/promises";
+import { join as join23, relative as relative10, resolve as resolve33 } from "node:path";
 function uniqueIds(matches) {
   return [...new Set(matches ?? [])];
 }
@@ -26549,17 +26769,17 @@ async function assessChangeFolder(projectRoot, changePath) {
   const extra = ["proposal.md", "design.md"].map((name) => join23(changeRoot, name));
   const reports = [];
   for (const file of specFiles) {
-    const content = await readFile34(file, "utf-8");
-    reports.push(assessSpecMarkdown(content, relative8(root, file).replace(/\\/g, "/")));
+    const content = await readFile35(file, "utf-8");
+    reports.push(assessSpecMarkdown(content, relative10(root, file).replace(/\\/g, "/")));
   }
   for (const file of extra) {
     let content;
     try {
-      content = await readFile34(file, "utf-8");
+      content = await readFile35(file, "utf-8");
     } catch {
       continue;
     }
-    const rel = relative8(root, file).replace(/\\/g, "/");
+    const rel = relative10(root, file).replace(/\\/g, "/");
     if (PLACEHOLDER.test(content)) {
       reports.push({
         valid: false,
@@ -26610,7 +26830,7 @@ var init_spec_quality = __esm(() => {
 });
 
 // src/core/openspec/spec-analyzer.ts
-import { readFile as readFile35, readdir as readdir12 } from "node:fs/promises";
+import { readFile as readFile36, readdir as readdir12 } from "node:fs/promises";
 import { join as join24, resolve as resolve34 } from "node:path";
 function unique(ids) {
   return [...new Set(ids)];
@@ -26648,7 +26868,7 @@ async function readDeltaSpecs(specDir) {
     if (entry.isDirectory()) {
       contents.push(await readDeltaSpecs(path));
     } else if (entry.isFile() && entry.name.endsWith(".md")) {
-      contents.push(await readFile35(path, "utf-8"));
+      contents.push(await readFile36(path, "utf-8"));
     }
   }
   return contents.filter(Boolean).join(`
@@ -26730,13 +26950,13 @@ async function analyzeChangeFolder(projectRoot, changePath, options) {
   const specMarkdown = await readDeltaSpecs(join24(changeRoot, "specs"));
   let tasksMarkdown = "";
   try {
-    tasksMarkdown = await readFile35(join24(changeRoot, "tasks.md"), "utf-8");
+    tasksMarkdown = await readFile36(join24(changeRoot, "tasks.md"), "utf-8");
   } catch {
     tasksMarkdown = "";
   }
   let designMarkdown;
   try {
-    designMarkdown = await readFile35(join24(changeRoot, "design.md"), "utf-8");
+    designMarkdown = await readFile36(join24(changeRoot, "design.md"), "utf-8");
   } catch {
     designMarkdown = undefined;
   }
@@ -26755,8 +26975,8 @@ var init_spec_analyzer = __esm(() => {
 });
 
 // src/core/openspec/spec-sync.ts
-import { mkdir as mkdir23, readFile as readFile36, readdir as readdir13 } from "node:fs/promises";
-import { join as join25, relative as relative9, resolve as resolve35 } from "node:path";
+import { mkdir as mkdir23, readFile as readFile37, readdir as readdir13 } from "node:fs/promises";
+import { join as join25, relative as relative11, resolve as resolve35 } from "node:path";
 async function markdownFiles(dir) {
   let entries;
   try {
@@ -26854,23 +27074,23 @@ async function syncChangeSpecs(projectRoot, changePath) {
   }
   const writes = [];
   for (const file of files) {
-    const delta = await readFile36(file, "utf-8");
+    const delta = await readFile37(file, "utf-8");
     const requirements = deltaRequirements(delta);
     if (requirements.length === 0) {
       return {
         success: false,
         syncedPaths: [],
-        errors: [`${relative9(root, file)}: no delta requirements found`]
+        errors: [`${relative11(root, file)}: no delta requirements found`]
       };
     }
-    const relativeSpec = relative9(changeSpecs, file);
+    const relativeSpec = relative11(changeSpecs, file);
     const target = join25(root, "openspec", "specs", relativeSpec);
     let existing = `# ${relativeSpec.replace(/\\/g, "/")}
 `;
     try {
-      existing = await readFile36(target, "utf-8");
+      existing = await readFile37(target, "utf-8");
     } catch {}
-    const merged = upsertRequirements(existing, requirements, relative9(root, file));
+    const merged = upsertRequirements(existing, requirements, relative11(root, file));
     if (!merged.ok)
       return { success: false, syncedPaths: [], errors: [merged.error] };
     writes.push({ path: target, content: merged.content });
@@ -26881,7 +27101,7 @@ async function syncChangeSpecs(projectRoot, changePath) {
   }
   return {
     success: true,
-    syncedPaths: writes.map((write) => relative9(root, write.path).replace(/\\/g, "/")),
+    syncedPaths: writes.map((write) => relative11(root, write.path).replace(/\\/g, "/")),
     errors: []
   };
 }
@@ -26897,7 +27117,7 @@ var exports_openspec_command = {};
 __export(exports_openspec_command, {
   openspecCommand: () => openspecCommand
 });
-import { readFile as readFile37 } from "node:fs/promises";
+import { readFile as readFile38 } from "node:fs/promises";
 import { resolve as resolve36 } from "node:path";
 async function openspecCommand(options) {
   const { subcommand, itemId, projectRoot, output, reason } = options;
@@ -26954,7 +27174,7 @@ async function persistState(projectRoot, state) {
   return { ok: true };
 }
 async function readBacklogMarkdown(projectRoot) {
-  return readFile37(resolve36(projectRoot, BACKLOG_FILENAME), "utf-8");
+  return readFile38(resolve36(projectRoot, BACKLOG_FILENAME), "utf-8");
 }
 async function transitionItem(projectRoot, item, to, progress) {
   const content = await readBacklogMarkdown(projectRoot);
@@ -27152,7 +27372,7 @@ async function handleAnalyze(projectRoot, itemId) {
   const policyParts = [];
   for (const name of ["AGENTS.md", "BACKLOG.md"]) {
     try {
-      policyParts.push(await readFile37(resolve36(projectRoot, name), "utf-8"));
+      policyParts.push(await readFile38(resolve36(projectRoot, name), "utf-8"));
     } catch {}
   }
   const cards = itemCards(stateResult.data, targetId);
@@ -27584,10 +27804,45 @@ function resumeDecision(changedPaths) {
 }
 var init_context_assembly = () => {};
 
+// src/core/ccep/handoff-envelope.ts
+function buildHandoffEnvelope(ledger, changedPaths) {
+  return HandoffEnvelopeSchema.parse({
+    version: 1,
+    task: {
+      id: ledger.taskCard.id,
+      objective: ledger.taskCard.objective,
+      acceptanceCriteria: ledger.taskCard.acceptanceCriteria,
+      status: ledger.taskCard.status
+    },
+    decisions: {
+      constraints: ledger.taskCard.constraints,
+      unresolved: ledger.tasks.filter((task) => task.status === "blocked").map((task) => task.title)
+    },
+    scope: {
+      relevantFiles: ledger.taskCard.targetFiles,
+      boundaries: ledger.taskCard.boundaries
+    },
+    verification: { evidence: ledger.evidence },
+    change: { touchedFiles: [...new Set(changedPaths)].sort() },
+    next: {
+      role: ledger.taskCard.agentType,
+      objective: ledger.nextStep
+    },
+    sources: {
+      deliveryLedger: ledger.id,
+      memoryTopicKey: ledger.memoryTopicKey,
+      technicalPlanPath: ledger.technicalPlanPath
+    }
+  });
+}
+var init_handoff_envelope = __esm(() => {
+  init_schemas();
+});
+
 // src/core/delivery/delivery-ledger.ts
 import { createHash as createHash7 } from "node:crypto";
-import { mkdir as mkdir24, readFile as readFile38, writeFile as writeFile23 } from "node:fs/promises";
-import { resolve as resolve37, sep as sep6 } from "node:path";
+import { mkdir as mkdir24, readFile as readFile39, writeFile as writeFile23 } from "node:fs/promises";
+import { resolve as resolve37, sep as sep8 } from "node:path";
 function ledgerPath(projectRoot, id) {
   if (!/^[a-z0-9][a-z0-9-]{0,63}$/.test(id))
     throw new Error("Invalid delivery ledger id");
@@ -27598,12 +27853,12 @@ async function fingerprintWorkspace(projectRoot, paths) {
   const fingerprints = {};
   for (const path of paths) {
     const candidate = resolve37(root, path);
-    if (candidate !== root && !candidate.startsWith(`${root}${sep6}`)) {
+    if (candidate !== root && !candidate.startsWith(`${root}${sep8}`)) {
       fingerprints[path] = "outside-root";
       continue;
     }
     try {
-      fingerprints[path] = createHash7("sha256").update(await readFile38(candidate)).digest("hex");
+      fingerprints[path] = createHash7("sha256").update(await readFile39(candidate)).digest("hex");
     } catch {
       fingerprints[path] = "missing";
     }
@@ -27626,7 +27881,7 @@ function parseLedger(content) {
   return DeliveryLedgerSchema.parse($parse(match[1]));
 }
 async function loadDeliveryLedger(projectRoot, id) {
-  return parseLedger(await readFile38(ledgerPath(projectRoot, id), "utf-8"));
+  return parseLedger(await readFile39(ledgerPath(projectRoot, id), "utf-8"));
 }
 async function createDeliveryLedger(projectRoot, input) {
   const request = DeliveryLedgerRequestSchema.parse(input);
@@ -27647,6 +27902,7 @@ async function createDeliveryLedger(projectRoot, input) {
     nextStep: request.nextStep,
     memoryTopicKey: `delivery:${request.id}`,
     workspace: await fingerprintWorkspace(projectRoot, request.taskCard.targetFiles),
+    technicalPlanPath: request.technicalPlanPath,
     createdAt: now,
     updatedAt: now
   });
@@ -27678,6 +27934,28 @@ var exports_odd_command = {};
 __export(exports_odd_command, {
   oddCommand: () => oddCommand
 });
+async function reconcileForResume(projectRoot, id) {
+  const result = await reconcileDeliveryLedger(projectRoot, id);
+  const memory = await loadMemoryIndex(projectRoot);
+  const { rddCommand: rddCommand2 } = await Promise.resolve().then(() => (init_rdd_command(), exports_rdd_command));
+  const rdd = await rddCommand2({
+    subcommand: "status",
+    projectRoot,
+    taskId: result.ledger.taskCard.id
+  });
+  const receipts = rdd.data.receipts ?? [];
+  const staleReceipt = receipts.some((receipt) => receipt.valid === false);
+  const changedPaths = staleReceipt ? [...result.changedPaths, "RDD receipt"].sort() : result.changedPaths;
+  return {
+    ...result,
+    changedPaths,
+    resume: resumeDecision(changedPaths),
+    status: changedPaths.length === 0 ? "ready" : "conflict",
+    rdd,
+    memory: memory.success ? "available" : "unavailable",
+    memoryPointers: memory.success ? memory.data.pointers.filter((pointer) => pointer.topic_key === result.ledger.memoryTopicKey) : []
+  };
+}
 async function oddCommand(options) {
   if (options.subcommand === "create") {
     let input = options.input;
@@ -27711,28 +27989,25 @@ async function oddCommand(options) {
       return { code: 0, data: { success: true, ledger: await loadDeliveryLedger(options.projectRoot, options.id) } };
     }
     if (options.subcommand === "reconcile") {
-      const result = await reconcileDeliveryLedger(options.projectRoot, options.id);
-      const memory = await loadMemoryIndex(options.projectRoot);
-      const { rddCommand: rddCommand2 } = await Promise.resolve().then(() => (init_rdd_command(), exports_rdd_command));
-      const rdd = await rddCommand2({
-        subcommand: "status",
-        projectRoot: options.projectRoot,
-        taskId: result.ledger.taskCard.id
-      });
-      const receipts = rdd.data.receipts ?? [];
-      const staleReceipt = receipts.some((receipt) => receipt.valid === false);
-      const changedPaths = staleReceipt ? [...result.changedPaths, "RDD receipt"].sort() : result.changedPaths;
+      const result = await reconcileForResume(options.projectRoot, options.id);
       return {
         code: 0,
         data: {
           success: true,
-          status: changedPaths.length === 0 ? "ready" : "conflict",
-          resume: resumeDecision(changedPaths),
-          rdd,
-          memory: memory.success ? "available" : "unavailable",
-          memoryPointers: memory.success ? memory.data.pointers.filter((pointer) => pointer.topic_key === result.ledger.memoryTopicKey) : [],
-          ...result,
-          changedPaths
+          ...result
+        }
+      };
+    }
+    if (options.subcommand === "handoff") {
+      const result = await reconcileForResume(options.projectRoot, options.id);
+      return {
+        code: 0,
+        data: {
+          success: true,
+          status: result.status,
+          changedPaths: result.changedPaths,
+          resume: result.resume,
+          handoff: buildHandoffEnvelope(result.ledger, result.changedPaths)
         }
       };
     }
@@ -27744,6 +28019,7 @@ async function oddCommand(options) {
 var init_odd_command = __esm(() => {
   init_memory_index();
   init_context_assembly();
+  init_handoff_envelope();
   init_task_card_validator();
   init_workflow_profile_loader();
   init_delivery_ledger();
@@ -27755,7 +28031,11 @@ function normalizeCommand(raw) {
   return raw.replace(/\s+/g, " ").trim();
 }
 function stripGitBinary(command) {
-  return command.replace(/(?:^|[\\/])git(?:\.exe)?\b/i, "git");
+  const match = command.match(/^(?:&\s*)?("[^"]+"|'[^']+'|[^\s]+)([\s\S]*)$/);
+  if (!match)
+    return command;
+  const binary = match[1].replace(/^["']|["']$/g, "").replace(/\\/g, "/").split("/").pop();
+  return /^git(?:\.exe)?$/i.test(binary ?? "") ? `git${match[2]}` : command;
 }
 function evaluatePath(filePath) {
   if (SENSITIVE_PATH.test(filePath.replace(/\//g, "\\")) || SENSITIVE_PATH.test(filePath)) {
@@ -27764,9 +28044,44 @@ function evaluatePath(filePath) {
   return allow();
 }
 function evaluateCommand(rawCommand) {
-  const command = stripGitBinary(normalizeCommand(rawCommand));
+  if (/(?:curl|wget)\b.+\|\s*(sh|bash|zsh|cmd)\b/i.test(normalizeCommand(rawCommand)))
+    return deny(MSG_POLICY);
+  const tokens = rawCommand.match(/"[^"]*"|'[^']*'|[^"';&|\r\n]+|[;&|\r\n]+/g) ?? [];
+  const commands = [];
+  let current = "";
+  for (const token of tokens) {
+    if (/^[;&|\r\n]+$/.test(token) && !(token === "&" && !current.trim())) {
+      commands.push(current);
+      current = "";
+    } else {
+      current += token;
+    }
+  }
+  commands.push(current);
+  let verdict = allow();
+  for (const part of commands) {
+    const result = evaluateSingleCommand(part);
+    if (result.action === "deny")
+      return result;
+    if (result.action === "ask")
+      verdict = result;
+  }
+  return verdict;
+}
+function evaluateSingleCommand(rawCommand) {
+  let command = stripGitBinary(normalizeCommand(rawCommand));
   if (!command)
     return allow();
+  if (/^git\s/i.test(command)) {
+    const words = command.match(/"[^"]*"|'[^']*'|\S+/g) ?? [];
+    let index = 1;
+    while (words[index]?.startsWith("-")) {
+      const option = words[index++];
+      if (/^(?:-C|-c|--git-dir|--work-tree|--namespace)$/.test(option))
+        index++;
+    }
+    command = ["git", ...words.slice(index)].join(" ");
+  }
   if (SENSITIVE_PATH.test(command) && READ_LIKE.test(command)) {
     return deny(MSG_SECRET);
   }
@@ -27789,9 +28104,12 @@ function evaluateCommand(rawCommand) {
   }
   if (/^rm\s+-rf\s+(\*|[\\/])/i.test(command))
     return deny(MSG_POLICY);
-  if (/^sudo\s+/i.test(command))
+  const windowsTarget = /(?:^|\s)["']?(?:[a-z]:[\\/]|\\|\*)/i.test(command);
+  if (windowsTarget && /^Remove-Item\b/i.test(command) && /\s-(?:Recurse|r)\b/i.test(command) && /\s-(?:Force|f)\b/i.test(command))
     return deny(MSG_POLICY);
-  if (/(?:curl|wget)\b.+\|\s*(sh|bash|zsh|cmd)\b/i.test(command))
+  if (windowsTarget && /^(?:rd|rmdir|del|erase)\b/i.test(command) && /\s\/s\b/i.test(command))
+    return deny(MSG_POLICY);
+  if (/^sudo\s+/i.test(command))
     return deny(MSG_POLICY);
   if (/^chmod\s+777\b/i.test(command))
     return deny(MSG_POLICY);
@@ -27818,13 +28136,16 @@ function evaluatePreTool(input) {
 function formatHookOutput(verdict, format) {
   if (format === "agy") {
     if (verdict.action === "deny") {
-      return JSON.stringify({ decision: "deny", error: verdict.message });
+      return JSON.stringify({ decision: "deny", reason: verdict.message });
     }
     if (verdict.action === "ask") {
       return JSON.stringify({ decision: "ask" });
     }
     return JSON.stringify({ decision: "allow" });
   }
+  if (verdict.action === "ask") {
+    return JSON.stringify({ hookSpecificOutput: { hookEventName: "PreToolUse", permissionDecision: "ask" } });
+  }
   return "";
 }
 function claudeExitCode(verdict) {
@@ -27835,11 +28156,24 @@ function parseAgyPayload(raw) {
     return {};
   try {
     const parsed = JSON.parse(raw);
-    const args = parsed.arguments ?? {};
+    const args = parsed.toolCall?.args ?? parsed.arguments ?? {};
+    return {
+      toolName: typeof (parsed.toolCall?.name ?? parsed.toolName) === "string" ? parsed.toolCall?.name ?? parsed.toolName : undefined,
+      command: typeof args.CommandLine === "string" ? args.CommandLine : undefined,
+      filePath: typeof args.TargetFile === "string" ? args.TargetFile : typeof args.AbsolutePath === "string" ? args.AbsolutePath : undefined
+    };
+  } catch {
+    return {};
+  }
+}
+function parseClaudePayload(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    const input = parsed.tool_input ?? {};
     return {
-      toolName: parsed.toolName,
-      command: args.CommandLine,
-      filePath: args.TargetFile ?? args.AbsolutePath
+      toolName: typeof parsed.tool_name === "string" ? parsed.tool_name : undefined,
+      command: typeof input.command === "string" ? input.command : undefined,
+      filePath: typeof input.file_path === "string" ? input.file_path : undefined
     };
   } catch {
     return {};
@@ -27890,7 +28224,7 @@ function isDestructiveRestore(command) {
 }
 var SENSITIVE_PATH, READ_LIKE, MSG_SECRET = "Bloqueado: intento de leer archivos sensibles", MSG_AUTHORITY = "Bloqueado: El agente no tiene autoridad sobre este comando.", MSG_POLICY = "Bloqueado: Command violated security policy";
 var init_hook_runner = __esm(() => {
-  SENSITIVE_PATH = /(?:\.env\b|secrets[/\\]|id_rsa|\.pem\b|\.key\b|(?:^|[/\\])\.ssh(?:[/\\]|$)|(?:^|[/\\])\.aws(?:[/\\]|$)|(?:^|[/\\])\.kube(?:[/\\]|$))/i;
+  SENSITIVE_PATH = /(?:\.env(?!\.example(?:$|[/\\]))\b|secrets[/\\]|id_rsa|\.pem\b|\.key\b|(?:^|[/\\])\.ssh(?:[/\\]|$)|(?:^|[/\\])\.aws(?:[/\\]|$)|(?:^|[/\\])\.kube(?:[/\\]|$))/i;
   READ_LIKE = /(?:^|[\s;&|])(cat|less|more|head|tail|type|Get-Content|cp|copy|mv|move|scp)\b/i;
 });
 
@@ -27901,14 +28235,17 @@ __export(exports_hook_command, {
   readStdinText: () => readStdinText
 });
 import { spawnSync } from "node:child_process";
-import { existsSync as existsSync8 } from "node:fs";
-import { resolve as resolve38 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync5 } from "node:fs";
+import { createRequire as createRequire2 } from "node:module";
+import { dirname as dirname13, resolve as resolve38 } from "node:path";
 function detectFormat(explicit, stdinText) {
   if (explicit)
     return explicit;
-  const trimmed = stdinText.trim();
-  if (trimmed.startsWith("{"))
-    return "agy";
+  try {
+    const payload = JSON.parse(stdinText);
+    if (payload && (("toolCall" in payload) || ("toolName" in payload) || ("workspacePaths" in payload)))
+      return "agy";
+  } catch {}
   return "claude";
 }
 async function readStdinText() {
@@ -27920,11 +28257,11 @@ async function readStdinText() {
   }
   return Buffer.concat(chunks).toString("utf8");
 }
-function resolvePreToolInput(options, stdinText) {
-  const fromStdin = parseAgyPayload(stdinText);
+function resolvePreToolInput(options, stdinText, format) {
+  const fromStdin = format === "agy" ? parseAgyPayload(stdinText) : parseClaudePayload(stdinText);
   return {
-    command: options.command ?? process.env.CLAUDE_TOOL_INPUT_COMMAND ?? fromStdin.command,
-    filePath: options.filePath ?? process.env.CLAUDE_TOOL_INPUT_FILE_PATH ?? fromStdin.filePath,
+    command: options.command ?? (process.env.CLAUDE_TOOL_INPUT_COMMAND || undefined) ?? fromStdin.command,
+    filePath: options.filePath ?? (process.env.CLAUDE_TOOL_INPUT_FILE_PATH || undefined) ?? fromStdin.filePath,
     toolName: fromStdin.toolName
   };
 }
@@ -27951,15 +28288,15 @@ async function hookCommand(options) {
     return { code: 0, data: { success: true, command: "hook session-start" } };
   }
   if (event === "post-tool") {
-    const filePath = options.filePath ?? process.env.CLAUDE_TOOL_INPUT_FILE_PATH ?? parseAgyPayload(stdinText).filePath;
-    formatWrittenFile(filePath);
+    const filePath = resolvePreToolInput(options, stdinText, format).filePath;
+    formatWrittenFile(filePath, options.projectRoot);
     if (format === "agy") {
       process.stdout.write(`{}
 `);
     }
     return { code: 0, data: { success: true, command: "hook post-tool" } };
   }
-  const input = resolvePreToolInput(options, stdinText);
+  const input = resolvePreToolInput(options, stdinText, format);
   const verdict = evaluatePreTool(input);
   if (format === "agy") {
     process.stdout.write(`${formatHookOutput(verdict, "agy")}
@@ -27973,23 +28310,40 @@ async function hookCommand(options) {
     process.stderr.write(`${verdict.message}
 `);
   }
+  const output = formatHookOutput(verdict, "claude");
+  if (output)
+    process.stdout.write(`${output}
+`);
   return {
     code: claudeExitCode(verdict),
     data: { success: verdict.action !== "deny", command: "hook pre-tool", verdict }
   };
 }
-function formatWrittenFile(filePath) {
-  if (!filePath || !existsSync8(filePath))
+function formatWrittenFile(filePath, projectRoot) {
+  if (!filePath)
+    return;
+  filePath = resolve38(projectRoot, filePath);
+  if (!existsSync8(filePath))
     return;
   const prettier = /\.(ts|tsx|js|jsx|mjs|cjs|json|jsonc|md|mdx|css|scss|html|astro|ya?ml)$/i;
   const eslint = /\.(ts|tsx|js|jsx|mjs|cjs)$/i;
   const python = /\.py$/i;
-  const opts = { stdio: "ignore", windowsHide: true };
+  const opts = { cwd: projectRoot, stdio: "ignore", windowsHide: true, timeout: 5000 };
+  const require2 = createRequire2(resolve38(projectRoot, "package.json"));
+  function runNodeTool(name, args) {
+    try {
+      const manifestPath = require2.resolve(`${name}/package.json`);
+      const manifest = JSON.parse(readFileSync5(manifestPath, "utf8"));
+      const bin = typeof manifest.bin === "string" ? manifest.bin : manifest.bin?.[name];
+      if (typeof bin === "string")
+        spawnSync(process.execPath, [resolve38(dirname13(manifestPath), bin), ...args], opts);
+    } catch {}
+  }
   if (prettier.test(filePath)) {
-    spawnSync("npx", ["--no-install", "prettier", "--write", filePath], opts);
+    runNodeTool("prettier", ["--write", filePath]);
   }
   if (eslint.test(filePath)) {
-    spawnSync("npx", ["--no-install", "eslint", "--fix", filePath], opts);
+    runNodeTool("eslint", ["--fix", filePath]);
   }
   if (python.test(filePath)) {
     spawnSync("ruff", ["format", filePath], opts);
@@ -28396,7 +28750,7 @@ function ccGainToScorecardImpact(result) {
 }
 
 // src/core/evaluation/scorecard-signals.ts
-import { execFileSync as execFileSync3 } from "node:child_process";
+import { execFileSync as execFileSync2 } from "node:child_process";
 function parseScopeFiles(scope) {
   return scope.split(/[,;]/).map((entry) => entry.trim().replace(/[.;:]$/, "").replace(/^`|`$/g, "")).filter(Boolean);
 }
@@ -28426,7 +28780,7 @@ function collectScorecardSignals(projectRoot, scopeFiles, extra) {
   }
   let diff = "";
   try {
-    diff = execFileSync3("git", ["diff", "HEAD"], {
+    diff = execFileSync2("git", ["diff", "HEAD"], {
       cwd: projectRoot,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "ignore"]
@@ -28521,8 +28875,8 @@ var init_scorecard_signals = __esm(() => {
 
 // src/core/evaluation/harness-experiment.ts
 import { existsSync as existsSync9 } from "node:fs";
-import { cp, mkdir as mkdir25, readFile as readFile39, readdir as readdir14, writeFile as writeFile24 } from "node:fs/promises";
-import { dirname as dirname13, join as join26, resolve as resolve39 } from "node:path";
+import { cp, mkdir as mkdir25, readFile as readFile40, readdir as readdir14, writeFile as writeFile24 } from "node:fs/promises";
+import { dirname as dirname14, join as join26, resolve as resolve39 } from "node:path";
 function experimentDir(projectRoot, experimentId) {
   return resolve39(projectRoot, EVAL_DIR2, EXPERIMENTS_DIR, experimentId);
 }
@@ -28538,7 +28892,7 @@ async function loadHarnessSuite(projectRoot, suiteId, suitePath) {
     if (!existsSync9(path))
       continue;
     try {
-      const suite = HarnessSuiteSchema.parse($parse(await readFile39(path, "utf-8")));
+      const suite = HarnessSuiteSchema.parse($parse(await readFile40(path, "utf-8")));
       return ok({ ...suite, path });
     } catch (e) {
       return err(e instanceof Error ? e : new Error(String(e)));
@@ -28548,7 +28902,7 @@ async function loadHarnessSuite(projectRoot, suiteId, suitePath) {
 }
 async function loadExperiment(projectRoot, experimentId) {
   try {
-    const raw = await readFile39(experimentYamlPath(projectRoot, experimentId), "utf-8");
+    const raw = await readFile40(experimentYamlPath(projectRoot, experimentId), "utf-8");
     return ok(HarnessExperimentSchema.parse($parse(raw)));
   } catch (e) {
     if (e.code === "ENOENT") {
@@ -28637,7 +28991,7 @@ function generateExperimentId(suiteId, now = new Date) {
   return `abl-${date}-${suiteId}-${rand}`;
 }
 async function copyFixture(suitePath, fixtureDir, dest) {
-  const source = fixtureDir ? resolve39(dirname13(suitePath), fixtureDir) : join26(dirname13(suitePath), "fixture");
+  const source = fixtureDir ? resolve39(dirname14(suitePath), fixtureDir) : join26(dirname14(suitePath), "fixture");
   await mkdir25(dest, { recursive: true });
   if (existsSync9(source)) {
     await cp(source, dest, { recursive: true });
@@ -28823,11 +29177,11 @@ var init_suite_run = __esm(() => {
 });
 
 // src/core/evaluation/execution-profile.ts
-import { readFile as readFile40 } from "node:fs/promises";
+import { readFile as readFile41 } from "node:fs/promises";
 import { resolve as resolve41 } from "node:path";
 async function loadExecutionProfile(projectRoot, defaultTarget = "opencode") {
   try {
-    const content = await readFile40(resolve41(projectRoot, PROFILE_FILE), "utf-8");
+    const content = await readFile41(resolve41(projectRoot, PROFILE_FILE), "utf-8");
     const data = $parse(content);
     return ExecutionProfileSchema.parse(data);
   } catch {
@@ -28907,7 +29261,7 @@ var init_execution_profile = __esm(() => {
 });
 
 // src/core/evaluation/prompt-diff.ts
-import { readFile as readFile41, readdir as readdir15 } from "node:fs/promises";
+import { readFile as readFile42, readdir as readdir15 } from "node:fs/promises";
 import { join as join27, resolve as resolve42 } from "node:path";
 function normalizeVersion(v) {
   return v.startsWith("v") ? v : `v${v}`;
@@ -28967,7 +29321,7 @@ async function diffPromptVersions(fromVersion, toVersion, options = {}) {
     const f = join27(root, fromV);
     const t = join27(root, toV);
     try {
-      await readFile41(join27(f, "orchestrator.md"), "utf-8");
+      await readFile42(join27(f, "orchestrator.md"), "utf-8");
       fromDir = f;
       toDir = t;
       break;
@@ -28978,7 +29332,7 @@ async function diffPromptVersions(fromVersion, toVersion, options = {}) {
     toDir = join27(ROOT_PRESETS_DIR, "opencode", "prompts", toV);
   } else {
     try {
-      await readFile41(join27(toDir, "orchestrator.md"), "utf-8");
+      await readFile42(join27(toDir, "orchestrator.md"), "utf-8");
     } catch {
       toDir = join27(ROOT_PRESETS_DIR, "opencode", "prompts", toV);
     }
@@ -28998,12 +29352,12 @@ async function diffPromptVersions(fromVersion, toVersion, options = {}) {
     let oldText = "";
     let newText = "";
     try {
-      oldText = await readFile41(join27(fromDir, name), "utf-8");
+      oldText = await readFile42(join27(fromDir, name), "utf-8");
     } catch {
       oldText = "";
     }
     try {
-      newText = await readFile41(join27(toDir, name), "utf-8");
+      newText = await readFile42(join27(toDir, name), "utf-8");
     } catch {
       newText = "";
     }
@@ -29042,13 +29396,13 @@ var init_prompt_diff = __esm(() => {
 });
 
 // src/core/evaluation/regression-checklist.ts
-import { execFileSync as execFileSync4 } from "node:child_process";
-import { mkdir as mkdir26, readFile as readFile42, writeFile as writeFile25 } from "node:fs/promises";
-import { dirname as dirname14, resolve as resolve43 } from "node:path";
+import { execFileSync as execFileSync3 } from "node:child_process";
+import { mkdir as mkdir26, readFile as readFile43, writeFile as writeFile25 } from "node:fs/promises";
+import { dirname as dirname15, resolve as resolve43 } from "node:path";
 async function loadRegressionChecklist() {
   try {
     const path = resolve43(ROOT_PRESETS_DIR, "templates", "regression-checklist.yml");
-    const content = await readFile42(path, "utf-8");
+    const content = await readFile43(path, "utf-8");
     const data = $parse(content);
     return data.checks ?? [];
   } catch {
@@ -29062,7 +29416,7 @@ function runCheckCommand(cmd, cwd) {
   if (!file)
     return { passed: false, message: "Empty command" };
   try {
-    execFileSync4(file, args, {
+    execFileSync3(file, args, {
       cwd,
       encoding: "utf-8",
       stdio: ["ignore", "pipe", "pipe"],
@@ -29104,7 +29458,7 @@ async function runRegressionChecklist(projectRoot, options = {}) {
       timestamp: new Date().toISOString()
     };
     const outPath = resolve43(projectRoot, ".codeconductor/evaluation/regression-last.json");
-    await mkdir26(dirname14(outPath), { recursive: true });
+    await mkdir26(dirname15(outPath), { recursive: true });
     await writeFile25(outPath, JSON.stringify(report, null, 2), "utf-8");
     return ok(report);
   } catch (e) {
@@ -29378,7 +29732,7 @@ var exports_scorecard_command = {};
 __export(exports_scorecard_command, {
   scorecardCommand: () => scorecardCommand
 });
-import { readFile as readFile43 } from "node:fs/promises";
+import { readFile as readFile44 } from "node:fs/promises";
 import { resolve as resolve46 } from "node:path";
 function contractVersion() {
   return package_default.version;
@@ -29669,7 +30023,7 @@ async function handleCompareModels(projectRoot, options) {
   const markdown = generateModelComparisonMarkdown(outcomes, options.modelsFilter);
   const templatePath = resolve46(projectRoot, ".codeconductor/evaluation/model-comparison-last.md");
   try {
-    await readFile43(templatePath);
+    await readFile44(templatePath);
   } catch {}
   const { writeFile: writeFile28, mkdir: mkdir28 } = await import("node:fs/promises");
   await mkdir28(resolve46(projectRoot, ".codeconductor/evaluation"), { recursive: true });
@@ -31516,6 +31870,7 @@ var COMMANDS = [
   { name: "setup", group: "getting-started", summary: "Configure and install CodeConductor.", usage: ["cc-codeconductor setup [--target <target>] [--locale en|es] [--yes] [--dry-run]"] },
   { name: "detect", group: "getting-started", summary: "Inspect the project stack and recommended presets.", usage: ["cc-codeconductor detect"] },
   { name: "init", group: "getting-started", summary: "Initialize low-level CodeConductor configuration.", usage: ["cc-codeconductor init [--locale en|es]"] },
+  { name: "usage", group: "getting-started", summary: "Show installation examples for presets, council, and LSP.", usage: ["cc-codeconductor usage"] },
   { name: "install", group: "getting-started", summary: "Install harness components.", usage: ["cc-codeconductor install preset --target <target>"], options: ["--target opencode|claude|codex|gemini|cursor|agy|pi|all"], subcommands: [
     { name: "preset", group: "getting-started", summary: "Install agents, prompts, skills, and commands.", usage: ["cc-codeconductor install preset --target <target> [--locale en|es]"] },
     { name: "council", group: "getting-started", summary: "Install generated council files.", usage: ["cc-codeconductor install council --target <target>"] },
@@ -31535,6 +31890,7 @@ var COMMANDS = [
   { name: "ingest", group: "workflow", summary: "Ingest repository knowledge into the product graph.", usage: ["cc-codeconductor ingest"] },
   { name: "product", group: "workflow", summary: "Explore the product graph and memory.", usage: ["cc-codeconductor product <subcommand>"] },
   { name: "ccep", group: "workflow", summary: "Run CCEP contract workflows.", usage: ["cc-codeconductor ccep <subcommand>"] },
+  { name: "odd", group: "workflow", summary: "Create, resume, and hand off tracked delivery work.", usage: ["cc-codeconductor odd <create|read|reconcile|handoff>"] },
   { name: "openspec", group: "workflow", summary: "Run the OpenSpec delivery loop.", usage: ["cc-codeconductor openspec <subcommand>"] },
   { name: "scorecard", group: "workflow", summary: "Record and aggregate outcomes.", usage: ["cc-codeconductor scorecard <subcommand>"] },
   { name: "orchestrate", group: "workflow", summary: "Run goal execution orchestration.", usage: ["cc-codeconductor orchestrate <subcommand>"] },
@@ -31629,11 +31985,102 @@ _arguments '1:command:(${names})' '--target[target]:target:(${targets})'`;
   return null;
 }
 
+// src/cli/usage-guide.ts
+init_cli_bin();
+var RECOMMENDED_FLOW = [
+  "cc-codeconductor setup --target claude",
+  "cc-codeconductor setup --target claude --locale es --yes",
+  "cc-codeconductor setup --target claude --dry-run"
+];
+var PRIMITIVES = [
+  "cc-codeconductor detect",
+  "cc-codeconductor init --locale es",
+  "cc-codeconductor install preset --target claude",
+  "cc-codeconductor install council --target claude",
+  "cc-codeconductor install lsp --target claude"
+];
+var PRESET_EXAMPLES = [
+  "cc-codeconductor install preset --target claude",
+  "cc-codeconductor install preset --target claude --global",
+  "cc-codeconductor install preset --target claude --force",
+  "cc-codeconductor install preset --target claude --dry-run",
+  "cc-codeconductor install preset --target all",
+  "cc-codeconductor install preset --target claude --locale es",
+  "cc-codeconductor install preset --target claude --global --force"
+];
+var COUNCIL_EXAMPLES = [
+  "cc-codeconductor install council --target claude",
+  "cc-codeconductor install council --target claude --global",
+  "cc-codeconductor install council --target claude --force",
+  "cc-codeconductor install council --target claude --dry-run",
+  "cc-codeconductor install council --target all",
+  "cc-codeconductor install council --target claude --global --force"
+];
+var LSP_EXAMPLES = [
+  "cc-codeconductor install lsp --target claude --lang typescript,python",
+  "cc-codeconductor install lsp --target all --lang typescript,python",
+  "cc-codeconductor install lsp --target claude --global",
+  "cc-codeconductor install lsp --target claude --dry-run"
+];
+var AFTER_INSTALL_EXAMPLES = [
+  ["cc-codeconductor doctor", "validates the installation"],
+  ["cc-codeconductor status", "shows what is installed"],
+  ["cc-codeconductor update --dry-run", "previews reconciliation of managed files after upgrading"],
+  ["cc-codeconductor update --force", "applies reconciliation of managed files after upgrading"],
+  ["cc-codeconductor migrate --dry-run", "previews repair of orphaned artifacts a reinstall cannot fix"]
+];
+function renderExamples(lines, bin) {
+  return lines.map((line) => `  ${formatUsage(line, bin)}`);
+}
+function renderAnnotatedExamples(entries, bin) {
+  return entries.map(([line, description]) => `  ${formatUsage(line, bin)} — ${description}`);
+}
+function renderUsageGuide(bin = resolveCliBin()) {
+  return [
+    "CodeConductor — installation usage guide",
+    "",
+    "Recommended flow (one command, installs and configures everything):",
+    ...renderExamples(RECOMMENDED_FLOW, bin),
+    "",
+    "Fine-grained primitives (for scripting or partial installs):",
+    ...renderExamples(PRIMITIVES, bin),
+    "",
+    "Shared flags:",
+    "  --target    opencode|claude|codex|gemini|cursor|agy|pi|all (default: opencode)",
+    "  --global    Install to the home directory (~/.claude, ~/.opencode, etc.) instead of the project",
+    "  --force     Allow overwriting existing files",
+    "  --dry-run   Show what would happen without writing files",
+    "  --locale    Instruction language for agent files: en (default) | es — install preset only",
+    "  --lang      Comma-separated languages to install LSP servers for — install lsp only",
+    "  --output    Output mode: human (default) | json",
+    "",
+    "install preset — agents, prompts, skills, and commands:",
+    ...renderExamples(PRESET_EXAMPLES, bin),
+    "",
+    "install council — generated council spec files:",
+    ...renderExamples(COUNCIL_EXAMPLES, bin),
+    "",
+    "install lsp — language servers:",
+    ...renderExamples(LSP_EXAMPLES, bin),
+    "  Dedicated integration config is generated for: opencode, claude, codex, gemini, cursor, agy.",
+    "  pi installs the language servers but does not get a dedicated integration config file.",
+    "",
+    "After installing, verify and keep in sync:",
+    ...renderAnnotatedExamples(AFTER_INSTALL_EXAMPLES, bin),
+    "",
+    "More detail (GitHub only, not bundled in the npm package):",
+    "  docs/usage-cli.md         Detailed CLI reference, incl. per-target generated files",
+    "  docs/getting-started/     Installation, first project, and update walkthroughs"
+  ].join(`
+`);
+}
+
 // src/cli/router.ts
 var OutputModeSchema = exports_external.enum(["json", "human"]);
 var SeoFormatSchema = exports_external.enum(["cli", "json", "markdown"]);
 var SeoFailOnSchema = exports_external.enum(["error", "warning", "never"]);
 var NonNegativeIntegerSchema = exports_external.coerce.number().int().nonnegative();
+var BOOLEAN_OPTIONS = new Set(["record-telemetry"]);
 function parseArgs(args) {
   const commandAcceptsOutputPath = args[0] === "seo";
   const flags = {
@@ -31704,6 +32151,9 @@ function parseArgs(args) {
       } else if (value !== undefined) {
         options[key] = value;
         consumed.add(i);
+      } else if (BOOLEAN_OPTIONS.has(key)) {
+        options[key] = true;
+        consumed.add(i);
       } else if (remaining[i + 1] && !remaining[i + 1].startsWith("-")) {
         options[key] = remaining[++i];
         consumed.add(i - 1);
@@ -31909,6 +32359,8 @@ async function routeCommand(args, projectRoot) {
     case "docs":
     case "man":
       return { code: 0, data: { success: true, command, output: renderDocs(subcommand) } };
+    case "usage":
+      return { code: 0, data: { success: true, command: "usage", output: renderUsageGuide() } };
     case "completion": {
       const output = renderCompletion(subcommand ?? "");
       return output ? { code: 0, data: { success: true, command: "completion", output } } : cliContractError("completion", ["Expected shell: bash, zsh, fish, or powershell."]);
@@ -32059,6 +32511,11 @@ async function routeCommand(args, projectRoot) {
         input: options.input,
         contextPath: options.context || options.contextPath,
         promptVersion: options["prompt-version"] || options.promptVersion,
+        view: options.view,
+        recordTelemetry: options["record-telemetry"] === true || options["record-telemetry"] === "true",
+        executionId: options["execution-id"],
+        taskId: options["task-id"],
+        contextStrategy: options["context-strategy"],
         config: options.config,
         rest: validateRest
       });
@@ -32099,7 +32556,7 @@ async function routeCommand(args, projectRoot) {
       });
     }
     case "odd": {
-      const validSubs = ["create", "read", "reconcile"];
+      const validSubs = ["create", "read", "reconcile", "handoff"];
       if (!subcommand || !validSubs.includes(subcommand)) {
         return unknownSubcommand(command, subcommand ?? "", validSubs);
       }