@promptwheel/core 0.6.0

package/dist/services/qa.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 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 type { DatabaseAdapter } from '../db/adapter.js';
+import type { ExecRunner } from '../exec/types.js';
+import * as runs from '../repos/runs.js';
+import * as runSteps from '../repos/run_steps.js';
+export interface QaLogger {
+    info: (msg: string) => void;
+    warn?: (msg: string) => void;
+    error: (msg: string) => void;
+    debug?: (msg: string) => void;
+}
+export interface QaCommand {
+    name: string;
+    cmd: string;
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    timeoutMs?: number;
+}
+export interface QaArtifactsConfig {
+    dir: string;
+    maxLogBytes: number;
+    tailBytes: number;
+}
+export interface QaRetryConfig {
+    enabled: boolean;
+    maxAttempts: number;
+}
+export interface QaConfig {
+    commands: QaCommand[];
+    artifacts: QaArtifactsConfig;
+    retry: QaRetryConfig;
+}
+export interface QaDeps {
+    db: DatabaseAdapter;
+    exec: ExecRunner;
+    logger: QaLogger;
+}
+export interface QaRunOptions {
+    projectId: string;
+    repoRoot: string;
+    config: QaConfig;
+    maxAttemptsOverride?: number;
+    signal?: AbortSignal;
+}
+export interface QaRunResult {
+    runId: string;
+    projectId: string;
+    status: 'success' | 'failed' | 'canceled';
+    attempts: number;
+    latestAttempt: number;
+    failedAt?: {
+        attempt: number;
+        stepName: string;
+    };
+    startedAtMs: number;
+    endedAtMs: number;
+    durationMs: number;
+}
+/**
+ * Run QA commands and record results
+ */
+export declare function runQa(deps: QaDeps, opts: QaRunOptions): Promise<QaRunResult>;
+/**
+ * Get QA run details with step information
+ */
+export declare function getQaRunDetails(db: DatabaseAdapter, runId: string): Promise<{
+    run: runs.Run | null;
+    steps: runSteps.RunStep[];
+    summary: runSteps.StepSummary;
+} | null>;
+//# sourceMappingURL=qa.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"qa.d.ts","sourceRoot":"","sources":["../../src/services/qa.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AAElD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,eAAe,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAaD;;GAEG;AACH,wBAAsB,KAAK,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,WAAW,CAAC,CAmOtB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,EAAE,EAAE,eAAe,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IACT,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC;CAC/B,GAAG,IAAI,CAAC,CAQR"}

package/dist/services/qa.js

@@ -0,0 +1,228 @@
+/**
+ * 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';
+}
+/**
+ * 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 .promptwheel/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":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,OAAO,KAAK,IAAI,MAAM,kBAAkB,CAAC;AACzC,OAAO,KAAK,QAAQ,MAAM,uBAAuB,CAAC;AA+DlD,SAAS,UAAU,CAAC,WAAmB,EAAE,GAAY;IACnD,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,WAAW,CAAC;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAgB;IAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAClD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CACzB,IAAY,EACZ,IAAkB;IAElB,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAClC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAErD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5F,CAAC;IAED,6BAA6B;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACrE,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC;QAC7E,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACjF,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE/B,yBAAyB;IACzB,MAAM,WAAW,GACf,IAAI,CAAC,mBAAmB;QACxB,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,iBAAiB;IACjB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE;QAChC,SAAS;QACT,IAAI,EAAE,IAAI;QACV,aAAa,EAAE,WAAW;QAC1B,QAAQ,EAAE;YACR,WAAW;YACX,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;SACrC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IAEzC,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,WAAW,GAAsC,QAAQ,CAAC;IAC9D,IAAI,QAA6C,CAAC;IAElD,+BAA+B;IAC/B,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,uBAAuB,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAC7E,OAAO;YACL,KAAK,EAAE,GAAG,CAAC,EAAE;YACb,SAAS;YACT,MAAM,EAAE,UAAU;YAClB,QAAQ,EAAE,CAAC;YACX,aAAa,EAAE,CAAC;YAChB,WAAW;YACX,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW;SACrC,CAAC;IACJ,CAAC;IAED,eAAe;IACf,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACxD,aAAa,GAAG,OAAO,CAAC;QACxB,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,IAAI,WAAW,EAAE,CAAC,CAAC;QAEjD,6BAA6B;QAC7B,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,UAAU,CAC5C,EAAE,EACF,GAAG,CAAC,EAAE,EACN,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG;YACjB,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,EACH,OAAO,CACR,CAAC;QAEF,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;YAChC,0CAA0C;YAC1C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;gBACpB,MAAM,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;gBAC7D,yBAAyB;gBACzB,KAAK,MAAM,SAAS,IAAI,YAAY,EAAE,CAAC;oBACrC,IAAI,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;wBACrC,MAAM,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC;oBACpE,CAAC;gBACH,CAAC;gBACD,WAAW,GAAG,UAAU,CAAC;gBACzB,QAAQ,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5C,aAAa,GAAG,IAAI,CAAC;gBACrB,MAAM;YACR,CAAC;YAED,MAAM,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAExC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;YAEnE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC;gBAC7B,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,GAAG,EAAE,MAAM;gBACX,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,SAAS;gBAC1D,MAAM;gBAEN,QAAQ;gBACR,YAAY,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG;gBAElC,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;gBAErB,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW;gBACzC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,SAAS;aACtC,CAAC,CAAC;YAEH,MAAM,UAAU,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC;YAEnD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,QAAQ,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;oBACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;oBAC/B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;oBACjC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;oBACjC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;oBACzC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;oBACzC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,QAAQ,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE;iBACzC,CAAC,CAAC;gBACH,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YAED,qBAAqB;YACrB,aAAa,GAAG,IAAI,CAAC;YAErB,MAAM,YAAY,GAChB,OAAO,CAAC,YAAY;gBACpB,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;oBAC3B,CAAC,CAAC,mBAAmB,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,IAAI,SAAS,IAAI;oBACxE,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,UAAU;wBAC/B,CAAC,CAAC,UAAU;wBACZ,CAAC,CAAC,oBAAoB,OAAO,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC,CAAC;YAE3D,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC9B,MAAM,QAAQ,CAAC,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC;gBACvD,WAAW,GAAG,UAAU,CAAC;YAC3B,CAAC;iBAAM,CAAC;gBACN,MAAM,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;oBACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;oBACvC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;oBACnC,YAAY;oBACZ,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;oBACjC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;oBACjC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;oBACzC,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;oBACzC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;oBAC/B,QAAQ,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE;iBACzC,CAAC,CAAC;gBACH,WAAW,GAAG,QAAQ,CAAC;YACzB,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC,CAAC;YAClD,QAAQ,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAE5C,gDAAgD;YAChD,KAAK,MAAM,SAAS,IAAI,YAAY,EAAE,CAAC;gBACrC,IAAI,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO;oBAAE,SAAS;gBAChD,MAAM,QAAQ,CAAC,WAAW,CACxB,EAAE,EACF,SAAS,CAAC,EAAE,EACZ,2BAA2B,IAAI,CAAC,IAAI,KAAK,UAAU,GAAG,CACvD,CAAC;YACJ,CAAC;YAED,MAAM;QACR,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,WAAW,GAAG,SAAS,CAAC;YACxB,QAAQ,GAAG,SAAS,CAAC;YACrB,MAAM;QACR,CAAC;QAED,2BAA2B;QAC3B,IAAI,WAAW,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,eAAe;IACf,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE;YACjC,QAAQ,EAAE,aAAa;YACvB,UAAU,EAAE,SAAS,GAAG,WAAW;SACpC,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,QAAQ;YACvB,CAAC,CAAC,aAAa,QAAQ,CAAC,QAAQ,aAAa,QAAQ,CAAC,OAAO,GAAG;YAChE,CAAC,CAAC,WAAW,KAAK,UAAU;gBAC5B,CAAC,CAAC,aAAa;gBACf,CAAC,CAAC,WAAW,CAAC;QAChB,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE;YAC3C,QAAQ,EAAE,aAAa;YACvB,QAAQ;YACR,UAAU,EAAE,SAAS,GAAG,WAAW;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,SAAS;QACT,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,aAAa;QACvB,aAAa;QACb,QAAQ;QACR,WAAW;QACX,SAAS;QACT,UAAU,EAAE,SAAS,GAAG,WAAW;KACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,EAAmB,EACnB,KAAa;IAMb,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAEtB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAErD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC"}

package/dist/services/scout.d.ts

@@ -0,0 +1,164 @@
+/**
+ * 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, type ProposalCategory } 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?: ProposalCategory[];
+    /** Categories to exclude */
+    excludeTypes?: ProposalCategory[];
+    /** 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;
+    /** Raw output streaming callback (per-batch stdout/stderr) */
+    onRawOutput?: (batchIndex: number, chunk: string) => 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[];
+    /** Token budget per scout batch (default: auto based on backend) */
+    batchTokenBudget?: number;
+    /** Maximum files to scan per cycle (default: 60) */
+    maxFiles?: number;
+    /** Max parallel scout batches (default: auto — 4 for codex, 3 for claude) */
+    scoutConcurrency?: number;
+    /** Module groups for dependency-aware batching */
+    moduleGroups?: import('../scout/scanner.js').ModuleGroup[];
+    /** Coverage context passed through to the scout prompt */
+    coverageContext?: {
+        sectorPath: string;
+        scannedSectors: number;
+        totalSectors: number;
+        percent: number;
+        sectorPercent: number;
+        classificationConfidence: string;
+        scanCount: number;
+        proposalYield: number;
+        sectorSummary?: string;
+        sectorDifficulty?: 'easy' | 'moderate' | 'hard';
+        sectorCategoryAffinity?: {
+            boost: string[];
+            suppress: string[];
+        };
+    };
+}
+/**
+ * Scout progress
+ */
+export interface BatchStatus {
+    index: number;
+    status: 'waiting' | 'running' | 'done' | 'failed';
+    proposals?: number;
+    startedAt?: number;
+    durationMs?: number;
+    error?: string;
+}
+export interface ScoutProgress {
+    phase: 'init' | 'scanning' | 'analyzing' | 'storing' | 'complete';
+    filesScanned?: number;
+    totalFiles?: number;
+    proposalsFound?: number;
+    ticketsCreated?: number;
+    message?: string;
+    /** Per-batch status for multi-line display */
+    batchStatuses?: BatchStatus[];
+    totalBatches?: number;
+}
+/**
+ * Scout result
+ */
+export interface ScoutRepoResult {
+    success: boolean;
+    project: projects.Project;
+    run: runs.Run;
+    proposals: TicketProposal[];
+    tickets: tickets.Ticket[];
+    errors: string[];
+    scannedFiles: number;
+    durationMs: number;
+    sectorReclassification?: {
+        production?: boolean;
+        confidence?: string;
+    };
+}
+/**
+ * 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":"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"}