codeharness 0.16.1 → 0.17.1

package/dist/index.js

@@ -464,6 +464,10 @@ var WEB_OTLP_PACKAGES = [
 var AGENT_OTLP_PACKAGES_NODE = ["@traceloop/node-server-sdk"];
 var AGENT_OTLP_PACKAGES_PYTHON = ["traceloop-sdk"];
 var NODE_REQUIRE_FLAG = "--require @opentelemetry/auto-instrumentations-node/register";
+function truncateError(message, maxLength = 200) {
+  if (message.length <= maxLength) return message;
+  return message.slice(0, maxLength) + "... (truncated)";
+}
 function installNodeOtlp(projectDir) {
   try {
     execFileSync2("npm", ["install", ...NODE_OTLP_PACKAGES], { cwd: projectDir, stdio: "pipe", timeout: 3e5 });
@@ -480,7 +484,7 @@ function installNodeOtlp(projectDir) {
       packages_installed: false,
       start_script_patched: false,
       env_vars_configured: false,
-      error: `Failed to install Node.js OTLP packages: ${message}`
+      error: `Failed to install Node.js OTLP packages: ${truncateError(message)}`
     };
   }
 }
@@ -489,8 +493,14 @@ function patchNodeStartScript(projectDir) {
   if (!existsSync3(pkgPath)) {
     return false;
   }
-  const raw = readFileSync3(pkgPath, "utf-8");
-  const pkg = JSON.parse(raw);
+  let raw;
+  let pkg;
+  try {
+    raw = readFileSync3(pkgPath, "utf-8");
+    pkg = JSON.parse(raw);
+  } catch {
+    return false;
+  }
   const scripts = pkg["scripts"];
   if (!scripts) {
     return false;
@@ -554,6 +564,14 @@ function configureWeb(projectDir, stack) {
     } catch {
     }
   }
+  let endpoint = "http://localhost:4318";
+  try {
+    const currentState = readState(projectDir);
+    if (currentState.otlp?.endpoint) {
+      endpoint = currentState.otlp.endpoint;
+    }
+  } catch {
+  }
   const snippet = `// OpenTelemetry Web SDK initialization \u2014 generated by codeharness
 import { WebTracerProvider } from '@opentelemetry/sdk-trace-web';
 import { BatchSpanProcessor } from '@opentelemetry/sdk-trace-base';
@@ -563,7 +581,7 @@ import { XMLHttpRequestInstrumentation } from '@opentelemetry/instrumentation-xm
 import { registerInstrumentations } from '@opentelemetry/instrumentation';
 
 const exporter = new OTLPTraceExporter({
-  url: 'http://localhost:4318/v1/traces',
+  url: '${endpoint}/v1/traces',
 });
 
 const provider = new WebTracerProvider();
@@ -675,12 +693,12 @@ function instrumentProject(projectDir, stack, opts) {
       error: "Unsupported stack for OTLP instrumentation"
     };
   }
+  configureOtlpEnvVars(projectDir, stack, { appType });
+  result.env_vars_configured = true;
+  if (!isJson) {
+    ok("OTLP: environment variables configured");
+  }
   if (result.status === "configured") {
-    configureOtlpEnvVars(projectDir, stack, { appType });
-    result.env_vars_configured = true;
-    if (!isJson) {
-      ok("OTLP: environment variables configured");
-    }
     if (appType === "cli") {
       configureCli(projectDir);
       if (!isJson) {
@@ -874,6 +892,11 @@ ${patchContent}
 ${markers.end}`;
   const startIdx = content.indexOf(markers.start);
   const endIdx = content.indexOf(markers.end);
+  if (startIdx !== -1 !== (endIdx !== -1)) {
+    throw new Error(
+      `Corrupted patch markers for '${patchName}': only ${startIdx !== -1 ? "start" : "end"} marker found in ${filePath}`
+    );
+  }
   if (startIdx !== -1 && endIdx !== -1) {
     if (endIdx < startIdx) {
       throw new Error(
@@ -1060,8 +1083,8 @@ var BmadError = class extends Error {
 };
 var PATCH_TARGETS = {
   "story-verification": "bmm/workflows/4-implementation/create-story/template.md",
-  "dev-enforcement": "bmm/workflows/4-implementation/dev-story/checklist.md",
-  "review-enforcement": "bmm/workflows/4-implementation/code-review/checklist.md",
+  "dev-enforcement": "bmm/workflows/4-implementation/dev-story/instructions.xml",
+  "review-enforcement": "bmm/workflows/4-implementation/code-review/instructions.xml",
   "retro-enforcement": "bmm/workflows/4-implementation/retrospective/instructions.md",
   "sprint-beads": "bmm/workflows/4-implementation/sprint-planning/checklist.md",
   "sprint-retro": "bmm/workflows/4-implementation/sprint-planning/instructions.md"
@@ -1110,9 +1133,9 @@ function installBmad(dir) {
       patches_applied: []
     };
   }
-  const cmdStr = "npx bmad-method init";
+  const cmdStr = "npx bmad-method install";
   try {
-    execFileSync4("npx", ["bmad-method", "init"], {
+    execFileSync4("npx", ["bmad-method", "install"], {
       stdio: "pipe",
       timeout: 6e4,
       cwd: root
@@ -1121,6 +1144,9 @@ function installBmad(dir) {
     const message = err instanceof Error ? err.message : String(err);
     throw new BmadError(cmdStr, message);
   }
+  if (!isBmadInstalled(root)) {
+    throw new BmadError(cmdStr, "_bmad/ directory was not created after successful npx bmad-method install");
+  }
   const version = detectBmadVersion(root);
   return {
     status: "installed",
@@ -1177,6 +1203,21 @@ function applyAllPatches(dir) {
   }
   return results;
 }
+function detectBmalph(dir) {
+  const root = dir ?? process.cwd();
+  const files = [];
+  const ralphRcPath = join5(root, ".ralph", ".ralphrc");
+  if (existsSync5(ralphRcPath)) {
+    files.push(".ralph/.ralphrc");
+  }
+  const dotRalphDir = join5(root, ".ralph");
+  if (existsSync5(dotRalphDir)) {
+    if (files.length === 0) {
+      files.push(".ralph/");
+    }
+  }
+  return { detected: files.length > 0, files };
+}
 function generateStoryKey(epicNumber, storyNumber, title) {
   const slug = title.toLowerCase().replace(/[^a-z0-9\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
   return `${epicNumber}-${storyNumber}-${slug}`;
@@ -1402,7 +1443,7 @@ function getInstallCommand(stack) {
 }
 
 // src/commands/init.ts
-var HARNESS_VERSION = true ? "0.16.1" : "0.0.0-dev";
+var HARNESS_VERSION = true ? "0.17.1" : "0.0.0-dev";
 function getProjectName(projectDir) {
   try {
     const pkgPath = join6(projectDir, "package.json");
@@ -1498,7 +1539,7 @@ function generateDocsIndexContent() {
 }
 var DO_NOT_EDIT_HEADER = "<!-- DO NOT EDIT MANUALLY -->\n";
 function registerInitCommand(program) {
-  program.command("init").description("Initialize the harness in a project").option("--no-frontend", "Disable frontend enforcement").option("--no-database", "Disable database enforcement").option("--no-api", "Disable API enforcement").option("--otel-endpoint <url>", "Remote OTLP endpoint (skips local Docker stack)").option("--logs-url <url>", "Remote VictoriaLogs URL").option("--metrics-url <url>", "Remote VictoriaMetrics URL").option("--traces-url <url>", "Remote Jaeger/VictoriaTraces URL").action(async (options, cmd) => {
+  program.command("init").description("Initialize the harness in a project").option("--no-frontend", "Disable frontend enforcement").option("--no-database", "Disable database enforcement").option("--no-api", "Disable API enforcement").option("--no-observability", "Skip OTLP package installation").option("--otel-endpoint <url>", "Remote OTLP endpoint (skips local Docker stack)").option("--logs-url <url>", "Remote VictoriaLogs URL").option("--metrics-url <url>", "Remote VictoriaMetrics URL").option("--traces-url <url>", "Remote Jaeger/VictoriaTraces URL").action(async (options, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const isJson = globalOpts.json === true;
     const projectDir = process.cwd();
@@ -1527,6 +1568,47 @@ function registerInitCommand(program) {
           result.documentation.agents_md = "exists";
           result.documentation.docs_scaffold = "exists";
           result.documentation.readme = "exists";
+          const depResults = [];
+          for (const spec of DEPENDENCY_REGISTRY) {
+            const check = checkInstalled(spec);
+            const depResult = {
+              name: spec.name,
+              displayName: spec.displayName,
+              status: check.installed ? "already-installed" : "failed",
+              version: check.version
+            };
+            depResults.push(depResult);
+            if (!isJson) {
+              if (check.installed) {
+                const versionStr = check.version ? ` (v${check.version})` : "";
+                ok(`${spec.displayName}: already installed${versionStr}`);
+              } else {
+                fail(`${spec.displayName}: not found`);
+              }
+            }
+          }
+          result.dependencies = depResults;
+          if (isBmadInstalled(projectDir)) {
+            try {
+              const patchResults = applyAllPatches(projectDir);
+              const patchNames = patchResults.filter((r) => r.applied).map((r) => r.patchName);
+              const version = detectBmadVersion(projectDir);
+              const bmalpHDetection = detectBmalph(projectDir);
+              result.bmad = {
+                status: "already-installed",
+                version,
+                patches_applied: patchNames,
+                bmalph_detected: bmalpHDetection.detected
+              };
+              if (!isJson) {
+                info("BMAD: already installed, patches verified");
+                if (bmalpHDetection.detected) {
+                  warn("bmalph detected \u2014 superseded files noted for cleanup");
+                }
+              }
+            } catch {
+            }
+          }
           if (isJson) {
             jsonOutput(result);
           } else {
@@ -1661,10 +1743,11 @@ function registerInitCommand(program) {
         result.bmad = {
           status: "already-installed",
           version,
-          patches_applied: patchNames
+          patches_applied: patchNames,
+          bmalph_detected: false
         };
         if (!isJson) {
-          info("BMAD: existing installation detected, patches applied");
+          info("BMAD: already installed, patches verified");
         }
       } else {
         const installResult = installBmad(projectDir);
@@ -1673,18 +1756,27 @@ function registerInitCommand(program) {
         result.bmad = {
           status: installResult.status,
           version: installResult.version,
-          patches_applied: patchNames
+          patches_applied: patchNames,
+          bmalph_detected: false
         };
         if (!isJson) {
           ok(`BMAD: installed (v${installResult.version ?? "unknown"}), harness patches applied`);
         }
       }
+      const bmalpHDetection = detectBmalph(projectDir);
+      if (bmalpHDetection.detected && result.bmad) {
+        result.bmad.bmalph_detected = true;
+        if (!isJson) {
+          warn("bmalph detected \u2014 superseded files noted for cleanup");
+        }
+      }
     } catch (err) {
       if (err instanceof BmadError) {
         result.bmad = {
           status: "failed",
           version: null,
           patches_applied: [],
+          bmalph_detected: false,
           error: err.message
         };
         if (!isJson) {
@@ -1757,7 +1849,20 @@ function registerInitCommand(program) {
         ok("Documentation: README.md created");
       }
     }
-    const otlpResult = instrumentProject(projectDir, stack, { json: isJson, appType });
+    let otlpResult;
+    if (!options.observability) {
+      otlpResult = {
+        status: "skipped",
+        packages_installed: false,
+        start_script_patched: false,
+        env_vars_configured: false
+      };
+      if (!isJson) {
+        info("OTLP: skipped (--no-observability)");
+      }
+    } else {
+      otlpResult = instrumentProject(projectDir, stack, { json: isJson, appType });
+    }
     result.otlp = otlpResult;
     try {
       const updatedState = readState(projectDir);
@@ -2680,14 +2785,8 @@ var DB_KEYWORDS = [
   "table"
 ];
 var INTEGRATION_KEYWORDS = [
-  "sprint planning",
-  "workflow",
-  "run /command",
-  "user session",
-  "multi-step",
   "external system",
   "real infrastructure",
-  "integration test",
   "manual verification"
 ];
 var ESCALATE_KEYWORDS = [
@@ -3398,6 +3497,10 @@ function checkBlackBoxEnforcement(proofContent) {
     acsMissingDockerExec
   };
 }
+function hasFailVerdict(section) {
+  const withoutCodeBlocks = section.replace(/```[\s\S]*?```/g, "");
+  return withoutCodeBlocks.includes("[FAIL]");
+}
 function checkPreconditions(dir, storyId) {
   const state = readState(dir);
   const failures = [];
@@ -3510,6 +3613,10 @@ function validateProofQuality(proofPath) {
         escalated++;
         continue;
       }
+      if (hasFailVerdict(section)) {
+        pending++;
+        continue;
+      }
       const hasEvidence = section.includes("<!-- /showboat exec -->") || section.includes("<!-- showboat image:") || /```(?:bash|shell)\n[\s\S]*?```\n+```output\n/m.test(section);
       if (hasEvidence) {
         verified++;
@@ -3545,6 +3652,8 @@ function validateProofQuality(proofPath) {
           const bulletText = bulletMatch[1].toLowerCase();
           if (bulletText.includes("n/a") || bulletText.includes("escalat") || bulletText.includes("superseded")) {
             bEscalated++;
+          } else if (bulletText.includes("fail")) {
+            bPending++;
           } else {
             bVerified++;
           }
@@ -3570,6 +3679,8 @@ function validateProofQuality(proofPath) {
         const section = content.slice(regionStart, regionEnd);
         if (section.includes("[ESCALATE]")) {
           escalated++;
+        } else if (hasFailVerdict(section)) {
+          pending++;
         } else if (/```output/m.test(section)) {
           verified++;
         } else {
@@ -3597,6 +3708,8 @@ function validateProofQuality(proofPath) {
       const section = content.slice(acIdx, nextMatch ? nextMatch.index : content.length);
       if (section.includes("[ESCALATE]")) {
         escalated++;
+      } else if (hasFailVerdict(section)) {
+        pending++;
       } else if (/```output\n/m.test(section)) {
         verified++;
       } else {
@@ -7675,7 +7788,7 @@ function handleStatus(dir, isJson, filterStory) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.16.1" : "0.0.0-dev";
+var VERSION = true ? "0.17.1" : "0.0.0-dev";
 function createProgram() {
   const program = new Command();
   program.name("codeharness").description("Makes autonomous coding agents produce software that actually works").version(VERSION).option("--json", "Output in machine-readable JSON format");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeharness",
-  "version": "0.16.1",
+  "version": "0.17.1",
   "type": "module",
   "description": "CLI for codeharness — makes autonomous coding agents produce software that actually works",
   "bin": {

package/ralph/drivers/claude-code.sh

@@ -48,6 +48,9 @@ driver_valid_tools() {
         "Bash(showboat *)"
         "Bash(codeharness *)"
         "NotebookEdit"
+        "Skill"
+        "Agent"
+        "ToolSearch"
     )
 }