GameCult/Weksa
Watch
9
0
Fork
You've already forked Weksa
 0
Code Issues Pull requests 2 Projects Releases Packages Wiki Activity Actions
Weksa/schemas/README.md
Meta Vens 743f3aabe2 Define nested cultural ontology profile state
2026-06-09 16:40:31 +01:00

2.4 KiB
Raw Permalink Blame History

Schemas

This folder records Weksa's persistent state contracts in human language.

The repo deliberately starts without general executable schema code. Runtime language, storage backend, and generated type targets are undecided. Until those decisions are made, this folder is the receipt surface: if a state shape matters enough to steer the machine, describe its authority here.

Narrow fixture validators may exist when an external handoff needs an executable proof. They do not become the schema authority unless the map explicitly promotes them.

Canonical Surfaces

  • project-state.md: project map, scratch, decisions, evidence, and open questions.
  • language-project-state.md: future per-language state for ontology, grammar, morphology, phonology, diachrony, and renderer configuration.
  • interlingua-packet.md: shared meaning packet contract between clients, authoring tools, and language projects.
  • utterance-lowering-packet.md: shared packet contract for lowering interlingua and projected speaker context into one or more target-language utterance realizations.
  • target-language-cultural-ontology.md: contract for the address, politeness, register, idiom, metaphor, script, and forbidden-flattening profiles consumed by target lowerers.
  • cultural-ontology-profile.md: nested CultCache profile contract for cultural ontology, including typed salience axes, linguistic affordance feature records, evidence, activation gates, and lowering traces.
  • english-lowering-packet.md: packet contract for the older English-specific realization lane.
  • english-pronunciation-plan.md: plan for stringing flavored English into IPA/phoneme sequences before downstream speech.
  • utterance-embedding-handoff.md: learned utterance embedding handoff contract for handing prosody, emphasis, and character pressure to downstream synth control.

Source Of Truth

  • state/map.yaml is the canonical live map for this workspace.
  • state/scratch.md is temporary working memory.
  • schemas/ explains the contracts.
  • Future executable schemas must be generated from or reconciled with these receipts in the same pass that introduces them.