124 lines
15 KiB
Text
124 lines
15 KiB
Text
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.
|