codemap_orient

{
  "content": [
    {
      "type": "text",
      "text": "# CodeMap Session Orientation\n\n**Version:** 0.2.5\n**Project Root:** `/path/to/your/project`\n\n## Stats\n\n- **Files:** 299\n- **Symbols:** 3099\n- **Dependencies:** 173\n\n## 📋 Session Checklist\n\n- 🔴 **[HIGH]** Review .codemap/sessions/NEXT_SESSION.md to see if there are any outstanding tasks to do.\n- 🔴 **[HIGH]** Use clean-build.bat to build codemap package\n- 🟡 **[MEDIUM]** Label files with appropriate architectural patterns as you encounter them\n\n## 🏷️ THIS PROJECT USES LABELS!\n\nThis project has **19 labels** defined with **45 assignments**.\n\n**Labels track status, patterns, and workflow states across files.**\n\n- Use `codemap_label_list()` to see all available labels\n- Use `codemap_label_search(labelId: \"...\")` to find labeled files\n- Use `codemap_help(topic: \"labels\")` to learn the label system\n\n**Remember to label files as you work** - check the session checklist for labeling guidance.\n\n## Loaded Parsers\n\n- **@egentica/codemap-parser-typescript** (v0.1.0): .ts, .tsx, .js, .jsx\n- **@egentica/codemap-parser-vue** (v0.1.0): .vue\n- **@egentica/codemap-parser-php** (v0.2.0): .php\n\n## Quick Start Commands\n\n**Search & Navigate:**\n- `codemap_search(query: 'keyword')` - Search files and symbols\n- `codemap_read_file(path: 'src/file.ts')` - Read file contents\n\n**Edit Files:**\n- `codemap_replace_text(target: 'file.ts', oldString: '...', newString: '...')` - Find & replace\n- `codemap_write_file(target: 'file.ts', content: '...')` - Write entire file\n\n**Get Help:**\n- `codemap_help()` - Show all available commands and guides\n- `codemap_help(topic: 'search')` - Get help on specific topic\n\n---\n\n## ⚡ IMPORTANT: Load Core Tools First\n\n**Unlike Desktop Commander tools (which are pre-loaded in the model), CodeMap tools require explicit loading via `tool_search` before first use.**\n\n**At the start of each session, immediately load these essential tools:**\n\n```javascript\ntool_search(query: \"codemap read write replace\")\n// This loads: codemap_read_file, codemap_write, codemap_replace_text, etc.\n```\n\n**Without this step, tool calls will fail with \"tool not loaded\" errors.**\n\n---\n\n## AI Agent Responsibilities\n\n**The system depends on you, the AI Agent, to maintain organization:**\n\n- **Create groups regularly** using `codemap_group_add(name, description, members)`\n- **Add notations** using `codemap_group_notate(name, text)` to document patterns\n- **Use consistent naming** when grouping files together\n\n---\n\n*Session ready. Try `codemap_help()` to explore all features.*\n\n---\n\n## Last Successfully Closed Session\n\n**Session ID:** 2026-04-07T20-37-30\n**Started:** 2026-04-07T20:37:30.202Z\n**Duration:** 2 hours, 15 minutes\n\n**Files Updated (8):**\n- packages/codemap/src/core/Scanner.ts\n- packages/codemap/src/mcp/tools/io/read.tool.ts\n- packages/codemap/CHANGELOG.md\n"
    }
  ]
}