@hupan56/wlkj 3.1.24 → 3.1.26

package/templates/qoder/scripts/foundation/integrations/active_task.py

@@ -1,245 +1,245 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-QODER Pipeline - 会话级活跃任务管理
-
-核心概念: "活跃任务" 是按 AI 会话/窗口存储的, 不是全局的。
-
-存储位置: .qoder/.runtime/sessions/<session-id>
-每个会话文件只包含一行: 活跃任务的相对路径。
-
-会话身份来源 (按优先级):
-1. 环境变量: QODER_SESSION_ID, CODEX_SESSION_ID, CODEX_THREAD_ID 等
-2. Hook 输入中的 session_id 字段
-3. TRELLIS_CONTEXT_ID 环境变量
-4. 后备: 全局 .qoder/.current-task 文件
-
-参考: Trellis 的 common/active_task.py 设计
-"""
-
-from __future__ import annotations
-
-import hashlib
-import json
-import os
-import sys
-from dataclasses import dataclass
-from pathlib import Path
-from typing import Any
-
-# 支持的 AI 平台及其会话环境变量
-# -----------------------------------------------------------------------------
-# 单一事实源: nexus.registry.HOST_TABLE（宿主能力抽象层）。
-# 本表从 HOST_TABLE 派生，保持 tuple[tuple[str, tuple[str, ...]]] 格式兼容。
-# 新增宿主只需改 nexus.HOST_TABLE 一处，active_task 自动跟随。
-# nexus 不可用时回退到内联定义（向后兼容，零破坏）。
-# -----------------------------------------------------------------------------
-try:
-    from capability.registry import HOST_TABLE as _HOST_TABLE
-
-    _ENV_SESSION_KEYS: tuple[tuple[str, tuple[str, ...]], ...] = tuple(
-        (name, tuple(info.get("detect", ())))
-        for name, info in _HOST_TABLE.items()
-        if name != "cli" and info.get("detect")
-    )
-except ImportError:
-    _ENV_SESSION_KEYS = (
-        ("qoderwork", ("QODER_SESSION_ID",)),
-        ("codex", ("CODEX_SESSION_ID", "CODEX_THREAD_ID")),
-        ("claude", ("CLAUDE_SESSION_ID", "CLAUDE_CODE_SESSION_ID")),
-        ("cursor", ("CURSOR_SESSION_ID",)),
-        ("opencode", ("OPENCODE_SESSION_ID", "OPENCODE_RUN_ID")),
-        ("gemini", ("GEMINI_SESSION_ID",)),
-        ("copilot", ("COPILOT_SESSION_ID",)),
-    )
-
-
-@dataclass(frozen=True)
-class ActiveTask:
-    """活跃任务状态。
-
-    Attributes:
-        task_path: 任务相对路径, None 表示无活跃任务。
-        source_type: 来源类型 (session / global-fallback / none)。
-        context_key: 会话标识键。
-        stale: 是否过期。
-    """
-    task_path: str | None
-    source_type: str  # "session" | "global-fallback" | "none"
-    context_key: str | None = None
-    stale: bool = False
-
-    @property
-    def source(self) -> str:
-        """人类可读的来源标签。"""
-        if self.source_type == "session" and self.context_key:
-            return f"session:{self.context_key}"
-        if self.source_type == "global-fallback":
-            return "global-fallback"
-        return "none"
-
-
-# =============================================================================
-# 会话身份解析
-# =============================================================================
-
-def resolve_context_key() -> str | None:
-    """解析当前会话的唯一标识键。
-
-    按平台优先级检查环境变量, 返回第一个找到的值。
-
-    Returns:
-        会话 ID 字符串, 无则返回 None。
-    """
-    # 1. 检查通用环境变量
-    for env_var in ("TRELLIS_CONTEXT_ID", "QODER_CONTEXT_ID"):
-        val = os.environ.get(env_var)
-        if val:
-            return val
-
-    # 2. 检查各平台专用环境变量
-    for _platform, env_vars in _ENV_SESSION_KEYS:
-        for env_var in env_vars:
-            val = os.environ.get(env_var)
-            if val:
-                return val
-
-    return None
-
-
-def _get_session_file(session_key: str, repo_root: Path) -> Path:
-    """获取会话状态文件路径。
-
-    Args:
-        session_key: 会话标识。
-        repo_root: 项目根目录。
-
-    Returns:
-        会话文件路径。
-    """
-    # 对 session_key 做 hash 避免特殊字符问题
-    key_hash = hashlib.sha256(session_key.encode()).hexdigest()[:16]
-    sessions_dir = repo_root / ".qoder" / ".runtime" / "sessions"
-    sessions_dir.mkdir(parents=True, exist_ok=True)
-    return sessions_dir / f"session-{key_hash}"
-
-
-# =============================================================================
-# 活跃任务读写
-# =============================================================================
-
-def resolve_active_task(repo_root: Path | None = None) -> ActiveTask:
-    """解析当前会话的活跃任务。
-
-    优先级:
-    1. 会话级状态文件
-    2. 全局 .current-task 文件 (后备)
-
-    Args:
-        repo_root: 项目根目录, 默认自动检测。
-
-    Returns:
-        ActiveTask 对象。
-    """
-    if repo_root is None:
-        from foundation.core.paths import get_repo_root
-        repo_root = get_repo_root()
-
-    # 1. 尝试会话级
-    session_key = resolve_context_key()
-    if session_key:
-        session_file = _get_session_file(session_key, repo_root)
-        if session_file.is_file():
-            try:
-                task_path = session_file.read_text(encoding="utf-8").strip()
-                if task_path:
-                    return ActiveTask(
-                        task_path=task_path,
-                        source_type="session",
-                        context_key=session_key,
-                    )
-            except (OSError, IOError):
-                pass
-
-    # 2. 后备: 全局文件
-    from foundation.core.paths import get_current_task
-    global_task = get_current_task(repo_root)
-    if global_task:
-        return ActiveTask(
-            task_path=global_task,
-            source_type="global-fallback",
-            context_key=session_key,
-        )
-
-    return ActiveTask(task_path=None, source_type="none")
-
-
-def set_active_task(task_path: str, repo_root: Path | None = None) -> ActiveTask | None:
-    """设置当前会话的活跃任务。
-
-    Args:
-        task_path: 任务相对路径。
-        repo_root: 项目根目录, 默认自动检测。
-
-    Returns:
-        ActiveTask 对象, 无会话身份则返回 None。
-    """
-    if repo_root is None:
-        from foundation.core.paths import get_repo_root
-        repo_root = get_repo_root()
-
-    session_key = resolve_context_key()
-    if not session_key:
-        # 无会话身份, 使用全局后备
-        from foundation.core.paths import set_current_task
-        set_current_task(task_path, repo_root)
-        return ActiveTask(
-            task_path=task_path,
-            source_type="global-fallback",
-            context_key=None,
-        )
-
-    session_file = _get_session_file(session_key, repo_root)
-    try:
-        session_file.parent.mkdir(parents=True, exist_ok=True)
-        session_file.write_text(task_path, encoding="utf-8")
-        return ActiveTask(
-            task_path=task_path,
-            source_type="session",
-            context_key=session_key,
-        )
-    except (OSError, IOError) as e:
-        print(f"Warning: Failed to write session file: {e}", file=sys.stderr)
-        return None
-
-
-def clear_active_task(repo_root: Path | None = None) -> ActiveTask:
-    """清除当前会话的活跃任务。
-
-    Args:
-        repo_root: 项目根目录, 默认自动检测。
-
-    Returns:
-        清除前的 ActiveTask 状态。
-    """
-    if repo_root is None:
-        from foundation.core.paths import get_repo_root
-        repo_root = get_repo_root()
-
-    # 获取清除前的状态
-    active = resolve_active_task(repo_root)
-
-    # 清除会话文件
-    session_key = resolve_context_key()
-    if session_key:
-        session_file = _get_session_file(session_key, repo_root)
-        try:
-            session_file.unlink(missing_ok=True)
-        except (OSError, IOError):
-            pass
-
-    # 也清除全局后备
-    from foundation.core.paths import set_current_task
-    set_current_task(None, repo_root)
-
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Pipeline - 会话级活跃任务管理
+
+核心概念: "活跃任务" 是按 AI 会话/窗口存储的, 不是全局的。
+
+存储位置: .qoder/.runtime/sessions/<session-id>
+每个会话文件只包含一行: 活跃任务的相对路径。
+
+会话身份来源 (按优先级):
+1. 环境变量: QODER_SESSION_ID, CODEX_SESSION_ID, CODEX_THREAD_ID 等
+2. Hook 输入中的 session_id 字段
+3. TRELLIS_CONTEXT_ID 环境变量
+4. 后备: 全局 .qoder/.current-task 文件
+
+参考:  common/active_task.py 设计
+"""
+
+from __future__ import annotations
+
+import hashlib
+import json
+import os
+import sys
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any
+
+# 支持的 AI 平台及其会话环境变量
+# -----------------------------------------------------------------------------
+# 单一事实源: nexus.registry.HOST_TABLE（宿主能力抽象层）。
+# 本表从 HOST_TABLE 派生，保持 tuple[tuple[str, tuple[str, ...]]] 格式兼容。
+# 新增宿主只需改 nexus.HOST_TABLE 一处，active_task 自动跟随。
+# nexus 不可用时回退到内联定义（向后兼容，零破坏）。
+# -----------------------------------------------------------------------------
+try:
+    from capability.registry import HOST_TABLE as _HOST_TABLE
+
+    _ENV_SESSION_KEYS: tuple[tuple[str, tuple[str, ...]], ...] = tuple(
+        (name, tuple(info.get("detect", ())))
+        for name, info in _HOST_TABLE.items()
+        if name != "cli" and info.get("detect")
+    )
+except ImportError:
+    _ENV_SESSION_KEYS = (
+        ("qoderwork", ("QODER_SESSION_ID",)),
+        ("codex", ("CODEX_SESSION_ID", "CODEX_THREAD_ID")),
+        ("claude", ("CLAUDE_SESSION_ID", "CLAUDE_CODE_SESSION_ID")),
+        ("cursor", ("CURSOR_SESSION_ID",)),
+        ("opencode", ("OPENCODE_SESSION_ID", "OPENCODE_RUN_ID")),
+        ("gemini", ("GEMINI_SESSION_ID",)),
+        ("copilot", ("COPILOT_SESSION_ID",)),
+    )
+
+
+@dataclass(frozen=True)
+class ActiveTask:
+    """活跃任务状态。
+
+    Attributes:
+        task_path: 任务相对路径, None 表示无活跃任务。
+        source_type: 来源类型 (session / global-fallback / none)。
+        context_key: 会话标识键。
+        stale: 是否过期。
+    """
+    task_path: str | None
+    source_type: str  # "session" | "global-fallback" | "none"
+    context_key: str | None = None
+    stale: bool = False
+
+    @property
+    def source(self) -> str:
+        """人类可读的来源标签。"""
+        if self.source_type == "session" and self.context_key:
+            return f"session:{self.context_key}"
+        if self.source_type == "global-fallback":
+            return "global-fallback"
+        return "none"
+
+
+# =============================================================================
+# 会话身份解析
+# =============================================================================
+
+def resolve_context_key() -> str | None:
+    """解析当前会话的唯一标识键。
+
+    按平台优先级检查环境变量, 返回第一个找到的值。
+
+    Returns:
+        会话 ID 字符串, 无则返回 None。
+    """
+    # 1. 检查通用环境变量
+    for env_var in ("TRELLIS_CONTEXT_ID", "QODER_CONTEXT_ID"):
+        val = os.environ.get(env_var)
+        if val:
+            return val
+
+    # 2. 检查各平台专用环境变量
+    for _platform, env_vars in _ENV_SESSION_KEYS:
+        for env_var in env_vars:
+            val = os.environ.get(env_var)
+            if val:
+                return val
+
+    return None
+
+
+def _get_session_file(session_key: str, repo_root: Path) -> Path:
+    """获取会话状态文件路径。
+
+    Args:
+        session_key: 会话标识。
+        repo_root: 项目根目录。
+
+    Returns:
+        会话文件路径。
+    """
+    # 对 session_key 做 hash 避免特殊字符问题
+    key_hash = hashlib.sha256(session_key.encode()).hexdigest()[:16]
+    sessions_dir = repo_root / ".qoder" / ".runtime" / "sessions"
+    sessions_dir.mkdir(parents=True, exist_ok=True)
+    return sessions_dir / f"session-{key_hash}"
+
+
+# =============================================================================
+# 活跃任务读写
+# =============================================================================
+
+def resolve_active_task(repo_root: Path | None = None) -> ActiveTask:
+    """解析当前会话的活跃任务。
+
+    优先级:
+    1. 会话级状态文件
+    2. 全局 .current-task 文件 (后备)
+
+    Args:
+        repo_root: 项目根目录, 默认自动检测。
+
+    Returns:
+        ActiveTask 对象。
+    """
+    if repo_root is None:
+        from foundation.core.paths import get_repo_root
+        repo_root = get_repo_root()
+
+    # 1. 尝试会话级
+    session_key = resolve_context_key()
+    if session_key:
+        session_file = _get_session_file(session_key, repo_root)
+        if session_file.is_file():
+            try:
+                task_path = session_file.read_text(encoding="utf-8").strip()
+                if task_path:
+                    return ActiveTask(
+                        task_path=task_path,
+                        source_type="session",
+                        context_key=session_key,
+                    )
+            except (OSError, IOError):
+                pass
+
+    # 2. 后备: 全局文件
+    from foundation.core.paths import get_current_task
+    global_task = get_current_task(repo_root)
+    if global_task:
+        return ActiveTask(
+            task_path=global_task,
+            source_type="global-fallback",
+            context_key=session_key,
+        )
+
+    return ActiveTask(task_path=None, source_type="none")
+
+
+def set_active_task(task_path: str, repo_root: Path | None = None) -> ActiveTask | None:
+    """设置当前会话的活跃任务。
+
+    Args:
+        task_path: 任务相对路径。
+        repo_root: 项目根目录, 默认自动检测。
+
+    Returns:
+        ActiveTask 对象, 无会话身份则返回 None。
+    """
+    if repo_root is None:
+        from foundation.core.paths import get_repo_root
+        repo_root = get_repo_root()
+
+    session_key = resolve_context_key()
+    if not session_key:
+        # 无会话身份, 使用全局后备
+        from foundation.core.paths import set_current_task
+        set_current_task(task_path, repo_root)
+        return ActiveTask(
+            task_path=task_path,
+            source_type="global-fallback",
+            context_key=None,
+        )
+
+    session_file = _get_session_file(session_key, repo_root)
+    try:
+        session_file.parent.mkdir(parents=True, exist_ok=True)
+        session_file.write_text(task_path, encoding="utf-8")
+        return ActiveTask(
+            task_path=task_path,
+            source_type="session",
+            context_key=session_key,
+        )
+    except (OSError, IOError) as e:
+        print(f"Warning: Failed to write session file: {e}", file=sys.stderr)
+        return None
+
+
+def clear_active_task(repo_root: Path | None = None) -> ActiveTask:
+    """清除当前会话的活跃任务。
+
+    Args:
+        repo_root: 项目根目录, 默认自动检测。
+
+    Returns:
+        清除前的 ActiveTask 状态。
+    """
+    if repo_root is None:
+        from foundation.core.paths import get_repo_root
+        repo_root = get_repo_root()
+
+    # 获取清除前的状态
+    active = resolve_active_task(repo_root)
+
+    # 清除会话文件
+    session_key = resolve_context_key()
+    if session_key:
+        session_file = _get_session_file(session_key, repo_root)
+        try:
+            session_file.unlink(missing_ok=True)
+        except (OSError, IOError):
+            pass
+
+    # 也清除全局后备
+    from foundation.core.paths import set_current_task
+    set_current_task(None, repo_root)
+
     return active

package/templates/root/AGENTS.md

@@ -1,6 +1,6 @@
 # QODER Pipeline
 
-## 🏗️ 架构: 引擎与数据分离 (Trellis 化)
+## 🏗️ 架构: 引擎与数据分离 (引擎数据分离)
 
 `.qoder/` 一分为二 (v2.8.0+):