ambrosiana-document-intake/TODO.md
John A. Hoeven bddbd552d2
Add Textual intake TUI, reach Beta (v0.1.0)
Implements the human-facing front door to the Ambrosiana RAG pipeline:
a Textual TUI that collects document-intake metadata (source location,
type, tier, licence, priority, optional title/notes) and writes a
structured markdown ticket for Claude Code to act on. The app never
touches the pipeline, any agent, or any model.

- Tickets write flat into a configured tickets_root (no immediate/
  queue subdirectories); priority is encoded in the filename instead
  (immediate_ prefix vs. no prefix for normal queue/order-of-arrival).
- tickets_root is read from ~/.config/ambrosiana-intake/config.toml,
  auto-created with a sensible default on first run rather than
  hardcoded.
- Save clears the form and fires a toast notification, fixing a bug
  where the confirmation message rendered below the visible viewport
  on any normal terminal size, giving no visible sign a save succeeded.
- Verified clean against flake8 and pylint per the CE OS script
  styleguide.
- Adds TODO.md tracking open items, including a cross-project link
  with the RIS design spec on multi-page document-set handling.

Created by John A. Hoeven with the ethical assistance of Claude AI.
2026-08-02 14:03:35 +02:00

29 lines
1.6 KiB
Markdown

# TODO
- [ ] Move installation and usage instructions out of README.md into a project wiki.
- [ ] Move config from `~/.config/ambrosiana-intake/` (XDG) to a
`~/.local/etc/` subdirectory once that convention is settled.
Only `CONFIG_DIR` in `ambrosiana_intake.py` needs to change.
- [ ] Decide the ticket → corpus-doc field mapping — specifically when/how
`doc-state` gets set once a ticket is actually processed into a
RIS-registered doc-set (a ticket has no `doc-state` at intake time
either way; this was flagged during the RIS spec resync with
Claude Desktop and never formally resolved).
- [ ] Clean up leftover test tickets in the old, now-abandoned
`~/ambrosiana/intake-tickets/` location (pre-dates the config-driven
`tickets_root`).
- [ ] Optional: add docstrings to close pylint's remaining missing-docstring
notes (not required by the CE OS styleguide, low priority).
- [ ] Design how Ambrosiana/RIS handles multi-page document sets (source
URL is an index or first page of a larger set, not a single doc) —
needs a decision at the spec level (how the pipeline should crawl/
section a doc set) before the intake form adds a dedicated field.
Using the Notes field as a manual workaround in the meantime
(first surfaced with the PEP8 styleguide intake). **Parallel
development item** with the RIS project — matching entry logged in
`~/projects/rosetta-indexing-system/OPEN-ITEMS.md` under "Adjacent,
not-yet-formalized systems". Keep both in sync as this gets designed.
---
*Created by John A. Hoeven with the ethical assistance of Claude AI*