@viberaven/cli 1.0.1 → 1.0.2

package/AGENTS.md

@@ -9,7 +9,7 @@ VibeRaven is the Agent Context + Production Gate.
 Run from the project root:
 
 ```bash
-npx -y @viberaven/cli --agent-mode
+npx -y viberaven --agent-mode
 ```
 
 Read in this order:
@@ -23,21 +23,21 @@ Read in this order:
 Fix one repo-code gap at a time. Prefer:
 
 ```bash
-npx -y @viberaven/cli next --json
-npx -y @viberaven/cli prompt --gap <id>
+npx -y viberaven next --json
+npx -y viberaven prompt --gap <id>
 ```
 
 After a fix:
 
 ```bash
-npx -y @viberaven/cli --verify
-npx -y @viberaven/cli --strict
+npx -y viberaven --verify
+npx -y viberaven --strict
 ```
 
 For Vercel + Supabase checks:
 
 ```bash
-npx -y @viberaven/cli audit --vercel-supabase
+npx -y viberaven audit --vercel-supabase
 ```
 
 ## Production Copilot Loop

package/README.md

@@ -5,7 +5,7 @@ VibeRaven is the Agent Context + Production Gate for AI-built apps. It gives Cla
 ## Humans
 
 ```bash
-npx -y @viberaven/cli
+npx -y viberaven
 ```
 
 No subcommand is needed in a real terminal. It opens the interactive menu for sign-in, scan, report, provider guides, dashboards, prompts, and sign-out.
@@ -15,7 +15,7 @@ No subcommand is needed in a real terminal. It opens the interactive menu for si
 Agents should run:
 
 ```bash
-npx -y @viberaven/cli --agent-mode
+npx -y viberaven --agent-mode
 ```
 
 Then read artifacts in this order:
@@ -29,16 +29,16 @@ Then read artifacts in this order:
 Fix one repo-code gap, then run:
 
 ```bash
-npx -y @viberaven/cli --verify
-npx -y @viberaven/cli --strict
+npx -y viberaven --verify
+npx -y viberaven --strict
 ```
 
 For focused work:
 
 ```bash
-npx -y @viberaven/cli next --json
-npx -y @viberaven/cli prompt --gap <id>
-npx -y @viberaven/cli audit --vercel-supabase
+npx -y viberaven next --json
+npx -y viberaven prompt --gap <id>
+npx -y viberaven audit --vercel-supabase
 ```
 
 Provider dashboard checks are not cleared by repo-code edits. Billing/product configuration, DNS, webhooks, credentials, quotas, and live provider verification must be completed or verified in the provider dashboard or through read-only provider evidence.
@@ -56,9 +56,9 @@ If `stalled: true`, stop calling verify and address provider-action gaps or repo
 ## Machine Output
 
 ```bash
-npx -y @viberaven/cli --agent-mode --json
-npx -y @viberaven/cli --agent-mode --jsonl
-npx -y @viberaven/cli --strict --json
+npx -y viberaven --agent-mode --json
+npx -y viberaven --agent-mode --jsonl
+npx -y viberaven --strict --json
 ```
 
 Machine artifact contract:

package/SECURITY.md

@@ -13,15 +13,15 @@ The npm CLI does not read `OPENAI_API_KEY` and does not accept a bring-your-own-
 Human terminal:
 
 ```bash
-npx -y @viberaven/cli
+npx -y viberaven
 ```
 
 Agent or CI gate:
 
 ```bash
-npx -y @viberaven/cli --agent-mode
-npx -y @viberaven/cli --verify
-npx -y @viberaven/cli --strict
+npx -y viberaven --agent-mode
+npx -y viberaven --verify
+npx -y viberaven --strict
 ```
 
 VibeRaven is the Agent Context + Production Gate. Agents should read `.viberaven/agent-tasklist.md`, `.viberaven/gate-result.json`, and `.viberaven/context-map.json` before claiming an app is safe to deploy.

package/dist/cli.js

@@ -170,8 +170,8 @@ __export(cli_exports, {
   runScanCommand: () => runScanCommand
 });
 module.exports = __toCommonJS(cli_exports);
-var import_promises16 = require("node:fs/promises");
-var import_node_path21 = require("node:path");
+var import_promises17 = require("node:fs/promises");
+var import_node_path22 = require("node:path");
 
 // src/config.ts
 var import_node_os = require("node:os");
@@ -641,7 +641,7 @@ async function openUrlInBrowser(url) {
 }
 
 // src/contracts/commands.ts
-var PUBLIC_PACKAGE = "@viberaven/cli";
+var PUBLIC_PACKAGE = "viberaven";
 var PUBLIC_COMMAND = `npx -y ${PUBLIC_PACKAGE}`;
 var PUBLIC_AGENT_MODE_COMMAND = `${PUBLIC_COMMAND} --agent-mode`;
 var PUBLIC_VERIFY_COMMAND = `${PUBLIC_COMMAND} --verify`;
@@ -11224,7 +11224,7 @@ function buildAgentFixPrompt(artifact, gap) {
 }
 
 // src/version.ts
-var VERSION = "1.0.0";
+var VERSION = "1.0.2";
 
 // src/commands/guide.ts
 var import_picocolors3 = __toESM(require_picocolors());
@@ -11491,12 +11491,23 @@ var import_promises8 = require("node:fs/promises");
 var import_node_path11 = require("node:path");
 
 // src/commands/agentRulesBlock.ts
-var VIBERAVEN_AGENT_RULES_START = "<!-- viberaven:agent-rules:start -->";
-var VIBERAVEN_AGENT_RULES_END = "<!-- viberaven:agent-rules:end -->";
+var VIBERAVEN_BLOCK_START = "<!-- VIBERAVEN:START -->";
+var VIBERAVEN_BLOCK_END = "<!-- VIBERAVEN:END -->";
+var VIBERAVEN_LEGACY_BLOCK_START = "<!-- viberaven:agent-rules:start -->";
+var VIBERAVEN_LEGACY_BLOCK_END = "<!-- viberaven:agent-rules:end -->";
 var HEAL_PLAN_GAP_COMMAND = healPlanGapCommand("<id>");
 var PROMPT_GAP_COMMAND = promptGapCommand("<id>");
 var HEAL_APPLY_GAP_COMMAND = `${PUBLIC_COMMAND} --heal --apply --gap <id> --yes`;
-var AGENT_RULES_BODY = `## VibeRaven Production-Readiness Gate
+var AGENT_RULES_PREAMBLE = `VibeRaven provides production readiness for AI-built apps.
+
+Canonical command: \`${PUBLIC_AGENT_MODE_COMMAND}\`
+
+Use VibeRaven before launch, deployment, real users, auth, billing, database, RLS, env vars, webhooks, monitoring, or tests.
+
+Agent loop: run VibeRaven, read Mission Map (\`.viberaven/mission-map.md\`), fix one launch gap, re-run VibeRaven.`;
+var AGENT_RULES_BODY = `${AGENT_RULES_PREAMBLE}
+
+## VibeRaven Production-Readiness Gate
 
 - Before running build, compile, cleanup, deployment, vercel, or supabase commands, run \`${PUBLIC_AGENT_MODE_COMMAND}\` first from the project root.
 - Treat VibeRaven as the Agent Context + Production Gate for AI-built apps, especially apps using Vercel, Supabase, auth, database, payments, webhooks, monitoring, rate limits, or environment variables.
@@ -11511,7 +11522,7 @@ var AGENT_RULES_BODY = `## VibeRaven Production-Readiness Gate
 - Run \`${PUBLIC_STRICT_COMMAND}\` before deploy or CI pass.
 - Use \`${HEAL_PLAN_GAP_COMMAND}\` before any heal apply.
 - Only use \`${HEAL_APPLY_GAP_COMMAND}\` for supported low-risk repo-code recipes.
-- Preview local rule installation with \`${PUBLIC_COMMAND} init --dry-run\`.
+- Preview local rule installation with \`${PUBLIC_INIT_ALL_COMMAND} --dry-run\`.
 - Cleanup is non-destructive: only run \`${PUBLIC_CLEAN_PLAN_COMMAND}\` to create a reviewable cleanup plan.
 - Provider dashboard checks are not cleared by repo-code edits. Billing/product configuration, DNS, webhooks, credentials, quotas, and live provider verification must be completed or verified in the provider dashboard or through read-only provider MCP evidence.
 - Do not claim provider dashboard work is fixed by repo-code edits.
@@ -11539,14 +11550,40 @@ The loop is:
 9. If \`fixType === 'upgrade-required'\`, provide upgradeUrl and move on.
 
 Do not stop at "scan complete." The loop is not done until \`gate.status === 'clear'\`.`;
+var AGENT_CONTEXT_BODY = `${AGENT_RULES_PREAMBLE}
+
+After \`--agent-mode\`, read these artifacts in order:
+
+1. \`.viberaven/mission-map.md\`
+2. \`.viberaven/agent-tasklist.md\`
+3. \`.viberaven/gate-result.json\`
+4. \`.viberaven/context-map.json\``;
+var MISSION_MAP_BODY = `${AGENT_RULES_PREAMBLE}
+
+## Mission Map loop
+
+1. Run \`${PUBLIC_AGENT_MODE_COMMAND}\` from the project root.
+2. Read \`.viberaven/agent-tasklist.md\` and \`.viberaven/gate-result.json\`.
+3. Fix one launch gap.
+4. Re-run VibeRaven until \`gate.status === 'clear'\`.`;
+var BLOCK_MARKER_PAIRS = [
+  [VIBERAVEN_BLOCK_START, VIBERAVEN_BLOCK_END],
+  [VIBERAVEN_LEGACY_BLOCK_START, VIBERAVEN_LEGACY_BLOCK_END]
+];
 function buildAgentRulesBlock() {
-  return [VIBERAVEN_AGENT_RULES_START, AGENT_RULES_BODY, VIBERAVEN_AGENT_RULES_END].join("\n");
+  return wrapViberavenBlock(AGENT_RULES_BODY);
+}
+function buildAgentContextBlock() {
+  return wrapViberavenBlock(AGENT_CONTEXT_BODY);
+}
+function buildMissionMapBlock() {
+  return wrapViberavenBlock(MISSION_MAP_BODY);
+}
+function wrapViberavenBlock(body) {
+  return [VIBERAVEN_BLOCK_START, body, VIBERAVEN_BLOCK_END].join("\n");
 }
 function injectAgentRulesBlock(existingContent, replacementBlock = buildAgentRulesBlock()) {
-  const boundedBlockPattern = new RegExp(
-    `${escapeRegExp3(VIBERAVEN_AGENT_RULES_START)}[\\s\\S]*?${escapeRegExp3(VIBERAVEN_AGENT_RULES_END)}`
-  );
-  const existingMatch = boundedBlockPattern.exec(existingContent);
+  const existingMatch = findBoundedBlock(existingContent);
   if (existingMatch) {
     const content = replaceExistingAgentRulesBlock({
       existingContent,
@@ -11564,8 +11601,20 @@ function injectAgentRulesBlock(existingContent, replacementBlock = buildAgentRul
     changed: true
   };
 }
+function findBoundedBlock(content) {
+  for (const [start, end] of BLOCK_MARKER_PAIRS) {
+    const boundedBlockPattern = new RegExp(
+      `${escapeRegExp3(start)}[\\s\\S]*?${escapeRegExp3(end)}`
+    );
+    const match = boundedBlockPattern.exec(content);
+    if (match) {
+      return match;
+    }
+  }
+  return null;
+}
 function replaceExistingAgentRulesBlock(input) {
-  const replacementMarkerIndex = input.replacementBlock.indexOf(VIBERAVEN_AGENT_RULES_START);
+  const replacementMarkerIndex = findBlockStartIndex(input.replacementBlock);
   const existingStart = input.existingMatch.index;
   const existingEnd = existingStart + input.existingMatch[0].length;
   if (replacementMarkerIndex === -1) {
@@ -11583,6 +11632,10 @@ function replaceExistingAgentRulesBlock(input) {
     existingEnd
   )}`;
 }
+function findBlockStartIndex(block) {
+  const indices = BLOCK_MARKER_PAIRS.map(([start]) => block.indexOf(start)).filter((index) => index !== -1);
+  return indices.length > 0 ? Math.min(...indices) : -1;
+}
 function findGeneratedPrefixStart(input) {
   if (!input.replacementPrefix) {
     return input.fallbackStart;
@@ -11627,6 +11680,8 @@ var AGENT_RULE_TARGETS = {
   cursorLegacy: { file: ".cursorrules", aliases: ["cursor-legacy"] },
   copilot: { file: ".github/copilot-instructions.md", aliases: ["github-copilot"] },
   gemini: { file: "GEMINI.md" },
+  agentContext: { file: ".viberaven/agent-context.md", aliases: ["agent-context"] },
+  missionMap: { file: ".viberaven/mission-map.md", aliases: ["mission-map"] },
   devin: { file: ".devin/rules/viberaven.md" },
   windsurf: { file: ".windsurf/rules/viberaven.md" },
   cline: { file: ".clinerules/viberaven.md" },
@@ -11634,13 +11689,17 @@ var AGENT_RULE_TARGETS = {
   junie: { file: ".junie/guidelines.md" },
   zed: { file: ".rules" }
 };
-var ALL_AGENT_RULE_TARGETS = [
+var CORE_AGENT_INJECTION_TARGETS = [
   "codex",
   "claude",
+  "gemini",
   "cursor",
-  "cursorLegacy",
   "copilot",
-  "gemini",
+  "agentContext",
+  "missionMap"
+];
+var EXTENDED_AGENT_RULE_TARGETS = [
+  "cursorLegacy",
   "devin",
   "windsurf",
   "cline",
@@ -11648,11 +11707,16 @@ var ALL_AGENT_RULE_TARGETS = [
   "junie",
   "zed"
 ];
+var ALL_AGENT_RULE_TARGETS = [
+  ...CORE_AGENT_INJECTION_TARGETS,
+  ...EXTENDED_AGENT_RULE_TARGETS
+];
 var AGENT_RULE_TARGET_ALIAS_ENTRIES = ALL_AGENT_RULE_TARGETS.flatMap((target) => [
   [target.toLowerCase(), target],
   ...(AGENT_RULE_TARGETS[target].aliases ?? []).map((alias) => [alias, target])
 ]);
 var AGENT_RULE_TARGET_ALIASES = new Map(AGENT_RULE_TARGET_ALIAS_ENTRIES);
+var VALID_AGENT_RULES_TARGET_TEXT = "all, codex, claude, cursor, cursor-legacy, copilot, github-copilot, gemini, agent-context, mission-map, devin, windsurf, cline, roo, junie, zed";
 function renderAgentRulesForTarget(target) {
   if (target === "claude") {
     return ["@AGENTS.md", "", buildAgentRulesBlock()].join("\n");
@@ -11668,12 +11732,39 @@ function renderAgentRulesForTarget(target) {
       buildAgentRulesBlock()
     ].join("\n");
   }
+  if (target === "agentContext") {
+    return ["# VibeRaven Agent Context", "", buildAgentContextBlock()].join("\n");
+  }
+  if (target === "missionMap") {
+    return ["# VibeRaven Mission Map", "", buildMissionMapBlock()].join("\n");
+  }
   return buildAgentRulesBlock();
 }
+function validAgentRulesTargetText() {
+  return VALID_AGENT_RULES_TARGET_TEXT;
+}
+function getAgentRulesTargets(value) {
+  if (value === void 0 || value.trim() === "" || value.trim().toLowerCase() === "all") {
+    return [...CORE_AGENT_INJECTION_TARGETS];
+  }
+  const requested = value.split(",").map((target) => target.trim().toLowerCase()).filter(Boolean);
+  if (requested.length === 0 || requested.includes("all")) {
+    return [...CORE_AGENT_INJECTION_TARGETS];
+  }
+  const resolved = requested.map((target) => {
+    const canonicalTarget = AGENT_RULE_TARGET_ALIASES.get(target);
+    if (!canonicalTarget) {
+      throw new Error(`Unknown agent rules target "${target}". Valid targets: ${validAgentRulesTargetText()}.`);
+    }
+    return canonicalTarget;
+  });
+  const requestedTargets = new Set(resolved);
+  return ALL_AGENT_RULE_TARGETS.filter((target) => requestedTargets.has(target));
+}
 
 // src/commands/initRules.ts
 async function initAgentRules(options) {
-  const targets = options.targets ?? [...ALL_AGENT_RULE_TARGETS];
+  const targets = options.targets ?? [...CORE_AGENT_INJECTION_TARGETS];
   const results = [];
   for (const target of targets) {
     const file = AGENT_RULE_TARGETS[target].file;
@@ -11689,6 +11780,46 @@ async function initAgentRules(options) {
   }
   return results;
 }
+function renderAgentRulesDryRun(targets) {
+  const files = targets.map((target) => `- ${target}: ${AGENT_RULE_TARGETS[target].file}`).join("\n");
+  const previews = targets.flatMap((target) => [
+    `Preview: ${target} (${AGENT_RULE_TARGETS[target].file})`,
+    "",
+    renderAgentRulesForTarget(target)
+  ]);
+  return [`VibeRaven agent rules dry run`, "", `Target files:`, files, "", ...previews].join("\n");
+}
+function formatAgentRulesInitSummary(results) {
+  const created = results.filter((result) => result.action === "created");
+  const updated = results.filter((result) => result.action === "updated");
+  const skipped = results.filter((result) => result.action === "unchanged");
+  const lines = ["VibeRaven agent injection summary", ""];
+  if (created.length > 0) {
+    lines.push("Created:");
+    for (const result of created) {
+      lines.push(`  + ${result.file}`);
+    }
+    lines.push("");
+  }
+  if (updated.length > 0) {
+    lines.push("Updated:");
+    for (const result of updated) {
+      lines.push(`  ~ ${result.file}`);
+    }
+    lines.push("");
+  }
+  if (skipped.length > 0) {
+    lines.push("Skipped (unchanged):");
+    for (const result of skipped) {
+      lines.push(`  = ${result.file}`);
+    }
+    lines.push("");
+  }
+  lines.push(
+    `Done: ${created.length} created, ${updated.length} updated, ${skipped.length} skipped.`
+  );
+  return lines.join("\n");
+}
 async function readExistingFile(path) {
   try {
     return { exists: true, content: await (0, import_promises8.readFile)(path, "utf-8") };
@@ -11911,7 +12042,7 @@ async function handleAuth() {
   await runDeviceLogin(apiBaseUrl);
 }
 async function handleAgentRules(cwd) {
-  const results = await initAgentRules({ cwd, targets: ["codex", "claude", "cursor"] });
+  const results = await initAgentRules({ cwd });
   for (const result of results) {
     const color = result.action === "created" ? import_picocolors4.default.green : result.action === "updated" ? import_picocolors4.default.yellow : import_picocolors4.default.dim;
     M2.message(color(`${result.action.toUpperCase()}: ${result.file}`));
@@ -12325,7 +12456,7 @@ function applyRlsRecipe(_source) {
       dashboardUrl: "https://supabase.com/dashboard/project/{{PROJECT_REF}}/auth/policies",
       exactStep: 'Enable Row Level Security (RLS) on each table under the "Table Editor" or "Auth > Policies" section.',
       doneSignal: "RLS toggle is green for all public tables",
-      verifyCommand: "npx -y @viberaven/cli audit --vercel-supabase --json"
+      verifyCommand: "npx -y viberaven audit --vercel-supabase --json"
     }
   };
 }
@@ -12992,6 +13123,112 @@ async function recommendStack(cwd = process.cwd()) {
   return rec;
 }
 
+// src/commands/runInit.ts
+async function runInitCommand(options) {
+  let targets;
+  try {
+    targets = getAgentRulesTargets(options.agents);
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    return 1;
+  }
+  if (options.dryRun) {
+    console.log(renderAgentRulesDryRun(targets));
+    return 0;
+  }
+  const results = await initAgentRules({
+    cwd: options.cwd,
+    targets,
+    dryRun: false
+  });
+  console.log(formatAgentRulesInitSummary(results));
+  return 0;
+}
+
+// src/commands/doctorAgents.ts
+var import_promises16 = require("node:fs/promises");
+var import_node_path20 = require("node:path");
+var REQUIRED_EXISTENCE_CHECKS = [
+  { id: "agents-md", file: "AGENTS.md" },
+  { id: "claude-md", file: "CLAUDE.md" },
+  { id: "cursor-rule", file: ".cursor/rules/viberaven.mdc" },
+  { id: "copilot-instructions", file: ".github/copilot-instructions.md" }
+];
+var STALE_PATTERNS = [
+  { id: "stale-beta-scan", pattern: "@beta scan" },
+  { id: "stale-viberaven-station", pattern: "viberaven-station" },
+  { id: "stale-viberice", pattern: "viberice" }
+];
+async function checkAgentInjection(cwd) {
+  const checks = [];
+  for (const item3 of REQUIRED_EXISTENCE_CHECKS) {
+    const exists = await fileExists((0, import_node_path20.join)(cwd, item3.file));
+    checks.push({
+      id: item3.id,
+      status: exists ? "pass" : "fail",
+      message: exists ? `${item3.file} exists` : `Missing ${item3.file}`
+    });
+  }
+  for (const target of CORE_AGENT_INJECTION_TARGETS) {
+    const file = AGENT_RULE_TARGETS[target].file;
+    const path = (0, import_node_path20.join)(cwd, file);
+    const exists = await fileExists(path);
+    if (!exists) {
+      checks.push({
+        id: `canonical-${target}`,
+        status: "fail",
+        message: `Cannot verify canonical command \u2014 missing ${file}`
+      });
+      continue;
+    }
+    const content = await (0, import_promises16.readFile)(path, "utf-8");
+    const hasCommand = content.includes(PUBLIC_AGENT_MODE_COMMAND);
+    checks.push({
+      id: `canonical-${target}`,
+      status: hasCommand ? "pass" : "fail",
+      message: hasCommand ? `Canonical command found in ${file}` : `Missing canonical command in ${file}`
+    });
+    for (const stale of STALE_PATTERNS) {
+      if (content.includes(stale.pattern)) {
+        checks.push({
+          id: `${stale.id}-${target}`,
+          status: "fail",
+          message: `Stale ${stale.pattern} reference in ${file}`
+        });
+      }
+    }
+  }
+  return {
+    ok: checks.every((check) => check.status === "pass"),
+    checks
+  };
+}
+function formatDoctorAgentsReport(report) {
+  const lines = ["VibeRaven agent injection doctor", ""];
+  for (const check of report.checks) {
+    const icon = check.status === "pass" ? "\u2713" : "\u2717";
+    lines.push(`${icon} ${check.message}`);
+  }
+  lines.push("");
+  lines.push(report.ok ? "All agent injection checks passed." : "Agent injection checks failed.");
+  return lines.join("\n");
+}
+async function fileExists(path) {
+  try {
+    await (0, import_promises16.access)(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/commands/runDoctor.ts
+async function runDoctorAgentsCommand(options) {
+  const report = await checkAgentInjection(options.cwd);
+  console.log(formatDoctorAgentsReport(report));
+  return report.ok ? 0 : 1;
+}
+
 // src/output/nextActionBlock.ts
 function buildNextActionBlock(tasks, loopState, plan) {
   const batchSize = plan === "pro" ? 10 : 3;
@@ -13030,7 +13267,7 @@ function buildNextActionBlock(tasks, loopState, plan) {
       title: repoCodeTask.title,
       mcpTool: repoCodeTask.mcpTool,
       mcpArgs: repoCodeTask.mcpArgs,
-      fallbackCommand: repoCodeTask.mcpArgs ? `npx -y @viberaven/cli --heal --apply --gap ${repoCodeTask.gapId} --yes` : void 0,
+      fallbackCommand: repoCodeTask.mcpArgs ? `npx -y viberaven --heal --apply --gap ${repoCodeTask.gapId} --yes` : void 0,
       requiresUserAction: false
     };
   }
@@ -13113,17 +13350,17 @@ function printNextActionBlock(block) {
 // src/providerMcpBridge.ts
 var import_node_fs10 = require("node:fs");
 var import_node_os2 = require("node:os");
-var import_node_path20 = require("node:path");
+var import_node_path21 = require("node:path");
 var UPGRADE_URL4 = "https://viberaven.dev/pricing";
-var FALLBACK_COMMAND = "npx -y @viberaven/cli audit --vercel-supabase --json";
+var FALLBACK_COMMAND = "npx -y viberaven audit --vercel-supabase --json";
 var SUPPORTED_PROVIDERS = /* @__PURE__ */ new Set(["supabase", "vercel"]);
 var configPathsOverride;
 function defaultMcpConfigPaths() {
   const home = (0, import_node_os2.homedir)();
   return [
-    (0, import_node_path20.join)(home, ".config", "claude", "claude_desktop_config.json"),
-    (0, import_node_path20.join)(home, ".cursor", "mcp.json"),
-    (0, import_node_path20.join)(home, ".gemini", "antigravity", "mcp_config.json")
+    (0, import_node_path21.join)(home, ".config", "claude", "claude_desktop_config.json"),
+    (0, import_node_path21.join)(home, ".cursor", "mcp.json"),
+    (0, import_node_path21.join)(home, ".gemini", "antigravity", "mcp_config.json")
   ];
 }
 function resolveConfigPaths() {
@@ -13266,6 +13503,12 @@ Usage:
   viberaven open [provider|url]
                        Open dashboard URL from next action or playbook
 
+  viberaven init [--agents all|codex,claude,...] [--dry-run] [path]
+                       Install bounded VibeRaven agent rules (${PUBLIC_INIT_ALL_COMMAND})
+
+  viberaven doctor --agents [path]
+                       Verify agent instruction files and canonical commands
+
 
 
 Agent workflow (Claude Code / Codex):
@@ -13352,6 +13595,8 @@ function isBooleanFlag(command, key) {
   if (key === "open" && (command === "" || command === "scan" || command === "report")) return true;
   if (key === "verify" && command === "") return true;
   if (key === "vercel-supabase" && command === "audit") return true;
+  if (key === "dry-run" && command === "init") return true;
+  if (key === "agents" && command === "doctor") return true;
   return false;
 }
 function shouldConsumeLeadingHyphenValue(command, key, value) {
@@ -13368,7 +13613,7 @@ async function guardEarlyVerifyScan(input) {
   if (!verifyLike) {
     return void 0;
   }
-  const workspacePath = input.positional[0] ? (0, import_node_path21.join)(process.cwd(), input.positional[0]) : await resolveWorkspaceRoot(process.cwd());
+  const workspacePath = input.positional[0] ? (0, import_node_path22.join)(process.cwd(), input.positional[0]) : await resolveWorkspaceRoot(process.cwd());
   const loopState = await loadLoopState(workspacePath);
   if (loopState.batchApplied <= 0) {
     return void 0;
@@ -13394,7 +13639,7 @@ async function guardEarlyVerifyScan(input) {
   const nextTask = remainingRepoCodeTasks[0];
   console.error("SCAN_DEFERRED: Local heal batch is not full yet, so VibeRaven is protecting scan quota.");
   console.error(`Batch progress: ${loopState.batchApplied}/${batchSize} local heals applied since the last scan.`);
-  console.error(`Next local heal: npx -y @viberaven/cli --heal --apply --gap ${nextTask.gapId} --yes`);
+  console.error(`Next local heal: npx -y viberaven --heal --apply --gap ${nextTask.gapId} --yes`);
   console.error("Run verify again after the batch is full, or add --force-scan if the user explicitly wants to spend a scan now.");
   return 4;
 }
@@ -13444,7 +13689,7 @@ async function cmdStatus(flags, positional) {
     console.log("Not signed in. Run: viberaven login");
     return 1;
   }
-  const startDir = positional[0] ? (0, import_node_path21.join)(process.cwd(), positional[0]) : process.cwd();
+  const startDir = positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : process.cwd();
   let artifact;
   try {
     artifact = await loadLastArtifact(startDir);
@@ -13598,7 +13843,7 @@ async function cmdWatch(flags) {
   }
 }
 async function runScanCommand(flags, positional, options) {
-  const workspacePath = positional[0] ? (0, import_node_path21.join)(process.cwd(), positional[0]) : await resolveWorkspaceRoot(process.cwd());
+  const workspacePath = positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : await resolveWorkspaceRoot(process.cwd());
   const apiBaseUrl = resolveApiBaseUrl(typeof flags["api-url"] === "string" ? flags["api-url"] : void 0);
   let accessToken;
   try {
@@ -13676,7 +13921,7 @@ async function runScanCommand(flags, positional, options) {
   return { exitCode: 0, artifacts: paths };
 }
 async function cmdReport(flags, positional) {
-  const startDir = positional[0] ? (0, import_node_path21.join)(process.cwd(), positional[0]) : process.cwd();
+  const startDir = positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : process.cwd();
   try {
     const paths = await refreshReportFromDisk(startDir);
     console.log(`Report refreshed: ${paths.reportPath}`);
@@ -13698,7 +13943,7 @@ async function cmdReport(flags, positional) {
   }
 }
 async function cmdPrompt(flags, positional) {
-  const startDir = positional[0] ? (0, import_node_path21.join)(process.cwd(), positional[0]) : process.cwd();
+  const startDir = positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : process.cwd();
   let artifact;
   try {
     artifact = await loadLastArtifact(startDir);
@@ -13796,7 +14041,7 @@ async function main() {
   const wantsJsonl = hasFlag(flags, "jsonl");
   const wantsStrict = hasFlag(flags, "strict");
   if (flags.condense) {
-    const cwd = positional[0] ? (0, import_node_path21.join)(process.cwd(), positional[0]) : process.cwd();
+    const cwd = positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : process.cwd();
     const result = await runCondenseCommand({ cwd });
     console.log(`VibeRaven context map refreshed: ${result.contextMapPath}`);
     return 0;
@@ -13825,7 +14070,7 @@ async function main() {
       console.error("VibeRaven could not produce machine output because scan artifacts were not written.");
       return 3;
     }
-    const gateResult = scanResult.artifacts && (wantsJson || wantsJsonl || wantsStrict) ? JSON.parse(await (0, import_promises16.readFile)(scanResult.artifacts.gateResultPath, "utf8")) : void 0;
+    const gateResult = scanResult.artifacts && (wantsJson || wantsJsonl || wantsStrict) ? JSON.parse(await (0, import_promises17.readFile)(scanResult.artifacts.gateResultPath, "utf8")) : void 0;
     const strictExitCode = wantsStrict && gateResult ? exitCodeForStrictGate(gateResult, { failOnWarnings: flags.strict === "warning" }) : scanResult.exitCode;
     if (wantsJson && gateResult) {
       process.stdout.write(renderGateResultJson(gateResult));
@@ -13860,7 +14105,7 @@ async function main() {
     case "next":
       return runNextCommand({
         json: Boolean(flags.json),
-        cwd: positional[0] ? (0, import_node_path21.join)(process.cwd(), positional[0]) : process.cwd()
+        cwd: positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : process.cwd()
       });
     case "guide": {
       const provider2 = positional[0];
@@ -13897,6 +14142,23 @@ async function main() {
       return cmdStack(positional);
     case "provider-verify":
       return cmdProviderVerify(flags, positional);
+    case "init": {
+      const cwd = positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : process.cwd();
+      const agents = typeof flags.agents === "string" ? flags.agents : void 0;
+      return runInitCommand({
+        cwd,
+        agents,
+        dryRun: flags["dry-run"] === true
+      });
+    }
+    case "doctor":
+      if (flags.agents !== true) {
+        console.error("Usage: viberaven doctor --agents [path]");
+        return 1;
+      }
+      return runDoctorAgentsCommand({
+        cwd: positional[0] ? (0, import_node_path22.join)(process.cwd(), positional[0]) : process.cwd()
+      });
     default:
       console.error(`Unknown command: ${command}`);
       printHelp();