Skip to content

Project Manager Insights 0.2.3

Choose a tag to compare

@github-actions github-actions released this 20 Aug 06:59
· 3 commits to main since this release

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.2 or 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-test Vault 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.