vibe-splain 3.4.2 → 4.0.0

package/dist/mcp/tools/apply_patch.js

@@ -1,103 +0,0 @@
-import { writeFile, rename, mkdir } from 'fs/promises';
-import { join, dirname } from 'path';
-import { SessionScope, ScopeViolation } from '../SessionScope.js';
-import { hashFile, BlobStore } from '../../store/BlobStore.js';
-import { PointerStore } from '../../store/PointerStore.js';
-import { applyBudgetGuard } from '../BudgetGuard.js';
-import { v4 as uuidv4 } from 'uuid';
-export class StalePatchError extends Error {
-    filePath;
-    expectedHash;
-    actualHash;
-    constructor(filePath, expectedHash, actualHash) {
-        super(`StalePatchError: ${filePath} hash mismatch — expected ${expectedHash}, got ${actualHash}. ` +
-            'File was modified since the expectedPrePatchHash was computed. Re-read the file and regenerate the patch.');
-        this.filePath = filePath;
-        this.expectedHash = expectedHash;
-        this.actualHash = actualHash;
-        this.name = 'StalePatchError';
-    }
-}
-export const applyPatchTool = {
-    name: 'apply_patch',
-    description: 'Applies a text patch to a file within the active workOrder scope. Requires expectedPrePatchHash to prevent stale-patch corruption. Records pre- and post-patch hashes.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            projectRoot: { type: 'string', description: 'Absolute project root' },
-            filePath: { type: 'string', description: 'Path relative to projectRoot' },
-            newContent: { type: 'string', description: 'Full new content of the file after the patch' },
-            expectedPrePatchHash: {
-                type: 'string',
-                description: 'sha256:<hex> hash of the file BEFORE patching. Obtain via hashFile or the sourceHash from get_file_skeleton.',
-            },
-            scanId: { type: 'string', description: 'Current scan ID for pointer registration' },
-        },
-        required: ['projectRoot', 'filePath', 'newContent', 'expectedPrePatchHash', 'scanId'],
-    },
-};
-export async function handleApplyPatch(args) {
-    const projectRoot = args.projectRoot;
-    const filePath = args.filePath;
-    const newContent = args.newContent;
-    const expectedPrePatchHash = args.expectedPrePatchHash;
-    const scanId = args.scanId;
-    if (!projectRoot || !filePath || !newContent || !expectedPrePatchHash || !scanId) {
-        throw new Error('projectRoot, filePath, newContent, expectedPrePatchHash, and scanId are all required');
-    }
-    // 1. Scope enforcement
-    try {
-        SessionScope.enforce(filePath);
-    }
-    catch (e) {
-        if (e instanceof ScopeViolation)
-            throw e;
-        throw e;
-    }
-    const absolutePath = filePath.startsWith('/') ? filePath : join(projectRoot, filePath);
-    // 2. Preimage hash check
-    let actualPreHash;
-    try {
-        actualPreHash = await hashFile(absolutePath);
-    }
-    catch {
-        // File doesn't exist yet — for new files, expectedPrePatchHash must be 'sha256:new'
-        actualPreHash = 'sha256:new';
-    }
-    if (actualPreHash !== expectedPrePatchHash) {
-        throw new StalePatchError(filePath, expectedPrePatchHash, actualPreHash);
-    }
-    // 3. Atomic write
-    const dir = dirname(absolutePath);
-    await mkdir(dir, { recursive: true });
-    const tmpPath = absolutePath + `.tmp_${Date.now()}`;
-    await writeFile(tmpPath, newContent, 'utf8');
-    await rename(tmpPath, absolutePath);
-    // 4. Compute post-patch hash
-    const postPatchHash = await hashFile(absolutePath);
-    // 5. Record both hashes in blob store
-    const blobStore = new BlobStore(projectRoot);
-    const pointerStore = PointerStore.open(projectRoot);
-    const { blobPath } = await blobStore.writeAtomic(newContent);
-    const pointerId = `ptr_patch_${uuidv4().replace(/-/g, '').slice(0, 12)}`;
-    await pointerStore.insertPointer({
-        pointerId,
-        scanId,
-        artifactName: 'patch_record',
-        contentHash: postPatchHash,
-        blobPath,
-        schemaVersion: '1.0.0',
-        createdAt: Date.now(),
-        expiresAt: null,
-    });
-    const result = {
-        ok: true,
-        filePath,
-        prePatchHash: actualPreHash,
-        postPatchHash,
-        pointerId,
-        message: `Patch applied to ${filePath}`,
-    };
-    return await applyBudgetGuard(projectRoot, scanId, 'patch_record', result);
-}
-//# sourceMappingURL=apply_patch.js.map

package/dist/mcp/tools/explainSpecialistScope.d.ts

@@ -1,15 +0,0 @@
-export declare const explainSpecialistScopeTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            specialist_id: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleExplainSpecialistScope(args: Record<string, unknown>, options?: any): Promise<unknown>;

package/dist/mcp/tools/explainSpecialistScope.js

@@ -1,30 +0,0 @@
-import { getSpecialistProfile, isSpecialistId } from '@vibe-splain/brain';
-export const explainSpecialistScopeTool = {
-    name: 'vibe_explain_specialist_scope',
-    description: 'Explains the jurisdiction scope card and profile definitions for a given specialist ID.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            specialist_id: {
-                type: 'string',
-                description: 'Specialist ID to explain (control_flow | data_transform | integration_contracts | generic_repo)',
-            }
-        },
-        required: ['specialist_id'],
-    },
-};
-export async function handleExplainSpecialistScope(args, options = {}) {
-    const specialistId = args.specialist_id;
-    if (!specialistId)
-        throw new Error('specialist_id is required');
-    if (!isSpecialistId(specialistId)) {
-        throw new Error(`Invalid specialist ID: "${specialistId}". Must be one of: control_flow, data_transform, integration_contracts, generic_repo.`);
-    }
-    console.error(`[vibe-splain] Fetching scope profile for specialist: "${specialistId}"`);
-    const profile = getSpecialistProfile(specialistId);
-    return {
-        ok: true,
-        profile
-    };
-}
-//# sourceMappingURL=explainSpecialistScope.js.map

package/dist/mcp/tools/get_call_chain.d.ts

@@ -1,42 +0,0 @@
-export declare const getCallChainTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            projectRoot: {
-                type: string;
-            };
-            entrypointPath: {
-                type: string;
-                description: string;
-            };
-            maxDepth: {
-                type: string;
-                description: string;
-            };
-            targetActionKind: {
-                type: string;
-                description: string;
-            };
-            targetModel: {
-                type: string;
-                description: string;
-            };
-            targetOperation: {
-                type: string;
-                description: string;
-            };
-            targetFunctionName: {
-                type: string;
-                description: string;
-            };
-            includeTests: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGetCallChain(args: Record<string, unknown>): Promise<unknown>;

package/dist/mcp/tools/get_call_chain.js

@@ -1,50 +0,0 @@
-import { traverseCallChain } from '@vibe-splain/brain';
-export const getCallChainTool = {
-    name: 'get_call_chain',
-    description: `Trace how behavior is reached from an entrypoint by following function call edges through the codebase. Returns a step-by-step chain with exact function names, file paths, line numbers, action kinds, and evidence text. Every edge has a confidence level; unresolved edges are listed explicitly.
-
-Use structured filters when you know the target:
-  targetModel + targetOperation: "where does Booking get created?"
-  targetActionKind: "where is auth enforced?"  
-  targetFunctionName: "how is function X reached?"
-No filter returns the full call tree up to maxDepth.
-
-Run scan_project first — this tool reads from the generated action_bindings.json.`,
-    inputSchema: {
-        type: 'object',
-        properties: {
-            projectRoot: { type: 'string' },
-            entrypointPath: { type: 'string', description: 'Relative path to the entrypoint file' },
-            maxDepth: { type: 'number', description: 'Max traversal depth. Default 6, max 12.' },
-            targetActionKind: { type: 'string', description: 'Stop at this semantic action kind.' },
-            targetModel: { type: 'string', description: 'Stop at functions touching this model.' },
-            targetOperation: { type: 'string', description: 'Narrow targetModel to this operation.' },
-            targetFunctionName: { type: 'string', description: 'Stop at a specific function name.' },
-            includeTests: { type: 'boolean', description: 'Include test files in traversal. Default false.' },
-        },
-        required: ['projectRoot', 'entrypointPath'],
-    },
-};
-export async function handleGetCallChain(args) {
-    const projectRoot = args.projectRoot;
-    const entrypointPath = args.entrypointPath;
-    if (!projectRoot || !entrypointPath)
-        throw new Error('projectRoot and entrypointPath are required');
-    const getCallChainArgs = {
-        entrypointPath,
-        maxDepth: typeof args.maxDepth === 'number' ? args.maxDepth : undefined,
-        targetActionKind: typeof args.targetActionKind === 'string' ? args.targetActionKind : undefined,
-        targetModel: typeof args.targetModel === 'string' ? args.targetModel : undefined,
-        targetOperation: typeof args.targetOperation === 'string' ? args.targetOperation : undefined,
-        targetFunctionName: typeof args.targetFunctionName === 'string' ? args.targetFunctionName : undefined,
-        includeTests: typeof args.includeTests === 'boolean' ? args.includeTests : undefined,
-    };
-    try {
-        const result = await traverseCallChain(projectRoot, getCallChainArgs);
-        return result;
-    }
-    catch (error) {
-        throw new Error(`get_call_chain failed: ${error instanceof Error ? error.message : String(error)}`);
-    }
-}
-//# sourceMappingURL=get_call_chain.js.map

package/dist/mcp/tools/get_file_skeleton.d.ts

@@ -1,23 +0,0 @@
-export declare const getFileSkeletonTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            projectRoot: {
-                type: string;
-                description: string;
-            };
-            filePath: {
-                type: string;
-                description: string;
-            };
-            scanId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGetFileSkeleton(args: Record<string, unknown>): Promise<unknown>;

package/dist/mcp/tools/get_file_skeleton.js

@@ -1,124 +0,0 @@
-import { readFile } from 'fs/promises';
-import { join } from 'path';
-import { SessionScope, ScopeViolation } from '../SessionScope.js';
-import { BlobStore, hashFile } from '../../store/BlobStore.js';
-import { PointerStore } from '../../store/PointerStore.js';
-import { applyBudgetGuard } from '../BudgetGuard.js';
-import { v4 as uuidv4 } from 'uuid';
-export const getFileSkeletonTool = {
-    name: 'get_file_skeleton',
-    description: 'Returns a content-addressed skeleton view of a source file (function signatures, class names, exported symbols). Enforces active workOrder scope. Results are content-addressed — repeated calls on unchanged files return cached pointers.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            projectRoot: { type: 'string', description: 'Absolute project root' },
-            filePath: { type: 'string', description: 'Path relative to projectRoot' },
-            scanId: { type: 'string', description: 'Current scan ID for pointer registration' },
-        },
-        required: ['projectRoot', 'filePath', 'scanId'],
-    },
-};
-export async function handleGetFileSkeleton(args) {
-    const projectRoot = args.projectRoot;
-    const filePath = args.filePath;
-    const scanId = args.scanId;
-    if (!projectRoot || !filePath || !scanId) {
-        throw new Error('projectRoot, filePath, and scanId are required');
-    }
-    // 1. Scope enforcement
-    try {
-        SessionScope.enforce(filePath);
-    }
-    catch (e) {
-        if (e instanceof ScopeViolation)
-            throw e;
-        throw e;
-    }
-    const absolutePath = filePath.startsWith('/') ? filePath : join(projectRoot, filePath);
-    // 2. Compute preimage hash of source file
-    let currentHash;
-    try {
-        currentHash = await hashFile(absolutePath);
-    }
-    catch {
-        throw new Error(`FileNotFound: cannot read ${filePath}`);
-    }
-    // 3. Check cache: same hash + parser version = return existing pointer
-    const parserVersion = '1.0.0';
-    const cacheKey = `skeleton:${currentHash}:${parserVersion}`;
-    const pointerStore = PointerStore.open(projectRoot);
-    // Look up by contentHash in existing pointers for this scan
-    const existingPointers = pointerStore.listPointersByScan(scanId);
-    const cached = existingPointers.find(p => p.artifactName === 'file_skeleton' && p.contentHash === cacheKey);
-    if (cached) {
-        return {
-            pointerId: cached.pointerId,
-            contentHash: currentHash,
-            cached: true,
-            filePath,
-        };
-    }
-    // 4. Build skeleton
-    const source = await readFile(absolutePath, 'utf8');
-    const skeleton = extractSkeleton(source, filePath);
-    // 5. Record content hash
-    const skeletonPayload = {
-        filePath,
-        sourceHash: currentHash,
-        parserVersion,
-        skeleton,
-    };
-    // 6. Budget enforcement
-    const blobStore = new BlobStore(projectRoot);
-    const serialized = JSON.stringify(skeletonPayload, null, 2);
-    const { contentHash: skeletonHash, blobPath } = await blobStore.writeAtomic(serialized);
-    const pointerId = `ptr_skel_${uuidv4().replace(/-/g, '').slice(0, 12)}`;
-    await pointerStore.insertPointer({
-        pointerId,
-        scanId,
-        artifactName: 'file_skeleton',
-        contentHash: cacheKey, // cache key encodes source hash + parser version
-        blobPath,
-        schemaVersion: '1.0.0',
-        createdAt: Date.now(),
-        expiresAt: null,
-    });
-    const result = {
-        filePath,
-        sourceHash: currentHash,
-        pointerId,
-        skeleton,
-    };
-    return await applyBudgetGuard(projectRoot, scanId, 'file_skeleton', result);
-}
-function extractSkeleton(source, filePath) {
-    const lines = source.split('\n');
-    const skeleton = [];
-    const ext = filePath.split('.').pop() ?? '';
-    const isTS = ['ts', 'tsx'].includes(ext);
-    const isJS = ['js', 'jsx', 'mjs', 'cjs'].includes(ext);
-    if (isTS || isJS) {
-        for (let i = 0; i < lines.length; i++) {
-            const line = lines[i].trim();
-            // Exported declarations, function/class/interface/type/enum signatures
-            if (/^(export\s+)?(async\s+)?function\b/.test(line) ||
-                /^(export\s+)?(abstract\s+)?class\b/.test(line) ||
-                /^(export\s+)?interface\b/.test(line) ||
-                /^(export\s+)?type\s+\w+/.test(line) ||
-                /^(export\s+)?enum\b/.test(line) ||
-                /^(export\s+)?const\s+\w+\s*[:=(]/.test(line) ||
-                /^(export\s+)?let\s+\w+\s*[:=(]/.test(line) ||
-                /^(export\s+)?(default\s+)/.test(line) ||
-                /^\s*(public|private|protected|static|readonly|abstract)\s+/.test(line) ||
-                /^import\b/.test(line)) {
-                skeleton.push(`L${i + 1}: ${lines[i]}`);
-            }
-        }
-    }
-    else {
-        // Generic: return first 80 lines as skeleton for unsupported types
-        return lines.slice(0, 80).map((l, i) => `L${i + 1}: ${l}`);
-    }
-    return skeleton;
-}
-//# sourceMappingURL=get_file_skeleton.js.map

package/dist/mcp/tools/hydration/get_evidence_slice.d.ts

@@ -1,31 +0,0 @@
-export declare const getEvidenceSliceTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            projectRoot: {
-                type: string;
-                description: string;
-            };
-            pointerId: {
-                type: string;
-                description: string;
-            };
-            startLine: {
-                type: string;
-                description: string;
-            };
-            endLine: {
-                type: string;
-                description: string;
-            };
-            scanId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGetEvidenceSlice(args: Record<string, unknown>): Promise<unknown>;

package/dist/mcp/tools/hydration/get_evidence_slice.js

@@ -1,57 +0,0 @@
-import { hydratePointer, applyBudgetGuard } from '../../BudgetGuard.js';
-import { SessionScope } from '../../SessionScope.js';
-export const getEvidenceSliceTool = {
-    name: 'get_evidence_slice',
-    description: 'Raw fallback: returns a line-range slice from a blob artifact. Pointer must be valid and unexpired. Output is budgeted.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            projectRoot: { type: 'string', description: 'Absolute project root' },
-            pointerId: { type: 'string', description: 'Pointer ID for the target artifact' },
-            startLine: { type: 'number', description: 'Inclusive start line (1-based)' },
-            endLine: { type: 'number', description: 'Inclusive end line (1-based). Capped at startLine+200.' },
-            scanId: { type: 'string', description: 'Current scan ID for budget pointer registration' },
-        },
-        required: ['projectRoot', 'pointerId', 'startLine', 'endLine', 'scanId'],
-    },
-};
-export async function handleGetEvidenceSlice(args) {
-    const projectRoot = args.projectRoot;
-    const pointerId = args.pointerId;
-    const startLine = Number(args.startLine);
-    const endLine = Math.min(Number(args.endLine), startLine + 200);
-    const scanId = args.scanId;
-    if (!projectRoot || !pointerId || !scanId) {
-        throw new Error('projectRoot, pointerId, startLine, endLine, and scanId are required');
-    }
-    // 1. Verify pointer, lifetime, hash
-    const { content, row } = await hydratePointer(projectRoot, pointerId);
-    const rawText = content.toString('utf8');
-    // Scope enforcement: if a Worker scope is active, enforce it for file-type artifacts
-    const scope = SessionScope.get();
-    if (scope && (row.artifactName === 'file_read' || row.artifactName === 'file_skeleton')) {
-        try {
-            const parsed = JSON.parse(rawText);
-            if (parsed.filePath) {
-                SessionScope.enforce(parsed.filePath);
-            }
-        }
-        catch (e) {
-            if (e.name === 'ScopeViolation')
-                throw e;
-        }
-    }
-    const lines = rawText.split('\n');
-    const sliced = lines.slice(startLine - 1, endLine);
-    const result = {
-        pointerId,
-        artifactName: row.artifactName,
-        startLine,
-        endLine,
-        totalLines: lines.length,
-        slice: sliced,
-    };
-    // 2. Budget query result
-    return await applyBudgetGuard(projectRoot, scanId, 'evidence_slice', result);
-}
-//# sourceMappingURL=get_evidence_slice.js.map

package/dist/mcp/tools/hydration/get_project_summary.d.ts

@@ -1,23 +0,0 @@
-export declare const getProjectSummaryTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            projectRoot: {
-                type: string;
-                description: string;
-            };
-            manifestPointer: {
-                type: string;
-                description: string;
-            };
-            scanId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGetProjectSummary(args: Record<string, unknown>): Promise<unknown>;

package/dist/mcp/tools/hydration/get_project_summary.js

@@ -1,58 +0,0 @@
-import { hydratePointer, applyBudgetGuard } from '../../BudgetGuard.js';
-export const getProjectSummaryTool = {
-    name: 'get_project_summary',
-    description: 'Returns high-level project metrics from a scan manifest pointer: file counts, pillar summary, stack. Token-safe. Pointer must be valid and unexpired.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            projectRoot: { type: 'string', description: 'Absolute project root' },
-            manifestPointer: { type: 'string', description: 'Pointer ID for the scan manifest' },
-            scanId: { type: 'string', description: 'Current scan ID for budget pointer registration' },
-        },
-        required: ['projectRoot', 'manifestPointer', 'scanId'],
-    },
-};
-export async function handleGetProjectSummary(args) {
-    const projectRoot = args.projectRoot;
-    const manifestPointer = args.manifestPointer;
-    const scanId = args.scanId;
-    if (!projectRoot || !manifestPointer || !scanId) {
-        throw new Error('projectRoot, manifestPointer, and scanId are required');
-    }
-    const { content, row } = await hydratePointer(projectRoot, manifestPointer);
-    const payload = JSON.parse(content.toString('utf8'));
-    if (row.artifactName === 'artifact_manifest') {
-        const manifest = payload;
-        const analysisEntry = manifest.artifacts.find(a => a.name === 'analysis' && a.indexes?.startHere);
-        let indexData = {};
-        if (analysisEntry?.indexes?.startHere) {
-            const { content: ic } = await hydratePointer(projectRoot, analysisEntry.indexes.startHere);
-            indexData = JSON.parse(ic.toString('utf8'));
-        }
-        const result = {
-            scanId: manifest.scanId,
-            generatedAt: manifest.generatedAt,
-            artifactCount: manifest.artifacts.length,
-            totalArtifactBytes: manifest.artifacts.reduce((s, a) => s + (a.sizeBytes ?? 0), 0),
-            startHere: indexData.startHere,
-            topHeat: indexData.topHeat,
-            pillarSummary: indexData.pillarSummary,
-            totalFiles: indexData.totalFiles,
-            realSourceFiles: indexData.realSourceFiles,
-        };
-        return await applyBudgetGuard(projectRoot, scanId, 'get_project_summary_result', result);
-    }
-    if (row.artifactName === 'analysis.index') {
-        const result = {
-            scanId: payload.scanId,
-            startHere: payload.startHere,
-            topHeat: payload.topHeat,
-            pillarSummary: payload.pillarSummary,
-            totalFiles: payload.totalFiles,
-            realSourceFiles: payload.realSourceFiles,
-        };
-        return await applyBudgetGuard(projectRoot, scanId, 'get_project_summary_result', result);
-    }
-    throw new Error(`Unsupported artifact type for get_project_summary: ${row.artifactName}`);
-}
-//# sourceMappingURL=get_project_summary.js.map

package/dist/mcp/tools/hydration/get_start_here.d.ts

@@ -1,23 +0,0 @@
-export declare const getStartHereTool: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            projectRoot: {
-                type: string;
-                description: string;
-            };
-            manifestPointer: {
-                type: string;
-                description: string;
-            };
-            scanId: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handleGetStartHere(args: Record<string, unknown>): Promise<unknown>;

package/dist/mcp/tools/hydration/get_start_here.js

@@ -1,52 +0,0 @@
-import { hydratePointer, applyBudgetGuard } from '../../BudgetGuard.js';
-export const getStartHereTool = {
-    name: 'get_start_here',
-    description: 'Hydrates the start-here index for a scan manifest pointer. Returns the top 5 highest-gravity files. Pointer must be valid and unexpired.',
-    inputSchema: {
-        type: 'object',
-        properties: {
-            projectRoot: { type: 'string', description: 'Absolute project root' },
-            manifestPointer: { type: 'string', description: 'Pointer ID for the scan manifest or analysis.index artifact' },
-            scanId: { type: 'string', description: 'Current scan ID for budget pointer registration' },
-        },
-        required: ['projectRoot', 'manifestPointer', 'scanId'],
-    },
-};
-export async function handleGetStartHere(args) {
-    const projectRoot = args.projectRoot;
-    const manifestPointer = args.manifestPointer;
-    const scanId = args.scanId;
-    if (!projectRoot || !manifestPointer || !scanId) {
-        throw new Error('projectRoot, manifestPointer, and scanId are required');
-    }
-    // 1. Verify pointer exists, unexpired, hash matches blob
-    const { content, row } = await hydratePointer(projectRoot, manifestPointer);
-    const payload = JSON.parse(content.toString('utf8'));
-    // 2. If it's a manifest pointer, find the analysis.index pointer
-    if (row.artifactName === 'artifact_manifest') {
-        const manifest = payload;
-        const analysisEntry = manifest.artifacts.find(a => a.name === 'analysis' || a.name === 'analysis.index');
-        if (!analysisEntry?.indexes?.startHere) {
-            throw new Error('Manifest has no analysis.index entry — rescan to regenerate');
-        }
-        const { content: indexContent } = await hydratePointer(projectRoot, analysisEntry.indexes.startHere);
-        const index = JSON.parse(indexContent.toString('utf8'));
-        const result = {
-            startHere: index.startHere.slice(0, 5),
-            schemaVersion: index.schemaVersion,
-            scanId: index.scanId,
-        };
-        return await applyBudgetGuard(projectRoot, scanId, 'get_start_here_result', result);
-    }
-    // 3. If it's an analysis.index pointer directly
-    if (row.artifactName === 'analysis.index') {
-        const result = {
-            startHere: payload.startHere.slice(0, 5),
-            schemaVersion: payload.schemaVersion,
-            scanId: payload.scanId,
-        };
-        return await applyBudgetGuard(projectRoot, scanId, 'get_start_here_result', result);
-    }
-    throw new Error(`Unsupported artifact type for get_start_here: ${row.artifactName}`);
-}
-//# sourceMappingURL=get_start_here.js.map