@decantr/cli 1.5.4 → 1.5.6

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import "./chunk-D3W3MYKT.js";
-import "./chunk-T7CQSJGV.js";
+import "./chunk-G77ADKWE.js";
+import "./chunk-VKWRNLHR.js";

package/dist/{chunk-D3W3MYKT.js → chunk-G77ADKWE.js}

@@ -9,7 +9,7 @@ import {
   scaffoldMinimal,
   scaffoldProject,
   syncRegistry
-} from "./chunk-T7CQSJGV.js";
+} from "./chunk-VKWRNLHR.js";
 
 // src/index.ts
 import { readFileSync as readFileSync15, existsSync as existsSync23, readdirSync as readdirSync6 } from "fs";
@@ -4256,7 +4256,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-TXVD2WIN.js");
+      const { cmdUpgrade } = await import("./upgrade-6MKC6EDQ.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/{chunk-T7CQSJGV.js → chunk-VKWRNLHR.js}

@@ -93,6 +93,9 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
     ["box-shadow", "var(--d-shadow-lg)"],
     ["z-index", "50"]
   ]);
+  emitRule(".d-surface[data-interactive]", [
+    ["cursor", "pointer"]
+  ]);
   emitRule(".d-surface[data-interactive]:hover", [
     ["border-color", "var(--d-primary-hover, var(--d-border))"],
     ["box-shadow", "var(--d-shadow-md)"],
@@ -154,7 +157,13 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
     ["padding", "var(--d-section-py) 0"]
   ]);
   lines.push(".d-section + .d-section {");
-  lines.push("  border-top: 1px solid var(--d-border);");
+  lines.push("  border-top: 1px solid transparent;");
+  lines.push("  border-image: linear-gradient(to right, transparent, var(--d-border), transparent) 1;");
+  lines.push("  margin-top: var(--d-gap-2);");
+  lines.push("}");
+  lines.push("");
+  lines.push('.d-section[data-density="compact"] {');
+  lines.push("  padding: calc(var(--d-section-py) * 0.5) 0;");
   lines.push("}");
   lines.push("");
   emitRule(".d-annotation", [
@@ -185,6 +194,14 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
     ["background", "color-mix(in srgb, var(--d-info) 15%, transparent)"],
     ["color", "var(--d-info)"]
   ]);
+  emitRule(".d-label", [
+    ["font-size", "0.7rem"],
+    ["font-weight", "600"],
+    ["text-transform", "uppercase"],
+    ["letter-spacing", "0.08em"],
+    ["color", "var(--d-text-muted)"],
+    ["font-family", "var(--d-font-mono, ui-monospace, monospace)"]
+  ]);
   if (themeDecorators && Object.keys(themeDecorators).length > 0) {
     const label = themeName ? ` (${themeName})` : "";
     lines.push(`/* \u2500\u2500 Layer 3: Theme Decorators${label} \u2500\u2500 */`);
@@ -208,6 +225,35 @@ function generateTreatmentCSS(spatialTokens, treatmentOverrides, themeDecorators
   lines.push("}");
   return lines.join("\n");
 }
+function generatePersonalityCSS(personality, themeData) {
+  const text = personality.join(" ").toLowerCase();
+  const rules = [];
+  if (text.includes("neon") || text.includes("glow")) {
+    const glowColor = "var(--d-accent-glow, rgba(0, 212, 255, 0.3))";
+    rules.push(`.neon-glow { box-shadow: 0 0 20px ${glowColor}; }`);
+    rules.push(`.neon-glow-hover:hover { box-shadow: 0 0 24px ${glowColor}; transition: box-shadow var(--d-duration-hover, 0.15s) var(--d-easing, ease); }`);
+    rules.push(`.neon-text-glow { text-shadow: 0 0 12px ${glowColor}; }`);
+    rules.push(`.neon-border-glow { border-color: var(--d-accent); box-shadow: 0 0 8px ${glowColor}; }`);
+  }
+  if (text.includes("monospace") || text.includes("mono")) {
+    rules.push(`.mono-data { font-family: var(--d-font-mono, ui-monospace, monospace); font-variant-numeric: tabular-nums; }`);
+  }
+  if (text.includes("pulse") || text.includes("ring") || text.includes("status")) {
+    rules.push(`.status-ring { width: 48px; height: 48px; border-radius: 50%; border: 2px solid var(--d-border); display: flex; align-items: center; justify-content: center; position: relative; transition: border-color 0.2s ease, box-shadow 0.2s ease; }`);
+    rules.push(`.status-ring[data-status="active"] { border-color: var(--d-success); }`);
+    rules.push(`.status-ring[data-status="error"] { border-color: var(--d-error); box-shadow: 0 0 12px color-mix(in srgb, var(--d-error) 25%, transparent); }`);
+    rules.push(`.status-ring[data-status="warning"] { border-color: var(--d-warning); }`);
+    rules.push(`.status-ring[data-status="idle"] { border-color: var(--d-text-muted); }`);
+    rules.push(`@keyframes pulse-ring { 0% { opacity: 0.6; transform: scale(1); } 100% { opacity: 0; transform: scale(1.3); } }`);
+    rules.push(`.status-ring[data-status="active"]::after { content: ''; position: absolute; inset: -4px; border-radius: 50%; border: 2px solid var(--d-success); opacity: 0; animation: pulse-ring 2s ease-out infinite; }`);
+  }
+  if (themeData.motion?.entrance) {
+    rules.push(`.entrance-fade { animation: decantr-entrance var(--d-duration-entrance, 0.2s) var(--d-easing, ease-out); }`);
+    rules.push(`@keyframes decantr-entrance { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: translateY(0); } }`);
+  }
+  if (rules.length === 0) return "";
+  return "\n/* \u2500\u2500 Personality-Derived Utilities \u2500\u2500 */\n\n" + rules.join("\n\n") + "\n";
+}
 
 // src/scaffold.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
@@ -627,35 +673,6 @@ input, button, textarea, select {
 }
 `;
 }
-function generateTreatmentsContext(themeData, themeName) {
-  const lines = [];
-  lines.push(`# Visual Treatments: ${themeName}`);
-  lines.push("");
-  lines.push("## Base Treatments");
-  lines.push("");
-  lines.push("d-interactive, d-surface, d-data, d-control, d-section, d-annotation \u2014 see DECANTR.md for usage.");
-  lines.push("");
-  if (themeData?.decorators && Object.keys(themeData.decorators).length > 0) {
-    lines.push(`## Theme Decorators (${themeName}-specific)`);
-    lines.push("");
-    lines.push("| Class | Use for |");
-    lines.push("|-------|---------|");
-    for (const [name, description] of Object.entries(themeData.decorators)) {
-      const useFor = description.split(".")[0].trim();
-      lines.push(`| ${name} | ${useFor} |`);
-    }
-    lines.push("");
-  }
-  lines.push("## Composition");
-  lines.push("");
-  lines.push("Atoms + treatment + theme decorator:");
-  lines.push("```tsx");
-  lines.push(`css('_flex _col _gap4') + ' d-surface'`);
-  lines.push("```");
-  lines.push("");
-  lines.push("Atoms use `css()` function. Treatments and theme decorators are plain class strings.");
-  return lines.join("\n");
-}
 function generateDecoratorRule(name, description) {
   const rules = [];
   const descLower = description.toLowerCase();
@@ -1064,21 +1081,191 @@ Atoms + treatment + theme decorator:
 - **Theme decorators:** \`carbon-glass\`, \`carbon-code\` \u2014 theme-specific decoration from treatments.css
 - **Combined:** \`css('_flex _col') + ' d-surface carbon-card'\`
 
-### Atoms Quick Reference
+### Atom Reference
+
+#### Display
+| Atom | CSS |
+|------|-----|
+| \`_flex\` | \`display:flex\` |
+| \`_grid\` | \`display:grid\` |
+| \`_block\` | \`display:block\` |
+| \`_inline\` | \`display:inline\` |
+| \`_inlineflex\` | \`display:inline-flex\` |
+| \`_none\` | \`display:none\` |
+| \`_contents\` | \`display:contents\` |
+
+#### Flexbox
+| Atom | CSS |
+|------|-----|
+| \`_col\` | \`flex-direction:column\` |
+| \`_row\` | \`flex-direction:row\` |
+| \`_colrev\` | \`flex-direction:column-reverse\` |
+| \`_wrap\` | \`flex-wrap:wrap\` |
+| \`_nowrap\` | \`flex-wrap:nowrap\` |
+| \`_flex1\` | \`flex:1\` |
+| \`_flex0\` | \`flex:none\` |
+| \`_flexauto\` | \`flex:auto\` |
+| \`_grow\` | \`flex-grow:1\` |
+| \`_grow0\` | \`flex-grow:0\` |
+| \`_shrink0\` | \`flex-shrink:0\` |
+
+#### Alignment
+| Atom | CSS |
+|------|-----|
+| \`_aic\` | \`align-items:center\` |
+| \`_aifs\` | \`align-items:flex-start\` |
+| \`_aife\` | \`align-items:flex-end\` |
+| \`_aist\` | \`align-items:stretch\` |
+| \`_aibl\` | \`align-items:baseline\` |
+| \`_jcc\` | \`justify-content:center\` |
+| \`_jcfs\` | \`justify-content:flex-start\` |
+| \`_jcfe\` | \`justify-content:flex-end\` |
+| \`_jcsb\` | \`justify-content:space-between\` |
+| \`_jcsa\` | \`justify-content:space-around\` |
+| \`_jcse\` | \`justify-content:space-evenly\` |
+| \`_pic\` | \`place-items:center\` |
+| \`_pcc\` | \`place-content:center\` |
+
+#### Spacing (scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24, ...)
+| Atom | CSS | Notes |
+|------|-----|-------|
+| \`_gap{n}\` | \`gap:{scale}\` | e.g. \`_gap4\` = \`gap:1rem\` |
+| \`_gx{n}\` | \`column-gap:{scale}\` | horizontal gap |
+| \`_gy{n}\` | \`row-gap:{scale}\` | vertical gap |
+| \`_p{n}\` | \`padding:{scale}\` | all sides |
+| \`_pt{n}\`, \`_pr{n}\`, \`_pb{n}\`, \`_pl{n}\` | directional padding | top/right/bottom/left |
+| \`_px{n}\` | \`padding-inline:{scale}\` | horizontal |
+| \`_py{n}\` | \`padding-block:{scale}\` | vertical |
+| \`_m{n}\` | \`margin:{scale}\` | same as padding variants |
+| \`_mx{n}\`, \`_my{n}\` | inline/block margin | horizontal/vertical |
+
+#### Sizing
+| Atom | CSS |
+|------|-----|
+| \`_wfull\` / \`_w100\` | \`width:100%\` |
+| \`_hfull\` / \`_h100\` | \`height:100%\` |
+| \`_wscreen\` | \`width:100vw\` |
+| \`_hscreen\` | \`height:100vh\` |
+| \`_wfit\` | \`width:fit-content\` |
+| \`_hfit\` | \`height:fit-content\` |
+| \`_wauto\` | \`width:auto\` |
+| \`_minw0\` | \`min-width:0\` |
+| \`_minh0\` | \`min-height:0\` |
+| \`_w{n}\`, \`_h{n}\` | width/height from spacing scale |
+| \`_minw{n}\`, \`_maxw{n}\` | min/max width from scale |
 
-| Category | Examples | Purpose |
-|----------|----------|---------|
-| Layout | \`_flex\`, \`_col\`, \`_row\`, \`_wrap\`, \`_grid\` | Flex/grid containers |
-| Spacing | \`_gap4\`, \`_p4\`, \`_px4\`, \`_py2\`, \`_m0\` | Gaps, padding, margin |
-| Sizing | \`_w100\`, \`_h100\`, \`_minw0\`, \`_maxwfull\` | Width, height |
-| Text | \`_textlg\`, \`_text2xl\`, \`_fontbold\`, \`_textc\` | Typography |
-| Alignment | \`_aic\`, \`_jcc\`, \`_jcsb\`, \`_pic\` | Flex/grid alignment |
-| Position | \`_rel\`, \`_abs\`, \`_sticky\`, \`_z10\` | Positioning |
-| Visual | \`_rounded\`, \`_shadow\`, \`_trans\`, \`_op50\` | Decoration |
-| Color | \`_bgprimary\`, \`_fgtext\`, \`_fgmuted\`, \`_bcborder\` | Theme colors |
-| Responsive | \`_md:gc2\`, \`_lg:gc4\`, \`_sm:flex\` | Breakpoint prefixes |
+#### Text Size
+| Atom | Size | Line-height |
+|------|------|-------------|
+| \`_textxs\` | 0.75rem | 1rem |
+| \`_textsm\` | 0.875rem | 1.25rem |
+| \`_textbase\` | 1rem | 1.5rem |
+| \`_textlg\` | 1.125rem | 1.75rem |
+| \`_textxl\` | 1.25rem | 1.75rem |
+| \`_text2xl\` | 1.5rem | 2rem |
+| \`_text3xl\` | 1.875rem | 2.25rem |
+| \`_heading1\`-\`_heading6\` | Heading presets (size + weight) |
 
-Scale: 0, 1, 2, 3, 4, 5, 6, 8, 10, 12, 16, 20, 24. Example: \`_gap4\` = \`gap:1rem\`.
+#### Text Style
+| Atom | CSS |
+|------|-----|
+| \`_fontbold\` | \`font-weight:700\` |
+| \`_fontsemi\` | \`font-weight:600\` |
+| \`_fontmedium\` | \`font-weight:500\` |
+| \`_fontlight\` | \`font-weight:300\` |
+| \`_italic\` | \`font-style:italic\` |
+| \`_underline\` | \`text-decoration:underline\` |
+| \`_uppercase\` | \`text-transform:uppercase\` |
+| \`_truncate\` | overflow ellipsis + nowrap |
+| \`_textl\`, \`_textc\`, \`_textr\` | text-align left/center/right |
+
+#### Color (theme variable based)
+| Atom | CSS |
+|------|-----|
+| \`_bgprimary\` | \`background:var(--d-primary)\` |
+| \`_bgsurface\` | \`background:var(--d-surface)\` |
+| \`_bgsurface0\`-\`_bgsurface2\` | surface elevation layers |
+| \`_bgmuted\` | \`background:var(--d-muted)\` |
+| \`_bgbg\` | \`background:var(--d-bg)\` |
+| \`_bgsuccess\`, \`_bgerror\`, \`_bgwarning\`, \`_bginfo\` | status backgrounds |
+| \`_fgprimary\` | \`color:var(--d-primary)\` |
+| \`_fgtext\` | \`color:var(--d-text)\` |
+| \`_fgmuted\` | \`color:var(--d-text-muted)\` |
+| \`_fgsuccess\`, \`_fgerror\`, \`_fgwarning\`, \`_fginfo\` | status text |
+| \`_bcborder\` | \`border-color:var(--d-border)\` |
+
+#### Overflow & Whitespace
+| Atom | CSS |
+|------|-----|
+| \`_overhidden\` | \`overflow:hidden\` |
+| \`_overauto\` | \`overflow:auto\` |
+| \`_overscroll\` | \`overflow:scroll\` |
+| \`_overxauto\`, \`_overyauto\` | axis-specific overflow |
+| \`_nowraptext\` | \`white-space:nowrap\` |
+| \`_prewrap\` | \`white-space:pre-wrap\` |
+| \`_breakword\` | \`overflow-wrap:break-word\` |
+
+#### Cursor & Interaction
+| Atom | CSS |
+|------|-----|
+| \`_pointer\` | \`cursor:pointer\` |
+| \`_cursordefault\` | \`cursor:default\` |
+| \`_notallowed\` | \`cursor:not-allowed\` |
+| \`_grab\` | \`cursor:grab\` |
+| \`_selectnone\` | \`user-select:none\` |
+| \`_ptrnone\` | \`pointer-events:none\` |
+
+#### Position & Layout
+| Atom | CSS |
+|------|-----|
+| \`_rel\` | \`position:relative\` |
+| \`_abs\` | \`position:absolute\` |
+| \`_fixed\` | \`position:fixed\` |
+| \`_sticky\` | \`position:sticky\` |
+| \`_inset0\` | \`inset:0\` |
+| \`_top0\`, \`_right0\`, \`_bottom0\`, \`_left0\` | edge positioning |
+| \`_z10\`-\`_z50\` | z-index scale |
+
+#### Grid
+| Atom | CSS |
+|------|-----|
+| \`_gc1\`-\`_gc12\` | \`grid-template-columns:repeat(N,...)\` |
+| \`_gr1\`-\`_gr6\` | \`grid-template-rows:repeat(N,...)\` |
+| \`_span1\`-\`_span12\`, \`_spanfull\` | column span |
+| \`_rowspan1\`-\`_rowspan6\` | row span |
+
+#### Visual
+| Atom | CSS |
+|------|-----|
+| \`_rounded\` | \`border-radius:var(--d-radius)\` |
+| \`_roundedfull\` | \`border-radius:9999px\` |
+| \`_roundedsm\`, \`_roundedlg\`, \`_roundedxl\` | radius variants |
+| \`_shadow\`, \`_shadowmd\`, \`_shadowlg\` | box-shadow presets |
+| \`_bordernone\` | \`border:none\` |
+| \`_bw{n}\` | \`border-width:{n}px\` |
+| \`_op0\`-\`_op100\` | opacity (0, 25, 50, 75, 100) |
+| \`_trans\` | \`transition:all 0.15s ease\` |
+| \`_visible\`, \`_invisible\` | visibility |
+
+Responsive prefixes: \`_sm:\`, \`_md:\`, \`_lg:\` (e.g. \`_md:gc2\`, \`_lg:gc4\`, \`_sm:flex\`).
+
+### Section Labels
+
+Use the d-label class for uppercase section headings.
+Anchor with a left accent border: \`border-left: 2px solid var(--d-accent); padding-left: 0.5rem\`.
+
+### Empty States
+
+Every data-driven section should handle zero-data gracefully.
+Pattern: centered 48px muted icon + descriptive message + optional CTA button.
+
+### Page Transitions
+
+If the theme provides motion tokens, apply the \`entrance-fade\` class to page content containers for smooth page-to-page transitions.
+
+### Navigation Shortcuts
+
+If the essence defines hotkeys or command_palette, implement as keyboard event listeners (useEffect + keydown) \u2014 not as visible UI text.
 
 ### Design Tokens
 
@@ -1583,23 +1770,24 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
     writeFileSync(tokensPath, generateTokensCSS(themeData, mode, spatialTokens));
   }
   const treatmentsPath = join(stylesDir, "treatments.css");
-  writeFileSync(treatmentsPath, generateTreatmentCSS(
+  let treatmentCSS = generateTreatmentCSS(
     spatialTokens,
     themeData?.treatments,
     themeData?.decorators,
     themeName
-  ));
+  );
+  const personalityCSS = generatePersonalityCSS(personality || [], themeData || {});
+  treatmentCSS += personalityCSS;
+  writeFileSync(treatmentsPath, treatmentCSS);
   const globalPath = join(stylesDir, "global.css");
   if (!existsSync(globalPath)) {
     writeFileSync(globalPath, generateGlobalCSS(personality));
   }
   const cssFiles = [tokensPath, treatmentsPath, globalPath];
-  const treatmentsMdPath = join(contextDir, "treatments.md");
-  writeFileSync(treatmentsMdPath, generateTreatmentsContext(themeData, themeName));
   const decantrMdPath = join(projectRoot, "DECANTR.md");
   writeFileSync(decantrMdPath, generateDecantrMdV31(guardMode, CSS_APPROACH_CONTENT));
   const hasSections = essence.blueprint.sections && essence.blueprint.sections.length > 0;
-  const contextFiles = [treatmentsMdPath];
+  const contextFiles = [];
   if (!hasSections) {
     const summaryPath = join(contextDir, "essence-summary.md");
     writeFileSync(summaryPath, generateEssenceSummaryV3(essence));
@@ -1648,7 +1836,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
                   const spec = {
                     description: inner.description || "",
                     components: inner.components || [],
-                    slots
+                    slots,
+                    layout_hints: inner.layout_hints
                   };
                   if (!spec.components || spec.components.length === 0) {
                     const syntheticComps = generateSyntheticComponents(name, spec.description);
@@ -1729,7 +1918,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
             shellInfoCache[shellId] = {
               description: inner.description || "",
               regions: inner.config?.regions || [],
-              layout: inner.layout || void 0
+              layout: inner.layout || void 0,
+              guidance: inner.guidance || void 0
             };
           }
         } catch {
@@ -1827,7 +2017,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
                 const spec = {
                   description: inner.description || "",
                   components: inner.components || [],
-                  slots
+                  slots,
+                  layout_hints: inner.layout_hints
                 };
                 if (!spec.components || spec.components.length === 0) {
                   const syntheticComps = generateSyntheticComponents(name, spec.description);
@@ -1881,7 +2072,8 @@ async function refreshDerivedFiles(projectRoot, essence, registry, prefetchedThe
         v30ShellInfo = {
           description: inner.description || "",
           regions: inner.config?.regions || [],
-          layout: inner.layout || void 0
+          layout: inner.layout || void 0,
+          guidance: inner.guidance || void 0
         };
       }
     } catch {
@@ -2015,6 +2207,15 @@ function generateSectionContext(input) {
     }
   }
   lines.push("");
+  if (shellInfo?.guidance && Object.keys(shellInfo.guidance).length > 0) {
+    lines.push(`## Shell Notes (${section.shell})`);
+    lines.push("");
+    for (const [key, value] of Object.entries(shellInfo.guidance)) {
+      const label = key.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+      lines.push(`- **${label}:** ${value}`);
+    }
+    lines.push("");
+  }
   lines.push("---");
   lines.push("");
   lines.push(`**Guard:** ${guardConfig.mode} mode | DNA violations = ${guardConfig.dna_enforcement} | Blueprint violations = ${guardConfig.blueprint_enforcement}`);
@@ -2039,6 +2240,10 @@ function generateSectionContext(input) {
     }
     lines.push("");
   }
+  const themePrefix = themeName.split("-")[0] || themeName;
+  lines.push("");
+  lines.push(`Usage: \`className={css('_flex _col _gap4') + ' d-surface ${themePrefix}-glass'}\` \u2014 atoms via css(), treatments and theme decorators as plain class strings.`);
+  lines.push("");
   lines.push("---");
   lines.push("");
   if (zoneContext) {
@@ -2091,6 +2296,12 @@ function generateSectionContext(input) {
       for (const [slot, desc] of Object.entries(spec.slots)) {
         lines.push(`- \`${slot}\`: ${desc}`);
       }
+      if (spec.layout_hints && Object.keys(spec.layout_hints).length > 0) {
+        lines.push(`  **Layout guidance:**`);
+        for (const [key, value] of Object.entries(spec.layout_hints)) {
+          lines.push(`  - ${key}: ${value}`);
+        }
+      }
       lines.push("");
     }
     lines.push("---");

package/dist/index.js

@@ -1,2 +1,2 @@
-import "./chunk-D3W3MYKT.js";
-import "./chunk-T7CQSJGV.js";
+import "./chunk-G77ADKWE.js";
+import "./chunk-VKWRNLHR.js";

package/dist/{upgrade-TXVD2WIN.js → upgrade-6MKC6EDQ.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.5.4",
+  "version": "1.5.6",
   "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
   "license": "MIT",
   "repository": {

package/src/templates/task-scaffold.md.template

@@ -1,66 +1,12 @@
 # Task Context: Scaffolding
 
-**Enforcement Tier: Creative**
-
-You are scaffolding a new Decantr project. Guard rules are advisory only during initial scaffolding.
-
----
-
-## Your Task
-
-Generate the initial project structure based on the essence specification.
-
-## Rules (Advisory)
-
-During scaffolding, the following rules are recommendations, not requirements:
-
-| # | Layer | Rule | Status | Guidance |
-|---|-------|------|--------|----------|
-| 1 | DNA | Style | Advisory | Use the theme from essence, but creative variations are acceptable |
-| 2 | DNA | Density | Advisory | Follow spacing guidelines loosely |
-| 4 | DNA | Accessibility | Advisory | Meet WCAG level from essence where possible |
-| 5 | DNA | Theme-mode | Advisory | Use the specified theme/mode combination |
-| 6 | Blueprint | Structure | Advisory | Follow the page structure, add placeholder content |
-| 7 | Blueprint | Layout | Advisory | Use suggested patterns, order can be adjusted |
-| 8 | Blueprint | Pattern-exists | Advisory | Use patterns that exist in the registry |
-
-## Checklist
-
-Before scaffolding:
-
-- [ ] Read `decantr.essence.json`
-- [ ] Understand the target framework ({{TARGET}})
-- [ ] Know the theme ({{THEME_STYLE}}) and mode ({{THEME_MODE}})
-- [ ] Review the page structure
-
-During scaffolding:
-
-- [ ] Create the shell layout ({{DEFAULT_SHELL}})
-- [ ] Generate pages from `blueprint.pages[]`
-- [ ] Add pattern placeholders for each page's `layout[]`
-- [ ] Apply theme colors and typography
-- [ ] Set up routing based on page IDs
-
-After scaffolding:
-
-- [ ] Run `npx @decantr/cli validate` to check the essence
-- [ ] Verify each page renders correctly
-- [ ] Check theme consistency across pages
+**Enforcement Tier: Creative** — Guard rules are advisory during initial scaffolding.
 
 ## What to Generate
 
 {{SCAFFOLD_STRUCTURE}}
 
-## Next Steps
-
-After scaffolding is complete:
-
-1. Run the development server
-2. Verify all pages load
-3. Check theme consistency
-4. Run `npx @decantr/cli validate`
-
-Once verified, subsequent changes will use **{{GUARD_MODE}}** enforcement mode.
+Post-scaffold enforcement mode: **{{GUARD_MODE}}**.
 
 ---