ReviewOS

also looking at this

stacks/drone

fix: resolve source links through native drone docs

#40
Merged chris wants to merge codex/native-doc-links into main
56 files +179 -159
docs/index.mdmodified+31-31
Changes to docs/index.md
@@ -5,8 +5,8 @@ controls and mission engine. Drone is a Stacks application with TypeScript libra
55functions in `resources/functions/drone/`, native Buddy commands and stx workspaces.
66ArduPilot and PX4 are optional drivers.
77
8Use the sidebar to read guides here. Inline guide links open their GitHub source.
9Routing for relative Markdown links is tracked in [issue #39](https://github.com/stacksjs/drone/issues/39).
8Use the sidebar or inline links to read guides here. Markdown source links also work
9when browsing the repository on GitHub.
1010
1111**Current status: experimental simulation and bench development. Physical telemetry
1212is receive-only and physical flight commands are disabled.** Modeled completion,
@@ -33,40 +33,40 @@ browser and has no aircraft connection. For a terminal demonstration:
3333./buddy drone:simulate
3434```
3535
36Read [architecture and failure behavior](https://github.com/stacksjs/drone/blob/main/docs/architecture.md) before extending control.
37For your Pi 5, start with the [hardware list](https://github.com/stacksjs/drone/blob/main/docs/hardware.md),
38[Pi bring-up](https://github.com/stacksjs/drone/blob/main/docs/raspberry-pi.md) and [Pi AI Camera tracking](https://github.com/stacksjs/drone/blob/main/docs/camera-tracking.md).
36Read [architecture and failure behavior](architecture.md) before extending control.
37For your Pi 5, start with the [hardware list](hardware.md),
38[Pi bring-up](raspberry-pi.md) and [Pi AI Camera tracking](camera-tracking.md).
3939An image-space person lock does not establish identity or metric position.
4040
4141## Build on our runtime
4242
43The [native bench runtime](https://github.com/stacksjs/drone/blob/main/docs/runtime.md) has host and Pico 2 build paths. Its board
44profile remains neutral-only. The owned [sensor pipeline](https://github.com/stacksjs/drone/blob/main/docs/sensors.md),
45[estimator](https://github.com/stacksjs/drone/blob/main/docs/estimation.md), [multirotor controls](https://github.com/stacksjs/drone/blob/main/docs/controls.md),
46[authority supervisor](https://github.com/stacksjs/drone/blob/main/docs/authority.md), [mission engine](https://github.com/stacksjs/drone/blob/main/docs/missions.md) and
47[navigation](https://github.com/stacksjs/drone/blob/main/docs/navigation.md) have separate simulation and hardware acceptance gates.
43The [native bench runtime](runtime.md) has host and Pico 2 build paths. Its board
44profile remains neutral-only. The owned [sensor pipeline](sensors.md),
45[estimator](estimation.md), [multirotor controls](controls.md),
46[authority supervisor](authority.md), [mission engine](missions.md) and
47[navigation](navigation.md) have separate simulation and hardware acceptance gates.
4848
49[Diagnostics and replay](https://github.com/stacksjs/drone/blob/main/docs/diagnostics.md) retain explicit loss and provenance.
50The [library API](https://github.com/stacksjs/drone/blob/main/docs/api.md) describes behavior extensions. The
51[shared vehicle contract](https://github.com/stacksjs/drone/blob/main/docs/vehicles.md) covers quadcopter, fixed-wing, ground,
52surface and subsea profiles. [Optional external drivers](https://github.com/stacksjs/drone/blob/main/docs/drivers.md) have
53[acknowledged protocol services](https://github.com/stacksjs/drone/blob/main/docs/driver-protocols.md); scripted peers are distinct
54from [firmware SITL](https://github.com/stacksjs/drone/blob/main/docs/sitl.md) and physical testing.
49[Diagnostics and replay](diagnostics.md) retain explicit loss and provenance.
50The [library API](api.md) describes behavior extensions. The
51[shared vehicle contract](vehicles.md) covers quadcopter, fixed-wing, ground,
52surface and subsea profiles. [Optional external drivers](drivers.md) have
53[acknowledged protocol services](driver-protocols.md); scripted peers are distinct
54from [firmware SITL](sitl.md) and physical testing.
5555
5656## Explore a workflow
5757
5858| Workflow | Current development surface | Guide |
5959|---|---|---|
60| Camera tracking and follow | Explicit target selection, image-space loss handling and synthetic calibrated fusion | [Tracking](https://github.com/stacksjs/drone/blob/main/docs/camera-tracking.md), [fusion](https://github.com/stacksjs/drone/blob/main/docs/vision.md) |
61| Aerial mapping | Survey planning, synthetic acknowledged capture and dataset export; reconstruction remains open | [Survey collection](https://github.com/stacksjs/drone/blob/main/docs/mapping.md) |
62| Stockpile volumes | Numeric grids/TINs, declared base surfaces, cut/fill and uncertainty; acquisition accuracy is separate | [Volume processing](https://github.com/stacksjs/drone/blob/main/docs/volumes.md) |
63| Infrastructure inspection | Asset-relative modeled capture, explicit observations and repeat-visit comparison | [Inspection](https://github.com/stacksjs/drone/blob/main/docs/inspection.md) |
64| Farming | Synthetic crop sensing and declared planning previews; agronomy and authenticated app integration remain separate | [Agriculture](https://github.com/stacksjs/drone/blob/main/docs/agriculture.md), [Open Farming](https://github.com/stacksjs/drone/blob/main/docs/open-farming.md) |
65| Prescribed application | Owned ground simulation for inert water or granules, with explicit implement authority | [Application](https://github.com/stacksjs/drone/blob/main/docs/application.md) |
66| Public safety | Synthetic incident collection, authenticated records, review and local dataset management | [Public safety](https://github.com/stacksjs/drone/blob/main/docs/public-safety.md) |
67| Patrol and docking | Retained modeled vehicle, explicit decisions, finite recurrence and charge opt-in | [Patrol CLI](https://github.com/stacksjs/drone/blob/main/docs/patrol-cli.md) |
68| Cargo and cinema | Bounded carried-load characterization and a simulated POI angular reframe | [Cargo](https://github.com/stacksjs/drone/blob/main/docs/cargo-load.md), [cinema](https://github.com/stacksjs/drone/blob/main/docs/cinema.md) |
69| Environmental sampling and antenna pointing | Synthetic sampling and a selected-vehicle mount model | [Environment](https://github.com/stacksjs/drone/blob/main/docs/environment.md), [antenna](https://github.com/stacksjs/drone/blob/main/docs/antenna.md) |
60| Camera tracking and follow | Explicit target selection, image-space loss handling and synthetic calibrated fusion | [Tracking](camera-tracking.md), [fusion](vision.md) |
61| Aerial mapping | Survey planning, synthetic acknowledged capture and dataset export; reconstruction remains open | [Survey collection](mapping.md) |
62| Stockpile volumes | Numeric grids/TINs, declared base surfaces, cut/fill and uncertainty; acquisition accuracy is separate | [Volume processing](volumes.md) |
63| Infrastructure inspection | Asset-relative modeled capture, explicit observations and repeat-visit comparison | [Inspection](inspection.md) |
64| Farming | Synthetic crop sensing and declared planning previews; agronomy and authenticated app integration remain separate | [Agriculture](agriculture.md), [Open Farming](open-farming.md) |
65| Prescribed application | Owned ground simulation for inert water or granules, with explicit implement authority | [Application](application.md) |
66| Public safety | Synthetic incident collection, authenticated records, review and local dataset management | [Public safety](public-safety.md) |
67| Patrol and docking | Retained modeled vehicle, explicit decisions, finite recurrence and charge opt-in | [Patrol CLI](patrol-cli.md) |
68| Cargo and cinema | Bounded carried-load characterization and a simulated POI angular reframe | [Cargo](cargo-load.md), [cinema](cinema.md) |
69| Environmental sampling and antenna pointing | Synthetic sampling and a selected-vehicle mount model | [Environment](environment.md), [antenna](antenna.md) |
7070
7171Each guide distinguishes implemented behavior, recorded evidence and remaining
7272work. The sidebar links the detailed runtime, vehicle, payload and operational
@@ -74,14 +74,14 @@ record contracts.
7474
7575## Follow implementation and evidence
7676
77The [dependency roadmap](https://github.com/stacksjs/drone/blob/main/docs/roadmap/README.md) and
78[feature coverage matrix](https://github.com/stacksjs/drone/blob/main/docs/roadmap/feature-coverage.md) map the requested workflows
79to issues. The [behavior parity audit](https://github.com/stacksjs/drone/blob/main/docs/parity.md) records reviewed upstream scope
77The [dependency roadmap](roadmap/README.md) and
78[feature coverage matrix](roadmap/feature-coverage.md) map the requested workflows
79to issues. The [behavior parity audit](parity.md) records reviewed upstream scope
8080and unresolved detail; inventory coverage is not full ArduPilot or PX4 parity.
81The [validation record](https://github.com/stacksjs/drone/blob/main/docs/validation.md) describes individual tested slices and
81The [validation record](validation.md) describes individual tested slices and
8282their limits.
8383
8484Physical integrations retain independent flight-controller and RC authority.
85Read the [flight-development gates](https://github.com/stacksjs/drone/blob/main/docs/flight-development.md) before connecting
85Read the [flight-development gates](flight-development.md) before connecting
8686hardware. Follow work in the [public repository](https://github.com/stacksjs/drone)
8787and [issue tracker](https://github.com/stacksjs/drone/issues).