@ngockhoale/ukit 3.4.74 → 3.4.76
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +110 -95
- package/manifests/platform.full.yaml +15 -0
- package/package.json +14 -4
- package/src/cli/commands/markerStore.js +15 -0
- package/src/cli/index.js +7 -0
- package/src/core/markerStoreMigration.js +122 -0
- package/template_project/.claude/hooks/completion-gate.sh +10 -1
- package/template_project/.claude/hooks/handoff-resume.sh +9 -0
- package/template_project/.claude/hooks/owner-stop-gate.mjs +41 -0
- package/template_project/.claude/hooks/skill-router.sh +262 -28
- package/template_project/.claude/settings.json +11 -1
- package/template_project/.claude/ukit/index/publication-intent.mjs +144 -18
- package/template_project/.claude/ukit/index/route-task.mjs +91 -9
- package/template_project/.claude/ukit/runtime/cron-operation-adapter.mjs +11 -4
- package/template_project/.claude/ukit/runtime/execution-ledger.mjs +369 -29
- package/template_project/.claude/ukit/runtime/operation-evidence.mjs +9 -0
- package/template_project/.claude/ukit/runtime/resumable-run.mjs +33 -11
- package/template_project/.claude/ukit/runtime/stop-coordinator.mjs +161 -32
- package/template_project/.omp/hooks/pre/ukit-bridge.js +552 -4
- package/scripts/bug/triage.mjs +0 -76
- package/scripts/dev/worktree-preflight.mjs +0 -166
- package/scripts/docs/render-instructions.mjs +0 -66
- package/scripts/index/build-index.mjs +0 -102
- package/scripts/index/query-index.mjs +0 -128
- package/scripts/index/refresh-index.mjs +0 -195
- package/scripts/install/sync-installed-mirror.mjs +0 -263
- package/scripts/measure-decision-gateway.mjs +0 -306
- package/scripts/probe/codex-capability-probe.mjs +0 -169
- package/scripts/skill/audit-skill.mjs +0 -68
- package/scripts/test/run-handoff-isolated.mjs +0 -178
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,21 @@
|
|
|
2
2
|
|
|
3
3
|
All notable changes to UKit are documented here.
|
|
4
4
|
|
|
5
|
+
## 3.4.76 - 2026-11-03
|
|
6
|
+
|
|
7
|
+
**P0 follow-up: UNKNOWN-stop marker store, explicit STOP publication and negation-aware state classification. Isolated process/replay evidence only; not live-host certification.**
|
|
8
|
+
|
|
9
|
+
- `ukit marker-store migrate`: plan by default; `--apply --writers-stopped` refuses unless the owner attests every OMP/bridge session is closed, no process uses the project, no writer temp file exists and the store is unchanged across an observation window. It never kills processes, keeps releases byte-for-byte, turns blocks into sticky releases under the same hashed names, quarantines (never deletes) the old store, and resumes after interruption.
|
|
10
|
+
- Bridge: a fenced or unavailable store fails open (`degraded:storage`) without crash or repeated calls; release-only saturation keeps every release.
|
|
11
|
+
- Explicit owner STOP survives pending route publication and never expires by TTL.
|
|
12
|
+
- Classifier: a negated verb ("do not stop the job") no longer mints a state-verification debt; `khong sua ledger/gate/receipts` stays READ_ONLY.
|
|
13
|
+
- Consumers: close related OMP/bridge sessions, `ukit update`, `ukit marker-store migrate`, then `--apply --writers-stopped`, verify, reopen. STOP stays in effect; legacy cursors are adopted only via explicit `--adopt-legacy-run`.
|
|
14
|
+
- Artifact budget: packed < 3,500,000 and unpacked < 11,300,000 bytes (limits unchanged). To stay under the unpacked limit, about 92 verbose bullets in historical entries (mostly older than 2.7) were shortened in this file, saving about 22 KB; no release was removed, and the full original text is in git history at 46b48d11.
|
|
15
|
+
|
|
16
|
+
## 3.4.75 - 2026-11-01
|
|
17
|
+
|
|
18
|
+
- Publish receipts bind to artifact integrity.
|
|
19
|
+
|
|
5
20
|
## 3.4.74 - 2026-10-30
|
|
6
21
|
|
|
7
22
|
**Route publication protocol, handoff ownership authority and explicit legacy adoption; no live-host certification beyond the isolated native OMP A/B/C acceptance recorded in `docs/STATUS.md`.**
|
|
@@ -2034,7 +2049,7 @@ pulls from npm, so an install on 2.3.19 (or older) needs an update to receive th
|
|
|
2034
2049
|
|
|
2035
2050
|
C14 bug-fix release record — one correctness fix is shipped; this release adds no new features.
|
|
2036
2051
|
|
|
2037
|
-
- **Completion gate no longer silently releases a reentrant stop.** `templates/.claude/ukit/runtime/execution-ledger.mjs` (`--evaluate-stop`) had a `stop_hook_active` valve:
|
|
2052
|
+
- **Completion gate no longer silently releases a reentrant stop.** `templates/.claude/ukit/runtime/execution-ledger.mjs` (`--evaluate-stop`) had a `stop_hook_active` valve:
|
|
2038
2053
|
|
|
2039
2054
|
## 2.3.18 - 2026-09-12
|
|
2040
2055
|
|
|
@@ -3064,7 +3079,7 @@ Follow-up to the user's report that UKit had become too heavy-handed: too many h
|
|
|
3064
3079
|
### Changed
|
|
3065
3080
|
|
|
3066
3081
|
- **`PreToolUse:Bash` now runs 4 hook scripts instead of 6.** `verification-guard.sh` was removed from the default Bash chain (both `.claude/settings.json` copies, the omp bridge's `HOOK_EVENT_MAP`/`FAIL_CLOSED_SCRIPTS`, and `hook-chain-runner.mjs`'s own classification). Its hard-block path is gated behind `UKIT_VERIFICATION_GUARD_ENFORCE=1`, unset by default, so it was pure per-call overhead (a full `node` spawn) for zero present safety value. The script and its standalone tests are untouched — still shippable, opt-in.
|
|
3067
|
-
- **`PreToolUse:Read|Grep|Glob` no longer runs `skill-router.sh`.** Automatic skill activation still runs on `UserPromptSubmit` and `Edit|Write`, where a skill choice actually matters;
|
|
3082
|
+
- **`PreToolUse:Read|Grep|Glob` no longer runs `skill-router.sh`.** Automatic skill activation still runs on `UserPromptSubmit` and `Edit|Write`, where a skill choice actually matters;
|
|
3068
3083
|
|
|
3069
3084
|
### Fixed
|
|
3070
3085
|
|
|
@@ -3082,7 +3097,7 @@ Follow-up to 2.2.3's hook-chain collapse: a real omp session on a CloudMounter/F
|
|
|
3082
3097
|
### Fixed
|
|
3083
3098
|
|
|
3084
3099
|
- **Outer transport failures no longer impersonate a specific safety gate.** `runScriptChain` in `ukit-bridge.js` treated a killed/timed-out `pi.exec`, empty stdout, or malformed JSON from `hook-chain-runner.mjs` as proof that the chain's first fail-closed script (e.g. `protect-files.sh`) had failed — without verifying that script ever ran. It now distinguishes "the runner returned a verifiable per-script result" from "the runner itself failed before producing one," and on the latter reports the real failure (killed/code/elapsedMs/runtime) instead of a fabricated gate name. Diagnostics are appended to `.ukit/storage/cache/hook-errors/<session>.jsonl`.
|
|
3085
|
-
- **Bash and Read/Grep/Glob no longer fail closed on a bridge/runner outage.** Only `Edit`/`Write` chains still block when the runner can't produce a verdict, since those guard file mutation.
|
|
3100
|
+
- **Bash and Read/Grep/Glob no longer fail closed on a bridge/runner outage.** Only `Edit`/`Write` chains still block when the runner can't produce a verdict, since those guard file mutation.
|
|
3086
3101
|
- **`process.execPath` is no longer trusted blindly for the runner subprocess.** The bridge resolves `process.env.UKIT_NODE_PATH || process.execPath` and records the resolved runtime in the failure diagnostic, so a Bun-hosted omp launching the Node-only runner under the wrong binary is now visible instead of silently assumed.
|
|
3087
3102
|
|
|
3088
3103
|
### Added
|
|
@@ -3095,17 +3110,17 @@ Sessions were stalling mid-task — the model would read source, then simply sto
|
|
|
3095
3110
|
|
|
3096
3111
|
### Fixed
|
|
3097
3112
|
|
|
3098
|
-
- **Silent stalls were unenforceable, because nothing measured them.** A stop after a read-only pass was indistinguishable from a stop after finished work:
|
|
3113
|
+
- **Silent stalls were unenforceable, because nothing measured them.** A stop after a read-only pass was indistinguishable from a stop after finished work:
|
|
3099
3114
|
- **The omp bridge could exceed omp's own handler budget and freeze the session.** A single `Edit` fired 7 hook scripts as 7 serial `pi.exec` subprocesses at up to 8s each — worst case well past omp's ~30s outer timeout, which surfaces to the user as the session simply hanging. They now run in one bounded `hook-chain-runner.mjs` process: 4s per script, 10s total budget, under a 12s outer timeout. Per-event latency is appended to `.ukit/storage/cache/hook-latency/<session>.jsonl` so hook cost stops being invisible.
|
|
3100
|
-
- **omp writes bypassed the safety gates entirely.** omp's `normalizeToolEventInput` emits `path` / `paths`;
|
|
3115
|
+
- **omp writes bypassed the safety gates entirely.** omp's `normalizeToolEventInput` emits `path` / `paths`;
|
|
3101
3116
|
- **An unmapped mutation-capable tool failed open and silently.** `mapToolName` returned `null` for any tool not in its table, and the bridge ran an empty script chain — so a host tool that writes files but is not yet mapped skipped every guard with no signal. Such tools are now blocked with a message naming the tool; unmapped read-only tools still pass through.
|
|
3102
|
-
- **The ledger CLI silently did nothing under a symlinked project root.** Its main-guard compared `fileURLToPath(import.meta.url)` against `path.resolve(process.argv[1])`.
|
|
3103
|
-
- **`.omp/config.yml` documented the model aliases backwards**, calling the UNIC names "LITERAL model names, not aliases".
|
|
3117
|
+
- **The ledger CLI silently did nothing under a symlinked project root.** Its main-guard compared `fileURLToPath(import.meta.url)` against `path.resolve(process.argv[1])`.
|
|
3118
|
+
- **`.omp/config.yml` documented the model aliases backwards**, calling the UNIC names "LITERAL model names, not aliases".
|
|
3104
3119
|
|
|
3105
3120
|
### Added
|
|
3106
3121
|
|
|
3107
|
-
- **`tests/hooks/executionLedgerCli.test.js`** (4 tests) — drives the real CLI through a symlinked root:
|
|
3108
|
-
- **Manifest entries and dev-mirror parity for the four new files** — `record-execution.sh`, `completion-gate.sh`, `execution-ledger.mjs`, `hook-chain-runner.mjs`.
|
|
3122
|
+
- **`tests/hooks/executionLedgerCli.test.js`** (4 tests) — drives the real CLI through a symlinked root:
|
|
3123
|
+
- **Manifest entries and dev-mirror parity for the four new files** — `record-execution.sh`, `completion-gate.sh`, `execution-ledger.mjs`, `hook-chain-runner.mjs`.
|
|
3109
3124
|
|
|
3110
3125
|
## 2.2.2 - 2026-08-22
|
|
3111
3126
|
|
|
@@ -3115,20 +3130,20 @@ It also settles the three `TODO(verify)` items 2.2.1 shipped with. Those were pl
|
|
|
3115
3130
|
|
|
3116
3131
|
### Fixed
|
|
3117
3132
|
|
|
3118
|
-
- **Auto-compact was never actually configured on omp.** `.omp/config.yml` set `compact.autoCompactWindow:
|
|
3119
|
-
- **Post-compact hooks never ran on omp.** The bridge assumed omp re-emitted `session_start` after a compaction, the way Claude Code's matcher-less `SessionStart` hook fires with `source:
|
|
3120
|
-
- **Two UNIC gateway probes could never have fired.** `unic-gateway.mjs` probed an `OMP_BASE_URL` env var and a `baseUrl` key in `.omp/config.yml`.
|
|
3133
|
+
- **Auto-compact was never actually configured on omp.** `.omp/config.yml` set `compact.autoCompactWindow:
|
|
3134
|
+
- **Post-compact hooks never ran on omp.** The bridge assumed omp re-emitted `session_start` after a compaction, the way Claude Code's matcher-less `SessionStart` hook fires with `source:
|
|
3135
|
+
- **Two UNIC gateway probes could never have fired.** `unic-gateway.mjs` probed an `OMP_BASE_URL` env var and a `baseUrl` key in `.omp/config.yml`.
|
|
3121
3136
|
- **omp behaved as if UKit only had one model, because it was never told otherwise.** `templates/AGENTS.md` — the context doc omp, Codex and OpenCode read — was missing the entire `3-Tier Model Routing` block, plus `Post-Edit Sidecar Review` and `Skill Quality`, and still announced itself as `UKit v1.5.1`. `.omp/config.yml` declared `modelRoles` for all four lanes, but nothing in omp's context ever said *when* to use a tier, so everything ran inline on the session model.
|
|
3122
3137
|
- **Five section pairs had been renamed apart** — `Core Rule`/`Core UKit Rule`, `Fast Classification`/`Fast Task Classification`, `Internal Helper Policy`/`Internal Helper Routing`, `Selective Subagent Policy`/`Subagent Policy`, `Project Snapshot`/`Environment Snapshot`. This is what let the drift hide: once the headings differ, no diff lines up and the gap is invisible. Headings are now shared, and the two docs carry byte-identical bodies for every shared section.
|
|
3123
|
-
- **Every session opened by being told to resume a finished cycle.** `docs/AI_HANDOFF/RUN.md` was left at `Phase:
|
|
3124
|
-
- **`/ukit:*` commands re-pasted the user's whole problem statement up to seven times per file.** Only one `$ARGUMENTS` site per command is a real interpolation (the `## Problem / feature` body);
|
|
3125
|
-
- **Eight fallback lines told the model to do something only a human can do.** `> Other tools without subagent support:
|
|
3138
|
+
- **Every session opened by being told to resume a finished cycle.** `docs/AI_HANDOFF/RUN.md` was left at `Phase:
|
|
3139
|
+
- **`/ukit:*` commands re-pasted the user's whole problem statement up to seven times per file.** Only one `$ARGUMENTS` site per command is a real interpolation (the `## Problem / feature` body);
|
|
3140
|
+
- **Eight fallback lines told the model to do something only a human can do.** `> Other tools without subagent support:
|
|
3126
3141
|
|
|
3127
3142
|
### Added
|
|
3128
3143
|
|
|
3129
|
-
- **`### How a tier is actually bound`** in both context docs. The main session model never changes mid-turn;
|
|
3144
|
+
- **`### How a tier is actually bound`** in both context docs. The main session model never changes mid-turn;
|
|
3130
3145
|
- **`tests/consistency/contextDocsParity.test.js`** (29 tests) — every `## ` section must exist in both `templates/CLAUDE.md` and `templates/AGENTS.md` with byte-identical bodies, unless allowlisted with a stated reason (currently one entry: `Session Start — OpenCode`, which exists because OpenCode does not auto-load `.claude/skills/`). Also asserts neither doc hardcodes a version, and that both manifest items declare the same variable set.
|
|
3131
|
-
- **`.omp/RULES.md` grew from 4 rules to 7**, targeting direct chat specifically — direct chat is steered only by static context, so what is missing there is simply never applied.
|
|
3146
|
+
- **`.omp/RULES.md` grew from 4 rules to 7**, targeting direct chat specifically — direct chat is steered only by static context, so what is missing there is simply never applied.
|
|
3132
3147
|
- **The three `/ukit:*` sites that named only Claude Code now name omp too** — `handoff-fullstack.md`'s Model Split note, and the small-task-maintainer lines in `handoff-clear.md` and `handoff-status.md`.
|
|
3133
3148
|
|
|
3134
3149
|
### Changed
|
|
@@ -3142,27 +3157,27 @@ UKit gains a fourth runtime and loses one. omp (Oh My Pi) reaches full parity wi
|
|
|
3142
3157
|
|
|
3143
3158
|
### Added
|
|
3144
3159
|
|
|
3145
|
-
- **omp (Oh My Pi) adapter — `ukit install --tools=omp`** (alias `--tools=oh-my-pi`).
|
|
3146
|
-
- **All six shared agents ported to omp's task-agent contract**: `bug-debugger`, `code-reviewer`, `feature-implementer`, `handoff-planner`, `ukit-small-task-maintainer`, `ukit-vision-analyst`.
|
|
3147
|
-
- **UNIC model names survive the port.** `.omp/config.yml` ships `modelRoles` with all four lanes intact:
|
|
3160
|
+
- **omp (Oh My Pi) adapter — `ukit install --tools=omp`** (alias `--tools=oh-my-pi`).
|
|
3161
|
+
- **All six shared agents ported to omp's task-agent contract**: `bug-debugger`, `code-reviewer`, `feature-implementer`, `handoff-planner`, `ukit-small-task-maintainer`, `ukit-vision-analyst`.
|
|
3162
|
+
- **UNIC model names survive the port.** `.omp/config.yml` ships `modelRoles` with all four lanes intact:
|
|
3148
3163
|
- **Hook bridge — one source of truth, two runtimes.** `.omp/hooks/pre/ukit-bridge.js` is an omp hook factory (`export default function hook(pi)`) that translates omp's events into the Claude Code hook JSON shape and then executes the **existing** `.claude/hooks/*.sh` scripts. The 20 shell hooks are not duplicated, forked, or rewritten for omp; a fix to one fixes both runtimes.
|
|
3149
|
-
- **Auto-compact parity.** `compact.agentContext.targets` gains an `omp` entry using `mode:
|
|
3150
|
-
- **`agent-code-reviewer` manifest item.** `templates/.claude/agents/code-reviewer.md` had shipped as a template with no manifest item since it was introduced, and `autoDiscoverTemplates:
|
|
3164
|
+
- **Auto-compact parity.** `compact.agentContext.targets` gains an `omp` entry using `mode:
|
|
3165
|
+
- **`agent-code-reviewer` manifest item.** `templates/.claude/agents/code-reviewer.md` had shipped as a template with no manifest item since it was introduced, and `autoDiscoverTemplates:
|
|
3151
3166
|
|
|
3152
3167
|
### Changed
|
|
3153
3168
|
|
|
3154
|
-
- **`/ukit:*` commands are phrased for whichever runtime is reading them.** The command bodies no longer assume Claude Code's spawn mechanics;
|
|
3169
|
+
- **`/ukit:*` commands are phrased for whichever runtime is reading them.** The command bodies no longer assume Claude Code's spawn mechanics;
|
|
3155
3170
|
- **`ukit status` reports `Oh My Pi (omp)`** and checks `.omp/config.yml`; the Antigravity row is gone.
|
|
3156
3171
|
- **`.omp/` is TCC-protected** (`applyPlan.js`) and **git-ignored** by the managed `.gitignore` block, alongside `.claude/` and `.codex/`.
|
|
3157
3172
|
|
|
3158
3173
|
### Removed
|
|
3159
3174
|
|
|
3160
3175
|
- **The Antigravity adapter.** `templates/.antigravity/`, `templates/adapter-presets/antigravity/`, the five `multi-antigravity-*` manifest items, its entry in `src/cli/adapters.js`, and every user-facing mention — in `README.md`, `QUICK_START.md`, `docs/PROJECT.md`, and in the installed workspace itself: `AGENTS.md`, `.codex/README.md` and the four `/ukit:handoff-*` command files all named Antigravity as a tool you could use. `--tools=antigravity` now fails fast with `Antigravity has been removed as a UKit adapter.` plus the list of adapters that do exist, rather than silently installing nothing.
|
|
3161
|
-
- **Legacy cleanup is retained, not removed.** `ukit uninstall` still cleans `.antigravity/`, and `.antigravity/` keeps its TCC protection, because a stale pre-2.2.0 install still has the directory.
|
|
3176
|
+
- **Legacy cleanup is retained, not removed.** `ukit uninstall` still cleans `.antigravity/`, and `.antigravity/` keeps its TCC protection, because a stale pre-2.2.0 install still has the directory.
|
|
3162
3177
|
|
|
3163
3178
|
### Fixed
|
|
3164
3179
|
|
|
3165
|
-
- **Deselecting omp no longer orphans its agents.** `OPTIONAL_ADAPTERS`' `managedPaths` listed `.omp/agents` as a single entry, copying the shape of Codex's `.codex/agents`.
|
|
3180
|
+
- **Deselecting omp no longer orphans its agents.** `OPTIONAL_ADAPTERS`' `managedPaths` listed `.omp/agents` as a single entry, copying the shape of Codex's `.codex/agents`.
|
|
3166
3181
|
- **The `--tools=antigravity` regression test was passing vacuously.** It asserted on a directory the install pipeline had never been pointed at, so the "no partial write" half would have held even if the error path did write. It now runs the real `bin/ukit`, and checks the exit code, the stderr text, the absence of a stack frame, and that not even the always-on `.claude/` adapter was written.
|
|
3167
3182
|
|
|
3168
3183
|
**Known gap:** omp was not installed on the machine this release was built on. Every omp assertion in the test suite is against the generated `.omp/` tree and the bridge module's shape — the packed-tarball test confirms `templates/.omp/**` actually publishes, but nothing here observes omp's runtime behaviour. The three open verification items (does omp emit `session_start` on a post-compact continuation; omp's real base-URL key; omp's real auto-compact-window key) are recorded in `docs/AI_HANDOFF/tasks/TASK-008.md`.
|
|
@@ -3173,7 +3188,7 @@ UKit gains a fourth runtime and loses one. omp (Oh My Pi) reaches full parity wi
|
|
|
3173
3188
|
|
|
3174
3189
|
### Changed
|
|
3175
3190
|
|
|
3176
|
-
- **`local-build` now requires verification evidence, not just write evidence, before claiming done.** `orchestration.contracts['local-build'].completionRule` was `require-write`;
|
|
3191
|
+
- **`local-build` now requires verification evidence, not just write evidence, before claiming done.** `orchestration.contracts['local-build'].completionRule` was `require-write`;
|
|
3177
3192
|
|
|
3178
3193
|
### Added
|
|
3179
3194
|
|
|
@@ -3196,8 +3211,8 @@ More room before compaction, the handoff hooks stop taxing every call they were
|
|
|
3196
3211
|
|
|
3197
3212
|
### Added
|
|
3198
3213
|
|
|
3199
|
-
- **`.claude/ukit/index/provision-worktree.mjs`** — deterministic worktree provisioning for handoff waves, packaged via `manifests/platform.full.yaml`.
|
|
3200
|
-
- **Test-selection policy in `docs/AI_HANDOFF/RULES.md`** — per-task related tests are the floor, and a full suite at the wave/cycle boundary is mandatory, not optional.
|
|
3214
|
+
- **`.claude/ukit/index/provision-worktree.mjs`** — deterministic worktree provisioning for handoff waves, packaged via `manifests/platform.full.yaml`.
|
|
3215
|
+
- **Test-selection policy in `docs/AI_HANDOFF/RULES.md`** — per-task related tests are the floor, and a full suite at the wave/cycle boundary is mandatory, not optional.
|
|
3201
3216
|
- **`scripts/bench/parallel-agents.mjs`** — harness for measuring concurrent test-process contention at several parallelism levels, recording `slowdownFactor` / `perRunCost` / a `recommended` value plus the load averages the run happened under. It measures test-process contention, not LLM agents.
|
|
3202
3217
|
- **`handoff.maxParallelAgents`: 10 → 12.** Chosen, not measured — the benchmark above was never run on a quiet enough machine, so this is the middle of the ~10-15 safe band the config's own `_help` has always documented. Lower it to 3-5 if your tasks produce long verification output or you see compaction firing repeatedly.
|
|
3203
3218
|
|
|
@@ -3229,12 +3244,12 @@ Follow-up to 2.1.0, which fixed the wrong hook. Runs were still freezing mid-tas
|
|
|
3229
3244
|
|
|
3230
3245
|
### Added
|
|
3231
3246
|
|
|
3232
|
-
- **`compact.hardCapGraceCalls`** (default `10`). Budget is per over-cap episode, not per wave:
|
|
3233
|
-
- **`tests/hooks/contextHardcapGate.test.js`** — 12 cases covering under-cap pass-through, blocking with no run in flight, `Phase:
|
|
3247
|
+
- **`compact.hardCapGraceCalls`** (default `10`). Budget is per over-cap episode, not per wave:
|
|
3248
|
+
- **`tests/hooks/contextHardcapGate.test.js`** — 12 cases covering under-cap pass-through, blocking with no run in flight, `Phase:
|
|
3234
3249
|
|
|
3235
3250
|
### Notes
|
|
3236
3251
|
|
|
3237
|
-
- **No hook can call `/compact`** — it is a client-only command, so UKit cannot auto-compact on your behalf.
|
|
3252
|
+
- **No hook can call `/compact`** — it is a client-only command, so UKit cannot auto-compact on your behalf.
|
|
3238
3253
|
|
|
3239
3254
|
## 2.1.0 - 2026-08-16
|
|
3240
3255
|
|
|
@@ -3243,39 +3258,39 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3243
3258
|
### Added
|
|
3244
3259
|
|
|
3245
3260
|
- **Autonomy Contract in all four handoff commands.** `handoff-create` owns the single question window — one batched `AskUserQuestion` (max 4, recommended option first) before planning starts, covering scope, conflicting interpretations, subsystem choice and acceptance criteria only. `handoff-fullstack`, `handoff-implement` and `handoff-review` ask nothing between that window and the Final Report; each command carries a table mapping every former STOP to its required automatic behavior.
|
|
3246
|
-
- **Run cursor + resume protocol (`docs/AI_HANDOFF/RUN.md`).** Every phase transition writes `Phase`/`Cursor`/`Next`.
|
|
3261
|
+
- **Run cursor + resume protocol (`docs/AI_HANDOFF/RUN.md`).** Every phase transition writes `Phase`/`Cursor`/`Next`.
|
|
3247
3262
|
- **`handoff-resume.sh` SessionStart hook** (manifest id `hook-handoff-resume`). Reads the run cursor and prints a resume banner with Goal/Base/Phase/Cursor/Next, plus two extra lines when the session started from `source: compact`. Advisory only, always exits 0, silent when there is no unfinished run.
|
|
3248
|
-
- **Auto-fix loop after review (max 2 rounds).** Non-approved tasks are re-waved and re-implemented in parallel — agents read their own `## Reviewer Verdict` from disk — then committed and re-reviewed.
|
|
3263
|
+
- **Auto-fix loop after review (max 2 rounds).** Non-approved tasks are re-waved and re-implemented in parallel — agents read their own `## Reviewer Verdict` from disk — then committed and re-reviewed.
|
|
3249
3264
|
- **Planner Grounding + 12-point Self-Audit.** `handoff-planner` must verify that every Target File exists (or is marked `(new)`), that every Verification Command is a real `package.json` script, and that test file paths match the neighbouring test layout; then run a 12-point self-audit (coverage / correctness / test quality, including "could every listed test pass against an empty implementation?") and report the result. Compensates for dropping plan review from 3 rounds to 2.
|
|
3250
|
-
- **Wave-boundary commit + context checkpoint.** Each wave ends with `git add -A && git commit -m "handoff:
|
|
3265
|
+
- **Wave-boundary commit + context checkpoint.** Each wave ends with `git add -A && git commit -m "handoff:
|
|
3251
3266
|
|
|
3252
3267
|
### Changed
|
|
3253
3268
|
|
|
3254
|
-
- **`git push` moved from the `ask` list to `allow`** in default settings, alongside `git add`, `git commit` and `git worktree`.
|
|
3255
|
-
- **Subagent return contracts are now capped.** Executors return ≤10 lines (`TASK`/`STATUS`/`EXECUTOR_MODEL`/`FILES`/`RED`/`VERIFY`/`NOTE`), reviewers ≤6.
|
|
3256
|
-
- **`context-window-guard.sh` is now run-cursor aware.** With an unfinished run it emits shed-context-and-continue instructions instead of the stop-and-`/compact` directive.
|
|
3257
|
-
- **Same-wave file conflicts auto-serialize** instead of marking both tasks `needs_breakdown`:
|
|
3269
|
+
- **`git push` moved from the `ask` list to `allow`** in default settings, alongside `git add`, `git commit` and `git worktree`.
|
|
3270
|
+
- **Subagent return contracts are now capped.** Executors return ≤10 lines (`TASK`/`STATUS`/`EXECUTOR_MODEL`/`FILES`/`RED`/`VERIFY`/`NOTE`), reviewers ≤6.
|
|
3271
|
+
- **`context-window-guard.sh` is now run-cursor aware.** With an unfinished run it emits shed-context-and-continue instructions instead of the stop-and-`/compact` directive.
|
|
3272
|
+
- **Same-wave file conflicts auto-serialize** instead of marking both tasks `needs_breakdown`:
|
|
3258
3273
|
- **A dirty working tree no longer blocks Phase 3.** It is committed as `handoff: checkpoint before implement` and the run continues.
|
|
3259
3274
|
- **Plan review loop cap: 3 rounds → 2**, then findings are applied and the run proceeds (logged as `### Round <N> — findings applied without re-review`). Config: `handoff.autonomy.planReviewRounds`.
|
|
3260
3275
|
- **Review diff range is now anchored to the plan commit** (`git log --grep='^handoff: plan' -n 1`) rather than the working tree, since waves are committed as they finish.
|
|
3261
3276
|
- **`handoff-planner` maximizes wave width.** `Dependencies: none` unless task B genuinely cannot be written without A's output — ordering preference, same code area and review order are explicitly not dependencies.
|
|
3262
|
-
- **`feature-implementer` and `code-reviewer` run unattended in handoff mode.** Ambiguity resolves through task file → PLAN.md → surrounding code → recommended choice, recorded in `## Discussion`;
|
|
3263
|
-
- **`handoff-model-guard.sh` gained a bash fast path** that skips the node spawn when the payload contains neither `AI_HANDOFF` nor `git push`.
|
|
3277
|
+
- **`feature-implementer` and `code-reviewer` run unattended in handoff mode.** Ambiguity resolves through task file → PLAN.md → surrounding code → recommended choice, recorded in `## Discussion`;
|
|
3278
|
+
- **`handoff-model-guard.sh` gained a bash fast path** that skips the node spawn when the payload contains neither `AI_HANDOFF` nor `git push`.
|
|
3264
3279
|
|
|
3265
3280
|
## 2.0.7 - 2026-08-15
|
|
3266
3281
|
|
|
3267
3282
|
### Added
|
|
3268
3283
|
|
|
3269
3284
|
- **`/ukit:handoff-create` and `/ukit:handoff-fullstack` gain a P2.5 independent plan review gate.** After the planner writes `PLAN.md` and before it's committed, a separate `code-reviewer` agent invocation (`REVIEW_TARGET_TYPE=plan`, fresh context — not the planner reviewing its own work) checks Completeness/Consistency/Clarity/Scope/YAGNI. `Issues Found` routes back to the planner to revise and resubmit; `Approved` unlocks the commit. Each round is logged to PLAN.md's new `## Plan Review Log` section, and the loop is capped at 3 `Issues Found` rounds — past that it escalates to the human instead of looping indefinitely.
|
|
3270
|
-
- **Same-wave file-conflict precheck in Phase 3.** Before spawning any implementation wave, `handoff-implement.md`/`handoff-fullstack.md` now compare `Target Files` across every task in that wave;
|
|
3285
|
+
- **Same-wave file-conflict precheck in Phase 3.** Before spawning any implementation wave, `handoff-implement.md`/`handoff-fullstack.md` now compare `Target Files` across every task in that wave;
|
|
3271
3286
|
- **TDD RED-state now requires real evidence.** The Executor Report template adds a mandatory `RED_OUTPUT` field — the actual failing-test output pasted before implementation, not a bare "confirmed" claim. `code-reviewer` checks this field during Test Plan adherence review and requests changes if it's missing or vague.
|
|
3272
|
-
- **`handoff.plan.requireLintOrTypecheckInVerification`** (default `true`): when the project has a lint/typecheck script, task Verification Commands must run it, not just tests;
|
|
3287
|
+
- **`handoff.plan.requireLintOrTypecheckInVerification`** (default `true`): when the project has a lint/typecheck script, task Verification Commands must run it, not just tests;
|
|
3273
3288
|
|
|
3274
3289
|
### Changed
|
|
3275
3290
|
|
|
3276
3291
|
- **`handoff.maxParallelAgents`**: 3 → 10, raising the default cap on concurrent background agents per wave (config comments still warn against exceeding ~10-15 — each agent's report gets injected back into the orchestrator's own context on completion).
|
|
3277
3292
|
- **Phase 4 (Review) is now parallelized**, batched by `maxParallelAgents` the same way Phase 3 (Implement) already was — reviewer agents only read a diff and append a verdict to their own task file, so parallel review carries none of Phase 3's shared-worktree conflict risk.
|
|
3278
|
-
- **`handoff.plan.minTestsEdgeCase`**: 1 → 2, and the two edge cases must now be of different kinds (e.g.
|
|
3293
|
+
- **`handoff.plan.minTestsEdgeCase`**: 1 → 2, and the two edge cases must now be of different kinds (e.g.
|
|
3279
3294
|
|
|
3280
3295
|
## 2.0.6 - 2026-08-12
|
|
3281
3296
|
|
|
@@ -3293,9 +3308,9 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3293
3308
|
|
|
3294
3309
|
### Added
|
|
3295
3310
|
|
|
3296
|
-
- **`context-window-guard.sh`** (UserPromptSubmit) — measures the session's real context by reading the transcript, and warns at 80% of `compact.hardCapTokens` / raises an ALERT at 100%.
|
|
3297
|
-
- **`handoff.maxParallelAgents`** (default `3`) — caps how many implementer agents a handoff wave spawns at once.
|
|
3298
|
-
- **`ukit update` now refreshes the current project**, replacing the `ukit update && ukit install` two-step.
|
|
3311
|
+
- **`context-window-guard.sh`** (UserPromptSubmit) — measures the session's real context by reading the transcript, and warns at 80% of `compact.hardCapTokens` / raises an ALERT at 100%.
|
|
3312
|
+
- **`handoff.maxParallelAgents`** (default `3`) — caps how many implementer agents a handoff wave spawns at once.
|
|
3313
|
+
- **`ukit update` now refreshes the current project**, replacing the `ukit update && ukit install` two-step.
|
|
3299
3314
|
|
|
3300
3315
|
### Changed
|
|
3301
3316
|
|
|
@@ -3307,30 +3322,30 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3307
3322
|
|
|
3308
3323
|
- **One pasted screenshot could brick `Edit`/`Write` for an entire session on every non-UNIC project.** The vision gate hard-blocks edits until a `ukit-vision-analyst` receipt exists, and it accepted a receipt only if the reported model matched a hardcoded, by-then-stale model ID. That acceptance path is unsatisfiable in practice: an honest agent reports the model it *actually* ran on, so the gate could never be cleared and the only escape was deleting a gitignored marker file by hand. The gate now stands down entirely when the session is off the UNIC gateway — where Claude reads images natively and there is nothing to enforce — and matches `unic-vision` by capability instead of by a pinned version string. Detection failure (`null`) still enforces, so breaking one gitignored file is not a bypass. `tests/handoff/cycle4/vision-gate.test.mjs` gains cases 21b/21c pinning "off-gateway + no receipt is allowed, never a deadlock" and "no fallback model needs to be configured"; the UNIC enforcement cases are untouched and still pass.
|
|
3309
3324
|
- **The v2.0.2 hard cap could not stop what it was built to stop.** `context-hardcap-gate.sh` is `PreToolUse`, but a context-window rejection happens when the request is *sent* — before any tool call exists to gate. `UserPromptSubmit` is the only event that runs early enough, hence the new guard above. Related: only three modules ever advance `estimatedTotalTokens`, and none of them observe `Read` results, images, or returned subagent reports, so the tracked figure drifts far below reality on exactly the sessions that overflow.
|
|
3310
|
-
- **UKit's index could not see what UKit ships — the root cause of three releases' worth of dead features.** Because `src`, `tests` and `manifests` all exist in this repo, `templates/` was never scanned:
|
|
3325
|
+
- **UKit's index could not see what UKit ships — the root cause of three releases' worth of dead features.** Because `src`, `tests` and `manifests` all exist in this repo, `templates/` was never scanned:
|
|
3311
3326
|
- `tests/index/scanScope.test.js` guards the class: code outside the old allowlist is indexed even when a listed directory exists, ignore rules define scope, the non-git fallback still covers the whole project, and the shipped `index-core.mjs` bundle must carry the same discovery logic as `src/` — that bundle is what installed projects actually run, so a fix landing only in `src/` reaches nobody.
|
|
3312
3327
|
|
|
3313
3328
|
## 2.0.3 - 2026-08-11
|
|
3314
3329
|
|
|
3315
3330
|
### Added
|
|
3316
3331
|
|
|
3317
|
-
- **`ukit memory propose "<text>" [--category <name>] [--project <id>]`** — the missing first step of the Project Pattern Learning loop.
|
|
3332
|
+
- **`ukit memory propose "<text>" [--category <name>] [--project <id>]`** — the missing first step of the Project Pattern Learning loop.
|
|
3318
3333
|
|
|
3319
3334
|
### Fixed
|
|
3320
3335
|
|
|
3321
|
-
- **Project Pattern Learning was unreachable in every real install.** v2.0.0 shipped `ukit memory list --pending` / `approve` / `reject`, but nothing could create a candidate:
|
|
3336
|
+
- **Project Pattern Learning was unreachable in every real install.** v2.0.0 shipped `ukit memory list --pending` / `approve` / `reject`, but nothing could create a candidate:
|
|
3322
3337
|
- **The v2.0.0 handoff Interfaces block never shipped.** `Consumes`/`Produces` were added to the repo's own `docs/AI_HANDOFF/RULES.md` and `tasks/_TEMPLATE.md` but not to the `templates/docs/AI_HANDOFF/` copies that `ukit install` actually delivers, so installed projects got handoff docs without the feature the 2.0.0 changelog claims. Same dev-mirror divergence class as the 2.0.2 hard-cap hooks.
|
|
3323
3338
|
|
|
3324
3339
|
## 2.0.2 - 2026-08-11
|
|
3325
3340
|
|
|
3326
3341
|
### Added
|
|
3327
3342
|
|
|
3328
|
-
- **Absolute context hard cap** — new `compact.hardCapTokens` (default `220000`) and `compact.hardCapBlock` (default `true`).
|
|
3343
|
+
- **Absolute context hard cap** — new `compact.hardCapTokens` (default `220000`) and `compact.hardCapBlock` (default `true`).
|
|
3329
3344
|
- **`reset-compact-pressure.sh`** (SessionStart) — zeroes the compact pressure tracker at session start, so the cap measures the current session rather than accumulating over a project's lifetime.
|
|
3330
3345
|
|
|
3331
3346
|
### Fixed
|
|
3332
3347
|
|
|
3333
|
-
- **The hard cap would have shipped dead.** Both new hooks were wired into `settings.json` but had no entry in `manifests/platform.full.yaml`, so `ukit install` never copied them:
|
|
3348
|
+
- **The hard cap would have shipped dead.** Both new hooks were wired into `settings.json` but had no entry in `manifests/platform.full.yaml`, so `ukit install` never copied them:
|
|
3334
3349
|
- **Permanent-block deadlock.** `compact-pressure.json` accumulated forever, so the cap would eventually block `Edit`/`Write`/`Bash` in every future session even with tiny context — and because the gate covers `Bash`, the documented remedies could not run. Fixed by the SessionStart reset plus a PreCompact reset.
|
|
3335
3350
|
- **Reset skipped on cache hit.** The PreCompact reset sat after `reinject-context.mjs`'s prompt-cache early return, so a cache hit left the gate tripped permanently. Moved ahead of the return.
|
|
3336
3351
|
- **Gate bypass via `NotebookEdit`/`MultiEdit`.** The gate compared `tool_name` exactly while the `settings.json` matcher is a regex (`Edit|Write` also matches both), so those tools fired the hook and passed through it. Now matched against an explicit tool set.
|
|
@@ -3368,25 +3383,25 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3368
3383
|
|
|
3369
3384
|
### Fixed
|
|
3370
3385
|
|
|
3371
|
-
- **`extract-image.mjs`** no longer re-arms `pending-<sha>.json` for an image that already has an `analyzed-<sha>.json` receipt.
|
|
3386
|
+
- **`extract-image.mjs`** no longer re-arms `pending-<sha>.json` for an image that already has an `analyzed-<sha>.json` receipt.
|
|
3372
3387
|
|
|
3373
3388
|
## 1.6.7 - 2026-08-09
|
|
3374
3389
|
|
|
3375
3390
|
### Fixed
|
|
3376
3391
|
|
|
3377
3392
|
- **`unic-gateway.mjs` `detectUnicGateway()`** is now scoped to Claude Code's own outbound endpoint only (`process.env.ANTHROPIC_BASE_URL`, and the `env.ANTHROPIC_BASE_URL` key in project/home `.claude/settings.json`). It no longer probes Codex `config.toml`, Kilo `secrets.json`, or `OPENAI_BASE_URL` — those describe a different tool's endpoint and were producing permanent false positives (`unicMode: true` for a plain Claude Code session whenever some other tool on the machine happened to be pointed at the UNIC gateway), which would deadlock Edit/Write on any image-mentioning turn under the vision gate.
|
|
3378
|
-
- **`vision-router.sh`** no longer always tells the caller to invoke `Agent(subagent_type:
|
|
3379
|
-
- **`handoff-model-guard.sh`** no longer re-blocks `git push` forever over a closed, human-approved model-tier exception (a documented `## Model-Tier Guard Override` section with `OVERRIDE_APPROVED_BY:
|
|
3393
|
+
- **`vision-router.sh`** no longer always tells the caller to invoke `Agent(subagent_type:
|
|
3394
|
+
- **`handoff-model-guard.sh`** no longer re-blocks `git push` forever over a closed, human-approved model-tier exception (a documented `## Model-Tier Guard Override` section with `OVERRIDE_APPROVED_BY:
|
|
3380
3395
|
|
|
3381
3396
|
## 1.6.6 - 2026-08-03
|
|
3382
3397
|
|
|
3383
3398
|
### Fixed
|
|
3384
3399
|
|
|
3385
|
-
- **`ensureGitignore`** no longer silently no-ops on a damaged UKit block (missing/duplicate end marker).
|
|
3400
|
+
- **`ensureGitignore`** no longer silently no-ops on a damaged UKit block (missing/duplicate end marker).
|
|
3386
3401
|
- **Install summary counts** no longer go negative or misattribute a skip. `applyDiffResults` now tracks skips per planned action (`create`/`update`), and `runInstallPipeline` subtracts each skip from its own bucket instead of always assuming `update`.
|
|
3387
3402
|
- **Runtime config default version** is now read from `package.json` instead of a hardcoded, drifting literal (was stuck at `1.5.2`).
|
|
3388
3403
|
- **`mergeObjects` (runtime config)** now refuses `__proto__`, `constructor`, and `prototype` keys at every merge depth, closing a prototype-pollution path via a hand-edited `.ukit/storage/config.json`.
|
|
3389
|
-
- **`buildInstallPlan`** no longer aborts the entire install when a template is missing for a *non-selected/excluded* item — it skips quietly.
|
|
3404
|
+
- **`buildInstallPlan`** no longer aborts the entire install when a template is missing for a *non-selected/excluded* item — it skips quietly.
|
|
3390
3405
|
- **`uninstallUkit`** now reports out-of-scope/forged tracked paths on real runs, not only `--dry-run`, while routine link-child paths stay silent.
|
|
3391
3406
|
|
|
3392
3407
|
## 1.6.5 - 2026-08-02
|
|
@@ -3395,10 +3410,10 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3395
3410
|
|
|
3396
3411
|
- **Enforced `unic-vision` image lane.** Images are now mechanically routed to a vision-capable model instead of being guessed at by `unic-code`/`unic-smart`, which cannot read images on the UNIC gateway.
|
|
3397
3412
|
- `.claude/ukit/index/extract-image.mjs` — decodes pasted images out of the session transcript to disk (a spawned subagent receives text only and does not inherit image blocks), and writes content-addressed `pending-<sha>.json` markers. Single owner of the sha256; both the marker and the image filename come from the same hash.
|
|
3398
|
-
- `.claude/hooks/vision-router.sh` (`UserPromptSubmit`) — detects all three input forms (pasted, local path, image URL) and arms a marker for each.
|
|
3399
|
-
- `.claude/hooks/vision-gate.sh` (`PreToolUse`, `Edit|Write` only) — hard-blocks the write (exit 2) until an `analyzed-<sha>.json` receipt exists whose self-reported model is vision-capable.
|
|
3413
|
+
- `.claude/hooks/vision-router.sh` (`UserPromptSubmit`) — detects all three input forms (pasted, local path, image URL) and arms a marker for each.
|
|
3414
|
+
- `.claude/hooks/vision-gate.sh` (`PreToolUse`, `Edit|Write` only) — hard-blocks the write (exit 2) until an `analyzed-<sha>.json` receipt exists whose self-reported model is vision-capable.
|
|
3400
3415
|
- `ukit-vision-analyst` agent — pinned to `unic-vision`, the only lane permitted to interpret images. Reports findings only; it has no `Edit`/`Write`.
|
|
3401
|
-
- `.claude/ukit/index/unic-gateway.mjs` — detects a `unicjsc.com` gateway across Claude Code env, Codex config, Kilo config, and `OPENAI_BASE_URL`.
|
|
3416
|
+
- `.claude/ukit/index/unic-gateway.mjs` — detects a `unicjsc.com` gateway across Claude Code env, Codex config, Kilo config, and `OPENAI_BASE_URL`.
|
|
3402
3417
|
|
|
3403
3418
|
### Changed
|
|
3404
3419
|
|
|
@@ -3410,14 +3425,14 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3410
3425
|
|
|
3411
3426
|
### Added
|
|
3412
3427
|
|
|
3413
|
-
- Hard enforcement of the handoff model-tier contract via a new `PreToolUse` hook (`.claude/hooks/handoff-model-guard.sh`), registered for both `Edit|Write` and `Bash`.
|
|
3428
|
+
- Hard enforcement of the handoff model-tier contract via a new `PreToolUse` hook (`.claude/hooks/handoff-model-guard.sh`), registered for both `Edit|Write` and `Bash`.
|
|
3414
3429
|
- Blocks writing `docs/AI_HANDOFF/PLAN.md` unless it declares a smart-tier `PLANNER_MODEL` in a new mandatory `## Planner Report` footer.
|
|
3415
3430
|
- Blocks creating a fresh `TASK-xxx.md` until `PLAN.md` has a valid smart-tier `PLANNER_MODEL`.
|
|
3416
3431
|
- Blocks writing `## Executor Report` unless `EXECUTOR_MODEL` is present and not lite-tier.
|
|
3417
3432
|
- Blocks writing `## Reviewer Verdict` unless `REVIEWER_MODEL` is smart-tier and differs from `EXECUTOR_MODEL`.
|
|
3418
3433
|
- Blocks `git push` when any reviewed task in the active cycle violates the contract.
|
|
3419
3434
|
- Applies identically to the standalone `/ukit:handoff-create`, `/ukit:handoff-implement`, `/ukit:handoff-review` commands and the combined `/ukit:handoff-fullstack` pipeline, since the gate is keyed on file content, not on which command ran.
|
|
3420
|
-
- `/ukit:handoff-create`, `/ukit:handoff-implement`, `/ukit:handoff-review`, `/ukit:handoff-fullstack`:
|
|
3435
|
+
- `/ukit:handoff-create`, `/ukit:handoff-implement`, `/ukit:handoff-review`, `/ukit:handoff-fullstack`:
|
|
3421
3436
|
- `handoff-planner` agent and `PLAN.md` now require a `## Planner Report` / `PLANNER_MODEL` self-report, mirroring the existing `EXECUTOR_MODEL` / `REVIEWER_MODEL` self-report contract on task files.
|
|
3422
3437
|
|
|
3423
3438
|
## 1.6.2 - 2026-07-26
|
|
@@ -3428,23 +3443,23 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3428
3443
|
|
|
3429
3444
|
### Changed
|
|
3430
3445
|
|
|
3431
|
-
- Downgraded `find-cause` and `map-impact` orchestration contracts from `modelTier:
|
|
3446
|
+
- Downgraded `find-cause` and `map-impact` orchestration contracts from `modelTier:
|
|
3432
3447
|
|
|
3433
3448
|
### Fixed
|
|
3434
3449
|
|
|
3435
|
-
- Auto-compact context-pressure state is now surfaced to the model as a warning (`[ukit-skill-router] Context pressure:
|
|
3450
|
+
- Auto-compact context-pressure state is now surfaced to the model as a warning (`[ukit-skill-router] Context pressure:
|
|
3436
3451
|
|
|
3437
3452
|
## 1.5.24 - 2026-06-10
|
|
3438
3453
|
|
|
3439
3454
|
### Fixed
|
|
3440
3455
|
|
|
3441
|
-
- Register `command-handoff-fullstack` in `manifests/platform.full.yaml` so `ukit install` now copies `handoff-fullstack.md` to target projects.
|
|
3456
|
+
- Register `command-handoff-fullstack` in `manifests/platform.full.yaml` so `ukit install` now copies `handoff-fullstack.md` to target projects.
|
|
3442
3457
|
|
|
3443
3458
|
## 1.5.23 - 2026-06-10
|
|
3444
3459
|
|
|
3445
3460
|
### Added
|
|
3446
3461
|
|
|
3447
|
-
- `handoff-fullstack`: new all-in-one slash command combining `handoff-create` + `handoff-implement` + `handoff-review` into a single pipeline.
|
|
3462
|
+
- `handoff-fullstack`: new all-in-one slash command combining `handoff-create` + `handoff-implement` + `handoff-review` into a single pipeline.
|
|
3448
3463
|
|
|
3449
3464
|
## 1.5.22 - 2026-06-09
|
|
3450
3465
|
|
|
@@ -3456,14 +3471,14 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3456
3471
|
|
|
3457
3472
|
### Changed
|
|
3458
3473
|
|
|
3459
|
-
- Renamed handoff slash commands from `*-handoff` to `handoff-*` convention: `handoff-status`, `handoff-create`, `handoff-implement`, `handoff-review`, `handoff-clear`.
|
|
3474
|
+
- Renamed handoff slash commands from `*-handoff` to `handoff-*` convention: `handoff-status`, `handoff-create`, `handoff-implement`, `handoff-review`, `handoff-clear`.
|
|
3460
3475
|
- Auto-prune now targets `handoff-abort.md` (new name) instead of `clear-handoff.md`.
|
|
3461
3476
|
|
|
3462
3477
|
## 1.5.16 - 2026-06-06
|
|
3463
3478
|
|
|
3464
3479
|
### Changed
|
|
3465
3480
|
|
|
3466
|
-
- `handoff-clear`: added Step 2 — stage `docs/AI_HANDOFF/`, commit planning artifacts, merge `handoff/integration → $BASE`, push, delete integration branch.
|
|
3481
|
+
- `handoff-clear`: added Step 2 — stage `docs/AI_HANDOFF/`, commit planning artifacts, merge `handoff/integration → $BASE`, push, delete integration branch.
|
|
3467
3482
|
- `handoff-review`: removed all merge/push instructions from Step 3. Reviewer now stops at "Run /ukit:handoff-clear" after all tasks approved.
|
|
3468
3483
|
- Rule enforced: `handoff-create`, `handoff-implement`, `handoff-review` may only change files inside `docs/AI_HANDOFF/`. No commits to main, no pushes.
|
|
3469
3484
|
|
|
@@ -3471,13 +3486,13 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3471
3486
|
|
|
3472
3487
|
### Changed
|
|
3473
3488
|
|
|
3474
|
-
- `handoff-review`: removed automatic `git merge handoff/integration → $BASE`. Reviewer now stops after all tasks are approved and instructs the human to merge manually.
|
|
3489
|
+
- `handoff-review`: removed automatic `git merge handoff/integration → $BASE`. Reviewer now stops after all tasks are approved and instructs the human to merge manually.
|
|
3475
3490
|
|
|
3476
3491
|
## 1.5.14 - 2026-06-05
|
|
3477
3492
|
|
|
3478
3493
|
### Added
|
|
3479
3494
|
|
|
3480
|
-
- Added 6 handoff slash commands to OpenCode template (`ukit-handoff-status`, `ukit-handoff-create`, `ukit-handoff-implement`, `ukit-handoff-review`, `ukit-handoff-clear`, `ukit-handoff-abort`).
|
|
3495
|
+
- Added 6 handoff slash commands to OpenCode template (`ukit-handoff-status`, `ukit-handoff-create`, `ukit-handoff-implement`, `ukit-handoff-review`, `ukit-handoff-clear`, `ukit-handoff-abort`).
|
|
3481
3496
|
|
|
3482
3497
|
### Fixed
|
|
3483
3498
|
|
|
@@ -3487,17 +3502,17 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3487
3502
|
|
|
3488
3503
|
### Fixed
|
|
3489
3504
|
|
|
3490
|
-
- Fixed `compact-threshold.mjs` never being deployed by `ukit install` — the file existed in `templates/` since v1.1.2 but was missing from `manifests/platform.full.yaml`.
|
|
3491
|
-
- Added `ukit-runtime-compact-threshold-script` manifest entry with correct `requires` chain.
|
|
3492
|
-
- Changed default `safePatch.advisoryOnly` from `false` to `true` in `src/core/runtimeConfig.js`.
|
|
3505
|
+
- Fixed `compact-threshold.mjs` never being deployed by `ukit install` — the file existed in `templates/` since v1.1.2 but was missing from `manifests/platform.full.yaml`.
|
|
3506
|
+
- Added `ukit-runtime-compact-threshold-script` manifest entry with correct `requires` chain.
|
|
3507
|
+
- Changed default `safePatch.advisoryOnly` from `false` to `true` in `src/core/runtimeConfig.js`.
|
|
3493
3508
|
|
|
3494
3509
|
## 1.5.5 - 2026-05-30
|
|
3495
3510
|
|
|
3496
3511
|
### Added
|
|
3497
3512
|
|
|
3498
|
-
- **Handoff Quality Gate** — opt-in, tool-agnostic, file-based, 4-phase pipeline (Idea+Plan → Create Tasks → Implement+Test → Review+Test) for tasks routed through `docs/AI_HANDOFF/`.
|
|
3499
|
-
- New agent `templates/.claude/agents/code-reviewer.md`: independent reviewer with a model-isolation check.
|
|
3500
|
-
- New config block `handoff.*` in `templates/ukit/storage/config.json` with Vietnamese `_help` entries:
|
|
3513
|
+
- **Handoff Quality Gate** — opt-in, tool-agnostic, file-based, 4-phase pipeline (Idea+Plan → Create Tasks → Implement+Test → Review+Test) for tasks routed through `docs/AI_HANDOFF/`.
|
|
3514
|
+
- New agent `templates/.claude/agents/code-reviewer.md`: independent reviewer with a model-isolation check.
|
|
3515
|
+
- New config block `handoff.*` in `templates/ukit/storage/config.json` with Vietnamese `_help` entries:
|
|
3501
3516
|
- New `## 4. Test Plan (REQUIRED — TDD-style)` section in `templates/docs/AI_HANDOFF/PLAN.md`.
|
|
3502
3517
|
- New `templates/docs/AI_HANDOFF/tasks/_TEMPLATE.md`: every task file MUST embed its own `## Test Cases` (table with happy + ≥1 edge case + regression for bug fixes) + `## Test Files` + `## Verification Commands` + `## Acceptance Criteria`. Tasks without these are `needs_breakdown`, not `ready`.
|
|
3503
3518
|
- `## Discussion` section pattern on task files: structured AI-to-AI comment thread (date · role · tool/model) so planner/executor/reviewer can talk back to each other through files — no out-of-band channels.
|
|
@@ -3505,14 +3520,14 @@ Handoff autonomy wave: `/ukit:handoff-fullstack` runs a whole goal end-to-end wi
|
|
|
3505
3520
|
|
|
3506
3521
|
### Changed
|
|
3507
3522
|
|
|
3508
|
-
- `templates/.claude/agents/feature-implementer.md`: now operates in two explicit modes.
|
|
3523
|
+
- `templates/.claude/agents/feature-implementer.md`: now operates in two explicit modes.
|
|
3509
3524
|
- `templates/.claude/agents/bug-debugger.md`: same two-mode split. Handoff mode requires regression-test-first (RED before fix, GREEN after); Daily mode unchanged.
|
|
3510
|
-
- `templates/docs/AI_HANDOFF/RULES.md`: rewritten around the 4-phase model. Added `## Hard rule — All work stays in docs/AI_HANDOFF/` (no out-of-band AI communication).
|
|
3525
|
+
- `templates/docs/AI_HANDOFF/RULES.md`: rewritten around the 4-phase model. Added `## Hard rule — All work stays in docs/AI_HANDOFF/` (no out-of-band AI communication).
|
|
3511
3526
|
- `templates/CLAUDE.md` + `templates/AGENTS.md`: added scoped `## Handoff Quality Gate` section with explicit OPT-IN scope language so adapter targets (Claude Code, Kilo Code, Codex, OpenCode, future tools) only apply Quality Gate to handoff work, not daily prompts.
|
|
3512
3527
|
|
|
3513
3528
|
### Fixed
|
|
3514
3529
|
|
|
3515
|
-
- Fixed output-history deduplication for `promptCache: false` — the second call with semantically equivalent (but noisy) output now returns the cached first summary instead of recomputing.
|
|
3530
|
+
- Fixed output-history deduplication for `promptCache: false` — the second call with semantically equivalent (but noisy) output now returns the cached first summary instead of recomputing.
|
|
3516
3531
|
|
|
3517
3532
|
### Why
|
|
3518
3533
|
|
|
@@ -3582,7 +3597,7 @@ User had two real concerns: (1) cheap-model executors (e.g. Kilo Code) miss smal
|
|
|
3582
3597
|
|
|
3583
3598
|
### Fixed
|
|
3584
3599
|
|
|
3585
|
-
- Stopped safe-patch hooks (`stale-spec-check`, `post-edit-verify`) from hard-blocking tool calls when configured via the new `safePatch.advisoryOnly` flag or the `UKIT_SAFE_PATCH_ADVISORY=1` env.
|
|
3600
|
+
- Stopped safe-patch hooks (`stale-spec-check`, `post-edit-verify`) from hard-blocking tool calls when configured via the new `safePatch.advisoryOnly` flag or the `UKIT_SAFE_PATCH_ADVISORY=1` env.
|
|
3586
3601
|
- Default behavior unchanged (`advisoryOnly: false`): pre-edit corruption guards (shebang-bom, non-text, whole-file Write to shared-risk) and the `protect-files` / `block-dangerous` hooks still hard-block.
|
|
3587
3602
|
|
|
3588
3603
|
### Tests
|
|
@@ -3675,7 +3690,7 @@ User had two real concerns: (1) cheap-model executors (e.g. Kilo Code) miss smal
|
|
|
3675
3690
|
- Added post-edit delta verification for backed-up shared-risk edits so unexpected broad rewrites are flagged against the Safe Patch hunk/changed-line budget and rollback manifests record after hashes.
|
|
3676
3691
|
- Added Safe Patch backup retention and bounded delta-diff fallback so rollback data does not grow forever and very large edits avoid unbounded LCS memory use.
|
|
3677
3692
|
- Added byte-first UTF-8/BOM/newline profile handling so helper-mediated patches preserve UTF-8 BOM/no-BOM, LF/CRLF, Vietnamese/CJK/emoji content, and reject unsafe binary/invalid UTF-8 edit paths.
|
|
3678
|
-
- Added `safePatch` runtime config defaults under `.ukit/storage/config.json` while keeping the end-user workflow unchanged:
|
|
3693
|
+
- Added `safePatch` runtime config defaults under `.ukit/storage/config.json` while keeping the end-user workflow unchanged:
|
|
3679
3694
|
|
|
3680
3695
|
### Changed
|
|
3681
3696
|
|
|
@@ -3753,7 +3768,7 @@ User had two real concerns: (1) cheap-model executors (e.g. Kilo Code) miss smal
|
|
|
3753
3768
|
- Added recovery-safe output compaction on top of the existing command-aware compression lane instead of introducing a second output/history subsystem.
|
|
3754
3769
|
- Preserved raw tool output in `ukit/storage/cache/tee/` for high-value recovery cases such as failed commands, large raw outputs, or unusually high token savings.
|
|
3755
3770
|
- Extended output-history entries with recovery metadata (`rawSaved`, `rawPath`, `rawBytes`, `recoveryReason`) so routed/runtime consumers can reuse the same shared artifact instead of rerunning noisy commands blindly.
|
|
3756
|
-
- Appended a compact `Full output:` recovery hint only when it still preserves net token savings;
|
|
3771
|
+
- Appended a compact `Full output:` recovery hint only when it still preserves net token savings;
|
|
3757
3772
|
- Kept source runtime behavior and shipped Claude hook behavior aligned for recovery-safe compaction, including prompt-cache reuse of recovery metadata and history dedupe that ignores the recovery-hint line.
|
|
3758
3773
|
- Extended `ukit status` output-compression reporting to show recovery counts so maintainers can see when the runtime preserved raw evidence in addition to saving tokens.
|
|
3759
3774
|
- Updated shared runtime docs/version surfaces to reflect the new v1.1.4 recovery-safe compaction lane while keeping the teammate workflow centered on `ukit install`.
|
|
@@ -3866,25 +3881,25 @@ User had two real concerns: (1) cheap-model executors (e.g. Kilo Code) miss smal
|
|
|
3866
3881
|
- support nested DuraOne monorepo activation
|
|
3867
3882
|
- Fixed index graph resolution for extensionless React-style internal imports (`.jsx`, `.tsx`, and directory `index.jsx` / `index.tsx`) so rerunning **`ukit install`** rebuilds correct relations/analogs in JSX/TSX projects too.
|
|
3868
3883
|
- Fixed source discovery for supported **symlinked source files** in both the repo runtime and the shipped installed mirror, so alias file paths inside the project remain indexed/searchable even when the real file lives elsewhere.
|
|
3869
|
-
- Stopped `ukit install` from claiming success before the required source-code index actually finishes;
|
|
3884
|
+
- Stopped `ukit install` from claiming success before the required source-code index actually finishes;
|
|
3870
3885
|
- Slimmed the bundled hidden `canvas-design` asset lane to a curated built-in font set, cutting the published tarball from roughly **3.3 MB** to **1.5 MB** while preserving immediate post-install usability and the one-command `ukit install` workflow.
|
|
3871
3886
|
- Deduped the heavy hidden **OOXML** support bundle used by PPTX/DOCX into a shared installed lane, preserving the same skill paths after `ukit install` via symlinks and safely migrating previously managed real directories on reinstall.
|
|
3872
|
-
- Hardened uninstall against stale tracked metadata under managed symlink roots:
|
|
3873
|
-
- Hardened reinstall migration for shared OOXML symlink targets so UKit only auto-replaces an old real directory when every nested path is still clearly UKit-managed;
|
|
3874
|
-
- Hardened reinstall migration again so even an **empty real directory** at a managed symlink target is treated as ambiguous user content;
|
|
3875
|
-
- Hardened legacy reinstall cleanup so `ukit install` no longer deletes the whole old `ukit/.ukit/` directory tree;
|
|
3876
|
-
- Hardened legacy flat-file cleanup so paths like `.claude/skills/delivery.md` are removed only when they are actual files/symlinks;
|
|
3887
|
+
- Hardened uninstall against stale tracked metadata under managed symlink roots:
|
|
3888
|
+
- Hardened reinstall migration for shared OOXML symlink targets so UKit only auto-replaces an old real directory when every nested path is still clearly UKit-managed;
|
|
3889
|
+
- Hardened reinstall migration again so even an **empty real directory** at a managed symlink target is treated as ambiguous user content;
|
|
3890
|
+
- Hardened legacy reinstall cleanup so `ukit install` no longer deletes the whole old `ukit/.ukit/` directory tree;
|
|
3891
|
+
- Hardened legacy flat-file cleanup so paths like `.claude/skills/delivery.md` are removed only when they are actual files/symlinks;
|
|
3877
3892
|
- Hardened adapter deselection metadata cleanup so removing a managed link path also removes stale tracked descendants under that path, preventing old `.antigravity/skills/...` or `.codex/skills/...` entries from lingering in install metadata after `ukit install --tools=...` changes.
|
|
3878
|
-
- Hardened maintainer preview flows so `ukit diff` / dry-run install planning no longer delete a previously managed real directory before showing the preview;
|
|
3879
|
-
- Fixed index import resolution for **single-segment `baseUrl` imports** (for example `import { loadUser } from 'userApi'` with `baseUrl:
|
|
3880
|
-
- Hardened adapter deselection safety again so UKit only prunes deselected adapter files when install metadata proves UKit actually owns them;
|
|
3893
|
+
- Hardened maintainer preview flows so `ukit diff` / dry-run install planning no longer delete a previously managed real directory before showing the preview;
|
|
3894
|
+
- Fixed index import resolution for **single-segment `baseUrl` imports** (for example `import { loadUser } from 'userApi'` with `baseUrl:
|
|
3895
|
+
- Hardened adapter deselection safety again so UKit only prunes deselected adapter files when install metadata proves UKit actually owns them;
|
|
3881
3896
|
- Tightened deselection ownership handling so when adapter cleanup is skipped (non-interactive mode, user says no, or the path is a real directory), UKit immediately drops those deselected paths from install metadata instead of carrying stale ownership forward to uninstall.
|
|
3882
|
-
- Restored **index-first routing** for prompt-only hybrid lanes where a standalone specialist (for example Docker packaging) is selected together with a real code skill;
|
|
3883
|
-
- Hardened fresh `ukit install` ownership handling against stray/non-UKit `install.json` files:
|
|
3897
|
+
- Restored **index-first routing** for prompt-only hybrid lanes where a standalone specialist (for example Docker packaging) is selected together with a real code skill;
|
|
3898
|
+
- Hardened fresh `ukit install` ownership handling against stray/non-UKit `install.json` files:
|
|
3884
3899
|
- Stopped tracking **skip-strategy bootstrap files** (for example `docs/PROJECT.md`, `docs/MEMORY.md`, `docs/WORKLOG.md`, `CLAUDE.md`, `AGENTS.md`, `.claude/settings.local.json`, `.codex/settings.local.json`) as uninstall-owned outputs, so UKit preserves team memory/local settings even when those files were first created by `ukit install`.
|
|
3885
|
-
- Kept **test-like direct targets** targeted even when filenames omit `.test` / `.spec` (for example `tests/pages/LoginFlow.js`):
|
|
3886
|
-
- Hardened source `deriveVerificationPlan(...)` again so callers that pass a precomputed/raw `contextResult` still normalize direct `tests/` / `specs/` primary targets into targeted verification;
|
|
3887
|
-
- Fixed source + shipped index discovery so root-level **`specs/` / `spec/` / `test/` / `__tests__/`** lanes are scanned and treated consistently as likely tests;
|
|
3900
|
+
- Kept **test-like direct targets** targeted even when filenames omit `.test` / `.spec` (for example `tests/pages/LoginFlow.js`):
|
|
3901
|
+
- Hardened source `deriveVerificationPlan(...)` again so callers that pass a precomputed/raw `contextResult` still normalize direct `tests/` / `specs/` primary targets into targeted verification;
|
|
3902
|
+
- Fixed source + shipped index discovery so root-level **`specs/` / `spec/` / `test/` / `__tests__/`** lanes are scanned and treated consistently as likely tests;
|
|
3888
3903
|
- Completed the root test-lane hardening so **root `test/`, `spec/`, and `__tests__/`** paths are recognized consistently across index build, query ranking, and direct test-target routing/verification heuristics in both source and shipped helpers.
|
|
3889
3904
|
- Aligned shipped helper cache keys with route-task seeding for **target-only helper invocations** (`--target ...` with no prompt text), so direct `resolve-context` / `verify-context` calls can reuse the route-seeded cache instead of recomputing indexed context.
|
|
3890
3905
|
- Reused relations/analogs safely for alias-based projects when code + alias config stay unchanged, reducing wasted rebuild work on repeated refreshes.
|