@hone-ai/cli 1.7.1 → 1.8.0

package/hone-cli.js

@@ -4235,6 +4235,200 @@ program
     process.exit(results.failed + results.errors > 0 ? 1 : 0);
   });
 
+// ── HC-041: Run Story (Orchestrator) ─────────────────────────────────────────
+program
+  .command('run-story <storyId>')
+  .description('Run the SDLC pipeline for a story via the orchestrator')
+  .option('--mode <mode>', 'Execution mode: interactive or batch', 'interactive')
+  .option('--repo <name>', 'Repository name override (default: directory name)')
+  .option('--branch <name>', 'Git branch (default: current)')
+  .option('--status', 'Show status of the latest workflow run for this story')
+  .option('--kill', 'Kill the latest workflow run for this story')
+  .option('--approve <step>', 'Approve a paused gate (e.g., --approve step_0)')
+  .option('--format <fmt>', 'Output format: pretty or json', 'pretty')
+  .option('--poll-interval <s>', 'Poll interval in seconds', '5')
+  .action(async (storyIdOrRunId, opts) => {
+    const config = getConfig();
+    const client = api(config);
+
+    // Resolve: if it looks like a UUID, use as runId directly.
+    // Otherwise treat as storyId — will be used for POST /orchestrate body.
+    const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(storyIdOrRunId);
+    const storyId = isUuid ? null : storyIdOrRunId;
+    const runId = isUuid ? storyIdOrRunId : null;
+
+    // Status mode
+    if (opts.status) {
+      const statusId = runId || storyIdOrRunId;
+      try {
+        const { data } = await client.get(`/orchestrate/${statusId}`);
+        if (opts.format === 'json') { console.log(JSON.stringify(data, null, 2)); return; }
+        console.log('');
+        console.log(`Workflow: ${data.runId}`);
+        console.log(`Story:    ${data.storyId}`);
+        console.log(`Status:   ${data.status}`);
+        console.log(`Mode:     ${data.mode}`);
+        console.log(`Tokens:   ${(data.totalTokens || 0).toLocaleString()}`);
+        if (data.errorMessage) console.log(`Error:    ${data.errorMessage}`);
+        console.log('');
+        console.log('Steps:');
+        for (const s of (data.steps || [])) {
+          const icon = s.status === 'completed' ? '✓' : s.status === 'running' ? '⏳' : s.status === 'failed' ? '✗' : '⬜';
+          const gate = s.gateResult ? ` (${s.gateResult})` : '';
+          console.log(`  ${icon} ${s.stepKey}  (${s.agent})  ${s.status}${gate}`);
+        }
+        if (data.awaitingApproval) {
+          console.log('');
+          console.log(`Awaiting approval at ${data.currentStep}.`);
+          console.log(`Approve: hone run-story ${data.runId} --approve ${data.currentStep}`);
+        }
+        console.log('');
+      } catch (e) {
+        console.error(`Failed: ${e.response?.data?.error || e.message}`);
+        process.exit(1);
+      }
+      return;
+    }
+
+    // Kill mode
+    if (opts.kill) {
+      const killId = runId || storyIdOrRunId;
+      try {
+        const { data } = await client.post(`/orchestrate/${killId}/kill`, { reason: 'CLI kill' });
+        console.log(`Workflow ${data.runId} killed.`);
+      } catch (e) {
+        console.error(`Failed: ${e.response?.data?.error || e.message}`);
+        process.exit(1);
+      }
+      return;
+    }
+
+    // Approve mode
+    if (opts.approve) {
+      const approveId = runId || storyIdOrRunId;
+      try {
+        const { data } = await client.post(`/orchestrate/${approveId}/approve`, { stepKey: opts.approve });
+        console.log(`Gate ${opts.approve} approved. Workflow resuming.`);
+        console.log(`Poll: hone run-story ${approveId} --status`);
+      } catch (e) {
+        console.error(`Failed: ${e.response?.data?.error || e.message}`);
+        process.exit(1);
+      }
+      return;
+    }
+
+    // Start workflow (storyId required, runId not accepted for starting)
+    if (isUuid) {
+      console.error('Cannot start workflow with a runId. Use a story ID like HC-042.');
+      console.error('To check status: hone run-story <runId> --status');
+      process.exit(1);
+    }
+
+    const repoName = opts.repo || path.basename(process.cwd());
+    let branch = opts.branch;
+    if (!branch) {
+      try { branch = execSync('git symbolic-ref --short HEAD', { encoding: 'utf8' }).trim(); } catch { branch = null; }
+    }
+
+    try {
+      const { data } = await client.post('/orchestrate', {
+        storyId: storyIdOrRunId, repoName, branch, mode: opts.mode, config: {},
+      });
+
+      console.log('');
+      console.log(`Workflow started: ${data.runId}`);
+      console.log(`Mode: ${data.mode} | Story: ${data.storyId}`);
+      console.log(`Poll: ${data.pollUrl}`);
+      console.log('');
+
+      // Poll loop
+      const interval = parseInt(opts.pollInterval, 10) * 1000;
+      while (true) {
+        await new Promise(r => setTimeout(r, interval));
+
+        let status;
+        try {
+          const { data: pollData } = await client.get(`/orchestrate/${data.runId}`);
+          status = pollData;
+        } catch (e) {
+          console.error(`Poll error: ${e.message}`);
+          continue;
+        }
+
+        if (status.status === 'completed') {
+          console.log(`✓ Workflow completed! Total tokens: ${(status.totalTokens || 0).toLocaleString()}`);
+          process.exit(0);
+        }
+
+        if (status.status === 'failed' || status.status === 'killed') {
+          console.error(`✗ Workflow ${status.status}: ${status.errorMessage || 'unknown'}`);
+          process.exit(1);
+        }
+
+        if (status.status === 'paused' && status.awaitingApproval) {
+          const step = status.steps.find(s => s.stepKey === status.currentStep);
+          console.log(`⏳ Step ${status.currentStep} (${step?.agent || 'unknown'}) — awaiting approval`);
+
+          // Interactive prompt
+          if (process.stdin.isTTY) {
+            const readline = require('readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise(resolve => {
+              rl.question('  Approve? [y/n/kill] ', resolve);
+            });
+            rl.close();
+
+            if (answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes') {
+              try {
+                await client.post(`/orchestrate/${data.runId}/approve`, { stepKey: status.currentStep });
+                console.log('  Approved — workflow resuming...');
+              } catch (e) {
+                console.error(`  Approve failed: ${e.response?.data?.error || e.message}`);
+              }
+            } else if (answer.toLowerCase() === 'kill') {
+              try {
+                await client.post(`/orchestrate/${data.runId}/kill`, { reason: 'CLI kill' });
+                console.log('  Workflow killed.');
+                process.exit(0);
+              } catch (e) {
+                console.error(`  Kill failed: ${e.message}`);
+              }
+            } else {
+              console.log(`  Skipped. Resume later: hone run-story ${data.runId} --status`);
+              process.exit(0);
+            }
+          } else {
+            // Non-interactive (CI): exit with code 2 (paused, needs approval)
+            console.log(`  Non-interactive mode. Approve with: hone run-story ${data.runId} --approve ${status.currentStep}`);
+            process.exit(2);
+          }
+          continue;
+        }
+
+        // Still running
+        const currentStep = status.steps.find(s => s.status === 'running');
+        if (currentStep) {
+          process.stdout.write(`  Running: ${currentStep.stepKey} (${currentStep.agent})...\r`);
+        }
+      }
+    } catch (e) {
+      if (e.response?.status === 429) {
+        console.error(`Max concurrent workflows reached. ${e.response.data.error}`);
+      } else {
+        console.error(`Failed to start: ${e.response?.data?.error || e.message}`);
+      }
+      process.exit(1);
+    }
+  });
+
+// SIGINT handler for run-story
+process.on('SIGINT', () => {
+  console.log('\n\nWorkflow continues on the server.');
+  console.log('Resume: hone run-story <storyId> --status');
+  console.log('Kill:   hone run-story <storyId> --kill');
+  process.exit(0);
+});
+
 // ── CLI setup ─────────────────────────────────────────────────────────────────
 program
   .name('hone')

package/package.json

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