dorfl 0.1.0 → 0.1.2

package/dist/item-lock.d.ts

@@ -1,6 +1,6 @@
 import { type SidecarType } from './sidecar.js';
 /**
- * The **unified item-lock module** (prd `ledger-status-per-item-lock-refs`, ADR
+ * The **unified item-lock module** (spec `ledger-status-per-item-lock-refs`, ADR
  * `ledger-status-on-per-item-lock-refs`). The runner's ONE lock primitive: ONE
  * lock per item, on a PER-ITEM hidden ref `refs/dorfl/lock/<entry>`,
  * acquired by an ATOMIC create-only push and released by DELETING the ref, with a
@@ -12,12 +12,12 @@ import { type SidecarType } from './sidecar.js';
  * It GENERALISES the green tracer that proved the dangerous core end-to-end on a
  * bare `file://` arbiter (the tracer is now this file). The one production
  * difference from the tracer is the IDENTITY SEAM: callers pass a NAMESPACED item
- * identity (`task:<slug>` / `prd:<slug>` / `observation:<slug>` / `obs:<slug>`,
+ * identity (`task:<slug>` / `spec:<slug>` / `observation:<slug>` / `obs:<slug>`,
  * or a bare `<slug>` = task), and this module derives the type-encoded lock
  * `<entry>` (`<type>-<slug>`) through {@link resolveSidecarIdentity} — the SAME
  * single source of truth the sidecar (`work/questions/<type>-<slug>.md`) and the
  * work branch (`work/<type>-<slug>`) already use. There is deliberately NO second
- * identity scheme: a task, a prd,
+ * identity scheme: a task, a spec,
  * and an observation that share a slug get DISTINCT lock refs, and the SAME item
  * under different actions shares ONE ref (so implement / task / advance on one
  * item are mutually exclusive by construction).
@@ -57,7 +57,7 @@ export declare const LOCK_REF_PREFIX = "refs/dorfl/lock";
  * (`<type>-<slug>`) from a NAMESPACED item identity, through the shared
  * {@link resolveSidecarIdentity} resolver (the single source of truth, which the
  * sidecar filename + the advancing-lock marker also key onto). Accepts the same
- * forms as that resolver: `task:<slug>` / `prd:<slug>` / `observation:<slug>` /
+ * forms as that resolver: `task:<slug>` / `spec:<slug>` / `observation:<slug>` /
  * `obs:<slug>`, or a bare `<slug>` (= task). Acquire/release/read ALL key
  * through THIS function, so there is one — and only one — addressing scheme.
  */
@@ -114,7 +114,7 @@ export interface ReleaseResult {
 }
 /**
  * Outcome of an AMEND-style transition (mark-stuck / resume / requeue) — the
- * lock-entry STATE MACHINE's interior moves (prd `ledger-status-per-item-lock-refs`,
+ * lock-entry STATE MACHINE's interior moves (spec `ledger-status-per-item-lock-refs`,
  * the C8 lock-entry state machine in the design trail). Each is a single CAS on the
  * held ref (no retry loop), so the verdict is definitive:
  *   - `transitioned` — we won the CAS; the entry now holds the target `(action, state)`.
@@ -150,7 +150,7 @@ export interface TransitionResult {
 export declare function serialiseLockEntry(e: LockEntry): string;
 export interface AcquireOptions {
     /**
-     * The NAMESPACED item identity to lock (`task:<slug>` / `prd:<slug>` /
+     * The NAMESPACED item identity to lock (`task:<slug>` / `spec:<slug>` /
      * `observation:<slug>` / `obs:<slug>`, or a bare `<slug>` = task). Resolved to
      * the type-encoded lock `<entry>` through {@link lockEntryFor}.
      */
@@ -196,7 +196,7 @@ export interface ReleaseHeldResult {
     message: string;
 }
 /**
- * GUARDED release for a runner that KNOWS it acquired and HELD the lock (prd
+ * GUARDED release for a runner that KNOWS it acquired and HELD the lock (spec
  * `ledger-status-per-item-lock-refs` US #13): unlike {@link releaseItemLock} —
  * whose `not-held` is a BENIGN idempotent case the complete/tasking/needs-attention
  * callers tolerate (the body may predate the lock, or a crash-recovery may have
@@ -291,19 +291,19 @@ export declare function readItemLock(opts: ReleaseOptions): Promise<LockEntry |
  * authoritative resting records the cross-substrate reconciliation reads. An
  * item is TERMINAL on `main` iff ANY of these paths exists on `<arbiter>/main`.
  * The won't-proceed terminal is PER-REGIME (the slug-collision correctness fix:
- * a dropped task and a dropped prd sharing a slug used to collide on one
+ * a dropped task and a dropped spec sharing a slug used to collide on one
  * bare-slug `work/dropped/<slug>.md`):
  *   - a TASK: `work/tasks/done/<slug>.md` (completed) OR
  *     `work/tasks/cancelled/<slug>.md` (the task regime's won't-proceed terminal).
- *   - a PRD: `work/prds/tasked/<slug>.md` (tasked) OR `work/prds/dropped/<slug>.md`
- *     (the prd regime's won't-proceed terminal).
+ *   - a SPEC: `work/specs/tasked/<slug>.md` (tasked) OR `work/specs/dropped/<slug>.md`
+ *     (the spec regime's won't-proceed terminal).
  *   - an OBSERVATION: NONE. A note has no durable terminal folder — it leaves by
  *     deletion (its absence, not a terminal record, is the end state). A promoted
- *     observation becomes a NEW task/prd with its own ref.
+ *     observation becomes a NEW task/spec with its own ref.
  */
 export declare function terminalMainPaths(type: SidecarType, slug: string): string[];
 /** The outcome of a cross-substrate reconciliation of one item's lock against
- * the authoritative `main` durable record (prd `ledger-status-per-item-lock-refs`
+ * the authoritative `main` durable record (spec `ledger-status-per-item-lock-refs`
  * US #9/#10; ADR `ledger-status-on-per-item-lock-refs`). */
 export type ReconcileOutcome = 'cleared-stale' | 'kept-stuck' | 'kept-in-flight' | 'no-lock' | 'error';
 export interface ReconcileResult {
@@ -312,19 +312,19 @@ export interface ReconcileResult {
     entry: string;
     ref: string;
     /** Whether `<arbiter>/main` shows the item terminal (per {@link terminalMainPaths}:
-     * a task at `tasks/done`/`tasks/cancelled`, a prd at `prds/tasked`/`prds/dropped`). */
+     * a task at `tasks/done`/`tasks/cancelled`, a spec at `specs/tasked`/`specs/dropped`). */
     terminalOnMain: boolean;
     message: string;
 }
 /**
  * Reconcile ONE item's per-item lock against the AUTHORITATIVE `main` durable
- * record — the heart of complete's cross-substrate crash-safety (prd
+ * record — the heart of complete's cross-substrate crash-safety (spec
  * `ledger-status-per-item-lock-refs` US #9/#10; ADR
  * `ledger-status-on-per-item-lock-refs`; the design trail's Amendment 6).
  *
  * complete's order is hold lock → land the DURABLE `main` move FIRST → release
  * the lock SECOND. A crash BETWEEN the move and the release leaves a
- * terminal-on-`main` item (a completed/cancelled task or a tasked/dropped prd,
+ * terminal-on-`main` item (a completed/cancelled task or a tasked/dropped spec,
  * per {@link terminalMainPaths}) with a STILL-HELD lock — a stale lock with no
  * in-flight work behind it. This is the recovery that converges it.
  *
@@ -409,7 +409,7 @@ export interface LockReportEntry {
      */
     reconcile: ReconcileOutcome;
 }
-/** The `gc --ledger` stuck/orphaned-lock REPORT (prd
+/** The `gc --ledger` stuck/orphaned-lock REPORT (spec
  * `ledger-status-per-item-lock-refs` US #14): every lingering per-item lock on the
  * arbiter, each classified read-only against `main`. An EMPTY list = no locks held
  * (an absent ref namespace reads as `[]`, the recoverable "all locks released"
@@ -418,7 +418,7 @@ export interface ItemLockReport {
     locks: LockReportEntry[];
 }
 /**
- * Build the `gc --ledger` stuck/orphaned-lock REPORT (prd
+ * Build the `gc --ledger` stuck/orphaned-lock REPORT (spec
  * `ledger-status-per-item-lock-refs` US #12/#13/#14; ADR
  * `ledger-status-on-per-item-lock-refs`): enumerate every per-item lock currently
  * held on the arbiter ({@link listItemLockEntries} — held active + stuck, with
@@ -450,7 +450,7 @@ export declare function reportItemLocks(cwd: string, arbiter?: string, env?: Nod
  */
 /**
  * Does the `gc --ledger` lock report contain a lock that NEEDS HUMAN ATTENTION
- * (prd US#14/#21; ADR `ledger-status-on-per-item-lock-refs`: this surface is the
+ * (spec US#14/#21; ADR `ledger-status-on-per-item-lock-refs`: this surface is the
  * STUCK / crash-orphaned lock, NOT every held one)? TRUE iff some lock is
  * `kept-stuck` (terminal-on-`main` + stuck) or `cleared-stale`-eligible
  * (terminal-on-`main` + a stale active orphan). A `kept-in-flight` (active,
@@ -504,7 +504,7 @@ export interface ReapReport {
     lost: number;
 }
 /**
- * The OPT-IN `gc --ledger --reap-stale-locks` SWEEP (prd
+ * The OPT-IN `gc --ledger --reap-stale-locks` SWEEP (spec
  * `ledger-status-per-item-lock-refs` US #14): a human asserting "clear the dead
  * TERMINAL locks now", so one command sweeps every orphaned terminal lock instead
  * of N hand-run `release-lock`s. It is the WRITE twin of {@link reportItemLocks}
@@ -560,7 +560,7 @@ export declare function itemFromLockEntry(entry: string): string;
 export declare function listItemLocks(cwd: string, arbiter?: string, env?: NodeJS.ProcessEnv): Promise<string[]>;
 /**
  * Read the FULL lock entries currently held on the arbiter — the `status`/`scan`
- * in-flight read path (prd `ledger-status-per-item-lock-refs` US #8; task
+ * in-flight read path (spec `ledger-status-per-item-lock-refs` US #8; task
  * `needs-attention-as-stuck-lock-state`). One fetch of the lock refs, then read
  * each held entry's `lock.md` blob, returning the parsed {@link LockEntry} for
  * every ref (so a caller can surface `active` (in-progress) and `stuck`
@@ -572,7 +572,7 @@ export declare function listItemLocks(cwd: string, arbiter?: string, env?: NodeJ
 export declare function listItemLockEntries(cwd: string, arbiter?: string, env?: NodeJS.ProcessEnv): Promise<LockEntry[]>;
 /**
  * List the TASK slugs currently lock-held on the arbiter — the held-slug set the
- * `ready/` pool readers SUBTRACT (prd `ledger-status-per-item-lock-refs` US #15;
+ * `ready/` pool readers SUBTRACT (spec `ledger-status-per-item-lock-refs` US #15;
  * task `claim-acquires-unified-lock-no-body-move`). Enumerates {@link listItemLocks}
  * and keeps only the `task-<slug>` entries (a prd/observation lock does not gate
  * the TASK pool), mapping each to its bare `<slug>`.

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

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

package/dist/item-lock.js

@@ -3,7 +3,7 @@ import { runAsync } from './git.js';
 import { resolveSidecarIdentity } from './sidecar.js';
 import { workItemRel } from './work-layout.js';
 /**
- * The **unified item-lock module** (prd `ledger-status-per-item-lock-refs`, ADR
+ * The **unified item-lock module** (spec `ledger-status-per-item-lock-refs`, ADR
  * `ledger-status-on-per-item-lock-refs`). The runner's ONE lock primitive: ONE
  * lock per item, on a PER-ITEM hidden ref `refs/dorfl/lock/<entry>`,
  * acquired by an ATOMIC create-only push and released by DELETING the ref, with a
@@ -15,12 +15,12 @@ import { workItemRel } from './work-layout.js';
  * It GENERALISES the green tracer that proved the dangerous core end-to-end on a
  * bare `file://` arbiter (the tracer is now this file). The one production
  * difference from the tracer is the IDENTITY SEAM: callers pass a NAMESPACED item
- * identity (`task:<slug>` / `prd:<slug>` / `observation:<slug>` / `obs:<slug>`,
+ * identity (`task:<slug>` / `spec:<slug>` / `observation:<slug>` / `obs:<slug>`,
  * or a bare `<slug>` = task), and this module derives the type-encoded lock
  * `<entry>` (`<type>-<slug>`) through {@link resolveSidecarIdentity} — the SAME
  * single source of truth the sidecar (`work/questions/<type>-<slug>.md`) and the
  * work branch (`work/<type>-<slug>`) already use. There is deliberately NO second
- * identity scheme: a task, a prd,
+ * identity scheme: a task, a spec,
  * and an observation that share a slug get DISTINCT lock refs, and the SAME item
  * under different actions shares ONE ref (so implement / task / advance on one
  * item are mutually exclusive by construction).
@@ -60,7 +60,7 @@ export const LOCK_REF_PREFIX = 'refs/dorfl/lock';
  * (`<type>-<slug>`) from a NAMESPACED item identity, through the shared
  * {@link resolveSidecarIdentity} resolver (the single source of truth, which the
  * sidecar filename + the advancing-lock marker also key onto). Accepts the same
- * forms as that resolver: `task:<slug>` / `prd:<slug>` / `observation:<slug>` /
+ * forms as that resolver: `task:<slug>` / `spec:<slug>` / `observation:<slug>` /
  * `obs:<slug>`, or a bare `<slug>` (= task). Acquire/release/read ALL key
  * through THIS function, so there is one — and only one — addressing scheme.
  */
@@ -259,7 +259,7 @@ export async function releaseItemLock(opts) {
     }
 }
 /**
- * GUARDED release for a runner that KNOWS it acquired and HELD the lock (prd
+ * GUARDED release for a runner that KNOWS it acquired and HELD the lock (spec
  * `ledger-status-per-item-lock-refs` US #13): unlike {@link releaseItemLock} —
  * whose `not-held` is a BENIGN idempotent case the complete/tasking/needs-attention
  * callers tolerate (the body may predate the lock, or a crash-recovery may have
@@ -596,15 +596,15 @@ export async function readItemLock(opts) {
  * authoritative resting records the cross-substrate reconciliation reads. An
  * item is TERMINAL on `main` iff ANY of these paths exists on `<arbiter>/main`.
  * The won't-proceed terminal is PER-REGIME (the slug-collision correctness fix:
- * a dropped task and a dropped prd sharing a slug used to collide on one
+ * a dropped task and a dropped spec sharing a slug used to collide on one
  * bare-slug `work/dropped/<slug>.md`):
  *   - a TASK: `work/tasks/done/<slug>.md` (completed) OR
  *     `work/tasks/cancelled/<slug>.md` (the task regime's won't-proceed terminal).
- *   - a PRD: `work/prds/tasked/<slug>.md` (tasked) OR `work/prds/dropped/<slug>.md`
- *     (the prd regime's won't-proceed terminal).
+ *   - a SPEC: `work/specs/tasked/<slug>.md` (tasked) OR `work/specs/dropped/<slug>.md`
+ *     (the spec regime's won't-proceed terminal).
  *   - an OBSERVATION: NONE. A note has no durable terminal folder — it leaves by
  *     deletion (its absence, not a terminal record, is the end state). A promoted
- *     observation becomes a NEW task/prd with its own ref.
+ *     observation becomes a NEW task/spec with its own ref.
  */
 export function terminalMainPaths(type, slug) {
     const file = `${slug}.md`;
@@ -625,13 +625,13 @@ export function terminalMainPaths(type, slug) {
 }
 /**
  * Reconcile ONE item's per-item lock against the AUTHORITATIVE `main` durable
- * record — the heart of complete's cross-substrate crash-safety (prd
+ * record — the heart of complete's cross-substrate crash-safety (spec
  * `ledger-status-per-item-lock-refs` US #9/#10; ADR
  * `ledger-status-on-per-item-lock-refs`; the design trail's Amendment 6).
  *
  * complete's order is hold lock → land the DURABLE `main` move FIRST → release
  * the lock SECOND. A crash BETWEEN the move and the release leaves a
- * terminal-on-`main` item (a completed/cancelled task or a tasked/dropped prd,
+ * terminal-on-`main` item (a completed/cancelled task or a tasked/dropped spec,
  * per {@link terminalMainPaths}) with a STILL-HELD lock — a stale lock with no
  * in-flight work behind it. This is the recovery that converges it.
  *
@@ -881,7 +881,7 @@ export async function classifyItemLockAgainstMain(opts) {
     }
 }
 /**
- * Build the `gc --ledger` stuck/orphaned-lock REPORT (prd
+ * Build the `gc --ledger` stuck/orphaned-lock REPORT (spec
  * `ledger-status-per-item-lock-refs` US #12/#13/#14; ADR
  * `ledger-status-on-per-item-lock-refs`): enumerate every per-item lock currently
  * held on the arbiter ({@link listItemLockEntries} — held active + stuck, with
@@ -929,7 +929,7 @@ export async function reportItemLocks(cwd, arbiter = 'origin', env) {
  */
 /**
  * Does the `gc --ledger` lock report contain a lock that NEEDS HUMAN ATTENTION
- * (prd US#14/#21; ADR `ledger-status-on-per-item-lock-refs`: this surface is the
+ * (spec US#14/#21; ADR `ledger-status-on-per-item-lock-refs`: this surface is the
  * STUCK / crash-orphaned lock, NOT every held one)? TRUE iff some lock is
  * `kept-stuck` (terminal-on-`main` + stuck) or `cleared-stale`-eligible
  * (terminal-on-`main` + a stale active orphan). A `kept-in-flight` (active,
@@ -979,7 +979,7 @@ function reconcileNote(reconcile) {
     }
 }
 /**
- * The OPT-IN `gc --ledger --reap-stale-locks` SWEEP (prd
+ * The OPT-IN `gc --ledger --reap-stale-locks` SWEEP (spec
  * `ledger-status-per-item-lock-refs` US #14): a human asserting "clear the dead
  * TERMINAL locks now", so one command sweeps every orphaned terminal lock instead
  * of N hand-run `release-lock`s. It is the WRITE twin of {@link reportItemLocks}
@@ -1186,7 +1186,7 @@ export async function listItemLocks(cwd, arbiter = 'origin', env) {
 }
 /**
  * Read the FULL lock entries currently held on the arbiter — the `status`/`scan`
- * in-flight read path (prd `ledger-status-per-item-lock-refs` US #8; task
+ * in-flight read path (spec `ledger-status-per-item-lock-refs` US #8; task
  * `needs-attention-as-stuck-lock-state`). One fetch of the lock refs, then read
  * each held entry's `lock.md` blob, returning the parsed {@link LockEntry} for
  * every ref (so a caller can surface `active` (in-progress) and `stuck`
@@ -1231,7 +1231,7 @@ export async function listItemLockEntries(cwd, arbiter = 'origin', env) {
 }
 /**
  * List the TASK slugs currently lock-held on the arbiter — the held-slug set the
- * `ready/` pool readers SUBTRACT (prd `ledger-status-per-item-lock-refs` US #15;
+ * `ready/` pool readers SUBTRACT (spec `ledger-status-per-item-lock-refs` US #15;
  * task `claim-acquires-unified-lock-no-body-move`). Enumerates {@link listItemLocks}
  * and keeps only the `task-<slug>` entries (a prd/observation lock does not gate
  * the TASK pool), mapping each to its bare `<slug>`.

package/dist/item-path.d.ts

@@ -20,7 +20,7 @@ import type { WorkFolderKey } from './work-layout.js';
  * (`tasks-backlog`, `prds-proposed`) on purpose: a concurrent `promote` may have
  * just `git mv`'d the item from staging into the pool between an apply's CAPTURE
  * and WRITE, and the apply must resolve to the post-move path — the whole point of
- * folder-agnostic apply (F3a of prd `staging-surface-and-apply-promote-safety`).
+ * folder-agnostic apply (F3a of spec `staging-surface-and-apply-promote-safety`).
  * Terminal-only folders (`cancelled`, `prds-dropped`, `needs-attention`) are NOT
  * here — once an item has reached a terminal, the apply is OVER, and a re-resolve
  * into a terminal would mean the item has effectively vanished from the active
@@ -40,7 +40,7 @@ export declare const APPLY_LIFECYCLE_FOLDERS: Record<SidecarType, readonly WorkF
  * move) — the apply rung then exits CLEAN (no commit, no ghost file), routed as the
  * `vanished` outcome.
  *
- * This is the F3a fix from prd `staging-surface-and-apply-promote-safety`: the
+ * This is the F3a fix from spec `staging-surface-and-apply-promote-safety`: the
  * sidecar is already identity-keyed and folder-agnostic; the item path is now the
  * same. A concurrent `promote` that `git mv`'d the item out from under a captured
  * path can no longer cause a stale-path write.

package/dist/item-path.js

@@ -22,7 +22,7 @@ import { resolveSidecarIdentity } from './sidecar.js';
  * (`tasks-backlog`, `prds-proposed`) on purpose: a concurrent `promote` may have
  * just `git mv`'d the item from staging into the pool between an apply's CAPTURE
  * and WRITE, and the apply must resolve to the post-move path — the whole point of
- * folder-agnostic apply (F3a of prd `staging-surface-and-apply-promote-safety`).
+ * folder-agnostic apply (F3a of spec `staging-surface-and-apply-promote-safety`).
  * Terminal-only folders (`cancelled`, `prds-dropped`, `needs-attention`) are NOT
  * here — once an item has reached a terminal, the apply is OVER, and a re-resolve
  * into a terminal would mean the item has effectively vanished from the active
@@ -48,7 +48,7 @@ export const APPLY_LIFECYCLE_FOLDERS = {
  * move) — the apply rung then exits CLEAN (no commit, no ghost file), routed as the
  * `vanished` outcome.
  *
- * This is the F3a fix from prd `staging-surface-and-apply-promote-safety`: the
+ * This is the F3a fix from spec `staging-surface-and-apply-promote-safety`: the
  * sidecar is already identity-keyed and folder-agnostic; the item path is now the
  * same. A concurrent `promote` that `git mv`'d the item out from under a captured
  * path can no longer cause a stale-path write.

package/dist/ledger-lint.d.ts

@@ -1,6 +1,6 @@
 import { type LedgerStatusFolder } from './work-layout.js';
 /**
- * The **one-slug-one-folder LINT** over the `work/` lifecycle ledger (prd
+ * The **one-slug-one-folder LINT** over the `work/` lifecycle ledger (spec
  * `ledger-integrity`, story 3 — the READ-side belt-and-suspenders for defect 1).
  *
  * `work/` IS the ledger: a task's STATUS is the FOLDER its single `.md` lives in
@@ -27,14 +27,14 @@ import { type LedgerStatusFolder } from './work-layout.js';
  * The `work/` STATUS folders a task's ledger file can rest in — the
  * one-slug-one-folder set this lint is asserted over (WORK-CONTRACT.md
  * "status = the folder"). After 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 ONLY `work/` moves on `main` are the DURABLE RESTING transitions, so a
  * task's ledger file can rest only in the DURABLE set: the pool `backlog/`, the
  * terminal `done/`, and the task regime's PER-REGIME "won't-proceed" terminal
- * `tasks/cancelled/` (the per-regime split of the previous shared `dropped/`, prd
+ * `tasks/cancelled/` (the per-regime split of the previous shared `dropped/`, spec
  * `folder-taxonomy-reorg-and-rename` US #10; the specific REASON lives in the item
- * BODY as a `reason:` value). The prd regime's terminal `prds/dropped/` is a
+ * BODY as a `reason:` value). The spec regime's terminal `specs/dropped/` is a
  * SEPARATE namespace and is NOT a task-status folder. The transient
  * `in-progress`/`needs-attention`/`tasking`/
  * `advancing` are GONE from `main`'s tree — they are per-item lock-ref state
@@ -45,11 +45,11 @@ import { type LedgerStatusFolder } from './work-layout.js';
  * `cancelled`). A read-side lint surfaces a slug that ends up in `tasks/cancelled/`
  * AND another status folder, so the lint covers all three.
  *
- * The capture buckets (`ideas`/`observations`/`findings`) and the prd-flow folders
- * (`prds/ready`/`prds/tasked`) are NOT task-status folders (WORK-CONTRACT.md: the buckets
- * are "exempt from status = folder"; the prd folders carry prds, a separate
+ * The capture buckets (`ideas`/`observations`/`findings`) and the spec-flow folders
+ * (`specs/ready`/`specs/tasked`) are NOT task-status folders (WORK-CONTRACT.md: the buckets
+ * are "exempt from status = folder"; the spec folders carry prds, a separate
  * namespace) — they are deliberately EXCLUDED so a slug that legitimately has both
- * a task and a same-named note/prd is never a false positive.
+ * a task and a same-named note/spec is never a false positive.
  */
 export { LEDGER_STATUS_FOLDERS, type LedgerStatusFolder } from './work-layout.js';
 /** One slug found in more than one status folder — the corruption to surface. */
@@ -103,7 +103,7 @@ export interface LedgerSweepResult {
     duplicates: DuplicateSlug[];
 }
 /**
- * The `gc`-STYLE ledger SWEEP (prd story 3's belt-and-suspenders): on demand,
+ * The `gc`-STYLE ledger SWEEP (spec story 3's belt-and-suspenders): on demand,
  * REPORT every slug present in more than one status folder of a LOCAL `work/`
  * ledger, naming the folders and the CANDIDATE canonical folder — and NEVER
  * auto-delete. A human confirms the cleanup (keep the canonical copy, delete the

package/dist/ledger-lint.js

@@ -4,7 +4,7 @@ import { parseFrontmatter } from './frontmatter.js';
 import { run } from './git.js';
 import { LEDGER_STATUS_FOLDERS, workFolderName, workFolderPath, workFolderPrefix, isWorkItemFile, } from './work-layout.js';
 /**
- * The **one-slug-one-folder LINT** over the `work/` lifecycle ledger (prd
+ * The **one-slug-one-folder LINT** over the `work/` lifecycle ledger (spec
  * `ledger-integrity`, story 3 — the READ-side belt-and-suspenders for defect 1).
  *
  * `work/` IS the ledger: a task's STATUS is the FOLDER its single `.md` lives in
@@ -31,14 +31,14 @@ import { LEDGER_STATUS_FOLDERS, workFolderName, workFolderPath, workFolderPrefix
  * The `work/` STATUS folders a task's ledger file can rest in — the
  * one-slug-one-folder set this lint is asserted over (WORK-CONTRACT.md
  * "status = the folder"). After 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 ONLY `work/` moves on `main` are the DURABLE RESTING transitions, so a
  * task's ledger file can rest only in the DURABLE set: the pool `backlog/`, the
  * terminal `done/`, and the task regime's PER-REGIME "won't-proceed" terminal
- * `tasks/cancelled/` (the per-regime split of the previous shared `dropped/`, prd
+ * `tasks/cancelled/` (the per-regime split of the previous shared `dropped/`, spec
  * `folder-taxonomy-reorg-and-rename` US #10; the specific REASON lives in the item
- * BODY as a `reason:` value). The prd regime's terminal `prds/dropped/` is a
+ * BODY as a `reason:` value). The spec regime's terminal `specs/dropped/` is a
  * SEPARATE namespace and is NOT a task-status folder. The transient
  * `in-progress`/`needs-attention`/`tasking`/
  * `advancing` are GONE from `main`'s tree — they are per-item lock-ref state
@@ -49,11 +49,11 @@ import { LEDGER_STATUS_FOLDERS, workFolderName, workFolderPath, workFolderPrefix
  * `cancelled`). A read-side lint surfaces a slug that ends up in `tasks/cancelled/`
  * AND another status folder, so the lint covers all three.
  *
- * The capture buckets (`ideas`/`observations`/`findings`) and the prd-flow folders
- * (`prds/ready`/`prds/tasked`) are NOT task-status folders (WORK-CONTRACT.md: the buckets
- * are "exempt from status = folder"; the prd folders carry prds, a separate
+ * The capture buckets (`ideas`/`observations`/`findings`) and the spec-flow folders
+ * (`specs/ready`/`specs/tasked`) are NOT task-status folders (WORK-CONTRACT.md: the buckets
+ * are "exempt from status = folder"; the spec folders carry prds, a separate
  * namespace) — they are deliberately EXCLUDED so a slug that legitimately has both
- * a task and a same-named note/prd is never a false positive.
+ * a task and a same-named note/spec is never a false positive.
  */
 export { LEDGER_STATUS_FOLDERS } from './work-layout.js';
 /**
@@ -204,7 +204,7 @@ export function formatDuplicateWarnings(duplicates) {
     return lines;
 }
 /**
- * The `gc`-STYLE ledger SWEEP (prd story 3's belt-and-suspenders): on demand,
+ * The `gc`-STYLE ledger SWEEP (spec story 3's belt-and-suspenders): on demand,
  * REPORT every slug present in more than one status folder of a LOCAL `work/`
  * ledger, naming the folders and the CANDIDATE canonical folder — and NEVER
  * auto-delete. A human confirms the cleanup (keep the canonical copy, delete the