Absorb toc-index note directory indexing into notio

Problem¶

pixecog has a standalone code/utils/cli/toc-index.py script that regenerates index.md files for each note type directory (ideas, issues, commits, etc.). It's called via docs.mk Make targets (toc-all, toc-idea, toc-issue, etc.) and parses YAML frontmatter to build tables with configurable columns and grouping.

This is a generic pattern — every project with notio notes needs directory indexes. Currently each project would have to reimplement this.

Proposal¶

Add note directory indexing to notio, either: 1. notio_reindex(note_type?) MCP tool — regenerates index.md for one or all note type directories 2. Automatic on note_create — append to index.md when a new note is created (lighter, no full scan) 3. Both — auto-append on create, full reindex as a maintenance tool

The index should: - Parse frontmatter for configurable display columns (status, title, participants, etc.) - Support grouping (e.g. issues grouped by status) - Generate markdown tables compatible with mkdocs

Reference implementation¶

pixecog:code/utils/cli/toc-index.py — called as python -m utils.cli.toc-index <dir> <note_type> <yaml_keys> [groupby=<key>]

Context¶

From pixecog cleanup — this is one of three legacy utilities identified as general enough to absorb into projio.

Source context: pixecog¶

PixEcog (pixecog): Neuropixels and ECoG dataset and analysis

Recent commits:

2601c54 Cleanup: remove legacy tooling superseded by projio ecosystem (pixecog_mcp modules, RAG system, foam templates, workflow makefiles, context builder, dead CLI scripts)
1cdc964 Pre-cleanup checkpoint: update bib and docs subdatasets, indexio config v3
6429574 untrack

README:

type: readme

Quick Start for Collaborators¶

Follow this checklist to get started with Pixecog documentation and workflows.

🐀 Pixecog Project — Compact Overview¶

Core principles

One immutable BIDS raw dataset (raw/) as the canonical baseline
Each analysis pipeline ha