Council minutes artifact: render a sitting's question, synthesis, and verbatim takes to HTML on close

[dotdevdotdev]

Goal

When a council sitting wraps, produce a presentation-quality standalone HTML 'minutes' artifact: the original question, the orchestrator's synthesis, and the verbatim per-soul takes (attributed, with take/ack/pass status), one section per prompt for multi-prompt sittings. Owner request 2026-07-04.

Design (handoff pattern: in-context distill, deterministic render)

• Everything verbatim already persists under ~/.agentwire/council/<name>/prompts/<id>/ — the renderer reads it deterministically. The synthesis exists only in the orchestrator's context, so it's an input: --synthesis <file-or-text> (optional; omitted = minutes without synthesis section).
• CLI: agentwire council minutes [--name <sitting>] [--prompt <id|all>] [--synthesis ...] → writes ~/.agentwire/artifacts/council-<name>-minutes/index.html, prints the path, and opens it as an artifact window when the portal is up. MCP: council_minutes(...).
• council_stop gains --minutes/--no-minutes (default: render when any prompt exists) so closing a sitting leaves the record behind automatically. Prompt history is already kept on stop, so minutes can also be rendered for past sittings (cc-vocab, monetization, … exist today).
• HTML: self-contained (inline CSS, no external fetches — artifact CSP blocks them), theme-aware, sections: question → synthesis → takes (soul name, status, verbatim text) → sitting metadata (roster, timestamps).
• Pairs with the artifact-download issue for pull-out/share, but doesn't depend on it to render.

Verification

agentwire council minutes --name cc-vocab --synthesis 'test' renders today's real sitting into a readable standalone HTML; council_stop on a fresh sitting auto-produces minutes; sitting with zero prompts produces none.

Built by dotdev.dev

[dotdevdotdev]

Breadcrumb — implemented in PR #710 (draft).

What we built:

• agentwire/council/minutes.py: pure renderer — gather() / render_html() / write_minutes(). Prompt history is disk-derived (view.available_prompt_ids), sitting metadata falls back sitting.json → archive.json, so live and dismissed sittings render identically. Reply dicts carry content only (soul/kind/text/timestamp), never local paths — the artifact is shareable.
• agentwire/templates/council/minutes.html.j2: self-contained (inline CSS only, CSP-safe), theme-aware via prefers-color-scheme. Synthesis sits between question and takes for a single-prompt render, leads the doc for multi-prompt.
• CLI council minutes [--name] [--prompt <id|all>] [--synthesis <file-or-text>]; council stop gained --minutes/--no-minutes + --synthesis (tri-state default: render exactly when any prompt exists). MCP: new council_minutes, council_stop(name, minutes, synthesis).
• Best-effort portal open POSTs the existing /api/desktop/window/open route — no portal routes/static touched (concurrent Artifact windows: download the standalone HTML #707 owns that surface).

Decisions locked in:

• Jinja2 autoescape=True forced explicitly — select_autoescape keys off the final extension, and .html.j2 ends in .j2, which silently disables escaping. Soul takes are untrusted content. (The handoff renderer has the same latent gap; not touched here.)
• --synthesis is file-or-text: an existing file path reads the file, anything else is the synthesis verbatim.
• One minutes artifact per sitting name (index.html overwritten on re-render).

Verified: full suite 2555 passed, ruff clean; 26 new unit tests against synthetic prompt dirs; real-fixture render of dismissed sitting cc-vocab (6 souls, ack+followup badges, synthesis) with the live portal accepting the artifact window (opened: true). Zero-prompt sittings produce no minutes, on both minutes and stop.