kirograph 0.17.0 → 0.20.0

package/dist/compression/tracker.d.ts

@@ -0,0 +1,155 @@
+/**
+ * KiroGraph Token Savings Tracker
+ *
+ * Records compression results to a local JSON file for analytics.
+ * Uses a simple append-only JSON lines file to avoid SQLite dependency
+ * in the compression module (keeps it lightweight and independent).
+ */
+import type { TokenSavingsRecord } from './types';
+export interface GainStats {
+    totalCommands: number;
+    totalOriginal: number;
+    totalCompressed: number;
+    totalSaved: number;
+    savingsPercent: number;
+    byFamily: Record<string, {
+        count: number;
+        savings: number;
+    }>;
+    recentCommands: Array<{
+        command: string;
+        savings: number;
+        timestamp: number;
+        source?: string;
+    }>;
+    /** Breakdown by source type */
+    bySource: {
+        exec: {
+            count: number;
+            saved: number;
+        };
+        graph: {
+            count: number;
+            saved: number;
+        };
+        memory: {
+            count: number;
+            saved: number;
+        };
+        docs: {
+            count: number;
+            saved: number;
+        };
+        data: {
+            count: number;
+            saved: number;
+        };
+    };
+}
+export declare class TokenTracker {
+    private filePath;
+    private sessionId;
+    constructor(projectRoot: string);
+    private getOrCreateSessionId;
+    /**
+     * Record a compression result.
+     */
+    record(command: string, originalTokens: number, compressedTokens: number, strategy: string, source?: 'exec' | 'graph' | 'memory' | 'docs' | 'data'): void;
+    /**
+     * Record a graph tool saving.
+     * @param toolName - The MCP tool that was called
+     * @param outputTokens - Actual tokens returned by the tool
+     * @param naiveCost - Estimated tokens the agent would have used without the tool
+     */
+    recordGraphSaving(toolName: string, outputTokens: number, naiveCost: number): void;
+    /**
+     * Record a memory tool saving.
+     * @param toolName - The MCP tool that was called
+     * @param outputTokens - Actual tokens returned by the tool
+     * @param naiveCost - Estimated tokens the agent would have used without memory
+     */
+    recordMemorySaving(toolName: string, outputTokens: number, naiveCost: number): void;
+    /**
+     * Record a docs tool saving.
+     * @param toolName - The MCP tool that was called
+     * @param outputTokens - Actual tokens returned by the tool
+     * @param naiveCost - Estimated tokens the agent would have used without docs indexing
+     */
+    recordDocsSaving(toolName: string, outputTokens: number, naiveCost: number): void;
+    /**
+     * Record a data tool saving.
+     * @param toolName - The MCP tool that was called
+     * @param outputTokens - Actual tokens returned by the tool
+     * @param naiveCost - Estimated tokens the agent would have used without data indexing
+     */
+    recordDataSaving(toolName: string, outputTokens: number, naiveCost: number): void;
+    /**
+     * Get aggregated statistics for a time period.
+     */
+    getStats(period: 'session' | 'today' | 'week' | 'all'): GainStats;
+    /**
+     * Get raw history for CLI display.
+     */
+    getHistory(limit?: number): TokenSavingsRecord[];
+    /**
+     * Get daily breakdown for graph display.
+     */
+    getDailyBreakdown(days?: number): Array<{
+        date: string;
+        commands: number;
+        saved: number;
+    }>;
+    private loadRecords;
+    private extractFamily;
+    private maybeRotate;
+}
+export interface BudgetConfig {
+    maxTokensPerSession: number;
+    warnAt: number;
+    throttleAt: number;
+}
+export interface BudgetStatus {
+    consumed: number;
+    limit: number;
+    remaining: number;
+    utilization: number;
+    warning: string | null;
+    throttled: boolean;
+}
+/**
+ * Session-scoped context budget tracker.
+ * Tracks cumulative token consumption and enforces budget limits.
+ */
+export declare class BudgetTracker {
+    private static instances;
+    private consumed;
+    private config;
+    private projectRoot;
+    private constructor();
+    static getInstance(projectRoot: string, config?: Partial<BudgetConfig>): BudgetTracker;
+    /**
+     * Record tokens consumed by a tool response.
+     */
+    recordConsumption(tokens: number): void;
+    /**
+     * Get current budget status.
+     */
+    getStatus(): BudgetStatus;
+    /**
+     * Check if the budget is throttled (responses should be truncated).
+     */
+    isThrottled(): boolean;
+    /**
+     * Check if a warning should be appended to responses.
+     */
+    shouldWarn(): boolean;
+    /**
+     * Reset the budget counters.
+     */
+    reset(): void;
+    /**
+     * Update budget configuration.
+     */
+    updateConfig(config: Partial<BudgetConfig>): void;
+}
+//# sourceMappingURL=tracker.d.ts.map

package/dist/compression/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/compression/tracker.ts"],"names":[],"mappings":"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"}

package/dist/compression/tracker.js

@@ -28,6 +28,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var tracker_exports = {};
 __export(tracker_exports, {
+  BudgetTracker: () => BudgetTracker,
   TokenTracker: () => TokenTracker
 });
 module.exports = __toCommonJS(tracker_exports);
@@ -253,8 +254,87 @@ class TokenTracker {
     }
   }
 }
+const DEFAULT_BUDGET = {
+  maxTokensPerSession: 1e5,
+  warnAt: 8e4,
+  throttleAt: 95e3
+};
+class BudgetTracker {
+  constructor(projectRoot, config) {
+    this.consumed = 0;
+    this.projectRoot = projectRoot;
+    this.config = { ...DEFAULT_BUDGET, ...config };
+  }
+  static {
+    this.instances = /* @__PURE__ */ new Map();
+  }
+  static getInstance(projectRoot, config) {
+    const key = projectRoot;
+    if (!BudgetTracker.instances.has(key)) {
+      BudgetTracker.instances.set(key, new BudgetTracker(projectRoot, config));
+    }
+    const instance = BudgetTracker.instances.get(key);
+    if (config) {
+      instance.config = { ...DEFAULT_BUDGET, ...config };
+    }
+    return instance;
+  }
+  /**
+   * Record tokens consumed by a tool response.
+   */
+  recordConsumption(tokens) {
+    this.consumed += tokens;
+  }
+  /**
+   * Get current budget status.
+   */
+  getStatus() {
+    const limit = this.config.maxTokensPerSession;
+    const remaining = Math.max(0, limit - this.consumed);
+    const utilization = limit > 0 ? Math.round(this.consumed / limit * 100) : 0;
+    let warning = null;
+    if (limit > 0 && this.consumed >= this.config.throttleAt) {
+      warning = `Budget nearly exhausted (${utilization}%). Responses will be truncated.`;
+    } else if (limit > 0 && this.consumed >= this.config.warnAt) {
+      warning = `Approaching budget limit (${utilization}%). Consider using compact read modes.`;
+    }
+    return {
+      consumed: this.consumed,
+      limit,
+      remaining,
+      utilization,
+      warning,
+      throttled: limit > 0 && this.consumed >= this.config.throttleAt
+    };
+  }
+  /**
+   * Check if the budget is throttled (responses should be truncated).
+   */
+  isThrottled() {
+    return this.config.maxTokensPerSession > 0 && this.consumed >= this.config.throttleAt;
+  }
+  /**
+   * Check if a warning should be appended to responses.
+   */
+  shouldWarn() {
+    return this.config.maxTokensPerSession > 0 && this.consumed >= this.config.warnAt;
+  }
+  /**
+   * Reset the budget counters.
+   */
+  reset() {
+    this.consumed = 0;
+  }
+  /**
+   * Update budget configuration.
+   */
+  updateConfig(config) {
+    this.config = { ...this.config, ...config };
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BudgetTracker,
   TokenTracker
 });
 //# sourceMappingURL=tracker.js.map

package/dist/compression/tracker.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/compression/tracker.ts"],
-  "sourcesContent": ["/**\n * KiroGraph Token Savings Tracker\n *\n * Records compression results to a local JSON file for analytics.\n * Uses a simple append-only JSON lines file to avoid SQLite dependency\n * in the compression module (keeps it lightweight and independent).\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as crypto from 'crypto';\nimport type { TokenSavingsRecord } from './types';\n\nconst TRACKER_DIR = '.kirograph';\nconst TRACKER_FILE = 'token-savings.jsonl';\nconst MAX_RECORDS = 5000; // Rotate after this many records\n\nexport interface GainStats {\n  totalCommands: number;\n  totalOriginal: number;\n  totalCompressed: number;\n  totalSaved: number;\n  savingsPercent: number;\n  byFamily: Record<string, { count: number; savings: number }>;\n  recentCommands: Array<{ command: string; savings: number; timestamp: number; source?: string }>;\n  /** Breakdown by source type */\n  bySource: {\n    exec: { count: number; saved: number };\n    graph: { count: number; saved: number };\n    memory: { count: number; saved: number };\n    docs: { count: number; saved: number };\n    data: { count: number; saved: number };\n  };\n}\n\nexport class TokenTracker {\n  private filePath: string;\n  private sessionId: string;\n\n  constructor(projectRoot: string) {\n    const dir = path.join(projectRoot, TRACKER_DIR);\n    fs.mkdirSync(dir, { recursive: true });\n    this.filePath = path.join(dir, TRACKER_FILE);\n    this.sessionId = this.getOrCreateSessionId(dir);\n  }\n\n  private getOrCreateSessionId(dir: string): string {\n    const sessionFile = path.join(dir, '.session-id');\n    try {\n      const existing = fs.readFileSync(sessionFile, 'utf8').trim();\n      if (existing) return existing;\n    } catch { /* file doesn't exist */ }\n\n    const id = crypto.randomBytes(8).toString('hex');\n    try {\n      fs.writeFileSync(sessionFile, id, 'utf8');\n    } catch { /* ignore write errors */ }\n    return id;\n  }\n\n  /**\n   * Record a compression result.\n   */\n  record(command: string, originalTokens: number, compressedTokens: number, strategy: string, source: 'exec' | 'graph' | 'memory' | 'docs' | 'data' = 'exec'): void {\n    const record: TokenSavingsRecord = {\n      timestamp: Date.now(),\n      command: command.slice(0, 200), // Truncate long commands\n      originalTokens,\n      compressedTokens,\n      strategy,\n      sessionId: this.sessionId,\n      source,\n    };\n\n    try {\n      fs.appendFileSync(this.filePath, JSON.stringify(record) + '\\n', 'utf8');\n      this.maybeRotate();\n    } catch {\n      // Non-critical \u2014 don't crash on tracking failure\n    }\n  }\n\n  /**\n   * Record a graph tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without the tool\n   */\n  recordGraphSaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `graph:${toolName}`, 'graph');\n  }\n\n  /**\n   * Record a memory tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without memory\n   */\n  recordMemorySaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `memory:${toolName}`, 'memory');\n  }\n\n  /**\n   * Record a docs tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without docs indexing\n   */\n  recordDocsSaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `docs:${toolName}`, 'docs');\n  }\n\n  /**\n   * Record a data tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without data indexing\n   */\n  recordDataSaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `data:${toolName}`, 'data');\n  }\n\n  /**\n   * Get aggregated statistics for a time period.\n   */\n  getStats(period: 'session' | 'today' | 'week' | 'all'): GainStats {\n    const records = this.loadRecords(period);\n\n    if (records.length === 0) {\n      return {\n        totalCommands: 0,\n        totalOriginal: 0,\n        totalCompressed: 0,\n        totalSaved: 0,\n        savingsPercent: 0,\n        byFamily: {},\n        recentCommands: [],\n        bySource: { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 }, memory: { count: 0, saved: 0 }, docs: { count: 0, saved: 0 }, data: { count: 0, saved: 0 } },\n      };\n    }\n\n    let totalOriginal = 0;\n    let totalCompressed = 0;\n    const byFamily = new Map<string, { count: number; totalOriginal: number; totalCompressed: number }>();\n    const bySource = { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 }, memory: { count: 0, saved: 0 }, docs: { count: 0, saved: 0 }, data: { count: 0, saved: 0 } };\n\n    for (const r of records) {\n      totalOriginal += r.originalTokens;\n      totalCompressed += r.compressedTokens;\n\n      const family = this.extractFamily(r.strategy);\n      const existing = byFamily.get(family) || { count: 0, totalOriginal: 0, totalCompressed: 0 };\n      existing.count++;\n      existing.totalOriginal += r.originalTokens;\n      existing.totalCompressed += r.compressedTokens;\n      byFamily.set(family, existing);\n\n      const source = (r.source || 'exec') as 'exec' | 'graph' | 'memory' | 'docs' | 'data';\n      if (bySource[source]) {\n        bySource[source].count++;\n        bySource[source].saved += r.originalTokens - r.compressedTokens;\n      } else {\n        bySource.exec.count++;\n        bySource.exec.saved += r.originalTokens - r.compressedTokens;\n      }\n    }\n\n    const totalSaved = totalOriginal - totalCompressed;\n    const savingsPercent = totalOriginal > 0 ? Math.round((totalSaved / totalOriginal) * 100) : 0;\n\n    // Convert byFamily map to sorted object\n    const byFamilyObj: Record<string, { count: number; savings: number }> = {};\n    const sortedFamilies = [...byFamily.entries()].sort((a, b) => b[1].count - a[1].count);\n    for (const [family, data] of sortedFamilies) {\n      const familySaved = data.totalOriginal - data.totalCompressed;\n      const familyPercent = data.totalOriginal > 0 ? Math.round((familySaved / data.totalOriginal) * 100) : 0;\n      byFamilyObj[family] = { count: data.count, savings: familyPercent };\n    }\n\n    // Recent commands (last 10)\n    const recentCommands = records.slice(-10).reverse().map(r => ({\n      command: r.command,\n      savings: r.originalTokens > 0\n        ? Math.round(((r.originalTokens - r.compressedTokens) / r.originalTokens) * 100)\n        : 0,\n      timestamp: r.timestamp,\n      source: r.source,\n    }));\n\n    return {\n      totalCommands: records.length,\n      totalOriginal,\n      totalCompressed,\n      totalSaved,\n      savingsPercent,\n      byFamily: byFamilyObj,\n      recentCommands,\n      bySource,\n    };\n  }\n\n  /**\n   * Get raw history for CLI display.\n   */\n  getHistory(limit: number = 20): TokenSavingsRecord[] {\n    const records = this.loadRecords('all');\n    return records.slice(-limit).reverse();\n  }\n\n  /**\n   * Get daily breakdown for graph display.\n   */\n  getDailyBreakdown(days: number = 30): Array<{ date: string; commands: number; saved: number }> {\n    const records = this.loadRecords('all');\n    const now = Date.now();\n    const cutoff = now - days * 24 * 60 * 60 * 1000;\n\n    const byDay = new Map<string, { commands: number; saved: number }>();\n\n    for (const r of records) {\n      if (r.timestamp < cutoff) continue;\n      const date = new Date(r.timestamp).toISOString().slice(0, 10);\n      const existing = byDay.get(date) || { commands: 0, saved: 0 };\n      existing.commands++;\n      existing.saved += r.originalTokens - r.compressedTokens;\n      byDay.set(date, existing);\n    }\n\n    return [...byDay.entries()]\n      .sort((a, b) => a[0].localeCompare(b[0]))\n      .map(([date, data]) => ({ date, ...data }));\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private loadRecords(period: 'session' | 'today' | 'week' | 'all'): TokenSavingsRecord[] {\n    if (!fs.existsSync(this.filePath)) return [];\n\n    let lines: string[];\n    try {\n      lines = fs.readFileSync(this.filePath, 'utf8').split('\\n').filter(l => l.trim());\n    } catch {\n      return [];\n    }\n\n    const records: TokenSavingsRecord[] = [];\n    for (const line of lines) {\n      try {\n        records.push(JSON.parse(line));\n      } catch {\n        // Skip malformed lines\n      }\n    }\n\n    // Filter by period\n    const now = Date.now();\n    switch (period) {\n      case 'session':\n        return records.filter(r => r.sessionId === this.sessionId);\n      case 'today': {\n        const startOfDay = new Date();\n        startOfDay.setHours(0, 0, 0, 0);\n        return records.filter(r => r.timestamp >= startOfDay.getTime());\n      }\n      case 'week':\n        return records.filter(r => r.timestamp >= now - 7 * 24 * 60 * 60 * 1000);\n      case 'all':\n        return records;\n    }\n  }\n\n  private extractFamily(strategy: string): string {\n    // \"git:status:ultra\" \u2192 \"git\"\n    // \"jest:failures\" \u2192 \"jest\"\n    const colon = strategy.indexOf(':');\n    return colon > 0 ? strategy.slice(0, colon) : strategy;\n  }\n\n  private maybeRotate(): void {\n    try {\n      const stat = fs.statSync(this.filePath);\n      // Rotate if file exceeds ~500KB\n      if (stat.size > 500 * 1024) {\n        const lines = fs.readFileSync(this.filePath, 'utf8').split('\\n').filter(l => l.trim());\n        if (lines.length > MAX_RECORDS) {\n          // Keep last half\n          const keep = lines.slice(-Math.floor(MAX_RECORDS / 2));\n          fs.writeFileSync(this.filePath, keep.join('\\n') + '\\n', 'utf8');\n        }\n      }\n    } catch {\n      // Non-critical\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * KiroGraph Token Savings Tracker\n *\n * Records compression results to a local JSON file for analytics.\n * Uses a simple append-only JSON lines file to avoid SQLite dependency\n * in the compression module (keeps it lightweight and independent).\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as crypto from 'crypto';\nimport type { TokenSavingsRecord } from './types';\n\nconst TRACKER_DIR = '.kirograph';\nconst TRACKER_FILE = 'token-savings.jsonl';\nconst MAX_RECORDS = 5000; // Rotate after this many records\n\nexport interface GainStats {\n  totalCommands: number;\n  totalOriginal: number;\n  totalCompressed: number;\n  totalSaved: number;\n  savingsPercent: number;\n  byFamily: Record<string, { count: number; savings: number }>;\n  recentCommands: Array<{ command: string; savings: number; timestamp: number; source?: string }>;\n  /** Breakdown by source type */\n  bySource: {\n    exec: { count: number; saved: number };\n    graph: { count: number; saved: number };\n    memory: { count: number; saved: number };\n    docs: { count: number; saved: number };\n    data: { count: number; saved: number };\n  };\n}\n\nexport class TokenTracker {\n  private filePath: string;\n  private sessionId: string;\n\n  constructor(projectRoot: string) {\n    const dir = path.join(projectRoot, TRACKER_DIR);\n    fs.mkdirSync(dir, { recursive: true });\n    this.filePath = path.join(dir, TRACKER_FILE);\n    this.sessionId = this.getOrCreateSessionId(dir);\n  }\n\n  private getOrCreateSessionId(dir: string): string {\n    const sessionFile = path.join(dir, '.session-id');\n    try {\n      const existing = fs.readFileSync(sessionFile, 'utf8').trim();\n      if (existing) return existing;\n    } catch { /* file doesn't exist */ }\n\n    const id = crypto.randomBytes(8).toString('hex');\n    try {\n      fs.writeFileSync(sessionFile, id, 'utf8');\n    } catch { /* ignore write errors */ }\n    return id;\n  }\n\n  /**\n   * Record a compression result.\n   */\n  record(command: string, originalTokens: number, compressedTokens: number, strategy: string, source: 'exec' | 'graph' | 'memory' | 'docs' | 'data' = 'exec'): void {\n    const record: TokenSavingsRecord = {\n      timestamp: Date.now(),\n      command: command.slice(0, 200), // Truncate long commands\n      originalTokens,\n      compressedTokens,\n      strategy,\n      sessionId: this.sessionId,\n      source,\n    };\n\n    try {\n      fs.appendFileSync(this.filePath, JSON.stringify(record) + '\\n', 'utf8');\n      this.maybeRotate();\n    } catch {\n      // Non-critical \u2014 don't crash on tracking failure\n    }\n  }\n\n  /**\n   * Record a graph tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without the tool\n   */\n  recordGraphSaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `graph:${toolName}`, 'graph');\n  }\n\n  /**\n   * Record a memory tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without memory\n   */\n  recordMemorySaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `memory:${toolName}`, 'memory');\n  }\n\n  /**\n   * Record a docs tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without docs indexing\n   */\n  recordDocsSaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `docs:${toolName}`, 'docs');\n  }\n\n  /**\n   * Record a data tool saving.\n   * @param toolName - The MCP tool that was called\n   * @param outputTokens - Actual tokens returned by the tool\n   * @param naiveCost - Estimated tokens the agent would have used without data indexing\n   */\n  recordDataSaving(toolName: string, outputTokens: number, naiveCost: number): void {\n    this.record(toolName, naiveCost, outputTokens, `data:${toolName}`, 'data');\n  }\n\n  /**\n   * Get aggregated statistics for a time period.\n   */\n  getStats(period: 'session' | 'today' | 'week' | 'all'): GainStats {\n    const records = this.loadRecords(period);\n\n    if (records.length === 0) {\n      return {\n        totalCommands: 0,\n        totalOriginal: 0,\n        totalCompressed: 0,\n        totalSaved: 0,\n        savingsPercent: 0,\n        byFamily: {},\n        recentCommands: [],\n        bySource: { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 }, memory: { count: 0, saved: 0 }, docs: { count: 0, saved: 0 }, data: { count: 0, saved: 0 } },\n      };\n    }\n\n    let totalOriginal = 0;\n    let totalCompressed = 0;\n    const byFamily = new Map<string, { count: number; totalOriginal: number; totalCompressed: number }>();\n    const bySource = { exec: { count: 0, saved: 0 }, graph: { count: 0, saved: 0 }, memory: { count: 0, saved: 0 }, docs: { count: 0, saved: 0 }, data: { count: 0, saved: 0 } };\n\n    for (const r of records) {\n      totalOriginal += r.originalTokens;\n      totalCompressed += r.compressedTokens;\n\n      const family = this.extractFamily(r.strategy);\n      const existing = byFamily.get(family) || { count: 0, totalOriginal: 0, totalCompressed: 0 };\n      existing.count++;\n      existing.totalOriginal += r.originalTokens;\n      existing.totalCompressed += r.compressedTokens;\n      byFamily.set(family, existing);\n\n      const source = (r.source || 'exec') as 'exec' | 'graph' | 'memory' | 'docs' | 'data';\n      if (bySource[source]) {\n        bySource[source].count++;\n        bySource[source].saved += r.originalTokens - r.compressedTokens;\n      } else {\n        bySource.exec.count++;\n        bySource.exec.saved += r.originalTokens - r.compressedTokens;\n      }\n    }\n\n    const totalSaved = totalOriginal - totalCompressed;\n    const savingsPercent = totalOriginal > 0 ? Math.round((totalSaved / totalOriginal) * 100) : 0;\n\n    // Convert byFamily map to sorted object\n    const byFamilyObj: Record<string, { count: number; savings: number }> = {};\n    const sortedFamilies = [...byFamily.entries()].sort((a, b) => b[1].count - a[1].count);\n    for (const [family, data] of sortedFamilies) {\n      const familySaved = data.totalOriginal - data.totalCompressed;\n      const familyPercent = data.totalOriginal > 0 ? Math.round((familySaved / data.totalOriginal) * 100) : 0;\n      byFamilyObj[family] = { count: data.count, savings: familyPercent };\n    }\n\n    // Recent commands (last 10)\n    const recentCommands = records.slice(-10).reverse().map(r => ({\n      command: r.command,\n      savings: r.originalTokens > 0\n        ? Math.round(((r.originalTokens - r.compressedTokens) / r.originalTokens) * 100)\n        : 0,\n      timestamp: r.timestamp,\n      source: r.source,\n    }));\n\n    return {\n      totalCommands: records.length,\n      totalOriginal,\n      totalCompressed,\n      totalSaved,\n      savingsPercent,\n      byFamily: byFamilyObj,\n      recentCommands,\n      bySource,\n    };\n  }\n\n  /**\n   * Get raw history for CLI display.\n   */\n  getHistory(limit: number = 20): TokenSavingsRecord[] {\n    const records = this.loadRecords('all');\n    return records.slice(-limit).reverse();\n  }\n\n  /**\n   * Get daily breakdown for graph display.\n   */\n  getDailyBreakdown(days: number = 30): Array<{ date: string; commands: number; saved: number }> {\n    const records = this.loadRecords('all');\n    const now = Date.now();\n    const cutoff = now - days * 24 * 60 * 60 * 1000;\n\n    const byDay = new Map<string, { commands: number; saved: number }>();\n\n    for (const r of records) {\n      if (r.timestamp < cutoff) continue;\n      const date = new Date(r.timestamp).toISOString().slice(0, 10);\n      const existing = byDay.get(date) || { commands: 0, saved: 0 };\n      existing.commands++;\n      existing.saved += r.originalTokens - r.compressedTokens;\n      byDay.set(date, existing);\n    }\n\n    return [...byDay.entries()]\n      .sort((a, b) => a[0].localeCompare(b[0]))\n      .map(([date, data]) => ({ date, ...data }));\n  }\n\n  // \u2500\u2500 Private \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  private loadRecords(period: 'session' | 'today' | 'week' | 'all'): TokenSavingsRecord[] {\n    if (!fs.existsSync(this.filePath)) return [];\n\n    let lines: string[];\n    try {\n      lines = fs.readFileSync(this.filePath, 'utf8').split('\\n').filter(l => l.trim());\n    } catch {\n      return [];\n    }\n\n    const records: TokenSavingsRecord[] = [];\n    for (const line of lines) {\n      try {\n        records.push(JSON.parse(line));\n      } catch {\n        // Skip malformed lines\n      }\n    }\n\n    // Filter by period\n    const now = Date.now();\n    switch (period) {\n      case 'session':\n        return records.filter(r => r.sessionId === this.sessionId);\n      case 'today': {\n        const startOfDay = new Date();\n        startOfDay.setHours(0, 0, 0, 0);\n        return records.filter(r => r.timestamp >= startOfDay.getTime());\n      }\n      case 'week':\n        return records.filter(r => r.timestamp >= now - 7 * 24 * 60 * 60 * 1000);\n      case 'all':\n        return records;\n    }\n  }\n\n  private extractFamily(strategy: string): string {\n    // \"git:status:ultra\" \u2192 \"git\"\n    // \"jest:failures\" \u2192 \"jest\"\n    const colon = strategy.indexOf(':');\n    return colon > 0 ? strategy.slice(0, colon) : strategy;\n  }\n\n  private maybeRotate(): void {\n    try {\n      const stat = fs.statSync(this.filePath);\n      // Rotate if file exceeds ~500KB\n      if (stat.size > 500 * 1024) {\n        const lines = fs.readFileSync(this.filePath, 'utf8').split('\\n').filter(l => l.trim());\n        if (lines.length > MAX_RECORDS) {\n          // Keep last half\n          const keep = lines.slice(-Math.floor(MAX_RECORDS / 2));\n          fs.writeFileSync(this.filePath, keep.join('\\n') + '\\n', 'utf8');\n        }\n      }\n    } catch {\n      // Non-critical\n    }\n  }\n}\n\n\n// \u2500\u2500 Context Budget Governance \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport interface BudgetConfig {\n  maxTokensPerSession: number;\n  warnAt: number;\n  throttleAt: number;\n}\n\nexport interface BudgetStatus {\n  consumed: number;\n  limit: number;\n  remaining: number;\n  utilization: number;\n  warning: string | null;\n  throttled: boolean;\n}\n\nconst DEFAULT_BUDGET: BudgetConfig = {\n  maxTokensPerSession: 100_000,\n  warnAt: 80_000,\n  throttleAt: 95_000,\n};\n\n/**\n * Session-scoped context budget tracker.\n * Tracks cumulative token consumption and enforces budget limits.\n */\nexport class BudgetTracker {\n  private static instances = new Map<string, BudgetTracker>();\n\n  private consumed = 0;\n  private config: BudgetConfig;\n  private projectRoot: string;\n\n  private constructor(projectRoot: string, config?: Partial<BudgetConfig>) {\n    this.projectRoot = projectRoot;\n    this.config = { ...DEFAULT_BUDGET, ...config };\n  }\n\n  static getInstance(projectRoot: string, config?: Partial<BudgetConfig>): BudgetTracker {\n    const key = projectRoot;\n    if (!BudgetTracker.instances.has(key)) {\n      BudgetTracker.instances.set(key, new BudgetTracker(projectRoot, config));\n    }\n    const instance = BudgetTracker.instances.get(key)!;\n    if (config) {\n      instance.config = { ...DEFAULT_BUDGET, ...config };\n    }\n    return instance;\n  }\n\n  /**\n   * Record tokens consumed by a tool response.\n   */\n  recordConsumption(tokens: number): void {\n    this.consumed += tokens;\n  }\n\n  /**\n   * Get current budget status.\n   */\n  getStatus(): BudgetStatus {\n    const limit = this.config.maxTokensPerSession;\n    const remaining = Math.max(0, limit - this.consumed);\n    const utilization = limit > 0 ? Math.round((this.consumed / limit) * 100) : 0;\n\n    let warning: string | null = null;\n    if (limit > 0 && this.consumed >= this.config.throttleAt) {\n      warning = `Budget nearly exhausted (${utilization}%). Responses will be truncated.`;\n    } else if (limit > 0 && this.consumed >= this.config.warnAt) {\n      warning = `Approaching budget limit (${utilization}%). Consider using compact read modes.`;\n    }\n\n    return {\n      consumed: this.consumed,\n      limit,\n      remaining,\n      utilization,\n      warning,\n      throttled: limit > 0 && this.consumed >= this.config.throttleAt,\n    };\n  }\n\n  /**\n   * Check if the budget is throttled (responses should be truncated).\n   */\n  isThrottled(): boolean {\n    return this.config.maxTokensPerSession > 0 && this.consumed >= this.config.throttleAt;\n  }\n\n  /**\n   * Check if a warning should be appended to responses.\n   */\n  shouldWarn(): boolean {\n    return this.config.maxTokensPerSession > 0 && this.consumed >= this.config.warnAt;\n  }\n\n  /**\n   * Reset the budget counters.\n   */\n  reset(): void {\n    this.consumed = 0;\n  }\n\n  /**\n   * Update budget configuration.\n   */\n  updateConfig(config: Partial<BudgetConfig>): void {\n    this.config = { ...this.config, ...config };\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/compression/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * KiroGraph Shell Compression — Type Definitions
+ */
+export interface CompressionResult {
+    /** Compressed output text */
+    output: string;
+    /** Estimated original token count */
+    originalTokens: number;
+    /** Estimated compressed token count */
+    compressedTokens: number;
+    /** Percentage saved (0-100) */
+    savings: number;
+    /** Which strategy was applied */
+    strategy: string;
+    /** The detected command family */
+    commandFamily: string;
+}
+export interface CompressorOptions {
+    /** Compression aggressiveness */
+    level: 'normal' | 'aggressive' | 'ultra';
+    /** Max output tokens (truncate beyond this) */
+    maxOutputTokens?: number;
+    /** Never compress error details (default: true) */
+    preserveErrors?: boolean;
+}
+export interface FilterResult {
+    output: string;
+    strategy: string;
+}
+export interface CommandFilter {
+    /** Name of this filter family */
+    name: string;
+    /** Test if this filter handles the given command */
+    matches(command: string): boolean;
+    /** Apply the filter to raw output */
+    filter(command: string, rawOutput: string, level: CompressorOptions['level']): FilterResult;
+}
+export interface TokenSavingsRecord {
+    id?: number;
+    timestamp: number;
+    command: string;
+    originalTokens: number;
+    compressedTokens: number;
+    strategy: string;
+    sessionId: string;
+    /** Source of the saving: 'exec' for compression, 'graph' for MCP graph tools, 'memory' for memory tools, 'docs' for documentation tools, 'data' for data tools */
+    source?: 'exec' | 'graph' | 'memory' | 'docs' | 'data';
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/compression/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compression/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,KAAK,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;IACzC,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,qCAAqC;IACrC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC;CAC7F;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,kKAAkK;IAClK,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;CACxD"}

package/dist/config.d.ts

@@ -31,6 +31,96 @@ export interface KiroGraphConfig {
      * Example: { "api": ["src/routes/**", "src/controllers/**"] }
      */
     architectureLayers?: Record<string, string[]>;
+    /** Agent communication style injected at agentSpawn. Default: 'off'. */
+    cavemanMode: 'off' | 'lite' | 'full' | 'ultra';
+    /** Shell compression level for kirograph_exec. 'off' disables the hook/steering. Default: 'normal'. */
+    shellCompressionLevel: 'off' | 'normal' | 'aggressive' | 'ultra';
+    /**
+     * Number of pending (unindexed) files above which kirograph_status warns the agent.
+     * Set to 0 to disable the warning. Default: 10.
+     */
+    syncWarningThreshold: number;
+    /** Enable persistent cross-session memory. Default: false. */
+    enableMemory: boolean;
+    /** FTS/vector blend for memory search: 0 = FTS only, 1 = vector only. Default: 0.5. */
+    memorySearchAlpha: number;
+    /** Store uncompressed originals when caveman is on. Default: false. */
+    memoryKeepRaw: boolean;
+    /** Auto-prune threshold (max observations). 0 = no limit. Default: 10000. */
+    memoryMaxObservations: number;
+    /** Seconds of inactivity before auto-closing a session. Default: 7200. */
+    memorySessionTimeout: number;
+    /** Max observations shown in kirograph_context. Default: 3. */
+    memoryContextLimit: number;
+    /** Min relevance score to include memory in context. Default: 0.3. */
+    memoryContextThreshold: number;
+    /** Glob patterns for paths to never capture in memory. Default: []. */
+    memoryExcludePatterns: string[];
+    /** Enable documentation indexing and navigation. Default: false. */
+    enableDocs: boolean;
+    /** Glob patterns for documentation files to include. */
+    docsInclude: string[];
+    /** Glob patterns for documentation files to exclude. */
+    docsExclude: string[];
+    /** Enable auto-linking of doc sections to code symbols. Default: true. */
+    docsLinkCode: boolean;
+    /** Max doc sections to include in kirograph_context. 0 = disabled. Default: 0. */
+    docsContextLimit: number;
+    /** Min relevance score to include a doc section in context. Default: 0.3. */
+    docsContextThreshold: number;
+    /** Max file size for doc files (bytes). Default: 1MB. */
+    docsMaxFileSize: number;
+    /** Summarization strategy. Default: 'first-sentence'. */
+    docsSummarization: 'embedding' | 'first-sentence' | 'off';
+    /** Enable tabular data indexing and querying. Default: false. */
+    enableData: boolean;
+    /** Glob patterns for data files to include. */
+    dataInclude: string[];
+    /** Glob patterns for data files to exclude. */
+    dataExclude: string[];
+    /** Enable auto-linking of data files to code symbols. Default: true. */
+    dataLinkCode: boolean;
+    /** Max datasets to include in kirograph_context. 0 = disabled. Default: 0. */
+    dataContextLimit: number;
+    /** Max file size for data files (bytes). Default: 50MB. */
+    dataMaxFileSize: number;
+    /** Max rows to index per file. Default: 1,000,000. */
+    dataMaxRows: number;
+    /** Max rows returned per query. Default: 500. */
+    dataQueryLimit: number;
+    /** Max token budget per response. Default: 8000. */
+    dataMaxResponseTokens: number;
+    /** Enable security analysis (dependency scanning + vulnerability detection). Default: false. */
+    enableSecurity: boolean;
+    /** Vulnerability databases to query. Default: ['OSV']. */
+    securityDatabases: string[];
+    /** Enable AST-level structural pattern matching (SAST) during indexing. Default: false. */
+    enablePatterns: boolean;
+    /** Path to a directory of user-supplied YAML rule files. Merged with bundled library (user rules win on id conflict). Default: undefined. */
+    patternLibraryPath: string | undefined;
+    /** Minimum severity level for storing pattern matches during index-time analysis. Default: 'low'. */
+    patternSeverityThreshold: 'critical' | 'high' | 'medium' | 'low';
+    /** Auto-run vulnerability enrichment after manifest parsing. Default: true. */
+    securityAutoEnrich: boolean;
+    /** Max age in days for vulnerability data before showing a staleness warning. Default: 7. */
+    securityEnrichMaxAgeDays: number;
+    /**
+     * License policy for dependency compliance.
+     * deny: licenses to block (build fails / command exits non-zero).
+     * warn: licenses to flag as warnings.
+     * Patterns support wildcards: GPL-* matches GPL-2.0, GPL-3.0, etc.
+     * Default: { deny: [], warn: [] }.
+     */
+    securityLicensePolicy: {
+        deny: string[];
+        warn: string[];
+    };
+    /** Context budget governance settings. */
+    contextBudget?: {
+        maxTokensPerSession: number;
+        warnAt: number;
+        throttleAt: number;
+    };
 }
 /**
  * Returns false if the pattern is potentially dangerous (ReDoS risk) or too long.

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;IAExB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAClG,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,sFAAsF;IACtF,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC/C;AAmBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAOpD;AAID,wBAAgB,mBAAmB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,CAqB1E;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,CA8F/D;AA+BD,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAsB9E;AAED,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5F;AAUD,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAC9B,OAAO,CAAC,eAAe,CAAC,CAK1B;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/F;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/F;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAUnF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}