harnessed 4.7.0 → 4.9.0

package/bin/harnessed-inject-state.mjs

@@ -38,11 +38,28 @@ function harnessedRoot() {
     : join(homedir(), '.claude', 'harnessed')
 }
 
-// workflows.json[repoKey] first, then the legacy singleton (dual-write anchor).
-function readWorkflow(root, key) {
+// Phase 35 — mirror PlatformDescriptor.sessionIdEnv (src/installers/lib/platform.ts)
+// for the hot path: which env var carries the active session id. Minimal replica —
+// HARNESSED_PLATFORM selects (default claude); codex has none. State-root selection
+// (.platform pin / auto-probe) is orthogonal and already handled via
+// HARNESSED_ROOT_OVERRIDE, so it is not re-derived here. The TS `activeKey` uses the
+// full descriptor; the parity test sets matching signals.
+function sessionIdEnvName() {
+  const platform = (process.env.HARNESSED_PLATFORM || 'claude').trim()
+  if (platform === 'codex') return null
+  return 'CLAUDE_CODE_SESSION_ID' // claude (default)
+}
+
+// Phase 35 — try the session-scoped slot first, then the bare repoKey slot, then
+// the legacy singleton (dual-write anchor). `keys` is ordered most→least specific.
+function readWorkflow(root, keys) {
   try {
     const store = JSON.parse(readFileSync(join(root, 'workflows.json'), 'utf8'))
-    if (store && store.workflows && store.workflows[key]) return store.workflows[key]
+    if (store?.workflows) {
+      for (const k of keys) {
+        if (store.workflows[k]) return store.workflows[k]
+      }
+    }
   } catch {}
   try {
     return JSON.parse(readFileSync(join(root, 'current-workflow.json'), 'utf8'))
@@ -76,6 +93,14 @@ function workflowStateBlock(wf) {
       'RETRO-DUE: enough phases completed since the last retro — run /retro, then `harnessed retro --done`',
     )
   }
+  // Phase 36 — scale-adaptive verify_mode directive (parity with injectState.ts).
+  if (wf.verify_mode === 'full') {
+    lines.push(
+      'VERIFY-MODE: full — run full verification (large/risky change: >5 files / >4 subs / >3 reqs)',
+    )
+  } else if (wf.verify_mode === 'light') {
+    lines.push('VERIFY-MODE: light — scope verification to the changed surface (small change)')
+  }
   lines.push('</workflow-state>')
   return lines.join('\n')
 }
@@ -140,8 +165,14 @@ function projectContextBlock(learnings, contextExcerpt) {
 
 try {
   const root = harnessedRoot()
+  // `key` is the repo ROOT directory (used for .planning/ fs paths below). The
+  // workflow LOOKUP uses the session-scoped composite key first (Phase 34/35),
+  // falling back to the bare repoKey, then the legacy singleton. The composite
+  // key is NOT a real directory — only the bare repoKey is.
   const key = repoKey(process.cwd())
-  const wf = readWorkflow(root, key)
+  const envName = sessionIdEnvName()
+  const sid = envName ? process.env[envName]?.trim() : undefined
+  const wf = readWorkflow(root, sid ? [`${key}::${sid}`, key] : [key])
   if (!wf) process.exit(0)
 
   const budget = Number(process.env.HARNESSED_INJECT_BUDGET) || DEFAULT_INJECT_BUDGET

package/dist/cli.mjs

@@ -6,6 +6,7 @@ import * as ajvFormatsNs from 'ajv-formats';
 import { execFileSync, spawnSync, spawn, exec, execFile, execSync } from 'child_process';
 import { existsSync, mkdirSync, renameSync, writeFileSync, readFileSync, readdirSync } from 'fs';
 import { join, dirname, resolve, sep, relative } from 'path';
+import { fileURLToPath } from 'url';
 import { homedir } from 'os';
 import { createHash } from 'crypto';
 import { readFile, readdir, unlink, writeFile, stat, rm, cp, mkdir, rename, appendFile, access } from 'fs/promises';
@@ -13,7 +14,6 @@ import { Value } from '@sinclair/typebox/value';
 import lockfile from 'proper-lockfile';
 import { Parser } from 'expr-eval';
 import { query } from '@anthropic-ai/claude-agent-sdk';
-import { fileURLToPath } from 'url';
 import { promisify } from 'util';
 import * as p from '@clack/prompts';
 import { createPatch } from 'diff';
@@ -38,7 +38,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "harnessed",
-      version: "4.7.0",
+      version: "4.9.0",
       description: "AI coding harness package manager + composition orchestrator",
       type: "module",
       license: "Apache-2.0",
@@ -852,6 +852,76 @@ var init_origin_check = __esm({
   "src/cli/lib/origin-check.ts"() {
   }
 });
+function mapToSupported(raw) {
+  if (!raw) return "en";
+  if (/^zh([^a-z]|$)/i.test(raw)) return "zh-Hans";
+  return "en";
+}
+function detectLocale() {
+  const raw = process.env.HARNESSED_LANG || process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || safeIntlLocale();
+  return mapToSupported(raw);
+}
+function safeIntlLocale() {
+  try {
+    return Intl.DateTimeFormat().resolvedOptions().locale;
+  } catch {
+    return void 0;
+  }
+}
+function messagesDir() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [resolve(here, "..", "..", "messages"), resolve(here, "..", "messages")];
+  for (const c of candidates) {
+    try {
+      readFileSync(join(c, "en.json"), "utf8");
+      return c;
+    } catch {
+    }
+  }
+  return resolve(process.cwd(), "messages");
+}
+function loadLocale(locale) {
+  if (cache[locale]) return cache[locale];
+  const path = join(messagesDir(), `${locale}.json`);
+  try {
+    const raw = readFileSync(path, "utf8");
+    cache[locale] = JSON.parse(raw);
+  } catch {
+    cache[locale] = {};
+  }
+  return cache[locale];
+}
+function setLocale(locale) {
+  if (!locale) return;
+  const mapped = mapToSupported(locale);
+  if (SUPPORTED.has(mapped)) currentLocale = mapped;
+}
+function getLocale() {
+  if (currentLocale === null) currentLocale = detectLocale();
+  return currentLocale;
+}
+function t(key, params) {
+  const locale = getLocale();
+  const primary = loadLocale(locale);
+  let template = primary[key];
+  if (template === void 0 && locale !== "en") {
+    template = loadLocale("en")[key];
+  }
+  if (template === void 0) template = key;
+  if (!params) return template;
+  return template.replace(/\{\{(\w+)\}\}/g, (_match, name) => {
+    const v = params[name];
+    return v === void 0 ? `{{${name}}}` : String(v);
+  });
+}
+var SUPPORTED, currentLocale, cache;
+var init_i18n = __esm({
+  "src/i18n/index.ts"() {
+    SUPPORTED = /* @__PURE__ */ new Set(["en", "zh-Hans"]);
+    currentLocale = null;
+    cache = {};
+  }
+});
 function claudeDescriptor(home = homedir()) {
   const claudeHome = join(home, ".claude");
   return {
@@ -866,7 +936,9 @@ function claudeDescriptor(home = homedir()) {
     // the same home base — not a child of homeDir.
     mcpConfigPath: join(home, ".claude.json"),
     // claude writes its env keys into JSON settings.json (capability present).
-    supportsEnvKeyWrite: true
+    supportsEnvKeyWrite: true,
+    // Claude Code exposes the active session id to Bash-invoked CLI + hooks.
+    sessionIdEnv: "CLAUDE_CODE_SESSION_ID"
   };
 }
 function codexDescriptor(home = homedir()) {
@@ -882,7 +954,9 @@ function codexDescriptor(home = homedir()) {
     commandsDir: join(codexHome, "prompts"),
     pluginsRegistry: null,
     mcpConfigPath: configToml,
-    supportsEnvKeyWrite: false
+    supportsEnvKeyWrite: false,
+    // No verified codex session-id env → single-session fallback (anti-stale).
+    sessionIdEnv: null
   };
 }
 function descriptorById(id, home) {
@@ -1406,6 +1480,7 @@ var workflowStore_exports = {};
 __export(workflowStore_exports, {
   RetroMetaEntry: () => RetroMetaEntry,
   WorkflowStoreV1: () => WorkflowStoreV1,
+  activeKey: () => activeKey,
   listWorkflows: () => listWorkflows,
   readStoreRaw: () => readStoreRaw,
   repoKey: () => repoKey,
@@ -1430,6 +1505,12 @@ function repoKey(cwd = process.cwd()) {
   }
   return resolve(cwd);
 }
+function activeKey(cwd = process.cwd()) {
+  const base = repoKey(cwd);
+  const envName = detectPlatform().sessionIdEnv;
+  const sid = envName ? process.env[envName]?.trim() : void 0;
+  return sid ? `${base}::${sid}` : base;
+}
 async function readStoreRaw() {
   try {
     const parsed = JSON.parse(await readFile(storePath(), "utf8"));
@@ -1469,6 +1550,7 @@ var RetroMetaEntry, WorkflowStoreV1;
 var init_workflowStore = __esm({
   "src/checkpoint/workflowStore.ts"() {
     init_harnessedRoot();
+    init_platform();
     init_schemaVersion();
     init_atomicWrite();
     init_currentWorkflow_v1();
@@ -1535,7 +1617,7 @@ async function withLock(fn) {
 }
 async function readCurrentWorkflow() {
   const store = await readStoreRaw();
-  return store.workflows[repoKey()] ?? null;
+  return store.workflows[activeKey()] ?? store.workflows[repoKey()] ?? null;
 }
 async function writeCurrentWorkflowUnlocked(s) {
   if (!Value.Check(CurrentWorkflowV1, s)) {
@@ -1543,7 +1625,7 @@ async function writeCurrentWorkflowUnlocked(s) {
     throw new WorkflowStateError(`current-workflow schema validation failed: ${errs}`);
   }
   const store = await readStoreRaw();
-  store.workflows[repoKey()] = s;
+  store.workflows[activeKey()] = s;
   await writeStoreRaw(store);
   await writeFileAtomic(statePath(), JSON.stringify(s, null, 2));
 }
@@ -1978,8 +2060,20 @@ var init_loadPhases = __esm({
     };
   }
 });
-async function loadRolePrompts(workflowsDir) {
-  const path = join(workflowsDir, "role-prompts.yaml");
+function resolveLocaleYaml(dir, baseName, locale = getLocale()) {
+  if (locale !== "en") {
+    const sibling = join(dir, `${baseName}.${locale}.yaml`);
+    if (existsSync(sibling)) return sibling;
+  }
+  return join(dir, `${baseName}.yaml`);
+}
+var init_localeYaml = __esm({
+  "src/i18n/localeYaml.ts"() {
+    init_i18n();
+  }
+});
+async function loadRolePrompts(workflowsDir, locale = getLocale()) {
+  const path = resolveLocaleYaml(workflowsDir, "role-prompts", locale);
   let raw;
   try {
     raw = await readFile(path, "utf8");
@@ -2193,6 +2287,8 @@ async function writeAllCommands(slashNames, commandsDir, rolePrompts, capabiliti
 var INTERACTIVE_COMMANDS, ORCHESTRATOR_COMMANDS, MARKER, LANG_DIRECTIVE, HARNESSED_MARKER_RX, V3_4_3_SIGNATURE_SUB_RX, V3_4_3_SIGNATURE_MASTER_RX;
 var init_generateCommands = __esm({
   "src/cli/lib/generateCommands.ts"() {
+    init_i18n();
+    init_localeYaml();
     INTERACTIVE_COMMANDS = /* @__PURE__ */ new Set([
       "discuss",
       "discuss-strategic",
@@ -6875,73 +6971,9 @@ audited ${yamls.length} manifest${yamls.length === 1 ? "" : "s"} \u2014 ${findin
     process.exit(errorCount > 0 ? 1 : 0);
   });
 }
-var SUPPORTED = /* @__PURE__ */ new Set(["en", "zh-Hans"]);
-var currentLocale = null;
-var cache = {};
-function mapToSupported(raw) {
-  if (!raw) return "en";
-  if (/^zh([^a-z]|$)/i.test(raw)) return "zh-Hans";
-  return "en";
-}
-function detectLocale() {
-  const raw = process.env.HARNESSED_LANG || process.env.LC_ALL || process.env.LANG || process.env.LANGUAGE || safeIntlLocale();
-  return mapToSupported(raw);
-}
-function safeIntlLocale() {
-  try {
-    return Intl.DateTimeFormat().resolvedOptions().locale;
-  } catch {
-    return void 0;
-  }
-}
-function messagesDir() {
-  const here = dirname(fileURLToPath(import.meta.url));
-  const candidates = [resolve(here, "..", "..", "messages"), resolve(here, "..", "messages")];
-  for (const c of candidates) {
-    try {
-      readFileSync(join(c, "en.json"), "utf8");
-      return c;
-    } catch {
-    }
-  }
-  return resolve(process.cwd(), "messages");
-}
-function loadLocale(locale) {
-  if (cache[locale]) return cache[locale];
-  const path = join(messagesDir(), `${locale}.json`);
-  try {
-    const raw = readFileSync(path, "utf8");
-    cache[locale] = JSON.parse(raw);
-  } catch {
-    cache[locale] = {};
-  }
-  return cache[locale];
-}
-function setLocale(locale) {
-  if (!locale) return;
-  const mapped = mapToSupported(locale);
-  if (SUPPORTED.has(mapped)) currentLocale = mapped;
-}
-function getLocale() {
-  if (currentLocale === null) currentLocale = detectLocale();
-  return currentLocale;
-}
-function t(key, params) {
-  const locale = getLocale();
-  const primary = loadLocale(locale);
-  let template = primary[key];
-  if (template === void 0 && locale !== "en") {
-    template = loadLocale("en")[key];
-  }
-  if (template === void 0) template = key;
-  if (!params) return template;
-  return template.replace(/\{\{(\w+)\}\}/g, (_match, name) => {
-    const v = params[name];
-    return v === void 0 ? `{{${name}}}` : String(v);
-  });
-}
 
 // src/cli/audit-log.ts
+init_i18n();
 init_harnessedRoot();
 function auditPath() {
   return harnessedFile("audit.log");
@@ -7048,6 +7080,9 @@ function registerAuditLog(program2) {
     }
   );
 }
+
+// src/cli/backup-list.ts
+init_i18n();
 init_backup();
 function registerBackupList(program2) {
   const backup2 = program2.command("backup").description("Backup snapshot operations");
@@ -7283,6 +7318,7 @@ function registerCompact(program2) {
 }
 
 // src/cli/doctor.ts
+init_i18n();
 init_doctor_registry();
 function registerDoctor(program2) {
   program2.command("doctor").description(
@@ -7439,6 +7475,9 @@ function fireEntry(clause, master) {
   if (isMaster) entry.is_master = true;
   return entry;
 }
+
+// src/cli/gc.ts
+init_i18n();
 init_backup();
 var DURATION_RE = /^(\d+)([dhmw])$/;
 function parseDuration(s) {
@@ -7529,6 +7568,7 @@ ${t("gc.invalid_duration.fix")}`
 
 // src/cli/install.ts
 init_package();
+init_i18n();
 init_installers();
 init_path_guard();
 init_validate();
@@ -7631,12 +7671,14 @@ function registerLearn(program2) {
 
 // src/cli/lib/here.ts
 init_nextStep();
+init_i18n();
 init_harnessedRoot();
 
 // src/cli/status.ts
 init_evidence();
 init_ledger();
 init_state();
+init_i18n();
 init_harnessedRoot();
 init_state2();
 function statusMarker(status) {
@@ -7803,6 +7845,9 @@ async function runHere(opts) {
   }
   process.exit(0);
 }
+
+// src/cli/manifest-add.ts
+init_i18n();
 var QA = [
   { q: "\u2460 \u662F\u771F reusable surface \u8FD8\u662F\u4E34\u65F6 wrapper?", f: "q1_reusable_surface" },
   { q: "\u2461 \u4E0A\u6E38\u540D\u5B57 fit \u9879\u76EE shape \u5417? \u6709\u73B0\u6709\u547D\u540D\u51B2\u7A81\u5417?", f: "q2_name_fit" },
@@ -7874,6 +7919,8 @@ function registerNext(program2) {
 }
 
 // src/cli/prompt.ts
+init_i18n();
+init_localeYaml();
 init_run();
 init_generateCommands();
 init_packagePath();
@@ -7919,16 +7966,17 @@ ${lines.join("\n")}
     return "";
   }
 }
-async function buildDisciplinesSection(sub, packageRoot) {
+async function buildDisciplinesSection(sub, packageRoot, locale = getLocale()) {
   try {
     const workflowsDir = resolve(packageRoot, "workflows");
+    const disciplinesDir = resolve(workflowsDir, "disciplines");
     const applied = await loadSubArrayField(sub, packageRoot, "disciplines_applied");
     const names = applied.filter((d) => d !== "language");
     if (names.length === 0) return "";
     const blocks = [];
     for (const name of names) {
       try {
-        const dRaw = await readFile(resolve(workflowsDir, "disciplines", `${name}.yaml`), "utf8");
+        const dRaw = await readFile(resolveLocaleYaml(disciplinesDir, name, locale), "utf8");
         const dDoc = parse(dRaw);
         const rules = Array.isArray(dDoc?.rules) ? dDoc.rules : [];
         const descs = rules.map((r) => typeof r.description === "string" ? r.description.trim() : "").filter((s) => s.length > 0).map((s) => `  - ${s.replace(/\s+/g, " ")}`);
@@ -8074,6 +8122,9 @@ function registerReleasePreflight(program2) {
     process.exit(failed ? 1 : 0);
   });
 }
+
+// src/cli/research.ts
+init_i18n();
 init_run();
 init_packagePath();
 init_run2();
@@ -8115,6 +8166,7 @@ function registerResearch(program2) {
 }
 
 // src/cli/resume.ts
+init_i18n();
 function registerResume(program2) {
   program2.command("resume").description(
     "Reload checkpoint from paused workflow + print resume hint (D-03 \u2014 user invokes phase command manually)"
@@ -8179,6 +8231,9 @@ function registerRetro(program2) {
     process.exit(0);
   });
 }
+
+// src/cli/rollback.ts
+init_i18n();
 init_backup();
 function normalizeEol(buf, eol) {
   const lf = buf.toString("utf8").replace(/\r\n/g, "\n");
@@ -8250,6 +8305,9 @@ ${t("rollback.metadata_unreadable.fix")}`
 
 // src/cli.ts
 init_run2();
+
+// src/cli/setup.ts
+init_i18n();
 init_platform();
 
 // src/cli/lib/capabilityResolver.ts
@@ -8504,42 +8562,78 @@ async function enableUserLangInSettings(override) {
 // src/cli/setup.ts
 init_generateCommands();
 init_packagePath();
+
+// src/cli/lib/renderSkillTemplates.ts
+init_i18n();
+
+// src/cli/lib/resolveSkillBody.ts
+init_i18n();
+function skillBodyFilename(locale) {
+  return locale === "en" ? "SKILL.md" : `SKILL.${locale}.md`;
+}
+function resolveSkillBodyFilename(skillDir, locale) {
+  const resolved = locale ?? getLocale();
+  const candidate = skillBodyFilename(resolved);
+  if (candidate === "SKILL.md") return "SKILL.md";
+  return existsSync(join(skillDir, candidate)) ? candidate : "SKILL.md";
+}
+
+// src/cli/lib/renderSkillTemplates.ts
+var LOCALE_SIBLINGS = ["zh-Hans"];
 async function loadCapabilities(workflowsDir) {
   const path = join(workflowsDir, "capabilities.yaml");
   const raw = await readFile(path, "utf8");
   const doc = parse(raw);
   return doc?.capabilities ?? {};
 }
-async function renderSkillFile(skillName, skillsBase, capabilities, installedPlugins, installedUserSkills) {
-  const skillPath = join(skillsBase, skillName, "SKILL.md");
+async function renderSkillFile(skillName, skillsBase, capabilities, installedPlugins, installedUserSkills, locale) {
+  const dir = join(skillsBase, skillName);
+  const resolved = locale ?? getLocale();
+  const srcName = resolveSkillBodyFilename(dir, resolved);
+  const srcPath = join(dir, srcName);
+  const destPath = join(dir, "SKILL.md");
   const result = {
     name: skillName,
-    skillPath,
+    skillPath: destPath,
     rendered: false,
     warnings: []
   };
   let body;
   try {
-    body = await readFile(skillPath, "utf8");
+    body = await readFile(srcPath, "utf8");
   } catch (e) {
     result.error = `read failed: ${e.message}`;
     return result;
   }
   const rendered = renderSkillBody(body, capabilities, installedPlugins, installedUserSkills);
-  if (rendered.body === body) {
+  const localeBodySelected = srcName !== "SKILL.md";
+  const needsWrite = localeBodySelected || rendered.body !== body;
+  if (!needsWrite) {
     result.warnings = rendered.warnings;
     return result;
   }
   try {
-    await writeFile(skillPath, rendered.body, "utf8");
-    result.rendered = true;
+    await writeFile(destPath, rendered.body, "utf8");
+    result.rendered = rendered.body !== body;
     result.warnings = rendered.warnings;
   } catch (e) {
     result.error = `write failed: ${e.message}`;
+    return result;
+  }
+  if (localeBodySelected) {
+    for (const loc of LOCALE_SIBLINGS) {
+      const sibling = skillBodyFilename(loc);
+      if (sibling === "SKILL.md") continue;
+      try {
+        await rm(join(dir, sibling), { force: true });
+      } catch {
+      }
+    }
   }
   return result;
 }
-async function renderAllSkills(skillNames, skillsBase, workflowsDir, homedirOverride) {
+async function renderAllSkills(skillNames, skillsBase, workflowsDir, homedirOverride, locale) {
+  const resolvedLocale = locale ?? getLocale();
   let capabilities = {};
   try {
     capabilities = await loadCapabilities(workflowsDir);
@@ -8567,7 +8661,8 @@ async function renderAllSkills(skillNames, skillsBase, workflowsDir, homedirOver
       skillsBase,
       capabilities,
       installedPlugins,
-      installedUserSkills
+      installedUserSkills,
+      resolvedLocale
     );
     results.push(r);
     for (const w of r.warnings) warningSet.add(w);
@@ -8835,7 +8930,13 @@ function registerSetup(program2) {
     }
     console.log(t("setup.step_a_complete", { count: skillsInstalled, path: skillsBase }));
     const skillNames = toInstall.map((wf) => wf.name);
-    const rendered = await renderAllSkills(skillNames, skillsBase, workflowsDir);
+    const rendered = await renderAllSkills(
+      skillNames,
+      skillsBase,
+      workflowsDir,
+      void 0,
+      getLocale()
+    );
     if (rendered.aggregatedWarnings.length > 0) {
       console.warn(t("setup.step_a_render.warnings_header"));
       for (const w of rendered.aggregatedWarnings) {
@@ -8937,6 +9038,9 @@ Force-update pass complete: ${b2.installed.length} installed / ${b2.alreadyInsta
     process.exit(0);
   });
 }
+
+// src/cli/uninstall.ts
+init_i18n();
 init_harnessedRoot();
 init_path_guard();
 init_validate();
@@ -9513,6 +9617,7 @@ function registerWorkflows(program2) {
 }
 
 // src/cli.ts
+init_i18n();
 init_harnessedRoot();
 migrateLegacyHarnessedRoot();
 var argv = process.argv;