@hupan56/wlkj 2.7.12 → 3.1.2

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

@@ -1,245 +1,257 @@
-#!/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
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+from foundation.core.paths import get_repo_root
+
+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 foundation.core.paths import (
+    FILE_JOURNAL_PREFIX,
+    get_repo_root,
+    get_developer,
+    get_workspace_dir,
+    get_active_journal_file,
+    count_lines,
+)
+from foundation.identity.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())

package/templates/qoder/scripts/{export.py → domain/report/export.py}

@@ -1,5 +1,16 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
 """
 export.py - 集成导出工具 (阶段 C)
 
@@ -33,9 +44,9 @@ except (AttributeError, TypeError, OSError):
 
 THIS_DIR = os.path.dirname(os.path.abspath(__file__))
 sys.path.insert(0, THIS_DIR)
-from common.paths import get_repo_root, get_developer, get_tasks_dir
-from common.task_utils import load_task_json
-from common.atomicio import safe_read_json
+from foundation.core.paths import get_repo_root, get_developer, get_tasks_dir
+from foundation.data.task_utils import load_task_json
+from foundation.io.atomicio import safe_read_json
 
 BASE = get_repo_root()
 INDEX_DIR = BASE / 'data' / 'index'
@@ -407,7 +418,7 @@ def _build_callgraph():
 
     # 持久化到 data/index/code-callgraph.json (供后续查询复用)
     try:
-        from common.atomicio import atomic_write_json
+        from foundation.io.atomicio import atomic_write_json
         atomic_write_json(str(INDEX_DIR / 'code-callgraph.json'), cg)
     except Exception as e:
         sys.stderr.write(f'[export] callgraph 持久化失败 (不影响导出): {e}\n')
@@ -470,6 +481,13 @@ def main():
     p_cg = sub.add_parser('callgraph', help='Java 调用图')
     p_cg.add_argument('--class', dest='class_name', help='查询指定类的依赖')
 
+    p_dx = sub.add_parser('docx', help='PRD导出Word(M5)')
+    p_dx.add_argument('prd', help='PRD md文件')
+    p_dx.add_argument('-o', '--output')
+    p_pf = sub.add_parser('pdf', help='PRD导出HTML(浏览器打印为PDF)')
+    p_pf.add_argument('prd', help='PRD md文件')
+    p_pf.add_argument('-o', '--output')
+
     args = parser.parse_args()
     if not args.format:
         parser.print_help()
@@ -482,6 +500,56 @@ def main():
     elif args.format == 'callgraph':
         return export_callgraph(class_name=args.class_name)
 
+    elif args.format == 'docx':
+        return export_docx(args.prd, args.output)
+    elif args.format == 'pdf':
+        return export_pdf(args.prd, args.output)
+
+
+def export_docx(prd_path, output=None):
+    """PRD markdown -> Word docx (M5)。用 python-docx, 纯Python不依赖pandoc。"""
+    if not os.path.isfile(prd_path):
+        print('PRD 不存在: %s' % prd_path); return 1
+    try:
+        from docx import Document
+    except ImportError:
+        print('python-docx 未装。pip install python-docx'); return 1
+    doc = Document()
+    with open(prd_path, encoding='utf-8') as f:
+        for line in f:
+            ln = line.rstrip('\n'); s = ln.strip()
+            if s.startswith('# '): doc.add_heading(s[2:], level=1)
+            elif s.startswith('## '): doc.add_heading(s[3:], level=2)
+            elif s.startswith('### '): doc.add_heading(s[4:], level=3)
+            elif s.startswith('- ') or s.startswith('* '): doc.add_paragraph(s[2:], style='List Bullet')
+            elif s.startswith('<!--'): pass
+            elif s == '': pass
+            else: doc.add_paragraph(s)
+    if not output: output = os.path.splitext(prd_path)[0] + '.docx'
+    doc.save(output)
+    print('OK Word: %s' % output); return 0
+
+
+def export_pdf(prd_path, output=None):
+    """PRD markdown -> HTML (浏览器Ctrl+P另存PDF) (M5)。避免wkhtmltopdf重依赖。"""
+    if not os.path.isfile(prd_path):
+        print('PRD 不存在: %s' % prd_path); return 1
+    try:
+        import markdown as md
+    except ImportError:
+        print('markdown 未装。pip install markdown'); return 1
+    with open(prd_path, encoding='utf-8') as f:
+        body = md.markdown(f.read(), extensions=['tables', 'fenced_code'])
+    html = ('<!DOCTYPE html><html lang="zh"><head><meta charset="UTF-8"><style>'
+            'body{font-family:"Microsoft YaHei",sans-serif;max-width:800px;margin:40px auto;line-height:1.6}'
+            'h1{border-bottom:2px solid #333}h2{border-bottom:1px solid #999;margin-top:24px}'
+            'table{border-collapse:collapse;width:100%}th,td{border:1px solid #ccc;padding:6px}th{background:#f5f5f5}'
+            '@media print{body{margin:20px}}</style></head><body>' + body + '</body></html>')
+    if not output: output = os.path.splitext(prd_path)[0] + '.html'
+    with open(output, 'w', encoding='utf-8') as f:
+        f.write(html)
+    print('OK HTML: %s (浏览器打开 Ctrl+P 另存PDF)' % output); return 0
+
 
 if __name__ == '__main__':
     sys.exit(main())