@gopherine/obsidian-mcp 0.1.1

package/dist/commands/init.js

@@ -0,0 +1,256 @@
+import { readFile, readdir } from "fs/promises";
+import { join, basename } from "path";
+import { execFile } from "child_process";
+import { promisify } from "util";
+import { safeExternalPath } from "../lib/safe-external-path.js";
+const execFileAsync = promisify(execFile);
+const MANIFEST_FILES = [
+    "README.md", "AGENTS.md", "CLAUDE.md",
+    "go.mod", "Cargo.toml", "package.json", "pyproject.toml",
+    "requirements.txt", "Makefile", "Dockerfile", "docker-compose.yml",
+];
+/**
+ * Scan a git repo and generate a draft context.md.
+ * Does NOT write to vault — returns the draft as a string.
+ */
+export async function initCommand(projectPath, slug) {
+    const resolved = await safeExternalPath(projectPath);
+    const projectSlug = slug ?? basename(resolved).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+    // Probe manifest files
+    const probes = [];
+    for (const name of MANIFEST_FILES) {
+        try {
+            const content = await readFile(join(resolved, name), "utf-8");
+            probes.push({ name, exists: true, content });
+        }
+        catch {
+            probes.push({ name, exists: false });
+        }
+    }
+    // Detect tech stack
+    const techStack = detectTechStack(probes);
+    // Extract description from README
+    const readme = probes.find((p) => p.name === "README.md" && p.exists);
+    const description = readme ? extractDescription(readme.content) : "No README found.";
+    // Check for AI instructions
+    const hasAgentsMd = probes.some((p) => p.name === "AGENTS.md" && p.exists);
+    const hasClaudeMd = probes.some((p) => p.name === "CLAUDE.md" && p.exists);
+    // Git log (5s timeout)
+    let recentActivity = "No git history available.";
+    try {
+        const { stdout } = await execFileAsync("git", ["log", "--oneline", "-20"], {
+            cwd: resolved,
+            timeout: 5000,
+        });
+        recentActivity = stdout.trim() || "No commits yet.";
+    }
+    catch {
+        // git log failed, use default
+    }
+    // Git remote
+    let repoUrl = "";
+    try {
+        const { stdout } = await execFileAsync("git", ["remote", "-v"], {
+            cwd: resolved,
+            timeout: 3000,
+        });
+        const match = stdout.match(/origin\s+(\S+)\s+\(fetch\)/);
+        if (match)
+            repoUrl = match[1];
+    }
+    catch {
+        // no remote
+    }
+    // Detect project structure
+    const structure = await detectStructure(resolved);
+    // Detect key files
+    const keyFiles = probes
+        .filter((p) => p.exists)
+        .map((p) => p.name);
+    // AI instructions note
+    const aiInstructions = [];
+    if (hasAgentsMd)
+        aiInstructions.push("AGENTS.md present");
+    if (hasClaudeMd)
+        aiInstructions.push("CLAUDE.md present");
+    // Build draft
+    const today = new Date().toISOString().slice(0, 10);
+    const draft = `---
+type: context
+project: ${projectSlug}
+status: active
+created: ${today}
+updated: ${today}
+tags: []
+---
+
+# ${projectSlug}
+
+## What It Is
+
+${description}
+
+## Current State
+
+${structure}${repoUrl ? `\nRepository: ${repoUrl}` : ""}${aiInstructions.length > 0 ? `\nAI Instructions: ${aiInstructions.join(", ")}` : ""}
+
+## Tech Stack
+
+${techStack.map((t) => `- ${t}`).join("\n")}
+
+## Key Files
+
+${keyFiles.map((f) => `- \`${f}\``).join("\n")}
+
+## Recent Activity
+
+\`\`\`
+${recentActivity}
+\`\`\`
+`;
+    return { draft_context_md: draft, detected_tech_stack: techStack, slug: projectSlug };
+}
+function detectTechStack(probes) {
+    const stack = [];
+    const goMod = probes.find((p) => p.name === "go.mod" && p.exists);
+    if (goMod) {
+        stack.push("Go");
+        const content = goMod.content;
+        if (content.includes("gin-gonic"))
+            stack.push("Gin");
+        if (content.includes("fiber"))
+            stack.push("Fiber");
+        if (content.includes("echo"))
+            stack.push("Echo");
+        if (content.includes("sqlc"))
+            stack.push("sqlc");
+        if (content.includes("pgx") || content.includes("lib/pq"))
+            stack.push("PostgreSQL");
+    }
+    const cargo = probes.find((p) => p.name === "Cargo.toml" && p.exists);
+    if (cargo) {
+        stack.push("Rust");
+        const content = cargo.content;
+        if (content.includes("actix"))
+            stack.push("Actix");
+        if (content.includes("axum"))
+            stack.push("Axum");
+        if (content.includes("tokio"))
+            stack.push("Tokio");
+        if (content.includes("serde"))
+            stack.push("Serde");
+    }
+    const packageJson = probes.find((p) => p.name === "package.json" && p.exists);
+    if (packageJson) {
+        try {
+            const pkg = JSON.parse(packageJson.content);
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (allDeps["next"])
+                stack.push("Next.js");
+            else if (allDeps["react"])
+                stack.push("React");
+            if (allDeps["vue"])
+                stack.push("Vue");
+            if (allDeps["svelte"] || allDeps["@sveltejs/kit"])
+                stack.push("Svelte");
+            if (allDeps["express"])
+                stack.push("Express");
+            if (allDeps["typescript"])
+                stack.push("TypeScript");
+            if (allDeps["tailwindcss"])
+                stack.push("Tailwind CSS");
+            if (allDeps["prisma"] || allDeps["@prisma/client"])
+                stack.push("Prisma");
+            if (allDeps["drizzle-orm"])
+                stack.push("Drizzle");
+            if (!stack.some((s) => ["Next.js", "React", "Vue", "Svelte", "Express"].includes(s))) {
+                stack.push("Node.js");
+            }
+        }
+        catch {
+            stack.push("Node.js");
+        }
+    }
+    const pyproject = probes.find((p) => p.name === "pyproject.toml" && p.exists);
+    const requirements = probes.find((p) => p.name === "requirements.txt" && p.exists);
+    if (pyproject || requirements) {
+        stack.push("Python");
+        const content = (pyproject?.content ?? "") + (requirements?.content ?? "");
+        if (content.includes("fastapi"))
+            stack.push("FastAPI");
+        if (content.includes("django"))
+            stack.push("Django");
+        if (content.includes("flask"))
+            stack.push("Flask");
+        if (content.includes("groq"))
+            stack.push("Groq");
+        if (content.includes("openai"))
+            stack.push("OpenAI");
+        if (content.includes("graphql") || content.includes("strawberry") || content.includes("ariadne"))
+            stack.push("GraphQL");
+    }
+    const dockerfile = probes.find((p) => p.name === "Dockerfile" && p.exists);
+    if (dockerfile)
+        stack.push("Docker");
+    const dockerCompose = probes.find((p) => p.name === "docker-compose.yml" && p.exists);
+    if (dockerCompose) {
+        stack.push("Docker Compose");
+        const content = dockerCompose.content;
+        if (content.includes("postgres"))
+            stack.push("PostgreSQL");
+        if (content.includes("redis"))
+            stack.push("Redis");
+        if (content.includes("mongo"))
+            stack.push("MongoDB");
+    }
+    const makefile = probes.find((p) => p.name === "Makefile" && p.exists);
+    if (makefile)
+        stack.push("Make");
+    return [...new Set(stack)];
+}
+function extractDescription(readme) {
+    const lines = readme.split("\n");
+    let foundHeading = false;
+    const paragraphLines = [];
+    for (const line of lines) {
+        if (line.startsWith("# ")) {
+            foundHeading = true;
+            continue;
+        }
+        if (foundHeading) {
+            if (line.trim() === "" && paragraphLines.length === 0)
+                continue;
+            if (line.startsWith("## ") || line.startsWith("# "))
+                break;
+            if (line.trim() === "" && paragraphLines.length > 0)
+                break;
+            paragraphLines.push(line);
+        }
+    }
+    const desc = paragraphLines.join(" ").trim();
+    if (desc.length > 500)
+        return desc.slice(0, 500) + "...";
+    return desc || "No description available.";
+}
+async function detectStructure(projectPath) {
+    try {
+        const entries = await readdir(projectPath, { withFileTypes: true });
+        const dirs = entries.filter((e) => e.isDirectory() && !e.name.startsWith(".")).map((e) => e.name);
+        const hasFrontend = dirs.some((d) => ["frontend", "web", "client", "app"].includes(d));
+        const hasBackend = dirs.some((d) => ["backend", "server", "api", "cmd", "internal"].includes(d));
+        const hasPackages = dirs.some((d) => ["packages", "libs", "crates", "modules"].includes(d));
+        if (hasPackages)
+            return "Monorepo structure";
+        if (hasFrontend && hasBackend)
+            return "Full-stack (frontend + backend)";
+        if (dirs.includes("cmd") && dirs.includes("internal"))
+            return "Go project structure (cmd + internal)";
+        if (dirs.length > 10)
+            return `Large project (${dirs.length} top-level directories)`;
+        return `Single project (top-level dirs: ${dirs.slice(0, 8).join(", ")})`;
+    }
+    catch {
+        return "Structure unknown";
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/learn.d.ts

@@ -0,0 +1,25 @@
+import type { CommandContext } from "../core/types.js";
+export type Confidence = "high" | "medium" | "low";
+export interface LearningItem {
+    id: string;
+    title: string;
+    confidence: Confidence;
+    tags: string[];
+    created: string;
+    path: string;
+}
+export declare function learnCommand(args: {
+    action: "add" | "list";
+    title?: string;
+    discovery?: string;
+    project?: string;
+    tags?: string[];
+    confidence?: Confidence;
+    source?: string;
+    sessionId?: string;
+    tag?: string;
+}, ctx: CommandContext): Promise<{
+    learning_id?: string;
+    path?: string;
+    learnings?: LearningItem[];
+}>;

package/dist/commands/learn.js

@@ -0,0 +1,92 @@
+import { parseFrontmatter, serializeFrontmatter, createFrontmatter } from "../lib/frontmatter.js";
+import { resolveProject } from "../config.js";
+import { getNextNumber, slugify } from "../lib/auto-number.js";
+const VALID_CONFIDENCE = ["high", "medium", "low"];
+export async function learnCommand(args, ctx) {
+    const projectSlug = await resolveProject(ctx.vaultPath, args.project);
+    const vaultFs = ctx.vaultFs;
+    const learningsDir = `projects/${projectSlug}/learnings`;
+    switch (args.action) {
+        case "add": {
+            if (!args.title)
+                throw new Error("Title required for add");
+            if (!args.discovery)
+                throw new Error("Discovery required for add");
+            const confidence = args.confidence ?? "medium";
+            if (!VALID_CONFIDENCE.includes(confidence)) {
+                throw new Error(`Invalid confidence "${confidence}". Must be one of: ${VALID_CONFIDENCE.join(", ")}`);
+            }
+            const nextNum = await getNextNumber(vaultFs, learningsDir);
+            const padded = String(nextNum).padStart(3, "0");
+            const titleSlug = slugify(args.title);
+            const filename = `${padded}-${titleSlug}.md`;
+            const filePath = `${learningsDir}/${filename}`;
+            const learningId = padded;
+            const fm = createFrontmatter({
+                type: "learning",
+                project: projectSlug,
+                status: "active",
+                confidence,
+                source: args.source ?? "",
+                session_id: args.sessionId ?? "",
+                tags: args.tags ?? [],
+            });
+            const body = `\n# ${args.title}\n\n${args.discovery}\n`;
+            await vaultFs.write(filePath, serializeFrontmatter(fm, body));
+            return { learning_id: learningId, path: filePath };
+        }
+        case "list": {
+            const learnings = await listLearnings(vaultFs, learningsDir);
+            let filtered = learnings;
+            if (args.tag) {
+                filtered = filtered.filter((l) => l.tags.includes(args.tag));
+            }
+            return { learnings: filtered };
+        }
+        default:
+            throw new Error(`Unknown action: ${args.action}`);
+    }
+}
+async function listLearnings(vaultFs, learningsDir) {
+    const learnings = [];
+    let files;
+    try {
+        files = await vaultFs.list(learningsDir, 1);
+    }
+    catch {
+        return [];
+    }
+    for (const file of files) {
+        if (!file.endsWith(".md"))
+            continue;
+        const filePath = file;
+        try {
+            const content = await vaultFs.read(filePath);
+            const { data, content: body } = parseFrontmatter(content);
+            if (data.type !== "learning")
+                continue;
+            const basename = file.split("/").pop() ?? file;
+            const idMatch = basename.match(/^(\d+)-/);
+            if (!idMatch)
+                continue;
+            const titleMatch = body.match(/^# (.+)$/m);
+            const title = titleMatch ? titleMatch[1].trim() : file;
+            learnings.push({
+                id: idMatch[1],
+                title,
+                confidence: data.confidence ?? "medium",
+                tags: Array.isArray(data.tags) ? data.tags : [],
+                created: data.created ?? "",
+                path: filePath,
+            });
+        }
+        catch (e) {
+            if (e instanceof Error && "code" in e && e.code !== "ENOENT") {
+                console.error("[learn] Skipping unreadable learning file:", e instanceof Error ? e.message : e);
+            }
+        }
+    }
+    learnings.sort((a, b) => a.id.localeCompare(b.id));
+    return learnings;
+}
+//# sourceMappingURL=learn.js.map

package/dist/commands/learn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learn.js","sourceRoot":"","sources":["../../src/commands/learn.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClG,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAa/D,MAAM,gBAAgB,GAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAEjE,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAUC,EACD,GAAmB;IAMnB,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,MAAM,YAAY,GAAG,YAAY,WAAW,YAAY,CAAC;IAEzD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAEnE,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC;YAC/C,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,KAAK,CAAC,uBAAuB,UAAU,sBAAsB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACxG,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAChD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,SAAS,KAAK,CAAC;YAC7C,MAAM,QAAQ,GAAG,GAAG,YAAY,IAAI,QAAQ,EAAE,CAAC;YAC/C,MAAM,UAAU,GAAG,MAAM,CAAC;YAE1B,MAAM,EAAE,GAAG,iBAAiB,CAAC;gBAC3B,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,WAAW;gBACpB,MAAM,EAAE,QAAQ;gBAChB,UAAU;gBACV,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;gBACzB,UAAU,EAAE,IAAI,CAAC,SAAS,IAAI,EAAE;gBAChC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;aACtB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC;YACxD,MAAM,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;YAE9D,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACrD,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAC7D,IAAI,QAAQ,GAAG,SAAS,CAAC;YAEzB,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAI,CAAC,CAAC,CAAC;YAChE,CAAC;YAED,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;QACjC,CAAC;QAED;YACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,OAA6C,EAAE,YAAoB;IAC9F,MAAM,SAAS,GAAmB,EAAE,CAAC;IAErC,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC;QAEtB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAE1D,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,SAAS;YAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;YAC/C,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAEvD,SAAS,CAAC,IAAI,CAAC;gBACb,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;gBACd,KAAK;gBACL,UAAU,EAAG,IAAI,CAAC,UAAyB,IAAI,QAAQ;gBACvD,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAgB,CAAC,CAAC,CAAC,EAAE;gBAC3D,OAAO,EAAG,IAAI,CAAC,OAAkB,IAAI,EAAE;gBACvC,IAAI,EAAE,QAAQ;aACf,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,KAAK,IAAI,MAAM,IAAI,CAAC,IAAK,CAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACtE,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/commands/learn.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/learn.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+import { mkdir, rm } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+import { learnCommand } from "./learn.js";
+import { VaultFS } from "../lib/vault-fs.js";
+function createCommandContext(vaultFs, overrides) {
+    return {
+        vaultFs,
+        vaultPath: vaultFs.root,
+        sessionRegistry: {},
+        config: {},
+        log: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
+        ...overrides,
+    };
+}
+describe("learnCommand", () => {
+    let vaultRoot;
+    let vaultFs;
+    let ctx;
+    beforeEach(async () => {
+        vaultRoot = join(homedir(), `.vault-test-${Date.now()}-${Math.random().toString(36).slice(2)}`);
+        await mkdir(vaultRoot, { recursive: true });
+        vaultFs = new VaultFS(vaultRoot);
+        ctx = createCommandContext(vaultFs);
+    });
+    afterEach(async () => {
+        await rm(vaultRoot, { recursive: true, force: true });
+    });
+    describe("add learning", () => {
+        it("creates new learning with auto-numbering", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            const result = await learnCommand({
+                action: "add",
+                title: "API Rate Limiting",
+                discovery: "Rate limits reset at midnight UTC",
+                project: "test-project",
+            }, ctx);
+            expect(result.learning_id).toBe("001");
+            expect(result.path).toBe("projects/test-project/learnings/001-api-rate-limiting.md");
+            const content = await vaultFs.read(result.path);
+            expect(content).toContain("type: learning");
+            expect(content).toContain("# API Rate Limiting");
+            expect(content).toContain("Rate limits reset at midnight UTC");
+        });
+        it("increments number for subsequent learnings", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            const result1 = await learnCommand({
+                action: "add",
+                title: "First Learning",
+                discovery: "Discovery 1",
+                project: "test-project",
+            }, ctx);
+            const result2 = await learnCommand({
+                action: "add",
+                title: "Second Learning",
+                discovery: "Discovery 2",
+                project: "test-project",
+            }, ctx);
+            expect(result1.learning_id).toBe("001");
+            expect(result2.learning_id).toBe("002");
+        });
+        it("sets default confidence to medium", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await learnCommand({
+                action: "add",
+                title: "Test",
+                discovery: "Discovery",
+                project: "test-project",
+            }, ctx);
+            const content = await vaultFs.read("projects/test-project/learnings/001-test.md");
+            expect(content).toContain("confidence: medium");
+        });
+        it("accepts high confidence", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await learnCommand({
+                action: "add",
+                title: "High Confidence",
+                discovery: "Verified",
+                confidence: "high",
+                project: "test-project",
+            }, ctx);
+            const content = await vaultFs.read("projects/test-project/learnings/001-high-confidence.md");
+            expect(content).toContain("confidence: high");
+        });
+        it("accepts low confidence", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await learnCommand({
+                action: "add",
+                title: "Low Confidence",
+                discovery: "Unverified",
+                confidence: "low",
+                project: "test-project",
+            }, ctx);
+            const content = await vaultFs.read("projects/test-project/learnings/001-low-confidence.md");
+            expect(content).toContain("confidence: low");
+        });
+        it("rejects invalid confidence", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await expect(learnCommand({
+                action: "add",
+                title: "Test",
+                discovery: "Test",
+                confidence: "invalid",
+                project: "test-project",
+            }, ctx)).rejects.toThrow('Invalid confidence "invalid"');
+        });
+        it("requires title for add", async () => {
+            await expect(learnCommand({
+                action: "add",
+                discovery: "Test",
+                project: "test-project",
+            }, ctx)).rejects.toThrow("Title required for add");
+        });
+        it("requires discovery for add", async () => {
+            await expect(learnCommand({
+                action: "add",
+                title: "Test",
+                project: "test-project",
+            }, ctx)).rejects.toThrow("Discovery required for add");
+        });
+        it("stores tags in frontmatter", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await learnCommand({
+                action: "add",
+                title: "Tagged Learning",
+                discovery: "Content",
+                tags: ["api", "performance"],
+                project: "test-project",
+            }, ctx);
+            const content = await vaultFs.read("projects/test-project/learnings/001-tagged-learning.md");
+            expect(content).toContain("tags:");
+            expect(content).toContain("- api");
+            expect(content).toContain("- performance");
+        });
+        it("stores source and session_id", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await learnCommand({
+                action: "add",
+                title: "Sourced Learning",
+                discovery: "Content",
+                source: "PR #123",
+                sessionId: "session-abc123",
+                project: "test-project",
+            }, ctx);
+            const content = await vaultFs.read("projects/test-project/learnings/001-sourced-learning.md");
+            expect(content).toMatch(/source:\s*'?PR #123'?/);
+            expect(content).toContain("session_id: session-abc123");
+        });
+    });
+    describe("list learnings", () => {
+        it("returns empty array when no learnings", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            const result = await learnCommand({
+                action: "list",
+                project: "test-project",
+            }, ctx);
+            expect(result.learnings).toEqual([]);
+        });
+        it("lists all learnings", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await learnCommand({
+                action: "add",
+                title: "Learning 1",
+                discovery: "Discovery 1",
+                tags: ["api"],
+                project: "test-project",
+            }, ctx);
+            await learnCommand({
+                action: "add",
+                title: "Learning 2",
+                discovery: "Discovery 2",
+                tags: ["database"],
+                confidence: "high",
+                project: "test-project",
+            }, ctx);
+            const result = await learnCommand({
+                action: "list",
+                project: "test-project",
+            }, ctx);
+            expect(result.learnings).toHaveLength(2);
+            expect(result.learnings[0].id).toBe("001");
+            expect(result.learnings[0].title).toBe("Learning 1");
+            expect(result.learnings[0].tags).toEqual(["api"]);
+            expect(result.learnings[1].id).toBe("002");
+            expect(result.learnings[1].confidence).toBe("high");
+        });
+        it("filters by tag", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            await mkdir(join(vaultRoot, "projects/test-project/learnings"), { recursive: true });
+            await learnCommand({
+                action: "add",
+                title: "API Learning",
+                discovery: "Discovery",
+                tags: ["api"],
+                project: "test-project",
+            }, ctx);
+            await learnCommand({
+                action: "add",
+                title: "DB Learning",
+                discovery: "Discovery",
+                tags: ["database"],
+                project: "test-project",
+            }, ctx);
+            const result = await learnCommand({
+                action: "list",
+                tag: "api",
+                project: "test-project",
+            }, ctx);
+            expect(result.learnings).toHaveLength(1);
+            expect(result.learnings[0].title).toBe("API Learning");
+        });
+        it("returns empty when learnings directory does not exist", async () => {
+            await vaultFs.write("project-map.json", JSON.stringify({ projects: { "test-project": "/tmp/test" } }));
+            const result = await learnCommand({
+                action: "list",
+                project: "test-project",
+            }, ctx);
+            expect(result.learnings).toEqual([]);
+        });
+    });
+    describe("unknown action", () => {
+        it("throws error for unknown action", async () => {
+            await expect(learnCommand({
+                action: "unknown",
+                project: "test-project",
+            }, ctx)).rejects.toThrow("Unknown action: unknown");
+        });
+    });
+});
+//# sourceMappingURL=learn.test.js.map