@jterrats/open-orchestra 1.0.13 → 1.0.15

package/dist/context-index-signals.js

@@ -0,0 +1,102 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+export async function compactFileSignals(absolutePath, relativePath) {
+    if (!isTextIndexCandidate(relativePath)) {
+        return {};
+    }
+    const content = await readFile(absolutePath, "utf8").catch(() => "");
+    if (!content) {
+        return {};
+    }
+    const sampled = content.slice(0, 20000);
+    const headings = uniqueLimited(extractHeadings(sampled), 12);
+    const imports = uniqueLimited(extractImports(sampled), 20);
+    const symbols = uniqueLimited(extractSymbols(sampled), 30);
+    const testHints = uniqueLimited(extractTestHints(sampled, relativePath), 12);
+    return {
+        ...(headings ? { headings } : {}),
+        ...(imports ? { imports } : {}),
+        ...(symbols ? { symbols } : {}),
+        ...(testHints ? { testHints } : {}),
+    };
+}
+function isTextIndexCandidate(relativePath) {
+    return [
+        ".cjs",
+        ".css",
+        ".html",
+        ".js",
+        ".json",
+        ".jsx",
+        ".md",
+        ".mdc",
+        ".mjs",
+        ".ts",
+        ".tsx",
+        ".yml",
+        ".yaml",
+    ].includes(path.extname(relativePath).toLowerCase());
+}
+function extractHeadings(content) {
+    const headings = [];
+    for (const rawLine of content.split("\n")) {
+        const heading = parseMarkdownHeading(rawLine);
+        if (heading) {
+            headings.push(heading);
+        }
+    }
+    return headings;
+}
+function parseMarkdownHeading(rawLine) {
+    const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+    let level = 0;
+    while (level < line.length && line[level] === "#") {
+        level += 1;
+    }
+    if (level === 0 || level > 6 || !isWhitespace(line[level])) {
+        return undefined;
+    }
+    const heading = line.slice(level + 1).trim();
+    return heading || undefined;
+}
+function isWhitespace(value) {
+    return value === " " || value === "\t";
+}
+function extractImports(content) {
+    const imports = [];
+    for (const match of content.matchAll(/\bfrom\s+["']([^"']+)["']/g)) {
+        imports.push(match[1]);
+    }
+    for (const match of content.matchAll(/\bimport\s*\(\s*["']([^"']+)["']/g)) {
+        imports.push(match[1]);
+    }
+    return imports;
+}
+function extractSymbols(content) {
+    const symbols = [];
+    const pattern = /\b(?:export\s+)?(?:async\s+)?(?:function|class|interface|type|const|let|var|enum)\s+([A-Za-z_$][\w$]*)/g;
+    for (const match of content.matchAll(pattern)) {
+        symbols.push(match[1]);
+    }
+    return symbols;
+}
+function extractTestHints(content, relativePath) {
+    const hints = [];
+    if (/(^|\/)(test|e2e|specs?|__tests__)(\/|$)/i.test(relativePath)) {
+        hints.push("test-path");
+    }
+    if (/\.(test|spec)\.[cm]?[jt]sx?$/i.test(relativePath)) {
+        hints.push("test-file");
+    }
+    for (const match of content.matchAll(/\b(?:describe|test|it)\s*\(\s*["'`]([^"'`]+)["'`]/g)) {
+        hints.push(match[1]);
+    }
+    return hints;
+}
+function uniqueLimited(values, limit) {
+    const unique = [
+        ...new Set(values.map((value) => value.trim()).filter(Boolean)),
+    ];
+    return unique.length ? unique.slice(0, limit) : undefined;
+}
+//# sourceMappingURL=context-index-signals.js.map

package/dist/context-index-signals.js.map

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

package/dist/context-pack-service.d.ts

@@ -0,0 +1,14 @@
+import type { ContextPackResult } from "./types.js";
+export interface ContextPackOptions {
+    root?: string;
+    query: string;
+    taskId?: string;
+    phase?: string;
+    role?: string;
+    targetChars?: number;
+    hardCapChars?: number;
+    maxFiles?: number;
+    maxSnippets?: number;
+    perSnippetChars?: number;
+}
+export declare function buildContextPack({ root, query, taskId, phase, role, targetChars, hardCapChars, maxFiles, maxSnippets, perSnippetChars, }: ContextPackOptions): Promise<ContextPackResult>;

package/dist/context-pack-service.js

@@ -0,0 +1,153 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { removeUndefined } from "./command-utils.js";
+import { ensureDir, resolveWorkflowPath, resolveWorkspaceWritePath, } from "./fs-utils.js";
+import { searchContextIndex } from "./context-search-service.js";
+import { writeArtifact } from "./workspace.js";
+const DEFAULT_TARGET_CHARS = 30000;
+const DEFAULT_HARD_CAP_CHARS = 40000;
+const DEFAULT_MAX_FILES = 20;
+const DEFAULT_MAX_SNIPPETS = 60;
+const DEFAULT_PER_SNIPPET_CHARS = 1200;
+export async function buildContextPack({ root = process.cwd(), query, taskId, phase, role, targetChars = DEFAULT_TARGET_CHARS, hardCapChars = DEFAULT_HARD_CAP_CHARS, maxFiles = DEFAULT_MAX_FILES, maxSnippets = DEFAULT_MAX_SNIPPETS, perSnippetChars = DEFAULT_PER_SNIPPET_CHARS, }) {
+    const search = await searchContextIndex(removeUndefined({
+        root,
+        query,
+        taskId,
+        phase,
+        role,
+        limit: maxFiles,
+    }));
+    if (search.status !== "ok") {
+        throw new Error(`context pack requires a fresh context index: ${search.reason}`);
+    }
+    const state = {
+        usedChars: 0,
+        snippets: 0,
+        redactions: 0,
+        truncated: false,
+    };
+    const items = [];
+    for (const match of search.results.slice(0, maxFiles)) {
+        if (state.usedChars >= targetChars || state.snippets >= maxSnippets) {
+            state.truncated = true;
+            break;
+        }
+        const item = await buildPackItem(root, match, {
+            query,
+            perSnippetChars,
+            remainingChars: Math.min(hardCapChars, targetChars) - state.usedChars,
+        });
+        state.usedChars += item.item.snippets.reduce((sum, snippet) => sum + snippet.text.length, 0);
+        state.snippets += item.item.snippets.length;
+        state.redactions += item.redactions;
+        items.push(item.item);
+    }
+    const result = removeUndefined({
+        generatedAt: new Date().toISOString(),
+        query,
+        taskId,
+        phase,
+        role,
+        jsonArtifact: "",
+        markdownArtifact: "",
+        budget: {
+            targetChars,
+            hardCapChars,
+            usedChars: state.usedChars,
+            maxFiles,
+            maxSnippets,
+            perSnippetChars,
+            truncated: state.truncated || state.usedChars >= targetChars,
+        },
+        items,
+        redactions: state.redactions,
+        omitted: search.omitted,
+    });
+    await ensureDir(resolveWorkflowPath(root, "context-packs"));
+    const baseName = contextPackFileName(taskId ?? "advisory", query);
+    const jsonArtifact = await writeArtifact(root, "context-packs", `${baseName}.json`, `${JSON.stringify({ ...result, jsonArtifact: undefined, markdownArtifact: undefined }, null, 2)}\n`);
+    const markdownArtifact = await writeArtifact(root, "context-packs", `${baseName}.md`, renderContextPackMarkdown({
+        ...result,
+        jsonArtifact,
+        markdownArtifact: "",
+    }));
+    return { ...result, jsonArtifact, markdownArtifact };
+}
+function renderContextPackMarkdown(pack) {
+    return [
+        `# Context Pack: ${pack.query}`,
+        "",
+        `- Task: ${pack.taskId ?? "none"}`,
+        `- Role: ${pack.role ?? "none"}`,
+        `- Phase: ${pack.phase ?? "none"}`,
+        `- Budget: ${pack.budget.usedChars}/${pack.budget.targetChars} chars`,
+        `- Redactions: ${pack.redactions}`,
+        "",
+        ...pack.items.flatMap((item) => [
+            `## ${item.path}`,
+            "",
+            `Inclusion: ${item.inclusionReason}`,
+            "",
+            ...item.snippets.flatMap((snippet) => [
+                `Lines ${snippet.startLine}-${snippet.endLine}${snippet.truncated ? " (truncated)" : ""}`,
+                "",
+                "```",
+                snippet.text,
+                "```",
+                "",
+            ]),
+        ]),
+    ].join("\n");
+}
+async function buildPackItem(root, match, options) {
+    const absolutePath = resolveWorkspaceWritePath(root, match.path);
+    const content = await readFile(absolutePath, "utf8");
+    const redacted = redactSecrets(content);
+    const snippets = selectSnippets(redacted.text, options);
+    return {
+        item: {
+            path: match.path,
+            inclusionReason: match.reasons.join("; ") || "ranked search match",
+            score: match.score,
+            snippets,
+        },
+        redactions: redacted.count,
+    };
+}
+function selectSnippets(content, options) {
+    const lines = content.split(/\r?\n/);
+    const tokens = normalize(options.query).split(" ").filter(Boolean);
+    const index = lines.findIndex((line) => tokens.some((token) => normalize(line).includes(token)));
+    const center = index >= 0 ? index : 0;
+    const start = Math.max(0, center - 6);
+    const end = Math.min(lines.length, center + 7);
+    let text = lines.slice(start, end).join("\n").trim();
+    const maxChars = Math.max(0, Math.min(options.perSnippetChars, options.remainingChars));
+    const truncated = text.length > maxChars;
+    text = text.slice(0, maxChars);
+    return text ? [{ startLine: start + 1, endLine: end, text, truncated }] : [];
+}
+function redactSecrets(content) {
+    let count = 0;
+    const text = content.replace(/\b(?:api[_-]?key|token|secret|password)\b\s*[:=]\s*["']?[^"'\s]+/gi, (match) => {
+        count += 1;
+        const key = match.split(/[:=]/)[0]?.trim() ?? "secret";
+        return `${key}=<redacted>`;
+    });
+    return { text, count };
+}
+function contextPackFileName(taskId, query) {
+    const slug = normalize(`${taskId}-${query}`)
+        .replaceAll(" ", "-")
+        .slice(0, 80);
+    return `${slug || "context-pack"}-${Date.now()}`;
+}
+function normalize(value) {
+    return path
+        .basename(value, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=context-pack-service.js.map

package/dist/context-pack-service.js.map

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

package/dist/context-search-service.d.ts

@@ -0,0 +1,10 @@
+import type { ContextIndexSearchResult } from "./types.js";
+export interface ContextIndexSearchOptions {
+    root?: string;
+    query: string;
+    taskId?: string;
+    phase?: string;
+    role?: string;
+    limit?: number;
+}
+export declare function searchContextIndex({ root, query, taskId, phase, role, limit, }: ContextIndexSearchOptions): Promise<ContextIndexSearchResult>;

package/dist/context-search-service.js

@@ -0,0 +1,142 @@
+import path from "node:path";
+import { getContextIndexStatus, readIndexedFiles, } from "./context-index-service.js";
+import { removeUndefined } from "./command-utils.js";
+import { listTasks } from "./workflow-task-service.js";
+const DEFAULT_LIMIT = 10;
+export async function searchContextIndex({ root = process.cwd(), query, taskId, phase, role, limit = DEFAULT_LIMIT, }) {
+    const status = await getContextIndexStatus(root);
+    const base = {
+        generatedAt: new Date().toISOString(),
+        query,
+        ...(taskId ? { taskId } : {}),
+        ...(phase ? { phase } : {}),
+        ...(role ? { role } : {}),
+        limit,
+    };
+    if (!status.exists) {
+        return {
+            ...base,
+            status: "missing",
+            reason: status.reason,
+            results: [],
+            omitted: [],
+        };
+    }
+    if (status.stale) {
+        return {
+            ...base,
+            status: "stale",
+            reason: status.reason,
+            results: [],
+            omitted: [],
+        };
+    }
+    const task = taskId ? await findTask(root, taskId) : undefined;
+    const tokens = tokenize(query);
+    const matches = (await readIndexedFiles(root))
+        .map((file) => scoreFile(removeUndefined({
+        file,
+        tokens,
+        task,
+        phase,
+        role,
+    })))
+        .filter((match) => match.score > 0)
+        .sort(compareMatches);
+    return {
+        ...base,
+        status: "ok",
+        reason: "context index search completed",
+        results: matches.slice(0, limit),
+        omitted: matches.slice(limit).map((match) => ({
+            ...match,
+            omissionReasons: ["below result limit"],
+        })),
+    };
+}
+function scoreFile({ file, tokens, task, phase, role, }) {
+    const matchedSignals = [];
+    const reasons = [];
+    let score = 0;
+    for (const token of tokens) {
+        score += scoreText(file.path, token, 25, "path", matchedSignals, reasons);
+        score += scoreText(path.basename(file.path), token, 40, "basename", matchedSignals, reasons);
+        score += scoreList(file.headings, token, 18, "heading", matchedSignals, reasons);
+        score += scoreList(file.imports, token, 12, "import", matchedSignals, reasons);
+        score += scoreList(file.symbols, token, 22, "symbol", matchedSignals, reasons);
+        score += scoreList(file.testHints, token, 15, "test", matchedSignals, reasons);
+    }
+    score += taskPathBoost(file, task, reasons);
+    score += phaseRoleBoost(file, phase, role, reasons);
+    return {
+        path: file.path,
+        score,
+        matchedSignals: [...new Set(matchedSignals)],
+        reasons: [...new Set(reasons)],
+        omissionReasons: [],
+    };
+}
+function scoreText(value, token, points, label, matchedSignals, reasons) {
+    if (!normalize(value).includes(token))
+        return 0;
+    matchedSignals.push(`${label}:${value}`);
+    reasons.push(`${label} matched query`);
+    return points;
+}
+function scoreList(values, token, points, label, matchedSignals, reasons) {
+    return (values ?? []).reduce((sum, value) => sum + scoreText(value, token, points, label, matchedSignals, reasons), 0);
+}
+function taskPathBoost(file, task, reasons) {
+    if (!task?.paths?.some((taskPath) => pathOverlaps(file.path, taskPath))) {
+        return 0;
+    }
+    reasons.push("task ownership path boost");
+    return 35;
+}
+function phaseRoleBoost(file, phase, role, reasons) {
+    const normalized = normalize([phase, role, file.path, file.testHints?.join(" ")].join(" "));
+    if (/(qa|test)/.test(normalized) && isTestLike(file)) {
+        reasons.push("qa/test phase boost");
+        return 20;
+    }
+    if (/(architect|architecture)/.test(normalized) &&
+        /(^|\/)(docs|src)\//.test(file.path)) {
+        reasons.push("architecture phase boost");
+        return 10;
+    }
+    if (/(developer|dev)/.test(normalized) &&
+        /(^|\/)(src|test)\//.test(file.path)) {
+        reasons.push("developer phase boost");
+        return 10;
+    }
+    return 0;
+}
+function compareMatches(left, right) {
+    return right.score - left.score || left.path.localeCompare(right.path);
+}
+function pathOverlaps(filePath, taskPath) {
+    const normalized = taskPath.replaceAll("\\", "/").replace(/\*\*?\/?/g, "");
+    return Boolean(normalized && filePath.includes(normalized));
+}
+function isTestLike(file) {
+    return (Boolean(file.testHints?.length) ||
+        /(^|\/)(test|e2e|specs?|__tests__)(\/|$)/i.test(file.path) ||
+        /\.(test|spec)\.[cm]?[jt]sx?$/i.test(file.path));
+}
+async function findTask(root, taskId) {
+    return (await listTasks(root)).find((task) => task.id === taskId);
+}
+function tokenize(query) {
+    return [
+        ...new Set(normalize(query)
+            .split(" ")
+            .filter((token) => token.length > 1)),
+    ];
+}
+function normalize(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, " ")
+        .trim();
+}
+//# sourceMappingURL=context-search-service.js.map

package/dist/context-search-service.js.map

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

package/dist/diagrams/geometry.d.ts

@@ -0,0 +1,12 @@
+import type { DiagramPoint, DiagramRect } from "./model.js";
+export declare function rectRight(rect: DiagramRect): number;
+export declare function rectBottom(rect: DiagramRect): number;
+export declare function rectCenter(rect: DiagramRect): DiagramPoint;
+export declare function rectContainsRect(outer: DiagramRect, inner: DiagramRect): boolean;
+export declare function rectsOverlap(first: DiagramRect, second: DiagramRect): boolean;
+export declare function pointDistance(first: DiagramPoint, second: DiagramPoint): number;
+export declare function segmentIntersectsRect(start: DiagramPoint, end: DiagramPoint, rect: DiagramRect): boolean;
+export declare function polylineSegments(points: DiagramPoint[]): Array<{
+    start: DiagramPoint;
+    end: DiagramPoint;
+}>;

package/dist/diagrams/geometry.js

@@ -0,0 +1,69 @@
+export function rectRight(rect) {
+    return rect.x + rect.width;
+}
+export function rectBottom(rect) {
+    return rect.y + rect.height;
+}
+export function rectCenter(rect) {
+    return {
+        x: rect.x + rect.width / 2,
+        y: rect.y + rect.height / 2,
+    };
+}
+export function rectContainsRect(outer, inner) {
+    return (inner.x >= outer.x &&
+        inner.y >= outer.y &&
+        rectRight(inner) <= rectRight(outer) &&
+        rectBottom(inner) <= rectBottom(outer));
+}
+export function rectsOverlap(first, second) {
+    return !(rectRight(first) <= second.x ||
+        rectRight(second) <= first.x ||
+        rectBottom(first) <= second.y ||
+        rectBottom(second) <= first.y);
+}
+export function pointDistance(first, second) {
+    return Math.hypot(first.x - second.x, first.y - second.y);
+}
+export function segmentIntersectsRect(start, end, rect) {
+    if (pointInsideRect(start, rect) || pointInsideRect(end, rect)) {
+        return true;
+    }
+    const corners = [
+        { x: rect.x, y: rect.y },
+        { x: rectRight(rect), y: rect.y },
+        { x: rectRight(rect), y: rectBottom(rect) },
+        { x: rect.x, y: rectBottom(rect) },
+    ];
+    return corners.some((corner, index) => {
+        const nextCorner = corners[(index + 1) % corners.length];
+        return nextCorner
+            ? segmentsIntersect(start, end, corner, nextCorner)
+            : false;
+    });
+}
+export function polylineSegments(points) {
+    return points.slice(1).map((point, index) => ({
+        start: points[index] ?? point,
+        end: point,
+    }));
+}
+function pointInsideRect(point, rect) {
+    return (point.x >= rect.x &&
+        point.x <= rectRight(rect) &&
+        point.y >= rect.y &&
+        point.y <= rectBottom(rect));
+}
+function segmentsIntersect(firstStart, firstEnd, secondStart, secondEnd) {
+    const d1 = direction(secondStart, secondEnd, firstStart);
+    const d2 = direction(secondStart, secondEnd, firstEnd);
+    const d3 = direction(firstStart, firstEnd, secondStart);
+    const d4 = direction(firstStart, firstEnd, secondEnd);
+    return (((d1 > 0 && d2 < 0) || (d1 < 0 && d2 > 0)) &&
+        ((d3 > 0 && d4 < 0) || (d3 < 0 && d4 > 0)));
+}
+function direction(first, second, target) {
+    return ((target.x - first.x) * (second.y - first.y) -
+        (second.x - first.x) * (target.y - first.y));
+}
+//# sourceMappingURL=geometry.js.map

package/dist/diagrams/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../../src/diagrams/geometry.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS,CAAC,IAAiB;IACzC,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;QAC1B,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAkB,EAClB,KAAkB;IAElB,OAAO,CACL,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;QAClB,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;QAClB,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC;QACpC,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,CACvC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAkB,EAAE,MAAmB;IAClE,OAAO,CAAC,CACN,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC;QAC5B,SAAS,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC;QAC5B,UAAU,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC;QAC7B,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,KAAmB,EACnB,MAAoB;IAEpB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,KAAmB,EACnB,GAAiB,EACjB,IAAiB;IAEjB,IAAI,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG;QACd,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE;QACxB,EAAE,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE;QACjC,EAAE,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;QAC3C,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;KACnC,CAAC;IACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QACpC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,UAAU;YACf,CAAC,CAAC,iBAAiB,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC;YACnD,CAAC,CAAC,KAAK,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IAIrD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5C,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK;QAC7B,GAAG,EAAE,KAAK;KACX,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,eAAe,CAAC,KAAmB,EAAE,IAAiB;IAC7D,OAAO,CACL,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QACjB,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC;QAC1B,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;QACjB,KAAK,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CACxB,UAAwB,EACxB,QAAsB,EACtB,WAAyB,EACzB,SAAuB;IAEvB,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACtD,OAAO,CACL,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,KAAmB,EACnB,MAAoB,EACpB,MAAoB;IAEpB,OAAO,CACL,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAC5C,CAAC;AACJ,CAAC"}

package/dist/diagrams/iconify.d.ts

@@ -0,0 +1,22 @@
+export interface IconifySymbol {
+    id: string;
+    body: string;
+    width: number;
+    height: number;
+}
+export interface IconifyIconCache {
+    get(iconifyId: string): IconifySymbol | undefined;
+}
+export interface MutableIconifyIconCache extends IconifyIconCache {
+    set(symbol: IconifySymbol): void;
+}
+export declare class MemoryIconifyIconCache implements MutableIconifyIconCache {
+    #private;
+    constructor(symbols?: IconifySymbol[]);
+    get(iconifyId: string): IconifySymbol | undefined;
+    set(symbol: IconifySymbol): void;
+}
+export declare function resolveIconifySymbol({ iconifyId, cache, }: {
+    iconifyId: string;
+    cache: IconifyIconCache;
+}): IconifySymbol;

package/dist/diagrams/iconify.js

@@ -0,0 +1,42 @@
+export class MemoryIconifyIconCache {
+    #symbols = new Map();
+    constructor(symbols = defaultIconifySymbols) {
+        for (const symbol of symbols) {
+            this.set(symbol);
+        }
+    }
+    get(iconifyId) {
+        return this.#symbols.get(iconifyId);
+    }
+    set(symbol) {
+        this.#symbols.set(symbol.id, symbol);
+    }
+}
+export function resolveIconifySymbol({ iconifyId, cache, }) {
+    const symbol = cache.get(iconifyId);
+    if (!symbol) {
+        throw new Error(`Iconify icon is not cached: ${iconifyId}`);
+    }
+    return symbol;
+}
+const defaultIconifySymbols = [
+    {
+        id: "mdi:account",
+        width: 24,
+        height: 24,
+        body: '<path d="M12 12a4 4 0 1 0 0-8 4 4 0 0 0 0 8Zm0 2c-3.3 0-6 1.7-6 3.8V20h12v-2.2c0-2.1-2.7-3.8-6-3.8Z"/>',
+    },
+    {
+        id: "mdi:server",
+        width: 24,
+        height: 24,
+        body: '<path d="M4 3h16v8H4V3Zm2 2v4h12V5H6Zm-2 8h16v8H4v-8Zm2 2v4h12v-4H6Z"/>',
+    },
+    {
+        id: "mdi:database",
+        width: 24,
+        height: 24,
+        body: '<path d="M12 3c4.4 0 8 1.3 8 3v12c0 1.7-3.6 3-8 3s-8-1.3-8-3V6c0-1.7 3.6-3 8-3Zm0 2C8.1 5 6 6 6 6s2.1 1 6 1 6-1 6-1-2.1-1-6-1Zm6 4.3c-1.5.7-3.7 1.1-6 1.1s-4.5-.4-6-1.1V12c0 .1 2.1 1.1 6 1.1s6-1 6-1.1V9.3Zm0 6c-1.5.7-3.7 1.1-6 1.1s-4.5-.4-6-1.1V18c0 .1 2.1 1 6 1s6-.9 6-1v-2.7Z"/>',
+    },
+];
+//# sourceMappingURL=iconify.js.map

package/dist/diagrams/iconify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconify.js","sourceRoot":"","sources":["../../src/diagrams/iconify.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,sBAAsB;IACxB,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAErD,YAAY,UAA2B,qBAAqB;QAC1D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,MAAqB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,EACnC,SAAS,EACT,KAAK,GAIN;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,+BAA+B,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,qBAAqB,GAAoB;IAC7C;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,wGAAwG;KAC/G;IACD;QACE,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,yEAAyE;KAChF;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,IAAI,EAAE,yRAAyR;KAChS;CACF,CAAC"}

package/dist/diagrams/index.d.ts

@@ -0,0 +1,6 @@
+export { MemoryIconifyIconCache, resolveIconifySymbol, type IconifyIconCache, type IconifySymbol, type MutableIconifyIconCache, } from "./iconify.js";
+export { layoutDiagram } from "./layout.js";
+export { generateDeterministicDiagram, runDeterministicDiagramPipeline, } from "./pipeline.js";
+export { renderDiagramSvg } from "./render-svg.js";
+export { validateDiagramArtifact } from "./validate.js";
+export type { DiagramArtifact, DiagramConnector, DiagramConnectorKind, DiagramConnectorLayout, DiagramDirection, DiagramGroup, DiagramGroupLayout, DiagramIconRef, DiagramLayout, DiagramModel, DiagramNode, DiagramNodeKind, DiagramNodeLayout, DiagramPoint, DiagramPipelineIteration, DiagramPipelineRun, DiagramPipelineRunOptions, DiagramRect, DiagramSeverity, DiagramText, DiagramValidationFinding, } from "./model.js";

package/dist/diagrams/index.js

@@ -0,0 +1,6 @@
+export { MemoryIconifyIconCache, resolveIconifySymbol, } from "./iconify.js";
+export { layoutDiagram } from "./layout.js";
+export { generateDeterministicDiagram, runDeterministicDiagramPipeline, } from "./pipeline.js";
+export { renderDiagramSvg } from "./render-svg.js";
+export { validateDiagramArtifact } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/diagrams/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/diagrams/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAIrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/diagrams/layout.d.ts

@@ -0,0 +1,2 @@
+import type { DiagramLayout, DiagramModel } from "./model.js";
+export declare function layoutDiagram(model: DiagramModel): DiagramLayout;