@blockspool/core 0.3.2 → 0.4.0

package/dist/scout/prompt.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Scout prompt template
+ *
+ * This prompt is sent to Claude to analyze code and generate improvement proposals.
+ */
+import type { ProposalCategory } from './types.js';
+/**
+ * Build the scout prompt for analyzing a batch of files
+ */
+export declare function buildScoutPrompt(options: {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    scope: string;
+    types?: ProposalCategory[];
+    excludeTypes?: ProposalCategory[];
+    maxProposals: number;
+    minConfidence: number;
+    recentlyCompletedTitles?: string[];
+    customPrompt?: string;
+    /** Files the scout can read but must NOT propose changes to */
+    protectedFiles?: string[];
+}): string;
+/**
+ * Build a focused prompt for a single category
+ */
+export declare function buildCategoryPrompt(category: ProposalCategory, files: Array<{
+    path: string;
+    content: string;
+}>, maxProposals?: number): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/scout/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/scout/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B,GAAG,MAAM,CAkGT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,YAAY,GAAE,MAAU,GACvB,MAAM,CAQR"}

package/dist/scout/prompt.js

@@ -0,0 +1,104 @@
+/**
+ * Scout prompt template
+ *
+ * This prompt is sent to Claude to analyze code and generate improvement proposals.
+ */
+/**
+ * Build the scout prompt for analyzing a batch of files
+ */
+export function buildScoutPrompt(options) {
+    const { files, scope, types, excludeTypes, maxProposals, minConfidence, recentlyCompletedTitles, customPrompt, protectedFiles, } = options;
+    const protectedNote = protectedFiles?.length
+        ? `\n\n**DO NOT propose changes to these files** (read-only context): ${protectedFiles.join(', ')}\n`
+        : '';
+    const categoryFilter = types?.length
+        ? `Focus ONLY on these categories: ${types.join(', ')}`
+        : excludeTypes?.length
+            ? `EXCLUDE these categories: ${excludeTypes.join(', ')}`
+            : 'Consider all categories';
+    const strategicFocus = customPrompt
+        ? `\n## Strategic Focus\n\n${customPrompt}\n`
+        : '';
+    const recentContext = recentlyCompletedTitles?.length
+        ? `\n\nAVOID proposing work similar to these recently completed tickets:\n${recentlyCompletedTitles.map(t => `- ${t}`).join('\n')}`
+        : '';
+    const fileContents = files
+        .map(f => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``)
+        .join('\n\n');
+    return `You are a senior software engineer reviewing code for improvement opportunities.
+
+Analyze these files from scope "${scope}" and identify actionable improvements.
+
+${categoryFilter}
+
+## Categories
+
+- **refactor**: Code quality, readability, maintainability improvements including:
+  - DRY violations (duplicate code that should be consolidated)
+  - Dead code removal (unused functions, imports, variables)
+  - Over-engineering (unnecessary abstractions, premature optimization)
+  - Inconsistent patterns (code that doesn't match surrounding conventions)
+  - Bloat cleanup (removing complexity that doesn't add value)
+- **docs**: Missing/outdated documentation, comments, README updates
+- **test**: Missing tests, edge cases, coverage gaps
+- **perf**: Performance optimizations, algorithmic improvements
+- **security**: Security vulnerabilities, input validation, auth issues
+
+## Requirements
+
+1. Each proposal MUST be:
+   - Specific and actionable (not vague)
+   - Self-contained (completable in one PR)
+   - Have at least one verification command
+   - Have confidence >= ${minConfidence}
+
+2. Verification commands should be:
+   - Runnable without manual setup
+   - NOT include grep/wc/file-specific test commands
+   - Prefer "npm run build" for non-test categories
+   - Prefer "npm test" for test categories
+
+3. Generate at most ${maxProposals} proposals, prioritized by impact.
+${protectedNote}${strategicFocus}${recentContext}
+
+## Files to Analyze
+
+${fileContents}
+
+## Output Format
+
+Respond with ONLY a JSON object (no markdown, no explanation):
+
+{
+  "proposals": [
+    {
+      "category": "refactor|docs|test|perf|security",
+      "title": "Short actionable title (imperative mood)",
+      "description": "What needs to be done and why",
+      "acceptance_criteria": ["Criterion 1", "Criterion 2"],
+      "verification_commands": ["npm run build"],
+      "allowed_paths": ["path/to/file.ts"],
+      "files": ["path/to/file.ts"],
+      "confidence": 75,
+      "impact_score": 5,
+      "rationale": "Why this improvement matters",
+      "estimated_complexity": "trivial|simple|moderate|complex"
+    }
+  ]
+}
+
+If no improvements are needed, return: {"proposals": []}`;
+}
+/**
+ * Build a focused prompt for a single category
+ */
+export function buildCategoryPrompt(category, files, maxProposals = 5) {
+    return buildScoutPrompt({
+        files,
+        scope: '*',
+        types: [category],
+        maxProposals,
+        minConfidence: 50,
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/scout/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/scout/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAWhC;IACC,MAAM,EACJ,KAAK,EACL,KAAK,EACL,KAAK,EACL,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,uBAAuB,EACvB,YAAY,EACZ,cAAc,GACf,GAAG,OAAO,CAAC;IAEZ,MAAM,aAAa,GAAG,cAAc,EAAE,MAAM;QAC1C,CAAC,CAAC,sEAAsE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACrG,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,cAAc,GAAG,KAAK,EAAE,MAAM;QAClC,CAAC,CAAC,mCAAmC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACvD,CAAC,CAAC,YAAY,EAAE,MAAM;YACpB,CAAC,CAAC,6BAA6B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACxD,CAAC,CAAC,yBAAyB,CAAC;IAEhC,MAAM,cAAc,GAAG,YAAY;QACjC,CAAC,CAAC,2BAA2B,YAAY,IAAI;QAC7C,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,aAAa,GAAG,uBAAuB,EAAE,MAAM;QACnD,CAAC,CAAC,0EAA0E,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACnI,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,YAAY,GAAG,KAAK;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,OAAO,UAAU,CAAC;SACvD,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO;;kCAEyB,KAAK;;EAErC,cAAc;;;;;;;;;;;;;;;;;;;;;0BAqBU,aAAa;;;;;;;;sBAQjB,YAAY;EAChC,aAAa,GAAG,cAAc,GAAG,aAAa;;;;EAI9C,YAAY;;;;;;;;;;;;;;;;;;;;;;;;yDAwB2C,CAAC;AAC1D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA0B,EAC1B,KAA+C,EAC/C,eAAuB,CAAC;IAExB,OAAO,gBAAgB,CAAC;QACtB,KAAK;QACL,KAAK,EAAE,GAAG;QACV,KAAK,EAAE,CAAC,QAAQ,CAAC;QACjB,YAAY;QACZ,aAAa,EAAE,EAAE;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/scout/runner.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Scout runner - Executes LLM CLI backends for analysis
+ */
+export interface RunnerOptions {
+    /** Prompt to send to the LLM */
+    prompt: string;
+    /** Working directory */
+    cwd: string;
+    /** Timeout in ms */
+    timeoutMs: number;
+    /** Model to use */
+    model?: string;
+    /** Cancellation signal */
+    signal?: AbortSignal;
+}
+export interface RunnerResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Output from the LLM */
+    output: string;
+    /** Error message if failed */
+    error?: string;
+    /** Duration in ms */
+    durationMs: number;
+}
+/**
+ * Pluggable scout backend interface
+ */
+export interface ScoutBackend {
+    /** Human-readable name for logging */
+    readonly name: string;
+    /** Run a scout prompt and return the result */
+    run(options: RunnerOptions): Promise<RunnerResult>;
+}
+/**
+ * Run Claude Code CLI with a prompt
+ */
+export declare function runClaude(options: RunnerOptions): Promise<RunnerResult>;
+/**
+ * Claude Code CLI scout backend (default)
+ */
+export declare class ClaudeScoutBackend implements ScoutBackend {
+    readonly name = "claude";
+    run(options: RunnerOptions): Promise<RunnerResult>;
+}
+/**
+ * Codex CLI scout backend
+ *
+ * Spawns `codex exec` in read-only sandbox mode for analysis.
+ * Uses --output-last-message for reliable output extraction.
+ */
+export declare class CodexScoutBackend implements ScoutBackend {
+    readonly name = "codex";
+    private apiKey?;
+    private defaultModel;
+    constructor(opts?: {
+        apiKey?: string;
+        model?: string;
+    });
+    run(options: RunnerOptions): Promise<RunnerResult>;
+}
+/**
+ * Parse JSON from Claude's output
+ *
+ * Handles common issues like markdown code blocks
+ */
+export declare function parseClaudeOutput<T>(output: string): T | null;
+//# sourceMappingURL=runner.d.ts.map

package/dist/scout/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/scout/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACpD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwG7E;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IAEzB,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAGnD;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAKhD,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CA2HzD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CA6B7D"}

package/dist/scout/runner.js

@@ -0,0 +1,270 @@
+/**
+ * Scout runner - Executes LLM CLI backends for analysis
+ */
+import { spawn } from 'node:child_process';
+import { writeFileSync, readFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Run Claude Code CLI with a prompt
+ */
+export async function runClaude(options) {
+    const { prompt, cwd, timeoutMs, model = 'opus', signal } = options;
+    const start = Date.now();
+    return new Promise((resolve) => {
+        // Check if already aborted
+        if (signal?.aborted) {
+            resolve({
+                success: false,
+                output: '',
+                error: 'Aborted before start',
+                durationMs: Date.now() - start,
+            });
+            return;
+        }
+        const args = [
+            '-p', prompt,
+            '--model', model,
+            '--output-format', 'text',
+            '--allowedTools', '', // Disable tools - content provided in prompt
+        ];
+        const proc = spawn('claude', args, {
+            cwd,
+            env: {
+                ...process.env,
+                CLAUDE_CODE_NON_INTERACTIVE: '1',
+            },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        let stderr = '';
+        let killed = false;
+        // Timeout handler
+        const timeout = setTimeout(() => {
+            killed = true;
+            proc.kill('SIGTERM');
+            // Grace period before SIGKILL
+            setTimeout(() => proc.kill('SIGKILL'), 5000);
+        }, timeoutMs);
+        // Abort signal handler
+        const abortHandler = () => {
+            killed = true;
+            proc.kill('SIGTERM');
+        };
+        signal?.addEventListener('abort', abortHandler);
+        proc.stdout.on('data', (data) => {
+            stdout += data.toString();
+        });
+        proc.stderr.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (code) => {
+            clearTimeout(timeout);
+            signal?.removeEventListener('abort', abortHandler);
+            const durationMs = Date.now() - start;
+            if (killed) {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: signal?.aborted ? 'Aborted by signal' : 'Timeout exceeded',
+                    durationMs,
+                });
+                return;
+            }
+            if (code !== 0) {
+                resolve({
+                    success: false,
+                    output: stdout,
+                    error: stderr || `Process exited with code ${code}`,
+                    durationMs,
+                });
+                return;
+            }
+            resolve({
+                success: true,
+                output: stdout,
+                durationMs,
+            });
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timeout);
+            signal?.removeEventListener('abort', abortHandler);
+            resolve({
+                success: false,
+                output: '',
+                error: err.message,
+                durationMs: Date.now() - start,
+            });
+        });
+    });
+}
+/**
+ * Claude Code CLI scout backend (default)
+ */
+export class ClaudeScoutBackend {
+    name = 'claude';
+    run(options) {
+        return runClaude(options);
+    }
+}
+/**
+ * Codex CLI scout backend
+ *
+ * Spawns `codex exec` in read-only sandbox mode for analysis.
+ * Uses --output-last-message for reliable output extraction.
+ */
+export class CodexScoutBackend {
+    name = 'codex';
+    apiKey;
+    defaultModel;
+    constructor(opts) {
+        this.apiKey = opts?.apiKey;
+        this.defaultModel = opts?.model ?? 'gpt-5.2-codex';
+    }
+    async run(options) {
+        const { prompt, cwd, timeoutMs, model, signal } = options;
+        const start = Date.now();
+        if (signal?.aborted) {
+            return { success: false, output: '', error: 'Aborted before start', durationMs: 0 };
+        }
+        const tmpDir = mkdtempSync(join(tmpdir(), 'blockspool-codex-'));
+        const outPath = join(tmpDir, 'output.md');
+        const schemaPath = join(tmpDir, 'schema.json');
+        // Write JSON schema so Codex returns structured output
+        writeFileSync(schemaPath, JSON.stringify({
+            type: 'object',
+            properties: {
+                proposals: {
+                    type: 'array',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            category: { type: 'string' },
+                            title: { type: 'string' },
+                            description: { type: 'string' },
+                            acceptance_criteria: { type: 'array', items: { type: 'string' } },
+                            verification_commands: { type: 'array', items: { type: 'string' } },
+                            allowed_paths: { type: 'array', items: { type: 'string' } },
+                            files: { type: 'array', items: { type: 'string' } },
+                            confidence: { type: 'number' },
+                            impact_score: { type: 'number' },
+                            rationale: { type: 'string' },
+                            estimated_complexity: { type: 'string' },
+                        },
+                        required: ['category', 'title', 'description', 'confidence', 'impact_score', 'files'],
+                    },
+                },
+            },
+            required: ['proposals'],
+        }));
+        try {
+            const effectiveModel = model ?? this.defaultModel;
+            const args = [
+                'exec',
+                '--json',
+                '--sandbox', 'read-only',
+                '--ask-for-approval', 'never',
+                '--output-last-message', outPath,
+                '--output-schema', schemaPath,
+                '--model', effectiveModel,
+                '--cd', cwd,
+                '-',
+            ];
+            const env = { ...process.env };
+            if (this.apiKey) {
+                env.CODEX_API_KEY = this.apiKey;
+            }
+            return await new Promise((resolve) => {
+                const proc = spawn('codex', args, {
+                    cwd,
+                    env,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                // Send prompt via stdin
+                proc.stdin.write(prompt);
+                proc.stdin.end();
+                let stdout = '';
+                let stderr = '';
+                let killed = false;
+                const timeout = setTimeout(() => {
+                    killed = true;
+                    proc.kill('SIGTERM');
+                    setTimeout(() => proc.kill('SIGKILL'), 5000);
+                }, timeoutMs);
+                const abortHandler = () => { killed = true; proc.kill('SIGTERM'); };
+                signal?.addEventListener('abort', abortHandler);
+                proc.stdout.on('data', (d) => { stdout += d.toString(); });
+                proc.stderr.on('data', (d) => { stderr += d.toString(); });
+                proc.on('close', (code) => {
+                    clearTimeout(timeout);
+                    signal?.removeEventListener('abort', abortHandler);
+                    const durationMs = Date.now() - start;
+                    if (killed) {
+                        resolve({ success: false, output: stdout, error: signal?.aborted ? 'Aborted by signal' : 'Timeout exceeded', durationMs });
+                        return;
+                    }
+                    // Prefer --output-last-message file over stdout (stdout is JSONL telemetry)
+                    let output = stdout;
+                    try {
+                        output = readFileSync(outPath, 'utf-8');
+                    }
+                    catch {
+                        // Fall back to stdout if file wasn't written
+                    }
+                    if (code !== 0) {
+                        resolve({ success: false, output, error: stderr || `codex exited with code ${code}`, durationMs });
+                        return;
+                    }
+                    resolve({ success: true, output, durationMs });
+                });
+                proc.on('error', (err) => {
+                    clearTimeout(timeout);
+                    signal?.removeEventListener('abort', abortHandler);
+                    resolve({ success: false, output: '', error: err.message, durationMs: Date.now() - start });
+                });
+            });
+        }
+        finally {
+            try {
+                rmSync(tmpDir, { recursive: true, force: true });
+            }
+            catch { /* best-effort cleanup */ }
+        }
+    }
+}
+/**
+ * Parse JSON from Claude's output
+ *
+ * Handles common issues like markdown code blocks
+ */
+export function parseClaudeOutput(output) {
+    // Try direct parse first
+    try {
+        return JSON.parse(output.trim());
+    }
+    catch {
+        // Ignore and try other methods
+    }
+    // Try extracting from markdown code block
+    const jsonMatch = output.match(/```(?:json)?\s*([\s\S]*?)```/);
+    if (jsonMatch) {
+        try {
+            return JSON.parse(jsonMatch[1].trim());
+        }
+        catch {
+            // Ignore
+        }
+    }
+    // Try finding JSON object/array in output
+    const objectMatch = output.match(/\{[\s\S]*\}/);
+    if (objectMatch) {
+        try {
+            return JSON.parse(objectMatch[0]);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=runner.js.map

package/dist/scout/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/scout/runner.ts"],"names":[],"mappings":"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"}

package/dist/scout/scanner.d.ts

@@ -0,0 +1,35 @@
+/**
+ * File scanner - Discovers and reads files for analysis
+ */
+/**
+ * File info with content
+ */
+export interface ScannedFile {
+    path: string;
+    content: string;
+    size: number;
+}
+/**
+ * Options for file scanning
+ */
+export interface ScanOptions {
+    /** Base directory */
+    cwd: string;
+    /** Glob-like patterns to include */
+    include: string[];
+    /** Glob-like patterns to exclude */
+    exclude?: string[];
+    /** Maximum file size in bytes (default: 100KB) */
+    maxFileSize?: number;
+    /** Maximum total files (default: 500) */
+    maxFiles?: number;
+}
+/**
+ * Scan a directory for files matching the given patterns
+ */
+export declare function scanFiles(options: ScanOptions): ScannedFile[];
+/**
+ * Group files into batches for processing
+ */
+export declare function batchFiles(files: ScannedFile[], batchSize?: number): ScannedFile[][];
+//# sourceMappingURL=scanner.d.ts.map

package/dist/scout/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/scout/scanner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAsKD;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,EAAE,CAI7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,SAAS,GAAE,MAAU,GAAG,WAAW,EAAE,EAAE,CAQvF"}