dorfl 0.0.0 → 0.1.0

package/dist/prompt.js

@@ -0,0 +1,499 @@
+/**
+ * Builds the prompt the runner hands to `agentCmd`: a small CONSTANT wrapper
+ * (only the `<slug>` / source-prd path vary) around the claimed task's own
+ * `## Prompt` section. This is dual-use — the SAME assembly the autonomous
+ * runner feeds `agentCmd` and the human `dorfl prompt [<slug>]` command.
+ *
+ * The wrapper is NOT hardcoded here: it is read VERBATIM from the work-contract
+ * (`skills/setup/protocol/CLAIM-PROTOCOL.md` → "The prompt handed to the work agent"),
+ * so the emitted text can never silently diverge from the canonical contract.
+ * We only substitute the per-task placeholders (`<slug>`, `<prd>`).
+ *
+ * The wrapper draws the git boundary IN-BAND — the spawned agent does NO git ops
+ * on the repo (no commit/push, no moving `work/` files); the RUNNER owns every
+ * git-state transition (claim, done-move, work commit, integration). We state
+ * this in the prompt rather than relying on the host's global agent config (an
+ * `AGENTS.md`), because the runner is portable and cannot assume any host rule
+ * exists. See CLAIM-PROTOCOL.md → "The prompt handed to the work agent".
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseFrontmatter } from './frontmatter.js';
+import { WORK_ROOT, workFolderName, workItemPath, workFolderRel, } from './work-layout.js';
+import { run } from './git.js';
+import { branchAheadOf } from './continue-branch.js';
+import { isAncestor } from './gc.js';
+import { extractReason } from './needs-attention.js';
+/**
+ * Extract the body of the `## Prompt` section from a task's markdown. Returns
+ * the section text with the heading removed, leading `>` blockquote markers
+ * stripped, trimmed; or `undefined` when the task has no `## Prompt` heading.
+ */
+export function extractPromptSection(content) {
+    const normalized = content.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    let start = -1;
+    let headingLevel = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const match = /^(#{1,6})\s+(.*)$/.exec(lines[i]);
+        if (match && match[2].trim().toLowerCase() === 'prompt') {
+            start = i + 1;
+            headingLevel = match[1].length;
+            break;
+        }
+    }
+    if (start === -1) {
+        return undefined;
+    }
+    // Collect until the next heading of the same or higher level (fewer/equal #).
+    const body = [];
+    for (let i = start; i < lines.length; i++) {
+        const heading = /^(#{1,6})\s+/.exec(lines[i]);
+        if (heading && heading[1].length <= headingLevel) {
+            break;
+        }
+        body.push(lines[i]);
+    }
+    // Strip a single leading blockquote marker (`> ` or `>`) from each line.
+    const unquoted = body.map((line) => line.replace(/^>\s?/, ''));
+    const text = unquoted.join('\n').trim();
+    return text === '' ? undefined : text;
+}
+/**
+ * Locate one of the runtime-read protocol docs (`CLAIM-PROTOCOL.md`,
+ * `REVIEW-PROTOCOL.md`, …) the runner reads at RUNTIME. Resolution order,
+ * highest authority first:
+ *
+ *   1. `override` — explicit, for tests / unusual layouts (short-circuits).
+ *   2. `<cwd>/work/protocol/<name>` — the TARGET repo's adopted copy. `setup`
+ *      copies the protocol docs verbatim into every repo's `work/protocol/`
+ *      (ADR `methodology-and-skills.md` §5, the `work/protocol/` propagation),
+ *      so a set-up repo carries the protocol VERSION it adopted; that copy
+ *      wins.
+ *   3. `dist/protocol/<name>` — a copy VENDORED inside this package (by the
+ *      `vendor-protocol` build step). The published-CLI fallback: an installed
+ *      CLI has no sibling `skills/` tree, and the target repo may not be set
+ *      up yet (no `work/protocol/`), so the package ships its own copy of the
+ *      SET of runtime-read protocol docs.
+ *   4. the legacy monorepo-relative `skills/setup/protocol/<name>` walk —
+ *      DEV-only, kept LAST (it only resolves inside this dev monorepo; an
+ *      installed CLI's walks escape into the consumer's filesystem → ENOENT,
+ *      which is why it cannot be the primary source).
+ *
+ * `cwd` is the target repo root (threaded from `renderPrompt`/`do`/`run`/the
+ * `render-prompt` CLI). When omitted, the target-repo step is simply skipped.
+ * `name` is the doc's BASENAME (e.g. `'CLAIM-PROTOCOL.md'`).
+ */
+export function resolveProtocolDoc(name, cwd, override) {
+    if (override) {
+        return override;
+    }
+    const here = dirname(fileURLToPath(import.meta.url));
+    // here = .../packages/dorfl/{src,dist}.
+    const candidates = [];
+    // 2. The target repo's adopted copy (authoritative when present).
+    if (cwd) {
+        candidates.push(resolve(cwd, WORK_ROOT, workFolderName('protocol'), name));
+    }
+    // 3. The copy vendored inside this package (published-CLI fallback). From
+    //    `src/` (tsx) `dist/` is a sibling; from `dist/` it is the dir itself.
+    candidates.push(resolve(here, '..', 'dist', 'protocol', name), resolve(here, 'protocol', name));
+    // 4. The legacy monorepo-relative `skills/setup/protocol/` walks — DEV-only,
+    //    LAST. The docs are OWNED by the `setup` skill (`skills/setup/protocol/`).
+    candidates.push(resolve(here, '..', '..', '..', 'skills', 'setup', 'protocol', name), resolve(here, '..', '..', '..', '..', 'skills', 'setup', 'protocol', name));
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return candidates[0];
+}
+/**
+ * Pull the canonical wrapper TEMPLATE out of CLAIM-PROTOCOL.md: the first fenced
+ * code block following the "The prompt handed to the work agent" heading. The
+ * returned text still contains the `<slug>` / `<prd>` placeholders verbatim — it
+ * is the single source of truth for the wrapper.
+ */
+export function extractCanonicalWrapperTemplate(protocol) {
+    const normalized = protocol.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    // Find the "prompt handed to the work agent" heading (any level).
+    let headingIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        const match = /^#{1,6}\s+(.*)$/.exec(lines[i]);
+        if (match && /prompt handed to the work agent/i.test(match[1])) {
+            headingIndex = i;
+            break;
+        }
+    }
+    if (headingIndex === -1) {
+        throw new Error('CLAIM-PROTOCOL.md: could not find the "prompt handed to the work agent" section');
+    }
+    // Find the opening fence of the first code block after the heading.
+    let open = -1;
+    for (let i = headingIndex + 1; i < lines.length; i++) {
+        if (/^```/.test(lines[i])) {
+            open = i;
+            break;
+        }
+        // A new heading before any fence means the wrapper block is missing.
+        if (/^#{1,6}\s+/.test(lines[i])) {
+            break;
+        }
+    }
+    if (open === -1) {
+        throw new Error('CLAIM-PROTOCOL.md: no fenced wrapper block under the work-agent-prompt section');
+    }
+    let close = -1;
+    for (let i = open + 1; i < lines.length; i++) {
+        if (/^```/.test(lines[i])) {
+            close = i;
+            break;
+        }
+    }
+    if (close === -1) {
+        throw new Error('CLAIM-PROTOCOL.md: unterminated wrapper code block');
+    }
+    return lines
+        .slice(open + 1, close)
+        .join('\n')
+        .trim();
+}
+/**
+ * The single-pass extractor-post-step for the `promptGuidance` NUDGE namespace.
+ * Resolves every `<!-- if promptGuidance.<member> --> … <!-- else --> … <!-- /if -->`
+ * conditional fragment in the canonical wrapper template ("Option A" — single
+ * wrapper, conditional fragments — see the ADR + this task's recorded decision):
+ * when the named nudge member resolves TRUE the IF-branch text is kept and the
+ * markers + ELSE-branch are stripped; when FALSE the ELSE-branch text is kept
+ * and the markers + IF-branch are stripped. The markers' own lines (and the
+ * newlines that terminate them) are consumed too, so the OFF-path output is
+ * BYTE-IDENTICAL to the pre-marker template — the guard the prompt-assembly
+ * byte-identity test pins.
+ *
+ * Pure string transform; runs AFTER `extractCanonicalWrapperTemplate` (a pure
+ * verbatim extractor stays a pure verbatim extractor) and BEFORE the
+ * `<slug>`/`<prd>` substitution.
+ */
+export function applyPromptGuidance(template, nudges = {}) {
+    const values = {
+        testFirst: nudges.testFirst === true,
+    };
+    return template.replace(/<!-- if promptGuidance\.(\w+) -->\n([\s\S]*?)\n<!-- else -->\n([\s\S]*?)\n<!-- \/if -->/g, (_match, member, ifBranch, elseBranch) => {
+        const on = values[member] === true;
+        return on ? ifBranch : elseBranch;
+    });
+}
+/**
+ * The constant wrapper, parameterised only by the task slug, its source prd
+ * slug, and (optionally) the resolved {@link PromptGuidance} nudges. Read
+ * verbatim from the work-contract and substituted — never a divergent hardcoded
+ * copy. `prd` may be `undefined` when the task has no `prd:` field. When
+ * `promptGuidance` is omitted (or every member resolves false) the output is
+ * BYTE-IDENTICAL to today's wrapper (the ELSE-branch of every conditional is
+ * the historic text).
+ */
+export function wrapper(slug, prd, options = {}) {
+    const protocolPath = resolveProtocolDoc('CLAIM-PROTOCOL.md', options.cwd, options.protocolPath);
+    const protocol = readFileSync(protocolPath, 'utf8');
+    const template = extractCanonicalWrapperTemplate(protocol);
+    const resolved = applyPromptGuidance(template, options.promptGuidance);
+    return resolved.replace(/<slug>/g, slug).replace(/<prd>/g, prd ?? '<prd>');
+}
+/** The heading prefix the requeue handoff notes are appended under. */
+const REQUEUE_HEADING_PREFIX = '## Requeue';
+/**
+ * Extract the accumulated requeue handoff notes from an item's BODY: the prose
+ * under each `## Requeue YYYY-MM-DD` heading (append-only; written by
+ * `requeue -m "<note>"` in `needs-attention.ts`). Returns one trimmed string per
+ * section in file order (oldest first, newest last); `[]` when none are present.
+ */
+export function extractRequeueNotes(content) {
+    const normalized = content.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    const notes = [];
+    for (let i = 0; i < lines.length; i++) {
+        if (!lines[i].startsWith(REQUEUE_HEADING_PREFIX)) {
+            continue;
+        }
+        // Collect the prose under this heading until the next `## ` heading or EOF.
+        const collected = [];
+        for (let j = i + 1; j < lines.length; j++) {
+            if (/^##\s/.test(lines[j])) {
+                break;
+            }
+            collected.push(lines[j]);
+        }
+        const note = collected.join('\n').trim();
+        if (note !== '') {
+            notes.push(note);
+        }
+    }
+    return notes;
+}
+/**
+ * Resolve the CONTINUE context for `slug`, runner-side, REUSING the SAME
+ * continue-detection the `requeue-continue-and-reset` claim/start path uses
+ * ({@link branchAheadOf}) — never a parallel re-derivation. Returns a
+ * {@link ContinueContext} iff the arbiter holds a `work/<slug>` ref AHEAD of
+ * main (the prior attempt's kept work); otherwise `undefined` (fresh-start: the
+ * common case, a first attempt or a `requeue --reset` that deleted the branch).
+ *
+ * The reason + handoff note(s) are read from the item BODY (the ledger file the
+ * caller already resolved), so they survive the requeue → tasks-ready (the pool) → claim gap
+ * and cross machines. The ref names match the two onboarding paths:
+ *   - in-place clone:  branchRef=`<arbiter>/work/<slug>`, mainRef=`<arbiter>/main`
+ *   - bare hub mirror: branchRef=`work/<slug>`,           mainRef=`main`
+ */
+export function resolveContinueContext(options) {
+    if (!branchAheadOf(options.cwd, options.branchRef, options.mainRef, options.env)) {
+        return undefined;
+    }
+    return {
+        arbiter: options.arbiter,
+        // Strip any `<arbiter>/` remote prefix off the ref to recover the bare
+        // `work/<type>-<slug>` branch name the prose points at.
+        branch: stripRemotePrefix(options.branchRef, options.arbiter),
+        reason: extractReason(options.content),
+        requeueNotes: extractRequeueNotes(options.content),
+    };
+}
+/**
+ * Recover the bare `work/<type>-<slug>` branch from a resolved ref: drop a
+ * leading `<arbiter>/` (the in-place remote-tracking form `<arbiter>/work/...`);
+ * the bare hub-mirror form (`work/...`) is returned as-is.
+ */
+function stripRemotePrefix(branchRef, arbiter) {
+    const prefix = `${arbiter}/`;
+    return branchRef.startsWith(prefix)
+        ? branchRef.slice(prefix.length)
+        : branchRef;
+}
+/**
+ * Build the CONTINUE block injected ahead of the task prompt in continue-mode.
+ * Pure text: a "you are continuing" framing + a pointer to review the prior diff
+ * vs `<arbiter>/main` + the needs-attention reason + the requeue handoff note(s)
+ * (read from the item body). Never emitted in fresh-start mode.
+ */
+export function buildContinueBlock(slug, ctx) {
+    const lines = [];
+    lines.push('## You are CONTINUING prior work on this task');
+    lines.push('');
+    lines.push(`This is NOT a fresh start. A prior attempt at '${slug}' was requeued, and ` +
+        `you have landed on its \`${ctx.branch}\` branch — it ALREADY carries that ` +
+        'work. Before you implement anything, REVIEW what the prior attempt did ' +
+        `(\`git diff ${ctx.arbiter}/main...${ctx.branch}\`) and BUILD ON what is ` +
+        'good — do NOT blindly restart or undo it.');
+    if (ctx.reason.trim() !== '') {
+        lines.push('');
+        lines.push('### Why the prior attempt stalled (needs-attention reason)');
+        lines.push('');
+        lines.push(ctx.reason.trim());
+    }
+    if (ctx.requeueNotes.length > 0) {
+        lines.push('');
+        lines.push('### Handoff note(s) from the requeue');
+        lines.push('');
+        for (const note of ctx.requeueNotes) {
+            lines.push(note.trim());
+            lines.push('');
+        }
+    }
+    return lines.join('\n').trim();
+}
+/**
+ * Build the full prompt: the canonical wrapper for `slug` (with its source prd
+ * substituted) followed by the task's own `## Prompt` body, appended verbatim.
+ *
+ * In CONTINUE-mode (a {@link ContinueContext} is supplied), a CONTINUE block is
+ * injected between the wrapper and the task prompt — telling the agent it is
+ * continuing, where to find the prior diff, why it stalled, and the human's
+ * handoff note(s). In FRESH-START mode (no context, the common case) the output
+ * is BYTE-IDENTICAL to the canonical wrapper + task prompt — no CONTINUE block.
+ */
+export function buildAgentPrompt(slug, prd, taskPrompt, options = {}) {
+    const head = wrapper(slug, prd, options);
+    if (options.continueContext) {
+        const block = buildContinueBlock(slug, options.continueContext);
+        return `${head}\n\n${block}\n\n${taskPrompt}\n`;
+    }
+    return `${head}\n\n${taskPrompt}\n`;
+}
+/** Raised for usage/environment problems (no slug, no task file, no prompt). */
+export class PromptError extends Error {
+}
+/**
+ * True iff the work-branch tip (`gate.branchRef`) is genuinely STRANDED: it
+ * resolves to a commit that is NOT reachable on the arbiter main
+ * (`gate.mainRef`). REUSES {@link isAncestor} (`gc.ts`) — the one reachability
+ * predicate — never a second one. When the branch ref does not resolve (no prior
+ * attempt's branch on the arbiter) the task is NOT treated as a stranded
+ * continue (false → `done/` stays unreachable, the safe direction). Read-only.
+ */
+function isStrandedDoneTip(gate) {
+    const tip = run('git', ['rev-parse', '--verify', '--quiet', `${gate.branchRef}^{commit}`], gate.cwd, { env: gate.env }).stdout.trim();
+    if (tip === '') {
+        return false; // no work-branch tip on the arbiter → not a stranded continue
+    }
+    // STRANDED ⇔ the tip is NOT an ancestor of the arbiter main (not integrated).
+    // REACHABLE (an ancestor) ⇒ COMPLETE ⇒ do NOT re-onboard.
+    return !isAncestor(gate.cwd, tip, gate.mainRef, gate.env);
+}
+/**
+ * Resolve a task's file: prefer `work/in-progress/<slug>.md`, fall back to
+ * `work/tasks/ready/<slug>.md` (the pool). Returns the parsed prd + extracted
+ * `## Prompt` body. Throws {@link PromptError} when neither file exists or it has
+ * no prompt body.
+ *
+ * On a CONTINUE (a {@link ContinueResolutionGate} is supplied), `work/done/` is
+ * added to the resolution AFTER `in-progress`/`tasks-ready` — but ONLY when the
+ * gate proves the work-branch tip is STRANDED (committed-but-not-on-the-arbiter).
+ * A genuinely-COMPLETE `done/` task (tip reachable on `<arbiter>/main`) is NEVER
+ * resolved, so onboard cannot resurrect a finished task (defect 3 / story 5).
+ * The `in-progress`/`tasks-ready` resolution is UNCHANGED in every case; `done/`
+ * is
+ * the only addition, and it is gated. With no gate (a fresh claim) the behaviour
+ * is byte-identical to the original `['in-progress','tasks-ready']`-only resolution.
+ *
+ * `--allow-backlog` (prd `do-allow-backlog-drive-staged-tasks-without-promotion`):
+ * when {@link ResolveTaskOptions.allowBacklog} is set, `tasks-backlog` (the staging
+ * folder) is appended at the LOWEST priority — after `tasks-ready`, so a slug
+ * present in BOTH the pool and staging resolves to the READY copy (the same-slug
+ * precedence the prd's decision 5 fixes). Default off ⇒ byte-identical to today
+ * (no autonomous path sets it; staging stays unreachable to `run`/auto-pick).
+ */
+export function resolveTask(cwd, slug, continueGate, options) {
+    const order = ['in-progress', 'tasks-ready'];
+    // `--allow-backlog`: append `tasks-backlog` at LOWEST priority (after
+    // `tasks-ready`), so the READY copy wins a same-slug tie and a staged task is
+    // only reachable behind the explicit flag. Default off ⇒ unchanged.
+    if (options?.allowBacklog === true) {
+        order.push('tasks-backlog');
+    }
+    // `done/` is appended ONLY on a continue whose work-branch tip is STRANDED —
+    // the tip-vs-arbiter gate (NEVER folder name alone). A complete task (tip on
+    // the arbiter) leaves the order untouched, so onboard never re-runs it.
+    if (continueGate && isStrandedDoneTip(continueGate)) {
+        order.push('done');
+    }
+    for (const folder of order) {
+        const path = workItemPath(cwd, folder, slug);
+        if (!existsSync(path)) {
+            continue;
+        }
+        const content = readFileSync(path, 'utf8');
+        const taskPrompt = extractPromptSection(content);
+        if (taskPrompt === undefined) {
+            throw new PromptError(`task '${slug}' (${workFolderRel(folder)}/${slug}.md) has no '## Prompt' section`);
+        }
+        const fm = parseFrontmatter(content);
+        // MIGRATE step (prd `prd-to-spec-vocabulary-cutover-and-migration-command`):
+        // read the parent-spec pointer off the new `fm.spec` field (populated beside
+        // `fm.prd` by the expand task). The `ResolvedTask.prd` field name is left
+        // unchanged (a struct-field rename is out of this batch's scope).
+        return { slug, path, folder, prd: fm.spec, taskPrompt };
+    }
+    const searched = order.map((f) => `${workFolderRel(f)}/`).join(', ');
+    throw new PromptError(`no task '${slug}' found in ${searched}`);
+}
+/** If HEAD is a `work/<slug>` branch, return `<slug>`; else `''`. */
+export function inferSlugFromBranch(cwd, env) {
+    const sym = run('git', ['symbolic-ref', '--quiet', '--short', 'HEAD'], cwd, { env });
+    if (sym.status !== 0) {
+        return '';
+    }
+    const match = /^work\/(.+)$/.exec(sym.stdout.trim());
+    return match ? match[1] : '';
+}
+/**
+ * The full `dorfl prompt [<slug>]` rendering: resolve the slug (explicit,
+ * else inferred from a `work/<slug>` branch), resolve its task file
+ * (in-progress over `tasks-ready`, the pool), and assemble the canonical wrapper
+ * + the task's
+ * `## Prompt`. Pure with respect to the repo (read-only) — the caller writes the
+ * result to stdout.
+ */
+/**
+ * Resolve the EFFECTIVE `promptGuidance` for an item by walking the precedence
+ * chain (highest → lowest): the per-task frontmatter override, the per-prd
+ * frontmatter override (only when the task carries a `prd:`), then the
+ * already-resolved repo policy. Each nudge member resolves independently — a
+ * task's `promptGuidance.testFirst` override never bleeds into a sibling
+ * member — mirroring the `humanOnly`/`autoBuild` per-item override shape.
+ *
+ * A task may carry the override even when it has NO `prd:` (a self-contained
+ * chore), by symmetry with `humanOnly` at the item level; `specFrontmatter`
+ * is then simply absent and the chain reads task ⇒ repo.
+ */
+export function resolveItemPromptGuidance(repoResolved, taskFrontmatter, specFrontmatter) {
+    const taskTestFirst = taskFrontmatter?.promptGuidance.testFirst;
+    const specTestFirst = specFrontmatter?.promptGuidance.testFirst;
+    return {
+        testFirst: taskTestFirst ?? specTestFirst ?? repoResolved.testFirst,
+    };
+}
+/**
+ * Locate a prd's file on disk: prefer `work/prds/ready/<slug>.md` (the
+ * auto-slice pool), then fall back to `work/prds/tasked/<slug>.md` (tasked,
+ * resting). Returns `undefined` when neither exists — the caller treats that
+ * as "no prd-level override available" and the precedence chain falls
+ * through to the repo policy (a missing prd is NOT an error at this seam;
+ * the per-item override is OPTIONAL by design).
+ */
+export function findSpecPath(cwd, specSlug) {
+    const candidates = [
+        workItemPath(cwd, 'specs-ready', specSlug),
+        workItemPath(cwd, 'specs-tasked', specSlug),
+    ];
+    for (const path of candidates) {
+        if (existsSync(path)) {
+            return path;
+        }
+    }
+    return undefined;
+}
+/**
+ * The convenience seam every caller of {@link buildAgentPrompt} reuses to
+ * resolve the per-item override: load the task frontmatter from its file +
+ * (when the task carries `prd:`) the prd frontmatter, then walk
+ * {@link resolveItemPromptGuidance}. Pure-ish (reads at most two files);
+ * returns the repo policy verbatim when neither item layer overrides anything.
+ */
+export function resolvePromptGuidanceForItem(options) {
+    const taskFm = parseFrontmatter(options.taskContent);
+    let specFm;
+    // MIGRATE step (prd `prd-to-spec-vocabulary-cutover-and-migration-command`):
+    // read the parent-spec pointer off `fm.spec` (populated beside `fm.prd`).
+    if (taskFm.spec !== undefined) {
+        const specPath = findSpecPath(options.cwd, taskFm.spec);
+        if (specPath !== undefined) {
+            specFm = parseFrontmatter(readFileSync(specPath, 'utf8'));
+        }
+    }
+    return resolveItemPromptGuidance(options.repoResolved, taskFm, specFm);
+}
+export function renderPrompt(options) {
+    const slug = options.slug || inferSlugFromBranch(options.cwd, options.env);
+    if (!slug) {
+        throw new PromptError('missing <slug> and the current branch is not a work/<slug> branch. ' +
+            'usage: dorfl prompt [<slug>]');
+    }
+    const task = resolveTask(options.cwd, slug);
+    // Per-item override layer: a task or prd may pin `promptGuidance.testFirst`
+    // in its frontmatter, superseding the resolved repo policy for THIS item.
+    // We ALWAYS walk the resolver (even when no repo policy was threaded), so a
+    // task can opt IN to the strengthened nudge even on a repo whose default is
+    // off (and vice-versa) — the per-item override is the escape hatch.
+    const resolvedGuidance = resolvePromptGuidanceForItem({
+        cwd: options.cwd,
+        repoResolved: { testFirst: options.promptGuidance?.testFirst === true },
+        taskContent: readFileSync(task.path, 'utf8'),
+    });
+    return buildAgentPrompt(task.slug, task.prd, task.taskPrompt, {
+        protocolPath: options.protocolPath,
+        cwd: options.cwd,
+        promptGuidance: resolvedGuidance,
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/dist/protocol/ADR-FORMAT.md

@@ -0,0 +1,47 @@
+# ADR Format
+
+ADRs live in `docs/adr/` and use sequential numbering: `0001-slug.md`, `0002-slug.md`, etc.
+
+Create the `docs/adr/` directory lazily — only when the first ADR is needed.
+
+## Template
+
+```md
+# {Short title of the decision}
+
+{1-3 sentences: what's the context, what did we decide, and why.}
+```
+
+That's it. An ADR can be a single paragraph. The value is in recording _that_ a decision was made and _why_ — not in filling out sections.
+
+## Optional sections
+
+Only include these when they add genuine value. Most ADRs won't need them.
+
+- **Status** frontmatter (`proposed | accepted | deprecated | superseded by ADR-NNNN`) — useful when decisions are revisited
+- **Considered Options** — only when the rejected alternatives are worth remembering
+- **Consequences** — only when non-obvious downstream effects need to be called out
+
+## Numbering
+
+Scan `docs/adr/` for the highest existing number and increment by one.
+
+## When to offer an ADR
+
+All three of these must be true:
+
+1. **Hard to reverse** — the cost of changing your mind later is meaningful
+2. **Surprising without context** — a future reader will look at the code and wonder "why on earth did they do it this way?"
+3. **The result of a real trade-off** — there were genuine alternatives and you picked one for specific reasons
+
+If a decision is easy to reverse, skip it — you'll just reverse it. If it's not surprising, nobody will wonder why. If there was no real alternative, there's nothing to record beyond "we did the obvious thing."
+
+### What qualifies
+
+- **Architectural shape.** "We're using a monorepo." "The write model is event-sourced, the read model is projected into Postgres."
+- **Integration patterns between contexts.** "Ordering and Billing communicate via domain events, not synchronous HTTP."
+- **Technology choices that carry lock-in.** Database, message bus, auth provider, deployment target. Not every library — just the ones that would take a quarter to swap out.
+- **Boundary and scope decisions.** "Customer data is owned by the Customer context; other contexts reference it by ID only." The explicit no-s are as valuable as the yes-s.
+- **Deliberate deviations from the obvious path.** "We're using manual SQL instead of an ORM because X." Anything where a reasonable reader would assume the opposite. These stop the next engineer from "fixing" something that was deliberate.
+- **Constraints not visible in the code.** "We can't use AWS because of compliance requirements." "Response times must be under 200ms because of the partner API contract."
+- **Rejected alternatives when the rejection is non-obvious.** If you considered GraphQL and picked REST for subtle reasons, record it — otherwise someone will suggest GraphQL again in six months.