Project Manager Insights 0.2.3
Project Manager Insights 0.2.3
Project Manager Insights 0.2.3 replaces repeated Vault-wide discovery with a managed-folder catalog that keeps Project Manager data indexed and updates it incrementally.
Highlights
Incremental Project Manager catalog
- Discover projects and tasks only inside the folder configured by Project Manager instead of enumerating every Markdown file in the Vault.
- Cache the normalized Project Manager snapshot so repeated dashboard reads do not repeat file discovery or metadata lookups.
- Update the catalog incrementally when a managed project or task is created, changed, renamed, or deleted.
- Ignore unrelated note changes so they no longer trigger Project Manager rescans or dashboard refreshes.
- Preserve explicit refresh behavior by reconciling the catalog with the configured Project Manager folder.
Reliability and compatibility
- Replay relevant file events that arrive while the initial catalog is being built, preventing initialization races from leaving stale data behind.
- Keep the last valid snapshot available if a later reconciliation cannot complete.
- Preserve existing project, task, priority, completion-status, filtering, sorting, and workload calculations.
- Continue reading Project Manager's public note metadata and configured projects folder without depending on its private runtime state.
Measured impact
Measurements below use the release verification Vault, which contains 416 Markdown files and 262 Project Manager records (5 projects and 257 tasks). Results vary with Vault size and structure.
- Cold candidate metadata lookups decreased from 416 to 262, a 37% reduction.
- Cached dashboard reads decreased from 416 metadata lookups to zero.
- Processing one changed Project Manager note decreased from a 416-file scan to one record update, a 99.8% reduction in candidate work.
- A metadata change to an unrelated note caused zero Project Manager catalog refreshes.
- Thirty consecutive cached reads completed with zero full-Vault enumerations and zero metadata lookups.
Compatibility and upgrade notes
- Obsidian
1.7.2or later remains supported. - Project Manager remains required.
- No settings or note migration is required.
- Project Manager's configured projects folder remains the source of project and task discovery; the default is
Projects. - The plugin ID remains
project-manager-insights. - Project Manager Insights remains read-only and does not modify project or task notes.
Verification
- TypeScript type checking passes.
- Official Obsidian ESLint rules pass with zero warnings.
- Official-review regression checks pass, including a guard against full-Vault file enumeration in the production source adapter.
- All 15 automated tests pass, including catalog caching, incremental updates, initialization-event replay, settings reconciliation, and managed-folder source behavior.
- The production bundle builds successfully.
- Desktop verification in the
dev-testVault confirms output parity with 5 projects, 257 tasks, and 4 priorities, with no runtime or console errors.
This release contains no breaking changes to Project Manager data or existing Project Manager Insights settings.