6 Commits

Author SHA1 Message Date
63ed336dfa docs(outline): add AI agent context set (Outline layer)
Add docs/outline/00-index.md plus system overview, config/env, code map,
and agent runbook in Simplified Technical English. Link the set from the
README. Completes the project-docs Outline layer.
2026-10-13 12:37:28 +11:00
eaa7761437 docs: align README with project-docs Gitea template
Add Demonstrated Skills & Tech Stack and System Architecture (Mermaid +
Archify map link) sections. Rename Install to Quick Start and group manual
commands under Usage & Configuration.
2026-10-13 12:27:14 +11:00
sam
4f92d3782b fix(watch): drop proposed_folder_auto; a recorded folder is never re-decided
The extra bookkeeping field showed up in Obsidian's Properties panel as a
second 'proposed folder' row, which was confusing.

Simpler rule replaces it: once proposed_folder is set it is never changed.
The owner edits it if they disagree; deleting the field asks for a fresh
suggestion.
2026-09-26 08:19:00 +10:00
sam
92ea55f77d fix(watch): the owner's folder choice must never be overwritten
Two bugs found while filing the Obsidian Sorter note itself:

1. proposed_toc went stale when proposed_folder was edited by hand.
   The watcher now re-resolves the index line from the folder on every pass.

2. Re-proposing after a body edit clobbered a hand-edited proposed_folder.
   The watcher's own suggestion is now kept separately in
   proposed_folder_auto, so a difference marks a human choice, which wins.

Adds two guard tests. 17/17 passing.
2026-09-26 06:57:41 +10:00
sam
2c7c8257d1 docs: mermaid flow + archify architecture map, published to maps site
- docs/obsidian-sorter-flow.mmd + rendered PNG
- docs/archify/*.architecture.json (validation: 0 errors, 0 warnings)
- docs/obsidian-sorter-map.html (interactive, showcase quality)
- published to https://maps.lab.audasmedia.com.au/obsidian-sorter/docs/
2026-09-26 06:56:20 +10:00
sam
33ec9b5bc5 obsidian-sorter: automated note filing for an Obsidian vault
Classifies notes from an inbox folder and files them, with a human
approval step. Zero third-party dependencies.

- type mirrors folder (200 projects / 300 areas / 400 Personal Family)
- TypeSafe JEV for semantic classification (~$0.0001 per note)
- watcher writes a proposal INTO the note; the owner ticks a checkbox
- systemd user service on .27, 10s poll
- 15/15 functional tests
2026-09-26 06:53:24 +10:00