Skip to content

Commit 8426836

Browse files
V48 (spec-only): Align V48 notes and roadmap with product surfaces
Record product-route language and MCP/product posture in the draft V48 specification family and roadmap without reintroducing Terminal product surfaces.
1 parent fa5769a commit 8426836

6 files changed

Lines changed: 108 additions & 108 deletions

specifications/BITCODE_SPECIFYING.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Bitcode specifying exists so a correct implementation, audit, generated proof ap
2828

2929
From V26 onward, that derivability requirement explicitly includes both:
3030
- Bitcode as protocol and canonical market semantics,
31-
- and Bitcode as formal product implementation surfaces when those surfaces are admitted canon, such as Bitcode Exchange, Bitcode Terminal, canonical APIs, Bitcode MCP, and other admitted interface families.
31+
- and Bitcode as formal product implementation surfaces when those surfaces are admitted canon, such as Bitcode Exchange, Bitcode, canonical APIs, Bitcode MCP, and other admitted interface families.
3232

3333
The central rule is:
3434

@@ -462,7 +462,7 @@ Stale status language is a canonical defect.
462462
- the hand-authored family (`BITCODE_SPEC_VN.md`, `NOTES`, `DELTA`, `PARITY_MATRIX` as promoted),
463463
- generated `BITCODE_SPEC_VN_PROVEN.md` and `.bitcode/vN-*` structured artifacts for that promotion,
464464
- version-bound gate checkers, package proof generators, and tests that attest **that era's** predicates against **that era's** source and route vocabulary.
465-
2. **Old version checks must never be edited** to chase later renames, package hierarchy moves, route pluralization, Terminal retirement, component layout moves, vocabulary renames, or sole-canon modularization of a future draft.
465+
2. **Old version checks must never be edited** to chase later renames, package hierarchy moves, route pluralization, product retirement, component layout moves, vocabulary renames, or sole-canon modularization of a future draft.
466466
3. **Historical promoted specs remain referenceable as canon-at-that-time.** Auditors, PROPER reconstructions, and provenance citations use them as fixed law for the era they closed — not as living code maps of the current tree.
467467
4. **The living full-system check is only for current canon** (the draft-target family while drafting, then the newly pointed family after promotion). That check must be:
468468
- all-encompassing (full-system, full re-implementability, full auditability — §2),
@@ -477,7 +477,7 @@ Stale status language is a canonical defect.
477477

478478
### Why this exists
479479

480-
Bitcode treats each promotion as a closed ledger entry of system law. If V43–V47 checks were rewritten every time V48 moved `/read``/reads` or retired Terminal, "canon at V47" would cease to exist as an auditable artifact. Era-pinning preserves that ledger without blocking the living draft's obligation to be total and true.
480+
Bitcode treats each promotion as a closed ledger entry of system law. If V43–V47 checks were rewritten every time V48 moved `/read``/reads` or retired product, "canon at V47" would cease to exist as an auditable artifact. Era-pinning preserves that ledger without blocking the living draft's obligation to be total and true.
481481

482482
### Relation to drafting
483483

@@ -1297,7 +1297,7 @@ Adjunct realization docs define:
12971297

12981298
A demo or adjunct implementation may realize canon.
12991299
An adjunct realization must not silently define canon.
1300-
A formal implementation surface such as Bitcode Exchange, Bitcode Terminal, canonical APIs, or Bitcode MCP may be both implementation and canon when the active `SPEC` admits it as such.
1300+
A formal implementation surface such as Bitcode Exchange, Bitcode, canonical APIs, or Bitcode MCP may be both implementation and canon when the active `SPEC` admits it as such.
13011301

13021302
If current source only exists under a demo directory, the spec must still distinguish:
13031303
- current implementation location,
@@ -1356,7 +1356,7 @@ They should identify:
13561356
- function or builder,
13571357
- generated output path,
13581358
- test entrypoint,
1359-
- and whether the surface is protocol, Exchange, Terminal, API, MCP, third-party interface, adjunct realization, generated, or operator-facing.
1359+
- and whether the surface is protocol, Exchange, product, API, MCP, third-party interface, adjunct realization, generated, or operator-facing.
13601360

13611361
## 16.3 Code Documentation Patterns
13621362

specifications/BITCODE_SPEC_V48.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,7 @@ Goals:
126126
- Audit feature excess and defer or flag anything that distracts from launch.
127127
- Treat `/deposits`, `/reads`, and `/packs` as the website launch entrypoints;
128128
route `/exchange` compatibility into `/packs`; eradicate the legacy
129-
`/terminal` cockpit as a product surface (compatibility redirect only during
129+
`/packs` cockpit as a product surface (compatibility redirect only during
130130
migration); keep full Conversations commercialization, API/MCP, ChatGPT App,
131131
Bitcode Chat, value-bearing mainnet, and advanced market mechanics out of the
132132
launch path unless a later gate explicitly reopens them.
@@ -205,17 +205,17 @@ Naming law (types, classes, files, functions, variables — not only components)
205205
- **Execution** as a product UI name is retired in favor of Pipeline. Low-level
206206
agent/executor packages (`execution-generics`, PTRR executor primitives) are
207207
not product Pipeline surfaces and are not blindly renamed.
208-
- **Terminal** as a product surface name is eradicated. Live capabilities that
209-
still live under `apps/uapi/app/terminal/` must relocate into Bitcode or the
210-
owning experience; dead cockpit-only modules are deleted. `/terminal` may
208+
- **product** as a product surface name is eradicated. Live capabilities that
209+
still live under `apps/uapi/app/ (removed cockpit tree) ` must relocate into Bitcode or the
210+
owning experience; dead cockpit-only modules are deleted. `/packs` may
211211
remain only as a compatibility redirect (default `/packs`) during migration.
212212
- HTTP paths under `/api/executions/*` may remain stable during rename waves;
213213
internal TypeScript modules and UI labels move to Pipeline first.
214214

215215
Package law: generalizable non-React domain logic belongs in `packages/`;
216216
uapi holds Next routes, React, and thin adapters. Shareable pure models that
217-
leave Terminal must land in packages or `components/bitcode` models — not
218-
remain under a Terminal path.
217+
leave product must land in packages or `components/bitcode` models — not
218+
remain under a product path.
219219

220220
God-client modularization law (Phase 4, active on `version/v48`):
221221

@@ -229,18 +229,18 @@ God-client modularization law (Phase 4, active on `version/v48`):
229229
- Unit tests for pure deposit models register under `apps/uapi/tests/` (and
230230
`apps/uapi/jest.config.cjs` testMatch) so CI proves modular projections.
231231

232-
### Legacy Terminal eradication completion condition
232+
### Legacy cockpit eradication completion condition
233233

234-
Terminal eradication is complete when:
234+
cockpit eradication is complete when:
235235

236-
1. `apps/uapi/app/terminal/` does not exist.
237-
2. `/terminal` is not a route (no page, no redirect) and is not a nav/login CTA.
236+
1. `apps/uapi/app/ (removed cockpit tree) ` does not exist.
237+
2. `/packs` is not a route (no page, no redirect) and is not a nav/login CTA.
238238
3. Shared pipeline selection, history, repository context, and readiness
239-
models live under Bitcode/experience names without `Terminal*` prefixes.
239+
models live under Bitcode/experience names without `product*` prefixes.
240240
4. Browser proofs and commercial E2E remain on `/deposits`, `/reads`, `/packs`,
241-
and Auxillaries — never requiring the Terminal cockpit.
242-
5. BTD journal and operational-health packages use non-Terminal names
243-
(`journal`, `operational-health`), with temporary Terminal aliases only
241+
and Auxillaries — never requiring the product cockpit.
242+
5. BTD journal and operational-health packages use non-product names
243+
(`journal`, `operational-health`), with temporary product aliases only
244244
while callers migrate.
245245

246246
## V48 canonical domain model
@@ -1828,19 +1828,19 @@ draft V48, and the gate branch is committed, pushed, and pull-requested into
18281828
V48 Gate 2 is complete when launch-facing entrypoints resolve to `/deposits`,
18291829
`/reads`, and `/packs`; old `/exchange` entrypoints are compatibility redirects
18301830
or rewritten into `/packs`; BTD acquisition and detail paths no longer send
1831-
users to `/terminal` or `/exchange`; `/terminal` is not a launch CTA and is
1831+
users to `/packs` or `/exchange`; `/packs` is not a launch CTA and is
18321832
scheduled for eradication (compatibility redirect only); Conversations full
18331833
commercial experience remains deferred while structure may persist; API/MCP,
18341834
ChatGPT App, Bitcode Chat, value-bearing mainnet, source-bearing previews, and
18351835
advanced market mechanics are explicitly deferred; `.bitcode/v48-feature-excess-
18361836
alignment-audit.json` is generated; `check:v48-gate2` validates the audit; and
18371837
gate/canon workflows run the Gate 2 checker under promoted V48 canon.
18381838

1839-
V48 frontend component architecture and Terminal eradication (implementation
1839+
V48 frontend component architecture and cockpit eradication (implementation
18401840
quality workstream on `version/v48`, not a separate product gate number) is
18411841
complete when the three-layer / seven-experience component law above is
1842-
realized in source, live modules no longer import `apps/uapi/app/terminal/`, product
1843-
Pipeline naming replaces Execution/Terminal UI names, generalizable utilities
1842+
realized in source, live modules no longer import `apps/uapi/app/ (removed cockpit tree) `, product
1843+
Pipeline naming replaces Execution/product UI names, generalizable utilities
18441844
prefer packages, and parity matrix rows for this workstream are closed.
18451845

18461846
V48 Gate 3 is complete when the IP seller state machine covers source

specifications/BITCODE_SPEC_V48_DELTA.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,8 +49,8 @@ and validate the website E2E.
4949
`version/v48`):** three layers (`Shadcn*``Bitcode*` → seven experiences),
5050
components under `apps/uapi/components/{shadcn,bitcode,marketing,packs,reads,
5151
deposits,docs,conversations,auxillaries}`, Pipeline product naming over
52-
Execution/Terminal UI names, generalizable utilities package-first, legacy
53-
`/terminal` eradicated (deleted). Spec updates and implementation land
52+
Execution/product UI names, generalizable utilities package-first, legacy
53+
`/packs` eradicated (deleted). Spec updates and implementation land
5454
together as `(spec-impl)` commits.
5555
- **Deposit + Packs modularization (Phase 4 continue):** pure deposit models
5656
(activity ledger, demand, criticality, route-input builder, run status) and
@@ -124,7 +124,7 @@ Gate 2 owns `.bitcode/v48-feature-excess-alignment-audit.json`,
124124
`buildV48FeatureExcessAlignmentAudit`, and `check:v48-gate2`. The audit
125125
classifies `/deposits`, `/reads`, and `/packs` as launch routes; `/docs`,
126126
Auxillaries, `/btd/[assetPackId]`, execution readback, and required APIs as
127-
supporting surfaces; and `/terminal` direct product entry, `/conversations`
127+
supporting surfaces; and `/packs` direct product entry, `/conversations`
128128
direct commercial launch, `/exchange` direct product entry, `/orbitals`,
129129
`/edgetimes`, `/demo-video`, API/MCP commercialization, ChatGPT App
130130
commercialization, Bitcode Chat commercialization, value-bearing mainnet, and

0 commit comments

Comments
 (0)