From ff62ad9e20dcab5395a7460023b6eda473e00f78 Mon Sep 17 00:00:00 2001 From: thedancingdeveloper <306930456+thedancingdeveloper@users.noreply.github.com> Date: Tue, 1 Sep 2026 21:48:47 +0000 Subject: [PATCH] docs(roadmap): record foreign-domain integration finding and collector-discovery deferral MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Investigating bee hive management as the first concrete foreign-domain case confirmed the DESIGN.md §11 allocation: the domain lives in its own product, tasks enter as work items over MCP/REST, and evidence would enter as read-only observations. Also records that CUSTOMISATION.md's Layer-3 'extra collectors' path has no discovery mechanism yet (collectors are assembled from hard-coded lists in application/services/collect.py), deferred until a concrete external-evidence integration needs it. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_0194Cp7tA6NFXhy534TYrKSA --- docs/ROADMAP.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 52e2acba..7ffb56aa 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -19,6 +19,20 @@ until it ships. deferred. Tracked in the issue tracker as it is picked up. - **Native Anthropic assistant backend.** The assistant speaks to any OpenAI-compatible chat endpoint; a native Anthropic backend is deferred. +- **Foreign-domain integration (first investigated case: bee hive + management).** [`DESIGN.md`](DESIGN.md) §11 keeps foreign domains out of + the core entity set and leaves "feeds in as a collector, read-only" as the + open integration shape. Investigating the first concrete case — apiary, + hive, inspection, treatment, harvest, sensor telemetry — confirmed that + allocation: the domain lives in its own product outside this repository + (co-deployable via a Layer-2 Compose overlay, + [`CUSTOMISATION.md`](CUSTOMISATION.md), when wanted), actionable tasks + enter Vogt as ordinary work items over MCP/REST, and evidence would enter + as read-only observations under a domain vocabulary (e.g. `hive.*` kinds — + observation `kind`/`payload` already accept this without schema change). + No new core entities; continuous telemetry stays in the foreign product's + own store, with Vogt observing summaries. The evidence half depends on + collector discovery below. ## Pending cleanup @@ -38,3 +52,9 @@ until it ships. - **Device-dependent conformance.** The voice and mobile-push passes that need a physical phone and speaker are run per release by the maintainer rather than in CI. +- **Operator-supplied collector discovery.** [`CUSTOMISATION.md`](CUSTOMISATION.md) + names extra collectors as a Layer-3 image extension, but the collector + registry is assembled from a hard-coded list plus configuration-gated + branches in `application/services/collect.py`; an image extension cannot + register one today. An entry-point (or equivalent) discovery mechanism is + deferred until a concrete external-evidence integration needs it.