cowork-flow 0.0.37 → 0.0.39

package/template/.cowork-flow/spec/runtime/host-assets.json

@@ -0,0 +1,214 @@
+{
+  "schemaVersion": 1,
+  "capabilityValues": [
+    "native",
+    "shim",
+    "plugin",
+    "external",
+    "experimental",
+    "unsupported"
+  ],
+  "platforms": [
+    {
+      "id": "codex",
+      "displayName": "Codex",
+      "aliases": [
+        "codex"
+      ],
+      "detectAny": [
+        ".codex"
+      ],
+      "assetPrefixes": [
+        ".codex/",
+        ".cowork-flow/adapters/codex/"
+      ],
+      "assetFiles": [],
+      "skillTarget": ".agents/skills",
+      "adapterPath": ".cowork-flow/adapters/codex/adapter.yaml",
+      "capabilities": {
+        "dispatchSubagent": "native",
+        "freshChildContext": "native",
+        "sendFollowup": "native",
+        "waitChild": "native",
+        "listChildren": "native",
+        "cancelChild": "native",
+        "stateInjection": "native",
+        "backgroundChild": "native",
+        "runtimeContextDispatch": "native",
+        "runtimeContextBinding": "shim",
+        "runtimeContextCleanup": "native"
+      },
+      "commandTargets": [
+        {
+          "config": ".codex/hooks.json",
+          "format": "json",
+          "target": ".codex/hooks/inject-workflow-state.py"
+        }
+      ]
+    },
+    {
+      "id": "opencode",
+      "displayName": "OpenCode",
+      "aliases": [
+        "opencode"
+      ],
+      "detectAny": [
+        ".opencode"
+      ],
+      "assetPrefixes": [
+        ".opencode/",
+        ".cowork-flow/adapters/opencode/"
+      ],
+      "assetFiles": [],
+      "skillTarget": ".agents/skills",
+      "adapterPath": ".cowork-flow/adapters/opencode/adapter.yaml",
+      "capabilities": {
+        "dispatchSubagent": "native",
+        "freshChildContext": "native",
+        "sendFollowup": "shim",
+        "waitChild": "native",
+        "listChildren": "native",
+        "cancelChild": "native",
+        "stateInjection": "plugin",
+        "backgroundChild": "experimental",
+        "runtimeContextDispatch": "native",
+        "runtimeContextBinding": "shim",
+        "runtimeContextCleanup": "native"
+      },
+      "commandTargets": []
+    },
+    {
+      "id": "claude-code",
+      "displayName": "Claude Code",
+      "aliases": [
+        "claude-code",
+        "claude",
+        "claudecode"
+      ],
+      "detectAny": [
+        ".claude",
+        "CLAUDE.md"
+      ],
+      "assetPrefixes": [
+        ".claude/",
+        ".cowork-flow/adapters/claude-code/"
+      ],
+      "assetFiles": [
+        "CLAUDE.md"
+      ],
+      "skillTarget": ".claude/skills",
+      "adapterPath": ".cowork-flow/adapters/claude-code/adapter.yaml",
+      "capabilities": {
+        "dispatchSubagent": "native",
+        "freshChildContext": "native",
+        "sendFollowup": "native",
+        "waitChild": "native",
+        "listChildren": "native",
+        "cancelChild": "native",
+        "stateInjection": "external",
+        "backgroundChild": "native",
+        "runtimeContextDispatch": "native",
+        "runtimeContextBinding": "shim",
+        "runtimeContextCleanup": "native"
+      },
+      "commandTargets": [
+        {
+          "config": ".claude/settings.json",
+          "format": "json",
+          "target": ".claude/hooks/inject-workflow-state.py"
+        }
+      ]
+    }
+  ],
+  "excludedPrefixes": [
+    "skills/",
+    ".zcode/"
+  ],
+  "syncPolicy": {
+    "protectedFiles": [
+      ".cowork-flow/config.yaml"
+    ],
+    "protectedPrefixes": [
+      ".cowork-flow/spec/",
+      ".cowork-flow/workspace/",
+      ".cowork-flow/tasks/",
+      ".cowork-flow/changes/",
+      ".cowork-flow/plans/"
+    ],
+    "safeFiles": [
+      ".cowork-flow/.gitignore",
+      ".cowork-flow/.version",
+      ".cowork-flow/run",
+      ".cowork-flow/run.cmd",
+      ".cowork-flow/spec/runtime/rules.json",
+      ".cowork-flow/spec/runtime/skill-registry.json",
+      ".cowork-flow/spec/schemas/skill-registry.schema.json",
+      ".cowork-flow/spec/contracts/workflow-state-templates.md"
+    ],
+    "safePrefixes": [
+      ".cowork-flow/"
+    ],
+    "managedBlockFiles": [
+      "AGENTS.md",
+      "CLAUDE.md"
+    ],
+    "obsoleteFiles": [
+      ".cowork-flow/project-context.md",
+      ".cowork-flow/scripts/add_session.py",
+      ".cowork-flow/scripts/change.py",
+      ".cowork-flow/scripts/doctor.py",
+      ".cowork-flow/scripts/get_context.py",
+      ".cowork-flow/scripts/get_developer.py",
+      ".cowork-flow/scripts/init_developer.py",
+      ".cowork-flow/scripts/party_mode_v2.py",
+      ".cowork-flow/scripts/project_context.py",
+      ".cowork-flow/scripts/resume.py",
+      ".cowork-flow/scripts/subagent.py",
+      ".cowork-flow/scripts/task.py",
+      ".cowork-flow/scripts/common/active_task.py",
+      ".cowork-flow/scripts/common/archive_utils.py",
+      ".cowork-flow/scripts/common/coding_standards.py",
+      ".cowork-flow/scripts/common/config.py",
+      ".cowork-flow/scripts/common/developer.py",
+      ".cowork-flow/scripts/common/execution_context.py",
+      ".cowork-flow/scripts/common/files.py",
+      ".cowork-flow/scripts/common/gates.py",
+      ".cowork-flow/scripts/common/git_context.py",
+      ".cowork-flow/scripts/common/git_snapshot.py",
+      ".cowork-flow/scripts/common/paths.py",
+      ".cowork-flow/scripts/common/readiness.py",
+      ".cowork-flow/scripts/common/state_machine.py",
+      ".cowork-flow/scripts/common/task_utils.py",
+      ".cowork-flow/scripts/common/tdd_evidence.py",
+      ".cowork-flow/scripts/common/test_intent.py",
+      ".cowork-flow/scripts/common/validate_coding_standards.py",
+      ".cowork-flow/scripts/common/validate_implementation.py",
+      ".cowork-flow/scripts/common/validate_rules.py",
+      ".cowork-flow/scripts/common/gates/spec_validator.py",
+      ".cowork-flow/scripts/common/gates/validate_jsonl.py",
+      ".cowork-flow/spec/contracts/entry-contract.md",
+      ".agents/skills/before-dev",
+      ".agents/skills/check",
+      ".agents/skills/continue",
+      ".agents/skills/doubt-review",
+      ".agents/skills/entry-boundary",
+      ".agents/skills/finish-work",
+      ".agents/skills/party-mode-v2",
+      ".agents/skills/start",
+      ".agents/skills/tdd",
+      ".agents/skills/update-spec",
+      ".agents/skills/using-cowork-flow",
+      ".claude/skills/before-dev",
+      ".claude/skills/check",
+      ".claude/skills/continue",
+      ".claude/skills/doubt-review",
+      ".claude/skills/entry-boundary",
+      ".claude/skills/finish-work",
+      ".claude/skills/party-mode-v2",
+      ".claude/skills/start",
+      ".claude/skills/tdd",
+      ".claude/skills/update-spec",
+      ".claude/skills/using-cowork-flow"
+    ]
+  }
+}

package/template/.cowork-flow/spec/runtime/index.md

@@ -5,6 +5,14 @@
 - `rules.json`: workflow rule 元数据单源。执行器可以按 rule id 做事实判断，
   但 violation 的 `message`、`severity`、`fix_hint` 和来源信息必须来自这里。
 - `contract-registry.json`: hook/plugin 注入 contract digest 的注册表。
+- `host-assets.json`: 宿主平台、资产归属、技能目标、同步保护策略和旧资产迁移清单的单源；结构由 `../schemas/host-assets.schema.json` 约束。
 
 缺少或损坏的 runtime 文件不能静默放行关键门禁。宿主插件可使用最小 fallback
 避免崩溃，但必须在 digest 中暴露 warning；doctor/tests 负责发现缺失。
+
+运行时写入边界：
+
+- 命令层通过 `scripts/application/` 调用任务与 runtime context 用例。
+- JSON 状态通过 `scripts/common/storage/` 读写并显式使用 UTF-8。
+- init/sync 通过 Asset Plan、staging、备份和 rollback 提交资产，版本文件最后更新。
+- 旧状态只允许在带迁移测试的读取边界兼容；新写入必须使用当前 schema 和权威路径。

package/template/.cowork-flow/spec/runtime/rules.json

@@ -11,7 +11,11 @@
       "fix_hint": "创建 .cowork-flow/changes/<slug>/proposal.md 并填写目标、用户价值、范围边界",
       "source_file": ".cowork-flow/workflow.md",
       "source_excerpt": "定义 L1（增量）、L2（结构性）和 L3（重大）三级工作",
-      "enforcement": "validate_rules"
+      "enforcement": "validate_rules",
+      "validator": "runtime.l2_required_file",
+      "parameters": {
+        "filename": "proposal.md"
+      }
     },
     {
       "id": "R-WF-002",
@@ -23,7 +27,11 @@
       "fix_hint": "创建 .cowork-flow/changes/<slug>/spec.md 并填写功能规格",
       "source_file": ".cowork-flow/workflow.md",
       "source_excerpt": "L2（结构性）",
-      "enforcement": "validate_rules"
+      "enforcement": "validate_rules",
+      "validator": "runtime.l2_required_file",
+      "parameters": {
+        "filename": "spec.md"
+      }
     },
     {
       "id": "R-WF-003",
@@ -35,7 +43,11 @@
       "fix_hint": "创建 .cowork-flow/changes/<slug>/design.md 并填写技术设计",
       "source_file": ".cowork-flow/workflow.md",
       "source_excerpt": "L2（结构性）",
-      "enforcement": "validate_rules"
+      "enforcement": "validate_rules",
+      "validator": "runtime.l2_required_file",
+      "parameters": {
+        "filename": "design.md"
+      }
     },
     {
       "id": "R-WF-004",
@@ -47,7 +59,9 @@
       "fix_hint": "在 change.yaml 中添加 plan 字段指向 .cowork-flow/plans/ 下的计划文件",
       "source_file": ".cowork-flow/workflow.md",
       "source_excerpt": "L2（结构性）",
-      "enforcement": "validate_rules"
+      "enforcement": "validate_rules",
+      "validator": "runtime.l2_plan_link",
+      "parameters": {}
     },
     {
       "id": "R-WF-005",
@@ -59,7 +73,25 @@
       "fix_hint": "在 change.yaml 中添加 tasks 字段指向相关任务目录",
       "source_file": ".cowork-flow/workflow.md",
       "source_excerpt": "L2（结构性）",
-      "enforcement": "validate_rules"
+      "enforcement": "validate_rules",
+      "validator": "runtime.l2_task_link",
+      "parameters": {}
+    },
+    {
+      "id": "R-WF-006",
+      "type": "phase_gate",
+      "severity": "block",
+      "scope": "task_start",
+      "condition": "L2 任务必须有有效的 decision-review.jsonl",
+      "message": "L2 decision review evidence is missing or invalid",
+      "fix_hint": "按 .cowork-flow/spec/protocols/decision-review.md 写入已接受的结构化记录",
+      "source_file": ".cowork-flow/spec/protocols/decision-review.md",
+      "source_excerpt": "L2 task start requires accepted structured decision evidence",
+      "enforcement": "validate_rules",
+      "validator": "runtime.l2_decision_review",
+      "parameters": {
+        "filename": "decision-review.jsonl"
+      }
     },
     {
       "id": "R-WF-007",
@@ -71,7 +103,13 @@
       "fix_hint": "运行 ./.cowork-flow/run task review [task-dir] 进入检查阶段，然后运行验证命令",
       "source_file": ".cowork-flow/workflow.md",
       "source_excerpt": "先验证再完成",
-      "enforcement": "validate_rules"
+      "enforcement": "validate_rules",
+      "validator": "runtime.task_status",
+      "parameters": {
+        "allowed_statuses": [
+          "review"
+        ]
+      }
     },
     {
       "id": "R-WF-008",
@@ -83,7 +121,14 @@
       "fix_hint": "创建 <task-dir>/decision-anchor.md，至少包含 ## 目标和 ## 验收标准",
       "source_file": ".cowork-flow/spec/contracts/decision-anchor.md",
       "source_excerpt": "每个任务必须有决策锚点",
-      "enforcement": "validate_rules"
+      "enforcement": "validate_rules",
+      "validator": "runtime.decision_anchor",
+      "parameters": {
+        "required_sections": [
+          "目标",
+          "验收标准"
+        ]
+      }
     },
     {
       "id": "R-AG-002",
@@ -95,7 +140,9 @@
       "fix_hint": "规格文件只能由主会话修改，子代理应专注于实现任务",
       "source_file": ".cowork-flow/spec/contracts/subagent-dispatch.md",
       "source_excerpt": "cowork-* 固定代理是叶子执行者",
-      "enforcement": "validate_implementation"
+      "enforcement": "validate_implementation",
+      "validator": "implementation.spec_files",
+      "parameters": {}
     },
     {
       "id": "R-AG-005",
@@ -107,7 +154,9 @@
       "fix_hint": "通过 ./.cowork-flow/run task add-context <dir> implement <path> <reason> 登记所有需要修改的文件",
       "source_file": ".cowork-flow/spec/contracts/decision-anchor.md",
       "source_excerpt": "implement.jsonl 是任务的权威文件白名单",
-      "enforcement": "validate_implementation"
+      "enforcement": "validate_implementation",
+      "validator": "implementation.allowed_files",
+      "parameters": {}
     },
     {
       "id": "R-AG-006",
@@ -119,7 +168,9 @@
       "fix_hint": "保持代码简单直接，只有在确认需要复用时才进行抽象",
       "source_file": "AGENTS.md",
       "source_excerpt": "不为一次性代码做抽象",
-      "enforcement": "validate_implementation"
+      "enforcement": "validate_implementation",
+      "validator": "implementation.premature_abstraction",
+      "parameters": {}
     }
   ]
 }