Codex Release Bot
274 lines
8.7 KiB
Python
274 lines
8.7 KiB
Python
#!/usr/bin/env python3
|
||
"""Consolidate Nexus docs: move batches to docs/archive/ and generate merged volumes."""
|
||
|
||
from __future__ import annotations
|
||
|
||
import shutil
|
||
from datetime import date
|
||
from pathlib import Path
|
||
|
||
REPO = Path(__file__).resolve().parents[1]
|
||
DOCS = REPO / "docs"
|
||
ARCHIVE = DOCS / "archive"
|
||
TODAY = date.today().isoformat()
|
||
|
||
|
||
def ensure_dirs() -> None:
|
||
for sub in (
|
||
"audits/2026-06-04-line-walk",
|
||
"audits/2026-06-04-delta",
|
||
"audits/2026-06-04-phase2",
|
||
"audits/2026-06-04-frontend-14p",
|
||
"memory/raw",
|
||
"handoff",
|
||
"project",
|
||
"reports/2026-05-reviews",
|
||
"reports/2026-05-steps",
|
||
):
|
||
(ARCHIVE / sub).mkdir(parents=True, exist_ok=True)
|
||
|
||
|
||
def extract_summary(text: str, max_lines: int = 12) -> str:
|
||
lines: list[str] = []
|
||
for line in text.splitlines():
|
||
s = line.strip()
|
||
if not s:
|
||
continue
|
||
if s.startswith("#"):
|
||
lines.append(s)
|
||
elif any(k in s for k in ("Closure", "DoD", "P0", "P1", "FINDING", "结论", "摘要")):
|
||
lines.append(s[:200])
|
||
if len(lines) >= max_lines:
|
||
break
|
||
return "\n".join(lines) if lines else (text.splitlines()[0][:200] if text.splitlines() else "(empty)")
|
||
|
||
|
||
def extract_closure_rows(text: str) -> list[str]:
|
||
rows: list[str] = []
|
||
in_table = False
|
||
for line in text.splitlines():
|
||
if "|" in line and ("Closure" in line or "H " in line or "FINDING" in line):
|
||
in_table = True
|
||
if in_table and line.strip().startswith("|") and "---" not in line:
|
||
rows.append(line.strip())
|
||
if in_table and not line.strip() and rows:
|
||
break
|
||
return rows[:80]
|
||
|
||
|
||
def merge_glob(
|
||
pattern: str,
|
||
out_name: str,
|
||
title: str,
|
||
archive_subdir: str,
|
||
) -> None:
|
||
base = DOCS / "reports"
|
||
files = sorted(base.glob(pattern))
|
||
if not files:
|
||
print(f" skip merge (no files): {pattern}")
|
||
return
|
||
|
||
out_path = ARCHIVE / "audits" / out_name
|
||
parts = [
|
||
f"# {title}",
|
||
"",
|
||
f"> 生成日期: {TODAY} · 源文件 {len(files)} 篇 · 原文 `docs/archive/{archive_subdir}/`",
|
||
"",
|
||
"## 批次索引",
|
||
"",
|
||
]
|
||
archive_dir = ARCHIVE / archive_subdir
|
||
archive_dir.mkdir(parents=True, exist_ok=True)
|
||
|
||
all_closure: list[str] = []
|
||
for f in files:
|
||
dest = archive_dir / f.name
|
||
if f.resolve() != dest.resolve():
|
||
if dest.exists():
|
||
dest.unlink()
|
||
shutil.move(str(f), str(dest))
|
||
text = dest.read_text(encoding="utf-8", errors="replace")
|
||
parts.append(f"### `{f.name}`")
|
||
parts.append("")
|
||
parts.append(extract_summary(text))
|
||
parts.append("")
|
||
all_closure.extend(extract_closure_rows(text))
|
||
|
||
if all_closure:
|
||
parts.extend(["## Closure 摘录（合并）", ""])
|
||
seen: set[str] = set()
|
||
for row in all_closure:
|
||
if row not in seen:
|
||
seen.add(row)
|
||
parts.append(row)
|
||
parts.append("")
|
||
|
||
out_path.write_text("\n".join(parts), encoding="utf-8")
|
||
print(f" merged {len(files)} → {out_path.relative_to(REPO)}")
|
||
|
||
|
||
def merge_memory() -> None:
|
||
mem_dir = DOCS / "memory"
|
||
if not mem_dir.is_dir():
|
||
return
|
||
files = sorted(p for p in mem_dir.glob("*.md") if p.name != "MEMORY.md")
|
||
if not files:
|
||
return
|
||
raw_dir = ARCHIVE / "memory/raw"
|
||
raw_dir.mkdir(parents=True, exist_ok=True)
|
||
parts = [
|
||
"# Agent Memory 合并卷（2026-05 迁移）",
|
||
"",
|
||
f"> 生成: {TODAY} · 原 docs/memory/ {len(files)} 篇",
|
||
"",
|
||
"请以 [nexus-functional-development-guide.md](../project/nexus-functional-development-guide.md) 为准。",
|
||
"",
|
||
]
|
||
for f in files:
|
||
text = f.read_text(encoding="utf-8", errors="replace")
|
||
dest = raw_dir / f.name
|
||
if f.resolve() != dest.resolve():
|
||
shutil.move(str(f), str(dest))
|
||
parts.extend([f"## {f.stem}", "", extract_summary(text, 8), ""])
|
||
out = ARCHIVE / "memory/agentmemory-2026-05-merged.md"
|
||
out.write_text("\n".join(parts), encoding="utf-8")
|
||
(mem_dir / "MEMORY.md").write_text(
|
||
"# 项目记忆（已归档）\n\n"
|
||
"见 [agentmemory-2026-05-merged.md](../archive/memory/agentmemory-2026-05-merged.md)\n"
|
||
"与 [功能开发指南](../project/nexus-functional-development-guide.md)。\n",
|
||
encoding="utf-8",
|
||
)
|
||
print(f" memory merged → {out.relative_to(REPO)}")
|
||
|
||
|
||
def archive_handoffs() -> None:
|
||
for name in ("handoff-2026-05-31.md", "handoff-2026-06-01.md"):
|
||
src = DOCS / name
|
||
if src.is_file():
|
||
shutil.move(str(src), str(ARCHIVE / "handoff" / name))
|
||
for f in sorted((DOCS / "project").glob("AI-HANDOFF-2026-05*.md")):
|
||
shutil.move(str(f), str(ARCHIVE / "handoff" / f.name))
|
||
old = DOCS / "project" / "AI-HANDOFF-2026-06-01-files.md"
|
||
if old.is_file():
|
||
shutil.move(str(old), str(ARCHIVE / "handoff" / old.name))
|
||
print(" handoffs archived")
|
||
|
||
|
||
def archive_nexus_full_site_features() -> None:
|
||
src = DOCS / "project" / "nexus-full-site-features.md"
|
||
if not src.is_file():
|
||
return
|
||
shutil.move(str(src), str(ARCHIVE / "project" / src.name))
|
||
(DOCS / "project" / "nexus-full-site-features.md").write_text(
|
||
"# 全站功能清单（已 supersede）\n\n"
|
||
"请以 **[nexus-functional-development-guide.md](nexus-functional-development-guide.md)** 为准。\n\n"
|
||
"历史 HTML 版: [archive](../archive/project/nexus-full-site-features.md)\n",
|
||
encoding="utf-8",
|
||
)
|
||
print(" nexus-full-site-features → archive + stub")
|
||
|
||
|
||
def archive_old_line_walk_standard() -> None:
|
||
v1 = DOCS / "project" / "line-walk-audit-standard.md"
|
||
if v1.is_file():
|
||
shutil.move(str(v1), str(ARCHIVE / "project" / v1.name))
|
||
print(" line-walk v1 archived")
|
||
|
||
|
||
def archive_phase2_reviews() -> None:
|
||
dest = ARCHIVE / "reports/2026-05-reviews"
|
||
patterns = (
|
||
"review-*-2026-05-21.md",
|
||
"signoff-2026-05-21.md",
|
||
"session-log-2026-05-21.md",
|
||
"2026-05-23-full-audit-report.md",
|
||
"audit-full-vs-phase2-reconciliation.md",
|
||
"audit-phase-2*.md",
|
||
"audit-phase-3*.md",
|
||
"implementation-progress-2026-05-21.md",
|
||
)
|
||
n = 0
|
||
reports = DOCS / "reports"
|
||
for pat in patterns:
|
||
for g in reports.glob(pat):
|
||
if g.is_file():
|
||
t = dest / g.name
|
||
if t.exists():
|
||
t.unlink()
|
||
shutil.move(str(g), str(t))
|
||
n += 1
|
||
step_dir = ARCHIVE / "reports/2026-05-steps"
|
||
for f in reports.glob("step-*"):
|
||
if f.is_dir():
|
||
target = step_dir / f.name
|
||
if target.exists():
|
||
shutil.rmtree(target)
|
||
shutil.move(str(f), str(target))
|
||
n += 1
|
||
if n:
|
||
print(f" archived {n} legacy review/step items")
|
||
|
||
|
||
def write_archive_readme() -> None:
|
||
(ARCHIVE / "README.md").write_text(
|
||
f"""# Nexus 文档归档区
|
||
|
||
> 更新: {TODAY}
|
||
|
||
历史审计、旧 handoff、agentmemory。**日常请先读** [docs/README.md](../README.md)。
|
||
|
||
## 合并卷
|
||
|
||
| 文件 | 内容 |
|
||
|------|------|
|
||
| [audits/2026-06-04-line-walk-merged.md](audits/2026-06-04-line-walk-merged.md) | Line-walk batch |
|
||
| [audits/2026-06-04-delta-merged.md](audits/2026-06-04-delta-merged.md) | Delta D1–D8 |
|
||
| [audits/2026-06-04-phase2-merged.md](audits/2026-06-04-phase2-merged.md) | Phase2 P2 |
|
||
| [audits/2026-06-04-frontend-14p-merged.md](audits/2026-06-04-frontend-14p-merged.md) | 前端 14p |
|
||
| [memory/agentmemory-2026-05-merged.md](memory/agentmemory-2026-05-merged.md) | 旧 memory |
|
||
|
||
原文在对应子目录；changelog 不归档。
|
||
""",
|
||
encoding="utf-8",
|
||
)
|
||
|
||
|
||
def main() -> None:
|
||
print("=== Nexus docs consolidation ===")
|
||
ensure_dirs()
|
||
merge_glob(
|
||
"audit-bug-line-walk-2026-06-04-batch*.md",
|
||
"2026-06-04-line-walk-merged.md",
|
||
"Bug Scan Line-Walk 合并卷",
|
||
"audits/2026-06-04-line-walk",
|
||
)
|
||
merge_glob(
|
||
"audit-delta-2026-06-04-waveD*.md",
|
||
"2026-06-04-delta-merged.md",
|
||
"Delta D1–D8 合并卷",
|
||
"audits/2026-06-04-delta",
|
||
)
|
||
merge_glob(
|
||
"audit-phase2-2026-06-04-waveP2-*.md",
|
||
"2026-06-04-phase2-merged.md",
|
||
"Phase2 P2 合并卷",
|
||
"audits/2026-06-04-phase2",
|
||
)
|
||
merge_glob(
|
||
"audit-frontend-14p-2026-06-04-batch*.md",
|
||
"2026-06-04-frontend-14p-merged.md",
|
||
"前端 14p batch 合并卷",
|
||
"audits/2026-06-04-frontend-14p",
|
||
)
|
||
merge_memory()
|
||
archive_handoffs()
|
||
archive_nexus_full_site_features()
|
||
archive_old_line_walk_standard()
|
||
archive_phase2_reviews()
|
||
write_archive_readme()
|
||
print("=== done ===")
|
||
|
||
|
||
if __name__ == "__main__":
|
||
main()
|