kontexta-mcp 2.0.2

package/dist/migrations/001-initial.sql

@@ -0,0 +1,72 @@
+-- Initial database schema for Kontexta
+
+-- Projects table
+CREATE TABLE IF NOT EXISTS projects (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  slug TEXT NOT NULL UNIQUE,
+  description TEXT,
+  path TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Files table
+CREATE TABLE IF NOT EXISTS files (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  path TEXT NOT NULL UNIQUE,
+  title TEXT NOT NULL,
+  project_id INTEGER,
+  storage_type TEXT NOT NULL CHECK(storage_type IN ('local', 'reference', 'backup')),
+  source_path TEXT,
+  content_hash TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (project_id) REFERENCES projects(id)
+);
+
+-- Tags table
+CREATE TABLE IF NOT EXISTS tags (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL UNIQUE,
+  color TEXT
+);
+
+-- File-Tag junction table
+CREATE TABLE IF NOT EXISTS file_tags (
+  file_id INTEGER NOT NULL,
+  tag_id INTEGER NOT NULL,
+  PRIMARY KEY (file_id, tag_id),
+  FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE,
+  FOREIGN KEY (tag_id) REFERENCES tags(id) ON DELETE CASCADE
+);
+
+-- Favorites table
+CREATE TABLE IF NOT EXISTS favorites (
+  file_id INTEGER PRIMARY KEY,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (file_id) REFERENCES files(id) ON DELETE CASCADE
+);
+
+-- Users table
+CREATE TABLE IF NOT EXISTS users (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  email TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- Insert default user
+INSERT OR IGNORE INTO users (id, name, email)
+VALUES (1, 'Default User', NULL);
+
+-- FTS5 virtual table for full-text search
+CREATE VIRTUAL TABLE IF NOT EXISTS fts_index USING fts5(
+  title,
+  content,
+  tokenize='porter unicode61'
+);
+
+-- Indexes for performance
+CREATE INDEX IF NOT EXISTS idx_files_project ON files(project_id);
+CREATE INDEX IF NOT EXISTS idx_files_storage_type ON files(storage_type);
+CREATE INDEX IF NOT EXISTS idx_files_path ON files(path);

package/dist/migrations/002-remote-git.sql

@@ -0,0 +1,2 @@
+-- Add remote_url to projects for collaboration
+ALTER TABLE projects ADD COLUMN remote_url TEXT;

package/dist/migrations/003-source-path-index.sql

@@ -0,0 +1,2 @@
+-- Speeds up dedup lookup for clipped URLs (clipUrl looks up files by source_path).
+CREATE INDEX IF NOT EXISTS idx_files_source_path ON files(source_path);

package/dist/migrations/004-journaling.sql

@@ -0,0 +1,44 @@
+-- Journaling & indexing — Phase 1 tables.
+-- See docs/superpowers/specs/2026-05-12-journaling-and-indexing-design.md §4.5
+
+CREATE TABLE IF NOT EXISTS journal_meta (
+  file_id        INTEGER PRIMARY KEY REFERENCES files(id) ON DELETE CASCADE,
+  project_id     INTEGER NOT NULL REFERENCES projects(id),
+  task_slug      TEXT NOT NULL,
+  status_latest  TEXT,
+  started_at     TEXT NOT NULL,
+  last_active_at TEXT NOT NULL,
+  touched_files  TEXT NOT NULL DEFAULT '[]',
+  raw_sources    TEXT NOT NULL DEFAULT '[]'
+);
+
+CREATE INDEX IF NOT EXISTS idx_journal_project_active
+  ON journal_meta(project_id, last_active_at DESC);
+CREATE INDEX IF NOT EXISTS idx_journal_project_status
+  ON journal_meta(project_id, status_latest);
+CREATE INDEX IF NOT EXISTS idx_journal_task_slug
+  ON journal_meta(project_id, task_slug);
+
+CREATE TABLE IF NOT EXISTS journal_touches (
+  file_id      INTEGER NOT NULL REFERENCES journal_meta(file_id) ON DELETE CASCADE,
+  touched_path TEXT NOT NULL,
+  PRIMARY KEY (file_id, touched_path)
+);
+CREATE INDEX IF NOT EXISTS idx_journal_touches_path ON journal_touches(touched_path);
+
+CREATE TABLE IF NOT EXISTS journal_git_refs (
+  file_id   INTEGER NOT NULL REFERENCES journal_meta(file_id) ON DELETE CASCADE,
+  ref_type  TEXT NOT NULL,
+  ref_value TEXT NOT NULL,
+  PRIMARY KEY (file_id, ref_type, ref_value)
+);
+CREATE INDEX IF NOT EXISTS idx_journal_git_value ON journal_git_refs(ref_type, ref_value);
+
+-- Per-project high-water mark for distillation. Single row per project_slug.
+-- Stored in DB (not just on disk) so SQL queries can report status without filesystem walk.
+CREATE TABLE IF NOT EXISTS journal_high_water (
+  project_slug      TEXT PRIMARY KEY,
+  last_event_ts     TEXT NOT NULL,
+  last_distilled_at TEXT NOT NULL,
+  events_processed  INTEGER NOT NULL DEFAULT 0
+);

package/dist/migrations/005-auth.sql

@@ -0,0 +1,7 @@
+-- 005-auth.sql
+
+CREATE TABLE IF NOT EXISTS settings (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "kontexta-mcp",
+  "version": "2.0.2",
+  "description": "The local Brain and Hands for AI coding agents (MCP Server)",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "kontexta",
+    "context-engine",
+    "knowledge-base",
+    "agentic",
+    "claude",
+    "cursor",
+    "rag"
+  ],
+  "homepage": "https://github.com/safiyu/kontexta#readme",
+  "bugs": {
+    "url": "https://github.com/safiyu/kontexta/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/safiyu/kontexta.git",
+    "directory": "apps/mcp"
+  },
+  "license": "Apache-2.0",
+  "author": "safiyu",
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "exports": {
+    ".": "./dist/index.js",
+    "./hands/loader": "./dist/hands/loader.js",
+    "./hands/sanitizer": "./dist/hands/sanitizer.js",
+    "./hands/types": "./dist/hands/types.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "kontexta-mcp": "dist/index.js",
+    "kxta": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:npm": "tsup",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "smoke": "node test-tools.mjs",
+    "gen:manifest": "node scripts/generate-manifest.js",
+    "test": "node test-tools.mjs",
+    "prepublishOnly": "pnpm run build:npm"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "better-sqlite3": "^11.7.0",
+    "chokidar": "^4.0.0",
+    "kxta-core": "workspace:*",
+    "re2": "^1.21.4",
+    "simple-git": "^3.27.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0"
+  },
+  "rulesVersion": "2.0.0"
+}