Skip to content

chore: close Workflow v2 epic release gates - #38

Merged
tim8es merged 4 commits into
mainfrom
chore/workflow-v2-epic-closeout
Sep 9, 2026
Merged

tim8es merged 4 commits into
mainfrom
chore/workflow-v2-epic-closeout

Conversation

@tim8es

@tim8es tim8es commented Sep 8, 2026

Copy link
Copy Markdown
Owner

Epic #20 closeout gate

Post-release closeout from main @ b67399ff03dcaafb917123b6b0e11212d3583462.

Scope is intentionally limited to:

No production runtime files are changed.

RED -> GREEN evidence

RED:

  • commit 492331b154788ec65b8403e45c9051b0469badc9
  • run 34292630701
  • Python 3.10: 327 tests, exactly one intended failure: missing docs/COMMIT_DISCIPLINE.md
  • representative end-to-end dogfood already passed in RED, confirming no runtime fix was required.

GREEN:

  • exact head 31c6c02ee98a2a59862261e4af4bf0f4a8bc30ba
  • run 34293033405, conclusion success
  • Python 3.10 job 102283541487: 327/327 OK
  • Python 3.12 job 102283541387: 327/327 OK
  • merge-ref 598be206aa225b53ce4ebdbb0b5b169d2392f78f = exact head merged into the reviewed base.

Dogfood gate

The new representative test creates a fresh two-chapter workspace and exercises the real CLI/runtime through:

  1. extract + validate + sealed corpus verify;
  2. deterministic resume;
  3. Translator durable claims and machine accept-translation;
  4. Reviewer claims, PASS ledger records and accept-review;
  5. canonical REVIEW_REPORT.md with 100% current PASS coverage and no stale/missing units;
  6. atomic finalize producing STATE.md and FINAL_QUALITY_GATES.md;
  7. post-finalize validate + corpus verify;
  8. resume reporting complete;
  9. validated EPUB build, output manifest and build-status=current.

.github/workflows/ contains only the generic optional tests.yml; runtime orchestration has no GitHub Actions dependency.

Diff boundary

Only four files differ from base:

  • docs/AGENT_SETUP.md
  • new docs/COMMIT_DISCIPLINE.md
  • docs/ORCHESTRATION.md
  • new tests/test_workflow_v2_epic_closeout.py

No deploy is part of this PR. PR #36 remains a historical non-merge CI harness.

@tim8es
tim8es marked this pull request as ready for review September 9, 2026 00:02
@tim8es
tim8es merged commit e2abab5 into main Sep 9, 2026
2 checks passed

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 31c6c02ee9

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread docs/ORCHESTRATION.md

`STATE.md`, `FINAL_QUALITY_GATES.md`, and `REVIEW_REPORT.md` are generated projections of authoritative machine state. They are deterministic human-readable evidence, not lifecycle or review authority. Handwritten range audits or edits to generated Markdown must never be used to manufacture PASS coverage or completion. When authoritative state changes, regenerate the projections through the normal review-report/finalize paths.

Repository contributors and Git-backed book workflows should follow `docs/COMMIT_DISCIPLINE.md` for audit-friendly commit boundaries, provenance, and revert/recovery behavior. That document governs Git history as a secondary audit trail; it does not replace the machine-state acceptance rules in this orchestration contract.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Ship the commit guidance with runtime installations

For repository-API or namespaced installations that copy only the documented runtime set, docs/COMMIT_DISCIPLINE.md is absent because docs/AGENT_SETUP.md classifies it as development-only, yet this orchestrator contract directs Git-backed book workflows to follow it. Those supported installations therefore cannot access the referenced recovery and history guidance; either include the file in the runtime set or limit this direction to development checkouts.

AGENTS.md reference: AGENTS.md:L40-L44

Useful? React with 👍 / 👎.

Comment on lines +51 to +52
workflows = sorted(path.name for path in workflow_dir.glob("*.yml"))
self.assertEqual(workflows, ["tests.yml"])

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Include YAML-suffixed files in the workflow gate

If an orchestration Action is added with GitHub's supported .yaml suffix, this test ignores it and still passes as long as tests.yml remains present, so the asserted “only generic optional CI workflow remains” gate does not enforce its stated policy. Collect both *.yml and *.yaml workflows before comparing the directory contents.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant