obsidian-tc 1.0.2 → 1.3.1

package/dist/migrations/20260519_002_entity_unique.sql

@@ -0,0 +1,51 @@
+-- 20260519_002_entity_unique — F4: enforce the entity natural key
+-- (vault_id, entity_type, name) at the DB level to close the create_entity
+-- read-then-insert race. Pre-existing duplicates are merged into the earliest
+-- (MIN rowid) row. Relations are repointed onto the survivor BEFORE the dedup
+-- DELETE, so the ON DELETE CASCADE FKs do not drop edges that belonged to a
+-- duplicate (review #5); then the unique index is created.
+
+-- Repoint outgoing edges of a duplicate onto its surviving sibling. UPDATE OR IGNORE
+-- drops a repoint that would collide with an existing (source,target,type) edge.
+UPDATE OR IGNORE memory_relations
+SET source_id = (
+  SELECT keep.id
+  FROM memory_entities dup
+  JOIN memory_entities keep
+    ON keep.vault_id = dup.vault_id
+   AND keep.entity_type = dup.entity_type
+   AND keep.name = dup.name
+  WHERE dup.id = memory_relations.source_id
+  ORDER BY keep.rowid
+  LIMIT 1
+)
+WHERE source_id IN (
+  SELECT id FROM memory_entities
+  WHERE rowid NOT IN (SELECT MIN(rowid) FROM memory_entities GROUP BY vault_id, entity_type, name)
+);
+
+-- Repoint incoming edges likewise.
+UPDATE OR IGNORE memory_relations
+SET target_id = (
+  SELECT keep.id
+  FROM memory_entities dup
+  JOIN memory_entities keep
+    ON keep.vault_id = dup.vault_id
+   AND keep.entity_type = dup.entity_type
+   AND keep.name = dup.name
+  WHERE dup.id = memory_relations.target_id
+  ORDER BY keep.rowid
+  LIMIT 1
+)
+WHERE target_id IN (
+  SELECT id FROM memory_entities
+  WHERE rowid NOT IN (SELECT MIN(rowid) FROM memory_entities GROUP BY vault_id, entity_type, name)
+);
+
+DELETE FROM memory_entities
+WHERE rowid NOT IN (
+  SELECT MIN(rowid) FROM memory_entities GROUP BY vault_id, entity_type, name
+);
+
+CREATE UNIQUE INDEX idx_memory_entities_natural_key
+  ON memory_entities(vault_id, entity_type, name);

package/dist/migrations/20260626_001_experiential_init.sql

@@ -0,0 +1,61 @@
+-- 20260626_001_experiential_init.sql
+-- THE-233 (W-SCHEMA): the experiential tier -- a PHYSICALLY SEPARATE store (experiential.db),
+-- NOT a partition of cache.db. The membrane (see decision
+-- 2026-06-26-experiential-tier-write-on-gate): low-trust per-retrieval state lives in its
+-- own file so an injected / auto-captured episode can never FK into an authored atom,
+-- poisoning blast radius is capped at the store boundary, and a reset is a file truncate
+-- rather than a filtered delete. Because chunks live in cache.db, object_id / chunk_id
+-- reference chunk ids BY VALUE (no cross-file foreign key -- this is the membrane).
+--
+-- Holds only NON-RECONSTRUCTABLE keep-state: engram activation history + retrieval feedback.
+-- Authored chunks are re-indexed from the vault, never imported (thin-merge decision).
+-- Behavior-preserving port of KMS vault_object_state (migration 017) + chunk_retrievals (018).
+--
+-- PRAGMAs (foreign_keys, journal_mode = WAL) are set per-connection by the runtime.
+-- The migration runner pre-creates schema_migrations; it is not declared here.
+--
+-- TRIPWIRE: valid_from / valid_until are the EXISTING KMS 2-timestamp validity, loaded
+-- as-is. This is NOT the engine-build 4-timestamp bi-temporal substrate; no claim atoms,
+-- authoritative_claims, or derives_from (THE-235, downstream).
+
+-- ACT-R / engram activation state, one row per chunk (object).
+CREATE TABLE vault_object_state (
+  object_id               TEXT PRIMARY KEY,          -- chunk id, by value (membrane: no cross-file FK)
+  retrieval_strength      REAL,
+  storage_strength        REAL,
+  frequency               INTEGER NOT NULL DEFAULT 0,
+  last_accessed           INTEGER,
+  learned_at              INTEGER,
+  valid_from              INTEGER,                   -- existing KMS 2-timestamp validity (loaded as-is)
+  valid_until             INTEGER,
+  emotional_weight        REAL NOT NULL DEFAULT 5,   -- KMS default 5 (1-10 modulates ACT-R decay)
+  confidence              REAL,
+  injections              INTEGER NOT NULL DEFAULT 0,
+  hits                    INTEGER NOT NULL DEFAULT 0,
+  misses                  INTEGER NOT NULL DEFAULT 0,
+  last_hit_at             INTEGER,
+  cached_activation_score REAL,
+  last_computed_at        INTEGER
+);
+
+CREATE INDEX idx_vault_object_state_activation
+  ON vault_object_state(cached_activation_score)
+  WHERE cached_activation_score IS NOT NULL;
+
+-- Append-only retrieval event log; feeds the nightly activation recompute (sleep-time plane).
+CREATE TABLE chunk_retrievals (
+  id                TEXT PRIMARY KEY,                -- retrieval event id, by value
+  chunk_id          TEXT NOT NULL,                   -- chunk id, by value (membrane: no cross-file FK)
+  retrieved_at      INTEGER NOT NULL,
+  session_id        TEXT,
+  surface_type      TEXT,                            -- which surface / client retrieved it
+  query_text        TEXT,
+  rank_in_results   INTEGER,
+  rerank_score      REAL,                            -- rerank passthrough score (D1); was KMS cohere_score
+  cited_in_response INTEGER,                         -- nullable 0/1
+  citation_score    REAL,
+  feedback          INTEGER                          -- -1 | 0 | +1
+);
+
+CREATE INDEX idx_chunk_retrievals_chunk   ON chunk_retrievals(chunk_id, retrieved_at DESC);
+CREATE INDEX idx_chunk_retrievals_session ON chunk_retrievals(session_id) WHERE session_id IS NOT NULL;

package/dist/migrations/20260626_001_vault_edges.sql

@@ -0,0 +1,31 @@
+-- 20260626_001_vault_edges.sql
+-- THE-233 (W-SCHEMA): wikilink edge graph for GraphRAG.
+--
+-- The ported vault_graph_expand walks this edge table (KMS migrations 005/011/013).
+-- Edges are authored / derived from vault wikilinks, so they live in the main cache.db
+-- alongside chunks. Path-based (a wikilink is note -> note); the graph walk joins edges
+-- to chunks by path. Behavior-preserving port of the KMS vault_edges shape (Postgres)
+-- onto SQLite. SQLite has full recursive CTEs, so the expand walk ports directly; only
+-- the pgvector distance operator becomes a sqlite-vec / in-process call (retrieval slice).
+--
+-- PRAGMAs (foreign_keys, journal_mode = WAL) are set per-connection by the runtime.
+--
+-- TRIPWIRE: plain graph structure only. No claim atoms, authoritative_claims,
+-- derives_from, or bi-temporal columns -- that is the engine-build typed-atom substrate
+-- (THE-235), downstream of this merge.
+
+CREATE TABLE vault_edges (
+  source_path  TEXT NOT NULL,                       -- vault-relative note path (edge tail)
+  target_path  TEXT NOT NULL,                       -- vault-relative note path (edge head)
+  edge_type    TEXT NOT NULL,                       -- relation verb, e.g. "links_to" | "embed" | "tag"
+  edge_kind    TEXT NOT NULL DEFAULT 'literal',     -- 'literal' (wikilink) | 'virtual' (cosine neighbor)
+  provenance   TEXT,                                -- how the edge was derived, e.g. "wikilink" | "graph_expand"
+  created_at   INTEGER NOT NULL,
+  updated_at   INTEGER NOT NULL
+);
+
+-- Dedup identical edges regardless of insert order (mirrors KMS unique(source, target, type)).
+CREATE UNIQUE INDEX idx_vault_edges_unique ON vault_edges(source_path, target_path, edge_type);
+CREATE INDEX idx_vault_edges_source ON vault_edges(source_path);
+CREATE INDEX idx_vault_edges_target ON vault_edges(target_path);
+CREATE INDEX idx_vault_edges_kind   ON vault_edges(edge_kind);

package/dist/migrations/20260626_002_plane.sql

@@ -0,0 +1,69 @@
+-- 20260626_002_plane.sql
+-- THE-233 W-WORKERS: sleep-time consolidation plane state tables. Committed here but NOT yet
+-- wired into the cli.ts migrate chain — that registration lands in the integration slice
+-- (Batch 4), alongside W-SCHEMA's vault_edges/experiential migrations. The plane jobs operate
+-- on these tables; the unit tests provision them directly.
+--
+-- PRAGMAs (foreign_keys, journal_mode = WAL) are set per-connection by the runtime.
+-- TRIPWIRE: lifecycle/state tables only. No claim atoms, authoritative_claims, derives_from,
+-- or 4-timestamp bi-temporal columns (detected_at/resolved_at is the existing KMS 2-timestamp
+-- flag lifecycle, not the engine-build substrate).
+
+-- Contradiction flags (contradiction job; was KMS contradictions table). Flag-only lifecycle.
+CREATE TABLE contradictions (
+  id                   TEXT PRIMARY KEY,
+  source_chunk_id      TEXT NOT NULL,
+  source_path          TEXT NOT NULL,
+  conflict_chunk_id    TEXT NOT NULL,
+  conflict_path        TEXT NOT NULL,
+  source_content_sha   TEXT NOT NULL,
+  conflict_content_sha TEXT NOT NULL,
+  cosine_similarity    REAL,
+  judge_verdict        TEXT NOT NULL,        -- 'contradiction' | 'tension'
+  judge_rationale      TEXT,
+  judge_model          TEXT,                 -- resolved gateway model (attestation)
+  status               TEXT NOT NULL DEFAULT 'open',
+  detected_at          INTEGER NOT NULL,
+  resolved_at          INTEGER
+);
+
+-- Dedup a pair regardless of which side was the new chunk (mirrors KMS unique constraint).
+CREATE UNIQUE INDEX idx_contradictions_pair ON contradictions(source_content_sha, conflict_content_sha);
+CREATE INDEX idx_contradictions_status ON contradictions(status, detected_at DESC);
+
+-- Weekly synthesis records (synthesis job; was KMS syntheses table). One row per ISO week.
+CREATE TABLE syntheses (
+  iso_year      INTEGER NOT NULL,
+  iso_week      INTEGER NOT NULL,
+  generated_at  INTEGER NOT NULL,
+  cluster_count INTEGER NOT NULL,
+  pattern_count INTEGER NOT NULL,
+  clusters      TEXT NOT NULL,               -- JSON
+  patterns      TEXT NOT NULL,               -- JSON
+  judge_model   TEXT,
+  PRIMARY KEY (iso_year, iso_week)
+);
+
+-- Health audit reports (audit job; was KMS audit_reports/audit_flags collapsed).
+CREATE TABLE audit_reports (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  report_type TEXT NOT NULL,
+  created_at  INTEGER NOT NULL,
+  has_issues  INTEGER NOT NULL,
+  summary     TEXT,
+  report      TEXT NOT NULL                  -- JSON
+);
+
+CREATE INDEX idx_audit_reports_created ON audit_reports(created_at DESC);
+
+-- Plane run log (observability for the local job runner).
+CREATE TABLE job_runs (
+  id          INTEGER PRIMARY KEY AUTOINCREMENT,
+  job         TEXT NOT NULL,
+  started_at  INTEGER NOT NULL,
+  finished_at INTEGER,
+  ok          INTEGER NOT NULL,
+  detail      TEXT                           -- JSON
+);
+
+CREATE INDEX idx_job_runs_job ON job_runs(job, started_at DESC);

package/dist/migrations/20260702_001_notes.sql

@@ -0,0 +1,17 @@
+-- THE-291: per-note metadata backing the lexical/metadata index (list_tags, list_properties,
+-- find_notes_by_*, search_text acceleration). notes_fts (FTS5, trigram) is runtime-provisioned
+-- by ensureNotesFts (search/fts.ts) exactly like vec_chunks — deliberately NOT in this chain,
+-- so the versioned migrations apply unchanged on an adapter built without FTS5.
+CREATE TABLE IF NOT EXISTS notes (
+  vault_id     TEXT NOT NULL,
+  path         TEXT NOT NULL,
+  title        TEXT NOT NULL,
+  tags         TEXT NOT NULL,           -- JSON array (noteTags(raw).all)
+  frontmatter  TEXT,                    -- JSON object; NULL when absent or unserializable
+  content_hash TEXT NOT NULL,           -- contentHash(raw) — backfill/staleness key
+  mtime        INTEGER NOT NULL,
+  size         INTEGER NOT NULL,
+  indexed_at   INTEGER NOT NULL,
+  PRIMARY KEY (vault_id, path)
+);
+CREATE INDEX IF NOT EXISTS idx_notes_hash ON notes(content_hash);

package/dist/plugin/main.js

@@ -0,0 +1,5 @@
+"use strict";var k=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var B=Object.prototype.hasOwnProperty;var E=(l,s)=>{for(var o in s)k(l,o,{get:s[o],enumerable:!0})},L=(l,s,o,n)=>{if(s&&typeof s=="object"||typeof s=="function")for(let i of T(s))!B.call(l,i)&&i!==o&&k(l,i,{get:()=>s[i],enumerable:!(n=C(s,i))||n.enumerable});return l};var S=l=>L(k({},"__esModule",{value:!0}),l);var O={};E(O,{default:()=>b});module.exports=S(O);var q=require("obsidian");var _=require("obsidian"),j="1",R={excalidraw:"obsidian-excalidraw-plugin",dataview:"dataview",tasks:"obsidian-tasks-plugin",templater:"templater-obsidian",quickadd:"quickadd","text-extractor":"obsidian-text-extractor","make-md":"make-md"},c=(l,s)=>{l.status(200).json({ok:!0,result:s})},u=(l,s,o,n)=>{l.status(200).json({ok:!1,code:s,message:o,...n?{details:n}:{}})},m=l=>typeof l.body=="object"&&l.body!==null?l.body:{},g=(l,s)=>typeof l[s]=="string"?l[s]:void 0;function w(l,s){let o=R[s];return o?l.plugins?.plugins?.[o]:void 0}function h(l,s,o){let n=w(l,o);return n?n.api?n.api:(u(s,"plugin_unreachable",`${o} exposes no programmatic API`,{plugin:o}),null):(u(s,"plugin_missing",`${o} is not installed`,{plugin:o}),null)}function F(l,s,o){let n={};for(let[i,e]of Object.entries(R)){let t=l.plugins?.plugins?.[e];n[i]=t?{installed:!0,...t.manifest?.version?{version:t.manifest.version}:{}}:{installed:!1}}return{plugin_version:s,obsidian_version:_.apiVersion,obsidianTcApiVersion:j,vault_path:l.vault.getName(),capabilities:n,shape_ok:o.length===0,...o.length?{shape_warnings:o}:{}}}function x(l,s){let o=l.vault.getAbstractFileByPath((0,_.normalizePath)(s));return o&&"extension"in o?o:null}function A(l,s,o=[]){let n=l;return[{method:"get",path:"/probe",handler:(i,e)=>c(e,F(n,s,o))},{method:"post",path:"/commands/list",handler:(i,e)=>{let t=g(m(i),"filter")?.toLowerCase(),a=(n.commands?.listCommands()??[]).map(r=>({id:r.id,name:r.name})).filter(r=>!t||r.id.toLowerCase().includes(t)||r.name.toLowerCase().includes(t));c(e,{items:a,total:a.length})}},{method:"post",path:"/commands/execute",handler:(i,e)=>{let t=g(m(i),"command_id");if(!t)return u(e,"invalid_input","command_id is required");if(!(n.commands?.executeCommandById(t)??!1))return u(e,"invalid_input","command not found or did not run",{command_id:t});c(e,{command_id:t,fired_at:new Date().toISOString()})}},{method:"post",path:"/dataview/dql",handler:async(i,e)=>{let t=h(n,e,"dataview");if(!t)return;if(!t.query)return u(e,"plugin_unreachable","dataview query API unavailable",{plugin:"dataview"});let a=await t.query(g(m(i),"dql")??"");if(!a.successful)return u(e,"dql_error",a.error??"DQL query failed");c(e,{headers:a.value?.headers??[],rows:a.value?.values??[],note_paths:[]})}},{method:"post",path:"/dataview/validate",handler:async(i,e)=>{let t=h(n,e,"dataview");if(!t)return;if(!t.query)return u(e,"plugin_unreachable","dataview query API unavailable",{plugin:"dataview"});let a=await t.query(g(m(i),"dql")??"");c(e,{valid:a.successful,...a.successful?{}:{error:{message:a.error??"parse error"}}})}},{method:"post",path:"/dataview/eval",handler:async(i,e)=>{let t=h(n,e,"dataview");if(!t)return;if(!t.evaluate)return u(e,"plugin_unreachable","dataview evaluate API unavailable",{plugin:"dataview"});let a=m(i),r=await t.evaluate(g(a,"expression")??"",g(a,"path"));if(!r.successful)return u(e,"dql_error",r.error??"evaluation failed");c(e,{value:r.value,type:typeof r.value})}},{method:"post",path:"/quickadd/actions",handler:(i,e)=>{let t=w(n,"quickadd");if(!t)return u(e,"plugin_missing","quickadd is not installed",{plugin:"quickadd"});let r=(t.settings?.choices??[]).map(d=>({name:d.name,type:d.type??"unknown"}));c(e,{items:r})}},{method:"post",path:"/quickadd/trigger",handler:async(i,e)=>{let t=h(n,e,"quickadd");if(!t)return;if(!t.executeChoice)return u(e,"plugin_unreachable","quickadd execute API unavailable",{plugin:"quickadd"});let a=m(i),r=g(a,"action_name");if(!r)return u(e,"invalid_input","action_name is required");let d=typeof a.args=="object"&&a.args!==null?a.args:void 0;await t.executeChoice(r,d),c(e,{action_name:r,fired_at:new Date().toISOString()})}},{method:"post",path:"/ocr/attachment",handler:async(i,e)=>{let t=h(n,e,"text-extractor");if(!t)return;if(!t.extractText)return u(e,"plugin_unreachable","text-extractor API unavailable",{plugin:"text-extractor"});let a=g(m(i),"path")??"",r=x(n,a);if(!r)return u(e,"note_not_found","attachment not found",{path:a});let d=await t.isInCache?.(r)??!1,p=Date.now(),f=await t.extractText(r);c(e,{path:a,text:f,cached:d,duration_ms:Date.now()-p})}},{method:"post",path:"/ocr/bulk",handler:async(i,e)=>{let t=h(n,e,"text-extractor");if(!t)return;if(!t.extractText)return u(e,"plugin_unreachable","text-extractor API unavailable",{plugin:"text-extractor"});let a=m(i).paths,r=Array.isArray(a)?a:[],d=Date.now(),p=[];for(let f of r){let y=x(n,f);if(!y){p.push({path:f,ok:!1,error:"not found"});continue}try{p.push({path:f,ok:!0,text:await t.extractText(y)})}catch(v){p.push({path:f,ok:!1,error:v.message})}}c(e,{processed:p.length,results:p,total_duration_ms:Date.now()-d})}},{method:"post",path:"/excalidraw/read",handler:async(i,e)=>{if(!w(n,"excalidraw"))return u(e,"plugin_missing","excalidraw is not installed",{plugin:"excalidraw"});let t=g(m(i),"path")??"",a=x(n,t);if(!a)return u(e,"note_not_found","drawing not found",{path:t});let r=await n.vault.read(a);c(e,{path:t,text_content:r})}},{method:"post",path:"/excalidraw/write",handler:async(i,e)=>{if(!w(n,"excalidraw"))return u(e,"plugin_missing","excalidraw is not installed",{plugin:"excalidraw"});let t=m(i),a=g(t,"path")??"",r=x(n,a);if(t.mode==="create"&&r&&t.overwrite!==!0)return u(e,"note_exists","drawing already exists",{path:a});let d=`---
+excalidraw-plugin: parsed
+---
+# Excalidraw Data
+`;r?await n.vault.modify(r,d):await n.vault.create((0,_.normalizePath)(a),d),c(e,{path:a,plugin_used:!0})}},{method:"post",path:"/makemd/spaces",handler:(i,e)=>{let t=h(n,e,"make-md");t&&c(e,{spaces:typeof t.spaces=="function"?t.spaces():[]})}},{method:"post",path:"/makemd/query",handler:(i,e)=>{let t=h(n,e,"make-md");if(!t)return;if(!t.query)return u(e,"plugin_unreachable","make-md query API unavailable",{plugin:"make-md"});let a=m(i),r=t.query(g(a,"space_id")??"",a.filter);c(e,{items:Array.isArray(r)?r:[],total:Array.isArray(r)?r.length:0})}},{method:"post",path:"/templater/list",handler:(i,e)=>{let t=w(n,"templater");if(!t)return u(e,"plugin_missing","templater is not installed",{plugin:"templater"});let r=t.settings?.templates_folder,d=r?n.vault.getMarkdownFiles().filter(p=>p.path.startsWith(`${r}/`)).map(p=>({path:p.path,name:p.basename})):[];c(e,{items:d})}},{method:"post",path:"/templater/execute",handler:async(i,e)=>{let t=w(n,"templater");if(!t)return u(e,"plugin_missing","templater is not installed",{plugin:"templater"});if(!t.templater?.create_new_note_from_template)return u(e,"plugin_unreachable","templater expansion API unavailable",{plugin:"templater"});let a=m(i),r=g(a,"template")??"",d=g(a,"target")??"",p=x(n,r);if(!p)return u(e,"note_not_found","template not found",{path:r});let f=d.endsWith(".md")?d:`${d}.md`;if(a.overwrite!==!0&&x(n,f))return u(e,"note_exists","target already exists; set overwrite",{path:f});let y=t.templater.create_new_note_from_template,v=d.lastIndexOf("/"),P=v>0?d.slice(0,v):"",I=(v>=0?d.slice(v+1):d).replace(/\.md$/,""),D=await y(p,P,I,!1);c(e,{template:r,target:D?.path??d,created_at:new Date().toISOString()})}},{method:"post",path:"/tasks/filter",handler:(i,e)=>{if(!w(n,"tasks"))return u(e,"plugin_missing","tasks is not installed",{plugin:"tasks"});u(e,"plugin_unreachable","Tasks exposes no programmatic filter API; use list_tasks",{plugin:"tasks"})}}]}var $="obsidian-local-rest-api",b=class extends q.Plugin{async onload(){let s=[],o=this.app;typeof o.commands?.listCommands!="function"&&s.push("app.commands.listCommands is not a function"),(typeof o.plugins?.plugins!="object"||o.plugins?.plugins===null)&&s.push("app.plugins.plugins is not an object");let n=A(this.app,this.manifest.version,s),i=this.registerBridgeRoutes(n);i===null?console.warn("[obsidian-tc] Local REST API plugin not found (or no extension API); bridge routes not registered. Install/enable the Local REST API plugin."):(s.length&&console.warn(`[obsidian-tc] degraded: ${s.join("; ")} \u2014 Obsidian internals may have moved; some bridges will degrade.`),console.info(`[obsidian-tc] registered ${i} bridge routes under /obsidian-tc/v1`))}registerBridgeRoutes(s){let o=this.app.plugins?.plugins?.[$];if(!o)return null;let n=o.requestHandler?.apiExtensionRouter;if(n){for(let e of s)n[e.method](e.path,e.handler);return s.length}let i=o.api?.addRoute;if(i){for(let e of s)i.call(o.api,e.path)[e.method](e.handler);return s.length}return null}};

package/dist/plugin/manifest.json

@@ -0,0 +1,11 @@
+{
+  "id": "obsidian-tc",
+  "name": "Obsidian Turbocharged",
+  "version": "1.0.2",
+  "minAppVersion": "1.7.0",
+  "description": "Companion plugin for the obsidian-tc MCP server. Extends Local REST API with command dispatch and plugin firepower bridges.",
+  "author": "The 40 Thieves",
+  "authorUrl": "https://github.com/The-40-Thieves",
+  "fundingUrl": "",
+  "isDesktopOnly": false
+}

package/dist/schema.sql

@@ -7,7 +7,10 @@
 --   PRAGMA foreign_keys = ON;
 --   PRAGMA journal_mode = WAL;
 --
--- One DB file per vault, located at <cache_dir>/<vault_id>/db.sqlite.
+-- One SHARED cache DB for the whole server, at <config.cacheDir>/cache.db (vault isolation
+-- is logical via vault_id columns — see ARCHITECTURE.md component 10; per-vault DB files are
+-- the planned V2 storage rewrite). A sibling
+-- experiential.db holds the low-trust membrane tier, provisioned on its own migration chain.
 
 -- ============================================================================
 -- Migrations tracking
@@ -139,6 +142,9 @@ CREATE TABLE memory_entities (
 
 CREATE INDEX idx_memory_entities_vault_type ON memory_entities(vault_id, entity_type);
 CREATE INDEX idx_memory_entities_name       ON memory_entities(vault_id, name);
+-- Natural key (F4): (vault_id, entity_type, name) is unique — closes the create_entity
+-- read-then-insert race. Migration 20260519_002 dedups + adds this on existing DBs.
+CREATE UNIQUE INDEX idx_memory_entities_natural_key ON memory_entities(vault_id, entity_type, name);
 
 CREATE TABLE memory_relations (
   source_id      TEXT NOT NULL,
@@ -169,7 +175,7 @@ CREATE INDEX idx_memory_relations_target ON memory_relations(target_id);
 --   3. Replay reads existing row if completed_at IS NOT NULL.
 --   4. Concurrent INSERT with same (vault_id, key) and completed_at IS NULL
 --      raises idempotency_in_flight.
---   5. Sweep reaps rows where started_at + 60000 < now AND
+--   5. Sweep reaps rows where started_at + the configured reclaim window (idempotencyReclaimSeconds x 1000 ms, default 60000) < now AND
 --      completed_at IS NULL (process crashed mid-execution).
 -- ============================================================================
 

package/package.json

@@ -1,16 +1,20 @@
 {
   "name": "obsidian-tc",
-  "version": "1.0.2",
+  "version": "1.3.1",
   "description": "MCP server for Obsidian — comprehensive tool surface for humans and autonomous agents",
-  "license": "Apache-2.0",
+  "license": "AGPL-3.0-only",
   "type": "module",
   "main": "./dist/index.js",
   "bin": {
     "obsidian-tc": "./dist/cli.js"
   },
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
-    "build": "bun build ./src/index.ts ./src/cli.ts --outdir ./dist --target node && bun scripts/copy-assets.mjs",
+    "build": "bun build ./src/index.ts ./src/cli.ts --outdir ./dist --target node --external better-sqlite3 --minify --sourcemap=linked && bun scripts/copy-assets.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
@@ -19,30 +23,36 @@
   "dependencies": {
     "@hono/node-server": "^2.0.5",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@the-40-thieves/obsidian-tc-native": "1.0.2",
-    "@the-40-thieves/obsidian-tc-shared": "1.0.2",
+    "@the-40-thieves/obsidian-tc-native": "1.3.1",
+    "@the-40-thieves/obsidian-tc-shared": "1.3.1",
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/exporter-trace-otlp-http": "^0.219.0",
     "@opentelemetry/resources": "^2.8.0",
     "@opentelemetry/sdk-trace-node": "^2.8.0",
     "@opentelemetry/semantic-conventions": "^1.41.1",
-    "better-sqlite3": "^11.5.0",
+    "better-sqlite3": "^12.11.1",
     "fetch-to-node": "^2.1.0",
     "hono": "^4.6.0",
     "jose": "^6.2.3",
     "prom-client": "^15.1.3",
     "sqlite-vec": "^0.1.9",
-    "yaml": "^2.6.1",
-    "zod": "^3.23.0",
-    "zod-to-json-schema": "^3.24.0"
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.0",
-    "@types/node": "^22.0.0",
-    "@vitest/coverage-v8": "^2.1.0",
-    "vitest": "^2.1.0"
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^24.0.0",
+    "@vitest/coverage-v8": "^3.2.6",
+    "vitest": "^3.2.6"
   },
-  "keywords": ["obsidian", "mcp", "model-context-protocol", "knowledge-management", "agent", "ai"],
+  "keywords": [
+    "obsidian",
+    "mcp",
+    "model-context-protocol",
+    "knowledge-management",
+    "agent",
+    "ai"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/The-40-Thieves/obsidian-tc.git",
@@ -51,5 +61,8 @@
   "exports": {
     ".": "./dist/index.js",
     "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=24"
   }
 }