agent-bober 0.15.0 → 0.17.0

package/dist/state/memory.d.ts

@@ -0,0 +1,60 @@
+import { z } from "zod";
+export declare const LessonEntrySchema: z.ZodObject<{
+    lessonId: z.ZodString;
+    createdAt: z.ZodString;
+    category: z.ZodString;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    summary: z.ZodString;
+    occurrences: z.ZodNumber;
+    severity: z.ZodEnum<["info", "warn", "high"]>;
+    sourceEntryRefs: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    severity: "info" | "high" | "warn";
+    summary: string;
+    category: string;
+    createdAt: string;
+    lessonId: string;
+    tags: string[];
+    occurrences: number;
+    sourceEntryRefs: string[];
+}, {
+    severity: "info" | "high" | "warn";
+    summary: string;
+    category: string;
+    createdAt: string;
+    lessonId: string;
+    occurrences: number;
+    sourceEntryRefs: string[];
+    tags?: string[] | undefined;
+}>;
+export type LessonEntry = z.infer<typeof LessonEntrySchema>;
+export interface LessonIndexRecord {
+    lessonId: string;
+    category: string;
+    severity: string;
+    occurrences: number;
+    tags: string[];
+    summarySnippet: string;
+}
+/**
+ * Append (or update) a lesson to the .bober/memory/ store.
+ * Writes <lessonId>.md with hand-rolled front-matter plus a human body.
+ * Upserts exactly one INDEX.md line for this lessonId (replace if exists, else append).
+ * Throws if the lesson fails schema validation (sourceEntryRefs must be non-empty).
+ */
+export declare function appendLesson(projectRoot: string, lesson: LessonEntry): Promise<void>;
+/**
+ * Load at most `limit` lesson index records from INDEX.md.
+ * Never opens individual lesson files — parses only INDEX.md.
+ * Returns an empty array if INDEX.md does not exist.
+ */
+export declare function loadLessonIndex(projectRoot: string, { limit }: {
+    limit: number;
+}): Promise<LessonIndexRecord[]>;
+/**
+ * Load a single lesson by ID from its <lessonId>.md file.
+ * Parses front-matter and validates against LessonEntrySchema.
+ * Throws a descriptive error if the file does not exist or fails validation.
+ */
+export declare function loadLesson(projectRoot: string, lessonId: string): Promise<LessonEntry>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/state/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/state/memory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AA6ID;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAkCf;AAID;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoB9B;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CAkCtB"}

package/dist/state/memory.js

@@ -0,0 +1,242 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { z } from "zod";
+import { ensureDir } from "./helpers.js";
+// ── Constants ───────────────────────────────────────────────────────
+const BOBER_DIR = ".bober";
+const MEMORY_DIR = "memory";
+const INDEX_FILE = "INDEX.md";
+// ── Path Helpers ─────────────────────────────────────────────────────
+function memoryDir(projectRoot) {
+    return join(projectRoot, BOBER_DIR, MEMORY_DIR);
+}
+function lessonPath(projectRoot, lessonId) {
+    return join(memoryDir(projectRoot), `${lessonId}.md`);
+}
+function indexPath(projectRoot) {
+    return join(memoryDir(projectRoot), INDEX_FILE);
+}
+// ── Schema ───────────────────────────────────────────────────────────
+export const LessonEntrySchema = z.object({
+    lessonId: z.string().min(1),
+    createdAt: z.string().datetime(),
+    category: z.string().min(1),
+    tags: z.array(z.string()).default([]),
+    summary: z.string().min(1),
+    occurrences: z.number().int().positive(),
+    severity: z.enum(["info", "warn", "high"]),
+    sourceEntryRefs: z.array(z.string().min(1)).min(1),
+});
+// ── Serialization ─────────────────────────────────────────────────────
+/**
+ * Serialize a LessonEntry to a markdown file with hand-rolled front-matter.
+ * Arrays (tags, sourceEntryRefs) are emitted as YAML block sequences.
+ */
+function serializeLesson(lesson) {
+    const tagsBlock = lesson.tags.length > 0
+        ? `tags:\n${lesson.tags.map((t) => `  - ${t}`).join("\n")}`
+        : `tags: []`;
+    const refsBlock = `sourceEntryRefs:\n${lesson.sourceEntryRefs.map((r) => `  - ${r}`).join("\n")}`;
+    const frontMatter = [
+        `lessonId: ${lesson.lessonId}`,
+        `createdAt: ${lesson.createdAt}`,
+        `category: ${lesson.category}`,
+        tagsBlock,
+        `summary: ${lesson.summary}`,
+        `occurrences: ${lesson.occurrences}`,
+        `severity: ${lesson.severity}`,
+        refsBlock,
+    ].join("\n");
+    const body = `Lesson: ${lesson.lessonId}\n\nCategory: ${lesson.category}\nSeverity: ${lesson.severity}\nOccurrences: ${lesson.occurrences}\n\nSummary:\n${lesson.summary}\n\nSource References:\n${lesson.sourceEntryRefs.map((r) => `- ${r}`).join("\n")}\n`;
+    return `---\n${frontMatter}\n---\n\n${body}`;
+}
+/**
+ * Build a single INDEX.md line for a lesson, following the MEMORY.md curated-index format:
+ * - <lessonId> [<category>/<severity>] (x<occurrences>) tags: a,b — <summary first 80 chars>
+ */
+function buildIndexLine(lesson) {
+    const tagsStr = lesson.tags.length > 0 ? lesson.tags.join(",") : "";
+    const snippet = lesson.summary.slice(0, 80);
+    const tagsSegment = tagsStr ? `tags: ${tagsStr}` : `tags:`;
+    return `- ${lesson.lessonId} [${lesson.category}/${lesson.severity}] (x${lesson.occurrences}) ${tagsSegment} — ${snippet}`;
+}
+/**
+ * Parse a single INDEX.md line into a LessonIndexRecord.
+ * Returns null for lines that do not match the expected format.
+ */
+function parseIndexLine(line) {
+    // Expected: - <lessonId> [<category>/<severity>] (x<occurrences>) tags: a,b — <snippet>
+    const match = line.match(/^- (\S+) \[([^/\]]+)\/([^\]]+)\] \(x(\d+)\) tags: ([^—]*)— (.*)$/);
+    if (!match)
+        return null;
+    const [, lessonId, category, severity, occStr, tagsRaw, summarySnippet] = match;
+    const tags = tagsRaw.trim()
+        ? tagsRaw
+            .trim()
+            .split(",")
+            .map((t) => t.trim())
+            .filter(Boolean)
+        : [];
+    return {
+        lessonId: lessonId.trim(),
+        category: category.trim(),
+        severity: severity.trim(),
+        occurrences: Number(occStr),
+        tags,
+        summarySnippet: summarySnippet.trim(),
+    };
+}
+/**
+ * Parse the front-matter block from a lesson markdown file.
+ * Uses the hand-rolled regex approach from src/orchestrator/agent-loader.ts.
+ * Returns null if the file does not have the expected front-matter delimiters.
+ */
+function parseLessonFrontMatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n([\s\S]*)$/);
+    if (!match)
+        return null;
+    const [, yamlBlock] = match;
+    const meta = {};
+    let currentKey = null;
+    let currentList = null;
+    for (const line of yamlBlock.split("\n")) {
+        const trimmed = line.trim();
+        // Block sequence item (e.g. "  - value")
+        if (line.startsWith("  - ") && currentKey !== null && currentList !== null) {
+            currentList.push(line.slice(4).trim());
+            continue;
+        }
+        // Flush any pending list on a new key
+        if (currentKey !== null && currentList !== null && !line.startsWith("  ")) {
+            meta[currentKey] = currentList;
+            currentKey = null;
+            currentList = null;
+        }
+        if (trimmed.length === 0)
+            continue;
+        // Key: value or Key: (block sequence start)
+        const kvMatch = trimmed.match(/^([\w-]+):\s*(.*)$/);
+        if (!kvMatch)
+            continue;
+        const [, key, value] = kvMatch;
+        if (value === "[]") {
+            // Explicit empty array
+            meta[key] = [];
+            continue;
+        }
+        if (!value) {
+            // Start of a block sequence
+            currentKey = key;
+            currentList = [];
+            continue;
+        }
+        // Scalar value
+        meta[key] = value;
+    }
+    // Flush trailing list
+    if (currentKey !== null && currentList !== null) {
+        meta[currentKey] = currentList;
+    }
+    return meta;
+}
+// ── Persistence ──────────────────────────────────────────────────────
+/**
+ * Append (or update) a lesson to the .bober/memory/ store.
+ * Writes <lessonId>.md with hand-rolled front-matter plus a human body.
+ * Upserts exactly one INDEX.md line for this lessonId (replace if exists, else append).
+ * Throws if the lesson fails schema validation (sourceEntryRefs must be non-empty).
+ */
+export async function appendLesson(projectRoot, lesson) {
+    const validation = LessonEntrySchema.safeParse(lesson);
+    if (!validation.success) {
+        const issues = validation.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Invalid lesson entry:\n${issues}`);
+    }
+    const dir = memoryDir(projectRoot);
+    await ensureDir(dir);
+    // Write the lesson markdown file
+    await writeFile(lessonPath(projectRoot, lesson.lessonId), serializeLesson(lesson), "utf-8");
+    // Upsert one INDEX.md line for this lessonId
+    const idxPath = indexPath(projectRoot);
+    let existingContent = "";
+    try {
+        existingContent = await readFile(idxPath, "utf-8");
+    }
+    catch {
+        // INDEX.md does not exist yet — treat as empty
+    }
+    const lines = existingContent.split("\n").filter((l) => l.trim().length > 0);
+    // Drop any prior line for this lessonId (match leading "- <lessonId> " token)
+    const filtered = lines.filter((l) => {
+        const parts = l.split(" ");
+        // parts[0] = "-", parts[1] = lessonId
+        return !(parts[0] === "-" && parts[1] === lesson.lessonId);
+    });
+    filtered.push(buildIndexLine(lesson));
+    await writeFile(idxPath, filtered.join("\n") + "\n", "utf-8");
+}
+// ── Read ─────────────────────────────────────────────────────────────
+/**
+ * Load at most `limit` lesson index records from INDEX.md.
+ * Never opens individual lesson files — parses only INDEX.md.
+ * Returns an empty array if INDEX.md does not exist.
+ */
+export async function loadLessonIndex(projectRoot, { limit }) {
+    let content;
+    try {
+        content = await readFile(indexPath(projectRoot), "utf-8");
+    }
+    catch {
+        // INDEX.md does not exist yet
+        return [];
+    }
+    const lines = content.split("\n").filter((l) => l.trim().length > 0);
+    const records = [];
+    for (const line of lines) {
+        const record = parseIndexLine(line);
+        if (record !== null) {
+            records.push(record);
+        }
+    }
+    return records.slice(-limit);
+}
+/**
+ * Load a single lesson by ID from its <lessonId>.md file.
+ * Parses front-matter and validates against LessonEntrySchema.
+ * Throws a descriptive error if the file does not exist or fails validation.
+ */
+export async function loadLesson(projectRoot, lessonId) {
+    let raw;
+    try {
+        raw = await readFile(lessonPath(projectRoot, lessonId), "utf-8");
+    }
+    catch {
+        throw new Error(`Lesson not found: ${lessonId} (path: ${lessonPath(projectRoot, lessonId)})`);
+    }
+    const meta = parseLessonFrontMatter(raw);
+    if (meta === null) {
+        throw new Error(`Lesson file for ${lessonId} has no valid front-matter`);
+    }
+    // Reconstruct lesson object from parsed meta — coerce numeric fields
+    const candidate = {
+        lessonId: meta["lessonId"],
+        createdAt: meta["createdAt"],
+        category: meta["category"],
+        tags: meta["tags"] ?? [],
+        summary: meta["summary"],
+        occurrences: Number(meta["occurrences"]),
+        severity: meta["severity"],
+        sourceEntryRefs: meta["sourceEntryRefs"],
+    };
+    const result = LessonEntrySchema.safeParse(candidate);
+    if (!result.success) {
+        const issues = result.error.issues
+            .map((i) => `  - ${i.path.join(".")}: ${i.message}`)
+            .join("\n");
+        throw new Error(`Lesson file for ${lessonId} failed validation:\n${issues}`);
+    }
+    return result.data;
+}
+//# sourceMappingURL=memory.js.map

package/dist/state/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/state/memory.ts"],"names":[],"mappings":"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"}

package/hooks/hooks.json

@@ -15,11 +15,21 @@
     "PostToolUse": [
       {
         "matcher": "Edit|Write",
-        "command": "echo 'Files modified — run /bober:eval to verify'"
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo 'Files modified — run /bober:eval to verify'"
+          }
+        ]
       },
       {
         "matcher": "Edit|Write",
-        "command": "node scripts/graph-hook.mjs"
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT:-.}/scripts/graph-hook.mjs"
+          }
+        ]
       }
     ]
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-bober",
-  "version": "0.15.0",
-  "description": "Multi-agent harness for building applications autonomously with any LLM. Researcher, Planner, Curator, Generator, Evaluator pipeline. Supports Claude, GPT, Gemini, Ollama. MCP server for Cursor/Windsurf.",
+  "version": "0.17.0",
+  "description": "Multi-agent harness for building applications autonomously with any LLM. Researcher, Planner, Curator, Generator, Evaluator, Documenter pipeline. Supports Claude, GPT, Gemini, DeepSeek, Ollama, and Claude Code subscriptions. MCP server for Cursor/Windsurf.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -14,6 +14,8 @@
     "lint": "eslint src/",
     "typecheck": "tsc --noEmit",
     "test": "vitest",
+    "update-all": "node scripts/update-all.mjs",
+    "update-all:check": "node scripts/update-all.mjs --check",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -28,6 +30,7 @@
     "claude",
     "openai",
     "gemini",
+    "deepseek",
     "ollama",
     "plugin"
   ],
@@ -66,11 +69,12 @@
     "ora": "^8.1.1",
     "prompts": "^2.4.2",
     "semver": "^7.8.1",
-    "zod": "^3.24.2"
+    "zod": "^3.24.2",
+    "zod-to-json-schema": "^3.25.2"
   },
   "peerDependencies": {
     "@google/generative-ai": ">=0.21.0",
-    "openai": ">=4.0.0"
+    "openai": "^6.42.0"
   },
   "peerDependenciesMeta": {
     "openai": {
@@ -87,7 +91,7 @@
     "@types/semver": "^7.7.1",
     "@typescript-eslint/eslint-plugin": "^8.22.0",
     "@typescript-eslint/parser": "^8.22.0",
-    "eslint": "^9.19.0",
+    "eslint": "^10.0.0",
     "markdownlint-cli": "^0.48.0",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5"

package/scripts/spike-claude-code-provider.mjs

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+// SPIKE runner: prove ClaudeCodeAdapter satisfies LLMClient.chat() end-to-end
+// against the user's Claude subscription (NO ANTHROPIC_API_KEY).
+//
+//   node scripts/spike-claude-code-provider.mjs
+//
+// Builds nothing; imports the compiled dist adapter (run `npm run build` first).
+// Exercises the real `claude -p` subprocess. Prints the normalized ChatResponse
+// and asserts the contract shape. Also demonstrates the tools-rejection guard.
+
+import { spawnSync } from "node:child_process";
+import { ClaudeCodeAdapter } from "../dist/providers/claude-code.js";
+
+const probe = spawnSync("claude", ["--version"], { stdio: "ignore" });
+if (probe.error || probe.status !== 0) {
+  console.log("SKIP: `claude` binary not on PATH — skipping claude-code smoke.");
+  process.exit(0);
+}
+
+function assert(cond, msg) {
+  if (!cond) {
+    console.error("ASSERT FAILED:", msg);
+    process.exit(1);
+  }
+}
+
+const adapter = new ClaudeCodeAdapter();
+
+console.log("── Spike 1: no-tools planner-style completion (real subscription call) ──");
+const res = await adapter.chat({
+  model: "haiku", // cheapest for a spike; proves the seam without burning credit
+  system:
+    "You are a terse planning assistant. Answer in one short sentence, no preamble.",
+  messages: [
+    { role: "user", content: "Name one risk of building a feature without tests." },
+  ],
+});
+
+console.log("text:", JSON.stringify(res.text));
+console.log("stopReason:", res.stopReason);
+console.log("usage:", JSON.stringify(res.usage));
+
+assert(typeof res.text === "string" && res.text.length > 0, "text should be non-empty");
+assert(Array.isArray(res.toolCalls) && res.toolCalls.length === 0, "toolCalls should be empty");
+assert(typeof res.usage.inputTokens === "number", "usage.inputTokens should be a number");
+assert(typeof res.usage.outputTokens === "number", "usage.outputTokens should be a number");
+console.log("✓ ChatResponse contract satisfied via subscription (no API key)\n");
+
+console.log("── Spike 2: tools guard must throw (honest about the limitation) ──");
+let threw = false;
+try {
+  await adapter.chat({
+    model: "haiku",
+    system: "x",
+    messages: [{ role: "user", content: "y" }],
+    tools: [
+      { name: "do_thing", description: "d", input_schema: { type: "object", properties: {} } },
+    ],
+  });
+} catch (err) {
+  threw = true;
+  console.log("✓ threw as designed:", err.message.split(":")[0]);
+}
+assert(threw, "adapter must reject custom tools rather than silently drop them");
+
+console.log("\nSPIKE PASSED — claude -p backs LLMClient for no-tools roles on the subscription.");

package/scripts/spike-deepseek.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+// SPIKE: verify DeepSeek works through the EXISTING openai-compat adapter,
+// including TOOL CALLING (the capability that makes it usable for ALL roles,
+// unlike the claude-code provider). No new adapter code — this is the whole point.
+//
+//   DEEPSEEK_API_KEY=sk-... node scripts/spike-deepseek.mjs
+//
+// Run `npm run build` first (imports compiled dist).
+
+import { createClient } from "../dist/providers/factory.js";
+
+const key = process.env.DEEPSEEK_API_KEY;
+if (!key) {
+  console.log("SKIP: DEEPSEEK_API_KEY not set — skipping DeepSeek smoke.");
+  process.exit(0);
+}
+
+function assert(c, m) { if (!c) { console.error("ASSERT FAILED:", m); process.exit(1); } }
+
+// Existing openai-compat adapter, pointed at DeepSeek's OpenAI-compatible endpoint.
+const client = createClient(
+  "openai-compat",
+  "https://api.deepseek.com",
+  { apiKey: key },
+  "deepseek-v4-pro",
+  "Spike",
+);
+
+console.log("── Spike 1: plain completion via DeepSeek (openai-compat) ──");
+const r1 = await client.chat({
+  model: "deepseek-v4-pro",
+  system: "You are terse. One sentence, no preamble.",
+  messages: [{ role: "user", content: "What is a code knowledge graph, in one sentence?" }],
+});
+console.log("text:", JSON.stringify(r1.text).slice(0, 200));
+console.log("stopReason:", r1.stopReason, "| usage:", JSON.stringify(r1.usage));
+assert(typeof r1.text === "string" && r1.text.length > 0, "text non-empty");
+
+console.log("\n── Spike 2: TOOL CALLING (the differentiator vs claude-code) ──");
+const r2 = await client.chat({
+  model: "deepseek-v4-pro",
+  system: "You are an agent. When asked to read a file, you MUST call the read_file tool. Do not answer directly.",
+  messages: [{ role: "user", content: "Read the file src/index.ts and tell me what it does." }],
+  tools: [
+    {
+      name: "read_file",
+      description: "Read a file from the project by path.",
+      input_schema: {
+        type: "object",
+        properties: { file_path: { type: "string", description: "Path to read" } },
+        required: ["file_path"],
+      },
+    },
+  ],
+});
+console.log("stopReason:", r2.stopReason);
+console.log("toolCalls:", JSON.stringify(r2.toolCalls, null, 2));
+console.log("usage:", JSON.stringify(r2.usage));
+assert(r2.toolCalls.length > 0, "DeepSeek should emit a tool_use call");
+assert(r2.toolCalls[0].name === "read_file", "should call read_file");
+assert(typeof r2.toolCalls[0].input?.file_path === "string", "tool input should parse with file_path");
+
+console.log("\nDEEPSEEK SPIKE PASSED — existing openai-compat adapter drives DeepSeek WITH tool calling, all roles, zero new code.");

package/scripts/sync-targets.json

@@ -0,0 +1,12 @@
+{
+  "//": "Projects that consume agent-bober's skills/agents. `npm run update-all` rebuilds the CLI once (shared via symlink) and re-inlines skills/agents into each target's .claude/. Add absolute project paths here. Auto-discovery (--discover) appends any initialized project it finds under the configured roots.",
+  "discoverRoots": [
+    "/Users/bober4ik/WebstormProjects",
+    "/Users/bober4ik/agent-bober-workspace"
+  ],
+  "targets": [
+    "/Users/bober4ik/WebstormProjects/solex-integration-demo",
+    "/Users/bober4ik/WebstormProjects/solex-integration-demo/apps/api",
+    "/Users/bober4ik/WebstormProjects/solex-integration-demo/solex-games-betbook (Copy)"
+  ]
+}