standupguy 0.1.0__tar.gz

standupguy-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Calas Automations Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

standupguy-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: standupguy
+Version: 0.1.0
+Summary: Local-first standup notes from git ground truth.
+Author: Calas Automations Inc.
+License: MIT
+Project-URL: Homepage, https://github.com/calasdan-sketch/standupguy
+Project-URL: Issues, https://github.com/calasdan-sketch/standupguy/issues
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# StandupGuy (`standupguy`)
+
+Kill the tracker trap without leaking data.
+
+Engineers lose up to 2/5 of the week to reporting busywork — duplicating
+updates across Jira, Slack, Confluence, and slide decks. AI note-takers are
+cloud SaaS with data-leak concerns. `standupguy` is the local-first
+alternative: it reads your **git history** (ground truth) and drafts your
+standup notes, weekly summary, and sprint-review bullets as Markdown.
+**Your history never leaves your laptop** — except to the model endpoint
+*you* configure (Ollama on localhost by default).
+
+## Install
+
+Zero dependencies — Python 3.10+ stdlib only.
+
+```bash
+git clone <repo> && cd standupguy
+# no-install alias (run from the repo root):
+alias standupguy="python3 -m standupguy"
+# or: pip install .   # provides the `standupguy` console script
+```
+
+## Usage
+
+```bash
+standupguy                          # yesterday's digest (deterministic, offline)
+standupguy --week                   # last 7 days
+standupguy --sprint                 # sprint-review bullets
+standupguy --since 2026-10-01       # custom range
+standupguy --draft                  # LLM prose: Yesterday / Today / Blockers
+standupguy --format json            # machine-readable digest
+standupguy --author "teammate@co"   # filter (default: your git user)
+standupguy --all                    # everyone
+standupguy --push-slack             # POST to AUTOSTANDUP_SLACK_WEBHOOK
+standupguy mcp                      # MCP server on stdio
+standupguy serve                    # HTTP bridge for Activepieces / workflow tools
+```
+
+## Activepieces
+
+`standupguy serve` exposes the digest over HTTP so Activepieces' HTTP
+Request piece can pull it on a schedule:
+
+```bash
+standupguy serve --root /path/to/repo   # localhost:8765
+```
+
+- `GET /digest?since=yesterday&author=&format=json|markdown`
+- `GET /week?author=&format=json|markdown`
+- `GET /health`
+
+[`workflows/activepieces-standup-digest.json`](workflows/activepieces-standup-digest.json)
+is a documented flow definition (it's a human-readable spec, not a native
+export — build it in Activepieces by adding the steps in order; the file
+carries the exact config for each step and setup notes at the top):
+weekday 9am Schedule trigger → HTTP Request → Branch (skip quiet days) →
+Slack. Connect your Slack connection, set the channel, done. The same
+`serve` endpoints work from n8n's HTTP Request node too — nothing in the
+bridge is platform-specific.
+
+Example output:
+
+```markdown
+# Standup — myrepo
+_since 2026-10-14_
+
+## Shipped
+### Features
+- add login flow (1 files) `6785c87`
+### Fixes
+- null pointer on logout (1 files) `8ce2731`
+
+## In progress (uncommitted)
+- `wip.py`
+
+## Blockers
+_none reported — fill in yours_
+```
+
+## How it works
+
+- **Digest mode (default):** pure Python, fully offline. Commits grouped by
+  conventional-commit prefix (feat/fix/docs/refactor/test/chore); merge
+  commits surface as shipped PRs; `git status` feeds the In-progress section.
+- **Draft mode (`--draft`):** sends the digest to your local model via an
+  OpenAI-compatible endpoint and gets back Yesterday/Today/Blockers prose.
+  Configure with env vars (Ollama defaults shown):
+
+```bash
+export AUTOSTANDUP_BASE_URL="http://localhost:11434/v1"
+export AUTOSTANDUP_MODEL="llama3.1"
+# freellmapi works too — it's OpenAI-compatible:
+export AUTOSTANDUP_BASE_URL="https://api.freellmapi.com/v1"
+export AUTOSTANDUP_API_KEY="<your key>"
+```
+
+- **MCP server:** exposes `what_did_i_ship {since?, author?, root?}` so your
+  coding agent can answer "what did I ship this week" from local git.
+- **Push:** `--push-slack` POSTs the Markdown to a Slack incoming webhook
+  (URL from the flag or `AUTOSTANDUP_SLACK_WEBHOOK`). Commit-derived text
+  is sanitized before posting: control characters stripped, lines
+  truncated at 500 chars, and `@channel`/`@here`/`@everyone` neutralized
+  to `[at]channel`-style text — so a hostile commit message can never ping
+  the channel or inject payloads. Jira/Confluence push
+  is intentionally not built in — paste the Markdown, keep your tokens
+  out of another integration.
+
+## Date handling
+
+Bare dates and words are normalized to explicit midnight (`2026-10-14` →
+`2026-10-14 00:00`, `yesterday` → yesterday 00:00) because git's date parser
+treats them as *noon* — silently dropping morning commits.
+
+## Tests
+
+```bash
+python3 -m unittest discover -s tests   # 36 tests, no network, no model
+```
+
+## License
+
+TBD

standupguy-0.1.0/README.md

@@ -0,0 +1,123 @@
+# StandupGuy (`standupguy`)
+
+Kill the tracker trap without leaking data.
+
+Engineers lose up to 2/5 of the week to reporting busywork — duplicating
+updates across Jira, Slack, Confluence, and slide decks. AI note-takers are
+cloud SaaS with data-leak concerns. `standupguy` is the local-first
+alternative: it reads your **git history** (ground truth) and drafts your
+standup notes, weekly summary, and sprint-review bullets as Markdown.
+**Your history never leaves your laptop** — except to the model endpoint
+*you* configure (Ollama on localhost by default).
+
+## Install
+
+Zero dependencies — Python 3.10+ stdlib only.
+
+```bash
+git clone <repo> && cd standupguy
+# no-install alias (run from the repo root):
+alias standupguy="python3 -m standupguy"
+# or: pip install .   # provides the `standupguy` console script
+```
+
+## Usage
+
+```bash
+standupguy                          # yesterday's digest (deterministic, offline)
+standupguy --week                   # last 7 days
+standupguy --sprint                 # sprint-review bullets
+standupguy --since 2026-10-01       # custom range
+standupguy --draft                  # LLM prose: Yesterday / Today / Blockers
+standupguy --format json            # machine-readable digest
+standupguy --author "teammate@co"   # filter (default: your git user)
+standupguy --all                    # everyone
+standupguy --push-slack             # POST to AUTOSTANDUP_SLACK_WEBHOOK
+standupguy mcp                      # MCP server on stdio
+standupguy serve                    # HTTP bridge for Activepieces / workflow tools
+```
+
+## Activepieces
+
+`standupguy serve` exposes the digest over HTTP so Activepieces' HTTP
+Request piece can pull it on a schedule:
+
+```bash
+standupguy serve --root /path/to/repo   # localhost:8765
+```
+
+- `GET /digest?since=yesterday&author=&format=json|markdown`
+- `GET /week?author=&format=json|markdown`
+- `GET /health`
+
+[`workflows/activepieces-standup-digest.json`](workflows/activepieces-standup-digest.json)
+is a documented flow definition (it's a human-readable spec, not a native
+export — build it in Activepieces by adding the steps in order; the file
+carries the exact config for each step and setup notes at the top):
+weekday 9am Schedule trigger → HTTP Request → Branch (skip quiet days) →
+Slack. Connect your Slack connection, set the channel, done. The same
+`serve` endpoints work from n8n's HTTP Request node too — nothing in the
+bridge is platform-specific.
+
+Example output:
+
+```markdown
+# Standup — myrepo
+_since 2026-10-14_
+
+## Shipped
+### Features
+- add login flow (1 files) `6785c87`
+### Fixes
+- null pointer on logout (1 files) `8ce2731`
+
+## In progress (uncommitted)
+- `wip.py`
+
+## Blockers
+_none reported — fill in yours_
+```
+
+## How it works
+
+- **Digest mode (default):** pure Python, fully offline. Commits grouped by
+  conventional-commit prefix (feat/fix/docs/refactor/test/chore); merge
+  commits surface as shipped PRs; `git status` feeds the In-progress section.
+- **Draft mode (`--draft`):** sends the digest to your local model via an
+  OpenAI-compatible endpoint and gets back Yesterday/Today/Blockers prose.
+  Configure with env vars (Ollama defaults shown):
+
+```bash
+export AUTOSTANDUP_BASE_URL="http://localhost:11434/v1"
+export AUTOSTANDUP_MODEL="llama3.1"
+# freellmapi works too — it's OpenAI-compatible:
+export AUTOSTANDUP_BASE_URL="https://api.freellmapi.com/v1"
+export AUTOSTANDUP_API_KEY="<your key>"
+```
+
+- **MCP server:** exposes `what_did_i_ship {since?, author?, root?}` so your
+  coding agent can answer "what did I ship this week" from local git.
+- **Push:** `--push-slack` POSTs the Markdown to a Slack incoming webhook
+  (URL from the flag or `AUTOSTANDUP_SLACK_WEBHOOK`). Commit-derived text
+  is sanitized before posting: control characters stripped, lines
+  truncated at 500 chars, and `@channel`/`@here`/`@everyone` neutralized
+  to `[at]channel`-style text — so a hostile commit message can never ping
+  the channel or inject payloads. Jira/Confluence push
+  is intentionally not built in — paste the Markdown, keep your tokens
+  out of another integration.
+
+## Date handling
+
+Bare dates and words are normalized to explicit midnight (`2026-10-14` →
+`2026-10-14 00:00`, `yesterday` → yesterday 00:00) because git's date parser
+treats them as *noon* — silently dropping morning commits.
+
+## Tests
+
+```bash
+python3 -m unittest discover -s tests   # 36 tests, no network, no model
+```
+
+## License
+
+TBD

standupguy-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "standupguy"
+version = "0.1.0"
+description = "Local-first standup notes from git ground truth."
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{name = "Calas Automations Inc."}]
+license = {text = "MIT"}
+
+[project.urls]
+Homepage = "https://github.com/calasdan-sketch/standupguy"
+Issues = "https://github.com/calasdan-sketch/standupguy/issues"
+
+[project.scripts]
+standupguy = "standupguy.cli:main"
+
+[tool.setuptools]
+packages = ["standupguy"]

standupguy-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

standupguy-0.1.0/standupguy/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

standupguy-0.1.0/standupguy/cli.py

@@ -0,0 +1,134 @@
+"""StandupGuy: kill the tracker trap without leaking data.
+
+Reads local git history and drafts your standup notes, weekly summary,
+and sprint-review bullets as Markdown. Deterministic digest works fully
+offline; --draft uses YOUR local model endpoint (Ollama/freellmapi).
+Your history never touches a cloud SaaS.
+
+  standupguy                  # yesterday's digest
+  standupguy --week           # last 7 days
+  standupguy --draft          # LLM prose: Yesterday / Today / Blockers
+  standupguy --sprint         # sprint-review bullets
+  standupguy mcp              # MCP server: ask "what did I ship this week"
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+
+from . import digest as digest_mod
+from . import draft as draft_mod
+from . import gitlog as gitlog_mod
+from . import mcp as mcp_mod
+from . import push as push_mod
+from . import serve as serve_mod
+
+VERSION = "0.1.0"
+
+
+def _resolve_author(args, root: str) -> str | None:
+    if args.all:
+        return None
+    if args.author:
+        return args.author
+    return gitlog_mod.default_author(root) or None
+
+
+def cmd_digest(args) -> int:
+    root = args.root
+    author = _resolve_author(args, root)
+    if args.week or args.sprint:
+        md = digest_mod.weekly_markdown(root, author)
+        label = "week"
+    else:
+        since = args.since or "yesterday"
+        label = f"since {since}"
+        md = digest_mod.digest_markdown(root, since, label, author)
+    if args.draft:
+        try:
+            md = draft_mod.draft(
+                md, base_url=args.base_url, model=args.model) + "\n"
+        except draft_mod.DraftError as e:
+            print(f"error: {e}", file=sys.stderr)
+            return 2
+    if args.format == "json":
+        commits = gitlog_mod.commits_since(
+            root, "7 days ago" if (args.week or args.sprint) else
+            (args.since or "yesterday"), author)
+        print(json.dumps({
+            "repo": gitlog_mod.repo_name(root), "label": label,
+            "in_progress": gitlog_mod.uncommitted(root),
+            "commits": [{"sha": c.sha, "author": c.author, "date": c.date,
+                         "subject": c.subject, "files": c.files,
+                         "pr": c.pr_number} for c in commits],
+        }, indent=2))
+        return 0
+    if args.push_slack:
+        webhook = args.push_slack if args.push_slack is not True else \
+            os.environ.get("AUTOSTANDUP_SLACK_WEBHOOK", "")
+        if not webhook:
+            print("error: no webhook — pass --push-slack <url> or set "
+                  "AUTOSTANDUP_SLACK_WEBHOOK", file=sys.stderr)
+            return 2
+        try:
+            push_mod.push_slack(webhook, md)
+            print("pushed to Slack ✓")
+        except push_mod.PushError as e:
+            print(f"error: {e}", file=sys.stderr)
+            return 2
+        return 0
+    sys.stdout.write(md)
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(prog="standupguy", description=__doc__)
+    p.add_argument("--version", action="version", version=f"%(prog)s {VERSION}")
+    p.add_argument("--root", default=os.getcwd(), help="Repo path.")
+    p.add_argument("--author", default=None, help="Filter by author.")
+    p.add_argument("--all", action="store_true",
+                   help="Include all authors (default: your git user).")
+    p.add_argument("--since", default=None,
+                   help="git date: 'yesterday' (default), '2026-10-01', …")
+    p.add_argument("--week", action="store_true", help="Last 7 days.")
+    p.add_argument("--sprint", action="store_true",
+                   help="Sprint-review bullets (weekly + highlights).")
+    p.add_argument("--draft", action="store_true",
+                   help="Draft Yesterday/Today/Blockers prose via local model.")
+    p.add_argument("--format", choices=["markdown", "json"],
+                   default="markdown")
+    p.add_argument("--push-slack", nargs="?", const=True, default=None,
+                   metavar="WEBHOOK_URL",
+                   help="POST the notes to a Slack webhook "
+                        "(or AUTOSTANDUP_SLACK_WEBHOOK).")
+    p.add_argument("--base-url", default=None)
+    p.add_argument("--model", default=None)
+    p.add_argument("cmd", nargs="?", choices=["mcp", "serve"],
+                   help="Run the MCP server (mcp) or HTTP bridge (serve) "
+                        "for n8n / workflow tools.")
+    p.add_argument("--port", type=int, default=8765,
+                   help="Port for `serve` (default 8765).")
+    p.add_argument("--host", default="127.0.0.1",
+                   help="Bind host for `serve` (default 127.0.0.1).")
+    return p
+
+
+def main(argv=None) -> int:
+    args = build_parser().parse_args(argv)
+    if args.cmd == "mcp":
+        return mcp_mod.serve(args.root)
+    if args.cmd == "serve":
+        return serve_mod.serve(args.root, args.host, args.port)
+    try:
+        gitlog_mod._git(args.root, "rev-parse", "--git-dir")
+    except RuntimeError:
+        print("error: not a git repo", file=sys.stderr)
+        return 2
+    return cmd_digest(args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

standupguy-0.1.0/standupguy/digest.py

@@ -0,0 +1,95 @@
+"""Digest: turn commits into grouped Markdown. Deterministic, offline.
+
+Groups by conventional-commit prefix (feat/fix/docs/refactor/test/chore),
+falls back to an 'other' bucket. Merge commits surface as shipped PRs.
+"""
+
+from __future__ import annotations
+
+import re
+from collections import OrderedDict
+
+from . import gitlog as gitlog_mod
+
+_PREFIX_RE = re.compile(r"^(\w+)(?:\(.+\))?[:!]\s*(.+)$", re.IGNORECASE)
+
+GROUP_ORDER = ["feat", "fix", "refactor", "docs", "test", "chore", "other"]
+GROUP_TITLES = {
+    "feat": "Features", "fix": "Fixes", "refactor": "Refactors",
+    "docs": "Docs", "test": "Tests", "chore": "Chores", "other": "Other",
+}
+
+
+def classify(subject: str) -> tuple[str, str]:
+    """(group, cleaned subject)."""
+    m = _PREFIX_RE.match(subject.strip())
+    if m and m.group(1).lower() in GROUP_TITLES:
+        return m.group(1).lower(), m.group(2).strip()
+    return "other", subject.strip()
+
+
+def group_commits(commits: list[gitlog_mod.Commit]
+                  ) -> "OrderedDict[str, list[gitlog_mod.Commit]]":
+    groups: OrderedDict[str, list] = OrderedDict(
+        (g, []) for g in GROUP_ORDER)
+    for c in commits:
+        g, _ = classify(c.subject)
+        groups[g].append(c)
+    return groups
+
+
+def _commit_line(c: gitlog_mod.Commit) -> str:
+    _, clean = classify(c.subject)
+    files = f" ({len(c.files)} files)" if c.files else ""
+    pr = f" [PR #{c.pr_number}]" if c.pr_number else ""
+    return f"- {clean}{pr}{files} `{c.sha[:7]}`"
+
+
+def digest_markdown(root: str, since: str, label: str,
+                    author: str | None = None) -> str:
+    commits = gitlog_mod.commits_since(root, since, author)
+    in_progress = gitlog_mod.uncommitted(root)
+    repo = gitlog_mod.repo_name(root)
+    lines = [f"# Standup — {repo}", f"_{label}_", ""]
+    if not commits and not in_progress:
+        lines.append("No commits or uncommitted changes in range. "
+                     "Touch grass. 🌱")
+        return "\n".join(lines) + "\n"
+    if commits:
+        lines.append("## Shipped")
+        for group, items in group_commits(commits).items():
+            if not items:
+                continue
+            lines.append(f"### {GROUP_TITLES[group]}")
+            lines.extend(_commit_line(c) for c in items)
+            lines.append("")
+    if in_progress:
+        lines.append("## In progress (uncommitted)")
+        lines.extend(f"- `{p}`" for p in sorted(in_progress)[:20])
+        if len(in_progress) > 20:
+            lines.append(f"- …and {len(in_progress) - 20} more")
+        lines.append("")
+    lines.append("## Blockers")
+    lines.append("_none reported — fill in yours_")
+    lines.append("")
+    return "\n".join(lines)
+
+
+def weekly_markdown(root: str, author: str | None = None) -> str:
+    commits = gitlog_mod.commits_since(root, "7 days ago", author)
+    repo = gitlog_mod.repo_name(root)
+    by_day: OrderedDict[str, list] = OrderedDict()
+    for c in commits:
+        by_day.setdefault(c.date, []).append(c)
+    lines = [f"# Weekly summary — {repo}",
+             f"_{len(commits)} commits in the last 7 days_", ""]
+    for day in sorted(by_day):
+        lines.append(f"## {day}")
+        for group, items in group_commits(by_day[day]).items():
+            if items:
+                lines.append(f"### {GROUP_TITLES[group]}")
+                lines.extend(_commit_line(c) for c in items)
+        lines.append("")
+    lines.append("## Highlights for sprint review")
+    lines.append("_pick 3–5 bullets from above_")
+    return "\n".join(lines) + "\n"

standupguy-0.1.0/standupguy/draft.py

@@ -0,0 +1,100 @@
+"""Draft: turn a digest into Yesterday/Today/Blockers prose via a local model.
+
+Local-first: the default endpoint is Ollama on localhost. Point
+AUTOSTANDUP_BASE_URL at freellmapi or any OpenAI-compatible endpoint.
+Your git history never leaves the machine except to the endpoint YOU
+configured. No cloud SaaS, no data-leak ceremony.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import urllib.request
+import urllib.error
+
+
+class DraftError(RuntimeError):
+    pass
+
+
+# Largest digest (characters) sent to the model for --draft. A full-repo
+# digest can be hundreds of KB (the Round 2 panel measured 569KB/142k
+# tokens on one repo), so the digest is truncated for the MODEL CALL only;
+# the digest printed to the terminal is untouched.
+MAX_DIGEST_CHARS = 100_000
+
+TRUNCATION_NOTE = (
+    "\n\n[Note: this digest was truncated to 100,000 characters for the "
+    "model call. The full digest is still available above.]")
+
+
+DRAFT_TEMPLATE = """You are writing a developer's daily standup notes. Be terse.
+Use exactly these three sections:
+
+Yesterday:
+- 2-5 bullets of what was accomplished, in plain past tense.
+
+Today:
+- 2-4 bullets of what is in progress or planned next, inferred from the
+  in-progress files and the trajectory of yesterday's work.
+
+Blockers:
+- "None reported." unless the digest clearly shows something stuck.
+
+Rules: no fluff, no emojis, no inventing work that isn't in the digest.
+If the digest is thin, say so in one line and stop.
+
+Digest:
+---
+{digest}
+---
+"""
+
+
+def _cfg(base_url=None, api_key=None, model=None):
+    return {
+        "base_url": (base_url or os.environ.get("AUTOSTANDUP_BASE_URL")
+                     or "http://localhost:11434/v1").rstrip("/"),
+        "api_key": api_key or os.environ.get("AUTOSTANDUP_API_KEY") or "ollama",
+        "model": model or os.environ.get("AUTOSTANDUP_MODEL") or "llama3.1",
+    }
+
+
+def _cap_digest(digest_md: str) -> str:
+    """Truncate the digest for the model call; the terminal copy is full.
+
+    Returns the digest unchanged when it fits; otherwise keeps the first
+    MAX_DIGEST_CHARS characters and appends a note saying so. The note is
+    plain text without {} so DRAFT_TEMPLATE.format() stays safe.
+    """
+    if len(digest_md) <= MAX_DIGEST_CHARS:
+        return digest_md
+    return digest_md[:MAX_DIGEST_CHARS] + TRUNCATION_NOTE
+
+
+def draft(digest_md: str, *, base_url=None, api_key=None, model=None,
+          timeout: int = 120) -> str:
+    digest_md = _cap_digest(digest_md)
+    cfg = _cfg(base_url, api_key, model)
+    body = json.dumps({
+        "model": cfg["model"],
+        "messages": [{"role": "user",
+                      "content": DRAFT_TEMPLATE.format(digest=digest_md)}],
+        "temperature": 0.3,
+    }).encode()
+    req = urllib.request.Request(
+        cfg["base_url"] + "/chat/completions", data=body,
+        headers={"Content-Type": "application/json",
+                 "Authorization": f"Bearer {cfg['api_key']}"})
+    try:
+        with urllib.request.urlopen(req, timeout=timeout) as resp:
+            data = json.loads(resp.read().decode())
+    except urllib.error.URLError as e:
+        raise DraftError(
+            f"cannot reach model at {cfg['base_url']} "
+            f"(set AUTOSTANDUP_BASE_URL): {e.reason}")
+    try:
+        return data["choices"][0]["message"]["content"].strip()
+    except (KeyError, IndexError, TypeError) as e:
+        raise DraftError(f"unexpected response shape: {e}")