Skip to content

feat: intake census + dashboard modes — Mind backlog page #30

Description

@Jammy2211

Overview

Add the two follow-up modes the Intake Agent's own docs already name as planned: intake census (a read-only inventory of every filed PyAutoMind prompt) and intake dashboard (renders that census as a clean backlog page committed to the PyAutoMind repo). This gives the Mind a single GitHub-rendered view of the backlog — what is filed, where, at what difficulty/priority — plus hygiene flags for malformed prompts. The repair sibling mode stays out of scope.

Plan

  • Add intake census: walk all work-type folders + triage/ in PyAutoMind, parse each prompt's light header, and report an inventory with hygiene flags (missing header fields, unresolved targets).
  • Add intake dashboard: render the census as a clean markdown backlog page; dry-run prints to stdout, --apply writes PyAutoMind/dashboard.md.
  • Wire both subcommands + --json through intake.sh.
  • Update intake docs and the /intake skill body; move census/dashboard out of "planned follow-up" (repair stays planned).
  • Generate and commit the first dashboard.md to PyAutoMind.
Detailed implementation plan

Affected Repositories

  • PyAutoBrain (primary — agent code + docs)
  • PyAutoMind (generated dashboard.md page)

Branch Survey

Repository Current Branch Dirty?
./PyAutoBrain docs/build-capabilities-consumer-column (clean, 1 doc commit ahead of main) clean
./PyAutoMind main clean

Suggested branch: feature/intake-census-dashboard (cut from origin/main)

Implementation Steps

  1. agents/conductors/intake/_intake.py — add parse_header(text): extract the light Type:/Target:/Difficulty:/Autonomy:/Priority:/Status: header lines (intake's own convention; no YAML).
  2. agents/conductors/intake/_intake.py — add census(mind): walk WORK_TYPES folders + triage/ (skip README.md; count issued/ separately as already-dispatched). Per-prompt record: path, folder-derived work-type/target, title, header fields, missing-field flags. Aggregates: counts by work-type, target, difficulty, status; hygiene list.
  3. agents/conductors/intake/_intake.py — add render_dashboard(census): markdown page with summary count table, per-work-type sections with linked prompt tables (target/difficulty/autonomy/priority), triage + hygiene sections, and a "generated by intake dashboard — do not hand-edit" stamp. No Heart/health data — this is the Mind backlog view, honouring the agent's "never emit a health dashboard" rule.
  4. agents/conductors/intake/_intake.pymain(): add census subcommand (always read-only) and dashboard (stdout on dry-run; writes dashboard.md under --apply); both support --json.
  5. agents/conductors/intake/intake.sh — add census/dashboard to the known-subcommand list and the help header comment.
  6. Docs — agents/conductors/intake/AGENTS.md modes table (census/dashboard shipped; repair stays planned), INTAKE_TAXONOMY.md short section, skills/intake/intake.md (the /intake command body), skills/COMMANDS.md routing line.
  7. PyAutoMind/dashboard.md — run intake dashboard --apply against the live Mind; commit the first page via prompt_sync_push.

Key Files

  • PyAutoBrain/agents/conductors/intake/_intake.py — analysis core (stdlib-only; writes only under --apply)
  • PyAutoBrain/agents/conductors/intake/intake.sh — CLI front door / subcommand routing
  • PyAutoBrain/agents/conductors/intake/AGENTS.md — agent contract; names census/dashboard as the planned follow-up
  • PyAutoBrain/agents/faculties/sizing/_sizing.py — shared WORK_TYPES / repo sets consumed by the census walk
  • PyAutoMind/dashboard.md — the generated backlog page (new)

Testing

PyAutoBrain has no pytest suite — validate via CLI: dry-run / --json / --apply against a temp Mind fixture (missing headers, triage files, empty folders), then against the live Mind; confirm dashboard.md renders cleanly on GitHub.

Original Prompt

Click to expand starting prompt

Add census and dashboard modes to the PyAutoBrain intake agent

Type: feature
Target: PyAutoBrain
Repos:

  • PyAutoBrain
  • PyAutoMind
    Difficulty: medium
    Autonomy: supervised
    Priority: normal
    Status: formalised

Add census and dashboard modes to the PyAutoBrain intake agent. A census mode inventories every filed PyAutoMind prompt (work-type, target, difficulty, status), and a dashboard mode renders that census as a clean summary page committed to the PyAutoMind repo. Touches the intake agent code in PyAutoBrain plus a generated page in PyAutoMind.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions