Scriptum Workflows

Last validated: 2026-05-14

This workflow guide is now split into focused runbooks. Each workflow includes:

• Dodil CLI steps (dodil scriptum ...)
• Direct gRPC examples (grpcurl)
• HTTP guidance (management endpoints and gateway contracts where applicable)

Workflow Index

1. 06-workflows/01-bootstrap-author-and-publish.md
   • Create script, save draft, compile/test, publish first stable version.
2. 06-workflows/02-run-observe-and-retrieve.md
   • Execute pinned versions, monitor progress, retrieve full outputs and step details.
3. 06-workflows/03-human-in-the-loop-resume.md
   • Handle ask pauses and resume with validated input.
4. 06-workflows/04-env-promotion-and-rollback.md
   • Promote env/version changes safely and roll back quickly when needed.
5. 06-workflows/05-incident-debugging-playbook.md
   • Incident triage, deep diagnostics, evidence collection, and stabilization loop.

Quick Recommendations

1. Use Dodil CLI for covered operations and day-to-day workflows.
2. Use gRPC (grpcurl) for API capabilities not yet exposed in CLI (resume, template, script env overlay, script code retrieval).
3. Use HTTP management endpoints (/health, /ready, /metrics) for runtime checks.
4. When gateway is present, HTTP-annotated API paths can be used for REST-style integrations.

Related Docs

• 04-api-reference.md
• 05-cli-guide.md
• 09-scriptum-dsl-reference.md