Skip to content

Ban non-semantic code comments - #2624

Merged
SawyerHood merged 1 commit into
mainfrom
bb/delete-typescript-comments-codemod-thr_pz28rvtnwb
Aug 28, 2026
Merged

Ban non-semantic code comments#2624
SawyerHood merged 1 commit into
mainfrom
bb/delete-typescript-comments-codemod-thr_pz28rvtnwb

Conversation

@SawyerHood

Copy link
Copy Markdown
Collaborator

Human comments

What was wrong

The repository allowed explanatory code comments without a common removal tool or a lint check.

What changed

  • Added a TypeScript codemod that removes non-semantic comments from tracked TypeScript files.
  • Added a fixable bb/no-comments Oxlint rule and enabled it for the repository.
  • Kept compiler, test, lint, format, coverage, bundler, and shebang directives.
  • Kept comments in the public Plugin SDK declaration sources.
  • Removed existing non-semantic TypeScript comments and updated generated outputs.
  • Added the comment policy to AGENTS.md.

How you verified

  • pnpm run codemod:remove-typescript-comments removed zero comments on a second run.
  • pnpm exec turbo run lint
  • pnpm exec turbo run typecheck
  • pnpm exec turbo run test --filter=@get-bb/plugin-sdk --force
  • pnpm exec turbo run test --filter=@bb/mobile --force
  • node packages/plugin-registry/scripts/build-registry.mjs --check
  • git diff --check

AGENT GENERATED

@SawyerHood
SawyerHood merged commit 8b22136 into main Aug 28, 2026
15 checks passed
@SawyerHood
SawyerHood deleted the bb/delete-typescript-comments-codemod-thr_pz28rvtnwb branch August 28, 2026 03:57
ymichael added a commit that referenced this pull request Aug 31, 2026
…omments

Land the dispatch-queue rework on main's newer trunk:

- HOST_DAEMON_PROTOCOL_VERSION resolves to 176 (main's 175 + 1) with the
  branch narration reduced to the one thing a daemon observes: the three
  branch-only `system/*` event types leaving `threadEventSchema`. Main
  deleted the historical narration block, so the file keeps main's shape.
- @get-bb/plugin-sdk bumped 0.4.30 -> 0.4.31 via scripts/bump-plugin-sdk.mjs
  (main had moved past the branch's stale 0.4.33 lineage); bundled types,
  sdk-public-api.json and the plugin registry snapshots regenerated.
- thread-create uses main's resolveManagedBaseBranchForCreate shape;
  #2616 removed resolveManagedNamedBaseBranchSpec and the originKind arm.
- Composer queue UI adopts main's "follow-up" wording (#2695) while keeping
  the branch's queue rows, wait lines and visuals.
- The bb-cli and bb-plugin-authoring skills were restructured on main into
  references/; the branch's CLI surface (`--send-at`, queued delivery,
  `bb thread count`, `bb thread retry`) and plugin surface
  (`bb.experimental_hooks`, `message.queued`/`message.dispatched`/
  `turn.failed`, the new SDK type exports) are documented there instead.
- apps/app comments removed to satisfy main's `bb/no-comments` rule (#2624).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
ymichael added a commit that referenced this pull request Aug 31, 2026
…omments

Land the dispatch-queue rework on main's newer trunk:

- HOST_DAEMON_PROTOCOL_VERSION resolves to 176 (main's 175 + 1) with the
  branch narration reduced to the one thing a daemon observes: the three
  branch-only `system/*` event types leaving `threadEventSchema`. Main
  deleted the historical narration block, so the file keeps main's shape.
- @get-bb/plugin-sdk bumped 0.4.30 -> 0.4.31 via scripts/bump-plugin-sdk.mjs
  (main had moved past the branch's stale 0.4.33 lineage); bundled types,
  sdk-public-api.json and the plugin registry snapshots regenerated.
- thread-create uses main's resolveManagedBaseBranchForCreate shape;
  #2616 removed resolveManagedNamedBaseBranchSpec and the originKind arm.
- Composer queue UI adopts main's "follow-up" wording (#2695) while keeping
  the branch's queue rows, wait lines and visuals.
- The bb-cli and bb-plugin-authoring skills were restructured on main into
  references/; the branch's CLI surface (`--send-at`, queued delivery,
  `bb thread count`, `bb thread retry`) and plugin surface
  (`bb.experimental_hooks`, `message.queued`/`message.dispatched`/
  `turn.failed`, the new SDK type exports) are documented there instead.
- apps/app comments removed to satisfy main's `bb/no-comments` rule (#2624).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
ymichael added a commit that referenced this pull request Sep 1, 2026
…omments

Land the dispatch-queue rework on main's newer trunk:

- HOST_DAEMON_PROTOCOL_VERSION resolves to 176 (main's 175 + 1) with the
  branch narration reduced to the one thing a daemon observes: the three
  branch-only `system/*` event types leaving `threadEventSchema`. Main
  deleted the historical narration block, so the file keeps main's shape.
- @get-bb/plugin-sdk bumped 0.4.30 -> 0.4.31 via scripts/bump-plugin-sdk.mjs
  (main had moved past the branch's stale 0.4.33 lineage); bundled types,
  sdk-public-api.json and the plugin registry snapshots regenerated.
- thread-create uses main's resolveManagedBaseBranchForCreate shape;
  #2616 removed resolveManagedNamedBaseBranchSpec and the originKind arm.
- Composer queue UI adopts main's "follow-up" wording (#2695) while keeping
  the branch's queue rows, wait lines and visuals.
- The bb-cli and bb-plugin-authoring skills were restructured on main into
  references/; the branch's CLI surface (`--send-at`, queued delivery,
  `bb thread count`, `bb thread retry`) and plugin surface
  (`bb.experimental_hooks`, `message.queued`/`message.dispatched`/
  `turn.failed`, the new SDK type exports) are documented there instead.
- apps/app comments removed to satisfy main's `bb/no-comments` rule (#2624).

Co-Authored-By: Claude Fable 5 <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