codeloop-mcp-server 0.1.14 → 0.1.16

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":"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"}

package/dist/runners/generic.js

@@ -38,28 +38,31 @@ function stripAnsi(str) {
     // eslint-disable-next-line no-control-regex
     return str.replace(/\x1B\[[0-9;]*[A-Za-z]/g, "");
 }
+function sumMatches(output, pattern) {
+    let total = 0;
+    for (const match of output.matchAll(pattern)) {
+        total += parseInt(match[1], 10);
+    }
+    return total;
+}
 function parseTestOutput(output) {
-    let passed = 0;
-    let failed = 0;
-    let skipped = 0;
     const clean = stripAnsi(output);
-    // Vitest/Jest format: "Tests  12 passed (12)" — strip ANSI first
-    const vitestMatch = clean.match(/Tests\s+(\d+)\s+passed/);
-    if (vitestMatch)
-        passed = parseInt(vitestMatch[1], 10);
-    const vitestFail = clean.match(/Tests\s+(\d+)\s+failed/);
-    if (vitestFail)
-        failed = parseInt(vitestFail[1], 10);
-    // Mocha/tap format: "X passing" / "X failing"
-    const mochaPass = clean.match(/(\d+)\s+passing/);
-    if (mochaPass && !vitestMatch)
-        passed = parseInt(mochaPass[1], 10);
-    const mochaFail = clean.match(/(\d+)\s+failing/);
-    if (mochaFail && !vitestFail)
-        failed = parseInt(mochaFail[1], 10);
-    const skipMatch = clean.match(/(\d+)\s+(?:skipped|pending)/);
-    if (skipMatch)
-        skipped = parseInt(skipMatch[1], 10);
+    // Vitest/Jest format: "Tests  12 passed (12)" — sum across all packages so
+    // monorepo runs (turbo, nx, lerna) report the full coverage instead of just
+    // the first runner that flushed to stdout. The narrow "Tests  N passed"
+    // anchor avoids accidentally matching a script's preview text.
+    const vitestPassed = sumMatches(clean, /Tests\s+(\d+)\s+passed/g);
+    const vitestFailed = sumMatches(clean, /Tests\s+(\d+)\s+failed/g);
+    // Mocha/tap format: "X passing" / "X failing". We deliberately match only
+    // the first occurrence to avoid double-counting npm's command-echo line.
+    const mochaPassMatch = clean.match(/(\d+)\s+passing/);
+    const mochaFailMatch = clean.match(/(\d+)\s+failing/);
+    const mochaPassed = mochaPassMatch ? parseInt(mochaPassMatch[1], 10) : 0;
+    const mochaFailed = mochaFailMatch ? parseInt(mochaFailMatch[1], 10) : 0;
+    const passed = vitestPassed > 0 ? vitestPassed : mochaPassed;
+    const failed = vitestFailed > 0 ? vitestFailed : mochaFailed;
+    const skippedMatch = clean.match(/(\d+)\s+(?:skipped|pending)/);
+    const skipped = skippedMatch ? parseInt(skippedMatch[1], 10) : 0;
     if (passed === 0 && failed === 0) {
         return { passed: 0, failed: 0, skipped: 0 };
     }

package/dist/runners/generic.js.map

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

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"}

package/dist/runners/plugin_sdk.js

@@ -0,0 +1,86 @@
+/**
+ * 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 { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { runCommand } from "./base.js";
+const PLUGINS_FILE = ".codeloop/plugins.json";
+export function loadPluginsManifest(cwd) {
+    const p = join(cwd, PLUGINS_FILE);
+    if (!existsSync(p))
+        return { plugins: [] };
+    try {
+        const raw = JSON.parse(readFileSync(p, "utf-8"));
+        return Array.isArray(raw.plugins) ? raw : { plugins: [] };
+    }
+    catch {
+        return { plugins: [] };
+    }
+}
+function parseGenericOutput(stdout) {
+    let passed = 0;
+    let failed = 0;
+    const skipped = 0;
+    const jestMatch = stdout.match(/Tests:\s*(\d+)\s*passed/);
+    if (jestMatch)
+        passed = parseInt(jestMatch[1]);
+    const jestFail = stdout.match(/Tests:\s*(\d+)\s*failed/);
+    if (jestFail)
+        failed = parseInt(jestFail[1]);
+    const pytestMatch = stdout.match(/(\d+)\s*passed/);
+    if (pytestMatch)
+        passed = parseInt(pytestMatch[1]);
+    const pytestFail = stdout.match(/(\d+)\s*failed/);
+    if (pytestFail)
+        failed = parseInt(pytestFail[1]);
+    const rspecMatch = stdout.match(/(\d+)\s*examples?,\s*(\d+)\s*failures?/);
+    if (rspecMatch) {
+        passed = parseInt(rspecMatch[1]) - parseInt(rspecMatch[2]);
+        failed = parseInt(rspecMatch[2]);
+    }
+    return { passed, failed, skipped };
+}
+export function createRunnerFromPlugin(plugin) {
+    return {
+        name: plugin.name,
+        detect: (cwd) => {
+            if (!plugin.detect_file)
+                return true;
+            return existsSync(join(cwd, plugin.detect_file));
+        },
+        run: async (cwd, logPath) => {
+            const start = Date.now();
+            const args = plugin.args ?? [];
+            const result = await runCommand(plugin.command, args, cwd, logPath);
+            const parseMode = plugin.parse_output ?? "generic";
+            let parsed = { passed: 0, failed: 0, skipped: 0 };
+            if (parseMode === "exit_code") {
+                parsed = { passed: result.exit_code === 0 ? 1 : 0, failed: result.exit_code === 0 ? 0 : 1, skipped: 0 };
+            }
+            else {
+                parsed = parseGenericOutput(result.stdout + "\n" + result.stderr);
+            }
+            return {
+                runner_name: plugin.name,
+                available: true,
+                exit_code: result.exit_code,
+                passed: parsed.passed,
+                failed: parsed.failed,
+                skipped: parsed.skipped,
+                log_path: logPath,
+                duration_ms: result.duration_ms,
+                stdout: result.stdout,
+                stderr: result.stderr,
+            };
+        },
+    };
+}
+export function loadCustomRunners(cwd) {
+    const manifest = loadPluginsManifest(cwd);
+    return manifest.plugins
+        .map(createRunnerFromPlugin)
+        .filter((runner) => runner.detect(cwd));
+}
+//# sourceMappingURL=plugin_sdk.js.map

package/dist/runners/plugin_sdk.js.map

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

package/dist/state/dependency_graph.d.ts

@@ -0,0 +1,23 @@
+import type { SectionStateRecord } from "@codelooptech/shared";
+export interface DependencyGraphNode {
+    id: string;
+    dependsOn: string[];
+    dependedOnBy: string[];
+}
+export interface DependencyGraph {
+    nodes: Map<string, DependencyGraphNode>;
+    /** Topological order of section ids — predecessors first. Empty if the graph contains a cycle. */
+    topoOrder: string[];
+    /** True iff a cycle was detected during sort. */
+    hasCycle: boolean;
+    /** When `hasCycle` is true, this contains the ids of one cycle for diagnostics. */
+    cycle: string[];
+    /** Section ids referenced as dependencies but not present in the input set. */
+    unknownDependencies: string[];
+}
+export declare function buildDependencyGraph(sections: readonly SectionStateRecord[]): DependencyGraph;
+/**
+ * Returns the maximum dependency depth (longest path) for diagnostics in the dashboard.
+ */
+export declare function longestPathLength(graph: DependencyGraph): number;
+//# sourceMappingURL=dependency_graph.d.ts.map

package/dist/state/dependency_graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency_graph.d.ts","sourceRoot":"","sources":["../../src/state/dependency_graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACxC,kGAAkG;IAClG,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,mFAAmF;IACnF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,+EAA+E;IAC/E,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,eAAe,CA2B7F;AA+ED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAqBhE"}