dorfl 0.1.2 → 0.2.0

package/dist/install-ci-github.js

@@ -206,6 +206,62 @@ export class GitHubCIContext {
             return false;
         return undefined;
     }
+    /**
+     * Detect the repo's DEFAULT BRANCH via
+     * `gh repo view --json defaultBranchRef --jq .defaultBranchRef.name`. Returns
+     * `undefined` when `gh` is unavailable / the repo is unknown / the call fails
+     * / the name is empty — the caller falls back to `main` (and logs it) so a
+     * `master`-defaulted repo is never silently protected on a hardcoded `main`.
+     */
+    async getDefaultBranch() {
+        if (!this.repo) {
+            return undefined;
+        }
+        const result = this.runGh([
+            'repo',
+            'view',
+            '--json',
+            'defaultBranchRef',
+            '--jq',
+            '.defaultBranchRef.name',
+        ]);
+        if (result === undefined || result.status !== 0) {
+            return undefined;
+        }
+        const name = result.stdout.trim();
+        return name === '' ? undefined : name;
+    }
+    /**
+     * Create the deadlock-guard RULESET via
+     * `POST /repos/{owner}/{repo}/rulesets`. The `ruleset` body is JSON-piped on
+     * stdin (`gh api --input -`) so the nested rule shape carries cleanly. Throws
+     * on a non-zero exit; caller logs + falls back. See the module header of
+     * `install-ci-branch-protection.ts` for why the required-check guard uses a
+     * ruleset while base protection stays a classic PUT.
+     */
+    async setBranchRuleset(ruleset) {
+        if (!this.repo) {
+            throw new Error('cannot create branch ruleset: repo unknown');
+        }
+        const args = [
+            'api',
+            '-X',
+            'POST',
+            '-H',
+            'Accept: application/vnd.github+json',
+            `repos/${this.repo}/rulesets`,
+            '--input',
+            '-',
+        ];
+        const result = this.runGhWithInput(args, JSON.stringify(ruleset));
+        if (result === undefined) {
+            throw new Error('gh not available; cannot create branch ruleset');
+        }
+        if (result.status !== 0) {
+            throw new Error(`gh api POST repos/${this.repo}/rulesets failed: ` +
+                (result.stderr.trim() || 'unknown error'));
+        }
+    }
     /**
      * Configure Tier-1 branch protection via
      * `PUT /repos/{owner}/{repo}/branches/{branch}/protection`. The `spec` body
@@ -281,16 +337,24 @@ export class MemoryCIProviderContext {
     repoSettings = new Map();
     /** Branch-protection spec recorded in memory (branch → spec). */
     branchProtections = new Map();
+    /** Deadlock-guard rulesets recorded in memory (append-only). */
+    rulesets = [];
     /** What `getRepoAdminScope()` should return (tests configure). */
     adminScope;
+    /** What `getDefaultBranch()` should return (tests configure). */
+    defaultBranch;
     /** Whether `setBranchProtection` should throw (tests configure). */
     branchProtectionError;
+    /** Whether `setBranchRuleset` should throw (tests configure). */
+    branchRulesetError;
     constructor(options) {
         this.workDir = options.workDir;
         this.repo = options.repo;
         this.ghAvailable = options.ghAvailable ?? false;
         this.adminScope = options.adminScope;
+        this.defaultBranch = options.defaultBranch;
         this.branchProtectionError = options.branchProtectionError;
+        this.branchRulesetError = options.branchRulesetError;
         this.providerId = options.providerId ?? GITHUB_PROVIDER_ID;
     }
     renderProjectSetup(payload) {
@@ -305,11 +369,20 @@ export class MemoryCIProviderContext {
     async getRepoAdminScope() {
         return this.adminScope;
     }
+    async getDefaultBranch() {
+        return this.defaultBranch;
+    }
     async setBranchProtection(branch, spec) {
         if (this.branchProtectionError !== undefined) {
             throw new Error(this.branchProtectionError);
         }
         this.branchProtections.set(branch, spec);
     }
+    async setBranchRuleset(ruleset) {
+        if (this.branchRulesetError !== undefined) {
+            throw new Error(this.branchRulesetError);
+        }
+        this.rulesets.push(ruleset);
+    }
 }
 //# sourceMappingURL=install-ci-github.js.map

package/dist/install-ci-github.js.map

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

package/dist/install-skills.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The dorfl-side wrapper around the VENDORED `incur/agents.ts` (MIT — see
+ * `./vendor/incur/`, and the ADR `docs/adr/skill-install-vendors-incur-agents-map.md`).
+ * The vendored file provides the ~22-harness destination map, `detect()`, and
+ * `install(sourceDir, options)` that copies each skill into the canonical
+ * `~/.agents/skills/` and symlinks non-universal harnesses. This module is the
+ * dorfl-authored code AROUND it: it resolves the packaged-skills SOURCE dir
+ * and drives the vendored `install()` — nothing more. Keep the vendored file
+ * untouched (byte-close to upstream) so future incur updates stay a mechanical
+ * re-copy.
+ *
+ * ## Decisions (in-scope, non-obvious)
+ *
+ * - **Sibling script over merged.** The build-time packaging lives in
+ *   `scripts/vendor-skills.mjs`, a SIBLING of the existing `vendor-protocol.mjs`
+ *   rather than an appended block on it. The two scripts copy DIFFERENT concept
+ *   sets (contract docs vs. hand-authored skills) into different dest subtrees;
+ *   each has its own set that evolves independently. See the header of
+ *   `vendor-skills.mjs` for the rationale (mirrors the wording here).
+ * - **Vendored file location.** `src/vendor/incur/agents.ts` (co-located with
+ *   its MIT `LICENSE` + a `README.md` provenance note). Under `src/` so `tsc`
+ *   compiles it into `dist/vendor/incur/agents.js`; under `vendor/incur/` so
+ *   the upstream origin is CLEAR from the path, and a future re-copy is a
+ *   drop-in overwrite. All dorfl wrapper code lives OUTSIDE that directory.
+ * - **Resolver home.** {@link resolveSkillsSourceDir} lives IN this module
+ *   (not in `prompt.ts` next to `resolveProtocolDoc`) because "the packaged
+ *   skills source" is a concept OWNED by skill-install; `resolveProtocolDoc`
+ *   is owned by the runner's prompt-assembly. Same SHAPE, different concept —
+ *   duplicating the small resolver body keeps the ownership boundary clean.
+ */
+import { type Agent } from './vendor/incur/agents.js';
+/**
+ * Locate the SOURCE directory of the vendored skills the installer copies
+ * from. Resolution order, highest authority first:
+ *
+ *   1. `override` — explicit, for tests / unusual layouts (short-circuits).
+ *   2. `dist/skills/` — a copy VENDORED inside this package (by the
+ *      `vendor-skills` build step). The published-CLI primary: an installed
+ *      CLI has no sibling monorepo-root `skills/` tree.
+ *   3. the legacy monorepo-relative `skills/` walk — DEV-only, kept LAST (it
+ *      only resolves inside this dev monorepo; an installed CLI's walks escape
+ *      into the consumer's filesystem \u2192 nothing there, which is why it cannot
+ *      be the primary source).
+ *
+ * Mirrors the shape of {@link import('./prompt.js').resolveProtocolDoc} — the
+ * prefer-`dist/`-then-dev-walk order. Returns the first existing candidate;
+ * when nothing exists, returns the first candidate (the caller then hits a
+ * clean ENOENT rather than a silent no-op).
+ */
+export declare function resolveSkillsSourceDir(override?: string): string;
+/**
+ * Options threaded through {@link installSkills} to the vendored `install()`.
+ * The shape mirrors incur's `install.Options` verbatim, plus a `sourceDir`
+ * override for the resolver seam. Everything is optional; a bare call
+ * `installSkills()` performs the "install every packaged skill, globally,
+ * into every detected harness" default.
+ */
+export interface InstallSkillsOptions {
+    /**
+     * Override the resolved packaged-skills source dir. Tests pin this to a
+     * scratch dir with fake skill folders; production callers omit it and take
+     * whatever {@link resolveSkillsSourceDir} returns.
+     */
+    sourceDir?: string;
+    /**
+     * `false` \u21d2 project-local placement (canonical base is `<cwd>/.agents/skills/`,
+     * and non-universal harnesses use their PROJECT-relative dirs). Default
+     * `true` (or omitted) \u21d2 global placement under `~/.agents/skills/`.
+     */
+    global?: boolean;
+    /**
+     * Working directory for project-local installs. Ignored when `global` is not
+     * `false`. Defaults (in the vendored file) to `process.cwd()`.
+     */
+    cwd?: string;
+    /**
+     * Override the detected harnesses. Tests use this to force a deterministic
+     * set; production callers omit it and let the vendored `detect()` pick.
+     */
+    agents?: Agent[];
+}
+/**
+ * The per-harness install detail returned by the vendored `install()` (for
+ * NON-UNIVERSAL harnesses only \u2014 universal harnesses read from the canonical
+ * `.agents/skills/` directly and need no per-harness entry).
+ */
+export interface InstalledAgent {
+    /** Harness display name (e.g. `'Claude Code'`, `'Windsurf'`). */
+    agent: string;
+    /** Absolute path the skill was placed at for this harness. */
+    path: string;
+    /** How the placement was materialised. Symlink is the norm; copy is the
+     *  Windows/no-permission fallback. */
+    mode: 'symlink' | 'copy';
+}
+/** The report {@link installSkills} returns to its CLI caller. */
+export interface InstallSkillsResult {
+    /**
+     * The SOURCE directory the vendored `install()` was driven from (the value
+     * {@link resolveSkillsSourceDir} chose). Included so `dorfl skills add`
+     * can print WHERE the skills were read from, and tests can assert the
+     * resolver picked what they expected.
+     */
+    sourceDir: string;
+    /** Canonical install paths (one per skill directory copied). */
+    paths: string[];
+    /** Per-harness placements for non-universal harnesses. */
+    agents: InstalledAgent[];
+}
+/**
+ * Resolve the packaged-skills source, drive the vendored `install()`, return
+ * the source + canonical paths + per-harness report. Global by default; pass
+ * `global: false` for project-local placement. Tests pin `sourceDir`/`agents`
+ * to keep the run hermetic; production callers pass nothing.
+ *
+ * The vendored `install()` reads `os.homedir()` (etc.) at MODULE LOAD, so
+ * shared-write isolation for `global: true` (the default) has to happen BEFORE
+ * this module is loaded (e.g. by pointing `HOME` at a scratch dir). Tests use
+ * `global: false` + a scratch `cwd` for the common path (no env dance needed);
+ * see `test/install-skills.test.ts`.
+ */
+export declare function installSkills(options?: InstallSkillsOptions): InstallSkillsResult;
+//# sourceMappingURL=install-skills.d.ts.map

package/dist/install-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.d.ts","sourceRoot":"","sources":["../src/install-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,EAAU,KAAK,KAAK,EAAC,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAqBhE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACpC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb;0CACsC;IACtC,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;CACzB;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IACnC;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,0DAA0D;IAC1D,MAAM,EAAE,cAAc,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC5B,OAAO,GAAE,oBAAyB,GAChC,mBAAmB,CAYrB"}

package/dist/install-skills.js

@@ -0,0 +1,100 @@
+/**
+ * The dorfl-side wrapper around the VENDORED `incur/agents.ts` (MIT — see
+ * `./vendor/incur/`, and the ADR `docs/adr/skill-install-vendors-incur-agents-map.md`).
+ * The vendored file provides the ~22-harness destination map, `detect()`, and
+ * `install(sourceDir, options)` that copies each skill into the canonical
+ * `~/.agents/skills/` and symlinks non-universal harnesses. This module is the
+ * dorfl-authored code AROUND it: it resolves the packaged-skills SOURCE dir
+ * and drives the vendored `install()` — nothing more. Keep the vendored file
+ * untouched (byte-close to upstream) so future incur updates stay a mechanical
+ * re-copy.
+ *
+ * ## Decisions (in-scope, non-obvious)
+ *
+ * - **Sibling script over merged.** The build-time packaging lives in
+ *   `scripts/vendor-skills.mjs`, a SIBLING of the existing `vendor-protocol.mjs`
+ *   rather than an appended block on it. The two scripts copy DIFFERENT concept
+ *   sets (contract docs vs. hand-authored skills) into different dest subtrees;
+ *   each has its own set that evolves independently. See the header of
+ *   `vendor-skills.mjs` for the rationale (mirrors the wording here).
+ * - **Vendored file location.** `src/vendor/incur/agents.ts` (co-located with
+ *   its MIT `LICENSE` + a `README.md` provenance note). Under `src/` so `tsc`
+ *   compiles it into `dist/vendor/incur/agents.js`; under `vendor/incur/` so
+ *   the upstream origin is CLEAR from the path, and a future re-copy is a
+ *   drop-in overwrite. All dorfl wrapper code lives OUTSIDE that directory.
+ * - **Resolver home.** {@link resolveSkillsSourceDir} lives IN this module
+ *   (not in `prompt.ts` next to `resolveProtocolDoc`) because "the packaged
+ *   skills source" is a concept OWNED by skill-install; `resolveProtocolDoc`
+ *   is owned by the runner's prompt-assembly. Same SHAPE, different concept —
+ *   duplicating the small resolver body keeps the ownership boundary clean.
+ */
+import { existsSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { install } from './vendor/incur/agents.js';
+/**
+ * Locate the SOURCE directory of the vendored skills the installer copies
+ * from. Resolution order, highest authority first:
+ *
+ *   1. `override` — explicit, for tests / unusual layouts (short-circuits).
+ *   2. `dist/skills/` — a copy VENDORED inside this package (by the
+ *      `vendor-skills` build step). The published-CLI primary: an installed
+ *      CLI has no sibling monorepo-root `skills/` tree.
+ *   3. the legacy monorepo-relative `skills/` walk — DEV-only, kept LAST (it
+ *      only resolves inside this dev monorepo; an installed CLI's walks escape
+ *      into the consumer's filesystem \u2192 nothing there, which is why it cannot
+ *      be the primary source).
+ *
+ * Mirrors the shape of {@link import('./prompt.js').resolveProtocolDoc} — the
+ * prefer-`dist/`-then-dev-walk order. Returns the first existing candidate;
+ * when nothing exists, returns the first candidate (the caller then hits a
+ * clean ENOENT rather than a silent no-op).
+ */
+export function resolveSkillsSourceDir(override) {
+    if (override) {
+        return override;
+    }
+    const here = dirname(fileURLToPath(import.meta.url));
+    // here = .../packages/dorfl/{src,dist}.
+    const candidates = [
+        // 2. Package-vendored copy (published-CLI primary). From `src/` (tsx)
+        //    `dist/` is a sibling; from `dist/` it is the dir itself.
+        resolve(here, '..', 'dist', 'skills'),
+        resolve(here, 'skills'),
+        // 3. Legacy monorepo-root walk \u2014 DEV-only, LAST.
+        resolve(here, '..', '..', '..', 'skills'),
+        resolve(here, '..', '..', '..', '..', 'skills'),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return candidates[0];
+}
+/**
+ * Resolve the packaged-skills source, drive the vendored `install()`, return
+ * the source + canonical paths + per-harness report. Global by default; pass
+ * `global: false` for project-local placement. Tests pin `sourceDir`/`agents`
+ * to keep the run hermetic; production callers pass nothing.
+ *
+ * The vendored `install()` reads `os.homedir()` (etc.) at MODULE LOAD, so
+ * shared-write isolation for `global: true` (the default) has to happen BEFORE
+ * this module is loaded (e.g. by pointing `HOME` at a scratch dir). Tests use
+ * `global: false` + a scratch `cwd` for the common path (no env dance needed);
+ * see `test/install-skills.test.ts`.
+ */
+export function installSkills(options = {}) {
+    const sourceDir = resolveSkillsSourceDir(options.sourceDir);
+    const result = install(sourceDir, {
+        global: options.global,
+        cwd: options.cwd,
+        agents: options.agents,
+    });
+    return {
+        sourceDir,
+        paths: result.paths,
+        agents: result.agents,
+    };
+}
+//# sourceMappingURL=install-skills.js.map

package/dist/install-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.js","sourceRoot":"","sources":["../src/install-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,SAAS,CAAC;AACnC,OAAO,EAAC,OAAO,EAAE,OAAO,EAAC,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAC,aAAa,EAAC,MAAM,UAAU,CAAC;AACvC,OAAO,EAAC,OAAO,EAAa,MAAM,0BAA0B,CAAC;AAE7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACvD,IAAI,QAAQ,EAAE,CAAC;QACd,OAAO,QAAQ,CAAC;IACjB,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACrD,wCAAwC;IACxC,MAAM,UAAU,GAAa;QAC5B,sEAAsE;QACtE,8DAA8D;QAC9D,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC;QACrC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;QACvB,sDAAsD;QACtD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC;QACzC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC;KAC/C,CAAC;IACF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QAClB,CAAC;IACF,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAgED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAC5B,UAAgC,EAAE;IAElC,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,MAAM,EAAE,OAAO,CAAC,MAAM;KACtB,CAAC,CAAC;IACH,OAAO;QACN,SAAS;QACT,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACrB,CAAC;AACH,CAAC"}

package/dist/intake-trigger-template.js

@@ -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}

package/dist/intake.d.ts

@@ -53,7 +53,7 @@ import { type IntakeTriageDecision } from './intake-triage.js';
  * 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';
@@ -198,7 +198,7 @@ export interface PerformIntakeOptions {
      * 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 spec 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
@@ -209,7 +209,7 @@ 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 spec/
-     * task it emits, so the author-trust signal SURVIVES the prd/task merge
+     * 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`
@@ -267,6 +267,19 @@ 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. */
@@ -286,7 +299,7 @@ export interface PerformIntakeOptions {
 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 spec file (`work/specs/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.)

package/dist/intake.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../src/intake.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../src/intake.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,eAAe,EAAE,cAAc,EAAC,MAAM,iBAAiB,CAAC;AAErE,OAAO,KAAK,EAAC,eAAe,EAAE,WAAW,EAAC,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAC;AAMlD,OAAO,EAGN,KAAK,QAAQ,EACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAc,KAAK,OAAO,EAAC,MAAM,cAAc,CAAC;AAGvD,OAAO,EAGN,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACN,kBAAkB,EAGlB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAe,KAAK,oBAAoB,EAAC,MAAM,oBAAoB,CAAC;AAG3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC7B,oDAAoD;IACpD,OAAO,EAAE,aAAa,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GACzB,QAAQ,GACR,OAAO,GACP,cAAc,GACd,SAAS,GACT,cAAc,GACd,kBAAkB,GAClB,QAAQ,GACR,aAAa,GACb,cAAc,GACd,OAAO,GACP,aAAa,CAAC;AAEjB,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACpC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,0FAA0F;IAC1F,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;;;;;OAQG;IACH,mBAAmB,CAAC,EAAE,WAAW,CAAC;IAClC;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,cAAc,CAAC;IAClC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,8CAA8C;IAC9C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAID;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,QAAkC,CAAC;AA+BhE;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAC;AAIjD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,sBAAsB;IACtC,qFAAqF;IACrF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qFAAqF;AACrF,MAAM,WAAW,sBAAsB;IACtC,gDAAgD;IAChD,IAAI,EAAE,eAAe,CAAC;IACtB;;;;OAIG;IACH,IAAI,EAAE,eAAe,CAAC;CACtB;AA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,sBAAsB,EAC7B,WAAW,GAAE,eAAqC,GAChD,sBAAsB,CA0BxB;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,oBAAoB,GAC3B,OAAO,CAAC,YAAY,CAAC,CA2KvB;AAywBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACtD,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,eAAe,GAAG,SAAS,CAAC;IACzC,IAAI,EAAE,MAAM,EAAE,CAAC;CACf,GAAG,MAAM,CAkBT;AAqGD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B,GAAG,MAAM,CA+BT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC;IAC/B,YAAY,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B,GAAG,MAAM,CAyCT;AAuGD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAkEhE;AAqBD;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC;AAElD,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACvC,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAChC,KAAK,EAAE,uBAAuB,KAC1B,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAuMpC,uEAAuE;AACvE,MAAM,WAAW,gCAAgC;IAChD,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACxC,OAAO,GAAE,gCAAqC,GAC5C,kBAAkB,CA0BpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,uBAAuB,GAC5B,MAAM,CAsDR;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,2BAAqB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EAAE,EACxB,MAAM,CAAC,EAAE,oBAAoB,GAC3B,MAAM,CA4HR"}

package/dist/intake.js

@@ -411,6 +411,9 @@ async function decideAndDispatch(options, cwd, issue, comments, ctx) {
                 cwd,
                 arbiter,
                 integration: modes.task,
+                // The resolved cross-job CAS-retry cap (config `mergeRetries`) — threaded so
+                // intake's lone-task emit lands under the same per-repo cap the build path uses.
+                mergeRetries: options.mergeRetries,
                 // The origin-trust STAMP, passed IN (not resolved here): the emitted task
                 // carries `origin: issue` + this verdict so the becomes-code checkpoint is
                 // not laundered. Unset ⇒ unstamped (a local intake ⇒ human/trusted).
@@ -429,7 +432,7 @@ async function decideAndDispatch(options, cwd, issue, comments, ctx) {
                 note,
             });
         // The `spec` outcome is the parent-spec verdict; it dispatches through
-        // `modes.spec`. HARD CUTOVER: the legacy `prd` outcome case is GONE.
+        // `modes.spec`. HARD CUTOVER: the legacy ''prd'' outcome case is GONE.
         case 'spec':
             return dispatchSpec({
                 verdict,
@@ -437,6 +440,9 @@ async function decideAndDispatch(options, cwd, issue, comments, ctx) {
                 cwd,
                 arbiter,
                 integration: modes.spec,
+                // The resolved cross-job CAS-retry cap (config `mergeRetries`) — threaded so
+                // intake's spec emit lands under the same per-repo cap the build path uses.
+                mergeRetries: options.mergeRetries,
                 // Same origin-trust stamp on the spec outcome (propagated onto its tasks
                 // later by the tasker). Passed IN; not resolved here.
                 originTrust: options.originTrust,
@@ -580,7 +586,7 @@ async function dispatchComment(params) {
  * agent did NO git/seam ops.
  */
 async function dispatchTask(params) {
-    const { verdict, issueNumber, cwd, arbiter, integration, originTrust, noPR, providerInstance, issueProvider, reviewTask, seen, env, agentEnv, note, } = params;
+    const { verdict, issueNumber, cwd, arbiter, integration, mergeRetries, originTrust, noPR, providerInstance, issueProvider, reviewTask, seen, env, agentEnv, note, } = params;
     // A content-derived slug — NEVER a counter (spec `issue-intake` US #8). Prefer the drafted
     // `taskSlug`, else derive from the drafted title; sanitise either through
     // `paramCase` so the filename + frontmatter slug are well-formed.
@@ -684,6 +690,12 @@ async function dispatchTask(params) {
         // EXPLICITLY-chosen mode proceeds as-is: a future `--merge-task` lands on main
         // (`merge` IS the auto-land mode, never downgraded).
         mode: integration,
+        // The cross-job merge-serialiser CAS-retry cap (config `mergeRetries`) — the
+        // git-alone floor of the cross-job land queue, resolved through the gate-
+        // family precedence chain in the CLI and threaded here so intake's lone-task
+        // emit lands under the same per-repo cap the build path uses. Unset ⇒ the
+        // engine default (byte-for-byte unchanged).
+        mergeRetries,
         noPR,
         providerInstance,
         type: 'feat',
@@ -713,8 +725,8 @@ async function dispatchTask(params) {
     });
 }
 /**
- * DISPATCH the `spec` outcome (canonical; the legacy `prd` outcome routes here too
- * through the cutover): derive a content-derived slug, write the spec file
+ * DISPATCH the `spec` outcome (the SOLE parent-spec outcome after the HARD CUTOVER;
+ * the legacy ''prd'' outcome token is GONE): derive a content-derived slug, write the spec file
  * (`work/specs/ready/<slug>.md`) carrying `issue: N` (the loop-closure linkage the
  * close JOB reaches via `task.spec: → spec issue:`; on a fanned spec the number
  * lives ONLY on the spec — a fanned task uses `spec:`, NOT its own `issue:`, which
@@ -725,7 +737,7 @@ async function dispatchTask(params) {
  * runner owns the git exactly as the task branch does; the agent did NO git/seam ops.
  */
 async function dispatchSpec(params) {
-    const { verdict, issueNumber, cwd, arbiter, integration, originTrust, noPR, specsLandIn, explicitSpecsLandIn, providerInstance, issueProvider, seen, env, note, } = params;
+    const { verdict, issueNumber, cwd, arbiter, integration, mergeRetries, originTrust, noPR, specsLandIn, explicitSpecsLandIn, providerInstance, issueProvider, seen, env, note, } = params;
     // A content-derived slug — NEVER a counter (spec `issue-intake` US #8). Prefer the drafted
     // `specSlug`, else derive from the drafted title.
     const slug = resolveSpecSlug(verdict);
@@ -774,6 +786,10 @@ async function dispatchSpec(params) {
         // not a build), exactly as the task branch + the tasking transition skip it.
         skipVerify: true,
         mode: integration,
+        // The cross-job merge-serialiser CAS-retry cap (config `mergeRetries`) — same
+        // rationale as the lone-task emit above; threaded so intake's spec emit lands
+        // under the same per-repo cap. Unset ⇒ the engine default (byte-for-byte).
+        mergeRetries,
         noPR,
         providerInstance,
         type: 'feat',
@@ -1091,7 +1107,7 @@ async function stageIntakeContent(params) {
  * `intake-` PRODUCER prefix keeps this short-lived "create the item" branch
  * DISTINCT from the later build branch (`work/task-<slug>`) for the same slug
  * — the firing `intake` × `do task:` collision the observation traced. The
- * task-emit path passes `'task'`, the spec-emit path `'prd'`. A pre-existing
+ * task-emit path passes `'task'`, the spec-emit path `'spec'`. A pre-existing
  * local branch (a re-run) is force-recreated off fresh main.
  */
 async function switchToWorkBranch(cwd, arbiter, type, slug, env) {
@@ -1184,7 +1200,7 @@ export function parseIntakeVerdict(output) {
         outcome !== 'spec' &&
         outcome !== 'bounce') {
         // The prompt teaches the LLM to emit `spec`, so the accepted outcome set is
-        // `ask|task|spec|bounce`. HARD CUTOVER: the legacy `prd` outcome token is
+        // `ask|task|spec|bounce`. HARD CUTOVER: the legacy ''prd'' outcome token is
         // fully gone (rejected here + removed from the `IntakeOutcome` type + the
         // dispatch `case`).
         throw new Error(`intake verdict 'outcome' was not one of ask|task|spec|bounce (got ` +