@decantr/cli 1.7.18 → 1.7.20

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-VHDAHJKS.js";
-import "./chunk-5ZMHI3R4.js";
+import "./chunk-GHLSLSRW.js";
+import "./chunk-26JRGQ54.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{chunk-5ZMHI3R4.js → chunk-26JRGQ54.js}

@@ -3170,12 +3170,18 @@ Start implementation from the shell layouts and shared route structure before fi
   }
   briefLines.push(`- **Guard mode:** ${params.guardMode}`);
   briefLines.push("");
+  const escDecCell = (s) => s.replace(/\|/g, "\\|");
   if (params.decoratorDefinitions && Object.keys(params.decoratorDefinitions).length > 0) {
     briefLines.push("### Decorator Quick Reference");
-    briefLines.push("| Class | Intent | Key CSS |");
-    briefLines.push("|-------|--------|---------|");
+    briefLines.push(
+      `Apply these classes \u2014 they carry the theme's visual identity. Without them the scaffold reads as "themed colors only."`
+    );
+    briefLines.push("");
+    briefLines.push("| Class | Intent | Apply to | Key CSS |");
+    briefLines.push("|-------|--------|----------|---------|");
     for (const [name, def] of Object.entries(params.decoratorDefinitions)) {
-      const intent = def.intent || "";
+      const intent = escDecCell(def.intent || "");
+      const applyTo = escDecCell((def.usage || []).join(", "));
       const props = def.suggested_properties ?? def.css ?? {};
       const base = Object.entries(props).map(([p, v]) => `${p}: ${v}`).join("; ");
       const hasHover = def.hover_properties && Object.keys(def.hover_properties).length > 0;
@@ -3187,7 +3193,9 @@ Start implementation from the shell layouts and shared route structure before fi
         hasActive && ":active"
       ].filter((m) => Boolean(m));
       const stateSuffix = stateMarkers.length > 0 ? ` _(+ ${stateMarkers.join(", ")})_` : "";
-      briefLines.push(`| \`.${name}\` | ${intent} | ${base}${stateSuffix} |`);
+      briefLines.push(
+        `| \`.${name}\` | ${intent} | ${applyTo} | ${escDecCell(base)}${stateSuffix} |`
+      );
     }
     briefLines.push("");
   } else if (params.decorators && params.decorators.length > 0) {
@@ -3195,7 +3203,7 @@ Start implementation from the shell layouts and shared route structure before fi
     briefLines.push("| Class | Purpose |");
     briefLines.push("|-------|---------|");
     for (const d of params.decorators) {
-      briefLines.push(`| \`.${d.name}\` | ${d.description} |`);
+      briefLines.push(`| \`.${d.name}\` | ${escDecCell(d.description)} |`);
     }
     briefLines.push("");
   }
@@ -4598,14 +4606,20 @@ function generateQuickStart(input) {
   if (patternLabels.length > 0) {
     lines.push(`**Key patterns:** ${patternLabels.join(", ")}`);
   }
-  const cssClasses = [];
-  const topDecorators = decorators.slice(0, 3).map((d) => d.name);
-  cssClasses.push(...topDecorators);
+  if (decorators.length > 0) {
+    const count = decorators.length;
+    lines.push(
+      `**Theme decorators:** ${count} class${count === 1 ? "" : "es"} \u2014 see "Required Theme Decorators" below for class + intent + apply-to`
+    );
+  }
   const pLower = personality.join(" ").toLowerCase();
-  if (pLower.includes("neon") || pLower.includes("glow")) cssClasses.push("neon-glow");
-  if (pLower.includes("mono") || pLower.includes("monospace")) cssClasses.push("mono-data");
-  if (cssClasses.length > 0) {
-    lines.push(`**CSS classes:** ${cssClasses.map((c) => `\`.${c}\``).join(", ")}`);
+  const personalityUtils = [];
+  if (pLower.includes("neon") || pLower.includes("glow")) personalityUtils.push("neon-glow");
+  if (pLower.includes("mono") || pLower.includes("monospace")) personalityUtils.push("mono-data");
+  if (personalityUtils.length > 0) {
+    lines.push(
+      `**Personality utilities:** ${personalityUtils.map((c) => `\`.${c}\``).join(", ")}`
+    );
   }
   const density = section.dna_overrides?.density || "comfortable";
   lines.push(`**Density:** ${density}`);
@@ -4756,21 +4770,38 @@ function generateSectionContext(input) {
   );
   lines.push("");
   const decoratorDefs = input.themeData?.decorator_definitions;
+  const escCell = (s) => s.replace(/\|/g, "\\|");
   if (decoratorDefs && Object.keys(decoratorDefs).length > 0) {
-    const usageEntries = Object.entries(decoratorDefs).filter(
-      ([, def]) => def.usage && def.usage.length > 0
+    const renderableEntries = Object.entries(decoratorDefs).filter(
+      ([, def]) => def.intent || def.description || def.usage && def.usage.length > 0
     );
-    if (usageEntries.length > 0) {
-      lines.push("**Section decorators (usage hints):**");
-      for (const [name, def] of usageEntries) {
-        lines.push(`- \`.${name}\`: ${(def.usage || []).join(", ")}`);
+    if (renderableEntries.length > 0) {
+      lines.push(`## Required Theme Decorators (${themeName})`);
+      lines.push("");
+      lines.push(
+        `These classes carry the active theme's visual identity. Tokens alone give bones; decorators give personality. Generated source MUST apply these \u2014 without them, the page reads as "themed colors only" with no theme character.`
+      );
+      lines.push("");
+      lines.push("| Class | Intent | Apply to |");
+      lines.push("|-------|--------|----------|");
+      for (const [name, def] of renderableEntries) {
+        const intent = escCell(def.intent || def.description || "");
+        const applyTo = escCell((def.usage || []).join(", "));
+        lines.push(`| \`.${name}\` | ${intent} | ${applyTo} |`);
       }
       lines.push("");
     }
   } else if (decorators.length > 0) {
-    lines.push("**Section decorators:**");
+    lines.push(`## Required Theme Decorators (${themeName})`);
+    lines.push("");
+    lines.push(
+      "These classes carry the active theme's visual identity. Apply them across this section's patterns or the scaffold reads as generic."
+    );
+    lines.push("");
+    lines.push("| Class | Description |");
+    lines.push("|-------|-------------|");
     for (const d of decorators) {
-      lines.push(`- \`.${d.name}\` \u2014 ${d.description}`);
+      lines.push(`| \`.${d.name}\` | ${escCell(d.description)} |`);
     }
     lines.push("");
   }

package/dist/{chunk-VHDAHJKS.js → chunk-GHLSLSRW.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-5ZMHI3R4.js";
+} from "./chunk-26JRGQ54.js";
 import {
   buildGuardRegistryContext,
   scanProjectInteractions
@@ -5942,7 +5942,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-LK3Z44M2.js");
+      const { cmdUpgrade } = await import("./upgrade-LVMAKWEA.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-VHDAHJKS.js";
-import "./chunk-5ZMHI3R4.js";
+import "./chunk-GHLSLSRW.js";
+import "./chunk-26JRGQ54.js";
 import "./chunk-QRQCPD3C.js";

package/dist/{upgrade-LK3Z44M2.js → upgrade-LVMAKWEA.js}

@@ -1,7 +1,7 @@
 import {
   RegistryClient,
   refreshDerivedFiles
-} from "./chunk-5ZMHI3R4.js";
+} from "./chunk-26JRGQ54.js";
 
 // src/commands/upgrade.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.7.18",
+  "version": "1.7.20",
   "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -27,10 +27,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@decantr/core": "1.0.2",
+    "@decantr/core": "1.0.3",
     "@decantr/essence-spec": "1.0.5",
-    "@decantr/verifier": "1.0.3",
-    "@decantr/registry": "1.0.2"
+    "@decantr/registry": "1.0.2",
+    "@decantr/verifier": "1.0.3"
   },
   "scripts": {
     "build": "tsup",