fix: restore custom heartbeat bloom spinner, replace clack with inquirer

Restore the hand-crafted connect renderer that was accidentally
overwritten by an agent in commit 5029900. The original renderer
(from ae3a674) features a custom heartbeat bloom spinner
(· → ✧ → ✦ double-beat with dark pause) with ANSI cursor control
for in-place repaint — no ora dependency.

Adapted the restored renderer's interface to match current call
sites (title, scopeActive, scopeDone, success, detail, next,
fail, bell, cleanup, pauseForPrompt, resumeAfterPrompt).

Replaced @clack/prompts with @inquirer/prompts for credential
inputs and source picker. Clack's visual chrome (vertical bars,
diamond symbols) violated the design skill's principle of owning
our visual identity.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: tnunamak

docs/CLI-README-launch.md

@@ -0,0 +1,218 @@
+# vana
+
+**Portable personal data, from the terminal.**
+
+[![Release](https://img.shields.io/github/v/release/vana-com/cli)](https://github.com/vana-com/cli/releases)
+![macOS · Linux · Windows](https://img.shields.io/badge/platform-macOS%20·%20Linux%20·%20Windows-blue)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+
+<p align="center">
+  <img src="docs/assets/demo.gif" width="720" />
+  <br />
+  <sub>Connecting GitHub and inspecting the results. Credentials never leave your machine.</sub>
+</p>
+
+`vana` collects your data from platforms you use. You log in through a browser
+on your machine, and the CLI saves it locally as JSON.
+
+### Highlights
+
+- **Fully local**: credentials and collected data never leave your machine
+- **Any platform**: connects through a browser session, not a restricted API
+- **Inspectable**: collected data is JSON you can summarize, query, or pipe
+- **Agent-ready**: `--json` and `--no-input` flags for scripts and AI agents
+- **Session caching**: log in once, reconnect faster next time
+- **Extensible**: connectors are standalone modules; add new platforms without touching the core
+
+## Install
+
+macOS (Homebrew):
+
+```bash
+brew install vana-com/tap/vana
+```
+
+macOS and Linux:
+
+```bash
+curl -fsSL https://cli.vana.com/install.sh | sh
+```
+
+Windows (PowerShell):
+
+```powershell
+irm https://cli.vana.com/install.ps1 | iex
+```
+
+Verify with `vana --version`.
+
+## Quick start
+
+```console
+$ vana connect github
+
+Connect GitHub
+
+→ Connecting
+  Checking GitHub login...
+  Login confirmed. Collecting data in background...
+  Profile (1/3): Fetching profile...
+  Repositories (2/3): Fetched 2 repositories
+  Starred (3/3): Fetched 0 starred repositories
+✓ Connected GitHub. Saved locally.
+  Path: ~/.dataconnect/last-result.json
+```
+
+```console
+$ vana data show github
+
+GitHub data
+
+→ Summary
+  Profile: tnunamak
+  Repositories: 2
+  Latest repos: vana-connect, data-connectors
+  Starred: 0
+
+  Path: ~/.dataconnect/last-result.json
+  Updated: Mar 14, 2026, 8:10 AM
+```
+
+Your data is on disk at `~/.dataconnect/`.
+
+```bash
+vana data show github --json | jq '.summary'
+```
+
+Explore further:
+
+```bash
+vana sources               # See all available platforms
+vana connect               # Interactive source picker
+vana status                # What's connected, what needs attention
+```
+
+## How it works
+
+1. `vana connect <source>` launches a browser on your machine
+2. You log in (credentials stay on your machine)
+3. The CLI collects your data and saves it to `~/.dataconnect/`
+4. `vana data show <source>` summarizes what was collected
+
+Sessions are cached, so reconnecting is faster next time. Your data is files
+on disk. Inspect, move, or delete them whenever you want.
+
+## Commands
+
+| Command                   | What it does                                              |
+| ------------------------- | --------------------------------------------------------- |
+| `vana connect [source]`   | Connect a platform and export your data                   |
+| `vana sources`            | List available platforms                                  |
+| `vana data list`          | Show all collected datasets                               |
+| `vana data show <source>` | Summarize a collected dataset                             |
+| `vana data path <source>` | Print the file path for a dataset                         |
+| `vana status`             | Overview of connections and anything that needs attention |
+| `vana doctor`             | Diagnose installation and runtime health                  |
+| `vana logs [source]`      | View run logs                                             |
+| `vana setup`              | Install or repair the browser runtime                     |
+
+Run `vana <command> --help` for detailed usage.
+
+### For scripts and AI agents
+
+Commands support structured output:
+
+```bash
+vana connect github --json --no-input    # Machine-safe — never prompts
+vana data show github --json | jq        # Pipe collected data anywhere
+vana sources --json                      # Discover platforms programmatically
+```
+
+`--json` writes structured output to stdout. `--no-input` guarantees no
+interactive prompts. The CLI exits `1` if input is needed. See the
+[exit code reference](docs/exit-codes.md) for the full contract.
+
+## Sources
+
+`vana` connects to any platform that has a web login. Connectors handle the
+automation for each source.
+
+The CLI shares its connector format with
+[DataConnect](https://github.com/vana-com/data-connect) and the
+[data-connectors](https://github.com/vana-com/data-connectors) repository.
+
+Tested in the CLI: **GitHub**, **Spotify**.
+Available in the connector ecosystem: **ChatGPT**, **Instagram**, **LinkedIn**,
+**YouTube**, **Shop**, and more.
+
+Run `vana sources` to see what's available on your install.
+
+Missing a platform?
+[Request one](https://github.com/vana-com/cli/issues/new?template=source-request.yml)
+· [Build a connector](docs/building-connectors.md)
+
+## Ecosystem
+
+`vana` is the CLI for [Vana](https://vana.org)'s data portability network. It
+shares connectors and local storage with
+[DataConnect](https://github.com/vana-com/data-connect), the desktop app. For
+building apps that request user data, see the
+[Connect SDK](https://github.com/vana-com/vana-connect).
+
+## Privacy
+
+**Credentials**: You log in through a browser on your machine. Vana never
+sees your password, token, or session cookie.
+
+**Collected data**: Saved to `~/.dataconnect/` as local files. Nothing is
+uploaded.
+
+**Browser sessions**: Cached in `~/.dataconnect/browser-profiles/` for faster
+reconnects. Delete them any time.
+
+**Telemetry**: None.
+
+## Troubleshooting
+
+```bash
+vana doctor              # Runtime, browser, and state health
+vana logs <source>       # Latest run log for a source
+```
+
+| Problem                 | Fix                                        |
+| ----------------------- | ------------------------------------------ |
+| Browser runtime missing | `vana setup`                               |
+| Login expired           | `vana connect <source>` to re-authenticate |
+| Connector fails         | `vana logs <source>` for details           |
+
+## Uninstall
+
+Remove the CLI:
+
+```bash
+brew uninstall vana                  # Homebrew
+rm -f ~/.local/bin/vana              # Script install (macOS / Linux)
+```
+
+Remove collected data and state:
+
+```bash
+rm -rf ~/.dataconnect
+```
+
+## Documentation
+
+- [Building connectors](docs/building-connectors.md)
+- [Exit code reference](docs/exit-codes.md)
+- [Architecture](docs/architecture.md)
+
+## Community
+
+- [Issues](https://github.com/vana-com/cli/issues): bugs and source requests
+- [Discussions](https://github.com/vana-com/cli/discussions): questions and ideas
+- [Discord](https://discord.gg/vana): chat with the team
+- [Contributing](CONTRIBUTING.md)
+
+## License
+
+MIT

package.json

@@ -99,7 +99,6 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "@clack/prompts": "^1.1.0",
     "@inquirer/prompts": "8.3.0",
     "chromium-bidi": "15.0.0",
     "commander": "14.0.3",

pnpm-lock.yaml

@@ -3,13 +3,7 @@ import fsp from "node:fs/promises";
 import path from "node:path";
 import { createRequire } from "node:module";
 
-import {
-  text as clackText,
-  password as clackPassword,
-  select as clackSelect,
-  confirm as clackConfirm,
-  isCancel,
-} from "@clack/prompts";
+import { confirm, input, password, select } from "@inquirer/prompts";
 import { Command, CommanderError } from "commander";
 
 import {
@@ -496,11 +490,11 @@ async function runConnect(
         process.stderr.write("  \u2022 Local files under ~/.dataconnect/\n\n");
         process.stderr.write("Your credentials stay on this machine.\n\n");
 
-        const shouldContinue = await clackConfirm({
+        const shouldContinue = await confirm({
           message: "Continue?",
-          initialValue: true,
+          default: true,
         });
-        if (isCancel(shouldContinue) || !shouldContinue) {
+        if (!shouldContinue) {
           renderer?.fail("Cancelled.");
           emit.event({
             type: "outcome",
@@ -709,30 +703,16 @@ async function runConnect(
           for (const field of needInput.fields) {
             const isPasswordField = field.toLowerCase().includes("password");
             if (isPasswordField) {
-              const result = await clackPassword({
+              values[field] = await password({
                 message: humanizeField(field),
               });
-              if (isCancel(result)) {
-                throw new Error("__vana_prompt_cancelled__");
-              }
-              values[field] = result;
             } else {
-              const result = await clackText({
+              values[field] = await input({
                 message: humanizeField(field),
               });
-              if (isCancel(result)) {
-                throw new Error("__vana_prompt_cancelled__");
-              }
-              values[field] = result;
             }
           }
         } catch (error) {
-          if (
-            error instanceof Error &&
-            error.message === "__vana_prompt_cancelled__"
-          ) {
-            throw error;
-          }
           if (isPromptCancelled(error)) {
             throw new Error("__vana_prompt_cancelled__");
           }
@@ -1088,8 +1068,8 @@ async function runConnectEntry(options: GlobalOptions): Promise<number> {
     return 1;
   }
 
-  // Build clack-compatible options from enriched sources
-  const clackOptions = enrichedSources.map((item) => {
+  // Build inquirer-compatible choices from enriched sources
+  const choices = enrichedSources.map((item) => {
     const connected = hasCollectedData(item.dataState);
     const hint = connected
       ? "connected"
@@ -1098,23 +1078,26 @@ async function runConnectEntry(options: GlobalOptions): Promise<number> {
         : undefined;
     return {
       value: item.id,
-      label: item.name,
-      hint,
+      name: item.name,
+      description: hint,
     };
   });
 
-  const source = await clackSelect({
-    message: "Choose a source to connect.",
-    options: clackOptions,
-    initialValue: suggestedSource?.id,
-  });
+  try {
+    const source = await select({
+      message: "Choose a source to connect.",
+      choices,
+      default: suggestedSource?.id,
+    });
 
-  if (isCancel(source)) {
-    emit.info("Cancelled.");
-    return 1;
+    return runConnect(source as string, options);
+  } catch (error) {
+    if (isPromptCancelled(error)) {
+      emit.info("Cancelled.");
+      return 1;
+    }
+    throw error;
   }
-
-  return runConnect(source as string, options);
 }
 
 async function runList(options: GlobalOptions): Promise<number> {