Skip to content

Reconcile the language-registry surfaces to one canonical 15-entry family#106

Merged
hyperpolymath merged 5 commits into
mainfrom
claude/explore-repo-languages-xkrc46
Jul 3, 2026
Merged

Reconcile the language-registry surfaces to one canonical 15-entry family#106
hyperpolymath merged 5 commits into
mainfrom
claude/explore-repo-languages-xkrc46

Conversation

@hyperpolymath

Copy link
Copy Markdown
Owner

Context

A survey of the coordinator found its language-registry surfaces disagreed badly: languages/ had 12 pointers, docs/language-portfolio.md had 14 + a DSL, .machine_readable/LANGUAGES.a2ml registered only 2 languages in structured form (in two incompatible schemas, the rest in a corrupted "do not parse" s-expression blob), and TOOLING-STATUS.adoc graded ~20 entries. Several real family languages (error-lang, tangle) and haec/007 were registered on some surfaces but missing from others, so a "new language" needed ~10 manual edits with nothing catching a miss.

This PR makes every in-scope surface converge on one canonical set.

The canonical set — 15 entries (14 languages + KitchenSpeak DSL)

affinescript, anvomidav, betlang, eclexia, ephapax, error-lang, haec, jtv, my-lang, oblibeny, phronesis, tangle, wokelang, 007 + kitchenspeak. typefix-zero is registered as status = "proposed" only (its repo doesn't exist yet). Database/type-theory estates (VCL-total, KRL stack, Quandledb, TypeLL, PanLL, VQL/GQL/FBQL-DT, a2ml, k9-svc) stay out, listed for discoverability only.

What changed

  • languages/ — new pointer files for error-lang, tangle, kitchenspeak; 007.md gets an invariant + index-only boilerplate; README invariant table now 15 rows.
  • .machine_readable/LANGUAGES.a2ml — rewritten to a single [[language]] schema (all 15 + typefix-zero proposed); the legacy commented s-expression blob dropped (recoverable from git history).
  • ECOSYSTEM.a2ml, 0-AI-MANIFEST.a2ml, boundary hook LANGS — add haec + 007. The hook change closes a real gap: a re-vendored haec/ or 007/ root dir now fails the coordinator-boundary CI check.
  • Intentfile.a2ml — fixes a factual bug (my-lang's Solo/Duet/Ensemble dialects were attributed to affinescript) and backfills 6 missing entries.
  • TOOLING-STATUS.adoc — retires me-dialect across grade/tooling/BoJ tables (superseded by the Me projection); adds a 007 row; drops the duplicate Anvomidav meta-project; splits the 5 DB/type-theory rows into an "Adjacent estates" section; fixes the language count, the "4 dialects" error, the false "refreshed by tracker" claim, and the stale 7-Tentacles name.
  • portfolio, wiki/Home, tracker.jl, STATE.a2ml, TEST-NEEDS.md — same convergence; disambiguates Tangle from the KRL stack; removes the 7-tentacles-as-language row (canon violation); corrects STATE's false Mustfile claim.

Judgment calls worth a look

  • Dropped the 375-line legacy blob in LANGUAGES.a2ml rather than keeping it inline (it's marked "do not parse", is corrupted, and git preserves it). Easy to reinstate if you'd rather archive it under docs/.
  • Invariant wording for 007, error-lang, kitchenspeak was synthesized from existing prose (no canonical one-liner existed in-repo) — please adjust to your phrasing if needed.
  • Tangle vs KRL: treated as one topological language (Tangle) whose IR feeds a separate, out-of-scope KRL resolution stack, per docs/identity-fabric/musts-intends-wishes.adoc and docs/AFFIRMATION.adoc.

Deliberately deferred (follow-ups)

  • Me-as-language prose drift in README.adoc and the wiki/ subpages (tutorials/tooling/overview still treat Me as a peer language).
  • Stale monorepo manifests: stapeln.toml, opsm.toml, CLADE.a2ml, PANIC-ATTACK-TRIAGE.adoc, TOPOLOGY.md still declare a monorepo — that needs a decision (delete vs. rewrite as multi-repo orchestration).

Verification

  • bash hooks/validate-coordinator-boundary.shOK.
  • grep -c '^\[\[language\]\]' .machine_readable/LANGUAGES.a2ml16 (15 + proposed).
  • languages/*.md = 15 pointers; README table = 15 rows; hook LANGS = 15; Intentfile family = 15; ECOSYSTEM [language-repos] = 15.
  • TOML parse of the rewritten a2ml could not be machine-checked (no deno in this environment); the stanzas mirror the previously-valid haec entry.

🤖 Generated with Claude Code


Generated by Claude Code

claude added 5 commits July 3, 2026 01:30
Adds the three family languages that were tracked on ~8 other surfaces but
had no thin pointer file (error-lang, tangle, kitchenspeak), following the
existing languages/*.md convention. Adds an invariant blockquote and the
index-only boilerplate to 007.md, and adds all four to the README invariant
table (now 15 rows). Tangle's pointer disambiguates the language from the
separate KRL resolution stack whose IR it feeds.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K
The structured registry held only two entries in two incompatible schemas
(kitchenspeak as [languages.*] table, haec as [[language]] stanza); every
other language existed only in a corrupted, commented "do not parse"
s-expression blob that still modelled Solo/Duet/Ensemble as top-level
languages and claimed "eight languages".

Rewrites the file to a single [[language]] array-of-tables covering all 14
family languages + the KitchenSpeak DSL, plus typefix-zero as
status="proposed". Drops the legacy blob (recoverable from git history) and
records the scope boundary (database/type-theory estates stay out).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K
Adds haec and 007 to ECOSYSTEM.a2ml [language-repos], the 0-AI-MANIFEST
family list, and the boundary hook's LANGS guard (so a re-vendored haec/ or
007/ root dir now fails the coordinator-boundary CI check instead of passing).
007 is noted as the sole non-hyperpolymath, private, index-only exception.

Fixes the Intentfile bug that attributed my-lang's Solo/Duet/Ensemble
dialects to affinescript, and backfills the six missing family entries.
Corrects STATE.a2ml's false claim that KitchenSpeak was registered in the
Mustfile, and records this reconciliation.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K
- Marks Me-dialect retired in the grade matrix, tooling matrix, and BoJ ID
  table (superseded by the Me runtime projection; slot 11 kept as positional).
- Adds a 007 grade row; drops the duplicate Anvomidav meta-project bullet
  (it is already a language row).
- Moves the five out-of-scope database/type-theory rows (VCL-total, KRL,
  Quandledb, TypeLL, PanLL) into a new "Adjacent estates" subsection, and
  distinguishes the KRL resolution language from the Tangle language.
- Fixes the overview count (15 family entries, not "12 + 2"), the "my has 4
  dialects" error (3; Me is a projection), the false "refreshed by
  language-status-tracker.jl" claim, and renames 7-Tentacles to
  tentacles-agentic-syllabus (not a language).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K
- portfolio: adds 007, disambiguates "Tangle (KRL)" -> Tangle, adds a
  Proposed subsection for typefix-zero.
- wiki/Home external-repos table: adds haec and 007, fixes the Tangle row.
- language-status-tracker.jl: adds haec/tangle/007/kitchenspeak, corrects the
  wrong "Core 8" comment, and drops the fqldt/a2ml/k9-svc quasi-languages
  (adjacent estates, out of scope).
- TEST-NEEDS.md: removes the 7-tentacles-as-language row (canon violation)
  and annotates the stale in-tree counts as historical.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K
@sonarqubecloud

sonarqubecloud Bot commented Jul 3, 2026

Copy link
Copy Markdown

@hyperpolymath hyperpolymath marked this pull request as ready for review July 3, 2026 01:38
@hyperpolymath hyperpolymath merged commit 876d2b9 into main Jul 3, 2026
23 checks passed
@hyperpolymath hyperpolymath deleted the claude/explore-repo-languages-xkrc46 branch July 3, 2026 01:38
hyperpolymath added a commit that referenced this pull request Jul 9, 2026
…nder-review (#113)

## Context

Two follow-ups deferred from the registry reconciliation (#106, merged).
Both are
documentation/registry-only.

## 1. Stop framing *Me* as a peer dialect/language

Canon: the My-Lang dialects are three and nested (Solo ⊂ Duet ⊂
Ensemble); **Me** is an
agent-generated *projection* over that hierarchy, not a fourth dialect
(specified in
`tentacles-agentic-syllabus/me`). Several active-surface pages still
listed Me alongside the
dialects. Reworded:

- `README.adoc` — the `My Language (Me / Solo / Duet / Ensemble)`
heading → `My-Lang (Solo ⊂ Duet ⊂ Ensemble)` with a projection note.
- `wiki/Home.md` — "Educational progression: Me → Solo → …" → dialect
progression with Me called out as a projection.
- `wiki/overview/Choosing-a-Language.md` — the by-age table now labels
Me *(projection)* and adds a clarifying note; "Start with Me or Solo" →
"the Me projection or Solo".
- `wiki/contributing/How-to-Contribute.md` — repo map cell
`Me/Solo/Duet/Ensemble` → `Solo/Duet/Ensemble dialects (+ the Me
projection)`.
-
`wiki/tooling/{Parser-Architecture,Interpreter-Implementation,REPL-Guide}.md`
— passing "Me, Solo" language references reworded.

Left untouched: `extraction-queue/**` copies (already carry corrective
notes and are staged
for landing in the my-lang repo) and the dated historical audit report.

## 2. typefix-zero — private + viability under review

The repo **exists but is private** with uncertain viability, so the
earlier
"proposed / repo not yet created" framing was wrong. Now recorded
index-only (no public link,
same pattern as 007):

- `.machine_readable/LANGUAGES.a2ml` — stanza now `visibility =
"private"`, `status = "exploratory"`, note says viability under review;
public `hyperpolymath/typefix-zero` URL removed.
- `docs/language-portfolio.md` — "Proposed (repo not yet created)"
section → "Exploratory (private; viability under review)".
- `EXTRACTION-MANIFEST.md` — staged-spec row updated (land in the
private repo if/when viability is confirmed).
- Small accuracy touch-up to the **007** note: held back pending further
safety/guardrail testing (release pending), per maintainer.

## Verification

- `bash hooks/validate-coordinator-boundary.sh` → **OK**.
- `grep -c '^\[\[language\]\]' .machine_readable/LANGUAGES.a2ml` →
**16** (unchanged; typefix-zero re-characterised, not added/removed).
- No language list changed — this PR only re-characterises typefix-zero
and rewords Me prose.

## Still parked (needs your decision)

The stale **monorepo manifests** (`stapeln.toml`, `opsm.toml`,
`.machine_readable/CLADE.a2ml`,
`PANIC-ATTACK-TRIAGE.adoc`, `TOPOLOGY.md`) still describe an in-tree
monorepo. Deferred pending
a decision: **delete** them, or **rewrite** as multi-repo orchestration.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K

---
_Generated by [Claude
Code](https://claude.ai/code/session_016t5KLJDtqdeDi1EMNqNx6K)_

---------

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants