@openagt/dashboard 0.8.0 → 0.9.0

package/dist/store/worktree.js

@@ -1,331 +0,0 @@
-import { join } from 'node:path';
-import { realpath } from 'node:fs/promises';
-import { nodeGitRunner } from '../project.js';
-import { FRAMEWORK_DIR, BRANCHES_DIR, isSafeAgentId } from './agent-store.js';
-import { worktreeDirName } from '../branch-names.js';
-/**
- * Git-worktree lifecycle for concurrent agents (#453/#735): give each agent its own
- * checkout so N runs on one repo never fight over the working tree. Pure plumbing
- * over the existing {@link GitRunner} seam; no daemon wiring, no concurrency, no
- * dashboard changes (those are the sibling #453 slices). This module only knows
- * how to add, list, remove, and prune worktrees.
- */
-/** The path an agent's worktree gets (#1580): `<repo>/.the-framework/branches/<run branch name>`. */
-export function worktreePath(repo, agentId) {
-    return join(repo, FRAMEWORK_DIR, BRANCHES_DIR, worktreeDirName(agentId));
-}
-export { AGENT_BRANCH_PREFIX, LEGACY_AGENT_BRANCH_PREFIX, agentBranchName, legacyAgentBranchName, } from '../branch-names.js';
-/**
- * Create a worktree for an agent on a fresh branch: `git worktree add -b <branch>
- * <path> [base]`. Git makes the leaf dir (and any missing parents) itself. The
- * `agentId` is validated as path-safe first so a caller can never traverse out of
- * `.the-framework/branches/`. Rejects on any git failure (a caller that wants a
- * run needs its checkout, so failure must surface, not be swallowed).
- */
-export async function addWorktree(repo, opts, agent = nodeGitRunner()) {
-    if (!isSafeAgentId(opts.agentId))
-        throw new Error(`unsafe run id: ${opts.agentId}`);
-    const path = worktreePath(repo, opts.agentId);
-    await agent(['worktree', 'add', '-b', opts.branch, path, ...(opts.base ? [opts.base] : [])], repo);
-    return { path, branch: opts.branch };
-}
-/**
- * Check an *existing* branch out into an agent's worktree (#762): `git worktree add <path> <branch>`,
- * no `-b`. Continuing an agent puts it back on the branch its work is already on, rather than
- * branching again from HEAD and stranding what it did last time.
- *
- * A branch that is gone is recreated from HEAD (#1650): the only branch the framework deletes is
- * one that held nothing past a commit the remote already had, so HEAD is where its work was.
- * Anything else git refuses — the branch checked out elsewhere, say — still rejects, like
- * {@link addWorktree}: a continued agent needs its checkout.
- */
-export async function attachWorktree(repo, opts, agent = nodeGitRunner()) {
-    if (!isSafeAgentId(opts.agentId))
-        throw new Error(`unsafe run id: ${opts.agentId}`);
-    const path = worktreePath(repo, opts.agentId);
-    try {
-        await agent(['worktree', 'add', path, opts.branch], repo);
-    }
-    catch (err) {
-        // `worktree add <path> <name>` also resolves a remote-only `origin/<name>`, so the existence
-        // check comes after the attempt, not before it.
-        const exists = await agent(['show-ref', '--verify', '--quiet', `refs/heads/${opts.branch}`], repo).then(() => true, () => false);
-        if (exists)
-            throw err;
-        await agent(['worktree', 'add', '-b', opts.branch, path], repo);
-    }
-    return { path, branch: opts.branch };
-}
-/**
- * Every worktree registered for the repo (the main checkout included). Forgiving:
- * a non-repo / git failure yields `[]` so a reconcile scan never throws.
- */
-export async function listWorktrees(repo, agent = nodeGitRunner()) {
-    try {
-        return parseWorktreeList(await agent(['worktree', 'list', '--porcelain'], repo));
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Parse `git worktree list --porcelain`: blank-line-separated records, each with
- * a `worktree <path>` line, a `HEAD <sha>` line, and either `branch refs/heads/...`
- * or `detached`. Extra attributes (bare/locked/prunable) are ignored. Exported so
- * the parsing is unit-testable without a real repo.
- */
-export function parseWorktreeList(porcelain) {
-    const entries = [];
-    for (const block of porcelain.split(/\n\s*\n/)) {
-        let path;
-        let head = '';
-        let branch;
-        for (const line of block.split('\n')) {
-            if (line.startsWith('worktree '))
-                path = line.slice('worktree '.length).trim();
-            else if (line.startsWith('HEAD '))
-                head = line.slice('HEAD '.length).trim();
-            else if (line.startsWith('branch '))
-                branch = line.slice('branch '.length).trim().replace(/^refs\/heads\//, '');
-        }
-        if (path)
-            entries.push({ path, head, ...(branch ? { branch } : {}) });
-    }
-    return entries;
-}
-/**
- * Commit whatever the agent left behind, on the agent's own branch (#786).
- *
- * An agent that edits and stops without committing is behaving as instructed: the
- * system prompt has it commit *pre-existing* changes before it starts, never its own
- * work at the end. Removing that checkout would destroy the diff (the work was never
- * staged, so it is not recoverable from git afterwards), so teardown commits it first
- * and the branch outlives the worktree.
- *
- * Returns whether the checkout is safe to remove: true when it was already clean or
- * the work is now committed, false when the commit failed (no git identity, a hook
- * refusing it). False means keep the checkout, which is the safe direction.
- *
- * Retries before giving up (#1376): the daemon's conversation committer works in the same
- * checkout and is busiest exactly when this runs (session end), so a first attempt can lose
- * an `index.lock` race. That transient loss is how a session's real work got judged
- * "committed nothing" by the handoff while the teardown's identical commit, seconds later,
- * succeeded. A short wait outlasts the committer's hold; a persistent failure (identity,
- * hooks) still comes back false.
- */
-export async function commitPendingWork(path, agent = nodeGitRunner(), retry = {}) {
-    const attempts = Math.max(1, retry.attempts ?? 3);
-    const delayMs = retry.delayMs ?? 300;
-    for (let attempt = 1; attempt <= attempts; attempt++) {
-        try {
-            const status = await agent(['status', '--porcelain'], path);
-            if (!status.trim())
-                return true;
-            await agent(['add', '-A'], path);
-            // Same wording as the install-time safety commit (install.ts), for one vocabulary.
-            await agent(['commit', '-m', '[The Framework] uncommitted changes'], path);
-            return true;
-        }
-        catch {
-            if (attempt < attempts)
-                await new Promise(resolve => setTimeout(resolve, delayMs));
-        }
-    }
-    return false;
-}
-/**
- * Remove an agent's worktree. Tolerant of an already-gone / never-registered path so
- * teardown stays idempotent (the agent child is detached; the daemon only holds its pid).
- *
- * Plain removal first: it refuses a checkout git considers unclean, which after
- * {@link commitPendingWork} means a state we did not anticipate. Falling back to
- * `--force` keeps teardown working (an ignored build artifact must not strand a
- * worktree forever), but it says so, because forcing past unknown state is exactly
- * how uncommitted work got deleted in the first place.
- */
-export async function removeWorktree(repo, path, agent = nodeGitRunner()) {
-    try {
-        await agent(['worktree', 'remove', path], repo);
-        return;
-    }
-    catch {
-        // Unclean by git's reckoning, already removed, or never registered: try forcing.
-    }
-    try {
-        await agent(['worktree', 'remove', '--force', path], repo);
-        console.log(`[framework] forced removal of worktree ${path} (git called it unclean)`);
-    }
-    catch {
-        // Already removed, or never registered: nothing to do.
-    }
-}
-/**
- * Delete a branch that holds nothing (#1650). `-D`, because "merged" in git's eyes is the wrong
- * test: the caller proved the tip is a commit the remote already has, which is the stronger fact.
- * Forgiving: the checkout is already gone by the time this runs, and a branch that would not
- * delete is a leftover name, not lost work.
- */
-export async function deleteBranch(repo, branch, agent = nodeGitRunner()) {
-    await agent(['branch', '-D', branch], repo).catch(() => undefined);
-}
-/**
- * Whether `path` is the root of a git worktree — the main checkout's or a linked one (#1654).
- *
- * Git answers for any directory *inside* a repository, so a `branches/<run>` directory that is
- * no longer a worktree (a checkout removed by hand, a marker written after teardown) makes every
- * git command run in it act on the enclosing repo: the user's own checkout, on the user's own
- * branch. The one question that tells the two apart is whether git's top level is this very
- * directory. False on any failure, and the caller leaves the directory alone.
- */
-export async function isWorktreeRoot(path, agent = nodeGitRunner()) {
-    try {
-        const top = (await agent(['rev-parse', '--show-toplevel'], path)).trim();
-        if (!top)
-            return false;
-        // Both sides resolved: macOS's tmpdir sits behind the /var -> /private/var link, and git
-        // reports the resolved path.
-        return (await realpath(top)) === (await realpath(path));
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * The branch checked out at `path` when `path` is a worktree root (#1654), else `undefined` —
- * the read every consumer of a `branches/<run>` directory wants, so none of them can take the
- * enclosing repo's branch for the run's.
- */
-export async function worktreeBranch(path, agent = nodeGitRunner()) {
-    return (await isWorktreeRoot(path, agent)) ? currentBranch(path, agent) : undefined;
-}
-/**
- * The branch checked out at `path`, or `undefined` when detached / not a repo.
- * Forgiving, like {@link listWorktrees}: callers use it to decide, not to fail.
- */
-export async function currentBranch(path, agent = nodeGitRunner()) {
-    try {
-        const name = (await agent(['rev-parse', '--abbrev-ref', 'HEAD'], path)).trim();
-        return name && name !== 'HEAD' ? name : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Rename an agent's branch once the agent names the session (#736): the worktree is
- * created on `tf-agent-<agentId>` before a name exists, and this puts the
- * readable `tf-<sessionName>` on it.
- *
- * Only renames when `path` is still on `from`. The #326 system prompt currently
- * tells the agent to create and check out its own `tf-<name>` branch,
- * and until that step is dropped there (the prompt ships verbatim from the issue,
- * so it is not ours to edit) the agent may already have moved off `from` — in
- * which case it named the branch itself and there is nothing to rename. Returns
- * whether it renamed, and never throws: an agent must not die over a branch name.
- */
-export async function renameAgentBranch(path, from, to, agent = nodeGitRunner()) {
-    if ((await currentBranch(path, agent)) !== from)
-        return false;
-    try {
-        await agent(['branch', '-m', from, to], path);
-        return true;
-    }
-    catch {
-        // Target name taken, or an invalid slug: keep the run-id branch.
-        return false;
-    }
-}
-/**
- * `git worktree prune`: drop administrative entries for worktree dirs a crash left
- * behind. Never removes a live worktree, so it is always safe. Forgiving.
- */
-export async function pruneWorktrees(repo, agent = nodeGitRunner()) {
-    try {
-        await agent(['worktree', 'prune'], repo);
-    }
-    catch {
-        // Not a repo / nothing to prune: no-op.
-    }
-}
-/** A {@link SizeRunner} over `du -sk`: one process, and it does not follow the symlinked deps (#736). */
-export function nodeSizeRunner() {
-    return path => new Promise((resolvePromise, rejectPromise) => {
-        void import('node:child_process').then(({ execFile }) => {
-            execFile('du', ['-sk', path], { timeout: 5_000 }, (err, stdout) => err ? rejectPromise(err) : resolvePromise(stdout));
-        });
-    });
-}
-/**
- * A worktree's size on disk in bytes, or undefined when it cannot be read (#798). Best-effort by
- * design: this only ever labels a "remove this" button, so a missing number costs nothing while a
- * throw or a hang would cost the panel it sits in. `du` is absent on Windows, which reads as
- * unknown like any other failure.
- */
-export async function worktreeSize(path, agent = nodeSizeRunner()) {
-    try {
-        const kb = Number.parseInt((await agent(path)).trim().split(/\s+/)[0] ?? '', 10);
-        return Number.isFinite(kb) ? kb * 1024 : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Whether a branch is on the remote, with the local tip already there (E5).
- *
- * The one predicate the whole retention story is built on: nothing local is ever the last copy of
- * work, so anything the remote has may be deleted and anything it does not have stays. It replaced
- * three interacting rules — a clean finish removes the checkout, a failure keeps it, a merged
- * branch reclaims it later — each of which asked *what state did this session end in* rather than
- * *is this recoverable*.
- *
- * `git rev-parse` of the remote-tracking ref, then a merge-base check: the ref existing is not
- * enough, because a branch pushed and then committed to again has a tip the remote has never seen.
- * Reads only local refs (no fetch), so it is cheap enough to ask on every teardown — the remote ref
- * is written by the push this is checking for, which is what makes that sound.
- *
- * Anything unreadable answers `false`. A repo with no remote configured therefore keeps every
- * checkout, which is the honest outcome: there is nowhere for the work to be recoverable from.
- */
-export async function branchPushed(repo, branch, agent = nodeGitRunner()) {
-    try {
-        const local = (await agent(['rev-parse', '--verify', `refs/heads/${branch}`], repo)).trim();
-        const remote = (await agent(['rev-parse', '--verify', `refs/remotes/origin/${branch}`], repo)).trim();
-        if (!local || !remote)
-            return false;
-        if (local === remote)
-            return true;
-        // The remote may be ahead (someone pushed on top): what matters is that our tip is in it.
-        await agent(['merge-base', '--is-ancestor', local, remote], repo);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Whether the checkout has nothing uncommitted — the read half of {@link commitPendingWork}, for
- * a decision that must not commit on the way to its answer: removing a publish-nothing session's
- * checkout requires a clean tree, and grabbing someone's half-typed edits as a commit to find
- * that out would be the intrusion the question exists to avoid. Throws when git cannot answer,
- * so the caller keeps the checkout rather than guessing.
- */
-export async function worktreeClean(path, agent = nodeGitRunner()) {
-    return !(await agent(['status', '--porcelain'], path)).trim();
-}
-/**
- * Whether the repo has any remote configured at all. What the sweep asks once per project: with
- * no remote, {@link branchPushed} is false for every checkout and the push cannot land, so the
- * whole per-checkout probe-and-push cycle is doomed before it starts — and that answer cannot
- * change between two rows of the same sweep. Anything unreadable answers `false`, like
- * {@link branchPushed}: keeping a checkout is the safe direction.
- */
-export async function repoHasRemote(repo, agent = nodeGitRunner()) {
-    try {
-        return (await agent(['remote'], repo)).trim().length > 0;
-    }
-    catch {
-        return false;
-    }
-}
-//# sourceMappingURL=worktree.js.map

package/dist/store/worktree.js.map

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

package/dist/subagent-settings.d.ts

@@ -1,27 +0,0 @@
-import { type DriverName } from './driver-names.js';
-/**
- * The person's subagent settings (#1902), node-free so the daemon and the dashboard bundle share
- * one copy: the coding agent and model a main agent's subagents run on, by how hard their task is,
- * and how many of one main agent's subagents run at once. They are the orchestration package's, in
- * its file at each project's root, written through each project's `subagents` line; the dashboard
- * reads the file by its name and runs no tool. A level left out runs on the main agent's own coding
- * agent and model, and a limit left out is the package's own, {@link DEFAULT_AT_ONCE}.
- */
-/** The file the settings are kept in, at a project's root; this machine's, hidden from git by the package. */
-export declare const SUBAGENT_SETTINGS_FILE = ".orchestration/settings.json";
-/** How many of one main agent's subagents run at once when nobody said: the orchestration package's default. */
-export declare const DEFAULT_AT_ONCE = 4;
-/** A coding agent and, when one is picked, its model; no model is that coding agent's own default. */
-export interface SubagentRunner {
-    driver: DriverName;
-    model?: string;
-}
-export interface SubagentSettings {
-    simple?: SubagentRunner;
-    hard?: SubagentRunner;
-    atOnce?: number;
-}
-export declare const SUBAGENT_LEVELS: readonly ['simple', 'hard'];
-/** The settings in `value`, each field kept only when it has the shape the file promises. */
-export declare function subagentSettingsIn(value: unknown): SubagentSettings;
-//# sourceMappingURL=subagent-settings.d.ts.map

package/dist/subagent-settings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"subagent-settings.d.ts","sourceRoot":"","sources":["../src/subagent-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAEjE;;;;;;;GAOG;AAEH,8GAA8G;AAC9G,eAAO,MAAM,sBAAsB,iCAAiC,CAAA;AAEpE,gHAAgH;AAChH,eAAO,MAAM,eAAe,IAAI,CAAA;AAEhC,sGAAsG;AACtG,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,eAAe,YAAI,QAAQ,EAAE,MAAM,CAAU,CAAA;AAE1D,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAcnE"}

package/dist/subagent-settings.js

@@ -1,35 +0,0 @@
-import { isDriverName } from './driver-names.js';
-/**
- * The person's subagent settings (#1902), node-free so the daemon and the dashboard bundle share
- * one copy: the coding agent and model a main agent's subagents run on, by how hard their task is,
- * and how many of one main agent's subagents run at once. They are the orchestration package's, in
- * its file at each project's root, written through each project's `subagents` line; the dashboard
- * reads the file by its name and runs no tool. A level left out runs on the main agent's own coding
- * agent and model, and a limit left out is the package's own, {@link DEFAULT_AT_ONCE}.
- */
-/** The file the settings are kept in, at a project's root; this machine's, hidden from git by the package. */
-export const SUBAGENT_SETTINGS_FILE = '.orchestration/settings.json';
-/** How many of one main agent's subagents run at once when nobody said: the orchestration package's default. */
-export const DEFAULT_AT_ONCE = 4;
-export const SUBAGENT_LEVELS = ['simple', 'hard'];
-/** The settings in `value`, each field kept only when it has the shape the file promises. */
-export function subagentSettingsIn(value) {
-    if (!value || typeof value !== 'object' || Array.isArray(value))
-        return {};
-    const given = value;
-    const settings = {};
-    for (const level of SUBAGENT_LEVELS) {
-        const runner = given[level];
-        if (!runner || typeof runner !== 'object')
-            continue;
-        const { driver, model } = runner;
-        if (typeof driver !== 'string' || !isDriverName(driver))
-            continue;
-        settings[level] = { driver, ...(typeof model === 'string' && model.trim() ? { model: model.trim() } : {}) };
-    }
-    const atOnce = given['atOnce'];
-    if (typeof atOnce === 'number' && Number.isInteger(atOnce) && atOnce >= 1)
-        settings.atOnce = atOnce;
-    return settings;
-}
-//# sourceMappingURL=subagent-settings.js.map

package/dist/subagent-settings.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"subagent-settings.js","sourceRoot":"","sources":["../src/subagent-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmB,MAAM,mBAAmB,CAAA;AAEjE;;;;;;;GAOG;AAEH,8GAA8G;AAC9G,MAAM,CAAC,MAAM,sBAAsB,GAAG,8BAA8B,CAAA;AAEpE,gHAAgH;AAChH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAchC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAU,CAAA;AAE1D,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1E,MAAM,KAAK,GAAG,KAAgC,CAAA;IAC9C,MAAM,QAAQ,GAAqB,EAAE,CAAA;IACrC,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAC3B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,SAAQ;QACnD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAiC,CAAA;QAC3D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;YAAE,SAAQ;QACjE,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAA;IAC7G,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;IAC9B,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAA;IACnG,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/system-prompt-file.d.ts

@@ -1,18 +0,0 @@
-/**
- * Reading the user's own `SYSTEM.md` off disk — the one Node-bound half of the
- * system prompt, kept apart from the composition itself (#520).
- *
- * The split is what lets the dashboard render the prompt in the browser: a
- * bundler that reaches `system-prompt.ts` must not find `node:fs` behind it, and
- * `client.ts` promises exactly that. Everything here takes a `dir` and hands back
- * a string, which the pure side takes as plain input.
- */
-/** The user's system prompt file, read from the workspace root. */
-export declare const SYSTEM_PROMPT_FILE = "SYSTEM.md";
-/**
- * Read the user's system prompt from {@link SYSTEM_PROMPT_FILE} at the workspace
- * root. Returns `undefined` when the file is absent or empty, so the caller falls
- * back to the built-in default alone.
- */
-export declare function loadUserSystemPrompt(dir: string, file?: string): Promise<string | undefined>;
-//# sourceMappingURL=system-prompt-file.d.ts.map

package/dist/system-prompt-file.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"system-prompt-file.d.ts","sourceRoot":"","sources":["../src/system-prompt-file.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,mEAAmE;AACnE,eAAO,MAAM,kBAAkB,cAAc,CAAA;AAE7C;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAA2B,GAChC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7B"}

package/dist/system-prompt-file.js

@@ -1,28 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-/**
- * Reading the user's own `SYSTEM.md` off disk — the one Node-bound half of the
- * system prompt, kept apart from the composition itself (#520).
- *
- * The split is what lets the dashboard render the prompt in the browser: a
- * bundler that reaches `system-prompt.ts` must not find `node:fs` behind it, and
- * `client.ts` promises exactly that. Everything here takes a `dir` and hands back
- * a string, which the pure side takes as plain input.
- */
-/** The user's system prompt file, read from the workspace root. */
-export const SYSTEM_PROMPT_FILE = 'SYSTEM.md';
-/**
- * Read the user's system prompt from {@link SYSTEM_PROMPT_FILE} at the workspace
- * root. Returns `undefined` when the file is absent or empty, so the caller falls
- * back to the built-in default alone.
- */
-export async function loadUserSystemPrompt(dir, file = SYSTEM_PROMPT_FILE) {
-    try {
-        const content = (await readFile(join(dir, file), 'utf8')).trim();
-        return content || undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-//# sourceMappingURL=system-prompt-file.js.map

package/dist/system-prompt-file.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"system-prompt-file.js","sourceRoot":"","sources":["../src/system-prompt-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC;;;;;;;;GAQG;AAEH,mEAAmE;AACnE,MAAM,CAAC,MAAM,kBAAkB,GAAG,WAAW,CAAA;AAE7C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAW,EACX,IAAI,GAAW,kBAAkB;IAEjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;QAChE,OAAO,OAAO,IAAI,SAAS,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/system-prompt.d.ts

@@ -1,148 +0,0 @@
-/**
- * The system prompt (#326), verbatim, as a template. It supersedes the
- * anti-lazy-pill (#297/#301) it grew out of: the prompt is analyzed first — an
- * ambiguous one becomes a ranked `showChoices()` list, a
- * large scope becomes a PLAN file to approve, a very large one also spins off a TODO
- * backlog (#323), the work moves onto its own
- * `agent-<session>` branch before the first change, and the alternatives flow
- * rates problem "variability" before code is written.
- *
- * Two layers make it executable:
- * - `${{ ... }}` fragments are JS evaluated against a {@link TfContext} (#350).
- * - The trailing `# User prompt` section is the user-prompt slot; use
- *   {@link renderSystemPrompt} to render and split the two halves.
- *
- * The `<SHOW_*>` / `<AWAIT>` macros are interpreted by the agent itself (Rom's
- * call on #326); the await protocol (#337/#339) pins how the stop-signal is
- * emitted so the turn-boundary gates can detect it.
- *
- * The text lives in `prompts/system_prompt.md` (#551), not here. It is Rom's living
- * doc: change it on #326 first, then sync the markdown.
- */
-export declare const SYSTEM_PROMPT_TEMPLATE = "# System prompt\n\nSHOW_MD: Show it via `showMarkdown()`\nSHOW_CHOICES: Show it via `showChoices()`\nAWAIT: Stop, await user answer before resuming\nSESSION_NAME: the name of the session\nTODO_FILE: the agent queue, `TODO_AGENTS.md` \u2014 add an entry with `queue add \"<entry>\" --priority <N>` from the `queue` skill\n\n## Analyze the user prompt\n\nAnalyze the user prompt and follow the instructions below.\n\n### Ambiguous prompt\n\nIf it isn't clear what you should do (e.g. unclear scope, unclear user prompt), make a list of interpretations sorted by plausibility, <SHOW_CHOICES>, <AWAIT>\n\n### Scope\n\n- If the scope of what you'll work on is *large*, create a `PLAN_<SESSION_NAME>.agent.md` of what you'll work on, <SHOW_MD>, <AWAIT>\n- If the scope is potentially *very large* (e.g. spans over many hours/days of work), consider adding entries to <TODO_FILE> (backlog of follow-up tasks) and show new entries <SHOW_MD>\n\n\n## Before starting changes\n\nDo the following before applying your first change.\n\n### Session name\n\n1. Create a <SESSION_NAME> as a string [a-z0-9-]+ that succinctly represents the intention of the user prompt\n2. Name your branch after it: use the `branches` skill, which says how. Where that skill is not available, the \"Branch management\" section below says how instead. If the name you end up with differs, that is your <SESSION_NAME> from now on\n\n\n## Before applying changes\n\nDo the following before applying changes \u2014 do it again anytime you make new changes.\n\n### Alternatives\n\nMeasure \"variability\":\n- List all high-level problems that you're about to solve\n- Give a rating to each problem (from 0 to 10) following this criteria: is there an obviously optimal way to solve the problem (10), or is it highly unclear whether the problem can be solved in a better way (0)?\n- Explore and suggest alternatives for problems with a low rating\n- For each problem that has alternatives: list all alternatives sorted in a sensible order, <SHOW_CHOICES>, <AWAIT>\n\n\n## After applying changes\n\nAfter you're done, decide: is <SESSION_NAME> finished, with no work left to do?\n- Yes: call setReadyForMerge() \u2014 required, the work is never merged without it\n- No: don't call it; say what's left instead\n\n\n\n# User prompt\n\n${{tf.prompt}}";
-/**
- * The `tf` context the templates' `${{...}}` fragments read (#326/#350). One shape across
- * the prompts; each reads the subset it needs. `session_name` is the on-before-mergeable
- * prompt's (#556), and is snake_case because the doc writes it that way.
- */
-export interface TfContext {
-    /** The user's prompt (the session's intent, or the typed prompt): fills `${{tf.prompt}}`. */
-    prompt: string;
-    /**
-     * The session name, read off the agent's branch (#1725) once it named it. Only the
-     * on-before-mergeable prompt reads it, never the system prompt: the name exists before the agent
-     * makes changes and is read afterwards, so it is not chicken-and-egg.
-     */
-    session_name?: string | undefined;
-}
-/** A project-context document: a repo-root path and the one-line gloss shown beside it (#559). */
-export interface ContextDoc {
-    path: string;
-    comment: string;
-}
-/**
- * The business-knowledge docs (#537): what the repo has learned about itself, which the
- * agent both reads at the start of an agent and folds new knowledge back into at merge. The
- * on-before-mergeable prompt's `## Business knowledge` section names this exact set, so the
- * agent is never told to read one set of files and update another (pinned by a test). A
- * subset of {@link CONTEXT_DOCS}.
- */
-export declare const BUSINESS_KNOWLEDGE_DOCS: readonly ContextDoc[];
-/**
- * Everything the agent keeps in context when it starts (#683), which
- * {@link systemPromptBlock} renders as the `Context:` bullets. A superset of
- * {@link BUSINESS_KNOWLEDGE_DOCS}: it adds `GOAL.md`, `BUSINESS_LOGIC.md`, and the
- * roadmap/queue pointers the agent reads but does *not* fold knowledge back into — the tickets
- * (the potential work, the `tickets` skill's) and the agent queue (the `queue` skill's) (#1748):
- * they live on the `agent-data` branch, and each skill says how to read and change its own and
- * what the format is.
- * Repo-root paths, because that is the agent's cwd. README is left out: a repo's own `README.md`
- * already covers the overview.
- */
-export declare const CONTEXT_DOCS: readonly ContextDoc[];
-/** The two halves of the rendered {@link SYSTEM_PROMPT_TEMPLATE}. */
-export interface RenderedSystemPrompt {
-    /** The `# System prompt` half: frames the session's system channel. */
-    system: string;
-    /** The `# User prompt` half: the rendered user-prompt slot (`${{tf.prompt}}` plus any framing Rom adds around it). */
-    user: string;
-}
-/**
- * Render the built-in system prompt against a {@link TfContext} and split it at
- * the `# User prompt` heading. The split happens on the *template*, before
- * rendering, so a user prompt that itself contains the heading can never move
- * the boundary.
- */
-export declare function renderSystemPrompt(tf?: TfContext): RenderedSystemPrompt;
-/** Inputs to {@link systemPromptBlock}. */
-export interface SystemPromptOptions {
-    /** Remove the built-in #326 system prompt. Default `false` — it is included. */
-    vanilla?: boolean | undefined;
-    /** The user's own system prompt (e.g. from `SYSTEM.md`), injected after the built-in one. */
-    user?: string | undefined;
-    /** Context for the template's `${{...}}` fragments. Default: {@link DEFAULT_TF}. */
-    tf?: TfContext | undefined;
-    /**
-     * Directories the user picked as in-context (#439/#314). The agent can reach every
-     * registered repo, so this narrows its focus: it prepends one `Context: <dirs>` line to
-     * the block. Empty/absent adds nothing.
-     */
-    context?: readonly string[] | undefined;
-    /**
-     * Transparent mode (#625): drop *everything* framework-authored from the system channel —
-     * the built-in prompt, the knowledge docs, AND the emit protocols — so the agent receives an
-     * empty system channel, byte-identical to raw `claude -p <prompt>`. This is stronger than
-     * `--vanilla` (which keeps the AWAIT/SIGNAL emit contract so the agent can still drive the
-     * dashboard's gates); transparent means there is no framework behavior left to signal to.
-     * Short-circuits {@link composeAgentSystem}, so it overrides every other option here.
-     */
-    transparent?: boolean | undefined;
-    /**
-     * This agent has a real browser attached (#824). Adds the section telling the agent so: the
-     * tools are wired through MCP, which the agent discovers, but nothing otherwise says to prefer
-     * them — so it reaches for `WebFetch`, and the browser (and its preview) sits unused.
-     */
-    browser?: boolean | undefined;
-    /**
-     * This agent hands off to a remote session whose workspace nothing local sees (#1231), so it
-     * has to land its own work: appends {@link HANDS_OFF_PROTOCOL}, the commit-and-open-a-PR rule.
-     */
-    handsOff?: boolean | undefined;
-    /**
-     * This agent runs in a checkout The Framework created, with `branches` on its PATH
-     * (#1725) — a daemon-started agent on this machine. It gets the `branches` skill; any
-     * other agent (a plain terminal run in the user's own checkout, a GitHub Actions runner, a cloud
-     * session) gets the section that has it branch with git itself.
-     */
-    ownedCheckout?: boolean | undefined;
-}
-/**
- * Compose the system-prompt block injected into every prompt: the built-in #326
- * prompt (unless removed) followed by the user's own prompt. Additive, so a repo
- * can keep the built-in *and* add its instructions, remove it and keep only its
- * own, or leave both off. Returns `''` when there is nothing to inject. Only the
- * template's system half lands here; the user-prompt half is the caller's to
- * deliver (see {@link renderSystemPrompt}).
- */
-export declare function systemPromptBlock(opts?: SystemPromptOptions): string;
-/** Inputs to {@link composeAgentSystem}. */
-export type AgentSystemOptions = SystemPromptOptions;
-/**
- * Assemble an agent's full system channel — the single place it is composed (#501), so the
- * build path and the direct-prompt path, before D2 collapsed them into one {@link runAgent}
- * cannot drift. That drift is exactly what dropped the session-action (#326) layer from `--vanilla`
- * builds (#500): the two sites each inlined the composition and one nested the protocols
- * inside the built-in-prompt branch.
- *
- * Order is fixed: the built-in system prompt (#326) block (context / built-in prompt / user SYSTEM.md)
- * first, then the emit protocols. Nothing else is appended — a build agent's system channel
- * is exactly this (#547), which is what lets the dashboard show the whole prompt before an agent
- * starts (#520). The protocols are otherwise unconditional — they are the *emit contract* (how
- * the agent signals an awaited choice and the setReadyForMerge() lifecycle),
- * not prompt content — so the agent needs them even with the built-in prompt off (`--vanilla`).
- *
- * The one exception is transparent mode (#625): there is no framework behavior to signal to, so
- * the whole channel is empty and the agent runs as raw `claude -p`.
- */
-export declare function composeAgentSystem(opts?: AgentSystemOptions): string;
-//# sourceMappingURL=system-prompt.d.ts.map

package/dist/system-prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"system-prompt.d.ts","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,ywEAAgB,CAAA;AAEnD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAClC;AAKD,kGAAkG;AAClG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAQD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,UAAU,EAA6C,CAAA;AAYtG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAiB7C,CAAA;AAED,qEAAqE;AACrE,MAAM,WAAW,oBAAoB;IACnC,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;IACd,sHAAsH;IACtH,IAAI,EAAE,MAAM,CAAA;CACb;AAID;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,GAAE,SAAsB,GAAG,oBAAoB,CAQnF;AAED,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,6FAA6F;IAC7F,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,oFAAoF;IACpF,EAAE,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IACvC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,mBAAwB,GAAG,MAAM,CA4BxE;AAED,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAAG,mBAAmB,CAAA;AAEpD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,kBAAuB,GAAG,MAAM,CAaxE"}