Skip to content

Free, open source blog writer for Claude Code. Researches current sources, writes answer-first posts for Google and AI answers, has an independent reviewer score each one out of 100 and ships only after five delivery gates. 32 skills, 30 /blog commands, 5 agents. Active development at AI-Marketing-Hub/claude-blog; public releases ship here.

3.1 KB
Raw Blame
#!/usr/bin/env python3
"""Render the vault weekly report to HTML with safe output path handling."""
from __future__ import annotations

import argparse
import html
import json
import os
import re
import sys
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent))
from safe_write import UnsafeWriteError, write_text_safely  # noqa: E402


REPO = Path(__file__).resolve().parent.parent
LOCAL_PATH = re.compile(r"(?:/home|/var/home|/Users)/[A-Za-z0-9_.-]+|[A-Za-z]:\\Users\\[A-Za-z0-9_.-]+", re.I)


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description="Render the weekly report as HTML.")
    parser.add_argument("--vault", required=True)
    parser.add_argument("--out", default="")
    parser.add_argument("--html-only", action="store_true")
    parser.add_argument("--unsafe-write", action="store_true", help="Allow --out outside the vault or repo.")
    parser.add_argument("--json", action="store_true", help="Print a JSON result envelope.")
    args = parser.parse_args(argv)
    vault = Path(args.vault).expanduser().resolve()
    report = vault / "wiki" / "reports" / "Weekly Report.md"
    if not report.exists():
        return error("report not found; run synthesize first", args.json)
    # Keep a symlinked leaf visible (resolve() would follow it to its target).
    out = Path(os.path.abspath(Path(args.out).expanduser())) if args.out else vault / "weekly-report.html"
    if not args.unsafe_write and not is_safe_output(out.parent.resolve() / out.name, vault):
        return error(f"--out must stay inside the vault or repo: {out}", args.json)
    html_text = markdown_to_html(report.read_text(encoding="utf-8"))
    html_text = LOCAL_PATH.sub("[local-path-redacted]", html_text)
    try:
        write_text_safely(out, html_text, root=vault if out.parent.resolve().is_relative_to(vault) else None)
    except (UnsafeWriteError, OSError) as exc:
        return error(f"cannot write report: {exc}", args.json)
    if args.json:
        print(json.dumps({"ok": True, "out": str(out)}, indent=2, sort_keys=True))
    else:
        print(out)
    return 0


def error(message: str, as_json: bool) -> int:
    if as_json:
        print(json.dumps({"ok": False, "errors": [message]}, indent=2, sort_keys=True))
    else:
        print("ERROR: " + message, file=sys.stderr)
    return 2


def is_safe_output(out: Path, vault: Path) -> bool:
    return out == vault or out.is_relative_to(vault) or out == REPO or out.is_relative_to(REPO)


def markdown_to_html(text: str) -> str:
    body = []
    for line in text.splitlines():
        if line.startswith("---"):
            continue
        if line.startswith("# "):
            body.append(f"<h1>{html.escape(line[2:])}</h1>")
        elif line.startswith("## "):
            body.append(f"<h2>{html.escape(line[3:])}</h2>")
        elif line.startswith("- "):
            body.append(f"<li>{html.escape(line[2:])}</li>")
        elif line.strip():
            body.append(f"<p>{html.escape(line)}</p>")
    return "<!doctype html><meta charset='utf-8'><title>Weekly Report</title><body>" + "\n".join(body) + "</body>\n"


if __name__ == "__main__":
    raise SystemExit(main())