@substrate-ai/sdlc 0.19.54

package/dist/orchestrator/graph-orchestrator.js

@@ -0,0 +1,213 @@
+/**
+ * GraphOrchestrator — drives the SDLC pipeline as a factory graph.
+ *
+ * Story 43-7: GraphOrchestrator multi-story orchestration.
+ * Story 43-8: applyConfigToGraph config-to-graph mapping (duck-typed, ADR-003 compliant).
+ * Story 43-10: resolveGraphPath helper; eventBus/pipelineRunId/maxReviewCycles in config;
+ *              per-story outcome tracking in GraphRunSummary.
+ *
+ * ADR-003: NO imports from @substrate-ai/factory in this file.
+ * All factory-side types are accepted via locally-defined duck-typed
+ * interfaces injected through GraphOrchestratorConfig.
+ */
+import { EventEmitter } from 'node:events';
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { createSdlcEventBridge } from '../handlers/event-bridge.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// ---------------------------------------------------------------------------
+// Story 43-10: resolveGraphPath helper
+// ---------------------------------------------------------------------------
+/**
+ * Returns the absolute path to the bundled SDLC pipeline DOT file.
+ *
+ * Resolution order:
+ *   1. Relative to __dirname (works in source/unbundled: __dirname = packages/sdlc/src/orchestrator/)
+ *   2. Via createRequire to locate @substrate-ai/sdlc package.json, then graphs/ relative to it
+ *      (works when bundled: __dirname points to dist/ but createRequire finds the real package)
+ *
+ * @throws {Error} if the DOT file cannot be found by any method.
+ */
+export function resolveGraphPath() {
+    const candidates = [
+        // Method 1: relative to source file (works in unbundled / workspace mode)
+        join(__dirname, '../../graphs/sdlc-pipeline.dot'),
+        // Method 2: relative to dist/ directory (works when bundled via tsdown postbuild copy)
+        join(__dirname, '../graphs/sdlc-pipeline.dot'),
+        join(__dirname, 'graphs/sdlc-pipeline.dot'),
+    ];
+    // Method 3: resolve via createRequire (works in npm-installed mode)
+    try {
+        const require = createRequire(import.meta.url);
+        const sdlcPkgPath = require.resolve('@substrate-ai/sdlc/package.json');
+        candidates.push(join(dirname(sdlcPkgPath), 'graphs', 'sdlc-pipeline.dot'));
+    }
+    catch {
+        // createRequire resolution failed — continue with other candidates
+    }
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return candidate;
+    }
+    throw new Error(`Cannot locate sdlc-pipeline.dot. Searched:\n${candidates.map((c) => `  ${c}`).join('\n')}`);
+}
+/** Thrown by `createGraphOrchestrator` when the supplied graph is structurally invalid. */
+export class GraphOrchestratorInitError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GraphOrchestratorInitError';
+    }
+}
+// ---------------------------------------------------------------------------
+// Story 43-7/43-10: Factory function
+// ---------------------------------------------------------------------------
+/**
+ * Creates a `GraphOrchestrator` that runs one graph executor instance per
+ * concurrent story slot, with conflict-group serialization and bounded concurrency.
+ *
+ * When `config.eventBus` is provided, a per-story SDLC event bridge is created
+ * to translate factory `graph:*` events into `orchestrator:story-*` events (AC4,
+ * story 43-10).
+ *
+ * @throws {GraphOrchestratorInitError} if `config.graph` is missing `nodes` or `edges`.
+ */
+export function createGraphOrchestrator(config) {
+    if (!config.graph?.nodes || !config.graph?.edges) {
+        throw new GraphOrchestratorInitError('Invalid graph: missing nodes or edges arrays');
+    }
+    const gcPauseMs = config.gcPauseMs ?? 2000;
+    async function runStoryGraph(storyKey, summary) {
+        // Derive epicId from story key (e.g. "48-1" → "48")
+        const epicId = storyKey.split('-')[0] ?? '';
+        const initialContext = {
+            storyKey,
+            epicId,
+            projectRoot: config.projectRoot,
+            methodologyPack: config.methodologyPack,
+            ...(config.pipelineRunId !== undefined ? { runId: config.pipelineRunId, pipelineRunId: config.pipelineRunId } : {}),
+        };
+        // Create a per-story factory event bus so each story's graph events are scoped
+        // to its own execution. The executor emits graph:* events on this bus.
+        const factoryBus = new EventEmitter();
+        // Wire up the SDLC event bridge if an SDLC event bus has been provided (story 43-9).
+        // The bridge translates factory graph:* events into orchestrator:story-* events.
+        const bridge = config.eventBus != null
+            ? createSdlcEventBridge({
+                storyKey,
+                ...(config.pipelineRunId !== undefined ? { pipelineRunId: config.pipelineRunId } : {}),
+                sdlcBus: config.eventBus,
+                graphEvents: factoryBus,
+            })
+            : undefined;
+        // Track whether the executor escalated this story (goal gate unsatisfied after max retries)
+        let escalated = false;
+        factoryBus.on('graph:goal-gate-unsatisfied', () => { escalated = true; });
+        let result;
+        try {
+            result = await config.executor.run(config.graph, {
+                runId: `${config.runId}:${storyKey}`,
+                logsRoot: config.logsRoot,
+                handlerRegistry: config.handlerRegistry,
+                initialContext,
+                eventBus: factoryBus,
+            });
+        }
+        catch (err) {
+            // Record failure — bridge teardown happens in finally
+            const errMsg = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[graph-orchestrator] Story ${storyKey} failed: ${errMsg}\n`);
+            summary.stories[storyKey] = { outcome: escalated ? 'ESCALATED' : 'FAILED', error: errMsg };
+            summary.f++;
+        }
+        finally {
+            // Always teardown the bridge to remove graph event listeners (AC7)
+            bridge?.teardown();
+        }
+        if (result === undefined) {
+            // Executor threw — outcome already recorded in catch block
+            return;
+        }
+        if (result.status === 'SUCCESS') {
+            summary.stories[storyKey] = { outcome: 'SUCCESS' };
+            summary.s++;
+        }
+        else if (escalated) {
+            summary.stories[storyKey] = { outcome: 'ESCALATED' };
+            summary.f++;
+        }
+        else {
+            const reason = result.failureReason ?? `status=${result.status}`;
+            process.stderr.write(`[graph-orchestrator] Story ${storyKey} failed: ${reason}\n`);
+            summary.stories[storyKey] = { outcome: 'FAILED', error: reason };
+            summary.f++;
+        }
+    }
+    async function runGroup(group, summary) {
+        for (const storyKey of group) {
+            await runStoryGraph(storyKey, summary);
+            if (gcPauseMs > 0)
+                await new Promise((r) => setTimeout(r, gcPauseMs));
+        }
+    }
+    async function runBatch(groups, summary) {
+        const queue = [...groups];
+        const active = [];
+        while (queue.length > 0 || active.length > 0) {
+            while (active.length < config.maxConcurrency && queue.length > 0) {
+                const group = queue.shift();
+                const p = runGroup(group, summary).finally(() => {
+                    active.splice(active.indexOf(p), 1);
+                });
+                active.push(p);
+            }
+            if (active.length > 0)
+                await Promise.race(active);
+        }
+    }
+    return {
+        async run(storyKeys) {
+            const grouper = config.conflictGrouper ?? ((keys) => [keys.map((k) => [k])]);
+            const batches = grouper(storyKeys);
+            const summary = {
+                s: 0,
+                f: 0,
+                stories: {},
+            };
+            for (const batchGroups of batches) {
+                await runBatch(batchGroups, summary);
+            }
+            return {
+                successCount: summary.s,
+                failureCount: summary.f,
+                totalStories: storyKeys.length,
+                stories: summary.stories,
+            };
+        },
+    };
+}
+/**
+ * Patches the loaded SDLC pipeline graph to reflect runtime configuration.
+ *
+ * Currently maps `maxReviewCycles` → `dev_story.maxRetries` (1:1 mapping).
+ * Both values represent the number of *additional* retry attempts (not total).
+ *
+ * Must be called after parseGraph() and before any story graph instance runs.
+ *
+ * @param graph  A factory Graph (Map-based nodes) duck-typed as PatchableGraph.
+ * @param options  Runtime configuration to apply.
+ * @throws {Error} if the graph does not contain a `dev_story` node.
+ */
+export function applyConfigToGraph(graph, options) {
+    const devStoryNode = graph.nodes.get('dev_story');
+    if (!devStoryNode) {
+        throw new Error("applyConfigToGraph: graph does not contain a 'dev_story' node");
+    }
+    devStoryNode.maxRetries = options.maxReviewCycles;
+    // Also set graph-level defaultMaxRetries so the executor's failRouteCount safeguard
+    // (which bounds conditional edge loops like code_review → dev_story) respects
+    // the --max-review-cycles value instead of using a hardcoded default.
+    graph.defaultMaxRetries = options.maxReviewCycles;
+}
+//# sourceMappingURL=graph-orchestrator.js.map

package/dist/orchestrator/graph-orchestrator.js.map

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

package/dist/run-manifest/cli-flags.d.ts

@@ -0,0 +1,11 @@
+/**
+ * run-manifest/cli-flags.ts — alias path for architectural spec conformance.
+ *
+ * Story 52-3 specified CliFlags at packages/sdlc/src/run-manifest/cli-flags.ts.
+ * The implementation lives at ../run-model/cli-flags.ts (established by Story 52-1
+ * which used run-model/ as the module namespace). This file re-exports from there
+ * so both import paths work.
+ */
+export { CliFlagsSchema } from '../run-model/cli-flags.js';
+export type { CliFlags } from '../run-model/cli-flags.js';
+//# sourceMappingURL=cli-flags.d.ts.map

package/dist/run-manifest/cli-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.d.ts","sourceRoot":"","sources":["../../src/run-manifest/cli-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/run-manifest/cli-flags.js

@@ -0,0 +1,10 @@
+/**
+ * run-manifest/cli-flags.ts — alias path for architectural spec conformance.
+ *
+ * Story 52-3 specified CliFlags at packages/sdlc/src/run-manifest/cli-flags.ts.
+ * The implementation lives at ../run-model/cli-flags.ts (established by Story 52-1
+ * which used run-model/ as the module namespace). This file re-exports from there
+ * so both import paths work.
+ */
+export { CliFlagsSchema } from '../run-model/cli-flags.js';
+//# sourceMappingURL=cli-flags.js.map

package/dist/run-manifest/cli-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.js","sourceRoot":"","sources":["../../src/run-manifest/cli-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/run-manifest/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * run-manifest/index.ts — alias path for architectural spec conformance.
+ *
+ * Story 52-3 specified the module barrel at packages/sdlc/src/run-manifest/index.ts.
+ * The implementation lives at ../run-model/index.ts (established by Story 52-1
+ * which used run-model/ as the module namespace). This file re-exports from there
+ * so both import paths work.
+ */
+export * from '../run-model/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/run-manifest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/run-manifest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,uBAAuB,CAAA"}

package/dist/run-manifest/index.js

@@ -0,0 +1,10 @@
+/**
+ * run-manifest/index.ts — alias path for architectural spec conformance.
+ *
+ * Story 52-3 specified the module barrel at packages/sdlc/src/run-manifest/index.ts.
+ * The implementation lives at ../run-model/index.ts (established by Story 52-1
+ * which used run-model/ as the module namespace). This file re-exports from there
+ * so both import paths work.
+ */
+export * from '../run-model/index.js';
+//# sourceMappingURL=index.js.map

package/dist/run-manifest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run-manifest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,uBAAuB,CAAA"}

package/dist/run-model/cli-flags.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CliFlags — typed schema for CLI flags persisted in the run manifest — Story 52-3.
+ *
+ * These flags are written to `cli_flags` in the run manifest at run start so that
+ * the supervisor can read the original scope on restart.
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for the CLI flags persisted in the run manifest.
+ *
+ * All fields are optional — only flags explicitly provided on the CLI are written.
+ * `halt_on` defaults to `'none'` at write time; `cost_ceiling` is omitted when not provided.
+ */
+export declare const CliFlagsSchema: z.ZodObject<{
+    stories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    halt_on: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        critical: "critical";
+        none: "none";
+    }>>;
+    cost_ceiling: z.ZodOptional<z.ZodNumber>;
+    agent: z.ZodOptional<z.ZodString>;
+    skip_verification: z.ZodOptional<z.ZodBoolean>;
+    events: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CliFlags = z.infer<typeof CliFlagsSchema>;
+//# sourceMappingURL=cli-flags.d.ts.map

package/dist/run-model/cli-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.d.ts","sourceRoot":"","sources":["../../src/run-model/cli-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;;;;GAKG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;iBAazB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/dist/run-model/cli-flags.js

@@ -0,0 +1,31 @@
+/**
+ * CliFlags — typed schema for CLI flags persisted in the run manifest — Story 52-3.
+ *
+ * These flags are written to `cli_flags` in the run manifest at run start so that
+ * the supervisor can read the original scope on restart.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// CliFlagsSchema — Zod schema for CLI flags
+// ---------------------------------------------------------------------------
+/**
+ * Zod schema for the CLI flags persisted in the run manifest.
+ *
+ * All fields are optional — only flags explicitly provided on the CLI are written.
+ * `halt_on` defaults to `'none'` at write time; `cost_ceiling` is omitted when not provided.
+ */
+export const CliFlagsSchema = z.object({
+    /** Explicit story keys provided via --stories (e.g. ['51-1', '51-2']). */
+    stories: z.array(z.string()).optional(),
+    /** Escalation severity level that halts the pipeline (--halt-on). */
+    halt_on: z.enum(['all', 'critical', 'none']).optional(),
+    /** Maximum spend in USD before the pipeline halts (--cost-ceiling). */
+    cost_ceiling: z.number().positive().optional(),
+    /** Agent backend ID (--agent), e.g. 'codex' or 'gemini'. */
+    agent: z.string().optional(),
+    /** When true, the post-dispatch verification pipeline was skipped (--skip-verification). */
+    skip_verification: z.boolean().optional(),
+    /** When true, NDJSON events were requested (--events). */
+    events: z.boolean().optional(),
+});
+//# sourceMappingURL=cli-flags.js.map

package/dist/run-model/cli-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-flags.js","sourceRoot":"","sources":["../../src/run-model/cli-flags.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,0EAA0E;IAC1E,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,qEAAqE;IACrE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvD,uEAAuE;IACvE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,4DAA4D;IAC5D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,4FAA4F;IAC5F,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,0DAA0D;IAC1D,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAA"}

package/dist/run-model/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * run-model barrel export — Story 52-1/52-3.
+ *
+ * Exports RunManifest, RunManifestData, RunManifestSchema, ManifestReadError,
+ * CliFlags, CliFlagsSchema, and all sub-types consumed by Epic 52 stories.
+ */
+export { RunManifest } from './run-manifest.js';
+export type { IDoltAdapter } from './run-manifest.js';
+export type { RunManifestData, RecoveryEntry, CostAccumulation, Proposal, } from './types.js';
+export { RunManifestSchema, RecoveryEntrySchema, CostAccumulationSchema, ProposalSchema, ManifestReadError, } from './schemas.js';
+export { RecoveryOutcomeSchema } from './recovery-history.js';
+export type { RecoveryOutcome } from './recovery-history.js';
+export { CliFlagsSchema } from './cli-flags.js';
+export type { CliFlags } from './cli-flags.js';
+export { PerStoryStatusSchema, PerStoryStateSchema } from './per-story-state.js';
+export type { PerStoryStatus, PerStoryState } from './per-story-state.js';
+export { StoredVerificationCheckResultSchema, StoredVerificationSummarySchema } from './verification-result.js';
+export type { StoredVerificationCheckResult, StoredVerificationSummary } from './verification-result.js';
+export { SupervisorLock } from './supervisor-lock.js';
+export type { SupervisorLockOptions } from './supervisor-lock.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/run-model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/run-model/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,QAAQ,GACT,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAG5D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAG9C,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAChF,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGzE,OAAO,EAAE,mCAAmC,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAA;AAC/G,YAAY,EAAE,6BAA6B,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AAGxG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/run-model/index.js

@@ -0,0 +1,19 @@
+/**
+ * run-model barrel export — Story 52-1/52-3.
+ *
+ * Exports RunManifest, RunManifestData, RunManifestSchema, ManifestReadError,
+ * CliFlags, CliFlagsSchema, and all sub-types consumed by Epic 52 stories.
+ */
+export { RunManifest } from './run-manifest.js';
+export { RunManifestSchema, RecoveryEntrySchema, CostAccumulationSchema, ProposalSchema, ManifestReadError, } from './schemas.js';
+// Story 52-8: Recovery history schemas and types (additional exports not covered above)
+export { RecoveryOutcomeSchema } from './recovery-history.js';
+// Story 52-3: CLI flag persistence schema
+export { CliFlagsSchema } from './cli-flags.js';
+// Story 52-4: Per-story lifecycle state schema and types
+export { PerStoryStatusSchema, PerStoryStateSchema } from './per-story-state.js';
+// Story 52-7: Stored verification result schemas and types
+export { StoredVerificationCheckResultSchema, StoredVerificationSummarySchema } from './verification-result.js';
+// Story 52-2: Supervisor locking and ownership
+export { SupervisorLock } from './supervisor-lock.js';
+//# sourceMappingURL=index.js.map

package/dist/run-model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run-model/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAU/C,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,iBAAiB,GAClB,MAAM,cAAc,CAAA;AAErB,wFAAwF;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,0CAA0C;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG/C,yDAAyD;AACzD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAGhF,2DAA2D;AAC3D,OAAO,EAAE,mCAAmC,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAA;AAG/G,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/run-model/per-story-state.d.ts

@@ -0,0 +1,62 @@
+/**
+ * PerStoryState — per-story lifecycle state schema — Story 52-4.
+ *
+ * Provides the typed schema for individual story lifecycle states tracked
+ * in the run manifest's `per_story_state` map. Each entry records both
+ * a high-level consumer-facing status and the raw orchestrator phase string.
+ */
+import { z } from 'zod';
+/**
+ * High-level consumer-facing status for a story in the run manifest.
+ *
+ * Known literals cover all states defined in Epic 52–54. The trailing
+ * `z.string()` fallback (MUST remain last) accommodates states added by
+ * later stories (`gated` from 53-9, `skipped` from 53-3, `recovered` from 54-1)
+ * and any future extensions without breaking deserialization.
+ */
+export declare const PerStoryStatusSchema: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"dispatched">, z.ZodLiteral<"in-review">, z.ZodLiteral<"complete">, z.ZodLiteral<"failed">, z.ZodLiteral<"escalated">, z.ZodLiteral<"recovered">, z.ZodLiteral<"verification-failed">, z.ZodLiteral<"gated">, z.ZodLiteral<"skipped">, z.ZodString]>;
+export type PerStoryStatus = z.infer<typeof PerStoryStatusSchema>;
+/**
+ * Schema for a single per-story state entry in the run manifest.
+ *
+ * Field semantics:
+ * - `status`: High-level consumer-facing status (state-machine value). Use this
+ *   for state-machine decisions and display.
+ * - `phase`: Raw orchestrator `StoryPhase` string (e.g., `'IN_DEV'`, `'IN_REVIEW'`).
+ *   Informational only — do NOT compare this field in state-machine logic.
+ * - `started_at`: ISO-8601 timestamp when the story entered an active phase.
+ * - `completed_at`: ISO-8601 timestamp when the story reached a terminal state.
+ * - `verification_result`: Verification pipeline result (populated by story 52-7).
+ * - `cost_usd`: Accumulated cost in USD (populated at terminal transition).
+ */
+export declare const PerStoryStateSchema: z.ZodObject<{
+    status: z.ZodUnion<readonly [z.ZodLiteral<"pending">, z.ZodLiteral<"dispatched">, z.ZodLiteral<"in-review">, z.ZodLiteral<"complete">, z.ZodLiteral<"failed">, z.ZodLiteral<"escalated">, z.ZodLiteral<"recovered">, z.ZodLiteral<"verification-failed">, z.ZodLiteral<"gated">, z.ZodLiteral<"skipped">, z.ZodString]>;
+    phase: z.ZodString;
+    started_at: z.ZodString;
+    completed_at: z.ZodOptional<z.ZodString>;
+    verification_result: z.ZodOptional<z.ZodObject<{
+        storyKey: z.ZodString;
+        checks: z.ZodArray<z.ZodObject<{
+            checkName: z.ZodString;
+            status: z.ZodEnum<{
+                pass: "pass";
+                warn: "warn";
+                fail: "fail";
+            }>;
+            details: z.ZodString;
+            duration_ms: z.ZodNumber;
+        }, z.core.$strip>>;
+        status: z.ZodEnum<{
+            pass: "pass";
+            warn: "warn";
+            fail: "fail";
+        }>;
+        duration_ms: z.ZodNumber;
+    }, z.core.$strip>>;
+    cost_usd: z.ZodOptional<z.ZodNumber>;
+    review_cycles: z.ZodOptional<z.ZodNumber>;
+    dispatches: z.ZodOptional<z.ZodNumber>;
+    retry_count: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type PerStoryState = z.infer<typeof PerStoryStateSchema>;
+//# sourceMappingURL=per-story-state.d.ts.map

package/dist/run-model/per-story-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-story-state.d.ts","sourceRoot":"","sources":["../../src/run-model/per-story-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAOvB;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,iTAY/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAMjE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmB9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/run-model/per-story-state.js

@@ -0,0 +1,70 @@
+/**
+ * PerStoryState — per-story lifecycle state schema — Story 52-4.
+ *
+ * Provides the typed schema for individual story lifecycle states tracked
+ * in the run manifest's `per_story_state` map. Each entry records both
+ * a high-level consumer-facing status and the raw orchestrator phase string.
+ */
+import { z } from 'zod';
+import { StoredVerificationSummarySchema } from './verification-result.js';
+// ---------------------------------------------------------------------------
+// PerStoryStatusSchema — extensible union (v0.19.6 pattern)
+// ---------------------------------------------------------------------------
+/**
+ * High-level consumer-facing status for a story in the run manifest.
+ *
+ * Known literals cover all states defined in Epic 52–54. The trailing
+ * `z.string()` fallback (MUST remain last) accommodates states added by
+ * later stories (`gated` from 53-9, `skipped` from 53-3, `recovered` from 54-1)
+ * and any future extensions without breaking deserialization.
+ */
+export const PerStoryStatusSchema = z.union([
+    z.literal('pending'),
+    z.literal('dispatched'),
+    z.literal('in-review'),
+    z.literal('complete'),
+    z.literal('failed'),
+    z.literal('escalated'),
+    z.literal('recovered'),
+    z.literal('verification-failed'),
+    z.literal('gated'),
+    z.literal('skipped'),
+    z.string(), // extensible fallback — must be last
+]);
+// ---------------------------------------------------------------------------
+// PerStoryStateSchema
+// ---------------------------------------------------------------------------
+/**
+ * Schema for a single per-story state entry in the run manifest.
+ *
+ * Field semantics:
+ * - `status`: High-level consumer-facing status (state-machine value). Use this
+ *   for state-machine decisions and display.
+ * - `phase`: Raw orchestrator `StoryPhase` string (e.g., `'IN_DEV'`, `'IN_REVIEW'`).
+ *   Informational only — do NOT compare this field in state-machine logic.
+ * - `started_at`: ISO-8601 timestamp when the story entered an active phase.
+ * - `completed_at`: ISO-8601 timestamp when the story reached a terminal state.
+ * - `verification_result`: Verification pipeline result (populated by story 52-7).
+ * - `cost_usd`: Accumulated cost in USD (populated at terminal transition).
+ */
+export const PerStoryStateSchema = z.object({
+    /** High-level consumer-facing status (state-machine value). */
+    status: PerStoryStatusSchema,
+    /** Raw orchestrator StoryPhase string (informational, for debugging). */
+    phase: z.string(),
+    /** ISO-8601 timestamp when the story entered an active phase. */
+    started_at: z.string(),
+    /** ISO-8601 timestamp when the story reached a terminal state. */
+    completed_at: z.string().optional(),
+    /** Verification pipeline result for this story (populated by story 52-7). */
+    verification_result: StoredVerificationSummarySchema.optional(),
+    /** Accumulated cost in USD for this story (populated at terminal transition). */
+    cost_usd: z.number().nonnegative().optional(),
+    /** Number of code review cycles this story went through. */
+    review_cycles: z.number().int().nonnegative().optional(),
+    /** Number of agent dispatches for this story. */
+    dispatches: z.number().int().nonnegative().optional(),
+    /** Number of retry attempts for this story (code review retries + recovery-engine retries). Initial dispatch is not counted. */
+    retry_count: z.number().int().nonnegative().optional(),
+});
+//# sourceMappingURL=per-story-state.js.map

package/dist/run-model/per-story-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"per-story-state.js","sourceRoot":"","sources":["../../src/run-model/per-story-state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAA;AAE1E,8EAA8E;AAC9E,4DAA4D;AAC5D,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC1C,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACpB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACvB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACtB,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IACrB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACtB,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IACtB,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAChC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;IAClB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACpB,CAAC,CAAC,MAAM,EAAE,EAAE,qCAAqC;CAClD,CAAC,CAAA;AAIF,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB;IAC5B,yEAAyE;IACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,iEAAiE;IACjE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kEAAkE;IAClE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,6EAA6E;IAC7E,mBAAmB,EAAE,+BAA+B,CAAC,QAAQ,EAAE;IAC/D,iFAAiF;IACjF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC7C,4DAA4D;IAC5D,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACxD,iDAAiD;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACrD,gIAAgI;IAChI,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAA"}

package/dist/run-model/recovery-history.d.ts

@@ -0,0 +1,56 @@
+/**
+ * RecoveryEntry and CostAccumulation schemas — Story 52-8.
+ *
+ * Provides Zod schemas and TypeScript types for recovery history and cost
+ * accumulation data stored in the run manifest. Consumed by Epic 53 cost
+ * governance and Epic 54 recovery engine.
+ */
+import { z } from 'zod';
+/**
+ * Outcome of a recovery attempt.
+ *
+ * The string fallback must be last in the union so Zod evaluates the literal
+ * variants first — a leading z.string() would swallow all literals. This
+ * follows the v0.19.6 extensible union pattern used throughout the codebase.
+ */
+export declare const RecoveryOutcomeSchema: z.ZodUnion<readonly [z.ZodLiteral<"retried">, z.ZodLiteral<"escalated">, z.ZodLiteral<"skipped">, z.ZodString]>;
+export type RecoveryOutcome = z.infer<typeof RecoveryOutcomeSchema>;
+/**
+ * A single recovery attempt recorded in the run manifest.
+ *
+ * `attempt_number` is 1-indexed: 1 = first retry, NOT the initial dispatch.
+ * The initial dispatch of a story is never recorded as a RecoveryEntry.
+ *
+ * `strategy` is free-form (e.g., `'retry-with-context'`, `'re-scope'`).
+ *
+ * `cost_usd` is the cost of THIS single retry attempt only — NOT cumulative.
+ * Cumulative per-story retry cost is tracked in `CostAccumulation.per_story`.
+ */
+export declare const RecoveryEntrySchema: z.ZodObject<{
+    story_key: z.ZodString;
+    attempt_number: z.ZodNumber;
+    strategy: z.ZodString;
+    root_cause: z.ZodString;
+    outcome: z.ZodUnion<readonly [z.ZodLiteral<"retried">, z.ZodLiteral<"escalated">, z.ZodLiteral<"skipped">, z.ZodString]>;
+    cost_usd: z.ZodNumber;
+    timestamp: z.ZodString;
+}, z.core.$strip>;
+export type RecoveryEntry = z.infer<typeof RecoveryEntrySchema>;
+/**
+ * Accumulated retry cost data for a pipeline run.
+ *
+ * `per_story` maps story_key → sum of all RecoveryEntry.cost_usd for that
+ * story. It does NOT include the initial dispatch cost, which is tracked in
+ * `PerStoryState.cost_usd`.
+ *
+ * `run_total` is the sum of all RecoveryEntry.cost_usd values in the run
+ * (i.e., total retry cost only, not total run cost).
+ *
+ * An empty `{ per_story: {}, run_total: 0 }` is the valid initial value.
+ */
+export declare const CostAccumulationSchema: z.ZodObject<{
+    per_story: z.ZodRecord<z.ZodString, z.ZodNumber>;
+    run_total: z.ZodNumber;
+}, z.core.$strip>;
+export type CostAccumulation = z.infer<typeof CostAccumulationSchema>;
+//# sourceMappingURL=recovery-history.d.ts.map

package/dist/run-model/recovery-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-history.d.ts","sourceRoot":"","sources":["../../src/run-model/recovery-history.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,iHAKhC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAMnE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;iBAe9B,CAAA;AAEF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAM/D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,sBAAsB;;;iBAYjC,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA"}