@tomflow/proflow-task-orchestration 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @tomflow/proflow-task-orchestration
+
+## 0.1.4
+
+### Patch Changes
+
+- Align all Modules to the seven-command setup contract with executable package-owned setup guidance and full Platform setup aggregation.

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,19 @@
+# @tomflow/proflow-task-orchestration — Module Setup
+
+## Goal
+
+Reach `setupStatus=READY` without user configuration.
+
+## Step 1 — Complete machine-owned preparation
+
+**Type:** automatic
+**Executable:** `platform install`
+**What happens:** No user input is required. Task orchestration exposes domain behavior but no independent setup choice.
+
+## Step 2 — Re-observe dependency and setup state
+
+**Type:** automatic verification
+**Verify:** `platform status`
+**Success condition:** `task-orchestration.setupStatus=READY`.
+
+There is no human setup action. A missing machine-owned artifact or producer-owned dependency is a `FAILED` condition to fix in the owning package/dependency; it must never be converted into a request for path/token/endpoint input.

package/dist/deployment/adapter.d.ts

@@ -1,61 +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.2";
-        };
-        observedEffects: never[];
-    };
-    readonly preflight: () => {
-        result: {
-            readonly contract: "deployment.result.v1";
-            readonly ok: true;
-            readonly status: "SUCCEEDED";
-            readonly moduleRef: "task-orchestration";
-            readonly moduleVersion: "0.1.2";
-        };
-        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.4";
     };
+    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.2";
+            moduleVersion: "0.1.4";
             data: {
-                configStatus: "READY";
-                runtimeStatus: "UNKNOWN";
+                setupStatus: "READY";
+                runtimeStatus: "NOT_APPLICABLE";
             };
         };
-        observedEffects: never[];
+        observedEffects: string[];
     };
-    readonly verify: () => {
+    readonly setup: typeof success;
+    readonly docs: () => {
         result: {
             contract: "deployment.result.v1";
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-orchestration";
-            moduleVersion: "0.1.2";
-            checks: {
-                id: string;
-                status: string;
-                message: string;
-            }[];
-        };
-        observedEffects: never[];
-    };
-    readonly doctor: () => {
-        result: {
-            readonly contract: "deployment.result.v1";
-            readonly ok: true;
-            readonly status: "SUCCEEDED";
-            readonly moduleRef: "task-orchestration";
-            readonly moduleVersion: "0.1.2";
+            moduleVersion: "0.1.4";
+            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,36 +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: [] }),
+    install: success,
+    uninstall: success,
     status: () => ({
         result: {
-            ...result,
+            ...base,
             data: {
-                configStatus: "READY",
-                runtimeStatus: "UNKNOWN",
+                setupStatus: "READY",
+                runtimeStatus: "NOT_APPLICABLE",
             },
         },
         observedEffects: [],
     }),
-    verify: () => ({
-        result: {
-            ...result,
-            checks: [
-                {
-                    id: "task-domain-tests-pass",
-                    status: "PASS",
-                    message: "Task Domain test gate is available",
-                },
-            ],
-        },
+    setup: success,
+    docs: () => ({
+        result: { ...base, data: descriptor.documentation },
         observedEffects: [],
     }),
-    doctor: () => ({ result, observedEffects: [] }),
+    start: success,
+    stop: success,
 };

package/dist/deployment/descriptor.d.ts

@@ -3,7 +3,7 @@ export declare const descriptor: {
     readonly contractVersion: "1.0.0";
     readonly moduleRef: "task-orchestration";
     readonly packageName: "@tomflow/proflow-task-orchestration";
-    readonly moduleVersion: "0.1.2";
+    readonly moduleVersion: "0.1.4";
     readonly kind: "library";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";
@@ -22,24 +22,13 @@ export declare const descriptor: {
         readonly versionRange: ">=24.19.0";
     }];
     readonly configSlots: readonly [];
-    readonly lifecycle: {
-        readonly supported: readonly ["describe", "preflight", "status", "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,7 +3,7 @@ export const descriptor = {
     contractVersion: "1.0.0",
     moduleRef: "task-orchestration",
     packageName: "@tomflow/proflow-task-orchestration",
-    moduleVersion: "0.1.2",
+    moduleVersion: "0.1.4",
     kind: "library",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",
@@ -11,24 +11,21 @@ export const descriptor = {
         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", "status", "verify", "doctor"],
-    },
-    verification: {
-        checks: [
-            {
-                id: "task-domain-tests-pass",
-                description: "Task orchestration Critical Proofs pass",
-                lifecycle: "verify",
-            },
-        ],
-    },
     effects: [
         {
             kind: "filesystem",
@@ -36,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.2",
+  "version": "0.1.4",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -14,16 +14,18 @@
     "dist",
     "proflow.module.json",
     "conformance.json",
-    "README.md"
+    "README.md",
+    "DOCS.md",
+    "SETUP.md"
   ],
   "dependencies": {
     "zod": "4.1.12",
-    "@tomflow/proflow-module-contract": "^0.1.2"
+    "@tomflow/proflow-module-contract": "^0.1.5"
   },
   "devDependencies": {
-    "@tomflow/proflow-deployment-conformance": "^0.1.3",
-    "@tomflow/proflow-task-migration-runner": "^0.1.3",
-    "@tomflow/proflow-task-store-sqlite": "^0.1.3"
+    "@tomflow/proflow-deployment-conformance": "^0.1.5",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.5",
+    "@tomflow/proflow-task-migration-runner": "^0.1.5"
   },
   "description": "Owns the Task & Orchestration public contract, domain rules and application services.",
   "keywords": [

package/proflow.module.json

@@ -3,7 +3,7 @@
 	"contractVersion": "1.0.0",
 	"moduleRef": "task-orchestration",
 	"packageName": "@tomflow/proflow-task-orchestration",
-	"moduleVersion": "0.1.2",
+	"moduleVersion": "0.1.4",
 	"kind": "library",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",
@@ -26,18 +26,6 @@
 		}
 	],
 	"configSlots": [],
-	"lifecycle": {
-		"supported": ["describe", "preflight", "status", "verify", "doctor"]
-	},
-	"verification": {
-		"checks": [
-			{
-				"id": "task-domain-tests-pass",
-				"description": "Task orchestration Critical Proofs pass",
-				"lifecycle": "verify"
-			}
-		]
-	},
 	"effects": [
 		{
 			"kind": "filesystem",
@@ -45,11 +33,8 @@
 			"retention": "preserve"
 		}
 	],
-	"documentation": [
-		{
-			"id": "overview",
-			"path": "./README.md",
-			"description": "Package-owned module overview"
-		}
-	]
+	"documentation": {
+		"docs": "DOCS.md",
+		"setup": "SETUP.md"
+	}
 }