Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
162 commits
Select commit Hold shift + click to select a range
9a87197
store: machine-wide content-addressed store of blobs and refs
tomaszbk Nov 18, 2026
c186798
std/blake3: BLAKE3 in portable Odin with group values
tomaszbk Nov 18, 2026
c68c941
std/blake3: compress chunks from the input, four at once
tomaszbk Nov 18, 2026
d987ccb
Merge branch 'store/integration' into std/blake3
tomaszbk Nov 18, 2026
fed60d1
asset: records of imports in the machine store
tomaszbk Nov 18, 2026
1c14bab
store: completion publishes only checked bytes; kept tables and readers
tomaszbk Nov 18, 2026
81d306f
Merge branch 'store/integration' into store/blobs
tomaszbk Nov 18, 2026
cf2bd2b
Merge branch 'store/integration' into imports/contract
tomaszbk Nov 18, 2026
25d8191
net: bulk streams find the path rate and leave game channels on time
tomaszbk Nov 18, 2026
9c7b4e4
store: address blobs with standard BLAKE3
tomaszbk Nov 18, 2026
6888984
Merge branch 'store/integration' into store/blobs
tomaszbk Nov 18, 2026
4243f38
store: the address of bytes is their BLAKE3 hash, without a table
tomaszbk Nov 18, 2026
129eed7
Merge branch 'store/integration' into net/bulk
tomaszbk Nov 18, 2026
b68029f
asset: the registry lists the outputs of packages, not sidecars
tomaszbk Nov 18, 2026
0ece3fd
import: the writer puts its outputs and its package in the machine store
tomaszbk Nov 18, 2026
5a039af
Merge branch 'asset/registry-listed' into import/library
tomaszbk Nov 18, 2026
344bcdc
cook/cache: results are refs into the machine store
tomaszbk Nov 18, 2026
bb1d750
net: streams survive outages, long acks and gaps of small messages
tomaszbk Nov 18, 2026
4b5ab8a
Merge branch 'cache/store-refs' into import/library
tomaszbk Nov 18, 2026
3ae24e8
project: every registry lists the packages of its root from the store
tomaszbk Nov 18, 2026
644922c
store: a sweep safe beside writers, and leases
tomaszbk Nov 18, 2026
23afa4e
editor: the session owns the path of its program
tomaszbk Nov 18, 2026
a4c3f7e
import: the sync of a project becomes a machine library of packages
tomaszbk Nov 18, 2026
c2495ad
Merge branch 'project/pins-resolve' into imports/wave
tomaszbk Nov 18, 2026
6634111
Merge branch 'store/integration' into imports/wave
tomaszbk Nov 18, 2026
fed408b
exchange: blobs and refs of the store between peers over net
tomaszbk Nov 18, 2026
e3ca0a7
Merge branch 'store/integration' into store/transport
tomaszbk Nov 18, 2026
b9a3cb0
exchange: fix the review's defects of trust, reservations and shutdown
tomaszbk Nov 18, 2026
ef4e5d2
net: a bulk stream keeps its rate on a path that reorders
tomaszbk Nov 18, 2026
0d6d611
Merge branch 'store/integration' into net/reordering
tomaszbk Nov 18, 2026
faf21df
editor: import through the machine library
tomaszbk Nov 18, 2026
d76ca24
import: a root carries the manifests it pins, and the repository's ro…
tomaszbk Nov 18, 2026
dcd30da
Merge branch 'editor/library' into imports/wave
tomaszbk Nov 18, 2026
ef6cdf5
Merge branch 'store/integration' into imports/wave
tomaszbk Nov 18, 2026
1f99bdf
asset: say how to fix a store of another layout
tomaszbk Nov 18, 2026
ba97dd6
build: refresh and cook from the library, ship plugin builds in the i…
tomaszbk Nov 18, 2026
cf8774e
import: one store per value where the library and the writer keep agg…
tomaszbk Nov 19, 2026
adff4db
import: following a package writes only what differs, and the demo's …
tomaszbk Nov 19, 2026
d53c48f
Merge branch 'imports/refresh-idempotent' into imports/wave
tomaszbk Nov 19, 2026
72b5c2e
share: share and join a project from the command line
tomaszbk Nov 19, 2026
fe0dc87
Merge branch 'store/integration' into share/command-line
tomaszbk Nov 19, 2026
7151f72
share: a node's clock starts at its first step, and a stopped join's …
tomaszbk Nov 19, 2026
935b504
exchange: small blobs come whole, many to a request, and blocking for…
tomaszbk Nov 19, 2026
d67ab1a
share: fetch the blobs of a build together
tomaszbk Nov 19, 2026
d668810
net: a UDP socket asks for 4 MiB send and receive buffers
tomaszbk Nov 19, 2026
a3723af
share: a snapshot's entry has the size of what was put, and the index…
tomaszbk Nov 19, 2026
93c7c88
share: a join follows renames by case, keeps edits made while it runs…
tomaszbk Nov 19, 2026
8062acb
share: a refresh asks the peers for every manifest and build in one b…
tomaszbk Nov 19, 2026
f562660
skills: what a shared file carries, case, incomplete joins and batche…
tomaszbk Nov 19, 2026
5715fd6
std/blake3: a root from group values given one at a time
tomaszbk Nov 19, 2026
6f87cf0
store, exchange: checked and durable blobs, sharing on Windows, held …
tomaszbk Nov 19, 2026
9312c4c
store: a lease holds while its holder runs on its machine (N3)
tomaszbk Nov 19, 2026
0165d3d
asset: store_sweep, the sweep a long-running owner calls (N1)
tomaszbk Nov 19, 2026
5f8879d
Merge branch 'store/integration' into store/compare-fixes
tomaszbk Nov 19, 2026
0c99330
Merge origin/main into store/merge-main
tomaszbk Nov 19, 2026
fc14569
Merge store/integration into store/merge-main
tomaszbk Nov 19, 2026
7adbd3c
Tests of the merge: make folders as every platform does, and name a d…
tomaszbk Nov 19, 2026
d35071f
One store per value where the merge brought aggregates of more than 6…
tomaszbk Nov 19, 2026
b054d07
store: chunks and nodes, the contract of the chunked store (B1)
tomaszbk Nov 19, 2026
ef85162
Demo content reads the ids of imports from the manifests the demo pin…
tomaszbk Nov 19, 2026
4bed0b9
store: a group carries the byte offset of its first leaf
tomaszbk Nov 19, 2026
903d253
Merge branch 'store/integration' into store/chunks-contract
tomaszbk Nov 19, 2026
6d8cf35
net: reliable chunks sized to the datagram, batched datagrams, a work…
tomaszbk Nov 19, 2026
3a327b0
net: datagrams sealed with AEGIS-128L; resent bytes counted
tomaszbk Nov 19, 2026
812af77
store: chunks in packs, commits, refs as frames, generations and a sw…
tomaszbk Nov 19, 2026
73db365
store: the skill describes the packs store
tomaszbk Nov 19, 2026
ffc2d92
Merge branch 'store/integration' into store/packs
tomaszbk Nov 19, 2026
877c842
exchange: protocol 3 moves chunks of objects, asked by address with a…
tomaszbk Nov 19, 2026
aa8bc28
store: a sweep keeps what live roots reach at every level, beside eve…
tomaszbk Nov 19, 2026
0ccf9e4
store: the skill says how retired packs, leases and dead writers stay…
tomaszbk Nov 19, 2026
11e07bf
store: the bridge keeps only what consumers of blobs use; receiving i…
tomaszbk Nov 19, 2026
5e5819a
exchange: the reference describes protocol 3, a bench over UDP loopba…
tomaszbk Nov 19, 2026
bac4305
Merge branch 'store/integration' into exchange/chunks
tomaszbk Nov 19, 2026
10a12c1
exchange: reading, hashing, storing, walking, serving and committing …
tomaszbk Nov 19, 2026
43b4bd8
asset: a native asset is an object of the store, one group per contai…
tomaszbk Nov 19, 2026
bb4b005
asset: records are objects, the build manifest (version 2) names obje…
tomaszbk Nov 19, 2026
6c67f4c
cook/cache: results are objects and many keys are looked up in one fetch
tomaszbk Nov 19, 2026
5d41b79
cook/import: outputs are put as objects, and a plugin's document a re…
tomaszbk Nov 19, 2026
50d4df8
host: listed assets load from the store by parts, and a part not here…
tomaszbk Nov 19, 2026
64e6b7d
cook/build: a cook ships package assets from their objects and looks …
tomaszbk Nov 19, 2026
b4363af
skills: package assets are objects of the store read by parts
tomaszbk Nov 19, 2026
9ef74a4
exchange: the reference says what runs on jobs; net's reference says …
tomaszbk Nov 19, 2026
7e892cb
cook/cache: the ref of a result carries the layout of results, raised…
tomaszbk Nov 19, 2026
588629e
share: the snapshot is a tree of objects, files materialize by chunks
tomaszbk Nov 19, 2026
e269b9c
cook/import: a test of the extension of a plugin's document; animatio…
tomaszbk Nov 19, 2026
a3a6930
host: the store of listed assets opens the first time one is read
tomaszbk Nov 19, 2026
a8f48fb
asset: the hostile build of the current version is corrupt
tomaszbk Nov 19, 2026
b34c9b5
cook/build: a file that is no listed output is read as it is
tomaszbk Nov 19, 2026
6e9bee7
Merge branch 'store/integration' into share/tree
tomaszbk Nov 19, 2026
aa6b7e5
Merge branch 'store/integration' into asset/parts
tomaszbk Nov 19, 2026
e43217c
share: the test network's clock moves only while the join waits for it
tomaszbk Nov 19, 2026
8121893
Merge branch 'store/integration' into share/tree
tomaszbk Nov 19, 2026
0a51b46
share: a build manifest is an object, and peers may read package mani…
tomaszbk Nov 19, 2026
cfdb503
build: binaries are published by renaming whole files into place
tomaszbk Nov 19, 2026
1708b5a
Merge branch 'store/integration' into build/replace-binaries
tomaszbk Nov 19, 2026
cdaab46
store: finish removing the blob bridge
tomaszbk Nov 19, 2026
7d7328e
share: a share serves the Fast builds, and a join takes what an edito…
tomaszbk Nov 19, 2026
15bbf5e
tools: --store on mirai scene, mirai ui and mirai texts
tomaszbk Nov 19, 2026
f6c7b01
import: the editor build an import runs uses its store, and a failed …
tomaszbk Nov 19, 2026
94f4ad9
build: one store per value in the import and the join
tomaszbk Nov 19, 2026
310265e
import: the build of a whole source is found by key without its source
tomaszbk Nov 19, 2026
0ec2e9b
Merge remote-tracking branch 'origin/main' into store/verify
tomaszbk Nov 19, 2026
932d301
demo: the three tree sources origin/main added pin packages with the …
tomaszbk Nov 19, 2026
5721633
store: a commit that returns is durable: frames and marker, then one …
tomaszbk Nov 19, 2026
7b9ce38
asset: every size of an object's meta is bounded by its groups before…
tomaszbk Nov 19, 2026
e38d839
share: a join never writes or removes through a link inside its folder
tomaszbk Nov 19, 2026
1a64d06
share: a join checks a file again right before renaming its replacement
tomaszbk Nov 19, 2026
6588a71
share: the snapshot of an invitation is asked only of the host it con…
tomaszbk Nov 19, 2026
a23187b
exchange: a test that a batch of refs waits for the slots of the last…
tomaszbk Nov 19, 2026
f3231c1
share: a join ends in bounded time without progress whatever a peer w…
tomaszbk Nov 19, 2026
9d27408
library: a pin update lands whole or leaves the root as it was
tomaszbk Nov 19, 2026
02ec091
library: a refresh asks for a missing manifest by the ref that names …
tomaszbk Nov 19, 2026
78ca5d1
library: a refresh takes a build only when this engine decodes its fo…
tomaszbk Nov 19, 2026
e2f71c2
docs: the store's focal test and the lines of the sharing section
tomaszbk Nov 19, 2026
3586277
share: the CLI share and join read, hash and store on the exchange's …
tomaszbk Nov 19, 2026
2fc610b
store: a sweep reports what its value lent and keeps mapped as held, …
tomaszbk Nov 19, 2026
bf6129c
asset: the hostile build record without fields carries the current ve…
tomaszbk Nov 19, 2026
a7c213a
library: the test of an unreadable build expects a peer to find none
tomaszbk Nov 19, 2026
0a1ab76
gltf: the tests write their models into a store of their own
tomaszbk Nov 19, 2026
ab55c99
editor: the library test checks the texture is an object of the store
tomaszbk Nov 19, 2026
12f3083
Merge branch 'store/integration' into store/verify
tomaszbk Nov 19, 2026
6abc637
Merge remote-tracking branch 'origin/main' into store/verify
tomaszbk Nov 19, 2026
729f0f4
import: a rebuild takes objects only from builds of its own compressor
tomaszbk Nov 19, 2026
4add4f1
Merge remote-tracking branch 'origin/main' into store/verify
tomaszbk Nov 19, 2026
6430684
cook/share: a node over an owner's hosts, offer, and the progress of …
tomaszbk Nov 19, 2026
0aa9e7b
store: a frame compresses its chunk with this build's codec; the addr…
tomaszbk Nov 19, 2026
ea038de
asset: an object holds its file as Codecs.None writes it; only a cook…
tomaszbk Nov 19, 2026
6c56291
exchange: chunks travel in a codec their receiver decodes (protocol 5)
tomaszbk Nov 19, 2026
1028532
net: the invitation carries a key and the first datagram carries data
tomaszbk Nov 19, 2026
8c033ef
cook/share: node totals say which peers went bad and what was refused
tomaszbk Nov 19, 2026
2aeff5e
packages: any engine reads any build; the compressor of builds goes
tomaszbk Nov 19, 2026
6ddc4cb
cook: compresses what it ships from files written without a compressor
tomaszbk Nov 19, 2026
51578b8
skills: what an object holds, where compression lives, build.compress…
tomaszbk Nov 19, 2026
bc8404f
demo: documents its imports write again without a compressor
tomaszbk Nov 19, 2026
3b09f97
editor: a collaboration session carries the project
tomaszbk Nov 19, 2026
6df3b74
net: fixes from the review of the invitation key
tomaszbk Nov 19, 2026
cfcab84
editor: what the host changes during a session reaches the guests
tomaszbk Nov 19, 2026
bb41ee9
Merge branch 'store/integration' into store/codec-outside-hash
tomaszbk Nov 19, 2026
fc306f5
Merge branch 'store/integration' into editor/share
tomaszbk Nov 19, 2026
4f38a43
Merge branch 'store/codec-outside-hash' into store/integration
tomaszbk Nov 19, 2026
c1c7dd3
store: a sweep copies, of the copies of a chunk, one every build reads
tomaszbk Nov 19, 2026
340bf72
asset: object_put checks the hash of the file as it arrived
tomaszbk Nov 19, 2026
8e7063c
store: a frame a caller offers is decoded and checked before it is kept
tomaszbk Nov 19, 2026
366dc34
store: refs, leases and sweeps find a chunk in a frame of any codec
tomaszbk Nov 19, 2026
84e3183
textures: the block encoder counts only for textures of blocks
tomaszbk Nov 19, 2026
e67fd68
store: tests and invariants of the review of codecs
tomaszbk Nov 19, 2026
f7ae0e9
Merge remote-tracking branch 'origin/main' into store/integration
tomaszbk Nov 19, 2026
1cbd484
editor: the content browser shows the libraries of the other editors
tomaszbk Nov 19, 2026
85dc46f
Keep BC7 alpha exact at the root of the open encoder
tomaszbk Nov 19, 2026
48a9419
docs: keep a line of the content browser within 100 characters
tomaszbk Nov 19, 2026
a773a94
Encode with mode 6 a block its mode mask leaves without a mode
tomaszbk Nov 19, 2026
541e18a
Merge branch 'store/integration' into editor/share
tomaszbk Nov 19, 2026
c54cb47
Merge branch 'compressor/alpha-fixes' into store/integration
tomaszbk Nov 19, 2026
a2964ff
editor: libraries are roots of the content browser
tomaszbk Nov 19, 2026
939087e
Merge branch 'editor/share' into store/integration
tomaszbk Nov 19, 2026
0008584
tests: a broken column is a stream that does not decode, whatever wri…
tomaszbk Nov 19, 2026
d53481b
editor: library cards show thumbnails, streamed from the peer that ha…
tomaszbk Nov 19, 2026
2feb5c4
Merge branch 'editor/share' into store/integration
tomaszbk Nov 19, 2026
83c3350
editor: textures and materials have stored previews, made on any mach…
tomaszbk Nov 19, 2026
1d36405
Merge branch 'editor/share' into store/integration
tomaszbk Nov 19, 2026
b010c10
The tracked interfaces as the engine writes them, and the cave test a…
tomaszbk Nov 19, 2026
d84c859
Merge remote-tracking branch 'origin/main' into store/integration
tomaszbk Nov 19, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
47 changes: 33 additions & 14 deletions .agents/skills/mirai-agent-api/references/methods.md
Original file line number Diff line number Diff line change
Expand Up @@ -872,19 +872,30 @@ of an instance" are `-32602`; the rest, `-32000`
another asset (that of an imported prefab), is its owner.
- `asset.import`: what the Import button of the content browser does with any source it imports
([import](../../mirai-editor/references/panels.md#import)), wherever it is on disk: the
editor reads it and writes only in the assets folder. `folder` replaces the folder of its type; a
source that a plugin imports whole (a map) does not accept it. It imports, writing to disk (it
is an operation on files) while the editor goes on, and answers when it ends: whether it wrote
(`ok`), its message, the scene of a map and the assets it wrote (`kept`: its file was already
the one it gives). `asset.import_status` gives the same, and whether one runs (`importing`), at
any moment. While it runs, another import and whatever writes assets fail saying what is being
imported. Reimporting keeps ids and files, which the sidecar of the source lists
source stays where it is, its package goes to the store of the session and the project pins it,
listed in `folder` (else the root, or the folder of a source in the assets). It imports,
writing to disk (it is an operation on files) while the editor goes on, and answers when it
ends: whether it wrote (`ok`), its message, the scene of a map and the assets it wrote
(`kept`: its file was already the one it gives). `asset.import_status` gives the same, and
whether one runs (`importing`), at any moment. While it runs, another import and whatever
writes assets fail saying what is being imported. Reimporting keeps ids and files, which the
package of the source lists
([identity](../../mirai-imports/references/imports.md#identity-and-reimport)); over a document
that changed since it was imported it fails naming it, and `discard_changes` writes over it
([changed documents](../../mirai-imports/references/imports.md#changed-documents)).
of the project that changed since it was written it fails naming it, and `discard_changes`
writes over it ([changed documents](../../mirai-imports/references/imports.md#changed-documents)).
`image` (`color`, `data`, `normal`, `normal_green_down`) says what an image imported on
its own holds, over its settings and its name (a packed metallic-roughness or a mask is `data`); a
source in the project keeps the choice in its settings
- `packages.list {name?}`: the packages of the library of the machine (the store of the session)
with their assets (`name`, `kind`, `bytes`, `built`) and whether the project pins each (`pinned`,
`folder`). `packages.add {name, assets?, folder?}` pins one, by id or name, or some of its
assets by id, listed in `folder`, as carrying it from a library root of the content
browser; it runs as an import and answers as `asset.import`. An unknown package or asset, an
invalid folder or a session without a store fail saying how to fix it.
- `packages.peers {refresh?, seconds?}`: in a session, the libraries of the other editors, each
package with `bytes`, `built`, `here` and `pinned`; `listing` while they are read, `adding` for
the last package taken. `packages.peer_add {peer, name, folder?}` takes one into this machine's
library and adds it as `packages.add` does; one whose peer left says so in `adding.error`.
- `asset.detach`: `asset` (path or id) is a part that leaves its owner: it is left without `owner`
and shown alone; the import keeps writing it and leaves it out
([parts](../../mirai-imports/references/imports.md#parts)). It is an edit of its file, with undo;
Expand All @@ -898,14 +909,17 @@ of an instance" are `-32602`; the rest, `-32000`
`{id,path}`; an unknown type fails naming the valid ones, and a taken or invalid name says why.
- `asset.delete`: `asset` (path or id) goes to the system trash with the import parts it owns, like
Delete of the [content browser](../../mirai-editor/references/panels.md#content-browser): at
once, without undo. Returns `{moved,used_by}`; those that use it keep the
reference. Fails saying why with an asset of a plugin, of the engine or of the editor, a scene
open in a tab or outside Edit.
once, without undo; the root of a package also takes the package out of the project, and what
it listed leaves with it while the store keeps its blobs. Returns `{moved,used_by}`; those that
use it keep the reference. Fails saying why with another asset a package lists, an asset of a
plugin, of the engine or of the editor, a scene open in a tab or outside Edit.
- `asset.move {asset, folder?, name?, copy?}` takes an asset by path or id, or a folder by path,
and writes at once, without undo; it returns the resulting path and id
([rename, move and duplicate](../../mirai-editor/references/panels.md#content-browser)). No
`folder` keeps the one it is in and `/` is the root. Moving keeps the id and takes the parts
along; what is being edited fails asking to finish the edit. With `copy` it
along; the root of a package moves where the project lists it, keeping its name, and another
asset a package lists fails naming that root; what is being edited fails asking to finish the
edit. With `copy` it
copies with new ids and the copy is not an output of the import; without `name` it takes a free
one.
- `asset.users`: `asset` (path or id). Returns `{used_by}`, the files that reference it or a part
Expand Down Expand Up @@ -1125,7 +1139,12 @@ The methods read the source the editor has.
[Collaboration](../../mirai-editor/references/collaboration.md). In `peers` of `collab.status`,
`playing` says that editor is in a Play or Simulate of its own and `serving`, that it serves a
networked game; `unsent` lists the asset files changed in the session that the others do not have
because they are too large to travel. an invalid code is `-32602`.
because they are too large to travel. an invalid code is `-32602`. `collab.join` takes an optional
`folder` (the open project when empty) and returns at once; `join` of `collab.status` follows how
that folder is brought to the host's project, phase by phase, and lists after it what was kept,
not written and the packages no peer has a build of; `project`, the chunk bytes the session moved
and the peers that went bad; `offers` and `updates`, the new snapshots a host offered and a guest
took during the session.

## Project panels

Expand Down
25 changes: 22 additions & 3 deletions .agents/skills/mirai-assets/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,9 @@ types, scenes and their prefab instances, registry).
[container](references/formats.md#container), [typed tables](references/formats.md#typed-tables),
[asset types](references/formats.md#asset-types), [versions](references/formats.md#versions),
[registry](references/formats.md#registry) and [text](references/formats.md#text).
- The records of imports in the machine store (package and build manifests, `packages.mirai`
and the manifest files a root carries), their refs and `packages_resolve`:
[packages](references/formats.md#packages).
- The collection `compressor`, profiles, codecs, streams and decoders:
[compression](references/formats.md#compression).
- Streams, schemas, migration, paths, text: [serial](references/serial.md#stdserial).
Expand Down Expand Up @@ -108,9 +111,11 @@ types, scenes and their prefab instances, registry).
package: `compressor:data`, `compressor:texture` and, engine-time, `compressor:blocks`. The open
one (`std/compressor`) is a real implementation; the private one has the same packages and
declarations. Its sources are never versioned in the engine nor packaged.
- **What the repository of the engine versions is open**: its projects declare
`build.compression` `open`, and the assets of the engine and its plugins are always written
open. A project chooses for itself (`none`, `open`, or the best its engine has).
- **What is hashed and shared never depends on a compressor.** The documents of a project, the
assets of the engine and its plugins, imports and objects of the store are written with
`Codecs.None`: no stage of a compressor, each kind keeping the modeling of its data, chosen
without one. The store compresses where bytes rest and the exchange where they travel; only the
files a cook ships are compressed as the project's `build.compression` says.
- **A stream says what decodes it**: a read needs no profile nor codecs.
- **Decoders are preallocated.** A `Stream_Decoder` holds all the scratch, allocated once by
whoever reads; a decode never allocates, and for any input never reads outside `src` nor writes
Expand All @@ -131,6 +136,12 @@ types, scenes and their prefab instances, registry).
- **The header says Scene or Prefab.** One `.scene` extension and kind; `Header_Flag.Prefab` is
what whoever made the file chose, never guessed from its roots, and a prefab has exactly one root
([prefab](references/scenes.md#prefab)).
- **A package asset is an object of the store read by parts**, never a file opened by path: what
a load needs reads only its chunks, a part not here is `Not_Here` to its caller, and encoding
the same input twice gives the same object ([store](references/formats.md#container)).
- **A project pins the manifest of each package it uses, never a build**, and carries the text
of each manifest it pins; builds are found by key through refs, and resolving a list never
removes nor rebuilds ([packages](references/formats.md#packages)).
- **A guest mount never takes an id the registry has**: what the program shipped wins over what a
player adds ([guest mounts](references/formats.md#registry)).

Expand All @@ -157,7 +168,15 @@ types, scenes and their prefab instances, registry).
`a_scene_saved_with_another_layout_of_a_component_loads_it_by_field_names` of `engine/scene`;
- the document of a scene or a `.ui` from a file outside the assets (what `dump` and git
show): `the_commands_read_write_and_check_the_document_of_an_asset` of `cook/author`;
- records of packages: `package_records_read_back_what_they_write`,
`packages_resolve_lists_the_objects_of_what_a_project_uses`,
`package_records_refuse_hostile_text` and `a_root_carries_the_manifests_it_pins` of
`asset/packages_test.odin`;
- registry: `asset/registry_test.odin` and, in the editor, `editor/content_test.odin`;
- assets of the store: `every_kind_loads_equal_from_a_file_and_from_the_store`,
`the_small_levels_of_a_texture_load_before_the_large_ones_arrive`,
`a_chunk_stored_as_it_is_is_read_in_place` and `hostile_object_meta_and_groups_fail_the_asset`
of `asset/parts_test.odin`;
- layers of an imported material: `asset/kinds_test.odin`, and the overrides shared with prefabs
in the editor, `editor/prefabs_test.odin`;
- JSON inspection with transient fields: `std/serial/text_runtime_test.odin`.
Expand Down
7 changes: 3 additions & 4 deletions .agents/skills/mirai-assets/references/cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,10 +23,9 @@ subcommands with their usage.
of the engine), the one whose assets have its id. A file outside the assets (another version of
one, as git gives it) reads as the asset with its id. `unpack`, `pack` and `dump --schema`
refuse them.
- **`repack`** writes each file again compressed as the project that holds it saves
(`build.compression`), or open outside a project; a texture with its blocks as they are. A file
that already is so stays untouched: what a project that changes its compression runs over its
assets.
- **`repack`** writes each file again as a project keeps it, without a stage of a compressor
(`Codecs.None`); a texture with its blocks as they are. A file that already is so stays
untouched: what a project runs over the files of its assets a compressor wrote.
- **`verify`** checks container, hash, decompression, schema and tables, that the stored
dependencies are the derived ones and that each value meets its schema. For the engine's types it
checks their version (for one the build does not read, the reason is `version_message`, with the
Expand Down
Loading
Loading