diff --git a/profile/README.md b/profile/README.md index 8151f38..e8c1fb7 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,15 +1,72 @@ -# traverse-framework +# Traverse Framework -Traverse is a runtime and composition model for business capabilities — capability contracts, a governed registry, and a local-first execution runtime, built to be portable across execution environments. +**Define once. Run anywhere.** -## Repos +Traverse is a contract-driven WebAssembly runtime and a governed registry for +**portable business capabilities**. You write a rule — pricing, eligibility, +authorization, escalation — once, as a capability with a machine-readable +contract, and the same signed WASM artifact runs on Linux, macOS, and Windows, +on iOS and Android, in the browser, on a server, and inside an AI agent — +producing a verifiable execution trace every time. -- [`traverse`](https://github.com/traverse-framework/traverse) — the core runtime, CLI, contracts, and MCP surface -- [`registry`](https://github.com/traverse-framework/registry) — the public capability registry: capability contracts, artifacts, and the publishing pipeline -- [`reference-apps`](https://github.com/traverse-framework/reference-apps) — reference and example applications proving Traverse across web, cloud, mobile, and desktop targets -- [`website`](https://github.com/traverse-framework/website) — the public site and docs -- [`.github`](https://github.com/traverse-framework/.github) (this repo) — shared governance: constitution, NFRs, quality standards, CI gates, CLA, and AI-agent hardening rules used across every repo above +No reimplementation per environment. No agent free-handing your business rules. +One behavior, governed, everywhere it needs to run. It's the working +implementation of +[Universal Microservices Architecture](https://www.universalmicroservices.com/): +**the agent proposes, the runtime decides.** + +→ [traverse-framework.com](https://traverse-framework.com) · +start in [`traverse`](https://github.com/traverse-framework/traverse) + +--- + +## The org at a glance + +| Repo | What it is | +|---|---| +| [`traverse`](https://github.com/traverse-framework/traverse) | Core runtime, CLI, contracts, and MCP surface. Rust, `v0.10.0`, 134 approved specs, 6 crates on crates.io, ~660 commits. | +| [`registry`](https://github.com/traverse-framework/registry) | The public capability registry — a git-based, CI-validated, PR-published catalog. **46 capabilities across 24 domains** (117 signed versions) live at [registry.traverse-framework.com](https://registry.traverse-framework.com). | +| [`reference-apps`](https://github.com/traverse-framework/reference-apps) | Real example apps — one set of Traverse capabilities behind many UI shells: Web, macOS, iOS, Android, Windows, Linux, CLI, plus MCP façades for Claude, Cursor, ChatGPT, and Grok. | +| [`claude-skills`](https://github.com/traverse-framework/claude-skills) | Claude Skills for building on Traverse — check the registry before authoring, compose capabilities, validate against the real CLI. | +| [`website`](https://github.com/traverse-framework/website) | The public site and documentation. | +| [`.github`](https://github.com/traverse-framework/.github) | *(this repo)* Org-wide governance — constitution, NFRs, quality standards, CI gates, CLA, and AI-agent hardening rules shared by every repo above. | +| [`repo-template`](https://github.com/traverse-framework/repo-template) | Starting point for a new org repo — compliant with governance from the first commit. | + +**Platform reach:** five embedder SDKs on one `embedder-api/1.0.0` contract and +one CI conformance suite — Rust and Web/TypeScript published (crates.io / npm); +Swift (iOS/macOS, WasmKit), Kotlin (Android, Chicory), and .NET (Windows, +Wasmtime) shipping from `traverse/packages/`. Cloud and edge placement targets +are specified and on the roadmap, not yet shipped. + +--- + +## Why it matters + +The same business rule now has to run in a web client, on a server, at the +edge, and inside an AI agent a user is talking to. Teams answer that by +rewriting the rule in each stack; the copies drift and the behavior stops +being one thing. + +AI coding agents make this sharper: an agent asked to "add the discount logic" +re-derives it from scratch every session — unversioned, unreviewed, and +authoritative only because it ran last. Traverse's position is the opposite: +a capability is a contract, an immutable version, a signature, and a WASM +artifact; the runtime validates every input, isolates execution in a sandbox, +enforces policy, and emits an auditable trace. The agent's job is to **find and +compose** existing capabilities — not to be the source of truth for what the +business does. The registry already holds 46 of them, so that logic is a +lookup, not a regeneration. + +--- ## Governance -Every repo in this org follows the same spec-driven governance model. See [`constitution.md`](../constitution.md) for the full rules, and each repo's own `CLAUDE.md`/`AGENTS.md` for what's specific to that repo. +Every repo in this org follows the same spec-driven governance model: approved +specs are versioned, immutable, and merge-gating; contracts are the source of +truth for runtime behavior; core logic holds 100% automated coverage; a +deterministic spec-alignment gate runs on every PR. + +See [`constitution.md`](../constitution.md) for the full rules, +[`GOVERNANCE.md`](../GOVERNANCE.md) for the ownership and decision model, and +each repo's own `CLAUDE.md` / `AGENTS.md` for what's specific to it. One CLA +signature covers every repo in the org.