@hupan56/wlkj 3.0.0 → 3.1.3

package/templates/qoder/scripts/{task → domain/task}/team_sync.py

@@ -2,7 +2,12 @@
 # -*- coding: utf-8 -*-
 # v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
 import os as _o, sys as _s
-_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+_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()
 
@@ -40,8 +45,8 @@ if sys.platform == 'win32':
         pass
 
 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-from common.paths import get_repo_root, get_developer
-from common.filelock import FileLock, LockTimeoutError
+from foundation.core.paths import get_repo_root, get_developer
+from foundation.io.filelock import FileLock, LockTimeoutError
 from syncgate import run_gates, SAFE_EXTENSIONS
 
 BASE = str(get_repo_root())
@@ -114,7 +119,7 @@ def _notify_prd_publications(staged_files):
     """
     import re as _re
     try:
-        from common.feishu import notify_prd_published, is_enabled
+        from foundation.integrations.feishu import notify_prd_published, is_enabled
     except ImportError as e:
         print('[sync] WARN: feishu 模块缺失, 跳过 PRD 发布通知: %s' % e, file=sys.stderr)
         return

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

@@ -0,0 +1,370 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+zentao_sync.py - 本地任务 ↔ 禅道 双向同步（安全优先）
+
+设计目标 (回应团队最担心的「拉错/覆盖队友」):
+  - 拉取(禅道→本地): 强制 assignedTo == 我的禅道账号 过滤, 物理上拉不到队友任务。
+  - 推送(本地→禅道): 默认 --dry-run, 仅推 creator==我 的任务, 且禅道同名任务
+                     assignedTo 须与我一致才更新, 不一致拒绝 (防误改队友任务)。
+  - 幂等: task.json 的 zentao_id 做主键, 已有则跳过 create。
+
+隔离契约: contracts/isolation.md「禅道同步」红线。
+归属映射: member.json 的 zentao_account 字段 (本地 dev 名 ↔ 禅道 account)。
+
+用法:
+  python .qoder/scripts/domain/task/zentao_sync.py pull <execution_id> [--apply]   # 默认 dry-run 预览
+  python .qoder/scripts/domain/task/zentao_sync.py push [--execution_id N] [--apply]
+  python .qoder/scripts/domain/task/zentao_sync.py status                          # 看同步状态概览
+
+退出码:
+  0 成功 (含 dry-run 预览); 2 busy; 3 配置/归属错误; 4 权限拒绝; 5 网络不通
+"""
+import os
+import sys
+
+# ── 路径自举: 让脚本能独立运行 (复用 bootstrap 模式) ──
+# task_utils/identity 用相对导入 (.paths), 必须从 common 包上下文导入,
+# 因此把 scripts/ 加入 path, 用 common.xxx / task.xxx 访问。
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_SCRIPTS = os.path.dirname(_HERE)          # .qoder/scripts
+_COMMON = os.path.join(_SCRIPTS, 'foundation')
+for _p in (_SCRIPTS, _COMMON):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+try:
+    from bootstrap import setup; setup()
+except Exception:
+    pass
+
+import json
+import argparse
+
+from foundation.core.paths import get_repo_root, get_tasks_dir, get_developer
+from foundation.identity.identity import get_member
+from foundation.data.task_utils import modify_task_json, load_task_json, write_task_json
+from foundation.integrations.zentao_client import ZentaoClient
+from datetime import datetime
+from pathlib import Path
+
+
+def _create_local_task(repo_root, title, slug_seed, zentao_id, developer):
+    """直接创建本地任务目录 + task.json (含 zentao_id), 不走 cmd_create。
+
+    自包含, 避免 cmd_create 的 argparse Namespace 签名 + team_sync stage 副作用。
+    返回新建的 task_dir 或 None。"""
+    date_prefix = datetime.now().strftime("%m-%d")
+    tasks_dir = get_tasks_dir(repo_root)
+    task_dir_name = "%s-%s" % (date_prefix, slug_seed)
+    task_dir = tasks_dir / task_dir_name
+    if task_dir.exists():
+        # 撞名加后缀
+        task_dir_name = "%s-%s-%s" % (date_prefix, slug_seed, developer[:6])
+        task_dir = tasks_dir / task_dir_name
+    task_dir.mkdir(parents=True, exist_ok=True)
+    now_iso = datetime.now().isoformat()
+    task_data = {
+        "title": title, "slug": slug_seed, "status": "planning", "priority": "P2",
+        "assignee": developer, "creator": developer,
+        "created_at": now_iso, "updated_at": now_iso,
+        "branch": None, "base_branch": None, "scope": None,
+        "parent": None, "children": [], "tags": [],
+        "due_date": None, "start_date": None, "estimate_hours": None,
+        "blocked_by": [], "blocks": [],
+        "stage_ts": {"created": now_iso, "started": None, "completed": None},
+        "zentao_id": zentao_id,
+    }
+    if write_task_json(task_dir, task_data):
+        return task_dir
+    return None
+
+
+# ============================================================
+# 配置与归属解析
+# ============================================================
+
+def _zentao_creds():
+    """构建禅道客户端。凭据不全返回 None。
+    底层 HTTP 逻辑收敛在 common.zentao_client.ZentaoClient (与 mcp_server 共享)。"""
+    return ZentaoClient.from_config()
+
+
+def _resolve_my_account(developer):
+    """解析当前本地 developer → 禅道 account。
+    无 member.json 或无 zentao_account → 返回 (None, 原因)。"""
+    mem = get_member(developer)
+    if not mem:
+        return None, '当前开发者 %s 未注册 (无 member.json)。请先 /wl-init。' % developer
+    acc = (mem.get('zentao_account') or '').strip()
+    if not acc:
+        return None, ('%s 的 member.json 未配 zentao_account (本地名↔禅道账号映射)。'
+                      '\n  手动编辑 workspace/members/%s/member.json 加 "zentao_account": "你的禅道账号"。'
+                      % (developer, developer))
+    return acc, None
+
+
+# ============================================================
+# 禅道 HTTP 层已收敛到 common.zentao_client.ZentaoClient (与 mcp_server 共享同一份)
+# 下面 cmd_* 通过 creds (ZentaoClient 实例) 的 .api() / .check_intranet() 调用
+# ============================================================
+
+# ============================================================
+# 本地任务遍历
+# ============================================================
+
+def _iter_local_tasks(repo_root):
+    """遍历 workspace/tasks/*/task.json, yield (task_dir, data)。"""
+    tdir = get_tasks_dir(repo_root)
+    if not tdir.is_dir():
+        return
+    for child in sorted(tdir.iterdir()):
+        if not child.is_dir():
+            continue
+        data = load_task_json(child)
+        if data:
+            yield child, data
+
+
+# ============================================================
+# 拉取: 禅道 → 本地 (归属硬过滤)
+# ============================================================
+
+def cmd_pull(args, creds, my_account):
+    """拉取某执行下 assignedTo==我 的任务到本地。默认 dry-run。"""
+    eid = args.execution_id
+    print('═══ 拉取 执行 #%s (仅 assignedTo=%s) ═══' % (eid, my_account))
+    if not args.apply:
+        print('[DRY-RUN] 仅预览, 不写本地。加 --apply 才真写。\n')
+
+    r = creds.api('GET', '/executions/%s/tasks' % eid, {'limit': 100})
+    if r.status_code != 200:
+        print('查询失败: %s %s' % (r.status_code, r.text[:120]))
+        return 3
+    data = r.json()
+    tasks = data.get('tasks') if isinstance(data, dict) else None
+    if not isinstance(tasks, list):
+        print('响应格式异常 (无 tasks 列表)。')
+        return 3
+
+    # ── 归属硬过滤: 只取 assignedTo == 我 ──
+    mine = [t for t in tasks if isinstance(t, dict)
+            and str(t.get('assignedTo', '')) == my_account]
+    skipped = len(tasks) - len(mine)
+    print('执行 #%s 共 %d 个任务, 归属我的 %d 个 (跳过队友 %d 个, 不拉)。\n'
+          % (eid, len(tasks), len(mine), skipped))
+
+    if not mine:
+        print('没有归属你的任务, 无需同步。')
+        return 0
+
+    # 建立本地 zentao_id 索引 (防重复 create)
+    repo_root = get_repo_root()
+    existing_zids = {}
+    for td, d in _iter_local_tasks(repo_root):
+        zid = d.get('zentao_id')
+        if zid:
+            existing_zids[int(zid)] = td
+
+    created = skipped_dup = 0
+    for t in mine:
+        zid = int(t.get('id', 0))
+        name = str(t.get('name', ''))[:50]
+        status = t.get('status', '')
+        if zid in existing_zids:
+            print('  ⊘ 跳过 #%s「%s」(本地已有 zentao_id=%s)' % (zid, name, zid))
+            skipped_dup += 1
+            continue
+        if not args.apply:
+            print('  ＋ [将创建] #%s「%s」status=%s' % (zid, name, status))
+            created += 1
+            continue
+        # 真写: 直接创建本地任务 (含 zentao_id), 自包含不走 cmd_create
+        slug_seed = 'zentao-%s' % zid
+        new_dir = _create_local_task(repo_root, 'zentao#%s %s' % (zid, name),
+                                     slug_seed, zid, developer)
+        if new_dir:
+            print('  ✅ 创建 #%s「%s」并回填 zentao_id -> %s' % (zid, name, new_dir.name))
+            created += 1
+        else:
+            print('  ⚠️ 创建 #%s 失败' % zid)
+
+    print('\n小结: 创建 %d, 幂等跳过 %d, 队友任务跳过 %d。%s'
+          % (created, skipped_dup, skipped,
+             '(dry-run, 未真写)' if not args.apply else ''))
+    return 0
+
+
+# ============================================================
+# 推送: 本地 → 禅道 (默认 dry-run + 双校验)
+# ============================================================
+
+def cmd_push(args, creds, my_account, developer):
+    """推送本地 creator==我 的任务到禅道。默认 dry-run。"""
+    print('═══ 推送 本地 → 禅道 (仅 creator=%s, 强制 assignedTo=%s) ═══'
+          % (developer, my_account))
+    if not args.apply:
+        print('[DRY-RUN] 仅预览, 不写禅道。加 --apply 才真推。\n')
+
+    repo_root = get_repo_root()
+    candidates = []
+    for td, d in _iter_local_tasks(repo_root):
+        # ── 校验 1: 只推我创建的 (复用本地归属) ──
+        if (d.get('creator') or '') != developer:
+            continue
+        candidates.append((td, d))
+
+    if not candidates:
+        print('没有你创建的本地任务可推送。')
+        return 0
+
+    print('本地归属你的任务 %d 个:\n' % len(candidates))
+    pushed = skipped = 0
+    for td, d in candidates:
+        zid = d.get('zentao_id')
+        title = str(d.get('title', ''))[:50]
+        if zid:
+            # 已有 zentao_id → 更新前校验归属一致性
+            chk = creds.api('GET', '/tasks/%s' % zid)
+            if chk.status_code == 200:
+                remote_assign = str(chk.json().get('assignedTo', ''))
+                if remote_assign != my_account:
+                    print('  🚫 拒绝更新 #%s「%s」: 禅道 assignedTo=%s ≠ 你(%s)'
+                          '  (防误改队友任务)' % (zid, title, remote_assign, my_account))
+                    skipped += 1
+                    continue
+                if not args.apply:
+                    print('  ⟳ [将更新] #%s「%s」' % (zid, title))
+                    pushed += 1
+                    continue
+                payload = {'name': d.get('title', ''), 'assignedTo': my_account}
+                if d.get('estimate_hours'):
+                    payload['estimate'] = d['estimate_hours']
+                if d.get('due_date'):
+                    payload['deadline'] = d['due_date']
+                upd = creds.api('PUT', '/tasks/%s' % zid, payload)
+                print('  %s 更新 #%s「%s」%s'
+                      % ('✅' if upd.status_code in (200, 201) else '⚠️', zid, title,
+                         '' if upd.status_code in (200, 201) else '(%s)' % upd.status_code))
+                pushed += 1
+            else:
+                print('  ⚠️ 查询 #%s 失败 (%s), 跳过' % (zid, chk.status_code))
+                skipped += 1
+        else:
+            # 无 zentao_id → 新建 (强制 assignedTo=我)
+            if not args.execution_id:
+                print('  ⊙ 跳过「%s」(无 zentao_id, 且未给 --execution_id, 无法新建)'
+                      % title)
+                skipped += 1
+                continue
+            if not args.apply:
+                print('  ＋ [将新建]「%s」→ 执行 #%s' % (title, args.execution_id))
+                pushed += 1
+                continue
+            payload = {'execution': args.execution_id, 'name': d.get('title', ''),
+                       'assignedTo': my_account, 'type': 'devel', 'pri': 3}
+            cre = creds.api('POST', '/tasks', payload)
+            if cre.status_code in (200, 201):
+                new_zid = cre.json().get('id')
+                def _set(d, _z=new_zid):
+                    d['zentao_id'] = _z
+                modify_task_json(td, _set)
+                print('  ✅ 新建「%s」→ 禅道 #%s, 回填 zentao_id' % (title, new_zid))
+                pushed += 1
+            else:
+                print('  ⚠️ 新建「%s」失败 (%s)' % (title, cre.status_code))
+                skipped += 1
+
+    print('\n小结: 推送 %d, 跳过 %d。%s'
+          % (pushed, skipped, '(dry-run, 未真写)' if not args.apply else ''))
+    return 0
+
+
+# ============================================================
+# status 概览
+# ============================================================
+
+def cmd_status(args, creds, my_account, developer):
+    """看本地任务与禅道的关联状态概览 (只读)。"""
+    repo_root = get_repo_root()
+    total = mine = linked = unlinked = 0
+    for td, d in _iter_local_tasks(repo_root):
+        total += 1
+        if (d.get('creator') or '') == developer:
+            mine += 1
+            if d.get('zentao_id'):
+                linked += 1
+            else:
+                unlinked += 1
+    print('═══ 同步状态 (%s / 禅道账号 %s) ═══' % (developer, my_account))
+    print('本地任务总数: %d' % total)
+    print('  归属你的:    %d' % mine)
+    print('    已关联禅道 (有 zentao_id): %d' % linked)
+    print('    未关联禅道 (推送时需 --execution_id 新建): %d' % unlinked)
+    ok, _ = creds.check_intranet()
+    print('\n禅道连通: %s (%s)' % ('✅ 可达' if ok else '❌ 不可达', creds.url))
+    return 0
+
+
+# ============================================================
+# 主入口
+# ============================================================
+
+def main(argv=None):
+    p = argparse.ArgumentParser(description='本地任务 ↔ 禅道安全同步',
+                                formatter_class=argparse.RawDescriptionHelpFormatter,
+                                epilog='安全原则: 拉取只取 assignedTo=我; 推送默认 dry-run 且'
+                                       ' 仅推 creator=我, 同名任务归属不一致则拒绝。')
+    sub = p.add_subparsers(dest='cmd')
+
+    pp = sub.add_parser('pull', help='拉取禅道任务到本地 (仅 assignedTo=我)')
+    pp.add_argument('execution_id', type=int, help='执行ID')
+    pp.add_argument('--apply', action='store_true', help='真写 (默认 dry-run 仅预览)')
+
+    sp = sub.add_parser('push', help='推送本地任务到禅道 (默认 dry-run)')
+    sp.add_argument('--execution_id', type=int, help='新建任务落到哪个执行 (无 zentao_id 的任务需要)')
+    sp.add_argument('--apply', action='store_true', help='真推 (默认 dry-run 仅预览)')
+
+    sub.add_parser('status', help='看同步状态概览 (只读)')
+
+    args = p.parse_args(argv)
+    if not args.cmd:
+        p.print_help()
+        return 0
+
+    developer = get_developer()
+    if not developer:
+        print('ERROR: 未设置当前开发者 (无 .developer)。请先 /wl-init。', file=sys.stderr)
+        return 4
+
+    my_account, err = _resolve_my_account(developer)
+    if err:
+        print('ERROR: %s' % err, file=sys.stderr)
+        return 3
+
+    creds = _zentao_creds()
+    if not creds:
+        print('ERROR: 禅道凭据未配置。请在 .qoder/config.yaml 的 zentao: 段填 url/user/password。',
+              file=sys.stderr)
+        return 3
+
+    # 连通性预检
+    ok, msg = creds.check_intranet()
+    if not ok:
+        print('ERROR: %s' % msg, file=sys.stderr)
+        return 5
+
+    try:
+        if args.cmd == 'pull':
+            return cmd_pull(args, creds, my_account)
+        elif args.cmd == 'push':
+            return cmd_push(args, creds, my_account, developer)
+        elif args.cmd == 'status':
+            return cmd_status(args, creds, my_account, developer)
+    except RuntimeError as e:
+        print('ERROR: %s' % e, file=sys.stderr)
+        return 3
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

package/templates/qoder/scripts/{common → foundation}/bootstrap.py

@@ -4,23 +4,23 @@ bootstrap.py - 统一 CLI 启动样板 (DRY) + 子目录化路径自举 (v3.0)
 
 治"70处 sys.path + 50处 reconfigure" + 子目录化后的路径定位。
 
-子目录化后, 脚本在 scripts/kg/kg.py, 它的 dirname(__file__)=scripts/kg/,
-直接 sys.path.insert(scripts/kg/) 后 `from common.x` 会断 (common 在 scripts/common/)。
+子目录化后, 脚本在 scripts/domain/kg/kg.py, 它的 dirname(__file__)=scripts/domain/kg/,
+直接 sys.path.insert(scripts/domain/kg/) 后 `from foundation.x` 会断 (foundation 在 scripts/foundation/)。
 
 本模块的 setup() 解决: 无论脚本在 scripts/ 根还是 scripts/某子包/,
-都能正确定位 scripts/ 根并注入, 让 `from common.x` 和跨包 import 都能用。
+都能正确定位 scripts/ 根并注入, 让 `from foundation.x` 和跨包 import 都能用。
 
-核心: _find_scripts_root() 向上找含 'common/' 子目录的那个目录 = scripts/ 根。
+核心: _find_scripts_root() 向上找含 'foundation/' 子目录的那个目录 = scripts/ 根。
 
 Usage (两种姿势):
     # 姿势1: 子包脚本开头 (推荐)
     import os, sys
     _S = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))  # 子包→scripts
     if _S not in sys.path: sys.path.insert(0, _S)
-    from common.bootstrap import setup; setup()
+    from bootstrap import setup; setup()
 
     # 姿势2: scripts/ 根脚本 (老姿势仍可用)
-    from common.bootstrap import setup; setup()
+    from bootstrap import setup; setup()
 """
 
 import os
@@ -40,7 +40,7 @@ def find_scripts_root(start=None):
     cur = start
     for _ in range(10):
         # scripts/ 根的标志: 含 common/bootstrap.py
-        if os.path.isfile(os.path.join(cur, "common", "bootstrap.py")):
+        if os.path.isfile(os.path.join(cur, "foundation", "bootstrap.py")):
             return cur
         parent = os.path.dirname(cur)
         if parent == cur:
@@ -62,7 +62,7 @@ def find_scripts_root(start=None):
 def ensure_scripts_path(start=None):
     """确保 scripts/ 根在 sys.path 最前。幂等。
 
-    子包脚本调用此函数后, `from common.x` 即可用。
+    子包脚本调用此函数后, `from foundation.x` 即可用。
     """
     root = find_scripts_root(start)
     if root not in sys.path:
@@ -107,7 +107,7 @@ def setup():
     scripts_dir = ensure_scripts_root = find_scripts_root()
     if scripts_dir not in sys.path:
         sys.path.insert(0, scripts_dir)
-    common_dir = os.path.join(scripts_dir, "common")
+    common_dir = os.path.join(scripts_dir, "foundation")
     if os.path.isdir(common_dir) and common_dir not in sys.path:
         sys.path.insert(0, common_dir)
     # 注入所有子包目录 (kg/build/mcp/test/setup/carriers/task/search/report)
@@ -142,4 +142,4 @@ def setup():
 
 # 模块级常量
 SCRIPTS_DIR = find_scripts_root()
-REPO_ROOT = os.path.dirname(os.path.dirname(SCRIPTS_DIR))
+REPO_ROOT = os.path.dirname(os.path.dirname(os.path.dirname(os.path.dirname(SCRIPTS_DIR))))

package/templates/qoder/scripts/{common → foundation/core}/cmd_registry.py

@@ -17,7 +17,7 @@ args_spec 格式 (简化 argparse.add_argument):
   ]
 
 Usage:
-    from common.cmd_registry import build_parser
+    from foundation.core.cmd_registry import build_parser
 
     COMMANDS = [
         ('create', '建任务', [

package/templates/qoder/scripts/{common → foundation/core}/config.py

@@ -12,7 +12,7 @@ config.py - Config 单例 (Singleton 模式, 治"4份 load_config + 明文凭据
   - 凭据从代码移除: mysql/zentao 密码只在 config.yaml, 不在源码默认值
 
 Usage:
-    from common.config import Config, SECTIONS
+    from foundation.core.config import Config, SECTIONS
     cfg = Config.load()           # 单例, 全进程共享
     feishu = cfg.section('feishu')   # {'enabled': false, ...}
     mysql = cfg.mysql               # 类型化便捷访问