@akagilnc/pi-workflow-roles 0.1.4422 → 0.1.4489

package/dist/ticket-provenance-contracts.js

@@ -78,29 +78,6 @@ export function projectTicketProvenanceSessions(value) {
     }
     return sessions;
 }
-/**
- * 投影补写集合。缺该字段＝无补写（不拒收）；成员形状不成立的整条跳过——
- * 它没有绑定位置，放不回去。
- */
-export function projectTicketProvenanceAmendments(value) {
-    if (!Array.isArray(value))
-        return [];
-    const out = [];
-    for (const raw of value) {
-        if (!isRecord(raw))
-            continue;
-        const s = nonNegativeInteger(raw.s);
-        const line = positiveInteger(raw.line);
-        const speaker = projectSpeaker(raw.speaker);
-        const text = raw.text;
-        if (s === undefined || line === undefined || speaker === undefined)
-            continue;
-        if (typeof text !== "string")
-            continue;
-        out.push({ s, line, speaker, text });
-    }
-    return out;
-}
 /** 读回册子头（文件第一行）。形状不成立即 undefined——按无册处理，不猜。 */
 export function projectTicketProvenanceHeader(value) {
     if (!isRecord(value))
@@ -135,12 +112,16 @@ export function projectTicketProvenanceLine(value) {
         return undefined;
     if (typeof value.text !== "string")
         return undefined;
-    const line = positiveInteger(value.line);
+    const sourcePosition = nonNegativeInteger(value.sourcePosition);
+    const sourceIdentity = typeof value.sourceIdentity === "string" && value.sourceIdentity !== ""
+        ? value.sourceIdentity
+        : undefined;
     const id = typeof value.id === "string" && value.id !== "" ? value.id : undefined;
     return {
         speaker,
         s,
-        ...(line === undefined ? {} : { line }),
+        ...(sourcePosition === undefined ? {} : { sourcePosition }),
+        ...(sourceIdentity === undefined ? {} : { sourceIdentity }),
         ...(id === undefined ? {} : { id }),
         text: value.text,
     };

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/extensions/role-runtime.ts

@@ -31,9 +31,14 @@ import { JUDGE_OUTPUT_TOOL_NAME } from "../src/package-contracts/judge-output.ts
 import { readOAuthKeepaliveProviders } from "../src/oauth-keepalive.ts";
 import {
   formatNavigatorRoleHelp,
+  type RoleRuntimeDependencies,
 } from "../src/role-runtime.ts";
 import { loadAuditorSoulFromSubjectInput } from "../src/auditor-soul.ts";
-import { loadGatekeeperSessionMaterials, loadMainRoleSessionMaterials } from "../src/session-opening-materials.ts";
+import { loadPackagedRoleReferenceMaterials } from "../src/role-runtime-dependencies.ts";
+import {
+  loadGatekeeperSessionMaterials,
+  loadMainRoleSessionMaterials,
+} from "../src/session-opening-materials.ts";
 const extensionPath = fileURLToPath(import.meta.url);
 const packageRoot = fileURLToPath(new URL("..", import.meta.url));
 const navigatorRoutePlaybookPath = fileURLToPath(new URL("../resources/navigator-route-playbook.md", import.meta.url));
@@ -105,12 +110,11 @@ export async function loadNavigatorWorkContext(
   });
 }
 
-export default function roleRuntime(pi: ExtensionAPI): void {
-  const oauthKeepaliveProviders = readOAuthKeepaliveProviders();
-  registerNavigatorModelCommand(pi);
+export function createPiRoleRuntimeDependencies(pi: ExtensionAPI): RoleRuntimeDependencies {
   const navigatorSessionFactory = createNativeNavigatorSessionFactory();
-  createPiRoleRuntimeExtension({
+  return {
     packageRoot,
+    loadRoleReferenceMaterials: loadPackagedRoleReferenceMaterials,
     loadJudgeSoul: () => loadMainRoleSessionMaterials("judge"),
     loadFixerSoul: () => loadMainRoleSessionMaterials("fixer"),
     loadFixPacket: (path) => readFile(path, "utf8"),
@@ -167,7 +171,13 @@ export default function roleRuntime(pi: ExtensionAPI): void {
       }
       return loadHomeCanonicalSkillBinding(name);
     },
-  }, {
+  };
+}
+
+export default function roleRuntime(pi: ExtensionAPI): void {
+  const oauthKeepaliveProviders = readOAuthKeepaliveProviders();
+  registerNavigatorModelCommand(pi);
+  createPiRoleRuntimeExtension(createPiRoleRuntimeDependencies(pi), {
     transcriptFromContext,
     oauthKeepalive: { providers: oauthKeepaliveProviders },
   })(pi);

package/package.json

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

package/resources/method-host-plugin/.claude-plugin/plugin.json

@@ -0,0 +1,5 @@
+{
+  "name": "ak-methods",
+  "version": "0.0.0",
+  "description": "ak-roles packaged role method skills"
+}

package/scripts/build-package.mjs

@@ -1,4 +1,4 @@
-import { chmod, copyFile, mkdir, readFile, writeFile } from "node:fs/promises";
+import { chmod, copyFile, cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { build } from "esbuild";
@@ -200,6 +200,11 @@ export async function buildPackageArtifacts() {
   await buildAcpProductionHost();
   await buildHeadlessProductionHost();
   await buildMigrateBookTopology();
+  const pluginDir = join("dist", "method-host-plugin");
+  await rm(pluginDir, { recursive: true, force: true });
+  await mkdir(pluginDir, { recursive: true });
+  await cp("resources/method-host-plugin/.claude-plugin", join(pluginDir, ".claude-plugin"), { recursive: true });
+  await cp("resources/methods", join(pluginDir, "skills"), { recursive: true });
 }
 
 const isMain =

package/src/acp-host/description.ts

@@ -1,6 +1,6 @@
 /**
  * One ACP host description. Every host-specific value the generic ACP adapter
- * needs — binary location, argv shape, resume verb, binding filename, child env,
+ * needs — binary location, argv shape, resume verb, binding filename,
  * optional seat-profile soul — is data here; the lifecycle in role-turn-host.ts
  * stays one copy (#732).
  */
@@ -30,7 +30,6 @@ export type AcpHostDescription = Readonly<{
   boundResume: "session/load" | "session/new";
   /** Durable ACP binding filename written beside the session principal. */
   sessionBindingFile: string;
-  childEnv: Readonly<Record<string, string>>;
   /**
    * When set, the production factory ensures a seat profile whose SOUL.md is a
    * symlink to the packaged role soul, and prefixes argv with `flag <name>`.
@@ -44,8 +43,7 @@ export function resolveAcpBinary(description: AcpHostDescription, operatorHome:
   return join(operatorHome, ...description.binaryFromHome);
 }
 
-/** Stdio argv: optional profile flag, thinking flag (before the subcommand),
- * prefix, optional model flag pair, suffix. */
+/** Stdio argv: optional profile flag, thinking flag, prefix, model, suffix. */
 export function acpStdioArgs(
   description: AcpHostDescription,
   model?: { readonly model?: string; readonly thinking?: string },

package/src/acp-host/production-host.ts

@@ -55,7 +55,6 @@ export function createProductionAcpRoleTurnHost(options: ProductionAcpHostOption
   const { packageRoot, principalAuthority, description, hostName } = options;
   const env: NodeJS.ProcessEnv = {
     ...process.env,
-    ...description.childEnv,
     AK_PACKAGE_ROOT: packageRoot,
   };
 

package/src/auditor-soul.ts

@@ -85,10 +85,19 @@ export async function loadAuditorSoul(role: AuditorSoulRole): Promise<string> {
   if (soul.trim().length === 0) {
     throw new Error(`The ${role} auditor Soul is blank`);
   }
-  return joinPackageMaterials(materials);
+  return soul;
+}
+
+export function loadAuditorReferenceMaterials(role: AuditorSoulRole): Promise<string> {
+  const soulPath = auditorSoulRelativePath(role);
+  return joinPackageMaterials(AUDITOR_SESSION_MATERIALS[role].filter((path) => path !== soulPath));
 }
 
 /** Runtime loader: subject input decides which soul file to assemble. */
 export async function loadAuditorSoulFromSubjectInput(raw?: string): Promise<string> {
   return loadAuditorSoul(resolveAuditorSubject(raw));
 }
+
+export function loadAuditorReferenceMaterialsFromSubjectInput(raw?: string): Promise<string> {
+  return loadAuditorReferenceMaterials(resolveAuditorSubject(raw));
+}