@sentropic/track 0.83.0 → 0.85.0

package/dist/focus-vendor/render/html.js

@@ -0,0 +1,89 @@
+/**
+ * HTML renderer (Focus-M1 L1) — MANDATORY surface.
+ *
+ * Renders a `DecisionDossierDocument` to an HTML string. Read-only FocusSnapshot:
+ * affordances appear as DISABLED metadata; diagrams fall back to a `<pre>` block (no diagram
+ * adapter). Markdown prose is converted via the host-supplied `renderMarkdown` hook (NO `marked`
+ * dep, NO mdast core); the full document HTML is run through the host `sanitizeHtml` hook before
+ * emission. The renderer core owns structure only; hosts own sanitization/styling.
+ */
+/** Minimal HTML text escaping for attribute/text content the renderer itself emits. */
+const escapeHtml = (value) => value
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#39;");
+const renderQuestion = (q) => {
+    const parts = [
+        `<p class="focus-q"><strong>Q:</strong> ${escapeHtml(q.question)} <em>(${escapeHtml(q.state)})</em></p>`,
+    ];
+    if (q.recommendedAnswer !== undefined) {
+        parts.push(`<p class="focus-preco">préco: ${escapeHtml(q.recommendedAnswer)}</p>`);
+    }
+    if (q.answer !== undefined) {
+        parts.push(`<p class="focus-answer">answer: ${escapeHtml(q.answer)}</p>`);
+    }
+    return `<section class="focus-question">${parts.join("")}</section>`;
+};
+const renderOptionSet = (s) => {
+    const head = s.title !== undefined
+        ? `<h3>Options — ${escapeHtml(s.title)}</h3>`
+        : "<h3>Options</h3>";
+    const items = s.options.map((o) => {
+        const comment = o.annotationComment !== undefined
+            ? ` <span class="focus-option-comment">— ${escapeHtml(o.annotationComment)}</span>`
+            : "";
+        const body = o.body !== undefined
+            ? `<div class="focus-option-body">${escapeHtml(o.body)}</div>`
+            : "";
+        return `<li class="focus-option" data-annotation="${escapeHtml(o.annotation)}"><strong>${escapeHtml(o.label)}</strong>${comment}${body}</li>`;
+    });
+    return `<section class="focus-optionset">${head}<ul>${items.join("")}</ul></section>`;
+};
+const renderAmendmentTrace = (steps) => {
+    if (steps.length === 0) {
+        return `<section class="focus-amendment-trace"><h3>Amendment trace</h3><p><em>(none)</em></p></section>`;
+    }
+    const items = steps.map((st) => `<li><code>${escapeHtml(st.at)}</code> <strong>${escapeHtml(st.author)}</strong> — ${escapeHtml(st.summary)}</li>`);
+    return `<section class="focus-amendment-trace"><h3>Amendment trace</h3><ol>${items.join("")}</ol></section>`;
+};
+const renderDiagram = (d) => `<figure class="focus-diagram" data-syntax="${escapeHtml(d.syntax)}"><figcaption>${escapeHtml(d.alt)}</figcaption><pre><code class="language-${escapeHtml(d.syntax)}">${escapeHtml(d.source)}</code></pre></figure>`;
+const renderNode = (node, hooks) => {
+    switch (node.kind) {
+        case "prose":
+            return `<section class="focus-prose">${hooks.renderMarkdown(node.markdown)}</section>`;
+        case "question":
+            return renderQuestion(node);
+        case "optionSet":
+            return renderOptionSet(node);
+        case "outcome":
+            return `<section class="focus-outcome" data-modality="${escapeHtml(node.modality)}"><h3>Outcome (${escapeHtml(node.modality)})</h3><p>${escapeHtml(node.statement)}</p></section>`;
+        case "amendmentTrace":
+            return renderAmendmentTrace(node.steps);
+        case "diagram":
+            return renderDiagram(node);
+    }
+};
+const renderAffordances = (affordances) => {
+    if (affordances.length === 0)
+        return "";
+    const items = affordances.map((a) => `<li class="focus-affordance" data-affordance="${escapeHtml(a.name)}" data-target="${escapeHtml(a.targetRef)}" aria-disabled="true"><del>${escapeHtml(a.label)}</del> <span class="focus-affordance-meta">${escapeHtml(a.name)} → ${escapeHtml(a.targetRef)} (disabled)</span></li>`);
+    return `<section class="focus-affordances"><h3>Affordances (read-only snapshot)</h3><ul>${items.join("")}</ul></section>`;
+};
+/** Render a decision-dossier document to a sanitized HTML string. */
+export const renderHtml = (doc, hooks) => {
+    const header = `<header class="focus-header"><h1>${escapeHtml(doc.title)}</h1>` +
+        `<p class="focus-meta">subject: ${escapeHtml(doc.subject)} · ref: <code>${escapeHtml(doc.ref)}</code> · cursor: <code>${escapeHtml(doc.cursor)}</code></p></header>`;
+    const sections = doc.sections.map((node) => renderNode(node, hooks)).join("");
+    const amendment = renderAmendmentTrace(doc.amendmentTrace);
+    const affordances = renderAffordances(doc.interactions);
+    const html = `<article class="focus-document" data-ref="${escapeHtml(doc.ref)}">` +
+        header +
+        sections +
+        amendment +
+        affordances +
+        "</article>";
+    return hooks.sanitizeHtml(html);
+};
+//# sourceMappingURL=html.js.map

package/dist/focus-vendor/render/html.js.map

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

package/dist/focus-vendor/render/md.d.ts

@@ -0,0 +1,2 @@
+export function renderMd(doc: any, hooks?: {}): string;
+//# sourceMappingURL=md.d.ts.map

package/dist/focus-vendor/render/md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md.d.ts","sourceRoot":"","sources":["../../../src/focus-vendor/render/md.js"],"names":[],"mappings":"AA4DO,uDAaN"}

package/dist/focus-vendor/render/md.js

@@ -0,0 +1,75 @@
+/**
+ * Markdown renderer (Focus-M1 L1).
+ *
+ * Renders a `DecisionDossierDocument` to a Markdown string. Read-only FocusSnapshot:
+ * affordances appear as disabled metadata; diagrams fall back to a FENCED code block
+ * (```mermaid / ```plantuml — no diagram adapter). Prose markdown is emitted verbatim
+ * (or passed through an optional host `renderMarkdown` hook for normalization).
+ */
+const renderQuestion = (q) => {
+    const lines = [`**Q:** ${q.question} _(${q.state})_`];
+    if (q.recommendedAnswer !== undefined) {
+        lines.push(`- préco: ${q.recommendedAnswer}`);
+    }
+    if (q.answer !== undefined) {
+        lines.push(`- answer: ${q.answer}`);
+    }
+    return lines.join("\n");
+};
+const renderOptionSet = (s) => {
+    const head = s.title !== undefined ? `### Options — ${s.title}` : "### Options";
+    const opts = s.options.map((o) => {
+        const mark = o.annotation === "none" ? "[ ]" : `[${o.annotation}]`;
+        const comment = o.annotationComment !== undefined ? ` — ${o.annotationComment}` : "";
+        const body = o.body !== undefined ? `\n  ${o.body}` : "";
+        return `- ${mark} **${o.label}**${comment}${body}`;
+    });
+    return [head, ...opts].join("\n");
+};
+const renderAmendmentTrace = (steps) => {
+    if (steps.length === 0)
+        return "### Amendment trace\n\n_(none)_";
+    const lines = steps.map((st, i) => `${i + 1}. \`${st.at}\` **${st.author}** — ${st.summary}`);
+    return ["### Amendment trace", "", ...lines].join("\n");
+};
+const renderDiagram = (d) => [`_${d.alt}_`, "", "```" + d.syntax, d.source, "```"].join("\n");
+const renderNode = (node, hooks) => {
+    switch (node.kind) {
+        case "prose":
+            return hooks.renderMarkdown !== undefined
+                ? hooks.renderMarkdown(node.markdown)
+                : node.markdown;
+        case "question":
+            return renderQuestion(node);
+        case "optionSet":
+            return renderOptionSet(node);
+        case "outcome":
+            return `### Outcome (${node.modality})\n\n${node.statement}`;
+        case "amendmentTrace":
+            return renderAmendmentTrace(node.steps);
+        case "diagram":
+            return renderDiagram(node);
+    }
+};
+const renderAffordances = (affordances) => {
+    if (affordances.length === 0)
+        return "";
+    const lines = affordances.map((a) => `- ~~${a.label}~~ \`${a.name}\` → \`${a.targetRef}\` _(disabled)_`);
+    return ["### Affordances (read-only snapshot)", "", ...lines].join("\n");
+};
+/** Render a decision-dossier document to a Markdown string. */
+export const renderMd = (doc, hooks = {}) => {
+    const blocks = [
+        `# ${doc.title}`,
+        `> subject: ${doc.subject}  ·  ref: \`${doc.ref}\`  ·  cursor: \`${doc.cursor}\``,
+    ];
+    for (const node of doc.sections) {
+        blocks.push(renderNode(node, hooks));
+    }
+    blocks.push(renderAmendmentTrace(doc.amendmentTrace));
+    const affordances = renderAffordances(doc.interactions);
+    if (affordances !== "")
+        blocks.push(affordances);
+    return blocks.join("\n\n") + "\n";
+};
+//# sourceMappingURL=md.js.map

package/dist/focus-vendor/render/md.js.map

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

package/dist/focus-vendor/render/terminal.d.ts

@@ -0,0 +1,2 @@
+export function renderTerminal(doc: any, opts?: {}): string;
+//# sourceMappingURL=terminal.d.ts.map

package/dist/focus-vendor/render/terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal.d.ts","sourceRoot":"","sources":["../../../src/focus-vendor/render/terminal.js"],"names":[],"mappings":"AAgEO,4DAiBN"}

package/dist/focus-vendor/render/terminal.js

@@ -0,0 +1,83 @@
+/**
+ * Terminal renderer (Focus-M1 L1).
+ *
+ * Renders a `DecisionDossierDocument` to a plain-text terminal string. Read-only FocusSnapshot:
+ * affordances appear as disabled metadata; diagrams fall back to text (no diagram adapter);
+ * markdown prose is emitted as-is (terminal has no markdown engine).
+ *
+ * Align the CLI/terminal render with ARCH-21 resource_terminal / RF11 renderer (no duplication):
+ * this stays a pure string builder with no ANSI/color side effects.
+ */
+const rule = (width) => "=".repeat(Math.max(8, width));
+const renderQuestion = (q) => {
+    const lines = [`Q: ${q.question}  [${q.state}]`];
+    if (q.recommendedAnswer !== undefined) {
+        lines.push(`   préco: ${q.recommendedAnswer}`);
+    }
+    if (q.answer !== undefined) {
+        lines.push(`   answer: ${q.answer}`);
+    }
+    return lines.join("\n");
+};
+const renderOptionSet = (s) => {
+    const head = s.title !== undefined ? `Options — ${s.title}` : "Options";
+    const opts = s.options.map((o) => {
+        const mark = o.annotation === "none" ? "( )" : `(${o.annotation})`;
+        const comment = o.annotationComment !== undefined ? ` — ${o.annotationComment}` : "";
+        const body = o.body !== undefined ? `\n      ${o.body}` : "";
+        return `  ${mark} ${o.label}${comment}${body}`;
+    });
+    return [head, ...opts].join("\n");
+};
+const renderAmendmentTrace = (steps) => {
+    if (steps.length === 0)
+        return "Amendment trace: (none)";
+    const lines = steps.map((st, i) => `  ${i + 1}. [${st.at}] ${st.author}: ${st.summary}`);
+    return ["Amendment trace:", ...lines].join("\n");
+};
+const renderDiagram = (d) => [
+    `Diagram (${d.syntax}) — ${d.alt}`,
+    ...d.source.split("\n").map((l) => `  | ${l}`),
+].join("\n");
+const renderNode = (node) => {
+    switch (node.kind) {
+        case "prose":
+            return node.markdown;
+        case "question":
+            return renderQuestion(node);
+        case "optionSet":
+            return renderOptionSet(node);
+        case "outcome":
+            return `Outcome [${node.modality}]: ${node.statement}`;
+        case "amendmentTrace":
+            return renderAmendmentTrace(node.steps);
+        case "diagram":
+            return renderDiagram(node);
+    }
+};
+const renderAffordances = (affordances) => {
+    if (affordances.length === 0)
+        return "";
+    const lines = affordances.map((a) => `  [disabled] ${a.label} (${a.name} → ${a.targetRef})`);
+    return ["Affordances (read-only snapshot):", ...lines].join("\n");
+};
+/** Render a decision-dossier document to a terminal string. */
+export const renderTerminal = (doc, opts = {}) => {
+    const width = opts.width ?? 72;
+    const blocks = [
+        rule(width),
+        `${doc.title}`,
+        `subject: ${doc.subject}`,
+        `ref: ${doc.ref}  cursor: ${doc.cursor}`,
+        rule(width),
+    ];
+    for (const node of doc.sections) {
+        blocks.push(renderNode(node));
+    }
+    blocks.push(renderAmendmentTrace(doc.amendmentTrace));
+    const affordances = renderAffordances(doc.interactions);
+    if (affordances !== "")
+        blocks.push(affordances);
+    return blocks.join("\n\n") + "\n";
+};
+//# sourceMappingURL=terminal.js.map

package/dist/focus-vendor/render/terminal.js.map

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

package/dist/focus-vendor/track/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The major-compatible `@sentropic/track/read` READ contract this binding was written against.
+ * The contract is additive-only within a major; we accept any matching major (gate below).
+ */
+export const EXPECTED_TRACK_READ_MAJOR: 1;
+/** Thrown when the installed `@sentropic/track/read` contract major is incompatible. */
+export class TrackContractMismatchError extends Error {
+    constructor(actual: any, expectedMajor: any);
+    actual: any;
+    expectedMajor: any;
+}
+/** Thrown when a `decisionId` is not present (or not a decision) in the read log. */
+export class DecisionNotFoundError extends Error {
+    constructor(decisionId: any);
+    decisionId: any;
+}
+export function toDecisionDossierDocument(view: any, amendmentTrace: any, meta: any): {
+    ref: any;
+    subject: any;
+    title: any;
+    hash: any;
+    cursor: any;
+    sections: ({
+        state: string;
+        answer?: any;
+        kind: string;
+        id: any;
+        targetRef: any;
+        question: any;
+    } | {
+        kind: string;
+        id: string;
+        targetRef: string;
+        markdown: any;
+        title?: never;
+        options?: never;
+        modality?: never;
+        statement?: never;
+    } | {
+        kind: string;
+        id: string;
+        targetRef: string;
+        title: string;
+        options: any;
+        markdown?: never;
+        modality?: never;
+        statement?: never;
+    } | {
+        kind: string;
+        id: string;
+        targetRef: string;
+        modality: string;
+        statement: string | undefined;
+        markdown?: never;
+        title?: never;
+        options?: never;
+    })[];
+    interactions: never[];
+    provenance: {
+        comprehensionEvidence?: {
+            signature?: any;
+            subject: any;
+            dossierHash: any;
+        };
+        source: any;
+        readAt: any;
+    };
+    amendmentTrace: any;
+};
+export function readDecisionDossier(eventsPath: any, query: any, readAt: any): {
+    ref: any;
+    subject: any;
+    title: any;
+    hash: any;
+    cursor: any;
+    sections: ({
+        state: string;
+        answer?: any;
+        kind: string;
+        id: any;
+        targetRef: any;
+        question: any;
+    } | {
+        kind: string;
+        id: string;
+        targetRef: string;
+        markdown: any;
+        title?: never;
+        options?: never;
+        modality?: never;
+        statement?: never;
+    } | {
+        kind: string;
+        id: string;
+        targetRef: string;
+        title: string;
+        options: any;
+        markdown?: never;
+        modality?: never;
+        statement?: never;
+    } | {
+        kind: string;
+        id: string;
+        targetRef: string;
+        modality: string;
+        statement: string | undefined;
+        markdown?: never;
+        title?: never;
+        options?: never;
+    })[];
+    interactions: never[];
+    provenance: {
+        comprehensionEvidence?: {
+            signature?: any;
+            subject: any;
+            dossierHash: any;
+        };
+        source: any;
+        readAt: any;
+    };
+    amendmentTrace: any;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/focus-vendor/track/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/focus-vendor/track/index.js"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,wCAAyC,CAAC,CAAC;AAC3C,wFAAwF;AACxF;IAGI,6CAMC;IARD,YAAO;IACP,mBAAc;CAQjB;AACD,qFAAqF;AACrF;IAEI,6BAIC;IALD,gBAAW;CAMd;AA4HM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyBN;AAYM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmBN"}

package/dist/focus-vendor/track/index.js

@@ -0,0 +1,223 @@
+/**
+ * `@sentropic/focus/track` — the read binding over `@sentropic/track/read` (Focus-M1 L2).
+ *
+ * Per SPEC_VOL_FOCUS §4b L2: binds the private `packages/focus` render-core to the REAL
+ * `@sentropic/track` read API, replacing L1's local `DecisionDossierViewFixture` type + mapper.
+ * A `TrackReader` read is PURE / read-only / clockless — NO auth, NO identity, NO clock (the L4
+ * write lot is where identity enters). This module:
+ *   1. reads a real `DecisionDossierView` from a track event log via
+ *      `new TrackReader(eventsPath).canevas(workspace, { baselineCommit, decisionId }).dossier`,
+ *   2. reads the ordered `amendmentTrace(decisionId)` for the same decision,
+ *   3. maps both into the concrete L1 `DecisionDossierDocument`.
+ *
+ * It binds to the VERSIONED `@sentropic/track/read` subpath (NOT track's non-versioned barrel) and
+ * gates on `reader.contractVersion` (the additive-only READ contract — consumers gate on it).
+ */
+import { TrackReader } from "@sentropic/track/read";
+/**
+ * The major-compatible `@sentropic/track/read` READ contract this binding was written against.
+ * The contract is additive-only within a major; we accept any matching major (gate below).
+ */
+export const EXPECTED_TRACK_READ_MAJOR = 1;
+/** Thrown when the installed `@sentropic/track/read` contract major is incompatible. */
+export class TrackContractMismatchError extends Error {
+    actual;
+    expectedMajor;
+    constructor(actual, expectedMajor) {
+        super(`@sentropic/track/read contract ${actual} is incompatible with focus/track ` +
+            `(expects major ${expectedMajor}.x)`);
+        this.actual = actual;
+        this.expectedMajor = expectedMajor;
+        this.name = "TrackContractMismatchError";
+    }
+}
+/** Thrown when a `decisionId` is not present (or not a decision) in the read log. */
+export class DecisionNotFoundError extends Error {
+    decisionId;
+    constructor(decisionId) {
+        super(`decision ${decisionId} not found in the track read log`);
+        this.decisionId = decisionId;
+        this.name = "DecisionNotFoundError";
+    }
+}
+const majorOf = (version) => {
+    const major = Number.parseInt(version.split(".")[0] ?? "", 10);
+    return Number.isNaN(major) ? -1 : major;
+};
+/** A `track` `Outcome` ('pending'|'go'|'no-go'|'deferred') → the focus outcome statement. */
+const outcomeStatement = (outcome) => {
+    switch (outcome) {
+        case "go":
+            return "GO — the decision is ratified.";
+        case "no-go":
+            return "NO-GO — the decision is declined.";
+        case "deferred":
+            return "DEFERRED — the decision is postponed.";
+        case "pending":
+            return "PENDING — the decision is not yet settled.";
+    }
+};
+/** Map an `Option` (id/title/summary/pros?/cons?) into the focus `optionSet` body text. */
+const optionBody = (option) => {
+    const parts = [];
+    if (option.pros !== undefined && option.pros.length > 0) {
+        parts.push(`pros: ${option.pros.join("; ")}`);
+    }
+    if (option.cons !== undefined && option.cons.length > 0) {
+        parts.push(`cons: ${option.cons.join("; ")}`);
+    }
+    return parts.length > 0 ? parts.join("\n") : undefined;
+};
+/**
+ * Extract the comprehension evidence carried VERBATIM on the dossier's
+ * `kind:'h2a-decision-dossier'` artifacts. ComprehensionEvidence is NESTED (not a top-level
+ * sibling of the view): `dossier.artifacts[] → .comprehension[]`. We keep `subject` (the NAMED
+ * attester/decider) intact — it is DISTINCT from any channel principal that merely relayed the
+ * write (the anti-confused-deputy invariant: never launder the origin).
+ */
+const collectComprehension = (dossier) => {
+    const out = [];
+    for (const artifact of dossier.artifacts ?? []) {
+        if (artifact.kind === "h2a-decision-dossier") {
+            for (const ev of artifact.comprehension ?? []) {
+                out.push(ev);
+            }
+        }
+    }
+    return out;
+};
+/** Map a track `ComprehensionEvidence` into the focus model's verbatim shape (subject intact). */
+const toFocusComprehension = (ev) => ({
+    subject: ev.subject,
+    dossierHash: ev.dossierHash,
+    ...(ev.sig !== undefined ? { signature: ev.sig.value } : {}),
+});
+/** Map a track `AmendmentStep` (seq/at/by/kind/prov/origin/...) into the focus amendment step. */
+const toFocusAmendmentStep = (step) => ({
+    at: step.at,
+    // `by` is the actor on whose behalf the write was recorded; `origin` ('human'|'machine')
+    // derives PURELY from `prov.proposed` — the machine origin is never laundered. We surface the
+    // origin alongside the actor so the rendered trace is honest about machine-proposed steps.
+    author: `${step.by} (${step.origin})`,
+    summary: step.summary ?? step.kind,
+});
+/**
+ * Build the focus `DecisionDossierDocument` sections from a real track `Dossier`:
+ * a `prose` context node, one `question` per QA entry (préco = recommendation rationale when it
+ * targets the answered option), an `optionSet` of the options, and a terminal `outcome` node.
+ */
+const buildSections = (view) => {
+    const dossier = view.dossier;
+    const sections = [];
+    sections.push({
+        kind: "prose",
+        id: `${view.id}:context`,
+        targetRef: `${view.id}:context`,
+        markdown: dossier.context,
+    });
+    for (const qa of dossier.qa) {
+        sections.push(mapQa(view.id, qa));
+    }
+    if (dossier.options.length > 0) {
+        sections.push({
+            kind: "optionSet",
+            id: `${view.id}:options`,
+            targetRef: `${view.id}:options`,
+            title: "Options",
+            options: dossier.options.map((opt) => ({
+                kind: "option",
+                id: opt.id,
+                targetRef: opt.id,
+                label: opt.title,
+                ...(optionBody(opt) !== undefined ? { body: optionBody(opt) } : {}),
+                // The annotation reflects the dossier's selection/recommendation, NOT a live action:
+                // the selected option is 'accept'; the others are 'none' in this read-only snapshot.
+                annotation: opt.id === dossier.selectedOptionId ? "accept" : "none",
+                ...(dossier.recommendation?.optionId === opt.id
+                    ? { annotationComment: dossier.recommendation.rationale }
+                    : {}),
+            })),
+        });
+    }
+    sections.push({
+        kind: "outcome",
+        id: `${view.id}:outcome`,
+        targetRef: `${view.id}:outcome`,
+        modality: "decision",
+        statement: outcomeStatement(view.outcome),
+    });
+    return sections;
+};
+const mapQa = (decisionId, qa) => ({
+    kind: "question",
+    id: qa.id,
+    targetRef: qa.id,
+    question: qa.question,
+    ...(qa.answer !== undefined ? { answer: qa.answer } : {}),
+    // A QA entry carries no separate préco field in the track contract; an answered entry is
+    // 'answered', an open one is 'open'. (The validated state is only reachable via a live write.)
+    state: qa.answer !== undefined ? "answered" : "open",
+});
+/**
+ * Map a REAL track `DecisionDossierView` + its ordered `amendmentTrace` into the concrete L1
+ * `DecisionDossierDocument`. The comprehension evidence is carried VERBATIM from the nested
+ * `dossier.artifacts[] (kind:'h2a-decision-dossier').comprehension[]` (subject/hash/sig intact).
+ */
+export const toDecisionDossierDocument = (view, amendmentTrace, meta) => {
+    const comprehension = collectComprehension(view.dossier);
+    const firstComprehension = comprehension[0];
+    return {
+        ref: view.id,
+        subject: view.workspace,
+        title: view.title,
+        // The dossier hash is the integrity tag the attester signed over; surface the first one as the
+        // snapshot hash when present, else fall back to the read cursor.
+        hash: firstComprehension?.dossierHash ?? meta.cursor,
+        cursor: meta.cursor,
+        sections: buildSections(view),
+        // The read is a snapshot: the affordances are surfaced disabled by the renderers; this binding
+        // does not invent live actions (those are L3+/L4). We leave interactions empty here — the
+        // canevas affordances are NOT laundered into the read-only doc.
+        interactions: [],
+        provenance: {
+            source: meta.source,
+            readAt: meta.readAt,
+            ...(firstComprehension !== undefined
+                ? { comprehensionEvidence: toFocusComprehension(firstComprehension) }
+                : {}),
+        },
+        amendmentTrace: amendmentTrace.map(toFocusAmendmentStep),
+    };
+};
+/**
+ * Read a real decision from a track event log and project it into a `DecisionDossierDocument`.
+ *
+ * PURE / read-only / clockless: the `readAt` timestamp is CALLER-supplied (track holds no clock),
+ * and no auth/identity is involved. The binding gates on `reader.contractVersion` (additive-only
+ * READ contract) and throws `TrackContractMismatchError` on an incompatible major.
+ *
+ * @param eventsPath  path to the track event log (`.track/events.jsonl`)
+ * @param query       workspace + baseline commit + decision id
+ * @param readAt      caller-supplied ISO-8601 read timestamp (no clock in track)
+ */
+export const readDecisionDossier = (eventsPath, query, readAt) => {
+    const reader = new TrackReader(eventsPath);
+    if (majorOf(reader.contractVersion) !== EXPECTED_TRACK_READ_MAJOR) {
+        throw new TrackContractMismatchError(reader.contractVersion, EXPECTED_TRACK_READ_MAJOR);
+    }
+    const canevas = reader.canevas(query.workspace, {
+        baselineCommit: query.baselineCommit,
+        decisionId: query.decisionId,
+    });
+    if (canevas.dossier === undefined) {
+        throw new DecisionNotFoundError(query.decisionId);
+    }
+    const amendmentTrace = reader.amendmentTrace(query.decisionId);
+    const cursor = reader.cursor();
+    return toDecisionDossierDocument(canevas.dossier, amendmentTrace, {
+        source: `track:${eventsPath}`,
+        readAt,
+        cursor: `count:${cursor.count}`,
+    });
+};
+//# sourceMappingURL=index.js.map

package/dist/focus-vendor/track/index.js.map

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