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

package/dist/cli/index.d.ts

@@ -12,7 +12,7 @@
  * — missing args, decision not found, contract mismatch). It is READ-ONLY: NO track write, NO new
  * track event (those are L4).
  *
- *   stp focus <decision-id> [--format terminal|md|html] [--workspace <ws>]
+ *   stp focus <decision-id> [--format terminal|md|html|json] [--workspace <ws>]
  *                           [--baseline-commit <sha>] [--events-path <path>]
  *
  * Defaults: `--events-path` = `.track/events.jsonl`, `--format` = `terminal`. `--workspace` is

package/dist/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiBH,iFAAiF;AACjF,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AA2G3C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAiBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,GACd,MAAM,SAAS,MAAM,EAAE,EACvB,OAAM,YAAiB,KACtB,OAAO,CAAC,MAAM,CAkDhB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAkBH,iFAAiF;AACjF,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC;AA2G3C;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAiBD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,GAAG,GACd,MAAM,SAAS,MAAM,EAAE,EACvB,OAAM,YAAiB,KACtB,OAAO,CAAC,MAAM,CA0DhB,CAAC"}

package/dist/cli/index.js

@@ -12,7 +12,7 @@
  * — missing args, decision not found, contract mismatch). It is READ-ONLY: NO track write, NO new
  * track event (those are L4).
  *
- *   stp focus <decision-id> [--format terminal|md|html] [--workspace <ws>]
+ *   stp focus <decision-id> [--format terminal|md|html|json] [--workspace <ws>]
  *                           [--baseline-commit <sha>] [--events-path <path>]
  *
  * Defaults: `--events-path` = `.track/events.jsonl`, `--format` = `terminal`. `--workspace` is
@@ -21,18 +21,19 @@
 import { createRequire } from "node:module";
 import { renderHtml, renderMd, renderTerminal } from "../index.js";
 import { DecisionNotFoundError, TrackContractMismatchError, readDecisionDossier, } from "../track/index.js";
+import { assertDecisionDossierForPresentation } from "../validation/index.js";
 /** The package version, read from the package manifest (single source of truth). */
 const pkg = createRequire(import.meta.url)("../../package.json");
 /** The `{ run, version }` contract surfaced to the `stp` subcommand registry. */
 export const version = pkg.version;
 /** The supported render formats. */
-const FORMATS = ["terminal", "md", "html"];
+const FORMATS = ["terminal", "md", "html", "json"];
 const DEFAULT_EVENTS_PATH = ".track/events.jsonl";
 const DEFAULT_FORMAT = "terminal";
 /** A parse failure carrying the message to print on stderr (exit code 2 = usage error). */
 class UsageError extends Error {
 }
-const USAGE = "Usage: stp focus <decision-id> [--format terminal|md|html] " +
+const USAGE = "Usage: stp focus <decision-id> [--format terminal|md|html|json] " +
     "[--workspace <ws>] [--baseline-commit <sha>] [--events-path <path>]\n" +
     "Render a track decision dossier read-only. Defaults: --format terminal, " +
     `--events-path ${DEFAULT_EVENTS_PATH}. --workspace is required.`;
@@ -162,6 +163,14 @@ export const run = async (argv, deps = {}) => {
             case "html":
                 out(renderHtml(doc, defaultHtmlHooks));
                 break;
+            case "json": {
+                // No renderer: validate through the SAME presentation gate (readability included) and
+                // serialize the validated document verbatim — v1 today, v2 the day a dossier carries
+                // embedded evidence (assertDecisionDossierForPresentation is the v1|v2 union validator).
+                const validated = assertDecisionDossierForPresentation(doc);
+                out(`${JSON.stringify(validated, null, 2)}\n`);
+                break;
+            }
         }
         return 0;
     }

package/dist/cli/index.js.map

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

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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"}