Skip to content

The boards wear their organ's logo #260

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Jammy2211 merged 3 commits into from
Aug 23, 2026
Merged

The boards wear their organ's logo #260

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
8351c39
The boards wear their organ's logo
claude Aug 23, 2026
6106ffe
Sample the remaining four logos; fix the cut titles; show the work type
claude Aug 23, 2026
723e8be
Keep the theme behind the tenant firewall
claude Aug 23, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
157 changes: 75 additions & 82 deletions agents/conductors/intake/_intake.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,16 @@
policy as _sizing_policy, BODY_MAP_PATH,
)

# The shared board theme: the one place that answers "what does a one-tap board
# look like". Presentation only — the stylesheet, the hero, the pills — so this
# page and the Brain board are visibly the same family (board/_theme.py).
sys.path.insert(0, str(Path(__file__).resolve().parents[3] / "board"))
from _theme import ( # noqa: E402
JS as _THEME_JS, boards_footer, css as _theme_css, hero, pills, stats,
)

THEME_ORGAN = "mind" # whose logo this page wears

# --- work-type classification -------------------------------------------------
# Keyword signals per work-type. The classifier scores each type by keyword hits
# (word-boundary prefix match via _sizing._hits) and picks the strongest; ties /
Expand Down Expand Up @@ -104,16 +114,54 @@ def _slug(text: str, maxwords: int = 7) -> str:
return slug[:48].strip("_") or "untitled"


# Words that must never be the last one in a truncated title. A cut landing
# on "the" or "which" reads as a rendering bug rather than a summary — the
# page said "kernel-CDF numba fast path (the" for months.
_DANGLING = {
"a", "an", "and", "are", "as", "at", "but", "by", "can", "for", "from",
"if", "in", "into", "is", "it", "its", "of", "on", "or", "our", "over",
"one", "other", "per", "so", "than", "that", "the", "their", "then",
"this", "to", "up", "via", "we", "what", "when", "which", "while",
"with", "without",
}
TITLE_WORDS = 12


def _shorten(words: list) -> str:
"""`words` cut to a title, ending somewhere a reader can stop.

Trailing function words are dropped, an orphaned opening bracket is
dropped with the fragment it opened, and an unpaired backtick is dropped
so the code span cannot bleed into the rest of the page. An ellipsis
marks that there was more — a silent cut is indistinguishable from a
title that simply ends badly.
"""
kept = list(words[:TITLE_WORDS])
while kept and kept[-1].lower().strip("(,;:—-") in _DANGLING:
kept.pop()
out = " ".join(kept).rstrip(" ,;:—-([{")
if out.count("(") > out.count(")"):
out = out[:out.rindex("(")].rstrip(" ,;:—-")
if out.count("`") % 2:
out = out[:out.rindex("`")].rstrip(" ,;:—-")
# Every guard above can eat the whole thing (a title that opens with a
# bracket, say) — fall back to the plain cut rather than to nothing.
return (out or " ".join(words[:TITLE_WORDS])) + "…"


def _title(text: str) -> str:
"""First markdown heading, else first non-empty line, trimmed to a title."""
for line in text.splitlines():
s = line.strip()
if not s:
continue
s = s.lstrip("#").strip().rstrip(":").rstrip(".")
# Keep it title-length: first sentence / ~10 words.
# Keep it title-length: first sentence / ~12 words.
s = re.split(r"(?<=[a-z])[.?!]\s", s)[0]
return " ".join(s.split()[:10]) or "Untitled"
words = s.split()
if not words:
return "Untitled"
return " ".join(words) if len(words) <= TITLE_WORDS else _shorten(words)
return "Untitled"


Expand Down Expand Up @@ -1121,63 +1169,10 @@ def render_dashboard(c: dict) -> str:
return "\n".join(L).rstrip("\n") + "\n"


_HTML_CSS = """\
:root{color-scheme:light dark;--bg:#fff;--fg:#1f2328;--muted:#59636e;
--line:#d1d9e0;--btn:#f6f8fa;--ok:#1a7f37;--accent:#0969da}
@media(prefers-color-scheme:dark){:root{--bg:#0d1117;--fg:#f0f6fc;
--muted:#9198a1;--line:#3d444d;--btn:#151b23;--ok:#3fb950;--accent:#4493f8}}
*{box-sizing:border-box}
body{margin:0 auto;max-width:44rem;padding:1rem 1rem 4rem;background:var(--bg);
color:var(--fg);font:16px/1.45 -apple-system,BlinkMacSystemFont,"Segoe UI",
Helvetica,Arial,sans-serif}
h1{font-size:1.35rem;margin:.4rem 0}
h2{font-size:1.15rem;margin-top:2rem;border-bottom:1px solid var(--line);
padding-bottom:.3rem}
h3{font-size:1rem;margin:1.2rem 0 .2rem}
a{color:var(--accent);text-decoration:none}
a:hover{text-decoration:underline}
.muted{color:var(--muted)}
.facets{color:var(--muted);font-size:.85em}
.mdsrc{font-size:.85em}
code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.92em;
background:var(--btn);padding:.1em .3em;border-radius:4px}
.task{display:flex;gap:.6rem;align-items:flex-start;padding:.45rem 0;
border-bottom:1px solid var(--line)}
.task p{margin:.25rem 0 0;flex:1;overflow-wrap:anywhere}
button.copy{flex:0 0 auto;width:2.6rem;height:2.6rem;font-size:1.1rem;
border:1px solid var(--line);border-radius:8px;background:var(--btn);
cursor:pointer;color:var(--fg)}
button.copy.ok{color:var(--ok);border-color:var(--ok)}
details{margin:.5rem 0}
summary{cursor:pointer;font-weight:600;padding:.4rem 0}
table.recent{width:100%;border-collapse:collapse;font-size:.95em}
table.recent td{border-bottom:1px solid var(--line);padding:.45rem .4rem .45rem 0;
vertical-align:top;overflow-wrap:anywhere}
table.recent td.when{white-space:nowrap;color:var(--muted);font-variant-numeric:
tabular-nums}
table.recent td.what{white-space:nowrap;color:var(--muted);font-size:.85em;
padding-top:.58rem}
table.recent td.pick{width:2.6rem;padding-right:0}
table.recent button.copy{width:2.2rem;height:2.2rem;font-size:.95rem}
button.more{display:block;width:100%;margin:.6rem 0;padding:.5rem;
border:1px solid var(--line);border-radius:8px;background:var(--btn);
color:var(--muted);cursor:pointer;font:inherit;font-size:.9em}
button.more:hover{color:var(--fg)}
"""

# One tap on 📋 → the command is on the clipboard; the button flashes ✓. The
# textarea path covers browsers without the async clipboard API.
_HTML_JS = """\
async function copyCmd(b){
const cmd=b.dataset.cmd;
try{await navigator.clipboard.writeText(cmd);}
catch(e){const t=document.createElement("textarea");t.value=cmd;
document.body.appendChild(t);t.select();document.execCommand("copy");
t.remove();}
b.textContent="\\u2713";b.classList.add("ok");
setTimeout(()=>{b.textContent="\\ud83d\\udccb";b.classList.remove("ok");},1200);}
document.addEventListener("click",e=>{
const b=e.target.closest("button.copy");if(b)copyCmd(b);});
# The dashboard-only half of the page script: the shared clipboard
# handler lives in the board theme, this reveals the Recent feed a page
# at a time.
_MORE_JS = """\
// Recent shows one page and reveals the next on each tap of the \u2026 button,
// which retires itself once the feed is exhausted. Every row is already in the
// DOM, so this never re-renders or re-sorts anything.
Expand Down Expand Up @@ -1227,12 +1222,10 @@ def link(path, text_html):
return f'<a href="{_attr(blob + path)}">{text_html}</a>'

def record_row(r):
text = link(r["path"], _summary_label(r["title"]))
facets = " · ".join(_summary_label(x) for x in
(r["target"], r["difficulty"],
r["autonomy"], r["priority"]) if x != "-")
if facets:
text += f' — <span class="facets">{facets}</span>'
text = link(r["path"], _summary_label(r["title"])) + pills(
*(_summary_label(x) for x in (r["target"], r["difficulty"],
r["autonomy"], r["priority"])),
work_type=r["work_type"])
return _html_task(text, f"/start_dev {r['path']}")

H = [
Expand All @@ -1244,21 +1237,22 @@ def record_row(r):
"<title>PyAutoMind Dashboard</title>",
f"<!-- generated by `pyauto-brain intake dashboard --apply` on "
f"{c['generated']} — regenerate, do not hand-edit -->",
f"<style>{_HTML_CSS}</style>",
f"<style>{_theme_css(THEME_ORGAN)}</style>",
"</head>",
"<body>",
"<h1>📋 PyAutoMind Dashboard</h1>",
"<p>Every task the Mind is holding. Tap a task's 📋 and its "
"<code>/start_dev</code> command is on your clipboard — paste it into "
"a Claude Code chat to route Claude straight to that task. "
'<a href="#recent">Recent</a> is the same work by date — what has been '
"happening rather than what to do next.</p>",
f'<p class="muted">In flight {c["issued_count"]} · '
f'Parked {len(c["parked"])} · Planned {len(c["planned"])} · '
f'Backlog {c["total"]}'
+ (f' · {link("dashboard.md", "markdown version")}' if home else "")
+ "</p>",
hero(THEME_ORGAN, "Dashboard",
"Every task the Mind is holding. Tap a task's 📋 and its "
"<code>/start_dev</code> command is on your clipboard — paste it "
"into a Claude Code chat to route Claude straight to that task. "
'<a href="#recent">Recent</a> is the same work by date — what has '
"been happening rather than what to do next."),
# The four numbers a human wants before reading a single row.
stats((c["issued_count"], "In flight"), (len(c["parked"]), "Parked"),
(len(c["planned"]), "Planned"), (c["total"], "Backlog")),
]
if home:
H.append(f'<p class="muted mdsrc">'
f'{link("dashboard.md", "markdown version")}</p>')
if c.get("drift"):
H += ['<p>⚠️ <b>Needs lifecycle reconciliation</b> — draft prompts '
"whose body records a fix PR (done, never advanced):</p>", "<ul>"]
Expand Down Expand Up @@ -1399,11 +1393,10 @@ def h2(title, src):
H += [record_row(r) for r in rows]
H += ["</details>"]

boards = _board_links(home)
if boards:
nav = " · ".join(f'<a href="{_attr(u)}">{n}</a>' for n, u in boards)
H.append(f'<p class="muted">Boards: {nav}</p>')
H += [f"<script>{_HTML_JS}</script>", "</body>", "</html>"]
footer = boards_footer(dict(_board_links(home)), THEME_ORGAN)
if footer:
H.append(footer)
H += [f"<script>{_THEME_JS}{_MORE_JS}</script>", "</body>", "</html>"]
return "\n".join(H) + "\n"


Expand Down
23 changes: 23 additions & 0 deletions board/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,29 @@ dispatch renders `--apply` output and deploys it to GitHub Pages (page +
`badge.json` + `board.json` + `board.md`). Nothing is committed to the repo —
the board is served, not stored, so a daily refresh makes no commit noise.

## Look (`_theme.py`)

`board/_theme.py` is the one place that answers *what does a one-tap board
look like* — the stylesheet, the hero, the facet pills, the family footer.
Presentation only: no state, no collection, no policy. It is shared, not
copied: this board and the Mind dashboard (rendered by the intake conductor)
both import it, so a change to the look lands on the whole family at once
rather than drifting page by page.

Each organ has an accent sampled from its own logo, and every board opens
with a dark hero reproducing that logo's wordmark — white `PyAuto`, the organ
name in its accent, the logo's tagline underneath. Below the hero the page
goes back to being a plain readable document, because these are lists people
scan on a phone before breakfast.

Colour is information, never decoration: the accent is organ identity; pills
are task facets, toned so that only the *exception* is coloured (`supervised`
is 9 of 10 prompts in the Mind, so it stays neutral — tinting it would paint
the backlog and say nothing); `ok`/`warn`/`bad` stay reserved for verdict
semantics. `ORGANS` holds the palette — `mind` and `brain` are sampled from
the real logo files, the other four are placeholders in the right hue family,
to be confirmed against each logo when that renderer adopts the theme.

## Configuration

Instance vocabulary lives in `config/policy.yaml` under `board:` (the declared
Expand Down
90 changes: 28 additions & 62 deletions board/_board.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,16 @@
from datetime import datetime, timezone
from pathlib import Path

# The shared board theme — presentation only: the stylesheet, the hero
# and the small components every one-tap board draws itself with, so
# this page and the Mind dashboard are visibly the same family.
sys.path.insert(0, str(Path(__file__).resolve().parent))
from _theme import ( # noqa: E402
JS as _THEME_JS, boards_footer, css as _theme_css, hero,
)

THEME_ORGAN = "brain" # whose logo this page wears

BRAIN_HOME = Path(__file__).resolve().parents[1]
# Default workspace root = the checkout's parent (the standard sibling layout
# the sizing faculty also assumes) — no instance path named here.
Expand Down Expand Up @@ -788,56 +798,6 @@ def render_md(data):
return "\n".join(L)


# The html twin — same CSS/JS contract as the Mind dashboard: self-contained
# (no external assets; inline script + href anchors only), one copy button per
# actionable row.
_HTML_CSS = """\
:root{color-scheme:light dark;--bg:#fff;--fg:#1f2328;--muted:#59636e;
--line:#d1d9e0;--btn:#f6f8fa;--ok:#1a7f37;--warn:#9a6700;--bad:#d1242f;
--accent:#0969da}
@media(prefers-color-scheme:dark){:root{--bg:#0d1117;--fg:#f0f6fc;
--muted:#9198a1;--line:#3d444d;--btn:#151b23;--ok:#3fb950;--warn:#d29922;
--bad:#f85149;--accent:#4493f8}}
*{box-sizing:border-box}
body{margin:0 auto;max-width:44rem;padding:1rem 1rem 4rem;background:var(--bg);
color:var(--fg);font:16px/1.45 -apple-system,BlinkMacSystemFont,"Segoe UI",
Helvetica,Arial,sans-serif}
h1{font-size:1.35rem;margin:.4rem 0}
h2{font-size:1.15rem;margin-top:2rem;border-bottom:1px solid var(--line);
padding-bottom:.3rem}
a{color:var(--accent);text-decoration:none}
a:hover{text-decoration:underline}
.muted{color:var(--muted)}
.ok{color:var(--ok)}.warn{color:var(--warn)}.bad{color:var(--bad)}
code{font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:.92em;
background:var(--btn);padding:.1em .3em;border-radius:4px}
.task{display:flex;gap:.6rem;align-items:flex-start;padding:.45rem 0;
border-bottom:1px solid var(--line)}
.task p{margin:.25rem 0 0;flex:1;overflow-wrap:anywhere}
button.copy{flex:0 0 auto;width:2.6rem;height:2.6rem;font-size:1.1rem;
border:1px solid var(--line);border-radius:8px;background:var(--btn);
cursor:pointer;color:var(--fg)}
button.copy.ok{color:var(--ok);border-color:var(--ok)}
button.copy.term{font-size:.95rem}
details{margin:.5rem 0}
summary{cursor:pointer;font-weight:600;padding:.4rem 0}
"""

_HTML_JS = """\
async function copyCmd(b){
const cmd=b.dataset.cmd;
try{await navigator.clipboard.writeText(cmd);}
catch(e){const t=document.createElement("textarea");t.value=cmd;
document.body.appendChild(t);t.select();document.execCommand("copy");
t.remove();}
const old=b.textContent;
b.textContent="\\u2713";b.classList.add("ok");
setTimeout(()=>{b.textContent=old;b.classList.remove("ok");},1200);}
document.addEventListener("click",e=>{
const b=e.target.closest("button.copy");if(b)copyCmd(b);});
"""


def _attr(s):
return html.escape(str(s), quote=True)

Expand All @@ -855,6 +815,10 @@ def _plain(text_html):
return f'<div class="task"><p>{text_html}</p></div>'


# The html twin. Self-contained by the same contract as the Mind dashboard —
# no external assets, inline style and script only, one copy button per
# actionable row — and dressed by the shared board theme, so this page and
# that one are visibly the same family (board/_theme.py).
def render_html(data):
blocking, attention = verdict(data)
esc = html.escape
Expand All @@ -867,21 +831,24 @@ def render_html(data):
"<title>PyAutoBrain Board</title>",
f"<!-- generated by `pyauto-brain board` on {data['generated']} — "
"regenerate, do not hand-edit -->",
f"<style>{_HTML_CSS}</style>",
f"<style>{_theme_css(THEME_ORGAN)}</style>",
"</head>",
"<body>",
"<h1>🧠 PyAutoBrain Board</h1>",
"<p>The organism's morning door — what ran overnight, who is waiting, "
"and what needs you. Tap 📋 to put a command on your clipboard for a "
"Claude Code chat; ⌨ rows are terminal commands.</p>",
hero(THEME_ORGAN, "Board",
"The organism's morning door — what ran overnight, who is "
"waiting, and what needs you. Tap 📋 to put a command on your "
"clipboard for a Claude Code chat; ⌨ rows are terminal "
"commands."),
]
verdict_cls = "bad" if blocking else ("warn" if attention else "ok")
spark = sparkline(data.get("history") or [])
spark_html = (f'<span class="muted" title="need-you count, last '
f'{min(len(data.get("history") or []), 14)} days"> · trend '
f'{esc(spark)}</span>') if spark else ""
H.append(f'<p><b class="{verdict_cls}">{esc(headline(data))}</b>'
f'<span class="muted"> — generated {esc(data["generated"])}</span>'
# The verdict is the one thing a human reads before anything else, so it
# gets a banner rather than a coloured word in a paragraph.
H.append(f'<p class="verdict {verdict_cls}"><b>{esc(headline(data))}</b>'
f'<span class="muted">generated {esc(data["generated"])}</span>'
f'{spark_html}</p>')
H.append("<h2>⌨ Morning sync (local)</h2>")
H.append(_row(
Expand Down Expand Up @@ -1110,11 +1077,10 @@ def community_row(e, note_html):
for d in data["degraded"]:
H.append(_plain(f'<span class="warn">{esc(d)}</span>'))

nav = " · ".join(f'<a href="{_attr(url)}">{esc(name)}</a>'
for name, url in data["boards"].items()
if name != "brain")
H.append(f'<p class="muted">Boards: {nav}</p>')
H += [f"<script>{_HTML_JS}</script>", "</body>", "</html>"]
footer = boards_footer(data["boards"], THEME_ORGAN)
if footer:
H.append(footer)
H += [f"<script>{_THEME_JS}</script>", "</body>", "</html>"]
return "\n".join(H) + "\n"


Expand Down
Loading
Loading