@akagilnc/pi-workflow-roles 0.1.5235 → 0.1.5241

package/src/sitian-appender.ts

@@ -127,20 +127,6 @@ export function resolveSitianRecordPathInLedger(
   return { sessionDir, recordFile, ledgerHome };
 }
 
-/**
- * Owner-visible ticket 起居录 path shape via the writer ticket joins
- * (ticketProvenanceUnderBookPaths). Ledger leaf is the package-owned `.ak-roles`
- * name (ADR 0048); variable slots keep owner labels; no fake-home path reverse.
- */
-export function projectTicketRecordsPathShape(): string {
-  const { recordFile } = ticketProvenanceUnderBookPaths(
-    join("~", ".ak-roles"),
-    "<簿>",
-    "<票号>",
-  );
-  return recordFile.replace(/\\/g, "/");
-}
-
 /** Compute a write destination from ambient ledger topology (ADR 0065). */
 export function resolveSitianRecordPath(input: SitianRecordInput): SitianRecordPath {
   const ledgerHome =

package/dist/public-cli/case-dossier-delivery.js

@@ -1,109 +0,0 @@
-/**
- * 系统随案递送起居录路径的中立指针段（ADR 0081：公共入口直接挂案卷，Soul 只说明用途不负责派送；
- * #709 公共入口通用递送与 #742 给事中受理链路同源；#858 告诉 LLM 路径，不另建取号/lookup）。
- * 指针输入沿 ADR 0079（指针是绑定材料由代码精准递送），不把卷宗正文塞进提示词。
- * 只告诉路径：不刷新、不生成、不校验内容、不新增拒收或停工条件、不从 instruction 抽票号。
- * 机器文本仅中立标识材料（ADR 0073），用途说明归角色材料所有。
- *
- * 递送挂载点唯一：`post-admission` 在 beforeDispatch 之后为每个公共入口挂载。
- * 全部公共入口（ordinary 已绑定／未绑定与 station-child）统一走 attachments 冻结 +
- * role-runtime `loadCaseDossierReadingMaterial` → readingMaterial →
- * systemPrompt.materials fold（#879 / #858：对话 instruction、空请求、resume
- * message 保持调用者原文；起居录作独立附件面，不新造 RoleTurnRequest.materials，
- * 不拼进 user-dialogue continuation）。
- *
- * #858: deliver returns typed FrozenAttachment[]; load currently re-derives the
- * freeze leaf under runDirectory because agent-start only has HostContext.runDirectory.
- * Consuming the typed frozenPath across that process boundary needs a design
- * revision of the existing envelope/persistence seam — not a local replica of
- * freezeAttachments' `00-` naming, not a drift throw, not readdir guessing.
- */
-import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { projectTicketRecordsPathShape } from "../sitian-facade.js";
-import { resolveTicketProvenanceVolume } from "../ticket-provenance.js";
-import { freezeAttachmentsIntoRun, } from "./invocation.js";
-/** Bound-ticket section heading (presentation only). */
-const CASE_DOSSIER_SECTION_HEADING = "## 本票起居录（系统随案提供）";
-/** Unbound path-only heading — no 本票 claim when no typed ticket is on the run. */
-const UNBOUND_DOSSIER_PATH_HEADING = "## 起居录路径（系统随案提供）";
-/** Stable freeze key under run/attachments/ for station-child 0081 delivery. */
-const CASE_DOSSIER_ATTACH_KEY = "case-dossier";
-/** Leaf name of the frozen pointer section (content = purpose + paths). */
-const CASE_DOSSIER_ATTACH_FILE = "case-dossier-pointer.md";
-/**
- * Neutral 起居录 path pointer for every public entry (ADR 0081 delivery seam).
- * Always tells the canonical path shape so the seat LLM can read the diary
- * itself (陛下 2026-09-15: 只需要告诉llm这个路径). When a typed ticket identity is
- * already on the run, also project the concrete resolved file. Never claims a
- * volume or「本票」exists when unbound; never extracts a ticket from instruction.
- * Under-book shape comes only from sitian writer joins — no local replica.
- */
-export async function projectCaseDossierPointerSection(input) {
-    if (input.ticketNumber === undefined) {
-        return [
-            UNBOUND_DOSSIER_PATH_HEADING,
-            "",
-            `记录卷宗：${projectTicketRecordsPathShape()}`,
-        ].join("\n");
-    }
-    const volume = resolveTicketProvenanceVolume(input.ticketNumber, input.projectRoot, input.home);
-    return [
-        CASE_DOSSIER_SECTION_HEADING,
-        "",
-        `票号：#${input.ticketNumber}`,
-        `记录卷宗：${volume.recordFile}`,
-    ].join("\n");
-}
-/**
- * ADR 0081 delivery for every public entry (#879 / #858): freeze the pointer
- * section through the existing attachments seam. Role-runtime loads that freeze
- * via loadCaseDossierReadingMaterial onto readingMaterial; the envelope then
- * folds it into systemPrompt.materials. Caller / peer dialogue instruction stays
- * opaque; never RoleTurnRequest.materials, never user-dialogue continuation.
- * Always freezes the path pointer (canonical shape, or concrete file when a
- * typed ticket is already bound).
- */
-export async function deliverCaseDossierAsAttachment(input) {
-    const section = await projectCaseDossierPointerSection({
-        ticketNumber: input.ticketNumber,
-        projectRoot: input.projectRoot,
-        home: input.home,
-    });
-    // Stage in OS temp only — never leave a run-local .case-dossier-stage copy.
-    const stagingDir = await mkdtemp(join(tmpdir(), "ak-case-dossier-"));
-    try {
-        const stagingPath = join(stagingDir, CASE_DOSSIER_ATTACH_FILE);
-        await writeFile(stagingPath, `${section}\n`, "utf8");
-        return await freezeAttachmentsIntoRun([stagingPath], input.runDirectory, CASE_DOSSIER_ATTACH_KEY);
-    }
-    finally {
-        await rm(stagingDir, { recursive: true, force: true });
-    }
-}
-/**
- * Load a previously frozen case-dossier attachment as reading material
- * (existing agent-start / systemPrompt.materials fold — not dialogue prompt,
- * not RoleTurnRequest.materials). Undefined when the run has no such freeze.
- *
- * #858: this join re-derives freezeAttachments' leaf naming because the
- * agent-start handler only receives runDirectory. Replacing it requires
- * threading deliver's typed frozenPath across the existing envelope seam
- * (design revision) — do not copy freeze's `00-` algorithm here again.
- */
-export async function loadCaseDossierReadingMaterial(runDirectory) {
-    const frozenPath = join(runDirectory, "attachments", CASE_DOSSIER_ATTACH_KEY, `00-${CASE_DOSSIER_ATTACH_FILE}`);
-    let section;
-    try {
-        section = await readFile(frozenPath, "utf8");
-    }
-    catch (error) {
-        if (error.code === "ENOENT")
-            return undefined;
-        throw error;
-    }
-    if (section.trim() === "")
-        return undefined;
-    return { kind: "case-dossier-pointer", frozenPath, section };
-}

package/src/public-cli/case-dossier-delivery.ts

@@ -1,147 +0,0 @@
-/**
- * 系统随案递送起居录路径的中立指针段（ADR 0081：公共入口直接挂案卷，Soul 只说明用途不负责派送；
- * #709 公共入口通用递送与 #742 给事中受理链路同源；#858 告诉 LLM 路径，不另建取号/lookup）。
- * 指针输入沿 ADR 0079（指针是绑定材料由代码精准递送），不把卷宗正文塞进提示词。
- * 只告诉路径：不刷新、不生成、不校验内容、不新增拒收或停工条件、不从 instruction 抽票号。
- * 机器文本仅中立标识材料（ADR 0073），用途说明归角色材料所有。
- *
- * 递送挂载点唯一：`post-admission` 在 beforeDispatch 之后为每个公共入口挂载。
- * 全部公共入口（ordinary 已绑定／未绑定与 station-child）统一走 attachments 冻结 +
- * role-runtime `loadCaseDossierReadingMaterial` → readingMaterial →
- * systemPrompt.materials fold（#879 / #858：对话 instruction、空请求、resume
- * message 保持调用者原文；起居录作独立附件面，不新造 RoleTurnRequest.materials，
- * 不拼进 user-dialogue continuation）。
- *
- * #858: deliver returns typed FrozenAttachment[]; load currently re-derives the
- * freeze leaf under runDirectory because agent-start only has HostContext.runDirectory.
- * Consuming the typed frozenPath across that process boundary needs a design
- * revision of the existing envelope/persistence seam — not a local replica of
- * freezeAttachments' `00-` naming, not a drift throw, not readdir guessing.
- */
-import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-import { projectTicketRecordsPathShape } from "../sitian-facade.ts";
-import { resolveTicketProvenanceVolume } from "../ticket-provenance.ts";
-import {
-  freezeAttachmentsIntoRun,
-  type FrozenAttachment,
-} from "./invocation.ts";
-
-/** Bound-ticket section heading (presentation only). */
-const CASE_DOSSIER_SECTION_HEADING = "## 本票起居录（系统随案提供）" as const;
-
-/** Unbound path-only heading — no 本票 claim when no typed ticket is on the run. */
-const UNBOUND_DOSSIER_PATH_HEADING = "## 起居录路径（系统随案提供）" as const;
-
-/** Stable freeze key under run/attachments/ for station-child 0081 delivery. */
-const CASE_DOSSIER_ATTACH_KEY = "case-dossier" as const;
-
-/** Leaf name of the frozen pointer section (content = purpose + paths). */
-const CASE_DOSSIER_ATTACH_FILE = "case-dossier-pointer.md" as const;
-
-/**
- * Neutral 起居录 path pointer for every public entry (ADR 0081 delivery seam).
- * Always tells the canonical path shape so the seat LLM can read the diary
- * itself (陛下 2026-09-15: 只需要告诉llm这个路径). When a typed ticket identity is
- * already on the run, also project the concrete resolved file. Never claims a
- * volume or「本票」exists when unbound; never extracts a ticket from instruction.
- * Under-book shape comes only from sitian writer joins — no local replica.
- */
-export async function projectCaseDossierPointerSection(input: {
-  readonly ticketNumber: number | undefined;
-  readonly projectRoot: string;
-  readonly home: string;
-}): Promise<string> {
-  if (input.ticketNumber === undefined) {
-    return [
-      UNBOUND_DOSSIER_PATH_HEADING,
-      "",
-      `记录卷宗：${projectTicketRecordsPathShape()}`,
-    ].join("\n");
-  }
-  const volume = resolveTicketProvenanceVolume(
-    input.ticketNumber,
-    input.projectRoot,
-    input.home,
-  );
-  return [
-    CASE_DOSSIER_SECTION_HEADING,
-    "",
-    `票号：#${input.ticketNumber}`,
-    `记录卷宗：${volume.recordFile}`,
-  ].join("\n");
-}
-
-/**
- * ADR 0081 delivery for every public entry (#879 / #858): freeze the pointer
- * section through the existing attachments seam. Role-runtime loads that freeze
- * via loadCaseDossierReadingMaterial onto readingMaterial; the envelope then
- * folds it into systemPrompt.materials. Caller / peer dialogue instruction stays
- * opaque; never RoleTurnRequest.materials, never user-dialogue continuation.
- * Always freezes the path pointer (canonical shape, or concrete file when a
- * typed ticket is already bound).
- */
-export async function deliverCaseDossierAsAttachment(input: {
-  readonly ticketNumber: number | undefined;
-  readonly projectRoot: string;
-  readonly home: string;
-  readonly runDirectory: string;
-}): Promise<readonly FrozenAttachment[]> {
-  const section = await projectCaseDossierPointerSection({
-    ticketNumber: input.ticketNumber,
-    projectRoot: input.projectRoot,
-    home: input.home,
-  });
-  // Stage in OS temp only — never leave a run-local .case-dossier-stage copy.
-  const stagingDir = await mkdtemp(join(tmpdir(), "ak-case-dossier-"));
-  try {
-    const stagingPath = join(stagingDir, CASE_DOSSIER_ATTACH_FILE);
-    await writeFile(stagingPath, `${section}\n`, "utf8");
-    return await freezeAttachmentsIntoRun(
-      [stagingPath],
-      input.runDirectory,
-      CASE_DOSSIER_ATTACH_KEY,
-    );
-  } finally {
-    await rm(stagingDir, { recursive: true, force: true });
-  }
-}
-
-/** Typed reading-material face for a frozen station-child 0081 attachment. */
-export type CaseDossierReadingMaterial = {
-  readonly kind: "case-dossier-pointer";
-  readonly frozenPath: string;
-  readonly section: string;
-};
-
-/**
- * Load a previously frozen case-dossier attachment as reading material
- * (existing agent-start / systemPrompt.materials fold — not dialogue prompt,
- * not RoleTurnRequest.materials). Undefined when the run has no such freeze.
- *
- * #858: this join re-derives freezeAttachments' leaf naming because the
- * agent-start handler only receives runDirectory. Replacing it requires
- * threading deliver's typed frozenPath across the existing envelope seam
- * (design revision) — do not copy freeze's `00-` algorithm here again.
- */
-export async function loadCaseDossierReadingMaterial(
-  runDirectory: string,
-): Promise<CaseDossierReadingMaterial | undefined> {
-  const frozenPath = join(
-    runDirectory,
-    "attachments",
-    CASE_DOSSIER_ATTACH_KEY,
-    `00-${CASE_DOSSIER_ATTACH_FILE}`,
-  );
-  let section: string;
-  try {
-    section = await readFile(frozenPath, "utf8");
-  } catch (error) {
-    if ((error as NodeJS.ErrnoException).code === "ENOENT") return undefined;
-    throw error;
-  }
-  if (section.trim() === "") return undefined;
-  return { kind: "case-dossier-pointer", frozenPath, section };
-}