@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/jsonl-tail.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Tails an append-only JSONL log, calling `onLine` for each complete line as it
+ * is written. Reads only the bytes appended since the last {@link pull},
+ * buffering a torn trailing line until its newline arrives. A file that shrinks
+ * (a fresh agent truncated the log) resets to the start so the new content is
+ * picked up. The generic base behind the daemon's event tail and the agent's
+ * control tail (#344) — one tailer, two directions.
+ */
+export declare class JsonlTailer<T> {
+    private path;
+    private readonly onLine;
+    /** Told when the log is found rewritten, before its lines are read again from the top. */
+    private readonly onReset?;
+    private offset;
+    private partial;
+    private lastMtimeMs;
+    private adoptMtime;
+    constructor(path: string, onLine: (value: T) => void, 
+    /** Told when the log is found rewritten, before its lines are read again from the top. */
+    onReset?: (() => void) | undefined);
+    /**
+     * Point the tailer at the log's new home, keeping the read offset. For a log that is
+     * *relocated with its content intact* — a run's diary is copied verbatim onto the data branch
+     * when the run ends and its checkout is reclaimed — the bytes already consumed are a prefix of
+     * the new file, so the next {@link pull} delivers exactly the lines the move would otherwise
+     * have swallowed, without replaying what was already delivered.
+     *
+     * The first pull after a retarget adopts the new home's mtime instead of running the
+     * same-length-rewrite check: the copy is younger than the original by construction, and a
+     * fully-consumed log would otherwise read as "rewritten to the same length" and replay
+     * every line it already delivered.
+     */
+    retarget(path: string): void;
+    /** Read and dispatch any lines appended since the previous call. */
+    pull(): Promise<void>;
+}
+/** Options for {@link followFile}. */
+export interface FollowFileOptions {
+    /** How often the backstop poll runs. */
+    pollMs: number;
+    /**
+     * Let the process exit with the tail still running (steering must never hold it open).
+     * Covers both handles this opens — the poll timer *and* the `fs.watch` — since either one
+     * on its own is enough to keep the event loop alive.
+     */
+    unref?: boolean;
+}
+/**
+ * Drive a {@link JsonlTailer} as the file grows: an `fs.watch` on `dir` for latency, plus a
+ * poll backstop because `fs.watch` is unreliable across platforms. Pulls are serialized (a
+ * pull already in flight swallows the next trigger) and stop for good once the returned
+ * function is called. Shared by the agent's control tail and the dashboard's event tail, which
+ * hand-rolled this separately and drifted apart.
+ *
+ * Nothing here may throw at the process: a failed pull and a watcher error are both survivable,
+ * and the poll alone is a complete tail (#996).
+ */
+export declare function followFile(dir: string, pull: () => Promise<void>, opts: FollowFileOptions): () => void;
+//# sourceMappingURL=jsonl-tail.d.ts.map

package/dist/jsonl-tail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-tail.d.ts","sourceRoot":"","sources":["../src/jsonl-tail.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qBAAa,WAAW,CAAC,CAAC;IAOtB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,0FAA0F;IAC1F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAT3B,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,UAAU,CAAQ;IAE1B,YACU,IAAI,EAAE,MAAM,EACH,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI;IAC3C,0FAA0F;IACzE,OAAO,CAAC,GAAE,MAAM,IAAI,aAAA,EACnC;IAEJ;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG3B;IAED,oEAAoE;IAC9D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAwC1B;CACF;AAED,sCAAsC;AACtC,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,IAAI,CA+CtG"}

package/dist/jsonl-tail.js

@@ -0,0 +1,152 @@
+import { watch } from 'node:fs';
+import { open } from 'node:fs/promises';
+/**
+ * Tails an append-only JSONL log, calling `onLine` for each complete line as it
+ * is written. Reads only the bytes appended since the last {@link pull},
+ * buffering a torn trailing line until its newline arrives. A file that shrinks
+ * (a fresh agent truncated the log) resets to the start so the new content is
+ * picked up. The generic base behind the daemon's event tail and the agent's
+ * control tail (#344) — one tailer, two directions.
+ */
+export class JsonlTailer {
+    path;
+    onLine;
+    onReset;
+    offset = 0;
+    partial = '';
+    lastMtimeMs = 0;
+    adoptMtime = false;
+    constructor(path, onLine, 
+    /** Told when the log is found rewritten, before its lines are read again from the top. */
+    onReset) {
+        this.path = path;
+        this.onLine = onLine;
+        this.onReset = onReset;
+    }
+    /**
+     * Point the tailer at the log's new home, keeping the read offset. For a log that is
+     * *relocated with its content intact* — a run's diary is copied verbatim onto the data branch
+     * when the run ends and its checkout is reclaimed — the bytes already consumed are a prefix of
+     * the new file, so the next {@link pull} delivers exactly the lines the move would otherwise
+     * have swallowed, without replaying what was already delivered.
+     *
+     * The first pull after a retarget adopts the new home's mtime instead of running the
+     * same-length-rewrite check: the copy is younger than the original by construction, and a
+     * fully-consumed log would otherwise read as "rewritten to the same length" and replay
+     * every line it already delivered.
+     */
+    retarget(path) {
+        this.path = path;
+        this.adoptMtime = true;
+    }
+    /** Read and dispatch any lines appended since the previous call. */
+    async pull() {
+        let fd;
+        try {
+            fd = await open(this.path, 'r');
+        }
+        catch {
+            return; // not created yet (nothing has written)
+        }
+        try {
+            const { size, mtimeMs } = await fd.stat();
+            // A fresh agent truncates the log in place (same inode). Detect it two ways: the
+            // file shrank below what we consumed, or it was rewritten to the same length
+            // (size unchanged but mtime advanced). Either way, re-read from the top.
+            // Suspended for the first read after a retarget, whose newer mtime is the copy's, not a rewrite's.
+            const rewritten = !this.adoptMtime && size === this.offset && this.offset > 0 && mtimeMs > this.lastMtimeMs;
+            if (size < this.offset || rewritten) {
+                this.offset = 0;
+                this.partial = '';
+                this.onReset?.();
+            }
+            this.lastMtimeMs = mtimeMs;
+            this.adoptMtime = false;
+            if (size === this.offset)
+                return;
+            const buf = Buffer.alloc(size - this.offset);
+            await fd.read(buf, 0, buf.length, this.offset);
+            this.offset = size;
+            this.partial += buf.toString('utf8');
+            const lines = this.partial.split('\n');
+            this.partial = lines.pop() ?? ''; // trailing fragment with no newline yet
+            for (const line of lines) {
+                const trimmed = line.trim();
+                if (!trimmed)
+                    continue;
+                try {
+                    this.onLine(JSON.parse(trimmed));
+                }
+                catch {
+                    // a torn/half-written line — skip it; the log never rewrites history
+                }
+            }
+        }
+        finally {
+            await fd.close();
+        }
+    }
+}
+/**
+ * Drive a {@link JsonlTailer} as the file grows: an `fs.watch` on `dir` for latency, plus a
+ * poll backstop because `fs.watch` is unreliable across platforms. Pulls are serialized (a
+ * pull already in flight swallows the next trigger) and stop for good once the returned
+ * function is called. Shared by the agent's control tail and the dashboard's event tail, which
+ * hand-rolled this separately and drifted apart.
+ *
+ * Nothing here may throw at the process: a failed pull and a watcher error are both survivable,
+ * and the poll alone is a complete tail (#996).
+ */
+export function followFile(dir, pull, opts) {
+    let pulling = false;
+    let stopped = false;
+    const pump = async () => {
+        if (pulling || stopped)
+            return;
+        pulling = true;
+        try {
+            await pull();
+        }
+        catch {
+            // #996: every caller discards this promise, so a rejected read (EIO on a network mount,
+            // EISDIR, a log grown past kMaxLength) would be an unhandled rejection and kill the
+            // process. Swallowed rather than logged: the next tick retries, and a fault that persists
+            // would otherwise print once per poll forever.
+        }
+        finally {
+            pulling = false;
+        }
+    };
+    let watcher;
+    try {
+        watcher = watch(dir, () => void pump());
+        // #996: an 'error' with no listener throws out of the emitter, which is the same process
+        // death. The watcher is spent once it errors (node closes the handle first), so drop it and
+        // let the poll below carry the tail on its own.
+        watcher.on('error', () => {
+            watcher?.close();
+            watcher = undefined;
+        });
+        // Unref the watcher, not just the poll below: an `fs.watch` handle refs the event loop on
+        // its own, so unrefing only the timer left `unref: true` a half-measure that still pinned the
+        // process open. That is what wedged an agent whose config check failed before its watcher had an
+        // owner to close it — the CLI returned, and the process then sat there forever with the agent
+        // recorded as `running`.
+        if (opts.unref)
+            watcher?.unref();
+    }
+    catch {
+        // dir may not be watchable everywhere; the poll backstop still covers it
+    }
+    const poll = setInterval(() => void pump(), opts.pollMs);
+    if (opts.unref)
+        poll.unref();
+    void pump(); // seed with whatever is already written
+    return () => {
+        stopped = true;
+        clearInterval(poll);
+        watcher?.close();
+        watcher = undefined;
+    };
+}
+//# sourceMappingURL=jsonl-tail.js.map

package/dist/jsonl-tail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonl-tail.js","sourceRoot":"","sources":["../src/jsonl-tail.ts"],"names":[],"mappings":"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"}

package/dist/layout.d.ts

@@ -0,0 +1,41 @@
+import { type StoreFs } from './store/index.js';
+/**
+ * The layout gate (#1575): a build refuses to run in a repo whose recorded bookkeeping layout
+ * differs from its own.
+ *
+ * The failure this closes was caught live (#1574): the cloud environment installs the framework
+ * from npm, the last published build predated the `sessions/` → `agents/` rename, and the web
+ * run's bookkeeping landed under the old name — a wrong-layout commit that main's guard test
+ * rejects, hours after the session could have said it will not work. Same philosophy as the
+ * extension gate (#1519): a skewed build half-works, so it is refused outright with both sides
+ * named, no degraded mode.
+ *
+ * The repo's half is a tracked marker file whose content is *derived from the build's own layout
+ * constants*, so a rename changes the derivation by itself and the lockstep test fails the rename
+ * PR until the checked-in marker is regenerated — nothing to remember to bump. A repo without the
+ * marker is ungated, the way an absent `expectedExtensionVersion` leaves the bridge ungated:
+ * install writes it, so every newly activated repo is gated from the start.
+ */
+/** The marker's name under `.the-framework/`. Tracked, so every worktree and clone carries it. */
+export declare const LAYOUT_FILE = "LAYOUT";
+/** The marker path under `cwd`'s `.the-framework/`. */
+export declare function layoutMarkerPath(cwd: string): string;
+/**
+ * The layout this build writes, as one comparable string: every name a committed artifact's path
+ * hangs off. Pure data — a comment line would put message wording into the equality.
+ */
+export declare function layoutMarker(): string;
+/** The outcome of {@link checkLayout}. A failure is a value carrying the refusal, never a throw. */
+export type LayoutCheck = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Compare the repo's recorded layout against this build's. A missing marker passes (an unmarked
+ * repo is ungated); a present-but-different one refuses with both sides named and the fix for
+ * each direction — the stale-published-build case this exists for, and the older-repo case.
+ */
+export declare function checkLayout(cwd: string, fs?: StoreFs): Promise<LayoutCheck>;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuC,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAMpF;;;;;;;;;;;;;;;;GAgBG;AAEH,kGAAkG;AAClG,eAAO,MAAM,WAAW,WAAW,CAAA;AAEnC,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAWrC;AAED,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAErE;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAehG"}

package/dist/layout.js

@@ -0,0 +1,69 @@
+import { join } from 'node:path';
+import { THE_FRAMEWORK_DIR } from './framework-dir.js';
+import { EVENTS_FILE, META_FILE, nodeStoreFs } from './store/index.js';
+import { TICKETS_DIR } from '@gemstack/skill-tickets/names';
+import { QUEUE_FILE } from '@gemstack/skill-queue/names';
+import { RUNS_DIR } from '@gemstack/skill-logs/names';
+import { DATA_BRANCH } from '@gemstack/agent-data/names';
+/**
+ * The layout gate (#1575): a build refuses to run in a repo whose recorded bookkeeping layout
+ * differs from its own.
+ *
+ * The failure this closes was caught live (#1574): the cloud environment installs the framework
+ * from npm, the last published build predated the `sessions/` → `agents/` rename, and the web
+ * run's bookkeeping landed under the old name — a wrong-layout commit that main's guard test
+ * rejects, hours after the session could have said it will not work. Same philosophy as the
+ * extension gate (#1519): a skewed build half-works, so it is refused outright with both sides
+ * named, no degraded mode.
+ *
+ * The repo's half is a tracked marker file whose content is *derived from the build's own layout
+ * constants*, so a rename changes the derivation by itself and the lockstep test fails the rename
+ * PR until the checked-in marker is regenerated — nothing to remember to bump. A repo without the
+ * marker is ungated, the way an absent `expectedExtensionVersion` leaves the bridge ungated:
+ * install writes it, so every newly activated repo is gated from the start.
+ */
+/** The marker's name under `.the-framework/`. Tracked, so every worktree and clone carries it. */
+export const LAYOUT_FILE = 'LAYOUT';
+/** The marker path under `cwd`'s `.the-framework/`. */
+export function layoutMarkerPath(cwd) {
+    return join(cwd, THE_FRAMEWORK_DIR, LAYOUT_FILE);
+}
+/**
+ * The layout this build writes, as one comparable string: every name a committed artifact's path
+ * hangs off. Pure data — a comment line would put message wording into the equality.
+ */
+export function layoutMarker() {
+    return [
+        `framework-dir: ${THE_FRAMEWORK_DIR}`,
+        `data-branch: ${DATA_BRANCH}`,
+        `events-file: ${EVENTS_FILE}`,
+        `meta-file: ${META_FILE}`,
+        `tickets-dir: ${TICKETS_DIR}`,
+        `queue-file: ${QUEUE_FILE}`,
+        `runs-dir: ${RUNS_DIR}`,
+        '',
+    ].join('\n');
+}
+/**
+ * Compare the repo's recorded layout against this build's. A missing marker passes (an unmarked
+ * repo is ungated); a present-but-different one refuses with both sides named and the fix for
+ * each direction — the stale-published-build case this exists for, and the older-repo case.
+ */
+export async function checkLayout(cwd, fs = nodeStoreFs()) {
+    const path = layoutMarkerPath(cwd);
+    if (!(await fs.exists(path)))
+        return { ok: true };
+    const recorded = await fs.read(path);
+    if (recorded === layoutMarker())
+        return { ok: true };
+    return {
+        ok: false,
+        error: `this framework build's bookkeeping layout does not match what the repo records in ` +
+            `${THE_FRAMEWORK_DIR}/${LAYOUT_FILE}, so running it here would commit files under names ` +
+            `the repo does not use (#1575).\n\nthis build writes:\n${layoutMarker()}\nthe repo records:\n${recorded}\n` +
+            `A published build that predates a repo-side rename does this: update ` +
+            `framework to a build matching the repo, or — if this build is the newer ` +
+            `side — rewrite the marker with its layout and land that as the rename's own commit.`,
+    };
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AACpF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAExD;;;;;;;;;;;;;;;;GAgBG;AAEH,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAA;AAEnC,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,IAAI,CAAC,GAAG,EAAE,iBAAiB,EAAE,WAAW,CAAC,CAAA;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO;QACL,kBAAkB,iBAAiB,EAAE;QACrC,gBAAgB,WAAW,EAAE;QAC7B,gBAAgB,WAAW,EAAE;QAC7B,cAAc,SAAS,EAAE;QACzB,gBAAgB,WAAW,EAAE;QAC7B,eAAe,UAAU,EAAE;QAC3B,aAAa,QAAQ,EAAE;QACvB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC;AAKD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,EAAE,GAAY,WAAW,EAAE;IACxE,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;IAClC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACjD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpC,IAAI,QAAQ,KAAK,YAAY,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAA;IACpD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EACH,oFAAoF;YACpF,GAAG,iBAAiB,IAAI,WAAW,sDAAsD;YACzF,yDAAyD,YAAY,EAAE,wBAAwB,QAAQ,IAAI;YAC3G,uEAAuE;YACvE,0EAA0E;YAC1E,qFAAqF;KACxF,CAAA;AACH,CAAC"}

package/dist/logs.d.ts

@@ -0,0 +1,73 @@
+import { THE_FRAMEWORK_DIR } from './framework-dir.js';
+import { type StoreFs } from './store/index.js';
+/**
+ * The `.the-framework/LOGS.md` project log (#378): a human-readable markdown
+ * record of every loop, prompt, and build run in a project. Pure core over the
+ * same {@link StoreFs} seam as the run store; the run-lifecycle wiring and UI
+ * land in later issues (#379/#380).
+ */
+/** The directory, under the project root, that holds the log. Defined in its own node-free
+ * module (#874) so the browser-reachable preset registry can share it; re-exported here
+ * because this is where every existing import site expects to find it. */
+export { THE_FRAMEWORK_DIR };
+/** The markdown log file name. */
+export declare const LOGS_FILE = "LOGS.md";
+/**
+ * The `.the-framework/.gitignore` that keeps run state transient (#313): the dir
+ * holds both the committed DB (LOGS.md) and the transient run logs, so this
+ * ignores everything except LOGS.md and itself.
+ *
+ * An allow-list, so anything else meant to be committed needs its own negation —
+ * see `CONVERSATIONS_GITIGNORE` (#908), which install appends to this.
+ */
+export declare const LOGS_GITIGNORE = "# The Framework: the committed project DB; session state is transient.\n*\n!.gitignore\n!LOGS.md\n";
+/** One project-log entry: a loop, or a standalone prompt/build. */
+export interface LogEntry {
+    /** ISO timestamp. */
+    at: string;
+    kind: 'loop' | 'prompt' | 'build';
+    /** The run's intent/prompt. Escaped to one line on write (#897), so it may hold a whole prompt. */
+    title: string;
+    status: 'done' | 'stopped' | 'failed' | 'running';
+    /**
+     * The run's id (#898): the join key from this committed entry to the rest of the run, whose
+     * `runs/<id>.json` meta and `runs/<id>.jsonl` events are transient and stay out of git.
+     */
+    id?: string;
+    /** Claude Code session id. */
+    sessionId?: string;
+    /** e.g. `https://claude.ai/code/<id>` */
+    sessionLink?: string;
+    /** The name the agent gave the session (#326), also its `the-framework/<name>` branch. */
+    sessionName?: string;
+    /**
+     * The branch the run's work landed on (#799). Read from the checkout as the run settles,
+     * because it is not derivable later: a clean run loses its worktree, and the agent may have
+     * branched itself.
+     */
+    branch?: string;
+    /** For a loop: constituent prompt summaries. */
+    prompts?: string[];
+}
+/** The one-time first line of the file, written on the first append. */
+export declare const LOGS_HEADER = "# The Framework logs\n";
+/** The log path under `cwd`. */
+export declare function logsPath(cwd: string): string;
+/** The `.gitignore` path under `cwd`'s `.the-framework/`. */
+export declare function gitignorePath(cwd: string): string;
+/** Markdown for one entry, starting at `## ` (no file header, no blank lines around it). */
+export declare function renderLogEntry(entry: LogEntry): string;
+/**
+ * Parse every entry out of the markdown, in file order (append order, so
+ * oldest-first). Forgiving: a malformed or torn entry is skipped, never thrown.
+ */
+export declare function parseLogs(md: string): LogEntry[];
+/**
+ * Append one entry to `.the-framework/LOGS.md`, creating the dir and the
+ * one-time file header when absent. A raw write (may reject); the caller
+ * decides best-effort.
+ */
+export declare function appendLog(cwd: string, entry: LogEntry, fs?: StoreFs): Promise<void>;
+/** Read the project log, newest-first (append order reversed). Missing file yields `[]`. */
+export declare function readLogs(cwd: string, fs?: StoreFs): Promise<LogEntry[]>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE5D;;;;;GAKG;AAEH;;0EAE0E;AAC1E,OAAO,EAAE,iBAAiB,EAAE,CAAA;AAE5B,kCAAkC;AAClC,eAAO,MAAM,SAAS,YAAY,CAAA;AAElC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,uGAC2E,CAAA;AAEtG,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IACjC,mGAAmG;IACnG,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;IACjD;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAwBD,wEAAwE;AACxE,eAAO,MAAM,WAAW,2BAA2B,CAAA;AAEnD,gCAAgC;AAChC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AA0ED,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAWtD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE,CAmBhD;AA8CD;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxG;AAED,4FAA4F;AAC5F,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAI5F"}

package/dist/logs.js

@@ -0,0 +1,218 @@
+import { join } from 'node:path';
+import { THE_FRAMEWORK_DIR } from './framework-dir.js';
+import { nodeStoreFs } from './store/index.js';
+/**
+ * The `.the-framework/LOGS.md` project log (#378): a human-readable markdown
+ * record of every loop, prompt, and build run in a project. Pure core over the
+ * same {@link StoreFs} seam as the run store; the run-lifecycle wiring and UI
+ * land in later issues (#379/#380).
+ */
+/** The directory, under the project root, that holds the log. Defined in its own node-free
+ * module (#874) so the browser-reachable preset registry can share it; re-exported here
+ * because this is where every existing import site expects to find it. */
+export { THE_FRAMEWORK_DIR };
+/** The markdown log file name. */
+export const LOGS_FILE = 'LOGS.md';
+/**
+ * The `.the-framework/.gitignore` that keeps run state transient (#313): the dir
+ * holds both the committed DB (LOGS.md) and the transient run logs, so this
+ * ignores everything except LOGS.md and itself.
+ *
+ * An allow-list, so anything else meant to be committed needs its own negation —
+ * see `CONVERSATIONS_GITIGNORE` (#908), which install appends to this.
+ */
+export const LOGS_GITIGNORE = '# The Framework: the committed project DB; session state is transient.\n*\n!.gitignore\n!LOGS.md\n';
+const KINDS = ['loop', 'prompt', 'build'];
+const STATUSES = ['done', 'stopped', 'failed', 'running'];
+/** Heading field separator: a middle dot (U+00B7) with a space on each side. */
+const SEP = ' · ';
+/**
+ * Escape a free-text field so it stays on its own line (#897). A title is the run's prompt and a
+ * prompt bullet is agent text, but the file is committed history parsed line by line: an unescaped
+ * newline spills the rest of the prompt into the file, where a `## ` line forges an entry and a
+ * `- status: ` line rewrites one. Reversed by {@link decodeField}.
+ */
+function encodeField(value) {
+    return value.replace(/\\/g, '\\\\').replace(/\r\n|\r|\n/g, '\\n');
+}
+/** Reverse {@link encodeField}. Entries written before #897 are unescaped, so a literal `\n` in
+ * one of them decodes to a newline; harmless next to reading the rest of the prompt as entries. */
+function decodeField(value) {
+    return value.replace(/\\(\\|n)/g, (_, char) => (char === 'n' ? '\n' : '\\'));
+}
+/** The one-time first line of the file, written on the first append. */
+export const LOGS_HEADER = '# The Framework logs\n';
+/** The log path under `cwd`. */
+export function logsPath(cwd) {
+    return join(cwd, THE_FRAMEWORK_DIR, LOGS_FILE);
+}
+/** The `.gitignore` path under `cwd`'s `.the-framework/`. */
+export function gitignorePath(cwd) {
+    return join(cwd, THE_FRAMEWORK_DIR, '.gitignore');
+}
+/**
+ * The single-line `- key: ` fields, in render order, each owning both directions of its own
+ * encoding. render and parse both walk this one list, so a field's name, prefix, and escaping
+ * can never drift between the two sides — the file's one real hazard when they were hand-mirrored.
+ * The heading and the `- prompts:` nested list are structurally different and stay bespoke.
+ */
+const LOG_FIELDS = [
+    {
+        prefix: '- status: ',
+        render: entry => entry.status,
+        parse: (body, draft) => {
+            draft.status = body.trim();
+        },
+    },
+    {
+        prefix: '- run: ',
+        render: entry => (entry.id ? encodeField(entry.id) : undefined),
+        parse: (body, draft) => {
+            draft.id = decodeField(body.trim());
+        },
+    },
+    {
+        prefix: '- session: ',
+        render: entry => entry.sessionId === undefined
+            ? undefined
+            : entry.sessionLink
+                ? `[${entry.sessionId}](${entry.sessionLink})`
+                : entry.sessionId,
+        parse: (body, draft) => {
+            const value = body.trim();
+            const linked = /^\[(.+)\]\((.+)\)$/.exec(value);
+            if (linked) {
+                draft.sessionId = linked[1];
+                draft.sessionLink = linked[2];
+            }
+            else {
+                draft.sessionId = value;
+            }
+        },
+    },
+    {
+        prefix: '- name: ',
+        render: entry => (entry.sessionName ? encodeField(entry.sessionName) : undefined),
+        parse: (body, draft) => {
+            draft.sessionName = decodeField(body.trim());
+        },
+    },
+    {
+        prefix: '- branch: ',
+        render: entry => (entry.branch ? encodeField(entry.branch) : undefined),
+        parse: (body, draft) => {
+            draft.branch = decodeField(body.trim());
+        },
+    },
+];
+/** Markdown for one entry, starting at `## ` (no file header, no blank lines around it). */
+export function renderLogEntry(entry) {
+    const lines = [`## ${entry.at}${SEP}${entry.kind}${SEP}${encodeField(entry.title)}`, ''];
+    for (const field of LOG_FIELDS) {
+        const body = field.render(entry);
+        if (body !== undefined)
+            lines.push(`${field.prefix}${body}`);
+    }
+    if (entry.prompts && entry.prompts.length > 0) {
+        lines.push('- prompts:');
+        for (const prompt of entry.prompts)
+            lines.push(`  - ${encodeField(prompt)}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Parse every entry out of the markdown, in file order (append order, so
+ * oldest-first). Forgiving: a malformed or torn entry is skipped, never thrown.
+ */
+export function parseLogs(md) {
+    const entries = [];
+    let block;
+    const flush = () => {
+        const entry = block && parseEntry(block);
+        if (entry)
+            entries.push(entry);
+        block = undefined;
+    };
+    for (const line of md.split('\n')) {
+        if (line.startsWith('## ')) {
+            flush();
+            block = [line];
+        }
+        else if (block) {
+            block.push(line);
+        }
+        // Anything before the first `## ` (the file header) is ignored.
+    }
+    flush();
+    return entries;
+}
+/** Parse one `## `-headed block; `undefined` when a required field is missing/invalid. */
+function parseEntry(lines) {
+    const heading = lines[0]?.slice('## '.length) ?? '';
+    const parts = heading.split(SEP);
+    const at = parts[0];
+    const kind = parts[1];
+    // Re-join the rest so a title containing the separator survives.
+    const title = decodeField(parts.slice(2).join(SEP));
+    if (!at || !kind || !title || !KINDS.includes(kind))
+        return undefined;
+    const draft = {};
+    let prompts;
+    let inPrompts = false;
+    for (const line of lines.slice(1)) {
+        if (inPrompts && line.startsWith('  - ')) {
+            prompts.push(decodeField(line.slice('  - '.length)));
+            continue;
+        }
+        inPrompts = false;
+        if (line.trim() === '- prompts:') {
+            prompts = [];
+            inPrompts = true;
+            continue;
+        }
+        const field = LOG_FIELDS.find(f => line.startsWith(f.prefix));
+        if (field)
+            field.parse(line.slice(field.prefix.length), draft);
+    }
+    if (!draft.status || !STATUSES.includes(draft.status))
+        return undefined;
+    const entry = {
+        at,
+        kind: kind,
+        title,
+        status: draft.status,
+    };
+    if (draft.id)
+        entry.id = draft.id;
+    if (draft.sessionId)
+        entry.sessionId = draft.sessionId;
+    if (draft.sessionLink)
+        entry.sessionLink = draft.sessionLink;
+    if (draft.sessionName)
+        entry.sessionName = draft.sessionName;
+    if (draft.branch)
+        entry.branch = draft.branch;
+    if (prompts && prompts.length > 0)
+        entry.prompts = prompts;
+    return entry;
+}
+/**
+ * Append one entry to `.the-framework/LOGS.md`, creating the dir and the
+ * one-time file header when absent. A raw write (may reject); the caller
+ * decides best-effort.
+ */
+export async function appendLog(cwd, entry, fs = nodeStoreFs()) {
+    await fs.mkdir(join(cwd, THE_FRAMEWORK_DIR));
+    const path = logsPath(cwd);
+    if (!(await fs.exists(path)))
+        await fs.write(path, LOGS_HEADER);
+    await fs.append(path, '\n' + renderLogEntry(entry) + '\n');
+}
+/** Read the project log, newest-first (append order reversed). Missing file yields `[]`. */
+export async function readLogs(cwd, fs = nodeStoreFs()) {
+    const path = logsPath(cwd);
+    if (!(await fs.exists(path)))
+        return [];
+    return parseLogs(await fs.read(path)).reverse();
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"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"}