speckeeper 0.13.0 → 0.14.0

package/cli-contract.yaml

@@ -691,7 +691,7 @@ command_sets:
 
         usage:
           - speckeeper audit-requirements
-          - speckeeper audit-requirements --adapter gemini --dry-run
+          - speckeeper audit-requirements --adapter gemini --show-prompt
           - speckeeper audit-requirements --report-format json --output audit.json
 
         options:
@@ -720,19 +720,6 @@ command_sets:
             schema:
               type: string
 
-          - name: dry-run
-            aliases: [n]
-            description: Output the constructed prompt without calling LLM.
-            schema:
-              type: boolean
-              default: false
-
-          - name: show-prompt
-            description: Display the constructed LLM prompt on stderr.
-            schema:
-              type: boolean
-              default: false
-
           - name: fail-on
             description: Minimum severity that causes a non-zero exit.
             value_name: level
@@ -796,7 +783,7 @@ command_sets:
 
         x-agent:
           recommended_before_use:
-            - "Run with --dry-run first to preview the prompt"
+            - "Run with --show-prompt first to preview the prompt"
           retryableExitCodes: [12]
 
       # ── propose-trace-links ─────────────────────────────
@@ -841,19 +828,6 @@ command_sets:
             schema:
               type: string
 
-          - name: dry-run
-            aliases: [n]
-            description: Output the constructed prompt without calling LLM.
-            schema:
-              type: boolean
-              default: false
-
-          - name: show-prompt
-            description: Display the constructed LLM prompt on stderr.
-            schema:
-              type: boolean
-              default: false
-
           - name: fail-on
             description: Minimum severity that causes a non-zero exit.
             value_name: level
@@ -917,7 +891,7 @@ command_sets:
 
         x-agent:
           recommended_before_use:
-            - "Run with --dry-run first to preview the prompt"
+            - "Run with --show-prompt first to preview the prompt"
           retryableExitCodes: [12]
 
       # ── explain-impact ──────────────────────────────────
@@ -959,19 +933,6 @@ command_sets:
             schema:
               type: string
 
-          - name: dry-run
-            aliases: [n]
-            description: Output the constructed prompt without calling LLM.
-            schema:
-              type: boolean
-              default: false
-
-          - name: show-prompt
-            description: Display the constructed LLM prompt on stderr.
-            schema:
-              type: boolean
-              default: false
-
           - name: fail-on
             description: Minimum severity that causes a non-zero exit.
             value_name: level
@@ -1035,7 +996,7 @@ command_sets:
 
         x-agent:
           recommended_before_use:
-            - "Run with --dry-run first to preview the prompt"
+            - "Run with --show-prompt first to preview the prompt"
           retryableExitCodes: [12]
 
       # ── propose-acceptance-criteria ─────────────────────
@@ -1052,7 +1013,7 @@ command_sets:
         usage:
           - speckeeper propose-acceptance-criteria
           - speckeeper propose-acceptance-criteria FR-001 FR-002
-          - speckeeper propose-acceptance-criteria --adapter gemini --dry-run
+          - speckeeper propose-acceptance-criteria --adapter gemini --show-prompt
 
         arguments:
           - name: specIds
@@ -1090,19 +1051,6 @@ command_sets:
             schema:
               type: string
 
-          - name: dry-run
-            aliases: [n]
-            description: Output the constructed prompt without calling LLM.
-            schema:
-              type: boolean
-              default: false
-
-          - name: show-prompt
-            description: Display the constructed LLM prompt on stderr.
-            schema:
-              type: boolean
-              default: false
-
           - name: fail-on
             description: Minimum severity that causes a non-zero exit.
             value_name: level
@@ -1166,7 +1114,7 @@ command_sets:
 
         x-agent:
           recommended_before_use:
-            - "Run with --dry-run first to preview the prompt"
+            - "Run with --show-prompt first to preview the prompt"
           retryableExitCodes: [12]
 
 components:

package/dist/cli.js

@@ -1340,20 +1340,6 @@ var commandDefinitions = {
           "type": "string"
         }
       },
-      {
-        "name": "dry-run",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
-      {
-        "name": "show-prompt",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
       {
         "name": "fail-on",
         "schema": {
@@ -1442,20 +1428,6 @@ var commandDefinitions = {
           "type": "string"
         }
       },
-      {
-        "name": "dry-run",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
-      {
-        "name": "show-prompt",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
       {
         "name": "fail-on",
         "schema": {
@@ -1533,20 +1505,6 @@ var commandDefinitions = {
           "type": "string"
         }
       },
-      {
-        "name": "dry-run",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
-      {
-        "name": "show-prompt",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
       {
         "name": "fail-on",
         "schema": {
@@ -1635,20 +1593,6 @@ var commandDefinitions = {
           "type": "string"
         }
       },
-      {
-        "name": "dry-run",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
-      {
-        "name": "show-prompt",
-        "schema": {
-          "type": "boolean",
-          "default": false
-        }
-      },
       {
         "name": "fail-on",
         "schema": {
@@ -1809,40 +1753,60 @@ function createProgram(handlers2, version) {
     }
     await handlers2.convert(file, opts, globalOpts);
   });
-  program.command("audit-requirements").description("Run LLM-based requirement quality audit.").option("-c, --config <path>", "Path to config file.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("-n, --dry-run", "Output the constructed prompt without calling LLM.", false).option("--show-prompt", "Display the constructed LLM prompt on stderr.", false).option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the audit report.", "json").action(async (opts, cmd) => {
+  program.command("audit-requirements").description("Run LLM-based requirement quality audit.").option("-c, --config <path>", "Path to config file.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the audit report.", "json").option("--show-prompt", "Output the constructed prompt without calling the LLM API.", false).action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     if (globalOpts.introspect) {
       const policy = deriveCommandPolicy("audit-requirements", opts);
       console.log(JSON.stringify(policy, null, 2));
       return;
     }
+    if (opts.showPrompt) {
+      const prompt = await handlers2.auditRequirements(opts, globalOpts);
+      if (typeof prompt === "string") process.stdout.write(prompt + "\n");
+      return;
+    }
     await handlers2.auditRequirements(opts, globalOpts);
   });
-  program.command("propose-trace-links").description("LLM-based traceability link proposal.").option("-c, --config <path>", "Path to config file.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("-n, --dry-run", "Output the constructed prompt without calling LLM.", false).option("--show-prompt", "Display the constructed LLM prompt on stderr.", false).option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the report.", "json").action(async (opts, cmd) => {
+  program.command("propose-trace-links").description("LLM-based traceability link proposal.").option("-c, --config <path>", "Path to config file.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the report.", "json").option("--show-prompt", "Output the constructed prompt without calling the LLM API.", false).action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     if (globalOpts.introspect) {
       const policy = deriveCommandPolicy("propose-trace-links", opts);
       console.log(JSON.stringify(policy, null, 2));
       return;
     }
+    if (opts.showPrompt) {
+      const prompt = await handlers2.proposeTraceLinks(opts, globalOpts);
+      if (typeof prompt === "string") process.stdout.write(prompt + "\n");
+      return;
+    }
     await handlers2.proposeTraceLinks(opts, globalOpts);
   });
-  program.command("explain-impact").description("LLM-based explanation of impact analysis output.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("-n, --dry-run", "Output the constructed prompt without calling LLM.", false).option("--show-prompt", "Display the constructed LLM prompt on stderr.", false).option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the report.", "json").action(async (opts, cmd) => {
+  program.command("explain-impact").description("LLM-based explanation of impact analysis output.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the report.", "json").option("--show-prompt", "Output the constructed prompt without calling the LLM API.", false).action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     if (globalOpts.introspect) {
       const policy = deriveCommandPolicy("explain-impact", opts);
       console.log(JSON.stringify(policy, null, 2));
       return;
     }
+    if (opts.showPrompt) {
+      const prompt = await handlers2.explainImpact(opts, globalOpts);
+      if (typeof prompt === "string") process.stdout.write(prompt + "\n");
+      return;
+    }
     await handlers2.explainImpact(opts, globalOpts);
   });
-  program.command("propose-acceptance-criteria").description("LLM-based acceptance criteria proposal.").argument("[specIds...]", "Spec IDs to propose criteria for. Defaults to all specs if omitted.").option("-c, --config <path>", "Path to config file.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("-n, --dry-run", "Output the constructed prompt without calling LLM.", false).option("--show-prompt", "Display the constructed LLM prompt on stderr.", false).option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the report.", "json").action(async (specIds, opts, cmd) => {
+  program.command("propose-acceptance-criteria").description("LLM-based acceptance criteria proposal.").argument("[specIds...]", "Spec IDs to propose criteria for. Defaults to all specs if omitted.").option("-c, --config <path>", "Path to config file.").option("-a, --adapter <name>", "SDK adapter to use for LLM execution.").option("--model <name>", "LLM model override.").option("--fail-on <level>", "Minimum severity that causes a non-zero exit.", "error").option("-o, --output <file>", "Write result to a file instead of stdout.").option("--report-format <fmt>", "Output format for the report.", "json").option("--show-prompt", "Output the constructed prompt without calling the LLM API.", false).action(async (specIds, opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     if (globalOpts.introspect) {
       const policy = deriveCommandPolicy("propose-acceptance-criteria", opts);
       console.log(JSON.stringify(policy, null, 2));
       return;
     }
+    if (opts.showPrompt) {
+      const prompt = await handlers2.proposeAcceptanceCriteria(specIds, opts, globalOpts);
+      if (typeof prompt === "string") process.stdout.write(prompt + "\n");
+      return;
+    }
     await handlers2.proposeAcceptanceCriteria(specIds, opts, globalOpts);
   });
   return program;
@@ -4448,19 +4412,7 @@ async function createAdapter(runtimePkg, name, config) {
       );
   }
 }
-async function runAgentTask(userRequest, taskId, auditConfig, options) {
-  if (options.dryRun) {
-    return {
-      taskId,
-      data: null,
-      raw: "",
-      prompt: userRequest,
-      dryRun: true,
-      status: "success",
-      followUpsUsed: 0,
-      retriesUsed: 0
-    };
-  }
+async function runAgentTask(userRequest, taskId, auditConfig, _options) {
   const RUNTIME_PKG = ["agent-contracts", "runtime"].join("-");
   let runTask;
   let agentRegistry2, taskRegistry2, handoffSchemas2;
@@ -4470,7 +4422,7 @@ async function runAgentTask(userRequest, taskId, auditConfig, options) {
   } catch {
     throw Object.assign(
       new Error(
-        "agent-contracts-runtime is not installed. Install it to use this command, or use --dry-run to inspect the prompt.\n  npm install agent-contracts-runtime"
+        "agent-contracts-runtime is not installed. Install it to use this command, or use --show-prompt to inspect the prompt.\n  npm install agent-contracts-runtime"
       ),
       { exitCode: EXIT_RUNTIME_MISSING }
     );
@@ -4507,7 +4459,6 @@ async function runAgentTask(userRequest, taskId, auditConfig, options) {
     data: outcome.status === "success" ? outcome.data : null,
     raw: outcome.raw ?? "",
     prompt: userRequest,
-    dryRun: false,
     status: outcome.status,
     errorMessage: outcome.status === "error" ? outcome.message : outcome.status === "escalation" ? outcome.reason : outcome.status === "validation_error" ? outcome.errors?.message : void 0,
     followUpsUsed: result.follow_ups_used,
@@ -4515,7 +4466,6 @@ async function runAgentTask(userRequest, taskId, auditConfig, options) {
   };
 }
 function computeExitCode(result, options) {
-  if (result.dryRun) return 0;
   if (result.status !== "success" || !result.data) return 1;
   const failOn = options.failOn ?? "error";
   const severityOrder = ["info", "warning", "error", "critical"];
@@ -4526,9 +4476,6 @@ function computeExitCode(result, options) {
   return hasBlocking ? 10 : 0;
 }
 function formatResultText(result) {
-  if (result.dryRun) {
-    return result.prompt;
-  }
   if (result.status !== "success" || !result.data) {
     return result.errorMessage ?? `Task failed with status: ${result.status}`;
   }
@@ -4564,20 +4511,12 @@ function formatResultText(result) {
   return lines.join("\n");
 }
 function formatResultJson(result) {
-  if (result.dryRun) {
-    return JSON.stringify({ dryRun: true, prompt: result.prompt }, null, 2);
-  }
   if (!result.data) {
     return JSON.stringify({ error: result.errorMessage, status: result.status }, null, 2);
   }
   return JSON.stringify(result.data, null, 2);
 }
 function formatResultYaml(result) {
-  if (result.dryRun) {
-    return `dryRun: true
-prompt: |
-${indent(result.prompt)}`;
-  }
   if (!result.data) {
     return `error: ${JSON.stringify(result.errorMessage)}
 status: ${result.status}`;
@@ -4658,12 +4597,14 @@ ${val}`;
 // src/cli/audit-requirements.ts
 async function commandAuditRequirements(opts) {
   const context = await buildAuditRequirementsContext(opts.config);
+  if (opts.showPrompt) {
+    return context;
+  }
   const auditConfig = {
     adapter: opts.adapter,
     model: opts.model
   };
   const auditOpts = {
-    dryRun: opts.dryRun,
     failOn: opts.failOn
   };
   try {
@@ -4692,12 +4633,14 @@ async function commandAuditRequirements(opts) {
 }
 async function commandProposeTraceLinks(opts) {
   const context = await buildProposeTraceLinksContext(opts.config);
+  if (opts.showPrompt) {
+    return context;
+  }
   const auditConfig = {
     adapter: opts.adapter,
     model: opts.model
   };
   const auditOpts = {
-    dryRun: opts.dryRun,
     failOn: opts.failOn
   };
   try {
@@ -4732,12 +4675,14 @@ async function commandExplainImpact(opts) {
     process.exit(2);
   }
   const context = buildExplainImpactContext(stdin);
+  if (opts.showPrompt) {
+    return context;
+  }
   const auditConfig = {
     adapter: opts.adapter,
     model: opts.model
   };
   const auditOpts = {
-    dryRun: opts.dryRun,
     failOn: opts.failOn
   };
   try {
@@ -4778,12 +4723,14 @@ function readStdin() {
 async function commandProposeAcceptanceCriteria(specIds, opts) {
   const targetSpecIds = specIds.length > 0 ? specIds : void 0;
   const context = await buildProposeAcceptanceCriteriaContext(opts.config, targetSpecIds);
+  if (opts.showPrompt) {
+    return context;
+  }
   const auditConfig = {
     adapter: opts.adapter,
     model: opts.model
   };
   const auditOpts = {
-    dryRun: opts.dryRun,
     failOn: opts.failOn
   };
   try {
@@ -4849,49 +4796,41 @@ var handlers = {
   convert: async (file, opts) => {
     await runConvert(file, opts);
   },
-  auditRequirements: async (opts) => {
-    await commandAuditRequirements({
-      config: opts.config,
-      adapter: opts.adapter,
-      model: opts.model,
-      dryRun: opts.dryRun,
-      failOn: opts.failOn,
-      output: opts.output,
-      reportFormat: opts.reportFormat
-    });
-  },
-  proposeTraceLinks: async (opts) => {
-    await commandProposeTraceLinks({
-      config: opts.config,
-      adapter: opts.adapter,
-      model: opts.model,
-      dryRun: opts.dryRun,
-      failOn: opts.failOn,
-      output: opts.output,
-      reportFormat: opts.reportFormat
-    });
-  },
-  explainImpact: async (opts) => {
-    await commandExplainImpact({
-      adapter: opts.adapter,
-      model: opts.model,
-      dryRun: opts.dryRun,
-      failOn: opts.failOn,
-      output: opts.output,
-      reportFormat: opts.reportFormat
-    });
-  },
-  proposeAcceptanceCriteria: async (specIds, opts) => {
-    await commandProposeAcceptanceCriteria(specIds, {
-      config: opts.config,
-      adapter: opts.adapter,
-      model: opts.model,
-      dryRun: opts.dryRun,
-      failOn: opts.failOn,
-      output: opts.output,
-      reportFormat: opts.reportFormat
-    });
-  }
+  auditRequirements: (opts) => commandAuditRequirements({
+    config: opts.config,
+    adapter: opts.adapter,
+    model: opts.model,
+    showPrompt: opts.showPrompt,
+    failOn: opts.failOn,
+    output: opts.output,
+    reportFormat: opts.reportFormat
+  }),
+  proposeTraceLinks: (opts) => commandProposeTraceLinks({
+    config: opts.config,
+    adapter: opts.adapter,
+    model: opts.model,
+    showPrompt: opts.showPrompt,
+    failOn: opts.failOn,
+    output: opts.output,
+    reportFormat: opts.reportFormat
+  }),
+  explainImpact: (opts) => commandExplainImpact({
+    adapter: opts.adapter,
+    model: opts.model,
+    showPrompt: opts.showPrompt,
+    failOn: opts.failOn,
+    output: opts.output,
+    reportFormat: opts.reportFormat
+  }),
+  proposeAcceptanceCriteria: (specIds, opts) => commandProposeAcceptanceCriteria(specIds, {
+    config: opts.config,
+    adapter: opts.adapter,
+    model: opts.model,
+    showPrompt: opts.showPrompt,
+    failOn: opts.failOn,
+    output: opts.output,
+    reportFormat: opts.reportFormat
+  })
 };
 createProgram(handlers, getVersion()).parse();
 //# sourceMappingURL=cli.js.map