Integration Matrix
Legacy TypeScript website content. Shared public website, blog, protocol, guide, and language-neutral docs ownership now lives in
~/src/graphreflyunder D563. This page is retained here only as migration/reference material while the TS API generator still lives inwebsite/.
This matrix is the fast inventory view. Use it to find what exists today, where to look next, and which package or doc path to start from.
Focused Package Surfaces
Section titled “Focused Package Surfaces”| Surface | Type | Entry |
|---|---|---|
| Root convenience surface | Primary package entry | @graphrefly/ts |
| Core graph layer | Graph API | @graphrefly/ts/graph |
| Protocol/core primitives | Node, ctx, and message-level API | @graphrefly/ts/core |
| Data contracts | Data-only result and issue types | @graphrefly/ts/data |
| Operators | Tree-shakeable operator factories | @graphrefly/ts/operators |
| Sources | Universal source factories | @graphrefly/ts/sources |
| Browser sources | Browser-only source factories | @graphrefly/ts/sources/browser |
| Node sources | Node-only source factories | @graphrefly/ts/sources/node |
| Render | Pure describe snapshot renderers | @graphrefly/ts/render |
| Composition | Topology composition helpers | @graphrefly/ts/composition |
| Committed facts | Domain-neutral committed-fact journal mechanics over passive append logs | @graphrefly/ts/committed-facts |
| Data structures | Reactive list/map/index/log helpers | @graphrefly/ts/data-structures |
| Passive storage | Storage codecs, KV, append-log, WAL, and read-through helpers | @graphrefly/ts/storage |
| Browser storage | IndexedDB-backed storage helpers | @graphrefly/ts/storage/browser |
| Node storage | File and SQLite-backed storage helpers | @graphrefly/ts/storage/node |
| Testing helpers | Package-level assertions for tests | @graphrefly/ts/testing |
See Adapters for usage guidance and naming conventions.
Adapter and Application Surfaces
Section titled “Adapter and Application Surfaces”| Surface | Type | Entry |
|---|---|---|
| Generic adapters | Store facades, environment projections, bridge helpers, and persistence adapters | @graphrefly/ts/adapters |
| Observe storage adapter | Graph-observe egress into passive storage sinks/logs | @graphrefly/ts/adapters/observe-storage |
| Messaging | Topic message helpers and bus projections | @graphrefly/ts/messaging |
| CQRS | CQRS helpers | @graphrefly/ts/cqrs |
| CQRS messaging recipe | Focused CQRS messaging recipe | @graphrefly/ts/cqrs/messaging |
| CQRS work-queue recipe | Focused CQRS work-queue recipe | @graphrefly/ts/cqrs/work-queue |
| Work queue | Work queue facts and projections | @graphrefly/ts/work-queue |
| Rate limit | Strict keyed admission contracts, exact host-side reference transitions, and the explicitly local fixed-window helper | @graphrefly/ts/rate-limit |
| Orchestration | Process, retry, timeout, tool-provider, and scheduled-readiness projectors | @graphrefly/ts/orchestration |
| Orchestration messaging recipe | Focused orchestration messaging recipe | @graphrefly/ts/orchestration/messaging |
| Orchestration work-queue recipe | Focused orchestration work-queue recipe | @graphrefly/ts/orchestration/work-queue |
| Executor work-queue recipe | Focused executor work-queue recipe | @graphrefly/ts/executors/work-queue |
| Execution-environment targeting | Strict environment-pinned profile/route/run contracts and D419-admitted local-host gate; remote/container bindings are not implied | @graphrefly/ts/executors/execution-environment |
| Local-container PostgreSQL binding | Digest-pinned, host-injected PostgreSQL container lifecycle with exact cancellation and independently visible cleanup | @graphrefly/ts/executors/local-container-postgresql |
| Local-container PostgreSQL Docker Engine API v0 broker | D624 host-runtime focused Docker Engine API broker/certifier; sockets, endpoints, client handles, resource IDs, raw inspect/logs, credentials, and cleanup handles remain private | @graphrefly/ts/executors/local-container-postgresql-docker-engine-api-v0 |
| Node-local Docker Engine API v0 certifier | D624 Node-only Docker Engine API certifier entry for the existing local-container PostgreSQL family; private Docker socket/resource handles stay inside the host process and caller-supplied proof adapters provide containment/network/secret evidence | @graphrefly/ts/executors/local-container-postgresql-docker-engine-api-v0/node |
| Rootless Podman native Libpod API v0 PostgreSQL contract | D645 independent Podman backend family and app-private runtime host contract; it does not use the Docker-compatible API or expose a provider registry | @graphrefly/ts/executors/local-container-postgresql-podman-libpod-api-v0-rootless |
| Node-local rootless Podman Libpod API v0 certifier | D645 Node-only candidate certifier with package-owned host coordinates, bounded CLI socket discovery, native Libpod requests, and private resource handles; it remains unavailable until every required live effect probe is certified | @graphrefly/ts/executors/local-container-postgresql-podman-libpod-api-v0-rootless/node |
| Local untrusted JavaScript compute contract | D667 host-neutral, exact-coordinate attempt contract for immutable JavaScript bundles, admitted JSON inputs, bounded GraphReFly runner results, runtime topology, provenance, cancellation, and verified cleanup | @graphrefly/ts/executors/local-untrusted-js-compute |
| Node-local untrusted JavaScript Podman broker and certifier | D667 Node-only rootless-Podman broker plus package-owned distroless runner artifact and live certifier: admitted bundles receive only the fixed graph/source/derive API and admitted JSON; static/dynamic imports and ambient process/require/fetch are denied; the digest-pinned image runs non-root with a read-only rootfs, no host or engine-socket mount, one bounded noexec tmpfs, no network, bounded resources, exact cancellation, verified 0N/0E Graph disposal, and terminal container removal | @graphrefly/ts/executors/local-untrusted-js-compute/node |
| Local untrusted JavaScript fixed runner Containerfile | D667 package-owned immutable image recipe, exported only under the focused compute family so installed hosts can build the certified runner without traversing package internals | @graphrefly/ts/executors/local-untrusted-js-compute/runner/Containerfile |
| Local untrusted JavaScript fixed runner bundle | D667 package-version-bound runner bundle consumed by the focused Containerfile; it is an asset subpath, not a package root API | @graphrefly/ts/executors/local-untrusted-js-compute/runner/local-untrusted-js-runner.mjs |
| Managed-cloud PostgreSQL binding | PostgreSQL-16 atomic control-store and worker-initiated WSS session lifecycle with exact fenced leases, cancellation, and settlement | @graphrefly/ts/executors/managed-cloud-postgresql |
| Managed untrusted JS compute | E2B Cloud v0 untrusted JavaScript compute lifecycle with deny-all network, bounded movement evidence, exact cancellation, and independently visible cleanup | @graphrefly/ts/executors/managed-untrusted-js-compute |
| Customer-hosted PostgreSQL binding | Signed digest-pinned endpoint agent, outbound authenticated WSS, customer-resident credentials, exact cross-domain fences, and encrypted evidence-only offline outbox | @graphrefly/ts/executors/customer-hosted-postgresql |
| PostgreSQL governed run operations | Host-owned PostgreSQL-16 CAS recovery ledger, action-specific eligibility, new D419 candidate handoff, and proposal-only D358 repair | @graphrefly/ts/executors/postgresql-run-operations |
| Shared control-panel authority | Database-neutral panel, capability admission, subscription, occurrence, alert, suppression, and inbox delivery contracts over a host-supplied feature persistence port | @graphrefly/ts/solutions/shared-control-panel-authority |
| Shared control-panel reference persistence | Testing-only in-memory backend for persistence conformance; never a production default | @graphrefly/ts/testing/shared-control-panel-memory-persistence |
| Production evaluation authority | D610 campaign/result/attestation/migration/packet contracts over host-private evidence authorities and a narrow persistence port | @graphrefly/ts/solutions/production-evaluation-authority |
| ClickHouse trusted-query evaluation | D628 focused ClickHouse candidate/profile/scenario/evidence contracts that lower to D610 without owning clients, credentials, SQL execution, raw rows, or registries | @graphrefly/ts/solutions/clickhouse-trusted-query-evaluation |
| Production evaluation reference persistence | Testing-only atomic in-memory backend for D610 persistence conformance; never a production default | @graphrefly/ts/testing/production-evaluation-memory-persistence |
| Tool-provider execution recipe | Focused tool-provider execution recipe | @graphrefly/ts/executors/tool-provider |
| Tool-provider runtime | Explicit low-level adapter runtime attach boundary; runtime handles stay private data | @graphrefly/ts/executors/tool-provider-runtime |
| Tool-provider adapter pack | Local builtin, process, and HTTP adapter helpers | @graphrefly/ts/executors/tool-provider-adapters |
| PostgreSQL tool-provider adapter | Version-pinned PostgreSQL-compatible read-only async runtime with private driver lifecycle | @graphrefly/ts/executors/postgresql-tool-provider |
| Boundary inspection | Boundary manifest inspection helpers | @graphrefly/ts/inspection/boundary |
| Memory | Horizontal memory and fact-fragment families | @graphrefly/ts/memory |
| Semantic memory | Focused semantic memory fact-fragment helpers | @graphrefly/ts/memory/semantic |
| Patterns | Reusable projection patterns | @graphrefly/ts/patterns |
| Event-flow pattern | Focused event-flow pattern | @graphrefly/ts/patterns/event-flow |
| Scoring | Reusable subjects/signals/policy scoring helpers | @graphrefly/ts/scoring |
| Solutions | Vertical solution kits | @graphrefly/ts/solutions |
| Agentic memory | Focused agentic memory solution | @graphrefly/ts/solutions/agentic-memory |
| Agentic memory browser | Browser-only AgenticMemory reference backends | @graphrefly/ts/solutions/agentic-memory/browser |
| Agentic memory Node | Node-only AgenticMemory reference backends | @graphrefly/ts/solutions/agentic-memory/node |
| Agentic WorkItem memory bridge | Mapper-only bridge namespace | @graphrefly/ts/solutions/agentic-work-item-memory |
| Agentic WorkItem memory application | Cross-family application composition recipe | @graphrefly/ts/solutions/agentic-work-item-memory-application |
| Reactive layout | DOM-free reactive layout solution core | @graphrefly/ts/solutions/reactive-layout |
| Reactive layout browser | Browser measurement helpers | @graphrefly/ts/solutions/reactive-layout/browser |
| Reactive layout caller-owned canvas context | Dependency-free Node-style canvas measurement helper | @graphrefly/ts/solutions/reactive-layout/node-canvas |
| Reactive layout React Native | React Native measurement helpers | @graphrefly/ts/solutions/reactive-layout/react-native |
| Reactive layout Skia | Skia measurement helpers | @graphrefly/ts/solutions/reactive-layout/skia |
| Work item | Focused WorkItem solution barrel | @graphrefly/ts/solutions/work-item |
| Work-item actions | Focused work-item action projectors | @graphrefly/ts/solutions/work-item/actions |
| Work-item scheduling | Focused work-item scheduling projectors | @graphrefly/ts/solutions/work-item/scheduling |
| Work-item work-queue recipe | Focused work-item work-queue recipe | @graphrefly/ts/solutions/work-item/work-queue |
Framework and Host Bindings
Section titled “Framework and Host Bindings”| Integration | Type | Entry |
|---|---|---|
| React | Framework adapter | @graphrefly/react |
| Vue | Framework adapter | @graphrefly/vue |
| Solid | Framework adapter | @graphrefly/solid |
| Svelte | Framework adapter | @graphrefly/svelte |
| NestJS structural metadata | D484 dependency-light boundary factories/decorators | @graphrefly/nestjs |
| NestJS native providers | D494 HTTP/guard/filter/cron/lifecycle provider bundles and explicit targets | @graphrefly/nestjs/native |
| NestJS WebSocket boundary | D488 focused optional-peer gateway bridge plus D495 provider bundle | @graphrefly/nestjs/websockets |
| NestJS microservice boundary | D488 focused optional-peer message-pattern bridge plus D495 provider bundle | @graphrefly/nestjs/microservices |
| node-canvas package loader | Concrete third-party canvas integration | @graphrefly/reactive-layout-node-canvas |
| Jotai-style facade | Framework-neutral store facade | jotaiAtom from @graphrefly/ts/adapters |
| Nanostores-style facade | Framework-neutral store facade | nanoAtom from @graphrefly/ts/adapters |
| Zustand-style facade | Framework-neutral store facade | zustandStore from @graphrefly/ts/adapters |
Legacy @graphrefly/graphrefly/compat/* imports are retired.
NestJS provider bundles are explicit arrays over existing options. They are not modules, do not scan the container, do not create graphs, and do not own retry, session, reconnect, or transport lifecycle policy. Graph-visible adapter diagnostics require an explicitly wired sanitized diagnostics ingress boundary; there is no diagnostics callback or logging API.