kbe
3e294dc846
Introduces ApplicationFinder (by name/title/handle), Magic.Open overloads, and Magic.Threads/Regions/QueryRegion accessors. Closes section 3 of add-thread-region-finder and updates tasks/comparison doc.
26 lines
1.1 KiB
Markdown
26 lines
1.1 KiB
Markdown
## ADDED Requirements
|
|
|
|
### Requirement: Process discovery
|
|
|
|
WhiteMagic SHALL attach to a target process discovered by process name, window title, or window handle, and SHALL enumerate candidate processes. An ambiguous match MUST fail deterministically rather than attaching to an arbitrary candidate.
|
|
|
|
#### Scenario: open by process name
|
|
- **WHEN** a target is opened by a unique process name
|
|
- **THEN** it MUST attach to that process
|
|
|
|
#### Scenario: open by window title
|
|
- **WHEN** a target is opened by a window title
|
|
- **THEN** it MUST attach to the process owning the window with that title
|
|
|
|
#### Scenario: open by window handle
|
|
- **WHEN** a target is opened by a window handle
|
|
- **THEN** it MUST attach to the process that owns that window
|
|
|
|
#### Scenario: ambiguous match is rejected
|
|
- **WHEN** more than one process matches the given name or title
|
|
- **THEN** the open MUST fail and surface the set of candidate processes rather than picking one
|
|
|
|
#### Scenario: enumerate candidates
|
|
- **WHEN** candidate processes are enumerated
|
|
- **THEN** the result MUST list the processes eligible to be opened
|