fushiguro-mcp 0.1.0

package/dist/init.js

@@ -0,0 +1,159 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, relative, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const DIRS = [
+    "agents",
+    "skills",
+    "knowledge",
+    "runbooks",
+    "topics",
+    "tools",
+    "connectors",
+];
+const CATALOG_README = `# <Your business>'s Fushiguro catalog
+
+This directory is your organisation's AI operating layer. It layers over the
+catalog that ships with the server: an entry here with the same \`name\` as a
+packaged one **merges into it** — your scalar fields win, list fields union, and
+your body is appended. Nothing is forked, so you keep receiving improvements to
+the base prompts underneath your own additions.
+
+Commit this directory. It is a shared business asset, and it is the part that
+makes answers specific to you rather than generic.
+
+## Where to start
+
+1. **\`knowledge/\`** — highest leverage by a wide margin. Drop your real policy
+   and product documents into a folder per collection (\`knowledge/policies/\`,
+   \`knowledge/product/\`). Plain markdown; frontmatter is optional here.
+2. **\`connectors/\`** — describe the systems you actually use, and delete the
+   packaged ones you do not. Record env var **names**, never secret values.
+3. **\`runbooks/\`** — the packaged runbooks are templates. Copy
+   \`runbook-template.md\` and fill in one real process. Escalation is usually
+   the right first one.
+4. **\`agents/\`** — extend a packaged agent with your house rules, or add a role
+   the base set does not cover.
+
+Run the \`status\` tool at any time to see what is loaded and what is still an
+unfilled template.
+
+## Extending a packaged agent
+
+Create \`agents/customer-support.md\` with only what you are adding:
+
+\`\`\`markdown
+---
+name: customer-support
+model: opus
+keywords: [overage, seat, enterprise contract]
+connectors: [our-helpdesk]
+---
+
+## How we do this here
+
+Our plans are Starter, Pro, and Enterprise, and entitlement differs sharply
+between them. Always confirm the plan before quoting any policy window.
+\`\`\`
+
+Add \`override: true\` to the frontmatter to replace the packaged body outright
+instead of appending to it.
+
+## What does NOT go here
+
+Personal working preferences — how one person likes their code formatted, or
+their tone. Those are captured per-user through the \`remember\` tool and stored
+in that person's own memory database. This catalog is for rules that apply to
+everyone.
+`;
+const KNOWLEDGE_PLACEHOLDER = `---
+name: example-policy
+title: Example policy — replace this
+collection: policies
+reviewed: REPLACE-WITH-DATE
+---
+
+# Replace this file with a real policy document
+
+Everything in this directory is indexed and retrieved for agents to cite. This
+placeholder exists so retrieval has something to return before you have added
+anything real — delete it once you have.
+
+Knowledge files are ordinary markdown. Headings matter: they become the citation
+trail an agent shows when it uses a passage, so write headings that identify the
+rule rather than generic ones like "Overview".
+
+Good documents to add first, in rough order of value:
+
+- Refund, cancellation, and entitlement policy, per plan
+- Escalation and approval thresholds — who can authorise what
+- Product behaviour that support is repeatedly asked to explain
+- Brand voice and writing guidance
+- Metric definitions, so one metric keeps one meaning
+
+Aim for the document a new hire would need on their first week. If it is not
+written down anywhere, an agent cannot be told to follow it.
+`;
+/**
+ * Scaffolds a business's own catalog. Never overwrites an existing file, so it
+ * is safe to re-run after the server has been upgraded.
+ */
+export function init(targetArg) {
+    const catalogDir = resolve(targetArg ?? join(process.cwd(), ".fushiguro", "catalog"));
+    const results = [];
+    const write = (path, contents) => {
+        if (existsSync(path)) {
+            results.push({ path, status: "skipped" });
+            return;
+        }
+        mkdirSync(dirname(path), { recursive: true });
+        writeFileSync(path, contents);
+        results.push({ path, status: "created" });
+    };
+    for (const dir of DIRS)
+        mkdirSync(join(catalogDir, dir), { recursive: true });
+    mkdirSync(join(catalogDir, "knowledge", "policies"), { recursive: true });
+    write(join(catalogDir, "README.md"), CATALOG_README);
+    write(join(catalogDir, "knowledge", "policies", "example-policy.md"), KNOWLEDGE_PLACEHOLDER);
+    // Give them the runbook template locally, so filling one in needs no lookup.
+    // The copy gets its own name — sharing one with a packaged entry would merge
+    // the two rather than starting a new runbook.
+    const templateSource = join(packageRoot, "catalog", "runbooks", "_TEMPLATE.md");
+    if (existsSync(templateSource)) {
+        const template = readFileSync(templateSource, "utf8")
+            .replace(/^name: .*$/m, "name: my-first-runbook")
+            .replace(/^title: .*$/m, "title: My First Runbook — rename this")
+            .replace(/^description: .*$/m, "description: Replace this with what the process does. Rename the file and the name field to match.");
+        write(join(catalogDir, "runbooks", "my-first-runbook.md"), template);
+    }
+    const created = results.filter((r) => r.status === "created");
+    const skipped = results.filter((r) => r.status === "skipped");
+    const show = (p) => relative(process.cwd(), p) || p;
+    process.stdout.write(`\nCatalog ready at ${show(catalogDir)}\n\n`);
+    for (const r of created)
+        process.stdout.write(`  created  ${show(r.path)}\n`);
+    for (const r of skipped)
+        process.stdout.write(`  kept     ${show(r.path)} (already existed)\n`);
+    process.stdout.write([
+        "",
+        "Next:",
+        "",
+        "  1. Register the server so your whole team gets it from the repo:",
+        "",
+        "       claude mcp add fushiguro --scope project -- npx -y fushiguro-mcp",
+        "",
+        "     That writes .mcp.json. Commit it, and teammates are prompted to",
+        "     enable the server the next time they open the repo.",
+        "",
+        `  2. Put your real policy and product documents in ${show(join(catalogDir, "knowledge"))}/`,
+        "     That is the highest-leverage thing in the catalog by a wide margin.",
+        "",
+        "  3. Fill in one runbook, then set `template: false` in its frontmatter.",
+        "",
+        "  4. Commit the catalog. It is a shared business asset.",
+        "",
+        "Run the `status` tool once connected to see what loaded.",
+        "",
+    ].join("\n"));
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

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

package/dist/knowledge.d.ts

@@ -0,0 +1,31 @@
+import type { KnowledgeChunk } from "./types.js";
+export interface ChunkHit extends KnowledgeChunk {
+    /** Relevance, higher is better. Comparable within one search only. */
+    score: number;
+}
+/**
+ * Full-text index over the knowledge corpus. The whole index is rebuilt when the
+ * corpus hash changes — the corpus is small enough that incremental updates would
+ * cost more in complexity than they save in time.
+ */
+export declare class KnowledgeIndex {
+    #private;
+    constructor(dbPath: string);
+    close(): void;
+    /** Rebuilds the index if the corpus changed. Returns true when it rebuilt. */
+    sync(chunks: KnowledgeChunk[], signature: string): boolean;
+    /**
+     * Ranked chunk retrieval. `collections` narrows the corpus to what an agent is
+     * allowed to see; a heading hit counts for more than a body hit, since headings
+     * are the terms the author chose deliberately.
+     */
+    search(query: string, options?: {
+        collections?: string[];
+        docs?: string[];
+        limit?: number;
+    }): ChunkHit[];
+    stats(): {
+        chunks: number;
+        collections: Record<string, number>;
+    };
+}

package/dist/knowledge.js

@@ -0,0 +1,126 @@
+import { mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { ftsQuery } from "./text.js";
+/**
+ * Full-text index over the knowledge corpus. The whole index is rebuilt when the
+ * corpus hash changes — the corpus is small enough that incremental updates would
+ * cost more in complexity than they save in time.
+ */
+export class KnowledgeIndex {
+    #db;
+    constructor(dbPath) {
+        if (dbPath !== ":memory:")
+            mkdirSync(dirname(dbPath), { recursive: true });
+        this.#db = new DatabaseSync(dbPath);
+        this.#db.exec("PRAGMA journal_mode = WAL");
+        this.#db.exec(`
+      CREATE TABLE IF NOT EXISTS knowledge_meta (
+        key   TEXT PRIMARY KEY,
+        value TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS knowledge_chunks (
+        rowid_key  INTEGER PRIMARY KEY,
+        id         TEXT NOT NULL UNIQUE,
+        doc_name   TEXT NOT NULL,
+        collection TEXT NOT NULL,
+        heading    TEXT NOT NULL DEFAULT '',
+        text       TEXT NOT NULL,
+        idx        INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_chunks_collection ON knowledge_chunks(collection);
+
+      CREATE VIRTUAL TABLE IF NOT EXISTS knowledge_fts
+        USING fts5(text, heading, doc_name, tokenize = 'porter unicode61');
+    `);
+    }
+    close() {
+        this.#db.close();
+    }
+    #signature() {
+        const row = this.#db
+            .prepare("SELECT value FROM knowledge_meta WHERE key = 'signature'")
+            .get();
+        return row?.value ?? "";
+    }
+    /** Rebuilds the index if the corpus changed. Returns true when it rebuilt. */
+    sync(chunks, signature) {
+        if (signature === this.#signature())
+            return false;
+        this.#db.exec("BEGIN");
+        try {
+            this.#db.exec("DELETE FROM knowledge_chunks");
+            this.#db.exec("DELETE FROM knowledge_fts");
+            const insertChunk = this.#db.prepare(`INSERT INTO knowledge_chunks (id, doc_name, collection, heading, text, idx)
+         VALUES (?, ?, ?, ?, ?, ?)`);
+            const insertFts = this.#db.prepare("INSERT INTO knowledge_fts (rowid, text, heading, doc_name) VALUES (?, ?, ?, ?)");
+            for (const chunk of chunks) {
+                const result = insertChunk.run(chunk.id, chunk.docName, chunk.collection, chunk.heading, chunk.text, chunk.index);
+                insertFts.run(Number(result.lastInsertRowid), chunk.text, chunk.heading, chunk.docName);
+            }
+            this.#db
+                .prepare(`INSERT INTO knowledge_meta (key, value) VALUES ('signature', ?)
+           ON CONFLICT(key) DO UPDATE SET value = excluded.value`)
+                .run(signature);
+            this.#db.exec("COMMIT");
+        }
+        catch (err) {
+            this.#db.exec("ROLLBACK");
+            throw err;
+        }
+        return true;
+    }
+    /**
+     * Ranked chunk retrieval. `collections` narrows the corpus to what an agent is
+     * allowed to see; a heading hit counts for more than a body hit, since headings
+     * are the terms the author chose deliberately.
+     */
+    search(query, options = {}) {
+        const match = ftsQuery(query);
+        if (!match)
+            return [];
+        const limit = Math.min(50, Math.max(1, options.limit ?? 6));
+        const clauses = ["knowledge_fts MATCH ?"];
+        const params = [match];
+        if (options.collections?.length) {
+            clauses.push(`c.collection IN (${options.collections.map(() => "?").join(", ")})`);
+            params.push(...options.collections);
+        }
+        if (options.docs?.length) {
+            clauses.push(`c.doc_name IN (${options.docs.map(() => "?").join(", ")})`);
+            params.push(...options.docs);
+        }
+        params.push(limit);
+        const rows = this.#db
+            .prepare(`SELECT c.id, c.doc_name, c.collection, c.heading, c.text, c.idx,
+                -bm25(knowledge_fts, 1.0, 2.0, 1.0) AS score
+           FROM knowledge_fts f
+           JOIN knowledge_chunks c ON c.rowid_key = f.rowid
+          WHERE ${clauses.join(" AND ")}
+          ORDER BY score DESC
+          LIMIT ?`)
+            .all(...params);
+        return rows.map((row) => ({
+            id: row.id,
+            docName: row.doc_name,
+            collection: row.collection,
+            heading: row.heading,
+            text: row.text,
+            index: row.idx,
+            score: Number(row.score.toFixed(3)),
+        }));
+    }
+    stats() {
+        const total = Number(this.#db.prepare("SELECT COUNT(*) AS n FROM knowledge_chunks").get().n);
+        const collections = {};
+        for (const row of this.#db
+            .prepare("SELECT collection, COUNT(*) AS n FROM knowledge_chunks GROUP BY collection")
+            .all()) {
+            collections[row.collection] = Number(row.n);
+        }
+        return { chunks: total, collections };
+    }
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/knowledge.js.map

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

package/dist/main.d.ts

@@ -0,0 +1 @@
+export declare function main(): Promise<void>;

package/dist/main.js

@@ -0,0 +1,22 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadConfig } from "./config.js";
+import { createServer } from "./server.js";
+export async function main() {
+    const config = loadConfig();
+    const { server, close } = createServer(config);
+    const shutdown = async () => {
+        try {
+            await server.close();
+        }
+        finally {
+            close();
+        }
+        process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    await server.connect(new StdioServerTransport());
+    // stdout carries the protocol; anything human-readable must go to stderr.
+    process.stderr.write(`fushiguro-mcp ready — base: ${config.baseCatalogDir}, custom: ${config.customCatalogDir}, memory: ${config.dbPath}\n`);
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAE/C,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,KAAK,EAAE,CAAC;QACV,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,0EAA0E;IAC1E,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+BAA+B,MAAM,CAAC,cAAc,aAAa,MAAM,CAAC,gBAAgB,aAAa,MAAM,CAAC,MAAM,IAAI,CACvH,CAAC;AACJ,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,85 @@
+import type { Memory, MemoryKind, Outcome } from "./types.js";
+export interface RememberInput {
+    text: string;
+    kind: MemoryKind;
+    scope: string;
+    agent: string | null;
+    why?: string | null;
+    confidence?: number;
+    source?: string | null;
+}
+export interface RememberResult {
+    id: number;
+    action: "created" | "reinforced" | "superseded";
+    /** Set when this write retired an older memory. */
+    supersededId?: number;
+    memory: Memory;
+}
+export interface RecallOptions {
+    query?: string;
+    /** Include memories for this specialist plus the agent-agnostic ones. */
+    agent?: string | null;
+    /** Scopes to search. Later entries do not outrank earlier ones. */
+    scopes?: string[];
+    limit?: number;
+}
+export declare class MemoryStore {
+    #private;
+    constructor(dbPath: string);
+    close(): void;
+    /**
+     * Writes a preference, folding it into an existing one when it says the same
+     * thing. Restating a preference reinforces it; a constraint or correction that
+     * restates a softer memory retires that memory instead of duplicating it.
+     */
+    remember(input: RememberInput): RememberResult;
+    /**
+     * Ranked recall. Relevance comes from BM25 when there is a query, then gets
+     * scaled by kind weight and confidence so a hard constraint beats a passing
+     * remark even when the remark matches the words better.
+     *
+     * Constraints and corrections are also pulled in unconditionally, whether or
+     * not they match the query. A rule like "never use purple" that only surfaces
+     * when the user happens to say "purple" is not a rule — it has to be in front
+     * of the agent on the task where it would otherwise be broken.
+     */
+    recall(options?: RecallOptions): Memory[];
+    /** Marks memories as used, so `memory_stats` can show what actually earns its keep. */
+    markUsed(ids: number[]): void;
+    get(id: number): Memory | null;
+    forget(id: number): boolean;
+    list(options?: {
+        agent?: string | null;
+        scope?: string;
+        limit?: number;
+    }): Memory[];
+    /**
+     * Records how a routing decision landed and nudges the term→agent affinity
+     * that the router consults next time. This is the loop that makes routing
+     * improve with use rather than staying frozen at whatever the keywords say.
+     */
+    recordOutcome(input: {
+        task: string;
+        agent: string;
+        outcome: Outcome;
+        notes?: string | null;
+        correctAgent?: string | null;
+    }): {
+        decisionId: number;
+        adjusted: number;
+    };
+    /** Learned per-agent weight for the given terms, summed. */
+    affinity(terms: string[]): Map<string, number>;
+    stats(): {
+        total: number;
+        byKind: Record<string, number>;
+        byAgent: Record<string, number>;
+        superseded: number;
+        decisions: number;
+        topUsed: {
+            id: number;
+            text: string;
+            hits: number;
+        }[];
+    };
+}