@sentropic/focus 0.5.0-rc.3 → 0.5.0-rc.7

package/dist/editing/anchors.d.ts

@@ -0,0 +1,14 @@
+import type { DecisionDossierDocument } from '../model.js';
+import type { Address, EditingField, FocusEditingManifest, Paragraph, ParagraphValue, Validation } from './contract.js';
+export declare const fieldKey: (a: Address) => string;
+export declare function sourceNodes(doc: DecisionDossierDocument): Record<string, any>[];
+export declare function sourceNode(doc: DecisionDossierDocument, address: Address): Record<string, any>;
+export declare function editableFields(doc: DecisionDossierDocument): EditingField[];
+export declare function sealManifest(value: Omit<FocusEditingManifest, 'manifestBaseHash'>): FocusEditingManifest;
+/** Legacy seed only. A revised source MUST carry an explicit mapping instead of reseeding. */
+export declare function seedManifest(doc: DecisionDossierDocument): FocusEditingManifest;
+export declare function validateManifest(value: unknown, doc: DecisionDossierDocument): Validation<FocusEditingManifest>;
+/** Explicit producer correspondence, including retirements. Never matches by text similarity. */
+export declare function carryManifest(doc: DecisionDossierDocument, previous: FocusEditingManifest, paragraphs: Paragraph[]): FocusEditingManifest;
+export declare function readParagraphs(doc: DecisionDossierDocument, manifest: FocusEditingManifest): ParagraphValue[];
+//# sourceMappingURL=anchors.d.ts.map

package/dist/editing/anchors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.d.ts","sourceRoot":"","sources":["../../src/editing/anchors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAKxH,eAAO,MAAM,QAAQ,GAAI,GAAG,OAAO,KAAG,MAAyD,CAAC;AAQhG,wBAAgB,WAAW,CAAC,GAAG,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAE/E;AACD,wBAAgB,UAAU,CAAC,GAAG,EAAE,uBAAuB,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAG9F;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,GAAG,YAAY,EAAE,CAK3E;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,oBAAoB,EAAE,kBAAkB,CAAC,GAAG,oBAAoB,CAExG;AACD,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,GAAG,EAAE,uBAAuB,GAAG,oBAAoB,CAU/E;AACD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,uBAAuB,GAAG,UAAU,CAAC,oBAAoB,CAAC,CA2C/G;AACD,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,GAAG,EAAE,uBAAuB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,oBAAoB,CAKzI;AACD,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,EAAE,QAAQ,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAM7G"}

package/dist/editing/anchors.js

@@ -0,0 +1,113 @@
+import { baseDigest, canonicalJson, manifestDigest } from './digest.js';
+import { manifestSchema, matchesSchema } from './structure.js';
+import { isRepresentablePlainText, segmentMarkdown, segmentText } from './codec.js';
+export const fieldKey = (a) => canonicalJson([a.nodeId, a.targetRef, a.field]);
+/** Exactly one soft line break (LF, CRLF or CR): the only allowed overhang
+ * of a text/plain paragraph range beyond its source block. */
+const singleLineBreak = /^(?:\r\n|\n|\r)$/;
+/** An emptied narrative field keeps one empty unit: `""` is content (D14), so an
+ * empty source still carries its paragraph identity instead of zero units. */
+const textSegments = (source) => source === '' ? [{ start: 0, end: 0, editable: true }] : segmentText(source);
+export function sourceNodes(doc) {
+    return doc.sections.flatMap(s => s.kind === 'optionSet' ? [s, ...s.options] : [s]);
+}
+export function sourceNode(doc, address) {
+    const found = sourceNodes(doc).filter(n => n.id === address.nodeId && n.targetRef === address.targetRef);
+    if (found.length !== 1)
+        throw new Error('missing-or-ambiguous-node');
+    return found[0];
+}
+export function editableFields(doc) {
+    const allowed = { prose: ['markdown'], question: ['question', 'recommendedAnswer', 'context'], option: ['label', 'body', 'consequence'] };
+    return sourceNodes(doc).flatMap(n => (allowed[n.kind] ?? []).filter(field => typeof n[field] === 'string').map(field => ({
+        nodeId: n.id, targetRef: n.targetRef, field: field, contentFormat: field === 'markdown' ? 'focus.markdown.p0@1' : 'text/plain', blockKind: n.kind,
+    })));
+}
+export function sealManifest(value) {
+    return { ...value, manifestBaseHash: manifestDigest(value) };
+}
+/** Legacy seed only. A revised source MUST carry an explicit mapping instead of reseeding. */
+export function seedManifest(doc) {
+    const baseHash = baseDigest(doc), fields = editableFields(doc);
+    const paragraphs = fields.flatMap(f => {
+        const source = sourceNode(doc, f)[f.field];
+        const segments = f.contentFormat === 'text/plain' ? textSegments(source) : segmentMarkdown(source);
+        return segments.filter(s => s.editable).map((s, order) => ({ nodeId: f.nodeId, targetRef: f.targetRef, field: f.field,
+            paragraphId: `paragraph:${baseDigest([baseHash, fieldKey(f), order]).slice(7)}`, blockKind: 'paragraph', parentId: null, order,
+            range: { start: s.start, end: s.end, unit: 'utf16' } }));
+    });
+    return sealManifest({ schemaVersion: 1, manifestId: `manifest:${baseHash.slice(7)}`, documentRef: doc.ref, baseHash, fields, paragraphs, retiredParagraphIds: [] });
+}
+export function validateManifest(value, doc) {
+    if (!matchesSchema(manifestSchema, value))
+        return { ok: false, issues: ['manifest-structure'] };
+    const m = value, issues = [];
+    try {
+        if (m.documentRef !== doc.ref || m.baseHash !== baseDigest(doc) || m.manifestBaseHash !== manifestDigest(m))
+            issues.push('manifest-digest-or-base');
+        const allowed = editableFields(doc), fieldIds = new Set(), ids = new Set();
+        for (const f of m.fields) {
+            const key = fieldKey(f);
+            if (fieldIds.has(key) || !allowed.some(a => canonicalJson(a) === canonicalJson(f)))
+                issues.push('unsupported-or-duplicate-field');
+            fieldIds.add(key);
+            const source = sourceNode(doc, f)[f.field];
+            const ps = m.paragraphs.filter(p => fieldKey(p) === key).sort((a, b) => a.order - b.order);
+            const segments = f.contentFormat === 'text/plain' ? textSegments(source) : segmentMarkdown(source);
+            let end = 0;
+            ps.forEach((p, index) => {
+                if (p.order !== index || p.range.start < end || p.range.end < p.range.start || p.range.end > source.length)
+                    issues.push('ambiguous-range');
+                // An empty text/plain paragraph holds no characters, so it never matches a
+                // text block: it is a zero-length unit owned by a structural gap (D14).
+                // It is representable outside any block (source edge, block boundary or
+                // blank gap), never strictly inside one.
+                const emptyGapUnit = f.contentFormat === 'text/plain' && p.range.start === p.range.end &&
+                    !segments.some(s => s.start < p.range.start && p.range.start < s.end);
+                // Case 3: a text/plain paragraph may keep at most one soft break at
+                // each edge ("A\n", "\nB"). Its range then extends one break beyond
+                // its block; the sliced text still round-trips via stored ranges.
+                // The extension must stay anchored on a whole source block: an
+                // internal fragment that merely round-trips (e.g. "B" of "ABC")
+                // is never a paragraph.
+                const edgeBreakUnit = f.contentFormat === 'text/plain' && p.range.start < p.range.end &&
+                    isRepresentablePlainText(source.slice(p.range.start, p.range.end)) &&
+                    segments.some(s => s.editable && p.range.start <= s.start && p.range.end >= s.end &&
+                        (p.range.start === s.start || singleLineBreak.test(source.slice(p.range.start, s.start))) &&
+                        (p.range.end === s.end || singleLineBreak.test(source.slice(s.end, p.range.end))));
+                if (!segments.some(s => s.editable && s.start === p.range.start && s.end === p.range.end) && !emptyGapUnit && !edgeBreakUnit && !(p.range.start === p.range.end && f.contentFormat !== 'text/plain'))
+                    issues.push('unsupported-range');
+                end = p.range.end;
+            });
+        }
+        for (const p of m.paragraphs) {
+            if (ids.has(p.paragraphId) || m.retiredParagraphIds.includes(p.paragraphId) || !fieldIds.has(fieldKey(p)))
+                issues.push('ambiguous-paragraph');
+            ids.add(p.paragraphId);
+        }
+    }
+    catch {
+        issues.push('invalid-manifest');
+    }
+    return issues.length ? { ok: false, issues } : { ok: true, value: m };
+}
+/** Explicit producer correspondence, including retirements. Never matches by text similarity. */
+export function carryManifest(doc, previous, paragraphs) {
+    const active = new Set(paragraphs.map(p => p.paragraphId));
+    const m = sealManifest({ schemaVersion: 1, manifestId: previous.manifestId, documentRef: doc.ref, baseHash: baseDigest(doc), fields: editableFields(doc),
+        paragraphs: structuredClone(paragraphs), retiredParagraphIds: [...new Set([...previous.retiredParagraphIds, ...previous.paragraphs.filter(p => !active.has(p.paragraphId)).map(p => p.paragraphId)])] });
+    const result = validateManifest(m, doc);
+    if (!result.ok)
+        throw new Error(result.issues.join(', '));
+    return m;
+}
+export function readParagraphs(doc, manifest) {
+    const check = validateManifest(manifest, doc);
+    if (!check.ok)
+        throw new Error(check.issues.join(', '));
+    return manifest.fields.flatMap(f => manifest.paragraphs.filter(p => fieldKey(p) === fieldKey(f)).sort((a, b) => a.order - b.order).map(p => ({
+        documentRef: doc.ref, nodeId: p.nodeId, targetRef: p.targetRef, field: p.field, paragraphId: p.paragraphId, blockKind: 'paragraph',
+        format: f.contentFormat, text: sourceNode(doc, p)[p.field].slice(p.range.start, p.range.end),
+    })));
+}
+//# sourceMappingURL=anchors.js.map

package/dist/editing/anchors.js.map

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

package/dist/editing/codec.d.ts

@@ -0,0 +1,24 @@
+import type { FocusReturn } from './contract.js';
+export interface SourceSegment {
+    start: number;
+    end: number;
+    text: string;
+    editable: boolean;
+}
+/** Source-preserving CommonMark + GFM tables. No Markdown reserialization. */
+export declare function segmentMarkdown(source: string): SourceSegment[];
+/** Plain narrative fields: one unit per block of non-blank lines. Exact source
+ * offsets, CRLF/CR aware, no trimming and no normalization: blank lines stay
+ * structural gaps owned by the manifest, never paragraph content. */
+export declare function segmentText(source: string): SourceSegment[];
+/** A text/plain paragraph is one block of non-blank lines (segmentText) with
+ * at most one soft line break kept at each edge (case 3: "A\n", "\nB",
+ * "\nA\n", CRLF/CR included). Blank lines stay structural gaps owned by the
+ * manifest, never paragraph content: stripping more than one edge break still
+ * leaves an edge break behind, so "A\n\n" or "\n\nB" keep failing. A lone
+ * single break ("\n", "\r\n", "\r") is representable as its own unit. */
+export declare function isRepresentablePlainText(text: string): boolean;
+export declare function assertParagraphText(text: string, format: string): void;
+export declare function encodeReturn(value: FocusReturn, format?: 'json' | 'yaml'): string;
+export declare function decodeReturn(raw: string, format?: 'json' | 'yaml'): FocusReturn;
+//# sourceMappingURL=codec.d.ts.map

package/dist/editing/codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.d.ts","sourceRoot":"","sources":["../../src/editing/codec.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,WAAW,aAAa;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE;AAG9F,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAoB/D;AACD;;qEAEqE;AACrE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CAsB3D;AAKD;;;;;yEAKyE;AACzE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAW9D;AACD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQtE;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,GAAE,MAAM,GAAG,MAAe,GAAG,MAAM,CAIzF;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,MAAe,GAAG,WAAW,CAevF"}

package/dist/editing/codec.js

@@ -0,0 +1,143 @@
+import { parser, GFM } from '@lezer/markdown';
+import { parseDocument, isAlias, isMap, isSeq, isScalar, stringify } from 'yaml';
+import { canonicalJson } from './digest.js';
+import { validateReturnStructure } from './contract.js';
+const sourceParser = parser.configure(GFM);
+/** Source-preserving CommonMark + GFM tables. No Markdown reserialization. */
+export function segmentMarkdown(source) {
+    // Lezer consumes LF. Preserve an exact offset map into the original CRLF/CR source.
+    const chars = [], offsets = [0];
+    for (let i = 0; i < source.length; i++) {
+        if (source[i] === '\r') {
+            chars.push('\n');
+            if (source[i + 1] === '\n')
+                i++;
+        }
+        else
+            chars.push(source[i]);
+        offsets.push(i + 1);
+    }
+    const tree = sourceParser.parse(chars.join(''));
+    const safe = (node) => {
+        if (!['Paragraph', 'Emphasis', 'StrongEmphasis', 'InlineCode', 'HardBreak', 'CodeMark', 'EmphasisMark', 'Escape', 'Entity'].includes(node.name))
+            return false;
+        for (let child = node.firstChild; child; child = child.nextSibling)
+            if (!safe(child))
+                return false;
+        return true;
+    };
+    const segments = [];
+    for (let node = tree.topNode.firstChild; node; node = node.nextSibling) {
+        const start = offsets[node.from], end = offsets[node.to];
+        segments.push({ start, end, text: source.slice(start, end), editable: node.name === 'Paragraph' && safe(node) });
+    }
+    return segments;
+}
+/** Plain narrative fields: one unit per block of non-blank lines. Exact source
+ * offsets, CRLF/CR aware, no trimming and no normalization: blank lines stay
+ * structural gaps owned by the manifest, never paragraph content. */
+export function segmentText(source) {
+    if (source === '')
+        return [];
+    const parts = source.split(/(\r\n|\n|\r)/);
+    const lines = [];
+    let offset = 0;
+    for (let i = 0; i < parts.length; i += 2) {
+        const text = parts[i];
+        lines.push({ start: offset, end: offset + text.length, text });
+        offset += text.length + (parts[i + 1] ?? '').length;
+    }
+    const segments = [];
+    let open = null;
+    const close = (last) => {
+        segments.push({ start: lines[open].start, end: lines[last].end, text: source.slice(lines[open].start, lines[last].end), editable: true });
+        open = null;
+    };
+    lines.forEach((line, index) => {
+        if (/^[ \t]*$/.test(line.text)) {
+            if (open !== null)
+                close(index - 1);
+        }
+        else if (open === null)
+            open = index;
+    });
+    if (open !== null)
+        close(lines.length - 1);
+    return segments;
+}
+const lineBreak = String.raw `(?:\r\n|\n|\r)`;
+const singleBreak = new RegExp(`^${lineBreak}$`);
+const leadingBreak = new RegExp(`^${lineBreak}`);
+const trailingBreak = new RegExp(`${lineBreak}$`);
+/** A text/plain paragraph is one block of non-blank lines (segmentText) with
+ * at most one soft line break kept at each edge (case 3: "A\n", "\nB",
+ * "\nA\n", CRLF/CR included). Blank lines stay structural gaps owned by the
+ * manifest, never paragraph content: stripping more than one edge break still
+ * leaves an edge break behind, so "A\n\n" or "\n\nB" keep failing. A lone
+ * single break ("\n", "\r\n", "\r") is representable as its own unit. */
+export function isRepresentablePlainText(text) {
+    if (text === '')
+        return true;
+    if (singleBreak.test(text))
+        return true;
+    let core = text;
+    const lead = core.match(leadingBreak);
+    if (lead)
+        core = core.slice(lead[0].length);
+    const trail = core.match(trailingBreak);
+    if (trail)
+        core = core.slice(0, -trail[0].length);
+    if (core === '')
+        return false;
+    const parts = segmentText(core);
+    return parts.length === 1 && parts[0].start === 0 && parts[0].end === core.length;
+}
+export function assertParagraphText(text, format) {
+    if (text === '')
+        return;
+    if (format === 'text/plain') {
+        if (isRepresentablePlainText(text))
+            return;
+        throw new Error('unsupported-paragraph-format');
+    }
+    const parts = segmentMarkdown(text);
+    if (parts.length !== 1 || !parts[0].editable || parts[0].start !== 0 || parts[0].end !== text.length)
+        throw new Error('unsupported-paragraph-format');
+}
+export function encodeReturn(value, format = 'json') {
+    if (!validateReturnStructure(value))
+        throw new Error('unsupported-version-or-structure');
+    canonicalJson(value);
+    return format === 'json' ? JSON.stringify(value, null, 2) + '\n' : stringify(value, { lineWidth: 0, aliasDuplicateObjects: false });
+}
+export function decodeReturn(raw, format = 'json') {
+    if (format !== 'json' && format !== 'yaml')
+        throw new Error('unsupported-format');
+    if (format === 'json')
+        JSON.parse(raw); // Strict JSON syntax; YAML below also checks duplicate keys.
+    const parsed = parseDocument(raw, { uniqueKeys: true, strict: true, schema: 'core' });
+    if (parsed.errors.length || parsed.warnings.length)
+        throw new Error('Invalid serialized return');
+    const visit = (node) => {
+        if (!node)
+            return;
+        if (isAlias(node) || node.tag)
+            throw new Error('Aliases and explicit tags are unsupported');
+        if (isMap(node))
+            for (const pair of node.items) {
+                if (!isScalar(pair.key) || typeof pair.key.value !== 'string')
+                    throw new Error('JSON keys must be strings');
+                visit(pair.key);
+                visit(pair.value);
+            }
+        if (isSeq(node))
+            node.items.forEach(visit);
+    };
+    visit(parsed.contents);
+    const value = parsed.toJS({ maxAliasCount: 0 });
+    canonicalJson(value);
+    if (!validateReturnStructure(value))
+        throw new Error('unsupported-version-or-structure');
+    return value;
+}
+//# sourceMappingURL=codec.js.map

package/dist/editing/codec.js.map

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

package/dist/editing/contract.d.ts

@@ -0,0 +1,129 @@
+import type { DecisionDossierDocument } from '../model.js';
+export type Format = 'text/plain' | 'focus.markdown.p0@1';
+export interface Address {
+    nodeId: string;
+    targetRef: string;
+    field: 'markdown' | 'question' | 'recommendedAnswer' | 'context' | 'label' | 'body' | 'consequence';
+}
+export interface EditingField extends Address {
+    contentFormat: Format;
+    blockKind: 'prose' | 'question' | 'option';
+}
+export interface Paragraph extends Address {
+    paragraphId: string;
+    blockKind: 'paragraph';
+    parentId: null;
+    order: number;
+    range: {
+        start: number;
+        end: number;
+        unit: 'utf16';
+    };
+}
+export interface FocusEditingManifest {
+    schemaVersion: 1;
+    manifestId: string;
+    documentRef: string;
+    baseHash: string;
+    manifestBaseHash: string;
+    fields: EditingField[];
+    paragraphs: Paragraph[];
+    retiredParagraphIds: string[];
+}
+export interface Anchors {
+    parentId: null;
+    previousParagraphId: string | null;
+    nextParagraphId: string | null;
+}
+export interface ParagraphValue extends Address {
+    documentRef: string;
+    paragraphId: string;
+    blockKind: 'paragraph';
+    format: Format;
+    text: string;
+}
+export interface ParagraphChange extends Address {
+    documentRef: string;
+    paragraphId: string;
+    blockKind: 'paragraph';
+    format: Format;
+    changeId: string;
+    operation: 'replace' | 'insert' | 'delete' | 'move';
+    before: string | null;
+    after: string | null;
+    beforeAnchors: Anchors | null;
+    anchors: Anchors;
+}
+export interface EditTransaction {
+    transactionId: string;
+    changes: ParagraphChange[];
+}
+export interface Production {
+    producerId: string;
+    generationId: string;
+    requestId: string;
+}
+export interface FocusReturn {
+    kind: 'focus.return';
+    schemaVersion: 1;
+    returnId: string;
+    digest: string;
+    capture: {
+        at: string;
+    };
+    scope: {
+        workspaceId: string;
+    } | null;
+    source: {
+        documentRef: string;
+        hash: string;
+        cursor: string;
+        baseHash: string;
+        manifestId: string;
+        manifestBaseHash: string;
+    };
+    production: Production | null;
+    manifest: FocusEditingManifest;
+    answers: {
+        questionId: string;
+        targetRef: string;
+        optionIds: string[];
+        text: string | null;
+    }[];
+    notes: {
+        targetRef: string;
+        text: string | null;
+    }[];
+    editReturn: {
+        schemaVersion: 1;
+        mode: 'cumulative';
+        transactions: EditTransaction[];
+        supersedesReturnId?: string;
+        supersededReturnIds: string[];
+    };
+}
+export type Validation<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    issues: string[];
+};
+export declare const validateManifestStructure: (v: unknown) => v is FocusEditingManifest;
+export declare const validateReturnStructure: (v: unknown) => v is FocusReturn;
+export declare function validateReturn(value: unknown, doc: DecisionDossierDocument, manifest: FocusEditingManifest): Validation<FocusReturn>;
+export interface FreezeInput {
+    document: DecisionDossierDocument;
+    manifest: FocusEditingManifest;
+    production: Production | null;
+    scope: FocusReturn['scope'];
+    answers: FocusReturn['answers'];
+    notes: FocusReturn['notes'];
+    transactions: EditTransaction[];
+    previous?: FocusReturn;
+    returnId: string;
+    capturedAt: string;
+}
+/** Capture metadata/identity is supplied by the host, never invented by the pure core. */
+export declare function freezeReturn(input: FreezeInput): FocusReturn;
+//# sourceMappingURL=contract.d.ts.map

package/dist/editing/contract.d.ts.map

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

package/dist/editing/contract.js

@@ -0,0 +1,76 @@
+import { baseDigest, canonicalJson, returnDigest } from './digest.js';
+import { validateManifest, fieldKey, sourceNodes } from './anchors.js';
+import { matchesSchema, manifestSchema, returnSchema } from './structure.js';
+export const validateManifestStructure = (v) => matchesSchema(manifestSchema, v);
+export const validateReturnStructure = (v) => matchesSchema(returnSchema, v);
+export function validateReturn(value, doc, manifest) {
+    const issues = [];
+    if (!validateReturnStructure(value))
+        return { ok: false, issues: ['unsupported-version-or-structure'] };
+    try {
+        if (value.digest !== returnDigest(value))
+            issues.push('return-digest');
+        if (!validateManifest(manifest, doc).ok || !validateManifest(value.manifest, doc).ok || canonicalJson(value.manifest) !== canonicalJson(manifest))
+            issues.push('manifest-mismatch');
+        if (value.source.documentRef !== doc.ref || value.source.hash !== doc.hash || value.source.cursor !== doc.cursor || value.source.baseHash !== baseDigest(doc) || value.source.manifestId !== manifest.manifestId || value.source.manifestBaseHash !== manifest.manifestBaseHash)
+            issues.push('source-mismatch');
+        const ancestry = value.editReturn.supersededReturnIds;
+        if (ancestry.includes(value.returnId) || (ancestry.length === 0) !== (value.editReturn.supersedesReturnId === undefined) || (ancestry.length && ancestry[0] !== value.editReturn.supersedesReturnId))
+            issues.push('ancestry');
+        const nodes = sourceNodes(doc), targets = new Set([doc.ref, ...nodes.map(n => n.targetRef)]);
+        for (const note of value.notes)
+            if (!targets.has(note.targetRef))
+                issues.push('note-target');
+        const answerIds = new Set();
+        for (const answer of value.answers) {
+            if (answerIds.has(answer.questionId))
+                issues.push('duplicate-answer');
+            answerIds.add(answer.questionId);
+            const question = nodes.find(n => n.kind === 'question' && n.id === answer.questionId && n.targetRef === answer.targetRef);
+            const options = doc.sections.flatMap(n => n.kind === 'optionSet' && n.questionId === answer.questionId ? n.options : []);
+            if (!question || answer.optionIds.some(id => !options.some(o => o.id === id)))
+                issues.push('answer-target');
+        }
+        const txIds = new Set(), changeIds = new Set();
+        for (const tx of value.editReturn.transactions) {
+            if (txIds.has(tx.transactionId))
+                issues.push('duplicate-transaction-id');
+            txIds.add(tx.transactionId);
+            for (const change of tx.changes) {
+                if (changeIds.has(change.changeId))
+                    issues.push('duplicate-change-id');
+                changeIds.add(change.changeId);
+                const f = manifest.fields.find(f => fieldKey(f) === fieldKey(change));
+                if (!f || f.contentFormat !== change.format || change.documentRef !== doc.ref)
+                    issues.push('address');
+                if (change.operation === 'move' && change.before !== change.after)
+                    issues.push('move-content');
+                if (change.operation === 'insert' && (manifest.paragraphs.some(p => p.paragraphId === change.paragraphId) || manifest.retiredParagraphIds.includes(change.paragraphId)))
+                    issues.push('reused-paragraph-id');
+            }
+        }
+    }
+    catch {
+        issues.push('invalid-json-value');
+    }
+    return issues.length ? { ok: false, issues } : { ok: true, value };
+}
+/** Capture metadata/identity is supplied by the host, never invented by the pure core. */
+export function freezeReturn(input) {
+    const { document: doc, manifest, previous } = input;
+    if (previous && !validateReturn(previous, doc, manifest).ok)
+        throw new Error('Invalid previous frozen return: recover complete ancestry');
+    const value = { kind: 'focus.return', schemaVersion: 1, returnId: input.returnId, digest: '', capture: { at: input.capturedAt },
+        scope: input.scope, source: { documentRef: doc.ref, hash: doc.hash, cursor: doc.cursor, baseHash: manifest.baseHash, manifestId: manifest.manifestId, manifestBaseHash: manifest.manifestBaseHash },
+        production: input.production, manifest, answers: input.answers, notes: input.notes,
+        editReturn: { schemaVersion: 1, mode: 'cumulative', transactions: input.transactions.filter(t => t.changes.length), supersededReturnIds: previous ? [previous.returnId, ...previous.editReturn.supersededReturnIds] : [], ...(previous ? { supersedesReturnId: previous.returnId } : {}) } };
+    // Re-copy/download the same completed revision without allocating a new identity.
+    if (previous && canonicalJson([value.answers, value.notes, value.editReturn.transactions, value.production, value.scope]) === canonicalJson([previous.answers, previous.notes, previous.editReturn.transactions, previous.production, previous.scope]))
+        return structuredClone(previous);
+    value.digest = returnDigest(value);
+    const check = validateReturn(value, doc, manifest);
+    if (!check.ok)
+        throw new Error(check.issues.join(', '));
+    return structuredClone(value);
+}
+//# sourceMappingURL=contract.js.map

package/dist/editing/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/editing/contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAsB7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAU,EAA6B,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;AACrH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAU,EAAoB,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AACxG,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,GAA4B,EAAE,QAA8B;IACzG,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,kCAAkC,CAAC,EAAE,CAAC;IACxG,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,CAAC,KAAK,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACvE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,aAAa,CAAC,QAAQ,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACpL,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,KAAK,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,gBAAgB,KAAK,QAAQ,CAAC,gBAAgB;YAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChT,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC;QACtD,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,kBAAkB,KAAK,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9N,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC7F,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7F,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YACxG,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC;YAC1H,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACzH,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9G,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,EAAE,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/D,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;YACtG,KAAK,MAAM,MAAM,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;gBAChC,IAAI,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;gBAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACvG,MAAM,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;gBACtE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,WAAW,KAAK,GAAG,CAAC,GAAG;oBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtG,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK;oBAAE,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAC/F,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YAC9M,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACrE,CAAC;AAMD,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,KAAkB;IAC7C,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACpD,IAAI,QAAQ,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC1I,MAAM,KAAK,GAAgB,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,UAAU,EAAE;QAC1I,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,EAAE;QACnM,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK;QAClF,UAAU,EAAE,EAAE,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,mBAAmB,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;IAC/R,kFAAkF;IAClF,IAAI,QAAQ,IAAI,aAAa,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,aAAa,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,YAAY,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzR,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAAC,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5G,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/editing/diff.d.ts

@@ -0,0 +1,12 @@
+import type { DecisionDossierDocument } from '../model.js';
+import type { Anchors, EditTransaction, FocusEditingManifest, ParagraphValue } from './contract.js';
+export declare const paragraphAnchors: (values: ParagraphValue[], index: number) => Anchors;
+export declare function diffParagraphs(baseline: ParagraphValue[], draft: ParagraphValue[], transactionId: string): EditTransaction;
+/** Applies one atomic batch to source tokens. Opaque gaps are never reserialized.
+ * A retired identity is restored only when explicitly listed in `restoreIds`:
+ * reviving any other retired identity silently reassigns it (D13). */
+export declare function applyParagraphChanges(document: DecisionDossierDocument, manifest: FocusEditingManifest, transactions: EditTransaction[], restoreIds?: ReadonlySet<string> | null): {
+    document: DecisionDossierDocument;
+    manifest: FocusEditingManifest;
+};
+//# sourceMappingURL=diff.d.ts.map

package/dist/editing/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/editing/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAmB,cAAc,EAAa,MAAM,eAAe,CAAC;AAKhI,eAAO,MAAM,gBAAgB,GAAI,QAAQ,cAAc,EAAE,EAAE,OAAO,MAAM,KAAG,OAAqJ,CAAC;AACjO,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,CA2B1H;AAED;;sEAEsE;AACtE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,UAAU,GAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAW,GAAG;IAAE,QAAQ,EAAE,uBAAuB,CAAC;IAAC,QAAQ,EAAE,oBAAoB,CAAA;CAAE,CA8C9P"}