Skip to content

docs(changelog): scope E101S07a entries to OSS daemon work only#216

Open
Fr-e-d wants to merge 1 commit intomainfrom
fix/changelog-e101s07a-oss-cloud-boundary
Open

docs(changelog): scope E101S07a entries to OSS daemon work only#216
Fr-e-d wants to merge 1 commit intomainfrom
fix/changelog-e101s07a-oss-cloud-boundary

Conversation

@Fr-e-d
Copy link
Copy Markdown
Owner

@Fr-e-d Fr-e-d commented Apr 28, 2026

Summary

Strip + webhook secret provisioning [endpoint] from the v2.19.0 and v2.20.0 entries for feat(E101S07a). That half of the original commit subject referred to PUT /api/v1/workspaces/:id/webhook-secrets/:source — a Cloud-side REST endpoint (workers/gaai-cloud/api/src/rest/workspaces.ts) that never ships to GAAI-framework via sync-framework-to-oss.sh (only .gaai/core/ is snapshotted).

Per DEC-70 (gaai-oss and gaai-cloud are independent products), the OSS CHANGELOG must describe only what an OSS user can install and use without running gaai-cloud.

Diff

Both lines rewritten to:

feat(E101S07a): daemon HMAC-SHA256 signing of outbound webhook POSTs (X-Hub-Signature-256 + X-Webhook-Source headers, GAAI_DAEMON_WEBHOOK_SECRET env var)

This describes exactly what landed in .gaai/core/scripts/delivery-daemon.sh (compute_webhook_hmac helper + header injection at 4 call sites + env var declaration) and in .gaai/core/scripts/tests/test-webhook-hmac.sh.

Root cause

Upstream commit d3f5c347 feat(E101S07a): daemon HMAC signing + webhook secret provisioning (#466) bundled OSS daemon edits (3 files in .gaai/core/) with a Cloud REST endpoint (2 files in workers/gaai-cloud/) into one PR/one commit. The auto-sync replays commit subjects verbatim into CHANGELOG.md, so the Cloud half leaked into OSS release notes.

Discipline patch in upstream gaai-platform repo (memory rule extended to forbid mixed-scope stories/commits — boundary check on cross-product diffs).

Test plan

  • Verify diff only touches CHANGELOG.md (2 lines)
  • Confirm rewritten lines accurately describe what is in .gaai/core/scripts/delivery-daemon.sh at the relevant version
  • Merge

🤖 Generated with Claude Code

Strip "+ webhook secret provisioning [endpoint]" from the v2.19.0 and
v2.20.0 entries. That half of the original commit subject referred to
PUT /api/v1/workspaces/:id/webhook-secrets/:source — a Cloud-side REST
endpoint (workers/gaai-cloud/api/src/rest/workspaces.ts) that never
syncs to GAAI-framework via sync-framework-to-oss.sh.

Per DEC-70 (gaai-oss and gaai-cloud are independent products), the OSS
CHANGELOG must describe only what an OSS user can install and use
without running gaai-cloud. The OSS-relevant change is the daemon HMAC
signing helper + header injection in delivery-daemon.sh.

Root cause: upstream commit subject conflated OSS daemon edits with a
Cloud REST endpoint into one feat() line, and the auto-sync replays
commit subjects verbatim into the CHANGELOG. Discipline patch tracked
in gaai-platform (boundary check on cross-product commits).

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