@cubis/foundry 0.3.83 → 0.3.84

package/mcp/src/tools/registry.test.ts

@@ -1,175 +0,0 @@
-import { describe, expect, it } from "vitest";
-import {
-  TOOL_REGISTRY,
-  getToolsByCategory,
-  getRegisteredToolNames,
-  buildRegistrySummary,
-  type ToolRegistryEntry,
-  type ToolRuntimeContext,
-} from "./registry.js";
-import type { VaultManifest } from "../vault/types.js";
-import type { RouteManifest } from "../routes/types.js";
-
-function createTestContext(): ToolRuntimeContext {
-  const manifest: VaultManifest = {
-    categories: ["frontend", "backend"],
-    skills: [
-      {
-        id: "react-expert",
-        category: "frontend",
-        path: "/tmp/react-expert/SKILL.md",
-        fileBytes: 100,
-      },
-    ],
-    fullCatalogBytes: 100,
-    fullCatalogEstimatedTokens: 25,
-  };
-  const routeManifest: RouteManifest = {
-    $schema: "cubis-foundry-route-manifest-v1",
-    generatedAt: new Date(0).toISOString(),
-    contentHash: "test",
-    summary: { totalRoutes: 1, workflows: 1, agents: 0 },
-    routes: [
-      {
-        kind: "workflow",
-        id: "mobile",
-        command: "/mobile",
-        displayName: "mobile",
-        description: "Mobile workflow",
-        triggers: ["mobile", "flutter"],
-        primaryAgent: "mobile-developer",
-        supportingAgents: [],
-        primarySkills: ["flutter-expert"],
-        supportingSkills: [],
-        artifacts: {
-          codex: {
-            workflowFile: "mobile.md",
-            compatibilityAlias: "$workflow-mobile",
-          },
-          copilot: {
-            workflowFile: "mobile.md",
-            promptFile: "workflow-mobile.prompt.md",
-          },
-          antigravity: {
-            workflowFile: "mobile.md",
-            commandFile: "mobile.toml",
-          },
-          claude: { workflowFile: "mobile.md" },
-        },
-      },
-    ],
-  };
-
-  return {
-    manifest,
-    routeManifest,
-    charsPerToken: 4,
-    summaryMaxLength: 200,
-    defaultConfigScope: "auto",
-  };
-}
-
-describe("tool registry", () => {
-  it("contains all expected built-in tools", () => {
-    const names = getRegisteredToolNames();
-    expect(names).toContain("route_resolve");
-    expect(names).toContain("skill_list_categories");
-    expect(names).toContain("skill_browse_category");
-    expect(names).toContain("skill_search");
-    expect(names).toContain("skill_validate");
-    expect(names).toContain("skill_get");
-    expect(names).toContain("skill_get_reference");
-    expect(names).toContain("skill_budget_report");
-    expect(names).toContain("postman_get_mode");
-    expect(names).toContain("postman_set_mode");
-    expect(names).toContain("postman_get_status");
-    expect(names).toContain("stitch_get_mode");
-    expect(names).toContain("stitch_set_profile");
-    expect(names).toContain("stitch_get_status");
-    expect(names).toContain("playwright_get_status");
-  });
-
-  it("has exactly 15 built-in tools", () => {
-    expect(TOOL_REGISTRY).toHaveLength(15);
-  });
-
-  it("has no duplicate tool names", () => {
-    const names = getRegisteredToolNames();
-    const unique = new Set(names);
-    expect(unique.size).toBe(names.length);
-  });
-
-  it("every entry has required fields", () => {
-    for (const entry of TOOL_REGISTRY) {
-      expect(entry.name).toBeTruthy();
-      expect(entry.description).toBeTruthy();
-      expect(entry.schema).toBeTruthy();
-      expect(entry.category).toMatch(
-        /^(skill|route|postman|stitch|playwright)$/,
-      );
-      expect(typeof entry.createHandler).toBe("function");
-    }
-  });
-
-  it("filters by category", () => {
-    const routeTools = getToolsByCategory("route");
-    expect(routeTools).toHaveLength(1);
-
-    const skillTools = getToolsByCategory("skill");
-    expect(skillTools).toHaveLength(7);
-    expect(skillTools.every((t) => t.category === "skill")).toBe(true);
-
-    const postmanTools = getToolsByCategory("postman");
-    expect(postmanTools).toHaveLength(3);
-
-    const stitchTools = getToolsByCategory("stitch");
-    expect(stitchTools).toHaveLength(3);
-  });
-
-  it("creates handlers from runtime context", () => {
-    const ctx = createTestContext();
-    for (const entry of TOOL_REGISTRY) {
-      const handler = entry.createHandler(ctx);
-      expect(typeof handler).toBe("function");
-    }
-  });
-
-  it("skill_list_categories handler returns valid result from registry", async () => {
-    const ctx = createTestContext();
-    const entry = TOOL_REGISTRY.find(
-      (t) => t.name === "skill_list_categories",
-    )!;
-    const handler = entry.createHandler(ctx);
-    const result = (await (
-      handler as unknown as (
-        args: Record<string, never>,
-      ) => Promise<{ content: Array<{ text: string }> }>
-    )({})) as {
-      content: Array<{ text: string }>;
-    };
-    const data = JSON.parse(result.content[0].text);
-    expect(data.totalSkills).toBe(1);
-  });
-
-  it("buildRegistrySummary produces correct structure", () => {
-    const summary = buildRegistrySummary();
-    expect(summary.totalTools).toBe(15);
-    expect(summary.categories).toHaveProperty("route");
-    expect(summary.categories).toHaveProperty("skill");
-    expect(summary.categories).toHaveProperty("postman");
-    expect(summary.categories).toHaveProperty("stitch");
-    expect(summary.categories).toHaveProperty("playwright");
-    expect(summary.categories.route.tools).toHaveLength(1);
-    expect(summary.categories.skill.tools).toHaveLength(7);
-    expect(summary.categories.postman.tools).toHaveLength(3);
-    expect(summary.categories.stitch.tools).toHaveLength(3);
-    expect(summary.categories.playwright.tools).toHaveLength(1);
-  });
-
-  it("each schema has a valid .shape property", () => {
-    for (const entry of TOOL_REGISTRY) {
-      expect(entry.schema.shape).toBeDefined();
-      expect(typeof entry.schema.shape).toBe("object");
-    }
-  });
-});

package/mcp/src/tools/registry.ts

@@ -1,405 +0,0 @@
-/**
- * Cubis Foundry MCP Server – declarative tool registry.
- *
- * Defines all built-in tools in a single registry array.
- * Server.ts reads from this registry to auto-register tools,
- * eliminating per-tool import boilerplate.
- *
- * When adding a new tool:
- *   1. Create toolName.ts with name/description/schema/handler exports
- *   2. Add a ToolRegistryEntry here
- *   3. Done — server.ts picks it up automatically.
- */
-
-import { z } from "zod";
-import type { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { VaultManifest } from "../vault/types.js";
-import type { RouteManifest } from "../routes/types.js";
-import type { ConfigScope } from "../cbxConfig/types.js";
-
-// ─── Core types ─────────────────────────────────────────────
-
-export type ToolCategory =
-  | "skill"
-  | "route"
-  | "postman"
-  | "stitch"
-  | "playwright";
-
-export interface ToolRegistryEntry {
-  /** Tool name exposed to MCP clients. */
-  name: string;
-  /** One-line description for MCP discovery. */
-  description: string;
-  /** Zod schema (the `.shape` is extracted at registration time). */
-  schema: z.ZodObject<z.ZodRawShape>;
-  /** Tool category for grouping and documentation. */
-  category: ToolCategory;
-  /**
-   * Handler factory.  Receives shared runtime context and returns the
-   * concrete async handler that server.tool() expects.
-   */
-  createHandler: (
-    ctx: ToolRuntimeContext,
-  ) => ToolCallback<z.ZodObject<z.ZodRawShape>>;
-}
-
-export interface ToolRuntimeContext {
-  manifest: VaultManifest;
-  routeManifest: RouteManifest;
-  charsPerToken: number;
-  summaryMaxLength: number;
-  defaultConfigScope: ConfigScope | "auto";
-}
-
-// ─── Tool imports ───────────────────────────────────────────
-
-import {
-  routeResolveName,
-  routeResolveDescription,
-  routeResolveSchema,
-  handleRouteResolve,
-} from "./routeResolve.js";
-
-import {
-  skillListCategoriesName,
-  skillListCategoriesDescription,
-  skillListCategoriesSchema,
-  handleSkillListCategories,
-} from "./skillListCategories.js";
-
-import {
-  skillBrowseCategoryName,
-  skillBrowseCategoryDescription,
-  skillBrowseCategorySchema,
-  handleSkillBrowseCategory,
-} from "./skillBrowseCategory.js";
-
-import {
-  skillSearchName,
-  skillSearchDescription,
-  skillSearchSchema,
-  handleSkillSearch,
-} from "./skillSearch.js";
-
-import {
-  skillValidateName,
-  skillValidateDescription,
-  skillValidateSchema,
-  handleSkillValidate,
-} from "./skillValidate.js";
-
-import {
-  skillGetName,
-  skillGetDescription,
-  skillGetSchema,
-  handleSkillGet,
-} from "./skillGet.js";
-
-import {
-  skillGetReferenceName,
-  skillGetReferenceDescription,
-  skillGetReferenceSchema,
-  handleSkillGetReference,
-} from "./skillGetReference.js";
-
-import {
-  skillBudgetReportName,
-  skillBudgetReportDescription,
-  skillBudgetReportSchema,
-  handleSkillBudgetReport,
-} from "./skillBudgetReport.js";
-
-import {
-  postmanGetModeName,
-  postmanGetModeDescription,
-  postmanGetModeSchema,
-  handlePostmanGetMode,
-} from "./postmanGetMode.js";
-
-import {
-  postmanSetModeName,
-  postmanSetModeDescription,
-  postmanSetModeSchema,
-  handlePostmanSetMode,
-} from "./postmanSetMode.js";
-
-import {
-  postmanGetStatusName,
-  postmanGetStatusDescription,
-  postmanGetStatusSchema,
-  handlePostmanGetStatus,
-} from "./postmanGetStatus.js";
-
-import {
-  stitchGetModeName,
-  stitchGetModeDescription,
-  stitchGetModeSchema,
-  handleStitchGetMode,
-} from "./stitchGetMode.js";
-
-import {
-  stitchSetProfileName,
-  stitchSetProfileDescription,
-  stitchSetProfileSchema,
-  handleStitchSetProfile,
-} from "./stitchSetProfile.js";
-
-import {
-  stitchGetStatusName,
-  stitchGetStatusDescription,
-  stitchGetStatusSchema,
-  handleStitchGetStatus,
-} from "./stitchGetStatus.js";
-
-import {
-  playwrightGetStatusName,
-  playwrightGetStatusDescription,
-  playwrightGetStatusSchema,
-  handlePlaywrightGetStatus,
-} from "./playwrightGetStatus.js";
-
-// ─── Scope helper ───────────────────────────────────────────
-
-function withDefaultScope(
-  args: unknown,
-  defaultScope: ConfigScope | "auto",
-): Record<string, unknown> {
-  const safeArgs =
-    args && typeof args === "object" ? (args as Record<string, unknown>) : {};
-  return {
-    ...safeArgs,
-    scope: typeof safeArgs.scope === "string" ? safeArgs.scope : defaultScope,
-  };
-}
-
-// ─── Registry ───────────────────────────────────────────────
-
-export const TOOL_REGISTRY: readonly ToolRegistryEntry[] = [
-  // ── Route tools ───────────────────────────────────────────
-  {
-    name: routeResolveName,
-    description: routeResolveDescription,
-    schema: routeResolveSchema,
-    category: "route",
-    createHandler: (ctx) => async (args) =>
-      handleRouteResolve(
-        args as z.infer<typeof routeResolveSchema>,
-        ctx.routeManifest,
-      ),
-  },
-
-  // ── Skill vault tools ─────────────────────────────────────
-  {
-    name: skillListCategoriesName,
-    description: skillListCategoriesDescription,
-    schema: skillListCategoriesSchema,
-    category: "skill",
-    createHandler: (ctx) => async () =>
-      handleSkillListCategories(ctx.manifest, ctx.charsPerToken),
-  },
-  {
-    name: skillBrowseCategoryName,
-    description: skillBrowseCategoryDescription,
-    schema: skillBrowseCategorySchema,
-    category: "skill",
-    createHandler: (ctx) => async (args) =>
-      handleSkillBrowseCategory(
-        args as z.infer<typeof skillBrowseCategorySchema>,
-        ctx.manifest,
-        ctx.summaryMaxLength,
-        ctx.charsPerToken,
-      ),
-  },
-  {
-    name: skillSearchName,
-    description: skillSearchDescription,
-    schema: skillSearchSchema,
-    category: "skill",
-    createHandler: (ctx) => async (args) =>
-      handleSkillSearch(
-        args as z.infer<typeof skillSearchSchema>,
-        ctx.manifest,
-        ctx.summaryMaxLength,
-        ctx.charsPerToken,
-      ),
-  },
-  {
-    name: skillValidateName,
-    description: skillValidateDescription,
-    schema: skillValidateSchema,
-    category: "skill",
-    createHandler: (ctx) => async (args) =>
-      handleSkillValidate(
-        args as z.infer<typeof skillValidateSchema>,
-        ctx.manifest,
-        ctx.charsPerToken,
-      ),
-  },
-  {
-    name: skillGetName,
-    description: skillGetDescription,
-    schema: skillGetSchema,
-    category: "skill",
-    createHandler: (ctx) => async (args) =>
-      handleSkillGet(
-        args as z.infer<typeof skillGetSchema>,
-        ctx.manifest,
-        ctx.charsPerToken,
-      ),
-  },
-  {
-    name: skillGetReferenceName,
-    description: skillGetReferenceDescription,
-    schema: skillGetReferenceSchema,
-    category: "skill",
-    createHandler: (ctx) => async (args) =>
-      handleSkillGetReference(
-        args as z.infer<typeof skillGetReferenceSchema>,
-        ctx.manifest,
-        ctx.charsPerToken,
-      ),
-  },
-  {
-    name: skillBudgetReportName,
-    description: skillBudgetReportDescription,
-    schema: skillBudgetReportSchema,
-    category: "skill",
-    createHandler: (ctx) => async (args) =>
-      handleSkillBudgetReport(
-        args as z.infer<typeof skillBudgetReportSchema>,
-        ctx.manifest,
-        ctx.charsPerToken,
-      ),
-  },
-
-  // ── Postman tools ─────────────────────────────────────────
-  {
-    name: postmanGetModeName,
-    description: postmanGetModeDescription,
-    schema: postmanGetModeSchema,
-    category: "postman",
-    createHandler: (ctx) => async (args) =>
-      handlePostmanGetMode(
-        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
-          typeof postmanGetModeSchema
-        >,
-      ),
-  },
-  {
-    name: postmanSetModeName,
-    description: postmanSetModeDescription,
-    schema: postmanSetModeSchema,
-    category: "postman",
-    createHandler: (ctx) => async (args) =>
-      handlePostmanSetMode(
-        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
-          typeof postmanSetModeSchema
-        >,
-      ),
-  },
-  {
-    name: postmanGetStatusName,
-    description: postmanGetStatusDescription,
-    schema: postmanGetStatusSchema,
-    category: "postman",
-    createHandler: (ctx) => async (args) =>
-      handlePostmanGetStatus(
-        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
-          typeof postmanGetStatusSchema
-        >,
-      ),
-  },
-
-  // ── Stitch tools ──────────────────────────────────────────
-  {
-    name: stitchGetModeName,
-    description: stitchGetModeDescription,
-    schema: stitchGetModeSchema,
-    category: "stitch",
-    createHandler: (ctx) => async (args) =>
-      handleStitchGetMode(
-        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
-          typeof stitchGetModeSchema
-        >,
-      ),
-  },
-  {
-    name: stitchSetProfileName,
-    description: stitchSetProfileDescription,
-    schema: stitchSetProfileSchema,
-    category: "stitch",
-    createHandler: (ctx) => async (args) =>
-      handleStitchSetProfile(
-        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
-          typeof stitchSetProfileSchema
-        >,
-      ),
-  },
-  {
-    name: stitchGetStatusName,
-    description: stitchGetStatusDescription,
-    schema: stitchGetStatusSchema,
-    category: "stitch",
-    createHandler: (ctx) => async (args) =>
-      handleStitchGetStatus(
-        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
-          typeof stitchGetStatusSchema
-        >,
-      ),
-  },
-
-  // ── Playwright tools ──────────────────────────────────────
-  {
-    name: playwrightGetStatusName,
-    description: playwrightGetStatusDescription,
-    schema: playwrightGetStatusSchema,
-    category: "playwright",
-    createHandler: (ctx) => async (args) =>
-      handlePlaywrightGetStatus(
-        withDefaultScope(args, ctx.defaultConfigScope) as z.infer<
-          typeof playwrightGetStatusSchema
-        >,
-      ),
-  },
-];
-
-// ─── Helpers ────────────────────────────────────────────────
-
-/** Get tools filtered by category. */
-export function getToolsByCategory(
-  category: ToolCategory,
-): ToolRegistryEntry[] {
-  return TOOL_REGISTRY.filter((t) => t.category === category);
-}
-
-/** Get all registered tool names. */
-export function getRegisteredToolNames(): string[] {
-  return TOOL_REGISTRY.map((t) => t.name);
-}
-
-/** Build a summary of the registry for documentation/rule-file generation. */
-export function buildRegistrySummary(): {
-  categories: Record<
-    string,
-    { tools: Array<{ name: string; description: string }> }
-  >;
-  totalTools: number;
-} {
-  const categories: Record<
-    string,
-    { tools: Array<{ name: string; description: string }> }
-  > = {};
-
-  for (const tool of TOOL_REGISTRY) {
-    if (!categories[tool.category]) {
-      categories[tool.category] = { tools: [] };
-    }
-    categories[tool.category].tools.push({
-      name: tool.name,
-      description: tool.description,
-    });
-  }
-
-  return { categories, totalTools: TOOL_REGISTRY.length };
-}