Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
7 changes: 4 additions & 3 deletions .github/workflows/knowledge_board.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: Knowledge Board
name: Dashboard

# Publishes the knowledge board — the management view of the Memory's papers
# Publishes the PyAutoMemory Dashboard — the management view of the Memory's papers
# and wikis (scripts/board.py, the Heart/Hands dashboard pattern):
# * the GitHub Pages page (one-tap 📋 work prompts for a phone),
# * badge.json (the shields endpoint the README badge reads),
Expand Down Expand Up @@ -35,7 +35,7 @@ concurrency:

jobs:
board:
name: Render + publish the knowledge board
name: Render + publish the dashboard
runs-on: ubuntu-latest
environment:
name: github-pages
Expand All @@ -53,6 +53,7 @@ jobs:
python scripts/board.py --html > _site/index.html
python scripts/board.py --badge > _site/badge.json
python scripts/board.py --md > board.md
cp board.md _site/dashboard.md
python scripts/board.py --md-brief > readme_strip.md

- name: Write the board to the job step summary
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,8 @@ verify them. Memory holds *what the science says*; what the organism *did*
lives in the Mind. Source PDFs live off-repo; what's here is the durable
knowledge. Start at [`index.md`](index.md).

See the **[PyAutoMemory Knowledge Board](https://pyautolabs.github.io/PyAutoMemory/)**
(mobile phone dashboard) for managing all of it from one page: the reading
See the **[PyAutoMemory Dashboard](https://pyautolabs.github.io/PyAutoMemory/)**
for managing all of it from one page: the reading
queue, the paper sections still needing a canonical citation key, and each
sub-wiki's maturity — every work queue carrying a one-tap 📋 button that
copies a paste-ready Claude prompt (file the next paper, resolve keys,
Expand All @@ -27,7 +27,7 @@ upgrade a stub, or `/memory <domain>` to recall what's known).
<!-- The line below is auto-updated by .github/workflows/knowledge_board.yml (everything -->
<!-- between the memory:begin/memory:end markers is replaced with the rendered strip). -->
<!-- memory:begin -->
🧠 **166 pages** · 69 drafted · 40% of 643 paper sections cite a resolved key · 231 papers queued · [knowledge board →](https://pyautolabs.github.io/PyAutoMemory/)
🧠 **166 pages** · 69 drafted · 40% of 643 paper sections cite a resolved key · 231 papers queued · [dashboard →](https://pyautolabs.github.io/PyAutoMemory/)
<!-- memory:end -->

## The sub-wikis
Expand Down
4 changes: 2 additions & 2 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ the schema in [`wiki/CLAUDE.md`](wiki/CLAUDE.md).
`bibliography/`, stub it in the matching sub-wiki `sources/*.md`, mark the
line DONE, and run `make validate` — the PDF itself stays off-repo, never
committed. Per-section waiting/read counts live on the
[knowledge board](https://pyautolabs.github.io/PyAutoMemory/).
[dashboard](https://pyautolabs.github.io/PyAutoMemory/).

## Schema

Expand All @@ -60,4 +60,4 @@ externally). Most legacy per-paper entries remain filename-inferred stubs:
upgrade them to compact, claim-oriented `drafted` entries only after
verifying the paper, and log the change in the relevant sub-wiki. The live
counts — pages, maturity, unresolved citation keys, reading queue — are on
the [knowledge board](https://pyautolabs.github.io/PyAutoMemory/).
the [dashboard](https://pyautolabs.github.io/PyAutoMemory/).
12 changes: 6 additions & 6 deletions scripts/board.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
"""scripts/board.py — the PyAutoMemory knowledge board.
"""scripts/board.py — the PyAutoMemory Dashboard.

A phone-readable, MANAGEMENT-FIRST view of the repo's knowledge: what is
waiting to be read, which paper sections still need a canonical BibTeX key,
Expand Down Expand Up @@ -199,7 +199,7 @@ def _stub_prompt(snapshot: dict, wiki: str) -> str:
# --- renderers ------------------------------------------------------------------
def _render_md(snapshot: dict) -> str:
t = _totals(snapshot)
lines = ["# PyAutoMemory knowledge board", "",
lines = ["# PyAutoMemory Dashboard", "",
"_Contents and work queues — the knowledge itself lives in the "
"wiki pages._", "",
f"**{t['pages']} pages** across {len(snapshot.get('wikis') or [])} "
Expand All @@ -221,7 +221,7 @@ def _render_md(snapshot: dict) -> str:
lines.append("- _(queue empty or unavailable)_")
url = pages_url(snapshot)
if url:
lines += ["", f"[Knowledge board]({url}) — one-tap 📋 work prompts"]
lines += ["", f"[Dashboard]({url}) — one-tap 📋 work prompts"]
return "\n".join(lines)


Expand All @@ -233,7 +233,7 @@ def _render_md_brief(snapshot: dict) -> str:
f"{t['queued']} papers queued"]
url = pages_url(snapshot)
if url:
bits.append(f"[knowledge board →]({url})")
bits.append(f"[dashboard →]({url})")
return " · ".join(bits)


Expand Down Expand Up @@ -339,8 +339,8 @@ def _render_html(snapshot: dict) -> str:
function fb(t){{window.prompt('Copy this:',t)}}
</script></head>
<body><div class="wrap">
<h1>PyAutoMemory knowledge board</h1>
<p><span class="pill">{t['pages']} pages · {pct}% cited</span></p>
<h1>PyAutoMemory Dashboard</h1>
<p><span class="pill">{t['pages']} pages · {pct}% cited</span> <span class="meta"><a href="dashboard.md">markdown version</a></span></p>
<p class="meta">Contents and work queues for the organism's long-term memory
— titles and counts only; the knowledge itself lives in the wiki pages.
📋 copies a paste-ready prompt for a Claude Code chat.</p>
Expand Down
2 changes: 1 addition & 1 deletion tests/test_board.py
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
"""tests/test_board.py — the knowledge board (scripts/board.py).
"""tests/test_board.py — the PyAutoMemory Dashboard (scripts/board.py).

The board's contract: counts are computed correctly from a synthetic tree,
every fmt renders, the work-queue prompts reference the repo's documented
Expand Down
Loading