codeloop-mcp-server 0.1.14 → 0.1.15

package/dist/prompt_manager/templates.js

@@ -0,0 +1,177 @@
+/**
+ * Prompt Manager — five-layer template library.
+ *
+ * Layers correspond to the lifecycle of multi-section app construction
+ * (see CodeLoop_Development_Plan.md §19):
+ *   1. master_human       — top-level user-facing instruction relayed to the agent
+ *   2. planning           — translate master spec into section graph + checkpoints
+ *   3. section_implement  — per-section build prompt
+ *   4. repair             — issued when verification or gate_check fails
+ *   5. integration        — issued at integration checkpoints to wire sections together
+ *
+ * Each template is plain text with `{{variable}}` placeholders that are filled
+ * from a context object at render time. Missing variables become the literal
+ * empty string (the renderer never throws); callers are expected to validate
+ * required variables via {@link describeTemplate}.
+ */
+const TEMPLATES = {
+    master_human: {
+        layer: "master_human",
+        id: "master_human.v1",
+        description: "Initial framing for the agent when the user issues a one-line application goal. Echoes back the goal, requires a master spec, and forces a planning pass.",
+        required_vars: ["user_goal", "project_name"],
+        body: [
+            "You are working on **{{project_name}}**.",
+            "",
+            "User goal:",
+            "> {{user_goal}}",
+            "",
+            "Before writing any code:",
+            "1. Confirm `docs/specs/_master.md` exists. If it does not, write one that breaks the goal into independently testable sections with explicit dependencies.",
+            "2. Call `codeloop_section_status` to bootstrap the section registry.",
+            "3. Call `codeloop_get_prompt` with `layer=\"planning\"` to produce a build plan, then proceed section by section.",
+            "",
+            "Constraints:",
+            "- Never declare the project complete without a passing `codeloop_gate_check` (confidence ≥ 94%).",
+            "- After every code change, call `codeloop_verify`. If `codeloop_diagnose` returns repair tasks, call `codeloop_get_prompt` with `layer=\"repair\"`.",
+            "- After every {{integration_cadence}} sections, call `codeloop_integration_check`.",
+        ].join("\n"),
+    },
+    planning: {
+        layer: "planning",
+        id: "planning.v1",
+        description: "Translates the master spec into an ordered build plan and per-section acceptance criteria. Output is consumed by section_implement.",
+        required_vars: ["master_spec_path", "section_count"],
+        body: [
+            "Plan a section-by-section build for the spec at `{{master_spec_path}}`.",
+            "There are {{section_count}} sections. For each section, list:",
+            "  - section_id (kebab-case, matches the spec heading)",
+            "  - blocking dependencies (other section_ids that must be `READY` first)",
+            "  - acceptance criteria (testable, max 6 bullets)",
+            "  - integration risk (which earlier sections are most likely to regress)",
+            "",
+            "Order the sections via topological sort. When dependencies tie, prefer the section with the fewest acceptance criteria first to maximise early gate-check signal.",
+            "",
+            "Emit the result as JSON matching this shape:",
+            "```json",
+            "{",
+            "  \"order\": [\"section-id-1\", \"section-id-2\", ...],",
+            "  \"sections\": {",
+            "    \"section-id-1\": { \"deps\": [], \"acceptance\": [...], \"risk\": [...] }",
+            "  },",
+            "  \"integration_checkpoints\": [\"section-id-2\", \"section-id-4\"]",
+            "}",
+            "```",
+        ].join("\n"),
+    },
+    section_implement: {
+        layer: "section_implement",
+        id: "section_implement.v1",
+        description: "Per-section build prompt. Embeds acceptance criteria and forces a verify+gate loop before the section may be marked READY.",
+        required_vars: ["section_id", "section_name", "acceptance_criteria"],
+        body: [
+            "Implement section **{{section_id}} — {{section_name}}**.",
+            "",
+            "Acceptance criteria:",
+            "{{acceptance_criteria}}",
+            "",
+            "Dependencies already READY: {{ready_deps}}",
+            "",
+            "Workflow:",
+            "1. Make the smallest coherent code change that advances at least one acceptance criterion.",
+            "2. Call `codeloop_verify` with `section_id={{section_id}}`.",
+            "3. If verification fails, request the repair prompt (`codeloop_get_prompt` layer=\"repair\"). Do not skip to the next section.",
+            "4. When all acceptance criteria are met and `codeloop_gate_check` passes for this section, call `codeloop_section_status` to mark it READY.",
+            "",
+            "Do not modify files belonging to other sections. If you must, stop and request `layer=\"integration\"` instead.",
+        ].join("\n"),
+    },
+    repair: {
+        layer: "repair",
+        id: "repair.v1",
+        description: "Repair prompt. Used when codeloop_verify or codeloop_gate_check fails. Forces a constrained, deterministic fix loop.",
+        required_vars: ["section_id", "failure_summary", "attempt", "max_attempts"],
+        body: [
+            "Repair attempt {{attempt}}/{{max_attempts}} for section **{{section_id}}**.",
+            "",
+            "Failure summary from `codeloop_diagnose`:",
+            "{{failure_summary}}",
+            "",
+            "Rules:",
+            "1. Address the highest-priority repair task first.",
+            "2. Do not introduce changes outside the failing section's directory unless the diagnose report explicitly says so.",
+            "3. After each fix, re-run `codeloop_verify` for this section only.",
+            "4. If attempt {{attempt}} >= {{max_attempts}}, stop and call `codeloop_replan` to escalate.",
+            "",
+            "Treat any new lint warnings or test regressions in already-READY sections as a hard stop — switch to the integration prompt instead.",
+        ].join("\n"),
+    },
+    integration: {
+        layer: "integration",
+        id: "integration.v1",
+        description: "Integration prompt issued at checkpoints. Coordinates cross-section verification and regression hunting.",
+        required_vars: ["sections_in_scope", "checkpoint_index"],
+        body: [
+            "Integration checkpoint #{{checkpoint_index}}.",
+            "",
+            "Sections in scope: {{sections_in_scope}}",
+            "",
+            "Workflow:",
+            "1. Call `codeloop_integration_check` for the listed sections.",
+            "2. For each regression listed in the result, open the affected section, run `codeloop_get_prompt` with `layer=\"repair\"`, and fix it before continuing.",
+            "3. Capture cross-section screenshots and a short interaction recording with `codeloop_capture_screenshot` and `codeloop_start_recording`/`codeloop_stop_recording`.",
+            "4. Call `codeloop_gate_check` with `scope=\"integration\"`.",
+            "",
+            "Only return to per-section work when integration confidence is ≥ 94%.",
+        ].join("\n"),
+    },
+};
+export const PROMPT_LAYERS = [
+    "master_human",
+    "planning",
+    "section_implement",
+    "repair",
+    "integration",
+];
+export function listTemplates() {
+    return PROMPT_LAYERS.map((layer) => TEMPLATES[layer]);
+}
+export function getTemplate(layer) {
+    const t = TEMPLATES[layer];
+    if (!t) {
+        throw new Error(`Unknown prompt layer: ${layer}`);
+    }
+    return t;
+}
+export function describeTemplate(layer) {
+    const t = getTemplate(layer);
+    return {
+        id: t.id,
+        description: t.description,
+        required_vars: t.required_vars,
+    };
+}
+/**
+ * Render a template using a context object. Missing variables are recorded in
+ * `missing_vars` and replaced with the empty string. Caller decides whether to
+ * treat missing required variables as an error.
+ */
+export function renderTemplate(layer, context = {}) {
+    const tpl = getTemplate(layer);
+    const missing = [];
+    const prompt = tpl.body.replace(/\{\{\s*([a-zA-Z0-9_]+)\s*\}\}/g, (_m, key) => {
+        const value = context[key];
+        if (value === undefined || value === null || value === "") {
+            if (tpl.required_vars.includes(key)) {
+                missing.push(key);
+            }
+            return "";
+        }
+        if (Array.isArray(value)) {
+            return value.map((v) => `- ${String(v)}`).join("\n");
+        }
+        return String(value);
+    });
+    return { prompt, missing_vars: [...new Set(missing)] };
+}
+//# sourceMappingURL=templates.js.map

package/dist/prompt_manager/templates.js.map

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

package/dist/runners/base.d.ts

@@ -12,7 +12,7 @@ export interface RunnerResult {
 }
 export declare function makeSkippedResult(runnerName: string, reason: string): RunnerResult;
 export declare function checkToolAvailable(command: string): Promise<boolean>;
-export declare function runCommand(cmd: string, args: string[], cwd: string, logPath?: string): Promise<{
+export declare function runCommand(cmd: string, args: string[], cwd: string, logPath?: string, extraEnv?: Record<string, string>): Promise<{
     exit_code: number;
     stdout: string;
     stderr: string;

package/dist/runners/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/runners/base.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,YAAY,CAad;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1E;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAqDrF"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/runners/base.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,YAAY,CAad;AAED,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ1E;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAqDrF"}

package/dist/runners/base.js

@@ -25,7 +25,7 @@ export async function checkToolAvailable(command) {
         return false;
     }
 }
-export async function runCommand(cmd, args, cwd, logPath) {
+export async function runCommand(cmd, args, cwd, logPath, extraEnv) {
     const start = Date.now();
     return new Promise((resolve) => {
         const quotedArgs = args.map(a => (a.includes(" ") ? `"${a}"` : a));
@@ -33,7 +33,7 @@ export async function runCommand(cmd, args, cwd, logPath) {
             cwd,
             shell: true,
             stdio: ["pipe", "pipe", "pipe"],
-            env: { ...process.env },
+            env: { ...process.env, ...(extraEnv ?? {}) },
         });
         const stdoutChunks = [];
         const stderrChunks = [];

package/dist/runners/base.js.map

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

package/dist/runners/figma_spec_generator.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Figma Spec Generator — pulls design tokens (colors, typography, spacing)
+ * from a Figma file's styles and writes them to `docs/specs/` and
+ * `docs/ui_rules.md`. Extends the existing Figma fetcher with token-level
+ * extraction via the Figma REST API v1 `files/:key` endpoint.
+ */
+export interface ColorToken {
+    name: string;
+    hex: string;
+    opacity: number;
+    r: number;
+    g: number;
+    b: number;
+}
+export interface TypographyToken {
+    name: string;
+    family: string;
+    weight: number;
+    size: number;
+    line_height?: number;
+    letter_spacing?: number;
+}
+export interface SpacingToken {
+    name: string;
+    value: number;
+}
+export interface DesignTokens {
+    colors: ColorToken[];
+    typography: TypographyToken[];
+    spacing: SpacingToken[];
+    extracted_at: string;
+    figma_file_key: string;
+}
+/**
+ * Extract design tokens from a Figma file using the REST API.
+ */
+export declare function extractTokensFromFigma(fileKey: string, token: string): Promise<{
+    tokens: DesignTokens;
+    errors: string[];
+}>;
+export declare function writeTokenFiles(cwd: string, tokens: DesignTokens): {
+    specPath: string;
+    rulesPath: string;
+};
+/**
+ * Full pipeline: load Figma config -> extract tokens -> write docs.
+ */
+export declare function generateSpec(cwd: string): Promise<{
+    tokens: DesignTokens;
+    errors: string[];
+    specPath?: string;
+    rulesPath?: string;
+}>;
+//# sourceMappingURL=figma_spec_generator.d.ts.map

package/dist/runners/figma_spec_generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma_spec_generator.d.ts","sourceRoot":"","sources":["../../src/runners/figma_spec_generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;CACxB;AAUD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAkFrD;AA4ED,wBAAgB,eAAe,CAC7B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,YAAY,GACnB;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAWzC;AA8CD;;GAEG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA4B5F"}

package/dist/runners/figma_spec_generator.js

@@ -0,0 +1,227 @@
+/**
+ * Figma Spec Generator — pulls design tokens (colors, typography, spacing)
+ * from a Figma file's styles and writes them to `docs/specs/` and
+ * `docs/ui_rules.md`. Extends the existing Figma fetcher with token-level
+ * extraction via the Figma REST API v1 `files/:key` endpoint.
+ */
+import { mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import { loadFigmaConfig, resolveFigmaToken, parseFigmaFileKey, } from "./figma_fetcher.js";
+function rgbaToHex(r, g, b) {
+    const toHex = (v) => Math.round(v * 255)
+        .toString(16)
+        .padStart(2, "0");
+    return `#${toHex(r)}${toHex(g)}${toHex(b)}`;
+}
+/**
+ * Extract design tokens from a Figma file using the REST API.
+ */
+export async function extractTokensFromFigma(fileKey, token) {
+    const errors = [];
+    const colors = [];
+    const typography = [];
+    const spacing = [];
+    let fileData;
+    try {
+        const resp = await fetch(`https://api.figma.com/v1/files/${fileKey}/styles`, {
+            headers: { "X-Figma-Token": token },
+        });
+        if (!resp.ok) {
+            errors.push(`Figma styles API returned ${resp.status}`);
+            return {
+                tokens: { colors, typography, spacing, extracted_at: new Date().toISOString(), figma_file_key: fileKey },
+                errors,
+            };
+        }
+        fileData = (await resp.json());
+    }
+    catch (err) {
+        errors.push(`Network error: ${err.message}`);
+        return {
+            tokens: { colors, typography, spacing, extracted_at: new Date().toISOString(), figma_file_key: fileKey },
+            errors,
+        };
+    }
+    const meta = fileData.meta;
+    const styles = meta?.styles ?? [];
+    const colorStyleKeys = [];
+    const textStyleKeys = [];
+    for (const style of styles) {
+        if (style.style_type === "FILL") {
+            colorStyleKeys.push(style.key);
+            colors.push({
+                name: style.name,
+                hex: "#000000",
+                opacity: 1,
+                r: 0,
+                g: 0,
+                b: 0,
+            });
+        }
+        else if (style.style_type === "TEXT") {
+            textStyleKeys.push(style.key);
+            typography.push({
+                name: style.name,
+                family: "Unknown",
+                weight: 400,
+                size: 16,
+            });
+        }
+    }
+    try {
+        // depth=4 keeps the document payload bounded while still surfacing
+        // tokens that live inside frames/components/component-sets a few levels
+        // deep. We then traverse the returned subtree recursively up to a hard
+        // depth cap to avoid runaway traversal on huge files.
+        const fileResp = await fetch(`https://api.figma.com/v1/files/${fileKey}?depth=4`, {
+            headers: { "X-Figma-Token": token },
+        });
+        if (fileResp.ok) {
+            const file = (await fileResp.json());
+            const doc = file.document;
+            if (doc?.children) {
+                extractTokensFromNodes(doc.children, colors, typography, spacing);
+            }
+        }
+    }
+    catch { /* swallow — we already have style names */ }
+    return {
+        tokens: {
+            colors,
+            typography,
+            spacing,
+            extracted_at: new Date().toISOString(),
+            figma_file_key: fileKey,
+        },
+        errors,
+    };
+}
+/**
+ * Hard cap on tree traversal. depth=4 fetches roughly the visual hierarchy
+ * we care about (page → frame → component → variant → leaf), and the cap
+ * here protects us if Figma ever returns deeper inline trees (e.g. nested
+ * component sets). Anything deeper than 8 is almost always implementation
+ * detail unrelated to design tokens.
+ */
+const MAX_TRAVERSAL_DEPTH = 8;
+function extractTokensFromNodes(nodes, colors, typography, spacing, depth = 0) {
+    if (depth > MAX_TRAVERSAL_DEPTH)
+        return;
+    for (const node of nodes) {
+        if (node.fills && Array.isArray(node.fills)) {
+            for (const fill of node.fills) {
+                if (fill.type === "SOLID" && fill.color) {
+                    const existing = colors.find((c) => c.name === node.name);
+                    if (existing) {
+                        existing.r = fill.color.r;
+                        existing.g = fill.color.g;
+                        existing.b = fill.color.b;
+                        existing.opacity = fill.color.a ?? 1;
+                        existing.hex = rgbaToHex(fill.color.r, fill.color.g, fill.color.b);
+                    }
+                }
+            }
+        }
+        if (node.style && typeof node.style === "object") {
+            const s = node.style;
+            if (s.fontFamily) {
+                const existing = typography.find((t) => t.name === node.name);
+                if (existing) {
+                    existing.family = String(s.fontFamily);
+                    existing.weight = Number(s.fontWeight) || 400;
+                    existing.size = Number(s.fontSize) || 16;
+                    if (s.lineHeightPx)
+                        existing.line_height = Number(s.lineHeightPx);
+                    if (s.letterSpacing)
+                        existing.letter_spacing = Number(s.letterSpacing);
+                }
+            }
+        }
+        if (node.itemSpacing && node.name) {
+            spacing.push({ name: `${node.name}/gap`, value: node.itemSpacing });
+        }
+        if (node.paddingLeft && node.name) {
+            spacing.push({ name: `${node.name}/padding`, value: node.paddingLeft });
+        }
+        if (node.children) {
+            extractTokensFromNodes(node.children, colors, typography, spacing, depth + 1);
+        }
+    }
+}
+export function writeTokenFiles(cwd, tokens) {
+    const specsDir = join(cwd, "docs", "specs");
+    mkdirSync(specsDir, { recursive: true });
+    const specPath = join(specsDir, "design_tokens.json");
+    writeFileSync(specPath, JSON.stringify(tokens, null, 2));
+    const rulesPath = join(cwd, "docs", "ui_rules.md");
+    const md = generateUiRulesMarkdown(tokens);
+    writeFileSync(rulesPath, md);
+    return { specPath, rulesPath };
+}
+function generateUiRulesMarkdown(tokens) {
+    const lines = [
+        "# UI Design Rules",
+        "",
+        `> Auto-generated from Figma (file: \`${tokens.figma_file_key}\`) on ${tokens.extracted_at}`,
+        "",
+    ];
+    if (tokens.colors.length > 0) {
+        lines.push("## Colors", "");
+        lines.push("| Name | Hex | Opacity |");
+        lines.push("|------|-----|---------|");
+        for (const c of tokens.colors) {
+            lines.push(`| ${c.name} | \`${c.hex}\` | ${c.opacity} |`);
+        }
+        lines.push("");
+    }
+    if (tokens.typography.length > 0) {
+        lines.push("## Typography", "");
+        lines.push("| Name | Family | Weight | Size | Line Height |");
+        lines.push("|------|--------|--------|------|-------------|");
+        for (const t of tokens.typography) {
+            lines.push(`| ${t.name} | ${t.family} | ${t.weight} | ${t.size}px | ${t.line_height ? `${t.line_height}px` : "auto"} |`);
+        }
+        lines.push("");
+    }
+    if (tokens.spacing.length > 0) {
+        lines.push("## Spacing", "");
+        lines.push("| Name | Value |");
+        lines.push("|------|-------|");
+        for (const s of tokens.spacing) {
+            lines.push(`| ${s.name} | ${s.value}px |`);
+        }
+        lines.push("");
+    }
+    lines.push("---", "", "These rules are enforced by CodeLoop's `codeloop_design_compare` tool during verification.");
+    return lines.join("\n");
+}
+/**
+ * Full pipeline: load Figma config -> extract tokens -> write docs.
+ */
+export async function generateSpec(cwd) {
+    const config = loadFigmaConfig(cwd);
+    if (!config) {
+        return {
+            tokens: { colors: [], typography: [], spacing: [], extracted_at: new Date().toISOString(), figma_file_key: "" },
+            errors: ["No .codeloop/figma.json found."],
+        };
+    }
+    const token = resolveFigmaToken(config);
+    if (!token) {
+        return {
+            tokens: { colors: [], typography: [], spacing: [], extracted_at: new Date().toISOString(), figma_file_key: "" },
+            errors: ["No Figma API token configured."],
+        };
+    }
+    const fileKey = config.file_key || (config.file_url ? parseFigmaFileKey(config.file_url) : null);
+    if (!fileKey) {
+        return {
+            tokens: { colors: [], typography: [], spacing: [], extracted_at: new Date().toISOString(), figma_file_key: "" },
+            errors: ["No Figma file key found."],
+        };
+    }
+    const { tokens, errors } = await extractTokensFromFigma(fileKey, token);
+    const { specPath, rulesPath } = writeTokenFiles(cwd, tokens);
+    return { tokens, errors, specPath, rulesPath };
+}
+//# sourceMappingURL=figma_spec_generator.js.map

package/dist/runners/figma_spec_generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"figma_spec_generator.js","sourceRoot":"","sources":["../../src/runners/figma_spec_generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAc,SAAS,EAAE,aAAa,EAAgB,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAiC5B,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IAChD,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAE,CAC1B,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC;SAChB,QAAQ,CAAC,EAAE,CAAC;SACZ,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACtB,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,KAAa;IAEb,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,UAAU,GAAsB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAmB,EAAE,CAAC;IAEnC,IAAI,QAAiC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,kCAAkC,OAAO,SAAS,EAAE;YAC3E,OAAO,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACxD,OAAO;gBACL,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE;gBACxG,MAAM;aACP,CAAC;QACJ,CAAC;QACD,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,EAAE,CAA4B,CAAC;IAC5D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,kBAAmB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QACxD,OAAO;YACL,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE;YACxG,MAAM;SACP,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAI,QAA6F,CAAC,IAAI,CAAC;IACjH,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;IAElC,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,MAAM,aAAa,GAAa,EAAE,CAAC;IAEnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YAChC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,GAAG,EAAE,SAAS;gBACd,OAAO,EAAE,CAAC;gBACV,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,CAAC;aACL,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YACvC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC;gBACd,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,GAAG;gBACX,IAAI,EAAE,EAAE;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,mEAAmE;QACnE,wEAAwE;QACxE,uEAAuE;QACvE,sDAAsD;QACtD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,kCAAkC,OAAO,UAAU,EAAE;YAChF,OAAO,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE;SACpC,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;YAChE,MAAM,GAAG,GAAG,IAAI,CAAC,QAAqE,CAAC;YACvF,IAAI,GAAG,EAAE,QAAQ,EAAE,CAAC;gBAClB,sBAAsB,CAAC,GAAG,CAAC,QAAuB,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,2CAA2C,CAAC,CAAC;IAEvD,OAAO;QACL,MAAM,EAAE;YACN,MAAM;YACN,UAAU;YACV,OAAO;YACP,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,cAAc,EAAE,OAAO;SACxB;QACD,MAAM;KACP,CAAC;AACJ,CAAC;AAgBD;;;;;;GAMG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,SAAS,sBAAsB,CAC7B,KAAkB,EAClB,MAAoB,EACpB,UAA6B,EAC7B,OAAuB,EACvB,KAAK,GAAG,CAAC;IAET,IAAI,KAAK,GAAG,mBAAmB;QAAE,OAAO;IACxC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACxC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC1D,IAAI,QAAQ,EAAE,CAAC;wBACb,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;wBAC1B,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;wBAC1B,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;wBAC1B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;wBACrC,QAAQ,CAAC,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACrE,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAgC,CAAC;YAChD,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;gBACjB,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC9D,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;oBACvC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC;oBAC9C,QAAQ,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;oBACzC,IAAI,CAAC,CAAC,YAAY;wBAAE,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;oBAClE,IAAI,CAAC,CAAC,aAAa;wBAAE,QAAQ,CAAC,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;gBACzE,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,UAAU,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,GAAW,EACX,MAAoB;IAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;IACtD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAEzD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAC3C,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IAE7B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAoB;IACnD,MAAM,KAAK,GAAa;QACtB,mBAAmB;QACnB,EAAE;QACF,wCAAwC,MAAM,CAAC,cAAc,UAAU,MAAM,CAAC,YAAY,EAAE;QAC5F,EAAE;KACH,CAAC;IAEF,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC9D,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CACR,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAC7G,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,4FAA4F,CAAC,CAAC;IACpH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW;IAEX,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;YAC/G,MAAM,EAAE,CAAC,gCAAgC,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;YAC/G,MAAM,EAAE,CAAC,gCAAgC,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjG,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;YACL,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE;YAC/G,MAAM,EAAE,CAAC,0BAA0B,CAAC;SACrC,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACxE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjD,CAAC"}

package/dist/runners/playwright.d.ts

@@ -1,3 +1,11 @@
 import type { RunnerResult } from "./base.js";
-export declare function runPlaywrightTests(cwd: string, logPath: string, jsonReportPath?: string): Promise<RunnerResult>;
+export interface PlaywrightEnvOverrides {
+    viewportWidth?: number;
+    viewportHeight?: number;
+    deviceScaleFactor?: number;
+    isMobile?: boolean;
+    locale?: string;
+    timezone?: string;
+}
+export declare function runPlaywrightTests(cwd: string, logPath: string, jsonReportPath?: string, envOverrides?: PlaywrightEnvOverrides): Promise<RunnerResult>;
 //# sourceMappingURL=playwright.d.ts.map

package/dist/runners/playwright.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/runners/playwright.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,YAAY,CAAC,CAuCvB"}
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../src/runners/playwright.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAI9C,MAAM,WAAW,sBAAsB;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,sBAAsB,GACpC,OAAO,CAAC,YAAY,CAAC,CAmDvB"}

package/dist/runners/playwright.js

@@ -1,8 +1,7 @@
 import { runCommand, checkToolAvailable, makeSkippedResult } from "./base.js";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
-export async function runPlaywrightTests(cwd, logPath, jsonReportPath) {
-    // Check for playwright config
+export async function runPlaywrightTests(cwd, logPath, jsonReportPath, envOverrides) {
     const hasConfig = existsSync(join(cwd, "playwright.config.ts")) ||
         existsSync(join(cwd, "playwright.config.js"));
     if (!hasConfig) {
@@ -12,7 +11,23 @@ export async function runPlaywrightTests(cwd, logPath, jsonReportPath) {
         return makeSkippedResult("playwright", "npx not found on PATH");
     }
     const reportPath = jsonReportPath || join(cwd, "playwright-report.json");
-    const result = await runCommand("npx", ["playwright", "test", "--reporter=json"], cwd, logPath);
+    // CodeLoop normalisation env vars; users can read these in their
+    // playwright.config.ts via `process.env.CODELOOP_VIEWPORT_WIDTH` etc.
+    // to lock viewport, locale, timezone for reproducibility.
+    const extraEnv = {};
+    if (envOverrides?.viewportWidth)
+        extraEnv.CODELOOP_VIEWPORT_WIDTH = String(envOverrides.viewportWidth);
+    if (envOverrides?.viewportHeight)
+        extraEnv.CODELOOP_VIEWPORT_HEIGHT = String(envOverrides.viewportHeight);
+    if (envOverrides?.deviceScaleFactor)
+        extraEnv.CODELOOP_DEVICE_SCALE_FACTOR = String(envOverrides.deviceScaleFactor);
+    if (envOverrides?.isMobile !== undefined)
+        extraEnv.CODELOOP_IS_MOBILE = envOverrides.isMobile ? "1" : "0";
+    if (envOverrides?.locale)
+        extraEnv.CODELOOP_LOCALE = envOverrides.locale;
+    if (envOverrides?.timezone)
+        extraEnv.CODELOOP_TIMEZONE = envOverrides.timezone;
+    const result = await runCommand("npx", ["playwright", "test", "--reporter=json"], cwd, logPath, Object.keys(extraEnv).length > 0 ? extraEnv : undefined);
     const { passed, failed, skipped } = parsePlaywrightOutput(result.stdout, reportPath);
     return {
         runner_name: "playwright",

package/dist/runners/playwright.js.map

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

package/dist/runners/plugin_sdk.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Plugin SDK — defines the runner plugin interface and provides a registry
+ * for custom runners. Third-party frameworks (Django, Rails, etc.) implement
+ * the `CodeLoopRunner` interface and register via `.codeloop/plugins.json`.
+ */
+import type { RunnerResult } from "./base.js";
+export interface CodeLoopRunner {
+    name: string;
+    detect: (cwd: string) => boolean;
+    run: (cwd: string, logPath: string) => Promise<RunnerResult>;
+}
+export interface PluginConfig {
+    name: string;
+    command: string;
+    args?: string[];
+    detect_file?: string;
+    parse_output?: "jest" | "pytest" | "rspec" | "generic" | "exit_code";
+}
+export interface PluginsManifest {
+    plugins: PluginConfig[];
+}
+export declare function loadPluginsManifest(cwd: string): PluginsManifest;
+export declare function createRunnerFromPlugin(plugin: PluginConfig): CodeLoopRunner;
+export declare function loadCustomRunners(cwd: string): CodeLoopRunner[];
+//# sourceMappingURL=plugin_sdk.d.ts.map

package/dist/runners/plugin_sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin_sdk.d.ts","sourceRoot":"","sources":["../../src/runners/plugin_sdk.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAG9C,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACjC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9D;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;CACtE;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAID,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAShE;AA0BD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAmC3E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAK/D"}