@viberaven/cli 0.1.0-beta.0 → 0.1.0-beta.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viberaven/cli",
-  "version": "0.1.0-beta.0",
+  "version": "0.1.0-beta.2",
   "description": "VibeRaven launch readiness for Claude Code, Codex, and terminal agents — scan, map, and agent-ready prompts.",
   "license": "UNLICENSED",
   "author": "VibeRaven",
@@ -31,10 +31,13 @@
   },
   "files": [
     "dist",
+    "assets/report",
     "AGENTS.md",
+    "SECURITY.md",
     "templates"
   ],
   "scripts": {
+    "sync-report-assets": "node scripts/sync-report-assets.mjs",
     "build": "node scripts/build.mjs",
     "dev": "node scripts/build.mjs && node dist/cli.js",
     "typecheck": "tsc -p tsconfig.json",
@@ -42,11 +45,15 @@
     "verify:beta:smoke": "npm run build && node scripts/verify-beta-flow.mjs --smoke",
     "verify:beta:live": "npm run build && node scripts/verify-beta-flow.mjs --live",
     "test": "vitest run",
-    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+    "prepublishOnly": "npm run sync-report-assets && npm run typecheck && npm run test && npm run build"
   },
   "engines": {
     "node": ">=20"
   },
+  "dependencies": {
+    "@clack/prompts": "^0.10.1",
+    "picocolors": "^1.1.1"
+  },
   "devDependencies": {
     "esbuild": "^0.25.0",
     "typescript": "^5.8.0",

package/templates/AGENTS.snippet.md

@@ -1,23 +1,54 @@
 ## VibeRaven launch readiness (CLI)
 
-When the user asks if their AI-built app is production-ready, launch-ready, or what is missing before ship:
+### For humans
 
 ```bash
+npx -y @viberaven/cli@beta login
 npx -y @viberaven/cli@beta scan --open
 ```
 
-If not signed in, run `npx -y @viberaven/cli@beta login` first (browser device approval).
+Sign in once, then scan with `--open` to view the report in your browser.
+
+### For agents (Claude Code, Codex, Cursor)
+
+When the user asks if their AI-built app is production-ready, launch-ready, or what is missing before ship:
+
+1. If not signed in: `npx -y @viberaven/cli@beta login` (browser device approval, once)
+2. `npx -y @viberaven/cli@beta scan` — agents do not need `--open`
+3. Read `.viberaven/agent-summary.md` — briefing for you
+4. `npx -y @viberaven/cli@beta prompt` — copy-ready prompt for the top gap
+5. Implement in the repo
+6. `npx -y @viberaven/cli@beta scan` — verify readiness improved
 
-Then read:
+Also available:
 
-- `.viberaven/agent-summary.md` — briefing for you
 - `.viberaven/last-scan.json` — full mission map + gaps
-- `.viberaven/report.html` — visual map for the user
+- `.viberaven/report.html` — visual map for the user (use `scan --open` when the user wants the browser map)
 
-Fix loop:
+Repeat steps 4–6 until critical gaps are resolved.
+
+If scan output says `LOGIN_REQUIRED`, stop and ask the user to complete:
+
+```bash
+npx -y @viberaven/cli@beta login
+```
 
-1. `npx -y @viberaven/cli@beta prompt` — copy-ready prompt for the top gap
-2. Implement in the repo
-3. `npx -y @viberaven/cli@beta scan` — verify readiness improved
+Then rerun:
+
+```bash
+npx -y @viberaven/cli@beta scan
+```
+
+Stable scan labels:
+
+- `READY` — scan finished; read `.viberaven/agent-summary.md` before changing code.
+- `LOGIN_REQUIRED` — stop and ask the user to complete login.
+- `UPGRADE_REQUIRED` — stop; the user must upgrade or wait for quota reset.
+- `MANUAL_ACTION_REQUIRED` — provider dashboard, billing, DNS, webhook, MCP, or live verification needs user/provider action.
+- `ERROR` — report the error and retry only when the cause is clear.
+
+Run `viberaven prompt` or `viberaven prompt --gap <id>` for repo-code fixes.
+
+Do not claim human-provider actions as repo-code fixes. Human-provider actions include dashboard setup, billing/product configuration, DNS, webhooks, provider credentials, quota upgrades, and read-only MCP/provider-live verification.
 
 Same VibeRaven account and scan quota as the VS Code extension.