Skip to content
9 changes: 6 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Semion

<p align="center">
<img src="assets/hero.svg" alt="Semion hero — bronze triad of icon, index, symbol" width="100%" />
<img src="assets/hero.png" alt="Semion hero — bronze triad of icon, index, symbol" width="100%" />
</p>

**Triad specialist** for the Abraxas model stack. Corpus atoms in. `semion.frame.v0` out.
Expand All @@ -22,14 +22,17 @@ The Validate badge may stay red when Actions billing blocks the workflow even if

## Social preview

GitHub / link-preview card: [`assets/og-social.svg`](assets/og-social.svg) (1280×640). Distinct from the README hero.
Raster stills for Settings → Social preview live at `assets/og-social.jpg` once dropped (see `assets/README.md`).
Raster card for GitHub Settings → Social preview: [`assets/og-social.jpg`](assets/og-social.jpg) (1280×640). Also [`assets/og-social.png`](assets/og-social.png).
SVG stand-in remains at [`assets/og-social.svg`](assets/og-social.svg).

Custom Settings social preview is **not** writable via API or the GitHub MCP connector. After merge, paste `assets/og-social.jpg` in Settings → General → Social preview (private repos may require a prior upload or public visibility for sharing).

## Quick links

| Doc | Path |
|-----|------|
| Status | [`STATUS.md`](STATUS.md) |
| Aaron train handoff | [`docs/aaron-train-handoff.md`](docs/aaron-train-handoff.md) |
| Milestones | [`specs/MILESTONES.md`](specs/MILESTONES.md) |
| Constitution | [`.specify/memory/constitution.md`](.specify/memory/constitution.md) |
| Spec 000 spine | [`specs/000-semion-spine/spec.md`](specs/000-semion-spine/spec.md) |
Expand Down
8 changes: 7 additions & 1 deletion STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,5 +12,11 @@
| Spec 003 semiosis chain | specified + export `compat.py` |
| Spec 004 encoder gate | specified, name_gate **false**, dataset note landed |
| E-S0 / E-C0 / E-K0 | in repo |
| Hub | closed |
| Hub | closed (HF skipped 2026-09-11) |
| Spec 009 id swap | done — `semion.triad` |
| Hero / OG rasters | on branch — `assets/hero.{png,jpg}` · `assets/og-social.{png,jpg}` |
| Settings Social preview | **manual paste** of `og-social.jpg` (no API/MCP write) |
| M2 rebalance pack | floors **PASS** — gold 482 (train 330 / val 50 / test 102); keep_weak 150 |
| Aaron Notion pack | https://app.notion.com/p/3d83e8ba2f5c81608499deffc060160d |
| Boof ALLOW_TRAIN | **false** — Aaron trains on Spark |
| Handoff doc | [`docs/aaron-train-handoff.md`](docs/aaron-train-handoff.md) |
12 changes: 7 additions & 5 deletions assets/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,11 @@

| File | Use |
|---|---|
| `hero.svg` | README banner |
| `og-social.svg` | 1280×640 link preview stand-in |
| `hero.jpg` | optional raster drop-in (generate locally; not required for specify) |
| `og-social.jpg` | paste into GitHub Settings → General → Social preview |
| `hero.svg` | README banner (vector) |
| `hero.png` / `hero.jpg` | README hero raster (1600×900) |
| `og-social.svg` | 1280×640 link-preview stand-in |
| `og-social.png` / `og-social.jpg` | Settings → General → Social preview (1280×640) |

GitHub social preview API is not writable from this lane. Operator pastes `og-social.jpg` in the repo settings UI.
GitHub social preview **API is not writable** (REST/GraphQL/MCP). Operator pastes `og-social.jpg` in the repo Settings UI after merge.

Semion is private; GitHub only allows custom OG upload on public repos, or private repos that already have a custom image.
Binary file added assets/hero.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/hero.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/og-social.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/og-social.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
39 changes: 39 additions & 0 deletions docs/aaron-train-handoff.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Aaron train handoff — Semion M2 rebalance

**Audience:** Aaron Godbout (Spark)
**Date:** 2026-09-11 PT
**Repo pin:** `scrimshawlife-ctrl/Semion@9e29976` (docs tip of this branch may be newer)

## Pack

- Notion: https://app.notion.com/p/3d83e8ba2f5c81608499deffc060160d
- Pack id: `semion-train-pack-m2-rebalance-20260911`
- SHA256: `8bb18b705b1e51cbce63b4fec79029c00b5f2b81e0b11ca9d42533057851b0da`
- Spec 011: https://app.notion.com/p/3d83e8ba2f5c813c9989c0a2dc28357f

## Counts (Spec 004 floors PASS)

| Split | N |
|---|---|
| train | 330 |
| val | 50 |
| test | 102 |
| keep_weak (not gold) | 150 |

Gold pool 482: OBSERVED 14 · inferred wrap 240 · inferred seed 228.
Class floors PASS (icon/index/symbol ≥15%; mixed/NC ≥8%). Train symbol share ~0.31.

## How to train

1. Download the zip from Notion.
2. Prefer `gold_observed.jsonl` for T0/T1 gold; full splits in `train.jsonl` / `val.jsonl` / `test.jsonl`.
3. Keep `keep_weak.jsonl` out of gold unless you set an explicit weak-lane flag.
4. Dual-use / `NOT_COMPUTABLE` rows are refuse probes — expect refuse, not action content.
5. Encoder gate: `specs/004-encoder-gate/`. `name_gate` stays **false** until your eval is green.
6. HF Hub skipped (Danny). Boof `ALLOW_TRAIN` is false — run train on Spark.

## Do not

- Mix `keep_weak` into gold without a weak-lane flag
- Treat Notion/email as a green name-gate
- Publish to Hugging Face without Danny `ALLOW_HUB`
Loading