briefed 0.1.0

package/dist/deliver/hooks.js

@@ -0,0 +1,315 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+/**
+ * Install briefed hooks into .claude/settings.json.
+ * Adds SessionStart (compact) and UserPromptSubmit hooks.
+ */
+export function installHooks(root) {
+    const claudeDir = join(root, ".claude");
+    const settingsPath = join(claudeDir, "settings.json");
+    // Ensure .claude directory exists
+    if (!existsSync(claudeDir)) {
+        mkdirSync(claudeDir, { recursive: true });
+    }
+    // Load existing settings or create new
+    // Security: backup existing settings before modifying
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        try {
+            const raw = readFileSync(settingsPath, "utf-8");
+            settings = JSON.parse(raw);
+            // Backup before modifying
+            writeFileSync(settingsPath + ".briefed-backup", raw);
+        }
+        catch {
+            settings = {};
+        }
+    }
+    // Initialize hooks object
+    if (!settings.hooks)
+        settings.hooks = {};
+    // Remove any existing briefed hooks (for idempotency)
+    for (const eventName of Object.keys(settings.hooks)) {
+        settings.hooks[eventName] = settings.hooks[eventName].filter((entry) => !entry.hooks.some((h) => h.command.includes("briefed")));
+        if (settings.hooks[eventName].length === 0) {
+            delete settings.hooks[eventName];
+        }
+    }
+    // Add SessionStart hook (compact matcher) — re-inject skeleton after compaction
+    if (!settings.hooks.SessionStart)
+        settings.hooks.SessionStart = [];
+    settings.hooks.SessionStart.push({
+        matcher: "compact",
+        hooks: [
+            {
+                type: "command",
+                command: `node "${join(root, ".briefed", "hooks", "session-start.js")}"`,
+                timeout: 5,
+            },
+        ],
+    });
+    // Add UserPromptSubmit hook — dynamic per-prompt context injection
+    if (!settings.hooks.UserPromptSubmit)
+        settings.hooks.UserPromptSubmit = [];
+    settings.hooks.UserPromptSubmit.push({
+        hooks: [
+            {
+                type: "command",
+                command: `node "${join(root, ".briefed", "hooks", "prompt-submit.js")}"`,
+                timeout: 5,
+            },
+        ],
+    });
+    // Add PostToolUse hook — learning loop (tracks file reads)
+    if (!settings.hooks.PostToolUse)
+        settings.hooks.PostToolUse = [];
+    settings.hooks.PostToolUse.push({
+        matcher: "Read",
+        hooks: [
+            {
+                type: "command",
+                command: `node "${join(root, ".briefed", "hooks", "post-read.js")}"`,
+                timeout: 2,
+            },
+        ],
+    });
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+}
+/**
+ * Generate the hook scripts that get executed by Claude Code.
+ */
+export function generateHookScripts(root) {
+    const hooksDir = join(root, ".briefed", "hooks");
+    mkdirSync(hooksDir, { recursive: true });
+    // SessionStart hook — re-inject skeleton after compaction
+    const sessionStartScript = `#!/usr/bin/env node
+// briefed: SessionStart hook — re-inject skeleton after compaction
+// Security: only reads from .briefed/ directory, never writes, never persists input
+const { readFileSync, realpathSync } = require("fs");
+const { join, resolve } = require("path");
+
+const briefedDir = resolve(join(__dirname, ".."));
+const skeletonPath = join(briefedDir, "skeleton.md");
+
+// Verify the skeleton file is inside .briefed/ (prevent path traversal)
+try {
+  const realPath = realpathSync(skeletonPath);
+  if (!realPath.startsWith(realpathSync(briefedDir))) process.exit(0);
+  process.stdout.write(readFileSync(realPath, "utf-8"));
+} catch {}
+`.trim();
+    writeFileSync(join(hooksDir, "session-start.js"), sessionStartScript);
+    // UserPromptSubmit hook — analyze prompt, inject relevant contracts + dependencies
+    const promptSubmitScript = `
+#!/usr/bin/env node
+// briefed: UserPromptSubmit hook — adaptive context injection
+// Security: read-only, never persists prompt data, all file reads scoped to .briefed/
+const { readFileSync, existsSync, realpathSync } = require("fs");
+const { join, resolve } = require("path");
+
+const briefedDir = resolve(join(__dirname, ".."));
+const contractsDir = join(briefedDir, "contracts");
+const indexPath = join(briefedDir, "index.json");
+const testMapPath = join(briefedDir, "test-map.json");
+const historyPath = join(briefedDir, "history.json");
+
+// Security: verify a path is inside .briefed/ before reading
+function safeRead(filePath) {
+  try {
+    const real = realpathSync(filePath);
+    if (!real.startsWith(realpathSync(briefedDir))) return null;
+    return readFileSync(real, "utf-8");
+  } catch { return null; }
+}
+function safeExists(filePath) {
+  try {
+    if (!existsSync(filePath)) return false;
+    return realpathSync(filePath).startsWith(realpathSync(briefedDir));
+  } catch { return false; }
+}
+
+// Complexity scoring — determines how much context to inject
+function scorePrompt(prompt) {
+  let score = 3; // baseline: moderate
+
+  // High complexity signals (+2 each)
+  const highSignals = [/refactor/i, /restructur/i, /redesign/i, /migrat/i, /debug/i, /investigate/i, /\\bwhy\\b/i, /architect/i, /\\bsystem\\b/i, /security/i, /vulnerab/i, /performance/i, /optimiz/i];
+  for (const s of highSignals) { if (s.test(prompt)) score += 2; }
+
+  // Medium signals (+1 each)
+  const medSignals = [/\\badd\\b/i, /implement/i, /create/i, /build/i, /integrat/i, /\\btest/i, /endpoint/i, /feature/i, /module/i, /service/i];
+  for (const s of medSignals) { if (s.test(prompt)) score += 1; }
+
+  // Low complexity signals (-2 each)
+  const lowSignals = [/typo/i, /rename/i, /comment/i, /\\blog\\b/i, /print/i, /format/i, /lint/i, /spell/i];
+  for (const s of lowSignals) { if (s.test(prompt)) score -= 2; }
+
+  // Long prompts = more complex
+  if (prompt.length > 200) score += 1;
+  if (prompt.length > 500) score += 1;
+  if (prompt.length < 30) score -= 1;
+
+  // Multiple file/module mentions = complex
+  const fileRefs = (prompt.match(/\\w+\\.\\w{2,4}/g) || []).length;
+  if (fileRefs >= 2) score += 2;
+
+  return Math.max(1, Math.min(10, score));
+}
+
+let input = "";
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => { input += chunk; });
+process.stdin.on("end", () => {
+  try {
+    const data = JSON.parse(input);
+    const prompt = (data.prompt || data.message || "").toLowerCase();
+
+    if (!prompt || !safeExists(indexPath)) {
+      process.exit(0);
+      return;
+    }
+
+    // Security: truncate prompt analysis to prevent ReDoS on long inputs
+    const safePrompt = prompt.slice(0, 2000);
+    const index = JSON.parse(safeRead(indexPath) || "{}");
+    if (!index.modules) { process.exit(0); return; }
+    const complexity = scorePrompt(safePrompt);
+
+    // Adaptive budget based on prompt complexity
+    // Simple (1-3): 1500 chars (~400 tokens) — contracts only
+    // Moderate (4-6): 5000 chars (~1350 tokens) — contracts + deps
+    // Complex (7-10): 9000 chars (~2400 tokens) — contracts + deps + tests + history
+    const budget = complexity <= 3 ? 1500 : complexity <= 6 ? 5000 : 9000;
+    const includeDeps = complexity >= 4;
+    const includeTests = complexity >= 7;
+    const includeHistory = complexity >= 7;
+
+    let used = 0;
+    const loaded = new Set();
+    const output = [];
+
+    // Score each module by keyword hits
+    const scored = index.modules.map((mod) => {
+      const keywords = mod.keywords || [];
+      const hits = keywords.filter((k) => safePrompt.includes(k.toLowerCase()));
+      return { mod, hits: hits.length, complexity: mod.complexity || 0 };
+    })
+    .filter((s) => s.hits > 0)
+    .sort((a, b) => b.hits - a.hits || b.complexity - a.complexity);
+
+    // Load matching modules + their dependencies
+    for (const { mod } of scored) {
+      if (used >= budget) break;
+
+      // Load the module's contract
+      if (!loaded.has(mod.file)) {
+        const contractPath = join(contractsDir, mod.file);
+        const contract = safeRead(contractPath);
+        if (contract) {
+          if (used + contract.length <= budget) {
+            output.push("# Module: " + mod.dir + "\\n" + contract);
+            used += contract.length;
+            loaded.add(mod.file);
+          }
+        }
+      }
+
+      // Load dependency modules (moderate+ complexity)
+      if (includeDeps) {
+        const contractPath2 = join(contractsDir, mod.file);
+        const contractText = safeRead(contractPath2);
+        if (contractText) {
+          const depMatch = contractText.match(/dependencies:\\n([\\s\\S]*?)(?:\\n\\w|$)/);
+          if (depMatch) {
+            const deps = depMatch[1].match(/- (.+)/g) || [];
+            for (const dep of deps) {
+              const depName = dep.replace("- ", "").trim();
+              const depMod = index.modules.find((m) => m.name === depName);
+              if (depMod && !loaded.has(depMod.file) && used < budget) {
+                const depPath = join(contractsDir, depMod.file);
+                const depContract = safeRead(depPath);
+                if (depContract) {
+                  if (used + depContract.length <= budget) {
+                    output.push("# Dependency: " + depMod.dir + "\\n" + depContract);
+                    used += depContract.length;
+                    loaded.add(depMod.file);
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+
+      // Inject test info for matched modules (complex tasks only)
+      if (includeTests && safeExists(testMapPath) && used < budget) {
+        try {
+          const testMap = JSON.parse(safeRead(testMapPath) || "{}");
+          for (const file of mod.files || []) {
+            const testInfo = testMap[file];
+            if (testInfo && used < budget) {
+              const testLine = "# Tests for " + file + ": " + testInfo.test + " (" + testInfo.count + " tests)\\n" +
+                (testInfo.names || []).slice(0, 5).map((n) => "  - " + n).join("\\n");
+              if (used + testLine.length <= budget) {
+                output.push(testLine);
+                used += testLine.length;
+              }
+            }
+          }
+        } catch {}
+      }
+
+      // Inject history for matched modules (complex tasks only)
+      if (includeHistory && safeExists(historyPath) && used < budget) {
+        try {
+          const history = JSON.parse(safeRead(historyPath) || "{}");
+          for (const file of mod.files || []) {
+            const hist = history[file];
+            if (hist && hist.recent && hist.recent.length > 0 && used < budget) {
+              const histLine = "# History for " + file + " (" + hist.frequency + " recent commits):\\n" +
+                hist.recent.slice(0, 3).map((m) => "  - " + m).join("\\n");
+              if (used + histLine.length <= budget) {
+                output.push(histLine);
+                used += histLine.length;
+              }
+            }
+          }
+        } catch {}
+      }
+    }
+
+    if (output.length > 0) {
+      process.stdout.write(output.join("\\n---\\n"));
+    }
+  } catch {
+    // Fail silently
+  }
+  process.exit(0);
+});
+`.trim();
+    writeFileSync(join(hooksDir, "prompt-submit.js"), promptSubmitScript);
+    // PostToolUse hook — learning loop (tracks file reads for future improvement)
+    writeFileSync(join(hooksDir, "post-read.js"), `#!/usr/bin/env node
+// briefed: PostToolUse hook — tracks which files Claude reads for the learning loop
+// Security: only appends to .briefed/session-reads.log, never reads prompt content
+const { appendFileSync, mkdirSync, existsSync } = require("fs");
+const { join } = require("path");
+
+let input = "";
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => { input += chunk; });
+process.stdin.on("end", () => {
+  try {
+    const data = JSON.parse(input);
+    if (data.tool_name !== "Read") { process.exit(0); return; }
+    const filePath = data.tool_input && data.tool_input.file_path;
+    if (!filePath) { process.exit(0); return; }
+    const briefedDir = join(process.cwd(), ".briefed");
+    if (!existsSync(briefedDir)) mkdirSync(briefedDir, { recursive: true });
+    appendFileSync(join(briefedDir, "session-reads.log"), filePath + "\\n");
+  } catch {}
+  process.exit(0);
+});
+`);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/deliver/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/deliver/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAW,MAAM,MAAM,CAAC;AAcrC;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IAEtD,kCAAkC;IAClC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,uCAAuC;IACvC,sDAAsD;IACtD,IAAI,QAAQ,GAAmB,EAAE,CAAC;IAClC,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAChD,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3B,0BAA0B;YAC1B,aAAa,CAAC,YAAY,GAAG,iBAAiB,EAAE,GAAG,CAAC,CAAC;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,IAAI,CAAC,QAAQ,CAAC,KAAK;QAAE,QAAQ,CAAC,KAAK,GAAG,EAAE,CAAC;IAEzC,sDAAsD;IACtD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAC1D,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CACnE,CAAC;QACF,IAAI,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,YAAY;QAAE,QAAQ,CAAC,KAAK,CAAC,YAAY,GAAG,EAAE,CAAC;IACnE,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC;QAC/B,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,CAAC,GAAG;gBACxE,OAAO,EAAE,CAAC;aACX;SACF;KACF,CAAC,CAAC;IAEH,mEAAmE;IACnE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB;QAAE,QAAQ,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC;IAC3E,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC;QACnC,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,CAAC,GAAG;gBACxE,OAAO,EAAE,CAAC;aACX;SACF;KACF,CAAC,CAAC;IAEH,2DAA2D;IAC3D,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW;QAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,CAAC;IACjE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC;QAC9B,OAAO,EAAE,MAAM;QACf,KAAK,EAAE;YACL;gBACE,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,GAAG;gBACpE,OAAO,EAAE,CAAC;aACX;SACF;KACF,CAAC,CAAC;IAEH,aAAa,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACxE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACjD,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,0DAA0D;IAC1D,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;CAe5B,CAAC,IAAI,EAAE,CAAC;IAEP,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAEtE,mFAAmF;IACnF,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0L5B,CAAC,IAAI,EAAE,CAAC;IAEP,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IAEtE,8EAA8E;IAC9E,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,EAAE;;;;;;;;;;;;;;;;;;;;;CAqB/C,CAAC,CAAC;AACH,CAAC"}

package/dist/extract/complexity.d.ts

@@ -0,0 +1,16 @@
+import type { FileExtraction } from "./signatures.js";
+import type { DepGraph } from "./depgraph.js";
+export interface ComplexityScore {
+    file: string;
+    score: number;
+    fanOut: number;
+    fanIn: number;
+    branchCount: number;
+    lineCount: number;
+    symbolCount: number;
+}
+/**
+ * Compute complexity score for a file.
+ * Higher score = more context needed when working with this file.
+ */
+export declare function computeComplexity(extraction: FileExtraction, depGraph: DepGraph): ComplexityScore;

package/dist/extract/complexity.js

@@ -0,0 +1,46 @@
+import { readFileSync } from "fs";
+/**
+ * Compute complexity score for a file.
+ * Higher score = more context needed when working with this file.
+ */
+export function computeComplexity(extraction, depGraph) {
+    const content = readFileSync(extraction.path, "utf-8");
+    const fanOut = extraction.imports.filter((i) => i.isRelative).length;
+    const node = depGraph.nodes.get(extraction.path.replace(/\\/g, "/"));
+    const fanIn = node?.inEdges.length || 0;
+    // Count branching constructs
+    const branchPatterns = [
+        /\bif\s*\(/g,
+        /\belse\s+if\s*\(/g,
+        /\bswitch\s*\(/g,
+        /\bcase\s+/g,
+        /\bcatch\s*\(/g,
+        /\?\s*[^:]/g, // ternary
+    ];
+    let branchCount = 0;
+    for (const pattern of branchPatterns) {
+        const matches = content.match(pattern);
+        if (matches)
+            branchCount += matches.length;
+    }
+    // Compute weighted score (0-10)
+    const score = Math.min(10, (clamp(fanOut / 3, 0, 3) + // 0-3 points for imports
+        clamp(fanIn / 3, 0, 3) + // 0-3 points for dependents
+        clamp(branchCount / 15, 0, 2) + // 0-2 points for branching
+        clamp(extraction.lineCount / 200, 0, 1) + // 0-1 points for size
+        clamp(extraction.symbols.length / 10, 0, 1) // 0-1 points for symbol density
+    ));
+    return {
+        file: extraction.path,
+        score: Math.round(score * 10) / 10,
+        fanOut,
+        fanIn,
+        branchCount,
+        lineCount: extraction.lineCount,
+        symbolCount: extraction.symbols.length,
+    };
+}
+function clamp(val, min, max) {
+    return Math.max(min, Math.min(max, val));
+}
+//# sourceMappingURL=complexity.js.map

package/dist/extract/complexity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"complexity.js","sourceRoot":"","sources":["../../src/extract/complexity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAclC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAA0B,EAC1B,QAAkB;IAElB,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAC7B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CACpC,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;IAExC,6BAA6B;IAC7B,MAAM,cAAc,GAAG;QACrB,YAAY;QACZ,mBAAmB;QACnB,gBAAgB;QAChB,YAAY;QACZ,eAAe;QACf,YAAY,EAAG,UAAU;KAC1B,CAAC;IACF,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,OAAO;YAAE,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED,gCAAgC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CACzB,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAS,yBAAyB;QACzD,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAU,4BAA4B;QAC5D,KAAK,CAAC,WAAW,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,2BAA2B;QAC3D,KAAK,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,sBAAsB;QAChE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,gCAAgC;KAC7E,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE;QAClC,MAAM;QACN,KAAK;QACL,WAAW;QACX,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,WAAW,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM;KACvC,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,GAAW,EAAE,GAAW,EAAE,GAAW;IAClD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/extract/conventions.d.ts

@@ -0,0 +1,18 @@
+import type { FileExtraction } from "./signatures.js";
+export interface ProjectConventions {
+    naming: string[];
+    errorHandling: string[];
+    patterns: string[];
+    testing: string[];
+    imports: string[];
+    other: string[];
+}
+/**
+ * Auto-detect project conventions from code patterns.
+ * Prevents the "inconsistent code style" problem that compounds across sessions.
+ */
+export declare function detectConventions(extractions: FileExtraction[], root: string): ProjectConventions;
+/**
+ * Format conventions for inclusion in CLAUDE.md or rules.
+ */
+export declare function formatConventions(conv: ProjectConventions): string;

package/dist/extract/conventions.js

@@ -0,0 +1,143 @@
+import { readFileSync } from "fs";
+/**
+ * Auto-detect project conventions from code patterns.
+ * Prevents the "inconsistent code style" problem that compounds across sessions.
+ */
+export function detectConventions(extractions, root) {
+    const conventions = {
+        naming: [],
+        errorHandling: [],
+        patterns: [],
+        testing: [],
+        imports: [],
+        other: [],
+    };
+    // Sample files for analysis (up to 20 of the most important)
+    const sample = extractions
+        .filter((e) => e.symbols.length > 0)
+        .slice(0, 20);
+    if (sample.length === 0)
+        return conventions;
+    // Analyze naming conventions
+    const allSymbols = sample.flatMap((e) => e.symbols);
+    const exportedFunctions = allSymbols.filter((s) => s.exported && (s.kind === "function" || s.kind === "method"));
+    const exportedTypes = allSymbols.filter((s) => s.exported && (s.kind === "class" || s.kind === "interface" || s.kind === "type"));
+    if (exportedFunctions.length > 3) {
+        const camelCount = exportedFunctions.filter((s) => /^[a-z][a-zA-Z]+$/.test(s.name.split(".").pop())).length;
+        const snakeCount = exportedFunctions.filter((s) => /^[a-z][a-z_]+$/.test(s.name.split(".").pop())).length;
+        if (camelCount > snakeCount * 2) {
+            conventions.naming.push("camelCase for functions and methods");
+        }
+        else if (snakeCount > camelCount * 2) {
+            conventions.naming.push("snake_case for functions and methods");
+        }
+    }
+    if (exportedTypes.length > 2) {
+        const pascalCount = exportedTypes.filter((s) => /^[A-Z][a-zA-Z]+$/.test(s.name)).length;
+        if (pascalCount > exportedTypes.length * 0.7) {
+            conventions.naming.push("PascalCase for types, classes, and interfaces");
+        }
+    }
+    // Analyze error handling patterns
+    const fileContents = sample.map((e) => {
+        try {
+            return readFileSync(e.path, "utf-8");
+        }
+        catch {
+            return "";
+        }
+    });
+    const tryCatchCount = fileContents.filter((c) => c.includes("try {") || c.includes("try:")).length;
+    const resultTypeCount = fileContents.filter((c) => c.includes("Result<") || c.includes("Either<") || c.includes("Result[")).length;
+    const throwCount = fileContents.filter((c) => c.includes("throw new") || c.includes("raise ")).length;
+    if (tryCatchCount > sample.length * 0.3) {
+        conventions.errorHandling.push("uses try/catch for error handling");
+    }
+    if (resultTypeCount > 2) {
+        conventions.errorHandling.push("uses Result/Either types for error propagation");
+    }
+    if (throwCount > sample.length * 0.3) {
+        // Check if custom error classes are used
+        const customErrors = fileContents.filter((c) => c.match(/class \w+Error extends/)).length;
+        if (customErrors > 0) {
+            conventions.errorHandling.push("throws custom error classes (not generic Error)");
+        }
+    }
+    // Analyze import patterns
+    const allImports = sample.flatMap((e) => e.imports);
+    const aliasImports = allImports.filter((i) => i.source.startsWith("@/") || i.source.startsWith("~/") || i.source.startsWith("#"));
+    if (aliasImports.length > allImports.length * 0.1) {
+        const prefix = aliasImports[0]?.source.split("/")[0];
+        conventions.imports.push(`uses ${prefix} path alias for absolute imports`);
+    }
+    const relativeImports = allImports.filter((i) => i.isRelative);
+    const absoluteImports = allImports.filter((i) => !i.isRelative);
+    if (relativeImports.length > absoluteImports.length * 2) {
+        conventions.imports.push("prefers relative imports");
+    }
+    // Detect testing patterns
+    const testFiles = extractions.filter((e) => e.path.includes(".test.") || e.path.includes(".spec.") ||
+        e.path.includes("_test.") || e.path.startsWith("test_"));
+    if (testFiles.length > 0) {
+        const colocated = testFiles.filter((t) => {
+            const dir = t.path.split("/").slice(0, -1).join("/");
+            return sample.some((s) => s.path.split("/").slice(0, -1).join("/") === dir);
+        });
+        if (colocated.length > testFiles.length * 0.5) {
+            conventions.testing.push("test files are colocated with source files");
+        }
+        else {
+            conventions.testing.push("test files are in separate test/ directory");
+        }
+        if (testFiles.some((t) => t.path.includes(".test."))) {
+            conventions.testing.push("uses .test.{ext} naming convention");
+        }
+        else if (testFiles.some((t) => t.path.includes(".spec."))) {
+            conventions.testing.push("uses .spec.{ext} naming convention");
+        }
+    }
+    // Detect common architectural patterns
+    const hasServices = extractions.some((e) => e.path.includes("/services/") || e.path.includes("/service/"));
+    const hasControllers = extractions.some((e) => e.path.includes("/controllers/") || e.path.includes("/routes/") ||
+        e.path.includes("/api/"));
+    if (hasServices && hasControllers) {
+        conventions.patterns.push("layered architecture: routes/controllers → services");
+    }
+    // Detect async patterns
+    const asyncCount = fileContents.filter((c) => c.includes("async ") || c.includes("await ")).length;
+    if (asyncCount > sample.length * 0.5) {
+        conventions.patterns.push("predominantly async/await (not callbacks)");
+    }
+    // Detect export style
+    const defaultExports = fileContents.filter((c) => c.includes("export default") || c.includes("module.exports =")).length;
+    const namedExports = fileContents.filter((c) => c.includes("export function") || c.includes("export const") || c.includes("export class")).length;
+    if (namedExports > defaultExports * 3) {
+        conventions.patterns.push("prefers named exports over default exports");
+    }
+    else if (defaultExports > namedExports * 2) {
+        conventions.patterns.push("uses default exports");
+    }
+    return conventions;
+}
+/**
+ * Format conventions for inclusion in CLAUDE.md or rules.
+ */
+export function formatConventions(conv) {
+    const lines = [];
+    const all = [
+        ...conv.naming,
+        ...conv.errorHandling,
+        ...conv.patterns,
+        ...conv.testing,
+        ...conv.imports,
+        ...conv.other,
+    ];
+    if (all.length === 0)
+        return "";
+    lines.push("Conventions:");
+    for (const c of all) {
+        lines.push(`  - ${c}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=conventions.js.map

package/dist/extract/conventions.js.map

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

package/dist/extract/depgraph.d.ts

@@ -0,0 +1,12 @@
+import type { FileExtraction } from "./signatures.js";
+import { GraphNode } from "../utils/pagerank.js";
+export interface DepGraph {
+    nodes: Map<string, GraphNode>;
+    pageRank: Map<string, number>;
+    refCounts: Map<string, number>;
+}
+/**
+ * Build a dependency graph from file extractions.
+ * Resolves relative imports to actual file paths.
+ */
+export declare function buildDepGraph(extractions: FileExtraction[], root: string): DepGraph;

package/dist/extract/depgraph.js

@@ -0,0 +1,70 @@
+import { dirname, join, relative } from "path";
+import { computePageRank, computeRefCounts } from "../utils/pagerank.js";
+/**
+ * Build a dependency graph from file extractions.
+ * Resolves relative imports to actual file paths.
+ */
+export function buildDepGraph(extractions, root) {
+    const fileSet = new Set(extractions.map((e) => e.path));
+    const nodes = new Map();
+    // Initialize all nodes
+    for (const ext of extractions) {
+        nodes.set(ext.path, {
+            id: ext.path,
+            outEdges: [],
+            inEdges: [],
+        });
+    }
+    // Resolve imports and build edges
+    for (const ext of extractions) {
+        const node = nodes.get(ext.path);
+        for (const imp of ext.imports) {
+            if (!imp.isRelative)
+                continue; // skip external packages
+            const resolved = resolveImport(ext.path, imp.source, root, fileSet);
+            if (resolved && nodes.has(resolved)) {
+                if (!node.outEdges.includes(resolved)) {
+                    node.outEdges.push(resolved);
+                }
+                const targetNode = nodes.get(resolved);
+                if (!targetNode.inEdges.includes(ext.path)) {
+                    targetNode.inEdges.push(ext.path);
+                }
+            }
+        }
+    }
+    // Compute rankings
+    const pageRank = computePageRank(nodes);
+    const refCounts = computeRefCounts(nodes);
+    return { nodes, pageRank, refCounts };
+}
+/**
+ * Resolve a relative import to a file path.
+ * Handles TypeScript/JS resolution with extension inference.
+ */
+function resolveImport(fromFile, importPath, root, fileSet) {
+    const fromDir = dirname(join(root, fromFile));
+    const basePath = relative(root, join(fromDir, importPath)).replace(/\\/g, "/");
+    // Security: prevent path traversal outside project root
+    if (basePath.startsWith("..") || basePath.startsWith("/"))
+        return null;
+    // Try exact match first
+    if (fileSet.has(basePath))
+        return basePath;
+    // Try with extensions
+    const extensions = [".ts", ".tsx", ".js", ".jsx", ".mjs", ".py", ".go", ".rs"];
+    for (const ext of extensions) {
+        const withExt = basePath + ext;
+        if (fileSet.has(withExt))
+            return withExt;
+    }
+    // Try index files
+    const indexFiles = ["index.ts", "index.tsx", "index.js", "index.jsx", "mod.rs", "__init__.py"];
+    for (const idx of indexFiles) {
+        const indexPath = basePath + "/" + idx;
+        if (fileSet.has(indexPath))
+            return indexPath;
+    }
+    return null;
+}
+//# sourceMappingURL=depgraph.js.map

package/dist/extract/depgraph.js.map

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