@sun-asterisk/sungen 3.2.34-beta.1 → 3.3.0-alpha.1

package/dist/basis/anchor-grammar.d.ts

@@ -0,0 +1,32 @@
+export type AnchorKind = 'item' | 'validation' | 'section';
+export type AnchorConfidence = 'EXTRACTED' | 'INFERRED' | 'AMBIGUOUS';
+/** Score band per label (takumi confidence taxonomy): inclusive lower, inclusive upper. */
+export declare const CONFIDENCE_BANDS: Record<AnchorConfidence, readonly [number, number]>;
+export interface ParsedAnchorId {
+    kind: AnchorKind;
+    docId?: string;
+    itemId?: string;
+    slug?: string;
+}
+export declare function parseAnchorId(id: string): ParsedAnchorId | null;
+export declare function isItemAnchorId(id: string): boolean;
+export declare function isDocId(id: string): boolean;
+export declare function itemAnchorId(docId: string, itemId: string, validation?: boolean): string;
+/**
+ * BM-51 §4.1 numbers items `1.0, 2.0 …` under a bold section row; the composed id drops the `.0`
+ * (`2.0` under `A` → `A-2`) and keeps a real sub-number (`2.1` → `A-2.1`). No section → null.
+ */
+export declare function composeItemId(section: string | null, itemNumber: string): string | null;
+/** `sec-<slug>` from a heading: accents folded, ASCII kebab-case; a script with no ASCII gets a hash. */
+export declare function sectionAnchorId(heading: string): string;
+export interface CitationBase {
+    repo: string;
+    sha: string;
+    path: string;
+}
+export declare function formatCitation(base: CitationBase, startLine: number, endLine: number): string;
+export declare function parseCitation(s: string): (CitationBase & {
+    start: number;
+    end: number;
+}) | null;
+//# sourceMappingURL=anchor-grammar.d.ts.map

package/dist/basis/anchor-grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-grammar.d.ts","sourceRoot":"","sources":["../../src/basis/anchor-grammar.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtE,2FAA2F;AAC3F,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAIhF,CAAC;AAQF,MAAM,WAAW,cAAc;IAAG,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAEpG,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAK/D;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,MAAM,CAEtF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIvF;AAED,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAEzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7F;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAM/F"}

package/dist/basis/anchor-grammar.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONFIDENCE_BANDS = void 0;
+exports.parseAnchorId = parseAnchorId;
+exports.isItemAnchorId = isItemAnchorId;
+exports.isDocId = isDocId;
+exports.itemAnchorId = itemAnchorId;
+exports.composeItemId = composeItemId;
+exports.sectionAnchorId = sectionAnchorId;
+exports.formatCitation = formatCitation;
+exports.parseCitation = parseCitation;
+/**
+ * Anchor grammar and the shared trace vocabulary (DOS-12.1, DOS-12.2; takumi T7).
+ *
+ * | anchor                     | example                  | label       |
+ * |----------------------------|--------------------------|-------------|
+ * | `<docId>#<itemId>`         | `SPEC-AUTH-001#A-2`      | `EXTRACTED` |
+ * | `<docId>#<itemId>/val`     | `SPEC-AUTH-001#A-2/val`  | `EXTRACTED` |
+ * | `sec-<slug>`               | `sec-login-form`         | `INFERRED`  |
+ * | duplicate id / fuzzy match | —                        | `AMBIGUOUS` |
+ *
+ * docId is the spec frontmatter `id`; itemId is COMPOSED from BM-51 §4.1 (`2.0` under section row
+ * `A` → `A-2`). BM-51 has no `VAL-xx` codes: a Validation row is keyed by its item. `screen_id` is
+ * metadata and never part of an anchor. Every anchor is cited as `repo@SHA:path#Lx-Ly`.
+ */
+const crypto_1 = require("crypto");
+/** Score band per label (takumi confidence taxonomy): inclusive lower, inclusive upper. */
+exports.CONFIDENCE_BANDS = {
+    EXTRACTED: [0.9, 1],
+    INFERRED: [0.5, 0.89],
+    AMBIGUOUS: [0, 0.49],
+};
+const DOC_ID = '[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)+';
+const ITEM_ID = '[A-Z]+-\\d+(?:\\.\\d+)?';
+const ITEM_ANCHOR_RE = new RegExp(`^(${DOC_ID})#(${ITEM_ID})(/val)?$`);
+const SECTION_ANCHOR_RE = /^sec-[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const CITATION_RE = /^([^@\s]+)@([^:\s]+):([^#\s]+)#L(\d+)-L(\d+)$/;
+function parseAnchorId(id) {
+    const item = ITEM_ANCHOR_RE.exec(id);
+    if (item)
+        return { kind: item[3] ? 'validation' : 'item', docId: item[1], itemId: item[2] };
+    if (SECTION_ANCHOR_RE.test(id))
+        return { kind: 'section', slug: id.slice(4) };
+    return null;
+}
+function isItemAnchorId(id) {
+    return ITEM_ANCHOR_RE.test(id);
+}
+function isDocId(id) {
+    return new RegExp(`^${DOC_ID}$`).test(id);
+}
+function itemAnchorId(docId, itemId, validation = false) {
+    return `${docId}#${itemId}${validation ? '/val' : ''}`;
+}
+/**
+ * BM-51 §4.1 numbers items `1.0, 2.0 …` under a bold section row; the composed id drops the `.0`
+ * (`2.0` under `A` → `A-2`) and keeps a real sub-number (`2.1` → `A-2.1`). No section → null.
+ */
+function composeItemId(section, itemNumber) {
+    if (!section || !/^[A-Z]+$/.test(section))
+        return null;
+    const n = itemNumber.trim().replace(/\.0+$/, '');
+    return /^\d+(?:\.\d+)?$/.test(n) ? `${section}-${n}` : null;
+}
+/** `sec-<slug>` from a heading: accents folded, ASCII kebab-case; a script with no ASCII gets a hash. */
+function sectionAnchorId(heading) {
+    const slug = heading.normalize('NFKD').replace(/\p{M}/gu, '').replace(/[đĐ]/g, 'd').toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+    return `sec-${slug || (0, crypto_1.createHash)('sha1').update(heading).digest('hex').slice(0, 8)}`;
+}
+function formatCitation(base, startLine, endLine) {
+    return `${base.repo}@${base.sha}:${base.path.replace(/\\/g, '/')}#L${startLine}-L${endLine}`;
+}
+function parseCitation(s) {
+    const m = CITATION_RE.exec(s);
+    if (!m)
+        return null;
+    const start = Number(m[4]);
+    const end = Number(m[5]);
+    return start >= 1 && end >= start ? { repo: m[1], sha: m[2], path: m[3], start, end } : null;
+}
+//# sourceMappingURL=anchor-grammar.js.map

package/dist/basis/anchor-grammar.js.map

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

package/dist/basis/anchor-hash.d.ts

@@ -0,0 +1,6 @@
+export type HashAlgo = 'sha1-12' | 'sha256-12';
+export declare function sectionHash(bodyLines: string[]): string;
+/** One table row as compared: cells trimmed, inner whitespace collapsed, joined by `|`. */
+export declare function normalizeRow(cells: string[]): string;
+export declare function itemRowHash(cells: string[]): string;
+//# sourceMappingURL=anchor-hash.d.ts.map

package/dist/basis/anchor-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-hash.d.ts","sourceRoot":"","sources":["../../src/basis/anchor-hash.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAE/C,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD;AAED,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnD"}

package/dist/basis/anchor-hash.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sectionHash = sectionHash;
+exports.normalizeRow = normalizeRow;
+exports.itemRowHash = itemRowHash;
+/**
+ * Hash by anchor kind (DOS-12.3, red-team #1).
+ *
+ * | anchor kind                  | hash        | why                                                      |
+ * |------------------------------|-------------|----------------------------------------------------------|
+ * | section `sec-<slug>` (legacy) | `sha1-12`   | every manifest already on disk holds these; a new algorithm would read "changed" everywhere |
+ * | item `<docId>#<itemId>`       | `sha256-12` | new in schema 2, so nothing old depends on it            |
+ *
+ * `sectionHash` is the exact computation the manifest has always used: sha1 over the section
+ * body joined with LF and trimmed, first 12 hex. Do not "improve" it.
+ */
+const crypto_1 = require("crypto");
+function sectionHash(bodyLines) {
+    return (0, crypto_1.createHash)('sha1').update(bodyLines.join('\n').trim()).digest('hex').slice(0, 12);
+}
+/** One table row as compared: cells trimmed, inner whitespace collapsed, joined by `|`. */
+function normalizeRow(cells) {
+    return cells.map((c) => c.normalize('NFC').replace(/\s+/g, ' ').trim()).join('|');
+}
+function itemRowHash(cells) {
+    return (0, crypto_1.createHash)('sha256').update(normalizeRow(cells)).digest('hex').slice(0, 12);
+}
+//# sourceMappingURL=anchor-hash.js.map

package/dist/basis/anchor-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-hash.js","sourceRoot":"","sources":["../../src/basis/anchor-hash.ts"],"names":[],"mappings":";;AAeA,kCAEC;AAGD,oCAEC;AAED,kCAEC;AA1BD;;;;;;;;;;GAUG;AACH,mCAAoC;AAIpC,SAAgB,WAAW,CAAC,SAAmB;IAC7C,OAAO,IAAA,mBAAU,EAAC,MAAM,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,2FAA2F;AAC3F,SAAgB,YAAY,CAAC,KAAe;IAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpF,CAAC;AAED,SAAgB,WAAW,CAAC,KAAe;IACzC,OAAO,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/basis/bm51-tables.d.ts

@@ -0,0 +1,20 @@
+export type Bm51TableKind = 'item' | 'validation' | 'mapping' | 'event';
+export interface Bm51Row {
+    table: Bm51TableKind;
+    cells: string[];
+    id: string;
+    line: number;
+}
+export interface Bm51ItemRow extends Bm51Row {
+    section: string | null;
+    itemId: string | null;
+}
+export interface Bm51Tables {
+    items: Bm51ItemRow[];
+    validations: Bm51Row[];
+    mappings: Bm51Row[];
+    events: Bm51Row[];
+}
+/** `lines` are the spec's lines; `firstLine` is the 1-based number of `lines[0]`. */
+export declare function readBm51Tables(lines: string[], firstLine?: number): Bm51Tables;
+//# sourceMappingURL=bm51-tables.d.ts.map

package/dist/basis/bm51-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm51-tables.d.ts","sourceRoot":"","sources":["../../src/basis/bm51-tables.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,CAAC;AAExE,MAAM,WAAW,OAAO;IAAG,KAAK,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC5F,MAAM,WAAW,WAAY,SAAQ,OAAO;IAAG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAC9F,MAAM,WAAW,UAAU;IAAG,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,WAAW,EAAE,OAAO,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAAC,MAAM,EAAE,OAAO,EAAE,CAAA;CAAE;AAqBpH,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,SAAI,GAAG,UAAU,CAwBzE"}

package/dist/basis/bm51-tables.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readBm51Tables = readBm51Tables;
+/**
+ * Read the BM-51 screen-spec tables that carry item ids (company standard, DOS-12.0).
+ *
+ * `reports/mng/specs/_templates/BM-2-901-51-screen-specification-template.md`:
+ *   §4.1 Item          `| ID | Item Name | Item Type | Required | Note |`  — bold section row `A`, then `1.0`, `2.0` …
+ *   §4.2 Validation    `| ID | Type | Min | Max | Default | … |`          — rows keyed by the composed id `A-2`
+ *   §4.3 Data Mapping  `| ID | Data Source | API ID | … |`                — same key
+ *   §5   Event         `| ID | Given (Pre-condition) | … |`               — same key, or `-`
+ *
+ * Tables are recognised by their header (first column `ID` plus the second column's name), not by
+ * heading numbers, so a translated heading still reads. Rows keep their 1-based source line.
+ */
+const anchor_grammar_1 = require("./anchor-grammar");
+const SEPARATOR = /^\|?\s*:?-{3,}:?\s*(\|\s*:?-{3,}:?\s*)*\|?\s*$/;
+const COMPOSED_ID = /^[A-Z]+-\d+(?:\.\d+)?$/;
+function splitRow(line) {
+    const body = line.trim().replace(/^\|/, '').replace(/\|$/, '');
+    return body.split(/(?<!\\)\|/).map((c) => c.replace(/\\\|/g, '|').trim());
+}
+const bare = (cell) => cell.replace(/\*\*|__|`/g, '').trim();
+function kindOf(header) {
+    if (bare(header[0] ?? '').toUpperCase() !== 'ID')
+        return null;
+    const second = bare(header[1] ?? '').toLowerCase();
+    if (second === 'item name')
+        return 'item';
+    if (second === 'type')
+        return 'validation';
+    if (second === 'data source')
+        return 'mapping';
+    if (second.startsWith('given'))
+        return 'event';
+    return null;
+}
+/** `lines` are the spec's lines; `firstLine` is the 1-based number of `lines[0]`. */
+function readBm51Tables(lines, firstLine = 1) {
+    const out = { items: [], validations: [], mappings: [], events: [] };
+    for (let i = 0; i < lines.length - 1; i++) {
+        if (!lines[i].trim().startsWith('|') || !SEPARATOR.test(lines[i + 1].trim()))
+            continue;
+        const kind = kindOf(splitRow(lines[i]));
+        let j = i + 2;
+        let section = null;
+        for (; j < lines.length && lines[j].trim().startsWith('|'); j++) {
+            if (!kind)
+                continue;
+            const cells = splitRow(lines[j]);
+            const id = bare(cells[0] ?? '');
+            const line = firstLine + j;
+            if (kind === 'item') {
+                if (/^[A-Z]+$/.test(id)) {
+                    section = id;
+                    continue;
+                }
+                if (!/^\d+(?:\.\d+)?$/.test(id))
+                    continue;
+                out.items.push({ table: kind, cells, id, line, section, itemId: (0, anchor_grammar_1.composeItemId)(section, id) });
+            }
+            else if (COMPOSED_ID.test(id)) {
+                const row = { table: kind, cells, id, line };
+                (kind === 'validation' ? out.validations : kind === 'mapping' ? out.mappings : out.events).push(row);
+            }
+        }
+        i = j - 1;
+    }
+    return out;
+}
+//# sourceMappingURL=bm51-tables.js.map

package/dist/basis/bm51-tables.js.map

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

package/dist/basis/extract-spec-anchors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Every anchor a `spec.md` offers, with its hash, confidence label and citation (DOS-12.1 – 12.3).
+ *
+ *   section  `sec-<slug>`             sha1-12 of the section body (the manifest's hash)   INFERRED
+ *   item     `<docId>#<itemId>`       sha256-12 of the normalized §4.1 row                EXTRACTED
+ *   val      `<docId>#<itemId>/val`   sha256-12 of the normalized §4.2 row                EXTRACTED
+ *   a duplicate id, or a §4.2 row naming no §4.1 item                                    AMBIGUOUS
+ *
+ * A §4.3 / §5 row naming no §4.1 item is reported in `orphans` (AMBIGUOUS, not an error). Item
+ * anchors need a docId (frontmatter `id`); without one only section anchors exist. Pointers and
+ * hashes only — no spec text leaves this function (red-team #14).
+ */
+import { AnchorConfidence, AnchorKind, CitationBase } from './anchor-grammar';
+import { HashAlgo } from './anchor-hash';
+import { SpecFrontmatter } from './spec-frontmatter';
+export interface SourceAnchor {
+    id: string;
+    kind: AnchorKind;
+    confidence: AnchorConfidence;
+    hash: string;
+    hashAlgo: HashAlgo;
+    location: string;
+    /** Why the label is AMBIGUOUS. */
+    note?: string;
+}
+export interface OrphanReference {
+    table: 'mapping' | 'event';
+    itemId: string;
+    location: string;
+    confidence: 'AMBIGUOUS';
+}
+export interface SpecAnchors {
+    frontmatter: SpecFrontmatter;
+    anchors: SourceAnchor[];
+    orphans: OrphanReference[];
+    problems: string[];
+}
+export declare function extractSpecAnchors(text: string, citation: CitationBase): SpecAnchors;
+//# sourceMappingURL=extract-spec-anchors.d.ts.map

package/dist/basis/extract-spec-anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-spec-anchors.d.ts","sourceRoot":"","sources":["../../src/basis/extract-spec-anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAiD,MAAM,kBAAkB,CAAC;AAC7H,OAAO,EAAE,QAAQ,EAA4B,MAAM,eAAe,CAAC;AAGnE,OAAO,EAAuB,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAAG,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,WAAW,CAAA;CAAE;AAE1H,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,eAAe,CAAC;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAWD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,CA+CpF"}

package/dist/basis/extract-spec-anchors.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractSpecAnchors = extractSpecAnchors;
+/**
+ * Every anchor a `spec.md` offers, with its hash, confidence label and citation (DOS-12.1 – 12.3).
+ *
+ *   section  `sec-<slug>`             sha1-12 of the section body (the manifest's hash)   INFERRED
+ *   item     `<docId>#<itemId>`       sha256-12 of the normalized §4.1 row                EXTRACTED
+ *   val      `<docId>#<itemId>/val`   sha256-12 of the normalized §4.2 row                EXTRACTED
+ *   a duplicate id, or a §4.2 row naming no §4.1 item                                    AMBIGUOUS
+ *
+ * A §4.3 / §5 row naming no §4.1 item is reported in `orphans` (AMBIGUOUS, not an error). Item
+ * anchors need a docId (frontmatter `id`); without one only section anchors exist. Pointers and
+ * hashes only — no spec text leaves this function (red-team #14).
+ */
+const anchor_grammar_1 = require("./anchor-grammar");
+const anchor_hash_1 = require("./anchor-hash");
+const bm51_tables_1 = require("./bm51-tables");
+const spec_sections_1 = require("./spec-sections");
+const spec_frontmatter_1 = require("./spec-frontmatter");
+/** Mark every anchor whose id occurs more than once as AMBIGUOUS — a human must pick. */
+function flagDuplicates(anchors) {
+    const count = new Map();
+    for (const a of anchors)
+        count.set(a.id, (count.get(a.id) ?? 0) + 1);
+    for (const a of anchors) {
+        if ((count.get(a.id) ?? 0) > 1) {
+            a.confidence = 'AMBIGUOUS';
+            a.note = 'duplicate id';
+        }
+    }
+}
+function extractSpecAnchors(text, citation) {
+    const lines = text.replace(/^/, '').replace(/\r\n?/g, '\n').split('\n');
+    const fm = (0, spec_frontmatter_1.readSpecFrontmatter)(text, citation.path);
+    const problems = [...fm.problems];
+    const cite = (start, end) => (0, anchor_grammar_1.formatCitation)(citation, start, end);
+    const sections = (0, spec_sections_1.readSpecSectionBlocks)(lines).map((s) => ({
+        id: (0, anchor_grammar_1.sectionAnchorId)((0, spec_sections_1.normalizeSectionName)(s.name)),
+        kind: 'section',
+        confidence: 'INFERRED',
+        hash: (0, anchor_hash_1.sectionHash)(s.body),
+        hashAlgo: 'sha1-12',
+        location: cite(s.headingIndex + 1, s.headingIndex + 1 + s.body.length),
+    }));
+    flagDuplicates(sections);
+    const docId = fm.frontmatter.id;
+    const tables = (0, bm51_tables_1.readBm51Tables)(lines);
+    const items = [];
+    const orphans = [];
+    if (!docId) {
+        if (tables.items.length)
+            problems.push(`${citation.path}: a BM-51 item table is present but the frontmatter has no id; no item anchors`);
+        return { frontmatter: fm.frontmatter, anchors: sections, orphans, problems };
+    }
+    for (const row of tables.items) {
+        if (!row.itemId) {
+            problems.push(`${citation.path}:${row.line}: item ${row.id} has no section row above it; skipped`);
+            continue;
+        }
+        items.push({ id: (0, anchor_grammar_1.itemAnchorId)(docId, row.itemId), kind: 'item', confidence: 'EXTRACTED', hash: (0, anchor_hash_1.itemRowHash)(row.cells), hashAlgo: 'sha256-12', location: cite(row.line, row.line) });
+    }
+    flagDuplicates(items);
+    const known = new Set(tables.items.map((r) => r.itemId).filter(Boolean));
+    const vals = tables.validations.map((row) => ({
+        id: (0, anchor_grammar_1.itemAnchorId)(docId, row.id, true),
+        kind: 'validation',
+        confidence: known.has(row.id) ? 'EXTRACTED' : 'AMBIGUOUS',
+        hash: (0, anchor_hash_1.itemRowHash)(row.cells),
+        hashAlgo: 'sha256-12',
+        location: cite(row.line, row.line),
+        ...(known.has(row.id) ? {} : { note: 'no §4.1 item with this id' }),
+    }));
+    flagDuplicates(vals);
+    for (const row of [...tables.mappings, ...tables.events]) {
+        if (!known.has(row.id))
+            orphans.push({ table: row.table, itemId: row.id, location: cite(row.line, row.line), confidence: 'AMBIGUOUS' });
+    }
+    return { frontmatter: fm.frontmatter, anchors: [...items, ...vals, ...sections], orphans, problems };
+}
+//# sourceMappingURL=extract-spec-anchors.js.map

package/dist/basis/extract-spec-anchors.js.map

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

package/dist/basis/migration-sentinel.d.ts

@@ -0,0 +1,47 @@
+export interface SentinelFile {
+    path: string;
+    existed: boolean;
+    contentBase64?: string;
+}
+export interface PendingMigration {
+    schema: 1;
+    unit: string;
+    slug: string;
+    reason: string;
+    startedAt: string;
+    pid?: number;
+    host?: string;
+    files: SentinelFile[];
+}
+export type MigrationChoice = 'REVERT' | 'KEEP';
+export declare const IN_PROGRESS_WINDOW_MS = 60000;
+export declare function sentinelPath(projectRoot: string, slug: string): string;
+export declare class PendingMigrationError extends Error {
+    readonly unit: string;
+    readonly slug: string;
+    readonly file: string;
+    constructor(unit: string, slug: string, file: string, detail: string);
+}
+/** The sentinel, or null when there is none. An unreadable sentinel still exists: `files` is then empty. */
+export declare function readPendingMigration(projectRoot: string, slug: string): (PendingMigration & {
+    readable: boolean;
+}) | null;
+export declare class MigrationInProgressError extends Error {
+    readonly unit: string;
+    constructor(unit: string, detail: string);
+}
+/** in-progress: under a minute old and written by a process alive on this host (another host cannot be checked). */
+export declare function pendingMigrationState(p: PendingMigration & {
+    readable: boolean;
+}): 'in-progress' | 'interrupted';
+/** Throws MigrationInProgressError (retry) or PendingMigrationError (REVERT/KEEP) when a sentinel exists. */
+export declare function assertNoPendingMigration(projectRoot: string, slug: string): void;
+/**
+ * Run `write` under a sentinel covering `files` (absolute paths). The sentinel is written atomically
+ * before `write` starts and removed after it returns. If `write` throws, the copies are restored and
+ * the sentinel removed before the error is rethrown; a failed rollback leaves the sentinel in place.
+ */
+export declare function withMigrationSentinel<T>(projectRoot: string, unit: string, slug: string, reason: string, files: string[], write: () => T): T;
+/** Answer a leftover sentinel. REVERT restores every listed file exactly; KEEP only removes the sentinel. */
+export declare function resolvePendingMigration(projectRoot: string, slug: string, choice: MigrationChoice): string[];
+//# sourceMappingURL=migration-sentinel.d.ts.map

package/dist/basis/migration-sentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-sentinel.d.ts","sourceRoot":"","sources":["../../src/basis/migration-sentinel.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,YAAY;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE;AACxF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAC;CAC9H;AACD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;AAChD,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,qBAAa,qBAAsB,SAAQ,KAAK;aAClB,IAAI,EAAE,MAAM;aAAkB,IAAI,EAAE,MAAM;aAAkB,IAAI,EAAE,MAAM;gBAAxE,IAAI,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM,EAAkB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQrH;AAED,4GAA4G;AAC5G,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,gBAAgB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,IAAI,CAQzH;AAED,qBAAa,wBAAyB,SAAQ,KAAK;aACrB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAIzD;AAOD,oHAAoH;AACpH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,gBAAgB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,aAAa,GAAG,aAAa,CAMhH;AAWD,6GAA6G;AAC7G,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGhF;AAuCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAC/F,CAAC,CA6BH;AAED,6GAA6G;AAC7G,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAS5G"}