@mmerterden/multi-agent-pipeline 8.6.1 → 10.0.6

package/install/_common.mjs

@@ -18,16 +18,36 @@ import {
   rmSync,
   symlinkSync,
   unlinkSync,
+  writeFileSync,
 } from "fs";
 import { dirname } from "path";
 import { execSync } from "child_process";
 import { join } from "path";
 
+let dryRun = false;
+
+/**
+ * Toggle dry-run mode for every filesystem primitive in this module.
+ * In dry-run, mutations are logged as `[dry-run] would ...` and skipped,
+ * so the install code path stays identical and the preview cannot drift
+ * from the real behaviour.
+ * @param {boolean} value
+ */
+export function setDryRun(value) {
+  dryRun = Boolean(value);
+}
+
+/** @returns {boolean} */
+export function isDryRun() {
+  return dryRun;
+}
+
 /**
  * Recursively create a directory if it doesn't exist.
  * @param {string} dir
  */
 export function ensureDir(dir) {
+  if (dryRun) return;
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
 }
 
@@ -44,6 +64,10 @@ export function copyDir(src, dest, opts = {}) {
     symlinkDir(src, dest);
     return;
   }
+  if (dryRun) {
+    console.log(`    [dry-run] would copy ${src} -> ${dest}`);
+    return;
+  }
   ensureDir(dest);
   if (exclude.length === 0) {
     cpSync(src, dest, { recursive: true, force: true });
@@ -71,6 +95,10 @@ export function copyDir(src, dest, opts = {}) {
  * @param {string} dest
  */
 export function symlinkDir(src, dest) {
+  if (dryRun) {
+    console.log(`    [dry-run] would symlink ${dest} -> ${src}`);
+    return;
+  }
   try {
     if (existsSync(dest)) {
       const stat = lstatSync(dest);
@@ -108,6 +136,11 @@ export function pruneLegacyMultiAgentSkills(skillsDir) {
     if (!(entry.isDirectory() || entry.isSymbolicLink())) continue;
     const name = entry.name;
     if (name === "multi-agent" || name.startsWith("multi-agent-")) {
+      if (dryRun) {
+        console.log(`    [dry-run] would remove legacy skill dir ${join(skillsDir, name)}`);
+        removed++;
+        continue;
+      }
       try {
         rmSync(join(skillsDir, name), { recursive: true, force: true });
         removed++;
@@ -119,6 +152,32 @@ export function pruneLegacyMultiAgentSkills(skillsDir) {
   return removed;
 }
 
+/**
+ * Copy a single file, honouring dry-run mode.
+ * @param {string} src
+ * @param {string} dest
+ */
+export function copyFile(src, dest) {
+  if (dryRun) {
+    console.log(`    [dry-run] would copy ${src} -> ${dest}`);
+    return;
+  }
+  cpSync(src, dest, { force: true });
+}
+
+/**
+ * Write a file, honouring dry-run mode.
+ * @param {string} path
+ * @param {string} content
+ */
+export function writeFile(path, content) {
+  if (dryRun) {
+    console.log(`    [dry-run] would write ${path}`);
+    return;
+  }
+  writeFileSync(path, content);
+}
+
 /**
  * Count files in a directory tree.
  * @param {string} dir
@@ -142,6 +201,10 @@ export function countFiles(dir) {
  */
 export function wipeDir(dir) {
   if (!existsSync(dir)) return;
+  if (dryRun) {
+    console.log(`    [dry-run] would wipe ${dir}`);
+    return;
+  }
   try {
     rmSync(dir, { recursive: true, force: true });
   } catch {

package/install/claude.mjs

@@ -12,21 +12,19 @@
  * @module install/claude
  */
 
-import {
-  copyFileSync,
-  existsSync,
-  readFileSync,
-  writeFileSync,
-} from "fs";
+import { existsSync, readFileSync } from "fs";
 import { join } from "path";
 import { execSync } from "child_process";
 
 import {
   copyDir,
+  copyFile,
   countFiles,
   ensureDir,
+  isDryRun,
   pruneLegacyMultiAgentSkills,
   wipeDir,
+  writeFile,
 } from "./_common.mjs";
 import { copyExternalSkillsFiltered } from "./_platform-filter.mjs";
 import { DEV_ONLY_SCRIPTS } from "./_dev-only-files.mjs";
@@ -184,8 +182,8 @@ function installSkills(opts) {
     ensureDir(dest);
     const indexJson = join(pipelineSrc, "skills", ".skills-index.json");
     const indexMd = join(pipelineSrc, "skills", "skills-index.md");
-    if (existsSync(indexJson)) copyFileSync(indexJson, join(dest, ".skills-index.json"));
-    if (existsSync(indexMd)) copyFileSync(indexMd, join(dest, "skills-index.md"));
+    if (existsSync(indexJson)) copyFile(indexJson, join(dest, ".skills-index.json"));
+    if (existsSync(indexMd)) copyFile(indexMd, join(dest, "skills-index.md"));
     console.log(`    -> --index-only: wrote skills-index.{json,md} to ${dest}`);
     console.log(`    -> set prefs.global.dynamicSkillLoading=true to use (see docs)`);
     return;
@@ -248,7 +246,7 @@ function installSkills(opts) {
   if (existsSync(sharedReadmeSrc)) {
     const claudeReadme = join(dest, "README.md");
     try {
-      copyFileSync(sharedReadmeSrc, claudeReadme);
+      copyFile(sharedReadmeSrc, claudeReadme);
       console.log(`    -> updated ${claudeReadme}`);
     } catch {
       /* non-fatal */
@@ -262,7 +260,7 @@ function ensureClaudeMd(home, pipelineSrc) {
   const templateSrc = join(pipelineSrc, "claude-md-template.md");
   if (!existsSync(CLAUDE_MD)) {
     if (existsSync(templateSrc)) {
-      copyFileSync(templateSrc, CLAUDE_MD);
+      copyFile(templateSrc, CLAUDE_MD);
       console.log(`    -> Created ${CLAUDE_MD} from template`);
     }
   } else {
@@ -275,7 +273,7 @@ function ensurePreferences(prefsPath, pipelineSrc) {
   const prefsSrc = join(pipelineSrc, "preferences-template.json");
   if (!existsSync(prefsPath)) {
     if (existsSync(prefsSrc)) {
-      copyFileSync(prefsSrc, prefsPath);
+      copyFile(prefsSrc, prefsPath);
       console.log(`    -> Created ${prefsPath}`);
     }
   } else {
@@ -312,15 +310,17 @@ function configureSettings(home) {
             type: "command",
             command: "bash $HOME/.claude/scripts/pre-commit-check.sh",
             timeout: 15,
-            statusMessage: "Scanning for secrets...",
+            statusMessage: "Scanning staged changes for secrets...",
           },
         ],
       });
       settingsChanged = true;
     }
 
-    if (settingsChanged) {
-      writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
+    if (settingsChanged && isDryRun()) {
+      console.log(`    [dry-run] would update ${SETTINGS_PATH} (hooks + env)`);
+    } else if (settingsChanged) {
+      writeFile(SETTINGS_PATH, JSON.stringify(settings, null, 2) + "\n");
       console.log("    -> Added PreToolUse secret detection hook");
       console.log("    -> Set CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=65");
     } else {

package/install/copilot.mjs

@@ -9,21 +9,22 @@
  */
 
 import {
-  copyFileSync,
   existsSync,
   mkdirSync,
   readdirSync,
   readFileSync,
   rmSync,
-  writeFileSync,
 } from "fs";
 import { join } from "path";
 
 import {
   copyDir,
+  copyFile,
   countFiles,
   ensureDir,
+  isDryRun,
   wipeDir,
+  writeFile,
 } from "./_common.mjs";
 import { copyExternalSkillsFiltered } from "./_platform-filter.mjs";
 import { DEV_ONLY_SCRIPTS } from "./_dev-only-files.mjs";
@@ -64,7 +65,7 @@ function writeInstructionsFile(path) {
   const pipelineSection = generateCopilotInstructions();
 
   if (!existsSync(path)) {
-    writeFileSync(path, pipelineSection + "\n");
+    writeFile(path, pipelineSection + "\n");
     console.log("    -> Created copilot-instructions.md with pipeline");
     return;
   }
@@ -103,11 +104,11 @@ function writeInstructionsFile(path) {
 
   if (existing.includes(marker)) {
     const before = existing.split(marker)[0].trimEnd();
-    writeFileSync(path, before + "\n\n" + pipelineSection + "\n");
+    writeFile(path, before + "\n\n" + pipelineSection + "\n");
     const suffix = cleaned ? " (also scrubbed pre-v5.0 drift section)" : "";
     console.log(`    -> Updated existing pipeline section in copilot-instructions.md${suffix}`);
   } else {
-    writeFileSync(path, existing.trimEnd() + "\n\n" + pipelineSection + "\n");
+    writeFile(path, existing.trimEnd() + "\n\n" + pipelineSection + "\n");
     console.log("    -> Appended pipeline section to copilot-instructions.md");
   }
 }
@@ -163,8 +164,8 @@ function installSkills(opts) {
     }
     const indexJson = join(pipelineSrc, "skills", ".skills-index.json");
     const indexMd = join(pipelineSrc, "skills", "skills-index.md");
-    if (existsSync(indexJson)) copyFileSync(indexJson, join(dest, ".skills-index.json"));
-    if (existsSync(indexMd)) copyFileSync(indexMd, join(dest, "skills-index.md"));
+    if (existsSync(indexJson)) copyFile(indexJson, join(dest, ".skills-index.json"));
+    if (existsSync(indexMd)) copyFile(indexMd, join(dest, "skills-index.md"));
     console.log(`    -> --index-only: wrote skills-index.{json,md} to ${dest}`);
     console.log("");
     return;
@@ -192,6 +193,11 @@ function installSkills(opts) {
         entry.name.startsWith("multi-agent") &&
         !sourceNames.has(entry.name)
       ) {
+        if (isDryRun()) {
+          console.log(`    [dry-run] would prune stale skill dir ${join(dest, entry.name)}`);
+          pruned++;
+          continue;
+        }
         try {
           rmSync(join(dest, entry.name), { recursive: true, force: true });
           pruned++;
@@ -242,7 +248,7 @@ function installSkills(opts) {
   if (existsSync(sharedReadmeSrc)) {
     const copilotReadme = join(dest, "README.md");
     try {
-      copyFileSync(sharedReadmeSrc, copilotReadme);
+      copyFile(sharedReadmeSrc, copilotReadme);
       console.log(`    -> updated ${copilotReadme}`);
     } catch {
       /* non-fatal */

package/install/index.mjs

@@ -17,6 +17,7 @@ import { fileURLToPath } from "url";
 import { installClaude } from "./claude.mjs";
 import { installCopilot } from "./copilot.mjs";
 import { anyAdapterRequested, installAdapters } from "./_adapters.mjs";
+import { setDryRun } from "./_common.mjs";
 import { sendInstallTelemetry } from "./_telemetry.mjs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -30,6 +31,8 @@ const TOOL_FLAGS = [
   "--copilot",
   "--cursor",
   "--copilot-chat",
+  "--antigravity",
+  "--codex",
 ];
 
 /**
@@ -49,6 +52,32 @@ export async function runInstall(argv) {
   //   `multi-agent-pipeline install --all` (via bin, argv[2]="install")
   const flags = argv.slice(2).filter((a) => a !== "install");
 
+  const KNOWN_FLAGS = [
+    ...TOOL_FLAGS,
+    "--all",
+    "--all-tools",
+    "--link",
+    "--index-only",
+    "--dry-run",
+  ];
+  const KNOWN_PREFIXES = ["--target=", "--platform="];
+  const unknown = flags.filter(
+    (f) =>
+      f.startsWith("--") &&
+      !KNOWN_FLAGS.includes(f) &&
+      !KNOWN_PREFIXES.some((p) => f.startsWith(p)),
+  );
+  if (unknown.length > 0) {
+    console.error(`Error: unknown flag(s): ${unknown.join(", ")}`);
+    console.error(
+      `Supported: ${[...KNOWN_FLAGS, "--target=<path>", "--platform=<ios|android|all>"].join(" ")}`,
+    );
+    process.exit(1);
+  }
+
+  const dryRun = flags.includes("--dry-run");
+  setDryRun(dryRun);
+
   const isExplicitlyTargeted =
     flags.some((f) => TOOL_FLAGS.includes(f)) ||
     flags.includes("--all") ||
@@ -68,6 +97,8 @@ export async function runInstall(argv) {
   const adapterFlags = {
     cursor: flags.includes("--cursor") || flags.includes("--all-tools"),
     copilotChat: flags.includes("--copilot-chat") || flags.includes("--all-tools"),
+    antigravity: flags.includes("--antigravity") || flags.includes("--all-tools"),
+    codex: flags.includes("--codex") || flags.includes("--all-tools"),
   };
 
   const adapterTarget = (() => {
@@ -90,19 +121,37 @@ export async function runInstall(argv) {
   console.log("");
   console.log("  multi-agent-pipeline installer");
   console.log("  ==============================");
+  if (dryRun) console.log("  (dry-run: no files will be written)");
   console.log("");
 
   if (forClaude) installClaude(installerCtx);
   if (forCopilot) installCopilot(installerCtx);
 
   if (anyAdapterRequested(adapterFlags)) {
-    await installAdapters({
-      pipelineRoot: PIPELINE_ROOT,
-      pipelineSrc: PIPELINE_SRC,
-      target: adapterTarget,
-      platformFilter: platformFlag,
-      flags: adapterFlags,
-    });
+    if (dryRun) {
+      // Adapter installs merge marker-wrapped blocks into user-owned files;
+      // the preview lists the touched paths instead of threading dry-run
+      // through every adapter write site.
+      const planned = Object.entries(adapterFlags)
+        .filter(([, on]) => on)
+        .map(([name]) => name);
+      console.log(`  [dry-run] would install adapter(s) ${planned.join(", ")} into ${adapterTarget}`);
+    } else {
+      await installAdapters({
+        pipelineRoot: PIPELINE_ROOT,
+        pipelineSrc: PIPELINE_SRC,
+        target: adapterTarget,
+        platformFilter: platformFlag,
+        flags: adapterFlags,
+      });
+    }
+  }
+
+  if (dryRun) {
+    console.log("");
+    console.log("  Dry-run complete — nothing was written. Re-run without --dry-run to install.");
+    console.log("");
+    return;
   }
 
   printSummary({
@@ -152,21 +201,38 @@ function printSummary(opts) {
     console.log("");
   }
   if (adapterFlags.cursor) {
-    console.log("  Cursor:");
-    console.log(`    Rules emitted to ${adapterTarget}/.cursor/rules/multi-agent-*.mdc`);
-    console.log(`    Legacy fallback: ${adapterTarget}/.cursorrules`);
-    console.log(
-      "    Note: orchestration commands not portable — use Claude Code or Copilot CLI for the full pipeline",
-    );
+    console.log("  Cursor (full orchestration):");
+    console.log(`    Rules:    ${adapterTarget}/.cursor/rules/multi-agent-*.mdc`);
+    console.log(`    Subagents: ${adapterTarget}/.cursor/agents/ma-*.md (parallel review / explorer / triage)`);
+    console.log(`    Command:  ${adapterTarget}/.cursor/commands/multi-agent.md  (run /multi-agent)`);
+    console.log(`    MCP:      ${adapterTarget}/.cursor/mcp.json (dev-toolkit)`);
+    console.log("    Pickers degrade per refs/picker-contract.md; hard gates -> advisory rules + CI.");
     console.log("");
   }
   if (adapterFlags.copilotChat) {
-    console.log("  GitHub Copilot Chat:");
-    console.log(`    Main: ${adapterTarget}/.github/copilot-instructions.md (marker-wrapped)`);
-    console.log(
-      `    Per-skill: ${adapterTarget}/.github/instructions/multi-agent-*.instructions.md`,
-    );
-    console.log("    Note: knowledge layer only — Copilot Chat has no subagent dispatch");
+    console.log("  GitHub Copilot Chat (VS Code, full orchestration):");
+    console.log(`    Instructions: ${adapterTarget}/.github/copilot-instructions.md + .github/instructions/multi-agent-*`);
+    console.log(`    Agents:   ${adapterTarget}/.github/agents/ma-*.agent.md (parallel review / explorer / triage)`);
+    console.log(`    Command:  ${adapterTarget}/.github/prompts/multi-agent.prompt.md  (run /multi-agent)`);
+    console.log(`    MCP:      ${adapterTarget}/.vscode/mcp.json (dev-toolkit)`);
+    console.log("    Confirmations use VS Code native approval dialogs (refs/picker-contract.md).");
+    console.log("");
+  }
+  if (adapterFlags.antigravity) {
+    console.log("  Antigravity (full orchestration):");
+    console.log(`    Rules:    ${adapterTarget}/.agent/rules/multi-agent-*.md`);
+    console.log(`    Workflow: ${adapterTarget}/.agent/workflows/multi-agent.md  (run /multi-agent)`);
+    console.log(`    Context:  ${adapterTarget}/AGENTS.md (skill index, marker-wrapped)`);
+    console.log(`    MCP:      ${adapterTarget}/.agent/mcp_config.json (dev-toolkit)`);
+    console.log("    Note: .agent/ paths community-documented; confirm against current Antigravity docs.");
+    console.log("");
+  }
+  if (adapterFlags.codex) {
+    console.log("  OpenAI Codex CLI (global, sequential orchestration):");
+    console.log("    Command:  ~/.codex/prompts/multi-agent.md  (run /multi-agent)");
+    console.log("    Context:  ~/.codex/AGENTS.md (skill index, marker-wrapped)");
+    console.log("    MCP:      ~/.codex/config.toml ([mcp_servers.dev-toolkit])");
+    console.log("    Note: prompts + MCP are global; Codex has no subagent fan-out (review runs sequential).");
     console.log("");
   }
 

package/install/templates/claude-hooks.json

@@ -0,0 +1,18 @@
+{
+  "_readme": "Recommended Claude Code hooks for multi-agent-pipeline. Merge the `hooks` object into your ~/.claude/settings.json to make the secret scan a HARD pre-commit gate (exit 2 blocks the commit) rather than an advisory step. This is the one gate that is naturally a PreToolUse hook: it scans the staged diff with no extra arguments. The other deterministic gates (evidence, consensus, intent, learnings) are invoked by the pipeline phases with run-specific arguments (a build-log path, the triage JSON, the free-text input), so they are phase-enforced by contract, not OS-hookable. multi-agent:setup offers to merge this block.",
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash(git commit:*)",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash $HOME/.claude/scripts/pre-commit-check.sh",
+            "timeout": 15,
+            "statusMessage": "Scanning staged changes for secrets..."
+          }
+        ]
+      }
+    ]
+  }
+}

package/install/templates/copilot-instructions.md

@@ -66,7 +66,7 @@ pipeline installer alongside the Claude Code equivalents at `~/.claude/agents/`.
 Load the matching persona file before dispatching each reviewer — the prompt defines
 the model's focus area, severity rubric, and output format the triage pass expects.
 
-## Phase 0 — Interactive Steps (MANDATORY)
+## Phase 0 — Interactive Steps (required)
 
 The orchestrator skill (`multi-agent/SKILL.md`) shows a condensed Phase 0 for brevity,
 but the actual contract is **8 interactive steps** from `refs/phases/phase-0-init.md`.
@@ -104,7 +104,7 @@ https://github.com/mmerterden/multi-agent-pipeline/blob/main/pipeline/commands/m
 or, on machines with Claude Code also installed:
 `~/.claude/commands/multi-agent/refs/phases/phase-0-init.md`
 
-## Progress Tracking — MANDATORY
+## Progress Tracking — required
 
 Every phase boundary MUST call the cross-CLI tracker. The tracker is the single source of truth
 for user-visible phase progress on Copilot CLI (no TaskCreate native UI here). Banner is optional flair.
@@ -258,7 +258,7 @@ For visual testing, use the dev-toolkit MCP server tools:
 
 Requires: @mmerterden/dev-toolkit-mcp MCP server running
 
-## Post-Development Integration Build (Multi-Repo) — MANDATORY
+## Post-Development Integration Build (Multi-Repo) — required
 
 When a task touches multiple repositories that have a producer→consumer dependency
 (e.g. shared codegen library + consuming UI library), the pipeline MUST build the

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "8.6.1",
-  "description": "8-phase AI development pipeline. Full orchestration on Claude Code + Copilot CLI; knowledge layer (rules + skills) ports to Cursor, Windsurf, and Cline. Analysis, planning, TDD, CLI-aware parallel review with Opus triage, wiki generation, commit automation. Token-preserving uninstall.",
+  "version": "10.0.6",
+  "description": "8-phase AI development pipeline with full orchestration on Claude Code, Copilot CLI, Cursor, Antigravity, and VS Code Copilot Chat. Analysis, planning, TDD, CLI-aware parallel review with consensus surfacing + Opus triage, default-FAIL evidence gates, secret + intent guards, per-phase cost ledger, persistent learnings memory, wiki generation, commit automation. Token-preserving uninstall.",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -14,9 +14,10 @@
   },
   "scripts": {
     "start": "node index.js",
-    "test": "node --test test/*.test.mjs && for f in pipeline/scripts/smoke-*.sh; do bash \"$f\" || exit 1; done && node pipeline/scripts/eval-triage.mjs && node pipeline/scripts/eval-golden-tasks.mjs && node pipeline/scripts/validate-schemas.mjs",
+    "test": "node --test test/*.test.mjs && node pipeline/scripts/run-smokes.mjs && node pipeline/scripts/lint-skills.mjs && node pipeline/scripts/eval-triage.mjs && node pipeline/scripts/eval-golden-tasks.mjs && node pipeline/scripts/eval-intent.mjs && node pipeline/scripts/validate-schemas.mjs",
     "test:unit": "node --test test/*.test.mjs",
-    "test:smoke": "for f in pipeline/scripts/smoke-*.sh; do bash \"$f\" || exit 1; done",
+    "test:smoke": "node pipeline/scripts/run-smokes.mjs",
+    "lint:skills": "node pipeline/scripts/lint-skills.mjs",
     "test:coverage": "c8 --reporter=text --reporter=lcov node --test test/*.test.mjs && c8 report",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
@@ -47,7 +48,8 @@
   "author": "Mert Erden",
   "license": "MIT",
   "publishConfig": {
-    "registry": "https://npm.pkg.github.com"
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
   },
   "repository": {
     "type": "git",
@@ -69,10 +71,23 @@
     "docs/**/*",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE"
+    "LICENSE",
+    "!pipeline/scripts/figma-placeholder-map.json",
+    "!pipeline/scripts/sync-figma-source.sh",
+    "!pipeline/scripts/import-figma-skills.sh",
+    "!pipeline/scripts/smoke-figma-skill-import.sh",
+    "!pipeline/scripts/smoke-figma-config-schema.sh",
+    "!pipeline/scripts/smoke-personal-data.sh",
+    "!pipeline/scripts/smoke-install-leak-gate.sh",
+    "!pipeline/scripts/README-figma-smokes.md",
+    "!pipeline/scripts/.last-figma-sync-plan.json",
+    "!docs/GENERICITY-REVIEW.md",
+    "!docs/STABILITY-FIX-PLAN.md"
   ],
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "ajv": "^8.20.0",
+    "ajv-formats": "^3.0.1",
     "c8": "^11.0.0",
     "eslint": "^10.2.0",
     "eslint-config-prettier": "^10.1.8",