@su-record/vibe 2.9.25 → 2.9.32

package/dist/infra/lib/evolution/SkillBenchmark.js

@@ -16,18 +16,18 @@ export class SkillBenchmark {
         this.initializeTables();
     }
     initializeTables() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS skill_benchmarks (
-        id TEXT PRIMARY KEY,
-        skillName TEXT NOT NULL,
-        iteration INTEGER NOT NULL,
-        summary TEXT NOT NULL,
-        evalBreakdowns TEXT NOT NULL,
-        createdAt TEXT NOT NULL
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_sb_skill ON skill_benchmarks(skillName);
-      CREATE INDEX IF NOT EXISTS idx_sb_iter ON skill_benchmarks(skillName, iteration);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS skill_benchmarks (
+        id TEXT PRIMARY KEY,
+        skillName TEXT NOT NULL,
+        iteration INTEGER NOT NULL,
+        summary TEXT NOT NULL,
+        evalBreakdowns TEXT NOT NULL,
+        createdAt TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_sb_skill ON skill_benchmarks(skillName);
+      CREATE INDEX IF NOT EXISTS idx_sb_iter ON skill_benchmarks(skillName, iteration);
     `);
     }
     /**
@@ -74,9 +74,9 @@ export class SkillBenchmark {
         };
         const id = `bench-${Date.now().toString(36)}-${randomUUID().replace(/-/g, '').slice(0, 8)}`;
         const now = new Date().toISOString();
-        this.db.prepare(`
-      INSERT INTO skill_benchmarks (id, skillName, iteration, summary, evalBreakdowns, createdAt)
-      VALUES (?, ?, ?, ?, ?, ?)
+        this.db.prepare(`
+      INSERT INTO skill_benchmarks (id, skillName, iteration, summary, evalBreakdowns, createdAt)
+      VALUES (?, ?, ?, ?, ?, ?)
     `).run(id, skillName, iteration, JSON.stringify(summary), JSON.stringify(breakdowns), now);
         return { id, skillName, iteration, timestamp: now, summary, evalBreakdowns: breakdowns };
     }
@@ -84,8 +84,8 @@ export class SkillBenchmark {
      * Get benchmark history for a skill
      */
     getHistory(skillName) {
-        const rows = this.db.prepare(`
-      SELECT * FROM skill_benchmarks WHERE skillName = ? ORDER BY iteration ASC
+        const rows = this.db.prepare(`
+      SELECT * FROM skill_benchmarks WHERE skillName = ? ORDER BY iteration ASC
     `).all(skillName);
         return rows.map(this.rowToBenchmark);
     }
@@ -93,8 +93,8 @@ export class SkillBenchmark {
      * Get the latest benchmark for a skill
      */
     getLatest(skillName) {
-        const row = this.db.prepare(`
-      SELECT * FROM skill_benchmarks WHERE skillName = ? ORDER BY iteration DESC LIMIT 1
+        const row = this.db.prepare(`
+      SELECT * FROM skill_benchmarks WHERE skillName = ? ORDER BY iteration DESC LIMIT 1
     `).get(skillName);
         return row ? this.rowToBenchmark(row) : null;
     }
@@ -158,14 +158,14 @@ export class SkillBenchmark {
         return lines.join('\n');
     }
     getBenchmarkByIteration(skillName, iteration) {
-        const row = this.db.prepare(`
-      SELECT * FROM skill_benchmarks WHERE skillName = ? AND iteration = ?
+        const row = this.db.prepare(`
+      SELECT * FROM skill_benchmarks WHERE skillName = ? AND iteration = ?
     `).get(skillName, iteration);
         return row ? this.rowToBenchmark(row) : null;
     }
     getNextIteration(skillName) {
-        const row = this.db.prepare(`
-      SELECT MAX(iteration) as maxIter FROM skill_benchmarks WHERE skillName = ?
+        const row = this.db.prepare(`
+      SELECT MAX(iteration) as maxIter FROM skill_benchmarks WHERE skillName = ?
     `).get(skillName);
         return (row.maxIter ?? 0) + 1;
     }

package/dist/infra/lib/evolution/SkillEvalRunner.js

@@ -14,36 +14,36 @@ export class SkillEvalRunner {
         this.initializeTables();
     }
     initializeTables() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS skill_eval_cases (
-        id TEXT PRIMARY KEY,
-        skillName TEXT NOT NULL,
-        prompt TEXT NOT NULL,
-        expectedOutput TEXT NOT NULL,
-        files TEXT DEFAULT '[]',
-        assertions TEXT DEFAULT '[]',
-        createdAt TEXT NOT NULL,
-        updatedAt TEXT NOT NULL
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_sec_skill ON skill_eval_cases(skillName);
-
-      CREATE TABLE IF NOT EXISTS skill_eval_runs (
-        id TEXT PRIMARY KEY,
-        evalId TEXT NOT NULL,
-        skillName TEXT NOT NULL,
-        variant TEXT NOT NULL CHECK(variant IN ('with_skill','baseline')),
-        status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','running','passed','failed','error')),
-        output TEXT DEFAULT '',
-        grades TEXT DEFAULT '[]',
-        durationMs INTEGER DEFAULT 0,
-        tokenCount INTEGER DEFAULT 0,
-        createdAt TEXT NOT NULL
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_ser_eval ON skill_eval_runs(evalId);
-      CREATE INDEX IF NOT EXISTS idx_ser_skill ON skill_eval_runs(skillName);
-      CREATE INDEX IF NOT EXISTS idx_ser_variant ON skill_eval_runs(variant);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS skill_eval_cases (
+        id TEXT PRIMARY KEY,
+        skillName TEXT NOT NULL,
+        prompt TEXT NOT NULL,
+        expectedOutput TEXT NOT NULL,
+        files TEXT DEFAULT '[]',
+        assertions TEXT DEFAULT '[]',
+        createdAt TEXT NOT NULL,
+        updatedAt TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_sec_skill ON skill_eval_cases(skillName);
+
+      CREATE TABLE IF NOT EXISTS skill_eval_runs (
+        id TEXT PRIMARY KEY,
+        evalId TEXT NOT NULL,
+        skillName TEXT NOT NULL,
+        variant TEXT NOT NULL CHECK(variant IN ('with_skill','baseline')),
+        status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','running','passed','failed','error')),
+        output TEXT DEFAULT '',
+        grades TEXT DEFAULT '[]',
+        durationMs INTEGER DEFAULT 0,
+        tokenCount INTEGER DEFAULT 0,
+        createdAt TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_ser_eval ON skill_eval_runs(evalId);
+      CREATE INDEX IF NOT EXISTS idx_ser_skill ON skill_eval_runs(skillName);
+      CREATE INDEX IF NOT EXISTS idx_ser_variant ON skill_eval_runs(variant);
     `);
     }
     /**
@@ -52,9 +52,9 @@ export class SkillEvalRunner {
     createEvalSet(input) {
         const cases = [];
         const now = new Date().toISOString();
-        const insertStmt = this.db.prepare(`
-      INSERT INTO skill_eval_cases (id, skillName, prompt, expectedOutput, files, assertions, createdAt, updatedAt)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        const insertStmt = this.db.prepare(`
+      INSERT INTO skill_eval_cases (id, skillName, prompt, expectedOutput, files, assertions, createdAt, updatedAt)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
     `);
         const insertMany = this.db.transaction((evals) => {
             for (const evalCase of evals) {
@@ -83,8 +83,8 @@ export class SkillEvalRunner {
      * Get all eval cases for a skill
      */
     getEvalCases(skillName) {
-        const rows = this.db.prepare(`
-      SELECT * FROM skill_eval_cases WHERE skillName = ? ORDER BY createdAt ASC
+        const rows = this.db.prepare(`
+      SELECT * FROM skill_eval_cases WHERE skillName = ? ORDER BY createdAt ASC
     `).all(skillName);
         return rows.map(this.rowToEvalCase);
     }
@@ -92,8 +92,8 @@ export class SkillEvalRunner {
      * Get a single eval case by ID
      */
     getEvalCase(evalId) {
-        const row = this.db.prepare(`
-      SELECT * FROM skill_eval_cases WHERE id = ?
+        const row = this.db.prepare(`
+      SELECT * FROM skill_eval_cases WHERE id = ?
     `).get(evalId);
         return row ? this.rowToEvalCase(row) : null;
     }
@@ -103,9 +103,9 @@ export class SkillEvalRunner {
     startRun(evalId, skillName, variant) {
         const id = `run-${Date.now().toString(36)}-${randomUUID().replace(/-/g, '').slice(0, 8)}`;
         const now = new Date().toISOString();
-        this.db.prepare(`
-      INSERT INTO skill_eval_runs (id, evalId, skillName, variant, status, createdAt)
-      VALUES (?, ?, ?, ?, 'running', ?)
+        this.db.prepare(`
+      INSERT INTO skill_eval_runs (id, evalId, skillName, variant, status, createdAt)
+      VALUES (?, ?, ?, ?, 'running', ?)
     `).run(id, evalId, skillName, variant, now);
         return id;
     }
@@ -115,18 +115,18 @@ export class SkillEvalRunner {
     completeRun(runId, output, grades, durationMs, tokenCount) {
         const allPassed = grades.length === 0 || grades.every(g => g.passed);
         const status = allPassed ? 'passed' : 'failed';
-        this.db.prepare(`
-      UPDATE skill_eval_runs
-      SET status = ?, output = ?, grades = ?, durationMs = ?, tokenCount = ?
-      WHERE id = ?
+        this.db.prepare(`
+      UPDATE skill_eval_runs
+      SET status = ?, output = ?, grades = ?, durationMs = ?, tokenCount = ?
+      WHERE id = ?
     `).run(status, output, JSON.stringify(grades), durationMs, tokenCount, runId);
     }
     /**
      * Mark a run as errored
      */
     failRun(runId, errorMessage) {
-        this.db.prepare(`
-      UPDATE skill_eval_runs SET status = 'error', output = ? WHERE id = ?
+        this.db.prepare(`
+      UPDATE skill_eval_runs SET status = 'error', output = ? WHERE id = ?
     `).run(errorMessage, runId);
     }
     /**
@@ -181,8 +181,8 @@ export class SkillEvalRunner {
      * Get all runs for an eval case
      */
     getRunsForEval(evalId) {
-        const rows = this.db.prepare(`
-      SELECT * FROM skill_eval_runs WHERE evalId = ? ORDER BY createdAt DESC
+        const rows = this.db.prepare(`
+      SELECT * FROM skill_eval_runs WHERE evalId = ? ORDER BY createdAt DESC
     `).all(evalId);
         return rows.map(this.rowToRunResult);
     }
@@ -190,8 +190,8 @@ export class SkillEvalRunner {
      * Get all runs for a skill
      */
     getRunsForSkill(skillName) {
-        const rows = this.db.prepare(`
-      SELECT * FROM skill_eval_runs WHERE skillName = ? ORDER BY createdAt DESC
+        const rows = this.db.prepare(`
+      SELECT * FROM skill_eval_runs WHERE skillName = ? ORDER BY createdAt DESC
     `).all(skillName);
         return rows.map(this.rowToRunResult);
     }

package/dist/infra/lib/evolution/SkillGapDetector.js

@@ -17,9 +17,9 @@ export class SkillGapDetector {
         const truncated = prompt.slice(0, 200);
         const normalized = truncated.toLowerCase().replace(/\s+/g, ' ').trim();
         try {
-            this.db.prepare(`
-        INSERT INTO skill_gaps (id, prompt, normalizedPrompt, sessionId, createdAt)
-        VALUES (?, ?, ?, ?, ?)
+            this.db.prepare(`
+        INSERT INTO skill_gaps (id, prompt, normalizedPrompt, sessionId, createdAt)
+        VALUES (?, ?, ?, ?, ?)
       `).run(id, truncated, normalized, sessionId || null, new Date().toISOString());
         }
         catch {
@@ -33,13 +33,13 @@ export class SkillGapDetector {
         const result = { newGaps: [], totalClusters: 0 };
         try {
             // Cluster by normalizedPrompt
-            const clusters = this.db.prepare(`
-        SELECT normalizedPrompt, COUNT(*) as count, GROUP_CONCAT(prompt, '|||') as prompts
-        FROM skill_gaps
-        GROUP BY normalizedPrompt
-        HAVING count >= 3
-        ORDER BY count DESC
-        LIMIT ?
+            const clusters = this.db.prepare(`
+        SELECT normalizedPrompt, COUNT(*) as count, GROUP_CONCAT(prompt, '|||') as prompts
+        FROM skill_gaps
+        GROUP BY normalizedPrompt
+        HAVING count >= 3
+        ORDER BY count DESC
+        LIMIT ?
       `).all(limit);
             result.totalClusters = clusters.length;
             for (const cluster of clusters) {

package/dist/infra/lib/evolution/UsageTracker.js

@@ -11,20 +11,20 @@ export class UsageTracker {
         this.initializeTables();
     }
     initializeTables() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS usage_events (
-        id TEXT PRIMARY KEY,
-        generationId TEXT NOT NULL,
-        sessionId TEXT,
-        matchedPrompt TEXT,
-        feedback TEXT CHECK(feedback IN ('positive','negative','neutral') OR feedback IS NULL),
-        createdAt TEXT NOT NULL
-      );
-
-      CREATE INDEX IF NOT EXISTS idx_ue_gen ON usage_events(generationId);
-      CREATE INDEX IF NOT EXISTS idx_ue_session ON usage_events(sessionId);
-      CREATE INDEX IF NOT EXISTS idx_ue_feedback ON usage_events(feedback);
-      CREATE INDEX IF NOT EXISTS idx_ue_created ON usage_events(createdAt);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS usage_events (
+        id TEXT PRIMARY KEY,
+        generationId TEXT NOT NULL,
+        sessionId TEXT,
+        matchedPrompt TEXT,
+        feedback TEXT CHECK(feedback IN ('positive','negative','neutral') OR feedback IS NULL),
+        createdAt TEXT NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_ue_gen ON usage_events(generationId);
+      CREATE INDEX IF NOT EXISTS idx_ue_session ON usage_events(sessionId);
+      CREATE INDEX IF NOT EXISTS idx_ue_feedback ON usage_events(feedback);
+      CREATE INDEX IF NOT EXISTS idx_ue_created ON usage_events(createdAt);
     `);
     }
     /**
@@ -33,9 +33,9 @@ export class UsageTracker {
     recordUsage(generationId, sessionId, matchedPrompt) {
         const id = `ue-${Date.now().toString(36)}-${randomUUID().replace(/-/g, '').slice(0, 8)}`;
         const now = new Date().toISOString();
-        this.db.prepare(`
-      INSERT INTO usage_events (id, generationId, sessionId, matchedPrompt, createdAt)
-      VALUES (?, ?, ?, ?, ?)
+        this.db.prepare(`
+      INSERT INTO usage_events (id, generationId, sessionId, matchedPrompt, createdAt)
+      VALUES (?, ?, ?, ?, ?)
     `).run(id, generationId, sessionId || null, matchedPrompt || null, now);
         // Also increment usage count in generations table
         this.registry.incrementUsage(generationId);
@@ -45,8 +45,8 @@ export class UsageTracker {
      * Record explicit user feedback for a usage event
      */
     setFeedback(eventId, feedback) {
-        const result = this.db.prepare(`
-      UPDATE usage_events SET feedback = ? WHERE id = ?
+        const result = this.db.prepare(`
+      UPDATE usage_events SET feedback = ? WHERE id = ?
     `).run(feedback, eventId);
         return result.changes > 0;
     }
@@ -54,8 +54,8 @@ export class UsageTracker {
      * Record explicit feedback for a generation (latest event)
      */
     setFeedbackForGeneration(generationId, feedback) {
-        const event = this.db.prepare(`
-      SELECT id FROM usage_events WHERE generationId = ? ORDER BY createdAt DESC LIMIT 1
+        const event = this.db.prepare(`
+      SELECT id FROM usage_events WHERE generationId = ? ORDER BY createdAt DESC LIMIT 1
     `).get(generationId);
         if (!event)
             return false;
@@ -76,9 +76,9 @@ export class UsageTracker {
             feedback = 'neutral';
         }
         // Only apply to events without explicit feedback
-        const result = this.db.prepare(`
-      UPDATE usage_events SET feedback = ?
-      WHERE sessionId = ? AND feedback IS NULL
+        const result = this.db.prepare(`
+      UPDATE usage_events SET feedback = ?
+      WHERE sessionId = ? AND feedback IS NULL
     `).run(feedback, sessionId);
         return result.changes;
     }
@@ -86,8 +86,8 @@ export class UsageTracker {
      * Get usage events for a generation
      */
     getByGeneration(generationId) {
-        const rows = this.db.prepare(`
-      SELECT * FROM usage_events WHERE generationId = ? ORDER BY createdAt DESC
+        const rows = this.db.prepare(`
+      SELECT * FROM usage_events WHERE generationId = ? ORDER BY createdAt DESC
     `).all(generationId);
         return rows.map(this.rowToEvent);
     }
@@ -138,8 +138,8 @@ export class UsageTracker {
      * Get total usage count for a generation
      */
     getUsageCount(generationId) {
-        const result = this.db.prepare(`
-      SELECT COUNT(*) as cnt FROM usage_events WHERE generationId = ?
+        const result = this.db.prepare(`
+      SELECT COUNT(*) as cnt FROM usage_events WHERE generationId = ?
     `).get(generationId);
         return result.cnt;
     }

package/dist/infra/lib/figma/audit.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Figma Node Audit — pre-implementation gate that flags properties which
+ * Figma's native renderer supports but the browser CSS engine does not
+ * (or translates differently). Designer fixes these BEFORE AI reads the
+ * file, so the MCP / REST pipeline never sees them.
+ *
+ * Three failure classes from the Figma↔CSS gap analysis:
+ *   1. Mistranslation        — caught by compareRaw (step 4)
+ *   2. Unsupported property  — THIS MODULE (step 0)
+ *   3. Silent drop           — extract.ts now warns instead of dropping
+ */
+export type AuditSeverity = 'P1' | 'P2';
+export interface AuditFinding {
+    nodeId: string;
+    /** "Frame / Card / Title" — dot-joined name trail for designer navigation. */
+    path: string;
+    name: string;
+    type: string;
+    property: string;
+    value: string;
+    severity: AuditSeverity;
+    /** What breaks in the browser. */
+    note: string;
+    /** Designer-facing remediation. */
+    action: string;
+}
+export interface AuditReport {
+    fileKey: string;
+    nodeId: string;
+    scannedNodes: number;
+    findings: AuditFinding[];
+    p1Count: number;
+    p2Count: number;
+}
+export declare function auditNode(fileKey: string, nodeId: string, depth?: number): Promise<AuditReport>;
+export declare function formatAuditReport(report: AuditReport): string;
+//# sourceMappingURL=audit.d.ts.map

package/dist/infra/lib/figma/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../../../src/infra/lib/figma/audit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,aAAa,CAAC;IACxB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AA2FD,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAsBrG;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAiB7D"}

package/dist/infra/lib/figma/audit.js

@@ -0,0 +1,130 @@
+/**
+ * Figma Node Audit — pre-implementation gate that flags properties which
+ * Figma's native renderer supports but the browser CSS engine does not
+ * (or translates differently). Designer fixes these BEFORE AI reads the
+ * file, so the MCP / REST pipeline never sees them.
+ *
+ * Three failure classes from the Figma↔CSS gap analysis:
+ *   1. Mistranslation        — caught by compareRaw (step 4)
+ *   2. Unsupported property  — THIS MODULE (step 0)
+ *   3. Silent drop           — extract.ts now warns instead of dropping
+ */
+import { figmaFetch, loadToken } from './api.js';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const UNSUPPORTED_BLEND_MODES = new Set([
+    'LINEAR_BURN',
+    'LINEAR_DODGE',
+    'PLUS_DARKER',
+    'PLUS_LIGHTER',
+]);
+function pushFrom(node, trail, findings) {
+    const path = trail.join(' / ') || node.name || node.id;
+    const base = { nodeId: node.id, path, name: node.name ?? '', type: node.type };
+    // 1. stroke alignment — CSS border is always centered; INSIDE/OUTSIDE
+    //    shift layout box vs. visual box and have no direct equivalent.
+    if (node.strokes?.length && node.strokeAlign && node.strokeAlign !== 'CENTER') {
+        findings.push({
+            ...base,
+            property: 'strokeAlign',
+            value: String(node.strokeAlign),
+            severity: 'P1',
+            note: 'CSS border is always drawn centered on the path — INSIDE/OUTSIDE shifts do not translate.',
+            action: `Change stroke alignment to CENTER in Figma (current: ${node.strokeAlign}).`,
+        });
+    }
+    // 2. blend modes without a CSS mix-blend-mode equivalent.
+    if (node.blendMode && UNSUPPORTED_BLEND_MODES.has(node.blendMode)) {
+        findings.push({
+            ...base,
+            property: 'blendMode',
+            value: String(node.blendMode),
+            severity: 'P1',
+            note: 'CSS mix-blend-mode has no equivalent — Figma renderer only.',
+            action: `Replace with a supported blend mode (MULTIPLY / SCREEN / OVERLAY / …) or bake into the asset.`,
+        });
+    }
+    // 3. vertical trim / leading-trim → text-box-trim, Firefox unsupported as of 2026-04.
+    if (node.style && (node.style.leadingTrim || node.style.textBoxTrim)) {
+        findings.push({
+            ...base,
+            property: 'style.leadingTrim',
+            value: String(node.style.leadingTrim ?? node.style.textBoxTrim),
+            severity: 'P2',
+            note: 'Maps to CSS text-box-trim — not supported in Firefox yet, inconsistent across engines.',
+            action: 'Disable vertical trim in Figma, rely on explicit line-height instead.',
+        });
+    }
+    // 4. Constraints set to SCALE or CENTER — semantics differ from CSS position:absolute fixed offsets.
+    for (const axis of ['horizontal', 'vertical']) {
+        const v = node.constraints?.[axis];
+        if (v === 'SCALE' || v === 'CENTER') {
+            findings.push({
+                ...base,
+                property: `constraints.${axis}`,
+                value: String(v),
+                severity: 'P2',
+                note: `Constraints.${axis}=${v} scales/centers relative to parent — CSS position: absolute uses fixed offsets, behaviour diverges on resize.`,
+                action: `Switch to LEFT / RIGHT / TOP / BOTTOM / LEFT_RIGHT / TOP_BOTTOM, or use Auto Layout instead.`,
+            });
+        }
+    }
+    // 5. individualStrokeWeights with non-CENTER align compounds problem 1.
+    if (node.individualStrokeWeights && node.strokeAlign && node.strokeAlign !== 'CENTER') {
+        findings.push({
+            ...base,
+            property: 'individualStrokeWeights',
+            value: 'set with non-center alignment',
+            severity: 'P2',
+            note: 'Per-side stroke widths + INSIDE/OUTSIDE alignment compounds — CSS border-width per-side is centered only.',
+            action: 'Keep per-side widths but set strokeAlign=CENTER.',
+        });
+    }
+}
+function walkAudit(node, trail, findings, counter) {
+    counter.n += 1;
+    const nextTrail = [...trail, node.name ?? node.id];
+    pushFrom(node, nextTrail, findings);
+    if (node.children?.length) {
+        for (const child of node.children)
+            walkAudit(child, nextTrail, findings, counter);
+    }
+}
+/* eslint-enable @typescript-eslint/no-explicit-any */
+export async function auditNode(fileKey, nodeId, depth) {
+    const token = loadToken();
+    const depthParam = depth ? `&depth=${depth}` : '';
+    const data = await figmaFetch(`/files/${fileKey}/nodes?ids=${nodeId}${depthParam}`, token);
+    const doc = data.nodes?.[nodeId]?.document;
+    if (!doc)
+        throw new Error(`Node ${nodeId} not found in file ${fileKey}`);
+    const findings = [];
+    const counter = { n: 0 };
+    walkAudit(doc, [], findings, counter);
+    return {
+        fileKey,
+        nodeId,
+        scannedNodes: counter.n,
+        findings,
+        p1Count: findings.filter((f) => f.severity === 'P1').length,
+        p2Count: findings.filter((f) => f.severity === 'P2').length,
+    };
+}
+export function formatAuditReport(report) {
+    const lines = [];
+    lines.push(`Figma Audit — ${report.fileKey} / ${report.nodeId}`);
+    lines.push(`Scanned ${report.scannedNodes} nodes · P1=${report.p1Count} P2=${report.p2Count}`);
+    lines.push('');
+    if (report.findings.length === 0) {
+        lines.push('✓ No CSS-incompatible properties found.');
+        return lines.join('\n');
+    }
+    for (const f of report.findings) {
+        lines.push(`[${f.severity}] ${f.path}`);
+        lines.push(`  property: ${f.property} = ${f.value}`);
+        lines.push(`  reason:   ${f.note}`);
+        lines.push(`  action:   ${f.action}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=audit.js.map

package/dist/infra/lib/figma/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../../../src/infra/lib/figma/audit.ts"],"names":[],"mappings":"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"}

package/dist/infra/lib/figma/extract.d.ts

@@ -1,9 +1,29 @@
 /**
  * Figma 노드 → CSS 추출 + 트리 워커
  */
-import type { FigmaNode, FigmaImageMap, FigmaTreeOptions, FigmaImageOptions, FigmaScreenshotOptions } from './types.js';
+import type { FigmaNode, FigmaRawProps, FigmaWarning, FigmaImageMap, FigmaTreeOptions, FigmaImageOptions, FigmaScreenshotOptions } from './types.js';
 export declare function getTree(options: FigmaTreeOptions): Promise<FigmaNode>;
 export declare function collectImageRefs(node: FigmaNode, refs?: Set<string>): Set<string>;
+/** Flat list of nodes with their raw numeric values — input for compareRaw. */
+export declare function collectRawNodes(node: FigmaNode, out?: Array<{
+    nodeId: string;
+    name: string;
+    raw: FigmaRawProps;
+}>): Array<{
+    nodeId: string;
+    name: string;
+    raw: FigmaRawProps;
+}>;
+/** Flat list of every extraction warning in the tree (silent-drop replacement). */
+export declare function collectWarnings(node: FigmaNode, out?: Array<{
+    nodeId: string;
+    name: string;
+    warning: FigmaWarning;
+}>): Array<{
+    nodeId: string;
+    name: string;
+    warning: FigmaWarning;
+}>;
 export declare function getImages(options: FigmaImageOptions): Promise<FigmaImageMap>;
 export declare function getScreenshot(options: FigmaScreenshotOptions): Promise<{
     path: string;

package/dist/infra/lib/figma/extract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../../src/infra/lib/figma/extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAkMpB,wBAAsB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAc3E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAI5F;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2DlF;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB5G"}
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../../src/infra/lib/figma/extract.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAwPpB,wBAAsB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CAc3E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAI5F;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,GAAG,GAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,aAAa,CAAA;CAAE,CAAM,GACpE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,aAAa,CAAA;CAAE,CAAC,CAM7D;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,GAAG,GAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAM,GACvE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAIhE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CA2DlF;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB5G"}