fix: manifest.jsonl schema is undocumented — no canonical field list exists anywhere (#718)

Add a Push3 Seed Pool section to docs/ARCHITECTURE.md documenting all
manifest.jsonl fields (file, origin, date, fitness, fitness_flags, run,
generation, note) with type, required/optional status, and allowed values.
References the machine-readable manifest.schema.json for validation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
openhands 2026-03-19 11:58:37 +00:00
parent c824489c23
commit cf87ade05a

View file

@ -67,6 +67,25 @@ Sentiment calculation: `sentiment = f(averageTaxRate, percentageStaked)`
- Holder value comes from asymmetric slippage (structural ETH accumulation), NOT from fee reinvestment - Holder value comes from asymmetric slippage (structural ETH accumulation), NOT from fee reinvestment
- Low sentiment (bear) → tight around floor, maximum protection - Low sentiment (bear) → tight around floor, maximum protection
## Push3 Seed Pool
The evolutionary optimizer runs from `tools/push3-evolution/`. Active seeds are tracked in `tools/push3-evolution/seeds/manifest.jsonl` — one JSON object per line (JSONL format).
### `manifest.jsonl` field reference
| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `file` | string | ✓ | Filename relative to `seeds/` (e.g. `optimizer_v3.push3`) |
| `origin` | `"hand-written"` \| `"evolved"` \| `"llm"` | ✓ | How the seed was produced |
| `date` | string (`YYYY-MM-DD`) | ✓ | ISO 8601 date the entry was added to the manifest |
| `fitness` | integer \| null | — | Raw fitness score (wei-scale integer). `null` when the seed has not yet been evaluated or the score has been invalidated |
| `fitness_flags` | string \| null | — | Comma-separated flags that qualify or invalidate the fitness value (e.g. `token_value_inflation,processExecIf_fix`). `null` when no flags apply |
| `run` | string \| null | — | Zero-padded run identifier from which the seed was admitted (e.g. `"007"`). `null` for `hand-written` and `llm` seeds |
| `generation` | integer \| null | — | Generation index within the run at which this candidate was produced. `null` for `hand-written` and `llm` seeds |
| `note` | string \| null | — | Human-readable description of the seed strategy or noteworthy behaviour |
The full machine-readable definition is in `tools/push3-evolution/seeds/manifest.schema.json` (JSON Schema draft 2020-12). `additionalProperties` is `false` — unknown fields are rejected. Only `file`, `origin`, and `date` are required; all other fields are optional but must match the types above when present.
## Stack ## Stack
### On-chain ### On-chain