mandrel 1.76.0 → 1.78.0

package/.agents/workflows/loops/watch-ci.md

@@ -0,0 +1,68 @@
+---
+description: >-
+  Interval watch loop that polls a pull request's CI checks until they settle.
+  Each round runs `gh pr checks` and reports the delta; the host (`/loop 5m`)
+  owns the cadence and re-invokes the unit on its schedule. verify is optional
+  for an interval loop — the externally-scheduled host owns iteration, so this
+  unit ships the action and goal, not a terminating oracle.
+loop:
+  cadence: interval
+  goal: >-
+    Keep an eye on the current pull request's required CI checks each interval,
+    surfacing the first failed or stuck check the moment it appears so a human
+    can act before the checks finish.
+  maxRounds: 60
+  onExhaust: report
+---
+
+# /loops:watch-ci — poll a PR's checks until they settle
+
+An **interval watch loop**. The host (`/loop <interval> /loops:watch-ci`, e.g.
+`/loop 5m …`) owns the cadence and re-runs this unit on each tick. Because the
+host schedules iteration externally, this unit carries **no `verify` oracle** —
+per the loop-unit schema, `verify` is required only for `self-paced` cadence and
+optional for `interval` / `cron`. The unit's job each round is to observe and
+report, not to converge.
+
+## Action
+
+Each interval:
+
+1. **Read the current check state.** Run `gh pr checks` for the PR under watch
+   (the host supplies the PR number, or it is inferred from the current
+   branch's open PR). Capture the per-check status: pending, passed, or failed.
+2. **Compute the delta since last round.** Compare against the prior round's
+   snapshot. A check that flipped `pending → failed` is the headline; a check
+   that flipped `pending → passed` is progress.
+3. **Surface failures immediately.** On the first failed or cancelled required
+   check, report it — name the check, link the run, and quote the first error
+   line if cheaply available — so a human can act before the rest of the matrix
+   finishes. Do not wait for the whole suite to settle to raise a red check.
+4. **Report and yield.** Emit a one-line status summary
+   (`N passed, M pending, K failed`) and return control to the host, which
+   sleeps until the next interval.
+
+## Goal & done-signal
+
+- **Goal:** the operator learns about a CI failure on the watched PR as early as
+  the polling interval allows, and knows when all required checks have gone
+  green.
+- **Done-signal:** all required checks have a terminal status (every check
+  passed, or at least one has failed). An interval loop has no self-evaluated
+  oracle — the host stops the loop when the operator cancels it, when a failure
+  is surfaced and acted on, or when `maxRounds` is reached.
+- **Backstop:** `maxRounds: 60`. At a 5-minute interval that is ~5 hours of
+  watching; `onExhaust: report` emits a final status and stops rather than
+  polling forever on a wedged check.
+
+## Stop & escalate
+
+- **A required check failed.** Surface it and let the operator decide whether to
+  keep watching the remaining checks or stop. A failed required check is the
+  signal the watch existed to catch.
+- **The PR cannot be resolved** (no open PR for the branch, `gh` not
+  authenticated, the PR was merged or closed out from under the watch). Report
+  the condition and stop — there is nothing left to watch.
+- **`maxRounds` is reached with checks still pending.** Emit a final summary of
+  the stuck checks (`onExhaust: report`) so the operator can investigate the
+  wedged run.

package/docs/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.78.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.77.0...mandrel-v1.78.0) (2026-06-24)
+
+
+### Added
+
+* Epic [#4284](https://github.com/dsj1984/mandrel/issues/4284) ([#4297](https://github.com/dsj1984/mandrel/issues/4297)) ([0f7c543](https://github.com/dsj1984/mandrel/commit/0f7c543e1ceb1c38ac425c388e338e3bfaaec49e))
+
+
+### Fixed
+
+* **baselines:** apply ignoreGlobs in the maintainability baseline CLI diff-scope branch (refs [#4293](https://github.com/dsj1984/mandrel/issues/4293)) ([#4294](https://github.com/dsj1984/mandrel/issues/4294)) ([c0c7dd5](https://github.com/dsj1984/mandrel/commit/c0c7dd5948314800e5a9d5808fb5eb0b01b09833))
+* **close-validation:** treat biome "No files were processed" as a clean format-gate skip (refs [#4292](https://github.com/dsj1984/mandrel/issues/4292)) ([#4295](https://github.com/dsj1984/mandrel/issues/4295)) ([bf6840d](https://github.com/dsj1984/mandrel/commit/bf6840dd69abbece4eb221797e6432519b6614a0))
+
+
+### Changed
+
+* **github-provider:** unify the two divergent withTransientRetry into one canonical primitive (refs [#4298](https://github.com/dsj1984/mandrel/issues/4298)) ([#4299](https://github.com/dsj1984/mandrel/issues/4299)) ([e5668dc](https://github.com/dsj1984/mandrel/commit/e5668dcca73b37c37d38e52e1eb8d2930a0e1790))
+
+## [1.77.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.76.0...mandrel-v1.77.0) (2026-06-24)
+
+
+### Added
+
+* **close-validation:** unify evidence keyspace — critic verify[] sharing + standalone parity (refs [#4250](https://github.com/dsj1984/mandrel/issues/4250)) ([#4266](https://github.com/dsj1984/mandrel/issues/4266)) ([0555f3b](https://github.com/dsj1984/mandrel/commit/0555f3b0aaeabfb09c2ab02ed2bf7f5182a96c28))
+* **decompose-gates:** emit a deterministic soft missing-reason-to-exist finding + document reason_to_exist in the author SKILL (refs [#4273](https://github.com/dsj1984/mandrel/issues/4273)) ([#4280](https://github.com/dsj1984/mandrel/issues/4280)) ([98d3d5b](https://github.com/dsj1984/mandrel/commit/98d3d5b3d4ba8aa1c5485f5728e44bda09a6f3d3))
+* **decompose:** single-source the binding-vs-advisory authoring altitude + New-File Contract into the decomposer prompt (refs [#4272](https://github.com/dsj1984/mandrel/issues/4272)) ([#4279](https://github.com/dsj1984/mandrel/issues/4279)) ([3fc9adb](https://github.com/dsj1984/mandrel/commit/3fc9adb848226e4ef90463e31d5cbabb3f350c7f))
+* **deliver:** add --epic/--branch flags to story-phase.js and drop duplicate closing snapshot (refs [#4256](https://github.com/dsj1984/mandrel/issues/4256)) ([#4261](https://github.com/dsj1984/mandrel/issues/4261)) ([0f75eda](https://github.com/dsj1984/mandrel/commit/0f75eda48568d136803cd714ab0fd04bc341033d))
+* overhaul worktree install: copy-on-write node_modules + correct, PM-aware retry ([#4249](https://github.com/dsj1984/mandrel/issues/4249)) ([#4267](https://github.com/dsj1984/mandrel/issues/4267)) ([ce92a71](https://github.com/dsj1984/mandrel/commit/ce92a71b47a7851a04ce4d48ce6fa16c9ea41988))
+* persist Projects v2 board metadata to a disk cache ([#4252](https://github.com/dsj1984/mandrel/issues/4252)) ([#4263](https://github.com/dsj1984/mandrel/issues/4263)) ([277d9ec](https://github.com/dsj1984/mandrel/commit/277d9ecd8ac05fa291bb873a57966fc67d768205))
+* **story-body:** add optional advisory non_goals negative-scope section (refs [#4275](https://github.com/dsj1984/mandrel/issues/4275)) ([#4281](https://github.com/dsj1984/mandrel/issues/4281)) ([e118482](https://github.com/dsj1984/mandrel/commit/e118482aa5aa6ae2874c1da9d470d8c53b26bdf8))
+
+
+### Fixed
+
+* **decompose-gates:** parse string Story bodies in sizing/conflict gates (refs [#4271](https://github.com/dsj1984/mandrel/issues/4271)) ([#4277](https://github.com/dsj1984/mandrel/issues/4277)) ([6c804a4](https://github.com/dsj1984/mandrel/commit/6c804a4b6645f0742ba21ef145a5dc5a351b21bb))
+* rebuild the audit-to-stories Story body to the canonical inline-contract shape and gate it before issue creation ([#4270](https://github.com/dsj1984/mandrel/issues/4270)) ([#4278](https://github.com/dsj1984/mandrel/issues/4278)) ([058ff7b](https://github.com/dsj1984/mandrel/commit/058ff7b13ec799c11ed2ddf134adaf82c289168f))
+* **single-story-close:** release assignee-lease on recoverable-blocked exits (refs [#4257](https://github.com/dsj1984/mandrel/issues/4257)) ([#4268](https://github.com/dsj1984/mandrel/issues/4268)) ([108fa5f](https://github.com/dsj1984/mandrel/commit/108fa5f834121bf53c5cb59005415ea30b6e990f))
+* **story-body:** close section on unrecognized heading to stop content bleed (refs [#4274](https://github.com/dsj1984/mandrel/issues/4274)) ([#4276](https://github.com/dsj1984/mandrel/issues/4276)) ([808d508](https://github.com/dsj1984/mandrel/commit/808d5080fee460f24cae8ef43b2c8c1b442de1f3))
+
+
+### Performance
+
+* **coverage:** make run-coverage.js host-aware for --test-concurrency (refs [#4254](https://github.com/dsj1984/mandrel/issues/4254)) ([#4260](https://github.com/dsj1984/mandrel/issues/4260)) ([0078195](https://github.com/dsj1984/mandrel/commit/0078195afeee50fafefdaf4dea3d59b33b172cc6))
+* **deliver:** resolve Epic once and thread --prd/--tech-spec into story-init (refs [#4253](https://github.com/dsj1984/mandrel/issues/4253)) ([#4269](https://github.com/dsj1984/mandrel/issues/4269)) ([8dbc006](https://github.com/dsj1984/mandrel/commit/8dbc006882379ccdfb5dca90d8d8bca11c2dbb0e))
+* **story-init:** short-circuit childless 2-tier sub-issues + Search probe in buildTaskGraph (refs [#4251](https://github.com/dsj1984/mandrel/issues/4251)) ([#4265](https://github.com/dsj1984/mandrel/issues/4265)) ([7c8fcd2](https://github.com/dsj1984/mandrel/commit/7c8fcd21a9c781bd2e4592d7c8e7b4bf8476cd22))
+
+
+### Changed
+
+* **story-init:** single-home the duplicated branch-seed action switch (refs [#4255](https://github.com/dsj1984/mandrel/issues/4255)) ([#4264](https://github.com/dsj1984/mandrel/issues/4264)) ([7a6f2ec](https://github.com/dsj1984/mandrel/commit/7a6f2ec9c2e7ce0b680c620e9bb52541ec37db1b))
+
 ## [1.76.0](https://github.com/dsj1984/mandrel/compare/mandrel-v1.75.0...mandrel-v1.76.0) (2026-06-20)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mandrel",
-  "version": "1.76.0",
+  "version": "1.78.0",
   "description": "Claude Code-first opinionated workflow framework: instructions, personas, skills, and SDLC workflows that govern AI coding assistants.",
   "files": [
     ".agents/",

package/.agents/scripts/providers/github/transient-retry.js

@@ -1,62 +0,0 @@
-/**
- * transient-retry — shared retry-with-backoff for GitHub provider calls.
- *
- * Resilience for flaky connections (e.g. cell hotspots): retry ONLY on
- * connectivity blips, never on auth / scope / not-found / already-exists /
- * validation errors. Works for both surfaces the provider uses:
- *   - the gh CLI path — errors carry the Go HTTP error on `err.stderr`
- *     (e.g. `dial tcp ...: i/o timeout`); and
- *   - the direct `fetch` path — errors are a `TypeError: fetch failed` with
- *     the real reason on `err.cause` (e.g. `ETIMEDOUT`, `ENOTFOUND`).
- *
- * Retrying a non-idempotent create is acceptable for the dominant hotspot
- * failure (`dial tcp ... i/o timeout` means the connection never opened, so
- * the request never reached GitHub). Callers still gate retry per call so
- * the genuinely non-idempotent project-create can opt out.
- */
-
-const TRANSIENT_RE =
-  /i\/o timeout|dial tcp|TLS handshake timeout|connection reset|connection refused|temporary failure|could not resolve host|no such host|network is unreachable|socket hang up|fetch failed|ConnectTimeoutError|UND_ERR_CONNECT_TIMEOUT|ETIMEDOUT|ECONNRESET|ECONNREFUSED|ENOTFOUND|EAI_AGAIN|\b50[234]\b/i;
-
-/** True when an error looks like a retryable network/connectivity blip. */
-export function isTransientNetworkError(err) {
-  const hay = [
-    err?.stderr,
-    err?.message,
-    err?.code,
-    err?.cause?.message,
-    err?.cause?.code,
-  ]
-    .filter(Boolean)
-    .join(' ');
-  return TRANSIENT_RE.test(hay);
-}
-
-/**
- * Run `fn`, retrying with exponential backoff ONLY on transient network
- * errors (1s, 2s, 4s by default). Non-transient errors throw immediately so
- * real failures stay loud. `sleep` is injectable for tests.
- *
- * @template T
- * @param {() => Promise<T>} fn
- * @param {{ retries?: number, baseDelayMs?: number,
- *   sleep?: (ms: number) => Promise<void> }} [opts]
- * @returns {Promise<T>}
- */
-export async function withTransientRetry(
-  fn,
-  {
-    retries = 3,
-    baseDelayMs = 1000,
-    sleep = (ms) => new Promise((r) => setTimeout(r, ms)),
-  } = {},
-) {
-  for (let attempt = 0; ; attempt++) {
-    try {
-      return await fn();
-    } catch (err) {
-      if (attempt >= retries || !isTransientNetworkError(err)) throw err;
-      await sleep(baseDelayMs * 2 ** attempt);
-    }
-  }
-}