Skip to content

OpenUdon Release Note Template

Candidate

  • Version:
  • Date:
  • Commit:
  • Dirty worktree state:
  • Eval corpus size:
  • Minimum eval brief gate:
  • Provider:
  • Model:
  • Prompt version:
  • Comparison baseline:
  • Structured mode count:
  • Legacy fallback count:
  • Pass rate:
  • Maximum attempts for any brief:
  • Blocking reference issues:
  • Secret-scan failures:
  • Release-gate result:
  • Expanded-corpus evidence exception:
  • SaaS operator demo fixtures:
  • SaaS operator demo dry-run result:
  • Trusted executor report paths:
  • Async evidence sidecar paths:
  • Run evidence verifier result:
  • Product smoke dry-run result:
  • Product smoke live result:
  • Product smoke summary JSON:
  • Required Slack live smoke result:
  • Optional provider live skips:
  • n8n bridge validation result:
  • Optional iCoT authoring-eval report:
  • Optional iCoT authoring-eval provider/model:
  • Optional iCoT authoring-eval pass summary:
  • Optional iCoT authoring-eval credential-scan result:
  • Optional iCoT authoring-eval failure-category summary:
  • Optional iCoT authoring-eval run ID/digest:
  • Optional iCoT authoring-eval retention/share-safety metadata:
  • iCoT variant provider-family coverage result:
  • iCoT scorecard provenance run ID/commit/prompt/readiness versions:
  • iCoT scorecard digest:
  • iCoT scorecard retention/share-safety metadata:
  • iCoT scorecard report verify result:
  • Optional iCoT authoring-eval report verify result:
  • iCoT scorecard missing-detail false-pass count:
  • iCoT scorecard unsafe false-pass count:
  • iCoT scorecard needs-input diagnostic-gap count:

Local Checks

  • GOWORK=off go mod download:
  • GOWORK=off go test ./... -count=1 -timeout=10m:
  • GOWORK=off go vet ./...:
  • clean source-archive standalone test/vet:
  • go test ./...:
  • go vet ./...:
  • make check:
  • git diff --check:
  • make release-check:
  • make release-saas-check:
  • make icot-variants-validate:
  • make icot-authoring-scorecard:
  • make product-smoke-check:
  • make product-smoke-live:
  • make release-evidence provider-free local udon smoke:
  • six-platform three-binary cross-build:
  • actionlint:
  • mkdocs build --strict:
  • openudon validate ./examples/uws-validation:
  • openudon check-doc-memory:
  • openudon n8n-bridge validate --root examples/eval:
  • Selected SaaS fixture lint:
  • SaaS demo trusted dry-run:
  • Sibling checkout layout (../uws, ../apitools, optional ../udon):
  • openudon readiness --run-gates:
  • Readiness JSON:

Publication

  • Annotated tag:
  • GitHub Actions test run:
  • GitHub Actions release run:
  • Published platform archives:
  • SHA256SUMS verification:
  • Linux amd64 openudon version --json:
  • Isolated go install ...@v0.1.0:
  • Installed-binary credential-free golden path:

Real-LLM Smoke

Command:

make release-eval

make release-eval is opt-in real-provider evidence. Keep make release-check as the deterministic pre-tag gate and record provider credentials/model context separately from deterministic evidence.

Report paths:

  • JSON:
  • Markdown:
  • Optional iCoT authoring-eval JSON:

Comparison:

  • Baseline JSON:
  • Pass-rate delta:
  • Brief regressions:
  • Attempt regressions:
  • Blocking-reference regressions:
  • Failing-check regressions:

Provider Drift Watch

  • Status:
  • Structured fallback count:
  • Structured fallback delta:
  • Rate/transient failures:
  • Model availability:
  • Maximum attempts-to-pass:
  • Attempt regressions:
  • Release-gate failures:
  • Eval JSON provider_drift_watch:
  • Rerun evidence, if provider drift was suspected:

SaaS Operator Demo

Demo fixtures:

  • Single-service:
  • Multi-service:

Provider-free commands:

# See docs/saas-operator-release.md for the ignored-workdir script.

Evidence:

  • Quality Markdown paths:
  • Review Markdown paths:
  • Approval JSON paths kept local/ignored:
  • Dry-run config paths kept local/ignored:
  • Boundary notes:

Product Smoke Matrix

Commands:

make product-smoke-check
OPENUDON_EXECUTOR=/absolute/path/to/udon make product-smoke-live

Evidence:

  • Summary JSON kept local/ignored:
  • Slack live message/channel confirmation:
  • Local stub-backed live scenarios:
  • Optional provider live scenarios run:
  • Optional provider live scenarios skipped for missing env:
  • Failed or blocked scenarios:

Known External Blockers

Decision

  • Release decision:
  • Reviewer:
  • Notes: