Skip to content

0.4.0: safe on a user profile (Claude Desktop test gaps) - #12

Merged
m4bwav merged 3 commits into
masterfrom
fix/2026-10-13-desktop-test-gaps
Oct 14, 2026
Merged

m4bwav merged 3 commits into
masterfrom
fix/2026-10-13-desktop-test-gaps

Conversation

@m4bwav

@m4bwav m4bwav commented Oct 14, 2026

Copy link
Copy Markdown
Owner

Fixes what the Claude Desktop marketplace test of 2026-10-13 ran into. In that test the listed plugin ran from a cloud chat linked to this PC and was asked to index the whole user profile.

Merging deploys: the directory listing has auto-publish on and picks master up on its scheduled check, so merging ships 0.4.0.

Changes

  • Unreadable files no longer stop the lint. A PermissionError used to end the run; now the file is skipped and reported under a new warning, unreadable files N, in the text report and --json (--max applies). Folders the walk cannot list are reported the same way. On Windows, hidden+system folders are skipped like dot folders. Those are the legacy junctions such as My Documents and Cookies, which deny listing by design.
  • AppData is skipped by default. So are Application Data and Local Settings, at any depth. --include-appdata opts in.
  • Home-folder guard. On a root that holds NTUSER.DAT, equals USERPROFILE or HOME, or has more than 1,000 markdown files, --fix-index and --to-markdown-links write nothing unless --yes is given. They print how many files they would touch and exit 3. The lint itself still runs.
  • --root-index [--group PATH ...] writes only <root>/INDEX.md and never overwrites one. It has frontmatter and links each top folder (or each child of a group) to its index by H1 title, with a purpose clause and a file count. A folder whose only content is one subfolder links to that subfolder's index. Folders without an index are listed unlinked, with counts.
  • UTF-8 output. stdout and stderr are reconfigured to UTF-8 on every console.
  • SKILL.md. On a home folder, Step 1 now stops and asks which subfolder to use before writing anything. A new paragraph covers remote or cloud sessions: copy the script to a scratch folder on the device, check its sha256, and run large trees in the background with output polled from a file.
  • LEARNINGS L-005 to L-010, CHANGELOG C-20261013-1, TESTS T-20261013-1. Version 0.4.0 in both plugin.json files.

Verification

  • test_vault_lint.py gains cases 13a to 13e. They pass on Windows with Python 3.9 and 3.14, and against 0.3.0 they fail. The unreadable-file case really runs on Windows: it denies read access with icacls (chmod 0 on other systems).
  • tests/test_repo.py passes, and the repo passes its own lint.
  • vault_lint.py D:\m4bwa with default settings and no fix flag finishes without a traceback: 6,454 files, 327 errors, 4 unreadable (locked scheduled-task files), 8 s warm.
  • Eval action-1 passes on the evidence (check_vault.py --task index exits 0).

- Unreadable files and folders are skipped and reported as a warning
  instead of ending the lint with a PermissionError.
- AppData, Application Data and Local Settings are skipped by default
  (--include-appdata opts in); Windows hidden+system folders (legacy
  profile junctions) are skipped like dot folders.
- --fix-index and --to-markdown-links refuse on a user profile or a tree
  of more than 1,000 markdown files unless --yes, saying what they would
  touch (exit 3); the lint still runs.
- --root-index [--group PATH ...] writes only <root>/INDEX.md and never
  overwrites one.
- stdout and stderr are UTF-8 on every console.
- SKILL.md: stop and ask on a home folder; steps for remote or cloud
  sessions (copy to a device scratch folder, check sha256, poll long runs).
- Tests 13a-13e, LEARNINGS L-005 to L-010, CHANGELOG C-20261013-1.
@m4bwav m4bwav self-assigned this Oct 14, 2026
@m4bwav

m4bwav commented Oct 14, 2026

Copy link
Copy Markdown
Owner Author

CI caught one more case on windows-latest with Python 3.9.13: Path.resolve() raised PermissionError on the unreadable file before the read guard ran. Path resolution now falls back to os.path.abspath (commit on this branch, noted in C-20261013-1). All six jobs pass.

@m4bwav
m4bwav merged commit cd392c2 into master Oct 14, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant