@0dai-dev/cli 4.4.1 → 4.4.3

package/lib/commands/init.js

@@ -696,8 +696,8 @@ async function cmdInit(target, args = []) {
   console.log(`  ${D}1.${R} Check health:  ${D}0dai doctor${R}`);
   if (agents.length > 0) {
     const a = agents[0];
-    console.log(`  ${D}2.${R} Try delegation: ${D}0dai run "write tests for auth"${R}`);
-    console.log(`     ${D}(${agents.join(", ")} detected — delegation will use ${a} by default)${R}`);
+    console.log(`  ${D}2.${R} Run a task now: ${D}0dai run "write tests for auth" --now${R}`);
+    console.log(`     ${D}(${agents.join(", ")} detected — runs ${a} locally and prints a scored receipt; drop --now to just queue)${R}`);
   } else {
     console.log(`  ${D}2.${R} Install an agent CLI to enable delegation:`);
     console.log(`     ${D}claude:${R} npm i -g @anthropic-ai/claude-code  ${D}(or Pro subscription)${R}`);

package/lib/commands/run.js

@@ -1,6 +1,17 @@
 "use strict";
 const shared = require("../shared");
-const { log, T, R, D, fs, path, apiCall } = shared;
+const { log, T, R, D, fs, path, apiCall, spawnSync } = shared;
+
+// Best-effort git read: returns trimmed stdout, or null when not a git repo /
+// git missing. Never throws — safety output degrades silently outside git.
+function _git(target, args) {
+  try {
+    const r = spawnSync("git", args, { cwd: target, encoding: "utf8", timeout: 5000, stdio: ["ignore", "pipe", "ignore"] });
+    return r && r.status === 0 ? (r.stdout || "").trim() : null;
+  } catch {
+    return null;
+  }
+}
 const {
   estimateRunCost,
   formatTokens,
@@ -164,13 +175,36 @@ async function cmdRun(goal, target, args = []) {
 // Execute the just-queued tasks locally (synchronous), emit a scored receipt,
 // move drained task files queue→done, and record the executed activation outcome.
 function runNow(target, queueDir, entries, { goal, maxCost, costEstimateUsd, identity }) {
-  const { drainTasks } = require("../run/local_executor");
+  const { drainTasks, previewInvocation } = require("../run/local_executor");
   const { buildReceipt, writeReceipt, renderReceipt } = require("../run/scored_receipt");
 
+  // Safety snapshot BEFORE anything runs: capture the pre-run commit so the user
+  // has a one-line undo, and checkpoint any uncommitted work via `git stash
+  // create` (captures a dangling commit WITHOUT touching the working tree or the
+  // shared stash stack — never the destructive `git stash` that CLAUDE.md §3
+  // forbids). All best-effort: outside a git repo these are null and the run
+  // still proceeds.
+  const preSha = _git(target, ["rev-parse", "HEAD"]);
+  const dirty = preSha != null ? Boolean(_git(target, ["status", "--porcelain"])) : false;
+  // `git stash create` captures only TRACKED changes → returns "" for an
+  // untracked-only dirty tree. Coerce that to null so we never advertise a
+  // checkpoint that wasn't created (untracked files survive a reset anyway).
+  const checkpointSha = dirty ? (_git(target, ["stash", "create"]) || null) : null;
+
   console.log(
     `\n  ${T}Executing locally${R} ${D}(--now)${R} — running the assigned agent on this`
-    + ` repo now; it may modify files.\n`,
+    + ` repo now; it may modify files. Exact command(s):\n`,
   );
+  for (const e of entries) {
+    console.log(`    ${D}$ ${previewInvocation(e, { budgetUsd: maxCost })}${R}`);
+  }
+  if (preSha) {
+    let treeNote = " (clean)";
+    if (dirty && checkpointSha) treeNote = ` (dirty — tracked work checkpointed to ${checkpointSha.slice(0, 9)})`;
+    else if (dirty) treeNote = " (dirty — untracked files only; an undo leaves them in place)";
+    console.log(`    ${D}working tree @ ${preSha.slice(0, 9)}${treeNote}${R}`);
+  }
+  console.log("");
 
   const results = drainTasks(entries, {
     cwd: target,
@@ -189,11 +223,21 @@ function runNow(target, queueDir, entries, { goal, maxCost, costEstimateUsd, ide
   const file = writeReceipt(target, receipt);
   console.log(renderReceipt(receipt, { T, R, D }));
   if (file) {
-    console.log(`  ${D}receipt: ${path.relative(target, file)}${R}\n`);
+    console.log(`  ${D}receipt: ${path.relative(target, file)}${R}`);
   } else {
     log(`warn: could not persist run receipt to ai/meta/receipts/${runId}.json`);
   }
 
+  // Undo footer: the literal commands to inspect or reverse what the agent did.
+  if (preSha) {
+    console.log(`  ${D}inspect: git diff ${preSha.slice(0, 12)}   |   revert tracked changes: git reset --hard ${preSha.slice(0, 12)}${R}`);
+    console.log(`  ${D}(new files the agent added are kept by reset — 'git status' to see them)${R}`);
+    if (checkpointSha) {
+      console.log(`  ${D}restore your uncommitted work after a revert: git stash apply ${checkpointSha.slice(0, 12)}${R}`);
+    }
+  }
+  console.log("");
+
   // Move drained task files queue→done so `0dai watch` / `status` stay consistent.
   const doneDir = path.join(target, "ai", "swarm", "done");
   try { fs.mkdirSync(doneDir, { recursive: true }); } catch {}

package/lib/onboarding.js

@@ -44,6 +44,7 @@ function showWhatsNext(mode, isAuthed) {
   console.log("  \u2705 0dai initialized! Your AI agents are configured.");
   console.log("");
   console.log("  What's next:");
+  console.log("    \u2610 0dai run \"add a test for X\" --now  \u2014 run a task locally, get a scored receipt");
   console.log("    \u2610 0dai status     \u2014 check your config");
   console.log("    \u2610 0dai doctor     \u2014 verify everything works");
   if (mode === "local" && !isAuthed) {

package/lib/python/usage_ledger.py

@@ -53,7 +53,7 @@ FREE_TIER_LIMITS = {
 
 # Plan entitlements (mirrors tier_gate.py PLAN_LIMITS for task budgets).
 PLAN_ENTITLEMENTS = {
-    "free": {"daily_tasks": 0, "monthly_budget_usd": 0.0, "max_model_tier": "fast", "free_tier": FREE_TIER_LIMITS},
+    "free": {"daily_tasks": 1, "monthly_budget_usd": 0.0, "max_model_tier": "fast", "free_tier": FREE_TIER_LIMITS},
     "pro": {"daily_tasks": 50, "monthly_budget_usd": 15.0, "max_model_tier": "balanced"},
     "team": {"daily_tasks": 200, "monthly_budget_usd": 49.0, "max_model_tier": "deep"},
     "enterprise": {"daily_tasks": 999999, "monthly_budget_usd": 999999.0, "max_model_tier": "deep"},

package/lib/run/local_executor.js

@@ -73,6 +73,22 @@ function buildPrompt(task) {
   return lines.join("\n");
 }
 
+// Human-readable preview of the exact command `--now` will run, for the
+// pre-run transparency line. The prompt arg (long, multi-line) is collapsed to
+// a short quoted preview so a skeptic sees the literal binary + flags before any
+// agent touches their tree. Returns a note (not a throw) for unsupported agents.
+function previewInvocation(task, opts = {}) {
+  const agent = (task && task.assigned_to) || opts.defaultAgent || "claude";
+  const inv = buildInvocation(agent, buildPrompt(task || {}), { budgetUsd: opts.budgetUsd });
+  if (!inv) return `# no headless invocation for agent '${agent}' — task skipped`;
+  const args = inv.args.map((a) => {
+    const oneLine = String(a).replace(/\s+/g, " ").trim();
+    if (oneLine.length > 48) return `"${oneLine.slice(0, 45)}…"`;
+    return /\s/.test(oneLine) ? `"${oneLine}"` : oneLine;
+  });
+  return `${inv.bin} ${args.join(" ")}`;
+}
+
 // Default command runner — a thin wrapper over spawnSync so tests can inject a
 // fake. Signature: runner(bin, args, { cwd, timeoutMs }) -> spawnSync-like result.
 function defaultRunner(bin, args, opts = {}) {
@@ -216,6 +232,7 @@ function drainTasks(tasks, opts = {}) {
 module.exports = {
   buildInvocation,
   buildPrompt,
+  previewInvocation,
   executeTask,
   drainTasks,
   agentInstalled,

package/lib/utils/identity.js

@@ -322,15 +322,17 @@ function detectStackHint(projectFiles, manifestContents) {
   // Node deps fallback (#4493): when config files are absent, infer the stack from
   // package.json dependencies so an account-free `init --local` still gets a real stack
   // instead of "unknown". Order matters — react-native ships react, so it must win first.
+  let validPackageJson = false;
   if (manifestContents["package.json"]) {
     try {
       const pkg = JSON.parse(manifestContents["package.json"]);
+      validPackageJson = true;
       const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
       if (deps["react-native"] || deps.expo) return "react-native";
       if (deps.next) return "nextjs";
       if (deps.react || deps.vue || deps.svelte || deps["@angular/core"]) return "frontend";
       if (deps.express || deps.fastify || deps.koa || deps["@nestjs/core"] || deps["@hapi/hapi"]) return "backend-api";
-    } catch {}
+    } catch { validPackageJson = false; }
   }
 
   if (manifestContents["go.mod"]) return "go-service";
@@ -343,6 +345,15 @@ function detectStackHint(projectFiles, manifestContents) {
   }
 
   if (projectFiles.some((name) => name.startsWith("apps/") || name.startsWith("packages/"))) return "monorepo";
+
+  // Language floor (#4515 follow-up): a valid package.json with no framework, no
+  // go.mod / pyproject, and no monorepo layout is still unmistakably a Node
+  // project — label it "node", not "unknown". This matches the unconditional
+  // go.mod→go-service and pyproject→python-service floors above (a bare go/python
+  // project gets a language label; a bare Node lib/CLI must too). "node" is a real
+  // label the offline scaffold writes as-is; it is placed AFTER the go/python/
+  // monorepo checks so a polyglot repo still resolves to the more specific stack.
+  if (validPackageJson) return "node";
   return "unknown";
 }
 

package/lib/wizard.js

@@ -270,6 +270,7 @@ function stepNext(mode) {
   console.log("  ✅ 0dai is ready!");
   console.log("");
   console.log("  Try these commands:");
+  console.log("    0dai run \"...\" --now — run a task locally + get a scored receipt");
   console.log("    0dai status     — see your project config");
   console.log("    0dai doctor     — check config health");
   if (mode === "cloud") {
@@ -380,6 +381,7 @@ module.exports = {
   needsWizard,
   isInteractive,
   stepGenerate,
+  stepNext,
   detectLocalStack,
   detectProjectCommands,
   AGENTS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@0dai-dev/cli",
-  "version": "4.4.1",
+  "version": "4.4.3",
   "description": "One config layer for seven AI coding agents \u2014 Claude Code, Codex, OpenCode, Gemini, Aider, Qoder, Cursor",
   "bin": {
     "0dai": "./bin/0dai.js"