@openagt/dashboard 0.8.0 → 0.10.0

package/dist/merged-worktrees.d.ts

@@ -1,74 +0,0 @@
-import { type RemoveResult, type WorktreeRow } from './worktrees.js';
-import { type ProjectPass, type ProjectsSource } from './project-pass.js';
-/** One worktree this sweep removed. */
-export interface RemovedWorktree {
-    /** The agent id, which is also the worktree's directory name. */
-    agentId: string;
-    /** Branches that went with it: one holding nothing the remote lacks (#1650), a run-id branch the kept branch contains (#1657). */
-    branchesDeleted?: string[];
-}
-/** A worktree the sweep tried to reclaim and could not, and why. */
-export interface FailedRemoval {
-    agentId: string;
-    error: string;
-}
-/** What {@link removeMergedWorktrees} did. */
-export interface MergedSweepResult {
-    removed: RemovedWorktree[];
-    /** Worktrees it tried and could not reclaim — most often a branch it could not push. */
-    failed: FailedRemoval[];
-}
-/** Injectable seams so the sweep is unit-testable off disk. */
-export interface MergedSweepDeps {
-    /** The worktrees on disk (default {@link listProjectWorktrees}). */
-    worktrees?: (cwd: string) => Promise<WorktreeRow[]>;
-    /** Removes one worktree (default {@link removeProjectWorktree}). */
-    remove?: (cwd: string, agentId: string) => Promise<RemoveResult>;
-    /** Whether the repo has a remote at all (default {@link repoHasRemote}). */
-    hasRemote?: (cwd: string) => Promise<boolean>;
-    /** Agent ids whose checkouts the daemon is still responsible for; see {@link MergedSweepOptions.busy}. */
-    busy?: ReadonlySet<string>;
-}
-/**
- * Reclaim every retained worktree in `cwd` whose work can reach the remote (E5).
- *
- * The decision is entirely {@link removeProjectWorktree}'s — keep a dirty checkout, push the
- * branch, remove only once the remote has it — so the automatic path and the manual one (the
- * dashboard's Remove button) are one behaviour rather than two that can disagree. This adds the
- * loop, the one thing it must never touch (a live agent's checkout, where its agent is working), and
- * the agent lock.
- *
- * The lock is load-bearing: an agent's meta flips to `done` a beat before its teardown finishes
- * archiving, so a sweep landing in that window would remove the checkout out from under the
- * archive — which then recreates the directory it was reading from, and the removal silently
- * un-happens. Every other actor on a checkout already takes this lock.
- */
-export declare function removeMergedWorktrees(cwd: string, deps?: MergedSweepDeps): Promise<MergedSweepResult>;
-/** `its branch x` / `its branches x and y`, for the removal line. */
-export declare function describeDeleted(branches: readonly string[]): string;
-/** What {@link startMergedWorktreeSweep} needs from the daemon. */
-export interface MergedSweepOptions {
-    /** The registered projects to sweep. */
-    projects: ProjectsSource;
-    log: (message: string) => void;
-    /**
-     * The agents the daemon is still responsible for — spawning, running, or mid-retirement — whose
-     * checkouts this must not touch.
-     *
-     * "Not live" on disk is not "the daemon is finished with it": an agent's meta flips to `done` a
-     * beat before its teardown archives the history and reclaims the checkout, and a sweep landing
-     * in that window races the teardown for the same directory. Absent means nothing is busy, which
-     * is right for a caller that spawns no agents.
-     */
-    busy?: () => ReadonlySet<string>;
-    /** The per-project sweep (default {@link removeMergedWorktrees}). */
-    sweep?: (cwd: string) => Promise<MergedSweepResult>;
-}
-/**
- * Sweep every registered project's reclaimable worktrees (#1036), one turn per call.
- *
- * Says what it removed rather than removing it silently: a checkout vanishing from under someone
- * with no line explaining why reads as a bug, even when the work behind it is safe.
- */
-export declare function startMergedWorktreeSweep(opts: MergedSweepOptions): ProjectPass;
-//# sourceMappingURL=merged-worktrees.d.ts.map

package/dist/merged-worktrees.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merged-worktrees.d.ts","sourceRoot":"","sources":["../src/merged-worktrees.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjH,OAAO,EAAoB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAmB3F,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAA;IACf,kIAAkI;IAClI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED,oEAAoE;AACpE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,wFAAwF;IACxF,MAAM,EAAE,aAAa,EAAE,CAAA;CACxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;IACnD,oEAAoE;IACpE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAA;IAChE,4EAA4E;IAC5E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7C,0GAA0G;IAC1G,IAAI,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAC3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAyB/G;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAEnE;AAED,mEAAmE;AACnE,MAAM,WAAW,kBAAkB;IACjC,wCAAwC;IACxC,QAAQ,EAAE,cAAc,CAAA;IACxB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,qEAAqE;IACrE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACpD;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,WAAW,CA6B9E"}

package/dist/merged-worktrees.js

@@ -1,84 +0,0 @@
-import { listProjectWorktrees, removeProjectWorktree } from './worktrees.js';
-import { withAgentLock } from './agent-locks.js';
-import { repoHasRemote, worktreePath } from '@gemstack/skill-branches';
-import { startProjectPass } from './project-pass.js';
-/**
- * Reclaim every retained worktree in `cwd` whose work can reach the remote (E5).
- *
- * The decision is entirely {@link removeProjectWorktree}'s — keep a dirty checkout, push the
- * branch, remove only once the remote has it — so the automatic path and the manual one (the
- * dashboard's Remove button) are one behaviour rather than two that can disagree. This adds the
- * loop, the one thing it must never touch (a live agent's checkout, where its agent is working), and
- * the agent lock.
- *
- * The lock is load-bearing: an agent's meta flips to `done` a beat before its teardown finishes
- * archiving, so a sweep landing in that window would remove the checkout out from under the
- * archive — which then recreates the directory it was reading from, and the removal silently
- * un-happens. Every other actor on a checkout already takes this lock.
- */
-export async function removeMergedWorktrees(cwd, deps = {}) {
-    // Sizes off: `du` over every retained checkout is the expensive part of the listing, and a sweep
-    // that only decides removal never reads the number.
-    const worktrees = deps.worktrees ?? ((path) => listProjectWorktrees(path, { sizes: false }));
-    const remove = deps.remove ?? removeProjectWorktree;
-    const hasRemote = deps.hasRemote ?? repoHasRemote;
-    const result = { removed: [], failed: [] };
-    const rows = (await worktrees(cwd).catch(() => [])).filter(row => !row.live && !deps.busy?.has(row.agentId));
-    if (!rows.length)
-        return result;
-    // Asked once per project, not once per checkout: with no remote the rule keeps everything, and
-    // that answer cannot change between two rows of the same sweep — so the doomed per-checkout
-    // probe-and-push cycle is skipped while each retained checkout is still accounted for.
-    if (!(await hasRemote(cwd))) {
-        for (const row of rows)
-            result.failed.push({ agentId: row.agentId, error: 'the repo has no remote; its worktree was kept' });
-        return result;
-    }
-    for (const row of rows) {
-        const outcome = await withAgentLock(worktreePath(cwd, row.agentId), () => remove(cwd, row.agentId));
-        if (outcome.ok)
-            result.removed.push({ agentId: row.agentId, ...(outcome.branchesDeleted ? { branchesDeleted: outcome.branchesDeleted } : {}) });
-        else
-            result.failed.push({ agentId: row.agentId, error: outcome.error });
-    }
-    return result;
-}
-/** `its branch x` / `its branches x and y`, for the removal line. */
-export function describeDeleted(branches) {
-    return branches.length === 1 ? `its branch ${branches[0]}` : `its branches ${branches.join(' and ')}`;
-}
-/**
- * Sweep every registered project's reclaimable worktrees (#1036), one turn per call.
- *
- * Says what it removed rather than removing it silently: a checkout vanishing from under someone
- * with no line explaining why reads as a bug, even when the work behind it is safe.
- */
-export function startMergedWorktreeSweep(opts) {
-    const sweep = opts.sweep ?? ((cwd) => removeMergedWorktrees(cwd, { ...(opts.busy ? { busy: opts.busy() } : {}) }));
-    // Each checkout's last-announced keep reason, so a retained checkout is accounted for once per
-    // *state* rather than re-announced every ten minutes for the life of the daemon — a permanently
-    // unpushable one (no remote, a publish-nothing session) repeats forever. A changed reason is a
-    // changed state and is said again (a remote added, pushes now failing on auth); a removal
-    // clears the entry, so a same-id checkout that reappears is a new thing to account for; a
-    // daemon restart starts the accounting over, which is the boot-time announcement the retained
-    // state deserves.
-    const announced = new Map();
-    // No timer of its own (E4): the daemon's one clock calls `tick`, including once at start-up —
-    // the case this exists for is a machine that was off while the work could not be pushed.
-    return startProjectPass(opts.projects, async (cwd) => {
-        const { removed, failed } = await sweep(cwd).catch(() => ({ removed: [], failed: [] }));
-        for (const item of removed) {
-            announced.delete(item.agentId);
-            opts.log(item.branchesDeleted
-                ? `[framework] removed the worktree for session ${item.agentId} and ${describeDeleted(item.branchesDeleted)}: nothing on it is missing elsewhere. The session is kept.`
-                : `[framework] removed the worktree for session ${item.agentId}: its branch is on the remote. The branch and the session are kept.`);
-        }
-        for (const item of failed) {
-            if (announced.get(item.agentId) === item.error)
-                continue;
-            announced.set(item.agentId, item.error);
-            opts.log(`[framework] kept the worktree for session ${item.agentId}: ${item.error}`);
-        }
-    });
-}
-//# sourceMappingURL=merged-worktrees.js.map

package/dist/merged-worktrees.js.map

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

package/dist/module-types/src/dashboard/agent-tree.d.ts

@@ -1,105 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-import { type BranchesFor } from '../store/index.js';
-import type { Cached } from './cache.js';
-import { type FileGitStatus } from './file-status.js';
-import { type FileDiff } from './file-diff.js';
-import { type FileContent } from './file-read.js';
-import { type LinkedPr } from './pull-requests.js';
-/** Where a run's files are read from, and the commit its changes are measured from (`base`). */
-export type AgentFilesAt = {
-    source: 'checkout';
-    path: string;
-    base?: string;
-} | {
-    source: 'branch';
-    branch: string;
-    ref: string;
-    base?: string;
-} | {
-    source: 'merge';
-    number: number;
-    ref: string;
-    base?: string;
-}
-/** The run changed nothing: the project's default branch, where no path is marked. */
- | {
-    source: 'unchanged';
-    ref: string;
-}
-/** The run's pull request is still being looked up: the next read knows. */
- | {
-    source: 'pending';
-} | {
-    source: 'gone';
-};
-/** One changed path: what changed, and whether it is committed or only on disk in the checkout. */
-export interface FileMark {
-    status: FileGitStatus;
-    committed: boolean;
-}
-/** What the Files tab shows for a run: the tree at its last state, the paths it changed marked. */
-export type AgentTree = {
-    source: 'checkout';
-    files: string[];
-    changes: Record<string, FileMark>;
-} | {
-    source: 'branch';
-    branch: string;
-    files: string[];
-    changes: Record<string, FileMark>;
-} | {
-    source: 'merge';
-    number: number;
-    files: string[];
-    changes: Record<string, FileMark>;
-} | {
-    source: 'unchanged';
-    files: string[];
-    changes: Record<string, FileMark>;
-} | {
-    source: 'pending';
-} | {
-    source: 'gone';
-};
-/** What {@link resolveAgentFiles} reads through; each defaults to the production reader. */
-export interface AgentFilesDeps {
-    git?: GitRunner;
-    branches?: BranchesFor;
-    agent?: (root: string, agentId: string) => Promise<{
-        id: string;
-        status?: string;
-        host?: string;
-        branch?: string;
-        pr?: {
-            number: number;
-        };
-    } | undefined>;
-    /** This machine's name, against the run's `host`. */
-    host?: string;
-    prs?: (root: string, branch: string) => Promise<Cached<LinkedPr[]>>;
-}
-/**
- * Where the run `agentId` of the project at `root` has its files: its checkout, else its recorded
- * branch (local, then origin's copy), else the commit its recorded pull request merged as, else,
- * for a run that finished `done` on this machine with no pull request, the default branch as a
- * run that changed nothing, else gone. A branch the default branch already contains (a true merge) shows no change, so there
- * the merge commit is preferred when this machine has it.
- */
-export declare function resolveAgentFiles(root: string, agentId: string, deps?: AgentFilesDeps): Promise<AgentFilesAt>;
-/**
- * The Files tab's answer for a resolved source. A checkout lists every file git sees in it and
- * marks both what the run committed since it forked and what is on disk uncommitted, the
- * uncommitted mark winning a path marked both: it is what the file is now. A branch or a merge
- * lists the commit's tree and marks what it changed, all committed. A run that changed nothing
- * lists the default branch's tree and marks nothing.
- */
-export declare function readAgentTree(root: string, at: AgentFilesAt, git?: GitRunner): Promise<AgentTree>;
-/**
- * One changed file's diff, from the same source the tree was read from. In a checkout an
- * uncommitted file diffs as it always has (against its last commit); a committed one diffs from
- * the fork point to the checkout's last commit. On a branch or a merge it is the commit's own
- * change. Null for a path that is unsafe or not changed there.
- */
-export declare function readAgentFileDiff(root: string, at: AgentFilesAt, path: string, git?: GitRunner): Promise<FileDiff | null>;
-/** One unchanged file's contents, from the same source the tree was read from. */
-export declare function readAgentFileContent(root: string, at: AgentFilesAt, path: string, git?: GitRunner): Promise<FileContent | null>;

package/dist/module-types/src/dashboard/file-diff.d.ts

@@ -1,66 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-import type { FileGitStatus } from './file-status.js';
-import { safeRepoPath } from './file-read.js';
-export { safeRepoPath };
-/** One file's diff, capped so a hover card can render it. */
-export interface FileDiff {
-    /** The repo-relative path asked for. */
-    path: string;
-    status: FileGitStatus;
-    /** Unified diff body, hunks only (git's `diff --git` / index preamble is dropped). */
-    patch: string;
-    added: number;
-    removed: number;
-    /** The patch hit the preview cap and was cut. */
-    truncated: boolean;
-    /** Nothing textual to show (git reports a binary change, or the file is not UTF-8 text). */
-    binary: boolean;
-}
-/** One changed file in a session's Changes list (#817): what moved, and by how much. */
-export interface FileChange {
-    path: string;
-    status: FileGitStatus;
-    added: number;
-    removed: number;
-    /** Line counts are unavailable (a binary file, or an untracked one too large to count). */
-    binary: boolean;
-}
-/**
- * The diff for one changed file in the checkout at `cwd`, or, given a `range`, between two
- * commits of the repository at `cwd` (a run's committed change, `agent-tree.ts`).
- *
- * Tracked files diff against `HEAD`, not the index, so a change the agent staged still shows;
- * that also matches `git status --porcelain`, which is what dotted the file in the first place.
- * An untracked file is rendered as all-added from its contents, since `git diff --no-index`
- * exits non-zero on a difference and would read as a failure here.
- *
- * Returns null when the path is unsafe, unreadable, or has no diff to show.
- */
-export declare function readFileDiff(cwd: string, path: string, status: FileGitStatus, git?: GitRunner, range?: {
-    from: string;
-    to: string;
-}): Promise<FileDiff | null>;
-/** One `git diff --numstat` line, parsed. */
-export interface NumstatEntry {
-    path: string;
-    added: number;
-    removed: number;
-    binary: boolean;
-}
-/**
- * Parse `git diff --numstat` output: `added<TAB>removed<TAB>path`, with `-` for both counts
- * on a binary file. The one parser for the grammar — it was written here and in run-handoff,
- * and the copies had already drifted on a path containing a tab (this side rejoined it, the
- * other dropped the line).
- */
-export declare function parseNumstat(out: string): NumstatEntry[];
-/**
- * Every changed file in the checkout at `cwd`, with its line counts: the session's Changes list
- * (#817). One `git status` plus one `git diff --numstat`, not a diff per file, so a session that
- * touched forty files still costs two git calls.
- *
- * Untracked files have no numstat entry (they are not in the diff at all), so their added count
- * is their line count, read from disk. Sorted by path, so the list does not reshuffle as a live
- * session edits.
- */
-export declare function readFileChanges(cwd: string, statuses: Record<string, FileGitStatus>, git?: GitRunner): Promise<FileChange[]>;

package/dist/module-types/src/dashboard/file-read.d.ts

@@ -1,41 +0,0 @@
-/** Cap what a hover card renders, whether it is a patch or a file. */
-export declare const MAX_PREVIEW_LINES = 500;
-/** One unchanged file's contents for the tree's hover card (#828). */
-export interface FileContent {
-    /** The repo-relative path asked for. */
-    path: string;
-    /** The file's text, cut at {@link MAX_PREVIEW_LINES}. Empty when binary. */
-    text: string;
-    /** The file was longer than the cap and was cut. */
-    truncated: boolean;
-    /** Not UTF-8 text, so there is nothing to render. */
-    binary: boolean;
-}
-/**
- * Whether a client-supplied path may be read: repo-relative, no traversal, no absolute path, no
- * leading `-` (git would read it as a flag), and never into `.git` (config and credentials live
- * there). Rejecting is the whole contract; the caller resolves it against a checkout it chose.
- */
-export declare function safeRepoPath(path: string): boolean;
-/**
- * Read a repo-relative file from `cwd`, or null when it is unsafe, outside the checkout, or
- * unreadable.
- *
- * The confinement check is a `realpath` on both sides, not a string compare on the resolved path.
- * `resolve` does not follow symlinks, so `src/link.txt -> /etc/passwd` resolves to a path that sits
- * happily under `cwd` and passes a textual check while the read leaves the repo. `realpath` is what
- * makes the containment real; it also normalizes the platform's own links (macOS `/tmp`), which is
- * why `cwd` goes through it too rather than being compared raw.
- */
-export declare function readConfinedFile(cwd: string, path: string): Promise<Buffer | null>;
-/** Cut a body to {@link MAX_PREVIEW_LINES}, reporting whether anything was dropped. */
-export declare function cutToPreview(body: string): {
-    body: string;
-    truncated: boolean;
-};
-/**
- * One unchanged file's contents (#828). Null when the path is unsafe, outside the checkout, or
- * unreadable. A file git has not touched still reads from the resolved checkout, so a session's
- * hover shows its worktree's copy rather than the project root's (#815).
- */
-export declare function readFileContent(cwd: string, path: string): Promise<FileContent | null>;

package/dist/module-types/src/dashboard/file-status.d.ts

@@ -1,20 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-/**
- * The tree's per-file git state. `added` is a file a commit created (a run's committed change,
- * `agent-tree.ts`); the working tree's status here never says it, a new file there is `untracked`.
- */
-export type FileGitStatus = 'untracked' | 'added' | 'modified' | 'deleted';
-/** One `git status --porcelain` line: the two status columns and the path they are about. */
-export interface PorcelainEntry {
-    code: string;
-    /** Repo-relative; a rename resolves to the new path. */
-    path: string;
-}
-/** Parse `git status --porcelain` output. Shared with the handoff's pending-files read (#1173). */
-export declare function parsePorcelain(out: string): PorcelainEntry[];
-/**
- * Read each changed file's status from `git status --porcelain`, keyed by repo-relative path.
- * `??` is untracked, a `D` in either column is deleted, anything else (M/A/R/C…) reads as
- * modified. Renames map to the new path. Returns `{}` when the path is not a git repo.
- */
-export declare function readFileStatuses(cwd: string, git?: GitRunner): Promise<Record<string, FileGitStatus>>;

package/dist/module-types/src/dashboard/scheduler-state.d.ts

@@ -1,72 +0,0 @@
-import type { ProjectSummary } from './projects.js';
-import { type PublishLevel, type PublishPick } from '../publish-levels.js';
-import { type GitHostFor } from '../store/git-host.js';
-/** The file the scheduler keeps its state in, at the project's root; per user, hidden from git by the tool. */
-export declare const SCHEDULER_STATE_FILE = ".agent-scheduler/state.json";
-/** What the last tick decided for one scheduled command, one line for a person. */
-export interface SchedulerDecision {
-    command: string;
-    outcome: string;
-    /** The run's id when the tick started one: the same id the agent's record and checkout carry. */
-    run?: string;
-}
-/** The last tick as the state file remembers it. */
-export interface SchedulerTick {
-    /** ISO timestamp. */
-    at: string;
-    decisions: SchedulerDecision[];
-    /** Why the tick decided nothing, when it could not. */
-    note?: string;
-}
-/** One command of the project's schedule, as the scheduler's last tick read it, with this machine's switch and publish pick. */
-export interface SchedulerCommand {
-    command: string;
-    /** How often at most, as written (`1d`). */
-    every?: string;
-    /** The check, when the line has one. */
-    when?: string;
-    /** Whether it runs on this machine: the machine's switch, else what the line says. */
-    on: boolean;
-    /** How far a run of the command publishes its work, when the line says: `branch`, `pr` or `merge`. A line that says nothing publishes nothing. */
-    publish?: PublishLevel;
-    /** This machine's publish pick for the command, which stands in for the line's level; absent when nobody picked here. */
-    publishPick?: PublishPick;
-}
-/** A project's scheduler as the card shows it. */
-export interface SchedulerState {
-    /** Whether the state file exists and parses: a project without it has no scheduler set up. */
-    present: boolean;
-    /** Whether ticks start agents. */
-    on: boolean;
-    /** Whether the scheduler's process outlives the dashboard that started it. */
-    keepAlive: boolean;
-    /** Whether the scheduler's own process is alive on this machine. */
-    running: boolean;
-    /** The model every run starts on. */
-    model?: string;
-    /** How far past the quota boundary this project's unattended runs may start, in percentage points. */
-    spendOffset?: number;
-    lastTick?: SchedulerTick;
-    /** The schedule's commands with their switches; empty until the scheduler has ticked once with a schedule. */
-    commands: SchedulerCommand[];
-}
-export interface ProjectScheduler extends SchedulerState {
-    projectId: string;
-    projectName: string;
-    /** Whether one of the project's packages provides a git host; without one no pull request can be opened, so a publish pick stops at the branch. */
-    gitHost: boolean;
-}
-/**
- * Read one project's scheduler state. `isAlive` is the process probe; injectable so a test can
- * decide what "running" means without holding a process.
- */
-export declare function readSchedulerState(cwd: string, isAlive?: (pid: number) => boolean): Promise<SchedulerState>;
-/** Every registered project's scheduler, one row per project in registry order, a failing read as not set up. */
-export declare function collectSchedulers(projects: ProjectSummary[], read?: (cwd: string) => Promise<SchedulerState>, gitHost?: GitHostFor): Promise<ProjectScheduler[]>;
-/**
- * The spend offset the usage panel draws (#960), read off the projects' schedulers: the loosest
- * one, since it is the one that lets unattended work spend the furthest; `undefined` when no
- * scheduler names one. The panel's slider writes it back through each project's `offset` hook,
- * so the schedulers agree unless one was set by hand.
- */
-export declare function loosestSpendOffset(states: readonly SchedulerState[]): number | undefined;

package/dist/module-types/src/dashboard/subagent-settings.d.ts

@@ -1,25 +0,0 @@
-import { runSubagentsHook } from '../project-hooks.js';
-import { type SubagentSettings } from '../subagent-settings.js';
-import type { ProjectSummary } from './projects.js';
-/** The settings in force, and how many projects have the line that writes them. */
-export interface SubagentSettingsView {
-    settings: SubagentSettings;
-    /** Projects with a `subagents` line; none means Settings can save nothing. */
-    hooked: number;
-}
-/**
- * The settings of the first project, in registry order, that has the line and a file: Settings
- * writes every project alike, so they differ only where a file was edited by hand.
- */
-export declare function readSubagentSettings(projects: readonly ProjectSummary[]): Promise<SubagentSettingsView>;
-/**
- * Save the settings whole, through the `subagents` line of each project given. Only settings of the
- * promised shape are passed on. A project without the line is skipped; none having it, or a line
- * that fails, is the answer's error, each failing project named.
- */
-export declare function setSubagentSettings(projects: readonly ProjectSummary[], settings: SubagentSettings, run?: typeof runSubagentsHook): Promise<{
-    ok: true;
-} | {
-    ok: false;
-    error: string;
-}>;

package/dist/module-types/src/dashboard-rpc/subagents.d.ts

@@ -1,11 +0,0 @@
-import { type SubagentSettingsView } from '../dashboard/subagent-settings.js';
-import type { SubagentSettings } from '../subagent-settings.js';
-/** The settings in force, and how many projects have the line that writes them. */
-export declare function onSubagentSettings(): Promise<SubagentSettingsView>;
-/** Save the settings whole, through every registered project's `subagents` line. */
-export declare function sendSubagentSettings(settings: SubagentSettings): Promise<{
-    ok: true;
-} | {
-    ok: false;
-    error: string;
-}>;

package/dist/module-types/src/framework-dir.d.ts

@@ -1,10 +0,0 @@
-/**
- * The directory, under a project root, that holds The Framework's own files.
- *
- * Its own module so every reader and writer of the directory (the hooks file, the project's saved
- * prompts, the activation's `.gitignore`, a run's card, diary and inbox) spells it the same way.
- *
- * Nothing of the product's rides on a branch of its own any more: the agent archives are the
- * `logs` skill's runs, on the shared `agent-data` branch that `@openagt/agent-data` names (#1769).
- */
-export declare const THE_FRAMEWORK_DIR = ".the-framework";

package/dist/module-types/src/framework-gitignore.d.ts

@@ -1,11 +0,0 @@
-/**
- * The `.the-framework/.gitignore` (#313): one file, one content, written at install.
- *
- * Everything under `.the-framework/` is this machine's or transient: a run's live files, the
- * hooks file. The lasting records (the runs, the `logs` skill's) live on the data branch
- * (#1582/#1769), so nothing but this file is tracked: main is 100% code.
- */
-/** The `.gitignore` path under `cwd`'s `.the-framework/`. */
-export declare function gitignorePath(cwd: string): string;
-/** The whole file: everything under `.the-framework/` stays out of git (#1582). */
-export declare function frameworkGitignore(): string;

package/dist/module-types/src/subagent-settings.d.ts

@@ -1,26 +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;

package/dist/on-before-mergeable-prompt.d.ts

@@ -1,32 +0,0 @@
-/**
- * The on-before-mergeable prompt (#326), in `prompts/on_before_mergeable_prompt.md` (#551).
- *
- * It does not *run* the quality presets, it *queues* them: one agent turn that appends
- * "Apply <preset filePath> with tf.params.what set to ..." entries to the project's queue
- * file (`TODO_AGENTS.md`), which a later drain picks up. That is the whole point of
- * #556 — the previous suite executed maintainability, readability and security-audit as
- * three child runs on the spot, which does not compose with the queue.
- *
- * The markdown is the prompt, verbatim: it is compiled into the package at build time and
- * used as it is written, so what a reviewer reads in `prompts/` is what an agent is sent.
- *
- * Two sections: `## Maintenance` queues the quality presets, and `## Business knowledge`
- * (#537) asks the agent to fold what it learned back into {@link BUSINESS_KNOWLEDGE_DOCS}.
- */
-export declare const ON_BEFORE_MERGEABLE_PROMPT_TEMPLATE = "TODO_FILE: the agent queue, `TODO_AGENTS.md` \u2014 add an entry with `queue add \"<entry>\"` from the `queue` skill\n\n## Maintenance\n\nIf the changes introduced by ${{ tf.session_name }} aren't trivial and have refactor potential, add the following to <TODO_FILE>\n- `Apply ${{ tf.presets.maintainability.filePath }} with tf.params.what set to \"changes introduced by ${{ tf.session_name }}\"`\nIf the changes introduced by ${{ tf.session_name }} can potentially lead to security issues, add the following to <TODO_FILE>\n- `Apply ${{ tf.presets.security_audit.filePath }} with tf.params.what set to \"changes introduced by ${{ tf.session_name }}\"`\n\n\n## Business knowledge\n\nIf you didn't already, consider updating the following based on the changes and discussions of ${{ tf.session_name }} (you can create the files if they're missing):\n- `knowledge-base/DECISIONS.md` (decisions taken, and why)\n- `knowledge-base/FACTS.md` (non-obvious facts relevant to the project)\n- `knowledge-base/INSIGHTS.md` (insights relevant to the project)\n\nOnly write what a future agent would need and cannot get from the code itself.";
-/** What the on-before-mergeable prompt's fragments read. */
-export interface OnBeforeMergeableContext {
-    /** The finished agent's session name, read off its branch (#1725). Every line of the prompt names it. */
-    session_name: string;
-    /**
-     * The materialized presets, stem -> `{ filePath }` (#326). The `## Maintenance` entries carry
-     * `tf.presets.<name>.filePath` so the picked-up agent opens the real preset file. Defaulted
-     * from {@link presetContext}, so callers get the standard `.the-framework/presets/*.md` paths.
-     */
-    presets?: Record<string, {
-        filePath: string;
-    }>;
-}
-/** Render the on-before-mergeable prompt for a finished session. */
-export declare function renderOnBeforeMergeablePrompt(tf: OnBeforeMergeableContext): string;
-//# sourceMappingURL=on-before-mergeable-prompt.d.ts.map

package/dist/on-before-mergeable-prompt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"on-before-mergeable-prompt.d.ts","sourceRoot":"","sources":["../src/on-before-mergeable-prompt.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mCAAmC,8mCAA6B,CAAA;AAE7E,4DAA4D;AAC5D,MAAM,WAAW,wBAAwB;IACvC,yGAAyG;IACzG,YAAY,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAC/C;AAED,oEAAoE;AACpE,wBAAgB,6BAA6B,CAAC,EAAE,EAAE,wBAAwB,GAAG,MAAM,CAIlF"}

package/dist/on-before-mergeable-prompt.js

@@ -1,26 +0,0 @@
-import { renderTemplate } from './prompt-template.js';
-import { ON_BEFORE_MERGEABLE_PROMPT } from './prompts.generated.js';
-import { presetContext } from './presets.js';
-/**
- * The on-before-mergeable prompt (#326), in `prompts/on_before_mergeable_prompt.md` (#551).
- *
- * It does not *run* the quality presets, it *queues* them: one agent turn that appends
- * "Apply <preset filePath> with tf.params.what set to ..." entries to the project's queue
- * file (`TODO_AGENTS.md`), which a later drain picks up. That is the whole point of
- * #556 — the previous suite executed maintainability, readability and security-audit as
- * three child runs on the spot, which does not compose with the queue.
- *
- * The markdown is the prompt, verbatim: it is compiled into the package at build time and
- * used as it is written, so what a reviewer reads in `prompts/` is what an agent is sent.
- *
- * Two sections: `## Maintenance` queues the quality presets, and `## Business knowledge`
- * (#537) asks the agent to fold what it learned back into {@link BUSINESS_KNOWLEDGE_DOCS}.
- */
-export const ON_BEFORE_MERGEABLE_PROMPT_TEMPLATE = ON_BEFORE_MERGEABLE_PROMPT;
-/** Render the on-before-mergeable prompt for a finished session. */
-export function renderOnBeforeMergeablePrompt(tf) {
-    return renderTemplate(ON_BEFORE_MERGEABLE_PROMPT_TEMPLATE, {
-        tf: { ...tf, presets: tf.presets ?? presetContext() },
-    });
-}
-//# sourceMappingURL=on-before-mergeable-prompt.js.map

package/dist/on-before-mergeable-prompt.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"on-before-mergeable-prompt.js","sourceRoot":"","sources":["../src/on-before-mergeable-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,0BAA0B,CAAA;AAc7E,oEAAoE;AACpE,MAAM,UAAU,6BAA6B,CAAC,EAA4B;IACxE,OAAO,cAAc,CAAC,mCAAmC,EAAE;QACzD,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,IAAI,aAAa,EAAE,EAAE;KACtD,CAAC,CAAA;AACJ,CAAC"}