knitbrain 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Piyush Dua
+
+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,142 @@
+# Knit Brain
+
+[![npm](https://img.shields.io/npm/v/knitbrain)](https://www.npmjs.com/package/knitbrain)
+[![ci](https://github.com/PDgit12/knitbrain/actions/workflows/ci.yml/badge.svg)](https://github.com/PDgit12/knitbrain/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](package.json)
+
+> The local-first brain for coding agents: per-project memory, task-tier workflow routing, and lossless context compression — measured ~56% on real sessions, reproducible with one command.
+
+Pure TypeScript. No Python, no native binaries, no network beyond `npm install`.
+
+```bash
+npx knitbrain profile    # measure what it would save on YOUR real sessions — before installing anything
+```
+
+## The honest number
+
+Most tools in this space quote their best workload ("up to 90%!"). We publish the number nobody else does: the **whole-session average** — every tool result from real coding sessions, *including* the blocks that don't compress.
+
+**On 3.08M tokens of tool results from 70 real Claude Code sessions: 55.8% saved overall, lossless.** Every original recoverable byte-for-byte.
+
+| shape | % of real burn | saved |
+|---|---|---|
+| code & file reads | 47% | 59.6% |
+| repetitive logs | 18% | 72.3% |
+| short prose (reports, summaries) | 15% | 19.5% |
+| long prose | 8% | 68.7% |
+| test output | 6% | 46.4% |
+| JSON | 5% | 65.8% |
+
+Measured the way others measure — single best-case workloads — we land 60–99% (import graphs 98.9%, whole files 88.8%, body-heavy code 71.6%). But that's not the number you'll feel; the whole-session average is.
+
+**Don't take our word for any of this.** `knitbrain profile` runs the actual optimizer over your own transcripts (`~/.claude/projects` by default) and prints *your* number. Local only — nothing is uploaded.
+
+## Why this and not a point tool
+
+Compression-only layers shrink tokens but remember nothing. Memory-only layers remember but burn your window. Knit Brain is one substrate doing both, plus the workflow layer that makes agents use them:
+
+- **Memory** — per-project learnings, session handoffs, a knowledge graph (imports/exports/blast-radius), on-demand skills that compound across tasks.
+- **Lossless optimization** — structure-preserving skeletons (JSON keeps its schema, code keeps its signatures via tree-sitter AST), cross-turn dedup of re-sent bulk, sentence anchoring for prose — all reversible through a content-addressed store.
+- **Workflow intelligence** — a deterministic tier classifier (inquiry/trivial/standard/complex) routing how much process a task deserves, with guardrailed agent generation and a shared team board.
+- **Self-healing, not self-confident** — two feedback loops run continuously: TOIN backs off any compression kind that gets over-retrieved, and the classifier shifts its own thresholds after 3 wrong-verdict votes (`knitbrain_record_false_positive`). Wrong tuning costs efficiency, never correctness.
+
+## Architecture
+
+```
+ agent (Claude Code / Cursor / Codex)              your app (API key)
+            │                                            │
+            ▼                                            ▼
+ ┌──────────────────────────┐            ┌──────────────────────────────┐
+ │  knitbrain · MCP server  │            │  knitbrain-proxy (loopback)  │
+ │  25 tools                │            │  rolling window — old turns  │
+ │  ├ memory: learnings,    │            │  compressed harder · exact   │
+ │  │ handoffs, sessions    │            │  repeats deduped to markers  │
+ │  ├ knowledge graph       │            │  · your directive verbatim   │
+ │  ├ classifier + FP loop  │            │  · CacheAligner prefix       │
+ │  ├ skills · agents       │            └──────────────┬───────────────┘
+ │  ├ team board · meter    │                           │ smaller request
+ │  └ optimize / retrieve   │                           ▼
+ └────────────┬─────────────┘            LLM provider (Anthropic
+              │ every data payload        /v1/messages · OpenAI
+              ▼                           /v1/chat/completions)
+ ┌──────────────────────────────────────────────┐
+ │ optimizer router                             │
+ │  json  → schema-preserving skeleton          │
+ │  code  → tree-sitter AST body elision        │
+ │  logs  → template dedup + anchor             │
+ │  prose → sentence anchor (TOIN-gated)        │
+ └────────────────────┬─────────────────────────┘
+                      ▼ skeleton + ⟨ccr:hash⟩
+ ┌──────────────────────────────────────────────┐     ┌─────────────────┐
+ │ CCR store — lossless, content-addressed      │◀───▶│ live dashboard  │
+ │ (sha256 = handle) · integrity-checked reads  │     │ 127.0.0.1:8790  │
+ │ hot → cold gzip → budgeted purge             │     └─────────────────┘
+ └──────────────────────────────────────────────┘
+   self-healing: TOIN backs off over-retrieved kinds ·
+   classifier recalibrates after 3 wrong-verdict votes
+```
+
+**One brain, two doors, one lossless store:**
+
+- **MCP server** (`knitbrain`) — 25 tools: memory (learnings, session handoff), knowledge graph (imports/exports/dependents), workflow classification with a self-healing false-positive loop (3 wrong-verdict votes shift the threshold), a `knitbrain_run` orchestrator (task → skill → agents → directive), an on-demand skills engine, project-specific agent generation, a shared team board, a **context-window meter** (warns and tells the agent to save a handoff before the window blows), and explicit `optimize`/`retrieve`. Every data payload flows through one dispatch chokepoint where it's compressed structure-preservingly and tagged with a `⟨ccr:hash⟩` handle.
+- **Proxy** (`knitbrain-proxy`) — a loopback HTTP proxy in front of the LLM API (provider auto-detected per request: Anthropic `/v1/messages`, OpenAI `/v1/chat/completions`). Compresses the full request — old turns harder than recent ones, exact repeats across turns collapsed to a marker, pasted bulk inside your message compressed while your directive stays verbatim — and streams the response back.
+- **CCR store** — content-addressed (SHA-256 = handle), integrity-checked on every read, atomic writes, tiered retention (hot → cold gzip archive → budgeted purge). The pristine original is always one `retrieve` away, which is what makes aggressive compression safe.
+- **Live dashboard** — context meter, tokens saved, CCR tiers, self-tuning stats, knowledge graph, skills, recent learnings, team board. All stores are cross-process fresh: what the agent writes, the dashboard shows on the next tick.
+
+## Quickstart
+
+```bash
+npm install -g knitbrain
+
+knitbrain profile      # your savings, on your transcripts, before you commit to anything
+
+# in your project:
+knitbrain setup        # detects your platform (Claude Code / Cursor / VS Code / Codex)
+                       # and writes its NATIVE integration: .mcp.json, slash commands,
+                       # rules files — non-clobbering
+
+knitbrain dashboard    # live local dashboard (127.0.0.1:8790)
+
+# optional — route LLM requests through the optimizer (API-key setups):
+knitbrain-proxy        # listens on 127.0.0.1:8788
+export ANTHROPIC_BASE_URL=http://127.0.0.1:8788
+
+# teams — shared optimized sessions (one URL + one token):
+knitbrain hub                              # start the team hub (host runs this once)
+knitbrain join <hub-url> <token> <name>    # everyone else; postings mirror automatically
+```
+
+## If you pay per token
+
+Agent loops re-send the entire conversation on every turn, so input tokens dominate the bill — usually by an order of magnitude over output. That makes context the thing worth optimizing:
+
+- **The proxy shrinks the request itself, on the wire.** ~56% fewer context tokens means a proportionally smaller input bill on the bulk of every request, every turn, compounding over a session.
+- **It stacks with provider prompt caching.** CacheAligner keeps the system prefix byte-stable across turns, so cache hits (which providers discount heavily) happen more often instead of breaking on whitespace drift.
+- **It can never make a request more expensive.** The never-expand guard is enforced by tests: output tokens ≤ input tokens, always.
+- **On a subscription instead?** Same mechanics, different currency: fewer tokens per turn means the context window fills slower — fewer compactions, fewer lost-context restarts, longer useful sessions.
+
+Run `knitbrain profile` to see the percentage on your own workload before believing any of this.
+
+## Guarantees (enforced by gated tests, not promises)
+
+- **Lossless** — every compressed payload recovers byte-for-byte from CCR; the round-trip test gates the build.
+- **Never-expand** — output tokens ≤ input tokens, always.
+- **Governance verbatim** — your instructions and protocol/classification text are never skeletonized.
+- **Local-first** — proxy, hub, and dashboard bind `127.0.0.1` by default; nothing leaves your machine.
+- **Reproducible claims** — every number in this README comes from `knitbrain profile` or `npm run bench`, both of which you can run yourself.
+
+## Development
+
+```bash
+npm install
+npm run verify       # typecheck → lint → test → build → consistency → bench (all must pass)
+npm run e2e          # built-artifact E2E: stdio session + real-file compression
+npm run audit:prod   # cold-start proof: clone → install → pack → installed binaries → all 25 tools
+```
+
+Current proof status: **159 tests passing**, and the production audit (`audit:prod`) passes — fresh clone, clean install, packed tarball installed into a new project, all 25 tools and both binaries verified working. One opt-in test (live LLM endpoint) requires your own API key: `KNITBRAIN_LIVE_TEST=1 ANTHROPIC_API_KEY=… npm test`.
+
+## License
+
+MIT © Piyush Dua

package/dist/ccr/store.d.ts

@@ -0,0 +1,57 @@
+/**
+ * CCR (Compress-Cache-Retrieve) store — the lossless safety net, tiered.
+ *
+ * Content-addressed: the SHA-256 of the original IS the handle (dedup +
+ * integrity). Tiered so disk stays bounded WITHOUT losing anything you might
+ * need: HOT (recent, stored as-is) → COLD (gzip-compressed, kept long-term,
+ * still fully recoverable) → PURGE (only as a warned last resort, by budget).
+ * File existence is authoritative; the manifest holds tiering metadata only.
+ */
+export interface CCRStore {
+    /** Store an original, return its content-hash handle. Idempotent. */
+    put(original: string): string;
+    /** Retrieve the exact original by handle (hot or cold). Throws if absent/corrupt. */
+    get(handle: string): string;
+    /** Whether a handle is present in any tier. */
+    has(handle: string): boolean;
+    /** Which tier a handle lives in. */
+    tierOf(handle: string): "hot" | "cold" | "absent";
+    /** Move a handle HOT → COLD (gzip). No-op if not hot. */
+    demote(handle: string): void;
+    /** Move a handle COLD → HOT (re-warm). No-op if not cold. */
+    promote(handle: string): void;
+    /** Apply a retention policy: demote stale hot entries, purge over-budget cold. */
+    maintain(policy: MaintainPolicy): {
+        demoted: number;
+        purged: number;
+    };
+    /** Tier counts. */
+    stats(): CCRStats;
+}
+export interface MaintainPolicy {
+    /** Demote hot entries whose lastUsed is older than this many ms. */
+    hotMaxAgeMs?: number;
+    /** Keep at most this many hot entries (demote least-recently-used beyond it). */
+    hotMaxEntries?: number;
+    /** Keep at most this many cold entries (purge fewest-retrieved/oldest beyond it). */
+    coldMaxEntries?: number;
+}
+export interface CCRStats {
+    total: number;
+    hot: number;
+    cold: number;
+}
+/** Thrown when a requested handle is in no tier (purged or never stored). */
+export declare class CCRMissingError extends Error {
+    readonly handle: string;
+    constructor(handle: string);
+}
+/** Thrown when stored bytes no longer hash to their handle (corruption). */
+export declare class CCRIntegrityError extends Error {
+    readonly handle: string;
+    constructor(handle: string);
+}
+/** SHA-256 hex digest of a UTF-8 string. */
+export declare function sha256(text: string): string;
+/** Filesystem-backed, tiered CCR store rooted at `root`. */
+export declare function createFileCCRStore(root: string): CCRStore;

package/dist/ccr/store.js

@@ -0,0 +1,195 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+import { gunzipSync, gzipSync } from "node:zlib";
+/** Thrown when a requested handle is in no tier (purged or never stored). */
+export class CCRMissingError extends Error {
+    handle;
+    constructor(handle) {
+        super(`CCR handle not found: ${handle} (purged or never stored — re-run the tool to regenerate)`);
+        this.handle = handle;
+        this.name = "CCRMissingError";
+    }
+}
+/** Thrown when stored bytes no longer hash to their handle (corruption). */
+export class CCRIntegrityError extends Error {
+    handle;
+    constructor(handle) {
+        super(`CCR integrity check failed for handle: ${handle}`);
+        this.handle = handle;
+        this.name = "CCRIntegrityError";
+    }
+}
+/** SHA-256 hex digest of a UTF-8 string. */
+export function sha256(text) {
+    return createHash("sha256").update(text, "utf8").digest("hex");
+}
+const HANDLE_RE = /^[0-9a-f]{64}$/;
+/** Filesystem-backed, tiered CCR store rooted at `root`. */
+export function createFileCCRStore(root) {
+    const coldDir = join(root, "cold");
+    const manifestPath = join(root, "manifest.json");
+    mkdirSync(coldDir, { recursive: true });
+    const meta = new Map();
+    loadManifest();
+    function loadManifest() {
+        if (!existsSync(manifestPath))
+            return;
+        try {
+            const raw = JSON.parse(readFileSync(manifestPath, "utf8"));
+            for (const [k, v] of Object.entries(raw))
+                meta.set(k, v);
+        }
+        catch {
+            // corrupt manifest is non-fatal — file existence is authoritative.
+        }
+    }
+    function saveManifest() {
+        const obj = {};
+        for (const [k, v] of meta.entries())
+            obj[k] = v;
+        const tmp = join(root, `.manifest.${process.pid}.tmp`);
+        writeFileSync(tmp, JSON.stringify(obj), "utf8");
+        renameSync(tmp, manifestPath);
+    }
+    // SECURITY: a handle is ONLY ever a 64-hex SHA-256. Reject anything else
+    // before it touches a filesystem path (prevents traversal + existence probes).
+    const assertHandle = (h) => {
+        if (!HANDLE_RE.test(h))
+            throw new CCRMissingError(h);
+    };
+    const hotPath = (h) => join(root, h);
+    const coldPath = (h) => join(coldDir, `${h}.gz`);
+    const touch = (h) => {
+        const m = meta.get(h) ?? { lastUsed: 0, retrievals: 0 };
+        meta.set(h, { lastUsed: Date.now(), retrievals: m.retrievals });
+    };
+    function writeAtomic(path, data) {
+        const tmp = `${path}.${process.pid}.tmp`;
+        writeFileSync(tmp, data);
+        renameSync(tmp, path);
+    }
+    function listHot() {
+        return readdirSync(root).filter((f) => HANDLE_RE.test(f));
+    }
+    function listCold() {
+        return readdirSync(coldDir)
+            .filter((f) => f.endsWith(".gz"))
+            .map((f) => f.slice(0, -3))
+            .filter((h) => HANDLE_RE.test(h));
+    }
+    function doDemote(handle) {
+        if (!existsSync(hotPath(handle)))
+            return false;
+        const data = readFileSync(hotPath(handle), "utf8");
+        writeAtomic(coldPath(handle), gzipSync(Buffer.from(data, "utf8")));
+        rmSync(hotPath(handle), { force: true });
+        touch(handle);
+        return true;
+    }
+    return {
+        put(original) {
+            const handle = sha256(original);
+            if (!existsSync(hotPath(handle)) && !existsSync(coldPath(handle))) {
+                writeAtomic(hotPath(handle), original);
+            }
+            meta.set(handle, { lastUsed: Date.now(), retrievals: meta.get(handle)?.retrievals ?? 0 });
+            saveManifest();
+            return handle;
+        },
+        has(handle) {
+            if (!HANDLE_RE.test(handle))
+                return false;
+            return existsSync(hotPath(handle)) || existsSync(coldPath(handle));
+        },
+        tierOf(handle) {
+            if (!HANDLE_RE.test(handle))
+                return "absent";
+            if (existsSync(hotPath(handle)))
+                return "hot";
+            if (existsSync(coldPath(handle)))
+                return "cold";
+            return "absent";
+        },
+        get(handle) {
+            assertHandle(handle);
+            if (existsSync(hotPath(handle))) {
+                const data = readFileSync(hotPath(handle), "utf8");
+                if (sha256(data) !== handle)
+                    throw new CCRIntegrityError(handle);
+                const m = meta.get(handle) ?? { lastUsed: 0, retrievals: 0 };
+                meta.set(handle, { lastUsed: Date.now(), retrievals: m.retrievals + 1 });
+                return data;
+            }
+            if (existsSync(coldPath(handle))) {
+                const data = gunzipSync(readFileSync(coldPath(handle))).toString("utf8");
+                if (sha256(data) !== handle)
+                    throw new CCRIntegrityError(handle);
+                const m = meta.get(handle) ?? { lastUsed: 0, retrievals: 0 };
+                meta.set(handle, { lastUsed: Date.now(), retrievals: m.retrievals + 1 });
+                return data;
+            }
+            throw new CCRMissingError(handle);
+        },
+        demote(handle) {
+            if (!HANDLE_RE.test(handle))
+                return;
+            if (doDemote(handle))
+                saveManifest();
+        },
+        promote(handle) {
+            if (!HANDLE_RE.test(handle))
+                return;
+            if (!existsSync(coldPath(handle)))
+                return;
+            const data = gunzipSync(readFileSync(coldPath(handle))).toString("utf8");
+            writeAtomic(hotPath(handle), data);
+            rmSync(coldPath(handle), { force: true });
+            touch(handle);
+            saveManifest();
+        },
+        maintain(policy) {
+            const now = Date.now();
+            const lastUsed = (h) => meta.get(h)?.lastUsed ?? 0;
+            const retrievals = (h) => meta.get(h)?.retrievals ?? 0;
+            // 1) Demote hot → cold (never delete): by age, then by hot-entry cap (LRU).
+            const hot = listHot();
+            const toDemote = new Set();
+            if (policy.hotMaxAgeMs !== undefined) {
+                for (const h of hot) {
+                    if (now - lastUsed(h) > policy.hotMaxAgeMs)
+                        toDemote.add(h);
+                }
+            }
+            if (policy.hotMaxEntries !== undefined) {
+                const survivors = hot.filter((h) => !toDemote.has(h)).sort((a, b) => lastUsed(b) - lastUsed(a));
+                for (const h of survivors.slice(policy.hotMaxEntries))
+                    toDemote.add(h);
+            }
+            let demoted = 0;
+            for (const h of toDemote) {
+                if (doDemote(h))
+                    demoted += 1;
+            }
+            // 2) Purge cold (last resort) by budget: fewest retrievals, then oldest.
+            let purged = 0;
+            if (policy.coldMaxEntries !== undefined) {
+                const cold = listCold().sort((a, b) => retrievals(a) - retrievals(b) || lastUsed(a) - lastUsed(b));
+                for (const h of cold.slice(policy.coldMaxEntries)) {
+                    rmSync(coldPath(h), { force: true });
+                    meta.delete(h);
+                    purged += 1;
+                }
+            }
+            if (demoted > 0 || purged > 0)
+                saveManifest();
+            return { demoted, purged };
+        },
+        stats() {
+            const hot = listHot().length;
+            const cold = listCold().length;
+            return { total: hot + cold, hot, cold };
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/ccr/store.js.map

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

package/dist/dashboard.d.ts

@@ -0,0 +1,23 @@
+import { type Server } from "node:http";
+import type { CCRStore } from "./ccr/store.js";
+import type { Knowledge } from "./engine/knowledge.js";
+import type { Memory } from "./engine/memory.js";
+import type { Feedback } from "./engine/feedback.js";
+import type { SkillsStore } from "./engine/skills.js";
+import type { TeamBoard } from "./engine/teams.js";
+import type { Meter } from "./engine/meter.js";
+export interface DashboardDeps {
+    ccr: CCRStore;
+    memory: Memory;
+    feedback: Feedback;
+    team: TeamBoard;
+    meter: Meter;
+    /** Optional: project knowledge graph (per-project; absent in global mode). */
+    knowledge?: Knowledge;
+    /** Optional: skills store. */
+    skills?: SkillsStore;
+}
+/** One JSON snapshot of everything the dashboard shows. */
+export declare function dashboardState(deps: DashboardDeps): Record<string, unknown>;
+/** Loopback-only dashboard server: GET / (page), GET /api/state (JSON). */
+export declare function createDashboardServer(deps: DashboardDeps): Server;

package/dist/dashboard.js

@@ -0,0 +1,125 @@
+import { createServer } from "node:http";
+import { fetchHubBoard, loadHubConfig } from "./hub/client.js";
+/** Knowledge-graph summary: file count + the highest-fanout files (blast radius). */
+function knowledgeSummary(k) {
+    const files = k.listFiles();
+    const fanout = files
+        .map((file) => ({ file, dependents: k.queryDependents(file).length }))
+        .filter((f) => f.dependents > 0)
+        .sort((a, b) => b.dependents - a.dependents)
+        .slice(0, 5);
+    return { files: files.length, topFanout: fanout };
+}
+/** One JSON snapshot of everything the dashboard shows. */
+export function dashboardState(deps) {
+    const meter = deps.meter.read();
+    const learnings = deps.memory.listLearnings();
+    return {
+        meter,
+        ccr: deps.ccr.stats(),
+        feedback: deps.feedback.stats(),
+        board: deps.team.board().map((e) => ({ id: e.id, author: e.author, ts: e.ts, summary: e.summary.slice(0, 200) })),
+        learnings: learnings.length,
+        recentLearnings: learnings.slice(-5).reverse().map((l) => ({ date: l.date, summary: l.summary.slice(0, 160) })),
+        knowledge: deps.knowledge ? knowledgeSummary(deps.knowledge) : null,
+        skills: deps.skills
+            ? deps.skills.list().map((s) => ({ name: s.name, uses: s.uses, triggers: s.triggers.slice(0, 6), updatedAt: s.updatedAt }))
+            : null,
+        generatedAt: new Date().toISOString(),
+    };
+}
+const PAGE = `<!doctype html>
+<html lang="en"><head><meta charset="utf-8"><title>Knit Brain</title>
+<style>
+  :root { color-scheme: dark; }
+  body { font: 14px/1.5 ui-monospace, monospace; background: #0d1117; color: #e6edf3; margin: 2rem auto; max-width: 880px; padding: 0 1rem; }
+  h1 { font-size: 1.2rem; letter-spacing: .04em; }
+  .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(190px, 1fr)); gap: .8rem; margin: 1rem 0; }
+  .card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: .9rem 1rem; }
+  .big { font-size: 1.6rem; font-weight: 700; }
+  .label { color: #8b949e; font-size: .75rem; text-transform: uppercase; letter-spacing: .08em; }
+  .bar { height: 10px; background: #21262d; border-radius: 5px; overflow: hidden; margin-top: .5rem; }
+  .fill { height: 100%; transition: width .4s; }
+  .ok { background: #3fb950; } .warn { background: #d29922; } .handoff { background: #f85149; }
+  .advice { margin-top: .5rem; color: #8b949e; }
+  table { width: 100%; border-collapse: collapse; margin-top: .4rem; }
+  td, th { text-align: left; padding: .25rem .5rem; border-bottom: 1px solid #21262d; }
+</style></head><body>
+<h1>🧠 knitbrain — live</h1>
+<div class="grid">
+  <div class="card"><div class="label">Context window</div><div class="big" id="pct">–</div>
+    <div class="bar"><div class="fill ok" id="fill" style="width:0%"></div></div>
+    <div class="advice" id="advice"></div></div>
+  <div class="card"><div class="label">Tokens saved (session)</div><div class="big" id="saved">–</div></div>
+  <div class="card"><div class="label">CCR store (hot / cold)</div><div class="big" id="ccr">–</div></div>
+  <div class="card"><div class="label">Learnings</div><div class="big" id="learnings">–</div></div>
+</div>
+<div class="card"><div class="label">Self-tuning (retrieval rate per kind)</div><table id="fb"></table></div>
+<div class="card" style="margin-top:.8rem"><div class="label">Knowledge graph (top blast radius)</div><div class="advice" id="kfiles"></div><table id="kg"></table></div>
+<div class="card" style="margin-top:.8rem"><div class="label">Skills</div><table id="skills"></table></div>
+<div class="card" style="margin-top:.8rem"><div class="label">Recent learnings</div><table id="recent"></table></div>
+<div class="card" style="margin-top:.8rem"><div class="label">Team board</div><table id="board"></table></div>
+<script>
+async function tick() {
+  try {
+    const s = await (await fetch("/api/state")).json();
+    document.getElementById("pct").textContent = s.meter.usedPct + "%";
+    const fill = document.getElementById("fill");
+    fill.style.width = Math.min(100, s.meter.usedPct) + "%";
+    fill.className = "fill " + s.meter.status;
+    document.getElementById("advice").textContent = s.meter.advice;
+    document.getElementById("saved").textContent = s.meter.savedTokens.toLocaleString();
+    document.getElementById("ccr").textContent = s.ccr.hot + " / " + s.ccr.cold;
+    document.getElementById("learnings").textContent = s.learnings;
+    document.getElementById("fb").innerHTML = "<tr><th>kind</th><th>compressed</th><th>retrieved</th><th>rate</th><th>state</th></tr>" +
+      s.feedback.map(f => \`<tr><td>\${f.kind}</td><td>\${f.compressions}</td><td>\${f.retrievals}</td><td>\${f.rate}</td><td>\${f.skipping ? "backing off" : "active"}</td></tr>\`).join("");
+    const esc = (v) => String(v).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;");
+    if (s.knowledge) {
+      document.getElementById("kfiles").textContent = s.knowledge.files + " files indexed";
+      document.getElementById("kg").innerHTML = "<tr><th>file</th><th>dependents</th></tr>" +
+        (s.knowledge.topFanout.length ? s.knowledge.topFanout.map(f => \`<tr><td>\${esc(f.file)}</td><td>\${f.dependents}</td></tr>\`).join("") : "<tr><td colspan=2>— run a scan —</td></tr>");
+    } else {
+      document.getElementById("kfiles").textContent = "no project scope (start the dashboard inside a project)";
+    }
+    document.getElementById("skills").innerHTML = "<tr><th>skill</th><th>uses</th><th>triggers</th><th>updated</th></tr>" +
+      (s.skills && s.skills.length ? s.skills.map(k => \`<tr><td>\${esc(k.name)}</td><td>\${k.uses}</td><td>\${esc(k.triggers.join(", "))}</td><td>\${esc(k.updatedAt.slice(0,10))}</td></tr>\`).join("") : "<tr><td colspan=4>—</td></tr>");
+    document.getElementById("recent").innerHTML = "<tr><th>date</th><th>learning</th></tr>" +
+      (s.recentLearnings.length ? s.recentLearnings.map(l => \`<tr><td>\${esc(l.date)}</td><td>\${esc(l.summary)}</td></tr>\`).join("") : "<tr><td colspan=2>—</td></tr>");
+    document.getElementById("board").innerHTML = "<tr><th>who</th><th>when</th><th>finding</th></tr>" +
+      (s.board.length ? s.board.map(b => \`<tr><td>\${esc(b.author)}</td><td>\${esc(b.ts.slice(11,19))}</td><td>\${esc(b.summary)}</td></tr>\`).join("") : "<tr><td colspan=3>—</td></tr>");
+  } catch {}
+}
+tick(); setInterval(tick, 2000);
+</script></body></html>`;
+/** Loopback-only dashboard server: GET / (page), GET /api/state (JSON). */
+export function createDashboardServer(deps) {
+    return createServer((req, res) => {
+        if (req.url === "/api/state") {
+            void (async () => {
+                const state = dashboardState(deps);
+                // COMMON view: merge the team hub's board (best-effort, never blocks long).
+                const hub = loadHubConfig();
+                if (hub) {
+                    const remote = await fetchHubBoard(hub);
+                    const local = state["board"];
+                    const seen = new Set(local.map((e) => e.id));
+                    state["board"] = [
+                        ...local,
+                        ...remote.filter((e) => !seen.has(e.id)).map((e) => ({ ...e, author: `${e.author} (hub)` })),
+                    ];
+                }
+                res.writeHead(200, { "content-type": "application/json" });
+                res.end(JSON.stringify(state));
+            })();
+            return;
+        }
+        if (req.url === "/" || req.url === "/index.html") {
+            res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
+            res.end(PAGE);
+            return;
+        }
+        res.writeHead(404, { "content-type": "application/json" });
+        res.end(JSON.stringify({ error: "not found" }));
+    });
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

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

package/dist/engine/agents.d.ts

@@ -0,0 +1,36 @@
+export interface DomainProposal {
+    /** Short domain name (e.g. "proxy"). */
+    name: string;
+    /** Glob the agent is scoped to (guardrail #1). */
+    scope: string;
+    /** Files detected in the domain. */
+    files: string[];
+    /** Suggested tool allowlist (guardrail #2). */
+    tools: string[];
+    /** Whether a review/verify gate is recommended (guardrail #3). */
+    reviewGate: boolean;
+    /** Suggested context-token budget (guardrail #4). */
+    contextBudget: number;
+}
+export interface AgentSpec {
+    name: string;
+    description?: string;
+    scope?: string;
+    tools?: string[];
+    reviewGate?: boolean;
+    contextBudget?: number;
+}
+/**
+ * Auto-detect candidate domain agents from the knowledge graph: group source
+ * files by their directory; each directory with ≥2 files becomes a proposal
+ * with sensible, project-specific guardrails. The agent then interviews the
+ * user to confirm/edit before create_agent writes them.
+ */
+export declare function proposeAgents(files: string[]): DomainProposal[];
+/**
+ * Render a project-specific subagent definition with all four guardrails baked
+ * in: file/domain scope, allowed-tools allowlist, review gate, context budget.
+ */
+export declare function generateAgentMarkdown(spec: AgentSpec): string;
+/** Write a generated agent to the project's .claude/agents directory. */
+export declare function writeAgent(projectRoot: string, spec: AgentSpec): string;