@ai-matrx/associations 0.8.11 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # Changelog — @ai-matrx/associations
 
+## 0.9.0 — BREAKING: the boot probe is deleted
+
+`AssociationsProvider` used to run `assertDemandedSchema` on mount. That probe
+established whether each of the 26 demanded RPCs existed **by calling it** with
+sentinel arguments — and **fourteen of them are writes** (`assoc_add`,
+`assoc_set_targets`, `assoc_remove_for_entity`, `conversation_file_add`,
+`agent_resource_add`, `cat_create`/`cat_update`/`cat_reparent`/`cat_delete`,
+`ues_set`, `ues_touch`, `cmt_add`, `cmt_edit`, `cmt_delete`). Measured in the
+AI Matrx frontend on `/administration/billing/spend`: **25 POSTs to
+`/rest/v1/rpc/<name>` answered 400 on every page load**, ahead of the page's own
+reads.
+
+It was documented as dev-only. It was not. The gate was
+`process.env.NODE_ENV === "development"`, and tsup builds this package with
+`platform: "browser"`, where esbuild SUBSTITUTES that expression at build time —
+the shipped `dist/react/index.js` read `typeof process !== "undefined" && true`.
+Every consumer fired the storm in production.
+
+**THE CLASS RULE: a write RPC is never invoked to ask whether it exists.**
+
+Removed, not deprecated (a knob nobody can safely turn on is not a knob):
+
+- `assertDemandedSchema`, `SELF_TEST_MISSING_RPC`, `AssertDemandedSchemaOptions`
+  and `DemandedSchemaReport` are gone from `@ai-matrx/associations/core`.
+- The `probeSchema` prop is gone from `AssociationsProvider`.
+- Mounting the provider now issues **no network call at all**.
+
+Nothing replaces it, because nothing needs to. A database that cannot answer a
+demanded function still says so, loudly, at the first REAL call: PostgREST
+returns PGRST202 and `mapPgError` raises `demanded_schema_violation` with the
+same remedy — at the moment it matters, and at zero cost on the loads where the
+database is right.
+
+Guards (both proven failing-then-passing):
+`src/react/__tests__/mount-is-inert.test.tsx` — a recorder sees an RPC when one
+is made (the self-test), and mounting the provider records none.
+`src/__tests__/no-node-env-gating.test.ts` — no source file reads `NODE_ENV` in
+code, because our own build bakes it. `scripts/verify-tarball.mjs` asserts the
+SHIPPED cjs core no longer exports `assertDemandedSchema`.
+
+**Consumer action.** Delete any `probeSchema` prop you pass to
+`AssociationsProvider` (it is now a type error) and any `assertDemandedSchema`
+import. If you want a deliberate schema check in CI, assert against `pg_proc`
+from a server-side script — never by invoking the functions.
+
+This release also carries 0.8.10 and 0.8.11, whose artifacts never reached the
+registry (the 0.8.10 workflow stopped on a stale workspace lockfile): the
+regenerated `entity-types.generated.ts` vocabulary at **676 tokens**.
+
 ## 0.8.11
 
 Republishes the 0.8.10 vocabulary artifact under a fresh immutable version.

package/README.md

@@ -26,7 +26,6 @@ import {
 ```ts
 import {
   createAssociationsStore, // the ONE runtime object a host constructs
-  assertDemandedSchema,    // boot probe: every demanded RPC must answer
 } from "@ai-matrx/associations/core";
 
 const store = createAssociationsStore({
@@ -42,10 +41,9 @@ await store.add({ sourceType: "note", sourceId, targetType: "task", targetId });
 store.titles.prime("task", taskId, "Renamed");
 await store.favorites.setFavorite("note", noteId, true);
 
-// Dev/CI boot check for any new environment (zero side effects; selfTest
-// proves the probe can fail before you trust its green). You normally never
-// call this: <AssociationsProvider> runs it for you in a development build.
-await assertDemandedSchema(supabase, { selfTest: true });
+// There is NO boot check to call (0.9.0). A database that cannot answer a
+// demanded function says so at the first real call: PostgREST returns
+// PGRST202 and the package screams `demanded_schema_violation` with a remedy.
 ```
 
 `useContainerLinks({ containerType, containerId, orgId })` is the canonical
@@ -91,7 +89,8 @@ adapt to your database — it DEMANDS ours. A consumer who won't run our schema
 not this package's consumer. It ships no DDL (the platform DB owns that; managed
 consumers run on our infrastructure); it ships the demand three ways —
 documented (here), typed (`DemandedRpcSignatures`, generated from the live DB),
-and probed (`assertDemandedSchema` in `/core`). Every violation
+and screamed at the first real call (PGRST202 → `demanded_schema_violation`,
+with a remedy). Every violation
 **screams, never degrades**.
 
 1. **The edge.** `platform.associations(source_type, source_id, target_type,

package/dist/{CommentThread--C4Vgv0S.d.cts → CommentThread-BKDzEKvk.d.cts}

@@ -335,7 +335,7 @@ type AssociationsRpcErrorCode = "unauthorized" | "forbidden_org" | "forbidden_ro
  * on any demanded RPC maps to this code: the database this client is
  * pointed at does not run the schema this package demands (README front
  * door). It always reaches the errorSink — one unambiguous scream, never a
- * mystery toast. Probe it at boot with `assertDemandedSchema` (/core, W2).
+ * mystery toast — PGRST202 arrives as `demanded_schema_violation`.
  */
  | "demanded_schema_violation" | "internal";
 interface AssociationsRpcError {

package/dist/{CommentThread--C4Vgv0S.d.ts → CommentThread-BKDzEKvk.d.ts}

@@ -335,7 +335,7 @@ type AssociationsRpcErrorCode = "unauthorized" | "forbidden_org" | "forbidden_ro
  * on any demanded RPC maps to this code: the database this client is
  * pointed at does not run the schema this package demands (README front
  * door). It always reaches the errorSink — one unambiguous scream, never a
- * mystery toast. Probe it at boot with `assertDemandedSchema` (/core, W2).
+ * mystery toast — PGRST202 arrives as `demanded_schema_violation`.
  */
  | "demanded_schema_violation" | "internal";
 interface AssociationsRpcError {

package/dist/core/index.cjs

@@ -23,8 +23,6 @@ __export(core_exports, {
   DEFAULT_ORG_COLUMN: () => DEFAULT_ORG_COLUMN,
   DEFAULT_OWNER_COLUMN: () => DEFAULT_OWNER_COLUMN,
   NON_CONTENT_SOURCE_TYPES: () => NON_CONTENT_SOURCE_TYPES,
-  SELF_TEST_MISSING_RPC: () => SELF_TEST_MISSING_RPC,
-  assertDemandedSchema: () => assertDemandedSchema,
   associationsKey: () => associationsKey,
   buildCategoryHierarchy: () => buildCategoryHierarchy,
   createAssociationGuards: () => createAssociationGuards,
@@ -3316,169 +3314,6 @@ function createAssociationsStore(config) {
   };
 }
 
-// src/demanded-rpcs.generated.ts
-var DEMANDED_RPC_NAMES = [
-  "assoc_add",
-  "assoc_remove",
-  "assoc_set_targets",
-  "assoc_remove_for_entity",
-  "assoc_for_entity",
-  "assoc_for_targets",
-  "assoc_for_sources",
-  "assoc_members_visible",
-  "conversation_file_add",
-  "conversation_file_remove",
-  "conversation_files",
-  "agent_resource_add",
-  "agent_resource_remove",
-  "cat_list",
-  "cat_create",
-  "cat_update",
-  "cat_reparent",
-  "cat_delete",
-  "ues_set",
-  "ues_list",
-  "ues_get_bulk",
-  "ues_touch",
-  "reference_search_candidates",
-  "cmt_list",
-  "cmt_add",
-  "cmt_edit",
-  "cmt_delete"
-];
-
-// src/core/assertDemandedSchema.ts
-var BAD_UUID = "__not_a_uuid__";
-var SELF_TEST_MISSING_RPC = "assoc_probe_self_test_missing_fn";
-var PROBE_ARGS = {
-  // edges — writes
-  assoc_add: {
-    p_source_type: "note",
-    p_source_id: BAD_UUID,
-    p_target_type: "task",
-    p_target_id: BAD_UUID
-  },
-  assoc_remove: {
-    p_source_type: "note",
-    p_source_id: BAD_UUID,
-    p_target_type: "task",
-    p_target_id: BAD_UUID
-  },
-  assoc_set_targets: {
-    p_source_type: "note",
-    p_source_id: BAD_UUID,
-    p_target_type: "task",
-    p_target_ids: [BAD_UUID]
-  },
-  assoc_remove_for_entity: { p_type: "note", p_id: BAD_UUID },
-  // edges — reads
-  assoc_for_entity: { p_type: "note", p_id: BAD_UUID },
-  assoc_for_targets: { p_target_type: "task", p_target_ids: [BAD_UUID] },
-  assoc_for_sources: { p_source_type: "note", p_source_ids: [BAD_UUID] },
-  assoc_members_visible: { p_target_type: "task", p_target_ids: [BAD_UUID] },
-  // conversation files
-  conversation_file_add: {
-    p_conversation_id: BAD_UUID,
-    p_file_id: BAD_UUID
-  },
-  conversation_file_remove: {
-    p_conversation_id: BAD_UUID,
-    p_file_id: BAD_UUID
-  },
-  conversation_files: { p_conversation_id: BAD_UUID },
-  // agent resources
-  agent_resource_add: {
-    p_agent_id: BAD_UUID,
-    p_source_type: "note",
-    p_source_id: BAD_UUID
-  },
-  agent_resource_remove: {
-    p_agent_id: BAD_UUID,
-    p_source_type: "note",
-    p_source_id: BAD_UUID
-  },
-  // categories
-  cat_list: {},
-  cat_create: { p_dimension: "", p_name: "", p_org_id: BAD_UUID },
-  cat_update: { p_category_id: BAD_UUID, p_name: "__probe__" },
-  cat_reparent: { p_category_id: BAD_UUID },
-  cat_delete: { p_category_id: BAD_UUID },
-  // favorites / recents
-  ues_set: { p_entity_type: "__probe__", p_entity_id: BAD_UUID },
-  ues_list: {},
-  ues_get_bulk: { p_entity_type: "__probe__", p_entity_ids: [BAD_UUID] },
-  ues_touch: { p_entity_type: "__probe__", p_entity_id: BAD_UUID },
-  // candidates
-  reference_search_candidates: { p_token: "__probe__", p_limit: 1 },
-  // comments (W6) — every fn takes a uuid arg, so the unparseable sentinel
-  // guarantees 22P02 before any SECURITY DEFINER body runs (no write occurs).
-  cmt_list: { p_entity_type: "__probe__", p_entity_id: BAD_UUID },
-  cmt_add: {
-    p_entity_type: "__probe__",
-    p_entity_id: BAD_UUID,
-    p_body: "__probe__"
-  },
-  cmt_edit: { p_id: BAD_UUID, p_body: "__probe__" },
-  cmt_delete: { p_id: BAD_UUID }
-};
-function isMissingFunctionError(error) {
-  if (!error || typeof error !== "object") return false;
-  return error.code === "PGRST202";
-}
-async function assertDemandedSchema(dataSource, options = {}) {
-  const { selfTest = false, concurrency = 6, throwOnViolation = true } = options;
-  const names = [...DEMANDED_RPC_NAMES];
-  if (selfTest) names.push(SELF_TEST_MISSING_RPC);
-  const missing = [];
-  const unreachable = [];
-  const answered = [];
-  let cursor = 0;
-  async function worker() {
-    while (cursor < names.length) {
-      const fn = names[cursor];
-      cursor += 1;
-      if (!fn) continue;
-      const args = fn === SELF_TEST_MISSING_RPC ? {} : PROBE_ARGS[fn];
-      try {
-        const { error } = await dataSource.rpc(fn, args);
-        if (error == null) answered.push(fn);
-        else if (isMissingFunctionError(error)) missing.push(fn);
-        else answered.push(fn);
-      } catch (e) {
-        unreachable.push({ fn, error: e });
-      }
-    }
-  }
-  await Promise.all(
-    Array.from({ length: Math.min(concurrency, names.length) }, worker)
-  );
-  if (selfTest) {
-    const selfTestMissing = missing.includes(SELF_TEST_MISSING_RPC);
-    const idx = missing.indexOf(SELF_TEST_MISSING_RPC);
-    if (idx >= 0) missing.splice(idx, 1);
-    const answeredIdx = answered.indexOf(SELF_TEST_MISSING_RPC);
-    if (answeredIdx >= 0) answered.splice(answeredIdx, 1);
-    if (!selfTestMissing) {
-      throw new Error(
-        `assertDemandedSchema self-test FAILED: the fabricated function "${SELF_TEST_MISSING_RPC}" did not come back as missing (PGRST202). This probe cannot currently fail, so its green result proves nothing \u2014 the dataSource is swallowing or faking errors.`
-      );
-    }
-  }
-  if (unreachable.length > 0) {
-    throw new Error(
-      `assertDemandedSchema could not complete: ${unreachable.length} probe call(s) failed to reach the database (${unreachable.map((u) => u.fn).join(", ")}). This is NOT a schema verdict \u2014 fix connectivity and re-run.`
-    );
-  }
-  const ok2 = missing.length === 0;
-  const report = { ok: ok2, missing, unreachable, answered };
-  if (!ok2 && throwOnViolation) {
-    throw new Error(
-      `DEMANDED SCHEMA VIOLATION: the database this dataSource points at cannot answer ${missing.length} demanded @ai-matrx/associations function(s): ${missing.join(", ")}. This package demands the AI Matrx platform schema (README \xA7 The demanded schema); a database without it is not this package's database.`
-    );
-  }
-  return report;
-}
-
 // src/core/edgeClassifier.ts
 var NON_CONTENT_SOURCE_TYPES = /* @__PURE__ */ new Set([
   "thread",