mirror of
https://github.com/ruvnet/RuView
synced 2026-06-23 12:33:18 +00:00
rUv
df617145d6
* feat(ADR-262 P3): live RuField surface — RuView sensing speaks RuField on /api/field + /ws/field Wire the P1 `wifi-densepose-rufield` bridge into the live `wifi-densepose-sensing-server` so the governed sensing cycle emits real signed RuField `FieldEvent`s on two additive endpoints. - Cargo: add the `wifi-densepose-rufield` path dep (the single coupling point, ADR-262 §5.4 — no new RuView-internal coupling). - New `src/rufield_surface.rs` (kept out of the 8k-line main.rs): `FieldSurface` holds a dedicated ed25519 `Signer` + a bounded ring of recent events + the `/ws/field` broadcast topic; `GET /api/field` and `GET /ws/field` handlers; a standalone `router()` for isolated testing. - Signer (defers the P2 key decision, ADR-262 §8 Q1): a STANDALONE dev/sensing key from `WDP_RUFIELD_SIGNING_SEED`, else a deterministic dev default with a logged WARN. Reusing the `cog-ha-matter` Ed25519 key is the deferred P2 call — P3 does not pre-empt it. - Tap: at the ESP32 governed-trust cycle (`main.rs` ~5886 observe_cycle / ~5938 SensingUpdate build), `emit_rufield_event` joins the cycle's features/classification/signal_field with the engine's effective_class/demoted trust state into a `SensingSnapshot` and surfaces it via the bridge. Existing endpoints (`/ws/sensing` etc.) are unchanged — purely additive. - Privacy egress: `network_egress_allowed` is fail-closed for an unattended live surface — only P1/P2 leave the box; P0 raw and P3/P4/P5 (identity/biometric/aggregate) are held edge-local. A `Derived` cycle maps to P4/P5 and never surfaces. - No-phantom: `emit` drops no-presence cycles (no fabricated events). Gates (tests/rufield_surface_test.rs, tower::oneshot, 4/0): well-formed signed event (WifiCsi, P2 not P1, is_fusable, real timestamp); empty cycle → no phantom; Derived trust never surfaces; mixed stream surfaces only egress-safe events. Honesty (ADR-262 §0/§6): real plumbing on a live endpoint, NOT accuracy. Single-link CSI with its existing caveats (no validated room-coordinate accuracy); dedicated dev signing key pending the P2 ownership decision; no accuracy claim. Co-Authored-By: claude-flow <ruv@ruv.net> * docs(ADR-262 P3): mark P1+P3 implemented; document /api/field + /ws/field; CHANGELOG - ADR-262 Status → "P1 + P3 implemented"; add a P3 implementation-status block (tap site, endpoints, dedicated dev signer deferring the §8 Q1 key decision, fail-closed egress, gates). Keep the honesty framing: real plumbing on a live endpoint, not accuracy. - CHANGELOG [Unreleased]: add the ADR-262 P3 entry. - user-guide: add `/api/field` to the REST table + a "RuField surface (ADR-262 P3)" section covering `/api/field` + `/ws/field`, the fail-closed P1/P2-only egress, the WDP_RUFIELD_SIGNING_SEED dev key, and the no-accuracy honesty note. Co-Authored-By: claude-flow <ruv@ruv.net> * ci: checkout submodules everywhere + Dockerfile copies vendor/rufield Making wifi-densepose-rufield (ADR-262 bridge) a v2 workspace member means EVERY cargo-on-workspace context must have the vendor/rufield submodule present (cargo loads all member manifests). P1 only fixed the rust-tests job; this adds `submodules: recursive` to all workflow checkouts that run cargo (mqtt-integration was failing on the missing submodule manifest), and makes Dockerfile.rust COPY vendor/rufield/ to /vendor/rufield (matches the bridge's ../../../vendor/rufield path-dep under the collapsed Docker layout). update-submodules.yml left alone (it manages submodules itself). Co-Authored-By: claude-flow <ruv@ruv.net> --------- Co-authored-by: ruv <ruvnet@gmail.com>
207 lines
7.0 KiB
YAML
207 lines
7.0 KiB
YAML
name: Cog HA-Matter Release
|
|
|
|
# ADR-116 P8 — Build + sign + bundle the cog-ha-matter cog on a
|
|
# version tag. Upload to gs://cognitum-apps/ runs only when the
|
|
# GCP_CREDENTIALS + COGNITUM_OWNER_SIGNING_KEY secrets are set, so
|
|
# this workflow is safe to merge before the production credentials
|
|
# land — it'll bundle release artifacts to the workflow run page
|
|
# either way.
|
|
|
|
on:
|
|
push:
|
|
tags:
|
|
- 'cog-ha-matter-v*'
|
|
workflow_dispatch:
|
|
inputs:
|
|
dry_run:
|
|
description: 'Build + sign + bundle but skip GCS upload'
|
|
required: false
|
|
default: 'true'
|
|
|
|
env:
|
|
CARGO_TERM_COLOR: always
|
|
CRATE: cog-ha-matter
|
|
|
|
jobs:
|
|
build-x86_64:
|
|
name: Build x86_64
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
with:
|
|
submodules: recursive
|
|
|
|
- name: Setup Rust
|
|
uses: dtolnay/rust-toolchain@stable
|
|
with:
|
|
targets: x86_64-unknown-linux-gnu
|
|
|
|
- name: Cache cargo registry
|
|
uses: actions/cache@v4
|
|
with:
|
|
path: |
|
|
~/.cargo/registry
|
|
~/.cargo/git
|
|
v2/target
|
|
key: cog-ha-matter-x86_64-${{ hashFiles('v2/Cargo.lock') }}
|
|
|
|
- name: Build release binary
|
|
working-directory: v2/crates/cog-ha-matter/cog
|
|
run: make build-x86_64
|
|
|
|
- name: Compute SHA-256
|
|
working-directory: v2/crates/cog-ha-matter/cog
|
|
run: make sign-x86_64
|
|
|
|
- name: Sign with Ed25519 (gated)
|
|
if: ${{ env.SIGNING_KEY != '' }}
|
|
env:
|
|
SIGNING_KEY: ${{ secrets.COGNITUM_OWNER_SIGNING_KEY }}
|
|
working-directory: v2/crates/cog-ha-matter/cog
|
|
run: |
|
|
printf '%s' "$SIGNING_KEY" \
|
|
| openssl pkeyutl -sign -inkey /dev/stdin -rawin \
|
|
-in dist/cog-ha-matter-x86_64.sha256 \
|
|
| base64 -w0 > dist/cog-ha-matter-x86_64.sig
|
|
echo "Signed cog-ha-matter-x86_64 ($(wc -c < dist/cog-ha-matter-x86_64.sig) bytes)"
|
|
|
|
- name: Upload workflow artifact
|
|
uses: actions/upload-artifact@v4
|
|
with:
|
|
name: cog-ha-matter-x86_64
|
|
path: |
|
|
v2/crates/cog-ha-matter/cog/dist/cog-ha-matter-x86_64
|
|
v2/crates/cog-ha-matter/cog/dist/cog-ha-matter-x86_64.sha256
|
|
v2/crates/cog-ha-matter/cog/dist/cog-ha-matter-x86_64.sig
|
|
if-no-files-found: warn
|
|
|
|
build-arm:
|
|
name: Build aarch64 (arm)
|
|
runs-on: ubuntu-latest
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
with:
|
|
submodules: recursive
|
|
|
|
- name: Setup Rust
|
|
uses: dtolnay/rust-toolchain@stable
|
|
with:
|
|
targets: aarch64-unknown-linux-gnu
|
|
|
|
- name: Install cross-compiler
|
|
run: |
|
|
sudo apt-get update
|
|
sudo apt-get install -y gcc-aarch64-linux-gnu
|
|
|
|
- name: Cache cargo registry
|
|
uses: actions/cache@v4
|
|
with:
|
|
path: |
|
|
~/.cargo/registry
|
|
~/.cargo/git
|
|
v2/target
|
|
key: cog-ha-matter-arm-${{ hashFiles('v2/Cargo.lock') }}
|
|
|
|
- name: Build release binary
|
|
working-directory: v2
|
|
env:
|
|
CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER: aarch64-linux-gnu-gcc
|
|
run: |
|
|
cargo build -p cog-ha-matter --release --target aarch64-unknown-linux-gnu
|
|
mkdir -p crates/cog-ha-matter/cog/dist
|
|
cp target/aarch64-unknown-linux-gnu/release/cog-ha-matter \
|
|
crates/cog-ha-matter/cog/dist/cog-ha-matter-arm
|
|
# ^ matches Makefile's `dist/$(CRATE)-arm` so `make sign-arm` finds it
|
|
|
|
- name: Compute SHA-256
|
|
working-directory: v2/crates/cog-ha-matter/cog
|
|
run: make sign-arm
|
|
|
|
- name: Sign with Ed25519 (gated)
|
|
if: ${{ env.SIGNING_KEY != '' }}
|
|
env:
|
|
SIGNING_KEY: ${{ secrets.COGNITUM_OWNER_SIGNING_KEY }}
|
|
working-directory: v2/crates/cog-ha-matter/cog
|
|
run: |
|
|
printf '%s' "$SIGNING_KEY" \
|
|
| openssl pkeyutl -sign -inkey /dev/stdin -rawin \
|
|
-in dist/cog-ha-matter-arm.sha256 \
|
|
| base64 -w0 > dist/cog-ha-matter-arm.sig
|
|
echo "Signed cog-ha-matter-arm ($(wc -c < dist/cog-ha-matter-arm.sig) bytes)"
|
|
|
|
- name: Upload workflow artifact
|
|
uses: actions/upload-artifact@v4
|
|
with:
|
|
name: cog-ha-matter-arm
|
|
path: |
|
|
v2/crates/cog-ha-matter/cog/dist/cog-ha-matter-arm
|
|
v2/crates/cog-ha-matter/cog/dist/cog-ha-matter-arm.sha256
|
|
v2/crates/cog-ha-matter/cog/dist/cog-ha-matter-arm.sig
|
|
if-no-files-found: warn
|
|
|
|
publish-gcs:
|
|
name: Upload to GCS (gated)
|
|
needs: [build-x86_64, build-arm]
|
|
runs-on: ubuntu-latest
|
|
# Skip on dry-run dispatch; skip on tags when GCP_CREDENTIALS unset.
|
|
if: >
|
|
github.event_name == 'push' &&
|
|
vars.HAS_GCP_CREDENTIALS == 'true'
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
with:
|
|
submodules: recursive
|
|
|
|
- name: Download x86_64 artifact
|
|
uses: actions/download-artifact@v4
|
|
with:
|
|
name: cog-ha-matter-x86_64
|
|
path: dist/
|
|
|
|
- name: Download arm artifact
|
|
uses: actions/download-artifact@v4
|
|
with:
|
|
name: cog-ha-matter-arm
|
|
path: dist/
|
|
|
|
- name: Auth to GCP
|
|
uses: google-github-actions/auth@v2
|
|
with:
|
|
credentials_json: ${{ secrets.GCP_CREDENTIALS }}
|
|
|
|
- name: Set up gcloud
|
|
uses: google-github-actions/setup-gcloud@v2
|
|
|
|
- name: Upload binaries + sidecars
|
|
run: |
|
|
gsutil cp dist/cog-ha-matter-x86_64 gs://cognitum-apps/cogs/x86_64/cog-ha-matter-x86_64
|
|
gsutil cp dist/cog-ha-matter-x86_64.sha256 gs://cognitum-apps/cogs/x86_64/cog-ha-matter-x86_64.sha256
|
|
gsutil cp dist/cog-ha-matter-arm gs://cognitum-apps/cogs/arm/cog-ha-matter-arm
|
|
gsutil cp dist/cog-ha-matter-arm.sha256 gs://cognitum-apps/cogs/arm/cog-ha-matter-arm.sha256
|
|
if [ -f dist/cog-ha-matter-x86_64.sig ]; then
|
|
gsutil cp dist/cog-ha-matter-x86_64.sig gs://cognitum-apps/cogs/x86_64/cog-ha-matter-x86_64.sig
|
|
fi
|
|
if [ -f dist/cog-ha-matter-arm.sig ]; then
|
|
gsutil cp dist/cog-ha-matter-arm.sig gs://cognitum-apps/cogs/arm/cog-ha-matter-arm.sig
|
|
fi
|
|
|
|
- name: Print app-registry.json snippet for the cognitum-one PR
|
|
run: |
|
|
for arch in arm x86_64; do
|
|
sha=$(cat dist/cog-cog-ha-matter-$arch.sha256)
|
|
sig=$([ -f dist/cog-cog-ha-matter-$arch.sig ] && cat dist/cog-cog-ha-matter-$arch.sig || echo "")
|
|
cat <<EOF
|
|
--- $arch ---
|
|
{
|
|
"id": "ha-matter",
|
|
"version": "${GITHUB_REF_NAME#cog-ha-matter-v}",
|
|
"binary_url": "https://storage.googleapis.com/cognitum-apps/cogs/$arch/cog-cog-ha-matter-$arch",
|
|
"binary_sha256": "$sha",
|
|
"binary_signature": "$sig",
|
|
"description": "Home Assistant + Matter Cognitum Seed cog (mDNS + witness chain)",
|
|
"min_seed_version": "0.6.0",
|
|
"installable_on": ["$arch"]
|
|
}
|
|
EOF
|
|
done
|