@hone-ai/cli 1.12.1 → 1.13.0

package/hone-cli.js

@@ -1035,6 +1035,11 @@ program
         docUrls,
         isRefresh,
         existingSkills,
+        // HC-019z-followup-2: derive is always batch from the CLI —
+        // there's no channel to relay user answers to the LLM mid-job.
+        // The server's prompt Step 0c uses this to emit STEP_0C_SKIPPED
+        // instead of stopping to ask, when no team docs are configured.
+        interactive: false,
       });
       jobId = r.data.jobId;
       console.log(`Job queued: ${jobId}`);
@@ -1084,6 +1089,25 @@ program
       fs.writeFileSync(reportPath, result.changeReport || '');
       console.log(`\nChange report saved to: .github/skill-refresh-report.md`);
     } else {
+      // HC-019z-followup-2: surface the non-interactive skip notice if
+      // the prompt emitted STEP_0C_SKIPPED. The marker appears in the
+      // server's rawOutputTail when the LLM honored the non-interactive
+      // guard. Without this message, the user is mystified by an empty
+      // skill set.
+      const rawOutput = result.rawOutputTail || result.rawOutput || '';
+      if (rawOutput.includes('STEP_0C_SKIPPED')) {
+        console.log('');
+        console.log('⚠  Phase 0c (team documentation URLs) skipped — derive is non-interactive.');
+        console.log('   To include team docs (Confluence, wiki, runbooks, etc.) in derivation,');
+        console.log('   add them to .github/.pipeline-config.yml under documentation.external_urls:');
+        console.log('     documentation:');
+        console.log('       external_urls:');
+        console.log('         - https://yourwiki.example/architecture');
+        console.log('         - https://yourwiki.example/conventions');
+        console.log('   Then re-run `hone derive`. (HC-019z-followup-2)');
+        console.log('');
+      }
+
       // Write generated skills to disk
       console.log('Writing generated skills...');
       if (result.skills) {
@@ -5253,6 +5277,50 @@ program
     }
   });
 
+// ── SHOW step output (HC-019n-followup-6) ─────────────────────────────────────
+// `hone show step <workflowId> <stepKey> [--attempt N]` — fetch the
+// actual LLM output of a specific orchestrator step. Pre-fix, the
+// /orchestrate/<id> endpoint returned step METADATA only; operators
+// approving a human gate (step_4 typically) had no way to see what
+// they were approving, and review-fail loops were undiagnosable.
+const showCmd = program.command('show').description('Inspect orchestrator step output (HC-019n-followup-6)');
+showCmd
+  .command('step <workflowId> <stepKey>')
+  .description('Print the actual LLM output of an orchestrator step (latest attempt by default)')
+  .option('--attempt <n>', 'Specific attempt number (default: latest)')
+  .action(async (workflowId, stepKey, opts) => {
+    const config = getConfig();
+    const client = api(config);
+    try {
+      const url = `/orchestrate/${workflowId}/step/${stepKey}${opts.attempt ? `?attempt=${opts.attempt}` : ''}`;
+      const r = await client.get(url);
+      const s = r.data;
+      console.log(`── step output ──────────────────────────────────────────`);
+      console.log(`  runId:       ${s.runId}`);
+      console.log(`  stepKey:     ${s.stepKey}`);
+      console.log(`  agent:       ${s.agent}`);
+      console.log(`  attempt:     ${s.attempt}`);
+      console.log(`  status:      ${s.status}`);
+      console.log(`  gateResult:  ${s.gateResult || '(none)'}`);
+      console.log(`  startedAt:   ${s.startedAt || '(not started)'}`);
+      console.log(`  completedAt: ${s.completedAt || '(not completed)'}`);
+      if (s.tokenUsage) console.log(`  tokenUsage:  ${JSON.stringify(s.tokenUsage)}`);
+      if (s.errorContext) {
+        console.log(``);
+        console.log(`── error_context (retry feedback) ──────────────────────`);
+        console.log(s.errorContext);
+      }
+      console.log(``);
+      console.log(`── output (the LLM's actual response) ──────────────────`);
+      console.log(s.output || '(no output recorded — step may not have completed)');
+      console.log(`────────────────────────────────────────────────────────`);
+    } catch (e) {
+      const msg = e.response?.data?.error || e.message;
+      console.error(`hone show step failed: ${msg}`);
+      process.exit(1);
+    }
+  });
+
 // ── CLI setup ─────────────────────────────────────────────────────────────────
 program
   .name('hone')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hone-ai/cli",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "Hone AI — Enterprise SDLC Pipeline CLI",
   "main": "hone-cli.js",
   "bin": {