role-os 2.2.0 → 2.3.0

package/src/swarm-cmd.mjs

@@ -0,0 +1,424 @@
+/**
+ * Swarm CLI — Dogfood Swarm entry point.
+ *
+ * roleos swarm                        Run dogfood swarm on current repo
+ * roleos swarm manifest               Show the swarm manifest
+ * roleos swarm manifest --generate    Auto-detect domains and generate manifest
+ * roleos swarm status                 Show swarm run progress
+ * roleos swarm findings               List all findings by severity
+ * roleos swarm approve                Approve the current feature gate
+ * roleos swarm verify                 Run Phase 9 final verification
+ *
+ * This is a first-class shortcut into the dogfood-swarm mission.
+ * Under the hood it creates a mission run with dynamic domain dispatch.
+ */
+
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import {
+  createPersistentRun, listRuns, loadRun, getPosition,
+} from "./run.mjs";
+import {
+  generateSwarmManifest, validateSwarmManifest,
+} from "./swarm/domain-detect.mjs";
+
+// ── Constants ────────────────────────────────────────────────────────────────
+
+const MANIFEST_FILE = "swarm-manifest.json";
+
+// ── Main dispatch ────────────────────────────────────────────────────────────
+
+/**
+ * @param {string[]} args
+ */
+export async function swarmCommand(args) {
+  const sub = args[0] || "run";
+
+  switch (sub) {
+    case "run":
+    case "start":
+      return cmdRun(args.slice(1));
+    case "manifest":
+      return cmdManifest(args.slice(1));
+    case "status":
+      return cmdStatus();
+    case "findings":
+      return cmdFindings();
+    case "approve":
+      return cmdApprove();
+    case "verify":
+      return cmdVerify();
+    case "help":
+      return cmdHelp();
+    default:
+      if (!["run", "start", "manifest", "status", "findings", "approve", "verify", "help"].includes(sub)) {
+        return cmdRun(args);
+      }
+      cmdHelp();
+  }
+}
+
+// ── roleos swarm [run] ──────────────────────────────────────────────────────
+
+function cmdRun(extraArgs) {
+  const cwd = process.cwd();
+  const manifestPath = join(cwd, MANIFEST_FILE);
+
+  // Auto-generate manifest if missing
+  if (!existsSync(manifestPath)) {
+    console.log("\nNo swarm-manifest.json found — generating from repo structure...");
+    const manifest = generateSwarmManifest(cwd);
+    const validation = validateSwarmManifest(manifest);
+
+    if (!validation.valid) {
+      console.log("\nGenerated manifest has issues:");
+      for (const issue of validation.issues) {
+        console.log(`  - ${issue}`);
+      }
+      console.log("\nFix and re-run, or run 'roleos swarm manifest --generate' to customize.\n");
+      process.exit(1);
+    }
+
+    writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+    console.log(`Generated ${MANIFEST_FILE} (${manifest.domains.length} domains, type: ${manifest.repoType})`);
+  }
+
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  const validation = validateSwarmManifest(manifest);
+
+  if (!validation.valid) {
+    console.log("\nSwarm manifest has issues:\n");
+    for (const issue of validation.issues) {
+      console.log(`  - ${issue}`);
+    }
+    console.log("\nFix the manifest and re-run.\n");
+    process.exit(1);
+  }
+
+  const taskDesc = extraArgs.length > 0
+    ? extraArgs.join(" ")
+    : `Dogfood swarm of ${manifest.repo || "current repo"}`;
+
+  // Create persistent run via the dogfood-swarm mission
+  const run = createPersistentRun(taskDesc, cwd, { forceMission: "dogfood-swarm" });
+
+  const domainCount = manifest.domains?.length || 0;
+  const stageCount = manifest.stages?.length || 4;
+
+  console.log(`\nDogfood Swarm Started`);
+  console.log(`─────────────────────`);
+  console.log(`Run:      ${run.id}`);
+  console.log(`Repo:     ${manifest.repo || "unknown"}`);
+  console.log(`Type:     ${manifest.repoType || "unknown"}`);
+  console.log(`Domains:  ${domainCount}`);
+  console.log(`Stages:   ${stageCount} (health-a → health-b → health-c → feature)`);
+  console.log(`Steps:    ${run.steps.length}`);
+  console.log(`\nDomain Agents:`);
+  for (const d of manifest.domains || []) {
+    console.log(`  - ${d.id}: ${d.role} (${d.patterns.length} patterns)`);
+  }
+  console.log(`\nStage Pipeline:`);
+  console.log(`  1. Health-A  Bug/Security Fix     (loop until 0 CRITICAL + 0 HIGH)`);
+  console.log(`  2. Health-B  Proactive Hardening   (user review gate)`);
+  console.log(`  3. Health-C  Humanization          (loop until 0 CRITICAL + 0 HIGH)`);
+  console.log(`  4. Feature   Capability Audit      (user approval gate)`);
+  console.log(`  5. Final     Synthesis + Verdict`);
+  console.log(`\nRun 'roleos next' to begin the first wave.`);
+  console.log(`Run 'roleos swarm status' to check progress.\n`);
+}
+
+// ── roleos swarm manifest ───────────────────────────────────────────────────
+
+function cmdManifest(args) {
+  const cwd = process.cwd();
+  const manifestPath = join(cwd, MANIFEST_FILE);
+
+  if (args.includes("--generate") || args.includes("-g")) {
+    return generateManifestFile(cwd, manifestPath);
+  }
+
+  if (!existsSync(manifestPath)) {
+    console.log("\nNo swarm-manifest.json found.");
+    console.log("Run 'roleos swarm manifest --generate' to create one.\n");
+    return;
+  }
+
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  const validation = validateSwarmManifest(manifest);
+
+  console.log(`\nSwarm Manifest: ${manifest.repo || "unknown"}`);
+  console.log(`──────────────────────────────────────────`);
+  console.log(`Version:  ${manifest.version || "unknown"}`);
+  console.log(`Type:     ${manifest.repoType || "unknown"}`);
+  console.log(`Domains:  ${manifest.domains?.length || 0}`);
+  console.log(`Stages:   ${manifest.stages?.length || 0}`);
+
+  if (manifest.domains?.length > 0) {
+    console.log(`\nDomains:`);
+    for (const d of manifest.domains) {
+      console.log(`  - ${d.id}: ${d.role}`);
+      for (const p of d.patterns || []) {
+        console.log(`      ${p}`);
+      }
+    }
+  }
+
+  if (!validation.valid) {
+    console.log(`\nIssues:`);
+    for (const issue of validation.issues) {
+      console.log(`  ! ${issue}`);
+    }
+  } else {
+    console.log(`\nManifest is valid.`);
+  }
+
+  console.log("");
+}
+
+function generateManifestFile(cwd, manifestPath) {
+  if (existsSync(manifestPath)) {
+    console.log(`\nManifest already exists at ${MANIFEST_FILE}.`);
+    console.log("Delete it to regenerate, or edit manually.\n");
+    return;
+  }
+
+  const manifest = generateSwarmManifest(cwd);
+  const validation = validateSwarmManifest(manifest);
+
+  writeFileSync(manifestPath, JSON.stringify(manifest, null, 2));
+  console.log(`\nGenerated ${MANIFEST_FILE}`);
+  console.log(`  Repo type: ${manifest.repoType}`);
+  console.log(`  Domains:   ${manifest.domains.length}`);
+
+  for (const d of manifest.domains) {
+    console.log(`    - ${d.id}: ${d.patterns.length} patterns`);
+  }
+
+  if (!validation.valid) {
+    console.log(`\nWarnings:`);
+    for (const issue of validation.issues) {
+      console.log(`  ! ${issue}`);
+    }
+  }
+
+  console.log(`\nEdit the manifest to customize domain boundaries.`);
+  console.log(`Then run 'roleos swarm' to start.\n`);
+}
+
+// ── roleos swarm status ─────────────────────────────────────────────────────
+
+function cmdStatus() {
+  const cwd = process.cwd();
+  const runs = listRuns(cwd);
+  const swarmRuns = runs.filter(r =>
+    r.task.toLowerCase().includes("swarm") ||
+    r.task.toLowerCase().includes("dogfood")
+  );
+
+  if (swarmRuns.length === 0) {
+    console.log("\nNo swarm runs found. Start one with: roleos swarm\n");
+    return;
+  }
+
+  const latest = swarmRuns[0];
+  console.log(`\nLatest Swarm Run`);
+  console.log(`────────────────`);
+  console.log(`ID:      ${latest.id}`);
+  console.log(`Task:    ${latest.task}`);
+  console.log(`Status:  ${latest.status.toUpperCase()}`);
+  console.log(`Created: ${latest.createdAt}`);
+
+  const full = loadRun(cwd, latest.id);
+  if (full) {
+    const pos = getPosition(full);
+    console.log(`Progress: ${pos.progress}`);
+
+    // Group by stage
+    const stageStats = {};
+    for (const s of full.steps) {
+      const stage = s.stage || "unknown";
+      if (!stageStats[stage]) stageStats[stage] = { total: 0, completed: 0, active: 0, pending: 0, failed: 0 };
+      stageStats[stage].total++;
+      stageStats[stage][s.status] = (stageStats[stage][s.status] || 0) + 1;
+    }
+
+    console.log(`\nStages:`);
+    for (const [stage, stats] of Object.entries(stageStats)) {
+      const icon = stats.failed > 0 ? "[!]" :
+                   stats.completed === stats.total ? "[x]" :
+                   stats.active > 0 ? "[>]" : "[ ]";
+      console.log(`  ${icon} ${stage}: ${stats.completed}/${stats.total} complete`);
+    }
+  }
+
+  console.log(`\nRun 'roleos explain ${latest.id}' for full detail.\n`);
+}
+
+// ── roleos swarm findings ───────────────────────────────────────────────────
+
+function cmdFindings() {
+  const cwd = process.cwd();
+  const runs = listRuns(cwd);
+  const swarmRuns = runs.filter(r =>
+    r.task.toLowerCase().includes("swarm") ||
+    r.task.toLowerCase().includes("dogfood")
+  );
+
+  if (swarmRuns.length === 0) {
+    console.log("\nNo swarm runs found.\n");
+    return;
+  }
+
+  const full = loadRun(cwd, swarmRuns[0].id);
+  if (!full) {
+    console.log("\nCouldn't load run.\n");
+    return;
+  }
+
+  // Extract findings from wave-report artifacts
+  const findings = [];
+  for (const step of full.steps) {
+    if (step.produces === "wave-report" && step.artifact) {
+      // Try to parse findings from artifact
+      const match = step.artifact.match(/## findings\n([\s\S]*?)(?=\n## |$)/i);
+      if (match) {
+        findings.push({
+          domain: step.domain || "unknown",
+          stage: step.stage || "unknown",
+          content: match[1].trim(),
+        });
+      }
+    }
+  }
+
+  if (findings.length === 0) {
+    console.log("\nNo findings captured yet. Run waves first.\n");
+    return;
+  }
+
+  console.log(`\nSwarm Findings (${findings.length} domains with findings)`);
+  console.log(`──────────────────────────────────────────────────────`);
+  for (const f of findings) {
+    console.log(`\n[${f.stage}] ${f.domain}:`);
+    console.log(f.content);
+  }
+  console.log("");
+}
+
+// ── roleos swarm approve ────────────────────────────────────────────────────
+
+function cmdApprove() {
+  const cwd = process.cwd();
+  const runs = listRuns(cwd);
+  const swarmRuns = runs.filter(r =>
+    r.task.toLowerCase().includes("swarm") ||
+    r.task.toLowerCase().includes("dogfood")
+  );
+
+  if (swarmRuns.length === 0) {
+    console.log("\nNo swarm runs found.\n");
+    return;
+  }
+
+  const full = loadRun(cwd, swarmRuns[0].id);
+  if (!full) {
+    console.log("\nCouldn't load run.\n");
+    return;
+  }
+
+  // Find the next gate step waiting for approval
+  const gateStep = full.steps.find(s =>
+    s.isGate && s.userApproval && s.status === "active"
+  );
+
+  if (!gateStep) {
+    console.log("\nNo gate currently waiting for approval.");
+    console.log("The swarm either hasn't reached a user gate yet, or has already been approved.\n");
+    return;
+  }
+
+  console.log(`\nApproved: ${gateStep.stage} gate`);
+  console.log(`The swarm will proceed to the next stage.\n`);
+}
+
+// ── roleos swarm verify ─────────────────────────────────────────────────────
+
+function cmdVerify() {
+  const cwd = process.cwd();
+  const manifestPath = join(cwd, MANIFEST_FILE);
+
+  if (!existsSync(manifestPath)) {
+    console.log("\nNo swarm-manifest.json found. Nothing to verify.\n");
+    process.exit(1);
+  }
+
+  const manifest = JSON.parse(readFileSync(manifestPath, "utf-8"));
+  const validation = validateSwarmManifest(manifest);
+
+  console.log(`\nSwarm Verification`);
+  console.log(`──────────────────`);
+
+  // 1. Manifest valid
+  if (validation.valid) {
+    console.log(`  [PASS] Manifest is valid`);
+  } else {
+    console.log(`  [FAIL] Manifest has ${validation.issues.length} issue(s)`);
+    for (const i of validation.issues) console.log(`         - ${i}`);
+  }
+
+  // 2. Domain count
+  const domainCount = manifest.domains?.length || 0;
+  if (domainCount >= 1 && domainCount <= 10) {
+    console.log(`  [PASS] ${domainCount} domains (within 1-10 range)`);
+  } else {
+    console.log(`  [FAIL] ${domainCount} domains (must be 1-10)`);
+  }
+
+  // 3. Check for swarm run
+  const runs = listRuns(cwd);
+  const swarmRuns = runs.filter(r =>
+    r.task.toLowerCase().includes("swarm") ||
+    r.task.toLowerCase().includes("dogfood")
+  );
+
+  if (swarmRuns.length > 0) {
+    const latest = swarmRuns[0];
+    const full = loadRun(cwd, latest.id);
+    if (full) {
+      const completed = full.steps.filter(s => s.status === "completed").length;
+      const total = full.steps.length;
+      console.log(`  [INFO] Active run: ${completed}/${total} steps complete`);
+    }
+  } else {
+    console.log(`  [INFO] No swarm runs yet — run 'roleos swarm' to start`);
+  }
+
+  console.log("");
+}
+
+// ── Help ────────────────────────────────────────────────────────────────────
+
+function cmdHelp() {
+  console.log(`
+Dogfood Swarm — Multi-pass convergence mission
+
+Usage:
+  roleos swarm                     Start a dogfood swarm on the current repo
+  roleos swarm manifest            Show the swarm manifest
+  roleos swarm manifest --generate Auto-detect domains and generate manifest
+  roleos swarm status              Show swarm run progress
+  roleos swarm findings            List all findings by severity
+  roleos swarm approve             Approve the current feature gate
+  roleos swarm verify              Verify manifest and run state
+  roleos swarm help                Show this help
+
+The swarm runs 4 stages in sequence:
+  1. Health-A   Bug/Security Fix      (loops until 0 CRITICAL + 0 HIGH)
+  2. Health-B   Proactive Hardening   (user review gate)
+  3. Health-C   Humanization          (loops until 0 CRITICAL + 0 HIGH)
+  4. Feature    Capability Audit      (user approval before execution)
+
+Each stage dispatches parallel domain agents with exclusive file ownership.
+A build gate (lint + typecheck + test) runs after every wave.
+`);
+}

package/src/tool-profiles.mjs

@@ -0,0 +1,91 @@
+/**
+ * Tool Profiles — per-role tool sandboxing.
+ *
+ * Extracted to a shared module so that both dispatch.mjs and trial.mjs
+ * can import it without creating a circular dependency.
+ */
+
+export const TOOL_PROFILES = {
+  // Core
+  "Orchestrator":         ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Product Strategist":   ["Read", "Glob", "Grep", "Write"],
+  "Critic Reviewer":      ["Read", "Glob", "Grep", "Bash"],
+
+  // Design
+  "UI Designer":          ["Read", "Glob", "Grep", "Write", "Edit"],
+  "Brand Guardian":       ["Read", "Glob", "Grep"],
+
+  // Engineering
+  "Backend Engineer":     ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Frontend Developer":   ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Test Engineer":        ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Performance Engineer": ["Read", "Glob", "Grep", "Bash"],
+  "Refactor Engineer":    ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Security Reviewer":    ["Read", "Glob", "Grep", "Bash"],
+  "Dependency Auditor":   ["Read", "Glob", "Grep", "Bash"],
+
+  // Treatment
+  "Repo Researcher":      ["Read", "Glob", "Grep", "Bash"],
+  "Repo Translator":      ["Read", "Glob", "Grep", "Write", "Edit"],
+  "Docs Architect":       ["Read", "Glob", "Grep", "Write", "Edit"],
+  "Metadata Curator":     ["Read", "Glob", "Grep", "Write", "Edit"],
+  "Coverage Auditor":     ["Read", "Glob", "Grep", "Bash"],
+  "Deployment Verifier":  ["Read", "Glob", "Grep", "Bash"],
+  "Release Engineer":     ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+
+  // Growth / Marketing
+  "Launch Strategist":    ["Read", "Glob", "Grep", "Write"],
+  "Content Strategist":   ["Read", "Glob", "Grep", "Write"],
+  "Community Manager":    ["Read", "Glob", "Grep", "Write"],
+  "Support Triage Lead":  ["Read", "Glob", "Grep", "Write"],
+  "Launch Copywriter":    ["Read", "Glob", "Grep", "Write", "Edit"],
+
+  // Product
+  "Feedback Synthesizer": ["Read", "Glob", "Grep"],
+  "Roadmap Prioritizer":  ["Read", "Glob", "Grep", "Write"],
+  "Spec Writer":          ["Read", "Glob", "Grep", "Write", "Edit"],
+
+  // Research
+  "UX Researcher":        ["Read", "Glob", "Grep"],
+  "Competitive Analyst":  ["Read", "Glob", "Grep"],
+  "Trend Researcher":     ["Read", "Glob", "Grep"],
+  "User Interview Synthesizer": ["Read", "Glob", "Grep"],
+
+  // Brainstorm
+  "Context Scout":        ["Read", "Glob", "Grep"],
+  "User Value Scout":     ["Read", "Glob", "Grep"],
+  "Creative Leap Scout":  ["Read", "Glob", "Grep"],
+  "Normalizer":           ["Read", "Glob", "Grep"],
+  "Synthesizer":          ["Read", "Glob", "Grep", "Write"],
+  "Product Expander":     ["Read", "Glob", "Grep", "Write"],
+  "Judge":                ["Read", "Glob", "Grep"],
+  "Mechanics Scout":      ["Read", "Glob", "Grep"],
+  "Market Scout":         ["Read", "Glob", "Grep"],
+  "Contrarian Scout":     ["Read", "Glob", "Grep"],
+  "Feasibility Scout":    ["Read", "Glob", "Grep"],
+  "Quality Bar Scout":    ["Read", "Glob", "Grep"],
+  "Scenario Expander":    ["Read", "Glob", "Grep", "Write"],
+  "Moat Expander":        ["Read", "Glob", "Grep", "Write"],
+
+  // Brainstorm v0.3 analysts
+  "Context Analyst":      ["Read", "Glob", "Grep"],
+  "User Value Analyst":   ["Read", "Glob", "Grep"],
+  "Mechanics Analyst":    ["Read", "Glob", "Grep"],
+  "Positioning Analyst":  ["Read", "Glob", "Grep"],
+  "Contrarian Analyst":   ["Read", "Glob", "Grep"],
+
+  // Deep Audit
+  "Component Auditor":    ["Read", "Glob", "Grep"],
+  "Seam Auditor":         ["Read", "Glob", "Grep"],
+  "Test Truth Auditor":   ["Read", "Glob", "Grep"],
+  "Audit Synthesizer":    ["Read", "Glob", "Grep", "Write"],
+
+  // Dogfood Swarm
+  "Swarm Coordinator":    ["Read", "Glob", "Grep", "Bash", "Write"],
+  "Swarm Backend Agent":  ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Swarm Bridge Agent":   ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Swarm Tests Agent":    ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Swarm Infra Agent":    ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Swarm Frontend Agent": ["Read", "Glob", "Grep", "Bash", "Write", "Edit"],
+  "Swarm Synthesizer":    ["Read", "Glob", "Grep", "Bash", "Write"],
+};

package/src/trial.mjs

@@ -10,7 +10,7 @@
  */
 
 import { ROLE_CATALOG, scoreRole, MIN_SCORE_THRESHOLD } from "./route.mjs";
-import { TOOL_PROFILES } from "./dispatch.mjs";
+import { TOOL_PROFILES } from "./tool-profiles.mjs";
 import { getRequirements } from "./evidence.mjs";
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
 import { join, resolve } from "node:path";