Skip to content

ci+docs: release hardening — playbook rewrite + publish-policy lint (#564, #557)#584

Merged
bradygaster merged 4 commits intodevfrom
squad/release-hardening
Mar 24, 2026
Merged

ci+docs: release hardening — playbook rewrite + publish-policy lint (#564, #557)#584
bradygaster merged 4 commits intodevfrom
squad/release-hardening

Conversation

@bradygaster
Copy link
Copy Markdown
Owner

Summary

Closes #564, closes #557. Also resolves #558, #559, #560 (absorbed into playbook sections).

Release playbook (#564) — PAO

Replaces the stale 58-line v0.8.22 stub with a 232-line living, version-agnostic release playbook. 11 sections:

  1. Overview (two channels, SDK-first order)
  2. Pre-flight checklist (runnable commands, pass/fail)
  3. Publish via CI (recommended — GitHub Release trigger)
  4. Publish via workflow_dispatch (manual trigger)
  5. Insider channel
  6. Workspace publish policy (references CI lint rule)
  7. Manual local publish / emergency fallback (Define publish fallback and escalation protocol #559)
  8. 422 race condition & npm errors (Document 422 race condition and mitigation for workflow changes #558)
  9. Post-publish verification
  10. Version bump after publish
  11. Legacy publish scripts (deprecated)

CI publish-policy lint job (#557) — FIDO

New publish-policy job in squad-ci.yml scans all workflow YAML for bare npm publish without -w/--workspace. Blocks PRs that would publish the root package instead of workspace packages.

  • 36 new tests in test/publish-policy.test.ts
  • Validates all 15 existing workflow files pass the check
  • Build clean, all tests passing

Copilot AI added 4 commits March 23, 2026 23:59
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Adds a lightweight publish-policy CI job to squad-ci.yml that scans all
workflow YAML files for bare npm publish commands missing -w/--workspace.
Prevents accidental root package publishing (v0.9.1 incident class).

Also adds test/publish-policy.test.ts (36 tests) validating the lint
logic against known good/bad patterns and all live workflow files.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…aybook

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Merge 3 decision inbox files into decisions.md (flight-release-hardening-plan, fido-publish-policy, eecom-personal-init-fix)
- Delete inbox files post-merge (no duplicates)
- Write session log: 2026-03-24T06-release-hardening.md
- Append team updates to PAO and FIDO history.md noting playbook + CI lint contributions
- Release hardening work (issues #564, #557) complete; #562 deferred to Brady (admin API access required)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@bradygaster bradygaster force-pushed the squad/release-hardening branch from c0eda9d to 02a493c Compare March 24, 2026 07:00
@bradygaster bradygaster merged commit 2f5e89e into dev Mar 24, 2026
3 checks passed
@bradygaster bradygaster deleted the squad/release-hardening branch March 24, 2026 07:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

2 participants