Skip to content

chore(mobile): purge comments from packages/mobile - #14806

Merged
dylanjeffers merged 2 commits into
chore/comment-purge-webfrom
chore/comment-purge-mobile
Nov 21, 2026
Merged

dylanjeffers merged 2 commits into
chore/comment-purge-webfrom
chore/comment-purge-mobile

Conversation

@dylanjeffers

Copy link
Copy Markdown
Contributor

Stacked on #14802, which is stacked on #14796. Merge those first.

What

Runs /delete-comment on packages/mobile. All 2,405 non-exempt comment blocks are handled:

Category Blocks Lines Action
Tautology 1,660 3,138 deleted
Stale 59 208 deleted
Excuse 82 138 deleted, filed as #14803 (components/harmony-native), #14804 (screens), #14805 (store/services/app shell)
Decision record 604 1,936 deleted, moved into docs/adr/0020–0027

Net effect on packages/mobile: −5,592 / +186 lines across 597 files.

Bugs found and confirmed in source

These are listed first in the issues:

Ratchet change

@format and JSDoc type annotations in plain JS files (e.g. @type {import('metro-config').MetroConfig}) are now exempt, because TypeScript reads them. The baseline is lowered; 2,902 comments / 5,792 lines remain repo-wide.

Verification

Compared against a pristine checkout of #14802:

  • tsc --noEmit: identical error set (52 pre-existing, from local dependency drift).
  • eslint src: identical (6 pre-existing).
  • Directive counts in packages/mobile are identical (@ts-ignore, @ts-expect-error, eslint-disable, prettier-ignore, @format, globals, worklet).
  • Jest was not run locally: the shared node_modules predates react-native-worklets, so the jest resolver fails on both base and branch. CI's mobile job installs fresh and covers it.

What's left

libs (1,170 blocks), then identity-service, protocol-dashboard, sdk non-JSDoc and the small packages.

🤖 Generated with Claude Code

Deletes all 2,405 non-exempt comment blocks in packages/mobile. Decision
records move to docs/adr/0020-0027. Excuses, including four confirmed
bugs, are tracked in #14803-#14805.

Also exempts @Format and JSDoc type annotations in plain JS files from
the ratchet, and lowers the baseline.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@changeset-bot

changeset-bot Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: aed6915

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Stacked on #14806 → #14802 → #14796. Merge in that order.

## What

The last `/delete-comment` pass. It covers every package not yet purged:
libs, identity-service, protocol-dashboard, sdk (non-public internals),
harmony, embed, es-indexer, commands, create-audius-app, migrate-tool,
docs, fixed-decimal, spl, eth, eslint-config-audius, distro and
`svgo.config.js`. **After this PR the repo has zero non-exempt comments
and `.comment-baseline.json` is `{}`.**

| Category | Blocks | Lines | Action |
| --- | ---: | ---: | --- |
| Tautology | 2,312 | 4,391 | deleted |
| Stale | 122 | 324 | deleted |
| Excuse | 107 | 167 | deleted, filed as #14807 (libs), #14808
(identity-service), #14809 (protocol-dashboard), #14810
(sdk/harmony/embed/tooling) |
| Decision record | 353 | 884 | deleted, moved into
`docs/adr/0028`–`0033` (one per package group) |

Net effect on code: **−5,762 / +281 lines**.

### Bugs found and confirmed in source

These are listed first in the issues:
- `libs` `CreatorNode._makeRequestV2`: dereferences the optional
`storageNodeSelector` in its catch block, so a failed request throws a
TypeError that hides the real error (#14807).
- `libs` `Web3Manager`: there is no identity fallback when the discovery
relay returns null, so `parseLogs` throws (#14807).
- `protocol-dashboard` `ServiceTable`: calls a hook inside `renderRow`
behind an `eslint-disable` (#14809).
- `commands` `aao.ts`: block and unblock post to two different discovery
hostnames (#14810).
- `identity-service`: three old migration `down` steps reference the
deleted `Notification` model (low impact, #14808).

### Fixes to the earlier PRs in this stack

- Restores the 17 `@deprecated` JSDoc blocks that #14796, #14802 and
#14806 removed from common, web and mobile. TypeScript and editors read
the tag, so it is now exempt.
- Exempts generator "DO NOT EDIT" headers, since
`generateServicesConfig.ts` rewrites them.

## Verification

Compared against a pristine checkout of #14806:
- `tsc --noEmit` in all 13 packages with a tsconfig: identical error set
(146 pre-existing, from local dependency drift in protocol-dashboard,
commands, sdk and fixed-decimal).
- `lint` in every package with a lint script: no new errors.
- `sdk` vitest: same result (1 pre-existing failing file, 31 passing).
- Repo-wide directive counts are identical before and after
(`@ts-ignore`, `@ts-expect-error`, `eslint-disable`, `prettier-ignore`,
`@format`, `globals`, `@deprecated`, `@__PURE__`, `webpackChunkName`,
`istanbul`).
- `npm run lint:comments` passes with an empty baseline.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
@dylanjeffers
dylanjeffers merged commit ed232c3 into chore/comment-purge-web Nov 21, 2026
@dylanjeffers
dylanjeffers deleted the chore/comment-purge-mobile branch November 21, 2026 16:02
dylanjeffers added a commit that referenced this pull request Nov 21, 2026
Removes every non-exempt code comment from the apps repo and adds a CI
ratchet so new ones fail. This PR now contains the folded stack: #14802
(web), #14806 (mobile) and #14811 (all remaining packages).

## Result

- **11,113 comment blocks removed**, about 23,800 lines of code.
- **Decision records** (2,139) moved into `docs/adr/0002`–`0033`, each
with a permalink to the original line.
- **Excuses** (363 TODOs/hacks) filed as grouped checklists, with
confirmed bugs listed first: #14793–#14795, #14798–#14801,
#14803–#14805, #14807–#14810.
- **Tautologies and stale comments** deleted.

## Ratchet

- `npm run lint:comments` (`scripts/comment-ratchet.cjs`) runs in
`.github/workflows/comments.yml`. `.comment-baseline.json` is now `{}`,
so any new non-exempt comment fails CI.
- Exempt:
- tool directives (`eslint-disable`, `@ts-*`, `prettier-ignore`,
`@format`, bundler pragmas, `globals`, test-env pragmas)
  - `@deprecated`
  - JSDoc type annotations in plain JS
  - generator "DO NOT EDIT" headers
  - public-API JSDoc in `sdk`, `harmony`, `fixed-decimal` and `spl`
- `examples/`, vendored `public/` and `*.min.js`, and generated SDK code
- Policy: [ADR 0001](docs/adr/0001-no-code-comments.md). The
`/delete-comment` skill (`.claude/skills/delete-comment/`) repeats the
process.

## Verification

Each pass was compared against a pristine checkout of its base:
- `tsc` and lint: identical error sets for every touched package.
- Tests: identical results for common, web and sdk.
- Directive counts: identical repo-wide.
- Mobile jest couldn't run locally (stale shared `node_modules`). It
runs in this PR's CI now that the stack targets `main`.

## Deploy note

Merging deploys identity-service and embed automatically. Both changes
are comment-only. Web and mobile go out with the next gate and OTA as
usual.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.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