wip v28

Author: geraldarthurdavis

.env.example

@@ -26,6 +26,7 @@ LOG_LEVEL=info
 NEXT_PUBLIC_COMING_SOON=false
 NEXT_PUBLIC_CONVERSATION_SECTION=false
 NEXT_PUBLIC_CONVERSATIONS_WIDGET=false
+NEXT_PUBLIC_DISABLE_CONVERSATIONS_ROUTE=false
 NEXT_PUBLIC_DISABLE_USING=false
 NEXT_PUBLIC_INVISIBLE_INTERFACES_GROUP=false
 NEXT_PUBLIC_LIGHTPAPER_BANNER=false

uapi/app/ClientLayoutInner.tsx

@@ -53,17 +53,19 @@ const Conversation = dynamic(() => import('@/app/conversations/components/Conver
 // Prefetch heavy components for instant loading
 const prefetchHeavyComponents = () => {
   if (typeof window !== 'undefined') {
+    const conversationsEnabled = !FEATURE_FLAGS.DISABLE_CONVERSATIONS_ROUTE && FEATURE_FLAGS.CONVERSATIONS_WIDGET;
+
     // Prefetch Conversations after 2 seconds (lower priority than Orbital)
     setTimeout(() => {
-      if (!(window as any).__conversationsPrefetched) {
+      if (conversationsEnabled && !(window as any).__conversationsPrefetched) {
         (window as any).__conversationsPrefetched = true;
         import('@/app/conversations/components/ConversationsOverlay').catch(() => {});
       }
     }, 2000);
 
     // Prefetch the retained Conversations sidebar after 3 seconds.
     setTimeout(() => {
-      if (!window.__sidebarsPrefetched) {
+      if (conversationsEnabled && !window.__sidebarsPrefetched) {
         window.__sidebarsPrefetched = true;
         import('@/components/base/bitcode/layout/sidebars/right-sidebar').catch(() => {});
       }
@@ -220,6 +222,7 @@ export default function ClientLayoutInner({ children }: { children: ReactNode })
   const { data: onboardingData } = useOnboarding();
   const isOnboardingComplete = onboardingData?.isOnboardingComplete ?? false;
   const hideFooter = shouldHideWorkspaceFooter(pathname);
+  const conversationsEnabled = !FEATURE_FLAGS.DISABLE_CONVERSATIONS_ROUTE && FEATURE_FLAGS.CONVERSATIONS_WIDGET;
 
   return (
     <AuthProvider>
@@ -231,7 +234,7 @@ export default function ClientLayoutInner({ children }: { children: ReactNode })
         <React.Suspense fallback={null}>
           {/* Desktop supporting overlays. Auxillaries stays portal-only for V28. */}
           <div className="hidden laptop:block">
-            {authLoaded && user && !mockMode && pathname !== '/terminal' && pathname !== '/conversations' && isOnboardingComplete && FEATURE_FLAGS.CONVERSATIONS_WIDGET && (
+            {authLoaded && user && !mockMode && pathname !== '/terminal' && pathname !== '/conversations' && isOnboardingComplete && conversationsEnabled && (
               <>
                 <Conversation
                   position="bottom-right"

uapi/app/edgetimes/EdgetimesPageContent.tsx

@@ -2,6 +2,7 @@ import React from 'react';
 import Link from 'next/link';
 
 import Footer from '@/components/base/bitcode/layout/footer';
+import { FEATURE_FLAGS } from '@/config/features';
 
 import { EDGETIMES_TOPOLOGY, getEdgetimesTopologySummary } from './edgetimes-topology';
 
@@ -149,12 +150,14 @@ export default function EdgetimesPageContent() {
           >
             Open Bitcode Terminal
           </Link>
-          <Link
-            href="/conversations"
-            className="inline-flex items-center rounded-full border border-white/12 bg-white/5 px-4 py-2 text-[11px] font-semibold uppercase tracking-[0.18em] text-white/84 transition hover:border-white/20 hover:bg-white/10"
-          >
-            Open conversations
-          </Link>
+          {!FEATURE_FLAGS.DISABLE_CONVERSATIONS_ROUTE ? (
+            <Link
+              href="/conversations"
+              className="inline-flex items-center rounded-full border border-white/12 bg-white/5 px-4 py-2 text-[11px] font-semibold uppercase tracking-[0.18em] text-white/84 transition hover:border-white/20 hover:bg-white/10"
+            >
+              Open conversations
+            </Link>
+          ) : null}
         </section>
       </main>
 

uapi/app/terminal/TerminalCoreNativeSections.tsx

@@ -196,10 +196,11 @@ export default function TerminalCoreNativeSections({
                           : 'Repository connection posture is not currently validated.',
                       badge: connectionStatus?.metadata?.mock_mode ? 'mock' : 'connected',
                       metrics: [
-                        { label: 'Default branch', value: selectedRepository.defaultBranch || 'main' },
+                        { label: 'Selected branch', value: repositoryContext?.selectedBranch || selectedRepository.defaultBranch || 'main' },
                         { label: 'Visibility', value: selectedRepository.private ? 'private' : 'public' },
                       ],
                       rows: [
+                        { label: 'Commit', value: repositoryContext?.selectedCommit || 'commit pending' },
                         { label: 'Language', value: selectedRepository.language || 'n/a' },
                         {
                           label: 'Owner',

uapi/app/terminal/TerminalDepositComposer.tsx

@@ -1,7 +1,7 @@
 'use client';
 
 import React, { useEffect, useMemo, useState } from 'react';
-import type { VCSProviderType } from '@bitcode/vcs-core';
+import type { VCSBranch, VCSCommit, VCSProviderType } from '@bitcode/vcs-core';
 
 import BitcodeChipCloud from '@/components/base/bitcode/execution/BitcodeChipCloud';
 import BitcodeInlineExplainer from '@/components/base/bitcode/execution/BitcodeInlineExplainer';
@@ -34,14 +34,36 @@ interface TerminalDepositComposerProps {
   onRecordActivity?: (draft: TerminalActivityRecordDraft) => Promise<unknown>;
   repositoryAnchor?: string | null;
   repositoryProvider?: VCSProviderType | null;
+  repositoryBranch?: string | null;
+  repositoryCommit?: string | null;
+  repositoryBranches?: VCSBranch[];
+  repositoryCommits?: VCSCommit[];
+  isLoadingRepositoryBranches?: boolean;
+  isLoadingRepositoryCommits?: boolean;
+  onRepositorySourceBranchChange?: (branch: string) => void;
+  onRepositorySourceCommitChange?: (commit: string) => void;
   transactionReadiness: BitcodeTransactionReadiness;
   showDemonstrationDraft?: boolean;
 }
 
+function formatCommitOption(commit: VCSCommit) {
+  const shortSha = commit.sha.slice(0, 7);
+  const title = commit.message.split('\n')[0]?.trim() || 'Commit';
+  return `${shortSha} - ${title}`;
+}
+
 export default function TerminalDepositComposer({
   onRecordActivity,
   repositoryAnchor,
   repositoryProvider,
+  repositoryBranch,
+  repositoryCommit,
+  repositoryBranches = [],
+  repositoryCommits = [],
+  isLoadingRepositoryBranches = false,
+  isLoadingRepositoryCommits = false,
+  onRepositorySourceBranchChange,
+  onRepositorySourceCommitChange,
   transactionReadiness,
   showDemonstrationDraft = true,
 }: TerminalDepositComposerProps) {
@@ -60,7 +82,11 @@ export default function TerminalDepositComposer({
   const [content, setContent] = useState('');
   const [submitState, setSubmitState] = useState<SubmitState>({ kind: 'idle' });
   const repositoryAnchorValue = String(repositoryAnchor || '').trim();
+  const repositoryBranchValue = String(repositoryBranch || '').trim();
+  const repositoryCommitValue = String(repositoryCommit || '').trim();
   const usesLiveRepositoryAnchor = Boolean(repositoryAnchorValue);
+  const hasSelectedSourceRevision =
+    !usesLiveRepositoryAnchor || Boolean(repositoryBranchValue && repositoryCommitValue);
   const composer = useMemo<TerminalDepositComposerState | null>(
     () => {
       if (!showDemonstrationDraft && repositoryAnchorValue) {
@@ -84,6 +110,7 @@ export default function TerminalDepositComposer({
   const selectedSupplyCount = usesLiveRepositoryAnchor ? 1 : composer?.selectedCount || 0;
   const selectedInventoryEntryIds = usesLiveRepositoryAnchor ? [] : composer?.selectedInventoryEntryIds || [];
   const displayedSourceRepo = usesLiveRepositoryAnchor ? repositoryAnchorValue : sourceRepo;
+  const displayedSourceCommit = usesLiveRepositoryAnchor ? repositoryCommitValue : sourceCommit;
 
   useEffect(() => {
     setSignerAddress((current) => current || composer?.signerAddress || '');
@@ -105,6 +132,7 @@ export default function TerminalDepositComposer({
       (selectedSupplyCount > 0 || content.trim()) &&
       (title.trim() || selectedSupplyCount > 0) &&
       (author.trim() || effectiveAuthSessionId) &&
+      hasSelectedSourceRevision &&
       settlementReady,
   );
 
@@ -133,7 +161,9 @@ export default function TerminalDepositComposer({
           repositoryAnchor: repositoryAnchorValue || composer.sourceRepo || undefined,
           repositoryProvider: repositoryProvider || undefined,
           sourceRepo: displayedSourceRepo || undefined,
-          sourceCommit,
+          sourceBranch: repositoryBranchValue || undefined,
+          sourceRef: repositoryBranchValue || undefined,
+          sourceCommit: displayedSourceCommit || undefined,
           workflowRunId,
           signerAddress,
           visualPreview,
@@ -181,6 +211,8 @@ export default function TerminalDepositComposer({
             selectedInventoryEntryIds,
             selectedInventoryTitles: selectedEntryLabels,
             repositoryAnchor: repositoryAnchorValue || null,
+            sourceBranch: repositoryBranchValue || null,
+            sourceCommit: displayedSourceCommit || null,
             candidateAssetId: payload.asset?.assetId || null,
           },
           output: {
@@ -322,17 +354,71 @@ export default function TerminalDepositComposer({
 
             <div className="rounded-[1.5rem] border border-white/8 bg-black/20 px-4 py-4">
               <span className="flex items-center gap-2 text-[0.66rem] uppercase tracking-[0.24em] text-neutral-400">
-                <span>Source commit / ref</span>
-                <BitcodeInlineExplainer explainer={TERMINAL_INLINE_EXPLAINERS.sourceCommit} />
+                <span>{usesLiveRepositoryAnchor ? 'Source branch' : 'Source commit / ref'}</span>
+                <BitcodeInlineExplainer
+                  explainer={
+                    usesLiveRepositoryAnchor
+                      ? TERMINAL_INLINE_EXPLAINERS.sourceBranch
+                      : TERMINAL_INLINE_EXPLAINERS.sourceCommit
+                  }
+                />
               </span>
-              <input
-                value={sourceCommit}
-                onChange={(event) => setSourceCommit(event.target.value)}
-                placeholder="commit or branch override"
-                className="mt-3 w-full rounded-xl border border-white/10 bg-[rgba(10,15,30,0.88)] px-3 py-3 text-sm text-white outline-none transition placeholder:text-neutral-500 focus:border-emerald-400/40"
-              />
+              {usesLiveRepositoryAnchor ? (
+                <>
+                  <select
+                    aria-label="Deposit source branch"
+                    value={repositoryBranchValue}
+                    disabled={isLoadingRepositoryBranches || repositoryBranches.length === 0}
+                    onChange={(event) => onRepositorySourceBranchChange?.(event.target.value)}
+                    className="mt-3 w-full rounded-xl border border-white/10 bg-[rgba(10,15,30,0.88)] px-3 py-3 text-sm text-white outline-none transition focus:border-emerald-400/40 disabled:cursor-not-allowed disabled:opacity-60"
+                  >
+                    {repositoryBranches.length ? null : <option value="">No branches loaded</option>}
+                    {repositoryBranches.map((branch) => (
+                      <option key={branch.name} value={branch.name}>
+                        {branch.name}
+                      </option>
+                    ))}
+                  </select>
+                  <p className="mt-2 text-[0.68rem] uppercase tracking-[0.18em] text-neutral-500">
+                    {isLoadingRepositoryBranches ? 'Loading branches…' : 'Changing branch refreshes commit refs'}
+                  </p>
+                </>
+              ) : (
+                <input
+                  value={sourceCommit}
+                  onChange={(event) => setSourceCommit(event.target.value)}
+                  placeholder="commit or branch override"
+                  className="mt-3 w-full rounded-xl border border-white/10 bg-[rgba(10,15,30,0.88)] px-3 py-3 text-sm text-white outline-none transition placeholder:text-neutral-500 focus:border-emerald-400/40"
+                />
+              )}
             </div>
 
+            {usesLiveRepositoryAnchor ? (
+              <div className="rounded-[1.5rem] border border-white/8 bg-black/20 px-4 py-4">
+                <span className="flex items-center gap-2 text-[0.66rem] uppercase tracking-[0.24em] text-neutral-400">
+                  <span>Source commit / ref</span>
+                  <BitcodeInlineExplainer explainer={TERMINAL_INLINE_EXPLAINERS.sourceCommit} />
+                </span>
+                <select
+                  aria-label="Deposit source commit"
+                  value={repositoryCommitValue}
+                  disabled={!repositoryBranchValue || isLoadingRepositoryCommits || repositoryCommits.length === 0}
+                  onChange={(event) => onRepositorySourceCommitChange?.(event.target.value)}
+                  className="mt-3 w-full rounded-xl border border-white/10 bg-[rgba(10,15,30,0.88)] px-3 py-3 text-sm text-white outline-none transition focus:border-emerald-400/40 disabled:cursor-not-allowed disabled:opacity-60"
+                >
+                  {repositoryCommits.length ? null : <option value="">No commits loaded</option>}
+                  {repositoryCommits.map((commit) => (
+                    <option key={commit.sha} value={commit.sha}>
+                      {formatCommitOption(commit)}
+                    </option>
+                  ))}
+                </select>
+                <p className="mt-2 text-[0.68rem] uppercase tracking-[0.18em] text-neutral-500">
+                  {isLoadingRepositoryCommits ? 'Loading commits…' : 'Exact source materialization uses this commit SHA'}
+                </p>
+              </div>
+            ) : null}
+
             <label className="rounded-[1.5rem] border border-white/8 bg-black/20 px-4 py-4">
               <span className="text-[0.66rem] uppercase tracking-[0.24em] text-neutral-400">Workflow run override</span>
               <input
@@ -468,10 +554,15 @@ export default function TerminalDepositComposer({
             <p className="mt-3 text-sm leading-6 text-neutral-300">
               {selectedSupplyCount
                 ? usesLiveRepositoryAnchor
-                  ? `Bitcode will bind ${repositoryAnchorValue} as the selected repository source for this deposit.`
+                  ? `Bitcode will bind ${repositoryAnchorValue}${repositoryBranchValue ? ` on ${repositoryBranchValue}` : ''}${repositoryCommitValue ? ` at ${repositoryCommitValue.slice(0, 12)}` : ''} as the selected repository source for this deposit.`
                   : `Bitcode will bind ${selectedSupplyCount} selected repo artifact${selectedSupplyCount === 1 ? '' : 's'} into this deposit.`
                 : 'No repo artifacts are currently selected. Use raw fallback content or select inventory above.'}
             </p>
+            {usesLiveRepositoryAnchor && !hasSelectedSourceRevision ? (
+              <p className="mt-3 rounded-[1.1rem] border border-amber-400/20 bg-amber-400/10 px-4 py-3 text-sm leading-6 text-amber-100">
+                Select a branch and commit before depositing so source materialization can fetch an exact snapshot.
+              </p>
+            ) : null}
             {selectedEntryLabels.length ? (
               <BitcodeChipCloud
                 chips={selectedEntryLabels}

uapi/app/terminal/TerminalExperienceFrame.tsx

@@ -14,9 +14,13 @@ import { jumpToShellSection } from './terminal-shell-reading';
 
 interface TerminalExperienceFrameProps {
   onOpenConversations: () => void;
+  conversationsEnabled?: boolean;
 }
 
-export default function TerminalExperienceFrame({ onOpenConversations }: TerminalExperienceFrameProps) {
+export default function TerminalExperienceFrame({
+  onOpenConversations,
+  conversationsEnabled = true,
+}: TerminalExperienceFrameProps) {
   return (
     <TerminalWorkspaceCard
       kicker="Mode map"
@@ -63,7 +67,7 @@ export default function TerminalExperienceFrame({ onOpenConversations }: Termina
                 >
                   Focus activity ledger
                 </button>
-              ) : experience.id === 'conversations' ? (
+              ) : experience.id === 'conversations' && conversationsEnabled ? (
                 <TerminalOpenConversationsButton
                   onOpen={onOpenConversations}
                   className="rounded-[1.3rem] 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/50 hover:bg-emerald-400/15"