@inspecto-dev/cli 0.2.0-alpha.5 → 0.3.0-alpha.1

package/.turbo/turbo-build.log

@@ -1,20 +1,19 @@
-
-
-> @inspecto-dev/cli@0.2.0-alpha.4 build /Users/bytedance/Works/hugo.felix/inspecto/packages/cli
-> tsup
-
-CLI Building entry: src/bin.ts, src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.1
-CLI Using tsup config: /Users/bytedance/Works/hugo.felix/inspecto/packages/cli/tsup.config.ts
-CLI Target: node18
-CLI Cleaning output folder
-ESM Build start
-ESM dist/chunk-MIHQGC3L.js 58.03 KB
-ESM dist/bin.js            2.64 KB
-ESM dist/index.js          109.00 B
-ESM ⚡️ Build success in 32ms
-DTS Build start
-DTS ⚡️ Build success in 1096ms
-DTS dist/bin.d.ts   13.00 B
-DTS dist/index.d.ts 1.18 KB
+
+> @inspecto-dev/cli@0.3.0-alpha.1 build /Users/tangjie/hugo.felix/inspecto/packages/cli
+> tsup
+
+CLI Building entry: src/bin.ts, src/index.ts
+CLI Using tsconfig: tsconfig.json
+CLI tsup v8.5.1
+CLI Using tsup config: /Users/tangjie/hugo.felix/inspecto/packages/cli/tsup.config.ts
+CLI Target: node18
+CLI Cleaning output folder
+ESM Build start
+ESM dist/index.js          319.00 B
+ESM dist/bin.js            20.37 KB
+ESM dist/chunk-FZS2TLXQ.js 103.35 KB
+ESM ⚡️ Build success in 61ms
+DTS Build start
+DTS ⚡️ Build success in 5204ms
+DTS dist/bin.d.ts   185.00 B
+DTS dist/index.d.ts 7.79 KB

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @inspecto-dev/cli
 
+## 0.3.0-alpha.1
+
+### Minor Changes
+
+- Prepare the first `0.3.0-alpha.1` release line for Inspecto's browser-first workflow.
+  - unify onboarding around assistant-first setup and the single-entry `inspecto onboard --json` contract
+  - stabilize the browser UX across `Inspect`, `Annotate`, and `Alt + Click` quick jump
+  - tighten prompt and settings schema boundaries and keep evidence toggles built-in
+  - refresh README, website, onboarding docs, and playgrounds to match the shipped workflow
+  - refactor large runtime modules without intended behavior changes
+
+### Patch Changes
+
+- Updated dependencies
+  - @inspecto-dev/types@0.3.0-alpha.1
+
+## 0.2.0-alpha.6
+
+### Minor Changes
+
+- release alpha test version
+
 ## 0.2.0-alpha.5
 
 ### Minor Changes

package/README.md

@@ -1,6 +1,39 @@
 # @inspecto-dev/cli
 
-The official command-line interface for Inspecto. This tool automates the process of scaffolding, configuring, and maintaining the Inspecto setup within your project.
+The official command-line interface for Inspecto. This tool automates the process of detecting, planning, applying, and maintaining the Inspecto setup within your project.
+
+## Onboarding Flow
+
+For most users, the preferred setup path is assistant-first onboarding via the integrations documented in:
+`packages/docs/integrations/onboarding-skills.md`
+
+Install those assistant integration assets with:
+
+```bash
+npx @inspecto-dev/cli integrations install <assistant>
+```
+
+Supported assistants currently include `codex`, `claude-code`, `copilot`, `cursor`, `gemini`, `trae`, and `coco`.
+
+Inspect available integration targets with:
+
+```bash
+npx @inspecto-dev/cli integrations list
+npx @inspecto-dev/cli integrations install codex
+npx @inspecto-dev/cli integrations path <assistant>
+```
+
+Use `inspecto init` when you want a guided setup directly in the terminal, or when the assistant path is unavailable.
+
+If you are building your own agent/runtime integration, the machine-readable flow is:
+
+1. `inspecto detect --json`
+2. `inspecto plan --json`
+3. `inspecto apply --json`
+4. `inspecto doctor --json`
+
+See the public onboarding contract for response shapes and field semantics:
+`packages/docs/integrations/onboarding-contract.md`
 
 ## Installation
 
@@ -18,20 +51,53 @@ npm install -D @inspecto-dev/cli
 
 ## Commands
 
-### `inspecto init`
+### `inspecto detect`
 
-The primary command to scaffold Inspecto into a project. It performs a comprehensive environmental analysis and automatically configures Inspecto.
+Detects whether the current project can be onboarded automatically.
 
 **Features:**
 
-- **Package Manager Detection:** Auto-detects `npm`, `pnpm`, `yarn`, or `bun`.
-- **Build Tool / Framework Detection:** Detects Vite, Webpack, Rspack, Rsbuild, and others. Supports legacy versions (e.g., `@rspack/cli < 0.4.0`).
-- **IDE Detection:** Prioritizes environment variables, then falls back to directory structures to accurately detect VS Code, Cursor, Trae, Windsurf, or WebStorm.
-- **AI Tool Detection:** Scans for both CLI-based tools (Claude, Coco, CodeX, Gemini) and IDE Plugins (GitHub Copilot, Claude Code, Gemini, CodeX).
-- **Interactive Prompts:** If multiple build configurations or AI tools are detected, it presents an interactive prompt for you to select your preferred configuration.
-- **AST Injection:** Safely injects the `@inspecto-dev/plugin` into your Vite configuration file (`vite.config.ts`, etc.) using AST transformation, preventing duplicate injections. Manual setup is required for other build tools.
-- **IDE Extension Installation:** Uses a robust 4-level waterfall strategy to install the necessary IDE extension.
-- **Configuration Scaffolding:** Generates the `.inspecto/settings.local.json` file tailored to your detected or selected AI tools, and updates `.gitignore` to prevent committing local settings.
+- Detects the package manager, build tool/framework, IDE, and available AI tools.
+- Produces structured output for agent-driven setup flows.
+
+### `inspecto plan`
+
+Previews the onboarding plan for the current project.
+
+**Features:**
+
+- Summarizes the proposed setup strategy and actions.
+- Produces structured output that agents can inspect before applying changes.
+
+### `inspecto apply [--json]`
+
+Applies the onboarding plan to the current project. Use `--json` when the command is driven by an agent/runtime integration.
+
+**Features:**
+
+- Installs the required `@inspecto-dev/plugin` dependencies.
+- Injects the plugin into supported build configurations.
+- Installs or configures the selected IDE extension when needed.
+- Writes `.inspecto/settings.local.json` and updates `.gitignore` when appropriate.
+
+### `inspecto integrations`
+
+Manages assistant integration assets for the current project.
+
+**Subcommands:**
+
+- `inspecto integrations list` prints the supported assistant targets and their preferred install surfaces.
+- `inspecto integrations path <assistant>` prints the concrete files that a selected variant will create.
+- `inspecto integrations install <assistant>` installs the integration assets for the selected assistant.
+
+Examples:
+
+```bash
+inspecto integrations install codex
+inspecto integrations path codex
+inspecto integrations install claude-code --scope project
+inspecto integrations install cursor --mode rules
+```
 
 ### `inspecto doctor`
 
@@ -43,6 +109,22 @@ A diagnostic command to verify your current environment.
 - Verifies if the IDE is supported.
 - Scans for available AI tools (both CLI and Plugin modes).
 - Validates the current Inspecto installation and configuration.
+- Supports `--json` for agent-friendly diagnostics.
+
+### `inspecto init`
+
+The guided/manual fallback for scaffolding Inspecto into a project. It performs a comprehensive environmental analysis and automatically configures Inspecto in one step.
+
+**Features:**
+
+- **Package Manager Detection:** Auto-detects `npm`, `pnpm`, `yarn`, or `bun`.
+- **Build Tool / Framework Detection:** Detects Vite, Webpack, Rspack, Rsbuild, and others. Supports legacy versions (e.g., `@rspack/cli < 0.4.0`).
+- **IDE Detection:** Prioritizes environment variables, then falls back to directory structures to accurately detect VS Code, Cursor, Trae, Windsurf, or WebStorm.
+- **AI Tool Detection:** Scans for both CLI-based tools (Claude, Coco, CodeX, Gemini) and IDE Plugins (GitHub Copilot, Claude Code, Gemini, CodeX).
+- **Interactive Prompts:** If multiple build configurations or AI tools are detected, it presents an interactive prompt for you to select your preferred configuration.
+- **AST Injection:** Safely injects the `@inspecto-dev/plugin` into your Vite configuration file (`vite.config.ts`, etc.) using AST transformation, preventing duplicate injections. Manual setup is required for other build tools.
+- **IDE Extension Installation:** Uses a robust 4-level waterfall strategy to install the necessary IDE extension.
+- **Configuration Scaffolding:** Generates the `.inspecto/settings.local.json` file tailored to your detected or selected AI tools, and updates `.gitignore` to prevent committing local settings.
 
 ### `inspecto teardown`
 

package/bin/inspecto.js

@@ -1,3 +1,7 @@
 #!/usr/bin/env node
 
-import '../dist/bin.js'
+/* global process */
+
+import { runCli } from '../dist/bin.js'
+
+void runCli(process.argv)

package/dist/bin.d.ts

@@ -1,2 +1,6 @@
+import { CAC } from 'cac';
 
-export {  }
+declare function createCli(_argv?: readonly string[]): CAC;
+declare function runCli(argv?: readonly string[]): Promise<void>;
+
+export { createCli, runCli };