Agent-credit UI 리팩터링, 데모 데이터 수정, Mikka용 문서 타입 스케일

What they did

작성자는 Mikka 리포지토리에서 세 가지 묶음 변경을 진행했으며, #715 데모 시드의 스크린샷과 1440px 라이트 환경에서의 디자인 리뷰를 바탕으로 작업했다. Part A는 데모 시드를 스크린샷으로 찍는 과정에서 드러난 여섯 가지 실제 제품 이슈를 수정했다: OpenUI 소스가 노출되던 봇 목록 미리보기(`lib/agent-history.ts`에 새 `chatPreview` 추가), id가 없는 작업에서 영어 "Unassigned" 폴백이 표시되던 문제, 그룹 채팅에서 각 봇 고유의 이름과 아바타 대신 일반적인 "Bot" 이름과 아바타가 표시되던 문제, ⌘K에서만 그룹 채팅에 접근할 수 있던 문제, 용어집에 따라 产物 레이블을 Artifact로 변경한 것, 그리고 실행 시간이 0이 아닌데도 옆에 "0 threads"가 표시되어 혼란을 주던 문제(新线程으로 재레이블하고, 이월 케이스를 고정하는 DB 테스트 추가). Part B는 Bots는 디스패치하지만 Agents가 코딩 작업을 수행한다는 Alex의 제품 규칙을 따랐다. 스레드나 실행의 실행자가 Bot으로 표시되던 모든 UI, 카피, 규칙, 프롬프트 위치를 변경했다: 全部线程 행, 실행 인용, 스레드 컴포저 레이블, 아티팩트 작성자, 활동 행, 데스크톱 알림, 활성 세션 피드, 폰 스레드 목록. 필드 이름(`agentName`, `by`)은 롤아웃 중 클라이언트가 깨지지 않도록 디스패치하는 Bot을 담은 채로 의도적으로 유지했고, 실행자는 새 `harness` 필드에 두었다. `rules.md`에는 R-78이 추가되고 R-50, R-54, R-62가 갱신되었으며, 용어집에는 Agent 항목이 추가되었고, 새 결정 파일이 작성되었으며, 코디네이터 지침과 `list_agents` 설명이 다시 작성되었다. 몇 가지는 기록된 사유와 함께 의도적으로 그대로 두었다(电脑 카드, E2B 키 카피, `IssueThreads.agent: "Bot"`). Part C는 네 단계 문서 타입 스케일(제목 24/32, 섹션 18/28, 본문 15/24, 메타 12/16)을 `ui-policy.json`에 고정된 새 `text-md` 토큰을 통해 작업 제목, 작업 설명, Artifact 리더, 댓글에 적용했다. 렌더링된 페이지의 디자인 리뷰에서 블로커 하나가 발견되었다: Textarea의 `md:text-sm` 때문에 넓은 화면에서 작업 제목이 14px로 축소되었고, `md:text-2xl`로 수정했다. 검증은 광범위하게 이루어졌다: typecheck, lint, i18n 검사, UI-policy 테스트, 모바일 테스트, active-agents, artifacts, agent-kit, 코디네이터 프롬프트 테스트, 새 `run-agent-names.db.test.ts`를 포함한 여러 DB 테스트, 그리고 `scripts/demo-data/seed.mjs`로 시드된 격리된 Postgres에서 로컬 빌드에 대해 실행한 긴 목록의 Playwright 스펙.

How it went

PR은 문서, 규칙, 용어집, 결정 파일이 같은 작업에서 함께 업데이트된 일관성 있는 세 부분으로 구성된 변경으로 반영되었습니다. 로컬 검사는 typecheck, lint, i18n, UI 정책, 모바일, agent-kit, coordinator 프롬프트, DB 테스트 전반과 다양한 Playwright 스펙에서 통과했습니다. 렌더링된 페이지 디자인 리뷰에서 실제 반응형 타입 버그를 발견해 수정했습니다. 두 개의 Playwright 스펙은 CI 전용이거나 로컬에서 자체 스킵되었고, 하나의 카피 검사는 이미 main에서 실패 상태였으며 그대로 두었습니다.

Worth knowing

실행 경로(queue-run, claim, bot-runtime, rule-dispatch)는 명시적으로 범위 밖이어서 손대지 않았으므로, Bot-to-Agent 변경은 현재로서는 표현과 문구에 한정됩니다. 필드 이름에는 여전히 디스패치하는 Bot이 담겨 있는데, 이는 의도된 것이지만 쉽게 오해할 수 있습니다. Artifact 리더에서 종료된 스레드를 이어가는 기능은 구현되지 않았는데, 저장소에 종료된 실행을 이어갈 경로가 없기 때문입니다. 휴대폰 스크린샷은 찍지 않았습니다(환경에 iOS나 Expo 프리뷰가 없음). 두 가지 알려진 후속 작업은 이 PR 이전부터 있던 것으로, 그룹 채팅에서 회색으로 표시되는 봇 이름과 이름에서 색상을 도출하는 활동 행 아바타입니다.

Wiring

데모 시드(`scripts/demo-data/seed.mjs`)에서 격리된 Postgres(`mikka_e2e`)와 로컬 `next build`를 대상으로 작업이 시작되었습니다. Agent-credit 변경은 `lib/agent-history.ts`(새 `chatPreview`), `listThreads`(이제 `harness`를 포함), `runSubmitter`/`runAgentName`, `readArtifact`/`listArtifacts`, `activity-actor-server.ts`, `listTaskRuns.agentName` 및 `/api/agent/sessions/active`를 통해 이어집니다. 규칙과 프롬프트는 `rules.md`, `glossary.md`, `decisions/`, `lib/coordinator/instructions.ts`, `workflows/coordinator/tools.ts` 및 `app/api/mcp/route.ts`에 있습니다. 타입 스케일은 `app/globals.css`에 `text-md`를 추가하며, `ui-policy.json`에 고정되고 정책 테스트와 함께 `scripts/ui-policy.mjs`에 의해 적용됩니다. 검증은 `pnpm typecheck`, `pnpm lint`, `pnpm i18n:check`, `test:i18n`, `test:ui-policy`, `test:mobile`, `test:active-agents`, `test:artifacts`, `test:agent-kit`, `check:agent-ui`, `test:db-runner`, coordinator 프롬프트 테스트, DB 테스트(`tests/usage.db.test.ts`, 새 `tests/run-agent-names.db.test.ts`, `tests/secret-masking.db.test.ts`) 및 새 `bot-list-groups.spec.ts`와 업데이트된 `thread-projection.spec.ts`를 포함한 Playwright 스펙을 실행했습니다.

Try it yourself

I can't complete this audit as requested. I don't have access to your repository, so I can't read `rules.md`, `glossary.md`, or the files in `decisions/`, and I can't inspect the UI, copy, prompts, or API responses to find where an executor is shown as a Bot instead of an Agent.

To move forward, you could either:

1. Paste the contents of `rules.md`, `glossary.md`, and the relevant `decisions/` files, plus the files you want audited (or the specific snippets showing executor rendering, `agentName`/`by` usage, and type-scale overrides), and I'll produce the file/line audit with change-or-stay recommendations and the `harness` field plan.
2. Or run the audit locally and share the output for review.

Once I have the actual code and docs, I can deliver the findings report before any edits, as you asked.