website-htmx-rustelo-code/site/i18n/locales/en/pages/ontoref.ftl

ontoref-adoption-subtitle = ontoref setup wires up any new or existing project — idempotent scaffold with optional auth key bootstrap.
ontoref-adoption-title = Adopt in Any Project
ontoref-architecture-title = Architecture
ontoref-badge = Protocol + Runtime · v0.1.0
ontoref-crates-title = Crates & Tooling
ontoref-cta-explore = Explore the Protocol
ontoref-cta-subtitle = Start with ontoref setup. Your project gains machine-queryable invariants, living ADRs, actor-aware operational modes, and a daemon that shares context across every actor in real time.
ontoref-cta-title = Structure That Remembers Why
ontoref-duality-title = Ontology & Reflection — Yin and Yang
ontoref-footer-tagline = Protocol + Runtime. Zero enforcement. One graph per project.
ontoref-graph-desc = Force-directed graph of the live ontology. Nodes are typed (Axiom · Tension · Practice) and polarized (Yang · Yin · Spiral). Click any node to open its detail panel — artifacts, connections, NCL source.
ontoref-graph-title = The UI in Action -> Graph View
ontoref-hero-coda = Protocol + Runtime. Zero enforcement.
ontoref-hero-desc =  — encode what a system IS (invariants, tensions, constraints) and where it IS GOING (state dimensions, transition conditions, membranes) in machine-queryable directed acyclic graphs. Software projects, personal operational systems, agent contexts — same three files, same protocol. First-class web UI (12 pages), MCP server (19 tools), live session sharing. One protocol for developers, agents, CI, and individuals.
ontoref-hero-highlight = Ontology + Reflection + Daemon + MCP
ontoref-layer-adopt-desc = Each project maintains its own .ontology/ data. Ontoref provides the schemas, modules, and migration scripts. Zero lock-in.
ontoref-layer-adopt-label = ADOPTION LAYER · Per-project
ontoref-layer-decl-desc = Strong types, contracts, enums. Fails at definition time, not at runtime.
ontoref-layer-decl-label = DECLARATIVE LAYER · Nickel
ontoref-layer-entry-desc = Single entry point per project. Detects actor (developer/agent/CI), acquires lock, dispatches to correct Nu module.
ontoref-layer-entry-label = ENTRY POINT · Bash → Nu
ontoref-layer-graph-desc = The project knows what it knows. Actor-agnostic. Machine-queryable via nickel export.
ontoref-layer-graph-label = KNOWLEDGE GRAPH · .ontology/
ontoref-layer-op-desc = Typed pipelines over structured data. No text streams.
ontoref-layer-op-label = OPERATIONAL LAYER · Nushell
ontoref-layer-runtime-desc = Optional persistent daemon. NCL export cache, HTTP UI (12 pages), MCP server (19 tools), actor registry, notification store, search engine, SurrealDB persistence. Never a protocol requirement.
ontoref-layer-runtime-label = RUNTIME LAYER · Rust + axum
ontoref-mcp-backlog-desc = <li><strong>pre_commit</strong> — pre-commit hook POLLs <code>GET /notifications/pending?token=X&project=Y</code>; blocks git commit until all acked</li><li><strong>drift</strong> — schema drift detected between codebase and ontology</li><li><strong>ontology_drift</strong> — emitted by passive observer with missing/stale/drift/broken counts after 15s debounce</li><li>Fail-open: if daemon is unreachable, pre-commit hook passes — commits are never blocked by daemon downtime</li><li>Ack via UI or <code>POST /notifications/ack</code>; custom notifications via <code>POST /{slug}/notifications/emit</code></li><li>Action buttons in notifications can link to any dashboard page</li>
ontoref-mcp-backlog-title = Notification Barrier
ontoref-mcp-core-desc = ontoref-daemon is an optional persistent process. It caches NCL exports, serves 12 UI pages, exposes 19 MCP tools, maintains an actor registry, stores notifications, indexes everything for search, and optionally persists to SurrealDB. Auth is opt-in: all surfaces (CLI, UI, MCP) exchange a project key for a UUID v4 session token via <code>POST /sessions</code>; CLI injects <code>ONTOREF_TOKEN</code> as Bearer automatically. It never changes the protocol — it accelerates and shares access to it. Configured via <code>~/.config/ontoref/config.ncl</code> (Nickel, type-checked); edit interactively with <code>ontoref config-edit</code>. Started via NCL pipe bootstrap: <code>ontoref-daemon-boot</code>.
ontoref-mcp-knowledge-desc = <li>Enabled with <code>--db</code> feature flag and <code>--db-url ws://...</code></li><li>Connects via WebSocket at startup — 5s timeout, <strong>fail-open</strong> (daemon runs without it)</li><li>Seeds ontology tables from local NCL files on startup and on file changes</li><li>Persists: actor sessions, seeded ontology tables, search index, notification history</li><li>Without <code>--db</code>: DashMap-backed in-memory, process-lifetime only</li><li>Namespace configurable via <code>--db-namespace</code>; credentials via <code>--db-username/--db-password</code></li>
ontoref-mcp-knowledge-title = SurrealDB Persistence — Optional
ontoref-mcp-query-title = The MCP Server — 19 Tools
ontoref-mcp-table-desc-header = Description
ontoref-mcp-table-tool-header = Tool
ontoref-mcp-title = Daemon & MCP — Runtime Intelligence Layer
ontoref-mcp-tool-action-add-desc = Create reflection mode + register as quick action
ontoref-mcp-tool-action-list-desc = Quick actions catalog from .ontoref/config.ncl
ontoref-mcp-tool-backlog-desc = Add or update_status on a backlog item
ontoref-mcp-tool-constraints-desc = All hard + soft architectural constraints
ontoref-mcp-tool-describe-desc = Architecture overview and self-description
ontoref-mcp-tool-get-adr-desc = Full ADR content with constraints
ontoref-mcp-tool-get-backlog-desc = Backlog items filtered by status
ontoref-mcp-tool-get-desc = Fetch ontology node by id
ontoref-mcp-tool-get-mode-desc = Mode DAG contract — steps, preconditions, postconditions
ontoref-mcp-tool-get-node-desc = Full ontology node with edges and constraints
ontoref-mcp-tool-help-desc = List available tools and usage
ontoref-mcp-tool-list-adrs-desc = List ADRs filtered by status
ontoref-mcp-tool-list-modes-desc = List all reflection modes
ontoref-mcp-tool-list-projects-desc = Enumerate all registered projects
ontoref-mcp-tool-project-status-desc = Full project dashboard — health, drift, actors
ontoref-mcp-tool-qa-add-desc = Persist new Q&A entry to reflection/qa.ncl
ontoref-mcp-tool-qa-list-desc = List Q&A knowledge store with optional filter
ontoref-mcp-tool-search-desc = Free-text search across nodes, ADRs, modes
ontoref-mcp-tool-set-project-desc = Set session default project context
ontoref-metrics-title = Protocol Metrics
ontoref-page-subtitle = Self-Describing Protocol for<br>Evolving Systems
ontoref-page-title = Ontoref — A Self-Describing Ontology & Reflection Protocol
ontoref-problem-1-desc = <li>Architectural choices made in chat, forgotten after rotation</li><li>No machine-queryable source of why something exists</li><li>ADRs as typed Nickel: invariants, constraints, supersession chain</li><li>Hard constraints enforced at every operation</li>
ontoref-problem-1-title = Decisions Without Memory
ontoref-problem-2-desc = <li>Configs change outside any review cycle</li><li>No audit trail linking change to PR or ADR</li><li>Rollback requires manual file archaeology</li><li>Sealed profiles: sha256 hash, full history, verified rollback</li>
ontoref-problem-2-title = Invisible Configuration Drift
ontoref-problem-3-desc = <li>LLMs start each session with zero project knowledge</li><li>Same mistakes, same questions, no accumulation across operations</li><li>Actor registry tracks each session token, type, current mode, last seen — persisted to disk</li><li>MCP tools give agents direct DAG read/write: nodes, ADRs, backlog, Q&A</li><li>Composed tasks shared via daemon — multiple actors see the same operational context live</li>
ontoref-problem-3-title = Agents Without Context
ontoref-problem-4-desc = <li>Guidelines in wikis, patterns in docs, decisions in Slack</li><li>No single source queryable by humans, agents, and CI equally</li><li><code>.ontology/</code> separates three orthogonal concerns: <code>core.ncl</code> (what IS) · <code>state.ncl</code> (where we ARE vs want to BE) · <code>gate.ncl</code> (when READY to cross a boundary)</li><li><code>reflection/</code> reads all three and answers self-knowledge queries — an agent understands the project without reading code, only by consulting the declarative graph</li>
ontoref-problem-4-title = Scattered Project Knowledge
ontoref-problem-5-desc = <li>Each project re-invents its own conventions</li><li>No shared contract for how operations are defined and executed</li><li>Reflection modes: typed DAG contracts for any workflow</li><li>One protocol adopted per-project, without enforcing uniformity</li>
ontoref-problem-5-title = Protocol Fragmentation
ontoref-problem-6-desc = <li>Q&A answered in one session forgotten by the next</li><li>Agent re-asks questions already answered in previous sessions</li><li>Q&A Knowledge Store: typed NCL, git-versioned, persists across browser resets</li><li>Notification barrier surfaces drift to agents proactively — pre_commit, drift, ontology_drift signals block until acknowledged</li>
ontoref-problem-6-title = Knowledge Lost Between Sessions
ontoref-problem-7-desc = <li>Personal and professional decisions made against implicit, unverifiable assumptions</li><li>No queryable model of what you never compromise</li><li>No structured way to ask: does this opportunity violate who I am?</li><li>ontoref as personal operational ontology — same core/state/gate files applied to life, career, and ecosystem dimensions</li><li><code>jpl validate "accept offer"</code> → invariants_at_risk, relevant edges, verdict</li>
ontoref-problem-7-title = Decisions Without a Map
ontoref-problems-title = The 7 Problems It Solves
ontoref-tagline = Structure that remembers why
ontoref-tech-stack-title = Technology Stack
ontoref-tension-1 = Ontology without Reflection  =  correct but static.  Perfect invariants with no operations = dead documentation.
ontoref-tension-2 = Reflection without Ontology  =  fluid but unanchored.  Workflows that forget what they protect.
ontoref-tension-thesis = The protocol lives in coexistence.
ontoref-ui-dashboard-title = The Web UI — 12 Pages
ontoref-yang-desc = <li><strong>Modes</strong> — typed DAG workflow contracts (preconditions, steps, postconditions)</li><li><strong>Forms</strong> — parameter collection driving modes</li><li><strong>ADR lifecycle</strong> — Proposed → Accepted → Superseded, with constraint history</li><li><strong>Actors</strong> — developer / agent / CI, same protocol, different capabilities</li><li><strong>Config seals</strong> — sha256-sealed profiles, drift detection, rollback</li><li><strong>Quick Actions</strong> — runnable shortcuts over modes; configured in <code>.ontoref/config.ncl</code></li><li><strong>Passive Drift Observer</strong> — watches code changes, emits <code>ontology_drift</code> notifications with missing/stale/drift/broken counts</li>
ontoref-yang-sub = How things move and change
ontoref-yang-title = Yang — The Reflection Layer
ontoref-yin-desc = <li><strong>Invariants</strong> — axioms that cannot change without a new ADR</li><li><strong>Tensions</strong> — structural conflicts the project navigates, never resolves</li><li><strong>Practices</strong> — confirmed patterns with artifact paths to real files and declared ADR validators</li><li><strong>Gates</strong> — membranes controlling readiness thresholds</li><li><strong>Dimensions</strong> — current vs desired state, with transition conditions</li><li><strong>Q&A Knowledge Store</strong> — accumulated Q&A persisted to NCL, git-versioned, queryable by any actor</li>
ontoref-yin-sub = What must be true
ontoref-yin-title = Yin — The Ontology Layer
ontoref-layers-title = Protocol Stack
ontoref-layer-decl-items = .ontology/ · adrs/ · reflection/schemas/
ontoref-layer-op-items = adr · register · config · backlog · forms · describe
ontoref-layer-entry-items = ontoref · actor detection · advisory locking · ONTOREF_IMPORT_PATH
ontoref-layer-graph-items = nodes · invariants · tensions · gates · dimensions · states
ontoref-layer-runtime-items = ontoref-daemon · ontoref-ontology · ontoref-reflection · search engine · notification barrier · SurrealDB (optional)
ontoref-layer-adopt-items = .ontoref/config.ncl · ontoref CLI · adopt_ontoref mode
ontoref-ui-title = Web UI — 12 Pages
ontoref-ui-graph-title = Graph
ontoref-ui-graph-desc = Force-directed D3 visualization of the ontology DAG. Yang·Axiom diamonds, Yin·Tension circles, Spiral·Practice squares.
ontoref-ui-search-title = Search
ontoref-ui-search-desc = Full-text search across nodes, ADRs, and reflection modes.
ontoref-ui-sessions-title = Sessions
ontoref-ui-sessions-desc = Actor registry with token, type, registered_at, last_seen, and current mode per actor.
ontoref-ui-notifications-title = Notifications
ontoref-ui-notifications-desc = Notification feed for pre_commit, drift, and ontology_drift signals. Acknowledge, dismiss, or emit custom notifications with action buttons.
ontoref-ui-backlog-title = Backlog
ontoref-ui-backlog-desc = Work items filterable by status with add/update operations.
ontoref-ui-qa-title = Q&A
ontoref-ui-qa-desc = Server-hydrated knowledge store from reflection/qa.ncl. Add, edit, and delete entries — persisted as typed NCL.
ontoref-ui-actions-title = Actions
ontoref-ui-actions-desc = Quick actions catalog from .ontoref/config.ncl. Execute runnable shortcuts over modes via POST /actions/run.
ontoref-ui-modes-title = Modes
ontoref-ui-modes-desc = Reflection mode list from reflection/modes/ — name, description, and full DAG contract per mode.
ontoref-ui-compose-title = Compose
ontoref-ui-compose-desc = Interactive mode forms with live session sharing for multi-actor workflows.
ontoref-ui-dashboard-desc = Project health, drift status, actor overview, and pending notifications at a glance.
ontoref-mcp-core-title = Core
ontoref-mcp-query-desc = search, get_node, list_adrs, get_adr, list_modes, get_mode, constraints — full DAG traversal.
ontoref-crate-ontology-title = ontoref-ontology
ontoref-crate-ontology-desc = Load .ontology/ NCL files as typed Rust structs. Graph traversal (callers, callees, impact queries). Invariant extraction and constraint validation. Zero stratumiops dependencies — minimal adoption surface.
ontoref-crate-reflection-title = ontoref-reflection
ontoref-crate-reflection-desc = Execute reflection modes as typed NCL DAG contracts. Step execution with dependency resolution. ADR lifecycle from Proposed through Accepted to Superseded. Config seal and rollback operations.
ontoref-crate-nushell-title = Nushell Modules
ontoref-crate-nushell-desc = store.nu (SurrealDB-backed cache with NCL export) · sync.nu (ontology code synchronization) · describe.nu (actor-aware project self-knowledge) · coder.nu (structured session records). 16 modules total — one per operational domain.
ontoref-crate-nickel-title = Nickel Schemas
ontoref-crate-nickel-desc = Core ontology types: Node, Edge, Pole, AbstractionLevel. State machine types: Dimension, Transition, Gate, Membrane. ADR schema: Constraint, Severity, Status, supersession. Reflection schema: Mode, Step, OnError, Dependency.
ontoref-crate-daemon-title = ontoref-daemon
ontoref-crate-daemon-desc = Actor registry via DashMap. Notification barrier with pre-commit hook integration. Compose forms for shared mode dispatch. SurrealDB-backed persistence as opt-in feature. NATS feature gate for distributed setups.