speckeeper 0.11.1 → 0.13.0

package/dist/cli.js

@@ -39,7 +39,9 @@ var init_agents = __esm({
       can_execute_tools: [
         "speckeeper-cli"
       ],
-      can_invoke_agents: [],
+      can_invoke_agents: [
+        "spec-quality-reviewer"
+      ],
       can_return_handoffs: [
         "requirement-audit-result",
         "trace-link-result",
@@ -449,9 +451,14 @@ var init_workflows = __esm({
           type: "delegate",
           task: "audit-requirement-quality",
           from_agent: "spec-quality-reviewer",
-          description: "",
+          description: "Execute LLM-based requirement audit. Retries once on adapter error (exit 12).",
           optional: false,
-          max_retries: 0
+          max_retries: 1
+        },
+        {
+          type: "gate",
+          gate_kind: "requirement-audit-result",
+          description: "Block if RequirementAuditResult fails schema validation or no specs were found in configuration (stop_and_report)."
         }
       ]
     };
@@ -467,9 +474,14 @@ var init_workflows = __esm({
           type: "delegate",
           task: "propose-trace-links",
           from_agent: "spec-quality-reviewer",
-          description: "",
+          description: "Execute LLM-based trace link analysis. Retries once on adapter error (exit 12).",
           optional: false,
-          max_retries: 0
+          max_retries: 1
+        },
+        {
+          type: "gate",
+          gate_kind: "trace-link-result",
+          description: "Block if TraceLinkResult fails schema validation or no specs were found in configuration (stop_and_report)."
         }
       ]
     };
@@ -485,9 +497,14 @@ var init_workflows = __esm({
           type: "delegate",
           task: "explain-impact-result",
           from_agent: "spec-quality-reviewer",
-          description: "",
+          description: "Execute LLM-based impact explanation. Retries once on adapter error (exit 12).",
           optional: false,
-          max_retries: 0
+          max_retries: 1
+        },
+        {
+          type: "gate",
+          gate_kind: "impact-explain-result",
+          description: "Block if ImpactExplainResult fails schema validation or stdin was empty/invalid (stop_and_report)."
         }
       ]
     };
@@ -503,9 +520,14 @@ var init_workflows = __esm({
           type: "delegate",
           task: "propose-acceptance-criteria",
           from_agent: "spec-quality-reviewer",
-          description: "",
+          description: "Execute LLM-based acceptance criteria proposal. Retries once on adapter error (exit 12).",
           optional: false,
-          max_retries: 0
+          max_retries: 1
+        },
+        {
+          type: "gate",
+          gate_kind: "acceptance-criteria-result",
+          description: "Block if AcceptanceCriteriaResult fails schema validation or no specs were found in configuration (stop_and_report)."
         }
       ]
     };
@@ -570,9 +592,9 @@ function derivePolicy(input) {
   const riskLevels = [];
   let executionMode;
   let explicitConfirmation;
-  if (input.commandEffects) {
-    const ce = input.commandEffects;
-    riskLevels.push(ce.riskLevel ?? "low");
+  if (input.command_effects) {
+    const ce = input.command_effects;
+    riskLevels.push(ce.risk_level ?? "low");
     if (ce.writes) {
       sideEffects.add("file_write");
       for (const w of ce.writes) {
@@ -583,9 +605,9 @@ function derivePolicy(input) {
           overwrite: w.overwrite,
           destructive: w.destructive,
           ...w.idempotent !== void 0 ? { idempotent: w.idempotent } : {},
-          ...w.idempotencyKey ? { idempotencyKey: w.idempotencyKey } : {},
-          ...w.idempotentNote ? { idempotentNote: w.idempotentNote } : {},
-          source: `command:${input.commandId}`
+          ...w.idempotency_key ? { idempotency_key: w.idempotency_key } : {},
+          ...w.idempotent_note ? { idempotent_note: w.idempotent_note } : {},
+          source: `command:${input.command_id}`
         });
       }
     }
@@ -595,7 +617,7 @@ function derivePolicy(input) {
           kind: "semantic",
           target: r.target,
           description: r.description,
-          source: `command:${input.commandId}`
+          source: `command:${input.command_id}`
         });
       }
     }
@@ -606,17 +628,17 @@ function derivePolicy(input) {
           ...ce.network.description ? { description: ce.network.description } : {},
           ...ce.network.domains ? { domains: ce.network.domains } : {},
           ...ce.network.idempotent !== void 0 ? { idempotent: ce.network.idempotent } : {},
-          ...ce.network.idempotencyKey ? { idempotencyKey: ce.network.idempotencyKey } : {},
-          ...ce.network.idempotentNote ? { idempotentNote: ce.network.idempotentNote } : {},
-          source: `command:${input.commandId}`
+          ...ce.network.idempotency_key ? { idempotency_key: ce.network.idempotency_key } : {},
+          ...ce.network.idempotent_note ? { idempotent_note: ce.network.idempotent_note } : {},
+          source: `command:${input.command_id}`
         });
       }
     }
-    if (ce.executionMode) {
-      executionMode = ce.executionMode;
+    if (ce.execution_mode) {
+      executionMode = ce.execution_mode;
     }
-    if (ce.requiresConfirmation !== void 0) {
-      explicitConfirmation = ce.requiresConfirmation;
+    if (ce.requires_confirmation !== void 0) {
+      explicitConfirmation = ce.requires_confirmation;
     }
   }
   for (const [optName, optInput] of Object.entries(input.options)) {
@@ -647,7 +669,7 @@ function derivePolicy(input) {
     }
     if (definition.effects) {
       const eff = definition.effects;
-      riskLevels.push(eff.riskLevel ?? "low");
+      riskLevels.push(eff.risk_level ?? "low");
       if (eff.writes) {
         sideEffects.add("file_write");
         for (const w of eff.writes) {
@@ -658,8 +680,8 @@ function derivePolicy(input) {
             overwrite: w.overwrite,
             destructive: w.destructive,
             ...w.idempotent !== void 0 ? { idempotent: w.idempotent } : {},
-            ...w.idempotencyKey ? { idempotencyKey: w.idempotencyKey } : {},
-            ...w.idempotentNote ? { idempotentNote: w.idempotentNote } : {},
+            ...w.idempotency_key ? { idempotency_key: w.idempotency_key } : {},
+            ...w.idempotent_note ? { idempotent_note: w.idempotent_note } : {},
             source: `option:${optName}`
           });
         }
@@ -681,17 +703,17 @@ function derivePolicy(input) {
             ...eff.network.description ? { description: eff.network.description } : {},
             ...eff.network.domains ? { domains: eff.network.domains } : {},
             ...eff.network.idempotent !== void 0 ? { idempotent: eff.network.idempotent } : {},
-            ...eff.network.idempotencyKey ? { idempotencyKey: eff.network.idempotencyKey } : {},
-            ...eff.network.idempotentNote ? { idempotentNote: eff.network.idempotentNote } : {},
+            ...eff.network.idempotency_key ? { idempotency_key: eff.network.idempotency_key } : {},
+            ...eff.network.idempotent_note ? { idempotent_note: eff.network.idempotent_note } : {},
             source: `option:${optName}`
           });
         }
       }
-      if (eff.executionMode && !executionMode) {
-        executionMode = eff.executionMode;
+      if (eff.execution_mode && !executionMode) {
+        executionMode = eff.execution_mode;
       }
-      if (eff.requiresConfirmation !== void 0 && explicitConfirmation === void 0) {
-        explicitConfirmation = eff.requiresConfirmation;
+      if (eff.requires_confirmation !== void 0 && explicitConfirmation === void 0) {
+        explicitConfirmation = eff.requires_confirmation;
       }
     }
   }
@@ -712,15 +734,15 @@ function derivePolicy(input) {
   const semanticWrites = writes.filter((w) => w.kind === "semantic");
   const idempotent = semanticWrites.every((w) => w.idempotent === true) && networkEffects.every((n) => n.idempotent === true);
   return {
-    riskLevel: finalRiskLevel,
-    requiresConfirmation,
+    risk_level: finalRiskLevel,
+    requires_confirmation: requiresConfirmation,
     idempotent,
-    sideEffects: [...sideEffects],
+    side_effects: [...sideEffects],
     reads,
     writes,
     ...networkEffects.length > 0 ? { network: networkEffects } : {},
-    ...executionMode ? { executionMode } : {},
-    ...requiresSecrets ? { requiresSecrets } : {}
+    ...executionMode ? { execution_mode: executionMode } : {},
+    ...requiresSecrets ? { requires_secrets: requiresSecrets } : {}
   };
 }
 
@@ -728,7 +750,7 @@ function derivePolicy(input) {
 var commandDefinitions = {
   "init": {
     "effects": {
-      "riskLevel": "medium",
+      "risk_level": "medium",
       "writes": [
         {
           "target": "speckeeper.config.ts, design/ directory",
@@ -745,7 +767,7 @@ var commandDefinitions = {
           "default": false
         },
         "effects": {
-          "riskLevel": "high",
+          "risk_level": "high",
           "writes": [
             {
               "target": "existing project files",
@@ -785,7 +807,7 @@ var commandDefinitions = {
   },
   "build": {
     "effects": {
-      "riskLevel": "low",
+      "risk_level": "low",
       "writes": [
         {
           "target": "docs/ directory",
@@ -832,9 +854,7 @@ var commandDefinitions = {
           "type": "boolean",
           "default": false
         },
-        "effects": {
-          "executionMode": "watch"
-        }
+        "effects": {}
       },
       {
         "name": "verbose",
@@ -1033,7 +1053,7 @@ var commandDefinitions = {
   },
   "new": {
     "effects": {
-      "riskLevel": "low",
+      "risk_level": "low",
       "writes": [
         {
           "target": "design/ directory",
@@ -1158,7 +1178,7 @@ var commandDefinitions = {
   },
   "scaffold": {
     "effects": {
-      "riskLevel": "low",
+      "risk_level": "low",
       "writes": [
         {
           "target": "design/ directory",
@@ -1193,7 +1213,7 @@ var commandDefinitions = {
           "default": false
         },
         "effects": {
-          "riskLevel": "medium",
+          "risk_level": "medium",
           "writes": [
             {
               "target": "existing model and spec files",
@@ -1239,7 +1259,7 @@ var commandDefinitions = {
   },
   "convert": {
     "effects": {
-      "riskLevel": "low",
+      "risk_level": "low",
       "writes": [
         {
           "target": ".yaml output file",
@@ -1680,27 +1700,27 @@ var commandDefinitions = {
     }
   }
 };
-function deriveCommandPolicy(commandId, optionValues) {
-  const def = commandDefinitions[commandId];
-  if (!def) throw new Error(`Unknown command: ${commandId}`);
+function deriveCommandPolicy(command_id, optionValues) {
+  const def = commandDefinitions[command_id];
+  if (!def) throw new Error(`Unknown command: ${command_id}`);
   const cmdDef = def;
   const options = {};
-  const activeOptions = [];
+  const active_options = [];
   for (const optDef of cmdDef.options ?? []) {
     const value = optionValues[optDef.name];
     const specified = optDef.name in optionValues && value !== void 0;
     options[optDef.name] = { value, specified, definition: optDef };
     if (isOptionActive(optDef, value, specified)) {
-      activeOptions.push(optDef.name);
+      active_options.push(optDef.name);
     }
   }
   const policy = derivePolicy({
-    commandId,
-    commandEffects: cmdDef.effects,
+    command_id,
+    command_effects: cmdDef.effects,
     options,
     env: cmdDef.env
   });
-  return { command: commandId, activeOptions, policy };
+  return { command: command_id, active_options, policy };
 }
 
 // src/generated/program.ts