knitbrain 0.1.0

package/dist/hub/server.d.ts

@@ -0,0 +1,23 @@
+import { type Server } from "node:http";
+/**
+ * Knit Brain HUB — the shared-sessions server a team points at.
+ * One URL + one token; everything else is invisible. Clients mirror their
+ * board postings here fire-and-forget; dashboards read the merged view.
+ * Auth: single team token (Bearer). Originals stored verbatim server-side so
+ * any teammate can page in the full content (their local CCR handles don't
+ * resolve across machines).
+ */
+export interface HubEntry {
+    id: string;
+    author: string;
+    /** Compressed skeleton (cheap for everyone to scan). */
+    summary: string;
+    /** Full original (recoverable by any teammate). */
+    original: string;
+    ts: string;
+}
+export interface Hub {
+    server: Server;
+    token: string;
+}
+export declare function createHub(root: string): Hub;

package/dist/hub/server.js

@@ -0,0 +1,85 @@
+import { randomBytes, createHash, timingSafeEqual } from "node:crypto";
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { createServer } from "node:http";
+import { join } from "node:path";
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let d = "";
+        req.on("data", (c) => (d += c));
+        req.on("end", () => resolve(d));
+        req.on("error", reject);
+    });
+}
+export function createHub(root) {
+    mkdirSync(root, { recursive: true });
+    const tokenPath = join(root, "token.txt");
+    const boardPath = join(root, "board.json");
+    let token;
+    if (existsSync(tokenPath)) {
+        token = readFileSync(tokenPath, "utf8").trim();
+    }
+    else {
+        token = `khub_${randomBytes(24).toString("hex")}`;
+        writeFileSync(tokenPath, token, { encoding: "utf8", mode: 0o600 });
+    }
+    const load = () => {
+        if (!existsSync(boardPath))
+            return [];
+        try {
+            return JSON.parse(readFileSync(boardPath, "utf8"));
+        }
+        catch {
+            return [];
+        }
+    };
+    const save = (entries) => {
+        const tmp = `${boardPath}.${process.pid}.tmp`;
+        writeFileSync(tmp, JSON.stringify(entries), "utf8");
+        renameSync(tmp, boardPath);
+    };
+    // SECURITY: constant-time comparison — no timing oracle on the team token.
+    const expected = createHash("sha256").update(`Bearer ${token}`).digest();
+    const authed = (req) => {
+        const got = createHash("sha256").update(req.headers.authorization ?? "").digest();
+        return timingSafeEqual(got, expected);
+    };
+    const json = (res, code, body) => {
+        res.writeHead(code, { "content-type": "application/json" });
+        res.end(JSON.stringify(body));
+    };
+    const server = createServer((req, res) => {
+        void (async () => {
+            if (req.method === "GET" && req.url === "/health") {
+                return json(res, 200, { status: "healthy", server: "knitbrain-hub" });
+            }
+            if (!authed(req))
+                return json(res, 401, { error: "missing or invalid token" });
+            if (req.method === "POST" && req.url === "/board") {
+                const body = JSON.parse(await readBody(req));
+                if (typeof body.author !== "string" || typeof body.original !== "string") {
+                    return json(res, 400, { error: "author and original are required" });
+                }
+                const entry = {
+                    id: createHash("sha256").update(body.author + body.original + Date.now()).digest("hex").slice(0, 8),
+                    author: body.author,
+                    summary: typeof body.summary === "string" ? body.summary : body.original.slice(0, 400),
+                    original: body.original,
+                    ts: new Date().toISOString(),
+                };
+                save([...load(), entry]);
+                return json(res, 200, { id: entry.id });
+            }
+            if (req.method === "GET" && req.url === "/board") {
+                return json(res, 200, load().map((e) => ({ id: e.id, author: e.author, summary: e.summary, ts: e.ts })));
+            }
+            const m = req.url?.match(/^\/board\/([0-9a-f]{8})$/);
+            if (req.method === "GET" && m) {
+                const entry = load().find((e) => e.id === m[1]);
+                return entry ? json(res, 200, entry) : json(res, 404, { error: "not found" });
+            }
+            return json(res, 404, { error: "not found" });
+        })().catch((err) => json(res, 500, { error: String(err) }));
+    });
+    return { server, token };
+}
+//# sourceMappingURL=server.js.map

package/dist/hub/server.js.map

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { buildServer } from "./server.js";
+import { runSetup } from "./setup.js";
+async function main() {
+    if (process.argv[2] === "setup") {
+        process.exit(runSetup());
+    }
+    if (process.argv[2] === "hub") {
+        const [{ createHub }, { knitbrainHome }, { join }] = await Promise.all([
+            import("./hub/server.js"),
+            import("./paths.js"),
+            import("node:path"),
+        ]);
+        const { server, token } = createHub(join(knitbrainHome(), "hub"));
+        const port = Number(process.env["KNITBRAIN_HUB_PORT"] ?? 8791);
+        const host = process.env["KNITBRAIN_HUB_HOST"] ?? "127.0.0.1";
+        server.listen(port, host, () => {
+            console.log(`knitbrain hub → http://${host}:${port}`);
+            console.log(`team token: ${token}`);
+            console.log(`teammates join with:  knitbrain join http://<this-host>:${port} ${token} <name>`);
+            if (host === "127.0.0.1") {
+                console.log("(loopback only — set KNITBRAIN_HUB_HOST=0.0.0.0 to allow your team to reach it)");
+            }
+        });
+        return;
+    }
+    if (process.argv[2] === "join") {
+        const [url, token, member] = [process.argv[3], process.argv[4], process.argv[5] ?? "me"];
+        if (!url || !token) {
+            console.error("usage: knitbrain join <hub-url> <token> [member-name]");
+            process.exit(1);
+        }
+        const { saveHubConfig } = await import("./hub/client.js");
+        const path = saveHubConfig({ url, token, member });
+        console.log(`joined hub ${url} as "${member}" (config: ${path})`);
+        console.log("from now on, team_post mirrors to the hub automatically.");
+        process.exit(0);
+    }
+    if (process.argv[2] === "profile") {
+        const { runProfile } = await import("./profile.js");
+        await runProfile(process.argv.slice(3));
+        return;
+    }
+    if (process.argv[2] === "dashboard") {
+        const [{ createDashboardServer }, { createFileCCRStore }, { createKnowledge }, { createMemory }, { createFeedback }, { createSkillsStore }, { createTeamBoard }, { createMeter }, paths] = await Promise.all([
+            import("./dashboard.js"),
+            import("./ccr/store.js"),
+            import("./engine/knowledge.js"),
+            import("./engine/memory.js"),
+            import("./engine/feedback.js"),
+            import("./engine/skills.js"),
+            import("./engine/teams.js"),
+            import("./engine/meter.js"),
+            import("./paths.js"),
+        ]);
+        const ccr = createFileCCRStore(paths.ccrRoot());
+        const srv = createDashboardServer({
+            ccr,
+            memory: createMemory(paths.memoryRoot()),
+            feedback: createFeedback(paths.feedbackRoot()),
+            team: createTeamBoard(paths.teamRoot(), ccr),
+            meter: createMeter(paths.meterRoot()),
+            // Project scope: the directory the dashboard was started in.
+            knowledge: createKnowledge(process.cwd(), paths.knowledgeRoot()),
+            skills: createSkillsStore(paths.skillsRoot()),
+        });
+        const port = Number(process.env["KNITBRAIN_DASHBOARD_PORT"] ?? 8790);
+        srv.listen(port, "127.0.0.1", () => {
+            console.log(`knitbrain dashboard → http://127.0.0.1:${port}`);
+        });
+        return; // keep serving
+    }
+    const server = buildServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("[knitbrain] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mcp/tools.d.ts

@@ -0,0 +1,40 @@
+import type { CCRStore } from "../ccr/store.js";
+import type { Memory } from "../engine/memory.js";
+import type { Knowledge } from "../engine/knowledge.js";
+import type { Feedback } from "../engine/feedback.js";
+import type { TeamBoard } from "../engine/teams.js";
+import type { Meter } from "../engine/meter.js";
+import type { SkillsStore } from "../engine/skills.js";
+import type { Calibration } from "../engine/calibration.js";
+/** Runtime context handed to every tool. */
+export interface ToolContext {
+    ccr: CCRStore;
+    memory: Memory;
+    knowledge: Knowledge;
+    feedback: Feedback;
+    team: TeamBoard;
+    meter: Meter;
+    skills: SkillsStore;
+    calibration: Calibration;
+}
+/**
+ * Output discipline at the dispatch chokepoint:
+ *  - "data"     → auto-compressed (skeleton + ⟨ccr:hash⟩), original in CCR.
+ *  - "verbatim" → returned exactly as-is (governance/protocol/control output
+ *                 the agent must read literally — NEVER skeletonized).
+ */
+export type OutputKind = "data" | "verbatim";
+export interface ToolDef {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Record<string, unknown>;
+    readonly output: OutputKind;
+    run(args: Record<string, unknown>, ctx: ToolContext): string;
+}
+export declare const TOOLS: readonly ToolDef[];
+/**
+ * The ONE chokepoint: run a tool, then apply output discipline. Data outputs
+ * are compressed through the optimizer (original preserved in CCR); verbatim
+ * outputs pass through untouched.
+ */
+export declare function dispatch(tool: ToolDef, args: Record<string, unknown>, ctx: ToolContext): string;