@decantr/cli 1.7.0 → 1.7.4

package/dist/bin.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import "./chunk-RQUIYILX.js";
-import "./chunk-X4RHL7WQ.js";
+import "./chunk-Y5C2O7Z7.js";
+import "./chunk-XKXUVNUQ.js";

package/dist/{chunk-X4RHL7WQ.js → chunk-XKXUVNUQ.js}

@@ -1147,7 +1147,29 @@ Routes are defined in \`decantr.essence.json\` \u2192 \`blueprint.routes\` and l
 2. **Shell regions are frames, not surfaces.** Sidebar and header use var(--d-surface) or var(--d-bg) directly. Apply d-surface only to content cards within the body region.
 3. **One scroll container per region.** Body has overflow-y-auto. Sidebar nav has its own overflow-y-auto. Never nest additional scrollable wrappers.
 4. **d-section spacing is self-contained.** Each d-section owns its padding. The d-section + d-section rule adds a separator. Do NOT add extra margin between adjacent sections.
-5. **Responsive nav rules.** Hamburger menus appear ONLY below the shell collapse breakpoint. Full nav shows above it.`;
+5. **Responsive nav rules.** Hamburger menus appear ONLY below the shell collapse breakpoint. Full nav shows above it.
+
+### Motion Philosophy
+
+Every interaction should feel responsive and polished. Apply motion by default, not as an afterthought:
+
+- **Page transitions:** Apply entrance-fade (or the personality entrance animation) to the main content area on route change
+- **Stagger children:** Lists, grids, and card groups should stagger-animate on mount (50-100ms delay per item)
+- **Data visualization:** Charts, gauges, progress bars, and counters should animate to their values on mount \u2014 never render static
+- **Micro-interactions:** All interactive elements (buttons, toggles, cards, nav items) need hover/press transitions. Use the motion tokens (--d-duration-hover, --d-easing) for consistency.
+- **Scroll reveals:** Sections below the fold should fade-in on scroll intersection (IntersectionObserver, once)
+- **Reduced motion:** Wrap all animations in \`prefers-reduced-motion\` media query \u2014 skip animation, keep state changes instant
+
+### Interactivity Philosophy
+
+Build for wow factor. When a pattern describes a canvas, graph, map, or spatial visualization, implement it as a **fully interactive surface**, not a static illustration:
+
+- **Drag and drop:** Nodes, cards, and items on spatial canvases should be draggable. Use pointer events with proper grab/grabbing cursors.
+- **Pan and zoom:** Canvases and large visualizations should support pan (click-drag on background) and zoom (scroll wheel or pinch). Show zoom level indicator.
+- **Connections:** When nodes exist in a graph/topology view, they should have visible connection lines. Implement click-to-select + click-target for connecting nodes.
+- **Live state:** Data-driven visualizations should update in real-time with simulated data. Status changes should animate (color transitions, pulse effects).
+- **Direct manipulation:** Prefer drag-to-reorder over dropdown menus. Prefer inline editing over modal forms. Prefer resize handles over fixed layouts.
+- **Hover reveals:** Show contextual information (tooltips, expanded cards, action menus) on hover \u2014 don't require clicks to discover functionality.`;
 function generateDecantrMdV31(params) {
   const template = loadTemplate("DECANTR.md.template");
   const body = renderTemplate(template, {
@@ -1191,6 +1213,29 @@ function generateDecantrMdV31(params) {
     }
     briefLines.push("");
   }
+  briefLines.push("## Development Workflow");
+  briefLines.push("");
+  briefLines.push("The essence file (`decantr.essence.json`) is the source of truth for your project's structure. Context files in `.decantr/context/` are derived from it. When you need to add, remove, or modify pages, sections, or features:");
+  briefLines.push("");
+  briefLines.push("**1. Update the essence** (use CLI commands for consistency):");
+  briefLines.push("- `decantr add page {section}/{page} --route /{path}`");
+  briefLines.push("- `decantr add section {archetype}`");
+  briefLines.push("- `decantr add feature {name}` (or `--section {id}` for scoped)");
+  briefLines.push("- `decantr remove page {section}/{page}`");
+  briefLines.push("- `decantr remove section {id}`");
+  briefLines.push("- `decantr remove feature {name}`");
+  briefLines.push("- `decantr theme switch {name}`");
+  briefLines.push("");
+  briefLines.push("**2. Regenerate context:** `decantr refresh`");
+  briefLines.push("");
+  briefLines.push("**3. Read the updated context files**, then build.");
+  briefLines.push("");
+  briefLines.push("**Rules:**");
+  briefLines.push("- Never create page components for routes that don't exist in the essence");
+  briefLines.push("- Never delete pages without removing them from the essence");
+  briefLines.push("- Always refresh after mutations \u2014 stale context files lead to drift");
+  briefLines.push("- If you edit the essence directly, run `decantr refresh` before building");
+  briefLines.push("");
   briefLines.push("---");
   briefLines.push("");
   return briefLines.join("\n") + body;
@@ -2557,6 +2602,15 @@ function generateScaffoldContext(input) {
     if (input.voice.metrics_format) lines.push(`**Metrics format:** ${input.voice.metrics_format}`);
     lines.push("");
   }
+  lines.push("## Development Mode");
+  lines.push("");
+  lines.push("For local development and showcases, wire all zone transitions with mock data:");
+  lines.push("");
+  lines.push("- **Auth bypass:** Auth pages should accept any input and redirect to the primary section's default route");
+  lines.push("- **Route guards:** Check a simple localStorage flag (e.g., `decantr_authenticated`). Login sets it \u2192 redirect to app zone entry. Logout clears it \u2192 redirect to public/gateway zone.");
+  lines.push("- **Mock data on every page:** All pages should render with simulated data on first load \u2014 never show empty states during development");
+  lines.push("- **Zone transitions:** CTA links on marketing pages should route to the gateway (login/register). Successful auth should route to the primary section default page.");
+  lines.push("");
   lines.push(topologyMarkdown);
   lines.push("");
   lines.push("## Sections Overview");

package/dist/{chunk-RQUIYILX.js → chunk-Y5C2O7Z7.js}

@@ -9,7 +9,7 @@ import {
   scaffoldMinimal,
   scaffoldProject,
   syncRegistry
-} from "./chunk-X4RHL7WQ.js";
+} from "./chunk-XKXUVNUQ.js";
 
 // src/index.ts
 import { readFileSync as readFileSync15, existsSync as existsSync23, readdirSync as readdirSync6 } from "fs";
@@ -3299,48 +3299,16 @@ function extractPatternName(item) {
 }
 function generateCuratedPrompt(ctx) {
   const lines = [];
-  lines.push(`I'm building a ${ctx.archetype} application using ${ctx.target}.`);
+  lines.push("Build this application using the Decantr design system.");
   lines.push("");
-  if (ctx.blueprint) {
-    lines.push(`Blueprint: ${ctx.blueprint}`);
-  }
-  lines.push(`Theme: ${ctx.theme} (${ctx.mode} mode)`);
-  lines.push(`Personality: ${ctx.personality.join(", ")}`);
-  lines.push(`Guard mode: ${ctx.guard}`);
-  lines.push("");
-  lines.push("Pages to build:");
-  for (const page of ctx.pages) {
-    const patternNames = page.layout.map(extractPatternName);
-    const patterns = patternNames.length > 0 ? patternNames.join(", ") : "custom";
-    lines.push(`  - ${page.id}: ${page.shell} shell with ${patterns}`);
-  }
-  if (ctx.features.length > 0) {
-    lines.push("");
-    lines.push(`Features: ${ctx.features.join(", ")}`);
-  }
+  lines.push("Read DECANTR.md for the design spec, CSS approach, and guard rules.");
+  lines.push("Read .decantr/context/scaffold.md for the app overview, topology, routes, and voice guidance.");
+  lines.push("Read each .decantr/context/section-*.md file before building that section's pages.");
+  lines.push("Import src/styles/global.css, src/styles/tokens.css, and src/styles/treatments.css.");
   lines.push("");
-  lines.push("Please read DECANTR.md for the full design spec and methodology.");
-  lines.push("Follow the guard rules and use the patterns from decantr.essence.json.");
+  lines.push("Start with the shell layouts, then build each section's pages.");
   return lines.join("\n");
 }
-function boxedPrompt(content, title) {
-  const lines = content.split("\n");
-  const maxLen = Math.max(...lines.map((l) => l.length), title.length + 4);
-  const width = maxLen + 4;
-  const top = `\u250C${"\u2500".repeat(width - 2)}\u2510`;
-  const titleLine = `\u2502 ${BOLD6}${title}${RESET13}${" ".repeat(width - title.length - 4)} \u2502`;
-  const sep2 = `\u251C${"\u2500".repeat(width - 2)}\u2524`;
-  const bottom = `\u2514${"\u2500".repeat(width - 2)}\u2518`;
-  const body = lines.map((line) => {
-    const padding = " ".repeat(width - line.length - 4);
-    return `\u2502 ${line}${padding} \u2502`;
-  }).join("\n");
-  return `${top}
-${titleLine}
-${sep2}
-${body}
-${bottom}`;
-}
 function getAPIClient() {
   return new RegistryAPIClient3({
     baseUrl: process.env.DECANTR_API_URL || void 0,
@@ -3895,7 +3863,13 @@ Validation warnings: ${validation.errors.join(", ")}`));
     guard: options.guard
   };
   const curatedPrompt = generateCuratedPrompt(promptCtx);
-  console.log(boxedPrompt(curatedPrompt, "Copy this prompt for your AI assistant"));
+  console.log("");
+  console.log(`${BOLD6}Prompt for your AI assistant:${RESET13}`);
+  console.log(dim3("\u2500".repeat(50)));
+  console.log("");
+  console.log(curatedPrompt);
+  console.log("");
+  console.log(dim3("\u2500".repeat(50)));
   console.log("");
   if (registrySource === "cache") {
     console.log(dim3('Run "decantr sync" when online to get the latest registry content.'));
@@ -4332,7 +4306,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-2KX7BKEK.js");
+      const { cmdUpgrade } = await import("./upgrade-GTUGOUSD.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;

package/dist/index.js

@@ -1,2 +1,2 @@
-import "./chunk-RQUIYILX.js";
-import "./chunk-X4RHL7WQ.js";
+import "./chunk-Y5C2O7Z7.js";
+import "./chunk-XKXUVNUQ.js";

package/dist/{upgrade-2KX7BKEK.js → upgrade-GTUGOUSD.js}

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

package/package.json

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