@viberaven/cli 1.2.1 → 1.2.3

package/README.md

@@ -4,129 +4,85 @@
 [![npm downloads](https://img.shields.io/npm/dw/@viberaven/cli)](https://www.npmjs.com/package/@viberaven/cli)
 [![license](https://img.shields.io/npm/l/@viberaven/cli)](https://www.npmjs.com/package/@viberaven/cli)
 
-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.
+**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.
 
 Public repo: https://github.com/ohad6k/VibeRaven
 
-If VibeRaven helps, star the repo so more AI app builders find the production gate. Use Watch -> Custom -> Releases for release notifications.
-
-## Humans
+## Run Studio
 
 ```bash
 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.
+Opens VibeRaven Studio on `localhost` in the current project:
 
-## Coding Agents
+- Connect **Codex CLI**, **Claude Code**, or **Gemini CLI** (your existing CLI account — no OpenAI API key in VibeRaven).
+- **Terminal** tab: install → sign in → **Test connection** (chat only works after verify).
+- **Chat** tab: scoped missions that can edit the repo (permission mode: ask each change or full access).
+- Provider Control Board and Versions & Releases context for drag-to-chat.
 
-Agents should run:
+Explicit UI command:
 
 ```bash
-npx -y viberaven --agent-mode
+npx -y viberaven ui .
+```
+
+## Install agent rules (optional)
+
+```bash
+npx -y viberaven init --agents all
 ```
 
-If running from the `viberaven` monorepo root, run:
+Preview without writing files: `npx -y viberaven init --agents all --dry-run`
+
+## Agent production gate (CI & coding agents)
+
+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.
 
 ```bash
-node packages/cli/dist/cli.js --agent-mode
+npx -y viberaven --agent-mode
 ```
 
-Then read artifacts in this order:
+Read artifacts in order:
 
 1. `.viberaven/agent-tasklist.md`
 2. `.viberaven/gate-result.json`
 3. `.viberaven/context-map.json`
-4. `.viberaven/agent-summary.md`
-5. `.viberaven/launch-playbook.md`
 
-Fix one repo-code gap, then run:
+Fix one repo-code gap, then:
 
 ```bash
 npx -y viberaven --verify
 npx -y viberaven --strict
 ```
 
-For focused work:
-
-```bash
-npx -y viberaven next --json
-npx -y viberaven prompt --gap <id>
-npx -y viberaven audit --vercel-supabase
-```
-
-## Chat-native production actions
+Focused helpers: `npx -y viberaven next --json`, `npx -y viberaven prompt --gap <id>`, `npx -y viberaven audit --vercel-supabase`
 
-Agent mode writes a compact action surface for Codex, Claude Code, Cursor, and other agents:
+### Chat-native actions
 
 ```bash
-npx -y viberaven --agent-mode
 npx -y viberaven actions
 npx -y viberaven verify --action VR-A1
 ```
 
-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.
-
-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.
-
-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.
+Writes `.viberaven/actions.json` as the action surface contract. Provider dashboard steps are not cleared by repo edits alone.
 
-Preview the action surface without login, scan, or API spend:
-
-```bash
-npx -y viberaven preview --agent-mode
-```
-
-The preview uses sample renderer data to show the intended chat-native shape. It is not a production verdict for the current repository.
-
-## Agent infrastructure direction
-
-VibeRaven's action model is designed for normal Codex, Claude Code, Cursor, and MCP workflows today, and for richer agent hosts later.
-
-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:
-
-- `.viberaven/actions.json` is the current action surface.
-- `.viberaven/action-registry.json` preserves stable IDs and lifecycle history.
-- Future session events can add an append-only timeline without changing the current action model.
-- Provider credentials and raw env values must stay out of chat output, manifests, MCP resources, and UI renderers.
-- Future local/hosted consoles should execute only narrow VibeRaven commands, not arbitrary shell text.
-
-## Production Copilot Loop
-
-VibeRaven runs a batch-disciplined loop until the production gate clears. Do not stop at "scan complete."
-
-1. **Scan** — Run `--agent-mode`. Read `.viberaven/agent-tasklist.md` and parse `VIBERAVEN_NEXT_ACTION` from stdout for `batchSize`, `batchApplied`, `scanNow`, and `stalled`.
-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.
-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.
-
-If `stalled: true`, stop calling verify and address provider-action gaps or report to the user. Run `--strict` before deploy or CI pass.
-
-## Machine Output
+### Machine output
 
 ```bash
 npx -y viberaven --agent-mode --json
-npx -y viberaven --agent-mode --jsonl
 npx -y viberaven --strict --json
 ```
 
-Machine artifact contract:
-
-```text
-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
-```
+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
 
 ## Development
 
 ```bash
-npm run cli:build
-npm run cli:test
-node packages/cli/dist/cli.js scan
+npm run build
+npm test
 ```
 
 ## License
 
-The public npm CLI package is MIT licensed. Private monorepo code and extension packaging may have separate product terms.
+MIT

package/dist/cli.js

@@ -12304,7 +12304,7 @@ var VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    VERSION = "1.2.1";
+    VERSION = "1.2.3";
   }
 });
 
@@ -18846,17 +18846,19 @@ function connectCliAgent(agentId, chatIndex, options) {
 }
 
 function cliSetupProbeLabel() {
-  return demo.cliProbeStatus === 'probing' ? 'Testing...' : demo.cliProbeStatus === 'success' ? 'Connected' : demo.cliProbeStatus === 'failed' ? 'Try again' : 'Test connection';
+  return demo.cliProbeStatus === 'probing' ? 'Testing\u2026' : demo.cliProbeStatus === 'success' ? 'Connected' : demo.cliProbeStatus === 'failed' ? 'Try again' : 'Test connection';
 }
 
 function CliSetupActions(targetId, index) {
   const setup = cliSetupFor(targetId);
   const probeLabel = cliSetupProbeLabel();
-  return '<div class="vr-cli-connect-expand-actions">' +
+  const ctaPending = demo.cliProbeStatus !== 'success' && demo.cliProbeStatus !== 'probing';
+  const ctaClass = 'vr-cli-action-button is-primary' + (ctaPending ? ' is-pending' : '');
+  return '<p class="vr-cli-setup-cta-hint">After sign-in, click <strong>Test connection</strong> \u2014 chat only works once verified.</p>' +
+    '<div class="vr-cli-connect-expand-actions">' +
     '<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>' +
     '<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>' +
-    '<button class="vr-cli-action-button" type="button" data-action="finish-cli-signin" data-cli-agent="' + escapeHtml(targetId) + '" data-chat-index="' + String(index) + '">' + Icon('check') + 'I finished sign in</button>' +
-    '<button class="vr-cli-action-button is-primary" type="button" data-action="test-cli-connection" data-cli-agent="' + escapeHtml(targetId) + '" data-chat-index="' + String(index) + '">' + Icon('refresh') + escapeHtml(probeLabel) + '</button>' +
+    '<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>' +
     '</div>' +
     '<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>';
 }
@@ -19298,7 +19300,7 @@ async function runCliSignInInStudio(agentId, chatIndex) {
       String(payload?.output || payload?.message || 'Sign-in command finished.'),
       payload?.interactiveNote ? String(payload.interactiveNote) : '',
       '',
-      'Complete any browser login, then click I finished sign in or Test connection.'
+      'Complete any browser login, then click Test connection below to verify.'
     ]);
     demo.cliTerminalDraft = setupCommandFallback(agentId, 'sign-in');
     demo.notice = 'Sign-in ran in Studio terminal. Finish login if prompted, then test the connection.';
@@ -19330,7 +19332,7 @@ async function openCliOsTerminal(agentId, chatIndex) {
       '',
       String(payload?.message || 'Complete sign-in in the OS terminal window that opened.'),
       '',
-      'When login finishes, return here and click I finished sign in or Test connection.'
+      'When login finishes, return here and click Test connection below to verify.'
     ]);
     demo.notice = payload?.ok ? 'OS terminal opened for sign-in fallback.' : 'Could not open an OS terminal window.';
   } catch {
@@ -19340,16 +19342,6 @@ async function openCliOsTerminal(agentId, chatIndex) {
   render();
 }
 
-function finishCliSignIn(agentId, chatIndex) {
-  const laneIndex = Math.max(0, Number(chatIndex) || 0);
-  setConnectTarget(agentId);
-  demo.pickerChatIndex = laneIndex;
-  demo.activeStudioTab = 'terminal';
-  appendTerminalLines(['If sign-in finished in the browser or OS window, click Test connection below.', '']);
-  demo.notice = 'When sign-in finishes, click Test connection to verify.';
-  render();
-}
-
 function ModelPicker(index) {
   const chat = chatContext(index);
   const models = allModelOptions(index);
@@ -19695,12 +19687,8 @@ function renderAgentAnswerHtml(rawText, chatIndex, cards) {
   const hasMissionPlanSteps = Boolean(cards && Array.isArray(cards.planSteps) && cards.planSteps.length);
   const structured = parseAgentSections(visibleText, { skipPlanSections: hasMissionPlanSteps });
   if (structured) {
-    const hasGateSection = structured.some((section) => section.name.toLowerCase() === 'gate');
-    const gateStrip = !hasGateSection && currentState.gate && currentState.gate.label
-      ? AgentGateStrip('', currentState.gate)
-      : '';
     const sectionCards = structured.map((section) => renderAgentSectionCard(section, chatIndex)).join('');
-    return '<div class="vr-agent-answer-body vr-agent-answer-structured"><div class="vr-agent-sections">' + gateStrip + sectionCards + '</div></div>';
+    return '<div class="vr-agent-answer-body vr-agent-answer-structured"><div class="vr-agent-sections">' + sectionCards + '</div></div>';
   }
   const blocks = [];
   let listType = null;
@@ -20225,7 +20213,7 @@ app.addEventListener('click', async (event) => {
     return;
   }
 
-  const connectActionButton = event.target.closest('[data-action="run-cli-install"], [data-action="run-cli-signin"], [data-action="finish-cli-signin"], [data-action="open-os-terminal"], [data-action="test-cli-connection"], [data-action="copy-cli-command"], [data-action="terminal-select-cli"], [data-action="terminal-shell-run"], [data-action="connect-complete-chat"], [data-action="reset-cli-connect"]');
+  const connectActionButton = event.target.closest('[data-action="run-cli-install"], [data-action="run-cli-signin"], [data-action="open-os-terminal"], [data-action="test-cli-connection"], [data-action="copy-cli-command"], [data-action="terminal-select-cli"], [data-action="terminal-shell-run"], [data-action="connect-complete-chat"], [data-action="reset-cli-connect"]');
   if (connectActionButton) {
     const action = connectActionButton.getAttribute('data-action');
     const agentId = connectActionButton.getAttribute('data-cli-agent') || demo.cliConnectTargetId || 'codex';
@@ -20279,10 +20267,6 @@ app.addEventListener('click', async (event) => {
       await runCliSignInInStudio(agentId, chatIndex);
       return;
     }
-    if (action === 'finish-cli-signin') {
-      finishCliSignIn(agentId, chatIndex);
-      return;
-    }
     if (action === 'open-os-terminal') {
       await openCliOsTerminal(agentId, chatIndex);
       return;
@@ -20548,12 +20532,6 @@ app.addEventListener('click', async (event) => {
     await runCliSignInInStudio(agentId, chatIndex);
     return;
   }
-  if (action === 'finish-cli-signin') {
-    const agentId = actionButton.getAttribute('data-cli-agent') || demo.cliConnectTargetId || 'codex';
-    const chatIndex = Number(actionButton.getAttribute('data-chat-index') || demo.pickerChatIndex || 0);
-    finishCliSignIn(agentId, chatIndex);
-    return;
-  }
   if (action === 'open-os-terminal') {
     const agentId = actionButton.getAttribute('data-cli-agent') || demo.cliConnectTargetId || 'codex';
     const chatIndex = Number(actionButton.getAttribute('data-chat-index') || demo.pickerChatIndex || 0);
@@ -23790,6 +23768,21 @@ body:has(.vr-app.is-dragging) {
   background: rgba(124, 58, 237, 0.92);
   color: #fff;
 }
+.vr-cli-setup-cta-hint {
+  margin: 0 0 6px;
+  color: #94a3b8;
+  font-size: 11px;
+  font-weight: 500;
+  line-height: 1.35;
+}
+.vr-cli-setup-cta-hint strong {
+  color: #c4b5fd;
+  font-weight: 650;
+}
+.vr-cli-action-button.is-primary.is-pending {
+  border-color: rgba(168, 85, 247, 0.55);
+  box-shadow: 0 0 0 1px rgba(168, 85, 247, 0.25);
+}
 .vr-cli-strip button.is-connect-target {
   border-color: rgba(248, 250, 252, 0.34);
   box-shadow: inset 0 0 0 1px rgba(248, 250, 252, 0.08);