@ngockhoale/ukit 2.6.4 → 2.6.6

package/CHANGELOG.md

@@ -2,6 +2,79 @@
 
 All notable changes to UKit are documented here.
 
+## 2.6.6 - 2026-09-19
+
+Documentation-hardening release — first slice of the
+DOCUMENTATION_IMPROVEMENT_ROADMAP (cycle C24, DOC-001..006). No runtime
+behavior changes: new manifest, new test lanes, doc cleanup, and a shipped
+registry the remaining roadmap items build on.
+
+- **DOC-001 — documentation ownership/source registry**: new
+  `manifests/documentation.yaml` classifies every active/template/adapter
+  documentation surface (owner, source_of_truth, merge_strategy, budget);
+  `tests/consistency/docRegistry.test.js` enforces schema, coverage,
+  manifest-skip consistency, and `error`-level budgets.
+- **DOC-002 — cross-agent benchmark corpus**: spec + fixtures at
+  `tests/fixtures/doc-benchmark/` (corpus index, 4 host files, 9+ task files);
+  `tests/benchmarks/docBenchmarkCorpus.test.js` validates structure and
+  registry cross-references. Host execution deferred — every host recorded
+  `untested` (roadmap-permitted).
+- **DOC-003 — artifact reference-integrity checks**:
+  `tests/integration/artifactReferenceIntegrity.test.js` fails when a shipped
+  instruction/skill doc references an internal command/file that does not
+  resolve into the `npm pack` artifact (or the declared runtime-generated
+  allowlist); wired into `yarn test:artifact`.
+- **DOC-004 — owner-file preservation lifecycle tests**:
+  `tests/integration/ownerPreservation.test.js` proves install/update/uninstall
+  preserve exact bytes and symlink posture of every registry
+  `merge_strategy: skip` file, including BOM/CRLF and absent-seed cases.
+- **DOC-005 — STATUS.md live snapshot**: `docs/STATUS.md` shrunk to a ≤150-line
+  live snapshot; historical body preserved verbatim at
+  `docs/archive/status/STATUS-2026-09-19.md` with two-way links; registry
+  budget for STATUS.md flipped to `error`.
+- **DOC-006 — adapter stale-version cleanup**: zero stale `vX.Y.Z` literals on
+  adapter doc surfaces (`templates/.codex/README.md`, `.codex/README.md`,
+  `templates/ukit/README.md`, `.ukit/README.md`); Codex-specific mechanics
+  retained; `tests/consistency/staleVersionProse.test.js` enforces.
+
+## 2.6.5 - 2026-09-19
+
+Stability release — third full audit pass on the 2.6.4 base (cycle C23). 15
+confirmed hang / freeze / silent-idle / silent-hook defects fixed with root
+causes (full register: `docs/AI_HANDOFF/BUGS-2.6.5.md`). Headline: the
+cycle-lockout mechanism observed live — stall-breaker streak erased on every
+Stop (BUG-C23-08) — is fixed, plus every blocking/degrading hook exit now
+announces on stdout per the §8 contract.
+
+- **Handoff stall-breaker streak erased every Stop (BUG-C23-08)**: the
+  stop-coordinator dedupe write dropped the `handoff` streak slot, so a wedged
+  RUN.md blocked forever; the merge now preserves the slot.
+- **Silent non-zero hook failures (BUG-C23-01, -03, -07)**: stderr-only crash
+  reasons in `output-compression`/`reinject-context`/`post-edit-verify`/
+  `stale-spec-check` + safe-patch exit-2 blocks + skill-router/vision-router/
+  task-watchdog crash paths now emit a stdout `systemMessage` before exit —
+  stderr reaches the model, not reliably the user.
+- **Lost/silent deadline emissions (BUG-C23-02, -04)**: compact-threshold's
+  same-tick `stdout.write` + `process.exit(0)` discarded the announce on pipes
+  (now `writeSync(1)`); deadline-expiry `exit 0` in four called `.mjs` modules
+  and `handoff-resume.sh` now announces the abandoned work.
+- **Fail-open/crash-posture defects (BUG-C23-05, -06)**: context-hardcap-gate's
+  internal-error catch now announces its fail-open degrade on stdout;
+  completion-gate's stop-coordinator spawn is deadline-bounded with forced
+  kill routed to the crash-streak path.
+- **Silent data loss + hot-path waste (BUG-C23-09, -10, -13, -15)**:
+  compact-threshold double capacity read collapsed to one; sweep failures
+  announce (bounded) instead of `.catch(() => {})` swallow; unguarded `main()`
+  no longer runs on `import()`; route-audit merges stage to an append-only
+  sidecar with a locked + exit fold instead of silently dropping entries.
+- **Unbounded growth + unbounded stalls (BUG-C23-11, -12, -14)**: memory
+  project archives capped; `permission-audit.log` rotates inside the prune
+  pass; `bin/ukit` runCli got an overall deadline watchdog.
+
+Regression gate: 138 files / 2360 tests green, liveness 120/120, §8 sweep
+clean, template↔installed parity byte-identical, async-caller census clean,
+all 25 C22 verdicts re-confirmed.
+
 ## 2.6.4 - 2026-09-19
 
 Stability release — second full audit pass on the 2.6.3 base (cycle C22). 25

package/bin/ukit

@@ -11,17 +11,37 @@ async function readPackageVersion(packageRoot) {
   return packageJson.version;
 }
 
+const DEFAULT_CLI_DEADLINE_MS = 120_000;
+
+function resolveCliDeadlineMs() {
+  const raw = Number(process.env.UKIT_CLI_DEADLINE_MS);
+  return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_CLI_DEADLINE_MS;
+}
+
 async function main() {
-  const currentFile = fileURLToPath(import.meta.url);
-  const packageRoot = path.resolve(path.dirname(currentFile), '..');
-  const packageVersion = await readPackageVersion(packageRoot);
-
-  await runCli({
-    argv: process.argv.slice(2),
-    packageRoot,
-    projectRoot: process.cwd(),
-    packageVersion,
-  });
+  // Overall wall-clock watchdog: individual fs/readline awaits inside runCli are
+  // unbounded, so a wedged .ukit/external mount would park the CLI forever.
+  const deadlineMs = resolveCliDeadlineMs();
+  const watchdog = setTimeout(() => {
+    console.error(`[UKit] timed out after ${deadlineMs}ms — likely wedged filesystem; retry`);
+    process.exit(1);
+  }, deadlineMs);
+  watchdog.unref();
+
+  try {
+    const currentFile = fileURLToPath(import.meta.url);
+    const packageRoot = path.resolve(path.dirname(currentFile), '..');
+    const packageVersion = await readPackageVersion(packageRoot);
+
+    await runCli({
+      argv: process.argv.slice(2),
+      packageRoot,
+      projectRoot: process.cwd(),
+      packageVersion,
+    });
+  } finally {
+    clearTimeout(watchdog);
+  }
 }
 
 main().catch((error) => {