@decibelsystems/tools 2.0.2 → 2.1.1

package/dist/tools/designer.d.ts

@@ -117,6 +117,149 @@ export interface CheckParityOutput {
     source: string;
 }
 export declare function checkParity(input: CheckParityInput): Promise<CheckParityOutput | DesignerError>;
+export interface TokensLookupInput {
+    projectId?: string;
+    category?: string;
+}
+export interface TokensLookupOutput {
+    tokens: DesignToken[];
+    total: number;
+    categories: string[];
+    source: string | null;
+    synced_at: string | null;
+    path: string;
+}
+export declare function tokensLookup(input: TokensLookupInput): Promise<TokensLookupOutput | DesignerError>;
+export interface DriftDetectionInput {
+    projectId?: string;
+}
+export interface DriftEntry {
+    token_name: string;
+    expected: string;
+    actual: string;
+    file: string;
+    format: 'css' | 'tailwind' | 'swift' | 'json';
+}
+export interface DriftDetectionOutput {
+    drifted: DriftEntry[];
+    scanned_files: number;
+    total_tokens_checked: number;
+    drift_detected: boolean;
+    timestamp: string;
+}
+export declare function driftDetection(input: DriftDetectionInput): Promise<DriftDetectionOutput | DesignerError>;
+export interface FigmaParityInput {
+    projectId?: string;
+    component: string;
+    figma_node_id?: string;
+}
+export interface FigmaParityOutput {
+    component: string;
+    status: 'pending_figma_integration' | 'compared';
+    figma_node_id: string | null;
+    message: string;
+    timestamp: string;
+}
+export declare function figmaParity(input: FigmaParityInput): Promise<FigmaParityOutput | DesignerError>;
 export declare function listPrinciples(input: ListPrinciplesInput): Promise<ListPrinciplesOutput | DesignerError>;
+export type EvalType = 'token-drift' | 'component-parity' | 'motion-review' | 'design-compliance' | 'visual-review' | 'accessibility';
+export type EvalScope = 'component' | 'page' | 'project';
+export type FindingSeverity = 'critical' | 'warning' | 'info';
+export interface EvalFinding {
+    severity: FindingSeverity;
+    category: string;
+    message: string;
+    location?: string;
+    expected?: string;
+    actual?: string;
+    suggestion?: string;
+}
+export interface LogEvalInput {
+    projectId?: string;
+    evalType: EvalType;
+    scope: EvalScope;
+    target: string;
+    score: number;
+    summary: string;
+    findings: EvalFinding[];
+    platform?: string;
+    branch?: string;
+    commit?: string;
+    evaluator?: string;
+    requestedBy?: string;
+    tags?: string[];
+}
+export interface LogEvalOutput {
+    id: string;
+    grade: string;
+    score: number;
+    findingCounts: {
+        critical: number;
+        warning: number;
+        info: number;
+    };
+    previousEvalId: string | null;
+    path: string;
+    timestamp: string;
+}
+export declare function logEval(input: LogEvalInput): Promise<LogEvalOutput | DesignerError>;
+export interface ListEvalsInput {
+    projectId?: string;
+    evalType?: EvalType;
+    scope?: EvalScope;
+    target?: string;
+    minScore?: number;
+    maxScore?: number;
+    tags?: string[];
+    limit?: number;
+}
+export interface EvalSummary {
+    id: string;
+    eval_type: EvalType;
+    scope: EvalScope;
+    target: string;
+    score: number;
+    grade: string;
+    summary: string;
+    finding_counts: {
+        critical: number;
+        warning: number;
+        info: number;
+    };
+    tags: string[];
+    timestamp: string;
+}
+export interface ListEvalsOutput {
+    evals: EvalSummary[];
+    total: number;
+    path: string;
+}
+export declare function listEvals(input: ListEvalsInput): Promise<ListEvalsOutput | DesignerError>;
+export interface EvalHistoryInput {
+    projectId?: string;
+    evalType: EvalType;
+    target?: string;
+}
+export interface EvalHistoryPoint {
+    id: string;
+    score: number;
+    grade: string;
+    finding_counts: {
+        critical: number;
+        warning: number;
+        info: number;
+    };
+    timestamp: string;
+    summary: string;
+}
+export interface EvalHistoryOutput {
+    eval_type: EvalType;
+    target: string;
+    history: EvalHistoryPoint[];
+    trend: 'improving' | 'declining' | 'stable' | 'insufficient_data';
+    delta: number | null;
+    path: string;
+}
+export declare function evalHistory(input: EvalHistoryInput): Promise<EvalHistoryOutput | DesignerError>;
 export {};
 //# sourceMappingURL=designer.d.ts.map

package/dist/tools/designer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"designer.d.ts","sourceRoot":"","sources":["../../src/tools/designer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"designer.d.ts","sourceRoot":"","sources":["../../src/tools/designer.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAUD,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,CAOxE;AAED,MAAM,WAAW,yBAAyB;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB;AAkBD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,0BAA0B,GAAG,aAAa,CAAC,CAoDrD;AAMD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiBD,wBAAsB,UAAU,CAC9B,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,gBAAgB,GAAG,aAAa,CAAC,CAsF3C;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,aAAa,CAAC;CAClD;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA6BD,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAmI5C;AAMD,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,eAAe,CACnC,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,qBAAqB,GAAG,aAAa,CAAC,CAgDhD;AAMD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAyH5C;AAUD,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,kBAAkB,GAAG,aAAa,CAAC,CAqD7C;AAMD,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AA+ED,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,GAAG,aAAa,CAAC,CAqF/C;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,2BAA2B,GAAG,UAAU,CAAC;IACjD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,GAAG,aAAa,CAAC,CA6B5C;AAMD,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,GAAG,aAAa,CAAC,CAsB/C;AAMD,MAAM,MAAM,QAAQ,GAChB,aAAa,GACb,kBAAkB,GAClB,eAAe,GACf,mBAAmB,GACnB,eAAe,GACf,eAAe,CAAC;AAEpB,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAUD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,OAAO,CAC3B,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC,CA+FxC;AAMD,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,QAAQ,CAAC;IACpB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,SAAS,CAC7B,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,eAAe,GAAG,aAAa,CAAC,CAiF1C;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,mBAAmB,CAAC;IAClE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,iBAAiB,GAAG,aAAa,CAAC,CAyD5C"}

package/dist/tools/designer.js

@@ -470,6 +470,242 @@ export async function checkParity(input) {
         source: `figma:${input.fileKey}`,
     };
 }
+export async function tokensLookup(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('look up tokens');
+    }
+    const tokensFile = path.join(resolved.subPath('designer', 'tokens'), 'tokens.yaml');
+    let tokens;
+    let source = null;
+    let synced_at = null;
+    try {
+        const content = await fs.readFile(tokensFile, 'utf-8');
+        const data = YAML.parse(content);
+        tokens = data?.tokens || [];
+        source = data?.source || null;
+        synced_at = data?.synced_at || null;
+    }
+    catch {
+        return {
+            error: 'NO_TOKENS',
+            message: 'No tokens.yaml found. Sync tokens from Figma first or create a tokens file manually.',
+            hint: 'Use designer sync_tokens with a Figma fileKey, or place a tokens.yaml in .decibel/designer/tokens/',
+        };
+    }
+    // Derive categories from token types + collections
+    const categorySet = new Set();
+    for (const t of tokens) {
+        if (t.type)
+            categorySet.add(t.type);
+        if (t.collection)
+            categorySet.add(t.collection.toLowerCase());
+    }
+    // Filter by category if specified
+    if (input.category) {
+        const cat = input.category.toLowerCase();
+        tokens = tokens.filter(t => t.type === cat ||
+            (t.collection && t.collection.toLowerCase() === cat));
+    }
+    log(`Designer: Tokens lookup — ${tokens.length} tokens${input.category ? ` (category: ${input.category})` : ''}`);
+    return {
+        tokens,
+        total: tokens.length,
+        categories: Array.from(categorySet).sort(),
+        source,
+        synced_at,
+        path: tokensFile,
+    };
+}
+// Format-aware value normalizer: convert various color/value formats to comparable form
+function normalizeColorValue(value) {
+    if (typeof value === 'string')
+        return value.toLowerCase().replace(/\s/g, '');
+    // Figma RGBA object → hex
+    if (typeof value === 'object' && value !== null && 'r' in value) {
+        const v = value;
+        const toHex = (n) => Math.round(n * 255).toString(16).padStart(2, '0');
+        return `#${toHex(v.r)}${toHex(v.g)}${toHex(v.b)}`.toLowerCase();
+    }
+    if (typeof value === 'number')
+        return String(value);
+    return null;
+}
+// Parsers for different source file formats
+const FORMAT_PARSERS = {
+    css: {
+        glob: '**/*.css',
+        extract(content) {
+            const map = new Map();
+            const re = /--([a-zA-Z0-9_-]+)\s*:\s*([^;]+)/g;
+            let m;
+            while ((m = re.exec(content)) !== null) {
+                map.set(m[1].toLowerCase(), m[2].trim().toLowerCase());
+            }
+            return map;
+        },
+    },
+    tailwind: {
+        glob: '**/tailwind.config.{js,ts,cjs,mjs}',
+        extract(content) {
+            const map = new Map();
+            // Match hex/rgb values in tailwind config
+            const re = /['"]([a-zA-Z0-9_-]+)['"]\s*:\s*['"](#[0-9a-fA-F]{3,8}|rgb[a]?\([^)]+\))['"]/g;
+            let m;
+            while ((m = re.exec(content)) !== null) {
+                map.set(m[1].toLowerCase(), m[2].toLowerCase());
+            }
+            return map;
+        },
+    },
+    swift: {
+        glob: '**/*.swift',
+        extract(content) {
+            const map = new Map();
+            // Match Color(hex: 0xRRGGBB) or Color(hex: "RRGGBB")
+            const re = /(?:let|var|static)\s+(\w+)\s*.*?Color\(\s*hex\s*:\s*(?:0x|"|')([0-9a-fA-F]{6,8})/g;
+            let m;
+            while ((m = re.exec(content)) !== null) {
+                map.set(m[1].toLowerCase(), `#${m[2].toLowerCase()}`);
+            }
+            return map;
+        },
+    },
+    json: {
+        glob: '**/tokens.json',
+        extract(content) {
+            const map = new Map();
+            try {
+                const data = JSON.parse(content);
+                // Flatten nested token objects
+                function walk(obj, prefix) {
+                    for (const [k, v] of Object.entries(obj)) {
+                        const key = prefix ? `${prefix}/${k}` : k;
+                        if (typeof v === 'object' && v !== null && 'value' in v) {
+                            map.set(key.toLowerCase(), String(v.value).toLowerCase());
+                        }
+                        else if (typeof v === 'object' && v !== null) {
+                            walk(v, key);
+                        }
+                    }
+                }
+                walk(data, '');
+            }
+            catch { /* not valid JSON, skip */ }
+            return map;
+        },
+    },
+};
+export async function driftDetection(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('detect drift');
+    }
+    const now = new Date();
+    // Load token registry
+    const tokensFile = path.join(resolved.subPath('designer', 'tokens'), 'tokens.yaml');
+    let registryTokens;
+    try {
+        const content = await fs.readFile(tokensFile, 'utf-8');
+        const data = YAML.parse(content);
+        registryTokens = data?.tokens || [];
+    }
+    catch {
+        return {
+            error: 'NO_TOKENS',
+            message: 'No tokens.yaml found. Sync or create tokens first.',
+            hint: 'Use designer sync_tokens or manually place tokens.yaml in .decibel/designer/tokens/',
+        };
+    }
+    // Build a lookup from token name → normalized expected value
+    const expectedMap = new Map();
+    for (const t of registryTokens) {
+        const norm = normalizeColorValue(t.value);
+        if (norm) {
+            // Use the last segment of slash-separated names for matching
+            const shortName = t.name.split('/').pop().toLowerCase();
+            expectedMap.set(shortName, norm);
+            expectedMap.set(t.name.toLowerCase(), norm);
+        }
+    }
+    const drifted = [];
+    let scannedFiles = 0;
+    // Scan source files using each format parser
+    for (const [format, parser] of Object.entries(FORMAT_PARSERS)) {
+        // Use the project root to find source files
+        const projectRoot = resolved.projectPath.replace(/\/.decibel$/, '');
+        let files;
+        try {
+            const { glob } = await import('glob');
+            files = await glob(parser.glob, {
+                cwd: projectRoot,
+                absolute: true,
+                ignore: ['**/node_modules/**', '**/dist/**', '**/.decibel/**'],
+            });
+        }
+        catch {
+            continue; // glob not available or no matches
+        }
+        for (const file of files) {
+            scannedFiles++;
+            const content = await fs.readFile(file, 'utf-8');
+            const sourceValues = parser.extract(content);
+            for (const [name, actual] of sourceValues) {
+                const expected = expectedMap.get(name);
+                if (expected && expected !== actual.replace(/\s/g, '')) {
+                    drifted.push({
+                        token_name: name,
+                        expected,
+                        actual,
+                        file: path.relative(projectRoot, file),
+                        format: format,
+                    });
+                }
+            }
+        }
+    }
+    log(`Designer: Drift detection — ${drifted.length} drifted tokens across ${scannedFiles} files`);
+    return {
+        drifted,
+        scanned_files: scannedFiles,
+        total_tokens_checked: expectedMap.size,
+        drift_detected: drifted.length > 0,
+        timestamp: now.toISOString(),
+    };
+}
+export async function figmaParity(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('check Figma parity');
+    }
+    // Input validation
+    if (!input.component || input.component.trim().length === 0) {
+        return {
+            error: 'INVALID_INPUT',
+            message: 'component parameter is required and must be non-empty.',
+            hint: 'Provide the component name or file path (e.g., "Button", "src/components/Button.tsx").',
+        };
+    }
+    const now = new Date();
+    // Phase 1: skeleton — real Figma MCP integration is pending
+    log(`Designer: Figma parity check requested for component "${input.component}" (Phase 2 integration pending)`);
+    return {
+        component: input.component,
+        status: 'pending_figma_integration',
+        figma_node_id: input.figma_node_id || null,
+        message: `Figma parity diff for "${input.component}" is registered. Real comparison requires Phase 2 Figma MCP integration. Node ID ${input.figma_node_id ? `"${input.figma_node_id}" saved for` : 'not provided — will need it for'} automated comparison.`,
+        timestamp: now.toISOString(),
+    };
+}
 // ============================================================================
 // List Design Principles
 // ============================================================================
@@ -492,4 +728,225 @@ export async function listPrinciples(input) {
         path: principlesDir,
     };
 }
+function deriveGrade(score) {
+    if (score >= 90)
+        return 'A';
+    if (score >= 80)
+        return 'B';
+    if (score >= 70)
+        return 'C';
+    if (score >= 60)
+        return 'D';
+    return 'F';
+}
+export async function logEval(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('log eval');
+    }
+    // Validate score range
+    if (input.score < 0 || input.score > 100) {
+        return {
+            error: 'INVALID_INPUT',
+            message: 'score must be between 0 and 100.',
+        };
+    }
+    const now = new Date();
+    const timestamp = now.toISOString();
+    const fileTimestamp = formatTimestampForFilename(now);
+    const grade = deriveGrade(input.score);
+    const id = `EVAL-${fileTimestamp}-${slugify(input.target)}`;
+    const evalsDir = resolved.subPath('designer', 'evals');
+    ensureDir(evalsDir);
+    // Auto-link to most recent eval with same evalType + target
+    let previousEvalId = null;
+    try {
+        const existingFiles = await fs.readdir(evalsDir);
+        const candidates = [];
+        for (const f of existingFiles) {
+            if (!f.endsWith('.yaml') && !f.endsWith('.yml'))
+                continue;
+            try {
+                const content = await fs.readFile(path.join(evalsDir, f), 'utf-8');
+                const data = YAML.parse(content);
+                if (data?.eval_type === input.evalType && data?.target === input.target && data?.id) {
+                    candidates.push({ id: data.id, timestamp: data.timestamp });
+                }
+            }
+            catch { /* skip malformed */ }
+        }
+        if (candidates.length > 0) {
+            candidates.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+            previousEvalId = candidates[0].id;
+        }
+    }
+    catch { /* no evals dir yet */ }
+    const findingCounts = {
+        critical: input.findings.filter(f => f.severity === 'critical').length,
+        warning: input.findings.filter(f => f.severity === 'warning').length,
+        info: input.findings.filter(f => f.severity === 'info').length,
+    };
+    const evalData = {
+        id,
+        project: resolved.id,
+        eval_type: input.evalType,
+        scope: input.scope,
+        target: input.target,
+        score: input.score,
+        grade,
+        summary: input.summary,
+        findings: input.findings,
+        finding_counts: findingCounts,
+        previous_eval_id: previousEvalId,
+        platform: input.platform || null,
+        branch: input.branch || null,
+        commit: input.commit || null,
+        evaluator: input.evaluator || 'decibel-designer',
+        requested_by: input.requestedBy || null,
+        tags: input.tags || [],
+        timestamp,
+    };
+    const filePath = path.join(evalsDir, `${id}.yaml`);
+    validateWritePath(filePath, resolved);
+    await fs.writeFile(filePath, YAML.stringify(evalData), 'utf-8');
+    log(`Designer: Logged eval ${id} — ${input.evalType} ${input.scope} "${input.target}" → ${grade} (${input.score}/100, ${input.findings.length} findings)`);
+    await emitCreateProvenance(`designer:eval:${id}`, YAML.stringify(evalData), `Design eval: ${input.evalType} on "${input.target}" — ${grade} (${input.score}/100)`, input.projectId);
+    return {
+        id,
+        grade,
+        score: input.score,
+        findingCounts,
+        previousEvalId,
+        path: filePath,
+        timestamp,
+    };
+}
+export async function listEvals(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('list evals');
+    }
+    const evalsDir = resolved.subPath('designer', 'evals');
+    let files;
+    try {
+        files = await fs.readdir(evalsDir);
+    }
+    catch {
+        return { evals: [], total: 0, path: evalsDir };
+    }
+    const evals = [];
+    for (const file of files) {
+        if (!file.endsWith('.yaml') && !file.endsWith('.yml'))
+            continue;
+        try {
+            const content = await fs.readFile(path.join(evalsDir, file), 'utf-8');
+            const data = YAML.parse(content);
+            if (!data?.id)
+                continue;
+            evals.push({
+                id: data.id,
+                eval_type: data.eval_type,
+                scope: data.scope,
+                target: data.target,
+                score: data.score,
+                grade: data.grade,
+                summary: data.summary,
+                finding_counts: data.finding_counts || { critical: 0, warning: 0, info: 0 },
+                tags: data.tags || [],
+                timestamp: data.timestamp,
+            });
+        }
+        catch {
+            // Skip malformed files
+        }
+    }
+    // Apply filters
+    let filtered = evals;
+    if (input.evalType) {
+        filtered = filtered.filter(e => e.eval_type === input.evalType);
+    }
+    if (input.scope) {
+        filtered = filtered.filter(e => e.scope === input.scope);
+    }
+    if (input.target) {
+        const t = input.target.toLowerCase();
+        filtered = filtered.filter(e => e.target.toLowerCase().includes(t));
+    }
+    if (input.minScore !== undefined) {
+        filtered = filtered.filter(e => e.score >= input.minScore);
+    }
+    if (input.maxScore !== undefined) {
+        filtered = filtered.filter(e => e.score <= input.maxScore);
+    }
+    if (input.tags && input.tags.length > 0) {
+        filtered = filtered.filter(e => input.tags.some(tag => e.tags.includes(tag)));
+    }
+    // Sort by timestamp descending (most recent first)
+    filtered.sort((a, b) => b.timestamp.localeCompare(a.timestamp));
+    if (input.limit) {
+        filtered = filtered.slice(0, input.limit);
+    }
+    return {
+        evals: filtered,
+        total: filtered.length,
+        path: evalsDir,
+    };
+}
+export async function evalHistory(input) {
+    let resolved;
+    try {
+        resolved = resolveProjectPaths(input.projectId);
+    }
+    catch {
+        return makeProjectError('get eval history');
+    }
+    const target = input.target || 'full-project';
+    // Reuse listEvals to get all matching evals
+    const result = await listEvals({
+        projectId: input.projectId,
+        evalType: input.evalType,
+        target,
+    });
+    if ('error' in result)
+        return result;
+    // Sort chronologically (oldest first) for trend analysis
+    const sorted = [...result.evals].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    const history = sorted.map(e => ({
+        id: e.id,
+        score: e.score,
+        grade: e.grade,
+        finding_counts: e.finding_counts,
+        timestamp: e.timestamp,
+        summary: e.summary,
+    }));
+    // Compute trend
+    let trend = 'insufficient_data';
+    let delta = null;
+    if (history.length >= 2) {
+        const first = history[0].score;
+        const last = history[history.length - 1].score;
+        delta = last - first;
+        if (delta > 5)
+            trend = 'improving';
+        else if (delta < -5)
+            trend = 'declining';
+        else
+            trend = 'stable';
+    }
+    log(`Designer: Eval history for ${input.evalType} "${target}" — ${history.length} data points, trend: ${trend}`);
+    return {
+        eval_type: input.evalType,
+        target,
+        history,
+        trend,
+        delta,
+        path: resolved.subPath('designer', 'evals'),
+    };
+}
 //# sourceMappingURL=designer.js.map