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
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
90 changes: 47 additions & 43 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,43 +10,46 @@ explicit local patch. A single write therefore updates list rows, detail panels,
relationships, badges, and policy-controlled generated UI without maintaining
parallel query caches.

## 3.x release status

**3.2.0 stable is published.** All twelve npm packages are public at `3.2.0`
with the `latest` and `next` tags pointing at it (published 2026-08-30). `3.2.0`
ships the complete optional DevTools distribution, including bounded core event
metadata and responsive React inspector search during continuous updates. It
retains provider-scoped imperative graph access, A2UI 1.0-RC React/Flutter
compatibility, and AG-UI 0.0.59 activity support. `3.0.0` shipped with an
unresolved pnpm `workspace:` protocol in its manifests and is deprecated; `3.0.1`
and `3.0.2` were corrective republications. `3.0.4` was published with stale
build artifacts and is deprecated. Flutter `3.1.0` consolidates the completed
controller and official DevTools companion, including multi-client cancellation.
## 4.x release status

**4.1.0 stable is published.** All thirteen npm packages are public at `4.1.0`
with the `latest` and `next` tags pointing at it (published 2026-10-07). `4.1.0`
fixes garbage collection evicting entities that mounted lists still reference
([#43](https://github.com/Prometheus-AGS/prometheus-entity-management/issues/43)):
list membership now counts as a reference, `removeIdFromAllLists` respects the
entity type, and `ListState` gains an optional `entityType`. `4.0.0` moved the
workspace to ESM-only output and published the React binding as
`@prometheus-ags/entity-graph-react`, with `@prometheus-ags/prometheus-entity-management`
kept as a compatibility alias. `4.0.1` shipped with an unresolved pnpm
`workspace:` protocol and is deprecated; `4.0.2` was its corrective
republication. Flutter `4.0.0` is public on pub.dev (published 2026-09-05)
with the completed controller and official DevTools companion.
The [Chrome DevTools 3.2.0 ZIP](https://github.com/Prometheus-AGS/prometheus-entity-management/releases/download/v3.2.0/prometheus-entity-graph-devtools-3.2.0.zip)
is available for developer-mode installation; it is not a Chrome Web Store listing.
The production documentation is available at
[prometheus-ags.github.io/prometheus-entity-management](https://prometheus-ags.github.io/prometheus-entity-management/).

<!-- BEGIN GENERATED:RELEASE_TAGS -->
Registry snapshot: 2026-08-30T22:54:50.026Z. Expected candidate: `3.2.0`.
Registry snapshot: 2026-10-08T10:34:51.000Z. Expected candidate: `4.1.0`.

| Package | `latest` | `alpha` | `next` | Release state |
| --- | --- | --- | --- | --- |
| `@prometheus-ags/entity-graph-core` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-sdl` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-solid` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-svelte` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-sync` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-tauri` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-web-components` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/prometheus-entity-management` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/a2ui-react` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-a2a` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-alpine` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-htmx` | `3.2.0` | `3.0.0-alpha.0` | `3.2.0` | published |
| `@prometheus-ags/entity-graph-core` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-react` | `4.1.0` | `absent` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-sdl` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-solid` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-svelte` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-sync` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-tauri` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-web-components` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/prometheus-entity-management` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/a2ui-react` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-a2a` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-alpine` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
| `@prometheus-ags/entity-graph-htmx` | `4.1.0` | `3.0.0-alpha.0` | `4.1.0` | published |
<!-- END GENERATED:RELEASE_TAGS -->

The stable release is tagged `v3.2.0` and was verified live against the public
The stable release is tagged `v4.1.0` and was verified live against the public
registry after publication. See [RELEASING.md](RELEASING.md) for the release
contract, the governed OIDC promotion path, and recovery rules.

Expand Down Expand Up @@ -100,18 +103,19 @@ they cannot create hidden graph singletons.
<!-- BEGIN GENERATED:PACKAGES -->
| Package | Candidate | Stability | Role |
| --- | --- | --- | --- |
| `@prometheus-ags/entity-graph-core` | `3.2.0` | stable | framework-neutral normalized graph |
| `@prometheus-ags/prometheus-entity-management` | `3.2.0` | stable | React 19 hooks and UI |
| `@prometheus-ags/entity-graph-sdl` | `3.2.0` | stable | schema definition language |
| `@prometheus-ags/entity-graph-sync` | `3.2.0` | stable | local-first and CRDT sync providers |
| `@prometheus-ags/entity-graph-svelte` | `3.2.0` | stable | Svelte 5 binding |
| `@prometheus-ags/entity-graph-solid` | `3.2.0` | stable | Solid binding |
| `@prometheus-ags/entity-graph-web-components` | `3.2.0` | stable | Lit web components |
| `@prometheus-ags/entity-graph-alpine` | `3.2.0` | stable | Alpine plugin |
| `@prometheus-ags/entity-graph-htmx` | `3.2.0` | stable | HTMX server adapter |
| `@prometheus-ags/entity-graph-a2a` | `3.2.0` | stable | A2A reference server |
| `@prometheus-ags/a2ui-react` | `3.2.0` | stable | A2UI React renderer and graph bridge after AG-UI migration |
| `@prometheus-ags/entity-graph-tauri` | `3.2.0` | stable | Tauri JavaScript binding and bundled Rust plugin |
| `@prometheus-ags/entity-graph-core` | `4.1.0` | stable | framework-neutral normalized graph |
| `@prometheus-ags/entity-graph-react` | `4.1.0` | stable | React 19 hooks and UI |
| `@prometheus-ags/entity-graph-sdl` | `4.1.0` | stable | schema definition language |
| `@prometheus-ags/entity-graph-sync` | `4.1.0` | stable | local-first and CRDT sync providers |
| `@prometheus-ags/entity-graph-svelte` | `4.1.0` | stable | Svelte 5 binding |
| `@prometheus-ags/entity-graph-solid` | `4.1.0` | stable | Solid binding |
| `@prometheus-ags/entity-graph-web-components` | `4.1.0` | stable | Lit web components |
| `@prometheus-ags/entity-graph-alpine` | `4.1.0` | stable | Alpine plugin |
| `@prometheus-ags/entity-graph-htmx` | `4.1.0` | stable | HTMX server adapter |
| `@prometheus-ags/entity-graph-a2a` | `4.1.0` | stable | A2A reference server |
| `@prometheus-ags/a2ui-react` | `4.1.0` | stable | A2UI React renderer and graph bridge after AG-UI migration |
| `@prometheus-ags/entity-graph-tauri` | `4.1.0` | stable | Tauri JavaScript binding and bundled Rust plugin |
| `@prometheus-ags/prometheus-entity-management` | `4.1.0` | stable | compatibility alias for @prometheus-ags/entity-graph-react |
<!-- END GENERATED:PACKAGES -->

Package-level READMEs remain the package-specific API sources. The generated
Expand Down Expand Up @@ -139,7 +143,7 @@ Loro, Suspense, DevTools, and accessibility. See
Opt into the optional inspector from a Vite client entry without adding it to
production bundles:

> npm `3.2.0` ships the optional `./devtools` and development-only
> npm `4.1.0` ships the optional `./devtools` and development-only
> `./devtools/auto` entries. The ordinary package root remains inspector-free.

```ts
Expand All @@ -162,15 +166,15 @@ hydration so server markup remains unchanged. See the
Install the public Flutter package from pub.dev:

```bash
flutter pub add entity_graph_flutter:^3.1.0
flutter pub add entity_graph_flutter:^4.0.0
```

<!-- BEGIN GENERATED:NATIVE_RELEASES -->
pub.dev snapshot: 2026-08-30T22:55:17.910Z.
pub.dev snapshot: 2026-10-08T10:38:40.000Z.

| Package | Version | State | Published |
| --- | --- | --- | --- |
| [`entity_graph_flutter`](https://pub.dev/packages/entity_graph_flutter) | `3.1.0` | published | 2026-08-30T22:50:00.407947Z |
| [`entity_graph_flutter`](https://pub.dev/packages/entity_graph_flutter) | `4.0.0` | published | 2026-09-05T13:06:03.642746Z |

The published archive passed a clean consumer resolution, import, and analyzer check.
pub.dev does not yet associate the package with a verified publisher.
Expand All @@ -182,7 +186,7 @@ example uses generated Riverpod families, optimistic/offline CRUD,
relationships, realtime invalidation, policy-gated GenUI, responsive layouts,
and an optional FFI transport.

Flutter `3.1.0` ships an optional, metadata-first DevTools controller,
Flutter `4.0.0` ships an optional, metadata-first DevTools controller,
store-isolated VM-service bridge, and official responsive DevTools package
extension. Import `package:entity_graph_flutter/devtools.dart` only from a
debug bootstrap; the ordinary package entry and product-mode builds remain
Expand Down
16 changes: 16 additions & 0 deletions RELEASING.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,21 @@
# Releasing Prometheus Entity Management

## 4.x status: stable published

**Update 2026-10-08: 4.1.0 stable is published.** All thirteen
`@prometheus-ags/*` npm packages are public at `4.1.0` with both `latest` and
`next` pointing at it (tag `v4.1.0`). `4.0.0` moved every package to ESM-only
output and published the React binding as `@prometheus-ags/entity-graph-react`,
keeping `@prometheus-ags/prometheus-entity-management` as a compatibility alias;
`4.0.1` shipped with an unresolved pnpm `workspace:` protocol and is deprecated;
`4.0.2` was its corrective republication; `4.1.0` makes garbage collection treat
list membership as a reference (#43). These publications ran with `pnpm publish`
and a granular npm token at operator direction, so they carry no npm provenance
attestation. The `publish-stable-3.0.0.sh` script publishes the twelve
long-standing packages; the `prometheus-entity-management` alias is published
afterwards by hand with the same command, and `next` is moved with
`npm dist-tag add` from a scratch directory.

## 3.x status: stable published

**Update 2026-08-30: 3.2.0 stable is published.** All twelve
Expand Down
2 changes: 1 addition & 1 deletion examples/coverage.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"schemaVersion": "1.0.0",
"release": "4.0.0",
"release": "4.1.0",

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Align the coverage release with the canonical contract

When pnpm run validate:release-contract evaluates this commit, validateReleaseCoverage compares this value with release/v3-release-contract.json's release.version, which remains 4.0.0, and reports a mismatch at scripts/validate-v3-release-contract.mjs:95-97. Consequently the release validation gate cannot pass until the canonical release version is updated to 4.1.0 or this ledger remains aligned at 4.0.0.

Useful? React with 👍 / 👎.

"contract": "release/v3-release-contract.json",
"status": "in-progress",
"semanticContract": {
Expand Down
2 changes: 1 addition & 1 deletion examples/coverage.schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
],
"properties": {
"schemaVersion": { "const": "1.0.0" },
"release": { "const": "4.0.0" },
"release": { "const": "4.1.0" },
"contract": { "const": "release/v3-release-contract.json" },
"status": { "enum": ["in-progress", "complete"] },
"semanticContract": {
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
"generatedPartsIncluded": false,
"publication": {
"status": "published",
"publishedArchiveVersion": "3.1.0",
"publishedArchiveVersion": "4.0.0",
"publishedArchiveIncludesLibrary": true
},
"exports": [
Expand Down
63 changes: 34 additions & 29 deletions release/npm-registry-status.json
Original file line number Diff line number Diff line change
@@ -1,86 +1,91 @@
{
"schemaVersion": "1.1.0",
"verifiedAt": "2026-08-30T22:54:50.026Z",
"verifiedAt": "2026-10-08T10:34:51.000Z",
"registry": "https://registry.npmjs.org/",
"expectedCandidate": "3.2.0",
"candidateSourceSha": "4780a27128683a946f45d098e7eded19a3ff98cc",
"expectedCandidate": "4.1.0",
"candidateSourceSha": "6a27c20576e6de6b33c500500ef6e9ba83d248fd",
"releaseStatus": "stable-published",
"releaseUrl": "https://github.com/Prometheus-AGS/prometheus-entity-management/releases/tag/v3.2.0",
"releaseUrl": "https://github.com/Prometheus-AGS/prometheus-entity-management/releases/tag/v4.1.0",
"provenance": "absent-manual-publication",
"packages": {
"@prometheus-ags/entity-graph-core": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-react": {
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-sdl": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-solid": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-svelte": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-sync": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-tauri": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-web-components": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/prometheus-entity-management": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/a2ui-react": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-a2a": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-alpine": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
},
"@prometheus-ags/entity-graph-htmx": {
"alpha": "3.0.0-alpha.0",
"next": "3.2.0",
"latest": "3.2.0",
"next": "4.1.0",
"latest": "4.1.0",
"candidateState": "published"
}
},
"publicationMethod": "manual-pnpm-publish",
"certifiedPackageSourceSha": "d7dff293a79d9d3cba26fa3a0c0fbb47e8d07944"
"certifiedPackageSourceSha": "6a27c20576e6de6b33c500500ef6e9ba83d248fd"
}
12 changes: 6 additions & 6 deletions release/pubdev-registry-status.json
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
{
"schemaVersion": "1.0.0",
"verifiedAt": "2026-08-30T22:55:17.910Z",
"verifiedAt": "2026-10-08T10:38:40.000Z",
"registry": "https://pub.dev",
"packageName": "entity_graph_flutter",
"version": "3.1.0",
"version": "4.0.0",
"releaseStatus": "published",
"publishedAt": "2026-08-30T22:50:00.407947Z",
"archiveSha256": "f79c5a97a9994769cb152c68b47bca1c59e1ebb3d0ba343af8c257fca92ba1cb",
"sourceSha": "4780a27128683a946f45d098e7eded19a3ff98cc",
"publishedAt": "2026-09-05T13:06:03.642746Z",
"archiveSha256": "5db1a741dc1663b9a661a5f8769338edb23595266864de9a73a3139c300dd3c1",
"sourceSha": "f3c0250264b706fe904edfa76c52392c3cf3ef51",
"packageUrl": "https://pub.dev/packages/entity_graph_flutter",
"publisherId": null,
"consumerVerification": "passed",
Expand All @@ -16,5 +16,5 @@
"package:entity_graph_flutter/entity_graph_flutter.dart",
"package:entity_graph_flutter/devtools.dart"
],
"certifiedPackageSourceSha": "d7dff293a79d9d3cba26fa3a0c0fbb47e8d07944"
"certifiedPackageSourceSha": "f3c0250264b706fe904edfa76c52392c3cf3ef51"
}
6 changes: 3 additions & 3 deletions release/v3-release-contract.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"schemaVersion": "1.0.0",
"release": {
"name": "Prometheus Entity Management",
"version": "4.0.0",
"version": "4.1.0",
"channel": "stable",
"owner": "Prometheus AGS",
"repository": "https://github.com/Prometheus-AGS/prometheus-entity-management",
Expand All @@ -18,7 +18,7 @@
"versionPolicy": {
"npm": {
"strategy": "fixed",
"version": "4.0.0",
"version": "4.1.0",
"prereleaseTag": "next",
"stableTag": "latest",
"packages": [
Expand Down Expand Up @@ -56,7 +56,7 @@
"google-play",
"microsoft-store"
],
"deferredPolicy": "A deferred registry does not block the npm 3.2.0 release, but documentation must not claim the artifact is installable from that registry until post-publish smoke evidence exists."
"deferredPolicy": "A deferred registry does not block the npm 4.1.0 release, but documentation must not claim the artifact is installable from that registry until post-publish smoke evidence exists."
},
"artifacts": [
{
Expand Down
2 changes: 1 addition & 1 deletion site/docs/guides/bindings/flutter.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ projections of provider state.
Install the current public package:

```bash
flutter pub add entity_graph_flutter:^3.1.0
flutter pub add entity_graph_flutter:^4.0.0
```

Add the package to your Flutter app's `pubspec.yaml` (see the
Expand Down
2 changes: 1 addition & 1 deletion website/docs/examples/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ sidebar_position: 5
All showcases use the shared Project/User/Task/Comment/Activity domain and the
capabilities in `examples/coverage.json`. “Implemented” records a bounded source
and evidence claim; registry publication is reported separately. Flutter is
public on pub.dev and all twelve npm packages are public at stable `3.2.0`; no
public on pub.dev and all thirteen npm packages are public at stable `4.1.0`; no
app-store release is claimed.

| Example | Current boundary |
Expand Down
2 changes: 1 addition & 1 deletion website/docs/frameworks/flutter-riverpod.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ invalidation, transports, an optional FFI seam, and cross-view widget goldens.
Install the public `3.1.0` package from pub.dev:

```bash
flutter pub add entity_graph_flutter:^3.1.0
flutter pub add entity_graph_flutter:^4.0.0
```

The published archive passed a clean consumer import and analyzer check. pub.dev
Expand Down
2 changes: 1 addition & 1 deletion website/docs/operations/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ testing, deployment, troubleshooting, skills, release recovery, and partial
publication. Stable promotion remains a human-reviewed operation over an
immutable certification bundle.

All twelve npm packages are public at stable `3.2.0` on `latest` (the broken
All thirteen npm packages are public at stable `4.1.0` on `latest` (the broken
`3.0.0` manifests are deprecated). Documentation deployment and example tests
never authorize or perform registry mutations. Registry trust, approval,
package integrity, and post-publish consumer gates remain in force for future
Expand Down
Loading
Loading