@directive-run/knowledge 0.2.0 → 0.4.2

package/examples/dashboard-loader.ts

@@ -70,7 +70,7 @@ export const dashboardLoaderSchema = {
     preferencesFailRate: t.number(),
     permissionsFailRate: t.number(),
     loadRequested: t.boolean(),
-    eventLog: t.object<EventLogEntry[]>(),
+    eventLog: t.array<EventLogEntry>(),
   },
   derivations: {
     loadedCount: t.number(),
@@ -106,7 +106,7 @@ function addLogEntry(
   resource: string,
   detail: string,
 ): void {
-  const log = [...(facts.eventLog as EventLogEntry[])];
+  const log = [...facts.eventLog];
   log.push({ timestamp: Date.now(), event, resource, detail });
   facts.eventLog = log;
 }
@@ -181,9 +181,9 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
     },
 
     combinedStatus: (facts, derive) => {
-      const loaded = derive.loadedCount as number;
-      const anyErr = derive.anyError as boolean;
-      const anyLoad = derive.anyLoading as boolean;
+      const loaded = derive.loadedCount;
+      const anyErr = derive.anyError;
+      const anyLoad = derive.anyLoading;
       const allIdle = [
         facts.profile,
         facts.preferences,
@@ -216,7 +216,7 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
     },
 
     canStart: (facts) => {
-      const id = (facts.userId as string).trim();
+      const id = facts.userId.trim();
       const allIdle = [
         facts.profile,
         facts.preferences,
@@ -237,7 +237,7 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
     },
 
     start: (facts) => {
-      const id = (facts.userId as string).trim();
+      const id = facts.userId.trim();
       if (id.length === 0) {
         return;
       }
@@ -293,54 +293,42 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
     needsProfile: {
       priority: 100,
       when: (facts) => {
-        const id = (facts.userId as string).trim();
-        const profile = facts.profile as ResourceState<Profile>;
+        const id = facts.userId.trim();
+        const profile = facts.profile;
 
-        return (
-          (facts.loadRequested as boolean) &&
-          id !== "" &&
-          profile.status === "idle"
-        );
+        return facts.loadRequested && id !== "" && profile.status === "idle";
       },
       require: (facts) => ({
         type: "FETCH_PROFILE",
-        userId: (facts.userId as string).trim(),
+        userId: facts.userId.trim(),
       }),
     },
 
     needsPreferences: {
       priority: 90,
       when: (facts) => {
-        const id = (facts.userId as string).trim();
-        const prefs = facts.preferences as ResourceState<Preferences>;
+        const id = facts.userId.trim();
+        const prefs = facts.preferences;
 
-        return (
-          (facts.loadRequested as boolean) &&
-          id !== "" &&
-          prefs.status === "idle"
-        );
+        return facts.loadRequested && id !== "" && prefs.status === "idle";
       },
       require: (facts) => ({
         type: "FETCH_PREFERENCES",
-        userId: (facts.userId as string).trim(),
+        userId: facts.userId.trim(),
       }),
     },
 
     needsPermissions: {
       priority: 80,
       when: (facts) => {
-        const id = (facts.userId as string).trim();
-        const perms = facts.permissions as ResourceState<Permissions>;
+        const id = facts.userId.trim();
+        const perms = facts.permissions;
 
-        return (
-          (facts.loadRequested as boolean) &&
-          id !== "" &&
-          perms.status === "idle"
-        );
+        return facts.loadRequested && id !== "" && perms.status === "idle";
       },
       require: (facts) => ({
         type: "FETCH_PERMISSIONS",
-        userId: (facts.userId as string).trim(),
+        userId: facts.userId.trim(),
       }),
     },
   },
@@ -355,7 +343,7 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
       retry: { attempts: 3, backoff: "exponential" },
       timeout: 10000,
       resolve: async (req, context) => {
-        const prev = context.facts.profile as ResourceState<Profile>;
+        const prev = context.facts.profile;
         context.facts.profile = {
           ...prev,
           status: "loading",
@@ -372,24 +360,22 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
         try {
           const data = await fetchMockProfile(
             req.userId,
-            context.facts.profileDelay as number,
-            context.facts.profileFailRate as number,
+            context.facts.profileDelay,
+            context.facts.profileFailRate,
           );
           context.facts.profile = {
             data,
             status: "success",
             error: null,
-            attempts: (context.facts.profile as ResourceState<Profile>)
-              .attempts,
-            startedAt: (context.facts.profile as ResourceState<Profile>)
-              .startedAt,
+            attempts: context.facts.profile.attempts,
+            startedAt: context.facts.profile.startedAt,
             completedAt: Date.now(),
           };
           addLogEntry(context.facts, "success", "profile", data.name);
         } catch (err) {
           const msg = err instanceof Error ? err.message : "Unknown error";
           context.facts.profile = {
-            ...(context.facts.profile as ResourceState<Profile>),
+            ...context.facts.profile,
             status: "error",
             error: msg,
             completedAt: Date.now(),
@@ -404,7 +390,7 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
       requirement: "FETCH_PREFERENCES",
       retry: { attempts: 2, backoff: "exponential" },
       resolve: async (req, context) => {
-        const prev = context.facts.preferences as ResourceState<Preferences>;
+        const prev = context.facts.preferences;
         context.facts.preferences = {
           ...prev,
           status: "loading",
@@ -421,17 +407,15 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
         try {
           const data = await fetchMockPreferences(
             req.userId,
-            context.facts.preferencesDelay as number,
-            context.facts.preferencesFailRate as number,
+            context.facts.preferencesDelay,
+            context.facts.preferencesFailRate,
           );
           context.facts.preferences = {
             data,
             status: "success",
             error: null,
-            attempts: (context.facts.preferences as ResourceState<Preferences>)
-              .attempts,
-            startedAt: (context.facts.preferences as ResourceState<Preferences>)
-              .startedAt,
+            attempts: context.facts.preferences.attempts,
+            startedAt: context.facts.preferences.startedAt,
             completedAt: Date.now(),
           };
           addLogEntry(
@@ -443,7 +427,7 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
         } catch (err) {
           const msg = err instanceof Error ? err.message : "Unknown error";
           context.facts.preferences = {
-            ...(context.facts.preferences as ResourceState<Preferences>),
+            ...context.facts.preferences,
             status: "error",
             error: msg,
             completedAt: Date.now(),
@@ -459,7 +443,7 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
       retry: { attempts: 3, backoff: "exponential" },
       timeout: 15000,
       resolve: async (req, context) => {
-        const prev = context.facts.permissions as ResourceState<Permissions>;
+        const prev = context.facts.permissions;
         context.facts.permissions = {
           ...prev,
           status: "loading",
@@ -476,17 +460,15 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
         try {
           const data = await fetchMockPermissions(
             req.userId,
-            context.facts.permissionsDelay as number,
-            context.facts.permissionsFailRate as number,
+            context.facts.permissionsDelay,
+            context.facts.permissionsFailRate,
           );
           context.facts.permissions = {
             data,
             status: "success",
             error: null,
-            attempts: (context.facts.permissions as ResourceState<Permissions>)
-              .attempts,
-            startedAt: (context.facts.permissions as ResourceState<Permissions>)
-              .startedAt,
+            attempts: context.facts.permissions.attempts,
+            startedAt: context.facts.permissions.startedAt,
             completedAt: Date.now(),
           };
           addLogEntry(
@@ -498,7 +480,7 @@ export const dashboardLoaderModule = createModule("dashboard-loader", {
         } catch (err) {
           const msg = err instanceof Error ? err.message : "Unknown error";
           context.facts.permissions = {
-            ...(context.facts.permissions as ResourceState<Permissions>),
+            ...context.facts.permissions,
             status: "error",
             error: msg,
             completedAt: Date.now(),

package/examples/debounce-constraints.ts

@@ -14,8 +14,6 @@
 import { createSystem } from "@directive-run/core";
 import { devtoolsPlugin } from "@directive-run/core/plugins";
 import {
-  type EventLogEntry,
-  type SearchResult,
   debounceSearchModule,
   debounceSearchSchema,
 } from "./debounce-search.js";

package/examples/dynamic-modules.ts

@@ -28,7 +28,7 @@ export interface EventLogEntry {
 // ============================================================================
 
 function addLogEntry(facts: any, event: string, detail: string): void {
-  const log = [...(facts.eventLog as EventLogEntry[])];
+  const log = [...facts.eventLog];
   log.push({ timestamp: Date.now(), event, detail });
   if (log.length > 50) {
     log.splice(0, log.length - 50);
@@ -42,8 +42,8 @@ function addLogEntry(facts: any, event: string, detail: string): void {
 
 export const dashboardSchema = {
   facts: {
-    loadedModules: t.object<string[]>(),
-    eventLog: t.object<EventLogEntry[]>(),
+    loadedModules: t.array<string>(),
+    eventLog: t.array<EventLogEntry>(),
   },
   derivations: {
     loadedCount: t.number(),
@@ -63,12 +63,12 @@ export const dashboardModule = createModule("dashboard", {
   },
 
   derive: {
-    loadedCount: (facts) => (facts.loadedModules as string[]).length,
+    loadedCount: (facts) => facts.loadedModules.length,
   },
 
   events: {
     moduleLoaded: (facts, { name }) => {
-      facts.loadedModules = [...(facts.loadedModules as string[]), name];
+      facts.loadedModules = [...facts.loadedModules, name];
       addLogEntry(facts, "loaded", `Loaded "${name}" module`);
     },
   },
@@ -105,18 +105,15 @@ export const counterModule = createModule("counter", {
   },
 
   derive: {
-    isNearMax: (facts) => (facts.count as number) >= 90,
+    isNearMax: (facts) => facts.count >= 90,
   },
 
   events: {
     increment: (facts) => {
-      facts.count = (facts.count as number) + (facts.step as number);
+      facts.count = facts.count + facts.step;
     },
     decrement: (facts) => {
-      facts.count = Math.max(
-        0,
-        (facts.count as number) - (facts.step as number),
-      );
+      facts.count = Math.max(0, facts.count - facts.step);
     },
     setStep: (facts, { value }) => {
       facts.step = value;
@@ -126,7 +123,7 @@ export const counterModule = createModule("counter", {
   constraints: {
     overflow: {
       priority: 100,
-      when: (facts) => (facts.count as number) >= 100,
+      when: (facts) => facts.count >= 100,
       require: () => ({ type: "COUNTER_RESET" }),
     },
   },
@@ -183,13 +180,13 @@ export const weatherModule = createModule("weather", {
 
   derive: {
     summary: (facts) => {
-      if ((facts.city as string) === "") {
+      if (facts.city === "") {
         return "";
       }
 
       return `${facts.temperature}\u00B0F, ${facts.condition}`;
     },
-    hasFetched: (facts) => (facts.lastFetchedCity as string) !== "",
+    hasFetched: (facts) => facts.lastFetchedCity !== "",
   },
 
   events: {
@@ -205,12 +202,12 @@ export const weatherModule = createModule("weather", {
     needsFetch: {
       priority: 100,
       when: (facts) =>
-        (facts.city as string).length >= 2 &&
+        facts.city.length >= 2 &&
         facts.city !== facts.lastFetchedCity &&
-        !(facts.isLoading as boolean),
+        !facts.isLoading,
       require: (facts) => ({
         type: "FETCH_WEATHER",
-        city: facts.city as string,
+        city: facts.city,
       }),
     },
   },
@@ -226,7 +223,7 @@ export const weatherModule = createModule("weather", {
         const data = await mockFetchWeather(req.city, 800);
 
         // Stale check: only apply if city still matches
-        if ((context.facts.city as string) === req.city) {
+        if (context.facts.city === req.city) {
           context.facts.temperature = data.temperature;
           context.facts.condition = data.condition;
           context.facts.humidity = data.humidity;
@@ -269,7 +266,7 @@ export const diceModule = createModule("dice", {
   },
 
   derive: {
-    total: (facts) => (facts.die1 as number) + (facts.die2 as number),
+    total: (facts) => facts.die1 + facts.die2,
     isDoubles: (facts) => facts.die1 === facts.die2,
   },
 
@@ -277,7 +274,7 @@ export const diceModule = createModule("dice", {
     roll: (facts) => {
       facts.die1 = Math.floor(Math.random() * 6) + 1;
       facts.die2 = Math.floor(Math.random() * 6) + 1;
-      facts.rollCount = (facts.rollCount as number) + 1;
+      facts.rollCount = facts.rollCount + 1;
     },
   },
 });

package/examples/error-boundaries.ts

@@ -1,9 +1,9 @@
 // Example: error-boundaries
-// Source: examples/error-boundaries/src/main.ts
-// Extracted for AI rules — DOM wiring stripped
+// Source: examples/error-boundaries/src/module.ts
+// Pure module file — no DOM wiring
 
 /**
- * Resilient API Dashboard — Error Boundaries, Retry, Circuit Breaker, Performance
+ * Resilient API Dashboard — Module Definition
  *
  * 3 simulated API services with configurable failure rates. Users inject errors
  * and watch recovery strategies, circuit breaker state transitions, retry-later
@@ -17,17 +17,18 @@ import {
   createSystem,
   t,
 } from "@directive-run/core";
-import { devtoolsPlugin, performancePlugin } from "@directive-run/core/plugins";
 import {
   type CircuitState,
   createCircuitBreaker,
+  devtoolsPlugin,
+  performancePlugin,
 } from "@directive-run/core/plugins";
 
 // ============================================================================
 // Types
 // ============================================================================
 
-interface ServiceState {
+export interface ServiceState {
   name: string;
   status: "idle" | "loading" | "success" | "error";
   lastResult: string;
@@ -36,7 +37,7 @@ interface ServiceState {
   lastError: string;
 }
 
-interface TimelineEntry {
+export interface TimelineEntry {
   time: number;
   event: string;
   detail: string;
@@ -44,12 +45,12 @@ interface TimelineEntry {
 }
 
 // ============================================================================
-// Circuit Breakers (one per service)
+// Timeline
 // ============================================================================
 
-const timeline: TimelineEntry[] = [];
+export const timeline: TimelineEntry[] = [];
 
-function addTimeline(
+export function addTimeline(
   event: string,
   detail: string,
   type: TimelineEntry["type"],
@@ -60,13 +61,18 @@ function addTimeline(
   }
 }
 
-const circuitBreakers = {
+// ============================================================================
+// Circuit Breakers (one per service)
+// ============================================================================
+
+export const circuitBreakers = {
   users: createCircuitBreaker({
     name: "users-api",
     failureThreshold: 3,
     recoveryTimeMs: 5000,
     halfOpenMaxRequests: 2,
     onStateChange: (from, to) => {
+      addTimeline("circuit", `users: ${from} → ${to}`, "circuit");
     },
   }),
   orders: createCircuitBreaker({
@@ -75,6 +81,7 @@ const circuitBreakers = {
     recoveryTimeMs: 5000,
     halfOpenMaxRequests: 2,
     onStateChange: (from, to) => {
+      addTimeline("circuit", `orders: ${from} → ${to}`, "circuit");
     },
   }),
   analytics: createCircuitBreaker({
@@ -83,6 +90,7 @@ const circuitBreakers = {
     recoveryTimeMs: 5000,
     halfOpenMaxRequests: 2,
     onStateChange: (from, to) => {
+      addTimeline("circuit", `analytics: ${from} → ${to}`, "circuit");
     },
   }),
 };
@@ -91,7 +99,7 @@ const circuitBreakers = {
 // Schema
 // ============================================================================
 
-const schema = {
+export const schema = {
   facts: {
     usersService: t.object<ServiceState>(),
     ordersService: t.object<ServiceState>(),
@@ -290,15 +298,16 @@ const dashboardModule = createModule("dashboard", {
           });
 
           // Success
-          const current = context.facts[serviceKey] as ServiceState;
+          const current = context.facts[serviceKey];
           context.facts[serviceKey] = {
             ...current,
             status: "success",
             lastResult: `Loaded at ${new Date().toLocaleTimeString()}`,
             successCount: current.successCount + 1,
           };
+          addTimeline("success", `${service} fetched`, "success");
         } catch (error) {
-          const current = context.facts[serviceKey] as ServiceState;
+          const current = context.facts[serviceKey];
           const msg = error instanceof Error ? error.message : String(error);
           context.facts[serviceKey] = {
             ...current,
@@ -307,6 +316,7 @@ const dashboardModule = createModule("dashboard", {
             errorCount: current.errorCount + 1,
           };
           context.facts.totalErrors = context.facts.totalErrors + 1;
+          addTimeline("error", `${service}: ${msg.slice(0, 60)}`, "error");
 
           // Re-throw so the error boundary handles recovery
           throw error;
@@ -320,8 +330,9 @@ const dashboardModule = createModule("dashboard", {
 // Performance Plugin
 // ============================================================================
 
-const perf = performancePlugin({
+export const perf = performancePlugin({
   onSlowResolver: (id, ms) => {
+    addTimeline("perf", `slow resolver: ${id} (${Math.round(ms)}ms)`, "info");
   },
 });
 
@@ -331,12 +342,13 @@ const perf = performancePlugin({
 
 let currentStrategy: RecoveryStrategy = "retry-later";
 
-const system = createSystem({
+export const system = createSystem({
   module: dashboardModule,
   debug: { runHistory: true },
   plugins: [perf, devtoolsPlugin({ name: "error-boundaries" })],
   errorBoundary: {
     onResolverError: (_error, resolver) => {
+      addTimeline(
         "recovery",
         `${resolver}: strategy=${currentStrategy}`,
         "recovery",
@@ -352,79 +364,16 @@ const system = createSystem({
       backoffMultiplier: 2,
     },
     onError: (error) => {
+      addTimeline("error", `boundary: ${error.message.slice(0, 60)}`, "error");
     },
   },
 });
-system.start();
 
 // Track strategy changes to update error boundary (via re-dispatch)
 system.subscribe(["strategy"], () => {
-  const newStrategy = system.facts.strategy as RecoveryStrategy;
+  const newStrategy = system.facts.strategy;
   if (newStrategy !== currentStrategy) {
     currentStrategy = newStrategy;
+    addTimeline("recovery", `strategy → ${newStrategy}`, "recovery");
   }
 });
-
-// ============================================================================
-// DOM References
-// ============================================================================
-
-// Service cards
-
-// Sliders
-  "eb-users-failrate",
-  "eb-orders-failrate",
-  "eb-analytics-failrate",
-
-// Strategy dropdown
-  "eb-strategy",
-
-// Timeline
-
-// ============================================================================
-// Render
-// ============================================================================
-
-function escapeHtml(text: string): string {
-
-  return div.innerHTML;
-}
-
-  service: ServiceState,
-): void {
-  if (service.lastError) {
-  } else {
-  }
-}
-
-
-// ============================================================================
-// Subscribe
-// ============================================================================
-
-const allKeys = [
-  ...Object.keys(schema.facts),
-  ...Object.keys(schema.derivations),
-];
-system.subscribe(allKeys, render);
-
-// Periodic refresh for circuit breaker state transitions + retry queue
-setInterval(() => {
-  render();
-}, 1000);
-
-// ============================================================================
-// Controls
-// ============================================================================
-
-// Fetch buttons
-
-// Strategy selector
-
-// Sliders
-
-// ============================================================================
-// Initial Render
-// ============================================================================
-
-render();