Skip to content

Knowledge board: manage the papers and wikis, one tap at a time - #33

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/knowledge-board
Aug 19, 2026
Merged

Knowledge board: manage the papers and wikis, one tap at a time#33
Jammy2211 merged 1 commit into
mainfrom
feature/knowledge-board

Conversation

@Jammy2211

Copy link
Copy Markdown
Collaborator

Closes #32. Fifth repo of the readability arc; delivers the "dashboard-style surfaces for papers and wiki contents?" research prompt's investigation AND the approved surface, with the human's direction: this board is the working management tool for the papers/wikis.

The knowledge board

  • scripts/board.py — stdlib-only, fully local (no network): parses frontmatter statuses, **Canonical BibTeX key:** markers, bib entry counts, reading-queue sections, wikilink totals; pure render(md | md-brief | html | badge | json).
  • Management-first html (Pages): the reading queue (8 sections, 230 papers), the citation work queue (389 TODO of 643 sections), and per-wiki maturity bars each carry a one-tap 📋 copying a paste-ready Claude prompt that executes the repo's own documented workflow (file the next paper per bibliography/README; resolve TODO keys; upgrade a stub; /memory <domain> recall chips). Contents-level only — titles/counts, never claim text (test-pinned).
  • knowledge_board.yml: push (wiki/bib/queue/index/board) + weekly cron + dispatch → Pages + badge.json + the README memory:begin/end strip. Nothing committed — validate_structure.py bans .html and gates the exhaustive root allowlist, so every surface renders fresh in CI. make board for local use.

Readability + declutter

  • README: knowledge badge, "(mobile phone dashboard)" board paragraph, Current contents auto-strip, the Mind-vs-Memory boundary line.
  • index.md: the drifted "Status (2026-05-22)" off-repo folder dump (with its false "File: lines" claim) → a 3-line provenance note pointing at the live board.
  • Doctrine fix: AGENTS.md's "never reference PyAutoMemory content into public repos" contradicted the README's CC BY 4.0 licence on this public repo — now a scope rule: out of scope for user-facing repos; link, never inline.
  • 8 schema-invalid status: draft pages (all in methods/) → drafted; bibliography/README archaeology trimmed; AI_POLICY.md/CONTRIBUTING.md.github/ (validator allowlist updated; spawn MEMORY_RULES/spec/fixtures updated in PyAutoMind in lockstep, including retiring the dead bibliography/*.py rule and an explicit DROP for this workflow — fail-closed held).
  • Untouched by design: reading-queue.md (carries an uncommitted hand edit), the 67 pages with off-repo PDF frontmatter (human-decision follow-up), stale remote branches.

Verification

  • make validate + 18 tests green (8 new board tests: synthetic-tree counts, contents-level no-leak guarantee, workflow-prompt anchors, html self-containment, live-repo schema-valid statuses).
  • Live render cross-checks the census: 166 pages, 254/643 resolved keys, 1,099 bib entries, 8 queue sections.
  • PyAutoMind spawn suite 154/154 after the lockstep.
  • After merge: create the Pages site out-of-band, dispatch, verify the live page/badge/strip.

🤖 Generated with Claude Code

scripts/board.py — stdlib-only, fully local parse (frontmatter statuses,
canonical-key markers, bib entries, reading-queue sections, wikilinks) +
pure render (md / md-brief / html / badge / json), the Heart/Hands
dashboard pattern. Management-first: the reading queue, the citation TODO
queue (389 sections), and per-wiki maturity each carry a one-tap 📋
paste-ready Claude prompt executing the repo's own documented workflow;
contents-level only (titles/counts, never claim text — test-pinned).
knowledge_board.yml publishes Pages + badge.json + the README
memory:begin/end strip; nothing is committed (validate_structure bans
.html). make board renders locally.

README gains the knowledge badge + board paragraph + Current contents
strip + the Mind-vs-Memory boundary line; index.md's drifted 2026-05-22
archaeology trimmed to a provenance note; AGENTS.md's 'never reference in
public repos' rule reworded as a scope rule (it contradicted the CC BY 4.0
licence on this public repo); bibliography/README archaeology trimmed;
8 schema-invalid 'status: draft' pages normalized to drafted;
AI_POLICY/CONTRIBUTING move under .github/ (validator allowlist updated;
spawn contract updated in PyAutoMind in lockstep).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@Jammy2211
Jammy2211 merged commit bd7fccb into main Aug 19, 2026
1 check passed
@Jammy2211
Jammy2211 deleted the feature/knowledge-board branch August 19, 2026 23:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: knowledge board — manage the papers and wikis, one tap at a time

1 participant