chore(ultraplan-local): release v3.4.1 [skip-docs]

Step 14 of v3.4.1 plan — final release commit.

CHANGELOG.md: new top section [3.4.1] - 2026-05-04 documenting
/ultracontinue-local hot-fix (Bugs 1-4 + ESM/CJS regression +
plugin.json description drift) and the SC-6 doc-rydding sweep.

README.md: version badge 3.4.0 -> 3.4.1.

Marketplace root README.md: ultraplan-local entry header bumped to
v3.4.1.

prior commits in this release:
- 1da4f3f docs(ultraplan-local): Handover 7 § Lifecycle (SC-5)
- 6bca3fb docs(ultraplan-local): remove ultra-cc-architect references (SC-6)
- 561ad5a chore(ultraplan-local): bump v3.4.1 + plugin.json description drift fix

The user-facing docs were already updated in the prior commits, so
[skip-docs] applies here.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

README.md

@@ -73,7 +73,7 @@ Key commands: `/config-audit posture`, `/config-audit feature-gap`, `/config-aud
 
 ---
 
-### [Ultra {brief | research | plan | execute | review | continue} - local](plugins/ultraplan-local/) `v3.4.0`
+### [Ultra {brief | research | plan | execute | review | continue} - local](plugins/ultraplan-local/) `v3.4.1`
 
 Deep requirements gathering, research, implementation planning, self-verifying execution, independent post-hoc review, and zero-friction multi-session resumption with specialized agent swarms, adversarial review, and failure recovery. Six-command (brief, research, plan, execute, review, continue) universal pipeline.
 

plugins/ultraplan-local/CHANGELOG.md

@@ -4,6 +4,86 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [3.4.1] - 2026-05-04 — `/ultracontinue-local` hot-fix + ultra-cc-architect doc-rydding
+
+Forward-patch on top of v3.4.0. Fixes four bugs in the multi-session
+resumption path discovered post-3.3.0 ship, plus a doc-rydding sweep
+that generalizes references to the `ultra-cc-architect` plugin (no
+longer publicly distributed). Non-breaking: the `architecture/overview.md`
+filesystem contract (Handover 3) is preserved for any compatible
+producer.
+
+### Fixed
+
+- **Bug 1 — `/ultracontinue-local` Phase 0 + auto-discovery.**
+  `commands/ultracontinue-local.md` no longer prints a usage block on
+  bare invocation; it enters auto-discovery (sorts active state files
+  numerically by `Date.parse(updated_at)`, not lexicographically — fixes
+  cross-timezone wrong-order). `--help` / `-h` is the only flag that
+  surfaces the usage block. (Steps 1–3)
+- **Bug 2 — Phase 2 placeholder leakage.** `{state-file-path}`,
+  `{project-dir}`, `{path-a}` and similar template tokens are gone from
+  `commands/ultracontinue-local.md` Phase 2 prose. The command now reads
+  the resolved path inline rather than asking the model to substitute.
+  (Steps 4–5)
+- **Bug 3 — frontmatter consistency for `NEXT-SESSION-PROMPT.local.md`.**
+  Producers (`/ultraexecute-local` Phase 8, `/ultraplan-end-session-local`)
+  now write `produced_by:` + `produced_at:` (ISO-8601) frontmatter on the
+  prompt file. `/ultracontinue-local` Phase 1.5 cross-checks `produced_at`
+  against the sibling state file's `updated_at` and refuses to proceed on
+  inconsistency (`NEXT_SESSION_PROMPT_INCONSISTENT`). Files without
+  frontmatter remain tolerated (warning, not error) for backwards
+  compatibility. State-anchored staleness check is the primary signal;
+  24h wall-clock is a soft warning only. (Steps 6–8)
+- **Bug 4 — `--cleanup` for completed projects.** `/ultracontinue-local
+  --cleanup <project-dir>` (dry-run by default) and
+  `/ultracontinue-local --cleanup --confirm <project-dir>` (deletes the
+  state file + sibling prompt file). Refuses non-completed status with
+  no force flag. Idempotent — safe to re-run after partial cleanup.
+  (Steps 9–10)
+- **ESM/CJS regression in `commands/ultraplan-end-session-local.md`.**
+  Phase 3 now invokes `atomicWriteJson` via `node --input-type=module`
+  rather than the broken `require()` call. State writes from the helper
+  command are no longer silently lost on Node 18+. (Collateral in Step 7)
+- **`plugin.json` description drift.** "Five-command" → "Six-command";
+  trailing `ultra-cc-architect` sentence removed. (Step 13)
+
+### Added
+
+- `lib/util/cleanup.mjs` — refuse-unless-completed gate + dry-run +
+  confirm-aware deleter for state file and sibling prompt file.
+- `lib/validators/next-session-prompt-validator.mjs` — frontmatter
+  validator + state-anchored staleness check + CLI shim.
+- `tests/commands/ultracontinue.test.mjs` — new test directory; covers
+  SC-1 (auto-discovery sort + usage block), SC-2 (.md diagnostic),
+  SC-3 (path-guard ALLOW + no placeholder), SC-4 (consistency), SC-5
+  (cleanup wiring).
+- `tests/validators/next-session-prompt-validator.test.mjs` — unit
+  coverage for frontmatter consistency: matching, mismatch, wall-clock,
+  no-frontmatter, missing-field.
+- `tests/lib/cleanup.test.mjs` — cleanup util tests.
+- `--cleanup` + `--confirm` flags on `/ultracontinue-local`.
+
+### Changed
+
+- `docs/HANDOVER-CONTRACTS.md` Handover 7 gains a § Lifecycle subsection
+  documenting producer/consumer arbeidsdeling, the stale-file principle
+  (operator-invoked `--cleanup`, no auto-cleanup, no force flag), the
+  `produced_by:` + `produced_at:` frontmatter contract, and idempotency.
+- `CLAUDE.md`, `README.md`, `SECURITY.md` — generalize references to
+  `ultra-cc-architect` plugin to "opt-in upstream architect plugin (not
+  bundled)". `CHANGELOG.md` historical references are preserved with a
+  2026-05-04 banner stating the plugin is no longer publicly distributed.
+
+### Tests
+
+- 322 (v3.3.0 baseline) → 358 (post-Wave 4) → 361 (Step 11 doc-pins) →
+  ~363 at release. New tests: arg-parser FLAG_SCHEMA extensions,
+  ultracontinue auto-discovery + diagnostic + path-guard +
+  consistency + cleanup wiring, next-session-prompt-validator
+  frontmatter checks, cleanup util, and 3 new doc-consistency pins
+  for Handover 7 § Lifecycle + next-session-prompt-validator CLI shim.
+
 ## [3.4.0] - 2026-05-04 — Ultra-pipeline speedup
 
 Hardenings + scaffolding to support an autonomy chain from brief approval

plugins/ultraplan-local/README.md

@@ -1,6 +1,6 @@
 # ultraplan-local — Brief, Research, Plan, Execute, Review, Continue
 
-![Version](https://img.shields.io/badge/version-3.4.0-blue)
+![Version](https://img.shields.io/badge/version-3.4.1-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
 ![Platform](https://img.shields.io/badge/platform-Claude%20Code-purple)