Function _write_generation_metadata

codewiki/mcp/server.py:556–596

Write ``metadata.json`` to the session's output directory. Merges the current git commit and timestamp into any existing metadata so that stats from other workflows (e.g. CLI ``generate_docs``) are preserved.

(session: SessionState)

def _write_generation_metadata(session: SessionState) -> None:
    """Write ``metadata.json`` to the session's output directory.

    Merges the current git commit and timestamp into any existing metadata
    so that stats from other workflows (e.g. CLI ``generate_docs``) are
    preserved.
    """
    try:
        output_dir = Path(session.output_dir)
        repo_path = Path(session.repo_path)

        # Baseline on the commit analyze_repo saw, NOT the current HEAD:
        # commits made mid-session were never analyzed, and recording HEAD
        # here would silently exclude them from the next incremental run.
        commit_id: str | None = session.analyzed_commit
        if not commit_id:
            from codewiki.cli.utils.repo_validator import get_git_commit_hash
            commit_id = get_git_commit_hash(repo_path) or None

        from datetime import datetime

        # Read existing metadata (if any) and merge
        metadata_path = output_dir / "metadata.json"
        existing: dict = {}
        if metadata_path.exists():
            try:
                existing = json.loads(metadata_path.read_text(encoding="utf-8"))
            except (json.JSONDecodeError, OSError):
                pass

        existing["generation_info"] = {
            **existing.get("generation_info", {}),
            "commit_id": commit_id,
            "timestamp": datetime.now().isoformat(),
        }
        metadata_path.write_text(
            json.dumps(existing, indent=2, ensure_ascii=False),
            encoding="utf-8",
        )
    except Exception as e:
        logger.warning("Failed to write metadata.json: %s", e)


# ===================================================================