@akagilnc/pi-workflow-roles 0.1.4422 → 0.1.4444

package/dist/ticket-provenance.js

@@ -87,6 +87,24 @@ export function resolveTicketProvenanceVolume(ticketNumber, cwd, home) {
     const path = resolveSitianRecordPath(ticketProvenanceRecordInput(ticketNumber, cwd, home));
     return { recordFile: path.recordFile, volumeDir: path.sessionDir };
 }
+function projectTicketProvenanceRaw(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        return undefined;
+    const raw = value;
+    if (typeof raw.raw !== "string" || !Number.isInteger(raw.s) || raw.s < 0 ||
+        !Number.isInteger(raw.sourcePosition) || raw.sourcePosition < 0) {
+        return undefined;
+    }
+    const sourceIdentity = typeof raw.sourceIdentity === "string" && raw.sourceIdentity !== ""
+        ? raw.sourceIdentity
+        : undefined;
+    return {
+        raw: raw.raw,
+        s: raw.s,
+        sourcePosition: raw.sourcePosition,
+        ...(sourceIdentity === undefined ? {} : { sourceIdentity }),
+    };
+}
 function projectTicketProvenanceCommit(value) {
     if (typeof value !== "object" || value === null || Array.isArray(value))
         return undefined;
@@ -105,10 +123,19 @@ function projectTicketProvenanceCommit(value) {
         return undefined;
     const lines = [];
     for (const raw of body.lines) {
+        if (typeof raw === "string") {
+            lines.push(raw);
+            continue;
+        }
         const line = projectTicketProvenanceLine(raw);
-        if (line === undefined)
+        if (line !== undefined) {
+            lines.push(line);
+            continue;
+        }
+        const preserved = projectTicketProvenanceRaw(raw);
+        if (preserved === undefined)
             return undefined;
-        lines.push(line);
+        lines.push(preserved);
     }
     return { timestamp: record.timestamp, sessions, lines };
 }
@@ -121,7 +148,14 @@ export async function readTicketProvenance(ticketNumber, cwd, home) {
     }
     catch (error) {
         if (error.code === "ENOENT") {
-            return { header: undefined, lines: [], unprojectedRaw: [], recordFile };
+            return {
+                header: undefined,
+                lines: [],
+                unprojectedRaw: [],
+                recordFile,
+                sourceIdentities: new Map(),
+                legacySourcePositions: new Map(),
+            };
         }
         throw error;
     }
@@ -129,6 +163,33 @@ export async function readTicketProvenance(ticketNumber, cwd, home) {
     let header;
     const lines = [];
     const unprojectedRaw = [];
+    const sourceIdentities = new Map();
+    const legacySourcePositions = new Map();
+    const rememberIdentity = (s, identity) => {
+        const seen = sourceIdentities.get(s) ?? new Set();
+        const fresh = !seen.has(identity);
+        seen.add(identity);
+        sourceIdentities.set(s, seen);
+        return fresh;
+    };
+    const rememberLegacyPosition = (s, position) => {
+        const seen = legacySourcePositions.get(s) ?? new Set();
+        seen.add(position);
+        legacySourcePositions.set(s, seen);
+    };
+    const remapCoverage = (coverage, priorIndexes) => {
+        const normalized = new Map();
+        for (const [s, values] of coverage) {
+            const target = priorIndexes[s] ?? s;
+            const union = normalized.get(target) ?? new Set();
+            for (const value of values)
+                union.add(value);
+            normalized.set(target, union);
+        }
+        coverage.clear();
+        for (const [s, values] of normalized)
+            coverage.set(s, values);
+    };
     let sawFirst = false;
     for (let index = 0; index < physical.length; index += 1) {
         const raw = physical[index];
@@ -158,10 +219,34 @@ export async function readTicketProvenance(ticketNumber, cwd, home) {
         const commit = projectTicketProvenanceCommit(parsed);
         if (commit !== undefined) {
             const merged = mergeSessionBounds(header?.sessions, commit.sessions);
-            const remapped = commit.lines.map((entry) => ({
-                ...entry,
-                s: merged.incomingIndexes[entry.s] ?? entry.s,
-            }));
+            remapCoverage(sourceIdentities, merged.priorIndexes);
+            remapCoverage(legacySourcePositions, merged.priorIndexes);
+            const remapped = [];
+            for (const entry of commit.lines) {
+                if (typeof entry === "string") {
+                    unprojectedRaw.push(entry);
+                    continue;
+                }
+                const s = merged.incomingIndexes[entry.s] ?? merged.priorIndexes[entry.s] ?? entry.s;
+                if ("raw" in entry) {
+                    if (entry.sourceIdentity !== undefined) {
+                        if (rememberIdentity(s, entry.sourceIdentity))
+                            unprojectedRaw.push(entry.raw);
+                    }
+                    else {
+                        rememberLegacyPosition(s, entry.sourcePosition);
+                        unprojectedRaw.push(entry.raw);
+                    }
+                    continue;
+                }
+                remapped.push({ ...entry, s });
+                if (entry.id === undefined) {
+                    if (entry.sourceIdentity !== undefined)
+                        rememberIdentity(s, entry.sourceIdentity);
+                    else if (entry.sourcePosition !== undefined)
+                        rememberLegacyPosition(s, entry.sourcePosition);
+                }
+            }
             const now = commit.timestamp;
             header = {
                 repo: header?.repo ?? resolveBookKeyFromGit(cwd),
@@ -180,7 +265,22 @@ export async function readTicketProvenance(ticketNumber, cwd, home) {
         // Unknown stock / damaged rows remain readable and are never upgraded in place.
         unprojectedRaw.push(raw);
     }
-    return { header, lines, unprojectedRaw, recordFile };
+    for (const line of lines) {
+        if (line.id !== undefined)
+            continue;
+        if (line.sourceIdentity !== undefined)
+            rememberIdentity(line.s, line.sourceIdentity);
+        else if (line.sourcePosition !== undefined)
+            rememberLegacyPosition(line.s, line.sourcePosition);
+    }
+    return {
+        header,
+        lines,
+        unprojectedRaw,
+        recordFile,
+        sourceIdentities,
+        legacySourcePositions,
+    };
 }
 /**
  * Ensure the per-ticket directory + volume file exist (ADR 0075 ticket-provenance-file).
@@ -218,10 +318,10 @@ function resolveBoundIndex(bound, sessionLines) {
     }
     return undefined;
 }
-function amendmentKey(s, line) {
-    return `${s}:${line}`;
-}
 /** Exact range identity for cumulative header dedupe (idempotent resubmit). */
+function dialogueIdentity(s, id) {
+    return `${s}\u0000${id}`;
+}
 function rangeDeclarationKey(range) {
     return JSON.stringify({
         from: range.from,
@@ -267,7 +367,7 @@ function mergeSessionBounds(prior, incoming) {
 }
 /**
  * #918 第一节：已投影行即卷宗。只对 prior 未声明的 range（按 path identity + 精确
- * from/to）读源；已声明的按 s,line 结转，不重读历史源。
+ * from/to）读源；已声明的投影原样结转，不重读历史源。
  */
 function undeclaredSessionRanges(prior, merged) {
     const priorKeys = new Map();
@@ -284,7 +384,8 @@ function undeclaredSessionRanges(prior, merged) {
     const out = [];
     for (let s = 0; s < merged.length; s += 1) {
         const session = merged[s];
-        const declared = priorKeys.get(physicalPathIdentity(session.path)) ?? new Set();
+        const identity = physicalPathIdentity(session.path);
+        const declared = priorKeys.get(identity) ?? new Set();
         const fresh = session.ranges.filter((range) => !declared.has(rangeDeclarationKey(range)));
         if (fresh.length === 0)
             continue;
@@ -301,46 +402,85 @@ function undeclaredSessionRanges(prior, merged) {
     }
     return out;
 }
-/** Sort archive rows by session index then source line (stable within equal keys). */
-function compareLinePosition(left, right) {
-    if (left.s !== right.s)
-        return left.s - right.s;
-    const leftLine = left.line ?? Number.MAX_SAFE_INTEGER;
-    const rightLine = right.line ?? Number.MAX_SAFE_INTEGER;
-    return leftLine - rightLine;
-}
 /**
  * Merge newly projected rows into the carried archive.
- * 既有卷宗按 (s,line) 优先；fresh 不得复制无 id 行（#918 C2/G1）。
- * id 去重仍保留（跨 path 同 id 首见胜）。
+ * Native id remains the typed first-seen identity; exact range resubmission is a no-op.
  */
 function mergeFreshIntoCarried(carried, fresh) {
-    const seenIds = new Set();
-    const seenPositions = new Set();
-    const out = [];
-    for (const line of carried) {
-        if (line.id !== undefined)
-            seenIds.add(line.id);
-        if (line.line !== undefined)
-            seenPositions.add(amendmentKey(line.s, line.line));
-        out.push(line);
-    }
-    for (const line of fresh) {
-        if (line.id !== undefined) {
-            if (seenIds.has(line.id))
+    const seenSources = new Map();
+    const bySession = new Map();
+    const absorb = (lines) => {
+        for (const line of lines) {
+            const sourceIdentity = line.id === undefined
+                ? line.sourceIdentity
+                : `id\u0000${line.id}`;
+            const identity = sourceIdentity === undefined
+                ? undefined
+                : `${line.s}\u0000${sourceIdentity}`;
+            const seen = identity === undefined ? undefined : seenSources.get(identity);
+            if (seen !== undefined) {
+                if (line.sourcePosition !== undefined) {
+                    Object.assign(seen, { sourcePosition: line.sourcePosition });
+                }
                 continue;
-            seenIds.add(line.id);
+            }
+            const bucket = bySession.get(line.s) ?? [];
+            bucket.push({ ...line });
+            if (identity !== undefined)
+                seenSources.set(identity, bucket.at(-1));
+            bySession.set(line.s, bucket);
         }
-        if (line.line !== undefined) {
-            const position = amendmentKey(line.s, line.line);
-            if (seenPositions.has(position))
-                continue;
-            seenPositions.add(position);
+    };
+    absorb(carried);
+    absorb(fresh);
+    return [...bySession.entries()]
+        .sort(([left], [right]) => left - right)
+        .flatMap(([, lines]) => lines
+        .map((line, archiveIndex) => ({ line, archiveIndex }))
+        .sort((left, right) => {
+        const leftPosition = left.line.sourcePosition;
+        const rightPosition = right.line.sourcePosition;
+        if (leftPosition === undefined && rightPosition === undefined) {
+            return left.archiveIndex - right.archiveIndex;
+        }
+        if (leftPosition === undefined)
+            return 1;
+        if (rightPosition === undefined)
+            return -1;
+        return leftPosition - rightPosition || left.archiveIndex - right.archiveIndex;
+    })
+        .map(({ line }) => line));
+}
+/**
+ * Give every logical source row a replay-invariant ordinal. Native ids identify
+ * replayed rows directly; idless rows use their ordinal after the preceding
+ * native id. Neither key inspects dialogue text or physical line numbers.
+ */
+function stableSourceFacts(sessionLines) {
+    const positionByIdentity = new Map();
+    const facts = [];
+    let precedingId = "<start>";
+    let idlessOffset = 0;
+    for (const entry of sessionLines) {
+        const id = entry.row === undefined ? undefined : nativeEventId(entry.row);
+        if (id !== undefined) {
+            precedingId = id;
+            idlessOffset = 0;
+        }
+        else {
+            idlessOffset += 1;
         }
-        out.push(line);
+        const identity = id === undefined
+            ? `after\u0000${precedingId}\u0000${idlessOffset}`
+            : `id\u0000${id}`;
+        let position = positionByIdentity.get(identity);
+        if (position === undefined) {
+            position = positionByIdentity.size;
+            positionByIdentity.set(identity, position);
+        }
+        facts.push({ position, identity });
     }
-    out.sort(compareLinePosition);
-    return out;
+    return facts;
 }
 /**
  * Resolve submitted ranges against the session, then sort by source position and
@@ -396,52 +536,49 @@ async function projectSessionRanges(input) {
     }
     const rows = sessionLines.map((entry) => entry.row);
     const dialogue = adaptSessionDialogue(rows);
+    const sourceFacts = stableSourceFacts(sessionLines);
+    const sourcePositionByIdentity = new Map();
+    for (const fact of sourceFacts) {
+        sourcePositionByIdentity.set(fact.identity, fact.position);
+    }
     const seenIds = input.seenIds;
     const lines = [];
-    const unparsable = [];
+    const raw = [];
     const ranges = normalizeResolvedRanges(input.session.ranges, sessionLines, input.session.path);
     for (const range of ranges) {
         for (let index = range.fromIndex; index <= range.toIndex; index += 1) {
+            const { position: sourcePosition, identity: sourceIdentity } = sourceFacts[index];
+            if (input.coveredSourceIdentities.has(sourceIdentity) ||
+                input.legacyCoveredSourcePositions.has(sourcePosition))
+                continue;
             const entry = sessionLines[index];
             if (entry.row === undefined) {
-                const key = amendmentKey(input.s, entry.line);
-                const amendment = input.amendmentsByKey.get(key);
-                if (amendment !== undefined) {
-                    lines.push({
-                        speaker: amendment.speaker,
-                        s: input.s,
-                        line: entry.line,
-                        text: amendment.text,
-                    });
-                }
-                else {
-                    unparsable.push({ s: input.s, line: entry.line, raw: entry.raw });
-                }
+                raw.push({ raw: entry.raw, s: input.s, sourcePosition, sourceIdentity });
                 continue;
             }
             for (const event of dialogue[index] ?? []) {
                 if (event.id !== undefined) {
-                    if (seenIds.has(event.id))
+                    const identity = dialogueIdentity(input.s, event.id);
+                    if (seenIds.has(identity))
                         continue;
-                    seenIds.add(event.id);
+                    seenIds.add(identity);
                 }
                 lines.push({
                     speaker: event.speaker,
                     s: input.s,
-                    line: entry.line,
-                    ...(event.id === undefined ? {} : { id: event.id }),
+                    sourcePosition,
+                    ...(event.id === undefined ? { sourceIdentity } : { id: event.id }),
                     text: event.text,
                 });
             }
         }
     }
-    return { lines, unparsable };
+    return { lines, raw, sourcePositionByIdentity };
 }
 /**
- * Reproject the unique diary from cumulative bounds + optional amendments.
- * #918：已投影行即卷宗——按 s,line 结转；本轮只读 prior 未声明的 range（或新
- * session 区间）。精确重复提交＝幂等 no-op，不因历史源不可读而失败。
- * amendments 只在本轮读取的新范围确有对应坏行时生效；空 sessions 保持 no-op。
+ * Reproject the unique diary from cumulative bounds.
+ * #918：已投影行即卷宗；本轮只读 prior 未声明的 range（或新 session 区间）。
+ * 精确重复提交＝幂等 no-op，不因历史源不可读而失败；空 sessions 保持 no-op。
  * 证不出的 body 原字节经 unprojectedRaw 原样留存。
  * Persistence appends one immutable commit through the Sitian appender seam.
  */
@@ -459,7 +596,6 @@ export async function reprojectTicketProvenance(input) {
                 sessions: [],
             },
             lines: prior.lines,
-            unparsable: [],
         };
     }
     const merged = mergeSessionBounds(prior.header?.sessions, input.sessions);
@@ -476,32 +612,33 @@ export async function reprojectTicketProvenance(input) {
                 sessions: merged.sessions,
             },
             lines: prior.lines,
-            unparsable: [],
         };
     }
-    const amendmentsByKey = new Map();
-    for (const amendment of input.amendments ?? []) {
-        const cumulativeIndex = merged.incomingIndexes[amendment.s];
-        if (cumulativeIndex === undefined)
-            continue;
-        amendmentsByKey.set(amendmentKey(cumulativeIndex, amendment.line), {
-            ...amendment,
-            s: cumulativeIndex,
-        });
-    }
-    const seenIds = new Set(prior.lines.flatMap((line) => line.id === undefined ? [] : [line.id]));
+    const seenIds = new Set(prior.lines.flatMap((line) => line.id === undefined ? [] : [dialogueIdentity(line.s, line.id)]));
     const fresh = [];
-    const unparsable = [];
+    const raw = [];
     for (const delta of deltas) {
         const projected = await projectSessionRanges({
             s: delta.s,
             session: delta.session,
-            amendmentsByKey,
             seenIds,
+            coveredSourceIdentities: prior.sourceIdentities.get(delta.s) ?? new Set(),
+            legacyCoveredSourcePositions: prior.legacySourcePositions.get(delta.s) ?? new Set(),
             ...(input.home === undefined ? {} : { home: input.home }),
         });
+        fresh.push(...prior.lines.flatMap((line) => {
+            if (line.s !== delta.s)
+                return [];
+            const sourceIdentity = line.id === undefined
+                ? line.sourceIdentity
+                : `id\u0000${line.id}`;
+            if (sourceIdentity === undefined)
+                return [];
+            const sourcePosition = projected.sourcePositionByIdentity.get(sourceIdentity);
+            return sourcePosition === undefined ? [] : [{ ...line, sourcePosition }];
+        }));
         fresh.push(...projected.lines);
-        unparsable.push(...projected.unparsable);
+        raw.push(...projected.raw);
     }
     const lines = mergeFreshIntoCarried(prior.lines, fresh);
     const now = new Date().toISOString();
@@ -512,9 +649,6 @@ export async function reprojectTicketProvenance(input) {
         updatedAt: now,
         sessions: merged.sessions,
     };
-    if (unparsable.length > 0) {
-        return { recordFile: prior.recordFile, header, lines, unparsable };
-    }
     // One immutable projection commit. Its deterministic identity makes retries of
     // the same logical increment converge, while unrelated concurrent increments
     // append independently and are folded by readTicketProvenance.
@@ -525,7 +659,7 @@ export async function reprojectTicketProvenance(input) {
             path: physicalPathIdentity(session.path),
             ranges: session.ranges,
         })),
-        lines: fresh,
+        lines: [...fresh, ...raw],
     });
     const identity = `ticket-provenance:${createHash("sha256").update(identityMaterial).digest("hex")}`;
     const pointer = appendSitianRecord({
@@ -534,7 +668,7 @@ export async function reprojectTicketProvenance(input) {
         payload: {
             type: "ticket-provenance-append",
             sessions: merged.sessions,
-            lines: fresh,
+            lines: [...fresh, ...raw],
         },
     });
     const folded = await readTicketProvenance(input.ticketNumber, input.cwd, input.home);
@@ -542,6 +676,5 @@ export async function reprojectTicketProvenance(input) {
         recordFile: pointer.recordFile,
         header: folded.header ?? header,
         lines: folded.lines,
-        unparsable: [],
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akagilnc/pi-workflow-roles",
-  "version": "0.1.4422",
+  "version": "0.1.4444",
   "description": "Soul-bound workflow roles for Pi",
   "type": "module",
   "license": "Apache-2.0",

package/src/diarist-contracts.ts

@@ -4,13 +4,11 @@
  * Machine facts about the volume come from the mechanical reproject seam, never
  * from model self-report (锚定宪法); this module owns the receipt shape only.
  *
- * #901: LLM submits bounds (+ optional amendments); mechanical layer projects.
+ * #901: LLM submits bounds; the mechanical layer projects source bytes.
  */
 
 import {
-  projectTicketProvenanceAmendments,
   projectTicketProvenanceSessions,
-  type TicketProvenanceAmendment,
   type TicketProvenanceSession,
 } from "./ticket-provenance-contracts.ts";
 import {
@@ -45,11 +43,6 @@ export type DiaristOutput =
        * Malformed endpoints → accept hook reasks (`reask-not-explode`).
        */
       readonly sessions?: readonly TicketProvenanceSession[];
-      /**
-       * Optional amendments for unparsable source lines (s + line + speaker + text).
-       * Absent = no amendments this turn (not a shape rejection).
-       */
-      readonly amendments?: readonly TicketProvenanceAmendment[];
     }
   | {
       /** LLM cannot tell which ticket this summons is about — escalate, never wash into 无录. */
@@ -187,14 +180,3 @@ export function projectDiaristSessions(
   if (raw === undefined) return [];
   return projectTicketProvenanceSessions(raw);
 }
-
-/**
- * Project optional amendments. Absent / non-array → empty (not a rejection).
- */
-export function projectDiaristAmendments(
-  value: unknown,
-): readonly TicketProvenanceAmendment[] {
-  const raw = (value as { amendments?: unknown } | null)?.amendments;
-  if (raw === undefined) return [];
-  return projectTicketProvenanceAmendments(raw);
-}

package/src/diarist-role.ts

@@ -18,7 +18,7 @@ export { validateRecordedDiaristOutput };
 
 /**
  * 起居郎交卷形状；形状指引，非 schema 闸。
- * #901：交边界（sessions）+ 可选坏行补写（amendments）；正文由机械投影。
+ * #901：交边界（sessions）；正文与不可解析原字节由机械投影。
  */
 export const diaristOutputSchema = withTerminatingOutputDeclarations(
   openToolObject(
@@ -93,34 +93,6 @@ export const diaristOutputSchema = withTerminatingOutputDeclarations(
           },
         ),
       ),
-      amendments: Type.Optional(
-        Type.Array(
-          Type.Object(
-            {
-              s: Type.Optional(
-                Type.Unknown({ description: "卷下标（sessions 位置）" }),
-              ),
-              line: Type.Optional(
-                Type.Unknown({ description: "源卷 1-based 行号" }),
-              ),
-              speaker: Type.Optional(
-                Type.String({ description: "owner | runner" }),
-              ),
-              text: Type.Optional(
-                Type.String({ description: "补写正文（原话）" }),
-              ),
-            },
-            {
-              additionalProperties: true,
-              description: "一条坏行补写；缺字段的成员机械跳过",
-            },
-          ),
-          {
-            description:
-              "可选；机械解析不了的行交此补写。缺本字段＝无补写，不拒收。",
-          },
-        ),
-      ),
     }),
   ),
 );
@@ -138,7 +110,7 @@ export const DIARIST_TOOL_SPEC = {
   name: DIARIST_OUTPUT_TOOL_NAME,
   label: "起居郎输出",
   description:
-    "起居郎交本票对话边界（sessions）与可选坏行补写（amendments）；认不出本庭对象则 escalate。",
-  promptSnippet: "起居郎交边界与可选补写",
+    "起居郎交本票对话边界（sessions）；认不出本庭对象则 escalate。",
+  promptSnippet: "起居郎交边界",
   parameters: diaristOutputSchema,
 } as const;

package/src/diarist.ts

@@ -1,17 +1,11 @@
 /**
  * 起居郎 volume commit — ADR 0075 `diarist-is-role` / #901.
- * LLM submits bounds (+ optional amendments); mechanical layer reprojects the
+ * LLM submits bounds; mechanical layer reprojects the
  * unique records.jsonl from session volumes. No human view. No lifecycle here
  * (ADR 0018): the seat prepares, the role envelope commits.
  */
-import {
-  reprojectTicketProvenance,
-  type UnparsableSessionLine,
-} from "./ticket-provenance.ts";
-import type {
-  TicketProvenanceAmendment,
-  TicketProvenanceSession,
-} from "./ticket-provenance-contracts.ts";
+import { reprojectTicketProvenance } from "./ticket-provenance.ts";
+import type { TicketProvenanceSession } from "./ticket-provenance-contracts.ts";
 
 /**
  * Honest machine facts about what this turn actually committed to the volume.
@@ -22,16 +16,11 @@ export type DiaristCommitFacts = {
   readonly volumeRecordFile: string;
   /** Dialogue lines written by this reproject. */
   readonly lineCount: number;
-  /**
-   * Session lines inside the bounds that still have no amendment.
-   * Accept hook turns a non-empty list into ParentQueueReaskError.
-   */
-  readonly unparsable: readonly UnparsableSessionLine[];
 };
 
 /**
- * Reproject the unique diary from LLM-submitted bounds + optional amendments.
- * Shape projection of sessions/amendments is the caller's job (accept hook);
+ * Reproject the unique diary from LLM-submitted bounds.
+ * Shape projection of sessions is the caller's job (accept hook);
  * this seam only copies source facts into the volume.
  */
 export async function commitDiaristProjection(input: {
@@ -39,19 +28,16 @@ export async function commitDiaristProjection(input: {
   readonly cwd: string;
   readonly home?: string;
   readonly sessions: readonly TicketProvenanceSession[];
-  readonly amendments?: readonly TicketProvenanceAmendment[];
 }): Promise<DiaristCommitFacts> {
   const result = await reprojectTicketProvenance({
     ticketNumber: input.ticketNumber,
     cwd: input.cwd,
     ...(input.home === undefined ? {} : { home: input.home }),
     sessions: input.sessions,
-    ...(input.amendments === undefined ? {} : { amendments: input.amendments }),
   });
   return {
     ticketNumber: input.ticketNumber,
     volumeRecordFile: result.recordFile,
     lineCount: result.lines.length,
-    unparsable: result.unparsable,
   };
 }

package/src/ledger-session-read.ts

@@ -40,8 +40,7 @@ function isRecord(value: unknown): value is Record<string, unknown> {
  * One physical JSONL line as the single kernel saw it.
  * `row` present = syntactically complete session object at that 1-based line.
  * `error` present = the line is complete but unreadable as a session object;
- * `raw` carries its original bytes so a reader that must keep going (起居录
- * projection, ADR 0075 `unparsable-line-to-diarist`) can hand the line back
+ * `raw` carries its original bytes so readers can preserve source evidence
  * instead of inventing content. The unfinished final fragment at EOF is not a
  * line — live tail is honest absence, never a bad line.
  */