@loomweaver/cli 0.7.3 → 0.7.4

package/dist/main.mjs

@@ -1122,6 +1122,219 @@ function renderRegions(indent) {
 var PLACEHOLDER_LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" xml:space="preserve" width="512" height="512" viewBox="87.5 -53 1129.9 1129.9"><g paint-order="stroke"><path d="m0 0 12.6-10.6-9.2-8-14.5 12.1q-.7.8 1.2 1.5A17 17 0 0 1-2.4-.5Q-1 .7 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 265.2 368.8)"/><path d="m0 0 19-16c.6-.5.5-1.6-.2-2.3q-2.8-3-7.5-4.5c-1.2-.4-2.8-.1-3.4.4l-17 14.3z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 593.2 644.5)"/><path d="m0 0 5.8-4.9-9.2-8-2.8 2.3q-.9 1 0 2.5l4 7.4Q-1 .7 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#c59a2f;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 386.3 170)"/><path d="m0 0 12.4-10.4-9.2-8.1L-9.2-8.1Z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#c59a2f;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 608.2 356.6)"/><path d="m0 0 5-4.2c.6-.5.6-1.6 0-2.5l-4-7.4q-1-1.4-2.1-.7l-8 6.7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#c59a2f;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 933.4 630)"/><path d="m0 0 14.6-12.3-9.2-8L-11-6.6c-.6.5-.6 1.6.2 2.4Q-8-1.2-3.3.3C-2.2.7-.6.5 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 589.5 28.9)"/><path d="m0 0 17-14.3q.8-.8-1.3-1.4a17 17 0 0 1-7.5-4.5c-.7-.8-1.8-1-2.4-.5l-15 12.6Z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 948.5 330.8)"/><path d="m0 0 8.4-7-13.6-12-8.4 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 514.5 213.2)"/><path d="m0 0 5.7-4.8q1.3-1 .4-2L3-9.5l-8.4 7 3 2.7A2 2 0 0 0 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 743 48)"/><path d="m0 0 8.4-7-2.2-2q-1-.7-2.3.2L-2-4q-1 1.2-.2 2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 158.6 526.5)"/><path d="m0 0 8.4-7L-5-18.9c-.5-.5-1.6-.4-2.3.2l-5.8 4.8q-1 1-.3 2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 492.8 507)"/><path d="m0 0 5.7-4.8q1.3-1 .4-2l-14.7-13-8.4 7.1L-2.3.3C-1.8.6-.7.5 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 902.6 182)"/><path d="m0 0 5.9-5Q7-6 6.2-7l-3-2.7-8.7 7.2L-2.4.3Q-1.4.9 0 0" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 1065.8 319.3)"/><path d="m0 0 8.6-7.2-13.6-12-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 836.9 484.2)"/><path d="m0 0 8.6-7.2-2.2-2q-1-.6-2.4.3l-5.9 5Q-3-3-2.2-2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:#2e96c9;fill-rule:nonzero;opacity:1" transform="matrix(15.6303 0 0 -15.6303 481 797.5)"/><g transform="matrix(15.6303 0 0 -15.6303 877.6 706.6)"><linearGradient id="a" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 64.4 103.4)scale(2.18666 -2.18666)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m176.7 129.6 2-1.7 9.2 8-2 1.8z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#a);fill-rule:nonzero;opacity:1" transform="translate(-182.3 -132.8)"/></g><g transform="matrix(15.6303 0 0 -15.6303 711.4 567.2)"><linearGradient id="b" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 56.7 106)scale(-2.18726 2.18726)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m166 138.5 2.1-1.7 9.2 8.1-2 1.7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#b);fill-rule:nonzero;opacity:1" transform="translate(-171.7 -141.7)"/></g><g transform="matrix(15.6303 0 0 -15.6303 532.5 867.7)"><linearGradient id="c" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -65.1 251)scale(2.11643 -2.11643)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m155 125.2 8.5-7.2 2 1.8-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#c);fill-rule:nonzero;opacity:1" transform="translate(-160.2 -122.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 707.2 713.6)"><linearGradient id="d" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(-134.3 114 30.2)scale(2.11524 -2.11524)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m166.1 135 8.6-7.1 2 1.7-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#d);fill-rule:nonzero;opacity:1" transform="translate(-171.4 -132.3)"/></g><g transform="matrix(15.6303 0 0 -15.6303 888.2 554.5)"><linearGradient id="e" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -77.5 288)scale(2.11554 -2.11554)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m177.7 145.3 8.6-7.3 2 1.8-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#e);fill-rule:nonzero;opacity:1" transform="translate(-183 -142.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 1062 401.2)"><linearGradient id="f" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -84.1 307.3)scale(-2.11583 2.11583)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m188.8 155 8.6-7.2 2 1.8-8.6 7.2z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#f);fill-rule:nonzero;opacity:1" transform="translate(-194.1 -152.3)"/></g><g transform="matrix(15.6303 0 0 -15.6303 206.5 595.5)"><linearGradient id="g" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(225.7 98.9 40.5)scale(-2.0962 2.0962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m134.3 142.5 8.2-7 2 1.8-8.3 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#g);fill-rule:nonzero;opacity:1" transform="translate(-139.4 -139.9)"/></g><g transform="matrix(15.6303 0 0 -15.6303 381 441.4)"><linearGradient id="h" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(-134.3 107 43.3)scale(2.0962 -2.0962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m145.4 152.3 8.3-6.9 2 1.8-8.3 6.9z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#h);fill-rule:nonzero;opacity:1" transform="translate(-150.5 -149.8)"/></g><g transform="matrix(15.6303 0 0 -15.6303 562 282.3)"><linearGradient id="i" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(225.7 114.5 45.7)scale(-2.0953 2.0953)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m157 162.5 8.2-7 2 1.8-8.2 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#i);fill-rule:nonzero;opacity:1" transform="translate(-162.1 -160)"/></g><g transform="matrix(15.6303 0 0 -15.6303 736 129)"><linearGradient id="j" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -115.1 291)scale(-2.0956 2.0956)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m168.1 172.3 8.3-6.9 2 1.7-8.3 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#j);fill-rule:nonzero;opacity:1" transform="translate(-173.2 -169.7)"/></g><g transform="matrix(15.6303 0 0 -15.6303 544.8 441.3)"><linearGradient id="k" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 50.4 108)scale(2.18666 -2.18666)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m155.9 147 2-1.6 9.2 8-2 1.8z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#k);fill-rule:nonzero;opacity:1" transform="translate(-161.5 -150.3)"/></g><g transform="matrix(15.6303 0 0 -15.6303 390.7 294.8)"><linearGradient id="l" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 42.9 110.5)scale(-2.17357 2.17357)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#c59a2f;stop-opacity:1"/><stop offset="100%" style="stop-color:#614d06;stop-opacity:1"/></linearGradient><path d="m145.6 156 2-1.7 9 8-2 1.6z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#l);fill-rule:nonzero;opacity:1" transform="translate(-151.2 -159.1)"/></g><g transform="matrix(15.6303 0 0 -15.6303 375.9 585.7)"><linearGradient id="m" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 46.2 101)scale(-1.9968 1.9968)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m144.7 137.2 1.8-1.5 9.2 8.1-1.8 1.5z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#m);fill-rule:nonzero;opacity:1" transform="translate(-150.2 -140.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 733.7 274)"><linearGradient id="n" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(-44.3 284 -131.7)scale(1.9968 -1.9968)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m167.6 157.2 1.8-1.5 9.2 8-1.8 1.6z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#n);fill-rule:nonzero;opacity:1" transform="translate(-173.1 -160.5)"/></g><g transform="matrix(15.6303 0 0 -15.6303 893.6 408.2)"><linearGradient id="o" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 61 113.2)scale(1.9962 -1.9962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m177.8 148.6 1.8-1.5 9.2 8-1.8 1.6z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#o);fill-rule:nonzero;opacity:1" transform="translate(-183.3 -151.9)"/></g><g transform="matrix(15.6303 0 0 -15.6303 535.9 720)"><linearGradient id="p" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(135.7 53.6 98.6)scale(1.9962 -1.9962)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m155 128.6 1.7-1.5 9.2 8.1-1.8 1.5z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#p);fill-rule:nonzero;opacity:1" transform="translate(-160.4 -132)"/></g><g transform="matrix(15.6303 0 0 -15.6303 717.3 421.6)"><linearGradient id="q" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -93.5 280)scale(-2.095 2.095)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m167 153.6 8.2-7 2 1.8-8.3 7z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#q);fill-rule:nonzero;opacity:1" transform="translate(-172 -151)"/></g><g transform="matrix(15.6303 0 0 -15.6303 542.1 575.9)"><linearGradient id="r" x1="0" x2="1" y1="0" y2="0" gradientTransform="rotate(45.7 -87 261)scale(2.0956 -2.0956)" gradientUnits="userSpaceOnUse"><stop offset="0%" style="stop-color:#2e96c9;stop-opacity:1"/><stop offset="100%" style="stop-color:#2479a3;stop-opacity:1"/></linearGradient><path d="m155.7 143.8 8.3-7 2 1.8-8.3 6.9z" style="stroke:none;stroke-width:1;stroke-dasharray:none;stroke-linecap:butt;stroke-dashoffset:0;stroke-linejoin:miter;stroke-miterlimit:4;fill:url(#r);fill-rule:nonzero;opacity:1" transform="translate(-160.8 -141.2)"/></g></g></svg>
 `;
 
+// ../devkit/src/recipes/angular-distribution/readme.ts
+function stylesNotes(d) {
+  if (d.styles === "precompiled") {
+    return [
+      "`src/styles.css` imports the stylesheet **we** compiled \u2014 tokens, the `.lw-*` class contracts",
+      "and every utility the shell's own templates use, 67 KB minified and 11 KB over the wire. There",
+      "is nothing to install and nothing to configure: no `tailwindcss`, no `.postcssrc.json`, no",
+      "`@source` paths to miscount.",
+      "",
+      "What you give up is writing Tailwind utilities in *your own* templates. The `--lw-*` tokens stay",
+      "available to any CSS you write, so re-theming stays a token remap rather than a fight.",
+      "",
+      "If you bring a CSS framework of your own, **import it into a cascade layer** \u2014 the file says how,",
+      "and it is the one decision that determines whether the chrome survives the introduction. Prefer",
+      "Tailwind after all? Re-run the scaffold with `--styles tailwind`."
+    ];
+  }
+  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. 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",
+    "```",
+    "",
+    "Use **semantic tokens only** in your own templates (`bg-surface`, `text-content`, `text-brand`,",
+    "`border-border`), never raw palette colours.",
+    "",
+    "**Count the `../` hops in the `@source` line.** It is resolved from the stylesheet, not from the",
+    "workspace root, and the scaffold derived it from where this project sits. Move the project and",
+    "nothing errors \u2014 Tailwind simply emits none of the shell's classes and the app renders unstyled.",
+    "",
+    "Want none of this? Re-run the scaffold with `--styles precompiled` and you get a one-line",
+    "stylesheet that needs no Tailwind at all \u2014 the right choice if your product is themed with",
+    "Bootstrap, Bulma or hand-written CSS."
+  ];
+}
+function readme2(d) {
+  return [
+    `# ${d.title} \u2014 a LoomWeaver distribution`,
+    "",
+    `The composition root that assembles the platform into a shippable product. It renders the bare`,
+    `shell out of the box; add your weavers and branding below. Your own README is untouched \u2014 the`,
+    `scaffold writes its notes here so it can never overwrite prose you wrote.`,
+    "",
+    "## Run it",
+    "",
+    "In an Nx workspace (the generator wired the project):",
+    "",
+    "```sh",
+    `nx serve ${d.name}`,
+    "```",
+    "",
+    "Scaffolded over the CLI or MCP, these files are sources without build wiring \u2014 drop them into",
+    "an application you already serve (`ng new`, or an Nx application). They keep Angular's own",
+    "shape: `main.ts` bootstraps `App`, `App` renders `<lw-shell />`, and everything this product is",
+    "made of lives in `app.config.ts`. Nothing of the generated app is deleted. Over an existing",
+    "application `--force` replaces exactly the files above \u2014 all of them bootstrap wiring, none of",
+    "them content you authored. Under Nx it additionally merges the build targets into that",
+    "project's `project.json`, keeping the targets, `implicitDependencies` and tags it already had.",
+    "",
+    "Two leftovers from `ng new` are no longer referenced and can go: `src/app/app.routes.ts` (the",
+    "shell owns content routing via `provideShellRouter()`) and `src/app/app.css`. The generated",
+    "`src/app/app.spec.ts` now fails \u2014 `App` pulls the whole shell into a bare `TestBed` \u2014 so delete",
+    "it and test your own components instead of the composition root.",
+    "",
+    "The project is generated **untagged**: Nx tags belong to your `depConstraints`, and inventing",
+    "one would fail a lint policy you never opted this project into. If your workspace enforces",
+    "module boundaries, give it tags your constraints allow \u2014 `--tags` at generation time, or",
+    "`tags` in `project.json` afterwards.",
+    "",
+    "## Compose weavers + branding (in `src/app/app.config.ts`)",
+    "",
+    "The layout is already there. Adding a weaver is three providers plus its import \u2014 note the",
+    "**spread**, since `providePlugins` is variadic and returns an array:",
+    "",
+    "```ts",
+    "import { providePlugins, provideCapabilityGrants, provideTranslationNamespaces } from '@loomweaver/shell';",
+    "import { notesPlugin } from '@acme/notes-weaver';   // Nx: the workspace alias; otherwise a relative path",
+    "",
+    "    provideTranslationNamespaces('notes'),",
+    "    provideCapabilityGrants({ notes: ['contributions', 'ui', 'navigation'] }),",
+    "    ...providePlugins(notesPlugin),",
+    "```",
+    "",
+    "Grant exactly what the weaver's manifest declares \u2014 the broker is default-deny, so an ungranted",
+    "plugin throws `CapabilityError` instead of quietly doing less. A weaver also needs its",
+    "translations served: add an assets glob for its `src/lib/i18n` under `i18n/<id>` (the Nx",
+    "generator does this for you).",
+    "",
+    "`public/logo.svg` is the LoomWeaver mark, dropped in as a placeholder so the top bar renders",
+    "something from the first run instead of a broken image. Replace it with your own \u2014 any square",
+    "image will do; `logoUrl` resolves against your served root. `tagline` is a",
+    "translation key that falls back to rendering itself, so the literal above works but makes",
+    "Transloco log a missing-translation warning in dev; point it at a key of your own to silence it.",
+    "",
+    "That same file is also the **app icon**: the browser tab reads it, and the manifest names it so",
+    "the app has an icon at all. One gap is left on purpose, because a scaffold writes text and",
+    "cannot invent your artwork: **Chromium only offers installation once the manifest names a 192",
+    "and a 512 raster icon**, and iOS ignores manifest icons entirely in favour of",
+    "`apple-touch-icon`. Drop `icon-192.png` and `icon-512.png` next to the logo, add them to the",
+    "manifest's `icons` and add an `apple-touch-icon` link to `index.html`, and the app becomes",
+    "installable. Until then it runs and caches offline, it simply is not offered for installation.",
+    "",
+    "## The two searches, and the badges that say so",
+    "",
+    "The shell seeds two searches and binds them itself: `mod+k` opens the command search, `mod+p`",
+    "the search over open work (`mod` is \u2318 on macOS, Ctrl elsewhere). Both work whether or not you",
+    "do anything. What the generated `app.config.ts` adds is only the way to *see* them: a badge in",
+    "the top bar for the command search, one at the leading edge of the status bar for open work,",
+    "each printing its own chord in the spelling of the platform it runs on.",
+    "",
+    "They are placed apart on purpose. Two identical-looking search badges side by side in the top",
+    "bar read as a duplicate rather than as two different things.",
+    "",
+    "```ts",
+    "provideCommandPaletteEntry();                          // top bar, end slot, order 5",
+    "provideQuickOpenEntry({ bar: 'top-bar', order: 4 });    // \u2026or put it wherever you want",
+    "```",
+    "",
+    "A badge never outlives what it opens. Drop the search and its badge goes with it; the same",
+    "happens for a session that may not run it. You will not be left with a control that does",
+    "nothing. Switching shortcuts off is the one exception: the badge stays and still opens the",
+    "search, it simply prints no chord, because nothing here advertises a key that does nothing.",
+    "",
+    "Four things you may want, and the line for each:",
+    "",
+    "```ts",
+    "// 1. Keep the search, drop only the badge \u2014 it then opens by shortcut alone.",
+    "provideShell({ omit: ['shell.commandPaletteEntry', 'shell.quickOpenEntry'] }),",
+    "",
+    "// 2. Drop the search itself. This takes mod+p with it: the chord is derived from the",
+    "//    registered command, so removing the command unbinds the key. The badge goes too.",
+    "provideShell({ omit: ['shell.quickOpen'] }),",
+    "",
+    "// 3. Make mod+k run something of yours, keeping the shell's id. Last registration wins,",
+    "//    so your command replaces the built-in one and inherits its place everywhere.",
+    "//    Register it from your own plugin with the id 'shell.commandPalette'.",
+    "",
+    "// 4. Bind mod+k to a command of your own, under your own id.",
+    "provideShell({ omit: ['shell.commandPalette'] }),   // \u2026then declare shortcut: 'mod+k' on yours",
+    "```",
+    "",
+    "What not to do is the fifth case: declaring `mod+k` on a command of your own while the",
+    "built-in one is still registered. Two commands then hold one chord. The shell warns about it in",
+    "the console and the later registration wins, but which registration is later is not something",
+    "your composition root decides. Omit the built-in, or take its id. Never race it.",
+    "",
+    "## Styles",
+    "",
+    ...stylesNotes(d),
+    "",
+    "## Build wiring",
+    "",
+    "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.",
+    "",
+    "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.",
+    "",
+    "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",
+    "",
+    "The shell arrives with every capability on: splitting, dragging tabs between panes, pinning,",
+    "stacking views, pop-out windows, keyboard shortcuts, the curation checklists. A product whose",
+    "users would be overwhelmed by that switches parts off in the same providers array:",
+    "",
+    "```ts",
+    "import { provideShellFeatures } from '@loomweaver/shell';",
+    "",
+    "    provideShellFeatures({",
+    "      content: { splitRight: false, splitDown: false, moveTabs: false },",
+    "      sidebar: { stackViews: false },",
+    "      windows: { popout: false },",
+    "    }),",
+    "```",
+    "",
+    "A switch takes the **affordance and the gesture**: turning `splitRight` off removes the toolbar",
+    "button, the drop edges *and* `mod+\\`, so the capability cannot come back through a second door.",
+    "Fields merge group by group, so name only what you turn off. The groups are `content`,",
+    "`sidebar`, `rail`, `workspaces`, `windows` and `commands`; everything is on by default except",
+    "`content.escalate`, the unlabelled double-click cycle on a tab.",
+    "",
+    "That provider is for **gestures**. A command, a bar or rail item, a settings row or a menu entry",
+    "is a *contribution* and goes instead \u2014 by id \u2014 into `provideShell({ omit: [...] })`. Where a",
+    "capability is both, the feature switch wins and takes the menu entry with it.",
+    "",
+    "A product backend is optional: implement the settings-store / auth-source ports",
+    "(`provideSettingsStore` / `provideAuthSource`, both against the `KeyValueStore` shape)",
+    "with your own backend, or keep the local/anonymous defaults for a standalone UI.",
+    "Working state stays on `WORKING_STATE_STORE` and never reaches your",
+    "settings backend; back it separately with `provideWorkingStateStore` only if",
+    "working state should travel across devices.",
+    ""
+  ].join("\n");
+}
+
 // ../devkit/src/recipes/angular-distribution/recipe.ts
 var STYLES = ["tailwind", "precompiled"];
 function resolveDistributionInput(input) {
@@ -1157,7 +1370,9 @@ bootstrapApplication(App, appConfig).catch((err) => console.error(err));
 function appConfigTs(d) {
   return `import { ApplicationConfig } from '@angular/core';
 import {
+  provideCommandPaletteEntry,
   provideLayout,
+  provideQuickOpenEntry,
   provideShell,
   provideShellRouter,
   type ShellLayout,
@@ -1182,6 +1397,11 @@ export const appConfig: ApplicationConfig = {
     provideShellRouter(),
     provideShell(),
     provideLayout(layout),
+    /* The two searches the shell seeds: mod+k over commands, mod+p over open work. Both work
+       without these two lines; these put the shortcut on screen for a user who does not know
+       it. Delete either one, or pass { bar, slot, order } to place it elsewhere. */
+    provideCommandPaletteEntry(),
+    provideQuickOpenEntry(),
     provideProductIdentity({
       name: '${d.title}',
       tagline: 'Built on LoomWeaver',
@@ -1339,173 +1559,6 @@ function manifest(d) {
     2
   );
 }
-function stylesNotes(d) {
-  if (d.styles === "precompiled") {
-    return [
-      "`src/styles.css` imports the stylesheet **we** compiled \u2014 tokens, the `.lw-*` class contracts",
-      "and every utility the shell's own templates use, 67 KB minified and 11 KB over the wire. There",
-      "is nothing to install and nothing to configure: no `tailwindcss`, no `.postcssrc.json`, no",
-      "`@source` paths to miscount.",
-      "",
-      "What you give up is writing Tailwind utilities in *your own* templates. The `--lw-*` tokens stay",
-      "available to any CSS you write, so re-theming stays a token remap rather than a fight.",
-      "",
-      "If you bring a CSS framework of your own, **import it into a cascade layer** \u2014 the file says how,",
-      "and it is the one decision that determines whether the chrome survives the introduction. Prefer",
-      "Tailwind after all? Re-run the scaffold with `--styles tailwind`."
-    ];
-  }
-  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. 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",
-    "```",
-    "",
-    "Use **semantic tokens only** in your own templates (`bg-surface`, `text-content`, `text-brand`,",
-    "`border-border`), never raw palette colours.",
-    "",
-    "**Count the `../` hops in the `@source` line.** It is resolved from the stylesheet, not from the",
-    "workspace root, and the scaffold derived it from where this project sits. Move the project and",
-    "nothing errors \u2014 Tailwind simply emits none of the shell's classes and the app renders unstyled.",
-    "",
-    "Want none of this? Re-run the scaffold with `--styles precompiled` and you get a one-line",
-    "stylesheet that needs no Tailwind at all \u2014 the right choice if your product is themed with",
-    "Bootstrap, Bulma or hand-written CSS."
-  ];
-}
-function readme2(d) {
-  return [
-    `# ${d.title} \u2014 a LoomWeaver distribution`,
-    "",
-    `The composition root that assembles the platform into a shippable product. It renders the bare`,
-    `shell out of the box; add your weavers and branding below. Your own README is untouched \u2014 the`,
-    `scaffold writes its notes here so it can never overwrite prose you wrote.`,
-    "",
-    "## Run it",
-    "",
-    "In an Nx workspace (the generator wired the project):",
-    "",
-    "```sh",
-    `nx serve ${d.name}`,
-    "```",
-    "",
-    "Scaffolded over the CLI or MCP, these files are sources without build wiring \u2014 drop them into",
-    "an application you already serve (`ng new`, or an Nx application). They keep Angular's own",
-    "shape: `main.ts` bootstraps `App`, `App` renders `<lw-shell />`, and everything this product is",
-    "made of lives in `app.config.ts`. Nothing of the generated app is deleted. Over an existing",
-    "application `--force` replaces exactly the files above \u2014 all of them bootstrap wiring, none of",
-    "them content you authored. Under Nx it additionally merges the build targets into that",
-    "project's `project.json`, keeping the targets, `implicitDependencies` and tags it already had.",
-    "",
-    "Two leftovers from `ng new` are no longer referenced and can go: `src/app/app.routes.ts` (the",
-    "shell owns content routing via `provideShellRouter()`) and `src/app/app.css`. The generated",
-    "`src/app/app.spec.ts` now fails \u2014 `App` pulls the whole shell into a bare `TestBed` \u2014 so delete",
-    "it and test your own components instead of the composition root.",
-    "",
-    "The project is generated **untagged**: Nx tags belong to your `depConstraints`, and inventing",
-    "one would fail a lint policy you never opted this project into. If your workspace enforces",
-    "module boundaries, give it tags your constraints allow \u2014 `--tags` at generation time, or",
-    "`tags` in `project.json` afterwards.",
-    "",
-    "## Compose weavers + branding (in `src/app/app.config.ts`)",
-    "",
-    "The layout is already there. Adding a weaver is three providers plus its import \u2014 note the",
-    "**spread**, since `providePlugins` is variadic and returns an array:",
-    "",
-    "```ts",
-    "import { providePlugins, provideCapabilityGrants, provideTranslationNamespaces } from '@loomweaver/shell';",
-    "import { notesPlugin } from '@acme/notes-weaver';   // Nx: the workspace alias; otherwise a relative path",
-    "",
-    "    provideTranslationNamespaces('notes'),",
-    "    provideCapabilityGrants({ notes: ['contributions', 'ui', 'navigation'] }),",
-    "    ...providePlugins(notesPlugin),",
-    "```",
-    "",
-    "Grant exactly what the weaver's manifest declares \u2014 the broker is default-deny, so an ungranted",
-    "plugin throws `CapabilityError` instead of quietly doing less. A weaver also needs its",
-    "translations served: add an assets glob for its `src/lib/i18n` under `i18n/<id>` (the Nx",
-    "generator does this for you).",
-    "",
-    "`public/logo.svg` is the LoomWeaver mark, dropped in as a placeholder so the top bar renders",
-    "something from the first run instead of a broken image. Replace it with your own \u2014 any square",
-    "image will do; `logoUrl` resolves against your served root. `tagline` is a",
-    "translation key that falls back to rendering itself, so the literal above works but makes",
-    "Transloco log a missing-translation warning in dev; point it at a key of your own to silence it.",
-    "",
-    "That same file is also the **app icon**: the browser tab reads it, and the manifest names it so",
-    "the app has an icon at all. One gap is left on purpose, because a scaffold writes text and",
-    "cannot invent your artwork: **Chromium only offers installation once the manifest names a 192",
-    "and a 512 raster icon**, and iOS ignores manifest icons entirely in favour of",
-    "`apple-touch-icon`. Drop `icon-192.png` and `icon-512.png` next to the logo, add them to the",
-    "manifest's `icons` and add an `apple-touch-icon` link to `index.html`, and the app becomes",
-    "installable. Until then it runs and caches offline, it simply is not offered for installation.",
-    "",
-    "## Styles",
-    "",
-    ...stylesNotes(d),
-    "",
-    "## Build wiring",
-    "",
-    "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.",
-    "",
-    "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.",
-    "",
-    "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",
-    "",
-    "The shell arrives with every capability on: splitting, dragging tabs between panes, pinning,",
-    "stacking views, pop-out windows, keyboard shortcuts, the curation checklists. A product whose",
-    "users would be overwhelmed by that switches parts off in the same providers array:",
-    "",
-    "```ts",
-    "import { provideShellFeatures } from '@loomweaver/shell';",
-    "",
-    "    provideShellFeatures({",
-    "      content: { splitRight: false, splitDown: false, moveTabs: false },",
-    "      sidebar: { stackViews: false },",
-    "      windows: { popout: false },",
-    "    }),",
-    "```",
-    "",
-    "A switch takes the **affordance and the gesture**: turning `splitRight` off removes the toolbar",
-    "button, the drop edges *and* `mod+\\`, so the capability cannot come back through a second door.",
-    "Fields merge group by group, so name only what you turn off. The groups are `content`,",
-    "`sidebar`, `rail`, `workspaces`, `windows` and `commands`; everything is on by default except",
-    "`content.escalate`, the unlabelled double-click cycle on a tab.",
-    "",
-    "That provider is for **gestures**. A command, a bar or rail item, a settings row or a menu entry",
-    "is a *contribution* and goes instead \u2014 by id \u2014 into `provideShell({ omit: [...] })`. Where a",
-    "capability is both, the feature switch wins and takes the menu entry with it.",
-    "",
-    "A product backend is optional: implement the settings-store / auth-source ports",
-    "(`provideSettingsStore` / `provideAuthSource`, both against the `KeyValueStore` shape)",
-    "with your own backend, or keep the local/anonymous defaults for a standalone UI.",
-    "Working state stays on `WORKING_STATE_STORE` and never reaches your",
-    "settings backend; back it separately with `provideWorkingStateStore` only if",
-    "working state should travel across devices.",
-    ""
-  ].join("\n");
-}
 var angularDistribution = {
   id: "angular-distribution",
   amend(input) {
@@ -2963,7 +3016,7 @@ function replaceSymlinkEntry(absolute) {
 }
 
 // src/lib/run.ts
-var VERSION = "0.7.3";
+var VERSION = "0.7.4";
 function help() {
   const commands = SCAFFOLDS.map((s) => `  ${s.name.padEnd(16)}${s.summary}`);
   return [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loomweaver/cli",
-  "version": "0.7.3",
+  "version": "0.7.4",
   "description": "LoomWeaver scaffolding CLI: generates weavers, distributions and integrations into any project — no Nx workspace, no LoomWeaver checkout and no AI assistant required.",
   "keywords": [
     "loomweaver",