@hupan56/wlkj 2.2.3 → 2.2.5

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

@@ -1,311 +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):
+# -*- 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