@osfactory/har 0.61.1 → 0.61.3

package/dist/index.js

@@ -28779,12 +28779,10 @@ function run(command2, options = {}) {
     };
   }
 }
-function runScript(scriptPath, args = [], options = {}) {
-  return runScriptCapture(scriptPath, args, { ...options, stream: true });
-}
 function runScriptCapture(scriptPath, args = [], options = {}) {
   const stream = options.stream ?? false;
-  const { stream: _stream, ...spawnOptions } = options;
+  const echoStdout = stream && (options.streamStdout ?? true);
+  const { stream: _stream, streamStdout: _streamStdout, ...spawnOptions } = options;
   return new Promise((resolve51) => {
     const proc = (0, import_child_process.spawn)("bash", [scriptPath, ...args], {
       ...spawnOptions,
@@ -28794,7 +28792,7 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
     let stderr = "";
     proc.stdout?.on("data", (d) => {
       stdout += d;
-      if (stream) process.stdout.write(d);
+      if (echoStdout) process.stdout.write(d);
     });
     proc.stderr?.on("data", (d) => {
       stderr += d;
@@ -28805,7 +28803,8 @@ function runScriptCapture(scriptPath, args = [], options = {}) {
 }
 function runShellCommand(command2, options = {}) {
   const stream = options.stream ?? false;
-  const { stream: _stream, ...spawnOptions } = options;
+  const echoStdout = stream && (options.streamStdout ?? true);
+  const { stream: _stream, streamStdout: _streamStdout, ...spawnOptions } = options;
   return new Promise((resolve51) => {
     const proc = (0, import_child_process.spawn)("bash", ["-lc", command2], {
       ...spawnOptions,
@@ -28815,7 +28814,7 @@ function runShellCommand(command2, options = {}) {
     let stderr = "";
     proc.stdout?.on("data", (d) => {
       stdout += d;
-      if (stream) process.stdout.write(d);
+      if (echoStdout) process.stdout.write(d);
     });
     proc.stderr?.on("data", (d) => {
       stderr += d;
@@ -29090,6 +29089,18 @@ function parseVerificationResult(stdout) {
   const parsed = VerificationResultSchema.safeParse(json);
   return parsed.success ? parsed.data : null;
 }
+function slimVerificationResult(verification) {
+  if (!verification) return null;
+  return {
+    ...verification,
+    stages: verification.stages.map((stage) => {
+      if (!stage.pass || stage.output === void 0) return stage;
+      const rest = { ...stage };
+      delete rest.output;
+      return rest;
+    })
+  };
+}
 function buildStageResult(input) {
   const verification = input.verification ?? parseVerificationResult(input.stdout) ?? void 0;
   const parsedStageResult = StageResultSchema.safeParse(extractJsonFromOutput(input.stdout));
@@ -29287,16 +29298,18 @@ function buildExecutionPlan(repoPath, stage, options) {
     env: mergedEnv
   };
 }
-async function executePlan(plan, capture) {
-  const spawnOptions = { cwd: plan.cwd, env: plan.env };
+async function executePlan(plan, options) {
+  const spawnOptions = {
+    cwd: plan.cwd,
+    env: plan.env,
+    stream: !options.capture,
+    streamStdout: options.streamStdout
+  };
   if (plan.mode === "shell" && plan.shellCommand) {
-    return runShellCommand(plan.shellCommand, { ...spawnOptions, stream: !capture });
+    return runShellCommand(plan.shellCommand, spawnOptions);
   }
   if (plan.scriptPath) {
-    if (capture) {
-      return runScriptCapture(plan.scriptPath, plan.args, spawnOptions);
-    }
-    return runScript(plan.scriptPath, plan.args, spawnOptions);
+    return runScriptCapture(plan.scriptPath, plan.args, spawnOptions);
   }
   throw new Error("Invalid stage execution plan");
 }
@@ -29328,7 +29341,10 @@ var init_local_executor = __esm({
         const plan = buildExecutionPlan(repoPath, stage, options);
         const capture = options.capture ?? ctx.capture ?? true;
         const started = Date.now();
-        const result = await executePlan(plan, capture);
+        const result = await executePlan(plan, {
+          capture,
+          streamStdout: stage.kind !== "verify"
+        });
         const durationMs = Date.now() - started;
         const verification = stage.kind === "verify" ? parseVerificationResult(result.stdout) : void 0;
         const previewUrls = stage.kind === "launch" && result.code === 0 && options.agentId !== void 0 ? computePreviewUrls(repoPath, options.agentId) : void 0;
@@ -73264,6 +73280,7 @@ function writeOnboardingPreferences(overrides) {
 // src/cli/commands/env.ts
 init_schema2();
 init_validation();
+init_results();
 init_logging();
 
 // src/cli/help-text.ts
@@ -73511,7 +73528,11 @@ var envCommand = {
   ).command(
     "verify <id>",
     "Run verification suite for an agent",
-    (y) => y.positional("id", { type: "number", describe: "Agent slot id (see .har/stages.json agentSlots)" }).option("repo", { type: "string", default: "." }).option("full", { type: "boolean", default: false }),
+    (y) => y.positional("id", { type: "number", describe: "Agent slot id (see .har/stages.json agentSlots)" }).option("repo", { type: "string", default: "." }).option("full", { type: "boolean", default: false }).option("json", {
+      type: "boolean",
+      default: false,
+      describe: "Structured JSON (passing steps omit output; default is progress only)"
+    }),
     handleVerify
   ).command(
     "teardown <id>",
@@ -73976,9 +73997,26 @@ async function handleVerify(argv) {
     repoPath: repo,
     agentId,
     full: argv.full,
-    capture: false
+    capture: Boolean(argv.json)
   });
-  if (result.stdout) process.stdout.write(result.stdout);
+  if (argv.json) {
+    const payload = slimVerificationResult(result.verification) ?? {
+      status: result.code === 0 ? "pass" : "fail",
+      agent_id: agentId,
+      stages: []
+    };
+    process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
+    return finishCommand(result.code);
+  }
+  if (result.verification) {
+    const failed = result.verification.stages.filter((stage) => !stage.pass).map((stage) => stage.name);
+    const elapsed = result.verification.total_ms != null ? ` (${result.verification.total_ms}ms)` : "";
+    if (failed.length > 0) {
+      error(`Verification failed: ${failed.join(", ")}${elapsed}`);
+    } else {
+      success(`Verification ${result.verification.status}${elapsed}`);
+    }
+  }
   return finishCommand(result.code);
 }
 async function handleTeardown(argv) {
@@ -82495,6 +82533,7 @@ function objectJsonSchema(properties, required2) {
 }
 
 // src/mcp/server.ts
+init_results();
 init_validation();
 
 // src/mcp/schemas.ts
@@ -82780,7 +82819,7 @@ var HAR_MCP_TOOLS = [
   },
   {
     name: "har_run_verification",
-    description: "Run the project verification pipeline for an agent slot.",
+    description: "Run the project verification pipeline for an agent slot. Returns status, timing, and failed-step output (passing steps omit logs; stdout is not the raw JSON dump).",
     inputSchema: objectJsonSchema(
       {
         repo: repoJsonProperty,
@@ -83006,7 +83045,14 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
         capture: true,
         trigger: "mcp"
       });
-      return jsonContent(RunVerificationOutputSchema.parse(result));
+      return jsonContent(
+        RunVerificationOutputSchema.parse({
+          code: result.code,
+          stdout: "",
+          stderr: result.stderr,
+          verification: slimVerificationResult(result.verification)
+        })
+      );
     }
     case "har_get_status": {
       const agentIdRaw = args.agentId;
@@ -83052,7 +83098,12 @@ async function handleMcpToolCall(toolName, args, defaultRepo = ".") {
         capture: true,
         trigger: "mcp"
       });
-      return jsonContent(CompleteEnvironmentOutputSchema.parse(result));
+      return jsonContent(
+        CompleteEnvironmentOutputSchema.parse({
+          ...result,
+          verification: slimVerificationResult(result.verification)
+        })
+      );
     }
     case "har_list_artifacts": {
       const input = ListArtifactsInputSchema.parse({ ...args, repo });

package/dist/templates/har-boilerplate/agent-slot.sh

@@ -776,6 +776,29 @@ escape_step_output() {
   printf '%s' "$1" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const s=d.trim().split('\n').slice(0,50).join('\n');process.stdout.write(JSON.stringify(s))})" 2>/dev/null || echo '""'
 }
 
+# Append one verify.sh step to RESULTS_JSON (caller global).
+# Passing steps omit output — it already appeared as ✓ on stderr.
+record_step_result() {
+  local name="$1"
+  local pass_bool="$2"
+  local elapsed="$3"
+  local output="${4:-}"
+  local step_json
+  if [ "$pass_bool" = "true" ]; then
+    step_json=$(NAME="$name" MS="$elapsed" node -e 'process.stdout.write(JSON.stringify({name:process.env.NAME,pass:true,ms:Number(process.env.MS)}))' 2>/dev/null) || return 0
+  else
+    local escaped
+    escaped=$(escape_step_output "$output")
+    step_json=$(NAME="$name" MS="$elapsed" node -e "process.stdout.write(JSON.stringify({name:process.env.NAME,pass:false,ms:Number(process.env.MS),output:$escaped}))" 2>/dev/null) || return 0
+  fi
+  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
+const fs = require('fs');
+const arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
+arr.push($step_json);
+process.stdout.write(JSON.stringify(arr));
+" 2>/dev/null || echo "$RESULTS_JSON")
+}
+
 # Emit "<id>\t<command>" for each registered stage listed in stages.json
 # verificationStages (used by verify --full). Ids without a matching registered
 # stage are inline verify.sh steps and skipped here; lifecycle stages

package/dist/templates/har-boilerplate/ecosystem.agent.template.cjs

@@ -7,11 +7,17 @@
 
 // launch.sh writes this file (and .env.agent.N) to the work dir root,
 // so __dirname IS the work dir — repo root or the agent's git worktree.
+const fs = require('fs');
 const path = require('path');
-const dotenv = require('dotenv');
 
 const agentEnvPath = path.resolve(__dirname, '.env.agent.${AGENT_ID}');
-const env = dotenv.config({ path: agentEnvPath }).parsed || {};
+const env = {};
+try {
+  for (const line of fs.readFileSync(agentEnvPath, 'utf8').split('\n')) {
+    const m = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/);
+    if (m && !line.trimStart().startsWith('#')) env[m[1]] = m[2].replace(/^["']|["']$/g, '');
+  }
+} catch {}
 
 module.exports = {
   apps: [

package/dist/templates/har-boilerplate/verify.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 # Progressive verification pipeline for an agent environment.
-# Outputs JSON to stdout, human-readable progress to stderr.
+# Outputs JSON to stdout (machine contract), human-readable progress to stderr.
+# Passing steps omit `output`. `har env verify` streams progress only.
 #
 # Usage: ./.har/verify.sh <agent-id> [--full]
 #
@@ -73,7 +74,7 @@ run_step() {
   end=$(now_ms)
   elapsed=$(( end - start ))
 
-  local pass_bool step_output_escaped
+  local pass_bool
   if [ "$exit_code" = "0" ]; then
     echo "✓ (${elapsed}ms)" >&2
     pass_bool="true"
@@ -84,14 +85,7 @@ run_step() {
     OVERALL_PASS=false
   fi
 
-  step_output_escaped=$(escape_step_output "$output")
-
-  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
-const fs = require('fs');
-let arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
-arr.push({name:'$name',pass:$pass_bool,ms:$elapsed,output:$step_output_escaped});
-process.stdout.write(JSON.stringify(arr));
-" 2>/dev/null || echo "$RESULTS_JSON")
+  record_step_result "$name" "$pass_bool" "$elapsed" "$output"
 
   if [ "$pass_bool" = "false" ] && [ -z "$FULL" ]; then
     return 1
@@ -114,7 +108,7 @@ run_http_step() {
   end=$(now_ms)
   elapsed=$(( end - start ))
 
-  local pass_bool step_output_escaped
+  local pass_bool
   if [ "$exit_code" = "0" ]; then
     echo "✓ (${elapsed}ms)" >&2
     pass_bool="true"
@@ -124,14 +118,7 @@ run_http_step() {
     OVERALL_PASS=false
   fi
 
-  step_output_escaped=$(escape_step_output "$output")
-
-  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
-const fs = require('fs');
-let arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
-arr.push({name:'$name',pass:$pass_bool,ms:$elapsed,output:$step_output_escaped});
-process.stdout.write(JSON.stringify(arr));
-" 2>/dev/null || echo "$RESULTS_JSON")
+  record_step_result "$name" "$pass_bool" "$elapsed" "$output"
 
   if [ "$pass_bool" = "false" ] && [ -z "$FULL" ]; then
     return 1

package/dist/templates/har-boilerplate-cli/agent-slot.sh

@@ -758,6 +758,29 @@ escape_step_output() {
   printf '%s' "$1" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const s=d.trim().split('\n').slice(0,50).join('\n');process.stdout.write(JSON.stringify(s))})" 2>/dev/null || echo '""'
 }
 
+# Append one verify.sh step to RESULTS_JSON (caller global).
+# Passing steps omit output — it already appeared as ✓ on stderr.
+record_step_result() {
+  local name="$1"
+  local pass_bool="$2"
+  local elapsed="$3"
+  local output="${4:-}"
+  local step_json
+  if [ "$pass_bool" = "true" ]; then
+    step_json=$(NAME="$name" MS="$elapsed" node -e 'process.stdout.write(JSON.stringify({name:process.env.NAME,pass:true,ms:Number(process.env.MS)}))' 2>/dev/null) || return 0
+  else
+    local escaped
+    escaped=$(escape_step_output "$output")
+    step_json=$(NAME="$name" MS="$elapsed" node -e "process.stdout.write(JSON.stringify({name:process.env.NAME,pass:false,ms:Number(process.env.MS),output:$escaped}))" 2>/dev/null) || return 0
+  fi
+  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
+const fs = require('fs');
+const arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
+arr.push($step_json);
+process.stdout.write(JSON.stringify(arr));
+" 2>/dev/null || echo "$RESULTS_JSON")
+}
+
 # Emit "<id>\t<command>" for each registered stage listed in stages.json
 # verificationStages (used by verify --full). Ids without a matching registered
 # stage are inline verify.sh steps and skipped here; lifecycle stages

package/dist/templates/har-boilerplate-cli/verify.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 # Verification pipeline for CLI/library repos.
-# Outputs JSON to stdout, human-readable progress to stderr.
+# Outputs JSON to stdout (machine contract), human-readable progress to stderr.
+# Passing steps omit `output`. `har env verify` streams progress only.
 #
 # Usage: ./.har/verify.sh <agent-id> [--full]
 #
@@ -70,7 +71,7 @@ run_step() {
   end=$(now_ms)
   elapsed=$(( end - start ))
 
-  local pass_bool step_output_escaped
+  local pass_bool
   if [ "$exit_code" = "0" ]; then
     echo "✓ (${elapsed}ms)" >&2
     pass_bool="true"
@@ -81,14 +82,7 @@ run_step() {
     OVERALL_PASS=false
   fi
 
-  step_output_escaped=$(escape_step_output "$output")
-
-  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
-const fs = require('fs');
-let arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
-arr.push({name:'$name',pass:$pass_bool,ms:$elapsed,output:$step_output_escaped});
-process.stdout.write(JSON.stringify(arr));
-" 2>/dev/null || echo "$RESULTS_JSON")
+  record_step_result "$name" "$pass_bool" "$elapsed" "$output"
 
   if [ "$pass_bool" = "false" ] && [ -z "$FULL" ]; then
     return 1

package/dist/templates/har-boilerplate-ios/agent-slot.sh

@@ -405,6 +405,29 @@ escape_step_output() {
   printf '%s' "$1" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>{const s=d.trim().split('\n').slice(0,50).join('\n');process.stdout.write(JSON.stringify(s))})" 2>/dev/null || echo '""'
 }
 
+# Append one verify.sh step to RESULTS_JSON (caller global).
+# Passing steps omit output — it already appeared as ✓ on stderr.
+record_step_result() {
+  local name="$1"
+  local pass_bool="$2"
+  local elapsed="$3"
+  local output="${4:-}"
+  local step_json
+  if [ "$pass_bool" = "true" ]; then
+    step_json=$(NAME="$name" MS="$elapsed" node -e 'process.stdout.write(JSON.stringify({name:process.env.NAME,pass:true,ms:Number(process.env.MS)}))' 2>/dev/null) || return 0
+  else
+    local escaped
+    escaped=$(escape_step_output "$output")
+    step_json=$(NAME="$name" MS="$elapsed" node -e "process.stdout.write(JSON.stringify({name:process.env.NAME,pass:false,ms:Number(process.env.MS),output:$escaped}))" 2>/dev/null) || return 0
+  fi
+  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
+const fs = require('fs');
+const arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
+arr.push($step_json);
+process.stdout.write(JSON.stringify(arr));
+" 2>/dev/null || echo "$RESULTS_JSON")
+}
+
 # Emit "<id>\t<command>" for each registered stage listed in stages.json
 # verificationStages (used by verify --full). Ids without a matching registered
 # stage are inline verify.sh steps and skipped here; lifecycle stages

package/dist/templates/har-boilerplate-ios/verify.sh

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 # Verification pipeline for iOS mobile app repos — build and test with xcodebuild.
-# Outputs JSON to stdout, human-readable progress to stderr.
+# Outputs JSON to stdout (machine contract), human-readable progress to stderr.
+# Passing steps omit `output`. `har env verify` streams progress only.
 #
 # Usage: ./.har/verify.sh <agent-id> [--full]
 #
@@ -92,7 +93,7 @@ run_step() {
   end=$(now_ms)
   elapsed=$(( end - start ))
 
-  local pass_bool step_output_escaped
+  local pass_bool
   if [ "$exit_code" = "0" ]; then
     echo "✓ (${elapsed}ms)" >&2
     pass_bool="true"
@@ -103,14 +104,7 @@ run_step() {
     OVERALL_PASS=false
   fi
 
-  step_output_escaped=$(escape_step_output "$output")
-
-  RESULTS_JSON=$(echo "$RESULTS_JSON" | node -e "
-const fs = require('fs');
-let arr = JSON.parse(fs.readFileSync('/dev/stdin','utf8'));
-arr.push({name:'$name',pass:$pass_bool,ms:$elapsed,output:$step_output_escaped});
-process.stdout.write(JSON.stringify(arr));
-" 2>/dev/null || echo "$RESULTS_JSON")
+  record_step_result "$name" "$pass_bool" "$elapsed" "$output"
 
   if [ "$pass_bool" = "false" ] && [ -z "$FULL" ]; then
     return 1

package/dist/templates/runtime-bundles/pm2-runtime/ecosystem.agent.template.cjs

@@ -7,11 +7,17 @@
 
 // launch.sh writes this file (and .env.agent.N) to the work dir root,
 // so __dirname IS the work dir — repo root or the agent's git worktree.
+const fs = require('fs');
 const path = require('path');
-const dotenv = require('dotenv');
 
 const agentEnvPath = path.resolve(__dirname, '.env.agent.${AGENT_ID}');
-const env = dotenv.config({ path: agentEnvPath }).parsed || {};
+const env = {};
+try {
+  for (const line of fs.readFileSync(agentEnvPath, 'utf8').split('\n')) {
+    const m = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*?)\s*$/);
+    if (m && !line.trimStart().startsWith('#')) env[m[1]] = m[2].replace(/^["']|["']$/g, '');
+  }
+} catch {}
 
 module.exports = {
   apps: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@osfactory/har",
-  "version": "0.61.1",
+  "version": "0.61.3",
   "description": "Open harness for reproducible multi-agent coding workflows",
   "keywords": [
     "har",