@0dai-dev/cli 4.0.0 → 4.2.0

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, 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",
@@ -172,15 +201,14 @@ async function cmdInit(target, args = []) {
 async function cmdSync(target, args = []) {
   const dryRun = args.includes("--dry-run");
   const quiet = args.includes("--quiet") || args.includes("-q");
+  const force = args.includes("--force");
 
-  // Quick local check: skip API if already at current version (unless dry-run)
+  // Quick local check: skip API if already at current version (unless dry-run or force)
   let version = "unknown";
   try { version = fs.readFileSync(path.join(target, "ai", "VERSION"), "utf8").trim(); } catch {}
 
   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"));
@@ -188,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
@@ -210,11 +260,12 @@ 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}`);
 
   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,
+    dry_run: dryRun, quiet, force,
     project_name: identity.project_name,
     project_id: boundProject.project_id || identity.project_id,
     remote_origin: identity.remote_origin,
@@ -250,6 +301,34 @@ async function cmdSync(target, args = []) {
   } else {
     log("already up to date");
   }
+
+  // --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 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`);
+      }
+    }
+    if (overwritten && !quiet) {
+      log(`force: ${overwritten} native config file(s) overwritten`);
+    }
+  }
+
+  // --force: update drift baseline hashes so drift clears after regeneration
+  if (force) {
+    try {
+      const { spawnSync } = require("child_process");
+      const driftScript = path.join(target, "scripts", "drift_detector.py");
+      if (fs.existsSync(driftScript)) {
+        spawnSync("python3", [driftScript, "record", "--target", target], { stdio: "inherit" });
+      }
+    } catch {}
+  }
+
   if (!quiet) {
     console.log(`  account: ${authStatus.email} · plan: ${authStatus.plan || license.plan || "free"} · activation: ${license.status}`);
     console.log(`  project: ${boundProject.project_id || identity.project_id}`);
@@ -266,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, {
@@ -279,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,35 +28,69 @@ 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`);
 }
 
-module.exports = { cmdModels };
+async function cmdModelsRecommend(target, args) {
+  const shared = require("../shared");
+  const { log, T, R, D, findRepoScript, spawnSync, requirePlan } = shared;
+
+  const gate = requirePlan("pro", "Model Recommend", target);
+  if (gate) { log(gate.error); log(gate.hint); return; }
+
+  const taskType = args.find((_, i) => args[i - 1] === "--task") || "";
+  const goal = args.find((_, i) => args[i - 1] === "--goal") || "";
+  const maxCost = parseFloat(args.find((_, i) => args[i - 1] === "--max-cost") || "0");
+  const minQuality = parseFloat(args.find((_, i) => args[i - 1] === "--min-quality") || "0");
+  const asJson = args.includes("--json");
+
+  if (!taskType && !goal) {
+    console.log("Usage: 0dai models recommend --task TYPE [--goal '...'] [--max-cost N] [--min-quality N] [--json]");
+    console.log("  TYPE: feat, fix, refactor, test, docs");
+    return;
+  }
+
+  const recScript = findRepoScript(target, "model_router.py");
+  if (!recScript) { log("model router unavailable"); return; }
+
+  const fwd = [recScript, "recommend", "--target", target];
+  if (taskType) fwd.push("--task", taskType);
+  if (goal) fwd.push("--goal", goal);
+  if (maxCost > 0) fwd.push("--max-cost", String(maxCost));
+  if (minQuality > 0) fwd.push("--min-quality", String(minQuality));
+  if (asJson) fwd.push("--json");
+
+  const result = spawnSync("python3", fwd, { stdio: "inherit" });
+  if (typeof result.status === "number" && result.status !== 0) process.exit(result.status);
+}
+
+module.exports = { cmdModels, cmdModelsRecommend };

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 };