Skip to content

mac_v0.1.2

Choose a tag to compare

@skuttlebot skuttlebot released this 16 Sep 01:55
· 5 commits to main since this release
9b976de

Pathfinder v0.1.2

Release notes for the improvements completed after v0.1.1.

Summary

v0.1.2 improves Pathfinder as a cross-platform project browser and an architectural investigation tool. It strengthens static, source-evidenced detection, documents how that detection works, and makes graph exploration more predictable.

Cross-platform project browsing

Project-folder selection and reveal actions are now supported across the desktop platforms Pathfinder targets.

Platform Browse for a project folder Reveal a folder or file
Windows Native WinForms picker through PowerShell in STA mode Explorer, including file selection where supported
macOS Finder picker through osascript open, or open -R to reveal a file in Finder
Linux zenity, then kdialog fallback xdg-open; files open their containing folder because there is no portable cross-desktop reveal-and-select command

Cancellation is treated as a normal cancellation rather than an application error. Linux displays a clear fallback message when neither picker is installed, so the project path can still be entered manually.

Scanner methodology and evidence model

The new maintainer-facing detection methodology documents scan order, language-specific extraction, project-wide resolution, known limits, and reconciliation. The shorter scanner detection guide links to it.

Every scan creates a snapshot, extracts evidence across the target, resolves relationships at project scope, and reconciles confirmed facts with the project database. The database is a history of scan results; Pathfinder does not rely on a separate connector-only expansion pass.

JavaScript and TypeScript

  • Babel-backed symbol extraction records top-level declarations and bounded same-file and project-import calls.
  • Synthetic execution roots represent source-visible ownership for module startup calls, browser event callbacks, embedded browser script startup, and literal Commander command handlers.
  • Browser event roots require DOM evidence so Node event emitters are not mislabeled as browser behavior.
  • Subprocess detection requires a proven child_process binding. Calls such as db.exec('ALTER TABLE ...') no longer become false subprocess nodes.
  • Interpolated URL strings are not emitted as literal external URL services.
  • Generic local-service correlation joins a binding-proven subprocess port to a local HTTP client using resolved literals, same-file constants, or a shared environment-variable token. It is marked as static evidence, not process-liveness proof.
  • A shared endpoint configuration key now connects a process manager and an adapter/provider even when the user-selected address is unavailable at scan time.
  • Config-derived JavaScript endpoint accessors used by HTTP templates are folded into their configured-service evidence instead of creating duplicate dynamic-service placeholders.

Python

  • Tree-sitter-backed symbol extraction records functions, classes, methods, source spans, and conservative call edges.
  • Supported literal FastAPI and Flask-style route decorators mark handlers as http_route entries. This is framework-invocation evidence, not an invented source call.
  • Direct calls to a local function at module scope, including conventional if __name__ == '__main__' blocks, receive a synthetic moduleStartup owner. Imported and dynamic calls remain unresolved.
  • Symbol-detail diagnostics distinguish no symbols recorded from an asserted parse failure.
  • Python subprocess and HTTP evidence participates in the same generic local-service correlation.

AI briefing improvements

  • Connected Electron IPC entries render their actual channel arrays rather than an undefined singular-channel field.
  • Symbolic evidence explains synthetic roots as scanner-created ownership markers rather than named source functions or runtime proof.
  • HTTP route entries are identified in the symbolic evidence index.
  • Host lifecycle exports such as activate and deactivate receive a caveat so reviewing agents do not mistake host-invoked code for safe-to-delete code.
  • Local-service correlations state the resolved endpoint and launch location, with an explicit static-evidence caveat.
  • Configured-service contracts identify the shared key and distinguish symbolic configuration evidence from a concrete reachable URL.

Graph interaction and presentation

Declutter and deep dive

Deep-dive symbols inherit the visibility state of their parent file. Hiding a test, missing, or planned-for-removal module through Declutter also hides its symbol cell and associated visible edges.

Focus and deep dive work in either order

Entering Deep Dive while Focus is active adds the expanded module to the focus lens. A focused module projects its focus to its expanded symbols, keeping the opened cell legible rather than dimming it as unrelated context.

More deliberate scroll-driven deep dive

Mouse-wheel Deep Dive begins only after zooming past 6x, rather than 2.2x. It preserves the pointer-centered camera position and does not recenter the view. Explicit Deep Dive toggles retain the centering animation.

Group movement

Dragging a node in a multi-selection now moves and persists the full group. When a parent module and an expanded symbol are selected together, the symbol moves only with its parent, preventing doubled movement or an unintended local symbol-layout change.

Verification

  • JavaScript graph client syntax check passes.
  • Full test suite passes: 50 tests.
  • Regression coverage covers Python framework and startup entries, constrained subprocess detection, literal versus dynamic URL handling, and graph query evidence.

Upgrade notes

No project source changes are required. Rescan a project after upgrading to populate new route entries and synthetic ownership evidence. Restart the Pathfinder process before rescanning if it was already running so the updated scanner and report modules are loaded.

The rescan also removes the retired, application-specific runtime-capability
rows from early v0.1.2 builds, so they do not remain as misleading missing
elements in the graph.