@tomflow/proflow-task-orchestration 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @tomflow/proflow-task-orchestration
 
+## 0.1.8
+
+### Patch Changes
+
+- Upgrade the ProFlow terminal experience, stream Registry and package-manager progress, publish structured Chinese Module documentation, and provide numbered package-owned Setup assistants.
+
 ## 0.1.7
 
 ### Patch Changes

package/DOCS.md

@@ -1,11 +1,39 @@
-# task-orchestration
+# task-orchestration — 任务与编排内核
 
-Task Orchestration（任务编排）管理 Task、Task Group、Node、角色绑定和任务文档，是任务生命周期的业务真相来源。
+## 模块定位与作用
+
+拥有 Task、Plan、Node、TaskRoleBinding 和 TaskDocument 等核心业务模型，负责确定性的任务状态推进与并发控制。
 
 ## 主要能力
 
-- 创建、启动、推进、重开和终止任务。
-- 管理节点顺序以及角色与 Worker（工作实例）的绑定。
-- 保存任务文档和状态变更记录。
+- 创建 Task、维护 Plan/Node 依赖和 READY 判定。
+- 绑定固定 Agent Worker，管理 start/complete/wait/reopen 等状态转换。
+- 提供 Task Document、版本控制、幂等和异常诊断入口。
+
+## 提供的 API 与 Public Contract
+
+- 提供 `task-orchestration` Contract，版本 `1.0.0`。
+- 公开 Task Application、Worker Binding、Node Command 与查询端口。
+
+## 依赖的 Module、Contract 和外部资源
+
+- 无上游 Module Contract 依赖。
+- 持久化由实现该领域端口的 Store Module 提供。
+
+## 运行形态与生命周期
+
+类型为 Library，由 Platform Host 组合运行，本身没有独立进程。
+
+## 使用方式
+
+通过公开应用端口创建和推进 Task；外部模块不得直接修改内部 Entity 或数据库表。
+
+## 职责边界与限制
+
+不执行真实 Effect、不控制 Browser、不管理 Agent 会话，也不调用模型完成普通确定性推进。
+
+## 术语
 
-它作为库运行在 Platform Host 中，没有独立进程，也不需要人工配置。
+- Task（任务）：从需求到结果的业务聚合根。
+- Node（节点）：具有依赖、Owner 和状态的可执行工作单元。
+- TaskRoleBinding（任务角色绑定）：Task 与稳定 Worker 的关系。

package/dist/deployment/adapter.d.ts

@@ -4,7 +4,7 @@ declare const success: () => {
         readonly ok: true;
         readonly status: "SUCCEEDED";
         readonly moduleRef: "task-orchestration";
-        readonly moduleVersion: "0.1.7";
+        readonly moduleVersion: "0.1.8";
     };
     observedEffects: string[];
 };
@@ -17,7 +17,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-orchestration";
-            moduleVersion: "0.1.7";
+            moduleVersion: "0.1.8";
             data: {
                 setupStatus: "READY";
                 runtimeStatus: "NOT_APPLICABLE";
@@ -32,7 +32,7 @@ export declare const behaviorAdapter: {
             ok: true;
             status: "SUCCEEDED";
             moduleRef: "task-orchestration";
-            moduleVersion: "0.1.7";
+            moduleVersion: "0.1.8";
             data: {
                 docs: string;
             };

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.7";
+    readonly moduleVersion: "0.1.8";
     readonly kind: "library";
     readonly templateVersion: "1.0.0";
     readonly platformCompatibility: ">=1.0.0 <2.0.0";

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.7",
+    moduleVersion: "0.1.8",
     kind: "library",
     templateVersion: "1.0.0",
     platformCompatibility: ">=1.0.0 <2.0.0",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomflow/proflow-task-orchestration",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -20,12 +20,12 @@
   ],
   "dependencies": {
     "zod": "4.1.12",
-    "@tomflow/proflow-module-contract": "^0.1.10"
+    "@tomflow/proflow-module-contract": "^0.1.11"
   },
   "devDependencies": {
-    "@tomflow/proflow-task-migration-runner": "^0.1.8",
-    "@tomflow/proflow-deployment-conformance": "^0.1.8",
-    "@tomflow/proflow-task-store-sqlite": "^0.1.8"
+    "@tomflow/proflow-task-migration-runner": "^0.1.9",
+    "@tomflow/proflow-deployment-conformance": "^0.1.9",
+    "@tomflow/proflow-task-store-sqlite": "^0.1.9"
   },
   "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.7",
+	"moduleVersion": "0.1.8",
 	"kind": "library",
 	"templateVersion": "1.0.0",
 	"platformCompatibility": ">=1.0.0 <2.0.0",