@keel_flow/extend 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jglasskatz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# @keel_flow/extend
+
+LLM-driven architecture extension: given an existing architecture map and a follow-up prompt, emits a typed `ArchitectureDelta` via `emit_delta` tool_use, applies it with `applyDelta`, and opens a GitHub PR with the updated `architecture/data.ts` via `openExtendPR`.
+
+Part of the [Keel](https://github.com/jglasskatz/keel) framework.
+
+## Install
+
+```
+npm install @keel_flow/extend
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { KnowledgeBase } from "@keel_flow/core";
+import type { ArchitectureDelta, ArchitectureMap } from "@keel_flow/schema";
+import type { ModelProvider } from "@keel_flow/runtime";
+export type { ArchitectureDelta };
+export { openExtendPR, openPr } from "./pr.js";
+export type { OpenExtendPRArgs, OpenExtendPRResult, OpenPrArgs, OpenPrResult } from "./pr.js";
+export interface ExtendResult {
+    delta: ArchitectureDelta;
+    rationale: string;
+}
+export declare function extend({ prompt, architecture, kb, provider, }: {
+    prompt: string;
+    architecture: ArchitectureMap;
+    kb: KnowledgeBase;
+    provider: ModelProvider;
+}): Promise<ExtendResult>;
+export declare function applyDelta(map: ArchitectureMap, delta: ArchitectureDelta): ArchitectureMap;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9F,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAmFD,wBAAsB,MAAM,CAAC,EAC3B,MAAM,EACN,YAAY,EACZ,EAAE,EACF,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,eAAe,CAAC;IAC9B,EAAE,EAAE,aAAa,CAAC;IAClB,QAAQ,EAAE,aAAa,CAAC;CACzB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuDxB;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,GAAG,eAAe,CA0B1F"}

package/dist/index.js

@@ -0,0 +1,152 @@
+import { ArchitectureDeltaSchema, ArchitectureMapSchema } from "@keel_flow/schema";
+export { openExtendPR, openPr } from "./pr.js";
+const extendToolSchema = {
+    name: "emit_delta",
+    description: "Emit only the additions and updates to the existing architecture map — not a full new map",
+    inputSchema: {
+        type: "object",
+        properties: {
+            addNodes: {
+                type: "array",
+                description: "New nodes to add to the architecture",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        label: { type: "string" },
+                        layer: { type: "string" },
+                        tech: { type: "string" },
+                        description: { type: "string" },
+                        keyFiles: { type: "array", items: { type: "string" } },
+                        keyFunctionality: { type: "array", items: { type: "string" } },
+                        principles: {
+                            type: "object",
+                            properties: {
+                                upholds: { type: "array", items: { type: "object" } },
+                                violates: { type: "array", items: { type: "object" } },
+                            },
+                            required: ["upholds", "violates"],
+                        },
+                    },
+                    required: ["id", "label", "layer", "tech", "description", "keyFiles", "keyFunctionality", "principles"],
+                },
+            },
+            addConnections: {
+                type: "array",
+                description: "New connections to add between existing or new nodes",
+                items: {
+                    type: "object",
+                    properties: {
+                        from: { type: "string" },
+                        to: { type: "string" },
+                        type: { type: "string" },
+                        label: { type: "string" },
+                    },
+                    required: ["from", "to", "type"],
+                },
+            },
+            addContexts: {
+                type: "array",
+                description: "New bounded contexts to add (optional)",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        label: { type: "string" },
+                        description: { type: "string" },
+                        nodeIds: { type: "array", items: { type: "string" } },
+                    },
+                    required: ["id", "label", "description", "nodeIds"],
+                },
+            },
+            updateNodes: {
+                type: "array",
+                description: "Partial updates to existing nodes (optional)",
+                items: {
+                    type: "object",
+                    properties: {
+                        id: { type: "string" },
+                        changes: { type: "object" },
+                    },
+                    required: ["id", "changes"],
+                },
+            },
+            rationale: {
+                type: "string",
+                description: "Why this delta was chosen",
+            },
+        },
+        required: ["addNodes", "addConnections", "rationale"],
+    },
+};
+export async function extend({ prompt, architecture, kb, provider, }) {
+    const chunks = await kb.retrieve(prompt, 10);
+    const kbContext = chunks.length > 0
+        ? chunks.map((c, i) => `[${i + 1}] (source: ${c.source})\n${c.content}`).join("\n\n")
+        : "No KB documents available.";
+    const archJson = JSON.stringify(architecture, null, 2).slice(0, 4096);
+    const systemPrompt = `You are an expert software architect extending an existing Keel architecture map.
+
+You will receive:
+1. The current architecture map (compact JSON, up to 4KB)
+2. A user prompt describing the change to make
+3. KB context chunks relevant to the prompt
+
+Your task: emit ONLY a delta — additions and/or updates to the existing map. Do NOT emit a full new map.
+Use the emit_delta tool to return:
+- addNodes: new nodes not yet in the map
+- addConnections: new connections between existing or new nodes
+- addContexts: optional new bounded contexts
+- updateNodes: optional partial updates to existing nodes
+- rationale: why this delta makes sense architecturally
+
+Existing node IDs in the map: ${architecture.nodes.map((n) => n.id).join(", ")}`;
+    const userMessage = `User prompt: ${prompt}
+
+Current architecture map:
+${archJson}
+
+KB context (top-10 chunks):
+${kbContext}
+
+Extend the architecture by emitting a delta using the emit_delta tool.`;
+    const response = await provider.generate({
+        model: provider.defaultModel,
+        system: systemPrompt,
+        messages: [{ role: "user", content: [{ type: "text", text: userMessage }] }],
+        tools: [extendToolSchema],
+        toolChoice: "any",
+        maxTokens: 4096,
+    });
+    const toolUse = response.content.find((b) => b.type === "tool_use");
+    if (!toolUse || toolUse.type !== "tool_use") {
+        throw new Error("Model did not return a delta");
+    }
+    const { rationale, ...deltaInput } = toolUse.input;
+    const delta = ArchitectureDeltaSchema.parse(deltaInput);
+    return { delta, rationale: String(rationale ?? "") };
+}
+export function applyDelta(map, delta) {
+    const nodeMap = new Map(map.nodes.map((n) => [n.id, { ...n }]));
+    for (const node of delta.addNodes) {
+        nodeMap.set(node.id, node);
+    }
+    if (delta.updateNodes) {
+        for (const { id, changes } of delta.updateNodes) {
+            const existing = nodeMap.get(id);
+            if (existing) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- merging Partial<ArchitectureNode> onto a full node; ArchitectureMapSchema.parse below validates the result
+                nodeMap.set(id, { ...existing, ...changes });
+            }
+        }
+    }
+    const validatedMap = ArchitectureMapSchema.parse({
+        schemaVersion: map.schemaVersion,
+        layers: map.layers,
+        nodes: Array.from(nodeMap.values()),
+        connections: [...map.connections, ...delta.addConnections],
+        contexts: [...map.contexts, ...(delta.addContexts ?? [])],
+    });
+    return validatedMap;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pr.d.ts

@@ -0,0 +1,37 @@
+import type { ArchitectureDelta } from "./index.js";
+export interface OpenPrArgs {
+    branch: string;
+    title: string;
+    body: string;
+    repo: {
+        owner: string;
+        name: string;
+    };
+    baseBranch?: string;
+    token: string;
+    merge?: boolean;
+}
+export interface OpenPrResult {
+    url: string;
+    number: number;
+    merged: boolean;
+}
+export declare function openPr({ branch, title, body, repo, baseBranch, token, merge, }: OpenPrArgs): Promise<OpenPrResult>;
+export interface OpenExtendPRArgs {
+    delta: ArchitectureDelta;
+    updatedArchitectureSource: string;
+    repo: {
+        owner: string;
+        name: string;
+    };
+    baseBranch?: string;
+    token: string;
+    promptSummary: string;
+}
+export interface OpenExtendPRResult {
+    url: string;
+    number: number;
+    branch: string;
+}
+export declare function openExtendPR({ delta, updatedArchitectureSource, repo, baseBranch, token, promptSummary, }: OpenExtendPRArgs): Promise<OpenExtendPRResult>;
+//# sourceMappingURL=pr.d.ts.map

package/dist/pr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../src/pr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,MAAM,CAAC,EAC3B,MAAM,EACN,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,UAAmB,EACnB,KAAK,EACL,KAAa,GACd,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAgCpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,iBAAiB,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAoCD,wBAAsB,YAAY,CAAC,EACjC,KAAK,EACL,yBAAyB,EACzB,IAAI,EACJ,UAAmB,EACnB,KAAK,EACL,aAAa,GACd,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+DhD"}

package/dist/pr.js

@@ -0,0 +1,111 @@
+import { Octokit } from "@octokit/rest";
+export async function openPr({ branch, title, body, repo, baseBranch = "main", token, merge = false, }) {
+    if (!token) {
+        throw new Error("GitHub token is required to open a PR");
+    }
+    if (!repo.owner || !repo.name) {
+        throw new Error("repo.owner and repo.name are required");
+    }
+    const octokit = new Octokit({ auth: token });
+    const { data: pr } = await octokit.pulls.create({
+        owner: repo.owner,
+        repo: repo.name,
+        title,
+        head: branch,
+        base: baseBranch,
+        body,
+    });
+    if (merge) {
+        await octokit.pulls.merge({
+            owner: repo.owner,
+            repo: repo.name,
+            pull_number: pr.number,
+            // Merge commit, not squash: CLAUDE.md mandates "merge to main with a
+            // merge commit — the conventional commits are the history; do not squash".
+            merge_method: "merge",
+        });
+        return { url: pr.html_url, number: pr.number, merged: true };
+    }
+    return { url: pr.html_url, number: pr.number, merged: false };
+}
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 40);
+}
+function buildPRBody(delta, rationale) {
+    const addedNodes = delta.addNodes
+        .map((n) => `- **${n.id}** (${n.layer}): ${n.label}`)
+        .join("\n");
+    const addedConnections = delta.addConnections
+        .map((c) => `- ${c.from} → ${c.to} (${c.type}${c.label ? `: ${c.label}` : ""})`)
+        .join("\n");
+    const updatedNodes = delta.updateNodes && delta.updateNodes.length > 0
+        ? delta.updateNodes.map((u) => `- **${u.id}**: ${Object.keys(u.changes).join(", ")}`).join("\n")
+        : null;
+    const sections = [
+        `## Rationale\n\n${rationale}`,
+        `## Delta`,
+        delta.addNodes.length > 0 ? `### Added nodes\n\n${addedNodes}` : null,
+        delta.addConnections.length > 0 ? `### Added connections\n\n${addedConnections}` : null,
+        updatedNodes ? `### Updated nodes\n\n${updatedNodes}` : null,
+        `---\n_Generated by Keel via \`/adopt/extend\`. Verify gate will run on this PR._`,
+    ].filter(Boolean);
+    return sections.join("\n\n");
+}
+export async function openExtendPR({ delta, updatedArchitectureSource, repo, baseBranch = "main", token, promptSummary, }) {
+    if (!token) {
+        throw new Error("GitHub token is required to open a PR");
+    }
+    if (!repo.owner || !repo.name) {
+        throw new Error("repo.owner and repo.name are required");
+    }
+    const octokit = new Octokit({ auth: token });
+    const timestamp = Date.now();
+    const slug = slugify(promptSummary);
+    const branch = `keel/extend-${timestamp}-${slug}`;
+    const { data: baseRef } = await octokit.git.getRef({
+        owner: repo.owner,
+        repo: repo.name,
+        ref: `heads/${baseBranch}`,
+    });
+    const baseSha = baseRef.object.sha;
+    await octokit.git.createRef({
+        owner: repo.owner,
+        repo: repo.name,
+        ref: `refs/heads/${branch}`,
+        sha: baseSha,
+    });
+    const { data: currentFile } = await octokit.repos.getContent({
+        owner: repo.owner,
+        repo: repo.name,
+        path: "architecture/data.ts",
+        ref: baseBranch,
+    }).catch(() => ({ data: null }));
+    const fileSha = currentFile && !Array.isArray(currentFile) && "sha" in currentFile
+        ? currentFile.sha
+        : undefined;
+    await octokit.repos.createOrUpdateFileContents({
+        owner: repo.owner,
+        repo: repo.name,
+        path: "architecture/data.ts",
+        message: `feat(architecture): ${promptSummary.slice(0, 72)}`,
+        content: Buffer.from(updatedArchitectureSource, "utf8").toString("base64"),
+        branch,
+        ...(fileSha !== undefined ? { sha: fileSha } : {}),
+    });
+    const title = `feat(architecture): ${promptSummary.slice(0, 72)}`;
+    const body = buildPRBody(delta, "Architecture extension via Keel /adopt/extend flow");
+    const { data: pr } = await octokit.pulls.create({
+        owner: repo.owner,
+        repo: repo.name,
+        title,
+        head: branch,
+        base: baseBranch,
+        body,
+    });
+    return { url: pr.html_url, number: pr.number, branch };
+}
+//# sourceMappingURL=pr.js.map

package/dist/pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr.js","sourceRoot":"","sources":["../src/pr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAmBxC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,EAC3B,MAAM,EACN,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,UAAU,GAAG,MAAM,EACnB,KAAK,EACL,KAAK,GAAG,KAAK,GACF;IACX,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE7C,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAC9C,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,UAAU;QAChB,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;YACxB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,EAAE,CAAC,MAAM;YACtB,qEAAqE;YACrE,2EAA2E;YAC3E,YAAY,EAAE,OAAO;SACtB,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAChE,CAAC;AAiBD,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,KAAwB,EAAE,SAAiB;IAC9D,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,KAAK,EAAE,CAAC;SACpD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,gBAAgB,GAAG,KAAK,CAAC,cAAc;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;SAC/E,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,YAAY,GAChB,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAC/C,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAChG,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,QAAQ,GAAG;QACf,mBAAmB,SAAS,EAAE;QAC9B,UAAU;QACV,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI;QACrE,KAAK,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,4BAA4B,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI;QACvF,YAAY,CAAC,CAAC,CAAC,wBAAwB,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI;QAC5D,kFAAkF;KACnF,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,EACjC,KAAK,EACL,yBAAyB,EACzB,IAAI,EACJ,UAAU,GAAG,MAAM,EACnB,KAAK,EACL,aAAa,GACI;IACjB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,eAAe,SAAS,IAAI,IAAI,EAAE,CAAC;IAElD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;QACjD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,SAAS,UAAU,EAAE;KAC3B,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;IAEnC,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;QAC1B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,cAAc,MAAM,EAAE;QAC3B,GAAG,EAAE,OAAO;KACb,CAAC,CAAC;IAEH,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QAC3D,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,sBAAsB;QAC5B,GAAG,EAAE,UAAU;KAChB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAEjC,MAAM,OAAO,GACX,WAAW,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,KAAK,IAAI,WAAW;QAChE,CAAC,CAAC,WAAW,CAAC,GAAG;QACjB,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC;QAC7C,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,uBAAuB,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QAC5D,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC1E,MAAM;QACN,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACnD,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,uBAAuB,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAElE,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,oDAAoD,CAAC,CAAC;IAEtF,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAC9C,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK;QACL,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,UAAU;QAChB,IAAI;KACL,CAAC,CAAC;IAEH,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;AACzD,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@keel_flow/extend",
+  "version": "0.2.0",
+  "private": false,
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@octokit/rest": "^21.0.0",
+    "zod": "^3.23.0",
+    "@keel_flow/core": "0.2.0",
+    "@keel_flow/runtime": "0.2.0",
+    "@keel_flow/schema": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}