Skip to content

0.3.0: faster lint, purpose clauses, capped --json, research pass - #8

Merged
m4bwav merged 2 commits into
masterfrom
improve/2026-10-06-speed-index-clauses
Oct 7, 2026
Merged

m4bwav merged 2 commits into
masterfrom
improve/2026-10-06-speed-index-clauses

Conversation

@m4bwav

@m4bwav m4bwav commented Oct 7, 2026

Copy link
Copy Markdown
Owner

Obvious wins, token and time savings, an evergreen research pass with an Obsidian forum sweep, and tests. Reasons are in skills/obsidian-notes/CHANGELOG.md (C-20261006-1).

Speed: one tree walk instead of two, plus folder listings and Path.resolve() cached per scan. On a 3,124-file tree it went from 5.2 s to 2.7 s (warm) with identical findings.

Tokens: SKILL.md told agents to use --json on large folders, which produced 586 KB on that tree. Now --json honours --max (6.6 KB at --max 10) and the skill points agents to the capped text report.

Index quality: --fix-index now writes [title](file): purpose lines, as the skill's own Step 3 asks (open since C-20260918-6).

Bugs:

  • A file that links only to itself is now reported as an orphan.
  • SECURITY.md was an orphan in the repo's own lint; README now links it.

Research (m 0.4):

  • Obsidian 1.14 is public.
  • Relative links inside a moved note break in Obsidian (forum thread 4386); there is a new self-test case for it.
  • New CLI unresolved/orphans/deadends commands.
  • claude plugin eval exists, noted for later.

Tests:

  • Self-test cases 12a to 12d.
  • New tests/test_repo.py guards what the plugin directory's auto-publish depends on (manifests agree, description cap, directory URLs, icon). It runs in CI and in the release job.
  • Eval action-1 passes (T-20261006-1).

Version 0.3.0 in both plugin.json files.

m4bwav added 2 commits October 6, 2026 20:37
…search with a forum sweep

- vault_lint.py: one tree walk, folder listings and resolved paths cached per scan (5.2 s to 2.7 s on 3,124 files, same findings); self-links no longer rescue an orphan; --fix-index lines carry a purpose clause (frontmatter description, else the first non-navigation sentence); --json honours --max and records cut lists under "truncated"
- SKILL.md Step 2: prefer the capped text report to --json (586 KB on a big tree); lint again after moving notes in Obsidian (forum 4386); 1.14 outside-file wording
- references/setup.md: move warning, 1.14 public, CLI unresolved/orphans/deadends, Local REST API 5.4.0
- tests: self-test cases 12a-12d; new tests/test_repo.py (manifests agree, directory fields, description cap, body budget, stdlib only) in CI and the release job
- README links SECURITY.md (it was an orphan); RESEARCH R-20261006-1..3; TESTS T-20261006-1; CHANGELOG C-20261006-1
@m4bwav
m4bwav merged commit ab8e53f into master Oct 7, 2026
6 checks passed
@m4bwav
m4bwav deleted the improve/2026-10-06-speed-index-clauses branch October 7, 2026 01:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant