wip v28

Author: geraldarthurdavis

BITCODE_SPEC_V28_NOTES.md

@@ -163,6 +163,10 @@ The active contained pane must own vertical scrolling; the overlay shell may con
 Selector-card state must render as visual indicators rather than `laneactive` / `laneready` prose, while retaining accessible labels and machine-readable state for tests.
 Async profile props must hydrate into editable local fields after mock/live data arrives, so display name, bio, company, avatar, and team data do not remain blank after the email field has already loaded.
 The BTC/BTD widget must render a compact wallet-reading posture while fresh lane-specific data loads or while stale anonymous zero-state is being revalidated; zero BTC/BTD may be shown only as a settled data state, not as an unceremonious hydration flash.
+Terminal-opened Auxillaries fullscreen must fill the operator viewport as a working overlay, not as a centered modal that leaves a navigation-height dead band below it.
+The contained selector/pane grid must use a single bounded row, with selector cards and the active pane owning their own internal scroll surfaces.
+Profile must remain long-form enough to expose identity, wallet, access-provider, and save controls, but its vertical rhythm must be tightened so scrolling feels like a contained product pane rather than a legacy onboarding form dropped into the commercial shell.
+The account-menu Auxillaries entry may reuse the pre-V26 solar-system visual language when it improves product legibility and polish, but the source and visible product naming must remain Auxillaries/Bitcode rather than restoring Orbitals as a commercial construct.
 
 These changes remain V28 scope because they are MVP-readiness and trust issues.
 The deeper Auxillaries version retains hierarchy, spacing, diagnostics, recovery, and provider-management expansion after V28 proves the contained shell, mocked prerequisite reads, fail-closed testnet-readiness, and no-console-error baseline.

BITCODE_V28_QA.md

@@ -174,6 +174,8 @@ Implemented after Pass 2, pending next manual QA confirmation:
 | Vercel deployment build | pass after fix | Latest deployment failed because `lib/bitcode-app-context.ts` imported `@bitcode/protocol` before Next's workspace-package resolver knew how to transpile/alias the new formal protocol package. V28 now adds `@bitcode/protocol` to `transpilePackages`, aliases the root import to `packages/protocol/src/index.js`, and verifies the resolver in `tests/protocolCommercialBoundary.test.ts`. Local `pnpm run build` from `uapi` now passes. |
 | Mock top chrome during 1A | pass | Manual reconfirmation on 2026-05-08 accepted the fixed mock balance, notification, and profile posture. V28 now treats master mock mode as sufficient for auxillaries mock data in client and server code, explicitly exposes public mock flags through Next config, and revalidates stale module-level user data on new mount so lane transitions cannot keep anonymous/zero cached data. |
 | Dual-lane dev artifact isolation | pass | Manual reconfirmation on 2026-05-08 accepted the mock/testnet-readiness separation. V28 QA servers use lane-specific `NEXT_DIST_DIR` values so public mock env compilation is isolated per lane. |
+| Mock Terminal data classification | pass | Manual QA clarified that the currently visible Terminal data is mock data because the operator is in the mock lane. This evidence remains mock-lane evidence only, not testnet-readiness evidence. |
+| Testnet-readiness Terminal baseline | pass | Port `3001` API returns anonymous/empty readiness rather than mock profile/repos/balances, and browser verification renders `Bitcode Terminal` with `Connect Wallet`, no mock profile strings, no mock balances, and no product console/page errors. |
 
 ### 2026-05-08 Pass 3A: Auxillaries Profile And Connects Readiness
 
@@ -185,13 +187,16 @@ Implemented after Pass 2, pending next manual QA confirmation:
 | Mock profile fields | fixed | Manual QA confirmed email but found display name and bio missing. V28 now hydrates async initial profile props into local editable state and mock data supplies display name, bio, and company posture. |
 | Connected repositories | pass | Manual QA confirmed mocked connected repos; browser verification confirms `Connected Repositories (3)` and `bitcode/economic-ledger` render in Connects. |
 | BTD/BTC first-load posture | fixed | Manual QA found the top-right widget flashing anonymous zero-state before hydrated values. V28 now surfaces a compact `Reading wallet` posture while fresh lane-specific user data is loading or revalidating stale cached zero-state. |
+| Fullscreen overlay viewport fit | fixed | Manual QA found a bottom gap approximately the height of the navigation/chrome after opening Auxillaries fullscreen from Terminal. V28 now lets the overlay shell fill the available viewport height and anchors the shell to the bottom edge while keeping overlay overflow hidden. |
+| Profile scroll quality | fixed | Manual QA found Profile auxillary scrolling technically worked but felt poor. V28 now constrains the right pane as a true `height:100%` scroll container, prevents selector/pane grid-row overflow, and tightens Profile vertical rhythm so lower wallet/access/provider controls stay reachable in the contained pane. |
+| Auxillaries menu icon | fixed | Manual QA found the account-menu Auxillaries entry had lost the more elegant animated solar-system cue from the late-Engi era. V28 restores the visual language as an Auxillaries-named animated solar icon without reverting product copy or route naming to Orbitals. |
 | Console/page errors | pass | Manual QA reported none; focused browser verification reports no product console messages and no page errors. |
 
 Automated verification for this slice:
 
 - `pnpm -C uapi exec jest --runInBand tests/useUserDataHydration.test.tsx tests/btdTrackerLoading.test.tsx tests/auxillariesWorkspacePanels.test.tsx tests/featureFlagsMockMode.test.ts`: pass.
-- `pnpm -C uapi exec playwright test tests/e2e/commercial-mvp.auxillaries.spec.ts --project=laptop --workers=1`: 8 passed.
-- Focused browser verification on the mock lane: raw lane text count `0`, state indicator count `4`, Profile display name `Avery Mercer`, Profile bio `Reviewing the Bitcode commercial surface in deterministic mock mode.`, pane `scrollTop` advances, Connects repos present, no product console/page errors.
+- `pnpm -C uapi exec playwright test tests/e2e/commercial-mvp.auxillaries.spec.ts --project=laptop --workers=1`: 9 passed, including the Terminal fullscreen Auxillaries viewport/scroll assertion.
+- Focused browser verification on the mock lane: raw lane text count `0`, state indicator count `4`, Profile display name `Avery Mercer`, Profile bio `Reviewing the Bitcode commercial surface in deterministic mock mode.`, shell bottom gap `0`, pane bottom overflow `0`, pane `scrollTop` advances, Save Profile is visible at the internal scroll bottom, Connects repos present, no product console/page errors.
 
 Deferred to V31 from this pass:
 

uapi/components/base/bitcode/layout/auxillaries-solar-icon.tsx

@@ -0,0 +1,25 @@
+import React from 'react';
+
+import menuStyles from '../menus/glassy-menu.module.css';
+
+interface AuxillariesSolarIconProps {
+  className?: string;
+}
+
+export function AuxillariesSolarIcon({ className = '' }: AuxillariesSolarIconProps) {
+  return (
+    <span
+      aria-hidden="true"
+      className={`${menuStyles.auxillariesSolarIcon} ${className}`.trim()}
+      data-testid="auxillaries-solar-icon"
+    >
+      <span className={menuStyles.auxillariesSolarHalo} />
+      <span className={menuStyles.auxillariesSolarRing} data-ring="outer" />
+      <span className={menuStyles.auxillariesSolarRing} data-ring="middle" />
+      <span className={menuStyles.auxillariesSolarRing} data-ring="inner" />
+      <span className={menuStyles.auxillariesSolarCore} />
+    </span>
+  );
+}
+
+export default AuxillariesSolarIcon;

uapi/components/base/bitcode/layout/orbital-icon.tsx

@@ -6,7 +6,7 @@ import * as Avatar from "@radix-ui/react-avatar";
 import classNames from "classnames";
 import menuStyles from '../menus/glassy-menu.module.css';
 import { ArrowRightOnRectangleIcon } from '@heroicons/react/24/outline';
-import { OrbitalIcon } from './orbital-icon';
+import { AuxillariesSolarIcon } from './auxillaries-solar-icon';
 import {
   OPEN_AUXILLARIES_FULLSCREEN_LABEL,
   AUXILLARIES_LIST_COMPACT_LABEL,
@@ -122,7 +122,7 @@ export function UserMenu({ user, onOpenAuxillaries, onSignOut }: UserMenuProps)
                 }}
                 className={`${menuStyles.item}`}
               >
-                <OrbitalIcon className="h-5 w-5 flex-shrink-0 mr-2" variant="green" />
+                <AuxillariesSolarIcon className="mr-2" />
                 <div className="min-w-0">
                   <span className="block">{OPEN_AUXILLARIES_FULLSCREEN_LABEL}</span>
                   <span className="mt-0.5 block text-[0.64rem] uppercase tracking-[0.18em] text-emerald-200/60">

uapi/components/base/bitcode/layout/user-menu.tsx

@@ -61,6 +61,137 @@
 .item:hover::before { opacity: 1; }
 .item:active { transform: scale(0.98); }
 
+.auxillariesSolarIcon {
+  position: relative;
+  display: inline-flex;
+  width: 1.85rem;
+  height: 1.85rem;
+  flex: 0 0 auto;
+  align-items: center;
+  justify-content: center;
+  border-radius: 999px;
+  color: #67feb7;
+  filter: drop-shadow(0 0 9px rgba(101, 254, 183, 0.22));
+}
+
+.auxillariesSolarHalo {
+  position: absolute;
+  inset: 0.24rem;
+  border-radius: 999px;
+  background:
+    radial-gradient(circle at center, rgba(101, 254, 183, 0.2), transparent 58%),
+    radial-gradient(circle at 60% 44%, rgba(56, 189, 248, 0.12), transparent 62%);
+  opacity: 0.78;
+  transform: scale(0.96);
+  transition: opacity 180ms ease, transform 180ms ease;
+}
+
+.auxillariesSolarCore {
+  position: absolute;
+  width: 0.36rem;
+  height: 0.36rem;
+  border-radius: 999px;
+  background: #67feb7;
+  box-shadow:
+    0 0 0 2px rgba(101, 254, 183, 0.14),
+    0 0 13px rgba(101, 254, 183, 0.78);
+  animation: auxillariesSolarPulse 2600ms ease-in-out infinite;
+}
+
+.auxillariesSolarRing {
+  --solar-ring-size: 1.5rem;
+  --solar-ring-duration: 9s;
+  position: absolute;
+  left: 50%;
+  top: 50%;
+  width: var(--solar-ring-size);
+  height: var(--solar-ring-size);
+  border: 1px solid rgba(101, 254, 183, 0.44);
+  border-radius: 999px;
+  transform: translate(-50%, -50%) rotate(0deg);
+  animation: auxillariesSolarOrbit var(--solar-ring-duration) linear infinite;
+  box-shadow:
+    0 0 10px rgba(101, 254, 183, 0.12),
+    inset 0 0 8px rgba(56, 189, 248, 0.08);
+}
+
+.auxillariesSolarRing::after {
+  content: '';
+  position: absolute;
+  top: 50%;
+  right: -0.12rem;
+  width: 0.24rem;
+  height: 0.24rem;
+  border-radius: 999px;
+  background: #eafff7;
+  box-shadow:
+    0 0 7px rgba(101, 254, 183, 0.8),
+    0 0 14px rgba(56, 189, 248, 0.26);
+  transform: translateY(-50%);
+}
+
+.auxillariesSolarRing[data-ring='outer'] {
+  --solar-ring-size: 1.78rem;
+  --solar-ring-duration: 11s;
+  border-color: rgba(101, 254, 183, 0.34);
+}
+
+.auxillariesSolarRing[data-ring='middle'] {
+  --solar-ring-size: 1.42rem;
+  --solar-ring-duration: 8.2s;
+  border-color: rgba(34, 211, 238, 0.34);
+  animation-direction: reverse;
+}
+
+.auxillariesSolarRing[data-ring='middle']::after {
+  right: auto;
+  left: -0.1rem;
+  width: 0.2rem;
+  height: 0.2rem;
+  background: #a7f3d0;
+}
+
+.auxillariesSolarRing[data-ring='inner'] {
+  --solar-ring-size: 1.02rem;
+  --solar-ring-duration: 6.4s;
+  border-color: rgba(251, 191, 36, 0.28);
+}
+
+.auxillariesSolarRing[data-ring='inner']::after {
+  width: 0.17rem;
+  height: 0.17rem;
+  background: #f9c855;
+  box-shadow:
+    0 0 7px rgba(249, 200, 85, 0.68),
+    0 0 11px rgba(101, 254, 183, 0.22);
+}
+
+.item:hover .auxillariesSolarIcon {
+  filter:
+    drop-shadow(0 0 12px rgba(101, 254, 183, 0.44))
+    drop-shadow(0 0 18px rgba(56, 189, 248, 0.16));
+}
+
+.item:hover .auxillariesSolarHalo {
+  opacity: 1;
+  transform: scale(1.05);
+}
+
+.item:hover .auxillariesSolarRing[data-ring='outer'] {
+  border-color: rgba(101, 254, 183, 0.58);
+  animation-duration: 7.2s;
+}
+
+.item:hover .auxillariesSolarRing[data-ring='middle'] {
+  border-color: rgba(34, 211, 238, 0.52);
+  animation-duration: 5.8s;
+}
+
+.item:hover .auxillariesSolarRing[data-ring='inner'] {
+  border-color: rgba(251, 191, 36, 0.44);
+  animation-duration: 4.6s;
+}
+
 .danger { color: #f87171; }
 .danger:hover { background: rgba(248, 113, 113, 0.08); }
 .dangerIcon { color: #f87171; }
@@ -72,3 +203,33 @@
   box-shadow: 0 10px 40px rgba(0,0,0,0.45), 0 0 0 1px rgba(101, 254, 183, 0.07), inset 0 0 24px rgba(101, 254, 183, 0.04);
   border-radius: 12px;
 }
+
+@keyframes auxillariesSolarOrbit {
+  from {
+    transform: translate(-50%, -50%) rotate(0deg);
+  }
+
+  to {
+    transform: translate(-50%, -50%) rotate(360deg);
+  }
+}
+
+@keyframes auxillariesSolarPulse {
+  0%,
+  100% {
+    opacity: 0.84;
+    transform: scale(0.94);
+  }
+
+  50% {
+    opacity: 1;
+    transform: scale(1.08);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .auxillariesSolarRing,
+  .auxillariesSolarCore {
+    animation: none;
+  }
+}

uapi/components/base/bitcode/menus/glassy-menu.module.css

@@ -130,6 +130,7 @@ module.exports = {
     '<rootDir>/tests/btdStep.integration.test.tsx',
     '<rootDir>/tests/navPublicShell.test.tsx',
     '<rootDir>/tests/navBrand.test.tsx',
+    '<rootDir>/tests/userMenu.test.tsx',
     '<rootDir>/tests/footerPublicShell.test.tsx',
     '<rootDir>/tests/bitcodeTransactionsFilterBar.test.tsx',
     '<rootDir>/tests/bitcodeTransactionsActiveFilters.test.tsx',