OAS v0.18.6

OAS v0.18.6

One public release, built from one tag: @oas-framework/oas@0.18.6,
@oas-framework/pi@0.18.6, and OAS Desktop 0.18.6 (attached to this
GitHub Release).

This release adds explicit spawn-time agent relations, cluster-first Desktop
navigation, and user-editable Desktop keyboard shortcuts. Desktop CLI API v1
remains the compatibility boundary (>=0.18.0 <0.19.0), but related spawns
require the new 0.18.6 CLI.

New: explicit agent relations

A new instance can declare what it is to an existing instance:

oas spawn <agent> --relation child|sibling|parent --relative-to <instance>

• child works for and nests under the anchor;
• sibling joins the anchor as a peer;
• parent oversees the anchor and takes its previous lineage position;
• no relation flags means unrelated and top-level.

--parent <instance> remains supported as child-relation shorthand.
Same-named instances can exist in different agent roots, so
--relative-root <agents-root> can qualify an anchor. Ambiguous or shadowed
lineage fails closed with E_RELATIVE_AMBIGUOUS rather than linking or acting
on the wrong instance. Attached agents remain children of the verified owner
of their shared work tree.

Retiring an instance repairs ordinary parent and sibling links that point to
it. OAS intentionally keeps this as sparse current-state metadata rather than
a lineage database: concurrent parent spawns against one anchor are
last-writer-wins, and a multi-instance retirement repair is sequential rather
than a crash-atomic transaction.

Desktop: cluster-first agent surfaces

The Active overview and permanent instance sidebar now group related agents as
clusters built from parent and sibling links. Independent instances remain in
a quieter separate strip. Duplicate instance names across repositories remain
distinct throughout grouping, filtering, collapse state, terminal routing,
Brain actions, and privileged instance-addressed API calls.

The Spawn surface now uses one accessible modal with purpose, task, relation,
anchor, runtime, and model controls. Relation controls stay visible but fail
closed when the installed CLI predates 0.18.6; unrelated spawning remains
available across the existing Desktop API v1 compatibility range.

Desktop: editable keyboard shortcuts

Desktop actions now use a central keybinding engine with persisted user
overrides and explicit unbinding. Open the shortcuts editor with Mod+,.
The editor covers app, stage, tab, sidebar, terminal typography, and
view-local actions, with live shortcut labels and conflict warnings.

Terminal shortcut interception happens before PTY writes for an explicit
action allowlist. View-local shortcuts remain confined to their focused
surface, and spawn-modal controls keep ownership of their keys.

Downloads

Platform	Artifacts
macOS arm64 (Apple Silicon)	DMG + ZIP
macOS x64 (Intel)	DMG + ZIP
Linux x64	AppImage + DEB

The macOS artifacts are ad-hoc signed — not Developer ID signed and not
notarized. First launch may still require right-click → Open (or Open
Anyway in System Settings → Privacy & Security).

Verify downloads with SHA256SUMS.txt; GitHub build-provenance attestations
are published for all assets.

Windows and Linux arm64 are not supported in 0.18.x.

Install / update

npm install -g @oas-framework/oas@0.18.6

The pi bridge @oas-framework/pi publishes in lockstep. Desktop downloads are
the assets on this release; the full install/support guide is
docs/desktop.md.