openclaw/ui/src
Peter Steinberger 799ddbd35d
refactor(comments): deslop production narration
## What Problem This Solves

Production code still carries duplicated narration over function names, types, branches and CSS selectors. Some of that prose has drifted: Zalo polling is described as development-only even though it is the default production route, and a joined hook helper is called fire-and-forget.

## User Impact

No user-visible behavior changes. Runtime logic, templates, CSS declarations, configuration, persisted state, wire formats, public API documentation, licenses and lint-suppression reasons remain intact.

## Why This Change Was Made

This maintainer-requested cleanup removes redundant internal helper/registrar summaries, repeated section labels, and obsolete inline font-size history. Existing declarations and shared owners already express these facts; no new abstraction is needed. Comments explaining authority, lifecycle, ordering, cleanup, platform constraints, dependencies and public contracts stay.

The measured reduction is 696 net production/tooling lines: 604 standalone comment lines and 92 adjacent blank lines, plus 59 inline comment removals without net line savings. No tests or generated files changed. This is a bounded contextual sweep, not a claim of exhaustive repository coverage; the local census records exact findings, retained candidates, and unread files. Filename-header cleanup from #161768 is excluded.

## Evidence

Independent review completed; all accepted documentation findings were addressed by restoring base comments. The remaining changed files are byte-identical to the reviewed and remotely frozen candidate.

Blacksmith Testbox validation:
- Parser comparison: identical non-comment TypeScript tokens and CSS structure.
- Both import-cycle checks: 0 cycles.
- Focused existing tests: 40 Vitest shards passed (521.71 seconds).
- Plugin contracts: 48 files / 1,153 tests passed.
- Plugin, source-to-extension, and SDK/package import-boundary checks passed.
- Feishu asset hook check: no build hooks; no plugin browser/control-UI source changed.

SDK API comparison passed with no API changes. The full changed-file gate passed remotely. The lowered-threshold duplicate census (12 lines / 80 tokens) completed; its raw 155 records include deliberate probe/fixture matches and are not claimed as removable production code. No tests were added or changed.

Public JSDoc was audited independently: the SDK API comparison strips comments, while shipped declarations can preserve them, so API-shape equality alone would not prove documentation preservation.


### Inherited hosted CI failure

Exact-head [CI run 36815106181](https://github.com/openclaw/openclaw/actions/runs/36815106181) tested `ff26a4c05d3b41d25477df41cb94010c6cac5cb0` merged with main `75d1f82c18`. The only failing test job was `checks-node-compact-small-19`: `test/helpers/openclaw-test-instance.acquisition.test.ts:33`, “keeps an absent Gateway unreachable while retaining its port claims,” expected `free` but received `busy`. The other failure is the aggregate CI gate. This attempt has 84 successful jobs, 16 skipped jobs, and 88 collateral cancellations; cancelled coverage is not counted as passing.

The identical assertion and error were independently verified in [job 110052175838](https://github.com/openclaw/openclaw/actions/runs/36763489663/job/110052175838), the latest attempt (1) for unrelated PR #162070's final head `d07a6981d4`. The acquisition test, instance helper, cleanup wrapper, isolated-state writer, port allocator, claim owner, claim-lock owner and TCP probe are byte-identical between that head and this PR. No changed file participates in the failing acquisition/probe path. The failure precedes Gateway startup; the logs do not identify the competing listener, so no root-cause repair is claimed.

Landing uses the maintainer-authorized inherited-failure exception pinned to this exact head, backed by the passing remote gates above. The fixture defect remains with the main-CI coordinator. No workflow rerun, test weakening, timeout increase, or source repush was used to obtain green. GitHub's GraphQL writer rejected auto-merge because its quota was exhausted; the request was reconciled as absent before selecting the supported REST squash path.
2026-09-30 22:28:36 -07:00
..
api test(core,plugins,ui): remove low-value tests (batch d122) (#162355) 2026-10-01 03:54:56 +00:00
app perf(ui): record only route-reachable modules in the boot manifest (#162382) 2026-09-30 22:00:49 -07:00
assets/themes
components feat(sessions): import Claude Code and Codex transcripts into OpenClaw (#161955) 2026-09-30 22:12:42 -07:00
e2e feat(sessions): import Claude Code and Codex transcripts into OpenClaw (#161955) 2026-09-30 22:12:42 -07:00
features/github-connections test(ui,plugins): remove low-value tests (batch d103) (#161313) 2026-09-29 19:49:49 +00:00
i18n feat(sessions): import Claude Code and Codex transcripts into OpenClaw (#161955) 2026-09-30 22:12:42 -07:00
lib fix: clear obsolete publication failures after work is published (#162257) 2026-10-01 04:30:26 +00:00
lit refactor(ui): route store subscriptions through the subscriptions controller (#161666) 2026-09-29 23:53:01 -07:00
pages refactor(comments): deslop production narration 2026-09-30 22:28:36 -07:00
plugins feat(control-ui): let plugins dock conversations (#161957) 2026-09-30 10:15:46 -07:00
styles refactor(comments): deslop production narration 2026-09-30 22:28:36 -07:00
test-helpers fix(ui): sidebar hides saved-draft and attachment outbox badges until the conversation is reopened (#162049) 2026-09-30 20:57:41 -07:00
types refactor(ui): deslop UI lib and shell second pass (#161433) 2026-09-29 21:36:00 -07:00
app-navigation-groups.test.ts test(ui,plugins): remove low-value tests (batch d103) (#161313) 2026-09-29 19:49:49 +00:00
app-navigation.test.ts test(ui,plugins): remove low-value tests (batch d103) (#161313) 2026-09-29 19:49:49 +00:00
app-navigation.ts refactor(ui): deslop UI lib and shell second pass (#161433) 2026-09-29 21:36:00 -07:00
app-route-paths.test.ts
app-route-paths.ts refactor(ui): deslop UI lib and shell (#161102) 2026-09-29 13:47:42 +00:00
app-routes.test.ts refactor(ui): retire the global Tasks workspace (#158217) 2026-09-25 17:10:15 -07:00
app-routes.ts feat(ui): add a native conversation surface for the macOS app (#159739) 2026-09-27 11:09:51 -07:00
app-session-path-builder.ts
app-session-route-paths.ts refactor: fold duplicated helpers onto canonical owners (#159409) 2026-09-27 09:24:28 -07:00
build-info-normalizers.ts refactor(ui): finish UI lib and shell third-pass cleanup (#161864) 2026-09-30 05:42:10 -07:00
build-info-types.ts
build-info.test.ts
build-info.ts
css.d.ts refactor(ui): deslop UI lib and shell second pass (#161433) 2026-09-29 21:36:00 -07:00
dev-gateway.ts
local-storage.ts refactor(ui): deslop UI lib and shell second pass (#161433) 2026-09-29 21:36:00 -07:00
main.ts refactor(ui): deslop UI lib and shell second pass (#161433) 2026-09-29 21:36:00 -07:00
markdown-it-emoji.d.ts
styles.css