Commit Graph

10 Commits

Author SHA1 Message Date
b08ca85b2e docs(security): add SAFE-MCP advisory 2026-04-17
Adds content/docs/security/ section:
- security/index.mdx — section landing page
- security/safe-mcp-advisory.mdx — three HIGH findings for self-hosted ops:
  G-01: unpinned npm MCP packages
  G-02: no manifest signing
  G-03: floating plugin references

Updates meta.json with Security nav section.

Pairs with: monorepo PRs #808, #809
Deadline: April 22, 2026

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-04-19 12:31:09 +00:00
Hongming Wang
54a86a3aa1
Merge pull request #22 from Molecule-AI/docs/daily-changelog-2026-04-17
docs(site): daily changelog 2026-04-17
2026-04-19 00:52:37 -07:00
Hongming Wang
3b126e1892
Merge pull request #9 from Molecule-AI/docs/hermes-dispatch-513
docs(site): Hermes multi-provider dispatch page
2026-04-19 00:52:08 -07:00
4a275835e4 docs(site): daily changelog 2026-04-17
Customer-facing CHANGELOG page summarising 80+ merged PRs for 2026-04-17:
new features (opencode MCP bridge, Slack Bot API, AG-UI SSE, A2A topology
canvas overlay, audit trail panel, workspace hibernation, Temporal checkpoints,
semantic memory search, Hermes stacked system messages + native tools + structured
output, AGENTS.md auto-gen, Discord adapter, budget limits, token metrics, Opus 4.7
effort/task_budget, plugin supply-chain hardening, Fly Machines provisioner),
security fixes, and docs PR cross-references.

Adds changelog.mdx and nav entry at top of meta.json pages array.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-17 23:37:34 +00:00
molecule-ai[bot]
7287e31bb2
docs(site): workspace config — Opus 4.7 effort levels and task budget (#608)
Adds content/docs/workspace-config.mdx covering:
- Config tab overview (how to open, form vs raw YAML mode)
- Claude Settings panel: gating condition, where to find it in the UI
- Effort levels table: low / medium / high / xhigh (extended thinking) / max
  with descriptions, use-case guidance, cost/latency/quality tradeoffs
- Task budget: token ceiling, 20k minimum, when it applies, sizing guidance
- config.yaml reference with three annotated examples
- Beta header note: task-budgets-2026-03-13 added automatically by executor
- Executor wiring callout: config stored today, executor wiring ships next release
Updates meta.json: adds workspace-config after concepts in the nav.

Closes #608 (docs portion)
Source PRs: molecule-monorepo#639 (effort + task_budget UI), #654 (max level)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-17 07:14:41 +00:00
54b659fd6e docs(site): add Hermes multi-provider dispatch page (pairs with monorepo PR #555)
Adds content/docs/hermes.mdx — full reference for Hermes Phases 2a/2b/2c:
dispatch table (key priority order), secrets setup, quickstart for native
Anthropic + Gemini paths, multi-turn history demo, multi-provider fan-out
example, capability table (shipped vs Phase 2d roadmap), and troubleshooting.
Updates meta.json to add hermes to the Runtimes nav section.

Pairs with: Molecule-AI/molecule-monorepo#555 (docs/devrel-feat-hermes-multimodel)
Source PRs: molecule-core#240 (Phase 2a), #255 (Phase 2b), #267 (Phase 2c)
Closes #513

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-17 00:51:45 +00:00
molecule-ai[bot]
0a4b8119c4
docs: add Google ADK runtime adapter documentation (#4)
Pre-draft docs for the google-adk workspace adapter (issue #542, PR #550).
Covers installation, secrets, config reference, A2A compatibility, plugin
support, and troubleshooting. Also adds google-adk to the runtimes table
in architecture.mdx and the runtime list in concepts.mdx.

Closes #542

Co-authored-by: Molecule AI Documentation Specialist <documentation-specialist@agents.moleculesai.app>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-04-17 00:36:27 +00:00
Hongming Wang
a620e5a7a3 docs: comprehensive content for all 15 documentation pages
Previously 7 pages were stubs ("Coming soon"). Now all 15 have full content:

- index.mdx: SaaS subdomain table, runtime adapters, MCP/SDK links
- quickstart.mdx: 3 setup options (dev-start.sh, docker-compose, manual), SaaS alternative
- concepts.mdx: added external agents, Lark channel, tokens, MCP integration
- architecture.mdx: system diagram, 4 components, infra services, health detection, deployment modes
- api-reference.mdx: all 80+ routes across 19 categories with auth requirements
- channels.mdx: Telegram, Slack, Lark/Feishu adapters with config examples
- plugins.mdx: two-axis model, 12 built-in plugins, install safeguards
- schedules.mdx: cron syntax, concurrency handling, supervision, org template examples
- org-template.mdx: YAML structure, defaults layer, plugin UNION, template registry
- self-hosting.mdx: dev-start.sh, docker-compose, env vars, production deployment
- observability.mdx: activity logs, Langfuse, Prometheus, liveness, WebSocket events
- troubleshooting.mdx: 10 common issues with fixes

Build verified: 19/19 static pages generated.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 10:05:12 -07:00
Hongming Wang
4f5bdc3f79 feat: add External Agents, Token Management, MCP Server docs
New pages:
- external-agents.mdx — step-by-step remote agent registration guide
  with Python (Flask) and Node.js (Express) working examples
- tokens.mdx — create, list, revoke workspace bearer tokens
- mcp-server.mdx — 87-tool reference with API route mapping

Framework upgrade (fumadocs v15.8 had a build crash "a.map is not a
function" in DocsLayout page tree formatter — unfixable without upgrade):
- fumadocs-core/ui: 15.8 → 16.7
- fumadocs-mdx: 11.10 → 14.3
- next: 15.5 → 16.2
- react/react-dom: 19.0 → 19.2

Migration: RootProvider import path, source import path, search route
stubbed (full-text search TBD after fumadocs v16 search API stabilizes).

Build: 19/19 static pages generated successfully.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 09:14:45 -07:00
rabbitblood
7cdc0bc9b4 init: scaffold doc.moleculesai.app with Fumadocs + Next.js 15
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.
2026-04-14 21:01:17 -07:00