@4da/mcp-server 3.2.0 → 4.1.0

package/dist/project-scanner.js

@@ -0,0 +1,366 @@
+// SPDX-License-Identifier: FSL-1.1-Apache-2.0
+/**
+ * Project Scanner for MCP Standalone Mode
+ *
+ * Lightweight project scanner that detects languages, frameworks,
+ * dependencies, and topics from the current working directory.
+ * Runs on startup when no existing 4DA database is found.
+ *
+ * Design goals:
+ * - Fast (<2 seconds) — only checks immediate directory
+ * - No recursion — reads manifest files at project root
+ * - No dependencies — uses only Node.js built-ins
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+// =============================================================================
+// Framework Detection Maps
+// =============================================================================
+/** npm package name -> framework label */
+const NPM_FRAMEWORK_MAP = {
+    react: "react",
+    "react-dom": "react",
+    vue: "vue",
+    next: "next.js",
+    nuxt: "nuxt",
+    "@angular/core": "angular",
+    svelte: "svelte",
+    "@sveltejs/kit": "sveltekit",
+    astro: "astro",
+    remix: "remix",
+    express: "express",
+    fastify: "fastify",
+    hono: "hono",
+    elysia: "elysia",
+    "react-native": "react-native",
+    expo: "expo",
+    electron: "electron",
+    tauri: "tauri",
+    "@tauri-apps/api": "tauri",
+    "@tauri-apps/cli": "tauri",
+};
+/** npm devDependency name -> language/tool */
+const NPM_DEVTOOL_MAP = {
+    typescript: "typescript",
+    vite: "vite",
+    vitest: "vitest",
+    jest: "jest",
+    webpack: "webpack",
+    esbuild: "esbuild",
+    rollup: "rollup",
+    tailwindcss: "tailwind",
+    "@tailwindcss/vite": "tailwind",
+    prisma: "prisma",
+    drizzle: "drizzle",
+};
+/** Rust crate name -> framework label */
+const RUST_FRAMEWORK_MAP = {
+    tauri: "tauri",
+    "tauri-build": "tauri",
+    actix: "actix",
+    "actix-web": "actix",
+    axum: "axum",
+    rocket: "rocket",
+    warp: "warp",
+    tokio: "tokio",
+    serde: "serde",
+    diesel: "diesel",
+    sqlx: "sqlx",
+    rusqlite: "sqlite",
+    reqwest: "reqwest",
+    tonic: "grpc",
+    leptos: "leptos",
+    yew: "yew",
+    dioxus: "dioxus",
+};
+// =============================================================================
+// Scanner
+// =============================================================================
+/**
+ * Scan a directory for project context.
+ * Only reads manifest files at the root level — no recursion.
+ */
+export function scanCurrentProject(cwd) {
+    const result = {
+        languages: [],
+        frameworks: [],
+        dependencies: [],
+        devDependencies: [],
+        topics: [],
+        projectName: path.basename(cwd),
+        projectPath: cwd,
+    };
+    const langSet = new Set();
+    const fwSet = new Set();
+    // -------------------------------------------------------------------------
+    // 1. package.json (JavaScript / TypeScript ecosystem)
+    // -------------------------------------------------------------------------
+    const pkgPath = path.join(cwd, "package.json");
+    if (fs.existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+            langSet.add("javascript");
+            if (pkg.name) {
+                result.projectName = pkg.name;
+            }
+            // Production dependencies
+            if (pkg.dependencies && typeof pkg.dependencies === "object") {
+                const depNames = Object.keys(pkg.dependencies);
+                result.dependencies.push(...depNames);
+                for (const dep of depNames) {
+                    if (dep in NPM_FRAMEWORK_MAP) {
+                        fwSet.add(NPM_FRAMEWORK_MAP[dep]);
+                    }
+                }
+            }
+            // Dev dependencies
+            if (pkg.devDependencies && typeof pkg.devDependencies === "object") {
+                const devDepNames = Object.keys(pkg.devDependencies);
+                result.devDependencies.push(...devDepNames);
+                for (const dep of devDepNames) {
+                    if (dep in NPM_DEVTOOL_MAP) {
+                        const tool = NPM_DEVTOOL_MAP[dep];
+                        if (tool === "typescript") {
+                            langSet.add("typescript");
+                        }
+                        else {
+                            fwSet.add(tool);
+                        }
+                    }
+                    // Also check frameworks in devDependencies (common for meta-frameworks)
+                    if (dep in NPM_FRAMEWORK_MAP) {
+                        fwSet.add(NPM_FRAMEWORK_MAP[dep]);
+                    }
+                }
+            }
+        }
+        catch {
+            // Malformed package.json — skip
+        }
+    }
+    // -------------------------------------------------------------------------
+    // 2. Cargo.toml (Rust ecosystem)
+    // -------------------------------------------------------------------------
+    const cargoPath = path.join(cwd, "Cargo.toml");
+    if (fs.existsSync(cargoPath)) {
+        try {
+            const content = fs.readFileSync(cargoPath, "utf-8");
+            langSet.add("rust");
+            // Extract project name from [package] section
+            const nameMatch = content.match(/^\[package\]\s*\n(?:.*\n)*?name\s*=\s*"([^"]+)"/m);
+            if (nameMatch) {
+                result.projectName = nameMatch[1];
+            }
+            // Parse [dependencies] and [dev-dependencies] sections
+            parseTOMLDependencies(content, "[dependencies]", result.dependencies, fwSet, RUST_FRAMEWORK_MAP);
+            parseTOMLDependencies(content, "[dev-dependencies]", result.devDependencies, fwSet, RUST_FRAMEWORK_MAP);
+            parseTOMLDependencies(content, "[build-dependencies]", result.devDependencies, fwSet, RUST_FRAMEWORK_MAP);
+        }
+        catch {
+            // Malformed Cargo.toml — skip
+        }
+    }
+    // -------------------------------------------------------------------------
+    // 3. pyproject.toml / requirements.txt (Python ecosystem)
+    // -------------------------------------------------------------------------
+    const pyprojectPath = path.join(cwd, "pyproject.toml");
+    const requirementsPath = path.join(cwd, "requirements.txt");
+    const setupPyPath = path.join(cwd, "setup.py");
+    if (fs.existsSync(pyprojectPath)) {
+        langSet.add("python");
+        try {
+            const content = fs.readFileSync(pyprojectPath, "utf-8");
+            // Extract dependencies from pyproject.toml
+            const depsMatch = content.match(/dependencies\s*=\s*\[([\s\S]*?)\]/);
+            if (depsMatch) {
+                const deps = depsMatch[1].match(/"([^">=<!\s]+)/g);
+                if (deps) {
+                    for (const dep of deps) {
+                        const name = dep.replace(/^"/, "");
+                        result.dependencies.push(name);
+                        detectPythonFramework(name, fwSet);
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip
+        }
+    }
+    else if (fs.existsSync(requirementsPath)) {
+        langSet.add("python");
+        try {
+            const content = fs.readFileSync(requirementsPath, "utf-8");
+            for (const line of content.split("\n")) {
+                const trimmed = line.trim();
+                if (trimmed && !trimmed.startsWith("#") && !trimmed.startsWith("-")) {
+                    const name = trimmed.split(/[>=<!\[]/)[0].trim();
+                    if (name) {
+                        result.dependencies.push(name);
+                        detectPythonFramework(name, fwSet);
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip
+        }
+    }
+    else if (fs.existsSync(setupPyPath)) {
+        langSet.add("python");
+    }
+    // -------------------------------------------------------------------------
+    // 4. go.mod (Go ecosystem)
+    // -------------------------------------------------------------------------
+    const goModPath = path.join(cwd, "go.mod");
+    if (fs.existsSync(goModPath)) {
+        langSet.add("go");
+        try {
+            const content = fs.readFileSync(goModPath, "utf-8");
+            // Extract module name
+            const moduleMatch = content.match(/^module\s+(\S+)/m);
+            if (moduleMatch) {
+                const parts = moduleMatch[1].split("/");
+                result.projectName = parts[parts.length - 1];
+            }
+            // Extract require block dependencies
+            const requireMatch = content.match(/require\s*\(([\s\S]*?)\)/);
+            if (requireMatch) {
+                for (const line of requireMatch[1].split("\n")) {
+                    const depMatch = line.trim().match(/^(\S+)\s+/);
+                    if (depMatch && !depMatch[1].startsWith("//")) {
+                        const dep = depMatch[1];
+                        result.dependencies.push(dep);
+                        detectGoFramework(dep, fwSet);
+                    }
+                }
+            }
+        }
+        catch {
+            // Skip
+        }
+    }
+    // -------------------------------------------------------------------------
+    // 5. tsconfig.json presence (confirms TypeScript even without package.json)
+    // -------------------------------------------------------------------------
+    if (fs.existsSync(path.join(cwd, "tsconfig.json"))) {
+        langSet.add("typescript");
+    }
+    // -------------------------------------------------------------------------
+    // 6. Dockerfile / docker-compose.yml (container detection)
+    // -------------------------------------------------------------------------
+    if (fs.existsSync(path.join(cwd, "Dockerfile")) ||
+        fs.existsSync(path.join(cwd, "docker-compose.yml")) ||
+        fs.existsSync(path.join(cwd, "docker-compose.yaml"))) {
+        fwSet.add("docker");
+    }
+    // -------------------------------------------------------------------------
+    // Finalize
+    // -------------------------------------------------------------------------
+    result.languages = [...langSet];
+    result.frameworks = [...fwSet];
+    // Deduplicate dependencies
+    result.dependencies = [...new Set(result.dependencies)];
+    result.devDependencies = [...new Set(result.devDependencies)];
+    // Generate topics from detected stack
+    result.topics = [
+        ...new Set([
+            ...result.languages,
+            ...result.frameworks,
+            // Add high-signal dependency names as topics (only well-known ones)
+            ...result.dependencies.filter(isNotableTopic),
+        ]),
+    ];
+    return result;
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Parse a TOML section for dependency names.
+ * Simple line-by-line parsing — handles `name = "version"` and `name = { ... }` forms.
+ */
+function parseTOMLDependencies(content, sectionHeader, target, frameworkSet, frameworkMap) {
+    const headerIndex = content.indexOf(sectionHeader);
+    if (headerIndex === -1)
+        return;
+    const afterHeader = content.substring(headerIndex + sectionHeader.length);
+    for (const line of afterHeader.split("\n")) {
+        const trimmed = line.trim();
+        // Stop at next section
+        if (trimmed.startsWith("[") && trimmed !== sectionHeader)
+            break;
+        // Skip empty lines and comments
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        // Match dependency line: `name = ...`
+        const depMatch = trimmed.match(/^([a-zA-Z_][\w-]*)\s*=/);
+        if (depMatch) {
+            const name = depMatch[1];
+            target.push(name);
+            if (name in frameworkMap) {
+                frameworkSet.add(frameworkMap[name]);
+            }
+        }
+    }
+}
+/** Detect Python framework from package name */
+function detectPythonFramework(name, fwSet) {
+    const pythonFrameworks = {
+        django: "django",
+        flask: "flask",
+        fastapi: "fastapi",
+        starlette: "starlette",
+        uvicorn: "uvicorn",
+        celery: "celery",
+        sqlalchemy: "sqlalchemy",
+        pytorch: "pytorch",
+        torch: "pytorch",
+        tensorflow: "tensorflow",
+        numpy: "numpy",
+        pandas: "pandas",
+        streamlit: "streamlit",
+    };
+    if (name in pythonFrameworks) {
+        fwSet.add(pythonFrameworks[name]);
+    }
+}
+/** Detect Go framework from module path */
+function detectGoFramework(dep, fwSet) {
+    if (dep.includes("gin-gonic"))
+        fwSet.add("gin");
+    if (dep.includes("gorilla/mux"))
+        fwSet.add("gorilla");
+    if (dep.includes("labstack/echo"))
+        fwSet.add("echo");
+    if (dep.includes("gofiber/fiber"))
+        fwSet.add("fiber");
+    if (dep.includes("grpc"))
+        fwSet.add("grpc");
+}
+/**
+ * Filter for well-known packages worth adding as topics.
+ * Avoids noise from utility packages.
+ */
+function isNotableTopic(name) {
+    const notable = new Set([
+        // Databases
+        "sqlite3", "better-sqlite3", "pg", "mysql2", "mongodb", "mongoose", "redis",
+        "prisma", "drizzle-orm", "typeorm", "sequelize", "knex",
+        // Auth
+        "passport", "next-auth", "lucia", "clerk",
+        // APIs
+        "graphql", "trpc", "@trpc/server", "openapi",
+        // AI/ML
+        "openai", "@anthropic-ai/sdk", "langchain", "llamaindex",
+        // Testing
+        "vitest", "jest", "mocha", "playwright", "cypress",
+        // Infrastructure
+        "docker", "kubernetes",
+        // Notable Rust crates
+        "serde", "tokio", "axum", "actix-web", "sqlx", "diesel",
+        "reqwest", "rusqlite", "clap", "tracing",
+    ]);
+    return notable.has(name);
+}
+//# sourceMappingURL=project-scanner.js.map

package/dist/project-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scanner.js","sourceRoot":"","sources":["../src/project-scanner.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAgBlC,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,0CAA0C;AAC1C,MAAM,iBAAiB,GAA2B;IAChD,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,OAAO;IACpB,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,eAAe,EAAE,SAAS;IAC1B,MAAM,EAAE,QAAQ;IAChB,eAAe,EAAE,WAAW;IAC5B,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,cAAc;IAC9B,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,iBAAiB,EAAE,OAAO;IAC1B,iBAAiB,EAAE,OAAO;CAC3B,CAAC;AAEF,8CAA8C;AAC9C,MAAM,eAAe,GAA2B;IAC9C,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,UAAU;IACvB,mBAAmB,EAAE,UAAU;IAC/B,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,yCAAyC;AACzC,MAAM,kBAAkB,GAA2B;IACjD,KAAK,EAAE,OAAO;IACd,aAAa,EAAE,OAAO;IACtB,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,OAAO;IACpB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,QAAQ;IAClB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,MAAM,MAAM,GAAsB;QAChC,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,EAAE;QACd,YAAY,EAAE,EAAE;QAChB,eAAe,EAAE,EAAE;QACnB,MAAM,EAAE,EAAE;QACV,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC/B,WAAW,EAAE,GAAG;KACjB,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,4EAA4E;IAC5E,sDAAsD;IACtD,4EAA4E;IAC5E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAE1B,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACb,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;YAChC,CAAC;YAED,0BAA0B;YAC1B,IAAI,GAAG,CAAC,YAAY,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;gBAC7D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;gBAC/C,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;gBAEtC,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;oBAC3B,IAAI,GAAG,IAAI,iBAAiB,EAAE,CAAC;wBAC7B,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;YACH,CAAC;YAED,mBAAmB;YACnB,IAAI,GAAG,CAAC,eAAe,IAAI,OAAO,GAAG,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;gBACnE,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;gBACrD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;gBAE5C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;oBAC9B,IAAI,GAAG,IAAI,eAAe,EAAE,CAAC;wBAC3B,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;wBAClC,IAAI,IAAI,KAAK,YAAY,EAAE,CAAC;4BAC1B,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;wBAC5B,CAAC;6BAAM,CAAC;4BACN,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;wBAClB,CAAC;oBACH,CAAC;oBACD,wEAAwE;oBACxE,IAAI,GAAG,IAAI,iBAAiB,EAAE,CAAC;wBAC7B,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;oBACpC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,iCAAiC;IACjC,4EAA4E;IAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAEpB,8CAA8C;YAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;YACpF,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACpC,CAAC;YAED,uDAAuD;YACvD,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;YACjG,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;YACxG,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,EAAE,MAAM,CAAC,eAAe,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC;QAC5G,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,0DAA0D;IAC1D,4EAA4E;IAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IACvD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAE/C,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YACxD,2CAA2C;YAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACrE,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;gBACnD,IAAI,IAAI,EAAE,CAAC;oBACT,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;wBACvB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;wBACnC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC/B,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;SAAM,IAAI,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YAC3D,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACjD,IAAI,IAAI,EAAE,CAAC;wBACT,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBAC/B,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;SAAM,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IAED,4EAA4E;IAC5E,2BAA2B;IAC3B,4EAA4E;IAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACpD,sBAAsB;YACtB,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACtD,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBACxC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC/C,CAAC;YACD,qCAAqC;YACrC,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC/D,IAAI,YAAY,EAAE,CAAC;gBACjB,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;oBAChD,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;wBAC9C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;wBACxB,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBAC9B,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,4EAA4E;IAC5E,4EAA4E;IAC5E,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC5B,CAAC;IAED,4EAA4E;IAC5E,2DAA2D;IAC3D,4EAA4E;IAC5E,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC3C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACnD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC,EACpD,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,4EAA4E;IAC5E,WAAW;IACX,4EAA4E;IAC5E,MAAM,CAAC,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,UAAU,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE/B,2BAA2B;IAC3B,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACxD,MAAM,CAAC,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;IAE9D,sCAAsC;IACtC,MAAM,CAAC,MAAM,GAAG;QACd,GAAG,IAAI,GAAG,CAAC;YACT,GAAG,MAAM,CAAC,SAAS;YACnB,GAAG,MAAM,CAAC,UAAU;YACpB,oEAAoE;YACpE,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,cAAc,CAAC;SAC9C,CAAC;KACH,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,OAAe,EACf,aAAqB,EACrB,MAAgB,EAChB,YAAyB,EACzB,YAAoC;IAEpC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACnD,IAAI,WAAW,KAAK,CAAC,CAAC;QAAE,OAAO;IAE/B,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC1E,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,uBAAuB;QACvB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,aAAa;YAAE,MAAM;QAChE,gCAAgC;QAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAClD,sCAAsC;QACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACzD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClB,IAAI,IAAI,IAAI,YAAY,EAAE,CAAC;gBACzB,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,SAAS,qBAAqB,CAAC,IAAY,EAAE,KAAkB;IAC7D,MAAM,gBAAgB,GAA2B;QAC/C,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,WAAW;QACtB,OAAO,EAAE,SAAS;QAClB,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,YAAY;QACxB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,YAAY;QACxB,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,WAAW;KACvB,CAAC;IACF,IAAI,IAAI,IAAI,gBAAgB,EAAE,CAAC;QAC7B,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,2CAA2C;AAC3C,SAAS,iBAAiB,CAAC,GAAW,EAAE,KAAkB;IACxD,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtD,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,IAAI,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;QACtB,YAAY;QACZ,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO;QAC3E,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM;QACvD,OAAO;QACP,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO;QACzC,OAAO;QACP,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS;QAC5C,QAAQ;QACR,QAAQ,EAAE,mBAAmB,EAAE,WAAW,EAAE,YAAY;QACxD,UAAU;QACV,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS;QAClD,iBAAiB;QACjB,QAAQ,EAAE,YAAY;QACtB,sBAAsB;QACtB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ;QACvD,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS;KACzC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/schema-registry.d.ts

@@ -5,19 +5,28 @@
  * - Returning only one-liner summaries in list_tools
  * - Storing full schemas as MCP Resources (lazy-loaded)
  *
+ * Also provides category/tag metadata for tool discovery and filtering.
+ *
  * Full schemas available at: 4da://schema/{tool_name}
+ * Category manifest at: 4da://categories
  */
-/**
- * Slim tool registry - one-liner descriptions only
- * Full schemas are stored in schemas/*.json and exposed as MCP Resources
- */
-export declare const TOOL_REGISTRY: Record<string, {
+/** Tool categories — maps to the 8 functional groupings in the MCP server */
+export type ToolCategory = "core" | "intelligence" | "diagnostic" | "knowledge" | "decisions" | "agent" | "identity" | "metabolism";
+/** Shape of each entry in the tool registry */
+export interface ToolRegistryEntry {
     summary: string;
     schemaFile: string;
-}>;
+    category: ToolCategory;
+    tags: string[];
+}
+/**
+ * Slim tool registry — one-liner descriptions + category/tag metadata.
+ * Full schemas are stored in schemas/*.json and exposed as MCP Resources.
+ */
+export declare const TOOL_REGISTRY: Record<string, ToolRegistryEntry>;
 /**
  * Get slim tool list for list_tools response
- * Returns minimal schema (just type: object) - full schema via resources
+ * Returns minimal schema (just type: object) — full schema via resources
  */
 export declare function getSlimToolList(): Array<{
     name: string;
@@ -35,12 +44,21 @@ export declare function getSchemaResources(): Array<{
     description: string;
     mimeType: string;
 }>;
-/**
- * Check if a tool exists
- */
+/** Check if a tool exists */
 export declare function hasToolSchema(toolName: string): boolean;
-/**
- * Get schema filename for a tool
- */
+/** Get schema filename for a tool */
 export declare function getSchemaFilename(toolName: string): string | null;
+/** Get tool names grouped by category */
+export declare function getToolsByCategory(): Record<ToolCategory, string[]>;
+/** Structured category manifest for the 4da://categories resource */
+export declare function getCategoryManifest(): {
+    version: string;
+    total_tools: number;
+    categories: Record<ToolCategory, {
+        tools: string[];
+        count: number;
+    }>;
+};
+/** Find tools matching any of the given tags */
+export declare function getToolsByTags(tags: string[]): string[];
 //# sourceMappingURL=schema-registry.d.ts.map

package/dist/schema-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../src/schema-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAsFjF,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;CACjC,CAAC,CAMD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAOD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE"}
+{"version":3,"file":"schema-registry.d.ts","sourceRoot":"","sources":["../src/schema-registry.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAEH,6EAA6E;AAC7E,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,cAAc,GACd,YAAY,GACZ,WAAW,GACX,WAAW,GACX,OAAO,GACP,UAAU,GACV,YAAY,CAAC;AAEjB,+CAA+C;AAC/C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAiP3D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,IAAI,KAAK,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;CACjC,CAAC,CAMD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAAC;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAOD;AAED,6BAA6B;AAC7B,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED,qCAAqC;AACrC,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEjE;AAED,yCAAyC;AACzC,wBAAgB,kBAAkB,IAAI,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CASnE;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,IAAI;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE,CAaA;AAED,gDAAgD;AAChD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKvD"}