ceos/ambrosiana-document-intake
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
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

1.6 KiB
Raw Permalink Blame History

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