concept reference
The small vocabulary needed to discuss Simmis precisely, plus a map of which component does what.
core vocabulary
- Basis
- The exact version of accepted managed state from which a task or branch begins.
- Branch
- Isolated, copy-on-write state that can diverge from its basis without changing the parent.
- Composite branch
- A branch that coordinates versioned knowledge, files, and relevant execution context from one basis.
- Team and room
- A Team is the persistent product context for people, agents, shared material, and history. A room is its Dvergr runtime context.
- Accepted managed state / main
- The currently accepted state managed by Simmis. Developer interfaces may call the branch
main. - Proposal
- A branch packaged for review with its changes, rationale, provenance, and cost.
- Semantic diff
- A description for reviewers of what meaningfully changed across facts, files, or outputs.
- Provenance
- The chain connecting an output to its basis, agent, tools, sources, and run history.
- Merge and discard
- The review decision determines whether to merge a proposal into accepted managed state or discard the attempt without changing its parent.
component map
| Component | Responsibility | Plain language outcome |
|---|---|---|
| Simmis | Product, shared work, proposals, review | Attempts remain separate from accepted managed state until an authorized decision makes them official. |
| Spindel | Reactive interface and execution context | Live work keeps the context needed to explain and resume it. |
| Dvergr | Rooms, agents, tools, schedules, budgets | An agent works inside explicit operational bounds. |
| Kabel + Yggdrasil | Synchronization and composite branching | An attempt can diverge without quietly changing its parent. |
| Datahike + Konserve | Versioned knowledge and durable storage | Shared memory keeps history instead of overwriting it. |
Lean in a JVM application
Java and Clojure applications can call Lean functions using the optional Ansatz Lean/JVM SDK. The 0.2.615 release supports prepared artifacts, typed host bindings and loading from built Lake workspaces within its documented runtime profile. Its guide covers preparation, deployment and compatibility limits. This is an independently released library and does not require the Simmis application.
how status words are used
- Working now means the capability exists in the current system, although documented limits may remain.
- In progress means active product work. Do not plan as though it has shipped.
- Planned means intended work that is not yet in active delivery.
- Research explains design intent, not a product commitment.
simmis