fritzkit 0.0.0-stage → 0.1.1

package/dist/mcp/server.js

@@ -0,0 +1,310 @@
+/**
+ * fritzkit MCP server (decision D3): the same verbs as the CLI, as tools, over one core.
+ * Every tool takes an optional `workspace`; every failure comes back as an isError result
+ * carrying the human message, never as an exception that would kill the server.
+ *
+ * stdio rule: nothing in here (or in the CLI command code it calls) writes to stdout;
+ * stdout belongs to JSON-RPC.
+ */
+import { existsSync } from "node:fs";
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { VIEWS } from "../core/compile/types.js";
+import { resolvePart, ResolveError } from "../core/resolve.js";
+import { parsePartSpec } from "../core/schema/part.js";
+import { formatIssues, validateCompiled, validateSpecJson } from "../core/validate/index.js";
+import { ASSETS_DIR, partDir, readPartJson, writePart } from "../core/workspace.js";
+import { CliError, cliVersion, describeError, resolveTarget, SCHEMA_HINT, workspaceOf, } from "../cli/context.js";
+import { doctorCommand } from "../cli/commands/doctor.js";
+import { exportCommand, installCommand } from "../cli/commands/export.js";
+import { importKicadCommand } from "../cli/commands/kicad.js";
+import { initCommand, listCommand, newCommand } from "../cli/commands/parts.js";
+import { pruneCommand } from "../cli/commands/prune.js";
+import { loadSvgs } from "../cli/commands/render.js";
+import { schemaCommand } from "../cli/commands/schema.js";
+import { compileDir, validateCommand, warningIssues } from "../cli/commands/validate.js";
+import { svgToPng } from "../cli/raster.js";
+import { applyPatch } from "./jsonpatch.js";
+function text(t, isError = false) {
+    return { content: [{ type: "text", text: t }], ...(isError ? { isError: true } : {}) };
+}
+function fromCommand(r, json = false) {
+    const body = json ? JSON.stringify(r.data, null, 2) : r.text;
+    return text(body, r.exitCode !== 0);
+}
+/** Run a handler; any throw becomes an isError result with the human message. */
+async function guard(fn) {
+    try {
+        return await fn();
+    }
+    catch (e) {
+        return text(describeError(e).message, true);
+    }
+}
+function withWs(ctx, workspace) {
+    return workspace === undefined ? ctx : { ...ctx, workspace };
+}
+/** Resolve <part> to a part folder (a .fzpz is refused: it cannot be edited). */
+async function folderOf(part, ctx) {
+    const t = await resolveTarget(part, ctx);
+    if (t.kind !== "dir")
+        throw new CliError(`${t.path} is a .fzpz; edit tools need a part folder`);
+    return t.dir;
+}
+/** Summary of the connectors the compiler will emit (ids include not-yet-persisted keys). */
+export function connectorSummary(raw) {
+    const resolved = resolvePart(parsePartSpec(raw));
+    return {
+        connectors: resolved.connectors.map((c) => ({
+            key: c.key,
+            id: c.fzpId,
+            name: c.name,
+            role: c.role,
+            type: c.type,
+            source: c.source,
+            xMm: c.xMm,
+            yMm: c.yMm,
+            tht: c.tht,
+        })),
+        newPinKeys: resolved.newPinKeys,
+    };
+}
+/**
+ * Validate a whole spec, write it, then compile for structural issues. Rejected (nothing
+ * written) on schema or resolve errors. pinIds on disk survive a body that omits them.
+ */
+export async function saveSpec(dir, raw, ctx) {
+    const schemaIssues = validateSpecJson(raw);
+    if (schemaIssues.length > 0) {
+        return text(`not saved:\n${formatIssues(schemaIssues)}\n${SCHEMA_HINT}`, true);
+    }
+    let body = raw;
+    if (raw.pinIds === undefined && existsSync(join(dir, "part.json"))) {
+        const old = await readPartJson(dir).catch(() => undefined);
+        if (old?.pinIds)
+            body = { ...raw, pinIds: old.pinIds };
+    }
+    try {
+        resolvePart(parsePartSpec(body));
+    }
+    catch (e) {
+        if (e instanceof ResolveError)
+            return text(`not saved: ${e.path}: ${e.message}`, true);
+        throw e;
+    }
+    const file = await writePart(dir, body);
+    if (!existsSync(join(dir, ASSETS_DIR))) {
+        await mkdir(join(dir, ASSETS_DIR), { recursive: true });
+        await writeFile(join(dir, ASSETS_DIR, ".gitkeep"), "");
+    }
+    try {
+        const compiled = await compileDir(dir, ctx);
+        const issues = [...validateCompiled(compiled), ...warningIssues(compiled.warnings)];
+        return text(`saved ${file} (${compiled.identity.moduleId})\n${formatIssues(issues)}`);
+    }
+    catch (e) {
+        return text(`saved ${file}, but it does not compile: ${describeError(e).message}`, true);
+    }
+}
+const ws = z.string().optional().describe("workspace folder (default ~/fritzkit/parts)");
+const partArg = z.string().describe("part slug in the workspace, a part folder, or a .fzpz path");
+const viewArg = z.enum(VIEWS);
+const patchOp = z.discriminatedUnion("op", [
+    z.object({ op: z.literal("add"), path: z.string(), value: z.unknown() }),
+    z.object({ op: z.literal("remove"), path: z.string() }),
+    z.object({ op: z.literal("replace"), path: z.string(), value: z.unknown() }),
+    z.object({ op: z.literal("test"), path: z.string(), value: z.unknown() }),
+]);
+const pinInput = z
+    .looseObject({
+    key: z.string(),
+    name: z.string(),
+    xMm: z.number(),
+    yMm: z.number(),
+})
+    .describe("a part.json pins[] entry (role, type, label, description, pad optional)");
+/** Build the server with every fritzkit tool registered. */
+export function createServer(base = { env: process.env }) {
+    const server = new McpServer({ name: "fritzkit", version: cliVersion() });
+    server.registerTool("fritzkit_init_workspace", {
+        description: "Create the parts workspace folder; returns its path.",
+        inputSchema: { workspace: ws },
+    }, ({ workspace }) => guard(async () => fromCommand(await initCommand(withWs(base, workspace)))));
+    server.registerTool("fritzkit_list_parts", {
+        description: "List parts in the workspace (slug, title, folder).",
+        inputSchema: { workspace: ws },
+    }, ({ workspace }) => guard(async () => fromCommand(await listCommand(withWs(base, workspace)), true)));
+    server.registerTool("fritzkit_new_part", {
+        description: "Create <workspace>/<slug>/part.json from the minimal template.",
+        inputSchema: {
+            slug: z.string().describe("new part slug: 3-60 chars, lowercase letters, digits, -"),
+            title: z.string().optional().describe("part title (default: the slug)"),
+            workspace: ws,
+        },
+    }, ({ slug, title, workspace }) => guard(async () => fromCommand(await newCommand(slug, title === undefined ? {} : { title }, withWs(base, workspace)))));
+    server.registerTool("fritzkit_get_part", {
+        description: "Return part.json as written plus the resolved connectors (key, connector id, name, role, position).",
+        inputSchema: { part: partArg, workspace: ws },
+    }, ({ part, workspace }) => guard(async () => {
+        const ctx = withWs(base, workspace);
+        const dir = await folderOf(part, ctx);
+        const raw = await readPartJson(dir);
+        const issues = validateSpecJson(raw);
+        const out = { dir, part: raw };
+        if (issues.length > 0)
+            out.issues = issues;
+        else {
+            try {
+                Object.assign(out, connectorSummary(raw));
+            }
+            catch (e) {
+                out.issues = [{ level: "error", code: "resolve", message: describeError(e).message }];
+            }
+        }
+        return text(JSON.stringify(out, null, 2));
+    }));
+    server.registerTool("fritzkit_set_part", {
+        description: "Replace part.json with a whole spec (validated first; nothing is written if invalid). Creates the part if missing. Returns issues.",
+        inputSchema: {
+            part: z.string().describe("part slug in the workspace, or a part folder"),
+            json: z.record(z.string(), z.unknown()).describe("the complete part.json object"),
+            workspace: ws,
+        },
+    }, ({ part, json, workspace }) => guard(async () => {
+        const ctx = withWs(base, workspace);
+        let dir;
+        try {
+            dir = await folderOf(part, ctx);
+        }
+        catch (e) {
+            if (/[/\\]/.test(part) || /\.fzpz$/i.test(part))
+                throw e;
+            dir = partDir(workspaceOf(ctx), part);
+        }
+        const inWorkspace = resolve(dirname(dir)) === workspaceOf(ctx);
+        const slug = json.slug;
+        if (inWorkspace && slug !== undefined && slug !== dir.split(/[/\\]/).pop()) {
+            return text(`not saved: json.slug "${String(slug)}" does not match the part folder; create a new part to rename`, true);
+        }
+        return saveSpec(dir, json, ctx);
+    }));
+    server.registerTool("fritzkit_patch_part", {
+        description: "Apply an RFC 6902 JSON Patch (add/remove/replace/test, JSON pointer paths) to part.json; validated before writing.",
+        inputSchema: {
+            part: partArg,
+            patch: z
+                .array(patchOp)
+                .describe("RFC 6902 ops applied in order; paths are JSON pointers like /pins/0/xMm or /tags/-"),
+            workspace: ws,
+        },
+    }, ({ part, patch, workspace }) => guard(async () => {
+        const ctx = withWs(base, workspace);
+        const dir = await folderOf(part, ctx);
+        const raw = await readPartJson(dir);
+        const next = applyPatch(raw, patch);
+        return saveSpec(dir, next, ctx);
+    }));
+    server.registerTool("fritzkit_add_pins", {
+        description: "Append free pins (key, name, xMm, yMm in the part frame: origin top-left, y down) to part.json.",
+        inputSchema: {
+            part: partArg,
+            pins: z.array(pinInput).min(1).describe("pins to append to part.json pins[]"),
+            workspace: ws,
+        },
+    }, ({ part, pins, workspace }) => guard(async () => {
+        const ctx = withWs(base, workspace);
+        const dir = await folderOf(part, ctx);
+        const raw = await readPartJson(dir);
+        const next = { ...raw, pins: [...(raw.pins ?? []), ...pins] };
+        return saveSpec(dir, next, ctx);
+    }));
+    server.registerTool("fritzkit_validate", {
+        description: "Validate a part: schema, compile, structural checks; checker:true also runs Fritzing's fzp checker.",
+        inputSchema: {
+            part: partArg,
+            checker: z.boolean().optional().describe("also run Fritzing's fzp checker (needs uv)"),
+            workspace: ws,
+        },
+    }, ({ part, checker, workspace }) => guard(async () => {
+        const r = await validateCommand(part, { checker: checker === true }, withWs(base, workspace));
+        return text(r.text);
+    }));
+    server.registerTool("fritzkit_render", {
+        description: "Render one view. Returns the SVG text, or with png:true a PNG image you can look at.",
+        inputSchema: {
+            part: partArg,
+            view: viewArg.default("breadboard").describe("view to render (default breadboard)"),
+            png: z.boolean().optional().describe("return a PNG image instead of SVG text"),
+            dpi: z.number().int().min(30).max(600).optional().describe("PNG resolution (default 300)"),
+            workspace: ws,
+        },
+    }, ({ part, view, png, dpi, workspace }) => guard(async () => {
+        const loaded = await loadSvgs(part, withWs(base, workspace));
+        const svg = loaded.svgs[view];
+        if (svg === undefined)
+            throw new CliError(`the part has no ${view} view`);
+        const notes = loaded.warnings.map((w) => `warning: ${w}`);
+        if (!png)
+            return text([...notes, svg].join("\n"));
+        const bytes = await svgToPng(svg, dpi ?? 300);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: [`${loaded.moduleId} ${view} view`, ...notes].join("\n"),
+                },
+                { type: "image", data: Buffer.from(bytes).toString("base64"), mimeType: "image/png" },
+            ],
+        };
+    }));
+    server.registerTool("fritzkit_export", {
+        description: "Compile and write <partdir>/<moduleId>.fzpz (validator errors block unless force).",
+        inputSchema: {
+            part: partArg,
+            out: z.string().optional().describe("output .fzpz path"),
+            force: z.boolean().optional().describe("export even when the validator reports errors"),
+            workspace: ws,
+        },
+    }, ({ part, out, force, workspace }) => guard(async () => fromCommand(await exportCommand(part, { ...(out ? { out } : {}), force: force === true }, withWs(base, workspace)))));
+    server.registerTool("fritzkit_install", {
+        description: "Export and install the part into Fritzing's user parts folder. Refuses while Fritzing runs.",
+        inputSchema: {
+            part: partArg,
+            force: z.boolean().optional().describe("install even when the validator reports errors"),
+            workspace: ws,
+        },
+    }, ({ part, force, workspace }) => guard(async () => fromCommand(await installCommand(part, { force: force === true }, withWs(base, workspace)))));
+    server.registerTool("fritzkit_prune", {
+        description: "Remove older installed versions of a part family. Dry run (prints the plan) unless yes:true.",
+        inputSchema: {
+            family: z.string().describe("family name, or a workspace slug (uses its family)"),
+            keep: z.string().optional().describe("moduleId to keep (default: newest)"),
+            yes: z.boolean().optional().describe("actually delete (default: dry run)"),
+            workspace: ws,
+        },
+    }, ({ family, keep, yes, workspace }) => guard(async () => fromCommand(await pruneCommand(family, { ...(keep ? { keep } : {}), yes: yes === true }, withWs(base, workspace)))));
+    server.registerTool("fritzkit_import_kicad", {
+        description: "Create a new part folder from a KiCad .kicad_mod footprint (exact pad geometry).",
+        inputSchema: {
+            file: z.string().describe("path to the .kicad_mod file"),
+            slug: z.string().describe("slug of the new part"),
+            title: z.string().optional().describe("part title (default: the footprint name)"),
+            workspace: ws,
+        },
+    }, ({ file, slug, title, workspace }) => guard(async () => fromCommand(await importKicadCommand(file, { slug, ...(title ? { title } : {}) }, withWs(base, workspace)))));
+    server.registerTool("fritzkit_schema", { description: "Return the part.json JSON Schema.", inputSchema: { workspace: ws } }, () => guard(async () => fromCommand(await schemaCommand({}, base))));
+    server.registerTool("fritzkit_doctor", {
+        description: "Check Node, Fritzing, its folders, uv + the fzp checker and sharp.",
+        inputSchema: { workspace: ws },
+    }, () => guard(async () => text((await doctorCommand(base)).text)));
+    return server;
+}
+/** Serve on stdio until stdin closes (logs, if any, go to stderr). */
+export async function startStdioServer(base = { env: process.env }) {
+    const server = createServer(base);
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/server/api.d.ts

@@ -0,0 +1,72 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import { type PartSpecInput } from "../core/schema/part.js";
+import { type Issue } from "../core/validate/index.js";
+import { type CommandContext } from "../cli/context.js";
+import { EventHub } from "./events.js";
+export declare const JSON_LIMIT: number;
+export declare const ASSET_LIMIT: number;
+/** Content type for serving an asset: a raster image type, or undefined (send as attachment). */
+export declare function assetMimeOf(name: string): string | undefined;
+/** Content type by file extension (application/octet-stream when unknown). */
+export declare function mimeOf(name: string): string;
+/**
+ * An upload name is one safe path segment (no separators, no "..", no leading dot) with a
+ * raster image extension (png, jpg/jpeg, webp, gif, avif, tif/tiff), and not a Windows
+ * device name (con, nul, com1, ...).
+ */
+export declare function isSafeAssetName(name: string): boolean;
+/** "assets/a/b.png" or "a/b.png" -> absolute path inside <dir>/assets, or undefined if unsafe. */
+export declare function assetPath(dir: string, name: string): string | undefined;
+export interface AssetInfo {
+    /** Spec-relative path, e.g. "assets/top.png". */
+    name: string;
+    size: number;
+}
+/** Files under <dir>/assets (dotfiles skipped), sorted, with sizes. */
+export declare function listAssets(dir: string): Promise<AssetInfo[]>;
+/** Issues with the human explanation attached (the validator panel shows it as is). */
+export declare function withExplain(issues: readonly Issue[]): (Issue & {
+    explain: string;
+})[];
+/** What GET /api/parts/:slug returns. `valid: false` still carries the text for the Raw tab. */
+export interface PartPayload {
+    slug: string;
+    dir: string;
+    /** part.json exactly as on disk. */
+    text: string;
+    hash: string;
+    /** Parsed JSON (null when the file is not JSON). */
+    raw: unknown;
+    valid: boolean;
+    issues: (Issue & {
+        explain: string;
+    })[];
+    /** With defaults applied (null when invalid). */
+    spec: unknown;
+    connectors: unknown[];
+    buses: unknown[];
+    frame: unknown;
+    /** pinIds after allocation (new keys included). */
+    pinIds: Record<string, number>;
+    assets: AssetInfo[];
+}
+/** Read a part folder into the payload the app works from. Never throws for a bad spec. */
+export declare function partPayload(slug: string, dir: string): Promise<PartPayload>;
+/**
+ * Validate a part.json body for PUT. Returns the raw object to write (with connector
+ * numbers for new keys merged into pinIds, D12a) or the issues.
+ */
+export declare function preparePut(slug: string, body: unknown): {
+    raw: PartSpecInput;
+    issues: [];
+} | {
+    raw?: undefined;
+    issues: Issue[];
+};
+export interface ApiOptions {
+    workspace: string;
+    ctx: CommandContext;
+    hub: EventHub;
+}
+/** Build the /api request handler. Resolves once the response is written. */
+export declare function apiHandler(opts: ApiOptions): (req: IncomingMessage, res: ServerResponse) => Promise<void>;