@ticatec/omniflow-core 0.1.0

package/dist/toolchain/providers/pom.js

@@ -0,0 +1,112 @@
+/**
+ * XML parsing helper for reading coordinates out of a pom.xml without general XML parser dependencies.
+ */
+const ENTITIES = {
+    '&lt;': '<',
+    '&gt;': '>',
+    '&amp;': '&',
+    '&quot;': '"',
+    '&apos;': "'"
+};
+function decodeEntities(text) {
+    return text.replace(/&(?:lt|gt|amp|quot|apos|#\d+|#x[0-9a-fA-F]+);/g, match => {
+        if (ENTITIES[match])
+            return ENTITIES[match];
+        const numeric = match.startsWith('&#x') || match.startsWith('&#X')
+            ? parseInt(match.slice(3, -1), 16)
+            : parseInt(match.slice(2, -1), 10);
+        return Number.isFinite(numeric) ? String.fromCodePoint(numeric) : match;
+    });
+}
+function stripNoise(xml) {
+    return xml
+        .replace(/<\?[\s\S]*?\?>/g, '')
+        .replace(/<!--[\s\S]*?-->/g, '')
+        .replace(/<!DOCTYPE[^>[]*(\[[\s\S]*?\])?[^>]*>/gi, '')
+        .replace(/<!\[CDATA\[([\s\S]*?)\]\]>/g, (_, body) => body.replace(/&/g, '&amp;').replace(/</g, '&lt;'));
+}
+export function parseXml(xml) {
+    const source = stripNoise(xml);
+    const tag = /<\s*(\/?)\s*([A-Za-z_][\w.:-]*)((?:"[^"]*"|'[^']*'|[^>"'])*?)(\/?)\s*>/g;
+    let root;
+    const stack = [];
+    let textFrom = 0;
+    let match;
+    const addText = (upTo) => {
+        const top = stack[stack.length - 1];
+        if (!top)
+            return;
+        top.node.text += source.slice(textFrom, upTo);
+    };
+    while ((match = tag.exec(source)) !== null) {
+        const [whole, closing, name, , selfClosing] = match;
+        addText(match.index);
+        textFrom = match.index + whole.length;
+        if (closing) {
+            const open = stack.pop();
+            if (!open || open.name !== name) {
+                throw new Error(`Malformed XML: </${name}> does not close <${open?.name ?? 'nothing'}>`);
+            }
+            continue;
+        }
+        const node = { text: '', children: {} };
+        const entry = { name, node };
+        const parent = stack[stack.length - 1];
+        if (parent) {
+            ;
+            (parent.node.children[name] ??= []).push(node);
+        }
+        else if (root) {
+            break;
+        }
+        else {
+            root = entry;
+        }
+        if (!selfClosing)
+            stack.push(entry);
+    }
+    if (!root)
+        throw new Error('Malformed XML: no root element');
+    return root;
+}
+function childText(node, name) {
+    const child = node.children[name]?.[0];
+    if (!child)
+        return undefined;
+    const text = decodeEntities(child.text).trim();
+    return text || undefined;
+}
+function properties(project) {
+    const out = {};
+    const block = project.children['properties']?.[0];
+    if (!block)
+        return out;
+    for (const [name, nodes] of Object.entries(block.children)) {
+        const text = decodeEntities(nodes[0].text).trim();
+        if (text)
+            out[name] = text;
+    }
+    return out;
+}
+function expand(value, vars) {
+    let out = value;
+    for (let depth = 0; depth < 5 && out.includes('${'); depth++) {
+        const next = out.replace(/\$\{([^}]+)\}/g, (whole, name) => vars[name] ?? whole);
+        if (next === out)
+            break;
+        out = next;
+    }
+    return out;
+}
+export function readPom(xml) {
+    const { node: project } = parseXml(xml);
+    const parent = project.children['parent']?.[0];
+    const vars = properties(project);
+    const resolve = (value) => value === undefined ? undefined : expand(value, vars);
+    return {
+        groupId: resolve(childText(project, 'groupId') ?? (parent && childText(parent, 'groupId'))),
+        artifactId: resolve(childText(project, 'artifactId')),
+        version: resolve(childText(project, 'version') ?? (parent && childText(parent, 'version')))
+    };
+}
+//# sourceMappingURL=pom.js.map

package/dist/toolchain/providers/pom.js.map

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

package/dist/toolchain/registry.d.ts

@@ -0,0 +1,48 @@
+import type { ToolchainProvider, DetectionResult } from './types.js';
+export declare class ToolchainRegistry {
+    private providers;
+    constructor(registerDefaults?: boolean);
+    private registerDefaultProviders;
+    /**
+     * Register a new or overriding ToolchainProvider.
+     */
+    register(provider: ToolchainProvider): void;
+    /**
+     * Remove a registered provider by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Look up a registered provider by name.
+     */
+    get(name: string): ToolchainProvider | undefined;
+    /**
+     * List all registered providers sorted by priority (highest first).
+     */
+    list(): ToolchainProvider[];
+    /**
+     * Detect which toolchain matches the directory.
+     */
+    detect(projectDir: string): Promise<{
+        provider: ToolchainProvider;
+        detection: DetectionResult;
+    } | null>;
+    /**
+     * Resolve a toolchain for a directory, respecting an optional preferred toolchain name fallback.
+     */
+    resolve(projectDir: string, preferredName?: string): Promise<{
+        provider: ToolchainProvider;
+        detection: DetectionResult;
+    }>;
+    /**
+     * Reset registry to defaults.
+     */
+    reset(): void;
+}
+/** Global default ToolchainRegistry singleton */
+export declare const defaultToolchainRegistry: ToolchainRegistry;
+export declare function registerToolchain(provider: ToolchainProvider): void;
+export declare function resolveToolchain(projectDir: string, preferredName?: string): Promise<{
+    provider: ToolchainProvider;
+    detection: DetectionResult;
+}>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/toolchain/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEpE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAA4C;gBAEjD,gBAAgB,UAAO;IAMnC,OAAO,CAAC,wBAAwB;IAOhC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI3C;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAShD;;OAEG;IACH,IAAI,IAAI,iBAAiB,EAAE;IAM3B;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,iBAAiB,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI,CAAC;IAW7G;;OAEG;IACG,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,QAAQ,EAAE,iBAAiB,CAAC;QAAC,SAAS,EAAE,eAAe,CAAA;KAAE,CAAC;IAyBvE;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,iDAAiD;AACjD,eAAO,MAAM,wBAAwB,mBAA0B,CAAA;AAE/D,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAEnE;AAED,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;IAAE,QAAQ,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC,CAEtE"}

package/dist/toolchain/registry.js

@@ -0,0 +1,97 @@
+import { MavenToolchain } from './providers/MavenToolchain.js';
+import { GradleToolchain } from './providers/GradleToolchain.js';
+import { NodeToolchain } from './providers/NodeToolchain.js';
+export class ToolchainRegistry {
+    providers = new Map();
+    constructor(registerDefaults = true) {
+        if (registerDefaults) {
+            this.registerDefaultProviders();
+        }
+    }
+    registerDefaultProviders() {
+        // Built-in order: Maven, Gradle, Node
+        this.register(new MavenToolchain());
+        this.register(new GradleToolchain());
+        this.register(new NodeToolchain());
+    }
+    /**
+     * Register a new or overriding ToolchainProvider.
+     */
+    register(provider) {
+        this.providers.set(provider.name, provider);
+    }
+    /**
+     * Remove a registered provider by name.
+     */
+    unregister(name) {
+        return this.providers.delete(name);
+    }
+    /**
+     * Look up a registered provider by name.
+     */
+    get(name) {
+        const direct = this.providers.get(name);
+        if (direct)
+            return direct;
+        if (['pnpm', 'npm', 'yarn', 'bun'].includes(name)) {
+            return new NodeToolchain(name);
+        }
+        return undefined;
+    }
+    /**
+     * List all registered providers sorted by priority (highest first).
+     */
+    list() {
+        return Array.from(this.providers.values()).sort((a, b) => (b.priority ?? 0) - (a.priority ?? 0));
+    }
+    /**
+     * Detect which toolchain matches the directory.
+     */
+    async detect(projectDir) {
+        const sorted = this.list();
+        for (const provider of sorted) {
+            const detection = await provider.detect(projectDir);
+            if (detection) {
+                return { provider, detection };
+            }
+        }
+        return null;
+    }
+    /**
+     * Resolve a toolchain for a directory, respecting an optional preferred toolchain name fallback.
+     */
+    async resolve(projectDir, preferredName) {
+        const detected = await this.detect(projectDir);
+        if (detected) {
+            return detected;
+        }
+        if (preferredName) {
+            const provider = this.get(preferredName);
+            if (!provider) {
+                throw new Error(`Preferred toolchain '${preferredName}' is not registered. Available: ${Array.from(this.providers.keys()).join(', ')}`);
+            }
+            return {
+                provider,
+                detection: { name: preferredName, reason: `configured default (${preferredName})` }
+            };
+        }
+        throw new Error(`Could not determine toolchain for directory '${projectDir}'. ` +
+            `No pom.xml, build.gradle, or package.json found, and no matching registered toolchain detected.`);
+    }
+    /**
+     * Reset registry to defaults.
+     */
+    reset() {
+        this.providers.clear();
+        this.registerDefaultProviders();
+    }
+}
+/** Global default ToolchainRegistry singleton */
+export const defaultToolchainRegistry = new ToolchainRegistry();
+export function registerToolchain(provider) {
+    defaultToolchainRegistry.register(provider);
+}
+export function resolveToolchain(projectDir, preferredName) {
+    return defaultToolchainRegistry.resolve(projectDir, preferredName);
+}
+//# sourceMappingURL=registry.js.map

package/dist/toolchain/registry.js.map

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

package/dist/toolchain/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Toolchain SPI definitions for project type detection and build execution.
+ */
+export interface ProjectInfo {
+    name: string;
+    version: string;
+    fullName: string;
+    namespace?: string;
+}
+export interface DetectionResult {
+    name: string;
+    reason: string;
+}
+export interface ToolchainProvider {
+    /** Identifier of this toolchain, e.g. 'maven', 'gradle', 'node', 'go' */
+    readonly name: string;
+    /**
+     * Detection and resolution priority. Higher priority is checked earlier.
+     * Enables custom plugins to override built-in toolchains.
+     */
+    readonly priority?: number;
+    /** Check if a project directory matches this toolchain */
+    detect(projectDir: string): Promise<DetectionResult | null>;
+    /** Extract project identity (name, version) from project manifests */
+    projectInfo(projectDir: string): Promise<ProjectInfo>;
+    /** Install or fetch dependencies */
+    install(projectDir: string, flags?: string[]): Promise<void>;
+    /** Run the primary build/package task */
+    build(projectDir: string, flags?: string[]): Promise<void>;
+    /** Run an arbitrary task or script */
+    run?(projectDir: string, task: string, flags?: string[]): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/toolchain/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/toolchain/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAE1B,0DAA0D;IAC1D,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAA;IAE3D,sEAAsE;IACtE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAErD,oCAAoC;IACpC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5D,yCAAyC;IACzC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE1D,sCAAsC;IACtC,GAAG,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxE"}

package/dist/toolchain/types.js

@@ -0,0 +1,5 @@
+/**
+ * Toolchain SPI definitions for project type detection and build execution.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/toolchain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/toolchain/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/mask.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Secret masking heuristics and masking stream utilities.
+ */
+export declare const MASK = "********";
+/** Does this variable or key name suggest its value is a secret? */
+export declare function isSecretKey(key: string): boolean;
+/**
+ * Mask secret substrings within a string log line.
+ */
+export declare function maskString(text: string, secretValues: string[]): string;
+/**
+ * Recursively mask values of secret-looking keys in an object.
+ */
+export declare function maskObject<T>(obj: T): T;
+//# sourceMappingURL=mask.d.ts.map

package/dist/utils/mask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.d.ts","sourceRoot":"","sources":["../../src/utils/mask.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,IAAI,aAAa,CAAA;AAK9B,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CASvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAkBvC"}

package/dist/utils/mask.js

@@ -0,0 +1,50 @@
+/**
+ * Secret masking heuristics and masking stream utilities.
+ */
+export const MASK = '********';
+const SECRET_NAME = /(PASSWORD|PASSWD|PASS|SECRET|TOKEN|CREDENTIAL|PRIVATE|APIKEY|_KEY|^KEY$|KEY$|AUTH|SIGNATURE)/i;
+const LOCATION_NAME = /(_FILE|_PATH|_DIR|_DIRECTORY|_URL|_URI|_LOCATION|_NAME|_ID)$/i;
+/** Does this variable or key name suggest its value is a secret? */
+export function isSecretKey(key) {
+    if (LOCATION_NAME.test(key))
+        return false;
+    return SECRET_NAME.test(key);
+}
+/**
+ * Mask secret substrings within a string log line.
+ */
+export function maskString(text, secretValues) {
+    if (!text || secretValues.length === 0)
+        return text;
+    let result = text;
+    for (const secret of secretValues) {
+        if (secret && secret.length >= 3) {
+            result = result.replaceAll(secret, MASK);
+        }
+    }
+    return result;
+}
+/**
+ * Recursively mask values of secret-looking keys in an object.
+ */
+export function maskObject(obj) {
+    if (obj === null || typeof obj !== 'object')
+        return obj;
+    if (Array.isArray(obj)) {
+        return obj.map(item => maskObject(item));
+    }
+    const output = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (isSecretKey(key) && typeof value === 'string' && value.length > 0) {
+            output[key] = MASK;
+        }
+        else if (typeof value === 'object' && value !== null) {
+            output[key] = maskObject(value);
+        }
+        else {
+            output[key] = value;
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=mask.js.map

package/dist/utils/mask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask.js","sourceRoot":"","sources":["../../src/utils/mask.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,CAAA;AAE9B,MAAM,WAAW,GAAG,+FAA+F,CAAA;AACnH,MAAM,aAAa,GAAG,+DAA+D,CAAA;AAErF,oEAAoE;AACpE,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACzC,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,YAAsB;IAC7D,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACnD,IAAI,MAAM,GAAG,IAAI,CAAA;IACjB,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;QAC1C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAI,GAAM;IAClC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAA;IAEvD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAiB,CAAA;IAC1D,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QACpB,CAAC;aAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;QACrB,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAA;AACpB,CAAC"}

package/dist/utils/template.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Utilities for template string interpolation into command arguments.
+ */
+/**
+ * Turn a tagged template into an argument list (argv).
+ *
+ * Whitespace in literal parts separates arguments, whereas an interpolated value
+ * is preserved as a single argument regardless of whitespace or special characters.
+ * Array values expand into one argument per element.
+ */
+export declare function templateToArgv(strings: readonly string[], values: readonly unknown[]): string[];
+//# sourceMappingURL=template.d.ts.map

package/dist/utils/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,EAAE,CAkD/F"}

package/dist/utils/template.js

@@ -0,0 +1,55 @@
+/**
+ * Utilities for template string interpolation into command arguments.
+ */
+/**
+ * Turn a tagged template into an argument list (argv).
+ *
+ * Whitespace in literal parts separates arguments, whereas an interpolated value
+ * is preserved as a single argument regardless of whitespace or special characters.
+ * Array values expand into one argument per element.
+ */
+export function templateToArgv(strings, values) {
+    const argv = [];
+    let token = '';
+    let started = false;
+    const flush = () => {
+        if (started) {
+            argv.push(token);
+            token = '';
+            started = false;
+        }
+    };
+    const append = (value) => {
+        token += value;
+        started = true;
+    };
+    for (let i = 0; i < strings.length; i++) {
+        for (const char of strings[i]) {
+            if (char === ' ' || char === '\t' || char === '\n' || char === '\r') {
+                flush();
+            }
+            else {
+                append(char);
+            }
+        }
+        if (i < values.length) {
+            const value = values[i];
+            if (value === undefined || value === null) {
+                throw new Error(`Command interpolation contains ${value === null ? 'null' : 'undefined'} ` +
+                    `(value at index ${i}). Verify your variables are configured.`);
+            }
+            if (Array.isArray(value)) {
+                flush();
+                for (const item of value) {
+                    argv.push(String(item));
+                }
+            }
+            else {
+                append(String(value));
+            }
+        }
+    }
+    flush();
+    return argv;
+}
+//# sourceMappingURL=template.js.map

package/dist/utils/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/utils/template.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAA0B,EAAE,MAA0B;IACnF,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,IAAI,KAAK,GAAG,EAAE,CAAA;IACd,IAAI,OAAO,GAAG,KAAK,CAAA;IAEnB,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAChB,KAAK,GAAG,EAAE,CAAA;YACV,OAAO,GAAG,KAAK,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IAED,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;QAC/B,KAAK,IAAI,KAAK,CAAA;QACd,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC,CAAA;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9B,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBACpE,KAAK,EAAE,CAAA;YACT,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,CAAA;YACd,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;YAEvB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CACb,kCAAkC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,GAAG;oBAC1E,mBAAmB,CAAC,0CAA0C,CAC/D,CAAA;YACH,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,EAAE,CAAA;gBACP,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;gBACzB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,EAAE,CAAA;IACP,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@ticatec/omniflow-core",
+  "version": "0.1.0",
+  "description": "Core primitives, execution context, and toolchain SPI for OmniFlow CI/CD orchestrator",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.js"
+    },
+    "./primitives": {
+      "types": "./dist/primitives/index.d.ts",
+      "import": "./dist/primitives/index.js"
+    },
+    "./toolchain": {
+      "types": "./dist/toolchain/index.d.ts",
+      "import": "./dist/toolchain/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "prebuild": "npm run clean",
+    "test": "NODE_OPTIONS=--experimental-vm-modules jest",
+    "typecheck": "tsc --noEmit",
+    "publish:npm": "npm publish --access public"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "execa": "^9.5.1"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.4.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.10.2",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "README_CN.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}