knitbrain 0.1.0

package/dist/engine/meter.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Context-window meter — tracks how much of the model's context window the
+ * session has consumed and tells the agent (and the dashboard) when it's time
+ * to save a handoff and clear.
+ *
+ * Sources: the proxy reports the OPTIMIZED request size per turn (the true
+ * context the model sees); the MCP side adds tool-output tokens as a floor
+ * when no proxy is in the loop.
+ */
+export interface MeterReading {
+    /** Best-known tokens occupying the context window right now. */
+    usedTokens: number;
+    /** The window budget being metered against. */
+    windowTokens: number;
+    /** 0–100. */
+    usedPct: number;
+    /** Tokens the optimizer saved this session (before − after). */
+    savedTokens: number;
+    status: "ok" | "warn" | "handoff";
+    /** Human advice matching the status. */
+    advice: string;
+}
+export interface Meter {
+    /** Proxy turn: the full optimized request size IS the current context. */
+    onRequest(originalTokens: number, optimizedTokens: number): void;
+    /** MCP-side: a tool emitted `tokens` into the conversation (additive floor). */
+    onToolOutput(tokens: number): void;
+    read(): MeterReading;
+    /** New session: reset usage (savings history is kept). */
+    reset(): void;
+}
+export interface MeterOptions {
+    /** Context window budget in tokens. Default 200k (Claude-class). */
+    windowTokens?: number;
+    /** warn at this fraction. Default 0.7. */
+    warnAt?: number;
+    /** advise handoff+clear at this fraction. Default 0.85. */
+    handoffAt?: number;
+}
+export declare function createMeter(root: string, opts?: MeterOptions): Meter;

package/dist/engine/meter.js

@@ -0,0 +1,61 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+export function createMeter(root, opts = {}) {
+    const windowTokens = opts.windowTokens ?? 200_000;
+    const warnAt = opts.warnAt ?? 0.7;
+    const handoffAt = opts.handoffAt ?? 0.85;
+    mkdirSync(root, { recursive: true });
+    const path = join(root, "meter.json");
+    let state = { lastRequestTokens: 0, toolTokens: 0, savedTokens: 0 };
+    // Proxy, MCP server, and dashboard all share this store across processes —
+    // re-read disk before every public operation so no reader serves stale state.
+    const reload = () => {
+        if (!existsSync(path))
+            return;
+        try {
+            state = { ...state, ...JSON.parse(readFileSync(path, "utf8")) };
+        }
+        catch {
+            /* keep current in-memory state */
+        }
+    };
+    reload();
+    const save = () => {
+        const tmp = `${path}.${process.pid}.tmp`;
+        writeFileSync(tmp, JSON.stringify(state), "utf8");
+        renameSync(tmp, path);
+    };
+    return {
+        onRequest(originalTokens, optimizedTokens) {
+            reload();
+            // The optimized request is the authoritative context size this turn.
+            state.lastRequestTokens = optimizedTokens;
+            state.toolTokens = 0; // request already contains prior tool outputs
+            state.savedTokens += Math.max(0, originalTokens - optimizedTokens);
+            save();
+        },
+        onToolOutput(tokens) {
+            reload();
+            state.toolTokens += tokens;
+            save();
+        },
+        read() {
+            reload();
+            const usedTokens = state.lastRequestTokens + state.toolTokens;
+            const usedPct = Math.min(100, Math.round((usedTokens / windowTokens) * 1000) / 10);
+            const frac = usedTokens / windowTokens;
+            const status = frac >= handoffAt ? "handoff" : frac >= warnAt ? "warn" : "ok";
+            const advice = status === "handoff"
+                ? `Context ${usedPct}% full — SAVE A HANDOFF NOW (knitbrain_save_handoff with goal/state/next steps), then clear the session and resume; knitbrain_load_session restores everything.`
+                : status === "warn"
+                    ? `Context ${usedPct}% full — finish the current step, then consider knitbrain_save_handoff before starting anything large.`
+                    : `Context ${usedPct}% full — healthy.`;
+            return { usedTokens, windowTokens, usedPct, savedTokens: state.savedTokens, status, advice };
+        },
+        reset() {
+            state = { lastRequestTokens: 0, toolTokens: 0, savedTokens: state.savedTokens };
+            save();
+        },
+    };
+}
+//# sourceMappingURL=meter.js.map

package/dist/engine/meter.js.map

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

package/dist/engine/skills.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skills engine — find-or-write executable playbooks.
+ *
+ * Skills are made ON-DEMAND when the user states a task (never pre-installed,
+ * never downloaded): knitbrain drafts a telegraphic (caveman-method) playbook
+ * seeded from past learnings, the agent refines it while working, and the
+ * refined version is saved back. Skills persist and compound; agents are
+ * disposable workers briefed with them.
+ */
+export interface Skill {
+    id: string;
+    name: string;
+    /** Trigger keywords for matching future tasks. */
+    triggers: string[];
+    /** Telegraphic playbook body (caveman-method: max knowledge per token). */
+    body: string;
+    uses: number;
+    updatedAt: string;
+}
+export interface SkillsStore {
+    /** Best skill for a task, or null. Bumps `uses` on hit. */
+    find(task: string): Skill | null;
+    /** Draft a NEW telegraphic skill skeleton for a task (not persisted). */
+    draft(task: string, seedLessons: string[]): string;
+    /** Persist a skill (create or update by name). */
+    save(input: {
+        name: string;
+        body: string;
+        triggers?: string[];
+    }): Skill;
+    list(): Skill[];
+}
+export declare function createSkillsStore(root: string): SkillsStore;

package/dist/engine/skills.js

@@ -0,0 +1,97 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const tokenize = (s) => s.toLowerCase().split(/[^a-z0-9]+/).filter((t) => t.length > 2);
+export function createSkillsStore(root) {
+    mkdirSync(root, { recursive: true });
+    const path = join(root, "skills.json");
+    const load = () => {
+        if (!existsSync(path))
+            return [];
+        try {
+            return JSON.parse(readFileSync(path, "utf8"));
+        }
+        catch {
+            return [];
+        }
+    };
+    const persist = (skills) => {
+        const tmp = `${path}.${process.pid}.tmp`;
+        writeFileSync(tmp, JSON.stringify(skills, null, 2), "utf8");
+        renameSync(tmp, path);
+    };
+    return {
+        find(task) {
+            const terms = new Set(tokenize(task));
+            let best = null;
+            let bestScore = 0;
+            const all = load();
+            for (const s of all) {
+                let score = 0;
+                for (const t of s.triggers)
+                    if (terms.has(t))
+                        score += 2;
+                for (const t of tokenize(s.name))
+                    if (terms.has(t))
+                        score += 1;
+                if (score > bestScore) {
+                    best = s;
+                    bestScore = score;
+                }
+            }
+            if (best && bestScore >= 2) {
+                best.uses += 1;
+                persist(all);
+                return best;
+            }
+            return null;
+        },
+        draft(task, seedLessons) {
+            // Telegraphic skeleton (caveman method): no filler, fragments OK,
+            // sections the agent fills while working, then saves via skill_save.
+            const pitfalls = seedLessons.length > 0
+                ? seedLessons.map((l) => `- ${l}`).join("\n")
+                : "- (none known. add what bites.)";
+            return `# skill: ${task.slice(0, 64)}
+
+GOAL: ${task}
+
+STEPS:
+1. ground first: query_imports/dependents on touched files.
+2. smallest correct change. verify before claim.
+3. gates green before done.
+
+CHECKS:
+- lossless? never-expand? tests pass?
+
+PITFALLS (from memory):
+${pitfalls}
+
+AFTER: refine this skill w/ what you learned → knitbrain_skill_save (same name). Skill compound.`;
+        },
+        save(input) {
+            const all = load();
+            const triggers = input.triggers && input.triggers.length > 0 ? input.triggers : tokenize(input.name);
+            const existing = all.find((s) => s.name === input.name);
+            if (existing) {
+                existing.body = input.body;
+                existing.triggers = [...new Set([...existing.triggers, ...triggers])];
+                existing.updatedAt = new Date().toISOString();
+                persist(all);
+                return existing;
+            }
+            const skill = {
+                id: createHash("sha256").update(input.name + Date.now()).digest("hex").slice(0, 8),
+                name: input.name,
+                triggers,
+                body: input.body,
+                uses: 0,
+                updatedAt: new Date().toISOString(),
+            };
+            persist([...all, skill]);
+            return skill;
+        },
+        list: load,
+    };
+}
+//# sourceMappingURL=skills.js.map

package/dist/engine/skills.js.map

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

package/dist/engine/teams.d.ts

@@ -0,0 +1,28 @@
+import type { CCRStore } from "../ccr/store.js";
+/** One posting on the shared board: a compressed skeleton + a CCR handle to the full original. */
+export interface BoardEntry {
+    id: string;
+    author: string;
+    /** Compressed/skeleton view (cheap for other agents to read). */
+    summary: string;
+    /** CCR handle to the pristine original. */
+    handle: string;
+    ts: string;
+}
+export interface TeamBoard {
+    /** Post a finding: store the full original in CCR, keep a compressed summary on the board. */
+    post(author: string, content: string): BoardEntry;
+    /** The shared board — skeletons only (page originals via get). */
+    board(): BoardEntry[];
+    /** Fetch the full original of an entry by id (byte-for-byte from CCR). */
+    get(id: string): string | null;
+    /** Clear the board (entries only; CCR originals remain until tiered out). */
+    clear(): void;
+}
+/**
+ * Shared compressed-context board. Parallel agents post findings as skeletons
+ * (cheap for everyone to read); the full original is one CCR lookup away. This
+ * is what makes N parallel agents NOT multiply context cost. Local-first; the
+ * networked multi-user hub builds on top of this later.
+ */
+export declare function createTeamBoard(root: string, ccr: CCRStore): TeamBoard;

package/dist/engine/teams.js

@@ -0,0 +1,58 @@
+import { createHash } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { compress } from "../optimizer/router.js";
+/**
+ * Shared compressed-context board. Parallel agents post findings as skeletons
+ * (cheap for everyone to read); the full original is one CCR lookup away. This
+ * is what makes N parallel agents NOT multiply context cost. Local-first; the
+ * networked multi-user hub builds on top of this later.
+ */
+export function createTeamBoard(root, ccr) {
+    mkdirSync(root, { recursive: true });
+    const path = join(root, "board.json");
+    const load = () => {
+        if (!existsSync(path))
+            return [];
+        try {
+            return JSON.parse(readFileSync(path, "utf8"));
+        }
+        catch {
+            return [];
+        }
+    };
+    const save = (entries) => {
+        const tmp = `${path}.${process.pid}.tmp`;
+        writeFileSync(tmp, JSON.stringify(entries, null, 2), "utf8");
+        renameSync(tmp, path);
+    };
+    return {
+        post(author, content) {
+            const r = compress(content, ccr);
+            // Always keep the pristine original recoverable, compressed or not.
+            const handle = r.compressed ? r.handle : ccr.put(content);
+            const entry = {
+                id: createHash("sha256").update(author + content + Date.now()).digest("hex").slice(0, 8),
+                author,
+                summary: r.compressed ? r.skeleton : content,
+                handle,
+                ts: new Date().toISOString(),
+            };
+            save([...load(), entry]);
+            return entry;
+        },
+        board() {
+            return load();
+        },
+        get(id) {
+            const entry = load().find((e) => e.id === id);
+            if (!entry)
+                return null;
+            return ccr.get(entry.handle);
+        },
+        clear() {
+            save([]);
+        },
+    };
+}
+//# sourceMappingURL=teams.js.map

package/dist/engine/teams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"teams.js","sourceRoot":"","sources":["../../src/engine/teams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAwBlD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,GAAa;IACzD,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAEtC,MAAM,IAAI,GAAG,GAAiB,EAAE;QAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiB,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,OAAqB,EAAQ,EAAE;QAC3C,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC;QACzC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,CAAC,MAAM,EAAE,OAAO;YAClB,MAAM,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjC,oEAAoE;YACpE,MAAM,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAe;gBACxB,EAAE,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACxF,MAAM;gBACN,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO;gBAC5C,MAAM;gBACN,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aAC7B,CAAC;YACF,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,KAAK;YACH,OAAO,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK;YACH,IAAI,CAAC,EAAE,CAAC,CAAC;QACX,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/workflow.d.ts

@@ -0,0 +1,18 @@
+export type Tier = "inquiry" | "trivial" | "standard" | "complex";
+export interface Classification {
+    tier: Tier;
+    phases: string[];
+    autoPlanMode: boolean;
+    reason: string;
+}
+/**
+ * Deterministic tier router (no ML). Mirrors Knit's classifier shape:
+ * inquiry → just answer; trivial → execute; standard → light loop;
+ * complex → plan-mode + full phases.
+ *
+ * `scopeAdjust` is the calibration dial from the false-positive loop: positive
+ * raises the file-count bar for "complex" (classifier was over-sensitive),
+ * negative lowers it. Keyword-triggered complex is exempt unless the bar was
+ * raised — explicit risk words stay authoritative until users vote otherwise.
+ */
+export declare function classifyTask(description: string, files?: string[], scopeAdjust?: number): Classification;

package/dist/engine/workflow.js

@@ -0,0 +1,40 @@
+const COMPLEX = /\b(architect|architecture|refactor|migrat|redesign|rewrite|security|schema|breaking|orchestrat|protocol|concurren)/i;
+const TRIVIAL = /\b(typo|rename|comment|bump|format|lint|whitespace|one[- ]?line)\b/i;
+const INQUIRY = /^\s*(how|what|why|where|which|who|can|does|do|is|are|should|could|would|when)\b|[?]\s*$/i;
+/**
+ * Deterministic tier router (no ML). Mirrors Knit's classifier shape:
+ * inquiry → just answer; trivial → execute; standard → light loop;
+ * complex → plan-mode + full phases.
+ *
+ * `scopeAdjust` is the calibration dial from the false-positive loop: positive
+ * raises the file-count bar for "complex" (classifier was over-sensitive),
+ * negative lowers it. Keyword-triggered complex is exempt unless the bar was
+ * raised — explicit risk words stay authoritative until users vote otherwise.
+ */
+export function classifyTask(description, files = [], scopeAdjust = 0) {
+    const fileCount = files.filter((f) => f.trim().length > 0).length;
+    if (fileCount === 0 && INQUIRY.test(description) && !COMPLEX.test(description)) {
+        return { tier: "inquiry", phases: [], autoPlanMode: false, reason: "question with no files to touch" };
+    }
+    const complexAt = Math.max(2, 4 + scopeAdjust);
+    const keywordComplex = COMPLEX.test(description) && scopeAdjust <= 0;
+    if (keywordComplex || fileCount >= complexAt) {
+        const calNote = scopeAdjust !== 0 ? ` (calibrated: threshold ${complexAt} files)` : "";
+        return {
+            tier: "complex",
+            phases: ["RESEARCH", "PLAN", "EXECUTE", "REVIEW", "LEARN"],
+            autoPlanMode: true,
+            reason: (keywordComplex ? "high-risk keyword detected" : `${fileCount} files in scope`) + calNote,
+        };
+    }
+    if (TRIVIAL.test(description) || (fileCount <= 1 && description.length < 60)) {
+        return { tier: "trivial", phases: ["EXECUTE"], autoPlanMode: false, reason: "small, low-risk change" };
+    }
+    return {
+        tier: "standard",
+        phases: ["RESEARCH", "EXECUTE", "REVIEW", "LEARN"],
+        autoPlanMode: false,
+        reason: "standard multi-step change",
+    };
+}
+//# sourceMappingURL=workflow.js.map

package/dist/engine/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/engine/workflow.ts"],"names":[],"mappings":"AASA,MAAM,OAAO,GAAG,qHAAqH,CAAC;AACtI,MAAM,OAAO,GAAG,qEAAqE,CAAC;AACtF,MAAM,OAAO,GAAG,0FAA0F,CAAC;AAE3G;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,WAAmB,EAAE,QAAkB,EAAE,EAAE,WAAW,GAAG,CAAC;IACrF,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAElE,IAAI,SAAS,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,iCAAiC,EAAE,CAAC;IACzG,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC;IAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,WAAW,IAAI,CAAC,CAAC;IACrE,IAAI,cAAc,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,2BAA2B,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,OAAO;YACL,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;YAC1D,YAAY,EAAE,IAAI;YAClB,MAAM,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,4BAA4B,CAAC,CAAC,CAAC,GAAG,SAAS,iBAAiB,CAAC,GAAG,OAAO;SAClG,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC;QAC7E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACzG,CAAC;IACD,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC;QAClD,YAAY,EAAE,KAAK;QACnB,MAAM,EAAE,4BAA4B;KACrC,CAAC;AACJ,CAAC"}

package/dist/hooks/index.d.ts

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

package/dist/hooks/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * knitbrain-hook — host lifecycle hooks (Layer 2, per-platform enhancement on
+ * top of the universal knitbrain_read steering).
+ *
+ *   knitbrain-hook pretooluse   stdin: PreToolUse JSON → deny+redirect large raw Reads
+ *   knitbrain-hook precompact   auto-save a handoff BEFORE the host compacts
+ *
+ * Hooks must NEVER break the host: any internal error exits 0 silently.
+ */
+import { createMemory } from "../engine/memory.js";
+import { memoryRoot } from "../paths.js";
+import { decidePreToolUse } from "./pretooluse.js";
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = "";
+        process.stdin.on("data", (c) => (data += c));
+        process.stdin.on("end", () => resolve(data));
+        setTimeout(() => resolve(data), 2000); // never hang the host
+    });
+}
+async function main() {
+    const mode = process.argv[2];
+    try {
+        if (mode === "pretooluse") {
+            const input = JSON.parse(await readStdin());
+            const decision = decidePreToolUse(input);
+            if (decision)
+                process.stdout.write(JSON.stringify(decision));
+            return;
+        }
+        if (mode === "precompact") {
+            // The host is about to compact — capture a resumable handoff first so
+            // nothing is lost to compaction. load_session restores it next time.
+            const memory = createMemory(memoryRoot());
+            const prior = memory.loadSession().handoff ?? "";
+            const note = `[auto-handoff @ ${new Date().toISOString()}] Host compaction imminent. If resuming after a clear: re-run knitbrain_load_session, re-check knitbrain_context_meter, and continue from the state below.\n${prior}`;
+            memory.saveHandoff(note);
+            return;
+        }
+    }
+    catch {
+        // swallow — a hook failure must never break the host session
+    }
+}
+main().then(() => process.exit(0), () => process.exit(0));
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAwB,MAAM,iBAAiB,CAAC;AAEzE,SAAS,SAAS;IAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,sBAAsB;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,SAAS,EAAE,CAAoB,CAAC;YAC/D,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,QAAQ;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC7D,OAAO;QACT,CAAC;QACD,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;YAC1B,sEAAsE;YACtE,qEAAqE;YACrE,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;YAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,mBAAmB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,+JAA+J,KAAK,EAAE,CAAC;YAC/N,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6DAA6D;IAC/D,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,IAAI,CACT,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EACrB,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CACtB,CAAC"}

package/dist/hooks/pretooluse.d.ts

@@ -0,0 +1,23 @@
+/**
+ * PreToolUse hook logic (pure — IO injected for tests).
+ *
+ * When the host is about to raw-Read a LARGE file, deny with a reason that
+ * redirects the agent to `knitbrain_read` — turning the rules-file steering
+ * into automatic ENFORCEMENT. Small files pass through untouched. This uses
+ * the stable PreToolUse deny contract (works across host versions, unlike
+ * PostToolUse output replacement).
+ */
+export interface PreToolUseInput {
+    tool_name?: string;
+    tool_input?: {
+        file_path?: string;
+        [k: string]: unknown;
+    };
+    cwd?: string;
+}
+/** Files larger than this are denied in favor of knitbrain_read. */
+export declare const READ_REDIRECT_BYTES = 20000;
+export declare function decidePreToolUse(input: PreToolUseInput, io?: {
+    exists: (p: string) => boolean;
+    sizeOf: (p: string) => number;
+}): Record<string, unknown> | null;

package/dist/hooks/pretooluse.js

@@ -0,0 +1,38 @@
+import { existsSync, statSync } from "node:fs";
+import { isAbsolute, relative } from "node:path";
+/** Files larger than this are denied in favor of knitbrain_read. */
+export const READ_REDIRECT_BYTES = 20_000;
+export function decidePreToolUse(input, io = {
+    exists: existsSync,
+    sizeOf: (p) => statSync(p).size,
+}) {
+    if (input.tool_name !== "Read")
+        return null;
+    const path = input.tool_input?.file_path;
+    if (typeof path !== "string" || path.length === 0)
+        return null;
+    if (!io.exists(path))
+        return null;
+    let size;
+    try {
+        size = io.sizeOf(path);
+    }
+    catch {
+        return null;
+    }
+    if (size <= READ_REDIRECT_BYTES)
+        return null;
+    const cwd = input.cwd ?? process.cwd();
+    const rel = isAbsolute(path) ? relative(cwd, path) : path;
+    // Never redirect reads outside the project — knitbrain_read is project-scoped.
+    if (rel.startsWith(".."))
+        return null;
+    return {
+        hookSpecificOutput: {
+            hookEventName: "PreToolUse",
+            permissionDecision: "deny",
+            permissionDecisionReason: `Large file (${Math.round(size / 1024)}KB). Use knitbrain_read with path "${rel}" instead — optimized skeleton (~70-90% fewer tokens), exact original via knitbrain_retrieve. Raw Read only for the specific region you are about to edit.`,
+        },
+    };
+}
+//# sourceMappingURL=pretooluse.js.map

package/dist/hooks/pretooluse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretooluse.js","sourceRoot":"","sources":["../../src/hooks/pretooluse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAiBjD,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,KAAwE;IACtE,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;CAChC;IAED,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC;IACzC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/D,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAElC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,IAAI,IAAI,mBAAmB;QAAE,OAAO,IAAI,CAAC;IAE7C,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,+EAA+E;IAC/E,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,OAAO;QACL,kBAAkB,EAAE;YAClB,aAAa,EAAE,YAAY;YAC3B,kBAAkB,EAAE,MAAM;YAC1B,wBAAwB,EAAE,eAAe,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,sCAAsC,GAAG,4JAA4J;SACtQ;KACF,CAAC;AACJ,CAAC"}

package/dist/hub/client.d.ts

@@ -0,0 +1,26 @@
+/** Where this machine's hub membership lives. */
+export interface HubConfig {
+    url: string;
+    token: string;
+    /** Display name for this member's postings. */
+    member: string;
+}
+/** `knitbrain join <url> <token> [member]` writes this. */
+export declare function saveHubConfig(cfg: HubConfig): string;
+export declare function loadHubConfig(): HubConfig | null;
+/**
+ * Mirror a board posting to the hub — FIRE-AND-FORGET. Never throws, never
+ * blocks: a dead/unreachable hub must never slow local work.
+ */
+export declare function mirrorToHub(cfg: HubConfig, entry: {
+    author: string;
+    summary: string;
+    original: string;
+}): void;
+/** Best-effort hub board fetch (for the dashboard's merged view). */
+export declare function fetchHubBoard(cfg: HubConfig, timeoutMs?: number): Promise<Array<{
+    id: string;
+    author: string;
+    summary: string;
+    ts: string;
+}>>;

package/dist/hub/client.js

@@ -0,0 +1,64 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { knitbrainHome } from "../paths.js";
+function configPath() {
+    return join(knitbrainHome(), "hub.json");
+}
+/** `knitbrain join <url> <token> [member]` writes this. */
+export function saveHubConfig(cfg) {
+    mkdirSync(knitbrainHome(), { recursive: true });
+    const path = configPath();
+    const tmp = `${path}.${process.pid}.tmp`;
+    writeFileSync(tmp, JSON.stringify(cfg, null, 2), { encoding: "utf8", mode: 0o600 });
+    renameSync(tmp, path);
+    return path;
+}
+export function loadHubConfig() {
+    const path = configPath();
+    if (!existsSync(path))
+        return null;
+    try {
+        const cfg = JSON.parse(readFileSync(path, "utf8"));
+        return cfg.url && cfg.token ? cfg : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Mirror a board posting to the hub — FIRE-AND-FORGET. Never throws, never
+ * blocks: a dead/unreachable hub must never slow local work.
+ */
+export function mirrorToHub(cfg, entry) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 2000);
+    void fetch(`${cfg.url.replace(/\/+$/, "")}/board`, {
+        method: "POST",
+        headers: { "content-type": "application/json", authorization: `Bearer ${cfg.token}` },
+        body: JSON.stringify({ ...entry, author: cfg.member || entry.author }),
+        signal: controller.signal,
+    })
+        .catch(() => { })
+        .finally(() => clearTimeout(timer));
+}
+/** Best-effort hub board fetch (for the dashboard's merged view). */
+export async function fetchHubBoard(cfg, timeoutMs = 1500) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetch(`${cfg.url.replace(/\/+$/, "")}/board`, {
+            headers: { authorization: `Bearer ${cfg.token}` },
+            signal: controller.signal,
+        });
+        if (!res.ok)
+            return [];
+        return (await res.json());
+    }
+    catch {
+        return [];
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/hub/client.js.map

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