@db-lyon/flowkit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Lyon
+
+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/dist/config/deep-merge.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Deep-merges two values:
+ *
+ * - Objects: recursive key-by-key merge (override wins per-key)
+ * - Arrays: replace by default; `__merge: 'append'` on the override array concatenates
+ * - Scalars: override wins
+ * - `null` override: explicitly nullifies
+ * - `undefined` override: no-op (base preserved)
+ */
+export declare function deepMerge(base: unknown, override: unknown): unknown;
+//# sourceMappingURL=deep-merge.d.ts.map

package/dist/config/deep-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.d.ts","sourceRoot":"","sources":["../../src/config/deep-merge.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CA2BnE"}

package/dist/config/deep-merge.js

@@ -0,0 +1,39 @@
+/**
+ * Deep-merges two values:
+ *
+ * - Objects: recursive key-by-key merge (override wins per-key)
+ * - Arrays: replace by default; `__merge: 'append'` on the override array concatenates
+ * - Scalars: override wins
+ * - `null` override: explicitly nullifies
+ * - `undefined` override: no-op (base preserved)
+ */
+export function deepMerge(base, override) {
+    if (override === undefined)
+        return base;
+    if (override === null)
+        return null;
+    if (Array.isArray(override)) {
+        if (Array.isArray(base)) {
+            const annotation = override.__merge;
+            if (annotation === 'append') {
+                const cleaned = override.filter((item) => typeof item !== 'object' || !item.__merge);
+                return [...base, ...cleaned];
+            }
+        }
+        return override;
+    }
+    if (isPlainObject(base) && isPlainObject(override)) {
+        const result = { ...base };
+        for (const key of Object.keys(override)) {
+            if (key === '__merge')
+                continue;
+            result[key] = deepMerge(result[key], override[key]);
+        }
+        return result;
+    }
+    return override;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=deep-merge.js.map

package/dist/config/deep-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../../src/config/deep-merge.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,QAAiB;IACxD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAEnC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,UAAU,GAAI,QAAsC,CAAC,OAAO,CAAC;YACnE,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAE,IAAuB,CAAC,OAAO,CACxE,CAAC;gBACF,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnD,MAAM,MAAM,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;QACpD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS;YAChC,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,EAAG,QAAoC,CAAC,GAAG,CAAC,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,6 @@
+export { deepMerge } from './deep-merge.js';
+export { TaskOptionsSchema, TaskDefinitionSchema, FlowStepSchema, FlowDefinitionSchema, EngineConfigSchema, } from './schema.js';
+export type { TaskOptions, TaskDefinition, FlowStep, FlowDefinition, EngineConfig, } from './schema.js';
+export { loadConfig, loadRawYaml, findConfigFile } from './loader.js';
+export type { LoadConfigOptions, LoadedConfig } from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,4 @@
+export { deepMerge } from './deep-merge.js';
+export { TaskOptionsSchema, TaskDefinitionSchema, FlowStepSchema, FlowDefinitionSchema, EngineConfigSchema, } from './schema.js';
+export { loadConfig, loadRawYaml, findConfigFile } from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAUrB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/loader.d.ts

@@ -0,0 +1,33 @@
+import type { z } from 'zod';
+/**
+ * Walk up parent directories looking for `filename`.
+ */
+export declare function findConfigFile(filename: string, startDir?: string): string;
+export declare function loadRawYaml(filePath: string): unknown;
+export interface LoadConfigOptions<T extends z.ZodType> {
+    /** Primary config filename, e.g. `'myapp.yml'` */
+    filename: string;
+    /** Zod schema — applied after all layers are merged */
+    schema: T;
+    /** Builtin defaults merged under the project file */
+    defaults?: unknown;
+    /** Environment name — loads `{base}.{env}.{ext}` overlay */
+    env?: string;
+    /** Env var to read environment name from when `env` is not passed */
+    envVar?: string;
+    /** Directory to search for config files (default: cwd) */
+    configDir?: string;
+}
+export interface LoadedConfig<T> {
+    config: T;
+    configDir: string;
+}
+/**
+ * Layered config loader:
+ *
+ *     defaults  →  {filename}  →  {base}.{env}.{ext}  →  {base}.local.{ext}
+ *
+ * Each layer is deep-merged left-to-right, then validated through the Zod schema.
+ */
+export declare function loadConfig<T extends z.ZodType>(options: LoadConfigOptions<T>): LoadedConfig<z.infer<T>>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAW1E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;IACpD,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,MAAM,EAAE,CAAC,CAAC;IACV,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,MAAM,EAAE,CAAC,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC5C,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAiC1B"}

package/dist/config/loader.js

@@ -0,0 +1,58 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as yaml from 'js-yaml';
+import { deepMerge } from './deep-merge.js';
+/**
+ * Walk up parent directories looking for `filename`.
+ */
+export function findConfigFile(filename, startDir) {
+    let dir = startDir ?? process.cwd();
+    const root = path.parse(dir).root;
+    while (dir !== root) {
+        const candidate = path.join(dir, filename);
+        if (fs.existsSync(candidate))
+            return candidate;
+        dir = path.dirname(dir);
+    }
+    throw new Error(`Could not find ${filename} in any parent directory`);
+}
+export function loadRawYaml(filePath) {
+    const content = fs.readFileSync(filePath, 'utf8');
+    return yaml.load(content);
+}
+/**
+ * Layered config loader:
+ *
+ *     defaults  →  {filename}  →  {base}.{env}.{ext}  →  {base}.local.{ext}
+ *
+ * Each layer is deep-merged left-to-right, then validated through the Zod schema.
+ */
+export function loadConfig(options) {
+    const configDir = options.configDir ?? process.cwd();
+    const ext = path.extname(options.filename);
+    const base = path.basename(options.filename, ext);
+    const rootPath = path.join(configDir, options.filename);
+    if (!fs.existsSync(rootPath)) {
+        throw new Error(`Configuration file not found: ${rootPath}`);
+    }
+    // Layer 1: builtin defaults
+    let config = options.defaults ?? {};
+    // Layer 2: project file
+    const projectConfig = loadRawYaml(rootPath);
+    config = deepMerge(config, projectConfig);
+    // Layer 3: environment overlay
+    const env = options.env ?? (options.envVar ? process.env[options.envVar] : undefined);
+    if (env) {
+        const envPath = path.join(configDir, `${base}.${env}${ext}`);
+        if (fs.existsSync(envPath)) {
+            config = deepMerge(config, loadRawYaml(envPath));
+        }
+    }
+    // Layer 4: local overrides (never committed)
+    const localPath = path.join(configDir, `${base}.local${ext}`);
+    if (fs.existsSync(localPath)) {
+        config = deepMerge(config, loadRawYaml(localPath));
+    }
+    return { config: options.schema.parse(config), configDir };
+}
+//# sourceMappingURL=loader.js.map

package/dist/config/loader.js.map

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

package/dist/config/schema.d.ts

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+export declare const TaskOptionsSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+export declare const TaskDefinitionSchema: z.ZodObject<{
+    class_path: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    group: z.ZodOptional<z.ZodString>;
+    options: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    options: Record<string, unknown>;
+    class_path: string;
+    description?: string | undefined;
+    group?: string | undefined;
+}, {
+    class_path: string;
+    options?: Record<string, unknown> | undefined;
+    description?: string | undefined;
+    group?: string | undefined;
+}>;
+export declare const FlowStepSchema: z.ZodEffects<z.ZodObject<{
+    task: z.ZodOptional<z.ZodString>;
+    flow: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    options?: Record<string, unknown> | undefined;
+    task?: string | undefined;
+    flow?: string | undefined;
+}, {
+    options?: Record<string, unknown> | undefined;
+    task?: string | undefined;
+    flow?: string | undefined;
+}>, {
+    options?: Record<string, unknown> | undefined;
+    task?: string | undefined;
+    flow?: string | undefined;
+}, {
+    options?: Record<string, unknown> | undefined;
+    task?: string | undefined;
+    flow?: string | undefined;
+}>;
+export declare const FlowDefinitionSchema: z.ZodObject<{
+    description: z.ZodString;
+    steps: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+        task: z.ZodOptional<z.ZodString>;
+        flow: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strip", z.ZodTypeAny, {
+        options?: Record<string, unknown> | undefined;
+        task?: string | undefined;
+        flow?: string | undefined;
+    }, {
+        options?: Record<string, unknown> | undefined;
+        task?: string | undefined;
+        flow?: string | undefined;
+    }>, {
+        options?: Record<string, unknown> | undefined;
+        task?: string | undefined;
+        flow?: string | undefined;
+    }, {
+        options?: Record<string, unknown> | undefined;
+        task?: string | undefined;
+        flow?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    steps: Record<string, {
+        options?: Record<string, unknown> | undefined;
+        task?: string | undefined;
+        flow?: string | undefined;
+    }>;
+}, {
+    description: string;
+    steps: Record<string, {
+        options?: Record<string, unknown> | undefined;
+        task?: string | undefined;
+        flow?: string | undefined;
+    }>;
+}>;
+/** Minimal config shape the engine requires. Consumers extend with their own sections. */
+export declare const EngineConfigSchema: z.ZodObject<{
+    tasks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        class_path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
+        options: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, "strip", z.ZodTypeAny, {
+        options: Record<string, unknown>;
+        class_path: string;
+        description?: string | undefined;
+        group?: string | undefined;
+    }, {
+        class_path: string;
+        options?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        group?: string | undefined;
+    }>>>;
+    flows: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        steps: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            task: z.ZodOptional<z.ZodString>;
+            flow: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }>, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }>;
+    }, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }>;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    tasks: Record<string, {
+        options: Record<string, unknown>;
+        class_path: string;
+        description?: string | undefined;
+        group?: string | undefined;
+    }>;
+    flows: Record<string, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }>;
+    }>;
+}, {
+    tasks?: Record<string, {
+        class_path: string;
+        options?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        group?: string | undefined;
+    }> | undefined;
+    flows?: Record<string, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+        }>;
+    }> | undefined;
+}>;
+export type TaskOptions = z.infer<typeof TaskOptionsSchema>;
+export type TaskDefinition = z.infer<typeof TaskDefinitionSchema>;
+export type FlowStep = z.infer<typeof FlowStepSchema>;
+export type FlowDefinition = z.infer<typeof FlowDefinitionSchema>;
+export type EngineConfig = z.infer<typeof EngineConfigSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,iBAAiB,wCAAwB,CAAC;AAEvD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAK/B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;EAYxB,CAAC;AAEJ,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG/B,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG7B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export const TaskOptionsSchema = z.record(z.unknown());
+export const TaskDefinitionSchema = z.object({
+    class_path: z.string().min(1),
+    description: z.string().optional(),
+    group: z.string().optional(),
+    options: TaskOptionsSchema.optional().default({}),
+});
+export const FlowStepSchema = z
+    .object({
+    task: z.string().optional(),
+    flow: z.string().optional(),
+    options: TaskOptionsSchema.optional(),
+})
+    .refine((data) => {
+    if (data.task === 'None')
+        return true;
+    return (data.task && !data.flow) || (!data.task && data.flow);
+}, { message: 'Step must have exactly one of task or flow (or task: None to skip)' });
+export const FlowDefinitionSchema = z.object({
+    description: z.string(),
+    steps: z.record(z.coerce.string(), FlowStepSchema),
+});
+/** Minimal config shape the engine requires. Consumers extend with their own sections. */
+export const EngineConfigSchema = z.object({
+    tasks: z.record(TaskDefinitionSchema).default({}),
+    flows: z.record(FlowDefinitionSchema).default({}),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;AAEvD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAClD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,iBAAiB,CAAC,QAAQ,EAAE;CACtC,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE;IACP,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC,EACD,EAAE,OAAO,EAAE,oEAAoE,EAAE,CAClF,CAAC;AAEJ,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC;CACnD,CAAC,CAAC;AAEH,0FAA0F;AAC1F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAClD,CAAC,CAAC"}

package/dist/dag/index.d.ts

@@ -0,0 +1,3 @@
+export { topologicalSort, CircularDependencyError, MissingDependencyError, } from './resolver.js';
+export type { DagNode } from './resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/dag/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC"}

package/dist/dag/index.js

@@ -0,0 +1,2 @@
+export { topologicalSort, CircularDependencyError, MissingDependencyError, } from './resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/dag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,eAAe,CAAC"}

package/dist/dag/resolver.d.ts

@@ -0,0 +1,17 @@
+export interface DagNode<T = unknown> {
+    id: string;
+    dependencies: string[];
+    data: T;
+}
+export declare class CircularDependencyError extends Error {
+    readonly cycle: string[];
+    constructor(cycle: string[]);
+}
+export declare class MissingDependencyError extends Error {
+    readonly nodeId: string;
+    readonly missingDep: string;
+    constructor(nodeId: string, missingDep: string);
+}
+/** Topological sort — returns nodes in dependency order (dependencies first). */
+export declare function topologicalSort<T>(nodes: DagNode<T>[]): DagNode<T>[];
+//# sourceMappingURL=resolver.d.ts.map

package/dist/dag/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/dag/resolver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,qBAAa,uBAAwB,SAAQ,KAAK;aACpB,KAAK,EAAE,MAAM,EAAE;gBAAf,KAAK,EAAE,MAAM,EAAE;CAI5C;AAED,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,MAAM,EAAE,MAAM;aACd,UAAU,EAAE,MAAM;gBADlB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM;CAKrC;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CA4CpE"}

package/dist/dag/resolver.js

@@ -0,0 +1,57 @@
+export class CircularDependencyError extends Error {
+    cycle;
+    constructor(cycle) {
+        super(`Circular dependency detected: ${cycle.join(' -> ')}`);
+        this.cycle = cycle;
+        this.name = 'CircularDependencyError';
+    }
+}
+export class MissingDependencyError extends Error {
+    nodeId;
+    missingDep;
+    constructor(nodeId, missingDep) {
+        super(`Node "${nodeId}" depends on "${missingDep}" which does not exist`);
+        this.nodeId = nodeId;
+        this.missingDep = missingDep;
+        this.name = 'MissingDependencyError';
+    }
+}
+/** Topological sort — returns nodes in dependency order (dependencies first). */
+export function topologicalSort(nodes) {
+    const nodeMap = new Map();
+    for (const node of nodes) {
+        nodeMap.set(node.id, node);
+    }
+    for (const node of nodes) {
+        for (const dep of node.dependencies) {
+            if (!nodeMap.has(dep)) {
+                throw new MissingDependencyError(node.id, dep);
+            }
+        }
+    }
+    const visited = new Set();
+    const visiting = new Set();
+    const sorted = [];
+    function visit(nodeId, path) {
+        if (visited.has(nodeId))
+            return;
+        if (visiting.has(nodeId)) {
+            const cycleStart = path.indexOf(nodeId);
+            throw new CircularDependencyError([...path.slice(cycleStart), nodeId]);
+        }
+        visiting.add(nodeId);
+        path.push(nodeId);
+        const node = nodeMap.get(nodeId);
+        for (const dep of node.dependencies) {
+            visit(dep, [...path]);
+        }
+        visiting.delete(nodeId);
+        visited.add(nodeId);
+        sorted.push(node);
+    }
+    for (const node of nodes) {
+        visit(node.id, []);
+    }
+    return sorted;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/dag/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/dag/resolver.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACpB;IAA5B,YAA4B,KAAe;QACzC,KAAK,CAAC,iCAAiC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QADnC,UAAK,GAAL,KAAK,CAAU;QAEzC,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAE7B;IACA;IAFlB,YACkB,MAAc,EACd,UAAkB;QAElC,KAAK,CAAC,SAAS,MAAM,iBAAiB,UAAU,wBAAwB,CAAC,CAAC;QAH1D,WAAM,GAAN,MAAM,CAAQ;QACd,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAI,KAAmB;IACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,SAAS,KAAK,CAAC,MAAc,EAAE,IAAc;QAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO;QAEhC,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,IAAI,uBAAuB,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAElB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACpC,KAAK,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACxB,CAAC;QAED,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/flow/index.d.ts

@@ -0,0 +1,3 @@
+export { FlowRunner } from './runner.js';
+export type { FlowRunOptions, FlowStepResult, FlowRunResult, FlowRunnerHooks, FlowRunnerConfig, PlanStep, } from './runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/flow/index.js

@@ -0,0 +1,2 @@
+export { FlowRunner } from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/flow/runner.d.ts

@@ -0,0 +1,68 @@
+import type { Logger } from '../logger.js';
+import type { TaskDefinition, FlowDefinition } from '../config/schema.js';
+import type { TaskResult } from '../task/base-task.js';
+import type { TaskContext } from '../task/base-task.js';
+import type { TaskRegistry } from '../task/registry.js';
+export interface FlowRunOptions {
+    flowName: string;
+    skip?: string[];
+    plan?: boolean;
+}
+export interface FlowStepResult {
+    stepNumber: number;
+    type: 'task' | 'flow';
+    name: string;
+    result?: TaskResult;
+    skipped: boolean;
+    duration: number;
+}
+export interface FlowRunResult {
+    success: boolean;
+    steps: FlowStepResult[];
+    duration: number;
+    error?: Error;
+}
+export interface PlanStep {
+    stepNumber: number;
+    type: 'task' | 'flow';
+    name: string;
+    skipped: boolean;
+    options?: Record<string, unknown>;
+}
+export interface FlowRunnerHooks {
+    /** Fires once before the top-level flow starts (not for nested flows). */
+    beforeRun?(flowName: string, plan: PlanStep[]): Promise<void>;
+    /** Fires once after the top-level flow completes (success or failure). */
+    afterRun?(result: FlowRunResult): Promise<void>;
+    /** Fires before every step (including steps inside nested flows). */
+    beforeStep?(step: PlanStep): Promise<void>;
+    /** Fires after every step. */
+    afterStep?(step: PlanStep, result: FlowStepResult): Promise<void>;
+    /** Fires when a step fails — before afterRun. */
+    onStepError?(step: PlanStep, error: Error, completed: FlowStepResult[]): Promise<void>;
+}
+export interface FlowRunnerConfig {
+    tasks: Record<string, TaskDefinition>;
+    flows: Record<string, FlowDefinition>;
+    registry: TaskRegistry;
+    context: TaskContext;
+    hooks?: FlowRunnerHooks;
+    logger?: Logger;
+}
+export declare class FlowRunner {
+    private logger;
+    private tasks;
+    private flows;
+    private registry;
+    private ctx;
+    private hooks;
+    private runDepth;
+    constructor(config: FlowRunnerConfig);
+    run(options: FlowRunOptions): Promise<FlowRunResult>;
+    /** Flatten a flow definition into an ordered execution plan. */
+    resolveExecutionPlan(flow: FlowDefinition, skipSet: Set<string>): PlanStep[];
+    private executeFlow;
+    private executeTaskStep;
+    private resolveTaskDefinition;
+}
+//# sourceMappingURL=runner.d.ts.map

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

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

package/dist/flow/runner.js

@@ -0,0 +1,184 @@
+import { noopLogger } from '../logger.js';
+// ---------------------------------------------------------------------------
+// FlowRunner
+// ---------------------------------------------------------------------------
+export class FlowRunner {
+    logger;
+    tasks;
+    flows;
+    registry;
+    ctx;
+    hooks;
+    runDepth = 0;
+    constructor(config) {
+        this.logger = (config.logger ?? noopLogger).child({ component: 'flow-runner' });
+        this.tasks = config.tasks;
+        this.flows = config.flows;
+        this.registry = config.registry;
+        this.ctx = config.context;
+        this.hooks = config.hooks ?? {};
+    }
+    async run(options) {
+        this.runDepth++;
+        const isTopLevel = this.runDepth === 1;
+        try {
+            return await this.executeFlow(options, isTopLevel);
+        }
+        finally {
+            this.runDepth--;
+        }
+    }
+    /** Flatten a flow definition into an ordered execution plan. */
+    resolveExecutionPlan(flow, skipSet) {
+        const sortedKeys = Object.keys(flow.steps)
+            .map(Number)
+            .sort((a, b) => a - b);
+        return sortedKeys.map((key) => {
+            const step = flow.steps[String(key)];
+            if (step.task === 'None') {
+                return { stepNumber: key, type: 'task', name: 'None', skipped: true };
+            }
+            const name = (step.task ?? step.flow);
+            const type = step.task ? 'task' : 'flow';
+            return {
+                stepNumber: key,
+                type,
+                name,
+                skipped: skipSet.has(name) || skipSet.has(String(key)),
+                options: step.options,
+            };
+        });
+    }
+    // ---------------------------------------------------------------------------
+    // Internal
+    // ---------------------------------------------------------------------------
+    async executeFlow(options, isTopLevel) {
+        const startTime = Date.now();
+        const skipSet = new Set(options.skip ?? []);
+        const completedSteps = [];
+        const flow = this.flows[options.flowName];
+        if (!flow) {
+            throw new Error(`Flow "${options.flowName}" not found in configuration`);
+        }
+        const executionPlan = this.resolveExecutionPlan(flow, skipSet);
+        // Plan mode — return the plan without executing anything
+        if (options.plan) {
+            return {
+                success: true,
+                steps: executionPlan.map((s) => ({
+                    stepNumber: s.stepNumber,
+                    type: s.type,
+                    name: s.name,
+                    skipped: s.skipped,
+                    duration: 0,
+                })),
+                duration: 0,
+            };
+        }
+        if (isTopLevel) {
+            await this.hooks.beforeRun?.(options.flowName, executionPlan);
+        }
+        let flowError;
+        for (const planStep of executionPlan) {
+            // ---- Skipped steps ----
+            if (planStep.skipped) {
+                const sr = {
+                    stepNumber: planStep.stepNumber,
+                    type: planStep.type,
+                    name: planStep.name,
+                    skipped: true,
+                    duration: 0,
+                };
+                completedSteps.push(sr);
+                await this.hooks.afterStep?.(planStep, sr);
+                continue;
+            }
+            // ---- Active steps ----
+            await this.hooks.beforeStep?.(planStep);
+            const stepStart = Date.now();
+            try {
+                let stepResult;
+                if (planStep.type === 'task') {
+                    const taskResult = await this.executeTaskStep(planStep);
+                    stepResult = {
+                        stepNumber: planStep.stepNumber,
+                        type: 'task',
+                        name: planStep.name,
+                        result: taskResult,
+                        skipped: false,
+                        duration: Date.now() - stepStart,
+                    };
+                }
+                else {
+                    const nestedResult = await this.run({
+                        ...options,
+                        flowName: planStep.name,
+                        plan: false,
+                    });
+                    stepResult = {
+                        stepNumber: planStep.stepNumber,
+                        type: 'flow',
+                        name: planStep.name,
+                        result: {
+                            success: nestedResult.success,
+                            data: { stepCount: nestedResult.steps.length },
+                        },
+                        skipped: false,
+                        duration: Date.now() - stepStart,
+                    };
+                    if (!nestedResult.success) {
+                        flowError = nestedResult.error ?? new Error(`Nested flow ${planStep.name} failed`);
+                    }
+                }
+                completedSteps.push(stepResult);
+                await this.hooks.afterStep?.(planStep, stepResult);
+                if (!stepResult.result?.success) {
+                    flowError =
+                        flowError ?? stepResult.result?.error ?? new Error(`Step ${planStep.name} failed`);
+                    await this.hooks.onStepError?.(planStep, flowError, completedSteps);
+                    break;
+                }
+            }
+            catch (error) {
+                const err = error instanceof Error ? error : new Error(String(error));
+                completedSteps.push({
+                    stepNumber: planStep.stepNumber,
+                    type: planStep.type,
+                    name: planStep.name,
+                    skipped: false,
+                    duration: Date.now() - stepStart,
+                    result: { success: false, error: err },
+                });
+                flowError = err;
+                await this.hooks.onStepError?.(planStep, err, completedSteps);
+                break;
+            }
+        }
+        const result = {
+            success: !flowError,
+            steps: completedSteps,
+            duration: Date.now() - startTime,
+            error: flowError,
+        };
+        if (isTopLevel) {
+            await this.hooks.afterRun?.(result);
+        }
+        return result;
+    }
+    async executeTaskStep(step) {
+        const taskDef = this.resolveTaskDefinition(step.name);
+        const mergedOptions = { ...taskDef.options, ...step.options };
+        this.logger.info({ step: step.stepNumber, task: step.name, type: step.type }, `Executing step ${step.stepNumber}: ${step.name}`);
+        const task = await this.registry.create(taskDef.class_path, this.ctx, mergedOptions);
+        return task.run();
+    }
+    resolveTaskDefinition(taskName) {
+        const taskDef = this.tasks[taskName];
+        if (taskDef) {
+            return { class_path: taskDef.class_path, options: taskDef.options ?? {} };
+        }
+        // Allow using a class_path directly as the task reference
+        return { class_path: taskName, options: {} };
+    }
+}
+//# sourceMappingURL=runner.js.map

package/dist/flow/runner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export { deepMerge } from './config/deep-merge.js';
+export { TaskOptionsSchema, TaskDefinitionSchema, FlowStepSchema, FlowDefinitionSchema, EngineConfigSchema, } from './config/schema.js';
+export type { TaskOptions, TaskDefinition, FlowStep, FlowDefinition, EngineConfig, } from './config/schema.js';
+export { loadConfig, loadRawYaml, findConfigFile } from './config/loader.js';
+export type { LoadConfigOptions, LoadedConfig } from './config/loader.js';
+export { BaseTask } from './task/base-task.js';
+export type { TaskContext, TaskResult } from './task/base-task.js';
+export { TaskRegistry } from './task/registry.js';
+export type { TaskConstructor } from './task/registry.js';
+export { FlowRunner } from './flow/runner.js';
+export type { FlowRunOptions, FlowStepResult, FlowRunResult, FlowRunnerHooks, FlowRunnerConfig, PlanStep, } from './flow/runner.js';
+export { topologicalSort, CircularDependencyError, MissingDependencyError, } from './dag/resolver.js';
+export type { DagNode } from './dag/resolver.js';
+export type { Logger } from './logger.js';
+export { noopLogger } from './logger.js';
+//# 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":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,cAAc,EACd,QAAQ,EACR,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Config
+export { deepMerge } from './config/deep-merge.js';
+export { TaskOptionsSchema, TaskDefinitionSchema, FlowStepSchema, FlowDefinitionSchema, EngineConfigSchema, } from './config/schema.js';
+export { loadConfig, loadRawYaml, findConfigFile } from './config/loader.js';
+// Task
+export { BaseTask } from './task/base-task.js';
+export { TaskRegistry } from './task/registry.js';
+// Flow
+export { FlowRunner } from './flow/runner.js';
+// DAG
+export { topologicalSort, CircularDependencyError, MissingDependencyError, } from './dag/resolver.js';
+export { noopLogger } from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO;AACP,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO;AACP,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAU9C,MAAM;AACN,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,9 @@
+export interface Logger {
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+export declare const noopLogger: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAClD;AAED,eAAO,MAAM,UAAU,EAAE,MAQxB,CAAC"}

package/dist/logger.js

@@ -0,0 +1,10 @@
+export const noopLogger = {
+    debug() { },
+    info() { },
+    warn() { },
+    error() { },
+    child() {
+        return noopLogger;
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,UAAU,GAAW;IAChC,KAAK,KAAI,CAAC;IACV,IAAI,KAAI,CAAC;IACT,IAAI,KAAI,CAAC;IACT,KAAK,KAAI,CAAC;IACV,KAAK;QACH,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAC"}

package/dist/task/base-task.d.ts

@@ -0,0 +1,27 @@
+import type { Logger } from '../logger.js';
+export interface TaskContext {
+    logger?: Logger;
+    [key: string]: unknown;
+}
+export interface TaskResult {
+    success: boolean;
+    data?: Record<string, unknown>;
+    error?: Error;
+    duration?: number;
+}
+export declare abstract class BaseTask<TOpts = Record<string, unknown>> {
+    protected ctx: TaskContext;
+    protected options: TOpts;
+    protected logger: Logger;
+    constructor(ctx: TaskContext, options: TOpts);
+    abstract get taskName(): string;
+    abstract execute(): Promise<TaskResult>;
+    /** Override for option validation — called before execute(). */
+    protected validate(): void;
+    /**
+     * Lifecycle wrapper: validate → execute → return result.
+     * Catches exceptions and returns `{ success: false }` instead of throwing.
+     */
+    run(): Promise<TaskResult>;
+}
+//# sourceMappingURL=base-task.d.ts.map

package/dist/task/base-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-task.d.ts","sourceRoot":"","sources":["../../src/task/base-task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,8BAAsB,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI1D,SAAS,CAAC,GAAG,EAAE,WAAW;IAC1B,SAAS,CAAC,OAAO,EAAE,KAAK;IAJ1B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAGb,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,KAAK;IAM1B,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC;IAEhC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC;IAEvC,gEAAgE;IAChE,SAAS,CAAC,QAAQ,IAAI,IAAI;IAE1B;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;CA2BjC"}

package/dist/task/base-task.js

@@ -0,0 +1,39 @@
+import { noopLogger } from '../logger.js';
+export class BaseTask {
+    ctx;
+    options;
+    logger;
+    constructor(ctx, options) {
+        this.ctx = ctx;
+        this.options = options;
+        const parentLogger = ctx.logger ?? noopLogger;
+        this.logger = parentLogger.child({ task: this.constructor.name });
+    }
+    /** Override for option validation — called before execute(). */
+    validate() { }
+    /**
+     * Lifecycle wrapper: validate → execute → return result.
+     * Catches exceptions and returns `{ success: false }` instead of throwing.
+     */
+    async run() {
+        const startTime = Date.now();
+        this.logger.debug({ options: this.options }, `Starting task: ${this.taskName}`);
+        try {
+            this.validate();
+            const result = await this.execute();
+            result.duration = Date.now() - startTime;
+            this.logger.debug({ success: result.success, duration: result.duration }, `Completed task: ${this.taskName}`);
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            this.logger.error({ error, duration }, `Failed task: ${this.taskName}`);
+            return {
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+                duration,
+            };
+        }
+    }
+}
+//# sourceMappingURL=base-task.js.map

package/dist/task/base-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-task.js","sourceRoot":"","sources":["../../src/task/base-task.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAc1C,MAAM,OAAgB,QAAQ;IAIhB;IACA;IAJF,MAAM,CAAS;IAEzB,YACY,GAAgB,EAChB,OAAc;QADd,QAAG,GAAH,GAAG,CAAa;QAChB,YAAO,GAAP,OAAO,CAAO;QAExB,MAAM,YAAY,GAAG,GAAG,CAAC,MAAM,IAAI,UAAU,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;IAMD,gEAAgE;IACtD,QAAQ,KAAU,CAAC;IAE7B;;;OAGG;IACH,KAAK,CAAC,GAAG;QACP,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEhF,IAAI,CAAC;YACH,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEzC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EACtD,mBAAmB,IAAI,CAAC,QAAQ,EAAE,CACnC,CAAC;YAEF,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,gBAAgB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAExE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChE,QAAQ;aACT,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/task/index.d.ts

@@ -0,0 +1,5 @@
+export { BaseTask } from './base-task.js';
+export type { TaskContext, TaskResult } from './base-task.js';
+export { TaskRegistry } from './registry.js';
+export type { TaskConstructor } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/task/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/task/index.js

@@ -0,0 +1,3 @@
+export { BaseTask } from './base-task.js';
+export { TaskRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/task/registry.d.ts

@@ -0,0 +1,27 @@
+import { BaseTask, type TaskContext } from './base-task.js';
+export type TaskConstructor = new (ctx: TaskContext, options: Record<string, unknown>) => BaseTask;
+export declare class TaskRegistry {
+    private classPathMap;
+    private nameMap;
+    private dynamicCache;
+    /** Register a task by short name (e.g. `'deploy'`). */
+    register(name: string, ctor: TaskConstructor): this;
+    /** Register a task by class path (e.g. `'my.tasks.Deploy'`). */
+    registerClassPath(classPath: string, ctor: TaskConstructor): this;
+    /** Bulk-register by short name. */
+    registerAll(entries: Record<string, TaskConstructor>): this;
+    /** Bulk-register by class path. */
+    registerClassPaths(entries: Record<string, TaskConstructor>): this;
+    /**
+     * Resolve a task constructor by name or class path.
+     * Falls back to dynamic import from the filesystem.
+     */
+    resolve(classPathOrName: string): Promise<TaskConstructor>;
+    /** Resolve + instantiate in one call. */
+    create(classPathOrName: string, ctx: TaskContext, options: Record<string, unknown>): Promise<BaseTask>;
+    /** Return all registered names and class paths. */
+    listRegistered(): string[];
+    private loadDynamic;
+    private classPathToCandidates;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/task/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/task/registry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,KAC5B,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,QAAQ,CAAC;AAEd,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,YAAY,CAAsC;IAE1D,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI;IAKnD,gEAAgE;IAChE,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI;IAKjE,mCAAmC;IACnC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI;IAO3D,mCAAmC;IACnC,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,IAAI;IAOlE;;;OAGG;IACG,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAQhE,yCAAyC;IACnC,MAAM,CACV,eAAe,EAAE,MAAM,EACvB,GAAG,EAAE,WAAW,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,QAAQ,CAAC;IAKpB,mDAAmD;IACnD,cAAc,IAAI,MAAM,EAAE;YAQZ,WAAW;IA0CzB,OAAO,CAAC,qBAAqB;CAW9B"}

package/dist/task/registry.js

@@ -0,0 +1,95 @@
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import { BaseTask } from './base-task.js';
+export class TaskRegistry {
+    classPathMap = new Map();
+    nameMap = new Map();
+    dynamicCache = new Map();
+    /** Register a task by short name (e.g. `'deploy'`). */
+    register(name, ctor) {
+        this.nameMap.set(name, ctor);
+        return this;
+    }
+    /** Register a task by class path (e.g. `'my.tasks.Deploy'`). */
+    registerClassPath(classPath, ctor) {
+        this.classPathMap.set(classPath, ctor);
+        return this;
+    }
+    /** Bulk-register by short name. */
+    registerAll(entries) {
+        for (const [name, ctor] of Object.entries(entries)) {
+            this.nameMap.set(name, ctor);
+        }
+        return this;
+    }
+    /** Bulk-register by class path. */
+    registerClassPaths(entries) {
+        for (const [classPath, ctor] of Object.entries(entries)) {
+            this.classPathMap.set(classPath, ctor);
+        }
+        return this;
+    }
+    /**
+     * Resolve a task constructor by name or class path.
+     * Falls back to dynamic import from the filesystem.
+     */
+    async resolve(classPathOrName) {
+        const builtin = this.classPathMap.get(classPathOrName) ?? this.nameMap.get(classPathOrName);
+        if (builtin)
+            return builtin;
+        return this.loadDynamic(classPathOrName);
+    }
+    /** Resolve + instantiate in one call. */
+    async create(classPathOrName, ctx, options) {
+        const TaskClass = await this.resolve(classPathOrName);
+        return new TaskClass(ctx, options);
+    }
+    /** Return all registered names and class paths. */
+    listRegistered() {
+        return [...new Set([...this.nameMap.keys(), ...this.classPathMap.keys()])];
+    }
+    // ---------------------------------------------------------------------------
+    // Dynamic loading — class_path treated as a dotted file path
+    // ---------------------------------------------------------------------------
+    async loadDynamic(classPath) {
+        const cached = this.dynamicCache.get(classPath);
+        if (cached)
+            return cached;
+        const candidates = this.classPathToCandidates(classPath);
+        let resolvedPath = null;
+        for (const candidate of candidates) {
+            if (fs.existsSync(candidate)) {
+                resolvedPath = candidate;
+                break;
+            }
+        }
+        if (!resolvedPath) {
+            throw new Error(`Cannot resolve task "${classPath}". Searched:\n` +
+                candidates.map((c) => `  - ${c}`).join('\n'));
+        }
+        const fileUrl = `file://${resolvedPath.replace(/\\/g, '/')}`;
+        const mod = await import(fileUrl);
+        const baseName = path.basename(classPath.replace(/\./g, '/'));
+        const TaskClass = mod.default ?? mod[baseName];
+        if (!TaskClass) {
+            throw new Error(`Module "${resolvedPath}" does not export a default class or a named export ` +
+                `matching "${baseName}"`);
+        }
+        if (!(TaskClass.prototype instanceof BaseTask)) {
+            throw new Error(`Task class from "${resolvedPath}" does not extend BaseTask`);
+        }
+        this.dynamicCache.set(classPath, TaskClass);
+        return TaskClass;
+    }
+    classPathToCandidates(classPath) {
+        const segments = classPath.replace(/\./g, '/');
+        const cwd = process.cwd();
+        return [
+            path.resolve(cwd, `${segments}.ts`),
+            path.resolve(cwd, `${segments}.js`),
+            path.resolve(cwd, `${segments}/index.ts`),
+            path.resolve(cwd, `${segments}/index.js`),
+        ];
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/task/registry.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@db-lyon/flowkit",
+  "version": "0.1.0",
+  "description": "YAML-configured task and flow orchestration engine",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./config": "./dist/config/index.js",
+    "./task": "./dist/task/index.js",
+    "./flow": "./dist/flow/index.js",
+    "./dag": "./dist/dag/index.js"
+  },
+  "files": [
+    "/dist"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "prepublishOnly": "tsc -b",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": [
+    "task",
+    "flow",
+    "orchestration",
+    "yaml",
+    "pipeline",
+    "engine"
+  ],
+  "author": "David Lyon",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/db-lyon/flowkit.git"
+  },
+  "dependencies": {
+    "js-yaml": "^4",
+    "zod": "^3"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4",
+    "@types/node": "^20",
+    "typescript": "^5",
+    "vitest": "^2"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}