01 / Exchange And TerminalWrite guide

Terminal actions: what writes and what should read back

Every Terminal write should have an expected read result. This guide lists the operator actions and the state they should make visible.

Use this as the practical manual for Terminal operation. It follows the same model as the exhaustive tooltips: write deliberately, then verify the resulting read surface before moving deeper.

After reading

You can identify the write, the expected read, and the proof signal for each major Terminal action.

Flow control posture

01

Controls, flow guide, and working posture

Scenario, projection, branch mode, guide progress, and closure controls stay in one shared control surface.

This card is where the working flow becomes resumable. You should be able to see the current posture, reopen the guide, and continue without reconstructing context.

Why this matters

Controls are not generic preferences. Scenario, projection, branch mode, and guide state decide what Bitcode will measure, materialize, and prove.

  • Guide progress is resumable instead of one-shot
  • Scenario, projection, and branch mode remain explicit
  • Closure control stays adjacent to the active working posture

Deposit-side inventory

02

Search and select supply

Deposit-side supply should be searchable, reviewable, and selectable without turning transactions into an infrastructure note.

Use this surface to bind the current auth session, narrow the inventory, and keep only the supply you want in the active deposit draft before moving into Depositing, fit, and closure.

Why this matters

Supply search is the first filter on what source can become share-bearing intelligence.

  • Keeps searchable supply inside the Bitcode Terminal
  • Makes selected inventory explicit before Depositing drafting
  • Preserves continuity into the deposit draft instead of forcing context rebuilds

Deposit-side intake

03

Depositing flow and submission

Depositing should read like a resumable working draft built from selected supply, not like infrastructure plumbing.

Use this surface to bind selected supply, add issuer and provenance overrides where needed, and submit Depositing while keeping the rest of the working chain coherent.

Why this matters

Deposit provenance is what prevents useful source from becoming anonymous or unauditable.

  • Treats Depositing as a resumable working draft
  • Keeps selected supply and issuer continuity visible
  • Feeds directly into fit, proof, and settlement follow-through

Closure operation

04

Run and review closure follow-through

Closure work should stay adjacent to the active Bitcode activity detail so verification, branch execution, settlement, and ledger follow-through are one continuous operation.

This surface is where you run closure, refresh the current state, and reopen the exact follow-through path without rebuilding context.

Why this matters

Closure is where reviewable Read, verification, branch materialization, proof, and settlement become one consequence chain.

  • Keeps closure controls near the active activity
  • Makes refresh and reset explicit instead of hidden
  • Preserves continuity into Read review, verification, branch, settlement, and ledger reads

Disclosure limits

05

Public docs expose guidance and proof posture, not protected source

Public Bitcode docs derive from the active Protocol, package-owned catalogs, route contracts, and source-safe generated artifacts. They can explain usage, measurements, event ids, proof roots, docs links, runbook links, redaction posture, testnet rollout readiness, fee boundaries, and settlement posture.

They must not reveal protected source payloads, raw protected prompts, secret values, provider tokens, wallet private material, or unpaid AssetPack source. Source-bearing AssetPack contents cross to the reader only after settlement and rights transfer.

Why this matters

This keeps the public product understandable while preserving the boundary that makes Source Shares economically and operationally safe.

  • Allowed: usage guidance, route links, state labels, source-safe measurements, proof roots, dashboard/runbook ids, redacted incident posture, testnet rollout readiness, LocalStagingTelemetryDocumentationRehearsal evidence, and fee/right boundaries.
  • Interface docs may surface event ids, proof roots, docs links, runbook links, and redaction posture from TelemetryDocumentationInterfaceIntegration without revealing source-bearing payloads.
  • Local and staging-testnet rehearsal docs may surface documentation discovery, telemetry event emission, dashboard/runbook lookup, docs QA, incident drill, source-safe proof-root review, and blocked value-bearing mainnet posture.
  • Blocked: secrets, provider tokens, wallet private material, raw protected prompts, protected source payloads, and unpaid AssetPack source.
  • Docs QA fails closed when public docs, internal docs, route docs, interface docs, generated artifacts, proof posture, or workflow checks drift.
  • Deferred boundaries stay explicit: V35 documents Exchange and Conversations usage while deeper product depth remains future-canon work.

Interface preview

Learn with the same UI grammar used in Terminal

These embedded specimens reuse the Terminal card and explainer pattern so docs readers become familiar with the real product surfaces before they operate against them.

Write/read loop

Action cards are bounded state changes

The action guide mirrors Terminal controls: each write has a location, an expected read, and a proof signal.

Write

Operator action

Read

Exchange state

Proof

Closure signal

Action manual

Write deliberately, then read the result

The Terminal is not a button pile. Each write changes a bounded part of Bitcode state, and each expected read tells you whether to continue, stop, or open exact proof detail.

01 / Command deck

Choose the active scenario

Write

Select the measured Read or operating frame the Terminal should honor before fit, branch, and closure work continues.

Expected read

The Terminal rereads deposit, read, fit, and closure against the selected scenario rather than treating it as a cosmetic filter.

Scenario chooses the currently measured read or operating frame that the rest of the Bitcode flow should honor.

02 / Command deck

Set projection

Write

Choose whether the current flow is previewing, staging, or readying a stronger materialized posture.

Expected read

The rest of the Terminal should make clear which posture is being read before any state-changing work is trusted.

Projection determines how the current Bitcode flow is read and staged before materialization.

03 / Command deck and closure controls

Set branch mode

Write

Select the AssetPack execution posture that branch materialization should use when closure runs.

Expected read

Branch, settlement, and proof panels should reflect the selected mode as an operator-visible Bitcode decision.

Branch mode sets the exact AssetPack execution posture that the terminal will materialize when you commit the flow.

04 / Repository context

Select provider and repository

Write

Bind the deposit-side boundary to the provider and repository whose source supply the Terminal may search and cite.

Expected read

Repository supply, deposit provenance, and later closure reads should all stay attached to that selected source perimeter.

This is the deposit-side boundary selector for the repository supply that Bitcode can actually work against.

05 / Repository context

Record repository anchor

Write

Write the selected source perimeter into Bitcode activity so it survives navigation and later rereads.

Expected read

Recent Terminal activity shows repository posture beside deposit, read, proof, and settlement records.

Recording the repository anchor writes the selected source perimeter into recent Bitcode Terminal activity.

06 / Deposit-side supply

Search, filter, and select supply

Write

Use auth session, artifact kind, and inventory search to narrow the supply set before drafting a deposit.

Expected read

Selected inventory remains explicit and can be carried directly into deposit, deposit, fit, and closure.

Deposit-side supply should be searchable, reviewable, and selectable without turning transactions into an infrastructure note.

07 / Deposit + read workbench

Record deposit-side posture

Write

Record the current deposit-side summary into the Bitcode activity ledger when supply posture is ready to be reread.

Expected read

The selected activity can show what was offered, where it came from, and how it relates to later fit.

Supply, read measurement, and fit should read as one operating chain so you can judge why the current Bitcode activity is or is not moving forward.

08 / Read measurement

Record active Read

Write

Write the currently measured demand frame into the Bitcode activity ledger before fit and closure read against it.

Expected read

The Terminal activity result can reopen the exact Read frame with parser posture, scenario, and review state intact.

Recording the active read writes the currently measured demand frame into recent Bitcode Terminal activity.

09 / Read measurement

Accept, reject, or remeasure Read

Write

Choose whether the measured Read is admitted for Finding Fits, rejected, or sent back for remeasurement with feedback.

Expected read

Finding Fits stays blocked until Read review is accepted, and the closure map shows the current review posture.

The active reader demand frame should be explicit and switchable before you judge fit, proof, or settlement posture.

10 / Deposit intake

Complete deposit provenance

Write

Set source repo, source commit or ref, signer address, selected supply, and optional raw content where exact provenance is required.

Expected read

The deposit draft reads as source-backed supply rather than loose metadata, with readiness blockers visible before submit.

Depositing should read like a resumable working draft built from selected supply, not like infrastructure plumbing.

11 / Deposit intake

Deposit into Bitcode

Write

Submit selected supply, provenance, and content into the Bitcode activity chain.

Expected read

A ledger row should be rereadable immediately and should carry forward into fit, proof, settlement, and history.

Deposit submission should bind selected supply, provenance, and optional raw content into the same Bitcode activity chain.

12 / External interface readiness

Record external interface readiness

Write

Record whether connections, attachments, repository scope, and boundary services are live, modeled, blocked, or review-only.

Expected read

The Terminal shows boundary truth before downstream AssetPacks or settlement are trusted.

Bitcode should show what is live, modeled, boundary-only, or blocked without making you infer that state from failures later in the flow.

13 / Closure controls

Run closure and branch follow-through

Write

Run the closure path from Read review through verification, branch materialization, settlement, and proof.

Expected read

Verification, branch artifacts, AssetPack settlement, ledger continuity, and history should read as one consequence chain.

Closure action is the visible bridge from Read-review posture into verification, branch, settlement, and ledger follow-through.

14 / Closure controls

Refresh or reset closure state

Write

Refresh the current closure read or reset closure state when the operator needs to rebuild the exact follow-through path.

Expected read

The Terminal should make runtime status, visible artifacts, proof families, credited assets, and flow continuity explicit.

Closure work should stay adjacent to the active Bitcode activity detail so verification, branch execution, settlement, and ledger follow-through are one continuous operation.

15 / Support rail and experience map

Open Conversations

Write

Open natural-language drafting and coordination without losing the current Bitcode activity context.

Expected read

The Terminal remains the primary ledger, while conversation output can assist drafting and follow-through.

Conversations are a deliberate mode change, not a competing destination.

16 / Support rail and navigation

Open Auxillaries

Write

Open profile, connects, interface defaults, wallet posture, and $BTD state when identity or interface posture must change.

Expected read

The Terminal keeps its selected activity context while Auxillaries changes readiness and account posture.

Open the Bitcode auxillary shell for access, profile, interface defaults, and $BTD posture.