Skip to content

decision: commit to Datomic as the MongoDB migration target#86

Open
lambduhh wants to merge 1 commit into
masterfrom
decision/datomic-migration-target
Open

decision: commit to Datomic as the MongoDB migration target#86
lambduhh wants to merge 1 commit into
masterfrom
decision/datomic-migration-target

Conversation

@lambduhh

Copy link
Copy Markdown
Collaborator

Context

The 2026 vision names an explicit, extensible data model as the keystone investment that the verification pipeline, quality signals, REPL embed, multi-library support, and community/resource graph workstreams all depend on. entity-model-rfc.md (2026-06-09) already flagged Datomic as "under evaluation as the migration target," but no decision had formally committed to it.

Problem

The 2026-06-01 decision explicitly ruled out a schema-bearing database, reasoning "the system uses MongoDB (schemaless); a relational DDL would be misleading about the actual storage model." Proceeding with Datomic schema work without addressing that standing decision would leave the decision log silently contradicted.

Solution

Add a decisions.md entry committing to Datomic as the migration target, explicitly superseding 2026-06-01 with rationale. Migration mechanics (cutover strategy, downtime window) and Datomic edition/hosting choice are deliberately left open for separate follow-up decisions — this entry commits to the target, not the timeline.

This is the first landed milestone of a broader roadmap (RDF/knowledge-graph alignment, Claude Design UX prototyping, AI-scraped OSS example prepopulation, DevRel community campaign) sequenced via a /grill-me alignment interview.

Father Watson Questions
  • What do we know? The vision requires an explicit data model; MongoDB's implicit schema blocks nearly every dependent workstream; Datomic was already under evaluation.
  • What do we need to know? Migration mechanics, Datomic edition/hosting choice, and who else (Thiago, Alex) should review/approve before the schema translation itself lands.
  • Where are we? Target committed; no schema file, migration plan, or infra decision exists yet.
  • Where are we going? Next: translate entity-attribute-model.edn into a Datomic schema, designed to be RDF-alignable per the existing OKF/dcterms/PROV-O convention.

🤖 Generated with Claude Code

Reverses the 2026-06-01 decision that ruled out a schema-bearing
database, now that the vision's data-model workstream needs an
explicit target. Migration mechanics and hosting choice are
deliberately left for separate follow-up decisions.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings July 17, 2026 19:02

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the project’s decision log to formally commit to Datomic as the migration target away from MongoDB, explicitly superseding the earlier 2026-06-01 decision that rejected schema-bearing storage assumptions.

Changes:

  • Adds a new 2026-07-17 decision entry documenting the Datomic migration target, rationale, alternatives, and open risks.
  • Updates the decision log frontmatter modified date to reflect the new entry.

Comment thread docs/decisions.md
## 2026-07-17 — Commit to Datomic as the MongoDB migration target

### Status
Decided — supersedes the [2026-06-01 decision](#2026-06-01--dual-format-entity-model-documentation)'s rejection of a schema-bearing database.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants