baldart 4.88.0 → 4.88.1

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to BALDART will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [4.88.1] - 2026-07-01
+
+**`baldart update` backfills hooks on the aligned/self-heal path too.** The "already up to date" branch of `update` reconciled newly-shipped payload (agents / skills / workflows / output-styles + root primitives) but did **not** backfill hooks. Same gap class the payload reconcile already fixed: a consumer who framework-updated with an **older CLI** (before a given hook shipped — e.g. the v4.88.0 Codex hooks) and then aligned the CLI would hit the "already current" early-exit and **never get the hooks registered** (recoverable only via `doctor`). Now the aligned path registers both Claude (`.claude/settings.json`) and — when `tools.enabled ∋ codex` — Codex (`.codex/hooks.json`) hooks, **idempotently and additively**: SILENT when nothing is missing, drift left to `doctor` (never prompts on the self-heal path), non-fatal on any hiccup. The `--json` payload gains `backfilled_hooks`. **PATCH** — robustness fix, no behavior change on a healthy install. Codex parity: adapter-generated (the same registrar). No new config key.
+
+### Changed
+
+- **`src/commands/update.js`** — the aligned "already up to date" branch now backfills missing Claude + Codex hooks (silent when none missing) and reports `backfilled_hooks` in `--json`.
+
 ## [4.88.0] - 2026-07-01
 
 **Native Codex hooks — BALDART now manages `.codex/hooks.json` in parallel with `.claude/settings.json` (Codex-parity foundation, S1–S3).** Kicks off a phased program to make BALDART **universally tool-agnostic**: everything it ships must work natively on both Claude Code and Codex. Two governance rules are now binding on all future development (CLAUDE.md § "Cross-tool parity discipline"): (1) every NEW tool/surface is first checked for native Codex compatibility (portable / adapter-generated / inline-fallback / N/A, outcome recorded in the CHANGELOG); (2) every change travels in parallel across Codex and Claude in the same change. This release delivers the **hook foundation**:

package/VERSION

@@ -1 +1 @@
-4.88.0
+4.88.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baldart",
-  "version": "4.88.0",
+  "version": "4.88.1",
   "description": "Claude Agent Framework - Reusable framework for coordinating AI agents and humans in software projects",
   "bin": {
     "baldart": "./bin/baldart.js"

package/src/commands/update.js

@@ -939,12 +939,44 @@ async function update(options = {}, unknownArgs = []) {
       // version bump or a slot/overlay change must land even on an aligned install.
       // --json is programmatic → force autonomous so a handwritten file is never mutated.
       reconcileRootPrimitives(process.cwd(), alignedTools, options && options.json === true ? true : undefined);
+
+      // Backfill hooks on the aligned/self-heal path too. Same gap class as the
+      // payload reconcile above: a consumer who framework-updated with an OLDER
+      // CLI (before a given hook shipped — e.g. the S2 Codex hooks) then aligns
+      // the CLI would hit this "already current" early-exit and never get the
+      // hooks registered. Idempotent + additive → SILENT when nothing is
+      // missing; drift is left to `doctor` (never prompt on the self-heal path).
+      let hooksBackfilled = 0;
+      try {
+        const res = await Hooks.registerAll(process.cwd(), {
+          onDrift: Hooks.createDriftPrompt(UI, { autoYes: true }),
+        });
+        if (!res.malformed) {
+          hooksBackfilled += res.results.filter((r) => r.status === 'created' || r.status === 'legacy-migrated').length;
+        }
+      } catch (_) { /* non-fatal — never fail an aligned install on a hook hiccup */ }
+      if (Array.isArray(alignedTools) && alignedTools.includes('codex')) {
+        try {
+          const CodexHooks = require('../utils/hooks/codex');
+          const res = await CodexHooks.registerAll(process.cwd(), {
+            onDrift: CodexHooks.createDriftPrompt(UI, { autoYes: true }),
+          });
+          if (!res.malformed) {
+            hooksBackfilled += res.results.filter((r) => r.status === 'created').length;
+          }
+        } catch (_) { /* non-fatal */ }
+      }
+      if (hooksBackfilled > 0) {
+        UI.info(`Backfilled ${hooksBackfilled} missing hook(s) — hook drift from a prior CLI-skew update, now healed.`);
+      }
+
       UI.success(`Already up to date! (v${status.installedVersion})`);
       emitUpdateJson({ ok: true, action: 'already-current',
         installed_before: status.installedVersion,
         installed_after: status.installedVersion,
         remote_version: status.remoteVersion,
-        reconciled_items: reconciled }, 0);
+        reconciled_items: reconciled,
+        backfilled_hooks: hooksBackfilled }, 0);
     }
 
     UI.warning(`Update available: v${status.installedVersion} → v${status.remoteVersion}`);