@viberaven/cli 1.2.2 → 1.2.3

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/README.md CHANGED
@@ -4,129 +4,85 @@
4
4
  [![npm downloads](https://img.shields.io/npm/dw/@viberaven/cli)](https://www.npmjs.com/package/@viberaven/cli)
5
5
  [![license](https://img.shields.io/npm/l/@viberaven/cli)](https://www.npmjs.com/package/@viberaven/cli)
6
6
 
7
- VibeRaven is the Agent Context + Production Gate for AI-built apps. It gives Claude Code, Codex, Cursor, and other coding agents a production-readiness loop before Vercel/Supabase deployment.
7
+ **VibeRaven Studio** — local-first open-source console for AI-built apps. Chat with your connected coding CLI, attach provider and release context, and work from localhost.
8
8
 
9
9
  Public repo: https://github.com/ohad6k/VibeRaven
10
10
 
11
- If VibeRaven helps, star the repo so more AI app builders find the production gate. Use Watch -> Custom -> Releases for release notifications.
12
-
13
- ## Humans
11
+ ## Run Studio
14
12
 
15
13
  ```bash
16
14
  npx -y viberaven
17
15
  ```
18
16
 
19
- 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.
17
+ Opens VibeRaven Studio on `localhost` in the current project:
20
18
 
21
- ## Coding Agents
19
+ - Connect **Codex CLI**, **Claude Code**, or **Gemini CLI** (your existing CLI account — no OpenAI API key in VibeRaven).
20
+ - **Terminal** tab: install → sign in → **Test connection** (chat only works after verify).
21
+ - **Chat** tab: scoped missions that can edit the repo (permission mode: ask each change or full access).
22
+ - Provider Control Board and Versions & Releases context for drag-to-chat.
22
23
 
23
- Agents should run:
24
+ Explicit UI command:
24
25
 
25
26
  ```bash
26
- npx -y viberaven --agent-mode
27
+ npx -y viberaven ui .
28
+ ```
29
+
30
+ ## Install agent rules (optional)
31
+
32
+ ```bash
33
+ npx -y viberaven init --agents all
27
34
  ```
28
35
 
29
- If running from the `viberaven` monorepo root, run:
36
+ Preview without writing files: `npx -y viberaven init --agents all --dry-run`
37
+
38
+ ## Agent production gate (CI & coding agents)
39
+
40
+ VibeRaven is also the **Agent Context + Production Gate** for pre-deploy checks. Use this path when an agent or CI job needs repo evidence, not the Studio UI.
30
41
 
31
42
  ```bash
32
- node packages/cli/dist/cli.js --agent-mode
43
+ npx -y viberaven --agent-mode
33
44
  ```
34
45
 
35
- Then read artifacts in this order:
46
+ Read artifacts in order:
36
47
 
37
48
  1. `.viberaven/agent-tasklist.md`
38
49
  2. `.viberaven/gate-result.json`
39
50
  3. `.viberaven/context-map.json`
40
- 4. `.viberaven/agent-summary.md`
41
- 5. `.viberaven/launch-playbook.md`
42
51
 
43
- Fix one repo-code gap, then run:
52
+ Fix one repo-code gap, then:
44
53
 
45
54
  ```bash
46
55
  npx -y viberaven --verify
47
56
  npx -y viberaven --strict
48
57
  ```
49
58
 
50
- For focused work:
51
-
52
- ```bash
53
- npx -y viberaven next --json
54
- npx -y viberaven prompt --gap <id>
55
- npx -y viberaven audit --vercel-supabase
56
- ```
57
-
58
- ## Chat-native production actions
59
+ Focused helpers: `npx -y viberaven next --json`, `npx -y viberaven prompt --gap <id>`, `npx -y viberaven audit --vercel-supabase`
59
60
 
60
- Agent mode writes a compact action surface for Codex, Claude Code, Cursor, and other agents:
61
+ ### Chat-native actions
61
62
 
62
63
  ```bash
63
- npx -y viberaven --agent-mode
64
64
  npx -y viberaven actions
65
65
  npx -y viberaven verify --action VR-A1
66
66
  ```
67
67
 
68
- VibeRaven writes `.viberaven/actions.json` as the V1 source of truth and renderer contract for the current action surface. The manifest is generated by `--agent-mode`; `.viberaven/action-registry.json` preserves stable action handles across runs.
69
-
70
- Chat output is intentionally limited to focused actions, provider targets, copy payloads, verification commands, repo-relative file targets, and resume prompts. It does not print secrets, raw env values, or generic dashboard link dumps.
71
-
72
- 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.
68
+ Writes `.viberaven/actions.json` as the action surface contract. Provider dashboard steps are not cleared by repo edits alone.
73
69
 
74
- Preview the action surface without login, scan, or API spend:
75
-
76
- ```bash
77
- npx -y viberaven preview --agent-mode
78
- ```
79
-
80
- The preview uses sample renderer data to show the intended chat-native shape. It is not a production verdict for the current repository.
81
-
82
- ## Agent infrastructure direction
83
-
84
- VibeRaven's action model is designed for normal Codex, Claude Code, Cursor, and MCP workflows today, and for richer agent hosts later.
85
-
86
- Managed-agent systems need durable sessions, observable event history, credential boundaries, bounded execution, and resumable action state. VibeRaven keeps those concerns in the manifest contract:
87
-
88
- - `.viberaven/actions.json` is the current action surface.
89
- - `.viberaven/action-registry.json` preserves stable IDs and lifecycle history.
90
- - Future session events can add an append-only timeline without changing the current action model.
91
- - Provider credentials and raw env values must stay out of chat output, manifests, MCP resources, and UI renderers.
92
- - Future local/hosted consoles should execute only narrow VibeRaven commands, not arbitrary shell text.
93
-
94
- ## Production Copilot Loop
95
-
96
- VibeRaven runs a batch-disciplined loop until the production gate clears. Do not stop at "scan complete."
97
-
98
- 1. **Scan** — Run `--agent-mode`. Read `.viberaven/agent-tasklist.md` and parse `VIBERAVEN_NEXT_ACTION` from stdout for `batchSize`, `batchApplied`, `scanNow`, and `stalled`.
99
- 2. **Batch heals** — For each repo-code task where `requiresUserAction: false`, apply up to `batchSize` heals per batch (free=3, pro=10) via `viberaven_heal_apply { gap: "<gapId>", yes: true }` or `--heal --apply --gap <id> --yes`. When `scanNow: true`, verify before applying more heals.
100
- 3. **Verify and clear** — Run `--verify` once per batch (not after every heal). Repeat until `gate.status === 'clear'` in `.viberaven/gate-result.json`. For provider gaps, read `VIBERAVEN_PROVIDER_ACTION`, complete the dashboard step, then verify.
101
-
102
- If `stalled: true`, stop calling verify and address provider-action gaps or report to the user. Run `--strict` before deploy or CI pass.
103
-
104
- ## Machine Output
70
+ ### Machine output
105
71
 
106
72
  ```bash
107
73
  npx -y viberaven --agent-mode --json
108
- npx -y viberaven --agent-mode --jsonl
109
74
  npx -y viberaven --strict --json
110
75
  ```
111
76
 
112
- Machine artifact contract:
113
-
114
- ```text
115
- docs/contracts/artifacts.md
116
- https://viberaven.dev/schemas/gate-result.schema.json
117
- https://viberaven.dev/schemas/context-map.schema.json
118
- https://viberaven.dev/schemas/gap.schema.json
119
- https://viberaven.dev/schemas/heal-result.schema.json
120
- ```
77
+ Artifact schemas: `docs/contracts/artifacts.md`, https://viberaven.dev/schemas/gate-result.schema.json, https://viberaven.dev/schemas/context-map.schema.json, https://viberaven.dev/schemas/gap.schema.json, https://viberaven.dev/schemas/heal-result.schema.json
121
78
 
122
79
  ## Development
123
80
 
124
81
  ```bash
125
- npm run cli:build
126
- npm run cli:test
127
- node packages/cli/dist/cli.js scan
82
+ npm run build
83
+ npm test
128
84
  ```
129
85
 
130
86
  ## License
131
87
 
132
- The public npm CLI package is MIT licensed. Private monorepo code and extension packaging may have separate product terms.
88
+ MIT
package/dist/cli.js CHANGED
@@ -12304,7 +12304,7 @@ var VERSION;
12304
12304
  var init_version = __esm({
12305
12305
  "src/version.ts"() {
12306
12306
  "use strict";
12307
- VERSION = "1.2.2";
12307
+ VERSION = "1.2.3";
12308
12308
  }
12309
12309
  });
12310
12310
 
@@ -18846,20 +18846,20 @@ function connectCliAgent(agentId, chatIndex, options) {
18846
18846
  }
18847
18847
 
18848
18848
  function cliSetupProbeLabel() {
18849
- return demo.cliProbeStatus === 'probing' ? 'Testing\u2026' : demo.cliProbeStatus === 'success' ? 'Connected \u2014 continue to chat' : demo.cliProbeStatus === 'failed' ? 'Test connection again' : 'Test connection & verify';
18849
+ return demo.cliProbeStatus === 'probing' ? 'Testing\u2026' : demo.cliProbeStatus === 'success' ? 'Connected' : demo.cliProbeStatus === 'failed' ? 'Try again' : 'Test connection';
18850
18850
  }
18851
18851
 
18852
18852
  function CliSetupActions(targetId, index) {
18853
18853
  const setup = cliSetupFor(targetId);
18854
18854
  const probeLabel = cliSetupProbeLabel();
18855
18855
  const ctaPending = demo.cliProbeStatus !== 'success' && demo.cliProbeStatus !== 'probing';
18856
- const ctaClass = 'vr-cli-action-button is-primary is-cta' + (ctaPending ? ' is-pending' : '');
18857
- return '<div class="vr-cli-connect-expand-actions">' +
18856
+ const ctaClass = 'vr-cli-action-button is-primary' + (ctaPending ? ' is-pending' : '');
18857
+ return '<p class="vr-cli-setup-cta-hint">After sign-in, click <strong>Test connection</strong> \u2014 chat only works once verified.</p>' +
18858
+ '<div class="vr-cli-connect-expand-actions">' +
18858
18859
  '<button class="vr-cli-action-button" type="button" data-action="run-cli-install" data-cli-agent="' + escapeHtml(targetId) + '" data-chat-index="' + String(index) + '">' + Icon('shell') + 'Run install</button>' +
18859
18860
  '<button class="vr-cli-action-button" type="button" data-action="run-cli-signin" data-cli-agent="' + escapeHtml(targetId) + '" data-chat-index="' + String(index) + '">' + Icon('shell') + 'Run sign in</button>' +
18860
- '</div>' +
18861
- '<p class="vr-cli-setup-cta-hint">After sign-in finishes, click below to confirm the connection \u2014 chat only works once this verifies.</p>' +
18862
18861
  '<button class="' + ctaClass + '" type="button" data-action="test-cli-connection" data-cli-agent="' + escapeHtml(targetId) + '" data-chat-index="' + String(index) + '">' + Icon('refresh') + escapeHtml(probeLabel) + '</button>' +
18862
+ '</div>' +
18863
18863
  '<p class="vr-cli-setup-hint">Type commands in the Studio terminal below, or run: <code>' + escapeHtml(setup.installCommand) + '</code> then <code>' + escapeHtml(setup.signInCommand) + '</code></p>';
18864
18864
  }
18865
18865
 
@@ -23769,31 +23769,19 @@ body:has(.vr-app.is-dragging) {
23769
23769
  color: #fff;
23770
23770
  }
23771
23771
  .vr-cli-setup-cta-hint {
23772
- margin: 9px 0 5px;
23772
+ margin: 0 0 6px;
23773
+ color: #94a3b8;
23774
+ font-size: 11px;
23775
+ font-weight: 500;
23776
+ line-height: 1.35;
23777
+ }
23778
+ .vr-cli-setup-cta-hint strong {
23773
23779
  color: #c4b5fd;
23774
- font-size: 12px;
23775
23780
  font-weight: 650;
23776
- line-height: 1.4;
23777
- }
23778
- .vr-cli-action-button.is-cta {
23779
- width: 100%;
23780
- justify-content: center;
23781
- min-height: 42px;
23782
- font-size: 13.5px;
23783
- font-weight: 750;
23784
- letter-spacing: 0.1px;
23785
- }
23786
- .vr-cli-action-button.is-cta svg {
23787
- width: 16px;
23788
- height: 16px;
23789
- }
23790
- .vr-cli-action-button.is-cta.is-pending {
23791
- border-color: rgba(168, 85, 247, 0.65);
23792
- animation: vr-cli-cta-pulse 2.2s ease-in-out infinite;
23793
23781
  }
23794
- @keyframes vr-cli-cta-pulse {
23795
- 0%, 100% { box-shadow: 0 0 0 1px rgba(168, 85, 247, 0.3), 0 5px 16px rgba(124, 58, 237, 0.22); }
23796
- 50% { box-shadow: 0 0 0 1px rgba(168, 85, 247, 0.6), 0 8px 22px rgba(124, 58, 237, 0.42); }
23782
+ .vr-cli-action-button.is-primary.is-pending {
23783
+ border-color: rgba(168, 85, 247, 0.55);
23784
+ box-shadow: 0 0 0 1px rgba(168, 85, 247, 0.25);
23797
23785
  }
23798
23786
  .vr-cli-strip button.is-connect-target {
23799
23787
  border-color: rgba(248, 250, 252, 0.34);