@sxl-studio/bridge 1.7.2 → 1.8.0

package/dist/bridge-readiness-cli.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { runBridgeHealthCheck } from "./bridge-health.js";
+import { runBridgeLiveValidation } from "./bridge-live-validation.js";
+import { buildUltimateReadinessAudit } from "./ultimate-readiness-audit.js";
+function usage() {
+    return [
+        "Usage: sxl-bridge-readiness [--json] [--fail-on-warn] [--runtime] [--require-live] [--url <baseUrl>] [--auth-token <token>] [--timeout-ms <ms>] [--suite baseline|all] [--write-canary] [--cleanup]",
+        "",
+        "Runs the local Ultimate Bridge requirement-by-requirement readiness audit.",
+        "WARN exits successfully by default but should be reviewed before release; explicit companion/future scope is reported separately.",
+        "Use --runtime to add running Bridge HTTP/MCP proof. Use --require-live to fail unless a connected SXL Studio plugin passes live validation.",
+    ].join("\n");
+}
+function parseArgs(argv) {
+    const args = {
+        json: false,
+        failOnWarn: false,
+        runtime: false,
+        requireLive: false,
+        writeCanary: false,
+        cleanup: false,
+    };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            console.log(usage());
+            process.exit(0);
+        }
+        if (arg === "--json") {
+            args.json = true;
+            continue;
+        }
+        if (arg === "--fail-on-warn") {
+            args.failOnWarn = true;
+            continue;
+        }
+        if (arg === "--runtime") {
+            args.runtime = true;
+            continue;
+        }
+        if (arg === "--require-live") {
+            args.runtime = true;
+            args.requireLive = true;
+            continue;
+        }
+        if (arg === "--write-canary") {
+            args.runtime = true;
+            args.requireLive = true;
+            args.writeCanary = true;
+            continue;
+        }
+        if (arg === "--cleanup") {
+            args.cleanup = true;
+            continue;
+        }
+        if (arg === "--url") {
+            args.runtime = true;
+            args.baseUrl = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--auth-token") {
+            args.authToken = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--timeout-ms") {
+            const value = Number.parseInt(argv[i + 1] ?? "", 10);
+            if (!Number.isFinite(value) || value <= 0) {
+                throw new Error("--timeout-ms must be a positive integer.");
+            }
+            args.timeoutMs = value;
+            i += 1;
+            continue;
+        }
+        if (arg === "--suite") {
+            const value = argv[i + 1];
+            if (value !== "baseline" && value !== "all") {
+                throw new Error("--suite must be baseline or all.");
+            }
+            args.runtime = true;
+            args.requireLive = true;
+            args.suite = value;
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    if (args.cleanup && !args.writeCanary) {
+        throw new Error("--cleanup requires --write-canary.");
+    }
+    return args;
+}
+function combineStatus(statuses) {
+    if (statuses.includes("fail"))
+        return "fail";
+    if (statuses.includes("warn"))
+        return "warn";
+    return "pass";
+}
+function runtimePluginConnected(report) {
+    return report.checks.some((check) => check.name === "runtime.status" && check.details?.["pluginConnected"] === true);
+}
+function runtimeLiveStatus(args) {
+    if (args.liveValidation)
+        return args.liveValidation.status;
+    if (args.requireLive)
+        return "fail";
+    return runtimePluginConnected(args.health) ? "not-requested" : "not-connected";
+}
+export async function buildReadinessCliReport(options = {}) {
+    const audit = buildUltimateReadinessAudit();
+    const statuses = [audit.status];
+    let runtime;
+    if (options.runtime === true) {
+        const health = await runBridgeHealthCheck({
+            runtime: true,
+            baseUrl: options.baseUrl,
+            authToken: options.authToken,
+            timeoutMs: options.timeoutMs,
+            requirePlugin: options.requireLive === true,
+            fetchImpl: options.fetchImpl,
+        });
+        statuses.push(health.status);
+        const shouldRunLive = options.requireLive === true || runtimePluginConnected(health);
+        const liveValidation = shouldRunLive
+            ? await runBridgeLiveValidation({
+                baseUrl: options.baseUrl,
+                authToken: options.authToken,
+                timeoutMs: options.timeoutMs,
+                suite: options.suite,
+                writeCanary: options.writeCanary,
+                cleanup: options.cleanup,
+                fetchImpl: options.fetchImpl,
+            })
+            : undefined;
+        if (liveValidation)
+            statuses.push(liveValidation.status);
+        if (options.requireLive === true && !liveValidation)
+            statuses.push("fail");
+        if (options.requireLive !== true && !liveValidation && !runtimePluginConnected(health))
+            statuses.push("warn");
+        runtime = {
+            health,
+            liveValidation,
+            liveRequired: options.requireLive === true,
+            liveStatus: runtimeLiveStatus({ health, liveValidation, requireLive: options.requireLive === true }),
+        };
+    }
+    const status = combineStatus(statuses);
+    return {
+        ok: status !== "fail",
+        status,
+        audit,
+        runtime,
+    };
+}
+export function renderReadinessText(audit) {
+    const lines = [];
+    lines.push(`SXL Bridge ultimate readiness: ${audit.status.toUpperCase()}`);
+    lines.push(`Requirements: ${audit.summary.pass} pass, ${audit.summary.warn} warn, ${audit.summary.fail} fail`);
+    lines.push(`Surface: ${audit.summary.toolCount} tools, ${audit.summary.recipeCount} recipes, ${audit.summary.schemaCount} schemas, ${audit.summary.promptCount} prompts`);
+    lines.push(`Figma MCP: ${audit.summary.officialFigmaMcpTools} tools, ${audit.summary.officialFigmaMcpSkills} skills, ${audit.summary.companionFigmaMcpTools} companion tools, ${audit.summary.companionFigmaMcpSkills} companion skills`);
+    lines.push("");
+    for (const requirement of audit.requirements) {
+        lines.push(`- ${requirement.status.toUpperCase()} ${requirement.id}: ${requirement.title}`);
+        if (requirement.missing.length > 0) {
+            lines.push(`  missing: ${requirement.missing.join(", ")}`);
+        }
+    }
+    if (audit.scope.companion.length > 0) {
+        lines.push("");
+        lines.push(`Companion Figma MCP scope: ${audit.scope.companion.join(", ")}`);
+    }
+    if (audit.scope.future.length > 0) {
+        lines.push(`Future/unsupported scope: ${audit.scope.future.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+export function renderReadinessReportText(report) {
+    const lines = [renderReadinessText(report.audit)];
+    if (report.runtime) {
+        lines.push("");
+        lines.push("Runtime proof:");
+        lines.push(`- Bridge HTTP/MCP health: ${report.runtime.health.status.toUpperCase()}`);
+        lines.push(`- Live Figma E2E: ${report.runtime.liveStatus.toUpperCase()}`);
+        if (report.runtime.health.findings.length > 0) {
+            lines.push("  Health findings:");
+            for (const finding of report.runtime.health.findings.slice(0, 5)) {
+                const endpoint = finding.endpoint ? ` ${finding.endpoint}` : "";
+                lines.push(`  - ${finding.severity.toUpperCase()} ${finding.code}${endpoint}: ${finding.message}`);
+            }
+            if (report.runtime.health.findings.length > 5) {
+                lines.push(`  - ... ${report.runtime.health.findings.length - 5} more`);
+            }
+        }
+        if (report.runtime.liveStatus === "not-connected") {
+            lines.push("  Remote Connect plugin session is not connected; live Figma workflows are not proven.");
+        }
+        if (report.runtime.liveRequired && report.runtime.liveStatus === "fail") {
+            lines.push("  Required live validation failed. Open the SXL Studio plugin, enable Remote Connect, then rerun this command.");
+        }
+        if (report.runtime.liveValidation) {
+            lines.push(`  suite=${report.runtime.liveValidation.suite}, writeCanary=${report.runtime.liveValidation.writeCanary}, cleanup=${report.runtime.liveValidation.cleanup}`);
+        }
+    }
+    lines.push("");
+    lines.push(`Overall readiness: ${report.status.toUpperCase()}`);
+    return lines.join("\n");
+}
+export async function runBridgeReadinessCli(argv = process.argv.slice(2)) {
+    const args = parseArgs(argv);
+    const report = await buildReadinessCliReport({
+        runtime: args.runtime,
+        requireLive: args.requireLive,
+        baseUrl: args.baseUrl,
+        authToken: args.authToken,
+        timeoutMs: args.timeoutMs,
+        suite: args.suite,
+        writeCanary: args.writeCanary,
+        cleanup: args.cleanup,
+    });
+    if (args.json) {
+        console.log(JSON.stringify(args.runtime ? report : report.audit, null, 2));
+    }
+    else {
+        console.log(args.runtime ? renderReadinessReportText(report) : renderReadinessText(report.audit));
+    }
+    const shouldFail = !report.ok || (args.failOnWarn && report.status === "warn");
+    process.exit(shouldFail ? 1 : 0);
+}
+const isCliEntry = process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isCliEntry) {
+    runBridgeReadinessCli().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        console.error("");
+        console.error(usage());
+        process.exit(2);
+    });
+}
+//# sourceMappingURL=bridge-readiness-cli.js.map

package/dist/bridge-readiness-cli.js.map

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

package/dist/bridge-runtime-summary.d.ts

@@ -0,0 +1,50 @@
+import type { CommandQueue } from "./command-queue.js";
+import type { CommandQueueSnapshot, SessionInfo } from "./types.js";
+export type BridgeRuntimeSummary = {
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    version: 1;
+    bridgeVersion: string;
+    generatedAt: string;
+    transport: {
+        httpPort: number | null;
+        mcpStreamableHttp: string | null;
+        authEnabled: boolean;
+    };
+    plugin: {
+        connected: boolean;
+        pluginName: string | null;
+        connectedForMs: number | null;
+        lastHeartbeatAgeMs: number | null;
+    };
+    queue: {
+        idle: boolean;
+        current: CommandQueueSnapshot["current"];
+        queuedCount: number;
+        immediateCount: number;
+        maxAgeMs: number;
+    };
+    recent: {
+        events: {
+            count: number;
+            failures: number;
+            timeouts: number;
+            pluginEvents: number;
+            slowEvents: number;
+        };
+        audit: {
+            count: number;
+            failures: number;
+            slowCommands: number;
+        };
+    };
+    recommendations: string[];
+};
+export type BridgeRuntimeSummaryOptions = {
+    queue: CommandQueue;
+    sessionInfo?: SessionInfo;
+    bridgePort?: number;
+    auditLimit?: number;
+    now?: number;
+};
+export declare function buildBridgeRuntimeSummary(options: BridgeRuntimeSummaryOptions): BridgeRuntimeSummary;

package/dist/bridge-runtime-summary.js

@@ -0,0 +1,112 @@
+import { getAuditSnapshot } from "./audit.js";
+import { isAuthEnabled } from "./auth.js";
+import { getBridgePackageVersion } from "./bridge-version.js";
+const SLOW_EVENT_MS = 30_000;
+const SLOW_AUDIT_MS = 60_000;
+function maxCommandAge(snapshot) {
+    const ages = [
+        snapshot.current?.ageMs ?? 0,
+        ...snapshot.queued.map((item) => item.ageMs),
+        ...snapshot.immediate.map((item) => item.ageMs),
+    ];
+    return Math.max(0, ...ages);
+}
+function eventStats(events) {
+    return {
+        count: events.length,
+        failures: events.filter((event) => event.status === "failed").length,
+        timeouts: events.filter((event) => event.status === "timeout").length,
+        pluginEvents: events.filter((event) => event.source === "plugin").length,
+        slowEvents: events.filter((event) => (event.durationMs ?? 0) >= SLOW_EVENT_MS).length,
+    };
+}
+function auditStats(limit) {
+    const entries = getAuditSnapshot(limit);
+    return {
+        count: entries.length,
+        failures: entries.filter((entry) => entry.status !== "completed").length,
+        slowCommands: entries.filter((entry) => (entry.durationMs ?? 0) >= SLOW_AUDIT_MS).length,
+    };
+}
+function recommendations(args) {
+    const result = new Set();
+    if (!args.pluginConnected) {
+        result.add("Open SXL Studio plugin Remote Connect before running plugin-routed canvas, token, composition, data, or audit tools.");
+        if (args.bridgePort !== null) {
+            result.add(`Set the plugin Remote Connect port to ${args.bridgePort} if Bridge is not using the default port.`);
+        }
+        if (args.authEnabled) {
+            result.add("Bridge auth is enabled; enter the same BRIDGE_AUTH_TOKEN in the plugin Remote Connect overlay token field.");
+        }
+    }
+    if (args.current) {
+        result.add(`Wait for current command "${args.current.commandType}" to finish or inspect /api/events before queueing heavy writes.`);
+    }
+    if (args.queuedCount > 0) {
+        result.add("Bridge serializes plugin commands; keep workflows batched and avoid submitting duplicate long-running writes.");
+    }
+    if (args.failures > 0 || args.timeouts > 0) {
+        result.add("Inspect get_bridge_audit_log and /api/events for recent failures before retrying.");
+    }
+    if (args.slowCommands > 0) {
+        result.add("Use summary/paginated response modes and dry-run gates before large workflows.");
+    }
+    return Array.from(result);
+}
+export function buildBridgeRuntimeSummary(options) {
+    const now = options.now ?? Date.now();
+    const bridgePort = options.bridgePort ?? Number.parseInt(process.env["BRIDGE_PORT"] ?? "", 10);
+    const port = Number.isFinite(bridgePort) ? bridgePort : null;
+    const snapshot = options.queue.getSnapshot(now);
+    const events = options.queue.getEventsSnapshot({ limit: 100 });
+    const eventSummary = eventStats(events);
+    const auditSummary = auditStats(options.auditLimit ?? 50);
+    const session = options.sessionInfo;
+    const pluginConnected = session?.connected === true;
+    const queuedCount = snapshot.queued.length;
+    const immediateCount = snapshot.immediate.length;
+    const recs = recommendations({
+        pluginConnected,
+        authEnabled: isAuthEnabled(),
+        bridgePort: port,
+        queuedCount,
+        current: snapshot.current,
+        failures: eventSummary.failures + auditSummary.failures,
+        timeouts: eventSummary.timeouts,
+        slowCommands: eventSummary.slowEvents + auditSummary.slowCommands,
+    });
+    const status = !pluginConnected || queuedCount > 0 || snapshot.current || eventSummary.failures > 0 || eventSummary.timeouts > 0
+        ? "warn"
+        : "pass";
+    return {
+        ok: true,
+        status,
+        version: 1,
+        bridgeVersion: getBridgePackageVersion(),
+        generatedAt: new Date(now).toISOString(),
+        transport: {
+            httpPort: port,
+            mcpStreamableHttp: port ? `http://127.0.0.1:${port}/mcp` : null,
+            authEnabled: isAuthEnabled(),
+        },
+        plugin: {
+            connected: pluginConnected,
+            pluginName: session?.pluginName ?? null,
+            connectedForMs: session?.connectedAt ? Math.max(0, now - session.connectedAt) : null,
+            lastHeartbeatAgeMs: session?.lastHeartbeat ? Math.max(0, now - session.lastHeartbeat) : null,
+        },
+        queue: {
+            idle: !snapshot.current && queuedCount === 0 && immediateCount === 0,
+            current: snapshot.current,
+            queuedCount,
+            immediateCount,
+            maxAgeMs: maxCommandAge(snapshot),
+        },
+        recent: {
+            events: eventSummary,
+            audit: auditSummary,
+        },
+        recommendations: recs,
+    };
+}
+//# sourceMappingURL=bridge-runtime-summary.js.map

package/dist/bridge-runtime-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-runtime-summary.js","sourceRoot":"","sources":["../src/bridge-runtime-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAqD9D,MAAM,aAAa,GAAG,MAAM,CAAC;AAC7B,MAAM,aAAa,GAAG,MAAM,CAAC;AAE7B,SAAS,aAAa,CAAC,QAA8B;IACnD,MAAM,IAAI,GAAG;QACX,QAAQ,CAAC,OAAO,EAAE,KAAK,IAAI,CAAC;QAC5B,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;QAC5C,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;KAChD,CAAC;IACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,UAAU,CAAC,MAA+B;IACjD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,MAAM;QACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;QACpE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM;QACrE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,MAAM;QACxE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,MAAM;KACtF,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM;QACxE,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,MAAM;KACzF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IASxB;IACC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,sHAAsH,CAAC,CAAC;QACnI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,yCAAyC,IAAI,CAAC,UAAU,2CAA2C,CAAC,CAAC;QAClH,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,GAAG,CAAC,4GAA4G,CAAC,CAAC;QAC3H,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,GAAG,CAAC,6BAA6B,IAAI,CAAC,OAAO,CAAC,WAAW,kEAAkE,CAAC,CAAC;IACtI,CAAC;IACD,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,+GAA+G,CAAC,CAAC;IAC9H,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,mFAAmF,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,CAAC,gFAAgF,CAAC,CAAC;IAC/F,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAoC;IAC5E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IACpC,MAAM,eAAe,GAAG,OAAO,EAAE,SAAS,KAAK,IAAI,CAAC;IACpD,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3C,MAAM,cAAc,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC;IACjD,MAAM,IAAI,GAAG,eAAe,CAAC;QAC3B,eAAe;QACf,WAAW,EAAE,aAAa,EAAE;QAC5B,UAAU,EAAE,IAAI;QAChB,WAAW;QACX,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,YAAY,CAAC,QAAQ,GAAG,YAAY,CAAC,QAAQ;QACvD,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,YAAY,EAAE,YAAY,CAAC,UAAU,GAAG,YAAY,CAAC,YAAY;KAClE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,CAAC,eAAe,IAAI,WAAW,GAAG,CAAC,IAAI,QAAQ,CAAC,OAAO,IAAI,YAAY,CAAC,QAAQ,GAAG,CAAC,IAAI,YAAY,CAAC,QAAQ,GAAG,CAAC;QAC9H,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC;IAEX,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM;QACN,OAAO,EAAE,CAAC;QACV,aAAa,EAAE,uBAAuB,EAAE;QACxC,WAAW,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE;QACxC,SAAS,EAAE;YACT,QAAQ,EAAE,IAAI;YACd,iBAAiB,EAAE,IAAI,CAAC,CAAC,CAAC,oBAAoB,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI;YAC/D,WAAW,EAAE,aAAa,EAAE;SAC7B;QACD,MAAM,EAAE;YACN,SAAS,EAAE,eAAe;YAC1B,UAAU,EAAE,OAAO,EAAE,UAAU,IAAI,IAAI;YACvC,cAAc,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;YACpF,kBAAkB,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI;SAC7F;QACD,KAAK,EAAE;YACL,IAAI,EAAE,CAAC,QAAQ,CAAC,OAAO,IAAI,WAAW,KAAK,CAAC,IAAI,cAAc,KAAK,CAAC;YACpE,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,WAAW;YACX,cAAc;YACd,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC;SAClC;QACD,MAAM,EAAE;YACN,MAAM,EAAE,YAAY;YACpB,KAAK,EAAE,YAAY;SACpB;QACD,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC"}

package/dist/bridge-workflow-smoke-cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function runBridgeWorkflowSmokeCli(argv?: string[]): Promise<void>;

package/dist/bridge-workflow-smoke-cli.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import { pathToFileURL } from "node:url";
+import { runBridgeWorkflowSmoke } from "./bridge-workflow-smoke.js";
+function usage() {
+    return [
+        "Usage: sxl-bridge-smoke [--url <baseUrl>] [--auth-token <token>] [--timeout-ms <ms>] [--component-query <text>] [--component-prefix <prefix>] [--component-limit <n>] [--apply] [--cleanup] [--json]",
+        "",
+        "Default mode is non-destructive: status -> get_plugin_status -> find_components -> build_mockup dryRun.",
+        "Use --apply only when you intentionally want to create the smoke frame in the active Figma file.",
+        "Use --apply --cleanup to delete the smoke frame after verifying creation.",
+    ].join("\n");
+}
+function parseArgs(argv) {
+    const args = { apply: false, cleanup: false, json: false };
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === "--help" || arg === "-h") {
+            console.log(usage());
+            process.exit(0);
+        }
+        if (arg === "--apply") {
+            args.apply = true;
+            continue;
+        }
+        if (arg === "--cleanup") {
+            args.cleanup = true;
+            continue;
+        }
+        if (arg === "--json") {
+            args.json = true;
+            continue;
+        }
+        if (arg === "--url") {
+            args.baseUrl = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--auth-token") {
+            args.authToken = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--timeout-ms") {
+            const value = Number.parseInt(argv[i + 1] ?? "", 10);
+            if (!Number.isFinite(value) || value <= 0) {
+                throw new Error("--timeout-ms must be a positive integer.");
+            }
+            args.timeoutMs = value;
+            i += 1;
+            continue;
+        }
+        if (arg === "--component-query") {
+            args.componentQuery = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--component-prefix") {
+            args.componentPrefix = argv[i + 1];
+            i += 1;
+            continue;
+        }
+        if (arg === "--component-limit") {
+            const value = Number.parseInt(argv[i + 1] ?? "", 10);
+            if (!Number.isFinite(value) || value <= 0) {
+                throw new Error("--component-limit must be a positive integer.");
+            }
+            args.componentLimit = value;
+            i += 1;
+            continue;
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    return args;
+}
+function renderText(report) {
+    const lines = [];
+    const mode = report.apply ? report.cleanup ? "apply+cleanup" : "apply" : "dry-run";
+    lines.push(`SXL Bridge workflow smoke: ${report.status.toUpperCase()} (${mode})`);
+    lines.push(`Version: ${report.bridgeVersion}`);
+    lines.push(`Base URL: ${report.baseUrl}`);
+    lines.push("");
+    for (const step of report.steps) {
+        const command = step.commandType ? ` [${step.commandType}]` : "";
+        const timing = typeof step.durationMs === "number" ? ` ${step.durationMs}ms` : "";
+        lines.push(`- ${step.status.toUpperCase()} ${step.name}${command}${timing}`);
+    }
+    if (report.findings.length > 0) {
+        lines.push("");
+        lines.push("Findings:");
+        for (const finding of report.findings) {
+            const step = finding.step ? ` ${finding.step}` : "";
+            lines.push(`- ${finding.severity.toUpperCase()} ${finding.code}${step}: ${finding.message}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function runBridgeWorkflowSmokeCli(argv = process.argv.slice(2)) {
+    const args = parseArgs(argv);
+    const report = await runBridgeWorkflowSmoke({
+        baseUrl: args.baseUrl,
+        authToken: args.authToken,
+        timeoutMs: args.timeoutMs,
+        apply: args.apply,
+        cleanup: args.cleanup,
+        componentQuery: args.componentQuery,
+        componentPrefix: args.componentPrefix,
+        componentLimit: args.componentLimit,
+    });
+    if (args.json) {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log(renderText(report));
+    }
+    process.exit(report.ok ? 0 : 1);
+}
+const isCliEntry = process.argv[1] !== undefined && import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isCliEntry) {
+    runBridgeWorkflowSmokeCli().catch((error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        console.error("");
+        console.error(usage());
+        process.exit(2);
+    });
+}
+//# sourceMappingURL=bridge-workflow-smoke-cli.js.map

package/dist/bridge-workflow-smoke-cli.js.map

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

package/dist/bridge-workflow-smoke.d.ts

@@ -0,0 +1,39 @@
+export type BridgeWorkflowSmokeSeverity = "error" | "warning" | "info";
+export type BridgeWorkflowSmokeFinding = {
+    severity: BridgeWorkflowSmokeSeverity;
+    code: string;
+    message: string;
+    step?: string;
+};
+export type BridgeWorkflowSmokeStep = {
+    name: string;
+    commandType?: string;
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    durationMs?: number;
+    details?: Record<string, unknown>;
+};
+export type BridgeWorkflowSmokeReport = {
+    ok: boolean;
+    status: "pass" | "warn" | "fail";
+    version: 1;
+    bridgeVersion: string;
+    generatedAt: string;
+    baseUrl: string;
+    apply: boolean;
+    cleanup: boolean;
+    steps: BridgeWorkflowSmokeStep[];
+    findings: BridgeWorkflowSmokeFinding[];
+};
+export type BridgeWorkflowSmokeOptions = {
+    baseUrl?: string;
+    authToken?: string;
+    timeoutMs?: number;
+    apply?: boolean;
+    cleanup?: boolean;
+    componentQuery?: string;
+    componentPrefix?: string;
+    componentLimit?: number;
+    fetchImpl?: typeof fetch;
+};
+export declare function runBridgeWorkflowSmoke(options?: BridgeWorkflowSmokeOptions): Promise<BridgeWorkflowSmokeReport>;