@cleocode/cleo 2026.3.33 → 2026.3.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/cleo",
-  "version": "2026.3.33",
+  "version": "2026.3.34",
   "description": "CLEO V2 - TypeScript task management CLI for AI coding agents",
   "mcpName": "io.github.kryptobaseddev/cleo-mcp-server",
   "type": "module",

package/packages/ct-skills/skills/ct-codebase-mapper/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: ct-codebase-mapper
+version: 1.0.0
+description: Codebase analysis and mapping for autonomous agent understanding. Builds structured maps of project stack, architecture, conventions, testing, integrations, and concerns.
+category: recommended
+tier: 1
+protocol: null
+dependencies: []
+compatibility:
+  - claude-code
+  - cursor
+  - windsurf
+  - gemini-cli
+triggers:
+  - codebase map
+  - analyze codebase
+  - understand project
+  - brownfield analysis
+  - project structure
+---
+
+# Codebase Mapper
+
+Structured codebase analysis for autonomous agent understanding.
+
+## Quick Start
+
+| Goal | Command | Cost |
+|------|---------|------|
+| Quick analysis | `query admin map` | ~500 tokens |
+| Deep analysis + store | `mutate admin map` | ~800 tokens |
+| Focus on one area | `query admin map {focus: "concerns"}` | ~300 tokens |
+| CLI | `cleo map` / `cleo map --store` | — |
+
+## Progressive Disclosure
+
+### Tier 0: Quick Analysis
+
+```
+query admin map
+```
+
+Returns structured `CodebaseMapResult` with stack, architecture, structure, conventions, testing, integrations, and concerns.
+
+### Tier 1: Store to Brain
+
+```
+mutate admin map
+```
+
+Same analysis, but stores patterns, learnings, and observations to brain.db. Tagged with `source: 'codebase-map'` for filtering.
+
+### Tier 2: Focused Analysis
+
+```
+query admin map {focus: "concerns"}
+```
+
+Focus areas: `stack`, `architecture`, `structure`, `conventions`, `testing`, `integrations`, `concerns`.
+
+## When to Use
+
+- **New project onboarding**: Run `mutate admin map` to build brain.db context
+- **Brownfield init**: `cleo init --map-codebase` runs analysis during initialization
+- **Before epic planning**: Understand project structure before decomposing work
+- **Tech debt assessment**: `query admin map {focus: "concerns"}` for TODOs and large files
+
+## Output Structure
+
+```typescript
+{
+  projectContext: ProjectContext,  // From detectProjectType()
+  stack: StackAnalysis,           // Languages, frameworks, deps
+  architecture: ArchAnalysis,     // Layers, entry points, patterns
+  structure: StructureAnalysis,   // Directory tree with annotations
+  conventions: ConventionAnalysis,// Naming, linting, formatting
+  testing: TestingAnalysis,       // Framework, patterns, coverage
+  integrations: IntegrationAnalysis, // APIs, DBs, CI/CD
+  concerns: ConcernAnalysis,      // TODOs, large files, complexity
+  analyzedAt: string
+}
+```

package/packages/ct-skills/skills.json

@@ -242,6 +242,22 @@
       "license": "MIT",
       "metadata": {}
     },
+    {
+      "name": "ct-codebase-mapper",
+      "description": "Codebase analysis and mapping for autonomous agent understanding. Builds structured maps of project stack, architecture, conventions, testing, integrations, and concerns.",
+      "version": "1.0.0",
+      "path": "skills/ct-codebase-mapper/SKILL.md",
+      "references": [],
+      "core": false,
+      "category": "recommended",
+      "tier": 1,
+      "protocol": null,
+      "dependencies": [],
+      "sharedResources": [],
+      "compatibility": ["claude-code", "cursor", "windsurf", "gemini-cli"],
+      "license": "MIT",
+      "metadata": {}
+    },
     {
       "name": "loom",
       "description": "LOOM (Logical Order of Operations Methodology) - the systematic framework for how CLEO processes project threads through the RCASD-IVTR+C pipeline. LOOM encompasses the full lifecycle methodology that transforms raw ideas into delivered artifacts, from Research through Release with the Contribution protocol (+C) running across all stages. References docs/concepts/CLEO-VISION.md for the complete LOOM framework, neural hierarchy model, and brain metaphor mapping.",