My notes used to pile up in whatever folder I happened to be in. This tool fixes
that. I drop a note into an inbox folder, and the tool works out where it belongs
and offers to file it. I tick one checkbox to say yes. Nothing moves until I do.
🌟 Key Highlights (Portfolio & Employment)
Concept: An automated filing system for a personal knowledge vault. A model
decides the destination; a human approves it. The approval gate is the point —
it keeps the owner in control of a destructive operation.
Tools & Skills Showcase: Python with no third-party libraries, a systemd
user service, a decision model called over plain HTTP, and careful handling of
file moves.
Practical Value: Removes the daily friction of note organisation. Every note
ends up in the right place and in the index, without manual sorting.
📐 Architecture & Flow
flowchart LR
A["Sam writes a note"] --> B["010 inbox/"]
B --> C{"Watcher<br/>systemd user service<br/>polls every 10s"}
C --> D["Tier 1 - rules<br/>folder + keyword hints<br/>user tags win"]
D -->|"confident"| F["Proposal"]
D -->|"unsure"| E["Tier 2 - TypeSafe JEV<br/>bucket + folder + tags"]
E --> F
F --> G["Proposal written<br/>into the note frontmatter"]
G --> H["Sam reviews in Obsidian"]
H -->|"ticks approved"| I["Writer"]
H -->|"edits folder first"| G
I --> J["Destination folder"]
I --> K["Table of Contents"]
click C "https://maps.lab.audasmedia.com.au/obsidian-sorter/docs/obsidian-sorter-map.html" "View Archify Map"
click E "https://docs.typesafe.ai" "TypeSafe JEV documentation"
