Skip to content

Repin bc3 provenance ca1d34bc → d7bc88da (no-op range) + fix two stale api-gaps entries#416

Open
jeremy wants to merge 1 commit into
mainfrom
provenance-sync-d7bc88da
Open

Repin bc3 provenance ca1d34bc → d7bc88da (no-op range) + fix two stale api-gaps entries#416
jeremy wants to merge 1 commit into
mainfrom
provenance-sync-d7bc88da

Conversation

@jeremy

@jeremy jeremy commented Jul 25, 2026

Copy link
Copy Markdown
Member

Summary

Advance the bc3 provenance pin from ca1d34bcd7bc88da (bc3 master at 2026-07-24), and correct two spec/api-gaps/*.md entries whose upstream tails have since closed.

This is PR-0 of the multi-PR program absorbing the remaining BC3 follow-up contracts. It is a standalone provenance sync, warranted independent of the absorptions that follow.

Provenance range: reviewed no-op

ca1d34bc..d7bc88da = 30 commits, all non-API:

  • 26 UI/CSS/JS/lexxy commits
  • The duplicate-cookie migration auth commits (88cb86d2a, 52f1e9974, 7d86f1d06), which touch only app/controllers/concerns/authenticate/by_cookie.rb (a session-cookie concern) and its test — no route, controller, doc, or modeled API-contract change.

Pin date is unchanged (2026-07-24), so no SDK version bump. Only the provenance revision propagates into the go:embed; the other generated diffs are the usual generation-timestamp bumps.

Two stale api-gaps corrections (dropped during #401 reconciliation)

  • dock-tool-create-contract.md — bc3#12366 (8f938281) rewrote doc/api/sections/tools.md for the tool_type contract, closing the doc tail this entry still tracked as the open bc3#12364 note. Adds top-level bc3_pr: 12366.
  • schedule-recurrence-writes.md — bc3#12362 (ec17b83c) merged and now rejects week_instance: 0 (and other uncomputable schedules) at create time, so the previously-mandatory SDK-side guard is downgraded to optional hygiene.

Verification

make generate && make check — clean (71 conformance passed, 0 failed; 23 api-gap entries validated; deprecation parity clean).


Summary by cubic

Repins BC3 API provenance to d7bc88da (master at 2026-07-24) and refreshes generated metadata. Range reviewed as a no-op for the SDK (no API contract changes), so no SDK version bump.

  • Bug Fixes
    • Updated dock tool create api-gap to match upstream docs; BC3 PR 12366 documents the tool_type contract and closes the old tracking note.
    • Updated schedule recurrence api-gap; server now rejects week_instance: 0 at create time, so the SDK-side guard is optional hygiene.

Written for commit 32b7e1a. Summary will update on new commits.

Review in cubic

Copilot AI review requested due to automatic review settings July 25, 2026 04:11
@github-actions github-actions Bot added typescript Pull requests that update TypeScript code ruby Pull requests that update the Ruby SDK go spec Changes to the Smithy spec or OpenAPI labels Jul 25, 2026
@github-actions

github-actions Bot commented Jul 25, 2026

Copy link
Copy Markdown

Spec Change Impact

  • No operations, types, or resources were added, modified, or removed.
    The spec changes appear to be a no-op regarding API behavior, focusing on internal updates like repinning and fixing stale entries.

  • SDKs requiring regeneration: All SDKs need regeneration as part of standard protocol for any spec changes.

  • Breaking API change: No, this is not a breaking change.

Checklist of SDKs needing updates:

  • Go
  • TypeScript
  • Ruby
  • Kotlin
  • Swift

@github-actions github-actions Bot added the enhancement New feature or request label Jul 25, 2026

Copilot AI 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.

Pull request overview

Repins the upstream BC3 provenance revision (keeping the same provenance date) and refreshes SDK metadata outputs, while correcting two spec/api-gaps entries whose upstream documentation/behavior tails have closed.

Changes:

  • Advance provenance revision ca1d34bc… → d7bc88da… (date unchanged: 2026-07-24), propagating into both spec/ and Go’s embedded provenance copy.
  • Update spec/api-gaps/dock-tool-create-contract.md to record bc3#12366 as the doc-tail closure and add bc3_pr: 12366.
  • Update spec/api-gaps/schedule-recurrence-writes.md to reflect that bc3#12362 merged and now rejects week_instance: 0 server-side.

Tip

If you aren't ready for review, convert to a draft PR.
Click "Convert to draft" or run gh pr ready --undo.
Click "Ready for review" or run gh pr ready to reengage.

Reviewed changes

Copilot reviewed 5 out of 8 changed files in this pull request and generated no comments.

Show a summary per file
File Description
typescript/src/generated/metadata.ts Regenerated TS metadata timestamp (no functional change).
spec/api-provenance.json Update BC3 provenance revision to d7bc88da… (date unchanged).
spec/api-gaps/schedule-recurrence-writes.md Document server-side rejection for uncomputable recurrences (week_instance: 0).
spec/api-gaps/README.md Update README provenance-pin narrative to the new revision/range.
spec/api-gaps/dock-tool-create-contract.md Record upstream doc-tail closure (bc3#12366) and add bc3_pr.
ruby/lib/basecamp/generated/types.rb Regenerated Ruby types header timestamp (no functional change).
ruby/lib/basecamp/generated/metadata.json Regenerated Ruby metadata timestamp (no functional change).
go/pkg/basecamp/api-provenance.json Update embedded Go provenance copy to d7bc88da….

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@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: 461623af3c

ℹ️ 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 spec/api-gaps/README.md Outdated
Comment on lines +74 to +77
> Provenance pin advanced to `d7bc88da` (2026-07-24). The `ca1d34bc..d7bc88da`
> range — 30 commits — is a reviewed no-op for the SDK: 26 UI/CSS/JS/lexxy
> commits, plus the duplicate-cookie migration auth commits (`88cb86d2a`,
> `52f1e9974`, `7d86f1d06`) that touch only

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 Account for the thirtieth upstream commit

The audit says this range contains 30 commits, but its breakdown accounts for only 29: 26 UI/CSS/JS/lexxy commits plus the three listed auth commits. Because the conformance pin may advance only after every drift item is triaged, the unclassified commit leaves the new pin unsupported; classify the remaining commit or correct the count before declaring the range a no-op.

AGENTS.md reference: AGENTS.md:L270-L274

Useful? React with 👍 / 👎.

@cubic-dev-ai cubic-dev-ai 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.

All reported issues were addressed across 8 files

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread spec/api-gaps/README.md Outdated
…e api-gaps entries

Advance the bc3 provenance pin from ca1d34bc to d7bc88da (bc3 master at
2026-07-24). The ca1d34bc..d7bc88da range is 30 commits, all reviewed
no-ops for the SDK: 26 UI/CSS/JS/lexxy commits plus the duplicate-cookie
migration auth commits (88cb86d2a/52f1e9974/7d86f1d06), which touch only
the by_cookie session-cookie concern and its test — no route, controller,
doc, or modeled API-contract change. Pin date is unchanged (2026-07-24),
so no SDK version bump.

Also correct two api-gaps entries whose upstream tails have since closed:

- dock-tool-create-contract: bc3#12366 (8f938281) rewrote
  doc/api/sections/tools.md for the tool_type contract, closing the doc
  tail the entry still tracked as the open bc3#12364 note. Add top-level
  bc3_pr: 12366.
- schedule-recurrence-writes: bc3#12362 (ec17b83c) merged and now rejects
  week_instance: 0 (and other uncomputable schedules) at create time, so
  the mandatory SDK-side guard is downgraded to optional hygiene.
@jeremy
jeremy force-pushed the provenance-sync-d7bc88da branch from 461623a to 32b7e1a Compare July 25, 2026 06:48
Copilot AI review requested due to automatic review settings July 25, 2026 06:48
@github-actions github-actions Bot added swift bug Something isn't working and removed enhancement New feature or request labels Jul 25, 2026

Copilot AI 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.

Pull request overview

Copilot reviewed 5 out of 9 changed files in this pull request and generated 1 comment.

Comment on lines 228 to 232
"DeleteTemplate",
"DeleteTool",
"DeleteWebhook",
"DeleteWormhole",
"DestroyGaugeNeedle",

@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: 32b7e1a71d

ℹ️ 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 on lines +56 to +59
computed") merged and now rejects `week_instance: 0` (and other
uncomputable schedules) at create time — previously it spun a worker
indefinitely. An SDK-side guard is therefore **no longer mandatory**; `0`
is a normal validation error on the wire, not a hang. Modeling `frequency`

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 Qualify the silent-discard rule for invalid recurrences

The newly documented rejection contradicts the contract summary above, which still says that any invalid recurrence_schedule is silently discarded with no validation error. When the planned PR-5 models error behavior, these two rules give implementers and tests incompatible expectations; qualify the earlier bullet so silent discard applies only to invalid shapes other than the uncomputable schedules rejected by #12362.

Useful? React with 👍 / 👎.

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

Labels

bug Something isn't working go ruby Pull requests that update the Ruby SDK spec Changes to the Smithy spec or OpenAPI swift typescript Pull requests that update TypeScript code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants