@directive-run/knowledge 0.2.0 → 0.4.2

package/examples/ai-guardrails.ts

@@ -1,12 +1,12 @@
 // Example: ai-guardrails
-// Source: examples/ai-guardrails/src/main.ts
-// Extracted for AI rules — DOM wiring stripped
+// Source: examples/ai-guardrails/src/module.ts
+// Pure module file — no DOM wiring
 
 /**
- * AI Safety Shield — Prompt Injection & PII Detection
+ * AI Safety Shield — Directive Module
  *
- * Chat interface where every message passes through prompt injection detection,
- * PII detection, and compliance checks. All run locally using built-in patterns.
+ * Types, schema, module definition, timeline, analysis functions,
+ * and system creation for prompt injection & PII detection guardrails.
  */
 
 import {
@@ -27,7 +27,7 @@ import { devtoolsPlugin, emitDevToolsEvent } from "@directive-run/core/plugins";
 // Types
 // ============================================================================
 
-interface ChatMessage {
+export interface ChatMessage {
   id: string;
   text: string;
   blocked: boolean;
@@ -36,22 +36,22 @@ interface ChatMessage {
   piiResult: PIIDetectionResult | null;
 }
 
-interface TimelineEntry {
+export interface TimelineEntry {
   time: number;
   event: string;
   detail: string;
   type: "pass" | "injection" | "pii" | "compliance" | "info";
 }
 
-type ComplianceMode = "standard" | "gdpr" | "hipaa";
+export type ComplianceMode = "standard" | "gdpr" | "hipaa";
 
 // ============================================================================
 // Timeline
 // ============================================================================
 
-const timeline: TimelineEntry[] = [];
+export const timeline: TimelineEntry[] = [];
 
-function addTimeline(
+export function addTimeline(
   event: string,
   detail: string,
   type: TimelineEntry["type"],
@@ -66,9 +66,9 @@ function addTimeline(
 // Schema
 // ============================================================================
 
-const schema = {
+export const schema = {
   facts: {
-    messages: t.object<ChatMessage[]>(),
+    messages: t.array<ChatMessage>(),
     complianceMode: t.string<ComplianceMode>(),
     redactionEnabled: t.boolean(),
     blockedCount: t.number(),
@@ -159,18 +159,17 @@ const guardrailModule = createModule("guardrails", {
 // System
 // ============================================================================
 
-const system = createSystem({
+export const system = createSystem({
   module: guardrailModule,
   debug: { runHistory: true },
   plugins: [devtoolsPlugin({ name: "ai-guardrails" })],
 });
-system.start();
 
 // ============================================================================
 // Analysis Functions
 // ============================================================================
 
-function analyzeMessage(text: string): ChatMessage {
+export function analyzeMessage(text: string): ChatMessage {
   const id = `msg-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;
   let blocked = false;
 
@@ -181,6 +180,7 @@ function analyzeMessage(text: string): ChatMessage {
     system.facts.injectionAttempts =
       (system.facts.injectionAttempts as number) + 1;
     for (const p of injectionResult.patterns) {
+      addTimeline("injection", `${p.name} (${p.severity})`, "injection");
     }
   }
 
@@ -200,6 +200,7 @@ function analyzeMessage(text: string): ChatMessage {
   if (piiResult.detected) {
     system.facts.piiDetections = (system.facts.piiDetections as number) + 1;
     for (const item of piiResult.items) {
+      addTimeline("pii", `${item.type} found`, "pii");
     }
   }
 
@@ -228,12 +229,14 @@ function analyzeMessage(text: string): ChatMessage {
       blocked = true;
       system.facts.complianceBlocks =
         (system.facts.complianceBlocks as number) + 1;
+      addTimeline("compliance", "HIPAA: PHI detected", "compliance");
     }
 
     if (mode === "gdpr" && hasContactInfo) {
       blocked = true;
       system.facts.complianceBlocks =
         (system.facts.complianceBlocks as number) + 1;
+      addTimeline("compliance", "GDPR: personal data detected", "compliance");
     }
   }
 
@@ -250,8 +253,10 @@ function analyzeMessage(text: string): ChatMessage {
   }
 
   if (!blocked && !piiResult.detected) {
+    addTimeline("pass", "message passed all checks", "pass");
   }
 
+  const redactedText = piiResult.redactedText ?? text;
 
   return {
     id,
@@ -262,58 +267,3 @@ function analyzeMessage(text: string): ChatMessage {
     piiResult: piiResult.detected ? piiResult : null,
   };
 }
-
-// ============================================================================
-// DOM References
-// ============================================================================
-
-  "gs-compliance",
-  "gs-redaction",
-
-// Timeline
-
-// Pre-built test buttons
-
-// ============================================================================
-// Render
-// ============================================================================
-
-function escapeHtml(text: string): string {
-
-  return div.innerHTML;
-}
-
-
-// ============================================================================
-// Subscribe
-// ============================================================================
-
-const allKeys = [
-  ...Object.keys(schema.facts),
-  ...Object.keys(schema.derivations),
-];
-system.subscribe(allKeys, render);
-
-// ============================================================================
-// Controls
-// ============================================================================
-
-function sendMessage(text: string) {
-  if (!text.trim()) {
-    return;
-  }
-
-  const msg = analyzeMessage(text);
-  const messages = [...(system.facts.messages as ChatMessage[]), msg];
-  system.facts.messages = messages;
-}
-
-
-// Test buttons
-
-
-// ============================================================================
-// Initial Render
-// ============================================================================
-
-render();

package/examples/auth-flow.ts

@@ -54,7 +54,7 @@ export const authFlowSchema = {
     refreshBuffer: t.number(),
     loginFailRate: t.number(),
     refreshFailRate: t.number(),
-    eventLog: t.object<EventLogEntry[]>(),
+    eventLog: t.array<EventLogEntry>(),
   },
   derivations: {
     isAuthenticated: t.boolean(),
@@ -87,7 +87,7 @@ export const authFlowSchema = {
 // ============================================================================
 
 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 });
   facts.eventLog = log;
 }

package/examples/batch-resolver.ts

@@ -1,13 +1,12 @@
 // Example: batch-resolver
-// Source: examples/batch-resolver/src/main.ts
-// Extracted for AI rules — DOM wiring stripped
+// Source: examples/batch-resolver/src/module.ts
+// Pure module file — no DOM wiring
 
 /**
- * Batch Data Loader — Batched Resolution & Schema Validation
+ * Batch Data Loader — Directive Module
  *
- * User directory that loads profiles. Multiple constraints fire simultaneously;
- * the batch resolver groups them into one call. Dev-mode schema validation
- * catches type mismatches.
+ * Types, schema, mock data, module definition, timeline, and system creation
+ * for a batched user profile loader with schema validation.
  */
 
 import {
@@ -22,14 +21,14 @@ import { devtoolsPlugin } from "@directive-run/core/plugins";
 // Types
 // ============================================================================
 
-interface UserProfile {
+export interface UserProfile {
   id: number;
   name: string;
   email: string;
   role: string;
 }
 
-interface TimelineEntry {
+export interface TimelineEntry {
   time: number;
   event: string;
   detail: string;
@@ -67,9 +66,9 @@ const MOCK_USERS: Record<number, UserProfile> = {
 // Timeline
 // ============================================================================
 
-const timeline: TimelineEntry[] = [];
+export const timeline: TimelineEntry[] = [];
 
-function addTimeline(
+export function addTimeline(
   event: string,
   detail: string,
   type: TimelineEntry["type"],
@@ -84,15 +83,15 @@ function addTimeline(
 // Schema
 // ============================================================================
 
-const schema = {
+export const schema = {
   facts: {
-    users: t.object<UserProfile[]>(),
-    loadingIds: t.object<number[]>(),
+    users: t.array<UserProfile>(),
+    loadingIds: t.array<number>(),
     batchCount: t.number(),
     totalRequests: t.number(),
     batchWindowMs: t.number(),
     failItemId: t.number(),
-    validationErrors: t.object<string[]>(),
+    validationErrors: t.array<string>(),
   },
   derivations: {
     userCount: t.number(),
@@ -182,6 +181,7 @@ const batchModule = createModule("batch-loader", {
         ...facts.validationErrors,
         "schema: expected array for 'users', got string",
       ];
+      addTimeline(
         "validation",
         "schema error: expected array for 'users'",
         "validation",
@@ -225,6 +225,7 @@ const batchModule = createModule("batch-loader", {
       },
       resolveBatchWithResults: async (requirements, context) => {
         const ids = requirements.map((r) => r.userId);
+        addTimeline(
           "batch",
           `batch formed: ${ids.length} items [${ids.join(", ")}]`,
           "batch",
@@ -239,6 +240,7 @@ const batchModule = createModule("batch-loader", {
         const failId = context.facts.failItemId;
         const results = ids.map((id) => {
           if (id === failId) {
+            addTimeline("error", `user ${id}: simulated failure`, "error");
 
             return {
               success: false as const,
@@ -248,6 +250,7 @@ const batchModule = createModule("batch-loader", {
 
           const user = MOCK_USERS[id];
           if (!user) {
+            addTimeline("error", `user ${id}: not found`, "error");
 
             return {
               success: false as const,
@@ -275,6 +278,7 @@ const batchModule = createModule("batch-loader", {
         );
 
         const successCount = results.filter((r) => r.success).length;
+        addTimeline(
           "success",
           `batch resolved: ${successCount}/${ids.length} success`,
           "success",
@@ -290,52 +294,8 @@ const batchModule = createModule("batch-loader", {
 // System
 // ============================================================================
 
-const system = createSystem({
+export const system = createSystem({
   module: batchModule,
   debug: { runHistory: true },
   plugins: [devtoolsPlugin({ name: "batch-resolver" })],
 });
-system.start();
-
-// ============================================================================
-// DOM References
-// ============================================================================
-
-  "bl-fail-item",
-
-// ============================================================================
-// Render
-// ============================================================================
-
-function escapeHtml(text: string): string {
-
-  return div.innerHTML;
-}
-
-
-// ============================================================================
-// Subscribe
-// ============================================================================
-
-const allKeys = [
-  ...Object.keys(schema.facts),
-  ...Object.keys(schema.derivations),
-];
-system.subscribe(allKeys, render);
-
-// ============================================================================
-// Controls
-// ============================================================================
-
-// Individual load buttons (1-5)
-for (let i = 1; i <= 5; i++) {
-    system.events.loadUser({ id: i });
-  });
-}
-
-
-// ============================================================================
-// Initial Render
-// ============================================================================
-
-render();