@getmikk/ai-context 1.5.1 → 1.7.0

package/README.md

@@ -1,13 +1,15 @@
 # @getmikk/ai-context
 
-> Intelligent context distillation for AI coding agents — builds token-budgeted, relevance-scored context payloads from the dependency graph, plus generates `claude.md` / `AGENTS.md` files.
+> Token-budgeted, graph-traced AI context — the difference between an LLM that guesses your architecture and one that actually knows it.
 
 [![npm](https://img.shields.io/npm/v/@getmikk/ai-context)](https://www.npmjs.com/package/@getmikk/ai-context)
 [![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](../../LICENSE)
 
-`@getmikk/ai-context` solves the "context window" problem for AI coding assistants. Instead of dumping your entire codebase into a prompt, it uses the dependency graph to trace only the relevant functions, files, and constraints for a given task — then packs them into a token-budgeted payload.
+`@getmikk/ai-context` solves the AI context window problem at the architectural level. Instead of dumping your entire codebase into a prompt and hoping the LLM figures it out, it walks the dependency graph from task-relevant seed functions, scores every reachable function by relevance, and packs the highest-signal functions into a token budget — giving your AI exactly what it needs and nothing it doesn't.
 
-It also generates tiered `claude.md` and `AGENTS.md` files that give AI agents a structured understanding of your project architecture.
+It also generates `claude.md` and `AGENTS.md` — tiered architecture summaries that let AI agents understand your entire project structure from a single file.
+
+> Part of [Mikk](../../README.md) — the codebase nervous system for AI-assisted development.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@getmikk/ai-context",
-    "version": "1.5.1",
+    "version": "1.7.0",
     "license": "Apache-2.0",
     "repository": {
         "type": "git",
@@ -21,8 +21,8 @@
         "dev": "tsc --watch"
     },
     "dependencies": {
-        "@getmikk/core": "^1.5.1",
-        "@getmikk/intent-engine": "^1.5.1"
+        "@getmikk/core": "^1.7.0",
+        "@getmikk/intent-engine": "^1.7.0"
     },
     "devDependencies": {
         "typescript": "^5.7.0",

package/src/claude-md-generator.ts

@@ -1,4 +1,6 @@
 import type { MikkContract, MikkLock, MikkLockFunction } from '@getmikk/core'
+import * as fs from 'node:fs'
+import * as path from 'node:path'
 
 /** Default token budget for claude.md — generous but still bounded */
 const DEFAULT_TOKEN_BUDGET = 12000
@@ -33,7 +35,8 @@ export class ClaudeMdGenerator {
         private contract: MikkContract,
         private lock: MikkLock,
         private tokenBudget: number = DEFAULT_TOKEN_BUDGET,
-        meta?: ProjectMeta
+        meta?: ProjectMeta,
+        private projectRoot?: string
     ) {
         this.meta = meta || {}
     }
@@ -324,13 +327,18 @@ export class ClaudeMdGenerator {
             lines.push(`### \`${cf.path}\` (${cf.type})`)
             lines.push('')
             lines.push('```' + lang)
+            // Read content from disk on-demand
+            let content = ''
+            if (this.projectRoot) {
+                try { content = fs.readFileSync(path.resolve(this.projectRoot, cf.path), 'utf-8') } catch { }
+            }
             // Trim content to avoid blowing up the token budget
             const maxChars = 8000 // ~2000 tokens per file
-            if (cf.content.length > maxChars) {
-                lines.push(cf.content.slice(0, maxChars))
-                lines.push(`// ... truncated (${cf.size} bytes total)`)
+            if (content.length > maxChars) {
+                lines.push(content.slice(0, maxChars))
+                lines.push(`// ... truncated (${cf.size ?? content.length} bytes total)`)
             } else {
-                lines.push(cf.content.trimEnd())
+                lines.push(content.trimEnd())
             }
             lines.push('```')
             lines.push('')

package/src/context-builder.ts

@@ -24,6 +24,15 @@ const WEIGHT = {
 // Default token budget per context payload
 const DEFAULT_TOKEN_BUDGET = 6000
 
+function readContextFile(filePath: string, projectRoot?: string): string {
+    if (!projectRoot) return ''
+    try {
+        return fs.readFileSync(path.resolve(projectRoot, filePath), 'utf-8')
+    } catch {
+        return ''
+    }
+}
+
 /**
  * Rough token estimator: 1 token ≈ 4 chars for code/identifiers
  */
@@ -305,7 +314,7 @@ export class ContextBuilder {
             })),
             contextFiles: this.lock.contextFiles?.map(cf => ({
                 path: cf.path,
-                content: cf.content,
+                content: readContextFile(cf.path, query.projectRoot),
                 type: cf.type,
             })),
             routes: this.lock.routes?.map(r => ({
@@ -433,11 +442,12 @@ export class ContextBuilder {
                 lines.push(`--- ${cf.path} (${cf.type}) ---`)
                 // Trim to ~2000 chars per file in prompt output
                 const maxChars = 2000
-                if (cf.content.length > maxChars) {
-                    lines.push(cf.content.slice(0, maxChars))
-                    lines.push(`... (truncated, ${cf.size} bytes total)`)
+                const cfContent = readContextFile(cf.path, query.projectRoot)
+                if (cfContent.length > maxChars) {
+                    lines.push(cfContent.slice(0, maxChars))
+                    lines.push(`... (truncated, ${cf.size ?? cfContent.length} bytes total)`)
                 } else {
-                    lines.push(cf.content.trimEnd())
+                    lines.push(cfContent.trimEnd())
                 }
                 lines.push('')
             }