olympus-ai 4.4.22 → 4.5.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "olympus-ai",
-  "version": "4.4.22",
+  "version": "4.5.1",
   "description": "Olympus: Multi-agent orchestration for Claude Code. Summon the gods of code.",
   "author": {
     "name": "mikev10",

package/dist/features/workflow-engine/bolts/bolt-executor.d.ts

@@ -0,0 +1,29 @@
+import type { BoltSpec, BoltStatus, BoltExecutionStage, BoltStageProgress, WorkflowCheckpointV3 } from '../phase-types.js';
+export interface StageResult {
+    success: boolean;
+    artifact_path?: string;
+    error?: string;
+}
+export interface StageHandlers {
+    onElaboration: (bolt: BoltSpec, projectPath: string) => Promise<StageResult>;
+    onCodeGeneration: (bolt: BoltSpec, projectPath: string) => Promise<StageResult>;
+    onBuildAndTest: (bolt: BoltSpec, projectPath: string, targetFiles: string[]) => Promise<StageResult>;
+    onReview: (bolt: BoltSpec, projectPath: string) => Promise<StageResult>;
+}
+export interface BoltExecutionResult {
+    status: BoltStatus;
+    stages: Record<BoltExecutionStage, BoltStageProgress>;
+}
+/**
+ * Executes the 4-stage pipeline for a single bolt.
+ *
+ * The caller must ensure `checkpoint.construction_bolts[boltSpec.id]` exists
+ * before calling this function (via `registerBoltsInCheckpoint`).
+ *
+ * @returns The final execution result with bolt status and per-stage progress.
+ */
+export declare function execute(boltSpec: BoltSpec, checkpoint: WorkflowCheckpointV3, projectPath: string, workflowId: string, handlers: StageHandlers): Promise<BoltExecutionResult>;
+export declare const BoltExecutor: {
+    execute: typeof execute;
+};
+//# sourceMappingURL=bolt-executor.d.ts.map

package/dist/features/workflow-engine/bolts/bolt-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt-executor.d.ts","sourceRoot":"","sources":["../../../../src/features/workflow-engine/bolts/bolt-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7E,gBAAgB,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAChF,cAAc,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IACrG,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAC;CACvD;AAsCD;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAC3B,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,mBAAmB,CAAC,CAwE9B;AAED,eAAO,MAAM,YAAY;;CAAc,CAAC"}

package/dist/features/workflow-engine/bolts/bolt-executor.js

@@ -0,0 +1,96 @@
+import { saveCheckpoint } from '../checkpoint.js';
+const STAGE_ORDER = [
+    'elaboration',
+    'code_generation',
+    'build_and_test',
+    'review',
+];
+const HANDLER_MAP = {
+    elaboration: 'onElaboration',
+    code_generation: 'onCodeGeneration',
+    build_and_test: 'onBuildAndTest',
+    review: 'onReview',
+};
+// Bolt-level status transitions triggered after specific stages complete (BR-003)
+const STATUS_AFTER_STAGE = {
+    build_and_test: 'built',
+    review: 'done',
+};
+async function callHandler(handlers, stage, bolt, projectPath) {
+    const handlerKey = HANDLER_MAP[stage];
+    if (stage === 'build_and_test') {
+        return handlers.onBuildAndTest(bolt, projectPath, bolt.target_files ?? []);
+    }
+    return handlers[handlerKey](bolt, projectPath);
+}
+/**
+ * Executes the 4-stage pipeline for a single bolt.
+ *
+ * The caller must ensure `checkpoint.construction_bolts[boltSpec.id]` exists
+ * before calling this function (via `registerBoltsInCheckpoint`).
+ *
+ * @returns The final execution result with bolt status and per-stage progress.
+ */
+export async function execute(boltSpec, checkpoint, projectPath, workflowId, handlers) {
+    const boltProgress = checkpoint.construction_bolts[boltSpec.id];
+    checkpoint.active_bolt_id = boltSpec.id;
+    boltProgress.status = 'in_progress';
+    await saveCheckpoint(projectPath, checkpoint);
+    for (const stage of STAGE_ORDER) {
+        const stageProgress = boltProgress.stages[stage];
+        // Express mode: skip elaboration (BR-002, BR-009)
+        if (boltSpec.express_mode && stage === 'elaboration') {
+            stageProgress.status = 'skipped';
+            stageProgress.completed_at = new Date().toISOString();
+            await saveCheckpoint(projectPath, checkpoint);
+            continue;
+        }
+        // Transition to in_review at review start (BR-003)
+        if (stage === 'review') {
+            boltProgress.status = 'in_review';
+            await saveCheckpoint(projectPath, checkpoint);
+        }
+        checkpoint.active_bolt_stage = stage;
+        stageProgress.status = 'in_progress';
+        stageProgress.started_at = new Date().toISOString();
+        await saveCheckpoint(projectPath, checkpoint);
+        const result = await callHandler(handlers, stage, boltSpec, projectPath);
+        if (result.success) {
+            stageProgress.status = 'completed';
+            stageProgress.completed_at = new Date().toISOString();
+            if (result.artifact_path) {
+                stageProgress.artifact_path = result.artifact_path;
+            }
+            const nextStatus = STATUS_AFTER_STAGE[stage];
+            if (nextStatus) {
+                boltProgress.status = nextStatus;
+            }
+            await saveCheckpoint(projectPath, checkpoint);
+        }
+        else {
+            stageProgress.failure_count += 1;
+            stageProgress.last_error = result.error ?? 'Unknown error';
+            boltProgress.failure_count += 1;
+            boltProgress.last_error = stageProgress.last_error;
+            if (stageProgress.failure_count >= 2) {
+                stageProgress.status = 'failed';
+                boltProgress.status = 'failed';
+                await saveCheckpoint(projectPath, checkpoint);
+                break;
+            }
+            // First failure: revert to not_started so caller can retry
+            stageProgress.status = 'not_started';
+            await saveCheckpoint(projectPath, checkpoint);
+            break;
+        }
+    }
+    checkpoint.active_bolt_id = null;
+    checkpoint.active_bolt_stage = null;
+    await saveCheckpoint(projectPath, checkpoint);
+    return {
+        status: boltProgress.status,
+        stages: { ...boltProgress.stages },
+    };
+}
+export const BoltExecutor = { execute };
+//# sourceMappingURL=bolt-executor.js.map

package/dist/features/workflow-engine/bolts/bolt-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt-executor.js","sourceRoot":"","sources":["../../../../src/features/workflow-engine/bolts/bolt-executor.ts"],"names":[],"mappings":"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"}

package/dist/features/workflow-engine/bolts/bolt-planner.d.ts

@@ -0,0 +1,35 @@
+import type { BoltSpec, WorkflowCheckpointV3, HierarchicalNode } from '../phase-types.js';
+export interface CoverageResult {
+    coverage_percent: number;
+    uncovered_criteria: string[];
+    passed: boolean;
+    requiresAcknowledgment: boolean;
+}
+export type BoltPlannerErrorCode = 'AGENT_PARSE_FAILURE' | 'COVERAGE_HARD_BLOCK' | 'ARTIFACT_WRITE_FAILURE' | 'CHECKPOINT_UPDATE_FAILURE';
+export declare class BoltPlannerError extends Error {
+    readonly code: BoltPlannerErrorCode;
+    constructor(code: BoltPlannerErrorCode, message: string);
+}
+export declare function validateBoltCoverage(unitCriteria: string[], bolts: BoltSpec[]): CoverageResult;
+export declare function writeBoltArtifacts(bolts: BoltSpec[], projectPath: string, workflowId: string): Promise<void>;
+export declare function registerBoltsInCheckpoint(bolts: BoltSpec[], checkpoint: WorkflowCheckpointV3): void;
+export declare function buildDecompositionPrompt(unit: HierarchicalNode, intent: string, depth: number): string;
+export declare function parseAgentResponse(response: string, unit: HierarchicalNode, startIndex: number, depth: number): BoltSpec[];
+export declare function planBoltsForUnit(unit: HierarchicalNode, intent: string, depth: number, checkpoint: WorkflowCheckpointV3, projectPath: string, workflowId: string): Promise<{
+    bolts: BoltSpec[];
+    coverage: CoverageResult;
+}>;
+export declare function finalizeBoltPlan(bolts: BoltSpec[], unit: HierarchicalNode, checkpoint: WorkflowCheckpointV3, projectPath: string, workflowId: string): Promise<{
+    bolts: BoltSpec[];
+    coverage: CoverageResult;
+}>;
+export declare const BoltPlanner: {
+    buildDecompositionPrompt: typeof buildDecompositionPrompt;
+    parseAgentResponse: typeof parseAgentResponse;
+    validateBoltCoverage: typeof validateBoltCoverage;
+    writeBoltArtifacts: typeof writeBoltArtifacts;
+    registerBoltsInCheckpoint: typeof registerBoltsInCheckpoint;
+    planBoltsForUnit: typeof planBoltsForUnit;
+    finalizeBoltPlan: typeof finalizeBoltPlan;
+};
+//# sourceMappingURL=bolt-planner.d.ts.map

package/dist/features/workflow-engine/bolts/bolt-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt-planner.d.ts","sourceRoot":"","sources":["../../../../src/features/workflow-engine/bolts/bolt-planner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,QAAQ,EAGR,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,sBAAsB,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,oBAAoB,GAC5B,qBAAqB,GACrB,qBAAqB,GACrB,wBAAwB,GACxB,2BAA2B,CAAC;AAEhC,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;gBAExB,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAKxD;AAED,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EAAE,EACtB,KAAK,EAAE,QAAQ,EAAE,GAChB,cAAc,CAwDhB;AAED,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,QAAQ,EAAE,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAwGf;AAaD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,oBAAoB,GAC/B,IAAI,CAwBN;AAID,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,MAAM,CAwCR;AAWD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,QAAQ,EAAE,CA4DZ;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAAC,CAY1D;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,QAAQ,EAAE,EACjB,IAAI,EAAE,gBAAgB,EACtB,UAAU,EAAE,oBAAoB,EAChC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAAC,CAmB1D;AAED,eAAO,MAAM,WAAW;;;;;;;;CAQvB,CAAC"}

package/dist/features/workflow-engine/bolts/bolt-planner.js

@@ -0,0 +1,284 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { BoltSpecValidator } from './bolt-spec-validator.js';
+import { slugifyBoltName } from '../construction/decomposition.js';
+export class BoltPlannerError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = 'BoltPlannerError';
+        this.code = code;
+    }
+}
+export function validateBoltCoverage(unitCriteria, bolts) {
+    if (unitCriteria.length === 0) {
+        return {
+            coverage_percent: 100,
+            uncovered_criteria: [],
+            passed: true,
+            requiresAcknowledgment: false,
+        };
+    }
+    const boltCriteriaPool = [];
+    for (const bolt of bolts) {
+        for (const criterion of bolt.acceptance_criteria) {
+            boltCriteriaPool.push(criterion.toLowerCase());
+        }
+    }
+    const uncovered = [];
+    let coveredCount = 0;
+    for (const unitCriterion of unitCriteria) {
+        const lowerCriterion = unitCriterion.toLowerCase();
+        const isCovered = boltCriteriaPool.some((bc) => bc.includes(lowerCriterion));
+        if (isCovered) {
+            coveredCount++;
+        }
+        else {
+            uncovered.push(unitCriterion);
+        }
+    }
+    const coverage_percent = Math.round((coveredCount / unitCriteria.length) * 100);
+    if (coverage_percent >= 95) {
+        return {
+            coverage_percent,
+            uncovered_criteria: uncovered,
+            passed: true,
+            requiresAcknowledgment: false,
+        };
+    }
+    if (coverage_percent >= 80) {
+        return {
+            coverage_percent,
+            uncovered_criteria: uncovered,
+            passed: true,
+            requiresAcknowledgment: true,
+        };
+    }
+    return {
+        coverage_percent,
+        uncovered_criteria: uncovered,
+        passed: false,
+        requiresAcknowledgment: false,
+    };
+}
+export async function writeBoltArtifacts(bolts, projectPath, workflowId) {
+    try {
+        for (const bolt of bolts) {
+            const boltDir = path.join(projectPath, 'aidlc-docs', workflowId, 'construction', 'bolts', bolt.id);
+            await fs.ensureDir(boltDir);
+            const frontmatter = [
+                '---',
+                `id: ${bolt.id}`,
+                `title: "${bolt.title}"`,
+                `parent_unit_id: ${bolt.parent_unit_id}`,
+                `sequence: ${bolt.sequence}`,
+                `depth_target: ${bolt.depth_target}`,
+                `express_mode: ${bolt.express_mode}`,
+                `estimated_effort_hours: ${bolt.estimated_effort_hours}`,
+                '---',
+            ].join('\n');
+            const acList = bolt.acceptance_criteria.map((c) => `- ${c}`).join('\n');
+            const filesList = bolt.target_files.length > 0
+                ? bolt.target_files.map((f) => `- ${f}`).join('\n')
+                : 'None';
+            const depsList = bolt.dependencies.length > 0
+                ? bolt.dependencies.map((d) => `- ${d}`).join('\n')
+                : 'None';
+            const specContent = [
+                frontmatter,
+                '',
+                `# ${bolt.title}`,
+                '',
+                '## Scope',
+                '',
+                bolt.scope,
+                '',
+                '## Acceptance Criteria',
+                '',
+                acList,
+                '',
+                '## Target Files',
+                '',
+                filesList,
+                '',
+                '## Dependencies',
+                '',
+                depsList,
+                '',
+            ].join('\n');
+            await fs.writeFile(path.join(boltDir, 'spec.md'), specContent, 'utf-8');
+        }
+        if (bolts.length > 0) {
+            const parentUnitId = bolts[0].parent_unit_id;
+            const planDir = path.join(projectPath, 'aidlc-docs', workflowId, 'construction', 'plans');
+            await fs.ensureDir(planDir);
+            const summaryLines = [
+                `# Bolt Plan: ${parentUnitId}`,
+                '',
+                `Generated: ${new Date().toISOString()}`,
+                '',
+                '## Bolts',
+                '',
+            ];
+            for (const bolt of bolts) {
+                summaryLines.push(`### ${bolt.id}: ${bolt.title}`, '', `- **Sequence**: ${bolt.sequence}`, `- **Depth**: ${bolt.depth_target}`, `- **Express**: ${bolt.express_mode}`, `- **Effort**: ${bolt.estimated_effort_hours}h`, '');
+            }
+            await fs.writeFile(path.join(planDir, `${parentUnitId}-bolt-plan.md`), summaryLines.join('\n'), 'utf-8');
+        }
+    }
+    catch (error) {
+        throw new BoltPlannerError('ARTIFACT_WRITE_FAILURE', `Failed to write bolt artifacts: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function createInitialStageProgress() {
+    return {
+        status: 'not_started',
+        started_at: null,
+        completed_at: null,
+        failure_count: 0,
+        last_error: null,
+        artifact_path: null,
+    };
+}
+export function registerBoltsInCheckpoint(bolts, checkpoint) {
+    if (!checkpoint.construction_bolts) {
+        checkpoint.construction_bolts = {};
+    }
+    for (const bolt of bolts) {
+        const progress = {
+            bolt_id: bolt.id,
+            parent_unit_id: bolt.parent_unit_id,
+            status: 'planned',
+            stages: {
+                elaboration: createInitialStageProgress(),
+                code_generation: createInitialStageProgress(),
+                build_and_test: createInitialStageProgress(),
+                review: createInitialStageProgress(),
+            },
+            failure_count: 0,
+            last_error: null,
+            review_score: null,
+            acknowledged_by: null,
+            acknowledged_at: null,
+        };
+        checkpoint.construction_bolts[bolt.id] = progress;
+    }
+}
+const MAX_BOLTS_PER_UNIT = 8;
+export function buildDecompositionPrompt(unit, intent, depth) {
+    const intentSummary = intent.length > 500 ? intent.substring(0, 500) + '...' : intent;
+    const acSection = 'acceptance_criteria' in unit && Array.isArray(unit.acceptance_criteria)
+        ? unit.acceptance_criteria.map((c) => `- ${c}`).join('\n')
+        : '(none provided)';
+    return [
+        'You are decomposing a construction unit into sequential bolts (small executable work items).',
+        '',
+        `## Unit: ${unit.id}`,
+        `**Title**: ${unit.title}`,
+        `**Estimated effort**: ${unit.estimated_effort} hours`,
+        '',
+        '### Acceptance Criteria',
+        acSection,
+        '',
+        '### Intent Summary',
+        intentSummary,
+        '',
+        `### Depth Level: ${depth} (1-11 scale)`,
+        '',
+        '### Decomposition Rules',
+        `- Maximum ${MAX_BOLTS_PER_UNIT} bolts per unit`,
+        '- Each bolt must cover at least one acceptance criterion',
+        '- Bolts are executed sequentially',
+        '- Each bolt must specify target_files',
+        '- Achieve >= 95% acceptance criteria coverage across all bolts',
+        '',
+        '### Required Output Format',
+        'Return a JSON array of bolt objects. Each object must have:',
+        '- `title` (string): Short descriptive name',
+        '- `scope` (string): What this bolt accomplishes',
+        '- `acceptance_criteria` (string[]): Verifiable outcomes (min 1)',
+        '- `target_files` (string[]): Relative file paths to modify/create',
+        '- `dependencies` (string[]): IDs of preceding bolts (or empty array)',
+        '- `estimated_effort_hours` (number): Estimated duration in hours',
+        '',
+        'Return ONLY the JSON array, no other text.',
+    ].join('\n');
+}
+export function parseAgentResponse(response, unit, startIndex, depth) {
+    let rawBolts;
+    try {
+        const jsonMatch = response.match(/\[[\s\S]*\]/);
+        if (!jsonMatch) {
+            throw new Error('No JSON array found in response');
+        }
+        rawBolts = JSON.parse(jsonMatch[0]);
+    }
+    catch (error) {
+        throw new BoltPlannerError('AGENT_PARSE_FAILURE', `Failed to parse agent response as JSON array: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!Array.isArray(rawBolts)) {
+        throw new BoltPlannerError('AGENT_PARSE_FAILURE', 'Agent response parsed but is not an array');
+    }
+    const expressMode = depth <= 4;
+    const bolts = rawBolts.map((raw, i) => {
+        const globalIndex = startIndex + i;
+        const id = slugifyBoltName(raw.title || '', globalIndex);
+        return {
+            id,
+            type: 'bolt',
+            title: raw.title || 'Untitled Bolt',
+            parent_id: unit.id,
+            children_ids: [],
+            status: 'pending',
+            assigned_agent: null,
+            estimated_effort: raw.estimated_effort_hours || 0,
+            parent_unit_id: unit.id,
+            sequence: i + 1,
+            scope: raw.scope || '',
+            acceptance_criteria: raw.acceptance_criteria || [],
+            target_files: raw.target_files || [],
+            dependencies: raw.dependencies || [],
+            depth_target: depth,
+            express_mode: expressMode,
+            estimated_effort_hours: raw.estimated_effort_hours || 0,
+        };
+    });
+    const existingBoltsTotal = startIndex - 1;
+    for (let i = 0; i < bolts.length; i++) {
+        const context = {
+            existing_bolts_in_unit: i,
+            existing_bolts_total: existingBoltsTotal + i,
+        };
+        BoltSpecValidator.validate(bolts[i], context);
+    }
+    return bolts;
+}
+export async function planBoltsForUnit(unit, intent, depth, checkpoint, projectPath, workflowId) {
+    const startIndex = Object.keys(checkpoint.construction_bolts ?? {}).length + 1;
+    const prompt = buildDecompositionPrompt(unit, intent, depth);
+    void prompt;
+    void startIndex;
+    throw new BoltPlannerError('AGENT_PARSE_FAILURE', 'planBoltsForUnit is a coordination entry point. Use buildDecompositionPrompt + parseAgentResponse + writeBoltArtifacts + registerBoltsInCheckpoint individually.');
+}
+export async function finalizeBoltPlan(bolts, unit, checkpoint, projectPath, workflowId) {
+    const unitCriteria = 'acceptance_criteria' in unit && Array.isArray(unit.acceptance_criteria)
+        ? unit.acceptance_criteria
+        : [];
+    const coverage = validateBoltCoverage(unitCriteria, bolts);
+    if (!coverage.passed) {
+        throw new BoltPlannerError('COVERAGE_HARD_BLOCK', `Bolt coverage is ${coverage.coverage_percent}% (below 80% threshold). Uncovered: ${coverage.uncovered_criteria.join(', ')}`);
+    }
+    await writeBoltArtifacts(bolts, projectPath, workflowId);
+    registerBoltsInCheckpoint(bolts, checkpoint);
+    return { bolts, coverage };
+}
+export const BoltPlanner = {
+    buildDecompositionPrompt,
+    parseAgentResponse,
+    validateBoltCoverage,
+    writeBoltArtifacts,
+    registerBoltsInCheckpoint,
+    planBoltsForUnit,
+    finalizeBoltPlan,
+};
+//# sourceMappingURL=bolt-planner.js.map

package/dist/features/workflow-engine/bolts/bolt-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt-planner.js","sourceRoot":"","sources":["../../../../src/features/workflow-engine/bolts/bolt-planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAQxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAenE,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAEpC,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAClC,YAAsB,EACtB,KAAiB;IAEjB,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,gBAAgB,EAAE,GAAG;YACrB,kBAAkB,EAAE,EAAE;YACtB,MAAM,EAAE,IAAI;YACZ,sBAAsB,EAAE,KAAK;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACjD,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,MAAM,aAAa,IAAI,YAAY,EAAE,CAAC;QACzC,MAAM,cAAc,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;QAC7E,IAAI,SAAS,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IAEhF,IAAI,gBAAgB,IAAI,EAAE,EAAE,CAAC;QAC3B,OAAO;YACL,gBAAgB;YAChB,kBAAkB,EAAE,SAAS;YAC7B,MAAM,EAAE,IAAI;YACZ,sBAAsB,EAAE,KAAK;SAC9B,CAAC;IACJ,CAAC;IAED,IAAI,gBAAgB,IAAI,EAAE,EAAE,CAAC;QAC3B,OAAO;YACL,gBAAgB;YAChB,kBAAkB,EAAE,SAAS;YAC7B,MAAM,EAAE,IAAI;YACZ,sBAAsB,EAAE,IAAI;SAC7B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,gBAAgB;QAChB,kBAAkB,EAAE,SAAS;QAC7B,MAAM,EAAE,KAAK;QACb,sBAAsB,EAAE,KAAK;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAiB,EACjB,WAAmB,EACnB,UAAkB;IAElB,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,OAAO,EACP,IAAI,CAAC,EAAE,CACR,CAAC;YACF,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAE5B,MAAM,WAAW,GAAG;gBAClB,KAAK;gBACL,OAAO,IAAI,CAAC,EAAE,EAAE;gBAChB,WAAW,IAAI,CAAC,KAAK,GAAG;gBACxB,mBAAmB,IAAI,CAAC,cAAc,EAAE;gBACxC,aAAa,IAAI,CAAC,QAAQ,EAAE;gBAC5B,iBAAiB,IAAI,CAAC,YAAY,EAAE;gBACpC,iBAAiB,IAAI,CAAC,YAAY,EAAE;gBACpC,2BAA2B,IAAI,CAAC,sBAAsB,EAAE;gBACxD,KAAK;aACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,MAAM,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxE,MAAM,SAAS,GACb,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBAC1B,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACnD,CAAC,CAAC,MAAM,CAAC;YACb,MAAM,QAAQ,GACZ,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;gBAC1B,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACnD,CAAC,CAAC,MAAM,CAAC;YAEb,MAAM,WAAW,GAAG;gBAClB,WAAW;gBACX,EAAE;gBACF,KAAK,IAAI,CAAC,KAAK,EAAE;gBACjB,EAAE;gBACF,UAAU;gBACV,EAAE;gBACF,IAAI,CAAC,KAAK;gBACV,EAAE;gBACF,wBAAwB;gBACxB,EAAE;gBACF,MAAM;gBACN,EAAE;gBACF,iBAAiB;gBACjB,EAAE;gBACF,SAAS;gBACT,EAAE;gBACF,iBAAiB;gBACjB,EAAE;gBACF,QAAQ;gBACR,EAAE;aACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEb,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACvB,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,OAAO,CACR,CAAC;YACF,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAE5B,MAAM,YAAY,GAAG;gBACnB,gBAAgB,YAAY,EAAE;gBAC9B,EAAE;gBACF,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;gBACxC,EAAE;gBACF,UAAU;gBACV,EAAE;aACH,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,YAAY,CAAC,IAAI,CACf,OAAO,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,KAAK,EAAE,EAC/B,EAAE,EACF,mBAAmB,IAAI,CAAC,QAAQ,EAAE,EAClC,gBAAgB,IAAI,CAAC,YAAY,EAAE,EACnC,kBAAkB,IAAI,CAAC,YAAY,EAAE,EACrC,iBAAiB,IAAI,CAAC,sBAAsB,GAAG,EAC/C,EAAE,CACH,CAAC;YACJ,CAAC;YAED,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,YAAY,eAAe,CAAC,EAClD,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EACvB,OAAO,CACR,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CACxB,wBAAwB,EACxB,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO;QACL,MAAM,EAAE,aAAa;QACrB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;QAClB,aAAa,EAAE,CAAC;QAChB,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,IAAI;KACpB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,KAAiB,EACjB,UAAgC;IAEhC,IAAI,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAC;QACnC,UAAU,CAAC,kBAAkB,GAAG,EAAE,CAAC;IACrC,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAA6B;YACzC,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE;gBACN,WAAW,EAAE,0BAA0B,EAAE;gBACzC,eAAe,EAAE,0BAA0B,EAAE;gBAC7C,cAAc,EAAE,0BAA0B,EAAE;gBAC5C,MAAM,EAAE,0BAA0B,EAAE;aACrC;YACD,aAAa,EAAE,CAAC;YAChB,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,IAAI;YACrB,eAAe,EAAE,IAAI;SACtB,CAAC;QACF,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC;IACpD,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,UAAU,wBAAwB,CACtC,IAAsB,EACtB,MAAc,EACd,KAAa;IAEb,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACtF,MAAM,SAAS,GACb,qBAAqB,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAAY,CAAC,mBAAmB,CAAC;QAC/E,CAAC,CAAE,IAAY,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3E,CAAC,CAAC,iBAAiB,CAAC;IAExB,OAAO;QACL,8FAA8F;QAC9F,EAAE;QACF,YAAY,IAAI,CAAC,EAAE,EAAE;QACrB,cAAc,IAAI,CAAC,KAAK,EAAE;QAC1B,yBAAyB,IAAI,CAAC,gBAAgB,QAAQ;QACtD,EAAE;QACF,yBAAyB;QACzB,SAAS;QACT,EAAE;QACF,oBAAoB;QACpB,aAAa;QACb,EAAE;QACF,oBAAoB,KAAK,eAAe;QACxC,EAAE;QACF,yBAAyB;QACzB,aAAa,kBAAkB,iBAAiB;QAChD,0DAA0D;QAC1D,mCAAmC;QACnC,uCAAuC;QACvC,gEAAgE;QAChE,EAAE;QACF,4BAA4B;QAC5B,6DAA6D;QAC7D,4CAA4C;QAC5C,iDAAiD;QACjD,iEAAiE;QACjE,mEAAmE;QACnE,sEAAsE;QACtE,kEAAkE;QAClE,EAAE;QACF,4CAA4C;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAWD,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,IAAsB,EACtB,UAAkB,EAClB,KAAa;IAEb,IAAI,QAA4B,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CACxB,qBAAqB,EACrB,iDAAiD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAC1G,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,gBAAgB,CACxB,qBAAqB,EACrB,2CAA2C,CAC5C,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,IAAI,CAAC,CAAC;IAE/B,MAAM,KAAK,GAAe,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAChD,MAAM,WAAW,GAAG,UAAU,GAAG,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC;QAEzD,OAAO;YACL,EAAE;YACF,IAAI,EAAE,MAAe;YACrB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,eAAe;YACnC,SAAS,EAAE,IAAI,CAAC,EAAE;YAClB,YAAY,EAAE,EAAE;YAChB,MAAM,EAAE,SAAkB;YAC1B,cAAc,EAAE,IAAI;YACpB,gBAAgB,EAAE,GAAG,CAAC,sBAAsB,IAAI,CAAC;YACjD,cAAc,EAAE,IAAI,CAAC,EAAE;YACvB,QAAQ,EAAE,CAAC,GAAG,CAAC;YACf,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;YACtB,mBAAmB,EAAE,GAAG,CAAC,mBAAmB,IAAI,EAAE;YAClD,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE;YACpC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE;YACpC,YAAY,EAAE,KAAK;YACnB,YAAY,EAAE,WAAW;YACzB,sBAAsB,EAAE,GAAG,CAAC,sBAAsB,IAAI,CAAC;SACxD,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,UAAU,GAAG,CAAC,CAAC;IAC1C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,OAAO,GAAsB;YACjC,sBAAsB,EAAE,CAAC;YACzB,oBAAoB,EAAE,kBAAkB,GAAG,CAAC;SAC7C,CAAC;QACF,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAsB,EACtB,MAAc,EACd,KAAa,EACb,UAAgC,EAChC,WAAmB,EACnB,UAAkB;IAElB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAE7D,KAAK,MAAM,CAAC;IACZ,KAAK,UAAU,CAAC;IAEhB,MAAM,IAAI,gBAAgB,CACxB,qBAAqB,EACrB,kKAAkK,CACnK,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAiB,EACjB,IAAsB,EACtB,UAAgC,EAChC,WAAmB,EACnB,UAAkB;IAElB,MAAM,YAAY,GAChB,qBAAqB,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAAY,CAAC,mBAAmB,CAAC;QAC/E,CAAC,CAAE,IAAY,CAAC,mBAAmB;QACnC,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,QAAQ,GAAG,oBAAoB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IAE3D,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,gBAAgB,CACxB,qBAAqB,EACrB,oBAAoB,QAAQ,CAAC,gBAAgB,uCAAuC,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7H,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACzD,yBAAyB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAE7C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,wBAAwB;IACxB,kBAAkB;IAClB,oBAAoB;IACpB,kBAAkB;IAClB,yBAAyB;IACzB,gBAAgB;IAChB,gBAAgB;CACjB,CAAC"}

package/dist/features/workflow-engine/bolts/bolt-reviewer.d.ts

@@ -0,0 +1,36 @@
+import type { BoltSpec, WorkflowCheckpointV3 } from '../phase-types.js';
+export interface AgentReviewResult {
+    score: number;
+    feedback: string;
+    concerns: string[];
+}
+export interface EscalationEvent {
+    bolt_id: string;
+    failure_count: number;
+    last_errors: string[];
+    recommended_actions: ('re-scope' | 'split')[];
+}
+export interface ReviewDecision {
+    approved: boolean;
+    score: number;
+    tier: 'auto_approve' | 'advisory_ack' | 'hard_block';
+    feedback: string;
+    concerns: string[];
+    /** True only when tier is advisory_ack (trust < 2). Caller must surface acknowledgment prompt. */
+    requiresAcknowledgment: boolean;
+    escalation?: EscalationEvent;
+    artifact_path: string;
+}
+export declare function applyTierLogic(score: number): 'auto_approve' | 'advisory_ack' | 'hard_block';
+export declare class BoltReviewer {
+    review(boltSpec: BoltSpec, codePaths: string[], projectPath: string, workflowId: string, checkpoint: WorkflowCheckpointV3, reviewCallback: (bolt: BoltSpec, codePaths: string[], projectPath: string) => Promise<AgentReviewResult>): Promise<ReviewDecision>;
+    writeReviewArtifact(boltId: string, reviewData: {
+        score: number;
+        tier: string;
+        approved: boolean;
+        feedback: string;
+        concerns: string[];
+        escalation?: EscalationEvent;
+    }, projectPath: string, workflowId: string): Promise<string>;
+}
+//# sourceMappingURL=bolt-reviewer.d.ts.map

package/dist/features/workflow-engine/bolts/bolt-reviewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt-reviewer.d.ts","sourceRoot":"","sources":["../../../../src/features/workflow-engine/bolts/bolt-reviewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAIxE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,GAAG,cAAc,GAAG,YAAY,CAAC;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kGAAkG;IAClG,sBAAsB,EAAE,OAAO,CAAC;IAChC,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,CAI5F;AAED,qBAAa,YAAY;IACjB,MAAM,CACV,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,oBAAoB,EAChC,cAAc,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,GACvG,OAAO,CAAC,cAAc,CAAC;IAuDpB,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,CAAC,EAAE,eAAe,CAAC;KAC9B,EACD,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;CA2DnB"}

package/dist/features/workflow-engine/bolts/bolt-reviewer.js

@@ -0,0 +1,108 @@
+import fs from 'fs-extra';
+import { join } from 'path';
+import { loadTrustState } from '../trust.js';
+import { saveCheckpoint } from '../checkpoint.js';
+export function applyTierLogic(score) {
+    if (score >= 70)
+        return 'auto_approve';
+    if (score >= 50)
+        return 'advisory_ack';
+    return 'hard_block';
+}
+export class BoltReviewer {
+    async review(boltSpec, codePaths, projectPath, workflowId, checkpoint, reviewCallback) {
+        const result = await reviewCallback(boltSpec, codePaths, projectPath);
+        let tier = applyTierLogic(result.score);
+        const trustState = loadTrustState(projectPath);
+        if (trustState.current_level >= 2 && tier === 'advisory_ack') {
+            tier = 'auto_approve';
+        }
+        const approved = tier !== 'hard_block';
+        const requiresAcknowledgment = tier === 'advisory_ack';
+        let escalation;
+        const boltProgress = checkpoint.construction_bolts?.[boltSpec.id];
+        if (boltProgress) {
+            const reviewStage = boltProgress.stages.review;
+            if (reviewStage.failure_count >= 2) {
+                const lastErrors = [];
+                if (reviewStage.last_error) {
+                    lastErrors.push(reviewStage.last_error);
+                }
+                escalation = {
+                    bolt_id: boltSpec.id,
+                    failure_count: reviewStage.failure_count,
+                    last_errors: lastErrors,
+                    recommended_actions: ['re-scope', 'split'],
+                };
+            }
+        }
+        const artifactPath = await this.writeReviewArtifact(boltSpec.id, { score: result.score, tier, approved, feedback: result.feedback, concerns: result.concerns, escalation }, projectPath, workflowId);
+        if (checkpoint.construction_bolts?.[boltSpec.id]) {
+            checkpoint.construction_bolts[boltSpec.id].review_score = result.score;
+        }
+        await saveCheckpoint(projectPath, checkpoint);
+        return {
+            approved,
+            score: result.score,
+            tier,
+            feedback: result.feedback,
+            concerns: result.concerns,
+            requiresAcknowledgment,
+            escalation,
+            artifact_path: artifactPath,
+        };
+    }
+    async writeReviewArtifact(boltId, reviewData, projectPath, workflowId) {
+        const relativePath = join('aidlc-docs', workflowId, 'construction', 'bolts', boltId, 'review.md');
+        const absolutePath = join(projectPath, relativePath);
+        const lines = [];
+        lines.push('---');
+        lines.push(`bolt_id: "${boltId}"`);
+        lines.push(`score: ${reviewData.score}`);
+        lines.push(`tier: "${reviewData.tier}"`);
+        lines.push(`approved: ${reviewData.approved}`);
+        lines.push(`reviewed_at: "${new Date().toISOString()}"`);
+        lines.push('---');
+        lines.push('');
+        lines.push('## Score');
+        lines.push('');
+        lines.push(`${reviewData.score}/100 (${reviewData.tier})`);
+        lines.push('');
+        lines.push('## Decision');
+        lines.push('');
+        if (reviewData.approved && reviewData.tier === 'auto_approve') {
+            lines.push('Approved — score meets auto-approve threshold.');
+        }
+        else if (reviewData.approved && reviewData.tier === 'advisory_ack') {
+            lines.push('Approved with advisory — acknowledgment required before proceeding.');
+        }
+        else {
+            lines.push('Blocked — score below minimum threshold. Review feedback and re-submit.');
+        }
+        lines.push('');
+        lines.push('## Feedback');
+        lines.push('');
+        lines.push(reviewData.feedback);
+        lines.push('');
+        if (reviewData.concerns.length > 0) {
+            lines.push('## Concerns');
+            lines.push('');
+            for (const concern of reviewData.concerns) {
+                lines.push(`- ${concern}`);
+            }
+            lines.push('');
+        }
+        if (reviewData.escalation) {
+            lines.push('## Recommended Actions');
+            lines.push('');
+            for (const action of reviewData.escalation.recommended_actions) {
+                lines.push(`- ${action}`);
+            }
+            lines.push('');
+        }
+        await fs.ensureDir(join(absolutePath, '..'));
+        await fs.writeFile(absolutePath, lines.join('\n'), 'utf-8');
+        return relativePath;
+    }
+}
+//# sourceMappingURL=bolt-reviewer.js.map

package/dist/features/workflow-engine/bolts/bolt-reviewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bolt-reviewer.js","sourceRoot":"","sources":["../../../../src/features/workflow-engine/bolts/bolt-reviewer.ts"],"names":[],"mappings":"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"}