Skip to content

Commit 28a57a5

Browse files
V48 (specification-implementation): Modularize full deposit stack across uapi and packages
Split all major deposit-touched modules into SRP units while preserving public import paths: depository-search (types/scoring/evidence/normalize/run), deposit option policy/admission/options/earnings/demand (types+helpers+source-safe utils), depository-supply-index (types/helpers/build-record/projections), asset-packs-synthesis (catalogs/inventory/neediness/validate), deposit agents (schema/prompts/checks), pipeline-hosts harness (constants/runners/builder), uapi deposit UI (option card, source field grid, aside, obfuscations), synthesize-options (parse+dispatch), and reads deposit workbench (panels/hooks/ evidence models). Restate rebuild law in SPEC G3-14a and NOTES/PARITY.
1 parent d02e47d commit 28a57a5

93 files changed

Lines changed: 14578 additions & 12301 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

BITCODE_SPEC_V48.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -592,6 +592,13 @@ The `/deposits` commercial surface is modular by SRP, not a single god client:
592592
6. Rebuilders must follow `internal-docs/BITCODE_SOURCE_LAYOUT.md`; do not
593593
reassemble deposit law into a single multi-thousand-line page client.
594594

595+
Package modularization (deposit domain): depository-search, deposit option
596+
policy/admission/options/earnings/demand, depository-supply-index, and
597+
asset-packs-synthesis are split into types/helpers/builders with stable public
598+
entry paths under `@bitcode/pipeline-asset-pack/*`. Harness plan builder is
599+
split from in-box runner templates. Agents co-locate schema/prompts/checks.
600+
601+
595602
### G3-15 Gate 3 completion condition
596603

597604
Gate 3 is closed when:

BITCODE_SPEC_V48_NOTES.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1427,3 +1427,27 @@ Canonical filesystem and co-location rules live in
14271427
co-located `hooks/`, `styles/`, `__tests__/`
14281428
- Domain pure logic prefers `packages/`; pages stay thin
14291429
- Terminal remains deleted
1430+
1431+
1432+
### Deposit full-stack modularization landing (Garrett, 2026-07-13 — aggressive pass)
1433+
1434+
**packages/pipelines/asset-pack**
1435+
- `depository-search` → types / scoring / evidence / normalize / run + barrel (1898→43)
1436+
- deposit option domain → types + helpers + shared `deposit-source-safe-utils`
1437+
- `depository-supply-index` → types / helpers / build-record / projections
1438+
- `asset-packs-synthesis` → types / catalogs / neediness / inventory / validate + barrel
1439+
- deposit agents → schema / prompts / checks co-located under agents/
1440+
1441+
**packages/pipeline-hosts**
1442+
- `asset-pack-harness` → constants + runners templates + plan builder
1443+
1444+
**uapi deposits**
1445+
- Option card, source field grid, aside panels, obfuscations controls
1446+
- synthesize-options: parse body + dispatch modules; thin route
1447+
1448+
**uapi reads (deposit workbench)**
1449+
- ReadsDepositReadWorkbench orchestrator + hooks + stage panels
1450+
- deposit-read-workbench models split; evidence types/extract/row-builders
1451+
1452+
Public package export paths preserved. Jest deposit/depository/synthesis suites green.
1453+

BITCODE_SPEC_V48_PARITY_MATRIX.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ storage readback, wallet/provider receipts, and repository delivery receipts.
6969
| BTD journal / operational health naming | Package modules use `journal` and `operational-health` (non-Terminal); temporary Terminal aliases until callers migrate | substantially advanced | `packages/btd/src/journal.ts` + `operational-health.ts` canonical; `terminal-journal` / `terminal-operational-health` shims | version/v48 workstream |
7070
| Package-first utilities | Generalizable pure logic from uapi `lib/` and pure terminal models live in `packages/` or Bitcode models | substantially advanced| Law specified; wallet/cancel/analytics extractions planned Phase 7 | version/v48 workstream |
7171
| God-client modularization | Deposit/Read/Packs page clients thin; logic in experience subcomponents/hooks/models (SRP) | substantially advanced | Packs shell ~187 LOC; DepositPageClient ~677 LOC orchestration with models + hooks (live runs, demand, URL, VCS inventory, option actions, activity recording, synthesis lifecycle); DepositSourceSelection ~682 render + VCS hook; Read still pending | version/v48 workstream |
72-
| Deposit modular units | Pure deposit projections + hooks unit-tested; G3-14 source map lists modular paths | substantially advanced | Models + 9 page-client hooks + VCS hook + named UI units under `uapi/components/deposits/`; jest allowlist includes `depositActivityLedger`, `depositSourceCriticality`, `depositRunStatus` | version/v48 workstream |
72+
| Deposit modular units | Pure deposit projections + hooks unit-tested; G3-14 source map lists modular paths | substantially advanced | UAPI deposits+reads workbench modular; packages asset-pack depository-search/options/supply/synthesis + agents + harness split with stable exports; jest deposit/depository/synthesis green | version/v48 workstream |
7373

7474
## Grouped closure gates
7575

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
/**
2+
* AssetPack sandbox harness path and timeout constants.
3+
* Shared by harness plan builder and in-box runner templates.
4+
*/
5+
6+
export const HARNESS_DIRECTORY = '.bitcode/pipeline-harness';
7+
export const MANIFEST_PATH = `${HARNESS_DIRECTORY}/manifest.json`;
8+
export const HOST_SMOKE_RUNNER_PATH = `${HARNESS_DIRECTORY}/run-host-smoke.mjs`;
9+
export const LIVE_PIPELINE_RUNNER_PATH = `${HARNESS_DIRECTORY}/run-live-asset-pack-pipeline.ts`;
10+
export const SOURCE_OVERLAY_PATCH_PATH = `${HARNESS_DIRECTORY}/source-overlay.patch`;
11+
export const EVIDENCE_PATH = `${HARNESS_DIRECTORY}/evidence.json`;
12+
export const TELEMETRY_PATH = `${HARNESS_DIRECTORY}/telemetry.jsonl`;
13+
export const TSCONFIG_PATHS_REGISTER_PATH = `${HARNESS_DIRECTORY}/node_modules/tsconfig-paths/register`;
14+
export const PIPELINE_STDOUT_PATH = `${HARNESS_DIRECTORY}/pipeline.stdout.log`;
15+
export const PIPELINE_STDERR_PATH = `${HARNESS_DIRECTORY}/pipeline.stderr.log`;
16+
export const PIPELINE_EXIT_CODE_PATH = `${HARNESS_DIRECTORY}/pipeline.exit-code`;
17+
export const SANDBOX_WORKING_DIRECTORY = '/vercel/sandbox' as const;
18+
export const DEFAULT_LONG_TIMEOUT_MS = 45 * 60 * 1000;
19+
export const SANDBOX_PNPM_VERSION = '10.33.0';

0 commit comments

Comments
 (0)