37 lines
1.8 KiB
Markdown
37 lines
1.8 KiB
Markdown
# Migration
|
|
|
|
v3.x → v4.0.0 is a rebrand. All command names changed:
|
|
`/ultrabrief-local` → `/trekbrief`, `/ultraresearch-local` → `/trekresearch`,
|
|
`/ultraplan-local` → `/trekplan`, `/ultraexecute-local` → `/trekexecute`,
|
|
`/ultrareview-local` → `/trekreview`, `/ultracontinue-local` → `/trekcontinue`,
|
|
`/ultraplan-end-session-local` → `/trekendsession`. The plugin is now
|
|
named `voyage`. Re-fork from main if upgrading. There is no migration
|
|
path — see [`GOVERNANCE.md`](https://git.fromaitochitta.com/open/ktg-plugin-marketplace/src/branch/main/GOVERNANCE.md) for the fork-and-own model.
|
|
|
|
Prior version migration notes (v1→v2, v2→v3) are preserved in
|
|
`CHANGELOG.md` only.
|
|
|
|
## review_version 1.2 (from the next release)
|
|
|
|
`review.md` moves from `review_version: "1.1"` to `"1.2"`. Everything new is
|
|
optional, and each field or section is checked for its shape only when it is
|
|
present:
|
|
|
|
- frontmatter `round`, `round_base`, `review_policy`, `review_policy_note`,
|
|
`review_policy_sha256` and `finalized`;
|
|
- in the trailing JSON block, per finding `pre_existing`, `carried_from` and
|
|
`instruction_ref`, and at the top level `pre_existing_counts`, `resolved`
|
|
and `ran`;
|
|
- the sections `## Answers` (the operator's answer to each counting MAJOR),
|
|
`## Pre-existing` and `## Resolved since round <n>`;
|
|
- three `## Declined to Judge` reasons: `policy:skip`, `policy:cap` and
|
|
`instruction-out-of-set`.
|
|
|
|
N-1 window: a 1.1 review validates unchanged for one minor version, and only
|
|
with a warning after that. No reader fails on a 1.1 review: the validator,
|
|
`/trekplan` and the verdict gate all read it.
|
|
|
|
Gate change: a WARN opens the merge only when the verdict gate finds every
|
|
counting MAJOR answered. That holds for a 1.1 review too, so a 1.1 WARN with a
|
|
MAJOR keeps the merge lock closed until the MAJOR is answered; a 1.1 WARN
|
|
without a MAJOR is read as before.
|