@calibrate-ds/cli 0.1.0

package/dist/commands/context.js

@@ -0,0 +1,297 @@
+import { loadConfig, loadLatestSnapshot, resolveComponent, loadManifest, getComponentContext, loadContextIndex, resolveContextQuery } from "@calibrate-ds/core";
+import { logger, redact } from "../utils/logger.js";
+export async function contextComponentCommand(name, options = {}) {
+    try {
+        const config = await loadConfig();
+        const snapshot = await loadLatestSnapshot(config);
+        if (!snapshot || !snapshot.components) {
+            logger.warn("No snapshot found. Please run 'ptb scan' first.");
+            return;
+        }
+        // Dot/wildcard: show a compact summary table for every component
+        if (name === "." || name === "*") {
+            const components = snapshot.components;
+            if (components.length === 0) {
+                logger.warn("No components in snapshot.");
+                return;
+            }
+            const nameWidth = Math.max(9, ...components.map(c => c.name.length));
+            const kindWidth = Math.max(4, ...components.map(c => (c.kind?.value ?? "").length));
+            const header = `${"Component".padEnd(nameWidth)}  ${"Kind".padEnd(kindWidth)}  Variants  Deps`;
+            console.log(`\n\x1b[1m${header}\x1b[0m`);
+            console.log(`\x1b[2m${"─".repeat(header.length + 4)}\x1b[0m`);
+            for (const c of components) {
+                const variants = (c.variantAxes?.length ?? c.variants?.length ?? 0).toString().padEnd(8);
+                const deps = (c.dependencies?.length ?? 0).toString();
+                const kind = (c.kind?.value ?? "").padEnd(kindWidth);
+                console.log(`\x1b[36m${c.name.padEnd(nameWidth)}\x1b[0m  \x1b[33m${kind}\x1b[0m  ${variants}  ${deps}`);
+            }
+            console.log(`\n\x1b[2m${components.length} components — run \x1b[0m\x1b[1mptb context component <name>\x1b[0m\x1b[2m for full detail\x1b[0m\n`);
+            return;
+        }
+        const resolution = resolveComponent(name, snapshot.components, config);
+        const component = resolution.exactMatch;
+        if (!component) {
+            logger.error(`Component '${name}' not found.`);
+            if (resolution.suggestions && resolution.suggestions.length > 0) {
+                logger.info("Did you mean:");
+                resolution.suggestions.forEach((s) => logger.dim(`  - ${s}`));
+            }
+            else {
+                logger.info("Available components:");
+                const availableNames = snapshot.components.map((c) => c.name).sort();
+                availableNames.forEach((n) => logger.dim(`  - ${n}`));
+            }
+            return;
+        }
+        const manifest = await loadManifest(config);
+        const contextData = await getComponentContext(component.id, snapshot, config, manifest);
+        if (!contextData) {
+            logger.error(`Failed to construct context for '${name}'.`);
+            return;
+        }
+        // 2. Output
+        if (options.json) {
+            console.log(JSON.stringify(contextData, null, 2));
+            return;
+        }
+        // Rich Terminal Output
+        console.log(`\n\x1b[1mComponent Context:\x1b[0m \x1b[36m${component.name}\x1b[0m`);
+        console.log(`\x1b[2mId:\x1b[0m ${component.id}`);
+        const kindMeta = contextData.component.kind;
+        console.log(`\x1b[2mKind:\x1b[0m ${kindMeta?.value ?? "unclassified"} \x1b[2m(${kindMeta?.inferred ? 'inferred' : 'manual'})\x1b[0m`);
+        console.log(`\x1b[2mFramework:\x1b[0m ${config.framework.name}`);
+        if (contextData.component.artifacts.isManaged) {
+            console.log(`\x1b[2mArtifact Path:\x1b[0m ${contextData.component.artifacts.folder}`);
+        }
+        if (contextData.variantAxes.length > 0) {
+            console.log(`\n\x1b[1mVariant Axes:\x1b[0m \x1b[2m(from Figma Component Set)\x1b[0m`);
+            for (const v of contextData.variantAxes) {
+                console.log(`  \x1b[33m${v.name}\x1b[0m: ${v.options.join(", ")}`);
+            }
+        }
+        if (contextData.properties.length > 0) {
+            console.log(`\n\x1b[1mProperties:\x1b[0m \x1b[2m(from Figma Component Properties)\x1b[0m`);
+            for (const p of contextData.properties) {
+                console.log(`  \x1b[35m${p.name}\x1b[0m (${p.type})`);
+            }
+        }
+        if (contextData.dependencies.length > 0) {
+            console.log(`\n\x1b[1mDependencies:\x1b[0m \x1b[2m(Nested Instances)\x1b[0m`);
+            for (const dep of contextData.dependencies) {
+                const countSuffix = dep.count > 1 ? ` \x1b[2mx ${dep.count}\x1b[0m` : "";
+                let statusLabel = "";
+                if (dep.status === "ready")
+                    statusLabel = " \x1b[32m(Ready)\x1b[0m";
+                else if (dep.status === "missing")
+                    statusLabel = " \x1b[31m(Missing)\x1b[0m";
+                else if (dep.status === "external")
+                    statusLabel = " \x1b[33m(External)\x1b[0m";
+                console.log(`  - ${dep.name}${countSuffix}${statusLabel}`);
+            }
+        }
+        if (contextData.tokenBindings.length > 0) {
+            console.log(`\n\x1b[1mToken Bindings:\x1b[0m`);
+            for (const b of contextData.tokenBindings) {
+                const t = b.resolvedToken;
+                let tokenPart = t ? `\x1b[32m${t.name}\x1b[0m` : `\x1b[2mraw\x1b[0m`;
+                if (t?.codeName)
+                    tokenPart += ` \x1b[2m(${t.codeName})\x1b[0m`;
+                if (t?.collection)
+                    tokenPart += ` \x1b[2m[coll: ${t.collection.name}]\x1b[0m`;
+                if (t?.mode)
+                    tokenPart += ` \x1b[2m[mode: ${t.mode.name}]\x1b[0m`;
+                if (t?.id)
+                    tokenPart += ` \x1b[2m[id: ${t.id}]\x1b[0m`;
+                if (t?.aliasTargetId)
+                    tokenPart += ` \x1b[2m-> ${t.aliasTargetId}\x1b[0m`;
+                console.log(`  \x1b[34m${b.slot}\x1b[0m -> ${tokenPart} (\x1b[2m${b.rawValue}\x1b[0m)`);
+            }
+        }
+        if (component.size) {
+            const s = component.size;
+            console.log(`\n\x1b[1mSizing:\x1b[0m`);
+            const formatDim = (v) => {
+                const modeStr = v.mode ? ` (\x1b[32m${v.mode}\x1b[0m)` : "";
+                const t = v.resolvedToken;
+                let tokenPart = "";
+                if (t) {
+                    tokenPart = ` [\x1b[32m${t.name}\x1b[0m${t.id ? ` \x1b[2m(${t.id})\x1b[0m` : ""}]`;
+                    if (t.collection)
+                        tokenPart += ` \x1b[2m[coll: ${t.collection.name}]\x1b[0m`;
+                    if (t.aliasTargetId)
+                        tokenPart += ` \x1b[2m-> ${t.aliasTargetId}\x1b[0m`;
+                }
+                return `${v.rawValue}px${tokenPart}${modeStr}`;
+            };
+            console.log(`  \x1b[2mWidth:\x1b[0m  ${formatDim(s.width)}`);
+            console.log(`  \x1b[2mHeight:\x1b[0m ${formatDim(s.height)}`);
+        }
+        if (component.layout) {
+            const l = component.layout;
+            console.log(`\n\x1b[1mLayout:\x1b[0m`);
+            console.log(`  \x1b[2mDirection:\x1b[0m ${l.direction}`);
+            if (l.gap) {
+                const modeStr = l.gap.mode === "auto" ? " (\x1b[32mauto\x1b[0m)" : "";
+                const t = l.gap.resolvedToken;
+                let tokenPart = "";
+                if (t) {
+                    tokenPart = ` [\x1b[32m${t.name}\x1b[0m${t.id ? ` \x1b[2m(${t.id})\x1b[0m` : ""}]`;
+                    if (t.collection)
+                        tokenPart += ` \x1b[2m[coll: ${t.collection.name}]\x1b[0m`;
+                    if (t.aliasTargetId)
+                        tokenPart += ` \x1b[2m-> ${t.aliasTargetId}\x1b[0m`;
+                }
+                console.log(`  \x1b[2mGap:\x1b[0m ${l.gap.rawValue}px${tokenPart}${modeStr}`);
+            }
+            if (l.padding) {
+                console.log(`  \x1b[2mPadding:\x1b[0m`);
+                const sides = ["top", "right", "bottom", "left"];
+                for (const side of sides) {
+                    const v = l.padding[side];
+                    const t = v.resolvedToken;
+                    let tokenPart = "";
+                    if (t) {
+                        tokenPart = ` [\x1b[32m${t.name}\x1b[0m${t.id ? ` \x1b[2m(${t.id})\x1b[0m` : ""}]`;
+                        if (t.collection)
+                            tokenPart += ` \x1b[2m[coll: ${t.collection.name}]\x1b[0m`;
+                        if (t.aliasTargetId)
+                            tokenPart += ` \x1b[2m-> ${t.aliasTargetId}\x1b[0m`;
+                    }
+                    console.log(`    \x1b[2m${side.charAt(0).toUpperCase() + side.slice(1)}:\x1b[0m ${v.rawValue}px${tokenPart}`);
+                }
+            }
+            if (l.mainAlignment) {
+                console.log(`  \x1b[2mMain Alignment:\x1b[0m ${l.mainAlignment}`);
+            }
+            if (l.crossAlignment) {
+                console.log(`  \x1b[2mCross Alignment:\x1b[0m ${l.crossAlignment}`);
+            }
+        }
+        console.log("");
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+function getTokensUsed(component) {
+    const tokens = new Set();
+    if (component.styleMetadata) {
+        for (const val of Object.values(component.styleMetadata)) {
+            if (typeof val === "string" && val.startsWith("{") && val.endsWith("}")) {
+                tokens.add(val.slice(1, -1));
+            }
+        }
+    }
+    return Array.from(tokens).sort();
+}
+/**
+ * Handler for 'ptb context list'
+ * Lists all exported components from the context index.
+ */
+export async function contextListCommand() {
+    try {
+        const config = await loadConfig();
+        const index = await loadContextIndex(config);
+        if (index.length === 0) {
+            logger.warn("No component context index found. Run 'ptb export context' first.");
+            return;
+        }
+        // Calculate column widths for alignment
+        const nameWidth = Math.max(12, ...index.map(e => e.displayName.length));
+        const kindWidth = Math.max(6, ...index.map(e => e.kind.length));
+        const catWidth = Math.max(10, ...index.map(e => e.category.length));
+        // Header
+        const header = `${"Component".padEnd(nameWidth)}  ${"Kind".padEnd(kindWidth)}  ${"Category".padEnd(catWidth)}  Path`;
+        console.log(`\n\x1b[1m${header}\x1b[0m`);
+        console.log("\x1b[2m" + "─".repeat(header.length + 10) + "\x1b[0m");
+        // Rows
+        for (const entry of index) {
+            const name = entry.displayName.padEnd(nameWidth);
+            const kind = entry.kind.padEnd(kindWidth);
+            const cat = entry.category.padEnd(catWidth);
+            console.log(`\x1b[36m${name}\x1b[0m  \x1b[33m${kind}\x1b[0m  \x1b[2m${cat}\x1b[0m  ${entry.path}`);
+        }
+        console.log(`\n\x1b[2m${index.length} components indexed\x1b[0m\n`);
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+/**
+ * Handler for 'ptb context resolve <query>'
+ * Resolves a component query to the best matching context file.
+ */
+export async function contextResolveCommand(query) {
+    try {
+        const config = await loadConfig();
+        const index = await loadContextIndex(config);
+        if (index.length === 0) {
+            logger.warn("No component context index found. Run 'ptb export context' first.");
+            return;
+        }
+        const result = resolveContextQuery(query, index);
+        if (result.match) {
+            console.log(`\n\x1b[32m✔\x1b[0m Resolved \x1b[1m${query}\x1b[0m`);
+            console.log(`  \x1b[2mComponent:\x1b[0m  ${result.match.displayName}`);
+            console.log(`  \x1b[2mKind:\x1b[0m       ${result.match.kind}`);
+            console.log(`  \x1b[2mCategory:\x1b[0m   ${result.match.category}`);
+            console.log(`  \x1b[2mPath:\x1b[0m       ${result.match.path}`);
+            console.log("");
+        }
+        else if (result.suggestions.length > 0) {
+            logger.warn(`No exact match for '${query}'. Did you mean:`);
+            for (const s of result.suggestions) {
+                logger.dim(`  - ${s.displayName} (${s.name})`);
+            }
+        }
+        else {
+            logger.error(`No component found matching '${query}'.`);
+            logger.info("Run 'ptb context list' to see available components.");
+        }
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+/**
+ * Handler for 'ptb context open <query>'
+ * Prints ONLY the path to the resolved context file for AI IDE integration.
+ */
+export async function contextOpenCommand(query) {
+    try {
+        const config = await loadConfig();
+        const index = await loadContextIndex(config);
+        if (index.length === 0) {
+            process.stderr.write(`${redact(`\x1b[33m⚠\x1b[0m No component context index found. Run 'ptb export context' first.\n`)}`);
+            process.exit(1);
+        }
+        const result = resolveContextQuery(query, index);
+        if (result.match) {
+            // Print ONLY the path to stdout
+            process.stdout.write(result.match.path + "\n");
+        }
+        else {
+            // Print error/suggestions to stderr
+            if (result.suggestions.length > 0) {
+                process.stderr.write(`${redact(`\x1b[31m✖\x1b[0m No exact match for '${query}'. Did you mean:\n`)}`);
+                for (const s of result.suggestions) {
+                    process.stderr.write(`${redact(`\x1b[90m  - ${s.displayName} (${s.name})\n\x1b[0m`)}`);
+                }
+            }
+            else {
+                process.stderr.write(`${redact(`\x1b[31m✖\x1b[0m No component found matching '${query}'.\n`)}`);
+                process.stderr.write(`${redact(`\x1b[34mℹ\x1b[0m Run 'ptb context list' to see available components.\n`)}`);
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        process.stderr.write(`${redact(`\x1b[31m✖\x1b[0m ${error.message || String(error)}\n`)}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/context.js.map

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

package/dist/commands/diff.d.ts

@@ -0,0 +1,2 @@
+export declare function diffCommand(): Promise<void>;
+//# sourceMappingURL=diff.d.ts.map

package/dist/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/commands/diff.ts"],"names":[],"mappings":"AAqDA,wBAAsB,WAAW,kBAwFhC"}

package/dist/commands/diff.js

@@ -0,0 +1,119 @@
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { loadConfig, loadLatestSnapshot, loadPreviousSnapshot, computeDesignDiff, formatDiffSummary, resolveDSPaths } from "@calibrate-ds/core";
+import { logger } from "../utils/logger.js";
+/**
+ * When stale components exist but have no stampedSnapshotFile (e.g. stamped before
+ * that field was introduced), scan history newest-first and return the most recent
+ * snapshot where those components actually differed from the current model.
+ */
+async function findBaselineForStaleComponents(historyDir, staleIds, currentModel) {
+    let files;
+    try {
+        files = (await fs.readdir(historyDir)).filter(f => f.endsWith(".json")).sort().reverse();
+    }
+    catch {
+        return null;
+    }
+    const currentById = new Map(currentModel.components.map(c => [c.id, c]));
+    for (const file of files) {
+        try {
+            const raw = await fs.readFile(path.join(historyDir, file), "utf-8");
+            const model = JSON.parse(raw);
+            const changed = model.components.some(prev => {
+                if (!staleIds.has(prev.id))
+                    return false;
+                const curr = currentById.get(prev.id);
+                if (!curr)
+                    return true;
+                // Compare the fields that actually matter for the diff
+                return JSON.stringify(prev.variantAxes) !== JSON.stringify(curr.variantAxes)
+                    || JSON.stringify(prev.properties) !== JSON.stringify(curr.properties)
+                    || JSON.stringify(prev.layout) !== JSON.stringify(curr.layout)
+                    || JSON.stringify(prev.styleMetadata) !== JSON.stringify(curr.styleMetadata);
+            });
+            if (changed)
+                return { model, filename: file };
+        }
+        catch { /* skip unreadable files */ }
+    }
+    return null;
+}
+export async function diffCommand() {
+    try {
+        logger.info("Loading ptb.config.json...");
+        const config = await loadConfig();
+        logger.info("Loading latest snapshot...");
+        const currentModel = await loadLatestSnapshot(config);
+        if (!currentModel) {
+            logger.warn("No current snapshot found. Please run 'ptb scan' first to establish a baseline.");
+            return;
+        }
+        const { workspaceRoot, metadataDir } = resolveDSPaths(config);
+        const historyDir = path.join(metadataDir, "history");
+        let baselineFile;
+        let staleIds = new Set();
+        try {
+            const raw = await fs.readFile(path.join(workspaceRoot, "ptb.lock"), "utf-8");
+            const lock = JSON.parse(raw);
+            const staleEntries = Object.entries(lock.components).filter(([, e]) => e.stampedHash && e.stampedHash !== e.designHash);
+            if (staleEntries.length > 0) {
+                // Prefer stampedSnapshotFile when available
+                const withFile = staleEntries
+                    .filter(([, e]) => e.stampedSnapshotFile)
+                    .map(([, e]) => e.stampedSnapshotFile);
+                if (withFile.length > 0) {
+                    baselineFile = withFile.sort()[0];
+                }
+                else {
+                    // Stale but stamped before stampedSnapshotFile tracking — search history semantically
+                    staleIds = new Set(staleEntries
+                        .map(([, e]) => currentModel.components.find(c => c.name === e.displayName)?.id)
+                        .filter((id) => !!id));
+                }
+            }
+        }
+        catch (e) {
+            if (e.code !== "ENOENT")
+                throw new Error(`ptb.lock is corrupt or unreadable: ${e.message}`);
+        }
+        let previousModel;
+        let previousLabel;
+        if (baselineFile) {
+            try {
+                previousModel = JSON.parse(await fs.readFile(path.join(historyDir, baselineFile), "utf-8"));
+                previousLabel = `history/${baselineFile}`;
+            }
+            catch {
+                logger.warn(`Could not load stamp-time snapshot '${baselineFile}'. Falling back.`);
+            }
+        }
+        if (!previousModel && staleIds.size > 0) {
+            const found = await findBaselineForStaleComponents(historyDir, staleIds, currentModel);
+            if (found) {
+                previousModel = found.model;
+                previousLabel = `history/${found.filename}`;
+            }
+        }
+        if (!previousModel) {
+            logger.info("Loading previous snapshot from history...");
+            const previousData = await loadPreviousSnapshot(config);
+            if (!previousData) {
+                logger.info("Baseline established. Run 'ptb scan' again after the next design update to see what changed.");
+                return;
+            }
+            previousModel = previousData.model;
+            previousLabel = `history/${previousData.filename}`;
+        }
+        logger.info("\nComparing:");
+        logger.info(`- current:  latest.json`);
+        logger.info(`- previous: ${previousLabel}\n`);
+        const summary = computeDesignDiff(previousModel, currentModel);
+        console.log(formatDiffSummary(summary));
+    }
+    catch (error) {
+        logger.error(error.message || String(error));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/commands/diff.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,5 @@
+export declare function doctorCommand(): Promise<void>;
+export declare function doctorComponentCommand(name: string): Promise<void>;
+export declare function doctorTokensCommand(): Promise<void>;
+export declare function doctorContextCommand(name: string): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AA4DA,wBAAsB,aAAa,kBAiElC;AAGD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,iBAsGxD;AAGD,wBAAsB,mBAAmB,kBA6CxC;AAmDD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,iBAoEtD"}