@substrate-ai/sdlc 0.19.54

package/dist/events.d.ts

@@ -0,0 +1,336 @@
+/**
+ * SdlcEvents — typed event map for SDLC orchestrator story-lifecycle events.
+ *
+ * Extends CoreEvents (via intersection) with all SDLC-specific event types:
+ * orchestrator:*, plan:*, solutioning:*, story:*, pipeline:*
+ *
+ * Payload shapes are copied verbatim from src/core/event-bus.types.ts (monolith source).
+ * Do NOT modify this file without corresponding changes to the monolith source.
+ */
+import type { CoreEvents } from '@substrate-ai/core';
+import type { VerificationSummary } from './verification/types.js';
+/**
+ * Structured escalation diagnosis from `orchestrator:story-escalated`.
+ * Carries classification and recommended action for the escalation.
+ */
+export interface EscalationDiagnosis {
+    issueDistribution: 'concentrated' | 'widespread';
+    severityProfile: 'blocker-present' | 'major-only' | 'minor-only' | 'no-structured-issues';
+    totalIssues: number;
+    blockerCount: number;
+    majorCount: number;
+    minorCount: number;
+    affectedFiles: string[];
+    reviewCycles: number;
+    recommendedAction: 'retry-targeted' | 'split-story' | 'human-intervention';
+    rationale: string;
+}
+/**
+ * A single finding from `solutioning:readiness-failed`.
+ */
+export interface SolutioningFinding {
+    category: string;
+    severity: string;
+    description: string;
+    affected_items: string[];
+}
+/**
+ * Phase-level timing breakdown from `story:metrics`.
+ * Keys are phase names (e.g., "dev-story", "code-review"), values are elapsed milliseconds.
+ */
+export type StoryPhaseBreakdown = Record<string, number>;
+/**
+ * Complete typed map of all SDLC orchestrator events.
+ * Intersection with CoreEvents so TypedEventBus<SdlcEvents> includes all core event keys.
+ */
+export type SdlcEvents = CoreEvents & {
+    /** Implementation orchestrator has started processing story keys */
+    'orchestrator:started': {
+        storyKeys: string[];
+        pipelineRunId?: string;
+    };
+    /** A story phase has started within the implementation orchestrator */
+    'orchestrator:story-phase-start': {
+        storyKey: string;
+        phase: string;
+        pipelineRunId?: string;
+    };
+    /** A story phase has completed within the implementation orchestrator */
+    'orchestrator:story-phase-complete': {
+        storyKey: string;
+        phase: string;
+        result: unknown;
+        pipelineRunId?: string;
+    };
+    /** A story has completed the full pipeline with SHIP_IT verdict */
+    'orchestrator:story-complete': {
+        storyKey: string;
+        reviewCycles: number;
+    };
+    /** A story has been escalated after exceeding max review cycles */
+    'orchestrator:story-escalated': {
+        storyKey: string;
+        lastVerdict: string;
+        reviewCycles: number;
+        issues: unknown[];
+        /** Structured diagnosis with classification and recommended action (Story 22-3) */
+        diagnosis?: EscalationDiagnosis;
+    };
+    /** A non-fatal warning occurred during story processing */
+    'orchestrator:story-warn': {
+        storyKey: string;
+        msg: string;
+    };
+    /** Zero-diff detection gate: dev-story reported COMPLETE but git diff is empty (Story 24-1) */
+    'orchestrator:zero-diff-escalation': {
+        storyKey: string;
+        reason: string;
+    };
+    /** Implementation orchestrator has finished all stories */
+    'orchestrator:complete': {
+        totalStories: number;
+        completed: number;
+        escalated: number;
+        failed: number;
+    };
+    /** Implementation orchestrator has been paused */
+    'orchestrator:paused': Record<string, never>;
+    /** Implementation orchestrator has been resumed */
+    'orchestrator:resumed': Record<string, never>;
+    /** Periodic heartbeat emitted every 30s during pipeline execution */
+    'orchestrator:heartbeat': {
+        runId: string;
+        activeDispatches: number;
+        completedDispatches: number;
+        queuedDispatches: number;
+    };
+    /** Watchdog detected no progress for an extended period */
+    'orchestrator:stall': {
+        runId: string;
+        storyKey: string;
+        phase: string;
+        elapsedMs: number;
+        /** PIDs of child processes at time of stall detection */
+        childPids: number[];
+        /** Whether any child process was actively running (not zombie) */
+        childActive: boolean;
+    };
+    /** Plan generation has started */
+    'plan:generating': {
+        agent: string;
+        description: string;
+    };
+    /** Plan generation has completed */
+    'plan:generated': {
+        taskCount: number;
+        estimatedCost: number;
+    };
+    /** Plan was approved by the user */
+    'plan:approved': {
+        taskCount: number;
+    };
+    /** Plan was rejected by the user */
+    'plan:rejected': {
+        reason: string;
+    };
+    /** Plan is being refined based on feedback */
+    'plan:refining': {
+        planId: string;
+        feedback: string;
+        currentVersion: number;
+    };
+    /** Plan refinement completed successfully */
+    'plan:refined': {
+        planId: string;
+        newVersion: number;
+        taskCount: number;
+    };
+    /** Plan was rolled back to a previous version */
+    'plan:rolled-back': {
+        planId: string;
+        fromVersion: number;
+        toVersion: number;
+        newVersion: number;
+    };
+    /** Plan refinement failed */
+    'plan:refinement-failed': {
+        planId: string;
+        currentVersion: number;
+        error: string;
+    };
+    /** Readiness check has completed — emitted for all verdicts (READY, NEEDS_WORK, NOT_READY) */
+    'solutioning:readiness-check': {
+        runId: string;
+        verdict: 'READY' | 'NEEDS_WORK' | 'NOT_READY';
+        coverageScore: number;
+        findingCount: number;
+        blockerCount: number;
+    };
+    /** Readiness check returned NOT_READY — solutioning phase will not proceed to implementation */
+    'solutioning:readiness-failed': {
+        runId: string;
+        verdict: 'NOT_READY';
+        coverageScore: number;
+        findings: SolutioningFinding[];
+    };
+    /**
+     * Emitted when a dev-story timeout has partial work on disk and the
+     * orchestrator captures it as a checkpoint for retry (Story 39-5).
+     */
+    'story:checkpoint-saved': {
+        /** Story key that timed out with partial work */
+        storyKey: string;
+        /** Number of files modified before the timeout */
+        filesCount: number;
+        /** Approximate byte length of the git diff captured */
+        diffSizeBytes: number;
+    };
+    /**
+     * Emitted when the orchestrator dispatches a checkpoint retry for a story
+     * that timed out with partial work (Story 39-6).
+     */
+    'story:checkpoint-retry': {
+        /** Story key being retried */
+        storyKey: string;
+        /** Number of files modified in the partial work captured at checkpoint */
+        filesCount: number;
+        /** Retry attempt number (always 2 — first retry after initial timeout) */
+        attempt: number;
+    };
+    /** Build verification command failed with non-zero exit or timeout */
+    'story:build-verification-failed': {
+        storyKey: string;
+        exitCode: number;
+        /** Build output (stdout+stderr), truncated to 2000 chars */
+        output: string;
+    };
+    /** Build verification command exited with code 0 */
+    'story:build-verification-passed': {
+        storyKey: string;
+    };
+    /** Non-blocking warning: modified .ts files export shared interfaces referenced by cross-module tests */
+    'story:interface-change-warning': {
+        storyKey: string;
+        modifiedInterfaces: string[];
+        potentiallyAffectedTests: string[];
+    };
+    /** Per-story metrics snapshot emitted when a story reaches a terminal state (Story 24-4) */
+    'story:metrics': {
+        storyKey: string;
+        wallClockMs: number;
+        phaseBreakdown: StoryPhaseBreakdown;
+        tokens: {
+            input: number;
+            output: number;
+        };
+        reviewCycles: number;
+        dispatches: number;
+    };
+    /** A pipeline phase has started (emitted by full pipeline path for NDJSON visibility) */
+    'pipeline:phase-start': {
+        phase: string;
+        ts: string;
+    };
+    /** A pipeline phase has completed (emitted by full pipeline path for NDJSON visibility) */
+    'pipeline:phase-complete': {
+        phase: string;
+        ts: string;
+    };
+    /** Pre-flight build check failed before any stories were dispatched */
+    'pipeline:pre-flight-failure': {
+        exitCode: number;
+        /** Build output (stdout+stderr), truncated to 2000 chars */
+        output: string;
+    };
+    /** Contract verification found a mismatch between declared export/import contracts */
+    'pipeline:contract-mismatch': {
+        /** Story key that declared the export for this contract */
+        exporter: string;
+        /** Story key that declared the import for this contract (null if no importer found) */
+        importer: string | null;
+        /** TypeScript interface or Zod schema name (e.g., "JudgeResult") */
+        contractName: string;
+        /** Human-readable description of the mismatch */
+        mismatchDescription: string;
+    };
+    /** Consolidated contract verification summary (emitted once per verification pass) */
+    'pipeline:contract-verification-summary': {
+        /** Number of contract declarations verified (current sprint only) */
+        verified: number;
+        /** Number of stale declarations pruned (from previous epics) */
+        stalePruned: number;
+        /** Number of real mismatches found */
+        mismatches: number;
+        /** 'pass' if zero mismatches, 'fail' otherwise */
+        verdict: 'pass' | 'fail';
+    };
+    /** Dolt merge conflict detected when merging a story branch into main */
+    'pipeline:state-conflict': {
+        storyKey: string;
+        conflict: unknown;
+    };
+    /**
+     * Emitted at pipeline startup when the repo-map symbol index is detected as stale.
+     */
+    'pipeline:repo-map-stale': {
+        /** SHA stored in the repo-map meta (last index update) */
+        storedSha: string;
+        /** Current HEAD commit SHA */
+        headSha: string;
+        /** Number of files in the stored index */
+        fileCount: number;
+    };
+    /** Project profile may be outdated relative to the actual project structure */
+    'pipeline:profile-stale': {
+        /** Human-readable message describing the staleness indicators found */
+        message: string;
+        /** List of staleness indicators detected */
+        indicators: string[];
+    };
+    /**
+     * Emitted when classifyAndPersist() successfully persists a finding from
+     * a failing story. Used by observability and monitoring consumers.
+     */
+    'pipeline:finding-captured': {
+        storyKey: string;
+        runId: string;
+        rootCause: string;
+    };
+    /**
+     * Emitted when a file overlap is detected between a pending story and a
+     * completed story, but no namespace collision exists. Dispatch proceeds
+     * normally after this event (non-blocking warning).
+     */
+    'pipeline:dispatch-warn': {
+        storyKey: string;
+        completedStoryKey: string;
+        overlappingFiles: string[];
+    };
+    /**
+     * Emitted when the dispatch gate cannot resolve a conflict and places the
+     * story in the `gated` phase for operator review. Dispatch does not proceed.
+     */
+    'pipeline:story-gated': {
+        storyKey: string;
+        conflictType: string;
+        reason: string;
+        completedStoryKey?: string;
+    };
+    /**
+     * Emitted after each individual verification check completes (pass, warn, or fail).
+     * AC5: payload matches VerificationCheckResult fields plus storyKey.
+     */
+    'verification:check-complete': {
+        storyKey: string;
+        checkName: string;
+        status: 'pass' | 'warn' | 'fail';
+        details: string;
+        duration_ms: number;
+    };
+    /**
+     * Emitted once per story after all verification checks have run.
+     * AC5: payload is the full VerificationSummary for the story.
+     */
+    'verification:story-complete': VerificationSummary;
+};
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,11 @@
+/**
+ * SdlcEvents — typed event map for SDLC orchestrator story-lifecycle events.
+ *
+ * Extends CoreEvents (via intersection) with all SDLC-specific event types:
+ * orchestrator:*, plan:*, solutioning:*, story:*, pipeline:*
+ *
+ * Payload shapes are copied verbatim from src/core/event-bus.types.ts (monolith source).
+ * Do NOT modify this file without corresponding changes to the monolith source.
+ */
+export {};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/gating/conflict-detector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ConflictDetector — file-overlap and namespace-collision detection.
+ *
+ * Story 53-9: Dispatch Pre-Condition Gating
+ *
+ * Provides pure utility functions for:
+ *   - extracting target symbol names from story content
+ *   - finding file-level overlap between pending and completed story file sets
+ *   - detecting namespace collisions in overlapping files
+ */
+export declare class ConflictDetector {
+    /**
+     * Extract exported/declared symbol names from story content using regex.
+     *
+     * Matches the primary pattern for TypeScript exports and class/interface
+     * declarations. Returns unique symbol names only.
+     *
+     * AC3: Symbol extraction uses regex (no AST).
+     *
+     * @param storyContent - Raw text content of the story file.
+     * @returns Unique array of symbol names found in the content.
+     */
+    static extractTargetSymbols(storyContent: string): string[];
+    /**
+     * Return the intersection of two file-path arrays.
+     *
+     * AC2: identifies file-level overlap for the warn path.
+     *
+     * @param pendingFiles - File paths targeted by the pending story.
+     * @param completedFiles - File paths modified by a completed story.
+     * @returns Paths present in both arrays.
+     */
+    static findOverlappingFiles(pendingFiles: string[], completedFiles: string[]): string[];
+    /**
+     * Search overlapping files for a namespace collision on the given symbol.
+     *
+     * Reads each file and looks for patterns like:
+     *   - `class ${symbol}`
+     *   - `interface ${symbol}`
+     *   - `export const ${symbol}`
+     *   - `export class ${symbol}`
+     *
+     * Returns the first match found, or null if no collision exists.
+     * Each file read is wrapped in its own try-catch so a single unreadable
+     * file does not abort the entire check.
+     *
+     * AC3: async file reads; per-file try-catch.
+     *
+     * @param symbol - Symbol name to search for.
+     * @param files - Relative file paths to search.
+     * @param projectRoot - Absolute project root directory.
+     * @returns First collision found `{ file, symbol }`, or null.
+     */
+    static detectNamespaceCollision(symbol: string, files: string[], projectRoot: string): Promise<{
+        file: string;
+        symbol: string;
+    } | null>;
+}
+//# sourceMappingURL=conflict-detector.d.ts.map

package/dist/gating/conflict-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.d.ts","sourceRoot":"","sources":["../../src/gating/conflict-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,qBAAa,gBAAgB;IAC3B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE;IAkB3D;;;;;;;;OAQG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IAKvF;;;;;;;;;;;;;;;;;;;OAmBG;WACU,wBAAwB,CACnC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EAAE,EACf,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CA4BpD"}

package/dist/gating/conflict-detector.js

@@ -0,0 +1,101 @@
+/**
+ * ConflictDetector — file-overlap and namespace-collision detection.
+ *
+ * Story 53-9: Dispatch Pre-Condition Gating
+ *
+ * Provides pure utility functions for:
+ *   - extracting target symbol names from story content
+ *   - finding file-level overlap between pending and completed story file sets
+ *   - detecting namespace collisions in overlapping files
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// ---------------------------------------------------------------------------
+// ConflictDetector
+// ---------------------------------------------------------------------------
+export class ConflictDetector {
+    /**
+     * Extract exported/declared symbol names from story content using regex.
+     *
+     * Matches the primary pattern for TypeScript exports and class/interface
+     * declarations. Returns unique symbol names only.
+     *
+     * AC3: Symbol extraction uses regex (no AST).
+     *
+     * @param storyContent - Raw text content of the story file.
+     * @returns Unique array of symbol names found in the content.
+     */
+    static extractTargetSymbols(storyContent) {
+        // Primary extraction pattern from dev notes
+        const pattern = /(export\s+(?:class|interface|const|function)|(?:^|\s)class|(?:^|\s)interface)\s+(\w+)/gm;
+        const names = new Set();
+        let match;
+        while ((match = pattern.exec(storyContent)) !== null) {
+            const name = match[2];
+            if (name !== undefined && name.length > 0) {
+                names.add(name);
+            }
+        }
+        return Array.from(names);
+    }
+    /**
+     * Return the intersection of two file-path arrays.
+     *
+     * AC2: identifies file-level overlap for the warn path.
+     *
+     * @param pendingFiles - File paths targeted by the pending story.
+     * @param completedFiles - File paths modified by a completed story.
+     * @returns Paths present in both arrays.
+     */
+    static findOverlappingFiles(pendingFiles, completedFiles) {
+        const completedSet = new Set(completedFiles);
+        return pendingFiles.filter((f) => completedSet.has(f));
+    }
+    /**
+     * Search overlapping files for a namespace collision on the given symbol.
+     *
+     * Reads each file and looks for patterns like:
+     *   - `class ${symbol}`
+     *   - `interface ${symbol}`
+     *   - `export const ${symbol}`
+     *   - `export class ${symbol}`
+     *
+     * Returns the first match found, or null if no collision exists.
+     * Each file read is wrapped in its own try-catch so a single unreadable
+     * file does not abort the entire check.
+     *
+     * AC3: async file reads; per-file try-catch.
+     *
+     * @param symbol - Symbol name to search for.
+     * @param files - Relative file paths to search.
+     * @param projectRoot - Absolute project root directory.
+     * @returns First collision found `{ file, symbol }`, or null.
+     */
+    static async detectNamespaceCollision(symbol, files, projectRoot) {
+        // Patterns that indicate the symbol is declared in the file
+        const patterns = [
+            new RegExp(`export\\s+class\\s+${symbol}\\b`),
+            new RegExp(`export\\s+interface\\s+${symbol}\\b`),
+            new RegExp(`export\\s+const\\s+${symbol}\\b`),
+            new RegExp(`(?:^|\\s)class\\s+${symbol}\\b`),
+            new RegExp(`(?:^|\\s)interface\\s+${symbol}\\b`),
+        ];
+        for (const filePath of files) {
+            try {
+                const absolutePath = join(projectRoot, filePath);
+                const content = await readFile(absolutePath, 'utf-8');
+                for (const pattern of patterns) {
+                    if (pattern.test(content)) {
+                        return { file: filePath, symbol };
+                    }
+                }
+            }
+            catch {
+                // Non-fatal: unreadable file skipped — proceed to next
+                continue;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=conflict-detector.js.map

package/dist/gating/conflict-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.js","sourceRoot":"","sources":["../../src/gating/conflict-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,OAAO,gBAAgB;IAC3B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAoB;QAC9C,4CAA4C;QAC5C,MAAM,OAAO,GACX,yFAAyF,CAAA;QAE3F,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;QAC/B,IAAI,KAA6B,CAAA;QAEjC,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YACrB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1C,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;YACjB,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,oBAAoB,CAAC,YAAsB,EAAE,cAAwB;QAC1E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAA;QAC5C,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACxD,CAAC;IAED;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,KAAK,CAAC,wBAAwB,CACnC,MAAc,EACd,KAAe,EACf,WAAmB;QAEnB,4DAA4D;QAC5D,MAAM,QAAQ,GAAG;YACf,IAAI,MAAM,CAAC,sBAAsB,MAAM,KAAK,CAAC;YAC7C,IAAI,MAAM,CAAC,0BAA0B,MAAM,KAAK,CAAC;YACjD,IAAI,MAAM,CAAC,sBAAsB,MAAM,KAAK,CAAC;YAC7C,IAAI,MAAM,CAAC,qBAAqB,MAAM,KAAK,CAAC;YAC5C,IAAI,MAAM,CAAC,yBAAyB,MAAM,KAAK,CAAC;SACjD,CAAA;QAED,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC;gBACH,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;gBAChD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;gBAErD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;wBAC1B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;oBACnC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,uDAAuD;gBACvD,SAAQ;YACV,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/gating/dispatch-gate.d.ts

@@ -0,0 +1,42 @@
+/**
+ * DispatchGate — pre-dispatch conflict gating for story dispatch.
+ *
+ * Story 53-9: Dispatch Pre-Condition Gating
+ *
+ * Evaluates three gating conditions in order:
+ *   1. Learning pre-emption (AC6): high-confidence namespace-collision findings
+ *      from the learning store that overlap with the pending story's files.
+ *   2. File-level overlap (AC2): completed-story modified files overlap with
+ *      the pending story's target files (warn, no block).
+ *   3. Namespace collision (AC3): a symbol targeted by the pending story already
+ *      exists in a file modified by a completed story.
+ *
+ * All DB and file I/O is wrapped in a single outer try-catch so that gate
+ * failures never block the pipeline (AC7 — graceful degradation).
+ */
+import type { GateResult, DispatchGateOptions } from './types.js';
+export declare class DispatchGate {
+    /**
+     * Evaluate all pre-dispatch gating conditions for a pending story.
+     *
+     * Entry point: called once per story before agent dispatch.
+     *
+     * Steps (in order):
+     *   1. Learning pre-emption check (AC6)
+     *   2. Per-completed-story file overlap + collision scan (AC2/AC3)
+     *   3. Return proceed if no issues found
+     *
+     * Outer try-catch ensures any unexpected error returns `{ decision: 'proceed' }`
+     * so the pipeline is never blocked by gate failures (AC7).
+     */
+    static check(options: DispatchGateOptions): Promise<GateResult>;
+    /**
+     * Attempt to auto-resolve a conflict by appending an extension note to the
+     * story content.
+     *
+     * Returns the modified prompt string on success, or null if the content is
+     * empty or the append fails for any reason (AC4/AC5).
+     */
+    private static attemptAutoResolution;
+}
+//# sourceMappingURL=dispatch-gate.d.ts.map

package/dist/gating/dispatch-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-gate.d.ts","sourceRoot":"","sources":["../../src/gating/dispatch-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAQjE,qBAAa,YAAY;IACvB;;;;;;;;;;;;OAYG;WACU,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC;IAgKrE;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;CAUrC"}