@fabricorg/platform-host 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# @fabricorg/platform-host
+
+## 0.1.0 — 2026-07-19
+
+- Add the reusable governed mutation host extracted from the reference Fabric application host.
+- Persist action invocations before execution, policy evaluations, adapter attempts, domain events, and terminal statuses through database-neutral ports.
+- Support inline execution for tests and an injected dispatcher for durable workflow engines.
+- Support completion-style actions that append domain events only after every adapter succeeds.
+- Pass authenticated actor identity into policy evaluation context.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Fabric
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,26 @@
+# @fabricorg/platform-host
+
+The canonical host for the `@fabricorg/platform` mutation pipeline.
+
+```bash
+pnpm add @fabricorg/platform@^0.7.0 @fabricorg/platform-host@^0.1.0
+```
+
+Vertical packages register `FabricModule` definitions. Host applications provide tenant authorization,
+module entitlements, persistence, projections, and an optional durable dispatcher. The package owns the
+ordering and lifecycle invariant:
+
+```text
+Actor → ActionInvocation → PolicyEvaluation → StateMachine → Handler → AssetEvent → AdapterInvocation → Projection
+```
+
+`submitAction()` creates the durable `ActionInvocation` before dispatch. `executeInvocation()` is the
+worker entry point. With no dispatcher the host executes inline, which is intended for tests and local
+development only.
+
+Sensitive values must not be passed as action parameters. Stage them in tenant-bound encrypted storage
+and pass an opaque identifier instead; action parameters are intentionally durable audit evidence.
+
+`MemoryPlatformHostStore` is for tests and local demos. Production control planes use
+`PostgresPlatformHostStore` with Databricks Lakebase (or standard Postgres), call
+`ensureSchema()` at startup, and hydrate projections from `listEvents()`.