@tomflow/proflow-task-orchestration 0.1.1 → 0.1.3

package/DOCS.md

@@ -0,0 +1,27 @@
+# @tomflow/proflow-task-orchestration — Module Docs
+
+Module ref: `task-orchestration`  
+Domain: `task-orchestration`  
+Kind: `library`
+
+Owns the Task & Orchestration public contract, domain rules and application services.
+
+## Standard management surface
+
+`install / uninstall / status / setup / docs / start / stop`
+
+## Provides
+
+- `task-orchestration` `1.0.0`
+
+## Requires
+
+- None.
+
+## Public setup inputs
+
+- None. Deterministic/private values and cross-Module shared facts are not public configuration.
+
+## Ownership boundary
+
+Module business APIs and any module-specific extra commands remain package-owned. Platform does not proxy or interpret them. Current human/external preparation is documented in `SETUP.md`.

package/SETUP.md

@@ -0,0 +1,7 @@
+# @tomflow/proflow-task-orchestration — Module Setup
+
+No user or external setup is required by the current frozen Module contract. `Module.install` completes deterministic preparation; `Module.setup` only re-observes current reality and must not ask the user to supply private paths, loopback endpoints, tokens or cross-Module facts.
+
+## Completion
+
+Setup is complete only when the Module's own `status` reports `setupStatus=READY`. Re-running setup must re-observe reality; it must not resume from a blind historical step index.

package/dist/deployment/adapter.d.ts

@@ -1,47 +1,46 @@
-export declare const behaviorAdapter: {
-    readonly describe: () => {
-        result: {
-            readonly contract: "deployment.result.v1";
-            readonly ok: true;
-            readonly status: "SUCCEEDED";
-            readonly moduleRef: "task-orchestration";
-            readonly moduleVersion: "0.1.1";
-        };
-        observedEffects: never[];
-    };
-    readonly preflight: () => {
-        result: {
-            readonly contract: "deployment.result.v1";
-            readonly ok: true;
-            readonly status: "SUCCEEDED";
-            readonly moduleRef: "task-orchestration";
-            readonly moduleVersion: "0.1.1";
-        };
-        observedEffects: never[];
+declare const success: () => {
+    result: {
+        readonly contract: "deployment.result.v1";
+        readonly ok: true;
+        readonly status: "SUCCEEDED";
+        readonly moduleRef: "task-orchestration";
+        readonly moduleVersion: "0.1.3";
     };
-    readonly verify: () => {
+    observedEffects: string[];
+};
+export declare const behaviorAdapter: {
+    readonly install: typeof success;
+    readonly uninstall: typeof success;
+    readonly status: () => {
         result: {
             contract: "deployment.result.v1";
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-orchestration";
-            moduleVersion: "0.1.1";
-            checks: {
-                id: string;
-                status: string;
-                message: string;
-            }[];
+            moduleVersion: "0.1.3";
+            data: {
+                setupStatus: "READY";
+                runtimeStatus: "NOT_APPLICABLE";
+            };
         };
-        observedEffects: never[];
+        observedEffects: string[];
     };
-    readonly doctor: () => {
+    readonly setup: typeof success;
+    readonly docs: () => {
         result: {
-            readonly contract: "deployment.result.v1";
-            readonly ok: true;
-            readonly status: "SUCCEEDED";
-            readonly moduleRef: "task-orchestration";
-            readonly moduleVersion: "0.1.1";
+            contract: "deployment.result.v1";
+            ok: true;
+            status: "SUCCEEDED";
+            moduleRef: "task-orchestration";
+            moduleVersion: "0.1.3";
+            data: {
+                readonly docs: "DOCS.md";
+                readonly setup: "SETUP.md";
+            };
         };
-        observedEffects: never[];
+        observedEffects: string[];
     };
+    readonly start: typeof success;
+    readonly stop: typeof success;
 };
+export {};

package/dist/deployment/adapter.js

@@ -1,26 +1,30 @@
 import { descriptor } from "./descriptor.js";
-const result = {
+const base = {
     contract: "deployment.result.v1",
     ok: true,
     status: "SUCCEEDED",
     moduleRef: descriptor.moduleRef,
     moduleVersion: descriptor.moduleVersion,
 };
+const success = () => ({ result: base, observedEffects: [] });
 export const behaviorAdapter = {
-    describe: () => ({ result, observedEffects: [] }),
-    preflight: () => ({ result, observedEffects: [] }),
-    verify: () => ({
+    install: success,
+    uninstall: success,
+    status: () => ({
         result: {
-            ...result,
-            checks: [
-                {
-                    id: "task-domain-tests-pass",
-                    status: "PASS",
-                    message: "Task Domain test gate is available",
-                },
-            ],
+            ...base,
+            data: {
+                setupStatus: "READY",
+                runtimeStatus: "NOT_APPLICABLE",
+            },
         },
         observedEffects: [],
     }),
-    doctor: () => ({ result, observedEffects: [] }),
+    setup: success,
+    docs: () => ({
+        result: { ...base, data: descriptor.documentation },
+        observedEffects: [],
+    }),
+    start: success,
+    stop: success,
 };

package/dist/deployment/descriptor.d.ts

@@ -3,11 +3,10 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "task-orchestration";
     readonly packageName: "@tomflow/proflow-task-orchestration";
-    readonly moduleVersion: "0.1.1";
+    readonly moduleVersion: "0.1.3";
     readonly kind: "library";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
-    readonly installClass: "core";
     readonly identity: {
         readonly domain: "task-orchestration";
         readonly summary: "Owns the Task & Orchestration public contract, domain rules and application services.";
@@ -23,24 +22,13 @@ export declare const descriptor: {
         readonly versionRange: ">=24.19.0";
     }];
     readonly configSlots: readonly [];
-    readonly lifecycle: {
-        readonly supported: readonly ["describe", "preflight", "verify", "doctor"];
-    };
-    readonly verification: {
-        readonly checks: readonly [{
-            readonly id: "task-domain-tests-pass";
-            readonly description: "Task orchestration Critical Proofs pass";
-            readonly lifecycle: "verify";
-        }];
-    };
     readonly effects: readonly [{
         readonly kind: "filesystem";
         readonly description: "Owns TaskDocument Markdown writes inside the configured workspace";
         readonly retention: "preserve";
     }];
-    readonly documentation: readonly [{
-        readonly id: "overview";
-        readonly path: "./README.md";
-        readonly description: "Package-owned module overview";
-    }];
+    readonly documentation: {
+        readonly docs: "DOCS.md";
+        readonly setup: "SETUP.md";
+    };
 };

package/dist/deployment/descriptor.js

@@ -3,31 +3,29 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "task-orchestration",
     packageName: "@tomflow/proflow-task-orchestration",
-    moduleVersion: "0.1.1",
+    moduleVersion: "0.1.3",
     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" }],
+    provides: [
+        {
+            contractRef: "task-orchestration",
+            version: "1.0.0",
+        },
+    ],
     requires: [],
     requirements: [
-        { kind: "runtime", runtime: "node", versionRange: ">=24.19.0" },
+        {
+            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",
@@ -35,11 +33,8 @@ export const descriptor = {
             retention: "preserve",
         },
     ],
-    documentation: [
-        {
-            id: "overview",
-            path: "./README.md",
-            description: "Package-owned module overview",
-        },
-    ],
+    documentation: {
+        docs: "DOCS.md",
+        setup: "SETUP.md",
+    },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-orchestration",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -15,16 +15,17 @@
     "proflow.module.json",
     "conformance.json",
     "README.md",
-    "self-install.mjs"
+    "DOCS.md",
+    "SETUP.md"
   ],
   "dependencies": {
     "zod": "4.1.12",
-    "@tomflow/proflow-module-contract": "^0.1.1"
+    "@tomflow/proflow-module-contract": "^0.1.4"
   },
   "devDependencies": {
-    "@tomflow/proflow-task-migration-runner": "^0.1.1",
-    "@tomflow/proflow-task-store-sqlite": "^0.1.1",
-    "@tomflow/proflow-deployment-conformance": "^0.1.2"
+    "@tomflow/proflow-task-migration-runner": "^0.1.4",
+    "@tomflow/proflow-deployment-conformance": "^0.1.4",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.4"
   },
   "description": "Owns the Task & Orchestration public contract, domain rules and application services.",
   "keywords": [
@@ -34,16 +35,9 @@
   ],
   "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

@@ -3,11 +3,10 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "task-orchestration",
 	"packageName": "@tomflow/proflow-task-orchestration",
-	"moduleVersion": "0.1.1",
+	"moduleVersion": "0.1.3",
 	"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."
@@ -27,18 +26,6 @@
 		}
 	],
 	"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",
@@ -46,11 +33,8 @@
 			"retention": "preserve"
 		}
 	],
-	"documentation": [
-		{
-			"id": "overview",
-			"path": "./README.md",
-			"description": "Package-owned module overview"
-		}
-	]
+	"documentation": {
+		"docs": "DOCS.md",
+		"setup": "SETUP.md"
+	}
 }

package/CHANGELOG.md

@@ -1,7 +0,0 @@
-# @tomflow/proflow-task-orchestration
-
-## 0.1.1
-
-### Patch Changes
-
-- Close the Real-1 global Platform control-plane contract across every published ProFlow package. Platform CLI now owns one durable global Workspace binding with canonical identity, cross-process operation locking, cwd/`--workspace` install targeting, cross-directory instance commands, whole-instance uninstall/rebind, and deterministic npm/yarn/pnpm Workspace package-manager selection. Every package-owned install entry, including newly generated Module Template packages, delegates to the Shell-global `platform` command and fails closed when that global CLI is unavailable; Deployment Conformance and the formal test plans mechanically enforce the same rule across all 24 packages.

package/self-install.mjs

@@ -1,34 +0,0 @@
-#!/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" ? "platform.cmd" : "platform";
-const result = spawnSync(
-	executable,
-	[
-		"install",
-		"@tomflow/proflow-task-orchestration",
-		"--workspace",
-		process.cwd(),
-	],
-	{ cwd: process.cwd(), env: process.env, stdio: "inherit" },
-);
-if (result.error) {
-	if (result.error.code === "ENOENT") {
-		process.stderr.write(
-			"GLOBAL_PLATFORM_CLI_REQUIRED: install @tomflow/proflow-platform-cli globally before package-owned install\n",
-		);
-		process.exit(127);
-	}
-	throw result.error;
-}
-process.exit(result.status ?? 1);