@openagt/dashboard 0.8.0 → 0.10.0

package/dist/layout.js

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

package/dist/layout.js.map

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

package/dist/logs.d.ts

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

package/dist/logs.d.ts.map

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

package/dist/logs.js

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

package/dist/logs.js.map

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

package/dist/maintenance.d.ts

@@ -1,90 +0,0 @@
-import { type GitRunner } from '@gemstack/agent-data';
-/** What a repo's last maintenance review recorded. */
-export interface MaintenanceState {
-    /** The HEAD commit the maintenance loop last reviewed (a full SHA). */
-    reviewedSha?: string;
-    /** ISO timestamp of that review. */
-    reviewedAt?: string;
-}
-/** Minimal fs seam so the state IO is unit-testable without touching disk. */
-export interface MaintenanceFs {
-    read(path: string): Promise<string>;
-    write(path: string, contents: string): Promise<void>;
-    mkdir(path: string): Promise<void>;
-}
-/** The review-state file path for a repo. */
-export declare function maintenanceStatePath(cwd: string): string;
-/** Read a repo's review state. Forgiving: a missing/unreadable/malformed file yields `{}`. */
-export declare function readMaintenanceState(cwd: string, fs?: MaintenanceFs): Promise<MaintenanceState>;
-/** Record a repo's review state, creating `.the-framework/` as needed. */
-export declare function writeMaintenanceState(cwd: string, state: MaintenanceState, fs?: MaintenanceFs): Promise<void>;
-/**
- * Record part of a repo's state, leaving the keys not mentioned alone: {@link writeMaintenanceState}
- * replaces the file wholesale, and a caller that knows only the part it changed must not erase the
- * rest.
- */
-export declare function mergeMaintenanceState(cwd: string, patch: MaintenanceState, fs?: MaintenanceFs): Promise<void>;
-/** What the sweep decided for one repo. */
-export type MaintenanceAction = 'baseline' | 'review' | 'skip' | 'error';
-/** A repo's assessed maintenance status. */
-export interface RepoReview {
-    /** Registry id, when assessed from the registry. */
-    id?: string;
-    /** Absolute repo path. */
-    path: string;
-    /** Current HEAD SHA, when resolvable. */
-    headSha?: string;
-    /** The last-reviewed SHA, when the repo has been reviewed before. */
-    reviewedSha?: string;
-    /** Commits in `reviewedSha..HEAD` (0 for a first-seen or up-to-date repo). */
-    newCommits: number;
-    /** What to do: baseline a first-seen repo, review new commits, skip an up-to-date one, or an error. */
-    action: MaintenanceAction;
-    /** Context for an `error` or an unusual `review` (e.g. rewritten history). */
-    note?: string;
-}
-/**
- * Assess one repo: resolve HEAD, read its review state, and count the commits since
- * the last review. A never-reviewed repo is `baseline` (we record HEAD without
- * reviewing history retroactively); an unchanged repo is `skip`; new commits are
- * `review`. A non-repo / missing git is `error` (skipped, never throws). A reviewed
- * SHA git no longer knows (rebased away) falls back to `review`.
- */
-export declare function assessRepo(path: string, git?: GitRunner, fs?: MaintenanceFs): Promise<RepoReview>;
-/** Assess every registered repo, tagging each review with its registry id. */
-export declare function planMaintenanceSweep(repos: readonly {
-    id?: string;
-    path: string;
-}[], git?: GitRunner, fs?: MaintenanceFs): Promise<RepoReview[]>;
-/** The tally a sweep returns. */
-export interface SweepSummary {
-    reviewed: number;
-    baselined: number;
-    skipped: number;
-    failed: number;
-    /** Repos not reached because `maxRepos` was hit. */
-    pending: number;
-}
-/** Injected effects for {@link maintainSweep}, so the orchestration is testable off disk/process. */
-export interface SweepDeps {
-    /** Run the maintenance loop on a repo; resolves true on success. */
-    agent(review: RepoReview): Promise<boolean>;
-    /** Persist a repo's review state (called after a baseline or a successful review). */
-    record(path: string, state: MaintenanceState): Promise<void>;
-    /** Progress line. */
-    log(message: string): void;
-    /** ISO timestamp for a recorded review (injected so runs are deterministic in tests). */
-    now(): string;
-    /** Stop after reviewing this many repos in one sweep (baselines/skips don't count). */
-    maxRepos?: number;
-}
-/**
- * Orchestrate a sweep over pre-assessed reviews: baseline first-seen repos (record
- * HEAD, no run), skip up-to-date ones, and run the maintenance loop on the rest —
- * recording the reviewed SHA only when the agent succeeds, so a failure is retried next
- * sweep. Honors `maxRepos`; the remainder is reported as `pending`.
- */
-export declare function maintainSweep(reviews: readonly RepoReview[], deps: SweepDeps): Promise<SweepSummary>;
-/** Short SHA for logs. */
-export declare function short(sha: string | undefined): string;
-//# sourceMappingURL=maintenance.d.ts.map

package/dist/maintenance.d.ts.map

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

package/dist/maintenance.js

@@ -1,141 +0,0 @@
-import { join } from 'node:path';
-import { nodeGitRunner } from '@gemstack/agent-data';
-import { THE_FRAMEWORK_DIR } from './framework-dir.js';
-import { nodeFs } from './node-fs.js';
-/**
- * The maintenance sweep (#298): a background job that walks the registered repos,
- * finds the commits each repo has grown since its last maintenance review, and runs
- * the maintainability loop on them. Per-repo review state is a small local file
- * (`.the-framework/maintenance.json`, gitignored) recording the last-reviewed commit,
- * so a sweep only ever acts on new work. The capacity gate is the quota boundary, which
- * decides whether unattended work may start. #298's "check the limit" half is reachable — the agent
- * reports the account's quota per turn (#517) and on demand (#521) — but this sweep
- * does not gate on it yet; that is #519's consumption limits.
- */
-/** The per-repo review-state filename under `.the-framework/`. */
-const MAINTENANCE_FILE = 'maintenance.json';
-/** A {@link MaintenanceFs} backed by `node:fs/promises`. See {@link nodeFs}. */
-function nodeMaintenanceFs() {
-    const { read, write, mkdir } = nodeFs();
-    return { read, write, mkdir };
-}
-/** The review-state file path for a repo. */
-export function maintenanceStatePath(cwd) {
-    return join(cwd, THE_FRAMEWORK_DIR, MAINTENANCE_FILE);
-}
-/** Read a repo's review state. Forgiving: a missing/unreadable/malformed file yields `{}`. */
-export async function readMaintenanceState(cwd, fs = nodeMaintenanceFs()) {
-    try {
-        const parsed = JSON.parse(await fs.read(maintenanceStatePath(cwd)));
-        if (parsed && typeof parsed === 'object') {
-            const record = parsed;
-            const state = {};
-            if (typeof record['reviewedSha'] === 'string')
-                state.reviewedSha = record['reviewedSha'];
-            if (typeof record['reviewedAt'] === 'string')
-                state.reviewedAt = record['reviewedAt'];
-            return state;
-        }
-    }
-    catch {
-        // absent / unreadable / malformed -> no prior review
-    }
-    return {};
-}
-/** Record a repo's review state, creating `.the-framework/` as needed. */
-export async function writeMaintenanceState(cwd, state, fs = nodeMaintenanceFs()) {
-    await fs.mkdir(join(cwd, THE_FRAMEWORK_DIR));
-    await fs.write(maintenanceStatePath(cwd), JSON.stringify(state, null, 2));
-}
-/**
- * Record part of a repo's state, leaving the keys not mentioned alone: {@link writeMaintenanceState}
- * replaces the file wholesale, and a caller that knows only the part it changed must not erase the
- * rest.
- */
-export async function mergeMaintenanceState(cwd, patch, fs = nodeMaintenanceFs()) {
-    await writeMaintenanceState(cwd, { ...(await readMaintenanceState(cwd, fs)), ...patch }, fs);
-}
-/**
- * Assess one repo: resolve HEAD, read its review state, and count the commits since
- * the last review. A never-reviewed repo is `baseline` (we record HEAD without
- * reviewing history retroactively); an unchanged repo is `skip`; new commits are
- * `review`. A non-repo / missing git is `error` (skipped, never throws). A reviewed
- * SHA git no longer knows (rebased away) falls back to `review`.
- */
-export async function assessRepo(path, git = nodeGitRunner(), fs = nodeMaintenanceFs()) {
-    let headSha;
-    try {
-        headSha = (await git(['rev-parse', 'HEAD'], path)).trim();
-    }
-    catch {
-        return { path, newCommits: 0, action: 'error', note: 'not a git repo, or it has no commits' };
-    }
-    const { reviewedSha } = await readMaintenanceState(path, fs);
-    if (!reviewedSha)
-        return { path, headSha, newCommits: 0, action: 'baseline' };
-    if (reviewedSha === headSha)
-        return { path, headSha, reviewedSha, newCommits: 0, action: 'skip' };
-    try {
-        const count = Number.parseInt((await git(['rev-list', '--count', `${reviewedSha}..HEAD`], path)).trim(), 10);
-        const newCommits = Number.isFinite(count) ? count : 0;
-        return { path, headSha, reviewedSha, newCommits, action: newCommits > 0 ? 'review' : 'skip' };
-    }
-    catch {
-        // The reviewed commit is unknown to git (history was rewritten): re-review to be safe.
-        return { path, headSha, reviewedSha, newCommits: 0, action: 'review', note: 'reviewed commit not found (history changed); re-reviewing' };
-    }
-}
-/** Assess every registered repo, tagging each review with its registry id. */
-export async function planMaintenanceSweep(repos, git = nodeGitRunner(), fs = nodeMaintenanceFs()) {
-    return Promise.all(repos.map(async (repo) => ({ ...(await assessRepo(repo.path, git, fs)), ...(repo.id ? { id: repo.id } : {}) })));
-}
-/**
- * Orchestrate a sweep over pre-assessed reviews: baseline first-seen repos (record
- * HEAD, no run), skip up-to-date ones, and run the maintenance loop on the rest —
- * recording the reviewed SHA only when the agent succeeds, so a failure is retried next
- * sweep. Honors `maxRepos`; the remainder is reported as `pending`.
- */
-export async function maintainSweep(reviews, deps) {
-    const summary = { reviewed: 0, baselined: 0, skipped: 0, failed: 0, pending: 0 };
-    const limit = deps.maxRepos ?? Infinity;
-    for (const review of reviews) {
-        if (review.action === 'skip') {
-            summary.skipped++;
-            continue;
-        }
-        if (review.action === 'error') {
-            summary.failed++;
-            deps.log(`✗ ${review.path}: ${review.note ?? 'could not assess'}`);
-            continue;
-        }
-        if (review.action === 'baseline') {
-            if (review.headSha)
-                await deps.record(review.path, { reviewedSha: review.headSha, reviewedAt: deps.now() });
-            summary.baselined++;
-            deps.log(`◆ baselined ${review.path} at ${short(review.headSha)}`);
-            continue;
-        }
-        // action === 'review'
-        if (summary.reviewed >= limit) {
-            summary.pending++;
-            continue;
-        }
-        deps.log(`▶ maintaining ${review.path} (${review.newCommits} new commit${review.newCommits === 1 ? '' : 's'})…`);
-        const ok = await deps.agent(review);
-        if (ok && review.headSha) {
-            await deps.record(review.path, { reviewedSha: review.headSha, reviewedAt: deps.now() });
-            summary.reviewed++;
-            deps.log(`✓ ${review.path} reviewed`);
-        }
-        else {
-            summary.failed++;
-            deps.log(`✗ ${review.path} maintenance session failed; will retry next sweep`);
-        }
-    }
-    return summary;
-}
-/** Short SHA for logs. */
-export function short(sha) {
-    return sha ? sha.slice(0, 7) : '(unknown)';
-}
-//# sourceMappingURL=maintenance.js.map

package/dist/maintenance.js.map

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