V48 (specification-implementation): Extract SDIVF base into packages/generic-pipelines/SDIVF

Establish the Pipeline inheritance hierarchy as primitive → base → product:
pipelines-generics (Pipeline/PhaseDelegator) → generic-pipelines-sdivf
(Setup-[DIV]*-Finish) → pipeline-asset-pack (SynthesizeAssetPacks; future
SettleAssetPacks). Own factorySDIVFExecutorPipeline/factorySDIVFPipeline/
SDIVFPhase in @bitcode/generic-pipelines-sdivf; re-export from
pipelines-generics for compatibility; wire AssetPack and docs/tests/jest maps.

Author: geraldarthurdavis

BITCODE_SPEC_V48_NOTES.md

@@ -1491,3 +1491,18 @@ SOURCE_LAYOUT:
 | Edge-case handler | Real concern modules + thin class facade |
 
 Navigation map: `FAMILIARIZATION.md`. Layout contract: `internal-docs/BITCODE_SOURCE_LAYOUT.md`.
+
+
+## SDIVF base package (Garrett, 2026-07-13)
+
+Pipeline inheritance hierarchy is now explicit:
+
+```
+@bitcode/pipelines-generics              # Pipeline / PhaseDelegator primitives
+  → @bitcode/generic-pipelines-sdivf     # packages/generic-pipelines/SDIVF
+    → @bitcode/pipeline-asset-pack       # SynthesizeAssetPacks (future SettleAssetPacks)
+```
+
+`factorySDIVFExecutorPipeline` / `factorySDIVFPipeline` / `SDIVFPhase` live in
+`@bitcode/generic-pipelines-sdivf`. AssetPack imports the base package directly.
+`pipelines-generics` re-exports for compatibility.

FAMILIARIZATION.md

@@ -142,15 +142,23 @@ pipeline-local tools            e.g. AssetPackLexicalDepositorySearchTool
 ### 3.3 Pipelines
 
 ```
-@bitcode/pipelines-generics     Pipeline, PhaseDelegator, SDIVF factories, streaming
+@bitcode/pipelines-generics              Pipeline, PhaseDelegator, composition, streaming
         ↑
-@bitcode/pipeline-asset-pack    SynthesizeAssetPacks SDIVF (deposit | read modes)
-@bitcode/pipeline-hosts         Inline host + Vercel Sandbox harness
+@bitcode/generic-pipelines-sdivf         SDIVF *base* loop (Setup-[DIV]*-Finish)
+        ↑
+@bitcode/pipeline-asset-pack             SynthesizeAssetPacks (deposit | read);
+                                         future SettleAssetPacks extends SDIVF base
+@bitcode/pipeline-hosts                  Inline host + Vercel Sandbox harness
 ```
 
 **SDIVF** = Setup → Discovery → Implementation → Validation → Finish  
 (Discovery/Implementation/Validation may loop up to `maxIterations`).
 
+Package path: `packages/generic-pipelines/SDIVF/` (`@bitcode/generic-pipelines-sdivf`).
+Product pipelines supply phase executors/agents; they do not reimplement the DIV loop.
+`pipelines-generics` re-exports SDIVF for compatibility — prefer importing
+`@bitcode/generic-pipelines-sdivf` in new code.
+
 Product UI says **Pipeline**. Low-level packages may still say `execution` /
 `Execution` — do **not** rename `execution-generics` blindly.
 
@@ -227,7 +235,8 @@ Grouped by role. Names are `@bitcode/<name>` unless noted.
 | `execution-generics` | `Execution` state tree, `Executor`, sequential/parallel/pipe |
 | `agent-generics` | Agent = Executor + PTRR + failsafes + generations |
 | `tools-generics` | `Tool` class, factories, MCP bridges |
-| `pipelines-generics` | Pipeline / PhaseDelegator / SDIVF factories / stream hooks |
+| `pipelines-generics` | Pipeline / PhaseDelegator primitives / stream hooks (re-exports SDIVF) |
+| `generic-pipelines-sdivf` | SDIVF base loop (`packages/generic-pipelines/SDIVF`) |
 | `llm-generics` | Pure LLM call contracts |
 | `registry` | Hierarchical registry (Prompt is a Registry) |
 | `prompts` | Prompt + PromptPart + **all** raw prompt parts |
@@ -562,7 +571,7 @@ as if they were source of product law.
 | --- | --- |
 | Executor composition | `execution-generics` sequential/parallel/pipe |
 | Agent PTRR | `agent-generics` |
-| Phase pipeline | `pipelines-generics` SDIVF factories |
+| Phase pipeline | `generic-pipelines-sdivf` base (via `pipelines-generics` primitives) |
 | Registry hierarchy | `registry` → `Prompt` |
 | Source-safe allowlist | pipeline streaming + deposit UI contracts |
 | Thin HTTP route | validate → dispatch → return id; long work off-request |

internal-docs/BITCODE_SOURCE_LAYOUT.md

@@ -192,8 +192,9 @@ packages/
     src/
       product-analytics.ts
   btd/                         # BTD measurement, journal, settlement, authority
-  pipelines/                   # AssetPack synthesis pipelines (SDIVF, …)
-  pipelines-generics/
+  pipelines-generics/          # Pipeline / PhaseDelegator primitives
+  generic-pipelines/SDIVF/     # SDIVF base Pipeline (extends pipelines-generics)
+  pipelines/asset-pack/        # SynthesizeAssetPacks (extends SDIVF base)
   agent-generics/              # PTRR agents (not product “Pipeline” UI)
   execution-generics/          # low-level executor primitives
   prompts/
@@ -248,8 +249,11 @@ bitcode/
 │   │       ├── journal.ts
 │   │       ├── operational-health.ts
 │   │       └── ...
+│   ├── pipelines-generics/            # Pipeline / PhaseDelegator primitives
+│   ├── generic-pipelines/
+│   │   └── SDIVF/                     # @bitcode/generic-pipelines-sdivf base
 │   ├── pipelines/
-│   │   └── asset-pack/                # SynthesizeAssetPacks SDIVF, …
+│   │   └── asset-pack/                # SynthesizeAssetPacks (extends SDIVF)
 │   ├── agent-generics/
 │   ├── execution-generics/
 │   ├── prompts/

package.json

@@ -10,6 +10,7 @@
     "packages/*",
     "packages/generic-tools/*",
     "packages/generic-agents/*",
+    "packages/generic-pipelines/*",
     "packages/pipelines/*",
     "uapi",
     "admin"

packages/generic-pipelines/README.md

@@ -0,0 +1,21 @@
+# generic-pipelines
+
+Base pipeline implementations that extend `@bitcode/pipelines-generics` primitives.
+
+## Hierarchy
+
+```
+@bitcode/pipelines-generics          # Pipeline / PhaseDelegator / composition primitives
+        ↑
+@bitcode/generic-pipelines-sdivf     # SDIVF base loop (this folder: SDIVF/)
+        ↑
+@bitcode/pipeline-asset-pack         # SynthesizeAssetPacks (and future SettleAssetPacks)
+```
+
+## Packages
+
+| Path | Package name | Role |
+| --- | --- | --- |
+| `SDIVF/` | `@bitcode/generic-pipelines-sdivf` | Setup-[Discovery-Implementation-Validation]*-Finish base |
+
+Product pipelines supply phase agents/executors; they do not reimplement the DIV loop.

packages/generic-pipelines/SDIVF/jest.config.cjs

@@ -0,0 +1,33 @@
+/**
+ * Jest configuration for @bitcode/generic-pipelines-sdivf
+ */
+module.exports = {
+  preset: 'ts-jest/presets/js-with-ts',
+  testEnvironment: 'node',
+  testMatch: ['**/__tests__/**/*.test.(ts|tsx)'],
+  roots: ['<rootDir>'],
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+  moduleNameMapper: {
+    '^@bitcode/generic-pipelines-sdivf$': '<rootDir>/src/index.ts',
+    '^@bitcode/pipelines-generics$': '<rootDir>/../../pipelines-generics/src/index.ts',
+    '^@bitcode/pipelines-generics/(.*)$': '<rootDir>/../../pipelines-generics/src/$1',
+    '^@bitcode/execution-generics$': '<rootDir>/../../execution-generics/src/index.ts',
+    '^@bitcode/execution-generics/(.*)$': '<rootDir>/../../execution-generics/src/$1',
+    '^@bitcode/agent-generics$': '<rootDir>/../../agent-generics/src/index.ts',
+    '^@bitcode/agent-generics/(.*)$': '<rootDir>/../../agent-generics/src/$1',
+    '^@bitcode/registry$': '<rootDir>/../../registry/src/index.ts',
+    '^@bitcode/prompts$': '<rootDir>/../../prompts/src/index.ts',
+    '^@bitcode/doc-comment$': '<rootDir>/../../pipelines-generics/src/__mocks__/doc-comment.ts',
+    '^@bitcode/tools-generics$': '<rootDir>/../../pipelines-generics/src/__mocks__/tools-generics.ts',
+    '^@bitcode/llm-generics$': '<rootDir>/../../llm-generics/src/index.ts',
+    '^@bitcode/orm$': '<rootDir>/../../orm/src/index.ts',
+    '^@bitcode/streams$': '<rootDir>/../../streams/src/index.ts',
+    '^@bitcode/logger$': '<rootDir>/../../logger/src/index.ts',
+  },
+  globals: {
+    'ts-jest': {
+      tsconfig: '<rootDir>/../../../tsconfig.json',
+      diagnostics: false,
+    },
+  },
+};

packages/generic-pipelines/SDIVF/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@bitcode/generic-pipelines-sdivf",
+  "version": "1.0.0",
+  "description": "SDIVF base Pipeline implementation: Setup-[Discovery-Implementation-Validation]*-Finish extending pipelines-generics primitives",
+  "main": "src/index.ts",
+  "types": "src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./sdivf-factory": "./src/sdivf-factory.ts",
+    "./sdivf-phases": "./src/sdivf-phases.ts"
+  },
+  "scripts": {
+    "build": "tsc --noEmit",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm exec jest --config jest.config.cjs --passWithNoTests"
+  },
+  "dependencies": {
+    "@bitcode/execution-generics": "workspace:*",
+    "@bitcode/agent-generics": "workspace:*",
+    "@bitcode/pipelines-generics": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.0.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.1",
+    "typescript": "^5.0.0"
+  }
+}