Projects
Meta-Effects is the company and hosted runtime. The open-source projects are the parts we compose to make hosted deployments work.
This is not an umbrella brand with unrelated projects underneath it. It is one product stack:
The Product Layer#
These packages are the hosted product surface: the web app, deployment hosts, API process, SDK, CLI, and shared platform contracts.
| Package | Path | Role |
|---|---|---|
| @open-ontology/web | packages/web | The Meta-Effects web app, branded pages, docs surfaces, and product UI. |
| @open-ontology/runtime-http | packages/runtime/api | HTTP API, RPC, and runtime-facing service boundary. |
| @open-ontology/node | apps/node | Unified Node host for API and web in one process. |
| @open-ontology/cloudflare | apps/cloudflare | Cloudflare Workers deployment target. |
| @open-ontology/bun | apps/bun | Bun single-binary deployment target. |
| @open-ontology/sdk | packages/sdk | Embeddable JavaScript SDK for databases and runtime clients. |
| @open-ontology/cli | packages/npm/cli | Published command-line entrypoint. |
| @open-ontology/runtime-cli | packages/runtime/cli | Effect-based CLI implementation. |
| @open-ontology/platform | packages/platform | Shared contracts for host environments. |
| @open-ontology/platform-node | packages/platform-node | Node host composition. |
| @open-ontology/platform-cloudflare | packages/platform-cloudflare | Cloudflare host composition. |
| @open-ontology/platform-bun | packages/platform-bun | Bun host composition. |
| @open-ontology/platform-clerk | packages/platform-clerk | Clerk authentication providers for hosted surfaces. |
Forma Toolchain#
Forma is the language workbench: parse source, define forms, check declarations, project editor metadata, and emit canonical artifacts.
| Package | Path | Role |
|---|---|---|
| @open-ontology/language-ocaml | packages/language-ocaml | OCaml compiler engine for the Lisp language substrate. |
| @open-ontology/language-ocaml-lsp | packages/language-ocaml-lsp | Language Server Protocol wrapper around the OCaml engine. |
| @open-ontology/language-ts | packages/language-ts | TypeScript language engine: reader, evaluator, type system, descriptors, and elaboration. |
| @open-ontology/language-host | packages/language-host | Shared host ABI facade for TypeScript and OCaml language engines. |
| @open-ontology/language-editor | packages/language-editor | CodeMirror and editor integration for authored declarations. |
| @open-ontology/language-e2e | packages/language-e2e | Fixture-driven parity and cutover harness for language engines. |
| @open-ontology/compiler-editor | packages/compiler/compiler-editor | Compiler-backed editor services and projections. |
| @open-ontology/compiler-descriptor-protocol | packages/compiler/descriptor-protocol | Protocol contracts for descriptor-shaped compiler metadata. |
| @open-ontology/compiler-protocol-codegen | packages/compiler/protocol-codegen | Code generation for protocol-defined contracts. |
Schema Packages#
These names describe the schema-facing package surfaces in the stack. Some are already separate packages; some are still implemented inside the compiler/runtime packages and are being made explicit as the primitive stabilizes.
| Surface | Current home | Role |
|---|---|---|
| schema-algebra | language, compiler, and runtime packages | The algebra for composing declarations, schemas, constraints, handlers, and annotations into one graph. |
| schema-artifacts | ontology-ir, ontology-generate, protocol-codegen | The generated artifacts: Effect Schemas, TypeScript types, validators, manifests, docs, OpenAPI/MCP-shaped exports, and runtime contracts. |
| schema-ide | language-editor, compiler-editor, web IDE | The IDE layer that reads the same declarations for hover, completion, diagnostics, navigation, previews, and edits. |
| @open-ontology/ontology-ir | packages/compiler/ontology-ir | Canonical intermediate representation for compiled ontologies. |
| @open-ontology/ontology-generate | packages/compiler/ontology-generate | TypeScript and Effect Schema generation from ontology IR. |
| @open-ontology/view-protocol | packages/view-protocol | Protocol for generated views and UI-facing projections. |
Alpha Ontology#
Alpha Ontology is the default operational ontology stack built on Forma. It gives teams useful forms for entities, facts, workflows, policies, commands, effects, projections, and interfaces.
| Package | Path | Role |
|---|---|---|
| @open-ontology/ontology-compiler | packages/compiler/ontology-compiler | Alpha Ontology compilation pipeline from source to canonical IR. |
| @open-ontology/ontology-project | packages/compiler/ontology-project | Project loading, markdown extraction, source graph utilities, and authored bundle handling. |
| @open-ontology/examples | examples | Canonical example ontology source bundles. |
| @open-ontology/connectors | packages/connectors | Reusable integration bundles: documents, adapters, processes, and actions. |
| @open-ontology/agent-skills | packages/agent-skills | Agent skill definitions bundled for distribution and CLI embedding. |
| @open-ontology/runtime-testkit | packages/runtime/testkit | Test utilities for runtime behavior. |
Runtime And Data#
The runtime executes declarations against durable state. The database packages preserve facts, history, relationships, queries, and provenance.
| Package | Path | Role |
|---|---|---|
| @open-ontology/runtime | packages/runtime | Core runtime services, execution semantics, IDE-facing runtime projections, and schema generation. |
| @open-ontology/database | packages/database | Database contracts for facts, entities, relationships, and time. |
| @open-ontology/database-sql | packages/database/sql | Shared SQL support. |
| @open-ontology/database-sqlite | packages/database/sqlite | SQLite adapter. |
| @open-ontology/database-postgres | packages/database/postgres | Postgres adapter. |
| @open-ontology/database-cloudflare | packages/database/cloudflare | Cloudflare database adapter. |
| @open-ontology/database-foundationdb | packages/database/foundationdb | FoundationDB adapter. |
| @open-ontology/database-testkit | packages/database/testkit | Database test utilities. |
Interface Packages#
These packages make the declaration graph visible: application screens, reusable blocks, design exploration, local dev tools, and generated views.
| Package | Path | Role |
|---|---|---|
| @open-ontology/ui | packages/ui | Shared UI primitives. |
| @open-ontology/blocks | packages/blocks | Block-based UI components. |
| @open-ontology/devtools | apps/devtools | Local development utilities and dashboards. |
| @open-ontology/design-exploration | packages/design-exploration | Design experiments and product surface exploration. |
Distribution And Tooling#
These packages ship the stack, bundle content, and keep CI explicit.
| Package | Path | Role |
|---|---|---|
| @open-ontology/cli-darwin-arm64 | packages/npm/cli-darwin-arm64 | macOS arm64 CLI binary. |
| @open-ontology/cli-darwin-x64 | packages/npm/cli-darwin-x64 | macOS x64 CLI binary. |
| @open-ontology/cli-linux-arm64 | packages/npm/cli-linux-arm64 | Linux arm64 CLI binary. |
| @open-ontology/cli-linux-x64 | packages/npm/cli-linux-x64 | Linux x64 CLI binary. |
| @open-ontology/onlang | packages/npm/onlang | JavaScript language toolchain package. |
| @open-ontology/content-bundler | tools/content-bundler | Bundles docs, specs, and blog content into generated TypeScript. |
| @open-ontology/ci-dsl | tools/ci | CI DSL and orchestration tools. |
How To Read This#
The hosted product is Meta-Effects. Forma is how declarations are authored and checked. Alpha Ontology is the default operational language. The schema surfaces are the contract layer that turns declarations into types, artifacts, IDE behavior, runtime bindings, agent interfaces, and deployment manifests.
The word project here means a load-bearing layer of the product, not a side quest.