@hupan56/wlkj 2.7.11 → 3.0.0

package/templates/qoder/scripts/report/__init__.py

@@ -0,0 +1,11 @@
+# 子包初始化: 注入 scripts/根 + 所有子包到 sys.path
+# 让跨包 import (旧式不带前缀) 仍可用, 兼容现有代码
+import os as _os, sys as _sys
+_root = _os.path.dirname(_os.path.dirname(_os.path.abspath(__file__)))
+if _root not in _sys.path:
+    _sys.path.insert(0, _root)
+# 注入所有子包目录 (兼容旧式 import xxx)
+for _sub in ('kg', 'build', 'test', 'setup', 'io'):
+    _subdir = _os.path.join(_root, _sub)
+    if _os.path.isdir(_subdir) and _subdir not in _sys.path:
+        _sys.path.insert(0, _subdir)

package/templates/qoder/scripts/{add_session.py → report/add_session.py}

@@ -1,245 +1,251 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-QODER Pipeline - 会话日志记录
-
-每次 AI 会话结束后, 记录一条日志到开发者的工作空间。
-日志文件按行数自动轮转 (默认 2000 行)。
-
-Usage:
-    python add_session.py --title "Title" --commit "hash" --summary "Summary"
-    python add_session.py --title "Title" --branch "feat/my-branch"
-
-日志文件: .qoder/workspace/<developer>/journal-N.md
-索引文件: .qoder/workspace/<developer>/index.md
-
-参考: Trellis 的 add_session.py 设计
-"""
-
-from __future__ import annotations
-
-import argparse
-import re
-import subprocess
-import sys
-import os
-from datetime import datetime
-from pathlib import Path
-
-sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
-
-from common.paths import (
-    FILE_JOURNAL_PREFIX,
-    get_repo_root,
-    get_developer,
-    get_workspace_dir,
-    get_active_journal_file,
-    count_lines,
-)
-from common.developer import ensure_developer
-
-
-# =============================================================================
-# 默认配置
-# =============================================================================
-
-MAX_JOURNAL_LINES = 2000  # 每个日志文件最大行数
-
-
-# =============================================================================
-# 核心函数
-# =============================================================================
-
-def get_latest_journal_info(dev_dir: Path) -> tuple[Path | None, int, int]:
-    """获取最新日志文件信息。
-
-    Returns:
-        (文件路径, 文件编号, 行数)
-    """
-    latest_file = None
-    latest_num = 0
-
-    for f in dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md"):
-        if not f.is_file():
-            continue
-        match = re.search(r"(\d+)$", f.stem)
-        if match:
-            num = int(match.group(1))
-            if num > latest_num:
-                latest_num = num
-                latest_file = f
-
-    if latest_file:
-        lines = count_lines(latest_file)
-        return latest_file, latest_num, lines
-
-    return None, 0, 0
-
-
-def get_current_session(index_file: Path) -> int:
-    """从 index.md 读取当前会话编号。"""
-    if not index_file.is_file():
-        return 0
-
-    try:
-        content = index_file.read_text(encoding="utf-8")
-        for line in content.splitlines():
-            if "Total Sessions" in line:
-                match = re.search(r":\s*(\d+)", line)
-                if match:
-                    return int(match.group(1))
-    except (OSError, IOError):
-        pass
-    return 0
-
-
-def create_new_journal_file(
-    dev_dir: Path, num: int, developer: str, max_lines: int = MAX_JOURNAL_LINES
-) -> Path:
-    """创建新的日志文件。"""
-    prev_num = num - 1
-    new_file = dev_dir / f"{FILE_JOURNAL_PREFIX}{num}.md"
-    today = datetime.now().strftime("%Y-%m-%d")
-
-    content = f"""# Journal - {developer} (Part {num})
-
-> Continuation from `{FILE_JOURNAL_PREFIX}{prev_num}.md` (archived at ~{max_lines} lines)
-> Started: {today}
-
----
-
-"""
-    new_file.write_text(content, encoding="utf-8")
-    return new_file
-
-
-def update_index(
-    index_file: Path,
-    developer: str,
-    session_num: int,
-    journal_file: str,
-    max_lines: int = MAX_JOURNAL_LINES,
-) -> None:
-    """更新工作空间索引文件 index.md。"""
-    today = datetime.now().strftime("%Y-%m-%d %H:%M")
-
-    # 生成日志表格
-    dev_dir = index_file.parent
-    table_rows = []
-    for f in sorted(dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md")):
-        lines = count_lines(f)
-        status = "Active" if f.name == journal_file else "Archived"
-        table_rows.append(f"| `{f.name}` | ~{lines} | {status} |")
-
-    journals_table = "\n".join(table_rows)
-
-    index_content = f"""# Workspace Index - {developer}
-
-> Journal tracking for AI development sessions.
-
----
-
-## Current Status
-
-<!-- @@@auto:current-status -->
-- **Active File**: `{journal_file}`
-- **Total Sessions**: {session_num}
-- **Last Active**: {today}
-<!-- @@@/auto:current-status -->
-
----
-
-## Journals
-
-| File | Lines | Status |
-|------|-------|--------|
-<!-- @@@auto:journals-table -->
-{journals_table}
-<!-- @@@/auto:journals-table -->
-
----
-
-*Auto-managed by QODER Pipeline*
-"""
-    index_file.write_text(index_content, encoding="utf-8")
-
-
-# =============================================================================
-# Main
-# =============================================================================
-
-def main() -> int:
-    """CLI 入口。"""
-    parser = argparse.ArgumentParser(description="Record AI session to journal")
-    parser.add_argument("--title", required=True, help="Session title")
-    parser.add_argument("--summary", default="", help="Session summary")
-    parser.add_argument("--commit", default="", help="Git commit hash")
-    parser.add_argument("--branch", default="", help="Git branch (auto-detected if omitted)")
-    args = parser.parse_args()
-
-    repo_root = get_repo_root()
-    developer = ensure_developer(repo_root)
-
-    workspace = get_workspace_dir(repo_root)
-    if not workspace:
-        print("Error: No workspace directory", file=sys.stderr)
-        return 1
-
-    workspace.mkdir(parents=True, exist_ok=True)
-
-    # 获取 Git 分支
-    branch = args.branch
-    if not branch:
-        try:
-            result = subprocess.run(
-                ["git", "branch", "--show-current"],
-                capture_output=True, text=True, cwd=str(repo_root)
-            )
-            branch = result.stdout.strip()
-        except Exception:
-            branch = "unknown"
-
-    # 获取最新日志文件
-    journal_file, journal_num, lines = get_latest_journal_info(workspace)
-
-    # 如果没有日志文件或已满, 创建新的
-    if not journal_file or lines >= MAX_JOURNAL_LINES:
-        journal_num = journal_num + 1 if journal_file else 1
-        journal_file = create_new_journal_file(workspace, journal_num, developer)
-        lines = 0
-
-    # 读取当前会话编号
-    index_file = workspace / "index.md"
-    session_num = get_current_session(index_file) + 1
-
-    # 追加会话记录
-    today = datetime.now().strftime("%Y-%m-%d %H:%M")
-    commit_line = f"- **Commit**: `{args.commit}`\n" if args.commit else ""
-    branch_line = f"- **Branch**: `{branch}`\n" if branch else ""
-
-    entry = f"""### Session {session_num}: {args.title}
-
-- **Date**: {today}
-- **Developer**: {developer}
-{commit_line}{branch_line}
-**Summary**: {args.summary or 'No summary provided.'}
-
----
-
-"""
-    try:
-        with open(journal_file, "a", encoding="utf-8") as f:
-            f.write(entry)
-    except (OSError, IOError) as e:
-        print(f"Error: Failed to append to journal: {e}", file=sys.stderr)
-        return 1
-
-    # 更新索引
-    update_index(index_file, developer, session_num, journal_file.name)
-
-    print(f"Session {session_num} recorded in {journal_file.name}")
-    return 0
-
-
-if __name__ == "__main__":
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Pipeline - 会话日志记录
+
+每次 AI 会话结束后, 记录一条日志到开发者的工作空间。
+日志文件按行数自动轮转 (默认 2000 行)。
+
+Usage:
+    python add_session.py --title "Title" --commit "hash" --summary "Summary"
+    python add_session.py --title "Title" --branch "feat/my-branch"
+
+日志文件: .qoder/workspace/<developer>/journal-N.md
+索引文件: .qoder/workspace/<developer>/index.md
+
+参考: Trellis 的 add_session.py 设计
+"""
+
+from __future__ import annotations
+
+# 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')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+import argparse
+import re
+import subprocess
+import sys
+import os
+from datetime import datetime
+from pathlib import Path
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from common.paths import (
+    FILE_JOURNAL_PREFIX,
+    get_repo_root,
+    get_developer,
+    get_workspace_dir,
+    get_active_journal_file,
+    count_lines,
+)
+from common.developer import ensure_developer
+
+
+# =============================================================================
+# 默认配置
+# =============================================================================
+
+MAX_JOURNAL_LINES = 2000  # 每个日志文件最大行数
+
+
+# =============================================================================
+# 核心函数
+# =============================================================================
+
+def get_latest_journal_info(dev_dir: Path) -> tuple[Path | None, int, int]:
+    """获取最新日志文件信息。
+
+    Returns:
+        (文件路径, 文件编号, 行数)
+    """
+    latest_file = None
+    latest_num = 0
+
+    for f in dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md"):
+        if not f.is_file():
+            continue
+        match = re.search(r"(\d+)$", f.stem)
+        if match:
+            num = int(match.group(1))
+            if num > latest_num:
+                latest_num = num
+                latest_file = f
+
+    if latest_file:
+        lines = count_lines(latest_file)
+        return latest_file, latest_num, lines
+
+    return None, 0, 0
+
+
+def get_current_session(index_file: Path) -> int:
+    """从 index.md 读取当前会话编号。"""
+    if not index_file.is_file():
+        return 0
+
+    try:
+        content = index_file.read_text(encoding="utf-8")
+        for line in content.splitlines():
+            if "Total Sessions" in line:
+                match = re.search(r":\s*(\d+)", line)
+                if match:
+                    return int(match.group(1))
+    except (OSError, IOError):
+        pass
+    return 0
+
+
+def create_new_journal_file(
+    dev_dir: Path, num: int, developer: str, max_lines: int = MAX_JOURNAL_LINES
+) -> Path:
+    """创建新的日志文件。"""
+    prev_num = num - 1
+    new_file = dev_dir / f"{FILE_JOURNAL_PREFIX}{num}.md"
+    today = datetime.now().strftime("%Y-%m-%d")
+
+    content = f"""# Journal - {developer} (Part {num})
+
+> Continuation from `{FILE_JOURNAL_PREFIX}{prev_num}.md` (archived at ~{max_lines} lines)
+> Started: {today}
+
+---
+
+"""
+    new_file.write_text(content, encoding="utf-8")
+    return new_file
+
+
+def update_index(
+    index_file: Path,
+    developer: str,
+    session_num: int,
+    journal_file: str,
+    max_lines: int = MAX_JOURNAL_LINES,
+) -> None:
+    """更新工作空间索引文件 index.md。"""
+    today = datetime.now().strftime("%Y-%m-%d %H:%M")
+
+    # 生成日志表格
+    dev_dir = index_file.parent
+    table_rows = []
+    for f in sorted(dev_dir.glob(f"{FILE_JOURNAL_PREFIX}*.md")):
+        lines = count_lines(f)
+        status = "Active" if f.name == journal_file else "Archived"
+        table_rows.append(f"| `{f.name}` | ~{lines} | {status} |")
+
+    journals_table = "\n".join(table_rows)
+
+    index_content = f"""# Workspace Index - {developer}
+
+> Journal tracking for AI development sessions.
+
+---
+
+## Current Status
+
+<!-- @@@auto:current-status -->
+- **Active File**: `{journal_file}`
+- **Total Sessions**: {session_num}
+- **Last Active**: {today}
+<!-- @@@/auto:current-status -->
+
+---
+
+## Journals
+
+| File | Lines | Status |
+|------|-------|--------|
+<!-- @@@auto:journals-table -->
+{journals_table}
+<!-- @@@/auto:journals-table -->
+
+---
+
+*Auto-managed by QODER Pipeline*
+"""
+    index_file.write_text(index_content, encoding="utf-8")
+
+
+# =============================================================================
+# Main
+# =============================================================================
+
+def main() -> int:
+    """CLI 入口。"""
+    parser = argparse.ArgumentParser(description="Record AI session to journal")
+    parser.add_argument("--title", required=True, help="Session title")
+    parser.add_argument("--summary", default="", help="Session summary")
+    parser.add_argument("--commit", default="", help="Git commit hash")
+    parser.add_argument("--branch", default="", help="Git branch (auto-detected if omitted)")
+    args = parser.parse_args()
+
+    repo_root = get_repo_root()
+    developer = ensure_developer(repo_root)
+
+    workspace = get_workspace_dir(repo_root)
+    if not workspace:
+        print("Error: No workspace directory", file=sys.stderr)
+        return 1
+
+    workspace.mkdir(parents=True, exist_ok=True)
+
+    # 获取 Git 分支
+    branch = args.branch
+    if not branch:
+        try:
+            result = subprocess.run(
+                ["git", "branch", "--show-current"],
+                capture_output=True, text=True, cwd=str(repo_root)
+            )
+            branch = result.stdout.strip()
+        except Exception:
+            branch = "unknown"
+
+    # 获取最新日志文件
+    journal_file, journal_num, lines = get_latest_journal_info(workspace)
+
+    # 如果没有日志文件或已满, 创建新的
+    if not journal_file or lines >= MAX_JOURNAL_LINES:
+        journal_num = journal_num + 1 if journal_file else 1
+        journal_file = create_new_journal_file(workspace, journal_num, developer)
+        lines = 0
+
+    # 读取当前会话编号
+    index_file = workspace / "index.md"
+    session_num = get_current_session(index_file) + 1
+
+    # 追加会话记录
+    today = datetime.now().strftime("%Y-%m-%d %H:%M")
+    commit_line = f"- **Commit**: `{args.commit}`\n" if args.commit else ""
+    branch_line = f"- **Branch**: `{branch}`\n" if branch else ""
+
+    entry = f"""### Session {session_num}: {args.title}
+
+- **Date**: {today}
+- **Developer**: {developer}
+{commit_line}{branch_line}
+**Summary**: {args.summary or 'No summary provided.'}
+
+---
+
+"""
+    try:
+        with open(journal_file, "a", encoding="utf-8") as f:
+            f.write(entry)
+    except (OSError, IOError) as e:
+        print(f"Error: Failed to append to journal: {e}", file=sys.stderr)
+        return 1
+
+    # 更新索引
+    update_index(index_file, developer, session_num, journal_file.name)
+
+    print(f"Session {session_num} recorded in {journal_file.name}")
+    return 0
+
+
+if __name__ == "__main__":
     sys.exit(main())