chore: scaffold monorepo + AI harness (constitution, rules, glossary, kernel stub)

1 files changed, 27 insertions, 0 deletions

diff --git a/GLOSSARY.md b/GLOSSARY.md
new file mode 100644
index 0000000..4d70e0e
--- /dev/null
+++ b/GLOSSARY.md
@@ -0,0 +1,27 @@
+# Glossary — canonical vocabulary
+
+> One name per concept. Never invent a synonym. New term? The orchestrator
+> proposes the standard/training-baked name and the user confirms before it lands
+> here. "Aliases to avoid" maps wrong names back to the canonical one.
+
+| Term | Meaning | Aliases to avoid |
+|---|---|---|
+| **kernel** | The minimal runtime core: contracts, extension host, turn loop, event/hook bus. Touches no I/O, names no feature. NOT an extension. | core (when meaning the runtime), engine |
+| **core** (tier) | The extension tier required to complete one turn end-to-end ("minimal Dispatch"). | — |
+| **standard** (tier) | Extension tier shipped on-by-default; the features people think of as Dispatch. | — |
+| **extension** | A unit that contributes capabilities via the Host API: tools, providers, auth, hooks, routes, services, migrations. | plugin, module (when meaning an extension) |
+| **contract** | An extension's typed, exported surface: what it exposes + what it requires. The ONLY thing other units see. | interface (when meaning the whole surface), API |
+| **manifest** | An extension's declaration: id, version, apiVersion, dependsOn, contributions, capabilities, trust. | — |
+| **Host API** | The object an extension receives in `activate(host)`. | host context |
+| **turn** | One user message → assistant response cycle (may span multiple steps). | — |
+| **step** | One LLM round-trip within a turn (may emit multiple tool calls). | iteration |
+| **tool call** | A model's request to run a tool within a step. | function call (when meaning a tool call) |
+| **chunk** | One ordered piece of a message (text, thinking, tool-call/result, etc.), append-only in the log. | block, segment |
+| **runTurn** | The kernel's turn loop: takes provider + messages + tools + dispatch policy, streams, dispatches tools, emits events. | run, agentLoop |
+| **hook** | A typed extension point. **event** = fire-and-forget, N listeners, error-isolated. **filter** = ordered value-in→value-out chain, in-band. | callback (when meaning a hook), listener |
+| **service** | A single-responder request/response capability fetched via a typed handle. NOT a hook. | — |
+| **dispatch policy** | `{ maxConcurrent, eager }` controlling how the turn loop runs a step's tool calls. | — |
+| **reconcile** | The pure function run on load that repairs a partial/interrupted turn into a valid history. | recover, repair |
+| **session-orchestrator** | The core extension that drives a turn: load history → resolve provider/tools → call `runTurn` → persist. | — |
+| **conversation-store** | The core extension persisting the append-only turn/chunk log. | message store |
+| **provider** | An extension wrapping an LLM backend (`stream(messages, tools)`), provider-agnostic to the kernel. | — |