@x12i/memorix-pipeline-orchestrator 1.0.0

package/README.md

@@ -0,0 +1,99 @@
+# `@x12i/memorix-pipeline-orchestrator`
+
+Generic **pipeline step** contract, Catalox-backed registry, and run/execute engine for Memorix.
+
+A step is the atomic unit of pipeline work (connector / data / AI). The same shape covers fetch workers, transforms, and AI services — aligned with `@x12i/memorix-pipeline-services` taxonomy.
+
+## Capabilities
+
+| Layer | What |
+|-------|------|
+| Types + validation + graph | `PipelineStep`, `validatePipelineStepGraph`, `topologicalOrder` |
+| Registry | Catalox catalogs for steps, templates, pipeline definitions, schedules, runs |
+| Runtime | deps → inputs → apiCalls/invoke (typed envelope) → raw → normalize → snapshot; simulation (sandbox ports); schedule ticker |
+| HTTP | Fastify on **:5187**, prefix `/api/pipeline-orchestrator` |
+
+Invoke calls to `@x12i/memorix-pipeline-services` use `PipelineServiceRequest` / `PipelineServiceResponse` (sparse envelope + per-type `payload`). See that package’s README for contracts.
+
+AI step authoring (object/content selectors, request templates, suggestions): [docs/ai-steps.md](./docs/ai-steps.md).
+
+## HTTP
+
+| Method | Path | Role |
+|--------|------|------|
+| `GET` | `/health` | health |
+| `GET/POST` | `/api/pipeline-orchestrator/steps` | list / create |
+| `GET/PUT/DELETE` | `/api/pipeline-orchestrator/steps/:stepId` | CRUD |
+| `GET/POST` | `/api/pipeline-orchestrator/templates` | list / create templates |
+| `GET/PUT/DELETE` | `/api/pipeline-orchestrator/templates/:id` | template CRUD |
+| `GET/POST` | `/api/pipeline-orchestrator/pipelines` | list / create |
+| `GET/PUT/DELETE` | `/api/pipeline-orchestrator/pipelines/:id` | CRUD (optional `templateId`) |
+| `POST` | `/api/pipeline-orchestrator/pipelines/:id/validate` | graph validate |
+| `GET/POST` | `/api/pipeline-orchestrator/schedules` | list / activate schedule |
+| `GET/PUT/DELETE` | `/api/pipeline-orchestrator/schedules/:id` | schedule CRUD |
+| `POST` | `/api/pipeline-orchestrator/runs?wait=1` | start run (`mode`: `ondemand` \| `simulation`) |
+| `GET` | `/api/pipeline-orchestrator/runs/:runId` | get run |
+| `POST` | `/api/pipeline-orchestrator/runs/:runId/cancel` | cancel |
+| `POST` | `/api/pipeline-orchestrator/runs/:runId/retry` | retry from step (`fromStepId`) |
+
+## Dev
+
+```bash
+cd memorix-pipeline-orchestrator
+npm install
+npm run dev
+```
+
+Env: same Catalox/Mongo vars as other Memorix services. Optional `PIPELINE_SERVICES_URL` (default `http://127.0.0.1:5185/api/pipeline-services`) for worker invoke. Optional `PIPELINE_ORCHESTRATOR_TOKEN` for bearer auth.
+
+## Catalogs
+
+- `memorix-pipeline-steps`
+- `memorix-pipeline-templates`
+- `memorix-pipeline-definitions`
+- `memorix-pipeline-schedules`
+- `memorix-pipeline-runs`
+
+When the HTTP server starts, an in-process schedule ticker (every 30s) fires due
+active schedules as real on-demand runs. The ticker only runs while the process
+is up.
+
+## Distinct from
+
+| Package | Role |
+|---------|------|
+| `memorix-pipeline-services` | Worker registry + HTTP invoke |
+| `memorix-pipeline` | Entity enrichment stages |
+| **this package** | Step graphs + runs |
+
+## Scripts
+
+```bash
+npm test
+npm run build
+
+# Upsert platform-smoke template + steps + pipeline (agent-platform-smoke)
+npm run seed:platform-smoke
+
+# Regenerate platform-smoke catalox-seeds JSON from src/seeds/platform-smoke.ts
+npm run generate:seed-json
+```
+
+### Integration pack orchestration seeds (external)
+
+MOVE-OUT integration pipeline steps, definitions, and templates (firewall topology,
+Cortex XDR, Tenable Nessus, vuln-analytics) live in
+`.operational/package-seed-packs/<pack-id>/` and are applied via
+`@x12i/memorix-package-seed`. See
+[`.operational/package-seed-packs/README.md`](../.operational/package-seed-packs/README.md).
+
+```bash
+cd memorix-package-seed
+node dist/cli.js validate --dir ../.operational/package-seed-packs/firewall-topology
+node dist/cli.js apply --dir ../.operational/package-seed-packs/firewall-topology --agent agent-firewall-topology
+```
+
+Platform-smoke authored source: `src/seeds/platform-smoke.ts` (also written to
+`catalox-seeds/inputs/platform-smoke-*.json` on seed/generate runs). Template
+`tpl_platform_smoke` groups the synthetic acceptance pipeline for
+`agent-platform-smoke`.

package/dist/browser.d.ts

@@ -0,0 +1,9 @@
+/** Browser-safe surface: types, validation, graph helpers only (no Node/HTTP/Catalox). */
+export { MEMORIX_PIPELINE_STEPS_CATALOG, MEMORIX_PIPELINE_DEFINITIONS_CATALOG, MEMORIX_PIPELINE_RUNS_CATALOG, MEMORIX_PIPELINE_TEMPLATES_CATALOG, MEMORIX_PIPELINE_SCHEDULES_CATALOG, } from "./catalog.js";
+export { PIPELINE_STEP_LIFECYCLE_STATUSES, type PipelineStepCategory, type PipelineStageName, type PipelineStepLifecycleStatus, type StepInputSource, type StepRequiredInput, type StepApiCall, type StepRawSaveMode, type StepRawOutput, type StepNormalizedOutput, type StepSnapshotFinalization, type StepSnapshotOutput, type StepStatusBehavior, type StepErrorBehavior, type PipelineStepInvoke, type PipelineStepRequestTemplate, type ObjectTarget, type PipelineObjectTypeRef, type PipelineStepObjectTypes, type PipelineStep, type PipelineStepGraph, type PipelineTemplate, type RegisterPipelineTemplateInput, type UpdatePipelineTemplateInput, type PipelineDefinition, type RegisterPipelineDefinitionInput, type UpdatePipelineDefinitionInput, type PipelineRunStatus, type PipelineRunMode, type StepRun, type PipelineRun, type StartPipelineRunInput, type PipelineScheduleFrequency, type PipelineScheduleStatus, type PipelineSchedule, type RegisterPipelineScheduleInput, type UpdatePipelineScheduleInput, type PipelineStepRecord, } from "./types.js";
+export { rawCollection, snapshotsCollection, contentCollection, resolveRawCollection, resolveSnapshotsCollection, } from "./collections.js";
+export { validatePipelineStep, validatePipelineStepGraph, type PipelineStepValidationIssue, type PipelineStepValidationResult, } from "./validate.js";
+export { topologicalOrder, readySteps, dependenciesSatisfied, PipelineStepGraphError, } from "./graph.js";
+export { getContextPath, setContextPath, mergeRunContext, isMissingContextValue, missingRequiredRunInputs, } from "./runtime/run-context.js";
+export { computeNextRunAt, requiredInputsForMode } from "./runtime/schedule-utils.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EACL,8BAA8B,EAC9B,oCAAoC,EACpC,6BAA6B,EAC7B,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gCAAgC,EAChC,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,EACvB,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,GAClC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/browser.js

@@ -0,0 +1,9 @@
+/** Browser-safe surface: types, validation, graph helpers only (no Node/HTTP/Catalox). */
+export { MEMORIX_PIPELINE_STEPS_CATALOG, MEMORIX_PIPELINE_DEFINITIONS_CATALOG, MEMORIX_PIPELINE_RUNS_CATALOG, MEMORIX_PIPELINE_TEMPLATES_CATALOG, MEMORIX_PIPELINE_SCHEDULES_CATALOG, } from "./catalog.js";
+export { PIPELINE_STEP_LIFECYCLE_STATUSES, } from "./types.js";
+export { rawCollection, snapshotsCollection, contentCollection, resolveRawCollection, resolveSnapshotsCollection, } from "./collections.js";
+export { validatePipelineStep, validatePipelineStepGraph, } from "./validate.js";
+export { topologicalOrder, readySteps, dependenciesSatisfied, PipelineStepGraphError, } from "./graph.js";
+export { getContextPath, setContextPath, mergeRunContext, isMissingContextValue, missingRequiredRunInputs, } from "./runtime/run-context.js";
+export { computeNextRunAt, requiredInputsForMode } from "./runtime/schedule-utils.js";
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EACL,8BAA8B,EAC9B,oCAAoC,EACpC,6BAA6B,EAC7B,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,gCAAgC,GAsCjC,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,yBAAyB,GAG1B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,cAAc,EACd,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/catalog.d.ts

@@ -0,0 +1,11 @@
+/** Catalox catalog id for pipeline step definitions. */
+export declare const MEMORIX_PIPELINE_STEPS_CATALOG = "memorix-pipeline-steps";
+/** Catalox catalog id for named pipeline definitions (ordered step ids). */
+export declare const MEMORIX_PIPELINE_DEFINITIONS_CATALOG = "memorix-pipeline-definitions";
+/** Catalox catalog id for pipeline run records. */
+export declare const MEMORIX_PIPELINE_RUNS_CATALOG = "memorix-pipeline-runs";
+/** Catalox catalog id for reusable pipeline templates (shapes). */
+export declare const MEMORIX_PIPELINE_TEMPLATES_CATALOG = "memorix-pipeline-templates";
+/** Catalox catalog id for recurring pipeline schedules. */
+export declare const MEMORIX_PIPELINE_SCHEDULES_CATALOG = "memorix-pipeline-schedules";
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,eAAO,MAAM,8BAA8B,2BAA2B,CAAC;AACvE,4EAA4E;AAC5E,eAAO,MAAM,oCAAoC,iCAAiC,CAAC;AACnF,mDAAmD;AACnD,eAAO,MAAM,6BAA6B,0BAA0B,CAAC;AACrE,mEAAmE;AACnE,eAAO,MAAM,kCAAkC,+BAA+B,CAAC;AAC/E,2DAA2D;AAC3D,eAAO,MAAM,kCAAkC,+BAA+B,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,11 @@
+/** Catalox catalog id for pipeline step definitions. */
+export const MEMORIX_PIPELINE_STEPS_CATALOG = "memorix-pipeline-steps";
+/** Catalox catalog id for named pipeline definitions (ordered step ids). */
+export const MEMORIX_PIPELINE_DEFINITIONS_CATALOG = "memorix-pipeline-definitions";
+/** Catalox catalog id for pipeline run records. */
+export const MEMORIX_PIPELINE_RUNS_CATALOG = "memorix-pipeline-runs";
+/** Catalox catalog id for reusable pipeline templates (shapes). */
+export const MEMORIX_PIPELINE_TEMPLATES_CATALOG = "memorix-pipeline-templates";
+/** Catalox catalog id for recurring pipeline schedules. */
+export const MEMORIX_PIPELINE_SCHEDULES_CATALOG = "memorix-pipeline-schedules";
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,CAAC,MAAM,8BAA8B,GAAG,wBAAwB,CAAC;AACvE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oCAAoC,GAAG,8BAA8B,CAAC;AACnF,mDAAmD;AACnD,MAAM,CAAC,MAAM,6BAA6B,GAAG,uBAAuB,CAAC;AACrE,mEAAmE;AACnE,MAAM,CAAC,MAAM,kCAAkC,GAAG,4BAA4B,CAAC;AAC/E,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kCAAkC,GAAG,4BAA4B,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { startMemorixPipelineOrchestratorHttp } from "./http/server.js";
+import { closePipelineOrchestratorStack } from "./store/stack.js";
+function loadDotEnv() {
+    const candidates = [
+        join(process.cwd(), ".env"),
+        join(process.cwd(), "..", "memorix-catalox-api", ".env"),
+        join(process.cwd(), "..", "memorix-explorer-api", ".env"),
+    ];
+    for (const path of candidates) {
+        if (!existsSync(path))
+            continue;
+        for (const line of readFileSync(path, "utf8").split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith("#"))
+                continue;
+            const eq = trimmed.indexOf("=");
+            if (eq === -1)
+                continue;
+            const key = trimmed.slice(0, eq).trim();
+            const val = trimmed.slice(eq + 1).trim();
+            if (!process.env[key]?.trim())
+                process.env[key] = val;
+        }
+    }
+}
+function resolveMonorepoRoot() {
+    if (process.env.MEMORIX_MONOREPO_ROOT?.trim())
+        return;
+    let dir = process.cwd();
+    for (let i = 0; i < 12; i++) {
+        const marker = join(dir, ".operational/PACKAGE-OWNERSHIP.md");
+        if (existsSync(marker)) {
+            process.env.MEMORIX_MONOREPO_ROOT = dir;
+            return;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+}
+loadDotEnv();
+resolveMonorepoRoot();
+const cmd = process.argv[2];
+async function main() {
+    if (cmd === "serve") {
+        const { url } = await startMemorixPipelineOrchestratorHttp();
+        console.log(`memorix-pipeline-orchestrator listening on ${url}`);
+        process.on("SIGINT", () => {
+            void closePipelineOrchestratorStack().finally(() => process.exit(0));
+        });
+        process.on("SIGTERM", () => {
+            void closePipelineOrchestratorStack().finally(() => process.exit(0));
+        });
+        return;
+    }
+    console.log("Usage: memorix-pipeline-orchestrator serve");
+    process.exit(cmd ? 1 : 0);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/collections.d.ts

@@ -0,0 +1,25 @@
+/** Derive `<objectType>-raw` collection name. */
+export declare function rawCollection(objectType: string): string;
+/** Derive `<objectType>-snapshots` collection name. */
+export declare function snapshotsCollection(objectType: string): string;
+/**
+ * Derive `<objectType>-<contentType>` collection name.
+ * `contentType` is a descriptor key without a leading hyphen.
+ */
+export declare function contentCollection(objectType: string, contentType: string): string;
+/** Resolve raw collection from step (explicit or derived). */
+export declare function resolveRawCollection(step: {
+    objectType?: string;
+    rawOutput?: {
+        collection?: string;
+    };
+}): string | undefined;
+/** Resolve snapshots / content collection from step (explicit, contentType, or snapshots). */
+export declare function resolveSnapshotsCollection(step: {
+    objectType?: string;
+    snapshotOutput?: {
+        collection?: string;
+        contentType?: string;
+    };
+}): string | undefined;
+//# sourceMappingURL=collections.d.ts.map

package/dist/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CASjF;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC,GAAG,MAAM,GAAG,SAAS,CAIrB;AAED,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,IAAI,EAAE;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE,GAAG,MAAM,GAAG,SAAS,CAOrB"}

package/dist/collections.js

@@ -0,0 +1,50 @@
+/** Derive `<objectType>-raw` collection name. */
+export function rawCollection(objectType) {
+    const ot = objectType.trim();
+    if (!ot)
+        throw new Error("objectType is required");
+    return `${ot}-raw`;
+}
+/** Derive `<objectType>-snapshots` collection name. */
+export function snapshotsCollection(objectType) {
+    const ot = objectType.trim();
+    if (!ot)
+        throw new Error("objectType is required");
+    return `${ot}-snapshots`;
+}
+/**
+ * Derive `<objectType>-<contentType>` collection name.
+ * `contentType` is a descriptor key without a leading hyphen.
+ */
+export function contentCollection(objectType, contentType) {
+    const ot = objectType.trim();
+    if (!ot)
+        throw new Error("objectType is required");
+    const key = contentType.trim();
+    if (!key)
+        throw new Error("contentType is required");
+    if (key.startsWith("-")) {
+        throw new Error(`contentType must not start with '-': ${contentType}`);
+    }
+    return `${ot}-${key}`;
+}
+/** Resolve raw collection from step (explicit or derived). */
+export function resolveRawCollection(step) {
+    if (step.rawOutput?.collection?.trim())
+        return step.rawOutput.collection.trim();
+    if (step.objectType?.trim())
+        return rawCollection(step.objectType);
+    return undefined;
+}
+/** Resolve snapshots / content collection from step (explicit, contentType, or snapshots). */
+export function resolveSnapshotsCollection(step) {
+    if (step.snapshotOutput?.collection?.trim())
+        return step.snapshotOutput.collection.trim();
+    if (step.objectType?.trim() && step.snapshotOutput?.contentType?.trim()) {
+        return contentCollection(step.objectType, step.snapshotOutput.contentType);
+    }
+    if (step.objectType?.trim())
+        return snapshotsCollection(step.objectType);
+    return undefined;
+}
+//# sourceMappingURL=collections.js.map

package/dist/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../src/collections.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACnD,OAAO,GAAG,EAAE,MAAM,CAAC;AACrB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACnD,OAAO,GAAG,EAAE,YAAY,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,WAAmB;IACvE,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACrD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,wCAAwC,WAAW,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,GAAG,EAAE,IAAI,GAAG,EAAE,CAAC;AACxB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,oBAAoB,CAAC,IAGpC;IACC,IAAI,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAChF,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE;QAAE,OAAO,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,0BAA0B,CAAC,IAG1C;IACC,IAAI,IAAI,CAAC,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1F,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC;QACxE,OAAO,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE;QAAE,OAAO,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzE,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/examples/fetch-interfaces.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineStep } from "../types.js";
+/** Connector-style step: fetch interfaces via API, then normalize + snapshot. */
+export declare const fetchInterfacesStep: PipelineStep;
+/** Data-style step: normalize vendor raw into common schema via a worker. */
+export declare const normalizeInterfacesStep: PipelineStep;
+/** Minimal auth + scopes stubs so the fetch-interfaces example graph can validate. */
+export declare const authenticateStep: PipelineStep;
+export declare const fetchDeviceIdentityStep: PipelineStep;
+export declare const fetchScopesStep: PipelineStep;
+/** Example connector + data graph for docs and tests. */
+export declare const exampleFirewallPipelineSteps: PipelineStep[];
+//# sourceMappingURL=fetch-interfaces.d.ts.map

package/dist/examples/fetch-interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-interfaces.d.ts","sourceRoot":"","sources":["../../src/examples/fetch-interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,YA2DjC,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,EAAE,YA0CrC,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,EAAE,YA0B9B,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,YA+BrC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,YA+B7B,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,4BAA4B,EAAE,YAAY,EAMtD,CAAC"}

package/dist/examples/fetch-interfaces.js

@@ -0,0 +1,206 @@
+/** Connector-style step: fetch interfaces via API, then normalize + snapshot. */
+export const fetchInterfacesStep = {
+    id: "fetch-interfaces",
+    name: "Fetch Interfaces",
+    purpose: "Fetch firewall interfaces as base topology attachment points.",
+    category: "connector",
+    serviceType: "entity-provider",
+    vendor: "generic",
+    objectType: "firewall-interfaces",
+    dependsOn: ["authenticate", "fetch-device-identity", "fetch-scopes"],
+    requiredInputs: [
+        { name: "baseUrl", source: "connector-config", required: true },
+        {
+            name: "authToken",
+            source: "step-output",
+            fromStep: "authenticate",
+            required: true,
+        },
+        {
+            name: "scope",
+            source: "step-output",
+            fromStep: "fetch-scopes",
+            required: false,
+        },
+    ],
+    apiCalls: [
+        {
+            method: "GET",
+            url: "<baseUrl>/api/v1/interfaces",
+            auth: "authToken",
+            pagination: false,
+        },
+    ],
+    rawOutput: {
+        collection: "firewall-interfaces-raw",
+        saveMode: "append",
+        includeMetadata: true,
+    },
+    normalizedOutput: {
+        enabled: true,
+        outputType: "FirewallInterface",
+    },
+    snapshotOutput: {
+        collection: "firewall-interfaces-snapshots",
+        saveMode: "snapshot",
+        finalization: "after-zone-and-routing-resolution",
+    },
+    statusBehavior: {
+        idempotent: true,
+        retryable: true,
+        partialAllowed: false,
+        completionCondition: "all-scopes-fetched",
+    },
+    errorBehavior: {
+        onApiError: "retry",
+        maxRetries: 3,
+        onMissingDependency: "block",
+        onPartialData: "mark-partial",
+        onNormalizationError: "save-raw-and-fail-normalization",
+    },
+};
+/** Data-style step: normalize vendor raw into common schema via a worker. */
+export const normalizeInterfacesStep = {
+    id: "normalize-interfaces",
+    name: "Normalize Interfaces",
+    purpose: "Convert vendor-specific interface raw payloads into FirewallInterface.",
+    category: "data",
+    serviceType: "normalizer",
+    serviceId: "firewall-interface-normalizer",
+    objectType: "firewall-interfaces",
+    dependsOn: ["fetch-interfaces"],
+    requiredInputs: [
+        {
+            name: "rawBatch",
+            source: "step-output",
+            fromStep: "fetch-interfaces",
+            required: true,
+        },
+    ],
+    invoke: {
+        serviceType: "normalizer",
+        serviceId: "firewall-interface-normalizer",
+    },
+    normalizedOutput: {
+        enabled: true,
+        mapper: "firewall-interface-normalizer",
+        outputType: "FirewallInterface",
+    },
+    snapshotOutput: {
+        saveMode: "snapshot",
+        finalization: "after-normalization",
+    },
+    statusBehavior: {
+        idempotent: true,
+        retryable: true,
+        completionCondition: "all-raw-normalized",
+    },
+    errorBehavior: {
+        onApiError: "retry",
+        maxRetries: 2,
+        onMissingDependency: "block",
+        onPartialData: "fail",
+        onNormalizationError: "fail",
+    },
+};
+/** Minimal auth + scopes stubs so the fetch-interfaces example graph can validate. */
+export const authenticateStep = {
+    id: "authenticate",
+    name: "Authenticate",
+    purpose: "Obtain an API token for the connector.",
+    category: "connector",
+    serviceType: "health-provider",
+    dependsOn: [],
+    requiredInputs: [
+        { name: "baseUrl", source: "connector-config", required: true },
+        { name: "credentials", source: "connector-config", required: true },
+    ],
+    apiCalls: [
+        { method: "POST", url: "<baseUrl>/api/auth", pagination: false },
+    ],
+    statusBehavior: {
+        idempotent: true,
+        retryable: true,
+        completionCondition: "token-issued",
+    },
+    errorBehavior: {
+        onApiError: "retry",
+        maxRetries: 3,
+        onMissingDependency: "block",
+        onPartialData: "fail",
+        onNormalizationError: "fail",
+    },
+};
+export const fetchDeviceIdentityStep = {
+    id: "fetch-device-identity",
+    name: "Fetch Device Identity",
+    purpose: "Resolve the source device id used by later fetch steps.",
+    category: "connector",
+    serviceType: "entity-provider",
+    dependsOn: ["authenticate"],
+    requiredInputs: [
+        { name: "baseUrl", source: "connector-config", required: true },
+        {
+            name: "authToken",
+            source: "step-output",
+            fromStep: "authenticate",
+            required: true,
+        },
+    ],
+    apiCalls: [
+        { method: "GET", url: "<baseUrl>/api/v1/system", auth: "authToken" },
+    ],
+    statusBehavior: {
+        idempotent: true,
+        retryable: true,
+        completionCondition: "identity-fetched",
+    },
+    errorBehavior: {
+        onApiError: "retry",
+        maxRetries: 3,
+        onMissingDependency: "block",
+        onPartialData: "fail",
+        onNormalizationError: "fail",
+    },
+};
+export const fetchScopesStep = {
+    id: "fetch-scopes",
+    name: "Fetch Scopes",
+    purpose: "List available collection scopes (VSYS/VDOM/tenants).",
+    category: "connector",
+    serviceType: "scope-provider",
+    dependsOn: ["authenticate"],
+    requiredInputs: [
+        { name: "baseUrl", source: "connector-config", required: true },
+        {
+            name: "authToken",
+            source: "step-output",
+            fromStep: "authenticate",
+            required: true,
+        },
+    ],
+    apiCalls: [
+        { method: "GET", url: "<baseUrl>/api/v1/scopes", auth: "authToken" },
+    ],
+    statusBehavior: {
+        idempotent: true,
+        retryable: true,
+        completionCondition: "scopes-listed",
+    },
+    errorBehavior: {
+        onApiError: "retry",
+        maxRetries: 3,
+        onMissingDependency: "block",
+        onPartialData: "fail",
+        onNormalizationError: "fail",
+    },
+};
+/** Example connector + data graph for docs and tests. */
+export const exampleFirewallPipelineSteps = [
+    authenticateStep,
+    fetchDeviceIdentityStep,
+    fetchScopesStep,
+    fetchInterfacesStep,
+    normalizeInterfacesStep,
+];
+//# sourceMappingURL=fetch-interfaces.js.map

package/dist/examples/fetch-interfaces.js.map

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

package/dist/graph.d.ts

@@ -0,0 +1,16 @@
+import type { PipelineStep } from "./types.js";
+export declare class PipelineStepGraphError extends Error {
+    constructor(message: string);
+}
+/**
+ * Topological order of steps (dependencies first).
+ * Throws if the graph is invalid or has a cycle.
+ */
+export declare function topologicalOrder(steps: PipelineStep[]): PipelineStep[];
+/**
+ * Steps whose dependencies are all in `completedStepIds` and that are not yet completed.
+ */
+export declare function readySteps(steps: PipelineStep[], completedStepIds: Iterable<string>): PipelineStep[];
+/** True when every dependency of `stepId` is in `completedStepIds`. */
+export declare function dependenciesSatisfied(steps: PipelineStep[], stepId: string, completedStepIds: Iterable<string>): boolean;
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAgBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CA2CtE;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EAAE,EACrB,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACjC,YAAY,EAAE,CAMhB;AAED,uEAAuE;AACvE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EAAE,EACrB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACjC,OAAO,CAKT"}