Skip to content

Loud errors: a name bound nowhere is never read silently - #25

Open
alakanani wants to merge 1 commit into
mainfrom
loud-errors-2026-11
Open

alakanani wants to merge 1 commit into
mainfrom
loud-errors-2026-11

Conversation

@alakanani

Copy link
Copy Markdown
Collaborator

Build 2 of the 90-day plan. The founder gave the green light for this language change and chose the syntax herself on 2026-11-17: bare words used on purpose are written :worthy.

The change

  • Explicit symbols. :name is a Symbol literal in the lexer, parser, interpreter, and formatter. The mark is punctuation, not a keyword, so it speaks the same in every tongue, and godcode fmt round-trips it into canonical English.
  • Loud unbound names. Reading a name that was never declared stops the run: "There is no 'worhty' in this creation. It was never spoken into being. DECLARE it first, or, if the bare word itself is meant, mark it as one: :worhty", with a did-you-mean toward the nearest declared name when one stands near. Unknown rite calls keep their existing gentle error.
  • check --json is unchanged. It still answers only whether the scroll parses (the frozen schema keeps its meaning). The linter's GC002 counsel walks beside the new law: lint speaks first and gently, the engine speaks at the read and firmly.

Migration

Everything that leaned on the old silence was migrated and verified by running: examples/psalm_of_creation.god, examples/lots.god, the root sample, the Setswana and isiZulu IF snippets, both playground lite engines (ported to the same law and tested headless in node), the site learn, landing and demos pages, the skill pack, and the doc examples. The spec's static meaning layer states the new law (ST-14 and its kin), test-kept as before. The playground engine bundle is rebuilt.

Proof

The scroll DECLARE seeker AS "worthy" / IF seeker IS worhty THEN ran ok: true, exit 0 under the old law. It now returns ok: false, exit 1, error at line 3 naming worhty. The same scroll with DECLARE seeker AS :worthy and IS :worthy runs clean and reveals enter.

Tests: 1066 passed before, 1088 passed after, 0 failed. Every scroll in examples/ runs under run --sandbox exactly as before, except the two migrated ones, which now run under the new law (the five sandbox-grant, registry and plugin demos fail identically on main, untouched by this change).

This is a breaking change with a one-character migration, named plainly in the CHANGELOG: worthy becomes :worthy.

Build 2 of the 90-day plan, with the founder's chosen syntax. Reading a
name that was never declared now stops the run with a gentle error that
names the name and offers the two honest fixes: DECLARE it first, or
mark the bare word as one, :name. A did-you-mean rides along when a
declared name stands near the misspelling. Unknown rite calls keep
their existing gentle error.

The explicit symbol: :name is a Symbol literal in the lexer, parser,
interpreter, and formatter. The mark is punctuation, not a keyword, so
it speaks the same in every tongue, and godcode fmt round-trips it.
check --json is unchanged: it still answers only whether a scroll
parses; the linter's GC002 counsel walks beside the new law.

Migration, all verified by running: examples/psalm_of_creation.god and
examples/lots.god, the root sample, the Setswana and isiZulu IF
snippets, the playground lite engines (both copies, ported to the same
law and tested headless in node), the site learn, landing and demos
pages, the skill pack, and every doc example that leaned on the old
silence. The spec's static meaning layer states the new law (ST-14 and
its kin), test-kept as before. Tests that asserted the silent behaviour
now assert the loud one; tests/test_loud_errors.py carries the new
coverage. The playground engine bundle is rebuilt.
@vercel

vercel Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
godcode Ready Ready Preview Nov 17, 2026 6:50pm UTC

This branch was successfully deployed

1 active deployment
Preview — 47445f07 Deployed Nov 17, 2026 by vercel[bot]
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