@getmikk/diagram-generator 1.8.0 → 1.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@getmikk/diagram-generator",
-    "version": "1.8.0",
+    "version": "1.9.0",
     "license": "Apache-2.0",
     "repository": {
         "type": "git",
@@ -21,7 +21,7 @@
         "dev": "tsc --watch"
     },
     "dependencies": {
-        "@getmikk/core": "^1.8.0"
+        "@getmikk/core": "^1.9.0"
     },
     "devDependencies": {
         "typescript": "^5.7.0",

package/src/generators/commands-diagram.ts

@@ -0,0 +1,100 @@
+import type { MikkContract, MikkLock } from '@getmikk/core'
+
+/**
+ * Generates a Mermaid mindmap of all mikk CLI commands grouped by category.
+ * Does not depend on contract or lock data — it is a static reference diagram.
+ */
+export class CommandsDiagramGenerator {
+    // contract/lock kept for interface consistency with other generators
+    constructor(
+        private _contract?: MikkContract,
+        private _lock?: MikkLock,
+    ) {}
+
+    generate(): string {
+        return `mindmap
+  root((mikk))
+    Setup
+      mikk init
+        Scan project
+        Build dependency graph
+        Generate all artifacts
+      mikk analyze
+        Re-analyze after changes
+        Update lock file
+      mikk watch
+        Live file watcher daemon
+        Incremental updates
+        100ms debounce
+      mikk diff
+        Files changed since last analysis
+      mikk remove
+        Uninstall mikk
+        Delete all artifacts
+    Health
+      mikk stats
+        Per-module metrics
+        Function counts
+        Dead code %
+      mikk doctor
+        7-point diagnostic check
+        Config validation
+        Lock freshness
+      mikk dead-code
+        Unused functions
+        Filter by module
+    Architecture
+      mikk ci
+        Exit non-zero on violations
+        CI pipeline gate
+      mikk ci --strict
+        Also enforce dead code threshold
+      mikk ci --format json
+        Machine-readable output
+      mikk contract validate
+        Constraint violations
+        Drift detection
+      mikk contract show-boundaries
+        Cross-module dependencies
+    Context
+      mikk context query
+        Architecture question
+        Graph-traced response
+      mikk context impact
+        Blast radius of a file change
+        Classified by severity
+      mikk context for
+        Token-budgeted task context
+    Refactoring
+      mikk intent
+        Pre-flight a refactor
+        Detect conflicts before coding
+      mikk rename
+        Coordinated multi-file rename
+        Find all call sites
+    MCP Server
+      mikk mcp
+        Start MCP server
+        22 tools available
+      mikk mcp install
+        Install into Claude Desktop
+        Install into Cursor
+    Visualization
+      mikk visualize all
+        Regenerate all diagrams
+        7 diagram types
+      mikk visualize module
+        Per-module call graph
+        Public API capsule
+      mikk visualize commands
+        This diagram
+    Decisions
+      mikk adr list
+        All architectural decisions
+      mikk adr add
+        New ADR
+      mikk adr get
+        Details for a specific ADR
+`
+    }
+}

package/src/generators/dependency-matrix.ts

@@ -93,7 +93,9 @@ export class DependencyMatrixGenerator {
         // Count file-level cross-module imports
         for (const file of Object.values(this.lock.files)) {
             if (!file.imports) continue
-            for (const importedPath of file.imports) {
+            for (const imp of file.imports) {
+                const importedPath = imp.resolvedPath
+                if (!importedPath) continue
                 const importedFile = this.lock.files[importedPath]
                 if (importedFile && file.moduleId !== importedFile.moduleId) {
                     const key = `${file.moduleId}|${importedFile.moduleId}`

package/src/generators/health-diagram.ts

@@ -45,7 +45,9 @@ export class HealthDiagramGenerator {
         }
         for (const file of Object.values(this.lock.files)) {
             if (!file.imports) continue
-            for (const importedPath of file.imports) {
+            for (const imp of file.imports) {
+                const importedPath = imp.resolvedPath
+                if (!importedPath) continue
                 const importedFile = this.lock.files[importedPath]
                 if (importedFile && file.moduleId !== importedFile.moduleId) {
                     const key = `${file.moduleId}|${importedFile.moduleId}`
@@ -88,7 +90,9 @@ export class HealthDiagramGenerator {
         }
         for (const file of moduleFiles) {
             if (!file.imports) continue
-            for (const importedPath of file.imports) {
+            for (const imp of file.imports) {
+                const importedPath = imp.resolvedPath
+                if (!importedPath) continue
                 const importedFile = this.lock.files[importedPath]
                 if (importedFile) {
                     if (importedFile.moduleId === moduleId) internalCalls++

package/src/generators/main-diagram.ts

@@ -61,7 +61,9 @@ export class MainDiagramGenerator {
         // File-level cross-module imports
         for (const file of Object.values(this.lock.files)) {
             if (!file.imports) continue
-            for (const importedPath of file.imports) {
+            for (const imp of file.imports) {
+                const importedPath = imp.resolvedPath
+                if (!importedPath) continue
                 const importedFile = this.lock.files[importedPath]
                 if (importedFile && file.moduleId !== importedFile.moduleId) {
                     const edgeKey = `${file.moduleId}→${importedFile.moduleId}`
@@ -103,7 +105,7 @@ export class MainDiagramGenerator {
         const ranked = allFiles
             .map(f => ({
                 ...f,
-                connections: (f.imports?.length || 0) + (Object.values(this.lock.files).filter(other => other.imports?.includes(f.path)).length),
+                connections: (f.imports?.length || 0) + (Object.values(this.lock.files).filter(other => other.imports?.some(i => i.resolvedPath === f.path)).length),
             }))
             .sort((a, b) => b.connections - a.connections)
 
@@ -146,8 +148,8 @@ export class MainDiagramGenerator {
         for (const file of filesToShow) {
             if (!file.imports) continue
             for (const imp of file.imports) {
-                if (shownPaths.has(imp)) {
-                    lines.push(`    ${this.sanitizeId(file.path)} --> ${this.sanitizeId(imp)}`)
+                if (imp.resolvedPath && shownPaths.has(imp.resolvedPath)) {
+                    lines.push(`    ${this.sanitizeId(file.path)} --> ${this.sanitizeId(imp.resolvedPath)}`)
                 }
             }
         }

package/src/index.ts

@@ -6,3 +6,4 @@ export { HealthDiagramGenerator } from './generators/health-diagram.js'
 export { FlowDiagramGenerator } from './generators/flow-diagram.js'
 export { CapsuleDiagramGenerator } from './generators/capsule-diagram.js'
 export { DependencyMatrixGenerator } from './generators/dependency-matrix.js'
+export { CommandsDiagramGenerator } from './generators/commands-diagram.js'

package/src/orchestrator.ts

@@ -8,6 +8,7 @@ import { HealthDiagramGenerator } from './generators/health-diagram.js'
 import { FlowDiagramGenerator } from './generators/flow-diagram.js'
 import { CapsuleDiagramGenerator } from './generators/capsule-diagram.js'
 import { DependencyMatrixGenerator } from './generators/dependency-matrix.js'
+import { CommandsDiagramGenerator } from './generators/commands-diagram.js'
 
 /**
  * DiagramOrchestrator — generates all diagram types and writes them to