@decantr/cli 2.4.0 → 2.4.1

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-H6TIXG5K.js";
-import "./chunk-PEGMSXDJ.js";
+import "./chunk-6BRD6DTB.js";
+import "./chunk-P4NUDLWB.js";
 import "./chunk-IEW2QFYI.js";

package/dist/{chunk-H6TIXG5K.js → chunk-6BRD6DTB.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-PEGMSXDJ.js";
+} from "./chunk-P4NUDLWB.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -5624,6 +5624,7 @@ function extractPatternName(item) {
 function generateGreenfieldPrompt(ctx) {
   const lines = [];
   const usesDecantrCss = ctx.adoptionMode === "decantr-css" || !ctx.adoptionMode;
+  const hasCompiledPacks = ctx.hasCompiledPacks ?? true;
   lines.push("Build this greenfield application using the Decantr design system.");
   lines.push("");
   if (ctx.blueprint) lines.push(`Blueprint: ${ctx.blueprint}`);
@@ -5640,44 +5641,66 @@ function generateGreenfieldPrompt(ctx) {
     "This workspace is a new Decantr scaffold. Use the contract to create or extend the runtime deliberately, not to reverse-engineer a hidden starter."
   );
   lines.push("");
-  lines.push("Treat the compiled execution-pack files as the primary source of truth.");
-  lines.push(
-    "Use narrative docs only as secondary explanation when the compiled packs are not enough."
-  );
+  if (hasCompiledPacks) {
+    lines.push("Treat the compiled execution-pack files as the primary source of truth.");
+    lines.push(
+      "Use narrative docs only as secondary explanation when the compiled packs are not enough."
+    );
+  } else {
+    lines.push(
+      "Compiled execution-pack files are not present in this scaffold. Treat narrative Decantr context as the temporary source of truth and run `decantr refresh` after fixing the reported validation issue."
+    );
+  }
   lines.push(
     "Use only files present in this workspace as the source of truth. If local scaffold files disagree, stop and report the mismatch instead of relying on external Decantr assumptions or prior examples."
   );
   lines.push("");
   lines.push("Read in this order:");
-  lines.push(
-    "1. .decantr/context/scaffold-pack.md \u2014 the canonical compiled contract. Contains route plan, shell layouts, navigation, Required Theme Decorators, and project-wide execution rules."
-  );
-  lines.push(
-    "2. Before section work, read the matching .decantr/context/section-*-pack.md first, then .decantr/context/section-*.md only for extra slot/layout detail."
-  );
-  lines.push(
-    "3. Before route work, read the matching .decantr/context/page-*-pack.md file. Its pattern layout and interaction checklists are contract."
-  );
-  lines.push(
-    "4. .decantr/context/scaffold.md for broader topology, route map, and voice guidance after the compact packs are understood."
-  );
-  lines.push(
-    "5. DECANTR.md as a lookup reference for atoms, treatments, decorators, interaction implementations, and guard rules. Do not let narrative docs override compiled packs."
-  );
-  lines.push("");
-  lines.push("\u2550\u2550\u2550 INTERACTIONS ARE CONTRACT, NOT GUIDANCE \u2550\u2550\u2550");
-  lines.push("");
-  lines.push(
-    'Each page pack lists "Interactions (MUST implement each)" per pattern. Implement the actual behavior, not visible text saying it exists. Use DECANTR.md only to look up the canonical implementation shape when needed.'
-  );
-  lines.push(
-    "Examples: pointer handlers for dragging/panning, onWheel for zoom, onKeyDown + tabIndex for keyboard navigation, IntersectionObserver for scroll reveal, state updates for real-time indicators, and d-* motion classes where the contract calls for animation."
-  );
-  lines.push("");
-  lines.push(
-    "`decantr check --strict` fails when a declared interaction has no matching implementation."
-  );
-  lines.push("");
+  if (hasCompiledPacks) {
+    lines.push(
+      "1. .decantr/context/scaffold-pack.md \u2014 the canonical compiled contract. Contains route plan, shell layouts, navigation, Required Theme Decorators, and project-wide execution rules."
+    );
+    lines.push(
+      "2. Before section work, read the matching .decantr/context/section-*-pack.md first, then .decantr/context/section-*.md only for extra slot/layout detail."
+    );
+    lines.push(
+      "3. Before route work, read the matching .decantr/context/page-*-pack.md file. Its pattern layout and interaction checklists are contract."
+    );
+    lines.push(
+      "4. .decantr/context/scaffold.md for broader topology, route map, and voice guidance after the compact packs are understood."
+    );
+    lines.push(
+      "5. DECANTR.md as a lookup reference for atoms, treatments, decorators, interaction implementations, and guard rules. Do not let narrative docs override compiled packs."
+    );
+    lines.push("");
+    lines.push("\u2550\u2550\u2550 INTERACTIONS ARE CONTRACT, NOT GUIDANCE \u2550\u2550\u2550");
+    lines.push("");
+    lines.push(
+      'Each page pack lists "Interactions (MUST implement each)" per pattern. Implement the actual behavior, not visible text saying it exists. Use DECANTR.md only to look up the canonical implementation shape when needed.'
+    );
+    lines.push(
+      "Examples: pointer handlers for dragging/panning, onWheel for zoom, onKeyDown + tabIndex for keyboard navigation, IntersectionObserver for scroll reveal, state updates for real-time indicators, and d-* motion classes where the contract calls for animation."
+    );
+    lines.push("");
+    lines.push(
+      "`decantr check --strict` fails when a declared interaction has no matching implementation."
+    );
+    lines.push("");
+  } else {
+    lines.push(
+      "1. .decantr/context/scaffold.md for topology, route map, voice, and section inventory."
+    );
+    lines.push(
+      "2. The matching .decantr/context/section-*.md file before implementing each section."
+    );
+    lines.push(
+      "3. DECANTR.md for atoms, treatments, decorators, interaction shapes, and guard rules."
+    );
+    lines.push(
+      "4. Run `decantr refresh` and switch to compiled pack files once validation passes."
+    );
+    lines.push("");
+  }
   lines.push("\u2550\u2550\u2550 STYLING ADOPTION \u2550\u2550\u2550");
   lines.push("");
   if (ctx.adoptionMode === "contract-only") {
@@ -5764,12 +5787,18 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("");
   lines.push("\u2550\u2550\u2550 THEME DECORATOR CONTRACT \u2014 APPLY OR THE THEME DOES NOT LAND \u2550\u2550\u2550");
   lines.push("");
-  lines.push(
-    'Each theme ships namespaced decorator classes (`clean-card`, `lum-glass`, `carbon-canvas`, `paper-card`, etc.). Apply the scaffold-pack.md "Required Theme Decorators" as additive classes alongside d-* treatments so the theme lands as more than token colors.'
-  );
-  lines.push(
-    "Section packs may point back to the scaffold-pack table; scaffold-pack.md is authoritative."
-  );
+  if (hasCompiledPacks) {
+    lines.push(
+      'Each theme ships namespaced decorator classes (`clean-card`, `lum-glass`, `carbon-canvas`, `paper-card`, etc.). Apply the scaffold-pack.md "Required Theme Decorators" as additive classes alongside d-* treatments so the theme lands as more than token colors.'
+    );
+    lines.push(
+      "Section packs may point back to the scaffold-pack table; scaffold-pack.md is authoritative."
+    );
+  } else {
+    lines.push(
+      "Each theme ships namespaced decorator classes (`clean-card`, `lum-glass`, `carbon-canvas`, `paper-card`, etc.). Use DECANTR.md and section context to apply the theme, then rerun `decantr refresh` to restore the authoritative decorator table."
+    );
+  }
   lines.push("");
   lines.push("\u2550\u2550\u2550 HARD RULES (NON-NEGOTIABLE) \u2550\u2550\u2550");
   lines.push("");
@@ -5790,7 +5819,7 @@ function generateGreenfieldPrompt(ctx) {
     "- Use lucide-react for ALL iconography (already in package.json). Pick semantic icons (Bot, Activity, Database, Search) over generic ones. Do NOT inline SVGs for icons that have Lucide equivalents."
   );
   lines.push(
-    "- Section Directives in section packs are execution rules for layout proportions, treatment stacks, copy conventions, and pattern fitness."
+    hasCompiledPacks ? "- Section Directives in section packs are execution rules for layout proportions, treatment stacks, copy conventions, and pattern fitness." : "- Section context files are execution rules for layout proportions, treatment stacks, copy conventions, and pattern fitness until compiled packs are restored."
   );
   lines.push(
     "- Filter chip rows / tab strips use `d-step-chip[data-step-state]`, not bare `d-interactive` buttons."
@@ -5804,9 +5833,11 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("");
   lines.push("\u2550\u2550\u2550 IMPLEMENTATION RULES \u2550\u2550\u2550");
   lines.push(
-    "- Do not invent routes, sections, shells, themes, or features beyond the compiled packs."
+    hasCompiledPacks ? "- Do not invent routes, sections, shells, themes, or features beyond the compiled packs." : "- Do not invent routes, sections, shells, themes, or features beyond decantr.essence.json and generated narrative context."
+  );
+  lines.push(
+    hasCompiledPacks ? "- Prefer scaffold-pack, section-pack, and page-pack guidance over narrative docs." : "- Prefer decantr.essence.json and generated section context over assumptions from prior examples."
   );
-  lines.push("- Prefer scaffold-pack, section-pack, and page-pack guidance over narrative docs.");
   lines.push(
     "- Start with the shell layouts and route structure first, then build section pages route by route."
   );
@@ -5850,7 +5881,9 @@ function generateGreenfieldPrompt(ctx) {
   lines.push("");
   lines.push("\u2550\u2550\u2550 EXECUTION FLOW \u2550\u2550\u2550");
   lines.push("- Build the shell and shared layout first.");
-  lines.push("- Then implement each section's pages using the matching section and page packs.");
+  lines.push(
+    hasCompiledPacks ? "- Then implement each section's pages using the matching section and page packs." : "- Then implement each section's pages using decantr.essence.json and the matching section context."
+  );
   lines.push(
     "- After implementation, run `decantr check` (primary gate) and `decantr audit` (supplementary diagnostics)."
   );
@@ -7353,19 +7386,34 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET14}`);
       )
     );
   }
+  const hasCompiledPacks = existsSync26(join27(projectRoot, ".decantr", "context", "scaffold-pack.md"));
   console.log("");
   console.log("  Next steps:");
-  console.log(
-    "    1. Read .decantr/context/scaffold-pack.md first as the primary compiled contract"
-  );
-  console.log(
-    "    2. Read .decantr/context/scaffold.md for broader topology, route map, and voice guidance"
-  );
-  console.log("    3. Read the matching section and page packs before implementing each route");
-  console.log("    4. Use DECANTR.md as a lookup reference for atoms, treatments, and guard rules");
-  console.log("    5. Build the shell and route structure first, then implement the pages");
-  console.log("    6. Run decantr check and decantr audit after implementation");
-  console.log("    7. Explore more at decantr.ai/registry");
+  if (hasCompiledPacks) {
+    console.log(
+      "    1. Read .decantr/context/scaffold-pack.md first as the primary compiled contract"
+    );
+    console.log(
+      "    2. Read .decantr/context/scaffold.md for broader topology, route map, and voice guidance"
+    );
+    console.log("    3. Read the matching section and page packs before implementing each route");
+    console.log(
+      "    4. Use DECANTR.md as a lookup reference for atoms, treatments, and guard rules"
+    );
+    console.log("    5. Build the shell and route structure first, then implement the pages");
+    console.log("    6. Run decantr check and decantr audit after implementation");
+    console.log("    7. Explore more at decantr.ai/registry");
+  } else {
+    console.log("    1. Fix the validation issue reported above");
+    console.log("    2. Run decantr refresh to restore compiled execution packs");
+    console.log(
+      "    3. Until packs exist, read .decantr/context/scaffold.md and section context files"
+    );
+    console.log(
+      "    4. Use DECANTR.md as a lookup reference for atoms, treatments, and guard rules"
+    );
+    console.log("    5. Run decantr check and decantr audit after implementation");
+  }
   console.log("");
   console.log("  Commands:");
   console.log(`    ${cyan3("decantr status")}     Project health`);
@@ -7416,7 +7464,8 @@ Validation warnings: ${validation.errors.join(", ")}`));
     pages: promptPages,
     personality: options.personality,
     features: options.features,
-    guard: options.guard
+    guard: options.guard,
+    hasCompiledPacks
   };
   const curatedPrompt = generateCuratedPrompt(promptCtx);
   console.log("");
@@ -8178,7 +8227,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-XTTGHFG7.js");
+      const { cmdUpgrade } = await import("./upgrade-HSPWYROM.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/{chunk-PEGMSXDJ.js → chunk-P4NUDLWB.js}

@@ -3969,6 +3969,44 @@ function buildFlagsString(options) {
   }
   return flags.join(" ");
 }
+function serializeConstraintValue(value) {
+  if (value === void 0 || value === null) return void 0;
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function normalizeBlueprintDesignConstraints(designConstraints) {
+  if (!designConstraints || typeof designConstraints !== "object" || Array.isArray(designConstraints)) {
+    return void 0;
+  }
+  const constraints = {};
+  const effects = {};
+  for (const [key, value] of Object.entries(designConstraints)) {
+    if (key === "effects" && value && typeof value === "object" && !Array.isArray(value)) {
+      for (const [effectKey, effectValue] of Object.entries(value)) {
+        const serialized2 = serializeConstraintValue(effectValue);
+        if (serialized2) effects[effectKey] = serialized2;
+      }
+      continue;
+    }
+    const serialized = serializeConstraintValue(value);
+    if (!serialized) continue;
+    if (key === "mode" && typeof value === "string") constraints.mode = value;
+    else if (key === "typography" && typeof value === "string") constraints.typography = value;
+    else if (key === "borders" && typeof value === "string") constraints.borders = value;
+    else if (key === "corners" && typeof value === "string") constraints.corners = value;
+    else if (key === "shadows" && typeof value === "string") constraints.shadows = value;
+    else effects[key] = serialized;
+  }
+  if (Object.keys(effects).length > 0) {
+    constraints.effects = effects;
+  }
+  return Object.keys(constraints).length > 0 ? constraints : void 0;
+}
 function generateTaskContextV4(templateName, essence) {
   const template = loadTemplate(templateName);
   const sections = essence.blueprint.sections;
@@ -4226,8 +4264,11 @@ async function scaffoldProject(projectRoot, options, detected, registry, archety
     if (blueprintData?.personality?.length) {
       essenceV4.dna.personality = typeof blueprintData.personality === "string" ? [blueprintData.personality] : blueprintData.personality;
     }
-    if (blueprintData?.design_constraints) {
-      essenceV4.dna.constraints = blueprintData.design_constraints;
+    const normalizedDesignConstraints = normalizeBlueprintDesignConstraints(
+      blueprintData?.design_constraints
+    );
+    if (normalizedDesignConstraints) {
+      essenceV4.dna.constraints = normalizedDesignConstraints;
     }
     if (blueprintData?.seo_hints) {
       essenceV4.meta.seo = blueprintData.seo_hints;

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-H6TIXG5K.js";
-import "./chunk-PEGMSXDJ.js";
+import "./chunk-6BRD6DTB.js";
+import "./chunk-P4NUDLWB.js";
 import "./chunk-IEW2QFYI.js";

package/dist/{upgrade-XTTGHFG7.js → upgrade-HSPWYROM.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "keywords": [
     "decantr",
@@ -48,9 +48,9 @@
   },
   "dependencies": {
     "ajv": "^8.20.0",
+    "@decantr/core": "2.1.0",
     "@decantr/registry": "2.0.0",
     "@decantr/essence-spec": "2.0.1",
-    "@decantr/core": "2.1.0",
     "@decantr/telemetry": "2.2.1",
     "@decantr/verifier": "2.1.0"
   },