@tomflow/proflow-task-orchestration 0.1.0

package/dist/src/transitions.d.ts

@@ -0,0 +1,4 @@
+import type { NodeStatus, TaskGroupStatus, TaskStatus } from "./model.ts";
+export declare const assertTaskTransition: (from: TaskStatus, to: TaskStatus) => void;
+export declare const assertTaskGroupTransition: (from: TaskGroupStatus, to: TaskGroupStatus) => void;
+export declare const assertNodeTransition: (from: NodeStatus, to: NodeStatus) => void;

package/dist/src/transitions.js

@@ -0,0 +1,27 @@
+function assertTransition(from, to, allowed) {
+    if (!allowed[from].includes(to))
+        throw new Error(`illegal transition ${from} -> ${to}`);
+}
+const taskTransitions = {
+    PENDING: ["READY", "TERMINATED"],
+    READY: ["ACTIVE", "TERMINATED"],
+    ACTIVE: ["WAITING", "PAUSED", "FAILED", "SUCCEEDED", "TERMINATED"],
+    WAITING: ["ACTIVE", "PAUSED", "TERMINATED"],
+    FAILED: ["PAUSED", "TERMINATED"],
+    PAUSED: ["ACTIVE", "TERMINATED"],
+    SUCCEEDED: [],
+    TERMINATED: [],
+};
+const groupTransitions = { READY: ["ACTIVE"], ACTIVE: ["SUCCEEDED"], SUCCEEDED: [] };
+const nodeTransitions = {
+    PENDING: ["READY", "TERMINATED"],
+    READY: ["IN_PROGRESS", "TERMINATED"],
+    IN_PROGRESS: ["WAITING", "FAILED", "SUCCEEDED", "TERMINATED"],
+    WAITING: ["IN_PROGRESS", "TERMINATED"],
+    FAILED: ["READY", "TERMINATED"],
+    SUCCEEDED: [],
+    TERMINATED: [],
+};
+export const assertTaskTransition = (from, to) => assertTransition(from, to, taskTransitions);
+export const assertTaskGroupTransition = (from, to) => assertTransition(from, to, groupTransitions);
+export const assertNodeTransition = (from, to) => assertTransition(from, to, nodeTransitions);

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@tomflow/proflow-task-orchestration",
+  "version": "0.1.0",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": "./dist/src/index.js",
+    "./deployment/adapter": "./dist/deployment/adapter.js",
+    "./deployment/descriptor": "./dist/deployment/descriptor.js"
+  },
+  "files": [
+    "dist",
+    "proflow.module.json",
+    "conformance.json",
+    "README.md",
+    "self-install.mjs"
+  ],
+  "dependencies": {
+    "zod": "4.1.12",
+    "@tomflow/proflow-module-contract": "^0.1.0"
+  },
+  "devDependencies": {
+    "@tomflow/proflow-deployment-conformance": "^0.1.0",
+    "@tomflow/proflow-task-migration-runner": "^0.1.0",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.0"
+  },
+  "description": "Owns the Task & Orchestration public contract, domain rules and application services.",
+  "keywords": [
+    "proflow",
+    "proflow-module",
+    "task-orchestration"
+  ],
+  "proflow": {
+    "module": true,
+    "installClass": "core",
+    "installRequires": [
+      "@tomflow/proflow-module-contract"
+    ],
+    "descriptor": "./dist/deployment/descriptor.js",
+    "manifest": "./proflow.module.json"
+  },
+  "bin": {
+    "proflow-task-orchestration": "./self-install.mjs"
+  },
+  "scripts": {
+    "test": "node --test tests/**/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/proflow.module.json

@@ -0,0 +1,56 @@
+{
+	"contract": "module",
+	"contractVersion": "1.0.0",
+	"moduleRef": "task-orchestration",
+	"packageName": "@tomflow/proflow-task-orchestration",
+	"moduleVersion": "0.1.0",
+	"kind": "library",
+	"templateVersion": "1.0.0",
+	"platformCompatibility": ">=1.0.0 <2.0.0",
+	"installClass": "core",
+	"identity": {
+		"domain": "task-orchestration",
+		"summary": "Owns the Task & Orchestration public contract, domain rules and application services."
+	},
+	"provides": [
+		{
+			"contractRef": "task-orchestration",
+			"version": "1.0.0"
+		}
+	],
+	"requires": [],
+	"requirements": [
+		{
+			"kind": "runtime",
+			"runtime": "node",
+			"versionRange": ">=24.19.0"
+		}
+	],
+	"configSlots": [],
+	"lifecycle": {
+		"supported": ["describe", "preflight", "verify", "doctor"]
+	},
+	"verification": {
+		"checks": [
+			{
+				"id": "task-domain-tests-pass",
+				"description": "Task orchestration Critical Proofs pass",
+				"lifecycle": "verify"
+			}
+		]
+	},
+	"effects": [
+		{
+			"kind": "filesystem",
+			"description": "Owns TaskDocument Markdown writes inside the configured workspace",
+			"retention": "preserve"
+		}
+	],
+	"documentation": [
+		{
+			"id": "overview",
+			"path": "./README.md",
+			"description": "Package-owned module overview"
+		}
+	]
+}

package/self-install.mjs

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+
+const [command, ...rest] = process.argv.slice(2);
+const usage = "Usage: npx @tomflow/proflow-task-orchestration install\n";
+if (command === "--help" || command === "-h") {
+	process.stdout.write(usage);
+	process.exit(0);
+}
+if (command !== "install" || rest.length > 0) {
+	process.stderr.write(usage);
+	process.exit(2);
+}
+const executable = process.platform === "win32" ? "npx.cmd" : "npx";
+const result = spawnSync(
+	executable,
+	[
+		"--yes",
+		"@tomflow/proflow-platform-cli",
+		"install",
+		"@tomflow/proflow-task-orchestration",
+	],
+	{ cwd: process.cwd(), env: process.env, stdio: "inherit" },
+);
+if (result.error) throw result.error;
+process.exit(result.status ?? 1);