@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 +31 -75
- package/dist/cli.js +16 -28
- package/dist/cli.js.map +2 -2
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -4,129 +4,85 @@
|
|
|
4
4
|
[](https://www.npmjs.com/package/@viberaven/cli)
|
|
5
5
|
[](https://www.npmjs.com/package/@viberaven/cli)
|
|
6
6
|
|
|
7
|
-
VibeRaven
|
|
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
|
-
|
|
12
|
-
|
|
13
|
-
## Humans
|
|
11
|
+
## Run Studio
|
|
14
12
|
|
|
15
13
|
```bash
|
|
16
14
|
npx -y viberaven
|
|
17
15
|
```
|
|
18
16
|
|
|
19
|
-
|
|
17
|
+
Opens VibeRaven Studio on `localhost` in the current project:
|
|
20
18
|
|
|
21
|
-
|
|
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
|
-
|
|
24
|
+
Explicit UI command:
|
|
24
25
|
|
|
25
26
|
```bash
|
|
26
|
-
npx -y viberaven
|
|
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
|
-
|
|
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
|
-
|
|
43
|
+
npx -y viberaven --agent-mode
|
|
33
44
|
```
|
|
34
45
|
|
|
35
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
126
|
-
npm
|
|
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
|
-
|
|
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.
|
|
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
|
|
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
|
|
18857
|
-
return '<
|
|
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:
|
|
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
|
-
|
|
23795
|
-
|
|
23796
|
-
|
|
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);
|