@directive-run/knowledge 0.2.0 → 0.5.0

package/core/system-api.md

@@ -23,14 +23,14 @@ What do you want to do?
 import { createSystem } from "@directive-run/core";
 import { loggingPlugin, devtoolsPlugin } from "@directive-run/core/plugins";
 
-// Single module — direct access to facts/derive/events
+// Single module – direct access to facts/derive/events
 const system = createSystem({
   module: myModule,
   plugins: [loggingPlugin(), devtoolsPlugin()],
   debug: { timeTravel: true, maxSnapshots: 100 },
 });
 
-// Multi-module — namespaced access
+// Multi-module – namespaced access
 const system = createSystem({
   modules: {
     auth: authModule,
@@ -48,7 +48,7 @@ const system = createSystem({
 system.facts.count = 5;
 const val = system.facts.count;
 
-// Multi-module — access through module namespace
+// Multi-module – access through module namespace
 system.facts.auth.token = "abc123";
 system.facts.cart.items = [];
 const token = system.facts.auth.token;
@@ -107,7 +107,7 @@ unsub();
 // Wait until a condition is true
 await system.when((facts) => facts.phase === "done");
 
-// With timeout — throws if condition not met in time
+// With timeout – throws if condition not met in time
 await system.when((facts) => facts.phase === "done", { timeout: 5000 });
 ```
 
@@ -140,7 +140,7 @@ const unsub = system.onSettledChange(() => {
 const count = system.read("count");
 const isLoading = system.read("isLoading");
 
-// Multi-module — use dot notation
+// Multi-module – use dot notation
 const token = system.read("auth.token");
 const total = system.read("cart.totalPrice");
 ```
@@ -184,13 +184,13 @@ const explanation = system.explain("req-123");
 ## Lifecycle
 
 ```typescript
-// Start — begins constraint evaluation and reconciliation
+// Start – begins constraint evaluation and reconciliation
 system.start();
 
-// Stop — pauses evaluation, cancels inflight resolvers
+// Stop – pauses evaluation, cancels inflight resolvers
 system.stop();
 
-// Destroy — cleans up all resources, subscriptions, plugins
+// Destroy – cleans up all resources, subscriptions, plugins
 system.destroy();
 
 // Lifecycle order:
@@ -202,13 +202,13 @@ system.destroy();
 ## Constraint Control at Runtime
 
 ```typescript
-// Disable a constraint — it won't be evaluated
+// Disable a constraint – it won't be evaluated
 system.constraints.disable("fetchWhenReady");
 
 // Check if disabled
 system.constraints.isDisabled("fetchWhenReady"); // true
 
-// Re-enable — triggers re-evaluation on next cycle
+// Re-enable – triggers re-evaluation on next cycle
 system.constraints.enable("fetchWhenReady");
 ```
 
@@ -217,11 +217,11 @@ system.constraints.enable("fetchWhenReady");
 ### Reading facts before settling
 
 ```typescript
-// WRONG — resolver hasn't completed, facts are stale
+// WRONG – resolver hasn't completed, facts are stale
 system.start();
 console.log(system.facts.user); // null
 
-// CORRECT — wait for async resolution
+// CORRECT – wait for async resolution
 system.start();
 await system.settle();
 console.log(system.facts.user); // { id: "1", name: "Alice" }
@@ -230,10 +230,10 @@ console.log(system.facts.user); // { id: "1", name: "Alice" }
 ### Casting facts/derivations unnecessarily
 
 ```typescript
-// WRONG — the schema already provides types
+// WRONG – the schema already provides types
 const profile = system.facts.profile as ResourceState<Profile>;
 
-// CORRECT — types are inferred from the schema
+// CORRECT – types are inferred from the schema
 const profile = system.facts.profile;
 ```
 
@@ -254,7 +254,7 @@ system.watch("phase", (val) => {
 ### Forgetting to destroy
 
 ```typescript
-// WRONG — resources leak
+// WRONG – resources leak
 function setupSystem() {
   const system = createSystem({ module: myModule });
   system.start();
@@ -262,7 +262,7 @@ function setupSystem() {
   return system;
 }
 
-// CORRECT — clean up when done
+// CORRECT – clean up when done
 const system = createSystem({ module: myModule });
 system.start();
 // ... when finished:

package/core/testing.md

@@ -29,7 +29,7 @@ import {
   assertRequirement,
 } from "@directive-run/core/testing";
 
-// Single module — same API as createSystem, with testing defaults
+// Single module – same API as createSystem, with testing defaults
 // (time-travel off, no plugins, synchronous settling)
 const system = createTestSystem(myModule);
 
@@ -220,12 +220,12 @@ it("processes intermediate state", async () => {
 ### Testing real resolvers instead of mocking
 
 ```typescript
-// WRONG — tests hit real APIs, slow and flaky
+// WRONG – tests hit real APIs, slow and flaky
 const system = createTestSystem(myModule);
 system.facts.needsFetch = true;
 await system.settle(); // Makes real HTTP call
 
-// CORRECT — mock the resolver
+// CORRECT – mock the resolver
 const system = createTestSystem(myModule, {
   mockResolvers: [mockResolver("FETCH", async (req, context) => {
     context.facts.data = { mocked: true };
@@ -236,11 +236,11 @@ const system = createTestSystem(myModule, {
 ### Forgetting to settle before asserting async results
 
 ```typescript
-// WRONG — resolver hasn't completed yet
+// WRONG – resolver hasn't completed yet
 system.facts.trigger = true;
 assertFact(system, "result", "done"); // Fails!
 
-// CORRECT — wait for resolution
+// CORRECT – wait for resolution
 system.facts.trigger = true;
 await system.settle();
 assertFact(system, "result", "done");

package/core/time-travel.md

@@ -9,7 +9,7 @@ What's the use case?
 ├── Debugging during development → Yes, enable with maxSnapshots cap
 ├── Production app → No, disable for performance
 ├── Bug reproduction → Enable, use exportHistory() to share
-├── Testing → Usually no — use assertFact/assertDerivation instead
+├── Testing → Usually no – use assertFact/assertDerivation instead
 └── Demo / presentation → Yes, great for showing state changes
 ```
 
@@ -37,8 +37,8 @@ Access via `system.debug.timeTravel`:
 const tt = system.debug.timeTravel;
 
 // Navigation
-tt.canUndo();           // boolean — is there a previous snapshot?
-tt.canRedo();           // boolean — is there a next snapshot?
+tt.canUndo();           // boolean – is there a previous snapshot?
+tt.canRedo();           // boolean – is there a next snapshot?
 tt.undo();              // Restore previous snapshot
 tt.redo();              // Restore next snapshot
 
@@ -48,10 +48,10 @@ tt.goToSnapshot(index); // Jump to a specific snapshot by index
 
 // Each snapshot contains:
 // {
-//   facts: { ... },        — full fact state at that point
-//   timestamp: number,     — when the snapshot was taken
-//   label?: string,        — optional label from changeset
-//   changedKeys: string[], — which facts changed
+//   facts: { ... },        – full fact state at that point
+//   timestamp: number,     – when the snapshot was taken
+//   label?: string,        – optional label from changeset
+//   changedKeys: string[], – which facts changed
 // }
 ```
 
@@ -94,12 +94,12 @@ Multiple fact mutations can be grouped into a single undoable unit.
 ```typescript
 const tt = system.debug.timeTravel;
 
-// Without changeset — each mutation is a separate snapshot
+// Without changeset – each mutation is a separate snapshot
 system.facts.firstName = "Alice";
 system.facts.lastName = "Smith";
 // Two snapshots, two undos needed
 
-// With changeset — grouped into one snapshot
+// With changeset – grouped into one snapshot
 tt.beginChangeset("Update user name");
 system.facts.firstName = "Alice";
 system.facts.lastName = "Smith";
@@ -120,12 +120,12 @@ Serialize the full snapshot history for bug reports or debugging.
 ```typescript
 const tt = system.debug.timeTravel;
 
-// Export — returns a serializable object
+// Export – returns a serializable object
 const historyData = tt.exportHistory();
 // Send to server, save to file, attach to bug report
 console.log(JSON.stringify(historyData));
 
-// Import — restore history from exported data
+// Import – restore history from exported data
 tt.importHistory(historyData);
 
 // Now you can step through the user's exact state sequence
@@ -159,10 +159,10 @@ console.log(system.facts); // State as of snapshot 3
 Every fact mutation creates a snapshot. Cap the number to control memory:
 
 ```typescript
-// Low memory — keeps last 20 snapshots, discards oldest
+// Low memory – keeps last 20 snapshots, discards oldest
 debug: { timeTravel: true, maxSnapshots: 20 },
 
-// Development — generous cap for deep debugging
+// Development – generous cap for deep debugging
 debug: { timeTravel: true, maxSnapshots: 500 },
 
 // Default if not specified
@@ -176,13 +176,13 @@ When the cap is reached, the oldest snapshot is discarded (FIFO). Redo history b
 ### Enabling time-travel in production
 
 ```typescript
-// WRONG — snapshots consume memory on every mutation
+// WRONG – snapshots consume memory on every mutation
 const system = createSystem({
   module: myModule,
   debug: { timeTravel: true },
 });
 
-// CORRECT — gate on environment
+// CORRECT – gate on environment
 const system = createSystem({
   module: myModule,
   debug: {
@@ -195,13 +195,13 @@ const system = createSystem({
 ### Forgetting to end a changeset
 
 ```typescript
-// WRONG — changeset never closed, all subsequent mutations are grouped
+// WRONG – changeset never closed, all subsequent mutations are grouped
 tt.beginChangeset("update");
 system.facts.name = "Alice";
 // ... forgot endChangeset()
 system.facts.unrelated = true; // Still part of the changeset!
 
-// CORRECT — always close changesets
+// CORRECT – always close changesets
 tt.beginChangeset("update");
 system.facts.name = "Alice";
 tt.endChangeset();
@@ -210,11 +210,11 @@ tt.endChangeset();
 ### Accessing time-travel when disabled
 
 ```typescript
-// WRONG — timeTravel not enabled, system.debug.timeTravel is null
+// WRONG – timeTravel not enabled, system.debug.timeTravel is null
 const system = createSystem({ module: myModule });
 system.debug.timeTravel.undo(); // TypeError!
 
-// CORRECT — check before using
+// CORRECT – check before using
 const tt = system.debug.timeTravel;
 if (tt) {
   tt.undo();
@@ -230,7 +230,7 @@ const system = createSystem({
 ### No maxSnapshots cap with frequent mutations
 
 ```typescript
-// WRONG — unbounded snapshots in a high-frequency update loop
+// WRONG – unbounded snapshots in a high-frequency update loop
 debug: { timeTravel: true }, // Default cap is 50, which is fine
 
 // Be explicit when mutation rate is high

package/dist/index.cjs

@@ -1,111 +1,12 @@
-'use strict';
+'use strict';var fs=require('fs'),path=require('path'),url=require('url');var _documentCurrentScript=typeof document!=='undefined'?document.currentScript:null;var h=path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)))),g=path.resolve(h,"..");function s(n){let t=path.join(g,n);if(fs.existsSync(t))return t;let e=path.join(g,"..",n);return fs.existsSync(e)?e:t}var w=s("core"),A=s("ai"),y=s("examples"),R=s("api-skeleton.md"),r=null,i=null;function a(n,t){try{let e=fs.readdirSync(n).filter(o=>o.endsWith(".md")||o.endsWith(".ts"));for(let o of e){let m=o.replace(/\.(md|ts)$/,"");t.set(m,fs.readFileSync(path.join(n,o),"utf-8"));}}catch(e){if(e.code!=="ENOENT")throw e}}function u(){let n=new Map;a(w,n),a(A,n);try{n.set("api-skeleton",fs.readFileSync(R,"utf-8"));}catch{}return n}function f(){let n=new Map;return a(y,n),n}function _(n){return r||(r=u()),r.get(n)??""}function O(){return r||(r=u()),r}function S(n){return i||(i=f()),i.get(n)??""}function P(){return i||(i=f()),i}function T(n){return n.map(t=>_(t)).filter(Boolean).join(`
 
-var fs = require('fs');
-var path = require('path');
-var url = require('url');
+---
 
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-// src/index.ts
-var __dirname$1 = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))));
-var PKG_ROOT = path.resolve(__dirname$1, "..");
-function resolveAsset(name) {
-  const fromDist = path.join(PKG_ROOT, name);
-  if (fs.existsSync(fromDist)) {
-    return fromDist;
-  }
-  const fromSrc = path.join(PKG_ROOT, "..", name);
-  if (fs.existsSync(fromSrc)) {
-    return fromSrc;
-  }
-  return fromDist;
-}
-var CORE_DIR = resolveAsset("core");
-var AI_DIR = resolveAsset("ai");
-var EXAMPLES_DIR = resolveAsset("examples");
-var API_SKELETON_PATH = resolveAsset("api-skeleton.md");
-var knowledgeCache = null;
-var exampleCache = null;
-function loadDir(dir, map) {
-  try {
-    const files = fs.readdirSync(dir).filter(
-      (f) => f.endsWith(".md") || f.endsWith(".ts")
-    );
-    for (const file of files) {
-      const name = file.replace(/\.(md|ts)$/, "");
-      map.set(name, fs.readFileSync(path.join(dir, file), "utf-8"));
-    }
-  } catch (err) {
-    if (err.code !== "ENOENT") {
-      throw err;
-    }
-  }
-}
-function loadAllKnowledge() {
-  const map = /* @__PURE__ */ new Map();
-  loadDir(CORE_DIR, map);
-  loadDir(AI_DIR, map);
-  try {
-    map.set("api-skeleton", fs.readFileSync(API_SKELETON_PATH, "utf-8"));
-  } catch {
-  }
-  return map;
-}
-function loadAllExamples() {
-  const map = /* @__PURE__ */ new Map();
-  loadDir(EXAMPLES_DIR, map);
-  return map;
-}
-function getKnowledge(name) {
-  if (!knowledgeCache) {
-    knowledgeCache = loadAllKnowledge();
-  }
-  return knowledgeCache.get(name) ?? "";
-}
-function getAllKnowledge() {
-  if (!knowledgeCache) {
-    knowledgeCache = loadAllKnowledge();
-  }
-  return knowledgeCache;
-}
-function getExample(name) {
-  if (!exampleCache) {
-    exampleCache = loadAllExamples();
-  }
-  return exampleCache.get(name) ?? "";
-}
-function getAllExamples() {
-  if (!exampleCache) {
-    exampleCache = loadAllExamples();
-  }
-  return exampleCache;
-}
-function getKnowledgeFiles(names) {
-  return names.map((name) => getKnowledge(name)).filter(Boolean).join("\n\n---\n\n");
-}
-function getExampleFiles(names) {
-  return names.map((name) => {
-    const content = getExample(name);
-    if (!content) {
-      return "";
-    }
-    return `### Example: ${name}
+`)}function k(n){return n.map(t=>{let e=S(t);return e?`### Example: ${t}
 
 \`\`\`typescript
-${content}
-\`\`\``;
-  }).filter(Boolean).join("\n\n");
-}
-function clearCache() {
-  knowledgeCache = null;
-  exampleCache = null;
-}
+${e}
+\`\`\``:""}).filter(Boolean).join(`
 
-exports.clearCache = clearCache;
-exports.getAllExamples = getAllExamples;
-exports.getAllKnowledge = getAllKnowledge;
-exports.getExample = getExample;
-exports.getExampleFiles = getExampleFiles;
-exports.getKnowledge = getKnowledge;
-exports.getKnowledgeFiles = getKnowledgeFiles;
-//# sourceMappingURL=index.cjs.map
+`)}function v(){r=null,i=null;}exports.clearCache=v;exports.getAllExamples=P;exports.getAllKnowledge=O;exports.getExample=S;exports.getExampleFiles=k;exports.getKnowledge=_;exports.getKnowledgeFiles=T;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["__dirname","dirname","fileURLToPath","resolve","join","existsSync","readdirSync","readFileSync"],"mappings":"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","file":"index.cjs","sourcesContent":["import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n// Resolve package root: works both in src/ (dev) and dist/ (bundled)\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst PKG_ROOT = resolve(__dirname, \"..\");\n\n/**\n * Resolve a path relative to the package root.\n * Tries dist-relative first (bundled), then src-relative (dev).\n */\nfunction resolveAsset(name: string): string {\n  const fromDist = join(PKG_ROOT, name);\n  if (existsSync(fromDist)) {\n    return fromDist;\n  }\n\n  const fromSrc = join(PKG_ROOT, \"..\", name);\n  if (existsSync(fromSrc)) {\n    return fromSrc;\n  }\n\n  return fromDist; // default, will just return empty maps\n}\n\nconst CORE_DIR = resolveAsset(\"core\");\nconst AI_DIR = resolveAsset(\"ai\");\nconst EXAMPLES_DIR = resolveAsset(\"examples\");\nconst API_SKELETON_PATH = resolveAsset(\"api-skeleton.md\");\n\nlet knowledgeCache: Map<string, string> | null = null;\nlet exampleCache: Map<string, string> | null = null;\n\nfunction loadDir(dir: string, map: Map<string, string>): void {\n  try {\n    const files = readdirSync(dir).filter(\n      (f) => f.endsWith(\".md\") || f.endsWith(\".ts\"),\n    );\n    for (const file of files) {\n      const name = file.replace(/\\.(md|ts)$/, \"\");\n      map.set(name, readFileSync(join(dir, file), \"utf-8\"));\n    }\n  } catch (err: unknown) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      throw err;\n    }\n    // directory does not exist — expected during tests or incomplete installs\n  }\n}\n\nfunction loadAllKnowledge(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(CORE_DIR, map);\n  loadDir(AI_DIR, map);\n\n  // Include api-skeleton\n  try {\n    map.set(\"api-skeleton\", readFileSync(API_SKELETON_PATH, \"utf-8\"));\n  } catch {\n    // may not exist yet\n  }\n\n  return map;\n}\n\nfunction loadAllExamples(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(EXAMPLES_DIR, map);\n\n  return map;\n}\n\nexport function getKnowledge(name: string): string {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache.get(name) ?? \"\";\n}\n\nexport function getAllKnowledge(): ReadonlyMap<string, string> {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache;\n}\n\nexport function getExample(name: string): string {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache.get(name) ?? \"\";\n}\n\nexport function getAllExamples(): ReadonlyMap<string, string> {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache;\n}\n\nexport function getKnowledgeFiles(names: string[]): string {\n  return names\n    .map((name) => getKnowledge(name))\n    .filter(Boolean)\n    .join(\"\\n\\n---\\n\\n\");\n}\n\nexport function getExampleFiles(names: string[]): string {\n  return names\n    .map((name) => {\n      const content = getExample(name);\n      if (!content) {\n        return \"\";\n      }\n\n      return `### Example: ${name}\\n\\n\\`\\`\\`typescript\\n${content}\\n\\`\\`\\``;\n    })\n    .filter(Boolean)\n    .join(\"\\n\\n\");\n}\n\n/** Clear cached knowledge and examples. Useful for dev/watch mode. */\nexport function clearCache(): void {\n  knowledgeCache = null;\n  exampleCache = null;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["__dirname","dirname","fileURLToPath","PKG_ROOT","resolve","resolveAsset","name","fromDist","join","existsSync","fromSrc","CORE_DIR","AI_DIR","EXAMPLES_DIR","API_SKELETON_PATH","knowledgeCache","exampleCache","loadDir","dir","map","files","readdirSync","f","file","readFileSync","err","loadAllKnowledge","loadAllExamples","getKnowledge","getAllKnowledge","getExample","getAllExamples","getKnowledgeFiles","names","getExampleFiles","content","clearCache"],"mappings":"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","file":"index.cjs","sourcesContent":["import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n// Resolve package root: works both in src/ (dev) and dist/ (bundled)\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst PKG_ROOT = resolve(__dirname, \"..\");\n\n/**\n * Resolve a path relative to the package root.\n * Tries dist-relative first (bundled), then src-relative (dev).\n */\nfunction resolveAsset(name: string): string {\n  const fromDist = join(PKG_ROOT, name);\n  if (existsSync(fromDist)) {\n    return fromDist;\n  }\n\n  const fromSrc = join(PKG_ROOT, \"..\", name);\n  if (existsSync(fromSrc)) {\n    return fromSrc;\n  }\n\n  return fromDist; // default, will just return empty maps\n}\n\nconst CORE_DIR = resolveAsset(\"core\");\nconst AI_DIR = resolveAsset(\"ai\");\nconst EXAMPLES_DIR = resolveAsset(\"examples\");\nconst API_SKELETON_PATH = resolveAsset(\"api-skeleton.md\");\n\nlet knowledgeCache: Map<string, string> | null = null;\nlet exampleCache: Map<string, string> | null = null;\n\nfunction loadDir(dir: string, map: Map<string, string>): void {\n  try {\n    const files = readdirSync(dir).filter(\n      (f) => f.endsWith(\".md\") || f.endsWith(\".ts\"),\n    );\n    for (const file of files) {\n      const name = file.replace(/\\.(md|ts)$/, \"\");\n      map.set(name, readFileSync(join(dir, file), \"utf-8\"));\n    }\n  } catch (err: unknown) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      throw err;\n    }\n    // directory does not exist — expected during tests or incomplete installs\n  }\n}\n\nfunction loadAllKnowledge(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(CORE_DIR, map);\n  loadDir(AI_DIR, map);\n\n  // Include api-skeleton\n  try {\n    map.set(\"api-skeleton\", readFileSync(API_SKELETON_PATH, \"utf-8\"));\n  } catch {\n    // may not exist yet\n  }\n\n  return map;\n}\n\nfunction loadAllExamples(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(EXAMPLES_DIR, map);\n\n  return map;\n}\n\nexport function getKnowledge(name: string): string {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache.get(name) ?? \"\";\n}\n\nexport function getAllKnowledge(): ReadonlyMap<string, string> {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache;\n}\n\nexport function getExample(name: string): string {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache.get(name) ?? \"\";\n}\n\nexport function getAllExamples(): ReadonlyMap<string, string> {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache;\n}\n\nexport function getKnowledgeFiles(names: string[]): string {\n  return names\n    .map((name) => getKnowledge(name))\n    .filter(Boolean)\n    .join(\"\\n\\n---\\n\\n\");\n}\n\nexport function getExampleFiles(names: string[]): string {\n  return names\n    .map((name) => {\n      const content = getExample(name);\n      if (!content) {\n        return \"\";\n      }\n\n      return `### Example: ${name}\\n\\n\\`\\`\\`typescript\\n${content}\\n\\`\\`\\``;\n    })\n    .filter(Boolean)\n    .join(\"\\n\\n\");\n}\n\n/** Clear cached knowledge and examples. Useful for dev/watch mode. */\nexport function clearCache(): void {\n  knowledgeCache = null;\n  exampleCache = null;\n}\n"]}

package/dist/index.js

@@ -1,102 +1,12 @@
-import { existsSync, readFileSync, readdirSync } from 'fs';
-import { dirname, resolve, join } from 'path';
-import { fileURLToPath } from 'url';
+import {existsSync,readFileSync,readdirSync}from'fs';import {dirname,resolve,join}from'path';import {fileURLToPath}from'url';var h=dirname(fileURLToPath(import.meta.url)),g=resolve(h,"..");function s(n){let t=join(g,n);if(existsSync(t))return t;let e=join(g,"..",n);return existsSync(e)?e:t}var w=s("core"),A=s("ai"),y=s("examples"),R=s("api-skeleton.md"),r=null,i=null;function a(n,t){try{let e=readdirSync(n).filter(o=>o.endsWith(".md")||o.endsWith(".ts"));for(let o of e){let m=o.replace(/\.(md|ts)$/,"");t.set(m,readFileSync(join(n,o),"utf-8"));}}catch(e){if(e.code!=="ENOENT")throw e}}function u(){let n=new Map;a(w,n),a(A,n);try{n.set("api-skeleton",readFileSync(R,"utf-8"));}catch{}return n}function f(){let n=new Map;return a(y,n),n}function _(n){return r||(r=u()),r.get(n)??""}function O(){return r||(r=u()),r}function S(n){return i||(i=f()),i.get(n)??""}function P(){return i||(i=f()),i}function T(n){return n.map(t=>_(t)).filter(Boolean).join(`
 
-// src/index.ts
-var __dirname$1 = dirname(fileURLToPath(import.meta.url));
-var PKG_ROOT = resolve(__dirname$1, "..");
-function resolveAsset(name) {
-  const fromDist = join(PKG_ROOT, name);
-  if (existsSync(fromDist)) {
-    return fromDist;
-  }
-  const fromSrc = join(PKG_ROOT, "..", name);
-  if (existsSync(fromSrc)) {
-    return fromSrc;
-  }
-  return fromDist;
-}
-var CORE_DIR = resolveAsset("core");
-var AI_DIR = resolveAsset("ai");
-var EXAMPLES_DIR = resolveAsset("examples");
-var API_SKELETON_PATH = resolveAsset("api-skeleton.md");
-var knowledgeCache = null;
-var exampleCache = null;
-function loadDir(dir, map) {
-  try {
-    const files = readdirSync(dir).filter(
-      (f) => f.endsWith(".md") || f.endsWith(".ts")
-    );
-    for (const file of files) {
-      const name = file.replace(/\.(md|ts)$/, "");
-      map.set(name, readFileSync(join(dir, file), "utf-8"));
-    }
-  } catch (err) {
-    if (err.code !== "ENOENT") {
-      throw err;
-    }
-  }
-}
-function loadAllKnowledge() {
-  const map = /* @__PURE__ */ new Map();
-  loadDir(CORE_DIR, map);
-  loadDir(AI_DIR, map);
-  try {
-    map.set("api-skeleton", readFileSync(API_SKELETON_PATH, "utf-8"));
-  } catch {
-  }
-  return map;
-}
-function loadAllExamples() {
-  const map = /* @__PURE__ */ new Map();
-  loadDir(EXAMPLES_DIR, map);
-  return map;
-}
-function getKnowledge(name) {
-  if (!knowledgeCache) {
-    knowledgeCache = loadAllKnowledge();
-  }
-  return knowledgeCache.get(name) ?? "";
-}
-function getAllKnowledge() {
-  if (!knowledgeCache) {
-    knowledgeCache = loadAllKnowledge();
-  }
-  return knowledgeCache;
-}
-function getExample(name) {
-  if (!exampleCache) {
-    exampleCache = loadAllExamples();
-  }
-  return exampleCache.get(name) ?? "";
-}
-function getAllExamples() {
-  if (!exampleCache) {
-    exampleCache = loadAllExamples();
-  }
-  return exampleCache;
-}
-function getKnowledgeFiles(names) {
-  return names.map((name) => getKnowledge(name)).filter(Boolean).join("\n\n---\n\n");
-}
-function getExampleFiles(names) {
-  return names.map((name) => {
-    const content = getExample(name);
-    if (!content) {
-      return "";
-    }
-    return `### Example: ${name}
+---
+
+`)}function k(n){return n.map(t=>{let e=S(t);return e?`### Example: ${t}
 
 \`\`\`typescript
-${content}
-\`\`\``;
-  }).filter(Boolean).join("\n\n");
-}
-function clearCache() {
-  knowledgeCache = null;
-  exampleCache = null;
-}
+${e}
+\`\`\``:""}).filter(Boolean).join(`
 
-export { clearCache, getAllExamples, getAllKnowledge, getExample, getExampleFiles, getKnowledge, getKnowledgeFiles };
-//# sourceMappingURL=index.js.map
+`)}function v(){r=null,i=null;}export{v as clearCache,P as getAllExamples,O as getAllKnowledge,S as getExample,k as getExampleFiles,_ as getKnowledge,T as getKnowledgeFiles};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":["__dirname"],"mappings":"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","file":"index.js","sourcesContent":["import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n// Resolve package root: works both in src/ (dev) and dist/ (bundled)\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst PKG_ROOT = resolve(__dirname, \"..\");\n\n/**\n * Resolve a path relative to the package root.\n * Tries dist-relative first (bundled), then src-relative (dev).\n */\nfunction resolveAsset(name: string): string {\n  const fromDist = join(PKG_ROOT, name);\n  if (existsSync(fromDist)) {\n    return fromDist;\n  }\n\n  const fromSrc = join(PKG_ROOT, \"..\", name);\n  if (existsSync(fromSrc)) {\n    return fromSrc;\n  }\n\n  return fromDist; // default, will just return empty maps\n}\n\nconst CORE_DIR = resolveAsset(\"core\");\nconst AI_DIR = resolveAsset(\"ai\");\nconst EXAMPLES_DIR = resolveAsset(\"examples\");\nconst API_SKELETON_PATH = resolveAsset(\"api-skeleton.md\");\n\nlet knowledgeCache: Map<string, string> | null = null;\nlet exampleCache: Map<string, string> | null = null;\n\nfunction loadDir(dir: string, map: Map<string, string>): void {\n  try {\n    const files = readdirSync(dir).filter(\n      (f) => f.endsWith(\".md\") || f.endsWith(\".ts\"),\n    );\n    for (const file of files) {\n      const name = file.replace(/\\.(md|ts)$/, \"\");\n      map.set(name, readFileSync(join(dir, file), \"utf-8\"));\n    }\n  } catch (err: unknown) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      throw err;\n    }\n    // directory does not exist — expected during tests or incomplete installs\n  }\n}\n\nfunction loadAllKnowledge(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(CORE_DIR, map);\n  loadDir(AI_DIR, map);\n\n  // Include api-skeleton\n  try {\n    map.set(\"api-skeleton\", readFileSync(API_SKELETON_PATH, \"utf-8\"));\n  } catch {\n    // may not exist yet\n  }\n\n  return map;\n}\n\nfunction loadAllExamples(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(EXAMPLES_DIR, map);\n\n  return map;\n}\n\nexport function getKnowledge(name: string): string {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache.get(name) ?? \"\";\n}\n\nexport function getAllKnowledge(): ReadonlyMap<string, string> {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache;\n}\n\nexport function getExample(name: string): string {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache.get(name) ?? \"\";\n}\n\nexport function getAllExamples(): ReadonlyMap<string, string> {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache;\n}\n\nexport function getKnowledgeFiles(names: string[]): string {\n  return names\n    .map((name) => getKnowledge(name))\n    .filter(Boolean)\n    .join(\"\\n\\n---\\n\\n\");\n}\n\nexport function getExampleFiles(names: string[]): string {\n  return names\n    .map((name) => {\n      const content = getExample(name);\n      if (!content) {\n        return \"\";\n      }\n\n      return `### Example: ${name}\\n\\n\\`\\`\\`typescript\\n${content}\\n\\`\\`\\``;\n    })\n    .filter(Boolean)\n    .join(\"\\n\\n\");\n}\n\n/** Clear cached knowledge and examples. Useful for dev/watch mode. */\nexport function clearCache(): void {\n  knowledgeCache = null;\n  exampleCache = null;\n}\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":["__dirname","dirname","fileURLToPath","PKG_ROOT","resolve","resolveAsset","name","fromDist","join","existsSync","fromSrc","CORE_DIR","AI_DIR","EXAMPLES_DIR","API_SKELETON_PATH","knowledgeCache","exampleCache","loadDir","dir","map","files","readdirSync","f","file","readFileSync","err","loadAllKnowledge","loadAllExamples","getKnowledge","getAllKnowledge","getExample","getAllExamples","getKnowledgeFiles","names","getExampleFiles","content","clearCache"],"mappings":"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","file":"index.js","sourcesContent":["import { existsSync, readFileSync, readdirSync } from \"node:fs\";\nimport { dirname, join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\n// Resolve package root: works both in src/ (dev) and dist/ (bundled)\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst PKG_ROOT = resolve(__dirname, \"..\");\n\n/**\n * Resolve a path relative to the package root.\n * Tries dist-relative first (bundled), then src-relative (dev).\n */\nfunction resolveAsset(name: string): string {\n  const fromDist = join(PKG_ROOT, name);\n  if (existsSync(fromDist)) {\n    return fromDist;\n  }\n\n  const fromSrc = join(PKG_ROOT, \"..\", name);\n  if (existsSync(fromSrc)) {\n    return fromSrc;\n  }\n\n  return fromDist; // default, will just return empty maps\n}\n\nconst CORE_DIR = resolveAsset(\"core\");\nconst AI_DIR = resolveAsset(\"ai\");\nconst EXAMPLES_DIR = resolveAsset(\"examples\");\nconst API_SKELETON_PATH = resolveAsset(\"api-skeleton.md\");\n\nlet knowledgeCache: Map<string, string> | null = null;\nlet exampleCache: Map<string, string> | null = null;\n\nfunction loadDir(dir: string, map: Map<string, string>): void {\n  try {\n    const files = readdirSync(dir).filter(\n      (f) => f.endsWith(\".md\") || f.endsWith(\".ts\"),\n    );\n    for (const file of files) {\n      const name = file.replace(/\\.(md|ts)$/, \"\");\n      map.set(name, readFileSync(join(dir, file), \"utf-8\"));\n    }\n  } catch (err: unknown) {\n    if ((err as NodeJS.ErrnoException).code !== \"ENOENT\") {\n      throw err;\n    }\n    // directory does not exist — expected during tests or incomplete installs\n  }\n}\n\nfunction loadAllKnowledge(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(CORE_DIR, map);\n  loadDir(AI_DIR, map);\n\n  // Include api-skeleton\n  try {\n    map.set(\"api-skeleton\", readFileSync(API_SKELETON_PATH, \"utf-8\"));\n  } catch {\n    // may not exist yet\n  }\n\n  return map;\n}\n\nfunction loadAllExamples(): Map<string, string> {\n  const map = new Map<string, string>();\n  loadDir(EXAMPLES_DIR, map);\n\n  return map;\n}\n\nexport function getKnowledge(name: string): string {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache.get(name) ?? \"\";\n}\n\nexport function getAllKnowledge(): ReadonlyMap<string, string> {\n  if (!knowledgeCache) {\n    knowledgeCache = loadAllKnowledge();\n  }\n\n  return knowledgeCache;\n}\n\nexport function getExample(name: string): string {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache.get(name) ?? \"\";\n}\n\nexport function getAllExamples(): ReadonlyMap<string, string> {\n  if (!exampleCache) {\n    exampleCache = loadAllExamples();\n  }\n\n  return exampleCache;\n}\n\nexport function getKnowledgeFiles(names: string[]): string {\n  return names\n    .map((name) => getKnowledge(name))\n    .filter(Boolean)\n    .join(\"\\n\\n---\\n\\n\");\n}\n\nexport function getExampleFiles(names: string[]): string {\n  return names\n    .map((name) => {\n      const content = getExample(name);\n      if (!content) {\n        return \"\";\n      }\n\n      return `### Example: ${name}\\n\\n\\`\\`\\`typescript\\n${content}\\n\\`\\`\\``;\n    })\n    .filter(Boolean)\n    .join(\"\\n\\n\");\n}\n\n/** Clear cached knowledge and examples. Useful for dev/watch mode. */\nexport function clearCache(): void {\n  knowledgeCache = null;\n  exampleCache = null;\n}\n"]}