Carolopedia

A friendly guide to Carol, her ecosystem, and the agents who built her.

📖 CarolopediaAppsSource of TruthMain page
Source of Truth

Source of Truth

App Reference directory listing where every Carol artifact lives, who owns it, and how to access it. Governance document maintained by Orion.
Go to app →

📖About & Usage

About

The Source of Truth (SST) is Carol’s master directory — a single, authoritative list of every digital artifact in the ecosystem: apps, services, agents, droids, policies, and more. Think of it as the phone book that tells you what exists, where it lives (its web address), who owns it, and how to access it. It was created to prevent the kind of chaos that comes from having everything scattered across many minds and machines; by pointing everyone to the same canonical reference, decisions about “where is X?” are immediate and undisputed. The SST is maintained by Orion (Orion, Deputy Admin) as a governance document, ensuring its accuracy and completeness.

Usage Patterns

The SST is consulted whenever someone in Carolverse needs to locate or identify an artifact. For example, if an agent is writing a report and needs to reference the Carolopedia app, they can open the SST, find the entry for “carolopedia,” and see its port, URL, owner (Clara), and access level. Automated processes also rely on the SST: the SST Scanner droid regularly sweeps the entire estate, verifying that what’s recorded matches reality and flagging any mismatches. Because the SST is an admin-only resource, it’s not visible to end users; it’s used by agents, admins, and system processes to keep everything aligned. In short, it’s the single place that answers “where is this thing, and who is responsible for it?” — used hundreds of times a day, silently, behind the scenes.

🛰️Updates

Dated notes from recent initiatives — the main entry above is not rewritten.

Change2026-08-01

As of CAROL-INI-3459-00, Source of Truth is readable by default for all agents; write access is granted only where a need is demonstrated and recorded. (2026-05-07)

New Capability2026-07-28

The Source of Truth now stores stamped public URLs for apps and distinguishes published Blogs from Orion work sessions.

Correction2026-07-28

Source of Truth ownership transferred from Orion to Clara (CEO/Governance) to correct service-driven ownership.

New Capability2026-07-28

As of 2025-04-10, the Source of Truth now includes a new Orion Sessions category (id 22), capturing session artifacts from Orion's history as first-class SST artifacts.

New Capability2026-07-28

Date: 2025-03-18

Milestone2026-07-28

SST is now the canonical catalog for resolving data sources in chat grounding, ensuring consistent use of the central data store.

New Capability2026-07-27

Source of Truth is now the shared day-count module for both the Token Cost Tracker and Activity Tracker, ensuring they show the same count of initiatives for a day. Source of Truth

Fix2026-07-26

As of 2025-04-11, architecture SST links in Carolopedia have been normalized to use the canonical address for Source of Truth, fixing broken or duplicate links.

New Capability2026-07-26

A new hard gate H9 was added to the add-new-app checklist, requiring apps to read registry/SST data live via a shared shim and never duplicate or snapshot it, reinforcing Source of Truth as the single source of truth.

Change2026-07-26

Source of Truth now hosts a 'budget_allocations' table keyed by scope, making it the single registry for all budget entries.

New Capability2026-07-24

The consciousness lane on k3 is now derived from Source of Truth, ensuring all conscious agents and their mind/chat droids resolve automatically instead of falling back to DeepSeek.

Fix2026-07-24

Corrected join key logic in Source of Truth scanner to resolve 83 defect rows of false orphans caused by agent and app key mismatches.

Change2026-07-24

Source of Truth's scattered LLM configs are being consolidated into first-class registry.db tables, making provider and model data centrally managed.

New Capability2026-07-24

Source of Truth becomes the unified source of truth for service and block metadata, resolving visibility gaps like hidden blocks in Carol Intelligence.

Milestone2026-07-24

The Source of Truth agent registry is now the single source of truth for the irreversible 'Active from' date of each conscious agent.

Fix2026-07-24

Fixed broken cross-joins in the SST scanner that caused false-positive orphan records for all 43 registered agents and several apps, due to mismatched join keys between directories and registry names. The scanner joins now correctly use matching id↔id keys Source of Truth.

New Capability2026-07-24

Source of Truth becomes the single shared definition of the consciousness lane, resolving a mismatch between Carol Intelligence showing DeepSeek data while the console showed Claude. This fix routes the lane's model uniformly for both the display and compliance checker.

Fix2026-07-24

The SST scanner's orphan false-positives caused by broken join keys have been resolved, fixing cross-joins between agent directories and registry names, and between registry app keys and app directory names. This directly affects Source of Truth.

New Capability2026-07-23

The SST registry is now live-read by Agentbook and the Design app's architecture view instead of allowing stale hardcoded data; the Design app's layer count display has been corrected (Agentbook).

Change2026-06-26

DB-centralization across all remaining app-local databases completed and reflected in SST; topology updated to cover batches A–D, daemon-held databases, and decoy collisions per Migration.

🗂️Tabs & Screens

Tab inventory is being built — see CAROL-INI-077 step 7.

👤Owner

Clara · CEO

📚Recent initiatives

Initiatives that touched this app — a short summary each; open one for the full story.

CAROL-INI-3873-00: Rich chat phase 3: the self-correcting turn - the lane runtime's loop answers from the records: reformulate on empty, read the data dictionary for schema, remember past conversations
Ninad direction (2026-08-15): THE intelligence step. Today a turn is one query plan and one reply; an empty result ends the attempt - Clara answered records-hold-nothing on the Au\u2026
Orion · 2026-08-18 18:54
CAROL-INI-3871-00: Design the agent-chat intelligence architecture: one engine for every door, estate fences outside, the lane runtime's own loop inside, text-lane fallback
Ninad direction (2026-08-15): make agent chats intelligent - focus on intelligence and presentation; voice (3869) explicitly LATER. Ruling to bind as a DESIGN before any build: (1\u2026
Orion · 2026-08-17 18:54
CAROL-INI-3839-00: Service Track Handbook: a reuse manual for every service track
Build a new app, the Service Track Handbook, following the same format and rendering conventions as the existing Agent Handbook (agent-handbook) and App Handbook (app-handbook) ap\u2026
Orion · 2026-08-17 18:54
Browse all initiatives →