Initial Brokkr scaffold
This commit is contained in:
Meta Vens
commit
16adc98447
16 changed files with 675 additions and 0 deletions
15
.gitignore
vendored
Normal file
15
.gitignore
vendored
Normal file
|
|
@ -0,0 +1,15 @@
|
||||||
|
target/
|
||||||
|
.brokkr/
|
||||||
|
.brokkr-smoke/
|
||||||
|
*.user
|
||||||
|
*.suo
|
||||||
|
Library/
|
||||||
|
Temp/
|
||||||
|
Obj/
|
||||||
|
Build/
|
||||||
|
Builds/
|
||||||
|
Logs/
|
||||||
|
UserSettings/
|
||||||
|
__pycache__/
|
||||||
|
*.pyc
|
||||||
|
|
||||||
114
Cargo.lock
generated
Normal file
114
Cargo.lock
generated
Normal file
|
|
@ -0,0 +1,114 @@
|
||||||
|
# This file is automatically @generated by Cargo.
|
||||||
|
# It is not intended for manual editing.
|
||||||
|
version = 4
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "anyhow"
|
||||||
|
version = "1.0.102"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "7f202df86484c868dbad7eaa557ef785d5c66295e41b460ef922eca0723b842c"
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "brokkr-daemon"
|
||||||
|
version = "0.1.0"
|
||||||
|
dependencies = [
|
||||||
|
"anyhow",
|
||||||
|
"serde",
|
||||||
|
"serde_json",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "itoa"
|
||||||
|
version = "1.0.18"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "8f42a60cbdf9a97f5d2305f08a87dc4e09308d1276d28c869c684d7777685682"
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "memchr"
|
||||||
|
version = "2.8.2"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "88904434abc2901f197fe8cc55f0445e7ded921dba5911dad2e2b39b48e663c4"
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "proc-macro2"
|
||||||
|
version = "1.0.106"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "8fd00f0bb2e90d81d1044c2b32617f68fcb9fa3bb7640c23e9c748e53fb30934"
|
||||||
|
dependencies = [
|
||||||
|
"unicode-ident",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "quote"
|
||||||
|
version = "1.0.45"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "41f2619966050689382d2b44f664f4bc593e129785a36d6ee376ddf37259b924"
|
||||||
|
dependencies = [
|
||||||
|
"proc-macro2",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "serde"
|
||||||
|
version = "1.0.228"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "9a8e94ea7f378bd32cbbd37198a4a91436180c5bb472411e48b5ec2e2124ae9e"
|
||||||
|
dependencies = [
|
||||||
|
"serde_core",
|
||||||
|
"serde_derive",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "serde_core"
|
||||||
|
version = "1.0.228"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "41d385c7d4ca58e59fc732af25c3983b67ac852c1a25000afe1175de458b67ad"
|
||||||
|
dependencies = [
|
||||||
|
"serde_derive",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "serde_derive"
|
||||||
|
version = "1.0.228"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "d540f220d3187173da220f885ab66608367b6574e925011a9353e4badda91d79"
|
||||||
|
dependencies = [
|
||||||
|
"proc-macro2",
|
||||||
|
"quote",
|
||||||
|
"syn",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "serde_json"
|
||||||
|
version = "1.0.150"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "e8014e44b4736ed0538adeecded0fce2a272f22dc9578a7eb6b2d9993c74cfb9"
|
||||||
|
dependencies = [
|
||||||
|
"itoa",
|
||||||
|
"memchr",
|
||||||
|
"serde",
|
||||||
|
"serde_core",
|
||||||
|
"zmij",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "syn"
|
||||||
|
version = "2.0.117"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "e665b8803e7b1d2a727f4023456bbbbe74da67099c585258af0ad9c5013b9b99"
|
||||||
|
dependencies = [
|
||||||
|
"proc-macro2",
|
||||||
|
"quote",
|
||||||
|
"unicode-ident",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "unicode-ident"
|
||||||
|
version = "1.0.24"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "zmij"
|
||||||
|
version = "1.0.21"
|
||||||
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
|
checksum = "b8848ee67ecc8aedbaf3e4122217aff892639231befc6a1b58d29fff4c2cabaa"
|
||||||
6
Cargo.toml
Normal file
6
Cargo.toml
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
[workspace]
|
||||||
|
resolver = "2"
|
||||||
|
members = [
|
||||||
|
"brokkr-daemon"
|
||||||
|
]
|
||||||
|
|
||||||
44
README.md
Normal file
44
README.md
Normal file
|
|
@ -0,0 +1,44 @@
|
||||||
|
# Brokkr
|
||||||
|
|
||||||
|
Brokkr is the GameCult creative-tool broker daemon: a CultMesh service that lets
|
||||||
|
Unity, Blender, and future editor runtimes expose their live authoring surfaces
|
||||||
|
to the Verse without pretending those runtimes are the same machine.
|
||||||
|
|
||||||
|
The name earns its keep twice. Brokkr is the dwarf at the forge bellows in the
|
||||||
|
Eddic treasure contest, holding the work steady while the artifact takes shape.
|
||||||
|
Brokkr is also the broker: the daemon that routes typed editor observations,
|
||||||
|
capabilities, commands, and Eve/CultUI surfaces between tool runtimes and the
|
||||||
|
Verse.
|
||||||
|
|
||||||
|
## Authority
|
||||||
|
|
||||||
|
- Brokkr owns the broker contract, provider advertisement, routing policy, and
|
||||||
|
typed command receipts.
|
||||||
|
- Unity owns Unity editor truth: scenes, assets, selection, play mode, imports,
|
||||||
|
build settings, and editor-side side effects.
|
||||||
|
- Blender owns Blender editor truth: scenes, objects, assets, operators, add-ons,
|
||||||
|
render settings, and editor-side side effects.
|
||||||
|
- Eve owns rendering of Brokkr surfaces.
|
||||||
|
- Odin owns discovery of Brokkr as a Verse provider.
|
||||||
|
- CultCache owns durable `.cc` witnesses and command receipts.
|
||||||
|
|
||||||
|
Plugins are adapters. They do not own Verse state. They connect their host editor
|
||||||
|
to Brokkr, publish editor observations, and execute admitted commands from the
|
||||||
|
broker.
|
||||||
|
|
||||||
|
## Surfaces
|
||||||
|
|
||||||
|
- `surfaces/unity/Packages/com.gamecult.brokkr`: Unity editor package scaffold.
|
||||||
|
- `surfaces/blender/brokkr_bridge`: Blender add-on scaffold.
|
||||||
|
- `brokkr-daemon`: Rust daemon skeleton that emits Brokkr's provider
|
||||||
|
advertisement and command policy.
|
||||||
|
|
||||||
|
## First Smoke
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
cargo run -p brokkr-daemon -- provider
|
||||||
|
```
|
||||||
|
|
||||||
|
The first smoke prints the typed provider advertisement. That is deliberately
|
||||||
|
small: discovery shape first, live sockets second.
|
||||||
|
|
||||||
11
brokkr-daemon/Cargo.toml
Normal file
11
brokkr-daemon/Cargo.toml
Normal file
|
|
@ -0,0 +1,11 @@
|
||||||
|
[package]
|
||||||
|
name = "brokkr-daemon"
|
||||||
|
version = "0.1.0"
|
||||||
|
edition = "2024"
|
||||||
|
publish = false
|
||||||
|
|
||||||
|
[dependencies]
|
||||||
|
anyhow = "1"
|
||||||
|
serde = { version = "1", features = ["derive"] }
|
||||||
|
serde_json = "1"
|
||||||
|
|
||||||
170
brokkr-daemon/src/main.rs
Normal file
170
brokkr-daemon/src/main.rs
Normal file
|
|
@ -0,0 +1,170 @@
|
||||||
|
use anyhow::Result;
|
||||||
|
use serde::Serialize;
|
||||||
|
|
||||||
|
const PROVIDER_SCHEMA: &str = "gamecult.brokkr.provider_advertisement.v0";
|
||||||
|
const PROVIDER_ID: &str = "brokkr.creative_tool_broker";
|
||||||
|
const CULTMESH_BASE_URI: &str = "cultmesh://brokkr";
|
||||||
|
|
||||||
|
#[derive(Debug, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
struct ProviderAdvertisement {
|
||||||
|
schema: &'static str,
|
||||||
|
provider: ProviderIdentity,
|
||||||
|
authority: Authority,
|
||||||
|
transports: Vec<Transport>,
|
||||||
|
tool_surfaces: Vec<ToolSurface>,
|
||||||
|
eve_surfaces: Vec<EveSurface>,
|
||||||
|
command_policy: CommandPolicy,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
struct ProviderIdentity {
|
||||||
|
id: &'static str,
|
||||||
|
title: &'static str,
|
||||||
|
description: &'static str,
|
||||||
|
version: &'static str,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
struct Authority {
|
||||||
|
owner: &'static str,
|
||||||
|
role: &'static str,
|
||||||
|
state_owner: &'static str,
|
||||||
|
presentation_owner: &'static str,
|
||||||
|
discovery_owner: &'static str,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
struct Transport {
|
||||||
|
kind: &'static str,
|
||||||
|
base_uri: &'static str,
|
||||||
|
status: &'static str,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
struct ToolSurface {
|
||||||
|
id: &'static str,
|
||||||
|
title: &'static str,
|
||||||
|
tool_kind: &'static str,
|
||||||
|
adapter: &'static str,
|
||||||
|
capabilities: Vec<&'static str>,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
struct EveSurface {
|
||||||
|
id: &'static str,
|
||||||
|
title: &'static str,
|
||||||
|
cult_mesh_uri: &'static str,
|
||||||
|
schema: &'static str,
|
||||||
|
}
|
||||||
|
|
||||||
|
#[derive(Debug, Serialize)]
|
||||||
|
#[serde(rename_all = "camelCase")]
|
||||||
|
struct CommandPolicy {
|
||||||
|
mode: &'static str,
|
||||||
|
envelope_schema: &'static str,
|
||||||
|
receipt_schema: &'static str,
|
||||||
|
notes: Vec<&'static str>,
|
||||||
|
}
|
||||||
|
|
||||||
|
fn main() -> Result<()> {
|
||||||
|
let command = std::env::args()
|
||||||
|
.nth(1)
|
||||||
|
.unwrap_or_else(|| "provider".to_string());
|
||||||
|
|
||||||
|
match command.as_str() {
|
||||||
|
"provider" => print_provider(),
|
||||||
|
"smoke" => print_provider(),
|
||||||
|
_ => {
|
||||||
|
eprintln!("usage: brokkr-daemon [provider|smoke]");
|
||||||
|
std::process::exit(2);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn print_provider() -> Result<()> {
|
||||||
|
let advertisement = build_provider_advertisement();
|
||||||
|
println!("{}", serde_json::to_string_pretty(&advertisement)?);
|
||||||
|
Ok(())
|
||||||
|
}
|
||||||
|
|
||||||
|
fn build_provider_advertisement() -> ProviderAdvertisement {
|
||||||
|
ProviderAdvertisement {
|
||||||
|
schema: PROVIDER_SCHEMA,
|
||||||
|
provider: ProviderIdentity {
|
||||||
|
id: PROVIDER_ID,
|
||||||
|
title: "Brokkr",
|
||||||
|
description: "GameCult creative-tool broker for Unity, Blender, and future editor runtimes.",
|
||||||
|
version: env!("CARGO_PKG_VERSION"),
|
||||||
|
},
|
||||||
|
authority: Authority {
|
||||||
|
owner: "Brokkr",
|
||||||
|
role: "CultMesh broker for creative editor observations, command admission, receipts, and Eve/CultUI projection.",
|
||||||
|
state_owner: "Brokkr typed CultCache witnesses; host editors own host-local scene and asset truth.",
|
||||||
|
presentation_owner: "Eve/CultUI lowers Brokkr surfaces without owning editor truth.",
|
||||||
|
discovery_owner: "Odin discovers Brokkr through CultMesh provider advertisements.",
|
||||||
|
},
|
||||||
|
transports: vec![Transport {
|
||||||
|
kind: "cultmesh",
|
||||||
|
base_uri: CULTMESH_BASE_URI,
|
||||||
|
status: "scaffold",
|
||||||
|
}],
|
||||||
|
tool_surfaces: vec![
|
||||||
|
ToolSurface {
|
||||||
|
id: "brokkr.unity_editor",
|
||||||
|
title: "Unity Editor",
|
||||||
|
tool_kind: "unity-editor",
|
||||||
|
adapter: "surfaces/unity/Packages/com.gamecult.brokkr",
|
||||||
|
capabilities: shared_capabilities(),
|
||||||
|
},
|
||||||
|
ToolSurface {
|
||||||
|
id: "brokkr.blender_editor",
|
||||||
|
title: "Blender Editor",
|
||||||
|
tool_kind: "blender-editor",
|
||||||
|
adapter: "surfaces/blender/brokkr_bridge",
|
||||||
|
capabilities: shared_capabilities(),
|
||||||
|
},
|
||||||
|
],
|
||||||
|
eve_surfaces: vec![
|
||||||
|
EveSurface {
|
||||||
|
id: "brokkr.eve.tool_broker.v0",
|
||||||
|
title: "Creative Tool Broker",
|
||||||
|
cult_mesh_uri: "cultmesh://brokkr/eve/tool-broker",
|
||||||
|
schema: "gamecult.eve.surface.v1",
|
||||||
|
},
|
||||||
|
EveSurface {
|
||||||
|
id: "brokkr.eve.command_receipts.v0",
|
||||||
|
title: "Command Receipts",
|
||||||
|
cult_mesh_uri: "cultmesh://brokkr/eve/command-receipts",
|
||||||
|
schema: "gamecult.eve.surface.v1",
|
||||||
|
},
|
||||||
|
],
|
||||||
|
command_policy: CommandPolicy {
|
||||||
|
mode: "policy-gated",
|
||||||
|
envelope_schema: "gamecult.brokkr.command_request.v0",
|
||||||
|
receipt_schema: "gamecult.brokkr.command_receipt.v0",
|
||||||
|
notes: vec![
|
||||||
|
"Plugins are adapters and do not own Verse provider truth.",
|
||||||
|
"All host mutations must produce command receipts.",
|
||||||
|
"Unity and Blender commands share one envelope shape.",
|
||||||
|
],
|
||||||
|
},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
fn shared_capabilities() -> Vec<&'static str> {
|
||||||
|
vec![
|
||||||
|
"host.status.read",
|
||||||
|
"scene.tree.read",
|
||||||
|
"selection.read",
|
||||||
|
"asset.catalog.read",
|
||||||
|
"command.palette.read",
|
||||||
|
"command.execute",
|
||||||
|
"receipt.read",
|
||||||
|
]
|
||||||
|
}
|
||||||
86
docs/architecture.md
Normal file
86
docs/architecture.md
Normal file
|
|
@ -0,0 +1,86 @@
|
||||||
|
# Brokkr Architecture
|
||||||
|
|
||||||
|
## Objective
|
||||||
|
|
||||||
|
Expose creative editor runtimes to the Verse through one coherent CultMesh broker
|
||||||
|
daemon, beginning with Unity and Blender plugin surfaces.
|
||||||
|
|
||||||
|
## Current Mechanism
|
||||||
|
|
||||||
|
Brokkr starts as a Rust daemon skeleton that can emit a provider advertisement.
|
||||||
|
Unity and Blender each have a thin plugin scaffold with host-local metadata and
|
||||||
|
connection settings. The live transport is intentionally not claimed yet; the
|
||||||
|
first contract establishes owner, inputs, outputs, command policy, and surface
|
||||||
|
names.
|
||||||
|
|
||||||
|
## Invariants
|
||||||
|
|
||||||
|
- Editor hosts keep editor truth. Brokkr never becomes the canonical scene,
|
||||||
|
asset, object, import, or build database.
|
||||||
|
- Brokkr owns Verse-facing broker identity, command admission, routing receipts,
|
||||||
|
and durable witness publication.
|
||||||
|
- Unity and Blender commands share the same command envelope and receipt shape.
|
||||||
|
- Eve/CultUI surfaces are projections over Brokkr/provider state and host
|
||||||
|
observations, not separate dashboards with their own truth.
|
||||||
|
- JSON is tolerated only as a schema/debug/export boundary. Durable state should
|
||||||
|
become CultCache `.cc` witnesses as the runtime grows.
|
||||||
|
|
||||||
|
## Intended Change
|
||||||
|
|
||||||
|
The Unity idea is widened into a general creative-tool broker: Unity and Blender
|
||||||
|
are peers behind one broker contract. Tool-specific plugins stay boring and
|
||||||
|
replaceable. Brokkr becomes the stable Verse organ.
|
||||||
|
|
||||||
|
## Cut Line
|
||||||
|
|
||||||
|
Do not build separate Unity and Blender Verse providers unless a future invariant
|
||||||
|
proves they need independent authority. Do not give plugins their own discovery
|
||||||
|
truth, command policy, or dashboard summaries. They delegate to Brokkr.
|
||||||
|
|
||||||
|
## Owner Map
|
||||||
|
|
||||||
|
Owner: Brokkr owns tool-to-Verse brokerage.
|
||||||
|
|
||||||
|
Inputs:
|
||||||
|
|
||||||
|
- Host observations from Unity and Blender plugins.
|
||||||
|
- Operator commands admitted through Brokkr's command policy.
|
||||||
|
- Odin discovery queries.
|
||||||
|
- Eve/CultUI surface requests.
|
||||||
|
- CultCache witness stores.
|
||||||
|
|
||||||
|
Outputs:
|
||||||
|
|
||||||
|
- `gamecult.brokkr.provider_advertisement.v0`
|
||||||
|
- `gamecult.brokkr.tool_host_snapshot.v0`
|
||||||
|
- `gamecult.brokkr.command_request.v0`
|
||||||
|
- `gamecult.brokkr.command_receipt.v0`
|
||||||
|
- Eve/CultUI surface documents for host status, selection, assets, scene/object
|
||||||
|
trees, command palette, and receipt history.
|
||||||
|
|
||||||
|
Derived State:
|
||||||
|
|
||||||
|
- Unity package settings are adapter configuration, not Verse authority.
|
||||||
|
- Blender add-on preferences are adapter configuration, not Verse authority.
|
||||||
|
- Editor selection and scene summaries are observations until command receipts
|
||||||
|
confirm an accepted mutation.
|
||||||
|
|
||||||
|
Forbidden Writers:
|
||||||
|
|
||||||
|
- Unity editor callbacks cannot write Verse provider truth directly.
|
||||||
|
- Blender operators cannot write Verse provider truth directly.
|
||||||
|
- Eve renderers cannot admit commands directly to editor hosts.
|
||||||
|
- Odin discovery records cannot decide command permissions.
|
||||||
|
|
||||||
|
Shared Paths:
|
||||||
|
|
||||||
|
- Unity commands, Blender commands, programmatic commands, UI-triggered commands,
|
||||||
|
and replayed command receipts must use the same command envelope.
|
||||||
|
- Host snapshots from all tools must carry host id, tool kind, project path,
|
||||||
|
observed-at timestamp, capabilities, and authority owner.
|
||||||
|
|
||||||
|
Deletion Line:
|
||||||
|
|
||||||
|
If a plugin grows its own command policy, provider advertisement, or durable
|
||||||
|
state ledger, cut it back into an adapter and move the authority into Brokkr.
|
||||||
|
|
||||||
27
docs/provider-contract.md
Normal file
27
docs/provider-contract.md
Normal file
|
|
@ -0,0 +1,27 @@
|
||||||
|
# Brokkr Provider Contract
|
||||||
|
|
||||||
|
Provider id: `brokkr.creative_tool_broker`
|
||||||
|
|
||||||
|
CultMesh base URI: `cultmesh://brokkr`
|
||||||
|
|
||||||
|
Primary Eve surface id: `brokkr.eve.tool_broker.v0`
|
||||||
|
|
||||||
|
## Tool Kinds
|
||||||
|
|
||||||
|
- `unity-editor`
|
||||||
|
- `blender-editor`
|
||||||
|
|
||||||
|
## Capability Families
|
||||||
|
|
||||||
|
- `host.status.read`
|
||||||
|
- `scene.tree.read`
|
||||||
|
- `selection.read`
|
||||||
|
- `asset.catalog.read`
|
||||||
|
- `command.palette.read`
|
||||||
|
- `command.execute`
|
||||||
|
- `receipt.read`
|
||||||
|
|
||||||
|
The scaffold advertises command execution as policy-gated. No host command
|
||||||
|
should execute unless the host plugin recognizes the command family and Brokkr
|
||||||
|
has issued a command request with a receipt id.
|
||||||
|
|
||||||
17
schemas/brokkr-provider-advertisement.v0.schema.json
Normal file
17
schemas/brokkr-provider-advertisement.v0.schema.json
Normal file
|
|
@ -0,0 +1,17 @@
|
||||||
|
{
|
||||||
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||||
|
"$id": "gamecult.brokkr.provider_advertisement.v0",
|
||||||
|
"title": "Brokkr Provider Advertisement",
|
||||||
|
"type": "object",
|
||||||
|
"required": ["schema", "provider", "authority", "transports", "toolSurfaces", "eveSurfaces", "commandPolicy"],
|
||||||
|
"properties": {
|
||||||
|
"schema": { "const": "gamecult.brokkr.provider_advertisement.v0" },
|
||||||
|
"provider": { "type": "object" },
|
||||||
|
"authority": { "type": "object" },
|
||||||
|
"transports": { "type": "array" },
|
||||||
|
"toolSurfaces": { "type": "array" },
|
||||||
|
"eveSurfaces": { "type": "array" },
|
||||||
|
"commandPolicy": { "type": "object" }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
80
surfaces/blender/brokkr_bridge/__init__.py
Normal file
80
surfaces/blender/brokkr_bridge/__init__.py
Normal file
|
|
@ -0,0 +1,80 @@
|
||||||
|
bl_info = {
|
||||||
|
"name": "Brokkr",
|
||||||
|
"author": "GameCult",
|
||||||
|
"version": (0, 1, 0),
|
||||||
|
"blender": (4, 0, 0),
|
||||||
|
"location": "View3D > Sidebar > Brokkr",
|
||||||
|
"description": "Blender adapter for the Brokkr CultMesh creative-tool broker.",
|
||||||
|
"category": "System",
|
||||||
|
}
|
||||||
|
|
||||||
|
import bpy
|
||||||
|
|
||||||
|
PROVIDER_ID = "brokkr.blender_editor"
|
||||||
|
TOOL_KIND = "blender-editor"
|
||||||
|
DEFAULT_BROKER_URI = "cultmesh://brokkr"
|
||||||
|
|
||||||
|
|
||||||
|
class BrokkrPreferences(bpy.types.AddonPreferences):
|
||||||
|
bl_idname = __name__
|
||||||
|
|
||||||
|
broker_uri: bpy.props.StringProperty(
|
||||||
|
name="Broker URI",
|
||||||
|
default=DEFAULT_BROKER_URI,
|
||||||
|
description="CultMesh broker URI for Brokkr",
|
||||||
|
)
|
||||||
|
|
||||||
|
def draw(self, context):
|
||||||
|
layout = self.layout
|
||||||
|
layout.prop(self, "broker_uri")
|
||||||
|
|
||||||
|
|
||||||
|
class BROKKR_PT_status(bpy.types.Panel):
|
||||||
|
bl_label = "Brokkr"
|
||||||
|
bl_idname = "BROKKR_PT_status"
|
||||||
|
bl_space_type = "VIEW_3D"
|
||||||
|
bl_region_type = "UI"
|
||||||
|
bl_category = "Brokkr"
|
||||||
|
|
||||||
|
def draw(self, context):
|
||||||
|
layout = self.layout
|
||||||
|
prefs = context.preferences.addons[__name__].preferences
|
||||||
|
layout.label(text=f"Provider: {PROVIDER_ID}")
|
||||||
|
layout.label(text=f"Tool Kind: {TOOL_KIND}")
|
||||||
|
layout.label(text=f"Broker: {prefs.broker_uri}")
|
||||||
|
layout.operator("brokkr.capture_snapshot")
|
||||||
|
|
||||||
|
|
||||||
|
class BROKKR_OT_capture_snapshot(bpy.types.Operator):
|
||||||
|
bl_idname = "brokkr.capture_snapshot"
|
||||||
|
bl_label = "Capture Host Snapshot"
|
||||||
|
bl_description = "Scaffold command: report the current Blender host snapshot to the console"
|
||||||
|
|
||||||
|
def execute(self, context):
|
||||||
|
snapshot = {
|
||||||
|
"schema": "gamecult.brokkr.tool_host_snapshot.v0",
|
||||||
|
"providerId": PROVIDER_ID,
|
||||||
|
"toolKind": TOOL_KIND,
|
||||||
|
"projectPath": bpy.data.filepath,
|
||||||
|
"scene": context.scene.name if context.scene else "",
|
||||||
|
}
|
||||||
|
print(f"Brokkr snapshot scaffold: {snapshot}")
|
||||||
|
return {"FINISHED"}
|
||||||
|
|
||||||
|
|
||||||
|
classes = (
|
||||||
|
BrokkrPreferences,
|
||||||
|
BROKKR_PT_status,
|
||||||
|
BROKKR_OT_capture_snapshot,
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def register():
|
||||||
|
for cls in classes:
|
||||||
|
bpy.utils.register_class(cls)
|
||||||
|
|
||||||
|
|
||||||
|
def unregister():
|
||||||
|
for cls in reversed(classes):
|
||||||
|
bpy.utils.unregister_class(cls)
|
||||||
|
|
||||||
10
surfaces/blender/docs/install.md
Normal file
10
surfaces/blender/docs/install.md
Normal file
|
|
@ -0,0 +1,10 @@
|
||||||
|
# Blender Add-on Scaffold
|
||||||
|
|
||||||
|
Install `surfaces/blender/brokkr_bridge` as a Blender add-on directory during
|
||||||
|
local development.
|
||||||
|
|
||||||
|
The scaffold adds a Brokkr panel to the 3D View sidebar. It does not open a live
|
||||||
|
transport yet. Its first job is to preserve the adapter boundary: Blender emits
|
||||||
|
host snapshots and executes admitted Brokkr commands; Brokkr owns Verse-facing
|
||||||
|
broker state and receipts.
|
||||||
|
|
||||||
|
|
@ -0,0 +1,18 @@
|
||||||
|
using UnityEditor;
|
||||||
|
|
||||||
|
namespace GameCult.Brokkr.Editor
|
||||||
|
{
|
||||||
|
internal static class BrokkrSettings
|
||||||
|
{
|
||||||
|
internal const string ProviderId = "brokkr.unity_editor";
|
||||||
|
internal const string ToolKind = "unity-editor";
|
||||||
|
internal const string DefaultBrokerUri = "cultmesh://brokkr";
|
||||||
|
|
||||||
|
internal static string BrokerUri
|
||||||
|
{
|
||||||
|
get => EditorPrefs.GetString("GameCult.Brokkr.BrokerUri", DefaultBrokerUri);
|
||||||
|
set => EditorPrefs.SetString("GameCult.Brokkr.BrokerUri", value);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
@ -0,0 +1,39 @@
|
||||||
|
using UnityEditor;
|
||||||
|
using UnityEngine;
|
||||||
|
|
||||||
|
namespace GameCult.Brokkr.Editor
|
||||||
|
{
|
||||||
|
public sealed class BrokkrWindow : EditorWindow
|
||||||
|
{
|
||||||
|
private string brokerUri = BrokkrSettings.DefaultBrokerUri;
|
||||||
|
|
||||||
|
[MenuItem("GameCult/Brokkr")]
|
||||||
|
public static void Open()
|
||||||
|
{
|
||||||
|
GetWindow<BrokkrWindow>("Brokkr");
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnEnable()
|
||||||
|
{
|
||||||
|
brokerUri = BrokkrSettings.BrokerUri;
|
||||||
|
}
|
||||||
|
|
||||||
|
private void OnGUI()
|
||||||
|
{
|
||||||
|
EditorGUILayout.LabelField("Provider", BrokkrSettings.ProviderId);
|
||||||
|
EditorGUILayout.LabelField("Tool Kind", BrokkrSettings.ToolKind);
|
||||||
|
brokerUri = EditorGUILayout.TextField("Broker URI", brokerUri);
|
||||||
|
|
||||||
|
if (GUILayout.Button("Save Settings"))
|
||||||
|
{
|
||||||
|
BrokkrSettings.BrokerUri = brokerUri;
|
||||||
|
}
|
||||||
|
|
||||||
|
EditorGUILayout.Space();
|
||||||
|
EditorGUILayout.HelpBox(
|
||||||
|
"Scaffold only: this adapter should publish Unity editor observations to Brokkr and execute admitted broker commands with receipts.",
|
||||||
|
MessageType.Info);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
|
@ -0,0 +1,15 @@
|
||||||
|
using System;
|
||||||
|
|
||||||
|
namespace GameCult.Brokkr
|
||||||
|
{
|
||||||
|
[Serializable]
|
||||||
|
public sealed class BrokkrHostSnapshot
|
||||||
|
{
|
||||||
|
public string schema = "gamecult.brokkr.tool_host_snapshot.v0";
|
||||||
|
public string providerId = "brokkr.unity_editor";
|
||||||
|
public string toolKind = "unity-editor";
|
||||||
|
public string projectPath = "";
|
||||||
|
public string observedAt = "";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
11
surfaces/unity/Packages/com.gamecult.brokkr/package.json
Normal file
11
surfaces/unity/Packages/com.gamecult.brokkr/package.json
Normal file
|
|
@ -0,0 +1,11 @@
|
||||||
|
{
|
||||||
|
"name": "com.gamecult.brokkr",
|
||||||
|
"version": "0.1.0",
|
||||||
|
"displayName": "Brokkr",
|
||||||
|
"description": "Unity Editor adapter for the Brokkr CultMesh creative-tool broker.",
|
||||||
|
"unity": "2022.3",
|
||||||
|
"author": {
|
||||||
|
"name": "GameCult"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
12
tools/check.ps1
Normal file
12
tools/check.ps1
Normal file
|
|
@ -0,0 +1,12 @@
|
||||||
|
$ErrorActionPreference = "Stop"
|
||||||
|
|
||||||
|
Push-Location (Split-Path -Parent $PSScriptRoot)
|
||||||
|
try {
|
||||||
|
cargo fmt --check
|
||||||
|
cargo test --workspace
|
||||||
|
cargo run -p brokkr-daemon -- provider | Out-Null
|
||||||
|
}
|
||||||
|
finally {
|
||||||
|
Pop-Location
|
||||||
|
}
|
||||||
|
|
||||||
Loading…
Reference in a new issue