@vpxa/aikit 0.1.53 → 0.1.55

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vpxa/aikit",
-  "version": "0.1.53",
+  "version": "0.1.55",
   "type": "module",
   "description": "Local-first AI developer toolkit — knowledge base, code analysis, context management, and developer tools for LLM agents",
   "license": "MIT",
@@ -59,6 +59,7 @@
     "tree-sitter-wasms": "~0.1.13",
     "turndown": "^7.x",
     "web-tree-sitter": "~0.24.7",
+    "yaml": "^2.x",
     "zod": "^4.x"
   },
   "devDependencies": {

package/packages/cli/dist/commands/init/templates.js

@@ -25,6 +25,7 @@ Once loaded, AI Kit tools appear as \`mcp_<server>_<tool>\` (e.g. \`mcp_aikit_se
 | \`run_in_terminal\` for tsc/lint | \`check({})\` | Typecheck + lint combined, summary output |
 | \`run_in_terminal\` for test | \`test_run({})\` | Run tests with structured output |
 | Manual code tracing | \`trace({ symbol, direction })\` | AST call-graph traversal |
+| Manual import/dependency tracing | \`graph({ action: 'neighbors' })\` | Module import graph with cross-package edges |
 | Line counting / wc | \`measure({ path })\` | Lines, functions, cognitive complexity |
 | \`fetch_webpage\` | \`web_fetch({ url })\` | Readability extract + token budget — richer output |
 | Web research / browsing | \`web_search({ query })\` | Structured web results without browser — unique to AI Kit |
@@ -121,6 +122,7 @@ Load them: \`tool_search_tool_regex({ pattern: "aikit" })\`
 | Category | Tools | Purpose |
 |----------|-------|---------|
 | Search & Discovery | \`search\`, \`find\`, \`symbol\`, \`trace\`, \`scope_map\`, \`lookup\`, \`dead_symbols\`, \`file_summary\` | Find code, symbols, data flow, reading plans |
+| Relationships | \`graph\` | Two-step: \`graph({action:'find_nodes', name_pattern})\` then \`graph({action:'neighbors', node_id})\`. Who imports / what depends / layer violations. |
 | Code Analysis | \`analyze_structure\`, \`analyze_dependencies\`, \`analyze_symbols\`, \`analyze_patterns\`, \`analyze_entry_points\`, \`analyze_diagram\`, \`blast_radius\` | Structure, deps, patterns, impact |
 | Knowledge | \`remember\`, \`read\`, \`update\`, \`forget\`, \`list\`, \`produce_knowledge\` | Persistent cross-session memory |
 | Execution | \`check\`, \`test_run\`, \`eval\`, \`batch\`, \`audit\` | Typecheck, lint, test, run code |
@@ -133,7 +135,7 @@ Load them: \`tool_search_tool_regex({ pattern: "aikit" })\`
 | Utilities | \`regex_test\`, \`encode\`, \`measure\`, \`changelog\`, \`schema_validate\`, \`snippet\`, \`parse_output\`, \`env\`, \`time\` | Regex, encoding, metrics, output parsing |
 | Presentation | \`present\` | Rich dashboards, charts, tables, timelines |
 | Brainstorming | \`brainstorm\` | Interactive ideation sessions with structured output |
-| System | \`status\`, \`reindex\`, \`health\`, \`guide\`, \`onboard\`, \`graph\`, \`queue\`, \`replay\` | Index management, knowledge graph |
+| System | \`status\`, \`reindex\`, \`health\`, \`guide\`, \`onboard\`, \`queue\`, \`replay\` | Index management |
 
 ---
 
@@ -145,6 +147,7 @@ Need to understand a file?
 \u251C\u2500 Specific section?   \u2192 compact({ path, query }) \u2014 5-20x token reduction
 \u251C\u2500 Multiple files?     \u2192 digest (multi-source compression)
 \u251C\u2500 Repeated reference? \u2192 stratum_card (reusable T1/T2 card)
+\u251C\u2500 Need relationships? \u2192 graph({action:'find_nodes', name_pattern}) \u2192 graph({action:'neighbors', node_id})
 \u2514\u2500 Need exact lines to EDIT? \u2192 read_file (ONLY acceptable use)
 \`\`\`
 
@@ -170,6 +173,7 @@ search({ query: "SESSION CHECKPOINT", origin: "curated" })    # Resume prior wor
 | Situation | Tool |
 |-----------|------|
 | Intermediate result | \`stash({ key, value })\` |
+| Parallel A/B exploration (read-only) | \`lane({ action: 'create', name })\` → explore → \`lane({ action: 'diff', names })\` |
 | Milestone completed | \`checkpoint({ action: "save", name })\` |
 | Architecture decision made | \`remember({ title, content, category: "decisions" })\` |
 | Pattern discovered | \`remember({ title, content, category: "patterns" })\` |