@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/open-choices.js

@@ -0,0 +1,31 @@
+/**
+ * Every question a run still waits on, in the order asked, read off the run's events. One rule
+ * for every surface that offers an answer (the run page, the open-questions list, the write
+ * that delivers the answer), so none offers what another would refuse.
+ *
+ * A `choice` event opens a question; asked again under the same id, the later one replaces it.
+ * It closes when the agent goes on (any later event of the agent's own: the answer, or the
+ * person's text, began a new turn), when a `choice-resolved` names it, and when the run ends
+ * for good. An end that says `waiting` closes nothing: the run ended ON the question, its
+ * checkout kept, and the answer resumes it. A run that died holding a question ends otherwise,
+ * and its question goes with it (#1359): nobody would read the pick.
+ */
+export function pendingChoices(events) {
+    const open = new Map();
+    for (const event of events) {
+        if (event.kind === 'choice-resolved')
+            open.delete(event.id);
+        else if (event.kind === 'driver')
+            open.clear();
+        else if (event.kind === 'end') {
+            if (event.waiting !== true)
+                open.clear();
+        }
+        else if (event.kind === 'choice') {
+            const { kind: _kind, ...request } = event;
+            open.set(event.id, request);
+        }
+    }
+    return [...open.values()];
+}
+//# sourceMappingURL=open-choices.js.map

package/dist/open-choices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-choices.js","sourceRoot":"","sources":["../src/open-choices.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiC;IAC9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAyB,CAAA;IAC7C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;YAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;aACtD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,KAAK,EAAE,CAAA;aACzC,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;gBAAE,IAAI,CAAC,KAAK,EAAE,CAAA;QAC1C,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,KAAoB,CAAA;YACxD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;AAC3B,CAAC"}

package/dist/pick-directory.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The system folder picker behind the dashboard's "Add project" (#1150): the daemon opens the
+ * OS's own choose-a-folder dialog and hands the picked absolute path back, because a browser page
+ * cannot learn the absolute path of anything the user picks in it.
+ */
+/** The outcome of asking the OS for a folder: a path, a dismissed dialog (`path: null`), or why the dialog could not be asked. */
+export type PickDirectoryResult = {
+    ok: true;
+    path: string | null;
+} | {
+    ok: false;
+    error: string;
+};
+/** What a dialog command left behind when it exited. */
+export type DialogRun = {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+/** Injectable seam so tests never open a real dialog. */
+export type DialogRunner = (command: string, args: string[]) => Promise<DialogRun>;
+/**
+ * Open the OS folder picker and wait for the user's choice.
+ *
+ * Dismissing the dialog is a normal outcome (`path: null`), not an error. A Linux daemon with no
+ * desktop session to draw on, a Linux machine with neither dialog helper installed, and a platform
+ * with no dialog wired up each answer with that reason instead of trying.
+ */
+export declare function pickDirectory(platform?: NodeJS.Platform, run?: DialogRunner, env?: NodeJS.ProcessEnv): Promise<PickDirectoryResult>;
+//# sourceMappingURL=pick-directory.d.ts.map

package/dist/pick-directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick-directory.d.ts","sourceRoot":"","sources":["../src/pick-directory.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,kIAAkI;AAClI,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhC,wDAAwD;AACxD,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAExE,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;AA2ElF;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,GAAE,MAAM,CAAC,QAA2B,EAC5C,GAAG,GAAE,YAA+B,EACpC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAAC,mBAAmB,CAAC,CAW9B"}

package/dist/pick-directory.js

@@ -0,0 +1,102 @@
+import { execFile } from 'node:child_process';
+/** The exit code standing for "this machine does not have that command", so the next candidate can be tried. */
+const NOT_INSTALLED = 127;
+/** The exit code the Windows script reports a cancelled dialog with, kept clear of PowerShell's own failure exit of 1. */
+const WINDOWS_CANCELLED = 2;
+/** What the user is asked for, in every OS's own dialog. */
+const PROMPT = 'Choose a git repository to add as a project';
+/** macOS: `osascript`'s `choose folder`, which renders the standard folder sheet. */
+const macDialog = {
+    command: 'osascript',
+    args: ['-e', `POSIX path of (choose folder with prompt "${PROMPT}")`],
+    // osascript reports a cancelled dialog as error -128, the one exit we translate rather than surface.
+    dismissed: run => run.stderr.includes('-128'),
+};
+/**
+ * Windows: PowerShell drives the folder browser that ships with the OS. `-STA` because that dialog
+ * needs a single-threaded apartment, `-NoProfile` so a user's startup script cannot print into the
+ * path read back off stdout.
+ */
+const windowsDialog = {
+    command: 'powershell.exe',
+    args: [
+        '-NoProfile',
+        '-STA',
+        '-Command',
+        [
+            'Add-Type -AssemblyName System.Windows.Forms',
+            '$dialog = New-Object System.Windows.Forms.FolderBrowserDialog',
+            `$dialog.Description = '${PROMPT}'`,
+            '$dialog.ShowNewFolderButton = $false',
+            `if ($dialog.ShowDialog() -eq [System.Windows.Forms.DialogResult]::OK) { $dialog.SelectedPath } else { exit ${WINDOWS_CANCELLED} }`,
+        ].join('; '),
+    ],
+    dismissed: run => run.code === WINDOWS_CANCELLED,
+};
+/**
+ * Linux: the desktop's own dialog helper, whichever of the two is installed — `zenity` on GTK
+ * desktops, `kdialog` on KDE. Both print the chosen folder and report a cancelled dialog as exit 1,
+ * and both are told where to open, because `kdialog` takes the starting directory as an argument.
+ *
+ * Exit 1 is read as a cancellation even though a helper that cannot reach the display exits that
+ * way too: a session with no display at all is ruled out before we get here, and mistaking the
+ * remaining rarity for a cancellation is better than showing every user who cancels the harmless
+ * warnings these helpers print on startup.
+ */
+function linuxDialogs(home) {
+    const dismissed = (run) => run.code === 1;
+    return [
+        { command: 'zenity', args: ['--file-selection', '--directory', `--title=${PROMPT}`, `--filename=${home}/`], dismissed },
+        { command: 'kdialog', args: ['--title', PROMPT, '--getexistingdirectory', home], dismissed },
+    ];
+}
+/** A command that could not be spawned at all reads as not installed; anything else keeps its own exit code. */
+function exitCode(error) {
+    if (error.code === 'ENOENT')
+        return NOT_INSTALLED;
+    return typeof error.code === 'number' ? error.code : 1;
+}
+const nodeDialogRunner = (command, args) => new Promise(done => {
+    execFile(command, args, (error, stdout, stderr) => {
+        done({ code: error ? exitCode(error) : 0, stdout: String(stdout), stderr: String(stderr) });
+    });
+});
+/**
+ * Open the OS folder picker and wait for the user's choice.
+ *
+ * Dismissing the dialog is a normal outcome (`path: null`), not an error. A Linux daemon with no
+ * desktop session to draw on, a Linux machine with neither dialog helper installed, and a platform
+ * with no dialog wired up each answer with that reason instead of trying.
+ */
+export async function pickDirectory(platform = process.platform, run = nodeDialogRunner, env = process.env) {
+    if (platform === 'darwin')
+        return openDialog([macDialog], run);
+    if (platform === 'win32')
+        return openDialog([windowsDialog], run);
+    if (platform === 'linux') {
+        // A dialog needs a screen to appear on, and a daemon started over SSH or inside a container has
+        // none — saying so beats spawning a helper that can only fail.
+        if (!env.DISPLAY && !env.WAYLAND_DISPLAY)
+            return { ok: false, error: 'The machine running The Framework has no desktop session, so no folder dialog can open there.' };
+        return openDialog(linuxDialogs(env.HOME ?? '.'), run);
+    }
+    return { ok: false, error: `The system folder picker is not available on ${platform}.` };
+}
+/** Open the first installed dialog of `dialogs`, and read the user's answer out of what it printed. */
+async function openDialog(dialogs, run) {
+    for (const dialog of dialogs) {
+        const result = await run(dialog.command, dialog.args);
+        if (result.code === NOT_INSTALLED)
+            continue;
+        if (dialog.dismissed(result))
+            return { ok: true, path: null };
+        if (result.code !== 0)
+            return { ok: false, error: result.stderr.trim() || 'The folder dialog could not be opened.' };
+        // macOS prints the POSIX path with a trailing slash; the registry stores paths without one.
+        const path = result.stdout.trim().replace(/(.)\/$/, '$1');
+        return path ? { ok: true, path } : { ok: false, error: 'The folder dialog returned no path.' };
+    }
+    const names = dialogs.map(dialog => dialog.command).join(' or ');
+    return { ok: false, error: `The folder dialog needs ${names}, which the machine running The Framework does not have installed.` };
+}
+//# sourceMappingURL=pick-directory.js.map

package/dist/pick-directory.js.map

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

package/dist/planned-quick-wins.d.ts

@@ -0,0 +1,102 @@
+import { type GitRunner } from './project.js';
+/**
+ * Turn a plan's own verdict into queued work (#1334).
+ *
+ * The missing link in the autonomy chain. Tickets arrive from GitHub, [Spike & plan] costs them,
+ * and the drain implements whatever is on the queue -- but nothing carried a plan's conclusion
+ * onto that queue, so a ticket the planner had already judged trivial still waited for a triage
+ * run to read the same ticket and reach the same conclusion a second time.
+ *
+ * The promotion is done here rather than by an agent because it is a decision the plan has
+ * already made: reading two keys out of a file and appending a line needs judgement from nobody,
+ * and spending a subscription turn to re-derive an answer already written down is the waste #879
+ * exists to avoid. It is the daemon that writes, for the reason queue-promote.ts gives: agents
+ * stay sandboxed in their worktrees with no write access to the checkout.
+ */
+/** How much work the plan says the ticket is. */
+export type PlanEffort = 'quick-win' | 'significant';
+/** Whether the plan says there is anything left to decide. */
+export type PlanConsensus = 'consensual' | 'open-questions';
+/** The two keys a plan records about itself, absent when the plan did not say. */
+export interface PlanVerdict {
+    effort?: PlanEffort;
+    consensus?: PlanConsensus;
+}
+/**
+ * Read a plan file's verdict keys.
+ *
+ * Only the header is scanned -- everything above the first `##` section -- because that is where
+ * the ticket format puts its keys, and because a plan that *discusses* quick wins in its prose
+ * must not be read as declaring itself one.
+ */
+export declare function parsePlanVerdict(md: string): PlanVerdict;
+/**
+ * Whether a plan authorises the drain to implement its ticket unattended.
+ *
+ * Fails closed, and demands both keys explicitly: the same polarity as `quotaHeadroom` (#879),
+ * for the same reason. A plan that forgot to say, or said something this version does not
+ * recognise, means a human decides -- not that an agent starts.
+ */
+export declare function isAutoImplementable(verdict: PlanVerdict): boolean;
+/** `tickets/<slug>.plan.md` for `tickets/<slug>.md`, and the read back. */
+export declare function planPathFor(ticket: string): string;
+/** The ticket a plan belongs to, or undefined for a file that is not one. */
+export declare function ticketForPlan(plan: string): string | undefined;
+/** A ticket's `Status:`/`Priority:`/title, as the queue needs them. */
+export interface TicketHeader {
+    title: string;
+    priority: number;
+    open: boolean;
+}
+/**
+ * Read a ticket's header. Keys sit above the `# Title`, per the ticket format.
+ *
+ * A ticket with no `Status:` counts as open: the key is what a *closed* ticket is marked with,
+ * and treating an unmarked one as closed would silently drop it out of the roadmap.
+ */
+export declare function parseTicketHeader(md: string): TicketHeader;
+/** The queue line for a planned ticket: the link, and nothing else. */
+export declare function queueEntryFor(ticket: string, title: string): string;
+/**
+ * Add an entry under its priority heading, creating the section when the file has none.
+ *
+ * Placement is the whole point rather than a nicety: `parseTodoEntries` returns entries in file
+ * order and the drain takes the first, so an entry appended to the end of the file is the last
+ * thing that would ever be worked -- which is the opposite of what "autonomously work on
+ * quick-wins" asks for. Additive like `landPinnedEntry`, so it composes with whatever else is
+ * mid-flight: it only ever inserts one line.
+ */
+export declare function insertQueueEntry(md: string, entry: string, priority: number): string;
+/** Everything the promotion reads and writes, injected so the policy above tests off disk. */
+export interface PlanPromoteDeps {
+    list?: (dir: string) => Promise<string[]>;
+    read?: (path: string) => Promise<string>;
+    write?: (path: string, content: string) => Promise<void>;
+    git?: GitRunner;
+}
+/** What one promotion pass did. Never throws: this runs on a background tick. */
+export interface PlanPromotion {
+    /** The entries appended, in the order they were added. */
+    queued: string[];
+    /** Why nothing was queued, when nothing was. */
+    reason?: string;
+    /**
+     * Something stood in the way, as opposed to there simply being nothing to promote.
+     *
+     * The distinction is what keeps the daemon log readable: "no plan called its ticket a quick-win"
+     * is the ordinary state of a healthy repo and would otherwise print on every tick of every
+     * project forever, burying the one line that means a human should look.
+     */
+    blocked?: true;
+}
+/** The commit message a promotion writes, naming the count so the history reads at a glance. */
+export declare function plannedQueueMessage(count: number): string;
+/**
+ * Queue every ticket whose plan declares itself a consensual quick-win and that is not on the
+ * queue already (#1334).
+ *
+ * Skips wholesale on a dirty queue file, for the same reason `promoteQueue` does: a human editing
+ * the queue by hand outranks an unattended tidy-up, and the next tick will try again.
+ */
+export declare function promotePlannedQuickWins(projectCwd: string, deps?: PlanPromoteDeps): Promise<PlanPromotion>;
+//# sourceMappingURL=planned-quick-wins.d.ts.map

package/dist/planned-quick-wins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planned-quick-wins.d.ts","sourceRoot":"","sources":["../src/planned-quick-wins.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAA;AAG5D;;;;;;;;;;;;;GAaG;AAEH,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,aAAa,CAAA;AAEpD,8DAA8D;AAC9D,MAAM,MAAM,aAAa,GAAG,YAAY,GAAG,gBAAgB,CAAA;AAE3D,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,SAAS,CAAC,EAAE,aAAa,CAAA;CAC1B;AAKD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAcxD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAEjE;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAK1D;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAID;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiCpF;AAED,8FAA8F;AAC9F,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACzC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACxC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,GAAG,CAAC,EAAE,SAAS,CAAA;CAChB;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,IAAI,CAAA;CACf;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,aAAa,CAAC,CA+CxB"}

package/dist/planned-quick-wins.js

@@ -0,0 +1,171 @@
+import { join } from 'node:path';
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { errorMessage } from './error-message.js';
+import { nodeGitRunner } from './project.js';
+import { FLAT_TODO_FILE, TICKETS_DIR, todoPriorityForTicket } from './tickets.js';
+const EFFORTS = ['quick-win', 'significant'];
+const CONSENSUS = ['consensual', 'open-questions'];
+/**
+ * Read a plan file's verdict keys.
+ *
+ * Only the header is scanned -- everything above the first `##` section -- because that is where
+ * the ticket format puts its keys, and because a plan that *discusses* quick wins in its prose
+ * must not be read as declaring itself one.
+ */
+export function parsePlanVerdict(md) {
+    const verdict = {};
+    for (const line of md.split('\n')) {
+        if (line.startsWith('## '))
+            break;
+        const key = /^\s*(Effort|Consensus)\s*:\s*(.+?)\s*$/i.exec(line);
+        if (!key)
+            continue;
+        const value = key[2].toLowerCase();
+        if (/^effort$/i.test(key[1])) {
+            if (EFFORTS.includes(value) && verdict.effort === undefined)
+                verdict.effort = value;
+        }
+        else if (CONSENSUS.includes(value) && verdict.consensus === undefined) {
+            verdict.consensus = value;
+        }
+    }
+    return verdict;
+}
+/**
+ * Whether a plan authorises the drain to implement its ticket unattended.
+ *
+ * Fails closed, and demands both keys explicitly: the same polarity as `quotaHeadroom` (#879),
+ * for the same reason. A plan that forgot to say, or said something this version does not
+ * recognise, means a human decides -- not that an agent starts.
+ */
+export function isAutoImplementable(verdict) {
+    return verdict.effort === 'quick-win' && verdict.consensus === 'consensual';
+}
+/** `tickets/<slug>.plan.md` for `tickets/<slug>.md`, and the read back. */
+export function planPathFor(ticket) {
+    return `${ticket.slice(0, -'.md'.length)}.plan.md`;
+}
+/** The ticket a plan belongs to, or undefined for a file that is not one. */
+export function ticketForPlan(plan) {
+    if (!plan.endsWith('.plan.md'))
+        return undefined;
+    return `${plan.slice(0, -'.plan.md'.length)}.md`;
+}
+/**
+ * Read a ticket's header. Keys sit above the `# Title`, per the ticket format.
+ *
+ * A ticket with no `Status:` counts as open: the key is what a *closed* ticket is marked with,
+ * and treating an unmarked one as closed would silently drop it out of the roadmap.
+ */
+export function parseTicketHeader(md) {
+    const title = /^#\s+(.+?)\s*$/m.exec(md)?.[1]?.trim() ?? '';
+    const status = /^\s*Status\s*:\s*(.+?)\s*$/im.exec(md)?.[1]?.trim().toLowerCase();
+    const priority = /^\s*Priority\s*:\s*(.+?)\s*$/im.exec(md)?.[1]?.trim();
+    return { title, priority: todoPriorityForTicket(priority), open: status !== 'closed' };
+}
+/** The queue line for a planned ticket: the link, and nothing else. */
+export function queueEntryFor(ticket, title) {
+    return `[${title}](${ticket})`;
+}
+const PRIORITY_HEADING = /^##\s+Priority\s+(\d+)\b/;
+/**
+ * Add an entry under its priority heading, creating the section when the file has none.
+ *
+ * Placement is the whole point rather than a nicety: `parseTodoEntries` returns entries in file
+ * order and the drain takes the first, so an entry appended to the end of the file is the last
+ * thing that would ever be worked -- which is the opposite of what "autonomously work on
+ * quick-wins" asks for. Additive like `landPinnedEntry`, so it composes with whatever else is
+ * mid-flight: it only ever inserts one line.
+ */
+export function insertQueueEntry(md, entry, priority) {
+    const lines = md.split('\n');
+    const headings = lines.flatMap((line, i) => {
+        const found = PRIORITY_HEADING.exec(line);
+        return found ? [{ index: i, priority: Number(found[1]) }] : [];
+    });
+    const line = `- ${entry}`;
+    if (!headings.length) {
+        const body = md.endsWith('\n') || md === '' ? md : `${md}\n`;
+        return `${body}${line}\n`;
+    }
+    const own = headings.find(h => h.priority === priority);
+    if (own) {
+        // The end of the section: the line before the next heading, with trailing blanks left where
+        // they are so the file's spacing survives.
+        const next = headings.find(h => h.index > own.index);
+        let end = next ? next.index : lines.length;
+        while (end > own.index + 1 && lines[end - 1].trim() === '')
+            end--;
+        return [...lines.slice(0, end), line, ...lines.slice(end)].join('\n');
+    }
+    // No section for this priority yet. Sections run high to low, so the new one goes before the
+    // first section that is less urgent, or after the last one when it is the least urgent of all.
+    const before = headings.find(h => h.priority < priority);
+    const at = before ? before.index : lines.length;
+    const section = [`## Priority ${priority}`, '', line, ''];
+    if (!before) {
+        while (lines.length && lines[lines.length - 1].trim() === '')
+            lines.pop();
+        return [...lines, '', ...section].join('\n');
+    }
+    return [...lines.slice(0, at), ...section, ...lines.slice(at)].join('\n');
+}
+/** The commit message a promotion writes, naming the count so the history reads at a glance. */
+export function plannedQueueMessage(count) {
+    return `[The Framework] queue ${count} planned quick-win${count === 1 ? '' : 's'}`;
+}
+/**
+ * Queue every ticket whose plan declares itself a consensual quick-win and that is not on the
+ * queue already (#1334).
+ *
+ * Skips wholesale on a dirty queue file, for the same reason `promoteQueue` does: a human editing
+ * the queue by hand outranks an unattended tidy-up, and the next tick will try again.
+ */
+export async function promotePlannedQuickWins(projectCwd, deps = {}) {
+    const list = deps.list ?? (dir => readdir(dir));
+    const read = deps.read ?? (path => readFile(path, 'utf8'));
+    const write = deps.write ?? ((path, content) => writeFile(path, content, 'utf8'));
+    const git = deps.git ?? nodeGitRunner();
+    try {
+        const files = await list(join(projectCwd, TICKETS_DIR)).catch(() => []);
+        const plans = files.filter(file => file.endsWith('.plan.md')).sort();
+        if (!plans.length)
+            return { queued: [], reason: 'no plans yet' };
+        const queuePath = join(projectCwd, FLAT_TODO_FILE);
+        let queue = await read(queuePath).catch(() => '');
+        const dirty = (await git(['status', '--porcelain', '--', FLAT_TODO_FILE], projectCwd)).trim();
+        if (dirty)
+            return { queued: [], reason: 'the checkout has uncommitted queue changes', blocked: true };
+        const queued = [];
+        for (const plan of plans) {
+            const ticket = ticketForPlan(`${TICKETS_DIR}/${plan}`);
+            if (!ticket)
+                continue;
+            // Already on the queue, open or checked off: `queue.includes` on the link target is enough
+            // because the entry is written as a link to exactly this path.
+            if (queue.includes(`(${ticket})`))
+                continue;
+            const verdict = parsePlanVerdict(await read(join(projectCwd, TICKETS_DIR, plan)).catch(() => ''));
+            if (!isAutoImplementable(verdict))
+                continue;
+            const header = parseTicketHeader(await read(join(projectCwd, ticket)).catch(() => ''));
+            // A ticket whose file is gone or whose title is empty has nothing a queue line could say,
+            // and a closed one is not work.
+            if (!header.title || !header.open)
+                continue;
+            const entry = queueEntryFor(ticket, header.title);
+            queue = insertQueueEntry(queue, entry, header.priority);
+            queued.push(entry);
+        }
+        if (!queued.length)
+            return { queued: [], reason: 'no plan called its ticket a consensual quick-win' };
+        await write(queuePath, queue);
+        await git(['add', '--', FLAT_TODO_FILE], projectCwd);
+        await git(['commit', '-m', plannedQueueMessage(queued.length), '--', FLAT_TODO_FILE], projectCwd);
+        return { queued };
+    }
+    catch (err) {
+        return { queued: [], reason: errorMessage(err), blocked: true };
+    }
+}
+//# sourceMappingURL=planned-quick-wins.js.map

package/dist/planned-quick-wins.js.map

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

package/dist/preference-defaults.d.ts

@@ -0,0 +1,43 @@
+import type { Preferences } from './registry.js';
+/**
+ * What an unset preference means, and the bounds the controls that write them share.
+ *
+ * A leaf module (no `node:*`) so `client.ts` can export it and the dashboard reads the same values
+ * the daemon acts on.
+ *
+ * No cycle: `registry.ts` re-exports the bounds from here, and the `Preferences` import going the
+ * other way is type-only, so it erases.
+ */
+/**
+ * Notifications have two axes (B5): `notifyBrowser` says whether they reach you in the browser at
+ * all, and `notifyHumanIntervention` / `notifyNewActivity` say *what* they are about. A category
+ * delivers only while the browser switch is on too.
+ */
+/** What a notification is about. */
+export type NotifyCategory = 'humanIntervention' | 'newActivity';
+/**
+ * What each switch means when nobody has said.
+ *
+ * The polarities are not uniform, and that is the point of writing them down once: browser
+ * delivery and the "needs you" category fire unless you turn them off, while plain activity is
+ * opt-in.
+ */
+export declare const NOTIFICATION_DEFAULTS: {
+    readonly browser: true;
+    readonly categories: {
+        readonly humanIntervention: true;
+        readonly newActivity: false;
+    };
+};
+/** Whether browser delivery is switched on, with its default applied. */
+export declare function browserNotifyEnabled(preferences: Preferences): boolean;
+/** Whether a category is switched on, with its default applied. */
+export declare function notifyCategoryEnabled(preferences: Preferences, category: NotifyCategory): boolean;
+/** Whether a category delivers: both browser delivery and the category have to be on. */
+export declare function notifies(preferences: Preferences, category: NotifyCategory): boolean;
+/**
+ * How far either side of the quota boundary the usage bar's handle reaches, in percentage points
+ * (#960): the bound of the stop line a module puts on the bar, which the bar clamps a drag to.
+ */
+export declare const MAX_SPEND_OFFSET = 50;
+//# sourceMappingURL=preference-defaults.d.ts.map

package/dist/preference-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-defaults.d.ts","sourceRoot":"","sources":["../src/preference-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD;;;;;;;;GAQG;AAEH;;;;GAIG;AAEH,oCAAoC;AACpC,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,aAAa,CAAA;AAQhE;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;iBAElB,iBAAiB;iBAAQ,WAAW;;CACkC,CAAA;AAEtF,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAEtE;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEjG;AAED,yFAAyF;AACzF,wBAAgB,QAAQ,CAAC,WAAW,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAEpF;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,KAAK,CAAA"}

package/dist/preference-defaults.js

@@ -0,0 +1,34 @@
+/** The preference key each category is stored under. */
+const CATEGORY_KEYS = {
+    humanIntervention: 'notifyHumanIntervention',
+    newActivity: 'notifyNewActivity',
+};
+/**
+ * What each switch means when nobody has said.
+ *
+ * The polarities are not uniform, and that is the point of writing them down once: browser
+ * delivery and the "needs you" category fire unless you turn them off, while plain activity is
+ * opt-in.
+ */
+export const NOTIFICATION_DEFAULTS = {
+    browser: true,
+    categories: { humanIntervention: true, newActivity: false },
+};
+/** Whether browser delivery is switched on, with its default applied. */
+export function browserNotifyEnabled(preferences) {
+    return preferences.notifyBrowser ?? NOTIFICATION_DEFAULTS.browser;
+}
+/** Whether a category is switched on, with its default applied. */
+export function notifyCategoryEnabled(preferences, category) {
+    return preferences[CATEGORY_KEYS[category]] ?? NOTIFICATION_DEFAULTS.categories[category];
+}
+/** Whether a category delivers: both browser delivery and the category have to be on. */
+export function notifies(preferences, category) {
+    return browserNotifyEnabled(preferences) && notifyCategoryEnabled(preferences, category);
+}
+/**
+ * How far either side of the quota boundary the usage bar's handle reaches, in percentage points
+ * (#960): the bound of the stop line a module puts on the bar, which the bar clamps a drag to.
+ */
+export const MAX_SPEND_OFFSET = 50;
+//# sourceMappingURL=preference-defaults.js.map

package/dist/preference-defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preference-defaults.js","sourceRoot":"","sources":["../src/preference-defaults.ts"],"names":[],"mappings":"AAqBA,wDAAwD;AACxD,MAAM,aAAa,GAAG;IACpB,iBAAiB,EAAE,yBAAyB;IAC5C,WAAW,EAAE,mBAAmB;CAC4B,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,IAAI;IACb,UAAU,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;CACyB,CAAA;AAEtF,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,WAAwB;IAC3D,OAAO,WAAW,CAAC,aAAa,IAAI,qBAAqB,CAAC,OAAO,CAAA;AACnE,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,qBAAqB,CAAC,WAAwB,EAAE,QAAwB;IACtF,OAAO,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;AAC3F,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,QAAQ,CAAC,WAAwB,EAAE,QAAwB;IACzE,OAAO,oBAAoB,CAAC,WAAW,CAAC,IAAI,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAC1F,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA"}

package/dist/preflight.d.ts

@@ -0,0 +1,77 @@
+import { type DriverName } from './driver-cli.js';
+/**
+ * Preflight checks for a live agent. A turnkey tool should fail *early and
+ * clearly* when a prerequisite is missing, not spawn a broken process mid-run.
+ * The main one: is the wrapped driver's CLI actually installed and runnable?
+ * A fake session needs none of this, so preflight only gates live agents.
+ *
+ * It probes the driver the session actually picked (#542), so a `codex` session is
+ * checked against `codex` and fails on `codex` being missing, not `claude`.
+ *
+ * Installed is not the same as usable (#1326). Our first external-user report (#1323) was a
+ * CLI that resolved fine and was logged out, under a daemon started with `sudo`: every session
+ * died before writing its agent.json, on both agents, across six projects, while the daemon went
+ * on spending a branch and a worktree per attempt. So preflight also asks the CLI whether it is
+ * authenticated, and says so when the daemon runs as root.
+ */
+/** One preflight check's outcome. */
+export interface PreflightCheck {
+    name: string;
+    ok: boolean;
+    /** Human-readable detail: the version when ok, or how to fix it when not. */
+    detail: string;
+    /**
+     * A problem worth saying out loud that must not block the agent. Root is the case: a container
+     * legitimately runs everything as root, so refusing to start there would break more than it
+     * explains.
+     */
+    warn?: boolean;
+}
+/** The result of running all preflight checks. */
+export interface PreflightResult {
+    ok: boolean;
+    checks: PreflightCheck[];
+}
+/**
+ * Run `<bin> <args>` and report whether it succeeded and everything it said. Injectable so
+ * tests need no real CLI.
+ *
+ * `output` merges stdout and stderr on purpose: the two CLIs disagree about where a status line
+ * belongs, and a check reading only stdout would call a CLI that answered on stderr "could not
+ * say".
+ */
+export type CliProbe = (bin: string, args: readonly string[]) => Promise<{
+    ok: boolean;
+    output: string;
+}>;
+/** Options for {@link preflight}. */
+export interface PreflightOptions {
+    /** The agent to check for. Default `"claude"`. */
+    driver?: DriverName;
+    /** The CLI binary to probe. Default the agent's own. */
+    bin?: string;
+    /** CLI probe override (tests). Default runs the real binary. */
+    probe?: CliProbe;
+    /** Root check override (tests). Default reads this process's uid. */
+    isRoot?: () => boolean;
+    /** The invoking user `sudo` recorded, named in the root warning. Default read from the environment. */
+    sudoUser?: string | undefined;
+    /**
+     * Also check `gh` (#1419): the agent's PR/merge rung is armed, and the handoff opens and merges
+     * PRs through the GitHub CLI. Missing or logged-out `gh` warns without blocking — the agent
+     * itself starts fine and the push rung is plain git; only the PR onward would silently degrade.
+     */
+    publish?: boolean;
+}
+/**
+ * Run the preflight checks: Node is implicit (we are running), the picked driver's CLI must be
+ * installed, and it must be logged in. Returns every check plus an overall `ok`, which counts
+ * failures only, so a warning travels without blocking anything.
+ *
+ * The auth probe is skipped when the CLI is missing: a binary that does not resolve cannot
+ * answer a second question, and one "not found" beats two lines saying the same thing.
+ */
+export declare function preflight(opts?: PreflightOptions): Promise<PreflightResult>;
+/** The failing checks, one line each, the way a user is told what to fix. */
+export declare function preflightProblems(result: PreflightResult): string[];
+//# sourceMappingURL=preflight.d.ts.map

package/dist/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../src/preflight.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE/D;;;;;;;;;;;;;;GAcG;AAEH,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,OAAO,CAAA;IACX,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,cAAc,EAAE,CAAA;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAezG,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gEAAgE;IAChE,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,OAAO,CAAA;IACtB,uGAAuG;IACvG,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAuErF;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,EAAE,CAEnE"}