SOTER Manuals — Documentation Portal (MVP Release)

Welcome to SOTER (Symbiotic Ontology Transformations Enterprise Runtime). SOTER MVP is a local-first enterprise architecture engine that validates Logos models, runs local semantic checks, and tracks observed business events via a cryptographic filesystem ledger.

Please select the guide relevant to your work:

📖 SOTER MVP Guides

1. 🎨 Analyst Manual (MvpManualAnalyst.md)

• Target Audience: Enterprise architects, business analysts, and process owners.
• Topics Covered: Logos DSL syntax, SVO (Subject-Verb-Object) ontology, gateways (XOR, AND, OR), modular design (include, show), strict mode validation rules, and domain-specific vocabulary aliases.

2. 🛠️ SOTER MVP & CLI Guide (SOTER_MVP.md)

• Target Audience: System engineers, architects, and operators working with SOTER MVP.
• Topics Covered: Local-first architecture, SOTER CLI commands (validate, fact validate, verify, ledger), filesystem-only cryptographic ledger format, and language configurations.

3. ⚙️ Pyrefly Linter Setup (MvpPyreflyLinterSetup.md)

• Target Audience: Developers and analysts setting up local validation checks.
• Topics Covered: Pyrefly linter configuration, VS Code styling highlights, and code quality standards.

4. 💡 Quickstart (MvpQuickstart.md)

• Target Audience: Everyone starting with SOTER CLI.
• Topics Covered: Verifying a model, validating fact files, and recording facts into the ledger.

5. 🔍 Troubleshooting (MvpTroubleshooting.md)

• Target Audience: Anyone troubleshooting local CLI issues.
• Topics Covered: Syntactic errors, CLI language resolution issues, and filesystem ledger verification failures.