@encore-os/eos-spec 0.3.1

package/dist/lib/placement.js

@@ -0,0 +1,40 @@
+import { existsSync, readdirSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { coresList, specsRoot } from './repo.js';
+import { extractSpecId, isDerivativeArtifact } from './specs.js';
+export function findMisplacedSpecs(repoRoot) {
+    const out = [];
+    for (const core of coresList(repoRoot)) {
+        const coreDir = join(specsRoot(repoRoot), core);
+        if (!existsSync(coreDir))
+            continue;
+        const stack = [coreDir];
+        while (stack.length > 0) {
+            const dir = stack.pop();
+            const dirName = basename(dir);
+            for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                const full = join(dir, entry.name);
+                if (entry.isSymbolicLink())
+                    continue; // skip symlinks to avoid loops
+                if (entry.isDirectory()) {
+                    stack.push(full);
+                    continue;
+                }
+                if (!entry.name.endsWith('.md'))
+                    continue;
+                if (isDerivativeArtifact(dirName, entry.name))
+                    continue;
+                const id = extractSpecId(entry.name, core);
+                if (!id)
+                    continue;
+                const rel = full.slice(coreDir.length + 1);
+                const inCanonical = /^(?:specs|ux|archive)[\\/]/.test(rel);
+                if (!inCanonical) {
+                    out.push({ id, path: full, expectedDir: join(coreDir, 'specs') });
+                }
+            }
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=placement.js.map

package/dist/lib/placement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement.js","sourceRoot":"","sources":["../../src/lib/placement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIjE,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,SAAS;QACnC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,CAAC;QACxB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;YACzB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9B,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,KAAK,CAAC,cAAc,EAAE;oBAAE,SAAS,CAAC,+BAA+B;gBACrE,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;oBACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACjB,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS;gBAC1C,IAAI,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC;oBAAE,SAAS;gBACxD,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBAC3C,IAAI,CAAC,EAAE;oBAAE,SAAS;gBAClB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC3C,MAAM,WAAW,GAAG,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;oBACjB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/lib/precedent-search.d.ts

@@ -0,0 +1,18 @@
+/** One ranked hit from the lexical precedent search over specs/spec-index.json. */
+export interface PrecedentHit {
+    id: string;
+    title: string;
+    file: string;
+    core: string;
+    status: string;
+    score: number;
+    matchedFields: string[];
+}
+/** Ranked lexical search over specs/spec-index.json (no markdown re-parse).
+ *  Throws when the index is missing — callers that must fail open catch. */
+export declare function searchSpecs(topic: string, opts: {
+    core?: string;
+    repoRoot: string;
+    includeArchived?: boolean;
+    limit?: number;
+}): PrecedentHit[];

package/dist/lib/precedent-search.js

@@ -0,0 +1,160 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const DEFAULT_LIMIT = 15;
+// Score tiers, strongest first: word-boundary phrase > all-tokens > partial
+// (per matched token, title x2). The body's all-tokens tier is cross-field-UNION
+// based: tokens matched anywhere across the body fields are unioned, and the
+// tier fires when that union covers every query token — no single field has to
+// contain them all. Title and body are scored independently and summed, with
+// one cross-field rule: when the TITLE's winning tier is the partial tier, the
+// tokens it matched are "claimed" and earn no second partial credit in the body
+// — otherwise a single token scattered across title + body (2 + 1) would tie or
+// beat a genuine all-tokens body match (3). When the title wins via
+// phrase/all-tokens, body partial credit is unrestricted.
+const TITLE_WEIGHTS = { phrase: 10, all: 6, perToken: 2 };
+const BODY_WEIGHTS = { phrase: 5, all: 3, perToken: 1 };
+// Index body fields scored, in matchedFields reporting order (after 'title').
+// `summary` is bounded Summary/Overview prose: the structured arrays index only a
+// thin slice, so the domain vocabulary paraphrase queries hit lives here. Partial
+// credit is per-distinct-query-token (capped at the token count), so a longer
+// summary lifts recall without inflating any single spec's score past coverage.
+const BODY_FIELDS = [
+    'summary',
+    'user_stories',
+    'acceptance_criteria',
+    'functional_requirements',
+    'non_functional_requirements',
+    'success_metrics',
+];
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** Lowercased tokens; length >= 2 so acronyms (AI, EDI, MAT, UDS) survive. */
+function tokenize(topic) {
+    return topic
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length >= 2);
+}
+/** Whole-topic phrase as a word-boundary regex; punctuation between words is
+ *  flexible, so "credentialing compliance" matches "Credentialing & Compliance". */
+function phraseRegex(tokens) {
+    if (tokens.length === 0)
+        return null;
+    return new RegExp(`(?:^|[^a-z0-9])${tokens.map(escapeRegExp).join('[^a-z0-9]+')}(?:$|[^a-z0-9])`);
+}
+function tokenRegexes(tokens) {
+    return tokens.map((t) => new RegExp(`(?:^|[^a-z0-9])${escapeRegExp(t)}(?:$|[^a-z0-9])`));
+}
+/** Runtime guard for untrusted index fields: anything non-array becomes []. */
+function asArray(value) {
+    return Array.isArray(value) ? value : [];
+}
+/** ACs carry given/when/then arrays instead of a .text field — flatten them. */
+function acText(ac) {
+    if (!ac)
+        return '';
+    return [ac.title ?? '', ...asArray(ac.given), ...asArray(ac.when), ...asArray(ac.then)].join(' ');
+}
+function fieldText(spec, field) {
+    if (field === 'summary')
+        return spec.summary ?? '';
+    if (field === 'acceptance_criteria')
+        return asArray(spec.acceptance_criteria).map(acText).join('\n');
+    return asArray(spec[field])
+        .map((i) => i?.text ?? '')
+        .join('\n');
+}
+function isArchived(spec) {
+    return spec.status === 'archived' || (spec.file ?? '').includes('/archive/');
+}
+/** Token indexes (into the query token list) that word-boundary match the haystack. */
+function matchedTokenIdxs(haystack, tokenRes) {
+    const matched = new Set();
+    if (!haystack)
+        return matched;
+    tokenRes.forEach((re, i) => {
+        if (re.test(haystack))
+            matched.add(i);
+    });
+    return matched;
+}
+/** Ranked lexical search over specs/spec-index.json (no markdown re-parse).
+ *  Throws when the index is missing — callers that must fail open catch. */
+export function searchSpecs(topic, opts) {
+    const indexPath = join(opts.repoRoot, 'specs', 'spec-index.json');
+    if (!existsSync(indexPath)) {
+        throw new Error(`spec index not found at ${indexPath} — run \`npm run spec:index\` first`);
+    }
+    const tokens = tokenize(topic);
+    if (tokens.length === 0)
+        return [];
+    const phrase = phraseRegex(tokens);
+    const tokenRes = tokenRegexes(tokens);
+    const core = opts.core?.toLowerCase();
+    const limit = opts.limit ?? DEFAULT_LIMIT;
+    const index = JSON.parse(readFileSync(indexPath, 'utf8'));
+    const hits = [];
+    for (const spec of asArray(index.specs)) {
+        if (!spec)
+            continue;
+        if (core && spec.core?.toLowerCase() !== core)
+            continue;
+        if (!opts.includeArchived && isArchived(spec))
+            continue;
+        // --- Title ---
+        const title = (spec.title ?? '').toLowerCase();
+        const titleTokens = matchedTokenIdxs(title, tokenRes);
+        const titleHolistic = Math.max(phrase?.test(title) ? TITLE_WEIGHTS.phrase : 0, titleTokens.size === tokens.length && tokens.length > 0 ? TITLE_WEIGHTS.all : 0);
+        const titlePartial = titleTokens.size * TITLE_WEIGHTS.perToken;
+        const titleScore = Math.max(titleHolistic, titlePartial);
+        // Partial tier won the title → those tokens are claimed (see weights note).
+        const titleClaimsTokens = titlePartial > titleHolistic;
+        // --- Body (per-field, then unioned) ---
+        const fieldTexts = BODY_FIELDS.map((f) => fieldText(spec, f).toLowerCase());
+        const fieldPhrase = fieldTexts.map((t) => (t !== '' && phrase ? phrase.test(t) : false));
+        const fieldTokens = fieldTexts.map((t) => matchedTokenIdxs(t, tokenRes));
+        const bodyTokens = new Set(fieldTokens.flatMap((s) => [...s]));
+        const countedTokens = new Set([...bodyTokens].filter((i) => !(titleClaimsTokens && titleTokens.has(i))));
+        const bodyPhrase = fieldPhrase.some(Boolean);
+        const bodyAll = bodyTokens.size === tokens.length && tokens.length > 0;
+        const bodyPartial = countedTokens.size * BODY_WEIGHTS.perToken;
+        const bodyScore = Math.max(bodyPhrase ? BODY_WEIGHTS.phrase : 0, bodyAll ? BODY_WEIGHTS.all : 0, bodyPartial);
+        const score = titleScore + bodyScore;
+        if (score <= 0)
+            continue;
+        // matchedFields = title (if it scored) + body fields contributing to the
+        // WINNING body tier — a stray single token in another field is not a match.
+        const matchedFields = [];
+        if (titleScore > 0)
+            matchedFields.push('title');
+        if (bodyScore > 0) {
+            const tier = bodyPhrase && bodyScore === BODY_WEIGHTS.phrase
+                ? 'phrase'
+                : bodyAll && bodyScore === BODY_WEIGHTS.all
+                    ? 'all'
+                    : 'partial';
+            BODY_FIELDS.forEach((field, i) => {
+                const contributes = tier === 'phrase'
+                    ? fieldPhrase[i]
+                    : tier === 'all'
+                        ? fieldTokens[i].size > 0
+                        : [...fieldTokens[i]].some((t) => countedTokens.has(t));
+                if (contributes)
+                    matchedFields.push(field);
+            });
+        }
+        hits.push({
+            id: spec.id,
+            title: spec.title ?? '',
+            file: spec.file ?? '',
+            core: spec.core,
+            status: spec.status ?? 'unknown',
+            score,
+            matchedFields,
+        });
+    }
+    hits.sort((a, b) => b.score - a.score || a.id.localeCompare(b.id));
+    return hits.slice(0, limit);
+}
+//# sourceMappingURL=precedent-search.js.map

package/dist/lib/precedent-search.js.map

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

package/dist/lib/predicate-registry.d.ts

@@ -0,0 +1,6 @@
+import type { PredicateRegistry } from './pipeline-schema.js';
+/** The default named-predicate registry for the encoreos-1 pipeline. Each body is
+ *  the EXACT `isDone` closure lifted from the current `PIPELINE` in pipeline-map.ts,
+ *  plus the two `computeStage` cap predicates (`hasResearch`/`hasAcceptanceCriteria`,
+ *  reused as caps). Field names verified against SpecFile/SpecSignals in specs.ts. */
+export declare const DEFAULT_PREDICATES: PredicateRegistry;

package/dist/lib/predicate-registry.js

@@ -0,0 +1,40 @@
+/** The default named-predicate registry for the encoreos-1 pipeline. Each body is
+ *  the EXACT `isDone` closure lifted from the current `PIPELINE` in pipeline-map.ts,
+ *  plus the two `computeStage` cap predicates (`hasResearch`/`hasAcceptanceCriteria`,
+ *  reused as caps). Field names verified against SpecFile/SpecSignals in specs.ts. */
+export const DEFAULT_PREDICATES = {
+    // clarify-spec: CONTEXT.md is the clarify artifact when present (top-level flag).
+    hasContext: (s) => s.hasContext,
+    // validate-spec: <!-- validated: --> marker.
+    hasValidationSignoff: (s) => s.signals.hasValidationSignoff,
+    // ground-research (regulatedOnly) — also reused as the research cap predicate.
+    hasResearch: (s) => s.signals.hasResearch,
+    // spec-review.
+    hasSpecReview: (s) => s.signals.hasSpecReview,
+    // compliance-review (regulatedOnly).
+    hasComplianceSignoff: (s) => s.signals.hasComplianceSignoff,
+    // draft-acs: done when there are no user stories, or ACs are drafted.
+    acsDraftedOrNoStories: (s) => !s.signals.hasUserStories || s.signals.hasAcceptanceCriteria,
+    // generate-tests: ACs absent, OR an active generated suite / verified ACs / linked local test exists (B5 + C1).
+    testsGeneratedOrProven: (s) => !s.signals.hasAcceptanceCriteria ||
+        s.signals.hasActiveGeneratedTests ||
+        s.signals.hasVerifiedAcceptanceCriteria ||
+        s.signals.hasLinkedLocalTest,
+    // generate-tests (BUILDER layout): keys on hasGeneratedTests (e2e_tests LISTED)
+    // rather than the fs-verified hasActiveGeneratedTests — matching the retired
+    // builder fork's gate, and computable by a read-economy consumer (Spec Studio)
+    // that can't read the test files to confirm an active suite.
+    testsListedOrProven: (s) => !s.signals.hasAcceptanceCriteria ||
+        s.signals.hasGeneratedTests ||
+        s.signals.hasVerifiedAcceptanceCriteria ||
+        s.signals.hasLinkedLocalTest,
+    // a11y-audit (optional, completes ux_reviewed).
+    hasUxSignoff: (s) => s.signals.hasUxSignoff,
+    // create-plan (top-level flag).
+    hasPlan: (s) => s.hasPlan,
+    // generate-tasks (top-level flag).
+    hasTasks: (s) => s.hasTasks,
+    // AC cap predicate (computeStage): caps below tasks_generated when ACs are absent.
+    hasAcceptanceCriteria: (s) => s.signals.hasAcceptanceCriteria,
+};
+//# sourceMappingURL=predicate-registry.js.map

package/dist/lib/predicate-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate-registry.js","sourceRoot":"","sources":["../../src/lib/predicate-registry.ts"],"names":[],"mappings":"AAEA;;;sFAGsF;AACtF,MAAM,CAAC,MAAM,kBAAkB,GAAsB;IACnD,kFAAkF;IAClF,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU;IAC/B,6CAA6C;IAC7C,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB;IAC3D,+EAA+E;IAC/E,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW;IACzC,eAAe;IACf,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa;IAC7C,qCAAqC;IACrC,oBAAoB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB;IAC3D,sEAAsE;IACtE,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,CAAC,OAAO,CAAC,qBAAqB;IAC1F,gHAAgH;IAChH,sBAAsB,EAAE,CAAC,CAAC,EAAE,EAAE,CAC5B,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB;QAChC,CAAC,CAAC,OAAO,CAAC,uBAAuB;QACjC,CAAC,CAAC,OAAO,CAAC,6BAA6B;QACvC,CAAC,CAAC,OAAO,CAAC,kBAAkB;IAC9B,gFAAgF;IAChF,6EAA6E;IAC7E,+EAA+E;IAC/E,6DAA6D;IAC7D,mBAAmB,EAAE,CAAC,CAAC,EAAE,EAAE,CACzB,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB;QAChC,CAAC,CAAC,OAAO,CAAC,iBAAiB;QAC3B,CAAC,CAAC,OAAO,CAAC,6BAA6B;QACvC,CAAC,CAAC,OAAO,CAAC,kBAAkB;IAC9B,gDAAgD;IAChD,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY;IAC3C,gCAAgC;IAChC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO;IACzB,mCAAmC;IACnC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ;IAC3B,mFAAmF;IACnF,qBAAqB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB;CAC9D,CAAC"}

package/dist/lib/recall-cases.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The 8 precedent-recall benchmark cases (8 exact-wording + 8 paraphrase queries),
+ * from the 2026-06-09 dogfood. Shared by the lexical recall test, the semantic
+ * recall test, and the embedding build script (which embeds these queries into the
+ * committed `recall-query-vectors.json` fixture) so all three stay in lockstep.
+ *
+ * Targets are matched by FILE, not id (RH-06-EN-3 carries the parent id RH-06).
+ * If a target spec is renamed, update its `targetFile`; never delete a case.
+ */
+export interface RecallCase {
+    exact: string;
+    paraphrase: string;
+    targetFile: string;
+}
+export declare const RECALL_CASES: RecallCase[];

package/dist/lib/recall-cases.js

@@ -0,0 +1,39 @@
+export const RECALL_CASES = [
+    {
+        exact: 'exit interview',
+        paraphrase: 'staff offboarding termination',
+        targetFile: 'HR-41-employee-separation-exit-interview-management.md',
+    },
+    {
+        exact: 'fixed assets depreciation',
+        paraphrase: 'capital equipment amortization',
+        targetFile: 'FA-11-fixed-assets-depreciation.md',
+    },
+    {
+        exact: 'fire inspection',
+        paraphrase: 'building safety walkthrough',
+        targetFile: 'RH-06-EN-3-fire-inspection-compliance.md',
+    },
+    {
+        exact: 'denial prediction',
+        paraphrase: 'claim rejection forecasting',
+        targetFile: 'PM-50-ai-denial-prediction-prevention.md',
+    },
+    {
+        exact: 'consent management',
+        paraphrase: 'patient authorization privacy releases',
+        targetFile: 'CL-11-consent-management-42cfr-part2.md',
+    },
+    {
+        exact: 'predictive maintenance',
+        paraphrase: 'equipment failure forecasting',
+        targetFile: 'FM-28-predictive-maintenance-ai.md',
+    },
+    { exact: 'incident reporting', paraphrase: 'adverse event tracking', targetFile: 'GR-09-incident-reporting.md' },
+    {
+        exact: 'tamper-evident hash chain',
+        paraphrase: 'immutable audit log integrity',
+        targetFile: 'FW-62-audit-trail-tamper-evident-hash-chain.md',
+    },
+];
+//# sourceMappingURL=recall-cases.js.map

package/dist/lib/recall-cases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-cases.js","sourceRoot":"","sources":["../../src/lib/recall-cases.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC;QACE,KAAK,EAAE,gBAAgB;QACvB,UAAU,EAAE,+BAA+B;QAC3C,UAAU,EAAE,wDAAwD;KACrE;IACD;QACE,KAAK,EAAE,2BAA2B;QAClC,UAAU,EAAE,gCAAgC;QAC5C,UAAU,EAAE,oCAAoC;KACjD;IACD;QACE,KAAK,EAAE,iBAAiB;QACxB,UAAU,EAAE,6BAA6B;QACzC,UAAU,EAAE,0CAA0C;KACvD;IACD;QACE,KAAK,EAAE,mBAAmB;QAC1B,UAAU,EAAE,6BAA6B;QACzC,UAAU,EAAE,0CAA0C;KACvD;IACD;QACE,KAAK,EAAE,oBAAoB;QAC3B,UAAU,EAAE,wCAAwC;QACpD,UAAU,EAAE,yCAAyC;KACtD;IACD;QACE,KAAK,EAAE,wBAAwB;QAC/B,UAAU,EAAE,+BAA+B;QAC3C,UAAU,EAAE,oCAAoC;KACjD;IACD,EAAE,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,wBAAwB,EAAE,UAAU,EAAE,6BAA6B,EAAE;IAChH;QACE,KAAK,EAAE,2BAA2B;QAClC,UAAU,EAAE,+BAA+B;QAC3C,UAAU,EAAE,gDAAgD;KAC7D;CACF,CAAC"}

package/dist/lib/repo.d.ts

@@ -0,0 +1,20 @@
+export declare function getRepoRoot(override?: string): string;
+export declare function specsRoot(repoRoot: string): string;
+/**
+ * Canonical fallback core ids. Mirrors `scripts/database/core-prefixes.ts` (CORE_PREFIXES).
+ * A direct cross-workspace import is not possible: this package compiles with
+ * `rootDir: ./src` (TS6059 on any import outside src/), and `bin/eos-spec.js` runs compiled
+ * `dist/` under plain node, which cannot load a `.ts` file from `scripts/` at runtime.
+ * Drift protection: repo.test.ts parses core-prefixes.ts at test time and asserts equality.
+ */
+export declare const FALLBACK_CORES: string[];
+export declare function coresList(repoRoot?: string): string[];
+/**
+ * Membership check against the configured core list — intentionally NOT dir-filtered:
+ * `create` must accept the first spec of a new core before its specs/{core}/ dir exists.
+ */
+export declare function isKnownCore(core: string, repoRoot?: string): boolean;
+/** Current git branch for repoRoot, or '' if undeterminable. */
+export declare function currentBranch(repoRoot: string): string;
+/** True on main/master — commands that mutate tracked files must refuse to --write here. */
+export declare function isProtectedBranch(repoRoot: string): boolean;

package/dist/lib/repo.js

@@ -0,0 +1,82 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { coresFromConfig, isKnownCoreFromConfig, loadConfig } from './config.js';
+let cachedRepoRoot = null;
+export function getRepoRoot(override) {
+    if (override) {
+        if (!existsSync(override)) {
+            throw new Error(`Repo root override does not exist: ${override}`);
+        }
+        return override;
+    }
+    if (cachedRepoRoot)
+        return cachedRepoRoot;
+    try {
+        cachedRepoRoot = execSync('git rev-parse --show-toplevel', { encoding: 'utf8' }).trim();
+        return cachedRepoRoot;
+    }
+    catch {
+        throw new Error('Could not determine repo root. Run from inside the encoreos repo or pass --repo-root.');
+    }
+}
+export function specsRoot(repoRoot) {
+    return join(repoRoot, 'specs');
+}
+/**
+ * Canonical fallback core ids. Mirrors `scripts/database/core-prefixes.ts` (CORE_PREFIXES).
+ * A direct cross-workspace import is not possible: this package compiles with
+ * `rootDir: ./src` (TS6059 on any import outside src/), and `bin/eos-spec.js` runs compiled
+ * `dist/` under plain node, which cannot load a `.ts` file from `scripts/` at runtime.
+ * Drift protection: repo.test.ts parses core-prefixes.ts at test time and asserts equality.
+ */
+export const FALLBACK_CORES = ['pf', 'ce', 'rh', 'fa', 'hr', 'gr', 'fw', 'fm', 'lo', 'it', 'cl', 'pm'];
+/** Keep only cores that actually have a `specs/{core}/` directory. specs/config.yaml lists
+ * `tr` (transcription module), which has no specs dir — scanning it yields phantom empty cores. */
+function withSpecsDir(cores, repoRoot) {
+    return cores.filter((core) => existsSync(join(repoRoot, 'specs', core)));
+}
+export function coresList(repoRoot) {
+    if (repoRoot) {
+        try {
+            const config = loadConfig(repoRoot);
+            return withSpecsDir(coresFromConfig(config), repoRoot);
+        }
+        catch {
+            // config unreadable — fall back to the canonical list, still dir-filtered
+        }
+        return withSpecsDir(FALLBACK_CORES, repoRoot);
+    }
+    return FALLBACK_CORES;
+}
+/**
+ * Membership check against the configured core list — intentionally NOT dir-filtered:
+ * `create` must accept the first spec of a new core before its specs/{core}/ dir exists.
+ */
+export function isKnownCore(core, repoRoot) {
+    if (repoRoot) {
+        try {
+            const config = loadConfig(repoRoot);
+            return isKnownCoreFromConfig(config, core);
+        }
+        catch {
+            // fall through
+        }
+    }
+    return FALLBACK_CORES.includes(core.toLowerCase());
+}
+/** Current git branch for repoRoot, or '' if undeterminable. */
+export function currentBranch(repoRoot) {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', { cwd: repoRoot, encoding: 'utf8' }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/** True on main/master — commands that mutate tracked files must refuse to --write here. */
+export function isProtectedBranch(repoRoot) {
+    const b = currentBranch(repoRoot);
+    return b === 'main' || b === 'master';
+}
+//# sourceMappingURL=repo.js.map

package/dist/lib/repo.js.map

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

package/dist/lib/requirements.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Typed acceptance-criteria / user-story / functional-requirement schema for spec
+ * frontmatter, plus a lenient normalizer. Adapted from encoreos's
+ * `ac-response-parser.ts`, but reads already-parsed YAML frontmatter values
+ * (objects) rather than an LLM JSON response, and coerces scalar Given/When/Then
+ * strings into single-element arrays so scalar-shaped legacy specs parse unchanged.
+ */
+/**
+ * AC/US/FR status lifecycle. Two of these are terminal-but-not-auto-proven and
+ * the audit's "AC Validated" gate treats them as closed (TOOL — issue #174):
+ * - `hand_closed`: proven by a CI suite the src-lane `verify-acs` prover can't
+ *   reach (runner/tool/e2e). REQUIRES a `## Verification` backlink in the spec
+ *   (the audit flags a hand_closed AC with no Verification section as a violation).
+ * - `deferred`: an explicit planned-by-design non-goal.
+ * A genuinely un-proven AC still reads `planned` and still fails the gate.
+ */
+export type RequirementStatus = 'planned' | 'verified' | 'hand_closed' | 'deferred';
+/** The status values the audit's "AC Validated" gate accepts as closed
+ *  (everything except `planned`). */
+export declare const TERMINAL_AC_STATUSES: readonly RequirementStatus[];
+export type AcceptanceCriterion = {
+    id: string;
+    userStory?: string;
+    status: RequirementStatus;
+    given: string[];
+    when: string[];
+    then: string[];
+    statementOnly: boolean;
+};
+export type UserStory = {
+    id: string;
+    text: string;
+};
+export type Requirement = {
+    id: string;
+    text: string;
+    status: RequirementStatus;
+};
+/** A structural problem found while normalizing — mapped to a ValidateIssue by the caller. */
+export type ShapeIssue = {
+    id?: string;
+    field: string;
+    message: string;
+};
+export declare const AC_ID_RE: RegExp;
+export declare const US_ID_RE: RegExp;
+export declare const FR_ID_RE: RegExp;
+/** Scalar string -> `[string]`; array -> trimmed non-empty strings; anything else -> `[]`. */
+export declare function coerceStringArray(v: unknown): string[];
+/**
+ * Normalizes a raw YAML frontmatter `acceptance_criteria` value into typed
+ * `AcceptanceCriterion` objects, collecting `ShapeIssue`s for any structural
+ * problems found. An entry with an unrecognized status is still included with
+ * `status` defaulted to `'planned'` plus a ShapeIssue — callers must check
+ * `issues` before trusting `status`.
+ */
+export declare function normalizeAcceptanceCriteria(raw: unknown): {
+    acs: AcceptanceCriterion[];
+    issues: ShapeIssue[];
+};
+export declare function normalizeUserStories(raw: unknown): {
+    uss: UserStory[];
+    issues: ShapeIssue[];
+};
+export declare function normalizeRequirements(raw: unknown): {
+    frs: Requirement[];
+    issues: ShapeIssue[];
+};
+/** Per-AC status tally for the pipeline status reader (consumed by the P3 audit).
+ *  `hand_closed` and `deferred` are terminal-but-not-`planned` statuses the audit
+ *  treats as closed (issue #174); they are counted separately so the audit can
+ *  still apply the Verification-backlink guard to `hand_closed`. */
+export declare function acStatusCounts(raw: unknown): AcStatusCounts;
+export type AcStatusCounts = {
+    planned: number;
+    verified: number;
+    handClosed: number;
+    deferred: number;
+};
+/**
+ * True when a spec has ≥1 acceptance criterion and EVERY (well-formed) AC is in a
+ * terminal status (`verified` | `hand_closed` | `deferred`) — i.e. none remain
+ * `planned`. This is the typed, ADR-0015-aware replacement for the legacy
+ * `status === 'verified'` check `specs.ts` used to hand-roll: a `hand_closed`
+ * (proven by a CI suite the src-lane prover can't reach) or `deferred` AC
+ * terminally resolves the generate-tests gate exactly as a `verified` one does
+ * (issue #174). Malformed (id-less) AC entries are dropped by
+ * `normalizeAcceptanceCriteria` — and `validate` flags them — so they are not
+ * counted here; an empty / non-array value is `false`.
+ */
+export declare function allAcceptanceCriteriaTerminal(raw: unknown): boolean;