@harness-engineering/cli 7.0.0 → 8.0.0

package/dist/bin/harness.js

@@ -3,7 +3,7 @@ import {
   createProgram,
   installCommandTelemetry,
   printFirstRunWelcome
-} from "../chunk-N4VEUBJ5.js";
+} from "../chunk-MSJJU6KH.js";
 import "../chunk-PYDUECJ3.js";
 import "../chunk-7IVIRKHD.js";
 import "../chunk-XYP5CIEN.js";

package/dist/{chunk-N4VEUBJ5.js → chunk-MSJJU6KH.js}

@@ -11987,15 +11987,45 @@ async function buildShapeHistory(cwd) {
   }
   return (shapeKey) => byShape.get(shapeKey) ?? [];
 }
+function selectActionableFeatures(roadmap, opts = {}) {
+  let features = roadmap.milestones.flatMap((m) => m.features).filter(isActionable);
+  if (opts.only !== void 0 && opts.only.trim().length > 0) {
+    const needle = opts.only.trim().toLowerCase();
+    features = features.filter((f) => f.name.toLowerCase().includes(needle));
+  }
+  if (opts.limit !== void 0 && opts.limit >= 0) {
+    features = features.slice(0, opts.limit);
+  }
+  return features;
+}
+function isPlausibleForModel(verdict) {
+  const scope = verdict.levers.scope.value;
+  const scopeResolvedBounded = scope !== "unknown" && scope.resolved.length > 0;
+  const level = verdict.verdict.level;
+  const inBand = level === "trivial" || level === "simple";
+  return scopeResolvedBounded && inBand;
+}
 async function runTriageReport(roadmap, deps = {}) {
-  const features = roadmap.milestones.flatMap((m) => m.features).filter(isActionable);
+  const features = selectActionableFeatures(roadmap, {
+    ...deps.only !== void 0 ? { only: deps.only } : {},
+    ...deps.limit !== void 0 ? { limit: deps.limit } : {}
+  });
+  const cheapDeps = {
+    ...deps.graphStore ? { graphStore: deps.graphStore } : {},
+    ...deps.precedent ? { precedent: deps.precedent } : {},
+    ...deps.config ? { config: deps.config } : {}
+  };
+  const useModel = deps.offline !== true && deps.provider != null;
   const rows = [];
   for (const feature of features) {
-    const verdict = await triageIssue(featureToIssue(feature), {
-      ...deps.graphStore ? { graphStore: deps.graphStore } : {},
-      ...deps.precedent ? { precedent: deps.precedent } : {},
-      ...deps.config ? { config: deps.config } : {}
-    });
+    let verdict = await triageIssue(featureToIssue(feature), cheapDeps);
+    if (useModel && isPlausibleForModel(verdict)) {
+      deps.onProgress?.(`Refining "${feature.name}" on the local model\u2026`);
+      verdict = await triageIssue(featureToIssue(feature), {
+        ...cheapDeps,
+        ...deps.provider ? { provider: deps.provider } : {}
+      });
+    }
     rows.push({
       externalId: verdict.externalId,
       name: feature.name,
@@ -12051,8 +12081,27 @@ function renderJson(rows) {
     2
   );
 }
+function skippedBrainstormRow(feature, verdict, level) {
+  return {
+    externalId: verdict.externalId,
+    name: feature.name,
+    status: feature.status,
+    level,
+    result: {
+      outcome: {
+        kind: "halted",
+        reason: "error",
+        fork: { id: "scope-gate", question: "", options: [] },
+        detail: `Skipped brainstorm \u2014 not a plausible candidate (${verdict.holdReason ?? "held"}). Held to human by the cheap scope/band gate.`
+      }
+    }
+  };
+}
 async function runBrainstormReport(roadmap, deps = {}) {
-  const features = roadmap.milestones.flatMap((m) => m.features).filter(isActionable);
+  const features = selectActionableFeatures(roadmap, {
+    ...deps.only !== void 0 ? { only: deps.only } : {},
+    ...deps.limit !== void 0 ? { limit: deps.limit } : {}
+  });
   const rows = [];
   for (const feature of features) {
     const issue = featureToIssue(feature);
@@ -12063,6 +12112,11 @@ async function runBrainstormReport(roadmap, deps = {}) {
       ...deps.config ? { config: deps.config } : {}
     });
     const level = verdict.verdict.level;
+    if (deps.gatePlausible === true && !isPlausibleForModel(verdict)) {
+      rows.push(skippedBrainstormRow(feature, verdict, level));
+      continue;
+    }
+    deps.onProgress?.(`Brainstorming "${feature.name}" [${level}]\u2026`);
     const wiringDeps = {
       ...deps.generator ? { generator: deps.generator } : {},
       ...deps.provider ? { provider: deps.provider } : {},
@@ -12262,59 +12316,93 @@ function createRoadmapTriageCommand() {
   ).option(
     "--brainstorm",
     "Run the autonomous brainstorm per candidate: draft a spec (docs only) or halt to a human at the first fork it can not confidently recommend. No dispatch, no execution."
-  ).action(async (opts, cmd) => {
-    const cwd = process.cwd();
-    const globalOpts = cmd.optsWithGlobals();
-    const configResult = resolveConfig(globalOpts.config);
-    const enabled = configResult.ok && configResult.value.roadmap?.autoTriage?.enabled === true;
-    if (!enabled) {
-      logger.info(
-        "Roadmap auto-triage is disabled (roadmap.autoTriage.enabled is not true). Enable it in harness.config.json to run the read-only triage report. No changes made."
-      );
-      return;
-    }
-    const roadmapPath = path60.join(cwd, "docs", "roadmap.md");
-    if (!fs36.existsSync(roadmapPath)) {
-      logger.error(
-        `No roadmap aggregate at ${roadmapPath}. If your roadmap is sharded, run \`harness roadmap regen\` first, then re-run triage.`
-      );
-      process.exitCode = 1;
-      return;
-    }
-    const parsed = parseRoadmap(fs36.readFileSync(roadmapPath, "utf-8"));
-    if (!parsed.ok) {
-      logger.error(`Failed to parse roadmap: ${parsed.error.message}`);
-      process.exitCode = 1;
-      return;
-    }
-    const graphStore = await loadGraphStore(cwd);
-    const precedent = await buildPrecedentLookup(cwd);
-    if (opts.brainstorm) {
-      const provider = resolveBrainstormProvider(globalOpts.config);
-      const rows2 = await runBrainstormReport(parsed.value, {
-        ...graphStore ? { graphStore } : {},
-        ...provider ? { provider } : {},
-        ...precedent ? { precedent } : {},
-        // Specs are written under docs/changes/<slug>/proposal.md (docs only, no dispatch).
-        docsRoot: path60.join(cwd, "docs")
-      });
-      if (globalOpts.json) {
-        process.stdout.write(renderBrainstormJson(rows2) + "\n");
-      } else {
-        logger.info(renderBrainstormHuman(rows2));
-      }
-      return;
+  ).option(
+    "--only <substring>",
+    'Process ONLY roadmap items whose title contains this substring (case-insensitive). Lets you triage/brainstorm a single item, e.g. --only "prefer-execfile".'
+  ).option(
+    "--limit <n>",
+    "Process at most N items (applied after --only). Useful for a quick partial scan.",
+    (v) => Number.parseInt(v, 10)
+  ).option(
+    "--offline",
+    "Force the pure static path \u2014 never consult the local model. A fast scan that holds every item to a human (byte-identical to running without a resolvable model)."
+  ).action(
+    async (opts, cmd) => {
+      await runTriageCommandAction(opts, cmd);
     }
-    const rows = await runTriageReport(parsed.value, {
-      ...graphStore ? { graphStore } : {},
-      ...precedent ? { precedent } : {}
+  ).addCommand(createTriageApproveCommand());
+}
+async function runTriageCommandAction(opts, cmd) {
+  const cwd = process.cwd();
+  const globalOpts = cmd.optsWithGlobals();
+  const parsed = gateAndParseRoadmap(cwd, globalOpts.config);
+  if (!parsed) return;
+  const graphStore = await loadGraphStore(cwd);
+  const precedent = await buildPrecedentLookup(cwd);
+  const provider = opts.offline === true ? null : resolveBrainstormProvider(globalOpts.config);
+  const onProgress = globalOpts.json === true ? void 0 : (message) => logger.info(message);
+  const shared = {
+    ...graphStore ? { graphStore } : {},
+    ...provider ? { provider } : {},
+    ...precedent ? { precedent } : {},
+    ...opts.only !== void 0 ? { only: opts.only } : {},
+    ...typeof opts.limit === "number" && !Number.isNaN(opts.limit) ? { limit: opts.limit } : {},
+    ...onProgress ? { onProgress } : {}
+  };
+  if (opts.brainstorm) {
+    const rows2 = await runBrainstormReport(parsed, {
+      ...shared,
+      gatePlausible: true,
+      docsRoot: path60.join(cwd, "docs")
     });
-    if (globalOpts.json) {
-      process.stdout.write(renderJson(rows) + "\n");
-    } else {
-      logger.info(renderHuman(rows));
-    }
-  }).addCommand(createTriageApproveCommand());
+    emitReport(
+      globalOpts.json === true,
+      () => renderBrainstormJson(rows2),
+      () => renderBrainstormHuman(rows2)
+    );
+    return;
+  }
+  const rows = await runTriageReport(parsed, {
+    ...shared,
+    ...opts.offline === true ? { offline: true } : {}
+  });
+  emitReport(
+    globalOpts.json === true,
+    () => renderJson(rows),
+    () => renderHuman(rows)
+  );
+}
+function gateAndParseRoadmap(cwd, configPath) {
+  const configResult = resolveConfig(configPath);
+  const enabled = configResult.ok && configResult.value.roadmap?.autoTriage?.enabled === true;
+  if (!enabled) {
+    logger.info(
+      "Roadmap auto-triage is disabled (roadmap.autoTriage.enabled is not true). Enable it in harness.config.json to run the read-only triage report. No changes made."
+    );
+    return null;
+  }
+  const roadmapPath = path60.join(cwd, "docs", "roadmap.md");
+  if (!fs36.existsSync(roadmapPath)) {
+    logger.error(
+      `No roadmap aggregate at ${roadmapPath}. If your roadmap is sharded, run \`harness roadmap regen\` first, then re-run triage.`
+    );
+    process.exitCode = 1;
+    return null;
+  }
+  const parsed = parseRoadmap(fs36.readFileSync(roadmapPath, "utf-8"));
+  if (!parsed.ok) {
+    logger.error(`Failed to parse roadmap: ${parsed.error.message}`);
+    process.exitCode = 1;
+    return null;
+  }
+  return parsed.value;
+}
+function emitReport(json, toJson, toHuman) {
+  if (json) {
+    process.stdout.write(toJson() + "\n");
+  } else {
+    logger.info(toHuman());
+  }
 }
 
 // src/commands/roadmap/index.ts

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   runSnapshotCapture,
   runUninstall,
   runUninstallConstraints
-} from "./chunk-N4VEUBJ5.js";
+} from "./chunk-MSJJU6KH.js";
 import {
   generateRuntime
 } from "./chunk-PYDUECJ3.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/cli",
-  "version": "7.0.0",
+  "version": "8.0.0",
   "description": "CLI for Harness Engineering toolkit",
   "type": "module",
   "bin": {
@@ -40,15 +40,15 @@
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
     "@harness-engineering/core": "0.37.0",
+    "@harness-engineering/dashboard": "0.14.4",
     "@harness-engineering/graph": "0.11.8",
-    "@harness-engineering/dashboard": "0.14.3",
     "@harness-engineering/linter-gen": "0.1.7",
-    "@harness-engineering/orchestrator": "0.15.0",
-    "@harness-engineering/types": "0.22.0",
-    "@harness-engineering/signals": "0.2.6"
+    "@harness-engineering/orchestrator": "0.15.1",
+    "@harness-engineering/signals": "0.2.6",
+    "@harness-engineering/types": "0.22.0"
   },
   "peerDependencies": {
-    "@harness-engineering/intelligence": "0.7.0"
+    "@harness-engineering/intelligence": "0.8.0"
   },
   "peerDependenciesMeta": {
     "@harness-engineering/intelligence": {