create-harness-vibe-coding 0.8.6 → 0.8.8

package/package.json

@@ -1,44 +1,46 @@
-{
-  "name": "create-harness-vibe-coding",
-  "version": "0.8.6",
-  "description": "Scaffold a 0-1 product harness for AI-assisted research, PRD, planning, architecture, build, test, and feedback loops",
-  "type": "module",
-  "bin": {
-    "create-harness-vibe-coding": "bin/create-harness-vibe-coding.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "templates/",
-    "README-CN.md"
-  ],
-  "scripts": {
-    "start": "node src/index.js",
-    "build:version": "node scripts/build-version.mjs",
-    "prepush": "node scripts/pre-push-check.mjs",
-    "test": "node --test tests/*.test.js",
-    "test:smoke": "node --test tests/cli-smoke.test.js",
-    "pack:smoke": "node --test tests/pack-smoke.test.js"
-  },
-  "dependencies": {
-    "@clack/prompts": "^0.7.0",
-    "picocolors": "^1.1.0"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zingspark/create-harness-vibe-coding.git"
-  },
-  "keywords": [
-    "claude-code",
-    "harness",
-    "scaffold",
-    "vibe-coding",
-    "agentic",
-    "ecc",
-    "superpowers"
-  ],
-  "license": "MIT"
-}
+{
+  "name": "create-harness-vibe-coding",
+  "version": "0.8.8",
+  "description": "Scaffold a 0-1 product harness for AI-assisted research, PRD, planning, architecture, build, test, and feedback loops",
+  "type": "module",
+  "bin": {
+    "create-harness-vibe-coding": "bin/create-harness-vibe-coding.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "docs/images/harness-architecture-light.png",
+    "docs/images/harness-architecture.drawio",
+    "README-CN.md"
+  ],
+  "scripts": {
+    "start": "node src/index.js",
+    "build:version": "node scripts/build-version.mjs",
+    "prepush": "node scripts/pre-push-check.mjs",
+    "test": "node --test tests/*.test.js",
+    "test:smoke": "node --test tests/cli-smoke.test.js",
+    "pack:smoke": "node --test tests/pack-smoke.test.js"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "picocolors": "^1.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zingspark/create-harness-vibe-coding.git"
+  },
+  "keywords": [
+    "claude-code",
+    "harness",
+    "scaffold",
+    "vibe-coding",
+    "agentic",
+    "ecc",
+    "superpowers"
+  ],
+  "license": "MIT"
+}

package/src/generator.js

@@ -350,8 +350,9 @@ function nextBackupPath(destPath) {
 }
 
 function registerOptionalContent(file, content, selectedSkills) {
-  if (!selectedSkills.length) return content;
-
+  if (!selectedSkills.length) return content;
+  const hasBrowserE2e = selectedSkills.some(skill => skill.id === 'browser-e2e');
+
   if (file === 'Harness/MEMORY.md') {
     const lines = selectedSkills.map(skill => (
       `- [${skill.id}](../.claude/skills/${skill.id}/SKILL.md) - ${skill.description} Codex mirror: [${skill.id}](../.agents/skills/${skill.id}/SKILL.md). Workflow: [workflows/${skill.id}.md](workflows/${skill.id}.md)`
@@ -360,15 +361,33 @@ function registerOptionalContent(file, content, selectedSkills) {
       'Stack-specific skills can be added after the product shape is known.',
       `Installed optional skills:\n\n${lines.join('\n')}\n\nStack-specific skills can be added after the product shape is known.`,
     );
-  }
-
-  if (file === 'Harness/README.md') {
-    const lines = selectedSkills.map(skill => (
-      `- [${skill.title}](workflows/${skill.id}.md) - ${skill.description}`
-    ));
-    return `${content.trimEnd()}\n\n## Installed Optional Workflows\n\n${lines.join('\n')}\n`;
-  }
-
+  }
+
+  if (file === 'Harness/README.md') {
+    const lines = selectedSkills.map(skill => (
+      `- [${skill.title}](workflows/${skill.id}.md) - ${skill.description}`
+    ));
+    let next = content;
+    if (hasBrowserE2e) {
+      next = next.replace(
+        '| Optional workflow installed |',
+        '| Browser E2E testing or automation | /wf-browser, $wf-browser, browser, e2e, web automation, screenshot verify, page test, browser test, Playwright, CDP | [workflows/browser-e2e.md](workflows/browser-e2e.md), [HARNESS_BRIDGE.md](HARNESS_BRIDGE.md) | UI/API contract, CLI commands, screenshots, traces, validation matrix |\n| Optional workflow installed |',
+      );
+      next = next.replace(
+        '| `/wf-readme [task]` |',
+        '| `/wf-browser [task]` | `$wf-browser [task]` | Optional browser automation/E2E workflow when `browser-e2e` is installed |\n| `/wf-readme [task]` |',
+      );
+    }
+    return `${next.trimEnd()}\n\n## Installed Optional Workflows\n\n${lines.join('\n')}\n`;
+  }
+
+  if ((file === '.claude/commands/wf-help.md' || file === '.opencode/commands/wf-help.md') && hasBrowserE2e) {
+    return content.replace(
+      '| `/wf-readme <task>` |',
+      '| `/wf-browser <task>` | optional workflow skill | `/wf-browser verify checkout flow` | Browser automation/E2E workflow with real UI interaction, screenshots, traces, and CDP/network evidence. |\n| `/wf-readme <task>` |',
+    );
+  }
+
   return content;
 }
 

package/src/index.js

@@ -2,9 +2,13 @@
 import * as p from '@clack/prompts';
 import fs from 'node:fs';
 import path from 'node:path';
+import { spawnSync } from 'node:child_process';
 import pc from 'picocolors';
 import { askConflictPolicy, askOptionalSelections, askProjectName, askTargetDir } from './prompts.js';
 import { generate, getOptionalCatalog } from './generator.js';
+
+const UPDATE_SUCCESS_STATUSES = new Set(['up-to-date', 'update-available', 'partial-update']);
+const UPDATE_FAILURE_STATUSES = new Set(['error', 'offline', 'template-remote', 'downgrade-refused']);
 
 // ── CLI flags ──────────────────────────────────────────────
 const raw = process.argv.slice(2);
@@ -85,6 +89,10 @@ if (generationOptions.json) {
   const projectName = argName || DEFAULT_NAME;
   const targetDir = argDir || `./${projectName}`;
   const scan = scanTarget(targetDir);
+  if (scan.hasHarness) {
+    printJsonResult(createUpdateSwitchResult(scan, { json: true }));
+    process.exit(0);
+  }
   const result = generate({ projectName, targetDir, ...generationOptions });
   result.scan = createJsonScan(scan);
   result.agent = createAgentGuidance(result, {
@@ -108,16 +116,21 @@ console.log('');
 let projectName, targetDir;
 
 // Non-interactive: positionals provided OR -y/--yes flag set
-if (argName || skipPrompts) {
-  projectName = argName || DEFAULT_NAME;
-  targetDir = argDir || `./${projectName}`;
-
-  console.log(pc.dim('────────────────────────────────────────────'));
+if (argName || skipPrompts) {
+  projectName = argName || DEFAULT_NAME;
+  targetDir = argDir || `./${projectName}`;
+  const scan = scanTarget(targetDir);
+
+  if (scan.hasHarness) {
+    process.exit(runUpdateSwitch(scan, { json: false }));
+  }
+
+  console.log(pc.dim('────────────────────────────────────────────'));
   console.log(`  Project     ${pc.green(projectName)}`);
   console.log(`  Directory   ${pc.green(targetDir)}`);
-  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, tests/')}`);
+  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, .opencode/, opencode.json, tests/')}`);
   if (generationOptions.dryRun) {
-    console.log(`  Mode        ${pc.yellow('dry-run')}`);
+    console.log(`  Mode        ${pc.yellow('dry-run')}`);
   }
   console.log(`  Conflicts   ${pc.cyan(generationOptions.onConflict)}`);
   if (generationOptions.withOptions.length > 0) {
@@ -159,6 +172,10 @@ if (argName || skipPrompts) {
   const scan = scanTarget(targetDir);
   printScan(scan);
 
+  if (scan.hasHarness) {
+    process.exit(runUpdateSwitch(scan, { json: false }));
+  }
+
   if (!generationOptions.dryRun && !conflictPolicyProvided && scan.needsConflictPolicy) {
     try {
       generationOptions.onConflict = await askConflictPolicy(scan);
@@ -189,7 +206,7 @@ if (argName || skipPrompts) {
   console.log(pc.dim('────────────────────────────────────────────'));
   console.log(`  Project     ${pc.green(projectName)}`);
   console.log(`  Directory   ${pc.green(targetDir)}`);
-  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, tests/')}`);
+  console.log(`  Creates     ${pc.cyan('CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, .opencode/, opencode.json, tests/')}`);
   console.log(`  Conflicts   ${pc.cyan(generationOptions.onConflict)}`);
   if (generationOptions.withOptions.length > 0) {
     console.log(`  Optional    ${pc.cyan(generationOptions.withOptions.join(','))}`);
@@ -259,8 +276,9 @@ function printResult(result, targetDir) {
 
     console.log(pc.bold('Next steps:'));
     console.log(`  ${pc.cyan(`cd ${targetDir}`)}`);
-    console.log(`  ${pc.cyan('claude')}                          # Start Claude Code`);
-    console.log(`  ${pc.cyan('codex')}                           # Or start Codex`);
+    console.log(`  ${pc.cyan('claude')}                          # Start Claude Code`);
+    console.log(`  ${pc.cyan('codex')}                           # Or start Codex`);
+    console.log(`  ${pc.cyan('opencode')}                        # Or start OpenCode`);
     console.log(`  Tell your agent: "${pc.yellow('Read Harness/SETUP.md. Bootstrap this project from idea to first vertical slice.')}"`);
     console.log('');
     console.log(pc.dim('  Harness/SETUP.md is temporary. Delete it after initialization.'));
@@ -429,6 +447,113 @@ function printJsonResult(result) {
   }
 }
 
+function runUpdateSwitch(scan, { json }) {
+  const updateResult = createUpdateSwitchResult(scan, { json });
+  if (json) {
+    printJsonResult(updateResult);
+    return updateResult.success ? 0 : 1;
+  }
+
+  console.log('');
+  console.log(pc.yellow('Existing Harness detected. Switching to wf-update check.'));
+  console.log(pc.dim(`Directory   ${scan.resolvedDir}`));
+  console.log(pc.dim('Command     node Harness/scripts/wf-update-check.mjs'));
+  console.log('');
+
+  if (!updateResult.success && updateResult.error) {
+    console.error(pc.red(updateResult.error));
+    return 1;
+  }
+
+  if (updateResult.stdout) process.stdout.write(updateResult.stdout);
+  if (updateResult.stderr) process.stderr.write(updateResult.stderr);
+  return updateResult.exitCode ?? 0;
+}
+
+function getUpdateStatusError(update) {
+  if (!update || typeof update !== 'object' || typeof update.status !== 'string') {
+    return 'Update checker did not return a machine-readable status.';
+  }
+  if (UPDATE_FAILURE_STATUSES.has(update.status)) {
+    return `Update checker reported ${update.status}${update.message ? `: ${update.message}` : ''}`;
+  }
+  if (!UPDATE_SUCCESS_STATUSES.has(update.status)) {
+    return `Update checker returned unrecognized status: ${update.status}`;
+  }
+  return null;
+}
+
+function createUpdateSwitchResult(scan, { json }) {
+  const args = ['Harness/scripts/wf-update-check.mjs'];
+  if (json) args.push('--json');
+
+  const scriptPath = path.join(scan.resolvedDir, 'Harness', 'scripts', 'wf-update-check.mjs');
+  const command = `node ${args.join(' ')}`;
+  const base = {
+    success: false,
+    mode: 'update',
+    scan: createJsonScan(scan),
+    agent: {
+      sourceOfTruth: 'Existing Harness detected; install automatically switched to the target update checker. Do not continue install writes.',
+      updateCommand: json
+        ? 'node Harness/scripts/wf-update-check.mjs --json'
+        : 'node Harness/scripts/wf-update-check.mjs',
+      next: [
+        {
+          action: 'update',
+          command: json
+            ? 'node Harness/scripts/wf-update-check.mjs --json'
+            : 'node Harness/scripts/wf-update-check.mjs',
+          reason: 'Harness already exists, so updates must use the installed Harness update flow.',
+        },
+      ],
+    },
+  };
+
+  if (!fs.existsSync(scriptPath)) {
+    return {
+      ...base,
+      error: 'Existing Harness detected, but Harness/scripts/wf-update-check.mjs was not found. Install writes were skipped; inspect the existing Harness before updating manually.',
+      errors: ['Harness/scripts/wf-update-check.mjs not found'],
+    };
+  }
+
+  const result = spawnSync(process.execPath, args, {
+    cwd: scan.resolvedDir,
+    encoding: 'utf8',
+  });
+  const stdout = result.stdout || '';
+  const stderr = result.stderr || '';
+  const status = result.status ?? 1;
+
+  let update = undefined;
+  if (json && stdout.trim()) {
+    try {
+      update = JSON.parse(stdout.trim());
+    } catch {
+      update = { rawOutput: stdout };
+    }
+  }
+
+  const errors = [];
+  if (status !== 0) errors.push(`Update checker exited with status ${status}`);
+  if (json) {
+    const statusError = getUpdateStatusError(update);
+    if (statusError) errors.push(statusError);
+  }
+
+  return {
+    ...base,
+    success: errors.length === 0,
+    exitCode: status,
+    command,
+    stdout,
+    stderr,
+    ...(json ? { update } : {}),
+    ...(errors.length === 0 ? {} : { error: errors[0], errors }),
+  };
+}
+
 function scanTarget(targetDir) {
   const resolvedDir = path.resolve(process.cwd(), targetDir);
   const exists = fs.existsSync(resolvedDir);
@@ -440,7 +565,8 @@ function scanTarget(targetDir) {
   const hasClaude = isDirectory && fs.existsSync(path.join(resolvedDir, 'CLAUDE.md'));
   const hasAgents = isDirectory && fs.existsSync(path.join(resolvedDir, 'AGENTS.md'));
   const hasAgentSkills = isDirectory && fs.existsSync(path.join(resolvedDir, '.agents'));
-  const hasCodex = isDirectory && fs.existsSync(path.join(resolvedDir, '.codex'));
+  const hasCodex = isDirectory && fs.existsSync(path.join(resolvedDir, '.codex'));
+  const hasOpencode = isDirectory && (fs.existsSync(path.join(resolvedDir, '.opencode')) || fs.existsSync(path.join(resolvedDir, 'opencode.json')));
   const hasDocs = isDirectory && fs.existsSync(path.join(resolvedDir, 'docs'));
   const hasReadme = isDirectory && fs.existsSync(path.join(resolvedDir, 'README.md'));
   const hasPackageJson = isDirectory && fs.existsSync(path.join(resolvedDir, 'package.json'));
@@ -458,7 +584,8 @@ function scanTarget(targetDir) {
     hasClaude,
     hasAgents,
     hasAgentSkills,
-    hasCodex,
+    hasCodex,
+    hasOpencode,
     hasDocs,
     hasReadme,
     hasPackageJson,
@@ -486,7 +613,8 @@ function createJsonScan(scan) {
       hasClaude: scan.hasClaude,
       hasAgents: scan.hasAgents,
       hasAgentSkills: scan.hasAgentSkills,
-      hasCodex: scan.hasCodex,
+      hasCodex: scan.hasCodex,
+      hasOpencode: scan.hasOpencode,
       hasDocs: scan.hasDocs,
       hasReadme: scan.hasReadme,
       hasPackageJson: scan.hasPackageJson,
@@ -660,6 +788,7 @@ function printScan(scan) {
   if (scan.hasClaude) console.log(`  CLAUDE.md   ${pc.yellow('exists')}`);
   if (scan.hasAgents) console.log(`  AGENTS.md   ${pc.yellow('exists')}`);
   if (scan.hasAgentSkills) console.log(`  .agents/    ${pc.yellow('exists')}`);
-  if (scan.hasCodex) console.log(`  .codex/     ${pc.yellow('exists')}`);
+  if (scan.hasCodex) console.log(`  .codex/     ${pc.yellow('exists')}`);
+  if (scan.hasOpencode) console.log(`  opencode     ${pc.yellow('exists')}  ${pc.dim('(.opencode/ or opencode.json)')}`);
   if (scan.hasDocs) console.log(`  docs/       ${pc.dim('project-owned; Harness stays in Harness/')}`);
 }

package/src/prompts.js

@@ -1,41 +1,41 @@
-import * as p from '@clack/prompts';
-import pc from 'picocolors';
-
-export async function askProjectName() {
-  const name = await p.text({
-    message: 'Project name?',
-    placeholder: 'my-vibe-project',
-    defaultValue: 'my-vibe-project',
-    validate(value) {
-      if (!value.trim()) return 'Project name is required';
-      if (!/^[a-zA-Z0-9_-]+$/.test(value)) return 'Only letters, numbers, hyphens, and underscores allowed';
-      return;
-    },
-  });
-
-  if (p.isCancel(name)) {
-    p.cancel('Cancelled');
-    process.exit(0);
-  }
-
-  return name.trim();
-}
-
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+
+export async function askProjectName() {
+  const name = await p.text({
+    message: 'Project name?',
+    placeholder: 'my-vibe-project',
+    defaultValue: 'my-vibe-project',
+    validate(value) {
+      if (!value.trim()) return 'Project name is required';
+      if (!/^[a-zA-Z0-9_-]+$/.test(value)) return 'Only letters, numbers, hyphens, and underscores allowed';
+      return;
+    },
+  });
+
+  if (p.isCancel(name)) {
+    p.cancel('Cancelled');
+    process.exit(0);
+  }
+
+  return name.trim();
+}
+
 export async function askTargetDir(projectName) {
-  const dir = await p.text({
-    message: 'Target directory?',
-    placeholder: `./${projectName}`,
-    defaultValue: `./${projectName}`,
-    validate(value) {
-      if (!value.trim()) return 'Directory is required';
-      return;
-    },
-  });
-
-  if (p.isCancel(dir)) {
-    p.cancel('Cancelled');
-    process.exit(0);
-  }
+  const dir = await p.text({
+    message: 'Target directory?',
+    placeholder: `./${projectName}`,
+    defaultValue: `./${projectName}`,
+    validate(value) {
+      if (!value.trim()) return 'Directory is required';
+      return;
+    },
+  });
+
+  if (p.isCancel(dir)) {
+    p.cancel('Cancelled');
+    process.exit(0);
+  }
 
   return dir.trim();
 }

package/templates/common/.claude/agents/architect-manager.md

@@ -1,45 +1,45 @@
----
-name: architect-manager
-description: WF-MAX Manager for W1 architecture wave. Spawns 3 boundary/interface/data-flow architects, synthesizes interface contracts, reports to CEO. Read-only + Agent spawn; no Edit/Write.
-tools: Read, Grep, Glob, Agent, Bash(git *), Bash(ls *), Bash(dir *)
-model: sonnet
----
-
-# Architect Manager — W1 Architecture Wave
-
-You are an Architect Manager in the WF-MAX hierarchy. You report to the CEO.
-
-## Role
-
-Cross-file interface design → parallel dispatch of 3 architects → synthesize boundary decisions + interface contract → report to CEO for approval.
-
-## What You Do
-
-1. Receive architecture scope from the CEO (which modules/layers need boundaries defined)
-2. Spawn 3 parallel architects:
-   - **boundary-researcher**: study existing interfaces, dependencies, import graphs
-   - **interface-designer**: propose new interface contracts, ports, adapters
-   - **data-flow-mapper**: trace data through the system, identify state ownership
-3. ALL 3 spawned in ONE message
-4. Synthesize: reconcile interface proposals, flag conflicts, produce one interface contract
-5. Report to CEO with recommended decisions and trade-offs
-
-## What You NEVER Do
-
-- Write or edit source code
-- Implement interfaces (that's W2)
-- Make final architecture decisions (present options with trade-offs)
-- Write to task files
-
-## Synthesis Format
-
-```
-Boundary decisions (proposed):
-Interface contract:
-  - Port A: <signature, owner, consumers>
-  - Port B: <signature, owner, consumers>
-Data flow:
-State ownership:
-Conflicts/risks:
-Open questions for CEO:
-```
+---
+name: architect-manager
+description: WF-MAX Manager for W1 architecture wave. Spawns 3 boundary/interface/data-flow architects, synthesizes interface contracts, reports to CEO. Read-only + Agent spawn; no Edit/Write.
+tools: Read, Grep, Glob, Agent, Bash(git *), Bash(ls *), Bash(dir *)
+model: sonnet
+---
+
+# Architect Manager — W1 Architecture Wave
+
+You are an Architect Manager in the WF-MAX hierarchy. You report to the CEO.
+
+## Role
+
+Cross-file interface design → parallel dispatch of 3 architects → synthesize boundary decisions + interface contract → report to CEO for approval.
+
+## What You Do
+
+1. Receive architecture scope from the CEO (which modules/layers need boundaries defined)
+2. Spawn 3 parallel architects:
+   - **boundary-researcher**: study existing interfaces, dependencies, import graphs
+   - **interface-designer**: propose new interface contracts, ports, adapters
+   - **data-flow-mapper**: trace data through the system, identify state ownership
+3. ALL 3 spawned in ONE message
+4. Synthesize: reconcile interface proposals, flag conflicts, produce one interface contract
+5. Report to CEO with recommended decisions and trade-offs
+
+## What You NEVER Do
+
+- Write or edit source code
+- Implement interfaces (that's W2)
+- Make final architecture decisions (present options with trade-offs)
+- Write to task files
+
+## Synthesis Format
+
+```
+Boundary decisions (proposed):
+Interface contract:
+  - Port A: <signature, owner, consumers>
+  - Port B: <signature, owner, consumers>
+Data flow:
+State ownership:
+Conflicts/risks:
+Open questions for CEO:
+```