@orchestrator-claude/definitions 3.31.1 → 3.32.0

package/hooks/subagent-stop.ts

@@ -14,44 +14,103 @@ import {
   getField,
   getActiveWorkflow,
   outputContext,
-} from "./lib/api-client.js";
-import { createCheckpointIfNeeded } from "./lib/git-checkpoint.js";
+  readInvocationState,
+  consumeInvocationState,
+  completeAgentInvocation,
+  isInvocationStateStale,
+} from './lib/api-client.js';
+import { join } from 'node:path';
+import { createCheckpointIfNeeded } from './lib/git-checkpoint.js';
+import { appendObservation } from './lib/observations-helper.js';
 
-const HOOK = "SUBAGENT-STOP";
+const HOOK = 'SUBAGENT-STOP';
 
 async function main(): Promise<void> {
   const stdin = await readStdin();
-  log(HOOK, "SubagentStop triggered");
+  log(HOOK, 'SubagentStop triggered');
 
   const agentType =
-    getField(stdin, "agent_type") ||
-    getField(stdin, "tool_input.subagent_type") ||
-    "unknown";
+    getField(stdin, 'agent_type') || getField(stdin, 'tool_input.subagent_type') || 'unknown';
 
   const workflow = await getActiveWorkflow();
   if (!workflow) {
-    log(HOOK, "No active workflow, skipping");
+    log(HOOK, 'No active workflow, skipping');
     return;
   }
 
   log(HOOK, `agent=${agentType} workflow=${workflow.id} phase=${workflow.currentPhase}`);
 
-  // 1. Invocation tracking — agent self-reports via MCP; this is safety net
-  log(HOOK, `COMPLETE: agent=${agentType} (safety net — agent self-reports via MCP)`);
+  // 1. Invocation tracking safety net — complete via state file if agent did not self-report via MCP
+  const invocationState = readInvocationState(workflow.id, agentType);
+  if (invocationState) {
+    log(
+      HOOK,
+      `COMPLETE safety-net: found state file for agent=${agentType} invocationId=${invocationState.invocationId}`
+    );
+    if (isInvocationStateStale(invocationState)) {
+      log(
+        HOOK,
+        `COMPLETE safety-net: state file is stale (>4h) for invocationId=${invocationState.invocationId} — deleting without completing`
+      );
+      consumeInvocationState(workflow.id, agentType);
+    } else {
+      const completed = await completeAgentInvocation(
+        invocationState.invocationId,
+        'completed',
+        `Safety-net completion: agent ${agentType} finished phase ${workflow.currentPhase}`
+      );
+      if (completed) {
+        consumeInvocationState(workflow.id, agentType);
+        log(
+          HOOK,
+          `COMPLETE safety-net: invocationId=${invocationState.invocationId} marked complete, state file deleted`
+        );
+      } else {
+        log(
+          HOOK,
+          `COMPLETE safety-net: POST failed for invocationId=${invocationState.invocationId} (fail-open, continuing)`
+        );
+      }
+    }
+  } else {
+    log(
+      HOOK,
+      `COMPLETE: agent=${agentType} — no state file (agent self-reported via MCP or start hook skipped)`
+    );
+  }
 
   // 2. Git checkpoint if phase changed
   const commitHash = await createCheckpointIfNeeded(workflow.id, workflow.currentPhase);
 
   // 3. Guide main conversation — NO ping-pong, main IS the orchestrator
-  const parts: string[] = [`[ORCHESTRATOR] Agent '${agentType}' completed for workflow ${workflow.id}.`];
+  const parts: string[] = [
+    `[ORCHESTRATOR] Agent '${agentType}' completed for workflow ${workflow.id}.`,
+  ];
 
   if (commitHash) {
     parts.push(`Checkpoint: ${commitHash}.`);
   }
 
-  parts.push("Proceed to gate check via AskUserQuestion before advancing phase.");
+  parts.push('Proceed to gate check via AskUserQuestion before advancing phase.');
+
+  outputContext('SubagentStop', parts.join(' '));
 
-  outputContext("SubagentStop", parts.join(" "));
+  // 4. Write Tier B observation (fail-open)
+  try {
+    const sessionId = getField(stdin, 'session_id') || getField(stdin, 'claude_session_id') || '';
+    const memoryBaseDir = join(process.cwd(), '.claude', 'agent-memory');
+    appendObservation(memoryBaseDir, agentType, {
+      timestamp: new Date().toISOString(),
+      session_id: sessionId,
+      phase: workflow.currentPhase,
+      workflow_id: workflow.id,
+      summary: `Agent ${agentType} completed phase ${workflow.currentPhase}${commitHash ? ` (checkpoint: ${commitHash})` : ''}`,
+      tags: [`agent:${agentType}`, `phase:${workflow.currentPhase}`],
+    });
+    log(HOOK, `Observation written for agent=${agentType}`);
+  } catch {
+    log(HOOK, 'Failed to write observation (fail-open, continuing)');
+  }
 }
 
 main().catch(() => process.exit(0));

package/hooks/user-prompt.ts

@@ -12,27 +12,28 @@ import {
   getNextAction,
   detectWorkflow,
   outputContext,
-} from "./lib/api-client.js";
+} from './lib/api-client.js';
+import { readSprintContext } from './lib/sprint-context.js';
 
-const HOOK = "USER-PROMPT";
+const HOOK = 'USER-PROMPT';
 
 async function main(): Promise<void> {
-  log(HOOK, "UserPromptSubmit triggered");
+  log(HOOK, 'UserPromptSubmit triggered');
 
   const stdin = await readStdin();
   const workflow = await getActiveWorkflow();
 
   if (!workflow) {
     // No active workflow — detect and suggest
-    const prompt = getField(stdin, "prompt");
+    const prompt = getField(stdin, 'prompt');
     if (!prompt) {
-      log(HOOK, "empty prompt, silence");
+      log(HOOK, 'empty prompt, silence');
       return;
     }
 
     const detection = await detectWorkflow(prompt);
     if (!detection) {
-      log(HOOK, "detect API failed/timeout, silence (fail-open)");
+      log(HOOK, 'detect API failed/timeout, silence (fail-open)');
       return;
     }
 
@@ -40,25 +41,25 @@ async function main(): Promise<void> {
     log(HOOK, `detected type=${workflowType} confidence=${confidence} mode=${suggestedMode}`);
 
     // Tier 1: interactive_analysis
-    if (workflowType === "interactive_analysis") {
+    if (workflowType === 'interactive_analysis') {
       outputContext(
-        "UserPromptSubmit",
+        'UserPromptSubmit',
         [
-          "[ORCHESTRATOR] This looks like an analytical/design request. How would you like to proceed?",
+          '[ORCHESTRATOR] This looks like an analytical/design request. How would you like to proceed?',
           '(a) Continue as a free conversation (no workflow)',
           '(b) Start an interactive_analysis workflow for structured exploration (cyclic phases: research → discuss → analyze)',
-          "",
+          '',
           'If you choose (b), I will call: mcp__orchestrator-tools__startWorkflow({ type: "interactive_analysis", prompt: "..." })',
-        ].join("\n")
+        ].join('\n')
       );
       return;
     }
 
     // Tier 2: high confidence (>= 0.7)
     if (confidence >= 0.7) {
-      const mode = suggestedMode || "standard";
+      const mode = suggestedMode || 'standard';
       outputContext(
-        "UserPromptSubmit",
+        'UserPromptSubmit',
         `[ORCHESTRATOR] Detected: ${workflowType} workflow (confidence: ${confidence}, suggested mode: ${mode}).\nTo start: mcp__orchestrator-tools__startWorkflow({ type: "${workflowType}", prompt: "...", mode: "${mode}" })\nOr continue without a workflow if this is exploratory.`
       );
       return;
@@ -67,7 +68,7 @@ async function main(): Promise<void> {
     // Tier 3: medium confidence (0.5-0.69)
     if (confidence >= 0.5) {
       outputContext(
-        "UserPromptSubmit",
+        'UserPromptSubmit',
         `[ORCHESTRATOR] Hint: this might be a ${workflowType} task. Consider starting a workflow if you plan to write code.`
       );
       return;
@@ -78,6 +79,33 @@ async function main(): Promise<void> {
     return;
   }
 
+  // Active workflow — check for brainstorm context injection (RFC-027)
+  const prompt = getField(stdin, 'prompt');
+  if (/brainstorm/i.test(prompt)) {
+    try {
+      const sprintCtx = readSprintContext(workflow.id);
+      if (sprintCtx) {
+        const previousSummary =
+          sprintCtx.previousSprints.length === 0
+            ? 'none'
+            : sprintCtx.previousSprints.map((s) => `S${s.index}(${s.status})`).join(', ');
+
+        // Context format: keep in sync with brainstormContextBranch in user-prompt-brainstorm.test.ts
+        const brainstormContext = [
+          `[PARENT-DOC-CONTEXT] parentDocument=${sprintCtx.parentDocument} | sprint=${sprintCtx.sprintIndex} | scope=${sprintCtx.sprintScope} | previousSprints=${previousSummary}`,
+          `[ORCHESTRATOR] Include parent document context in this brainstorm. Read the RFC for background.`,
+        ].join('\n');
+
+        log(HOOK, `brainstorm detected, injecting sprint context for workflow=${workflow.id}`);
+        outputContext('UserPromptSubmit', brainstormContext);
+        return;
+      }
+    } catch {
+      // fail-open: if readSprintContext throws unexpectedly, continue to standard injection
+      log(HOOK, 'brainstorm context read failed, falling through to standard injection');
+    }
+  }
+
   // Active workflow — inject state
   const action = await getNextAction(workflow.id);
   let context: string;
@@ -89,7 +117,7 @@ async function main(): Promise<void> {
   }
 
   log(HOOK, `workflow=${workflow.id} hasAction=${action?.hasAction}`);
-  outputContext("UserPromptSubmit", context);
+  outputContext('UserPromptSubmit', context);
 }
 
 main().catch(() => process.exit(0));

package/hooks/workflow-guard.ts

@@ -1,10 +1,25 @@
 /**
  * workflow-guard.ts — PreToolUse[Write|Edit] hook (RFC-022 Phase 2)
  * Replaces workflow-guard.sh
+ *
  * Blocks writes to src/ and tests/ without active workflow.
- * Respects SKIP_WORKFLOW_GUARD, quick/interactive modes, sub-agent writes.
+ *
+ * Allow paths (in evaluation order):
+ *   1. SKIP_WORKFLOW_GUARD=true (explicit bypass, all paths)
+ *   2. Non-guarded path (file outside src/ or tests/)
+ *   3. Config/doc file extension (.json|.yaml|.yml|.md|.env*)
+ *   4. Active workflow + mode='quick' (main agent writes allowed by design)
+ *   5. Active workflow + mode='interactive' (writes unexpected, but allowed)
+ *   6. Active workflow + mode='direct' (ADR-017 Phase 3 — tracked via startDirectExecution)
+ *   7. Active workflow + caller is sub-agent (agent_id present in stdin)
+ *   8. Active workflow + SKIP_SUBAGENT_GUARD=true (DEPRECATED — ADR-013 §6.5.3, telemetered to observations.yaml)
+ * Deny paths:
+ *   - Active workflow + standard/full/legacy mode + main agent direct write (no agent_id, no bypass)
+ *   - No active workflow
  */
 
+import { join } from 'node:path';
+
 import {
   log,
   readStdin,
@@ -12,35 +27,39 @@ import {
   getActiveWorkflow,
   getWorkflowMode,
   outputPreToolUse,
-} from "./lib/api-client.js";
+} from './lib/api-client.js';
+import { appendObservation } from './lib/observations-helper.js';
 
-const HOOK = "WORKFLOW-GUARD";
+const HOOK = 'WORKFLOW-GUARD';
 
 async function main(): Promise<void> {
   const stdin = await readStdin();
-  const filePath = getField(stdin, "tool_input.file_path") || getField(stdin, "file_path") || getField(stdin, "input.file_path");
+  const filePath =
+    getField(stdin, 'tool_input.file_path') ||
+    getField(stdin, 'file_path') ||
+    getField(stdin, 'input.file_path');
 
   log(HOOK, `file_path=${filePath}`);
 
   // Explicit bypass
-  if (process.env.SKIP_WORKFLOW_GUARD === "true") {
-    log(HOOK, "ALLOW (SKIP_WORKFLOW_GUARD=true)");
+  if (process.env.SKIP_WORKFLOW_GUARD === 'true') {
+    log(HOOK, 'ALLOW (SKIP_WORKFLOW_GUARD=true)');
     outputPreToolUse({
-      decision: "allow",
-      context: "Workflow guard bypassed via SKIP_WORKFLOW_GUARD=true.",
+      decision: 'allow',
+      context: 'Workflow guard bypassed via SKIP_WORKFLOW_GUARD=true.',
     });
     return;
   }
 
   // Only guard src/ and tests/ paths
-  if (!filePath.includes("/src/") && !filePath.includes("/tests/")) {
-    log(HOOK, "ALLOW (non-guarded path)");
+  if (!filePath.includes('/src/') && !filePath.includes('/tests/')) {
+    log(HOOK, 'ALLOW (non-guarded path)');
     return;
   }
 
   // Allow config/doc files
   if (/\.(json|ya?ml|md|env(\..*)?)$/.test(filePath)) {
-    log(HOOK, "ALLOW (config/doc file)");
+    log(HOOK, 'ALLOW (config/doc file)');
     return;
   }
 
@@ -49,71 +68,111 @@ async function main(): Promise<void> {
 
   if (workflow) {
     const mode = await getWorkflowMode(workflow.id);
-    log(HOOK, `workflow=${workflow.id} mode=${mode || "legacy"}`);
+    log(HOOK, `workflow=${workflow.id} mode=${mode || 'legacy'}`);
 
-    if (mode === "quick") {
+    if (mode === 'quick') {
       outputPreToolUse({
-        decision: "allow",
+        decision: 'allow',
         context: `Active workflow: ${workflow.id} (mode: quick). Direct writes allowed in quick mode.`,
       });
       return;
     }
 
-    if (mode === "interactive") {
+    if (mode === 'interactive') {
       outputPreToolUse({
-        decision: "allow",
+        decision: 'allow',
         context: `Active workflow: ${workflow.id} (mode: interactive). Note: code writes are unexpected in interactive/analysis workflows.`,
       });
       return;
     }
 
+    // ADR-017 Phase 3: direct execution mode — main agent writes without sub-agent required
+    if (mode === 'direct') {
+      log(HOOK, `ALLOW (executionMode=direct, workflow: ${workflow.id})`);
+      outputPreToolUse({
+        decision: 'allow',
+        context: `Active workflow: ${workflow.id} (executionMode: direct). Direct writes allowed — record will be tracked via startDirectExecution/completeDirectExecution.`,
+      });
+      return;
+    }
+
     // Check if running inside a sub-agent
-    const agentId = getField(stdin, "agent_id");
+    const agentId = getField(stdin, 'agent_id');
     if (agentId) {
-      const agentType = getField(stdin, "agent_type");
-      log(HOOK, `ALLOW (sub-agent: ${agentType || "unknown"}, workflow: ${workflow.id})`);
+      const agentType = getField(stdin, 'agent_type');
+      log(HOOK, `ALLOW (sub-agent: ${agentType || 'unknown'}, workflow: ${workflow.id})`);
       outputPreToolUse({
-        decision: "allow",
-        context: `Active workflow: ${workflow.id}. Sub-agent ${agentType || "unknown"} write allowed.`,
+        decision: 'allow',
+        context: `Active workflow: ${workflow.id}. Sub-agent ${agentType || 'unknown'} write allowed.`,
       });
       return;
     }
 
     // Main agent writing directly — check SKIP_SUBAGENT_GUARD
-    if (process.env.SKIP_SUBAGENT_GUARD === "true") {
-      log(HOOK, `ALLOW (SKIP_SUBAGENT_GUARD=true, workflow: ${workflow.id})`);
+    // DEPRECATED per ADR-013 §6.5.3 — preferred replacements are mode='quick'
+    // (single-phase, main-agent writes) or mode='direct' (ADR-017 Phase 3,
+    // multi-phase main-agent writes with startDirectExecution audit trail).
+    // Each bypass is recorded to .claude/agent-memory/main/observations.yaml
+    // (RFC-027 Sprint 3) so usage can be measured before full removal.
+    if (process.env.SKIP_SUBAGENT_GUARD === 'true') {
+      log(HOOK, `ALLOW (SKIP_SUBAGENT_GUARD=true, workflow: ${workflow.id}) [DEPRECATED]`);
+
+      // Fail-open observation for cross-session telemetry
+      try {
+        const sessionId =
+          getField(stdin, 'session_id') || getField(stdin, 'claude_session_id') || '';
+        const memoryBaseDir = join(process.cwd(), '.claude', 'agent-memory');
+        appendObservation(memoryBaseDir, 'main', {
+          timestamp: new Date().toISOString(),
+          session_id: sessionId,
+          phase: workflow.currentPhase || 'unknown',
+          workflow_id: workflow.id,
+          summary: `SKIP_SUBAGENT_GUARD bypass triggered. file=${filePath} mode=${mode || 'legacy'}. Prefer mode:'quick' or mode:'direct' (ADR-013 §6.5.3).`,
+          tags: ['skip_subagent_guard_bypass', 'deprecated_bypass', `mode:${mode || 'legacy'}`],
+        });
+      } catch {
+        // fail-open — never block on telemetry
+      }
+
       outputPreToolUse({
-        decision: "allow",
-        context: `Active workflow: ${workflow.id}. Direct write allowed via SKIP_SUBAGENT_GUARD.`,
+        decision: 'allow',
+        context: [
+          `Active workflow: ${workflow.id}. Direct write allowed via SKIP_SUBAGENT_GUARD.`,
+          '',
+          '⚠️ DEPRECATED per ADR-013 §6.5.3. Prefer:',
+          "  • mode:'quick' (startWorkflow({ mode: 'quick' })) — single-phase, main-agent writes allowed by design",
+          "  • mode:'direct' (ADR-017 Phase 3) — multi-phase, main-agent writes with startDirectExecution audit trail",
+          'Bypass logged to .claude/agent-memory/main/observations.yaml for usage review (S200+ remediation decision).',
+        ].join('\n'),
       });
       return;
     }
 
     // Main agent direct write — DENY
-    log(HOOK, `DENY (main agent direct write, mode=${mode || "legacy"})`);
+    log(HOOK, `DENY (main agent direct write, mode=${mode || 'legacy'})`);
     outputPreToolUse({
-      decision: "deny",
+      decision: 'deny',
       reason:
-        "Workflow Guard: Direct code writes are blocked. You must invoke a sub-agent (e.g. implementer) to write code. The sub-agent will have write access.",
+        'Workflow Guard: Direct code writes are blocked. You must invoke a sub-agent (e.g. implementer) to write code. The sub-agent will have write access.',
       context:
-        "Use the Agent tool to spawn an implementer sub-agent for code changes. The workflow-guard allows writes only from sub-agents (identified by agent_id in hook input).",
+        'Use the Agent tool to spawn an implementer sub-agent for code changes. The workflow-guard allows writes only from sub-agents (identified by agent_id in hook input).',
     });
     return;
   }
 
   // No active workflow — DENY
-  log(HOOK, "DENY (no active workflow)");
+  log(HOOK, 'DENY (no active workflow)');
   outputPreToolUse({
-    decision: "deny",
-    reason: "Workflow Guard: No active workflow. Direct implementation is not allowed.",
+    decision: 'deny',
+    reason: 'Workflow Guard: No active workflow. Direct implementation is not allowed.',
     context: [
-      "You MUST start a workflow before writing code:",
+      'You MUST start a workflow before writing code:',
       '1. mcp__orchestrator-tools__detectWorkflow({ prompt: "..." })',
       '2. mcp__orchestrator-tools__startWorkflow({ workflowType: "...", prompt: "..." })',
-      "3. Follow the nextStep returned by startWorkflow",
-      "",
-      "The workflow-guard hook blocks all writes to src/ and tests/ without an active workflow.",
-    ].join("\n"),
+      '3. Follow the nextStep returned by startWorkflow',
+      '',
+      'The workflow-guard hook blocks all writes to src/ and tests/ without an active workflow.',
+    ].join('\n'),
   });
 }
 

package/manifest.json

@@ -1,8 +1,8 @@
 {
   "schema": "orchestrator-definitions/v1",
   "namespace": "orchestrator",
-  "version": "3.31.1",
-  "generatedAt": "2026-05-23T19:07:04.611Z",
+  "version": "3.32.0",
+  "generatedAt": "2026-06-25T19:16:00.614Z",
   "definitions": {
     "agents": [
       {
@@ -65,7 +65,7 @@
         "slug": "docs-guardian",
         "file": "agents/docs-guardian.md",
         "version": "1.0.0",
-        "checksum": "sha256:26ace0b39cc85221186bc89cc5041394309f3831021d60ec600afe63dcb883b2",
+        "checksum": "sha256:b9d5b1a102a56f7927d43ccf3cb64332789c61a8c53ad1395bf1d6211d617c01",
         "supersedes": null,
         "metadata": {}
       },
@@ -211,7 +211,7 @@
         "slug": "backlog-synthesis",
         "file": "skills/backlog-synthesis/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:2c15ca7c45b052c929fe7a5ab34be7a82f6f8805f99dbb930c5f7cfbee91b828",
+        "checksum": "sha256:e077bbf16cfbb6a79fbda114df884066b57b93fff83d5d0bffdace46f62ae964",
         "supersedes": null,
         "metadata": {}
       },
@@ -403,7 +403,7 @@
         "slug": "workflow-status",
         "file": "skills/workflow-status/SKILL.md",
         "version": "1.0.0",
-        "checksum": "sha256:96c2afc874e1d783435b8fffb654caea5307338d5f53ccfa56ce9d17a097bfbc",
+        "checksum": "sha256:7390c8d966110f5e0f8935b61363c6252cde5674423355742a5ebe8c76b790ad",
         "supersedes": null,
         "metadata": {}
       }
@@ -413,7 +413,7 @@
         "slug": "dangling-guard",
         "file": "hooks/dangling-guard.ts",
         "version": "1.0.0",
-        "checksum": "sha256:9f26167f1e001c4740faa3434483286d26b566ca98802b26fd142c068ef18088",
+        "checksum": "sha256:795ab6cb17039f6fd503d484a49a9bfe1b8a4b735098a9499bd679e534296da1",
         "supersedes": null,
         "metadata": {}
       },
@@ -421,7 +421,7 @@
         "slug": "gate-guardian",
         "file": "hooks/gate-guardian.ts",
         "version": "1.0.0",
-        "checksum": "sha256:25b4d3a6d7f15943f3873a92414d3bceadefe89eb41c75874623b8b5eca05e82",
+        "checksum": "sha256:d4098999b3f4cf28f9bc309f6355a00aaa4d9df90b66c17ec32f27bd20d55bf9",
         "supersedes": null,
         "metadata": {}
       },
@@ -429,7 +429,23 @@
         "slug": "api-client",
         "file": "hooks/lib/api-client.ts",
         "version": "1.0.0",
-        "checksum": "sha256:3872730877dc22c73f9bc3c5f49f752d90bd98db9deaa5e693e4fde15deadc25",
+        "checksum": "sha256:fdac374cfabb58865d676e24157d15bc9d81cdabf62a5a6d28c66e9a95fdf69e",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "capability-scanner",
+        "file": "hooks/lib/capability-scanner.ts",
+        "version": "1.0.0",
+        "checksum": "sha256:f366c0afdcc06224d2e80566b3e5eaf6e06cf9af3b80c10d3c9acae4690f1c97",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "finops-parser",
+        "file": "hooks/lib/finops-parser.ts",
+        "version": "1.0.0",
+        "checksum": "sha256:4acdcd904dd956c0375b11ebfbadca904b51635033c64d10f96f721235247c55",
         "supersedes": null,
         "metadata": {}
       },
@@ -437,7 +453,7 @@
         "slug": "gate-logic",
         "file": "hooks/lib/gate-logic.ts",
         "version": "1.0.0",
-        "checksum": "sha256:156607b7f34da7fdef1aa05f05c5b61673249fc84685ed1e121c1cef8174488c",
+        "checksum": "sha256:d3fe80209e5a8267214c314ef7f6fad474764fddb9d398c660e33071ee604a7a",
         "supersedes": null,
         "metadata": {}
       },
@@ -445,7 +461,23 @@
         "slug": "git-checkpoint",
         "file": "hooks/lib/git-checkpoint.ts",
         "version": "1.0.0",
-        "checksum": "sha256:d816d30a840e2a12ad7261779bedf0b42affa14ac37a1cfed8a4b7217798fa55",
+        "checksum": "sha256:9a001448abbb96d974af14db0a93763426a6409aaa68fb338547795f493ac636",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "observations-helper",
+        "file": "hooks/lib/observations-helper.ts",
+        "version": "1.0.0",
+        "checksum": "sha256:76b531c227e616582a0a2989d19e60e3fe86bfc02a2dee12e32a8b7acfe18faf",
+        "supersedes": null,
+        "metadata": {}
+      },
+      {
+        "slug": "sprint-context",
+        "file": "hooks/lib/sprint-context.ts",
+        "version": "1.0.0",
+        "checksum": "sha256:fc681215c9a41615d8d902e0a39f18406d6e130780d7408ed264fbfc9eab8f1c",
         "supersedes": null,
         "metadata": {}
       },
@@ -453,7 +485,7 @@
         "slug": "mailbox-listener",
         "file": "hooks/mailbox-listener.ts",
         "version": "1.0.0",
-        "checksum": "sha256:ac237b81575182b2d4c7fba2c84dd6c6dd2d11c323a4f48b0e586c1b71ca34ab",
+        "checksum": "sha256:8112646bf356b209e986af38d2f9e8f71a01a38947540af76611ccc0725a718d",
         "supersedes": null,
         "metadata": {}
       },
@@ -461,15 +493,15 @@
         "slug": "post-compact",
         "file": "hooks/post-compact.ts",
         "version": "1.0.0",
-        "checksum": "sha256:9fce966c6e08cbd1241a42ab14c89f98f92adb569fbe149f59ef4cf0d5084bd9",
+        "checksum": "sha256:966ca9cf9dc32fc1b31e28fb36fdfc4732cd785bbbef7909de6d10ab1a79aec9",
         "supersedes": null,
         "metadata": {}
       },
       {
-        "slug": "pre-agent-dispatch",
-        "file": "hooks/pre-agent-dispatch.ts",
+        "slug": "post-implement",
+        "file": "hooks/post-implement.ts",
         "version": "1.0.0",
-        "checksum": "sha256:888b511de88c71ce3c429b8681a3e301f308f4f208ae101c5820885916eae445",
+        "checksum": "sha256:132c474d4e31ff76abaff10032b4389e015b6fe6e44d03becbe98a87bb89bbbd",
         "supersedes": null,
         "metadata": {}
       },
@@ -477,7 +509,7 @@
         "slug": "session-start",
         "file": "hooks/session-start.ts",
         "version": "1.0.0",
-        "checksum": "sha256:7d8c69c9f9d3cc219aa15bca152777328ac9d7bc9da42b7eb7f6182bc98b8ecf",
+        "checksum": "sha256:c8adea2c3cdfd0eebfe488d81260fb0eed26e88a231586b4af6174efebe87781",
         "supersedes": null,
         "metadata": {}
       },
@@ -485,7 +517,7 @@
         "slug": "sprint-registry",
         "file": "hooks/sprint-registry.ts",
         "version": "1.0.0",
-        "checksum": "sha256:324dcea52ca724cd89cd8ce73eb8e9dca78e578cde1078b3a0bbf95df3cdd6f2",
+        "checksum": "sha256:340e40adc35b75c1b09bdc5b9166272098e52db7a91e6d870ba7cd6ccba8b4ab",
         "supersedes": null,
         "metadata": {}
       },
@@ -493,7 +525,7 @@
         "slug": "subagent-start",
         "file": "hooks/subagent-start.ts",
         "version": "1.0.0",
-        "checksum": "sha256:724b4ff1a9bc9b46964e490b805dfca9efebfd72d94908929c5836682b079627",
+        "checksum": "sha256:1c9ea66ec85376d7a40b943d3b8b44c602faedad809df0419d85d8e454664a24",
         "supersedes": null,
         "metadata": {}
       },
@@ -501,7 +533,7 @@
         "slug": "subagent-stop",
         "file": "hooks/subagent-stop.ts",
         "version": "1.0.0",
-        "checksum": "sha256:6d16bb0649c27897d6bc79f0af8d2f7f04071b163989b7014e7c1aece3057622",
+        "checksum": "sha256:569408e36602087ccc8ada1f61de3a365fe92a4705332913094a6160cacee753",
         "supersedes": null,
         "metadata": {}
       },
@@ -509,15 +541,7 @@
         "slug": "user-prompt",
         "file": "hooks/user-prompt.ts",
         "version": "1.0.0",
-        "checksum": "sha256:59e701c9642a25fe60f975dd6b114d9de33cf0bfaeada0a5600c47cf2620847f",
-        "supersedes": null,
-        "metadata": {}
-      },
-      {
-        "slug": "verification-before-completion",
-        "file": "hooks/verification-before-completion.ts",
-        "version": "1.0.0",
-        "checksum": "sha256:83fc4baf7a5117cd6c0368592fc1ee254d1b138f0a38f88c554c72aa63713279",
+        "checksum": "sha256:93e247dffd5609cf9c179f653bf072be19e4c94d11bf420743046795e68cf9d3",
         "supersedes": null,
         "metadata": {}
       },
@@ -525,7 +549,7 @@
         "slug": "workflow-guard",
         "file": "hooks/workflow-guard.ts",
         "version": "1.0.0",
-        "checksum": "sha256:6ebc0c67afb4d5a1a94174054d64809866b8741b477cc72483634e14c5d2af46",
+        "checksum": "sha256:b70edb5d65d370ce230b1666171230c58c9f425e9cbb49687f08d236bc164e2c",
         "supersedes": null,
         "metadata": {}
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchestrator-claude/definitions",
-  "version": "3.31.1",
+  "version": "3.32.0",
   "description": "Built-in definitions (agents, skills, hooks, workflows, KB seeds) for the Orchestrator ecosystem",
   "type": "module",
   "main": "dist/index.js",