Skip to content
Merged
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
3 changes: 3 additions & 0 deletions .gitmodules
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
[submodule "uhura"]
path = uhura
url = https://github.com/gridaco/uhura.git
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -626,11 +626,33 @@ prints the SDL for offline schema tooling.
The npm package metadata lives under `npm/` only to reserve the package name.
It is not the primary implementation target.

## Uhura, the client language

Spock's doctrine forbids Spock from building a client language — "generate
types, never the client" (`docs/rfd/0010`), "borrow, don't build"
(`docs/rfd/0009`). That slot is filled by
[Uhura](https://github.com/gridaco/uhura): a declarative UI language and
deterministic headless experience runtime that owns non-authoritative
UI-session state and experience behavior, with Spock as its canonical
provider. No fact may be authoritative in both languages.

Uhura is a subsystem of the Spock project: its canonical source lives in its
own repository and is included here as a git submodule at `uhura/`. Today this
is topology only — Spock's workspace, build, and CI do not touch the
submodule, and `cargo` builds work without it (clone with
`--recurse-submodules` only if you want the Uhura tree). Once Uhura is
minimally stable, its tooling ships through the unified `spock` toolchain,
and the runtime integration lands as contract projection plus a provider
adapter.

## Repository Layout

- `examples/` contains product requirements and current-valid Spock examples.
- `docs/rfd/` contains discussion drafts and proposal-only language ideas.
- `npm/` contains package metadata for npm name reservation.
- `uhura/` is the Uhura client language (git submodule of
[gridaco/uhura](https://github.com/gridaco/uhura); not yet wired into the
build).

## References and prior work

Expand Down
1 change: 1 addition & 0 deletions uhura
Submodule uhura added at 201e84
Loading