@akagilnc/pi-workflow-roles 0.1.3452 → 0.1.3469

package/dist/ledger-session-read.js

@@ -1,241 +0,0 @@
-/**
- * Canonical ledger session JSONL read primitives (shared owner).
- * Consumers (ticket-trajectory, analyst, …) must import here — no second parse kernel.
- */
-import { readFile } from "node:fs/promises";
-/**
- * Loud JSONL failure that still retains rows parsed before the bad line.
- * Callers that only need the throw keep catching Error; owners that must
- * surface partial typed facts (e.g. first-frame timestamp) read prefixRows.
- */
-export class LedgerSessionJsonlError extends Error {
-    path;
-    line;
-    prefixRows;
-    constructor(message, init) {
-        super(message);
-        this.name = "LedgerSessionJsonlError";
-        this.path = init.path;
-        this.line = init.line;
-        this.prefixRows = init.prefixRows;
-    }
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/**
- * Read session JSONL with honest live-tail semantics:
- * a malformed line is tolerated only when it is an unfinished final
- * fragment at EOF (no record terminator after it). Any malformed line
- * completed by a line terminator must fail loudly with file and 1-based
- * line context — even when no non-empty record follows — never silently
- * under-count.
- *
- * Loud failures throw LedgerSessionJsonlError carrying prefixRows so the
- * single parse kernel can still expose facts obtained before the bad line.
- */
-export async function readLedgerSessionJsonl(path) {
-    const text = await readFile(path, "utf8");
-    // split keeps a trailing empty segment iff text ends with "\n", so
-    // index < lines.length - 1 means this segment was terminated.
-    const lines = text.split("\n");
-    const rows = [];
-    for (let index = 0; index < lines.length; index += 1) {
-        const line = lines[index];
-        if (!line.trim())
-            continue;
-        let row;
-        try {
-            row = JSON.parse(line);
-        }
-        catch (error) {
-            if (!(error instanceof SyntaxError))
-                throw error;
-            const completedByTerminator = index < lines.length - 1;
-            if (completedByTerminator) {
-                throw new LedgerSessionJsonlError(`malformed JSONL record in ${path} at line ${index + 1}: ${error.message}`, { path, line: index + 1, prefixRows: rows });
-            }
-            // unfinished fragment at EOF — keep prior complete rows
-            break;
-        }
-        // Syntactically complete line: must be a session object. Silent omission
-        // would under-count ledger evidence (failure honesty).
-        if (!isRecord(row)) {
-            const kind = row === null ? "null" : Array.isArray(row) ? "array" : typeof row;
-            throw new LedgerSessionJsonlError(`complete non-object JSONL record in ${path} at line ${index + 1}: expected object, got ${kind}`, { path, line: index + 1, prefixRows: rows });
-        }
-        rows.push(row);
-    }
-    return rows;
-}
-/** First and last record timestamps in encounter order. */
-export function extractSessionTimestampSpan(rows) {
-    let startedAt;
-    let endedAt;
-    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 (same faces ticket-trajectory already reads — single parse kernel):
- * - `model_change.modelId`
- * - assistant `message.model`
- * Blank / non-string values are skipped. Does not invent a default model.
- */
-export function extractSessionModelSequence(rows) {
-    const seen = new Set();
-    const ordered = [];
-    const push = (raw) => {
-        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) {
-    const match = /^[^\r\n]*/.exec(command);
-    return match?.[0] ?? "";
-}
-/**
- * Pair toolCall frames → toolResult frames by toolCallId.
- * Throws when a tool-bearing frame is structurally unreadable for association
- * (toolCall missing string id, toolResult missing string toolCallId).
- * Unpaired open calls remain without endedAt — that is incomplete, not unreadable.
- */
-export function extractSessionToolIntervals(rows) {
-    const order = [];
-    const openById = new Map();
-    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) {
-                    throw new Error("toolCall frame missing string id");
-                }
-                if (typeof part.name !== "string" || part.name.length === 0) {
-                    throw new Error(`toolCall ${part.id} missing string name`);
-                }
-                if (callTimestamp === undefined || callTimestamp.length === 0) {
-                    throw new Error(`toolCall ${part.id} missing timestamp`);
-                }
-                if (openById.has(part.id)) {
-                    throw new Error(`duplicate toolCall id ${part.id}`);
-                }
-                const args = isRecord(part.arguments) ? part.arguments : undefined;
-                // Ticket surface: only bash first-line summary is authorized here.
-                const command = part.name === "bash" &&
-                    args !== undefined &&
-                    typeof args.command === "string"
-                    ? bashCommandFirstLine(args.command)
-                    : undefined;
-                const interval = {
-                    toolCallId: part.id,
-                    toolName: part.name,
-                    startedAt: callTimestamp,
-                    ...(command !== undefined ? { command } : {}),
-                };
-                order.push(interval);
-                openById.set(part.id, interval);
-            }
-        }
-        if (message?.role === "toolResult") {
-            if (typeof message.toolCallId !== "string" || message.toolCallId.length === 0) {
-                throw new Error("toolResult frame missing string toolCallId");
-            }
-            const resultTimestamp = typeof message.timestamp === "string" && message.timestamp
-                ? message.timestamp
-                : rowTimestamp;
-            if (resultTimestamp === undefined || resultTimestamp.length === 0) {
-                throw new Error(`toolResult ${message.toolCallId} missing timestamp`);
-            }
-            const open = openById.get(message.toolCallId);
-            if (open === undefined) {
-                // Result without a prior call is still associable as a closed interval
-                // once a name is known; keep structural readability without inventing a call.
-                const toolName = typeof message.toolName === "string" && message.toolName.length > 0
-                    ? message.toolName
-                    : "unknown";
-                order.push({
-                    toolCallId: message.toolCallId,
-                    toolName,
-                    startedAt: resultTimestamp,
-                    endedAt: resultTimestamp,
-                });
-                continue;
-            }
-            if (open.endedAt !== undefined) {
-                throw new Error(`duplicate toolResult for toolCallId ${message.toolCallId}`);
-            }
-            open.endedAt = resultTimestamp;
-        }
-    }
-    return order.map((interval) => {
-        const base = {
-            toolCallId: interval.toolCallId,
-            toolName: interval.toolName,
-            startedAt: interval.startedAt,
-            ...(interval.command !== undefined ? { command: interval.command } : {}),
-        };
-        return interval.endedAt === undefined
-            ? base
-            : { ...base, endedAt: interval.endedAt };
-    });
-}
-export function intervalRowsAroundAnchor(rows, anchorIndex, isBindingRow) {
-    let start = 0;
-    for (let i = anchorIndex; i >= 0; i -= 1) {
-        if (isBindingRow(rows[i])) {
-            start = i;
-            break;
-        }
-    }
-    let end = rows.length;
-    for (let i = Math.max(anchorIndex, start) + 1; i < rows.length; i += 1) {
-        if (isBindingRow(rows[i])) {
-            end = i;
-            break;
-        }
-    }
-    return { rows: rows.slice(start, end), closed: end < rows.length };
-}
-/**
- * Interval owned by the first binding row that satisfies `matches`.
- * `undefined` when the volume carries no matching binding — callers must not
- * silently treat the whole continuous volume as that owner.
- */
-export function intervalRowsForMatchingBinding(rows, isBindingRow, matches) {
-    for (let i = 0; i < rows.length; i += 1) {
-        const row = rows[i];
-        if (!isBindingRow(row) || !matches(row))
-            continue;
-        return intervalRowsAroundAnchor(rows, i, isBindingRow);
-    }
-    return undefined;
-}

package/dist/ticket-seat-memory.js

@@ -1,244 +0,0 @@
-import { existsSync } from "node:fs";
-import { readFile, writeFile } from "node:fs/promises";
-import { join } from "node:path";
-import { pathToFileURL } from "node:url";
-import { homeFromRunDirectory } from "./activation-ledger-topology.js";
-import { subjectKeyedRecordDirectory } from "./archivist-record-topology.js";
-import { resolvePackageRootDir } from "./session-opening-materials.js";
-const TICKET_SEAT_RUN_BINDING_ENTRY_TYPE = "ak_ticket_seat_run_binding";
-function isTicketSeatRunBindingRow(row) {
-  return row.type === "custom" && row.customType === TICKET_SEAT_RUN_BINDING_ENTRY_TYPE;
-}
-function ticketSeatRunBindingRunId(row) {
-  if (!isTicketSeatRunBindingRow(row)) return void 0;
-  if (row.data === null || typeof row.data !== "object" || Array.isArray(row.data)) {
-    return void 0;
-  }
-  const runId = row.data.runId;
-  return typeof runId === "string" && runId.length > 0 ? runId : void 0;
-}
-async function loadCreateRecordSessionOpen() {
-  const packageRoot = resolvePackageRootDir(import.meta.url);
-  const built = join(packageRoot, "dist/archivist-record-entry.js");
-  const source = join(packageRoot, "src/archivist-record-entry.ts");
-  const target = existsSync(built) ? built : source;
-  const mod = await import(pathToFileURL(target).href);
-  return mod.createRecordSessionOpen;
-}
-const TICKET_SEAT_MEMORY_KIND = "auditor-roles";
-const TICKET_SEAT_MEMORY_SEATS = ["inspector", "notary", "auditor"];
-function isTicketSeatMemorySeat(value) {
-  return TICKET_SEAT_MEMORY_SEATS.includes(value);
-}
-function isTicketSeatMemoryBound(input) {
-  return isTicketSeatMemorySeat(input.role) && typeof input.ticketNumber === "number" && Number.isSafeInteger(input.ticketNumber) && input.ticketNumber >= 1;
-}
-function isEnoent(error) {
-  return error instanceof Error && "code" in error && error.code === "ENOENT";
-}
-function ticketSeatMemorySubject(ticketNumber, seat) {
-  if (!Number.isSafeInteger(ticketNumber) || ticketNumber < 1) {
-    throw new Error(
-      `ticket-seat memory subject requires a positive ticket number, got ${String(ticketNumber)}`
-    );
-  }
-  return `${ticketNumber}:${seat}`;
-}
-function ticketSeatMemorySessionDirectory(input) {
-  return subjectKeyedRecordDirectory({
-    cwd: input.cwd,
-    kind: TICKET_SEAT_MEMORY_KIND,
-    subject: ticketSeatMemorySubject(input.ticketNumber, input.seat),
-    ...input.parentSessionFile === void 0 ? {} : { parentSessionFile: input.parentSessionFile },
-    ...input.home === void 0 ? {} : { home: input.home }
-  });
-}
-async function readRunAdmittedPageFacts(runDirectory) {
-  try {
-    const raw = JSON.parse(
-      await readFile(join(runDirectory, "admitted-request.json"), "utf8")
-    );
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-      return {};
-    }
-    const record = raw;
-    const ticketNumber = record.ticketNumber;
-    const projectRoot = record.projectRoot;
-    return {
-      ...typeof ticketNumber === "number" && Number.isSafeInteger(ticketNumber) && ticketNumber >= 1 ? { ticketNumber } : {},
-      ...typeof projectRoot === "string" ? { projectRoot } : {}
-    };
-  } catch (error) {
-    if (isEnoent(error)) return {};
-    throw error;
-  }
-}
-async function readInvocationTicketNumber(runDirectory) {
-  try {
-    const raw = JSON.parse(
-      await readFile(join(runDirectory, "invocation.json"), "utf8")
-    );
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
-      return void 0;
-    }
-    const ticketNumber = raw.ticketNumber;
-    if (typeof ticketNumber === "number" && Number.isSafeInteger(ticketNumber) && ticketNumber >= 1) {
-      return ticketNumber;
-    }
-  } catch (error) {
-    if (isEnoent(error)) return void 0;
-    throw error;
-  }
-  return void 0;
-}
-async function readRunTicketNumber(runDirectory) {
-  const admitted = await readRunAdmittedPageFacts(runDirectory);
-  if (admitted.ticketNumber !== void 0) return admitted.ticketNumber;
-  return readInvocationTicketNumber(runDirectory);
-}
-async function resolveTicketSeatMemoryNestDirectories(input) {
-  if (input.seats.length === 0) return [];
-  const admitted = await readRunAdmittedPageFacts(input.runDirectory);
-  const ticketNumber = admitted.ticketNumber ?? await readInvocationTicketNumber(input.runDirectory);
-  if (ticketNumber === void 0) return [];
-  let home;
-  try {
-    home = homeFromRunDirectory(input.runDirectory);
-  } catch {
-    return [];
-  }
-  const projectRoot = admitted.projectRoot;
-  if (projectRoot === void 0) return [];
-  return input.seats.map(
-    (seat) => ticketSeatMemorySessionDirectory({
-      ticketNumber,
-      seat,
-      cwd: projectRoot,
-      home
-    })
-  );
-}
-async function openTicketSeatMemoryCoordinates(input) {
-  const createRecordSessionOpen = await loadCreateRecordSessionOpen();
-  const opened = createRecordSessionOpen({
-    cwd: input.cwd,
-    kind: TICKET_SEAT_MEMORY_KIND,
-    subject: ticketSeatMemorySubject(input.ticketNumber, input.seat),
-    parent: {
-      getSessionFile: () => input.ledgerAnchorSessionFile
-    }
-  });
-  if (input.runId !== void 0) {
-    const data = { version: 1, runId: input.runId };
-    opened.session.appendCustomEntry(TICKET_SEAT_RUN_BINDING_ENTRY_TYPE, data);
-  }
-  const sessionFile = opened.session.getSessionFile();
-  const sessionDirectory = opened.session.getSessionDir();
-  if (typeof sessionFile !== "string" || sessionFile.length === 0) {
-    throw new Error(
-      `ticket-seat memory principal missing session file for ticket #${input.ticketNumber} seat ${input.seat}`
-    );
-  }
-  if (typeof sessionDirectory !== "string" || sessionDirectory.length === 0) {
-    throw new Error(
-      `ticket-seat memory principal missing session directory for ticket #${input.ticketNumber} seat ${input.seat}`
-    );
-  }
-  return { sessionDirectory, sessionFile, resumed: opened.resumed };
-}
-async function rebindAdmittedToTicketSeatMemory(input) {
-  const ticketNumber = input.admitted.ticketNumber;
-  if (ticketNumber === void 0) return void 0;
-  const anchor = input.principalAuthority.decode(input.admitted.principal);
-  const opened = await openTicketSeatMemoryCoordinates({
-    ticketNumber,
-    seat: input.seat,
-    cwd: input.admitted.projectRoot,
-    ledgerAnchorSessionFile: anchor.sessionFile,
-    // Analyst attributes frame/model/tool to this binding interval only (#636 D).
-    runId: input.admitted.runId
-  });
-  const coordinates = {
-    sessionDirectory: opened.sessionDirectory,
-    sessionFile: opened.sessionFile
-  };
-  const principal = input.principalAuthority.seal(coordinates);
-  input.principalAuthority.decode(principal);
-  input.admitted.principal = principal;
-  for (const page of ["admitted-request.json", "invocation.json"]) {
-    const path = join(input.admitted.runDirectory, page);
-    try {
-      const raw = JSON.parse(await readFile(path, "utf8"));
-      if (raw === null || typeof raw !== "object" || Array.isArray(raw)) continue;
-      const next = {
-        ...raw,
-        sessionDirectory: coordinates.sessionDirectory,
-        sessionFile: coordinates.sessionFile
-      };
-      await writeFile(path, `${JSON.stringify(next, null, 2)}
-`, "utf8");
-    } catch (error) {
-      if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-        continue;
-      }
-      throw error;
-    }
-  }
-  return { coordinates, resumed: opened.resumed };
-}
-const TICKET_SEAT_LAST_HOST_FILE = "last-host.json";
-async function readTicketSeatMemoryLastHost(sessionDirectory) {
-  try {
-    const raw = JSON.parse(
-      await readFile(join(sessionDirectory, TICKET_SEAT_LAST_HOST_FILE), "utf8")
-    );
-    if (raw === null || typeof raw !== "object" || Array.isArray(raw) || typeof raw.host !== "string" || raw.host.length === 0) {
-      throw new Error(
-        `ticket-seat memory last-host page is damaged under ${sessionDirectory}`
-      );
-    }
-    const host = raw.host;
-    const runDirectory = raw.runDirectory;
-    return {
-      host,
-      ...typeof runDirectory === "string" && runDirectory.length > 0 ? { runDirectory } : {}
-    };
-  } catch (error) {
-    if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-      return void 0;
-    }
-    throw error;
-  }
-}
-async function writeTicketSeatMemoryLastHost(sessionDirectory, host, runDirectory) {
-  if (host.trim() === "") {
-    throw new Error("ticket-seat memory last-host requires a non-empty host");
-  }
-  const body = {
-    host,
-    ...runDirectory !== void 0 && runDirectory.length > 0 ? { runDirectory } : {}
-  };
-  await writeFile(
-    join(sessionDirectory, TICKET_SEAT_LAST_HOST_FILE),
-    `${JSON.stringify(body, null, 2)}
-`,
-    "utf8"
-  );
-}
-export {
-  TICKET_SEAT_MEMORY_KIND,
-  TICKET_SEAT_MEMORY_SEATS,
-  TICKET_SEAT_RUN_BINDING_ENTRY_TYPE,
-  isTicketSeatMemoryBound,
-  isTicketSeatMemorySeat,
-  isTicketSeatRunBindingRow,
-  openTicketSeatMemoryCoordinates,
-  readRunTicketNumber,
-  readTicketSeatMemoryLastHost,
-  rebindAdmittedToTicketSeatMemory,
-  resolveTicketSeatMemoryNestDirectories,
-  ticketSeatMemorySessionDirectory,
-  ticketSeatMemorySubject,
-  ticketSeatRunBindingRunId,
-  writeTicketSeatMemoryLastHost
-};