Skip to content

docs(changelog): post-v0.5.0 cleanup of orphaned phase refs#52

Merged
pykul merged 1 commit into
mainfrom
docs/post-v0.5.0-changelog-fixes
May 27, 2026
Merged

docs(changelog): post-v0.5.0 cleanup of orphaned phase refs#52
pykul merged 1 commit into
mainfrom
docs/post-v0.5.0-changelog-fixes

Conversation

@pykul

@pykul pykul commented May 26, 2026

Copy link
Copy Markdown
Member

Summary

Doc-expert review of PR #51 surfaced three CHANGELOG entries that survived the v0.5.0 release consolidation but no longer make sense to a reader:

  • CHANGELOG.md:2075 — orphaned "None for sensor users on v0.4.0 Phase 1." (the "v0.4.0 Phase 1" label was the draft heading that consolidation collapsed away)
  • CHANGELOG.md:782 / 883 / 1260"v0.6 enforces policy decisions" prose from when MCP Policy was in soft-launch and v0.6 was the target enforcement release. D145 retired the soft-launch before v0.5.0 shipped, so enforcement is the current behaviour, not a v0.6 promise.
  • CHANGELOG.md:9 — minor casing typo (v0.5.0 phasev0.5.0 Phase 4)

10 insertions, 11 deletions. No code changes; the published v0.5.0 artefacts (PyPI / Docker Hub / GitHub Release) are unaffected.

Deferred to v0.5.1 (from same review batch)

Not included here, queued as follow-up work:

  • Security: pin GitHub Actions to SHAs (release.yml), helm chart default Postgres password fallback ("flightdeck"), tok_dev silent default in the plugin's observe_cli.mjs (now amplified by marketplace install path)
  • QA: Swagger API version still embedded as "0.1.0" in api/docs/ and ingestion/docs/; absent helm lint + marketplace.json schema gates in CI; dashboard/package.json version still at 0.1.0 (private, not published)

Test plan

  • CI green (plugin + sensor + go + dashboard + integration + e2e)
  • CHANGELOG renders cleanly on GitHub release page (no broken anchor links)

🤖 Generated with Claude Code

Doc-expert review of the v0.5.0 release prep PR (#51) flagged two
items that survived the CHANGELOG consolidation:

1. ``CHANGELOG.md:2075`` carried ``"None for sensor users on v0.4.0
   Phase 1."`` inside the demoted Agent identity model foundation
   sub-section. The "v0.4.0 Phase 1" label was the original draft
   heading that consolidation collapsed away, leaving the phrase
   pointing at nothing. Replaced with ``"None."`` -- the surrounding
   ``### Breaking changes`` heading already scopes it.

2. ``CHANGELOG.md:782/883/1260`` carried ``"v0.6 enforces policy
   decisions as configured"`` prose written when MCP Policy was
   still in soft-launch and v0.6 was the target enforcement
   release. D145 retired the soft-launch override before v0.5.0
   shipped, so enforcement is the current behavior, not a planned
   v0.6 change. Rewrote to describe the present-tense behavior
   (``Block decisions raise MCPPolicyBlocked; warn decisions log
   and pass through``).

3. ``CHANGELOG.md:9`` minor typo (``v0.5.0 phase`` lowercase) ->
   ``v0.5.0 Phase 4`` capitalized to match the rest of the doc.

No code changes. Release tag v0.5.0 (commit 1ba1fcd) is unchanged
and published artifacts on PyPI / Docker Hub / GitHub Releases are
not affected.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@pykul
pykul merged commit c2be234 into main May 27, 2026
6 checks passed
pykul added a commit that referenced this pull request May 27, 2026
Post-release cleanup addressing the DIRTY findings from the v0.5.1
prep PR (#54) reviewer fan-out. Mirrors yesterday's #52 pattern.

CHANGELOG.md:
- Promotes the bundled-Postgres password breaking change out of
  "Security / hardening" into its own "### Breaking changes"
  subsection (the intro paragraph cross-references "see the breaking
  note below" so the subsection had to exist)
- Drops inline "(D100)" reference per CLAUDE.md rule 41 (no
  D-numbers in code/comments/CHANGELOG prose; describe behavior in
  plain English instead). Replaced with "zero-config default-token
  path"
- Tightens intro: "one bugfix, one breaking change, five hardening /
  infrastructure items" (was "six hardening items deferred", which
  conflated the bugfix and CI-gate items with security work)
- Updates [flightdeck] WARN reference to include the colon (matches
  the actual emitted format after the consistency fix below)

plugin/README.md:
- Documents FLIGHTDECK_QUIET in the env-var table (the v0.5.1 WARN
  message instructs users to set it; the table previously had no
  row, leaving operators stranded)

plugin/hooks/scripts/observe_cli.mjs:
- WARN format consistency: "[flightdeck] WARN: ..." (colon) to match
  the existing "[flightdeck] WARN:" pattern at lines 223 and 295.
  Behavior unchanged, format aligns

plugin/tests/observe_cli.test.mjs:
- 3 new unit tests pinning the tok_dev WARN contract: emits when
  FLIGHTDECK_TOKEN unset, suppressed by FLIGHTDECK_QUIET=1, silent
  when FLIGHTDECK_TOKEN is explicitly set. Each test captures
  process.stderr.write into a buffer and restores in finally so a
  resolveConfig failure doesn't leave the runner with a broken
  stderr stream. 91 → 94 tests.

.github/workflows/ci.yml:
- Pins azure/setup-helm to commit SHA bf6a7d304b... (was @v4
  mutable tag). Matches the SHA-pinning discipline established
  across all 7 actions in release.yml; closes the gap surfaced by
  the security reviewer.

Deferred to Supervisor scope decision (NOT in this PR):
- api.auth.jwtSecret / api.auth.adminPassword `required` guard in
  helm/templates/secret.yaml. Same shape as the postgres.password
  fix but a SECOND breaking change for existing helm installs that
  bootstrap auth via post-render or a separate secret. Needs scope
  authorization before landing; recommend v0.5.2.

Co-authored-by: pykul <omria@Omri-PC.localdomain>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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