From cf87ade05ab92d928b58e5422e08a1a27af99c77 Mon Sep 17 00:00:00 2001 From: openhands Date: Thu, 19 Mar 2026 11:58:37 +0000 Subject: [PATCH] =?UTF-8?q?fix:=20manifest.jsonl=20schema=20is=20undocumen?= =?UTF-8?q?ted=20=E2=80=94=20no=20canonical=20field=20list=20exists=20anyw?= =?UTF-8?q?here=20(#718)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 --- docs/ARCHITECTURE.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 689968c..265ad5a 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -67,6 +67,25 @@ Sentiment calculation: `sentiment = f(averageTaxRate, percentageStaked)` - Holder value comes from asymmetric slippage (structural ETH accumulation), NOT from fee reinvestment - 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 ### On-chain