Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 15 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,9 +24,9 @@ login file: `.venv/bin/python access.py login --data ./data --out /private/new-l
Use an existing private directory and a new filename, then enter its code in the
browser's Session dialog. Codes expire after ten minutes; sessions last eight
hours. Localhost is not an authenticated identity. Existing catalogs require the
explicit schema-7 upgrade before starting this version. See [actor access](docs/contracts/actors.md)
explicit schema-8 upgrade before starting this version. See [actor access](docs/contracts/actors.md)
for scoped agent credentials and [storage upgrades](docs/contracts/workspace-storage.md).
Existing execution remains owner-only; agent execution approval is a later stage.
Existing CPU and integrity execution remains owner-only. Scoped agents can submit external recipes with an exact, one-use owner approval; see [external recipes](docs/contracts/external-recipes.md).

The setup script uses a Unix socket under `~/.local/share/tuldok/postgres`,
generates private credentials, and creates a database role without superuser,
Expand Down Expand Up @@ -882,4 +882,16 @@ Start with `python app.py --data ./catalog --project-root research=/absolute/res

## Scientific field sequences

For a conforming [scientific field bundle](docs/contracts/scientific-fields.md), use **Import fields** on its project Data reference. Inspect frames, fields and index slices with physical coordinates, units and producer stage labels; save whole-trajectory review and freeze a canonical release. Original bundle and floating-point bytes remain unchanged. First-observed-state and declared-family grouping does not certify independent initial conditions. The cold reader `python scientific_release.py RELEASE.zip` verifies frozen custody; generation and training require later execution milestones.
For a conforming [scientific field bundle](docs/contracts/scientific-fields.md), use **Import fields** on its project Data reference. Inspect frames, fields and index slices with physical coordinates, units and producer stage labels; save whole-trajectory review and freeze a canonical release. Original bundle and floating-point bytes remain unchanged. First-observed-state and declared-family grouping does not certify independent initial conditions. The cold reader `python scientific_release.py RELEASE.zip` verifies frozen custody; the optional [Rheon producer](adapters/rheon/README.md) adds bounded native generation, while training and autonomous evaluation remain later milestones.


## Optional native generation

The [Rheon adapter](adapters/rheon/README.md) assembles a project from an explicitly
supplied qualified binary and original build receipt. Open that project, edit the
bounded grid/frame/seed controls in Pipeline, review the exact execution material
and submit. On a completed scientific artifact, **Import into Data** creates a
draft for inspection, human review and freeze. Native bytes, loaded-library
identity and the original custody receipt are retained. Initial support is Jacobi
generation at grids 8–32 and one or two frames; this is not training, GPU or
general physics acceptance. Generic projects and Data work without the adapter.
48 changes: 48 additions & 0 deletions adapters/rheon/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
# Optional Rheon producer

This package wraps one pinned native trajectory probe as an ordinary Tuldok external
recipe. Tuldok's generic project, data, approval, and Runs owners do not import it.
Removing this package does not disable generic projects or scientific data.

Assemble a new local project from an existing qualified binary and its original
build/capture receipt:

```sh
python adapters/rheon/project.py \
--binary /absolute/path/rheon-trajectory-probe \
--build-receipt /absolute/path/original-receipt.json \
--destination /absolute/path/new-project
```

The assembler creates only the new destination. It never builds, executes,
changes the original files, or overwrites an existing destination. It copies the
original receipt unchanged; that receipt supplies build evidence, not a claim
that earlier captured data was generated by the new Run. The receipt must bind
this adapter's pinned binary, lab/Rheon commits, locked build and toolchain.

Configure the new directory as an allowed project root, open `project.json`, and
select its generation recipe. Bind the `build_receipt` input to the project's
`build_receipt` data reference. The existing Pipeline controls expose grid 8–32,
frames 1–2, and seed 0–2147483647. Defaults are 32, 2, and 100. Jacobi, timestep
1/60, density 1.25, and native solver settings are fixed. Learned pressure and
SGS are not offered by this adapter.

Review the normal execution preflight and approve its exact material before
running. The generic host captures source, native policy, and inputs; the source
binary remains mode 0400. The captured wrapper seals the approved native and
loader bytes, observes loaded file identities while native READY waits for the
first command, and requests complete frames. Runs owns cancellation, descendants,
durable completion, and publication. The adapter is trusted local code, not a
filesystem or network sandbox.

A successful Run publishes `fields.zip` (role `scientific_fields`), `wire.bin`,
`producer-receipt.json`, and `native-diagnostics.txt`. Import `fields.zip` into
Data through its verified artifact action, inspect fields/frames, then separately
review and freeze it. Import parses the actual bytes; the role is only a UI hint.
The six fields preserve little-endian f32/f64 values, C-order ZYX and MAC face
staggering. Native units remain unspecified; field stages are distinct.

See [the producer contract](../../docs/contracts/rheon-producer.md). Local tests
run with `python -m unittest discover -s tests -p test_rheon_adapter.py -v`.
The two actual-native tests explicitly skip when the separately provisioned
pinned scratch build is absent. Authored parser fixtures are not native acceptance.
Loading
Loading