dorfl 0.1.1 → 0.2.0

package/dist/tasking-eligibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasking-eligibility.d.ts","sourceRoot":"","sources":["../src/tasking-eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAEpD,YAAY,EAAC,aAAa,EAAC,CAAC;AAE5B,kFAAkF;AAClF,MAAM,WAAW,iBAAiB;IACjC,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACvC,wEAAwE;IACxE,SAAS,EAAE,aAAa,CAAC;IACzB,sEAAsE;IACtE,YAAY,EAAE,aAAa,CAAC;IAC5B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gFAAgF;IAChF,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACxC,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,aAAa,EAC3B,QAAQ,EAAE,OAAO,EACjB,QAAQ,UAAQ,GACd,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,iBAAiB,CAGnB;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,uBAAuB,GAC5B,wBAAwB,CAa1B"}
+{"version":3,"file":"tasking-eligibility.d.ts","sourceRoot":"","sources":["../src/tasking-eligibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,kBAAkB,CAAC;AAEpD,YAAY,EAAC,aAAa,EAAC,CAAC;AAE5B,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IACjC,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACvC,yEAAyE;IACzE,SAAS,EAAE,aAAa,CAAC;IACzB,uEAAuE;IACvE,YAAY,EAAE,aAAa,CAAC;IAC5B,gFAAgF;IAChF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iFAAiF;IACjF,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACxC,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,iBAAiB,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC9B,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,aAAa,EAC3B,QAAQ,EAAE,OAAO,EACjB,QAAQ,UAAQ,GACd,OAAO,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,MAAM,EAAE,EACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,iBAAiB,CAGnB;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,uBAAuB,GAC5B,wBAAwB,CAa1B"}

package/dist/tasking-eligibility.js

@@ -1,21 +1,21 @@
 /**
  * Pure tasking-eligibility resolution — the auto-task decision layer, one level
- * UP from the build gate (`eligibility.ts`). No I/O: callers pass in the prd's
+ * UP from the build gate (`eligibility.ts`). No I/O: callers pass in the spec's
  * two autonomy axes (`humanOnly`, `needsAnswers`), the repo's `autoTask` policy,
- * the prd's `taskedAfter` slugs, and the set of slugs whose prds are already
- * TASKED (resolved against `work/prds/tasked/` residence, NOT `work/done/`).
+ * the spec's `taskedAfter` slugs, and the set of slugs whose prds are already
+ * TASKED (resolved against `work/specs/tasked/` residence, NOT `work/done/`).
  *
  * This mirrors the build-gate shape deliberately (CONTEXT.md / the `auto-slice`
- * prd): the same `needsAnswers !== true && humanOnly !== true && <repo policy>`
- * predicate, applied to a prd's two axes + the repo's `autoTask` toggle — and a
- * cross-prd ordering check that resolves against tasked-ness rather than done-ness.
+ * spec): the same `needsAnswers !== true && humanOnly !== true && <repo policy>`
+ * predicate, applied to a spec's two axes + the repo's `autoTask` toggle — and a
+ * cross-spec ordering check that resolves against tasked-ness rather than done-ness.
  */
 /**
  * Resolve the tasking autonomy gate: agent-taskable iff `needsAnswers` is not
  * `true` AND `humanOnly` is not `true` AND the repo's `autoTask` POLICY is
  * satisfied — where the policy is satisfied either by the repo's `autoTask`
  * toggle being on (the AUTO-PICK pool path) OR by the target being named
- * EXPLICITLY (`explicit: true` — `do prd:<slug>`, where naming IS the
+ * EXPLICITLY (`explicit: true` — `do spec:<slug>`, where naming IS the
  * authorization, mirroring `do <task>` vs `autoBuild`). Both readiness axes
  * block orthogonally and are never agent-taskable regardless of policy; a human
  * is never bound by either. The exact mirror of `resolveGate` (the build gate),
@@ -30,9 +30,9 @@ export function resolveTaskGate(humanOnly, needsAnswers, autoTask, explicit = fa
     return explicit || autoTask;
 }
 /**
- * Resolve a prd's `taskedAfter` against the slugs of prds already TASKED (NOT
- * `done/`): satisfied iff every listed prd is present in `taskedSlugs`. An
- * untasked blocker ⇒ not yet taskable (so this prd's emitted tasks can
+ * Resolve a spec's `taskedAfter` against the slugs of prds already TASKED (NOT
+ * `done/`): satisfied iff every listed spec is present in `taskedSlugs`. An
+ * untasked blocker ⇒ not yet taskable (so this spec's emitted tasks can
  * reference the real slugs of those prds' tasks).
  */
 export function resolveTaskedAfter(taskedAfter, taskedSlugs) {

package/dist/tasking-lock.d.ts

@@ -3,7 +3,7 @@ export type AcquireTaskingLockOutcome = 'acquired' | 'usage-error' | 'lost' | 'c
 /** Maps onto the claim-CAS exit codes (identical semantics). */
 export type AcquireTaskingLockExitCode = 0 | 1 | 2 | 3;
 export interface AcquireTaskingLockOptions {
-    /** The prd slug to lock (`work/prds/ready/<slug>.md`). */
+    /** The spec slug to lock (`work/specs/ready/<slug>.md`). */
     slug: string;
     /** Working clone/worktree the lock acquire runs in. */
     cwd: string;
@@ -26,10 +26,10 @@ export interface AcquireTaskingLockResult {
     /** Human-readable summary of the terminal condition. */
     message: string;
     /**
-     * On a successful acquire (`acquired`), the git BLOB sha of the prd body that
-     * the lock TOOK (`work/prds/ready/<slug>.md` on the arbiter). This IS the snapshot the
+     * On a successful acquire (`acquired`), the git BLOB sha of the spec body that
+     * the lock TOOK (`work/specs/ready/<slug>.md` on the arbiter). This IS the snapshot the
      * tasker reads + tasks from; the integrate transition compares the current
-     * `work/prds/ready/<slug>.md` blob against it to fail loud on a concurrent edit (the
+     * `work/specs/ready/<slug>.md` blob against it to fail loud on a concurrent edit (the
      * read-stability backstop). `undefined` unless `outcome === 'acquired'` (and on
      * dry-run, where nothing was published).
      */
@@ -47,7 +47,7 @@ export type ReleaseTaskingLockOutcome = 'released' | 'usage-error' | 'lost' | 'c
 /** Maps onto the claim-CAS exit codes, plus `4` for a STALE (conflicting) lock. */
 export type ReleaseTaskingLockExitCode = 0 | 1 | 2 | 3 | 4;
 export interface ReleaseTaskingLockOptions {
-    /** The prd slug whose lock to release. */
+    /** The spec slug whose lock to release. */
     slug: string;
     /** Working clone/worktree the release runs in. */
     cwd: string;
@@ -68,9 +68,9 @@ export interface ReleaseTaskingLockOptions {
     /**
      * The tasker review→edit LOOP's **decomposition-unclear** verdict
      * (`slicer-review-edit-loop`), or the task-SET acceptance gate's `block`:
-     * instead of DELETING the lock (returning the prd to the claimable/taskable
+     * instead of DELETING the lock (returning the spec to the claimable/taskable
      * pool), amend it `active → stuck` with this reason recorded on the entry,
-     * emitting NO guessed tasks. The prd body stays in `work/prds/ready/` (it never moved
+     * emitting NO guessed tasks. The spec body stays in `work/specs/ready/` (it never moved
      * under the lock); the stuck lock IS the tasking needs-attention surface (no
      * `work/needs-attention/` folder write), so it is NOT re-taskable until a human
      * resolves it via `release-lock`/`resume`. Omitted ⇒ the normal release DELETES
@@ -93,9 +93,9 @@ export interface ReleaseTaskingLockResult {
 /**
  * Release the tasking lock for `slug`: DELETE the unified `action: task` lock ref
  * (idempotent — an already-absent ref is a clean `released`). It moves NO lifecycle
- * file: the durable `prd → prd-tasked` success move is owned by the integrate band,
- * and the prd body never left `work/prds/ready/` under the lock, so there is no
- * `tasking/ → prd/` restore.
+ * file: the durable `specs/ready → specs/tasked` success move is owned by the integrate band,
+ * and the spec body never left `work/specs/ready/` under the lock, so there is no
+ * `tasking/ → specs/ready/` restore.
  *
  * When `routeToNeedsAttention` is set (the tasker decomposition-unclear verdict /
  * the task-SET acceptance gate `block`), the lock is AMENDED `active → stuck`

package/dist/tasking-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tasking-lock.d.ts","sourceRoot":"","sources":["../src/tasking-lock.ts"],"names":[],"mappings":"AAiEA,gFAAgF;AAChF,MAAM,MAAM,yBAAyB,GAClC,UAAU,GACV,aAAa,GACb,MAAM,GACN,WAAW,CAAC;AAEf,gEAAgE;AAChE,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACzC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uHAAuH;IACvH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,yBAAyB,CAAC;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,yBAAyB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAWnC;AAsFD,qDAAqD;AACrD,MAAM,MAAM,yBAAyB,GAClC,UAAU,GACV,aAAa,GACb,MAAM,GACN,WAAW,GACX,OAAO,CAAC;AAEX,mFAAmF;AACnF,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3D,MAAM,WAAW,yBAAyB;IACzC,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,qBAAqB,CAAC,EAAE;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACzC,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,yBAAyB,CAAC;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,yBAAyB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAWnC"}
+{"version":3,"file":"tasking-lock.d.ts","sourceRoot":"","sources":["../src/tasking-lock.ts"],"names":[],"mappings":"AA+DA,gFAAgF;AAChF,MAAM,MAAM,yBAAyB,GAClC,UAAU,GACV,aAAa,GACb,MAAM,GACN,WAAW,CAAC;AAEf,gEAAgE;AAChE,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACzC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uHAAuH;IACvH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,yBAAyB,CAAC;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAKD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,yBAAyB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAWnC;AAqFD,qDAAqD;AACrD,MAAM,MAAM,yBAAyB,GAClC,UAAU,GACV,aAAa,GACb,MAAM,GACN,WAAW,GACX,OAAO,CAAC;AAEX,mFAAmF;AACnF,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE3D,MAAM,WAAW,yBAAyB;IACzC,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;OAUG;IACH,qBAAqB,CAAC,EAAE;QAAC,MAAM,EAAE,MAAM,CAAA;KAAC,CAAC;IACzC,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,0BAA0B,CAAC;IACrC,OAAO,EAAE,yBAAyB,CAAC;IACnC,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,kBAAkB,CACvC,OAAO,EAAE,yBAAyB,GAChC,OAAO,CAAC,wBAAwB,CAAC,CAWnC"}

package/dist/tasking-lock.js

@@ -1,20 +1,21 @@
 import { runAsync } from './git.js';
-import { acquireItemLock, releaseItemLock, markStuckItemLock, } from './item-lock.js';
+import { acquireItemLock, releaseItemLock, readItemLock } from './item-lock.js';
+import { surfaceStuckToNeedsAttention } from './needs-attention.js';
 import { workItemRel } from './work-layout.js';
 /**
- * The **tasking concurrency lock** (prd `auto-slice`, task `autoslice-lock`).
+ * The **tasking concurrency lock** (spec `auto-slice`, task `autoslice-lock`).
  *
- * Serialises *concurrent* taskers (two CI runs, or human + CI) so a prd is never
+ * Serialises *concurrent* taskers (two CI runs, or human + CI) so a spec is never
  * double-tasked. As of the capstone cut-over (task
- * `cutover-retire-slicing-advancing-markers-and-trim-folder-sets`, prd
+ * `cutover-retire-slicing-advancing-markers-and-trim-folder-sets`, spec
  * `ledger-status-per-item-lock-refs`; ADR `ledger-status-on-per-item-lock-refs`)
- * the legacy `git mv work/prds/ready/<slug>.md → work/tasking/<slug>.md` MARKER on `main`
+ * the legacy `git mv work/specs/ready/<slug>.md → work/tasking/<slug>.md` MARKER on `main`
  * is GONE: the body NEVER relocates until the durable promotion, exactly as claim
  * no longer moves the task body (task
  * `cutover-claim-body-stays-and-complete-sources-from-backlog`). The tasking lock
  * is now ONLY the UNIFIED per-item lock (`refs/dorfl/lock/<entry>`,
- * `action: task`, keyed `prd:<slug>`) — the SAME ref claim and advance use for
- * the same item, so tasking a prd is mutually exclusive with claiming/advancing
+ * `action: task`, keyed `spec:<slug>`) — the SAME ref claim and advance use for
+ * the same item, so tasking a spec is mutually exclusive with claiming/advancing
  * the SAME item BY CONSTRUCTION (the second acquirer loses the SAME create-only
  * ref CAS, with NO retry budget and NO false contention). There is no transient
  * status in `main`'s tree anymore, so a work branch cut from `main` inherits no
@@ -24,15 +25,16 @@ import { workItemRel } from './work-layout.js';
  *   A `lost` (the item is already held for implement/task/advance) makes the
  *   tasking acquire lose DEFINITIVELY (exit 2, no retry). On a successful acquire
  *   it returns {@link AcquireTaskingLockResult.lockedBlob}: the git blob sha of the
- *   prd body the lock TOOK, read from `work/prds/ready/<slug>.md` on the arbiter — the
+ *   spec body the lock TOOK, read from `work/specs/ready/<slug>.md` on the arbiter — the
  *   snapshot the tasker reads + tasks from, handed back so the integrate
- *   transition can fail loud if the held prd was edited concurrently (the
+ *   transition can fail loud if the held spec was edited concurrently (the
  *   read-stability backstop). A dry-run takes no lock (it mutates nothing).
  *
  * - **Release** ({@link releaseTaskingLock}) DELETES the unified lock ref. It
- *   moves NO lifecycle file: the durable `prd → prd-tasked` success move is owned
- *   by the integrate band (`tasking.ts`/`integration-core.ts`), and there is no
- *   `tasking/ → prd/` abort bounce anymore (the body never left `prd/`). When
+ *   moves NO lifecycle file: the durable `specs/ready → specs/tasked` success move
+ *   is owned by the integrate band (`tasking.ts`/`integration-core.ts`), and there
+ *   is no `tasking/ → specs/ready/` abort bounce anymore (the body never left
+ *   `specs/ready/`). When
  *   `routeToNeedsAttention` is set (the tasker review/edit loop's
  *   decomposition-unclear verdict, or the task-SET acceptance gate's `block`),
  *   release amends the lock `active → stuck` with the reason on the entry INSTEAD
@@ -46,13 +48,13 @@ import { workItemRel } from './work-layout.js';
  * The READ-STABILITY backstop (the content-identity stale check that used to live
  * in the release, comparing the held `work/tasking/<slug>.md` blob against the
  * acquire-time snapshot) now lives at the integrate seam (`tasking.ts`
- * `heldSpecIsStale`, comparing `work/prds/ready/<slug>.md`) — relocated because the
+ * `heldSpecIsStale`, comparing `work/specs/ready/<slug>.md`) — relocated because the
  * completing transition, not the release, owns the commit. See
  * `work/notes/observations/tasking-lock-does-not-stabilise-prd-content.md`.
  *
- * This module provides the lock PRIMITIVES only. The orchestrating `do prd:<slug>`
+ * This module provides the lock PRIMITIVES only. The orchestrating `do spec:<slug>`
  * tasking command (`tasking.ts`) acquires, drives the agent's tasking, integrates
- * the emitted tasks + the durable `prd → prd-tasked` move, and releases. The
+ * the emitted tasks + the durable `specs/ready → specs/tasked` move, and releases. The
  * human path (no contention) may task on `main` directly without the lock.
  */
 const DEFAULT_ARBITER = 'origin';
@@ -94,12 +96,12 @@ async function runAcquire(options, note) {
         throw new TaskingLockUsageError(`no git remote named '${arbiter}' (set one, or pass --arbiter)`);
     }
     const by = options.by || (await resolveBy(cwd, env));
-    // Is the prd still lockable (present in work/prds/ready/ on the arbiter's main)?
+    // Is the spec still lockable (present in work/specs/ready/ on the arbiter's main)?
     await gitHard(['fetch', '--quiet', arbiter], cwd, env);
     const spec = workItemRel('specs-ready', `${slug}.md`);
     const specBlob = await gitSoft(['rev-parse', `${arbiter}/main:${spec}`], cwd, env);
     if (specBlob.status !== 0) {
-        const message = `'${spec}' not found on ${arbiter}/main (no such prd, or it was already moved/tasked).`;
+        const message = `'${spec}' not found on ${arbiter}/main (no such spec, or it was already moved/tasked).`;
         note(message);
         return { exitCode: 2, outcome: 'lost', message };
     }
@@ -111,18 +113,17 @@ async function runAcquire(options, note) {
         note(message);
         return { exitCode: 0, outcome: 'acquired', message, lockedBlob };
     }
-    // Acquire the UNIFIED per-item lock (`action: task`, keyed `prd:<slug>` so it
+    // Acquire the UNIFIED per-item lock (`action: task`, keyed `spec:<slug>` so it
     // shares the ONE ref with claim/advance of the SAME item). A create-only ref
     // CAS: the winner holds it, the loser is DEFINITIVELY `lost` (exit 2, no retry
     // budget). No auto-steal of an orphaned lock, consistent with claim/advance and
     // the ADR's recovery model (no liveness heartbeat / auto-sweep; a human asserts
     // a lock is dead via `release-lock` + `gc --ledger`).
-    // MIGRATE step (prd `prd-to-spec-vocabulary-cutover-and-migration-command`):
-    // EMIT the parent-spec item identity as `spec:<slug>` so the unified per-item
-    // lock ref is `refs/dorfl/lock/spec-<slug>` (the expand-lock task made
-    // `spec:<slug>` resolve to a `spec-<slug>` entry). The resolver still ACCEPTS
-    // `prd:<slug>`, so any lock taken under the old identity stays readable; the
-    // contract task removes the legacy form.
+    // Spec `prd-to-spec-vocabulary-cutover-and-migration-command`: the parent-spec
+    // item identity is `spec:<slug>`, so the unified per-item lock ref is
+    // `refs/dorfl/lock/spec-<slug>`. HARD CUTOVER: the legacy ''prd:<slug>'' identity
+    // is GONE — the resolver no longer treats ''prd:'' as the spec namespace (a
+    // ''prd:<slug>'' arg is a bare literal task slug now).
     const lock = await acquireItemLock({
         item: `spec:${slug}`,
         action: 'task',
@@ -145,9 +146,9 @@ async function runAcquire(options, note) {
 /**
  * Release the tasking lock for `slug`: DELETE the unified `action: task` lock ref
  * (idempotent — an already-absent ref is a clean `released`). It moves NO lifecycle
- * file: the durable `prd → prd-tasked` success move is owned by the integrate band,
- * and the prd body never left `work/prds/ready/` under the lock, so there is no
- * `tasking/ → prd/` restore.
+ * file: the durable `specs/ready → specs/tasked` success move is owned by the integrate band,
+ * and the spec body never left `work/specs/ready/` under the lock, so there is no
+ * `tasking/ → specs/ready/` restore.
  *
  * When `routeToNeedsAttention` is set (the tasker decomposition-unclear verdict /
  * the task-SET acceptance gate `block`), the lock is AMENDED `active → stuck`
@@ -186,33 +187,52 @@ async function runRelease(options, note) {
     if ((await gitSoft(['remote', 'get-url', arbiter], cwd, env)).status !== 0) {
         throw new TaskingLockUsageError(`no git remote named '${arbiter}' (set one, or pass --arbiter)`);
     }
-    // DECOMPOSITION-UNCLEAR / TASK-GATE BLOCK: amend the lock `active → stuck` with
-    // the reason on the entry (the tasking needs-attention surface), NOT delete it.
-    // The prd body stays in `work/prds/ready/`; the stuck lock keeps it out of the
-    // taskable pool until a human resolves it (`release-lock`/`resume`).
+    // DECOMPOSITION-UNCLEAR / TASK-GATE BLOCK: surface the spec as a `stuck`-kind
+    // sidecar + `needsAnswers:true` on the spec body in ONE commit on
+    // `<arbiter>/main`, THEN release the tasking lock (PR-2b, spec
+    // `surface-stuck-as-questions-and-retire-stuck-lock-state`, decision #1). The
+    // spec body stays in `work/specs/ready/` (or `work/specs/proposed/` — the D1
+    // probe finds it); the surfaced question keeps the spec out of the taskable
+    // pool via `needsAnswers:true` (eligibility `false`) until a human answers.
     if (options.routeToNeedsAttention !== undefined) {
-        // MIGRATE: EMIT `spec:<slug>` (keyed to the `spec-<slug>` lock entry).
-        const stuck = await markStuckItemLock({
-            item: `spec:${slug}`,
-            reason: options.routeToNeedsAttention.reason,
-            cwd,
-            arbiter,
-            env,
-        });
-        if (stuck.outcome === 'transitioned' || stuck.outcome === 'wrong-state') {
-            // `wrong-state` (already stuck) is a tolerated idempotent re-surface.
-            const message = `Routed the tasking of '${slug}' to needs-attention (per-item lock marked stuck).`;
+        const item = `spec:${slug}`;
+        // Detect a genuinely NOT-HELD lock BEFORE the surface (so a bounce of an
+        // unlocked spec still returns the exit-2 `lost` contract). The surface itself
+        // is idempotent, but without this pre-check a not-held spec would surface
+        // silently on main with no lock to release — losing the caller-visible
+        // "nothing to route" signal.
+        const held = await readItemLock({ item, cwd, arbiter, env });
+        if (held === undefined) {
+            const message = `'${slug}' is not locked for tasking — nothing to route to needs-attention.`;
             note(message);
-            return { exitCode: 0, outcome: 'released', message };
+            return { exitCode: 2, outcome: 'lost', message };
         }
-        if (stuck.outcome === 'not-held') {
-            const message = `'${slug}' is not locked for tasking — nothing to mark stuck.`;
+        try {
+            const surfaced = await surfaceStuckToNeedsAttention({
+                cwd,
+                slug,
+                item,
+                reason: options.routeToNeedsAttention.reason,
+                arbiter,
+                env,
+                note,
+            });
+            if (surfaced.surfaced || surfaced.bodyAbsent) {
+                const message = surfaced.surfaced
+                    ? `Routed the tasking of '${slug}' to needs-attention (surfaced on ${arbiter}/main; tasking lock released).`
+                    : `Routed the tasking of '${slug}' to needs-attention (no spec body on ${arbiter}/main — clean no-op surface; tasking lock released).`;
+                note(message);
+                return { exitCode: 0, outcome: 'released', message };
+            }
+            const message = `could not surface '${item}' on ${arbiter}/main (${surfaced.reasonNotSurfaced ?? 'unknown'}).`;
             note(message);
-            return { exitCode: 2, outcome: 'lost', message };
+            return { exitCode: 1, outcome: 'usage-error', message };
+        }
+        catch (err) {
+            const message = `could not surface '${item}' on ${arbiter}/main (${err instanceof Error ? err.message : String(err)}).`;
+            note(message);
+            return { exitCode: 1, outcome: 'usage-error', message };
         }
-        const message = `could not mark the per-item lock for '${slug}' stuck (${stuck.outcome}: ${stuck.message}).`;
-        note(message);
-        return { exitCode: 1, outcome: 'usage-error', message };
     }
     // NORMAL release: delete the lock ref (idempotent).
     // MIGRATE: EMIT `spec:<slug>` (keyed to the `spec-<slug>` lock entry).

package/dist/tasking-lock.js.map

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

package/dist/tasking.d.ts

@@ -5,44 +5,44 @@ import { type Harness } from './harness.js';
 import { type TaskReviewGate } from './tasker-review-loop.js';
 import type { ReviewGate } from './review-gate.js';
 /**
- * The **`do prd:<slug>` tasking path** (prd `auto-slice`, task
+ * The **`do spec:<slug>` tasking path** (spec `auto-slice`, task
  * `autoslice-command`) — the orchestration that ties the tasking GATE
  * (`tasking-eligibility.ts`) and the tasking LOCK (`tasking-lock.ts`) together to
- * task a prd into `work/tasks/backlog/` STAGED items (task
+ * task a spec into `work/tasks/backlog/` STAGED items (task
  * `pre-backlog-staging-folder-and-promote-step-a` — the runner-owned promotion
- * moves them `pre-backlog/ → backlog/` later), with the RUNNER owning every git-state
- * transition. This is the prd branch of the `do` worker (ADR
+ * moves them `tasks/backlog/ → tasks/ready/` later), with the RUNNER owning every git-state
+ * transition. This is the spec branch of the `do` worker (ADR
  * `command-surface-and-journeys.md` §3/§3a), NOT a standalone `task` command;
- * `do.ts` dispatches `resolved.namespace === 'prd'` here.
+ * `do.ts` dispatches `resolved.namespace === 'spec'` here.
  *
  * The end-to-end flow (mirroring the `do`/`run` runner-owns-git discipline — the
  * agent only EDITS files, the runner does ALL git):
  *
- *   1. **Resolve the gate** (agent path): refuse to task a prd that is
- *      `humanOnly`/`needsAnswers`, or whose `taskedAfter` prds are not yet tasked.
+ *   1. **Resolve the gate** (agent path): refuse to task a spec that is
+ *      `humanOnly`/`needsAnswers`, or whose `taskedAfter` specs are not yet tasked.
  *      The repo's `autoTask` POLICY also refuses on the AUTO-PICK pool path, but
- *      NOT when the prd was named EXPLICITLY (`do prd:<slug>`, `explicit: true`):
+ *      NOT when the spec was named EXPLICITLY (`do spec:<slug>`, `explicit: true`):
  *      naming it IS the authorization, exactly as `do <task>` builds regardless of
  *      `autoBuild` (the pool, not the explicit claim, gates the policy). The HUMAN
  *      path is unbound by the gate entirely.
  *   2. **Acquire the lock** (agent path) via the unified per-item lock CAS —
- *      serialising concurrent taskers on the `prd:<slug>` ref (the body STAYS in
- *      `work/prds/ready/`; the lock no longer moves it). The HUMAN path with no contention
+ *      serialising concurrent taskers on the `spec:<slug>` ref (the body STAYS in
+ *      `work/specs/ready/`; the lock no longer moves it). The HUMAN path with no contention
  *      may task on `main` directly WITHOUT the lock.
- *   3. **Invoke the agent harness** with the `to-task` prd — the agent runs the
+ *   3. **Invoke the agent harness** with the `to-task` spec — the agent runs the
  *      tasker methodology and produces `work/tasks/backlog/<slug>.md` FILES ONLY; it does
  *      NOT commit/push/move (the same in-band boundary as the build agent).
  *   4. **The runner integrates the COMPLETING transition through the SHARED core**
  *      (`performIntegration`, task `slice-output-through-integration`): the agent's
  *      tasking runs on a `work/<slug>` branch cut from `<arbiter>/main` (whose base
- *      holds the prd in `work/prds/ready/`), and the produced backlog tasks + the durable
- *      prd lifecycle move (`work/prds/ready/ → work/prds/tasked/`)
+ *      holds the spec in `work/specs/ready/`), and the produced backlog tasks + the durable
+ *      spec lifecycle move (`work/specs/ready/ → work/specs/tasked/`)
  *      integrate via the band honoring `--propose` (push the branch + open a
  *      PR, NO `main` touch) / `--merge` (land on `main`). Because the integrate-time
  *      args resolve ONCE in the shared core, EVERY `do task:` integrate arg applies
- *      to `do prd:` by construction. A content-identity STALE CHECK (the lock's
+ *      to `do spec:` by construction. A content-identity STALE CHECK (the lock's
  *      read-stability backstop) fires FIRST against the acquire-time `lockedBlob`,
- *      so a concurrent edit of the held prd still fails loud (`stale`).
+ *      so a concurrent edit of the held spec still fails loud (`stale`).
  *
  * The tasking LOCK (`tasking-lock.ts`, `acquireTaskingLock`/`releaseTaskingLock`)
  * is the UNIFIED per-item lock (`refs/dorfl/lock/<entry>`, `action: task`)
@@ -54,12 +54,12 @@ import type { ReviewGate } from './review-gate.js';
  * does NOT build the no-human confidence routing — that is the review/edit loop
  * owned by `slicer-review-edit-loop`; this path produces + integrates the tasks.
  */
-/** The terminal status of one `do prd:<slug>` tasking run. */
+/** The terminal status of one `do spec:<slug>` tasking run. */
 export type TaskOutcome = 'tasked' | 'gate-refused' | 'lock-lost' | 'agent-failed' | 'stale' | 'needs-attention' | 'usage-error';
 export interface TaskResult {
     exitCode: 0 | 1 | 2 | 3 | 4;
     outcome: TaskOutcome;
-    /** The prd slug acted on. */
+    /** The spec slug acted on. */
     slug: string;
     /** Repo-relative paths of the backlog tasks the runner committed. */
     emitted?: string[];
@@ -67,7 +67,7 @@ export interface TaskResult {
      * The tasker review→edit LOOP's disposition (`slicer-review-edit-loop`), when
      * the loop ran. `converged` = the improved tasks landed; `uncertain-tasks` =
      * the cap was hit and specific tasks landed `needsAnswers: true`; absent when
-     * no loop ran or the prd was routed to needs-attention (`outcome:
+     * no loop ran or the spec was routed to needs-attention (`outcome:
      * 'needs-attention'`).
      */
     loop?: 'converged' | 'uncertain-tasks';
@@ -75,8 +75,8 @@ export interface TaskResult {
     message: string;
 }
 /**
- * The agent invocation: runs the `to-task` prd in `cwd`, WRITING
- * `work/tasks/backlog/<slug>.md` task files (and trimming the prd). It does NO git —
+ * The agent invocation: runs the `to-task` spec in `cwd`, WRITING
+ * `work/tasks/backlog/<slug>.md` task files (and trimming the spec). It does NO git —
  * the runner captures the produced files and commits them.
  */
 export type TaskDorfl = (input: {
@@ -94,7 +94,7 @@ export interface TaskingLockSeam {
     release(options: ReleaseTaskingLockOptions): Promise<ReleaseTaskingLockResult>;
 }
 export interface PerformTaskOptions {
-    /** The prd slug to task (`work/prds/ready/<slug>.md`). */
+    /** The spec slug to task (`work/specs/ready/<slug>.md`). */
     slug: string;
     /** The working clone/checkout the tasking runs in. */
     cwd: string;
@@ -109,16 +109,16 @@ export interface PerformTaskOptions {
     /** Per-repo `autoTask` policy (resolved by `autoslice-gate`). Agent path only. */
     autoTask?: boolean;
     /**
-     * The prd was named EXPLICITLY by the operator (`do prd:<slug>`), so the
-     * `autoTask` POLICY is already satisfied — naming the prd IS the authorization,
+     * The spec was named EXPLICITLY by the operator (`do spec:<slug>`), so the
+     * `autoTask` POLICY is already satisfied — naming the spec IS the authorization,
      * EXACTLY as `do <task>` builds a named task regardless of `autoBuild` (the
      * build path's precedent: `autoBuild` gates the scan/selection POOL only, never
      * `performDo`'s explicit claim). When `true`, the agent tasking gate drops the
-     * `autoTask` policy term and binds ONLY the prd's own readiness axes
+     * `autoTask` policy term and binds ONLY the spec's own readiness axes
      * (`humanOnly`/`needsAnswers`) + `taskedAfter`. Defaults `false`. Both the
-     * explicit `do prd:` dispatch AND the auto-pick path pass `true` here: the
+     * explicit `do spec:` dispatch AND the auto-pick path pass `true` here: the
      * auto-pick POOL (`do-autopick.ts`) is the single `autoTask`-enforcement point
-     * (a pool-ineligible prd is never selected), so once a prd is dispatched its
+     * (a pool-ineligible spec is never selected), so once a spec is dispatched its
      * policy is already settled. Agent path only.
      */
     explicit?: boolean;
@@ -140,7 +140,7 @@ export interface PerformTaskOptions {
      * with (task `slice-output-through-integration`): `propose` (default — push the
      * `work/<slug>` branch + open a PR carrying the tasks, NO `main` touch) or
      * `merge` (land them on `main`). Resolved ONCE in {@link performIntegration},
-     * so EVERY `do task:` integrate-time arg applies to `do prd:` by construction.
+     * so EVERY `do task:` integrate-time arg applies to `do spec:` by construction.
      * The AGENT path only; the human path commits its own output. Defaults to the
      * system default (`propose`).
      */
@@ -165,7 +165,7 @@ export interface PerformTaskOptions {
      * task-path mirror of the build Gate-2, riding {@link performIntegration}'s
      * review-before-integrate block. When `review` resolves on, a FRESH-CONTEXT
      * agent reviews the WHOLE produced task SET (coherence / dependency graph /
-     * gaps + overlap / prd-goal correct-if-implemented) BEFORE the tasks integrate;
+     * gaps + overlap / spec-goal correct-if-implemented) BEFORE the tasks integrate;
      * `approve` lands them, `block` routes the set to needs-attention. It is
      * controlled by the BUILD `--review`/`--no-review`/`--review-model` family (ONE
      * gate-configuration story shared with the build path) and is ONE-SHOT —
@@ -183,10 +183,22 @@ export interface PerformTaskOptions {
      * loop's {@link taskerLoopModel} — see the note there.
      */
     acceptanceReviewModel?: string;
+    /**
+     * **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 {@link performIntegration} so a wide-matrix CI's
+     * raised cap actually reaches the cross-job land queue (the CAS loop IS the
+     * queue across separate jobs) on the `do spec:<slug>` tasking-transition path
+     * too. Resolved ONCE at the entry point through the gate-family precedence chain
+     * (flag > env > per-repo > global > default), same as `complete`/`do`/`run`.
+     * Unset ⇒ falls through to the engine's `DEFAULT_MERGE_RETRIES = 1000`
+     * (byte-for-byte unchanged).
+     */
+    mergeRetries?: number;
     /** Injectable lock seam (tests stub acquire/release). Defaults to the real CAS. */
     lock?: TaskingLockSeam;
     /**
-     * **The per-repo TASK-PLACEMENT default** (prd
+     * **The per-repo TASK-PLACEMENT default** (spec
      * `staging-pool-position-gate-and-trust-model` US #5, task
      * `runner-deterministic-slice-placement-policy-and-precedence`). The
      * resolved per-repo default landing for the tasker's emitted tasks, fed as
@@ -194,10 +206,10 @@ export interface PerformTaskOptions {
      * resolver (`src/placement.ts`). The resolver overlays an EXPLICIT operator
      * flag ({@link explicitTasksLandIn}, top) and the UNTRUSTED-ORIGIN force
      * (`originTrust: untrusted` ⇒ staging) on top. Unset ⇒ the resolver's
-     * built-in floor applies (`staging` = `pre-backlog/`, the conservative
+     * built-in floor applies (`staging` = `tasks/backlog/`, the conservative
      * landing that preserves zero behaviour change for the normal path).
      */
-    tasksLandIn?: 'pre-backlog' | 'ready';
+    tasksLandIn?: 'backlog' | 'ready';
     /**
      * **The OPERATOR's EXPLICIT task-placement override** (the TOP precedence
      * rung). When set, the runner-deterministic resolver lands the tasks HERE
@@ -207,15 +219,15 @@ export interface PerformTaskOptions {
      * force-key"). Set ONLY when the operator typed `--tasks-land-in <where>`;
      * never when the value came from config.
      */
-    explicitTasksLandIn?: 'pre-backlog' | 'ready';
+    explicitTasksLandIn?: 'backlog' | 'ready';
     /**
-     * **The tasker review→edit→converge LOOP** (`slicer-review-edit-loop`, GATES prd
-     * `work/prds/ready/review.md` RESOLVED DESIGN — Shape 2 / insertion point A). When
+     * **The tasker review→edit→converge LOOP** (`slicer-review-edit-loop`, GATES spec
+     * `work/specs/ready/review.md` RESOLVED DESIGN — Shape 2 / insertion point A). When
      * provided, AFTER the agent produces candidate tasks (step 3) and BEFORE the
      * runner finalises them (step 4), run the `review` SKILL as a review→edit→
      * re-review loop that IMPROVES the candidate tasks in place, then routes the
      * verdict through the three outcomes (converge→land / uncertain-task→
-     * needsAnswers / decomposition-unclear→prd-to-needs-attention). The seam is the
+     * needsAnswers / decomposition-unclear→spec-to-needs-attention). The seam is the
      * review+edit gate (tests inject a canned verdict+edits; production:
      * {@link harnessTaskReviewGate}). Omitted ⇒ NO loop (the candidate tasks land
      * as-is — the pre-loop behaviour). The HUMAN path is unaffected (the loop runs
@@ -254,22 +266,44 @@ export interface PerformTaskOptions {
     note?: (message: string) => void;
 }
 /**
- * **The STAGED-TASKS dir** (prd `staging-pool-position-gate-and-trust-model`,
+ * **The STAGED-TASKS dir** (spec `staging-pool-position-gate-and-trust-model`,
  * task `pre-backlog-staging-folder-and-promote-step-a`, governing ADR
  * `placement-is-runner-deterministic-humanonly-is-agent-judgement`). The runner
  * lands the tasker's emitted task files HERE, NOT in `work/tasks/ready/`: an item
- * born in `pre-backlog/` is durable + readable but NOT in the agent-eligible
+ * born in `tasks/backlog/` is durable + readable but NOT in the agent-eligible
  * pool (`work/tasks/ready/` STILL means the pool — every reader is byte-for-byte
  * unchanged). A runner/human-owned promotion (`promoteFromPreBacklog` in
- * `needs-attention.ts`) moves an approved item `pre-backlog/ → backlog/` to make
+ * `needs-attention.ts`) moves an approved item `tasks/backlog/ → tasks/ready/` to make
  * it claimable. STEP A: ADDITIVE — no `work/tasks/ready/` reader changes here.
  */
 export declare const STAGED_TASKS_DIR: string;
 /**
- * Run the `do prd:<slug>` tasking path end-to-end. Never throws for the expected
+ * Run the `do spec:<slug>` tasking path end-to-end. Never throws for the expected
  * gate-refused / lock-lost / agent-failed / stale cases — those are returned with
  * the appropriate exit code and outcome. The runner owns all git; the agent only
  * writes task files.
  */
 export declare function performTask(options: PerformTaskOptions): Promise<TaskResult>;
+/**
+ * Compose the propose-mode PR BODY for a slice-set (task
+ * `slicing-pr-body-summary-threading`): mirror the BUILD path's body threading
+ * (`do.ts` — `body: agent.output`) with a summary drawn from what the tasker
+ * ALREADY has in hand — the emitted task files. The shared
+ * {@link composeProposeBody} then wraps this prose with its runner-owned header.
+ *
+ * Sections (all suppressed when empty, so the body stays honest):
+ *   1. A lead line naming the source spec + emitted task count.
+ *   2. **Tasks** — one bullet per task: `slug — title`, plus `covers:` (which
+ *      spec user stories it maps to), `blockedBy:`, and `needsAnswers` if set.
+ *   3. **Dependency graph** — the KEYSTONE(S) (tasks whose `blockedBy` names no
+ *      other task in this set, so they land first) and the `blockedBy` edges.
+ *   4. **Needs answers** — any open questions the tasker review→edit loop
+ *      appended under `## Open questions` on `needsAnswers: true` tasks, so the
+ *      deferred seams are visible on the PR (not buried in task bodies).
+ *
+ * Returns `undefined` for the empty set (no emitted tasks) so the provider's
+ * `gh pr create --fill` fallback still applies on that edge (matches the build
+ * path's absent-body behaviour).
+ */
+export declare function composeTaskingProposeBody(specSlug: string, emitTasks: Record<string, string>): string | undefined;
 //# sourceMappingURL=tasking.d.ts.map