Skip to main content

Demiurge 0.3.0

Demiurge is alpha / developer-preview software. APIs, runtime layout, and authoring contracts may still change.

Summary​

This release adds session bootstrap context modules, moves workspace ownership from host configuration into agent core manifests, and publishes the new Docusaurus project website and hosted manual. It also reorganizes the manual around the host-owned harness and authored Agent Core boundary.

User-Visible Changes​

  • Agent cores can now declare agent/bootstrap/ modules that run once at session start and write bootstrap context into the session.
  • The default assistant core includes a bootstrap module that records the current workspace and local user in session-start context.
  • Workspace defaults now belong to runtime.workspace in each core manifest, with CLI --workspace, DEMIURGE_WORKSPACE, and launch-directory fallback still taking precedence.
  • Source core manifests now make default runtime, UI, approval, tool metadata, capability, dependency, and smoke-test fields explicit.
  • Runtime language and Python-version fields were removed from core manifests because code slots still run in the host-shared Python environment.
  • The TTS summarizer core manifest was updated to match the explicit manifest defaults.
  • Documentation was restructured into Getting Started, Concepts, Authoring, Operations, Reference, Developer Guide, and Releases sections.
  • A Docusaurus website was added for the project homepage and hosted manual, with GitHub Pages deployment workflow and local search.
  • Public-facing branding now uses Demiurge as the product name while command, package, path, and repository identifiers remain lowercase.

Breaking Changes​

  • runtime.workspace is no longer a supported field in ~/.demiurge/config.yaml. Configure a core-local workspace in ~/.demiurge/agents/<core>/agent.yaml, or keep using CLI --workspace / DEMIURGE_WORKSPACE for launch-time overrides.
  • Core manifest fields runtime.language and runtime.python were removed. Existing runtime cores that still contain those fields should be refreshed or edited before validation.
  • Documentation paths changed. The old flat docs/*.md pages were replaced by categorized paths such as docs/getting-started/quickstart.md and docs/authoring/agent-core-layout.md.

Known Limitations​

  • The package catalog is still local-only.
  • Code slots run in the host-shared Python environment by default.
  • Telegram is long-polling only.
  • Candidate core evolution and automatic promotion are still incomplete.
  • The Docusaurus site translates the homepage, navigation, footer, and sidebar labels first; full Chinese manual translation is not included in this release.
  • GitHub Pages deployment requires the repository Pages source to be set to GitHub Actions.

Verification​

  • uv run python -c 'import tomllib, demiurge; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"]); print(demiurge.__version__)'
  • git diff --check -- pyproject.toml demiurge/__init__.py README.md README.zh-CN.md docs website .github/workflows/pages.yml
  • cd website && npm run build