Brummel
832375f2ac
All 176 files in the four accumulating directories now use a zero-padded 4-digit counter prefix that reflects creation order (`NNNN-slug.md`). The counter is assigned per directory in strict git-log creation order; ties broken alphabetically by original name. The old `YYYY-MM-DD-` prefix on docs/specs/ and docs/plans/ files is dropped — the date is recoverable from git log and the counter carries the ordering. A file's counter is stable for the life of the file: never reassigned, never reused, never compacted. Deleted files retire their counter; subsequent files do not fill the gap. This is the property that lets cross-references stay literal — refs use the full filename including the counter (`design/contracts/0007-honesty-rule.md`) so they grep cleanly and resolve directly without a glob step. 313 cross-references updated across .md/.rs/.toml/.c/.json files (test pins, include_str! paths, design-INDEX entries, baseline notes, runtime C comments, inter-contract markdown links incl. bare basename and `../models/foo.md` forms). CLAUDE.md gets a new "File-naming convention" section spelling out the rule and rationale. skills/brainstorm/SKILL.md and skills/planner/SKILL.md updated so new spec/plan creation produces counter-prefixed names from the start. The full test suite (cargo test --workspace) passes.
22 lines
1.1 KiB
Markdown
22 lines
1.1 KiB
Markdown
# Effects — pure core + algebraic effects
|
|
|
|
## Pure core language + algebraic effects
|
|
|
|
The default is total, pure functions. Effects are declared as a set in the
|
|
function type: `(Int) -> Int ![IO]`. The effect set is a
|
|
flat, unordered, closed set of effect names, unified by set-equality —
|
|
there is no effect row variable; a signature lists exactly the effects
|
|
its body may perform. The schema-level effect-set field on `Type::Fn`
|
|
is documented in [Data model](../contracts/0002-data-model.md); what is
|
|
currently in scope vs. excluded lives in
|
|
[scope boundaries](../contracts/0010-scope-boundaries.md).
|
|
In the MVP only the effect `IO` is wired up (its sole op is `io/print_str`).
|
|
`Diverge` (for non-termination) is reserved as an effect name but is
|
|
unimplemented — no op, no codegen, no checker injection — in the same
|
|
sense the refinements layer is reserved as a future extension without
|
|
present-day surface (see
|
|
[scope boundaries](../contracts/0010-scope-boundaries.md)).
|
|
|
|
This is the most important LLM property: when I read a function, I can trust
|
|
its signature without reading the body.
|