V48 (specification-implementation): Hierarchy sole-canon modularization and dual purge

Complete the package hierarchy modularization on version/v48: single-home packages only, no dual barrels or Context/artifacts/protocol BC paths, product pipelines under asset-packs-pipelines, process-root Execution under generic-executions, and artifact providers under generic-artifacts/*-provider|compose|patch-kind. Retarget uapi, packages, tests, jest/tsconfig, and active docs; keep historical proofs era-pinned where Terminal/singular routes were superseded.

Verified green: uapi tsc, lint, jest (522 pass), next build; package tests for generic-executions, execution-generics, pipelines-generics, agent-generics, specifying (100 pass / 137 era-pinned skip).

Author: geraldarthurdavis

.bitcode/application-composition-proof.json

@@ -50,57 +50,57 @@
       "detail": "11 source evidence requirements satisfied",
       "requiredEvidence": [
         {
-          "file": "packages/chatgptapp/src/tools.ts",
+          "file": "packages/external-apps/chatgpt/src/tools.ts",
           "evidence": "function assertConfirmedConnectedInterfaceWrite",
           "description": "ChatGPT App write tools share a fail-closed confirmation guard"
         },
         {
-          "file": "packages/chatgptapp/src/tools.ts",
+          "file": "packages/external-apps/chatgpt/src/tools.ts",
           "evidence": "Bitcode ChatGPT App write admission requires confirmed: true",
           "description": "direct tool execution rejects unconfirmed connected-interface writes"
         },
         {
-          "file": "packages/chatgptapp/src/tools.ts",
+          "file": "packages/external-apps/chatgpt/src/tools.ts",
           "evidence": "permission: 'explicit_user_confirmation'",
           "description": "write receipts expose explicit confirmation as the permission basis"
         },
         {
-          "file": "packages/chatgptapp/src/tools.ts",
+          "file": "packages/external-apps/chatgpt/src/tools.ts",
           "evidence": "exchangeStateRole: 'connected_interface_delivery_mechanism'",
           "description": "ChatGPT App writes are delivery mechanisms rather than Exchange state owners"
         },
         {
-          "file": "packages/chatgptapp/src/server.ts",
+          "file": "packages/external-apps/chatgpt/src/server.ts",
           "evidence": "Bitcode is the source-to-shares protocol surfaced through ChatGPT",
           "description": "server instructions frame ChatGPT App as a Bitcode Terminal companion interface"
         },
         {
-          "file": "packages/chatgptapp/src/__tests__/tools.test.ts",
+          "file": "packages/external-apps/chatgpt/src/__tests__/tools.test.ts",
           "evidence": "rejects ChatGPT App connected-interface writes without explicit confirmation",
           "description": "unit proof covers unconfirmed write rejection"
         },
         {
-          "file": "packages/chatgptapp/src/__tests__/tools.test.ts",
+          "file": "packages/external-apps/chatgpt/src/__tests__/tools.test.ts",
           "evidence": "declares confirmation schema on every ChatGPT App connected-interface write carrier",
           "description": "unit proof covers schema-level confirmation requirements across GitHub, Vercel, and AWS write carriers"
         },
         {
-          "file": "packages/chatgptapp/src/__tests__/tools.test.ts",
+          "file": "packages/external-apps/chatgpt/src/__tests__/tools.test.ts",
           "evidence": "write_code_changes_to_vcs creates GitHub repository after explicit write admission",
           "description": "unit proof covers GitHub write admission through the ChatGPT App VCS tool"
         },
         {
-          "file": "packages/chatgptapp/src/__tests__/tools.test.ts",
+          "file": "packages/external-apps/chatgpt/src/__tests__/tools.test.ts",
           "evidence": "targetAnchor: 'github:bitcode-yapper'",
           "description": "unit proof covers target-bound GitHub write admission"
         },
         {
-          "file": "packages/chatgptapp/src/__tests__/tools.test.ts",
+          "file": "packages/external-apps/chatgpt/src/__tests__/tools.test.ts",
           "evidence": "targetAnchor: 'vercel:team_bitcode/prj_Yapper'",
           "description": "unit proof covers target-bound Vercel write admission"
         },
         {
-          "file": "packages/chatgptapp/src/__tests__/yapperFlow.test.ts",
+          "file": "packages/external-apps/chatgpt/src/__tests__/yapperFlow.test.ts",
           "evidence": "confirmed: true",
           "description": "demo-flow proof invokes write tools through explicit confirmation payloads"
         }

.bitcode/conversations-continuity-proof.json

@@ -28,9 +28,9 @@
     "uapi/app/api/conversations/[conversationId]/stream/route.ts",
     "uapi/app/api/conversations/branch/route.ts",
     "uapi/app/api/conversations/_shared.ts",
-    "packages/conversations-generics/src/index.ts",
-    "packages/conversations-generics/src/agent/ConversationAgent.ts",
-    "packages/conversations-generics/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
+    "packages/conversations/src/index.ts",
+    "packages/conversations/src/agent/ConversationAgent.ts",
+    "packages/conversations/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
     "packages/api/src/routes/conversations.ts",
     "packages/api/src/conversations/conversations.ts",
     "packages/api/src/conversations/messages.ts",
@@ -77,9 +77,9 @@
       "passed": true,
       "detail": "14 required files present",
       "requiredFiles": [
-        "packages/conversations-generics/src/index.ts",
-        "packages/conversations-generics/src/agent/ConversationAgent.ts",
-        "packages/conversations-generics/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
+        "packages/conversations/src/index.ts",
+        "packages/conversations/src/agent/ConversationAgent.ts",
+        "packages/conversations/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
         "packages/api/src/routes/conversations.ts",
         "packages/api/src/conversations/conversations.ts",
         "packages/api/src/conversations/messages.ts",

.bitcode/inference-implementation-records-proof.json

@@ -164,7 +164,7 @@
       "implementationOwnerRefs": [
         "packages/tools-generics/src/doc-code-tool/DocCodeToolPrompt.ts",
         "packages/tools-generics/src/doc-code-tool/formatUsableTools.ts",
-        "packages/doc-code/src/transformDocCodeTools.ts",
+        "packages/generic-doc-comments/doc-code/src/transformDocCodeTools.ts",
         "packages/tools-generics/src/Tool.ts",
         "packages/tools-generics/src/execution/ToolExecution.ts",
         "packages/tools-generics/src/execution/ToolPromptRegistry.ts",
@@ -178,14 +178,14 @@
         "packages/tools-generics/src/execution/ToolPromptRegistry.ts",
         "packages/tools-generics/src/doc-code-tool/DocCodeToolPrompt.ts",
         "packages/tools-generics/src/doc-code-tool/formatUsableTools.ts",
-        "packages/doc-code/src/transformDocCodeTools.ts",
-        "packages/doc-comment/src/build-plugin.ts"
+        "packages/generic-doc-comments/doc-code/src/transformDocCodeTools.ts",
+        "packages/doc-comment-generics/src/build-plugin.ts"
       ],
       "missingSourceEvidenceRefs": [],
       "verificationSet": [
         "node --test protocol-demonstration/test/v26-prompt-runtime-loadability.test.js",
         "node --test protocol-demonstration/test/v26-prompt-system-boundary.test.js",
-        "packages/doc-code/src/__tests__/transform.test.ts"
+        "packages/generic-doc-comments/doc-code/src/__tests__/transform.test.ts"
       ],
       "verificationEvidence": [
         {
@@ -199,9 +199,9 @@
           "refPath": null
         },
         {
-          "value": "packages/doc-code/src/__tests__/transform.test.ts",
+          "value": "packages/generic-doc-comments/doc-code/src/__tests__/transform.test.ts",
           "evidenceType": "source-test",
-          "refPath": "packages/doc-code/src/__tests__/transform.test.ts"
+          "refPath": "packages/generic-doc-comments/doc-code/src/__tests__/transform.test.ts"
         }
       ],
       "verificationEvidenceTypeCounts": {
@@ -409,17 +409,17 @@
       "invalidBoundaryPosture": null,
       "missingSectionFields": [],
       "implementationOwnerRefs": [
-        "packages/conversations-generics/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
+        "packages/conversations/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
         "uapi/prompts/bitcode-terminal-system-prompt.ts",
-        "packages/conversations-generics/src/agent/ConversationAgent.ts",
+        "packages/conversations/src/agent/ConversationAgent.ts",
         "packages/api/src/conversations/conversations.ts",
         "packages/api/src/conversations/streaming.ts",
         "uapi/app/api/conversations/stream/route.ts"
       ],
       "missingImplementationOwnerRefs": [],
       "sourceEvidenceRefs": [
-        "packages/conversations-generics/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
-        "packages/conversations-generics/src/agent/ConversationAgent.ts",
+        "packages/conversations/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
+        "packages/conversations/src/agent/ConversationAgent.ts",
         "uapi/prompts/bitcode-terminal-system-prompt.ts",
         "packages/api/src/conversations/conversations.ts",
         "packages/api/src/conversations/streaming.ts",
@@ -478,7 +478,7 @@
         "packages/generic-tools/simple-system-text-search/src/prompts/SimpleSystemTextSearchDocCodeToolPrompt.ts",
         "packages/asset-packs-pipelines/domain/src/tools/AssetPackCloneVCSRepositoryTool.ts",
         "packages/asset-packs-pipelines/domain/src/tools/search.ts",
-        "packages/system-grep/src/index.ts",
+        "packages/host-commands/grep/src/index.ts",
         "packages/generic-tools/simple-system-text-search/src/index.ts",
         "packages/generic-tools/files-maintaining/src/index.ts",
         "packages/generic-tools/files-maintaining/src/prompts/TextEditorDocCodeToolPrompt.ts",
@@ -521,8 +521,8 @@
         "packages/generic-agents/text-searcher/src/prompts/try-prompt-text-searcher.ts",
         "packages/generic-agents/text-searcher/src/prompts/refine-prompt-text-searcher.ts",
         "packages/generic-agents/text-searcher/src/prompts/retry-prompt-text-searcher.ts",
-        "packages/system-grep/README.md",
-        "packages/system-grep/src/index.ts",
+        "packages/host-commands/grep/README.md",
+        "packages/host-commands/grep/src/index.ts",
         "packages/generic-tools/simple-system-text-search/package.json",
         "packages/generic-tools/simple-system-text-search/README.md",
         "packages/generic-tools/simple-system-text-search/src/index.ts",
@@ -954,18 +954,18 @@
       "invalidBoundaryPosture": null,
       "missingSectionFields": [],
       "implementationOwnerRefs": [
-        "packages/executions-mcp/README.md",
-        "packages/executions-mcp/src/index.ts",
+        "packages/mcp-generics/README.md",
+        "packages/mcp-generics/src/index.ts",
         "packages/tools-generics/src/mcp/MCPToolWrapper.ts",
         "uapi/components/base/bitcode/execution/BitcodeExecutionStreamPanel.tsx"
       ],
       "missingImplementationOwnerRefs": [],
       "sourceEvidenceRefs": [
-        "packages/executions-mcp/package.json",
-        "packages/executions-mcp/README.md",
-        "packages/executions-mcp/src/index.ts",
-        "packages/executions-mcp/src/mcp-server/package.json",
-        "packages/executions-mcp/src/mcp-server/tsconfig.typecheck.json",
+        "packages/mcp-generics/package.json",
+        "packages/mcp-generics/README.md",
+        "packages/mcp-generics/src/index.ts",
+        "packages/mcp-generics/src/mcp-server/package.json",
+        "packages/mcp-generics/src/mcp-server/tsconfig.typecheck.json",
         "packages/tools-generics/src/mcp/MCPToolWrapper.ts",
         "uapi/components/base/bitcode/execution/BitcodeExecutionStreamPanel.tsx",
         "protocol-demonstration/V26_APPLICATION_SYSTEMS.md"
@@ -1061,7 +1061,7 @@
         "owners": [
           "packages/tools-generics/src/doc-code-tool/DocCodeToolPrompt.ts",
           "packages/tools-generics/src/doc-code-tool/formatUsableTools.ts",
-          "packages/doc-code/src/transformDocCodeTools.ts"
+          "packages/generic-doc-comments/doc-code/src/transformDocCodeTools.ts"
         ],
         "rawPromptPartBoundary": "doc-code labels and DocCodeToolPrompt paths",
         "registryLayering": "Tool prompt descriptions enter agent runs through prompt-aware registries while generic prompt fragments remain reusable base layers and tool-specific DocCodeToolPrompt material specializes implementation paths.",
@@ -1099,7 +1099,7 @@
       "verificationSet": [
         "node --test protocol-demonstration/test/v26-prompt-runtime-loadability.test.js",
         "node --test protocol-demonstration/test/v26-prompt-system-boundary.test.js",
-        "packages/doc-code/src/__tests__/transform.test.ts"
+        "packages/generic-doc-comments/doc-code/src/__tests__/transform.test.ts"
       ],
       "sourceEvidenceRefs": [
         "packages/tools-generics/package.json",
@@ -1108,8 +1108,8 @@
         "packages/tools-generics/src/execution/ToolPromptRegistry.ts",
         "packages/tools-generics/src/doc-code-tool/DocCodeToolPrompt.ts",
         "packages/tools-generics/src/doc-code-tool/formatUsableTools.ts",
-        "packages/doc-code/src/transformDocCodeTools.ts",
-        "packages/doc-comment/src/build-plugin.ts"
+        "packages/generic-doc-comments/doc-code/src/transformDocCodeTools.ts",
+        "packages/doc-comment-generics/src/build-plugin.ts"
       ]
     },
     {
@@ -1306,7 +1306,7 @@
       "canonicalNeed": "Provide the rich-input Bitcode write surface that binds conversation prompts, attachments, tool registration, streams, and ad hoc execution continuity.",
       "promptImplementation": {
         "owners": [
-          "packages/conversations-generics/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
+          "packages/conversations/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
           "uapi/prompts/bitcode-terminal-system-prompt.ts"
         ],
         "rawPromptPartBoundary": "conversation system prompt plus app-level binding",
@@ -1315,13 +1315,13 @@
       },
       "toolImplementation": {
         "owners": [
-          "packages/conversations-generics/src/agent/ConversationAgent.ts"
+          "packages/conversations/src/agent/ConversationAgent.ts"
         ],
         "contract": "Conversation tools are registered through the conversation agent and app-facing rich-input surface."
       },
       "agentImplementation": {
         "owners": [
-          "packages/conversations-generics/src/agent/ConversationAgent.ts"
+          "packages/conversations/src/agent/ConversationAgent.ts"
         ],
         "contract": "ConversationAgent owns conversation bootstrap, tool registration, and rich-input inference posture."
       },
@@ -1348,8 +1348,8 @@
         ".bitcode/conversations-continuity-proof.json"
       ],
       "sourceEvidenceRefs": [
-        "packages/conversations-generics/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
-        "packages/conversations-generics/src/agent/ConversationAgent.ts",
+        "packages/conversations/src/prompts/BitcodeTerminalConversationSystemPrompt.ts",
+        "packages/conversations/src/agent/ConversationAgent.ts",
         "uapi/prompts/bitcode-terminal-system-prompt.ts",
         "packages/api/src/conversations/conversations.ts",
         "packages/api/src/conversations/streaming.ts",
@@ -1381,7 +1381,7 @@
         "owners": [
           "packages/asset-packs-pipelines/domain/src/tools/AssetPackCloneVCSRepositoryTool.ts",
           "packages/asset-packs-pipelines/domain/src/tools/search.ts",
-          "packages/system-grep/src/index.ts",
+          "packages/host-commands/grep/src/index.ts",
           "packages/generic-tools/simple-system-text-search/src/index.ts",
           "packages/generic-tools/files-maintaining/src/index.ts",
           "packages/generic-tools/files-maintaining/src/prompts/TextEditorDocCodeToolPrompt.ts",
@@ -1450,8 +1450,8 @@
         "packages/generic-agents/text-searcher/src/prompts/try-prompt-text-searcher.ts",
         "packages/generic-agents/text-searcher/src/prompts/refine-prompt-text-searcher.ts",
         "packages/generic-agents/text-searcher/src/prompts/retry-prompt-text-searcher.ts",
-        "packages/system-grep/README.md",
-        "packages/system-grep/src/index.ts",
+        "packages/host-commands/grep/README.md",
+        "packages/host-commands/grep/src/index.ts",
         "packages/generic-tools/simple-system-text-search/package.json",
         "packages/generic-tools/simple-system-text-search/README.md",
         "packages/generic-tools/simple-system-text-search/src/index.ts",
@@ -1822,16 +1822,16 @@
       "canonicalNeed": "Admit Exchange-facing MCP and external interface operations as fail-closed ingress into Bitcode execution state, not as sibling product logic.",
       "promptImplementation": {
         "owners": [
-          "packages/executions-mcp/README.md",
-          "packages/executions-mcp/src/index.ts"
+          "packages/mcp-generics/README.md",
+          "packages/mcp-generics/src/index.ts"
         ],
         "rawPromptPartBoundary": "MCP tool descriptions only where admitted by V26 prompt/tool records",
         "registryLayering": "MCP ingress prompt descriptions may enter prompt-aware registries only as specific implementation layers bound to admitted Bitcode tool records.",
         "runtimeCarryThrough": "MCP descriptions must not promote non-admitted tool families into live Bitcode behavior."
       },
       "toolImplementation": {
         "owners": [
-          "packages/executions-mcp/src/index.ts",
+          "packages/mcp-generics/src/index.ts",
           "packages/tools-generics/src/mcp/MCPToolWrapper.ts"
         ],
         "contract": "Admitted Exchange-facing tool families are narrowed and create admission fails closed on permission, repository, and provider readiness."
@@ -1842,7 +1842,7 @@
       },
       "executionImplementation": {
         "owners": [
-          "packages/executions-mcp/src/index.ts",
+          "packages/mcp-generics/src/index.ts",
           "uapi/components/base/bitcode/execution/BitcodeExecutionStreamPanel.tsx"
         ],
         "carriers": [
@@ -1862,11 +1862,11 @@
         "pnpm -C packages/executions-mcp run typecheck"
       ],
       "sourceEvidenceRefs": [
-        "packages/executions-mcp/package.json",
-        "packages/executions-mcp/README.md",
-        "packages/executions-mcp/src/index.ts",
-        "packages/executions-mcp/src/mcp-server/package.json",
-        "packages/executions-mcp/src/mcp-server/tsconfig.typecheck.json",
+        "packages/mcp-generics/package.json",
+        "packages/mcp-generics/README.md",
+        "packages/mcp-generics/src/index.ts",
+        "packages/mcp-generics/src/mcp-server/package.json",
+        "packages/mcp-generics/src/mcp-server/tsconfig.typecheck.json",
         "packages/tools-generics/src/mcp/MCPToolWrapper.ts",
         "uapi/components/base/bitcode/execution/BitcodeExecutionStreamPanel.tsx",
         "protocol-demonstration/V26_APPLICATION_SYSTEMS.md"