@loomweaver/cli 0.9.1 → 0.9.3

package/dist/main.mjs

@@ -98,34 +98,15 @@ function ensureBuildTarget(target, amendment, projectRoot) {
     added.push(...assets.added.map((entry) => `assets: ${entry}`));
   }
   next["options"] = options;
-  if (amendment.inlineCritical !== void 0 || amendment.serviceWorker) {
-    const configurations = { ...asObject(next["configurations"]) };
-    const production = { ...asObject(configurations["production"]) };
-    if (amendment.serviceWorker && production["serviceWorker"] === void 0) {
-      production["serviceWorker"] = joinProjectPath(
-        projectRoot,
-        amendment.serviceWorker
-      );
-      added.push(`production serviceWorker: ${production["serviceWorker"]}`);
-    }
-    if (amendment.inlineCritical !== void 0) {
-      const critical = ensureInlineCritical(
-        production["optimization"],
-        amendment.inlineCritical
-      );
-      if (critical.declined) {
-        declined.push(
-          "production optimization is a boolean, so inlineCritical cannot be set beside it \u2014 a release build then loads the stylesheet with an inline handler the generated content-security policy blocks, and renders unstyled"
-        );
-      } else if (critical.changed) {
-        production["optimization"] = critical.value;
-        added.push(
-          `production optimization.styles.inlineCritical: ${amendment.inlineCritical}`
-        );
-      }
-    }
-    configurations["production"] = production;
-    next["configurations"] = configurations;
+  if (amendment.inlineCritical !== void 0 || amendment.serviceWorker || amendment.initialBudget) {
+    const production = ensureProductionConfiguration(
+      next["configurations"],
+      amendment,
+      projectRoot
+    );
+    next["configurations"] = production.value;
+    added.push(...production.added);
+    declined.push(...production.declined);
   }
   return { value: next, added, declined };
 }
@@ -139,6 +120,99 @@ function ensureStylesheetSource(css, source) {
 @source '${source}';
 `;
 }
+function ensureProductionConfiguration(value, amendment, projectRoot) {
+  const configurations = { ...asObject(value) };
+  const production = { ...asObject(configurations["production"]) };
+  const added = [];
+  const declined = [];
+  if (amendment.serviceWorker && production["serviceWorker"] === void 0) {
+    production["serviceWorker"] = joinProjectPath(
+      projectRoot,
+      amendment.serviceWorker
+    );
+    added.push(`production serviceWorker: ${production["serviceWorker"]}`);
+  }
+  if (amendment.inlineCritical !== void 0) {
+    const critical = ensureInlineCritical(
+      production["optimization"],
+      amendment.inlineCritical
+    );
+    if (critical.declined) {
+      declined.push(
+        "production optimization is a boolean, so inlineCritical cannot be set beside it \u2014 a release build then loads the stylesheet with an inline handler the generated content-security policy blocks, and renders unstyled"
+      );
+    } else if (critical.changed) {
+      production["optimization"] = critical.value;
+      added.push(
+        `production optimization.styles.inlineCritical: ${amendment.inlineCritical}`
+      );
+    }
+  }
+  if (amendment.initialBudget) {
+    const budgets = ensureInitialBudget(
+      production["budgets"],
+      amendment.initialBudget
+    );
+    if (budgets.changed) {
+      production["budgets"] = budgets.value;
+      added.push(
+        `production budget initial: ${amendment.initialBudget.warning} warning, ${amendment.initialBudget.error} error`
+      );
+    }
+  }
+  configurations["production"] = production;
+  return { value: configurations, added, declined };
+}
+function ensureInitialBudget(budgets, wanted) {
+  const entries = Array.isArray(budgets) ? [...budgets] : [];
+  const index = entries.findIndex(
+    (entry) => asObject(entry)?.["type"] === "initial"
+  );
+  if (index === -1) {
+    return {
+      value: [
+        ...entries,
+        {
+          type: "initial",
+          maximumWarning: wanted.warning,
+          maximumError: wanted.error
+        }
+      ],
+      changed: true
+    };
+  }
+  const current = asObject(entries[index]) ?? {};
+  if (!isBelow(current["maximumError"], wanted.error)) {
+    return { value: entries, changed: false };
+  }
+  entries[index] = {
+    ...current,
+    maximumWarning: wanted.warning,
+    maximumError: wanted.error
+  };
+  return { value: entries, changed: true };
+}
+function isBelow(recorded, wanted) {
+  const left = toBytes(recorded);
+  const right = toBytes(wanted);
+  return left !== void 0 && right !== void 0 && left < right;
+}
+function toBytes(size) {
+  if (typeof size !== "string") {
+    return void 0;
+  }
+  const match = /^([\d.]+)\s*(b|kb|mb|gb)?$/i.exec(size.trim());
+  if (!match) {
+    return void 0;
+  }
+  const units = {
+    b: 1,
+    kb: 1e3,
+    mb: 1e3 * 1e3,
+    gb: 1e3 * 1e3 * 1e3
+  };
+  return Number(match[1]) * units[(match[2] ?? "b").toLowerCase()];
+}
 function ensureInlineCritical(optimization, inlineCritical) {
   if (typeof optimization === "boolean") {
     return { value: optimization, changed: false, declined: true };
@@ -276,10 +350,11 @@ function joinNamespaces(source, id) {
   if (names.includes(`'${id}'`)) {
     return { source, joined: true };
   }
+  const namespaces = [...names, `'${id}'`].join(", ");
   return {
     source: source.replace(
       NAMESPACES,
-      () => `provideTranslationNamespaces(${[...names, `'${id}'`].join(", ")})`
+      () => `provideTranslationNamespaces(${namespaces})`
     ),
     joined: true
   };
@@ -346,15 +421,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)`
     ] : [],
@@ -363,7 +442,10 @@ function describeAmendment(amendment) {
     ] : [],
     ...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)`
-    ]
+    ],
+    ...amendment.initialBudget ? [
+      `raise the initial bundle budget to ${amendment.initialBudget.warning} warning and ${amendment.initialBudget.error} error in the production configuration (a fresh workspace carries one sized for an empty application, and the workbench alone spends almost all of it, so a release build fails)`
+    ] : []
   ].map((step, index) => `${index + 1}. ${step}`).join(" ");
 }
 
@@ -755,7 +837,7 @@ function pause(): Promise<void> {
 }
 
 // ../devkit/src/recipes/angular-weaver/agent-files.ts
-var AG_UI_ADAPTER_VERSION = "0.9.1";
+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';
@@ -1122,109 +1204,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 set = /* @__PURE__ */ new Set(["contributions", "navigation"]);
-  if (features.command) set.add("ui");
-  if (features.about) {
-    set.add("ui");
-    set.add("host");
-  }
-  if (features.agent) {
-    set.add("ui");
-    set.add("automation");
-  }
-  return KNOWN_CAPABILITIES.filter((capability) => set.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`];
 }
@@ -1361,7 +1342,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(
@@ -1385,6 +1366,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) {
@@ -1393,6 +1377,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(
@@ -1407,14 +1395,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: {
@@ -1428,6 +1419,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 set = /* @__PURE__ */ new Set(["contributions", "navigation"]);
+  if (features.command) set.add("ui");
+  if (features.about) {
+    set.add("ui");
+    set.add("host");
+  }
+  if (features.agent) {
+    set.add("ui");
+    set.add("automation");
+  }
+  return KNOWN_CAPABILITIES.filter((capability) => set.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';
@@ -1738,9 +1832,13 @@ var framePlugin = {
 };
 
 // ../devkit/src/recipes/platform-version.ts
-var PLATFORM_VERSION = "0.9.1";
+var PLATFORM_VERSION = "0.9.3";
 
 // ../devkit/src/recipes/angular-distribution/amendments.ts
+var DISTRIBUTION_INITIAL_BUDGET = {
+  warning: "1.5MB",
+  error: "2MB"
+};
 function distributionAmendments(d) {
   return [
     {
@@ -1774,7 +1872,8 @@ function distributionAmendments(d) {
         }
       ],
       serviceWorker: "ngsw-config.json",
-      inlineCritical: false
+      inlineCritical: false,
+      initialBudget: DISTRIBUTION_INITIAL_BUDGET
     }
   ];
 }
@@ -1969,9 +2068,10 @@ function readme2(d) {
     "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.",
+    "The initial-bundle budget in your build target was raised for the same reason: the shell is a",
+    "whole application chrome and spends most of Angular's default before your own code arrives, so",
+    "a production build would have failed on a number meant for an empty app. It is still a budget,",
+    "and it is yours to move.",
     "",
     "## Ship less than the whole workbench",
     "",
@@ -2024,7 +2124,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),
@@ -2744,10 +2844,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,
     {
@@ -2756,19 +2856,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")
     }
   ];
 }
@@ -2776,10 +2876,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",
@@ -2787,7 +2887,7 @@ function authSourceAmendments(input, where) {
       assets: [
         {
           glob: "**/*.json",
-          input: `${directory}/i18n`,
+          input: joinProjectPath(directory, "i18n"),
           from: "workspace",
           output: `i18n/${SESSION_PLUGIN_ID}`
         }
@@ -3488,7 +3588,7 @@ function read(ts, file, 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")),
@@ -3616,8 +3716,9 @@ function loadTypeScript(fromDir) {
 }
 
 // src/lib/run.ts
-import { readdirSync, readFileSync as readFileSync3 } from "node:fs";
-import { join } from "node:path";
+import { spawnSync } from "node:child_process";
+import { readdirSync as readdirSync2, readFileSync as readFileSync5 } from "node:fs";
+import { join as join4 } from "node:path";
 
 // src/lib/args.ts
 var ArgError = class extends Error {
@@ -3963,10 +4064,7 @@ var Amender = class {
     if (!/@import\s+['"]tailwindcss['"]/.test(css)) {
       return;
     }
-    const source = posix.relative(
-      this.displayName(dirname2(entry)),
-      amendment.sourceRoot
-    );
+    const source = posix.relative(this.displayName(dirname2(entry)), amendment.sourceRoot) || ".";
     const next = ensureStylesheetSource(css, source);
     if (next === css) {
       return;
@@ -4093,8 +4191,409 @@ function relativeImport(fromDir, sourceRoot) {
   return path.startsWith(".") ? path : `./${path}`;
 }
 
+// src/lib/init.ts
+import { existsSync as existsSync6, readFileSync as readFileSync4 } from "node:fs";
+import { join as join3 } from "node:path";
+
+// src/lib/init-plan.ts
+import { existsSync as existsSync5, readFileSync as readFileSync3 } from "node:fs";
+import { basename as basename2, join as join2, resolve as resolve5 } from "node:path";
+
+// src/lib/nx-applications.ts
+import { existsSync as existsSync3, readdirSync } from "node:fs";
+import { basename, join, relative as relative3, sep as sep3 } from "node:path";
+var SKIPPED = /* @__PURE__ */ new Set(["node_modules", "dist", "tmp", "coverage"]);
+function nxApplications(workspaceRoot) {
+  const found = [];
+  const walk = (folder) => {
+    const project = join(folder, "project.json");
+    if (existsSync3(project)) {
+      const config = readJsonFile(project);
+      const name = typeof config["name"] === "string" ? config["name"] : basename(folder);
+      if (config["projectType"] === "application" && !name.endsWith("-e2e")) {
+        found.push({
+          name,
+          root: relative3(workspaceRoot, folder).split(sep3).join("/")
+        });
+      }
+    }
+    for (const entry of readdirSync(folder, { withFileTypes: true })) {
+      if (!entry.isDirectory() || SKIPPED.has(entry.name) || entry.name.startsWith(".")) {
+        continue;
+      }
+      walk(join(folder, entry.name));
+    }
+  };
+  walk(workspaceRoot);
+  return found.toSorted((a, b) => a.name.localeCompare(b.name));
+}
+
+// src/lib/package-manager.ts
+import { existsSync as existsSync4 } from "node:fs";
+import { resolve as resolve4 } from "node:path";
+var PACKAGE_MANAGERS = [
+  "npm",
+  "pnpm",
+  "yarn",
+  "bun"
+];
+var LOCKFILES = [
+  ["package-lock.json", "npm"],
+  ["npm-shrinkwrap.json", "npm"],
+  ["pnpm-lock.yaml", "pnpm"],
+  ["yarn.lock", "yarn"],
+  ["bun.lock", "bun"],
+  ["bun.lockb", "bun"]
+];
+function detectPackageManager(root) {
+  for (const [lockfile, manager] of LOCKFILES) {
+    if (existsSync4(resolve4(root, lockfile))) {
+      return { manager, lockfile };
+    }
+  }
+  return { manager: "npm" };
+}
+function packageManagerFrom(value) {
+  if (value === void 0) {
+    return void 0;
+  }
+  if (!PACKAGE_MANAGERS.includes(value)) {
+    throw new ArgError(
+      `Option --package-manager must be one of: ${PACKAGE_MANAGERS.join(", ")}.`
+    );
+  }
+  return value;
+}
+function installCommand(manager, packages, dev) {
+  const devFlag = manager === "bun" ? "-d" : "-D";
+  const verb = manager === "npm" ? "install" : "add";
+  return [manager, verb, ...dev ? [devFlag] : [], ...packages];
+}
+function execCommand(manager, argv) {
+  if (manager === "npm") {
+    return ["npx", ...argv];
+  }
+  if (manager === "pnpm") {
+    return ["pnpm", "exec", ...argv];
+  }
+  if (manager === "bun") {
+    return ["bunx", ...argv];
+  }
+  return ["yarn", ...argv];
+}
+function runScriptCommand(manager, script) {
+  return `${manager} ${script}`;
+}
+
+// src/lib/init-plan.ts
+var RUNTIME_PACKAGES = [
+  "@loomweaver/shell",
+  "@loomweaver/plugin-sdk",
+  "@loomweaver/frame-kit",
+  "@angular/cdk",
+  "@jsverse/transloco",
+  "@ng-icons/heroicons"
+];
+var STYLE_PACKAGES = [
+  "tailwindcss",
+  "@tailwindcss/postcss",
+  "@tailwindcss/typography"
+];
+var SERVICE_WORKER = "@angular/service-worker";
+var NX_COLLECTION = "@loomweaver/devkit";
+function planInit(args, deps) {
+  const found = findWorkspace(deps.cwd);
+  if (!found?.kind) {
+    throw new WorkspaceError(
+      `No Angular application or Nx workspace here: expected an angular.json or an nx.json at or above ${resolve5(deps.cwd)}. Create one first ("ng new my-studio --style=css --ssr=false", or "npx create-nx-workspace") and run init inside it.`
+    );
+  }
+  const workspace = found;
+  const manifest2 = readManifest(workspace.root);
+  const override = packageManagerFrom(stringFlag(args, "package-manager"));
+  const detected = detectPackageManager(workspace.root);
+  const app = workspace.kind === "nx" ? chooseApplication(workspace.root, stringFlag(args, "app")) : void 0;
+  const name = app?.name ?? kebab(manifest2.name ?? basename2(workspace.root));
+  const styles = stringFlag(args, "styles") ?? "tailwind";
+  const declared = { ...manifest2.dependencies, ...manifest2.devDependencies };
+  const missing = (names) => names.filter((candidate) => !Object.hasOwn(declared, candidate));
+  return {
+    workspace,
+    manager: override ?? detected.manager,
+    lockfile: override ? void 0 : detected.lockfile,
+    name,
+    title: stringFlag(args, "title") ?? titleCase(name),
+    styles,
+    weaver: weaverId(args),
+    runtime: [
+      ...missing(RUNTIME_PACKAGES),
+      ...Object.hasOwn(declared, SERVICE_WORKER) ? [] : [serviceWorkerSpec(workspace.root, manifest2)]
+    ],
+    dev: [
+      ...styles === "tailwind" ? missing(STYLE_PACKAGES) : [],
+      ...workspace.kind === "nx" && !Object.hasOwn(declared, NX_COLLECTION) ? [collectionSpec(deps.version)] : []
+    ],
+    app,
+    dryRun: boolFlag(args, "dry-run") === true
+  };
+}
+function chooseApplication(root, wanted) {
+  const apps = nxApplications(root);
+  const names = apps.map((candidate) => candidate.name).join(", ");
+  if (wanted) {
+    const app = apps.find((candidate) => candidate.name === wanted);
+    if (!app) {
+      throw new WorkspaceError(
+        `No application named "${wanted}" in this workspace${apps.length > 0 ? `; there are: ${names}` : ""}.`
+      );
+    }
+    return app;
+  }
+  if (apps.length === 1) {
+    return apps[0];
+  }
+  if (apps.length === 0) {
+    throw new WorkspaceError(
+      'This Nx workspace has no application (no project.json with "projectType": "application"). Generate one first, then run init with --app <name>.'
+    );
+  }
+  throw new WorkspaceError(
+    `This Nx workspace has ${apps.length} applications, so none was chosen: ${names}. Name one with --app.`
+  );
+}
+function weaverId(args) {
+  const value = args.flags["weaver"];
+  if (value === false) {
+    return void 0;
+  }
+  if (value === true) {
+    throw new ArgError(
+      "Option --weaver needs a plugin id, or pass --no-weaver."
+    );
+  }
+  return value ?? "notes";
+}
+function readManifest(root) {
+  const file = join2(root, "package.json");
+  return existsSync5(file) ? readJsonFile(file) : {};
+}
+function serviceWorkerSpec(root, manifest2) {
+  const installed = join2(root, "node_modules/@angular/core/package.json");
+  if (existsSync5(installed)) {
+    const { version } = JSON.parse(readFileSync3(installed, "utf8"));
+    return `${SERVICE_WORKER}@${version}`;
+  }
+  const declared = manifest2.dependencies?.["@angular/core"];
+  return declared ? `${SERVICE_WORKER}@${declared}` : SERVICE_WORKER;
+}
+function collectionSpec(version) {
+  return version === "0.0.0" ? `${NX_COLLECTION}@latest` : `${NX_COLLECTION}@${version}`;
+}
+function kebab(value) {
+  const unscoped = value.includes("/") ? value.slice(value.lastIndexOf("/") + 1) : value;
+  return unscoped.replaceAll(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase().split(/[^a-z0-9]+/).filter(Boolean).join("-");
+}
+function titleCase(name) {
+  return name.split("-").filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
+}
+
+// src/lib/init.ts
+var INIT_FLAGS = [
+  "title",
+  "styles",
+  "weaver",
+  "app",
+  "package-manager",
+  "dry-run"
+];
+function init(args, io, deps) {
+  rejectUnknownFlags(args, INIT_FLAGS);
+  const plan = planInit(args, deps);
+  report(io, plan);
+  let didSomething = false;
+  for (const step of stepsFor(plan)) {
+    if (step.done) {
+      io.out(`${step.label}: already there.`);
+      continue;
+    }
+    didSomething = true;
+    const code = perform(step, plan, io, deps);
+    if (code !== 0) {
+      io.err(`${step.label} failed; nothing after it was run.`);
+      return code;
+    }
+  }
+  if (!plan.weaver) {
+    io.out(
+      "First weaver: skipped as asked; the rail stays empty until a plugin is composed in."
+    );
+  }
+  if (!didSomething) {
+    io.out(
+      "Nothing left to do: the packages, the distribution and the weaver are all in place."
+    );
+  }
+  io.out(
+    `${plan.dryRun ? "Then serve" : "Serve"} it with: ${serveCommand(plan)}`
+  );
+  return 0;
+}
+function perform(step, plan, io, deps) {
+  if (step.command) {
+    if (plan.dryRun) {
+      io.out(`Would run: ${step.command.join(" ")}`);
+      return 0;
+    }
+    io.out(`${step.label}: ${step.describe}`);
+    deps.exec(step.command, plan.workspace.root);
+    return 0;
+  }
+  if (step.argv) {
+    io.out(
+      plan.dryRun ? `Would ${step.label.toLowerCase()}: ${step.describe}` : `${step.label}: ${step.describe}`
+    );
+    if (plan.dryRun && step.after) {
+      io.out(`  (${step.after})`);
+    }
+    return deps.run(plan.dryRun ? [...step.argv, "--dry-run"] : step.argv);
+  }
+  return 0;
+}
+function report(io, plan) {
+  const where = plan.workspace.kind === "nx" ? `Nx workspace, application ${plan.app?.name}` : "Angular CLI application";
+  io.out(
+    `${plan.dryRun ? "Would take" : "Taking"} ${plan.workspace.root} to a product: ${where}, packages with ${managerLabel(plan)}.`
+  );
+}
+function managerLabel(plan) {
+  if (plan.lockfile) {
+    return `${plan.manager} (from ${plan.lockfile})`;
+  }
+  if (plan.manager === "npm") {
+    return "npm (no lockfile found, so npm)";
+  }
+  return plan.manager;
+}
+function stepsFor(plan) {
+  return plan.workspace.kind === "nx" ? nxSteps(plan) : angularSteps(plan);
+}
+function angularSteps(plan) {
+  const root = plan.workspace.root;
+  const steps = [
+    ...installSteps(plan),
+    {
+      label: "Distribution",
+      describe: `scaffold the composition root for "${plan.title}" (${plan.styles}) and wire the build`,
+      done: composesShell(join3(root, "src/app/app.config.ts")),
+      argv: [
+        "distribution",
+        "--name",
+        plan.name,
+        "--title",
+        plan.title,
+        "--styles",
+        plan.styles,
+        "--out",
+        root,
+        "--force"
+      ]
+    }
+  ];
+  if (plan.weaver) {
+    steps.push({
+      label: "First weaver",
+      describe: weaverDescription(plan.weaver),
+      done: existsSync6(join3(root, "src", plan.weaver, "src/index.ts")),
+      after: "planned against the composition root as it is now; once the distribution step has run, the weaver composes into it",
+      argv: [
+        "weaver",
+        "--id",
+        plan.weaver,
+        "--command",
+        "--out",
+        join3(root, "src", plan.weaver)
+      ]
+    });
+  }
+  return steps;
+}
+function nxSteps(plan) {
+  const root = plan.workspace.root;
+  const app = plan.app;
+  if (!app) {
+    return [];
+  }
+  const generator = (name, argv) => execCommand(plan.manager, ["nx", "g", `${NX_COLLECTION}:${name}`, ...argv]);
+  const steps = [
+    ...installSteps(plan),
+    {
+      label: "Distribution",
+      describe: `nx g ${NX_COLLECTION}:distribution over ${app.name} for "${plan.title}" (${plan.styles})`,
+      done: composesShell(join3(root, app.root, "src/app/app.config.ts")),
+      command: generator("distribution", [
+        "--name",
+        app.name,
+        "--directory",
+        app.root,
+        "--title",
+        plan.title,
+        "--styles",
+        plan.styles,
+        "--force"
+      ])
+    }
+  ];
+  if (plan.weaver) {
+    steps.push({
+      label: "First weaver",
+      describe: weaverDescription(plan.weaver),
+      done: existsSync6(join3(root, "libs", `${plan.weaver}-weaver`)),
+      command: generator("weaver", [
+        "--id",
+        plan.weaver,
+        "--command",
+        "--app",
+        app.name
+      ])
+    });
+  }
+  return steps;
+}
+function installSteps(plan) {
+  return [
+    {
+      label: "Install",
+      describe: plan.runtime.join(" "),
+      done: plan.runtime.length === 0,
+      command: installCommand(plan.manager, plan.runtime, false)
+    },
+    {
+      label: "Install for development",
+      describe: plan.dev.join(" "),
+      done: plan.dev.length === 0,
+      command: installCommand(plan.manager, plan.dev, true)
+    }
+  ];
+}
+function weaverDescription(id) {
+  return `"${id}" with a command on mod+shift+${id.charAt(0)}`;
+}
+function serveCommand(plan) {
+  if (plan.workspace.kind === "nx") {
+    return execCommand(plan.manager, [
+      "nx",
+      "serve",
+      plan.app?.name ?? ""
+    ]).join(" ");
+  }
+  return runScriptCommand(plan.manager, "start");
+}
+function composesShell(file) {
+  return existsSync6(file) && readFileSync4(file, "utf8").includes("provideShell(");
+}
+
 // src/lib/scaffold.ts
-import { relative as relative3, resolve as resolve4 } from "node:path";
+import { relative as relative4, resolve as resolve6 } from "node:path";
 function findScaffold2(name) {
   const scaffold2 = findScaffold(name);
   if (!scaffold2) {
@@ -4111,16 +4610,16 @@ function allowedFlagsFor(scaffold2) {
   ]);
 }
 function readFlag(args, option) {
-  const kebab = kebabCase(option.name);
-  const value = args.flags[kebab] ?? args.flags[option.name];
+  const kebab2 = kebabCase(option.name);
+  const value = args.flags[kebab2] ?? args.flags[option.name];
   if (value === void 0) {
     return void 0;
   }
   if (option.type === "string" && typeof value !== "string") {
-    throw new ArgError(`Option --${kebab} needs a value.`);
+    throw new ArgError(`Option --${kebab2} needs a value.`);
   }
   if (option.type === "boolean" && typeof value !== "boolean") {
-    throw new ArgError(`Option --${kebab} does not take a value.`);
+    throw new ArgError(`Option --${kebab2} does not take a value.`);
   }
   return value;
 }
@@ -4130,9 +4629,7 @@ function valuesFor(scaffold2, args) {
     const value = readFlag(args, option);
     if (value === void 0) {
       if (option.required) {
-        throw new ArgError(
-          `Option --${kebabCase(option.name)} is required.`
-        );
+        throw new ArgError(`Option --${kebabCase(option.name)} is required.`);
       }
       continue;
     }
@@ -4146,8 +4643,13 @@ function valuesFor(scaffold2, args) {
   return values;
 }
 function directoryFromOut(out) {
-  const below = relative3(process.cwd(), resolve4(out ?? "."));
-  return below.startsWith("..") ? "" : below;
+  const target = resolve6(out ?? ".");
+  const base = findWorkspace(target)?.root ?? process.cwd();
+  const below = relative4(base, target);
+  if (below.startsWith("..")) {
+    return "";
+  }
+  return below || ".";
 }
 function scaffoldValues(scaffold2, args) {
   const values = valuesFor(scaffold2, args);
@@ -4178,16 +4680,16 @@ import {
   rmSync,
   writeFileSync as writeFileSync2
 } from "node:fs";
-import { dirname as dirname3, isAbsolute, relative as relative4, resolve as resolve5 } from "node:path";
+import { dirname as dirname3, isAbsolute, relative as relative5, resolve as resolve7 } from "node:path";
 var WriteError = class extends Error {
 };
 function planWrite(files, root) {
-  const absoluteRoot = resolve5(root);
+  const absoluteRoot = resolve7(root);
   const planned = [];
   const conflicts = [];
   for (const path of Object.keys(files).toSorted((a, b) => a.localeCompare(b))) {
-    const absolute = resolve5(absoluteRoot, path);
-    const inside = relative4(absoluteRoot, absolute);
+    const absolute = resolve7(absoluteRoot, path);
+    const inside = relative5(absoluteRoot, absolute);
     if (inside.startsWith("..") || isAbsolute(inside)) {
       throw new WriteError(`Refusing to write outside the target directory: ${path}`);
     }
@@ -4215,7 +4717,7 @@ function entryExists(absolute) {
   }
 }
 function assertResolvesInsideRoot(root, path, absolute) {
-  const inside = relative4(realpathSync(root), realpathSync(dirname3(absolute)));
+  const inside = relative5(realpathSync(root), realpathSync(dirname3(absolute)));
   if (inside.startsWith("..") || isAbsolute(inside)) {
     throw new WriteError(
       `Refusing to write through a link that leaves the target directory: ${path}`
@@ -4229,7 +4731,7 @@ function replaceSymlinkEntry(absolute) {
 }
 
 // src/lib/run.ts
-var VERSION = "0.9.1";
+var VERSION = "0.9.3";
 function help() {
   const commands = SCAFFOLDS.map((s) => `  ${s.name.padEnd(16)}${s.summary}`);
   return [
@@ -4241,6 +4743,10 @@ function help() {
     ...commands,
     "",
     "Other commands:",
+    "  init            take the Angular application or Nx workspace you are in to a running product:",
+    "                  install the platform, scaffold the distribution and a first weaver, say what to serve",
+    "                  [--title <t>] [--styles tailwind|precompiled] [--weaver <id>|--no-weaver] [--app <nx app>]",
+    "                  [--package-manager npm|pnpm|yarn|bun] [--dry-run]",
     "  list            print every scaffold with its options",
     "  validate-manifest --id <id> [--name <name>] [--capabilities <a,b>]",
     "  validate-i18n   --dir <dir>   check <lang>.json bundles for key parity",
@@ -4299,15 +4805,17 @@ function validateManifestCommand(args, io) {
 }
 function readBundles(dir) {
   const bundles = {};
-  for (const entry of readdirSync(dir)) {
+  for (const entry of readdirSync2(dir)) {
     if (!entry.endsWith(".json")) {
       continue;
     }
     const language = entry.slice(0, -".json".length);
     try {
-      bundles[language] = JSON.parse(readFileSync3(join(dir, entry), "utf8"));
+      bundles[language] = JSON.parse(readFileSync5(join4(dir, entry), "utf8"));
     } catch (error) {
-      throw new ArgError(`${entry} is not valid JSON: ${error.message}`);
+      throw new ArgError(
+        `${entry} is not valid JSON: ${error.message}`
+      );
     }
   }
   if (Object.keys(bundles).length === 0) {
@@ -4326,15 +4834,15 @@ function validateI18nCommand(args, io) {
 function readSources(dir) {
   const sources = [];
   const walk = (folder) => {
-    for (const entry of readdirSync(folder, { withFileTypes: true })) {
+    for (const entry of readdirSync2(folder, { withFileTypes: true })) {
       if (entry.name === "node_modules" || entry.name === "dist" || entry.name.startsWith(".")) {
         continue;
       }
-      const path = join(folder, entry.name);
+      const path = join4(folder, entry.name);
       if (entry.isDirectory()) {
         walk(path);
       } else if (entry.name.endsWith(".ts") && !entry.name.endsWith(".d.ts") && !entry.name.endsWith(".spec.ts")) {
-        sources.push({ path, text: readFileSync3(path, "utf8") });
+        sources.push({ path, text: readFileSync5(path, "utf8") });
       }
     }
   };
@@ -4357,19 +4865,25 @@ function validateCommandsCommand(args, io) {
       `typescript is not installed where ${dir} can reach it; the check reads sources with the TypeScript compiler API, so run it inside the project.`
     );
   }
-  return reportFindings(io, validateCommands(readSources(dir), ts), boolFlag(args, "strict") === true);
+  return reportFindings(
+    io,
+    validateCommands(readSources(dir), ts),
+    boolFlag(args, "strict") === true
+  );
 }
 function readCatalog(file) {
   let raw;
   try {
-    raw = readFileSync3(file, "utf8");
+    raw = readFileSync5(file, "utf8");
   } catch (error) {
     throw new ArgError(`Cannot read ${file}: ${error.message}`);
   }
   try {
     return JSON.parse(raw);
   } catch (error) {
-    throw new ArgError(`${file} is not valid JSON: ${error.message}`);
+    throw new ArgError(
+      `${file} is not valid JSON: ${error.message}`
+    );
   }
 }
 function validateCatalogCommand(args, io) {
@@ -4446,7 +4960,26 @@ function scaffold(args, io) {
   reportAmendments(io, amend, true);
   return 0;
 }
-function run(argv, io) {
+var ExecError = class extends Error {
+};
+function execInherit(command, cwd) {
+  const result = spawnSync(command[0], command.slice(1), {
+    cwd,
+    stdio: "inherit",
+    shell: process.platform === "win32"
+  });
+  if (result.error) {
+    throw new ExecError(
+      `Could not run "${command.join(" ")}": ${result.error.message}`
+    );
+  }
+  if (result.status !== 0) {
+    throw new ExecError(
+      `"${command.join(" ")}" exited with ${result.status ?? "a signal"}.`
+    );
+  }
+}
+function run(argv, io, deps) {
   let args;
   try {
     args = parseArgs(argv);
@@ -4467,6 +5000,14 @@ function run(argv, io) {
     return 1;
   }
   try {
+    if (args.command === "init") {
+      return init(args, io, {
+        cwd: deps?.cwd ?? process.cwd(),
+        exec: deps?.exec ?? execInherit,
+        run: deps?.run ?? ((inner) => run(inner, io, deps)),
+        version: deps?.version ?? VERSION
+      });
+    }
     if (args.command === "list") {
       return list(args, io);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomweaver/cli",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "LoomWeaver: open-source plugin platform for Angular workbenches. The scaffolding CLI: generates weavers, distributions and integrations into any project, with no Nx workspace and no checkout required.",
   "keywords": [
     "loomweaver",