wip v28

Author: geraldarthurdavis

uapi/app/api/external-realization/route.ts

@@ -4,12 +4,56 @@ import { getBitcodeAppContext, toBitcodeErrorResponse } from '@/lib/bitcode-app-
 
 export const runtime = 'nodejs';
 
+type ExternalRealizationEnvironmentMode = 'production' | 'staging' | 'development' | 'mock';
+
+const EXTERNAL_REALIZATION_ENVIRONMENT_MODES = new Set<ExternalRealizationEnvironmentMode>([
+  'production',
+  'staging',
+  'development',
+  'mock',
+]);
+
+function normalizeExternalEnvironmentMode(value: string | null | undefined): ExternalRealizationEnvironmentMode | null {
+  const normalized = value?.trim().toLowerCase();
+  if (!normalized) return null;
+  return EXTERNAL_REALIZATION_ENVIRONMENT_MODES.has(normalized as ExternalRealizationEnvironmentMode)
+    ? (normalized as ExternalRealizationEnvironmentMode)
+    : null;
+}
+
+function normalizeBitcodeEnvironment(value: string | null | undefined): ExternalRealizationEnvironmentMode | null {
+  const normalized = value?.trim().toLowerCase();
+  if (!normalized) return null;
+  if (normalized === 'testnet' || normalized === 'staging-testnet') return 'staging';
+  if (normalized === 'mainnet') return 'production';
+  return normalizeExternalEnvironmentMode(normalized);
+}
+
+function resolveExternalRealizationEnvironmentMode(
+  requestUrl: URL,
+  env: NodeJS.ProcessEnv = process.env,
+): ExternalRealizationEnvironmentMode | null {
+  const explicitMode = normalizeExternalEnvironmentMode(requestUrl.searchParams.get('environmentMode'));
+  if (explicitMode) return explicitMode;
+
+  const protocolMode = normalizeExternalEnvironmentMode(env.BITCODE_V24_ENVIRONMENT_MODE);
+  if (protocolMode) return protocolMode;
+
+  const bitcodeMode = normalizeBitcodeEnvironment(env.NEXT_PUBLIC_BITCODE_ENV || env.BITCODE_ENV);
+  if (bitcodeMode) return bitcodeMode;
+
+  if (env.VERCEL_ENV === 'preview') return 'staging';
+  if (env.VERCEL_ENV === 'production') return 'production';
+
+  return null;
+}
+
 export async function GET(request: Request) {
   try {
     const url = new URL(request.url);
     return NextResponse.json(
       getBitcodeAppContext().getExternalRealization({
-        environmentMode: url.searchParams.get('environmentMode'),
+        environmentMode: resolveExternalRealizationEnvironmentMode(url),
       }),
     );
   } catch (error) {

uapi/app/terminal/TerminalCoreNativeSections.tsx

@@ -122,7 +122,7 @@ export default function TerminalCoreNativeSections({
                 </div>
               ) : (
                 <div className="mt-4 rounded-[1.2rem] border border-white/8 bg-white/5 px-4 py-4 text-sm leading-6 text-neutral-300">
-                  Connect and select a repository above to make Bitcode give-side supply explicit before the deposit chain.
+                  Connect and select a repository above to make Bitcode give-side supply explicit before the Giving chain.
                 </div>
               )
             ) : null}
@@ -189,7 +189,7 @@ export default function TerminalCoreNativeSections({
                       eyebrow: 'Selected repository supply',
                       subtitle:
                         selectedRepository.description ||
-                        'Selected repository supply is the current give-side source before deposit and fit.',
+                        'Selected repository supply is the current give-side source before Giving and fit.',
                       help:
                         connectionStatus?.connected && connectionStatus.valid
                           ? `Connected as ${connectionStatus.username || connectionStatus.metadata?.account || 'bitcode'}.`

uapi/app/terminal/TerminalDepositComposer.tsx

@@ -130,6 +130,9 @@ export default function TerminalExternalInterfacingPanel({
   };
 
   const counts = snapshot?.counts;
+  const hasMockRuntime =
+    snapshot?.configuredEnvironmentMode === 'mock' ||
+    Boolean(snapshot?.interfaces.some((entry) => entry.runtimeState === 'mock'));
 
   return (
     <TerminalWorkspaceCard
@@ -147,7 +150,7 @@ export default function TerminalExternalInterfacingPanel({
       <div className="grid gap-3 text-xs uppercase tracking-[0.2em] text-neutral-400 tablet:grid-cols-2">
         <div className="rounded-2xl border border-white/8 bg-black/20 px-4 py-4">
           <p className="text-emerald-300/85">Runtime scope</p>
-          <p className="mt-2 text-neutral-200">connected interfaces</p>
+          <p className="mt-2 text-neutral-200">{snapshot?.configuredEnvironmentMode || 'connected interfaces'}</p>
         </div>
         <div className="rounded-2xl border border-white/8 bg-black/20 px-4 py-4">
           <p className="text-emerald-300/85">Read posture</p>
@@ -317,8 +320,9 @@ export default function TerminalExternalInterfacingPanel({
             )}
           </div>
           <div className="mt-4 rounded-[1.3rem] border border-white/8 bg-white/5 px-4 py-4 text-sm leading-6 text-neutral-300">
-            Boundary truth remains explicit here: what is mocked, what is boundary-only, what is live-configured, and what
-            is misconfigured all stay visible from the Terminal surface.
+            {hasMockRuntime
+              ? 'Boundary truth remains explicit here: what is mocked, what is boundary-only, what is live-configured, and what is misconfigured all stay visible from the Terminal surface.'
+              : 'Boundary truth remains explicit here: what is boundary-only, what is live-configured, what is execution-disabled, and what is misconfigured all stay visible from the Terminal surface.'}
           </div>
         </div>
       </div>

uapi/app/terminal/TerminalExternalInterfacingPanel.tsx

@@ -12,7 +12,7 @@ const TERMINAL_MVP_STATIONS = [
   {
     id: 'giving',
     label: 'Giving',
-    value: 'repository + deposit',
+    value: 'repository + Giving',
     targetId: 'terminalSupplySelection',
   },
   {

uapi/app/terminal/TerminalMvpMap.tsx

@@ -71,11 +71,13 @@ const ConversationsOverlay = dynamic(() => import('@/app/conversations/component
 export default function TerminalPageClient() {
   const { user } = useAuth();
   const {
+    data: userData,
     hasGitHubConnection,
     hasValidGitHubConnection = hasGitHubConnection,
     hasWalletConnection,
     hasStoredVerifiedWalletConnection = false,
     hasVerifiedWalletConnection,
+    walletConnectionStatus,
     repositoryConnectionStatus,
   } = useUserData();
   const router = useRouter();
@@ -154,6 +156,17 @@ export default function TerminalPageClient() {
       user,
     ],
   );
+  const preferredSignerAddress = useMemo(() => {
+    const profile = userData?.profile as Record<string, unknown> | null | undefined;
+    const profileAuthAddress = typeof profile?.auth_address === 'string' ? profile.auth_address.trim() : '';
+    const profileWalletAddress = typeof profile?.wallet_address === 'string' ? profile.wallet_address.trim() : '';
+    const walletAuthAddress = walletConnectionStatus?.metadata?.authAddress?.trim() || '';
+    const walletAddress = walletConnectionStatus?.address?.trim() || '';
+    return walletAuthAddress || walletAddress || profileAuthAddress || profileWalletAddress || null;
+  }, [userData?.profile, walletConnectionStatus]);
+  const preferredSignerLabel = walletConnectionStatus?.provider
+    ? `${walletConnectionStatus.provider} wallet`
+    : 'connected wallet';
   const replaceTerminalSearchParams = useCallback(
     (nextParams: URLSearchParams) => {
       if (typeof window !== 'undefined' && window.location.pathname !== TERMINAL_ROUTE) return;
@@ -527,6 +540,8 @@ export default function TerminalPageClient() {
                       onRepositorySourceCommitChange={handleRepositorySourceCommitChange}
                       transactionReadiness={transactionReadiness}
                       showDemonstrationDraft={showDemonstrationSurfaces}
+                      preferredSignerAddress={preferredSignerAddress}
+                      preferredSignerLabel={preferredSignerLabel}
                     />
                   </div>
                 </div>

uapi/app/terminal/TerminalPageClient.tsx

@@ -445,7 +445,7 @@ export default function TerminalRepositoryContextPanel({
       id="terminalRepositorySupply"
       kicker="Repository supply"
       title="Connect and select searchable supply"
-      summary="Choose the provider and repository that will anchor give-side supply before you move deeper into deposit, need, and closure."
+      summary="Choose the GitHub repository that will anchor give-side supply before you move deeper into Giving, Need, and closure."
       explainer={TERMINAL_WORKSPACE_EXPLAINERS.repositorySupply}
       tone="emerald"
     >
@@ -697,7 +697,7 @@ export default function TerminalRepositoryContextPanel({
                     </div>
                     <div>
                       <dt className="text-amber-100/70">Write admission</dt>
-                      <dd className="mt-1 text-neutral-100">Reconnect required before deposit, branch, or closure writes.</dd>
+                      <dd className="mt-1 text-neutral-100">Reconnect required before Giving, branch, or closure writes.</dd>
                     </div>
                     <div>
                       <dt className="text-amber-100/70">Inventory source</dt>
@@ -742,7 +742,7 @@ export default function TerminalRepositoryContextPanel({
               {selectedRepository ? (
                 <div className="mt-4 space-y-4">
                   <p className="text-sm leading-6 text-neutral-300">
-                    The selected repository now anchors the give-side Terminal frame before the live Bitcode deposit
+                    The selected repository now anchors the give-side Terminal frame before live Bitcode Giving
                     surfaces below.
                   </p>
                   {connectionStatus?.connected && !connectionStatus.valid ? (
@@ -795,7 +795,7 @@ export default function TerminalRepositoryContextPanel({
                       onClick={() => jumpToShellSection('terminalDepositComposer')}
                       className="rounded-[1.2rem] border border-emerald-400/30 bg-emerald-400/10 px-4 py-3 text-sm font-medium text-emerald-100 transition hover:border-emerald-300/45 hover:bg-emerald-400/15"
                     >
-                      Open deposit draft
+                      Open Giving draft
                     </button>
                     <button
                       type="button"
@@ -831,7 +831,7 @@ export default function TerminalRepositoryContextPanel({
           <article className="rounded-[1.5rem] border border-white/8 bg-black/20 px-5 py-5">
             <p className="text-[0.68rem] uppercase tracking-[0.24em] text-neutral-400">Give-side guidance</p>
             <p className="mt-3 text-sm leading-6 text-neutral-300">
-              Keep repository connection, repository selection, and deposit focus visible before you move deeper into
+              Keep repository connection, repository selection, and Giving focus visible before you move deeper into
               supply, need, and closure.
             </p>
             <div className="mt-4 grid gap-3">

uapi/app/terminal/TerminalRepositoryContextPanel.tsx

@@ -37,9 +37,9 @@ type ShellSnapshot = {
 
 const CORE_PANEL_CONFIG = [
   { id: 'panelOperatingPicture', key: 'operatingPicture', fallbackLabel: 'Operating picture' },
-  { id: 'panelDepositing', key: 'depositing', fallbackLabel: 'Depositing' },
+  { id: 'panelDepositing', key: 'depositing', fallbackLabel: 'Giving' },
   { id: 'panelNeeding', key: 'needing', fallbackLabel: 'Needing + measured demand' },
-  { id: 'panelFit', key: 'fit', fallbackLabel: 'Depositing-to-needing fit' },
+  { id: 'panelFit', key: 'fit', fallbackLabel: 'Giving-to-Needing fit' },
 ] as const;
 
 function stringValue(value: string | number | null | undefined, fallback = '') {

uapi/app/terminal/terminal-core-surface.ts

@@ -107,9 +107,9 @@ export function deriveTerminalFlowGuide(
       ? transactionReadiness?.summary || 'The Bitcode Terminal is in review-only mode until transactional readiness is complete.'
     : draftOnly
       ? guideStep
-        ? `The flow guide is ${commandState.flowGuideOpen ? 'open' : 'saved'} at ${guideStep}. ${transactionReadiness?.summary || 'Bitcode can keep drafting, but branch, deposit, and closure remain fail-closed until signed settlement readiness is complete.'}`
+        ? `The flow guide is ${commandState.flowGuideOpen ? 'open' : 'saved'} at ${guideStep}. ${transactionReadiness?.summary || 'Bitcode can keep drafting, but branch, Giving, and closure remain fail-closed until signed settlement readiness is complete.'}`
         : transactionReadiness?.summary ||
-          'Bitcode can keep drafting, but branch, deposit, and closure remain fail-closed until signed settlement readiness is complete.'
+          'Bitcode can keep drafting, but branch, Giving, and closure remain fail-closed until signed settlement readiness is complete.'
     : guideStep
       ? `The flow guide is ${commandState.flowGuideOpen ? 'open' : 'saved'} at ${guideStep}.`
       : 'The Bitcode Terminal is ready for a fresh give-to-closure flow.';

uapi/app/terminal/terminal-flow-guide.ts

@@ -315,7 +315,7 @@ export function normalizeTerminalGiveNeedWorkbench(
     fit: {
       summary:
         String(snapshot.fitSurface?.fitSummary || '').trim() ||
-        'Depositing-to-needing fit stays the decisive Bitcode relation before branch, proof, and settlement are justified.',
+        'Giving-to-Needing fit stays the decisive Bitcode relation before branch, proof, and settlement are justified.',
       metrics: [
         {
           label: 'Pressure',