@zhuk/spego 0.11.0 → 0.13.0

package/dist/cli/epic-slug.js

@@ -0,0 +1,17 @@
+import { SpegoError } from '../errors.js';
+export async function assertEpicSlugActive(adapter, slug) {
+    if (adapter === null) {
+        process.stderr.write(`warning: OpenSpec change link for epic "${slug}" was not verified\n`);
+        return;
+    }
+    try {
+        await adapter.getEpic(slug);
+    }
+    catch (err) {
+        throw new SpegoError('VALIDATION_FAILED', `OpenSpec change not found or archived for epic slug: ${slug}`, {
+            slug,
+            cause: err instanceof Error ? err.message : String(err),
+        });
+    }
+}
+//# sourceMappingURL=epic-slug.js.map

package/dist/cli/epic-slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic-slug.js","sourceRoot":"","sources":["../../src/cli/epic-slug.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAA+B,EAC/B,IAAY;IAEZ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2CAA2C,IAAI,sBAAsB,CAAC,CAAC;QAC5F,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAAC,mBAAmB,EAAE,wDAAwD,IAAI,EAAE,EAAE;YACxG,IAAI;YACJ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/cli/runtime.d.ts

@@ -22,5 +22,7 @@ export declare function runCommand<T>(ctx: RuntimeContext, fn: (json: boolean) =
 /** Run a command body that needs an `ArtifactEngine`; the engine is closed on every exit path. */
 export declare function runEngineCommand<T>(ctx: RuntimeContext & {
     cwd?: string;
+    jsonOverride?: boolean;
+    validate?: () => Promise<void> | void;
 }, fn: (engine: ArtifactEngine, json: boolean) => Promise<CommandResult<T>>): Promise<void>;
 export {};

package/dist/cli/runtime.js

@@ -26,9 +26,10 @@ export async function runCommand(ctx, fn) {
 }
 /** Run a command body that needs an `ArtifactEngine`; the engine is closed on every exit path. */
 export async function runEngineCommand(ctx, fn) {
-    const json = getJsonMode(ctx.program);
+    const json = ctx.jsonOverride ?? getJsonMode(ctx.program);
     let engine;
     try {
+        await ctx.validate?.();
         engine = await ArtifactEngine.open({ projectRoot: ctx.cwd });
     }
     catch (err) {

package/dist/cli/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAWnC,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC1C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,IAAe,CAAC;AACxC,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAmB,EACnB,EAAgD;IAEhD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAsC,EACtC,EAAwE;IAExE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAClB,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/cli/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAWnC,MAAM,UAAU,WAAW,CAAC,OAAgB;IAC3C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC,IAAe,CAAC;AACvC,CAAC;AAED,iEAAiE;AACjE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC/B,GAAmB,EACnB,EAAgD;IAEhD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,CAAC;QACJ,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjB,CAAC;AACF,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,GAAqG,EACrG,EAAwE;IAExE,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,IAAI,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC1D,IAAI,MAAsB,CAAC;IAC3B,IAAI,CAAC;QACJ,MAAM,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;QACvB,MAAM,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjB,CAAC;YAAS,CAAC;QACV,MAAM,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;AACF,CAAC"}

package/dist/cli.js

@@ -19,6 +19,7 @@ import { registerView } from './cli/commands/view.js';
 import { registerIndex } from './cli/commands/index-rebuild.js';
 import { registerSkills } from './cli/commands/skills.js';
 import { registerDelivery } from './cli/commands/delivery.js';
+import { registerMirror } from './cli/commands/mirror.js';
 export function buildProgram() {
     const program = new Command();
     program
@@ -49,6 +50,7 @@ export function buildProgram() {
     registerIndex(program);
     registerSkills(program);
     registerDelivery(program);
+    registerMirror(program);
     return program;
 }
 /**

package/dist/cli.js.map

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

package/dist/{commands → command-meta}/registry.js

@@ -140,6 +140,17 @@ export const COMMAND_REGISTRY = [
         inputSchema: {},
         outputModes: ['markdown', 'json'],
     },
+    {
+        name: 'mirror',
+        description: 'Show delivery mirror board',
+        slashName: '/spego:mirror',
+        category: 'planning',
+        inputSchema: {
+            graph: { name: 'graph', type: 'boolean', required: false, description: 'Show dependency graph' },
+            gaps: { name: 'gaps', type: 'boolean', required: false, description: 'Show gaps, missing artifacts, and blockers' },
+        },
+        outputModes: ['markdown', 'json'],
+    },
 ];
 export function getCommandByName(name) {
     return COMMAND_REGISTRY.find((c) => c.name === name);

package/dist/command-meta/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/command-meta/registry.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAa/D,MAAM,CAAC,MAAM,gBAAgB,GAAkB;IAC7C;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,uDAAuD;QACpE,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE;YACX,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,0CAA0C,EAAE;YACpH,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,6CAA6C,EAAE;YACtH,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE;SAC7F;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,oBAAoB;QACjC,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE;YACX,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0CAA0C,EAAE;YAC/G,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACvF,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE;YAC9F,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE;YAC5F,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gCAAgC,EAAE;YAC9G,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,yBAAyB,EAAE;SAC9F;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;QACjC,aAAa,EAAE,CAAC,GAAG,sBAAsB,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,qCAAqC;QAClD,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE;YACX,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE;YAC/E,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACnG,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,6BAA6B,EAAE;YACnG,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,qCAAqC,EAAE;YAC3G,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE;SACzG;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;QACjC,aAAa,EAAE,CAAC,GAAG,sBAAsB,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kCAAkC;QAC/C,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE;YACX,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE;YAC9E,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE;YACnF,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE;YACzF,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE;YACnG,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gCAAgC,EAAE;YACpG,gBAAgB,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,oDAAoD,EAAE;SACnJ;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;QACjC,aAAa,EAAE,CAAC,GAAG,sBAAsB,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,yBAAyB;QACtC,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE;YACX,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE;SAC/E;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;QACjC,aAAa,EAAE,CAAC,GAAG,sBAAsB,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gBAAgB;QAC7B,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE;YACX,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACtF,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC5H;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;QACjC,aAAa,EAAE,CAAC,GAAG,sBAAsB,CAAC;KAC3C;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,4CAA4C;QACzD,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE;YACX,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE;YACtF,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,4BAA4B,EAAE;YAC9F,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mCAAmC,EAAE;YACjH,cAAc,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gCAAgC,EAAE;YAC3H,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gCAAgC,EAAE;SAC3G;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,yBAAyB;QACtC,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,0CAA0C;QACvD,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE;YACX,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE;SACnF;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,YAAY;QACzB,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,yBAAyB;QACtC,SAAS,EAAE,cAAc;QACzB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE;YACX,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qBAAqB,EAAE;SAC/F;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gCAAgC;QAC7C,SAAS,EAAE,kBAAkB;QAC7B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4BAA4B;QACzC,SAAS,EAAE,eAAe;QAC1B,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE;YACX,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAChG,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,4CAA4C,EAAE;SACpH;QACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;KAClC;CACF,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AACvD,CAAC"}

package/dist/delivery/mirror.d.ts

@@ -0,0 +1,62 @@
+import type { DeliveryStatus } from './types.js';
+export type WarningCode = 'dangling-dep' | 'dep-cycle' | 'ungroomed-change' | 'orphan-epic' | 'archived-in-sprint' | 'closable-sprint' | 'adapter-warning' | 'adapter-unavailable';
+export interface MirrorWarning {
+    code: WarningCode;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface MirrorArtifact {
+    id: string;
+    type: string;
+    slug: string;
+    title: string;
+    meta: Record<string, unknown>;
+}
+export interface MirrorSourceChange {
+    slug: string;
+    title: string;
+    status: DeliveryStatus;
+    archived?: boolean;
+    warnings?: string[];
+}
+export interface MirrorInput {
+    changes: MirrorSourceChange[];
+    epics: MirrorArtifact[];
+    sprints: MirrorArtifact[];
+    linkedArtifacts?: MirrorArtifact[];
+    warnings?: MirrorWarning[];
+}
+export interface MirrorGap {
+    flag: string;
+    note?: string;
+}
+export interface MirrorChange {
+    slug: string;
+    title: string;
+    status: DeliveryStatus;
+    blockers: string[];
+    gaps: MirrorGap[];
+    missing: string[];
+    warnings: WarningCode[];
+}
+export interface MirrorSprint {
+    slug: string;
+    title: string;
+    status: string;
+    startDate: string | null;
+    endDate: string | null;
+    changes: MirrorChange[];
+}
+export interface MirrorNext {
+    change: string;
+    sprint: string;
+    reason: string;
+}
+export interface MirrorBoard {
+    sprints: MirrorSprint[];
+    ungrouped: MirrorChange[];
+    warnings: MirrorWarning[];
+    next: MirrorNext | null;
+}
+export declare function deriveMirror(input: MirrorInput): MirrorBoard;
+export declare function filterMirrorGaps(board: MirrorBoard): MirrorBoard;

package/dist/delivery/mirror.js

@@ -0,0 +1,466 @@
+const ISO_DATE_PREFIX = /^\d{4}-\d{2}-\d{2}(T.*)?$/;
+const STATUS_VALUES = {
+    active: true,
+    completed: true,
+    'planning-incomplete': true,
+    unknown: true,
+};
+const WARNING_ORDER = {
+    'adapter-unavailable': 0,
+    'adapter-warning': 1,
+    'archived-in-sprint': 2,
+    'closable-sprint': 3,
+    'dangling-dep': 4,
+    'dep-cycle': 5,
+    'orphan-epic': 6,
+    'ungroomed-change': 7,
+};
+export function deriveMirror(input) {
+    const sortedChanges = [...input.changes].sort((a, b) => a.slug.localeCompare(b.slug));
+    const sortedEpics = sortArtifacts(input.epics);
+    const sortedSprintArtifacts = sortArtifacts(input.sprints);
+    const linkedById = new Map((input.linkedArtifacts ?? []).map((artifact) => [artifact.id, artifact]));
+    const inputChangeBySlug = new Map(sortedChanges.map((item) => [item.slug, item]));
+    const epicsBySlug = new Map(sortedEpics.map((item) => [item.slug, item]));
+    const changeStates = new Map();
+    for (const item of sortedChanges) {
+        changeStates.set(item.slug, {
+            slug: item.slug,
+            title: item.title,
+            status: item.archived ? 'completed' : item.status,
+            archived: item.archived === true,
+        });
+    }
+    for (const epic of sortedEpics) {
+        const current = changeStates.get(epic.slug);
+        if (current) {
+            current.title = epic.title;
+            current.epic = epic;
+            continue;
+        }
+        changeStates.set(epic.slug, {
+            slug: epic.slug,
+            title: epic.title,
+            status: statusFromMeta(epic.meta),
+            archived: false,
+            epic,
+        });
+    }
+    const sprints = sortedSprintArtifacts.map((artifact) => toSprintPlan(artifact));
+    sprints.sort(compareSprints);
+    sprints.forEach((sprint, index) => {
+        sprint.order = index;
+    });
+    const scheduled = new Set();
+    const scheduleBySlug = new Map();
+    for (const sprint of sprints) {
+        for (const slug of sprint.changes) {
+            scheduled.add(slug);
+            const current = scheduleBySlug.get(slug);
+            if (current === undefined || sprint.order < current)
+                scheduleBySlug.set(slug, sprint.order);
+            if (!changeStates.has(slug)) {
+                const discovered = inputChangeBySlug.get(slug);
+                changeStates.set(slug, {
+                    slug,
+                    title: discovered?.title ?? slug,
+                    status: discovered?.archived ? 'completed' : discovered?.status ?? 'unknown',
+                    archived: discovered?.archived === true,
+                    epic: epicsBySlug.get(slug),
+                });
+            }
+        }
+    }
+    const knownSlugs = new Set(changeStates.keys());
+    const depsBySlug = new Map();
+    for (const [slug, state] of [...changeStates].sort((a, b) => a[0].localeCompare(b[0]))) {
+        depsBySlug.set(slug, uniqueStrings(state.epic?.meta.deps));
+    }
+    const cycleMembers = findCycleMembers([...knownSlugs].sort(), depsBySlug, knownSlugs);
+    const warnings = [...(input.warnings ?? [])];
+    for (const source of sortedChanges) {
+        for (const warning of source.warnings ?? []) {
+            warnings.push({
+                code: 'adapter-warning',
+                message: `${source.slug}: ${warning}`,
+                details: { change: source.slug, warning },
+            });
+        }
+    }
+    for (const source of sortedChanges) {
+        if (source.archived)
+            continue;
+        if (epicsBySlug.has(source.slug))
+            continue;
+        warnings.push({
+            code: 'ungroomed-change',
+            message: `Active change "${source.slug}" has no epic artifact.`,
+            details: { change: source.slug },
+        });
+    }
+    for (const epic of sortedEpics) {
+        const source = inputChangeBySlug.get(epic.slug);
+        if (!source) {
+            warnings.push({
+                code: 'orphan-epic',
+                message: `Epic "${epic.slug}" does not resolve to an OpenSpec change.`,
+                details: { change: epic.slug, reason: 'missing' },
+            });
+            continue;
+        }
+        if (source.archived) {
+            warnings.push({
+                code: 'orphan-epic',
+                message: `Epic "${epic.slug}" points at an archived OpenSpec change.`,
+                details: { change: epic.slug, reason: 'archived' },
+            });
+        }
+    }
+    for (const sprint of sprints) {
+        for (const slug of sprint.changes) {
+            if (!inputChangeBySlug.get(slug)?.archived)
+                continue;
+            warnings.push({
+                code: 'archived-in-sprint',
+                message: `Sprint "${sprint.artifact.slug}" includes archived change "${slug}".`,
+                details: { sprint: sprint.artifact.slug, change: slug },
+            });
+        }
+    }
+    for (const [slug, deps] of [...depsBySlug].sort((a, b) => a[0].localeCompare(b[0]))) {
+        for (const dep of deps) {
+            if (knownSlugs.has(dep))
+                continue;
+            warnings.push({
+                code: 'dangling-dep',
+                message: `Change "${slug}" depends on unknown change "${dep}".`,
+                details: { change: slug, dep },
+            });
+        }
+    }
+    for (const slug of [...cycleMembers].sort()) {
+        warnings.push({
+            code: 'dep-cycle',
+            message: `Change "${slug}" is part of a dependency cycle.`,
+            details: { change: slug, cycle: [...cycleMembers].sort() },
+        });
+    }
+    const cycleReach = new Map();
+    const blockersBySlug = new Map();
+    for (const slug of [...knownSlugs].sort()) {
+        blockersBySlug.set(slug, blockersFor(slug, depsBySlug, knownSlugs, changeStates, scheduleBySlug, cycleMembers, cycleReach));
+    }
+    const sortedWarnings = sortWarnings(warnings);
+    const warningCodesByChange = new Map();
+    for (const warning of sortedWarnings) {
+        const change = typeof warning.details?.change === 'string' ? warning.details.change : undefined;
+        if (!change)
+            continue;
+        const codes = warningCodesByChange.get(change) ?? [];
+        codes.push(warning.code);
+        warningCodesByChange.set(change, codes);
+    }
+    const missingBySlug = new Map();
+    const gapsBySlug = new Map();
+    for (const [slug, state] of [...changeStates].sort((a, b) => a[0].localeCompare(b[0]))) {
+        const epic = state.epic;
+        if (!epic) {
+            missingBySlug.set(slug, []);
+            gapsBySlug.set(slug, []);
+            continue;
+        }
+        const links = uniqueStrings(epic.meta.links);
+        const coveredTypes = new Set();
+        for (const id of links) {
+            const linked = linkedById.get(id);
+            if (linked)
+                coveredTypes.add(linked.type);
+        }
+        missingBySlug.set(slug, uniqueStrings(epic.meta.requires).filter((type) => !coveredTypes.has(type)).sort());
+        gapsBySlug.set(slug, gapsFromMeta(epic.meta.gaps));
+    }
+    const toMirrorChange = (slug) => {
+        const state = changeStates.get(slug);
+        return {
+            slug,
+            title: state?.title ?? slug,
+            status: state?.status ?? 'unknown',
+            blockers: blockersBySlug.get(slug) ?? [],
+            gaps: gapsBySlug.get(slug) ?? [],
+            missing: missingBySlug.get(slug) ?? [],
+            warnings: warningCodesByChange.get(slug) ?? [],
+        };
+    };
+    const sprintRows = sprints.map((sprint) => ({
+        slug: sprint.artifact.slug,
+        title: sprint.artifact.title,
+        status: sprint.status,
+        startDate: sprint.startDate,
+        endDate: sprint.endDate,
+        changes: sprint.changes.map((slug) => toMirrorChange(slug)),
+    }));
+    for (const sprint of sprintRows) {
+        if (sprint.status === 'closed')
+            continue;
+        if (sprint.changes.length === 0)
+            continue;
+        if (!sprint.changes.every((item) => item.status === 'completed'))
+            continue;
+        sortedWarnings.push({
+            code: 'closable-sprint',
+            message: `Sprint "${sprint.slug}" has no pending changes and can be closed.`,
+            details: { sprint: sprint.slug },
+        });
+    }
+    const finalWarnings = sortWarnings(sortedWarnings);
+    const finalWarningCodesByChange = new Map();
+    for (const warning of finalWarnings) {
+        const change = typeof warning.details?.change === 'string' ? warning.details.change : undefined;
+        if (!change)
+            continue;
+        const codes = finalWarningCodesByChange.get(change) ?? [];
+        codes.push(warning.code);
+        finalWarningCodesByChange.set(change, codes);
+    }
+    for (const sprint of sprintRows) {
+        sprint.changes = sprint.changes.map((item) => ({
+            ...item,
+            warnings: finalWarningCodesByChange.get(item.slug) ?? item.warnings,
+        }));
+    }
+    const ungrouped = [...changeStates.keys()]
+        .filter((slug) => !scheduled.has(slug))
+        .sort()
+        .map((slug) => {
+        const item = toMirrorChange(slug);
+        return { ...item, warnings: finalWarningCodesByChange.get(slug) ?? item.warnings };
+    });
+    return {
+        sprints: sprintRows,
+        ungrouped,
+        warnings: finalWarnings,
+        next: chooseNext(sprintRows),
+    };
+}
+export function filterMirrorGaps(board) {
+    return {
+        sprints: board.sprints.map((sprint) => ({
+            ...sprint,
+            changes: sprint.changes.filter(hasGapSignal),
+        })),
+        ungrouped: board.ungrouped.filter(hasGapSignal),
+        warnings: board.warnings,
+        next: board.next,
+    };
+}
+function sortArtifacts(artifacts) {
+    const copy = [...artifacts];
+    copy.sort((a, b) => {
+        const bySlug = a.slug.localeCompare(b.slug);
+        if (bySlug !== 0)
+            return bySlug;
+        return a.id.localeCompare(b.id);
+    });
+    return copy;
+}
+function statusFromMeta(meta) {
+    if (typeof meta.status === 'string' && STATUS_VALUES[meta.status]) {
+        return meta.status;
+    }
+    return 'unknown';
+}
+function toSprintPlan(artifact) {
+    const start = normalizeDateField(artifact.meta.startDate);
+    return {
+        artifact,
+        order: 0,
+        parsedStart: start.sortKey,
+        changes: uniqueStrings(artifact.meta.changes),
+        status: typeof artifact.meta.status === 'string' ? artifact.meta.status : 'planned',
+        startDate: start.value,
+        endDate: normalizeDateField(artifact.meta.endDate).value,
+    };
+}
+function normalizeDateField(value) {
+    if (typeof value !== 'string')
+        return { sortKey: Number.POSITIVE_INFINITY, value: null };
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return { sortKey: Number.POSITIVE_INFINITY, value: null };
+    if (!ISO_DATE_PREFIX.test(trimmed))
+        return { sortKey: Number.POSITIVE_INFINITY, value: trimmed };
+    const time = new Date(trimmed).getTime();
+    if (!Number.isFinite(time))
+        return { sortKey: Number.POSITIVE_INFINITY, value: trimmed };
+    return { sortKey: time, value: trimmed };
+}
+function compareSprints(a, b) {
+    const byDate = a.parsedStart - b.parsedStart;
+    if (!Number.isNaN(byDate) && byDate !== 0)
+        return byDate;
+    return a.artifact.slug.localeCompare(b.artifact.slug);
+}
+function uniqueStrings(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    const seen = new Set();
+    for (const item of value) {
+        if (typeof item !== 'string')
+            continue;
+        if (seen.has(item))
+            continue;
+        seen.add(item);
+        out.push(item);
+    }
+    return out;
+}
+function gapsFromMeta(value) {
+    if (!Array.isArray(value))
+        return [];
+    const gaps = [];
+    for (const item of value) {
+        if (typeof item !== 'object' || item === null)
+            continue;
+        const record = item;
+        if (typeof record.flag !== 'string' || record.flag.length === 0)
+            continue;
+        const gap = { flag: record.flag };
+        if (typeof record.note === 'string')
+            gap.note = record.note;
+        gaps.push(gap);
+    }
+    return gaps;
+}
+function findCycleMembers(slugs, depsBySlug, knownSlugs) {
+    const state = new Map();
+    const stack = [];
+    const stackIndex = new Map();
+    const members = new Set();
+    let steps = 0;
+    const maxSteps = Math.max(100, slugs.length * slugs.length + slugs.length);
+    const visit = (slug) => {
+        if (state.get(slug) === 'done')
+            return;
+        if (steps > maxSteps) {
+            for (const item of stack)
+                members.add(item);
+            return;
+        }
+        steps += 1;
+        state.set(slug, 'visiting');
+        stackIndex.set(slug, stack.length);
+        stack.push(slug);
+        for (const dep of [...(depsBySlug.get(slug) ?? [])].sort()) {
+            if (!knownSlugs.has(dep))
+                continue;
+            const depState = state.get(dep);
+            if (depState === 'visiting') {
+                const start = stackIndex.get(dep) ?? 0;
+                for (const item of stack.slice(start))
+                    members.add(item);
+                continue;
+            }
+            visit(dep);
+        }
+        stack.pop();
+        stackIndex.delete(slug);
+        state.set(slug, 'done');
+    };
+    for (const slug of slugs)
+        visit(slug);
+    return members;
+}
+function blockersFor(slug, depsBySlug, knownSlugs, states, scheduleBySlug, cycleMembers, cycleReach) {
+    const blockers = new Set();
+    if (cycleMembers.has(slug))
+        blockers.add('dep-cycle');
+    const currentSchedule = scheduleBySlug.get(slug);
+    for (const dep of depsBySlug.get(slug) ?? []) {
+        if (!knownSlugs.has(dep)) {
+            blockers.add(dep);
+            continue;
+        }
+        if (leadsToCycle(dep, depsBySlug, knownSlugs, cycleMembers, cycleReach, new Set())) {
+            blockers.add(dep);
+            continue;
+        }
+        if (states.get(dep)?.status === 'completed')
+            continue;
+        const depSchedule = scheduleBySlug.get(dep);
+        if (currentSchedule !== undefined && depSchedule !== undefined && depSchedule <= currentSchedule)
+            continue;
+        blockers.add(dep);
+    }
+    return [...blockers].sort();
+}
+function leadsToCycle(slug, depsBySlug, knownSlugs, cycleMembers, memo, seen) {
+    const cached = memo.get(slug);
+    if (cached !== undefined)
+        return cached;
+    if (cycleMembers.has(slug)) {
+        memo.set(slug, true);
+        return true;
+    }
+    if (seen.has(slug))
+        return false;
+    seen.add(slug);
+    for (const dep of depsBySlug.get(slug) ?? []) {
+        if (!knownSlugs.has(dep))
+            continue;
+        if (leadsToCycle(dep, depsBySlug, knownSlugs, cycleMembers, memo, seen)) {
+            memo.set(slug, true);
+            seen.delete(slug);
+            return true;
+        }
+    }
+    seen.delete(slug);
+    memo.set(slug, false);
+    return false;
+}
+function sortWarnings(warnings) {
+    const copy = [...warnings];
+    copy.sort((a, b) => {
+        const byCode = WARNING_ORDER[a.code] - WARNING_ORDER[b.code];
+        if (byCode !== 0)
+            return byCode;
+        const aDetail = warningSortKey(a);
+        const bDetail = warningSortKey(b);
+        return aDetail.localeCompare(bDetail);
+    });
+    return copy;
+}
+function warningSortKey(warning) {
+    const details = warning.details ?? {};
+    const change = typeof details.change === 'string' ? details.change : '';
+    const sprint = typeof details.sprint === 'string' ? details.sprint : '';
+    const dep = typeof details.dep === 'string' ? details.dep : '';
+    return `${change}\u0000${sprint}\u0000${dep}\u0000${warning.message}`;
+}
+function chooseNext(sprints) {
+    const active = sprints.filter((sprint) => sprint.status === 'active');
+    const candidates = active.length > 0 ? active : sprints.filter((sprint) => sprint.status === 'planned');
+    const source = active.length > 0 ? 'active sprint' : 'planned sprint';
+    for (const sprint of candidates) {
+        for (const change of sprint.changes) {
+            if (change.status === 'completed')
+                continue;
+            if (change.blockers.length > 0)
+                continue;
+            return {
+                change: change.slug,
+                sprint: sprint.slug,
+                reason: `first pending unblocked change in ${source}`,
+            };
+        }
+    }
+    return null;
+}
+function hasGapSignal(change) {
+    if (change.gaps.length > 0)
+        return true;
+    if (change.missing.length > 0)
+        return true;
+    return change.blockers.length > 0;
+}
+//# sourceMappingURL=mirror.js.map