cowork-flow 0.0.5 → 0.0.8

package/template/.cowork-flow/run

@@ -3,30 +3,8 @@ set -u
 
 MIN_PYTHON_LABEL="Python 3.8+"
 VERSION_CHECK='import sys; raise SystemExit(0 if sys.version_info >= (3, 8) else 1)'
-
 WORKFLOW_DIR=$(CDPATH= cd "$(dirname "$0")" && pwd) || exit 1
-SCRIPTS_DIR="$WORKFLOW_DIR/scripts"
-
-print_usage() {
-  cat <<'EOF'
-用法：
-  ./.cowork-flow/run <command> [args...]
-  ./.cowork-flow/run python [python-args...]
-
-常用 command：
-  resume
-  task
-  change
-  get-context
-  get-developer
-  init-developer
-  add-session
-  agent-team
-
-解释器选择顺序：
-  COWORK_FLOW_PYTHON -> PYTHON -> python3 -> python -> py -3
-EOF
-}
+RUNNER_SCRIPT="$WORKFLOW_DIR/scripts/run.py"
 
 candidate_is_valid() {
   candidate_cmd=$1
@@ -51,8 +29,8 @@ select_explicit_python() {
     return 0
   fi
 
-  echo "错误：$env_name 指向的解释器不可用或版本低于 ${MIN_PYTHON_LABEL}：$env_value" >&2
-  echo "请设置 $env_name 为可执行的 Python 3.8+ 解释器路径。" >&2
+  echo "Error: $env_name does not point to a usable ${MIN_PYTHON_LABEL} interpreter: $env_value" >&2
+  echo "Set $env_name to an executable Python 3.8+ interpreter path." >&2
   exit 127
 }
 
@@ -86,81 +64,16 @@ select_python() {
     return 0
   fi
 
-  echo "错误：需要 ${MIN_PYTHON_LABEL}，但未找到可用解释器。" >&2
-  echo "已尝试：COWORK_FLOW_PYTHON、PYTHON、python3、python、py -3。" >&2
-  echo "可设置 COWORK_FLOW_PYTHON=/path/to/python3 后重试。" >&2
+  echo "Error: ${MIN_PYTHON_LABEL} is required, but no usable interpreter was found." >&2
+  echo "Tried: COWORK_FLOW_PYTHON, PYTHON, python3, python, py -3." >&2
+  echo "Set COWORK_FLOW_PYTHON=/path/to/python3 and retry." >&2
   exit 127
 }
 
-exec_python() {
-  select_python
-
-  if [ -n "$SELECTED_PYTHON_ARG" ]; then
-    exec "$SELECTED_PYTHON" "$SELECTED_PYTHON_ARG" "$@"
-  fi
-
-  exec "$SELECTED_PYTHON" "$@"
-}
-
-run_script() {
-  script_path=$1
-  shift
-
-  if [ ! -f "$script_path" ]; then
-    echo "错误：找不到脚本：$script_path" >&2
-    exit 2
-  fi
-
-  exec_python "$script_path" "$@"
-}
+select_python
 
-if [ "$#" -eq 0 ]; then
-  print_usage >&2
-  exit 2
+if [ -n "$SELECTED_PYTHON_ARG" ]; then
+  exec "$SELECTED_PYTHON" "$SELECTED_PYTHON_ARG" "$RUNNER_SCRIPT" "$@"
 fi
 
-command_name=$1
-shift
-
-case "$command_name" in
-  -h|--help|help)
-    print_usage
-    exit 0
-    ;;
-  python)
-    exec_python "$@"
-    ;;
-  resume)
-    run_script "$SCRIPTS_DIR/resume.py" "$@"
-    ;;
-  task)
-    run_script "$SCRIPTS_DIR/task.py" "$@"
-    ;;
-  change)
-    run_script "$SCRIPTS_DIR/change.py" "$@"
-    ;;
-  get-context|get_context)
-    run_script "$SCRIPTS_DIR/get_context.py" "$@"
-    ;;
-  get-developer|get_developer)
-    run_script "$SCRIPTS_DIR/get_developer.py" "$@"
-    ;;
-  init-developer|init_developer)
-    run_script "$SCRIPTS_DIR/init_developer.py" "$@"
-    ;;
-  add-session|add_session)
-    run_script "$SCRIPTS_DIR/add_session.py" "$@"
-    ;;
-  agent-team|agent_team)
-    run_script "$SCRIPTS_DIR/agent_team.py" "$@"
-    ;;
-  *)
-    if [ -f "$SCRIPTS_DIR/$command_name.py" ]; then
-      run_script "$SCRIPTS_DIR/$command_name.py" "$@"
-    fi
-
-    echo "错误：未知 cowork-flow 命令：$command_name" >&2
-    print_usage >&2
-    exit 2
-    ;;
-esac
+exec "$SELECTED_PYTHON" "$RUNNER_SCRIPT" "$@"

package/template/.cowork-flow/run.cmd

@@ -4,108 +4,20 @@ setlocal EnableExtensions
 set "MIN_PYTHON_LABEL=Python 3.8+"
 set "VERSION_CHECK=import sys; raise SystemExit(0 if sys.version_info >= (3, 8) else 1)"
 set "WORKFLOW_DIR=%~dp0"
-set "SCRIPTS_DIR=%WORKFLOW_DIR%scripts"
+set "RUNNER_SCRIPT=%WORKFLOW_DIR%scripts\run.py"
 set "SELECTED_PYTHON="
 set "SELECTED_PYTHON_ARG="
-set "REST_ARGS="
 
-if "%~1"=="" goto usage_error
-
-set "COMMAND_NAME=%~1"
-if not "%~2"=="" (
-  for /F "tokens=1,* delims= " %%A in ("%*") do set "REST_ARGS=%%B"
-)
+call :select_python
+if errorlevel 1 exit /b %ERRORLEVEL%
 
-if /I "%COMMAND_NAME%"=="-h" goto usage
-if /I "%COMMAND_NAME%"=="--help" goto usage
-if /I "%COMMAND_NAME%"=="help" goto usage
-if /I "%COMMAND_NAME%"=="python" goto run_python_passthrough
-if /I "%COMMAND_NAME%"=="resume" goto run_resume
-if /I "%COMMAND_NAME%"=="task" goto run_task
-if /I "%COMMAND_NAME%"=="change" goto run_change
-if /I "%COMMAND_NAME%"=="get-context" goto run_get_context
-if /I "%COMMAND_NAME%"=="get_context" goto run_get_context
-if /I "%COMMAND_NAME%"=="get-developer" goto run_get_developer
-if /I "%COMMAND_NAME%"=="get_developer" goto run_get_developer
-if /I "%COMMAND_NAME%"=="init-developer" goto run_init_developer
-if /I "%COMMAND_NAME%"=="init_developer" goto run_init_developer
-if /I "%COMMAND_NAME%"=="add-session" goto run_add_session
-if /I "%COMMAND_NAME%"=="add_session" goto run_add_session
-if /I "%COMMAND_NAME%"=="agent-team" goto run_agent_team
-if /I "%COMMAND_NAME%"=="agent_team" goto run_agent_team
-
-if exist "%SCRIPTS_DIR%\%COMMAND_NAME%.py" (
-  call :run_script "%SCRIPTS_DIR%\%COMMAND_NAME%.py"
-  exit /b %ERRORLEVEL%
+if not "%SELECTED_PYTHON_ARG%"=="" (
+  "%SELECTED_PYTHON%" "%SELECTED_PYTHON_ARG%" "%RUNNER_SCRIPT%" %*
+) else (
+  "%SELECTED_PYTHON%" "%RUNNER_SCRIPT%" %*
 )
-
-echo 错误：未知 cowork-flow 命令：%COMMAND_NAME% 1>&2
-call :print_usage 1>&2
-exit /b 2
-
-:usage
-call :print_usage
-exit /b 0
-
-:usage_error
-call :print_usage 1>&2
-exit /b 2
-
-:run_python_passthrough
-call :exec_python %REST_ARGS%
-exit /b %ERRORLEVEL%
-
-:run_resume
-call :run_script "%SCRIPTS_DIR%\resume.py"
-exit /b %ERRORLEVEL%
-
-:run_task
-call :run_script "%SCRIPTS_DIR%\task.py"
-exit /b %ERRORLEVEL%
-
-:run_change
-call :run_script "%SCRIPTS_DIR%\change.py"
-exit /b %ERRORLEVEL%
-
-:run_get_context
-call :run_script "%SCRIPTS_DIR%\get_context.py"
-exit /b %ERRORLEVEL%
-
-:run_get_developer
-call :run_script "%SCRIPTS_DIR%\get_developer.py"
 exit /b %ERRORLEVEL%
 
-:run_init_developer
-call :run_script "%SCRIPTS_DIR%\init_developer.py"
-exit /b %ERRORLEVEL%
-
-:run_add_session
-call :run_script "%SCRIPTS_DIR%\add_session.py"
-exit /b %ERRORLEVEL%
-
-:run_agent_team
-call :run_script "%SCRIPTS_DIR%\agent_team.py"
-exit /b %ERRORLEVEL%
-
-:print_usage
-echo 用法：
-echo   .\.cowork-flow\run.cmd ^<command^> [args...]
-echo   .\.cowork-flow\run.cmd python [python-args...]
-echo.
-echo 常用 command：
-echo   resume
-echo   task
-echo   change
-echo   get-context
-echo   get-developer
-echo   init-developer
-echo   add-session
-echo   agent-team
-echo.
-echo 解释器选择顺序：
-echo   COWORK_FLOW_PYTHON -^> PYTHON -^> python3 -^> python -^> py -3
-exit /b 0
-
 :candidate_is_valid
 set "CANDIDATE_CMD=%~1"
 set "CANDIDATE_ARG=%~2"
@@ -133,8 +45,8 @@ if not errorlevel 1 (
   exit /b 0
 )
 
-echo 错误：%ENV_NAME% 指向的解释器不可用或版本低于 %MIN_PYTHON_LABEL%：%ENV_VALUE% 1>&2
-echo 请设置 %ENV_NAME% 为可执行的 Python 3.8+ 解释器路径。 1>&2
+echo Error: %ENV_NAME% does not point to a usable %MIN_PYTHON_LABEL% interpreter: %ENV_VALUE% 1>&2
+echo Set %ENV_NAME% to an executable Python 3.8+ interpreter path. 1>&2
 exit /b 127
 
 :select_python
@@ -170,29 +82,7 @@ if not errorlevel 1 (
   exit /b 0
 )
 
-echo 错误：需要 %MIN_PYTHON_LABEL%，但未找到可用解释器。 1>&2
-echo 已尝试：COWORK_FLOW_PYTHON、PYTHON、python3、python、py -3。 1>&2
-echo 可设置 COWORK_FLOW_PYTHON=C:\Path\To\python.exe 后重试。 1>&2
+echo Error: %MIN_PYTHON_LABEL% is required, but no usable interpreter was found. 1>&2
+echo Tried: COWORK_FLOW_PYTHON, PYTHON, python3, python, py -3. 1>&2
+echo Set COWORK_FLOW_PYTHON=C:\Path\To\python.exe and retry. 1>&2
 exit /b 127
-
-:exec_python
-call :select_python
-if errorlevel 1 exit /b %ERRORLEVEL%
-
-if not "%SELECTED_PYTHON_ARG%"=="" (
-  "%SELECTED_PYTHON%" "%SELECTED_PYTHON_ARG%" %*
-) else (
-  "%SELECTED_PYTHON%" %*
-)
-exit /b %ERRORLEVEL%
-
-:run_script
-set "SCRIPT_PATH=%~1"
-
-if not exist "%SCRIPT_PATH%" (
-  echo 错误：找不到脚本：%SCRIPT_PATH% 1>&2
-  exit /b 2
-)
-
-call :exec_python "%SCRIPT_PATH%" %REST_ARGS%
-exit /b %ERRORLEVEL%

package/template/.cowork-flow/scripts/agent_team.py

@@ -15,6 +15,7 @@ from common.agent_team import (
     build_initial_metrics,
     build_initial_status,
     parse_plan,
+    load_agent_registry,
     render_assignment_prompt,
     render_dispatch_plan,
     write_json,
@@ -31,7 +32,7 @@ default_adapter: codex
 
 agents:
   implementer:
-    codex_type: worker
+    agent_type: worker
     capabilities:
       - implementation
       - test-writing
@@ -45,9 +46,51 @@ agents:
       - "test/**"
     risk_limits:
       max_parallel_write_conflicts: 0
+    prompt: |
+      Implement the smallest change that satisfies the approved plan and tests.
+      Write or update focused regression tests first, keep edits scoped, and report exact verification commands.
+
+  tester:
+    agent_type: worker
+    capabilities:
+      - test-writing
+      - verification
+    preferred_task_types:
+      - test
+      - verification
+    file_patterns:
+      - "tests/**"
+      - "test/**"
+      - "src/**"
+      - "template/**"
+    risk_limits:
+      max_parallel_write_conflicts: 0
+    prompt: |
+      Design tests that fail for the broken behavior and pass for the intended behavior.
+      Prefer clear behavior assertions over implementation details, and include the command that proves the result.
+
+  debugger:
+    agent_type: worker
+    capabilities:
+      - debugging
+      - implementation
+      - verification
+    preferred_task_types:
+      - bugfix
+      - code
+    file_patterns:
+      - "src/**"
+      - "template/**"
+      - "tests/**"
+      - "test/**"
+    risk_limits:
+      max_parallel_write_conflicts: 0
+    prompt: |
+      Find the root cause before changing code. Reproduce the failure, compare with nearby working patterns,
+      then make the smallest fix and verify the original symptom.
 
   spec-reviewer:
-    codex_type: default
+    agent_type: default
     capabilities:
       - spec-review
       - acceptance-check
@@ -61,12 +104,16 @@ agents:
       - "template/**"
     risk_limits:
       max_parallel_write_conflicts: 0
+    prompt: |
+      Review the proposal, spec, plan, and task PRD for contradictions, missing acceptance criteria,
+      unclear scope, and behavior that is not covered by verification.
 
   quality-reviewer:
-    codex_type: default
+    agent_type: default
     capabilities:
       - code-quality-review
       - test-review
+      - verification
     preferred_task_types:
       - review
       - verification
@@ -77,14 +124,18 @@ agents:
       - "test/**"
     risk_limits:
       max_parallel_write_conflicts: 0
+    prompt: |
+      Review the diff for correctness, maintainability, focused scope, and meaningful tests.
+      Check that verification evidence matches the behavior being claimed.
 
   docs-agent:
-    codex_type: worker
+    agent_type: worker
     capabilities:
       - documentation
       - workflow-writing
     preferred_task_types:
       - docs
+      - documentation
     file_patterns:
       - "README.md"
       - "AGENTS.md"
@@ -92,6 +143,30 @@ agents:
       - ".agent/skills/**"
     risk_limits:
       max_parallel_write_conflicts: 0
+    prompt: |
+      Write concise project documentation that reflects actual commands, files, and workflow behavior.
+      Avoid aspirational text that is not backed by the implementation.
+
+  release-reviewer:
+    agent_type: default
+    capabilities:
+      - release-review
+      - acceptance-check
+      - verification
+    preferred_task_types:
+      - release
+      - review
+    file_patterns:
+      - "package.json"
+      - "package-lock.json"
+      - "scripts/**"
+      - "README.md"
+      - ".cowork-flow/changes/**"
+    risk_limits:
+      max_parallel_write_conflicts: 0
+    prompt: |
+      Review release-facing changes for versioning, packaging, documentation, and command safety.
+      Confirm that generated artifacts and publish steps are intentional.
 """,
     "adapters.yaml": """# Agent Team Adapters
 
@@ -309,7 +384,8 @@ def cmd_prepare(args: argparse.Namespace) -> int:
     ):
         directory.mkdir(parents=True, exist_ok=True)
 
-    dispatch_plan = build_dispatch_plan(tasks)
+    registry = load_agent_registry(_agent_team_config_dir(repo_root) / "agents.yaml")
+    dispatch_plan = build_dispatch_plan(tasks, registry)
     (runtime_dir / "dispatch-plan.yaml").write_text(
         render_dispatch_plan(dispatch_plan),
         encoding="utf-8",
@@ -317,9 +393,9 @@ def cmd_prepare(args: argparse.Namespace) -> int:
     write_json(runtime_dir / "status.json", build_initial_status(dispatch_plan))
     write_json(runtime_dir / "metrics.json", build_initial_metrics(dispatch_plan))
     write_json(
-        adapters_dir / "codex.json",
+        adapters_dir / f"{dispatch_plan['adapter']}.json",
         {
-            "adapter": "codex",
+            "adapter": dispatch_plan["adapter"],
             "mode": "coordinator-dispatched",
             "assignmentCount": len(dispatch_plan["assignments"]),
         },
@@ -371,7 +447,7 @@ def cmd_next(args: argparse.Namespace) -> int:
     for assignment_id, assignment in ready:
         print(
             f"{assignment_id}\trole={assignment['role']}\t"
-            f"agent={assignment['recommended_agent']}\tcodex_type={assignment['codex_type']}"
+            f"agent={assignment['recommended_agent']}\tagent_type={assignment['agent_type']}"
         )
     return 0
 

package/template/.cowork-flow/scripts/change.py

@@ -6,12 +6,18 @@ from __future__ import annotations
 
 import argparse
 import re
-import shutil
 import sys
 from datetime import datetime
 from pathlib import Path
 
-from common.paths import DIR_ARCHIVE, DIR_CHANGES, DIR_WORKFLOW, get_repo_root
+from common.archive_utils import archive_directory_resumable
+from common.paths import (
+    DIR_ARCHIVE,
+    DIR_CHANGES,
+    DIR_WORKFLOW,
+    generate_task_date_prefix,
+    get_repo_root,
+)
 
 
 SLUG_PATTERN = re.compile(r"^[a-z0-9]+(?:-[a-z0-9]+)*$")
@@ -107,9 +113,52 @@ def _resolve_link(repo_root: Path, base_dir: str, value: object) -> Path | None:
         return raw_path
 
     direct = repo_root / raw_path
-    if direct.exists():
+    workflow_base = Path(DIR_WORKFLOW) / base_dir
+    if direct.exists() or raw_path.parts[:2] == workflow_base.parts:
         return direct
-    return repo_root / DIR_WORKFLOW / base_dir / raw_path
+    return repo_root / workflow_base / raw_path
+
+
+def _archived_task_link(repo_root: Path, task_name: str) -> str | None:
+    archive_root = repo_root / DIR_WORKFLOW / "tasks" / DIR_ARCHIVE
+    if not archive_root.is_dir():
+        return None
+
+    matches = [path for path in archive_root.glob(f"*/{task_name}") if path.is_dir()]
+    if len(matches) != 1:
+        return None
+
+    relative = matches[0].relative_to(archive_root)
+    return str(Path(DIR_ARCHIVE) / relative).replace("\\", "/")
+
+
+def _normalize_task_link(repo_root: Path, value: object) -> object:
+    if not isinstance(value, str) or not value.strip():
+        return value
+
+    target = _resolve_link(repo_root, "tasks", value)
+    tasks_root = repo_root / DIR_WORKFLOW / "tasks"
+    archive_root = tasks_root / DIR_ARCHIVE
+    if target is None:
+        return value
+
+    if not target.exists():
+        return _archived_task_link(repo_root, target.name) or value
+
+    try:
+        relative = target.resolve().relative_to(archive_root.resolve())
+    except ValueError:
+        return value
+
+    return str(Path(DIR_ARCHIVE) / relative).replace("\\", "/")
+
+
+def _normalize_archive_metadata(repo_root: Path, change_dir: Path) -> None:
+    metadata = _read_metadata(change_dir)
+    normalized_task = _normalize_task_link(repo_root, metadata.get("task"))
+    if normalized_task != metadata.get("task"):
+        metadata["task"] = normalized_task
+        _write_metadata(change_dir, metadata)
 
 
 def _validate_link(repo_root: Path, metadata: dict[str, object], field: str, base_dir: str) -> str | None:
@@ -178,14 +227,15 @@ def create_change(args: argparse.Namespace) -> int:
     if not _validate_slug(slug):
         return 2
 
-    change_dir = _change_dir(repo_root, slug)
+    dir_name = f"{generate_task_date_prefix()}-{slug}"
+    change_dir = _change_dir(repo_root, dir_name)
     if change_dir.exists():
-        print(f"Error: change already exists: {slug}", file=sys.stderr)
+        print(f"Error: change already exists: {dir_name}", file=sys.stderr)
         return 1
 
     change_dir.mkdir(parents=True)
     (change_dir / "proposal.md").write_text(
-        f"# {slug}\n\nDescribe the proposed behavior change.\n",
+        f"# {dir_name}\n\nDescribe the proposed behavior change.\n",
         encoding="utf-8",
     )
     (change_dir / "design.md").write_text("", encoding="utf-8")
@@ -193,7 +243,7 @@ def create_change(args: argparse.Namespace) -> int:
     _write_metadata(
         change_dir,
         {
-            "slug": slug,
+            "slug": dir_name,
             "status": "draft",
             "level": args.level,
             "created_at": _now_iso(),
@@ -203,7 +253,7 @@ def create_change(args: argparse.Namespace) -> int:
         },
     )
 
-    print(f"created {slug}")
+    print(f"created {dir_name}")
     return 0
 
 
@@ -215,22 +265,25 @@ def validate_command(args: argparse.Namespace) -> int:
 def archive_change(args: argparse.Namespace) -> int:
     repo_root = get_repo_root()
     slug = args.slug
+    source = _change_dir(repo_root, slug)
+    if source.is_dir():
+        _normalize_archive_metadata(repo_root, source)
+
     if not validate_change(repo_root, slug, quiet=True):
         return 1
 
-    source = _change_dir(repo_root, slug)
     month = datetime.now().astimezone().strftime("%Y-%m")
     destination = _archive_dir(repo_root) / month / slug
-    if destination.exists():
-        print(f"Error: archive destination already exists: {destination}", file=sys.stderr)
+    result = archive_directory_resumable(source, destination)
+    if not result.ok:
+        level = "Warning" if result.partial else "Error"
+        print(f"{level}: {result.message}", file=sys.stderr)
         return 1
 
-    destination.parent.mkdir(parents=True, exist_ok=True)
-    shutil.move(str(source), str(destination))
-
     metadata = _read_metadata(destination)
     metadata["status"] = "archived"
     metadata["archived_at"] = _now_iso()
+    metadata["task"] = _normalize_task_link(repo_root, metadata.get("task"))
     _write_metadata(destination, metadata)
 
     print(f"archived {slug}")