@0dai-dev/cli 4.1.0 → 4.2.0

package/bin/0dai.js

@@ -33,6 +33,10 @@ const { cmdGraph } = require("../lib/commands/graph");
 const { cmdReport } = require("../lib/commands/report");
 const { cmdExperience } = require("../lib/commands/experience");
 const { cmdWorkspace } = require("../lib/commands/workspace");
+const { cmdSsh } = require("../lib/commands/ssh");
+const { cmdTui } = require("../lib/commands/tui");
+const { cmdPersonaSimulate } = require("../lib/commands/persona-simulate");
+const { cmdProvider } = require("../lib/commands/provider");
 
 async function main() {
   const args = process.argv.slice(2);
@@ -103,13 +107,21 @@ async function main() {
     case "init": await cmdInit(target, args); break;
     case "sync": await cmdSync(target, args); break;
     case "detect": await cmdDetect(target); break;
-    case "doctor":
-      cmdDoctor(target);
+    case "doctor": {
+      const driftMode = args.includes("--drift");
+      cmdDoctor(target, { drift: driftMode });
       if (args.includes("--drift")) {
         const ds = findRepoScript(target, "drift_detector.py");
-        if (ds) spawnSync("python3", [ds, "report", "--target", target], { stdio: "inherit" });
+        console.log("\n  drift report:");
+        if (ds) {
+          const result = spawnSync("python3", [ds, "report", "--target", target], { stdio: "inherit" });
+          if (typeof result.status === "number" && result.status !== 0) process.exit(result.status);
+        } else {
+          console.log(`  ${D}drift detector unavailable in this environment${R}`);
+        }
       }
       break;
+    }
     case "drift": {
       const ds = findRepoScript(target, "drift_detector.py");
       if (!ds) { log("drift detector unavailable"); break; }
@@ -127,7 +139,7 @@ async function main() {
     case "update": cmdUpdate(args); break;
     case "metrics": cmdMetrics(target); break;
     case "portfolio": cmdPortfolio(); break;
-    case "status": cmdStatus(target); break;
+    case "status": cmdStatus(target, { json: args.includes("--json") }); break;
     case "auth":
       if (sub === "login") await cmdAuthLogin();
       else if (sub === "logout") cmdAuthLogout();
@@ -142,9 +154,13 @@ async function main() {
     case "session": cmdSession(target, sub, args); break;
     case "swarm": cmdSwarm(target, sub, args); break;
     case "workspace": cmdWorkspace(target, sub, args.slice(2)); break;
+    case "ssh": await cmdSsh(target, sub, args); break;
+    case "provider": cmdProvider(target, args.slice(1)); break;
+    case "tui": case "dashboard": await cmdTui(target, args.slice(1)); break;
     case "feedback": await cmdFeedback(target, sub, args); break;
     case "report": cmdReport(target, sub, args); break;
     case "experience": cmdExperience(target, sub, args); break;
+    case "persona-simulate": cmdPersonaSimulate(target, args.slice(1)); break;
     case "graph": await cmdGraph(target, sub, args); break;
     case "models": cmdModels(sub || args[1]); break;
     case "delegate": case "delegation": {
@@ -245,17 +261,19 @@ async function main() {
       console.log("  init           Initialize ai/ layer (via API) [--dry-run] [--minimal]");
       console.log("  sync           Update ai/ layer (via API) [--dry-run] [--quiet] [--force]");
       console.log("  detect         Show detected stack");
-      console.log("  doctor         Check health + credentials checklist");
+      console.log("  doctor         Check health + credentials checklist [--drift]");
       console.log("  update         Update all installed agent CLIs to latest [--dry-run]");
       console.log("  validate       Validate ai/ layer completeness");
       console.log("  reflect        Session reflection: delivered, delegation rate, blockers");
       console.log("  metrics        Effectiveness score: adoption funnel, sessions, delegation");
       console.log("  portfolio      All tracked projects: score, sessions, agents, last activity");
-      console.log("  status         Show maturity, swarm, session");
+      console.log("  status         Show maturity, swarm, session [--json]");
       console.log("  session save   Save session for roaming");
       console.log("  swarm status       Task queue & delegation");
       console.log("  swarm webhook add  Register webhook (fires on task done/failed)");
       console.log("  swarm webhook list Show registered webhooks");
+      console.log("  ssh            Manage SSH keys, hosts, grants, and host-side sync");
+      console.log("  provider       Local provider profiles, bindings, and direct invoke");
       console.log("  swarm webhook test Send test ping to a webhook URL");
       console.log("  workspace init     Create tmux workspace config (auto-detect services)");
       console.log("  workspace up       Start all workspace sessions");
@@ -264,6 +282,7 @@ async function main() {
       console.log("  report preview Preview privacy-safe project report");
       console.log("  report push    Send report to 0dai (with offline queue)");
       console.log("  report status  Show last report, queue, and auto-report status");
+      console.log("  persona-simulate  Produce a focus-group report and optional issue drafts");
       console.log("  experience list  Show recent structured experience events");
       console.log("  experience stats Show success and cost stats by agent/model/type");
       console.log("  graph push     Upload local graph to server (Pro: edges, Free: nodes)");

package/lib/commands/auth.js

@@ -8,6 +8,40 @@ const {
   makeEnsureAuthenticated, ensureLicenseActivation,
 } = shared;
 
+async function resolveSessionState() {
+  const auth = loadAuthState();
+  const hasCachedToken = !!(auth && (auth.api_key || auth.access_token || auth.token));
+  if (!hasCachedToken) {
+    return {
+      ok: false,
+      degraded: false,
+      auth: null,
+      status: null,
+      message: "Not logged in. Run: 0dai auth login",
+    };
+  }
+
+  const status = await fetchAuthStatus();
+  if (!status || status.error || !status.email) {
+    const email = auth.email || auth.user || "unknown";
+    return {
+      ok: false,
+      degraded: true,
+      auth,
+      status,
+      message: `Saved session for ${email}, but cloud validation failed. Run: 0dai auth login`,
+    };
+  }
+
+  return {
+    ok: true,
+    degraded: false,
+    auth,
+    status,
+    message: "",
+  };
+}
+
 async function cmdAuthLogin() {
   const isTTY = process.stdout.isTTY && process.stdin.isTTY;
 
@@ -131,8 +165,8 @@ async function cmdAuthLogin() {
         process.exit(1);
       }
     }
-    s.stop("Timed out");
-    p.log.error("Try again.");
+    s.stop("Device code expired");
+    p.log.error("The code expired after 10 minutes. Run '0dai auth login' to get a new code.");
     process.exit(1);
 
   } else {
@@ -158,7 +192,7 @@ async function cmdAuthLogin() {
         return;
       }
     }
-    log("Timed out");
+    log("Device code expired after 10 minutes. Run '0dai auth login' again.");
     process.exit(1);
   }
 }
@@ -196,26 +230,25 @@ async function cmdRedeem(code) {
 }
 
 async function cmdAuthStatus() {
-  try {
-    const auth = loadAuthState();
-    if (!auth) throw new Error("missing auth");
-    // Backwards compat: old auth.json used `user`, new uses `email`
-    const email = auth.email || auth.user || "unknown";
-    log(`${email} (${auth.plan || "free"} plan)`);
-    // Get usage from API
-    const status = await fetchAuthStatus();
-    if (status.usage_today) {
-      console.log("  Usage today:");
-      for (const [k, v] of Object.entries(status.usage_today))
-        console.log(`    ${k}: ${v} / ${status.limits[k]}`);
-    }
-    const license = status.license || auth.license || { status: "inactive" };
-    console.log(`  Activation: ${license.status || "inactive"}${license.activation_id ? ` (${license.activation_id})` : ""}`);
-    if (status.projects && status.projects.length) {
-      console.log(`  Projects bound: ${status.projects.length} / ${status.project_limit || "?"}`);
-    }
-  } catch {
-    log("Not logged in. Run: 0dai auth login");
+  const session = await resolveSessionState();
+  if (!session.ok) {
+    log(session.message);
+    process.exitCode = 1;
+    return;
+  }
+
+  const { auth, status } = session;
+  const email = status.email || auth.email || auth.user || "unknown";
+  log(`${email} (${status.plan || auth.plan || "free"} plan)`);
+  if (status.usage_today) {
+    console.log("  Usage today:");
+    for (const [k, v] of Object.entries(status.usage_today))
+      console.log(`    ${k}: ${v} / ${status.limits[k]}`);
+  }
+  const license = status.license || auth.license || { status: "inactive" };
+  console.log(`  Activation: ${license.status || "inactive"}${license.activation_id ? ` (${license.activation_id})` : ""}`);
+  if (status.projects && status.projects.length) {
+    console.log(`  Projects bound: ${status.projects.length} / ${status.project_limit || "?"}`);
   }
 }
 
@@ -229,13 +262,19 @@ async function cmdActivateFree() {
 }
 
 async function cmdActivateStatus() {
-  const ensureAuthenticated = makeEnsureAuthenticated(cmdAuthLogin);
-  const status = await ensureAuthenticated("activation status");
-  const license = status.license || (await apiCall("/v1/licenses/status")).license || { status: "inactive" };
+  const session = await resolveSessionState();
+  if (!session.ok) {
+    log(session.message);
+    process.exitCode = 1;
+    return;
+  }
+
+  const licenseResult = await apiCall("/v1/licenses/status");
+  const license = licenseResult.license || session.status.license || session.auth.license || { status: "inactive" };
   updateAuthState({ license });
   log(`license ${license.status || "inactive"}`);
   if (license.activation_id) console.log(`  activation id: ${license.activation_id}`);
-  console.log(`  plan: ${license.plan || status.plan || "free"}`);
+  console.log(`  plan: ${license.plan || session.status.plan || session.auth.plan || "free"}`);
 }
 
-module.exports = { cmdAuthLogin, cmdAuthLogout, cmdRedeem, cmdAuthStatus, cmdActivateFree, cmdActivateStatus };
+module.exports = { cmdAuthLogin, cmdAuthLogout, cmdRedeem, cmdAuthStatus, cmdActivateFree, cmdActivateStatus, resolveSessionState };

package/lib/commands/doctor.js

@@ -2,7 +2,7 @@
 const shared = require("../shared");
 const { log, T, R, D, fs, path, spawnSync, findRepoScript, SUPPORTED_CLIS, recordExperienceEvent } = shared;
 
-function cmdDoctor(target) {
+function cmdDoctor(target, options = {}) {
   const ai = path.join(target, "ai");
   if (!fs.existsSync(ai)) { log("No 0dai config found. Run: 0dai init"); return; }
   let v = "?", stack = "generic";
@@ -108,6 +108,36 @@ function cmdDoctor(target) {
     console.log(`    ${mark.padEnd(22)} ${c.name}${hint}`);
   }
 
+  console.log("\n  provider profiles:");
+  try {
+    const providerScript = findRepoScript(target, "provider_profiles.py");
+    if (!providerScript) {
+      console.log(`    ${D}—${R2}       unavailable in this environment`);
+    } else {
+      const pr = spawnSync(
+        "python3",
+        [providerScript, "status", "--target", target, "--json"],
+        { stdio: ["ignore", "pipe", "ignore"], encoding: "utf8", timeout: 5000 },
+      );
+      if (pr.stdout) {
+        const payload = JSON.parse(pr.stdout);
+        const bindings = payload.bindings && typeof payload.bindings === "object" ? payload.bindings : {};
+        const resolved = Object.entries(bindings).filter(([, profileId]) => Boolean(profileId));
+        if (!resolved.length) {
+          console.log(`    ${D}—${R2}       no provider profiles bound`);
+        } else {
+          for (const [agent, profileId] of resolved.sort((a, b) => a[0].localeCompare(b[0]))) {
+            console.log(`    ${G}ok${R2}      ${agent} ${D}→ ${profileId}${R2}`);
+          }
+        }
+      } else {
+        console.log(`    ${D}—${R2}       no provider profiles bound`);
+      }
+    }
+  } catch {
+    console.log(`    ${D}—${R2}       unable to resolve provider profile status`);
+  }
+
   // --- agent CLIs check ---
   const { execFileSync: _ef2 } = require("child_process");
   let updatesAvailable = 0;
@@ -172,23 +202,39 @@ function cmdDoctor(target) {
       review_needed: warnings > 0,
     },
   });
-  if (errors) process.exitCode = 1;
+  if (errors && !options.suppressExitCode) process.exitCode = 1;
 
   // Drift summary (lightweight — full report via --drift flag)
-  try {
-    const ds = findRepoScript(target, "drift_detector.py");
-    if (ds) {
-      const dr = spawnSync("python3", [ds, "report", "--target", target],
-                           { stdio: ["ignore", "pipe", "ignore"], encoding: "utf8", timeout: 5000 });
-      if (dr.stdout && dr.stdout.includes("MODIFIED")) {
-        const lines = dr.stdout.trim().split("\n");
-        const driftCount = lines.filter(l => l.includes("MODIFIED") || l.includes("CONTRADICTS")).length;
-        if (driftCount > 0) {
-          console.log(`\n  config drift: ${driftCount} issue(s) — run: 0dai doctor --drift`);
+  if (!options.drift) {
+    try {
+      const ds = findRepoScript(target, "drift_detector.py");
+      if (ds) {
+        const dr = spawnSync("python3", [ds, "report", "--target", target],
+                             { stdio: ["ignore", "pipe", "ignore"], encoding: "utf8", timeout: 5000 });
+        if (dr.stdout && dr.stdout.includes("MODIFIED")) {
+          const lines = dr.stdout.trim().split("\n");
+          const driftCount = lines.filter(l => l.includes("MODIFIED") || l.includes("CONTRADICTS")).length;
+          if (driftCount > 0) {
+            console.log(`\n  config drift: ${driftCount} issue(s) — run: 0dai doctor --drift`);
+          }
         }
       }
+    } catch {}
+  }
+
+  // --fix: auto-repair by running sync
+  if (process.argv.includes("--fix") && errors) {
+    console.log(`\n  ${G}auto-fix:${R2} running 0dai sync to regenerate missing files...`);
+    try {
+      const { cmdSync } = require("./init");
+      cmdSync(target, ["--quiet"]);
+    } catch (e) {
+      console.log(`  ${E}auto-fix failed:${R2} ${e.message}`);
+      console.log(`  ${D}Run manually: 0dai sync${R2}`);
     }
-  } catch {}
+  } else if (errors) {
+    console.log(`\n  ${D}Tip: run 0dai doctor --fix to auto-repair${R2}`);
+  }
 }
 
 module.exports = { cmdDoctor };

package/lib/commands/init.js

@@ -4,9 +4,10 @@ const {
   T, R, D, log,
   fs, path,
   VERSION, SUPPORTED_CLIS,
-  apiCall, makeEnsureAuthenticated, ensureLicenseActivation,
+  apiCall, makeEnsureAuthenticated, ensureLicenseActivation, loadAuthState,
   collectMetadata, buildProjectIdentity, registerProject,
-  writeFiles, writeManagedFiles, sendProjectHeartbeat, recordExperienceEvent,
+  writeFiles, sendProjectHeartbeat, recordExperienceEvent,
+  logFirstRunSuccess,
 } = shared;
 const { cmdAuthLogin } = require("./auth");
 
@@ -42,6 +43,20 @@ async function cmdInit(target, args = []) {
     return;
   }
 
+  // Pre-check: verify init quota before starting wizard (avoid 10 min wizard → "limit reached")
+  if (!dryRun) {
+    try {
+      const precheck = await apiCall("/v1/projects/precheck", {
+        device_id: shared.deviceFingerprint(),
+      });
+      if (precheck.error && precheck.error.includes("limit")) {
+        log(`${precheck.error}`);
+        if (precheck.hint) console.log(`  ${D}${precheck.hint}${R}`);
+        return;
+      }
+    } catch {}
+  }
+
   // First-run wizard (unless --no-wizard or non-interactive)
   if (!noWizard && !dryRun && !minimal) {
     try {
@@ -150,9 +165,9 @@ async function cmdInit(target, args = []) {
   }
   console.log(`  ${D}3.${R} Open dashboard: ${D}https://0dai.dev/dashboard${R}`);
 
-  await sendProjectHeartbeat(identity, result, {
+  const heartbeat = await sendProjectHeartbeat(target, identity, result, {
     project_id: boundProject.project_id || identity.project_id,
-  }).catch(() => {});
+  }).catch(() => null);
   recordExperienceEvent(target, {
     event_type: "config_generated",
     agent: "cli",
@@ -162,6 +177,20 @@ async function cmdInit(target, args = []) {
     context: { stack: result.stack || identity.stack || "unknown", files_touched: Number(result.file_count || 0), tests_passed: true },
   });
 
+  // First-run proof gate (issue #342). All 4 gates pass once we reach here:
+  // license active (line above), project bound, ai/ layer written, heartbeat sent.
+  // Idempotent — only fires once per project. See docs/first-run.md.
+  const firstRun = logFirstRunSuccess(target, {
+    license: true,
+    project_bound: true,
+    layer_written: true,
+    heartbeat: !!heartbeat && !heartbeat.error,
+  });
+  if (firstRun.fired) {
+    const suffix = typeof firstRun.elapsedS === "number" ? ` (${firstRun.elapsedS}s)` : "";
+    console.log(`  ${D}first-run gate: success${suffix}${R}`);
+  }
+
   // Send anonymous usage ping
   apiCall("/v1/feedback", { report: {
     stack_detected: result.stack || "?", _auto: true, _plan: result.plan || "trial",
@@ -173,7 +202,6 @@ async function cmdSync(target, args = []) {
   const dryRun = args.includes("--dry-run");
   const quiet = args.includes("--quiet") || args.includes("-q");
   const force = args.includes("--force");
-  const updateTemplates = args.includes("--update-templates");
 
   // Quick local check: skip API if already at current version (unless dry-run or force)
   let version = "unknown";
@@ -181,8 +209,6 @@ async function cmdSync(target, args = []) {
 
   const metadata = collectMetadata(target);
   const { manifestContents, clis } = metadata;
-  const authStatus = await ensureAuthenticated("sync");
-  const license = await ensureLicenseActivation();
   let stack = "generic", agents = [];
   try {
     const d = JSON.parse(fs.readFileSync(path.join(target, "ai", "manifest", "discovery.json"), "utf8"));
@@ -190,6 +216,28 @@ async function cmdSync(target, args = []) {
     agents = d.selected_agents || [];
   } catch {}
   const identity = buildProjectIdentity(target, metadata, stack);
+
+  if (dryRun) {
+    const auth = loadAuthState();
+    const hasAuth = !!(auth && (auth.api_key || auth.access_token || auth.token));
+    if (!hasAuth) {
+      const preview = buildLocalSyncPreview(target, { version, stack, cliVersion: VERSION });
+      log(`${D}dry-run: local preview without auth (exact cloud plan unavailable)${R}`);
+      console.log(`  stack: ${preview.stack}`);
+      console.log(`  ai version: ${preview.current_version} ${preview.version_matches ? `${D}(matches CLI ${preview.cli_version})${R}` : `${D}(CLI ${preview.cli_version})${R}`}`);
+      if (preview.changes.length) {
+        console.log("  likely changes:");
+        for (const change of preview.changes) console.log(`    ~ ${change}`);
+      } else {
+        console.log(`  ${D}no obvious local drift found${R}`);
+      }
+      console.log(`  ${D}Run: 0dai auth login for exact managed diff and write-mode sync${R}`);
+      return;
+    }
+  }
+
+  const authStatus = await ensureAuthenticated("sync");
+  const license = await ensureLicenseActivation();
   const boundProject = await bindProjectForCloud(target, metadata, identity);
 
   // Collect current ai/ files
@@ -213,12 +261,11 @@ async function cmdSync(target, args = []) {
 
   if (dryRun) log(`${D}dry-run: checking what sync would change...${R}`);
   if (force && !dryRun) log(`${T}force mode: will overwrite native configs from ai/ source${R}`);
-  if (updateTemplates && !dryRun) log(`${T}template update mode: will refresh managed native configs from latest templates${R}`);
 
   const result = await apiCall("/v1/sync", {
     ai_version: version, stack, agents: agents.length ? agents : clis,
     current_files: currentFiles, manifest_contents: manifestContents,
-    dry_run: dryRun, quiet, force, update_templates: updateTemplates,
+    dry_run: dryRun, quiet, force,
     project_name: identity.project_name,
     project_id: boundProject.project_id || identity.project_id,
     remote_origin: identity.remote_origin,
@@ -241,9 +288,6 @@ async function cmdSync(target, args = []) {
     } else {
       log(`${D}dry-run: nothing to update${R}`);
     }
-    if (result.template_update_available) {
-      console.log(`  ${D}template update available: run 0dai sync --update-templates${R}`);
-    }
     return;
   }
   const changedCount = Object.keys(updated).length;
@@ -258,18 +302,13 @@ async function cmdSync(target, args = []) {
     log("already up to date");
   }
 
-  if (result.template_update_available && !updateTemplates && !quiet) {
-    console.log(`  ${D}Template update available: run 0dai sync --update-templates to refresh managed native configs${R}`);
-  }
-
   // --force: also overwrite native configs (CLAUDE.md, AGENTS.md, etc.) from ai/ source
   if (force && result.native_configs) {
+    const NATIVE_CONFIGS = ["CLAUDE.md", "AGENTS.md", "GEMINI.md", "opencode.json", ".cursorrules", ".windsurfrules", ".aider.conf.yml"];
     let overwritten = 0;
-    for (const [name, content] of Object.entries(result.native_configs)) {
-      const targetPath = path.join(target, name);
-      fs.mkdirSync(path.dirname(targetPath), { recursive: true });
-      if (content) {
-        fs.writeFileSync(targetPath, content, "utf8");
+    for (const name of NATIVE_CONFIGS) {
+      if (result.native_configs[name]) {
+        fs.writeFileSync(path.join(target, name), result.native_configs[name], "utf8");
         overwritten++;
         if (!quiet) console.log(`  [force] ${name} overwritten from ai/ source`);
       }
@@ -277,11 +316,6 @@ async function cmdSync(target, args = []) {
     if (overwritten && !quiet) {
       log(`force: ${overwritten} native config file(s) overwritten`);
     }
-  } else if (updateTemplates && result.native_configs) {
-    writeManagedFiles(target, result.native_configs);
-    if (!quiet) {
-      log("template update: managed native configs refreshed");
-    }
   }
 
   // --force: update drift baseline hashes so drift clears after regeneration
@@ -311,7 +345,7 @@ async function cmdSync(target, args = []) {
 
   // Update portfolio registry
   registerProject(target, path.basename(target), stack);
-  await sendProjectHeartbeat(identity, result, {
+  await sendProjectHeartbeat(target, identity, result, {
     project_id: boundProject.project_id || identity.project_id,
   }).catch(() => {});
   recordExperienceEvent(target, {
@@ -324,4 +358,58 @@ async function cmdSync(target, args = []) {
   });
 }
 
-module.exports = { cmdInit, cmdSync };
+function buildLocalSyncPreview(target, { version, stack, cliVersion }) {
+  const changes = [];
+  const expectedAiFiles = [
+    "ai/VERSION",
+    "ai/manifest/project.yaml",
+    "ai/manifest/commands.yaml",
+    "ai/manifest/discovery.json",
+  ];
+  for (const rel of expectedAiFiles) {
+    if (!fs.existsSync(path.join(target, rel))) changes.push(`${rel} (missing)`);
+  }
+
+  if (version !== "unknown" && version !== cliVersion) {
+    changes.push(`ai/VERSION (${version} -> ${cliVersion})`);
+  }
+
+  const driftTracked = [
+    "CLAUDE.md",
+    "AGENTS.md",
+    "GEMINI.md",
+    "opencode.json",
+    ".cursorrules",
+    ".windsurfrules",
+    ".aider.conf.yml",
+  ];
+  const hashesPath = path.join(target, "ai", "manifest", "config_hashes.json");
+  try {
+    const hashes = JSON.parse(fs.readFileSync(hashesPath, "utf8"));
+    const crypto = require("crypto");
+    for (const rel of driftTracked) {
+      const filePath = path.join(target, rel);
+      const recorded = hashes[rel];
+      const exists = fs.existsSync(filePath) && fs.statSync(filePath).isFile();
+      if (recorded && !exists) changes.push(`${rel} (missing from workspace)`);
+      if (recorded && exists) {
+        const currentHash = crypto.createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+        if (currentHash !== String(recorded.hash || "")) changes.push(`${rel} (local edits)`);
+      }
+    }
+  } catch {}
+
+  if (!fs.existsSync(path.join(target, "ai"))) {
+    changes.push("ai/ layer missing — run 0dai init after auth");
+  }
+
+  return {
+    stack,
+    current_version: version,
+    cli_version: cliVersion,
+    version_matches: version === cliVersion,
+    changes,
+  };
+}
+
+module.exports = { cmdInit, cmdSync, buildLocalSyncPreview };

package/lib/commands/models.js

@@ -1,6 +1,11 @@
 "use strict";
 const shared = require("../shared");
-const { T, R } = shared;
+const { T, R, SUPPORTED_CLIS } = shared;
+const {
+  probeInstalledCliNames,
+  summarizeModelAvailability,
+  formatAvailableFooter,
+} = require("../utils/model_ratings");
 
 function cmdModels(filter) {
   // Scores from benchmark_models.py (3-task: read/count/review, 2026-04-06)
@@ -23,34 +28,35 @@ function cmdModels(filter) {
     { name: "MiniMax M2.5",      tier: "slow",     score: 57, cli: "opencode", flag: "-m opencode-go/minimax-m2.5",   tested: true },
   ];
 
-  const { execFileSync } = require("child_process");
-  const available = new Set();
-  for (const cli of ["claude", "codex", "opencode", "gemini", "aider"]) {
-    try { execFileSync("/bin/sh", ["-c", `command -v ${cli}`], { stdio: "ignore" }); available.add(cli); } catch {}
-  }
+  const installedCliNames = probeInstalledCliNames(SUPPORTED_CLIS);
+  const availability = summarizeModelAvailability(MODELS, SUPPORTED_CLIS, installedCliNames);
 
   const isTTY = process.stdout.isTTY;
   const Y  = isTTY ? "\x1b[33m" : "";
   const G  = isTTY ? "\x1b[32m" : "";
   const DIM = isTTY ? "\x1b[2m" : "";
 
-  let models = [...MODELS].sort((a, b) => b.score - a.score);
+  const allModels = [...MODELS].sort((a, b) => b.score - a.score);
+  let models = [...allModels];
   if (filter === "--fast")      models = models.filter(m => m.tier === "fast");
   if (filter === "--balanced")  models = models.filter(m => m.tier === "balanced");
   if (filter === "--deep")      models = models.filter(m => m.tier === "deep");
-  if (filter === "--available") models = models.filter(m => available.has(m.cli));
+  if (filter === "--available") models = models.filter(m => installedCliNames.has(m.cli));
 
   const tc = (t) => t === "deep" ? T : t === "balanced" ? G : DIM;
   console.log(`\n  ${T}0dai${R} model ratings — ${models.length} models\n`);
   console.log(`  ${"SCORE".padEnd(6)} ${"MODEL".padEnd(22)} ${"TIER".padEnd(10)} ${"CLI".padEnd(10)} FLAG`);
   console.log(`  ${"-".repeat(64)}`);
   for (const m of models) {
-    const dim = available.has(m.cli) ? "" : DIM;
+    const dim = installedCliNames.has(m.cli) ? "" : DIM;
     const mark = m.tested ? ` ${G}✓${R}` : "";
     console.log(`${dim}  ${Y}${String(m.score).padEnd(6)}${R} ${m.name.padEnd(22)} ${tc(m.tier)}${m.tier.padEnd(10)}${R} ${m.cli.padEnd(10)} ${DIM}${m.flag}${R}${mark}${dim ? R : ""}`);
   }
   console.log(`\n  ${DIM}✓ = swarm-benchmarked  |  dimmed = CLI not installed${R}`);
   console.log(`  ${DIM}Filter: --fast  --balanced  --deep  --available${R}`);
+  if (filter === "--available") {
+    console.log(`  ${DIM}${formatAvailableFooter(availability, models.length)}${R}`);
+  }
   console.log(`  ${DIM}Full table: https://0dai.dev/models${R}\n`);
 }
 

package/lib/commands/persona-simulate.js

@@ -0,0 +1,19 @@
+"use strict";
+const shared = require("../shared");
+const { log, D, R, spawnSync, findRepoScript } = shared;
+
+function cmdPersonaSimulate(target, args) {
+  const script = findRepoScript(target, "persona_simulate.py");
+  if (!script) {
+    log("persona-simulate unavailable in this environment");
+    console.log(`  ${D}Expected scripts/persona_simulate.py in repo checkout${R}`);
+    process.exit(1);
+  }
+
+  const forwarded = [script, ...args, "--target", target];
+  const result = spawnSync("python3", forwarded, { stdio: "inherit" });
+  if (typeof result.status === "number") process.exit(result.status);
+  process.exit(1);
+}
+
+module.exports = { cmdPersonaSimulate };

package/lib/commands/provider.js

@@ -0,0 +1,18 @@
+"use strict";
+
+const shared = require("../shared");
+const { log, spawnSync, findRepoScript } = shared;
+
+function cmdProvider(target, args) {
+  const script = findRepoScript(target, "provider_profiles.py");
+  if (!script) {
+    log("provider profiles unavailable in this environment");
+    process.exit(1);
+  }
+  const forwarded = [script, ...args];
+  const result = spawnSync("python3", forwarded, { stdio: "inherit" });
+  if (typeof result.status === "number") process.exit(result.status);
+  process.exit(1);
+}
+
+module.exports = { cmdProvider };