@viberaven/cli 0.1.0-beta.7 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +78 -88
- package/README.md +69 -82
- package/SECURITY.md +52 -36
- package/assets/report/station.js +8319 -0
- package/dist/cli.js +4535 -4569
- package/dist/cli.js.map +4 -4
- package/dist/report/station.js +8319 -0
- package/package.json +16 -7
- package/templates/AGENTS.snippet.md +43 -39
- package/templates/CLAUDE.snippet.md +16 -0
- package/templates/CURSOR.snippet.md +16 -0
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@viberaven/cli",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "1.0.1",
|
|
4
|
+
"description": "Production-readiness scan for AI-built apps: auth, billing, database, deployment, monitoring, launch gaps, and agent-ready fixes.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"author": "VibeRaven",
|
|
7
7
|
"homepage": "https://viberaven.dev",
|
|
@@ -16,15 +16,23 @@
|
|
|
16
16
|
"keywords": [
|
|
17
17
|
"viberaven",
|
|
18
18
|
"launch-readiness",
|
|
19
|
+
"production-readiness",
|
|
20
|
+
"launch-gaps",
|
|
21
|
+
"ai-built-apps",
|
|
22
|
+
"agent-mode",
|
|
23
|
+
"mcp",
|
|
19
24
|
"claude-code",
|
|
20
25
|
"codex",
|
|
21
26
|
"cursor",
|
|
22
27
|
"ai",
|
|
23
|
-
"production"
|
|
28
|
+
"production",
|
|
29
|
+
"supabase",
|
|
30
|
+
"vercel",
|
|
31
|
+
"stripe"
|
|
24
32
|
],
|
|
25
33
|
"publishConfig": {
|
|
26
34
|
"access": "public",
|
|
27
|
-
"tag": "
|
|
35
|
+
"tag": "latest"
|
|
28
36
|
},
|
|
29
37
|
"bin": {
|
|
30
38
|
"viberaven": "dist/cli.js"
|
|
@@ -43,10 +51,11 @@
|
|
|
43
51
|
"dev": "node scripts/build.mjs && node dist/cli.js",
|
|
44
52
|
"typecheck": "tsc -p tsconfig.json",
|
|
45
53
|
"demo-report": "node scripts/demo-report.mjs --open",
|
|
46
|
-
"verify:
|
|
47
|
-
"verify:
|
|
54
|
+
"verify:release:smoke": "npm run build && node scripts/verify-beta-flow.mjs --smoke",
|
|
55
|
+
"verify:release:live": "npm run build && node scripts/verify-beta-flow.mjs --live",
|
|
48
56
|
"test": "vitest run",
|
|
49
|
-
"prepublishOnly": "npm run sync-report-assets && npm run typecheck && npm run test && npm run build"
|
|
57
|
+
"prepublishOnly": "npm run sync-report-assets && npm run check:agent-discovery && npm run typecheck && npm run test && npm run build",
|
|
58
|
+
"check:agent-discovery": "node scripts/check-agent-discovery.mjs"
|
|
50
59
|
},
|
|
51
60
|
"engines": {
|
|
52
61
|
"node": ">=20"
|
|
@@ -1,47 +1,51 @@
|
|
|
1
|
-
## VibeRaven
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
3. Read `.viberaven/agent-summary.md` and `.viberaven/launch-playbook.md`
|
|
19
|
-
4. `npx -y @viberaven/cli@beta next --json` — one action at a time
|
|
20
|
-
5. If type=repo-fix: implement, then `viberaven report` (free) or `scan` (uses quota)
|
|
21
|
-
6. If type=provider-guide: `viberaven guide <provider> --step N` and `viberaven open <provider>`
|
|
22
|
-
7. Repeat 4–6 until done; `viberaven status --json` before each new scan
|
|
23
|
-
|
|
24
|
-
Also available:
|
|
25
|
-
|
|
26
|
-
- `.viberaven/last-scan.json` — full mission map + gaps
|
|
27
|
-
- `.viberaven/report.html` — visual map for the user (use `scan --open` when the user wants the browser map)
|
|
28
|
-
|
|
29
|
-
Free plan: 2 lifetime scans, 6/12 mission map lanes. Pro: 50 scans/month, all 12 lanes.
|
|
30
|
-
|
|
31
|
-
If browser opening fails, show the printed `Open:` URL to the user. After approval, rerun:
|
|
1
|
+
## VibeRaven Launch Readiness
|
|
2
|
+
|
|
3
|
+
VibeRaven is the Agent Context + Production Gate.
|
|
4
|
+
|
|
5
|
+
Use VibeRaven when the user asks if their AI-built app is production-ready, launch-ready, safer to deploy, or what is missing before ship.
|
|
6
|
+
|
|
7
|
+
### Humans
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npx -y @viberaven/cli
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
In a real terminal, this opens the interactive VibeRaven menu.
|
|
14
|
+
|
|
15
|
+
### Agents
|
|
16
|
+
|
|
17
|
+
Paste this into your coding agent:
|
|
32
18
|
|
|
33
19
|
```bash
|
|
34
|
-
npx -y @viberaven/cli
|
|
20
|
+
npx -y @viberaven/cli --agent-mode
|
|
35
21
|
```
|
|
36
22
|
|
|
37
|
-
|
|
23
|
+
1. Run `npx -y @viberaven/cli --agent-mode` from the project root.
|
|
24
|
+
2. If VibeRaven prints `LOGIN_URL_READY`, open that exact URL for the user. Say: "I opened VibeRaven sign-in so you can approve access; I will continue after approval." Do not ask for passwords, tokens, cookies, or secrets. Keep the terminal alive while the user approves.
|
|
25
|
+
If the scan flow cannot start login, run `npx -y @viberaven/cli login`.
|
|
26
|
+
3. Read `.viberaven/agent-tasklist.md` first, `.viberaven/gate-result.json` for the machine verdict, and `.viberaven/context-map.json` for compact agent context. If the tasklist says `CRITICAL GAPS DETECTED` or `PRODUCTION GATE NOT CLEAR`, fix one listed repo-code gap before deploy.
|
|
27
|
+
4. Read `.viberaven/agent-summary.md` second for scan context.
|
|
28
|
+
5. Read `.viberaven/launch-playbook.md` third for the full checklist.
|
|
29
|
+
6. Use `npx -y @viberaven/cli next --json` or `npx -y @viberaven/cli prompt --gap <id>` for one focused repo-code fix. Local installs can use `viberaven prompt`.
|
|
30
|
+
7. For Vercel + Supabase, run `npx -y @viberaven/cli audit --vercel-supabase` and check RLS, service role exposure, and Supabase pooler port 6543 instead of runtime port 5432.
|
|
31
|
+
8. Do not claim provider dashboard checks are fixed by repo-code edits.
|
|
32
|
+
9. Verify with tests/build, then run `npx -y @viberaven/cli --verify`.
|
|
33
|
+
|
|
34
|
+
Before deploy or CI pass:
|
|
38
35
|
|
|
39
36
|
```bash
|
|
40
|
-
npx -y @viberaven/cli
|
|
37
|
+
npx -y @viberaven/cli --strict
|
|
41
38
|
```
|
|
42
39
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
40
|
+
Also available:
|
|
41
|
+
|
|
42
|
+
- `.viberaven/last-scan.json` - full mission map and gaps
|
|
43
|
+
- `.viberaven/report.html` - visual map for the user
|
|
44
|
+
- `npx -y @viberaven/cli init --dry-run` - preview local agent rules
|
|
45
|
+
- `npx -y @viberaven/cli clean --plan` - write a non-destructive cleanup plan
|
|
46
|
+
|
|
47
|
+
Free plan: 2 lifetime scans, 6/12 mission map lanes. Pro: 50 scans/month, all 12 lanes.
|
|
48
|
+
|
|
49
|
+
Same VibeRaven account and scan quota as the VS Code extension.
|
|
50
|
+
|
|
51
|
+
Security: the CLI does not read `OPENAI_API_KEY`. Scans use VibeRaven login and the managed API; your model key stays server-side.
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
<!-- viberaven:agent-rules:start -->
|
|
2
|
+
## VibeRaven Agent Rules
|
|
3
|
+
|
|
4
|
+
VibeRaven is the Agent Context + Production Gate.
|
|
5
|
+
|
|
6
|
+
- When production readiness, launch readiness, Vercel, Supabase, auth, database, payments, monitoring, deployment, rate limits, or error handling comes up, run `npx -y @viberaven/cli --agent-mode` from the project root.
|
|
7
|
+
- Read `.viberaven/agent-tasklist.md` first, `.viberaven/gate-result.json` for the machine verdict, and `.viberaven/context-map.json` for compact agent context.
|
|
8
|
+
- Read `.viberaven/agent-summary.md` before editing code.
|
|
9
|
+
- Read `.viberaven/launch-playbook.md` before editing code.
|
|
10
|
+
- Use `npx -y @viberaven/cli next --json` or `npx -y @viberaven/cli prompt --gap <id>` for one focused repo-code fix at a time.
|
|
11
|
+
- Run `npx -y @viberaven/cli --verify` after one fix.
|
|
12
|
+
- Run `npx -y @viberaven/cli --strict` before deploy or CI pass.
|
|
13
|
+
- For Vercel + Supabase launch checks, run `npx -y @viberaven/cli audit --vercel-supabase`.
|
|
14
|
+
- Do not claim provider dashboard work is fixed by repo-code edits. Provider dashboard checks, billing/product configuration, DNS, webhooks, credentials, quotas, and live provider verification must be completed or verified in the provider dashboard.
|
|
15
|
+
- If VibeRaven prints `LOGIN_URL_READY`, open that URL for the user using the available browser tool or system browser. Tell the user: "I opened VibeRaven sign-in so you can approve access; I will continue after approval." Do not ask for passwords, tokens, cookies, or secrets. Keep the terminal process alive while the user approves.
|
|
16
|
+
<!-- viberaven:agent-rules:end -->
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
<!-- viberaven:agent-rules:start -->
|
|
2
|
+
## VibeRaven Agent Rules
|
|
3
|
+
|
|
4
|
+
VibeRaven is the Agent Context + Production Gate.
|
|
5
|
+
|
|
6
|
+
- When production readiness, launch readiness, Vercel, Supabase, auth, database, payments, monitoring, deployment, rate limits, or error handling comes up, run `npx -y @viberaven/cli --agent-mode` from the project root.
|
|
7
|
+
- Read `.viberaven/agent-tasklist.md` first, `.viberaven/gate-result.json` for the machine verdict, and `.viberaven/context-map.json` for compact agent context.
|
|
8
|
+
- Read `.viberaven/agent-summary.md` before editing code.
|
|
9
|
+
- Read `.viberaven/launch-playbook.md` before editing code.
|
|
10
|
+
- Use `npx -y @viberaven/cli next --json` or `npx -y @viberaven/cli prompt --gap <id>` for one focused repo-code fix at a time.
|
|
11
|
+
- Run `npx -y @viberaven/cli --verify` after one fix.
|
|
12
|
+
- Run `npx -y @viberaven/cli --strict` before deploy or CI pass.
|
|
13
|
+
- For Vercel + Supabase launch checks, run `npx -y @viberaven/cli audit --vercel-supabase`.
|
|
14
|
+
- Do not claim provider dashboard work is fixed by repo-code edits. Provider dashboard checks, billing/product configuration, DNS, webhooks, credentials, quotas, and live provider verification must be completed or verified in the provider dashboard.
|
|
15
|
+
- If VibeRaven prints `LOGIN_URL_READY`, open that URL for the user using the available browser tool or system browser. Tell the user: "I opened VibeRaven sign-in so you can approve access; I will continue after approval." Do not ask for passwords, tokens, cookies, or secrets. Keep the terminal process alive while the user approves.
|
|
16
|
+
<!-- viberaven:agent-rules:end -->
|