@openagt/dashboard 0.0.0-stage → 0.8.0

package/dist/preflight.js

@@ -0,0 +1,91 @@
+import { execFile } from 'node:child_process';
+import { DRIVER_SPECS } from './driver-cli.js';
+function defaultProbe(bin, args) {
+    return new Promise(resolvePromise => {
+        execFile(bin, [...args], { timeout: 10_000 }, (err, stdout, stderr) => {
+            resolvePromise({ ok: !err, output: `${String(stdout)}${String(stderr)}` });
+        });
+    });
+}
+/** Whether this process runs as root. Windows has no uid, and is never root by this test. */
+function runningAsRoot() {
+    return process.getuid?.() === 0;
+}
+/**
+ * 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 async function preflight(opts = {}) {
+    const agent = opts.driver ?? 'claude';
+    const spec = DRIVER_SPECS[agent];
+    const bin = opts.bin ?? spec.bin;
+    const probe = opts.probe ?? defaultProbe;
+    const checks = [{ name: 'node', ok: true, detail: process.version }];
+    const cli = await probe(bin, ['--version']);
+    checks.push(cli.ok
+        ? { name: agent, ok: true, detail: cli.output.trim() || 'installed' }
+        : { name: agent, ok: false, detail: `\`${bin}\` not found — ${spec.installHint}` });
+    if (cli.ok) {
+        const loggedIn = spec.auth.loggedIn(await probe(bin, spec.auth.args));
+        // Only an explicit no fails. `undefined` means the CLI would not say, and an agent that might
+        // work is worth more than a warning we cannot stand behind.
+        if (loggedIn === false) {
+            checks.push({
+                name: `${agent} auth`,
+                ok: false,
+                detail: `\`${bin}\` is not logged in. Run \`${spec.auth.fix}\`, then start the session again.`,
+            });
+        }
+        else if (loggedIn === true) {
+            checks.push({ name: `${agent} auth`, ok: true, detail: 'logged in' });
+        }
+    }
+    // The publish half (#1419): an armed PR/merge fires `gh` at the finish, hours after the Start
+    // that could have said it will not work. Warnings, not failures — the session's own work needs
+    // no gh, and the push rung is plain git, so the agent is worth starting either way.
+    if (opts.publish) {
+        const ghCli = await probe('gh', ['--version']);
+        if (!ghCli.ok) {
+            checks.push({
+                name: 'gh',
+                ok: true,
+                warn: true,
+                detail: '`gh` not found — the armed PR cannot be opened, so publishing stops at the pushed branch. Install the GitHub CLI (`brew install gh`, or https://cli.github.com) and run `gh auth login`.',
+            });
+        }
+        else if (!(await probe('gh', ['auth', 'status'])).ok) {
+            // `gh auth status` exits non-zero when no host is logged in, and says so on stderr —
+            // which the probe folds into `output`, though the exit code alone decides here.
+            checks.push({
+                name: 'gh auth',
+                ok: true,
+                warn: true,
+                detail: '`gh` is not logged in — the armed PR cannot be opened, so publishing stops at the pushed branch. Run `gh auth login`, then start the session.',
+            });
+        }
+    }
+    // Root is the sudo-HOME trap (#1323), and it fails every agent identically: `sudo` moves `HOME`, the CLI
+    // looks for its credentials under root's home instead of the user's, finds none, and every agent
+    // dies the same way with the same empty log. Named here because the failure it causes says
+    // nothing at all about its cause.
+    if ((opts.isRoot ?? runningAsRoot)()) {
+        const sudoUser = opts.sudoUser !== undefined ? opts.sudoUser : process.env.SUDO_USER;
+        const asUser = sudoUser ? `\`${sudoUser}\`` : 'your own user';
+        checks.push({
+            name: 'root',
+            ok: true,
+            warn: true,
+            detail: `running as root, so the agent looks for credentials under root's home and will not find yours. Restart the daemon as ${asUser}, without \`sudo\`.`,
+        });
+    }
+    return { ok: checks.every(c => c.ok), checks };
+}
+/** The failing checks, one line each, the way a user is told what to fix. */
+export function preflightProblems(result) {
+    return result.checks.filter(c => !c.ok).map(c => `${c.name}: ${c.detail}`);
+}
+//# sourceMappingURL=preflight.js.map

package/dist/preflight.js.map

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

package/dist/preset-catalog.d.ts

@@ -0,0 +1,98 @@
+import { type PresetDef } from './preset-prompt.js';
+export declare const presets: {
+    /**
+     * [Research] (#331): the problem-variability review, shipped as a direct prompt (see
+     * `runPrompt`) rather than a build agent — research reviews existing code, so it skips the
+     * scope -> build scaffolding. `showMultiSelect()` + `<AWAIT>` becomes a live turn-boundary
+     * gate (#339/#340) the dashboard resolves.
+     */
+    readonly research: PresetDef;
+    /**
+     * [Maintainability] (#361): deliberately minimal, so its performance can be judged before a
+     * more explicit prompt is written. Keep it in sync with the issue rather than growing it here.
+     */
+    readonly maintainability: PresetDef;
+    /** [Readability] (#360): the reader's-eye pass — seams, altitude, and one commit per refactor. */
+    readonly readability: PresetDef;
+    /** [Security audit] (#461). */
+    readonly securityAudit: PresetDef;
+    /**
+     * [UX (auto)] (#962, replacing #472's gated prompt): rate every UI flow, then fix the low
+     * scorers. Unattended by design — it ends in work rather than in `<AWAIT>`, so an agent started
+     * from it finishes on its own. A gated sibling that offers its ratings as choices is #962's
+     * stated follow-up and belongs beside this row, not inside it.
+     */
+    readonly ux: PresetDef;
+    /**
+     * [Maintenance] (#881/#882): the periodic codebase sweep. Note `${{ }}` fragments cannot nest (the
+     * scanner stops at the first `}}`), which is why its target is a plain blank.
+     */
+    readonly maintenance: PresetDef;
+    /**
+     * [Market research] (#694). Its prompt defines `<SESSION_NAME>` itself rather than reading
+     * `${{ tf.session_name }}`: it is launched from the launcher, where no session exists yet.
+     */
+    readonly marketResearch: PresetDef;
+    /**
+     * [Update from GitHub] (#1208, #1501): the one GitHub sync. It resumes from the
+     * `lastImportedAt` in `tickets/meta.json` and reconciles rather than refilling — an existing
+     * ticket is edited in place, keeping the `.plan.md` written against it, and a
+     * closed issue's ticket goes. An empty `tickets/` is its first-import branch: every open issue
+     * comes across, which is why the separate import preset could go (#1501).
+     *
+     * The timestamp is read by the agent out of the repo rather than rendered into the prompt: the
+     * file travels in the same commit as the tickets it describes, so an agent whose work never landed
+     * cannot leave behind a stamp claiming those issues were imported.
+     *
+     * Marked {@link PresetSpec.newAgent}: syncing is repo work, not a reply, so it opens its own
+     * session rather than appending to whichever one the user happens to be reading.
+     */
+    readonly updateTickets: PresetDef;
+    /** [Plan tickets] (#685): turn tickets into costed plans. */
+    readonly planTickets: PresetDef;
+    /** [Suggest new tickets] (#462/#683): the dashboard prefills this one line and the user edits it freely. */
+    readonly suggestNewTickets: PresetDef;
+    /**
+     * [Suggest new features] (#1109): the product-inward, generative corner of the PM cluster. It
+     * studies what the product does today and proposes net-new features as tickets in `tickets/`.
+     * Distinct from its neighbours: `suggestNewTickets` echoes a line the human types,
+     * `marketResearch` looks outward at the market, and `suggestTicketsToWorkOn` picks from tickets
+     * that already exist. Autonomous rather than gated — a proposal is a reviewable ticket, so the
+     * human triages later instead of approving mid-run, which also keeps it usable unattended.
+     */
+    readonly suggestNewFeatures: PresetDef;
+    /**
+     * [Suggest tickets to work on] (#698): the gated sibling of the triage pair. It ends in
+     * `<AWAIT>`, so it must not be fired unattended — that would wedge an agent against a human
+     * who is not there.
+     */
+    readonly suggestTicketsToWorkOn: PresetDef;
+    /**
+     * [Do quick-win work] (#891) and [Do consensual work] (#892): read `tickets/*.md`, pick the ones
+     * matching one filter, and append them to `TODO_AGENTS.md` — how the queue refills itself from
+     * the ticket backlog. The pair splits on cost, and the split is the point: both are consensual
+     * (zero open questions, zero variability), so neither needs a human, and they differ only in
+     * whether the work is cheap. Keeping them apart lets a person queue the cheap batch and the
+     * significant batch separately rather than in one indiscriminate sweep.
+     *
+     * Each prompt pins its own `<SESSION_NAME>`, so a triage always lands on the same branch and is
+     * recognizable there.
+     *
+     * Both end with the same rule (#1641): a triage only writes `TODO_AGENTS.md`, never a ticket's
+     * code. It is one file, `prompts/triage_scope.md`, appended here rather than pasted into each
+     * preset, so the pair cannot drift apart on it.
+     */
+    readonly triageQuick: PresetDef;
+    readonly triageConsensual: PresetDef;
+};
+/** The presets by key, e.g. `planTickets`. */
+export type PresetKey = keyof typeof presets;
+/**
+ * The presets the launcher offers, in the order it shows them.
+ *
+ * One list rather than a `launcher: true` flag on each row: membership and order are the same
+ * decision, and a flag would have stated half of it while the order lived somewhere else. Every
+ * preset is on it: working the agent queue is a skill file (#1774), not a preset.
+ */
+export declare const LAUNCHER_PRESETS: readonly PresetDef[];
+//# sourceMappingURL=preset-catalog.d.ts.map

package/dist/preset-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-catalog.d.ts","sourceRoot":"","sources":["../src/preset-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAmCjE,eAAO,MAAM,OAAO;IAClB;;;;;OAKG;;IAGH;;;OAGG;;IAGH,kGAAkG;;IAGlG,+BAA+B;;IAG/B;;;;;OAKG;;IAGH;;;OAGG;;IAMH;;;OAGG;;IAGH;;;;;;;;;;;;;OAaG;;IAGH,6DAA6D;;IAG7D,4GAA4G;;IAG5G;;;;;;;OAOG;;IAGH;;;;OAIG;;IAGH;;;;;;;;;;;;;;OAcG;;;CAGyC,CAAA;AAE9C,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,OAAO,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,SAAS,EAehD,CAAA"}

package/dist/preset-catalog.js

@@ -0,0 +1,129 @@
+import { definePreset } from './preset-prompt.js';
+import { PRESETS_MAINTAINABILITY, PRESETS_MAINTENANCE, PRESETS_MARKET_RESEARCH, PRESETS_PLAN_TICKETS, PRESETS_READABILITY, PRESETS_RESEARCH, PRESETS_SECURITY_AUDIT, PRESETS_SUGGEST_NEW_FEATURES, PRESETS_SUGGEST_NEW_TICKETS, PRESETS_SUGGEST_TICKETS_TO_WORK_ON, PRESETS_TRIAGE_CONSENSUAL, PRESETS_TRIAGE_QUICK, PRESETS_UPDATE_TICKETS, PRESETS_UX, TRIAGE_SCOPE, } from './prompts.generated.js';
+/**
+ * Every preset, in one table.
+ *
+ * Each of these used to be a file of its own whose whole body was one `definePreset` call (or a
+ * hand-rolled equivalent) plus four alias exports — 56 exported names for 14 objects, with the
+ * same four doc comments copied down the directory. What actually varies between them is two or
+ * three values, which is what a row is.
+ *
+ * The prompt text itself is not here: it ships in `prompts/presets/<stem>.md` and reaches this
+ * table through the generated constants, so a prompt is edited as prose in one place.
+ *
+ * Pure by construction (no `node:*`), so the dashboard can render any preset in the browser (#520).
+ */
+/** A triage prompt, with the queue-only rule the pair shares (#1641) at the end. */
+const triage = (template) => `${template}\n\n${TRIAGE_SCOPE}`;
+export const presets = {
+    /**
+     * [Research] (#331): the problem-variability review, shipped as a direct prompt (see
+     * `runPrompt`) rather than a build agent — research reviews existing code, so it skips the
+     * scope -> build scaffolding. `showMultiSelect()` + `<AWAIT>` becomes a live turn-boundary
+     * gate (#339/#340) the dashboard resolves.
+     */
+    research: definePreset({ name: 'research', template: PRESETS_RESEARCH, what: 'What to measure problem variability of', label: 'Research' }),
+    /**
+     * [Maintainability] (#361): deliberately minimal, so its performance can be judged before a
+     * more explicit prompt is written. Keep it in sync with the issue rather than growing it here.
+     */
+    maintainability: definePreset({ name: 'maintainability', template: PRESETS_MAINTAINABILITY, what: 'What to refactor for maintainability', label: 'Maintainability' }),
+    /** [Readability] (#360): the reader's-eye pass — seams, altitude, and one commit per refactor. */
+    readability: definePreset({ name: 'readability', template: PRESETS_READABILITY, what: 'What to refactor for readability', label: 'Readability' }),
+    /** [Security audit] (#461). */
+    securityAudit: definePreset({ name: 'security-audit', template: PRESETS_SECURITY_AUDIT, what: 'What to security-audit', label: 'Security audit' }),
+    /**
+     * [UX (auto)] (#962, replacing #472's gated prompt): rate every UI flow, then fix the low
+     * scorers. Unattended by design — it ends in work rather than in `<AWAIT>`, so an agent started
+     * from it finishes on its own. A gated sibling that offers its ratings as choices is #962's
+     * stated follow-up and belongs beside this row, not inside it.
+     */
+    ux: definePreset({ name: 'ux', template: PRESETS_UX, what: 'What to review the UX of', label: 'UX (auto)' }),
+    /**
+     * [Maintenance] (#881/#882): the periodic codebase sweep. Note `${{ }}` fragments cannot nest (the
+     * scanner stops at the first `}}`), which is why its target is a plain blank.
+     */
+    maintenance: definePreset({ name: 'maintenance', template: PRESETS_MAINTENANCE, what: 'What to analyze for refactor opportunities', label: 'Maintenance', tooltip: 'Queue maintainability + security work per codebase subset (TODO_AGENTS.md)' }),
+    // ---- Paramless: each of these scopes itself to the repo's own tickets, plans or queue, so
+    // there is no blank for a user to fill.
+    /**
+     * [Market research] (#694). Its prompt defines `<SESSION_NAME>` itself rather than reading
+     * `${{ tf.session_name }}`: it is launched from the launcher, where no session exists yet.
+     */
+    marketResearch: definePreset({ name: 'market-research', template: PRESETS_MARKET_RESEARCH, label: 'Market research' }),
+    /**
+     * [Update from GitHub] (#1208, #1501): the one GitHub sync. It resumes from the
+     * `lastImportedAt` in `tickets/meta.json` and reconciles rather than refilling — an existing
+     * ticket is edited in place, keeping the `.plan.md` written against it, and a
+     * closed issue's ticket goes. An empty `tickets/` is its first-import branch: every open issue
+     * comes across, which is why the separate import preset could go (#1501).
+     *
+     * The timestamp is read by the agent out of the repo rather than rendered into the prompt: the
+     * file travels in the same commit as the tickets it describes, so an agent whose work never landed
+     * cannot leave behind a stamp claiming those issues were imported.
+     *
+     * Marked {@link PresetSpec.newAgent}: syncing is repo work, not a reply, so it opens its own
+     * session rather than appending to whichever one the user happens to be reading.
+     */
+    updateTickets: definePreset({ name: 'update-tickets', template: PRESETS_UPDATE_TICKETS, label: 'Update from GitHub', newAgent: true, tooltip: 'Bring `tickets/` up to date with the GitHub issues. An empty `tickets/` gets a full first import.' }),
+    /** [Plan tickets] (#685): turn tickets into costed plans. */
+    planTickets: definePreset({ name: 'plan-tickets', template: PRESETS_PLAN_TICKETS, label: 'Plan tickets (aka spike)', tooltip: 'Turn `tickets/*.md` into costed plans (`tickets/*.plan.md`)' }),
+    /** [Suggest new tickets] (#462/#683): the dashboard prefills this one line and the user edits it freely. */
+    suggestNewTickets: definePreset({ name: 'suggest-new-tickets', template: PRESETS_SUGGEST_NEW_TICKETS, label: 'Suggest new tickets' }),
+    /**
+     * [Suggest new features] (#1109): the product-inward, generative corner of the PM cluster. It
+     * studies what the product does today and proposes net-new features as tickets in `tickets/`.
+     * Distinct from its neighbours: `suggestNewTickets` echoes a line the human types,
+     * `marketResearch` looks outward at the market, and `suggestTicketsToWorkOn` picks from tickets
+     * that already exist. Autonomous rather than gated — a proposal is a reviewable ticket, so the
+     * human triages later instead of approving mid-run, which also keeps it usable unattended.
+     */
+    suggestNewFeatures: definePreset({ name: 'suggest-new-features', template: PRESETS_SUGGEST_NEW_FEATURES, label: 'Suggest new features', tooltip: 'Propose net-new features as tickets in `tickets/`' }),
+    /**
+     * [Suggest tickets to work on] (#698): the gated sibling of the triage pair. It ends in
+     * `<AWAIT>`, so it must not be fired unattended — that would wedge an agent against a human
+     * who is not there.
+     */
+    suggestTicketsToWorkOn: definePreset({ name: 'suggest-tickets-to-work-on', template: PRESETS_SUGGEST_TICKETS_TO_WORK_ON, label: 'Suggest tickets to work on', tooltip: 'Add tickets to queue (TODO_AGENTS.md)' }),
+    /**
+     * [Do quick-win work] (#891) and [Do consensual work] (#892): read `tickets/*.md`, pick the ones
+     * matching one filter, and append them to `TODO_AGENTS.md` — how the queue refills itself from
+     * the ticket backlog. The pair splits on cost, and the split is the point: both are consensual
+     * (zero open questions, zero variability), so neither needs a human, and they differ only in
+     * whether the work is cheap. Keeping them apart lets a person queue the cheap batch and the
+     * significant batch separately rather than in one indiscriminate sweep.
+     *
+     * Each prompt pins its own `<SESSION_NAME>`, so a triage always lands on the same branch and is
+     * recognizable there.
+     *
+     * Both end with the same rule (#1641): a triage only writes `TODO_AGENTS.md`, never a ticket's
+     * code. It is one file, `prompts/triage_scope.md`, appended here rather than pasted into each
+     * preset, so the pair cannot drift apart on it.
+     */
+    triageQuick: definePreset({ name: 'triage-quick', template: triage(PRESETS_TRIAGE_QUICK), label: 'Add quick-win work to AI Queue', tooltip: 'Add `tickets/*.md` to queue (TODO_AGENTS.md), only quick-win and consensual tickets' }),
+    triageConsensual: definePreset({ name: 'triage-consensual', template: triage(PRESETS_TRIAGE_CONSENSUAL), label: 'Add consensual work to AI Queue', tooltip: 'Add `tickets/*.md` to queue (TODO_AGENTS.md), only significant (no quick-wins) and consensual tickets' }),
+};
+/**
+ * The presets the launcher offers, in the order it shows them.
+ *
+ * One list rather than a `launcher: true` flag on each row: membership and order are the same
+ * decision, and a flag would have stated half of it while the order lived somewhere else. Every
+ * preset is on it: working the agent queue is a skill file (#1774), not a preset.
+ */
+export const LAUNCHER_PRESETS = [
+    presets.research,
+    presets.readability,
+    presets.maintainability,
+    presets.securityAudit,
+    presets.ux,
+    presets.suggestNewTickets,
+    presets.suggestNewFeatures,
+    presets.suggestTicketsToWorkOn,
+    presets.planTickets,
+    presets.marketResearch,
+    presets.updateTickets,
+    presets.maintenance,
+    presets.triageQuick,
+    presets.triageConsensual,
+];
+//# sourceMappingURL=preset-catalog.js.map

package/dist/preset-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-catalog.js","sourceRoot":"","sources":["../src/preset-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAkB,MAAM,oBAAoB,CAAA;AACjE,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,EAClC,yBAAyB,EACzB,oBAAoB,EACpB,sBAAsB,EACtB,UAAU,EACV,YAAY,GACb,MAAM,wBAAwB,CAAA;AAE/B;;;;;;;;;;;;GAYG;AACH,oFAAoF;AACpF,MAAM,MAAM,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,GAAG,QAAQ,OAAO,YAAY,EAAE,CAAA;AAE7E,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB;;;;;OAKG;IACH,QAAQ,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,wCAAwC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAE3I;;;OAGG;IACH,eAAe,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,uBAAuB,EAAE,IAAI,EAAE,sCAAsC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAErK,kGAAkG;IAClG,WAAW,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,kCAAkC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IAEjJ,+BAA+B;IAC/B,aAAa,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,IAAI,EAAE,wBAAwB,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAElJ;;;;;OAKG;IACH,EAAE,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,0BAA0B,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAE5G;;;OAGG;IACH,WAAW,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,4CAA4C,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,4EAA4E,EAAE,CAAC;IAElP,4FAA4F;IAC5F,wCAAwC;IAExC;;;OAGG;IACH,cAAc,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,uBAAuB,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAEtH;;;;;;;;;;;;;OAaG;IACH,aAAa,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,sBAAsB,EAAE,KAAK,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,mGAAmG,EAAE,CAAC;IAEpP,6DAA6D;IAC7D,WAAW,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,0BAA0B,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC;IAE9L,4GAA4G;IAC5G,iBAAiB,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,2BAA2B,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAErI;;;;;;;OAOG;IACH,kBAAkB,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,4BAA4B,EAAE,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;IAEvM;;;;OAIG;IACH,sBAAsB,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,QAAQ,EAAE,kCAAkC,EAAE,KAAK,EAAE,4BAA4B,EAAE,OAAO,EAAE,uCAAuC,EAAE,CAAC;IAEjN;;;;;;;;;;;;;;OAcG;IACH,WAAW,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,OAAO,EAAE,qFAAqF,EAAE,CAAC;IACpO,gBAAgB,EAAE,YAAY,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,yBAAyB,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,OAAO,EAAE,uGAAuG,EAAE,CAAC;CAC1N,CAAA;AAK9C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyB;IACpD,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,kBAAkB;IAC1B,OAAO,CAAC,sBAAsB;IAC9B,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,gBAAgB;CACzB,CAAA"}

package/dist/preset-prompt.d.ts

@@ -0,0 +1,81 @@
+/**
+ * The default target a preset runs against (#874): the session it was launched from, falling back
+ * to the whole codebase when there is no session yet. A template, not a plain string — see
+ * {@link definePreset} for why that distinction matters.
+ */
+export declare const DEFAULT_WHAT = "${{ tf.session_name || \"entire codebase\" }}";
+/** A quality preset's single user param: the target to run against. */
+export interface PresetParam {
+    name: 'what';
+    /** A `${{ }}` template, rendered against the same context as the preset body. */
+    default: string;
+    description: string;
+}
+/**
+ * What a preset can read beyond its own params. Everything is optional: a preset rendered before
+ * any session exists (the launcher's prompt preview) simply has no `session_name`, which is what
+ * makes {@link DEFAULT_WHAT}'s `||` fall through to the codebase-wide default.
+ */
+export interface PresetRenderContext {
+    /** The launching session's name, once one has been set. */
+    session_name?: string | undefined;
+    /** stem -> `{ filePath }`, so a preset can point at another preset. Defaults to the registry. */
+    presets?: Record<string, {
+        filePath: string;
+    }> | undefined;
+}
+/**
+ * {@link DEFAULT_WHAT}, rendered. Exported so a caller that *labels* an agent (the CLI's log title)
+ * says the same thing the prompt targets, instead of keeping its own copy of the default.
+ */
+export declare function defaultWhat(ctx?: PresetRenderContext): string;
+/** How one preset is declared. Everything that differs between presets, and nothing else. */
+export interface PresetSpec {
+    /** The run-kind name, as the CLI subcommand and the agent record use it. */
+    name: string;
+    /** The prompt template, from `prompts/presets/<stem>.md`. */
+    template: string;
+    /** What the one `what` param means. Omit for a preset that scopes itself. */
+    what?: string;
+    /**
+     * The launcher button's label. Lives here rather than in the dashboard: it is the preset's
+     * user-facing name, and keeping it in the other package meant a preset's name and its label
+     * could only be kept in step by hand.
+     */
+    label: string;
+    /** One line under the label, when the name alone does not say what the preset queues. */
+    tooltip?: string;
+    /**
+     * Always run in a session of its own (#959), even when picked from inside one. A preset whose
+     * work is about the repo rather than about the conversation has nothing to gain from the current
+     * transcript and something to lose from it: sent to a live session it would land on that
+     * session's branch, behind its context. The flag sits on the preset rather than on the surface
+     * that fires it, because it is a property of the work, not of where the user clicked.
+     */
+    newAgent?: boolean;
+}
+/** A preset's public shape: how it is declared, plus its resolved params and a renderer. */
+export interface PresetDef extends PresetSpec {
+    /** The one `what` param, or empty for a preset that scopes itself. */
+    params: readonly PresetParam[];
+    /** Render the template, filling `${{ tf.params.what }}`; a blank/omitted `what` falls back to the default. */
+    render: (what?: string, ctx?: PresetRenderContext) => string;
+}
+/**
+ * Define a preset (#326/#330) from the three things that actually differ between them: the
+ * run-kind name, the prompt template, and what the one `what` param means. Every preset has the
+ * identical shape, so that shape lives here once instead of in each preset file.
+ *
+ * Omitting `whatDescription` defines a **paramless** preset: the prompt scopes itself (the triage
+ * and PM presets read the repo's own tickets or plans), so there is no blank to fill and the
+ * template renders verbatim. That case used to have a second near-identical factory, and six
+ * further presets hand-rolled it using neither — one optional argument covers all three.
+ *
+ * A blank/omitted `what` falls back to the default, so a dashboard button runs with zero input; a
+ * passed value is trimmed first. The default is itself rendered (#874): `${{ }}` has always been
+ * JS-evaluated, but the default was the one string that never went through the evaluator, so a
+ * `${{ }}` inside it reached the prompt as literal text. Rendering it against the same context is
+ * what lets the default depend on the session the preset was launched from.
+ */
+export declare function definePreset(spec: PresetSpec): PresetDef;
+//# sourceMappingURL=preset-prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preset-prompt.d.ts","sourceRoot":"","sources":["../src/preset-prompt.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,YAAY,kDAAgD,CAAA;AAEzE,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,iGAAiG;IACjG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;CAC3D;AAOD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,GAAE,mBAAwB,GAAG,MAAM,CAEjE;AAED,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACzB,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,4FAA4F;AAC5F,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,sEAAsE;IACtE,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9B,8GAA8G;IAC9G,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,mBAAmB,KAAK,MAAM,CAAA;CAC7D;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAaxD"}

package/dist/preset-prompt.js

@@ -0,0 +1,51 @@
+import { renderTemplate } from './prompt-template.js';
+import { presetContext } from './preset-registry.js';
+/**
+ * The default target a preset runs against (#874): the session it was launched from, falling back
+ * to the whole codebase when there is no session yet. A template, not a plain string — see
+ * {@link definePreset} for why that distinction matters.
+ */
+export const DEFAULT_WHAT = '${{ tf.session_name || "entire codebase" }}';
+/** The `tf` a preset renders against. `presets` defaults so a template never throws. */
+function tfFrom(ctx) {
+    return { session_name: ctx.session_name, presets: ctx.presets ?? presetContext() };
+}
+/**
+ * {@link DEFAULT_WHAT}, rendered. Exported so a caller that *labels* an agent (the CLI's log title)
+ * says the same thing the prompt targets, instead of keeping its own copy of the default.
+ */
+export function defaultWhat(ctx = {}) {
+    return renderTemplate(DEFAULT_WHAT, { tf: { ...tfFrom(ctx), params: {} } });
+}
+/**
+ * Define a preset (#326/#330) from the three things that actually differ between them: the
+ * run-kind name, the prompt template, and what the one `what` param means. Every preset has the
+ * identical shape, so that shape lives here once instead of in each preset file.
+ *
+ * Omitting `whatDescription` defines a **paramless** preset: the prompt scopes itself (the triage
+ * and PM presets read the repo's own tickets or plans), so there is no blank to fill and the
+ * template renders verbatim. That case used to have a second near-identical factory, and six
+ * further presets hand-rolled it using neither — one optional argument covers all three.
+ *
+ * A blank/omitted `what` falls back to the default, so a dashboard button runs with zero input; a
+ * passed value is trimmed first. The default is itself rendered (#874): `${{ }}` has always been
+ * JS-evaluated, but the default was the one string that never went through the evaluator, so a
+ * `${{ }}` inside it reached the prompt as literal text. Rendering it against the same context is
+ * what lets the default depend on the session the preset was launched from.
+ */
+export function definePreset(spec) {
+    const { template, what } = spec;
+    // Paramless: nothing to fill, so the template is the prompt.
+    if (what === undefined)
+        return { ...spec, params: [], render: () => template };
+    return {
+        ...spec,
+        params: [{ name: 'what', default: DEFAULT_WHAT, description: what }],
+        render: (value, ctx = {}) => {
+            // The default renders with an empty `params`: it can read the session, but not itself.
+            const target = value?.trim() || defaultWhat(ctx);
+            return renderTemplate(template, { tf: { ...tfFrom(ctx), params: { what: target } } });
+        },
+    };
+}
+//# sourceMappingURL=preset-prompt.js.map

package/dist/preset-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-prompt.js","sourceRoot":"","sources":["../src/preset-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,6CAA6C,CAAA;AAsBzE,wFAAwF;AACxF,SAAS,MAAM,CAAC,GAAwB;IACtC,OAAO,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,aAAa,EAAE,EAAE,CAAA;AACpF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAG,GAAwB,EAAE;IACvD,OAAO,cAAc,CAAC,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;AAC7E,CAAC;AAoCD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAA;IAC/B,6DAA6D;IAC7D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAA;IAC9E,OAAO;QACL,GAAG,IAAI;QACP,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACpE,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,GAAG,EAAE,EAAE,EAAE;YAC1B,uFAAuF;YACvF,MAAM,MAAM,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,WAAW,CAAC,GAAG,CAAC,CAAA;YAChD,OAAO,cAAc,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAA;QACvF,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/preset-registry.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Where the quality presets land on disk (#326), split out of `presets.ts` (#874) so it stays
+ * free of `node:*` — a preset's own template can reference `tf.presets.<name>.filePath`, and
+ * presets render in the browser (#520).
+ *
+ * Membership is *stems only*: the templates live in the catalog (`preset-catalog.ts`), which
+ * is the one table of presets. This module cannot hold them without forking that table — it
+ * sits below `preset-prompt.ts` (which reads {@link presetContext}), and the catalog sits
+ * above it, so importing the catalog from here would cycle. `presets.ts` joins the two on the
+ * node side, and its `PRESETS` export derives from the catalog rather than re-binding the
+ * generated constants a second time.
+ */
+/**
+ * The file stems of the presets that materialize to disk. The stem is both the on-disk name
+ * and the `tf.presets.<stem>` key the prompts read: `tf.presets.security_audit.filePath` uses
+ * the underscore file stem, not the hyphenated run-kind name (`security-audit`).
+ */
+export declare const PRESET_STEMS: readonly ['maintainability', 'readability', 'security_audit', 'research', 'ux', 'maintenance'];
+/** Where the materialized presets live under a repo's `.the-framework/` (#326). */
+export declare const PRESET_DIR = ".the-framework/presets";
+/**
+ * The workspace-relative path a materialized preset lives at, e.g.
+ * `.the-framework/presets/maintainability.md`. A TODO entry carries this as
+ * `tf.presets.<name>.filePath`, and the agent opens it. Workspace-relative, because that
+ * is the agent's cwd.
+ */
+export declare function presetFilePath(name: string): string;
+/** The `tf.presets` map the prompts read: stem -> `{ filePath }`. */
+export declare function presetContext(): Record<string, {
+    filePath: string;
+}>;
+//# sourceMappingURL=preset-registry.d.ts.map

package/dist/preset-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-registry.d.ts","sourceRoot":"","sources":["../src/preset-registry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,YAAI,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,CAAU,CAAA;AAE1H,mFAAmF;AACnF,eAAO,MAAM,UAAU,2BAAiC,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,qEAAqE;AACrE,wBAAgB,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAEpE"}

package/dist/preset-registry.js

@@ -0,0 +1,35 @@
+import { THE_FRAMEWORK_DIR } from './framework-dir.js';
+/**
+ * Where the quality presets land on disk (#326), split out of `presets.ts` (#874) so it stays
+ * free of `node:*` — a preset's own template can reference `tf.presets.<name>.filePath`, and
+ * presets render in the browser (#520).
+ *
+ * Membership is *stems only*: the templates live in the catalog (`preset-catalog.ts`), which
+ * is the one table of presets. This module cannot hold them without forking that table — it
+ * sits below `preset-prompt.ts` (which reads {@link presetContext}), and the catalog sits
+ * above it, so importing the catalog from here would cycle. `presets.ts` joins the two on the
+ * node side, and its `PRESETS` export derives from the catalog rather than re-binding the
+ * generated constants a second time.
+ */
+/**
+ * The file stems of the presets that materialize to disk. The stem is both the on-disk name
+ * and the `tf.presets.<stem>` key the prompts read: `tf.presets.security_audit.filePath` uses
+ * the underscore file stem, not the hyphenated run-kind name (`security-audit`).
+ */
+export const PRESET_STEMS = ['maintainability', 'readability', 'security_audit', 'research', 'ux', 'maintenance'];
+/** Where the materialized presets live under a repo's `.the-framework/` (#326). */
+export const PRESET_DIR = `${THE_FRAMEWORK_DIR}/presets`;
+/**
+ * The workspace-relative path a materialized preset lives at, e.g.
+ * `.the-framework/presets/maintainability.md`. A TODO entry carries this as
+ * `tf.presets.<name>.filePath`, and the agent opens it. Workspace-relative, because that
+ * is the agent's cwd.
+ */
+export function presetFilePath(name) {
+    return `${PRESET_DIR}/${name}.md`;
+}
+/** The `tf.presets` map the prompts read: stem -> `{ filePath }`. */
+export function presetContext() {
+    return Object.fromEntries(PRESET_STEMS.map(name => [name, { filePath: presetFilePath(name) }]));
+}
+//# sourceMappingURL=preset-registry.js.map

package/dist/preset-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset-registry.js","sourceRoot":"","sources":["../src/preset-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,iBAAiB,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,CAAU,CAAA;AAE1H,mFAAmF;AACnF,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,iBAAiB,UAAU,CAAA;AAExD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,GAAG,UAAU,IAAI,IAAI,KAAK,CAAA;AACnC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACjG,CAAC"}

package/dist/presets.d.ts

@@ -0,0 +1,20 @@
+import { type StoreFs } from './store/index.js';
+export { PRESET_DIR, PRESET_STEMS, presetFilePath, presetContext } from './preset-registry.js';
+/**
+ * The materialized presets by file stem, derived from the catalog — the registry names the
+ * stems, the catalog owns the templates, and this join is the only place the two meet. It
+ * used to be a second hand-maintained table re-binding the same generated constants, so a
+ * seventh quality preset was two edits with nothing checking they agreed; now a stem with no
+ * catalog row simply vanishes from this map, which `presets.test.ts`'s exact key-set
+ * assertion turns into a failure.
+ */
+export declare const PRESETS: Readonly<Record<string, string>>;
+/**
+ * Materialize every preset into `<cwd>/.the-framework/presets/<name>.md` so an on-before-mergeable
+ * TODO entry's `filePath` resolves to a real file the agent can open (#326). The files keep
+ * the `${{ tf.params.what }}` blank unrendered: the entry tells the agent what to set it to.
+ * The package ships the presets compiled (`files: ["dist"]`), so they land on disk only once
+ * written here. Overwrites, so a re-install refreshes them to the installed framework version.
+ */
+export declare function materializePresets(cwd: string, fs?: StoreFs): Promise<void>;
+//# sourceMappingURL=presets.d.ts.map

package/dist/presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.d.ts","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAK5D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAE9F;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAIpD,CAAA;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAE,OAAuB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhG"}

package/dist/presets.js

@@ -0,0 +1,33 @@
+import { join } from 'node:path';
+import { PRESET_DIR, PRESET_STEMS } from './preset-registry.js';
+import { presets } from './preset-catalog.js';
+import { nodeStoreFs } from './store/index.js';
+// The registry moved to `preset-registry.ts` (#874) to keep it free of `node:*`, since a preset
+// template can now read `tf.presets.<name>.filePath` and presets render in the browser (#520).
+// Re-exported here so every existing import site keeps working.
+export { PRESET_DIR, PRESET_STEMS, presetFilePath, presetContext } from './preset-registry.js';
+/**
+ * The materialized presets by file stem, derived from the catalog — the registry names the
+ * stems, the catalog owns the templates, and this join is the only place the two meet. It
+ * used to be a second hand-maintained table re-binding the same generated constants, so a
+ * seventh quality preset was two edits with nothing checking they agreed; now a stem with no
+ * catalog row simply vanishes from this map, which `presets.test.ts`'s exact key-set
+ * assertion turns into a failure.
+ */
+export const PRESETS = Object.fromEntries(Object.values(presets)
+    .map(def => [def.name.replace(/-/g, '_'), def.template])
+    .filter(([stem]) => PRESET_STEMS.includes(stem)));
+/**
+ * Materialize every preset into `<cwd>/.the-framework/presets/<name>.md` so an on-before-mergeable
+ * TODO entry's `filePath` resolves to a real file the agent can open (#326). The files keep
+ * the `${{ tf.params.what }}` blank unrendered: the entry tells the agent what to set it to.
+ * The package ships the presets compiled (`files: ["dist"]`), so they land on disk only once
+ * written here. Overwrites, so a re-install refreshes them to the installed framework version.
+ */
+export async function materializePresets(cwd, fs = nodeStoreFs()) {
+    await fs.mkdir(join(cwd, PRESET_DIR));
+    for (const [name, text] of Object.entries(PRESETS)) {
+        await fs.write(join(cwd, PRESET_DIR, `${name}.md`), text);
+    }
+}
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presets.js","sourceRoot":"","sources":["../src/presets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAA;AAE5D,gGAAgG;AAChG,+FAA+F;AAC/F,gEAAgE;AAChE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAE9F;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAqC,MAAM,CAAC,WAAW,CACzE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;KACnB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAU,CAAC;KAChE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAE,YAAkC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAC1E,CAAA;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW,EAAE,EAAE,GAAY,WAAW,EAAE;IAC/E,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;IACrC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;IAC3D,CAAC;AACH,CAAC"}