learning_ai_common_plat/docs
saravanakumardb1 839f3ff794 docs+chore: CC.6 ANTIPATTERNS.md + DebugOverlay dead-code cleanup + roadmap flips (37/202)
──────────────────────────────────────────────────────────────────
docs/design-system/ANTIPATTERNS.md  (CC.6 — new file)
──────────────────────────────────────────────────────────────────
Twelve anti-patterns codified, every product engineer + AI agent
should treat as a hard 'no':

  1.  Hard-coded colour / spacing / radius values
  2.  Bespoke skeleton / spinner / empty-state per surface
  3.  Bespoke tag editor / searchable select
  4.  Raw API responses inside React state
  5.  Hidden privacy / cost / refusal state
  6.  Motion without prefers-reduced-motion
  7.  SSR-unsafe ID generation (Math.random)
  8.  console.log / console.error in production
  9.  Cross-product imports
  10. `any` (especially in public API surfaces)
  11. Untested primitives in @bytelyst/*
  12. Animations that block keyboard focus

Each entry has Smell → Why it's wrong → Do this instead, with
canonical `@bytelyst/*` references.

──────────────────────────────────────────────────────────────────
packages/ai-ui/src/DebugOverlay.tsx  (audit cleanup)
──────────────────────────────────────────────────────────────────
Dropped dead `patchSingleChild` helper. It cloned the single child
unchanged, doing literally nothing — the click handler always lived
on the outer <span>. Replaced the call site with `{children}` and
removed 4 unused React imports (Children, cloneElement,
isValidElement, ReactElement).

Same 98/98 tests pass.

──────────────────────────────────────────────────────────────────
Roadmap flips (this commit + the prior unflag pass)
──────────────────────────────────────────────────────────────────
  9.E.1   <Markdown> + citation interop                ai-ui@0.6.0
  9.E.2   <CodeDiff> split + unified                   ai-ui@0.6.0
  9.E.3   <ExplainThis>                                ai-ui@0.6.0
  9.E.4   usePromptHistory                             ai-ui@0.6.0
  9.E.5   useTokenCount                                ai-ui@0.6.0
  9.E.6   /showcase/ai-ui/markdown                     showcase
  13.C.4  <ProvenanceDrawer>                           ai-ui@0.5.0+
  13.C.5  <DebugOverlay>                               ai-ui@0.5.0+
  13.C.6  <PrivacyBadge>                               ai-ui@0.5.0+
  13.D.1  <Parallax>                                   motion@0.2.1
  13.D.5  <TiltGallery>                                motion@0.2.1
  CC.6    ANTIPATTERNS.md                              docs
  MAG.8   /showcase/futurism/debug-overlay             showcase

§11.2 counter rewrote (37 / 202 done · 18%)
  Wave 9 Data:      9/42  → 15/42 (36%)
  Wave 13 Futurism: 9/39  → 17/39 (44%)
  Cross-cutting:    0/8   →  1/8  (13%)
  Magnet demos:     2/8   →  3/8  (38%)

Three MAG.* magnets are now live:
   MAG.1 spatial-hero    (Wave 13.D.6)
   MAG.3 trust-surfaces  (Wave 13.C.7)
   MAG.8 debug-overlay   (Wave 13.C.5)
2026-05-27 17:08:08 -07:00
..
_MobileApps docs: add Apple App Store + Google Play Store release guides 2026-04-04 23:37:25 -07:00
architecture docs(inventory): refresh platform and workspace capability maps 2026-03-05 22:59:45 -08:00
audits docs(audits): mobile app readiness audit + companion targets implementation prompt 2026-03-27 08:19:32 -07:00
design docs: complete Platform Acceleration Roadmap (all 4 phases) — move to completed/ 2026-03-19 22:13:21 -07:00
design-system docs+chore: CC.6 ANTIPATTERNS.md + DebugOverlay dead-code cleanup + roadmap flips (37/202) 2026-05-27 17:08:08 -07:00
design-system-agents docs(design-system): rewrite agent prompts with parallel-safety, pre-flight checks, build gates, rollback recipes 2026-03-27 17:43:03 -07:00
devops chore(gitea): rename npm package owner ByteLyst -> learning_ai_user 2026-05-26 18:38:57 -07:00
ecosystem docs: add Hermes delegation channel 2026-05-25 02:18:28 +00:00
guides docs: align ecosystem docs with single-source-of-truth agent pattern 2026-05-23 12:07:58 -07:00
MCP+A2A docs: Update EXECUTION_CHECKLIST.md with Phase 15 completion 2026-03-05 22:07:53 -08:00
pnpm docs(pnpm): add MindLyst to migration tracker, update Gitea registry status 2026-03-24 08:28:11 -07:00
rfc ci(packages): close ROADMAP TODOs #5, #6 + draft RFC for #4 2026-05-27 11:49:21 -07:00
roadmaps docs(roadmaps): detailed 2026-04-17 plans for event bus, RAG, agent runtime, approval queue 2026-04-17 09:36:44 -07:00
runbooks docs(runbooks): GITEA_VM_SETUP.md — step-by-step cloud VM wiring 2026-05-27 03:46:09 -07:00
session-logs docs: reorganize docs/ into category folders with roadmaps/{completed,partial,not-started} 2026-03-01 23:17:15 -08:00
workstreams docs(workstreams): align checklist with service consolidation 2026-02-15 08:58:58 -08:00
AGENT_COMPLIANCE_ROADMAP.md docs(compliance): final roadmap update \u2014 100% ecosystem compliance reached 2026-05-23 19:34:49 -07:00
AUDIT_PLATFORM.md docs(audit): reconcile final handoff state 2026-05-04 17:39:48 -07:00
AUDIT_WARNING_COMPLETION_CHECKLIST.md docs(audit): reconcile final handoff state 2026-05-04 17:39:48 -07:00
BROADCAST_SURVEY_API_REFERENCE.md docs(broadcasts,surveys): Complete API reference documentation 2026-03-03 08:28:15 -08:00
CODEX_RESUME_PROMPT.md docs(audit): record auth test reliability fix 2026-05-04 16:59:53 -07:00
CROSS_REPO_DRY_AUDIT.md docs: fix 10 inaccuracies in DRY audit + roadmap after thorough review 2026-03-20 07:15:07 -07:00
DASHBOARD_UI_COVERAGE_ROADMAP.md docs: fix 10 bugs in dashboard UI coverage roadmap — self-audit corrections 2026-03-21 17:35:30 -07:00
DASHBOARD_UI_GAP_ANALYSIS.md docs(admin-web): update gap analysis — all Q1-Q4 TODOs resolved, 0 partially exposed pages 2026-03-21 23:15:24 -07:00
DESIGN_SYSTEM_AUDIT.md docs(audit): add Round 3 hardcoded hex elimination findings to DESIGN_SYSTEM_AUDIT.md 2026-03-29 10:40:47 -07:00
DESIGN_SYSTEM_REMEDIATION_PLAYBOOK.md docs: agent-executable design system remediation playbook — 5 phases, 20 tasks, code templates, verification commands 2026-03-27 16:08:27 -07:00
DESIGN_SYSTEM_REMEDIATION_ROADMAP.md docs(audit): mark all design system remediation roadmap items complete 2026-03-29 01:47:06 -07:00
ECOSYSTEM_CONSISTENCY_AUDIT.md docs: align ecosystem docs with single-source-of-truth agent pattern 2026-05-23 12:07:58 -07:00
ECOSYSTEM_CROSS_POLLINATION_OPPORTUNITIES.md docs: create canonical ecosystem docs home 2026-04-03 15:25:00 -07:00
HANDOVER.md docs(audit): reconcile final handoff state 2026-05-04 17:39:48 -07:00
learning_ai_common_plat_INVENTORY.md docs: align ecosystem docs with single-source-of-truth agent pattern 2026-05-23 12:07:58 -07:00
MOBILE_DRY_REFACTORING_ROADMAP.md docs: Add post-implementation review fixes section to roadmap 2026-03-20 23:16:19 -07:00
PROTOTYPE_DEPLOYMENT.md chore(docker): add interactive cleanup menu 2026-05-05 18:28:55 -07:00
ROADMAP_2026_DECISIONS.md feat(packages): close ROADMAP TODOs #1, #2, #3 — density tier, react-auth fix, routePrefix 2026-05-27 11:49:20 -07:00
STORYBOOK_TEMPLATE.md ci(packages): close ROADMAP TODOs #5, #6 + draft RFC for #4 2026-05-27 11:49:21 -07:00
UI_ROADMAP_2026_V3_CROSS_REPO.md docs+chore: CC.6 ANTIPATTERNS.md + DebugOverlay dead-code cleanup + roadmap flips (37/202) 2026-05-27 17:08:08 -07:00
UNIFIED_BYTELYST_PORTAL_PRD.md fix(docs): self-audit Portal PRD + roadmap — 15 findings corrected 2026-03-21 20:57:28 -07:00
UNIFIED_BYTELYST_PORTAL_ROADMAP.md fix(docs): self-audit Portal PRD + roadmap — 15 findings corrected 2026-03-21 20:57:28 -07:00
WORKSPACE_INVENTORY.md docs(workspace): index gitea runner rollout 2026-05-25 02:32:19 +00:00
WORKSPACE_TODO_AUDIT.md fix(exports): strip data payload from list endpoint + update audit doc 2026-03-22 01:23:08 -07:00