dorfl 0.1.1 → 0.2.0

package/dist/intake-event.js

@@ -1,14 +1,14 @@
 /**
- * **`intake`'s PURE event-classification** (task `intake-event-classification`, prd
+ * **`intake`'s PURE event-classification** (task `intake-event-classification`, spec
  * `issue-intake` US #2 — the resume-on-thread-change behaviour).
  *
  * `intake` is a CONVERSATION on an issue thread: a run may ASK a clarifying question
- * and STOP, expecting a LATER run to resume from the updated thread (prd "Loop
+ * and STOP, expecting a LATER run to resume from the updated thread (spec "Loop
  * closure" / the decision table's ASK row). This module is the PURE CONTROL-PATH
  * classifier the re-run depends on: given an issue EVENT, it decides whether `intake`
  * should RE-EVALUATE the whole thread or IGNORE the event.
  *
- * THE CANONICAL RULE (from prd `issue-intake`, "The engine shape"): *"The loop
+ * THE CANONICAL RULE (from spec `issue-intake`, "The engine shape"): *"The loop
  * re-runs on a new comment OR an issue-body edit (re-evaluate the whole thread); a
  * buried prior-comment edit is IGNORED."*
  *
@@ -23,7 +23,7 @@
  * distinction the rule turns on is "a NEW turn vs an edit of a BURIED prior turn",
  * NOT "edit vs reply".
  *
- * SCOPE FENCE (prd "Scope: the engine only"): this is ONLY the pure classifier. It is
+ * SCOPE FENCE (spec "Scope: the engine only"): this is ONLY the pure classifier. It is
  * NOT CI's TRIGGER POLICY (command/every-issue, maintainer/anyone) — that is
  * `runner-in-ci`'s. CI's trigger LATER CONSULTS this classifier, but the policy of
  * WHO/WHAT may trigger lives in CI, not here. This module touches no seam, no git, no
@@ -32,10 +32,10 @@
  */
 /**
  * Classify an issue EVENT into the CONTROL-PATH decision: RE-EVALUATE the whole
- * thread, or IGNORE the event. The PURE realisation of the prd's canonical rule
+ * thread, or IGNORE the event. The PURE realisation of the spec's canonical rule
  * (no seam, no git, no `gh`).
  *
- * The table (prd `issue-intake` US #2):
+ * The table (spec `issue-intake` US #2):
  *
  * | event kind              | decision      | why                                          |
  * | ----------------------- | ------------- | -------------------------------------------- |

package/dist/intake-marker.d.ts

@@ -1,6 +1,6 @@
 import type { IssueComment } from './issue-provider.js';
 /**
- * **The intake MARKER** (task `intake-self-awareness-resumption-tracking`, prd
+ * **The intake MARKER** (task `intake-self-awareness-resumption-tracking`, spec
  * `issue-intake` US #2/#10): the ONE primitive the deterministic pre-decision
  * TRIAGE GATE is built on. A machine-readable HIDDEN HTML comment intake stamps on
  * EVERY comment it posts, recording a neutral FACT about what intake did:
@@ -24,7 +24,7 @@ import type { IssueComment } from './issue-provider.js';
  *   TERMINAL is the TRIAGE's interpretation, NEVER data in the marker (no `terminal`
  *   field): if a kind's terminal-ness ever changes that is a triage change and old
  *   markers stay valid.
- * - **`slug`** \u2014 present only on `kind=created` (which task/prd intake produced).
+ * - **`slug`** \u2014 present only on `kind=created` (which task/spec intake produced).
  * - **`seen=<id>,\u2026`** \u2014 the per-run DELTA of HUMAN comment ids intake READ this run
  *   (EXCLUDING intake's own marker-comments AND any human id already in a prior
  *   marker's `seen=`). Ids, not a count, because a count cannot distinguish "a new
@@ -43,7 +43,7 @@ export interface IntakeMarker {
     kind: IntakeMarkerKind;
     /** The HUMAN comment ids intake READ this run (the per-run delta; may be empty). */
     seen: string[];
-    /** The created task/prd slug \u2014 present only on `kind=created`. */
+    /** The created task/spec slug \u2014 present only on `kind=created`. */
     slug?: string;
 }
 /**

package/dist/intake-marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intake-marker.d.ts","sourceRoot":"","sources":["../src/intake-marker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC5B,iFAAiF;IACjF,IAAI,EAAE,gBAAgB,CAAC;IACvB,oFAAoF;IACpF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,GAC7D,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAsBxE;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAiBnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAYjE"}
+{"version":3,"file":"intake-marker.d.ts","sourceRoot":"","sources":["../src/intake-marker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7D,4FAA4F;AAC5F,MAAM,WAAW,YAAY;IAC5B,iFAAiF;IACjF,IAAI,EAAE,gBAAgB,CAAC;IACvB,oFAAoF;IACpF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAC,GAC7D,MAAM,CAaR;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAsBxE;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAiBnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAYjE"}

package/dist/intake-triage.d.ts

@@ -25,7 +25,7 @@ export type IntakeTriageDecision = {
 };
 /**
  * Run the TRIAGE over the issue's full comment thread (oldest-first, as
- * `listComments` returns it). The canonical branches (prd `issue-intake`):
+ * `listComments` returns it). The canonical branches (spec `issue-intake`):
  *
  * 1. **Last comment is INTAKE's** (carries a marker). Build `seenSet` = the UNION of
  *    every intake marker's `seen=` id-list, then:

package/dist/intake-triage.js

@@ -1,6 +1,6 @@
 import { parseIntakeMarker, seenSetFrom, } from './intake-marker.js';
 /**
- * **The intake TRIAGE GATE** (task `intake-self-awareness-resumption-tracking`, prd
+ * **The intake TRIAGE GATE** (task `intake-self-awareness-resumption-tracking`, spec
  * `issue-intake` US #2/#10): a DETERMINISTIC pre-decision gate that runs UNDER the
  * processing lock, BEFORE the decision prompt, deciding whether intake should run
  * the prompt at all. Built ENTIRELY on the thread MARKER (no sidecar, no cursor, no
@@ -21,7 +21,7 @@ import { parseIntakeMarker, seenSetFrom, } from './intake-marker.js';
 const TERMINAL_KINDS = new Set(['bounced', 'created']);
 /**
  * Run the TRIAGE over the issue's full comment thread (oldest-first, as
- * `listComments` returns it). The canonical branches (prd `issue-intake`):
+ * `listComments` returns it). The canonical branches (spec `issue-intake`):
  *
  * 1. **Last comment is INTAKE's** (carries a marker). Build `seenSet` = the UNION of
  *    every intake marker's `seen=` id-list, then:

package/dist/intake-trigger-template.d.ts

@@ -1,7 +1,7 @@
 /**
- * The `install-ci` ISSUE-INTAKE capability (prd `runner-in-ci`, task
+ * The `install-ci` ISSUE-INTAKE capability (spec `runner-in-ci`, task
  * `install-ci-intake-trigger-and-review-surface`; capability D: consider incoming
- * issues → task/prd, AND insertion point E: surface the review verdict back into
+ * issues → task/spec, AND insertion point E: surface the review verdict back into
  * the issue thread). This module GENERATES the one fixed intake workflow file and
  * STRUCTURALLY VALIDATES it, mirroring the snapshot-assertion style of
  * `advance-lifecycle-template.ts` / `advance-ci-template.ts` (the package depends on
@@ -10,13 +10,13 @@
  * ({@link deriveIntakeFlags}) — CI's merge-vs-propose POLICY, the load-bearing
  * testable logic the workflow encodes at runtime.
  *
- * SCOPE FENCE (prd Out-of-Scope): the issue→artifact TRANSFORM engine is
+ * SCOPE FENCE (spec Out-of-Scope): the issue→artifact TRANSFORM engine is
  * `issue-intake`'s (`intake <N>` + its four-outcome dispatch + the per-outcome
  * KNOBS + the lone-task review that posts to the issue thread). CI only
  * WIRES/SCHEDULES/INVOKES it and owns the merge-vs-propose POLICY + the delivery
  * surface. This module emits NO transform; it emits the WORKFLOW that calls it.
  *
- * The discipline (prd capability-D row + the merge-vs-propose POLICY + the two
+ * The discipline (spec capability-D row + the merge-vs-propose POLICY + the two
  * RESOLVED design decisions in the task):
  *
  *   - TRIGGERS: `issues` opened, `issue_comment` created, and a label
@@ -36,7 +36,7 @@
  *     everywhere" path is a LOUD, NON-DEFAULT opt-in — the default is conservative
  *     (propose / human-in-the-loop).
  *   - INSERTION POINT E (the issue-thread review surface): the review verdict over
- *     intake's generated prds/tasks is surfaced into the ISSUE THREAD via the
+ *     intake's generated specs/tasks is surfaced into the ISSUE THREAD via the
  *     `IssueProvider.postIssueComment` seam (issue thread, by NUMBER — NOT the PR
  *     seam `postPRComment`, which is keyed by url). This is REUSED, not new:
  *     `intake <N>` already runs the lone-task review/edit loop and posts its
@@ -59,7 +59,7 @@ import type { ResolvedCIConfig } from './install-ci-core.js';
 /** The capability id (the registry key + the emitted workflow file stem). */
 export declare const INTAKE_TRIGGER_CAPABILITY_ID = "intake";
 /** The wizard-facing label for the issue-intake capability. */
-export declare const INTAKE_TRIGGER_CAPABILITY_LABEL = "Consider incoming issues \u2192 task/prd + surface the review verdict into the issue thread (the intake trigger: issues / issue_comment / label)";
+export declare const INTAKE_TRIGGER_CAPABILITY_LABEL = "Consider incoming issues \u2192 task/spec + surface the review verdict into the issue thread (the intake trigger: issues / issue_comment / label)";
 /** The repo-relative path (under the output base) of the emitted workflow. */
 export declare const INTAKE_TRIGGER_WORKFLOW_PATH = "workflows/intake.yml";
 /**
@@ -90,7 +90,7 @@ export interface IntakeIntegrationFlags {
     task: 'merge' | 'propose';
     /**
      * The ORIGIN-TRUST verdict CI passes to `intake <N>` via `--origin-trust`
-     * (task `untrusted-origin-forces-build-propose`) so the emitted prd/task is
+     * (task `untrusted-origin-forces-build-propose`) so the emitted spec/task is
      * STAMPED with how it was born. Derived from the SAME `author_association` case
      * as the integration flags (it IS `authorTrusted` collapsed to the wire value),
      * so the stamp and the integration mode CANNOT desync. `intake.ts` writes it
@@ -116,7 +116,7 @@ export interface IntakeGateState {
 }
 /**
  * DERIVE the per-outcome merge-vs-propose flags from the gate state COMPOSED with
- * author-trust — CI's merge-vs-propose POLICY (prd "merge-vs-propose POLICY" +
+ * author-trust — CI's merge-vs-propose POLICY (spec "merge-vs-propose POLICY" +
  * "Composed with AUTHOR-TRUST"; task Decision 1). This is the load-bearing pure
  * logic the workflow encodes at runtime (it reads `author_association` off the
  * event payload and sets the flags accordingly):

package/dist/intake-trigger-template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intake-trigger-template.d.ts","sourceRoot":"","sources":["../src/intake-trigger-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAGH,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAG3D,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAErD,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B,qJACkG,CAAC;AAE/I,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,yBAAyB,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAI3D;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,8CAI9B,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACtC,mEAAmE;IACnE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,mEAAmE;IACnE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B;;;;;;;;OAQG;IACH,WAAW,EAAE,SAAS,GAAG,WAAW,CAAC;CACrC;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACvB,GAAG,sBAAsB,CAoBzB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACnC,OAAO,CAMT;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA4LvE;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACpC,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACvC,kEAAkE;IAClE,EAAE,EAAE,OAAO,CAAC;IACZ,iDAAiD;IACjD,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAsK5E"}
+{"version":3,"file":"intake-trigger-template.d.ts","sourceRoot":"","sources":["../src/intake-trigger-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAGH,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAG3D,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAErD,+DAA+D;AAC/D,eAAO,MAAM,+BAA+B,sJACmG,CAAC;AAEhJ,8EAA8E;AAC9E,eAAO,MAAM,4BAA4B,yBAAyB,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,QAAyB,CAAC;AAI3D;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,8CAI9B,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACtC,mEAAmE;IACnE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B,mEAAmE;IACnE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1B;;;;;;;;OAQG;IACH,WAAW,EAAE,SAAS,GAAG,WAAW,CAAC;CACrC;AAED,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC/B;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACvB,GAAG,sBAAsB,CAoBzB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC9B,iBAAiB,EAAE,MAAM,GAAG,SAAS,GACnC,OAAO,CAMT;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA4LvE;AAED,mEAAmE;AACnE,MAAM,WAAW,oBAAoB;IACpC,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACvC,kEAAkE;IAClE,EAAE,EAAE,OAAO,CAAC;IACZ,iDAAiD;IACjD,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,CAsK5E"}

package/dist/intake-trigger-template.js

@@ -1,7 +1,7 @@
 /**
- * The `install-ci` ISSUE-INTAKE capability (prd `runner-in-ci`, task
+ * The `install-ci` ISSUE-INTAKE capability (spec `runner-in-ci`, task
  * `install-ci-intake-trigger-and-review-surface`; capability D: consider incoming
- * issues → task/prd, AND insertion point E: surface the review verdict back into
+ * issues → task/spec, AND insertion point E: surface the review verdict back into
  * the issue thread). This module GENERATES the one fixed intake workflow file and
  * STRUCTURALLY VALIDATES it, mirroring the snapshot-assertion style of
  * `advance-lifecycle-template.ts` / `advance-ci-template.ts` (the package depends on
@@ -10,13 +10,13 @@
  * ({@link deriveIntakeFlags}) — CI's merge-vs-propose POLICY, the load-bearing
  * testable logic the workflow encodes at runtime.
  *
- * SCOPE FENCE (prd Out-of-Scope): the issue→artifact TRANSFORM engine is
+ * SCOPE FENCE (spec Out-of-Scope): the issue→artifact TRANSFORM engine is
  * `issue-intake`'s (`intake <N>` + its four-outcome dispatch + the per-outcome
  * KNOBS + the lone-task review that posts to the issue thread). CI only
  * WIRES/SCHEDULES/INVOKES it and owns the merge-vs-propose POLICY + the delivery
  * surface. This module emits NO transform; it emits the WORKFLOW that calls it.
  *
- * The discipline (prd capability-D row + the merge-vs-propose POLICY + the two
+ * The discipline (spec capability-D row + the merge-vs-propose POLICY + the two
  * RESOLVED design decisions in the task):
  *
  *   - TRIGGERS: `issues` opened, `issue_comment` created, and a label
@@ -36,7 +36,7 @@
  *     everywhere" path is a LOUD, NON-DEFAULT opt-in — the default is conservative
  *     (propose / human-in-the-loop).
  *   - INSERTION POINT E (the issue-thread review surface): the review verdict over
- *     intake's generated prds/tasks is surfaced into the ISSUE THREAD via the
+ *     intake's generated specs/tasks is surfaced into the ISSUE THREAD via the
  *     `IssueProvider.postIssueComment` seam (issue thread, by NUMBER — NOT the PR
  *     seam `postPRComment`, which is keyed by url). This is REUSED, not new:
  *     `intake <N>` already runs the lone-task review/edit loop and posts its
@@ -60,7 +60,7 @@ import { providerSecretsWithBlock } from './install-ci-core.js';
 /** The capability id (the registry key + the emitted workflow file stem). */
 export const INTAKE_TRIGGER_CAPABILITY_ID = 'intake';
 /** The wizard-facing label for the issue-intake capability. */
-export const INTAKE_TRIGGER_CAPABILITY_LABEL = 'Consider incoming issues → task/prd + surface the review verdict into the issue thread (the intake trigger: issues / issue_comment / label)';
+export const INTAKE_TRIGGER_CAPABILITY_LABEL = 'Consider incoming issues → task/spec + surface the review verdict into the issue thread (the intake trigger: issues / issue_comment / label)';
 /** The repo-relative path (under the output base) of the emitted workflow. */
 export const INTAKE_TRIGGER_WORKFLOW_PATH = 'workflows/intake.yml';
 /**
@@ -86,7 +86,7 @@ export const TRUSTED_AUTHOR_ASSOCIATIONS = [
 ];
 /**
  * DERIVE the per-outcome merge-vs-propose flags from the gate state COMPOSED with
- * author-trust — CI's merge-vs-propose POLICY (prd "merge-vs-propose POLICY" +
+ * author-trust — CI's merge-vs-propose POLICY (spec "merge-vs-propose POLICY" +
  * "Composed with AUTHOR-TRUST"; task Decision 1). This is the load-bearing pure
  * logic the workflow encodes at runtime (it reads `author_association` off the
  * event payload and sets the flags accordingly):
@@ -115,9 +115,9 @@ export function deriveIntakeFlags(options) {
     // ORIGIN-TRUST stamp (task `untrusted-origin-forces-build-propose`): the SAME
     // author-trust verdict, collapsed to the wire value `intake` stamps onto the
     // emitted artifact. Derived HERE — next to the integration flags, off the SAME
-    // `authorTrusted` input — so the stamp and the task/prd modes cannot desync.
+    // `authorTrusted` input — so the stamp and the task/spec modes cannot desync.
     // It is NOT a re-resolution of trust (CI already resolved it); it is the verdict
-    // being CARRIED so it survives the prd/task merge boundary (the becomes-code
+    // being CARRIED so it survives the spec/task merge boundary (the becomes-code
     // checkpoint is not laundered when the file lands on main).
     const originTrust = authorTrusted
         ? 'trusted'
@@ -159,12 +159,12 @@ export function generateIntakeWorkflow(config) {
     const setupWith = providerSecretsWithBlock(config);
     return `\
 # dorfl — the ISSUE INTAKE trigger in CI (capability D: consider incoming
-# issues → task/prd, PLUS insertion point E: surface the review verdict into the
-# issue thread, prd runner-in-ci). EMITTED by \`dorfl install-ci\`; the human
+# issues → task/spec, PLUS insertion point E: surface the review verdict into the
+# issue thread, spec runner-in-ci). EMITTED by \`dorfl install-ci\`; the human
 # commits it. DO NOT hand-edit a copy — re-run install-ci to upgrade the shell.
 #
 # WHAT IT DOES — \`dorfl intake <N>\` reads issue #N + its comment thread,
-# runs a prompt→verdict decision (ask / task / PRD / bounce), and dispatches it.
+# runs a prompt→verdict decision (ask / task / SPEC / bounce), and dispatches it.
 # CI owns ONLY the trigger + the merge-vs-propose POLICY + the delivery surface;
 # the TRANSFORM is the engine's (the Out-of-Scope fence — CI re-implements none of
 # it). The lone-task review/edit loop \`intake\` already runs ALSO surfaces its
@@ -250,7 +250,7 @@ env:
   # permissive merge side; author-trust then forces propose for a task from an
   # untrusted author.
   DORFL_AUTO_BUILD: 'false' # gate: will an agent auto-build the emitted task next?
-  DORFL_AUTO_TASK: 'false' # gate: will an agent auto-task the emitted prd next?
+  DORFL_AUTO_TASK: 'false' # gate: will an agent auto-task the emitted spec next?
 
 jobs:
   intake:
@@ -260,7 +260,7 @@ jobs:
     if: \${{ github.event.issue.number && !github.event.issue.pull_request }}
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           fetch-depth: 0
       - uses: ./.github/actions/dorfl-setup${setupWith}
@@ -308,8 +308,8 @@ jobs:
 
           # ORIGIN-TRUST stamp (task untrusted-origin-forces-build-propose):
           # derived from the SAME \${trusted} case above (one author-trust read,
-          # two consumers — the task/prd modes AND the stamp — so they cannot
-          # desync). \`intake\` STAMPS this onto the emitted prd/task frontmatter
+          # two consumers — the task/spec modes AND the stamp — so they cannot
+          # desync). \`intake\` STAMPS this onto the emitted spec/task frontmatter
           # (origin: issue + originTrust: <value>); it does NOT re-resolve trust
           # (that is CI's policy, passed IN). The stamp SURVIVES the merge boundary
           # so a later auto-task/auto-build of an untrusted-origin artifact still
@@ -410,7 +410,7 @@ export function validateIntakeWorkflow(text) {
     require('derives-propose-spec', /--propose-spec\b/.test(operative), 'the policy derivation must be able to emit `--propose-spec` (autoTask on).');
     // ORIGIN-TRUST stamp (task untrusted-origin-forces-build-propose): the shell
     // must derive `--origin-trust <trusted|untrusted>` from the SAME author-trust
-    // case it uses for the task/PRD modes, and pass it to `intake` so the emitted
+    // case it uses for the task/SPEC modes, and pass it to `intake` so the emitted
     // artifact is stamped (the stamp + the modes cannot desync).
     require('derives-origin-trust-untrusted', /--origin-trust=untrusted\b/.test(operative), 'the policy derivation must emit `--origin-trust=untrusted` for a non-trusted ' +
         'author (so the emitted artifact is stamped untrusted; task ' +

package/dist/intake-trigger-template.js.map

@@ -1 +1 @@
-{"version":3,"file":"intake-trigger-template.js","sourceRoot":"","sources":["../src/intake-trigger-template.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"intake-trigger-template.js","sourceRoot":"","sources":["../src/intake-trigger-template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,OAAO,EAAC,KAAK,EAAC,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAC,wBAAwB,EAAC,MAAM,sBAAsB,CAAC;AAE9D,6EAA6E;AAC7E,MAAM,CAAC,MAAM,4BAA4B,GAAG,QAAQ,CAAC;AAErD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,+BAA+B,GAC3C,8IAA8I,CAAC;AAEhJ,8EAA8E;AAC9E,MAAM,CAAC,MAAM,4BAA4B,GAAG,sBAAsB,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,KAAK,CAAC,IAAI,SAAS,CAAC;AAE3D,iFAAiF;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG;IAC1C,OAAO;IACP,QAAQ;IACR,cAAc;CACL,CAAC;AAwCX;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAGjC;IACA,MAAM,EAAC,IAAI,EAAE,aAAa,EAAC,GAAG,OAAO,CAAC;IACtC,+EAA+E;IAC/E,kEAAkE;IAClE,MAAM,IAAI,GAAwB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACtE,2EAA2E;IAC3E,0EAA0E;IAC1E,MAAM,IAAI,GACT,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACxD,8EAA8E;IAC9E,6EAA6E;IAC7E,+EAA+E;IAC/E,8EAA8E;IAC9E,iFAAiF;IACjF,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,WAAW,GAA4B,aAAa;QACzD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,WAAW,CAAC;IACf,OAAO,EAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC9B,iBAAqC;IAErC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,iBAAiB,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAQ,2BAAiD,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAwB;IAC9D,6EAA6E;IAC7E,qEAAqE;IACrE,MAAM,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACnD,OAAO;;;;;;;;;;;;;;;MAeF,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6CA2FmB,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6ErD,CAAC;AACF,CAAC;AAkBD;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,CAAC,EAAU,EAAE,OAAgB,EAAE,OAAe,EAAQ,EAAE;QACvE,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,EAAC,EAAE,EAAE,OAAO,EAAC,CAAC,CAAC;QAC9B,CAAC;IACF,CAAC,CAAC;IAEF,8EAA8E;IAC9E,4EAA4E;IAC5E,0EAA0E;IAC1E,iFAAiF;IACjF,wEAAwE;IACxE,MAAM,SAAS,GAAG,IAAI;SACpB,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACrC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,gFAAgF;IAChF,OAAO,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,IAAI,CAC9C,SAAS,CACT,EAAE,sEAAsE;QACxE,aAAa,CAAC,CAAC;IAChB,8EAA8E;IAC9E,gEAAgE;IAChE,OAAO,CAAC,8BAA8B,EAAE,sDAAsD,CAAC,IAAI,CAClG,SAAS,CACT,EAAE,4DAA4D;QAC9D,mDAAmD,CAAC,CAAC;IACtD,6EAA6E;IAC7E,sEAAsE;IACtE,OAAO,CAAC,gBAAgB,EAAE,CAAC,wBAAwB,CAAC,IAAI,CACvD,SAAS,CACT,EAAE,6EAA6E;QAC/E,0EAA0E,CAAC,CAAC;IAE7E,+EAA+E;IAC/E,OAAO,CAAC,uBAAuB,EAAE,mDAAmD,CAAC,IAAI,CACxF,IAAI,CACJ,EAAE,gEAAgE,CAAC,CAAC;IACrE,OAAO,CAAC,+BAA+B,EAAE,2DAA2D,CAAC,IAAI,CACxG,IAAI,CACJ,EAAE,0CAA0C;QAC5C,sEAAsE,CAAC,CAAC;IACzE,OAAO,CAAC,eAAe,EAAE,oDAAoD,CAAC,IAAI,CACjF,IAAI,CACJ,EAAE,yDAAyD,CAAC,CAAC;IAE9D,gFAAgF;IAChF,8EAA8E;IAC9E,gEAAgE;IAChE,OAAO,CAAC,2BAA2B,EAAE,CAAC,wDAAwD,CAAC,IAAI,CAClG,IAAI,CACJ,EAAE,wEAAwE;QAC1E,oEAAoE,CAAC,CAAC;IACvE,OAAO,CAAC,kBAAkB,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAChE,SAAS,CACT,EAAE,yEAAyE,CAAC,CAAC;IAC9E,8EAA8E;IAC9E,2EAA2E;IAC3E,OAAO,CAAC,kCAAkC,EAAE,qBAAqB,CAAC,IAAI,CACrE,IAAI,CACJ,EAAE,sEAAsE;QACxE,2DAA2D,CAAC,CAAC;IAE9D,+EAA+E;IAC/E,kFAAkF;IAClF,OAAO,CAAC,0BAA0B,EAAE,oBAAoB,CAAC,IAAI,CAC5D,IAAI,CACJ,EAAE,yEAAyE;QAC3E,yEAAyE,CAAC,CAAC;IAC5E,wDAAwD;IACxD,OAAO,CAAC,iCAAiC,EAAE,6EAA6E,CAAC,IAAI,CAC5H,IAAI,CACJ,EAAE,6EAA6E;QAC/E,kCAAkC,CAAC,CAAC;IACrC,2EAA2E;IAC3E,2EAA2E;IAC3E,yBAAyB;IACzB,OAAO,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,IAAI,CACtD,SAAS,CACT,EAAE,mEAAmE;QACrE,4CAA4C,CAAC,CAAC;IAC/C,OAAO,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,IAAI,CAClD,SAAS,CACT,EAAE,iEAAiE;QACnE,uCAAuC,CAAC,CAAC;IAC1C,mFAAmF;IACnF,OAAO,CAAC,oBAAoB,EAAE,gBAAgB,CAAC,IAAI,CAClD,SAAS,CACT,EAAE,0EAA0E;QAC5E,0EAA0E,CAAC,CAAC;IAC7E,OAAO,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,IAAI,CACtD,SAAS,CACT,EAAE,4EAA4E,CAAC,CAAC;IACjF,6EAA6E;IAC7E,8EAA8E;IAC9E,+EAA+E;IAC/E,6DAA6D;IAC7D,OAAO,CAAC,gCAAgC,EAAE,4BAA4B,CAAC,IAAI,CAC1E,SAAS,CACT,EAAE,+EAA+E;QACjF,6DAA6D;QAC7D,yCAAyC,CAAC,CAAC;IAC5C,OAAO,CAAC,8BAA8B,EAAE,0BAA0B,CAAC,IAAI,CACtE,SAAS,CACT,EAAE,gFAAgF,CAAC,CAAC;IACrF,OAAO,CAAC,+BAA+B,EAAE,2CAA2C,CAAC,IAAI,CACxF,SAAS,CACT,EAAE,yEAAyE;QAC3E,mCAAmC,CAAC,CAAC;IACtC,iFAAiF;IACjF,OAAO,CAAC,uBAAuB,EAAE,oBAAoB,CAAC,IAAI,CACzD,IAAI,CACJ,EAAE,8DAA8D,CAAC,CAAC;IACnE,OAAO,CAAC,sBAAsB,EAAE,mBAAmB,CAAC,IAAI,CACvD,IAAI,CACJ,EAAE,6DAA6D,CAAC,CAAC;IAElE,+EAA+E;IAC/E,6EAA6E;IAC7E,+EAA+E;IAC/E,OAAO,CAAC,yBAAyB,EAAE,qBAAqB,CAAC,IAAI,CAC5D,SAAS,CACT,EAAE,2EAA2E;QAC7E,+DAA+D,CAAC,CAAC;IAClE,gFAAgF;IAChF,6EAA6E;IAC7E,OAAO,CAAC,oBAAoB,EAAE,CAAC,iBAAiB,CAAC,IAAI,CACpD,SAAS,CACT,EAAE,4EAA4E;QAC9E,oEAAoE,CAAC,CAAC;IAEvE,8EAA8E;IAC9E,OAAO,CAAC,kBAAkB,EAAE,CAAC,cAAc,CAAC,IAAI,CAC/C,SAAS,CACT,EAAE,0EAA0E,CAAC,CAAC;IAC/E,OAAO,CAAC,gBAAgB,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAClD,SAAS,CACT,EAAE,gEAAgE,CAAC,CAAC;IAErE,+EAA+E;IAC/E,OAAO,CAAC,mBAAmB,EAAE,iCAAiC,CAAC,IAAI,CAClE,IAAI,CACJ,EAAE,yEAAyE,CAAC,CAAC;IAC9E,OAAO,CAAC,uBAAuB,EAAE,iEAAiE,CAAC,IAAI,CACtG,IAAI,CACJ,EAAE,yEAAyE;QAC3E,yCAAyC,CAAC,CAAC;IAE5C,+EAA+E;IAC/E,OAAO,CAAC,yBAAyB,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAChE,IAAI,CACJ,EAAE,wEAAwE;QAC1E,gEAAgE,CAAC,CAAC;IACnE,OAAO,CAAC,kCAAkC,EAAE,CAAC,uBAAuB,CAAC,IAAI,CACxE,SAAS,CACT,EAAE,+DAA+D,CAAC,CAAC;IAEpE,8EAA8E;IAC9E,OAAO,CAAC,0BAA0B,EAAE,8CAA8C,CAAC,IAAI,CACtF,IAAI,CACJ,EAAE,sDAAsD;QACxD,8DAA8D,CAAC,CAAC;IAEjE,OAAO,EAAC,EAAE,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,QAAQ,EAAC,CAAC;AAC9C,CAAC"}

package/dist/intake.d.ts

@@ -7,7 +7,7 @@ import { type Issue, type IssueComment, type IssueProvider } from './issue-provi
 import { parseReviewVerdict, type ReviewFinding, type ReviewVerdict } from './review-verdict.js';
 import { type IntakeTriageDecision } from './intake-triage.js';
 /**
- * **`intake <N>`** (prd `issue-intake`, task `intake-tracer-slice-outcome`): the
+ * **`intake <N>`** (spec `issue-intake`, task `intake-tracer-slice-outcome`): the
  * KEYSTONE of the issue front-door. A new, GATE-FREE command — explicit invocation
  * IS the authorization (precedent: `explicit-do-prd-not-gated-by-autoslice`), so
  * `autoTask`/`autoBuild` config does NOT apply — that reads a GitHub issue + its
@@ -21,24 +21,24 @@ import { type IntakeTriageDecision } from './intake-triage.js';
  * prompt's JUDGEMENT is NOT unit-tested (like the review prompt's is not); only the
  * dispatch is.
  *
- * The dispatcher implements the FULL four-outcome decision table (prd
+ * The dispatcher implements the FULL four-outcome decision table (spec
  * `issue-intake` — the source of truth):
  * - **ASK** (not clear enough to act on): `postIssueComment` the next clarifying
  *   question; emit NOTHING; STOP.
  * - **TASK** (clear AND fits ONE tracer-bullet task): write
- *   `work/backlog/<slug>.md` (`covers: []`, NO `prd:`) carrying `issue: N` (the
+ *   `work/backlog/<slug>.md` (`covers: []`, NO `spec:`) carrying `issue: N` (the
  *   lone-task closure link, NOT `Fixes #N`), integrate via {@link
  *   performIntegration} (default `propose`).
- * - **PRD** (clear AND coherent but >1 task — INCLUDING a coupled-but-SMALL pair,
- *   which is NEVER bounced): write the prd file (`work/prds/ready/<slug>.md`) with `issue: N` (+ the gate
- *   axes the verdict carried), integrate, STOP (tasking is the separate `do prd:`
+ * - **SPEC** (clear AND coherent but >1 task — INCLUDING a coupled-but-SMALL pair,
+ *   which is NEVER bounced): write the spec file (`work/specs/ready/<slug>.md`) with `issue: N` (+ the gate
+ *   axes the verdict carried), integrate, STOP (tasking is the separate `do spec:`
  *   step).
  * - **BOUNCE** (genuinely UNRELATED concerns — no shared vision): the bounce is
  *   TERMINAL (the asks are unrelated and must be re-filed), so intake CLOSES the
  *   issue ATOMICALLY — the "file separate issues" text as the closing comment +
  *   `reason: not planned` (the honest GitHub-native signal) in ONE `closeIssue`
  *   call; emit NOTHING. Intake closes on BOUNCE (as not planned); NEVER on
- *   task/prd (CI's close-job closes those via the `issue:` field) / ask.
+ *   task/spec (CI's close-job closes those via the `issue:` field) / ask.
  *
  * The per-outcome integration KNOBS, the processing LOCK, and event-classification
  * are LATER tasks and are NOT built here (default `propose` is fine here).
@@ -50,10 +50,10 @@ import { type IntakeTriageDecision } from './intake-triage.js';
  */
 /**
  * The four outcomes the decision prompt classifies an issue into (the decision
- * table). EXPAND step (prd
+ * table). EXPAND step (spec
  * `prd-to-spec-vocabulary-cutover-and-migration-command`): the `spec` outcome
  * names the "clear + coherent but >1 task" classification (a parent SPEC). HARD
- * CUTOVER (contract step): the legacy `prd` outcome token is GONE — the prompt
+ * CUTOVER (contract step): the legacy ''prd'' outcome token is GONE — the prompt
  * emits `spec` and the parser rejects any other token.
  */
 export type IntakeOutcome = 'ask' | 'task' | 'spec' | 'bounce';
@@ -79,7 +79,7 @@ export interface IntakeVerdict {
     /**
      * The drafted task BODY (`task` outcome) — the markdown AFTER the frontmatter
      * (the `## What to build` / `## Acceptance criteria` / `## Prompt` sections). The
-     * dispatcher writes the frontmatter (slug/title/`covers: []`, NO `prd:`) carrying
+     * dispatcher writes the frontmatter (slug/title/`covers: []`, NO `spec:`) carrying
      * the lone-task `issue: N` closure link itself; the agent never writes
      * git-visible files.
      */
@@ -108,7 +108,7 @@ export interface IntakeVerdict {
     specBody?: string;
     /**
      * The spec's gate axes (`spec` outcome) AS THE PROMPT JUDGED THEM — surfaced onto
-     * the emitted spec frontmatter (prd `issue-intake` US #8: "the emitted artifact
+     * the emitted spec frontmatter (spec `issue-intake` US #8: "the emitted artifact
      * carries … its own gate axes"). Both omitted (undeclared) by default; the prompt
      * sets `specHumanOnly: true` when a human should drive the TASKING and/or
      * `specNeedsAnswers: true` when open questions remain.
@@ -130,16 +130,16 @@ export interface IntakeResult {
     outcome: IntakeRunOutcome;
     /** The issue number acted on. */
     issueNumber: number;
-    /** The slug of the emitted artifact (task OR prd outcome). */
+    /** The slug of the emitted artifact (task OR spec outcome). */
     emittedSlug?: string;
-    /** Repo-relative path of the emitted artifact (task OR prd outcome). */
+    /** Repo-relative path of the emitted artifact (task OR spec outcome). */
     emitted?: string;
     /** True iff a comment was posted on the issue (ask / bounce outcomes). */
     commented?: boolean;
     /**
      * True iff the ISSUE was closed (the BOUNCE outcome — a terminal bounce closes
      * the issue atomically as `not planned`). Additive (mirrors {@link commented}),
-     * so CI / callers can observe the close. Never set on ask/task/prd.
+     * so CI / callers can observe the close. Never set on ask/task/spec.
      */
     closed?: boolean;
     /** Human-readable summary of the terminal condition. */
@@ -195,10 +195,10 @@ export interface PerformIntakeOptions {
     /** The HOST-ONLY sessions root for the pi session file. */
     sessionsDir?: string;
     /**
-     * The PER-OUTCOME integration modes (prd `issue-intake` US #9) the emitted artifact integrates
+     * The PER-OUTCOME integration modes (spec `issue-intake` US #9) the emitted artifact integrates
      * THROUGH the shared core with. Because `intake` decides the artifact TYPE at
      * RUNTIME, the mode is keyed per type: an emitted task integrates with
-     * `integration.task`, an emitted prd with `integration.prd` (`propose` =
+     * `integration.task`, an emitted spec with `integration.spec` (`propose` =
      * push the `work/<slug>` branch + open a PR, NO `main` touch; `merge` = land on
      * `main`). The CLI resolves this from the granular + aggregate flags via
      * {@link resolveIntakeIntegrationModes}; ask/bounce emit nothing, so the modes
@@ -208,8 +208,8 @@ export interface PerformIntakeOptions {
     /**
      * **The ORIGIN-TRUST verdict, passed IN** (task
      * `untrusted-origin-forces-build-propose`; the `--origin-trust <trusted|untrusted>`
-     * CLI flag). `intake` STAMPS `origin: issue` + this `originTrust` onto every prd/
-     * task it emits, so the author-trust signal SURVIVES the prd/task merge
+     * CLI flag). `intake` STAMPS `origin: issue` + this `originTrust` onto every spec/
+     * task it emits, so the author-trust signal SURVIVES the spec/task merge
      * boundary (a landed-on-main artifact otherwise erases how it was born, the
      * laundering gap). `intake` does NOT resolve trust itself: the verdict is CI's
      * POLICY, computed in the `intake.yml` shell from the SAME `author_association`
@@ -227,7 +227,7 @@ export interface PerformIntakeOptions {
      */
     noPR?: boolean;
     /**
-     * **The per-repo PRD-PLACEMENT default, passed IN** (prd
+     * **The per-repo SPEC-PLACEMENT default, passed IN** (spec
      * `staging-pool-position-gate-and-trust-model` US #2/#5, task
      * `pre-prd-staging-pool-split-and-untrusted-prd-placement`). The resolved
      * per-repo default landing for `intake`-authored prds (`pre-proposed` =
@@ -235,8 +235,8 @@ export interface PerformIntakeOptions {
      * into the shared placement resolver (`src/placement.ts`). The resolver
      * overlays an EXPLICIT operator flag ({@link explicitSpecsLandIn}, top) and
      * the UNTRUSTED-ORIGIN force (`originTrust: untrusted` ⇒ staging) on top.
-     * Unset ⇒ the resolver's built-in floor applies (`staging` = `prds/proposed/`,
-     * the conservative landing). The PRD TWIN of `tasksLandIn` on the tasker
+     * Unset ⇒ the resolver's built-in floor applies (`staging` = `specs/proposed/`,
+     * the conservative landing). The SPEC TWIN of `tasksLandIn` on the tasker
      * path — one resolver, two lifecycles.
      */
     specsLandIn?: SpecsLandIn;
@@ -267,35 +267,48 @@ export interface PerformIntakeOptions {
      * must not act as the bot. Absent ⇒ ambient (today's behaviour).
      */
     identity?: Identity;
+    /**
+     * **The cross-job merge-serialiser CAS-retry cap** (config `mergeRetries`, spec
+     * `land-time-reverify-and-parallel-merge-ceiling` Story 5 / Applied Answer q1
+     * (a)). Threaded VERBATIM into the shared integrate core so a wide-matrix CI's
+     * raised cap reaches intake's task/spec emit land tail too (task
+     * `thread-merge-retries-cross-task-and-ratify-default`). Resolved ONCE at the
+     * entry point (the CLI) through the env + per-repo layers of the gate-family
+     * precedence chain — the `intake` command has NO `--merge-retries` flag today
+     * (the flag layer legitimately does not apply here; intake is
+     * unattended-CI-first, env + per-repo cover the need). Unset ⇒ the engine's
+     * `DEFAULT_MERGE_RETRIES = 1000` (byte-for-byte unchanged).
+     */
+    mergeRetries?: number;
     /** Environment for child git/agent processes (the AGENT-launch ambient env). */
     env?: NodeJS.ProcessEnv;
     /** Sink for human-readable progress notes. */
     note?: (message: string) => void;
 }
 /**
- * **The STAGED-prds dir** (prd `staging-pool-position-gate-and-trust-model`,
+ * **The STAGED-prds dir** (spec `staging-pool-position-gate-and-trust-model`,
  * task `pre-prd-staging-pool-split-and-untrusted-prd-placement`, governing
  * ADR `placement-is-runner-deterministic-humanonly-is-agent-judgement`). When
  * the runner-deterministic placement resolver picks the staging side for an
- * `intake`-authored prd, the runner writes the prd file HERE instead of in
- * `work/prds/ready/`. An item born in `prds/proposed/` is durable + readable but NOT in
- * the tasking candidate POOL (`work/prds/ready/` is the pool). A runner/human-owned promotion
- * ({@link promoteFromPreSpec} in `needs-attention.ts`) moves an approved prd
- * `prds/proposed/ → prds/ready/` to make it taskable.
+ * `intake`-authored spec, the runner writes the spec file HERE instead of in
+ * `work/specs/ready/`. An item born in `specs/proposed/` is durable + readable but NOT in
+ * the tasking candidate POOL (`work/specs/ready/` is the pool). A runner/human-owned promotion
+ * ({@link promoteFromPreSpec} in `needs-attention.ts`) moves an approved spec
+ * `specs/proposed/ → specs/ready/` to make it taskable.
  */
 export declare const STAGED_SPECS_DIR: string;
 /**
  * The emitted artifact TYPE `intake` decides at RUNTIME — a `task` verdict emits
- * `work/backlog/<slug>.md`, a `prd` verdict emits the prd file (`work/prds/ready/<slug>.md`). The two
+ * `work/backlog/<slug>.md`, a `spec` verdict emits the spec file (`work/specs/ready/<slug>.md`). The two
  * granular flag axes (`--merge-task`/`--propose-task` vs `--merge-spec`/
  * `--propose-spec`) are keyed on this. (ask/bounce emit NOTHING, so the modes are
  * no-ops for them.)
  */
 export type IntakeArtifactType = 'task' | 'spec';
 /**
- * The PER-OUTCOME integration mode FLAG SET (prd `issue-intake` US #9). Because
+ * The PER-OUTCOME integration mode FLAG SET (spec `issue-intake` US #9). Because
  * `intake` decides the artifact TYPE at runtime, a single `--merge`/`--propose`
- * cannot express a type-conditional policy ("merge a prd but propose a task") —
+ * cannot express a type-conditional policy ("merge a spec but propose a task") —
  * hence the four GRANULAR per-type flags layered over the two AGGREGATES:
  *
  * - **granular:** `--merge-spec`/`--propose-spec` apply iff the outcome is a spec;
@@ -306,9 +319,9 @@ export type IntakeArtifactType = 'task' | 'spec';
  * author-trust) is CI's POLICY, authored in `runner-in-ci` — NOT here.
  */
 export interface IntakeIntegrationFlags {
-    /** Aggregate: merge BOTH a task and a prd (the broad knob, overridden per type). */
+    /** Aggregate: merge BOTH a task and a spec (the broad knob, overridden per type). */
     merge?: boolean;
-    /** Aggregate: propose BOTH a task and a prd. */
+    /** Aggregate: propose BOTH a task and a spec. */
     propose?: boolean;
     /** Granular: merge a spec (overrides the aggregate for the spec outcome). */
     mergeSpec?: boolean;
@@ -324,17 +337,17 @@ export interface IntakeIntegrationModes {
     /** The mode an EMITTED task integrates with. */
     task: IntegrationMode;
     /**
-     * The mode an EMITTED spec integrates with. `spec` is the CANONICAL key (prd →
+     * The mode an EMITTED spec integrates with. `spec` is the CANONICAL key (spec →
      * spec cutover); the user-facing `--merge-spec`/`--propose-spec` flags that FEED
      * it carry the same `spec` spelling (the cli-flag rename landed in batch 4f).
      */
     spec: IntegrationMode;
 }
 /**
- * The PURE per-outcome integration mode resolution (prd `issue-intake` US #9 —
+ * The PURE per-outcome integration mode resolution (spec `issue-intake` US #9 —
  * the canonical table). Given ONLY the flag set, resolve BOTH per-type modes in
  * one eager pass (so a usage error is caught before the runtime verdict is even
- * known). The rules, all decided in the prd:
+ * known). The rules, all decided in the spec:
  *
  * - **unset ⇒ propose for BOTH** (conservative default; matches `do`).
  * - **aggregates:** `--merge` ⇒ merge both; `--propose` ⇒ propose both (this axis
@@ -377,7 +390,7 @@ export declare function performIntake(options: PerformIntakeOptions): Promise<In
  *   `commit` (the additive {@link IntegrateResult.commit}) in merge. A degraded
  *   propose (no `url`) or a failed merge-tip read (no `commit`) simply OMITS the
  *   link — the comment still confirms what was created (the artifact is safe on the
- *   branch/main regardless). No prd link beyond the slug.
+ *   branch/main regardless). No spec link beyond the slug.
  * - carries the FULL intake MARKER via the SHARED {@link stampIntakeMarker} helper
  *   (`kind=created slug=<slug> seen=<id>,…`) so the triage's `already-terminal`
  *   branch consumes it — the comment cannot re-trigger intake.
@@ -390,13 +403,13 @@ export declare function composeIntakeCompletionComment(params: {
 }): string;
 /**
  * Render the backlog task file: the frontmatter (`title`/`slug`/`covers: []`, NO
- * `prd:` — its own source of truth, prd `issue-intake` decision table) carrying the lone-task
+ * `spec:` — its own source of truth, spec `issue-intake` decision table) carrying the lone-task
  * `issue: N` closure link + the drafted body. The task closes its source issue
  * via its `issue:` field (the provider-agnostic link a FUTURE CI close-job reads
  * from folder + field state); it carries NO `Fixes #N` (a deferred GitHub-only
  * optimisation, structurally unplaceable on the `--merge` path). The number is
- * the task's own closure path — `issue:` XOR `prd:`; a lone task never carries a
- * `prd:` (prd `issue-intake` decision table). When the agent drafted no body, a thin default
+ * the task's own closure path — `issue:` XOR `spec:`; a lone task never carries a
+ * `spec:` (spec `issue-intake` decision table). When the agent drafted no body, a thin default
  * scaffold keeps the file a valid task.
  */
 export declare function renderBacklogTask(params: {
@@ -413,16 +426,16 @@ export declare function renderBacklogTask(params: {
     originTrust?: OriginTrust;
 }): string;
 /**
- * Render the emitted prd file: the frontmatter (`title`/`slug` + the loop-closure
- * `issue: N` + the gate axes the prompt JUDGED) followed by the drafted prd body.
- * For a FANNED prd the `issue: N` lives ONLY on the prd — never duplicated across
- * the N fanned tasks, which reach it via `task.prd: → prd issue:` (a fanned
- * task carries `prd:`, NOT its own `issue:`; the lone-task outcome is the only
- * one that puts `issue:` on a task). The close JOB reaches the prd's number via
- * `task.prd: → prd issue:`. The gate axes (`humanOnly`/`needsAnswers`) are emitted ONLY when the
+ * Render the emitted spec file: the frontmatter (`title`/`slug` + the loop-closure
+ * `issue: N` + the gate axes the prompt JUDGED) followed by the drafted spec body.
+ * For a FANNED spec the `issue: N` lives ONLY on the spec — never duplicated across
+ * the N fanned tasks, which reach it via `task.spec: → spec issue:` (a fanned
+ * task carries `spec:`, NOT its own `issue:`; the lone-task outcome is the only
+ * one that puts `issue:` on a task). The close JOB reaches the spec's number via
+ * `task.spec: → spec issue:`. The gate axes (`humanOnly`/`needsAnswers`) are emitted ONLY when the
  * verdict declared them `true` — an omitted axis is `undefined` (undeclared), the
  * same convention `frontmatter.ts` parses. When the agent drafted no body, a thin
- * default scaffold keeps the file a valid prd that `do prd:` can later task.
+ * default scaffold keeps the file a valid spec that `do spec:` can later task.
  */
 export declare function renderSpec(params: {
     slug: string;
@@ -544,20 +557,20 @@ export declare function buildLoneTaskReviewPrompt(input: LoneTaskReviewGateInput
  */
 export declare const parseLoneTaskReviewVerdict: typeof parseReviewVerdict;
 /**
- * Build the intake decision PRD (an inline prompt builder, like `buildTaskingPrd`
+ * Build the intake decision SPEC (an inline prompt builder, like `buildTaskingPrd`
  * in `tasking.ts` / the reviewer prompts in `review-gate.ts` — NOT a standalone
  * asset/`.md` file; no such convention exists in this package). It encodes the FULL
- * four-outcome decision table (prd `issue-intake` — the source of truth) and the
+ * four-outcome decision table (spec `issue-intake` — the source of truth) and the
  * three DECISION AIDS stated once there:
  *
  * 1. the **"clear?" bar** = `to-task`/`needsAnswers`' "would I build the wrong
  *    thing if I guessed?" — if a material requirement/scope/acceptance question is
  *    unanswered, ASK (never guess a spec from a vague issue);
  * 2. the **"one task?" bar** = `to-task`' tracer-bullet test (one thin end-to-end
- *    path, demoable on its own) — fits → TASK, needs splitting → PRD;
- * 3. **PRD vs BOUNCE** turns on a **SHARED VISION**: coupled (even if small) → PRD;
+ *    path, demoable on its own) — fits → TASK, needs splitting → SPEC;
+ * 3. **SPEC vs BOUNCE** turns on a **SHARED VISION**: coupled (even if small) → SPEC;
  *    genuinely unrelated → BOUNCE. Size NEVER forces a bounce — only unrelatedness
- *    (the over-bounce guard: a coupled-but-small pair gets a light PRD, never a
+ *    (the over-bounce guard: a coupled-but-small pair gets a light SPEC, never a
  *    bounce).
  *
  * The prompt anchors to `to-task`/`to-spec` for the task/spec SHAPES it drafts. Its