@loomweaver/mcp 0.7.2 → 0.7.3

package/README.md

@@ -14,10 +14,6 @@ is not inside this repo (a chat assistant, a remote client) can scaffold and val
 
 ## Consume from npm (product repos)
 
-> **Availability:** the `@loomweaver/*` packages are not on the public npm registry yet — the first
-> public release publishes them. Until then they come from LoomWeaver's own package feed, and
-> `npx` needs that registry configured for the `@loomweaver` scope.
-
 `@loomweaver/mcp` ships as a self-contained bundle (devkit + the MCP SDK are inlined — no transitive
 install). A product repo that already consumes `@loomweaver/shell` / `@loomweaver/plugin-sdk` just adds the
 server to its `.mcp.json`; `npx` fetches the bundle and starts the stdio server:

package/dist/main.mjs

@@ -31012,6 +31012,36 @@ function generate(recipe, input) {
   }
   return files;
 }
+function amendments(recipe, input) {
+  return recipe.amend?.(input) ?? [];
+}
+
+// ../devkit/src/lib/amend/describe.ts
+function describeAmendment(amendment) {
+  if (amendment.kind === "postcss") {
+    return `Write ${amendment.file} beside your package.json, naming ${amendment.plugin}. Without it the stylesheet is read as plain CSS: no utility class is emitted, the workbench renders unstyled, and the build still reports success.`;
+  }
+  if (amendment.kind === "stylesheet-source") {
+    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") {
+    return `Register ${amendment.id} in the composition root: import { ${amendment.symbol} }, provideTranslationNamespaces('${amendment.id}'), provideCapabilityGrants({ ${amendment.id}: [${amendment.capabilities.map((capability) => `'${capability}'`).join(
+      ", "
+    )}] }) and ...providePlugins(${amendment.symbol}). 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(", ")} (the shell fetches its own strings at runtime, so without that glob every label in the chrome renders as its raw translation key)`
+    ] : [],
+    ...amendment.serviceWorker ? [
+      `set serviceWorker to ${amendment.serviceWorker} in the production configuration (provideShell registers a worker that 404s otherwise)`
+    ] : [],
+    ...amendment.inlineCritical === void 0 ? [] : [
+      `set optimization.styles.inlineCritical to ${amendment.inlineCritical} in the production configuration (the generated content-security policy blocks the inline handler Angular's critical-CSS pass attaches, so a release build renders unstyled)`
+    ]
+  ].map((step, index) => `${index + 1}. ${step}`).join(" ");
+}
 
 // ../devkit/src/lib/generate/casing.ts
 function isKebabId(value) {
@@ -31834,6 +31864,40 @@ var framePlugin = {
   }
 };
 
+// ../devkit/src/recipes/angular-distribution/amendments.ts
+function distributionAmendments(d) {
+  return [
+    ...d.styles === "tailwind" ? [
+      {
+        kind: "postcss",
+        file: ".postcssrc.json",
+        plugin: "@tailwindcss/postcss"
+      }
+    ] : [],
+    {
+      kind: "build-target",
+      styles: ["src/styles.css"],
+      assets: [
+        { glob: "**/*", input: "public", from: "project" },
+        {
+          glob: "**/*",
+          input: "node_modules/@loomweaver/shell/i18n",
+          from: "workspace",
+          output: "i18n"
+        },
+        {
+          glob: "**/*",
+          input: "node_modules/@loomweaver/frame-kit/dist",
+          from: "workspace",
+          output: "frame-kit"
+        }
+      ],
+      serviceWorker: "ngsw-config.json",
+      inlineCritical: false
+    }
+  ];
+}
+
 // ../devkit/src/recipes/shell-regions.ts
 var SHELL_REGIONS = [
   "{ id: 'top-bar', type: 'bar', dock: 'top' }",
@@ -32086,20 +32150,15 @@ function stylesNotes(d) {
   }
   return [
     "`src/styles.css` compiles the shell's source theme with Tailwind 4, which is also what lets you",
-    "write Tailwind utilities in your own templates. It needs two things the scaffold cannot add for",
-    "you \u2014 the packages:",
+    "write Tailwind utilities in your own templates. The scaffold wrote `.postcssrc.json` beside your",
+    "`package.json` for you, because without it the stylesheet is read as plain CSS: no utility class",
+    "is emitted, the workbench renders unstyled, and the build still reports success. The packages are",
+    "the one thing left, because a scaffold does not install:",
     "",
     "```sh",
     "npm install -D tailwindcss @tailwindcss/postcss @tailwindcss/typography",
     "```",
     "",
-    "and the PostCSS plugin, in a file next to your `package.json`:",
-    "",
-    "```jsonc",
-    "// .postcssrc.json",
-    '{ "plugins": { "@tailwindcss/postcss": {} } }',
-    "```",
-    "",
     "Use **semantic tokens only** in your own templates (`bg-surface`, `text-content`, `text-brand`,",
     "`border-border`), never raw palette colours.",
     "",
@@ -32185,39 +32244,25 @@ function readme2(d) {
     "",
     "## Build wiring",
     "",
-    "The Nx generator put all of this in `project.json`. Scaffolded over the CLI or MCP, add it to",
-    "your build target yourself \u2014 `angular.json` under `projects.<name>.architect.build.options` with",
-    "the Angular CLI, `project.json` under `targets.build.options` in Nx. Paths inside `assets` are",
-    "resolved from the workspace root, so they read the same either way:",
-    "",
-    "```jsonc",
-    '"styles": ["src/styles.css"],',
-    '"assets": [',
-    '  { "glob": "**/*", "input": "public" },',
-    '  { "glob": "**/*", "input": "node_modules/@loomweaver/shell/i18n", "output": "i18n" },',
-    '  { "glob": "**/*", "input": "node_modules/@loomweaver/frame-kit/dist", "output": "frame-kit" }',
-    "],",
-    '"serviceWorker": "ngsw-config.json"',
-    "```",
-    "",
-    "And in the **production** configuration of that same target:",
+    "The scaffold did this. Your build target now names the stylesheet, three asset globs, the",
+    "service worker and one production setting, and the run that wrote these files listed each one it",
+    "added. Anything you had already set was left exactly as you set it.",
     "",
-    "```jsonc",
-    '"optimization": { "styles": { "inlineCritical": false } }',
-    "```",
+    "What each is for, so that nobody removes one as clutter. The **`@loomweaver/shell/i18n` glob**",
+    "serves the strings the shell fetches at runtime; without it every label in the chrome renders as",
+    "its raw translation key and nothing errors. The **frame-kit** glob only matters if you host",
+    "sandboxed (iframe) plugins \u2014 until you install that package the glob simply matches nothing.",
+    "**`serviceWorker`** emits the worker that `provideShell()` already registers for you (inert in",
+    "dev) \u2014 never add `provideServiceWorker` yourself, and if you would rather ship no worker at all,",
+    "drop `ngsw-config.json` and pass `provideShell({ serviceWorker: false })`, because otherwise the",
+    "registration 404s in production. **`optimization.styles.inlineCritical: false`** is not optional:",
+    "the `index.html` above ships a strict `script-src 'self'`, and Angular's critical-CSS pass loads",
+    "the stylesheet with an **inline** `onload` handler that the policy blocks \u2014 the app then renders",
+    "completely unstyled, and only in production builds.",
     "",
-    "Each of those earns its place. The **`@loomweaver/shell/i18n` glob** is the one whose absence is easy",
-    "to misread: the shell fetches its own UI strings at runtime, so without it every label in the",
-    "chrome renders as its raw translation key and nothing errors. The **frame-kit** glob only",
-    "matters if you host sandboxed (iframe) plugins \u2014 install that package then; until you do, the",
-    "glob simply matches nothing. **`serviceWorker`** emits the worker that `provideShell()` already",
-    "registers for you (inert in dev) \u2014 never add `provideServiceWorker` yourself, and if you would",
-    "rather ship no worker at all, drop `ngsw-config.json` and pass",
-    "`provideShell({ serviceWorker: false })`, because otherwise the registration 404s in production.",
-    "**`inlineCritical: false`** is not optional here: the `index.html` above ships a strict",
-    "`script-src 'self'`, and Angular's critical-CSS pass loads the stylesheet with an **inline**",
-    "`onload` handler that the policy blocks \u2014 the app then renders completely unstyled, and only in",
-    "production builds.",
+    "One thing is still yours, because the scaffold cannot know your budget: a production build warns",
+    "that the initial bundle exceeds Angular's 500 kB default. The shell is a whole application",
+    "chrome, so raise the budgets in your build target.",
     "",
     "## Ship less than the whole workbench",
     "",
@@ -32256,6 +32301,9 @@ function readme2(d) {
 }
 var angularDistribution = {
   id: "angular-distribution",
+  amend(input) {
+    return distributionAmendments(resolveDistributionInput(input));
+  },
   build(input) {
     const d = resolveDistributionInput(input);
     return {
@@ -32546,6 +32594,67 @@ var layout = {
   }
 };
 
+// ../devkit/src/recipes/angular-weaver/amendments.ts
+function weaverAmendments(input, where) {
+  const w = resolveWeaverInput(input);
+  const directory = (where ?? "").replace(/^\.?\/*/, "").replace(/\/+$/, "");
+  if (!directory) {
+    return [];
+  }
+  return [
+    {
+      kind: "build-target",
+      styles: [],
+      assets: [
+        {
+          glob: "**/*.json",
+          input: `${directory}/src/lib/i18n`,
+          from: "workspace",
+          output: `i18n/${w.id}`
+        }
+      ]
+    },
+    { kind: "stylesheet-source", sourceRoot: `${directory}/src` },
+    {
+      kind: "compose-plugin",
+      id: w.id,
+      symbol: `${w.propertyName}Plugin`,
+      capabilities: w.capabilities,
+      sourceRoot: `${directory}/src`
+    }
+  ];
+}
+
+// ../devkit/src/lib/scaffolds/inputs.ts
+function weaverInput(values) {
+  return {
+    id: str(values, "id") ?? "",
+    name: str(values, "name"),
+    prefix: str(values, "prefix"),
+    importPath: str(values, "importPath"),
+    features: {
+      command: bool(values, "command"),
+      shortcut: str(values, "shortcut"),
+      menu: str(values, "menu"),
+      barItem: bool(values, "barItem"),
+      settings: bool(values, "settings"),
+      about: bool(values, "about"),
+      instanceable: bool(values, "instanceable"),
+      container: bool(values, "container"),
+      access: str(values, "access"),
+      spec: bool(values, "spec")
+    }
+  };
+}
+function distributionInput(values) {
+  return {
+    name: str(values, "name") ?? "",
+    title: str(values, "title"),
+    directory: str(values, "directory"),
+    styles: str(values, "styles") ?? "tailwind"
+  };
+}
+
 // ../devkit/src/lib/scaffolds/scaffolds.ts
 function str(values, name) {
   const value = values[name];
@@ -32681,24 +32790,8 @@ var SCAFFOLDS = [
       APP_OPTION,
       ...PLACEMENT_OPTIONS
     ],
-    build: (values) => generate(angularWeaver, {
-      id: str(values, "id") ?? "",
-      name: str(values, "name"),
-      prefix: str(values, "prefix"),
-      importPath: str(values, "importPath"),
-      features: {
-        command: bool(values, "command"),
-        shortcut: str(values, "shortcut"),
-        menu: str(values, "menu"),
-        barItem: bool(values, "barItem"),
-        settings: bool(values, "settings"),
-        about: bool(values, "about"),
-        instanceable: bool(values, "instanceable"),
-        container: bool(values, "container"),
-        access: str(values, "access"),
-        spec: bool(values, "spec")
-      }
-    })
+    build: (values) => generate(angularWeaver, weaverInput(values)),
+    amend: (values) => weaverAmendments(weaverInput(values), str(values, "directory"))
   },
   {
     name: "frame-plugin",
@@ -32754,12 +32847,8 @@ var SCAFFOLDS = [
       },
       ...PLACEMENT_OPTIONS
     ],
-    build: (values) => generate(angularDistribution, {
-      name: str(values, "name") ?? "",
-      title: str(values, "title"),
-      directory: str(values, "directory"),
-      styles: str(values, "styles") ?? "tailwind"
-    })
+    build: (values) => generate(angularDistribution, distributionInput(values)),
+    amend: (values) => amendments(angularDistribution, distributionInput(values))
   },
   {
     name: "auth-source",
@@ -33130,7 +33219,12 @@ function valuesFor(scaffold2, args) {
   return values;
 }
 function scaffold(scaffold2, args) {
-  return ok({ files: scaffold2.build(valuesFor(scaffold2, args)) });
+  const values = valuesFor(scaffold2, args);
+  const remaining = (scaffold2.amend?.(values) ?? []).map(describeAmendment);
+  return ok({
+    files: scaffold2.build(values),
+    ...remaining.length > 0 ? { remaining } : {}
+  });
 }
 function validateManifestTool(a) {
   return ok({
@@ -33150,7 +33244,7 @@ function validateI18nTool(a) {
 }
 
 // src/lib/server.ts
-var FILE_MAP_NOTE = "Returns a file map (relative path -> content); write the files into your project.";
+var FILE_MAP_NOTE = 'Returns a file map (relative path -> content); write the files into your project. May also return "remaining": steps the workspace needs that this route cannot perform, each saying what it costs to skip. Carry them out, or the generated output builds and does not work.';
 function inputSchema(descriptor) {
   const shape = {};
   for (const option of portableOptions(descriptor)) {
@@ -33163,7 +33257,7 @@ function inputSchema(descriptor) {
 function createMcpServer() {
   const server = new McpServer({
     name: "loomweaver-devkit",
-    version: "0.7.2"
+    version: "0.7.3"
   });
   server.registerTool(
     "list_generators",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomweaver/mcp",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "LoomWeaver MCP server: exposes LoomWeaver's scaffolding and validation as MCP tools, so an AI assistant in any product repo can scaffold and validate weavers, distributions and integrations without a LoomWeaver checkout.",
   "keywords": [
     "loomweaver",