Skip to content

docs(ui): audit ui-kit for existing chat-adjacent UI primitives - #6474

Merged
loopover-orb[bot] merged 1 commit into
JSONbored:mainfrom
galuis116:docs/chat-ui-primitives-audit
Jul 16, 2026
Merged

docs(ui): audit ui-kit for existing chat-adjacent UI primitives#6474
loopover-orb[bot] merged 1 commit into
JSONbored:mainfrom
galuis116:docs/chat-ui-primitives-audit

Conversation

@galuis116

Copy link
Copy Markdown
Contributor

Closes #6244

Summary

Research-only groundwork for #6230's eventual chat interface spec (still open). Audits apps/loopover-ui/src/components/** and packages/loopover-ui-kit/src/components/** for anything already resembling the four primitives a chat surface will need — a scrollable message/timeline list, a text composer with submit-on-enter, a streaming/incremental text renderer, and a typing/in-progress indicator — and writes up what's reusable, what's close but needs adaptation, and what's entirely absent. Per the issue's own scope, no functional code changes accompany this: apps/loopover-ui/src/chat-ui-primitives-audit.md is the sole deliverable, following the same design-doc pattern as PR #5794 (#3048).

  • Reusable as-is: state-views.tsx's LoadingState/EmptyState/ErrorState/StateBoundary, scroll-area.tsx, avatar.tsx, and the raw textarea.tsx/input.tsx/button.tsx primitives.
  • Close but needs adaptation: audit-feed.tsx (filtered, live-fetched list — but table-rendered, not a bubble/timeline layout), command-palette.tsx (the only text-input + filtered-list combo in the app — but click-to-navigate, no Enter-to-submit handling), animated-terminal.tsx (interval-driven typewriter reveal with reduced-motion handling — the closest streaming-text precedent, but over a hardcoded static scene array, not a live stream).
  • Entirely absent: a submit-on-Enter composer; any real streaming consumer (grepped apps/loopover-ui/src for EventSource|ReadableStream|text/event-stream|streaming — the one hit is a comment in analytics-proxy.ts explaining why it deliberately avoids a streaming request body); a chat-bubble/message-list component; an inline typing indicator.

Scope

  • The PR title follows type(scope): short summary Conventional Commit format.
  • This PR is focused and does not mix unrelated backend, UI, MCP, docs, dependency, and deploy changes.
  • This follows CONTRIBUTING.md and does not reintroduce GitHub Pages, VitePress, site/, or CNAME.
  • I linked a currently open issue this PR resolves — Closes research: audit ui-kit for existing message/chat-adjacent UI primitives #6244.

Validation

  • git diff --check
  • npm run actionlint
  • npm run docs:drift-check
  • npm run manifest:drift-check
  • npm run command-reference:check
  • npm run ui:lint — 0 errors, only pre-existing warnings in unrelated files.
  • npm run ui:typecheck / npm run ui:build — both fail identically on a clean main checkout in this sandbox, verified via git stash: ui:typecheck can't resolve the codegen modules collections/browser/collections/server (missing a content-collections build step in this environment), and ui:build can't resolve @scalar/api-reference from @scalar/api-reference-react's dist output. Neither references this PR's new file (apps/loopover-ui/src/chat-ui-primitives-audit.md — a .md file not imported anywhere) and both reproduce byte-for-byte on unmodified main.
  • Root npm run typecheck / npm run test:coverage — not run; this sandbox's root typecheck reliably OOMs regardless of diff content (reproduced repeatedly across prior PRs this session via git stash comparison), and this PR has no src/** code changes for Codecov to measure.
  • npm audit --audit-level=moderate — 0 vulnerabilities.
  • New/changed behavior has tests — N/A, pure documentation addition, no code paths added.

If any required check was skipped, explain why:

  • ui:typecheck/ui:build: pre-existing sandbox environment issues (a missing codegen step and an unresolvable third-party subpackage), confirmed unrelated to this diff by reproducing the identical failure on a clean main checkout before and after stashing this PR's single new file.
  • Root typecheck/test:coverage: this sandbox's established OOM pattern (unrelated to diff content, confirmed repeatedly this session), and moot here since no src/** files changed.

Safety

  • No secrets, wallet details, hotkeys, coldkeys, user PATs, private keys, raw trust scores, private rankings, or private maintainer evidence are exposed.
  • Public GitHub text stays sanitized, low-noise, and does not imply compensation guarantees or optimization tactics.
  • Auth, cookie, CORS, GitHub App, Cloudflare, or session changes include negative-path tests. — N/A, no such changes.
  • API/OpenAPI/MCP behavior is updated and tested where needed. — N/A, no API/MCP surface touched.
  • UI changes use live API data or real empty/error/loading states, not production mock/demo fallbacks. — N/A, no UI behavior changed; this only documents existing UI primitives.
  • Visible UI changes include a UI Evidence section below with screenshots. — N/A, no visible UI change (a new internal doc file only).
  • Public docs/changelogs are updated where needed; changelogs are only edited for release-prep PRs. — CHANGELOG.md untouched.

Notes

  • This is the audit/inventory deliverable only, per the issue's explicit instruction ("Do not build anything new — this is a research/audit deliverable only"). Spec: conversational chat interface for loopover (Lovable/Cursor-style) #6230 (the parent chat-interface spec) is still open with its own scope/backend/placement decisions unresolved; this doc is intended to inform that eventual implementation, not to prejudge it.

…bored#6244)

Research-only groundwork for JSONbored#6230's eventual chat interface: an
inventory of what apps/loopover-ui and packages/loopover-ui-kit
already have that a future chat surface could reuse against the four
primitives it will need (message list, composer, streaming renderer,
typing indicator).

- Reusable as-is: state-views.tsx's loading/empty/error scaffolding,
  scroll-area.tsx, avatar.tsx, and the raw textarea/input/button
  primitives.
- Close but needs adaptation: audit-feed.tsx (filtered live-data list,
  but table-rendered, not bubble-rendered), command-palette.tsx (the
  only text-input + filtered-list combo, but click-to-navigate, no
  Enter-to-submit), animated-terminal.tsx (interval-driven typewriter
  reveal over static scenes, the closest streaming-text precedent).
- Entirely absent: a submit-on-Enter composer, any real streaming
  consumer (grepped for EventSource/ReadableStream/text/event-stream
  across apps/loopover-ui/src — the one hit is a comment explaining
  why analytics-proxy.ts deliberately avoids a streaming body), a
  chat-bubble/message-list component, and an inline typing indicator.

No functional code changes accompany this doc, per the issue's own
scope ("do not build anything new").

Closes JSONbored#6244
@galuis116
galuis116 requested a review from JSONbored as a code owner July 16, 2026 09:37
@superagent-security

Copy link
Copy Markdown
Contributor

Superagent didn't find any vulnerabilities or security issues in this PR.

@loopover-orb loopover-orb Bot added the gittensor:feature Gittensor-scored feature linked to a feature issue — scores a 0.25x multiplier. label Jul 16, 2026
@loopover-orb

loopover-orb Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Important

🟪🟪🟪🟪🟪🟪🟪🟪🟪🟪🟪🟪

🔍 LoopOver is reviewing…

AI analysis is in progress. This comment will update when the review is complete.

🟩 Safe / merged · 🟦 Advisory · 🟨 Held for review · 🟥 Blocked / closed · 🟪 Reviewing

@loopover-orb loopover-orb Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

LoopOver approves — the gate is satisfied and CI is green.

@loopover-orb
loopover-orb Bot merged commit ab25367 into JSONbored:main Jul 16, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

gittensor:feature Gittensor-scored feature linked to a feature issue — scores a 0.25x multiplier.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

research: audit ui-kit for existing message/chat-adjacent UI primitives

1 participant