@hone-ai/cli 1.13.0 → 1.15.0

package/hone-cli.js

@@ -4364,6 +4364,7 @@ program
   .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')
+  .option('--include-paths <paths>', 'Comma-separated list of source file paths to bundle into the codebase context (HC-019n-followup-12). Augments auto-detected paths from the issue body.')
   .action(async (storyIdOrRunId, opts) => {
     const config = getConfig();
     const client = api(config);
@@ -4447,9 +4448,107 @@ program
       try { branch = execSync('git symbolic-ref --short HEAD', { encoding: 'utf8' }).trim(); } catch { branch = null; }
     }
 
+    // HC-019n-followup-11: when storyId is a bare integer, treat it as a
+    // GitHub issue number and fetch the issue's title + body via the local
+    // `gh` CLI. Inject into config.story_description so the orchestrator's
+    // buildStepContext (HC-019n root-cause fix B) hands the real story
+    // text to step_0 instead of letting the LLM produce placeholder
+    // [ASSUMPTION] grooming. Hook reused — no server change required.
+    //
+    // Gracefully degrade on any error (gh missing, no remote, network
+    // fail, private repo without auth): warn and proceed without context.
+    // The existing HC-019n-followup-7 hard_pause safety net catches the
+    // resulting placeholder cascade at step_1.
+    const orchestrateConfig = {};
+    let issueBodyForFiles = null;
+    if (/^\d+$/.test(storyIdOrRunId)) {
+      try {
+        const remoteUrl = execSync('git remote get-url origin', { encoding: 'utf8' }).trim();
+        const m = remoteUrl.match(/[/:]([^/]+)\/([^/]+?)(?:\.git)?$/);
+        if (!m) throw new Error(`could not parse owner/repo from remote: ${remoteUrl}`);
+        const ownerRepo = `${m[1]}/${m[2]}`;
+        const issueJson = execSync(
+          `gh issue view ${storyIdOrRunId} --repo ${ownerRepo} --json title,body,url`,
+          { encoding: 'utf8' }
+        );
+        const issue = JSON.parse(issueJson);
+        const desc = `# ${issue.title}\n\n${issue.body || '_(issue body is empty)_'}\n\n_Source: ${issue.url}_`;
+        orchestrateConfig.story_description = desc;
+        issueBodyForFiles = `${issue.title}\n${issue.body || ''}`;
+        console.log(`  → fetched GitHub issue #${storyIdOrRunId} for story context (${desc.length} chars)`);
+      } catch (e) {
+        const msg = (e && e.message) ? e.message.split('\n')[0] : String(e);
+        console.warn(`  ⚠ could not fetch GitHub issue context: ${msg}`);
+        console.warn('  → proceeding without story_description; step_0 may produce placeholder output');
+      }
+    }
+
+    // HC-019n-followup-12: auto-bundle codebase files referenced in the
+    // issue body (or by the operator via --include-paths). Without this,
+    // step_1/step_4 have only training-data priors and produce code that
+    // matches the SHAPE of the adopter's stack but not its actual
+    // architecture (cf. OptionsFlow #104 step_4 hallucinating SQLAlchemy
+    // for a JSON-lines repo). The bundle is capped at 10 files / 50K
+    // chars total to stay well inside the LLM context window.
+    //
+    // Detection scans the issue body for code-file-like paths:
+    //   - foo/bar/baz.py             (relative paths with extensions)
+    //   - tests/unit/test_foo.py     (typical pytest structure)
+    //   - src/web/routes.py          (src trees)
+    // Excludes:
+    //   - https:// or http:// URLs (those aren't local files)
+    //   - paths starting with / or ~ (absolute / home — bundle would
+    //     escape the repo)
+    //   - .md / .txt / .yml docs (rarely needed for code-builder; would
+    //     blow context with prose)
+    if (issueBodyForFiles || opts.includePaths) {
+      try {
+        const FILE_PATH_RE = /(?<![\w/])([a-zA-Z_][\w-]*\/(?:[\w.-]+\/)*[\w.-]+\.(?:py|js|ts|jsx|tsx|go|rs|java|rb|sh|sql))/g;
+        const candidates = new Set();
+        if (issueBodyForFiles) {
+          for (const m of issueBodyForFiles.matchAll(FILE_PATH_RE)) candidates.add(m[1]);
+        }
+        if (opts.includePaths) {
+          // --include-paths a/b.py,c/d.py
+          for (const p of String(opts.includePaths).split(',').map(s => s.trim()).filter(Boolean)) {
+            candidates.add(p);
+          }
+        }
+        const MAX_FILES = 10;
+        const MAX_TOTAL_CHARS = 50_000;
+        const MAX_PER_FILE_CHARS = 10_000;
+        const codebaseFiles = [];
+        let totalChars = 0;
+        for (const candidate of candidates) {
+          if (codebaseFiles.length >= MAX_FILES) break;
+          if (candidate.startsWith('/') || candidate.startsWith('~') || candidate.includes('..')) continue;
+          const abs = path.resolve(process.cwd(), candidate);
+          if (!abs.startsWith(process.cwd() + path.sep)) continue; // escape guard
+          if (!fs.existsSync(abs)) continue;
+          let content;
+          try {
+            content = fs.readFileSync(abs, 'utf8');
+          } catch { continue; }
+          if (content.length > MAX_PER_FILE_CHARS) {
+            content = content.slice(0, MAX_PER_FILE_CHARS) + `\n\n# [HC-019n-followup-12: truncated at ${MAX_PER_FILE_CHARS} chars; full file is ${content.length} chars]`;
+          }
+          if (totalChars + content.length > MAX_TOTAL_CHARS) break;
+          totalChars += content.length;
+          codebaseFiles.push({ path: candidate, content });
+        }
+        if (codebaseFiles.length > 0) {
+          orchestrateConfig.codebaseFiles = codebaseFiles;
+          console.log(`  → bundled ${codebaseFiles.length} codebase file(s) for step_1/step_4 context (${totalChars} chars)`);
+        }
+      } catch (e) {
+        const msg = (e && e.message) ? e.message.split('\n')[0] : String(e);
+        console.warn(`  ⚠ codebase bundling failed (non-fatal): ${msg}`);
+      }
+    }
+
     try {
       const { data } = await client.post('/orchestrate', {
-        storyId: storyIdOrRunId, repoName, branch, mode: opts.mode, config: {},
+        storyId: storyIdOrRunId, repoName, branch, mode: opts.mode, config: orchestrateConfig,
       });
 
       console.log('');

package/package.json

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