ridgeline 0.7.21 → 0.8.1

package/dist/sensors/a11y.js.map

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

package/dist/sensors/contrast.d.ts

@@ -0,0 +1,3 @@
+import type { SensorAdapter } from "./index";
+declare const contrastSensor: SensorAdapter;
+export default contrastSensor;

package/dist/sensors/contrast.js

@@ -0,0 +1,117 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const wcag_contrast_1 = require("wcag-contrast");
+const WCAG_AA_NORMAL = 4.5;
+const HEX_TOKEN = /#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})\b/g;
+const HEX_VALIDATE = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+const normalizeHex = (value) => {
+    const trimmed = value.trim();
+    if (!trimmed.startsWith("#"))
+        return `#${trimmed}`;
+    return trimmed;
+};
+const isValidHex = (value) => HEX_VALIDATE.test(value);
+const extractPairsFromMarkdown = (content) => {
+    const pairs = [];
+    const lines = content.split(/\r?\n/);
+    for (const line of lines) {
+        const tokens = line.match(HEX_TOKEN);
+        if (!tokens || tokens.length < 2)
+            continue;
+        const [bg, fg] = tokens;
+        pairs.push({ background: bg, foreground: fg });
+    }
+    return pairs;
+};
+const discoverPairs = (input) => {
+    if (input.contrastPairs && input.contrastPairs.length > 0) {
+        return [...input.contrastPairs];
+    }
+    const ridgelineDir = input.ridgelineDir ?? path.join(input.cwd, ".ridgeline");
+    const designPath = path.join(ridgelineDir, "design.md");
+    if (!fs.existsSync(designPath))
+        return [];
+    const content = fs.readFileSync(designPath, "utf-8");
+    return extractPairsFromMarkdown(content);
+};
+const scorePair = (pair) => {
+    const background = normalizeHex(pair.background);
+    const foreground = normalizeHex(pair.foreground);
+    if (!isValidHex(background) || !isValidHex(foreground)) {
+        return {
+            kind: "contrast",
+            summary: `invalid hex pair ${foreground} / ${background}`,
+            severity: "warning",
+        };
+    }
+    let ratio;
+    try {
+        ratio = (0, wcag_contrast_1.hex)(foreground, background);
+    }
+    catch {
+        return {
+            kind: "contrast",
+            summary: `invalid hex pair ${foreground} / ${background}`,
+            severity: "warning",
+        };
+    }
+    const label = pair.name ? `${pair.name} (${foreground} on ${background})` : `${foreground} on ${background}`;
+    if (ratio < WCAG_AA_NORMAL) {
+        return {
+            kind: "contrast",
+            summary: `${label}: contrast ${ratio.toFixed(2)}:1 below WCAG AA 4.5:1`,
+            severity: "error",
+        };
+    }
+    return {
+        kind: "contrast",
+        summary: `${label}: contrast ${ratio.toFixed(2)}:1 meets WCAG AA`,
+        severity: "info",
+    };
+};
+const contrastSensor = {
+    name: "contrast",
+    async run(input) {
+        const pairs = discoverPairs(input);
+        if (pairs.length === 0)
+            return [];
+        return pairs.map(scorePair);
+    },
+};
+exports.default = contrastSensor;
+//# sourceMappingURL=contrast.js.map

package/dist/sensors/contrast.js.map

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

package/dist/sensors/index.d.ts

@@ -0,0 +1,27 @@
+import type { SensorName } from "../engine/detect";
+export interface SensorFinding {
+    kind: "screenshot" | "a11y" | "contrast" | "vision";
+    path?: string;
+    summary: string;
+    severity: "info" | "warning" | "error";
+}
+export interface ColorPair {
+    name?: string;
+    foreground: string;
+    background: string;
+}
+export interface SensorInput {
+    cwd: string;
+    ridgelineDir?: string;
+    buildDir?: string;
+    shapeMdPath?: string;
+    artifactsDir?: string;
+    model?: string;
+    url?: string;
+    screenshotPath?: string;
+    contrastPairs?: readonly ColorPair[];
+}
+export interface SensorAdapter {
+    readonly name: SensorName;
+    run(input: SensorInput): Promise<SensorFinding[]>;
+}

package/dist/sensors/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/sensors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sensors/index.ts"],"names":[],"mappings":""}

package/dist/sensors/playwright.d.ts

@@ -0,0 +1,69 @@
+import type { SensorAdapter, SensorFinding, SensorInput } from "./index";
+export declare const PROBE_PORTS: readonly number[];
+type PortResult = {
+    source: "shape-md";
+    port: number;
+} | {
+    source: "probe";
+    port: number;
+    attempts: readonly number[];
+} | {
+    source: "none";
+    attempts: readonly number[];
+    reason: "no-probe-match" | "malformed-declaration";
+};
+interface ParseResult {
+    port: number | null;
+    malformed: boolean;
+}
+export declare const parsePortFromShape: (content: string) => ParseResult;
+interface ProbeOptions {
+    timeoutPerProbeMs?: number;
+    totalTimeoutMs?: number;
+    probe?: (port: number, timeoutMs: number) => Promise<boolean>;
+    ports?: readonly number[];
+}
+export declare const probeDevServer: (options?: ProbeOptions) => Promise<{
+    port: number | null;
+    attempts: readonly number[];
+}>;
+export declare const resolveDevServerPort: (input: SensorInput, options?: ProbeOptions) => Promise<PortResult>;
+interface PlaywrightModule {
+    chromium: {
+        launch(options: {
+            args?: string[];
+            timeout?: number;
+            headless?: boolean;
+        }): Promise<PlaywrightBrowser>;
+    };
+}
+interface PlaywrightBrowser {
+    newPage(): Promise<PlaywrightPage>;
+    close(): Promise<void>;
+}
+interface PlaywrightPage {
+    goto(url: string, options?: {
+        timeout?: number;
+        waitUntil?: string;
+    }): Promise<unknown>;
+    screenshot(options: {
+        path: string;
+        fullPage?: boolean;
+    }): Promise<Buffer>;
+    close(): Promise<void>;
+    addScriptTag(options: {
+        path: string;
+    }): Promise<unknown>;
+    evaluate<R>(fn: string | (() => R)): Promise<R>;
+}
+type LoadPlaywright = () => PlaywrightModule;
+interface PlaywrightRunInternals {
+    loadPlaywright?: LoadPlaywright;
+    isSandboxed?: () => boolean;
+    isResolvable?: () => boolean;
+    probeOptions?: ProbeOptions;
+    launchTimeoutMs?: number;
+}
+export declare const runPlaywrightSensor: (input: SensorInput, internals?: PlaywrightRunInternals) => Promise<SensorFinding[]>;
+declare const playwrightSensor: SensorAdapter;
+export default playwrightSensor;

package/dist/sensors/playwright.js

@@ -0,0 +1,266 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPlaywrightSensor = exports.resolveDevServerPort = exports.probeDevServer = exports.parsePortFromShape = exports.PROBE_PORTS = void 0;
+const fs = __importStar(require("node:fs"));
+const http = __importStar(require("node:http"));
+const path = __importStar(require("node:path"));
+const PLAYWRIGHT_INSTALL_HINT = "npm install --save-dev playwright && npx playwright install chromium";
+const isPlaywrightResolvable = () => {
+    try {
+        require.resolve("playwright");
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const LAUNCH_TIMEOUT_MS = 10_000;
+const DEFAULT_PROBE_TIMEOUT_MS = 250;
+const DEFAULT_TOTAL_PROBE_MS = 1_000;
+const RUNTIME_BLOCK_RE = /^##\s+Runtime\s*$([\s\S]*?)(?=^##\s+|$(?![\r\n]))/m;
+const DEV_PORT_LINE_RE = /^\s*-\s*\*\*Dev server port:\*\*\s+(\d+)\s*$/m;
+const DEV_PORT_LINE_GLOBAL = new RegExp(DEV_PORT_LINE_RE.source, "gm");
+exports.PROBE_PORTS = [5173, 3000, 8080, 4321];
+const parsePortFromShape = (content) => {
+    const runtimeBlocks = [];
+    const blockRe = new RegExp(RUNTIME_BLOCK_RE.source, "gm");
+    let match;
+    while ((match = blockRe.exec(content)) !== null) {
+        runtimeBlocks.push(match[1] ?? "");
+    }
+    if (runtimeBlocks.length === 0)
+        return { port: null, malformed: false };
+    if (runtimeBlocks.length > 1)
+        return { port: null, malformed: true };
+    const block = runtimeBlocks[0];
+    const ports = [];
+    let m;
+    const globalRe = new RegExp(DEV_PORT_LINE_GLOBAL.source, "gm");
+    while ((m = globalRe.exec(block)) !== null) {
+        const n = parseInt(m[1], 10);
+        if (Number.isFinite(n) && n >= 1 && n <= 65535) {
+            ports.push(n);
+        }
+        else {
+            return { port: null, malformed: true };
+        }
+    }
+    if (ports.length === 0)
+        return { port: null, malformed: false };
+    if (ports.length > 1)
+        return { port: null, malformed: true };
+    return { port: ports[0], malformed: false };
+};
+exports.parsePortFromShape = parsePortFromShape;
+const headProbe = (port, timeoutMs) => new Promise((resolve) => {
+    const req = http.request({ host: "127.0.0.1", port, method: "HEAD", path: "/", timeout: timeoutMs }, (res) => {
+        res.resume();
+        resolve(true);
+    });
+    req.on("timeout", () => {
+        req.destroy();
+        resolve(false);
+    });
+    req.on("error", () => resolve(false));
+    req.end();
+});
+const probeDevServer = async (options = {}) => {
+    const perProbe = options.timeoutPerProbeMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+    const total = options.totalTimeoutMs ?? DEFAULT_TOTAL_PROBE_MS;
+    const probeFn = options.probe ?? headProbe;
+    const ports = options.ports ?? exports.PROBE_PORTS;
+    const attempts = [];
+    const start = Date.now();
+    for (const port of ports) {
+        if (Date.now() - start >= total)
+            break;
+        attempts.push(port);
+        const ok = await probeFn(port, perProbe).catch(() => false);
+        if (ok)
+            return { port, attempts };
+    }
+    return { port: null, attempts };
+};
+exports.probeDevServer = probeDevServer;
+const readShapeMd = (input) => {
+    const candidate = input.shapeMdPath ??
+        (input.buildDir ? path.join(input.buildDir, "shape.md") : null);
+    if (!candidate)
+        return null;
+    if (!fs.existsSync(candidate))
+        return null;
+    try {
+        return fs.readFileSync(candidate, "utf-8");
+    }
+    catch {
+        return null;
+    }
+};
+const logWarn = (line) => {
+    process.stderr.write(`${line}\n`);
+};
+const resolveDevServerPort = async (input, options = {}) => {
+    const shape = readShapeMd(input);
+    if (shape) {
+        const parsed = (0, exports.parsePortFromShape)(shape);
+        if (parsed.port !== null) {
+            return { source: "shape-md", port: parsed.port };
+        }
+        if (parsed.malformed) {
+            logWarn(`[ridgeline] WARN: shape.md ## Runtime has malformed dev-server port; falling back to probing`);
+        }
+    }
+    const { port, attempts } = await (0, exports.probeDevServer)(options);
+    if (port === null) {
+        return { source: "none", attempts, reason: "no-probe-match" };
+    }
+    return { source: "probe", port, attempts };
+};
+exports.resolveDevServerPort = resolveDevServerPort;
+const isSandboxDetected = (env = process.env) => {
+    if (env.RIDGELINE_SANDBOX)
+        return true;
+    if (env.GREYWALL_ACTIVE)
+        return true;
+    if (env.BWRAP_DETECTED)
+        return true;
+    if (env.container)
+        return true;
+    return false;
+};
+const defaultLoadPlaywright = () => require("playwright");
+const unresolvableFinding = () => ({
+    kind: "screenshot",
+    severity: "warning",
+    summary: `Playwright is not installed. Install with: ${PLAYWRIGHT_INSTALL_HINT}`,
+});
+const launchFailureFinding = (message) => ({
+    kind: "screenshot",
+    severity: "warning",
+    summary: `Chromium launch failed — sandbox-incompatible (${message})`,
+});
+const noDevServerFinding = (attempts) => ({
+    kind: "screenshot",
+    severity: "warning",
+    summary: `no dev server detected (probed ports: ${attempts.join(", ") || "none"})`,
+});
+const runPlaywrightSensor = async (input, internals = {}) => {
+    const resolvable = (internals.isResolvable ?? isPlaywrightResolvable)();
+    if (!resolvable) {
+        return [unresolvableFinding()];
+    }
+    const port = await (0, exports.resolveDevServerPort)(input, internals.probeOptions).catch(() => ({
+        source: "none",
+        attempts: [],
+        reason: "no-probe-match",
+    }));
+    if (port.source === "none") {
+        return [noDevServerFinding(port.attempts)];
+    }
+    const load = internals.loadPlaywright ?? defaultLoadPlaywright;
+    const sandboxed = (internals.isSandboxed ?? isSandboxDetected)();
+    const launchTimeout = internals.launchTimeoutMs ?? LAUNCH_TIMEOUT_MS;
+    const launchArgs = sandboxed ? ["--no-sandbox", "--disable-setuid-sandbox"] : [];
+    let playwright;
+    try {
+        playwright = load();
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (message.toLowerCase().includes("cannot find module")) {
+            return [unresolvableFinding()];
+        }
+        return [launchFailureFinding(message)];
+    }
+    let browser;
+    try {
+        browser = await playwright.chromium.launch({
+            args: launchArgs,
+            timeout: launchTimeout,
+            headless: true,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        if (/executable doesn.?t exist|browser not found|playwright install/i.test(message)) {
+            return [unresolvableFinding()];
+        }
+        return [launchFailureFinding(message)];
+    }
+    const artifactsDir = input.artifactsDir ??
+        (input.buildDir ? path.join(input.buildDir, "artifacts") : path.join(input.cwd, ".ridgeline", "artifacts"));
+    try {
+        fs.mkdirSync(artifactsDir, { recursive: true });
+    }
+    catch {
+        // directory creation failed — fall through; screenshot will fail non-fatally
+    }
+    const screenshotPath = path.join(artifactsDir, `screenshot-${Date.now()}.png`);
+    const url = input.url ?? `http://127.0.0.1:${port.port}`;
+    try {
+        const page = await browser.newPage();
+        await page.goto(url, { waitUntil: "load", timeout: launchTimeout });
+        await page.screenshot({ path: screenshotPath, fullPage: true });
+        await page.close();
+    }
+    catch (err) {
+        await browser.close().catch(() => { });
+        const message = err instanceof Error ? err.message : String(err);
+        return [
+            {
+                kind: "screenshot",
+                severity: "warning",
+                summary: `screenshot failed at ${url}: ${message}`,
+            },
+        ];
+    }
+    await browser.close().catch(() => { });
+    return [
+        {
+            kind: "screenshot",
+            severity: "info",
+            path: screenshotPath,
+            summary: `captured screenshot of ${url} (port source: ${port.source})`,
+        },
+    ];
+};
+exports.runPlaywrightSensor = runPlaywrightSensor;
+const playwrightSensor = {
+    name: "playwright",
+    run: (input) => (0, exports.runPlaywrightSensor)(input),
+};
+exports.default = playwrightSensor;
+//# sourceMappingURL=playwright.js.map

package/dist/sensors/playwright.js.map

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

package/dist/sensors/vision.d.ts

@@ -0,0 +1,18 @@
+import type { SensorAdapter, SensorFinding, SensorInput } from "./index";
+type InvokeVision = (args: {
+    systemPrompt: string;
+    userPrompt: string;
+    model: string;
+    cwd: string;
+    imagePath: string;
+}) => Promise<{
+    result: string;
+}>;
+interface VisionRunInternals {
+    invokeVision?: InvokeVision;
+    existsSync?: (p: string) => boolean;
+    isResolvable?: () => boolean;
+}
+export declare const runVisionSensor: (input: SensorInput, internals?: VisionRunInternals) => Promise<SensorFinding[]>;
+declare const visionSensor: SensorAdapter;
+export default visionSensor;

package/dist/sensors/vision.js

@@ -0,0 +1,125 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runVisionSensor = void 0;
+const fs = __importStar(require("node:fs"));
+const claude_exec_1 = require("../engine/claude/claude.exec");
+const PLAYWRIGHT_INSTALL_HINT = "npm install --save-dev playwright && npx playwright install chromium";
+const isPlaywrightResolvable = () => {
+    try {
+        require.resolve("playwright");
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const VISION_SYSTEM_PROMPT = "You are a visual-analysis assistant. Describe the rendered UI at the given screenshot path: "
+    + "layout, visible elements, color usage, obvious visual defects. Respond in 3-5 short bullet points. "
+    + "Read the image file with the Read tool.";
+const VISION_TIMEOUT_MS = 2 * 60 * 1000;
+const defaultInvokeVision = async (args) => {
+    const result = await (0, claude_exec_1.invokeClaude)({
+        systemPrompt: args.systemPrompt,
+        userPrompt: args.userPrompt,
+        model: args.model,
+        allowedTools: ["Read"],
+        cwd: args.cwd,
+        timeoutMs: VISION_TIMEOUT_MS,
+    });
+    return { result: result.result };
+};
+const unresolvableFinding = () => ({
+    kind: "vision",
+    severity: "warning",
+    summary: `Playwright is not installed. Install with: ${PLAYWRIGHT_INSTALL_HINT}`,
+});
+const runVisionSensor = async (input, internals = {}) => {
+    const resolvable = (internals.isResolvable ?? isPlaywrightResolvable)();
+    if (!resolvable) {
+        return [unresolvableFinding()];
+    }
+    const imagePath = input.screenshotPath;
+    const exists = internals.existsSync ?? fs.existsSync;
+    if (!imagePath || !exists(imagePath)) {
+        return [
+            {
+                kind: "vision",
+                severity: "warning",
+                summary: imagePath
+                    ? `screenshot not found at ${imagePath}`
+                    : "no screenshot path provided for vision analysis",
+            },
+        ];
+    }
+    const invoke = internals.invokeVision ?? defaultInvokeVision;
+    const model = input.model ?? "opus";
+    const userPrompt = `Analyze the UI screenshot at: ${imagePath}\n\nRead the image with the Read tool, then respond with 3-5 short observations.`;
+    try {
+        const { result } = await invoke({
+            systemPrompt: VISION_SYSTEM_PROMPT,
+            userPrompt,
+            model,
+            cwd: input.cwd,
+            imagePath,
+        });
+        return [
+            {
+                kind: "vision",
+                severity: "info",
+                path: imagePath,
+                summary: result.trim() || "(vision returned empty analysis)",
+            },
+        ];
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return [
+            {
+                kind: "vision",
+                severity: "warning",
+                path: imagePath,
+                summary: `vision analysis failed: ${message}`,
+            },
+        ];
+    }
+};
+exports.runVisionSensor = runVisionSensor;
+const visionSensor = {
+    name: "vision",
+    run: (input) => (0, exports.runVisionSensor)(input),
+};
+exports.default = visionSensor;
+//# sourceMappingURL=vision.js.map