Repository navigation
mac_v0.1.2
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_processbinding. Calls such asdb.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_routeentries. 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 syntheticmoduleStartupowner. 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
activateanddeactivatereceive 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.