@promptwheel/core 0.6.0

package/dist/codebase-index/shared.js

@@ -0,0 +1,319 @@
+/**
+ * Codebase index shared algorithms — pure functions for module classification,
+ * import extraction, dependency resolution, and prompt formatting.
+ *
+ * No filesystem, git, or child_process I/O. The I/O-heavy functions
+ * (buildCodebaseIndex, refreshCodebaseIndex, hasStructuralChanges) live
+ * in ./index.ts and import these pure algorithms.
+ */
+import * as path from 'node:path';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const SOURCE_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs',
+    '.py',
+    '.rs',
+    '.go',
+    '.rb',
+    '.java', '.kt', '.kts', '.scala',
+    '.cs',
+    '.ex', '.exs',
+    '.php',
+    '.swift',
+    '.dart',
+    '.c', '.cpp', '.h', '.hpp',
+    '.hs',
+    '.lua',
+    '.zig',
+]);
+/** Directory-name hint — fast path when the name is unambiguous. */
+export const PURPOSE_HINT = {
+    api: 'api', apis: 'api', routes: 'api', handlers: 'api',
+    controllers: 'api', endpoints: 'api',
+    services: 'services', service: 'services', lib: 'services', core: 'services',
+    ui: 'ui', components: 'ui', views: 'ui', pages: 'ui', screens: 'ui',
+    utils: 'utils', util: 'utils', helpers: 'utils', shared: 'utils', common: 'utils',
+};
+export const NON_PRODUCTION_PURPOSES = new Set([
+    'tests', 'config', 'fixtures', 'docs', 'scripts', 'generated',
+]);
+/** Chunk size for prompt rendering. */
+export const CHUNK_SIZE = 15;
+// ---------------------------------------------------------------------------
+// Regex patterns
+// ---------------------------------------------------------------------------
+/** File-name patterns that indicate non-production files (even within production modules). */
+export const NON_PROD_FILE_RE = /\.(test|spec|e2e|integration|stories|story)\./i;
+/**
+ * Polyglot test-content patterns — matches test framework calls across languages.
+ */
+export const TEST_CONTENT_RE = new RegExp([
+    /\b(describe|it|test|expect|assert|beforeEach|afterEach|beforeAll|afterAll|jest|vitest|mocha|chai)\s*[.(]/.source,
+    /\b(pytest|unittest|def test_)\b/.source,
+    /#\[(test|cfg\(test\))\]/.source,
+    /\bfunc\s+Test[A-Z]/.source,
+    /@(Test|TestMethod)\b/.source,
+    /\b(RSpec\.|Minitest|should\s)/.source,
+    /\b(ExUnit|use ExUnit)/.source,
+    /\b(PHPUnit|->assert[A-Z])/.source,
+    /\b(XCTestCase|func\s+test[A-Z])/.source,
+].join('|'));
+export const GENERATED_RE = /(@generated|DO NOT EDIT|auto-generated|THIS FILE IS GENERATED|generated by)/i;
+export const CONFIG_CONTENT_RE = /\b(module\.exports|export default|defineConfig|createConfig)\b/;
+export const CONFIG_EXT_RE = /\.(json|ya?ml|toml|ini|env)$/i;
+export const FIXTURE_CONTENT_RE = /\b(mock[A-Z]\w*|fake[A-Z]\w*|stub[A-Z]\w*|fixture[A-Z]\w*)\s*[=:]|\bexport\s+(const|function)\s+(mock|fake|stub|fixture|seed|sample)/i;
+// JS/TS: import ... from '...' or require('...')
+export const JS_IMPORT_RE = /(?:import\s+.*?\s+from\s+['"]([^'"]+)['"]|require\s*\(\s*['"]([^'"]+)['"]\s*\))/g;
+// Python: from X import ... or import X
+export const PY_IMPORT_RE = /(?:from\s+([\w.]+)\s+import|^import\s+([\w.]+))/gm;
+// Go: import "..."
+export const GO_IMPORT_RE = /import\s+"([^"]+)"/g;
+// ---------------------------------------------------------------------------
+// Pure functions
+// ---------------------------------------------------------------------------
+/** Map directory name to a purpose hint. Returns 'unknown' if no match. */
+export function purposeHintFromDirName(dirName) {
+    return PURPOSE_HINT[dirName.toLowerCase()] ?? 'unknown';
+}
+/**
+ * Pick up to `count` items, evenly spaced across the array.
+ * Avoids alphabetical bias of always sampling the first N.
+ */
+export function sampleEvenly(arr, count) {
+    if (arr.length <= count)
+        return arr;
+    const step = arr.length / count;
+    const result = [];
+    for (let i = 0; i < count; i++) {
+        result.push(arr[Math.floor(i * step)]);
+    }
+    return result;
+}
+/** Count non-production files by name pattern within a file list. */
+export function countNonProdFiles(fileNames) {
+    return fileNames.filter(f => NON_PROD_FILE_RE.test(f)).length;
+}
+/**
+ * Classify a module by analyzing its file names and content snippets.
+ *
+ * Uses file-name patterns (checked against ALL files — cheap string matching)
+ * and content analysis (sampled snippets from evenly-distributed files).
+ *
+ * Thresholds use both ratio AND absolute count to avoid misclassifying
+ * large mixed modules (40% test in a 500-file module ≠ production).
+ */
+export function classifyModule(dirName, allFileNames, contentSnippets, totalFileCount) {
+    const nonProdFiles = countNonProdFiles(allFileNames);
+    const nonProdRatio = allFileNames.length > 0 ? nonProdFiles / allFileNames.length : 0;
+    // 1. Majority of files are test/story files → whole module is non-production
+    if (nonProdRatio > 0.5 || (nonProdFiles >= 10 && nonProdRatio > 0.4)) {
+        return { purpose: 'tests', production: false, productionFileCount: 0, confidence: 'high' };
+    }
+    // 2. Check content signals across sampled snippets
+    let testHits = 0;
+    let generatedHits = 0;
+    let configHits = 0;
+    let fixtureHits = 0;
+    const total = contentSnippets.length || 1;
+    for (const snippet of contentSnippets) {
+        if (TEST_CONTENT_RE.test(snippet))
+            testHits++;
+        if (GENERATED_RE.test(snippet))
+            generatedHits++;
+        if (CONFIG_CONTENT_RE.test(snippet))
+            configHits++;
+        if (FIXTURE_CONTENT_RE.test(snippet))
+            fixtureHits++;
+    }
+    if (generatedHits / total > 0.5) {
+        return { purpose: 'generated', production: false, productionFileCount: 0, confidence: 'high' };
+    }
+    if (testHits / total > 0.5) {
+        return { purpose: 'tests', production: false, productionFileCount: 0, confidence: 'high' };
+    }
+    if (fixtureHits / total > 0.5) {
+        return { purpose: 'fixtures', production: false, productionFileCount: 0, confidence: 'high' };
+    }
+    // 3. Config: mostly config-extension files or config content
+    const configFileCount = allFileNames.filter(f => CONFIG_EXT_RE.test(f)).length;
+    const configFileRatio = allFileNames.length > 0 ? configFileCount / allFileNames.length : 0;
+    if (configFileRatio > 0.5 || (configHits / total > 0.5 && configFileRatio > 0.3)) {
+        return { purpose: 'config', production: false, productionFileCount: 0, confidence: 'high' };
+    }
+    // 4. Production module — subtract non-prod files from count
+    const hint = purposeHintFromDirName(dirName);
+    const prodCount = Math.max(0, totalFileCount - nonProdFiles);
+    const hasContentSignals = contentSnippets.length > 0 && (testHits > 0 || generatedHits > 0 || configHits > 0 || fixtureHits > 0);
+    const hasHint = hint !== 'unknown';
+    const confidence = hasHint ? 'high' :
+        hasContentSignals ? 'medium' :
+            'low';
+    return { purpose: hint, production: true, productionFileCount: prodCount, confidence };
+}
+/**
+ * Extract import specifiers from file content using polyglot regex patterns.
+ * Supports JS/TS, Python, and Go.
+ */
+export function extractImports(content, filePath) {
+    const ext = path.extname(filePath);
+    const imports = [];
+    if (ext === '.ts' || ext === '.tsx' || ext === '.js' || ext === '.jsx' || ext === '.mjs' || ext === '.cjs') {
+        for (const m of content.matchAll(new RegExp(JS_IMPORT_RE.source, 'g'))) {
+            const spec = m[1] ?? m[2];
+            if (spec)
+                imports.push(spec);
+        }
+    }
+    else if (ext === '.py') {
+        for (const m of content.matchAll(new RegExp(PY_IMPORT_RE.source, 'gm'))) {
+            const spec = m[1] ?? m[2];
+            if (spec)
+                imports.push(spec);
+        }
+    }
+    else if (ext === '.go') {
+        for (const m of content.matchAll(new RegExp(GO_IMPORT_RE.source, 'g'))) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.rs') {
+        // Rust: use crate::..., use std::..., use super::...
+        for (const m of content.matchAll(/\buse\s+((?:crate|super|self|std)\b[\w:]+)/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.java' || ext === '.kt' || ext === '.kts' || ext === '.scala') {
+        // Java/Kotlin/Scala: import package.Class
+        for (const m of content.matchAll(/\bimport\s+([\w.]+)/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.rb') {
+        // Ruby: require 'lib' or require_relative 'path'
+        for (const m of content.matchAll(/\brequire(?:_relative)?\s+['"]([^'"]+)['"]/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.cs') {
+        // C#: using Namespace;
+        for (const m of content.matchAll(/\busing\s+([\w.]+)\s*;/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.swift') {
+        // Swift: import Module
+        for (const m of content.matchAll(/\bimport\s+(\w+)/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.ex' || ext === '.exs') {
+        // Elixir: alias/import/use Module
+        for (const m of content.matchAll(/\b(?:alias|import|use)\s+([\w.]+)/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.php') {
+        // PHP: use Namespace\Class;
+        for (const m of content.matchAll(/\buse\s+([\w\\]+)/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.dart') {
+        // Dart: import 'package:...';
+        for (const m of content.matchAll(/\bimport\s+['"]([^'"]+)['"]/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.c' || ext === '.cpp' || ext === '.h' || ext === '.hpp') {
+        // C/C++: #include "local.h" (skip <system.h>)
+        for (const m of content.matchAll(/#include\s+"([^"]+)"/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    else if (ext === '.hs') {
+        // Haskell: import Module.Name
+        // eslint-disable-next-line security/detect-unsafe-regex
+        for (const m of content.matchAll(/\bimport\s+(?:qualified\s+)?([\w.]+)/g)) {
+            if (m[1])
+                imports.push(m[1]);
+        }
+    }
+    return imports;
+}
+/**
+ * Resolve a relative import specifier to a module path relative to projectRoot.
+ * Returns null for non-relative (package) imports.
+ */
+export function resolveImportToModule(specifier, sourceFile, projectRoot, modulePaths) {
+    if (!specifier.startsWith('.'))
+        return null;
+    const sourceDir = path.dirname(sourceFile);
+    const resolved = path.resolve(sourceDir, specifier);
+    const relative = path.relative(projectRoot, resolved);
+    for (const mod of modulePaths) {
+        if (relative === mod || relative.startsWith(mod + '/') || relative.startsWith(mod + path.sep)) {
+            return mod;
+        }
+    }
+    return null;
+}
+/**
+ * Format a codebase index for injection into a scout prompt.
+ *
+ * Chunks modules (15 per chunk) and rotates by cycle number so all modules
+ * get exposure over multiple cycles. Includes untested modules, hotspots,
+ * and entrypoints.
+ */
+export function formatIndexForPrompt(index, scoutCycle) {
+    const { modules, dependency_edges, untested_modules, large_files, entrypoints } = index;
+    if (modules.length === 0) {
+        return '## Codebase Structure\n\nNo modules detected.';
+    }
+    const totalChunks = Math.max(1, Math.ceil(modules.length / CHUNK_SIZE));
+    const chunkIndex = scoutCycle % totalChunks;
+    const offset = chunkIndex * CHUNK_SIZE;
+    const focusModules = modules.slice(offset, offset + CHUNK_SIZE);
+    const otherModules = modules.filter((_, i) => i < offset || i >= offset + CHUNK_SIZE);
+    const parts = [];
+    parts.push(`## Codebase Structure (chunk ${chunkIndex + 1}/${totalChunks})`);
+    parts.push('');
+    parts.push('### Modules in Focus This Cycle');
+    for (const mod of focusModules) {
+        const deps = dependency_edges[mod.path];
+        const depStr = deps ? ` → imports: ${deps.join(', ')}` : '';
+        parts.push(`${mod.path}/ — ${mod.file_count} files (${mod.purpose})${depStr}`);
+    }
+    if (otherModules.length > 0) {
+        parts.push('');
+        parts.push('### Other Modules (not in focus — available for future cycles)');
+        parts.push(otherModules.map(m => m.path + '/').join(', '));
+    }
+    if (untested_modules.length > 0) {
+        parts.push('');
+        parts.push('### Untested Modules (context only — do NOT prioritize writing tests for these)');
+        parts.push(untested_modules.map(m => m + '/').join(', '));
+    }
+    if (large_files.length > 0) {
+        parts.push('');
+        parts.push('### Complexity Hotspots (>300 LOC)');
+        parts.push(large_files.map(f => `${f.path} (${f.lines})`).join(', '));
+    }
+    if (entrypoints.length > 0) {
+        parts.push('');
+        parts.push('### Entrypoints');
+        parts.push(entrypoints.join(', '));
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=shared.js.map

package/dist/codebase-index/shared.js.map

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

package/dist/config/defaults.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Centralized default constants for PromptWheel.
+ *
+ * Both CLI (solo-config.ts) and MCP (run-manager.ts) must agree on these values.
+ * Add new defaults here — not scattered across packages.
+ */
+export declare const SESSION_DEFAULTS: {
+    /** Max advance() calls per session */
+    readonly STEP_BUDGET: 200;
+    /** Max steps per ticket (relaxed in continuous/hours mode) */
+    readonly TICKET_STEP_BUDGET: 12;
+    /** Max line changes per ticket before scope-creep guard triggers */
+    readonly MAX_LINES_PER_TICKET: 500;
+    /** Max tool calls per ticket */
+    readonly MAX_TOOL_CALLS_PER_TICKET: 50;
+    /** Default PRs per session (non-continuous) */
+    readonly MAX_PRS: 5;
+    /** Default scout→execute cycles (non-continuous) */
+    readonly MAX_CYCLES: 1;
+};
+export declare const SCOUT_DEFAULTS: {
+    /** Minimum confidence to accept a proposal (MCP plugin mode) */
+    readonly MIN_CONFIDENCE: 55;
+    /** Maximum proposals per scout cycle */
+    readonly MAX_PROPOSALS_PER_SCOUT: 5;
+    /** Minimum impact score for proposals (matches PROPOSALS_DEFAULTS.DEFAULT_MIN_IMPACT) */
+    readonly MIN_IMPACT_SCORE: 3;
+    /** Retries when scout returns zero proposals */
+    readonly MAX_SCOUT_RETRIES: 3;
+    /** Default scope glob */
+    readonly SCOPE: "**";
+    /** Default trust ladder categories */
+    readonly CATEGORIES: readonly string[];
+    /** Directories excluded from scanning */
+    readonly EXCLUDE_DIRS: readonly string[];
+};
+export declare const EXECUTION_DEFAULTS: {
+    /** Max QA retry attempts before failing a ticket */
+    readonly MAX_QA_RETRIES: 3;
+    /** Default parallel ticket count */
+    readonly PARALLEL: 2;
+    /** Maximum parallel tickets allowed */
+    readonly MAX_PARALLEL: 5;
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,eAAO,MAAM,gBAAgB;IAC3B,sCAAsC;;IAEtC,8DAA8D;;IAE9D,oEAAoE;;IAEpE,gCAAgC;;IAEhC,+CAA+C;;IAE/C,oDAAoD;;CAE5C,CAAC;AAMX,eAAO,MAAM,cAAc;IACzB,gEAAgE;;IAEhE,wCAAwC;;IAExC,yFAAyF;;IAEzF,gDAAgD;;IAEhD,yBAAyB;;IAEzB,sCAAsC;yBAC6C,SAAS,MAAM,EAAE;IACpG,yCAAyC;2BA0BpC,SAAS,MAAM,EAAE;CACd,CAAC;AAMX,eAAO,MAAM,kBAAkB;IAC7B,oDAAoD;;IAEpD,oCAAoC;;IAEpC,uCAAuC;;CAE/B,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,79 @@
+/**
+ * Centralized default constants for PromptWheel.
+ *
+ * Both CLI (solo-config.ts) and MCP (run-manager.ts) must agree on these values.
+ * Add new defaults here — not scattered across packages.
+ */
+// ---------------------------------------------------------------------------
+// Session budgets
+// ---------------------------------------------------------------------------
+export const SESSION_DEFAULTS = {
+    /** Max advance() calls per session */
+    STEP_BUDGET: 200,
+    /** Max steps per ticket (relaxed in continuous/hours mode) */
+    TICKET_STEP_BUDGET: 12,
+    /** Max line changes per ticket before scope-creep guard triggers */
+    MAX_LINES_PER_TICKET: 500,
+    /** Max tool calls per ticket */
+    MAX_TOOL_CALLS_PER_TICKET: 50,
+    /** Default PRs per session (non-continuous) */
+    MAX_PRS: 5,
+    /** Default scout→execute cycles (non-continuous) */
+    MAX_CYCLES: 1,
+};
+// ---------------------------------------------------------------------------
+// Scout defaults
+// ---------------------------------------------------------------------------
+export const SCOUT_DEFAULTS = {
+    /** Minimum confidence to accept a proposal (MCP plugin mode) */
+    MIN_CONFIDENCE: 55,
+    /** Maximum proposals per scout cycle */
+    MAX_PROPOSALS_PER_SCOUT: 5,
+    /** Minimum impact score for proposals (matches PROPOSALS_DEFAULTS.DEFAULT_MIN_IMPACT) */
+    MIN_IMPACT_SCORE: 3,
+    /** Retries when scout returns zero proposals */
+    MAX_SCOUT_RETRIES: 3,
+    /** Default scope glob */
+    SCOPE: '**',
+    /** Default trust ladder categories */
+    CATEGORIES: ['refactor', 'docs', 'perf', 'security', 'fix', 'cleanup', 'types'],
+    /** Directories excluded from scanning */
+    EXCLUDE_DIRS: [
+        // JS/TS
+        'node_modules', 'dist', 'build', '.next', 'coverage',
+        // Python
+        '__pycache__', '.venv', 'venv', '.tox', '*.egg-info',
+        // Rust
+        'target',
+        // Java/Kotlin
+        '.gradle', '.mvn',
+        // Elixir
+        '_build', 'deps',
+        // Ruby
+        '.bundle',
+        // C#
+        'bin', 'obj',
+        // Swift
+        '.build', '.swiftpm',
+        // Dart
+        '.dart_tool',
+        // Haskell
+        '.stack-work', 'dist-newstyle', '.cabal-sandbox',
+        // Zig
+        'zig-cache', 'zig-out',
+        // General
+        'assets', 'public/static', 'vendor', '.git',
+    ],
+};
+// ---------------------------------------------------------------------------
+// Execution defaults
+// ---------------------------------------------------------------------------
+export const EXECUTION_DEFAULTS = {
+    /** Max QA retry attempts before failing a ticket */
+    MAX_QA_RETRIES: 3,
+    /** Default parallel ticket count */
+    PARALLEL: 2,
+    /** Maximum parallel tickets allowed */
+    MAX_PARALLEL: 5,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,sCAAsC;IACtC,WAAW,EAAE,GAAG;IAChB,8DAA8D;IAC9D,kBAAkB,EAAE,EAAE;IACtB,oEAAoE;IACpE,oBAAoB,EAAE,GAAG;IACzB,gCAAgC;IAChC,yBAAyB,EAAE,EAAE;IAC7B,+CAA+C;IAC/C,OAAO,EAAE,CAAC;IACV,oDAAoD;IACpD,UAAU,EAAE,CAAC;CACL,CAAC;AAEX,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,gEAAgE;IAChE,cAAc,EAAE,EAAE;IAClB,wCAAwC;IACxC,uBAAuB,EAAE,CAAC;IAC1B,yFAAyF;IACzF,gBAAgB,EAAE,CAAC;IACnB,gDAAgD;IAChD,iBAAiB,EAAE,CAAC;IACpB,yBAAyB;IACzB,KAAK,EAAE,IAAI;IACX,sCAAsC;IACtC,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAsB;IACpG,yCAAyC;IACzC,YAAY,EAAE;QACZ,QAAQ;QACR,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU;QACpD,SAAS;QACT,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY;QACpD,OAAO;QACP,QAAQ;QACR,cAAc;QACd,SAAS,EAAE,MAAM;QACjB,SAAS;QACT,QAAQ,EAAE,MAAM;QAChB,OAAO;QACP,SAAS;QACT,KAAK;QACL,KAAK,EAAE,KAAK;QACZ,QAAQ;QACR,QAAQ,EAAE,UAAU;QACpB,OAAO;QACP,YAAY;QACZ,UAAU;QACV,aAAa,EAAE,eAAe,EAAE,gBAAgB;QAChD,MAAM;QACN,WAAW,EAAE,SAAS;QACtB,UAAU;QACV,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM;KACvB;CACd,CAAC;AAEX,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oDAAoD;IACpD,cAAc,EAAE,CAAC;IACjB,oCAAoC;IACpC,QAAQ,EAAE,CAAC;IACX,uCAAuC;IACvC,YAAY,EAAE,CAAC;CACP,CAAC"}

package/dist/critic/shared.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Critic Scoring — pure algorithms for retry guidance.
+ *
+ * When QA fails or a plan is rejected, these functions analyze structured
+ * learnings to build targeted guidance for the retry prompt.
+ *
+ * No I/O — callers provide learnings and failure context.
+ */
+import type { Learning } from '../learnings/shared.js';
+export interface FailureContext {
+    failed_commands: string[];
+    error_output: string;
+    attempt: number;
+    max_attempts: number;
+}
+export interface RetryRiskScore {
+    score: number;
+    level: 'low' | 'medium' | 'high';
+    signals: string[];
+}
+export interface CriticStrategy {
+    label: string;
+    instruction: string;
+    confidence: number;
+}
+/**
+ * Compute retry risk based on learnings overlap with the failing ticket.
+ */
+export declare function computeRetryRisk(ticketPaths: string[], ticketCommands: string[], learnings: Learning[], failureContext: FailureContext): RetryRiskScore;
+/**
+ * Generate ranked strategies for a retry based on learnings.
+ * Returns top 3 by confidence.
+ */
+export declare function scoreStrategies(ticketPaths: string[], failureContext: FailureContext, learnings: Learning[]): CriticStrategy[];
+/**
+ * Build a critic review block for QA retry prompts.
+ * Returns empty string if risk is low and no high-confidence strategies exist.
+ */
+export declare function buildCriticBlock(failureContext: FailureContext, risk: RetryRiskScore, strategies: CriticStrategy[], _learnings: Learning[]): string;
+/**
+ * Build a critic block for plan rejection retries.
+ * Returns empty string if no actionable guidance exists.
+ */
+export declare function buildPlanRejectionCriticBlock(context: {
+    rejection_reason: string;
+    attempt: number;
+    max_attempts: number;
+}, learnings: Learning[], ticketPaths: string[]): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/critic/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/critic/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAMvD,MAAM,WAAW,cAAc;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EAAE,EACrB,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,EAAE,QAAQ,EAAE,EACrB,cAAc,EAAE,cAAc,GAC7B,cAAc,CA8ChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EAAE,EACrB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,QAAQ,EAAE,GACpB,cAAc,EAAE,CA+DlB;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,cAAc,EAC9B,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,cAAc,EAAE,EAC5B,UAAU,EAAE,QAAQ,EAAE,GACrB,MAAM,CAqCR;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EAC5E,SAAS,EAAE,QAAQ,EAAE,EACrB,WAAW,EAAE,MAAM,EAAE,GACpB,MAAM,CA0CR"}