164 lines
6.4 KiB
YAML
164 lines
6.4 KiB
YAML
project:
|
|
name: Weksa
|
|
status: scaffolded
|
|
phase: state_spine
|
|
premise: >
|
|
Build a procedural language engine that generates alien languages from
|
|
explicit concepts, cultural constraints, grammar, phonology, morphology,
|
|
and diachronic history instead of direct English word substitution.
|
|
|
|
objective:
|
|
primary: >
|
|
Create a durable workspace where Weksa can develop from a persistent map
|
|
before runtime architecture decisions are made.
|
|
current: >
|
|
Establish the language-neutral state spine ported from the EpiphanyAgent
|
|
pattern: canonical map, scratch surface, schema receipts, and pipeline
|
|
documentation.
|
|
|
|
constraints:
|
|
- Runtime implementation language is undecided.
|
|
- Do not add framework, package, build, CLI, or service scaffolding until the
|
|
architecture earns it.
|
|
- Neural models may decompose, suggest, generate, and critique; they do not
|
|
own the canonical language state.
|
|
- Runtime should accept structured meaning and compiled project data; required
|
|
hot-path rendering must not depend on arbitrary English interpretation or
|
|
live LLM calls.
|
|
- Setting-specific projects may pressure the engine, but their ontology must
|
|
not become generic Weksa doctrine.
|
|
- Explicit project state must distinguish durable decisions from scratch.
|
|
- Avoid direct English-to-alien word replacement as the core design.
|
|
|
|
invariants:
|
|
- Ontology owns meaning.
|
|
- Grammar owns required expression.
|
|
- Phonology owns sound shape.
|
|
- Morphology owns derivation, inflection, compounding, and root families.
|
|
- Diachrony owns historical distortion, semantic drift, register split, loan
|
|
strata, and irregularity.
|
|
- Renderer owns surface text and glosses from already-structured meaning.
|
|
- Persistent state owns durable maps, accepted decisions, open questions,
|
|
evidence, and working memory.
|
|
- Scratch is disposable; the map is slow-changing.
|
|
|
|
data_flow:
|
|
observe:
|
|
- source utterance
|
|
- translation context
|
|
- world model
|
|
- existing language project state
|
|
process:
|
|
- decompose source into structured interlingua
|
|
- apply alien ontology and cultural salience
|
|
- select grammatical commitments
|
|
- derive morphology and lexical families
|
|
- apply phonological constraints
|
|
- apply diachronic history
|
|
- render surface alien text, gloss, and explanation
|
|
cut:
|
|
- remove stages that do not own a clear invariant
|
|
- reject generic adapters until a real external boundary exists
|
|
- keep model prompts as replaceable tools, not hidden sources of truth
|
|
|
|
pipeline:
|
|
stages:
|
|
- id: source-input
|
|
title: Source Input
|
|
owns: raw utterance and context
|
|
emits: source packet
|
|
invariant: input text remains recoverable as evidence
|
|
- id: interlingua
|
|
title: Meaning Interlingua
|
|
owns: structured semantic representation
|
|
emits: concept/event graph
|
|
invariant: meaning is explicit before alien rendering
|
|
- id: ontology
|
|
title: Alien Ontology
|
|
owns: concept splits, collapses, salience, and worldview pressure
|
|
emits: alien concept frame
|
|
invariant: alien worldview decides which distinctions matter
|
|
- id: grammar
|
|
title: Grammar
|
|
owns: required expression, syntax, agreement, and clause structure
|
|
emits: grammatical plan
|
|
invariant: surface output carries required commitments
|
|
- id: morphology
|
|
title: Morphology
|
|
owns: roots, derivation, inflection, compounds, and families
|
|
emits: morpheme plan
|
|
invariant: related forms remain related for a reason
|
|
- id: phonology
|
|
title: Phonology
|
|
owns: legal sounds, syllables, phonotactics, and prosody
|
|
emits: legal proto-forms
|
|
invariant: generated forms belong to one sound system
|
|
- id: diachrony
|
|
title: Diachrony
|
|
owns: historical sound change, semantic drift, registers, loans, scars
|
|
emits: attested forms
|
|
invariant: plausible irregularity comes from history, not decoration
|
|
- id: renderer
|
|
title: Renderer
|
|
owns: surface alien text, glosses, and analysis output
|
|
emits: final translation packet
|
|
invariant: rendering does not invent meaning
|
|
edges:
|
|
- source: source-input
|
|
target: interlingua
|
|
carries: source packet
|
|
- source: interlingua
|
|
target: ontology
|
|
carries: concept/event graph
|
|
- source: ontology
|
|
target: grammar
|
|
carries: alien concept frame
|
|
- source: grammar
|
|
target: morphology
|
|
carries: grammatical plan
|
|
- source: morphology
|
|
target: phonology
|
|
carries: morpheme plan
|
|
- source: phonology
|
|
target: diachrony
|
|
carries: legal proto-forms
|
|
- source: diachrony
|
|
target: renderer
|
|
carries: attested forms
|
|
|
|
accepted_design:
|
|
- Weksa starts with a language-neutral persistent state spine rather than a
|
|
runtime scaffold.
|
|
- The EpiphanyAgent pattern is ported as architecture discipline, not as Rust
|
|
code or product-specific organs.
|
|
- The first model is concept-first translation through an explicit
|
|
interlingua, ontology, grammar, morphology, phonology, diachrony, and
|
|
renderer pipeline.
|
|
- Weksa is the engine. A language project owns one constructed language.
|
|
Setting docs own story, species, culture, and use cases.
|
|
- Rust to Dust is the first proving ground, not engine doctrine.
|
|
- Time-sensitive runtime paths should be deterministic and LLM-free.
|
|
Model-assisted decomposition, generation, and critique belong in authoring
|
|
or offline workflows.
|
|
- `docs/best-modern-approach.md` is the current doctrine for conceptual
|
|
ontology, root generation, morphology, syntax, lexical semantics,
|
|
interlingua, diachrony, and model-assisted consistency.
|
|
|
|
open_questions:
|
|
- Which implementation language best serves the first usable engine?
|
|
- What format should language projects use for ontology, grammar, phonology,
|
|
morphology, and diachrony definitions?
|
|
- What compiled runtime bundle format keeps game-time rendering fast and
|
|
inspectable?
|
|
- Which model provider and embedding strategy should be used for offline
|
|
semantic decomposition and critique?
|
|
- How much deterministic validation belongs in v0?
|
|
- What is the minimal Rust to Dust language-project slice that proves the
|
|
engine without hard-coding the setting into it?
|
|
|
|
landed_baseline:
|
|
- Language-neutral state spine.
|
|
- Canonical pipeline map.
|
|
- Scratch surface.
|
|
- Schema receipt docs.
|
|
- Rust to Dust setting documentation skeleton.
|