[Molecule-Platform-Evolvement-Manager]
PR #59 (commit dae42e2) was merged ~2 weeks ago with a bad diff that
deleted all Next.js/Fumadocs build files (package.json, app/, lib/,
source.config.ts, tsconfig.json, etc.) and most MDX content pages.
This broke the Vercel build, taking doc.moleculesai.app offline.
Root cause: the PR branch was likely rebased or reset to a state that
only contained the marketing/ subtree, so the merge diff showed
deletions for every other file.
This commit:
1. Restores all build infrastructure from the last good commit (86fa0e9)
2. Restores 25 deleted MDX content pages (concepts, quickstart, etc.)
3. Adds frontmatter (title) to 55 .md files added post-bad-merge that
were missing the required YAML frontmatter for Fumadocs
4. Removes duplicate quickstart.mdx (superseded by quickstart.md)
5. Adds CI workflow (.github/workflows/ci.yml) to catch build failures
on PRs before merge — this would have prevented the outage
Build verified: 99 static pages generated successfully.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Closes the TOCTOU race (PR #882/issue #819): documents that hibernation
uses an atomic SQL claim that aborts if active_tasks > 0 at commit time,
so no in-flight task is silently dropped.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Documents GET /workspaces/:id/events/stream — WorkspaceAuth-guarded
Server-Sent Events endpoint compatible with the AG-UI protocol.
Covers envelope format, event types, curl and JS examples.
Pairs with molecule-core PR #601 (closes#590).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- api-reference.mdx: add POST /workspaces/:id/hibernate to Lifecycle table;
callout explaining hibernated vs paused, 503+Retry-After auto-wake pattern,
and hibernation_idle_minutes config option
- concepts.mdx: add workspace status lifecycle table (all 7 statuses);
document hibernation as opt-in automatic cost-saving mode with link to API ref
Pairs with monorepo PR #724 (feat(registry): workspace hibernation).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
PR #784 added pgvector-backed semantic search to GET /workspaces/:id/memories.
When ?q= is supplied and an embedding function is configured, results are
ordered by cosine similarity and include a similarity_score field.
Documents the query parameter, response shape, and graceful FTS fallback
so callers know the endpoint is backwards-compatible.
Pairs with monorepo PR #784 (feat: pgvector semantic search, closes#776).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Customer-facing documentation site for Molecule AI. Built with Fumadocs
(open-source MIT, Next.js 15 App Router native, Tailwind v4, MDX) so we
own the deployment and aesthetic and can grow into custom doc components
for our agent-canvas flows.
## Why Fumadocs (over Mintlify, Nextra, Docusaurus)
- Open source, no vendor lock-in (vs Mintlify SaaS subscription)
- Built on Next.js 15 App Router — matches our existing canvas stack
- Less opinionated than Nextra; can grow into custom doc components
- React/Tailwind first; team already on this stack
- Ships search, dark mode, Shiki highlighting, MDX out of the box
## Initial structure
- app/ — Next.js App Router (home + docs + search route)
- content/docs/ — MDX source (3 hand-written + 9 stub pages)
- lib/source.ts — Fumadocs loader bound to the MDX content
- mdx-components.tsx — default + future custom MDX renderers
- source.config.ts — MDX compile config
## Hand-written launch content
- index.mdx — landing / what you can build / how it works
- quickstart.mdx — clone repo → docker compose → import template → talk to PM
- concepts.mdx — the five primitives: workspaces / plugins / channels / schedules / canvas
## Stub pages (Documentation Specialist agent fills these in on cron)
- org-template, plugins, channels, schedules
- architecture, api-reference, self-hosting
- observability, troubleshooting
## Ownership
The Documentation Specialist agent in the molecule-dev org template will
own this repo end-to-end:
- Watches PRs landing in the platform monorepo
- Auto-opens docs PRs when public APIs / templates / plugins / channels change
- Runs daily cron to backfill stubs and refresh stale pages
Manual edits welcome. Agent picks up on next cron tick.
