@substrate-ai/core 0.19.54

package/dist/persistence/schemas/decisions.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Zod schemas for the decision store persistence layer.
+ *
+ * Provides validation schemas for all decision store entities and their
+ * inferred TypeScript types.
+ */
+import { z } from 'zod';
+export declare const PhaseEnum: z.ZodEnum<{
+    analysis: "analysis";
+    planning: "planning";
+    solutioning: "solutioning";
+    implementation: "implementation";
+}>;
+export type Phase = z.infer<typeof PhaseEnum>;
+export declare const RequirementPriorityEnum: z.ZodEnum<{
+    must: "must";
+    should: "should";
+    could: "could";
+    wont: "wont";
+}>;
+export type RequirementPriority = z.infer<typeof RequirementPriorityEnum>;
+export declare const RequirementTypeEnum: z.ZodEnum<{
+    functional: "functional";
+    non_functional: "non_functional";
+    constraint: "constraint";
+}>;
+export type RequirementType = z.infer<typeof RequirementTypeEnum>;
+export declare const PipelineRunStatusEnum: z.ZodEnum<{
+    running: "running";
+    completed: "completed";
+    failed: "failed";
+    paused: "paused";
+    stopped: "stopped";
+}>;
+export type PipelineRunStatus = z.infer<typeof PipelineRunStatusEnum>;
+export declare const DecisionSchema: z.ZodObject<{
+    id: z.ZodString;
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phase: z.ZodString;
+    category: z.ZodString;
+    key: z.ZodString;
+    value: z.ZodString;
+    rationale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Decision = z.infer<typeof DecisionSchema>;
+export declare const CreateDecisionInputSchema: z.ZodObject<{
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phase: z.ZodString;
+    category: z.ZodString;
+    key: z.ZodString;
+    value: z.ZodString;
+    rationale: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type CreateDecisionInput = z.infer<typeof CreateDecisionInputSchema>;
+export declare const RequirementSchema: z.ZodObject<{
+    id: z.ZodString;
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodString;
+    type: z.ZodEnum<{
+        functional: "functional";
+        non_functional: "non_functional";
+        constraint: "constraint";
+    }>;
+    description: z.ZodString;
+    priority: z.ZodEnum<{
+        must: "must";
+        should: "should";
+        could: "could";
+        wont: "wont";
+    }>;
+    status: z.ZodDefault<z.ZodString>;
+    created_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Requirement = z.infer<typeof RequirementSchema>;
+export declare const CreateRequirementInputSchema: z.ZodObject<{
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    source: z.ZodString;
+    type: z.ZodEnum<{
+        functional: "functional";
+        non_functional: "non_functional";
+        constraint: "constraint";
+    }>;
+    description: z.ZodString;
+    priority: z.ZodEnum<{
+        must: "must";
+        should: "should";
+        could: "could";
+        wont: "wont";
+    }>;
+}, z.core.$strip>;
+export type CreateRequirementInput = z.infer<typeof CreateRequirementInputSchema>;
+export declare const ConstraintSchema: z.ZodObject<{
+    id: z.ZodString;
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    category: z.ZodString;
+    description: z.ZodString;
+    source: z.ZodString;
+    created_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Constraint = z.infer<typeof ConstraintSchema>;
+export declare const CreateConstraintInputSchema: z.ZodObject<{
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    category: z.ZodString;
+    description: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip>;
+export type CreateConstraintInput = z.infer<typeof CreateConstraintInputSchema>;
+export declare const ArtifactSchema: z.ZodObject<{
+    id: z.ZodString;
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phase: z.ZodString;
+    type: z.ZodString;
+    path: z.ZodString;
+    content_hash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Artifact = z.infer<typeof ArtifactSchema>;
+export declare const RegisterArtifactInputSchema: z.ZodObject<{
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phase: z.ZodString;
+    type: z.ZodString;
+    path: z.ZodString;
+    content_hash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type RegisterArtifactInput = z.infer<typeof RegisterArtifactInputSchema>;
+export declare const PipelineRunSchema: z.ZodObject<{
+    id: z.ZodString;
+    methodology: z.ZodString;
+    current_phase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodEnum<{
+        running: "running";
+        completed: "completed";
+        failed: "failed";
+        paused: "paused";
+        stopped: "stopped";
+    }>;
+    config_json: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    token_usage_json: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    parent_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type PipelineRun = z.infer<typeof PipelineRunSchema>;
+export declare const CreatePipelineRunInputSchema: z.ZodObject<{
+    methodology: z.ZodString;
+    start_phase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    config_json: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type CreatePipelineRunInput = z.infer<typeof CreatePipelineRunInputSchema>;
+export declare const TokenUsageSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNumber>;
+    pipeline_run_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    phase: z.ZodString;
+    agent: z.ZodString;
+    input_tokens: z.ZodDefault<z.ZodNumber>;
+    output_tokens: z.ZodDefault<z.ZodNumber>;
+    cost_usd: z.ZodDefault<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    created_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TokenUsage = z.infer<typeof TokenUsageSchema>;
+export declare const AddTokenUsageInputSchema: z.ZodObject<{
+    phase: z.ZodString;
+    agent: z.ZodString;
+    input_tokens: z.ZodDefault<z.ZodNumber>;
+    output_tokens: z.ZodDefault<z.ZodNumber>;
+    cost_usd: z.ZodDefault<z.ZodNumber>;
+    metadata: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+export type AddTokenUsageInput = z.infer<typeof AddTokenUsageInputSchema>;
+//# sourceMappingURL=decisions.d.ts.map

package/dist/persistence/schemas/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../../src/persistence/schemas/decisions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAMvB,eAAO,MAAM,SAAS;;;;;EAAoE,CAAA;AAC1F,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA;AAE7C,eAAO,MAAM,uBAAuB;;;;;EAA8C,CAAA;AAClF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEzE,eAAO,MAAM,mBAAmB;;;;EAAyD,CAAA;AACzF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAEjE,eAAO,MAAM,qBAAqB;;;;;;EAAkE,CAAA;AACpG,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAMrE,eAAO,MAAM,cAAc;;;;;;;;;;;iBAWzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,yBAAyB;;;;;;;iBAOpC,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAM3E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;iBAS5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;iBAMvC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAMjF,eAAO,MAAM,gBAAgB;;;;;;;iBAO3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,2BAA2B;;;;;iBAKtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAM/E,eAAO,MAAM,cAAc;;;;;;;;;iBASzB,CAAA;AACF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAErD,eAAO,MAAM,2BAA2B;;;;;;;iBAOtC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAM/E,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;iBAU5B,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAE3D,eAAO,MAAM,4BAA4B;;;;iBAIvC,CAAA;AACF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAMjF,eAAO,MAAM,gBAAgB;;;;;;;;;;iBAW3B,CAAA;AACF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEzD,eAAO,MAAM,wBAAwB;;;;;;;iBAQnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/persistence/schemas/decisions.js

@@ -0,0 +1,139 @@
+/**
+ * Zod schemas for the decision store persistence layer.
+ *
+ * Provides validation schemas for all decision store entities and their
+ * inferred TypeScript types.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Enums
+// ---------------------------------------------------------------------------
+export const PhaseEnum = z.enum(['analysis', 'planning', 'solutioning', 'implementation']);
+export const RequirementPriorityEnum = z.enum(['must', 'should', 'could', 'wont']);
+export const RequirementTypeEnum = z.enum(['functional', 'non_functional', 'constraint']);
+export const PipelineRunStatusEnum = z.enum(['running', 'paused', 'completed', 'failed', 'stopped']);
+// ---------------------------------------------------------------------------
+// Decision
+// ---------------------------------------------------------------------------
+export const DecisionSchema = z.object({
+    id: z.string().uuid(),
+    pipeline_run_id: z.string().nullable().optional(),
+    phase: z.string().min(1),
+    category: z.string().min(1),
+    key: z.string().min(1),
+    value: z.string().min(1),
+    rationale: z.string().nullable().optional(),
+    superseded_by: z.string().nullable().optional(),
+    created_at: z.string().optional(),
+    updated_at: z.string().optional(),
+});
+export const CreateDecisionInputSchema = z.object({
+    pipeline_run_id: z.string().nullable().optional(),
+    phase: z.string().min(1),
+    category: z.string().min(1),
+    key: z.string().min(1),
+    value: z.string().min(1),
+    rationale: z.string().nullable().optional(),
+});
+// ---------------------------------------------------------------------------
+// Requirement
+// ---------------------------------------------------------------------------
+export const RequirementSchema = z.object({
+    id: z.string().uuid(),
+    pipeline_run_id: z.string().nullable().optional(),
+    source: z.string().min(1),
+    type: RequirementTypeEnum,
+    description: z.string().min(1),
+    priority: RequirementPriorityEnum,
+    status: z.string().default('active'),
+    created_at: z.string().optional(),
+});
+export const CreateRequirementInputSchema = z.object({
+    pipeline_run_id: z.string().nullable().optional(),
+    source: z.string().min(1),
+    type: RequirementTypeEnum,
+    description: z.string().min(1),
+    priority: RequirementPriorityEnum,
+});
+// ---------------------------------------------------------------------------
+// Constraint
+// ---------------------------------------------------------------------------
+export const ConstraintSchema = z.object({
+    id: z.string().uuid(),
+    pipeline_run_id: z.string().nullable().optional(),
+    category: z.string().min(1),
+    description: z.string().min(1),
+    source: z.string().min(1),
+    created_at: z.string().optional(),
+});
+export const CreateConstraintInputSchema = z.object({
+    pipeline_run_id: z.string().nullable().optional(),
+    category: z.string().min(1),
+    description: z.string().min(1),
+    source: z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// Artifact
+// ---------------------------------------------------------------------------
+export const ArtifactSchema = z.object({
+    id: z.string().uuid(),
+    pipeline_run_id: z.string().nullable().optional(),
+    phase: z.string().min(1),
+    type: z.string().min(1),
+    path: z.string().min(1),
+    content_hash: z.string().nullable().optional(),
+    summary: z.string().nullable().optional(),
+    created_at: z.string().optional(),
+});
+export const RegisterArtifactInputSchema = z.object({
+    pipeline_run_id: z.string().nullable().optional(),
+    phase: z.string().min(1),
+    type: z.string().min(1),
+    path: z.string().min(1),
+    content_hash: z.string().nullable().optional(),
+    summary: z.string().nullable().optional(),
+});
+// ---------------------------------------------------------------------------
+// PipelineRun
+// ---------------------------------------------------------------------------
+export const PipelineRunSchema = z.object({
+    id: z.string().uuid(),
+    methodology: z.string().min(1),
+    current_phase: z.string().nullable().optional(),
+    status: PipelineRunStatusEnum,
+    config_json: z.string().nullable().optional(),
+    token_usage_json: z.string().nullable().optional(),
+    parent_run_id: z.string().nullable().optional(),
+    created_at: z.string().optional(),
+    updated_at: z.string().optional(),
+});
+export const CreatePipelineRunInputSchema = z.object({
+    methodology: z.string().min(1),
+    start_phase: z.string().nullable().optional(),
+    config_json: z.string().nullable().optional(),
+});
+// ---------------------------------------------------------------------------
+// TokenUsage
+// ---------------------------------------------------------------------------
+export const TokenUsageSchema = z.object({
+    id: z.number().int().optional(),
+    pipeline_run_id: z.string().nullable().optional(),
+    phase: z.string().min(1),
+    agent: z.string().min(1),
+    input_tokens: z.number().int().min(0).default(0),
+    output_tokens: z.number().int().min(0).default(0),
+    cost_usd: z.number().min(0).default(0),
+    /** Optional JSON string containing batch context (added in migration 009) */
+    metadata: z.string().nullable().optional(),
+    created_at: z.string().optional(),
+});
+export const AddTokenUsageInputSchema = z.object({
+    phase: z.string().min(1),
+    agent: z.string().min(1),
+    input_tokens: z.number().int().min(0).default(0),
+    output_tokens: z.number().int().min(0).default(0),
+    cost_usd: z.number().min(0).default(0),
+    /** Optional JSON string for batch context (e.g., batchIndex, storyKey) */
+    metadata: z.string().nullable().optional(),
+});
+//# sourceMappingURL=decisions.js.map

package/dist/persistence/schemas/decisions.js.map

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

package/dist/persistence/schemas/operational.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Category and key-schema constants for operational findings in the decision store.
+ *
+ * These constants avoid string literals scattered across supervisor, orchestrator,
+ * and experimenter code. Import them wherever you need to insert or query
+ * operational decisions.
+ */
+/**
+ * Category for supervisor stall events and run-level summaries.
+ *
+ * Key schemas:
+ *   - Stall finding:  "stall:{storyKey}:{timestamp}"
+ *   - Run summary:    "run-summary:{runId}"
+ *
+ * Value shapes:
+ *
+ * Stall finding:
+ * ```json
+ * {
+ *   "phase": "string",                     // story phase at stall time, e.g. "code-review"
+ *   "staleness_secs": 700,
+ *   "attempt": 1,                          // restart attempt number (1-based)
+ *   "outcome": "recovered"                 // "recovered" | "failed" | "max-restarts-escalated"
+ * }
+ * ```
+ *
+ * Run summary:
+ * ```json
+ * {
+ *   "succeeded": ["1-1", "1-2"],
+ *   "failed": ["1-3"],
+ *   "escalated": [],
+ *   "total_restarts": 0,
+ *   "elapsed_seconds": 1234,
+ *   "total_input_tokens": 50000,
+ *   "total_output_tokens": 10000
+ * }
+ * ```
+ */
+export declare const OPERATIONAL_FINDING: "operational-finding";
+/**
+ * Category for supervisor experiment results.
+ *
+ * Key schema: "experiment:{runId}:{timestamp}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "target_metric": "token_regression",
+ *   "before": 12000,
+ *   "after": 9500,
+ *   "verdict": "IMPROVED",                // "IMPROVED" | "MIXED" | "REGRESSED"
+ *   "branch_name": "supervisor/experiment/abc12345-dev-story-token-regression"
+ * }
+ * ```
+ */
+export declare const EXPERIMENT_RESULT: "experiment-result";
+/**
+ * Category for per-story wall-clock and efficiency metrics.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "wall_clock_seconds": 180,
+ *   "input_tokens": 8000,
+ *   "output_tokens": 2000,
+ *   "review_cycles": 2,
+ *   "stalled": false
+ * }
+ * ```
+ */
+export declare const STORY_METRICS: "story-metrics";
+/**
+ * Category for structured escalation diagnoses.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "issueDistribution": "concentrated",
+ *   "severityProfile": "major-only",
+ *   "totalIssues": 3,
+ *   "blockerCount": 0,
+ *   "majorCount": 3,
+ *   "minorCount": 0,
+ *   "affectedFiles": ["src/foo.ts"],
+ *   "reviewCycles": 3,
+ *   "recommendedAction": "retry-targeted",
+ *   "rationale": "3 major issues concentrated in few files."
+ * }
+ * ```
+ */
+export declare const ESCALATION_DIAGNOSIS: "escalation-diagnosis";
+/**
+ * Category for per-story outcome findings (learning loop).
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "storyKey": "22-1",
+ *   "outcome": "complete",
+ *   "reviewCycles": 2,
+ *   "verdictHistory": ["NEEDS_MINOR_FIXES", "SHIP_IT"],
+ *   "recurringPatterns": ["missing error handling"]
+ * }
+ * ```
+ */
+export declare const STORY_OUTCOME: "story-outcome";
+/**
+ * Category for post-implementation test expansion findings generated per-story.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "expansion_priority": "medium",        // "low" | "medium" | "high"
+ *   "coverage_gaps": [
+ *     {
+ *       "ac_ref": "AC1",
+ *       "description": "Happy path not exercised at module boundary",
+ *       "gap_type": "missing-integration"  // "missing-e2e" | "missing-integration" | "unit-only"
+ *     }
+ *   ],
+ *   "suggested_tests": [
+ *     {
+ *       "test_name": "runFoo integration happy path",
+ *       "test_type": "integration",        // "e2e" | "integration" | "unit"
+ *       "description": "Test runFoo with real DB instance",
+ *       "target_ac": "AC1"                 // optional
+ *     }
+ *   ],
+ *   "notes": "Optional free-text notes",  // optional
+ *   "error": "Error message if fallback"  // optional — present only on graceful fallback
+ * }
+ * ```
+ */
+export declare const TEST_EXPANSION_FINDING: "test-expansion-finding";
+/**
+ * Category for pre-implementation test plans generated per-story.
+ *
+ * Key schema: "{storyKey}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "test_files": ["src/modules/foo/__tests__/foo.test.ts"],
+ *   "test_categories": ["unit", "integration"],
+ *   "coverage_notes": "AC1 covered by foo.test.ts"
+ * }
+ * ```
+ */
+export declare const TEST_PLAN: "test-plan";
+/**
+ * Category for advisory notes persisted when a code review returns LGTM_WITH_NOTES.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape:
+ * ```json
+ * {
+ *   "storyKey": "25-3",
+ *   "notes": "Consider extracting the helper into a shared module for reuse."
+ * }
+ * ```
+ */
+export declare const ADVISORY_NOTES: "advisory-notes";
+/**
+ * Category for root cause taxonomy findings persisted by the learning loop.
+ *
+ * Key schema: "{storyKey}:{runId}"
+ *
+ * Value shape: JSON-serialized `Finding` object from the learning loop, e.g.:
+ * ```json
+ * {
+ *   "id": "uuid",
+ *   "run_id": "run-abc",
+ *   "story_key": "53-5",
+ *   "root_cause": "build-failure",
+ *   "affected_files": ["src/foo.ts"],
+ *   "description": "Build failed after story dispatch",
+ *   "confidence": "high",
+ *   "created_at": "2026-04-06T00:00:00.000Z",
+ *   "expires_after_runs": 5
+ * }
+ * ```
+ */
+export declare const LEARNING_FINDING: "finding";
+//# sourceMappingURL=operational.d.ts.map

package/dist/persistence/schemas/operational.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operational.d.ts","sourceRoot":"","sources":["../../../src/persistence/schemas/operational.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,mBAAmB,EAAG,qBAA8B,CAAA;AAEjE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,iBAAiB,EAAG,mBAA4B,CAAA;AAE7D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAA;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,aAAa,EAAG,eAAwB,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,sBAAsB,EAAG,wBAAiC,CAAA;AAEvE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,EAAG,WAAoB,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,EAAG,gBAAyB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,EAAG,SAAkB,CAAA"}