@decantr/cli 1.7.4 → 1.7.6

package/dist/chunk-KUDAVJOR.js

@@ -0,0 +1,46 @@
+// src/guard-context.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { join } from "path";
+function loadJsonEntries(dir) {
+  if (!existsSync(dir)) return [];
+  try {
+    return readdirSync(dir).filter((file) => file.endsWith(".json") && file !== "index.json").map((file) => JSON.parse(readFileSync(join(dir, file), "utf-8")));
+  } catch {
+    return [];
+  }
+}
+function buildGuardRegistryContext(projectRoot = process.cwd()) {
+  const themeRegistry = /* @__PURE__ */ new Map();
+  const patternRegistry = /* @__PURE__ */ new Map();
+  const cacheDir = join(projectRoot, ".decantr", "cache");
+  const customDir = join(projectRoot, ".decantr", "custom");
+  for (const data of loadJsonEntries(join(cacheDir, "@official", "themes"))) {
+    if (typeof data.id === "string" && !themeRegistry.has(data.id)) {
+      themeRegistry.set(data.id, {
+        modes: Array.isArray(data.modes) ? data.modes.filter((mode) => typeof mode === "string") : ["light", "dark"]
+      });
+    }
+  }
+  for (const data of loadJsonEntries(join(customDir, "themes"))) {
+    if (typeof data.id === "string") {
+      themeRegistry.set(`custom:${data.id}`, {
+        modes: Array.isArray(data.modes) ? data.modes.filter((mode) => typeof mode === "string") : ["light", "dark"]
+      });
+    }
+  }
+  for (const data of loadJsonEntries(join(cacheDir, "@official", "patterns"))) {
+    if (typeof data.id === "string" && !patternRegistry.has(data.id)) {
+      patternRegistry.set(data.id, data);
+    }
+  }
+  for (const data of loadJsonEntries(join(customDir, "patterns"))) {
+    if (typeof data.id === "string") {
+      patternRegistry.set(data.id, data);
+    }
+  }
+  return { themeRegistry, patternRegistry };
+}
+
+export {
+  buildGuardRegistryContext
+};

package/dist/{heal-VYEGIUAS.js → heal-MURR3RVQ.js}

@@ -1,3 +1,7 @@
+import {
+  buildGuardRegistryContext
+} from "./chunk-KUDAVJOR.js";
+
 // src/commands/heal.ts
 import { readFileSync as readFileSync2, existsSync as existsSync2 } from "fs";
 import { join as join2 } from "path";
@@ -8,7 +12,7 @@ import { readFileSync, writeFileSync, existsSync } from "fs";
 import { join } from "path";
 var TELEMETRY_ENDPOINT = "https://api.decantr.ai/v1/telemetry/guard";
 var TELEMETRY_TIMEOUT_MS = 3e3;
-var DNA_RULES = /* @__PURE__ */ new Set(["style", "density", "accessibility", "theme-mode"]);
+var DNA_RULES = /* @__PURE__ */ new Set(["theme", "style", "density", "accessibility", "theme-mode"]);
 async function sendGuardMetrics(metrics) {
   try {
     const controller = new AbortController();
@@ -77,7 +81,7 @@ function collectMetrics(essence, issues) {
     resolution_rate: 0,
     sections_count: sections.length,
     routes_count: Object.keys(routes).length,
-    theme: theme.style ?? "unknown"
+    theme: theme.id ?? "unknown"
   };
 }
 
@@ -109,7 +113,7 @@ async function cmdHeal(projectRoot = process.cwd(), options = {}) {
     }
   }
   try {
-    const violations = evaluateGuard(essence, { themeRegistry: /* @__PURE__ */ new Map(), patternRegistry: /* @__PURE__ */ new Map() });
+    const violations = evaluateGuard(essence, buildGuardRegistryContext(projectRoot));
     for (const v of violations) {
       issues.push({
         type: v.severity === "error" ? "error" : "warning",

package/dist/index.js

@@ -1,2 +1,3 @@
-import "./chunk-Y5C2O7Z7.js";
-import "./chunk-XKXUVNUQ.js";
+import "./chunk-KAEQTVAM.js";
+import "./chunk-H4H3IQJK.js";
+import "./chunk-KUDAVJOR.js";

package/dist/{upgrade-GTUGOUSD.js → upgrade-XNUAON3G.js}

@@ -1,7 +1,7 @@
 import {
   RegistryClient,
   refreshDerivedFiles
-} from "./chunk-XKXUVNUQ.js";
+} from "./chunk-H4H3IQJK.js";
 
 // src/commands/upgrade.ts
 import { readFileSync, writeFileSync, existsSync } from "fs";
@@ -26,22 +26,20 @@ async function cmdUpgrade(projectRoot = process.cwd(), options = {}) {
   });
   console.log("Checking for updates...\n");
   const upgrades = [];
-  const themeStyle = essence.dna?.theme?.style || essence.theme?.style;
-  if (themeStyle) {
-    const theme = await client.fetchTheme(themeStyle);
+  const themeId = essence.dna?.theme?.id || essence.theme?.id;
+  if (themeId) {
+    const theme = await client.fetchTheme(themeId);
     if (theme) {
-      const themeData = theme.data;
-      const inner = themeData.data ?? themeData;
-      const latestVersion = inner.version || themeData.version;
+      const latestVersion = theme.data.version;
       if (latestVersion) {
         const current = essence.dna?.theme?.version || essence.theme?.version || "0.0.0";
         if (latestVersion !== current) {
           upgrades.push({
             type: "theme",
-            id: themeStyle,
+            id: themeId,
             currentVersion: current,
             latestVersion,
-            data: themeData
+            data: theme.data
           });
         }
       }
@@ -50,9 +48,7 @@ async function cmdUpgrade(projectRoot = process.cwd(), options = {}) {
   if (essence.blueprint && typeof essence.blueprint === "string") {
     const blueprint = await client.fetchBlueprint(essence.blueprint);
     if (blueprint) {
-      const bpData = blueprint.data;
-      const inner = bpData.data ?? bpData;
-      const latestVersion = inner.version || bpData.version;
+      const latestVersion = blueprint.data.version;
       if (latestVersion) {
         const current = essence.blueprintVersion || "0.0.0";
         if (latestVersion !== current) {
@@ -61,7 +57,7 @@ async function cmdUpgrade(projectRoot = process.cwd(), options = {}) {
             id: essence.blueprint,
             currentVersion: current,
             latestVersion,
-            data: bpData
+            data: blueprint.data
           });
         }
       }

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "@decantr/cli",
-  "version": "1.7.4",
-  "description": "Decantr CLI — search the registry, validate essence files, and access design intelligence from the terminal",
+  "version": "1.7.6",
+  "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
+  "author": "Decantr AI",
   "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/decantr-ai/decantr/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/decantr-ai/decantr.git",
+    "url": "git+https://github.com/decantr-ai/decantr.git",
     "directory": "packages/cli"
   },
   "homepage": "https://decantr.ai",
   "type": "module",
   "bin": {
-    "decantr": "./dist/bin.js"
+    "decantr": "dist/bin.js"
   },
   "main": "dist/index.js",
   "files": [
@@ -23,8 +27,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@decantr/essence-spec": "1.0.0-beta.11",
-    "@decantr/registry": "1.0.0-beta.12"
+    "@decantr/core": "1.0.0",
+    "@decantr/essence-spec": "1.0.0",
+    "@decantr/registry": "1.0.1",
+    "@decantr/verifier": "1.0.1"
   },
   "scripts": {
     "build": "tsup",

package/src/templates/DECANTR.md.template

@@ -68,6 +68,11 @@ When a user request would violate guard rules:
 - `decantr_check_drift` -- Check if planned changes violate rules
 - `decantr_accept_drift` -- Accept a detected drift as intentional
 - `decantr_update_essence` -- Update the essence spec to match desired changes
+- `decantr_audit_project` -- Audit the current project against the essence contract and compiled packs
+- `decantr_get_scaffold_context` -- Read the top-level scaffold task, scaffold overview, compiled scaffold pack, and review pack together
+- `decantr_get_page_context` -- Read a route-local page pack together with its parent section context when available
+- `decantr_get_execution_pack` -- Read compiled scaffold, review, mutation, section, and page packs
+- `decantr_get_section_context` -- Read the richer section context with compiled pack data when available
 
 ---
 
@@ -79,15 +84,38 @@ When a user request would violate guard rules:
 
 ### Initial scaffolding
 
-Read `.decantr/context/scaffold.md` for the full app overview, topology, and route map.
+Treat the compiled execution-pack files as the primary source of truth.
+Use narrative docs only as secondary explanation when the compiled packs are not enough.
+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.
+
+Read `.decantr/context/scaffold-pack.md` first for the compact compiled shell, theme, feature, and route contract.
+Then read `.decantr/context/scaffold.md` for the fuller app overview, topology, route map, and voice guidance.
+Start implementation from the shell layouts and shared route structure before filling in section pages.
 
 ### Working on a section
 
-Read `.decantr/context/section-{name}.md` for that section's complete context. Each section file contains guard rules, theme tokens, decorator classes, pattern specs with code examples, zone context, and routes. **Everything you need is in that one file.**
+Read `.decantr/context/section-{name}-pack.md` for the compact compiled section contract.
+Then read `.decantr/context/section-{name}.md` for the fuller context. Prefer the compiled section pack if the two sources differ, and do not invent section features, shells, or themes that are not present in the compiled contract.
+
+### Working on a route
+
+Read `.decantr/context/page-{name}-pack.md` for the most local compiled route contract before editing a specific page. Route-local packs should win over broader narrative docs when there is any mismatch.
+
+### Editing rules
+
+- Use the real `@decantr/css` runtime for atoms. If `package.json` does not already include `@decantr/css`, add it before implementation.
+- If a local `package.json` is present, trust its declared Decantr dependencies over external assumptions about package availability.
+- Do **not** create local atom-runtime substitutes such as `src/lib/css.js`, `src/lib/css.ts`, or hand-written `src/styles/atoms.css` files unless the task explicitly asks for a fallback runtime.
+- Import `src/styles/global.css`, `src/styles/tokens.css`, and `src/styles/treatments.css`.
+- Reuse the existing Decantr tokens, treatments, and decorators instead of inventing a new visual system.
+- If `dna.accessibility.skip_nav = true`, add a visible-on-focus skip link and a matching main landmark target such as `<main id="main-content">`.
+- If `dna.motion.reduce_motion = true`, add an explicit `prefers-reduced-motion: reduce` path in project CSS.
+- Do not modify generated context files unless you are explicitly regenerating or refreshing Decantr context.
+- If a required context file is missing or inconsistent, stop and report which file is missing before continuing.
 
 ### Validation
 
-Run `decantr check` to validate code against the spec.
+Run `decantr check` to detect drift violations while editing and `decantr audit` to audit the whole project contract after implementation.
 
 ### Quick Commands
 

package/src/templates/essence-summary.md.template

@@ -17,9 +17,8 @@ Auto-generated summary of `decantr.essence.json`.
 
 | Property | Value |
 |----------|-------|
-| Theme | {{THEME_STYLE}} |
+| Theme ID | {{THEME_ID}} |
 | Mode | {{THEME_MODE}} |
-| Theme ID | {{THEME_RECIPE}} |
 | Shape | {{SHAPE}} |
 
 ## Structure

package/src/templates/task-add-page.md.template

@@ -10,7 +10,7 @@ You are adding new pages or features to an existing Decantr project. Guided mode
 
 | # | Layer | Rule | Enforcement | What It Means |
 |---|-------|------|-------------|---------------|
-| 1 | DNA | **Style** | ENFORCED | You MUST use theme `{{THEME_STYLE}}` |
+| 1 | DNA | **Theme** | ENFORCED | You MUST use theme `{{THEME_ID}}` |
 | 2 | DNA | **Density** | ENFORCED | You MUST follow density `{{DENSITY}}` |
 | 3 | DNA | **Accessibility** | ENFORCED | You MUST meet WCAG level from essence |
 | 4 | DNA | **Theme-mode** | ENFORCED | Theme/mode combination must be compatible |
@@ -67,8 +67,8 @@ Before adding a page:
 
 During code generation:
 
-- [ ] Use theme `{{THEME_STYLE}}` for all styling
-- [ ] Use theme `{{THEME_RECIPE}}` decorators for decoration
+- [ ] Use theme `{{THEME_ID}}` for all styling
+- [ ] Use theme `{{THEME_ID}}` treatments and decorators for visual identity
 - [ ] Follow the shell structure for the target section (see section context file for shell notes)
 - [ ] Include patterns from the layout array
 

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

@@ -10,7 +10,7 @@ You are modifying existing code in a Decantr project. ALL 7 guard rules are enfo
 
 | # | Layer | Rule | Enforcement | Consequence of Violation |
 |---|-------|------|-------------|--------------------------|
-| 1 | DNA | **Style** | STRICT | ERROR — Code rejected |
+| 1 | DNA | **Theme** | STRICT | ERROR — Code rejected |
 | 2 | DNA | **Density** | STRICT | WARNING — Flagged for review |
 | 3 | DNA | **Accessibility** | STRICT | ERROR — Code rejected |
 | 4 | DNA | **Theme-mode** | STRICT | ERROR — Code rejected |
@@ -34,11 +34,11 @@ When ANY rule would be violated:
 **Theme violation:**
 ```
 STOP: I cannot use theme "glassmorphism" because the essence specifies
-"{{THEME_STYLE}}". This would violate the Style guard rule.
+"{{THEME_ID}}". This would violate the Theme guard rule.
 
 Would you like me to:
 1. Update the essence to use "glassmorphism" instead?
-2. Keep the current theme "{{THEME_STYLE}}"?
+2. Keep the current theme "{{THEME_ID}}"?
 ```
 
 **Layout violation:**
@@ -73,7 +73,7 @@ For the page you're modifying, verify:
 - Page ID exists in `blueprint.sections[].pages[]`
 - Shell matches the page's `shell` property
 - Patterns match the page's `layout[]` in order
-- Theme matches `theme.style`
+- Theme matches `theme.id`
 - Theme decorators match `theme.id`
 
 ### 3. Plan Changes
@@ -91,7 +91,7 @@ Before modifying:
 
 - [ ] Page exists in essence structure
 - [ ] I know the layout order for the target page (check `blueprint.sections[].pages[]`)
-- [ ] I will use theme: `{{THEME_STYLE}}`
+- [ ] I will use theme: `{{THEME_ID}}`
 - [ ] I will follow density: `{{DENSITY}}`
 
 During modification:
@@ -139,10 +139,10 @@ Swapping `chart-grid` and `data-table` is a Layout guard violation.
 
 | Violation | What Happened | Fix |
 |-----------|---------------|-----|
-| "Theme mismatch" | Used different theme | Revert to `{{THEME_STYLE}}` |
+| "Theme mismatch" | Used different theme | Revert to `{{THEME_ID}}` |
 | "Page undefined" | Edited undeclared page | Add page to essence first |
 | "Layout order wrong" | Patterns out of order | Match `layout[]` exactly |
-| "Theme mismatch" | Wrong decoration style | Use `{{THEME_RECIPE}}` |
+| "Theme mismatch" | Wrong treatments or decorators | Use `{{THEME_ID}}` theme styling |
 | "Density drift" | Wrong spacing values | Use `{{CONTENT_GAP}}` tokens |
 
 ## Proposing Essence Changes