harnessed 4.3.0 → 4.4.0

package/README.md

@@ -234,7 +234,7 @@ harnessed/
 │   ├── verify/                 # Stage ④ (progress + code-review + paranoid + qa + cso + design + simplify + multispec)
 │   ├── research/               # standalone Stage ① alternate
 │   ├── retro/                  # standalone post-④ milestone close
-│   ├── capabilities.yaml       # L5a: ~70 entries, 7 categories SoT
+│   ├── capabilities.yaml       # L5a: ~100 entries, 7 categories SoT
 │   ├── defaults.yaml           # ralph_max_iterations per workflow phase
 │   ├── judgments/              # L5a: three-layer-stack criteria + parallelism + tdd + fallback + rules-routing
 │   │   ├── strategic-gate.yaml
@@ -296,7 +296,7 @@ harnessed/
 └────────────────────────────────────────────────────────────┘
 ```
 
-### 3. Cross-cutting Capabilities (capabilities.yaml — 7 categories, ~83 entries)
+### 3. Cross-cutting Capabilities (capabilities.yaml — 7 categories, ~100 entries)
 
 ```
 behavioral (6):       karpathy-guidelines + output-style + language + operational + priority + protocols

package/dist/cli.mjs

@@ -1037,7 +1037,7 @@ function nameToYamlHintPath(name) {
 function shouldOverwriteFile(content) {
   return HARNESSED_MARKER_RX.test(content) || V3_4_3_SIGNATURE_SUB_RX.test(content) || V3_4_3_SIGNATURE_MASTER_RX.test(content);
 }
-async function writeAllCommands(slashNames, commandsDir, rolePrompts, capabilities, installedPlugins, installedUserSkills, writer, fileExists2 = existsSync, readFileSync9 = (p5) => readFileSync(p5, "utf8")) {
+async function writeAllCommands(slashNames, commandsDir, rolePrompts, capabilities, installedPlugins, installedUserSkills, writer, fileExists2 = existsSync, readFileSync10 = (p5) => readFileSync(p5, "utf8")) {
   const results = [];
   const aggregatedWarnings = /* @__PURE__ */ new Set();
   for (const name of slashNames) {
@@ -1056,7 +1056,7 @@ async function writeAllCommands(slashNames, commandsDir, rolePrompts, capabiliti
     if (fileExists2(path)) {
       let existing = "";
       try {
-        existing = readFileSync9(path);
+        existing = readFileSync10(path);
       } catch {
         existing = "";
       }
@@ -1208,7 +1208,8 @@ var init_disciplineLoader = __esm({
       "language",
       "operational",
       "priority",
-      "protocols"
+      "protocols",
+      "doc-discipline"
     ];
     _cache = /* @__PURE__ */ new Map();
   }
@@ -1256,6 +1257,27 @@ async function runBeforeCommitHook(ctx) {
     console.error("\u274C no-skip-hooks violated: --no-verify forbidden");
     process.exit(2);
   }
+  if (ctx.changedFiles.some((f) => f.includes(".planning/STATE.md"))) {
+    const docD = await loadDiscipline("doc-discipline", ctx.packageRoot);
+    const rule = docD.rules.find((r) => r.id === "state-digest-line-limit");
+    if (rule?.enforcement === "halt") {
+      if (process.env.HARNESSED_ALLOW_LONG_STATE) {
+        console.warn(
+          "\u26A0\uFE0F doc-discipline: state-digest-line-limit override active (HARNESSED_ALLOW_LONG_STATE)"
+        );
+      } else {
+        const content = readFileSync(resolve(ctx.packageRoot, ".planning/STATE.md"), "utf8");
+        const lines = content.split(/\r?\n/);
+        const lineCount = lines[lines.length - 1] === "" ? lines.length - 1 : lines.length;
+        if (lineCount > 100) {
+          console.error(
+            `\u274C doc-discipline: STATE.md exceeds 100-line digest limit (current: ${lineCount} lines). Set HARNESSED_ALLOW_LONG_STATE=1 to override.`
+          );
+          process.exit(2);
+        }
+      }
+    }
+  }
 }
 var TS_JS_RE;
 var init_before_commit = __esm({
@@ -2541,6 +2563,7 @@ var init_run2 = __esm({
 var evidence_exports = {};
 __export(evidence_exports, {
   checkArtifacts: () => checkArtifacts,
+  checkPlanningSync: () => checkPlanningSync,
   detectDrift: () => detectDrift,
   hashFile: () => hashFile
 });
@@ -2577,6 +2600,15 @@ async function checkArtifacts(sub, packageRoot) {
   }
   return { status: missing.length === 0 ? "verified" : "missing", found, missing };
 }
+async function checkPlanningSync(cwd, _workflowState) {
+  const planningDir = resolve(cwd, ".planning");
+  const hasPlanningDir = await stat(planningDir).then((s) => s.isDirectory()).catch(() => false);
+  if (!hasPlanningDir) return { status: "none_declared", missing: [] };
+  const stateFile = resolve(cwd, ".planning", "STATE.md");
+  const hasStateFile = await stat(stateFile).then((s) => s.isFile()).catch(() => false);
+  if (!hasStateFile) return { status: "missing", missing: [".planning/STATE.md"] };
+  return { status: "verified", missing: [] };
+}
 async function detectDrift(evidence) {
   const drift = [];
   for (const ref of evidence) {
@@ -3406,7 +3438,7 @@ var init_auto_install = __esm({
 
 // package.json
 var package_default = {
-  version: "4.3.0"};
+  version: "4.4.0"};
 
 // src/manifest/errors.ts
 function instancePathToKeyPath(instancePath) {
@@ -4257,7 +4289,7 @@ function renderHumanTable(records) {
   }
 }
 function pipeToJq(filterExpr, lines) {
-  return new Promise((resolve17, reject) => {
+  return new Promise((resolve18, reject) => {
     const child = spawn("jq", [filterExpr], {
       stdio: ["pipe", "inherit", "inherit"],
       windowsHide: true
@@ -4266,12 +4298,12 @@ function pipeToJq(filterExpr, lines) {
       const e = err2;
       if (e.code === "ENOENT") {
         console.error(t("audit_log.jq_missing"));
-        resolve17(1);
+        resolve18(1);
       } else {
         reject(err2);
       }
     });
-    child.on("close", (code) => resolve17(code ?? 0));
+    child.on("close", (code) => resolve18(code ?? 0));
     child.stdin.write(lines.join("\n"));
     child.stdin.end();
   });
@@ -4549,11 +4581,14 @@ function registerCheckpoint(program2) {
         const { mutateSubProgress: mutateSubProgress3 } = await Promise.resolve().then(() => (init_state(), state_exports));
         const { getPackageRoot: getPackageRoot2 } = await Promise.resolve().then(() => (init_packagePath(), packagePath_exports));
         const result = await checkArtifacts2(sub, getPackageRoot2());
-        if (result.missing.length > 0 && !opts.force) {
+        const { checkPlanningSync: checkPlanningSync2 } = await Promise.resolve().then(() => (init_evidence(), evidence_exports));
+        const syncResult = await checkPlanningSync2(process.cwd(), null);
+        const allMissing = [...result.missing, ...syncResult.missing];
+        if (allMissing.length > 0 && !opts.force) {
           console.error(
-            `[harnessed] checkpoint complete BLOCKED: ${sub} \u2014 ${result.missing.length} declared artifact(s) missing (evidence guard, fail-closed):`
+            `[harnessed] checkpoint complete BLOCKED: ${sub} \u2014 ${allMissing.length} item(s) missing (evidence guard + .planning/ sync, fail-closed):`
           );
-          for (const m of result.missing) console.error(`  - ${m}`);
+          for (const m of allMissing) console.error(`  - ${m}`);
           console.error(
             "  (re-run with --force to override and record evidence_status=overridden)"
           );
@@ -4561,7 +4596,7 @@ function registerCheckpoint(program2) {
           return;
         }
         let evidenceStatus;
-        if (result.missing.length > 0 && opts.force) evidenceStatus = "overridden";
+        if (allMissing.length > 0 && opts.force) evidenceStatus = "overridden";
         else if (result.status === "verified") evidenceStatus = "verified";
         else evidenceStatus = "none_declared";
         const markOpts = evidenceStatus === "none_declared" ? { evidence_status: evidenceStatus } : { evidence: result.found, evidence_status: evidenceStatus };
@@ -5172,10 +5207,10 @@ async function spawnCmd(ctx, cmd, args, timeoutMs) {
   child.stderr?.setEncoding("utf8").on("data", (chunk) => {
     stderr += chunk;
   });
-  return await new Promise((resolve17) => {
+  return await new Promise((resolve18) => {
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve17({
+      resolve18({
         ok: false,
         phase: "spawn",
         error: {
@@ -5190,7 +5225,7 @@ async function spawnCmd(ctx, cmd, args, timeoutMs) {
     }, effectiveTimeoutMs);
     child.on("error", (err2) => {
       clearTimeout(timer);
-      resolve17({
+      resolve18({
         ok: false,
         phase: "spawn",
         error: {
@@ -5205,7 +5240,7 @@ async function spawnCmd(ctx, cmd, args, timeoutMs) {
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve17({ ok: true, exitCode: code ?? -1, stdout: stdout2, stderr });
+      resolve18({ ok: true, exitCode: code ?? -1, stdout: stdout2, stderr });
     });
   });
 }
@@ -5318,7 +5353,7 @@ async function isAlreadyInstalled(ctx, opts = {}) {
 // src/installers/ccPluginMarketplace.ts
 init_readClaudeConfig();
 function runArgs(claudeArgs, cwd, timeoutMs = 15e3) {
-  return new Promise((resolve17) => {
+  return new Promise((resolve18) => {
     const isWin = process.platform === "win32";
     const child = isWin ? spawn("cmd.exe", ["/c", "claude", ...claudeArgs], { cwd, windowsHide: true }) : spawn("claude", claudeArgs, { cwd, shell: false });
     let stderr = "";
@@ -5327,15 +5362,15 @@ function runArgs(claudeArgs, cwd, timeoutMs = 15e3) {
     });
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve17({ exitCode: -1, stderr: `${stderr}[timeout after ${timeoutMs}ms]` });
+      resolve18({ exitCode: -1, stderr: `${stderr}[timeout after ${timeoutMs}ms]` });
     }, timeoutMs);
     child.on("error", (e) => {
       clearTimeout(timer);
-      resolve17({ exitCode: -1, stderr: `${stderr}${e.message}` });
+      resolve18({ exitCode: -1, stderr: `${stderr}${e.message}` });
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve17({ exitCode: code ?? -1, stderr });
+      resolve18({ exitCode: code ?? -1, stderr });
     });
   });
 }
@@ -5481,7 +5516,7 @@ ${newEntry}
   return { ok: true, backupId: bk.backupId, appliedFiles: [settingsFile] };
 };
 function gitRevParseHead(cwd, timeoutMs = 1e4) {
-  return new Promise((resolve17) => {
+  return new Promise((resolve18) => {
     const isWin = process.platform === "win32";
     const child = isWin ? spawn("cmd.exe", ["/c", "git", "rev-parse", "HEAD"], { cwd, windowsHide: true }) : spawn("git", ["rev-parse", "HEAD"], { cwd, shell: false });
     let stdout2 = "";
@@ -5490,15 +5525,15 @@ function gitRevParseHead(cwd, timeoutMs = 1e4) {
     });
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve17({ sha: "", exit: -1 });
+      resolve18({ sha: "", exit: -1 });
     }, timeoutMs);
     child.on("error", () => {
       clearTimeout(timer);
-      resolve17({ sha: "", exit: -1 });
+      resolve18({ sha: "", exit: -1 });
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve17({ sha: stdout2.trim(), exit: code ?? -1 });
+      resolve18({ sha: stdout2.trim(), exit: code ?? -1 });
     });
   });
 }
@@ -7666,7 +7701,7 @@ var uninstallNpmCli = async (ctx) => {
   const m = install.cmd.match(/npm\s+(?:install|i)\s+(?:-g\s+)?(\S+)/);
   const pkg = m?.[1] ?? ctx.manifest.metadata.upstream.source;
   const isWin = process.platform === "win32";
-  const result = await new Promise((resolve17) => {
+  const result = await new Promise((resolve18) => {
     const child = isWin ? spawn("cmd.exe", ["/c", "npm", "uninstall", "-g", pkg], { windowsHide: true }) : spawn("npm", ["uninstall", "-g", pkg], { shell: false });
     let stderr = "";
     child.stderr?.setEncoding("utf8").on("data", (c) => {
@@ -7674,15 +7709,15 @@ var uninstallNpmCli = async (ctx) => {
     });
     const timer = setTimeout(() => {
       child.kill("SIGKILL");
-      resolve17({ exitCode: -1, stderr: `${stderr}[timeout]` });
+      resolve18({ exitCode: -1, stderr: `${stderr}[timeout]` });
     }, 3e4);
     child.on("error", (e) => {
       clearTimeout(timer);
-      resolve17({ exitCode: -1, stderr: e.message });
+      resolve18({ exitCode: -1, stderr: e.message });
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      resolve17({ exitCode: code ?? -1, stderr });
+      resolve18({ exitCode: code ?? -1, stderr });
     });
   });
   if (result.exitCode !== 0) {