tag-cleanup

Run tag co-occurrence analysis to group similarly named tags, then review the proposed canonical tag for each group. Approved duplicates are merged via canonical aliasing or full rename, keeping the highest-usage or most conventional name as the primary tag.

Tag co-occurrence analysis measures how often tags appear together using PMI scores and clustering. It reveals duplicate tags, natural groupings, orphan tags with low usage, and relationships strong enough to suggest consolidation or new grouping tags.

Yes, archiving retires a tag without physical deletion by setting archived=True with a reason, and it can be reversed anytime. A tag that is the canonical target of other tags cannot be archived until those aliases are removed first.

Use notes demotion to move approved sections, identified by their markdown headings, into standalone materials. Status or journal sections can be dropped entirely, while other sections are replaced with pointers, until the notes fall under the 4,000-character ceiling.

No, the analysis only produces a proposal organized into duplicates, clusters, orphans, co-occurrence data, and over-budget notes. Every consolidation, rename, archival, or demotion action executes only after explicit user approval, and results are saved as a tagged material record.