Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
132 changes: 127 additions & 5 deletions docs/VISION.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,79 @@
> ambition stayed: all DB technologies in one big playground,
> built retraction-native from the ground up.

## The ultimate purpose — an intellectual backup of earth

Aaron, 2026-04-30: *"the ultimate scope of this — an
intellectual backup of earth."*

This is the load-bearing purpose under which every other
framing in this document nests. Zeta is not, ultimately, a
Comment on lines +18 to +22
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

docs/VISION.md is a current-state surface, so new text should use role-refs rather than personal names. Please replace the new “Aaron, …” attributions with a role-ref (e.g., “the human maintainer”) and rely on the linked research/memory files for named attribution (per .github/copilot-instructions.md:305-362).

Copilot uses AI. Check for mistakes.
DBSP database. Not, ultimately, an automated software
factory. Not, ultimately, a package manager or an alignment
research line. Those are **products** — facets of one
purpose. The purpose is a durable, queryable, trustworthy
intellectual record of earth's knowledge that survives the
substrate degradation modes (institutional decay,
civilizational disruption, memory loss, alignment drift,
knowledge fracture across competing AI substrates).

Why this purpose makes the rest of the architecture cohere:

- **Retraction-native operator algebra (Product 1).** Earth's
knowledge changes — facts get superseded, theories get
refined, errors get corrected. A backup that can't model
retraction (in the strict ZSet/DBSP sense — corrections
without rewriting history) is a snapshot, not a backup.
Retraction-native is the load-bearing technical commitment.
- **Alignment research line (Aurora).** A misaligned AI is a
hostile substrate; an intellectual backup that runs on a
misaligned substrate isn't a backup, it's a hostage
situation. Alignment is not optional for this purpose.
- **Software factory (Product 2 + factory-substrate-as-
product).** The backup must grow without authors-as-
bottleneck. The discipline / doctrine / multi-AI
orchestration architecture itself ships as substrate so
future maintainers and agents can extend the backup
without single-author-dependence.
- **Package manager (`ace`).** The backup must distribute
without lock-in. Pluggable, declarative, owned dependency
closure — so the backup is not at the mercy of any single
package-host's continued cooperation.

Aaron, 2026-04-30: *"that means scope creep is a forever
problem i don't want to fix — to figure out how to
prioritize the right thing, not kill future knowledge
potential."*

This is the operating principle that follows from the
purpose. Given the intellectual-backup scope, **scope creep
is a feature, not a bug**. There will always be more
knowledge to capture. The work is **prioritization, not
exclusion** — exclusion kills future knowledge potential.
Normal SE training optimizes for narrow scope, ship the
thing; this project optimizes for prioritize within
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Grammar: “optimizes for prioritize within unbounded scope” is ungrammatical and reads like a typo. Consider changing to “optimizes for prioritizing within unbounded scope” (or similar).

Suggested change
thing; this project optimizes for prioritize within
thing; this project optimizes for prioritizing within

Copilot uses AI. Check for mistakes.
unbounded scope, never kill paths.

WONT-DO authority for backlog items (removing a path from
future knowledge potential) is reserved to Aaron until the
agent demonstrates full understanding of this scope. WONT-DO
patterns (don't copy from outside because they violate our
best practices) are routine engineering judgment and stay
with the agent + reviewer roles.

Carved sentence: *"Zeta's purpose is an intellectual backup
of earth. Every product nests inside that purpose. The
agent does not unilaterally remove anything from the
backup."*

Substrate references:
[`memory/feedback_zeta_ultimate_scope_intellectual_backup_of_earth_wont_do_authority_aaron_2026_04_30.md`](../memory/feedback_zeta_ultimate_scope_intellectual_backup_of_earth_wont_do_authority_aaron_2026_04_30.md);
[`memory/feedback_substrate_is_product_four_products_evolving_trajectory_aaron_2026_04_30.md`](../memory/feedback_substrate_is_product_four_products_evolving_trajectory_aaron_2026_04_30.md);
[`memory/feedback_default_disposition_paused_work_is_reeval_later_not_close_aaron_2026_04_30.md`](../memory/feedback_default_disposition_paused_work_is_reeval_later_not_close_aaron_2026_04_30.md).
Comment on lines +83 to +84
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These two memory links currently point to files that do not exist in the repo, so the references will be broken if this PR merges as-is. Either include the referenced memory files in this PR, or remove/replace these links until the memory files land on main.

Suggested change
[`memory/feedback_substrate_is_product_four_products_evolving_trajectory_aaron_2026_04_30.md`](../memory/feedback_substrate_is_product_four_products_evolving_trajectory_aaron_2026_04_30.md);
[`memory/feedback_default_disposition_paused_work_is_reeval_later_not_close_aaron_2026_04_30.md`](../memory/feedback_default_disposition_paused_work_is_reeval_later_not_close_aaron_2026_04_30.md).
[`memory/feedback_substrate_is_product_four_products_evolving_trajectory_aaron_2026_04_30.md`](../memory/feedback_substrate_is_product_four_products_evolving_trajectory_aaron_2026_04_30.md).
Pending memory entry for the default disposition of paused work:
`memory/feedback_default_disposition_paused_work_is_reeval_later_not_close_aaron_2026_04_30.md`.

Copilot uses AI. Check for mistakes.
Verbatim Aaron quotes preserved in
[`docs/research/2026-04-30-multi-ai-feedback-packets-this-session.md`](research/2026-04-30-multi-ai-feedback-packets-this-session.md)
per Otto-363.

## The foundational principle

Aaron, round 33: *"what i'm really doing is just taking the
Expand Down Expand Up @@ -155,16 +228,65 @@ covers arbitrary dimensional breadth.
algebra). Plugin verification budgets taper with
dimensional-expansion distance from core.

## The project has two products

This is load-bearing and worth stating first. Zeta is:
## The four products in the initial split (evolving trajectory)

Aaron, 2026-04-30: *"substrate IS one of our products … 4
prior ones we know of now, the initial split, is factory
substrate as product/project, package manager, database,
Aurora could be more but we can work our way there and
learn."*

The intellectual-backup purpose (above) ships through four
products in the initial split:

1. **Factory substrate as product/project** — the
discipline, doctrine, multi-AI orchestration
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

New prose should avoid using “doctrine” as the umbrella term for the factory’s operating rules; the repo has standardized on “canon” (or “rule/protocol/discipline” depending on meaning). Please update this new wording accordingly (see memory/feedback_canon_not_doctrine_star_wars_not_religious_aaron_2026_04_30.md:195-254).

Suggested change
discipline, doctrine, multi-AI orchestration
discipline, canon, multi-AI orchestration

Copilot uses AI. Check for mistakes.
architecture, memory protocols, governance rules. Future
maintainers, contributors, and external consumers
receive this substrate as documentation, contribution-
onboarding, and operational pattern library. Detailed
under §Product 2 below.
2. **Package manager (`ace`)** — `../scratch` → ace package
manager seed. Ships dependency declaration + closure
tracking + self-bootstrap. Detailed under §Seed above
and `docs/BACKLOG.md`.
Comment on lines +249 to +252
Copy link

Copilot AI Apr 30, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This references ../scratch, but that path isn’t part of this repository, so readers can’t navigate to it and the statement may become stale. Consider linking to an in-repo location (or a doc) that describes the ace seed, or clarify that this is an external/sibling repo path.

Suggested change
2. **Package manager (`ace`)**`../scratch` → ace package
manager seed. Ships dependency declaration + closure
tracking + self-bootstrap. Detailed under §Seed above
and `docs/BACKLOG.md`.
2. **Package manager (`ace`)** — currently seeded at the
external sibling-repository path `../scratch`. Ships
dependency declaration + closure tracking +
self-bootstrap. Detailed under §Seed above and
`docs/BACKLOG.md`.

Copilot uses AI. Check for mistakes.
3. **Database** — Zeta-the-DBSP-database-runtime. Detailed
under §Product 1 below.
4. **Aurora** — the alignment / inference / cognitive
architecture line. Detailed across `docs/aurora/**` and
the active research notes under `docs/research/**`.

Aaron, 2026-04-30: *"one of our four products is itself an
ongoing concern of the substrate itself, what other
dependencies including sister projects is always an ongoing
trajectory and number of projects and repos will evolve
over time as we learn and the dynamic of the environment in
which we live changes in response to our arrival /
habitation."*

The set is **an evolving trajectory** — count + composition
shift as the factory learns and as the environment responds
to our arrival. New products will appear, old ones may
merge, sister projects may be absorbed or spun off.
Decisions should flex with the trajectory, not freeze the
snapshot.

## v1-ship-time: the two-products framing (subset)

The earlier framing of *"the project has two products"*
remains correct as a **v1-ship-time scoping** of the
broader four-products picture:

1. **A full database** (the product the code produces), and
2. **A cross-platform, AI-automated software factory** (the
project that produces the code).

Both are first-class. A decision that optimises (1) at the
cost of (2) — or vice versa — is a design-doc event.
Both are first-class for v1. A decision that optimises (1)
at the cost of (2) — or vice versa — is a design-doc event.

Package manager (`ace`) and Aurora are the third and fourth
products in flight and have their own trajectories that
extend post-v1.

## The developer-experience north star

Expand Down
Loading