mandrel 2.8.0 → 2.9.0

package/.agents/scripts/single-story-confirm-merge.js

@@ -44,6 +44,7 @@ import { gh as defaultGh } from './lib/gh-exec.js';
 import { getStoryBranch } from './lib/git-utils.js';
 import { Logger } from './lib/Logger.js';
 import { emitTerminalFriction } from './lib/observability/runtime-friction.js';
+import { emitTerseResult } from './lib/observability/terse-result.js';
 import { MERGED_FLIP_FAILED_BLOCK_CLASS } from './lib/orchestration/lifecycle/emit-merge-flip-failed.js';
 import { parsePrNumber } from './lib/orchestration/single-story-close/phases/code-review.js';
 import { runConfirmMergePhase as defaultRunConfirmMergePhase } from './lib/orchestration/single-story-close/phases/confirm-merge.js';
@@ -142,11 +143,19 @@ async function resolvePrNumber({ cwd, storyBranch, gh }) {
  * exits via `process.exit` the moment `main` resolves.
  */
 async function logConfirmResult(result, terminal, config) {
-  // Human-facing dump stays level-gated; the envelope is the machine
-  // contract and must survive AGENT_LOG_LEVEL=silent.
-  Logger.info(
-    `\n--- CONFIRM MERGE RESULT ---\n${JSON.stringify(result, null, 2)}\n--- END RESULT ---\n`,
-  );
+  // Story #4685 — full detail to a temp log; the agent acts on the terminal
+  // envelope emitted below. The summary line keeps the at-a-glance fields.
+  emitTerseResult({
+    label: 'CONFIRM MERGE RESULT',
+    result,
+    scope: result?.storyId,
+    summary: {
+      storyId: result?.storyId,
+      action: result?.action,
+      reason: result?.reason,
+      status: terminal?.status,
+    },
+  });
   emitTerminalEnvelope(terminal);
   await emitTerminalFriction({ envelope: terminal, config });
   return { success: terminal.status !== 'failed', result, terminal };

package/.agents/scripts/single-story-init.js

@@ -55,6 +55,7 @@ import { getStoryBranch, gitSpawn, gitSync } from './lib/git-utils.js';
 import { Logger } from './lib/Logger.js';
 import { TYPE_LABELS } from './lib/label-constants.js';
 import { setActiveStoryEnv } from './lib/observability/active-story-env.js';
+import { emitTerseResult } from './lib/observability/terse-result.js';
 import {
   executeFastForward,
   planFastForward,
@@ -769,9 +770,24 @@ export async function runSingleStoryInit({
     }
   }
 
-  Logger.info('\n--- STORY INIT RESULT ---');
-  Logger.info(JSON.stringify(result, null, 2));
-  Logger.info('--- END RESULT ---\n');
+  // Story #4685 — route the full result to a temp log and emit a single-line
+  // summary carrying the fields the orchestrating agent acts on (workCwd,
+  // remoteVerified). The `## Spec` names this the hot-path stdout to quiet.
+  emitTerseResult({
+    label: 'STORY INIT RESULT',
+    result,
+    scope: storyId,
+    logDir: path.join(cwd, 'temp', 'orchestration'),
+    summary: {
+      storyId,
+      storyBranch,
+      workCwd,
+      worktreeCreated,
+      dependenciesInstalled,
+      remoteVerified: result.remoteVerified,
+      dryRun,
+    },
+  });
   progress(
     'DONE',
     dryRun

package/.agents/scripts/sync-branch-from-base.js

@@ -34,6 +34,7 @@ import { runAsCli } from './lib/cli-utils.js';
 import { syncBranchFromBase } from './lib/git/sync-from-base.js';
 import { gitSpawn, gitSync } from './lib/git-utils.js';
 import { Logger } from './lib/Logger.js';
+import { emitTerseResult } from './lib/observability/terse-result.js';
 import { PROJECT_ROOT } from './lib/project-root.js';
 
 const progress = Logger.createProgress('sync-branch-from-base', {
@@ -93,9 +94,14 @@ export async function runSyncBranchFromBase(opts = {}) {
     gitSpawn,
   });
 
-  Logger.info(
-    `\n--- SYNC RESULT ---\n${JSON.stringify(result, null, 2)}\n--- END RESULT ---\n`,
-  );
+  // Story #4685 — full detail to a temp log; emit a single summary line.
+  emitTerseResult({
+    label: 'SYNC RESULT',
+    result,
+    scope: branch,
+    logDir: path.join(cwd, 'temp', 'orchestration'),
+    summary: { branch, base, synced: result.synced, kind: result.kind },
+  });
 
   if (!result.synced) {
     const detail =

package/.agents/workflows/helpers/deliver-story.md

@@ -39,6 +39,16 @@ large — uses the same machinery:
 If the Story still carries an `Epic: #N` reference, **stop** — that is a v1
 Epic-attached ticket; re-plan as a v2 Story or finish it on a pre-v2 checkout.
 
+> **Ceremony-lite Stories still land through this engine unchanged (Story
+> #4683).** A Story that `/plan` routed onto the ceremony-lite path (its
+> `complexityRoute.route === "lite"`) collapses only the *advisory* plan/deliver
+> ceremony — the fresh-critic / Tech-Spec authoring a one-artifact scope does
+> not earn. It does **not** get a cheaper landing: the close-validation gates
+> (lint / test / format / coverage / CRAP / maintainability), the PR to `main`,
+> and the `rules/security-baseline.md` MUSTs all run here exactly as for a
+> full-ceremony Story. The lite route's `preserves` field is the machine-readable
+> record of those non-negotiables; there is no lite-specific gate bypass.
+
 ## Prerequisites
 
 1. A GitHub Issue with the `type::story` label and **no** `Epic: #N`

package/.agents/workflows/plan.md

@@ -79,11 +79,36 @@ That is what makes superseding work without anyone re-typing ids
 
 The envelope carries docs context, codebase snapshot, BDD probe, risk
 heuristics, the story-author system prompt, `sourceTickets[]` (`--tickets`
-mode), and `duplicates[]` (open **Stories** whose title/body overlap the
-seed — never Epics).
+mode), `duplicates[]` (open **Stories** whose title/body overlap the
+seed — never Epics), and the `complexityRoute` ceremony-lite signal (below).
 Under `--yes`, do not ask free-form operator questions — unresolved
 unknowns land in Key Assumptions.
 
+#### Ceremony-lite complexity gate (`complexityRoute`)
+
+The envelope's `complexityRoute` field is a **deterministic, conservative**
+plan-time gate (Story #4683) that routes a genuinely trivial single-artifact
+seed onto a collapsed path so it stops paying the full two-session
+plan/deliver ceremony that measurably buys no quality at that size:
+
+- **`route: "lite"`** — a trivial scope (seed ≤ `maxSeedWords` words **and** ≤
+  `maxArtifacts` enumerated items). Collapse the ceremony: author **one minimal
+  Story** and skip the fresh-critic / Tech-Spec ceremony a one-artifact scope
+  does not earn. The lite route is **not** licence to drop a non-negotiable —
+  its `preserves` field enumerates exactly what still holds: the Story ticket,
+  the PR-to-`main` landing, every repo quality gate, and the security baseline.
+  Those gates still run in `single-story-close.js` regardless of route.
+- **`route: "full"`** — everything else. The gate fails toward `full` on any
+  doubt (empty seed, over the word ceiling, a multi-capability enumeration, or
+  the gate disabled via `planning.complexityGate.enabled=false`), so a real
+  capability slice never loses ceremony. Author normally under the split policy.
+
+The threshold and its override knob (`planning.complexityGate.{enabled,
+maxSeedWords, maxArtifacts}`) are documented in
+[`.agents/docs/configuration.md`](../docs/configuration.md) under `### planning`;
+the defaults live on `DEFAULT_COMPLEXITY_GATE` in
+[`lib/orchestration/complexity-gate.js`](../scripts/lib/orchestration/complexity-gate.js).
+
 **Gate #1** — STOP to confirm the sharpened plan intent and any
 duplicate-candidate review. Under `--yes`, auto-proceed.
 

package/docs/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.9.0](https://github.com/dsj1984/mandrel/compare/mandrel-v2.8.0...mandrel-v2.9.0) (2026-07-21)
+
+
+### Added
+
+* ceremony-lite path: complexity-gate the full plan/deliver pipeline for trivial scopes ([#4683](https://github.com/dsj1984/mandrel/issues/4683)) ([#4688](https://github.com/dsj1984/mandrel/issues/4688)) ([1002776](https://github.com/dsj1984/mandrel/commit/10027761c7bf375aa32b4ffe8b526015433311ca))
+* harden /audit-to-stories dedup search: budget the fan-out, bound the query, soft-fail instead of aborting ([#4678](https://github.com/dsj1984/mandrel/issues/4678)) ([#4679](https://github.com/dsj1984/mandrel/issues/4679)) ([c043b70](https://github.com/dsj1984/mandrel/commit/c043b708dca9daf10525fe0e810da9b13998454b))
+* **plan:** pre-empt deterministic body-format lints in the story-author prompt and auto-fix mechanical ones (refs [#4684](https://github.com/dsj1984/mandrel/issues/4684)) ([#4689](https://github.com/dsj1984/mandrel/issues/4689)) ([8dea7ad](https://github.com/dsj1984/mandrel/commit/8dea7adc71e9adcb746022747f3d436ccb520758))
+
+
+### Fixed
+
+* land tail: tolerate/pre-empt a worktree-held story branch so a merged PR is never stranded at agent::blocked ([#4681](https://github.com/dsj1984/mandrel/issues/4681)) ([#4686](https://github.com/dsj1984/mandrel/issues/4686)) ([0436af0](https://github.com/dsj1984/mandrel/commit/0436af0ab183c6e423cf2b56e749d63fa0c6b150))
+* root-cause and fix: second-touch change-request deliveries complete but their PR never lands ([#4682](https://github.com/dsj1984/mandrel/issues/4682)) ([#4687](https://github.com/dsj1984/mandrel/issues/4687)) ([2010739](https://github.com/dsj1984/mandrel/commit/20107399a9a1645c0d8b259245b275a965ffdcbc))
+
+
+### Performance
+
+* **orchestration:** quiet hot-path script stdout to terse summaries (refs [#4685](https://github.com/dsj1984/mandrel/issues/4685)) ([#4690](https://github.com/dsj1984/mandrel/issues/4690)) ([310ee4a](https://github.com/dsj1984/mandrel/commit/310ee4a70726dee0ace6da8bb866cb01e57f7c2b))
+
 ## [2.8.0](https://github.com/dsj1984/mandrel/compare/mandrel-v2.7.0...mandrel-v2.8.0) (2026-07-21)
 
 

package/package.json

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