fushiguro-mcp 0.1.0

package/dist/text.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,195 @@
+/** Shapes shared across the catalog, router, knowledge index, and memory store. */
+/** The kinds of entity the catalog holds. Every one is a markdown file with frontmatter. */
+export type EntityKind = "agent" | "skill" | "knowledge" | "runbook" | "topic" | "tool" | "connector";
+/**
+ * Where an entity came from. `base` ships with the package, `custom` is the
+ * business's own, and `base+custom` is a base entity a custom file extended —
+ * custom scalars win, list fields union, and the custom body is appended.
+ */
+export type Layer = "base" | "custom" | "base+custom";
+/** Fields every catalog entity carries, whatever its kind. */
+export interface EntityBase {
+    kind: EntityKind;
+    layer: Layer;
+    /** Stable kebab-case slug. Unique within a kind; custom overrides base. */
+    name: string;
+    title: string;
+    description: string;
+    /** IDF-weighted routing signal. */
+    keywords: string[];
+    /** Example phrasings, matched by token overlap. */
+    triggers: string[];
+    /** Hand-written regexes — the strongest routing signal. */
+    patterns: RegExp[];
+    /** Business domains this belongs to, by topic slug. */
+    topics: string[];
+    tags: string[];
+    /** Everything below the frontmatter. */
+    body: string;
+    file: string;
+    /** Raw frontmatter, for kind-specific fields the loader did not claim. */
+    meta: Record<string, unknown>;
+}
+/** A specialist agent: a system prompt plus what it is allowed and expected to use. */
+export interface Agent extends EntityBase {
+    kind: "agent";
+    /** Model hint for the host, e.g. "opus" | "sonnet" | "haiku". */
+    model?: string;
+    /** Host tool names the subagent should be given. */
+    tools: string[];
+    /** Skill slugs always attached to this agent, regardless of the task. */
+    skills: string[];
+    /** Connector slugs this agent is expected to reach. */
+    connectors: string[];
+    /** Runbook slugs this agent should follow when they apply. */
+    runbooks: string[];
+    /** Knowledge collection prefixes this agent may draw on. Empty = all. */
+    knowledge: string[];
+}
+/** A reusable procedure injected into an agent's prompt when it is relevant. */
+export interface Skill extends EntityBase {
+    kind: "skill";
+    /** Agent slugs this skill may attach to. Empty means any agent. */
+    appliesTo: string[];
+    /** Always attach when the agent matches, without needing a keyword hit. */
+    always: boolean;
+}
+/** One source document in the RAG corpus, split into retrievable chunks. */
+export interface KnowledgeDoc extends EntityBase {
+    kind: "knowledge";
+    /** Folder path under knowledge/, used to scope retrieval per agent. */
+    collection: string;
+    /** Where the content came from, for citation. */
+    sourceUrl?: string;
+    /** ISO date the content was last verified by a human. */
+    reviewed?: string;
+    chunks: KnowledgeChunk[];
+    /** Content hash, so re-indexing only happens when the file really changed. */
+    hash: string;
+}
+export interface KnowledgeChunk {
+    /** `${docName}#${index}` — stable enough to cite. */
+    id: string;
+    docName: string;
+    collection: string;
+    /** Heading trail, e.g. "Refund policy > Exceptions". */
+    heading: string;
+    text: string;
+    index: number;
+}
+/**
+ * A team or project process guide: an ordered set of steps plus the context
+ * needed to run them. The packaged runbooks are templates — each business
+ * completes its own owners, thresholds, and escalation paths after setup.
+ */
+export interface Runbook extends EntityBase {
+    kind: "runbook";
+    /** True while this is still an unfilled template rather than agreed process. */
+    template: boolean;
+    /** Count of remaining `[FILL: ...]` markers in the body. */
+    placeholders: number;
+    /** Table of contents, derived from the body's headings. */
+    toc: RunbookSection[];
+    steps: string[];
+    /** Agent slugs qualified to execute this. */
+    agents: string[];
+    /** Knowledge doc slugs this procedure depends on. */
+    knowledge: string[];
+    connectors: string[];
+    owner?: string;
+    /** How long the whole procedure is expected to take. */
+    sla?: string;
+    /** Conditions under which a human must approve before continuing. */
+    escalation?: string;
+}
+export interface RunbookSection {
+    level: number;
+    title: string;
+    /** Line offset in the body, so a caller can slice just this section. */
+    line: number;
+}
+/** A business domain that ties agents, skills, knowledge, and runbooks together. */
+export interface Topic extends EntityBase {
+    kind: "topic";
+    agents: string[];
+    skills: string[];
+    runbooks: string[];
+    connectors: string[];
+    knowledge: string[];
+}
+/** A capability the host can execute, described so an agent knows when to reach for it. */
+export interface ToolDef extends EntityBase {
+    kind: "tool";
+    /** The name the host actually exposes, e.g. "Bash" or "mcp__stripe__create_refund". */
+    hostTool: string;
+    /** One line on when this is the right tool. */
+    when: string;
+    /** True when a human should confirm before it runs. */
+    requiresApproval: boolean;
+}
+/** An external system, described declaratively. Never holds a secret value. */
+export interface Connector extends EntityBase {
+    kind: "connector";
+    /** e.g. "mcp" | "rest" | "database" | "saas". */
+    connectorKind: string;
+    /** e.g. "oauth" | "api-key" | "none". */
+    auth: string;
+    /** Names of env vars that must be set. Names only — never values. */
+    env: string[];
+    /** What this connector can do, in plain language. */
+    capabilities: string[];
+    /** Operations that must never be performed automatically. */
+    guardrails: string[];
+    baseUrl?: string;
+    status: "available" | "planned" | "deprecated";
+}
+export type Entity = Agent | Skill | KnowledgeDoc | Runbook | Topic | ToolDef | Connector;
+export type MemoryKind = "preference" | "constraint" | "correction" | "style" | "fact";
+export interface Memory {
+    id: number;
+    scope: string;
+    /** Agent slug this applies to, or null for "all agents". */
+    agent: string | null;
+    kind: MemoryKind;
+    text: string;
+    /** The reason behind it, carried into the briefing. */
+    why: string | null;
+    confidence: number;
+    source: string | null;
+    createdAt: string;
+    updatedAt: string;
+    hits: number;
+    supersededBy: number | null;
+}
+export type Outcome = "accepted" | "revised" | "rejected" | "wrong_agent";
+export interface RouteCandidate {
+    name: string;
+    title: string;
+    description: string;
+    /** Normalised 0..1 — a comparable strength, not a probability. */
+    score: number;
+    why: string[];
+}
+export interface RouteResult {
+    chosen: RouteCandidate | null;
+    confidence: number;
+    /** True when the top two are too close to call. */
+    ambiguous: boolean;
+    alternatives: RouteCandidate[];
+}
+/** Everything the host needs to spawn one specialist subagent for one task. */
+export interface Briefing {
+    agent: Agent;
+    route: RouteResult;
+    topics: Topic[];
+    skills: Skill[];
+    runbooks: Runbook[];
+    knowledge: (KnowledgeChunk & {
+        score: number;
+    })[];
+    tools: ToolDef[];
+    connectors: Connector[];
+    memories: Memory[];
+    /** The assembled system prompt, ready to hand to a subagent verbatim. */
+    systemPrompt: string;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Shapes shared across the catalog, router, knowledge index, and memory store. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mFAAmF"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "fushiguro-mcp",
+  "version": "0.1.0",
+  "description": "MCP server that routes tasks to predefined specialist agents and remembers your preferences.",
+  "type": "module",
+  "bin": {
+    "fushiguro-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "catalog",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.5.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "npm run build && node --disable-warning=ExperimentalWarning test/smoke.mjs",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "yaml": "^2.9.0",
+    "zod": "^4.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.7.0"
+  },
+  "license": "MIT",
+  "author": "Carlo Jacalan <carlojacalan1@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omgcarlo/fushiguro-mcp.git"
+  },
+  "homepage": "https://github.com/omgcarlo/fushiguro-mcp#readme",
+  "bugs": {
+    "url": "https://github.com/omgcarlo/fushiguro-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "agents",
+    "subagents",
+    "rag",
+    "knowledge-base",
+    "memory",
+    "claude",
+    "ai-adoption",
+    "runbooks"
+  ]
+}