Skip to content

Commit 734ed34

Browse files
Merge pull request #171 from engineeredsoftware/v42/gate-2-depositing-shortest-path-compensation-visibility
V42 Gate 2: Depositing Shortest Path And Compensation Visibility
2 parents c3fbbaf + d20538f commit 734ed34

28 files changed

Lines changed: 1676 additions & 13 deletions

.bitcode/v42-depositing-shortest-path.json

Lines changed: 483 additions & 0 deletions
Large diffs are not rendered by default.

.github/workflows/bitcode-canon-quality.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -295,6 +295,9 @@ jobs:
295295
if [ -f BITCODE_SPEC_V42.md ]; then
296296
node scripts/check-bitcode-spec-family.mjs --version V42 --mode draft --current-target V41
297297
node scripts/check-v42-gate1-mvp-experience-roadmap-opening.mjs --skip-branch-check
298+
if [ -f scripts/check-v42-gate2-depositing-shortest-path.mjs ]; then
299+
node scripts/check-v42-gate2-depositing-shortest-path.mjs --skip-branch-check --skip-package-tests
300+
fi
298301
fi
299302
else
300303
echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

.github/workflows/bitcode-gate-quality.yml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -424,6 +424,9 @@ jobs:
424424
if [ -f BITCODE_SPEC_V42.md ]; then
425425
node scripts/check-bitcode-spec-family.mjs --version V42 --mode draft --current-target V41
426426
node scripts/check-v42-gate1-mvp-experience-roadmap-opening.mjs --skip-branch-check
427+
if [ -f scripts/check-v42-gate2-depositing-shortest-path.mjs ]; then
428+
node scripts/check-v42-gate2-depositing-shortest-path.mjs --skip-branch-check --skip-package-tests
429+
fi
427430
fi
428431
else
429432
echo "Unexpected BITCODE_SPEC.txt pointer: $POINTER" >&2

BITCODE_SPEC_V42.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -99,9 +99,18 @@ It closes when active V41 / draft V42 truth is visible in the root docs, protoco
9999

100100
## V42 Gate 2 Depositing Shortest Path And Compensation Visibility
101101

102-
Gate 2 must make the shortest deposit path explicit and testable.
102+
Gate 2 makes the shortest deposit path explicit and testable.
103103
The accepted user path is: provide source material, select repository/source anchor, admit deposit to the Depository, receive source-safe admission proof, and see how later BTC compensation will be attributed if the deposit participates in a synthesized AssetPack.
104-
It must cover route/API contracts, source validation, storage projection, Depository search-document creation, BTD/source-to-shares compensation readback, telemetry, and local/staging rehearsal.
104+
The implemented path covers route/API contracts, source validation, storage projection, Depository search-document creation, BTD/source-to-shares compensation readback, telemetry, and local/staging rehearsal posture.
105+
106+
Gate 2 introduces source-safe compensation visibility as a first-class Depository admission readback.
107+
`DepositorySupplyRecord.compensationPreview` and deposit route `depositoryEvidence.compensationPreview` expose only source-safe metadata: compensation state, depositor wallet id, BTC price asset, source-to-shares largest-remainder allocation method, compensation route root, source-to-shares preview root, ledger readback keys, database projection tables, and repair blockers.
108+
The compensation route preview is not a BTD mint and not a rights transfer.
109+
It states that source-to-shares proof, BTC allocation, BTD rights transfer, and source-bearing AssetPack delivery occur only after an accepted Need-Fit creates a paid AssetPack and settlement finality is observed.
110+
111+
Gate 2 proof artifact: `.bitcode/v42-depositing-shortest-path.json`.
112+
The artifact must prove eight source-safe rows: source-to-admission path, deposit route readiness contract, Depository record compensation preview, source-safe search/vector projection, storage readback projection, source-to-shares compensation ledger readback, Terminal compensation visibility readback, and local/staging deposit readback posture.
113+
Validating command: `pnpm run check:v42-gate2`.
105114

106115
## V42 Gate 3 Reading Shortest Path State Machine
107116

BITCODE_SPEC_V42_DELTA.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -35,6 +35,8 @@ Open the V42 full specification family, roadmap, package script, workflow postur
3535
### Gate 2: Depositing Shortest Path And Compensation Visibility
3636

3737
Implement and prove the shortest path from source material to Depository admission proof and later compensation readback.
38+
Gate 2 now binds Depository admission proof to a source-safe compensation route preview, route/API readiness, Depository search documents, vector/storage projection, source-to-shares readback keys, Terminal activity/history/readback fields, and `.bitcode/v42-depositing-shortest-path.json`.
39+
The compensation preview is deliberately pre-mint: it records BTC/source-to-shares eligibility if the deposit is selected into a later paid AssetPack, but it does not mint BTD, transfer rights, expose source, or allocate BTC before accepted Need-Fit and settlement.
3840

3941
### Gate 3: Reading Shortest Path State Machine
4042

BITCODE_SPEC_V42_NOTES.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,9 @@ It opens the reliable MVP experience version after V41 prompt-program promotion
2727
The V42 Depositing path should minimize the journey from source material to Depository admission proof.
2828
The user needs to know that the source is admitted, searchable for future Need-Fit work, and eligible for BTC compensation if it contributes to a synthesized AssetPack.
2929
The UX can stay simple, but expandable details must show source authority, admission proof, storage projection, search-document posture, compensation route, and repair state.
30+
Gate 2 implements that note through `DepositorySupplyCompensationPreview`, deposit route `depositoryEvidence.compensationPreview`, Terminal compensation readback rows, and `.bitcode/v42-depositing-shortest-path.json`.
31+
Local/staging rehearsal for this gate means the deposit route, source-safe evidence projection, generated artifact, package test, and protocol route test can run without value-bearing mainnet behavior.
32+
The staging-testnet lane may read the same source-safe roots and ledger keys, but secrets and private source remain outside generated artifacts.
3033

3134
## Reading shortest-path note
3235

@@ -59,6 +62,10 @@ V43 or a later explicitly opened version should evolve the deposit side into an
5962
Repository-installed Bitcode Agents should compare a connected enterprise codebase, the current Bitcode Depository, and Reading activity to propose deposit AssetPack options.
6063
Those options should be source-safe, sub-critical, likely positive ROI, and approve/rejectable before Depository admission.
6164
That later version should split `/terminal` into `/read` and `/deposit`, and rename `/exchange` to `/packs` across routes, code naming, docs, and operator vocabulary.
65+
The route model should be AssetPacks in and AssetPacks out: `/deposit` creates reviewable deposit AssetPack options from connected source, depositor instructions, and Bitcode's observed Needs; `/read` creates reviewed Need-Fit AssetPack previews and only unlocks source-bearing delivery after settlement; `/packs` is the searchable master-detail activity route for deposited packs, settled read packs, compensation posture, quotes, rights transfer, delivery, and repair.
66+
The `/packs` master view should support column sorting, filtering, and search over measurements, synthesized AssetPack titles and descriptions, values, activity or transaction type, settlement posture, and compensation state.
67+
The detail view should expose the selected activity's source-safe data, proof roots, telemetry, ledger/database synchronization, and expandable payloads without replacing the short default path.
68+
Outside public documentation, product UX should avoid self-referential explanatory copy; route structure, concise labels, progressive detail, and proof-on-expand must make Depositing, Reading, and Pack activity self-explanatory.
6269

6370
## Concise current-system reading
6471

BITCODE_SPEC_V42_PARITY_MATRIX.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ This matrix records the reliable MVP product surfaces that must become promotion
3333
| Roadmap truth | Roadmap states V41 active and V42 draft reliable MVP experience | `SPECIFICATIONS_ROADMAP.md` | drafted |
3434
| Gate workflow | Gate quality knows active V41 / draft V42 posture and V42 Gate 1 | `.github/workflows/bitcode-gate-quality.yml` | drafted |
3535
| Canon workflow | Canon quality knows active V41 / draft V42 posture and V42 Gate 1 | `.github/workflows/bitcode-canon-quality.yml` | drafted |
36-
| Depositing shortest path | Source material can be admitted with Depository proof and compensation visibility | later V42 Gate 2 artifact | draft-required |
36+
| Depositing shortest path | Source material can be admitted with Depository proof and compensation visibility | `.bitcode/v42-depositing-shortest-path.json`, `DepositorySupplyCompensationPreview`, `/api/deposits`, Terminal deposit readback | implemented |
3737
| Reading state machine | Five-step Reading UX is route-owned, persistent, and source-safe | later V42 Gate 3 artifact | draft-required |
3838
| ReadNeed product closure | Need synthesis, review, feedback, resynthesis, and accepted-Need admission are product-ready | later V42 Gate 4 artifact | draft-required |
3939
| Finding Fits preview and quote | Many-candidate search, selected-fit provenance, source-safe preview, and quote are product-ready | later V42 Gate 5 artifact | draft-required |
@@ -47,7 +47,7 @@ This matrix records the reliable MVP product surfaces that must become promotion
4747
| Area | Closure requirement | Judgment |
4848
| --- | --- | --- |
4949
| Gate 1 | Open V42 family, roadmap, docs, workflow posture, package script, and checker | drafted |
50-
| Gate 2 | Depositing shortest path and compensation visibility artifact | draft-required |
50+
| Gate 2 | Depositing shortest path and compensation visibility artifact | implemented |
5151
| Gate 3 | Reading shortest path state machine artifact | draft-required |
5252
| Gate 4 | ReadNeed review and resynthesis product closure artifact | draft-required |
5353
| Gate 5 | ReadFitsFinding AssetPack preview and quote closure artifact | draft-required |

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -87,11 +87,22 @@ later BTC compensation, shortest-path Reading through Need review/resynthesis,
8787
Finding Fits, source-safe AssetPack preview, BTD/BTC settlement, repository
8888
delivery, and an AI-reading dominant demonstration whose AssetPack measurably
8989
improves an AI system beyond public-data-only performance.
90+
V42 Gate 2 adds source-safe Depositing compensation visibility with
91+
`DepositorySupplyCompensationPreview`, deposit route compensation evidence,
92+
Terminal compensation roots, `.bitcode/v42-depositing-shortest-path.json`,
93+
and `check:v42-gate2`. Deposit admission remains pre-mint and pre-rights
94+
transfer; BTC source-to-shares allocation is only a later paid AssetPack
95+
settlement route.
9096
V43+ is roadmapped as the later agentic depositing evolution: repository
9197
agents synthesize deposit AssetPack options from connected enterprise code,
9298
Depository state, and Reading demand; enterprises approve or reject
9399
sub-critical positive-ROI options; `/terminal` separates into `/read` and
94100
`/deposit`; and `/exchange` is renamed to `/packs` across product naming.
101+
That future route model treats AssetPacks as the product object in and out:
102+
`/deposit` proposes deposit AssetPack options from source and Bitcode demand,
103+
`/read` buys synthesized Need-Fit AssetPacks, and `/packs` becomes the
104+
searchable master-detail activity surface for pack measurements, values,
105+
settlement posture, compensation, delivery, proofs, and repair.
95106

96107
Exchange is inherited V36 canon: market-wide activity master-detail, buy/sell/
97108
bid/ask/cancel/accept/settle/history flows, AssetPack range trading,

0 commit comments

Comments
 (0)