Asterdoc v0.9.0
Released 2026-10-29
Paradoc is now Asterdoc. 0.9 renames the packages, the CLI, the project files and the hosts, and starts a new schema history at 2026-10-28. The artifact format is the same as in Paradoc 0.8.
Highlights
- The packages are
@asterdoc/*. The CLI is@asterdoc/cli, or theasterdocpackage, and the command isasterdoc. - Schemas are at
https://schema.asterdoc.com. The current version,2026-10-28, has the same shape as Paradoc's2026-10-02. - Hosts move from
*.paradoc.devto*.asterdoc.com. The documentation is atdocs.asterdoc.comand the public registry is atpublic.asterdoc.com. - The source is at
github.com/asterdoc/asterdoc.
Breaking changes
All packages
- Each
@paradoc/*package is now the@asterdoc/*package with the same name. The@paradoc/*packages get no more releases.
Schemas
- The schema host is
schema.asterdoc.com, andSCHEMA_VERSIONSstarts again at2026-10-28. The Paradoc versions and their migration steps are removed, so aschema.paradoc.devaddress reads asunknown-version. - A signature
timestampand a lock fileinstalledAtmust include seconds.
CLI
- The command is
asterdoc, from@asterdoc/clior theasterdocpackage. It replacesparadocfrom@paradoc/cliorparadoc-cli. - A project uses
asterdoc.jsonand.asterdoc/, and user settings are in~/.asterdoc/config.json. - Environment variables start with
ASTERDOC_in place ofPARADOC_:ASTERDOC_SCHEMA_URL,ASTERDOC_NAMESPACE,ASTERDOC_NO_UPDATE_CHECK,ASTERDOC_TELEMETRY_DISABLED,ASTERDOC_TELEMETRY_URLandASTERDOC_TELEMETRY_DEBUG.
React
- The document root has the class
asterdoc-documentin place ofparadoc-document.
Agent skills
- The skills are
asterdocandasterdoc-react, fromgithub.com/asterdoc/asterdoc.
Upgrading from 0.8
- Replace each
@paradoc/*dependency with the@asterdoc/*package of the same name at0.9.0, and change the imports. - Remove
paradoc-clior@paradoc/cli, and install the CLI withnpm install -g asterdoc. - In each project, rename
paradoc.jsontoasterdoc.jsonand.paradoc/to.asterdoc/. Move~/.paradoc/config.jsonto~/.asterdoc/config.json. - Rename each
PARADOC_*environment variable toASTERDOC_*. - If an artifact is older than Paradoc's
2026-10-02, bring it to2026-10-02withparadoc migratefrom Paradoc 0.8. Then runasterdoc migrate <files> --from 2026-10-28. It changes only$schema, tohttps://schema.asterdoc.com/2026-10-28.json. - Change registry URLs and links from
*.paradoc.devto*.asterdoc.com, and publish your hosted artifacts again after step 5. - Install the agent skills again from
github.com/asterdoc/asterdoc.
Other changes
CLI
undiciandvitemove to patched releases.