diff --git a/docs/agent-update-observation-scope.md b/docs/agent-update-observation-scope.md new file mode 100644 index 0000000..eb03636 --- /dev/null +++ b/docs/agent-update-observation-scope.md @@ -0,0 +1,89 @@ +# Migration0016: passives Updateinventar annehmen + +Am2026-11-15 ist Migration0016 tatsächlich auf dem permanenten Server mit dem +regulären SQLx-Migrationspfad ausgeführt und separat nachgelesen worden. Der +bisherige Check `observations_source_id_check` ließ nur `linux.base` und +`windows.base` zu. Die laufende Gatewayversion kannte bereits die passive +`agent.update`-Beobachtung; der Datenbankcheck verweigerte deren Speicherung. +Nach dem neuen Windowsagentenwechsel waren15 entsprechende Fehler beobachtet +worden. Diese verweigerten Nachrichten werden nicht nachträglich als gespeichert +ausgegeben. + +Die additive Datei `migrations/0016_agent_update_observation_scope.sql` erweitert +ausschließlich diese feste Dreiermenge. Freie Scopes bleiben verboten. Im +normalen SQLx-Transactionrahmen wird der alte Check ersetzt und der neue Check +validiert; ein Fehler rollt die Transaktion zurück. `lock_timeout=3s` begrenzt +das Warten auf Tabellenlocks, `statement_timeout=15s` jedes DDL-Statement. +Keine DML-, RLS-, FK-, PK-, Tenant-/Geräte-/Zertifikats-, Job-, Grant- oder +Policyänderung gehört zur Migration. + +Tatsächlicher Fall: `cc3ea56d-6186-425a-8ef3-90562212fb1b`. Verwendet wurde das +bereits vom Orchestrator nativ ARM64 gebaute Image +`sha256:6a76343bf65c126458244f5540d4cb740988144fc77877b409f790251e7ddcc7`. +Es enthält den vorhandenen `rmm-server migrate`-Entrypoint und die echte +SQLx-`migrate!`-Migrationseinbettung. Es wurde kein zusätzlicher Builderlauf +gestartet und keine SQLx-Tabellenzeile manuell angelegt oder geändert. + +Ein eigenes privates Compose-Overlay wählte ausschließlich für den temporären +`migrate`-Container dieses bereits vorhandene Image (`pull_policy: never`, +read-only RootFS, CapDropALL, NoNewPrivileges). Die vorhandene Migration-URL +blieb im normalen Compose-/Prozesskontext; sie wurde nicht ausgegeben. Der +unterstützte `docker compose … run --no-deps … migrate` führte genau einen +wirklichen SQLx-Lauf aus, Exit0. Der eigene gestoppte Container wurde nach +seinem Exit-/Image-/Falllabelbeleg entfernt. Kein API-, Gateway- oder +PostgreSQLdienst wurde durch diesen Agenten ersetzt oder neu gestartet. +API-Filterung und API-only-Deployment sind ein eigener Orchestratorschnitt. + +Die tatsächliche SQLx-Historie besitzt danach Versionen1–16 jeweils mit +`success=true`; die alten15 Checksums stimmen unverändert mit den Quellinputs +überein. Version16 heißt `agent update observation scope` und besitzt SHA384 +`e66ec49233c210555b5107d20b925ca6715925871aa2bf94dfb86bd5cfb39c6dc769fdf0049b615fcad503332e1cd8fc`. +Die SQL-Datei hat SHA256 +`fa0953262e3a8da7f3f0366db6f3fa77ad7976ec04327b126036739eea46eebb`. + +Vor dem echten SQLx-Start wurden3127 bestehende Observationzeilen serverseitig +über ihre vollständige JSON-Zeilendarstellung gehasht; unmittelbar danach waren alle +unverändert. Der ursprüngliche Fallbaseline enthielt3123Zeilen. Deren +unveränderte Fingerprints und die vollständige RLS-/Owner-/ACL-/Policy-, +FK-/PK-/sonstige Check- und Job-/Plan-/Authorization-/Outbox-/Permit-/Receipt- +Zeugen wurden nochmals in einem getrennten Read-only-SQL-Aufruf bestätigt. +Neue passive Zeilen durften parallel regulär hinzukommen. Die neue Constraint +war tatsächlich `VALIDATED` und enthielt genau +`linux.base`, `windows.base`, `agent.update`. API und Gateway liefen während +dieser Migration unverändert mit Image422c2c28; PostgreSQL behielt seine +ursprüngliche Container-/Imageidentität. + +Ein weiterer lesender Serverabgleich fand bereits drei angenommene +`agent.update`-Zeilen, zuletzt15:40:50UTC. Das beweist die normale Speicherung +dieses Scopes nach der Migration, keinen separat geprüften Windows-ACK, +keine neue Basisinventarabnahme und keine Zeit-/Jobbereitschaft. + +Die Vorherarchive enthalten Katalog-/Migrations-/Policyzeugen und +Zeilenfingerprints; ein vollständiger **Vorher-`pg_dump` wurde nicht angelegt**. +Ein vollständiger privater Customformat-Dump wurde ausdrücklich **nach** der +Migration archiviert: `after-migration-0016.pg_dump`,49,455,447Bytes, SHA256 +`b89e74eaaea7ec2faa17a44358acca3aead1db0fcf9ccf673e2c5808b3259398`. +Er bleibt ausschließlich im Root0700-Fall auf dem Server, Datei0600, und wurde +nicht heruntergeladen oder als Vorherbackup bezeichnet. Ein Restoretest wurde +hier nicht ausgeführt. + +Zwei harmlose Vorbedingungen scheiterten vor dem eigentlichen SQLx-Lauf und +bleiben erhalten: zunächst die Annahme eines vollständigen Buildkontexts +statt des tatsächlichen Minimal-Kontexts; danach ein hier nicht unterstütztes +Compose-Flag `--no-build`. Für letzteren Fall waren Exit1, Ledger15 und die +Abwesenheit eines eigenen Containers belegt. Nach Roots konkreter Korrektur +wurde derselbe Originalfall mit einem neuen Create-only-Fortsetzungsintent +verwendet; alte Fehler-/Vorherdateien wurden nicht überschrieben. Ein weiterer +reiner Absenzmatcher wurde an die tatsächliche Kleinschreibung der Docker- +Fehlermeldung angepasst, ebenfalls vor jedem Container-/SQLx-Start. Keine +verlorene SQLx-Wirkung wurde blind wiederholt. + +Geschütztes Serverarchiv: +`/opt/rust-discovery/devstate/observation-scope-migration-cc3ea56d-6186-425a-8ef3-90562212fb1b/`. +Lokaler Belegordner im eigenen Worktree: +`devstate/observation-scope-migration/cc3ea56d-6186-425a-8ef3-90562212fb1b/`. +Die separate lokale `receipt.json` bindet Originalintent, Fehler, tatsächlichen +SQLx-Erfolg, getrennten Read und Nachbackup; SHA256 +`00ff8f8ffa689bf3917937ce14ae23457e464b921ae7793e9091eab9a83d76c7`. +Private Zugangsdaten und +Datenbankinhalte wurden weder veröffentlicht noch in Git aufgenommen. diff --git a/docs/implementation-status.md b/docs/implementation-status.md index d8b4080..91bf003 100644 --- a/docs/implementation-status.md +++ b/docs/implementation-status.md @@ -1,5 +1,16 @@ # Tatsächlicher Implementierungsstand +## Agent-Update-Telemetrie: Migration0016 tatsächlich angewendet — 2026-11-15 + +Der permanente Server akzeptiert nun zusätzlich den festen passiven Scope +`agent.update`. Regulärer SQLx-Runner aus dem vorhandenen ARM64-Kandidaten6a7634, +Exit0 und separate Read-only-Nachprüfung von Version16/Checksum/VALIDATED-Check +bestanden. Ursprüngliche Zeilen, RLS/FKs/PK/ACL und Corezeugen erhalten; keine +laufenden Dienste durch diesen Schnitt ersetzt. Erste drei regulär angenommene +Updatebeobachtungen belegt. API-Basisfilterung ist getrennt. Vorherfingerprints +und ausdrücklich erst nachher angelegter privater pg_dump sind dokumentiert; +kein vorgetäuschter Vorherbackup-/Restoretest. [Beleg](agent-update-observation-scope.md). + ## Passiver Windows-Zeitabschluss vorbereitet — 2026-11-15 Ein kleiner rein lesender Collector für die beiden historischen Rollenbelege diff --git a/migrations/0016_agent_update_observation_scope.sql b/migrations/0016_agent_update_observation_scope.sql new file mode 100644 index 0000000..d7b73f3 --- /dev/null +++ b/migrations/0016_agent_update_observation_scope.sql @@ -0,0 +1,9 @@ +-- Passive agent-update observations share the existing tenant/device-bound +-- ingest path. Preserve both base scopes and every existing row/RLS/FK. +-- SQLx applies this file transactionally and records its normal checksum. +SET LOCAL lock_timeout = '3s'; +SET LOCAL statement_timeout = '15s'; +ALTER TABLE observations DROP CONSTRAINT observations_source_id_check; +ALTER TABLE observations ADD CONSTRAINT observations_source_id_check + CHECK (source_id IN ('linux.base', 'windows.base', 'agent.update')) NOT VALID; +ALTER TABLE observations VALIDATE CONSTRAINT observations_source_id_check;