desen-cli 1.0.3-draft

package/.turbo/turbo-build.log

@@ -0,0 +1,5 @@
+
+
+> desen-cli@1.0.3-draft build /Users/selmanay/Desktop/desen/packages/cli
+> tsc
+

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,553 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const desen_core_1 = require("desen-core");
+const express_1 = __importDefault(require("express"));
+const cors_1 = __importDefault(require("cors"));
+const program = new commander_1.Command();
+program
+    .name("desen")
+    .description("DESEN Protocol CLI - Validation & Audit Tool")
+    .version("1.0.0-rc.1");
+// Helper to find json files recursively
+function getJsonFiles(dir, fileList = []) {
+    if (fs_1.default.statSync(dir).isFile() && dir.endsWith('.json')) {
+        fileList.push(dir);
+        return fileList;
+    }
+    if (fs_1.default.statSync(dir).isDirectory()) {
+        const files = fs_1.default.readdirSync(dir);
+        for (const file of files) {
+            const fullPath = path_1.default.join(dir, file);
+            if (fs_1.default.statSync(fullPath).isDirectory()) {
+                getJsonFiles(fullPath, fileList);
+            }
+            else if (fullPath.endsWith('.json')) {
+                fileList.push(fullPath);
+            }
+        }
+    }
+    return fileList;
+}
+// 1. VALIDATE COMMAND (CI/CD Firewall)
+program
+    .command("validate")
+    .description("Validate JSON files against DESEN SurfaceSpec")
+    .argument("<path>", "Directory or file path to validate")
+    .action((targetPath) => {
+    console.log(chalk_1.default.cyan(`\n🔍 DESEN Validation Started for: ${targetPath}`));
+    let hasFailures = false;
+    let totalFiles = 0;
+    try {
+        const targetFullPath = path_1.default.resolve(process.cwd(), targetPath);
+        if (!fs_1.default.existsSync(targetFullPath)) {
+            console.error(chalk_1.default.red(`Path does not exist: ${targetFullPath}`));
+            process.exit(1);
+        }
+        const files = getJsonFiles(targetFullPath);
+        totalFiles = files.length;
+        files.forEach((file) => {
+            try {
+                const content = fs_1.default.readFileSync(file, "utf-8");
+                const jsonData = JSON.parse(content);
+                const result = desen_core_1.surfaceSpec.safeParse(jsonData);
+                if (result.success) {
+                    console.log(chalk_1.default.green(`  [PASS] ${path_1.default.basename(file)}`));
+                }
+                else {
+                    hasFailures = true;
+                    console.log(chalk_1.default.red(`  [FAIL] ${path_1.default.basename(file)}`));
+                    result.error.errors.forEach((err) => {
+                        console.log(chalk_1.default.yellow(`     -> Path [${err.path.join(".")}] : ${err.message}`));
+                    });
+                }
+            }
+            catch (e) {
+                hasFailures = true;
+                console.log(chalk_1.default.red(`  [ERROR] ${path_1.default.basename(file)} - Invalid JSON: ${e.message}`));
+            }
+        });
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`Validation process failed: ${error.message}`));
+        process.exit(1);
+    }
+    console.log("\n---");
+    if (hasFailures) {
+        console.log(chalk_1.default.red.bold(`❌ Validation failed! Some DESEN files are invalid. Pipeline rejected.`));
+        process.exit(1); // Pipeline Break
+    }
+    else {
+        console.log(chalk_1.default.green.bold(`✅ All ${totalFiles} DESEN files passed successfully!`));
+        process.exit(0); // Success
+    }
+});
+// 2. AUDIT COMMAND (Governance & Risk Analysis)
+program
+    .command("audit")
+    .description("Perform Risk Analysis on DESEN JSON files (R1-R3 Levels)")
+    .argument("<path>", "Directory or file to audit")
+    .action((targetPath) => {
+    console.log(chalk_1.default.cyan(`\n🛡  DESEN Governance Audit Started for: ${targetPath}`));
+    try {
+        const targetFullPath = path_1.default.resolve(process.cwd(), targetPath);
+        if (!fs_1.default.existsSync(targetFullPath)) {
+            console.error(chalk_1.default.red(`Path does not exist: ${targetFullPath}`));
+            process.exit(1);
+        }
+        const files = getJsonFiles(targetFullPath);
+        let auditLogCount = 0;
+        files.forEach((file) => {
+            try {
+                const content = fs_1.default.readFileSync(file, "utf-8");
+                const jsonData = JSON.parse(content);
+                let hasWarningsForFile = false;
+                const messages = [];
+                const stringified = JSON.stringify(jsonData);
+                // Basic Risk Detections according to SPEC.md section 5
+                if (!jsonData.telemetry || !jsonData.telemetry.emit) {
+                    hasWarningsForFile = true;
+                    messages.push(chalk_1.default.yellow(`    [R2 RISK] Missing root telemetry. Surfaces must emit observability constraints.`));
+                }
+                if (stringified.includes('"kind":"mutate"')) {
+                    hasWarningsForFile = true;
+                    messages.push(chalk_1.default.magenta(`    [R3 RISK] Action 'mutate' detected. Requires Canary Rollout (A-Mode constraints).`));
+                }
+                if (stringified.includes('x_')) {
+                    hasWarningsForFile = true;
+                    messages.push(chalk_1.default.blue(`    [INFO] Vendor extensions detected (x_ properties). Skipping strict semantic match.`));
+                }
+                if (hasWarningsForFile) {
+                    console.log(chalk_1.default.white(`📝 ${path_1.default.basename(file)}`));
+                    messages.forEach(msg => console.log(msg));
+                    auditLogCount++;
+                }
+            }
+            catch (e) {
+                console.log(chalk_1.default.red(`  Skipping ${path_1.default.basename(file)} (Unparseable)`));
+            }
+        });
+        console.log("\n---");
+        console.log(chalk_1.default.cyan.bold(`📊 Audit complete. Files with risk items found: ${auditLogCount}/${files.length}`));
+        // Only logs, DOES NOT exit 1 for audit warnings.
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`Audit process failed: ${error.message}`));
+        process.exit(1);
+    }
+});
+// 3. DAEMON COMMAND (Local Sync Server)
+program
+    .command("daemon")
+    .description("Start the local sync server for Figma (localhost:3000)")
+    .option("-p, --port <number>", "Port to run the server on", "3000")
+    .action((options) => {
+    const port = parseInt(options.port, 10) || 3000;
+    const app = (0, express_1.default)();
+    app.use((0, cors_1.default)({ origin: '*' }));
+    app.use(express_1.default.json({ limit: "10mb" }));
+    app.get("/", (req, res) => {
+        const html = `
+            <!DOCTYPE html>
+            <html>
+            <head>
+                <title>DESEN Protocol Daemon</title>
+                <style>
+                    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; padding: 60px 20px; background: #0a0a0a; color: #fff; text-align: center; }
+                    .card { background: #111; border: 1px solid #333; padding: 40px; border-radius: 12px; max-width: 600px; margin: 0 auto; box-shadow: 0 10px 30px rgba(0,0,0,0.5); }
+                    h1 { color: #fff; margin-top: 0; font-weight: 600; font-size: 24px; }
+                    p { color: #a1a1aa; line-height: 1.6; font-size: 15px; margin-bottom: 24px; }
+                    .code { background: #000; border: 1px solid #222; padding: 16px; border-radius: 8px; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; color: #4ade80; font-size: 14px; text-align: left; overflow-x: auto; }
+                </style>
+            </head>
+            <body>
+                <div class="card">
+                    <h1>🚀 DESEN Daemon Active</h1>
+                    <p>The Synchronization (Sync) server is waiting for incoming <strong>UI AST</strong> data from Figma. It can safely continue running in the background.</p>
+                    <p>To preview your design live as a standalone application using the <strong>desen</strong> render engine, open a new terminal in your project directory and run the following commands:</p>
+                    <div class="code">cd desen-workspace<br/>npm install<br/>npm run dev</div>
+                </div>
+            </body>
+            </html>
+            `;
+        res.send(html);
+    });
+    app.post("/sync", (req, res) => {
+        try {
+            // Support both legacy {path, ast} and new { payloads: [{path, ast}] }
+            const payloads = req.body.payloads || [{ path: req.body.path, ast: req.body.ast }];
+            if (!payloads || payloads.length === 0 || !payloads[0].path) {
+                return res.status(400).json({ error: "Missing payloads or path in request body" });
+            }
+            // SECURITY BARRICADE: Validate strictly using @desen/core specs before disk IO
+            for (const item of payloads) {
+                if (!item.path || !item.ast)
+                    continue;
+                const result = desen_core_1.surfaceSpec.safeParse(item.ast);
+                if (!result.success) {
+                    console.error(chalk_1.default.red(`❌ [Fail-Closed] Payload validation failed for ${item.path}`));
+                    return res.status(400).json({
+                        error: "Validation failed against desen-core schemas",
+                        path: item.path,
+                        issues: result.error.errors
+                    });
+                }
+            }
+            const projectRoot = process.cwd();
+            const workspaceDir = path_1.default.join(projectRoot, "desen-workspace");
+            let savedCount = 0;
+            for (const item of payloads) {
+                if (!item.path || !item.ast)
+                    continue;
+                const fullPath = path_1.default.join(workspaceDir, item.path);
+                const dirName = path_1.default.dirname(fullPath);
+                if (!fs_1.default.existsSync(dirName)) {
+                    fs_1.default.mkdirSync(dirName, { recursive: true });
+                }
+                fs_1.default.writeFileSync(fullPath, JSON.stringify(item.ast, null, 2), "utf-8");
+                console.log(chalk_1.default.green(`✅ Synced: ${item.path}`));
+                savedCount++;
+            }
+            // -------------------------------------------------------------
+            // SCAFFOLDING LAUNCHER
+            // If this is the first sync (package.json doesn't exist), 
+            // setup a standalone Next.js template for desen
+            // -------------------------------------------------------------
+            const pkgPath = path_1.default.join(workspaceDir, "package.json");
+            if (!fs_1.default.existsSync(pkgPath)) {
+                console.log(chalk_1.default.blue(`\n🛠️  No package.json found. Scaffolding standalone DESEN app...`));
+                // 1. package.json
+                fs_1.default.writeFileSync(pkgPath, JSON.stringify({
+                    name: "desen-workspace-app",
+                    version: "0.1.0",
+                    private: true,
+                    scripts: {
+                        "dev": "next dev -p 3001",
+                        "build": "next build",
+                        "start": "next start"
+                    },
+                    dependencies: {
+                        "desen-core": "latest",
+                        "desen": "latest",
+                        "next": "14.2.3",
+                        "react": "18.3.1",
+                        "react-dom": "18.3.1"
+                    },
+                    devDependencies: {
+                        "@types/node": "^20",
+                        "@types/react": "^18",
+                        "@types/react-dom": "^18",
+                        "typescript": "^5"
+                    }
+                }, null, 2));
+                // 2. tsconfig.json
+                fs_1.default.writeFileSync(path_1.default.join(workspaceDir, "tsconfig.json"), JSON.stringify({
+                    "compilerOptions": {
+                        "target": "es5",
+                        "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" }],
+                        "paths": { "@/*": ["./src/*"] }
+                    },
+                    "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+                    "exclude": ["node_modules"]
+                }, null, 2));
+                // 3. App structure
+                const appDir = path_1.default.join(workspaceDir, "src", "app");
+                fs_1.default.mkdirSync(appDir, { recursive: true });
+                // Find first surface directly
+                const firstSurface = payloads.find((p) => p.path.startsWith('surface/'))?.path || 'surface/frame-1.desen.json';
+                // API Route to load local .desen.json dynamically
+                const apiDir = path_1.default.join(appDir, "api", "surface", "route");
+                fs_1.default.mkdirSync(apiDir, { recursive: true });
+                fs_1.default.writeFileSync(path_1.default.join(apiDir, "route.ts"), `
+import { NextResponse } from 'next/server';
+import { promises as fs } from 'fs';
+import path from 'path';
+
+async function resolveRefs(obj: any, baseDir: string): Promise<any> {
+    if (!obj || typeof obj !== 'object') return obj;
+    if (Array.isArray(obj)) {
+        return Promise.all(obj.map(item => resolveRefs(item, baseDir)));
+    }
+    if (obj.$ref && typeof obj.$ref === 'string') {
+        try {
+            const refPath = path.join(baseDir, obj.$ref);
+            const content = await fs.readFile(refPath, 'utf-8');
+            const resolved = JSON.parse(content);
+            // Recursively resolve inside the loaded ref
+            return await resolveRefs(resolved, baseDir);
+        } catch (e) {
+            console.error("Failed to resolve $ref:", obj.$ref, e);
+            return obj; // Return original if failed
+        }
+    }
+    
+    // Resolve all keys if object
+    const resolvedObj: any = {};
+    for (const [key, value] of Object.entries(obj)) {
+        resolvedObj[key] = await resolveRefs(value, baseDir);
+    }
+    return resolvedObj;
+}
+
+export async function GET() {
+    try {
+        const baseDir = process.cwd();
+        const filePath = path.join(baseDir, '${firstSurface}');
+        const content = await fs.readFile(filePath, 'utf-8');
+        let parsed = JSON.parse(content);
+        
+        parsed = await resolveRefs(parsed, baseDir);
+        
+        return NextResponse.json(parsed);
+    } catch (e) {
+        return NextResponse.json({ error: 'System is waiting for your sync!' }, { status: 404 });
+    }
+}
+                    `.trim());
+                // layout.tsx — with Google Fonts for Figma font support
+                fs_1.default.writeFileSync(path_1.default.join(appDir, "layout.tsx"), `
+import './globals.css';
+
+export const metadata = { title: "DESEN Workspace" };
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+    return (
+        <html lang="en">
+            <head>
+                <link rel="preconnect" href="https://fonts.googleapis.com" />
+                <link rel="preconnect" href="https://fonts.gstatic.com" crossOrigin="anonymous" />
+                <link href="https://fonts.googleapis.com/css2?family=Inter:wght@100;200;300;400;500;600;700;800;900&display=swap" rel="stylesheet" />
+            </head>
+            <body>
+                {children}
+            </body>
+        </html>
+    );
+}
+                    `.trim());
+                // globals.css — proper reset
+                fs_1.default.writeFileSync(path_1.default.join(appDir, "globals.css"), `
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+html, body {
+    width: 100%; min-height: 100vh; margin: 0; padding: 0;
+    font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+    background: #ffffff;
+}
+                    `.trim());
+                // page.tsx — renders the full surface (not data.root)
+                fs_1.default.writeFileSync(path_1.default.join(appDir, "page.tsx"), `
+"use client";
+import React, { useEffect, useState } from "react";
+import { DesenProvider, DesenRenderer } from "desen";
+import { registry } from "../lib/desenRegistry";
+
+export default function Page() {
+    const [data, setData] = useState<any>(null);
+
+    useEffect(() => {
+        const fetchUI = () => {
+            fetch("/api/surface/route")
+                .then(res => res.json())
+                .then(json => { if(!json.error) setData(json) })
+                .catch(e => console.error(e));
+        };
+        fetchUI();
+        const intv = setInterval(fetchUI, 2000);
+        return () => clearInterval(intv);
+    }, []);
+
+    if (!data) return <div style={{padding: 40, fontFamily: 'monospace'}}>Waiting for Figma Sync...</div>;
+
+    // SPEC.md: Surface = full page. Pass full surface object, not data.root.
+    return (
+        <DesenProvider
+            registry={registry}
+            session_id="workspace_session"
+            revision_id="rev_1"
+            onTelemetry={e => console.log("[Telemetry]", e)}
+            onAction={a => console.log("[Action]", a)}
+        >
+            <DesenRenderer node={data} />
+        </DesenProvider>
+    );
+}
+                    `.trim());
+                // Registry
+                const libDir = path_1.default.join(workspaceDir, "src", "lib");
+                fs_1.default.mkdirSync(libDir, { recursive: true });
+                fs_1.default.writeFileSync(path_1.default.join(libDir, "desenRegistry.tsx"), `
+import React from 'react';
+
+function resolveToken(tokenStr: string): string | undefined {
+    if (!tokenStr) return undefined;
+    const match = tokenStr.match(/t_([a-fA-F0-9]{3,8})/);
+    return match ? \`#\${match[1]}\` : undefined;
+}
+
+function resolveColor(tokenStr?: string, hexStr?: string): string | undefined {
+    if (tokenStr) return resolveToken(tokenStr);
+    if (hexStr) return hexStr;
+    return undefined;
+}
+
+function buildCssFromNode(layout: any, style: any, opts?: { isText?: boolean; isSurfaceRoot?: boolean }): React.CSSProperties {
+    const css: any = { boxSizing: 'border-box' };
+
+    if (layout) {
+        css.display = 'flex';
+        css.flexDirection = layout.direction === 'row' ? 'row' : 'column';
+        if (layout.gap !== undefined && layout.gap !== 0) css.gap = layout.gap;
+
+        const am: Record<string, string> = { start:'flex-start', end:'flex-end', center:'center', 'space-between':'space-between', 'space-around':'space-around', 'space-evenly':'space-evenly' };
+        css.alignItems = am[layout.align_items] || 'stretch';
+        css.justifyContent = am[layout.align_content] || 'flex-start';
+
+        if (layout.padding !== undefined) {
+            css.padding = Array.isArray(layout.padding) ? layout.padding.map((p:number)=>p+'px').join(' ') : layout.padding !== 0 ? layout.padding+'px' : undefined;
+        }
+
+        if (opts?.isSurfaceRoot) {
+            css.width = '100%'; css.minHeight = '100vh';
+        } else {
+            if (layout.sizing_h === 'FILL') css.width = '100%';
+            else if (layout.sizing_h === 'FIXED' && style?.width !== undefined) css.width = style.width;
+            if (layout.sizing_v === 'FILL') css.height = '100%';
+            else if (layout.sizing_v === 'FIXED' && style?.height !== undefined) css.height = style.height;
+        }
+    }
+
+    if (style) {
+        const bgColor = resolveColor(style.bg_color_token, style.bg_color);
+        if (bgColor) { if (opts?.isText) css.color = bgColor; else css.backgroundColor = bgColor; }
+        const bc = resolveColor(style.border_color_token, style.border_color);
+        if (bc) css.borderColor = bc;
+        if (style.border_width !== undefined) { css.borderWidth = style.border_width; css.borderStyle = 'solid'; }
+        if (style.border_radius !== undefined) {
+            css.borderRadius = Array.isArray(style.border_radius) ? style.border_radius.map((r:number)=>r+'px').join(' ') : style.border_radius;
+        }
+        if (!layout && !opts?.isText) { if (style.width !== undefined) css.width = style.width; if (style.height !== undefined) css.height = style.height; }
+        if (style.opacity !== undefined) css.opacity = style.opacity;
+        if (style.font_size) css.fontSize = style.font_size;
+        if (style.font_weight) css.fontWeight = style.font_weight;
+        if (style.font_family) css.fontFamily = style.font_family;
+        if (style.letter_spacing) css.letterSpacing = style.letter_spacing;
+        if (style.line_height) css.lineHeight = style.line_height + 'px';
+        if (style.text_align) css.textAlign = style.text_align;
+        if (style.text_decoration) css.textDecoration = style.text_decoration;
+        if (style.text_transform) css.textTransform = style.text_transform;
+    }
+    return css;
+}
+
+const DynamicFontLoader = ({ fonts }: { fonts?: string[] }) => {
+    if (!fonts || fonts.length === 0) return null;
+
+    // Aggregate weights per family for efficient Google Fonts URL
+    const familyMap: Record<string, Set<number>> = {};
+    fonts.forEach(f => {
+        const [family, weight] = f.split(':');
+        if (!familyMap[family]) familyMap[family] = new Set();
+        familyMap[family].add(parseInt(weight) || 400);
+    });
+
+    return (
+        <>
+            {Object.entries(familyMap).map(([family, weights]) => {
+                const weightStr = Array.from(weights).sort().join(';');
+                const url = \`https://fonts.googleapis.com/css2?family=\${family.replace(/ /g, '+')}:wght@\${weightStr}&display=swap\`;
+                return <link key={url} rel="stylesheet" href={url} />;
+            })}
+        </>
+    );
+};
+
+const SurfaceComponent = (props: any) => (
+    <div style={{ width: '100%', minHeight: '100vh', boxSizing: 'border-box' }}>
+        <DynamicFontLoader fonts={props.metadata?.fonts} />
+        {props.children}
+    </div>
+);
+
+const GenericContainer = (props: any) => (
+    <div style={buildCssFromNode(props.layout, props.style, { isSurfaceRoot: props._isSurfaceRoot })}>{props.children}</div>
+);
+
+const TextComponent = (props: any) => (
+    <span style={buildCssFromNode(props.layout, props.style, { isText: true })}>{props.content || props.text || props.name}</span>
+);
+
+const ButtonComponent = (props: any) => {
+    const adjLayout = { ...props.layout };
+    if (adjLayout && !props.children && adjLayout.align_content === 'space-between') adjLayout.align_content = 'center';
+    const css: any = { ...buildCssFromNode(adjLayout, props.style), cursor: 'pointer', border: 'none' };
+    if (props.text_style) {
+        const tc = resolveColor(props.text_style.bg_color_token, props.text_style.bg_color);
+        if (tc) css.color = tc;
+        if (props.text_style.font_size) css.fontSize = props.text_style.font_size;
+        if (props.text_style.font_weight) css.fontWeight = props.text_style.font_weight;
+        if (props.text_style.font_family) css.fontFamily = props.text_style.font_family;
+        if (props.text_style.text_align) css.textAlign = props.text_style.text_align;
+    }
+    return <button style={css}>{props.children || props.content || props.text || props.name}</button>;
+};
+
+export const registry: Record<string, React.FC<any>> = {
+    surface: SurfaceComponent,
+    composition: GenericContainer,
+    frame: GenericContainer,
+    element: GenericContainer,
+    group: GenericContainer,
+    stack: GenericContainer,
+    text: TextComponent,
+    Text: TextComponent,
+    button: ButtonComponent,
+    input: (props: any) => <input style={buildCssFromNode(props.layout, props.style)} placeholder={props.content || props.name} />,
+    icon: (props: any) => <div style={{ ...buildCssFromNode(props.layout, props.style), display:'inline-flex', alignItems:'center', justifyContent:'center' }}>⚙️</div>,
+};
+`.trim());
+                console.log(chalk_1.default.green(`✅ Done! Standalone App Scaffolded.`));
+                // 5. Add to pnpm-workspace.yaml if needed
+                const pnpmYamlPath = path_1.default.join(projectRoot, "pnpm-workspace.yaml");
+                if (fs_1.default.existsSync(pnpmYamlPath)) {
+                    let yamlContent = fs_1.default.readFileSync(pnpmYamlPath, 'utf-8');
+                    if (!yamlContent.includes("desen-workspace")) {
+                        yamlContent += `\n - "desen-workspace"\n`;
+                        fs_1.default.writeFileSync(pnpmYamlPath, yamlContent);
+                        console.log(chalk_1.default.blue(`🛠️  Added 'desen-workspace' to pnpm - workspace.yaml`));
+                    }
+                }
+            } // End if(!package.json)
+            res.status(200).json({ success: true, message: `Successfully saved ${savedCount} files.` });
+        }
+        catch (error) {
+            console.error(chalk_1.default.red("❌ Sync Error:"), error);
+            res.status(500).json({ error: error.message });
+        }
+    });
+    app.listen(port, () => {
+        console.log(chalk_1.default.cyan(`\n🚀 DESEN Sync Daemon running on http://localhost:${port}`));
+        console.log(chalk_1.default.gray(`   Waiting for Figma plugin 'Sync to Localhost' events...`));
+    });
+}); // End setup action
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "desen-cli",
+  "version": "1.0.3-draft",
+  "main": "dist/index.js",
+  "bin": {
+    "desen": "./dist/index.js"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "express": "^4.19.2",
+    "cors": "^2.8.5",
+    "desen-core": "1.0.3-draft"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^20.19.33",
+    "typescript": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc -w",
+    "clean": "rm -rf dist"
+  }
+}

package/src/index.ts

@@ -0,0 +1,594 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import chalk from "chalk";
+import fs from "fs";
+import path from "path";
+import { surfaceSpec } from "desen-core";
+import express from "express";
+import cors from "cors";
+
+const program = new Command();
+
+program
+    .name("desen")
+    .description("DESEN Protocol CLI - Validation & Audit Tool")
+    .version("1.0.0-rc.1");
+
+// Helper to find json files recursively
+function getJsonFiles(dir: string, fileList: string[] = []): string[] {
+    if (fs.statSync(dir).isFile() && dir.endsWith('.json')) {
+        fileList.push(dir);
+        return fileList;
+    }
+
+    if (fs.statSync(dir).isDirectory()) {
+        const files = fs.readdirSync(dir);
+        for (const file of files) {
+            const fullPath = path.join(dir, file);
+            if (fs.statSync(fullPath).isDirectory()) {
+                getJsonFiles(fullPath, fileList);
+            } else if (fullPath.endsWith('.json')) {
+                fileList.push(fullPath);
+            }
+        }
+    }
+    return fileList;
+}
+
+// 1. VALIDATE COMMAND (CI/CD Firewall)
+program
+    .command("validate")
+    .description("Validate JSON files against DESEN SurfaceSpec")
+    .argument("<path>", "Directory or file path to validate")
+    .action((targetPath) => {
+        console.log(chalk.cyan(`\n🔍 DESEN Validation Started for: ${targetPath}`));
+
+        let hasFailures = false;
+        let totalFiles = 0;
+
+        try {
+            const targetFullPath = path.resolve(process.cwd(), targetPath);
+            if (!fs.existsSync(targetFullPath)) {
+                console.error(chalk.red(`Path does not exist: ${targetFullPath}`));
+                process.exit(1);
+            }
+
+            const files = getJsonFiles(targetFullPath);
+            totalFiles = files.length;
+
+            files.forEach((file) => {
+                try {
+                    const content = fs.readFileSync(file, "utf-8");
+                    const jsonData = JSON.parse(content);
+
+                    const result = surfaceSpec.safeParse(jsonData);
+
+                    if (result.success) {
+                        console.log(chalk.green(`  [PASS] ${path.basename(file)}`));
+                    } else {
+                        hasFailures = true;
+                        console.log(chalk.red(`  [FAIL] ${path.basename(file)}`));
+
+                        result.error.errors.forEach((err) => {
+                            console.log(chalk.yellow(`     -> Path [${err.path.join(".")}] : ${err.message}`));
+                        });
+                    }
+                } catch (e: any) {
+                    hasFailures = true;
+                    console.log(chalk.red(`  [ERROR] ${path.basename(file)} - Invalid JSON: ${e.message}`));
+                }
+            });
+
+        } catch (error: any) {
+            console.error(chalk.red(`Validation process failed: ${error.message}`));
+            process.exit(1);
+        }
+
+        console.log("\n---");
+        if (hasFailures) {
+            console.log(chalk.red.bold(`❌ Validation failed! Some DESEN files are invalid. Pipeline rejected.`));
+            process.exit(1); // Pipeline Break
+        } else {
+            console.log(chalk.green.bold(`✅ All ${totalFiles} DESEN files passed successfully!`));
+            process.exit(0); // Success
+        }
+    });
+
+// 2. AUDIT COMMAND (Governance & Risk Analysis)
+program
+    .command("audit")
+    .description("Perform Risk Analysis on DESEN JSON files (R1-R3 Levels)")
+    .argument("<path>", "Directory or file to audit")
+    .action((targetPath) => {
+        console.log(chalk.cyan(`\n🛡  DESEN Governance Audit Started for: ${targetPath}`));
+
+        try {
+            const targetFullPath = path.resolve(process.cwd(), targetPath);
+            if (!fs.existsSync(targetFullPath)) {
+                console.error(chalk.red(`Path does not exist: ${targetFullPath}`));
+                process.exit(1);
+            }
+
+            const files = getJsonFiles(targetFullPath);
+            let auditLogCount = 0;
+
+            files.forEach((file) => {
+                try {
+                    const content = fs.readFileSync(file, "utf-8");
+                    const jsonData = JSON.parse(content);
+
+                    let hasWarningsForFile = false;
+                    const messages: string[] = [];
+
+                    const stringified = JSON.stringify(jsonData);
+
+                    // Basic Risk Detections according to SPEC.md section 5
+                    if (!jsonData.telemetry || !jsonData.telemetry.emit) {
+                        hasWarningsForFile = true;
+                        messages.push(chalk.yellow(`    [R2 RISK] Missing root telemetry. Surfaces must emit observability constraints.`));
+                    }
+
+                    if (stringified.includes('"kind":"mutate"')) {
+                        hasWarningsForFile = true;
+                        messages.push(chalk.magenta(`    [R3 RISK] Action 'mutate' detected. Requires Canary Rollout (A-Mode constraints).`));
+                    }
+
+                    if (stringified.includes('x_')) {
+                        hasWarningsForFile = true;
+                        messages.push(chalk.blue(`    [INFO] Vendor extensions detected (x_ properties). Skipping strict semantic match.`));
+                    }
+
+                    if (hasWarningsForFile) {
+                        console.log(chalk.white(`📝 ${path.basename(file)}`));
+                        messages.forEach(msg => console.log(msg));
+                        auditLogCount++;
+                    }
+
+                } catch (e) {
+                    console.log(chalk.red(`  Skipping ${path.basename(file)} (Unparseable)`));
+                }
+            });
+
+            console.log("\n---");
+            console.log(chalk.cyan.bold(`📊 Audit complete. Files with risk items found: ${auditLogCount}/${files.length}`));
+            // Only logs, DOES NOT exit 1 for audit warnings.
+            process.exit(0);
+
+        } catch (error: any) {
+            console.error(chalk.red(`Audit process failed: ${error.message}`));
+            process.exit(1);
+        }
+    });
+
+// 3. DAEMON COMMAND (Local Sync Server)
+program
+    .command("daemon")
+    .description("Start the local sync server for Figma (localhost:3000)")
+    .option("-p, --port <number>", "Port to run the server on", "3000")
+    .action((options) => {
+        const port = parseInt(options.port, 10) || 3000;
+        const app = express();
+
+        app.use(cors({ origin: '*' }));
+        app.use(express.json({ limit: "10mb" }));
+        app.get("/", (req, res) => {
+            const html = `
+            <!DOCTYPE html>
+            <html>
+            <head>
+                <title>DESEN Protocol Daemon</title>
+                <style>
+                    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif; padding: 60px 20px; background: #0a0a0a; color: #fff; text-align: center; }
+                    .card { background: #111; border: 1px solid #333; padding: 40px; border-radius: 12px; max-width: 600px; margin: 0 auto; box-shadow: 0 10px 30px rgba(0,0,0,0.5); }
+                    h1 { color: #fff; margin-top: 0; font-weight: 600; font-size: 24px; }
+                    p { color: #a1a1aa; line-height: 1.6; font-size: 15px; margin-bottom: 24px; }
+                    .code { background: #000; border: 1px solid #222; padding: 16px; border-radius: 8px; font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace; color: #4ade80; font-size: 14px; text-align: left; overflow-x: auto; }
+                </style>
+            </head>
+            <body>
+                <div class="card">
+                    <h1>🚀 DESEN Daemon Active</h1>
+                    <p>The Synchronization (Sync) server is waiting for incoming <strong>UI AST</strong> data from Figma. It can safely continue running in the background.</p>
+                    <p>To preview your design live as a standalone application using the <strong>desen</strong> render engine, open a new terminal in your project directory and run the following commands:</p>
+                    <div class="code">cd desen-workspace<br/>npm install<br/>npm run dev</div>
+                </div>
+            </body>
+            </html>
+            `;
+            res.send(html);
+        });
+
+        app.post("/sync", (req, res) => {
+            try {
+                // Support both legacy {path, ast} and new { payloads: [{path, ast}] }
+                const payloads = req.body.payloads || [{ path: req.body.path, ast: req.body.ast }];
+
+                if (!payloads || payloads.length === 0 || !payloads[0].path) {
+                    return res.status(400).json({ error: "Missing payloads or path in request body" });
+                }
+
+                // SECURITY BARRICADE: Validate strictly using @desen/core specs before disk IO
+                for (const item of payloads) {
+                    if (!item.path || !item.ast) continue;
+
+                    const result = surfaceSpec.safeParse(item.ast);
+                    if (!result.success) {
+                        console.error(chalk.red(`❌ [Fail-Closed] Payload validation failed for ${item.path}`));
+                        return res.status(400).json({
+                            error: "Validation failed against desen-core schemas",
+                            path: item.path,
+                            issues: result.error.errors
+                        });
+                    }
+                }
+
+                const projectRoot = process.cwd();
+                const workspaceDir = path.join(projectRoot, "desen-workspace");
+
+                let savedCount = 0;
+
+                for (const item of payloads) {
+                    if (!item.path || !item.ast) continue;
+
+                    const fullPath = path.join(workspaceDir, item.path);
+                    const dirName = path.dirname(fullPath);
+
+                    if (!fs.existsSync(dirName)) {
+                        fs.mkdirSync(dirName, { recursive: true });
+                    }
+
+                    fs.writeFileSync(fullPath, JSON.stringify(item.ast, null, 2), "utf-8");
+                    console.log(chalk.green(`✅ Synced: ${item.path}`));
+                    savedCount++;
+                }
+
+                // -------------------------------------------------------------
+                // SCAFFOLDING LAUNCHER
+                // If this is the first sync (package.json doesn't exist), 
+                // setup a standalone Next.js template for desen
+                // -------------------------------------------------------------
+                const pkgPath = path.join(workspaceDir, "package.json");
+                if (!fs.existsSync(pkgPath)) {
+                    console.log(chalk.blue(`\n🛠️  No package.json found. Scaffolding standalone DESEN app...`));
+
+                    // 1. package.json
+                    fs.writeFileSync(pkgPath, JSON.stringify({
+                        name: "desen-workspace-app",
+                        version: "0.1.0",
+                        private: true,
+                        scripts: {
+                            "dev": "next dev -p 3001",
+                            "build": "next build",
+                            "start": "next start"
+                        },
+                        dependencies: {
+                            "desen-core": "latest",
+                            "desen": "latest",
+                            "next": "14.2.3",
+                            "react": "18.3.1",
+                            "react-dom": "18.3.1"
+                        },
+                        devDependencies: {
+                            "@types/node": "^20",
+                            "@types/react": "^18",
+                            "@types/react-dom": "^18",
+                            "typescript": "^5"
+                        }
+                    }, null, 2));
+
+                    // 2. tsconfig.json
+                    fs.writeFileSync(path.join(workspaceDir, "tsconfig.json"), JSON.stringify({
+                        "compilerOptions": {
+                            "target": "es5",
+                            "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" }],
+                            "paths": { "@/*": ["./src/*"] }
+                        },
+                        "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+                        "exclude": ["node_modules"]
+                    }, null, 2));
+
+                    // 3. App structure
+                    const appDir = path.join(workspaceDir, "src", "app");
+                    fs.mkdirSync(appDir, { recursive: true });
+
+                    // Find first surface directly
+                    const firstSurface = payloads.find((p: any) => p.path.startsWith('surface/'))?.path || 'surface/frame-1.desen.json';
+
+                    // API Route to load local .desen.json dynamically
+                    const apiDir = path.join(appDir, "api", "surface", "route");
+                    fs.mkdirSync(apiDir, { recursive: true });
+                    fs.writeFileSync(path.join(apiDir, "route.ts"), `
+import { NextResponse } from 'next/server';
+import { promises as fs } from 'fs';
+import path from 'path';
+
+async function resolveRefs(obj: any, baseDir: string): Promise<any> {
+    if (!obj || typeof obj !== 'object') return obj;
+    if (Array.isArray(obj)) {
+        return Promise.all(obj.map(item => resolveRefs(item, baseDir)));
+    }
+    if (obj.$ref && typeof obj.$ref === 'string') {
+        try {
+            const refPath = path.join(baseDir, obj.$ref);
+            const content = await fs.readFile(refPath, 'utf-8');
+            const resolved = JSON.parse(content);
+            // Recursively resolve inside the loaded ref
+            return await resolveRefs(resolved, baseDir);
+        } catch (e) {
+            console.error("Failed to resolve $ref:", obj.$ref, e);
+            return obj; // Return original if failed
+        }
+    }
+    
+    // Resolve all keys if object
+    const resolvedObj: any = {};
+    for (const [key, value] of Object.entries(obj)) {
+        resolvedObj[key] = await resolveRefs(value, baseDir);
+    }
+    return resolvedObj;
+}
+
+export async function GET() {
+    try {
+        const baseDir = process.cwd();
+        const filePath = path.join(baseDir, '${firstSurface}');
+        const content = await fs.readFile(filePath, 'utf-8');
+        let parsed = JSON.parse(content);
+        
+        parsed = await resolveRefs(parsed, baseDir);
+        
+        return NextResponse.json(parsed);
+    } catch (e) {
+        return NextResponse.json({ error: 'System is waiting for your sync!' }, { status: 404 });
+    }
+}
+                    `.trim());
+
+                    // layout.tsx — with Google Fonts for Figma font support
+                    fs.writeFileSync(path.join(appDir, "layout.tsx"), `
+import './globals.css';
+
+export const metadata = { title: "DESEN Workspace" };
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+    return (
+        <html lang="en">
+            <head>
+                <link rel="preconnect" href="https://fonts.googleapis.com" />
+                <link rel="preconnect" href="https://fonts.gstatic.com" crossOrigin="anonymous" />
+                <link href="https://fonts.googleapis.com/css2?family=Inter:wght@100;200;300;400;500;600;700;800;900&display=swap" rel="stylesheet" />
+            </head>
+            <body>
+                {children}
+            </body>
+        </html>
+    );
+}
+                    `.trim());
+
+                    // globals.css — proper reset
+                    fs.writeFileSync(path.join(appDir, "globals.css"), `
+*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+html, body {
+    width: 100%; min-height: 100vh; margin: 0; padding: 0;
+    font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+    background: #ffffff;
+}
+                    `.trim());
+
+                    // page.tsx — renders the full surface (not data.root)
+                    fs.writeFileSync(path.join(appDir, "page.tsx"), `
+"use client";
+import React, { useEffect, useState } from "react";
+import { DesenProvider, DesenRenderer } from "desen";
+import { registry } from "../lib/desenRegistry";
+
+export default function Page() {
+    const [data, setData] = useState<any>(null);
+
+    useEffect(() => {
+        const fetchUI = () => {
+            fetch("/api/surface/route")
+                .then(res => res.json())
+                .then(json => { if(!json.error) setData(json) })
+                .catch(e => console.error(e));
+        };
+        fetchUI();
+        const intv = setInterval(fetchUI, 2000);
+        return () => clearInterval(intv);
+    }, []);
+
+    if (!data) return <div style={{padding: 40, fontFamily: 'monospace'}}>Waiting for Figma Sync...</div>;
+
+    // SPEC.md: Surface = full page. Pass full surface object, not data.root.
+    return (
+        <DesenProvider
+            registry={registry}
+            session_id="workspace_session"
+            revision_id="rev_1"
+            onTelemetry={e => console.log("[Telemetry]", e)}
+            onAction={a => console.log("[Action]", a)}
+        >
+            <DesenRenderer node={data} />
+        </DesenProvider>
+    );
+}
+                    `.trim());
+
+                    // Registry
+                    const libDir = path.join(workspaceDir, "src", "lib");
+                    fs.mkdirSync(libDir, { recursive: true });
+
+                    fs.writeFileSync(path.join(libDir, "desenRegistry.tsx"), `
+import React from 'react';
+
+function resolveToken(tokenStr: string): string | undefined {
+    if (!tokenStr) return undefined;
+    const match = tokenStr.match(/t_([a-fA-F0-9]{3,8})/);
+    return match ? \`#\${match[1]}\` : undefined;
+}
+
+function resolveColor(tokenStr?: string, hexStr?: string): string | undefined {
+    if (tokenStr) return resolveToken(tokenStr);
+    if (hexStr) return hexStr;
+    return undefined;
+}
+
+function buildCssFromNode(layout: any, style: any, opts?: { isText?: boolean; isSurfaceRoot?: boolean }): React.CSSProperties {
+    const css: any = { boxSizing: 'border-box' };
+
+    if (layout) {
+        css.display = 'flex';
+        css.flexDirection = layout.direction === 'row' ? 'row' : 'column';
+        if (layout.gap !== undefined && layout.gap !== 0) css.gap = layout.gap;
+
+        const am: Record<string, string> = { start:'flex-start', end:'flex-end', center:'center', 'space-between':'space-between', 'space-around':'space-around', 'space-evenly':'space-evenly' };
+        css.alignItems = am[layout.align_items] || 'stretch';
+        css.justifyContent = am[layout.align_content] || 'flex-start';
+
+        if (layout.padding !== undefined) {
+            css.padding = Array.isArray(layout.padding) ? layout.padding.map((p:number)=>p+'px').join(' ') : layout.padding !== 0 ? layout.padding+'px' : undefined;
+        }
+
+        if (opts?.isSurfaceRoot) {
+            css.width = '100%'; css.minHeight = '100vh';
+        } else {
+            if (layout.sizing_h === 'FILL') css.width = '100%';
+            else if (layout.sizing_h === 'FIXED' && style?.width !== undefined) css.width = style.width;
+            if (layout.sizing_v === 'FILL') css.height = '100%';
+            else if (layout.sizing_v === 'FIXED' && style?.height !== undefined) css.height = style.height;
+        }
+    }
+
+    if (style) {
+        const bgColor = resolveColor(style.bg_color_token, style.bg_color);
+        if (bgColor) { if (opts?.isText) css.color = bgColor; else css.backgroundColor = bgColor; }
+        const bc = resolveColor(style.border_color_token, style.border_color);
+        if (bc) css.borderColor = bc;
+        if (style.border_width !== undefined) { css.borderWidth = style.border_width; css.borderStyle = 'solid'; }
+        if (style.border_radius !== undefined) {
+            css.borderRadius = Array.isArray(style.border_radius) ? style.border_radius.map((r:number)=>r+'px').join(' ') : style.border_radius;
+        }
+        if (!layout && !opts?.isText) { if (style.width !== undefined) css.width = style.width; if (style.height !== undefined) css.height = style.height; }
+        if (style.opacity !== undefined) css.opacity = style.opacity;
+        if (style.font_size) css.fontSize = style.font_size;
+        if (style.font_weight) css.fontWeight = style.font_weight;
+        if (style.font_family) css.fontFamily = style.font_family;
+        if (style.letter_spacing) css.letterSpacing = style.letter_spacing;
+        if (style.line_height) css.lineHeight = style.line_height + 'px';
+        if (style.text_align) css.textAlign = style.text_align;
+        if (style.text_decoration) css.textDecoration = style.text_decoration;
+        if (style.text_transform) css.textTransform = style.text_transform;
+    }
+    return css;
+}
+
+const DynamicFontLoader = ({ fonts }: { fonts?: string[] }) => {
+    if (!fonts || fonts.length === 0) return null;
+
+    // Aggregate weights per family for efficient Google Fonts URL
+    const familyMap: Record<string, Set<number>> = {};
+    fonts.forEach(f => {
+        const [family, weight] = f.split(':');
+        if (!familyMap[family]) familyMap[family] = new Set();
+        familyMap[family].add(parseInt(weight) || 400);
+    });
+
+    return (
+        <>
+            {Object.entries(familyMap).map(([family, weights]) => {
+                const weightStr = Array.from(weights).sort().join(';');
+                const url = \`https://fonts.googleapis.com/css2?family=\${family.replace(/ /g, '+')}:wght@\${weightStr}&display=swap\`;
+                return <link key={url} rel="stylesheet" href={url} />;
+            })}
+        </>
+    );
+};
+
+const SurfaceComponent = (props: any) => (
+    <div style={{ width: '100%', minHeight: '100vh', boxSizing: 'border-box' }}>
+        <DynamicFontLoader fonts={props.metadata?.fonts} />
+        {props.children}
+    </div>
+);
+
+const GenericContainer = (props: any) => (
+    <div style={buildCssFromNode(props.layout, props.style, { isSurfaceRoot: props._isSurfaceRoot })}>{props.children}</div>
+);
+
+const TextComponent = (props: any) => (
+    <span style={buildCssFromNode(props.layout, props.style, { isText: true })}>{props.content || props.text || props.name}</span>
+);
+
+const ButtonComponent = (props: any) => {
+    const adjLayout = { ...props.layout };
+    if (adjLayout && !props.children && adjLayout.align_content === 'space-between') adjLayout.align_content = 'center';
+    const css: any = { ...buildCssFromNode(adjLayout, props.style), cursor: 'pointer', border: 'none' };
+    if (props.text_style) {
+        const tc = resolveColor(props.text_style.bg_color_token, props.text_style.bg_color);
+        if (tc) css.color = tc;
+        if (props.text_style.font_size) css.fontSize = props.text_style.font_size;
+        if (props.text_style.font_weight) css.fontWeight = props.text_style.font_weight;
+        if (props.text_style.font_family) css.fontFamily = props.text_style.font_family;
+        if (props.text_style.text_align) css.textAlign = props.text_style.text_align;
+    }
+    return <button style={css}>{props.children || props.content || props.text || props.name}</button>;
+};
+
+export const registry: Record<string, React.FC<any>> = {
+    surface: SurfaceComponent,
+    composition: GenericContainer,
+    frame: GenericContainer,
+    element: GenericContainer,
+    group: GenericContainer,
+    stack: GenericContainer,
+    text: TextComponent,
+    Text: TextComponent,
+    button: ButtonComponent,
+    input: (props: any) => <input style={buildCssFromNode(props.layout, props.style)} placeholder={props.content || props.name} />,
+    icon: (props: any) => <div style={{ ...buildCssFromNode(props.layout, props.style), display:'inline-flex', alignItems:'center', justifyContent:'center' }}>⚙️</div>,
+};
+`.trim());
+
+                    console.log(chalk.green(`✅ Done! Standalone App Scaffolded.`));
+
+                    // 5. Add to pnpm-workspace.yaml if needed
+                    const pnpmYamlPath = path.join(projectRoot, "pnpm-workspace.yaml");
+                    if (fs.existsSync(pnpmYamlPath)) {
+                        let yamlContent = fs.readFileSync(pnpmYamlPath, 'utf-8');
+                        if (!yamlContent.includes("desen-workspace")) {
+                            yamlContent += `\n - "desen-workspace"\n`;
+                            fs.writeFileSync(pnpmYamlPath, yamlContent);
+                            console.log(chalk.blue(`🛠️  Added 'desen-workspace' to pnpm - workspace.yaml`));
+                        }
+                    }
+                } // End if(!package.json)
+
+                res.status(200).json({ success: true, message: `Successfully saved ${savedCount} files.` });
+            } catch (error: any) {
+                console.error(chalk.red("❌ Sync Error:"), error);
+                res.status(500).json({ error: error.message });
+            }
+        });
+
+        app.listen(port, () => {
+            console.log(chalk.cyan(`\n🚀 DESEN Sync Daemon running on http://localhost:${port}`));
+            console.log(chalk.gray(`   Waiting for Figma plugin 'Sync to Localhost' events...`));
+        });
+    }); // End setup action
+
+program.parse(process.argv);

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "CommonJS",
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}