briefed 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Wesley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# briefed
+
+**Your AI already knows your codebase before you ask.**
+
+briefed scans your repository once and compiles a focused, token-efficient context snapshot that Claude Code, Cursor, and Copilot load automatically at the start of every session — eliminating the orientation phase where AI tools spend 8–12 seconds reading files they should already know.
+
+```bash
+npx briefed init
+```
+
+That's it. briefed installs itself and auto-updates on every commit.
+
+---
+
+## The problem
+
+Every AI coding session starts the same way: the model reads 5–10 files, builds a mental model of your codebase, then starts working. This costs ~5,000–10,000 tokens and 8–12 seconds *before a single line of code is written* — on every task.
+
+briefed pre-computes that mental model so the AI starts already oriented.
+
+## What it produces
+
+Three layers, delivered through the right channels:
+
+| Layer | What | Where | When loaded |
+|-------|------|--------|-------------|
+| Skeleton | File tree, exports, function signatures, dependency graph | `CLAUDE.md` | Every session |
+| Gotchas | Constraints, guard clauses, ordering deps, implicit contracts | `.claude/rules/` | When touching matching files |
+| Contracts | Per-module behavioral contracts, state machines, side effects | `.briefed/contracts/` | Per-prompt via hook |
+
+**Estimated savings: ~5,000–8,000 tokens per prompt, ~7–11 seconds per task.**
+
+## Installation
+
+```bash
+# Run once in any repo
+npx briefed init
+
+# Check your setup
+npx briefed doctor
+
+# See token usage stats
+npx briefed stats
+```
+
+## What gets generated
+
+```
+your-repo/
+├── CLAUDE.md              # skeleton — always loaded by Claude Code
+├── AGENTS.md              # cross-tool context (Copilot, OpenAI agents)
+├── .cursorrules           # Cursor IDE context
+├── .claude/
+│   ├── settings.json      # hooks registered here
+│   └── rules/
+│       └── briefed-*.md   # path-scoped gotchas
+└── .briefed/
+    ├── contracts/         # module behavioral contracts
+    ├── index.json         # module map for hook matching
+    ├── test-map.json      # source → test file mappings
+    └── history.json       # git churn data
+```
+
+## How it stays fresh
+
+briefed installs a git `post-commit` hook that re-indexes your codebase after every commit in the background (~5 seconds, async). No CI required.
+
+```bash
+# Manual refresh
+npx briefed init
+
+# Check staleness
+npx briefed doctor
+```
+
+## What gets mapped
+
+briefed extracts context across every domain relevant to your project:
+
+- **Code structure** — function signatures, exports, dependency graph, PageRank-ranked by importance
+- **Schemas** — Prisma, Drizzle, Django, TypeORM models and relations
+- **API routes** — Express, Fastify, Next.js, FastAPI, Django, Hono endpoints
+- **Frontend** — pages, components, state stores (Zustand, Redux, Context)
+- **Infrastructure** — Docker Compose, Terraform, Kubernetes, deployment platform
+- **Environment** — required env vars with descriptions
+- **Tests** — source → test file mappings
+- **Git history** — churn data, recent changes per file
+- **Conventions** — naming patterns, error handling style, code patterns
+- **Gotchas** — important comments, guard clauses, state machine transitions
+
+Only domains relevant to your project are included — a pure API project won't get frontend context.
+
+## Commands
+
+```bash
+briefed init              # scan and compile context
+briefed init --skip-hooks # init without installing hooks
+briefed init --skip-rules # init without writing .claude/rules/
+briefed stats             # show token usage breakdown
+briefed doctor            # validate setup, check staleness
+briefed bench             # benchmark with vs without briefed
+```
+
+## Works with
+
+- **Claude Code** — hooks inject context automatically
+- **Cursor** — `.cursorrules` loaded on every file
+- **GitHub Copilot** — `AGENTS.md` provides baseline context
+- **Any tool** that reads `CLAUDE.md` or `AGENTS.md`
+
+## Requirements
+
+- Node.js >= 20
+- Git (for auto-update hook)
+
+## License
+
+MIT

package/dist/bench/metrics.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Metrics extracted from a `claude -p --output-format json` result.
+ */
+export interface TaskMetrics {
+    durationMs: number;
+    numTurns: number;
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    totalCostUsd: number;
+    resultLength: number;
+    sessionId: string;
+    success: boolean;
+}
+/**
+ * Parse a claude -p JSON output file into metrics.
+ */
+export declare function parseResult(filePath: string): TaskMetrics;
+/**
+ * Compare two task results and produce a formatted row.
+ */
+export declare function compareMetrics(without: TaskMetrics, withCctx: TaskMetrics, taskName: string): string;
+/**
+ * Generate a summary report from multiple task comparisons.
+ */
+export declare function generateSummary(results: Array<{
+    task: string;
+    without: TaskMetrics | null;
+    withCctx: TaskMetrics | null;
+}>): string;

package/dist/bench/metrics.js

@@ -0,0 +1,122 @@
+import { readFileSync } from "fs";
+/**
+ * Parse a claude -p JSON output file into metrics.
+ */
+export function parseResult(filePath) {
+    const content = readFileSync(filePath, "utf-8").trim();
+    // Handle JSONL (multiple lines) — take the last valid JSON
+    const lines = content.split("\n").filter(Boolean);
+    let data = null;
+    for (let i = lines.length - 1; i >= 0; i--) {
+        try {
+            const parsed = JSON.parse(lines[i]);
+            if (parsed.type === "result" || parsed.duration_ms) {
+                data = parsed;
+                break;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    if (!data) {
+        // Try parsing the whole content as one JSON
+        data = JSON.parse(content);
+    }
+    if (!data)
+        throw new Error("No valid JSON found in transcript");
+    const usage = (data.usage || {});
+    return {
+        durationMs: data.duration_ms || 0,
+        numTurns: data.num_turns || 0,
+        inputTokens: usage.input_tokens || 0,
+        outputTokens: usage.output_tokens || 0,
+        cacheCreationTokens: usage.cache_creation_input_tokens || 0,
+        cacheReadTokens: usage.cache_read_input_tokens || 0,
+        totalCostUsd: data.total_cost_usd || 0,
+        resultLength: (data.result || "").length,
+        sessionId: data.session_id || "",
+        success: data.subtype === "success" && !data.is_error,
+    };
+}
+/**
+ * Compare two task results and produce a formatted row.
+ */
+export function compareMetrics(without, withCctx, taskName) {
+    const lines = [];
+    lines.push(`  Task: "${taskName}"`);
+    lines.push("  " + "─".repeat(62));
+    lines.push(padRow("", "Without briefed", "With briefed", "Delta"));
+    lines.push("  " + "─".repeat(62));
+    lines.push(padRow("Duration", `${(without.durationMs / 1000).toFixed(1)}s`, `${(withCctx.durationMs / 1000).toFixed(1)}s`, formatDelta(without.durationMs, withCctx.durationMs)));
+    lines.push(padRow("Turns", without.numTurns.toString(), withCctx.numTurns.toString(), formatDelta(without.numTurns, withCctx.numTurns)));
+    lines.push(padRow("Input tokens", formatNumber(without.inputTokens), formatNumber(withCctx.inputTokens), formatDelta(without.inputTokens, withCctx.inputTokens)));
+    lines.push(padRow("Output tokens", formatNumber(without.outputTokens), formatNumber(withCctx.outputTokens), formatDelta(without.outputTokens, withCctx.outputTokens, true)));
+    lines.push(padRow("Cache created", formatNumber(without.cacheCreationTokens), formatNumber(withCctx.cacheCreationTokens), formatDelta(without.cacheCreationTokens, withCctx.cacheCreationTokens)));
+    lines.push(padRow("Cache read", formatNumber(without.cacheReadTokens), formatNumber(withCctx.cacheReadTokens), formatDelta(without.cacheReadTokens, withCctx.cacheReadTokens, true)));
+    lines.push(padRow("Cost", `$${without.totalCostUsd.toFixed(4)}`, `$${withCctx.totalCostUsd.toFixed(4)}`, formatDelta(without.totalCostUsd, withCctx.totalCostUsd)));
+    lines.push("  " + "─".repeat(62));
+    return lines.join("\n");
+}
+/**
+ * Generate a summary report from multiple task comparisons.
+ */
+export function generateSummary(results) {
+    const lines = [];
+    let compared = 0;
+    let totalDurationWithout = 0;
+    let totalDurationWith = 0;
+    let totalInputWithout = 0;
+    let totalInputWith = 0;
+    let totalTurnsWithout = 0;
+    let totalTurnsWith = 0;
+    let totalCostWithout = 0;
+    let totalCostWith = 0;
+    for (const r of results) {
+        if (r.without && r.withCctx) {
+            compared++;
+            totalDurationWithout += r.without.durationMs;
+            totalDurationWith += r.withCctx.durationMs;
+            totalInputWithout += r.without.inputTokens;
+            totalInputWith += r.withCctx.inputTokens;
+            totalTurnsWithout += r.without.numTurns;
+            totalTurnsWith += r.withCctx.numTurns;
+            totalCostWithout += r.without.totalCostUsd;
+            totalCostWith += r.withCctx.totalCostUsd;
+        }
+    }
+    if (compared === 0) {
+        lines.push("  No tasks with both runs to compare.");
+        return lines.join("\n");
+    }
+    lines.push("  " + "═".repeat(62));
+    lines.push("  SUMMARY");
+    lines.push("  " + "═".repeat(62));
+    lines.push(`  Tasks compared:       ${compared}`);
+    lines.push(`  Avg duration:         ${(totalDurationWithout / compared / 1000).toFixed(1)}s → ${(totalDurationWith / compared / 1000).toFixed(1)}s (${formatDelta(totalDurationWithout, totalDurationWith)})`);
+    lines.push(`  Avg input tokens:     ${formatNumber(Math.round(totalInputWithout / compared))} → ${formatNumber(Math.round(totalInputWith / compared))} (${formatDelta(totalInputWithout, totalInputWith)})`);
+    lines.push(`  Avg turns:            ${(totalTurnsWithout / compared).toFixed(1)} → ${(totalTurnsWith / compared).toFixed(1)} (${formatDelta(totalTurnsWithout, totalTurnsWith)})`);
+    lines.push(`  Total cost:           $${totalCostWithout.toFixed(4)} → $${totalCostWith.toFixed(4)} (${formatDelta(totalCostWithout, totalCostWith)})`);
+    lines.push("  " + "═".repeat(62));
+    return lines.join("\n");
+}
+function padRow(label, col1, col2, col3) {
+    return `  ${label.padEnd(18)} ${col1.padStart(14)} ${col2.padStart(14)} ${col3.padStart(10)}`;
+}
+function formatDelta(before, after, higherIsBetter = false) {
+    if (before === 0 && after === 0)
+        return "—";
+    if (before === 0)
+        return `+${after}`;
+    const pct = Math.round(((after - before) / before) * 100);
+    const sign = pct >= 0 ? "+" : "";
+    return `${sign}${pct}%`;
+}
+function formatNumber(n) {
+    if (n >= 1_000_000)
+        return `${(n / 1_000_000).toFixed(1)}M`;
+    if (n >= 1_000)
+        return `${(n / 1_000).toFixed(1)}K`;
+    return n.toString();
+}
+//# sourceMappingURL=metrics.js.map

package/dist/bench/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/bench/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAkBlC;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvD,2DAA2D;IAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,IAAI,GAAmC,IAAI,CAAC;IAEhD,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACnD,IAAI,GAAG,MAAM,CAAC;gBACd,MAAM;YACR,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,4CAA4C;QAC5C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG,CAAC,IAAK,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;IAE7D,OAAO;QACL,UAAU,EAAG,IAAI,CAAC,WAAsB,IAAI,CAAC;QAC7C,QAAQ,EAAG,IAAI,CAAC,SAAoB,IAAI,CAAC;QACzC,WAAW,EAAG,KAAK,CAAC,YAAuB,IAAI,CAAC;QAChD,YAAY,EAAG,KAAK,CAAC,aAAwB,IAAI,CAAC;QAClD,mBAAmB,EAAG,KAAK,CAAC,2BAAsC,IAAI,CAAC;QACvE,eAAe,EAAG,KAAK,CAAC,uBAAkC,IAAI,CAAC;QAC/D,YAAY,EAAG,IAAI,CAAC,cAAyB,IAAI,CAAC;QAClD,YAAY,EAAE,CAAE,IAAI,CAAC,MAAiB,IAAI,EAAE,CAAC,CAAC,MAAM;QACpD,SAAS,EAAG,IAAI,CAAC,UAAqB,IAAI,EAAE;QAC5C,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ;KACtD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,OAAoB,EACpB,QAAqB,EACrB,QAAgB;IAEhB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,YAAY,QAAQ,GAAG,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,cAAc,EAAE,OAAO,CAAC,CACvD,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAElC,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,UAAU,EACV,GAAG,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAC5C,GAAG,CAAC,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAC7C,WAAW,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CACrD,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,OAAO,EACP,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAC3B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAC5B,WAAW,CAAC,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CACjD,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,cAAc,EACd,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,EACjC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAClC,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,CACvD,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,eAAe,EACf,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,EAClC,YAAY,CAAC,QAAQ,CAAC,YAAY,CAAC,EACnC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAC/D,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,eAAe,EACf,YAAY,CAAC,OAAO,CAAC,mBAAmB,CAAC,EACzC,YAAY,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAC1C,WAAW,CAAC,OAAO,CAAC,mBAAmB,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CACvE,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,YAAY,EACZ,YAAY,CAAC,OAAO,CAAC,eAAe,CAAC,EACrC,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,EACtC,WAAW,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,IAAI,CAAC,CACrE,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CACR,MAAM,CACJ,MAAM,EACN,IAAI,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EACrC,IAAI,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EACtC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CACzD,CACF,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAIE;IAEF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,oBAAoB,GAAG,CAAC,CAAC;IAC7B,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,iBAAiB,GAAG,CAAC,CAAC;IAC1B,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;IACzB,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC5B,QAAQ,EAAE,CAAC;YACX,oBAAoB,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;YAC7C,iBAAiB,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;YAC3C,iBAAiB,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;YAC3C,cAAc,IAAI,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;YACzC,iBAAiB,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACxC,cAAc,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACtC,gBAAgB,IAAI,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC;YAC3C,aAAa,IAAI,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACpD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,2BAA2B,QAAQ,EAAE,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CACR,2BAA2B,CAAC,oBAAoB,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,GAAG,CACnM,CAAC;IACF,KAAK,CAAC,IAAI,CACR,2BAA2B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,iBAAiB,GAAG,QAAQ,CAAC,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,QAAQ,CAAC,CAAC,KAAK,WAAW,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG,CACjM,CAAC;IACF,KAAK,CAAC,IAAI,CACR,2BAA2B,CAAC,iBAAiB,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,iBAAiB,EAAE,cAAc,CAAC,GAAG,CACvK,CAAC;IACF,KAAK,CAAC,IAAI,CACR,4BAA4B,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,gBAAgB,EAAE,aAAa,CAAC,GAAG,CAC3I,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAElC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY;IACrE,OAAO,KAAK,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAChG,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,KAAa,EAAE,cAAc,GAAG,KAAK;IACxE,IAAI,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5C,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC;AAC1B,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,IAAI,CAAC,IAAI,SAAS;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAC5D,IAAI,CAAC,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACpD,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtB,CAAC"}

package/dist/bench/runner.d.ts

@@ -0,0 +1,27 @@
+import { type TaskMetrics } from "./metrics.js";
+export interface BenchTask {
+    name: string;
+    prompt: string;
+}
+export interface BenchResult {
+    task: BenchTask;
+    without: TaskMetrics | null;
+    withCctx: TaskMetrics | null;
+    error: string | null;
+}
+export interface RunOptions {
+    repo: string;
+    tasks?: BenchTask[];
+    outputDir?: string;
+    skipWithout?: boolean;
+    skipWith?: boolean;
+    maxTasks?: number;
+}
+/**
+ * Run the benchmark: execute tasks with and without briefed, compare results.
+ */
+export declare function runBenchmark(opts: RunOptions): Promise<BenchResult[]>;
+/**
+ * Generate the full report string.
+ */
+export declare function generateReport(results: BenchResult[]): string;

package/dist/bench/runner.js

@@ -0,0 +1,184 @@
+import { execSync, spawnSync } from "child_process";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, rmSync } from "fs";
+import { join, resolve } from "path";
+import { parseResult, compareMetrics, generateSummary } from "./metrics.js";
+const DEFAULT_TASKS = [
+    {
+        name: "understand-architecture",
+        prompt: "Read the source files in this project and explain the overall architecture. What are the main modules, how do they connect, and what is the entry point? List every source file you read.",
+    },
+    {
+        name: "add-verbose-flag",
+        prompt: "Read the main CLI entry point and add a --verbose flag that enables debug logging throughout the application. Read the relevant source files first, then make the code changes.",
+    },
+    {
+        name: "find-and-fix-bugs",
+        prompt: "Read through the source code and identify any potential bugs, missing error handling, or edge cases. Fix at least 2 issues you find. Read every source file before making changes.",
+    },
+];
+/**
+ * Run the benchmark: execute tasks with and without briefed, compare results.
+ */
+export async function runBenchmark(opts) {
+    const root = resolve(opts.repo);
+    const tasks = (opts.tasks || DEFAULT_TASKS).slice(0, opts.maxTasks || 3);
+    const outputDir = resolve(opts.outputDir || join(root, ".briefed", "bench"));
+    mkdirSync(join(outputDir, "without"), { recursive: true });
+    mkdirSync(join(outputDir, "with"), { recursive: true });
+    const claudePath = findClaude();
+    if (!claudePath) {
+        console.error("  Error: 'claude' CLI not found.");
+        return [];
+    }
+    console.log(`  Using: ${claudePath}`);
+    // Phase 1: Run tasks WITHOUT briefed
+    if (!opts.skipWithout) {
+        console.log("\n  Phase 1: Running tasks WITHOUT briefed...\n");
+        const hadCctx = backupCctxArtifacts(root);
+        for (let i = 0; i < tasks.length; i++) {
+            const task = tasks[i];
+            console.log(`  [${i + 1}/${tasks.length}] ${task.name}`);
+            try {
+                runClaudeTask(claudePath, root, task.prompt, join(outputDir, "without", `${task.name}.json`));
+                const m = parseResult(join(outputDir, "without", `${task.name}.json`));
+                console.log(`    ${(m.durationMs / 1000).toFixed(1)}s, ${m.numTurns} turns, ${m.inputTokens + m.outputTokens} tokens`);
+            }
+            catch (e) {
+                console.error(`    Error: ${e.message.slice(0, 100)}`);
+            }
+        }
+        restoreCctxArtifacts(root, hadCctx);
+    }
+    // Phase 2: Run tasks WITH briefed
+    if (!opts.skipWith) {
+        console.log("\n  Phase 2: Running tasks WITH briefed...\n");
+        if (!existsSync(join(root, ".briefed", "skeleton.md"))) {
+            console.log("  Initializing briefed...");
+            const briefedCli = join(import.meta.dirname, "..", "cli.js");
+            execSync(`node "${briefedCli}" init --repo "${root}" --skip-hooks`, { stdio: "inherit" });
+        }
+        for (let i = 0; i < tasks.length; i++) {
+            const task = tasks[i];
+            console.log(`  [${i + 1}/${tasks.length}] ${task.name}`);
+            try {
+                runClaudeTask(claudePath, root, task.prompt, join(outputDir, "with", `${task.name}.json`));
+                const m = parseResult(join(outputDir, "with", `${task.name}.json`));
+                console.log(`    ${(m.durationMs / 1000).toFixed(1)}s, ${m.numTurns} turns, ${m.inputTokens + m.outputTokens} tokens`);
+            }
+            catch (e) {
+                console.error(`    Error: ${e.message.slice(0, 100)}`);
+            }
+        }
+    }
+    // Phase 3: Compare
+    console.log("\n  Phase 3: Results\n");
+    const results = [];
+    for (const task of tasks) {
+        const result = { task, without: null, withCctx: null, error: null };
+        try {
+            const wp = join(outputDir, "without", `${task.name}.json`);
+            const cp = join(outputDir, "with", `${task.name}.json`);
+            if (existsSync(wp))
+                result.without = parseResult(wp);
+            if (existsSync(cp))
+                result.withCctx = parseResult(cp);
+        }
+        catch (e) {
+            result.error = e.message;
+        }
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Generate the full report string.
+ */
+export function generateReport(results) {
+    const lines = [];
+    lines.push("  " + "═".repeat(62));
+    lines.push("  briefed Benchmark Report");
+    lines.push("  " + "═".repeat(62));
+    lines.push("");
+    const summaryData = [];
+    for (const r of results) {
+        if (r.without && r.withCctx) {
+            lines.push(compareMetrics(r.without, r.withCctx, r.task.name));
+            lines.push("");
+        }
+        else if (r.error) {
+            lines.push(`  Task "${r.task.name}": Error — ${r.error}`);
+        }
+        else {
+            lines.push(`  Task "${r.task.name}": Missing data (need both runs)`);
+        }
+        summaryData.push({ task: r.task.name, without: r.without, withCctx: r.withCctx });
+    }
+    lines.push(generateSummary(summaryData));
+    return lines.join("\n");
+}
+function findClaude() {
+    const candidates = [
+        "claude",
+        "claude.cmd",
+        join(process.env.APPDATA || "", "npm", "claude.cmd"),
+        join(process.env.APPDATA || "", "npm", "claude"),
+    ];
+    for (const c of candidates) {
+        try {
+            const r = spawnSync(c, ["--version"], { stdio: "pipe", timeout: 5000, encoding: "utf-8", shell: true });
+            if (r.status === 0)
+                return c;
+        }
+        catch { /* next */ }
+    }
+    return null;
+}
+function runClaudeTask(claudePath, cwd, prompt, outputPath) {
+    const result = spawnSync(claudePath, ["-p", prompt, "--output-format", "json", "--max-turns", "20", "--permission-mode", "bypassPermissions"], { cwd, stdio: ["pipe", "pipe", "pipe"], timeout: 300_000, encoding: "utf-8", shell: true });
+    if (result.error)
+        throw new Error(`CLI failed: ${result.error.message}`);
+    if (result.stdout?.trim()) {
+        writeFileSync(outputPath, result.stdout);
+    }
+    else {
+        throw new Error(result.stderr?.slice(0, 200) || "No output");
+    }
+}
+function backupCctxArtifacts(root) {
+    const claudeMd = join(root, "CLAUDE.md");
+    const rulesDir = join(root, ".claude", "rules");
+    let had = false;
+    if (existsSync(claudeMd)) {
+        const content = readFileSync(claudeMd, "utf-8");
+        if (content.includes("<!-- briefed:start -->")) {
+            writeFileSync(claudeMd + ".bak", content);
+            writeFileSync(claudeMd, content.replace(/<!-- briefed:start -->[\s\S]*?<!-- briefed:end -->\n?/, "").trim() || "");
+            had = true;
+        }
+    }
+    if (existsSync(rulesDir)) {
+        for (const f of readdirSync(rulesDir).filter((f) => f.startsWith("briefed-"))) {
+            writeFileSync(join(rulesDir, f + ".bak"), readFileSync(join(rulesDir, f)));
+            rmSync(join(rulesDir, f));
+            had = true;
+        }
+    }
+    return had;
+}
+function restoreCctxArtifacts(root, had) {
+    if (!had)
+        return;
+    const claudeMd = join(root, "CLAUDE.md");
+    const rulesDir = join(root, ".claude", "rules");
+    if (existsSync(claudeMd + ".bak")) {
+        writeFileSync(claudeMd, readFileSync(claudeMd + ".bak", "utf-8"));
+        rmSync(claudeMd + ".bak");
+    }
+    if (existsSync(rulesDir)) {
+        for (const f of readdirSync(rulesDir).filter((f) => f.endsWith(".bak"))) {
+            writeFileSync(join(rulesDir, f.replace(".bak", "")), readFileSync(join(rulesDir, f)));
+            rmSync(join(rulesDir, f));
+        }
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/bench/runner.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { initCommand } from "./commands/init.js";
+import { statsCommand } from "./commands/stats.js";
+import { benchCommand } from "./commands/bench.js";
+import { doctorCommand } from "./commands/doctor.js";
+const program = new Command();
+program
+    .name("briefed")
+    .description("Adaptive Context Engine — compile your codebase into focused, token-efficient context for AI coding tools")
+    .version("0.1.0");
+program
+    .command("init")
+    .description("Scan codebase and compile context (skeleton + gotchas + hooks)")
+    .option("--repo <path>", "Repository root path", ".")
+    .option("--max-tokens <n>", "Token budget for skeleton", "1000")
+    .option("--skip-hooks", "Skip hook installation")
+    .option("--skip-rules", "Skip .claude/rules/ generation")
+    .action(initCommand);
+program
+    .command("stats")
+    .description("Show token usage and context statistics")
+    .option("--repo <path>", "Repository root path", ".")
+    .action(statsCommand);
+program
+    .command("doctor")
+    .description("Validate briefed setup and diagnose issues")
+    .option("--repo <path>", "Repository root path", ".")
+    .action(doctorCommand);
+program
+    .command("bench")
+    .description("Benchmark briefed vs default Claude Code (uses your subscription)")
+    .option("--repo <path>", "Repository to benchmark", ".")
+    .option("--quick", "Run 3 tasks (fastest)")
+    .option("--full", "Run 10 tasks (most thorough)")
+    .option("--with-only", "Only run WITH briefed (skip without)")
+    .option("--without-only", "Only run WITHOUT briefed")
+    .option("--report-only", "Just generate report from existing transcripts")
+    .option("--output <dir>", "Output directory for transcripts")
+    .action(benchCommand);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,SAAS,CAAC;KACf,WAAW,CACV,2GAA2G,CAC5G;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gEAAgE,CAAC;KAC7E,MAAM,CAAC,eAAe,EAAE,sBAAsB,EAAE,GAAG,CAAC;KACpD,MAAM,CAAC,kBAAkB,EAAE,2BAA2B,EAAE,MAAM,CAAC;KAC/D,MAAM,CAAC,cAAc,EAAE,wBAAwB,CAAC;KAChD,MAAM,CAAC,cAAc,EAAE,gCAAgC,CAAC;KACxD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,yCAAyC,CAAC;KACtD,MAAM,CAAC,eAAe,EAAE,sBAAsB,EAAE,GAAG,CAAC;KACpD,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,eAAe,EAAE,sBAAsB,EAAE,GAAG,CAAC;KACpD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,mEAAmE,CAAC;KAChF,MAAM,CAAC,eAAe,EAAE,yBAAyB,EAAE,GAAG,CAAC;KACvD,MAAM,CAAC,SAAS,EAAE,uBAAuB,CAAC;KAC1C,MAAM,CAAC,QAAQ,EAAE,8BAA8B,CAAC;KAChD,MAAM,CAAC,aAAa,EAAE,sCAAsC,CAAC;KAC7D,MAAM,CAAC,gBAAgB,EAAE,0BAA0B,CAAC;KACpD,MAAM,CAAC,eAAe,EAAE,gDAAgD,CAAC;KACzE,MAAM,CAAC,gBAAgB,EAAE,kCAAkC,CAAC;KAC5D,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/bench.d.ts

@@ -0,0 +1,11 @@
+interface BenchOptions {
+    repo: string;
+    quick?: boolean;
+    full?: boolean;
+    withOnly?: boolean;
+    withoutOnly?: boolean;
+    reportOnly?: boolean;
+    output?: string;
+}
+export declare function benchCommand(opts: BenchOptions): Promise<void>;
+export {};

package/dist/commands/bench.js

@@ -0,0 +1,23 @@
+import { resolve, join } from "path";
+import { writeFileSync, existsSync } from "fs";
+import { runBenchmark, generateReport } from "../bench/runner.js";
+export async function benchCommand(opts) {
+    const root = resolve(opts.repo);
+    console.log("  briefed bench — measuring context efficiency");
+    console.log(`  Repository: ${root}\n`);
+    const results = await runBenchmark({
+        repo: root,
+        maxTasks: opts.quick ? 2 : opts.full ? 5 : 3,
+        skipWithout: opts.withOnly || opts.reportOnly,
+        skipWith: opts.withoutOnly || opts.reportOnly,
+        outputDir: opts.output,
+    });
+    const report = generateReport(results);
+    console.log("\n" + report);
+    const outDir = join(root, ".briefed", "bench");
+    if (existsSync(outDir)) {
+        writeFileSync(join(outDir, "report.txt"), report);
+        console.log(`\n  Report saved to ${join(outDir, "report.txt")}`);
+    }
+}
+//# sourceMappingURL=bench.js.map

package/dist/commands/bench.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bench.js","sourceRoot":"","sources":["../../src/commands/bench.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAa,UAAU,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAYlE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAkB;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC;IAEvC,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC;QACjC,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,WAAW,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU;QAC7C,QAAQ,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,UAAU;QAC7C,SAAS,EAAE,IAAI,CAAC,MAAM;KACvB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;IAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,5 @@
+interface DoctorOptions {
+    repo: string;
+}
+export declare function doctorCommand(opts: DoctorOptions): Promise<void>;
+export {};