@openagt/dashboard 0.8.0 → 0.9.0

package/dist/conversation-commit.js

@@ -1,309 +0,0 @@
-import { join } from 'node:path';
-import { CONVERSATIONS_DIR } from './conversations.js';
-import { SESSIONS_DIR } from './store/index.js';
-import { THE_FRAMEWORK_DIR } from './framework-dir.js';
-import { nodeGitRunner } from './project.js';
-import { errorMessage } from './error-message.js';
-/**
- * Committing the conversations the daemon records (#912) into the project checkout.
- *
- * #908 made `.the-framework/conversations/<runId>.md` tracked files, and the paths that already
- * commit pick them up: a run's worktree sweeps its own on teardown (`store/worktree.ts`). The main
- * checkout has no such path — `install.ts` commits once at activation and nothing after — so a
- * conversation held there sat as a working-tree change until a human happened to commit it. That
- * is the one gap between "the chat is in Git" (#857) and "the chat reaches Git by itself".
- *
- * Two rules shape the whole module, both about writing into a repo somebody else is using.
- *
- * Path-scoped, never `git add -A`. The pathspec names the conversations directory and nothing
- * else, the way `queue-promote.ts` names the queue file, so whatever the user has in progress
- * cannot ride along in our commit. A pathspec commit also leaves their index alone: what they had
- * staged is still staged afterwards. Scoped down further at commit time to the pathspecs that
- * actually have something pending — see {@link pathspecsFor}.
- *
- * Debounced on an idle window rather than committed per turn. A chat turn is seconds apart, and a
- * commit each would bury the project's real history under transcript noise. A poll that sees the
- * same pending set twice running treats the conversation as settled and commits the batch; a burst
- * keeps resetting it. {@link ConversationCommitterOptions.maxWaitMs} caps that, so a conversation
- * that never goes idle still lands instead of being starved forever.
- *
- * Tolerates not being alone (the #605 question this waited on). One daemon per machine is the rule
- * today (#393), but the committer never assumes it: a locked index or a rebase/merge in progress
- * means somebody else is mid-operation, so it skips rather than commits into their work, and a
- * failed commit is swallowed and retried on the next window. That way #605's eventual answer about
- * who owns the chat bot does not invalidate any of this.
- */
-/** The pathspec the conversations live under. Posix separators: it is a git pathspec, not a path. */
-export const CONVERSATIONS_PATHSPEC = `${THE_FRAMEWORK_DIR}/${CONVERSATIONS_DIR}`;
-/**
- * The committed session archives (#1179), under every user's own directory.
- *
- * `:(glob)` magic so the `*` stops at a path separator — a plain pathspec wildcard matches `/` too,
- * and would reach further down `.the-framework/` than this means to.
- *
- * The trailing `/**` is load-bearing, and its absence is silent: glob magic matches the pattern
- * against each file's whole path rather than treating a directory as a prefix, so
- * `.the-framework/*​/sessions` matches no *file* and `git add` fails with "did not match any files"
- * — a committer that commits nothing, every time. Only a real repo shows this.
- */
-export const SESSIONS_PATHSPEC = `:(glob)${THE_FRAMEWORK_DIR}/*/${SESSIONS_DIR}/**`;
-/**
- * Everything this committer is scoped to. Both are records the daemon writes into the repo and
- * nobody would think to commit by hand: the chat of a run (#908) and the run's own archived history
- * (#1179). They share one debounce because they are written by the same events and a commit each
- * would double the noise in the project's log.
- */
-export const COMMITTED_PATHSPECS = [CONVERSATIONS_PATHSPEC, SESSIONS_PATHSPEC];
-/**
- * Which pending file belongs to which pathspec, so a pathspec with nothing under it can be left out
- * of `add`/`commit` (see {@link pathspecsFor}). Kept beside the pathspecs themselves: a predicate
- * that drifts from the pattern it mirrors would silently drop a file from every commit.
- */
-const PATHSPEC_MEMBERSHIP = [
-    [CONVERSATIONS_PATHSPEC, file => file.startsWith(`${CONVERSATIONS_PATHSPEC}/`)],
-    [SESSIONS_PATHSPEC, file => file.startsWith(`${THE_FRAMEWORK_DIR}/`) && file.includes(`/${SESSIONS_DIR}/`)],
-];
-/**
- * The subset of {@link COMMITTED_PATHSPECS} that `files` actually has something under.
- *
- * `git add` and `git commit` are all-or-nothing about their pathspecs: one that matches no file
- * aborts the whole command with "pathspec ... did not match any files", so passing both patterns
- * unconditionally means a project that has sessions but has never recorded a conversation — every
- * project, until its first chat — fails to commit and puts that failure in the daemon log on every
- * poll. Nothing to commit under a pattern is the ordinary state, not an error, so the pattern is
- * dropped instead.
- *
- * This covers the empty directory as well as the missing one, and the two fail in different places:
- * `git add` tolerates an existing-but-empty directory, and then `git commit` rejects it, because by
- * then the pathspec has to match a file git knows about.
- */
-export function pathspecsFor(files) {
-    return PATHSPEC_MEMBERSHIP.filter(([, holds]) => files.some(holds)).map(([pathspec]) => pathspec);
-}
-/** How often the committer looks for settled conversations. */
-export const COMMIT_POLL_MS = 30_000;
-/** How long a conversation may keep changing before it is committed anyway. */
-export const COMMIT_MAX_WAIT_MS = 5 * 60_000;
-/** A {@link PathProbe} over `fs.access`. */
-export function nodePathProbe() {
-    return async (path) => {
-        const { access } = await import('node:fs/promises');
-        return access(path).then(() => true, () => false);
-    };
-}
-/**
- * The commit message a batch writes. Names what moved, so the log line stands alone.
- *
- * Sessions are counted by run, not by file: one archived run is a `<id>.json` and a `<id>.jsonl`,
- * and "2 sessions" for a single session would be a lie told by the batch's own commit message.
- */
-export function commitMessage(files) {
-    const sessionFiles = files.filter(file => file.includes(`/${SESSIONS_DIR}/`));
-    const runs = new Set(sessionFiles.map(file => file.replace(/\.[^./]+$/, ''))).size;
-    const conversations = files.length - sessionFiles.length;
-    const parts = [];
-    if (conversations > 0)
-        parts.push(conversations === 1 ? 'a conversation' : `${conversations} conversations`);
-    if (runs > 0)
-        parts.push(runs === 1 ? 'a session' : `${runs} sessions`);
-    return `[The Framework] ${parts.join(' and ')}`;
-}
-/**
- * The conversation files with uncommitted changes, as repo-relative paths, sorted so the result is
- * a stable fingerprint the debounce can compare across polls.
- *
- * `--porcelain` v1 is parsed rather than `--short` because its two status columns are fixed-width
- * and its paths are quoted consistently. A rename (`R  old -> new`) reports the destination, which
- * is the path we would commit. Anything unreadable — not a repo, no git — reads as no changes.
- *
- * `-uall` is load-bearing, not a detail. By default git collapses a wholly-untracked directory into
- * one entry (`?? .the-framework/conversations/`) instead of naming the files under it, which makes
- * the fingerprint identical whether one conversation is being written or ten. The debounce compares
- * fingerprints, so without this the idle window could never see a burst and would commit straight
- * through the middle of one. Only a real repo shows this; a per-file fake does not.
- */
-export async function pendingConversations(cwd, git = nodeGitRunner()) {
-    const out = await git(['status', '--porcelain', '-uall', '--', ...COMMITTED_PATHSPECS], cwd).catch(() => '');
-    const files = new Set();
-    for (const line of out.split('\n')) {
-        if (line.length < 4)
-            continue;
-        // Columns 0-1 are the status codes, 2 is a space, the path starts at 3.
-        const entry = line.slice(3);
-        const arrow = entry.indexOf(' -> ');
-        files.add(unquotePath(arrow === -1 ? entry : entry.slice(arrow + ' -> '.length)));
-    }
-    return [...files].sort();
-}
-/**
- * Undo git's C-style quoting of a path holding non-ASCII or special characters. Only the escapes
- * git actually emits are handled; anything else is left as written rather than mangled.
- */
-function unquotePath(entry) {
-    if (!entry.startsWith('"') || !entry.endsWith('"'))
-        return entry;
-    return entry
-        .slice(1, -1)
-        .replace(/\\([\\"])/g, '$1')
-        .replace(/\\t/g, '\t')
-        .replace(/\\n/g, '\n');
-}
-/** The markers that mean another git operation owns this repo right now. */
-const BUSY_MARKERS = [
-    ['index.lock', 'another git process holds the index lock'],
-    ['rebase-merge', 'a rebase is in progress'],
-    ['rebase-apply', 'a rebase is in progress'],
-    ['MERGE_HEAD', 'a merge is in progress'],
-    ['CHERRY_PICK_HEAD', 'a cherry-pick is in progress'],
-    ['REVERT_HEAD', 'a revert is in progress'],
-    ['BISECT_LOG', 'a bisect is in progress'],
-];
-/**
- * Why the repo is in no state to be committed into, or `undefined` when it is fine.
- *
- * The git dir is resolved through git rather than assumed to be `<cwd>/.git`, so this is right in a
- * linked worktree, where `.git` is a file pointing elsewhere and the markers live in the real dir.
- */
-export async function gitBusy(cwd, git = nodeGitRunner(), exists = nodePathProbe()) {
-    const gitDir = await git(['rev-parse', '--absolute-git-dir'], cwd).then(out => out.trim(), () => '');
-    if (!gitDir)
-        return 'not a git repository';
-    for (const [name, reason] of BUSY_MARKERS) {
-        if (await exists(join(gitDir, name)))
-            return reason;
-    }
-    return undefined;
-}
-/** The everyday no-op outcome. Named so the poller can tell it apart from a real failure. */
-const NOTHING_PENDING = 'no conversation changes';
-/**
- * Stage and commit the pending conversations under `cwd`, scoped to {@link COMMITTED_PATHSPECS}.
- *
- * `add` before `commit` because a brand-new conversation is untracked, and `git commit -- <path>`
- * only knows paths git already knows. Both are pathspec-scoped, so the staging is as narrow as the
- * commit and the user's own staged work is neither swept in nor disturbed, and both are narrowed to
- * the pathspecs that have something pending ({@link pathspecsFor}) — a pathspec matching nothing is
- * a hard error to git, and "no conversation has been recorded here yet" is not an error at all.
- *
- * Never throws: this runs on a background tick with nothing to catch it.
- */
-export async function commitConversations(cwd, git = nodeGitRunner(), exists = nodePathProbe()) {
-    const busy = await gitBusy(cwd, git, exists);
-    if (busy)
-        return { committed: false, reason: busy };
-    const files = await pendingConversations(cwd, git);
-    if (files.length === 0)
-        return { committed: false, reason: NOTHING_PENDING };
-    // Only the pathspecs that have something pending, or git aborts on the one that matches nothing.
-    // An empty result should be unreachable — `status` was scoped to these same pathspecs — but an
-    // empty pathspec list means "everything", which would sweep the user's whole checkout into our
-    // commit, so it reads as nothing pending rather than as a commit.
-    const pathspecs = pathspecsFor(files);
-    if (pathspecs.length === 0)
-        return { committed: false, reason: NOTHING_PENDING };
-    try {
-        await git(['add', '--', ...pathspecs], cwd);
-        await git(['commit', '-m', commitMessage(files), '--', ...pathspecs], cwd);
-        return { committed: true, files };
-    }
-    catch (err) {
-        return { committed: false, reason: errorMessage(err) };
-    }
-}
-/**
- * Start committing settled conversations, and return the handle that stops it.
- *
- * The idle window is the poll itself: a project whose pending set is byte-identical to the previous
- * poll's has stopped being written to, so its batch is committed. Anything still moving is recorded
- * and reconsidered next time, unless it has been dirty past `maxWaitMs`, which forces it through.
- *
- * Forgiving throughout — a failed project scan, a busy repo or a rejected commit costs one window
- * and is retried, never a throw. Runs immediately, then every `intervalMs`; the timer is unref'd so
- * it never keeps the daemon alive past shutdown.
- */
-export function startConversationCommitter(opts) {
-    const git = opts.git ?? nodeGitRunner();
-    const exists = opts.exists ?? nodePathProbe();
-    const now = opts.now ?? Date.now;
-    const intervalMs = opts.intervalMs ?? COMMIT_POLL_MS;
-    const maxWaitMs = opts.maxWaitMs ?? COMMIT_MAX_WAIT_MS;
-    const pending = new Map();
-    let stopped = false;
-    let running = false;
-    const poll = async () => {
-        if (stopped || running)
-            return;
-        running = true;
-        try {
-            const projects = await opts.projects().catch(() => []);
-            const seen = new Set();
-            for (const project of projects) {
-                if (stopped)
-                    break;
-                seen.add(project.path);
-                const files = await pendingConversations(project.path, git).catch(() => []);
-                if (files.length === 0) {
-                    pending.delete(project.path);
-                    continue;
-                }
-                const fingerprint = files.join('\n');
-                const previous = pending.get(project.path);
-                const since = previous?.since ?? now();
-                // Settled (nothing changed since the last poll), or dirty long enough that waiting for
-                // quiet is no longer worth it.
-                const settled = previous?.fingerprint === fingerprint || now() - since >= maxWaitMs;
-                const loggedReason = previous?.loggedReason;
-                if (!settled) {
-                    pending.set(project.path, { fingerprint, since, loggedReason });
-                    continue;
-                }
-                const outcome = await commitConversations(project.path, git, exists);
-                if (outcome.committed) {
-                    pending.delete(project.path);
-                    opts.log?.(`[framework] committed ${outcome.files.length} conversation(s) in ${project.name}`);
-                }
-                else {
-                    // A busy repo or a rejected commit keeps its place, so the next window retries it
-                    // rather than starting the idle count over.
-                    const reason = outcome.reason === NOTHING_PENDING ? undefined : outcome.reason;
-                    // Announced on change only: this is a poll, so logging every failure would repeat the
-                    // same line forever while a project stays stuck.
-                    if (reason !== undefined && reason !== loggedReason) {
-                        opts.log?.(`[framework] conversation commit failed in ${project.name}: ${reason}`);
-                    }
-                    pending.set(project.path, { fingerprint, since, loggedReason: reason });
-                }
-            }
-            // Drop state for projects that went away, so the map cannot grow without bound.
-            for (const path of [...pending.keys()])
-                if (!seen.has(path))
-                    pending.delete(path);
-        }
-        finally {
-            running = false;
-        }
-    };
-    const flush = async () => {
-        let committed = 0;
-        for (const project of await opts.projects().catch(() => [])) {
-            const outcome = await commitConversations(project.path, git, exists);
-            if (outcome.committed) {
-                pending.delete(project.path);
-                committed++;
-            }
-        }
-        return committed;
-    };
-    void poll();
-    const timer = setInterval(() => void poll(), intervalMs);
-    timer.unref?.();
-    return {
-        stop: () => {
-            stopped = true;
-            clearInterval(timer);
-        },
-        poll,
-        flush,
-    };
-}
-//# sourceMappingURL=conversation-commit.js.map

package/dist/conversation-commit.js.map

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

package/dist/conversations.d.ts

@@ -1,93 +0,0 @@
-import { type StoreFs } from './store/index.js';
-/**
- * The committed conversations (#908): the human turns and the agent's replies of a run, kept in
- * the Git repo so a clone carries the chat and not just the fact a run happened (#857).
- *
- * Deliberately not the verbose transcript — #857 leaves the tool-call-level log to the model
- * provider, which is also the standing policy in run-store.ts. What lands here is what a person
- * would reread: what was asked, and what came back.
- *
- * One file per run rather than one shared file, because run worktrees are live concurrently and
- * each auto-commits its own pending work on teardown; a shared file would be a merge conflict
- * every time two runs chatted at once. The run id is the join key back to the `- run:` field
- * LOGS.md records (#898), so the committed session list and the committed chat line up.
- *
- * Pure core over the same {@link StoreFs} seam as logs.ts.
- */
-/** The directory, under `.the-framework/`, that holds one markdown file per conversation. */
-export declare const CONVERSATIONS_DIR = "conversations";
-/**
- * The `.the-framework/.gitignore` that keeps run state transient while committing the DB. The
- * conversations rules need both entries: the `*` rule makes git skip the directory without ever
- * descending into it, so un-ignoring the files alone would never be reached.
- */
-export declare const CONVERSATIONS_GITIGNORE = "!conversations/\n!conversations/**\n";
-/** Who said it. The transport is {@link ConversationMessage.via}, not this. */
-export type ConversationRole = 'user' | 'agent';
-/** One turn in a conversation. */
-export interface ConversationMessage {
-    /** ISO timestamp. */
-    at: string;
-    role: ConversationRole;
-    /**
-     * The surface the turn came through — `dashboard`, `discord`, … Recorded so a conversation
-     * read back shows where it happened, while this module stays free of any transport.
-     */
-    via: string;
-    /** The message. Multi-line and kept that way; only line-leading markers are escaped. */
-    text: string;
-}
-/**
- * Whether a transport name is safe to record. Exported because #917 lets a surface name itself
- * over the control channel, so the name now arrives from outside this module: a `via` carrying
- * the heading separator, a newline or a `#` would forge structure in a file whose entries are
- * line-parsed, exactly the way #897 forged a LOGS.md title. Checked at the boundary rather than
- * trusted, and the same predicate {@link parseConversation} reads back with.
- */
-export declare function isSafeVia(via: unknown): via is string;
-/**
- * Escape a message body so it cannot forge structure (#897's threat model, applied to a
- * transcript). LOGS.md collapses free text to one line, which is right for a line-parsed record
- * and wrong here: a multi-paragraph reply has to stay readable in a `git diff`. So the text stays
- * as written and only a line's leading `#` or `\` is escaped, which is enough — an entry is only
- * ever started by a line beginning `## `. Reversed by {@link unescapeBody}.
- */
-export declare function escapeBody(text: string): string;
-/** Reverse {@link escapeBody}. */
-export declare function unescapeBody(text: string): string;
-/** The directory holding every conversation under `cwd`. */
-export declare function conversationsDir(cwd: string): string;
-/**
- * One conversation's path. `undefined` for an unsafe run id: the id reaches this from a run
- * store and, once #680 lands, indirectly from a chat surface, so it is checked rather than
- * trusted into a path.
- */
-export declare function conversationPath(cwd: string, runId: string): string | undefined;
-/** Markdown for one message, starting at `## ` (no file header, no blank lines around it). */
-export declare function renderMessage(message: ConversationMessage): string;
-/**
- * Parse every message out of the markdown, in file order (append order, so oldest-first — a
- * transcript reads forwards, unlike the newest-first project log). Forgiving: a malformed or
- * torn message is skipped, never thrown.
- */
-export declare function parseConversation(md: string): ConversationMessage[];
-/**
- * Make sure `.the-framework/.gitignore` un-ignores the conversations dir, returning whether it
- * wrote. Done lazily on append rather than only at install time: the seeded ignore file is
- * written once and only when absent (`install.ts`), so every repo activated before this feature
- * still carries the old three-line allow-list and would silently drop its own conversations.
- *
- * Only ours is upgraded — a file we do not recognize is left alone rather than appended to.
- */
-export declare function ensureConversationsIgnored(cwd: string, fs?: StoreFs): Promise<boolean>;
-/**
- * Append one message to `.the-framework/conversations/<runId>.md`, creating the dir, the
- * one-time file header, and the ignore rule when absent. A raw write (may reject); the caller
- * decides best-effort. A no-op for an unsafe run id.
- */
-export declare function appendMessage(cwd: string, runId: string, message: ConversationMessage, fs?: StoreFs): Promise<void>;
-/** Read one conversation, oldest-first. Missing file (or unsafe id) yields `[]`. */
-export declare function readConversation(cwd: string, runId: string, fs?: StoreFs): Promise<ConversationMessage[]>;
-/** The run ids that have a committed conversation, sorted. Missing dir yields `[]`. */
-export declare function listConversations(cwd: string, fs?: StoreFs): Promise<string[]>;
-//# sourceMappingURL=conversations.d.ts.map

package/dist/conversations.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../src/conversations.ts"],"names":[],"mappings":"AAGA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAEzE;;;;;;;;;;;;;;GAcG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,iBAAiB,kBAAkB,CAAA;AAEhD;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,yCAAuD,CAAA;AAE3F,+EAA+E;AAC/E,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAA;AAE/C,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,gBAAgB,CAAA;IACtB;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IACX,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAA;CACb;AAUD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,kCAAkC;AAClC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAOD,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG/E;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAElE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmBnE;AAoBD;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAW3G;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,mBAAmB,EAC5B,EAAE,GAAE,OAAuB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,oFAAoF;AACpF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,EAAE,GAAE,OAAuB,GAC1B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAIhC;AAED,uFAAuF;AACvF,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnG"}

package/dist/conversations.js

@@ -1,176 +0,0 @@
-import { join } from 'node:path';
-import { THE_FRAMEWORK_DIR } from './framework-dir.js';
-import { gitignorePath, LOGS_GITIGNORE } from './logs.js';
-import { isSafeRunId, nodeStoreFs } from './store/index.js';
-/**
- * The committed conversations (#908): the human turns and the agent's replies of a run, kept in
- * the Git repo so a clone carries the chat and not just the fact a run happened (#857).
- *
- * Deliberately not the verbose transcript — #857 leaves the tool-call-level log to the model
- * provider, which is also the standing policy in run-store.ts. What lands here is what a person
- * would reread: what was asked, and what came back.
- *
- * One file per run rather than one shared file, because run worktrees are live concurrently and
- * each auto-commits its own pending work on teardown; a shared file would be a merge conflict
- * every time two runs chatted at once. The run id is the join key back to the `- run:` field
- * LOGS.md records (#898), so the committed session list and the committed chat line up.
- *
- * Pure core over the same {@link StoreFs} seam as logs.ts.
- */
-/** The directory, under `.the-framework/`, that holds one markdown file per conversation. */
-export const CONVERSATIONS_DIR = 'conversations';
-/**
- * The `.the-framework/.gitignore` that keeps run state transient while committing the DB. The
- * conversations rules need both entries: the `*` rule makes git skip the directory without ever
- * descending into it, so un-ignoring the files alone would never be reached.
- */
-export const CONVERSATIONS_GITIGNORE = `!${CONVERSATIONS_DIR}/\n!${CONVERSATIONS_DIR}/**\n`;
-const ROLES = ['user', 'agent'];
-/** Heading field separator, matching LOGS.md: a middle dot (U+00B7) with a space on each side. */
-const SEP = ' · ';
-/** A transport name is a plain word, so it can never carry the heading separator into a heading. */
-const VIA = /^[A-Za-z0-9_-]+$/;
-/**
- * Whether a transport name is safe to record. Exported because #917 lets a surface name itself
- * over the control channel, so the name now arrives from outside this module: a `via` carrying
- * the heading separator, a newline or a `#` would forge structure in a file whose entries are
- * line-parsed, exactly the way #897 forged a LOGS.md title. Checked at the boundary rather than
- * trusted, and the same predicate {@link parseConversation} reads back with.
- */
-export function isSafeVia(via) {
-    return typeof via === 'string' && VIA.test(via);
-}
-/**
- * Escape a message body so it cannot forge structure (#897's threat model, applied to a
- * transcript). LOGS.md collapses free text to one line, which is right for a line-parsed record
- * and wrong here: a multi-paragraph reply has to stay readable in a `git diff`. So the text stays
- * as written and only a line's leading `#` or `\` is escaped, which is enough — an entry is only
- * ever started by a line beginning `## `. Reversed by {@link unescapeBody}.
- */
-export function escapeBody(text) {
-    return text.replace(/^([\\#])/gm, '\\$1');
-}
-/** Reverse {@link escapeBody}. */
-export function unescapeBody(text) {
-    return text.replace(/^\\([\\#])/gm, '$1');
-}
-/** The one-time first line of a conversation file. */
-function conversationHeader(runId) {
-    return `# Conversation ${runId}\n`;
-}
-/** The directory holding every conversation under `cwd`. */
-export function conversationsDir(cwd) {
-    return join(cwd, THE_FRAMEWORK_DIR, CONVERSATIONS_DIR);
-}
-/**
- * One conversation's path. `undefined` for an unsafe run id: the id reaches this from a run
- * store and, once #680 lands, indirectly from a chat surface, so it is checked rather than
- * trusted into a path.
- */
-export function conversationPath(cwd, runId) {
-    if (!isSafeRunId(runId))
-        return undefined;
-    return join(conversationsDir(cwd), `${runId}.md`);
-}
-/** Markdown for one message, starting at `## ` (no file header, no blank lines around it). */
-export function renderMessage(message) {
-    return `## ${message.at}${SEP}${message.role}${SEP}${message.via}\n\n${escapeBody(message.text)}`;
-}
-/**
- * Parse every message out of the markdown, in file order (append order, so oldest-first — a
- * transcript reads forwards, unlike the newest-first project log). Forgiving: a malformed or
- * torn message is skipped, never thrown.
- */
-export function parseConversation(md) {
-    const messages = [];
-    let block;
-    const flush = () => {
-        const message = block && parseMessage(block);
-        if (message)
-            messages.push(message);
-        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 messages;
-}
-/** Parse one `## `-headed block; `undefined` when a required field is missing/invalid. */
-function parseMessage(lines) {
-    const heading = lines[0]?.slice('## '.length) ?? '';
-    const parts = heading.split(SEP);
-    const at = parts[0];
-    const role = parts[1];
-    const via = parts[2];
-    if (!at || !role || !via || !ROLES.includes(role) || !VIA.test(via))
-        return undefined;
-    // A heading carries exactly three fields; anything more is not one of ours.
-    if (parts.length !== 3)
-        return undefined;
-    // Drop the blank line the renderer puts under the heading, and any trailing blank lines that
-    // are really the separator before the next message.
-    const body = lines.slice(1).join('\n').replace(/^\n/, '').replace(/\n+$/, '');
-    return { at, role: role, via, text: unescapeBody(body) };
-}
-/**
- * Make sure `.the-framework/.gitignore` un-ignores the conversations dir, returning whether it
- * wrote. Done lazily on append rather than only at install time: the seeded ignore file is
- * written once and only when absent (`install.ts`), so every repo activated before this feature
- * still carries the old three-line allow-list and would silently drop its own conversations.
- *
- * Only ours is upgraded — a file we do not recognize is left alone rather than appended to.
- */
-export async function ensureConversationsIgnored(cwd, fs = nodeStoreFs()) {
-    const path = gitignorePath(cwd);
-    if (!(await fs.exists(path))) {
-        await fs.write(path, LOGS_GITIGNORE + CONVERSATIONS_GITIGNORE);
-        return true;
-    }
-    const current = await fs.read(path);
-    if (current.includes(`!${CONVERSATIONS_DIR}/**`))
-        return false;
-    if (!current.includes('!LOGS.md'))
-        return false;
-    await fs.write(path, current.endsWith('\n') ? current + CONVERSATIONS_GITIGNORE : current + '\n' + CONVERSATIONS_GITIGNORE);
-    return true;
-}
-/**
- * Append one message to `.the-framework/conversations/<runId>.md`, creating the dir, the
- * one-time file header, and the ignore rule when absent. A raw write (may reject); the caller
- * decides best-effort. A no-op for an unsafe run id.
- */
-export async function appendMessage(cwd, runId, message, fs = nodeStoreFs()) {
-    const path = conversationPath(cwd, runId);
-    if (!path)
-        return;
-    await fs.mkdir(conversationsDir(cwd));
-    await ensureConversationsIgnored(cwd, fs);
-    if (!(await fs.exists(path)))
-        await fs.write(path, conversationHeader(runId));
-    await fs.append(path, '\n' + renderMessage(message) + '\n');
-}
-/** Read one conversation, oldest-first. Missing file (or unsafe id) yields `[]`. */
-export async function readConversation(cwd, runId, fs = nodeStoreFs()) {
-    const path = conversationPath(cwd, runId);
-    if (!path || !(await fs.exists(path)))
-        return [];
-    return parseConversation(await fs.read(path));
-}
-/** The run ids that have a committed conversation, sorted. Missing dir yields `[]`. */
-export async function listConversations(cwd, fs = nodeStoreFs()) {
-    const names = await fs.readdir(conversationsDir(cwd)).catch(() => []);
-    return names
-        .filter(name => name.endsWith('.md'))
-        .map(name => name.slice(0, -'.md'.length))
-        .filter(isSafeRunId)
-        .sort();
-}
-//# sourceMappingURL=conversations.js.map

package/dist/conversations.js.map

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

package/dist/daemon-writes.d.ts

@@ -1,33 +0,0 @@
-import { type CommitMessage, type FileBranchWrite, type GitRunner } from '@gemstack/agent-data';
-/**
- * The daemon's own writes to the `agent-data` branch, told apart from everyone else's.
- *
- * The daemon starts a run when the branch moved by a commit it did not write itself: someone
- * queued work, an agent claimed or closed a ticket. Its own commits — a run's record at teardown, a
- * routine lock, a claim minted for a plan agent — must not count, or every record it writes would
- * start the next run, forever. And the branch is shared: another machine's daemon writes records
- * too, and two daemons reading each other's records as work would fire empty runs at each other
- * without end. So every automatic write goes through {@link daemonFunnel}, which signs the commit
- * with a git trailer naming the machine, and the trigger counts only the commits that carry none.
- *
- * A write a person makes from the dashboard (queue an entry, release a claim) takes the skills'
- * plain funnel and carries no trailer: a person asking for work is exactly what should start a run.
- */
-/** The trailer key on every commit a daemon writes on its own: `Daemon: <machine name>`. */
-export declare const DAEMON_TRAILER = "Daemon";
-/** A write funnel to the data branch, the shape every skill library accepts. */
-export type DataFunnel = (root: string, message: CommitMessage, op: (dir: string) => Promise<void>) => Promise<FileBranchWrite>;
-/**
- * The persistent checkout's write cycle on the `agent-data` branch, every commit signed
- * `Daemon: <host>` as its last line. One per daemon; `host` is a test seam.
- */
-export declare function daemonFunnel(host?: string): DataFunnel;
-/** The local head of the `agent-data` branch, or `undefined` when the repo has no such branch yet. */
-export declare function dataHead(repo: string, git?: GitRunner): Promise<string | undefined>;
-/**
- * How many commits `from..to` on the branch were written by something other than a daemon: the
- * ones with no `Daemon:` trailer. A range git cannot walk (a `from` rebased away) counts as none;
- * the daily heartbeat is the belt for that.
- */
-export declare function foreignCommits(repo: string, from: string, to: string, git?: GitRunner): Promise<number>;
-//# sourceMappingURL=daemon-writes.d.ts.map

package/dist/daemon-writes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"daemon-writes.d.ts","sourceRoot":"","sources":["../src/daemon-writes.ts"],"names":[],"mappings":"AACA,OAAO,EAA8C,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAE3I;;;;;;;;;;;;;GAaG;AAEH,4FAA4F;AAC5F,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,eAAe,CAAC,CAAA;AAE/H;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAmB,GAAG,UAAU,CAGlE;AAED,sGAAsG;AACtG,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,SAA2B,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAK1G;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,GAAE,SAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAQ9H"}