@snag-run/core 0.3.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 David Taing
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,5 @@
+Snag — @snag-run/core
+Copyright 2026 David Taing
+
+This product is licensed under the Apache License, Version 2.0.
+See the LICENSE file in this directory for the full license text.

package/README.md

@@ -0,0 +1,22 @@
+# @snag-run/core
+
+Snag Map deterministic core — the `failure-map/v1` Zod schema plus the pure map
+machinery (severity banding, source-anchor normalization, lint, and
+embedding-free reconciliation). Browser-safe by construction (zod only, no Node
+built-ins), so both [`@snag-run/cli`](https://www.npmjs.com/package/@snag-run/cli)
+and the browser renderer depend on it directly.
+
+> Status: pre-v1.0.0 — early release. The map schema may change before `1.0`.
+
+Part of [snag](https://snag.run) — see [snag.run/docs](https://snag.run/docs) for
+the full documentation and a live demo.
+
+## Install
+
+```sh
+npm install @snag-run/core
+```
+
+## License
+
+Apache-2.0 © David Taing. See [LICENSE](./LICENSE).

package/dist/anchor.d.ts

@@ -0,0 +1,58 @@
+/** Lowercase the text and split into the set of content tokens: alphanumeric
+ * runs, longer than one char, that are not stopwords. */
+export declare function tokenize(text: string): Set<string>;
+/** Jaccard similarity of two token sets (|A∩B| / |A∪B|). 0 when either is
+ * empty or they share nothing. */
+export declare function jaccard(a: ReadonlySet<string>, b: ReadonlySet<string>): number;
+/**
+ * Extract the ordered H2/H3 heading texts from a Markdown document — the closed
+ * anchor vocabulary for a document subject. Parenthetical qualifiers and
+ * backticks are stripped so the heading matches the way the model tends to cite
+ * it (`## Generation (structured output)` → `Generation`).
+ */
+export declare function extractHeadings(markdown: string): string[];
+/** A named symbol and the line it starts on — the closed anchor vocabulary for a
+ * code subject. */
+export interface SymbolDef {
+    readonly file: string;
+    readonly line: number;
+    readonly name: string;
+}
+/**
+ * Extract named function declarations from a TS/JS source file — the closed
+ * anchor vocabulary for a code subject. A deliberately naive port of the M1.5
+ * probe: it catches `function foo` / `export async function foo`, the clean
+ * enclosing-function boundaries, and nothing richer (arrow consts, class methods,
+ * other languages). Symbol resolution via AST/LSP is deferred (#290); this is
+ * enough for the exact-anchor spine and its golden fixtures.
+ */
+export declare function extractSymbols(file: string, source: string): SymbolDef[];
+/**
+ * Normalize a document `sourceRef` to its nearest H2/H3 heading by token-Jaccard.
+ * Composite refs are split on `;` and `:` and the best (fragment, heading) pair
+ * wins. Returns `null` when no fragment shares a content token with any heading
+ * — an unanchored ref must NOT collide with others (returning a default heading
+ * would bucket every no-match node together and cause false carries).
+ */
+export declare function normalizeDocAnchor(ref: string | undefined, headings: readonly string[]): string | null;
+/**
+ * Normalize a code `sourceRef` (`file:line` or `file:line-line`) to its
+ * enclosing named symbol, as `"<file>:<symbol>"`. Returns `null` when the ref is
+ * unparseable or the line sits above the first symbol (top-level) — a top-level
+ * ref must NOT collide, same safety rationale as the doc anchor.
+ */
+export declare function normalizeCodeAnchor(ref: string | undefined, symbols: readonly SymbolDef[]): string | null;
+/** The closed source vocabulary a subject's refs are normalized against —
+ * headings for a document subject, symbols for a code subject. The caller
+ * extracts it from the artifact on disk so the engine stays source-free. */
+export type AnchorVocab = {
+    readonly kind: "headings";
+    readonly headings: readonly string[];
+} | {
+    readonly kind: "symbols";
+    readonly symbols: readonly SymbolDef[];
+};
+/** Normalize a `sourceRef` against the supplied vocabulary, dispatching on its
+ * kind. `null` means the ref anchored to nothing (it will not carry an id). */
+export declare function anchorForRef(ref: string | undefined, vocab: AnchorVocab): string | null;
+//# sourceMappingURL=anchor.d.ts.map

package/dist/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../src/anchor.ts"],"names":[],"mappings":"AAyBA;yDACyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAOlD;AAED;kCACkC;AAClC,wBAAgB,OAAO,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM,CAK9E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAa1D;AAED;mBACmB;AACnB,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CASxE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,MAAM,GAAG,IAAI,CAsBf;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,OAAO,EAAE,SAAS,SAAS,EAAE,GAC5B,MAAM,GAAG,IAAI,CAiBf;AAED;;4EAE4E;AAC5E,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAAC;AAEzE;+EAC+E;AAC/E,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,KAAK,EAAE,WAAW,GACjB,MAAM,GAAG,IAAI,CAIf"}

package/dist/anchor.js

@@ -0,0 +1,145 @@
+// Source-anchor normalization for reconcile() (#305, EXP 0001 M1.5 / ADR 0002).
+//
+// A failure node's free-text `sourceRef` is too noisy to key reconciliation on
+// directly (the backend PRD collapsed to 0% exact-carry on raw refs). The lever
+// that works is to normalize each ref to the subject's CLOSED vocabulary — the
+// document's H2/H3 headings, or the code's enclosing symbol — so that the same
+// failure mode lands on the same anchor across regenerations even when the model
+// rewords the citation. M1.5 measured this carrying 43%→89% (doc) and 68%→92%
+// (code). The anchor is the Layer-1 match key; it replaces the content
+// `fingerprint`, which carries ~0% across regenerations (the model rewords prose
+// every run) and survives only as a byte-identical fast-path in reconcile().
+//
+// The engine stays source-free at runtime: the caller supplies the closed
+// vocabulary ({@link AnchorVocab}) extracted from the artifact on disk (see
+// {@link extractHeadings} / {@link extractSymbols}). This keeps reconcile() pure.
+/** Stopwords dropped before token-Jaccard so heading matching keys on the
+ * content words, not connective tissue. Ported from the EXP 0001 M1.5 probe. */
+const STOPWORDS = new Set(("the a an of to and or for with in on at by from is are be this that it as " +
+    "into when then than but not no yes via per its their our your you we they").split(" "));
+/** Lowercase the text and split into the set of content tokens: alphanumeric
+ * runs, longer than one char, that are not stopwords. */
+export function tokenize(text) {
+    const out = new Set();
+    for (const match of text.toLowerCase().matchAll(/[a-z0-9]+/g)) {
+        const token = match[0];
+        if (token.length > 1 && !STOPWORDS.has(token))
+            out.add(token);
+    }
+    return out;
+}
+/** Jaccard similarity of two token sets (|A∩B| / |A∪B|). 0 when either is
+ * empty or they share nothing. */
+export function jaccard(a, b) {
+    if (a.size === 0 || b.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const token of a)
+        if (b.has(token))
+            intersection += 1;
+    return intersection / (a.size + b.size - intersection);
+}
+/**
+ * Extract the ordered H2/H3 heading texts from a Markdown document — the closed
+ * anchor vocabulary for a document subject. Parenthetical qualifiers and
+ * backticks are stripped so the heading matches the way the model tends to cite
+ * it (`## Generation (structured output)` → `Generation`).
+ */
+export function extractHeadings(markdown) {
+    const out = [];
+    for (const line of markdown.split(/\r?\n/)) {
+        const match = /^(#{2,3})\s+(.*)/.exec(line);
+        if (match) {
+            const heading = match[2]
+                .replace(/\(.*?\)/g, "")
+                .replace(/`/g, "")
+                .trim();
+            if (heading)
+                out.push(heading);
+        }
+    }
+    return out;
+}
+/**
+ * Extract named function declarations from a TS/JS source file — the closed
+ * anchor vocabulary for a code subject. A deliberately naive port of the M1.5
+ * probe: it catches `function foo` / `export async function foo`, the clean
+ * enclosing-function boundaries, and nothing richer (arrow consts, class methods,
+ * other languages). Symbol resolution via AST/LSP is deferred (#290); this is
+ * enough for the exact-anchor spine and its golden fixtures.
+ */
+export function extractSymbols(file, source) {
+    const out = [];
+    source.split(/\r?\n/).forEach((line, index) => {
+        const match = /^\s*(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_][A-Za-z0-9_]*)/.exec(line);
+        if (match)
+            out.push({ file, line: index + 1, name: match[1] });
+    });
+    return out.sort((a, b) => a.line - b.line);
+}
+/**
+ * Normalize a document `sourceRef` to its nearest H2/H3 heading by token-Jaccard.
+ * Composite refs are split on `;` and `:` and the best (fragment, heading) pair
+ * wins. Returns `null` when no fragment shares a content token with any heading
+ * — an unanchored ref must NOT collide with others (returning a default heading
+ * would bucket every no-match node together and cause false carries).
+ */
+export function normalizeDocAnchor(ref, headings) {
+    if (!ref)
+        return null;
+    const headingTokens = headings.map((h) => [h, tokenize(h)]);
+    const fragments = ref
+        .split(/[;:]/)
+        .map((f) => f.trim())
+        .filter((f) => f.length > 0);
+    const candidates = fragments.length > 0 ? fragments : [ref];
+    let best = null;
+    let bestScore = 0; // strict `>` from 0 means a zero-overlap ref stays null
+    for (const fragment of candidates) {
+        const fragmentTokens = tokenize(fragment);
+        for (const [heading, tokens] of headingTokens) {
+            const score = jaccard(fragmentTokens, tokens);
+            if (score > bestScore) {
+                bestScore = score;
+                best = heading;
+            }
+        }
+    }
+    return best;
+}
+/**
+ * Normalize a code `sourceRef` (`file:line` or `file:line-line`) to its
+ * enclosing named symbol, as `"<file>:<symbol>"`. Returns `null` when the ref is
+ * unparseable or the line sits above the first symbol (top-level) — a top-level
+ * ref must NOT collide, same safety rationale as the doc anchor.
+ */
+export function normalizeCodeAnchor(ref, symbols) {
+    if (!ref)
+        return null;
+    const lastColon = ref.lastIndexOf(":");
+    if (lastColon <= 0)
+        return null;
+    const file = ref.slice(0, lastColon);
+    const lineMatch = /^(\d+)/.exec(ref.slice(lastColon + 1).trim());
+    if (!lineMatch)
+        return null;
+    const lineno = Number.parseInt(lineMatch[1], 10);
+    let enclosing = null;
+    for (const symbol of symbols
+        .filter((s) => s.file === file)
+        .sort((a, b) => a.line - b.line)) {
+        if (symbol.line <= lineno)
+            enclosing = symbol.name;
+        else
+            break;
+    }
+    return enclosing ? `${file}:${enclosing}` : null;
+}
+/** Normalize a `sourceRef` against the supplied vocabulary, dispatching on its
+ * kind. `null` means the ref anchored to nothing (it will not carry an id). */
+export function anchorForRef(ref, vocab) {
+    return vocab.kind === "headings"
+        ? normalizeDocAnchor(ref, vocab.headings)
+        : normalizeCodeAnchor(ref, vocab.symbols);
+}
+//# sourceMappingURL=anchor.js.map

package/dist/anchor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export declare const CORE_PACKAGE: "@snag-run/core";
+export { failureMapSchema, generationSchema, generationSchemaNoNumericBounds, generationSchemaCode, generationSchemaCodeNoNumericBounds, flatGenerationSchema, nodeSchema, flowNodeSchema, failureNodeSchema, edgeSchema, scoresSchema, subjectSchema, metaSchema, HARNESSES, DEFAULT_HARNESS, SCHEMA_ID, parseGeneration, parseFailureMap, normalizeFlatGeneration, coerceNodeIds, isCodeIntakeKind, scopePathsFromRef, sourceRefProblem, } from "./schema.js";
+export type { FailureMap, Generation, FlatGeneration, Node, FlowNode, FailureNode, Edge, Scores, Subject, Meta, Harness, } from "./schema.js";
+export { reconcile, applyReconcile } from "./reconcile.js";
+export type { ReconcileDelta, ReconcileOptions, CarriedNode, CandidateContinuation, } from "./reconcile.js";
+export { tokenize, jaccard, extractHeadings, extractSymbols, normalizeDocAnchor, normalizeCodeAnchor, anchorForRef, } from "./anchor.js";
+export type { AnchorVocab, SymbolDef } from "./anchor.js";
+export { severityBand, SEVERITY_BANDS } from "./severity.js";
+export type { SeverityBand } from "./severity.js";
+export { lintGeneration } from "./lint.js";
+export type { LintWarning, LintCode } from "./lint.js";
+export { noopOnLog, summarizeToolArgs } from "./log.js";
+export type { HarnessLogEvent, OnLogFn } from "./log.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,YAAY,EAAG,gBAAyB,CAAC;AAEtD,OAAO,EAEL,gBAAgB,EAChB,gBAAgB,EAChB,+BAA+B,EAC/B,oBAAoB,EACpB,mCAAmC,EACnC,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,eAAe,EACf,SAAS,EAET,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,aAAa,EAEb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,IAAI,EACJ,MAAM,EACN,OAAO,EACP,IAAI,EACJ,OAAO,GACR,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,QAAQ,EACR,OAAO,EACP,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAKvD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,25 @@
+// @snag-run/core — Snag Map deterministic core (the "stays" half of the engine
+// split, ADR 0011). Browser-safe by construction: zod only, zero `node:`
+// built-ins — enforced via tsconfig `types: []` (no node globals compile). The
+// CLI and renderer depend on this; the archived engine leaves depend on it too.
+export const CORE_PACKAGE = "@snag-run/core";
+export { 
+// schemas
+failureMapSchema, generationSchema, generationSchemaNoNumericBounds, generationSchemaCode, generationSchemaCodeNoNumericBounds, flatGenerationSchema, nodeSchema, flowNodeSchema, failureNodeSchema, edgeSchema, scoresSchema, subjectSchema, metaSchema, HARNESSES, DEFAULT_HARNESS, SCHEMA_ID, 
+// parse/validate fns
+parseGeneration, parseFailureMap, normalizeFlatGeneration, coerceNodeIds, 
+// code-intake sourceRef grounding (#272)
+isCodeIntakeKind, scopePathsFromRef, sourceRefProblem, } from "./schema.js";
+// reconcile() — exact-anchor identity carry (#305, ADR 0002). The OSS,
+// embedding-free Layer-1 reconciliation: match a fresh proposal to the committed
+// prior map so an unchanged failure mode keeps its id.
+export { reconcile, applyReconcile } from "./reconcile.js";
+// Source-anchor normalization (the Layer-1 match key for reconcile()).
+export { tokenize, jaccard, extractHeadings, extractSymbols, normalizeDocAnchor, normalizeCodeAnchor, anchorForRef, } from "./anchor.js";
+export { severityBand, SEVERITY_BANDS } from "./severity.js";
+export { lintGeneration } from "./lint.js";
+// Harness logging seam (#45) — the structured, opt-in side-channel event the
+// engine emits during a run; the type + no-op sink land in core (ADR 0011:
+// parked, retire if unused post-extraction).
+export { noopOnLog, summarizeToolArgs } from "./log.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,yEAAyE;AACzE,+EAA+E;AAC/E,gFAAgF;AAEhF,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAyB,CAAC;AAEtD,OAAO;AACL,UAAU;AACV,gBAAgB,EAChB,gBAAgB,EAChB,+BAA+B,EAC/B,oBAAoB,EACpB,mCAAmC,EACnC,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,eAAe,EACf,SAAS;AACT,qBAAqB;AACrB,eAAe,EACf,eAAe,EACf,uBAAuB,EACvB,aAAa;AACb,yCAAyC;AACzC,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAgBrB,uEAAuE;AACvE,iFAAiF;AACjF,uDAAuD;AACvD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQ3D,uEAAuE;AACvE,OAAO,EACL,QAAQ,EACR,OAAO,EACP,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,6EAA6E;AAC7E,2EAA2E;AAC3E,6CAA6C;AAC7C,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC"}

package/dist/lint.d.ts

@@ -0,0 +1,19 @@
+import { type Generation, type Subject } from "./schema.js";
+export type LintCode = "orphan-failure" | "no-terminal-reach" | "unreachable-node" | "oversize-document" | "gather-incomplete" | "temperature-ignored" | "degenerate-duplicate" | "uncited-code-failure";
+export interface LintWarning {
+    code: LintCode;
+    message: string;
+    /** The node id the warning concerns, when applicable. */
+    nodeId?: string;
+}
+/**
+ * Run the soft lint checks over a generation analysis. Returns warnings;
+ * an empty array means clean. Never throws on lint findings.
+ *
+ * `subject` is optional: when it is a code intake (`module`/`capability`), each
+ * failure node is additionally checked for a valid in-scope `file:line` sourceRef
+ * (#272) and an `uncited-code-failure` warning is emitted for any that lack one.
+ * Omitted/spec subjects skip that check entirely.
+ */
+export declare function lintGeneration(generation: Generation, subject?: Subject): LintWarning[];
+//# sourceMappingURL=lint.d.ts.map

package/dist/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../src/lint.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,OAAO,EACb,MAAM,aAAa,CAAC;AAOrB,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,mBAAmB,GACnB,kBAAkB,GAIlB,mBAAmB,GAInB,mBAAmB,GAKnB,qBAAqB,GAQrB,sBAAsB,GAQtB,sBAAsB,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,OAAO,GAChB,WAAW,EAAE,CAmJf"}