Smeldr/core

Typed backend for decisions, tasks, and content that people and AI agents write to at the same time. Every item has an enforced lifecycle: a Decision moves proposed → ratified only when the right role approves it. Every relation between items is checked, not assumed: a background sweep flags connections that no longer hold.
A real decision, from this repo's own history:
json
"decisionnumber": "D59",
"state": "ratified",
"body": "Goals are places: new contains RelationStore kind (working name) gives Smeldr a first-class, user-defined taxonomy... Any item relates to a Goal via the new kind; the taxonomy is user/org-defined since Goals are already freely created, not a fixed enum.",
"nextevalat": null
Smeldr's own architecture decisions are tracked as Decision items and ratified the same way any Smeldr-hosted decision is. Full text: DECISIONS.md (D59); excerpted above for length.
bash
cd example/server
SECRET=changeme ENABLEORCHESTRATION=1 go run .
Start a chat with your favorite agent, create content together and then...
...build and publish websites. Edit sections, upload images and manage access directly in chat. Hook up your workflow states to AI actions.
...schedule, change, delete posts on X, Mastodon or LinkedIn
...build apps and manage data and automate workflows
...manage multiple agents to react to signals with the built-in agent runtime
...track decisions with a freshness cycle: propose, ratify, re-evaluate, so nothing silently goes stale
Or coordinate your entire pipeline and automated workflow, AI actions and human review included.
Directly from chat.
v1.174.0 — stable. Public APIs are stable within v1.
See CHANGELOG.md.
## 30-second start
bash
git clone https://github.com/smeldr/core
cd core
cd example/blog
go run .
# open http://localhost:8080
### Generic server (no custom content types)
example/server is a deployable binary with no hard-coded Go content types —
define everything at runtime via MCP:
bash
cd example/server
SECRET=changeme go run .
Optional subsystems are gated by environment variables (ENABLETOKENS,
ENABLEGOVERNANCE, ENABLERELATIONS, ENABLEDYNAMICCONTENT, ENABLEBLOCKS,
ENABLEMEDIA, ENABLESOCIAL, ENABLEWEBHOOKS, ENABLEPROVENANCE,
ENABLESTRUCTURALSWEEP, ENABLEAGENTS, OAUTHISSUER).
Set any to a non-empty value to enable that subsystem. See example/server/main.go
for the full variable reference and wiring order.
## What Smeldr gives you
Content
Full CRUD — create, update, publish, archive, and delete through a single Module[T]
Draft-safe lifecycle — drafts return 404 to guests; only Published content is visible
Draft preview — share a signed ?preview= URL to let reviewers see a draft without logging in
Scheduled publishing — set a future ScheduledAt; Smeldr transitions to Published automatically
Content negotiation — one endpoint serves JSON, HTML, or Markdown based on Accept
AI-native
AI indexing — /llms.txt compact index, /llms-full.txt Markdown corpus, and per-item /aidoc endpoints
MCP integration — connect AI agents to read and write content via the Model Context Protocol
Auth & security
Role-based auth — Guest → Author → Editor → Admin enforced per-module, per-operation
Cookie compliance — /.well-known/cookies.json declares cookie categories for GDPR tooling