@vibecodetown/mcp-server 1.3.1 → 1.5.0

package/build/mcp/tools/vibe_pm/ingress.d.ts

@@ -1,6 +1,6 @@
-import { IngressInputSchema, type IngressInput } from "../../generated/ingress_input.js";
-import { type IngressOutputSSOT } from "../../generated/ingress_output.js";
-export type IngressResolution = "INGRESS_RESOLVED_RESUME" | "INGRESS_RESOLVED_NEW_TASK" | "INGRESS_RESOLVED_ADOPT" | "INGRESS_ABORTED";
+import { IngressInputSchema, type IngressInput } from '../../generated/ingress_input.js';
+import { type IngressOutputSSOT } from '../../generated/ingress_output.js';
+export type IngressResolution = 'INGRESS_RESOLVED_RESUME' | 'INGRESS_RESOLVED_NEW_TASK' | 'INGRESS_RESOLVED_ADOPT' | 'INGRESS_ABORTED';
 export interface IngressArtifact {
     path: string;
     exists: boolean;
@@ -18,7 +18,7 @@ export declare function ingress(input: IngressInput): Promise<IngressOutputSSOT>
 /**
  * Get current ingress state for a run
  */
-export declare function getIngressState(runId: string, basePath: string): "ready" | "stale" | "missing" | "failed";
+export declare function getIngressState(runId: string, basePath: string): 'ready' | 'stale' | 'missing' | 'failed';
 /**
  * Check if ingress artifacts exist
  */

package/build/mcp/tools/vibe_pm/ingress.js

@@ -5,19 +5,16 @@
 // - best_effort 모드에서는 일부 실패해도 OK 반환
 // - strict 모드에서는 필수 산출물 실패 시 ERROR
 // - dirty 감지를 통해 재실행 필요성 판단
-import * as fsPromises from "node:fs/promises";
-import * as fs from "node:fs";
-import * as path from "node:path";
-import * as crypto from "node:crypto";
-import { fileURLToPath } from "node:url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-import { resolveRunId, readRunState } from "./context.js";
-import { IngressInputSchema } from "../../generated/ingress_input.js";
-import { runMappingPipelineSmart, hasSpecMap } from "./mapping/index.js";
-import { ensureDirSync, getPmRunDir, getPmRunsDir, resolvePmRunDirForRead } from "../../paths.js";
-import { prunePmRunsBestEffort } from "../../run-retention.js";
-import { runPreprocess } from "../../preprocess.js";
+import * as fsPromises from 'node:fs/promises';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { resolveRunId, readRunState } from './context.js';
+import { IngressInputSchema } from '../../generated/ingress_input.js';
+import { runMappingPipelineSmart, hasSpecMap, } from './mapping/index.js';
+import { ensureDirSync, getPmRunDir, getPmRunsDir, resolvePmRunDirForRead, getPackageVersion, } from '../../../kernel/paths.js';
+import { prunePmRunsBestEffort } from '../../run-retention.js';
+import { runPreprocess } from '../../preprocess.js';
 // ============================================================
 // Main Handler
 // ============================================================
@@ -51,8 +48,8 @@ export async function ingress(input) {
             workspaceRoot: basePath,
             runId: run_id,
             rawText,
-            filePath: "ingress.json",
-            taskType: "ingress",
+            filePath: 'ingress.json',
+            taskType: 'ingress',
         });
     }
     catch {
@@ -62,11 +59,11 @@ export async function ingress(input) {
     prunePmRunsBestEffort({ workspaceRoot: basePath, protectRunId: run_id });
     // PM run dir (do not write into engine run roots)
     const pmRunDir = getPmRunDir(basePath, run_id);
-    const ingressDir = path.join(pmRunDir, "ingress");
+    const ingressDir = path.join(pmRunDir, 'ingress');
     // Create ingress directory
     await fsPromises.mkdir(ingressDir, { recursive: true });
     // Check existing state
-    const hasVibeState = fs.existsSync(path.join(basePath, ".vibe"));
+    const hasVibeState = fs.existsSync(path.join(basePath, '.vibe'));
     const runState = is_new ? null : readRunState(run_id, basePath);
     // Determine resolution
     let resolution;
@@ -76,22 +73,22 @@ export async function ingress(input) {
     }
     else if (input.auto_resolve) {
         // Auto-resolve based on state
-        if (runState && runState.phase && runState.phase !== "completed") {
-            resolution = "INGRESS_RESOLVED_RESUME";
+        if (runState && runState.phase && runState.phase !== 'completed') {
+            resolution = 'INGRESS_RESOLVED_RESUME';
             autoResolveReason = `기존 run 상태 발견 (phase: ${runState.phase})`;
         }
         else if (is_new) {
-            resolution = "INGRESS_RESOLVED_NEW_TASK";
-            autoResolveReason = "새 프로젝트 시작";
+            resolution = 'INGRESS_RESOLVED_NEW_TASK';
+            autoResolveReason = '새 프로젝트 시작';
         }
         else {
-            resolution = "INGRESS_RESOLVED_ADOPT";
-            autoResolveReason = "기존 컨텍스트 채택";
+            resolution = 'INGRESS_RESOLVED_ADOPT';
+            autoResolveReason = '기존 컨텍스트 채택';
         }
     }
     else {
         // Default resolution
-        resolution = is_new ? "INGRESS_RESOLVED_NEW_TASK" : "INGRESS_RESOLVED_RESUME";
+        resolution = is_new ? 'INGRESS_RESOLVED_NEW_TASK' : 'INGRESS_RESOLVED_RESUME';
     }
     // Generate artifacts
     const artifacts = {};
@@ -99,9 +96,9 @@ export async function ingress(input) {
     // 1. Generate project fingerprint
     try {
         const fingerprint = await generateProjectFingerprint(basePath);
-        const fingerprintPath = path.join(ingressDir, "project_fingerprint.json");
+        const fingerprintPath = path.join(ingressDir, 'project_fingerprint.json');
         if (input.write_files) {
-            await fsPromises.writeFile(fingerprintPath, JSON.stringify(fingerprint, null, 2) + "\n", "utf-8");
+            await fsPromises.writeFile(fingerprintPath, JSON.stringify(fingerprint, null, 2) + '\n', 'utf-8');
         }
         artifacts.project_fingerprint = fingerprintPath;
     }
@@ -109,38 +106,38 @@ export async function ingress(input) {
         warnings.push(`project_fingerprint 생성 실패: ${e instanceof Error ? e.message : String(e)}`);
     }
     // 2. Generate ingress summary
-    const summaryPath = path.join(ingressDir, "ingress_summary.json");
+    const summaryPath = path.join(ingressDir, 'ingress_summary.json');
     try {
         const summary = {
-            format_version: "ingress.summary.v1",
+            format_version: 'ingress.summary.v1',
             run_id,
             project_id: input.project_id ?? run_id,
             created_at: new Date().toISOString(),
             producer: {
-                name: "@vibecodetown/mcp-server",
+                name: '@vibecodetown/mcp-server',
                 version: getPackageVersion(),
             },
             pointers: {
-                project_fingerprint: artifacts.project_fingerprint ?? "",
-                repo_map: "",
-                entrypoints: "",
-                docs_index: "",
-                risk_flags: "",
+                project_fingerprint: artifacts.project_fingerprint ?? '',
+                repo_map: '',
+                entrypoints: '',
+                docs_index: '',
+                risk_flags: '',
             },
             high_level: {
-                entrypoint_status: "AMBIGUOUS",
+                entrypoint_status: 'AMBIGUOUS',
                 clarification_recommended: true,
-                clarification_reasons: ["초기 분석 필요"],
+                clarification_reasons: ['초기 분석 필요'],
                 docs_index_count: 0,
             },
             consumption_policy: {
-                front_reads: ["ingress_summary.json"],
-                bridge_reads: ["ingress_resolution.json"],
-                back_reads: ["project_fingerprint.json"],
+                front_reads: ['ingress_summary.json'],
+                bridge_reads: ['ingress_resolution.json'],
+                back_reads: ['project_fingerprint.json'],
             },
         };
         if (input.write_files) {
-            await fsPromises.writeFile(summaryPath, JSON.stringify(summary, null, 2) + "\n", "utf-8");
+            await fsPromises.writeFile(summaryPath, JSON.stringify(summary, null, 2) + '\n', 'utf-8');
         }
         artifacts.ingress_summary = summaryPath;
     }
@@ -148,10 +145,10 @@ export async function ingress(input) {
         warnings.push(`ingress_summary 생성 실패: ${e instanceof Error ? e.message : String(e)}`);
     }
     // 3. Generate ingress resolution
-    const resolutionPath = path.join(ingressDir, "ingress_resolution.json");
+    const resolutionPath = path.join(ingressDir, 'ingress_resolution.json');
     try {
         const resolutionDoc = {
-            schema_version: "ingress.resolution.v2",
+            schema_version: 'ingress.resolution.v2',
             run_id,
             project_id: input.project_id ?? run_id,
             workspace_path: path.resolve(basePath),
@@ -162,7 +159,7 @@ export async function ingress(input) {
             created_at: new Date().toISOString(),
         };
         if (input.write_files) {
-            await fsPromises.writeFile(resolutionPath, JSON.stringify(resolutionDoc, null, 2) + "\n", "utf-8");
+            await fsPromises.writeFile(resolutionPath, JSON.stringify(resolutionDoc, null, 2) + '\n', 'utf-8');
         }
     }
     catch (e) {
@@ -177,10 +174,10 @@ export async function ingress(input) {
             contextScanCompleted = true;
             // Update resolution with scan results
             if (input.write_files) {
-                const resolutionDoc = JSON.parse(await fsPromises.readFile(resolutionPath, "utf-8"));
+                const resolutionDoc = JSON.parse(await fsPromises.readFile(resolutionPath, 'utf-8'));
                 resolutionDoc.context_scan_completed = true;
                 resolutionDoc.scan_result = scanResult;
-                await fsPromises.writeFile(resolutionPath, JSON.stringify(resolutionDoc, null, 2) + "\n", "utf-8");
+                await fsPromises.writeFile(resolutionPath, JSON.stringify(resolutionDoc, null, 2) + '\n', 'utf-8');
             }
         }
         catch (e) {
@@ -230,26 +227,26 @@ export async function ingress(input) {
             artifacts: artifacts.ingress_summary ? artifacts : undefined,
             mapping: mappingInfo,
             warnings: warnings.length > 0 ? warnings : undefined,
-            message: "필수 산출물(ingress_summary) 생성 실패",
+            message: '필수 산출물(ingress_summary) 생성 실패',
             next_action: {
-                tool: "vibe_pm.ingress",
-                reason: "ingress 재실행 필요",
+                tool: 'vibe_pm.ingress',
+                reason: 'ingress 재실행 필요',
             },
         };
     }
     // Determine next action
     let nextAction = null;
     if (success) {
-        if (resolution === "INGRESS_RESOLVED_NEW_TASK") {
+        if (resolution === 'INGRESS_RESOLVED_NEW_TASK') {
             nextAction = {
-                tool: "vibe_pm.briefing",
-                reason: "새 프로젝트 시작을 위해 briefing 필요",
+                tool: 'vibe_pm.briefing',
+                reason: '새 프로젝트 시작을 위해 briefing 필요',
             };
         }
-        else if (resolution === "INGRESS_RESOLVED_RESUME") {
+        else if (resolution === 'INGRESS_RESOLVED_RESUME') {
             nextAction = {
-                tool: "vibe_pm.get_decision",
-                reason: "기존 프로젝트 재개를 위해 결재 확인 필요",
+                tool: 'vibe_pm.get_decision',
+                reason: '기존 프로젝트 재개를 위해 결재 확인 필요',
             };
         }
     }
@@ -267,9 +264,7 @@ export async function ingress(input) {
         artifacts: Object.keys(artifacts).length > 0 ? artifacts : undefined,
         mapping: mappingInfo,
         warnings: warnings.length > 0 ? warnings : undefined,
-        message: success
-            ? `Ingress 완료 (${Date.now() - startTime}ms)`
-            : "Ingress 실패",
+        message: success ? `Ingress 완료 (${Date.now() - startTime}ms)` : 'Ingress 실패',
         next_action: nextAction,
     };
 }
@@ -285,10 +280,10 @@ async function generateProjectFingerprint(basePath) {
         workspace_path: path.resolve(basePath),
     };
     // Check for package.json
-    const packageJsonPath = path.join(basePath, "package.json");
+    const packageJsonPath = path.join(basePath, 'package.json');
     if (fs.existsSync(packageJsonPath)) {
         try {
-            const pkg = JSON.parse(await fsPromises.readFile(packageJsonPath, "utf-8"));
+            const pkg = JSON.parse(await fsPromises.readFile(packageJsonPath, 'utf-8'));
             fingerprint.package_name = pkg.name;
             fingerprint.package_version = pkg.version;
             fingerprint.has_package_json = true;
@@ -298,7 +293,7 @@ async function generateProjectFingerprint(basePath) {
         }
     }
     // Check for common project files
-    const markers = ["tsconfig.json", "pyproject.toml", "Cargo.toml", "go.mod", "pom.xml"];
+    const markers = ['tsconfig.json', 'pyproject.toml', 'Cargo.toml', 'go.mod', 'pom.xml'];
     const detectedMarkers = [];
     for (const marker of markers) {
         if (fs.existsSync(path.join(basePath, marker))) {
@@ -317,9 +312,9 @@ async function generateProjectFingerprint(basePath) {
         fingerprint.root_dir_count = 0;
     }
     // Generate hash
-    const hash = crypto.createHash("sha256");
+    const hash = crypto.createHash('sha256');
     hash.update(JSON.stringify(fingerprint));
-    fingerprint.fingerprint_hash = hash.digest("hex").slice(0, 16);
+    fingerprint.fingerprint_hash = hash.digest('hex').slice(0, 16);
     return fingerprint;
 }
 /**
@@ -330,10 +325,10 @@ async function runContextScan(basePath) {
         scanned_at: new Date().toISOString(),
     };
     // Check .vibe folder
-    const vibeDir = path.join(basePath, ".vibe");
+    const vibeDir = path.join(basePath, '.vibe');
     result.has_vibe_dir = fs.existsSync(vibeDir);
     // Check src folder
-    const srcDir = path.join(basePath, "src");
+    const srcDir = path.join(basePath, 'src');
     if (fs.existsSync(srcDir)) {
         try {
             const entries = await fsPromises.readdir(srcDir, { recursive: true });
@@ -344,7 +339,7 @@ async function runContextScan(basePath) {
         }
     }
     // Check lockfiles
-    const lockfiles = ["package-lock.json", "yarn.lock", "pnpm-lock.yaml", "bun.lockb"];
+    const lockfiles = ['package-lock.json', 'yarn.lock', 'pnpm-lock.yaml', 'bun.lockb'];
     const foundLockfiles = [];
     for (const lockfile of lockfiles) {
         if (fs.existsSync(path.join(basePath, lockfile))) {
@@ -354,26 +349,7 @@ async function runContextScan(basePath) {
     result.lockfiles = foundLockfiles;
     return result;
 }
-/**
- * Get package version from MCP server's package.json (not user's project)
- */
-function getPackageVersion() {
-    try {
-        // __dirname 기준으로 MCP 서버 루트의 package.json 찾기
-        // ingress.ts 위치: src/mcp/tools/vibe_pm/ingress.ts
-        // package.json 위치: package.json (루트)
-        // 상대 경로: ../../../../package.json
-        const pkgPath = path.resolve(__dirname, "../../../../package.json");
-        if (fs.existsSync(pkgPath)) {
-            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-            return pkg.version ?? "0.0.0";
-        }
-    }
-    catch {
-        // ignore
-    }
-    return "0.0.0";
-}
+// getPackageVersion() — imported from ../../paths.js (SSOT)
 // ============================================================
 // State Helpers
 // ============================================================
@@ -383,21 +359,21 @@ function getPackageVersion() {
 export function getIngressState(runId, basePath) {
     try {
         const runDir = resolvePmRunDirForRead(basePath, runId);
-        const summaryPath = path.join(runDir, "ingress", "ingress_summary.json");
+        const summaryPath = path.join(runDir, 'ingress', 'ingress_summary.json');
         if (!fs.existsSync(summaryPath)) {
-            return "missing";
+            return 'missing';
         }
         // Check if summary is recent (within 1 hour)
         const stats = fs.statSync(summaryPath);
         const ageMs = Date.now() - stats.mtimeMs;
         const oneHourMs = 60 * 60 * 1000;
         if (ageMs > oneHourMs) {
-            return "stale";
+            return 'stale';
         }
-        return "ready";
+        return 'ready';
     }
     catch {
-        return "missing";
+        return 'missing';
     }
 }
 /**
@@ -406,19 +382,19 @@ export function getIngressState(runId, basePath) {
 export function checkIngressArtifacts(runId, basePath) {
     try {
         const runDir = resolvePmRunDirForRead(basePath, runId);
-        const ingressDir = path.join(runDir, "ingress");
+        const ingressDir = path.join(runDir, 'ingress');
         const artifacts = {
             ingress_summary: {
-                path: path.join(ingressDir, "ingress_summary.json"),
-                exists: fs.existsSync(path.join(ingressDir, "ingress_summary.json")),
+                path: path.join(ingressDir, 'ingress_summary.json'),
+                exists: fs.existsSync(path.join(ingressDir, 'ingress_summary.json')),
             },
             ingress_resolution: {
-                path: path.join(ingressDir, "ingress_resolution.json"),
-                exists: fs.existsSync(path.join(ingressDir, "ingress_resolution.json")),
+                path: path.join(ingressDir, 'ingress_resolution.json'),
+                exists: fs.existsSync(path.join(ingressDir, 'ingress_resolution.json')),
             },
             project_fingerprint: {
-                path: path.join(ingressDir, "project_fingerprint.json"),
-                exists: fs.existsSync(path.join(ingressDir, "project_fingerprint.json")),
+                path: path.join(ingressDir, 'project_fingerprint.json'),
+                exists: fs.existsSync(path.join(ingressDir, 'project_fingerprint.json')),
             },
         };
         const exists = artifacts.ingress_summary.exists;

package/build/mcp/tools/vibe_pm/init_docs.js

@@ -8,7 +8,7 @@ export const InitDocsInputSchema = z.object({
 });
 export async function initDocs(input) {
     const workspaceRoot = input.workspace_path || findVibeConfigRoot() || process.cwd();
-    const current = checkDocsStructure(workspaceRoot);
+    const current = await checkDocsStructure(workspaceRoot);
     if (current.ok && !input.force) {
         return {
             status: "already_exists",
@@ -17,7 +17,7 @@ export async function initDocs(input) {
             message: "docs/ 구조가 이미 존재합니다.",
         };
     }
-    const result = ensureDocsStructure(workspaceRoot);
+    const result = await ensureDocsStructure(workspaceRoot);
     if (!result.created) {
         return {
             status: "already_exists",

package/build/mcp/tools/vibe_pm/inspect_code/cockpit.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cockpitd delegation for inspect_code.
+ * Delegates code review to cockpitd when VIBE_COCKPIT=1 and cockpitd is available.
+ */
+import type { InspectCodeInput, InspectCodeOutput } from '../types.js';
+import type { ProgressReporter } from '../../../progress.js';
+import type { McpLogger } from '../../../mcp-logger.js';
+/**
+ * Delegate inspect_code to cockpitd when VIBE_COCKPIT=1 and cockpitd is available.
+ * Returns InspectCodeOutput on success, null on failure (caller falls back to local flow).
+ */
+export declare function delegateToCockpitd(input: InspectCodeInput, reviewStage: string, projectId: string, runId: string, progress?: ProgressReporter, log?: McpLogger): Promise<InspectCodeOutput | null>;

package/build/mcp/tools/vibe_pm/inspect_code/cockpit.js

@@ -0,0 +1,88 @@
+/**
+ * Cockpitd delegation for inspect_code.
+ * Delegates code review to cockpitd when VIBE_COCKPIT=1 and cockpitd is available.
+ */
+import { isCockpitdAvailable, cockpitRunWithOptions, cockpitGateResult, waitForCompletion, } from '../../../cockpit-bridge/client.js';
+import { loadIntentForRun } from '../../../a2a/intent/loader.js';
+import { intentToCockpitScope, hasIntentScope } from '../../../a2a/intent/converter.js';
+/**
+ * Delegate inspect_code to cockpitd when VIBE_COCKPIT=1 and cockpitd is available.
+ * Returns InspectCodeOutput on success, null on failure (caller falls back to local flow).
+ */
+export async function delegateToCockpitd(input, reviewStage, projectId, runId, progress, log) {
+    try {
+        if (!(await isCockpitdAvailable()))
+            return null;
+        progress?.report(1, 4, 'Cockpit: gate 실행 중');
+        log?.log('info', { tool: 'vibe_pm.inspect_code', run_id: runId }, 'delegating to cockpitd');
+        const targetPaths = Array.isArray(input.target_paths) ? input.target_paths : [];
+        const basePath = process.cwd();
+        // Load intent scope for cockpitd (fail-safe)
+        let intentScope;
+        try {
+            const intent = loadIntentForRun(basePath, runId);
+            if (intent && hasIntentScope(intent)) {
+                intentScope = intentToCockpitScope(intent);
+            }
+        }
+        catch {
+            // fail-safe: intent load failure shouldn't block gate check
+        }
+        await cockpitRunWithOptions({
+            target_paths: targetPaths,
+            spec_path: input.spec_path,
+            review_stage: reviewStage,
+            max_attempts: 3,
+            intent_scope: intentScope,
+        });
+        progress?.report(2, 4, 'Cockpit: Ralph Loop 대기 중');
+        const finalStatus = await waitForCompletion(1000, 300000);
+        if (!finalStatus) {
+            log?.log('warning', { tool: 'vibe_pm.inspect_code', run_id: runId }, 'cockpitd timed out');
+            return null;
+        }
+        progress?.report(3, 4, 'Cockpit: 결과 수집 중');
+        const gateResult = await cockpitGateResult();
+        if (!gateResult.has_result)
+            return null;
+        // Map cockpitd signal to ReviewResult
+        const signalMap = { GO: 'GO', FIX: 'FIX', BLOCK: 'BLOCK' };
+        const reviewResult = signalMap[gateResult.signal ?? ''] ?? 'BLOCK';
+        // Convert violations to Issue[]
+        const issues = gateResult.violations.map((v) => ({
+            type: (v.violation_type?.toUpperCase() ?? 'VERIFY_FAIL'),
+            business_risk: v.message,
+            plain_explanation: v.message,
+            technical_detail: {
+                file_path: v.path ?? '',
+                evidence: v.evidence,
+            },
+        }));
+        const verdictMessages = {
+            GO: '검수 통과 — 문제 없음',
+            FIX: `보완 필요 — ${gateResult.violation_count}건 발견`,
+            BLOCK: `반려 — ${gateResult.violation_count}건 위반`,
+        };
+        const nextAction = reviewResult === 'GO'
+            ? { action_type: 'DONE', message: '검수 통과' }
+            : reviewResult === 'BLOCK'
+                ? { action_type: 'ASK_DECISION', tool: 'vibe_pm.get_decision', reason: '결재 단계로 복귀' }
+                : { action_type: 'CONTINUE', tool: 'vibe_pm.create_work_order', reason: '수정 후 재검수' };
+        progress?.report(4, 4, 'Cockpit: 완료');
+        return {
+            project_id: projectId,
+            review_summary: {
+                decision_context: `cockpitd 위임 검수 (attempt ${gateResult.attempt_count}/${gateResult.max_attempts})`,
+                review_result: reviewResult,
+                one_line_verdict: verdictMessages[reviewResult],
+            },
+            issues_found: issues,
+            next_action: nextAction,
+            message_template_id: reviewResult === 'GO' ? 'GO-01' : reviewResult === 'FIX' ? 'FIX-01' : 'BLOCK-01',
+        };
+    }
+    catch (e) {
+        log?.log('warning', { tool: 'vibe_pm.inspect_code', run_id: runId, error: e instanceof Error ? e.message : String(e) }, 'cockpitd delegation failed');
+        return null;
+    }
+}

package/build/mcp/tools/vibe_pm/inspect_code/core.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Core inspectCode orchestration.
+ * Main export: inspectCode()
+ */
+import type { InspectCodeInput, InspectCodeOutput } from '../types.js';
+import type { ProgressReporter } from '../../../progress.js';
+import type { McpLogger } from '../../../mcp-logger.js';
+/**
+ * vibe_pm.inspect_code - Code review and validation (MVP)
+ *
+ * Internal mapping:
+ *   → vibecoding-helper one-loop <run_id> --output selection
+ *   → issue classification
+ *   → prompt_block generation (if FIX/BLOCK)
+ */
+export declare function inspectCode(input: InspectCodeInput, progress?: ProgressReporter, log?: McpLogger): Promise<InspectCodeOutput>;