V48 (impl-only): Protocol settle_delivery vocabulary and Terminal cut

Rename product language from Shippable to settle delivery across UI,
conversations tokens, postprocess kinds, MCP, and templates docs.
Rename Terminal product helpers to Pipeline/Read names.
Finish promptparts no longer instruct PR Shippables; settle ships PRs.
Header CSS settle-delivery-header; history items use delivery_* fields.

Author: geraldarthurdavis

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

@@ -33,7 +33,7 @@ The Model Context Protocol (MCP) server exposing Bitcode’s technical knowledge
 
 ## Features
 
-- Tools interface for AssetPack execution and optional Shippable delivery
+- Tools interface for AssetPack execution and optional settle delivery
 - Real‑time streaming (WebSocket)
 - Multi‑modal attachments (Figma, documents, images, audio, video)
 - BTC fee posture plus measured non-fungible $BTD AssetPack amount
@@ -239,7 +239,7 @@ The Model Context Protocol (MCP) server exposing Bitcode’s technical knowledge
             subtype: {
               type: 'string',
               enum: ['pull_request'],
-              description: 'V26 Shippable type to create'
+              description: 'Delivery template type to create'
             },
             attachments: {
               type: 'array',

apps/mcp/src/types/index.ts

@@ -14,7 +14,7 @@ export type PipelinePhase =
   | 'validation'
   | 'finish';
 export type PipelineSubType = string;
-export type ShippableSubType = string;
+export type SettleDeliverySubType = string;
 export type InterfaceIngressSurface =
   | 'bitcode_mcp'
   | 'third_party_mcp'
@@ -157,7 +157,7 @@ export interface PipelineInputContext {
 }
 
 /**
- * Canonical output meaning for AssetPack/Shippable results.
+ * Canonical output meaning for AssetPack / settle delivery results.
  */
 export interface AssetPackResult {
   kind: 'asset_pack';
@@ -295,14 +295,14 @@ export const BasePipelineToolSchema = z.object({
 });
 
 /**
- * AssetPack pipeline tool schema with Shippable subtype specialization.
+ * AssetPack pipeline tool schema with settle-delivery subtype specialization.
  */
 export const AssetPackPipelineToolSchema = BasePipelineToolSchema.extend({
   subtype: z.enum([
     'pull_request', 'pr_review', 'issue', 'comment', 'blog_post', 
     'diagram', 'api_spec', 'frontend_scaffolder', 'scope_analysis',
     'implementation_plan', 'refactor_proposal'
-  ] as const).describe('Specific Shippable subtype or AssetPack written-asset focus'),
+  ] as const).describe('Specific settle-delivery subtype or AssetPack written-asset focus'),
 
   // AssetPack/Finish delivery options.
   options: z.object({

apps/uapi/app/api/templates/delivery/route.ts

@@ -46,7 +46,7 @@ export async function GET(request: Request) {
     const message =
       templatesError instanceof Error
         ? templatesError.message
-        : 'Failed to load Shippable templates';
+        : 'Failed to load Delivery templates';
 
     return NextResponse.json({ error: message, templates: [] }, { status: 500 });
   }
@@ -78,7 +78,7 @@ export async function POST(request: Request) {
   if (!name || !templateText || !types.length) {
     return NextResponse.json(
       {
-        error: 'Shippable template name, text, and at least one Shippable type are required',
+        error: 'Delivery template name, text, and at least one delivery type are required',
         templates: [],
       },
       { status: 400 },
@@ -88,7 +88,7 @@ export async function POST(request: Request) {
   if (types.some((type) => type !== 'pullRequests')) {
     return NextResponse.json(
       {
-        error: 'V26 Shippable templates support pull request delivery only',
+        error: 'V26 Delivery templates support pull request delivery only',
         templates: [],
       },
       { status: 400 },
@@ -113,7 +113,7 @@ export async function POST(request: Request) {
     const message =
       templatesError instanceof Error
         ? templatesError.message
-        : 'Failed to save Shippable template';
+        : 'Failed to save Delivery template';
 
     return NextResponse.json({ error: message, templates: [] }, { status: 500 });
   }

apps/uapi/app/executions/README.md

@@ -1,37 +1,16 @@
-# `/app/executions` retained Bitcode Executions route
+# `/app/executions` Bitcode Pipeline Executions route
 
-`/executions` remains the retained execution route during V26 fourth-gate convergence.
+`/executions` is the product surface for pipeline run history, settle delivery
+panels, AssetPack synthesis evidence, and execution logs.
 
-It is not the final Bitcode product topology.
-Merged-world V26 keeps this retained route explicit as `executions`, where Bitcode execution primitives, pipelines, and measured-read follow-through remain inspectable while the broader `activity` family grows around transactions, executions, and notifications.
-The retained execution route must remain explicit and healthy while the strongest execution, Shippable, and inspection patterns continue porting inward to `/packs`.
+Protocol law:
+- Deposit/Read synthesis = SDIVF (Finish closes evidence; does not open buyer PRs)
+- Buyer-repo PR shipping = settle Simple (`ship-asset-pack-patch-pr`) → `settleDelivery`
 
 Current owners:
-- `page.tsx`
-  Direct route metadata for the retained executions surface.
-- `[runId]/page.tsx`
-  Direct retained execution-detail route for one run.
-- `components/ExecutionsPage.tsx`
-  Route-level shell for the main retained executions read.
-- `components/ExecutionsPageClient.tsx`
-  The active retained runs, Shippables, AssetPack evidence, and execution-log composition owner.
-- `components/ExecutionsDetailsView.tsx`
-  Shared retained execution-detail carrier used by direct route and converged application reads.
-- `../api/executions/route.ts`
-  Active app-owned `/api/executions` route mounted from the canonical Shippables business-logic owner.
-- `../api/executions/history/*`
-  App-owned retained history JSON carriers for selected-run hydration.
-- `../api/vcs/route.ts`
-  Retained support carrier for provider/account/repository/branch/commit/issue reads required by the execution selectors.
-- `../api/templates/shippables/route.ts`
-  Active Shippable template reads and writes used by the execution composer.
-- `../api/auxillaries/template-preferences/route.ts`
-  Retained support storage carrier for saved Shippable-template preferences used by the execution composer.
-
-This route should stay explicit about:
-- retained executions, measured-read runs, pipeline continuity, and execution-primitives naming,
-- the broader `activity` family above transactions, executions, and notifications,
-- Shippable, AssetPack evidence, and execution inspection semantics,
-- retained support API ownership required to keep the route healthy during inward convergence,
-- direct route/API ownership during fourth-gate,
-- and inward convergence toward `/packs` plus merged-world `activity` ownership rather than peer-product permanence.
+- `page.tsx` / `[runId]/page.tsx` — route shells
+- `components/bitcode/pipeline/*` — Executions UI (header, complete, settle delivery panels)
+- `../api/executions/route.ts` — live SDIVF synthesis (`asset-pack-pipeline` handlers)
+- `../api/executions/history/*` — history reread JSON
+- `../api/templates/delivery/route.ts` — delivery template CRUD
+- `../api/auxillaries/template-preferences/route.ts` — `delivery_templates` prefs

apps/uapi/components/bitcode/orbitals/OrbitalsConnectsOrbitalEmailConnection/OrbitalsConnectsOrbitalEmailConnection.tsx

@@ -315,7 +315,7 @@ export function OrbitalsConnectsOrbitalEmailConnection({ userId, userEmail, onCo
                 <strong>From:</strong> {emailConfig?.email}
               </div>
               <div className="orbitals-connects-email-field">
-                <strong>Subject:</strong> Deliver application shippables
+                <strong>Subject:</strong> Deliver application settle delivery
               </div>
             </header>
             <div className="orbitals-connects-email-body">

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

@@ -58,9 +58,9 @@ export function ExecutionDetailsView({ runId, executionId }: ExecutionDetailsVie
   const runOutput = (run as any).output || (run as any).output_data || {};
   const assetPackCompletion = runOutput?.asset_pack_completion || (run as any).asset_pack_completion || null;
   const writtenAssets = getHeaderWrittenAssets(assetPackCompletion);
-  const shippables = getHeaderSettleDelivery(assetPackCompletion);
-  const deliveryMechanism = shippables;
-  const mergedAssetPackSurface = mergeHeaderSettleDelivery(writtenAssets, shippables);
+  const settleDelivery = getHeaderSettleDelivery(assetPackCompletion);
+  const deliveryMechanism = settleDelivery;
+  const mergedAssetPackSurface = mergeHeaderSettleDelivery(writtenAssets, settleDelivery);
   const ReactMarkdown = dynamic(() => import('react-markdown'), { ssr: false });
 
   // Extract execution state and output from events

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

@@ -25,7 +25,7 @@ const CodeBlock = dynamic(() => import("@/components/bitcode/media/SyntaxHighlig
 });
 import { ProcessingIndicator } from "@/components/bitcode/indicators/ProcessingIndicator/ProcessingIndicator";
 // global styles for the header
-import "@/styles/shippables-header.css";
+import "@/styles/settle-delivery-header.css";
 
 // Extracted component & styles
 import DeliveryTemplateText from "@/components/bitcode/pipeline/ExecutionsDeliveryTemplateText/ExecutionsDeliveryTemplateText";
@@ -375,7 +375,7 @@ export default function ExecutionsPageHeader({
     mode: 'execute',
     slowEntranceAnimations: false,
     showMockData: false,
-    enabledShippables: {
+    enabledSettleDelivery: {
       pullRequest: false,
       fileChanges: false,
       summary: false,
@@ -593,7 +593,7 @@ export default function ExecutionsPageHeader({
                   <li><span className="text-white">Maximum abstraction</span>: Optimal code organization and reusability</li>
                   <li><span className="text-white">Error handling</span>: Robust error management and recovery</li>
                 </ul>
-                <div className="text-xs text-gray-500 mt-2">Ideal for production-critical shippables requiring maximum reliability.</div>
+                <div className="text-xs text-gray-500 mt-2">Ideal for production-critical settle delivery requiring maximum reliability.</div>
               </div>
             )
           }

apps/uapi/components/bitcode/pipeline/models/pipeline-run-data.ts

@@ -70,7 +70,7 @@ export const MOCK_RUNS: WorkspaceRun[] = [
     btcFeeUsdEquivalent: 6.72,
     averageLatencyMs: 1180,
     proofStatus: 'bounded proof bundle ready',
-    closureFocus: 'AssetPack evidence + Finish PR mechanism',
+    closureFocus: 'AssetPack evidence + settle delivery',
   },
   {
     id: 'mock-run-read-measurement-pass',
@@ -191,13 +191,13 @@ export const MOCK_RUN_ACTIVITY: Record<
       phase: 'Branch remediation',
       agent: 'Branch synthesizer',
       step: 'prepare_concise_context',
-      generation: 'Shippable bundle',
+      generation: 'Settle delivery bundle',
     },
     latestWorkUpdate: {
       id: 'wu-1',
       iteration: 2,
       confidence: 0.94,
-      prose: 'Remediation branch artifacts and Shippable surfaces are aligned for transaction review.',
+      prose: 'Remediation branch artifacts and settle delivery surfaces are aligned for transaction review.',
       timestamp: '2026-04-16T12:01:40.000Z',
     },
     iterationUpdates: [
@@ -212,7 +212,7 @@ export const MOCK_RUN_ACTIVITY: Record<
         id: 'wu-2',
         iteration: 2,
         confidence: 0.94,
-        prose: 'Remediation branch artifacts and Shippable surfaces are aligned for transaction review.',
+        prose: 'Remediation branch artifacts and settle delivery surfaces are aligned for transaction review.',
         timestamp: '2026-04-16T12:01:40.000Z',
       },
     ],

apps/uapi/components/bitcode/pipeline/models/pipeline-selection-query.ts

@@ -232,14 +232,14 @@ export function readProductConversationHandoffContext(searchParams: URLSearchPar
   };
 }
 
-export function writeTerminalTransactionId(searchParams: URLSearchParams, transactionId: string) {
+export function writePipelineTransactionId(searchParams: URLSearchParams, transactionId: string) {
   const nextParams = new URLSearchParams(searchParams.toString());
   nextParams.set(SEARCH_PARAM_KEYS.transactionId, transactionId);
   nextParams.delete(SEARCH_PARAM_KEYS.runIdAlias);
   return nextParams;
 }
 
-export function clearTerminalTransactionId(searchParams: URLSearchParams) {
+export function clearPipelineTransactionId(searchParams: URLSearchParams) {
   const nextParams = new URLSearchParams(searchParams.toString());
   nextParams.delete(SEARCH_PARAM_KEYS.transactionId);
   nextParams.delete(SEARCH_PARAM_KEYS.runIdAlias);
@@ -259,7 +259,7 @@ export function writeProductEnvironmentMode(
   return nextParams;
 }
 
-export function writeTerminalDebugEnabled(searchParams: URLSearchParams, enabled: boolean) {
+export function writePipelineDebugEnabled(searchParams: URLSearchParams, enabled: boolean) {
   const nextParams = new URLSearchParams(searchParams.toString());
   if (!enabled) {
     nextParams.delete(SEARCH_PARAM_KEYS.debug);
@@ -309,7 +309,7 @@ export function writeProductTransactionFilters(
   return nextParams;
 }
 
-export function writeTerminalTransactionPagination(
+export function writePipelineTransactionPagination(
   searchParams: URLSearchParams,
   pagination: TransactionPagination,
 ) {
@@ -330,7 +330,7 @@ export function writeTerminalTransactionPagination(
   return nextParams;
 }
 
-export function shouldRecoverTerminalTransactionRoute({
+export function shouldRecoverPipelineTransactionRoute({
   transactionIds,
   selectedTransactionId,
 }: {

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

@@ -13,7 +13,7 @@ import "@/styles/conversations/conversation-card.css";
 
 interface MessageToken {
   id: string;
-  type: "evidence_document" | "shippable" | "attachment" | "source" | "command" | "destination" | "pipeline_run";
+  type: "evidence_document" | "settle_delivery" | "attachment" | "source" | "command" | "destination" | "pipeline_run";
   text: string;
   data: any;
 }