fathom-mcp 0.6.4 → 2.0.1

package/src/config.js

@@ -1,137 +0,0 @@
-/**
- * Config resolution for fathom-mcp.
- *
- * Precedence (highest wins):
- *   1. Environment variables (FATHOM_SERVER_URL, FATHOM_API_KEY, FATHOM_WORKSPACE, FATHOM_VAULT_DIR)
- *   2. .fathom.json (walked up from cwd to filesystem root)
- *   3. Built-in defaults
- */
-
-import fs from "fs";
-import path from "path";
-
-const CONFIG_FILENAME = ".fathom.json";
-
-const VALID_VAULT_MODES = new Set(["synced", "local", "none"]);
-
-const DEFAULTS = {
-  workspace: "",
-  vault: "vault",
-  vaultMode: "local", // hosted | synced | local | none
-  server: "http://127.0.0.1:4243",
-  apiKey: "",
-  description: "",
-  agents: [],
-  hooks: {
-    "context-inject": { enabled: true },
-    "precompact-snapshot": { enabled: true },
-  },
-};
-
-/**
- * Walk up from startDir looking for .fathom.json.
- * Returns the parsed config and the directory it was found in, or null.
- */
-export function findConfigFile(startDir = process.cwd()) {
-  let dir = path.resolve(startDir);
-  const root = path.parse(dir).root;
-
-  while (true) {
-    const candidate = path.join(dir, CONFIG_FILENAME);
-    try {
-      const content = fs.readFileSync(candidate, "utf-8");
-      const config = JSON.parse(content);
-      return { config, dir, path: candidate };
-    } catch {
-      // Not found or invalid — keep walking up
-    }
-
-    const parent = path.dirname(dir);
-    if (parent === dir || dir === root) break;
-    dir = parent;
-  }
-
-  return null;
-}
-
-/**
- * Apply fields from a source config object onto a result object.
- */
-function applyConfig(result, config) {
-  if (config.workspace) result.workspace = config.workspace;
-  if (config.vault) result.vault = config.vault;
-  if (config.vaultMode && VALID_VAULT_MODES.has(config.vaultMode)) {
-    result.vaultMode = config.vaultMode;
-  }
-  if (config.server) result.server = config.server;
-  if (config.apiKey) result.apiKey = config.apiKey;
-  if (config.agents && Array.isArray(config.agents)) {
-    result.agents = config.agents;
-  }
-  if (config.hooks) {
-    result.hooks = { ...result.hooks, ...config.hooks };
-  }
-}
-
-/**
- * Resolve final config by merging: defaults → .fathom.json → env vars.
- */
-export function resolveConfig(startDir = process.cwd()) {
-  const result = { ...DEFAULTS, hooks: { ...DEFAULTS.hooks } };
-  let projectDir = startDir;
-
-  // Layer 2: .fathom.json
-  const found = findConfigFile(startDir);
-  if (found) {
-    projectDir = found.dir;
-    applyConfig(result, found.config);
-  }
-
-  // Layer 1: Environment variables (highest priority)
-  if (process.env.FATHOM_SERVER_URL) result.server = process.env.FATHOM_SERVER_URL;
-  if (process.env.FATHOM_API_KEY) result.apiKey = process.env.FATHOM_API_KEY;
-  if (process.env.FATHOM_WORKSPACE) result.workspace = process.env.FATHOM_WORKSPACE;
-  if (process.env.FATHOM_VAULT_DIR) result.vault = process.env.FATHOM_VAULT_DIR;
-  if (process.env.FATHOM_VAULT_MODE && VALID_VAULT_MODES.has(process.env.FATHOM_VAULT_MODE)) {
-    result.vaultMode = process.env.FATHOM_VAULT_MODE;
-  }
-
-  // Derive workspace name from directory if still empty
-  if (!result.workspace) {
-    result.workspace = path.basename(projectDir);
-  }
-
-  // Preserve raw vault name before resolving to absolute (for registration)
-  result._rawVault = result.vault;
-
-  // Resolve vault to absolute path
-  if (!path.isAbsolute(result.vault)) {
-    result.vault = path.join(projectDir, result.vault);
-  }
-
-  // Normalize server URL — strip trailing slash
-  result.server = result.server.replace(/\/+$/, "");
-
-  result._projectDir = projectDir;
-  result._configPath = found?.path || null;
-
-  return result;
-}
-
-/**
- * Write a .fathom.json config file.
- */
-export function writeConfig(dir, config) {
-  const filePath = path.join(dir, CONFIG_FILENAME);
-  const data = {
-    workspace: config.workspace,
-    vaultMode: config.vaultMode || "local",
-    vault: config.vault || "vault",
-    server: config.server || DEFAULTS.server,
-    apiKey: config.apiKey || "",
-    agents: config.agents || [],
-    hooks: config.hooks || DEFAULTS.hooks,
-  };
-  fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + "\n");
-  return filePath;
-}

package/src/frontmatter.js

@@ -1,77 +0,0 @@
-/**
- * Shared frontmatter parsing and validation for vault files.
- *
- * Used by the vault-frontmatter-lint hook script and any other
- * code that needs to validate vault file frontmatter.
- */
-
-// --- Constants ---------------------------------------------------------------
-
-export const VALID_STATUSES = new Set(["draft", "published", "archived"]);
-
-export const VAULT_SCHEMA = {
-  title:   { required: true,  type: "string" },
-  date:    { required: true,  type: "string" },
-  tags:    { required: false, type: "array"  },
-  status:  { required: false, type: "string" },
-  project: { required: false, type: "string" },
-  aliases: { required: false, type: "array"  },
-};
-
-// --- Frontmatter -------------------------------------------------------------
-
-export function parseFrontmatter(content) {
-  if (!content.startsWith("---")) return { fm: {}, body: content };
-  const lines = content.split("\n");
-  let endIdx = null;
-  for (let i = 1; i < lines.length; i++) {
-    if (lines[i].trim() === "---") { endIdx = i; break; }
-  }
-  if (endIdx === null) return { fm: {}, body: content };
-  try {
-    const fmLines = lines.slice(1, endIdx);
-    const fm = {};
-    let currentKey = null;
-    for (const line of fmLines) {
-      const listMatch = line.match(/^[ ]{2}- (.+)$/);
-      const kvMatch = line.match(/^(\w+):\s*(.*)$/);
-      if (listMatch && currentKey) {
-        fm[currentKey].push(listMatch[1].trim());
-      } else if (kvMatch) {
-        currentKey = kvMatch[1];
-        const val = kvMatch[2].trim();
-        if (val === "") {
-          fm[currentKey] = [];
-        } else {
-          fm[currentKey] = val;
-        }
-      }
-    }
-    const body = lines.slice(endIdx + 1).join("\n");
-    return { fm, body };
-  } catch {
-    return { fm: {}, body: content };
-  }
-}
-
-export function validateFrontmatter(fm) {
-  const errors = [];
-  for (const [field, spec] of Object.entries(VAULT_SCHEMA)) {
-    const val = fm[field];
-    if (spec.required && val == null) {
-      errors.push(`Missing required field: '${field}'`);
-      continue;
-    }
-    if (val != null) {
-      const actualType = Array.isArray(val) ? "array" : typeof val;
-      if (actualType !== spec.type) {
-        errors.push(`Field '${field}' must be ${spec.type}, got ${actualType}`);
-      }
-    }
-  }
-  const status = fm["status"];
-  if (status != null && !VALID_STATUSES.has(status)) {
-    errors.push(`Field 'status' must be one of [${[...VALID_STATUSES].join(", ")}], got '${status}'`);
-  }
-  return errors;
-}