@encore-os/eos-spec 0.3.1

package/dist/lib/embedding-store.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Committed dense-embedding index for semantic precedent search. The matrix is a
+ * row-major Float32 binary aligned with `manifest.entries`; both are built offline
+ * by `scripts/build-spec-embeddings.ts` (Ollama) and committed so CI/runtime can
+ * rank without an embedding service. Mirrors the repo's PF-75 embedding-store
+ * pattern, reimplemented here because eos-spec cannot import from `src/`.
+ */
+export interface EmbeddingEntry {
+    id: string;
+    file: string;
+    title: string;
+}
+export interface EmbeddingManifest {
+    /** Embedding model id (e.g. "qwen3-embedding:0.6b"). */
+    model: string;
+    /** Vector dimensionality (rows in the .bin are this long). */
+    dims: number;
+    /** Query instruction prefix — documents are embedded WITHOUT it, queries WITH it. */
+    instruction: string;
+    /** SHA-256 of the concatenated embedded document texts — corpus drift detector. */
+    surfaceHash: string;
+    /** ISO build date (informational; not load-bearing). */
+    built: string;
+    /** Per-row metadata, aligned with the matrix rows. */
+    entries: EmbeddingEntry[];
+}
+export interface EmbeddingIndex {
+    manifest: EmbeddingManifest;
+    /** Unit vectors, row-aligned with `manifest.entries`. */
+    matrix: Float32Array[];
+}
+/** Legacy data-dir default — the encoreos fork layout (`tools/eos-spec/data`).
+ *  Configurable per-consumer via `specs/config.yaml` `embeddings.data_dir`, read
+ *  through the {@link EmbeddingsSource} seam (embeddings-source.ts). The DATA_DIR
+ *  must never be assumed package-relative — that is the "resolves to the wrong
+ *  root" bug class the npm-pack smoke guards against (epic #300, Wave-1 C1). */
+export declare const DEFAULT_DATA_DIR = "tools/eos-spec/data";
+/** Legacy spec-index path default (relative to repo root). */
+export declare const DEFAULT_SPEC_INDEX_PATH = "specs/spec-index.json";
+export declare const MANIFEST_FILE = "spec-embeddings.manifest.json";
+export declare const MATRIX_FILE = "spec-embeddings.bin";
+export declare const RECALL_VECTORS_FILE = "recall-query-vectors.json";
+export declare function dataPath(repoRoot: string, file: string, dataDir?: string): string;
+/** Unit-length copy of a vector (zero vector returned unchanged). */
+export declare function normalize(v: Float32Array): Float32Array;
+/** Dot product (== cosine similarity for unit vectors). */
+export declare function dot(a: Float32Array, b: Float32Array): number;
+/** Serialize rows to a little-endian Float32 row-major Buffer (build-time). */
+export declare function serializeMatrix(rows: Float32Array[]): Buffer;
+/** Parse a row-major Float32 buffer into per-row vectors. */
+export declare function parseMatrix(buf: ArrayBuffer, dims: number): Float32Array[];
+/** Load the committed embedding index from `repoRoot`/`dataDir`, or null when absent. */
+export declare function loadEmbeddingIndex(repoRoot: string, dataDir?: string): EmbeddingIndex | null;
+/** One ranked semantic hit. */
+export interface SemanticHit {
+    id: string;
+    file: string;
+    title: string;
+    score: number;
+}
+/** Rank every index entry by cosine to a (normalized) query vector, descending. */
+export declare function cosineRank(queryVec: Float32Array, index: EmbeddingIndex, limit?: number): SemanticHit[];
+/** Cap on a single document's embedded text — must match the build script. */
+export declare const DOC_CAP = 1200;
+/** Minimal spec-index row needed to recompute the embedding surface hash. */
+export interface SurfaceSpec {
+    id?: string | null;
+    title?: string | null;
+    file?: string | null;
+    status?: string | null;
+    summary?: string | null;
+}
+/** A spec is embedded only when it is non-archived and has a file. */
+export declare function isEmbeddableSpec(s: SurfaceSpec | null): s is SurfaceSpec;
+/** The document text embedded for one spec (title + summary, capped). */
+export declare function embedDocText(s: SurfaceSpec): string;
+/** SHA-256 of the concatenated embedded document texts — the corpus surface. */
+export declare function computeSurfaceHash(specs: (SurfaceSpec | null)[]): string;
+/** Outcome of a freshness check between the live corpus and committed vectors. */
+export interface FreshnessResult {
+    fresh: boolean;
+    /** Hash recomputed from the current specs/spec-index.json. */
+    currentHash: string;
+    /** Hash recorded in the committed manifest (null when the manifest is absent). */
+    committedHash: string | null;
+    /** Why a check could not be performed, when applicable. */
+    reason?: 'manifest-missing' | 'index-missing';
+}
+/**
+ * Compare the live corpus surface against the committed embedding manifest.
+ *
+ * Reads the generated (gitignored) spec-index.json, recomputes the surface hash,
+ * and compares it to the committed manifest hash. `fresh` is true only when both
+ * are present and equal. A missing manifest or index is reported as NOT fresh with
+ * a `reason` so callers can produce an actionable message. The data dir +
+ * spec-index path are configurable per-consumer via the {@link EmbeddingsSource}
+ * seam (embeddings-source.ts → `specs/config.yaml`); they default to the legacy
+ * fork layout when omitted.
+ */
+export declare function checkEmbeddingFreshness(repoRoot: string, opts?: {
+    dataDir?: string;
+    specIndexPath?: string;
+}): FreshnessResult;

package/dist/lib/embedding-store.js

@@ -0,0 +1,133 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** Legacy data-dir default — the encoreos fork layout (`tools/eos-spec/data`).
+ *  Configurable per-consumer via `specs/config.yaml` `embeddings.data_dir`, read
+ *  through the {@link EmbeddingsSource} seam (embeddings-source.ts). The DATA_DIR
+ *  must never be assumed package-relative — that is the "resolves to the wrong
+ *  root" bug class the npm-pack smoke guards against (epic #300, Wave-1 C1). */
+export const DEFAULT_DATA_DIR = 'tools/eos-spec/data';
+/** Legacy spec-index path default (relative to repo root). */
+export const DEFAULT_SPEC_INDEX_PATH = 'specs/spec-index.json';
+export const MANIFEST_FILE = 'spec-embeddings.manifest.json';
+export const MATRIX_FILE = 'spec-embeddings.bin';
+export const RECALL_VECTORS_FILE = 'recall-query-vectors.json';
+export function dataPath(repoRoot, file, dataDir = DEFAULT_DATA_DIR) {
+    return join(repoRoot, dataDir, file);
+}
+/** Unit-length copy of a vector (zero vector returned unchanged). */
+export function normalize(v) {
+    let sum = 0;
+    for (const x of v)
+        sum += x * x;
+    const mag = Math.sqrt(sum);
+    if (mag === 0)
+        return v.slice();
+    const out = new Float32Array(v.length);
+    for (let i = 0; i < v.length; i++)
+        out[i] = v[i] / mag;
+    return out;
+}
+/** Dot product (== cosine similarity for unit vectors). */
+export function dot(a, b) {
+    let s = 0;
+    const n = Math.min(a.length, b.length);
+    for (let i = 0; i < n; i++)
+        s += a[i] * b[i];
+    return s;
+}
+/** Serialize rows to a little-endian Float32 row-major Buffer (build-time). */
+export function serializeMatrix(rows) {
+    const dims = rows.length > 0 ? rows[0].length : 0;
+    const flat = new Float32Array(rows.length * dims);
+    for (let i = 0; i < rows.length; i++)
+        flat.set(rows[i], i * dims);
+    return Buffer.from(flat.buffer);
+}
+/** Parse a row-major Float32 buffer into per-row vectors. */
+export function parseMatrix(buf, dims) {
+    if (dims <= 0)
+        return [];
+    const flat = new Float32Array(buf);
+    const rows = [];
+    for (let i = 0; i < flat.length; i += dims)
+        rows.push(flat.slice(i, i + dims));
+    return rows;
+}
+/** Load the committed embedding index from `repoRoot`/`dataDir`, or null when absent. */
+export function loadEmbeddingIndex(repoRoot, dataDir = DEFAULT_DATA_DIR) {
+    const manifestPath = dataPath(repoRoot, MANIFEST_FILE, dataDir);
+    const matrixPath = dataPath(repoRoot, MATRIX_FILE, dataDir);
+    if (!existsSync(manifestPath) || !existsSync(matrixPath))
+        return null;
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const file = readFileSync(matrixPath);
+    // Slice to the exact backing region — readFileSync may share a pooled buffer.
+    const ab = file.buffer.slice(file.byteOffset, file.byteOffset + file.byteLength);
+    const matrix = parseMatrix(ab, manifest.dims);
+    return { manifest, matrix };
+}
+/** Rank every index entry by cosine to a (normalized) query vector, descending. */
+export function cosineRank(queryVec, index, limit) {
+    const hits = index.manifest.entries.map((e, i) => ({
+        id: e.id,
+        file: e.file,
+        title: e.title,
+        score: dot(queryVec, index.matrix[i] ?? new Float32Array()),
+    }));
+    hits.sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
+    return typeof limit === 'number' ? hits.slice(0, limit) : hits;
+}
+// --- Corpus surface-hash (freshness gate) -----------------------------------
+// The committed embedding manifest records the SHA-256 of the embedded document
+// texts. These helpers recompute that hash from the *current* spec-index.json so
+// `eos-spec freshness` can detect when the corpus has drifted away from the
+// committed vectors. They MUST mirror the offline embedding build exactly (same
+// archived filter, same docText shape, same join) or the hash will never match a
+// freshly-built index. Ported from encoreos (the engine was "encoreos minus freshness").
+/** Cap on a single document's embedded text — must match the build script. */
+export const DOC_CAP = 1200;
+/** A spec is embedded only when it is non-archived and has a file. */
+export function isEmbeddableSpec(s) {
+    if (!s?.file)
+        return false;
+    return !(s.status === 'archived' || (s.file ?? '').includes('/archive/'));
+}
+/** The document text embedded for one spec (title + summary, capped). */
+export function embedDocText(s) {
+    return `${s.title ?? ''}\n${s.summary ?? ''}`.slice(0, DOC_CAP);
+}
+/** SHA-256 of the concatenated embedded document texts — the corpus surface. */
+export function computeSurfaceHash(specs) {
+    const docTexts = specs.filter(isEmbeddableSpec).map(embedDocText);
+    return createHash('sha256').update(docTexts.join(' ')).digest('hex');
+}
+/**
+ * Compare the live corpus surface against the committed embedding manifest.
+ *
+ * Reads the generated (gitignored) spec-index.json, recomputes the surface hash,
+ * and compares it to the committed manifest hash. `fresh` is true only when both
+ * are present and equal. A missing manifest or index is reported as NOT fresh with
+ * a `reason` so callers can produce an actionable message. The data dir +
+ * spec-index path are configurable per-consumer via the {@link EmbeddingsSource}
+ * seam (embeddings-source.ts → `specs/config.yaml`); they default to the legacy
+ * fork layout when omitted.
+ */
+export function checkEmbeddingFreshness(repoRoot, opts = {}) {
+    const dataDir = opts.dataDir ?? DEFAULT_DATA_DIR;
+    const manifestPath = dataPath(repoRoot, MANIFEST_FILE, dataDir);
+    const committedHash = existsSync(manifestPath)
+        ? JSON.parse(readFileSync(manifestPath, 'utf8')).surfaceHash
+        : null;
+    const indexPath = join(repoRoot, opts.specIndexPath ?? DEFAULT_SPEC_INDEX_PATH);
+    if (!existsSync(indexPath)) {
+        return { fresh: false, currentHash: '', committedHash, reason: 'index-missing' };
+    }
+    const index = JSON.parse(readFileSync(indexPath, 'utf8'));
+    const currentHash = computeSurfaceHash(Array.isArray(index.specs) ? index.specs : []);
+    if (committedHash === null) {
+        return { fresh: false, currentHash, committedHash, reason: 'manifest-missing' };
+    }
+    return { fresh: currentHash === committedHash, currentHash, committedHash };
+}
+//# sourceMappingURL=embedding-store.js.map

package/dist/lib/embedding-store.js.map

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

package/dist/lib/embeddings-source.d.ts

@@ -0,0 +1,36 @@
+import { type EmbeddingIndex, type FreshnessResult } from './embedding-store.js';
+/** Where a consumer's committed embedding index + freshness corpus live. */
+export interface EmbeddingsPaths {
+    /** Index dir (manifest + matrix + recall vectors), relative to repo root. */
+    dataDir: string;
+    /** Generated spec-index.json (freshness corpus), relative to repo root. */
+    specIndexPath: string;
+}
+/**
+ * The injectable embedding backend. Semantic precedent search and the freshness
+ * gate consume this, never the raw filesystem paths — so a non-filesystem source
+ * (pgvector, tenant-scoped) is a drop-in.
+ */
+export interface EmbeddingsSource {
+    /** Load the committed dense index, or null when absent. */
+    loadIndex(): EmbeddingIndex | null;
+    /** Compare the live corpus surface against the committed manifest. */
+    checkFreshness(): FreshnessResult;
+}
+/**
+ * Resolve the embedding paths for `repoRoot` from `specs/config.yaml`
+ * (`embeddings.*`), falling back to the legacy fork-layout defaults when the
+ * config is absent, unreadable, or omits the `embeddings` block — so existing
+ * consumers behave exactly as before.
+ */
+export declare function resolveEmbeddingsPaths(repoRoot: string, configOverride?: string): EmbeddingsPaths;
+/** Filesystem-backed source: reads committed vectors + spec-index from disk. */
+export declare class FilesystemEmbeddingsSource implements EmbeddingsSource {
+    private readonly repoRoot;
+    private readonly paths;
+    constructor(repoRoot: string, paths: EmbeddingsPaths);
+    loadIndex(): EmbeddingIndex | null;
+    checkFreshness(): FreshnessResult;
+}
+/** The default source for a repo: filesystem-backed, paths resolved from config. */
+export declare function embeddingsSourceFromConfig(repoRoot: string, configOverride?: string): EmbeddingsSource;

package/dist/lib/embeddings-source.js

@@ -0,0 +1,62 @@
+/**
+ * The EmbeddingsSource provider seam (epic #300, Wave-1 C1).
+ *
+ * The engine carries NO corpus data — the embedding index location is injected
+ * per-consumer via `specs/config.yaml` (`embeddings.data_dir` /
+ * `embeddings.spec_index_path`), resolved here. Today the only implementation is
+ * filesystem-backed; the interface is the seam a future pgvector / tenant-scoped
+ * source (cloud, per-tenant) drops into without touching `semantic-search` or the
+ * `freshness` command.
+ *
+ * Keeping the data dir behind this seam — rather than a package-relative constant —
+ * is what lets the published tarball ship no `data/` and a consumer point at its
+ * own committed vectors, and it kills the "DATA_DIR resolves to the wrong root"
+ * bug class the npm-pack smoke guards against.
+ */
+import { loadConfig } from './config.js';
+import { checkEmbeddingFreshness, DEFAULT_DATA_DIR, DEFAULT_SPEC_INDEX_PATH, loadEmbeddingIndex, } from './embedding-store.js';
+/**
+ * Resolve the embedding paths for `repoRoot` from `specs/config.yaml`
+ * (`embeddings.*`), falling back to the legacy fork-layout defaults when the
+ * config is absent, unreadable, or omits the `embeddings` block — so existing
+ * consumers behave exactly as before.
+ */
+export function resolveEmbeddingsPaths(repoRoot, configOverride) {
+    let dataDir = DEFAULT_DATA_DIR;
+    let specIndexPath = DEFAULT_SPEC_INDEX_PATH;
+    try {
+        const cfg = loadConfig(repoRoot, configOverride);
+        if (cfg.embeddings?.data_dir)
+            dataDir = cfg.embeddings.data_dir;
+        if (cfg.embeddings?.spec_index_path)
+            specIndexPath = cfg.embeddings.spec_index_path;
+    }
+    catch {
+        // No / unreadable config → legacy defaults (the index simply reads as absent
+        // when the default dir doesn't exist, degrading semantic search to lexical).
+    }
+    return { dataDir, specIndexPath };
+}
+/** Filesystem-backed source: reads committed vectors + spec-index from disk. */
+export class FilesystemEmbeddingsSource {
+    repoRoot;
+    paths;
+    constructor(repoRoot, paths) {
+        this.repoRoot = repoRoot;
+        this.paths = paths;
+    }
+    loadIndex() {
+        return loadEmbeddingIndex(this.repoRoot, this.paths.dataDir);
+    }
+    checkFreshness() {
+        return checkEmbeddingFreshness(this.repoRoot, {
+            dataDir: this.paths.dataDir,
+            specIndexPath: this.paths.specIndexPath,
+        });
+    }
+}
+/** The default source for a repo: filesystem-backed, paths resolved from config. */
+export function embeddingsSourceFromConfig(repoRoot, configOverride) {
+    return new FilesystemEmbeddingsSource(repoRoot, resolveEmbeddingsPaths(repoRoot, configOverride));
+}
+//# sourceMappingURL=embeddings-source.js.map

package/dist/lib/embeddings-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings-source.js","sourceRoot":"","sources":["../../src/lib/embeddings-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EAGvB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAsB9B;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,cAAuB;IAC9E,IAAI,OAAO,GAAG,gBAAgB,CAAC;IAC/B,IAAI,aAAa,GAAG,uBAAuB,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QACjD,IAAI,GAAG,CAAC,UAAU,EAAE,QAAQ;YAAE,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC;QAChE,IAAI,GAAG,CAAC,UAAU,EAAE,eAAe;YAAE,aAAa,GAAG,GAAG,CAAC,UAAU,CAAC,eAAe,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACP,6EAA6E;QAC7E,6EAA6E;IAC/E,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AACpC,CAAC;AAED,gFAAgF;AAChF,MAAM,OAAO,0BAA0B;IAElB;IACA;IAFnB,YACmB,QAAgB,EAChB,KAAsB;QADtB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,UAAK,GAAL,KAAK,CAAiB;IACtC,CAAC;IAEJ,SAAS;QACP,OAAO,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED,cAAc;QACZ,OAAO,uBAAuB,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC5C,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO;YAC3B,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,aAAa;SACxC,CAAC,CAAC;IACL,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,UAAU,0BAA0B,CAAC,QAAgB,EAAE,cAAuB;IAClF,OAAO,IAAI,0BAA0B,CAAC,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC;AACpG,CAAC"}

package/dist/lib/enforcement-allowlist.d.ts

@@ -0,0 +1,12 @@
+export type EnforcementAllowlist = {
+    block: string[];
+    warn: string[];
+};
+/**
+ * Read scripts/specs/core-enforcement-allowlist.json — the SAME file
+ * validate-pipeline-status.loadEnforcementAllowlist reads — without crossing the
+ * scripts/ ↔ tools/eos-spec compile boundary. Returns everything-warn-only
+ * (`{ block: [], warn: [] }`) when the file is absent or unreadable, so a gate
+ * built on it never hard-refuses by accident.
+ */
+export declare function loadEnforcementAllowlist(repoRoot: string): EnforcementAllowlist;

package/dist/lib/enforcement-allowlist.js

@@ -0,0 +1,25 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Read scripts/specs/core-enforcement-allowlist.json — the SAME file
+ * validate-pipeline-status.loadEnforcementAllowlist reads — without crossing the
+ * scripts/ ↔ tools/eos-spec compile boundary. Returns everything-warn-only
+ * (`{ block: [], warn: [] }`) when the file is absent or unreadable, so a gate
+ * built on it never hard-refuses by accident.
+ */
+export function loadEnforcementAllowlist(repoRoot) {
+    const file = join(repoRoot, 'scripts', 'specs', 'core-enforcement-allowlist.json');
+    if (!existsSync(file))
+        return { block: [], warn: [] };
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf8'));
+        return {
+            block: Array.isArray(parsed.block) ? parsed.block : [],
+            warn: Array.isArray(parsed.warn) ? parsed.warn : [],
+        };
+    }
+    catch {
+        return { block: [], warn: [] };
+    }
+}
+//# sourceMappingURL=enforcement-allowlist.js.map

package/dist/lib/enforcement-allowlist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforcement-allowlist.js","sourceRoot":"","sources":["../../src/lib/enforcement-allowlist.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,iCAAiC,CAAC,CAAC;IACnF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAkC,CAAC;QACvF,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YACtD,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;SACpD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/lib/events.d.ts

@@ -0,0 +1,47 @@
+export type EosSpecEvent = {
+    ts: string;
+    command: string;
+    args?: string[];
+    ms: number;
+    ok: boolean;
+    /** AI-call-only fields: */
+    model?: string;
+    tokens?: {
+        prompt: number;
+        completion: number;
+        total: number;
+    };
+    costUsd?: number | null;
+    /** Optional CLI context: */
+    specId?: string;
+    core?: string;
+    /** Optional error message (when ok=false) */
+    error?: string;
+    /** Enforcement-gate fields (harness-spec-awareness design §4.6) — set when a
+     *  gate fires; consumed later by gate-precision reporting. Additive, optional. */
+    gate?: string;
+    verdict?: 'pass' | 'warn' | 'block';
+    overridden?: boolean;
+    /** D1 halt-cause taxonomy: when ok=false, why. 'gate' = a governance gate
+     *  fired (expected, autonomy working); 'crash' = unexpected tooling failure.
+     *  Derived at read time if absent; writers may set it explicitly. */
+    haltCause?: 'gate' | 'crash';
+    /** D3 run correlation: an opaque, PHI-free id for the originating process/run.
+     *  Set once per process (see RUN_ID below) — never a spec title/path. */
+    runId?: string;
+};
+/** Opaque, PHI-free run id for THIS process — generated once at module load.
+ *  Prefer an externally-supplied id (a future fleet orchestrator can correlate a
+ *  run across CLI invocations); otherwise a random UUID. Never derived from
+ *  Date.now()/Math.random() — parallel worktree agents share the sink path and
+ *  would collide. Must carry no PHI (a UUID, never a spec title/path). */
+export declare const RUN_ID: string;
+/** Relative path segments for the telemetry sink — shared so writer and reader
+ *  can't drift (see metrics.ts). Gitignored via the root `.claude/tmp/` entry. */
+export declare const EVENTS_RELATIVE_PATH: string;
+export declare function logEvent(event: EosSpecEvent, opts?: {
+    path?: string;
+}): void;
+/** Convert a commander `options` object to a flat `['--key', 'value', ...]` array,
+ *  allowlisting safe keys and redacting everything else (treated as potential secrets). */
+export declare function redactArgs(options: Record<string, unknown>): string[];

package/dist/lib/events.js

@@ -0,0 +1,75 @@
+import { execSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { appendFileSync, mkdirSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/** Opaque, PHI-free run id for THIS process — generated once at module load.
+ *  Prefer an externally-supplied id (a future fleet orchestrator can correlate a
+ *  run across CLI invocations); otherwise a random UUID. Never derived from
+ *  Date.now()/Math.random() — parallel worktree agents share the sink path and
+ *  would collide. Must carry no PHI (a UUID, never a spec title/path). */
+export const RUN_ID = process.env.EOS_SPEC_RUN_ID || randomUUID();
+/** Relative path segments for the telemetry sink — shared so writer and reader
+ *  can't drift (see metrics.ts). Gitignored via the root `.claude/tmp/` entry. */
+export const EVENTS_RELATIVE_PATH = join('.claude', 'tmp', 'eos-spec-events.jsonl');
+/** Resolve the git repo root via `git rev-parse --show-toplevel`, falling back
+ *  to `process.cwd()` if git fails (not a repo).  Never throws.
+ *  Resolved at call time so tests that chdir() see the new cwd. */
+function defaultPath() {
+    try {
+        const root = execSync('git rev-parse --show-toplevel', {
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return join(root, EVENTS_RELATIVE_PATH);
+    }
+    catch {
+        return join(process.cwd(), EVENTS_RELATIVE_PATH);
+    }
+}
+export function logEvent(event, opts = {}) {
+    try {
+        const path = opts.path ?? process.env.EOS_SPEC_EVENTS_PATH ?? defaultPath();
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, `${JSON.stringify(event)}\n`, 'utf8');
+    }
+    catch {
+        // A failed telemetry write must never propagate — silently no-op.
+    }
+}
+const ALLOWED_KEYS = new Set([
+    'spec',
+    'core',
+    'type',
+    'limit',
+    'dryRun',
+    'write',
+    'save',
+    'stallDays',
+    'all',
+    'includeArchived',
+    'since',
+    'json',
+    'file',
+    'date',
+]);
+const COMMANDER_INTERNAL = new Set(['parent', 'args', 'processedArgs', 'rawArgs', 'commands']);
+/** Convert a commander `options` object to a flat `['--key', 'value', ...]` array,
+ *  allowlisting safe keys and redacting everything else (treated as potential secrets). */
+export function redactArgs(options) {
+    const out = [];
+    for (const [key, value] of Object.entries(options)) {
+        if (COMMANDER_INTERNAL.has(key))
+            continue;
+        if (value === undefined || value === null)
+            continue;
+        const flag = `--${key.replace(/([A-Z])/g, '-$1').toLowerCase()}`;
+        if (ALLOWED_KEYS.has(key)) {
+            out.push(flag, String(value));
+        }
+        else {
+            out.push(flag, '<redacted>');
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=events.js.map

package/dist/lib/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/lib/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA+B1C;;;;0EAI0E;AAC1E,MAAM,CAAC,MAAM,MAAM,GAAW,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,UAAU,EAAE,CAAC;AAE1E;kFACkF;AAClF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,uBAAuB,CAAC,CAAC;AAEpF;;mEAEmE;AACnE,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,+BAA+B,EAAE;YACrD,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAmB,EAAE,OAA0B,EAAE;IACxE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,WAAW,EAAE,CAAC;QAC5E,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;AACH,CAAC;AAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAC3B,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;IACN,WAAW;IACX,KAAK;IACL,iBAAiB;IACjB,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC,CAAC;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAE/F;2FAC2F;AAC3F,MAAM,UAAU,UAAU,CAAC,OAAgC;IACzD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACjE,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/exec.d.ts

@@ -0,0 +1,8 @@
+export type RunResult = {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+};
+export declare function runScript(args: string[], cwd: string): RunResult;
+export declare function runScriptInherit(args: string[], cwd: string): number;
+export declare function tryRun(cmd: string, cwd: string): string;

package/dist/lib/exec.js

@@ -0,0 +1,25 @@
+import { execSync, spawnSync } from 'node:child_process';
+export function runScript(args, cwd) {
+    const result = spawnSync(args[0], args.slice(1), {
+        cwd,
+        encoding: 'utf8',
+        env: process.env,
+    });
+    return {
+        exitCode: result.status ?? -1,
+        stdout: result.stdout ?? '',
+        stderr: result.stderr ?? '',
+    };
+}
+export function runScriptInherit(args, cwd) {
+    const result = spawnSync(args[0], args.slice(1), {
+        cwd,
+        stdio: 'inherit',
+        env: process.env,
+    });
+    return result.status ?? -1;
+}
+export function tryRun(cmd, cwd) {
+    return execSync(cmd, { cwd, encoding: 'utf8' });
+}
+//# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.js","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAQzD,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,GAAW;IACnD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAChD,GAAG;QACH,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc,EAAE,GAAW;IAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAChD,GAAG;QACH,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,GAAW;IAC7C,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;AAClD,CAAC"}