Release v0.1.6

scripts/gitea-codex-note.py

@@ -0,0 +1,97 @@
+#!/usr/bin/env python3
+"""Post a standardized Codex state update comment to a Gitea issue."""
+
+from __future__ import annotations
+
+import argparse
+import os
+import pathlib
+import sys
+
+from gitea_common import GiteaClient, GiteaError, infer_target, load_dotenv, repo_path, repo_root, require_token
+
+
+STATUS_LABELS = {
+    "started": "status/in-progress",
+    "progress": "status/in-progress",
+    "blocked": "status/blocked",
+    "needs-info": "status/needs-info",
+    "ready": "status/ready",
+    "done": "",
+    "note": "",
+}
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--root", type=pathlib.Path, default=pathlib.Path.cwd(), help="repository root or child path")
+    parser.add_argument("--remote", default="origin", help="git remote to use for target inference")
+    parser.add_argument("--env-file", type=pathlib.Path, help="dotenv file to read before using GITEA_* values")
+    parser.add_argument("--issue", type=int, required=True, help="Gitea issue number")
+    parser.add_argument("--status", choices=sorted(STATUS_LABELS), default="note")
+    parser.add_argument("--summary", action="append", default=[], help="summary bullet; may be repeated")
+    parser.add_argument("--changed", action="append", default=[], help="changed file path; may be repeated")
+    parser.add_argument("--test", action="append", default=[], help="verification command/result; may be repeated")
+    parser.add_argument("--next", action="append", default=[], help="next step or blocker; may be repeated")
+    parser.add_argument("--body-file", type=pathlib.Path, help="additional Markdown body to append")
+    parser.add_argument("--close", action="store_true", help="close the issue after posting the note")
+    parser.add_argument("--apply", action="store_true", help="post the comment and optional state update")
+    args = parser.parse_args()
+
+    try:
+        root = repo_root(args.root)
+        load_dotenv(args.env_file or root / ".env")
+        target = infer_target(root, args.remote)
+        token = require_token() if args.apply else os.environ.get("GITEA_TOKEN")
+        body = build_body(args)
+
+        print(f"Target: {target.display}")
+        print(f"Issue: #{args.issue}")
+        print(body)
+
+        if not args.apply:
+            print("Dry run only. Re-run with --apply and GITEA_TOKEN to post.")
+            return 0
+
+        client = GiteaClient(target, token)
+        client.request_json(
+            "POST",
+            repo_path(target.owner, target.repo, f"/issues/{args.issue}/comments"),
+            body={"body": body},
+        )
+        if args.close:
+            client.request_json(
+                "PATCH",
+                repo_path(target.owner, target.repo, f"/issues/{args.issue}"),
+                body={"state": "closed"},
+            )
+        print("Posted Codex note.")
+        return 0
+    except GiteaError as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 1
+
+
+def build_body(args: argparse.Namespace) -> str:
+    lines = [f"## Codex State: {args.status}", ""]
+    append_section(lines, "Summary", args.summary)
+    append_section(lines, "Changed Files", [f"`{item}`" for item in args.changed])
+    append_section(lines, "Verification", [f"`{item}`" for item in args.test])
+    append_section(lines, "Next / Blocked", args.next)
+    if STATUS_LABELS[args.status]:
+        lines.extend(["", f"Suggested status label: `{STATUS_LABELS[args.status]}`"])
+    if args.body_file:
+        lines.extend(["", args.body_file.read_text(encoding="utf-8").strip()])
+    return "\n".join(lines).rstrip() + "\n"
+
+
+def append_section(lines: list[str], title: str, items: list[str]) -> None:
+    if not items:
+        return
+    lines.extend([f"### {title}", ""])
+    lines.extend(f"- {item}" for item in items)
+    lines.append("")
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())