V48 (impl-only): Prefer settleDelivery on reread

Extend dual-read of settleDelivery (canonical) with historical
shippables through domain postprocess, schemas, history types, and UI
panels. Correct Finish-ship copy to settle delivery language. Keep
dual-write so stored runs remain rereadable. Typecheck and focused
tests pass.

Author: geraldarthurdavis

apps/mcp/src/docs/openapi-generator.ts

@@ -210,7 +210,7 @@ The Model Context Protocol (MCP) server exposing Bitcode’s technical knowledge
             url: {
               type: 'string',
               format: 'uri',
-              description: 'External URL for the PR-backed Shippable',
+              description: 'External URL for the settle PR delivery',
               example: 'https://github.com/bitcode-labs/webapp/pull/123'
             },
             content: {
@@ -297,7 +297,7 @@ The Model Context Protocol (MCP) server exposing Bitcode’s technical knowledge
             assetPacks: {
               type: 'array',
               items: { $ref: '#/components/schemas/AssetPack' },
-              description: 'Generated AssetPack results and PR Shippables'
+              description: 'Generated AssetPack results and settle PR deliveries'
             },
             metrics: { $ref: '#/components/schemas/ExecutionMetrics' },
             streamUrl: {

apps/mcp/src/tools/monitoring-tools.ts

@@ -405,7 +405,7 @@ export function registerMonitoringTools(): MCPTool[] {
 Provides comprehensive pipeline information including:
 • Current execution status and phase
 • Performance metrics and resource usage
-• AssetPack results and PR Shippables produced
+• AssetPack results and settle PR deliveries produced
 • Error information and recovery status
 • Real-time execution events (optional)
 

apps/uapi/components/bitcode/pipeline/ExecutionsPageClient/ExecutionsPageClient.tsx

@@ -347,6 +347,7 @@ export function ExecutionsClient() {
     null;
   const deliveryMechanismForPanels =
     getHeaderSettleDelivery(historyAssetPackCompletion) ||
+    headerPostprocessed?.settleDelivery ||
     headerPostprocessed?.shippables ||
     headerPostprocessed?.deliveryMechanism ||
     null;

apps/uapi/components/bitcode/pipeline/models/pipeline-activity-history.ts

@@ -668,7 +668,7 @@ export function mapExecutionHistoryRunToWorkspaceRun(run: PipelineExecution): Wo
       run.asset_pack_completion?.summary ||
       run.asset_pack_completion?.assetPackSynthesisArtifacts?.summary ||
       run.asset_pack_completion?.writtenAssets?.summary ||
-      run.asset_pack_completion?.shippables?.summary ||
+      run.asset_pack_completion?.settleDelivery?.summary || run.asset_pack_completion?.shippables?.summary ||
       run.asset_pack_completion?.deliveryMechanism?.summary ||
       failureSummary ||
       null,

apps/uapi/components/conversations/ConversationsCard/ConversationsCard.tsx

@@ -300,7 +300,7 @@ export function ConversationsCard({
           </div>
         </div>
 
-        {/* Logs & Shippables bucket column */}
+        {/* Logs + settle delivery / evidence surfaces */}
         {showEmbeddedLogs && (
           <div
             className="embedded-process-log border-l border-gray-700 custom-scrollbar"
@@ -318,7 +318,9 @@ export function ConversationsCard({
               {renderLog()}
             </div>
             <div style={{ flex: 1, overflowY: "auto", borderTop: "1px solid rgba(55,65,81)", padding: "0.5rem", backgroundColor: "#0a1428" }}>
-              <h3 style={{ fontSize: "0.8rem", color: "#ccc", marginBottom: "0.5rem" }}>Shippables & Evidence Documents</h3>
+              <h3 style={{ fontSize: "0.8rem", color: "#ccc", marginBottom: "0.5rem" }}>
+                Delivery & evidence
+              </h3>
               {chat.messages.flatMap(m => m.actions || []).length > 0 ? (
                 chat.messages.flatMap(m => m.actions || []).map((action, idx) => (
                   <div key={idx} style={{ display: "flex", alignItems: "center", justifyContent: "space-between", padding: "0.25rem 0" }}>
@@ -333,7 +335,9 @@ export function ConversationsCard({
                   </div>
                 ))
               ) : (
-                <p style={{ fontSize: "0.75rem", color: "#9ca3af" }}>No Shippables or AI documents yet</p>
+                <p style={{ fontSize: "0.75rem", color: "#9ca3af" }}>
+                  No settle delivery or evidence surfaces yet
+                </p>
               )}
             </div>
           </div>

apps/uapi/components/conversations/ConversationsDeliveryTemplatePicker/ConversationsDeliveryTemplatePicker.tsx

@@ -20,7 +20,7 @@ interface DeliveryTemplatePickerProps {
 export default function DeliveryTemplatePicker({ isOpen, onSelect, onClose, searchTerm }: DeliveryTemplatePickerProps) {
   const [shippables, setShippables] = useState<Shippable[]>([]);
 
-  // Fetch AssetPack executions that can expose Finish-delivered Shippables.
+  // Fetch AssetPack executions that can expose settle delivery surfaces.
   useEffect(() => {
     if (!isOpen || shippables.length > 0) return;
     fetch('/api/executions?type=agentic-execution:asset-pack')

apps/uapi/hooks/usePatternRecognition.ts

@@ -421,7 +421,7 @@ const generateLearningInsights = (
   // Risk assessment insights
   const highRiskPatterns = patterns.filter(p => p.riskLevel === 'high');
   if (highRiskPatterns.length > 0) {
-    insights.push(`Detected ${highRiskPatterns.length} high-risk pattern(s) - consider splitting the AssetPack synthesis into smaller shippables`);
+    insights.push(`Detected ${highRiskPatterns.length} high-risk pattern(s) - consider splitting AssetPack synthesis into smaller options`);
   }
 
   return insights;

apps/uapi/networking/api-client.ts

@@ -176,7 +176,7 @@ export const callAssetPackExecutionsAPI = async (
 
 /**
  * Fetch a list of pipeline executions (history) for the current user.
- * Each execution may include AssetPack evidence and Finish-delivered Shippables.
+ * Each execution may include AssetPack evidence and settle delivery surfaces.
  */
 export const fetchPipelineExecutionHistory = async (): Promise<PipelineExecution[]> => {
   const response = await fetch('/api/executions/history');

apps/uapi/types/api.ts

@@ -195,7 +195,9 @@ export interface PipelineExecution {
   asset_pack_synthesis_artifacts?: AssetPackSynthesisArtifactsSurface | null;
   /** Semantic reread of the AssetPack synthesis artifacts. */
   written_assets?: AssetPackSurface | null;
-  /** V26 Finish-delivered pull-request Shippable. */
+  /** Canonical settle PR delivery surface. */
+  settle_delivery?: AssetPackSurface | null;
+  /** Historical dual-write of settle_delivery. */
   shippables?: AssetPackSurface | null;
   /** Delivery mechanism projected onto the connected pull-request interface. */
   delivery_mechanism?: AssetPackSurface | null;
@@ -211,7 +213,9 @@ export interface PipelineExecution {
   /** Canonical AssetPack completion payload. */
   asset_pack_completion?: {
     summary?: string | null;
-    /** Primary Finish-delivered Shippables. */
+    /** Canonical settle delivery surface (buyer PR after rights). */
+    settleDelivery?: AssetPackSurface;
+    /** Historical dual-write of settleDelivery. */
     shippables?: AssetPackSurface;
     /** Bitcode-owned implementation-phase AssetPack synthesis artifacts. */
     assetPackSynthesisArtifacts?: AssetPackSynthesisArtifactsSurface;

packages/api/src/routes/asset-pack-pipeline.ts

@@ -1263,6 +1263,7 @@ export const POST = traceRoute('/executions', async (request: NextRequest) => {
             null;
           const completionDelivery =
             assetPackCompletion?.deliveryMechanism ||
+            assetPackCompletion?.settleDelivery ||
             assetPackCompletion?.shippables ||
             null;
           const completionFileChanges = completionWrittenAssets?.fileChanges || null;