@inspecto-dev/cli 0.3.7 → 0.3.9

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+
 /** Package manager detection result */
 type PackageManager = 'bun' | 'pnpm' | 'yarn' | 'npm';
 /** Supported build tools (v1) */
@@ -111,6 +113,12 @@ interface OnboardingVerification {
     devCommand?: string;
     message: string;
 }
+interface OnboardingDailyUsageHandoff {
+    mode: 'agent';
+    skill: string;
+    prompt: string;
+    requiresMcp: boolean;
+}
 interface OnboardingAssistantHandoff {
     framework?: string;
     metaFramework?: string;
@@ -119,6 +127,7 @@ interface OnboardingAssistantHandoff {
     pendingSteps?: string[];
     assistantPrompt?: string;
     patches?: OnboardingPatchPlan[];
+    dailyUsage?: OnboardingDailyUsageHandoff;
 }
 interface ResolvedOnboardingSession {
     status: OnboardStatus;
@@ -141,6 +150,7 @@ interface ResolvedOnboardingSession {
     pendingSteps?: string[];
     assistantPrompt?: string;
     patches?: OnboardingPatchPlan[];
+    dailyUsage?: OnboardingDailyUsageHandoff;
     handoff?: OnboardingAssistantHandoff;
 }
 interface OnboardCommandResult {
@@ -159,6 +169,7 @@ interface OnboardCommandResult {
     pendingSteps?: string[];
     assistantPrompt?: string;
     patches?: OnboardingPatchPlan[];
+    dailyUsage?: OnboardingDailyUsageHandoff;
     handoff?: OnboardingAssistantHandoff;
 }
 /** Machine-readable detection output for skill-first onboarding */
@@ -383,6 +394,44 @@ interface IntegrationDoctorResult {
 }
 declare function integrationDoctor(assistant: string, options?: IntegrationDoctorOptions): Promise<IntegrationDoctorResult>;
 
+interface McpCommandOptions {
+    serverUrl?: string;
+    version?: string;
+}
+interface InspectoMcpRuntime {
+    getSession(args: {
+        sessionId: string;
+    }): Promise<Record<string, unknown>>;
+    claimNext(args?: {
+        timeoutMs?: number;
+    }): Promise<{
+        success: boolean;
+        timedOut: boolean;
+        matchedExisting: boolean;
+        session?: Record<string, unknown>;
+        event?: string;
+    }>;
+    reply(args: {
+        sessionId: string;
+        text: string;
+    }): Promise<Record<string, unknown>>;
+    resolve(args: {
+        sessionId: string;
+        message?: string;
+    }): Promise<Record<string, unknown>>;
+    dismiss(args: {
+        sessionId: string;
+        message?: string;
+    }): Promise<Record<string, unknown>>;
+}
+declare function startMcpServer(options?: McpCommandOptions): Promise<void>;
+declare function createInspectoMcpServer(options: {
+    baseUrl: string;
+    version?: string;
+}): McpServer;
+declare function createInspectoMcpRuntime(baseUrl: string): InspectoMcpRuntime;
+declare function resolveInspectoServerBaseUrl(cwd: string): string | null;
+
 interface OnboardCommandOptions {
     json?: boolean;
     target?: string;
@@ -405,6 +454,6 @@ interface ReportCommandErrorOptions {
 declare function writeCommandOutput<T>(result: T, json: boolean, renderText: (value: T) => void): T;
 declare function reportCommandError(error: unknown, options?: ReportCommandErrorOptions): void;
 
-type Framework = 'react' | 'vue';
+type Framework = 'react' | 'vue' | 'svelte' | 'solid' | 'astro';
 
-export { type BuildTool, type DoctorDiagnostic, type DoctorResult, type Framework, type InitOptions, type InstallLock, type OnboardCommandResult, type OnboardStatus, type PackageManager, type ResolvedOnboardingSession, apply, collectDoctorResult, detect, devLink, devStatus, devUnlink, doctor, init, integrationDoctor, onboard, plan, reportCommandError, teardown, writeCommandOutput };
+export { type BuildTool, type DoctorDiagnostic, type DoctorResult, type Framework, type InitOptions, type InstallLock, type OnboardCommandResult, type OnboardStatus, type PackageManager, type ResolvedOnboardingSession, apply, collectDoctorResult, createInspectoMcpRuntime, createInspectoMcpServer, detect, devLink, devStatus, devUnlink, doctor, init, integrationDoctor, onboard, plan, reportCommandError, resolveInspectoServerBaseUrl, startMcpServer, teardown, writeCommandOutput };

package/dist/index.js

@@ -1,6 +1,8 @@
 import {
   apply,
   collectDoctorResult,
+  createInspectoMcpRuntime,
+  createInspectoMcpServer,
   detect,
   devLink,
   devStatus,
@@ -11,12 +13,16 @@ import {
   onboard,
   plan,
   reportCommandError,
+  resolveInspectoServerBaseUrl,
+  startMcpServer,
   teardown,
   writeCommandOutput
-} from "./chunk-LLQA5L7E.js";
+} from "./chunk-T46P6RD7.js";
 export {
   apply,
   collectDoctorResult,
+  createInspectoMcpRuntime,
+  createInspectoMcpServer,
   detect,
   devLink,
   devStatus,
@@ -27,6 +33,8 @@ export {
   onboard,
   plan,
   reportCommandError,
+  resolveInspectoServerBaseUrl,
+  startMcpServer,
   teardown,
   writeCommandOutput
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inspecto-dev/cli",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "description": "CLI tools for Inspecto onboarding and lifecycle management",
   "keywords": [
     "inspecto",
@@ -15,12 +15,14 @@
     "inspecto": "./bin/inspecto.js"
   },
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "cac": "^6.7.14",
     "magicast": "^0.5.2",
-    "ora": "^9.3.0",
+    "ora": "^9.4.0",
     "picocolors": "^1.0.0",
     "prompts": "^2.4.2",
-    "@inspecto-dev/types": "0.3.7"
+    "zod": "^4.1.12",
+    "@inspecto-dev/types": "0.3.9"
   },
   "devDependencies": {
     "@types/node": "^20.19.39",

package/src/bin.ts

@@ -11,6 +11,7 @@ import { detect } from './commands/detect.js'
 import { devLink, devStatus, devUnlink } from './commands/dev-config.js'
 import { init } from './commands/init.js'
 import { doctor } from './commands/doctor.js'
+import { startMcpServer } from './commands/mcp.js'
 import { onboard } from './commands/onboard.js'
 import { plan } from './commands/plan.js'
 import { teardown } from './commands/teardown.js'
@@ -75,6 +76,10 @@ interface DevCommandOptions extends JsonCommandOptions {
   repo?: string
 }
 
+interface McpCommandOptions extends GlobalOptions {
+  serverUrl?: string
+}
+
 const integrationScopes = ['project', 'user'] as const
 const integrationModes = ['skills', 'instructions', 'agents', 'rules'] as const
 
@@ -128,6 +133,21 @@ export function createCli(_argv: readonly string[] = process.argv): CAC {
       }
     })
 
+  cli
+    .command('mcp', 'Run Inspecto as a minimal stdio MCP server for agents')
+    .option('--server-url <url>', 'Use an explicit Inspecto dev server base URL')
+    .option('--debug', 'Enable debug mode to show full error traces', { default: false })
+    .action(async (options: McpCommandOptions) => {
+      try {
+        await startMcpServer({
+          ...(options.serverUrl ? { serverUrl: options.serverUrl } : {}),
+          version,
+        })
+      } catch (error) {
+        exitWithError(error, options)
+      }
+    })
+
   cli
     .command('init', 'Set up Inspecto in your project')
     .option('--shared', 'Share .inspecto/settings.json with your team via Git', { default: false })

package/src/commands/init.ts

@@ -202,11 +202,15 @@ export async function init(options: InitOptions): Promise<void> {
   }
 
   // IDE detection
-  let selectedIDE: { ide: string; supported: boolean } | null = null
+  let selectedIDE: { ide: string; supported: boolean } | null
 
   if (ideProbe.detected.length === 0) {
-    log.error('No IDE detected in current project')
-    log.hint('Please open this project in a supported IDE (like VS Code)')
+    if (process.stdin.isTTY) {
+      log.warn('No IDE detected in current project')
+      selectedIDE = await promptIDEChoice([])
+    } else {
+      selectedIDE = { ide: 'none', supported: true }
+    }
   } else if (ideProbe.detected.length === 1) {
     selectedIDE = ideProbe.detected[0]!
   } else {

package/src/commands/integration-automation.ts

@@ -156,7 +156,9 @@ export async function runIntegrationAutomation(
     previewParams.set('overrides', JSON.stringify({ type: dispatchMode.mode }))
   }
 
-  const uriScheme = resolvedHostIde.ide ? (IDE_TO_URI_SCHEME[resolvedHostIde.ide] ?? resolvedHostIde.ide) : 'vscode'
+  const uriScheme = resolvedHostIde.ide
+    ? (IDE_TO_URI_SCHEME[resolvedHostIde.ide] ?? resolvedHostIde.ide)
+    : 'vscode'
   const launchUri = `${uriScheme}://inspecto.inspecto/send?${previewParams.toString()}`
   details.inspectoExtension = {
     source: options.inspectoVsix ? 'local_vsix' : 'marketplace',
@@ -425,7 +427,7 @@ export async function runIntegrationAutomation(
   }
 }
 
-function shouldAutoSend(assistant: string, ide: SupportedHostIde): boolean {
+function shouldAutoSend(assistant: string, _ide: SupportedHostIde): boolean {
   if (assistant === 'copilot') return true
   if (assistant === 'codex') return true
   return false

package/src/commands/integration-host-ide.ts

@@ -1,7 +1,6 @@
 import path from 'node:path'
 import { exists, readJSON } from '../utils/fs.js'
 import {
-  HOST_IDE_IDS,
   getHostIdeArtifactPath,
   isSupportedHostIde,
   type SupportedHostIde,
@@ -138,7 +137,8 @@ function detectEnvHostIdes(): SupportedHostIde[] {
   if (
     process.env.__CFBundleIdentifier === 'ai.codebuddy.mac.cn' ||
     process.env.COCO_IDE_PLUGIN_TYPE === 'CodeBuddyCN' ||
-    (process.env.npm_config_user_agent && process.env.npm_config_user_agent.includes('codebuddy-cn'))
+    (process.env.npm_config_user_agent &&
+      process.env.npm_config_user_agent.includes('codebuddy-cn'))
   ) {
     detected.add('codebuddy-cn')
   } else if (
@@ -157,7 +157,14 @@ function detectEnvHostIdes(): SupportedHostIde[] {
 }
 
 async function detectArtifactHostIdes(cwd: string): Promise<SupportedHostIde[]> {
-  const artifactOrder: SupportedHostIde[] = ['cursor', 'trae', 'trae-cn', 'codebuddy', 'codebuddy-cn', 'vscode']
+  const artifactOrder: SupportedHostIde[] = [
+    'cursor',
+    'trae',
+    'trae-cn',
+    'codebuddy',
+    'codebuddy-cn',
+    'vscode',
+  ]
   const candidates = artifactOrder.map(ide => ({
     ide,
     target: getHostIdeArtifactPath(ide, cwd),

package/src/commands/integration-install.ts

@@ -19,7 +19,15 @@ import {
 const REPO_RAW_BASE = 'https://raw.githubusercontent.com/inspecto-dev/inspecto/main'
 const TOTAL_STEPS = 6
 
-type AssistantId = 'codex' | 'claude-code' | 'copilot' | 'cursor' | 'gemini' | 'trae' | 'coco' | 'codebuddy'
+type AssistantId =
+  | 'codex'
+  | 'claude-code'
+  | 'copilot'
+  | 'cursor'
+  | 'gemini'
+  | 'trae'
+  | 'coco'
+  | 'codebuddy'
 type ClaudeScope = 'project' | 'user'
 type CopilotMode = 'skills' | 'instructions' | 'agents'
 type CursorMode = 'skills' | 'rules' | 'agents'
@@ -67,6 +75,7 @@ interface InstallPlan {
 interface InspectoSettingsShape {
   ide?: string
   'provider.default'?: string
+  'annotate.deliveryMode'?: 'ide' | 'agent' | 'both'
   [key: string]: unknown
 }
 
@@ -368,21 +377,31 @@ async function persistProjectOnboardingDefaults(
     resolvedHostIde.ide && resolvedHostIde.confidence !== 'low'
       ? await resolveProviderDefaultForAssistant(assistant, resolvedHostIde.ide)
       : undefined
+  const annotateDeliveryMode = resolveAnnotateDefaultDeliveryForAssistant(assistant)
   const mergedSettings =
     existingSettings && typeof existingSettings === 'object'
       ? {
           ...existingSettings,
           ide: options.ide,
           ...(providerDefault ? { 'provider.default': providerDefault } : {}),
+          'annotate.deliveryMode': annotateDeliveryMode,
         }
       : {
           ide: options.ide,
           ...(providerDefault ? { 'provider.default': providerDefault } : {}),
+          'annotate.deliveryMode': annotateDeliveryMode,
         }
 
   await writeJSON(settingsPath, mergedSettings)
 }
 
+function resolveAnnotateDefaultDeliveryForAssistant(
+  assistant: AssistantId,
+): 'ide' | 'agent' | 'both' {
+  void assistant
+  return 'both'
+}
+
 function shouldSkipAutomationForInstall(options: InstallIntegrationOptions): boolean {
   return options.scope === 'user' && !options.preview
 }
@@ -509,8 +528,10 @@ function resolveInstallPlan(assistant: string, options: InstallIntegrationOption
             executable: true,
           },
         ],
-        successMessage: 'Installed CodeBuddy skill to .codebuddy/skills/inspecto-onboarding/SKILL.md',
-        nextStep: 'Open a new CodeBuddy chat and verify the inspecto-onboarding skill is available.',
+        successMessage:
+          'Installed CodeBuddy skill to .codebuddy/skills/inspecto-onboarding/SKILL.md',
+        nextStep:
+          'Open a new CodeBuddy chat and verify the inspecto-onboarding skill is available.',
       }
     default:
       throw new Error(`Unknown assistant: ${assistant}`)
@@ -566,6 +587,10 @@ function resolveCodexPlan(options: InstallIntegrationOptions): InstallPlan {
     scope === 'user'
       ? path.join(homedir(), '.agents/skills/inspecto-onboarding-codex')
       : '.agents/skills/inspecto-onboarding-codex'
+  const agentDir =
+    scope === 'user'
+      ? path.join(homedir(), '.agents/skills/inspecto-agent-codex')
+      : '.agents/skills/inspecto-agent-codex'
 
   return {
     assets: [
@@ -585,9 +610,19 @@ function resolveCodexPlan(options: InstallIntegrationOptions): InstallPlan {
         executable: true,
         localSource: 'skills/inspecto-onboarding-codex/scripts/run-inspecto.sh',
       },
+      {
+        source: `${REPO_RAW_BASE}/skills/inspecto-agent-codex/SKILL.md`,
+        target: path.join(agentDir, 'SKILL.md'),
+        localSource: 'skills/inspecto-agent-codex/SKILL.md',
+      },
+      {
+        source: `${REPO_RAW_BASE}/skills/inspecto-agent-codex/agents/openai.yaml`,
+        target: path.join(agentDir, 'agents/openai.yaml'),
+        localSource: 'skills/inspecto-agent-codex/agents/openai.yaml',
+      },
     ],
-    successMessage: `Installed Codex skill to ${baseDir}`,
-    nextStep: 'Restart Codex or start a new Codex session to load the skill.',
+    successMessage: `Installed Codex skills to ${baseDir} and ${agentDir}`,
+    nextStep: 'Restart Codex or start a new Codex session to load the new skills.',
   }
 }