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>
This commit is contained in:
Kjell Tore Guttormsen 2026-05-04 17:55:51 +02:00
commit 4fd98988e2
3 changed files with 82 additions and 2 deletions

View file

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

View file

@ -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 13)
- **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 45)
- **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 68)
- **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 910)
- **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

View file

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