@directive-run/knowledge 1.14.0 → 1.16.0

package/examples/counter-svelte.ts

@@ -49,7 +49,7 @@ export const counterModule = createModule("counter", {
   resolvers: {
     clamp: {
       requirement: "CLAMP_TO_ZERO",
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         context.facts.count = 0;
       },
     },

package/examples/counter-vue.ts

@@ -49,7 +49,7 @@ export const counterModule = createModule("counter", {
   resolvers: {
     clamp: {
       requirement: "CLAMP_TO_ZERO",
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         context.facts.count = 0;
       },
     },

package/examples/counter.ts

@@ -69,7 +69,7 @@ export const counterModule = createModule("counter", {
   resolvers: {
     clamp: {
       requirement: "CLAMP_TO_ZERO",
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         context.facts.count = 0;
       },
     },

package/examples/data-triggers.ts

@@ -98,10 +98,10 @@ const trafficLight = createModule("traffic", {
     transition: {
       requirement: "TRANSITION",
       key: ["to"],
-      resolve: async (req, ctx) => {
-        ctx.facts.phase = req.to;
-        ctx.facts.elapsed = 0;
-        ctx.facts.transitionCount = ctx.facts.transitionCount + 1;
+      resolve: async (req, context) => {
+        context.facts.phase = req.to;
+        context.facts.elapsed = 0;
+        context.facts.transitionCount = context.facts.transitionCount + 1;
       },
     },
   },

package/examples/feature-flags.ts

@@ -162,14 +162,14 @@ export const featureFlagsModule = createModule("feature-flags", {
   resolvers: {
     enableBrandSwitcher: {
       requirement: "ENABLE_BRAND_SWITCHER",
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         context.facts.brandSwitcherEnabled = true;
       },
     },
 
     logMaintenanceWarning: {
       requirement: "LOG_MAINTENANCE_WARNING",
-      resolve: async (req, context) => {
+      resolve: async (_req, _context) => {
         console.warn(
           "[feature-flags] Maintenance mode is active. Chat, search, playground, and vote API are disabled.",
         );

package/examples/form-wizard.ts

@@ -227,7 +227,7 @@ export const wizardModule = createModule("wizard", {
   resolvers: {
     advanceStep: {
       requirement: "ADVANCE_STEP",
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         context.facts.currentStep = context.facts.currentStep + 1;
         context.facts.advanceRequested = false;
       },
@@ -236,7 +236,7 @@ export const wizardModule = createModule("wizard", {
     submitForm: {
       requirement: "SUBMIT_FORM",
       timeout: 10000,
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         // Simulate API submission
         await new Promise((resolve) => setTimeout(resolve, 800));
         context.facts.submitted = true;

package/examples/newsletter.ts

@@ -151,7 +151,7 @@ const newsletter = createModule("newsletter", {
     // Simulated submission — no API account needed
     subscribe: {
       requirement: "SUBSCRIBE",
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         addLog(`Subscribing: ${context.facts.email}`);
 
         // Simulate network delay
@@ -175,7 +175,7 @@ const newsletter = createModule("newsletter", {
 
     resetAfterDelay: {
       requirement: "RESET_AFTER_DELAY",
-      resolve: async (req, context) => {
+      resolve: async (_req, context) => {
         addLog("Auto-resetting in 5 seconds...");
         await new Promise((resolve) => setTimeout(resolve, 5000));
         context.facts.email = "";

package/examples/server.ts

@@ -109,7 +109,7 @@ app.get("/snapshot/:userId", async (req, res) => {
     snapshotCache.set(userId, { snapshot, cachedAt: Date.now() });
 
     res.json({ source: "fresh", snapshot });
-  } catch (error) {
+  } catch (_error) {
     res.status(500).json({ error: "Failed to settle system" });
   } finally {
     system.destroy();
@@ -162,7 +162,7 @@ app.post("/snapshot/:userId/verify", async (req, res) => {
         signedSnapshot: signed,
       });
     }
-  } catch (error) {
+  } catch (_error) {
     res.status(500).json({ error: "Verification failed" });
   } finally {
     system.destroy();

package/examples/shopping-cart.ts

@@ -193,7 +193,7 @@ export const cartModule = createModule("cart", {
       return sub * (facts.self.couponDiscount / 100);
     },
 
-    tax: (facts, derived) => {
+    tax: (_facts, derived) => {
       const sub = derived.subtotal;
       const disc = derived.discount;
 

package/examples/topic-guard.ts

@@ -106,7 +106,7 @@ export const topicGuardModule = createModule("topic-guard", {
         .length;
     },
 
-    blockRate: (facts, derived) => {
+    blockRate: (_facts, derived) => {
       const total = derived.messageCount;
       if (total === 0) {
         return "0%";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@directive-run/knowledge",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "description": "Knowledge files, examples, and validation for Directive — the constraint-driven TypeScript runtime.",
   "license": "(MIT OR Apache-2.0)",
   "author": "Jason Comes",
@@ -51,8 +51,8 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.2",
     "vitest": "^3.0.0",
-    "@directive-run/core": "1.14.0",
-    "@directive-run/ai": "1.14.0"
+    "@directive-run/core": "1.16.0",
+    "@directive-run/ai": "1.16.0"
   },
   "scripts": {
     "build": "tsx scripts/generate-api-skeleton.ts && tsx scripts/generate-sitemap.ts && tsx scripts/extract-examples.ts && tsup",

package/sitemap.md

@@ -64,18 +64,15 @@ Website: https://directive.run
 - [Error Boundaries](https://directive.run/docs/advanced/errors)
 - [Definition Meta](https://directive.run/docs/advanced/meta)
 
-### Analysis & Tooling
-- [Predicate Backtest (replay-under)](https://directive.run/docs/replay-under)
-- [Parameter Sweep (tune)](https://directive.run/docs/tune)
-- [Rules Diff](https://directive.run/docs/rules-diff)
+### Predicate Tools
+- [predicateFromIntent (LLM emit)](https://directive.run/docs/predicate-from-intent)
+- [describePredicate (prose)](https://directive.run/docs/describe-predicate)
 - [Predicate Codegen (SQL/Mongo/PostgREST)](https://directive.run/docs/predicate-codegen)
 - [predict()](https://directive.run/docs/predict)
 - [doctor.checkAgainst()](https://directive.run/docs/doctor)
-- [describePredicate (prose)](https://directive.run/docs/describe-predicate)
-
-### LLM Integration
-- [predicateFromIntent](https://directive.run/docs/predicate-from-intent)
-- [Audit Ledger](https://directive.run/docs/audit-ledger)
+- [Predicate Backtest (replay-under)](https://directive.run/docs/replay-under)
+- [Parameter Sweep (tune)](https://directive.run/docs/tune)
+- [Rules Diff](https://directive.run/docs/rules-diff)
 
 ### Plugins
 - [Overview](https://directive.run/docs/plugins/overview)
@@ -85,9 +82,18 @@ Website: https://directive.run
 - [Persistence](https://directive.run/docs/plugins/persistence)
 - [Performance](https://directive.run/docs/plugins/performance)
 - [Circuit Breaker](https://directive.run/docs/plugins/circuit-breaker)
+- [Audit Ledger](https://directive.run/docs/audit-ledger)
 - [Observability](https://directive.run/docs/plugins/observability)
 - [Custom Plugins](https://directive.run/docs/plugins/custom)
 
+### Packages
+- [Timeline (test REPL)](https://directive.run/docs/packages/timeline)
+- [Mutator (typed mutations)](https://directive.run/docs/packages/mutator)
+- [Optimistic (auto-rollback)](https://directive.run/docs/packages/optimistic)
+- [Query (data fetching)](https://directive.run/docs/packages/query)
+- [Vite Dev Proxy](https://directive.run/docs/packages/vite-dev-proxy)
+- [Composing all four](https://directive.run/docs/packages/composing-packages)
+
 ### Testing
 - [Overview](https://directive.run/docs/testing/overview)
 - [Mock Resolvers](https://directive.run/docs/testing/mock-resolvers)
@@ -121,8 +127,6 @@ Website: https://directive.run
 - [Role-Based Permissions](https://directive.run/docs/guides/permissions)
 - [Batch Mutations](https://directive.run/docs/guides/batch-mutations)
 
-## AI
-
 ### Integration Guides
 - [Overview](https://directive.run/docs/works-with/overview)
 - [Redux](https://directive.run/docs/works-with/redux)
@@ -131,6 +135,8 @@ Website: https://directive.run
 - [React Query](https://directive.run/docs/works-with/react-query)
 - [Web Worker](https://directive.run/docs/works-with/worker)
 
+## AI
+
 ### Foundations
 - [Overview](https://directive.run/ai/overview)
 - [Running Agents](https://directive.run/ai/running-agents)

package/examples/debounce-constraints.ts

@@ -1,95 +0,0 @@
-// Example: debounce-constraints
-// Source: examples/debounce-constraints/src/main.ts
-// Extracted for AI rules — DOM wiring stripped
-
-/**
- * Debounce Constraints — DOM Rendering & System Wiring
- *
- * Creates the Directive system, subscribes to state changes,
- * renders the search input, debounce progress bar, results list,
- * stats, config sliders, and event timeline.
- * A 100ms timer drives reactive debounce countdown.
- */
-
-import { createSystem } from "@directive-run/core";
-import { devtoolsPlugin } from "@directive-run/core/plugins";
-import { el } from "@directive-run/el";
-import {
-  debounceSearchModule,
-  debounceSearchSchema,
-} from "./debounce-search.js";
-
-// ============================================================================
-// System
-// ============================================================================
-
-const system = createSystem({
-  module: debounceSearchModule,
-  trace: true,
-  plugins: [devtoolsPlugin({ name: "debounce-constraints" })],
-});
-system.start();
-
-const allKeys = [
-  ...Object.keys(debounceSearchSchema.facts),
-  ...Object.keys(debounceSearchSchema.derivations),
-];
-
-// ============================================================================
-// DOM References
-// ============================================================================
-
-// Status bar
-
-// Search form
-  "dc-search-input",
-
-// Progress bar
-
-// Query display
-
-// Results
-
-// Stats
-
-// Config sliders
-  "dc-debounce-delay",
-  "dc-api-delay",
-  "dc-min-chars",
-
-// Timeline
-
-// ============================================================================
-// Render
-// ============================================================================
-
-
-// ============================================================================
-// Subscribe
-// ============================================================================
-
-system.subscribe(allKeys, render);
-
-// Timer — tick every 100ms for smooth debounce progress bar
-const tickInterval = setInterval(() => {
-  system.events.tick();
-}, 100);
-
-// ============================================================================
-// Controls
-// ============================================================================
-
-// Search input — fire on every keystroke
-
-// Clear
-
-// Sliders
-
-
-// ============================================================================
-// Initial Render
-// ============================================================================
-
-render();
-
-// Signal to tests that the module script has fully initialized

package/examples/multi-module.ts

@@ -1,58 +0,0 @@
-// Example: multi-module
-// Source: examples/multi-module/src/main.ts
-// Extracted for AI rules — DOM wiring stripped
-
-/**
- * Multi-Module Example - Main Entry Point
- *
- * Demonstrates the NEW namespaced module access:
- * - `system.facts.auth.token` instead of `system.facts.auth_token`
- * - `system.derive.data.userCount` instead of `system.derive.data_userCount`
- * - `system.events.auth.login({ token })` instead of `dispatch({ type: "auth_login", token })`
- *
- * Cross-module constraints work automatically:
- * - Data fetches when auth succeeds
- * - No asCombined() helper needed
- */
-
-import { el } from "@directive-run/el";
-import { getFacts, system } from "./system";
-
-// DOM Elements
-
-// Start the system
-system.start();
-
-// Update UI function
-
-// Subscribe to derivation changes using namespaced keys
-// Note: The internal keys are still prefixed (auth_status), so we use those for subscribe
-system.subscribe(
-  [
-    "auth_status",
-    "auth_displayName",
-    "data_status",
-    "data_userCount",
-    "ui_hasNotifications",
-  ],
-  () => {
-    updateUI();
-  },
-);
-
-// Also update on fact changes via polling (simple approach for this demo)
-
-// Event handlers using namespaced events accessor
-
-
-// Initial render
-updateUI();
-
-// Log to console for debugging
-console.log("Multi-Module Example Started (Namespaced Mode)");
-console.log("Try clicking Login to see the cross-module constraint in action:");
-console.log("1. Auth module validates token via facts.auth.*");
-console.log(
-  "2. Data module automatically fetches users when facts.auth.isAuthenticated",
-);
-console.log("3. UI module effects react to facts.data.* changes");