@tonytang99/integration-core 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -1,3 +1,9 @@
+export * from './types/common';
 export * from './pipeline/context';
 export * from './pipeline/phase';
+export * from './pipeline/builder';
+export * from './pipeline/executor';
+export * from './pipeline/middleware';
+export * from './slots/well-known-slots';
+export * from './registry/phase-registry';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -14,6 +14,16 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+// Types
+__exportStar(require("./types/common"), exports);
+// Pipeline
 __exportStar(require("./pipeline/context"), exports);
 __exportStar(require("./pipeline/phase"), exports);
+__exportStar(require("./pipeline/builder"), exports);
+__exportStar(require("./pipeline/executor"), exports);
+__exportStar(require("./pipeline/middleware"), exports);
+// Slots
+__exportStar(require("./slots/well-known-slots"), exports);
+// Registry
+__exportStar(require("./registry/phase-registry"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,QAAQ;AACR,iDAA+B;AAE/B,WAAW;AACX,qDAAmC;AACnC,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,wDAAsC;AAEtC,QAAQ;AACR,2DAAyC;AAEzC,WAAW;AACX,4DAA0C"}

package/dist/pipeline/builder.d.ts

@@ -0,0 +1,14 @@
+import { Phase } from './phase';
+import { Pipeline, ErrorHandler } from './executor';
+import { ClientConfig } from '../types/common';
+export declare class PipelineBuilder {
+    private phases;
+    private errorHandlers;
+    add(phase: Phase): this;
+    addIf(condition: boolean | ((config: ClientConfig) => boolean), phase: Phase): this;
+    addAll(...phases: Phase[]): this;
+    onError(phaseOrCode: string, handler: ErrorHandler): this;
+    build(): Pipeline;
+    private validate;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/pipeline/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/pipeline/builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAW,YAAY,EAAiB,MAAM,iBAAiB,CAAC;AAGvE,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAAmC;IAExD,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKvB,KAAK,CACH,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,EACxD,KAAK,EAAE,KAAK,GACX,IAAI;IASP,MAAM,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAKhC,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAKzD,KAAK,IAAI,QAAQ;IAWjB,OAAO,CAAC,QAAQ;CAmBjB"}

package/dist/pipeline/builder.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineBuilder = void 0;
+const executor_1 = require("./executor");
+class PipelineBuilder {
+    phases = [];
+    errorHandlers = new Map();
+    add(phase) {
+        this.phases.push(phase);
+        return this;
+    }
+    addIf(condition, phase) {
+        if (typeof condition === 'function') {
+            this.phases.push(new ConditionalPhase(phase, condition));
+        }
+        else if (condition) {
+            this.phases.push(phase);
+        }
+        return this;
+    }
+    addAll(...phases) {
+        this.phases.push(...phases);
+        return this;
+    }
+    onError(phaseOrCode, handler) {
+        this.errorHandlers.set(phaseOrCode, handler);
+        return this;
+    }
+    build() {
+        const errors = this.validate();
+        if (errors.length > 0) {
+            throw new Error(`Pipeline validation failed:\n${errors.join('\n')}`);
+        }
+        // In a real implementation, restore the topological sort here
+        // For now, we return the phases in added order
+        return new executor_1.Pipeline(this.phases, this.errorHandlers);
+    }
+    validate() {
+        const errors = [];
+        const produced = new Set();
+        for (const phase of this.phases) {
+            for (const req of phase.requires) {
+                // Cast to string for Set lookup
+                if (!produced.has(req)) {
+                    // Warning: strict validation. 
+                    // If you inject slots via Context initial state, this might false-positive.
+                    errors.push(`Phase "${phase.name}" requires slot "${req}" but no earlier phase produces it`);
+                }
+            }
+            for (const prod of phase.produces) {
+                produced.add(prod);
+            }
+        }
+        return errors;
+    }
+}
+exports.PipelineBuilder = PipelineBuilder;
+/**
+ * Wraps a phase and checks a condition before executing.
+ * Proxies all metadata (name, description, tags) to the inner phase.
+ */
+class ConditionalPhase {
+    inner;
+    condition;
+    constructor(inner, condition) {
+        this.inner = inner;
+        this.condition = condition;
+    }
+    // Required Metadata
+    get name() { return this.inner.name; }
+    get description() { return this.inner.description; }
+    get requires() { return this.inner.requires; }
+    get produces() { return this.inner.produces; }
+    // Optional Metadata
+    get optionalReads() { return this.inner.optionalReads; }
+    get dependsOn() { return this.inner.dependsOn; }
+    get tags() { return this.inner.tags; }
+    async execute(ctx) {
+        // Check condition dynamically at runtime
+        if (!this.condition(ctx.config)) {
+            return ctx; // Return context unchanged if skipped
+        }
+        return this.inner.execute(ctx);
+    }
+    async shouldSkip(ctx) {
+        // If the config condition fails, we definitely skip
+        if (!this.condition(ctx.config))
+            return true;
+        // Otherwise, check if the inner phase wants to skip
+        return this.inner.shouldSkip ? await this.inner.shouldSkip(ctx) : false;
+    }
+    async rollback(ctx, error) {
+        if (this.inner.rollback) {
+            await this.inner.rollback(ctx, error);
+        }
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/pipeline/builder.js.map

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

package/dist/pipeline/context.d.ts

@@ -1,21 +1,48 @@
-export type SlotKey = string & {
-    readonly __brand: unique symbol;
-};
-export declare const createSlotKey: <T = unknown>(key: string) => SlotKey;
+import { SlotKey, PipelineError, ClientConfig, ExecutionMetadata, PhaseExecution } from '../types/common';
+export interface SerializedContext {
+    slots: Record<string, unknown>;
+    errors: readonly PipelineError[];
+    warnings: readonly string[];
+    metadata: ExecutionMetadata;
+}
 export interface PipelineContext {
-    readonly slots: Map<SlotKey, unknown>;
-    readonly config: Record<string, unknown>;
-    get<T>(key: SlotKey): T | undefined;
-    require<T>(key: SlotKey): T;
-    set<T>(key: SlotKey, value: T): PipelineContext;
+    readonly slots: ReadonlyMap<SlotKey<any>, unknown>;
+    readonly errors: readonly PipelineError[];
+    readonly warnings: readonly string[];
+    readonly metadata: ExecutionMetadata;
+    readonly config: ClientConfig;
+    get<T>(key: SlotKey<T>): T | undefined;
+    require<T>(key: SlotKey<T>): T;
+    has(key: SlotKey<any>): boolean;
+    set<T>(key: SlotKey<T>, value: T): PipelineContext;
+    delete(key: SlotKey<any>): PipelineContext;
+    addError(error: PipelineError): PipelineContext;
+    addWarning(message: string): PipelineContext;
+    updateMetadata(update: Partial<ExecutionMetadata>): PipelineContext;
+    startPhase(phaseName: string): PipelineContext;
+    completePhase(phaseName: string, status: PhaseExecution['status'], error?: PipelineError): PipelineContext;
+    toJSON(): SerializedContext;
+    clone(): PipelineContext;
 }
 export declare class PipelineContextImpl implements PipelineContext {
-    readonly slots: Map<SlotKey, unknown>;
-    readonly config: Record<string, unknown>;
-    constructor(slots: Map<SlotKey, unknown>, config: Record<string, unknown>);
-    get<T>(key: SlotKey): T | undefined;
-    require<T>(key: SlotKey): T;
-    set<T>(key: SlotKey, value: T): PipelineContext;
+    readonly slots: ReadonlyMap<SlotKey<any>, unknown>;
+    readonly errors: readonly PipelineError[];
+    readonly warnings: readonly string[];
+    readonly metadata: ExecutionMetadata;
+    readonly config: ClientConfig;
+    constructor(slots: ReadonlyMap<SlotKey<any>, unknown>, errors: readonly PipelineError[], warnings: readonly string[], metadata: ExecutionMetadata, config: ClientConfig);
+    get<T>(key: SlotKey<T>): T | undefined;
+    require<T>(key: SlotKey<T>): T;
+    has(key: SlotKey<any>): boolean;
+    set<T>(key: SlotKey<T>, value: T): PipelineContext;
+    delete(key: SlotKey<any>): PipelineContext;
+    addError(error: PipelineError): PipelineContext;
+    addWarning(message: string): PipelineContext;
+    updateMetadata(update: Partial<ExecutionMetadata>): PipelineContext;
+    startPhase(phaseName: string): PipelineContext;
+    completePhase(phaseName: string, status: PhaseExecution['status'], error?: PipelineError): PipelineContext;
+    clone(): PipelineContext;
+    toJSON(): SerializedContext;
 }
-export declare function createContext(config: Record<string, unknown>): PipelineContext;
+export declare function createContext(config: ClientConfig): PipelineContext;
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,MAAM,CAAA;CAAE,CAAC;AAEnE,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,KAAG,OAAyB,CAAC;AAEnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS,CAAC;IACpC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC;IAC5B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC;CACjD;AAED,qBAAa,mBAAoB,YAAW,eAAe;aAEvC,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;aAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAD/B,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,EAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGjD,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC,GAAG,SAAS;IAInC,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,GAAG,CAAC;IAQ3B,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe;CAKhD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAE9E"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/context.js

@@ -1,14 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PipelineContextImpl = exports.createSlotKey = void 0;
+exports.PipelineContextImpl = void 0;
 exports.createContext = createContext;
-const createSlotKey = (key) => key;
-exports.createSlotKey = createSlotKey;
 class PipelineContextImpl {
     slots;
+    errors;
+    warnings;
+    metadata;
     config;
-    constructor(slots, config) {
+    constructor(slots, errors, warnings, metadata, config) {
         this.slots = slots;
+        this.errors = errors;
+        this.warnings = warnings;
+        this.metadata = metadata;
         this.config = config;
     }
     get(key) {
@@ -17,18 +21,87 @@ class PipelineContextImpl {
     require(key) {
         const value = this.get(key);
         if (value === undefined) {
-            throw new Error(`Required slot "${key}" not found`);
+            throw new Error(`Required slot "${key}" is not present in context`);
         }
         return value;
     }
+    has(key) {
+        return this.slots.has(key);
+    }
     set(key, value) {
         const newSlots = new Map(this.slots);
         newSlots.set(key, value);
-        return new PipelineContextImpl(newSlots, this.config);
+        return new PipelineContextImpl(newSlots, this.errors, this.warnings, this.metadata, this.config);
+    }
+    delete(key) {
+        const newSlots = new Map(this.slots);
+        newSlots.delete(key);
+        return new PipelineContextImpl(newSlots, this.errors, this.warnings, this.metadata, this.config);
+    }
+    addError(error) {
+        return new PipelineContextImpl(this.slots, [...this.errors, error], this.warnings, this.metadata, this.config);
+    }
+    addWarning(message) {
+        return new PipelineContextImpl(this.slots, this.errors, [...this.warnings, message], this.metadata, this.config);
+    }
+    updateMetadata(update) {
+        return new PipelineContextImpl(this.slots, this.errors, this.warnings, { ...this.metadata, ...update }, this.config);
+    }
+    startPhase(phaseName) {
+        const execution = {
+            phaseName,
+            startedAt: new Date(),
+            status: 'running',
+            slotsRead: [],
+            slotsWritten: [],
+        };
+        return this.updateMetadata({
+            currentPhase: phaseName,
+            phaseHistory: [...this.metadata.phaseHistory, execution],
+        });
+    }
+    completePhase(phaseName, status, error) {
+        const history = [...this.metadata.phaseHistory];
+        const currentPhaseIndex = history.findIndex(h => h.phaseName === phaseName && h.status === 'running');
+        if (currentPhaseIndex === -1) {
+            // Graceful handling if phase wasn't tracked as running
+            return this;
+        }
+        const currentPhase = history[currentPhaseIndex];
+        const completedAt = new Date();
+        const duration = completedAt.getTime() - currentPhase.startedAt.getTime();
+        history[currentPhaseIndex] = {
+            ...currentPhase,
+            completedAt,
+            duration,
+            status,
+            error,
+        };
+        return this.updateMetadata({
+            currentPhase: undefined,
+            phaseHistory: history,
+        });
+    }
+    clone() {
+        return new PipelineContextImpl(new Map(this.slots), [...this.errors], [...this.warnings], { ...this.metadata, phaseHistory: [...this.metadata.phaseHistory] }, this.config);
+    }
+    toJSON() {
+        return {
+            slots: Object.fromEntries(this.slots),
+            errors: this.errors,
+            warnings: this.warnings,
+            metadata: this.metadata,
+        };
     }
 }
 exports.PipelineContextImpl = PipelineContextImpl;
 function createContext(config) {
-    return new PipelineContextImpl(new Map(), config);
+    return new PipelineContextImpl(new Map(), [], [], {
+        pipelineId: config.clientId,
+        executionId: `exec_${Date.now()}`,
+        traceId: `trace_${Date.now()}_${Math.random().toString(36).slice(2, 7)}`,
+        startedAt: new Date(),
+        phaseHistory: [],
+    }, config);
 }
 //# sourceMappingURL=context.js.map

package/dist/pipeline/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":";;;AAsCA,sCAEC;AAtCM,MAAM,aAAa,GAAG,CAAc,GAAW,EAAW,EAAE,CAAC,GAAc,CAAC;AAAtE,QAAA,aAAa,iBAAyD;AAWnF,MAAa,mBAAmB;IAEZ;IACA;IAFlB,YACkB,KAA4B,EAC5B,MAA+B;QAD/B,UAAK,GAAL,KAAK,CAAuB;QAC5B,WAAM,GAAN,MAAM,CAAyB;IAC9C,CAAC;IAEJ,GAAG,CAAI,GAAY;QACjB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAkB,CAAC;IAC9C,CAAC;IAED,OAAO,CAAI,GAAY;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,aAAa,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,GAAG,CAAI,GAAY,EAAE,KAAQ;QAC3B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;CACF;AAvBD,kDAuBC;AAED,SAAgB,aAAa,CAAC,MAA+B;IAC3D,OAAO,IAAI,mBAAmB,CAAC,IAAI,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/pipeline/context.ts"],"names":[],"mappings":"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"}

package/dist/pipeline/executor.d.ts

@@ -0,0 +1,24 @@
+import { Phase } from './phase';
+import { PipelineContext } from './context';
+import { PipelineError } from '../types/common';
+export interface PipelineResult {
+    success: boolean;
+    skipped?: boolean;
+    reason?: string;
+    error?: PipelineError;
+    context: PipelineContext;
+    executedPhases: string[];
+    duration: number;
+}
+export type ErrorHandler = (ctx: PipelineContext, error: PipelineError) => Promise<'continue' | 'halt' | 'retry'>;
+export declare class Pipeline {
+    private phases;
+    private errorHandlers;
+    constructor(phases: Phase[], errorHandlers: Map<string, ErrorHandler>);
+    execute(initialCtx: PipelineContext): Promise<PipelineResult>;
+    private validateRequirements;
+    private handleError;
+    private rollback;
+    private toPipelineError;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/pipeline/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/pipeline/executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AAExE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,GAAG,EAAE,eAAe,EACpB,KAAK,EAAE,aAAa,KACjB,OAAO,CAAC,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;AAe5C,qBAAa,QAAQ;IAEjB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,aAAa;gBADb,MAAM,EAAE,KAAK,EAAE,EACf,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAG5C,OAAO,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAqEnE,OAAO,CAAC,oBAAoB;YAad,WAAW;YAaX,QAAQ;IAgBtB,OAAO,CAAC,eAAe;CAmBxB"}

package/dist/pipeline/executor.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pipeline = void 0;
+const common_1 = require("../types/common");
+// Error class for explicit phase errors
+class PhaseError extends Error {
+    phase;
+    code;
+    recoverable;
+    constructor(phase, code, message, recoverable) {
+        super(message);
+        this.phase = phase;
+        this.code = code;
+        this.recoverable = recoverable;
+        this.name = 'PhaseError';
+    }
+}
+class Pipeline {
+    phases;
+    errorHandlers;
+    constructor(phases, errorHandlers) {
+        this.phases = phases;
+        this.errorHandlers = errorHandlers;
+    }
+    async execute(initialCtx) {
+        const startTime = Date.now();
+        let ctx = initialCtx;
+        const executed = [];
+        for (let i = 0; i < this.phases.length; i++) {
+            const phase = this.phases[i];
+            ctx = ctx.startPhase(phase.name);
+            try {
+                if (phase.shouldSkip && await phase.shouldSkip(ctx)) {
+                    ctx = ctx.completePhase(phase.name, 'skipped');
+                    continue;
+                }
+                this.validateRequirements(ctx, phase);
+                // Execute
+                ctx = await phase.execute(ctx);
+                executed.push(phase.name);
+                ctx = ctx.completePhase(phase.name, 'completed');
+                // Check for halt signal
+                const haltKey = (0, common_1.createSlotKey)('control.shouldHalt');
+                const reasonKey = (0, common_1.createSlotKey)('control.haltReason');
+                if (ctx.has(haltKey)) {
+                    return {
+                        success: true,
+                        skipped: true,
+                        reason: ctx.get(reasonKey) ?? 'Pipeline halted',
+                        context: ctx,
+                        executedPhases: executed,
+                        duration: Date.now() - startTime,
+                    };
+                }
+            }
+            catch (error) {
+                const pipelineError = this.toPipelineError(error, phase.name);
+                ctx = ctx.addError(pipelineError);
+                ctx = ctx.completePhase(phase.name, 'failed', pipelineError);
+                const decision = await this.handleError(ctx, pipelineError);
+                if (decision === 'halt') {
+                    await this.rollback(ctx, executed);
+                    return {
+                        success: false,
+                        error: pipelineError,
+                        context: ctx,
+                        executedPhases: executed,
+                        duration: Date.now() - startTime,
+                    };
+                }
+                else if (decision === 'retry') {
+                    i--; // Simple retry
+                    continue;
+                }
+            }
+        }
+        return {
+            success: true,
+            context: ctx,
+            executedPhases: executed,
+            duration: Date.now() - startTime,
+        };
+    }
+    validateRequirements(ctx, phase) {
+        for (const req of phase.requires) {
+            if (!ctx.has(req)) {
+                throw new PhaseError(phase.name, 'MISSING_REQUIREMENT', `Required slot "${String(req)}" is not present`, false);
+            }
+        }
+    }
+    async handleError(ctx, error) {
+        const phaseHandler = this.errorHandlers.get(error.phase);
+        if (phaseHandler)
+            return phaseHandler(ctx, error);
+        const codeHandler = this.errorHandlers.get(error.code);
+        if (codeHandler)
+            return codeHandler(ctx, error);
+        return error.recoverable ? 'continue' : 'halt';
+    }
+    async rollback(ctx, executed) {
+        const lastError = ctx.errors[ctx.errors.length - 1];
+        const reverseExecuted = [...executed].reverse();
+        for (const phaseName of reverseExecuted) {
+            const phase = this.phases.find(p => p.name === phaseName);
+            if (phase?.rollback) {
+                try {
+                    await phase.rollback(ctx, lastError);
+                }
+                catch (e) {
+                    console.error(`Rollback failed for ${phaseName}`, e);
+                }
+            }
+        }
+    }
+    toPipelineError(error, phaseName) {
+        if (error instanceof PhaseError) {
+            return {
+                phase: error.phase,
+                code: error.code,
+                message: error.message,
+                recoverable: error.recoverable
+            };
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            phase: phaseName,
+            code: 'UNKNOWN_ERROR',
+            message,
+            recoverable: false,
+            cause: error,
+            timestamp: new Date()
+        };
+    }
+}
+exports.Pipeline = Pipeline;
+//# sourceMappingURL=executor.js.map

package/dist/pipeline/executor.js.map

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

package/dist/pipeline/middleware.d.ts

@@ -0,0 +1,26 @@
+import { Phase } from './phase';
+import { PipelineContext } from './context';
+import { PipelineError } from '../types/common';
+export type NextFn = (ctx: PipelineContext) => Promise<PipelineContext>;
+export type PhaseMiddleware = (ctx: PipelineContext, next: NextFn) => Promise<PipelineContext>;
+export declare class ComposablePhase implements Phase {
+    private inner;
+    private middlewares;
+    constructor(inner: Phase);
+    get name(): string;
+    get description(): string;
+    get requires(): import("../types/common").SlotKey[];
+    get produces(): import("../types/common").SlotKey[];
+    get optionalReads(): import("../types/common").SlotKey[] | undefined;
+    get dependsOn(): string[] | undefined;
+    get tags(): string[] | undefined;
+    use(middleware: PhaseMiddleware): this;
+    before(hook: (ctx: PipelineContext) => Promise<PipelineContext>): this;
+    after(hook: (ctx: PipelineContext) => Promise<PipelineContext>): this;
+    execute(ctx: PipelineContext): Promise<PipelineContext>;
+    shouldSkip(ctx: PipelineContext): Promise<boolean>;
+    rollback(ctx: PipelineContext, error: PipelineError): Promise<void>;
+}
+export declare function composable(phase: Phase): ComposablePhase;
+export declare function composeMiddlewares(...middlewares: PhaseMiddleware[]): PhaseMiddleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/pipeline/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/pipeline/middleware.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;AAExE,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,eAAe,CAAC,CAAC;AAE9B,qBAAa,eAAgB,YAAW,KAAK;IAG/B,OAAO,CAAC,KAAK;IAFzB,OAAO,CAAC,WAAW,CAAyB;gBAExB,KAAK,EAAE,KAAK;IAGhC,IAAI,IAAI,WAA8B;IACtC,IAAI,WAAW,WAAqC;IACpD,IAAI,QAAQ,wCAAkC;IAC9C,IAAI,QAAQ,wCAAkC;IAC9C,IAAI,aAAa,oDAAuC;IACxD,IAAI,SAAS,yBAAmC;IAChD,IAAI,IAAI,yBAA8B;IAEtC,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAMtC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAQtE,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAO/D,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAgBvD,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAIlD,QAAQ,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;CAK1E;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,eAAe,CAExD;AAGD,wBAAgB,kBAAkB,CAAC,GAAG,WAAW,EAAE,eAAe,EAAE,GAAG,eAAe,CAQrF"}

package/dist/pipeline/middleware.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComposablePhase = void 0;
+exports.composable = composable;
+exports.composeMiddlewares = composeMiddlewares;
+class ComposablePhase {
+    inner;
+    middlewares = [];
+    constructor(inner) {
+        this.inner = inner;
+    }
+    // Delegate metadata to inner phase
+    get name() { return this.inner.name; }
+    get description() { return this.inner.description; }
+    get requires() { return this.inner.requires; }
+    get produces() { return this.inner.produces; }
+    get optionalReads() { return this.inner.optionalReads; }
+    get dependsOn() { return this.inner.dependsOn; }
+    get tags() { return this.inner.tags; }
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    // Syntactic sugar for "Before" middleware
+    before(hook) {
+        return this.use(async (ctx, next) => {
+            const modified = await hook(ctx);
+            return next(modified);
+        });
+    }
+    // Syntactic sugar for "After" middleware
+    after(hook) {
+        return this.use(async (ctx, next) => {
+            const result = await next(ctx);
+            return hook(result);
+        });
+    }
+    async execute(ctx) {
+        // 1. The innermost function is the actual phase execution
+        const executeInner = (c) => this.inner.execute(c);
+        // 2. Reduce the middlewares into a single execution function
+        // explicit generic <NextFn> fixes the type inference error
+        const chain = this.middlewares.reduceRight((next, middleware) => (c) => middleware(c, next), executeInner);
+        // 3. Execute the chain
+        return chain(ctx);
+    }
+    // Delegate optional methods
+    async shouldSkip(ctx) {
+        return this.inner.shouldSkip ? await this.inner.shouldSkip(ctx) : false;
+    }
+    async rollback(ctx, error) {
+        if (this.inner.rollback) {
+            await this.inner.rollback(ctx, error);
+        }
+    }
+}
+exports.ComposablePhase = ComposablePhase;
+// Factory function
+function composable(phase) {
+    return new ComposablePhase(phase);
+}
+// Utility to combine multiple middlewares into one
+function composeMiddlewares(...middlewares) {
+    return async (ctx, next) => {
+        const chain = middlewares.reduceRight((nextFn, middleware) => (c) => middleware(c, nextFn), next);
+        return chain(ctx);
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/pipeline/middleware.js.map

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

package/dist/pipeline/phase.d.ts

@@ -1,17 +1,39 @@
-import { PipelineContext, SlotKey } from './context';
-export interface Phase {
+import { PipelineContext } from './context';
+import { SlotKey, PipelineError } from '../types/common';
+export interface PhaseContract {
     readonly name: string;
     readonly description: string;
     readonly requires: SlotKey[];
     readonly produces: SlotKey[];
+    readonly optionalReads?: SlotKey[];
+    readonly dependsOn?: string[];
+    readonly tags?: string[];
+}
+export interface Phase extends PhaseContract {
     execute(ctx: PipelineContext): Promise<PipelineContext>;
+    shouldSkip?(ctx: PipelineContext): Promise<boolean>;
+    rollback?(ctx: PipelineContext, error: PipelineError): Promise<void>;
 }
 export declare abstract class BasePhase implements Phase {
     abstract readonly name: string;
     abstract readonly description: string;
     abstract readonly requires: SlotKey[];
     abstract readonly produces: SlotKey[];
+    readonly optionalReads?: SlotKey[];
+    readonly dependsOn?: string[];
+    readonly tags?: string[];
     abstract execute(ctx: PipelineContext): Promise<PipelineContext>;
-    protected fail(code: string, message: string): never;
+    shouldSkip?(ctx: PipelineContext): Promise<boolean>;
+    rollback?(ctx: PipelineContext, error: PipelineError): Promise<void>;
+    protected fail(code: string, message: string, recoverable?: boolean, data?: Record<string, unknown>): never;
+    protected warn(ctx: PipelineContext, message: string): PipelineContext;
+}
+export declare class PhaseError extends Error implements PipelineError {
+    readonly phase: string;
+    readonly code: string;
+    readonly recoverable: boolean;
+    readonly data?: Record<string, unknown> | undefined;
+    readonly cause?: Error | undefined;
+    constructor(phase: string, code: string, message: string, recoverable: boolean, data?: Record<string, unknown> | undefined, cause?: Error | undefined);
 }
 //# sourceMappingURL=phase.d.ts.map

package/dist/pipeline/phase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAE7B,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACzD;AAED,8BAAsB,SAAU,YAAW,KAAK;IAC9C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAEhE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK;CAGrD"}
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,KAAM,SAAQ,aAAa;IAC1C,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACxD,UAAU,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,8BAAsB,SAAU,YAAW,KAAK;IAC9C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAEtC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAE1D,UAAU,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAInD,QAAQ,CAAC,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,SAAS,CAAC,IAAI,CACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,WAAW,UAAQ,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,KAAK;IAIR,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe;CAGvE;AAED,qBAAa,UAAW,SAAQ,KAAM,YAAW,aAAa;aAE1C,KAAK,EAAE,MAAM;aACb,IAAI,EAAE,MAAM;aAEZ,WAAW,EAAE,OAAO;aACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;aAC9B,KAAK,CAAC,EAAE,KAAK;gBALb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,OAAO,EACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EAC9B,KAAK,CAAC,EAAE,KAAK,YAAA;CAMhC"}

package/dist/pipeline/phase.js

@@ -1,10 +1,40 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BasePhase = void 0;
+exports.PhaseError = exports.BasePhase = void 0;
 class BasePhase {
-    fail(code, message) {
-        throw new Error(`[${this.name}] ${code}: ${message}`);
+    optionalReads;
+    dependsOn;
+    tags;
+    async shouldSkip(ctx) {
+        return false;
+    }
+    async rollback(ctx, error) {
+        // Default: no rollback action
+    }
+    fail(code, message, recoverable = false, data) {
+        throw new PhaseError(this.name, code, message, recoverable, data);
+    }
+    warn(ctx, message) {
+        return ctx.addWarning(`[${this.name}] ${message}`);
     }
 }
 exports.BasePhase = BasePhase;
+class PhaseError extends Error {
+    phase;
+    code;
+    recoverable;
+    data;
+    cause;
+    constructor(phase, code, message, recoverable, data, cause) {
+        super(message);
+        this.phase = phase;
+        this.code = code;
+        this.recoverable = recoverable;
+        this.data = data;
+        this.cause = cause;
+        this.name = 'PhaseError';
+        Object.setPrototypeOf(this, PhaseError.prototype);
+    }
+}
+exports.PhaseError = PhaseError;
 //# sourceMappingURL=phase.js.map

package/dist/pipeline/phase.js.map

@@ -1 +1 @@
-{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":";;;AAWA,MAAsB,SAAS;IAQnB,IAAI,CAAC,IAAY,EAAE,OAAe;QAC1C,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;CACF;AAXD,8BAWC"}
+{"version":3,"file":"phase.js","sourceRoot":"","sources":["../../src/pipeline/phase.ts"],"names":[],"mappings":";;;AAsBA,MAAsB,SAAS;IAMpB,aAAa,CAAa;IAC1B,SAAS,CAAY;IACrB,IAAI,CAAY;IAIzB,KAAK,CAAC,UAAU,CAAE,GAAoB;QACpC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ,CAAE,GAAoB,EAAE,KAAoB;QACxD,8BAA8B;IAChC,CAAC;IAES,IAAI,CACZ,IAAY,EACZ,OAAe,EACf,WAAW,GAAG,KAAK,EACnB,IAA8B;QAE9B,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;IACpE,CAAC;IAES,IAAI,CAAC,GAAoB,EAAE,OAAe;QAClD,OAAO,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;CACF;AAhCD,8BAgCC;AAED,MAAa,UAAW,SAAQ,KAAK;IAEjB;IACA;IAEA;IACA;IACA;IANlB,YACkB,KAAa,EACb,IAAY,EAC5B,OAAe,EACC,WAAoB,EACpB,IAA8B,EAC9B,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAPC,UAAK,GAAL,KAAK,CAAQ;QACb,SAAI,GAAJ,IAAI,CAAQ;QAEZ,gBAAW,GAAX,WAAW,CAAS;QACpB,SAAI,GAAJ,IAAI,CAA0B;QAC9B,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAbD,gCAaC"}

package/dist/registry/phase-registry.d.ts

@@ -0,0 +1,24 @@
+import { Phase, PhaseContract } from '../pipeline/phase';
+export type PhaseFactory = (config?: Record<string, unknown>) => Phase;
+export declare class PhaseRegistry {
+    private phases;
+    private tagIndex;
+    private metadata;
+    register(name: string, factory: PhaseFactory, metadata?: PhaseMetadata): this;
+    get(name: string, config?: Record<string, unknown>): Phase;
+    has(name: string): boolean;
+    findByTags(...tags: string[]): Phase[];
+    list(): string[];
+    listByTag(tag: string): string[];
+    describe(name: string): PhaseContract & PhaseMetadata | undefined;
+    describeAll(): Array<PhaseContract & PhaseMetadata>;
+}
+export interface PhaseMetadata {
+    tags?: string[];
+    category?: string;
+    author?: string;
+    version?: string;
+    deprecated?: boolean;
+    deprecationMessage?: string;
+}
+//# sourceMappingURL=phase-registry.d.ts.map

package/dist/registry/phase-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-registry.d.ts","sourceRoot":"","sources":["../../src/registry/phase-registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC;AAEvE,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,QAAQ,CAAoC;IAEpD,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,QAAQ,GAAE,aAAkB,GAC3B,IAAI;IAeP,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK;IAQ1D,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,UAAU,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE;IAWtC,IAAI,IAAI,MAAM,EAAE;IAIhB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE;IAIhC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS;IAmBjE,WAAW,IAAI,KAAK,CAAC,aAAa,GAAG,aAAa,CAAC;CAGpD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/registry/phase-registry.js

@@ -0,0 +1,69 @@
+"use strict";
+// ============================================================================
+// packages/core/src/registry/phase-registry.ts
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhaseRegistry = void 0;
+class PhaseRegistry {
+    phases = new Map();
+    tagIndex = new Map();
+    metadata = new Map();
+    register(name, factory, metadata = {}) {
+        this.phases.set(name, factory);
+        this.metadata.set(name, metadata);
+        // Index by tags
+        for (const tag of metadata.tags ?? []) {
+            if (!this.tagIndex.has(tag)) {
+                this.tagIndex.set(tag, new Set());
+            }
+            this.tagIndex.get(tag).add(name);
+        }
+        return this;
+    }
+    get(name, config) {
+        const factory = this.phases.get(name);
+        if (!factory) {
+            throw new Error(`Phase "${name}" not found in registry`);
+        }
+        return factory(config);
+    }
+    has(name) {
+        return this.phases.has(name);
+    }
+    findByTags(...tags) {
+        if (tags.length === 0)
+            return [];
+        const matchingSets = tags.map(t => this.tagIndex.get(t) ?? new Set());
+        const intersection = matchingSets.reduce((acc, set) => new Set([...acc].filter(x => set.has(x))));
+        return [...intersection].map(name => this.get(name));
+    }
+    list() {
+        return [...this.phases.keys()];
+    }
+    listByTag(tag) {
+        return [...(this.tagIndex.get(tag) ?? [])];
+    }
+    describe(name) {
+        const factory = this.phases.get(name);
+        const metadata = this.metadata.get(name);
+        if (!factory)
+            return undefined;
+        // Create instance to read contract
+        const instance = factory({});
+        return {
+            name: instance.name,
+            description: instance.description,
+            requires: instance.requires,
+            produces: instance.produces,
+            optionalReads: instance.optionalReads,
+            dependsOn: instance.dependsOn,
+            tags: instance.tags,
+            ...metadata,
+        };
+    }
+    describeAll() {
+        return this.list().map(name => this.describe(name)).filter(Boolean);
+    }
+}
+exports.PhaseRegistry = PhaseRegistry;
+//# sourceMappingURL=phase-registry.js.map

package/dist/registry/phase-registry.js.map

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

package/dist/slots/well-known-slots.d.ts

@@ -0,0 +1,27 @@
+export interface ValidationIssue {
+    field: string;
+    code: string;
+    message: string;
+    severity: 'error' | 'warning';
+}
+export interface SourceMetadata {
+    system: string;
+    originalId: string;
+    fetchedAt: Date;
+    version?: string;
+}
+/**
+ * Core Infrastructure Slots
+ */
+export declare const CoreSlots: {
+    readonly SOURCE_RAW: import("../types/common").SlotKey<unknown>;
+    readonly SOURCE_METADATA: import("../types/common").SlotKey<SourceMetadata>;
+    readonly TARGET_PAYLOAD: import("../types/common").SlotKey<unknown>;
+    readonly TARGET_RESPONSE: import("../types/common").SlotKey<unknown>;
+    readonly CONTROL_SHOULD_HALT: import("../types/common").SlotKey<boolean>;
+    readonly CONTROL_HALT_REASON: import("../types/common").SlotKey<string>;
+    readonly CONTROL_DRY_RUN: import("../types/common").SlotKey<boolean>;
+    readonly PROCESSING_BATCH_ID: import("../types/common").SlotKey<string>;
+    readonly VALIDATION_ISSUES: import("../types/common").SlotKey<ValidationIssue[]>;
+};
+//# sourceMappingURL=well-known-slots.d.ts.map

package/dist/slots/well-known-slots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-slots.d.ts","sourceRoot":"","sources":["../../src/slots/well-known-slots.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;CA0BZ,CAAC"}

package/dist/slots/well-known-slots.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoreSlots = void 0;
+const common_1 = require("../types/common");
+/**
+ * Core Infrastructure Slots
+ */
+exports.CoreSlots = {
+    // ─────────────────────────────────────
+    // GENERIC SOURCE DATA
+    // ─────────────────────────────────────
+    SOURCE_RAW: (0, common_1.createSlotKey)('source.raw'),
+    SOURCE_METADATA: (0, common_1.createSlotKey)('source.metadata'),
+    // ─────────────────────────────────────
+    // GENERIC TARGET DATA
+    // ─────────────────────────────────────
+    TARGET_PAYLOAD: (0, common_1.createSlotKey)('target.payload'),
+    TARGET_RESPONSE: (0, common_1.createSlotKey)('target.response'),
+    // ─────────────────────────────────────
+    // CONTROL FLOW & META
+    // ─────────────────────────────────────
+    CONTROL_SHOULD_HALT: (0, common_1.createSlotKey)('control.shouldHalt'),
+    CONTROL_HALT_REASON: (0, common_1.createSlotKey)('control.haltReason'),
+    CONTROL_DRY_RUN: (0, common_1.createSlotKey)('control.dryRun'),
+    PROCESSING_BATCH_ID: (0, common_1.createSlotKey)('processing.batchId'),
+    // ─────────────────────────────────────
+    // VALIDATION
+    // ─────────────────────────────────────
+    VALIDATION_ISSUES: (0, common_1.createSlotKey)('validation.issues'),
+};
+//# sourceMappingURL=well-known-slots.js.map

package/dist/slots/well-known-slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"well-known-slots.js","sourceRoot":"","sources":["../../src/slots/well-known-slots.ts"],"names":[],"mappings":";;;AAAA,4CAAgD;AAiBhD;;GAEG;AACU,QAAA,SAAS,GAAG;IACvB,wCAAwC;IACxC,sBAAsB;IACtB,wCAAwC;IACxC,UAAU,EAAE,IAAA,sBAAa,EAAU,YAAY,CAAC;IAChD,eAAe,EAAE,IAAA,sBAAa,EAAiB,iBAAiB,CAAC;IAEjE,wCAAwC;IACxC,sBAAsB;IACtB,wCAAwC;IACxC,cAAc,EAAE,IAAA,sBAAa,EAAU,gBAAgB,CAAC;IACxD,eAAe,EAAE,IAAA,sBAAa,EAAU,iBAAiB,CAAC;IAE1D,wCAAwC;IACxC,sBAAsB;IACtB,wCAAwC;IACxC,mBAAmB,EAAE,IAAA,sBAAa,EAAU,oBAAoB,CAAC;IACjE,mBAAmB,EAAE,IAAA,sBAAa,EAAS,oBAAoB,CAAC;IAChE,eAAe,EAAE,IAAA,sBAAa,EAAU,gBAAgB,CAAC;IAEzD,mBAAmB,EAAE,IAAA,sBAAa,EAAS,oBAAoB,CAAC;IAEhE,wCAAwC;IACxC,aAAa;IACb,wCAAwC;IACxC,iBAAiB,EAAE,IAAA,sBAAa,EAAoB,mBAAmB,CAAC;CAChE,CAAC"}

package/dist/types/common.d.ts

@@ -0,0 +1,45 @@
+export type SlotKey<T = unknown> = string & {
+    __brand: 'SlotKey';
+    __type: T;
+};
+/**
+ * Creates a typed slot key.
+ * Usage: const MY_SLOT = createSlotKey<MyType>('my-slot');
+ */
+export declare const createSlotKey: <T = unknown>(key: string) => SlotKey<T>;
+export interface ClientConfig {
+    clientId: string;
+    environment: 'dev' | 'staging' | 'prod';
+    features?: Record<string, boolean>;
+    settings?: Record<string, unknown>;
+}
+export interface PipelineError {
+    phase: string;
+    code: string;
+    message: string;
+    recoverable: boolean;
+    data?: Record<string, unknown>;
+    cause?: unknown;
+    stack?: string;
+    timestamp?: Date;
+}
+export interface PhaseExecution {
+    phaseName: string;
+    startedAt: Date;
+    completedAt?: Date;
+    duration?: number;
+    status: 'running' | 'completed' | 'skipped' | 'failed';
+    error?: PipelineError;
+    slotsRead: string[];
+    slotsWritten: string[];
+}
+export interface ExecutionMetadata {
+    pipelineId: string;
+    executionId: string;
+    traceId: string;
+    startedAt: Date;
+    phaseHistory: PhaseExecution[];
+    currentPhase?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=common.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,GAAG;IAC1C,OAAO,EAAE,SAAS,CAAC;IACnB,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,GAAG,OAAO,EAAE,KAAK,MAAM,KAAG,OAAO,CAAC,CAAC,CACpC,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvD,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types/common.js

@@ -0,0 +1,11 @@
+"use strict";
+// packages/core/src/types/common.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSlotKey = void 0;
+/**
+ * Creates a typed slot key.
+ * Usage: const MY_SLOT = createSlotKey<MyType>('my-slot');
+ */
+const createSlotKey = (key) => key;
+exports.createSlotKey = createSlotKey;
+//# sourceMappingURL=common.js.map

package/dist/types/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/types/common.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;AAYpC;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAc,GAAW,EAAc,EAAE,CACpE,GAA4B,CAAC;AADlB,QAAA,aAAa,iBACK"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tonytang99/integration-core",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Core pipeline framework for integration platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",