@ticatec/omniflow-core 0.1.0

package/dist/context/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Core execution context and command result contracts for OmniFlow.
+ */
+export interface GitMetadata {
+    branch?: string;
+    commit?: string;
+    tag?: string;
+    dirty?: boolean;
+}
+export interface Logger {
+    info(msg: string): void;
+    warn(msg: string): void;
+    error(msg: string): void;
+    debug?(msg: string): void;
+}
+export interface Artifact {
+    type: string;
+    ref: string;
+    name?: string;
+    digest?: string;
+    path?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface CommandResult {
+    success: boolean;
+    message?: string;
+    artifacts?: Artifact[];
+    outputs?: Record<string, unknown>;
+    error?: Error | string;
+}
+export type SourceMode = 'local' | 'ref' | 'managed';
+/**
+ * Pure read-only execution context representing the active run state.
+ * Bound to the current async execution chain via AsyncLocalStorage.
+ */
+export interface ExecutionContext {
+    /** Unique run identifier */
+    runId: string;
+    /** Physical directory path for workspace */
+    workspace: string;
+    /** Physical project root directory */
+    projectRoot: string;
+    /** Project key/name */
+    project: string;
+    /** Module name currently executing, if applicable */
+    module?: string;
+    /** Relative subdirectory of the active module */
+    moduleFolder?: string;
+    /** Target deployment environment name (test, prod, etc.) */
+    environment: string;
+    /** Git repository state at execution time */
+    git: GitMetadata;
+    /** Resolved and merged environment variables */
+    env: Record<string, string>;
+    /** Structured logger directing output to terminal and run record */
+    logger: Logger;
+    /** Whether the execution is running in dry-run mode */
+    dryRun: boolean;
+    /** Active source resolution mode */
+    sourceMode?: SourceMode;
+    /** Path to the log file receiving all process and command output */
+    logFile?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,KAAK,GAAG,SAAS,CAAA;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAA;IACnB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAA;IACnB,6CAA6C;IAC7C,GAAG,EAAE,WAAW,CAAA;IAChB,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3B,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,MAAM,EAAE,OAAO,CAAA;IACf,oCAAoC;IACpC,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB"}

package/dist/context/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core execution context and command result contracts for OmniFlow.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/context/types.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @omniflow/core
+ *
+ * Foundational execution context, primitives, and toolchain SPI
+ * for OmniFlow CI/CD orchestrator and its plugins.
+ */
+export { getContext, tryGetContext, hasContext, runWithContext, createMockContext, executionLocalStorage, type ExecutionContext, type CommandResult, type Artifact, type Logger, type GitMetadata, type SourceMode } from './context/index.js';
+export { shell, run, sh, output, type RunOptions, type ShellOutputResult, type TemplateRunner } from './primitives/shell.js';
+export { ssh, SshClient, type SshServerConfig, type SshConnectionConfig, type SshTarget, type SshResult } from './primitives/ssh.js';
+export { git } from './primitives/git.js';
+export { docker, type DockerBuildOptions, type ComposeOptions } from './primitives/docker.js';
+export { registerToolchain, resolveToolchain, ToolchainRegistry, defaultToolchainRegistry, MavenToolchain, GradleToolchain, NodeToolchain, readPom, parseXml, type ToolchainProvider, type DetectionResult, type ProjectInfo } from './toolchain/index.js';
+export { maskString, maskObject, isSecretKey, MASK } from './utils/mask.js';
+export { templateToArgv } from './utils/template.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":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,KAAK,EACL,GAAG,EACH,EAAE,EACF,MAAM,EACN,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,GAAG,EACH,SAAS,EACT,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAEzC,OAAO,EACL,MAAM,EACN,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,aAAa,EACb,OAAO,EACP,QAAQ,EACR,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,IAAI,EACL,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,EACf,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @omniflow/core
+ *
+ * Foundational execution context, primitives, and toolchain SPI
+ * for OmniFlow CI/CD orchestrator and its plugins.
+ */
+// Context
+export { getContext, tryGetContext, hasContext, runWithContext, createMockContext, executionLocalStorage } from './context/index.js';
+// Primitives
+export { shell, run, sh, output } from './primitives/shell.js';
+export { ssh, SshClient } from './primitives/ssh.js';
+export { git } from './primitives/git.js';
+export { docker } from './primitives/docker.js';
+// Toolchains
+export { registerToolchain, resolveToolchain, ToolchainRegistry, defaultToolchainRegistry, MavenToolchain, GradleToolchain, NodeToolchain, readPom, parseXml } from './toolchain/index.js';
+// Utilities
+export { maskString, maskObject, isSecretKey, MASK } from './utils/mask.js';
+export { templateToArgv } from './utils/template.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;;;;;GAKG;AAEH,UAAU;AACV,OAAO,EACL,UAAU,EACV,aAAa,EACb,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EAOtB,MAAM,oBAAoB,CAAA;AAE3B,aAAa;AACb,OAAO,EACL,KAAK,EACL,GAAG,EACH,EAAE,EACF,MAAM,EAIP,MAAM,uBAAuB,CAAA;AAE9B,OAAO,EACL,GAAG,EACH,SAAS,EAKV,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAA;AAEzC,OAAO,EACL,MAAM,EAGP,MAAM,wBAAwB,CAAA;AAE/B,aAAa;AACb,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,eAAe,EACf,aAAa,EACb,OAAO,EACP,QAAQ,EAIT,MAAM,sBAAsB,CAAA;AAE7B,YAAY;AACZ,OAAO,EACL,UAAU,EACV,UAAU,EACV,WAAW,EACX,IAAI,EACL,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,cAAc,EACf,MAAM,qBAAqB,CAAA"}

package/dist/primitives/docker.d.ts

@@ -0,0 +1,41 @@
+import type { Artifact } from '../context/types.js';
+export interface DockerBuildOptions {
+    image: string;
+    dockerfile?: string;
+    target?: string;
+    buildArgs?: Record<string, string>;
+    cwd?: string;
+    flags?: string[];
+}
+export interface ComposeOptions {
+    files?: string | string[];
+    services?: string[];
+    detach?: boolean;
+    build?: boolean;
+    envFile?: string;
+    cwd?: string;
+    flags?: string[];
+}
+export declare const docker: {
+    /**
+     * Build a Docker image.
+     */
+    build(options: DockerBuildOptions): Promise<Artifact>;
+    /**
+     * Tag an existing Docker image.
+     */
+    tag(sourceImage: string, targetImage: string): Promise<Artifact>;
+    /**
+     * Push a Docker image to a registry.
+     */
+    push(image: string): Promise<Artifact>;
+    /**
+     * Launch services using Docker Compose.
+     */
+    composeUp(options?: ComposeOptions): Promise<void>;
+    /**
+     * Stop and remove containers using Docker Compose.
+     */
+    composeDown(options?: ComposeOptions): Promise<void>;
+};
+//# sourceMappingURL=docker.d.ts.map

package/dist/primitives/docker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker.d.ts","sourceRoot":"","sources":["../../src/primitives/docker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,eAAO,MAAM,MAAM;IACjB;;OAEG;mBACkB,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAgC3D;;OAEG;qBACoB,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAUtE;;OAEG;gBACe,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAU5C;;OAEG;wBACsB,cAAc,GAAQ,OAAO,CAAC,IAAI,CAAC;IAsC5D;;OAEG;0BACwB,cAAc,GAAQ,OAAO,CAAC,IAAI,CAAC;CAqB/D,CAAA"}

package/dist/primitives/docker.js

@@ -0,0 +1,109 @@
+import path from 'node:path';
+import { shell } from './shell.js';
+import { tryGetContext } from '../context/index.js';
+export const docker = {
+    /**
+     * Build a Docker image.
+     */
+    async build(options) {
+        const ctx = tryGetContext();
+        const cwd = options.cwd ?? (ctx?.moduleFolder ? path.resolve(ctx.workspace, ctx.moduleFolder) : ctx?.workspace ?? process.cwd());
+        const dockerfile = options.dockerfile ?? 'Dockerfile';
+        const args = ['build', '-f', dockerfile, '-t', options.image];
+        if (options.target) {
+            args.push('--target', options.target);
+        }
+        if (options.buildArgs) {
+            for (const [k, v] of Object.entries(options.buildArgs)) {
+                args.push('--build-arg', `${k}=${v}`);
+            }
+        }
+        if (options.flags) {
+            args.push(...options.flags);
+        }
+        args.push('.');
+        ctx?.logger.info(`Building Docker image: ${options.image} (file: ${dockerfile})`);
+        await shell.run({ cwd }) `docker ${args}`;
+        return {
+            type: 'docker-image',
+            ref: options.image
+        };
+    },
+    /**
+     * Tag an existing Docker image.
+     */
+    async tag(sourceImage, targetImage) {
+        const ctx = tryGetContext();
+        ctx?.logger.info(`Tagging Docker image: ${sourceImage} -> ${targetImage}`);
+        await shell.run `docker tag ${sourceImage} ${targetImage}`;
+        return {
+            type: 'docker-image',
+            ref: targetImage
+        };
+    },
+    /**
+     * Push a Docker image to a registry.
+     */
+    async push(image) {
+        const ctx = tryGetContext();
+        ctx?.logger.info(`Pushing Docker image: ${image}`);
+        await shell.run `docker push ${image}`;
+        return {
+            type: 'docker-image',
+            ref: image
+        };
+    },
+    /**
+     * Launch services using Docker Compose.
+     */
+    async composeUp(options = {}) {
+        const ctx = tryGetContext();
+        const cwd = options.cwd ?? (ctx?.moduleFolder ? path.resolve(ctx.workspace, ctx.moduleFolder) : ctx?.workspace ?? process.cwd());
+        const args = ['compose'];
+        if (options.files) {
+            const files = Array.isArray(options.files) ? options.files : [options.files];
+            for (const f of files) {
+                args.push('-f', f);
+            }
+        }
+        if (options.envFile) {
+            args.push('--env-file', options.envFile);
+        }
+        args.push('up');
+        if (options.detach !== false) {
+            args.push('-d');
+        }
+        if (options.build) {
+            args.push('--build');
+        }
+        if (options.flags) {
+            args.push(...options.flags);
+        }
+        if (options.services && options.services.length > 0) {
+            args.push(...options.services);
+        }
+        ctx?.logger.info(`Docker Compose up (services: ${options.services?.join(', ') ?? 'all'})`);
+        await shell.run({ cwd }) `docker ${args}`;
+    },
+    /**
+     * Stop and remove containers using Docker Compose.
+     */
+    async composeDown(options = {}) {
+        const ctx = tryGetContext();
+        const cwd = options.cwd ?? (ctx?.moduleFolder ? path.resolve(ctx.workspace, ctx.moduleFolder) : ctx?.workspace ?? process.cwd());
+        const args = ['compose'];
+        if (options.files) {
+            const files = Array.isArray(options.files) ? options.files : [options.files];
+            for (const f of files) {
+                args.push('-f', f);
+            }
+        }
+        args.push('down');
+        if (options.flags) {
+            args.push(...options.flags);
+        }
+        ctx?.logger.info('Docker Compose down');
+        await shell.run({ cwd }) `docker ${args}`;
+    }
+};
+//# sourceMappingURL=docker.js.map

package/dist/primitives/docker.js.map

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

package/dist/primitives/git.d.ts

@@ -0,0 +1,19 @@
+export declare const git: {
+    /** Return full SHA of current commit */
+    currentCommit(dir?: string): Promise<string>;
+    /** Return short SHA of current commit */
+    shortCommit(dir?: string): Promise<string>;
+    /** Return current checked-out branch name, or empty string if detached HEAD */
+    currentBranch(dir?: string): Promise<string>;
+    /** Check if working tree has untracked or uncommitted changes */
+    isDirty(dir?: string): Promise<boolean>;
+    /** Fetch latest changes from remote */
+    fetch(dir?: string, remote?: string, branch?: string): Promise<void>;
+    /** Hard reset to target (defaults to HEAD) */
+    resetHard(dir?: string, target?: string): Promise<void>;
+    /** Clean working tree */
+    clean(dir?: string, forceIgnored?: boolean): Promise<void>;
+    /** Switch or checkout a ref */
+    checkout(dir?: string, ref?: string): Promise<void>;
+};
+//# sourceMappingURL=git.d.ts.map

package/dist/primitives/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/primitives/git.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,GAAG;IACd,wCAAwC;wBACd,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlD,yCAAyC;sBACjB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMhD,+EAA+E;wBACrD,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUlD,iEAAiE;kBAC7C,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAM7C,uCAAuC;gBACrB,MAAM,4BAA8B,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5E,8CAA8C;oBACxB,MAAM,oBAAoB,OAAO,CAAC,IAAI,CAAC;IAU7D,yBAAyB;gBACP,MAAM,2BAAyB,OAAO,CAAC,IAAI,CAAC;IAW9D,+BAA+B;mBACV,MAAM,iBAAiB,OAAO,CAAC,IAAI,CAAC;CAS1D,CAAA"}

package/dist/primitives/git.js

@@ -0,0 +1,84 @@
+import { execa } from 'execa';
+import { tryGetContext } from '../context/index.js';
+function resolveDir(dir) {
+    if (dir)
+        return dir;
+    const ctx = tryGetContext();
+    return ctx?.workspace ?? process.cwd();
+}
+export const git = {
+    /** Return full SHA of current commit */
+    async currentCommit(dir) {
+        const cwd = resolveDir(dir);
+        const { stdout } = await execa('git', ['rev-parse', 'HEAD'], { cwd });
+        return stdout.trim();
+    },
+    /** Return short SHA of current commit */
+    async shortCommit(dir) {
+        const cwd = resolveDir(dir);
+        const { stdout } = await execa('git', ['rev-parse', '--short', 'HEAD'], { cwd });
+        return stdout.trim();
+    },
+    /** Return current checked-out branch name, or empty string if detached HEAD */
+    async currentBranch(dir) {
+        const cwd = resolveDir(dir);
+        try {
+            const { stdout } = await execa('git', ['symbolic-ref', '--short', 'HEAD'], { cwd });
+            return stdout.trim();
+        }
+        catch {
+            return '';
+        }
+    },
+    /** Check if working tree has untracked or uncommitted changes */
+    async isDirty(dir) {
+        const cwd = resolveDir(dir);
+        const { stdout } = await execa('git', ['status', '--porcelain'], { cwd });
+        return stdout.trim().length > 0;
+    },
+    /** Fetch latest changes from remote */
+    async fetch(dir, remote = 'origin', branch) {
+        const cwd = resolveDir(dir);
+        const ctx = tryGetContext();
+        if (ctx?.dryRun) {
+            ctx.logger.info(`[DRY-RUN] git fetch ${remote} ${branch ?? ''}`);
+            return;
+        }
+        const args = ['fetch', remote];
+        if (branch)
+            args.push(branch);
+        await execa('git', args, { cwd });
+    },
+    /** Hard reset to target (defaults to HEAD) */
+    async resetHard(dir, target = 'HEAD') {
+        const cwd = resolveDir(dir);
+        const ctx = tryGetContext();
+        if (ctx?.dryRun) {
+            ctx.logger.info(`[DRY-RUN] git reset --hard ${target}`);
+            return;
+        }
+        await execa('git', ['reset', '--hard', target], { cwd });
+    },
+    /** Clean working tree */
+    async clean(dir, forceIgnored = false) {
+        const cwd = resolveDir(dir);
+        const ctx = tryGetContext();
+        if (ctx?.dryRun) {
+            ctx.logger.info(`[DRY-RUN] git clean -fd${forceIgnored ? 'x' : ''}`);
+            return;
+        }
+        const flags = forceIgnored ? ['clean', '-fdx'] : ['clean', '-fd'];
+        await execa('git', flags, { cwd });
+    },
+    /** Switch or checkout a ref */
+    async checkout(dir, ref = 'main') {
+        const cwd = resolveDir(dir);
+        const ctx = tryGetContext();
+        if (ctx?.dryRun) {
+            ctx.logger.info(`[DRY-RUN] git checkout ${ref}`);
+            return;
+        }
+        await execa('git', ['checkout', ref], { cwd });
+    }
+};
+//# sourceMappingURL=git.js.map

package/dist/primitives/git.js.map

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

package/dist/primitives/index.d.ts

@@ -0,0 +1,5 @@
+export * from './shell.js';
+export * from './ssh.js';
+export * from './git.js';
+export * from './docker.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}

package/dist/primitives/index.js

@@ -0,0 +1,5 @@
+export * from './shell.js';
+export * from './ssh.js';
+export * from './git.js';
+export * from './docker.js';
+//# sourceMappingURL=index.js.map

package/dist/primitives/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/primitives/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA"}

package/dist/primitives/shell.d.ts

@@ -0,0 +1,42 @@
+export interface RunOptions {
+    /** Working directory (defaults to context's active module or workspace) */
+    cwd?: string;
+    /** Extra environment variables merged over process and context env */
+    env?: Record<string, string>;
+    /** Reject promise on non-zero exit code (default: true) */
+    reject?: boolean;
+    /** Capture and return stdout / stderr */
+    capture?: boolean;
+}
+export interface ShellOutputResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Tagged template runner signature.
+ */
+export interface TemplateRunner {
+    (template: TemplateStringsArray, ...values: unknown[]): Promise<ShellOutputResult>;
+}
+/**
+ * `shell.run` runner function supporting:
+ * 1. `shell.run`docker build -t ${img} .``
+ * 2. `shell.run({ cwd: '/app' })`docker build -t ${img} .``
+ */
+export declare function run(options: RunOptions): TemplateRunner;
+export declare function run(template: TemplateStringsArray, ...values: unknown[]): Promise<ShellOutputResult>;
+/**
+ * Run a command string via the shell (supports pipes, redirects, &&, ||).
+ */
+export declare function sh(cmd: string, options?: RunOptions): Promise<ShellOutputResult>;
+/**
+ * Run a command and capture its stdout, stderr and exitCode without throwing on failure.
+ */
+export declare function output(cmd: string, options?: RunOptions): Promise<ShellOutputResult>;
+export declare const shell: {
+    run: typeof run;
+    sh: typeof sh;
+    output: typeof output;
+};
+//# sourceMappingURL=shell.d.ts.map

package/dist/primitives/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/primitives/shell.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB;AA4GD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACnF;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,cAAc,CAAA;AACxD,wBAAgB,GAAG,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;AA4BrG;;GAEG;AACH,wBAAsB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE1F;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAE9F;AAED,eAAO,MAAM,KAAK;;;;CAIjB,CAAA"}

package/dist/primitives/shell.js

@@ -0,0 +1,141 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { execa } from 'execa';
+import { tryGetContext } from '../context/index.js';
+import { templateToArgv } from '../utils/template.js';
+import { isSecretKey, maskString } from '../utils/mask.js';
+function resolveCwd(explicitCwd) {
+    if (explicitCwd)
+        return explicitCwd;
+    const ctx = tryGetContext();
+    if (ctx) {
+        if (ctx.moduleFolder) {
+            return path.resolve(ctx.workspace, ctx.moduleFolder);
+        }
+        if (ctx.workspace) {
+            return ctx.workspace;
+        }
+    }
+    return process.cwd();
+}
+function resolveEnv(explicitEnv) {
+    const ctx = tryGetContext();
+    const base = { ...process.env };
+    if (ctx?.env) {
+        Object.assign(base, ctx.env);
+    }
+    if (explicitEnv) {
+        Object.assign(base, explicitEnv);
+    }
+    return base;
+}
+function getSecretValues() {
+    const ctx = tryGetContext();
+    if (!ctx?.env)
+        return [];
+    const secrets = [];
+    for (const [k, v] of Object.entries(ctx.env)) {
+        if (isSecretKey(k) && typeof v === 'string' && v.length >= 3) {
+            secrets.push(v);
+        }
+    }
+    return secrets;
+}
+/**
+ * Execute command via execa, piping output and handling dryRun.
+ */
+async function executeInternal(fileOrCmd, args, options) {
+    const ctx = tryGetContext();
+    const cwd = resolveCwd(options.cwd);
+    const env = resolveEnv(options.env);
+    const secrets = getSecretValues();
+    const cmdDisplay = args ? [fileOrCmd, ...args].join(' ') : fileOrCmd;
+    // Dry-run interception
+    if (ctx?.dryRun) {
+        const maskedCmd = maskString(cmdDisplay, secrets);
+        ctx.logger.info(`[DRY-RUN] Executing: ${maskedCmd} (cwd: ${cwd})`);
+        return {
+            stdout: `[DRY-RUN] ${maskedCmd}`,
+            stderr: '',
+            exitCode: 0
+        };
+    }
+    const execaOpts = {
+        cwd,
+        env,
+        reject: options.reject ?? true,
+        shell: options.isShell ?? false
+    };
+    // If a log file is defined in the context, write to it
+    let logStream;
+    if (ctx?.logFile) {
+        try {
+            logStream = fs.createWriteStream(ctx.logFile, { flags: 'a' });
+        }
+        catch {
+            // Ignored if unable to open log file
+        }
+    }
+    try {
+        const subprocess = args
+            ? execa(fileOrCmd, args, execaOpts)
+            : execa(fileOrCmd, execaOpts);
+        if (subprocess.stdout && logStream) {
+            subprocess.stdout.pipe(logStream, { end: false });
+        }
+        if (subprocess.stderr && logStream) {
+            subprocess.stderr.pipe(logStream, { end: false });
+        }
+        const result = await subprocess;
+        return {
+            stdout: typeof result.stdout === 'string' ? result.stdout : (result.stdout ? String(result.stdout) : ''),
+            stderr: typeof result.stderr === 'string' ? result.stderr : (result.stderr ? String(result.stderr) : ''),
+            exitCode: result.exitCode ?? 0
+        };
+    }
+    finally {
+        if (logStream) {
+            logStream.end();
+        }
+    }
+}
+export function run(templateOrOptions, ...values) {
+    // Overload 2: options passed first, returns a TemplateRunner
+    if (!Array.isArray(templateOrOptions) || !('raw' in templateOrOptions)) {
+        const options = templateOrOptions ?? {};
+        return async (template, ...innerValues) => {
+            const argv = templateToArgv(template, innerValues);
+            if (argv.length === 0) {
+                throw new Error('Command is empty');
+            }
+            const [cmd, ...args] = argv;
+            return executeInternal(cmd, args, options);
+        };
+    }
+    // Overload 1: direct tagged template
+    const template = templateOrOptions;
+    const argv = templateToArgv(template, values);
+    if (argv.length === 0) {
+        throw new Error('Command is empty');
+    }
+    const [cmd, ...args] = argv;
+    return executeInternal(cmd, args, {});
+}
+/**
+ * Run a command string via the shell (supports pipes, redirects, &&, ||).
+ */
+export async function sh(cmd, options = {}) {
+    return executeInternal(cmd, undefined, { ...options, isShell: true });
+}
+/**
+ * Run a command and capture its stdout, stderr and exitCode without throwing on failure.
+ */
+export async function output(cmd, options = {}) {
+    return executeInternal(cmd, undefined, { ...options, isShell: true, reject: false, capture: true });
+}
+export const shell = {
+    run,
+    sh,
+    output
+};
+//# sourceMappingURL=shell.js.map

package/dist/primitives/shell.js.map

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