docs: audit is a living document; separate design sins from contained coding slips
This commit is contained in:
+24
-6
@@ -1,12 +1,26 @@
|
|||||||
# Neuron Fork — Process Audit Log
|
# Neuron Fork — Process Audit Log
|
||||||
|
|
||||||
**Date:** 2026-08-21
|
**Date:** 2026-08-21 (initial entry)
|
||||||
**Scope:** Everything unusual, odd, or dangerous observed while forking
|
**Scope:** Everything unusual, odd, or dangerous observed while forking
|
||||||
`anomalyco/opencode` → `neuron-technologies/neuron`, including mistakes made
|
`anomalyco/opencode` → `neuron-technologies/neuron`.
|
||||||
during our own surgery.
|
|
||||||
|
## This is a living document
|
||||||
|
|
||||||
|
Every future surgery on this codebase appends its findings and its errors
|
||||||
|
here. Two hard rules:
|
||||||
|
|
||||||
|
1. **Design sins and coding slips are logged in different sections.** A design
|
||||||
|
sin is a deliberate decision with dangerous defaults that ships to users.
|
||||||
|
A coding slip is an implementation error. They get different scrutiny and
|
||||||
|
different fixes — conflating them hides both.
|
||||||
|
2. **Containment is always recorded.** For every slip: which gate caught it,
|
||||||
|
and whether it ever reached the remote. The containment column is the point
|
||||||
|
of the log — it proves (or disproves) that our gates work.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## Part 1: Dangerous-by-design findings in upstream code
|
## Part 1: Dangerous-by-design findings in upstream code
|
||||||
|
|
||||||
### 1.1 Network-callable self-upgrade endpoint (HIGH)
|
### 1.1 Network-callable self-upgrade endpoint (HIGH)
|
||||||
@@ -90,10 +104,14 @@ with repo housekeeping files.
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Part 3: Our own surgery incidents (honest record)
|
## Part 3: Error log — all contained pre-push
|
||||||
|
|
||||||
These are mistakes **we** made during the fork process. Logged because a fork
|
Implementation slips made during the fork surgery. Categorically distinct
|
||||||
audit that only blames upstream is propaganda.
|
from Part 1: those were design decisions that shipped; these are coding
|
||||||
|
errors that never reached the remote. Every one was killed locally by a gate
|
||||||
|
(typecheck, test suite, or pre-push hook) before a commit left the machine.
|
||||||
|
The lesson is not "everyone makes mistakes" — it is that the gates caught
|
||||||
|
what invisible-to-upstream rot never could.
|
||||||
|
|
||||||
| # | Incident | Cause | Caught by | Severity |
|
| # | Incident | Cause | Caught by | Severity |
|
||||||
|---|----------|-------|-----------|----------|
|
|---|----------|-------|-----------|----------|
|
||||||
|
|||||||
Reference in New Issue
Block a user