@loomweaver/mcp 0.9.2 → 0.9.3

package/README.md

@@ -10,7 +10,7 @@ is not inside this repo (a chat assistant, a remote client) can scaffold and val
 - `scaffold_weaver` · `scaffold_frame_plugin` · `scaffold_distribution` · `scaffold_auth_source` ·
   `scaffold_settings_store` · `scaffold_theme` · `scaffold_layout` — return a **file map**
   (`path -> content`); the client writes the files into its project.
-- `validate_manifest` · `validate_i18n` · `validate_catalog` — return structured `Finding[]`.
+- `validate_manifest` · `validate_i18n` · `validate_catalog` · `validate_commands` — return structured `Finding[]`.
 
 ## Consume from npm (product repos)
 

package/dist/main.mjs

@@ -31025,6 +31025,10 @@ function normalizeProjectRoot(value) {
   }
   return rooted.slice(0, end);
 }
+function joinProjectPath(projectRoot, path) {
+  const root = normalizeProjectRoot(projectRoot);
+  return root ? `${root}/${path}` : path;
+}
 
 // ../devkit/src/lib/amend/describe.ts
 function describeAmendment(amendment) {
@@ -31038,15 +31042,19 @@ function describeAmendment(amendment) {
     return `Add an @source entry for '${amendment.sourceRoot}' to the application's entry stylesheet, resolved from that stylesheet. Without it none of that code's utilities are emitted.`;
   }
   if (amendment.kind === "compose-plugin") {
-    const providers = (amendment.providers ?? []).map((provider) => provider.line.replace(/,$/, ""));
-    return `Register ${amendment.id} in the composition root: import { ${amendment.symbol} }, ${providers.map((line) => `${line}, `).join("")}provideTranslationNamespaces('${amendment.id}'), provideCapabilityGrants({ ${amendment.id}: [${amendment.capabilities.map((capability) => `'${capability}'`).join(
-      ", "
-    )}] }) and ...providePlugins(${amendment.symbol}). Without it none of its contributions appear.`;
+    const providers = (amendment.providers ?? []).map((provider) => `${provider.line.replace(/,$/, "")}, `).join("");
+    const capabilities = amendment.capabilities.map((capability) => `'${capability}'`).join(", ");
+    const imports = (amendment.providers ?? []).flatMap((provider) => provider.from ?? []).map(
+      (imported) => ` import { ${imported.symbols.join(", ")} } from '${imported.path}'.`
+    ).join("");
+    return `Register ${amendment.id} in the composition root: import { ${amendment.symbol} }, ${providers}provideTranslationNamespaces('${amendment.id}'), provideCapabilityGrants({ ${amendment.id}: [${capabilities}] }) and ...providePlugins(${amendment.symbol}).${imports} Without it none of its contributions appear.`;
   }
   return [
     ...amendment.styles.length > 0 ? [`name ${amendment.styles.join(", ")} in styles`] : [],
     ...amendment.assets.length > 0 ? [
-      `add assets for ${amendment.assets.map((asset) => asset.input).join(
+      `add assets for ${amendment.assets.map(
+        (asset) => asset.output ? `${asset.input} served under ${asset.output}` : asset.input
+      ).join(
         ", "
       )} (the shell fetches its own strings at runtime, so without that glob every label in the chrome renders as its raw translation key)`
     ] : [],
@@ -31450,7 +31458,7 @@ function pause(): Promise<void> {
 }
 
 // ../devkit/src/recipes/angular-weaver/agent-files.ts
-var AG_UI_ADAPTER_VERSION = "0.9.2";
+var AG_UI_ADAPTER_VERSION = "0.9.3";
 var AG_UI_PROTOCOL_VERSION = "0.0.x";
 function connectionFile(w) {
   return `import { signal } from '@angular/core';
@@ -31817,109 +31825,8 @@ function toneHelper() {
   ].join("\n");
 }
 
-// ../devkit/src/recipes/angular-weaver/recipe.ts
-var DEFAULT_MENU_SLOT = "content/tab/context";
+// ../devkit/src/recipes/angular-weaver/weaver-plugin.ts
 var SURFACE_ICON = '<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><rect x="4" y="4" width="16" height="16" rx="3"/><path d="M8 9h8M8 13h8M8 17h5"/></svg>';
-function accessLiteral(spec) {
-  if (spec === "authenticated") return "{ authenticated: true }";
-  if (spec === "anonymous") return "{ authenticated: false }";
-  if (spec.startsWith("role:")) {
-    const role = spec.slice("role:".length);
-    if (!role)
-      throw new Error('Access "role:" needs a role name, e.g. "role:admin".');
-    if (/['\\]/.test(role))
-      throw new Error(
-        `Access role "${role}" must not contain quotes or backslashes.`
-      );
-    return `{ anyRole: ['${role}'] }`;
-  }
-  throw new Error(
-    `Unknown access "${spec}". Use "authenticated", "anonymous" or "role:<name>".`
-  );
-}
-function resolveMenuSlot(menu) {
-  if (menu === true) {
-    return DEFAULT_MENU_SLOT;
-  }
-  return typeof menu === "string" && menu.length ? menu : void 0;
-}
-var PLATFORM_BOUND_CHORD_TOKENS = /* @__PURE__ */ new Set([
-  "cmd",
-  "command",
-  "ctrl",
-  "control",
-  "meta"
-]);
-function assertPlatformNeutralChord(shortcut) {
-  const tokens = shortcut.toLowerCase().split("+").map((token) => token.trim());
-  const bound = tokens.find((token) => PLATFORM_BOUND_CHORD_TOKENS.has(token));
-  if (bound) {
-    throw new Error(
-      `Shortcut "${shortcut}" binds the platform-specific "${bound}" key. Use the neutral 'mod' token (e.g. 'mod+shift+k') \u2014 the host renders it as \u2318 on macOS and Ctrl elsewhere.`
-    );
-  }
-}
-function resolveFeatures(id, input) {
-  const menuSlot = resolveMenuSlot(input?.menu);
-  const barItem = Boolean(input?.barItem);
-  const hasShortcut = Boolean(input?.shortcut?.trim());
-  if (hasShortcut) {
-    assertPlatformNeutralChord(input?.shortcut?.trim() ?? "");
-  }
-  const instanceable = Boolean(input?.instanceable);
-  const container = Boolean(input?.container);
-  if (instanceable && container) {
-    throw new Error(
-      'A surface cannot be both a container and instanceable: a container tab holds its own ":id" and is therefore routable, while named instances exist only for a docked, non-routable surface. Pick one.'
-    );
-  }
-  const agent = Boolean(input?.agent);
-  return {
-    command: Boolean(input?.command) || menuSlot !== void 0 || barItem || hasShortcut || agent,
-    menuSlot,
-    settings: Boolean(input?.settings),
-    access: input?.access ? accessLiteral(input.access) : void 0,
-    shortcut: input?.shortcut?.trim() || `mod+shift+${id.charAt(0)}`,
-    barItem,
-    about: Boolean(input?.about),
-    instanceable,
-    container,
-    agent,
-    spec: input?.spec !== false
-  };
-}
-function deriveCapabilities(features) {
-  const set2 = /* @__PURE__ */ new Set(["contributions", "navigation"]);
-  if (features.command) set2.add("ui");
-  if (features.about) {
-    set2.add("ui");
-    set2.add("host");
-  }
-  if (features.agent) {
-    set2.add("ui");
-    set2.add("automation");
-  }
-  return KNOWN_CAPABILITIES.filter((capability) => set2.has(capability));
-}
-function resolveWeaverInput(input) {
-  if (!isKebabId(input.id)) {
-    throw new Error(
-      `Weaver id must be kebab-case (e.g. "notes"); got "${input.id}".`
-    );
-  }
-  const features = resolveFeatures(input.id, input.features);
-  const capabilities = input.capabilities?.length ? [...input.capabilities] : deriveCapabilities(features);
-  return {
-    id: input.id,
-    name: input.name?.trim() || toTitleCase(input.id),
-    className: toPascalCase(input.id),
-    propertyName: toCamelCase(input.id),
-    capabilities,
-    features,
-    prefix: input.prefix?.trim() || "lw",
-    importPath: input.importPath?.trim() || `@loomweaver/${input.id}-weaver`
-  };
-}
 function containerChildIds(w) {
   return [`${w.id}.canvas`, `${w.id}.details`];
 }
@@ -32056,7 +31963,7 @@ function settingsBlock(w) {
     "    });"
   ].join("\n");
 }
-function pluginFile(w) {
+function pluginImports(w) {
   const imports = ["import { Plugin } from '@loomweaver/plugin-sdk';"];
   if (w.features.container) {
     imports.push(
@@ -32080,6 +31987,9 @@ function pluginFile(w) {
   if (w.features.settings) {
     imports.unshift("import { signal } from '@angular/core';");
   }
+  return imports;
+}
+function pluginConsts(w) {
   const consts = [`const icon =
   '${SURFACE_ICON}';`];
   if (w.features.settings) {
@@ -32088,6 +31998,10 @@ function pluginFile(w) {
       `const ${w.propertyName}Note = signal('');`
     );
   }
+  if (w.features.command) consts.push(toneHelper());
+  return consts;
+}
+function pluginBody(w) {
   const body = [`    ctx.contributeIcons({ '${w.id}': icon });`];
   if (w.features.agent) {
     body.push(
@@ -32102,14 +32016,17 @@ function pluginFile(w) {
   if (w.features.menuSlot) body.push(menuBlock(w));
   if (w.features.settings) body.push(settingsBlock(w));
   if (w.features.agent) body.push(agentSurfaceBlock(w));
+  return body;
+}
+function pluginFile(w) {
+  const body = pluginBody(w);
   const deactivate = w.features.agent ? `
   deactivate() {
     ${w.propertyName}Agent.set(null);
   },` : "";
-  if (w.features.command) consts.push(toneHelper());
-  return `${imports.join("\n")}
+  return `${pluginImports(w).join("\n")}
 
-${consts.join("\n\n")}
+${pluginConsts(w).join("\n\n")}
 
 export const ${w.propertyName}Plugin: Plugin = {
   manifest: {
@@ -32123,6 +32040,109 @@ ${body.join("\n")}
 };
 `;
 }
+
+// ../devkit/src/recipes/angular-weaver/recipe.ts
+var DEFAULT_MENU_SLOT = "content/tab/context";
+function accessLiteral(spec) {
+  if (spec === "authenticated") return "{ authenticated: true }";
+  if (spec === "anonymous") return "{ authenticated: false }";
+  if (spec.startsWith("role:")) {
+    const role = spec.slice("role:".length);
+    if (!role)
+      throw new Error('Access "role:" needs a role name, e.g. "role:admin".');
+    if (/['\\]/.test(role))
+      throw new Error(
+        `Access role "${role}" must not contain quotes or backslashes.`
+      );
+    return `{ anyRole: ['${role}'] }`;
+  }
+  throw new Error(
+    `Unknown access "${spec}". Use "authenticated", "anonymous" or "role:<name>".`
+  );
+}
+function resolveMenuSlot(menu) {
+  if (menu === true) {
+    return DEFAULT_MENU_SLOT;
+  }
+  return typeof menu === "string" && menu.length ? menu : void 0;
+}
+var PLATFORM_BOUND_CHORD_TOKENS = /* @__PURE__ */ new Set([
+  "cmd",
+  "command",
+  "ctrl",
+  "control",
+  "meta"
+]);
+function assertPlatformNeutralChord(shortcut) {
+  const tokens = shortcut.toLowerCase().split("+").map((token) => token.trim());
+  const bound = tokens.find((token) => PLATFORM_BOUND_CHORD_TOKENS.has(token));
+  if (bound) {
+    throw new Error(
+      `Shortcut "${shortcut}" binds the platform-specific "${bound}" key. Use the neutral 'mod' token (e.g. 'mod+shift+k') \u2014 the host renders it as \u2318 on macOS and Ctrl elsewhere.`
+    );
+  }
+}
+function resolveFeatures(id, input) {
+  const menuSlot = resolveMenuSlot(input?.menu);
+  const barItem = Boolean(input?.barItem);
+  const hasShortcut = Boolean(input?.shortcut?.trim());
+  if (hasShortcut) {
+    assertPlatformNeutralChord(input?.shortcut?.trim() ?? "");
+  }
+  const instanceable = Boolean(input?.instanceable);
+  const container = Boolean(input?.container);
+  if (instanceable && container) {
+    throw new Error(
+      'A surface cannot be both a container and instanceable: a container tab holds its own ":id" and is therefore routable, while named instances exist only for a docked, non-routable surface. Pick one.'
+    );
+  }
+  const agent = Boolean(input?.agent);
+  return {
+    command: Boolean(input?.command) || menuSlot !== void 0 || barItem || hasShortcut || agent,
+    menuSlot,
+    settings: Boolean(input?.settings),
+    access: input?.access ? accessLiteral(input.access) : void 0,
+    shortcut: input?.shortcut?.trim() || `mod+shift+${id.charAt(0)}`,
+    barItem,
+    about: Boolean(input?.about),
+    instanceable,
+    container,
+    agent,
+    spec: input?.spec !== false
+  };
+}
+function deriveCapabilities(features) {
+  const set2 = /* @__PURE__ */ new Set(["contributions", "navigation"]);
+  if (features.command) set2.add("ui");
+  if (features.about) {
+    set2.add("ui");
+    set2.add("host");
+  }
+  if (features.agent) {
+    set2.add("ui");
+    set2.add("automation");
+  }
+  return KNOWN_CAPABILITIES.filter((capability) => set2.has(capability));
+}
+function resolveWeaverInput(input) {
+  if (!isKebabId(input.id)) {
+    throw new Error(
+      `Weaver id must be kebab-case (e.g. "notes"); got "${input.id}".`
+    );
+  }
+  const features = resolveFeatures(input.id, input.features);
+  const capabilities = input.capabilities?.length ? [...input.capabilities] : deriveCapabilities(features);
+  return {
+    id: input.id,
+    name: input.name?.trim() || toTitleCase(input.id),
+    className: toPascalCase(input.id),
+    propertyName: toCamelCase(input.id),
+    capabilities,
+    features,
+    prefix: input.prefix?.trim() || "lw",
+    importPath: input.importPath?.trim() || `@loomweaver/${input.id}-weaver`
+  };
+}
 function aboutDialogFile(w) {
   return `import { Component, inject } from '@angular/core';
 import { DialogRef, PluginHost } from '@loomweaver/plugin-sdk';
@@ -32433,7 +32453,7 @@ var framePlugin = {
 };
 
 // ../devkit/src/recipes/platform-version.ts
-var PLATFORM_VERSION = "0.9.2";
+var PLATFORM_VERSION = "0.9.3";
 
 // ../devkit/src/recipes/angular-distribution/amendments.ts
 var DISTRIBUTION_INITIAL_BUDGET = {
@@ -32725,7 +32745,7 @@ function resolveDistributionInput(input) {
     );
   }
   const directory = input.directory === void 0 ? `apps/${input.name}` : input.directory.trim();
-  const depth = directory.split("/").filter(Boolean).length;
+  const depth = normalizeProjectRoot(directory).split("/").filter(Boolean).length;
   return {
     name: input.name,
     title: input.title?.trim() || toTitleCase(input.name),
@@ -33445,10 +33465,10 @@ function weaverAmendments(input, where) {
       version: AG_UI_PROTOCOL_VERSION
     }
   ] : [];
-  const directory = normalizeProjectRoot(where ?? "");
-  if (!directory) {
+  if (where === void 0 || where === "") {
     return packages;
   }
+  const directory = normalizeProjectRoot(where);
   return [
     ...packages,
     {
@@ -33457,19 +33477,19 @@ function weaverAmendments(input, where) {
       assets: [
         {
           glob: "**/*.json",
-          input: `${directory}/src/lib/i18n`,
+          input: joinProjectPath(directory, "src/lib/i18n"),
           from: "workspace",
           output: `i18n/${w.id}`
         }
       ]
     },
-    { kind: "stylesheet-source", sourceRoot: `${directory}/src` },
+    { kind: "stylesheet-source", sourceRoot: joinProjectPath(directory, "src") },
     {
       kind: "compose-plugin",
       id: w.id,
       symbol: `${w.propertyName}Plugin`,
       capabilities: w.capabilities,
-      sourceRoot: `${directory}/src`
+      sourceRoot: joinProjectPath(directory, "src")
     }
   ];
 }
@@ -33477,10 +33497,10 @@ function weaverAmendments(input, where) {
 // ../devkit/src/recipes/auth-source/recipe-amendments.ts
 function authSourceAmendments(input, where) {
   const a = resolveAuthSourceInput(input);
-  const directory = normalizeProjectRoot(where ?? "");
-  if (a.bare || !directory) {
+  if (a.bare || where === void 0 || where === "") {
     return [];
   }
+  const directory = normalizeProjectRoot(where);
   return [
     {
       kind: "build-target",
@@ -33488,7 +33508,7 @@ function authSourceAmendments(input, where) {
       assets: [
         {
           glob: "**/*.json",
-          input: `${directory}/i18n`,
+          input: joinProjectPath(directory, "i18n"),
           from: "workspace",
           output: `i18n/${SESSION_PLUGIN_ID}`
         }
@@ -34175,7 +34195,7 @@ function read(ts, file2, call) {
   return {
     at: at2,
     id: id.text,
-    callable: callable !== void 0 && callable.kind === ts.SyntaxKind.TrueKeyword,
+    callable: callable?.kind === ts.SyntaxKind.TrueKeyword,
     described: properties.has("description"),
     answers: properties.has("answers"),
     returnsValue: returnsValue(ts, properties.get("run")),
@@ -34333,9 +34353,10 @@ function valuesFor(scaffold2, args) {
   }
   return values;
 }
+var WHERE_THE_FILES_LAND = "<the directory you wrote these files into>";
 function scaffold(scaffold2, args) {
   const values = valuesFor(scaffold2, args);
-  const remaining = (scaffold2.amend?.(values) ?? []).map((amendment) => describeAmendment(amendment));
+  const remaining = (scaffold2.amend?.({ ...values, directory: WHERE_THE_FILES_LAND }) ?? []).map((amendment) => describeAmendment(amendment));
   return ok({
     files: scaffold2.build(values),
     ...remaining.length > 0 && { remaining }
@@ -34395,7 +34416,7 @@ function inputSchema(descriptor) {
 function createMcpServer() {
   const server = new McpServer({
     name: "loomweaver-devkit",
-    version: "0.9.2"
+    version: "0.9.3"
   });
   server.registerTool(
     "list_generators",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomweaver/mcp",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "LoomWeaver: open-source plugin platform for Angular workbenches. The MCP server: scaffolding and validation as tools, so an AI assistant in any product repo can build weavers without a checkout.",
   "keywords": [
     "loomweaver",