diff options
| author | blasty <blasty@local> | 2026-07-25 11:51:38 +0200 |
|---|---|---|
| committer | blasty <blasty@local> | 2026-07-25 11:51:38 +0200 |
| commit | f4cb6eba274c411c503cbc8b4ed10fdfc6b70dcb (patch) | |
| tree | c9bd1e37b16725099e4d0351f91211443a5e2bf1 /docs/PROJECTS.md | |
| parent | projects: worker pool with memory-budgeted residency (phase 1b) (diff) | |
| download | ida-tui-f4cb6eba274c411c503cbc8b4ed10fdfc6b70dcb.tar.gz ida-tui-f4cb6eba274c411c503cbc8b4ed10fdfc6b70dcb.tar.xz ida-tui-f4cb6eba274c411c503cbc8b4ed10fdfc6b70dcb.zip | |
projects: switch between a project's binaries in the TUI (phase 1c)
Wires the project model + worker pool into the app. Project mode is ADDITIVE —
without --project the app is exactly the single-binary tool it was, which is what
keeps the 167-check pilot meaningful.
* IdaTui(project=...) builds a WorkerPool and opens the project's first binary;
_open_worker_client asks the pool instead of spawning directly.
* BinaryState snapshots what a switch leaves behind (program, func_index, nav,
cur, view prefs, filter). Switching reuses the _after_reconnect shape: swap
client+program, rebuild the index, reopen the entry. A still-resident binary
restores instantly (Program + index are in memory); an evicted one gets a fresh
worker but keeps its nav history, which is just addresses.
* ProjectPalette (Ctrl+O, + a "Switch binary…" palette command): the project's
binaries with resident/analysed/pinned/active state and memory, filterable.
* launch.py --project FILE, creating the project when binaries are also given;
stages everything up front so the source tree is never written to.
Two bugs found while testing:
* _did_auto_land is app-wide, but landing is per-binary: after the first binary
landed, a cold switch never landed at all AND left the switch overlay up
forever. Reset it per switch.
* PRE-EXISTING: the status Static had Textual markup enabled, so a single-word
bracket marker parses as a style tag and is silently eaten — [listing] and
[pseudocode] have never actually rendered (only [split · listing] survived,
because the · makes it an invalid tag). Status is plain text with brackets and
symbol names, so markup=False.
tests/test_project_ui.py: end-to-end pilot on two real binaries (18 checks) —
boot, switcher contents, switch, per-binary index, both workers resident,
switch back with state intact, return-to-where-you-were, and the promise that
the source tree stays pristine while every artifact lands in the sidecar.
Full single-binary suite unchanged at 167/2 (the standing flakes).
Diffstat (limited to 'docs/PROJECTS.md')
| -rw-r--r-- | docs/PROJECTS.md | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/docs/PROJECTS.md b/docs/PROJECTS.md index d1e2806..1f39c05 100644 --- a/docs/PROJECTS.md +++ b/docs/PROJECTS.md @@ -108,10 +108,19 @@ basename and must be unique (it names the staged file). ## Phases -**Phase 1 — project model + switching.** Project file, staging dir, -`WorkerPool` (lazy spawn, budget eviction, save-on-evict, clean shutdown), -`BinaryState` save/restore, switcher palette, active binary in the status bar, -`--project` CLI. One active binary; no cross-binary search yet. +**Phase 1 — project model + switching. DONE.** Project file + staging +(`idatui/project.py`), `WorkerPool` with budget eviction / save-on-evict / +clean shutdown (`idatui/pool.py`), `BinaryState` snapshot+restore and the switch +itself, the `Ctrl+O` switcher palette, the active binary in the status line, and +`--project` (which creates the project when given binaries). One active binary; +no cross-binary search yet. + +Project mode is **additive**: with no `--project` the app is byte-for-byte the +single-binary tool it was, which is what keeps the 167-check pilot honest. +Switching reuses the `_after_reconnect` shape — swap client+program, rebuild the +index, reopen the entry. A binary whose worker is still resident restores +instantly (its `Program` and index are still in memory); an evicted one comes +back with a fresh worker but keeps its nav history, since that is just addresses. **Phase 2 — index cache + project-wide search.** Per-binary index (functions, strings) persisted after first open, keyed by source size+mtime. Scope toggle in |
