worclaude 2.4.6 → 2.4.8

package/CHANGELOG.md

@@ -4,6 +4,31 @@ All notable changes to worclaude are documented in this file. Format loosely fol
 
 ## [Unreleased]
 
+## [2.4.8] — 2026-04-20
+
+Bug fix release — `worclaude doctor` reported `File integrity: 1/54 files missing` on every v2.4.6+ install. `checkHashIntegrity` resolved every `workflow-meta.json` `fileHashes` key under `.claude/`, so `root/AGENTS.md` (tracked at project root since v2.4.6) got looked up at `.claude/root/AGENTS.md` — which doesn't exist. `worclaude upgrade` already handled the `root/` prefix correctly; only doctor had missed the update.
+
+### Fixed
+
+- `worclaude doctor` now uses the shared `resolveKeyPath` helper from `src/core/file-categorizer.js` for every `fileHashes` key, so `root/<path>` entries resolve at the project root and `hooks/<name>` entries resolve under `.claude/hooks/`. No behavior change for `agents/`, `commands/`, or `skills/` keys.
+
+### Changed
+
+- `docs/reference/configuration.md` — `fileHashes` example extended with `hooks/` and `root/` entries and a one-line description of the key-prefix vocabulary. The field description no longer claims scope is "all files in `.claude/`" — that stopped being true in v2.4.6 when `root/AGENTS.md` started being tracked.
+
+## [2.4.7] — 2026-04-20
+
+Bug fix release — the learn-capture Stop hook writes `.claude/.stop-hook-active` as a runtime re-entry guard, but the scaffolded `.gitignore` never covered it. Every project scaffolded or upgraded to 2.4.6 saw a dirty `git status` right after the Stop hook fired. `worclaude delete` also left the now-stale line in `.gitignore`. Both are fixed symmetrically.
+
+### Fixed
+
+- `worclaude init` and `worclaude upgrade` now append `.claude/.stop-hook-active` to `.gitignore`. Pre-v2.4.7 installs pick up the missing entry on the next `upgrade`.
+- `worclaude delete` now removes the `.claude/.stop-hook-active` line from `.gitignore` alongside the other worclaude entries. `.claude-backup-*/` and `.claude/learnings/` remain intentionally preserved so personal/backup content stays ignored after uninstall.
+
+### Changed
+
+- `docs/reference/configuration.md` — gitignore entries reference now lists all 7 entries (previously out of date — missing `.claude/learnings/` too) with a one-line note on the stop-hook flag.
+
 ## [2.4.6] — 2026-04-19
 
 Bug fix release — `worclaude upgrade` was silently no-oping when the installed and CLI versions matched, even when on-disk files were missing. `worclaude doctor` flagged drift, but the upgrade command refused to reconcile it. This release adds a drift-repair pass to `upgrade` and exposes new flags.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worclaude",
-  "version": "2.4.6",
+  "version": "2.4.8",
   "description": "The Workflow Layer for Claude Code — scaffold agents, commands, skills, hooks, and memory into any project",
   "type": "module",
   "bin": {

package/src/commands/doctor.js

@@ -11,6 +11,7 @@ import {
   TEMPLATE_SKILLS,
 } from '../data/agents.js';
 import { hasClaudeMdMemoryGuidance, readClaudeMd } from '../core/drift-checks.js';
+import { resolveKeyPath } from '../core/file-categorizer.js';
 import * as display from '../utils/display.js';
 
 // Check categories
@@ -534,7 +535,7 @@ async function checkHashIntegrity(projectRoot, meta) {
   let intact = 0;
 
   for (const [relPath, storedHash] of Object.entries(meta.fileHashes)) {
-    const fullPath = path.join(projectRoot, '.claude', ...relPath.split('/'));
+    const fullPath = resolveKeyPath(relPath, projectRoot);
     if (!(await fileExists(fullPath))) {
       missing++;
     } else {

package/src/core/remover.js

@@ -188,6 +188,7 @@ export async function cleanGitignore(projectRoot) {
     '.claude/settings.local.json',
     '.claude/workflow-meta.json',
     '.claude/worktrees/',
+    '.claude/.stop-hook-active',
   ]);
 
   const filtered = lines.filter((line) => !REMOVE_LINES.has(line.trim()));

package/src/core/scaffolder.js

@@ -54,6 +54,7 @@ export async function updateGitignore(projectDir) {
     '.claude/worktrees/',
     '.claude-backup-*/',
     '.claude/learnings/',
+    '.claude/.stop-hook-active',
   ];
   const header = '# Worclaude (generated workflow files)';