@decantr/cli 2.3.0 → 2.4.0

package/dist/{chunk-FSZ6OIAC.js → chunk-H6TIXG5K.js}

@@ -14,7 +14,7 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-WDA4SHIQ.js";
+} from "./chunk-PEGMSXDJ.js";
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
@@ -247,119 +247,42 @@ function getApiKeyOrToken() {
 import { mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync3 } from "fs";
 import { basename, join as join3 } from "path";
 import { resolvePackAdapter } from "@decantr/core";
-var reactViteBootstrapAdapter = {
-  id: "react-vite",
-  label: "React + Vite starter",
-  target: "react",
-  packAdapter: "react-vite",
-  capabilities: {
-    bootstrap: true,
-    realize: true,
-    attach: true,
-    styling: true,
-    verify: true
-  },
-  attach: {
-    routeRoots: ["src/App.tsx", "src/routes", "src/pages"],
-    layoutFiles: ["src/App.tsx", "src/main.tsx"],
-    componentRoots: ["src/components", "src/pages", "src/routes"]
-  },
-  verify: {
-    devCommand: "npm run dev",
-    buildCommand: "npm run build",
-    distDir: "dist"
-  },
-  writeProjectFiles(projectDir, title, routingMode) {
-    const srcDir = join3(projectDir, "src");
-    const routerImport = routingMode === "hash" ? "HashRouter" : "BrowserRouter";
-    const packageJson = {
-      name: basename(projectDir) || "decantr-app",
-      private: true,
-      version: "0.0.0",
-      type: "module",
-      scripts: {
-        dev: "vite",
-        build: "tsc -b && vite build",
-        preview: "vite preview"
-      },
-      dependencies: {
-        react: "^19.0.0",
-        "react-dom": "^19.0.0",
-        "react-router-dom": "^7.0.0",
-        "@decantr/css": "^1.0.4",
-        // P0-4: Lucide is the canonical icon library Decantr blueprints
-        // reference in personality prose ("Lucide icons"). Including it by
-        // default means cold scaffolds don't have to hand-roll inline SVGs.
-        // Tree-shaking eliminates unused imports, so the bundle cost is
-        // zero when unused and ~2KB per icon when used.
-        "lucide-react": "^0.468.0"
-      },
-      devDependencies: {
-        "@types/react": "^19.0.0",
-        "@types/react-dom": "^19.0.0",
-        "@vitejs/plugin-react": "^4.0.0",
-        typescript: "^5.7.0",
-        vite: "^6.0.0"
-      }
-    };
-    writeFileSync3(join3(projectDir, "package.json"), JSON.stringify(packageJson, null, 2) + "\n");
-    const viteConfig = `import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react';
-
-export default defineConfig({
-  plugins: [react()],
-});
-`;
-    writeFileSync3(join3(projectDir, "vite.config.ts"), viteConfig);
-    const tsconfig = {
-      compilerOptions: {
-        target: "ES2020",
-        useDefineForClassFields: true,
-        lib: ["ES2020", "DOM", "DOM.Iterable"],
-        module: "ESNext",
-        skipLibCheck: true,
-        moduleResolution: "bundler",
-        allowImportingTsExtensions: true,
-        isolatedModules: true,
-        moduleDetection: "force",
-        noEmit: true,
-        jsx: "react-jsx",
-        strict: true,
-        noUnusedLocals: true,
-        noUnusedParameters: true,
-        noFallthroughCasesInSwitch: true,
-        noUncheckedSideEffectImports: true
-      },
-      include: ["src"]
-    };
-    writeFileSync3(join3(projectDir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2) + "\n");
-    const tsconfigApp = {
-      compilerOptions: {
-        tsBuildInfoFile: "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
-        target: "ES2020",
-        useDefineForClassFields: true,
-        lib: ["ES2020", "DOM", "DOM.Iterable"],
-        module: "ESNext",
-        skipLibCheck: true,
-        moduleResolution: "bundler",
-        allowImportingTsExtensions: true,
-        isolatedModules: true,
-        moduleDetection: "force",
-        noEmit: true,
-        jsx: "react-jsx",
-        strict: true,
-        noUnusedLocals: true,
-        noUnusedParameters: true,
-        noFallthroughCasesInSwitch: true,
-        noUncheckedSideEffectImports: true
-      },
-      include: ["src"]
-    };
-    writeFileSync3(
-      join3(projectDir, "tsconfig.app.json"),
-      JSON.stringify(tsconfigApp, null, 2) + "\n"
-    );
-    const indexHtml = `<!doctype html>
+function writeJson(path, value) {
+  writeFileSync3(path, JSON.stringify(value, null, 2) + "\n");
+}
+function mkdirp(path) {
+  mkdirSync3(path, { recursive: true });
+}
+function starterName(projectDir, fallback) {
+  return basename(projectDir) || fallback;
+}
+function writeViteTsConfig(projectDir, options = {}) {
+  writeJson(join3(projectDir, "tsconfig.json"), {
+    compilerOptions: {
+      target: "ES2020",
+      useDefineForClassFields: true,
+      lib: ["ES2020", "DOM", "DOM.Iterable"],
+      module: "ESNext",
+      skipLibCheck: true,
+      moduleResolution: "bundler",
+      allowImportingTsExtensions: true,
+      isolatedModules: true,
+      moduleDetection: "force",
+      noEmit: true,
+      ...options.jsx ? { jsx: options.jsx } : {},
+      strict: true,
+      noUnusedLocals: true,
+      noUnusedParameters: true,
+      noFallthroughCasesInSwitch: true,
+      noUncheckedSideEffectImports: true
+    },
+    include: ["src"]
+  });
+}
+function writeIndexHtml(projectDir, title, entry) {
+  writeFileSync3(
+    join3(projectDir, "index.html"),
+    `<!doctype html>
 <html lang="en">
   <head>
     <meta charset="UTF-8" />
@@ -368,13 +291,186 @@ export default defineConfig({
   </head>
   <body>
     <div id="root"></div>
-    <script type="module" src="/src/main.tsx"></script>
+    <script type="module" src="${entry}"></script>
   </body>
 </html>
-`;
-    writeFileSync3(join3(projectDir, "index.html"), indexHtml);
-    mkdirSync3(srcDir, { recursive: true });
-    const mainTsx = `import { StrictMode } from 'react';
+`
+  );
+}
+function ensureStyleDir(projectDir) {
+  mkdirp(join3(projectDir, "src", "styles"));
+}
+function packagePlanPackageJson(projectDir, fallbackName, packagePlan) {
+  return {
+    name: starterName(projectDir, fallbackName),
+    private: true,
+    version: "0.0.0",
+    type: "module",
+    scripts: packagePlan.scripts,
+    dependencies: packagePlan.dependencies,
+    devDependencies: packagePlan.devDependencies
+  };
+}
+var reactVitePackagePlan = {
+  scripts: {
+    dev: "vite",
+    build: "tsc -b && vite build",
+    preview: "vite preview"
+  },
+  dependencies: {
+    react: "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router-dom": "^7.0.0",
+    "@decantr/css": "^1.0.4",
+    "lucide-react": "^0.468.0"
+  },
+  devDependencies: {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.0.0",
+    typescript: "^5.7.0",
+    vite: "^6.0.0"
+  }
+};
+var nextPackagePlan = {
+  scripts: {
+    dev: "next dev",
+    build: "next build",
+    start: "next start"
+  },
+  dependencies: {
+    "@decantr/css": "^1.0.4",
+    "lucide-react": "^0.468.0",
+    next: "^16.0.0",
+    react: "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  devDependencies: {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    typescript: "^5.7.0"
+  }
+};
+var vanillaPackagePlan = {
+  scripts: {
+    dev: "vite",
+    build: "vite build",
+    preview: "vite preview"
+  },
+  dependencies: {
+    "@decantr/css": "^1.0.4",
+    lucide: "^0.468.0"
+  },
+  devDependencies: {
+    vite: "^6.0.0"
+  }
+};
+var vuePackagePlan = {
+  scripts: {
+    dev: "vite",
+    build: "vue-tsc -b && vite build",
+    preview: "vite preview"
+  },
+  dependencies: {
+    "@decantr/css": "^1.0.4",
+    "@vitejs/plugin-vue": "^5.0.0",
+    "@vue/compiler-sfc": "^3.5.0",
+    "lucide-vue-next": "^0.468.0",
+    vue: "^3.5.0",
+    "vue-router": "^4.4.0"
+  },
+  devDependencies: {
+    typescript: "^5.7.0",
+    vite: "^6.0.0",
+    "vue-tsc": "^2.1.0"
+  }
+};
+var sveltePackagePlan = {
+  scripts: {
+    dev: "vite dev",
+    build: "vite build",
+    preview: "vite preview"
+  },
+  dependencies: {
+    "@decantr/css": "^1.0.4",
+    "@sveltejs/adapter-auto": "^3.0.0",
+    "@sveltejs/kit": "^2.0.0",
+    "@sveltejs/vite-plugin-svelte": "^5.0.0",
+    lucide: "^0.468.0",
+    svelte: "^5.0.0"
+  },
+  devDependencies: {
+    typescript: "^5.7.0",
+    vite: "^6.0.0"
+  }
+};
+var angularPackagePlan = {
+  scripts: {
+    dev: "ng serve",
+    build: "ng build",
+    start: "ng serve"
+  },
+  dependencies: {
+    "@angular/animations": "^19.0.0",
+    "@angular/common": "^19.0.0",
+    "@angular/compiler": "^19.0.0",
+    "@angular/core": "^19.0.0",
+    "@angular/forms": "^19.0.0",
+    "@angular/platform-browser": "^19.0.0",
+    "@angular/router": "^19.0.0",
+    "@decantr/css": "^1.0.4",
+    lucide: "^0.468.0",
+    rxjs: "^7.8.0",
+    tslib: "^2.8.0",
+    "zone.js": "^0.15.0"
+  },
+  devDependencies: {
+    "@angular-devkit/build-angular": "^19.0.0",
+    "@angular/cli": "^19.0.0",
+    "@angular/compiler-cli": "^19.0.0",
+    typescript: "^5.7.0"
+  }
+};
+var solidPackagePlan = {
+  scripts: {
+    dev: "vite",
+    build: "tsc -b && vite build",
+    preview: "vite preview"
+  },
+  dependencies: {
+    "@decantr/css": "^1.0.4",
+    "@solidjs/router": "^0.15.0",
+    lucide: "^0.468.0",
+    "solid-js": "^1.9.0"
+  },
+  devDependencies: {
+    typescript: "^5.7.0",
+    vite: "^6.0.0",
+    "vite-plugin-solid": "^2.11.0"
+  }
+};
+function writeReactViteProject(projectDir, title, routingMode) {
+  const srcDir = join3(projectDir, "src");
+  const routerImport = routingMode === "hash" ? "HashRouter" : "BrowserRouter";
+  writeJson(join3(projectDir, "package.json"), packagePlanPackageJson(projectDir, "decantr-app", reactVitePackagePlan));
+  writeFileSync3(
+    join3(projectDir, "vite.config.ts"),
+    `import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+
+export default defineConfig({
+  plugins: [react()],
+});
+`
+  );
+  writeViteTsConfig(projectDir, { jsx: "react-jsx" });
+  writeJson(join3(projectDir, "tsconfig.app.json"), JSON.parse(readFileSync3(join3(projectDir, "tsconfig.json"), "utf-8")));
+  writeIndexHtml(projectDir, title, "/src/main.tsx");
+  mkdirp(srcDir);
+  writeFileSync3(
+    join3(srcDir, "main.tsx"),
+    `import { StrictMode } from 'react';
 import { createRoot } from 'react-dom/client';
 import { ${routerImport} } from 'react-router-dom';
 import { App } from './App';
@@ -389,9 +485,11 @@ createRoot(document.getElementById('root')!).render(
     </${routerImport}>
   </StrictMode>,
 );
-`;
-    writeFileSync3(join3(srcDir, "main.tsx"), mainTsx);
-    const appTsx = `import { css } from '@decantr/css';
+`
+  );
+  writeFileSync3(
+    join3(srcDir, "App.tsx"),
+    `import { css } from '@decantr/css';
 import { Routes, Route } from 'react-router-dom';
 
 function WelcomePage() {
@@ -403,9 +501,7 @@ function WelcomePage() {
           <div className={css('_flex _col _aic _gap4 _textc') + ' d-surface'} data-elevation="raised">
             <p className="d-label" data-anchor>Decantr starter</p>
             <h1 className={css('_heading2')}>${title}</h1>
-            <p className={css('_textsm _fgmuted _mw[32rem]')}>
-              Scaffolded with Decantr. Read .decantr/context/scaffold-pack.md first, then use DECANTR.md as a lookup reference.
-            </p>
+            <p className={css('_textsm _fgmuted _mw[32rem]')}>Scaffolded with Decantr. Read .decantr/context/scaffold-pack.md first, then use DECANTR.md as a lookup reference.</p>
             <div className={css('_flex _gap3 _wrap _jcc')}>
               <span className="d-annotation" data-status="info">Runtime: @decantr/css</span>
               <span className="d-annotation" data-status="success">Routing: ${routingMode}</span>
@@ -424,102 +520,42 @@ export function App() {
     </Routes>
   );
 }
-`;
-    writeFileSync3(join3(srcDir, "App.tsx"), appTsx);
-    writeFileSync3(join3(srcDir, "vite-env.d.ts"), '/// <reference types="vite/client" />\n');
-    mkdirSync3(join3(srcDir, "styles"), { recursive: true });
-  }
-};
-var nextAppAdapter = {
-  id: "next-app",
-  label: "Next.js App Router starter",
-  target: "nextjs",
-  packAdapter: "nextjs",
-  capabilities: {
-    bootstrap: true,
-    realize: true,
-    attach: true,
-    styling: true,
-    verify: true
-  },
-  attach: {
-    routeRoots: ["app", "pages"],
-    layoutFiles: ["app/layout.tsx", "pages/_app.tsx"],
-    componentRoots: ["components", "src/components", "app"]
-  },
-  verify: {
-    devCommand: "npm run dev",
-    buildCommand: "npm run build",
-    distDir: ".next"
-  },
-  writeProjectFiles(projectDir, title) {
-    const appDir = join3(projectDir, "app");
-    const stylesDir = join3(projectDir, "src", "styles");
-    const packageJson = {
-      name: basename(projectDir) || "decantr-next-app",
-      private: true,
-      version: "0.0.0",
-      type: "module",
-      scripts: {
-        dev: "next dev",
-        build: "next build",
-        start: "next start"
-      },
-      dependencies: {
-        "@decantr/css": "^1.0.4",
-        "lucide-react": "^0.468.0",
-        next: "^16.0.0",
-        react: "^19.0.0",
-        "react-dom": "^19.0.0"
-      },
-      devDependencies: {
-        "@types/node": "^20.0.0",
-        "@types/react": "^19.0.0",
-        "@types/react-dom": "^19.0.0",
-        typescript: "^5.7.0"
-      }
-    };
-    writeFileSync3(join3(projectDir, "package.json"), JSON.stringify(packageJson, null, 2) + "\n");
-    writeFileSync3(
-      join3(projectDir, "next.config.ts"),
-      'import type { NextConfig } from "next";\n\nconst nextConfig: NextConfig = {};\n\nexport default nextConfig;\n'
-    );
-    writeFileSync3(
-      join3(projectDir, "next-env.d.ts"),
-      '/// <reference types="next" />\n/// <reference types="next/image-types/global" />\n\n// This file is generated by Next.js.\n'
-    );
-    writeFileSync3(
-      join3(projectDir, "tsconfig.json"),
-      JSON.stringify(
-        {
-          compilerOptions: {
-            target: "ES2017",
-            lib: ["dom", "dom.iterable", "esnext"],
-            allowJs: true,
-            skipLibCheck: true,
-            strict: true,
-            noEmit: true,
-            esModuleInterop: true,
-            module: "esnext",
-            moduleResolution: "bundler",
-            resolveJsonModule: true,
-            isolatedModules: true,
-            jsx: "preserve",
-            incremental: true,
-            plugins: [{ name: "next" }]
-          },
-          include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
-          exclude: ["node_modules"]
-        },
-        null,
-        2
-      ) + "\n"
-    );
-    mkdirSync3(appDir, { recursive: true });
-    mkdirSync3(stylesDir, { recursive: true });
-    writeFileSync3(
-      join3(appDir, "layout.tsx"),
-      `import type { Metadata } from 'next';
+`
+  );
+  writeFileSync3(join3(srcDir, "vite-env.d.ts"), '/// <reference types="vite/client" />\n');
+  ensureStyleDir(projectDir);
+}
+function writeNextProject(projectDir, title) {
+  const appDir = join3(projectDir, "app");
+  const stylesDir = join3(projectDir, "src", "styles");
+  writeJson(join3(projectDir, "package.json"), packagePlanPackageJson(projectDir, "decantr-next-app", nextPackagePlan));
+  writeFileSync3(join3(projectDir, "next.config.ts"), 'import type { NextConfig } from "next";\n\nconst nextConfig: NextConfig = {};\n\nexport default nextConfig;\n');
+  writeFileSync3(join3(projectDir, "next-env.d.ts"), '/// <reference types="next" />\n/// <reference types="next/image-types/global" />\n\n// This file is generated by Next.js.\n');
+  writeJson(join3(projectDir, "tsconfig.json"), {
+    compilerOptions: {
+      target: "ES2017",
+      lib: ["dom", "dom.iterable", "esnext"],
+      allowJs: true,
+      skipLibCheck: true,
+      strict: true,
+      noEmit: true,
+      esModuleInterop: true,
+      module: "esnext",
+      moduleResolution: "bundler",
+      resolveJsonModule: true,
+      isolatedModules: true,
+      jsx: "preserve",
+      incremental: true,
+      plugins: [{ name: "next" }]
+    },
+    include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+    exclude: ["node_modules"]
+  });
+  mkdirp(appDir);
+  mkdirp(stylesDir);
+  writeFileSync3(
+    join3(appDir, "layout.tsx"),
+    `import type { Metadata } from 'next';
 import '../src/styles/global.css';
 import '../src/styles/tokens.css';
 import '../src/styles/treatments.css';
@@ -537,10 +573,10 @@ export default function RootLayout({ children }: Readonly<{ children: React.Reac
   );
 }
 `
-    );
-    writeFileSync3(
-      join3(appDir, "page.tsx"),
-      `import { css } from '@decantr/css';
+  );
+  writeFileSync3(
+    join3(appDir, "page.tsx"),
+    `import { css } from '@decantr/css';
 
 export default function HomePage() {
   return (
@@ -557,54 +593,486 @@ export default function HomePage() {
   );
 }
 `
-    );
-  }
+  );
+}
+function writeVanillaProject(projectDir, title, routingMode) {
+  const srcDir = join3(projectDir, "src");
+  writeJson(join3(projectDir, "package.json"), packagePlanPackageJson(projectDir, "decantr-vanilla-app", vanillaPackagePlan));
+  writeIndexHtml(projectDir, title, "/src/main.js");
+  mkdirp(srcDir);
+  writeFileSync3(
+    join3(srcDir, "main.js"),
+    `import { css } from '@decantr/css';
+import './styles/global.css';
+import './styles/tokens.css';
+import './styles/treatments.css';
+
+const root = document.getElementById('root');
+if (!root) throw new Error('Missing #root element.');
+
+root.innerHTML = \`
+  <a href="#main-content" class="skip-link">Skip to content</a>
+  <main id="main-content" class="\${css('_minh[100vh] _flex _col _aic _jcc _p6 _gap4')}">
+    <section class="\${css('_wfull _mw[42rem]')} d-section" data-density="comfortable">
+      <div class="\${css('_flex _col _aic _gap4 _textc')} d-surface" data-elevation="raised">
+        <p class="d-label" data-anchor>Decantr starter</p>
+        <h1 class="\${css('_heading2')}">${title}</h1>
+        <p class="\${css('_textsm _fgmuted _mw[32rem]')}">Scaffolded with Decantr. Read .decantr/context/scaffold-pack.md first, then use DECANTR.md as a lookup reference.</p>
+        <div class="\${css('_flex _gap3 _wrap _jcc')}">
+          <span class="d-annotation" data-status="info">Runtime: vanilla Vite</span>
+          <span class="d-annotation" data-status="success">Routing: ${routingMode}</span>
+        </div>
+      </div>
+    </section>
+  </main>
+\`;
+`
+  );
+  ensureStyleDir(projectDir);
+}
+function writeVueProject(projectDir, title, routingMode) {
+  const srcDir = join3(projectDir, "src");
+  const historyFactory = routingMode === "hash" ? "createWebHashHistory" : "createWebHistory";
+  writeJson(join3(projectDir, "package.json"), packagePlanPackageJson(projectDir, "decantr-vue-app", vuePackagePlan));
+  writeFileSync3(join3(projectDir, "vite.config.ts"), `import { defineConfig } from 'vite';
+import vue from '@vitejs/plugin-vue';
+
+export default defineConfig({ plugins: [vue()] });
+`);
+  writeViteTsConfig(projectDir);
+  writeFileSync3(join3(projectDir, "env.d.ts"), '/// <reference types="vite/client" />\n\ndeclare module "*.vue";\n');
+  writeIndexHtml(projectDir, title, "/src/main.ts");
+  mkdirp(srcDir);
+  writeFileSync3(
+    join3(srcDir, "main.ts"),
+    `import { createApp } from 'vue';
+import { createRouter, ${historyFactory} } from 'vue-router';
+import App from './App.vue';
+import './styles/global.css';
+import './styles/tokens.css';
+import './styles/treatments.css';
+
+const router = createRouter({
+  history: ${historyFactory}(),
+  routes: [{ path: '/', component: App }],
+});
+
+createApp(App).use(router).mount('#root');
+`
+  );
+  writeFileSync3(
+    join3(srcDir, "App.vue"),
+    `<script setup lang="ts">
+import { css } from '@decantr/css';
+</script>
+
+<template>
+  <a href="#main-content" class="skip-link">Skip to content</a>
+  <main id="main-content" :class="css('_minh[100vh] _flex _col _aic _jcc _p6 _gap4')">
+    <section :class="css('_wfull _mw[42rem]') + ' d-section'" data-density="comfortable">
+      <div :class="css('_flex _col _aic _gap4 _textc') + ' d-surface'" data-elevation="raised">
+        <p class="d-label" data-anchor>Decantr starter</p>
+        <h1 :class="css('_heading2')">${title}</h1>
+        <p :class="css('_textsm _fgmuted _mw[32rem]')">Scaffolded with Decantr. Read .decantr/context/scaffold-pack.md first, then use DECANTR.md as a lookup reference.</p>
+        <div :class="css('_flex _gap3 _wrap _jcc')">
+          <span class="d-annotation" data-status="info">Runtime: Vue + Vite</span>
+          <span class="d-annotation" data-status="success">Routing: ${routingMode}</span>
+        </div>
+      </div>
+    </section>
+  </main>
+</template>
+`
+  );
+  ensureStyleDir(projectDir);
+}
+function writeSvelteProject(projectDir, title) {
+  const routesDir = join3(projectDir, "src", "routes");
+  writeJson(join3(projectDir, "package.json"), packagePlanPackageJson(projectDir, "decantr-svelte-app", sveltePackagePlan));
+  writeFileSync3(join3(projectDir, "svelte.config.js"), `import adapter from '@sveltejs/adapter-auto';
+import { vitePreprocess } from '@sveltejs/vite-plugin-svelte';
+
+export default { preprocess: vitePreprocess(), kit: { adapter: adapter() } };
+`);
+  writeFileSync3(join3(projectDir, "vite.config.ts"), `import { sveltekit } from '@sveltejs/kit/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({ plugins: [sveltekit()] });
+`);
+  writeViteTsConfig(projectDir);
+  mkdirp(routesDir);
+  writeFileSync3(join3(projectDir, "src", "app.html"), '<!doctype html>\n<html lang="en">\n  <head>\n    <meta charset="utf-8" />\n    <meta name="viewport" content="width=device-width, initial-scale=1" />\n    %sveltekit.head%\n  </head>\n  <body data-sveltekit-preload-data="hover">\n    <div style="display: contents">%sveltekit.body%</div>\n  </body>\n</html>\n');
+  writeFileSync3(join3(routesDir, "+layout.svelte"), `<script lang="ts">
+import '../styles/global.css';
+import '../styles/tokens.css';
+import '../styles/treatments.css';
+let { children } = $props();
+</script>
+
+{@render children()}
+`);
+  writeFileSync3(
+    join3(routesDir, "+page.svelte"),
+    `<script lang="ts">
+import { css } from '@decantr/css';
+</script>
+
+<svelte:head>
+  <title>${title}</title>
+</svelte:head>
+
+<a href="#main-content" class="skip-link">Skip to content</a>
+<main id="main-content" class={css('_minh[100vh] _flex _col _aic _jcc _p6 _gap4')}>
+  <section class={css('_wfull _mw[42rem]') + ' d-section'} data-density="comfortable">
+    <div class={css('_flex _col _aic _gap4 _textc') + ' d-surface'} data-elevation="raised">
+      <p class="d-label" data-anchor>Decantr starter</p>
+      <h1 class={css('_heading2')}>${title}</h1>
+      <p class={css('_textsm _fgmuted _mw[32rem]')}>Scaffolded with Decantr. Read .decantr/context/scaffold-pack.md first, then use DECANTR.md as a lookup reference.</p>
+      <span class="d-annotation" data-status="info">Runtime: SvelteKit</span>
+    </div>
+  </section>
+</main>
+`
+  );
+  ensureStyleDir(projectDir);
+}
+function writeAngularProject(projectDir, title) {
+  const appDir = join3(projectDir, "src", "app");
+  writeJson(join3(projectDir, "package.json"), packagePlanPackageJson(projectDir, "decantr-angular-app", angularPackagePlan));
+  writeJson(join3(projectDir, "angular.json"), {
+    version: 1,
+    projects: {
+      app: {
+        projectType: "application",
+        root: "",
+        sourceRoot: "src",
+        architect: {
+          build: {
+            builder: "@angular-devkit/build-angular:application",
+            options: {
+              outputPath: "dist",
+              index: "src/index.html",
+              browser: "src/main.ts",
+              tsConfig: "tsconfig.app.json",
+              styles: ["src/styles.css", "src/styles/tokens.css", "src/styles/treatments.css"]
+            }
+          },
+          serve: {
+            builder: "@angular-devkit/build-angular:dev-server",
+            options: { buildTarget: "app:build" }
+          }
+        }
+      }
+    }
+  });
+  writeJson(join3(projectDir, "tsconfig.json"), {
+    compilerOptions: {
+      target: "ES2022",
+      module: "ES2022",
+      moduleResolution: "bundler",
+      strict: true,
+      skipLibCheck: true,
+      experimentalDecorators: true,
+      useDefineForClassFields: false,
+      lib: ["ES2022", "DOM"]
+    }
+  });
+  writeJson(join3(projectDir, "tsconfig.app.json"), { extends: "./tsconfig.json", files: ["src/main.ts"], include: ["src/**/*.d.ts"] });
+  mkdirp(appDir);
+  writeFileSync3(join3(projectDir, "src", "index.html"), `<!doctype html>
+<html lang="en">
+<head><meta charset="utf-8"><title>${title}</title><meta name="viewport" content="width=device-width, initial-scale=1"></head>
+<body><app-root></app-root></body>
+</html>
+`);
+  writeFileSync3(join3(projectDir, "src", "main.ts"), `import { bootstrapApplication } from '@angular/platform-browser';
+import { provideRouter } from '@angular/router';
+import { AppComponent } from './app/app.component';
+import { routes } from './app/app.routes';
+
+bootstrapApplication(AppComponent, { providers: [provideRouter(routes)] }).catch((err) => console.error(err));
+`);
+  writeFileSync3(join3(projectDir, "src", "styles.css"), '@import "./styles/global.css";\n');
+  writeFileSync3(join3(appDir, "app.routes.ts"), `import type { Routes } from '@angular/router';
+import { AppComponent } from './app.component';
+
+export const routes: Routes = [{ path: '', component: AppComponent }];
+`);
+  writeFileSync3(
+    join3(appDir, "app.component.ts"),
+    `import { Component } from '@angular/core';
+
+@Component({
+  selector: 'app-root',
+  standalone: true,
+  template: \`
+    <a href="#main-content" class="skip-link">Skip to content</a>
+    <main id="main-content" class="_minh[100vh] _flex _col _aic _jcc _p6 _gap4">
+      <section class="_wfull _mw[42rem] d-section" data-density="comfortable">
+        <div class="_flex _col _aic _gap4 _textc d-surface" data-elevation="raised">
+          <p class="d-label" data-anchor>Decantr starter</p>
+          <h1 class="_heading2">${title}</h1>
+          <p class="_textsm _fgmuted _mw[32rem]">Scaffolded with Decantr. Read .decantr/context/scaffold-pack.md first, then use DECANTR.md as a lookup reference.</p>
+          <span class="d-annotation" data-status="info">Runtime: Angular</span>
+        </div>
+      </section>
+    </main>
+  \`,
+})
+export class AppComponent {}
+`
+  );
+  ensureStyleDir(projectDir);
+}
+function writeSolidProject(projectDir, title, routingMode) {
+  const srcDir = join3(projectDir, "src");
+  const routerImport = routingMode === "hash" ? "HashRouter" : "Router";
+  writeJson(join3(projectDir, "package.json"), packagePlanPackageJson(projectDir, "decantr-solid-app", solidPackagePlan));
+  writeFileSync3(join3(projectDir, "vite.config.ts"), `import { defineConfig } from 'vite';
+import solid from 'vite-plugin-solid';
+
+export default defineConfig({ plugins: [solid()] });
+`);
+  writeViteTsConfig(projectDir, { jsx: "preserve" });
+  writeJson(join3(projectDir, "tsconfig.app.json"), JSON.parse(readFileSync3(join3(projectDir, "tsconfig.json"), "utf-8")));
+  writeIndexHtml(projectDir, title, "/src/main.tsx");
+  mkdirp(srcDir);
+  writeFileSync3(
+    join3(srcDir, "main.tsx"),
+    `import { render } from 'solid-js/web';
+import { ${routerImport} } from '@solidjs/router';
+import { App } from './App';
+import './styles/global.css';
+import './styles/tokens.css';
+import './styles/treatments.css';
+
+render(() => (
+  <${routerImport}>
+    <App />
+  </${routerImport}>
+), document.getElementById('root')!);
+`
+  );
+  writeFileSync3(
+    join3(srcDir, "App.tsx"),
+    `import { css } from '@decantr/css';
+
+export function App() {
+  return (
+    <>
+      <a href="#main-content" class="skip-link">Skip to content</a>
+      <main id="main-content" class={css('_minh[100vh] _flex _col _aic _jcc _p6 _gap4')}>
+        <section class={css('_wfull _mw[42rem]') + ' d-section'} data-density="comfortable">
+          <div class={css('_flex _col _aic _gap4 _textc') + ' d-surface'} data-elevation="raised">
+            <p class="d-label" data-anchor>Decantr starter</p>
+            <h1 class={css('_heading2')}>${title}</h1>
+            <p class={css('_textsm _fgmuted _mw[32rem]')}>Scaffolded with Decantr. Read .decantr/context/scaffold-pack.md first, then use DECANTR.md as a lookup reference.</p>
+            <div class={css('_flex _gap3 _wrap _jcc')}>
+              <span class="d-annotation" data-status="info">Runtime: Solid + Vite</span>
+              <span class="d-annotation" data-status="success">Routing: ${routingMode}</span>
+            </div>
+          </div>
+        </section>
+      </main>
+    </>
+  );
+}
+`
+  );
+  ensureStyleDir(projectDir);
+}
+var certifiedCapabilities = {
+  bootstrap: true,
+  realize: true,
+  attach: true,
+  styling: true,
+  verify: true
 };
-var genericWebAdapter = {
-  id: "generic-web",
-  label: "Generic web contract adapter",
-  target: "generic",
-  packAdapter: "generic-web",
-  capabilities: {
-    bootstrap: false,
-    realize: false,
-    attach: true,
-    styling: true,
-    verify: true
+var DECANTR_ADAPTERS = {
+  "react-vite": {
+    id: "react-vite",
+    label: "React + Vite starter",
+    target: "react",
+    aliases: ["react"],
+    status: "certified",
+    packAdapter: "react-vite",
+    routing: "history",
+    capabilities: certifiedCapabilities,
+    attach: {
+      routeRoots: ["src/App.tsx", "src/routes", "src/pages"],
+      layoutFiles: ["src/App.tsx", "src/main.tsx"],
+      componentRoots: ["src/components", "src/pages", "src/routes"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: "dist" },
+    packagePlan: reactVitePackagePlan,
+    docs: { summary: "React + Vite runnable starter.", notes: ["Uses React Router and @decantr/css."] },
+    writeProjectFiles: writeReactViteProject
+  },
+  "next-app": {
+    id: "next-app",
+    label: "Next.js App Router starter",
+    target: "nextjs",
+    aliases: ["next", "nextjs"],
+    status: "certified",
+    packAdapter: "nextjs",
+    routing: "pathname",
+    capabilities: certifiedCapabilities,
+    attach: {
+      routeRoots: ["app", "pages"],
+      layoutFiles: ["app/layout.tsx", "pages/_app.tsx"],
+      componentRoots: ["components", "src/components", "app"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: ".next" },
+    packagePlan: nextPackagePlan,
+    docs: { summary: "Next.js App Router runnable starter.", notes: ["Uses App Router for greenfield bootstraps."] },
+    writeProjectFiles: writeNextProject
+  },
+  "vanilla-vite": {
+    id: "vanilla-vite",
+    label: "Vanilla HTML/CSS/JS + Vite starter",
+    target: "html",
+    aliases: ["html", "vanilla", "javascript", "js"],
+    status: "certified",
+    packAdapter: "vanilla-vite",
+    routing: "history",
+    capabilities: certifiedCapabilities,
+    attach: {
+      routeRoots: ["index.html", "src/main.js", "src/routes"],
+      layoutFiles: ["index.html", "src/main.js"],
+      componentRoots: ["src/components", "src"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: "dist" },
+    packagePlan: vanillaPackagePlan,
+    docs: { summary: "Plain web runnable starter.", notes: ["Uses DOM APIs and @decantr/css without a UI framework."] },
+    writeProjectFiles: writeVanillaProject
+  },
+  "vue-vite": {
+    id: "vue-vite",
+    label: "Vue + Vite starter",
+    target: "vue",
+    aliases: ["vue", "vue3"],
+    status: "certified",
+    packAdapter: "vue-vite",
+    routing: "history",
+    capabilities: certifiedCapabilities,
+    attach: {
+      routeRoots: ["src/main.ts", "src/router.ts", "src/views"],
+      layoutFiles: ["src/App.vue", "src/main.ts"],
+      componentRoots: ["src/components", "src/views"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: "dist" },
+    packagePlan: vuePackagePlan,
+    docs: { summary: "Vue 3 + Vite runnable starter.", notes: ["Uses Vue Router and @decantr/css."] },
+    writeProjectFiles: writeVueProject
+  },
+  sveltekit: {
+    id: "sveltekit",
+    label: "SvelteKit starter",
+    target: "svelte",
+    aliases: ["svelte", "sveltekit"],
+    status: "certified",
+    packAdapter: "sveltekit",
+    routing: "framework-native",
+    capabilities: certifiedCapabilities,
+    attach: {
+      routeRoots: ["src/routes"],
+      layoutFiles: ["src/routes/+layout.svelte", "src/app.html"],
+      componentRoots: ["src/lib", "src/routes"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: ".svelte-kit" },
+    packagePlan: sveltePackagePlan,
+    docs: { summary: "SvelteKit runnable starter.", notes: ["Uses SvelteKit file routing and @decantr/css."] },
+    writeProjectFiles: writeSvelteProject
+  },
+  angular: {
+    id: "angular",
+    label: "Angular standalone starter",
+    target: "angular",
+    aliases: ["angular", "ng"],
+    status: "certified",
+    packAdapter: "angular",
+    routing: "framework-native",
+    capabilities: certifiedCapabilities,
+    attach: {
+      routeRoots: ["src/app/app.routes.ts"],
+      layoutFiles: ["src/app/app.component.ts", "src/main.ts"],
+      componentRoots: ["src/app"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: "dist" },
+    packagePlan: angularPackagePlan,
+    docs: { summary: "Angular standalone runnable starter.", notes: ["Uses Angular Router and global Decantr CSS files."] },
+    writeProjectFiles: writeAngularProject
   },
-  attach: {
-    routeRoots: ["src", "app", "pages"],
-    layoutFiles: ["index.html", "src/main.ts", "src/main.tsx"],
-    componentRoots: ["src/components", "components"]
+  "solid-vite": {
+    id: "solid-vite",
+    label: "Solid + Vite starter",
+    target: "solid",
+    aliases: ["solid", "solidjs"],
+    status: "certified",
+    packAdapter: "solid-vite",
+    routing: "history",
+    capabilities: certifiedCapabilities,
+    attach: {
+      routeRoots: ["src/App.tsx", "src/routes", "src/pages"],
+      layoutFiles: ["src/App.tsx", "src/main.tsx"],
+      componentRoots: ["src/components", "src/pages", "src/routes"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: "dist" },
+    packagePlan: solidPackagePlan,
+    docs: { summary: "Solid + Vite runnable starter.", notes: ["Uses @solidjs/router and @decantr/css."] },
+    writeProjectFiles: writeSolidProject
   },
-  verify: {
-    devCommand: "npm run dev",
-    buildCommand: "npm run build",
-    distDir: "dist"
+  "generic-web": {
+    id: "generic-web",
+    label: "Generic web contract adapter",
+    target: "generic",
+    aliases: [],
+    status: "contract-only",
+    packAdapter: "generic-web",
+    routing: "history",
+    capabilities: { bootstrap: false, realize: false, attach: true, styling: true, verify: true },
+    attach: {
+      routeRoots: ["src", "app", "pages"],
+      layoutFiles: ["index.html", "src/main.ts", "src/main.tsx"],
+      componentRoots: ["src/components", "components"]
+    },
+    verify: { devCommand: "npm run dev", buildCommand: "npm run build", distDir: "dist" },
+    docs: { summary: "Contract-only fallback for unsupported web targets.", notes: ["Does not write framework runtime files."] }
   }
 };
-var DECANTR_ADAPTERS = {
-  "react-vite": reactViteBootstrapAdapter,
-  "next-app": nextAppAdapter,
-  "generic-web": genericWebAdapter
-};
+var TARGET_ALIASES = /* @__PURE__ */ new Map();
+for (const adapter of Object.values(DECANTR_ADAPTERS)) {
+  TARGET_ALIASES.set(adapter.target, adapter.id);
+  TARGET_ALIASES.set(adapter.id, adapter.id);
+  for (const alias of adapter.aliases) TARGET_ALIASES.set(alias, adapter.id);
+}
+function normalizeTarget(target) {
+  return (target || "react").toLowerCase();
+}
+function platformTypeForTarget(target) {
+  return target === "nextjs" || target === "next" || target === "sveltekit" ? "ssr" : "spa";
+}
+function adapterIdForTarget(target, packAdapter) {
+  return TARGET_ALIASES.get(target) ?? (DECANTR_ADAPTERS[packAdapter] ? packAdapter : "generic-web");
+}
 function resolveBootstrapTarget(target) {
-  const normalizedTarget = (target || "react").toLowerCase();
-  const platformType = normalizedTarget === "nextjs" ? "ssr" : "spa";
-  const packAdapter = resolvePackAdapter(normalizedTarget, platformType);
-  const adapterId = normalizedTarget === "nextjs" ? "next-app" : DECANTR_ADAPTERS[packAdapter] ? packAdapter : "generic-web";
+  const normalizedTarget = normalizeTarget(target);
+  const adapterIdFromAlias = TARGET_ALIASES.get(normalizedTarget);
+  const adapterTarget = adapterIdFromAlias ? DECANTR_ADAPTERS[adapterIdFromAlias].target : normalizedTarget;
+  const platformType = platformTypeForTarget(adapterTarget);
+  const packAdapter = resolvePackAdapter(adapterTarget, platformType);
+  const adapterId = adapterIdForTarget(adapterTarget, packAdapter);
+  const adapter = DECANTR_ADAPTERS[adapterId];
   return {
-    target: normalizedTarget,
+    target: adapterTarget,
     platformType,
     packAdapter,
     adapterId,
-    bootstrapAdapterId: DECANTR_ADAPTERS[adapterId]?.capabilities.bootstrap && DECANTR_ADAPTERS[adapterId]?.writeProjectFiles ? adapterId : null
+    bootstrapAdapterId: adapter?.capabilities.bootstrap && adapter?.writeProjectFiles ? adapterId : null
   };
 }
 function getBootstrapAdapter(resolution) {
-  if (!resolution.bootstrapAdapterId) {
-    return null;
-  }
+  if (!resolution.bootstrapAdapterId) return null;
   const adapter = DECANTR_ADAPTERS[resolution.bootstrapAdapterId];
   return adapter?.writeProjectFiles ? adapter : null;
 }
@@ -612,9 +1080,7 @@ function detectRoutingMode(projectDir) {
   try {
     const essence = JSON.parse(readFileSync3(join3(projectDir, "decantr.essence.json"), "utf-8"));
     const routing = essence.meta?.platform?.routing;
-    if (routing === "history" || routing === "pathname") {
-      return routing;
-    }
+    if (routing === "history" || routing === "pathname") return routing;
     return "hash";
   } catch {
     return "hash";
@@ -1964,6 +2430,9 @@ function detectProject(projectRoot = process.cwd()) {
       } else if (deps["@angular/core"]) {
         result.framework = "angular";
         result.version = deps["@angular/core"].replace(/^\^|~/, "");
+      } else if (deps["solid-js"]) {
+        result.framework = "solid";
+        result.version = deps["solid-js"].replace(/^\^|~/, "");
       } else if (deps.vue) {
         result.framework = "vue";
         result.version = deps.vue.replace(/^\^|~/, "");
@@ -2660,6 +3129,22 @@ function generateCSSVars(tokens) {
   lines.push("}", "");
   return lines.join("\n");
 }
+function generateFigmaTokens(tokens) {
+  const out = {};
+  for (const [key, value] of tokens) {
+    const name = key.replace(/^--/, "").replace(/-/g, ".");
+    const type = /color|bg|surface|text|border|primary|secondary|accent|error|warning|success|info/.test(
+      key
+    ) ? "color" : /radius/.test(key) ? "borderRadius" : /shadow/.test(key) ? "shadow" : /gap|space|spacing/.test(key) ? "dimension" : "string";
+    out[name] = {
+      $type: type,
+      $value: value,
+      $description: `Exported from ${key} by Decantr.`
+    };
+  }
+  return `${JSON.stringify(out, null, 2)}
+`;
+}
 async function cmdExport(target, projectRoot, options = {}) {
   const essencePath = join14(projectRoot, "decantr.essence.json");
   const tokensPath = join14(projectRoot, "src", "styles", "tokens.css");
@@ -2710,6 +3195,14 @@ async function cmdExport(target, projectRoot, options = {}) {
       console.log(`  ${DIM3}File:${RESET3} ${out}`);
       break;
     }
+    case "figma-tokens": {
+      const out = options.output ?? join14(projectRoot, ".decantr", "design", "figma-tokens.json");
+      ensureDir(out);
+      writeFileSync8(out, generateFigmaTokens(tokens), "utf-8");
+      console.log(`${GREEN3}Exported Figma/Tokens Studio tokens:${RESET3}`);
+      console.log(`  ${DIM3}File:${RESET3} ${out}`);
+      break;
+    }
   }
 }
 function ensureDir(filePath) {
@@ -4184,6 +4677,7 @@ function resolveDriftEntries(projectRoot, options) {
 }
 
 // src/commands/telemetry.ts
+import { DECANTR_TELEMETRY_EVENT_CATALOG } from "@decantr/telemetry";
 var BOLD5 = "\x1B[1m";
 var CYAN6 = "\x1B[36m";
 var DIM11 = "\x1B[2m";
@@ -4201,6 +4695,10 @@ async function cmdTelemetry(args, projectRoot = process.cwd()) {
     printTelemetryStatus(projectRoot, options);
     return;
   }
+  if (subcommand === "explain") {
+    printTelemetryExplain(projectRoot, options);
+    return;
+  }
   if (subcommand === "link") {
     await linkTelemetryIdentity(projectRoot, options);
     return;
@@ -4213,11 +4711,13 @@ ${BOLD5}decantr telemetry${RESET11} \u2014 Inspect and link privacy-filtered CLI
 
 ${BOLD5}Usage:${RESET11}
   decantr telemetry status [--json]
+  decantr telemetry explain [--json]
   decantr telemetry link [--enable] [--org <slug>] [--label <label>] [--api-key <key>] [--api-url <url>]
 
 ${BOLD5}Examples:${RESET11}
   decantr init --telemetry
   decantr telemetry status
+  decantr telemetry explain
   decantr login --api-key=<your-key>
   decantr telemetry link --org my-team --label "CI runner"
 `);
@@ -4242,6 +4742,82 @@ ${BOLD5}Decantr telemetry${RESET11}`);
     console.log(DIM11 + "Run `decantr init --telemetry` or `decantr telemetry link --enable` to opt in." + RESET11);
   }
 }
+function printTelemetryExplain(projectRoot, options) {
+  const status = getCliTelemetryIdentityStatus(projectRoot, { create: false });
+  const cliEvents = DECANTR_TELEMETRY_EVENT_CATALOG.filter((entry) => entry.allowedSources.includes("cli")).map((entry) => ({
+    name: entry.name,
+    bucket: entry.bucket,
+    privacy: entry.privacy,
+    publicIngest: entry.publicIngest,
+    notes: entry.privacyNotes
+  }));
+  const report = {
+    source: "cli",
+    enabled: status.enabled,
+    hasProjectConfig: status.hasProjectConfig,
+    identifiers: {
+      installId: status.installId ?? null,
+      projectId: status.projectId ?? null,
+      meaning: "Opaque Decantr-generated ids used only when this project has opted into CLI telemetry."
+    },
+    endpoint: process.env.DECANTR_TELEMETRY_ENDPOINT ?? "https://api.decantr.ai/v1/telemetry/events",
+    events: cliEvents,
+    aggregateFields: [
+      "command name",
+      "success or failure",
+      "duration",
+      "workflow and adoption mode",
+      "project scope",
+      "registry source",
+      "aggregate analyze counts",
+      "Project Health status, score, and finding counts",
+      "CI gate outcome",
+      "Studio start and refresh activity",
+      "remediation prompt request outcome"
+    ],
+    neverCollected: [
+      "source code",
+      "prompt text",
+      "local file paths",
+      "repository names",
+      "emails",
+      "secrets",
+      "raw route names",
+      "private package slugs",
+      "health report bodies",
+      "finding evidence"
+    ],
+    controls: {
+      optIn: "Run decantr init --telemetry, decantr new --telemetry, or decantr telemetry link --enable.",
+      optOut: 'Set "telemetry": false in .decantr/project.json.',
+      link: "Run decantr telemetry link after login to attach opaque ids to your Decantr account/org."
+    }
+  };
+  if (options.json) {
+    console.log(JSON.stringify(report, null, 2));
+    return;
+  }
+  console.log(`
+${BOLD5}Decantr telemetry explanation${RESET11}`);
+  console.log(`  Source:     cli`);
+  console.log(`  Enabled:    ${status.enabled ? `${GREEN11}yes${RESET11}` : "no"}`);
+  console.log(`  Install ID: ${status.installId ?? `${DIM11}not created yet${RESET11}`}`);
+  console.log(`  Project ID: ${status.projectId ?? `${DIM11}not created yet${RESET11}`}`);
+  console.log(`  Events:     ${cliEvents.length} CLI event types in the public catalog`);
+  console.log(`
+${BOLD5}Aggregate fields${RESET11}`);
+  for (const field of report.aggregateFields) {
+    console.log(`  - ${field}`);
+  }
+  console.log(`
+${BOLD5}Never collected${RESET11}`);
+  for (const field of report.neverCollected) {
+    console.log(`  - ${field}`);
+  }
+  console.log(`
+${DIM11}${report.controls.optOut}${RESET11}`);
+  console.log(`${DIM11}${report.controls.link}${RESET11}`);
+}
 async function linkTelemetryIdentity(projectRoot, options) {
   if (options.enable && !isOptedIn(projectRoot)) {
     optIn(projectRoot);
@@ -4549,6 +5125,7 @@ async function runInteractivePrompts(detected, archetypes, blueprints, themes, w
     { value: "svelte", label: "svelte", description: "Svelte / SvelteKit" },
     { value: "astro", label: "astro", description: "Astro" },
     { value: "angular", label: "angular", description: "Angular" },
+    { value: "solid", label: "solid", description: "SolidJS" },
     { value: "html", label: "html", description: "Plain HTML/CSS/JS" }
   ];
   let defaultFrameworkIdx = frameworkOptions.findIndex(
@@ -7229,10 +7806,14 @@ ${BOLD7}Usage:${RESET14}
   decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]
   decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]
   decantr health [--format text|json|markdown] [--ci] [--fail-on error|warn|none]
-  decantr health init-ci [--force] [--project <path>] [--fail-on <error|warn|none>] [--cli-version <version|latest>]
+  decantr health --evidence [--browser] [--design-tokens <path>]
+  decantr health init-ci [--force] [--project <path>] [--workspace] [--fail-on <error|warn|none>] [--cli-version <version|latest>]
+  decantr workspace list [--json]
+  decantr workspace health [--json] [--changed --since origin/main]
   decantr content-health [--json] [--markdown] [--ci]
-  decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json]
+  decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json] [--workspace]
   decantr telemetry status [--json]
+  decantr telemetry explain [--json]
   decantr telemetry link [--enable] [--org <slug>]
   decantr rules preview [--project=<path>]
   decantr rules apply [--project=<path>]
@@ -7250,7 +7831,7 @@ ${BOLD7}Init Options:${RESET14}
   --theme            Theme ID
   --mode             Color mode: dark | light | auto
   --shape            Border shape: pill | rounded | sharp
-  --target           Framework: react | vue | svelte | angular | nextjs | nuxt | astro | html
+  --target           Framework: react | vue | svelte | angular | solid | nextjs | nuxt | astro | html
   --guard            Guard mode: creative | guided | strict
   --density          Spacing: compact | comfortable | spacious
   --shell            Default shell layout
@@ -7273,6 +7854,7 @@ ${BOLD7}Commands:${RESET14}
   ${cyan3("init")}        Attach Decantr contract/context files to an existing project or empty workspace
   ${cyan3("status")}      Show project status, DNA axioms, and blueprint info
   ${cyan3("health")}      Generate a local Project Health report [--json] [--markdown] [--ci]; use health init-ci to install a GitHub Actions gate
+  ${cyan3("workspace")}   Discover and aggregate health across Decantr projects in a monorepo
   ${cyan3("content-health")} Generate a local registry content health report [--json] [--markdown] [--ci]
   ${cyan3("studio")}      Open a local Project Health dashboard backed by the same report
   ${cyan3("sync")}        Sync registry content from API
@@ -7316,10 +7898,14 @@ ${BOLD7}Examples:${RESET14}
   decantr health init-ci
   decantr health init-ci --project apps/web
   decantr health --ci --fail-on error
+  decantr health --evidence --output .decantr/evidence/latest.json
+  decantr workspace list
+  decantr workspace health --changed --since origin/main
   decantr content-health --ci --fail-on error
   decantr studio
   decantr studio --report decantr-health.json
   decantr telemetry status
+  decantr telemetry explain
   decantr telemetry link --enable --org my-team
   decantr audit
   decantr audit src/pages/HomePage.tsx
@@ -7348,7 +7934,7 @@ ${BOLD7}Workflow Model:${RESET14}
   ${cyan3("Hybrid composition")}     decantr add/remove, decantr theme switch, decantr registry, decantr upgrade
 
 ${BOLD7}Bootstrap adapters:${RESET14}
-  Runnable starter adapters: ${cyan3("react-vite")}, ${cyan3("next-app")}
+  Runnable starter adapters: ${cyan3("react-vite")}, ${cyan3("next-app")}, ${cyan3("vanilla-vite")}, ${cyan3("vue-vite")}, ${cyan3("sveltekit")}, ${cyan3("angular")}, ${cyan3("solid-vite")}
   Unsupported targets resolve through ${cyan3("generic-web")} contract-only mode until their starter adapters land.
 `);
 }
@@ -7383,7 +7969,8 @@ ${BOLD7}Usage:${RESET14}
   decantr health --markdown
   decantr health --ci [--fail-on error|warn|none]
   decantr health --prompt <finding-id>
-  decantr health init-ci [--force] [--project <path>] [--fail-on error|warn|none] [--cli-version <version|latest>]
+  decantr health --evidence [--browser] [--design-tokens <path>]
+  decantr health init-ci [--force] [--project <path>] [--workspace] [--fail-on error|warn|none] [--cli-version <version|latest>]
 
 ${BOLD7}Options:${RESET14}
   --format      Output format: text, json, or markdown
@@ -7393,6 +7980,9 @@ ${BOLD7}Options:${RESET14}
   --ci          Enable CI exit-code behavior
   --fail-on     CI threshold: error, warn, or none
   --prompt      Print an AI-ready remediation prompt for a finding
+  --evidence    Emit a local Evidence Bundle JSON artifact
+  --browser     Include optional rendered-browser setup/evidence checks
+  --design-tokens Compare against a Figma/Tokens Studio JSON export
 
 ${BOLD7}Examples:${RESET14}
   decantr health
@@ -7400,7 +7990,25 @@ ${BOLD7}Examples:${RESET14}
   decantr health --markdown --output decantr-health.md
   decantr health --ci --fail-on error
   decantr health --prompt audit-essence-missing
+  decantr health --evidence --output .decantr/evidence/latest.json
   decantr health init-ci --project apps/web
+  decantr health init-ci --workspace
+`);
+}
+function cmdWorkspaceHelp() {
+  console.log(`
+${BOLD7}decantr workspace${RESET14} \u2014 Inspect Decantr projects across a monorepo
+
+${BOLD7}Usage:${RESET14}
+  decantr workspace list [--json]
+  decantr workspace health [--json|--markdown] [--output <file>]
+  decantr workspace health --changed --since origin/main
+
+${BOLD7}Examples:${RESET14}
+  decantr workspace list
+  decantr workspace health
+  decantr workspace health --json --output .decantr/workspace-health.json
+  decantr workspace health --changed --since origin/main
 `);
 }
 function cmdContentHealthHelp() {
@@ -7441,6 +8049,7 @@ ${BOLD7}Options:${RESET14}
   --port        Local port to bind; defaults to 4319
   --host        Local host to bind; defaults to 127.0.0.1
   --report      Serve a read-only Project Health JSON artifact instead of scanning the current project
+  --workspace   Serve a monorepo workspace health dashboard
 
 ${BOLD7}Endpoints:${RESET14}
   GET  /
@@ -7453,6 +8062,7 @@ ${BOLD7}Examples:${RESET14}
   decantr studio --host 127.0.0.1 --port 4319
   decantr health --json --output decantr-health.json
   decantr studio --report decantr-health.json
+  decantr studio --workspace
 `);
 }
 async function main() {
@@ -7568,7 +8178,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-PL755AF7.js");
+      const { cmdUpgrade } = await import("./upgrade-XTTGHFG7.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -7592,7 +8202,7 @@ async function main() {
           cmdHealthHelp();
           break;
         }
-        const { cmdHealth, parseHealthArgs } = await import("./health-EENY3BFS.js");
+        const { cmdHealth, parseHealthArgs } = await import("./health-ZXOPGNBZ.js");
         await cmdHealth(process.cwd(), parseHealthArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -7620,7 +8230,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-TBJPZZHA.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-LHQXHBE7.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -7628,6 +8238,20 @@ async function main() {
       }
       break;
     }
+    case "workspace": {
+      try {
+        if (isCommandHelpRequest(args)) {
+          cmdWorkspaceHelp();
+          break;
+        }
+        const { cmdWorkspace } = await import("./workspace-MOLAGT2B.js");
+        await cmdWorkspace(process.cwd(), args);
+      } catch (e) {
+        console.error(error3(e.message));
+        process.exitCode = 1;
+      }
+      break;
+    }
     case "migrate": {
       await cmdMigrate(process.cwd(), args.slice(1));
       break;
@@ -8114,7 +8738,7 @@ async function main() {
           exportOutput = args[i].split("=")[1];
         }
       }
-      const validTargets = ["shadcn", "tailwind", "css-vars"];
+      const validTargets = ["shadcn", "tailwind", "css-vars", "figma-tokens"];
       if (!exportTarget || !validTargets.includes(exportTarget)) {
         console.error(error3(`Usage: decantr export --to <${validTargets.join("|")}>`));
         process.exitCode = 1;