@hupan56/wlkj 2.0.0

package/templates/qoder/scripts/common/paths.py

@@ -0,0 +1,311 @@
+# -*- coding: utf-8 -*-
+"""
+Path management - central path config
+
+All paths managed from one place:
+- .qoder/ = engine (AI reads)
+- workspace/ = work area (humans see)
+- Strictly separated
+
+Reference: Trellis path management
+"""
+
+import os
+import sys
+from pathlib import Path
+from typing import Optional, Dict
+
+# Project root (auto-detect: find .qoder/ upward)
+def _find_repo_root() -> Path:
+    """Find project root by searching for .qoder/ directory."""
+    current = Path(__file__).resolve().parent
+    for _ in range(10):
+        if (current / ".qoder").is_dir():
+            return current
+        parent = current.parent
+        if parent == current:
+            break
+        current = parent
+    return Path(__file__).resolve().parent.parent.parent.parent.parent
+
+PROJECT_ROOT = _find_repo_root()
+
+# =============================================================================
+# Engine paths (.qoder/)
+# =============================================================================
+
+QODER_DIR = PROJECT_ROOT / ".qoder"
+RUNTIME_DIR = QODER_DIR / ".runtime"
+SESSIONS_DIR = RUNTIME_DIR / "sessions"
+ARCHIVE_DIR = QODER_DIR / "archive"
+RULES_DIR = QODER_DIR / "rules"
+CONTEXT_DIR = QODER_DIR / "context"
+SKILLS_DIR = QODER_DIR / "skills"
+AGENTS_DIR = QODER_DIR / "agents"
+HOOKS_DIR = QODER_DIR / "hooks"
+SCRIPTS_DIR = QODER_DIR / "scripts"
+
+# =============================================================================
+# Workspace paths (workspace/)
+# =============================================================================
+
+WORKSPACE_DIR = PROJECT_ROOT / "workspace"
+SPECS_DIR = WORKSPACE_DIR / "specs"
+PRD_DIR = SPECS_DIR / "prd"
+TASKS_DIR = WORKSPACE_DIR / "tasks"
+CONSTITUTION_DIR = WORKSPACE_DIR / "constitution"
+MEMBERS_DIR = WORKSPACE_DIR / "members"
+
+# =============================================================================
+# Developer files
+# =============================================================================
+
+DEVELOPER_FILE = QODER_DIR / ".developer"
+CURRENT_TASK_FILE = QODER_DIR / ".current-task"
+
+# =============================================================================
+# Legacy compatibility constants (used by task.py, developer.py, etc.)
+# =============================================================================
+
+DIR_TASKS = "workspace/tasks"
+DIR_ARCHIVE = ".qoder/archive"
+DIR_WORKFLOW = ".qoder"
+DIR_WORKSPACE = "workspace/members"
+DIR_SPECS = "workspace/specs"
+
+FILE_TASK_JSON = "task.json"
+FILE_DEVELOPER = ".developer"
+FILE_JOURNAL_PREFIX = "journal-"
+
+
+# =============================================================================
+# Core functions
+# =============================================================================
+
+def get_repo_root() -> Path:
+    """Get project root directory."""
+    return PROJECT_ROOT
+
+
+def ensure_dirs():
+    """Ensure all necessary directories exist."""
+    dirs = [
+        WORKSPACE_DIR, SPECS_DIR, PRD_DIR, TASKS_DIR,
+        CONSTITUTION_DIR, MEMBERS_DIR,
+        RUNTIME_DIR, SESSIONS_DIR, ARCHIVE_DIR,
+    ]
+    for d in dirs:
+        d.mkdir(parents=True, exist_ok=True)
+
+
+def _parse_developer_file(content: str) -> Dict[str, str]:
+    """Parse .developer content. Accepts both 'name=x' and 'name: x' formats."""
+    info = {}
+    for line in content.splitlines():
+        line = line.strip()
+        if not line or line.startswith("#"):
+            continue
+        for sep in ("=", ":"):
+            if sep in line:
+                k, v = line.split(sep, 1)
+                info[k.strip()] = v.strip()
+                break
+    return info
+
+
+def get_developer(repo_root: Optional[Path] = None) -> Optional[str]:
+    """Get current developer name from .developer file."""
+    if repo_root is None:
+        repo_root = PROJECT_ROOT
+    dev_file = repo_root / ".qoder" / ".developer"
+    if not dev_file.is_file():
+        return None
+    try:
+        content = dev_file.read_text(encoding="utf-8")
+    except UnicodeDecodeError:
+        try:
+            content = dev_file.read_text(encoding="gbk")
+        except (OSError, IOError, UnicodeDecodeError):
+            return None
+    except (OSError, IOError):
+        return None
+    return _parse_developer_file(content).get("name") or None
+
+
+def check_developer(repo_root: Optional[Path] = None) -> bool:
+    """Check if developer is initialized."""
+    return get_developer(repo_root) is not None
+
+
+def get_developer_info(repo_root: Optional[Path] = None) -> Optional[Dict]:
+    """Get developer info as dict."""
+    if repo_root is None:
+        repo_root = PROJECT_ROOT
+    dev_file = repo_root / ".qoder" / ".developer"
+    if not dev_file.is_file():
+        return None
+    try:
+        content = dev_file.read_text(encoding="utf-8")
+    except UnicodeDecodeError:
+        try:
+            content = dev_file.read_text(encoding="gbk")
+        except (OSError, IOError, UnicodeDecodeError):
+            return None
+    except (OSError, IOError):
+        return None
+    info = _parse_developer_file(content)
+    return info if info else None
+
+
+def get_developer_dir(developer_name: str) -> Path:
+    """Get developer personal directory under workspace/members/."""
+    dev_dir = MEMBERS_DIR / developer_name
+    dev_dir.mkdir(parents=True, exist_ok=True)
+    return dev_dir
+
+
+def get_developer_journal_dir(developer_name: str) -> Path:
+    """Get developer journal directory."""
+    journal_dir = get_developer_dir(developer_name) / "journal"
+    journal_dir.mkdir(parents=True, exist_ok=True)
+    return journal_dir
+
+
+def get_developer_drafts_dir(developer_name: str) -> Path:
+    """Get developer drafts directory."""
+    drafts_dir = get_developer_dir(developer_name) / "drafts"
+    drafts_dir.mkdir(parents=True, exist_ok=True)
+    return drafts_dir
+
+
+def get_workspace_dir(repo_root: Optional[Path] = None) -> Optional[Path]:
+    """Get developer workspace directory."""
+    dev = get_developer(repo_root)
+    if not dev:
+        return None
+    return MEMBERS_DIR / dev
+
+
+def get_active_journal_file(repo_root: Optional[Path] = None) -> Optional[Path]:
+    """Get developer active journal file."""
+    ws = get_workspace_dir(repo_root)
+    if not ws:
+        return None
+    journal_dir = ws / "journal"
+    if not journal_dir.is_dir():
+        return None
+    journals = sorted(journal_dir.glob("journal-*.md"))
+    return journals[-1] if journals else None
+
+
+def get_tasks_dir(repo_root: Optional[Path] = None) -> Path:
+    """Get tasks directory (workspace/tasks/)."""
+    if repo_root is None:
+        repo_root = PROJECT_ROOT
+    tasks = repo_root / "workspace" / "tasks"
+    tasks.mkdir(parents=True, exist_ok=True)
+    return tasks
+
+
+def _current_task_file(repo_root: Path, developer: Optional[str] = None) -> Path:
+    """当前任务文件路径。
+
+    零信任隔离: 按开发者命名, 避免共享机器上 A 的 current-task 被 B 覆盖。
+    developer=None 时回退到旧的全局 .current-task (向后兼容读取)。
+    """
+    repo_root = Path(repo_root)  # 容忍 str 输入
+    runtime = repo_root / ".qoder" / ".runtime"
+    if developer:
+        # 文件名只允许安全字符 (member name 已校验, 但防御性 sanitize)
+        safe = "".join(c for c in developer if c.isalnum() or c in "_-") or "anon"
+        return runtime / f"current-task.{safe}"
+    return repo_root / ".qoder" / ".current-task"
+
+
+def _read_task_file(path: Path) -> Optional[str]:
+    """读任务文件, 支持 UTF-8 和 GBK fallback (审计 H6: Notepad 默认 GBK)。"""
+    if not path.is_file():
+        return None
+    for enc in ("utf-8", "gbk", "utf-8-sig"):
+        try:
+            content = path.read_text(encoding=enc).strip()
+            return content if content else None
+        except (OSError, IOError, UnicodeDecodeError):
+            continue
+    return None
+
+
+def get_current_task(
+    repo_root: Optional[Path] = None,
+    developer: Optional[str] = None,
+) -> Optional[str]:
+    """Get current task.
+
+    优先读按开发者隔离的 .runtime/current-task.{dev};
+    若无则回退到旧的全局 .current-task (向后兼容, 会自动迁移)。
+    developer=None 时自动用 get_developer() 推断。
+    """
+    if repo_root is None:
+        repo_root = PROJECT_ROOT
+    if developer is None:
+        developer = get_developer(repo_root)
+    # 1. 优先读 developer 隔离的文件
+    if developer:
+        ct = _read_task_file(_current_task_file(repo_root, developer))
+        if ct:
+            return ct
+    # 2. 回退到旧全局文件 (兼容历史)
+    legacy = _read_task_file(_current_task_file(repo_root, None))
+    return legacy
+
+
+def set_current_task(
+    task_path: Optional[str],
+    repo_root: Optional[Path] = None,
+    developer: Optional[str] = None,
+) -> None:
+    """Set current task (按开发者隔离写入)。
+
+    零信任: 写入 .runtime/current-task.{dev}, 不再写全局 .current-task。
+    若 task_path=None 则清除该开发者的指针 (不影响他人)。
+    """
+    if repo_root is None:
+        repo_root = PROJECT_ROOT
+    if developer is None:
+        developer = get_developer(repo_root)
+    ct_file = _current_task_file(repo_root, developer)
+    try:
+        ct_file.parent.mkdir(parents=True, exist_ok=True)
+        if task_path:
+            ct_file.write_text(task_path, encoding="utf-8")
+        else:
+            ct_file.unlink(missing_ok=True)
+    except (OSError, IOError) as e:
+        print(f"Warning: Failed to write current-task: {e}", file=sys.stderr)
+
+
+def get_module_spec_dir(module: Optional[str] = None) -> Path:
+    """Get module spec directory."""
+    if module:
+        spec_dir = SPECS_DIR / module
+    else:
+        spec_dir = SPECS_DIR
+    spec_dir.mkdir(parents=True, exist_ok=True)
+    return spec_dir
+
+
+def get_task_dir(slug: str) -> Path:
+    """Get task directory by slug."""
+    from datetime import datetime
+    date_prefix = datetime.now().strftime("%m-%d")
+    task_dir = TASKS_DIR / "{0}-{1}".format(date_prefix, slug)
+    task_dir.mkdir(parents=True, exist_ok=True)
+    return task_dir
+
+
+def count_lines(file_path: Path) -> int:
+    """Count lines in a file."""
+    try:
+        return sum(1 for _ in file_path.open("r", encoding="utf-8"))
+    except (OSError, IOError):
+        return 0

package/templates/qoder/scripts/common/reqid.py

@@ -0,0 +1,218 @@
+# -*- coding: utf-8 -*-
+"""
+reqid.py - REQ-ID 原子分配器 + 撞号检测
+
+解决"两个 PM 同时扫到最大 REQ 号 +1, 都用同一个号"的生产事故。
+(已在 data/docs/prd/ 出现两个 REQ-2026-003 的真实撞号)
+
+设计:
+    - 中央计数器 data/index/req-counter.json: {"2026": 7, "2025": 47}
+    - allocate_req_id(year) 在 FileLock 内读+1+写, 保证原子
+    - validate_req_ids(staged_prds) 在 team_sync push 前校验:
+      (a) 格式合法 REQ-{YYYY}-{NNN}
+      (b) NNN <= 当前计数器 (防"跳号"或"未来号")
+      (c) 同一批无重复 ID
+    - migrate_from_existing() 一次性扫描, 把计数器初始化为现有最大值
+
+核心 API:
+    allocate_req_id(year=None) -> int       # 拿一个新 NNN
+    current_counter(year=None) -> int       # 看当前最大 (不递增)
+    validate_req_ids(prd_paths, repo_root)  # 校验, 不合法抛 ReqIdError
+    migrate_from_existing(repo_root)        # 初始化计数器
+    parse_req_id(filename) -> (year, n) | None
+"""
+
+import os
+import re
+import sys
+from datetime import datetime
+from pathlib import Path
+from typing import Optional, Tuple, List, Union
+
+_THIS_DIR = os.path.dirname(os.path.abspath(__file__))
+if _THIS_DIR not in sys.path:
+    sys.path.insert(0, _THIS_DIR)
+
+try:
+    from .atomicio import atomic_write_json, safe_read_json
+    from .filelock import FileLock, LockTimeoutError
+    from .paths import get_repo_root
+except ImportError:
+    # 被当作脚本直接运行时
+    from atomicio import atomic_write_json, safe_read_json
+    from filelock import FileLock, LockTimeoutError
+    from paths import get_repo_root
+
+__all__ = [
+    "ReqIdError",
+    "allocate_req_id",
+    "current_counter",
+    "validate_req_ids",
+    "migrate_from_existing",
+    "parse_req_id",
+    "REQ_ID_RE",
+]
+
+# REQ-2026-007 格式
+REQ_ID_RE = re.compile(r"REQ-(\d{4})-(\d{3,4})", re.IGNORECASE)
+
+
+class ReqIdError(Exception):
+    """REQ-ID 相关错误 (撞号/非法/超界)。"""
+
+
+def _counter_path(repo_root: Union[str, Path]) -> str:
+    return os.path.join(str(repo_root), "data", "index", "req-counter.json")
+
+
+def _lock_path(repo_root: Union[str, Path]) -> str:
+    return os.path.join(str(repo_root), "data", "index", ".req-lock")
+
+
+def _current_year() -> str:
+    return str(datetime.now().year)
+
+
+def _read_counter(repo_root: Union[str, Path]) -> dict:
+    """读计数器 (不锁)。返回 {year: max_n} dict。"""
+    return safe_read_json(_counter_path(repo_root), default={}) or {}
+
+
+def current_counter(year: Optional[str] = None, repo_root: Optional[Union[str, Path]] = None) -> int:
+    """看某年当前最大 NNN (不递增)。计数器不存在则返回 0。"""
+    if repo_root is None:
+        repo_root = get_repo_root()
+    if year is None:
+        year = _current_year()
+    return int(_read_counter(repo_root).get(str(year), 0))
+
+
+def allocate_req_id(year: Optional[str] = None, repo_root: Optional[Union[str, Path]] = None) -> int:
+    """原子分配一个新 NNN (在文件锁内读+1+写)。
+
+    Returns:
+        分配到的 NNN (整数)。
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+    if year is None:
+        year = _current_year()
+    year = str(year)
+
+    lock = FileLock(_lock_path(repo_root), timeout=30, stale_seconds=300)
+    try:
+        lock.acquire()
+    except LockTimeoutError as e:
+        raise ReqIdError("REQ-ID 分配锁竞争超时 (多人同时创建?): %s" % e)
+    try:
+        counter = _read_counter(repo_root)
+        next_n = int(counter.get(year, 0)) + 1
+        counter[year] = next_n
+        atomic_write_json(_counter_path(repo_root), counter)
+        return next_n
+    finally:
+        lock.release()
+
+
+def parse_req_id(filename_or_path: str) -> Optional[Tuple[int, int]]:
+    """从文件名或路径解析 REQ-{YYYY}-{NNN}。返回 (year, n) 或 None。"""
+    base = os.path.basename(filename_or_path)
+    m = REQ_ID_RE.search(base)
+    if m:
+        return int(m.group(1)), int(m.group(2))
+    return None
+
+
+def validate_req_ids(prd_paths: List[str], repo_root: Union[str, Path]) -> None:
+    """校验一批 PRD 的 REQ-ID。不合法抛 ReqIdError。
+
+    检查:
+      (a) 每个 PRD 文件名必须有 REQ-{YYYY}-{NNN}
+      (b) NNN 不能超过当前计数器 (防跳号/未来号; 但允许 NNN == 已分配的号,
+          因为可能是修改已有 PRD)
+      (c) 同一批无重复 ID
+
+    注意: 允许 NNN <= 计数器, 因为可能是更新已有 PRD (合法)。
+    撞号只在"同一批出现两个相同 ID"或"NNN 超过计数器"时报错。
+    """
+    seen = {}
+    errors = []
+    for p in prd_paths:
+        parsed = parse_req_id(p)
+        if not parsed:
+            errors.append("%s: 文件名无 REQ-{YYYY}-{NNN}" % os.path.basename(p))
+            continue
+        year, n = parsed
+        # 同批重复检测
+        key = (year, n)
+        if key in seen:
+            errors.append(
+                "撞号: %s 和 %s 都是 REQ-%d-%03d"
+                % (os.path.basename(seen[key]), os.path.basename(p), year, n)
+            )
+        else:
+            seen[key] = p
+        # 超界检测 (NNN 不能超过计数器, 防止跳号)
+        max_n = current_counter(str(year), repo_root)
+        if max_n > 0 and n > max_n:
+            errors.append(
+                "%s: REQ-%d-%03d 超过计数器最大值 %d (跳号?)"
+                % (os.path.basename(p), year, n, max_n)
+            )
+    if errors:
+        raise ReqIdError("[gate] 拒绝: REQ-ID 校验失败:\n  " + "\n  ".join(errors))
+
+
+def migrate_from_existing(repo_root: Optional[Union[str, Path]] = None) -> dict:
+    """一次性迁移: 扫描所有现有 PRD, 把计数器初始化为各年最大值。
+
+    扫描位置:
+      - data/docs/prd/REQ-*.md
+      - workspace/specs/prd/REQ-*.md
+      - workspace/members/*/drafts/REQ-*.md
+
+    Returns:
+        迁移后的计数器 dict, 同时写入 data/index/req-counter.json。
+    """
+    if repo_root is None:
+        repo_root = get_repo_root()
+    repo_root = Path(repo_root)
+
+    # 幂等: 用文件锁保证迁移本身不并发
+    lock = FileLock(_lock_path(repo_root), timeout=30, stale_seconds=300)
+    try:
+        lock.acquire()
+    except LockTimeoutError as e:
+        raise ReqIdError("迁移锁竞争: %s" % e)
+    try:
+        existing = _read_counter(repo_root)
+        counter = {k: int(v) for k, v in existing.items()}
+
+        scan_dirs = [
+            repo_root / "data" / "docs" / "prd",
+            repo_root / "workspace" / "specs" / "prd",
+        ]
+        # 加成员 drafts
+        members_dir = repo_root / "workspace" / "members"
+        if members_dir.is_dir():
+            for m in members_dir.iterdir():
+                d = m / "drafts"
+                if d.is_dir():
+                    scan_dirs.append(d)
+
+        for d in scan_dirs:
+            if not d.is_dir():
+                continue
+            for f in d.iterdir():
+                if not f.is_file() or not f.name.lower().endswith(".md"):
+                    continue
+                parsed = parse_req_id(f.name)
+                if parsed:
+                    year, n = parsed
+                    key = str(year)
+                    counter[key] = max(int(counter.get(key, 0)), n)
+
+        atomic_write_json(_counter_path(repo_root), counter)
+        return counter
+    finally:
+        lock.release()