substrate-ai 0.2.19 → 0.2.21

package/dist/{experimenter-CHRVkV3d.js → experimenter-bc40oi8p.js}

@@ -1,6 +1,6 @@
 import "./logger-D2fS2ccL.js";
 import { createDecision } from "./decisions-Dq4cAA2L.js";
-import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-CobuCGbM.js";
+import { EXPERIMENT_RESULT, getRunMetrics, getStoryMetricsForRun } from "./operational-CnMlvWqc.js";
 import { spawnGit } from "./git-utils-CtmrZrHS.js";
 import { spawn } from "node:child_process";
 import { join } from "node:path";
@@ -500,4 +500,4 @@ function createExperimenter(config, deps) {
 
 //#endregion
 export { createExperimenter };
-//# sourceMappingURL=experimenter-CHRVkV3d.js.map
+//# sourceMappingURL=experimenter-bc40oi8p.js.map

package/dist/index.d.ts

@@ -995,6 +995,19 @@ interface OrchestratorEvents {
     lastVerdict: string;
     reviewCycles: number;
     issues: unknown[];
+    /** Structured diagnosis with classification and recommended action (Story 22-3) */
+    diagnosis?: {
+      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 non-fatal warning occurred during story processing */
   'orchestrator:story-warn': {

package/dist/{operational-CobuCGbM.js → operational-CnMlvWqc.js}

@@ -255,7 +255,91 @@ const EXPERIMENT_RESULT = "experiment-result";
 * ```
 */
 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."
+* }
+* ```
+*/
+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"]
+* }
+* ```
+*/
+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
+* }
+* ```
+*/
+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"
+* }
+* ```
+*/
+const TEST_PLAN = "test-plan";
 
 //#endregion
-export { EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, aggregateTokenUsageForRun, aggregateTokenUsageForStory, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline, writeRunMetrics, writeStoryMetrics };
-//# sourceMappingURL=operational-CobuCGbM.js.map
+export { ESCALATION_DIAGNOSIS, EXPERIMENT_RESULT, OPERATIONAL_FINDING, STORY_METRICS, STORY_OUTCOME, TEST_EXPANSION_FINDING, TEST_PLAN, aggregateTokenUsageForRun, aggregateTokenUsageForStory, compareRunMetrics, getBaselineRunMetrics, getRunMetrics, getStoryMetricsForRun, incrementRunRestarts, listRunMetrics, tagRunAsBaseline, writeRunMetrics, writeStoryMetrics };
+//# sourceMappingURL=operational-CnMlvWqc.js.map