holistic 0.2.0 → 0.2.3

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.2.3 - 2026-03-22
+
+Stopped teaching agents to visibly fail on missing PATH before recovering.
+
+- Changed generated Holistic docs to recommend repo-local helper commands first in bootstrapped repos.
+- Changed resume output to recommend repo-local commands directly instead of bare `holistic ...` commands.
+- Tightened startup, checkpoint, and handoff guidance so agents use repo-local commands by default.
+- Added regression coverage for the repo-local-first command recommendations.
+
+## 0.2.2 - 2026-03-22
+
+Improved first-run recovery when Holistic is available in the repo but missing from the current shell PATH.
+
+- Added generated repo-local CLI fallback wrappers under `.holistic/system/` for Windows and macOS/Linux.
+- Surfaced repo-local fallback commands in bootstrap output, resume output, and generated Holistic docs.
+- Updated the README to document the repo-local fallback command for bootstrapped repos.
+- Added regression coverage for the generated fallback wrappers and startup guidance.
+
+## 0.2.1 - 2026-03-22
+
+Hardened for real-world use after dogfooding on the project that inspired Holistic.
+
+- Added `holistic --version` / `-v` / `version` command.
+- Added version display in the ASCII splash banner.
+- Fixed repo snapshot performance — now skips `node_modules` and other heavy generated directories instead of stat-ing tens of thousands of irrelevant files on every checkpoint.
+- Fixed stale lock recovery — a crashed daemon or CLI no longer permanently blocks all state operations.
+- Fixed corrupt session resilience — a single bad JSON file in `.holistic/sessions/` no longer crashes the entire tool.
+- Fixed `bin/holistic.js` to respect `holistic.repo.json` runtime overrides in the post-handoff auto-commit flow.
+- Fixed git hook refresh — hooks now self-heal from daemon startup and MCP client connections, not just CLI commands.
+- Improved first-run experience — softened empty-state language in generated docs so agents don't editorialize about missing plans.
+
 ## 0.2.0 - 2026-03-21
 
 First public npm-ready release of Holistic.

package/CONTRIBUTING.md

@@ -37,19 +37,28 @@ npm test
 | `tests/run-tests.ts` | end-to-end regression harness |
 | `.holistic-local/` | ignored local Holistic runtime for this public product repo |
 
-## Dogfooding Holistic in this repo
+## Working On This Repo
 
-This public product repo is a special case.
+This repository is the public Holistic product repo. That makes it a special case.
 
-Holistic dogfooding here must stay local-only and untracked. The repo-level override redirects runtime state into `.holistic-local/`, `HOLISTIC.local.md`, and `AGENTS.local.md` instead of tracked public runtime files.
+Normal user repos are expected to commit portable Holistic runtime files such as `.holistic/` and sync them through the hidden portable state ref. This repo should not publish a contributor's live runtime state, handoff history, or local dogfooding artifacts.
 
-Recommended local setup for working on Holistic itself:
+### Repo-specific dogfooding rules
+
+- Keep self-dogfooding runtime local-only and untracked.
+- Use `.holistic-local/`, `HOLISTIC.local.md`, and `AGENTS.local.md` for repo-local runtime state.
+- Do not initialize tracked `.holistic/` runtime state in this repo.
+- Do not use a visible `holistic/state` branch for self-dogfooding here.
+
+### Recommended local setup
+
+If you want Holistic active while working on Holistic itself, use this non-invasive local setup:
 
 ```bash
 node --experimental-strip-types src/cli.ts bootstrap --install-daemon false --configure-mcp false --install-hooks false
 ```
 
-Common local flows:
+### Common local flows
 
 ```bash
 node --experimental-strip-types src/cli.ts resume --agent codex
@@ -57,9 +66,7 @@ node --experimental-strip-types src/cli.ts checkpoint --reason "milestone"
 node --experimental-strip-types src/cli.ts handoff
 ```
 
-Do not initialize tracked `.holistic/` runtime state in this repo, and do not use a visible `holistic/state` branch here for self-dogfooding.
-
-For normal user repos, tracked `.holistic/` runtime plus the hidden portable state ref (`refs/holistic/state`) is the standard path. This product repo itself should stay public, clean, and main-only.
+For normal user repos, tracked `.holistic/` runtime plus the hidden portable state ref (`refs/holistic/state`) remains the standard path.
 
 ## Contribution guidelines
 

package/README.md

@@ -12,33 +12,52 @@ Your repo remembers, so your next agent doesn't have to guess.
 Shared memory for AI agents, built into your repo.
 ```
 
-### One command. Every agent. Zero re-explaining.
+### One command. Every agent. Zero re-explaining. ✨
 
 Holistic gives your AI agents shared memory inside the repo itself. When you switch from Claude to Codex to Gemini, the next agent can see what happened last time, what not to break, and what should happen next.
 
-## Public repo hygiene
+---
+
+## Get started in 30 seconds ⚡
+
+Open your project repo in PowerShell, Terminal, Command Prompt, or whatever shell you normally use.
+
+Requires Node.js 24+.
+
+Run these two commands:
+
+```bash
+npm install -g holistic
+holistic bootstrap
+```
+
+After that, open the repo in your agent app and use this startup prompt:
 
-The Holistic product repo is a special case when it dogfoods itself.
+```text
+Before doing any other work, read AGENTS.md and HOLISTIC.md, recap the current state briefly, and ask me exactly one question: continue as planned, tweak the plan, or start something new.
+```
 
-Normal user repos may commit portable Holistic runtime files and sync them through a dedicated portable git ref. This public repo should not ship a contributor's personal session history, handoff state, or live dogfooding runtime files. Self-dogfooding on this repo is redirected to ignored local files instead.
+That is enough to get the basic Holistic workflow working.
+
+If you want the fuller install and setup details, jump to [Quick start](#quick-start-).
 
 ---
 
-## The problem
+## The problem 😵
 
 If you use more than one AI coding assistant, the workflow usually falls apart:
 
-- You re-explain the project every session.
-- Bugs come back because the next agent does not know what was already fixed.
-- Progress gets lost when context windows end.
-- Agents undo each other because there is no durable handoff.
-- It is hard to tell what is actually done.
+- 🔁 You re-explain the project every session.
+- 🐞 Bugs come back because the next agent does not know what was already fixed.
+- 🧠 Progress gets lost when context windows end.
+- 💥 Agents undo each other because there is no durable handoff.
+- 🌫️ It is hard to tell what is actually done.
 
 Holistic fixes that by making the repo the source of truth.
 
 ---
 
-## What it feels like now
+## What it feels like now 🌿
 
 Run one setup command on a machine:
 
@@ -59,7 +78,7 @@ Most days, you do not need to run `npm start`, keep a terminal process open, or
 
 ---
 
-## How it works
+## How it works 🧭
 
 ```text
 holistic bootstrap
@@ -79,9 +98,9 @@ The next agent picks up without a long re-explanation
 
 ---
 
-## Quick start
+## Quick start 🚀
 
-### Install
+### Install 📦
 
 Requires Node.js 24+.
 
@@ -113,7 +132,7 @@ npm install
 npm link
 ```
 
-### Set up a repo
+### Set up a repo 🛠️
 
 ```bash
 cd my-project
@@ -147,21 +166,13 @@ holistic bootstrap --install-daemon false --configure-mcp false
 - `.holistic/sessions/` - session history files
 
 **What NOT to commit:**
-- `.holistic/system/*.sh` and `.holistic/system/*.ps1` - machine-local scripts with absolute paths (already in `.gitignore`)
+- `.holistic/system/` - machine-local helper scripts and wrappers with absolute paths (already in `.gitignore`)
 
 The portable repo memory is meant to be committed and synced. Machine-local helper scripts are generated for each machine and stay local.
 
-After that, open the repo in your agent app and use a startup prompt like:
-
-```text
-Before doing any other work, read AGENTS.md and HOLISTIC.md, recap the current state briefly, and ask me exactly one question: continue as planned, tweak the plan, or start something new.
-```
-
-That is enough for normal repo-first continuity.
-
 ---
 
-## Daily workflow
+## Daily workflow 🔄
 
 One-time machine setup:
 
@@ -184,9 +195,14 @@ holistic checkpoint --reason "..."
 holistic handoff
 ```
 
+If `holistic` is not on `PATH` in a given shell, every bootstrapped repo also has a repo-local fallback:
+
+- Windows: `.\.holistic\system\holistic.cmd <command>`
+- macOS/Linux: `./.holistic/system/holistic <command>`
+
 ---
 
-## Regression protection
+## Regression protection 🛡️
 
 When an agent fixes something delicate, lock it in:
 
@@ -201,7 +217,7 @@ Future agents will see that warning in the repo docs before they touch the risky
 
 ---
 
-## Works with multiple agent apps
+## Works with multiple agent apps 🤝
 
 Holistic is model-agnostic. It works through repo files first, and can also expose a thin MCP server where supported.
 
@@ -215,7 +231,7 @@ Holistic is model-agnostic. It works through repo files first, and can also expo
 
 ---
 
-## What lives in your repo
+## What lives in your repo 🗂️
 
 ```text
 my-project/
@@ -234,7 +250,7 @@ my-project/
       `- adapters/
 ```
 
-The portable repo memory (config, state, context, sessions) is meant to be committed and synced. Machine-local helper scripts under `.holistic/system/` are generated for each machine and stay local (already in `.gitignore`).
+The portable repo memory (config, state, context, sessions) is meant to be committed and synced. Machine-local helper scripts and repo-local CLI fallbacks under `.holistic/system/` are generated for each machine and stay local (already in `.gitignore`).
 
 ---
 

package/bin/holistic.js

@@ -1,59 +1,90 @@
-#!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import fs from "node:fs";
-import path from "node:path";
-
-const currentFile = fileURLToPath(import.meta.url);
-const repoRoot = path.resolve(path.dirname(currentFile), "..");
-const cliPath = path.resolve(repoRoot, "dist/cli.js");
-const args = process.argv.slice(2);
-const result = spawnSync(process.execPath, [cliPath, ...args], {
-  stdio: "inherit",
-  cwd: process.cwd(),
-});
-
-if (result.status !== 0) {
-  process.exit(result.status ?? 1);
-}
-
-if (args[0] === "handoff") {
-  const pendingCommitPath = path.join(process.cwd(), ".holistic", "context", "pending-commit.txt");
-  if (fs.existsSync(pendingCommitPath)) {
-    const message = fs.readFileSync(pendingCommitPath, "utf8").split(/\r?\n/)[0]?.trim();
-    if (message) {
-      const addResult = spawnSync("git", ["add", "--", "HOLISTIC.md", "AGENTS.md", ".holistic"], {
-        stdio: "inherit",
-        cwd: process.cwd(),
-      });
-      if ((addResult.status ?? 1) === 0) {
-        const commitResult = spawnSync("git", ["commit", "-m", message], {
-          stdio: "inherit",
-          cwd: process.cwd(),
-        });
-        if ((commitResult.status ?? 1) === 0) {
-          const syncScript = path.join(process.cwd(), ".holistic", "system", process.platform === "win32" ? "sync-state.ps1" : "sync-state.sh");
-          if (fs.existsSync(syncScript)) {
-            if (process.platform === "win32") {
-              spawnSync("powershell", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", syncScript], {
-                stdio: "inherit",
-                cwd: process.cwd(),
-              });
-            } else {
-              spawnSync("/bin/sh", [syncScript], {
-                stdio: "inherit",
-                cwd: process.cwd(),
-              });
-            }
-          }
-          spawnSync(process.execPath, [cliPath, "internal-mark-commit", "--message", message], {
-            stdio: "inherit",
-            cwd: process.cwd(),
-          });
-        }
-      }
-    }
-  }
-}
-
-process.exit(0);
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import fs from "node:fs";
+import path from "node:path";
+
+const currentFile = fileURLToPath(import.meta.url);
+const repoRoot = path.resolve(path.dirname(currentFile), "..");
+const cliPath = path.resolve(repoRoot, "dist/cli.js");
+const args = process.argv.slice(2);
+const result = spawnSync(process.execPath, [cliPath, ...args], {
+  stdio: "inherit",
+  cwd: process.cwd(),
+});
+
+if (result.status !== 0) {
+  process.exit(result.status ?? 1);
+}
+
+/**
+ * Resolve the Holistic directory and tracked file names for the current repo.
+ * Reads holistic.repo.json if present, otherwise falls back to defaults.
+ */
+function resolveRepoPaths(rootDir) {
+  const defaults = {
+    holisticDir: ".holistic",
+    masterDoc: "HOLISTIC.md",
+    agentsDoc: "AGENTS.md",
+  };
+
+  const configPath = path.join(rootDir, "holistic.repo.json");
+  if (fs.existsSync(configPath)) {
+    try {
+      const config = JSON.parse(fs.readFileSync(configPath, "utf8"));
+      const runtime = config.runtime ?? {};
+      return {
+        holisticDir: runtime.holisticDir ?? defaults.holisticDir,
+        masterDoc: runtime.masterDoc ?? defaults.masterDoc,
+        agentsDoc: runtime.agentsDoc ?? defaults.agentsDoc,
+      };
+    } catch {
+      // Fall through to defaults on corrupt config.
+    }
+  }
+
+  return defaults;
+}
+
+if (args[0] === "handoff") {
+  const rootDir = process.cwd();
+  const repoPaths = resolveRepoPaths(rootDir);
+  const pendingCommitPath = path.join(rootDir, repoPaths.holisticDir, "context", "pending-commit.txt");
+  if (fs.existsSync(pendingCommitPath)) {
+    const message = fs.readFileSync(pendingCommitPath, "utf8").split(/\r?\n/)[0]?.trim();
+    if (message) {
+      const addResult = spawnSync("git", ["add", "--", repoPaths.masterDoc, repoPaths.agentsDoc, repoPaths.holisticDir], {
+        stdio: "inherit",
+        cwd: rootDir,
+      });
+      if ((addResult.status ?? 1) === 0) {
+        const commitResult = spawnSync("git", ["commit", "-m", message], {
+          stdio: "inherit",
+          cwd: rootDir,
+        });
+        if ((commitResult.status ?? 1) === 0) {
+          const syncScript = path.join(rootDir, repoPaths.holisticDir, "system", process.platform === "win32" ? "sync-state.ps1" : "sync-state.sh");
+          if (fs.existsSync(syncScript)) {
+            if (process.platform === "win32") {
+              spawnSync("powershell", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", syncScript], {
+                stdio: "inherit",
+                cwd: rootDir,
+              });
+            } else {
+              spawnSync("/bin/sh", [syncScript], {
+                stdio: "inherit",
+                cwd: rootDir,
+              });
+            }
+          }
+          spawnSync(process.execPath, [cliPath, "internal-mark-commit", "--message", message], {
+            stdio: "inherit",
+            cwd: rootDir,
+          });
+        }
+      }
+    }
+  }
+}
+
+process.exit(0);

package/dist/__tests__/mcp-notification.test.js

@@ -248,7 +248,7 @@ export const tests = [
             });
             const greeting = buildStartupGreeting(state, "claude");
             assert.ok(greeting);
-            assert.match(greeting, /Recommended command: holistic resume --continue/);
+            assert.match(greeting, /Recommended command: Windows `?\.\\\.holistic\\system\\holistic\.cmd resume --continue`?; macOS\/Linux `?\.\/\.holistic\/system\/holistic resume --continue`?/);
         },
     },
 ];

package/dist/__tests__/mcp-notification.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-notification.test.js","sourceRoot":"","sources":["../../src/__tests__/mcp-notification.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-notification.test.js","sourceRoot":"","sources":["../../src/__tests__/mcp-notification.test.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAA4C,YAAY,EAAE,aAAa,EAAgB,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAoFvJ,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAyED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAcnG;AAMD,wBAAgB,UAAU,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAoE1G;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA4DzD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAA4C,YAAY,EAAE,aAAa,EAAgB,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AA+FvJ,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAyED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAcnG;AAMD,wBAAgB,UAAU,CAAC,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAoE1G;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA4DzD"}

package/dist/cli.js

@@ -1,7 +1,9 @@
+import fs from "node:fs";
 import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 import { fileURLToPath, pathToFileURL } from "node:url";
+import { renderRepoLocalCliCommands } from './core/cli-fallback.js';
 import { captureRepoSnapshot, clearPendingCommit, writePendingCommit } from './core/git.js';
 import { writeDerivedDocs } from './core/docs.js';
 import { bootstrapHolistic, initializeHolistic, refreshHolisticHooks } from './core/setup.js';
@@ -54,8 +56,19 @@ function asAgent(value) {
 function printJson(payload) {
     process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
 }
+function getVersion() {
+    const currentFile = fileURLToPath(import.meta.url);
+    const packagePath = path.resolve(path.dirname(currentFile), "..", "package.json");
+    try {
+        const pkg = JSON.parse(fs.readFileSync(packagePath, "utf8"));
+        return pkg.version ?? "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
 function printHelp() {
-    process.stdout.write(`Holistic CLI
+    process.stdout.write(`Holistic CLI v${getVersion()}
 
 Usage:
   holistic init [--install-daemon] [--install-hooks] [--platform win32|darwin|linux] [--interval 30] [--remote origin] [--state-ref refs/holistic/state] [--state-branch holistic/state]
@@ -63,15 +76,15 @@ Usage:
   holistic start [--agent codex|claude|antigravity|gemini|copilot|cursor|goose|gsd] [--continue] [--json]
   holistic resume [--agent codex|claude|antigravity|gemini|copilot|cursor|goose|gsd] [--continue] [--json]
   holistic checkpoint --reason "<reason>" [--goal "<goal>"] [--status "<status>"] [--plan "<step>"]...
-  holistic checkpoint --fixed "<bug>" [--fix-files "<file>"] [--fix-risk "<what reintroduces it>"]
-  holistic handoff [--draft] [--summary "<summary>"] [--next "<step>"]...
-  holistic start-new --goal "<goal>" [--title "<title>"] [--plan "<step>"]...
-  holistic status
-  holistic diff --from "<session-id>" --to "<session-id>" [--format text|json]
-  holistic serve
-  holistic watch [--agent codex|claude|antigravity|gemini|copilot|cursor|goose|gsd] [--interval 60]
-
-  'holistic start' is an alias for 'holistic resume'.
+  holistic checkpoint --fixed "<bug>" [--fix-files "<file>"] [--fix-risk "<what reintroduces it>"]
+  holistic handoff [--draft] [--summary "<summary>"] [--next "<step>"]...
+  holistic start-new --goal "<goal>" [--title "<title>"] [--plan "<step>"]...
+  holistic status
+  holistic diff --from "<session-id>" --to "<session-id>" [--format text|json]
+  holistic serve
+  holistic watch [--agent codex|claude|antigravity|gemini|copilot|cursor|goose|gsd] [--interval 60]
+
+  'holistic start' is an alias for 'holistic resume'.
 `);
 }
 export function renderResumeOutput(body) {
@@ -300,10 +313,12 @@ async function handleInit(rootDir, parsed) {
         showStatus: true,
         statusItems,
     });
-    process.stdout.write(`System files: ${result.systemDir}
-Config: ${result.configFile}
-Platform: ${result.platform}
-Daemon install: ${result.installed ? `enabled at ${result.startupTarget}` : "not installed"}
+    const initFallback = renderRepoLocalCliCommands(path.relative(rootDir, path.join(result.systemDir, "..", "context")).replaceAll("\\", "/"), "resume --agent codex");
+    process.stdout.write(`System files: ${result.systemDir}
+Config: ${result.configFile}
+Platform: ${result.platform}
+Daemon install: ${result.installed ? `enabled at ${result.startupTarget}` : "not installed"}
+Repo-local CLI: ${initFallback}
 `);
     if (result.gitHooksInstalled) {
         process.stdout.write(`Git hooks installed: ${result.gitHooks.join(", ")}\n`);
@@ -343,13 +358,15 @@ async function handleBootstrap(rootDir, parsed) {
         showStatus: true,
         statusItems,
     });
-    process.stdout.write(`System files: ${result.systemDir}
-Config: ${result.configFile}
-Platform: ${result.platform}
-Daemon install: ${result.installed ? `enabled at ${result.startupTarget}` : "not installed"}
-Git hooks: ${result.gitHooksInstalled ? result.gitHooks.join(", ") : "not installed"}
-MCP config: ${result.mcpConfigured ? result.mcpConfigFile : "skipped"}
-Checks: ${result.checks.join(", ")}
+    const bootstrapFallback = renderRepoLocalCliCommands(path.relative(rootDir, path.join(result.systemDir, "..", "context")).replaceAll("\\", "/"), "resume --agent codex");
+    process.stdout.write(`System files: ${result.systemDir}
+Config: ${result.configFile}
+Platform: ${result.platform}
+Daemon install: ${result.installed ? `enabled at ${result.startupTarget}` : "not installed"}
+Git hooks: ${result.gitHooksInstalled ? result.gitHooks.join(", ") : "not installed"}
+MCP config: ${result.mcpConfigured ? result.mcpConfigFile : "skipped"}
+Checks: ${result.checks.join(", ")}
+Repo-local CLI: ${bootstrapFallback}
 `);
     return 0;
 }
@@ -596,6 +613,11 @@ async function main() {
     const parsed = parseArgs(process.argv.slice(2));
     const rootDir = process.cwd();
     switch (parsed.command) {
+        case "version":
+        case "--version":
+        case "-v":
+            process.stdout.write(`${getVersion()}\n`);
+            return 0;
         case "init":
             return handleInit(rootDir, parsed);
         case "bootstrap":