Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
97 changes: 81 additions & 16 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand All @@ -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

Expand All @@ -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).
3 changes: 2 additions & 1 deletion STATUS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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) |
Loading