From c5a128a890ef1866cd7d7d2747a8319d13f31ec4 Mon Sep 17 00:00:00 2001 From: Daniel Meyer Date: Fri, 11 Sep 2026 22:41:41 +0000 Subject: [PATCH] docs: expand README to Athanor-stack operator front door Add ships/doesn't, M2 rebalance snapshot, pipeline, specs, corpus vs pack split, and fail-closed gates. Stamp STATUS hero on main. --- README.md | 97 ++++++++++++++++++++++++++++++++++++++++++++++--------- STATUS.md | 3 +- 2 files changed, 83 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index a53948b..18512b2 100644 --- a/README.md +++ b/README.md @@ -12,20 +12,67 @@ Named for Greek *sēmeion*: a sign. Semiosis is the chain. This repo is the clas | | | |---|---| -| **Owns** | triad · sign class · corpus adapt | +| **Owns** | triad · sign class · corpus adapt · semiosis export | | **Honesty** | `OBSERVED` / `INFERRED` / `SPECULATIVE` / `NOT_COMPUTABLE` | -| **Shape** | T0 rules now. Encoder name-gated. Not a chatbot. | +| **Shape** | Spec 001–003 **T0 live**. Spec 004 encoder **name-gated**. Not a chatbot. | | **Anti** | phenomenal heads · forecast mint · numeric Brier · chat trunk · Hyperlex form route · Athanor family gold | | **Lane** | SHADOW — classify live · train/Hub gated | - -The Validate badge may stay red when Actions billing blocks the workflow even if local `pytest` passes. +| **Version** | `0.1.0` (see [`STATUS.md`](STATUS.md)) | + +The Validate badge may stay red when Actions billing blocks the workflow even if local `pytest` passes. Local tests are the bar. + +## What ships / what does not + +| Ships now | Does **not** ship | +|-----------|-------------------| +| T0 `classify` / `adapt` / chain export (`compat`) | Trained encoder weights / Hub upload | +| Spec 004 encoder **gate** (name_gate **false**) | `ALLOW_TRAIN` / `ALLOW_HUB` from Boof | +| M2 rebalance gold floors **PASS** (local SoT + Aaron pack) | Full labeled SoT in git | +| Hero + OG rasters | Auto Settings social-preview write | + +## Current state (OBSERVED 2026-09-11 PT) + +| Area | State | +|------|-------| +| Spec 000–003 | Specified + code | +| Spec 004 encoder gate | Specified · `name_gate` **false** · dataset note landed | +| Local gold SoT | `~/.semion/corpus/dataset.jsonl` — **482** gold (**not in git**) | +| Splits | train **330** · val **50** · test **102** | +| keep_weak | **150** (demoted wrap-symbol; **not** gold) | +| Spec 004 class floors | **PASS** (icon/index/symbol ≥15%; mixed/NC ≥8%) | +| Hub / HF | **Skipped** (Danny) | +| Boof `ALLOW_TRAIN` | **false** — Aaron trains on Spark | +| Aaron Notion pack | https://app.notion.com/p/3d83e8ba2f5c81608499deffc060160d | +| Handoff | [`docs/aaron-train-handoff.md`](docs/aaron-train-handoff.md) | ## Social preview -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). +Raster card: [`assets/og-social.jpg`](assets/og-social.jpg) (1280×640) · also [`assets/og-social.png`](assets/og-social.png). +SVG stand-in: [`assets/og-social.svg`](assets/og-social.svg). +Settings → Social preview is **manual** (no API/MCP). Private repos may block first custom OG. + +## Pipeline + +``` +source packet → adapt() → atom → classify() → semion.frame.v0 + ↓ + frame_to_semiosis() + ↓ + SemiosisFrame-shaped dict (export only) +``` + +Router home: `yggdrasil.belief`. Mixed slang+sign → Hyperlex first. Mixed tradition+sign → Athanor first. +No circular import of Abraxas. See [`ARCHITECTURE.md`](ARCHITECTURE.md). + +## Specs -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). +| Spec | Role | Path | +|------|------|------| +| 000 spine | Constitution / dual-use | [`specs/000-semion-spine/`](specs/000-semion-spine/) | +| 001 triad | T0 classify | [`specs/001-semion-triad/`](specs/001-semion-triad/) | +| 002 corpus adapt | Adapt packets → atoms | [`specs/002-corpus-adapt/`](specs/002-corpus-adapt/) | +| 003 chain | Semiosis export | [`specs/003-semiosis-chain/`](specs/003-semiosis-chain/) | +| 004 encoder gate | Name-gate + floors | [`specs/004-encoder-gate/`](specs/004-encoder-gate/) | ## Quick links @@ -35,15 +82,10 @@ Custom Settings social preview is **not** writable via API or the GitHub MCP con | 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) | -| Spec 001 triad | [`specs/001-semion-triad/spec.md`](specs/001-semion-triad/spec.md) | -| Spec 002 corpus adapt | [`specs/002-corpus-adapt/spec.md`](specs/002-corpus-adapt/spec.md) | -| Spec 003 chain | [`specs/003-semiosis-chain/spec.md`](specs/003-semiosis-chain/spec.md) | -| Spec 004 encoder gate | [`specs/004-encoder-gate/spec.md`](specs/004-encoder-gate/spec.md) | -| Dual-use gate | [`specs/000-semion-spine/dual-use-gate.md`](specs/000-semion-spine/dual-use-gate.md) | | Model card | [`MODEL_CARD.md`](MODEL_CARD.md) | | Quickstart | [`docs/quickstart.md`](docs/quickstart.md) | | Architecture | [`ARCHITECTURE.md`](ARCHITECTURE.md) | +| Dual-use | [`specs/000-semion-spine/dual-use-gate.md`](specs/000-semion-spine/dual-use-gate.md) | ## Install and classify @@ -54,12 +96,35 @@ python -m semion classify '{"sign_form":"smoke column","object_candidate":"fire" pytest -q ``` -Local labeled corpus, when it exists, lives at `~/.semion/corpus/atoms.jsonl` — **not in git**. +Expected: `sign_class=index`, `phenomenal=false`, `forecast_eligible=false`. + +Local labeled corpus lives at `~/.semion/corpus/dataset.jsonl` (plus `keep_weak.jsonl`) — **not in git**. + +## Corpus and train packs + +| Layer | Where | In git? | +|-------|-------|---------| +| Gold SoT | `~/.semion/corpus/dataset.jsonl` | **No** | +| keep_weak | `~/.semion/corpus/keep_weak.jsonl` | **No** | +| Aaron zip / Notion | operator Notion page (see handoff) | **No** (Hub skipped) | + +Gold pool note: OBSERVED + INFERRED wrap/seed labels. Keep `keep_weak` **out** of gold unless an explicit weak-lane flag is set. +Dual-use / `NOT_COMPUTABLE` rows are refuse probes. + +## Fail-closed gates + +Do **not** without Danny/operator yes: + +- Commit SoT / gold dumps into git +- Flip `name_gate` or publish to Hugging Face (`ALLOW_HUB`) +- Treat Notion/email delivery as a green name-gate +- Mix `keep_weak` into gold without a weak-lane flag +- Forecast mint, phenomenal heads, or numeric Brier in this package ## Peers -Hyperlex (form / lexical) · Athanor (tradition structure) · **Semion (sign relation)** · abx.brier (settled calibration) +Hyperlex (form / lexical) · Athanor (tradition structure) · **Semion (sign relation)** · Yggdrasil (route classifier) · abx.brier (settled calibration) ## License -Code: MIT. Corpus atoms carry their own licenses — see `LICENSE_POLICY.md`. +Code: MIT. Corpus atoms carry their own licenses — see [`LICENSE_POLICY.md`](LICENSE_POLICY.md). diff --git a/STATUS.md b/STATUS.md index a714c77..85ddedd 100644 --- a/STATUS.md +++ b/STATUS.md @@ -14,9 +14,10 @@ | E-S0 / E-C0 / E-K0 | in repo | | 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}` | +| Hero / OG rasters | on main — `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) | +| README | operator front door expanded (stack parity with Athanor) |