@vibesdotdev/cli 0.0.1 → 1.0.0-rc.2

package/package.json

@@ -1,174 +1,252 @@
 {
   "name": "@vibesdotdev/cli",
-  "version": "0.0.1",
-  "type": "module",
-  "bin": {
-    "vibes": "./bin/vibes.ts"
+  "version": "1.0.0-rc.2",
+  "dependencies": {
+    "@vibesdotdev/docs-contracts": "^1.0.0-rc.4",
+    "@vibesdotdev/filesystem": "^1.0.0-rc.2",
+    "@vibesdotdev/paths": "^1.0.0-rc.3",
+    "@vibesdotdev/config": "^1.0.0-rc.2",
+    "@vibesdotdev/logging": "^1.0.0-rc.3",
+    "@vibesdotdev/kernel": "^1.0.0-rc.5",
+    "@vibesdotdev/host-bun": "^1.0.0-rc.2",
+    "@vibesdotdev/host-node": "^1.0.0-rc.2",
+    "commander": "^14.0.3",
+    "yaml": "^2.9.1",
+    "zod": "^4.6.7",
+    "@vibesdotdev/cli-contracts": "^1.0.0-rc.3",
+    "@vibesdotdev/design-tokens": "^1.0.0-rc.2"
+  },
+  "peerDependencies": {
+    "@vibesdotdev/tui": "^1.0.0-rc.2",
+    "react": "^19.3.1"
   },
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "bun": "./dist/index.js",
       "types": "./dist/index.d.ts",
-      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
-    "./bootstrap": {
-      "types": "./dist/bootstrap.d.ts",
-      "bun": "./src/bootstrap.ts",
-      "import": "./dist/bootstrap.js",
-      "default": "./dist/bootstrap.js"
+    "./design-inventory": {
+      "bun": "./dist/design-inventory.js",
+      "types": "./dist/design-inventory.d.ts",
+      "import": "./dist/design-inventory.js",
+      "default": "./dist/design-inventory.js"
     },
+    "./bin": null,
     "./plugin": {
-      "types": "./dist/cli.plugin.d.ts",
-      "bun": "./src/cli.plugin.ts",
-      "import": "./dist/cli.plugin.js",
-      "default": "./dist/cli.plugin.js"
+      "bun": "./dist/commands/cli.plugin.js",
+      "types": "./dist/commands/cli.plugin.d.ts",
+      "import": "./dist/commands/cli.plugin.js",
+      "default": "./dist/commands/cli.plugin.js"
+    },
+    "./kinds": {
+      "bun": "./dist/commands/cli.kinds.js",
+      "types": "./dist/commands/cli.kinds.d.ts",
+      "import": "./dist/commands/cli.kinds.js",
+      "default": "./dist/commands/cli.kinds.js"
+    },
+    "./completion/kinds": {
+      "bun": "./dist/commands/completion/completion.kinds.js",
+      "types": "./dist/commands/completion/completion.kinds.d.ts",
+      "import": "./dist/commands/completion/completion.kinds.js",
+      "default": "./dist/commands/completion/completion.kinds.js"
     },
-    "./cli.plugin": {
-      "types": "./dist/cli.plugin.d.ts",
-      "bun": "./src/cli.plugin.ts",
-      "import": "./dist/cli.plugin.js",
-      "default": "./dist/cli.plugin.js"
+    "./completion/plugin": {
+      "bun": "./dist/commands/completion/completion.consumer.plugin.js",
+      "types": "./dist/commands/completion/completion.consumer.plugin.d.ts",
+      "import": "./dist/commands/completion/completion.consumer.plugin.js",
+      "default": "./dist/commands/completion/completion.consumer.plugin.js"
+    },
+    "./output-formats": {
+      "bun": "./dist/support/ui/format.plugin.js",
+      "types": "./dist/support/ui/format.plugin.d.ts",
+      "import": "./dist/support/ui/format.plugin.js",
+      "default": "./dist/support/ui/format.plugin.js"
+    },
+    "./schemas/descriptors": {
+      "bun": "./dist/schemas/descriptors.js",
+      "types": "./dist/schemas/descriptors.d.ts",
+      "import": "./dist/schemas/descriptors.js",
+      "default": "./dist/schemas/descriptors.js"
+    },
+    "./schemas/types": {
+      "bun": "./dist/schemas/types.js",
+      "types": "./dist/schemas/types.d.ts",
+      "import": "./dist/schemas/types.js",
+      "default": "./dist/schemas/types.js"
     },
     "./config": {
-      "types": "./dist/config.d.ts",
-      "bun": "./src/config.ts",
-      "import": "./dist/config.js",
-      "default": "./dist/config.js"
+      "bun": "./dist/boot/config.js",
+      "types": "./dist/boot/config.d.ts",
+      "import": "./dist/boot/config.js",
+      "default": "./dist/boot/config.js"
     },
-    "./core": {
-      "types": "./dist/core/index.d.ts",
-      "bun": "./src/core/index.ts",
-      "import": "./dist/core/index.js",
-      "default": "./dist/core/index.js"
+    "./bootstrap": {
+      "bun": "./dist/boot/bootstrap.js",
+      "types": "./dist/boot/bootstrap.d.ts",
+      "import": "./dist/boot/bootstrap.js",
+      "default": "./dist/boot/bootstrap.js"
     },
     "./cli/runtime/shared/context": {
+      "bun": "./dist/core/runtime/shared/context.js",
       "types": "./dist/core/runtime/shared/context.d.ts",
-      "bun": "./src/core/runtime/shared/context.ts",
       "import": "./dist/core/runtime/shared/context.js",
       "default": "./dist/core/runtime/shared/context.js"
     },
     "./cli/runtime/shared/options": {
+      "bun": "./dist/core/runtime/shared/options.js",
       "types": "./dist/core/runtime/shared/options.d.ts",
-      "bun": "./src/core/runtime/shared/options.ts",
       "import": "./dist/core/runtime/shared/options.js",
       "default": "./dist/core/runtime/shared/options.js"
     },
-    "./*": {
-      "types": "./dist/*.d.ts",
-      "bun": "./src/*.ts",
-      "import": "./dist/*.js",
-      "default": "./dist/*.js"
-    },
-    "./*.js": {
-      "types": "./dist/*.d.ts",
-      "bun": "./src/*.ts",
-      "import": "./dist/*.js",
-      "default": "./dist/*.js"
-    },
-    "./*/*": {
-      "types": "./dist/*/*.d.ts",
-      "bun": "./src/*/*.ts",
-      "import": "./dist/*/*.js",
-      "default": "./dist/*/*.js"
-    },
-    "./*/*.js": {
-      "types": "./dist/*/*.d.ts",
-      "bun": "./src/*/*.ts",
-      "import": "./dist/*/*.js",
-      "default": "./dist/*/*.js"
-    },
-    "./*/*/*": {
-      "types": "./dist/*/*/*.d.ts",
-      "bun": "./src/*/*/*.ts",
-      "import": "./dist/*/*/*.js",
-      "default": "./dist/*/*/*.js"
-    },
-    "./*/*/*.js": {
-      "types": "./dist/*/*/*.d.ts",
-      "bun": "./src/*/*/*.ts",
-      "import": "./dist/*/*/*.js",
-      "default": "./dist/*/*/*.js"
-    },
-    "./*/*/*/*": {
-      "types": "./dist/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*.js",
-      "default": "./dist/*/*/*/*.js"
-    },
-    "./*/*/*/*.js": {
-      "types": "./dist/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*.js",
-      "default": "./dist/*/*/*/*.js"
-    },
-    "./*/*/*/*/*": {
-      "types": "./dist/*/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*/*.js",
-      "default": "./dist/*/*/*/*/*.js"
-    },
-    "./*/*/*/*/*.js": {
-      "types": "./dist/*/*/*/*/*.d.ts",
-      "bun": "./src/*/*/*/*/*.ts",
-      "import": "./dist/*/*/*/*/*.js",
-      "default": "./dist/*/*/*/*/*.js"
+    "./surface/interactive-gate": null,
+    "./surface/interactive-gate.js": null,
+    "./surface": {
+      "bun": "./dist/surface/index.js",
+      "types": "./dist/surface/index.d.ts",
+      "import": "./dist/surface/index.js",
+      "default": "./dist/surface/index.js"
+    },
+    "./bun": {
+      "bun": "./dist/bun/index.js",
+      "types": "./dist/bun/index.d.ts",
+      "import": "./dist/bun/index.js",
+      "default": "./dist/bun/index.js"
+    },
+    "./vibesdev": {
+      "bun": "./dist/support/vibesdev/index.js",
+      "types": "./dist/support/vibesdev/index.d.ts",
+      "import": "./dist/support/vibesdev/index.js",
+      "default": "./dist/support/vibesdev/index.js"
+    },
+    "./providers": {
+      "bun": "./dist/boot/providers.js",
+      "types": "./dist/boot/providers.d.ts",
+      "import": "./dist/boot/providers.js",
+      "default": "./dist/boot/providers.js"
+    },
+    "./output": {
+      "bun": "./dist/commands/output.js",
+      "types": "./dist/commands/output.d.ts",
+      "import": "./dist/commands/output.js",
+      "default": "./dist/commands/output.js"
+    },
+    "./schemas/surface": {
+      "bun": "./dist/schemas/surface.js",
+      "types": "./dist/schemas/surface.d.ts",
+      "import": "./dist/schemas/surface.js",
+      "default": "./dist/schemas/surface.js"
+    },
+    "./support/ui-toolkit": {
+      "bun": "./dist/support/ui/toolkit.js",
+      "types": "./dist/support/ui/toolkit.d.ts",
+      "import": "./dist/support/ui/toolkit.js",
+      "default": "./dist/support/ui/toolkit.js"
+    },
+    "./support/terminal-input": {
+      "bun": "./dist/support/terminal-input.js",
+      "types": "./dist/support/terminal-input.d.ts",
+      "import": "./dist/support/terminal-input.js",
+      "default": "./dist/support/terminal-input.js"
+    },
+    "./host-bootstrap": {
+      "bun": "./dist/boot/host-bootstrap.js",
+      "types": "./dist/boot/host-bootstrap.d.ts",
+      "import": "./dist/boot/host-bootstrap.js",
+      "default": "./dist/boot/host-bootstrap.js"
+    },
+    "./tui-plugin-policy": {
+      "bun": "./dist/boot/tui-plugin-policy.js",
+      "types": "./dist/boot/tui-plugin-policy.d.ts",
+      "import": "./dist/boot/tui-plugin-policy.js",
+      "default": "./dist/boot/tui-plugin-policy.js"
+    },
+    "./host-argv": {
+      "bun": "./dist/boot/host-argv.js",
+      "types": "./dist/boot/host-argv.d.ts",
+      "import": "./dist/boot/host-argv.js",
+      "default": "./dist/boot/host-argv.js"
+    },
+    "./types": {
+      "bun": "./dist/boot/schemas/types.js",
+      "types": "./dist/boot/schemas/types.d.ts",
+      "import": "./dist/boot/schemas/types.js",
+      "default": "./dist/boot/schemas/types.js"
+    },
+    "./commands/runtime/export": {
+      "bun": "./dist/commands/runtime/export.js",
+      "types": "./dist/commands/runtime/export.d.ts",
+      "import": "./dist/commands/runtime/export.js",
+      "default": "./dist/commands/runtime/export.js"
+    },
+    "./surface/discovery-cache": {
+      "bun": "./dist/surface/discovery-cache.js",
+      "types": "./dist/surface/discovery-cache.d.ts",
+      "import": "./dist/surface/discovery-cache.js",
+      "default": "./dist/surface/discovery-cache.js"
+    },
+    "./surface/exit": {
+      "bun": "./dist/surface/exit.js",
+      "types": "./dist/surface/exit.d.ts",
+      "import": "./dist/surface/exit.js",
+      "default": "./dist/surface/exit.js"
+    },
+    "./surface/CLISurface": {
+      "bun": "./dist/surface/CLISurface.js",
+      "types": "./dist/surface/CLISurface.d.ts",
+      "import": "./dist/surface/CLISurface.js",
+      "default": "./dist/surface/CLISurface.js"
+    },
+    "./surface/attach-tui-action": {
+      "bun": "./dist/surface/attach-tui-action.js",
+      "types": "./dist/surface/attach-tui-action.d.ts",
+      "import": "./dist/surface/attach-tui-action.js",
+      "default": "./dist/surface/attach-tui-action.js"
+    },
+    "./docs/generate": {
+      "bun": "./dist/commands/docs/generate.js",
+      "types": "./dist/commands/docs/generate.d.ts",
+      "import": "./dist/commands/docs/generate.js",
+      "default": "./dist/commands/docs/generate.js"
+    },
+    "./version": {
+      "bun": "./dist/boot/version.js",
+      "types": "./dist/boot/version.d.ts",
+      "import": "./dist/boot/version.js",
+      "default": "./dist/boot/version.js"
+    },
+    "./logging": {
+      "bun": "./dist/support/logging/logging.js",
+      "types": "./dist/support/logging/logging.d.ts",
+      "import": "./dist/support/logging/logging.js",
+      "default": "./dist/support/logging/logging.js"
+    },
+    "./package.json": "./package.json",
+    "./commands/runtime/codegen": {
+      "bun": "./dist/commands/runtime/codegen.js",
+      "types": "./dist/commands/runtime/codegen.d.ts",
+      "import": "./dist/commands/runtime/codegen.js",
+      "default": "./dist/commands/runtime/codegen.js"
+    },
+    "./codegen/declarations": {
+      "bun": "./dist/commands/runtime/codegen.declarations.js",
+      "types": "./dist/commands/runtime/codegen.declarations.d.ts",
+      "import": "./dist/commands/runtime/codegen.declarations.js",
+      "default": "./dist/commands/runtime/codegen.declarations.js"
+    },
+    "./codegen/command": {
+      "bun": "./dist/commands/runtime/codegen.command.impl.js",
+      "types": "./dist/commands/runtime/codegen.command.impl.d.ts",
+      "import": "./dist/commands/runtime/codegen.command.impl.js",
+      "default": "./dist/commands/runtime/codegen.command.impl.js"
     }
   },
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org",
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/vibesdotdev/monorepo.git",
-    "directory": "packages/cli"
-  },
-  "peerDependencies": {
-    "@vibesdotdev/config": "0.0.1",
-    "@vibesdotdev/localdb": "0.0.1",
-    "@vibesdotdev/runtime": "0.0.1",
-    "@vibesdotdev/logging": "0.0.1",
-    "@vibesdotdev/runtime-surface-cli": "0.0.1",
-    "@vibesdotdev/storage": "0.0.1",
-    "@vibesdotdev/tui": "0.0.1"
-  },
-  "dependencies": {
-    "@vibesdotdev/client": "0.1.0",
-    "@vibesdotdev/config": "0.0.1",
-    "@vibesdotdev/localdb": "0.0.1",
-    "@vibesdotdev/logging": "0.0.1",
-    "@vibesdotdev/runtime": "0.0.1",
-    "@vibesdotdev/runtime-bun": "0.0.0",
-    "@vibesdotdev/runtime-environment-bun": "0.0.0",
-    "@vibesdotdev/storage": "0.0.1",
-    "@vibesdotdev/tui": "0.0.1",
-    "commander": "^14.0.3",
-    "yaml": "^2.9.0",
-    "zod": "^4.3.6",
-    "@vibesdotdev/runtime-surface-cli": "0.0.1"
-  },
-  "scripts": {
-    "test": "bun test",
-    "check": "bun --bun tsc -p tsconfig.json --noEmit",
-    "build": "tsc -p tsconfig.json"
-  },
-  "license": "MIT",
   "files": [
     "dist",
-    "src",
-    "bin",
     "README.md",
-    "SPEC.md",
     "LICENSE",
-    "!src/**/__tests__/**",
-    "!src/**/__stubs__/**",
-    "!src/**/*.test.ts",
-    "!src/**/*.test.tsx",
-    "!src/**/*.spec.ts",
-    "!src/**/*.spec.tsx",
     "!dist/**/__tests__/**",
     "!dist/**/__stubs__/**",
     "!dist/**/*.test.js",
@@ -178,9 +256,67 @@
     "!dist/**/*.spec.js",
     "!dist/**/*.spec.js.map",
     "!dist/**/*.spec.d.ts",
-    "!dist/**/*.spec.d.ts.map"
+    "!dist/**/*.spec.d.ts.map",
+    "!dist/**/*.tsbuildinfo"
   ],
+  "scripts": {
+    "lint": "node ../node_modules/@vibesdotdev/internal-oxlint-toolchain/ratchet.mjs .",
+    "test": "${BUN:-bun} test src && ${BUN:-bun} run test:node",
+    "test:node": "rm -rf .cache/node-run && ${BUN:-bun} build --target=node --conditions=bun --splitting --format=esm --external '@opentui/*' --outdir .cache/node-run/bundle src/__tests__/node-run/surface.node-run.ts && node --test .cache/node-run/bundle/surface.node-run.js",
+    "check": "${BUN:-bun} --bun tsc -p tsconfig.json",
+    "build:design-inventory": "${BUN:-bun} --bun tsc -p tsconfig.inventory.json",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "directory": "cli"
+  },
+  "publishConfig": {
+    "registry": "https://packages.vibes.dev",
+    "access": "public"
+  },
   "vibes": {
-    "visibility": "public-framework"
+    "visibility": "public",
+    "registry": {
+      "repositoryId": "4b1374d4-6830-4bfd-98e3-de66416368a8",
+      "directory": "cli"
+    },
+    "handedRuntimeLogging": true,
+    "tooling": [
+      ".opencode"
+    ],
+    "compositionRoots": [
+      "src/commands/output.ts",
+      "src/support/terminal-input.ts",
+      "src/boot/bootstrap.ts",
+      "src/bun/index.ts",
+      "src/bun/interactive-host.ts",
+      "dist/bun/index.js",
+      ".opencode/tools/vibes.ts"
+    ]
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "description": "Descriptor-driven CLI framework for composing Vibes command groups and commands.",
+  "homepage": "https://docs.vibes.dev/cli",
+  "bugs": {
+    "url": "https://docs.vibes.dev/cli#support"
+  },
+  "//vibes-dual-exports-exempt": "pure consumer-only CLI; never runs in Node SvelteKit/Cloudflare builds (docs/dual-package-exports.md)",
+  "peerDependenciesMeta": {
+    "@vibesdotdev/tui": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "gitHead": "51230ebdad54bc405014633f435b499fa2a06b89",
+  "_vibes_source": {
+    "repo": "ssh://git@git.vibes.dev/vibesdotdev/framework.git",
+    "sha": "51230ebdad54bc405014633f435b499fa2a06b89",
+    "workspaceDigest": "sha256:fdd133f02b3ca6458729015332798fe10e1162f4207d4742bb807c3e0d4ce239"
   }
 }

package/SPEC.md

@@ -1,97 +0,0 @@
-# @vibesdotdev/cli
-
-Command-surface substrate: turns runtime `cli/group` and `cli/command` descriptors into a Commander.js CLI tree. Registers the CLI kinds, discovers and renders commands from the live descriptor graph, provides pattern-based command generation (CRUD, config-namespace, tool-wrapper, log-viewer, process-manager), shell completion, and CLI-scoped context providers (UI, logger, app, output-format). Does not own domain behavior — every command's logic lives in the owning feature package; cli only adapts and renders it.
-
-## Owns
-
-- **Bootstrap composition** (`./bootstrap`): `createVibesCliApp({ loader, defaultPlugins, ... })` — composes the runtime loader, core plugins, project-config plugin overrides, and the CLISurface. Accepts a statically-imported `defaultPlugins` set so `bun build --compile` can satisfy the Bundle Selection Rule.
-- **Binary entrypoint** (`./bin/vibes.ts`): `#!/usr/bin/env bun` wrapper calling `createVibesCliApp({ defaultPlugins })`; used by `bunx @vibesdotdev/cli` and the compiled binary wrapper at `apps/cli-bin/src/bin/vibes.ts`.
-- **Runtime kinds:** `cli/group`, `cli/command`
-- **Plugin descriptors:** `cli.plugin` registers the two CLI kinds + the built-in `completion` (`cli/command`) descriptor; depends on `context` kind
-- **CLISurface** (`./surface`): Commander.js program lifecycle — initialize (register providers → resolve patterns → discover groups → discover commands), run (parse argv, dispatch, handle errors)
-  - `register-groups.ts` — depth-first group sorting, parent-chain resolution, pattern delegation
-  - `register-commands.ts` — argument/option mapping, pattern detection, TUI bridging, implementation resolution via `runtime.query().resolve()`
-  - `build-context.ts` — assembles `CommandContext` (runtime + ui + logger + app + config) with fallback lookups
-  - `attach-tui-action.ts` — dynamic import bridge for commands with `tuiAppId`
-  - `command-group-policy.ts` — allowed root-fallback groups; orphan detection
-- **Pattern system** (`./patterns`): declarative command generation from descriptors
-  - `resolver.ts` — `PatternResolver` registry + factory wiring all 5 built-in patterns
-  - `crud.ts` — list/get/create/update/delete against any storage kind
-  - `config-namespace.ts` — get/set/reset/list for a config namespace
-  - `tool-wrapper.ts` — wraps a `tools/tool` asset as a CLI command
-  - `log-viewer.ts` — tail/search/levels for log streaming
-  - `process-manager.ts` — start/stop/restart/status/logs for daemon processes
-  - `schemas.ts` — Zod schemas + type guards for all 5 pattern variants
-- **Descriptor schemas** (`./schemas`): Zod schemas for `cli/group`, `cli/command`; TypeScript module augmentation for the runtime registry; `CLISurfaceOptions`, `CommandContext`
-- **CLI context providers** (`./providers`): registers 5 context loaders with the runtime — `cli/ui` (terminal output), `cli/logger` (cli-namespaced logging), `cli/app` (app-level state), `cli/invocation` (invocation metadata), `cli/output-format` (json/yaml/text detection); also exports `detectOutputFormat()`, `requestCLIExit()`, `shouldKeepAlive()`, `resetKeepAlive()`, `CLIExitSignal`
-- **Error types** (`./errors`): `CLIError` hierarchy — `CommandNotFound`, `InvalidArgument`, `MissingArgument`, `AuthRequired`, `PermissionDenied`, `NotFound`, `Config`, `Network`, `Timeout`, `UserCancelled`
-- **Shell completion** (`./commands/completion`): bash, zsh (including widget), fish, Fig spec generators — rendered from the live descriptor tree
-- **UI toolkit** (`./support/ui-toolkit`): `VibesUIToolkit` — terminal formatting (json/yaml/table/markdown), interactive prompts (prompt/confirm/select/multiselect), progress reporting
-- **Binary path resolution** (`./bin`): monorepo-aware `vibes` binary discovery + worker invocation command builder
-- **Config facade** (`./config`): re-exports `VibesAppConfig`/`PluginsConfig` from `@vibesdotdev/runtime/config` and provides `defineConfig()` typed for project-level `vibes.config.ts`. The CLI does not own the config schema — that lives in `runtime/config`; the facade exists so projects don't need to import from `runtime` directly.
-- **Logging shim** (`./logging`): `'cli'`-namespaced logger singleton wrapping `@vibesdotdev/logging`
-- **Open utility** (`./utils/open`): cross-platform `open(url)`
-- **CLI-startup logger descriptor** (`./logging/cli-startup.logger.descriptor.ts`): registers `'cli-startup'` logger under `'cli:startup'`
-- **UI context descriptor** (`./ui.context.descriptor.ts`): declares `cli/ui` as consumer-hardware-only
-
-## Does not own
-
-- Domain business logic, data access layers, storage engines, encryption, or CRUD services → owning feature packages (e.g., config domain → [`config`](../config/SPEC.md), auth → [`auth-system`](../auth-system/SPEC.md)). CLI is a rendering adapter only.
-- Binary compilation/distribution → [`cli-bin`](../cli-bin/SPEC.md) (wraps `packages/cli/bin/vibes.ts`).
-- Runtime loader implementation → [`runtime-bun`](../runtime-bun/SPEC.md) (Bun), [`runtime`](../runtime/SPEC.md) (interface).
-- TUI substrate (gateway, dispatcher, kinds, React hosting) → [`tui`](../tui/SPEC.md). CLI bridges to TUI via `attach-tui-action.ts` but does not own it.
-- Runtime plugin infrastructure, kind registration protocol, resolver chain → [`runtime`](../runtime/SPEC.md). CLI consumes kinds; it does not define the plugin contract.
-- Workspace data model, project state, active-project tracking → [`workspace`](../workspace/SPEC.md).
-- Auth credentials, session tokens, login flows → [`auth-system`](../auth-system/SPEC.md).
-- HTTP client construction, API connection testing, session refresh → [`client`](../client/SPEC.md). CLI may consume a resolved client; it must not build one.
-- Config storage backends (LocalDB, JSON file, encryption) → [`config`](../config/SPEC.md) + [`storage`](../storage/SPEC.md).
-- MCP protocol, transport, server lifecycle → [`mcp`](../mcp/SPEC.md).
-- Process manager engine, daemon lifecycle, resource registry → [`pm`](../pm/SPEC.md). CLI wraps PM via the `process-manager` pattern only.
-
-## Hard rules
-
-- **CLI is a descriptor rendering layer, not a domain owner.** Every command's execute path must resolve to an implementation owned by a feature package. CLI code must not contain business logic, validation rules, data transformations, or state mutations that belong in a domain package.
-- **All commands register through the descriptor surface.** Imperative `parent.command(...)` calls outside of `patterns/*` and `commands/completion/` are forbidden. Feature packages export `cli/command` descriptors; CLISurface discovers and renders them.
-- **No upstream package may import domain code from CLI.** `packages/cli` is a leaf/consumer package. New imports into `src/app/`, `src/api/`, or `src/core/` from any non-CLI package are blocked.
-- **No direct storage / database access.** CLI code must not import `@vibesdotdev/localdb`, run raw SQL, construct database connections, or manage migration scripts. All data access flows through runtime-resolved assets or context-provided services.
-- **No mutable global singletons.** The `getContext()/setContext()` pattern in `core/runtime/context.ts` is banned for new code. All context flows through the runtime's context injection system.
-- **Patterns are pure CLI translation layers.** Pattern implementations must only map descriptors to Commander.js arguments/options and delegate execution to the resolved implementation. No business logic beyond CLI input coercion.
-- **Completion is derived from the live descriptor tree.** Shell completion output reflects the current registered descriptors without changes to the completion module when new commands are added.
-- **Error types map to deterministic exit codes.** Every `CLIError` subclass has a deterministic exit code. Domain errors are wrapped, not raw. CLI layer formats user-facing errors; it must not expose internal stack traces in normal operation.
-- **Tolerant surface, strict audit.** `strictCommandGroups` and `strictGroupParents` default to off — a config-driven plugin set will routinely produce orphaned descriptors and the surface drops them quietly (warns under `--verbose`). Strict mode is opt-in via the bootstrap `strict` option or `VIBES_CLI_STRICT=1` and is reserved for CI / descriptor audits.
-
-## Migration debt (not yet executed)
-
-- **`src/app/config/` (~40 files)** — full config domain module: SQLite-backed `ConfigStorageService` (raw SQL, migrations), AES-256-GCM encryption service, config business logic monolith (`executeConfig*`), config loader facade, entity config service, imperative Commander.js command registrations. Belongs in [`config`](../config/SPEC.md). **Blocked on:** config package stabilization + migration of all importers off the CLI-internal loader.
-- **`src/api/`** — HTTP client factory + API test/debug service. Belongs in [`client`](../client/SPEC.md).
-- **`src/core/`** — legacy compatibility shims: mutable global `_context` singleton, file-based JSON namespace registry, legacy plugin/hook types.
-- **`src/commands/runtime/`** — imperative codegen command registration. Should be a `cli/command` descriptor owned by [`tools`](../tools/SPEC.md).
-- **Wildcard exports** in `package.json` — `./*`, `./*/*`, `./*/*/*`, `./*/*/*/*` must be replaced with explicit named entrypoints after migration debt clears.
-
-## Public entrypoints
-
-Canonical (stable):
-- `.` — `createVibesCliApp`, `VibesCliAppOptions`, `VibesCliApp`, `CliPluginLoader`, `CLISurface`, `CLISurfaceOptions`, `CommandContext`, `cliPlugin`, pattern types/errors/providers/bin utilities
-- `./bootstrap` — `createVibesCliApp`, types (also re-exported from `.`)
-- `./plugin` — default export: `cliPlugin`
-- `./config` — `VibesAppConfig`, `PluginsConfig`, `VibesConfig`, `defineConfig()`
-
-Migration-era (do not normalize new code against):
-- `./app/config/loader*` — domain leak; target home is [`config`](../config/SPEC.md)
-- `./core` — legacy shim; do not import in new code
-- Wildcard `./*` paths — will be replaced after migration debt clears
-
-## Verification
-
-`bun test` from package root. Covers descriptor schema validation, pattern resolution (all 5 built-in patterns), group registration ordering, command scope filtering, completion generation (bash/zsh/fish/fig), error-type exit-code mapping, context provider registration.
-
-## Links
-
-- [runtime/SPEC.md](../runtime/SPEC.md)
-- [config/SPEC.md](../config/SPEC.md)
-- [tui/SPEC.md](../tui/SPEC.md)
-- [tools/SPEC.md](../tools/SPEC.md)
-- [cli-bin/SPEC.md](../cli-bin/SPEC.md)
-- [storage/SPEC.md](../storage/SPEC.md)
-- [SPEC-AUDIT.md](../../docs/architecture/SPEC-AUDIT.md)
-- [RUNTIME-FIRST-MODULES.md](../../docs/architecture/RUNTIME-FIRST-MODULES.md)

package/bin/vibes.ts

@@ -1,26 +0,0 @@
-#!/usr/bin/env bun
-/**
- * Vibes CLI Entry Point
- *
- * Used by `bunx @vibesdotdev/cli` and the compiled binary wrapper at
- * `apps/cli-bin/src/bin/vibes.ts`. Both paths now route through the
- * dedicated runtime surface package for bootstrap.
- */
-
-import { createVibesCliApp } from "@vibesdotdev/runtime-surface-cli";
-
-async function main(): Promise<void> {
-  const app = await createVibesCliApp({
-    defaultPlugins: [],
-    verbose: process.argv.includes("-v") || process.argv.includes("--verbose"),
-    includeInternal: false,
-  });
-
-  await app.cli.run(process.argv);
-}
-
-main().catch((error: unknown) => {
-  const msg = error instanceof Error ? error.message : String(error);
-  process.stderr.write(`\n[FATAL] ${msg}\n`);
-  process.exit(1);
-});

package/dist/api/client/factory.d.ts

@@ -1,29 +0,0 @@
-/**
- * API client factory - creates configured clients for CLI commands
- * This is the central service that replaces direct database access
- * Uses the cfg -> env -> auth hooks system for configuration
- */
-import type { RuntimeContext } from '../types.ts';
-import type { APIClientConfig } from '../schemas/types.ts';
-import { VibesClient } from '@vibesdotdev/client/core';
-/**
- * Create a configured API client using current environment and auth settings
- * This is what ALL CLI modules should use instead of direct database access
- *
- * Uses the hooks system: cfg -> env -> auth -> api
- */
-export declare function createConfiguredClient(context?: RuntimeContext): Promise<VibesClient>;
-/**
- * Create API client configuration for debugging/inspection
- */
-export declare function createAPIClientConfig(context?: RuntimeContext): Promise<APIClientConfig>;
-/**
- * Test API connection
- */
-export declare function testAPIConnection(endpoint?: string, context?: RuntimeContext): Promise<{
-    success: boolean;
-    status: number;
-    latency: number;
-    error?: string;
-}>;
-//# sourceMappingURL=factory.d.ts.map

package/dist/api/client/factory.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/api/client/factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgIvD;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CA2B3F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAkD9F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,SAAgB,EACxB,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAyBD"}