Files
rust-discovery/docs/script-console-job-acceptance.md
2026-11-14 19:26:51 +01:00

182 lines
12 KiB
Markdown

# Vorbereiteter MCP-Abnahmerunner für das Linux-Rootskript
Stand: Grundvertrag des engen Jobrunners. Der erste tatsächliche Aufruf im
Planmodus hielt bei MCP-Initialize an; der strikt lesende Lookup belegt null
persistierte Pläne/Anträge und keinen Job. Die separate Initialize-Diagnose
und der eng korrigierte V2-Parser sind im [V2-Nachtrag](script-console-job-acceptance-v2.md)
belegt. Der ursprüngliche Reader und Fall bleiben unverändert. Kein Approval
oder Browseraufruf gehört zu diesem Runner.
Die 158 eingefrorenen Produktinputs und alle bisherigen Opsquellen bleiben
unverändert. Der neue Runner ist `deploy/script_console_job_acceptance.py`.
Er verwendet ausschließlich die tatsächliche Cloud-Linux-Geräteidentität aus
dem unveränderten Installationsfall `2e27c312-58cc-444d-92a6-863a11ac6ffd`.
Notebook und Windows-VM sind keine Ziele. Die private Inputvorlage ist
`devstate/output/playwright-private/console-full-v1/mcp-plan-input.template.json`,
SHA256 `66f684ab9c5c31be6583fe04f090ba9d7b8724d6e6c920dd9c67c484a339245e`.
Die Skriptbytes bleiben exakt 130 Byte, SHA256
`c878ba5b5c37fa3f1b9485c6994d6c57f6f37d01d99d4239c64d264d4ed95336`:
```sh
set -eu
/usr/bin/id -u
/usr/bin/sleep 12
printf '%s\n' 'RMM_FULL_CONSOLE_LINUX_V1'
printf '%s\n' 'RMM_FULL_CONSOLE_STDERR_V1' >&2
```
Diese Darstellung ist keine Aufforderung zur lokalen Ausführung. Der genaue
ursprüngliche UTF-8-Inhalt einschließlich abschließender Zeile wird gehasht.
Fest gebunden sind `posix_sh`, Root, `full_maintenance_v1`, keine Argumente,
30 Sekunden Laufzeit, 4096 Byte Gesamtausgabe, ein Job mit genau einem Versuch,
`max_parallel:1` und `halt_after_failures:1`. Erwartete rohe Ausgabe ist
`0\nRMM_FULL_CONSOLE_LINUX_V1\n` auf stdout und
`RMM_FULL_CONSOLE_STDERR_V1\n` auf stderr. Der harmlose Warteabschnitt von zwölf Sekunden
ermöglicht die Beobachtung des tatsächlichen laufenden Jobs in der WebUI.
## Voraussetzungen und Grenze
Der verantwortliche Rootagent prüft vor der tatsächlichen Benutzung getrennt
den erhaltenden Runtime-/Serverwechsel, frischen signierten Sync und Fullhelper-
Nachweis, Browservertrauen und die konkrete neue Rootpolicy. Vorlagen oder
dieser Runner ersetzen diese Abnahmen nicht. Eine ausdrücklich angegebene
Policy-SHA256 und ein fester künftiger UTC-Startzeitraum werden im unveränderlichen
Intent gebunden; die Deadline muss innerhalb der überprüften Policygültigkeit
liegen. Der Runner öffnet oder schließt selbst keine Policy.
Vor jedem `operations.plan` und `operations.submit` liest der Runner die
tatsächlichen aktuellen Mitgliedschaften ausschließlich auf dem Server.
Der bestehende Creator ist
`automation:11111111-1111-4111-8111-111111111111`, Art `automation`;
der Testfreigeber ist `simulated-testprincipal-a`, Art `test_human`.
Beide dürfen nicht widerrufen sein. Automation muss exakt die vorhandenen sieben
Rechte plus `root:execute` haben; `plans:approve` ist dort ausdrücklich verboten.
Der Simulator benötigt seine bestehenden Planfreigabe-, Skript- und Rootrechte.
Fehlende Rechte verweigern den Aufruf **vor** jeder MCP-Mutation. Das gesondert
reviewte Provisionieren des zusätzlichen Automation-Rootrechts gehört nicht
zu diesem Runner. Er verändert weder Rechte noch Actorart.
Die zentrale Policy muss genau einen Scope für dieses Gerät, diese Generation,
beide Akteure, den tatsächlichen Fullpolicyhash und den qualifizierten Helpercode
enthalten. Nur Fullskripte, keine Service-, APT- oder typisierte Rebootfreigabe.
Das Profil gibt genehmigtem Rootcode volle Hostautorität; daraus wird keine
Sandbox- oder generelle No-Reboot-Zusage abgeleitet.
Serverzugang nutzt ausschließlich den vorhandenen gepinnten SSH-Bootstrapweg.
Der Token `/opt/rust-discovery/devstate/operator-a.token` wird ausschließlich auf
dem Server für dessen eigene HTTPS-Anfrage gelesen. Er gelangt weder zum
Entwicklungsrechner noch in Logs oder Ergebnisse. Der HTTP-Endpunkt ist fest
`127.0.0.1:18443`, TLS-Name/SNI `localhost`, Vertrauen ausschließlich über
`/opt/rust-discovery/devstate/api-pki/ca.pem`. MCP-Initialize, Initialisierungs-
Notification, Sessionbindung und begrenzte JSON-/SSE-Antworten folgen dem
bestehenden Cloud-MVP-Muster; dessen veralteter privater API-CA-Pfad wird hier
gezielt nicht übernommen.
## Bedienweg und getrennte tatsächliche Abnahme
Die folgende Tabelle beschreibt die Modi. Mit dem separat korrigierten
V2-Runner wurde anschließend genau ein [nativer Rootlauf bestanden](script-console-linux-full-results.md).
Der ursprüngliche Fehlversuch bleibt erhalten; die Modusquelle selbst
enthält weiterhin keinen Genehmigungsweg.
| Modus | Einzige zugelassene Wirkung |
| --- | --- |
| `prepare-local` | Neuer privater lokaler Intent samt unveränderlichem vollständigem Hashzeugen; explizite Policy-SHA und UTC-Zeiten erforderlich |
| `plan --case <UUID>` | Einmalig MCP `operations.plan`, erst nach lokalem und serverseitigem dauerhaften Startmarker |
| `submit --case <UUID>` | Einmalig MCP `operations.submit` mit festem Idempotenzschlüssel; danach lesender Pending-0/0/0/0-Nachweis |
| `pending --case <UUID>` | Bestehende Anfrage und native Nichtverbräuche lesen; niemals einreichen oder genehmigen |
| `read --case <UUID>` | Originalfälle, eindeutige Plan-/Idempotenzlookupdaten und vorhandene Resultate lesen |
| `verify-result --case <UUID>` | Vorhandenes Endergebnis, tatsächlichen UI-Audit, native Originalbytes und betroffene MCP-Mandantengrenze lesen und prüfen |
`prepare-local` setzt nur Asset- und Zeitplatzhalter ein. An den Grund wird eine
eindeutige `acceptance_case=<UUID>`-Kennung angehängt, damit ein verlorener
Planreply rein lesend eindeutig gefunden werden kann. Skript, Identität,
Interpreter, Argumente und Limits werden nicht verändert. Sämtliche Vorlagen-,
Quell- und vollständigen Intentbindungen werden vor jedem Aufruf und Readback
geprüft. Bestehende Pläne, Versuche und Intents werden nicht überschrieben.
Die einzigen mutierenden MCP-Methoden sind Plan und Submit. Es existiert kein
Approval-API-, Browserautomations-, Cancel-, Retry- oder SQL-Schreibpfad. Auf dem
Server entstehen nur eigene private Bootstrapintents und Einmalmarker sowie die
durch MCP selbst erzeugten Pläne/Anträge. Alle direkten SQL-Abfragen laufen in
`BEGIN READ ONLY`; der Operation-Getter wird bewusst nicht aufgerufen, weil
dieser beim Lesen einen abgelaufenen Pendingantrag aktualisieren kann.
Nach Submit müssen die gespeicherte Anfrage `pending_approval`, null Jobs,
Outboxeinträge, Grants und Autorisierungen sowie null native Verbräuche des
neuen Versuchs belegt sein. Der lokale `pending-checkpoint.json` enthält die
tatsächlichen ursprünglichen Planbytes, Plan-/Job-/Skripthashes, Job-/Versuch- und
Operation-IDs, Ziel, Rechteprofil und Grenzen für die separate Browserprüfung.
Seine zusätzliche Operationsansicht ist als aus lesendem SQL abgeleitet
gekennzeichnet. **Erst danach darf der separat berechtigte Akteur den exakten
gespeicherten Plan tatsächlich in der WebUI genehmigen.**
Bei verlorenem Reply niemals denselben Plan-/Submitaufruf erneut starten.
Nur `read` verwenden: Originalcase und eindeutige gespeicherte Reason-/
Idempotenzbindung werden gelesen. Ein gefundener Originalplan darf als genau
dieser Plan erhalten werden; es wird kein Ersatzplan erzeugt. Ein fehlender oder
mehrdeutiger Nachweis bleibt unklar und sperrt Wiederholung.
## Geplanter Ergebnisnachweis und seine Grenzen
Der Endnachweis verlangt genau einen Job, Outboxeintrag, Grant und eine
Autorisierung. Er prüft tatsächlichen `dev_test_browser_simulation`-Audit mit
Simulatorprincipal, `testsimulation:true`, Developmentprofil sowie unveränderten
Plan-/Operationbindungen. Das ist ausdrücklich kein Produktionsnachweis einer
echten menschlichen Identität. Erfolgreicher Zustand, Exit 0, ungekürzte rohe
stdout-/stderr-Bytes, Root-UID, Fullprofil und Skripthash müssen übereinstimmen.
Die native Abfrage öffnet ausschließlich das vorhandene Root-Ledger lesend,
prüft Inode und alle ursprünglichen 18 Verbrauchszeilen bytegebunden und erlaubt
genau einen neuen abgeschlossenen Verbrauch für genau diesen Job/Versuch.
Sie materialisiert ausschließlich diese 18 bekannten IDs und den neuen Versuch
sowie die beiden Verbrauchszähler. Der Leseabschnitt wird vor BLOB-Hashing und
Dekodierung vollständig zurückgerollt/geschlossen. SQLite-Busy-Timeout ist
250 Millisekunden, das kooperative Fortschrittsbudget eine Sekunde; längere
gemessene Transaktionen werden als Nachweis verweigert. Dies ist keine harte
OS-/I/O-Echtzeitgarantie. Es läuft kein vollständiger Integritätsscan.
Originalstart, Jobbytes, Grantbytes, Signaturbytes, Autorisierung, Boot und
Ausführungsausgabe werden mit den gespeicherten Serverdaten verglichen.
Skriptbytes werden direkt aus den ursprünglichen Planbytes ausgeschnitten,
nicht aus einer API-Ansicht neu serialisiert. Die primäre Ed25519-Prüfung bleibt
beim qualifizierten Produkthelper; dieser enge Opsrunner ist kein zweiter
unabhängiger Signaturverifizierer und behauptet dies nicht.
Zeitvergleiche verwenden einen strikten RFC3339-Parser mit ganzzahligen
Epoch-Nanosekunden: null bis neun Nachkommastellen werden exakt auf neun Stellen
aufgefüllt, Z- und numerische UTC-Offsets korrekt verrechnet. Es gibt weder
Gleitkommazahlen noch Rundung/Abschneiden. Ungültige Kalender-/Offsetwerte,
fehlende Zone, mehr als neun Nachkommastellen und die hier nicht unterstützte
Schaltsekunden-Schreibweise werden verweigert. Eingabe und Policy dürfen weiter
Mikrosekunden verwenden; die ursprünglichen Produktbytes bleiben unverändert.
Grant-/Native-Start-/Deadlinegrenzen werden bis zur letzten Nanosekunde verglichen.
Zusätzlich muss derselbe bestehende Automation-A-Token den bereits gespeicherten
eigenen Job über den tatsächlichen MCP/HTTPS-Weg vollständig lesen können;
Ergebnis und rohe Ausgabe müssen zu SQL und nativen Originalen passen.
Mit dem ausschließlich serverseitigen bestehenden `operator-b.token` werden
danach genau zwei lesende MCP-Abfragen ausgeführt: der neue A-Job und dessen
gespeichertes A-Assetinventar. Gültige Authentisierung/Initialize und tatsächliche
strukturierte `FORBIDDEN`-/`NOT_FOUND`-Toolantworten ohne Daten/Details sind Pflicht.
Eine ungültige B-Anmeldung gilt nicht als Mandantennachweis. Dafür entstehen
weder neue Jobs noch weitere Scopes. Der frühere Datenbank-RLS-Beleg ersetzt
diesen ausdrücklich geplanten HTTP-/MCP-Authnachweis nicht.
Tatsächlich lokal geprüft: Python-Syntax und Help; sämtliche eingefrorenen
Quell-/Templatebindungen; exakte Jobbyteausschnitte aus allen drei tatsächlichen
Rust-Goldenplänen; synthetischer zulässiger Plan und Verweigerung geänderter
Skriptbytes, Limits, Creatoridentität und mehrerer Versuche. Kein Test wurde als
nativer Job- oder Browsernachweis ausgegeben. Der danach tatsächlich vorbereitete
ursprüngliche Fall hielt während MCP-Initialize vor dem Plan-Toolcall an;
sein Nichtwirkungsbeleg und die separate V2-Korrektur stehen im V2-Nachtrag.
Der ursprüngliche unbenutzte Runner `c958db665…` bleibt create-only archiviert.
Unabhängiger Review fand dort den zu langen Leseabschnitt über einen vollständigen
SQLite-Integritätsscan und Python-3.10-inkompatible beziehungsweise für Rust-
Nanosekunden ungeeignete `fromisoformat`-Vergleiche. Beide wurden vor jeder
Jobvorbereitung eng korrigiert. Tatsächliche gezielte lokale Prüfungen bestanden:
Z, null bis neun Nachkommastellen, positive/negative Offsets, Zeitpunkt eine
Nanosekunde vor Epoch und die echte Grantgrenzbedingung mit Ein-Nanosekunden-
Abständen. Ein separater temporärer SQLite-Zeuge konnte einen unabhängigen
Schreiber vor jedem Rowhash erwerben; kein Produkt-/VM-Ledger wurde dafür benutzt.