@hupan56/wlkj 2.7.12 → 3.1.2

package/templates/qoder/scripts/domain/task/task.py

@@ -0,0 +1,229 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Pipeline - 任务生命周期管理
+
+完整的任务 CRUD 和生命周期管理:
+- create: 创建任务 (含 task.json, prd.md 模板, implement.jsonl, check.jsonl)
+- start: 开始任务 (设置活跃任务, 状态 planning -> in_progress)
+- current: 查看当前活跃任务
+- finish: 完成任务 (清除活跃任务)
+- archive: 归档任务 (移动到 archive/ 目录)
+- list: 列出活跃/归档任务
+- show: 查看任务详情
+- reassign: 改派任务负责人 (多角色协作, PM 建任务后转给开发)
+- add-subtask / remove-subtask: 父子任务关联
+- set-due / block / unblock / gantt: 排期与依赖
+
+参考: Trellis 的 task.py 设计
+
+Usage:
+    python task.py create "<title>" [--slug <name>] [--assignee <dev>] [--priority P0|P1|P2|P3]
+    python task.py start <name>
+    python task.py current [--source]
+    python task.py finish
+    python task.py archive <name>
+    python task.py reassign <name> <new_assignee>
+    python task.py list [--mine] [--status <s>]
+    python task.py add-subtask <parent> <child>
+    python task.py remove-subtask <parent> <child>
+"""
+
+from __future__ import annotations
+
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+import argparse
+import json
+import os
+import shutil
+import sys
+from datetime import datetime
+from pathlib import Path
+
+# 将 scripts 目录加入路径
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from foundation.core.paths import (
+    DIR_TASKS,
+    DIR_ARCHIVE,
+    FILE_TASK_JSON,
+    get_repo_root,
+    get_developer,
+    get_tasks_dir,
+)
+from foundation.integrations.active_task import (
+    clear_active_task,
+    resolve_active_task,
+    resolve_context_key,
+    set_active_task,
+)
+from foundation.data.task_utils import (
+    resolve_task_dir,
+    run_task_hooks,
+    load_task_json,
+    write_task_json,
+    modify_task_json,
+    assert_can_modify_task,
+)
+
+
+# =============================================================================
+# 命令: create
+# =============================================================================
+
+
+# v3.0 f6: cmd_* 拆到三个模块
+from task_lifecycle import cmd_create, cmd_start, cmd_current, cmd_finish, cmd_archive
+from task_query import cmd_list, cmd_show
+from task_relations import cmd_add_subtask, cmd_remove_subtask, cmd_set_due, cmd_reassign, cmd_block, cmd_unblock, cmd_gantt
+
+
+def main() -> int:
+    """CLI 入口。v3.0: 用 cmd_registry 声明式注册 (消除 ~81 行 argparse 样板)。"""
+    try:
+        from foundation.core.cmd_registry import run_command
+    except ImportError:
+        # 回退: 内联 parser (common 不可用时)
+        return _main_legacy()
+
+    COMMANDS = [
+        ('create', 'Create a new task', [
+            ('title', {'help': 'Task title'}),
+            ('--slug', {'help': 'URL-safe slug (auto-generated if omitted)'}),
+            ('--assignee', {'help': 'Assignee (defaults to current developer)'}),
+            ('--priority', {'choices': ['P0', 'P1', 'P2', 'P3'], 'default': 'P2'}),
+            ('--req-id', {'default': None, 'help': '关联的需求编号 REQ-xxxx (用于 PRD↔Task 串联)'}),
+        ], cmd_create),
+        ('start', 'Start a task', [
+            ('dir', {'help': 'Task directory or name'}),
+        ], cmd_start),
+        ('current', 'Show current task', [
+            ('--source', {'action': 'store_true', 'help': 'Show source info'}),
+        ], cmd_current),
+        ('finish', 'Finish current task', [], cmd_finish),
+        ('archive', 'Archive a task', [
+            ('dir', {'help': 'Task directory or name'}),
+        ], cmd_archive),
+        ('list', 'List tasks', [
+            ('--mine', {'action': 'store_true', 'help': 'Only my tasks (assignee or creator)'}),
+            ('--status', {'help': 'Filter by status'}),
+            ('--ready', {'action': 'store_true', 'help': '只显示可立即开始的 (无未完成依赖)'}),
+            ('--blocked', {'action': 'store_true', 'help': '只显示被阻塞的任务'}),
+        ], cmd_list),
+        ('show', 'Show task details', [
+            ('dir', {'help': 'Task directory or name'}),
+        ], cmd_show),
+        ('add-subtask', 'Add subtask', [
+            ('parent', {'help': 'Parent task'}),
+            ('child', {'help': 'Child task'}),
+        ], cmd_add_subtask),
+        ('remove-subtask', 'Remove subtask', [
+            ('parent', {'help': 'Parent task'}),
+            ('child', {'help': 'Child task'}),
+        ], cmd_remove_subtask),
+        ('set-due', 'Set due date (YYYY-MM-DD)', [
+            ('task', {'help': 'Task name'}),
+            ('due_date', {'help': 'Due date YYYY-MM-DD'}),
+        ], cmd_set_due),
+        ('reassign', 'Reassign task to another developer', [
+            ('task', {'help': 'Task name'}),
+            ('new_assignee', {'help': 'New assignee (developer name)'}),
+        ], cmd_reassign),
+        ('block', 'Mark task blocked by another', [
+            ('task', {'help': 'Task that is blocked'}),
+            ('blocker', {'help': 'Task that blocks it (must finish first)'}),
+        ], cmd_block),
+        ('unblock', 'Remove block relationship', [
+            ('task', {'help': 'Task'}),
+            ('blocker', {'help': 'Blocker task'}),
+        ], cmd_unblock),
+        ('gantt', 'Render markdown Gantt chart', [
+            ('--weeks', {'type': int, 'default': 4, 'help': 'Number of weeks to show'}),
+        ], cmd_gantt),
+    ]
+    return run_command(COMMANDS, prog='task', description='QODER Task Management')
+
+
+def _main_legacy() -> int:
+    """回退: common.cmd_registry 不可用时的内联 argparse (与旧版行为一致)。"""
+    parser = argparse.ArgumentParser(description="QODER Task Management")
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+
+    p_create = subparsers.add_parser("create", help="Create a new task")
+    p_create.add_argument("title", help="Task title")
+    p_create.add_argument("--slug", help="URL-safe slug (auto-generated if omitted)")
+    p_create.add_argument("--assignee", help="Assignee (defaults to current developer)")
+    p_create.add_argument("--priority", choices=["P0", "P1", "P2", "P3"], default="P2")
+    p_create.add_argument("--req-id", default=None,
+                          help="关联的需求编号 REQ-xxxx (用于 PRD↔Task 串联)")
+    p_create.set_defaults(func=cmd_create)
+
+    p_start = subparsers.add_parser("start", help="Start a task")
+    p_start.add_argument("dir", help="Task directory or name")
+    p_start.set_defaults(func=cmd_start)
+
+    p_current = subparsers.add_parser("current", help="Show current task")
+    p_current.add_argument("--source", action="store_true", help="Show source info")
+    p_current.set_defaults(func=cmd_current)
+
+    p_finish = subparsers.add_parser("finish", help="Finish current task")
+    p_finish.set_defaults(func=cmd_finish)
+
+    p_archive = subparsers.add_parser("archive", help="Archive a task")
+    p_archive.add_argument("dir", help="Task directory or name")
+    p_archive.set_defaults(func=cmd_archive)
+
+    p_list = subparsers.add_parser("list", help="List tasks")
+    p_list.add_argument("--mine", action="store_true", help="Only my tasks")
+    p_list.add_argument("--status", help="Filter by status")
+    p_list.add_argument("--ready", action="store_true", help="可立即开始")
+    p_list.add_argument("--blocked", action="store_true", help="被阻塞")
+    p_list.set_defaults(func=cmd_list)
+
+    p_show = subparsers.add_parser("show", help="Show task details")
+    p_show.add_argument("dir", help="Task directory or name")
+    p_show.set_defaults(func=cmd_show)
+
+    for cmd, fn in [
+        ("add-subtask", cmd_add_subtask), ("remove-subtask", cmd_remove_subtask),
+    ]:
+        p = subparsers.add_parser(cmd)
+        p.add_argument("parent"); p.add_argument("child")
+        p.set_defaults(func=fn)
+
+    p_due = subparsers.add_parser("set-due")
+    p_due.add_argument("task"); p_due.add_argument("due_date")
+    p_due.set_defaults(func=cmd_set_due)
+
+    p_reassign = subparsers.add_parser("reassign")
+    p_reassign.add_argument("task"); p_reassign.add_argument("new_assignee")
+    p_reassign.set_defaults(func=cmd_reassign)
+
+    for cmd, fn in [("block", cmd_block), ("unblock", cmd_unblock)]:
+        p = subparsers.add_parser(cmd)
+        p.add_argument("task"); p.add_argument("blocker")
+        p.set_defaults(func=fn)
+
+    p_gantt = subparsers.add_parser("gantt")
+    p_gantt.add_argument("--weeks", type=int, default=4)
+    p_gantt.set_defaults(func=cmd_gantt)
+
+    args = parser.parse_args()
+    if not hasattr(args, "func"):
+        parser.print_help()
+        return 1
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())