nexus-agents 2.28.0 → 2.29.1

package/dist/chunk-CLYZ7FWP.js

@@ -0,0 +1,30 @@
+// src/config/learning-persistence.ts
+import { mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+function safeHomedir() {
+  try {
+    return homedir() || "/tmp";
+  } catch {
+    return "/tmp";
+  }
+}
+var LEARNING_DIR = join(safeHomedir(), ".nexus-agents", "learning");
+var OUTCOMES_FILE = join(LEARNING_DIR, "outcomes.jsonl");
+var RULES_FILE = join(LEARNING_DIR, "rules.json");
+var DIR_MODE = 448;
+function isPersistenceEnabled() {
+  return process.env["NEXUS_PERSIST_LEARNING"] !== "false";
+}
+function ensureLearningDir(dir = LEARNING_DIR) {
+  mkdirSync(dir, { recursive: true, mode: DIR_MODE });
+}
+
+export {
+  LEARNING_DIR,
+  OUTCOMES_FILE,
+  RULES_FILE,
+  isPersistenceEnabled,
+  ensureLearningDir
+};
+//# sourceMappingURL=chunk-CLYZ7FWP.js.map

package/dist/chunk-CLYZ7FWP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/learning-persistence.ts"],"sourcesContent":["/**\n * Shared configuration for cross-session learning persistence.\n *\n * Controls where learning data (outcomes, distilled rules) is stored\n * on disk and whether persistence is enabled via feature flag.\n *\n * @module config/learning-persistence\n * (Source: Issue #1009 — Cross-session persistence)\n */\n\nimport { mkdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { homedir } from 'node:os';\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** Resolve home directory with fallback for mocked environments. */\nfunction safeHomedir(): string {\n  try {\n    return homedir() || '/tmp';\n  } catch {\n    return '/tmp';\n  }\n}\n\n/** Base directory for learning persistence data. */\nexport const LEARNING_DIR = join(safeHomedir(), '.nexus-agents', 'learning');\n\n/** JSONL file for persisted task outcomes. */\nexport const OUTCOMES_FILE = join(LEARNING_DIR, 'outcomes.jsonl');\n\n/** JSON file for persisted distilled rules. */\nexport const RULES_FILE = join(LEARNING_DIR, 'rules.json');\n\n/** Directory mode: owner-only (rwx------). */\nconst DIR_MODE = 0o700;\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\n/**\n * Check whether learning persistence is enabled via feature flag.\n *\n * Defaults to true — cross-session LinUCB routing data persists to\n * `~/.nexus-agents/learning/` unless explicitly disabled.\n * Only routing metadata is stored (model, success, duration, category).\n * No user prompts, API keys, or model outputs are persisted.\n *\n * Set NEXUS_PERSIST_LEARNING=false to disable.\n */\nexport function isPersistenceEnabled(): boolean {\n  return process.env['NEXUS_PERSIST_LEARNING'] !== 'false';\n}\n\n/** Ensure the learning data directory exists. */\nexport function ensureLearningDir(dir: string = LEARNING_DIR): void {\n  mkdirSync(dir, { recursive: true, mode: DIR_MODE });\n}\n"],"mappings":";AAUA,SAAS,iBAAiB;AAC1B,SAAS,YAAY;AACrB,SAAS,eAAe;AAOxB,SAAS,cAAsB;AAC7B,MAAI;AACF,WAAO,QAAQ,KAAK;AAAA,EACtB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,IAAM,eAAe,KAAK,YAAY,GAAG,iBAAiB,UAAU;AAGpE,IAAM,gBAAgB,KAAK,cAAc,gBAAgB;AAGzD,IAAM,aAAa,KAAK,cAAc,YAAY;AAGzD,IAAM,WAAW;AAgBV,SAAS,uBAAgC;AAC9C,SAAO,QAAQ,IAAI,wBAAwB,MAAM;AACnD;AAGO,SAAS,kBAAkB,MAAc,cAAoB;AAClE,YAAU,KAAK,EAAE,WAAW,MAAM,MAAM,SAAS,CAAC;AACpD;","names":[]}

package/dist/chunk-ED6VQWNG.js

@@ -0,0 +1,63 @@
+// src/pipeline/shared-memory.ts
+var SharedMemoryStore = class {
+  entries = [];
+  maxEntries;
+  constructor(maxEntries = 100) {
+    this.maxEntries = maxEntries;
+  }
+  /** Write a memory entry. */
+  write(sourceStage, tag, content) {
+    if (this.entries.length >= this.maxEntries) {
+      this.entries.shift();
+    }
+    this.entries.push({
+      sourceStage,
+      tag,
+      content,
+      timestamp: Date.now()
+    });
+  }
+  /** Read all entries, optionally filtered by tag. */
+  read(tag) {
+    if (tag === void 0) return [...this.entries];
+    return this.entries.filter((e) => e.tag === tag);
+  }
+  /** Read entries from a specific stage. */
+  readFromStage(sourceStage) {
+    return this.entries.filter((e) => e.sourceStage === sourceStage);
+  }
+  /** Get summary of all entries as context string for LLM consumption. */
+  summarize(maxLength = 2e3) {
+    if (this.entries.length === 0) return "";
+    const lines = this.entries.map(
+      (e) => `[${e.tag}] (from ${e.sourceStage}): ${formatContent(e.content)}`
+    );
+    const joined = lines.join("\n");
+    if (joined.length <= maxLength) return joined;
+    return `${joined.slice(0, maxLength - 3)}...`;
+  }
+  /** Get entry count. */
+  get size() {
+    return this.entries.length;
+  }
+  /** Clear all entries. */
+  clear() {
+    this.entries.length = 0;
+  }
+};
+function formatContent(content) {
+  if (typeof content === "string") return content.slice(0, 200);
+  if (typeof content === "object" && content !== null) {
+    try {
+      return JSON.stringify(content).slice(0, 200);
+    } catch {
+      return "[object]";
+    }
+  }
+  return String(content);
+}
+
+export {
+  SharedMemoryStore
+};
+//# sourceMappingURL=chunk-ED6VQWNG.js.map

package/dist/chunk-ED6VQWNG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/pipeline/shared-memory.ts"],"sourcesContent":["/**\n * Shared Memory — Cross-stage knowledge propagation (#1737, Phase 4)\n *\n * Early pipeline stages (planning, research) write structured discoveries\n * to a shared memory layer. Later stages read before acting.\n *\n * Scoped to a single pipeline run — not persisted cross-session.\n *\n * Pattern from: SWE-AF shared memory, AutoGen knowledge propagation.\n *\n * @module pipeline/shared-memory\n */\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/** A tagged memory entry written by a pipeline stage. */\nexport interface SharedMemoryEntry {\n  /** Stage that wrote this entry. */\n  readonly sourceStage: string;\n  /** Category tag for filtering. */\n  readonly tag: SharedMemoryTag;\n  /** The content (structured or text). */\n  readonly content: unknown;\n  /** When this was written. */\n  readonly timestamp: number;\n}\n\n/** Tags for categorizing shared memory entries. */\nexport type SharedMemoryTag =\n  | 'convention'\n  | 'discovery'\n  | 'constraint'\n  | 'decision'\n  | 'risk'\n  | 'dependency'\n  | 'context';\n\n// ============================================================================\n// Shared Memory Store (per-pipeline-run)\n// ============================================================================\n\n/** In-memory store for cross-stage knowledge sharing. */\nexport class SharedMemoryStore {\n  private readonly entries: SharedMemoryEntry[] = [];\n  private readonly maxEntries: number;\n\n  constructor(maxEntries = 100) {\n    this.maxEntries = maxEntries;\n  }\n\n  /** Write a memory entry. */\n  write(sourceStage: string, tag: SharedMemoryTag, content: unknown): void {\n    if (this.entries.length >= this.maxEntries) {\n      this.entries.shift(); // Evict oldest\n    }\n    this.entries.push({\n      sourceStage,\n      tag,\n      content,\n      timestamp: Date.now(),\n    });\n  }\n\n  /** Read all entries, optionally filtered by tag. */\n  read(tag?: SharedMemoryTag): readonly SharedMemoryEntry[] {\n    if (tag === undefined) return [...this.entries];\n    return this.entries.filter((e) => e.tag === tag);\n  }\n\n  /** Read entries from a specific stage. */\n  readFromStage(sourceStage: string): readonly SharedMemoryEntry[] {\n    return this.entries.filter((e) => e.sourceStage === sourceStage);\n  }\n\n  /** Get summary of all entries as context string for LLM consumption. */\n  summarize(maxLength = 2000): string {\n    if (this.entries.length === 0) return '';\n    const lines = this.entries.map(\n      (e) => `[${e.tag}] (from ${e.sourceStage}): ${formatContent(e.content)}`\n    );\n    const joined = lines.join('\\n');\n    if (joined.length <= maxLength) return joined;\n    return `${joined.slice(0, maxLength - 3)}...`;\n  }\n\n  /** Get entry count. */\n  get size(): number {\n    return this.entries.length;\n  }\n\n  /** Clear all entries. */\n  clear(): void {\n    this.entries.length = 0;\n  }\n}\n\n/** Format content for summarization. */\nfunction formatContent(content: unknown): string {\n  if (typeof content === 'string') return content.slice(0, 200);\n  if (typeof content === 'object' && content !== null) {\n    try {\n      return JSON.stringify(content).slice(0, 200);\n    } catch {\n      return '[object]';\n    }\n  }\n  return String(content);\n}\n"],"mappings":";AA4CO,IAAM,oBAAN,MAAwB;AAAA,EACZ,UAA+B,CAAC;AAAA,EAChC;AAAA,EAEjB,YAAY,aAAa,KAAK;AAC5B,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA,EAGA,MAAM,aAAqB,KAAsB,SAAwB;AACvE,QAAI,KAAK,QAAQ,UAAU,KAAK,YAAY;AAC1C,WAAK,QAAQ,MAAM;AAAA,IACrB;AACA,SAAK,QAAQ,KAAK;AAAA,MAChB;AAAA,MACA;AAAA,MACA;AAAA,MACA,WAAW,KAAK,IAAI;AAAA,IACtB,CAAC;AAAA,EACH;AAAA;AAAA,EAGA,KAAK,KAAqD;AACxD,QAAI,QAAQ,OAAW,QAAO,CAAC,GAAG,KAAK,OAAO;AAC9C,WAAO,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG;AAAA,EACjD;AAAA;AAAA,EAGA,cAAc,aAAmD;AAC/D,WAAO,KAAK,QAAQ,OAAO,CAAC,MAAM,EAAE,gBAAgB,WAAW;AAAA,EACjE;AAAA;AAAA,EAGA,UAAU,YAAY,KAAc;AAClC,QAAI,KAAK,QAAQ,WAAW,EAAG,QAAO;AACtC,UAAM,QAAQ,KAAK,QAAQ;AAAA,MACzB,CAAC,MAAM,IAAI,EAAE,GAAG,WAAW,EAAE,WAAW,MAAM,cAAc,EAAE,OAAO,CAAC;AAAA,IACxE;AACA,UAAM,SAAS,MAAM,KAAK,IAAI;AAC9B,QAAI,OAAO,UAAU,UAAW,QAAO;AACvC,WAAO,GAAG,OAAO,MAAM,GAAG,YAAY,CAAC,CAAC;AAAA,EAC1C;AAAA;AAAA,EAGA,IAAI,OAAe;AACjB,WAAO,KAAK,QAAQ;AAAA,EACtB;AAAA;AAAA,EAGA,QAAc;AACZ,SAAK,QAAQ,SAAS;AAAA,EACxB;AACF;AAGA,SAAS,cAAc,SAA0B;AAC/C,MAAI,OAAO,YAAY,SAAU,QAAO,QAAQ,MAAM,GAAG,GAAG;AAC5D,MAAI,OAAO,YAAY,YAAY,YAAY,MAAM;AACnD,QAAI;AACF,aAAO,KAAK,UAAU,OAAO,EAAE,MAAM,GAAG,GAAG;AAAA,IAC7C,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO,OAAO,OAAO;AACvB;","names":[]}