Skip to content

chore(frontseat-api): GH-201 reword product references to neutral terms - #232

Merged
joaodinissf merged 1 commit into
mainfrom
chore/201-neutral-consumer-terms
Jul 29, 2026
Merged

chore(frontseat-api): GH-201 reword product references to neutral terms#232
joaodinissf merged 1 commit into
mainfrom
chore/201-neutral-consumer-terms

Conversation

@jbadeau

@jbadeau jbadeau commented Jul 28, 2026

Copy link
Copy Markdown
Collaborator

Supersedes #228 (auto-closed by the history-rewrite force-push). #229 is stacked on this branch.

Second checklist item of #201: references to specific downstream products in the OSS surface are reworded to product-neutral terms ("IDE integrations", "aggregating consumers") in the proto comments, apis/README.md, libs/frontseat-api-ts/README.md, and the remote-only-execution design doc, with Go/TS code regenerated.

The regen also catches up pre-existing drift in committed generated code:

  • the TypeScript gen still contained the removed relations/query/order_by fields and was produced by an older protoc-gen-es (2.12.1 → 2.13.0, both within the declared ^2.2.0 range)
  • bytestream.connect.go lagged its source proto's header comment

🤖 Generated with Claude Code

References to specific downstream products in the OSS surface (proto
comments, API READMEs, the remote-only-execution design doc) become
product-neutral: "IDE integrations" and "aggregating consumers".

Regenerating also catches up pre-existing codegen drift: the committed
TypeScript gen still contained the removed relations/query/order_by
fields and predates protoc-gen-es 2.13.0, and bytestream.connect.go
lagged its source proto's header comment.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

@joaodinissf joaodinissf left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Generated code verified rather than assumed: the agent decoded both FileDescriptorProtos (buf-built at head vs the rawDesc extracted from the committed .pb.go) and they correspond exactly to the proto edit — no hand-editing.

Three product references survive the sweep, going into a follow-up PR rather than blocking this one:

  • libs/frontseat-api-ts/src/index.ts:3,12-13 — the same two sentences reworded in the sibling README, and package.json declares files: ["dist", "src"], so this one ships in the npm tarball.
  • libs/frontseat-daemon/internal/transport/catalog_connect_adapter.go:88(IDEs, portals) on the doc comment for taskSchemaVersion, the constant populating the very schema_version field whose proto comment this PR rewrote.
  • libs/frontseat-api-ts/buf.gen.yaml:1-2 — repo-visible only.

This review was published with assistance from Claude.

@joaodinissf
joaodinissf merged commit 2d69832 into main Jul 29, 2026
1 check passed
@joaodinissf
joaodinissf deleted the chore/201-neutral-consumer-terms branch July 29, 2026 06:12
joaodinissf added a commit that referenced this pull request Aug 1, 2026
…uct references

GH-232 neutralised the downstream-product names across the proto
comments, apis/README.md, libs/frontseat-api-ts/README.md and the
remote-only-execution design doc, but three sites kept the old wording.

src/index.ts matters most: package.json lists "src" in files, so that
header ships verbatim in the published @frontseat/api tarball — the
sibling README it paraphrases was already reworded. buf.gen.yaml is
repo-visible only. The taskSchemaVersion comment sits on the constant
that populates ListTasksResponse.schema_version, the very field whose
proto comment GH-232 rewrote.

Comments only; no generated code and no behaviour change.

Co-Authored-By: Claude Opus 5 (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.

2 participants