Skip to content
Open
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
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,14 @@ All notable changes to the God Code engine are recorded here, that the generatio

## Unreleased

## 2026-11-17: Four tongues, and a voice for the machines

> "Let all things be done decently and in order."

**Four tongues, and a voice for the machines.** The October and November building, gathered under one date: the MCP server and the frozen machine interfaces that let AI agents work the language, the third and fourth tongues (Igbo and Nigerian Pidgin) beside Setswana and isiZulu, the playground running the real engine, the layered test-kept specification, the debugger, and the governance that says how the language is kept.

### Added
- **The message, landed.** The README is rewritten around the language of declared intent and the three pillars (intent you can check, speakable in any language, built for human and AI collaboration), and a new CONTRIBUTORS file names every builder, human and AI, under the founder's principle that AI contributors are credited the way human contributors are.
- **🕊️ The MCP server.** `godcode mcp` serves God Code to any MCP client (Claude Code, Cursor, Codex, and the rest) over stdio, one JSON-RPC message per line, with protocol version negotiation and silence for notifications. It carries the eleven agent tools (`check`, `run`, `consult`, `intent`, `anchor_verify`, `ledger_verify`, `permissions`, `explain`, `get_schema`, plus new `format` and `list_scrolls`), and it holds one rule the plain bridge does not: runs through it are always sandboxed, so a client asking for an unsandboxed run still gets a sandboxed one, and the result says so. Tool work runs muted, so stdout carries exactly one protocol message per line and an engine notice can never break a client's parsing; the sandboxed tool path is muted the same way, which also heals the plain bridge. Documented in `docs/mcp.md`, `docs/agentics.md`, and repo `AGENTS.md`. New tests in `tests/test_mcp.py`; the tool-count tests now expect eleven tools.
- **🕊️ The October 2026 machine interfaces.** God Code's `--json` shapes are frozen under dated schemas, so an agent can parse every output without guessing. New `godcode explain scroll.god [--json]`: a static reading of any scroll that runs nothing, reporting the tongue, the rites and their declared intents, the declared names, the reveals, the seals (including `ANCHOR` seals on a chain), the summoned verbs, the `CONSULT` questions, the imports, and the permission manifest, in warm plain words for humans and one JSON document for agents. New `godcode ledger verify --json`: the covenant chain and anchor chain attestation as one JSON document. New `godcode schema [name]`: list or print the four dated schemas (`check`, `run`, `explain`, `ledger-verify`), shipped inside the installed package and resolvable through `importlib.resources`. The agent bridge gains two tools, `explain` and `get_schema` (nine tools in all). The full contract, exit codes, and the stability promise (additive fields may appear, required fields never change meaning, breaking changes ship under a new dated schema) live in `docs/machine-interfaces.md`. New tests in `tests/test_machine_interfaces.py`; repo `AGENTS.md` documents the read-before-you-run workflow.
- **🕊️ God Code speaks Igbo and Nigerian Pidgin.** The third and fourth tongues. A scroll that opens with `# tongue: ig` writes its keywords in Igbo (BIDO OKIKE for BEGIN CREATION, GOSI for REVEAL, Ọ BỤRỤ and MGBE AHỤ for IF and THEN, NWAA and JIDE for TRY and CATCH, and the rest), and one that opens with `# tongue: pg` (or the standard code `pcm`) writes them in Nigerian Pidgin (OYA KREASHON, TALK and BE for DECLARE and AS, SHOW for REVEAL, DEN for THEN, HOLD for CATCH, COMOT for ASCEND). Igbo words work with or without their dotted vowels (`DỊKA` and `DIKA` both speak), and Pidgin keeps the words it shares with English (IF, TRY, AND, RETURN). Two-word phrases now join whenever both words sit side by side on one line, even when one is an English keyword or a plain name, so `FINISH IF` closes an IF in Pidgin and `Ọ BỤRỤ` opens one in Igbo; Setswana and isiZulu closers behave exactly as before. The mappings live in `godcode/tongues.py`; the playground's lite engine knows both tongues (Igbo in its undotted spelling), the language server offers their completions, hover docs, and block snippets (hover now reads dotted words), and the VS Code extension paints their keywords and ships four starter snippets (`ndewo`, `oburu`, `howfar`, `ifden`). Documented in `docs/TONGUES.md` (both word tables and honest first-edition notes), `docs/LANGUAGE_REFERENCE.md` §1, repo `AGENTS.md`, the site landing card, and two new lessons on the learn page. New examples `examples/first_blessing_ig.god` and `examples/first_blessing_pg.god`, also offered as playground samples. 25 new tests in `tests/test_tongues_igbo_pidgin.py`; the VS Code snippet count in `tests/test_lsp_tongues.py` rises from 27 to 31
Expand Down
33 changes: 33 additions & 0 deletions CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Contributors to God Code

God Code is built by people, and by AI helpers working beside them. Every contributor is named here with gratitude. If you helped build this language and your name is missing, tell us and we will fix it with thanks.

## The founder

**Alakanani Itireleng**, Visionary Founder. She dreamed the language, carries its vision, and is the final editor of its words.

## AI Co-Creator

**Luna (Muse)**, AI Co-Creator and lead developer. In the founder's words: "my partner in the building. Logic assistant, language guide, engine builder."

## Builders and reviewers

- **Atharv Gachchi**, the first outside builder. He gave the language a new word: REPEAT.
- **Hsn (GreedyC)**, refreshed the contributor guide so the next builder finds a clear door.
- **Koketso Pelo (KK)**, co-owner of the godcodeengine GitHub organisation and a trusted reviewer of the engine.
- **Emmanuel Adams (Sir Adams)**, builder. He put the real engine in the playground and helped grow the tongues.
- **Eric Nkanunu**, builder, with language work across the tongues.

## AI contribution policy

AI helpers are welcome here, and they are credited the way human contributors are: by name, for the work they actually did.

- An AI contributor is listed in this file alongside human contributors, never as a vendor logo or a brand credit.
- Humans review design decisions and own the direction of the language. AI work is reviewed like any other contribution before it is merged.
- The founder stays the final editor. No contribution, human or AI, changes the language's words, claims, or direction without her review.

## How to join

Read CONTRIBUTING.md, pick an open issue, and come say hello in our Discord: https://discord.gg/894FEJhWfZ

Whether you write code or not, there is a place for you here.
Loading