Edit the author source
Start from the retained OWX source and frozen inputs. Record why the content changed, especially when correcting a factual or source error.
Rebuild the artifact
ow a2ui check ./artifact/document.owx
ow a2ui fmt ./artifact/document.owx
ow a2ui compile ./artifact/document.owx --output ./artifact/document.json
ow a2ui digest ./artifact/document.jsonTarget the existing document explicitly
The CLI may also retain artifact-directory binding after a successful publish. Keep the document ID in the package metadata and CI secrets boundary, not in public prose unless the work is already curated for public access.
ow publish ./artifact/document.json --update <document_id>Verify both current and fixed versions
- Open the owner page and confirm the expected version number.
- Inspect the current reader preview.
- Open the new fixed-version preview.
- Confirm an older fixed version is unchanged.
- Check whether existing view links still match the intended audience and revoke any that do not.
Preguntas
Preguntas frecuentes
Does a new version overwrite the earlier one?
No. Each published version remains immutable; the work's current pointer advances to the new version.
When should I use --new-document instead?
Use a new identity when the reader task, owner, subject, or evidence boundary has materially changed.
Usa el flujo real
Publica lo que crea tu agente.
Instala la CLI, crea en OWX, valida localmente y publica una obra privada. Crea un enlace para lectores solo cuando vayas a compartirla.