@sun-asterisk/sungen 3.1.2-beta.117 → 3.1.2-beta.118

package/dist/cli/commands/context.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+/**
+ * `sungen context` — run the Discover → Contextualize phase (AO-3) for a unit and emit the
+ * normalized Context + generation-unit work-list. The `/sungen:design` loop calls this first so it
+ * knows WHAT to generate (the endpoints/screens + their modes) before authoring scenarios. Pure +
+ * deterministic; writes `.sungen/reports/<unit>-context.json`.
+ */
+export declare function registerContextCommand(program: Command): void;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/commands/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuC7D"}

package/dist/cli/commands/context.js

@@ -0,0 +1,90 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerContextCommand = registerContextCommand;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const context_discovery_1 = require("../../orchestrator/context-discovery");
+/**
+ * `sungen context` — run the Discover → Contextualize phase (AO-3) for a unit and emit the
+ * normalized Context + generation-unit work-list. The `/sungen:design` loop calls this first so it
+ * knows WHAT to generate (the endpoints/screens + their modes) before authoring scenarios. Pure +
+ * deterministic; writes `.sungen/reports/<unit>-context.json`.
+ */
+function registerContextCommand(program) {
+    program
+        .command('context')
+        .description('Discover + contextualize a unit (screen/flow/api area) → Context + generation units')
+        .option('-s, --screen <name>', 'Screen name')
+        .option('--flow <name>', 'Flow name (resolved as flows/<name>)')
+        .option('--api <name>', 'API-first area or api flow (resolved as api/<name>)')
+        .option('--json', 'Print the raw JSON')
+        .action(async (o) => {
+        try {
+            const unitId = o.api ? `api/${o.api}` : o.flow ? `flows/${o.flow}` : o.screen;
+            if (!unitId)
+                throw new Error('Provide --screen <name>, --flow <name>, or --api <area>.');
+            const cwd = process.cwd();
+            const result = await (0, context_discovery_1.discoverUnitContext)(unitId, cwd);
+            const outDir = path.join(cwd, '.sungen', 'reports');
+            fs.mkdirSync(outDir, { recursive: true });
+            const slug = unitId.replace(/\//g, '-');
+            const outPath = path.join(outDir, `${slug}-context.json`);
+            fs.writeFileSync(outPath, JSON.stringify(result, null, 2), 'utf-8');
+            if (o.json) {
+                console.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            const L = console.log;
+            const facts = result.context.facts;
+            L(`\n━━━ Context: ${unitId} (capability: ${result.capability}) ━━━`);
+            const srcKeys = Object.keys(result.context.sources);
+            L(`  Sources: ${srcKeys.length ? srcKeys.join(', ') : '(none)'}`);
+            if (facts.endpoints?.length) {
+                L(`  Endpoints (${facts.endpoints.length}):`);
+                for (const e of facts.endpoints)
+                    L(`     • ${e.method} ${e.path}  (@api:${e.name})`);
+            }
+            const byMode = result.units.reduce((m, u) => { m[u.mode] = (m[u.mode] || 0) + 1; return m; }, {});
+            L(`  Generation units: ${result.units.length} — ${Object.entries(byMode).map(([m, n]) => `${m}×${n}`).join(' · ') || '(none)'}`);
+            L(`\n  Report: ${path.relative(cwd, outPath)}\n`);
+        }
+        catch (e) {
+            console.error('Error:', e instanceof Error ? e.message : e);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/cli/commands/context.js.map

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

package/dist/cli/index.js

@@ -27,6 +27,7 @@ const challenge_1 = require("./commands/challenge");
 const blindspot_1 = require("./commands/blindspot");
 const capability_1 = require("./commands/capability");
 const flow_check_1 = require("./commands/flow-check");
+const context_1 = require("./commands/context");
 const registry_1 = require("../capabilities/registry");
 const discover_1 = require("../capabilities/discover");
 // Read version from package.json so `--version` never drifts from the released version.
@@ -60,6 +61,7 @@ async function main() {
     (0, blindspot_1.registerBlindspotCommand)(program);
     (0, capability_1.registerCapabilityCommand)(program);
     (0, flow_check_1.registerFlowCheckCommand)(program);
+    (0, context_1.registerContextCommand)(program);
     (0, ingest_1.registerIngestCommand)(program);
     (0, eval_1.registerEvalCommand)(program);
     // Capability-contributed CLI commands (Capability SPI): drivers own their authoring commands

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;GAGG;;AAEH,yCAAoC;AACpC,0CAAsD;AACtD,wCAAoD;AACpD,kDAA8D;AAC9D,kDAA8D;AAC9D,8CAA0D;AAC1D,kDAA8D;AAC9D,4CAAwD;AACxD,kDAA6D;AAC7D,oDAAgE;AAChE,4CAAwD;AACxD,8CAA0D;AAC1D,0CAAsD;AACtD,kDAA8D;AAC9D,8CAA0D;AAC1D,kDAA8D;AAC9D,0DAAqE;AACrE,4CAAwD;AACxD,oDAAgE;AAChE,oDAAgE;AAChE,sDAAkE;AAClE,sDAAiE;AACjE,uDAA8D;AAC9D,uDAA2E;AAE3E,wFAAwF;AACxF,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEzE,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,oEAAoE,CAAC;SACjF,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,iBAAiB;IACjB,OAAO;SACJ,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IAErD,oBAAoB;IACpB,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,iCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,yCAA0B,EAAC,OAAO,CAAC,CAAC;IACpC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,sCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,qCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAE7B,6FAA6F;IAC7F,iFAAiF;IACjF,IAAA,0CAA+B,GAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,6BAAkB,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3C,KAAK,MAAM,eAAe,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE;YAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AACA;;;GAGG;;AAEH,yCAAoC;AACpC,0CAAsD;AACtD,wCAAoD;AACpD,kDAA8D;AAC9D,kDAA8D;AAC9D,8CAA0D;AAC1D,kDAA8D;AAC9D,4CAAwD;AACxD,kDAA6D;AAC7D,oDAAgE;AAChE,4CAAwD;AACxD,8CAA0D;AAC1D,0CAAsD;AACtD,kDAA8D;AAC9D,8CAA0D;AAC1D,kDAA8D;AAC9D,0DAAqE;AACrE,4CAAwD;AACxD,oDAAgE;AAChE,oDAAgE;AAChE,sDAAkE;AAClE,sDAAiE;AACjE,gDAA4D;AAC5D,uDAA8D;AAC9D,uDAA2E;AAE3E,wFAAwF;AACxF,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEzE,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,QAAQ,CAAC;SACd,WAAW,CAAC,oEAAoE,CAAC;SACjF,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,iBAAiB;IACjB,OAAO;SACJ,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC,CAAC;IAErD,oBAAoB;IACpB,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAC7B,IAAA,wBAAkB,EAAC,OAAO,CAAC,CAAC;IAC5B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,iCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,kCAAuB,EAAC,OAAO,CAAC,CAAC;IACjC,IAAA,yCAA0B,EAAC,OAAO,CAAC,CAAC;IACpC,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;IAC9B,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,oCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,sCAAyB,EAAC,OAAO,CAAC,CAAC;IACnC,IAAA,qCAAwB,EAAC,OAAO,CAAC,CAAC;IAClC,IAAA,gCAAsB,EAAC,OAAO,CAAC,CAAC;IAChC,IAAA,8BAAqB,EAAC,OAAO,CAAC,CAAC;IAC/B,IAAA,0BAAmB,EAAC,OAAO,CAAC,CAAC;IAE7B,6FAA6F;IAC7F,iFAAiF;IACjF,IAAA,0CAA+B,GAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,6BAAkB,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3C,KAAK,MAAM,eAAe,IAAI,GAAG,CAAC,WAAW,IAAI,EAAE;YAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAChF,CAAC;IAED,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -7,6 +7,8 @@ export { capabilityRegistry, CapabilityRegistry } from './capabilities/registry'
 export type { CapabilityDescriptor } from './capabilities/registry';
 export type { Sensor, SensorFinding, AdvisoryScanInput, GateInput } from './capabilities/sensor';
 export type { Context, DiscoveryProvider, ContextMapper, GenerationUnit } from './capabilities/context';
+export { discoverUnitContext } from './orchestrator/context-discovery';
+export type { DiscoveredContext } from './orchestrator/context-discovery';
 export type { PatternContext, StepPattern, StepTemplateData } from './generators/test-generator/patterns/types';
 export type { MappedStep } from './generators/test-generator/step-mapper';
 export type { ParsedStep } from './generators/gherkin-parser';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACjG,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxG,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAChH,YAAY,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAGhH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChI,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACjF,YAAY,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACjG,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxG,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAG1E,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAChH,YAAY,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAGhH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAClF,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAI1D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChI,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -5,11 +5,13 @@
  * imports from a driver (discovery loads them at runtime). Keep this surface small and intentional.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.depthWarnOnly = exports.depthThresholdFor = exports.dataThemesFor = exports.assertionDepth = exports.viewpointGate = exports.loadCatalog = exports.lintCatalog = exports.compileQuery = exports.resolveQuery = exports.parseQueryOverrides = exports.resolvePathVariables = exports.inferPath = exports.getPathCode = exports.CapabilityRegistry = exports.capabilityRegistry = void 0;
+exports.depthWarnOnly = exports.depthThresholdFor = exports.dataThemesFor = exports.assertionDepth = exports.viewpointGate = exports.loadCatalog = exports.lintCatalog = exports.compileQuery = exports.resolveQuery = exports.parseQueryOverrides = exports.resolvePathVariables = exports.inferPath = exports.getPathCode = exports.discoverUnitContext = exports.CapabilityRegistry = exports.capabilityRegistry = void 0;
 // --- Capability SPI ---
 var registry_1 = require("./capabilities/registry");
 Object.defineProperty(exports, "capabilityRegistry", { enumerable: true, get: function () { return registry_1.capabilityRegistry; } });
 Object.defineProperty(exports, "CapabilityRegistry", { enumerable: true, get: function () { return registry_1.CapabilityRegistry; } });
+var context_discovery_1 = require("./orchestrator/context-discovery");
+Object.defineProperty(exports, "discoverUnitContext", { enumerable: true, get: function () { return context_discovery_1.discoverUnitContext; } });
 var path_inference_1 = require("./generators/test-generator/utils/path-inference");
 Object.defineProperty(exports, "getPathCode", { enumerable: true, get: function () { return path_inference_1.getPathCode; } });
 Object.defineProperty(exports, "inferPath", { enumerable: true, get: function () { return path_inference_1.inferPath; } });

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,yBAAyB;AACzB,oDAAiF;AAAxE,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAS/C,mFAAgH;AAAvG,6GAAA,WAAW,OAAA;AAAE,2GAAA,SAAS,OAAA;AAAE,sHAAA,oBAAoB,OAAA;AAErD,gGAAgG;AAChG,uEAAqE;AAA5D,2HAAA,mBAAmB,OAAA;AAE5B,mGAAmG;AACnG,yDAAkF;AAAzE,6GAAA,YAAY,OAAA;AAAE,6GAAA,YAAY,OAAA;AAAE,4GAAA,WAAW,OAAA;AAGhD,8EAA8E;AAC9E,mGAAmG;AACnG,6CAAgI;AAAvH,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,wGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,yBAAyB;AACzB,oDAAiF;AAAxE,8GAAA,kBAAkB,OAAA;AAAE,8GAAA,kBAAkB,OAAA;AAI/C,sEAAuE;AAA9D,wHAAA,mBAAmB,OAAA;AAO5B,mFAAgH;AAAvG,6GAAA,WAAW,OAAA;AAAE,2GAAA,SAAS,OAAA;AAAE,sHAAA,oBAAoB,OAAA;AAErD,gGAAgG;AAChG,uEAAqE;AAA5D,2HAAA,mBAAmB,OAAA;AAE5B,mGAAmG;AACnG,yDAAkF;AAAzE,6GAAA,YAAY,OAAA;AAAE,6GAAA,YAAY,OAAA;AAAE,4GAAA,WAAW,OAAA;AAGhD,8EAA8E;AAC9E,mGAAmG;AACnG,6CAAgI;AAAvH,sGAAA,WAAW,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,yGAAA,cAAc,OAAA;AAAE,wGAAA,aAAa,OAAA;AAAE,4GAAA,iBAAiB,OAAA;AAAE,wGAAA,aAAa,OAAA"}

package/dist/orchestrator/context-discovery.d.ts

@@ -0,0 +1,12 @@
+import type { Context, GenerationUnit } from '../capabilities/context';
+export interface DiscoveredContext {
+    capability: string;
+    context: Context;
+    units: GenerationUnit[];
+}
+/**
+ * Run the Discover → Contextualize phase for a unit. `unitId` is the catalog-resolution id
+ * (`<screen>` · `flows/<flow>` · `api/<area>` · `api/flows/<flow>`).
+ */
+export declare function discoverUnitContext(unitId: string, cwd?: string): Promise<DiscoveredContext>;
+//# sourceMappingURL=context-discovery.d.ts.map

package/dist/orchestrator/context-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-discovery.d.ts","sourceRoot":"","sources":["../../src/orchestrator/context-discovery.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AASD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmBjH"}

package/dist/orchestrator/context-discovery.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverUnitContext = discoverUnitContext;
+/**
+ * Orchestration phase: Discover → Contextualize (AO-3).
+ *
+ * The capability SPI declared `discovery` (sources → Context slice) + `contextMapper` (Context →
+ * generation units) since R1, but nothing consumed them. This is the deterministic consumer the
+ * orchestration loop (`/sungen:design`) calls before generating: resolve the unit's capability,
+ * run ITS discovery + contextMapper, and hand back the normalized Context + the generation-unit
+ * work-list. Capability-agnostic — a screen, an api area, or a future `mobile/` unit all flow here.
+ */
+const registry_1 = require("../capabilities/registry");
+const discover_1 = require("../capabilities/discover");
+/** Map a unit id (relative to qa/) to a discovery target. */
+function targetForUnit(unitId) {
+    if (unitId.startsWith('api/'))
+        return { kind: 'api', id: unitId };
+    if (unitId.startsWith('flows/'))
+        return { kind: 'flow', id: unitId };
+    return { kind: 'screen', id: unitId };
+}
+/**
+ * Run the Discover → Contextualize phase for a unit. `unitId` is the catalog-resolution id
+ * (`<screen>` · `flows/<flow>` · `api/<area>` · `api/flows/<flow>`).
+ */
+async function discoverUnitContext(unitId, cwd = process.cwd()) {
+    (0, discover_1.discoverAndRegisterCapabilities)();
+    const target = targetForUnit(unitId);
+    // The discovering capability is the first whose DiscoveryProvider claims the target; else the default.
+    const cap = registry_1.capabilityRegistry.all().find((c) => c.discovery?.appliesTo?.(target))
+        ?? (registry_1.capabilityRegistry.defaultCapabilityId() ? registry_1.capabilityRegistry.get(registry_1.capabilityRegistry.defaultCapabilityId()) : undefined);
+    let context = { target: { ...target, capability: cap?.id }, sources: {}, facts: {} };
+    if (cap?.discovery) {
+        const slice = await cap.discovery.discover(target, { cwd });
+        context = {
+            target: { ...target, capability: cap.id },
+            sources: { ...context.sources, ...(slice.sources ?? {}) },
+            facts: { ...context.facts, ...(slice.facts ?? {}) },
+            ...(slice.connectivity ? { connectivity: slice.connectivity } : {}),
+        };
+    }
+    const units = cap?.contextMapper?.decompose(context) ?? [];
+    return { capability: cap?.id ?? 'ui', context, units };
+}
+//# sourceMappingURL=context-discovery.js.map

package/dist/orchestrator/context-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-discovery.js","sourceRoot":"","sources":["../../src/orchestrator/context-discovery.ts"],"names":[],"mappings":";;AA8BA,kDAmBC;AAjDD;;;;;;;;GAQG;AACH,uDAA8D;AAC9D,uDAA2E;AAS3E,6DAA6D;AAC7D,SAAS,aAAa,CAAC,MAAc;IACnC,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAClE,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IACrE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,mBAAmB,CAAC,MAAc,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACnF,IAAA,0CAA+B,GAAE,CAAC;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,uGAAuG;IACvG,MAAM,GAAG,GAAG,6BAAkB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC;WAC7E,CAAC,6BAAkB,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,6BAAkB,CAAC,GAAG,CAAC,6BAAkB,CAAC,mBAAmB,EAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEhI,IAAI,OAAO,GAAY,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC9F,IAAI,GAAG,EAAE,SAAS,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5D,OAAO,GAAG;YACR,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,EAAE,EAAE;YACzC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;YACzD,KAAK,EAAE,EAAE,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;YACnD,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpE,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,IAAI,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACzD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sun-asterisk/sungen",
-  "version": "3.1.2-beta.117",
+  "version": "3.1.2-beta.118",
   "description": "Deterministic E2E Test Compiler - Gherkin + Selectors → Playwright tests",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -33,7 +33,7 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@sungen/driver-ui": "3.1.2-beta.117",
+    "@sungen/driver-ui": "3.1.2-beta.118",
     "@anthropic-ai/sdk": "^0.71.0",
     "@babel/parser": "^7.28.5",
     "@babel/traverse": "^7.28.5",

package/src/cli/commands/context.ts

@@ -0,0 +1,51 @@
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { discoverUnitContext } from '../../orchestrator/context-discovery';
+
+/**
+ * `sungen context` — run the Discover → Contextualize phase (AO-3) for a unit and emit the
+ * normalized Context + generation-unit work-list. The `/sungen:design` loop calls this first so it
+ * knows WHAT to generate (the endpoints/screens + their modes) before authoring scenarios. Pure +
+ * deterministic; writes `.sungen/reports/<unit>-context.json`.
+ */
+export function registerContextCommand(program: Command): void {
+  program
+    .command('context')
+    .description('Discover + contextualize a unit (screen/flow/api area) → Context + generation units')
+    .option('-s, --screen <name>', 'Screen name')
+    .option('--flow <name>', 'Flow name (resolved as flows/<name>)')
+    .option('--api <name>', 'API-first area or api flow (resolved as api/<name>)')
+    .option('--json', 'Print the raw JSON')
+    .action(async (o: { screen?: string; flow?: string; api?: string; json?: boolean }) => {
+      try {
+        const unitId = o.api ? `api/${o.api}` : o.flow ? `flows/${o.flow}` : o.screen;
+        if (!unitId) throw new Error('Provide --screen <name>, --flow <name>, or --api <area>.');
+        const cwd = process.cwd();
+        const result = await discoverUnitContext(unitId, cwd);
+
+        const outDir = path.join(cwd, '.sungen', 'reports');
+        fs.mkdirSync(outDir, { recursive: true });
+        const slug = unitId.replace(/\//g, '-');
+        const outPath = path.join(outDir, `${slug}-context.json`);
+        fs.writeFileSync(outPath, JSON.stringify(result, null, 2), 'utf-8');
+        if (o.json) { console.log(JSON.stringify(result, null, 2)); return; }
+
+        const L = console.log;
+        const facts = result.context.facts as { endpoints?: Array<{ name: string; method: string; path: string }> };
+        L(`\n━━━ Context: ${unitId} (capability: ${result.capability}) ━━━`);
+        const srcKeys = Object.keys(result.context.sources);
+        L(`  Sources: ${srcKeys.length ? srcKeys.join(', ') : '(none)'}`);
+        if (facts.endpoints?.length) {
+          L(`  Endpoints (${facts.endpoints.length}):`);
+          for (const e of facts.endpoints) L(`     • ${e.method} ${e.path}  (@api:${e.name})`);
+        }
+        const byMode = result.units.reduce<Record<string, number>>((m, u) => { m[u.mode] = (m[u.mode] || 0) + 1; return m; }, {});
+        L(`  Generation units: ${result.units.length} — ${Object.entries(byMode).map(([m, n]) => `${m}×${n}`).join(' · ') || '(none)'}`);
+        L(`\n  Report: ${path.relative(cwd, outPath)}\n`);
+      } catch (e) {
+        console.error('Error:', e instanceof Error ? e.message : e);
+        process.exit(1);
+      }
+    });
+}

package/src/cli/index.ts

@@ -26,6 +26,7 @@ import { registerChallengeCommand } from './commands/challenge';
 import { registerBlindspotCommand } from './commands/blindspot';
 import { registerCapabilityCommand } from './commands/capability';
 import { registerFlowCheckCommand } from './commands/flow-check';
+import { registerContextCommand } from './commands/context';
 import { capabilityRegistry } from '../capabilities/registry';
 import { discoverAndRegisterCapabilities } from '../capabilities/discover';
 
@@ -64,6 +65,7 @@ async function main() {
   registerBlindspotCommand(program);
   registerCapabilityCommand(program);
   registerFlowCheckCommand(program);
+  registerContextCommand(program);
   registerIngestCommand(program);
   registerEvalCommand(program);
 

package/src/index.ts

@@ -9,6 +9,8 @@ export { capabilityRegistry, CapabilityRegistry } from './capabilities/registry'
 export type { CapabilityDescriptor } from './capabilities/registry';
 export type { Sensor, SensorFinding, AdvisoryScanInput, GateInput } from './capabilities/sensor';
 export type { Context, DiscoveryProvider, ContextMapper, GenerationUnit } from './capabilities/context';
+export { discoverUnitContext } from './orchestrator/context-discovery';
+export type { DiscoveredContext } from './orchestrator/context-discovery';
 
 // --- Step-pattern authoring (a driver contributes step patterns via its descriptor) ---
 export type { PatternContext, StepPattern, StepTemplateData } from './generators/test-generator/patterns/types';

package/src/orchestrator/context-discovery.ts

@@ -0,0 +1,50 @@
+/**
+ * Orchestration phase: Discover → Contextualize (AO-3).
+ *
+ * The capability SPI declared `discovery` (sources → Context slice) + `contextMapper` (Context →
+ * generation units) since R1, but nothing consumed them. This is the deterministic consumer the
+ * orchestration loop (`/sungen:design`) calls before generating: resolve the unit's capability,
+ * run ITS discovery + contextMapper, and hand back the normalized Context + the generation-unit
+ * work-list. Capability-agnostic — a screen, an api area, or a future `mobile/` unit all flow here.
+ */
+import { capabilityRegistry } from '../capabilities/registry';
+import { discoverAndRegisterCapabilities } from '../capabilities/discover';
+import type { Context, GenerationUnit } from '../capabilities/context';
+
+export interface DiscoveredContext {
+  capability: string;
+  context: Context;
+  units: GenerationUnit[];
+}
+
+/** Map a unit id (relative to qa/) to a discovery target. */
+function targetForUnit(unitId: string): Context['target'] {
+  if (unitId.startsWith('api/')) return { kind: 'api', id: unitId };
+  if (unitId.startsWith('flows/')) return { kind: 'flow', id: unitId };
+  return { kind: 'screen', id: unitId };
+}
+
+/**
+ * Run the Discover → Contextualize phase for a unit. `unitId` is the catalog-resolution id
+ * (`<screen>` · `flows/<flow>` · `api/<area>` · `api/flows/<flow>`).
+ */
+export async function discoverUnitContext(unitId: string, cwd: string = process.cwd()): Promise<DiscoveredContext> {
+  discoverAndRegisterCapabilities();
+  const target = targetForUnit(unitId);
+  // The discovering capability is the first whose DiscoveryProvider claims the target; else the default.
+  const cap = capabilityRegistry.all().find((c) => c.discovery?.appliesTo?.(target))
+    ?? (capabilityRegistry.defaultCapabilityId() ? capabilityRegistry.get(capabilityRegistry.defaultCapabilityId()!) : undefined);
+
+  let context: Context = { target: { ...target, capability: cap?.id }, sources: {}, facts: {} };
+  if (cap?.discovery) {
+    const slice = await cap.discovery.discover(target, { cwd });
+    context = {
+      target: { ...target, capability: cap.id },
+      sources: { ...context.sources, ...(slice.sources ?? {}) },
+      facts: { ...context.facts, ...(slice.facts ?? {}) },
+      ...(slice.connectivity ? { connectivity: slice.connectivity } : {}),
+    };
+  }
+  const units = cap?.contextMapper?.decompose(context) ?? [];
+  return { capability: cap?.id ?? 'ui', context, units };
+}