@directive-run/knowledge 0.4.2 → 0.5.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Jason Comes
+Copyright (c) 2026 Sizls LLC
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/examples/contact-form.ts

@@ -197,8 +197,8 @@ const contactForm = createModule("contact-form", {
       facts.subject !== "" &&
       facts.message.trim().length >= 10,
 
-    canSubmit: (facts, derive) => {
-      if (!derive.isValid) {
+    canSubmit: (facts, derived) => {
+      if (!derived.isValid) {
         return false;
       }
       if (facts.status !== "idle") {

package/examples/dashboard-loader.ts

@@ -180,10 +180,10 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
       return resources.some((r) => r.status === "loading");
     },
 
-    combinedStatus: (facts, derive) => {
-      const loaded = derive.loadedCount;
-      const anyErr = derive.anyError;
-      const anyLoad = derive.anyLoading;
+    combinedStatus: (facts, derived) => {
+      const loaded = derived.loadedCount;
+      const anyErr = derived.anyError;
+      const anyLoad = derived.anyLoading;
       const allIdle = [
         facts.profile,
         facts.preferences,

package/examples/form-wizard.ts

@@ -127,23 +127,23 @@ export const wizardModule = createModule("wizard", {
       return facts.plan !== "";
     },
 
-    currentStepValid: (facts, derive) => {
+    currentStepValid: (facts, derived) => {
       if (facts.currentStep === 0) {
-        return derive.step0Valid;
+        return derived.step0Valid;
       }
       if (facts.currentStep === 1) {
-        return derive.step1Valid;
+        return derived.step1Valid;
       }
       if (facts.currentStep === 2) {
-        return derive.step2Valid;
+        return derived.step2Valid;
       }
 
       return false;
     },
 
-    canAdvance: (facts, derive) => {
+    canAdvance: (facts, derived) => {
       return (
-        derive.currentStepValid && facts.currentStep < facts.totalSteps - 1
+        derived.currentStepValid && facts.currentStep < facts.totalSteps - 1
       );
     },
 

package/examples/newsletter.ts

@@ -102,8 +102,8 @@ const newsletter = createModule("newsletter", {
 
     isValid: (facts) => EMAIL_REGEX.test(facts.email),
 
-    canSubmit: (facts, derive) => {
-      if (!derive.isValid) {
+    canSubmit: (facts, derived) => {
+      if (!derived.isValid) {
         return false;
       }
       if (facts.status !== "idle") {

package/examples/permissions.ts

@@ -138,7 +138,7 @@ export const permissionsModule = createModule("permissions", {
     canManageUsers: (facts) => facts.self.permissions.includes("users.manage"),
     canViewAnalytics: (facts) =>
       facts.self.permissions.includes("analytics.view"),
-    isAdmin: (_facts, derive) => derive.canManageUsers,
+    isAdmin: (_facts, derived) => derived.canManageUsers,
     permissionCount: (facts) => facts.self.permissions.length,
   },
 

package/examples/shopping-cart.ts

@@ -187,23 +187,23 @@ export const cartModule = createModule("cart", {
       return facts.self.items.length === 0;
     },
 
-    discount: (facts, derive) => {
-      const sub = derive.subtotal;
+    discount: (facts, derived) => {
+      const sub = derived.subtotal;
 
       return sub * (facts.self.couponDiscount / 100);
     },
 
-    tax: (facts, derive) => {
-      const sub = derive.subtotal;
-      const disc = derive.discount;
+    tax: (facts, derived) => {
+      const sub = derived.subtotal;
+      const disc = derived.discount;
 
       return (sub - disc) * 0.08;
     },
 
-    total: (_facts, derive) => {
-      const sub = derive.subtotal;
-      const disc = derive.discount;
-      const tx = derive.tax;
+    total: (_facts, derived) => {
+      const sub = derived.subtotal;
+      const disc = derived.discount;
+      const tx = derived.tax;
 
       return sub - disc + tx;
     },
@@ -214,8 +214,8 @@ export const cartModule = createModule("cart", {
       );
     },
 
-    freeShipping: (_facts, derive) => {
-      const sub = derive.subtotal;
+    freeShipping: (_facts, derived) => {
+      const sub = derived.subtotal;
 
       return sub >= 75;
     },

package/examples/sudoku.ts

@@ -147,10 +147,10 @@ export const sudokuGame = createModule("sudoku", {
       return findConflicts(facts.grid);
     },
 
-    conflictIndices: (facts, derive) => {
+    conflictIndices: (facts, derived) => {
       const indices = new Set<number>();
       const givens = facts.givens;
-      for (const c of derive.conflicts) {
+      for (const c of derived.conflicts) {
         // Only highlight player-placed cells, not givens
         if (!givens.has(c.index)) {
           indices.add(c.index);
@@ -160,8 +160,8 @@ export const sudokuGame = createModule("sudoku", {
       return indices;
     },
 
-    hasConflicts: (_facts, derive) => {
-      return derive.conflicts.length > 0;
+    hasConflicts: (_facts, derived) => {
+      return derived.conflicts.length > 0;
     },
 
     filledCount: (facts) => {
@@ -176,16 +176,16 @@ export const sudokuGame = createModule("sudoku", {
       return count;
     },
 
-    progress: (_facts, derive) => {
-      return Math.round((derive.filledCount / 81) * 100);
+    progress: (_facts, derived) => {
+      return Math.round((derived.filledCount / 81) * 100);
     },
 
     isComplete: (facts) => {
       return isBoardComplete(facts.grid);
     },
 
-    isSolved: (_facts, derive) => {
-      return derive.isComplete && !derive.hasConflicts;
+    isSolved: (_facts, derived) => {
+      return derived.isComplete && !derived.hasConflicts;
     },
 
     selectedPeers: (facts) => {
@@ -206,8 +206,8 @@ export const sudokuGame = createModule("sudoku", {
       return facts.grid[sel];
     },
 
-    sameValueIndices: (facts, derive) => {
-      const val = derive.highlightValue;
+    sameValueIndices: (facts, derived) => {
+      const val = derived.highlightValue;
       if (val === 0) {
         return new Set<number>();
       }

package/examples/topic-guard.ts

@@ -106,12 +106,12 @@ export const topicGuardModule = createModule("topic-guard", {
         .length;
     },
 
-    blockRate: (facts, derive) => {
-      const total = derive.messageCount;
+    blockRate: (facts, derived) => {
+      const total = derived.messageCount;
       if (total === 0) {
         return "0%";
       }
-      const blocked = derive.blockedCount;
+      const blocked = derived.blockedCount;
       const rate = Math.round((blocked / total) * 100);
 
       return `${rate}%`;

package/package.json

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