@encore-os/eos-spec 0.9.0 → 0.12.0

package/dist/lib/walkthrough-manifest-io.d.ts

@@ -0,0 +1,15 @@
+import type { WalkthroughManifest } from './walkthrough-coverage.js';
+/** Repo-relative path to a spec's walkthrough manifest (regenerated, gitignored). */
+export declare function manifestPath(repoRoot: string, specId: string): string;
+export type ManifestLoad = {
+    ok: true;
+    manifest: WalkthroughManifest;
+    path: string;
+} | {
+    ok: false;
+    reason: 'missing' | 'invalid';
+    message: string;
+    path: string;
+};
+/** Load + parse a spec's manifest. Never throws: absent → `missing`, bad JSON → `invalid`. */
+export declare function loadManifest(repoRoot: string, specId: string): ManifestLoad;

package/dist/lib/walkthrough-manifest-io.js

@@ -0,0 +1,30 @@
+// Filesystem IO for a spec's walkthrough manifest. FS-BOUND (node:fs) — shared by the
+// `walkthrough` and `signoff` commands so their manifest read cannot diverge. NEVER
+// re-export this from src/pure.ts: it reads the filesystem. The coverage predicate it
+// feeds (`checkWalkthroughCoverage`) stays the pure leaf.
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Repo-relative path to a spec's walkthrough manifest (regenerated, gitignored). */
+export function manifestPath(repoRoot, specId) {
+    return join(repoRoot, 'docs', 'walkthroughs', specId.toLowerCase(), 'manifest.json');
+}
+/** Load + parse a spec's manifest. Never throws: absent → `missing`, bad JSON → `invalid`. */
+export function loadManifest(repoRoot, specId) {
+    const path = manifestPath(repoRoot, specId);
+    if (!existsSync(path)) {
+        return { ok: false, reason: 'missing', path, message: `no manifest for ${specId}` };
+    }
+    try {
+        const manifest = JSON.parse(readFileSync(path, 'utf8'));
+        return { ok: true, manifest, path };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: 'invalid',
+            path,
+            message: `manifest for ${specId} is not valid JSON (${err instanceof Error ? err.message : String(err)})`,
+        };
+    }
+}
+//# sourceMappingURL=walkthrough-manifest-io.js.map

package/dist/lib/walkthrough-manifest-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"walkthrough-manifest-io.js","sourceRoot":"","sources":["../../src/lib/walkthrough-manifest-io.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,oFAAoF;AACpF,sFAAsF;AACtF,0DAA0D;AAC1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,qFAAqF;AACrF,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,MAAc;IAC3D,OAAO,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,EAAE,eAAe,CAAC,CAAC;AACvF,CAAC;AAMD,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,MAAc;IAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,MAAM,EAAE,EAAE,CAAC;IACtF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAwB,CAAC;QAC/E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACtC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,SAAS;YACjB,IAAI;YACJ,OAAO,EAAE,gBAAgB,MAAM,uBAAuB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG;SAC1G,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/lib/with-event-log.js

@@ -1,4 +1,17 @@
 import { logEvent, RUN_ID, redactArgs } from './events.js';
+import { getGlobalOptions } from './output.js';
+/** Resolve the caller's `--repo-root` global override from the commander command so
+ *  telemetry lands in the intended repo, not whatever git repo the invoking cwd is in
+ *  (F-3). Never throws — a fake/absent command (tests, non-commander callers) falls
+ *  back to undefined, which lets logEvent use its git-rev-parse default path. */
+function repoRootFromCmd(cmd) {
+    try {
+        return getGlobalOptions(cmd).repoRoot;
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Wrap a commander action with event logging — records ms, ok, and (re-)throws on error.
  *  The wrapped action sees the same (options, cmd) signature.
  *
@@ -18,6 +31,7 @@ export function withEventLog(commandName, action) {
     return async (...args) => {
         const cmd = args[args.length - 1];
         const options = (args.length >= 2 ? args[args.length - 2] : {});
+        const repoRoot = repoRootFromCmd(cmd);
         const start = Date.now();
         const ts = new Date().toISOString();
         const base = {
@@ -35,7 +49,7 @@ export function withEventLog(commandName, action) {
             if (logged)
                 return;
             logged = true;
-            logEvent({ ...base, ms: Date.now() - start, ok: code === 0 });
+            logEvent({ ...base, ms: Date.now() - start, ok: code === 0 }, { repoRoot });
         };
         process.once('exit', onExit);
         try {
@@ -44,7 +58,7 @@ export function withEventLog(commandName, action) {
             process.removeListener('exit', onExit);
             if (!logged) {
                 logged = true;
-                logEvent({ ...base, ms: Date.now() - start, ok: true });
+                logEvent({ ...base, ms: Date.now() - start, ok: true }, { repoRoot });
             }
         }
         catch (e) {
@@ -56,7 +70,7 @@ export function withEventLog(commandName, action) {
                     ms: Date.now() - start,
                     ok: false,
                     error: e instanceof Error ? e.message : String(e),
-                });
+                }, { repoRoot });
             }
             throw e;
         }

package/dist/lib/with-event-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"with-event-log.js","sourceRoot":"","sources":["../../src/lib/with-event-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI3D;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAoC,WAAmB,EAAE,MAAiB;IACpG,8EAA8E;IAC9E,gFAAgF;IAChF,gFAAgF;IAChF,+EAA+E;IAC/E,iFAAiF;IACjF,6BAA6B;IAC7B,OAAO,KAAK,EAAE,GAAG,IAAe,EAAiB,EAAE;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAM,CAAC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG;YACX,EAAE;YACF,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC;YACzB,MAAM,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACnE,IAAI,EAAE,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;SAClE,CAAC;QAEF,8EAA8E;QAC9E,6EAA6E;QAC7E,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,EAAE;YAC9B,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC3B,kEAAkE;YAClE,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,CAAC;gBACd,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,GAAG,IAAI,CAAC;gBACd,QAAQ,CAAC;oBACP,GAAG,IAAI;oBACP,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;oBACtB,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;iBAClD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"with-event-log.js","sourceRoot":"","sources":["../../src/lib/with-event-log.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@encore-os/eos-spec",
-  "version": "0.9.0",
+  "version": "0.12.0",
   "description": "Portable, config-driven spec-pipeline engine + quality harness. One canonical engine consumed as a library (with a client-safe /pure subpath) by every Encore-OS repo.",
   "private": false,
   "license": "SEE LICENSE IN LICENSE",