cowork-flow 0.0.3 → 0.0.5

package/template/.cowork-flow/run

@@ -0,0 +1,166 @@
+#!/bin/sh
+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
+}
+
+candidate_is_valid() {
+  candidate_cmd=$1
+  candidate_arg=${2:-}
+
+  command -v "$candidate_cmd" >/dev/null 2>&1 || return 1
+
+  if [ -n "$candidate_arg" ]; then
+    "$candidate_cmd" "$candidate_arg" -c "$VERSION_CHECK" >/dev/null 2>&1
+  else
+    "$candidate_cmd" -c "$VERSION_CHECK" >/dev/null 2>&1
+  fi
+}
+
+select_explicit_python() {
+  env_name=$1
+  env_value=$2
+
+  if candidate_is_valid "$env_value"; then
+    SELECTED_PYTHON=$env_value
+    SELECTED_PYTHON_ARG=
+    return 0
+  fi
+
+  echo "错误：$env_name 指向的解释器不可用或版本低于 ${MIN_PYTHON_LABEL}：$env_value" >&2
+  echo "请设置 $env_name 为可执行的 Python 3.8+ 解释器路径。" >&2
+  exit 127
+}
+
+select_python() {
+  SELECTED_PYTHON=
+  SELECTED_PYTHON_ARG=
+
+  if [ -n "${COWORK_FLOW_PYTHON:-}" ]; then
+    select_explicit_python "COWORK_FLOW_PYTHON" "$COWORK_FLOW_PYTHON"
+    return 0
+  fi
+
+  if [ -n "${PYTHON:-}" ]; then
+    select_explicit_python "PYTHON" "$PYTHON"
+    return 0
+  fi
+
+  if candidate_is_valid "python3"; then
+    SELECTED_PYTHON=python3
+    return 0
+  fi
+
+  if candidate_is_valid "python"; then
+    SELECTED_PYTHON=python
+    return 0
+  fi
+
+  if candidate_is_valid "py" "-3"; then
+    SELECTED_PYTHON=py
+    SELECTED_PYTHON_ARG=-3
+    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
+  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" "$@"
+}
+
+if [ "$#" -eq 0 ]; then
+  print_usage >&2
+  exit 2
+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

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

@@ -0,0 +1,198 @@
+@echo off
+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 "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"
+)
+
+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%
+)
+
+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"
+
+where "%CANDIDATE_CMD%" >nul 2>nul
+if errorlevel 1 (
+  if not exist "%CANDIDATE_CMD%" exit /b 1
+)
+
+if not "%CANDIDATE_ARG%"=="" (
+  "%CANDIDATE_CMD%" "%CANDIDATE_ARG%" -c "%VERSION_CHECK%" >nul 2>nul
+) else (
+  "%CANDIDATE_CMD%" -c "%VERSION_CHECK%" >nul 2>nul
+)
+exit /b %ERRORLEVEL%
+
+:select_explicit_python
+set "ENV_NAME=%~1"
+set "ENV_VALUE=%~2"
+
+call :candidate_is_valid "%ENV_VALUE%" ""
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=%ENV_VALUE%"
+  set "SELECTED_PYTHON_ARG="
+  exit /b 0
+)
+
+echo 错误：%ENV_NAME% 指向的解释器不可用或版本低于 %MIN_PYTHON_LABEL%：%ENV_VALUE% 1>&2
+echo 请设置 %ENV_NAME% 为可执行的 Python 3.8+ 解释器路径。 1>&2
+exit /b 127
+
+:select_python
+set "SELECTED_PYTHON="
+set "SELECTED_PYTHON_ARG="
+
+if not "%COWORK_FLOW_PYTHON%"=="" (
+  call :select_explicit_python "COWORK_FLOW_PYTHON" "%COWORK_FLOW_PYTHON%"
+  exit /b %ERRORLEVEL%
+)
+
+if not "%PYTHON%"=="" (
+  call :select_explicit_python "PYTHON" "%PYTHON%"
+  exit /b %ERRORLEVEL%
+)
+
+call :candidate_is_valid "python3" ""
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=python3"
+  exit /b 0
+)
+
+call :candidate_is_valid "python" ""
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=python"
+  exit /b 0
+)
+
+call :candidate_is_valid "py" "-3"
+if not errorlevel 1 (
+  set "SELECTED_PYTHON=py"
+  set "SELECTED_PYTHON_ARG=-3"
+  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
+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/add_session.py

@@ -4,8 +4,8 @@
 Add a new session to journal file and update index.md.
 
 Usage:
-    python3 add_session.py --title "Title" --commit "hash" --summary "Summary"
-    echo "content" | python3 add_session.py --title "Title" --commit "hash"
+    ./.cowork-flow/run add-session --title "Title" --commit "hash" --summary "Summary"
+    echo "content" | ./.cowork-flow/run add-session --title "Title" --commit "hash"
 """
 
 from __future__ import annotations