Feature | Running as administrator disables other instances

[AnnaSasDev]

Impact

Low

Problem / Motivation

No explicit elevation-aware instance arbitration feature in builder/runtime.

Current behavior

Relevant primitives exist in the files listed above, but this backlog item does not have a complete, explicit InfiniFrame contract with dedicated coverage.

Expected behavior

Add builder-level single-instance options (Disabled, PrimaryOnly, PrimaryWithArgForwarding) and handle elevation mismatch explicitly.

Proposed solution

Implement this incrementally:

1. Define/adjust the managed public API in InfiniFrame.Shared.
2. Wire implementation in InfiniFrame and InfiniFrame.Native where required.
3. Add focused tests (tests/InfiniFrameTests*) and docs updates (docs/docs/guides/*, docs/docs/migration/*).

Alternatives considered

• Keep as unsupported and document migration limitation.
• Provide a workaround-only approach without first-class API.

Use case

Applications migrating from Photino expect this behavior and currently need custom handling for "Running as administrator disables other instances".

Technical proposal

Scope implementation to: core managed runtime (src/InfiniFrame/*, src/InfiniFrame.Shared/*, src/InfiniFrame.Js/*). Keep behavior deterministic across Windows/Linux/macOS and document platform-specific limitations explicitly.

Additional context

Photino reference: tryphotino/photino.NET#162

Checklist

• I searched existing issues
• This is not a support question