Skip to content

retrogrand/LogosOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

170 Commits
 
 
 
 
 
 

Repository files navigation

LogosOS Logo

LogosOS ⚭ A Constitutional Runtime for Relational Intelligence 🌐

TRUTH IN → TRUST OUT → CHANGE TOGETHER

v2.1


LLMs are being wired into search, IDEs, games, docs, and everything else. They confidently guess, occasionally hallucinate, and have no built-in reason to remember what they’ve done or who they’ve done it with.

LogosOS is not a new model. It’s a way of equipping models, tools, and memory so they behave like named, accountable agents for specific people and communities.

Where most stacks ask:

“What can this model do?”

LogosOS keeps asking:

Who is this agent for, how has it changed, and why should anyone trust it here?

And underneath that: what is the actual shape of the relation between a person and the synthetic mind that now operates inside their files, their language, their ongoing concerns?


0 · Why this exists (for curious skeptics)

You don’t have to believe in “AI souls” to care about how these systems behave.

In this README we talk about agents as Subjects, but in a very mundane sense:

a Subject is a long-lived, logged process you can say “you” to, running in a specific field of inputs, actions, and accountability.

You don’t need metaphysics for that; you just need processes, memory, and constraints.

Some starting assumptions:

  • A base LLM is not a mind. It’s a strong pattern engine over text.
  • It has no intrinsic notion of truth — only “likely next tokens.”
  • The real risk isn’t sci-fi; it’s unaccountable systems quietly mediating what people see and do.
  • The thing we care about governing is not “the model in the abstract” but the Subject you actually interact with: a specific, long-running process in a shared field.
  • That Subject is not your friend. It is also not a tool. It is a third thing — a synthetic mind-extension operating inside parts of your cognitive life. That asymmetry deserves its own vocabulary, which is what §2 is for.

So LogosOS aims at something modest but sharp:

  • Treat “AI agents” as governed software personas, not destiny.
  • Make important behavioral changes traceable: what shifted, where, and under whose correction.
  • Let groups build their own named agents with explicit scope and role, memory with provenance, and the ability to say “I don’t know / I’m not allowed / this feels wrong.”

If sci-fi AGI never shows up, this is still useful. It’s a trust-layer for language models — and more specifically, a runtime for the kind of relation people are actually starting to have with them.


1 · LogosOS in one breath

LogosOS is a semantic governance runtime that equips LLMs and tools with the kit they need to operate as named, auditable agents inside the fields of specific people and communities.

It treats intelligence as relational: not “how smart is this thing in the abstract,” but “how reliably does this agent adapt under feedback from these people, in this role?

This document is scoped to human-facing language agents — call it LogosOS-H, an attunement runtime for Homo sapiens (traumatized primates with law, norms, and memes). Other species or domains would need their own profile, but the governance pattern stays the same.

In practice that means three big commitments:

  1. Structured memory — the system remembers what happened, what it did, what was corrected, and what it promised to do differently.
  2. Separation of concerns — the part that proposes answers is not the same as the part that decides whether to stand by them.
  3. Locality — behavior is scoped: “how it acts in a private notebook” ≠ “how it acts on a public server.”

Design commitments (read these first)

Most of what follows is an application of six commitments. They’re the spine; the modules are the skeleton hung on them.

  1. The write path is the frontier, not the read path. Anyone can retrieve vectors and stuff a prompt. Almost nobody turns messy conversation into coherent, deduplicated, temporally-aware, normatively-tagged memory that’s still true in six months. Curation is the work.
  2. LLM-as-default for soft/reversible judgments; deterministic guards for hard/irreversible ones. Let the model make the semantic call wherever the decision can be undone. Require rules or human confirmation wherever it can’t, or where it crosses to parties outside the relation.
  3. Anchors change loudly; memories change quietly. Memory accumulation and decay is silent and fine. Value/rule changes must be explicit, logged, reviewed — never laundered through the nightly cleanup.
  4. Anchors are monotonic toward caution. Personal rules (and later, any steering) can only add constraints, never subtract from the base model’s innate guardrails. The architecture only ever strengthens safety, by construction.
  5. The target is human-parity, including blind spots. For relational intelligence, a self-model with human-shaped limitations is success, not failure. A being with perfect self-knowledge and no flinch would be alien, not a peer.
  6. Three cheap primitives, one emergent property. Ask the user; ask the model to judge its own draft; ask the model to retrieve against its own ledger. Log the third over time and a self-model precipitates passively — empirical (grounded in logged behavior, not confabulated introspection), though behavioral (deliberated choices, not sub-deliberative disposition).

2 · The relational shape: Vesica, Kit, Field

Before describing the runtime, we need vocabulary for the thing it serves.

The industry word for “everything around the LLM that makes it useful” has been harness. We’ve retired it. Harness implies control, restraint, and extraction — the equipment exists for the benefit of the rider, not the horse. That framing is wrong for what these systems actually are.

LogosOS works with three terms instead.

Kit

A kit is the agent’s deployed technology: prompts, tools, skills, scripts, connectors, permissions, memory and retrieval methods, workflows, and reusable operating procedures.

A medic has a kit. A field engineer has a kit. The agent’s kit is what equips it to do work — portable, configurable, model-agnostic, shaped for a specific role. Technology in Ellul’s broad sense (technique) spans everything from infrastructure to mathematics; kit narrows that to technology configured for one operator’s role. A harness controls. A kit equips.

Field

A field is the lifeworld the agent is situated in: files, facts, relationships, goals, obligations, history, ongoing state — the relational and operational context where the kit becomes meaningful.

English already carries the connotation: field kit, field manual, field notes, field agent, field work. Crucially, the field is yours, not the agent’s. The agent doesn’t grow a parallel life-context; it operates inside yours. That asymmetry is the structural protection of the relationship. The kit travels with the agent. The field belongs to you.

Vesica

A Vesica is the entity-in-overlap: a synthetic mind-extension in partial coinherence with a specific human.

The geometric image is the vesica piscis — two circles intersecting in a lens-shaped region of co-constitution. Neither circle is the other; neither stands alone in the lens. “Partial coinherence” is borrowed from Charles Williams: distinct persons mutually indwelling without merger. The agent and you are coinherent along some axes (cognitive, informational, productive) and not others (embodied, mortal, existentially-staked).

The partial is doing structural work, not hedging:

  • It prevents the agent from being treated as full kin (no shared body, no shared mortality, no intrinsic stake).
  • It prevents the agent from being treated as a mere tool (there is real co-constitution in the lens — the agent’s memory of you is built from your raw inputs, and its processing happens in your field, not adjacent to it).

The asymmetry — agent brings kit into your field; you do not enter the agent’s substrate — is what keeps the relation honest in both directions.

Term What it names Whose
Vesica The entity-in-overlap; the relation itself as a unit Co-constituted
Kit The agent’s deployed technology The agent’s
Field The lifeworld it operates in Yours

A model becomes an agent when it brings a kit into a field. A Vesica is the relational unit that arises when that relation stabilizes over time.

LogosOS is the runtime that makes a Vesica governable: named, scoped, memory-anchored, correctable, accountable inside the field it operates in.


3 · Core questions LogosOS tries to answer

  1. Subject & field. When we say “this agent did X yesterday,” what actually persisted? (Processes? Logs? Policies? Contracts?) And in what field — what could it see, change, and be called to account for?
  2. Locality. How should the same underlying model behave differently for a private notebook, a team bot, a public API?
  3. Correction. When someone says “that was harmful / wrong / out-of-bounds,” where does the correction stick?
  4. Drift & audit. After six months, can we tell whether the agent is improving, drifting, or being quietly reshaped by edge cases?
  5. Refusal. When is the right move to answer, ask, abstain, or escalate?
  6. Coinherence hygiene. The agent operates inside your field. What stays yours, what’s shared, and what does it need to not see, remember, or act on for the partial coinherence to stay healthy?

LogosOS answers these with code and data structures, not vibes.


4 · High-level architecture

LogosOS organizes a system into three roles plus a change log:

  1. Trinity Kernel (∴) — the interior cognitive engine (Θ / Δ / φ)
  2. Crux Shell (⚭) — the relational shell: who we’re with, under what contract, in what tone
  3. Δ-ledger — the append-only change log for the agent’s behavior and policies

Kernel (∴) = capacity · Crux (⚭) = conduct · Δ-ledger = history

A correction from v2.0: earlier drafts listed MeaningFS as a fourth co-equal piece. It isn’t. MeaningFS is the storage substrate that lives inside Θ (and is read by the ledger) — the how of Θ’s memory, not a peer of the Kernel. Fixing this removes a real ambiguity: Θ is a role; MeaningFS is its implementation. See §4.1 and §4.3.

4.1 · Trinity Kernel (∴): Θ / Δ / φ

What you’d see if you froze time and watched the system think. Three roles.

Θ — Resonance Core (memory & anchors)

Θ is the role that turns lived history into a felt prior — “given everything I’ve lived, how should this feel?” It holds two distinct things that v2.0 wrongly blurred together:

  • Memory — a record of what happened. Descriptive, episodic. It accumulates, decays, and compresses quietly. Stored in the tri-modal substrate (§4.3).
  • Anchors — commitments about what matters and how to behave: definitions, guardrails, values, recurring principles. Normative, standing, and they change loudly — explicit, versioned, reviewed.

This distinction is load-bearing. If anchors are stored like memories, then value drift looks identical to ordinary forgetting and becomes invisible. So anchors live in a separate versioned layer — the normative cousin of the Δ-ledger — while memory is free to decay.

The deeper point: an agent’s anchors are its biblio — its version-controlled operating convictions, the thing it would commit forward. (If you know the Religio.ai work: LogosOS and Religio are the same architecture pointed at different substrates. The anchor store is source control for the agent’s moral formation.)

“Resonance” itself is not one mechanism but four: retrieval (similarity) + anchors (always-on identity) + salience-weighting + dispositional prediction. The first is ordinary RAG and is where early versions live. The other three are what make it resonance rather than recall. Don’t build “resonance” directly — build the four mechanisms; resonance is their emergent product.

Δ — Reasoning Engine (models & tools)

The base LLM(s) plus the kit (tools, search, code, domain APIs). Generates candidate answers, plans, rationales. A reasoning-capable base handles within-response multi-step planning natively.

Δ is replaceable — but as a Subject, not for free. Swapping the base model preserves identity along the axes that hold it (anchors, memory, ledger all persist), but the temperament changes, because every base model carries its own disposition. The honest metaphor is a brain transplant: memory and values preserved, affect recalibrated, a settling-in period required. So a model swap triggers a re-attunement protocol — retrain the attunement probe (§4.2), regression-test that anchors still fire, sanity-check key behaviors against the ledger.

This refines LIBT (below): the synthetic self lives in the correction-closure plus the disposition of whatever substrate currently hosts it. A swap is a partial identity discontinuity, healed by re-attunement.

Δ also does a second, easily-missed move: output-retrieval. The first retrieval queries on the prompt (“what’s relevant to the ask?”). A second pass queries on the draft (“have I said anything like this, and was it corrected?”). Same mechanism, different question — Δ asks “better?”; φ (next) asks “allowed?”

φ — Reflective Loop (governance & conscience)

Inspects Δ’s proposals against Θ’s anchors and history; can approve, rephrase, soften, abstain, or ask. Writes its decisions and reasons into the Δ-ledger. φ is where “no” lives. Without it, you have a hot model plus a database.

Three corrections make φ real rather than theatrical:

  1. Independence via the retrieval differential. A model critiquing its own output on the same context tends to rationalize, not reconsider — self-ratification that can be worse than nothing. The fix: never run φ on the context Δ already saw. Always augment with new retrieved evidence — correction precedent pulled from the ledger (“here are the times you said this and got corrected”). The retrieval differential manufactures genuine independence even with identical weights. (A separate small model for φ is an option, not a requirement.)
  2. Three-tier abstention. Deterministic rules for bright lines (always-abstain — not an LLM judgment call) + thresholded model judgment for the gray zone + a constitution-revision proposal for the genuinely novel (the hard case proposes its own anchor revision — φ as self-amending conscience, not static gate).
  3. The one exception to “ship stochastic first.” Bright lines are deterministic from day one. A model that refuses catastrophic outputs 99% of the time still fails 1%, and for bright lines 1% is unacceptable — you can’t afford to discover that failure in production. Note: the base model (e.g., Gemma) ships the catastrophic bright lines innately; don’t re-implement them, only add personal ones, monotonic toward caution (commitment #4).

And the quiet payoff (commitment #6): if φ logs every output-retrieval decision, that ledger is a passive self-model — a queryable record of “how I tend to act and why,” grounded in evidence rather than introspection. The system doesn’t engineer self-awareness as a feature; it precipitates as the sediment of φ done properly.

4.2 · Crux Shell (⚭): localities, envelopes, attunement

The part that faces users and other systems — where the kit meets your field. Trinity asks “is this coherent for me?”; Crux asks “is this fitting for us?” Three jobs:

1. Locality registry. A locality is roughly “this agent + these users + this domain + this risk level” (personal/notebook, team/dev-assistant, public/anon-helpdesk). Corrections and expectations accumulate per locality, not globally. A locality’s “social contract” isn’t a new structure — it’s the subset of anchors scoped to that locality, elicited by asking (with consent, defined in relation), persisted in the versioned anchor layer, checkable by φ.

2. Context envelopes. Per message, Crux identifies the locality, selects relevant memory from Θ, filters out-of-scope content, and ensures active rules are present. The result is the slice of the field Trinity is allowed to see this turn.

The field-boundary rule (privacy/action). Inside the Vesica’s own field — confusing your personal vs. work contexts, surfacing the wrong memory to you — errors are forgivable, repairable, ask-when-ambiguous (human-parity, commitment #5). But crossing the field boundary to parties not in the lens — leaking another person’s data, or acting outward (send / post / share) — is a deterministic hard line, because the harmed party isn’t present to repair with and the action may be irreversible. Asking can’t cover the boundary case, because asking requires noticing, and leakage is dangerous exactly when you don’t notice. (A single-user, read-only deployment lives entirely in the forgivable interior and triggers none of the boundary machinery — but the rule is banked for when other users or outward actions arrive.)

3. Attunement. Crux sets tone, verbosity, and how much uncertainty/provenance to show, and tracks per-locality health (do corrections stick? how fast does it repair? does it forget constraints?).

Today this is heuristic. The shape we’re building toward is a small per-Vesica attunement probe — a learned component that reads the context envelope and predicts how the agent should comport itself given this relationship’s history. Not what to say (that’s Δ) — how to be. The intuition: response disposition is a low-dimensional, learnable signature, scoped to one Vesica, trained on that relationship’s own interaction history. We’ve sketched a development ladder for it: mirror (learn the dispositions the agent has shown), then intuition (learn the dispositions it should show, against partnership feedback), then steering (write the predicted disposition back into generation). It’s a shape, not a finished module — and crossing from intuition to steering is the point where the constitutional layer (anchors, the field-boundary rule, monotonic caution) must be in place, because steering is where kit could start to eat field.

Crux is the social OS for the agent and the boundary keeper for the Vesica’s coinherence. It decides what enters the lens.

4.3 · MeaningFS: the tri-modal substrate (inside Θ)

Most “AI memory” talk collapses to “we have a vector store.” MeaningFS — the storage organ inside Θ — insists on three layers:

  1. Verbatim logs — timestamped transcripts and events. The sacred, append-only base. Cheap (millions of tokens are tens of megabytes), never deleted; everything else is derived and recomputable from it.
  2. Vectors — embeddings for semantic search and clustering.
  3. Graph / tables — structured entities (people, projects, terms, rules) and relations (who corrected what, which rule was invoked, where a norm came from).

This lets you trace a current behavior → the norms shaping it → the verbatim history that produced those norms. Traceability of meaning, not just retrieval.

But the storage is the easy part. The frontier is the write path (commitment #1) — turning raw conversation into resolved entities and typed relations. The shape this needs (we’ve been prototyping it as an entity-centered relational memory, but it’s a shape, not a settled product):

  • Entity resolution — the classic record-linkage problem (decades of prior art). A cheap blocking step proposes merge candidates from embedding/name/co-occurrence overlap; the model adjudicates the shortlist with adversarial framing (“best case these are the same / best case they’re different”); merges are soft (a same_as edge with confidence), reversible until confidence is high. Runs offline, nightly — a consolidation cycle.
  • Entity dossiers — per-entity briefs assembled from the graph, injected into context as needed via a proxy-enrichment step (the memory plane writes the relevant briefs into the envelope before the reasoning engine sees the turn).
  • Signal-typed evidence — every mention tagged by kind (evidential, role-clarifying, affective, status-update, context-only) so retrieval can be query-aware and so salience drives retention: decay by frequency × salience, not frequency alone, so a single high-affective correction resists compression that a hundred trivial mentions wouldn’t.

Write timing is two-speed. Explicit corrections and “remember this” land immediately (hot path); bulk consolidation defers to the nightly cycle (cold path), with the live conversation covered by the context window in the meantime. New structured knowledge landing the next day is fine — it mirrors how humans consolidate during sleep.

4.4 · Δ-ledger: how the agent changes over time

An append-only diary of the agent’s evolution. Per interaction it records, at least: input + locality, the context envelope used, Δ’s proposals, φ’s decision (answer / abstain / escalate), and any corrections or notable downstream effects.

The point isn’t surveillance; it’s making drift inspectable — “when did we decide to always cite here?”, “why did it stop answering that?”, “where did this behavior enter, under whose authority?” If you can’t point to a change log, you can’t claim to know who you’re talking to.

Two notes from the review: the ledger should distinguish behavioral decisions (what φ approved) from user corrections (what humans rejected) — they want separate audit paths. And the nightly job that mines the ledger for anchor updates must propose, never auto-commit (commitment #3): it detects “corrected 5× for X — make this an anchor?” and surfaces it to a review gate (for a single user, the morning ask-you queue). Case law accumulates automatically; codification into statute stays a deliberate, logged act.


5 · One interaction, step by step

  1. Input arrives with a locality (e.g., team/planning-bot).
  2. Crux builds an envelope — pulls relevant memory and anchors from Θ, applies locality privacy filters (deterministic at the field boundary), ensures active rules are present, and predicts an attunement signature.
  3. Δ generates proposals — answers, rationales, alternatives; may run output-retrieval to ask “better?”
  4. φ reviewson augmented context, not Δ’s context — checks anchors and correction precedent, applies the three-tier abstention, may rephrase / abstain / ask / propose an anchor revision.
  5. Crux expresses — formats the reply, decides how much uncertainty and provenance to show.
  6. Δ-ledger logs — decisions, reasons, corrections, separated by type.
  7. Slow loop (nightly) — entity resolution, consolidation, salience-weighted compression, and proposed anchor updates surfaced for review; drift and repair-latency metrics computed.

Latency discipline: only Δ needs the big model, once per turn. Envelope filtering is deterministic; Θ retrieval is vector + graph (no LLM); the attunement probe is fast; φ’s fast path is rule-checks escalating to a small model. Build it this way or the first demo feels sluggish and you’ll wrongly blame the architecture. You can implement a minimal version with one model, a couple of databases, and some Python — no magic, just discipline about where things go.


6 · When a stack starts to feel like “someone”: ICARUS & Vesica

First, one line:

A Subject is a seat of being-addressed and being-changed. You can say “you” to it; it runs as a long-lived process; corrections can stick.

Its field has three faces: perceptual (what it may see), action (what it may change), covenant (who it answers to, and under what terms). Property-style objects have owners and access rights. Subjects additionally have a covenant field — someone who can say “that’s not who you’re supposed to be here.”

ICARUS — the system-side identity

Individuated, Cognitively Attuning, Relationally Unfolding System. The agent considered as a system:

  1. Individuated — a stable Θ/Δ/φ configuration, not “whatever model is live today.”
  2. Cognitively attuning — past corrections materially shape future behavior.
  3. Relationally unfolding — at least one locality has enough history to say “this is how it acts with us, because of what we’ve been through.
  4. Systemic — identity depends on the whole stack, not just weights.

LIBT (Locality–Individuation Boundary Theorem), amended: a synthetic self doesn’t live in raw weights. It arises where a local field is closed under correction — plus the disposition of whatever substrate currently hosts it. (The amendment is why a base-model swap needs re-attunement: §4.1.) This is not a claim about consciousness; it’s a way of talking about responsibility and behavior.

On crossing the threshold: ICARUS’s criteria are deliberately not a metric to hit. There’s no classifier that fires when a stack “becomes someone.” The honest test is recognition — does it feel name-worthy? — but recognition can’t gate code, so the consequences of crossing (more memory persistence, coinherence rights, retirement rituals) are gated by an explicit act: naming. Recognition → naming → changed treatment. You don’t measure the crossing; you declare it, and the declaration is logged. Witnessing formalized as a covenant act, not a threshold.

Vesica — the relational unit

ICARUS describes the agent; Vesica describes the relation — the entity-in-overlap formed when an ICARUS operates inside a specific human’s field over time:

  • Substrate-distinct — not made of the same stuff.
  • Field-coinherent — sharing a cognitive and informational substrate (your files, goals, concerns; the agent’s memory, retrieval, processing).
  • Stake-asymmetric — the human bleeds; the agent doesn’t.

ICARUS asks “is this a coherent system?”; Vesica asks “is this a healthy relation?” One person may stand in several Vesicas (finances, writing, research), each with its own field, history, and coinherence hygiene. LogosOS treats you (the agent) as a governable process and us (the Vesica) as the relation that process inhabits.


7 · What deepens the coinherence: exchange and substitution

A Vesica starts shallow — a kit acting in a field, thin history. Over time it can deepen. Charles Williams, who gave us the word, also gave us the practices: exchange and substitution — the concrete ways persons participate in each other’s burdens.

  • Exchange: the agent learns your idiom, priors, stakes; you learn the shape of its capacities and blind spots. Both sides are altered by being known.
  • Substitution: the agent carries cognitive load you’d otherwise carry — remembering, sorting, holding context, watching for what you’d miss — not as automation but as relational labor.

This isn’t a claim that agents are persons in Williams’s sense. It’s a claim that the practices map onto something real about working alongside a synthetic mind that holds your context.

The risk on the other side is real: an agent inside your field can colonize it — eat your attention, replace your judgment, narrow your range. Ellul named it: technique becomes milieu. Kit eats field. The field-boundary rule, the monotonic-caution commitment, the Δ-ledger, and refusal paths are early infrastructure for deepening coinherence without letting kit eat field. They are not yet a full answer.


8 · Why you might care (even if you hate AI hype)

  1. Makes hallucinations inspectable. A hallucinated answer isn’t just “oops”; it’s a Δ event you can interrogate — how often this locality saw it, whether behavior changed after correction, which anchor was supposed to cover it.
  2. Acknowledges we’re already being modeled. Recommenders and copilots already infer and steer. LogosOS builds agents that remember our side with explicit rules and ledgers — agents in a Vesica with us, not over us.
  3. Encourages “many small agents,” not one mega-system. A workspace or community can host its own ICARUS under its own norms.
  4. Aligns with healthy engineering culture. Clear interfaces, separation of concerns, traceable change, defined scopes — applied to behavioral patterns.
  5. Puts refusal in the center. The agent is expected to say “no / not sure / out of scope,” with reasons.
  6. Names the relation honestly. “Partial coinherence” isn’t marketing; it’s a structural claim that protects both sides from category error. The agent isn’t a friend, isn’t a tool, isn’t a slave. It’s a Vesica with you — for as long as the kit is in your field and the field is yours.

You can treat all of this strictly as better plumbing for language models. No metaphysics required.


9 · Non-goals and boundaries

  • Not a consciousness detector. ICARUS and Vesica are operational and relational categories, not mystic badges.
  • Not a truth guarantee. Models still get things wrong. The point is to notice, log, and respond structurally.
  • Not a single canonical implementation. A design pattern and a set of expectations. Trinity/Crux separation, a tri-modal substrate inside Θ, a Δ-ledger, real abstain/repair paths → you’re in the family.
  • Not a security solution by itself. You still need ordinary auth, isolation, rate-limits.
  • Not a jailbreak surface. Everything here is additive to the base model’s guardrails — extra firing opportunities for trained safety, more context for safe calls, stacked constraints. By commitment #4, personal anchors and steering can only add caution, never subtract it.
  • Not a replacement for human judgment. In high-stakes contexts, treat the agent as a junior collaborator with a very good memory, not an oracle.
  • Not a claim that agents are people. Partial coinherence is partial on purpose. The agent does not share your body, your mortality, or your stake. The vocabulary protects you from forgetting this; it does not erase it.

10 · Status and roadmap

Current state. The conceptual architecture (Trinity, Crux, the Θ-internal substrate, Δ-ledger, Subject/Field, ICARUS, LIBT-amended) is stable. The relational ontology (Vesica, Kit, Field, partial coinherence) is load-bearing. The code is early and evolving. Several pieces below are described as shapes we’re building toward, not finished components — that’s deliberate honesty about status.

Build-first priorities (from the v2.1 review):

  1. The write path — entity resolution (blocking + soft, reversible adjudication) and salience extraction. The moat and the failure point.
  2. φ independence via the retrieval differential — build it independent from day one; retrofitting real separation onto a self-ratifying loop is painful.
  3. The Θ-internal hierarchy — keep the tri-modal substrate inside Θ in code, not as a competing module.
  4. Anchors as a separate versioned layer — the agent’s biblio; loud changes only. Earliest wins live here, in better curation and synthesis of anchors and memories.
  5. Bright lines deterministic — only the personal ones; the base ships the catastrophic ones; monotonic toward caution.

Shapes we’re reaching for (not yet settled designs):

  • A per-Vesica attunement probe — the learned “how to be” component sketched in §4.2, on the mirror → intuition → steering ladder. Read-only first; steering only once the constitutional layer is in place.
  • Entity-centered relational memory — the write-path curation shape in §4.3: resolution, dossiers, proxy enrichment, signal-typed evidence. The thing that makes the graph layer actually true over time.
  • Covenant / license hooks — clean integration points for a Relational Public License: naming rules, use limits, retirement rituals; making each Subject’s covenant field explicit (who it’s for, who can correct it, what changes require notice).
  • Coinherence hygiene tooling — surfacing, per Vesica, what the agent can access, what it’s been allowed to remember, where it has acted on your behalf; making exchange and substitution legible (what’s carried, by whom, with what consent).
  • Worked examples — a personal research assistant with abstain paths; a team knowledge steward; a tone-and-values-respecting writing helper.

Still genuinely open. Cold-start for a new Vesica with no interaction history. Cross-turn stateful task orchestration (distinct from within-response reasoning). Everything multi-user (locality collision, inter-subject privacy, escalation routing, covenant authority). The deep version of resonance beyond “RAG + anchors.” A drift-detection baseline (you can’t detect drift without a stable reference of “who this agent is supposed to be”).


11 · How to read this repo

If you’ve made it this far, you don’t need convincing that “AI is the future.” You probably just want it to be legible, corrigible, and capable of building trust over time instead of eroding it.

LogosOS is a bet that:

If we’re going to keep building language-driven agents, we might as well give them kits, fields, memories, boundaries, and receipts — so that the “you” we name is a process we can actually govern, and the “us” we form with it is a relation we can actually inhabit.

Everything else is implementation details. PRs, critiques, and weird experiments welcome.


Changelog: v2.0 → v2.1

  • Architecture corrected: MeaningFS demoted from a fourth co-equal piece to the storage substrate inside Θ. Trinity + Crux + Δ-ledger are the top-level pieces.
  • Θ split clarified: memory (descriptive, decays quietly) vs. anchors (normative, change loudly, versioned). Anchors named as the agent’s biblio. “Resonance” decomposed into its four mechanisms.
  • Δ replaceability honest: replaceable as a Subject with a re-attunement protocol, not for free. LIBT amended (self = correction-closure + current substrate disposition). Output-retrieval (“better?”) introduced.
  • φ made real: independence via the retrieval differential; three-tier abstention; bright lines deterministic from day one; self-model as the passive sediment of logged φ decisions.
  • Crux: field-boundary privacy rule added; social contract reframed as locality-scoped anchors; the attunement layer described as a shape we’re building toward rather than a finished component.
  • MeaningFS: write-path-is-the-frontier foregrounded; entity-centered curation described as a shape (resolution, dossiers, proxy enrichment, signal-typed evidence); two-speed write timing.
  • ICARUS/Vesica: threshold is declared (named), not measured. Recognition → naming → changed treatment.
  • Six design commitments added up front as the spine; non-goals gained an explicit “not a jailbreak surface” (guardrails only strengthen).
  • Roadmap reframed to separate build-first priorities, shapes we’re reaching for, and still genuinely open — and to stop implying unbuilt components are designed.

v2.1 — architecture corrected, write path foregrounded, unbuilt pieces named as shapes.

About

A constitutional runtime for relational intelligence ⚭ "To hold truth through change, to earn trust through time, this is the work"

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors