v2026.3.36

Bug Fixes

• fix(publish): move @cleocode/core to devDependencies — workspace:* is a pnpm/yarn protocol that npm does not understand; when npm encountered it in the published tarball it crashed with EUNSUPPORTEDPROTOCOL on npm install -g @cleocode/cleo@latest. Since @cleocode/core is bundled inline by esbuild it is a build-time dep only and must not appear in the published runtime deps (T5724)

v2026.3.35

@cleocode/core Standalone Package (T5701)

• packages/core/ is now a true standalone npm package: consumers can import { Cleo } from '@cleocode/core' with no dependency on @cleocode/cleo
• Full Cleo facade class with all 10 domain APIs (tasks, sessions, memory, pipeline, orchestrate, check, tools, admin, nexus, sticky)
• Tree-shakeable barrel exports and custom store support via DataAccessor interface from @cleocode/contracts
• 70 source files rewired across dispatch/cli/mcp to import from @cleocode/core; purity CI gate enforced

CI Hardening (T5716)

• drizzle-orm + drizzle-kit upgraded to v1.0.0-beta.18
• closeLogger() is now async — awaits pino transport worker thread drain, eliminating ENOENT races on temp dir cleanup across macOS and Windows
• Test cleanup hardened across 8 test files: Promise.race with 8s timeout prevents fs.rm from blocking on Windows; await closeLogger() prevents pino ENOENT
• detectProvider tests use tmpdir() instead of hardcoded /tmp (Windows fix)

v2026.3.34

Phase 1: Cognitive Feedback Loops

• Brain-enriched session briefing: Added recentLearnings to SessionMemoryContext so session start briefings include relevant brain.db learnings (T5700)
• Brain-informed tasks.next scoring: tasks.next now scores candidates with +10 for success pattern matches and -5 for failure pattern matches from brain.db (T5700)
• NEXUS auto-registration at startup: Health check now auto-registers the current project in nexus.db if not already present (T5700)
• Grade-to-brain feedback loop: Weak grading dimensions and protocol violations are automatically stored as learnings in brain.db (T5700)
• Auto-grade on session end: Session end hooks now trigger automatic grading via the session-hooks handler (T5700)

Phase 2: Codebase Intelligence

• New src/core/codebase-map/ module: 7 analyzers — stack, architecture, structure, conventions, testing, integrations, and concerns (T5700)
• Brain.db persistence: Codebase analysis findings are stored in brain.db for cross-session recall (T5700)
• Markdown summary generation: cleo map produces human-readable codebase intelligence summaries (T5700)

Phase 3: Dispatch + CLI + Skill

• 2 new MCP operations: query admin.map + mutate admin.map (209 total: 119q + 90m) (T5700)
• cleo map CLI command: cleo map [--store] [--focus area] for codebase intelligence from the command line (T5700)
• cleo init --map-codebase: Brownfield auto-mapping during project initialization (T5700)
• ct-codebase-mapper skill: New tier 1 recommended skill for codebase mapping workflows (T5700)
• Routing table entry: admin.map added to the 53-entry skill routing table (T5700)

---

v2026.3.33

Auto-prepared by release.ship (T5698)

Features

• Create normalizeTaskId() SSoT utility with validation and tests: Create SSoT utility function normalizeTaskId() in src/core/tasks/task-id-utils.ts that accepts any task ID format and returns canonical "T1234". ... (T5587)
• Implement normalization across all task operations: Implement normalizeTaskId() across all identified operations. Update task lookup functions to normalize input before querying database. Ensure epic... (T5589)
• Implement automatic PR creation for protected branches: Implement automatic PR creation when branch protection blocks direct push. Use GitHub CLI (gh) if available, or provide clear manual instructions. ... (T5591)
• Implement multi-channel release support (@latest/@beta/@Alpha): Add release channel support to pipeline: @latest for main branch, @beta for develop branch, @Alpha for feature branches. Update release gates to va... (T5592)
• Implementation: tasks.list Core Optimization: Redesign tasks.list as the flagship optimized list operation. Implement: (1) Cursor-based pagination with stable ordering, (2) Smart field projecti... (T5621)
• Implementation: Session & Admin List Operations Standardization: Apply optimized patterns to session.list, admin.job.list, admin.adr.list, and admin.grade.list. Standardize on: consistent pagination metadata, MVI... (T5622)
• Implementation: Pipeline List Operations Enhancement: Enhance pipeline domain list operations: release.list, manifest.list, phase.list, chain.list. These handle larger datasets (manifest entries, relea... (T5623)
• Implementation: Remaining List Operations Compliance: Update remaining list operations to meet new standards: sticky.list, nexus.list, tools.skill.list, tools.provider.list, orchestrate.tessera.list, t... (T5624)

Bug Fixes

• MCP response payload optimization — ranked blockedTasks, compact admin help, domain pagination: Reduce MCP response sizes and improve data quality across domains: - admin help: compact domain-grouped format by default (~85% token reduction), v... (T5584)
• Fix Layer 1 gate validator rejecting valid non-task status values: Layer 1 schema validator checked all status params against TASK_STATUSES regardless of domain. Operations like pipeline.stage.record with valid lif... (T5598)
• Fix missing drizzle-brain symlink for brain.db initialization: brain.db was 0 bytes because drizzle-brain symlink was missing at project root. The drizzle symlink for tasks.db existed correctly but drizzle-brai... (T5650)
• BUG: Remove projects-registry.json and wire nexus.db as canonical cross-project store: ~/.cleo/projects-registry.json is the old registry and MUST be fully deleted. nexus.db is canonical but not properly wired. Agents hit nexus tier-2... (T5656)
• Fix 5 red-team bugs + comprehensive vision validation: Fix 5 bugs found during red-team E2E testing: (1) AGENTS.md not created without provider, (2) session engine auto-ends before scope validation, (3)... (T5698)

Documentation

• Add agent guidance and workflow visualization to release command: Enhance release.ship output with clear agent guidance and next steps. Add --guided flag for step-by-step mode. Show progress through workflow stage... (T5593)
• Documentation: Migration Guide & Agent Communication: Create comprehensive documentation for the LOOM Pipeline changes: (1) Migration guide for existing agent workflows using list operations, (2) Updat... (T5626)

Tests

• Testing & Validation: LOOM Pipeline Integration Suite: Create comprehensive test suite for optimized list operations. Include: token usage benchmarks (before/after comparison), pagination correctness te... (T5625)

Chores

• Decide keep or remove outcomes for session operations: Decide which session operations should stay, merge, parameterize, or disappear, and record any naming or contract changes needed to keep session co... (T5537)
• Decide keep or remove outcomes for memory operations: Produce a disposition for each memory operation, including merges, removals, or plugin moves, plus any help-tier or contract changes required for a... (T5541)

Changes

• Inventory session operations and map agent workflows: Inventory session operations across lifecycle, continuity, drift detection, handoff, and decision recording so the current surface is tied to real ... (T5535)
• Challenge session operations against LAFS and MVI: Challenge the session domain against LAFS, progressive disclosure, and MVI with special attention to what an agent must know at start, resume, susp... (T5536)
• Inventory memory operations and map agent workflows: Inventory memory operations across retrieval, manifest access, contradiction handling, supersession, and mutation so the domain can be evaluated ag... (T5539)
• Challenge memory operations against LAFS and MVI: Challenge the memory domain against LAFS, progressive disclosure, and MVI to make sure agents get useful recall signals without excessive cognitive... (T5540)
• C: Synthesize all 10 domain reviews into unified consolidation decisions: After all 10 domain inventory + challenge tasks complete (T5530-T5566 children), synthesize findings into a single decision matrix. For every opera... (T5609)
• C: Design canonical agent decision tree for operation selection: LLM agents face a 267-op surface with no clear guidance on which operation to use for a given goal. This creates hallucination and ambiguity. Desig... (T5610)
• A: Write ADR for CLEO Operation Model Rationalization: Capture the architecture decision behind the operation consolidation: why the surface grew unbounded, what principles constrain it going forward, a... (T5611)
• S: Update CLEO-OPERATION-CONSTITUTION.md to reflect rationalized operation set: After consolidation decisions are finalized (T5609) and the ADR is written (T5611), update the Constitution to match the new operation set. Must up... (T5612)
• I: Rewrite ct-cleo skill with canonical decision tree and correct domain refs: Full rewrite of packages/ct-skills/skills/ct-cleo/SKILL.md based on T5607 audit and T5610 decision tree. Requirements: (1) Remove all stale domain ... (T5613)
• I: Rewrite CLEO-INJECTION.md for MVI token-conservative agent guidance: templates/CLEO-INJECTION.md is the cold-start protocol injected into every agent. It must be ruthlessly token-conservative while surfacing exactly ... (T5614)
• Wire --bump-version into releaseShip() pipeline and fix release notes content: bumpVersionFromConfig() exists but is never called by releaseShip(). VERSION and package.json are bumped manually after the tag, backwards and erro... (T5617)
• Design Phase: LAFS Envelope Optimization Standards: Design optimized LAFS envelope structures specifically for list operations to minimize token waste. Define standard pagination metadata format, tru... (T5620)
• Scandir test (T5665)

---

v2026.3.32

Auto-prepared by release.ship (T5698)

Features

• Create normalizeTaskId() SSoT utility with validation and tests: Create SSoT utility function normalizeTaskId() in src/core/tasks/task-id-utils.ts that accepts any task ID format and returns canonical "T1234". ... (T5587)
• Implement normalization across all task operations: Implement normalizeTaskId() across all identified operations. Update task lookup functions to normalize input before querying database. Ensure epic... (T5589)
• Implement automatic PR creation for protected branches: Implement automatic PR creation when branch protection blocks direct push. Use GitHub CLI (gh) if available, or provide clear manual instructions. ... (T5591)
• Implement multi-channel release support (@latest/@beta/@Alpha): Add release channel support to pipeline: @latest for main branch, @beta for develop branch, @Alpha for feature branches. Update release gates to va... (T5592)
• Implementation: tasks.list Core Optimization: Redesign tasks.list as the flagship optimized list operation. Implement: (1) Cursor-based pagination with stable ordering, (2) Smart field projecti... (T5621)
• Implementation: Session & Admin List Operations Standardization: Apply optimized patterns to session.list, admin.job.list, admin.adr.list, and admin.grade.list. Standardize on: consistent pagination metadata, MVI... (T5622)
• Implementation: Pipeline List Operations Enhancement: Enhance pipeline domain list operations: release.list, manifest.list, phase.list, chain.list. These handle larger datasets (manifest entries, relea... (T5623)
• Implementation: Remaining List Operations Compliance: Update remaining list operations to meet new standards: sticky.list, nexus.list, tools.skill.list, tools.provider.list, orchestrate.tessera.list, t... (T5624)

Bug Fixes

• MCP response payload optimization — ranked blockedTasks, compact admin help, domain pagination: Reduce MCP response sizes and improve data quality across domains: - admin help: compact domain-grouped format by default (~85% token reduction), v... (T5584)
• Fix Layer 1 gate validator rejecting valid non-task status values: Layer 1 schema validator checked all status params against TASK_STATUSES regardless of domain. Operations like pipeline.stage.record with valid lif... (T5598)
• Fix missing drizzle-brain symlink for brain.db initialization: brain.db was 0 bytes because drizzle-brain symlink was missing at project root. The drizzle symlink for tasks.db existed correctly but drizzle-brai... (T5650)
• BUG: Remove projects-registry.json and wire nexus.db as canonical cross-project store: ~/.cleo/projects-registry.json is the old registry and MUST be fully deleted. nexus.db is canonical but not properly wired. Agents hit nexus tier-2... (T5656)
• Fix 5 red-team bugs + comprehensive vision validation: Fix 5 bugs found during red-team E2E testing: (1) AGENTS.md not created without provider, (2) session engine auto-ends before scope validation, (3)... (T5698)

Documentation

• Add agent guidance and workflow visualization to release command: Enhance release.ship output with clear agent guidance and next steps. Add --guided flag for step-by-step mode. Show progress through workflow stage... (T5593)
• Documentation: Migration Guide & Agent Communication: Create comprehensive documentation for the LOOM Pipeline changes: (1) Migration guide for existing agent workflows using list operations, (2) Updat... (T5626)

Tests

• Testing & Validation: LOOM Pipeline Integration Suite: Create comprehensive test suite for optimized list operations. Include: token usage benchmarks (before/after comparison), pagination correctness te... (T5625)

Chores

• Decide keep or remove outcomes for session operations: Decide which session operations should stay, merge, parameterize, or disappear, and record any naming or contract changes needed to keep session co... (T5537)
• Decide keep or remove outcomes for memory operations: Produce a disposition for each memory operation, including merges, removals, or plugin moves, plus any help-tier or contract changes required for a... (T5541)

Changes

• Inventory session operations and map agent workflows: Inventory session operations across lifecycle, continuity, drift detection, handoff, and decision recording so the current surface is tied to real ... (T5535)
• Challenge session operations against LAFS and MVI: Challenge the session domain against LAFS, progressive disclosure, and MVI with special attention to what an agent must know at start, resume, susp... (T5536)
• Inventory memory operations and map agent workflows: Inventory memory operations across retrieval, manifest access, contradiction handling, supersession, and mutation so the domain can be evaluated ag... (T5539)
• Challenge memory operations against LAFS and MVI: Challenge the memory domain against LAFS, progressive disclosure, and MVI to make sure agents get useful recall signals without excessive cognitive... (T5540)
• C: Synthesize all 10 domain reviews into unified consolidation decisions: After all 10 domain inventory + challenge tasks complete (T5530-T5566 children), synthesize findings into a single decision matrix. For every opera... (T5609)
• C: Design canonical agent decision tree for operation selection: LLM agents face a 267-op surface with no clear guidance on which operation to use for a given goal. This creates hallucination and ambiguity. Desig... (T5610)
• A: Write ADR for CLEO Operation Model Rationalization: Capture the architecture decision behind the operation consolidation: why the surface grew unbounded, what principles constrain it going forward, a... (T5611)
• S: Update CLEO-OPERATION-CONSTITUTION.md to reflect rationalized operation set: After consolidation decisions are finalized (T5609) and the ADR is written (T5611), update the Constitution to match the new operation set. Must up... (T5612)
• I: Rewrite ct-cleo skill with canonical decision tree and correct domain refs: Full rewrite of packages/ct-skills/skills/ct-cleo/SKILL.md based on T5607 audit and T5610 decision tree. Requirements: (1) Remove all stale domain ... (T5613)
• I: Rewrite CLEO-INJECTION.md for MVI token-conservative agent guidance: templates/CLEO-INJECTION.md is the cold-start protocol injected into every agent. It must be ruthlessly token-conservative while surfacing exactly ... (T5614)
• Wire --bump-version into releaseShip() pipeline and fix release notes content: bumpVersionFromConfig() exists but is never called by releaseShip(). VERSION and package.json are bumped manually after the tag, backwards and erro... (T5617)
• Design Phase: LAFS Envelope Optimization Standards: Design optimized LAFS envelope structures specifically for list operations to minimize token waste. Define standard pagination metadata format, tru... (T5620)
• Scandir test (T5665)

---

v2026.3.31

Auto-prepared by release.ship (T5240)

Features

• Create normalizeTaskId() SSoT utility with validation and tests: Create SSoT utility function normalizeTaskId() in src/core/tasks/task-id-utils.ts that accepts any task ID format and returns canonical "T1234". ... (T5587)
• Implement normalization across all task operations: Implement normalizeTaskId() across all identified operations. Update task lookup functions to normalize input before querying database. Ensure epic... (T5589)
• Implement automatic PR creation for protected branches: Implement automatic PR creation when branch protection blocks direct push. Use GitHub CLI (gh) if available, or provide clear manual instructions. ... (T5591)
• Implement multi-channel release support (@latest/@beta/@Alpha): Add release channel support to pipeline: @latest for main branch, @beta for develop branch, @Alpha for feature branches. Update release gates to va... (T5592)
• Implementation: tasks.list Core Optimization: Redesign tasks.list as the flagship optimized list operation. Implement: (1) Cursor-based pagination with stable ordering, (2) Smart field projecti... (T5621)
• Implementation: Session & Admin List Operations Standardization: Apply optimized patterns to session.list, admin.job.list, admin.adr.list, and admin.grade.list. Standardize on: consistent pagination metadata, MVI... (T5622)
• Implementation: Pipeline List Operations Enhancement: Enhance pipeline domain list operations: release.list, manifest.list, phase.list, chain.list. These handle larger datasets (manifest entries, relea... (T5623)
• Implementation: Remaining List Operations Compliance: Update remaining list operations to meet new standards: sticky.list, nexus.list, tools.skill.list, tools.provider.list, orchestrate.tessera.list, t... (T5624)

Bug Fixes

• MCP response payload optimization — ranked blockedTasks, compact admin help, domain pagination: Reduce MCP response sizes and improve data quality across domains: - admin help: compact domain-grouped format by default (~85% token reduction), v... (T5584)
• Fix Layer 1 gate validator rejecting valid non-task status values: Layer 1 schema validator checked all status params against TASK_STATUSES regardless of domain. Operations like pipeline.stage.record with valid lif... (T5598)
• Fix missing drizzle-brain symlink for brain.db initialization: brain.db was 0 bytes because drizzle-brain symlink was missing at project root. The drizzle symlink for tasks.db existed correctly but drizzle-brai... (T5650)
• BUG: Remove projects-registry.json and wire nexus.db as canonical cross-project store: ~/.cleo/projects-registry.json is the old registry and MUST be fully deleted. nexus.db is canonical but not properly wired. Agents hit nexus tier-2... (T5656)

Documentation

• Add agent guidance and workflow visualization to release command: Enhance release.ship output with clear agent guidance and next steps. Add --guided flag for step-by-step mode. Show progress through workflow stage... (T5593)
• Documentation: Migration Guide & Agent Communication: Create comprehensive documentation for the LOOM Pipeline changes: (1) Migration guide for existing agent workflows using list operations, (2) Updat... (T5626)

Tests

• Testing & Validation: LOOM Pipeline Integration Suite: Create comprehensive test suite for optimized list operations. Include: token usage benchmarks (before/after comparison), pagination correctness te... (T5625)

Chores

• Decide keep or remove outcomes for session operations: Decide which session operations should stay, merge, parameterize, or disappear, and record any naming or contract changes needed to keep session co... (T5537)
• Decide keep or remove outcomes for memory operations: Produce a disposition for each memory operation, including merges, removals, or plugin moves, plus any help-tier or contract changes required for a... (T5541)

Changes

• Inventory session operations and map agent workflows: Inventory session operations across lifecycle, continuity, drift detection, handoff, and decision recording so the current surface is tied to real ... (T5535)
• Challenge session operations against LAFS and MVI: Challenge the session domain against LAFS, progressive disclosure, and MVI with special attention to what an agent must know at start, resume, susp... (T5536)
• Inventory memory operations and map agent workflows: Inventory memory operations across retrieval, manifest access, contradiction handling, supersession, and mutation so the domain can be evaluated ag... (T5539)
• Challenge memory operations against LAFS and MVI: Challenge the memory domain against LAFS, progressive disclosure, and MVI to make sure agents get useful recall signals without excessive cognitive... (T5540)
• C: Synthesize all 10 domain reviews into unified consolidation decisions: After all 10 domain inventory + challenge tasks complete (T5530-T5566 children), synthesize findings into a single decision matrix. For every opera... (T5609)
• C: Design canonical agent decision tree for operation selection: LLM agents face a 267-op surface with no clear guidance on which operation to use for a given goal. This creates hallucination and ambiguity. Desig... (T5610)
• A: Write ADR for CLEO Operation Model Rationalization: Capture the architecture decision behind the operation consolidation: why the surface grew unbounded, what principles constrain it going forward, a... (T5611)
• S: Update CLEO-OPERATION-CONSTITUTION.md to reflect rationalized operation set: After consolidation decisions are finalized (T5609) and the ADR is written (T5611), update the Constitution to match the new operation set. Must up... (T5612)
• I: Rewrite ct-cleo skill with canonical decision tree and correct domain refs: Full rewrite of packages/ct-skills/skills/ct-cleo/SKILL.md based on T5607 audit and T5610 decision tree. Requirements: (1) Remove all stale domain ... (T5613)
• I: Rewrite CLEO-INJECTION.md for MVI token-conservative agent guidance: templates/CLEO-INJECTION.md is the cold-start protocol injected into every agent. It must be ruthlessly token-conservative while surfacing exactly ... (T5614)
• Wire --bump-version into releaseShip() pipeline and fix release notes content: bumpVersionFromConfig() exists but is never called by releaseShip(). VERSION and package.json are bumped manually after the tag, backwards and erro... (T5617)
• Design Phase: LAFS Envelope Optimization Standards: Design optimized LAFS envelope structures specifically for list operations to minimize token waste. Define standard pagination metadata format, tru... (T5620)
• Scandir test (T5665)

---

v2026.3.30

Auto-prepared by release.ship (T5240)

Features

• Create normalizeTaskId() SSoT utility with validation and tests: Create SSoT utility function normalizeTaskId() in src/core/tasks/task-id-utils.ts that accepts any task ID format and returns canonical "T1234". ... (T5587)
• Implement normalization across all task operations: Implement normalizeTaskId() across all identified operations. Update task lookup functions to normalize input before querying database. Ensure epic... (T5589)
• Implement automatic PR creation for protected branches: Implement automatic PR creation when branch protection blocks direct push. Use GitHub CLI (gh) if available, or provide clear manual instructions. ... (T5591)
• Implement multi-channel release support (@latest/@beta/@Alpha): Add release channel support to pipeline: @latest for main branch, @beta for develop branch, @Alpha for feature branches. Update release gates to va... (T5592)
• Implementation: tasks.list Core Optimization: Redesign tasks.list as the flagship optimized list operation. Implement: (1) Cursor-based pagination with stable ordering, (2) Smart field projecti... (T5621)
• Implementation: Session & Admin List Operations Standardization: Apply optimized patterns to session.list, admin.job.list, admin.adr.list, and admin.grade.list. Standardize on: consistent pagination metadata, MVI... (T5622)
• Implementation: Pipeline List Operations Enhancement: Enhance pipeline domain list operations: release.list, manifest.list, phase.list, chain.list. These handle larger datasets (manifest entries, relea... (T5623)
• Implementation: Remaining List Operations Compliance: Update remaining list operations to meet new standards: sticky.list, nexus.list, tools.skill.list, tools.provider.list, orchestrate.tessera.list, t... (T5624)

Bug Fixes

• MCP response payload optimization — ranked blockedTasks, compact admin help, domain pagination: Reduce MCP response sizes and improve data quality across domains: - admin help: compact domain-grouped format by default (~85% token reduction), v... (T5584)
• Fix Layer 1 gate validator rejecting valid non-task status values: Layer 1 schema validator checked all status params against TASK_STATUSES regardless of domain. Operations like pipeline.stage.record with valid lif... (T5598)
• Fix missing drizzle-brain symlink for brain.db initialization: brain.db was 0 bytes because drizzle-brain symlink was missing at project root. The drizzle symlink for tasks.db existed correctly but drizzle-brai... (T5650)
• BUG: Remove projects-registry.json and wire nexus.db as canonical cross-project store: ~/.cleo/projects-registry.json is the old registry and MUST be fully deleted. nexus.db is canonical but not properly wired. Agents hit nexus tier-2... (T5656)

Documentation

• Add agent guidance and workflow visualization to release command: Enhance release.ship output with clear agent guidance and next steps. Add --guided flag for step-by-step mode. Show progress through workflow stage... (T5593)
• Documentation: Migration Guide & Agent Communication: Create comprehensive documentation for the LOOM Pipeline changes: (1) Migration guide for existing agent workflows using list operations, (2) Updat... (T5626)

Tests

• Testing & Validation: LOOM Pipeline Integration Suite: Create comprehensive test suite for optimized list operations. Include: token usage benchmarks (before/after comparison), pagination correctness te... (T5625)

Chores

• Decide keep or remove outcomes for session operations: Decide which session operations should stay, merge, parameterize, or disappear, and record any naming or contract changes needed to keep session co... (T5537)
• Decide keep or remove outcomes for memory operations: Produce a disposition for each memory operation, including merges, removals, or plugin moves, plus any help-tier or contract changes required for a... (T5541)

Changes

• Inventory session operations and map agent workflows: Inventory session operations across lifecycle, continuity, drift detection, handoff, and decision recording so the current surface is tied to real ... (T5535)
• Challenge session operations against LAFS and MVI: Challenge the session domain against LAFS, progressive disclosure, and MVI with special attention to what an agent must know at start, resume, susp... (T5536)
• Inventory memory operations and map agent workflows: Inventory memory operations across retrieval, manifest access, contradiction handling, supersession, and mutation so the domain can be evaluated ag... (T5539)
• Challenge memory operations against LAFS and MVI: Challenge the memory domain against LAFS, progressive disclosure, and MVI to make sure agents get useful recall signals without excessive cognitive... (T5540)
• C: Synthesize all 10 domain reviews into unified consolidation decisions: After all 10 domain inventory + challenge tasks complete (T5530-T5566 children), synthesize findings into a single decision matrix. For every opera... (T5609)
• C: Design canonical agent decision tree for operation selection: LLM agents face a 267-op surface with no clear guidance on which operation to use for a given goal. This creates hallucination and ambiguity. Desig... (T5610)
• A: Write ADR for CLEO Operation Model Rationalization: Capture the architecture decision behind the operation consolidation: why the surface grew unbounded, what principles constrain it going forward, a... (T5611)
• S: Update CLEO-OPERATION-CONSTITUTION.md to reflect rationalized operation set: After consolidation decisions are finalized (T5609) and the ADR is written (T5611), update the Constitution to match the new operation set. Must up... (T5612)
• I: Rewrite ct-cleo skill with canonical decision tree and correct domain refs: Full rewrite of packages/ct-skills/skills/ct-cleo/SKILL.md based on T5607 audit and T5610 decision tree. Requirements: (1) Remove all stale domain ... (T5613)
• I: Rewrite CLEO-INJECTION.md for MVI token-conservative agent guidance: templates/CLEO-INJECTION.md is the cold-start protocol injected into every agent. It must be ruthlessly token-conservative while surfacing exactly ... (T5614)
• Wire --bump-version into releaseShip() pipeline and fix release notes content: bumpVersionFromConfig() exists but is never called by releaseShip(). VERSION and package.json are bumped manually after the tag, backwards and erro... (T5617)
• Design Phase: LAFS Envelope Optimization Standards: Design optimized LAFS envelope structures specifically for list operations to minimize token waste. Define standard pagination metadata format, tru... (T5620)
• Scandir test (T5665)

---

v2026.3.29

Auto-prepared by release.ship (T5240)

Features

• Create normalizeTaskId() SSoT utility with validation and tests: Create SSoT utility function normalizeTaskId() in src/core/tasks/task-id-utils.ts that accepts any task ID format and returns canonical "T1234". ... (T5587)
• Implement normalization across all task operations: Implement normalizeTaskId() across all identified operations. Update task lookup functions to normalize input before querying database. Ensure epic... (T5589)
• Implement automatic PR creation for protected branches: Implement automatic PR creation when branch protection blocks direct push. Use GitHub CLI (gh) if available, or provide clear manual instructions. ... (T5591)
• Implement multi-channel release support (@latest/@beta/@Alpha): Add release channel support to pipeline: @latest for main branch, @beta for develop branch, @Alpha for feature branches. Update release gates to va... (T5592)
• Implementation: tasks.list Core Optimization: Redesign tasks.list as the flagship optimized list operation. Implement: (1) Cursor-based pagination with stable ordering, (2) Smart field projecti... (T5621)
• Implementation: Session & Admin List Operations Standardization: Apply optimized patterns to session.list, admin.job.list, admin.adr.list, and admin.grade.list. Standardize on: consistent pagination metadata, MVI... (T5622)
• Implementation: Pipeline List Operations Enhancement: Enhance pipeline domain list operations: release.list, manifest.list, phase.list, chain.list. These handle larger datasets (manifest entries, relea... (T5623)
• Implementation: Remaining List Operations Compliance: Update remaining list operations to meet new standards: sticky.list, nexus.list, tools.skill.list, tools.provider.list, orchestrate.tessera.list, t... (T5624)

Bug Fixes

• MCP response payload optimization — ranked blockedTasks, compact admin help, domain pagination: Reduce MCP response sizes and improve data quality across domains: - admin help: compact domain-grouped format by default (~85% token reduction), v... (T5584)
• Fix Layer 1 gate validator rejecting valid non-task status values: Layer 1 schema validator checked all status params against TASK_STATUSES regardless of domain. Operations like pipeline.stage.record with valid lif... (T5598)
• Fix missing drizzle-brain symlink for brain.db initialization: brain.db was 0 bytes because drizzle-brain symlink was missing at project root. The drizzle symlink for tasks.db existed correctly but drizzle-brai... (T5650)
• BUG: Remove projects-registry.json and wire nexus.db as canonical cross-project store: ~/.cleo/projects-registry.json is the old registry and MUST be fully deleted. nexus.db is canonical but not properly wired. Agents hit nexus tier-2... (T5656)

Documentation

• Add agent guidance and workflow visualization to release command: Enhance release.ship output with clear agent guidance and next steps. Add --guided flag for step-by-step mode. Show progress through workflow stage... (T5593)
• Documentation: Migration Guide & Agent Communication: Create comprehensive documentation for the LOOM Pipeline changes: (1) Migration guide for existing agent workflows using list operations, (2) Updat... (T5626)

Tests

• Testing & Validation: LOOM Pipeline Integration Suite: Create comprehensive test suite for optimized list operations. Include: token usage benchmarks (before/after comparison), pagination correctness te... (T5625)

Chores

• Decide keep or remove outcomes for session operations: Decide which session operations should stay, merge, parameterize, or disappear, and record any naming or contract changes needed to keep session co... (T5537)
• Decide keep or remove outcomes for memory operations: Produce a disposition for each memory operation, including merges, removals, or plugin moves, plus any help-tier or contract changes required for a... (T5541)

Changes

• Inventory session operations and map agent workflows: Inventory session operations across lifecycle, continuity, drift detection, handoff, and decision recording so the current surface is tied to real ... (T5535)
• Challenge session operations against LAFS and MVI: Challenge the session domain against LAFS, progressive disclosure, and MVI with special attention to what an agent must know at start, resume, susp... (T5536)
• Inventory memory operations and map agent workflows: Inventory memory operations across retrieval, manifest access, contradiction handling, supersession, and mutation so the domain can be evaluated ag... (T5539)
• Challenge memory operations against LAFS and MVI: Challenge the memory domain against LAFS, progressive disclosure, and MVI to make sure agents get useful recall signals without excessive cognitive... (T5540)
• C: Synthesize all 10 domain reviews into unified consolidation decisions: After all 10 domain inventory + challenge tasks complete (T5530-T5566 children), synthesize findings into a single decision matrix. For every opera... (T5609)
• C: Design canonical agent decision tree for operation selection: LLM agents face a 267-op surface with no clear guidance on which operation to use for a given goal. This creates hallucination and ambiguity. Desig... (T5610)
• A: Write ADR for CLEO Operation Model Rationalization: Capture the architecture decision behind the operation consolidation: why the surface grew unbounded, what principles constrain it going forward, a... (T5611)
• S: Update CLEO-OPERATION-CONSTITUTION.md to reflect rationalized operation set: After consolidation decisions are finalized (T5609) and the ADR is written (T5611), update the Constitution to match the new operation set. Must up... (T5612)
• I: Rewrite ct-cleo skill with canonical decision tree and correct domain refs: Full rewrite of packages/ct-skills/skills/ct-cleo/SKILL.md based on T5607 audit and T5610 decision tree. Requirements: (1) Remove all stale domain ... (T5613)
• I: Rewrite CLEO-INJECTION.md for MVI token-conservative agent guidance: templates/CLEO-INJECTION.md is the cold-start protocol injected into every agent. It must be ruthlessly token-conservative while surfacing exactly ... (T5614)
• Wire --bump-version into releaseShip() pipeline and fix release notes content: bumpVersionFromConfig() exists but is never called by releaseShip(). VERSION and package.json are bumped manually after the tag, backwards and erro... (T5617)
• Design Phase: LAFS Envelope Optimization Standards: Design optimized LAFS envelope structures specifically for list operations to minimize token waste. Define standard pagination metadata format, tru... (T5620)
• Scandir test (T5665)

---

v2026.3.28

CLEO brain context injection via CLAUDE.md + MCP Registry description fix (T5671)

Features

• Create normalizeTaskId() SSoT utility with validation and tests: Create SSoT utility function normalizeTaskId() in src/core/tasks/task-id-utils.ts that accepts any task ID format and returns canonical "T1234". ... (T5587)
• Implement normalization across all task operations: Implement normalizeTaskId() across all identified operations. Update task lookup functions to normalize input before querying database. Ensure epic... (T5589)
• Implement automatic PR creation for protected branches: Implement automatic PR creation when branch protection blocks direct push. Use GitHub CLI (gh) if available, or provide clear manual instructions. ... (T5591)
• Implement multi-channel release support (@latest/@beta/@Alpha): Add release channel support to pipeline: @latest for main branch, @beta for develop branch, @Alpha for feature branches. Update release gates to va... (T5592)
• Implementation: tasks.list Core Optimization: Redesign tasks.list as the flagship optimized list operation. Implement: (1) Cursor-based pagination with stable ordering, (2) Smart field projecti... (T5621)
• Implementation: Session & Admin List Operations Standardization: Apply optimized patterns to session.list, admin.job.list, admin.adr.list, and admin.grade.list. Standardize on: consistent pagination metadata, MVI... (T5622)
• Implementation: Pipeline List Operations Enhancement: Enhance pipeline domain list operations: release.list, manifest.list, phase.list, chain.list. These handle larger datasets (manifest entries, relea... (T5623)
• Implementation: Remaining List Operations Compliance: Update remaining list operations to meet new standards: sticky.list, nexus.list, tools.skill.list, tools.provider.list, orchestrate.tessera.list, t... (T5624)

Bug Fixes

• MCP response payload optimization — ranked blockedTasks, compact admin help, domain pagination: Reduce MCP response sizes and improve data quality across domains: - admin help: compact domain-grouped format by default (~85% token reduction), v... (T5584)
• Fix Layer 1 gate validator rejecting valid non-task status values: Layer 1 schema validator checked all status params against TASK_STATUSES regardless of domain. Operations like pipeline.stage.record with valid lif... (T5598)
• Fix missing drizzle-brain symlink for brain.db initialization: brain.db was 0 bytes because drizzle-brain symlink was missing at project root. The drizzle symlink for tasks.db existed correctly but drizzle-brai... (T5650)
• BUG: Remove projects-registry.json and wire nexus.db as canonical cross-project store: ~/.cleo/projects-registry.json is the old registry and MUST be fully deleted. nexus.db is canonical but not properly wired. Agents hit nexus tier-2... (T5656)

Documentation

• Add agent guidance and workflow visualization to release command: Enhance release.ship output with clear agent guidance and next steps. Add --guided flag for step-by-step mode. Show progress through workflow stage... (T5593)
• Documentation: Migration Guide & Agent Communication: Create comprehensive documentation for the LOOM Pipeline changes: (1) Migration guide for existing agent workflows using list operations, (2) Updat... (T5626)

Tests

• Testing & Validation: LOOM Pipeline Integration Suite: Create comprehensive test suite for optimized list operations. Include: token usage benchmarks (before/after comparison), pagination correctness te... (T5625)

Chores

• Decide keep or remove outcomes for session operations: Decide which session operations should stay, merge, parameterize, or disappear, and record any naming or contract changes needed to keep session co... (T5537)
• Decide keep or remove outcomes for memory operations: Produce a disposition for each memory operation, including merges, removals, or plugin moves, plus any help-tier or contract changes required for a... (T5541)

Changes

• Inventory session operations and map agent workflows: Inventory session operations across lifecycle, continuity, drift detection, handoff, and decision recording so the current surface is tied to real ... (T5535)
• Challenge session operations against LAFS and MVI: Challenge the session domain against LAFS, progressive disclosure, and MVI with special attention to what an agent must know at start, resume, susp... (T5536)
• Inventory memory operations and map agent workflows: Inventory memory operations across retrieval, manifest access, contradiction handling, supersession, and mutation so the domain can be evaluated ag... (T5539)
• Challenge memory operations against LAFS and MVI: Challenge the memory domain against LAFS, progressive disclosure, and MVI to make sure agents get useful recall signals without excessive cognitive... (T5540)
• C: Synthesize all 10 domain reviews into unified consolidation decisions: After all 10 domain inventory + challenge tasks complete (T5530-T5566 children), synthesize findings into a single decision matrix. For every opera... (T5609)
• C: Design canonical agent decision tree for operation selection: LLM agents face a 267-op surface with no clear guidance on which operation to use for a given goal. This creates hallucination and ambiguity. Desig... (T5610)
• A: Write ADR for CLEO Operation Model Rationalization: Capture the architecture decision behind the operation consolidation: why the surface grew unbounded, what principles constrain it going forward, a... (T5611)
• S: Update CLEO-OPERATION-CONSTITUTION.md to reflect rationalized operation set: After consolidation decisions are finalized (T5609) and the ADR is written (T5611), update the Constitution to match the new operation set. Must up... (T5612)
• I: Rewrite ct-cleo skill with canonical decision tree and correct domain refs: Full rewrite of packages/ct-skills/skills/ct-cleo/SKILL.md based on T5607 audit and T5610 decision tree. Requirements: (1) Remove all stale domain ... (T5613)
• I: Rewrite CLEO-INJECTION.md for MVI token-conservative agent guidance: templates/CLEO-INJECTION.md is the cold-start protocol injected into every agent. It must be ruthlessly token-conservative while surfacing exactly ... (T5614)
• Wire --bump-version into releaseShip() pipeline and fix release notes content: bumpVersionFromConfig() exists but is never called by releaseShip(). VERSION and package.json are bumped manually after the tag, backwards and erro... (T5617)
• Design Phase: LAFS Envelope Optimization Standards: Design optimized LAFS envelope structures specifically for list operations to minimize token waste. Define standard pagination metadata format, tru... (T5620)
• Scandir test (T5665)

---

v2026.3.27

CLEO brain observation system — full claude-mem replacement built natively into CLEO (T5671)

Features

• Create normalizeTaskId() SSoT utility with validation and tests: Create SSoT utility function normalizeTaskId() in src/core/tasks/task-id-utils.ts that accepts any task ID format and returns canonical "T1234". ... (T5587)
• Implement normalization across all task operations: Implement normalizeTaskId() across all identified operations. Update task lookup functions to normalize input before querying database. Ensure epic... (T5589)
• Implement automatic PR creation for protected branches: Implement automatic PR creation when branch protection blocks direct push. Use GitHub CLI (gh) if available, or provide clear manual instructions. ... (T5591)
• Implement multi-channel release support (@latest/@beta/@Alpha): Add release channel support to pipeline: @latest for main branch, @beta for develop branch, @Alpha for feature branches. Update release gates to va... (T5592)
• Implementation: tasks.list Core Optimization: Redesign tasks.list as the flagship optimized list operation. Implement: (1) Cursor-based pagination with stable ordering, (2) Smart field projecti... (T5621)
• Implementation: Session & Admin List Operations Standardization: Apply optimized patterns to session.list, admin.job.list, admin.adr.list, and admin.grade.list. Standardize on: consistent pagination metadata, MVI... (T5622)
• Implementation: Pipeline List Operations Enhancement: Enhance pipeline domain list operations: release.list, manifest.list, phase.list, chain.list. These handle larger datasets (manifest entries, relea... (T5623)
• Implementation: Remaining List Operations Compliance: Update remaining list operations to meet new standards: sticky.list, nexus.list, tools.skill.list, tools.provider.list, orchestrate.tessera.list, t... (T5624)

Bug Fixes

• MCP response payload optimization — ranked blockedTasks, compact admin help, domain pagination: Reduce MCP response sizes and improve data quality across domains: - admin help: compact domain-grouped format by default (~85% token reduction), v... (T5584)
• Fix Layer 1 gate validator rejecting valid non-task status values: Layer 1 schema validator checked all status params against TASK_STATUSES regardless of domain. Operations like pipeline.stage.record with valid lif... (T5598)
• Fix missing drizzle-brain symlink for brain.db initialization: brain.db was 0 bytes because drizzle-brain symlink was missing at project root. The drizzle symlink for tasks.db existed correctly but drizzle-brai... (T5650)
• BUG: Remove projects-registry.json and wire nexus.db as canonical cross-project store: ~/.cleo/projects-registry.json is the old registry and MUST be fully deleted. nexus.db is canonical but not properly wired. Agents hit nexus tier-2... (T5656)

Documentation

• Add agent guidance and workflow visualization to release command: Enhance release.ship output with clear agent guidance and next steps. Add --guided flag for step-by-step mode. Show progress through workflow stage... (T5593)
• Documentation: Migration Guide & Agent Communication: Create comprehensive documentation for the LOOM Pipeline changes: (1) Migration guide for existing agent workflows using list operations, (2) Updat... (T5626)

Tests

• Testing & Validation: LOOM Pipeline Integration Suite: Create comprehensive test suite for optimized list operations. Include: token usage benchmarks (before/after comparison), pagination correctness te... (T5625)

Chores

• Decide keep or remove outcomes for session operations: Decide which session operations should stay, merge, parameterize, or disappear, and record any naming or contract changes needed to keep session co... (T5537)
• Decide keep or remove outcomes for memory operations: Produce a disposition for each memory operation, including merges, removals, or plugin moves, plus any help-tier or contract changes required for a... (T5541)

Changes

• Inventory session operations and map agent workflows: Inventory session operations across lifecycle, continuity, drift detection, handoff, and decision recording so the current surface is tied to real ... (T5535)
• Challenge session operations against LAFS and MVI: Challenge the session domain against LAFS, progressive disclosure, and MVI with special attention to what an agent must know at start, resume, susp... (T5536)
• Inventory memory operations and map agent workflows: Inventory memory operations across retrieval, manifest access, contradiction handling, supersession, and mutation so the domain can be evaluated ag... (T5539)
• Challenge memory operations against LAFS and MVI: Challenge the memory domain against LAFS, progressive disclosure, and MVI to make sure agents get useful recall signals without excessive cognitive... (T5540)
• C: Synthesize all 10 domain reviews into unified consolidation decisions: After all 10 domain inventory + challenge tasks complete (T5530-T5566 children), synthesize findings into a single decision matrix. For every opera... (T5609)
• C: Design canonical agent decision tree for operation selection: LLM agents face a 267-op surface with no clear guidance on which operation to use for a given goal. This creates hallucination and ambiguity. Desig... (T5610)
• A: Write ADR for CLEO Operation Model Rationalization: Capture the architecture decision behind the operation consolidation: why the surface grew unbounded, what principles constrain it going forward, a... (T5611)
• S: Update CLEO-OPERATION-CONSTITUTION.md to reflect rationalized operation set: After consolidation decisions are finalized (T5609) and the ADR is written (T5611), update the Constitution to match the new operation set. Must up... (T5612)
• I: Rewrite ct-cleo skill with canonical decision tree and correct domain refs: Full rewrite of packages/ct-skills/skills/ct-cleo/SKILL.md based on T5607 audit and T5610 decision tree. Requirements: (1) Remove all stale domain ... (T5613)
• I: Rewrite CLEO-INJECTION.md for MVI token-conservative agent guidance: templates/CLEO-INJECTION.md is the cold-start protocol injected into every agent. It must be ruthlessly token-conservative while surfacing exactly ... (T5614)
• Wire --bump-version into releaseShip() pipeline and fix release notes content: bumpVersionFromConfig() exists but is never called by releaseShip(). VERSION and package.json are bumped manually after the tag, backwards and erro... (T5617)
• Design Phase: LAFS Envelope Optimization Standards: Design optimized LAFS envelope structures specifically for list operations to minimize token waste. Define standard pagination metadata format, tru... (T5620)
• Scandir test (T5665)

---