harnessed 4.0.0 → 4.1.0

package/dist/cli.mjs

@@ -1271,7 +1271,7 @@ var init_auto_install = __esm({
 
 // package.json
 var package_default = {
-  version: "4.0.0"};
+  version: "4.1.0"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -2583,6 +2583,7 @@ function getPackageRoot() {
 
 // src/cli/gates.ts
 var VALID_MASTERS = /* @__PURE__ */ new Set(["auto", "discuss", "plan", "task", "verify"]);
+var STAGE_MASTERS = /* @__PURE__ */ new Set(["discuss", "plan", "task", "verify"]);
 var PARALLELISM_GATE = "judgments.parallelism-gate.agent-teams-upgrade.fires";
 function defaultContext(task, stage) {
   return {
@@ -2733,6 +2734,9 @@ function fireEntry(clause) {
   if (clause.order !== void 0) entry.order = clause.order;
   if (clause.mode !== void 0) entry.mode = clause.mode;
   if (clause.gate !== void 0) entry.gate = clause.gate;
+  if (STAGE_MASTERS.has(clause.sub)) {
+    entry.is_master = true;
+  }
   return entry;
 }
 var DURATION_RE = /^(\d+)([dhmw])$/;
@@ -4397,6 +4401,7 @@ var INTERACTIVE_COMMANDS = /* @__PURE__ */ new Set([
 ]);
 var ORCHESTRATOR_COMMANDS = /* @__PURE__ */ new Set(["auto", "plan", "task", "verify"]);
 var MARKER = `<!-- harnessed-generated:v3.4.4 -->`;
+var LANG_DIRECTIVE = `> **Language**: respond to the user in the language set by \`env.HARNESSED_USER_LANG\` (e.g. \`zh-Hans\` \u2192 \u7B80\u4F53\u4E2D\u6587, \`en\` \u2192 English). If unset, mirror the user's input language. Keep code / commands / identifiers / error messages / URLs verbatim.`;
 function spawnLoopSteps(indent) {
   const i = indent;
   return [
@@ -4414,6 +4419,8 @@ function buildInteractiveBody(name, prompt) {
     ``,
     prompt.description,
     ``,
+    LANG_DIRECTIVE,
+    ``,
     `## How to run (interactive \u2014 in THIS session)`,
     ``,
     `Clarification requires real user dialogue. Spawned subagents cannot ask the user questions, so run this stage directly in this session \u2014 do NOT spawn it.`,
@@ -4447,6 +4454,8 @@ function buildOrchestratorBody(name, prompt) {
     ``,
     prompt.description,
     ``,
+    LANG_DIRECTIVE,
+    ``,
     `## How to run (orchestrator \u2014 clarify in THIS session, then drive native subagent spawns)`,
     ``,
     `harnessed is the orchestration brain: \`harnessed gates\` tells you which subs fire, \`harnessed prompt\` gives you each sub's spawn-ready prompt. YOU (the main session) do the spawning with CC-native Task / Agent tools \u2014 keeping the session responsive, enabling Agent Teams, and letting clarification round-trips reach the user.`,
@@ -4455,7 +4464,9 @@ function buildOrchestratorBody(name, prompt) {
     `2. Bash: \`harnessed gates ${name} --task "<locked spec>" --skip-sub clarify\` \u2192 parse the JSON \`{fire: [{sub, order, mode}], skip, parallelism: {escalate_to_teams}}\`.`,
     `3. If \`parallelism.escalate_to_teams === true\`: this stage needs multiple subagents to coordinate (SendMessage / shared contract). Read \`~/.claude/rules/agent-teams.md\`, then \`TeamCreate\` \u2192 \`Agent(name, team_name, ...)\` per fired sub (prompt from \`harnessed prompt <sub>\`) \u2192 coordinate via SendMessage \u2192 \`SendMessage shutdown_request\` + \`TeamDelete\`.`,
     `4. Otherwise, for each fired sub in \`order\` (serial subs sequentially, parallel subs concurrently via parallel Task calls):`,
-    ...spawnLoopSteps("   "),
+    `   - **If the fired entry has \`is_master: true\`** (it is itself a stage master, e.g. \`/auto\` firing \`plan\`/\`task\`/\`verify\`): do NOT prompt+spawn it directly \u2014 that would yield a vague dispatcher. RECURSE: run that master's orchestration \u2014 \`harnessed gates <sub> --task "<spec>" --skip-sub clarify\` \u2192 repeat this whole step-4 loop for ITS fired subs. Only leaf subs (no \`is_master\`) reach the spawn loop below.`,
+    `   - **Else (leaf sub)** \u2014 spawn it:`,
+    ...spawnLoopSteps("     "),
     `5. Report a per-sub fired/skipped summary to the user. ${name === "auto" ? "Then run the `retro` stage to capture lessons." : ""}`,
     ``,
     `Do NOT pipe to \`harnessed run ${name}\` \u2014 that is the CI/headless path (SDK spawn, blocks the session, no Agent Teams, no clarification round-trip).`,
@@ -4475,6 +4486,8 @@ function buildExecutionBody(name, prompt) {
     ``,
     prompt.description,
     ``,
+    LANG_DIRECTIVE,
+    ``,
     `## How to run (execution \u2014 native subagent spawn)`,
     ``,
     `harnessed gives you the spawn-ready prompt; YOU spawn the subagent with a CC-native Task / Agent tool (keeps the session responsive + lets clarification round-trips reach the user).`,
@@ -5699,78 +5712,6 @@ async function runWorkflow(yamlPath, vars, opts = {}) {
     ...skippedPhases.length > 0 ? { skippedPhases } : {}
   };
 }
-
-// src/cli/prompt.ts
-var DEFAULT_MAX_ITERATIONS = 20;
-var DEFAULT_MODEL = "sonnet";
-var DEFAULT_SPECIALIST = "Implementation Engineer";
-var PROTOCOLS = `
-## Completion protocol
-When done emit: <promise>COMPLETE</promise>
-
-## Clarification protocol
-If you hit a gray area you cannot decide (\u22652 reasonable options, missing key context, ambiguous requirement), do NOT self-decide. Emit:
-STATUS: NEEDS_CLARIFICATION
-1. <question>
-2. <question>
-The main session will relay these to the user and re-spawn you with answers.
-`;
-async function resolveMaxIterations2(sub, packageRoot) {
-  try {
-    const path = resolve(packageRoot, "workflows", "defaults.yaml");
-    const raw = await readFile(path, "utf8");
-    const doc = parse(raw);
-    const entry = doc?.ralph_max_iterations?.[sub];
-    if (typeof entry === "number" && Number.isFinite(entry)) {
-      return entry;
-    }
-    if (entry && typeof entry === "object") {
-      for (const v of Object.values(entry)) {
-        if (typeof v === "number" && Number.isFinite(v)) {
-          return v;
-        }
-      }
-    }
-    return DEFAULT_MAX_ITERATIONS;
-  } catch {
-    return DEFAULT_MAX_ITERATIONS;
-  }
-}
-function registerPrompt(program2) {
-  program2.command("prompt").description(
-    "Print a spawn-ready prompt for a sub-workflow (role + checklist + protocols, no spawn)."
-  ).argument("<sub>", "sub-workflow name (e.g. task-code, verify-paranoid)").option("--task <text>", "task description prepended as a ## Task section").option("--json", "emit JSON {prompt, max_iterations, model, specialist} instead of text").action(async (sub, raw) => {
-    const packageRoot = getPackageRoot();
-    const workflowsDir = resolve(packageRoot, "workflows");
-    const rolePrompts = await loadRolePrompts(workflowsDir);
-    const def = buildAgentDef(sub, rolePrompts, void 0, void 0, void 0);
-    const body = def.prompt;
-    const taskSection = typeof raw.task === "string" && raw.task.length > 0 ? `## Task
-${raw.task}
-
-` : "";
-    const fullPrompt = `${taskSection}${body}
-${PROTOCOLS}`;
-    if (raw.json) {
-      const maxIterations = await resolveMaxIterations2(sub, packageRoot);
-      const rp = rolePrompts[sub];
-      const model = def.model ?? DEFAULT_MODEL;
-      const specialist = rp?.specialist ?? DEFAULT_SPECIALIST;
-      console.log(
-        JSON.stringify({
-          prompt: fullPrompt,
-          max_iterations: maxIterations,
-          model,
-          specialist
-        })
-      );
-      process.exit(0);
-      return;
-    }
-    console.log(fullPrompt);
-    process.exit(0);
-  });
-}
 async function loadUserOverrides(packageRoot) {
   const yamlPath = resolve(packageRoot, "workflows", "judgments", "user-overrides.yaml");
   let raw;
@@ -6037,7 +5978,122 @@ async function getNextHint(workflowName) {
   return null;
 }
 
-// src/cli/research.ts
+// src/cli/prompt.ts
+var DEFAULT_MAX_ITERATIONS = 20;
+var DEFAULT_MODEL = "sonnet";
+var DEFAULT_SPECIALIST = "Implementation Engineer";
+var LANG_NAMES = {
+  en: "English",
+  "zh-Hans": "\u7B80\u4F53\u4E2D\u6587 (Simplified Chinese)",
+  "zh-CN": "\u7B80\u4F53\u4E2D\u6587 (Simplified Chinese)",
+  "zh-Hant": "\u7E41\u9AD4\u4E2D\u6587 (Traditional Chinese)",
+  "zh-TW": "\u7E41\u9AD4\u4E2D\u6587 (Traditional Chinese)"
+};
+async function buildToolsSection(sub, packageRoot) {
+  try {
+    const workflowsDir = resolve(packageRoot, "workflows");
+    const subYaml = await resolveWorkflowYaml(sub, workflowsDir);
+    if (!subYaml) return "";
+    const wfRaw = await readFile(subYaml, "utf8");
+    const wf = parse(wfRaw);
+    const tools = Array.isArray(wf?.tools_available) ? wf.tools_available : [];
+    if (tools.length === 0) return "";
+    const capRaw = await readFile(resolve(workflowsDir, "capabilities.yaml"), "utf8");
+    const capDoc = parse(capRaw);
+    const caps = capDoc?.capabilities ?? {};
+    const lines = [];
+    for (const tool of tools) {
+      const cmd = caps[tool]?.cmd;
+      const impl = caps[tool]?.impl;
+      lines.push(cmd ? `- Invoke \`${cmd}\` (${tool}${impl ? `, ${impl}` : ""})` : `- ${tool}`);
+    }
+    if (lines.length === 0) return "";
+    return `
+## Tools \u2014 invoke these (not optional)
+This workflow's SoT declares the following upstream tools. Actually invoke them as part of your work \u2014 do NOT improvise a lightweight substitute. Persist artifacts in the upstream's native format (e.g. planning-with-files \u2192 \`task_plan.md\` / \`progress.md\` / \`findings.md\`; GSD \u2192 \`PLAN.md\` / \`STATE.md\`).
+${lines.join("\n")}
+`;
+  } catch {
+    return "";
+  }
+}
+function buildLanguageSection() {
+  const code = process.env.HARNESSED_USER_LANG;
+  if (!code) return "";
+  const name = LANG_NAMES[code] ?? code;
+  return `
+## Language
+Respond in ${name}. Keep code, commands, file/identifier/API names, error messages, stack traces, URLs, commit hashes, and version numbers in their original form (do not translate or transliterate them).
+`;
+}
+var PROTOCOLS = `
+## Completion protocol
+When done emit: <promise>COMPLETE</promise>
+
+## Clarification protocol
+If you hit a gray area you cannot decide (\u22652 reasonable options, missing key context, ambiguous requirement), do NOT self-decide. Emit:
+STATUS: NEEDS_CLARIFICATION
+1. <question>
+2. <question>
+The main session will relay these to the user and re-spawn you with answers.
+`;
+async function resolveMaxIterations2(sub, packageRoot) {
+  try {
+    const path = resolve(packageRoot, "workflows", "defaults.yaml");
+    const raw = await readFile(path, "utf8");
+    const doc = parse(raw);
+    const entry = doc?.ralph_max_iterations?.[sub];
+    if (typeof entry === "number" && Number.isFinite(entry)) {
+      return entry;
+    }
+    if (entry && typeof entry === "object") {
+      for (const v of Object.values(entry)) {
+        if (typeof v === "number" && Number.isFinite(v)) {
+          return v;
+        }
+      }
+    }
+    return DEFAULT_MAX_ITERATIONS;
+  } catch {
+    return DEFAULT_MAX_ITERATIONS;
+  }
+}
+function registerPrompt(program2) {
+  program2.command("prompt").description(
+    "Print a spawn-ready prompt for a sub-workflow (role + checklist + protocols, no spawn)."
+  ).argument("<sub>", "sub-workflow name (e.g. task-code, verify-paranoid)").option("--task <text>", "task description prepended as a ## Task section").option("--json", "emit JSON {prompt, max_iterations, model, specialist} instead of text").action(async (sub, raw) => {
+    const packageRoot = getPackageRoot();
+    const workflowsDir = resolve(packageRoot, "workflows");
+    const rolePrompts = await loadRolePrompts(workflowsDir);
+    const def = buildAgentDef(sub, rolePrompts, void 0, void 0, void 0);
+    const body = def.prompt;
+    const taskSection = typeof raw.task === "string" && raw.task.length > 0 ? `## Task
+${raw.task}
+
+` : "";
+    const toolsSection = await buildToolsSection(sub, packageRoot);
+    const fullPrompt = `${taskSection}${body}
+${toolsSection}${PROTOCOLS}${buildLanguageSection()}`;
+    if (raw.json) {
+      const maxIterations = await resolveMaxIterations2(sub, packageRoot);
+      const rp = rolePrompts[sub];
+      const model = def.model ?? DEFAULT_MODEL;
+      const specialist = rp?.specialist ?? DEFAULT_SPECIALIST;
+      console.log(
+        JSON.stringify({
+          prompt: fullPrompt,
+          max_iterations: maxIterations,
+          model,
+          specialist
+        })
+      );
+      process.exit(0);
+      return;
+    }
+    console.log(fullPrompt);
+    process.exit(0);
+  });
+}
 var PACKAGE_ROOT2 = getPackageRoot();
 var WORKFLOWS_DIR2 = join(PACKAGE_ROOT2, "workflows");
 function registerResearch(program2) {