datanotes 1.1.0 → 1.2.0

package/README.md

@@ -4,30 +4,14 @@ The engine of your second brain: Markdown notes as database tables, for you and
 
 A row is any note whose `table` property names a table; tables are defined in
 `Database/database.yaml`. Every write is checked against its table, journaled and undoable. Agents
-use it through MCP (the separate `datanotes-mcp` server); programs use its HTTP API or the
-`datanotes/client` library; it also runs inside Obsidian as a plugin.
+programs use its HTTP API or the `datanotes/client` library, and agents use the separate MCP
+server `datanotes-mcp`.
 
 **Documentation: [datanotes.dev](https://datanotes.dev)**
 
 ## Quick start
 
-Requires Node.js 20 or newer. Connect an MCP client to a vault (here Claude Code):
-
-```bash
-claude mcp add datanotes -- npx -y datanotes-mcp --vault /path/to/vault
-```
-
-Other clients use the same command:
-
-```json
-{
-  "mcpServers": {
-    "datanotes": { "command": "npx", "args": ["-y", "datanotes-mcp", "--vault", "/path/to/vault"] }
-  }
-}
-```
-
-To keep the engine running for several clients and apps:
+Requires Node.js 20 or newer. Start the engine on a vault:
 
 ```bash
 npx -y datanotes serve --vault /path/to/vault
@@ -43,14 +27,17 @@ const db = new DatanotesClient({ url: "http://127.0.0.1:27150", token });
 const { value } = await db.call("select_rows", { table: "book", where: { pages: { gt: 300 } } });
 ```
 
+AI agents connect through [`datanotes-mcp`](https://www.npmjs.com/package/datanotes-mcp), the MCP
+server of Datanotes, a separate package built on this API.
+
 ## Learn more
 
 - [How it works](https://datanotes.dev/concepts/how-it-works/)
-- [Connect agents](https://datanotes.dev/start/connect-agents/)
-- [Operations and MCP tools](https://datanotes.dev/reference/tools/)
+- [Operations](https://datanotes.dev/reference/tools/)
+- [Connect agents (datanotes-mcp)](https://datanotes.dev/start/connect-agents/)
 - [JavaScript client](https://datanotes.dev/guides/client/)
 - [Apps](https://datanotes.dev/guides/apps/)
-- [Obsidian plugin](https://datanotes.dev/guides/obsidian/)
+- [Obsidian client](https://datanotes.dev/guides/obsidian/)
 
 ## Security
 

package/dist/api/local.cjs

@@ -40,8 +40,7 @@ var import_node_os = __toESM(require("node:os"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
 var LOCK_STALE_MS = 3e4;
 function vaultSettingsPath(vault) {
-  const plugin = import_node_path.default.join(vault, ".obsidian", "plugins", "datanotes", "data.json");
-  return import_node_fs.default.existsSync(plugin) ? plugin : import_node_path.default.join(vault, ".datanotes", "service.json");
+  return import_node_path.default.join(vault, ".datanotes", "service.json");
 }
 function readJson(file) {
   try {

package/dist/api/local.d.ts

@@ -4,7 +4,7 @@
  */
 /** The lock an engine writes in its store folder (`<vault>/.datanotes/engine.lock`). */
 export interface EngineLock {
-    kind: "service" | "plugin";
+    kind: "service";
     pid: number;
     host: string;
     port: number;
@@ -18,7 +18,7 @@ export interface LocalEngine {
     token: string;
     lock: EngineLock;
 }
-/** The settings file of a vault: the Obsidian plugin's when present, else the service's. */
+/** The settings file of a vault's engine. */
 export declare function vaultSettingsPath(vault: string): string;
 /**
  * The engine holding `vault`, or null when none runs. Throws when the lock is fresh but held on

package/dist/api/local.js

@@ -4,8 +4,7 @@ import os from "node:os";
 import path from "node:path";
 var LOCK_STALE_MS = 3e4;
 function vaultSettingsPath(vault) {
-  const plugin = path.join(vault, ".obsidian", "plugins", "datanotes", "data.json");
-  return fs.existsSync(plugin) ? plugin : path.join(vault, ".datanotes", "service.json");
+  return path.join(vault, ".datanotes", "service.json");
 }
 function readJson(file) {
   try {

package/dist/datanotes.cjs

@@ -7424,19 +7424,16 @@ var DEFAULT_SETTINGS = {
   tableProperty: "table",
   telemetryEnabled: false,
   telemetryEndpoint: "http://127.0.0.1:4318",
-  telemetryServiceName: "obsidian-datanotes",
-  restApiEnabled: false,
+  telemetryServiceName: "datanotes",
   autoRecompute: true,
   viewNotes: true,
   semanticEnabled: false,
   semanticProvider: "ollama",
   semanticBaseUrl: "",
   semanticModel: "",
-  semanticApiKeySecret: "",
   semanticScope: "vault",
   semanticExclude: [],
   semanticBatchSize: 32,
-  httpServerEnabled: false,
   httpServerPort: 27150,
   httpServerToken: ""
 };
@@ -7453,18 +7450,15 @@ var KEYS = [
   "telemetryEnabled",
   "telemetryEndpoint",
   "telemetryServiceName",
-  "restApiEnabled",
   "autoRecompute",
   "viewNotes",
   "semanticEnabled",
   "semanticProvider",
   "semanticBaseUrl",
   "semanticModel",
-  "semanticApiKeySecret",
   "semanticScope",
   "semanticExclude",
   "semanticBatchSize",
-  "httpServerEnabled",
   "httpServerPort",
   "httpServerToken"
 ];
@@ -7548,9 +7542,8 @@ function mergeWithDefaults(loaded) {
         if (typeof raw === "string" && (raw.trim() === "" || /^https?:\/\/\S+$/.test(raw.trim()))) out.semanticBaseUrl = raw.trim().replace(/\/+$/, "");
         break;
       }
-      case "semanticModel":
-      case "semanticApiKeySecret": {
-        if (typeof raw === "string") out[key] = raw.trim();
+      case "semanticModel": {
+        if (typeof raw === "string") out.semanticModel = raw.trim();
         break;
       }
       case "semanticScope": {
@@ -7574,9 +7567,7 @@ function mergeWithDefaults(loaded) {
         break;
       }
       case "telemetryEnabled":
-      case "httpServerEnabled":
       case "fileLogEnabled":
-      case "restApiEnabled":
       case "semanticEnabled":
       case "autoRecompute":
       case "viewNotes": {
@@ -7802,7 +7793,6 @@ var TeeTelemetry = class {
 
 // src/server/engine-lock.ts
 var LOCK_PATH_SUFFIX = "engine.lock";
-var LOCK_STALE_MS = 3e4;
 var LOCK_HEARTBEAT_MS = 1e4;
 function lockPath(storeFolder) {
   return `${storeFolder.replace(/\/+$/, "")}/${LOCK_PATH_SUFFIX}`;
@@ -7815,9 +7805,6 @@ async function readLock(adapter2, storeFolder) {
     return null;
   }
 }
-function isFresh(lock, now = Date.now()) {
-  return !!lock && now - Date.parse(lock.heartbeat) < LOCK_STALE_MS;
-}
 var LockHolder = class {
   constructor(adapter2, storeFolder, info) {
     this.adapter = adapter2;
@@ -7833,10 +7820,6 @@ var LockHolder = class {
   async write() {
     this.info.heartbeat = (/* @__PURE__ */ new Date()).toISOString();
     try {
-      if (this.info.kind === "plugin") {
-        const current2 = await readLock(this.adapter, this.storeFolder);
-        if (current2 && current2.kind === "service" && isFresh(current2)) return;
-      }
       await this.adapter.mkdir(this.storeFolder);
       await this.adapter.write(lockPath(this.storeFolder), JSON.stringify(this.info));
     } catch {
@@ -15650,13 +15633,13 @@ function createHandlers(app, getSettings, saveSettings = async () => {
     },
     "/tables/describe/": async (body) => ({ status: 200, json: await describeTable(app, s(), str(body, "table")) }),
     "/ddl/": ddl,
-    // The plugin API itself, method by method (camelCase inputs as in public-api.ts): what the
-    // Obsidian plugin uses in client mode, when the headless service owns the vault.
+    // The engine's API itself, method by method (camelCase inputs as in public-api.ts), for the
+    // owner: `remote-api.ts` is its client.
     "/api/": async (body) => {
       const method = str(body, "method");
       const args = list(body, "args") ?? [];
       const fn = pub[method];
-      if (typeof fn !== "function" || API_EXCLUDED.has(method)) throw new BadRequest(`"method" must be a method of the plugin API`);
+      if (typeof fn !== "function" || API_EXCLUDED.has(method)) throw new BadRequest(`"method" must be a method of the engine API`);
       const result = await fn.apply(pub, args);
       return { status: 200, json: { result: result === void 0 ? null : result } };
     },
@@ -16214,7 +16197,7 @@ async function simpleSearch(app, query, contextLength = 100) {
   }
   return out.sort((a, b) => b.score - a.score || a.filename.localeCompare(b.filename)).slice(0, 200);
 }
-var PluginHttpServer = class {
+var HttpApiServer = class {
   constructor(opts) {
     this.opts = opts;
     this.server = null;
@@ -20775,7 +20758,7 @@ var EngineRuntime = class {
       transport: async (url, body) => this.o.postLogs(url, body),
       resource: { "service.version": this.o.version, "host.name": this.o.hostName }
     });
-    const source = this.o.hostName === "obsidian" ? void 0 : this.o.hostName;
+    const source = this.o.hostName;
     const fileLog = new FileLogger({ enabled: () => s().fileLogEnabled, write: (day, lines) => appendLog(this.o.app, s(), day, lines, source) });
     const tee = new TeeTelemetry([logger, fileLog]);
     setTelemetry(tee);
@@ -20813,7 +20796,6 @@ var EngineRuntime = class {
     this.httpServer = null;
     this.httpServerError = null;
     const s = this.o.getSettings();
-    if (!s.httpServerEnabled) return;
     if (!this.o.canServeHttp) {
       this.httpServerError = "the HTTP server runs on desktop only";
       return;
@@ -20824,7 +20806,7 @@ var EngineRuntime = class {
     }
     const handlers = this.handlers();
     const guarded = this.apps.guard(dispatch);
-    const server = new PluginHttpServer({
+    const server = new HttpApiServer({
       app: this.o.app,
       handlers,
       token: s.httpServerToken,
@@ -22080,7 +22062,7 @@ var NodeWatcher = class {
 };
 
 // src/node/service.ts
-var VERSION = true ? "1.1.0" : "dev";
+var VERSION = true ? "1.2.0" : "dev";
 function parseArgs(argv, env = process.env) {
   const get = (name) => {
     const i = argv.indexOf(`--${name}`);
@@ -22103,8 +22085,6 @@ function parseArgs(argv, env = process.env) {
 }
 function settingsPath(o) {
   if (o.settingsFile) return import_node_path5.default.resolve(o.settingsFile);
-  const plugin = import_node_path5.default.join(o.vault, ".obsidian", "plugins", "datanotes", "data.json");
-  if (import_node_fs5.default.existsSync(plugin)) return plugin;
   return import_node_path5.default.join(o.vault, ".datanotes", "service.json");
 }
 async function startService(o, env = process.env) {
@@ -22123,13 +22103,9 @@ async function startService(o, env = process.env) {
     } catch {
       current2 = {};
     }
-    const { httpServerEnabled: _forced, ...mine } = settings;
     import_node_fs5.default.mkdirSync(import_node_path5.default.dirname(file), { recursive: true });
-    import_node_fs5.default.writeFileSync(file, JSON.stringify({ ...current2, ...mine }, null, 2));
+    import_node_fs5.default.writeFileSync(file, JSON.stringify({ ...current2, ...settings }, null, 2));
   };
-  const view = new Proxy(settings, {
-    get: (t, k) => k === "httpServerEnabled" ? true : t[k]
-  });
   const host = openNodeVault(o.vault);
   const watcher = new NodeWatcher(host.vault, { mode: o.watch, intervalMs: o.pollMs });
   const keyFromFile = () => {
@@ -22143,7 +22119,7 @@ async function startService(o, env = process.env) {
   const runtime = new EngineRuntime({
     ...o.host ? { httpHost: o.host } : {},
     app: host.app,
-    getSettings: () => view,
+    getSettings: () => settings,
     saveSettings: save,
     transport: async (req) => {
       const res = await fetch(req.url, { method: req.method, headers: req.headers, body: req.body });
@@ -22251,7 +22227,7 @@ Docs: https://datanotes.dev`;
 }
 
 // src/node/cli.ts
-var VERSION2 = true ? "1.1.0" : "dev";
+var VERSION2 = true ? "1.2.0" : "dev";
 async function main2(argv = process.argv.slice(2)) {
   const [command, ...rest] = argv;
   if (command === "--version" || command === "-v" || command === "version") return void process.stdout.write(`${VERSION2}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "datanotes",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "The engine of your second brain: Markdown notes as database tables, for you and your agents.",
   "keywords": [
-    "obsidian",
     "markdown",
     "database",
     "mcp",
     "model-context-protocol",
     "second-brain",
     "agents",
-    "frontmatter"
+    "frontmatter",
+    "obsidian-vault"
   ],
   "homepage": "https://datanotes.dev",
   "bugs": {
@@ -56,8 +56,6 @@
     "node": ">=20"
   },
   "scripts": {
-    "dev": "node esbuild.config.mjs",
-    "build": "node scripts/check-layers.mjs && tsc -noEmit -skipLibCheck && node esbuild.config.mjs production",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
@@ -65,16 +63,14 @@
     "check:layers": "node scripts/check-layers.mjs",
     "test:node": "vitest run --config vitest.node.config.ts",
     "build:service": "node scripts/check-layers.mjs && tsc -noEmit -skipLibCheck && node esbuild.service.mjs && npm run build:api",
-    "build:client": "node scripts/check-layers.mjs && tsc -noEmit -skipLibCheck && node esbuild.client.mjs",
     "prepack": "npm run build:service",
-    "build:api": "tsc -p tsconfig.api.json && node esbuild.api.mjs"
+    "build:api": "tsc -p tsconfig.api.json && node esbuild.api.mjs",
+    "build": "npm run build:service"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",
     "@vitest/coverage-v8": "^2.1.9",
     "esbuild": "0.25.5",
-    "happy-dom": "^20.9.0",
-    "obsidian": "1.7.2",
     "tslib": "2.8.1",
     "typescript": "^5.8.3",
     "vitest": "^2.1.9",