diff --git a/Rust_RMM_Implementierungsspezifikation.md b/Rust_RMM_Implementierungsspezifikation.md index c278dad..8b9bdd0 100644 --- a/Rust_RMM_Implementierungsspezifikation.md +++ b/Rust_RMM_Implementierungsspezifikation.md @@ -1,6 +1,6 @@ # Rust RMM: Architektur und Implementierungsspezifikation -Version 1.14 · 2026-11-13 · Sprache: Deutsch +Version 1.15 · 2026-11-13 · Sprache: Deutsch **Zweck:** Vollständige, eigenständig nutzbare Grundlage für die Implementierung einer mandantenfähigen Plattform zur Inventarisierung, Überwachung und Fernadministration von Kundengeräten durch eine Coding-KI und ein Entwicklungsteam. @@ -99,16 +99,18 @@ Deploymentdaten, offene Konfiguration und reale Nachweise: ### 0.1 Auftrag an die implementierende KI -**Technische Präzisierung Version 1.12 — endliche Journalbudgets:** +**Technische Präzisierung Version 1.15 — endliche Journalbudgets:** Agentjournal sowie Agent-/Helper-Verbrauchsledger erhalten pro SQLite-Datei -maximal256MiB bei geprüften4096-Byte-Seiten. Der bisherige Implementierungswert -64MiB blockierte auf der tatsächlichen VM bereits zehn abgeschlossene Rootjobs -wegen vollständig erhaltener Sync-Historien. Die Anpassung erhält alle -Identitäten, Journale, Signaturen und Tombstones; kein Reset oder Löschen zur -Abnahme. Volle/inkonsistente Journale sperren weiterhin neue Wirkungen; -`SQLITE_FULL` wird ausdrücklich als Kapazitätssperre gemeldet und nie ignoriert. -Sichere Kompaktierung bleibt späterer eigener Umfang, keine automatische -Löschung oder unbeschränkte Datenbank in diesem MVP. +maximal1GiB bei geprüften4096-Byte-Seiten (262144Seiten). Die früheren festen +64MiB und256MiB blockierten auf der tatsächlichen VM bei vollständig erhaltenen +Sync-Historien, zuletzt während des Abschlussabgleichs nach dem einzigen +Reboot. Eine Erhöhung ist ausschließlich versionierte Bootstrapwartung mit +qualifizierten Artefakten und unveränderten Identitäten, Journal-/Ledgerinodes, +Verbrauchszeilen, Signaturen und Tombstones. Kein Reset oder Löschen zur Abnahme. +Volle/inkonsistente Journale sperren weiterhin neue Wirkungen; Kapazitätsfehler +werden nie ignoriert. Sichere Kompaktierung und weitergehende Kapazitätsplanung +bleiben späterer eigener Umfang, keine automatische Löschung oder unbeschränkte +Datenbank in diesem MVP. Die größere Grenze ist kein Langzeitbetriebsnachweis. **Technische Präzisierung Version 1.11 — neuer Configure-only-Plan:** Nach unabhängig belegtem und durch normalen signierten RootSync abgeschlossenem diff --git a/crates/agent/src/storage.rs b/crates/agent/src/storage.rs index 28fe6a5..8693934 100644 --- a/crates/agent/src/storage.rs +++ b/crates/agent/src/storage.rs @@ -113,7 +113,7 @@ mod passive_pressure_tests { super::prepare_dir(&dir).unwrap(); let mut db = super::open(&dir).unwrap(); assert_eq!(super::next_sequence(&mut db).unwrap(), 1); - db.execute_batch("PRAGMA max_page_count=16384").unwrap(); + db.execute_batch("PRAGMA max_page_count=65536").unwrap(); drop(db); let mut db = super::open(&dir).unwrap(); assert_eq!( @@ -124,7 +124,7 @@ mod passive_pressure_tests { assert_eq!( db.query_row("PRAGMA max_page_count", [], |r| r.get::<_, u32>(0)) .unwrap(), - 65536 + 262144 ); assert_eq!(super::next_sequence(&mut db).unwrap(), 2); drop(db); diff --git a/crates/privileged-helper/src/lib.rs b/crates/privileged-helper/src/lib.rs index e5d7207..88d6a92 100644 --- a/crates/privileged-helper/src/lib.rs +++ b/crates/privileged-helper/src/lib.rs @@ -204,14 +204,14 @@ pub fn lock_state(dir: &Path, uid: u32) -> Result { f.try_lock_exclusive()?; Ok(f) } -/// Finite 256 MiB bound for durable agent/helper history. Unexpected page sizes +/// Finite 1 GiB bound for durable agent/helper history. Unexpected page sizes /// are refused rather than silently multiplying the byte limit. No compaction /// or tombstone deletion occurs here; SQLITE_FULL must still fail closed. pub fn bounded_journal_capacity(db: &rusqlite::Connection) -> Result<()> { let page_size: u32 = db.query_row("PRAGMA page_size", [], |r| r.get(0))?; ensure!(page_size == 4096, "JOURNAL_PAGE_SIZE_UNSUPPORTED"); - let maximum: u32 = db.query_row("PRAGMA max_page_count=65536", [], |r| r.get(0))?; - ensure!(maximum == 65536, "JOURNAL_STORAGE_CAPACITY_BLOCKED"); + let maximum: u32 = db.query_row("PRAGMA max_page_count=262144", [], |r| r.get(0))?; + ensure!(maximum == 262144, "JOURNAL_STORAGE_CAPACITY_BLOCKED"); Ok(()) } diff --git a/crates/privileged-helper/src/tests.rs b/crates/privileged-helper/src/tests.rs index 3c6ff44..00bc533 100644 --- a/crates/privileged-helper/src/tests.rs +++ b/crates/privileged-helper/src/tests.rs @@ -96,7 +96,7 @@ fn journal_capacity_is_finite_and_retains_original_consumption_on_reopen() { let original: Vec = db .query_row("SELECT start FROM execution_evidence", [], |r| r.get(0)) .unwrap(); - db.execute_batch("PRAGMA max_page_count=16384").unwrap(); + db.execute_batch("PRAGMA max_page_count=65536").unwrap(); drop(db); let mut db = open_ledger(&dir, uid).unwrap(); assert_eq!( @@ -107,7 +107,7 @@ fn journal_capacity_is_finite_and_retains_original_consumption_on_reopen() { assert_eq!( db.query_row("PRAGMA max_page_count", [], |r| r.get::<_, u32>(0)) .unwrap(), - 65536 + 262144 ); let preserved: (String, Option>, Vec) = db.query_row("SELECT c.grant_id,c.result,e.start FROM consumed c JOIN execution_evidence e USING(grant_id)", [], |r|Ok((r.get(0)?,r.get(1)?,r.get(2)?))).unwrap(); assert_eq!(preserved, (permit.grant_id.to_string(), None, original)); diff --git a/deploy/cloud_reboot_capacity_upgrade.py b/deploy/cloud_reboot_capacity_upgrade.py new file mode 100644 index 0000000..f297f91 --- /dev/null +++ b/deploy/cloud_reboot_capacity_upgrade.py @@ -0,0 +1,262 @@ +#!/usr/bin/env python3 +"""Preserve the single consumed reboot while extending finite journal capacity. + +No reset, deletion, package action, approval or additional reboot. The agent +remains stopped after installation; normal signed reconciliation is separate. +""" +import argparse +import base64 +import hashlib +import json +import os +from pathlib import Path +import uuid + +import cloud_reboot_acceptance as reboot + +cloud=reboot.cloud +require=cloud.contract.require +SESSION='d015c3ef-f3aa-4522-a3c2-fcb6099df17b' +GRANT='25a4bf3f-772c-487d-825d-73bcbbc418fd' + + +def capacity_maintenance(payload): + import contextlib + import fcntl + import sqlite3 + import stat + import traceback + os.umask(0o077) + state=Path('/var/lib/rmm-agent-remote');root=Path('/var/lib/rmm-helper') + ledger=root/'consumption.sqlite';apt=Path('/var/lib/rmm-apt-transaction') + agent=Path('/usr/local/libexec/rmm-agent-remote');helper=Path('/usr/local/libexec/rmm-privileged-helper') + provider=Path('/usr/lib/rmm-apt-transaction/apt_transaction.py') + config=Path('/etc/rmm-remote/helper-general.json');pin=Path('/etc/rmm-remote/general-helper-proof.json') + def sha(raw):return hashlib.sha256(raw).hexdigest() + def run(args):return subprocess.run(args,capture_output=True,check=True,timeout=15).stdout + def fsync_dir(path): + fd=os.open(path,os.O_RDONLY|os.O_DIRECTORY|os.O_NOFOLLOW) + try:os.fsync(fd) + finally:os.close(fd) + def create(path,raw,mode=0o600): + fd=os.open(path,os.O_WRONLY|os.O_CREAT|os.O_EXCL|os.O_NOFOLLOW,mode) + with os.fdopen(fd,'wb') as f:f.write(raw);f.flush();os.fchmod(f.fileno(),mode);os.fsync(f.fileno()) + fsync_dir(path.parent) + def file_identity(path): + s=path.lstat();require(not path.is_symlink() and path.is_file(),'regular preserved file') + return dict(device=s.st_dev,inode=s.st_ino,size=s.st_size,mode=s.st_mode,uid=s.st_uid,gid=s.st_gid,sha256=sha(path.read_bytes())) + def manifest(path): + if not path.exists():return {'absent':True} + out={} + for p in [path,*sorted(path.rglob('*'))]: + s=p.lstat();require(not p.is_symlink() and (p.is_dir() or p.is_file()),'regular preserved tree') + out[str(p.relative_to(path))]=dict(device=s.st_dev,inode=s.st_ino,mode=s.st_mode,uid=s.st_uid,gid=s.st_gid, + sha256=sha(p.read_bytes()) if p.is_file() else None) + return out + def fingerprint(db): + h=hashlib.sha256() + for name,sql in db.execute("SELECT name,sql FROM sqlite_master WHERE type='table' ORDER BY name"): + require(name.replace('_','').isalnum(),'fixed table identifier') + h.update(json.dumps([name,sql],separators=(',',':')).encode()) + for row in db.execute('SELECT * FROM "'+name+'" ORDER BY rowid'): + cells=[dict(blob_sha256=sha(v),length=len(v)) if isinstance(v,bytes) else v for v in row] + h.update(json.dumps(cells,separators=(',',':'),ensure_ascii=True).encode()) + return h.hexdigest() + @contextlib.contextmanager + def agent_readonly(path): + owner=path.lstat();require(stat.S_ISREG(owner.st_mode) and owner.st_uid==993 and owner.st_nlink==1,'original agent database owner') + sidecars=[Path(str(path)+suffix) for suffix in ('-wal','-shm')] + existing={} + for p in sidecars: + if p.exists() or p.is_symlink(): + s=p.lstat();require(stat.S_ISREG(s.st_mode) and s.st_nlink==1 and s.st_uid==owner.st_uid,'existing fixed agent sidecar owner') + existing[p]=(s.st_dev,s.st_ino,s.st_uid,s.st_gid) + try: + with contextlib.closing(sqlite3.connect(path.as_uri()+'?mode=ro',uri=True)) as db:yield db + finally: + require((path.stat().st_dev,path.stat().st_ino)==(owner.st_dev,owner.st_ino),'agent database inode unchanged') + for p in sidecars: + if p in existing: + s=p.lstat();require((s.st_dev,s.st_ino,s.st_uid,s.st_gid)==existing[p],'existing sidecar unchanged') + elif p.exists() or p.is_symlink(): + observed=p.lstat() + fd=os.open(p,os.O_RDWR|os.O_NOFOLLOW) + try: + s=os.fstat(fd);require(stat.S_ISREG(s.st_mode) and s.st_nlink==1 and s.st_uid in (0,owner.st_uid) and + (s.st_dev,s.st_ino)==(observed.st_dev,observed.st_ino),'only own newly created fixed sidecar') + if s.st_uid==0:os.fchown(fd,owner.st_uid,owner.st_gid) + finally:os.close(fd) + def guard(): + require(payload['grant_id']=='25a4bf3f-772c-487d-825d-73bcbbc418fd' and len(payload['root_rows'])==18,'exact original reboot and 18 retained grants') + require(json.loads((state/'identity.json').read_bytes())['agent_id']==payload['agent_id'],'permanent Cloud identity') + require(Path('/proc/sys/kernel/random/boot_id').read_text().strip()==payload['new_boot_id']!=payload['old_boot_id'],'same one completed boot') + dropin=Path('/etc/systemd/system/rmm-agent-remote.service.d/30-cloud-root.conf') + require('RMM_APT_HELPER_' not in dropin.read_text() and + run(['systemctl','show','rmm-apt-helper.service','-p','ActiveState','--value']).strip()==b'inactive','APT endpoint remains closed') + require(run(['systemctl','show','rmm-agent-remote.service','-p','ActiveState','--value']).strip()==b'inactive','agent must already be quiesced') + require(sha(provider.read_bytes())==payload['provider_sha256'] and sha(config.read_bytes())==payload['config_sha256'] and + sha(pin.read_bytes())==payload['pin_sha256'],'original provider and General policy/pin') + with contextlib.closing(sqlite3.connect(ledger.as_uri()+'?mode=ro',uri=True)) as db: + require(db.execute('PRAGMA integrity_check').fetchone()[0]=='ok','Root integrity') + rows=db.execute('SELECT c.grant_id,c.agent,c.generation,c.job,c.attempt,c.result,e.start,e.outcome FROM consumed c LEFT JOIN execution_evidence e USING(grant_id) ORDER BY grant_id').fetchall() + actual={r[0]:sha(json.dumps([dict(sha256=sha(v),size=len(v)) if isinstance(v,bytes) else v for v in r],separators=(',',':')).encode()) for r in rows} + require(actual==payload['root_rows'],'all 18 original consumption/start/outcome bytes retained') + pending=[r for r in rows if r[5] is None] + require(len(pending)==1 and pending[0][0]==payload['grant_id'] and pending[0][3:5]==(payload['job_id'],payload['attempt_id']) and + json.loads(pending[0][7])['state']=='awaiting_reboot','only original consumed reboot awaits proof') + require(db.execute('SELECT count(*) FROM helper_sync_meta WHERE fault IS NOT NULL').fetchone()[0]==0,'no helper fault') + for name,inode in payload['database_inodes'].items(): + p=Path(name);s=p.stat();require([s.st_dev,s.st_ino]==inode,'original database inode') + if p==ledger:continue + with agent_readonly(p) as db: + require(db.execute('PRAGMA integrity_check').fetchone()[0]=='ok','agent database integrity') + if p.name=='journal.sqlite': + require(db.execute('SELECT count(*) FROM reconcile_meta WHERE fault IS NOT NULL').fetchone()[0]==0 and + db.execute("SELECT count(*) FROM job_attempts WHERE NOT(job=? AND attempt=?) AND state NOT IN ('succeeded','failed','cancelled','expired')",(payload['job_id'],payload['attempt_id'])).fetchone()[0]==0,'no unrelated agent unresolved/fault') + require(payload['mode'] in ('copy','preflight','install'),'fixed maintenance mode') + require(str(uuid.UUID(payload['id']))==payload['id'],'canonical maintenance ID') + for name,path in (('agent',agent),('helper',helper)): + require(file_identity(path)['sha256']==payload['old_'+name+'_sha256'],'qualified old binary') + guard() + if payload['mode']=='preflight':return dict(preflight_only=True,maintenance_mutations=False,root_consumed=18,root_unresolved=1,apt_endpoint_enabled=False) + folder=Path('/var/lib/rmm-bootstrap-history')/('reboot-capacity-'+payload['id']);folder.mkdir(mode=0o700) + if payload['mode']=='copy': + before=file_identity(ledger) + with contextlib.closing(sqlite3.connect(ledger.as_uri()+'?mode=ro',uri=True)) as original: + expected=fingerprint(original);copy=folder/'ledger-copy.sqlite';create(copy,b'') + with contextlib.closing(sqlite3.connect(copy)) as duplicate: + original.backup(duplicate) + require(fingerprint(duplicate)==expected,'exact consistent copied ledger') + size=duplicate.execute('PRAGMA page_size').fetchone()[0];pages=duplicate.execute('PRAGMA page_count').fetchone()[0] + require(size==4096 and duplicate.execute('PRAGMA max_page_count=65536').fetchone()[0]==65536 and pages<=65536,'old finite capacity') + code=None + try: + duplicate.execute('BEGIN IMMEDIATE');duplicate.execute('CREATE TABLE journal_capacity_probe(payload BLOB NOT NULL)') + duplicate.execute('INSERT INTO journal_capacity_probe VALUES(zeroblob(524288))') + except sqlite3.DatabaseError as error:code=getattr(error,'sqlite_errorcode',None) + finally:duplicate.rollback() + require(code==sqlite3.SQLITE_FULL and fingerprint(duplicate)==expected,'copied old cap SQLITE_FULL13 with full rollback') + require(duplicate.execute('PRAGMA max_page_count=262144').fetchone()[0]==262144,'new finite 1GiB cap') + duplicate.execute('BEGIN IMMEDIATE');duplicate.execute('CREATE TABLE journal_capacity_probe(payload BLOB NOT NULL)') + duplicate.execute('INSERT INTO journal_capacity_probe VALUES(zeroblob(524288))') + require(duplicate.execute('SELECT length(payload) FROM journal_capacity_probe').fetchone()[0]==524288,'same insertion succeeds at finite new cap') + duplicate.rollback() + require(fingerprint(duplicate)==expected and duplicate.execute('PRAGMA integrity_check').fetchone()[0]=='ok','copied rows/schema unchanged') + require(file_identity(ledger)==before,'original ledger bytes/inode unchanged');guard() + report=dict(verified=True,backup=str(folder),old_error_code=code,new_insert_passed=True,old_cap_pages=65536,new_cap_pages=262144, + page_size=size,page_count=pages,probe_bytes=524288,original_before=before,original_unchanged=True,rows_and_schema_rolled_back=True, + original_sql_mutations=False,package_effects=False,reboot_requested=False) + create(folder/'report.json',json.dumps(report,indent=2).encode());return report + raw={n:base64.b64decode(payload[n],validate=True) for n in ('agent','helper')} + for name in raw: + require(sha(raw[name])==payload[name+'_sha256'] and raw[name][:6]==b'\x7fELF\x02\x01' and raw[name][18:20]==b'\x3e\x00','qualified Linux x64 artifact') + report=dict(completed=False,backup=str(folder),stage='validated',agent_stopped=True,apt_endpoint_enabled=False, + session_id=payload['session_id'],target=payload['target'],job_id=payload['job_id'],attempt_id=payload['attempt_id'], + grant_id=payload['grant_id'],new_boot_id=payload['new_boot_id'],database_inodes_before=payload['database_inodes'],root_rows_before=payload['root_rows'], + jobs_created=False,grants_created=False, + apt_runtime_ready=False,apt_runtime_note='Historical closed APT measurements retained; requalification required before any future APT job', + package_effects=False,reboot_requested=False,backups={}) + def save(): + create(folder/'.report-next.json',json.dumps(report,indent=2).encode());os.replace(folder/'.report-next.json',folder/'report.json');fsync_dir(folder) + lock=None + try: + save() + for name in raw:create(folder/(name+'-next'),raw[name],0o755);run(['/lib64/ld-linux-x86-64.so.2','--list',str(folder/(name+'-next'))]) + run(['systemctl','stop','rmm-helper-cloud.service']) + lock=os.open(root/'executor.lock',os.O_RDWR|os.O_NOFOLLOW);fcntl.flock(lock,fcntl.LOCK_EX|fcntl.LOCK_NB) + guard() + trees={str(p):manifest(p) for p in (state,root,Path('/var/lib/rmm-agent'),apt)} + controls={str(p):file_identity(p) for p in (config,pin,provider,Path('/etc/rmm/apt-helper.json'),Path('/etc/rmm-remote/apt-helper-proof.json'), + Path('/etc/systemd/system/rmm-agent-remote.service.d/30-cloud-root.conf'),Path('/var/lib/dpkg/status'),Path('/usr/share/rmm-mvp-test/version'))} + for name,path in (('helper',helper),('agent',agent)): + previous=folder/(name+'-previous');require(path.stat().st_dev==folder.stat().st_dev,'same-filesystem versioned replacement') + os.rename(path,previous);fsync_dir(path.parent);fsync_dir(folder);report['backups'][str(path)]=str(previous);save() + os.rename(folder/(name+'-next'),path);fsync_dir(path.parent);fsync_dir(folder) + inspected=json.loads(subprocess.run([str(helper),'--inspect-general-profile'],env=dict(os.environ,RMM_HELPER_CONFIG=str(config)),capture_output=True,check=True,timeout=10).stdout) + require(inspected==json.loads(pin.read_bytes()),'General identity/policy pin unchanged across binary upgrade') + require(all(manifest(Path(p))==v for p,v in trees.items()) and all(file_identity(Path(p))==v for p,v in controls.items()),'all state/identities/journals/APT histories/markers and file inodes preserved') + guard() + report.update(stage='installed_preserved',preserved_state=True,journals_preserved_before_restart=True,root_consumed=18,root_unresolved=1, + old_agent_sha256=payload['old_agent_sha256'],old_helper_sha256=payload['old_helper_sha256'],agent_sha256=payload['agent_sha256'], + helper_sha256=payload['helper_sha256'],provider_sha256=payload['provider_sha256'],general_pin=inspected, + journal_page_size=4096,journal_max_page_count=262144,journal_capacity_bytes=1073741824) + save();fcntl.flock(lock,fcntl.LOCK_UN);os.close(lock);lock=None + run(['systemctl','start','rmm-helper-cloud.service']) + require(run(['systemctl','show','rmm-helper-cloud.service','-p','ActiveState','--value']).strip()==b'active','General helper starts') + require(all(manifest(Path(p))==v for p,v in trees.items()) and all(file_identity(Path(p))==v for p,v in controls.items()),'helper startup preserves every journal and APT witness') + guard();report.update(stage='helper_started_agent_quiesced',completed=True, + database_inodes_after=payload['database_inodes'],root_rows_after=payload['root_rows']);save() + except Exception as error: + report.update(error_class=type(error).__name__,frames=[dict(function=f.name,line=f.lineno) for f in traceback.extract_tb(error.__traceback__)]);save() + finally: + if lock is not None:fcntl.flock(lock,fcntl.LOCK_UN);os.close(lock) + return report + + +def build_payload(mode): + m=cloud.contract;folder=reboot.STATE/SESSION + session=m.protected_json(folder/'before.json');cp=m.protected_json(folder/'checkpoint.json') + frozen=m.protected_json(folder/'proof-upgrade-before.json')['native'];enabled=m.protected_json(folder/'helper-enabled.json') + job=cp['job'];require(job['job_id']=='8ffd0ce5-187e-4227-9fd4-374ac5fdf4aa' and len(frozen['root_rows'])==18,'one exact actual approved reboot') + payload=dict(mode=mode,id=str(uuid.uuid4()),session_id=SESSION,target=session['target'],agent_id=session['target']['agent_id'],old_boot_id=session['old_boot_id'],new_boot_id=frozen['boot_id'], + grant_id=GRANT,job_id=job['job_id'],attempt_id=job['attempt_id'],root_rows=frozen['root_rows'],database_inodes=frozen['database_inodes'], + old_agent_sha256=session['pins']['agent_sha256'],old_helper_sha256=session['pins']['helper_sha256'], + provider_sha256='1dc0237dd8df9c9d22568bb1f6b047ede73bc2a5fca5c7fcedb7f24ab2a58b1e',config_sha256=enabled['config_sha256'],pin_sha256=enabled['pin_sha256']) + if mode=='install': + probe=m.protected_json(folder/'capacity-copy.json') + require(probe['verified'] and probe['old_error_code']==13 and probe['original_unchanged'] and probe['new_insert_passed'],'copied actual RootDB proof required first') + for name in ('agent','helper'): + path=folder/(name+'-reboot-capacity');qualification=m.protected_json(path.with_name(path.name+'.json'));raw=path.read_bytes() + require(qualification['release_build'] is True and qualification['architecture']=='x86_64-unknown-linux-gnu' and + qualification['provider_sha256']==payload['provider_sha256'] and qualification['binary_sha256']==hashlib.sha256(raw).hexdigest(),'qualified new release artifact') + require('crates/privileged-helper/src/lib.rs' in qualification['source_files'] and + (name!='agent' or 'crates/agent/src/reconcile.rs' in qualification['source_files']), + 'capacity and original reboot reconciliation source bound by release') + require(all(hashlib.sha256((cloud.ROOT/p).read_bytes()).hexdigest()==h for p,h in qualification['source_files'].items()),'qualified source unchanged') + payload[name]=base64.b64encode(raw).decode();payload[name+'_sha256']=qualification['binary_sha256'] + return payload + + +def main(): + p=argparse.ArgumentParser(description=__doc__);p.add_argument('mode',choices=('copy','preflight','install'));args=p.parse_args();os.umask(0o077) + folder=reboot.STATE/SESSION + if args.mode=='install':require(not (folder/'capacity-runtime.json').exists(),'completed/incomplete previous installation retained; inspect, never repeat blindly') + payload=build_payload(args.mode) + target=cloud.contract.protected_json(folder/'before.json')['target'] + require(reboot.evidence(target,'gate')==dict(jobs=30,outbox=30,permits=26,unresolved=1),'only original consumed reboot unresolved') + policy=cloud.bootstrap.rpc('server.conf',reboot.server_policy,dict(action='state'));require(policy['closed'],'central Root scopes closed') + cloud.contract.write_private(folder/('capacity-'+args.mode+'-intent.json'),{k:v for k,v in payload.items() if k not in ('agent','helper')}) + report=cloud.bootstrap.rpc('linux-vm.conf',capacity_maintenance,payload) + path=folder/('capacity-'+('runtime' if args.mode=='install' else args.mode)+'.json');cloud.contract.write_private(path,report) + require((report.get('completed') if args.mode=='install' else report.get('verified') if args.mode=='copy' else report.get('preflight_only')) is True,'maintenance incomplete; inspect saved report and preserve original effect') + if args.mode=='install':record_upgrade_index(report) + print('PASS bounded capacity '+args.mode+'; original reboot retained, no package effect, agent remains stopped') + + +def record_upgrade_index(report): + """Create only after an independently returned/read-back completed report.""" + m=cloud.contract;folder=reboot.STATE/SESSION;session=m.protected_json(folder/'before.json') + frozen=m.protected_json(folder/'proof-upgrade-before.json')['native'];enabled=m.protected_json(folder/'helper-enabled.json') + job=m.protected_json(folder/'checkpoint.json')['job'] + require(report['completed'] and report['preserved_state'] and report['journals_preserved_before_restart'] and + report['root_consumed']==18 and report['root_unresolved']==1 and report['agent_stopped'] and + report['apt_endpoint_enabled'] is False and report['package_effects'] is False and report['reboot_requested'] is False and + report['jobs_created'] is False and report['grants_created'] is False and + report['general_pin']==enabled['general_pin'] and report['root_rows_before']==report['root_rows_after']==frozen['root_rows'] and + report['database_inodes_before']==report['database_inodes_after']==frozen['database_inodes'],'complete original-state preserving native report') + bindings=dict(session_id=SESSION,target=session['target'],job_id=job['job_id'],attempt_id=job['attempt_id'],grant_id=GRANT,new_boot_id=frozen['boot_id']) + require(all(report[k]==v for k,v in bindings.items()),'same approved reboot receipt binding') + def ref(path):return dict(path=str(path.resolve()),sha256=hashlib.sha256(path.read_bytes()).hexdigest()) + value=dict(schema_version=1,type='rmm.reboot.storage-capacity-upgrade',verified=True,**bindings, + **{k:report[k] for k in ('old_agent_sha256','old_helper_sha256','agent_sha256','helper_sha256','provider_sha256')}, + session_before_sha256=hashlib.sha256((folder/'before.json').read_bytes()).hexdigest(), + checkpoint_sha256=hashlib.sha256((folder/'checkpoint.json').read_bytes()).hexdigest(),preservation_witness=ref(folder/'proof-upgrade-before.json'), + runtime_report=ref(folder/'capacity-runtime.json'),qualification_reports={n:ref(folder/(n+'-reboot-capacity.json')) for n in ('agent','helper')}) + m.write_private(folder/'capacity-upgrade.json',value) + + +if __name__=='__main__': + try:main() + except Exception as error: + message=str(error);print(message if message.startswith('remote bootstrap incomplete: ') else 'REBOOT_CAPACITY_INCOMPLETE:'+type(error).__name__) + raise SystemExit(2) from None diff --git a/docs/journal-capacity.md b/docs/journal-capacity.md index fce3a5d..ab59837 100644 --- a/docs/journal-capacity.md +++ b/docs/journal-capacity.md @@ -1,5 +1,28 @@ # Begrenzte Journalgröße und SQLite-Kapazitätsfehler +## Aktuell:256MiB-Grenze am Original-Reboot nativ reproduziert + +Spec1.15, tatsächliche Cloudkopie2026-11-13: OriginalRootDB268414976Bytes/ +65531Seiten. Eigene konsistente SQLitekopie mit65536Seiten und512KiB-Insert +scheiterte mit **SQLITE_FULL13**; vollständiger Rollback erhielt alle Zeilen +und Schema. Derselbe Insert auf derselben Kopie bei262144Seiten/1GiB gelang, +wieder vollständiger Rollback/Integritätok. Originalbytes/Größe/Inode unverändert, +Root18 und genau ursprünglicher Rebootgrant25a weiter offen/unverändert. +Keine Original-SQLmutation, Paketwirkung oder weiterer Reboot. Privater Beleg: +`devstate/cloud-reboot/d015c3ef-f3aa-4522-a3c2-fcb6099df17b/capacity-copy.json`. + +Minimaler gemeinsamer Rustfix setzt für Agentjournal/Verbrauchsledger und +Helperledger262144Seiten bei strikt4096Bytes, ohne Kompaktierung/Löschung. +BookwormReleasebuildc8f567a84f1c483e8cfea753e34e2c8f und126Tests im gleichen +Lockfile-/Buildimage sowie Format/AlltargetsClippy bestanden. AgentSHA +`9e9f323075f44e02e3900267b846f124303179171476a23d023708fc8339f9b4`, +HelperSHA`d6fbfc25263243475c50e703c014772c359533548bccc3f09ff91072b0e8b929`; +ELFx64/OpenSSL3/GLIBC2.34. Provider1dc unverändert. Dies ist noch **kein nativer +Artefaktaustausch** und noch kein erfolgreicher Rebootabschluss. + +Die folgenden256MiB-Angaben sind historische Vorgängerqualifikationen; sie +werden weder überschrieben noch als aktuelles1GiB-Installationszeugnis benutzt. + Stand 2026-11-13. **Quellkorrektur implementiert, lokal geprüft und x86-64- Releaseartefakte gebaut; nachfolgende native Kopier-/Installationsbelege stehen unten.** Die erhaltene Cloudhistorie darf weder gelöscht noch kompaktiert/zurückgesetzt werden. diff --git a/docs/post-mvp.md b/docs/post-mvp.md index 6f4fcd0..56f5633 100644 --- a/docs/post-mvp.md +++ b/docs/post-mvp.md @@ -14,7 +14,7 @@ Korrektheitsfehler in einem aktuellen MVP-Pfad bleiben dort sofort relevant. | Dauerhafter Produktivbetrieb (M7) | Ein dedizierter Cloudserver, getrennte API/Gateway-Rollen, interne DB; Wiederanläufe ohne Historienreset belegt. | HA, getestete Backups/zentraler Restore, vereinbarte RTO/RPO, externe Plattformüberwachung, signierte Agentupdates und getrennt gesicherter Auditbestand. Grundlegende aktuelle Wiederholungssperren bleiben schon im MVP Pflicht. | | Gleichzeitiger Build und Deployment | Entdeckt beim Zustellungstest und inzwischen im aktuellen Upgradepfad behoben: eindeutiger Kandidatentag + aufgezeichneter Digest; nur explizites geprüftes Deploy bewegt den Runtimetag. Abgeschlossener nativer Build ließ Runtime unverändert. Historische Buildrunner bleiben getrennt zu prüfen. | Verfahren später auf alle Release-/Rollbacks-/CI-Pfade übertragen. Historische mutable Runner bis dahin nur ausdrücklich koordiniert verwenden. | | Monitoringausbau (M6a) | Präsenz, Quellen-/Datenalter und unbekannte Gesundheit werden getrennt dargestellt. | Sollservice-/Funktionschecks, Alarmdauer/Hysterese, Vorfälle und produktiver Metrikpfad samt nativen AT-28-Nachweisen; keine erfundenen Patchdaten. | -| Langzeitjournale und Kompaktierung | Reale Sync-Historien erreichten64MiB nach zehn Rootverbräuchen. Isoliert reproduziert; aktueller endlicher Default256MiB pro Datei, alle Historien erhalten. Volle/inkonsistente Journale sperren weiterhin neue Wirkungen. | Dokumentierte beidseitige Kompaktierung und Kapazitätsplanung; niemals stille Löschung von Unknown oder unbestätigten Ergebnissen. | +| Langzeitjournale und Kompaktierung | Reale Sync-Historien erreichten64MiB nach zehn Rootverbräuchen. Isoliert reproduziert; auch die folgende256MiB-Grenze wurde im Rebootabschluss erreicht; Spec1.15 sieht weiterhin endliche1GiB pro Datei vor. Native Qualifikation separat im Journalbericht, alle Historien erhalten. Volle/inkonsistente Journale sperren weiterhin neue Wirkungen. | Dokumentierte beidseitige Kompaktierung und Kapazitätsplanung; niemals stille Löschung von Unknown oder unbestätigten Ergebnissen. | | Automatische Rückkehr von HTTPS zu WSS | Tatsächlicher Auto-Fallback nach zwei authentisierten WSS503 bestanden. Ein bestehender HTTPS-Aktor bleibt gegebenenfalls bestehen; operativer Agentneustart stellte WSS wieder her. | Nur bei produktivem Bedarf einen begrenzten, zustandserhaltenden Transportwechsel untersuchen; derzeit kein automatischer Switchback versprochen und kein zusätzliches MVP-Feature. | | Dauerhaft ungültiges passives Inventar vor Reconnect-Sync | Der neue Recovery-Scope wurde zunächst vom zentralen Zeichenvalidator abgewiesen. Das unverändert persistierte Inventar wurde vor dem Sync erneut gesendet und blockierte so den Kanal; der unmittelbare MVP-Fix erlaubt ausschließlich diesen bekannten Linux-Scope. | Einen expliziten Umgang mit dauerhaft abgewiesener passiver Telemetrie untersuchen, der Originalbytes, Nachrichten-ID, Herkunft und Ablehnungsbeleg erhält und keine Bestätigung erfindet. Job-/Ergebnisjournale und unbekannte Wirkungen dürfen dabei niemals übersprungen werden. | | Weitere Plattformen / Skalierung | Ubuntu 24.04 x86-64 als Linux-Testclient; ARM64-Serverbuild ist kein ARM64-Agentnachweis. Nur eine tatsächliche Linux-Zielmaschine im aktuellen Aufbau. | Native Agentmatrix und realistische Last-/Mehrgeräteabnahmen erst zur vereinbarten Ausbaustufe erweitern; keine erfundenen Parallelitätszahlen. | diff --git a/docs/project-decisions.md b/docs/project-decisions.md index 44d7cd1..437ff12 100644 --- a/docs/project-decisions.md +++ b/docs/project-decisions.md @@ -1,6 +1,6 @@ # Verbindliche Projektentscheidungen -Stand: **2026-11-13**, Spezifikation **1.14** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. +Stand: **2026-11-13**, Spezifikation **1.15** (`Rust_RMM_Implementierungsspezifikation.md`). Die ausdrücklichen normativen Entscheidungen in Kapitel 0 haben Vorrang vor früheren Architekturannahmen. Version 1.6 ersetzt die lokale Servertopologie durch den dedizierten Internetserver; Version 1.7 präzisiert das Notebook als reinen Entwicklungsrechner; Version 1.8 erlaubt vorgezogene parallele Windows-Entwicklung. ## Rechtzeitiger Rebootkontakt und spätere frische Verifikation (Version1.14) @@ -170,9 +170,15 @@ Plangenehmigungen. Runtimeprobe allein ist kein Ausführungsnachweis. ## Endliches Journalbudget nach tatsächlichem Kapazitätsbefund -Spezifikation1.12 setzt pro Agentjournal/Agent- oder Helperledger die feste -Grenze256MiB bei validierter4KiB-Seitengröße. Reale Cloud-Historie erreichte den -alten64MiB-Wert bereits ohne offene Wirkung; unveränderte Originaldatenbank -auf isolierter Kopie mit `SQLITE_FULL` reproduziert. Keine History-/Marker- -löschung oder Ausnahme vom Fail-closed-Verhalten. Quelle, lokale Guards und -nativer Erhaltungs-/Sync-Nachweis: `docs/journal-capacity.md`. +Spezifikation1.15 erhöht das weiterhin feste Budget pro Agentjournal/Agent- +oder Helperledger auf1GiB bei validierter4KiB-Seitengröße (262144Seiten). +Nach der früheren64→256MiB-Korrektur erreichte die vollständig erhaltene +Cloud-Sync-Historie auch256MiB während des Original-Rebootabschlusses. +Agenttransport wurde vor weiteren Diagnosezyklen angehalten. Qualifikation +verlangt Kopiereproduktion des alten Limits und versionierte Installation +mit erhaltenen DBinodes, sämtlichen alten Verbrauchs-/Signatur-/Historydaten +und genau demselben offenen Rebootversuch. Keine neue Wirkung/kein neuer Grant, +keine History-/Marker-Löschung und keine Fail-closed-Ausnahme. Native Prüfstände +stehen getrennt im [Journalbericht](journal-capacity.md); die Entscheidung +selbst behauptet keine bereits ausgeführte Installation. Kompaktierung bleibt +nach dem MVP.