# DesktopBeast™ EA RC v1.0 Fix Pass 001

## Package

- Package: `release\DesktopBeast-EA-Beta-Package-Candidate.zip`
- SHA256: `2792ED4A0A8A975C2E11A9D2DC60A72A083819E427B0763A597A126F05323585`
- Previous SHA256: `87E01AD993F30B6C5C2F88559E2049334F12BCFB692CE57D452715D5DA63CC65`

## What Changed

- Replaced the message-box-only single-instance behavior with a named mutex and named-pipe activation handoff.
- A second `DesktopBeast.exe` launch now signals the resident instance to show/activate the Main Screen, then exits.
- A `--library` launch now remains standalone when DesktopBeast™ is not running, but signals the resident instance to open ArchiveBeast™ Library when DesktopBeast™ is already running.
- Added capture-target decision diagnostics to Markdown exports:
  - foreground window handle/title/process at trigger time
  - selected capture window title/process
  - fallback-used flag
  - target-selection reason
- Hardened `Create Shortcuts.ps1` so shortcut targets/icons resolve from the package script folder and the script prints the exact target/icon paths it created.
- Reconfirmed Main Screen activation paths use `ShowMainWindowFromAnyContext()`.
- Cleaned repo-facing docs to remove unnecessary local personal paths and clarify historical internal source naming.

## Files Edited

- `DataBeastDesktop.Spike001\App.xaml.cs`
- `DataBeastDesktop.Spike001\MainWindow.xaml.cs`
- `DataBeastDesktop.Spike001\Models.cs`
- `DataBeastDesktop.Spike001\Services\CaptureCoordinator.cs`
- `DataBeastDesktop.Spike001\Services\CaptureTargetSelector.cs`
- `DataBeastDesktop.Spike001\Services\MarkdownExportService.cs`
- `package-work\DesktopBeast-EA-Beta\Create Shortcuts.ps1`
- `DesktopBeast-EA-Beta-Repo\src\App.xaml.cs`
- `DesktopBeast-EA-Beta-Repo\src\MainWindow.xaml.cs`
- `DesktopBeast-EA-Beta-Repo\src\Models.cs`
- `DesktopBeast-EA-Beta-Repo\src\Services\CaptureCoordinator.cs`
- `DesktopBeast-EA-Beta-Repo\src\Services\CaptureTargetSelector.cs`
- `DesktopBeast-EA-Beta-Repo\src\Services\MarkdownExportService.cs`
- `DesktopBeast-EA-Beta-Repo\BUILD.md`
- `DesktopBeast-EA-Beta-Repo\REPOSITORY_NOTES.md`
- `DesktopBeast-EA-Beta-Repo\docs\ARCHIVEBEAST_ADAPTIVE_CAPTURE_LAYOUT_GREEN.md`
- `DesktopBeast-EA-Beta-Repo\docs\DESKTOPBEAST_EA_BETA_POLISH_AND_PACKAGE_READINESS_GREEN.md`
- `DesktopBeast-EA-Beta-Repo\docs\DESKTOPBEAST_ICON_POLISH_GREEN.md`

## Single-Instance Verdict

Hardened and smoke-tested.

- First launch from rebuilt publish folder created one DesktopBeast™ process.
- Second launch from the same folder signaled the existing process and exited.
- Process count remained one.
- ArchiveBeast™ Library still launches standalone when DesktopBeast™ is not running.
- `DesktopBeast.exe --library` while DesktopBeast™ is running did not create a duplicate listener process.

## Capture-Target Diagnostics Verdict

Hardened.

- Smoke capture created PNG and Markdown.
- Markdown now includes trigger foreground diagnostics and selected capture diagnostics.
- The smoke artifact showed:
  - trigger foreground app/title/handle
  - selected capture app/title
  - fallback flag
  - selection reason
  - Evidence Envelope still present
  - metadata/OCR privacy signals still separated

Manual Notepad/File Explorer/Chrome targeting still needs a human validation pass because the prior Notepad issue may have involved test-environment focus ambiguity.

## Shortcut Path Verdict

Hardened and smoke-tested from the rebuilt package folder.

- `Create Shortcuts.ps1` now resolves `$PSScriptRoot` to the package folder.
- The script fails clearly if `DesktopBeast.exe` or `Assets\DesktopBeast.ico` is missing.
- The script printed real package target/icon paths in this pass.
- Created shortcut inspection showed both `.lnk` files targeting the package-local `DesktopBeast.exe` with the DTB `.ico`.
- Generated `.lnk` files were removed before ZIP packaging.

## Z-Order / Focus Readiness Verdict

Ready for live retest.

- Capture Screen, tray Open DesktopBeast™, tray double-click, and second-launch handoff route through the Main Screen activation helper.
- The helper restores/shows/maximizes the Main Screen, briefly toggles topmost, then calls `Activate()` and `Focus()`.
- No new owner relationship was added between Capture Screen and Main Screen.

Manual taskbar-preview validation is still recommended before calling the RC fully Green.

## Repo / Doc Cleanup Verdict

Cleaned.

- Source fixes were mirrored into `DesktopBeast-EA-Beta-Repo\src`.
- Repo docs were cleaned of unnecessary local personal paths.
- Repo notes now distinguish public DesktopBeast™ naming from historical internal `DataBeastDesktop.Spike001` source identifiers.
- Repo scan found no ZIPs, build outputs, smoke captures, appdata folders, caches, local personal paths, or blocked public-release language.

## Build / Package Verification

- Debug build succeeded.
- Release publish succeeded.
- Expected warning remained: NuGet vulnerability metadata could not be fetched because network access is restricted.
- PDB was excluded from the package ZIP.
- Package inspection found expected app files, docs, icon asset, `tessdata`, and native OCR DLLs.
- Package inspection found no PDB, ZIP, log, temp, user, shortcut, or cache files.

## Remaining Risks

- Manual Notepad, File Explorer, Chrome, and GitHub Desktop hotkey targeting still need a real Windows validation pass.
- Manual z-order/taskbar-preview behavior should be checked with Capture Screen and Main Screen visible.
- Windows icon cache may still show stale icons until old pins/cache are refreshed.

## Recommended Next Validation Steps

1. Unzip the new package into a fresh normal Windows folder.
2. Launch DesktopBeast™, then launch `DesktopBeast.exe` again and confirm only one resident instance remains.
3. Run Notepad, File Explorer, Chrome, and GitHub Desktop hotkey captures.
4. Inspect the new Markdown target-selection diagnostics for each capture.
5. Open Main Screen from Capture Screen and tray to confirm z-order behavior.
6. Run `Create Shortcuts.ps1` from normal Windows PowerShell and confirm shortcut targets/icons.

## Scope Confirmation

- No new features were added.
- No product rename was performed.
- No public deployment occurred.
- No Cloudflare DNS changes occurred.
- No purchase/download links were added.
- No BrowserBeast™ Pro work occurred.
- No PersonaVault work occurred.
- No unrelated Beast projects were edited.

