Documentation changelog

Audience: Operator

All notable changes to this documentation tree (docs/) are listed here. Application code lives in sibling folders and has its own history per repository.

[Unreleased]

Added

• HOSTED_APP_CONTRACT.md: Composition host and sibling iframes — normative proxy pattern for cross-app queries (edac.places.query / edos.places.query); forbids hidden-iframe access to another app’s origin-local storage. Cross-links from IPC.md, ARCHITECTURE.md.

• APP_DISCOVERY_REGISTRY.md: federated link-only discovery indexes (source list + per-source index JSON); resolution order for composition hosts; EDAC as reference consumer. Cross-links from HOSTED_APP_CONTRACT.md, README.md, AGENT_INDEX.md, DOC_CONVENTIONS.md, HANDOFF_FOR_EXTERNAL_AGENTS.md, docs-deploy/mkdocs.yml.

• HOSTNAMES.md: canonical *.howfe.org / *.edos.howfe.org registry, naming rules for new apps, scaffold slug hints; cross-links from README.md, AGENT_INDEX.md, AGENTS.md, REPOS.md, ARCHITECTURE.md, DEPLOYMENT.md, START_HERE.md, docs-deploy/mkdocs.yml.

• HOSTED_APP_CONTRACT.md: In-app navigation views — path-first shell routes in manifest navigation, optional edos.view query alias, optional runtime edos.navigation.set / edos.navigation.changed; explicit distinction from table saved views in TABLE_GUIDANCE.md.

• apps/elite-dangerous-credit-account.md, apps/elite-dangerous-universe-places.md; REPOS.md, SCOPE.md, README.md, ARCHITECTURE.md, AGENTS.md, IPC.md, docs-deploy/mkdocs.yml — Credit Account (edca) and git-only universe-places inventory.

Changed

• Full doc refresh (/edos-doc-full-refresh): REPOS.md quick reference — elite-dangerous-interstellar-scan, elite-dangerous-app-composition (edac), elite-dangerous-universe-places; npm dependency rows; expedition-planner journal/api-cache/manifest; git-only placeholder table trimmed. HOSTNAMES.md — allocated edac. Capsules: apps/elite-dangerous-interstellar-scan.md, apps/elite-dangerous-app-composition.md, apps/elite-dangerous-systems-uninhabitet.md, apps/elite-dangerous-expedition-planner.md. TODO.md — expedition manifest item resolved; git-only list narrowed.

• HOSTED_APP_CONTRACT.md: optional discovery registries section replaces “central registry out of scope”; manifest-at-origin remains normative; points to APP_DISCOVERY_REGISTRY.md.

• DESIGN_GUIDANCE.md: embeddable/clustered layout rules (main function first, avoid docked sidebars and hero chrome, draw-in panels, sub-nav vs collapsibles); Open journal reader / Install on desktop preferred top-right; prefer modals/popups over sidebars/drawers; avoid decorative outer padding around main content; Global shell action buttons norm (Stellar Scan .btn-top-bar-outlined, Journal / Desktop labels); Modals norm (header with title + Close, padded body, footer for actions; Stellar Scan reference). apps/elite-dangerous-stellar-scan.md overlay placement note aligned.

• DOC_CONVENTIONS.md, REPOS.md, AGENTS.md, TODO.md, SCOPE.md: general partial workspace checkout guidance (missing deploy/source files locally is expected; agents verify against full app repos).
• Removed per-project TODO: Verify docker-compose in checkout wording (e.g. planet-analyser capsule).
• Full doc refresh: REPOS.md EDJEV stack/run commands (Vite + Solid); planet-analyser deploy note; remote-journal partial-checkout hint.
• ARCHITECTURE.md: edpa.howfe.org in runtime topology; EDJEV stack wording (Solid, not Quasar).
• IPC.md, apps/elite-dangerous-stellar-scan.md: Stellar Scan IFM allowlist vs registered handlers (Status not ingested yet).
• apps/elite-dangerous-journal-event-viewer.md, apps/elite-dangerous-planet-analyser.md: run/build and API response alignment with project READMEs.
• AGENTS.md: builds table includes planet-analyser, stellar-scan, stellar-forge-helper, EDJEV.

Added

• TABLE_GUIDANCE.md: normative data-dense table guidance (views, filters, highlights, field registry, modals); Stellar Scan reference file map; cross-links from DESIGN_GUIDANCE.md, README.md, AGENTS.md, AGENT_INDEX.md, apps/elite-dangerous-stellar-scan.md; MkDocs nav entry.

• DESIGN_GUIDANCE.md: Third-party service attribution — when required, bottom-center placement, link behavior, naming (SPANSH, EDSM, api-cache), optional groupings, embedded-mode notes, reference apps (surface map, Stellar Scan). Cross-links from DOC_CONVENTIONS.md, AGENTS.md, HOSTED_APP_CONTRACT.md.

Added

• Capsules for git-only workspace folders: apps/elite-dangerous-interstellar-scan.md, universe-map, orrery-map, living-interior, planet-scan, app-composition.
• IPC.md: Stellar Scan same-window InterFrameMessenger pattern (useJournalConnection.ts).

Changed

• REPOS.md, SCOPE.md, README.md: inventory for six git-only app folders, stellar-forge-helper, planet-analyser, stellar-scan; partial-checkout notes for surface map and remote journal reader.
• ARCHITECTURE.md: Stellar Scan + planet analyser subsystems; topology diagram includes edss.
• apps/elite-dangerous-stellar-scan.md: run commands and env vars from code.

Changed

• Workspace rule: EDOS does not import curated game data from other Elite Dangerous applications (neutral one-line policy; no moral framing). Canonical section: DOC_CONVENTIONS.md; cross-links in ARCHITECTURE.md, AGENTS.md, SCOPE.md, HANDOFF_FOR_EXTERNAL_AGENTS.md, bootstrap templates.

Added

• DESIGN_GUIDANCE.md: optional visual identity (orange-on-black, design tokens, layout patterns); reference implementation elite-dangerous-surface-map. Cross-links from README.md, ARCHITECTURE.md, SCOPE.md, AGENTS.md, AGENT_INDEX.md, apps/elite-dangerous-surface-map.md; nav in docs-deploy/mkdocs.yml.

Changed

• DESIGN_GUIDANCE.md: framework-agnostic tokens (--edos-* CSS variables as canonical); Quasar/surface-map file table demoted to short legacy section; agents told not to scaffold Quasar for greenfield UIs.

• apps/elite-dangerous-local-journal-reader.md: Download filename guidance for hosted “Get desktop bridge” buttons (blob + programmatic <a download>; per-app names such as edam.exe / edjev.exe). Cross-links from apps/elite-dangerous-journal-event-viewer.md and apps/elite-dangerous-surface-map.md.

Changed

• README.md, START_HERE.md, AGENT_INDEX.md, AGENTS.md, ARCHITECTURE.md, REPOS.md, DEPLOYMENT.md, IPC.md, DOC_CONVENTIONS.md, HANDOFF_FOR_EXTERNAL_AGENTS.md, apps/inter-frame-messenger.md, apps/elite-dangerous-surface-map.md, apps/elite-dangerous-journal-event-viewer.md, templates/CURSOR_AGENT_BOOTSTRAP.md, templates/CURSOR_AGENT_BOOTSTRAP_PROD.md, templates/PROJECT_START_README.md: cross-links and checklists for the hosted-app URL/manifest contract (orthogonal to IFM journal IPC).
• docs-deploy/mkdocs.yml: site nav + description include Hosted app contract.
• IPC.md: dropped stale line-number anchor for InterFrameMessenger.send (point to send implementation instead).
• AGENT_INDEX.md, REPOS.md, ARCHITECTURE.md, README.md, SCOPE.md, AGENTS.md, HANDOFF_FOR_EXTERNAL_AGENTS.md, and bootstrap templates: clarified that desktop / URL-wired installers are owned solely by elite-dangerous-local-journal-reader (build-service/), documented EDJEV (edjev) in the runtime URL table and ecosystem mermaid diagram, and added agent read paths for desktop + EDJEV work.
• TODO.md: narrowed remaining gap for EDJEV to optional full source checkout in workspace.
• Refreshed REPOS.md, SCOPE.md, TODO.md, and apps/elite-dangerous-local-journal-reader.md for a populated elite-dangerous-local-journal-reader checkout; EDJEV is now described even when the workspace folder holds only .git.
• Documented mandatory use of the API cache server for community third-party HTTP APIs (fair use, no DDoS protection upstream) in ARCHITECTURE.md, AGENTS.md, DOC_CONVENTIONS.md, SCOPE.md, and apps/api-cache-server.md.

Added

• HOSTED_APP_CONTRACT.md: portable spec for URL bootstrap, /.well-known/edos-integration.json, optional embed handshake, edos.contract, and workspace status for edosEmbedded (surface map + EDJEV).