poly-weaver 0.2.5

package/dist/flow/custom/load.js

@@ -0,0 +1,117 @@
+import { readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { flowDSL } from "../../dsl.js";
+import { getFlowsDir } from "../../config.js";
+// ─── Built-in flows ─────────────────────────────────────────────────────
+const BUILTIN_SPECIFIERS = [
+    "../built-in/default.js",
+    "../built-in/why-so-serious.js",
+];
+export async function loadBuiltinFlows() {
+    const templates = [];
+    for (const specifier of BUILTIN_SPECIFIERS) {
+        const mod = await import(specifier);
+        const factory = mod.default;
+        if (typeof factory !== "function") {
+            throw new Error(`Built-in flow ${specifier}: default export is not a function`);
+        }
+        const template = factory(flowDSL);
+        templates.push(template);
+    }
+    return templates;
+}
+// ─── Custom flows ───────────────────────────────────────────────────────
+export function validateTemplate(template, file) {
+    const t = template;
+    if (!t || typeof t !== "object") {
+        throw new Error("Factory did not return an object");
+    }
+    if (typeof t.name !== "string" || t.name.length === 0) {
+        throw new Error("Template missing or empty 'name' property");
+    }
+    if (!Array.isArray(t.params)) {
+        throw new Error("Template missing 'params' array");
+    }
+    if (typeof t.build !== "function") {
+        throw new Error("Template missing 'build' function");
+    }
+    return t;
+}
+export async function loadCustomFlows(dir) {
+    const flowsDir = dir ?? getFlowsDir();
+    const templates = [];
+    const errors = [];
+    let entries;
+    try {
+        entries = await readdir(flowsDir);
+    }
+    catch (err) {
+        // Directory doesn't exist — no custom flows
+        if (err.code === "ENOENT") {
+            return { templates, errors };
+        }
+        // Other filesystem errors (permissions, etc.) — report, don't suppress
+        errors.push({
+            file: flowsDir,
+            message: `Cannot read flows directory: ${err instanceof Error ? err.message : String(err)}`,
+        });
+        return { templates, errors };
+    }
+    const files = entries
+        .filter(f => f.endsWith(".mjs") || f.endsWith(".js"))
+        .sort();
+    const seen = new Set();
+    for (const file of files) {
+        const fullPath = join(flowsDir, file);
+        try {
+            const mod = await import(pathToFileURL(fullPath).href);
+            const factory = mod.default ?? mod.createTemplate;
+            if (typeof factory !== "function") {
+                errors.push({ file, message: "No default export or createTemplate function found" });
+                continue;
+            }
+            const raw = factory(flowDSL);
+            const template = validateTemplate(raw, file);
+            if (seen.has(template.name)) {
+                errors.push({ file, message: `Duplicate template name "${template.name}" — skipped` });
+                continue;
+            }
+            seen.add(template.name);
+            templates.push(template);
+        }
+        catch (err) {
+            errors.push({
+                file,
+                message: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    return { templates, errors };
+}
+// ─── Combined loader ────────────────────────────────────────────────────
+/** Load all flows: built-in (from package) + custom (from user dir). */
+export async function loadAllFlows(customDir) {
+    const builtins = await loadBuiltinFlows();
+    const resolvedCustomDir = customDir ?? getFlowsDir();
+    const { templates: customs, errors } = await loadCustomFlows(resolvedCustomDir);
+    // Reject custom names that shadow built-in names
+    const builtinNames = new Set(builtins.map(t => t.name));
+    const validCustoms = customs.filter(t => {
+        if (builtinNames.has(t.name)) {
+            errors.push({
+                file: t.name,
+                message: `Custom flow "${t.name}" shadows a built-in flow — skipped`,
+            });
+            return false;
+        }
+        return true;
+    });
+    return {
+        templates: [...builtins, ...validCustoms],
+        errors,
+        builtinCount: builtins.length,
+        customDir: resolvedCustomDir,
+    };
+}
+//# sourceMappingURL=load.js.map

package/dist/flow/custom/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/flow/custom/load.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAkB9C,2EAA2E;AAE3E,MAAM,kBAAkB,GAAG;IACzB,wBAAwB;IACxB,+BAA+B;CAChC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,kBAAkB,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,iBAAiB,SAAS,oCAAoC,CAAC,CAAC;QAClF,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAiB,CAAC;QAClD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2EAA2E;AAE3E,MAAM,UAAU,gBAAgB,CAAC,QAAiB,EAAE,IAAY;IAC9D,MAAM,CAAC,GAAG,QAAmC,CAAC;IAC9C,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,CAA4B,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAY;IAChD,MAAM,QAAQ,GAAG,GAAG,IAAI,WAAW,EAAE,CAAC;IACtC,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,IAAI,OAAiB,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,4CAA4C;QAC5C,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;QAC/B,CAAC;QACD,uEAAuE;QACvE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC5F,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACpD,IAAI,EAAE,CAAC;IACV,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,cAAc,CAAC;YAClD,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC,CAAC;gBACrF,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;YAC7B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAE7C,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,4BAA4B,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;gBACvF,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACxB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aAC1D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED,2EAA2E;AAE3E,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,SAAkB;IACnD,MAAM,QAAQ,GAAG,MAAM,gBAAgB,EAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC;IACrD,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,iBAAiB,CAAC,CAAC;IAEhF,iDAAiD;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACtC,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,OAAO,EAAE,gBAAgB,CAAC,CAAC,IAAI,qCAAqC;aACrE,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,SAAS,EAAE,CAAC,GAAG,QAAQ,EAAE,GAAG,YAAY,CAAC;QACzC,MAAM;QACN,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,SAAS,EAAE,iBAAiB;KAC7B,CAAC;AACJ,CAAC"}

package/dist/flow/diagram.d.ts

@@ -0,0 +1,37 @@
+import type { FlowDefinition, FlowStep } from "./types.js";
+/**
+ * Compute the minimum visible width needed to render a flow without truncation.
+ * Walks the flow tree recursively. Result is clamped to >= MIN_WIDTH.
+ */
+export declare function computeMinWidth(steps: FlowStep[]): number;
+/**
+ * Compute diagram line count without full rendering.
+ * Width-aware: returns 0 when width < 12. Threads width through
+ * recursive loop nesting — loops whose width would be < 12 are omitted.
+ * Guaranteed: diagramHeight(flow, w) === renderFlowDiagram(flow, w).length
+ */
+export declare function diagramHeight(flow: FlowDefinition, width: number): number;
+/**
+ * Render the flow as an ASCII box-drawing diagram.
+ * Returns ANSI-colored lines, each with exactly `width` visible characters.
+ * Returns empty array if width < 12 (graceful degradation).
+ * Loop blocks whose recursive width falls below 12 are omitted.
+ */
+export declare function renderFlowDiagram(flow: FlowDefinition, width: number): string[];
+/**
+ * Compute minimum visible width for the detailed diagram.
+ * Result is clamped to >= MIN_DETAILED_WIDTH.
+ */
+export declare function computeDetailedMinWidth(steps: FlowStep[]): number;
+/**
+ * Compute detailed diagram line count without full rendering.
+ * Returns 0 when width < MIN_DETAILED_WIDTH.
+ */
+export declare function detailedDiagramHeight(flow: FlowDefinition, width: number): number;
+/**
+ * Render the flow as a detailed ASCII box-drawing diagram.
+ * Each step is rendered as a bordered box with phase label and reads/writes.
+ * Returns ANSI-colored lines, each with exactly `width` visible characters.
+ */
+export declare function renderDetailedFlowDiagram(flow: FlowDefinition, width: number): string[];
+//# sourceMappingURL=diagram.d.ts.map

package/dist/flow/diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.d.ts","sourceRoot":"","sources":["../../src/flow/diagram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAA+C,MAAM,YAAY,CAAC;AAUxG;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGzE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAO/E;AA0PD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAEjE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGjF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAOvF"}