v2026.3.57

Fixed

• Remove install-global hints from self-update (postinstall handles bootstrap)
• Template version bumped to 2.2.0 for refresh verification
• Remove packageRoot override from install-global and postinstall

v2026.3.56

Fixed

• Template refresh on install: install-global and postinstall were passing packageRoot pointing to @cleocode/cleo, but templates live in @cleocode/core. Bootstrap now resolves from core getPackageRoot() without override.

v2026.3.55

Fixed

• CRITICAL: CLEO-INJECTION.md template was stale in npm package — agents received old MCP-first template with deprecated memory brain.search operations. Template now correctly shows CLI-first, memory find, Runtime Environment section, and actual CLI command syntax.
• CLI command syntax in template — changed from wrong cleo <domain> <operation> to actual flat commands (cleo find, cleo current, cleo dash, etc.)
• Session quick reference — now shows CLI as primary with MCP fallback
• Memory examples — CLI-first (cleo memory find "auth" not MCP query)

v2026.3.54

Changed

• Dynamic template paths: All @ references in AGENTS.md now use getCleoTemplatesTildePath() — resolves to OS-appropriate XDG path (~/.local/share/cleo/templates on Linux, ~/Library/Application Support/cleo/templates on macOS). No more hardcoded ~/.cleo/templates/.
• getCleoTemplatesTildePath(): New path function that returns the templates dir as a ~-prefixed string for cross-platform @ references.

Fixed

• Template path mismatch: AGENTS.md referenced ~/.cleo/templates/ but templates live at XDG path (~/.local/share/cleo/templates/). Now both reference and storage use the same dynamic path.

v2026.3.53

Fixed

• Global config.json: Created from global-config.template.json during ensureGlobalHome() if missing.
• Stale templates/templates symlink: Added to STALE_GLOBAL_ENTRIES — was pointing to dev source in old installs.
• Stale .install-state/: Added to cleanup list.

v2026.3.52

Fixed

• Global scaffold cleanup works: Was cleaning XDG path (~/.local/share/cleo/) but stale dirs were at legacy ~/.cleo/ path. Now cleans both locations.
• CAAMP ^1.8.1: Consolidates pre-existing duplicate blocks natively. Removed workaround that stripped all CAAMP blocks before inject.

v2026.3.51

Fixed

• Postinstall bootstrap import: Fall back from @cleocode/core/internal (multi-file) to @cleocode/core (esbuild bundle) — dist/internal.js doesn't exist in published package.
• bootstrapGlobalCleo exported from public barrel: Now available via @cleocode/core import, not just @cleocode/core/internal.

v2026.3.50

Fixed

• Postinstall detection: Replaced broken process.argv[1] check with npm_config_global, lib/node_modules path check, and pnpm workspace marker detection.
• Postinstall import path: Changed from broken ../dist/core/bootstrap.js to @cleocode/core/internal which resolves correctly in published package.
• esbuild bundle dynamic import: Changed ensureGlobalHome() from dynamic import to static import so esbuild includes it in the single-file bundle.
• Global scaffold cleanup: Now actually runs during bootstrap — removes stale project-level dirs from ~/.cleo/.

v2026.3.49

Fixed

• CAAMP block duplication: Strip ALL existing CAAMP blocks before inject() — workaround for CAAMP not consolidating pre-existing duplicates (CAAMP issue #48)
• Global scaffold cleanup: Bootstrap now calls ensureGlobalHome() which removes stale project-level dirs from ~/.cleo/
• Stale cleo-subagent symlink: Now detects symlinks pointing to wrong target and recreates them pointing to the npm package path

v2026.3.48

Added

• cleo detect command: Standalone lightweight re-detection of project type. Updates project-context.json without full init or upgrade.
• cleo upgrade --detect: Force re-detection ignoring staleness schedule.
• cleo upgrade --map-codebase: Run full codebase analysis and store findings to brain.db.
• cleo upgrade --name <name>: Programmatically update project name in project-info.json and nexus registry.
• updateProjectName(): Core function in project-info.ts (SSoT for project name updates).

Changed

• init/upgrade boundary: --update-docs removed from init. All maintenance goes through cleo upgrade.
• --refresh alias removed from init (keep flags simple, --detect only).
• Fix hints across injection.ts and doctor/checks.ts now say cleo upgrade instead of cleo init --update-docs.

Fixed

• CLI version: Now reads from package.json at runtime instead of build-time constant.
• stripCLEOBlocks: Handles versioned legacy markers (<!-- CLEO:START v0.53.4 -->).
• Global scaffold cleanup: Removes stale project-level dirs from ~/.cleo/ on bootstrap.
• cleo-subagent symlink: Installed via bootstrapGlobalCleo using require.resolve for npm package path.