@akagilnc/pi-workflow-roles 0.1.5216 → 0.1.5241

package/src/host-transition-prior-native.ts

@@ -1,80 +0,0 @@
-/**
- * Single authority for #617 DK-4 cross-host prior-native projection.
- * Classifies the prior volume into the two record families that exist
- * (Pi native session file / sitian run records), never by host name.
- */
-import { access, readdir } from "node:fs/promises";
-import { dirname, join } from "node:path";
-
-import type { RoleTurnHostTransition } from "./host-contracts.ts";
-
-function isEnoent(error: unknown): boolean {
-  return typeof error === "object" && error !== null && (error as NodeJS.ErrnoException).code === "ENOENT";
-}
-
-/** Present Pi native session path, or empty when ENOENT. */
-async function listPiNativeRecordPaths(sessionFile: string): Promise<string[]> {
-  try {
-    await access(sessionFile);
-    return [sessionFile];
-  } catch (error) {
-    if (isEnoent(error)) return [];
-    throw error;
-  }
-}
-
-/**
- * Present sitian records.jsonl paths under sessionParent topology (#717).
- * resolveSitianRecordPathInLedger writes dirname(sessionParent)/<category>/records.jsonl
- * when sessionParent is inside ledger home — never session.jsonl itself.
- */
-async function listSitianRecordPaths(sessionParent: string): Promise<string[]> {
-  const sessionRoot = dirname(sessionParent);
-  let entries;
-  try {
-    entries = await readdir(sessionRoot, { withFileTypes: true });
-  } catch (error) {
-    if (isEnoent(error)) return [];
-    throw error;
-  }
-  const recordPaths: string[] = [];
-  for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-    const recordFile = join(sessionRoot, entry.name, "records.jsonl");
-    try {
-      await access(recordFile);
-      recordPaths.push(recordFile);
-    } catch (error) {
-      if (!isEnoent(error)) throw error;
-    }
-  }
-  recordPaths.sort();
-  return recordPaths;
-}
-
-/**
- * Project one hostTransition only for a real host switch. Empty native volume
- * still yields a typed switch (empty path list).
- *
- * Pi wrote its own session.jsonl; every other host's run volume is the sitian
- * record set on the live run (ADR 0077 全宿主 session 卷宗统一直写, #717) — the CLI's
- * own journals stay in the operator home and are never copied here.
- */
-export async function projectHostTransitionPriorNative(input: {
-  readonly previousHost: string;
-  readonly liveHost: string;
-  readonly piSessionFile: string;
-}): Promise<RoleTurnHostTransition | undefined> {
-  if (input.previousHost === input.liveHost) return undefined;
-  if (input.previousHost === "pi") {
-    return {
-      priorNativeKind: "pi-native",
-      priorNativePaths: await listPiNativeRecordPaths(input.piSessionFile),
-    };
-  }
-  // Sitian path handoff only — do not read bytes.
-  return {
-    priorNativeKind: "sitian",
-    priorNativePaths: await listSitianRecordPaths(input.piSessionFile),
-  };
-}

package/src/pi/pi-normalization.ts

@@ -1,291 +0,0 @@
-/**
- * Pi adapter session normalization translation point (#520 r8 / #513).
- * Normalizes Pi native frames at attempt settlement to minimal canonical records.
- * Promotes and owns session parsing primitives previously in ledger-session-read.ts.
- */
-import { readFile } from "node:fs/promises";
-import { basename } from "node:path";
-
-import {
-  sitianReport,
-  type RecordPointer,
-  type SitianSubject,
-  type SitianUsage,
-} from "../sitian-facade.ts";
-
-export type SessionRow = Record<string, unknown>;
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-
-/** First and last record timestamps in encounter order. */
-export function extractSessionTimestampSpan(
-  rows: readonly SessionRow[],
-): { startedAt?: string; endedAt?: string } {
-  let startedAt: string | undefined;
-  let endedAt: string | undefined;
-  for (const row of rows) {
-    if (typeof row.timestamp !== "string" || !row.timestamp) continue;
-    if (startedAt === undefined) startedAt = row.timestamp;
-    endedAt = row.timestamp;
-  }
-  return {
-    ...(startedAt !== undefined ? { startedAt } : {}),
-    ...(endedAt !== undefined ? { endedAt } : {}),
-  };
-}
-
-/**
- * Ordered-unique model ids from session frames (first-seen order).
- * Sources:
- * - `model_change.modelId`
- * - assistant `message.model`
- */
-export function extractSessionModelSequence(
-  rows: readonly SessionRow[],
-): string[] {
-  const seen = new Set<string>();
-  const ordered: string[] = [];
-  const push = (raw: string): void => {
-    const model = raw.trim();
-    if (model === "" || seen.has(model)) return;
-    seen.add(model);
-    ordered.push(model);
-  };
-  for (const row of rows) {
-    if (row.type === "model_change" && typeof row.modelId === "string") {
-      push(row.modelId);
-    }
-    const message = isRecord(row.message) ? row.message : undefined;
-    if (message?.role === "assistant" && typeof message.model === "string") {
-      push(message.model);
-    }
-  }
-  return ordered;
-}
-
-/** First line of a bash `command` argument (sole owner of this summary). */
-export function bashCommandFirstLine(command: string): string {
-  const match = /^[^\r\n]*/.exec(command);
-  return match?.[0] ?? "";
-}
-
-export type SessionToolInterval = {
-  readonly toolCallId: string;
-  readonly toolName: string;
-  readonly startedAt: string;
-  readonly endedAt?: string | undefined;
-  readonly command?: string | undefined;
-  readonly isError?: boolean | undefined;
-};
-
-/**
- * Pair toolCall frames → toolResult frames by toolCallId.
- */
-export function extractSessionToolIntervals(
-  rows: readonly SessionRow[],
-): SessionToolInterval[] {
-  type Open = {
-    toolCallId: string;
-    toolName: string;
-    startedAt: string;
-    endedAt?: string | undefined;
-    command?: string | undefined;
-    isError?: boolean | undefined;
-  };
-  const order: Open[] = [];
-  const openById = new Map<string, Open>();
-
-  for (const row of rows) {
-    const rowTimestamp = typeof row.timestamp === "string" ? row.timestamp : undefined;
-    const message = isRecord(row.message) ? row.message : undefined;
-
-    if (message?.role === "assistant" && Array.isArray(message.content)) {
-      const callTimestamp =
-        typeof message.timestamp === "string" && message.timestamp
-          ? message.timestamp
-          : rowTimestamp;
-      for (const part of message.content) {
-        if (!isRecord(part) || part.type !== "toolCall") continue;
-        if (typeof part.id !== "string" || part.id.length === 0) continue;
-        if (typeof part.name !== "string" || part.name.length === 0) continue;
-        const timestamp = callTimestamp ?? new Date().toISOString();
-        if (openById.has(part.id)) continue;
-
-        const args = isRecord(part.arguments) ? part.arguments : undefined;
-        const command =
-          part.name === "bash" &&
-          args !== undefined &&
-          typeof args.command === "string"
-            ? bashCommandFirstLine(args.command)
-            : undefined;
-
-        const interval: Open = {
-          toolCallId: part.id,
-          toolName: part.name,
-          startedAt: timestamp,
-          ...(command !== undefined ? { command } : {}),
-        };
-        order.push(interval);
-        openById.set(part.id, interval);
-      }
-    }
-
-    if (message?.role === "toolResult") {
-      if (typeof message.toolCallId !== "string" || message.toolCallId.length === 0) {
-        continue;
-      }
-      const resultTimestamp =
-        typeof message.timestamp === "string" && message.timestamp
-          ? message.timestamp
-          : rowTimestamp ?? new Date().toISOString();
-
-      const open = openById.get(message.toolCallId);
-      if (open === undefined) {
-        const toolName =
-          typeof message.toolName === "string" && message.toolName.length > 0
-            ? message.toolName
-            : "unknown";
-        order.push({
-          toolCallId: message.toolCallId,
-          toolName,
-          startedAt: resultTimestamp,
-          endedAt: resultTimestamp,
-          ...(typeof message.isError === "boolean" ? { isError: message.isError } : {}),
-        });
-        continue;
-      }
-      open.endedAt = resultTimestamp;
-      if (typeof message.isError === "boolean") {
-        open.isError = message.isError;
-      }
-    }
-  }
-
-  return order.map((interval) => ({
-    toolCallId: interval.toolCallId,
-    toolName: interval.toolName,
-    startedAt: interval.startedAt,
-    ...(interval.endedAt !== undefined ? { endedAt: interval.endedAt } : {}),
-    ...(interval.command !== undefined ? { command: interval.command } : {}),
-    ...(interval.isError !== undefined ? { isError: interval.isError } : {}),
-  }));
-}
-
-export type NormalizePiSessionAttemptOptions = {
-  readonly sessionFile: string;
-  readonly cwd?: string | undefined;
-  readonly subject?: SitianSubject | undefined;
-  readonly home?: string | undefined;
-};
-
-/**
- * Normalizes one Pi session attempt into canonical Sitian records.
- * Carries raw pointers back to original frames without copying full transcripts (#513).
- * Deterministically derives canonical identities (${sessionId}:${frameId}) for idempotent persistence.
- */
-export async function normalizePiSessionAttempt(
-  options: NormalizePiSessionAttemptOptions,
-): Promise<readonly RecordPointer[]> {
-  const text = await readFile(options.sessionFile, "utf8");
-  const lines = text.split("\n");
-  const pointers: RecordPointer[] = [];
-
-  const validRows: SessionRow[] = [];
-  let sessionId = basename(options.sessionFile, ".jsonl");
-  let aggregatedUsage: SitianUsage | undefined;
-
-  for (let index = 0; index < lines.length; index += 1) {
-    const line = lines[index]!;
-    if (!line.trim()) continue;
-
-    try {
-      const parsed = JSON.parse(line);
-      if (!isRecord(parsed)) {
-        throw new Error("non-object session frame");
-      }
-      validRows.push(parsed);
-
-      if (parsed.type === "session" && typeof parsed.id === "string" && parsed.id.length > 0) {
-        sessionId = parsed.id;
-      }
-
-      const message = isRecord(parsed.message) ? parsed.message : undefined;
-      if (message?.role === "assistant" && isRecord(message.usage)) {
-        const u = message.usage;
-        aggregatedUsage = {
-          promptTokens: (aggregatedUsage?.promptTokens ?? 0) + (typeof u.promptTokens === "number" ? u.promptTokens : 0),
-          completionTokens: (aggregatedUsage?.completionTokens ?? 0) + (typeof u.completionTokens === "number" ? u.completionTokens : 0),
-          totalTokens: (aggregatedUsage?.totalTokens ?? 0) + (typeof u.totalTokens === "number" ? u.totalTokens : 0),
-        };
-      }
-    } catch (error) {
-      // Normalization failure: record typed failure and keep traversing
-      const ptr = sitianReport({
-        level: "event",
-        kind: "normalization-failure",
-        cwd: options.cwd,
-        subject: options.subject,
-        identity: `${sessionId}:bad-line-${index + 1}`,
-        raw: { sessionFile: options.sessionFile, entryId: index + 1 },
-        payload: {
-          line: index + 1,
-          rawText: line,
-          error: error instanceof Error ? error.message : String(error),
-        },
-        source: "pi-normalization",
-        sessionParent: options.sessionFile,
-        ...(options.home !== undefined ? { home: options.home } : {}),
-      });
-      pointers.push(ptr);
-    }
-  }
-
-  const models = extractSessionModelSequence(validRows);
-  const span = extractSessionTimestampSpan(validRows);
-  const toolIntervals = extractSessionToolIntervals(validRows);
-
-  // Normalize paired tool intervals into canonical tool-call event records
-  for (const interval of toolIntervals) {
-    const ptr = sitianReport({
-      level: "event",
-      kind: "tool-call",
-      cwd: options.cwd,
-      subject: options.subject,
-      identity: `${sessionId}:${interval.toolCallId}`,
-      raw: { sessionFile: options.sessionFile, entryId: interval.toolCallId },
-      payload: interval,
-      timestamp: interval.startedAt,
-      source: "pi-normalization",
-      sessionParent: options.sessionFile,
-      ...(options.home !== undefined ? { home: options.home } : {}),
-    });
-    pointers.push(ptr);
-  }
-
-  // Normalize attempt summary into run-summary record
-  const summaryTimestamp = span.endedAt ?? span.startedAt ?? new Date().toISOString();
-  const summaryPtr = sitianReport({
-    level: "run-summary",
-    kind: "attempt-summary",
-    cwd: options.cwd,
-    subject: options.subject,
-    identity: `${sessionId}:summary`,
-    raw: { sessionFile: options.sessionFile, entryId: "summary" },
-    payload: {
-      startedAt: span.startedAt,
-      endedAt: span.endedAt,
-      models,
-      toolIntervals,
-    },
-    ...(aggregatedUsage !== undefined ? { usage: aggregatedUsage } : {}),
-    timestamp: summaryTimestamp,
-    source: "pi-normalization",
-    sessionParent: options.sessionFile,
-    ...(options.home !== undefined ? { home: options.home } : {}),
-  });
-  pointers.push(summaryPtr);
-
-  return pointers;
-}

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