From a270433335fa9a444147f596390c0d42aa0058e9 Mon Sep 17 00:00:00 2001 From: minuszka Date: Wed, 23 Sep 2026 09:18:33 +0200 Subject: [PATCH 1/2] docs: keep working notes local, publish English operational docs only Reviews, audits, handovers and implementation logs move out of the repository and stay on the workstation (docs/ is ignored except for an explicit allowlist). What remains public is the rollout record and the two operational runbooks, now in English: - docs/devnet-rollouts.md - docs/MONGO_BACKUP_RUNBOOK.md (was MONGO_BACKUP_RUNBOOK_HU.md) - docs/NGINX_HEADERS_RUNBOOK.md (was NGINX_HEADERS_RUNBOOK_HU.md) References in CLAUDE.md, the backup unit and two code comments are updated so nothing public points at a file that is no longer here. --- .gitignore | 7 + CLAUDE.md | 2 +- client/e2e/run-status.spec.ts | 2 +- docs/AUDIT_2026-09-05_HU.md | 208 - docs/AUDIT_FIX_ROADMAP_HU.md | 884 ---- docs/MONGO_BACKUP_RUNBOOK.md | 148 + docs/MONGO_BACKUP_RUNBOOK_HU.md | 149 - docs/NGINX_HEADERS_RUNBOOK.md | 119 + docs/NGINX_HEADERS_RUNBOOK_HU.md | 135 - docs/SIMULATOR_HANDOFF.md | 157 - docs/SIMULATOR_IMPLEMENTATION_ROADMAP_HU.md | 526 --- docs/WEBSITE_AUDIT_2026-09-11_HU.md | 223 - docs/WEBSITE_FINAL_REVIEW_2026-09-13_HU.md | 245 - docs/WEBSITE_HANDOVER_2026-09-13_HU.md | 391 -- docs/WEBSITE_IMPLEMENTATION_LOG_HU.md | 4045 ----------------- docs/WEBSITE_IMPLEMENTATION_ROADMAP_HU.md | 342 -- docs/WEBSITE_MODEL_PROMPTS_HU.md | 91 - ...WEBSITE_REVIEW_DAYS_01_10_2026-09-12_HU.md | 192 - ...SITE_REVIEW_RPC_KEEPALIVE_2026-09-14_HU.md | 94 - docs/WEBSITE_REVIEW_V1_V7_2026-09-13_HU.md | 122 - docs/WEBSITE_REVIEW_W1_W4_2026-09-14_HU.md | 128 - docs/WEBSITE_REVIEW_X1_X2_2026-09-14_HU.md | 136 - docs/review-2026-09-12/playwright.config.ts | 16 - docs/review-2026-09-12/regressions.spec.ts | 155 - docs/review-2026-09-12/results.txt | 372 -- .../W1-simulation-list.md | 15 - .../W2-evidence-session.md | 13 - .../W3-response-gate.md | 16 - .../W4-fairness-profile.md | 11 - .../counterexamples.txt | Bin 22944 -> 0 bytes docs/review-2026-09-13-followup/csp.txt | Bin 4214 -> 0 bytes .../followup.spec.ts | 112 - docs/review-2026-09-13-followup/k1.txt | Bin 4052 -> 0 bytes docs/review-2026-09-13-followup/k2.txt | Bin 252954 -> 0 bytes docs/review-2026-09-13-followup/k3.txt | Bin 868 -> 0 bytes .../negative-controls.txt | Bin 43780 -> 0 bytes .../negative-editor-controls.txt | Bin 12504 -> 0 bytes .../negative.playwright.config.ts | 11 - .../negative.vite.config.ts | 18 - .../review-2026-09-13-followup/npm-audit.json | Bin 4080 -> 0 bytes .../original-probes.txt | Bin 6338 -> 0 bytes .../playwright.config.ts | 6 - docs/review-2026-09-13/npm-audit.json | 85 - docs/review-2026-09-13/playwright.config.ts | 24 - docs/review-2026-09-13/regressions.spec.ts | 114 - docs/review-2026-09-13/results.txt | 408 -- docs/review-2026-09-13/vite.config.ts | 13 - .../P3-default-timeout-test-gap.md | 9 - docs/review-2026-09-14-rpc/RUNS.md | 46 - docs/review-2026-09-14-rpc/SHA256SUMS | 38 - .../agent-measurement.json | 326 -- .../agent-measurement.mjs | 42 - .../review-2026-09-14-rpc/baseline.config.mjs | 1 - docs/review-2026-09-14-rpc/ci.json | 69 - .../review-2026-09-14-rpc/collect-readonly.py | 36 - docs/review-2026-09-14-rpc/core-timeout.json | 21 - docs/review-2026-09-14-rpc/defaults.test.ts | 15 - docs/review-2026-09-14-rpc/final-evidence.py | 20 - .../first-error.config.mjs | 1 - docs/review-2026-09-14-rpc/identity.json | 14 - .../journal-summary.json | 17 - .../missing-default.config.mjs | 1 - .../negative-controls.json | 76 - .../no-pool-timeout.config.mjs | 1 - .../node-24.19-agent-source.json | 183 - .../own-baseline.config.mjs | 1 - .../own-default-results.json | 18 - .../own-missing-default.config.mjs | 1 - .../remote-readonly.json | 308 -- .../request-timeout.config.mjs | 1 - .../retry-warn.config.mjs | 1 - docs/review-2026-09-14-rpc/run-controls.py | 25 - docs/review-2026-09-14-rpc/run-own-default.py | 10 - docs/review-2026-09-14-x1-x2/.gitignore | 2 - docs/review-2026-09-14-x1-x2/baseline.txt | 295 -- docs/review-2026-09-14-x1-x2/csp.txt | 31 - docs/review-2026-09-14-x1-x2/effects.spec.ts | 37 - docs/review-2026-09-14-x1-x2/effects.txt | 32 - docs/review-2026-09-14-x1-x2/extra.txt | 33 - .../review-2026-09-14-x1-x2/github-pr176.json | 1 - docs/review-2026-09-14-x1-x2/harness.txt | 96 - docs/review-2026-09-14-x1-x2/k1.txt | 79 - docs/review-2026-09-14-x1-x2/k2.txt | 1466 ------ docs/review-2026-09-14-x1-x2/k3.txt | 17 - docs/review-2026-09-14-x1-x2/old.txt | 39 - .../playwright.config.ts | 23 - .../prepare-controls.mjs | 11 - docs/review-2026-09-14-x1-x2/vite.config.ts | 14 - docs/review-2026-09-14/.gitignore | 2 - docs/review-2026-09-14/X1-initial-401-lost.md | 31 - .../X2-harness-test-cleanup.md | 17 - docs/review-2026-09-14/csp.txt | 31 - docs/review-2026-09-14/debt-new-broken.txt | 157 - docs/review-2026-09-14/debt-new-clean.txt | 36 - docs/review-2026-09-14/debt-old-broken.txt | 157 - docs/review-2026-09-14/extra.spec.ts | 67 - docs/review-2026-09-14/extra.txt | 115 - docs/review-2026-09-14/github-pr176.json | 1 - docs/review-2026-09-14/k1.txt | 79 - docs/review-2026-09-14/k2-trace-buffer.txt | 2 - docs/review-2026-09-14/k2.txt | 1484 ------ docs/review-2026-09-14/k3.txt | 17 - docs/review-2026-09-14/negative-client.txt | 242 - docs/review-2026-09-14/negative-harness.txt | 107 - docs/review-2026-09-14/playwright.config.ts | 24 - docs/review-2026-09-14/prepare-controls.mjs | 11 - docs/review-2026-09-14/probes.txt | 39 - .../query-identity-rerun.txt | 79 - docs/review-2026-09-14/vite.config.ts | 21 - docs/simulator/ARCHITECTURE_HU.md | 216 - docs/simulator/CONTRACTS_HU.md | 439 -- docs/simulator/CONTROL_API_HU.md | 115 - docs/simulator/MEASUREMENT_PIPELINE_HU.md | 43 - docs/simulator/OPERATIONS_HU.md | 224 - docs/simulator/OUTAGE_WINDOWS_HU.md | 83 - docs/simulator/PERSISTENCE_HU.md | 140 - docs/simulator/PREFLIGHT_HU.md | 111 - docs/simulator/RESULTS_HU.md | 175 - docs/simulator/SCENARIOS_HU.md | 68 - docs/simulator/THREAT_MODEL_HU.md | 167 - docs/v23-production-explorer-port.md | 138 - ops/systemd/deftrack-mongo-backup.service | 2 +- server/src/simulator/scenarioRegistry.ts | 2 +- 123 files changed, 278 insertions(+), 17556 deletions(-) delete mode 100644 docs/AUDIT_2026-09-05_HU.md delete mode 100644 docs/AUDIT_FIX_ROADMAP_HU.md create mode 100644 docs/MONGO_BACKUP_RUNBOOK.md delete mode 100644 docs/MONGO_BACKUP_RUNBOOK_HU.md create mode 100644 docs/NGINX_HEADERS_RUNBOOK.md delete mode 100644 docs/NGINX_HEADERS_RUNBOOK_HU.md delete mode 100644 docs/SIMULATOR_HANDOFF.md delete mode 100644 docs/SIMULATOR_IMPLEMENTATION_ROADMAP_HU.md delete mode 100644 docs/WEBSITE_AUDIT_2026-09-11_HU.md delete mode 100644 docs/WEBSITE_FINAL_REVIEW_2026-09-13_HU.md delete mode 100644 docs/WEBSITE_HANDOVER_2026-09-13_HU.md delete mode 100644 docs/WEBSITE_IMPLEMENTATION_LOG_HU.md delete mode 100644 docs/WEBSITE_IMPLEMENTATION_ROADMAP_HU.md delete mode 100644 docs/WEBSITE_MODEL_PROMPTS_HU.md delete mode 100644 docs/WEBSITE_REVIEW_DAYS_01_10_2026-09-12_HU.md delete mode 100644 docs/WEBSITE_REVIEW_RPC_KEEPALIVE_2026-09-14_HU.md delete mode 100644 docs/WEBSITE_REVIEW_V1_V7_2026-09-13_HU.md delete mode 100644 docs/WEBSITE_REVIEW_W1_W4_2026-09-14_HU.md delete mode 100644 docs/WEBSITE_REVIEW_X1_X2_2026-09-14_HU.md delete mode 100644 docs/review-2026-09-12/playwright.config.ts delete mode 100644 docs/review-2026-09-12/regressions.spec.ts delete mode 100644 docs/review-2026-09-12/results.txt delete mode 100644 docs/review-2026-09-13-followup/W1-simulation-list.md delete mode 100644 docs/review-2026-09-13-followup/W2-evidence-session.md delete mode 100644 docs/review-2026-09-13-followup/W3-response-gate.md delete mode 100644 docs/review-2026-09-13-followup/W4-fairness-profile.md delete mode 100644 docs/review-2026-09-13-followup/counterexamples.txt delete mode 100644 docs/review-2026-09-13-followup/csp.txt delete mode 100644 docs/review-2026-09-13-followup/followup.spec.ts delete mode 100644 docs/review-2026-09-13-followup/k1.txt delete mode 100644 docs/review-2026-09-13-followup/k2.txt delete mode 100644 docs/review-2026-09-13-followup/k3.txt delete mode 100644 docs/review-2026-09-13-followup/negative-controls.txt delete mode 100644 docs/review-2026-09-13-followup/negative-editor-controls.txt delete mode 100644 docs/review-2026-09-13-followup/negative.playwright.config.ts delete mode 100644 docs/review-2026-09-13-followup/negative.vite.config.ts delete mode 100644 docs/review-2026-09-13-followup/npm-audit.json delete mode 100644 docs/review-2026-09-13-followup/original-probes.txt delete mode 100644 docs/review-2026-09-13-followup/playwright.config.ts delete mode 100644 docs/review-2026-09-13/npm-audit.json delete mode 100644 docs/review-2026-09-13/playwright.config.ts delete mode 100644 docs/review-2026-09-13/regressions.spec.ts delete mode 100644 docs/review-2026-09-13/results.txt delete mode 100644 docs/review-2026-09-13/vite.config.ts delete mode 100644 docs/review-2026-09-14-rpc/P3-default-timeout-test-gap.md delete mode 100644 docs/review-2026-09-14-rpc/RUNS.md delete mode 100644 docs/review-2026-09-14-rpc/SHA256SUMS delete mode 100644 docs/review-2026-09-14-rpc/agent-measurement.json delete mode 100644 docs/review-2026-09-14-rpc/agent-measurement.mjs delete mode 100644 docs/review-2026-09-14-rpc/baseline.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/ci.json delete mode 100644 docs/review-2026-09-14-rpc/collect-readonly.py delete mode 100644 docs/review-2026-09-14-rpc/core-timeout.json delete mode 100644 docs/review-2026-09-14-rpc/defaults.test.ts delete mode 100644 docs/review-2026-09-14-rpc/final-evidence.py delete mode 100644 docs/review-2026-09-14-rpc/first-error.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/identity.json delete mode 100644 docs/review-2026-09-14-rpc/journal-summary.json delete mode 100644 docs/review-2026-09-14-rpc/missing-default.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/negative-controls.json delete mode 100644 docs/review-2026-09-14-rpc/no-pool-timeout.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/node-24.19-agent-source.json delete mode 100644 docs/review-2026-09-14-rpc/own-baseline.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/own-default-results.json delete mode 100644 docs/review-2026-09-14-rpc/own-missing-default.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/remote-readonly.json delete mode 100644 docs/review-2026-09-14-rpc/request-timeout.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/retry-warn.config.mjs delete mode 100644 docs/review-2026-09-14-rpc/run-controls.py delete mode 100644 docs/review-2026-09-14-rpc/run-own-default.py delete mode 100644 docs/review-2026-09-14-x1-x2/.gitignore delete mode 100644 docs/review-2026-09-14-x1-x2/baseline.txt delete mode 100644 docs/review-2026-09-14-x1-x2/csp.txt delete mode 100644 docs/review-2026-09-14-x1-x2/effects.spec.ts delete mode 100644 docs/review-2026-09-14-x1-x2/effects.txt delete mode 100644 docs/review-2026-09-14-x1-x2/extra.txt delete mode 100644 docs/review-2026-09-14-x1-x2/github-pr176.json delete mode 100644 docs/review-2026-09-14-x1-x2/harness.txt delete mode 100644 docs/review-2026-09-14-x1-x2/k1.txt delete mode 100644 docs/review-2026-09-14-x1-x2/k2.txt delete mode 100644 docs/review-2026-09-14-x1-x2/k3.txt delete mode 100644 docs/review-2026-09-14-x1-x2/old.txt delete mode 100644 docs/review-2026-09-14-x1-x2/playwright.config.ts delete mode 100644 docs/review-2026-09-14-x1-x2/prepare-controls.mjs delete mode 100644 docs/review-2026-09-14-x1-x2/vite.config.ts delete mode 100644 docs/review-2026-09-14/.gitignore delete mode 100644 docs/review-2026-09-14/X1-initial-401-lost.md delete mode 100644 docs/review-2026-09-14/X2-harness-test-cleanup.md delete mode 100644 docs/review-2026-09-14/csp.txt delete mode 100644 docs/review-2026-09-14/debt-new-broken.txt delete mode 100644 docs/review-2026-09-14/debt-new-clean.txt delete mode 100644 docs/review-2026-09-14/debt-old-broken.txt delete mode 100644 docs/review-2026-09-14/extra.spec.ts delete mode 100644 docs/review-2026-09-14/extra.txt delete mode 100644 docs/review-2026-09-14/github-pr176.json delete mode 100644 docs/review-2026-09-14/k1.txt delete mode 100644 docs/review-2026-09-14/k2-trace-buffer.txt delete mode 100644 docs/review-2026-09-14/k2.txt delete mode 100644 docs/review-2026-09-14/k3.txt delete mode 100644 docs/review-2026-09-14/negative-client.txt delete mode 100644 docs/review-2026-09-14/negative-harness.txt delete mode 100644 docs/review-2026-09-14/playwright.config.ts delete mode 100644 docs/review-2026-09-14/prepare-controls.mjs delete mode 100644 docs/review-2026-09-14/probes.txt delete mode 100644 docs/review-2026-09-14/query-identity-rerun.txt delete mode 100644 docs/review-2026-09-14/vite.config.ts delete mode 100644 docs/simulator/ARCHITECTURE_HU.md delete mode 100644 docs/simulator/CONTRACTS_HU.md delete mode 100644 docs/simulator/CONTROL_API_HU.md delete mode 100644 docs/simulator/MEASUREMENT_PIPELINE_HU.md delete mode 100644 docs/simulator/OPERATIONS_HU.md delete mode 100644 docs/simulator/OUTAGE_WINDOWS_HU.md delete mode 100644 docs/simulator/PERSISTENCE_HU.md delete mode 100644 docs/simulator/PREFLIGHT_HU.md delete mode 100644 docs/simulator/RESULTS_HU.md delete mode 100644 docs/simulator/SCENARIOS_HU.md delete mode 100644 docs/simulator/THREAT_MODEL_HU.md delete mode 100644 docs/v23-production-explorer-port.md diff --git a/.gitignore b/.gitignore index 3482d5e..96a6fcd 100644 --- a/.gitignore +++ b/.gitignore @@ -68,3 +68,10 @@ audit-scratch/ # Playwright MCP session output (page snapshots taken while verifying a view). .playwright-mcp/ + +# Working notes, reviews, audits and handovers stay on the workstation; only +# the English operational docs listed below are published. +/docs/* +!/docs/devnet-rollouts.md +!/docs/MONGO_BACKUP_RUNBOOK.md +!/docs/NGINX_HEADERS_RUNBOOK.md diff --git a/CLAUDE.md b/CLAUDE.md index 82bd43e..6e93aa0 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1154,7 +1154,7 @@ The explorer database is backed up nightly since 2026-09-14. `ops/mongo-backup.s `/usr/local/sbin/deftrack-mongo-backup`, with the `deftrack-mongo-backup.{service,timer}` units. It runs mongodump as the read-only user, checks the archive before pruning, and writes a `.sha256` and a manifest beside each archive. The procedure, restore check and rollback are in -[`docs/MONGO_BACKUP_RUNBOOK_HU.md`](docs/MONGO_BACKUP_RUNBOOK_HU.md). The archives hold non-public host +[`docs/MONGO_BACKUP_RUNBOOK.md`](docs/MONGO_BACKUP_RUNBOOK.md). The archives hold non-public host addresses, so every copy that leaves the VPS must stay private. **Measure an RPC client change against its mechanism, not only against the error count.** #181 closes pooled diff --git a/client/e2e/run-status.spec.ts b/client/e2e/run-status.spec.ts index b1b6aa7..b98eb9b 100644 --- a/client/e2e/run-status.spec.ts +++ b/client/e2e/run-status.spec.ts @@ -498,7 +498,7 @@ test.describe('run status', () => { /** * Everything below was found by the final independent review (2026-09-13), * and each case failed on main before it was fixed. The review's own probes - * are in docs/review-2026-09-13; these are the gate's versions, and the order + * stayed with the review; these are the gate's versions, and the order * of the answers in them is stated with held responses rather than hoped for * with delays. */ diff --git a/docs/AUDIT_2026-09-05_HU.md b/docs/AUDIT_2026-09-05_HU.md deleted file mode 100644 index eea8a06..0000000 --- a/docs/AUDIT_2026-09-05_HU.md +++ /dev/null @@ -1,208 +0,0 @@ -# Audit – devnet.deftrack explorer és szimulátor (2026-09-05) - -Hatókör: a teljes repó a `feat/outcome-concentration` ágon (`3c7b498`), hat -területre bontva: gyűjtő/observation pipeline, HTTP-réteg és biztonság, -szimulátor-mag (`server/src/simulator`), szimulátor szolgáltatási réteg -(services/routes/models/CLI), Lit-kliens, valamint ops/chaos/lab/CI. Minden -fájl teljes terjedelmében olvasva; a kiemelt (kritikus/magas) találatokat a -forrásban másodszor is visszaellenőriztem, ezeket **[ellenőrizve]** jelöli. -A node-oldali feltevéseket az `~/DEFCON` `v22.1.x` (`e15e29b136`) fa ellen -olvastuk vissza. - -Kiindulási állapot: `npm run typecheck` zöld mindhárom workspace-en; `npm test` -69 fájl / 626 teszt zöld; `npm audit` 3 mérsékelt (qs az Express → body-parser -láncban, **most már** van hozzá `npm audit fix`). A VPS-en a `NODE_ENV=production` -a unitban és a futó folyamatban is be van állítva, az `ADMIN_IDENTITY_HEADER` -nincs (csak olvasó SSH-val ellenőrizve). - -Ami jól áll, és amit nem érdemes szétszedni: a tiszta domain-réteg (dkgSchedule, -dkgWindows, mnListDiff, runState, liveRunLock) alaposan tesztelt és helyes; az -admin auth-terv (kulcs XOR session, CSRF, Cloudflare Access JWT RS256 + iss/aud, -timing-safe összehasonlítás, hash-elt session-id) rendben van; a szimulátor -publikus DTO-i allowlist-alapúak és nem szivárogtatnak; az audit-stream -append-only és ujjlenyomattal visszajátszott; a chaos-csomag fájljogai, -symlink-ellenőrzései és job-írásai gondosak; secret nincs a munkafában. - ---- - -## 1. Kereszt-területi top-lista (ezekkel kezdeni) - -| # | Súly | Hol | Mi | -|---|---|---|---| -| 1 | **KRITIKUS** [ellenőrizve] | `server/src/services/sync.service.ts:333-347` | `rollbackIfReorged` a sikertelen `getblockhash`-t (null) hash-eltérésként kezeli; a visszagörgető ciklusban a null sosem töri meg a keresést, a kurzor -1-ig fut, és **minden** Block/Transaction/ServiceEpoch/QuorumCommitment törlődik, minden QuorumRound `pending`-re áll. Kiváltó: node-restart, `-28 warmup`, axios timeout (nincs a transient-regexben, `rpc.service.ts:122`), vagy **node-reindex** (a tip fölötti `getblockhash` hibát ad). A `signingActiveQuorumCount`-nál régebbi formálódott körök utána sosem figyelhetők meg újra, tehát a sikertelen-kör történet – a projekt célja – visszaállíthatatlanul elveszik. | -| 2 | **KRITIKUS** [ellenőrizve] | `ops/chaos/defcon-chaos:323-325`, `server/src/simulator/netemLease.ts:234-238` | A `prio` root az **alapértelmezett priomappal** épül, a netem az `1:3` sávra kerül. A Linux a TOS-bulk osztályú forgalmat – köztük az OpenSSH interaktív `af21`-ét – szűrő nélkül is a 3. sávba teszi, ezért 100 % loss mellett a host SSH-ja meghal (a plan.md §3a-ban élesben megtörtént), és egy közös hoston a mainnet forgalom is a netemen megy át. A „production sosem kap faultot” tulajdonságot a wrapper nem tartja. | -| 3 | **MAGAS** [ellenőrizve] | `defcon-chaos:325` | A szűrő egress `dport`-ra illeszt, ami a *távoli* portot jelenti: nem a célzott daemon linkjeit, hanem a host összes daemonjának az adott portszámú távoli peerek felé menő kapcsolatait vágja el. Egy megosztott hoston a másik 9 masternode-ot is rontja. Izolációhoz cgroup/unit-alapú osztályozó + `sport` kell. | -| 4 | **MAGAS** [ellenőrizve] | `netemRunner.ts:42-48`, `netemLease.ts:283`, `netemWrapperMain.ts:63-64` | A wrapper **nyugtázza, amit nem alkalmazott**: lejárt lease-re `planApply` üres akciólistát ad, `applyLocked` mégis jobId-t ad vissza, a ciklus `ack()`-ol és `dispatched`-ként számolja. Ugyanez a kimenet a nem validált partíciós peer-lista és az `1e-7%` formátumú loss esetén. A dispatcher már az enqueue-nál `applied`-re állítja az akciót (`simulationDispatcher.service.ts:131`). A futam „fault_active”-ot hisz, miközben semmi nem történt. | -| 5 | **MAGAS** [ellenőrizve] | `simulationDispatcher.service.ts:181-195`, `liveExecutorPlan.ts:327`, `dockerLiveExecutor.ts:163-165` | Az ütemezett `fault-clear` sorok bekerülnek a dispatcher-táblába, de `scheduledLabActionsForPlan` kihagyja őket, így a lookup `UnsupportedLiveFaultError`-t dob: **a netem-fault sosem törlődik a tervezett végén**, csak kézi `recover`-re vagy a wrapper TTL-jére. | -| 6 | **MAGAS** [ellenőrizve] | `quorumRound.service.ts:272-278, :179`, `dkgSchedule.ts:117-121`, `collectorPolicy.ts:24` | Egy `masternode count` hiba `null`-t ad, `effectiveSize` null → `classifyRound` az `impossible` ágat kihagyja → **végleges, hamis `failed`** ítélet; a `failed` státuszt a frissítési szabály sosem nézi újra. A CLAUDE.md „soha ne írjunk 0-t hibából” szabályának ítélet-változata. | -| 7 | **MAGAS** | `simulationControl.service.ts:646-656, :713-730, :741-747` | Három élő-lock hiba: (a) két egyidejű `start` esetén a vesztes CAS-ág `releaseForRun`-nal a **nyertes** lockját engedi el; (b) `abort()` a `begin_recovery`-t a végrehajtó-ellenőrzés *előtt* perzisztálja, így egy aktiválás előtt abortált live futam örökre `recovery`-ben ragad és a `no-active-experiment` preflight minden későbbi live futamot blokkol (a `create` alapból `network:'devnet'`-et fogad live módban is); (c) a lock sikertelen recovery után is elenged, miközben `faultMayBeActive: true`. | -| 8 | **MAGAS** | hat publikus route + `shared/src/index.ts:53,183,231,247,326` + öt kliensoldal | Masternode host-címek (`service`, `hostIp`, `serviceBefore/After`, `byHost[].hostIp`, `punishmentsInBlock.hosts`, fairness `hosts[].host`) a publikus DTO-kban és a publikus oldalon. A repó saját szabálya („a host-címek nem publikusak”) ellen. | -| 9 | **MAGAS** | git-történet, `fb6bb7c` → `a2f86c6` | Egy valós, nem dokumentációs tartományú IP-cím került egy tesztfixtúrába, később kicserélve, de a **publikus GitHub-történetben** benne maradt. Nem a VPS címe. Döntés kell: history-rewrite + force-push, vagy „kiszivárgottnak tekintjük és tűzfalazzuk”. (A cím szándékosan nincs ebben a fájlban.) | -| 10 | **MAGAS** | `ops/chaos/install.sh`, `plan.md` §4 | Nincs host-jogosultsági kapu: a wrapper és a 15 s-os recovery timer **három** hoston aktív, kettő véletlen maradvány, egyikükön fleet-staker és futó production `defcon-node` konténer. A `fleet-nodes.txt` csak leltár, a chaos-csomag nem olvassa. | -| 11 | **MAGAS** | `mnListDiff.service.ts:107-148` | Batch közbeni RPC-hiba után a memóriabeli penalty-baseline előrébb jár, mint a perzisztált kurzor; az újrajátszás minden büntetett node-ra hamis `penalty_up`-ot ír – pont az, amit a `seed()` megelőzni hivatott. | -| 12 | **MAGAS** | `dkgWindows.ts:1340-1353`, `measurementWindows.ts:107-110`, `simulationMeasurement.ts:338`, `scenarioRegistry.ts` (`MAX_OUTAGE_BLOCKS = 6`) | A DKG-anchor kapu és a mérési ablak együtt **sosem** tartalmazza a célzott kört: az anchor a ciklus + `dkgPhaseBlocks`-ra tesz, a megfigyelés faultStart + 2-től indul, a kört viszont `expectedHeight` = ciklus-kezdet szerint választja. Minden horgonyzott futam `not-evaluable`. Az egyetlen „matched” fixtúra 11 blokkos faulttal dolgozik, amit a registry (max 6) nem enged. | - ---- - -## 2. Területenkénti részletek - -### 2.1 Gyűjtő / observation pipeline - -Magas (az 1., 6., 11. fenti tételen túl): - -- **`effectiveSize`/`impossible` a *mostani* MN-számmal**, nem a kör alapblokkjának listájával (`quorumRound.service.ts:179`). Ban-hullám alatt (152→21) egy valóban sikertelen kör `impossible` lesz és sosem kerül újra elő; revive után az igazán lehetetlenek `failed`-re fordulnak. `protx list valid ` vagy az indexelt snapshot kell. -- **`minedHeight` sosem töltődik vissza** `detailsComplete` után (`:358-367` vs `:325`); a reorg-reset `minedHeight > cursor`-ra szűr (`reorg.ts:25`), így pont azokat a köröket hagyja formálódottnak, amelyek elhagyott blokkban voltak. -- **Két eseményíró, félig ütköző kulcsokkal** (`masternodePoller.service.ts:144-175` és `mnListDiff.service.ts:115`): a `banned/revived/registered` kulcs azonos, a poller (60 s, poll-magassággal) rendszerint előbb ír, a blokk-pontos listdiff sor no-op lesz; reorgnál csak a `source:'listdiff'` törlődik, a poll-dátumú ban megmarad. A `penalty_up` és `service_changed` viszont eltérő kulccsal **kétszer** íródik → minden lezárt kísérlet `penaltyIncreases` száma akár 2×. - -Közepes: - -- `QuorumCommitment.quorumHeight` a **bányászati** magasság, nem a kvórumé (`sync.service.ts:466`; konszenzus: `qcTx.height = pindexPrev+1`, `commitment.cpp:201`). Minden sorban `quorumHeight === minedHeight`. -- Holt ZMQ-ciklus `connected: true`-t jelent (`zmq.service.ts:82-85`), nincs újracsatlakozás; a ChainLock-időzítés csendben 5 perces felbontásra esik. -- `/chainlocks` latencia-percentilisek keverik a poll-forrású (akár 300 s) és a ZMQ-s értékeket (`chain.v1.routes.ts:308-313`), a `Block.ts:62-68` saját tiltása ellenére. -- `seedStatus.report()` RPC-hibából `peers: 0`, `verifiedMasternodes: 0`, `stakeScripts: []`-t ír (`seedStatus.service.ts:272-334`). -- Üres `protx list` (reindex, warmup) minden masternode-ra `removed` eseményt gyárt (`masternodePoller.service.ts:266-296`), IBD/mnsync-kapu nélkül. -- Batch közbeni reorg észlelhetetlen: nincs `previousblockhash` láncellenőrzés a ciklusban (`sync.service.ts:292`). -- `recomputeConsecutiveFailures` 0-ról indul egy önkényes ablakkezdetnél, és a nem rögzített (unseeable/gated) magasságokat átugorva egymás utáninak számol (`quorumRound.service.ts:418-437`). - -Alacsony: `valueSat` ~1,1e17 sat fölött nem safe integer (a `JSON.parse` már kerekít, `sync.service.ts:50-56`); hibás ZMQ-frame `lastSeq = -1`-re állít; `computeOutcome.chainLockCoverage` nevezője PoS-blokk, számlálója minden lockolt blokk; nincs `{hasChainLock, height}` index; `admin.v1.routes.ts:77` korlátlan `members.0 $exists` lekérdezés. - -Terv-szintű megjegyzés: két igazságforrás van a körökre – a `QuorumRound` egy 15 s-os RPC-ablakból, a `QuorumCommitment` blokk-pontosan és reorg-biztosan a láncból – és semmi nem egyezteti őket. A commitment-index már ismeri az egész lánc minden formálódott körét (és a null-commitment = sikertelen kör), reorg-biztosan. - -### 2.2 HTTP-réteg és biztonság - -- **Fejléc-identitásos bejelentkezés csak `NODE_ENV`-től függ** (`middleware/adminSession.ts:43`), és a „megbízható proxy” ellenőrzés nginx mögött üres (`adminSession.v1.routes.ts:55`, mindig `127.0.0.1`). Élesben zárva (ellenőrizve), de egy explicit `ADMIN_ALLOW_HEADER_IDENTITY` kapcsoló és nginx-oldali fejléc-törlés kell, hogy ne egy környezeti változó hiánya legyen a határ. -- `/admin/operators` és `/admin/experiments` csak `requireAdminApiKey`-t használ (`admin.v1.routes.ts:18`), nem `requireAdminAuth`-ot: elveszik a cookie/Origin-elutasítás, és a böngészős session nem tudja kezelni őket. -- **Nincs Express error-middleware**: hibás JSON, >256 kB body, `next(error)` HTML-oldalt ad, fejlesztői módban stack-tel; a `{ success, data }` boríték törik. -- `qs` sérülékenység a publikus API-n (`npm audit fix` + `app.set('query parser','simple')`). -- `offset` korlátlan minden lapozott route-on; `/blocks` és `/txs` `total`-ja `estimatedDocumentCount()`; `/experiments/:runKey` futó futamnál kérésenként újraszámol a teljes ablakon 10 s cache-sel; `sharesBlock` lap-lokális. -- **A CLAUDE.md „withCachePolicy profilok + in-flight dedup” állítása nem igaz**: a middleware csak fejléceket állít, dedup csak az RPC-rétegben van. -- `Cache-Control: public` 4xx-re is; `/metrics` és `/health` publikus (RSS, event-loop lag, RPC-metódusonkénti latencia); ingest `host` regex enged IPv4-et, `stakeScripts` korlát nélkül nő. -- Leállítás: `server.close()` nincs megvárva, dispatcher és observation sweep nem áll le, nincs timeout; nincs `unhandledRejection` handler; csak `MONGODB_URI` kötelező a configban; `db.ts:50-52` nyers driver-üzenetet logol (URI-töredék). - -### 2.3 Szimulátor-mag - -A 4., 5., 12. tételen túl: - -- `chain-synced` preflight a live tipet a draft `capturedAtHeight`-jével **egyenlőségre** ellenőrzi (`preflight.ts:213-216`, `simulationEvidence.service.ts:251-255`): validate és arm egy blokkon belül kell hogy lezáruljon (devneten 150 s). A 5 perces snapshot-kor már korlátoz; ez egy második, ellentmondó korlát – és a PREFLIGHT_HU így írja elő, tehát a terv hibás. -- `quorum-member-outage` `phase:'dkg'` a **régi** (utolsó formálódott) kvórumot célozza, a DKG viszont újat választ; ~40 % átfedésnél az `estimateImpact`/`expectedAvailability` szisztematikusan téves. A „next quorum nem elérhető” handoff-nyitott kérdés pont ez. -- `isBenignFailure` bármely `RTNETLINK answers`-t „már tiszta”-ként kezel egy `clear`-en, az `Operation not permitted`-et is: az élő qdisc kikerül a nyilvántartásból (`netemWrapperHost.ts:50-55`). -- Q60-küszöbök beégetve (44/41 a `dryRunExecutor.ts:333-347`-ben, literál típusok a `scenarioTypes.ts:79-80`-ban, 0,8/-0,1 a `compareAvailability`-ben): a laborban (3/2/2) minden riport `degraded` vagy `not-evaluable`. -- A futam-szintű lease minden akció-TTL-t felülír; `restart-flapping` 0. ciklusa 900 s-ig marad lent, ha a dispatcher meghal. -- Nincs automatikus `observing → recovery` átmenet a tervezett végén; a reconcile csak `abortRequested: true`-val tüzel, így egy kézzel nem recoverelt futam `aborted`-ként záródik, és a mérési vég-anchor az operátor reakcióidejétől függ. -- `preflight.ts:330` `(snapshotMatches ?? true)` fail-open; minden draft az aktuális kvórum összes tagjának regisztrációját követeli, `mn-stop`-ra is – részleges devnet-regiszterrel semmi nem draftolható. -- Wrapper boot-verseny (`netemWrapperMain.ts:433-455`: timer élesítés a `recoverInflight`/`bootCleanup` előtt); olvashatatlan state-fájl `{jobs: []}`-re cserélése; `NETEM_WRAPPER_INTERVAL_MS` NaN → 1 ms-os pörgés. -- Blast-radius: `host-outage` a `seed`-et és `staker`-t is viszi; `network-degradation` engedi a `seed` szerepet (az explorer bizonyítékforrása); flapping 10 stakert enged `maxStakers: 5` mellett; `node-isolation` peer-listája korlátlan a wrapper 32-es plafonja ellen. -- `interfaceRef: 'devnet-p2p'` dekoratív: a wrapper `eth0`-t és a teljes interfészt rontja, az ARCHITECTURE_HU „csak a P2P port” ígérete ellenére. -- `clear-recover` élőben nem futtatható (nincs lease-elt akció → `faultLeaseExpiresAtForStart` dob). Halott scenario. -- Egy régi/ismeretlen `parameters` dokumentum a teljes publikus `/simulations` listát 500-ra viszi (`simulationPublicDto.ts:351-356`). - -### 2.4 Szimulátor szolgáltatási réteg - -A 7. tételen túl: - -- **Finalize-jelölt kiéhezés**: a `find(...).sort(updatedAtMs).limit(50)` után szűr a már riportolt futamokra; 50 riportolt futam után az újak sosem kerülnek sorra (`simulationMongo.repository.ts:104-124`), és index nélküli collection scan 20 s-enként. -- **Dupla dispatch**: 30 s lease, `renewLease` implementálva, de sosem hívva; a `settle` eredménye eldobva; a parancsfájlnév nem `actionId`-alapú, tehát nincs dedup. Egy lassú docker-probe után a második worker is enqueue-ol, és a régi `stop` a frissebb `start` után landolhat. -- `failed` akciók sosem próbálódnak újra; a `maxAttempts` csak crash-reclaimre számít – a kód kommentje mást ígér. -- Recovery/abort események a request `acceptedAtMs`-ével vannak bélyegezve; egy rendszer-átmenet (`system_resume_recovery`) után ugyanazon idempotency-kulccsal ismételt kérés örökre `STALE_EVENT`. -- Sima `Error`-ok az időzítésből 500 „internal error”-ként jönnek vissza (határidő-lecsúszás 409 kellene, üzenettel). -- `PUT /targets/:targetId` bármely szerepnek engedi egy **engedélyezett** target `hostRef/unitRef/network` átírását, az `enabled` marad. -- Idempotency-kulcs nem globális (ugyanaz a kulcs `validate`/`arm`/`start`-ra elfogadva), a hash indexeletlen. -- `pre('validate')` invariánsok négy modellen sosem futnak (minden írás `updateOne`/`bulkWrite`); a modell-tesztek holt kódot tesztelnek. -- A dispatcher és az observation sweep az explorer-folyamatban is fut (`index.ts`), ahol live futam sosem aktiválódhat; leállításkor egyik sem áll le. -- Duplikáció: `isDuplicateKey` ×3, append-only hook-blokk ×4, három privát `Logger`, `abort()`/`recover()` azonos 12 sora, `chainTip` closure ×3. - -### 2.5 Kliens (Lit 3) - -- **Az áttekintő minden profilt egy sorozatba kever** (`dd-page-overview.ts:373` `healthTimeline` `llmqName` nélkül; a szerver csak paraméterrel szűr, `quorumRounds.v1.routes.ts:205`): a „formation rate (7d)”, medián/legrosszabb health és a streak öt interleaved ütemezésen fut – pont amit a CLAUDE.md tilt. A `minSize` az első (tie-break nélkül rendezett) körből jön (`:402`), így hol 3, hol 350 („152/350 minimum – kvórum nem lehetséges”), sosem a Q60 73 %-a. -- **Sikertelen vs. büntető kör vizuálisan fordítva**: a `failed` piros pill „0 büntetett” felirattal, a formálódott és 12-t büntető zöld pill sima számmal (`dd-page-rounds.ts:269-291`). Az incidens zöld, a nem-esemény piros. Három explicit állapot kell: `formed · clean`, `formed · punished N` (borostyán, N félkövér), `did not form · nobody punished` (semleges, szöveggel). -- Formation rate health nélkül a shell telemetriájában (`dd-shell.ts:307`) és a `/rounds`, `/pose` oldalon; `maxPossibleBan` a ChainLock-profilé, de nincs kimondva; profil-paraméterek csak a kísérlet-részletben. -- Host-IP-k a publikus oldalon (`dd-page-masternodes.ts:199,144`, `pose:202,245`, `fairness:192,249`, `blocks:269`). -- `.err`/`.note` osztály 12 oldalon definiálatlan; „Seen” oszlop `detectedAt`-ot mutat, amit minden poll felülír (mindig „Ns ago”); fetch-versenyek sequence-guard és AbortController nélkül minden oldalon; dupla fetch mountkor; admin-dashboard 30 s-ig üres bejelentkezés után (`_loading` kapu); scenario `