| Filename | Latest commit message | Latest commit date |
|---|---|---|
Soul pass 2 findings S1, S2, S3, S4. - Enabling the sink is the drain's EnableAsync: every intent already in the store gets an "expired" receipt and the enable marker is written, all in one flush. No decision compares StoredAt with a clock any more, so a fast writer clock and the Rust daemon's secs.nanosZ stamps stop mattering. - The operator's EditorPrefs hold a token, and the sink runs only while the store carries the marker with that token. A re-clone or a copied .brokkr has no such marker, so a stale "enabled" authorizes nothing and the editor drops it. The epoch and agentCommandsEnabledAt (host snapshot key 19) are gone. - Selection is one pass over the store per tick (Pending), not a copy and sort per intent. - Receipts are capped at the newest 1000, pruned 128 pairs per tick with the intent deleted before its receipt. - A marker that could not be written is withdrawn, so the intent reads as never started and is retried, not "interrupted". - The drain writes through IBrokkrCommandStore; puts stage and one flush makes them durable. - The CLI timeout text no longer says the intent "stays written" without the expiry caveat; the check-then-write window on --command-id is documented. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> |
||
| .. | ||
| Packages/com.gamecult.brokkr | ||
| README.md | ||
Brokkr Unity Adapter
This package lets the Unity Editor publish its scene, component, asset, command, receipt, Quest, and Eve/CultUI state as typed CultCache documents synced through CultMesh.
Install By Local Path
Add this package to a Unity project's Packages/manifest.json:
"com.gamecult.brokkr": "file:F:/Projects/Brokkr/surfaces/unity/Packages/com.gamecult.brokkr"
The package ships no assemblies. Its CultCache, CultNet and CultMesh runtime
comes from org.gamecult.cultlib, which the host manifest must also resolve:
"org.gamecult.cultlib": "https://github.com/GameCult/CultLib.git?path=/unity/org.gamecult.cultlib#cultlib-unity-v1.0.60"
Then open GameCult > Brokkr.
Local Smoke
In Unity:
- Open
GameCult > Brokkr. - Confirm
Broker URIiscultmesh://brokkr. - Confirm
CultMesh Cachepoints at.brokkr/unity-editor.ccmp. - Click
Start CultMesh Mirror. - Click
Capture Snapshot. - Click
Publish Mirror. - To create a ScriptableObject through the mirror (tick
Agent Commandsfirst, and addcreateScriptableObjecttoAllowed Actions), fillScriptableObject Type,Asset Name, andAsset Path, then clickCreate ScriptableObject Asset. - To instantiate or variant a prefab through the mirror, fill
Prefab Asset Path, optionalInstance Name, and optionalVariant Path, then click the matching prefab command. - To publish object sync policy, select a GameObject, set the object lane
toggles including transform, parent, active state, material, and property
lanes, then click
Publish Object Sync. - With the mirror running, run
brokkr-daemon sync-onceorsync-loop; the window shows the latest daemon sync pass receipt. - To publish an ad hoc sync variable, fill
Ad Hoc Sync Varwith a binding id or leave it blank for a generated id, set kind/paths/authority/interpolation, then clickPublish Sync Var.
The Unity adapter writes the latest editor snapshot to:
unity/host/current
Brokkr daemon sync receipts are read from:
sync/receipts/{receiptId}
Ad hoc sync variables are written to:
sync/vars/{syncVarId}
Verse-side command clients write brokkr.unity.command_intent.v0 documents to:
unity/commands/{commandId}
The editor service pulls the store about once a second while Agent Commands is on, admits each intent through the project policy, mutates the editor, and publishes receipts
to:
unity/receipts/{commandId}
Recognized Unity asset commands include:
instantiatePrefabcreatePrefabVariantcreateScriptableObject
The Unity plugin is still an adapter. Unity owns Unity editor truth; Brokkr owns provider discovery; CultCache and CultMesh own the live mirror lane.
Agent Commands
The editor executes intents that other processes write into .brokkr/ only
while Agent Commands is ticked in the Brokkr window. It is off for every
project until you tick it, and the host snapshot reports the flag. Nothing
listens on the network: callers reach the editor through the directory store
at .brokkr/unity-editor.ccmp.
Allowed Actions lists what an agent may run. The default allows scene
mutation and editor lifecycle; createScriptableObject, createPrefabVariant
and saveScene are off until you add them. A refused intent gets a receipt
with status: denied. Captures land under .brokkr/captures/.
From a shell, with the project's cache path:
dotnet run --project F:/Projects/Brokkr/brokkr-command/Brokkr.Command.csproj -- --unity-cache <project>/.brokkr/unity-editor.ccmp --action readHost
dotnet run --project F:/Projects/Brokkr/brokkr-command/Brokkr.Command.csproj -- --unity-cache <project>/.brokkr/unity-editor.ccmp --action createGameObject --name Marker
An intent stored before the flag was last turned on never runs: it gets a
receipt with status: expired, so turning the sink on cannot execute anything
you did not see. The host snapshot's agentCommandsEnabledAt is that instant.
Before the editor runs an intent it writes a receipt with status: attempted.
If the editor stops, or cannot record the result, that intent is reported as
interrupted and is not run again; check the project and send a new intent if
it should run. One editor tick handles at most 16 intents, expired and denied
ones included; the rest wait for the next tick. Receipts are never pruned.
brokkr-command exits 0 when the receipt is accepted, 1 for any other
receipt status (failed, denied, expired, interrupted), and 2 for bad
usage, a timeout, a store that cannot be opened, or any other failure. A
--command-id that already has a receipt is refused with exit 2.