briefed 0.1.0

package/dist/generate/index-file.js.map

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

package/dist/generate/rules.d.ts

@@ -0,0 +1,6 @@
+import type { Gotcha } from "../extract/gotchas.js";
+/**
+ * Group gotchas by directory and format as .claude/rules/ files.
+ * Each file gets YAML frontmatter with path matchers.
+ */
+export declare function generateRuleFiles(gotchas: Gotcha[], root: string): Map<string, string>;

package/dist/generate/rules.js

@@ -0,0 +1,94 @@
+import { dirname, relative } from "path";
+/**
+ * Group gotchas by directory and format as .claude/rules/ files.
+ * Each file gets YAML frontmatter with path matchers.
+ */
+export function generateRuleFiles(gotchas, root) {
+    // Group gotchas by directory
+    const byDir = new Map();
+    for (const g of gotchas) {
+        const relPath = relative(root, g.file).replace(/\\/g, "/");
+        const dir = dirname(relPath);
+        if (!byDir.has(dir))
+            byDir.set(dir, []);
+        byDir.get(dir).push({ ...g, file: relPath });
+    }
+    // Generate rule files
+    const files = new Map();
+    for (const [dir, dirGotchas] of byDir) {
+        if (dirGotchas.length === 0)
+            continue;
+        // Create a safe filename
+        const safeDir = dir.replace(/[\/\\]/g, "-").replace(/^-/, "");
+        const fileName = `briefed-${safeDir || "root"}.md`;
+        const lines = [];
+        // YAML frontmatter with path matcher
+        lines.push("---");
+        lines.push(`paths:`);
+        lines.push(`  - "${dir}/**"`);
+        lines.push("---");
+        lines.push("");
+        lines.push(`# Constraints: ${dir}/`);
+        lines.push("");
+        // Group by category
+        const byCategory = new Map();
+        for (const g of dirGotchas) {
+            if (!byCategory.has(g.category))
+                byCategory.set(g.category, []);
+            byCategory.get(g.category).push(g);
+        }
+        // Important comments first
+        const comments = byCategory.get("important_comment") || [];
+        if (comments.length > 0) {
+            for (const g of comments) {
+                lines.push(`- ${g.text}`);
+            }
+        }
+        // Guard clauses
+        const guards = byCategory.get("guard_clause") || [];
+        if (guards.length > 0) {
+            for (const g of guards) {
+                lines.push(`- ${g.text}`);
+            }
+        }
+        // State transitions
+        const states = byCategory.get("state_transition") || [];
+        if (states.length > 0) {
+            for (const g of states) {
+                lines.push(`- ${g.text}`);
+            }
+        }
+        // Side effects
+        const effects = byCategory.get("side_effect") || [];
+        if (effects.length > 0) {
+            for (const g of effects) {
+                lines.push(`- ${g.text}`);
+            }
+        }
+        // Soft deletes
+        const deletes = byCategory.get("soft_delete") || [];
+        if (deletes.length > 0) {
+            for (const g of deletes) {
+                lines.push(`- ${g.text}`);
+            }
+        }
+        // Unique constraints
+        const uniques = byCategory.get("unique_constraint") || [];
+        if (uniques.length > 0) {
+            for (const g of uniques) {
+                lines.push(`- ${g.text}`);
+            }
+        }
+        // Other
+        for (const [cat, gs] of byCategory) {
+            if (["important_comment", "guard_clause", "state_transition", "side_effect", "soft_delete", "unique_constraint"].includes(cat))
+                continue;
+            for (const g of gs) {
+                lines.push(`- ${g.text}`);
+            }
+        }
+        files.set(fileName, lines.join("\n"));
+    }
+    return files;
+}
+//# sourceMappingURL=rules.js.map

package/dist/generate/rules.js.map

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

package/dist/generate/skeleton.d.ts

@@ -0,0 +1,14 @@
+import type { FileExtraction } from "../extract/signatures.js";
+import type { DepGraph } from "../extract/depgraph.js";
+import type { ComplexityScore } from "../extract/complexity.js";
+import type { StackInfo } from "../utils/detect.js";
+export interface SkeletonOptions {
+    maxTokens: number;
+    topN: number;
+}
+/**
+ * Generate the L1 skeleton — a token-efficient structural map of the codebase.
+ * Uses PageRank to prioritize the most central files.
+ * Output format: Markdown (most token-efficient for hierarchical text).
+ */
+export declare function generateSkeleton(stack: StackInfo, extractions: FileExtraction[], depGraph: DepGraph, complexity: ComplexityScore[], opts?: Partial<SkeletonOptions>): string;

package/dist/generate/skeleton.js

@@ -0,0 +1,145 @@
+import { dirname, basename } from "path";
+import { countTokens } from "../utils/tokens.js";
+const DEFAULT_OPTIONS = {
+    maxTokens: 1000,
+    topN: 50,
+};
+/**
+ * Generate the L1 skeleton — a token-efficient structural map of the codebase.
+ * Uses PageRank to prioritize the most central files.
+ * Output format: Markdown (most token-efficient for hierarchical text).
+ */
+export function generateSkeleton(stack, extractions, depGraph, complexity, opts = {}) {
+    const options = { ...DEFAULT_OPTIONS, ...opts };
+    // Rank files by PageRank score
+    const ranked = extractions
+        .filter((e) => e.symbols.length > 0)
+        .map((e) => ({
+        extraction: e,
+        score: depGraph.pageRank.get(e.path) || 0,
+        refs: depGraph.refCounts.get(e.path) || 0,
+        complexity: complexity.find((c) => c.file === e.path)?.score || 0,
+    }))
+        .sort((a, b) => b.score - a.score);
+    // Group files by directory
+    const dirGroups = new Map();
+    for (const item of ranked) {
+        const dir = dirname(item.extraction.path);
+        if (!dirGroups.has(dir))
+            dirGroups.set(dir, []);
+        dirGroups.get(dir).push(item);
+    }
+    // Sort directories by total PageRank of their files
+    const sortedDirs = [...dirGroups.entries()]
+        .map(([dir, files]) => ({
+        dir,
+        files,
+        totalScore: files.reduce((s, f) => s + f.score, 0),
+        totalFiles: files.length,
+    }))
+        .sort((a, b) => b.totalScore - a.totalScore);
+    // Build skeleton
+    const lines = [];
+    // Header
+    const projectName = basename(extractions[0]?.path?.split("/")[0] || "project");
+    lines.push(`# briefed: ${stack.frameworks.length > 0 ? stack.frameworks.join(", ") : stack.languages.join(", ")} project`);
+    lines.push(`Stack: ${[...stack.languages, ...stack.frameworks].join(", ")}${stack.dbORM ? `, ${stack.dbORM}` : ""}`);
+    if (stack.entryPoints.length > 0) {
+        lines.push(`Entry: ${stack.entryPoints.join(", ")}`);
+    }
+    lines.push(`Files: ${extractions.length} source files across ${dirGroups.size} directories`);
+    lines.push("");
+    // Directory sections with file signatures
+    let tokenCount = countTokens(lines.join("\n"));
+    let filesIncluded = 0;
+    for (const { dir, files, totalFiles } of sortedDirs) {
+        if (filesIncluded >= options.topN)
+            break;
+        if (tokenCount >= options.maxTokens)
+            break;
+        // Count all source files in directory (not just those with symbols)
+        const allInDir = extractions.filter((e) => dirname(e.path) === dir).length;
+        const dirLine = `## ${dir}/ (${allInDir} files)`;
+        lines.push(dirLine);
+        tokenCount += countTokens(dirLine);
+        for (const { extraction, refs, complexity: cx } of files) {
+            if (filesIncluded >= options.topN)
+                break;
+            if (tokenCount >= options.maxTokens)
+                break;
+            const fname = basename(extraction.path);
+            const refTag = refs > 0 ? ` ★${refs}` : "";
+            // For high-complexity files, show full signatures
+            // For low-complexity files, just show the file name with exports
+            const exportedSymbols = extraction.symbols.filter((s) => s.exported);
+            if (cx >= 5 || refs >= 3) {
+                // Detailed: show signatures
+                const fileLine = `${fname}${refTag}`;
+                lines.push(fileLine);
+                tokenCount += countTokens(fileLine);
+                for (const sym of exportedSymbols.slice(0, 10)) {
+                    const sigLine = `  ${formatSignature(sym)}`;
+                    const sigTokens = countTokens(sigLine);
+                    if (tokenCount + sigTokens > options.maxTokens)
+                        break;
+                    lines.push(sigLine);
+                    tokenCount += sigTokens;
+                }
+                if (exportedSymbols.length > 10) {
+                    lines.push(`  ... +${exportedSymbols.length - 10} more exports`);
+                }
+            }
+            else {
+                // Compact: just file name with export count
+                const exportNames = exportedSymbols
+                    .slice(0, 5)
+                    .map((s) => s.name.split(".").pop())
+                    .join(", ");
+                const suffix = exportedSymbols.length > 5
+                    ? ` +${exportedSymbols.length - 5} more`
+                    : "";
+                const compactLine = `${fname}${refTag}: ${exportNames}${suffix}`;
+                lines.push(compactLine);
+                tokenCount += countTokens(compactLine);
+            }
+            filesIncluded++;
+        }
+        lines.push("");
+        tokenCount += 1;
+    }
+    // Footer with token count
+    lines.push(`<!-- briefed skeleton: ${filesIncluded} files, ~${countTokens(lines.join("\n"))} tokens -->`);
+    return lines.join("\n");
+}
+function formatSignature(sym) {
+    let base;
+    switch (sym.kind) {
+        case "route":
+            base = sym.signature;
+            break;
+        case "method":
+            base = sym.signature;
+            break;
+        case "class":
+        case "interface":
+            base = `${sym.kind} ${sym.signature}`;
+            break;
+        case "enum":
+            base = `enum ${sym.signature}`;
+            break;
+        case "type":
+            base = `type ${sym.signature}`;
+            break;
+        case "component":
+            base = `<${sym.name}> ${sym.signature}`;
+            break;
+        default:
+            base = sym.signature;
+    }
+    // Append description if available (one-liner from docstring/JSDoc)
+    if (sym.description) {
+        return `${base} — ${sym.description}`;
+    }
+    return base;
+}
+//# sourceMappingURL=skeleton.js.map

package/dist/generate/skeleton.js.map

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

package/dist/learn/tracker.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Learning loop: tracks what context was useful per prompt pattern.
+ * Over time, improves the adaptive hook's predictions.
+ *
+ * How it works:
+ * 1. UserPromptSubmit hook injects context for modules A, B based on keywords
+ * 2. PostToolUse hook (Read matcher) logs which files Claude actually read
+ * 3. If Claude read files from module C (not injected), that's a MISS
+ * 4. Over time, associate "prompts about X" with "also need module C"
+ *
+ * Storage: simple JSON file (no SQLite dependency for now)
+ */
+interface LearningRecord {
+    promptKeywords: string[];
+    injectedModules: string[];
+    accessedModules: string[];
+    misses: string[];
+    timestamp: string;
+}
+interface LearningStore {
+    records: LearningRecord[];
+    moduleRelevance: Record<string, Record<string, number>>;
+    version: number;
+}
+/**
+ * Load the learning store.
+ */
+export declare function loadStore(root: string): LearningStore;
+/**
+ * Save the learning store.
+ */
+export declare function saveStore(root: string, store: LearningStore): void;
+/**
+ * Record a session's context usage.
+ * Called by the learning hook after a session ends or periodically.
+ */
+export declare function recordSession(store: LearningStore, promptKeywords: string[], injectedModules: string[], accessedFiles: string[], moduleIndex: Array<{
+    name: string;
+    dir: string;
+    files: string[];
+}>): LearningStore;
+/**
+ * Get learned module suggestions for a set of keywords.
+ * Returns modules sorted by relevance score.
+ */
+export declare function getLearnedModules(store: LearningStore, promptKeywords: string[], limit?: number): Array<{
+    module: string;
+    score: number;
+}>;
+/**
+ * Generate the PostToolUse hook script that tracks file reads.
+ */
+export declare function generateLearningHookScript(): string;
+export {};

package/dist/learn/tracker.js

@@ -0,0 +1,129 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+const STORE_FILE = "learning.json";
+const MAX_RECORDS = 200;
+/**
+ * Load the learning store.
+ */
+export function loadStore(root) {
+    const storePath = join(root, ".briefed", STORE_FILE);
+    if (existsSync(storePath)) {
+        try {
+            return JSON.parse(readFileSync(storePath, "utf-8"));
+        }
+        catch {
+            // Corrupt store — start fresh
+        }
+    }
+    return { records: [], moduleRelevance: {}, version: 1 };
+}
+/**
+ * Save the learning store.
+ */
+export function saveStore(root, store) {
+    const briefedDir = join(root, ".briefed");
+    if (!existsSync(briefedDir))
+        mkdirSync(briefedDir, { recursive: true });
+    // Trim old records
+    if (store.records.length > MAX_RECORDS) {
+        store.records = store.records.slice(-MAX_RECORDS);
+    }
+    writeFileSync(join(briefedDir, STORE_FILE), JSON.stringify(store, null, 2));
+}
+/**
+ * Record a session's context usage.
+ * Called by the learning hook after a session ends or periodically.
+ */
+export function recordSession(store, promptKeywords, injectedModules, accessedFiles, moduleIndex) {
+    // Map accessed files to modules
+    const accessedModules = new Set();
+    for (const file of accessedFiles) {
+        for (const mod of moduleIndex) {
+            if (mod.files.some((f) => file.includes(f) || f.includes(file))) {
+                accessedModules.add(mod.name);
+            }
+        }
+    }
+    // Detect misses: modules Claude accessed but we didn't inject
+    const injectedSet = new Set(injectedModules);
+    const misses = [...accessedModules].filter((m) => !injectedSet.has(m));
+    // Record
+    store.records.push({
+        promptKeywords,
+        injectedModules,
+        accessedModules: [...accessedModules],
+        misses,
+        timestamp: new Date().toISOString(),
+    });
+    // Update relevance scores
+    // For each keyword in the prompt, increase the score for modules that were accessed
+    for (const keyword of promptKeywords) {
+        if (!store.moduleRelevance[keyword]) {
+            store.moduleRelevance[keyword] = {};
+        }
+        for (const mod of accessedModules) {
+            const current = store.moduleRelevance[keyword][mod] || 0;
+            store.moduleRelevance[keyword][mod] = current + 1;
+        }
+        // Slight boost for misses (we should have injected these)
+        for (const miss of misses) {
+            const current = store.moduleRelevance[keyword][miss] || 0;
+            store.moduleRelevance[keyword][miss] = current + 2; // double weight for misses
+        }
+    }
+    return store;
+}
+/**
+ * Get learned module suggestions for a set of keywords.
+ * Returns modules sorted by relevance score.
+ */
+export function getLearnedModules(store, promptKeywords, limit = 5) {
+    const scores = new Map();
+    for (const keyword of promptKeywords) {
+        const relevance = store.moduleRelevance[keyword];
+        if (!relevance)
+            continue;
+        for (const [mod, score] of Object.entries(relevance)) {
+            scores.set(mod, (scores.get(mod) || 0) + score);
+        }
+    }
+    return [...scores.entries()]
+        .map(([module, score]) => ({ module, score }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, limit);
+}
+/**
+ * Generate the PostToolUse hook script that tracks file reads.
+ */
+export function generateLearningHookScript() {
+    return `#!/usr/bin/env node
+// briefed: PostToolUse hook — tracks which files Claude reads for the learning loop
+// Security: only appends to .briefed/session-reads.json, 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);
+    // Only track Read tool calls
+    if (data.tool_name !== "Read") { process.exit(0); return; }
+
+    const filePath = data.tool_input?.file_path;
+    if (!filePath) { process.exit(0); return; }
+
+    // Append to session reads log (one line per file read)
+    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);
+});
+`.trim();
+}
+//# sourceMappingURL=tracker.js.map

package/dist/learn/tracker.js.map

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

package/dist/utils/detect.d.ts

@@ -0,0 +1,16 @@
+export interface StackInfo {
+    languages: string[];
+    frameworks: string[];
+    packageManager: string | null;
+    entryPoints: string[];
+    dbORM: string | null;
+    testFramework: string | null;
+}
+/** Detect the project's tech stack from config files */
+export declare function detectStack(root: string): StackInfo;
+/** Map file extension to language name */
+export declare function extToLanguage(ext: string): string | null;
+/** File extensions we should parse */
+export declare const PARSEABLE_EXTENSIONS: Set<string>;
+/** Directories to always skip */
+export declare const SKIP_DIRS: Set<string>;