@hupan56/wlkj 2.2.4 → 2.2.6

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

@@ -1,161 +1,231 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-QODER Pipeline - 开发者管理工具
-
-提供开发者身份的初始化和管理功能:
-- init_developer: 初始化开发者身份, 创建工作空间和日志
-- ensure_developer: 确保开发者已初始化 (未初始化则退出)
-- show_developer_info: 显示开发者信息
-
-开发者身份存储在 .qoder/.developer 文件中 (gitignored)
-工作空间在 workspace/members/<developer>/ 目录下 (与 workspace_init.py 一致)
-"""
-
-from __future__ import annotations
-
-import sys
-from datetime import datetime
-from pathlib import Path
-
-# 将 scripts 目录加入路径以便导入 common 模块
-import os
-sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
-
-from common.paths import (
-    DIR_WORKFLOW,
-    FILE_DEVELOPER,
-    MEMBERS_DIR,
-    get_repo_root,
-    get_developer,
-    check_developer,
-)
-
-
-# =============================================================================
-# 开发者初始化
-# =============================================================================
-
-def write_developer_file(name: str, role: str | None = None,
-                         repo_root: Path | None = None) -> bool:
-    """写入 .qoder/.developer (规范格式: name=<name>)。"""
-    if repo_root is None:
-        repo_root = get_repo_root()
-    dev_file = repo_root / DIR_WORKFLOW / FILE_DEVELOPER
-    lines = [f"name={name}"]
-    if role:
-        lines.append(f"role={role}")
-    lines.append(f"initialized_at={datetime.now().isoformat()}")
-    try:
-        dev_file.write_text("\n".join(lines) + "\n", encoding="utf-8")
-        return True
-    except (OSError, IOError) as e:
-        print(f"Error: Failed to create .developer file: {e}", file=sys.stderr)
-        return False
-
-
-def init_developer(name: str, role: str | None = None,
-                   repo_root: Path | None = None) -> bool:
-    """初始化开发者身份。
-
-    创建以下内容:
-        - .qoder/.developer 文件 (name= / role= / initialized_at=)
-        - workspace/members/<name>/{journal,drafts,inbox}/ 目录
-        - 初始日志文件 journal/journal-1.md
-
-    Returns:
-        成功返回 True, 失败返回 False。
-    """
-    if not name:
-        print("Error: developer name is required", file=sys.stderr)
-        return False
-
-    # 校验名称合法性 (允许字母数字、中文和部分符号)
-    if not all(c.isalnum() or c in "-_" for c in name):
-        print(f"Error: invalid developer name '{name}' (only alphanumeric, -, _ allowed)", file=sys.stderr)
-        return False
-
-    if repo_root is None:
-        repo_root = get_repo_root()
-
-    # 零信任: 切换身份时清除旧开发者的 current-task 指针
-    # (防止 B 在 A 用过的机器上看到 A 的活跃任务, 误操作)
-    try:
-        from .paths import get_developer, set_current_task
-        old_dev = get_developer(repo_root)
-        if old_dev and old_dev != name:
-            set_current_task(None, repo_root, developer=old_dev)
-            print(f"Note: 切换开发者 {old_dev} -> {name}, 已清除 {old_dev} 的活跃任务指针")
-    except Exception:
-        pass  # 清理失败不阻塞初始化
-
-    # 1. 创建 .developer 文件
-    if not write_developer_file(name, role, repo_root):
-        return False
-
-    # 2. 创建个人工作空间 workspace/members/<name>/
-    personal = repo_root / "workspace" / "members" / name
-    try:
-        for sub in ("journal", "drafts", "inbox"):
-            (personal / sub).mkdir(parents=True, exist_ok=True)
-    except (OSError, IOError) as e:
-        print(f"Error: Failed to create workspace directory: {e}", file=sys.stderr)
-        return False
-
-    # 3. 创建初始日志文件
-    journal_file = personal / "journal" / "journal-1.md"
-    if not journal_file.exists():
-        today = datetime.now().strftime("%Y-%m-%d")
-        try:
-            journal_file.write_text(
-                f"# Journal - {name}\n\n> Started: {today}\n\n---\n\n",
-                encoding="utf-8"
-            )
-        except (OSError, IOError) as e:
-            print(f"Error: Failed to create journal file: {e}", file=sys.stderr)
-            return False
-
-    print(f"Developer initialized: {name}" + (f" ({role})" if role else ""))
-    print(f"  Workspace: workspace/members/{name}/")
-    print(f"  Journal:   workspace/members/{name}/journal/journal-1.md")
-    return True
-
-
-# =============================================================================
-# 开发者校验
-# =============================================================================
-
-def ensure_developer(repo_root: Path | None = None) -> str:
-    """确保开发者已初始化, 未初始化则打印提示并退出。"""
-    developer = get_developer(repo_root)
-    if not developer:
-        print("Error: Developer not initialized.", file=sys.stderr)
-        print("Run: python .qoder/scripts/workspace_init.py <your-name>", file=sys.stderr)
-        sys.exit(1)
-    return developer
-
-
-def show_developer_info(repo_root: Path | None = None) -> None:
-    """显示当前开发者信息。"""
-    from common.paths import get_developer_info, get_workspace_dir, get_active_journal_file
-
-    info = get_developer_info(repo_root)
-    if not info:
-        print("Developer: not initialized")
-        print("Run: python .qoder/scripts/workspace_init.py <your-name>")
-        return
-
-    print(f"Developer: {info.get('name', 'unknown')}")
-    if info.get('role'):
-        print(f"Role: {info['role']}")
-    print(f"Initialized: {info.get('initialized_at', 'unknown')}")
-
-    workspace = get_workspace_dir(repo_root)
-    if workspace:
-        print(f"Workspace: {workspace}")
-
-    journal = get_active_journal_file(repo_root)
-    if journal:
-        from common.paths import count_lines
-        lines = count_lines(journal)
-        print(f"Active Journal: {journal.name} ({lines} lines)")
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Pipeline - 开发者管理工具
+
+提供开发者身份的初始化和管理功能:
+- init_developer: 初始化开发者身份, 创建工作空间和日志
+- ensure_developer: 确保开发者已初始化 (未初始化则退出)
+- show_developer_info: 显示开发者信息
+
+开发者身份存储在 .qoder/.developer 文件中 (gitignored)
+工作空间在 workspace/members/<developer>/ 目录下 (与 workspace_init.py 一致)
+"""
+
+from __future__ import annotations
+
+import sys
+from datetime import datetime
+from pathlib import Path
+
+# 将 scripts 目录加入路径以便导入 common 模块
+import os
+sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+from common.paths import (
+    DIR_WORKFLOW,
+    FILE_DEVELOPER,
+    MEMBERS_DIR,
+    get_repo_root,
+    get_developer,
+    check_developer,
+)
+
+
+# =============================================================================
+# 开发者初始化
+# =============================================================================
+
+def write_developer_file(name: str, role: str | None = None,
+                         repo_root: Path | None = None) -> bool:
+    """写入 .qoder/.developer (规范格式: name=<name>)。"""
+    if repo_root is None:
+        repo_root = get_repo_root()
+    dev_file = repo_root / DIR_WORKFLOW / FILE_DEVELOPER
+    lines = [f"name={name}"]
+    if role:
+        lines.append(f"role={role}")
+    lines.append(f"initialized_at={datetime.now().isoformat()}")
+    try:
+        dev_file.write_text("\n".join(lines) + "\n", encoding="utf-8")
+        return True
+    except (OSError, IOError) as e:
+        print(f"Error: Failed to create .developer file: {e}", file=sys.stderr)
+        return False
+
+
+def _detect_git_author() -> str | None:
+    """探测系统 git config 的 user.name <user.email>。git 未装或未配返回 None。"""
+    import subprocess
+    try:
+        rn = subprocess.run(["git", "config", "user.name"],
+                            capture_output=True, text=True, timeout=5)
+        re_ = subprocess.run(["git", "config", "user.email"],
+                             capture_output=True, text=True, timeout=5)
+        if rn.returncode == 0 and re_.returncode == 0:
+            gname = rn.stdout.strip()
+            gemail = re_.stdout.strip()
+            if gname and gemail:
+                return f"{gname} <{gemail}>"
+    except (FileNotFoundError, OSError, subprocess.SubprocessError):
+        pass  # git 未装
+    return None
+
+
+def _ensure_git_config(name: str, repo_root: Path) -> None:
+    """确保 git user.name/email 已配置。未配则用 --local 设为 init 的名字。
+
+    检测顺序: 全局 > local。都没有就提示用户。
+    """
+    import subprocess
+    # 先看 git 是否可用
+    try:
+        subprocess.run(["git", "--version"], capture_output=True, timeout=5)
+    except (FileNotFoundError, OSError):
+        print("  [INFO] git 未安装, 跳过 git 配置 (核心功能不依赖 git)")
+        return
+
+    author = _detect_git_author()
+    if author:
+        print(f"  [OK] git 作者: {author}")
+        return
+
+    # git 未配 user.name/email: 用 init 名字设 local config (不影响全局)
+    print(f"  [设置] git 未配置 user.name/email, 用你的名字设为 local:")
+    fake_email = f"{name}@local"
+    try:
+        subprocess.run(["git", "config", "--local", "user.name", name],
+                       cwd=str(repo_root), capture_output=True, timeout=5)
+        subprocess.run(["git", "config", "--local", "user.email", fake_email],
+                       cwd=str(repo_root), capture_output=True, timeout=5)
+        print(f"    user.name = {name}")
+        print(f"    user.email = {fake_email}")
+        print(f"    (仅本仓库生效。如有团队 git 账号, 自行改: git config --local user.email 你的邮箱)")
+    except (FileNotFoundError, OSError, subprocess.SubprocessError) as e:
+        print(f"  [WARN] 设置 git config 失败 (不阻塞): {e}")
+        print(f"    请手动跑: git config user.name {name} && git config user.email 你的邮箱")
+
+
+def init_developer(name: str, role: str | None = None,
+                   repo_root: Path | None = None) -> bool:
+    """初始化开发者身份。
+
+    创建以下内容:
+        - .qoder/.developer 文件 (name= / role= / initialized_at=)
+        - workspace/members/<name>/{journal,drafts,inbox}/ 目录
+        - 初始日志文件 journal/journal-1.md
+        - member.json + .signing_key (零信任身份注册, 用于 push 门禁)
+        - git user.name/email 检测与配置
+
+    Returns:
+        成功返回 True, 失败返回 False。
+    """
+    if not name:
+        print("Error: developer name is required", file=sys.stderr)
+        return False
+
+    # 校验名称合法性 (允许字母数字、中文和部分符号)
+    if not all(c.isalnum() or c in "-_" for c in name):
+        print(f"Error: invalid developer name '{name}' (only alphanumeric, -, _ allowed)", file=sys.stderr)
+        return False
+
+    if repo_root is None:
+        repo_root = get_repo_root()
+
+    # 零信任: 切换身份时清除旧开发者的 current-task 指针
+    # (防止 B 在 A 用过的机器上看到 A 的活跃任务, 误操作)
+    try:
+        from .paths import get_developer, set_current_task
+        old_dev = get_developer(repo_root)
+        if old_dev and old_dev != name:
+            set_current_task(None, repo_root, developer=old_dev)
+            print(f"Note: 切换开发者 {old_dev} -> {name}, 已清除 {old_dev} 的活跃任务指针")
+    except Exception:
+        pass  # 清理失败不阻塞初始化
+
+    # 1. 创建 .developer 文件
+    if not write_developer_file(name, role, repo_root):
+        return False
+
+    # 2. 创建个人工作空间 workspace/members/<name>/
+    personal = repo_root / "workspace" / "members" / name
+    try:
+        for sub in ("journal", "drafts", "inbox"):
+            (personal / sub).mkdir(parents=True, exist_ok=True)
+    except (OSError, IOError) as e:
+        print(f"Error: Failed to create workspace directory: {e}", file=sys.stderr)
+        return False
+
+    # 3. 创建初始日志文件
+    journal_file = personal / "journal" / "journal-1.md"
+    if not journal_file.exists():
+        today = datetime.now().strftime("%Y-%m-%d")
+        try:
+            journal_file.write_text(
+                f"# Journal - {name}\n\n> Started: {today}\n\n---\n\n",
+                encoding="utf-8"
+            )
+        except (OSError, IOError) as e:
+            print(f"Error: Failed to create journal file: {e}", file=sys.stderr)
+            return False
+
+    # 4. 零信任身份注册 (写 member.json + 签名密钥 + git_author)
+    #    这是 push 门禁的前提: 没 member.json → syncgate 拒绝 push
+    git_author = _detect_git_author()
+    try:
+        from common.identity import register_member, IdentityError
+        try:
+            register_member(name, role or "pm", git_author, repo_root)
+            print(f"  [OK] 身份注册: member.json + 签名密钥已生成")
+        except IdentityError as e:
+            print(f"  [WARN] 身份注册失败 (不阻塞): {e}")
+    except ImportError:
+        pass  # identity 模块不可用, 跳过 (向后兼容)
+
+    # 5. 确保 git 配置 (检测 + 自动设 local)
+    _ensure_git_config(name, repo_root)
+
+    print(f"Developer initialized: {name}" + (f" ({role})" if role else ""))
+    print(f"  Workspace: workspace/members/{name}/")
+    print(f"  Journal:   workspace/members/{name}/journal/journal-1.md")
+    return True
+
+
+# =============================================================================
+# 开发者校验
+# =============================================================================
+
+def ensure_developer(repo_root: Path | None = None) -> str:
+    """确保开发者已初始化, 未初始化则打印提示并退出。"""
+    developer = get_developer(repo_root)
+    if not developer:
+        print("Error: Developer not initialized.", file=sys.stderr)
+        print("Run: python .qoder/scripts/workspace_init.py <your-name>", file=sys.stderr)
+        sys.exit(1)
+    return developer
+
+
+def show_developer_info(repo_root: Path | None = None) -> None:
+    """显示当前开发者信息。"""
+    from common.paths import get_developer_info, get_workspace_dir, get_active_journal_file
+
+    info = get_developer_info(repo_root)
+    if not info:
+        print("Developer: not initialized")
+        print("Run: python .qoder/scripts/workspace_init.py <your-name>")
+        return
+
+    print(f"Developer: {info.get('name', 'unknown')}")
+    if info.get('role'):
+        print(f"Role: {info['role']}")
+    print(f"Initialized: {info.get('initialized_at', 'unknown')}")
+
+    workspace = get_workspace_dir(repo_root)
+    if workspace:
+        print(f"Workspace: {workspace}")
+
+    journal = get_active_journal_file(repo_root)
+    if journal:
+        from common.paths import count_lines
+        lines = count_lines(journal)
+        print(f"Active Journal: {journal.name} ({lines} lines)")