@plures/praxis 1.2.13 → 1.3.0

package/dist/node/index.js

@@ -21,7 +21,7 @@ import {
   formatValidationReportJSON,
   formatValidationReportSARIF,
   validateContracts
-} from "./chunk-5RH7UAQC.js";
+} from "./chunk-PTH6MD6P.js";
 import {
   defineContract,
   getContract,
@@ -50,7 +50,7 @@ import {
 import {
   ReactiveLogicEngine,
   createReactiveEngine
-} from "./chunk-PRPQO6R5.js";
+} from "./chunk-5JQJZADT.js";
 import {
   PraxisRegistry
 } from "./chunk-R2PSBPKQ.js";
@@ -78,8 +78,10 @@ import {
 import {
   LogicEngine,
   PRAXIS_PROTOCOL_VERSION,
-  createPraxisEngine
-} from "./chunk-VOMLVI6V.js";
+  RuleResult,
+  createPraxisEngine,
+  fact
+} from "./chunk-KMJWAFZV.js";
 import "./chunk-QGM4M3NI.js";
 
 // src/core/reactive-engine.ts
@@ -622,6 +624,53 @@ function createIntrospector(registry) {
   return new RegistryIntrospector(registry);
 }
 
+// src/core/chronicle/context.ts
+var ChronicleContext = class {
+  static _stack = [];
+  /**
+   * Get the current active span, if any.
+   */
+  static get current() {
+    return this._stack[this._stack.length - 1];
+  }
+  /**
+   * Run a synchronous function within a causal span.
+   * The span is automatically popped when the function returns.
+   */
+  static run(span, fn) {
+    this._stack.push(span);
+    try {
+      return fn();
+    } finally {
+      this._stack.pop();
+    }
+  }
+  /**
+   * Run an async function within a causal span.
+   * The span is popped after the promise settles.
+   */
+  static async runAsync(span, fn) {
+    this._stack.push(span);
+    try {
+      return await fn();
+    } finally {
+      this._stack.pop();
+    }
+  }
+  /**
+   * Create a child span that inherits the current contextId.
+   *
+   * @param spanId ID for the new span
+   * @returns A new ChronicleSpan with the current contextId
+   */
+  static childSpan(spanId) {
+    return {
+      spanId,
+      contextId: this.current?.contextId
+    };
+  }
+};
+
 // src/core/pluresdb/store.ts
 var PRAXIS_PATHS = {
   /** Base path for all Praxis data */
@@ -657,12 +706,32 @@ var PraxisDBStore = class {
   subscriptions = [];
   factWatchers = /* @__PURE__ */ new Map();
   onRuleError;
+  chronicle;
   constructor(options) {
     this.db = options.db;
     this.registry = options.registry;
     this.context = options.initialContext ?? {};
     this.onRuleError = options.onRuleError ?? defaultErrorHandler;
   }
+  /**
+   * Attach a Chronicle observer to this store.
+   *
+   * Every subsequent `storeFact` and `appendEvent` call will be recorded as a
+   * causal graph node in PluresDB, enabling full observability for free.
+   *
+   * @param chronicle Chronicle implementation to attach
+   * @returns `this` for fluent chaining
+   *
+   * @example
+   * ```typescript
+   * const store = createPraxisDBStore(db, registry)
+   *   .withChronicle(createChronicle(db));
+   * ```
+   */
+  withChronicle(chronicle) {
+    this.chronicle = chronicle;
+    return this;
+  }
   /**
    * Store a fact in PluresDB
    *
@@ -672,13 +741,37 @@ var PraxisDBStore = class {
    * @param fact The fact to store
    * @returns Promise that resolves when the fact is stored
    */
-  async storeFact(fact) {
-    const constraintResult = await this.checkConstraints([fact]);
+  async storeFact(fact2) {
+    const constraintResult = await this.checkConstraints([fact2]);
     if (!constraintResult.valid) {
       throw new Error(`Constraint violation: ${constraintResult.errors.join(", ")}`);
     }
-    await this.persistFact(fact);
-    await this.triggerRules([fact]);
+    let before;
+    if (this.chronicle) {
+      const payload = fact2.payload;
+      const id = payload?.id;
+      if (id) {
+        before = await this.getFact(fact2.tag, id);
+      }
+    }
+    await this.persistFact(fact2);
+    if (this.chronicle) {
+      const payload = fact2.payload;
+      const id = payload?.id ?? "";
+      const span = ChronicleContext.current;
+      try {
+        await this.chronicle.record({
+          path: getFactPath(fact2.tag, id),
+          before,
+          after: fact2,
+          cause: span?.spanId,
+          context: span?.contextId,
+          metadata: { factTag: fact2.tag, operation: "storeFact" }
+        });
+      } catch {
+      }
+    }
+    await this.triggerRules([fact2]);
   }
   /**
    * Store multiple facts in PluresDB
@@ -690,8 +783,32 @@ var PraxisDBStore = class {
     if (!constraintResult.valid) {
       throw new Error(`Constraint violation: ${constraintResult.errors.join(", ")}`);
     }
-    for (const fact of facts) {
-      await this.persistFact(fact);
+    for (const fact2 of facts) {
+      let before;
+      if (this.chronicle) {
+        const payload = fact2.payload;
+        const id = payload?.id;
+        if (id) {
+          before = await this.getFact(fact2.tag, id);
+        }
+      }
+      await this.persistFact(fact2);
+      if (this.chronicle) {
+        const payload = fact2.payload;
+        const id = payload?.id ?? "";
+        const span = ChronicleContext.current;
+        try {
+          await this.chronicle.record({
+            path: getFactPath(fact2.tag, id),
+            before,
+            after: fact2,
+            cause: span?.spanId,
+            context: span?.contextId,
+            metadata: { factTag: fact2.tag, operation: "storeFacts" }
+          });
+        } catch {
+        }
+      }
     }
     await this.triggerRules(facts);
   }
@@ -699,11 +816,11 @@ var PraxisDBStore = class {
    * Internal method to persist a fact without constraint checking
    * Used by both storeFact and derived fact storage
    */
-  async persistFact(fact) {
-    const payload = fact.payload;
+  async persistFact(fact2) {
+    const payload = fact2.payload;
     const id = payload?.id ?? generateId();
-    const path = getFactPath(fact.tag, id);
-    await this.db.set(path, fact);
+    const path = getFactPath(fact2.tag, id);
+    await this.db.set(path, fact2);
   }
   /**
    * Get a fact by tag and id
@@ -733,7 +850,29 @@ var PraxisDBStore = class {
     };
     const newEvents = [...existingEvents, entry];
     await this.db.set(path, newEvents);
-    await this.triggerRulesForEvents([event]);
+    let eventNodeId;
+    if (this.chronicle) {
+      const span = ChronicleContext.current;
+      try {
+        const node = await this.chronicle.record({
+          path,
+          before: existingEvents.length > 0 ? existingEvents[existingEvents.length - 1] : void 0,
+          after: entry,
+          cause: span?.spanId,
+          context: span?.contextId,
+          metadata: { eventTag: event.tag, sequence: String(entry.sequence), operation: "appendEvent" }
+        });
+        eventNodeId = node.id;
+      } catch {
+      }
+    }
+    const outerSpan = ChronicleContext.current;
+    const ruleSpan = eventNodeId ? { spanId: eventNodeId, contextId: outerSpan?.contextId } : outerSpan;
+    if (ruleSpan && this.chronicle) {
+      await ChronicleContext.runAsync(ruleSpan, () => this.triggerRulesForEvents([event]));
+    } else {
+      await this.triggerRulesForEvents([event]);
+    }
   }
   /**
    * Append multiple events to their respective streams
@@ -746,6 +885,7 @@ var PraxisDBStore = class {
       const existing = eventsByTag.get(event.tag) ?? [];
       eventsByTag.set(event.tag, [...existing, event]);
     }
+    let lastEventNodeId;
     for (const [tag, tagEvents] of eventsByTag) {
       const path = getEventPath(tag);
       const existingEvents = await this.db.get(path) ?? [];
@@ -756,8 +896,30 @@ var PraxisDBStore = class {
         sequence: sequence++
       }));
       await this.db.set(path, [...existingEvents, ...newEntries]);
+      if (this.chronicle) {
+        const span = ChronicleContext.current;
+        for (const entry of newEntries) {
+          try {
+            const node = await this.chronicle.record({
+              path,
+              after: entry,
+              cause: span?.spanId,
+              context: span?.contextId,
+              metadata: { eventTag: tag, sequence: String(entry.sequence), operation: "appendEvents" }
+            });
+            lastEventNodeId = node.id;
+          } catch {
+          }
+        }
+      }
+    }
+    const outerSpan = ChronicleContext.current;
+    const ruleSpan = lastEventNodeId ? { spanId: lastEventNodeId, contextId: outerSpan?.contextId } : outerSpan;
+    if (ruleSpan && this.chronicle) {
+      await ChronicleContext.runAsync(ruleSpan, () => this.triggerRulesForEvents(events));
+    } else {
+      await this.triggerRulesForEvents(events);
     }
-    await this.triggerRulesForEvents(events);
   }
   /**
    * Get events from a stream
@@ -795,8 +957,8 @@ var PraxisDBStore = class {
     if (watchers) {
       watchers.add(callback);
     }
-    const unsubscribe = this.db.watch(path, (fact) => {
-      callback([fact]);
+    const unsubscribe = this.db.watch(path, (fact2) => {
+      callback([fact2]);
     });
     this.subscriptions.push(unsubscribe);
     return () => {
@@ -854,13 +1016,18 @@ var PraxisDBStore = class {
     const state = {
       context: this.context,
       facts: [],
+      events,
       meta: {}
     };
     const derivedFacts = [];
     for (const rule of rules) {
       try {
-        const facts = rule.impl(state, events);
-        derivedFacts.push(...facts);
+        const result = rule.impl(state, events);
+        if (Array.isArray(result)) {
+          derivedFacts.push(...result);
+        } else if (result && "kind" in result && result.kind === "emit") {
+          derivedFacts.push(...result.facts);
+        }
       } catch (error) {
         this.onRuleError(rule.id, error);
       }
@@ -868,8 +1035,23 @@ var PraxisDBStore = class {
     if (derivedFacts.length > 0) {
       const constraintResult = await this.checkConstraints(derivedFacts);
       if (constraintResult.valid) {
-        for (const fact of derivedFacts) {
-          await this.persistFact(fact);
+        for (const fact2 of derivedFacts) {
+          await this.persistFact(fact2);
+          if (this.chronicle) {
+            const payload = fact2.payload;
+            const id = payload?.id ?? "";
+            const span = ChronicleContext.current;
+            try {
+              await this.chronicle.record({
+                path: getFactPath(fact2.tag, id),
+                after: fact2,
+                cause: span?.spanId,
+                context: span?.contextId,
+                metadata: { factTag: fact2.tag, operation: "derivedFact" }
+              });
+            } catch {
+            }
+          }
         }
       }
     }
@@ -989,6 +1171,156 @@ function createSchemaRegistry(db) {
   return new PraxisSchemaRegistry(db);
 }
 
+// src/core/chronicle/chronicle.ts
+var CHRONICLE_PATHS = {
+  BASE: "/_praxis/chronos",
+  NODES: "/_praxis/chronos/nodes",
+  EDGES_OUT: "/_praxis/chronos/edges/out",
+  EDGES_IN: "/_praxis/chronos/edges/in",
+  CONTEXT: "/_praxis/chronos/context",
+  INDEX: "/_praxis/chronos/index"
+};
+var _nodeCounter = 0;
+var PluresDbChronicle = class {
+  db;
+  constructor(db) {
+    this.db = db;
+  }
+  async record(event) {
+    const timestamp = Date.now();
+    const id = `chronos:${timestamp}-${++_nodeCounter}`;
+    const node = { id, timestamp, event };
+    await this.db.set(`${CHRONICLE_PATHS.NODES}/${id}`, node);
+    const index = await this.db.get(CHRONICLE_PATHS.INDEX) ?? [];
+    await this.db.set(CHRONICLE_PATHS.INDEX, [...index, id]);
+    if (event.cause) {
+      await this.addEdge(event.cause, id, "causes");
+    }
+    if (event.context) {
+      const contextPath = `${CHRONICLE_PATHS.CONTEXT}/${event.context}`;
+      const contextNodes = await this.db.get(contextPath) ?? [];
+      if (contextNodes.length > 0) {
+        const prevId = contextNodes[contextNodes.length - 1];
+        await this.addEdge(prevId, id, "follows");
+      }
+      await this.db.set(contextPath, [...contextNodes, id]);
+    }
+    return node;
+  }
+  async trace(nodeId, direction, maxDepth) {
+    const visited = /* @__PURE__ */ new Set();
+    const result = [];
+    await this._traceRecursive(nodeId, direction, maxDepth, 0, visited, result);
+    return result;
+  }
+  async range(start, end) {
+    const index = await this.db.get(CHRONICLE_PATHS.INDEX) ?? [];
+    const result = [];
+    for (const id of index) {
+      const node = await this.db.get(`${CHRONICLE_PATHS.NODES}/${id}`);
+      if (node && node.timestamp >= start && node.timestamp <= end) {
+        result.push(node);
+      }
+    }
+    return result;
+  }
+  async subgraph(contextId) {
+    const contextPath = `${CHRONICLE_PATHS.CONTEXT}/${contextId}`;
+    const nodeIds = await this.db.get(contextPath) ?? [];
+    const result = [];
+    for (const id of nodeIds) {
+      const node = await this.db.get(`${CHRONICLE_PATHS.NODES}/${id}`);
+      if (node) {
+        result.push(node);
+      }
+    }
+    return result;
+  }
+  // ── Internal helpers ──────────────────────────────────────────────────────
+  async addEdge(from, to, type) {
+    const edge = { from, to, type };
+    const outPath = `${CHRONICLE_PATHS.EDGES_OUT}/${from}`;
+    const outEdges = await this.db.get(outPath) ?? [];
+    await this.db.set(outPath, [...outEdges, edge]);
+    const inPath = `${CHRONICLE_PATHS.EDGES_IN}/${to}`;
+    const inEdges = await this.db.get(inPath) ?? [];
+    await this.db.set(inPath, [...inEdges, edge]);
+  }
+  async _traceRecursive(nodeId, direction, maxDepth, depth, visited, result) {
+    if (depth > maxDepth || visited.has(nodeId)) {
+      return;
+    }
+    visited.add(nodeId);
+    const node = await this.db.get(`${CHRONICLE_PATHS.NODES}/${nodeId}`);
+    if (node) {
+      result.push(node);
+    }
+    if (direction === "backward" || direction === "both") {
+      const inEdges = await this.db.get(`${CHRONICLE_PATHS.EDGES_IN}/${nodeId}`) ?? [];
+      for (const edge of inEdges) {
+        await this._traceRecursive(edge.from, direction, maxDepth, depth + 1, visited, result);
+      }
+    }
+    if (direction === "forward" || direction === "both") {
+      const outEdges = await this.db.get(`${CHRONICLE_PATHS.EDGES_OUT}/${nodeId}`) ?? [];
+      for (const edge of outEdges) {
+        await this._traceRecursive(edge.to, direction, maxDepth, depth + 1, visited, result);
+      }
+    }
+  }
+};
+function createChronicle(db) {
+  return new PluresDbChronicle(db);
+}
+
+// src/core/chronicle/mcp.ts
+function createChronosMcpTools(chronicle) {
+  return {
+    async trace(params) {
+      try {
+        const nodes = await chronicle.trace(
+          params.nodeId,
+          params.direction ?? "backward",
+          params.maxDepth ?? 10
+        );
+        return { success: true, data: nodes };
+      } catch (error) {
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    },
+    async search(params) {
+      try {
+        const query = params.query.toLowerCase();
+        let candidates;
+        if (params.contextId) {
+          candidates = await chronicle.subgraph(params.contextId);
+        } else {
+          candidates = await chronicle.range(params.since ?? 0, params.until ?? Date.now());
+        }
+        const filtered = candidates.filter((node) => {
+          const inPath = node.event.path.toLowerCase().includes(query);
+          const inMeta = Object.values(node.event.metadata).some(
+            (v) => v.toLowerCase().includes(query)
+          );
+          const inAfter = JSON.stringify(node.event.after ?? "").toLowerCase().includes(query);
+          const inBefore = JSON.stringify(node.event.before ?? "").toLowerCase().includes(query);
+          return inPath || inMeta || inAfter || inBefore;
+        });
+        const limited = params.limit !== void 0 ? filtered.slice(0, params.limit) : filtered;
+        return { success: true, data: limited };
+      } catch (error) {
+        return {
+          success: false,
+          error: error instanceof Error ? error.message : String(error)
+        };
+      }
+    }
+  };
+}
+
 // src/integrations/pluresdb.ts
 function createPluresDBAdapter(options) {
   const store = createPraxisDBStore(options.db, options.registry, options.initialContext);
@@ -1154,7 +1486,7 @@ async function createUnumAdapter(config) {
       type: "event"
     });
   }
-  async function broadcastFact(channelId, fact) {
+  async function broadcastFact(channelId, fact2) {
     const channel = channels.get(channelId);
     if (!channel) {
       throw new Error(`Not joined to channel ${channelId}`);
@@ -1162,7 +1494,7 @@ async function createUnumAdapter(config) {
     await channel.publish({
       id: generateId2(),
       sender: currentIdentity || { id: "anonymous", createdAt: Date.now() },
-      content: fact,
+      content: fact2,
       type: "fact"
     });
   }
@@ -1443,7 +1775,7 @@ function generateTauriConfig(config) {
 
 // src/integrations/unified.ts
 async function createUnifiedApp(config) {
-  const { createPraxisEngine: createPraxisEngine2 } = await import("./engine-2DQBKBJC.js");
+  const { createPraxisEngine: createPraxisEngine2 } = await import("./engine-FEN5IYZ5.js");
   const { createInMemoryDB: createInMemoryDB2 } = await import("./adapter-75ISSMWD.js");
   const db = config.db || createInMemoryDB2();
   const pluresdb = createPluresDBAdapter({
@@ -1572,10 +1904,304 @@ async function attachAllIntegrations(engine, registry, options = {}) {
     }
   };
 }
+
+// src/core/ui-rules.ts
+var loadingGateRule = {
+  id: "ui/loading-gate",
+  description: "Signals when the app is in a loading state",
+  eventTypes: ["ui.state-change", "app.init"],
+  impl: (state) => {
+    const ctx = state.context;
+    if (ctx.loading) {
+      return RuleResult.emit([fact("ui.loading-gate", { active: true })]);
+    }
+    return RuleResult.retract(["ui.loading-gate"], "Not loading");
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Emits ui.loading-gate when context.loading is true, retracts when false",
+    examples: [
+      { given: "loading is true", when: "ui state changes", then: "ui.loading-gate emitted" },
+      { given: "loading is false", when: "ui state changes", then: "ui.loading-gate retracted" }
+    ],
+    invariants: ["Loading gate must reflect context.loading exactly"]
+  }
+};
+var errorDisplayRule = {
+  id: "ui/error-display",
+  description: "Signals when an error should be displayed to the user",
+  eventTypes: ["ui.state-change", "app.error"],
+  impl: (state) => {
+    const ctx = state.context;
+    if (ctx.error) {
+      return RuleResult.emit([fact("ui.error-display", { message: ctx.error, severity: "error" })]);
+    }
+    return RuleResult.retract(["ui.error-display"], "Error cleared");
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Emits ui.error-display when context.error is non-null, retracts when cleared",
+    examples: [
+      { given: "error is set", when: "ui state changes", then: "ui.error-display emitted with message" },
+      { given: "error is null", when: "ui state changes", then: "ui.error-display retracted" }
+    ],
+    invariants: ["Error display must clear when error is null"]
+  }
+};
+var offlineIndicatorRule = {
+  id: "ui/offline-indicator",
+  description: "Signals when the app is offline",
+  eventTypes: ["ui.state-change", "network.change"],
+  impl: (state) => {
+    if (state.context.offline) {
+      return RuleResult.emit([fact("ui.offline", { message: "You are offline. Changes will sync when reconnected." })]);
+    }
+    return RuleResult.retract(["ui.offline"], "Back online");
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Emits ui.offline when context.offline is true, retracts when back online",
+    examples: [
+      { given: "offline is true", when: "network changes", then: "ui.offline emitted" },
+      { given: "offline is false", when: "network changes", then: "ui.offline retracted" }
+    ],
+    invariants: ["Offline indicator must match actual connectivity"]
+  }
+};
+var dirtyGuardRule = {
+  id: "ui/dirty-guard",
+  description: "Warns when there are unsaved changes",
+  eventTypes: ["ui.state-change", "navigation.request"],
+  impl: (state) => {
+    if (state.context.dirty) {
+      return RuleResult.emit([fact("ui.unsaved-warning", {
+        message: "You have unsaved changes",
+        blocking: true
+      })]);
+    }
+    return RuleResult.retract(["ui.unsaved-warning"], "No unsaved changes");
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Emits ui.unsaved-warning when context.dirty is true, retracts when saved",
+    examples: [
+      { given: "dirty is true", when: "ui state changes", then: "ui.unsaved-warning emitted with blocking=true" },
+      { given: "dirty is false", when: "ui state changes", then: "ui.unsaved-warning retracted" }
+    ],
+    invariants: ["Dirty guard must clear after save"]
+  }
+};
+var initGateRule = {
+  id: "ui/init-gate",
+  description: "Signals whether the app has completed initialization",
+  eventTypes: ["ui.state-change", "app.init"],
+  impl: (state) => {
+    if (!state.context.initialized) {
+      return RuleResult.emit([fact("ui.init-pending", {
+        message: "App is initializing..."
+      })]);
+    }
+    return RuleResult.retract(["ui.init-pending"], "App initialized");
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Emits ui.init-pending until context.initialized is true",
+    examples: [
+      { given: "initialized is false", when: "app starts", then: "ui.init-pending emitted" },
+      { given: "initialized is true", when: "init completes", then: "ui.init-pending retracted" }
+    ],
+    invariants: ["Init gate must clear exactly once, when initialization completes"]
+  }
+};
+var viewportRule = {
+  id: "ui/viewport-class",
+  description: "Classifies viewport size for responsive layout decisions",
+  eventTypes: ["ui.state-change", "ui.resize"],
+  impl: (state) => {
+    const vp = state.context.viewport;
+    if (!vp) return RuleResult.skip("No viewport data");
+    return RuleResult.emit([fact("ui.viewport-class", {
+      viewport: vp,
+      compact: vp === "mobile",
+      showSidebar: vp !== "mobile"
+    })]);
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Classifies viewport into responsive layout hints",
+    examples: [
+      { given: "viewport is mobile", when: "resize event", then: "compact=true, showSidebar=false" },
+      { given: "viewport is desktop", when: "resize event", then: "compact=false, showSidebar=true" }
+    ],
+    invariants: ["Viewport class must update on every resize event"]
+  }
+};
+var noInteractionWhileLoadingConstraint = {
+  id: "ui/no-interaction-while-loading",
+  description: "Prevents data mutations while a load operation is in progress",
+  impl: (state) => {
+    if (state.context.loading) {
+      return "Cannot perform action while data is loading";
+    }
+    return true;
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Fails when context.loading is true",
+    examples: [
+      { given: "loading is true", when: "action attempted", then: "violation" },
+      { given: "loading is false", when: "action attempted", then: "pass" }
+    ],
+    invariants: ["Must always fail during loading"]
+  }
+};
+var mustBeInitializedConstraint = {
+  id: "ui/must-be-initialized",
+  description: "Requires app initialization before user interactions",
+  impl: (state) => {
+    if (!state.context.initialized) {
+      return "App must be initialized before performing this action";
+    }
+    return true;
+  },
+  contract: {
+    ruleId: "RULE_ID_PLACEHOLDER",
+    behavior: "Fails when context.initialized is false",
+    examples: [
+      { given: "initialized is false", when: "action attempted", then: "violation" },
+      { given: "initialized is true", when: "action attempted", then: "pass" }
+    ],
+    invariants: ["Must always fail before init completes"]
+  }
+};
+var uiModule = {
+  rules: [
+    loadingGateRule,
+    errorDisplayRule,
+    offlineIndicatorRule,
+    dirtyGuardRule,
+    initGateRule,
+    viewportRule
+  ],
+  constraints: [
+    noInteractionWhileLoadingConstraint,
+    mustBeInitializedConstraint
+  ],
+  meta: {
+    name: "praxis-ui",
+    version: "1.0.0",
+    description: "Predefined UI rules and constraints \u2014 separate from business logic"
+  }
+};
+function createUIModule(options) {
+  const allRules = uiModule.rules;
+  const allConstraints = uiModule.constraints;
+  const selectedRules = options.rules ? allRules.filter((r) => options.rules.includes(r.id)) : allRules;
+  const selectedConstraints = options.constraints ? allConstraints.filter((c) => options.constraints.includes(c.id)) : allConstraints;
+  return {
+    rules: [...selectedRules, ...options.extraRules ?? []],
+    constraints: [...selectedConstraints, ...options.extraConstraints ?? []],
+    meta: { ...uiModule.meta, customized: true }
+  };
+}
+function uiStateChanged(changes) {
+  return { tag: "ui.state-change", payload: changes ?? {} };
+}
+function navigationRequest(to) {
+  return { tag: "navigation.request", payload: { to } };
+}
+function resizeEvent(width, height) {
+  return { tag: "ui.resize", payload: { width, height } };
+}
+
+// src/core/completeness.ts
+function auditCompleteness(manifest, registryRuleIds, registryConstraintIds, rulesWithContracts, config) {
+  const threshold = config?.threshold ?? 90;
+  const domainBranches = manifest.branches.filter((b) => b.kind === "domain");
+  const coveredDomain = domainBranches.filter((b) => b.coveredBy && registryRuleIds.includes(b.coveredBy));
+  const uncoveredDomain = domainBranches.filter((b) => !b.coveredBy || !registryRuleIds.includes(b.coveredBy));
+  const invariantBranches = manifest.branches.filter((b) => b.kind === "invariant");
+  const coveredInvariants = invariantBranches.filter((b) => b.coveredBy && registryConstraintIds.includes(b.coveredBy));
+  const uncoveredInvariants = invariantBranches.filter((b) => !b.coveredBy || !registryConstraintIds.includes(b.coveredBy));
+  const needContracts = manifest.rulesNeedingContracts;
+  const haveContracts = needContracts.filter((id) => rulesWithContracts.includes(id));
+  const missingContracts = needContracts.filter((id) => !rulesWithContracts.includes(id));
+  const neededFields = manifest.stateFields.filter((f) => f.usedByRule);
+  const coveredFields = neededFields.filter((f) => f.inContext);
+  const missingFields = neededFields.filter((f) => !f.inContext);
+  const coveredTransitions = manifest.transitions.filter((t) => t.eventTag);
+  const missingTransitions = manifest.transitions.filter((t) => !t.eventTag);
+  const ruleScore = domainBranches.length > 0 ? coveredDomain.length / domainBranches.length * 40 : 40;
+  const constraintScore = invariantBranches.length > 0 ? coveredInvariants.length / invariantBranches.length * 20 : 20;
+  const contractScore = needContracts.length > 0 ? haveContracts.length / needContracts.length * 15 : 15;
+  const contextScore = neededFields.length > 0 ? coveredFields.length / neededFields.length * 15 : 15;
+  const eventScore = manifest.transitions.length > 0 ? coveredTransitions.length / manifest.transitions.length * 10 : 10;
+  const score = Math.round(ruleScore + constraintScore + contractScore + contextScore + eventScore);
+  const rating = score >= 90 ? "complete" : score >= 70 ? "good" : score >= 50 ? "partial" : "incomplete";
+  const report = {
+    score,
+    rating,
+    rules: { total: domainBranches.length, covered: coveredDomain.length, uncovered: uncoveredDomain },
+    constraints: { total: invariantBranches.length, covered: coveredInvariants.length, uncovered: uncoveredInvariants },
+    contracts: { total: needContracts.length, withContracts: haveContracts.length, missing: missingContracts },
+    context: { total: neededFields.length, covered: coveredFields.length, missing: missingFields },
+    events: { total: manifest.transitions.length, covered: coveredTransitions.length, missing: missingTransitions }
+  };
+  if (config?.strict && score < threshold) {
+    throw new Error(`Praxis completeness ${score}/100 (${rating}) \u2014 below threshold ${threshold}. ${uncoveredDomain.length} uncovered rules, ${uncoveredInvariants.length} uncovered invariants, ${missingContracts.length} missing contracts.`);
+  }
+  return report;
+}
+function formatReport(report) {
+  const lines = [];
+  const icon = report.rating === "complete" ? "\u2705" : report.rating === "good" ? "\u{1F7E2}" : report.rating === "partial" ? "\u{1F7E1}" : "\u{1F534}";
+  lines.push(`${icon} Praxis Completeness: ${report.score}/100 (${report.rating})`);
+  lines.push("");
+  lines.push(`Rules:       ${report.rules.covered}/${report.rules.total} domain branches covered (${pct(report.rules.covered, report.rules.total)})`);
+  lines.push(`Constraints: ${report.constraints.covered}/${report.constraints.total} invariants covered (${pct(report.constraints.covered, report.constraints.total)})`);
+  lines.push(`Contracts:   ${report.contracts.withContracts}/${report.contracts.total} rules have contracts (${pct(report.contracts.withContracts, report.contracts.total)})`);
+  lines.push(`Context:     ${report.context.covered}/${report.context.total} state fields in context (${pct(report.context.covered, report.context.total)})`);
+  lines.push(`Events:      ${report.events.covered}/${report.events.total} transitions have events (${pct(report.events.covered, report.events.total)})`);
+  if (report.rules.uncovered.length > 0) {
+    lines.push("");
+    lines.push("Uncovered domain logic:");
+    for (const b of report.rules.uncovered) {
+      lines.push(`  \u274C ${b.location}: ${b.condition}${b.note ? ` \u2014 ${b.note}` : ""}`);
+    }
+  }
+  if (report.constraints.uncovered.length > 0) {
+    lines.push("");
+    lines.push("Uncovered invariants:");
+    for (const b of report.constraints.uncovered) {
+      lines.push(`  \u274C ${b.location}: ${b.condition}${b.note ? ` \u2014 ${b.note}` : ""}`);
+    }
+  }
+  if (report.contracts.missing.length > 0) {
+    lines.push("");
+    lines.push("Rules missing contracts:");
+    for (const id of report.contracts.missing) {
+      lines.push(`  \u{1F4DD} ${id}`);
+    }
+  }
+  if (report.events.missing.length > 0) {
+    lines.push("");
+    lines.push("State transitions without events:");
+    for (const t of report.events.missing) {
+      lines.push(`  \u26A1 ${t.location}: ${t.description}`);
+    }
+  }
+  return lines.join("\n");
+}
+function pct(a, b) {
+  if (b === 0) return "100%";
+  return Math.round(a / b * 100) + "%";
+}
 export {
   AcknowledgeContractGap,
   ActorManager,
   BehaviorLedger,
+  CHRONICLE_PATHS,
+  ChronicleContext,
   ContractAdded,
   ContractGapAcknowledged,
   ContractMissing,
@@ -1588,11 +2214,13 @@ export {
   PRAXIS_PROTOCOL_VERSION,
   PluresDBGenerator,
   PluresDBPraxisAdapter,
+  PluresDbChronicle,
   PraxisDBStore,
   PraxisRegistry,
   PraxisSchemaRegistry,
   ReactiveLogicEngine,
   RegistryIntrospector,
+  RuleResult,
   StateDocsGenerator,
   TerminalAdapter,
   ValidateContracts,
@@ -1600,11 +2228,14 @@ export {
   attachTauriToEngine,
   attachToEngine,
   attachUnumToEngine,
+  auditCompleteness,
   canvasToMermaid,
   canvasToSchema,
   canvasToYaml,
   createBehaviorLedger,
   createCanvasEditor,
+  createChronicle,
+  createChronosMcpTools,
   createReactiveEngine2 as createFrameworkAgnosticReactiveEngine,
   createInMemoryDB,
   createIntrospector,
@@ -1623,6 +2254,7 @@ export {
   createTauriPraxisAdapter,
   createTerminalAdapter,
   createTimerActor,
+  createUIModule,
   createUnifiedApp,
   createUnumAdapter,
   defineConstraint,
@@ -1631,10 +2263,14 @@ export {
   defineFact,
   defineModule,
   defineRule,
+  dirtyGuardRule,
+  errorDisplayRule,
+  fact,
   filterEvents,
   filterFacts,
   findEvent,
   findFact,
+  formatReport,
   formatValidationReport,
   formatValidationReportJSON,
   formatValidationReportSARIF,
@@ -1645,16 +2281,26 @@ export {
   getEventPath,
   getFactPath,
   getSchemaPath,
+  initGateRule,
   isContract,
   loadSchema,
   loadSchemaFromFile,
   loadSchemaFromJson,
   loadSchemaFromYaml,
+  loadingGateRule,
+  mustBeInitializedConstraint,
+  navigationRequest,
+  noInteractionWhileLoadingConstraint,
+  offlineIndicatorRule,
   registerSchema,
+  resizeEvent,
   runTerminalCommand,
   schemaToCanvas,
+  uiModule,
+  uiStateChanged,
   validateContracts,
   validateForGeneration,
   validateSchema,
-  validateWithGuardian
+  validateWithGuardian,
+  viewportRule
 };