@blockspool/core 0.3.2 → 0.3.3

package/dist/services/qa.js

@@ -0,0 +1,239 @@
+/**
+ * QA Service - Run local QA commands and record results
+ *
+ * This is pure orchestration: no FS writes, no raw SQL.
+ * Uses repos + ExecRunner for all operations.
+ */
+import * as path from 'node:path';
+import * as runs from '../repos/runs.js';
+import * as runSteps from '../repos/run_steps.js';
+function resolveCwd(repoRootAbs, cwd) {
+    if (!cwd || cwd === '.')
+        return repoRootAbs;
+    return path.isAbsolute(cwd) ? cwd : path.join(repoRootAbs, cwd);
+}
+function execStatusToStepStatus(exec) {
+    if (exec.status === 'success')
+        return 'success';
+    if (exec.status === 'canceled')
+        return 'canceled';
+    return 'failed';
+}
+/**
+ * Extract flat fields from ExecOutput for repo methods
+ */
+function flattenOutput(output, prefix) {
+    return {
+        [`${prefix}Path`]: output.path,
+        [`${prefix}Bytes`]: output.bytes,
+        [`${prefix}Truncated`]: output.truncated,
+        [`${prefix}Tail`]: output.tail,
+    };
+}
+/**
+ * Run QA commands and record results
+ */
+export async function runQa(deps, opts) {
+    const { db, exec, logger } = deps;
+    const { projectId, repoRoot, config, signal } = opts;
+    if (!config.commands?.length) {
+        throw new Error('QA config has no commands. Add qa.commands to .blockspool/config.json');
+    }
+    // Validate unique step names
+    const names = new Set();
+    for (const c of config.commands) {
+        if (!c.name?.trim())
+            throw new Error('QA command is missing a name');
+        if (!c.cmd?.trim())
+            throw new Error(`QA command "${c.name}" is missing cmd`);
+        if (names.has(c.name))
+            throw new Error(`Duplicate QA command name: "${c.name}"`);
+        names.add(c.name);
+    }
+    const startedAtMs = Date.now();
+    // Determine max attempts
+    const maxAttempts = opts.maxAttemptsOverride ??
+        (config.retry.enabled ? config.retry.maxAttempts : 1);
+    // Create the run
+    const run = await runs.create(db, {
+        projectId,
+        type: 'qa',
+        maxIterations: maxAttempts,
+        metadata: {
+            maxAttempts,
+            commandCount: config.commands.length,
+        },
+    });
+    logger.info(`QA run started: ${run.id}`);
+    let latestAttempt = 1;
+    let finalStatus = 'failed';
+    let failedAt;
+    // Check for early cancellation
+    if (signal?.aborted) {
+        await runs.markFailure(db, run.id, 'Canceled before start', { attempts: 0 });
+        return {
+            runId: run.id,
+            projectId,
+            status: 'canceled',
+            attempts: 0,
+            latestAttempt: 0,
+            startedAtMs,
+            endedAtMs: Date.now(),
+            durationMs: Date.now() - startedAtMs,
+        };
+    }
+    // Attempt loop
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        latestAttempt = attempt;
+        logger.info(`Attempt ${attempt}/${maxAttempts}`);
+        // Pre-create steps as queued
+        const createdSteps = await runSteps.createMany(db, run.id, config.commands.map((c) => ({
+            name: c.name,
+            cmd: c.cmd,
+            cwd: c.cwd ?? '.',
+            timeoutMs: c.timeoutMs,
+        })), attempt);
+        let attemptFailed = false;
+        for (const step of createdSteps) {
+            // Check for cancellation before each step
+            if (signal?.aborted) {
+                await runSteps.markCanceled(db, step.id, 'Canceled by user');
+                // Cancel remaining steps
+                for (const remaining of createdSteps) {
+                    if (remaining.ordinal > step.ordinal) {
+                        await runSteps.markCanceled(db, remaining.id, 'Canceled by user');
+                    }
+                }
+                finalStatus = 'canceled';
+                failedAt = { attempt, stepName: step.name };
+                attemptFailed = true;
+                break;
+            }
+            await runSteps.markStarted(db, step.id);
+            const cmdCfg = config.commands[step.ordinal];
+            const cwdAbs = resolveCwd(repoRoot, cmdCfg.cwd ?? step.cwd ?? '.');
+            const execRes = await exec.run({
+                cmd: cmdCfg.cmd,
+                cwd: cwdAbs,
+                env: cmdCfg.env,
+                timeoutMs: cmdCfg.timeoutMs ?? step.timeoutMs ?? undefined,
+                signal,
+                repoRoot,
+                artifactsDir: config.artifacts.dir,
+                runId: run.id,
+                attempt,
+                stepName: step.name,
+                ordinal: step.ordinal,
+                maxLogBytes: config.artifacts.maxLogBytes,
+                tailBytes: config.artifacts.tailBytes,
+            });
+            const stepStatus = execStatusToStepStatus(execRes);
+            if (stepStatus === 'success') {
+                await runSteps.markSuccess(db, step.id, {
+                    exitCode: execRes.exitCode ?? 0,
+                    stdoutPath: execRes.stdout.path,
+                    stderrPath: execRes.stderr.path,
+                    stdoutBytes: execRes.stdout.bytes,
+                    stderrBytes: execRes.stderr.bytes,
+                    stdoutTruncated: execRes.stdout.truncated,
+                    stderrTruncated: execRes.stderr.truncated,
+                    stdoutTail: execRes.stdout.tail,
+                    stderrTail: execRes.stderr.tail,
+                    metadata: { execStatus: execRes.status },
+                });
+                logger.info(`  ✓ ${step.name}`);
+                continue;
+            }
+            // Failed or canceled
+            attemptFailed = true;
+            const errorMessage = execRes.errorMessage ??
+                (execRes.status === 'timeout'
+                    ? `Timed out after ${cmdCfg.timeoutMs ?? step.timeoutMs ?? 'unknown'}ms`
+                    : execRes.status === 'canceled'
+                        ? 'Canceled'
+                        : `Exited with code ${execRes.exitCode ?? 'unknown'}`);
+            if (stepStatus === 'canceled') {
+                await runSteps.markCanceled(db, step.id, errorMessage);
+                finalStatus = 'canceled';
+            }
+            else {
+                await runSteps.markFailed(db, step.id, {
+                    exitCode: execRes.exitCode ?? undefined,
+                    signal: execRes.signal ?? undefined,
+                    errorMessage,
+                    stdoutPath: execRes.stdout.path,
+                    stderrPath: execRes.stderr.path,
+                    stdoutBytes: execRes.stdout.bytes,
+                    stderrBytes: execRes.stderr.bytes,
+                    stdoutTruncated: execRes.stdout.truncated,
+                    stderrTruncated: execRes.stderr.truncated,
+                    stdoutTail: execRes.stdout.tail,
+                    stderrTail: execRes.stderr.tail,
+                    metadata: { execStatus: execRes.status },
+                });
+                finalStatus = 'failed';
+            }
+            logger.error(`  ✗ ${step.name}: ${errorMessage}`);
+            failedAt = { attempt, stepName: step.name };
+            // Cancel remaining queued steps in this attempt
+            for (const remaining of createdSteps) {
+                if (remaining.ordinal <= step.ordinal)
+                    continue;
+                await runSteps.markSkipped(db, remaining.id, `Skipped (previous step "${step.name}" ${stepStatus})`);
+            }
+            break;
+        }
+        if (!attemptFailed) {
+            finalStatus = 'success';
+            failedAt = undefined;
+            break;
+        }
+        // If canceled, don't retry
+        if (finalStatus === 'canceled') {
+            break;
+        }
+    }
+    const endedAtMs = Date.now();
+    // Finalize run
+    if (finalStatus === 'success') {
+        await runs.markSuccess(db, run.id, {
+            attempts: latestAttempt,
+            durationMs: endedAtMs - startedAtMs,
+        });
+    }
+    else {
+        const errorMsg = failedAt
+            ? `Failed at ${failedAt.stepName} (attempt ${failedAt.attempt})`
+            : finalStatus === 'canceled'
+                ? 'QA canceled'
+                : 'QA failed';
+        await runs.markFailure(db, run.id, errorMsg, {
+            attempts: latestAttempt,
+            failedAt,
+            durationMs: endedAtMs - startedAtMs,
+        });
+    }
+    return {
+        runId: run.id,
+        projectId,
+        status: finalStatus,
+        attempts: latestAttempt,
+        latestAttempt,
+        failedAt,
+        startedAtMs,
+        endedAtMs,
+        durationMs: endedAtMs - startedAtMs,
+    };
+}
+/**
+ * Get QA run details with step information
+ */
+export async function getQaRunDetails(db, runId) {
+    const run = await runs.getById(db, runId);
+    if (!run)
+        return null;
+    const steps = await runSteps.listByRun(db, runId);
+    const summary = await runSteps.getSummary(db, runId);
+    return { run, steps, summary };
+}
+//# sourceMappingURL=qa.js.map

package/dist/services/qa.js.map

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

package/dist/services/scout.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Scout Service - Orchestrates codebase scanning and ticket creation
+ *
+ * This is pure orchestration - it coordinates between:
+ * - File scanning (scanner.ts)
+ * - LLM analysis (runner.ts)
+ * - Data persistence (repos/*)
+ *
+ * It accepts dependencies via ScoutDeps, making it testable and adapter-agnostic.
+ */
+import type { DatabaseAdapter } from '../db/adapter.js';
+import * as projects from '../repos/projects.js';
+import * as tickets from '../repos/tickets.js';
+import * as runs from '../repos/runs.js';
+import { type TicketProposal, type ScoutBackend } from '../scout/index.js';
+/**
+ * Dependencies for the scout service
+ */
+export interface ScoutDeps {
+    /** Database adapter */
+    db: DatabaseAdapter;
+    /** Git operations */
+    git: GitService;
+    /** Logger */
+    logger?: Logger;
+    /** Clock for timestamps (useful for testing) */
+    clock?: () => Date;
+}
+/**
+ * Git service interface
+ */
+export interface GitService {
+    /** Find repository root from a path */
+    findRepoRoot(path: string): Promise<string | null>;
+    /** Get remote URL */
+    getRemoteUrl(repoRoot: string): Promise<string | null>;
+    /** Generate deterministic project ID from repo */
+    getProjectId(repoRoot: string, remoteUrl: string | null): string;
+}
+/**
+ * Logger interface
+ */
+export interface Logger {
+    debug(msg: string, data?: Record<string, unknown>): void;
+    info(msg: string, data?: Record<string, unknown>): void;
+    warn(msg: string, data?: Record<string, unknown>): void;
+    error(msg: string, data?: Record<string, unknown>): void;
+}
+/**
+ * Scout options
+ */
+export interface ScoutRepoOptions {
+    /** Path to scan (defaults to repo root) */
+    path?: string;
+    /** Glob pattern for files */
+    scope?: string;
+    /** Filter to categories */
+    types?: Array<'refactor' | 'docs' | 'test' | 'perf' | 'security'>;
+    /** Maximum proposals */
+    maxProposals?: number;
+    /** Minimum confidence threshold */
+    minConfidence?: number;
+    /** Model to use */
+    model?: 'haiku' | 'sonnet' | 'opus';
+    /** Custom prompt from formula — tells the AI what to focus on */
+    customPrompt?: string;
+    /** Timeout per batch */
+    timeoutMs?: number;
+    /** Abort signal */
+    signal?: AbortSignal;
+    /** Progress callback */
+    onProgress?: (progress: ScoutProgress) => void;
+    /** Auto-create tickets from proposals */
+    autoApprove?: boolean;
+    /** Scout backend override (default: ClaudeScoutBackend) */
+    backend?: ScoutBackend;
+    /** Files the scout can read but must NOT propose changes to */
+    protectedFiles?: string[];
+}
+/**
+ * Scout progress
+ */
+export interface ScoutProgress {
+    phase: 'init' | 'scanning' | 'analyzing' | 'storing' | 'complete';
+    filesScanned?: number;
+    totalFiles?: number;
+    proposalsFound?: number;
+    ticketsCreated?: number;
+    message?: string;
+}
+/**
+ * Scout result
+ */
+export interface ScoutRepoResult {
+    success: boolean;
+    project: projects.Project;
+    run: runs.Run;
+    proposals: TicketProposal[];
+    tickets: tickets.Ticket[];
+    errors: string[];
+    scannedFiles: number;
+    durationMs: number;
+}
+/**
+ * Scout a repository for improvement opportunities
+ *
+ * This is the main entry point for the scout service. It:
+ * 1. Resolves the repository root
+ * 2. Ensures the project exists in the database
+ * 3. Creates a scout run
+ * 4. Scans files and generates proposals
+ * 5. Optionally creates tickets from proposals
+ * 6. Records the run outcome
+ */
+export declare function scoutRepo(deps: ScoutDeps, opts?: ScoutRepoOptions): Promise<ScoutRepoResult>;
+/**
+ * Approve specific proposals and create tickets
+ */
+export declare function approveProposals(deps: ScoutDeps, projectId: string, proposals: TicketProposal[]): Promise<tickets.Ticket[]>;
+//# sourceMappingURL=scout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scout.d.ts","sourceRoot":"","sources":["../../src/services/scout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,QAAQ,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,uBAAuB;IACvB,EAAE,EAAE,eAAe,CAAC;IACpB,qBAAqB;IACrB,GAAG,EAAE,UAAU,CAAC;IAChB,aAAa;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACnD,qBAAqB;IACrB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvD,kDAAkD;IAClD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,CAAC;IAClE,wBAAwB;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mCAAmC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB;IACnB,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC1B,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;IACd,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,SAAS,EACf,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAmK1B;AAyBD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,cAAc,EAAE,GAC1B,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAkB3B"}

package/dist/services/scout.js

@@ -0,0 +1,205 @@
+/**
+ * Scout Service - Orchestrates codebase scanning and ticket creation
+ *
+ * This is pure orchestration - it coordinates between:
+ * - File scanning (scanner.ts)
+ * - LLM analysis (runner.ts)
+ * - Data persistence (repos/*)
+ *
+ * It accepts dependencies via ScoutDeps, making it testable and adapter-agnostic.
+ */
+import * as projects from '../repos/projects.js';
+import * as tickets from '../repos/tickets.js';
+import * as runs from '../repos/runs.js';
+import { scout as scanAndPropose, } from '../scout/index.js';
+/**
+ * Scout a repository for improvement opportunities
+ *
+ * This is the main entry point for the scout service. It:
+ * 1. Resolves the repository root
+ * 2. Ensures the project exists in the database
+ * 3. Creates a scout run
+ * 4. Scans files and generates proposals
+ * 5. Optionally creates tickets from proposals
+ * 6. Records the run outcome
+ */
+export async function scoutRepo(deps, opts = {}) {
+    const { db, git, logger } = deps;
+    const startTime = Date.now();
+    const errors = [];
+    const report = (progress) => {
+        opts.onProgress?.({
+            phase: 'init',
+            ...progress,
+        });
+    };
+    // Phase 1: Resolve repository
+    report({ phase: 'init', message: 'Resolving repository...' });
+    const targetPath = opts.path ?? process.cwd();
+    const repoRoot = await git.findRepoRoot(targetPath);
+    if (!repoRoot) {
+        throw new Error(`Not a git repository: ${targetPath}`);
+    }
+    const remoteUrl = await git.getRemoteUrl(repoRoot);
+    const projectId = git.getProjectId(repoRoot, remoteUrl);
+    logger?.debug('Resolved repository', { repoRoot, remoteUrl, projectId });
+    // Phase 2: Ensure project exists
+    const project = await projects.ensureForRepo(db, {
+        id: projectId,
+        name: repoRoot.split('/').pop() || 'unknown',
+        repoUrl: remoteUrl,
+        rootPath: repoRoot,
+    });
+    logger?.info('Project ensured', { projectId: project.id, name: project.name });
+    // Phase 3: Create scout run
+    const run = await runs.create(db, {
+        projectId: project.id,
+        type: 'scout',
+        metadata: {
+            scope: opts.scope ?? 'src/**',
+            maxProposals: opts.maxProposals ?? 10,
+            model: opts.model ?? 'opus',
+        },
+    });
+    logger?.debug('Scout run created', { runId: run.id });
+    try {
+        // Phase 4: Get dedup context
+        const recentTickets = await tickets.getRecentlyCompleted(db, project.id, 20);
+        const recentTitles = recentTickets.map(t => t.title);
+        // Phase 5: Scan and generate proposals
+        report({ phase: 'scanning', message: 'Scanning files...' });
+        const scanResult = await scanAndPropose({
+            scope: opts.scope ?? 'src/**',
+            types: opts.types,
+            maxProposals: opts.maxProposals ?? 10,
+            minConfidence: opts.minConfidence ?? 50,
+            projectPath: repoRoot,
+            model: opts.model ?? 'opus',
+            timeoutMs: opts.timeoutMs ?? 120000,
+            signal: opts.signal,
+            recentlyCompletedTitles: recentTitles,
+            customPrompt: opts.customPrompt,
+            backend: opts.backend,
+            protectedFiles: opts.protectedFiles,
+            onProgress: (p) => {
+                report({
+                    phase: 'analyzing',
+                    filesScanned: p.filesScanned,
+                    totalFiles: p.totalFiles,
+                    proposalsFound: p.proposalsFound,
+                    message: `Analyzing batch ${p.currentBatch}/${p.totalBatches}`,
+                });
+            },
+        });
+        if (!scanResult.success) {
+            errors.push(...scanResult.errors);
+        }
+        logger?.info('Scan complete', {
+            files: scanResult.scannedFiles,
+            proposals: scanResult.proposals.length,
+        });
+        // Phase 6: Create tickets if auto-approve
+        const createdTickets = [];
+        if (opts.autoApprove && scanResult.proposals.length > 0) {
+            report({
+                phase: 'storing',
+                proposalsFound: scanResult.proposals.length,
+                message: 'Creating tickets...',
+            });
+            const ticketInputs = scanResult.proposals.map(proposal => ({
+                projectId: project.id,
+                title: proposal.title,
+                description: formatProposalDescription(proposal),
+                status: 'ready',
+                priority: proposal.confidence,
+                category: proposal.category,
+                allowedPaths: proposal.allowed_paths,
+                verificationCommands: proposal.verification_commands,
+            }));
+            const created = await tickets.createMany(db, ticketInputs);
+            createdTickets.push(...created);
+            logger?.info('Tickets created', { count: created.length });
+        }
+        // Phase 7: Mark run success
+        await runs.markSuccess(db, run.id, {
+            scannedFiles: scanResult.scannedFiles,
+            proposalCount: scanResult.proposals.length,
+            ticketCount: createdTickets.length,
+            durationMs: Date.now() - startTime,
+        });
+        report({
+            phase: 'complete',
+            filesScanned: scanResult.scannedFiles,
+            proposalsFound: scanResult.proposals.length,
+            ticketsCreated: createdTickets.length,
+        });
+        return {
+            success: true,
+            project,
+            run: (await runs.getById(db, run.id)),
+            proposals: scanResult.proposals,
+            tickets: createdTickets,
+            errors: scanResult.errors,
+            scannedFiles: scanResult.scannedFiles,
+            durationMs: Date.now() - startTime,
+        };
+    }
+    catch (error) {
+        // Mark run as failed
+        await runs.markFailure(db, run.id, error, {
+            durationMs: Date.now() - startTime,
+        });
+        logger?.error('Scout failed', { error: error.message });
+        return {
+            success: false,
+            project,
+            run: (await runs.getById(db, run.id)),
+            proposals: [],
+            tickets: [],
+            errors: [...errors, error.message],
+            scannedFiles: 0,
+            durationMs: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * Format a proposal into ticket description markdown
+ */
+function formatProposalDescription(proposal) {
+    const parts = [
+        proposal.description,
+        '',
+        '## Acceptance Criteria',
+        ...proposal.acceptance_criteria.map(c => `- ${c}`),
+        '',
+        '## Rationale',
+        proposal.rationale,
+        '',
+        '## Files',
+        ...proposal.files.map(f => `- \`${f}\``),
+        '',
+        `**Complexity:** ${proposal.estimated_complexity}`,
+        `**Confidence:** ${proposal.confidence}%`,
+    ];
+    return parts.join('\n');
+}
+/**
+ * Approve specific proposals and create tickets
+ */
+export async function approveProposals(deps, projectId, proposals) {
+    const { db, logger } = deps;
+    const ticketInputs = proposals.map(proposal => ({
+        projectId,
+        title: proposal.title,
+        description: formatProposalDescription(proposal),
+        status: 'ready',
+        priority: proposal.confidence,
+        category: proposal.category,
+        allowedPaths: proposal.allowed_paths,
+        verificationCommands: proposal.verification_commands,
+    }));
+    const created = await tickets.createMany(db, ticketInputs);
+    logger?.info('Proposals approved', { count: created.length });
+    return created;
+}
+//# sourceMappingURL=scout.js.map

package/dist/services/scout.js.map

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

package/dist/utils/id.d.ts

@@ -0,0 +1,12 @@
+/**
+ * ID generation utilities
+ */
+/**
+ * Generate a random ID
+ */
+export declare function nanoid(size?: number): string;
+/**
+ * Generate a prefixed ID
+ */
+export declare function prefixedId(prefix: string, size?: number): string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAW,GAAG,MAAM,CAWhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,CAEpE"}

package/dist/utils/id.js

@@ -0,0 +1,24 @@
+/**
+ * ID generation utilities
+ */
+const ALPHABET = '0123456789abcdefghijklmnopqrstuvwxyz';
+/**
+ * Generate a random ID
+ */
+export function nanoid(size = 21) {
+    let id = '';
+    const bytes = new Uint8Array(size);
+    // eslint-disable-next-line no-undef
+    crypto.getRandomValues(bytes);
+    for (let i = 0; i < size; i++) {
+        id += ALPHABET[bytes[i] % ALPHABET.length];
+    }
+    return id;
+}
+/**
+ * Generate a prefixed ID
+ */
+export function prefixedId(prefix, size = 12) {
+    return `${prefix}_${nanoid(size)}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/utils/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAExD;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe,EAAE;IACtC,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,oCAAoC;IACpC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,OAAe,EAAE;IAC1D,OAAO,GAAG,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;AACrC,CAAC"}

package/dist/utils/id.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for ID generation utilities
+ */
+export {};
+//# sourceMappingURL=id.test.d.ts.map

package/dist/utils/id.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.test.d.ts","sourceRoot":"","sources":["../../src/utils/id.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}