@formio/mcp - npm Package Compare versions

Comparing version 0.6.0 to 0.7.0

dist/project-resolver.d.ts

 import { z } from 'zod';
 import { FormioConfig, ResolvedFormioConfig } from './config.js';
-export declare const cwdSchema: z.ZodString;
-export declare function resolveProjectConfig(cwd: string, baseConfig: FormioConfig): ResolvedFormioConfig;
+export declare function buildCwdSchema(): z.ZodString | z.ZodOptional<z.ZodString>;
+export declare const cwdSchema: z.ZodString | z.ZodOptional<z.ZodString>;
+export declare function resolveProjectConfig(cwd: string | undefined, baseConfig: FormioConfig): ResolvedFormioConfig;

dist/project-resolver.js

 import path from 'path';
 import { z } from 'zod';
 import { readProjectEntry } from './project-map.js';
-export const cwdSchema = z
-    .string()
-    .min(1, 'cwd is required')
-    .refine((value) => path.isAbsolute(value), {
-    message: 'cwd must be an absolute path',
-})
-    .describe("User's current working directory as an absolute path. Required — the tool looks up the mapped Form.io project from ~/.formio/projects.json[cwd]. Call project_set first if the cwd is not yet mapped.");
+function isPluginContext() {
+    return process.env.FORMIO_PLUGIN_CONTEXT === '1';
+}
+const PLUGIN_CWD_DESCRIPTION = "User's current working directory as an absolute path. Required — the tool looks up the mapped Form.io project from ~/.formio/projects.json[cwd]. Call project_set first if the cwd is not yet mapped.";
+const STANDALONE_CWD_DESCRIPTION = 'Optional and ignored. The per-directory project map applies only when running as the Claude Code plugin; here the project comes from FORMIO_PROJECT_URL. Accepted so the same call works in either mode.';
+// The per-cwd map is only consulted in plugin context, so requiring cwd
+// elsewhere made callers invent a value that could not change the result — and
+// pointed them at project_set, which is not even registered outside the plugin.
+// Exported so tests can build a schema after changing the environment.
+export function buildCwdSchema() {
+    if (isPluginContext()) {
+        return z
+            .string()
+            .min(1, 'cwd is required')
+            .refine((value) => path.isAbsolute(value), {
+            message: 'cwd must be an absolute path',
+        })
+            .describe(PLUGIN_CWD_DESCRIPTION);
+    }
+    return z.string().optional().describe(STANDALONE_CWD_DESCRIPTION);
+}
+// Built once at module load, which is correct because the plugin sets
+// FORMIO_PLUGIN_CONTEXT before the server process starts.
+export const cwdSchema = buildCwdSchema();
 export function resolveProjectConfig(cwd, baseConfig) {
-    if (typeof cwd !== 'string' || cwd.length === 0) {
-        throw new Error('cwd is required and must be a non-empty string.');
+    const pluginContext = isPluginContext();
+    // Plugin context: the hook drives per-cwd project_set, so the map is
+    // authoritative and cwd must be usable. Standalone: the map is at best stale
+    // leftover from prior plugin use in this cwd, so the environment wins and cwd
+    // is never read — validating a value we are about to ignore would only
+    // produce confusing failures.
+    if (pluginContext) {
+        if (typeof cwd !== 'string' || cwd.length === 0) {
+            throw new Error('cwd is required and must be a non-empty string.');
+        }
+        if (!path.isAbsolute(cwd)) {
+            throw new Error(`cwd must be an absolute path (received: ${cwd}).`);
+        }
     }
-    if (!path.isAbsolute(cwd)) {
-        throw new Error(`cwd must be an absolute path (received: ${cwd}).`);
-    }
-    // Plugin context: the hook drives per-cwd project_set, so the map is
-    // authoritative. Standalone context: the map is at best stale leftover from
-    // prior plugin use in this cwd — ignore it so the user's .mcp.json env wins.
-    const pluginContext = process.env.FORMIO_PLUGIN_CONTEXT === '1';
-    const mappedEnv = pluginContext ? readProjectEntry(cwd)?.env : undefined;
+    const mappedEnv = pluginContext && cwd ? readProjectEntry(cwd)?.env : undefined;
     const mapped = mappedEnv?.FORMIO_PROJECT_URL;
     const projectUrl = mapped ?? baseConfig.projectUrl;
     if (!projectUrl) {
-        throw new Error(`No Form.io project is mapped for cwd=${cwd}. Call project_set with projectUrl and cwd=${cwd}, or set the FORMIO_PROJECT_URL environment variable, before invoking Form.io tools.`);
+        throw new Error(pluginContext
+            ? `No Form.io project is mapped for cwd=${cwd}. Call project_set with projectUrl and cwd=${cwd}, or set the FORMIO_PROJECT_URL environment variable, before invoking Form.io tools.`
+            : 'No Form.io project is configured. Set the FORMIO_PROJECT_URL environment variable before invoking Form.io tools.');
     }
@@ -28,0 +51,0 @@ const baseUrl = mappedEnv?.FORMIO_BASE_URL ?? baseConfig.baseUrl;

package.json

 {
   "name": "@formio/mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "mcpName": "io.form/formio-mcp",
@@ -5,0 +5,0 @@ "description": "Form.io MCP Server",

New alerts

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Fixed alerts

AI-detected potential code anomaly

Supply chain risk

AI has identified unusual behaviors that may pose a security risk.

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

114153

1.31%

Lines of code

2115

1.15%

No dependency changes