opencode-agora 0.3.0 → 0.4.1

package/README.md

@@ -1,309 +1,140 @@
-# Agora — Instant OpenCode Setup & Marketplace
+# agora
 
-<p align="center">
-  <strong>One command from zero to a perfectly configured OpenCode environment.</strong>
-</p>
-
-<p align="center">
-  Project scanner, MCP marketplace, workflow manager, and community hub — all in one CLI.
-</p>
+> A terminal hub for developers and the agentic AI ecosystem — discover MCP servers and AI tools, skills and harnesses, follow the news, join the conversation, access the latest tech.
 
-<p align="center">
+<p>
   <a href="https://www.npmjs.com/package/opencode-agora"><img src="https://img.shields.io/npm/v/opencode-agora" alt="npm"></a>
-  <a href="https://github.com/IrgenSlj/agora/issues"><img src="https://img.shields.io/github/issues/IrgenSlj/agora" alt="issues"></a>
-  <a href="https://github.com/IrgenSlj/agora/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/opencode-agora" alt="license"></a>
+  <a href="https://github.com/IrgenSlj/agora/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/opencode-agora" alt="MIT"></a>
   <a href="https://github.com/IrgenSlj/agora/actions"><img src="https://img.shields.io/github/actions/workflow/status/IrgenSlj/agora/ci.yml?branch=main" alt="CI"></a>
+  <img src="https://img.shields.io/badge/tests-768%20passing-success" alt="tests">
 </p>
 
----
-
-## Demo
-
-_A terminal recording is in the works — see ROADMAP.md._
-
-## What is Agora?
-
-Agora is a **zero-config OpenCode setup tool** and terminal marketplace. Run `npx opencode-agora init` in any project and it automatically scans your stack, generates the perfect `opencode.json`, installs MCP servers, and registers the plugin.
-
-It also bundles **36+ MCP servers**, **10 production workflows**, **6 tutorials**, and a full community discussion system — all usable offline.
-
-## Features
-
-### `agora init` — One-Command Setup
-- Scans your project for `package.json`, `Cargo.toml`, `pyproject.toml`, `go.mod`, `Gemfile`, `Dockerfile`, and more
-- Detects frameworks (React, Next.js, Django, Rails, Spring, Vue)
-- Generates the optimal `opencode.json` with stack-matched MCP servers
-- Automatically installs npm packages and registers the `opencode-agora` plugin
-- Ready in seconds — run once, done
-
-### `agora use` — Apply Workflows as Skills
-- Browse 10+ production-tested workflows (TDD, security audit, API design, refactoring, etc.)
-- `agora use wf-tdd-cycle` creates an OpenCode skill file and registers it
-- No manual copy-pasting — one command and the workflow is live
-
-### Rich Offline Marketplace
-- **36+ MCP servers** across 12 categories (filesystem, databases, cloud, browser automation, monitoring, etc.)
-- All official `@modelcontextprotocol/*` servers plus top community servers
-- Fully functional offline — no backend required
-- Search, browse, trending — all work with bundled data
-
-### Config-Aware Installs
-- `agora install mcp-github --write` installs the npm package **and** writes to config
-- Detects OpenCode config path automatically
-- Merge MCP servers into existing config
-- Inspect config health with `agora config doctor`
-
-### Community
-- Discussion threads on tools and patterns
-- Trending prompts and workflows
-- Browse and create discussions from the terminal
+`agora` is a standalone CLI that puts everything a developer building for the future  cares about in one terminal: a **curated + live marketplace** of MCP servers and agent tooling, a **threaded community** with reputation-weighted sort, a **ranked news feed** with on-cache AI summarization, and **first-class install consent** for declared permissions. Works offline by default; opt into the backend with `agora auth login`.
 
-### OpenCode Plugin
-- Search, browse, install-preview, review, profile, discussion, and tutorial tools from inside OpenCode
-- Uses the same marketplace core as the CLI
-
-### Local Hub
-- Optional browser console for browsing the marketplace
-- Runs locally with `bun run hub:dev`
-
-### Learn
-- 6 interactive tutorials on MCP, OpenCode agents, security auditing, and more
-
-## Quick Start
-
-The fastest way to get started — works in any project directory:
+## Install
 
 ```bash
-# One command: scan project, set up OpenCode, install MCP servers, register plugin
+# fastest path — runs in your current project
 npx opencode-agora init
-```
-
-For a persistent command:
-
-```bash
-npm install -g opencode-agora
-agora init
-```
-
-### Install from source
-
-Until the package is published to npm, or if you prefer to run from source:
 
-```bash
-git clone https://github.com/IrgenSlj/agora.git && cd agora && bun install && bun run build && bun link
+# or install once, use anywhere
+npm i -g opencode-agora
+agora welcome
 ```
 
-The package exposes two binary names:
+From source (requires [bun](https://bun.sh)):
 
 ```bash
-agora --help
-opencode-agora --help
+git clone https://github.com/IrgenSlj/agora.git
+cd agora && bun install && bun run build && bun link
 ```
 
-## Live mode / hosted backend
-
-> **Note:** Browse, search, and all read-only commands work fully offline using bundled data — no backend required. Features that write data (publish, reviews, discussions, auth login) and the `--api` flag require a live backend. A hosted instance is not yet deployed. Until then, self-host via the `backend/` directory and set `AGORA_API_URL` to your instance URL before using `--api` or any write commands.
-
-## Usage
+The binary is published as both `agora` and `opencode-agora`.
 
-### Setup
+## Try it
 
 ```bash
-# Scan project and generate optimal OpenCode config
-agora init
-agora init --dry-run    # Preview without writing
-
-# Apply a workflow as an OpenCode skill
-agora use wf-tdd-cycle
-agora use wf-security-audit
+agora welcome                          # guided tour, adapts when signed in
+agora today                            # last 24h: news + community + trending
+agora search mcp                       # 67 curated + live GitHub/HF results
+agora install mcp-github --write --yes # install + write opencode.json
+agora tui                              # 5-page full-screen interface
 ```
 
-### Marketplace
+The default `agora` in a TTY drops you into a **persistent shell** that mixes bash dispatch (`ls`, `git status`) with free LLM chat (`why is this slow?`). `/help` lists the slash commands; `/abc` shows the single-letter shortcuts.
 
-```bash
-# Search and browse
-agora search filesystem
-agora search database --category mcp
-AGORA_API_URL=https://agora.example.com agora search github --api
-agora browse mcp-postgres
-agora trending
-
-# Install MCP servers
-agora install mcp-github           # preview only
-agora install mcp-github --write   # install npm package + write config
-
-# Save/bookmark items
-agora save wf-security-audit
-agora saved
-agora remove wf-security-audit
-```
+## Commands
 
-### Workflows
+Run `agora help` for the grouped list, or `agora help <command>` for any of these:
 
-```bash
-agora workflows
-agora workflows security
-```
+| Group | Commands |
+|---|---|
+| **Daily** | `welcome` · `today` · `bookmarks` · `share` · `open` · `author` |
+| **Marketplace** | `search` · `browse` · `trending` · `similar` · `compare` · `install` · `workflows` |
+| **News** | `news` (CLI) · TUI reader with AI summarization |
+| **Community** | `community` · `thread` · `post` · `reply` · `vote` · `flag` · `discuss` |
+| **Account** | `auth login` · `auth status` · `profile` · `review` · `reviews` · `publish` |
+| **Moderation** | `admin hide` · `admin log` · `admin recompute` _(operator-only)_ |
+| **Setup** | `init` · `use` · `config show/edit/doctor` · `notify` · `completions` · `ping` |
+| **Utility** | `export` · `watch` · `chat` · `mcp` · `tui` · `menu` · `preferences` · `history` |
 
-### Community & Auth
+Every command supports `--json` for scripting and `--help` for inline manual.
 
-```bash
-agora discussions mcp --category question
-agora discuss --title "MCP question" --content "How are you composing servers?" --category question
-agora auth login --token $AGORA_TOKEN --api-url https://agora.example.com
-agora auth status
-agora publish package --name @you/server --description "MCP server" --npm @you/server
-agora publish workflow --name "Security Audit" --description "Audit workflow" --prompt-file ./prompt.md
-agora review mcp-github --rating 5 --content "Works well"
-agora reviews mcp-github --api
-agora profile alice
-```
+## Install consent
 
-### Diagnostics
+`agora install <id>` is preview-only by default. With `--write`, items that declare a permissions manifest require an explicit `--yes`:
 
-```bash
-agora config doctor
-agora config doctor --json
 ```
+$ agora install mcp-filesystem --write
+Permissions
+  fs    ./**/*
 
-`agora install <id>` is preview-only by default. Add `--write` to install the npm package and update config. Pass `--config ./opencode.json` for an explicit target.
-
-Saved items and optional auth credentials are stored in `~/.config/agora/state.json` by default. Use `AGORA_HOME=/path/to/agora` or `--data-dir /path/to/agora` to override.
-
-The CLI uses bundled offline marketplace data (36+ MCP servers, 10 workflows) by default. Add `--api`, `--live`, `AGORA_USE_API=true`, or `AGORA_API_URL` to use the live backend. Falls back to offline data if the API is unavailable.
+This package declares permissions. Re-run with --yes to grant and install.
+$ echo $?
+1
+```
 
-### OpenCode Plugin Commands
+The TUI install preview flips its footer to `g grant + install   d details   n cancel` when permissions are present. The list shows a dim `[fs net exec]` badge on any item with a non-empty manifest.
 
-Once registered (via `agora init` or manually), use inside OpenCode:
+## Configuration
 
-| Command | Description |
+| Env | Meaning |
 |---|---|
-| `/agora search <query> [category]` | Search marketplace |
-| `/agora browse_category <category>` | Browse by category |
-| `/agora browse <id>` | View package details |
-| `/agora trending [type]` | See trending |
-| `/agora install <id> [--write]` | Install to config |
-| `/agora review [action] [...]` | Reviews/ratings |
-| `/agora discussions [action] [...]` | Community |
-| `/agora profile [action] [--username]` | User profiles |
-| `/agora tutorial [id] [step]` | Interactive tutorials |
-| `/agora info` | Help |
-
-**Categories:** mcp, prompt, workflow, skill `|` **Data sources:** offline (default), `--api`
-
-### Registering the plugin manually
-
-If you did not run `agora init`, register the plugin by hand:
-
-1. Install the package globally:
-   ```bash
-   npm install -g opencode-agora
-   ```
-2. Add `"opencode-agora"` to the `plugins` array in `~/.config/opencode/opencode.json` (or your project-local `opencode.json`):
-   ```json
-   {
-     "plugins": ["opencode-agora"]
-   }
-   ```
-
-## Development
+| `AGORA_HOME` | Override the data dir (default `~/.config/agora`) |
+| `AGORA_API_URL` | Backend URL for `--api` reads, all writes, and `agora ping` |
+| `AGORA_TOKEN` | Bearer token (alternatively persisted by `agora auth login`) |
+| `AGORA_LIVE_HUBS` | `1` to merge live GitHub + HuggingFace into the marketplace |
+| `AGORA_GITHUB_TOKEN` | Raises the unauth 60 req/hr GitHub limit to 5000 |
+| `AGORA_ADMIN_USER_IDS` | Comma-separated user ids granted moderator commands |
+| `EDITOR` / `VISUAL` | Used by `agora config edit` |
+| `NO_COLOR` | Respect standard no-color convention |
 
-```bash
-# Typecheck
-bun run typecheck
-
-# Build package output
-bun run build
+Per-user state lives under `~/.config/agora/` — `state.json` (saves + auth), `settings.toml` (preferences), `news-cache.jsonl`, `news-meta.json` (bookmarks), `hubs-cache.jsonl`. All files holding user data are written `0o600` and atomically (`.tmp` + rename) so a crash mid-flush leaves the previous version intact.
 
-# Run tests
-bun test
+## OpenCode plugin
 
-# Try the CLI from source
-bun src/cli.ts search filesystem
+`agora init` also registers the package as an OpenCode plugin and drops a `.opencode/command/agora.md` slash command so the LLM can call:
 
-# Install locally to OpenCode
-bun run dev
-
-# Run the optional local Hub
-bun run hub:dev
 ```
-
-## Project Structure
-
-```
-agora/
-├── src/              # CLI, plugin, and shared marketplace core
-├── backend/          # Cloudflare Workers API
-├── hub/              # Optional local web Hub
-├── test/             # Tests
-├── dist/             # Built output
-└── README.md
+/agora search <query>
+/agora browse <id>
+/agora install <id>
+/agora chat <message>
 ```
 
+`agora_*` tools are also reachable from any MCP client via `agora mcp` — add `{"mcp": {"agora": {"command": ["agora", "mcp"]}}}` to your `opencode.json`.
+
 ## Architecture
 
 ```
-agora/
-├── src/
-│   ├── cli.ts        # CLI entrypoint
-│   ├── cli/app.ts    # CLI command parser and handlers
-│   ├── init.ts       # Project scanner + init plan generator
-│   ├── live.ts       # Live API source with offline fallback
-│   ├── marketplace.ts # Shared search, browse, trending, install-plan core
-│   ├── config-files.ts # OpenCode config detection, doctor, and write helpers
-│   ├── state.ts      # Local Agora saved-item state
-│   ├── index.ts      # OpenCode plugin
-│   ├── api.ts        # API client with fallback
-│   ├── format.ts     # Output formatting
-│   ├── config.ts     # MCP config generation
-│   ├── data.ts       # 36+ MCP servers, 10 workflows, 6 tutorials
-│   └── types.ts      # TypeScript types
-│
-├── backend/          # Cloudflare Workers API
-│   ├── src/index.ts  # Hono server + routes
-│   ├── schema.sql    # D1 database schema
-│   └── services/      # npm + GitHub API clients
-│
-├── hub/              # Local Hub app
-│
-├── test/             # Unit and CLI tests
-└── dist/             # Built output
+src/cli/              command handlers, dispatch, shell, prompter, TUI
+src/cli/pages/        five full-screen TUI pages (home, marketplace,
+                      community, news, settings) + shared helpers
+src/marketplace.ts    curated catalog + live hub merge + install planner
+src/hubs/             GitHub + HuggingFace connectors + AI enrichment
+src/community/        backend client + types
+src/news/             scoring, cache, per-source adapters
+src/state.ts          local state, saves, auth (atomic 0o600 writes)
+backend/src/index.ts  Cloudflare Workers + D1 (Hono router)
+test/                 768 tests, 34 files
 ```
 
-## Project Status
-
-| Component | Status | Notes |
-|-----------|--------|-------|
-| `agora init` | ✅ **New** | Project scanning, config generation, auto-install, plugin registration |
-| `agora use` | ✅ **New** | Apply workflows as OpenCode skills in one command |
-| `agora install --write` | ✅ **Improved** | Now auto-installs npm packages |
-| CLI | Ready | 20 commands: `init`, `use`, `search`, `browse`, `trending`, `workflows`, `tutorials`, `tutorial`, `discussions`, `discuss`, `install`, `save`, `saved`, `remove`, `auth`, `publish`, `review`, `reviews`, `profile`, `config doctor` |
-| Offline data | ✅ **Expanded** | 36 MCP servers, 10 workflows, 7 discussions, 6 tutorials |
-| Live API mode | Ready | Opt-in via `--api`, `AGORA_API_URL`; falls back offline |
-| Shared core | Ready | CLI and plugin share marketplace logic |
-| Local state | Ready | Saved items and auth tokens under `~/.config/agora` |
-| Plugin (offline) | Ready | Works with bundled data |
-| Backend | 🚧 Not deployed — self-host required (see backend/) | Cloudflare Workers + D1 ready for deployment |
-| Local Hub | Ready | Static web app served by Bun |
-| CI | Ready | Typecheck + tests on push/PR |
-| Publish CI | ✅ **New** | Auto-publish to npm on release |
-
-## Testing
+See [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md) for the why-this-shape writeup and [`ROADMAP.md`](./ROADMAP.md) for what's next.
+
+## Development
 
 ```bash
-bun test
-```
+bun test            # 768 cases, ~3.5s
+bun run typecheck   # tsc -p tsconfig.check.json
+bun run build       # tsc + chmod +x dist/cli.js
+bun src/cli.ts <cmd>  # run from source without building
 
-## Roadmap
+cd backend && bun run dev          # local backend on wrangler
+cd backend && bun run typecheck    # backend has its own tsconfig
+```
 
-See [ROADMAP.md](./ROADMAP.md) for upcoming work and ways to contribute.
+PRs welcome — see [`CONTRIBUTING.md`](./CONTRIBUTING.md) and [`COMMUNITY_GUIDELINES.md`](./COMMUNITY_GUIDELINES.md). The catalog accepts entries via PR; see `src/data.ts` for the shape.
 
 ## License
 
-MIT
-
----
-
-<p align="center">
-  Built for the developer community
-</p>
+[MIT](./LICENSE) — © IrgenSlj.

package/dist/atomic-write.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Write `body` to `path` atomically: writes to `path.tmp`, then renames
+ * over the destination. Also chmods to `mode` (default 0o600) so files
+ * holding user data — tokens, bookmarks, settings — are owner-readable
+ * only.
+ *
+ * Ensures the parent directory exists before writing.
+ */
+export declare function atomicWriteFile(path: string, body: string, mode?: number): void;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../src/atomic-write.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,SAAQ,GAAG,IAAI,CAU9E"}

package/dist/atomic-write.js

@@ -0,0 +1,23 @@
+import { writeFileSync, renameSync, chmodSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+/**
+ * Write `body` to `path` atomically: writes to `path.tmp`, then renames
+ * over the destination. Also chmods to `mode` (default 0o600) so files
+ * holding user data — tokens, bookmarks, settings — are owner-readable
+ * only.
+ *
+ * Ensures the parent directory exists before writing.
+ */
+export function atomicWriteFile(path, body, mode = 0o600) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, body, { mode });
+    renameSync(tmp, path);
+    try {
+        chmodSync(path, mode);
+    }
+    catch {
+        /* renameSync sometimes resets mode on some filesystems — best-effort */
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../src/atomic-write.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,IAAI,GAAG,KAAK;IACtE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC;IAC1B,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACnC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;AACH,CAAC"}

package/dist/auth/refresh.d.ts

@@ -0,0 +1,17 @@
+import type { AgoraState } from '../state.js';
+import type { FetchLike } from '../live.js';
+export interface EnsureFreshOpts {
+    dataDir: string;
+    fetcher?: FetchLike;
+    /** Seconds of slack before access exp at which to refresh. Default 60. */
+    slack?: number;
+}
+/**
+ * Returns auth with a fresh access token, refreshing if needed.
+ * Persists the rotated pair back to state.json on success.
+ * Returns the original auth (untouched) if:
+ *   - no refresh token available, OR
+ *   - refresh request fails (let the API call fail with 401 downstream)
+ */
+export declare function ensureFreshAccess(state: AgoraState, opts: EnsureFreshOpts): Promise<AgoraState>;
+//# sourceMappingURL=refresh.d.ts.map

package/dist/auth/refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../src/auth/refresh.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,UAAU,CAAC,CA0CrB"}

package/dist/auth/refresh.js

@@ -0,0 +1,50 @@
+import { setAuthState, getAuthState, clearAuthState, writeAgoraState } from '../state.js';
+/**
+ * Returns auth with a fresh access token, refreshing if needed.
+ * Persists the rotated pair back to state.json on success.
+ * Returns the original auth (untouched) if:
+ *   - no refresh token available, OR
+ *   - refresh request fails (let the API call fail with 401 downstream)
+ */
+export async function ensureFreshAccess(state, opts) {
+    const auth = getAuthState(state);
+    if (!auth || !auth.apiUrl)
+        return state;
+    const now = Math.floor(Date.now() / 1000);
+    const slack = opts.slack ?? 60;
+    if (auth.accessExp > now + slack)
+        return state; // still fresh
+    if (!auth.refreshToken)
+        return state; // can't refresh
+    const fetcher = opts.fetcher ?? globalThis.fetch;
+    try {
+        const res = await fetcher(`${auth.apiUrl.replace(/\/+$/, '')}/auth/refresh`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ refresh_token: auth.refreshToken })
+        });
+        if (res.status === 401) {
+            // Refresh revoked/expired — clear local auth so next attempt is clean
+            const cleared = clearAuthState(state);
+            writeAgoraState(opts.dataDir, cleared);
+            return cleared;
+        }
+        if (!res.ok)
+            return state; // transient; let caller retry
+        const data = (await res.json());
+        const nowSec = Math.floor(Date.now() / 1000);
+        const next = setAuthState(state, {
+            accessToken: data.access_token,
+            accessExp: nowSec + (data.expires_in || 0),
+            refreshToken: data.refresh_token,
+            refreshExp: nowSec + (data.refresh_expires_in || 0),
+            apiUrl: auth.apiUrl
+        });
+        writeAgoraState(opts.dataDir, next);
+        return next;
+    }
+    catch {
+        return state; // network error; let caller fail naturally
+    }
+}
+//# sourceMappingURL=refresh.js.map

package/dist/auth/refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refresh.js","sourceRoot":"","sources":["../../src/auth/refresh.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAU1F;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAiB,EACjB,IAAqB;IAErB,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,IAAI,IAAI,CAAC,SAAS,GAAG,GAAG,GAAG,KAAK;QAAE,OAAO,KAAK,CAAC,CAAC,cAAc;IAC9D,IAAI,CAAC,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC,CAAC,gBAAgB;IAEtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC;IACjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,EAAE;YAC3E,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;SAC3D,CAAC,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACvB,sEAAsE;YACtE,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvC,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,KAAK,CAAC,CAAC,8BAA8B;QACzD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAK7B,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE;YAC/B,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,SAAS,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;YAC1C,YAAY,EAAE,IAAI,CAAC,aAAa;YAChC,UAAU,EAAE,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,CAAC;YACnD,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,CAAC,2CAA2C;IAC3D,CAAC;AACH,CAAC"}

package/dist/cli/app.d.ts

@@ -1,22 +1,17 @@
 import { type MarketplaceItem } from '../marketplace.js';
-import { type FetchLike } from '../live.js';
-type OutputStream = {
-    write(chunk: string): unknown;
-};
-export interface CliIo {
-    stdout: OutputStream;
-    stderr: OutputStream;
-    env?: Record<string, string | undefined>;
-    cwd?: string;
-    fetcher?: FetchLike;
-}
-export interface ParsedArgs {
-    command?: string;
-    args: string[];
-    flags: Record<string, string | boolean>;
-}
+import { type Styler } from '../ui.js';
+import { type CliIo } from './flags.js';
+export declare const AGORA_VERSION: string;
+/**
+ * Levenshtein-based suggestion: when the user mistypes a command, pick the
+ * closest registered name if it's within edit-distance 3 AND no further from
+ * the input than half its length (so "z" doesn't suggest "saved").
+ */
+export declare function nearestCommand(input: string): string | null;
 export declare function runCli(argv: string[], io: CliIo): Promise<number>;
-export declare function parseArgs(argv: string[]): ParsedArgs;
+export declare function commandManual(name: string): string;
+export declare function commandCompletions(parsed: {
+    args: string[];
+}, io: CliIo, _style: Styler): Promise<number>;
 export declare function listKnownItems(): MarketplaceItem[];
-export {};
 //# sourceMappingURL=app.d.ts.map

package/dist/cli/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/cli/app.ts"],"names":[],"mappings":"AAUA,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAeL,KAAK,SAAS,EAGf,MAAM,YAAY,CAAC;AAqBpB,KAAK,YAAY,GAAG;IAClB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CACzC;AAaD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAmEvE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAsDpD;AAwwCD,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAElD"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/cli/app.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAmD,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAExF,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAoBnD,eAAO,MAAM,aAAa,QAAc,CAAC;AAGzC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAc3D;AA0BD,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAqIvE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,EAC1B,EAAE,EAAE,KAAK,EACT,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAUjB;AAED,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAElD"}