@ai-matrx/content-ir-react 0.18.1 → 0.19.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.19.0 — 2026-10-02
+
+- **A record's old value is the value it holds NOW.** `useRecordValues` read a
+  record ONCE per `noun:id`, so after Update A applied, Update B naming the same
+  record — its row, and a host confirm whose body stayed mounted between
+  questions — still showed A's old value as "old" (G7: "G6A renamed target"
+  while the database held "G6A second rename"). Every apply now announces the
+  records it touched (`noteRecordChanged`, for update/delete targets and the
+  written records, even when the apply fails) and every `useRecordValues`
+  naming one reads it again. New exports: `noteRecordChanged`,
+  `recordRevision`, `useRecordRevision`. Guard:
+  `__tests__/directive-record-values-g7.test.tsx` (2 red on 0.18.1).
+
+Consumer action: a host whose own writers change a record calls
+`noteRecordChanged(id)`; a host `readRecord` that shares in-flight reads keys
+them by `recordRevision(id)`, so a read started before a write is never handed
+to a reader asking after it.
+
 ## 0.18.1 — 2026-10-02
 
 - **An apply belongs to the block, not to the card that asked.** A note re-renders

package/dist/directives.cjs

@@ -38,13 +38,16 @@ __export(directives_exports, {
   getDirectiveRenderer: () => getDirectiveRenderer,
   itemChanges: () => itemChanges,
   itemRecordId: () => itemRecordId,
+  noteRecordChanged: () => noteRecordChanged,
   provisionalDirectiveSlug: () => provisionalDirectiveSlug,
   readsApplyLedger: () => readsApplyLedger,
   recordFallbackName: () => recordFallbackName,
+  recordRevision: () => recordRevision,
   registerDirectiveRenderer: () => registerDirectiveRenderer,
   resetDirectiveRenderers: () => resetDirectiveRenderers,
   useDirectiveHost: () => useDirectiveHost,
   useDirectiveScope: () => useDirectiveScope,
+  useRecordRevision: () => useRecordRevision,
   useRecordValues: () => useRecordValues
 });
 module.exports = __toCommonJS(directives_exports);
@@ -91,7 +94,7 @@ function resetDirectiveRenderers() {
 }
 
 // directives/ApplyDirectiveButton.tsx
-var import_react2 = require("react");
+var import_react3 = require("react");
 var import_content_ir2 = require("@ai-matrx/content-ir");
 
 // directives/item-changes.ts
@@ -170,6 +173,64 @@ function itemChanges(item, current, options = {}) {
   return out;
 }
 
+// directives/record-values.ts
+var import_react2 = require("react");
+var revisions = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Set();
+function recordRevision(id) {
+  return revisions.get(id) ?? 0;
+}
+function noteRecordChanged(id) {
+  if (!id) return;
+  revisions.set(id, recordRevision(id) + 1);
+  for (const listener of listeners) listener();
+}
+function subscribeRevisions(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+function useRecordRevision(id) {
+  return (0, import_react2.useSyncExternalStore)(
+    subscribeRevisions,
+    () => recordRevision(id),
+    () => 0
+  );
+}
+function useRecordValues(read, ref) {
+  const revision = useRecordRevision(ref?.id ?? "");
+  const key = ref && read ? `${ref.noun}:${ref.id}#${revision}` : "";
+  const [result, setResult] = (0, import_react2.useState)({
+    key: "",
+    values: null,
+    status: "idle"
+  });
+  (0, import_react2.useEffect)(() => {
+    if (!key || !read) return;
+    const split = key.indexOf(":");
+    const target = {
+      noun: key.slice(0, split),
+      id: key.slice(split + 1, key.lastIndexOf("#"))
+    };
+    let live = true;
+    setResult({ key, values: null, status: "loading" });
+    read(target).then((values) => {
+      if (!live) return;
+      setResult({ key, values, status: values ? "ready" : "unavailable" });
+    }).catch(() => {
+      if (!live) return;
+      setResult({ key, values: null, status: "unavailable" });
+    });
+    return () => {
+      live = false;
+    };
+  }, [key, read]);
+  if (!key) return { values: null, status: "idle" };
+  if (result.key !== key) return { values: null, status: "loading" };
+  return { values: result.values, status: result.status };
+}
+
 // directives/failure-words.ts
 var PAST = {
   create: "created",
@@ -289,6 +350,13 @@ function classIcon(directiveClass, noun) {
 
 // directives/ApplyDirectiveButton.tsx
 var import_jsx_runtime3 = require("react/jsx-runtime");
+function announceChangedRecords(directive, items) {
+  if (!TARGETING_CLASSES.has(directive.directiveClass)) return;
+  for (const item of items) {
+    const id = itemRecordId(item);
+    if (id) noteRecordChanged(id);
+  }
+}
 var applyOutcomes = /* @__PURE__ */ new WeakMap();
 var EMPTY_AUTHORITY = {};
 var outcomeListeners = /* @__PURE__ */ new Set();
@@ -311,7 +379,7 @@ function subscribeOutcomes(listener) {
   };
 }
 function useApplyOutcome(host, identity) {
-  return (0, import_react2.useSyncExternalStore)(
+  return (0, import_react3.useSyncExternalStore)(
     subscribeOutcomes,
     () => applyOutcomes.get(host)?.get(identity) ?? null,
     () => null
@@ -336,12 +404,12 @@ function ApplyDirectiveButton({
   const items = directive.items;
   const readsLedger = readsApplyLedger(host, directive);
   const initial = readsLedger ? { status: "checking" } : { status: "idle" };
-  const [state, setState] = (0, import_react2.useState)(initial);
-  const [elapsed, setElapsed] = (0, import_react2.useState)(0);
-  const [askingAgain, setAskingAgain] = (0, import_react2.useState)(false);
-  const startedAt = (0, import_react2.useRef)(null);
+  const [state, setState] = (0, import_react3.useState)(initial);
+  const [elapsed, setElapsed] = (0, import_react3.useState)(0);
+  const [askingAgain, setAskingAgain] = (0, import_react3.useState)(false);
+  const startedAt = (0, import_react3.useRef)(null);
   const identity = JSON.stringify([directive.slug, items, conversationId ?? null]);
-  const [stateFor, setStateFor] = (0, import_react2.useState)(identity);
+  const [stateFor, setStateFor] = (0, import_react3.useState)(identity);
   if (stateFor !== identity) {
     setStateFor(identity);
     setState(initial);
@@ -350,15 +418,15 @@ function ApplyDirectiveButton({
   }
   const shared = useApplyOutcome(host.confirm ?? EMPTY_AUTHORITY, identity);
   const view = state.status === "asking" || !shared ? state : shared;
-  const currentIdentity = (0, import_react2.useRef)(identity);
-  (0, import_react2.useEffect)(() => {
+  const currentIdentity = (0, import_react3.useRef)(identity);
+  (0, import_react3.useEffect)(() => {
     currentIdentity.current = identity;
   }, [identity]);
   const nounText = (0, import_content_ir2.nounLabel)(directive.noun, host.nouns);
   const shellKey = readsLedger ? JSON.stringify([directive.slug, items, conversationId ?? null]) : "";
   const read = host.applyState;
   const report = host.reportError;
-  (0, import_react2.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (!shellKey || !read) return;
     const [slug, shellItems, inConversation] = JSON.parse(shellKey);
     const shell = { __kind: slug, items: shellItems };
@@ -406,14 +474,14 @@ function ApplyDirectiveButton({
   const appliedClean = view.status === "applied" && view.failed === 0 ? view : null;
   const appliedBefore = appliedClean ? appliedClean.before : null;
   const phaseKey = view.status === "checking" || view.status === "finishing" ? "pending" : appliedClean ? `applied:${JSON.stringify(appliedBefore)}` : "open";
-  (0, import_react2.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (!onPhase) return;
     if (phaseKey === "pending") onPhase({ phase: "pending" });
     else if (phaseKey === "open") onPhase({ phase: "open" });
     else onPhase({ phase: "applied", before: appliedBefore });
   }, [phaseKey, onPhase, appliedBefore]);
   const applyingSince = view.status === "applying" ? view.startedAt : null;
-  (0, import_react2.useEffect)(() => {
+  (0, import_react3.useEffect)(() => {
     if (applyingSince === null) return;
     startedAt.current = applyingSince;
     const id = setInterval(
@@ -465,7 +533,13 @@ function ApplyDirectiveButton({
       const shell = { __kind: directive.slug, items };
       if (conversationId) shell.conversationId = conversationId;
       if (again) shell.force = true;
-      const result = await confirm(shell);
+      let result;
+      try {
+        result = await confirm(shell);
+      } finally {
+        announceChangedRecords(directive, items);
+      }
+      for (const record of result.records ?? []) noteRecordChanged(record.id);
       publishOutcome(confirm, askedFor, {
         status: "applied",
         applied: result.applied,
@@ -626,7 +700,7 @@ function FailureNotice({
   words,
   raw
 }) {
-  const [open, setOpen] = (0, import_react2.useState)(false);
+  const [open, setOpen] = (0, import_react3.useState)(false);
   const detail = raw?.trim() ?? "";
   return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { className: "flex min-w-0 flex-col gap-0.5", "data-apply-failure": true, children: [
     /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("span", { className: "min-w-0", children: [
@@ -659,39 +733,6 @@ function FailureNotice({
 // directives/SideEffectDirectiveCard.tsx
 var import_react4 = require("react");
 var import_content_ir3 = require("@ai-matrx/content-ir");
-
-// directives/record-values.ts
-var import_react3 = require("react");
-function useRecordValues(read, ref) {
-  const key = ref && read ? `${ref.noun}:${ref.id}` : "";
-  const [result, setResult] = (0, import_react3.useState)({
-    key: "",
-    values: null,
-    status: "idle"
-  });
-  (0, import_react3.useEffect)(() => {
-    if (!key || !read) return;
-    const split = key.indexOf(":");
-    const target = { noun: key.slice(0, split), id: key.slice(split + 1) };
-    let live = true;
-    setResult({ key, values: null, status: "loading" });
-    read(target).then((values) => {
-      if (!live) return;
-      setResult({ key, values, status: values ? "ready" : "unavailable" });
-    }).catch(() => {
-      if (!live) return;
-      setResult({ key, values: null, status: "unavailable" });
-    });
-    return () => {
-      live = false;
-    };
-  }, [key, read]);
-  if (!key) return { values: null, status: "idle" };
-  if (result.key !== key) return { values: null, status: "loading" };
-  return { values: result.values, status: result.status };
-}
-
-// directives/SideEffectDirectiveCard.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var ROWS_BEFORE_FOLD = 3;
 function ItemRow({