also looking at this
fix: resolve source links through native drone docs
#40
56 files
+179
-159
| @@ -5,8 +5,8 @@ controls and mission engine. Drone is a Stacks application with TypeScript libra | ||
| 5 | 5 | functions in `resources/functions/drone/`, native Buddy commands and stx workspaces. |
| 6 | 6 | ArduPilot and PX4 are optional drivers. |
| 7 | 7 | |
| 8 | Use the sidebar to read guides here. Inline guide links open their GitHub source. | |
| 9 | Routing for relative Markdown links is tracked in [issue #39](https://github.com/stacksjs/drone/issues/39). | |
| 8 | Use the sidebar or inline links to read guides here. Markdown source links also work | |
| 9 | when browsing the repository on GitHub. | |
| 10 | 10 | |
| 11 | 11 | **Current status: experimental simulation and bench development. Physical telemetry |
| 12 | 12 | is receive-only and physical flight commands are disabled.** Modeled completion, |
| @@ -33,40 +33,40 @@ browser and has no aircraft connection. For a terminal demonstration: | ||
| 33 | 33 | ./buddy drone:simulate |
| 34 | 34 | ``` |
| 35 | 35 | |
| 36 | Read [architecture and failure behavior](https://github.com/stacksjs/drone/blob/main/docs/architecture.md) before extending control. | |
| 37 | For 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). | |
| 36 | Read [architecture and failure behavior](architecture.md) before extending control. | |
| 37 | For 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). | |
| 39 | 39 | An image-space person lock does not establish identity or metric position. |
| 40 | 40 | |
| 41 | 41 | ## Build on our runtime |
| 42 | 42 | |
| 43 | The [native bench runtime](https://github.com/stacksjs/drone/blob/main/docs/runtime.md) has host and Pico 2 build paths. Its board | |
| 44 | profile 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. | |
| 43 | The [native bench runtime](runtime.md) has host and Pico 2 build paths. Its board | |
| 44 | profile 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. | |
| 48 | 48 | |
| 49 | [Diagnostics and replay](https://github.com/stacksjs/drone/blob/main/docs/diagnostics.md) retain explicit loss and provenance. | |
| 50 | The [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, | |
| 52 | surface 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 | |
| 54 | from [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. | |
| 50 | The [library API](api.md) describes behavior extensions. The | |
| 51 | [shared vehicle contract](vehicles.md) covers quadcopter, fixed-wing, ground, | |
| 52 | surface and subsea profiles. [Optional external drivers](drivers.md) have | |
| 53 | [acknowledged protocol services](driver-protocols.md); scripted peers are distinct | |
| 54 | from [firmware SITL](sitl.md) and physical testing. | |
| 55 | 55 | |
| 56 | 56 | ## Explore a workflow |
| 57 | 57 | |
| 58 | 58 | | Workflow | Current development surface | Guide | |
| 59 | 59 | |---|---|---| |
| 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) | | |
| 70 | 70 | |
| 71 | 71 | Each guide distinguishes implemented behavior, recorded evidence and remaining |
| 72 | 72 | work. The sidebar links the detailed runtime, vehicle, payload and operational |
| @@ -74,14 +74,14 @@ record contracts. | ||
| 74 | 74 | |
| 75 | 75 | ## Follow implementation and evidence |
| 76 | 76 | |
| 77 | The [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 | |
| 79 | to issues. The [behavior parity audit](https://github.com/stacksjs/drone/blob/main/docs/parity.md) records reviewed upstream scope | |
| 77 | The [dependency roadmap](roadmap/README.md) and | |
| 78 | [feature coverage matrix](roadmap/feature-coverage.md) map the requested workflows | |
| 79 | to issues. The [behavior parity audit](parity.md) records reviewed upstream scope | |
| 80 | 80 | and unresolved detail; inventory coverage is not full ArduPilot or PX4 parity. |
| 81 | The [validation record](https://github.com/stacksjs/drone/blob/main/docs/validation.md) describes individual tested slices and | |
| 81 | The [validation record](validation.md) describes individual tested slices and | |
| 82 | 82 | their limits. |
| 83 | 83 | |
| 84 | 84 | Physical integrations retain independent flight-controller and RC authority. |
| 85 | Read the [flight-development gates](https://github.com/stacksjs/drone/blob/main/docs/flight-development.md) before connecting | |
| 85 | Read the [flight-development gates](flight-development.md) before connecting | |
| 86 | 86 | hardware. Follow work in the [public repository](https://github.com/stacksjs/drone) |
| 87 | 87 | and [issue tracker](https://github.com/stacksjs/drone/issues). |