onboard_render.py

"""Turn collected answers into a PREFERENCES.md string. Pure function, no I/O."""
import datetime

VERSION = "0.8.0"

_DEFAULTS = {
    "name":      "",
    "languages": "unspecified",
    "style":     "concise",
    "tests":     "test-after",
    "commits":   "conventional commits",
    "review":    "critical issues only",
}


def _section(title, bullets):
    """Return a markdown section string, omitting any blank bullets."""
    kept = [f"- {b}" for b in bullets if b and b != "unspecified"]
    if not kept:
        kept = ["- _(edit me)_"]
    return f"## {title}\n" + "\n".join(kept)


def render(raw: dict) -> str:
    a = {**_DEFAULTS, **{k: v for k, v in raw.items() if v}}
    now = datetime.datetime.now().isoformat(timespec="seconds")

    identity = _section("Identity", [
        f"Name: {a['name']}" if a["name"] else "",
    ])

    code = _section("Code style", [
        f"Language(s): {a['languages']}",
        f"Explanations: {a['style']}",
    ])

    workflow = _section("Workflow", [
        f"Test strategy: {a['tests']}",
        f"Commit style: {a['commits']}",
    ])

    comms = _section("Communication", [
        f"Review depth: {a['review']}",
        "Tone: direct, skip pleasantries",
        "Surface tradeoffs: always",
    ])

    constraints = _section("Constraints", [
        "_(edit me: primary stack, deployment targets, off-limits patterns)_",
    ])

    # Only include Identity if a name was given
    sections = ([identity] if a["name"] else []) + [code, workflow, comms, constraints]
    body = "\n\n".join(sections)

    return f"""\
# Personal Preferences
<!-- generated by agentic-stack onboard v{VERSION} on {now} -->
<!-- re-run:  agentic-stack <harness> --reconfigure  to update -->

> **This file is yours.** Edit it any time — it's the first thing your AI
> reads at the start of every session.

{body}
"""