workhorse-ai-mcp 0.7.2

package/mcp/sync.mjs

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+// workhorse-sync — пушер журнала в облако planado (шаг 2 спеки «Sync design»).
+// Направление строго вверх: GET курсор → POST батчи событий с seq > курсора.
+// Zero deps: node:sqlite (read-only) + встроенный fetch. Ошибки возвращаются
+// значением ({error}), исключения наружу не летят — пушер никогда не роняет журнал.
+
+import { DatabaseSync } from "node:sqlite";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir, hostname, userInfo } from "node:os";
+import { join, dirname } from "node:path";
+import { pathToFileURL } from "node:url";
+
+export const BATCH_SIZE = 200;
+
+function defaultDbPath(env) {
+	return env.WORKHORSE_DB ?? join(homedir(), ".workhorse", "workhorse.db");
+}
+
+// Конфиг синка: JSON-файл {url, token, journalId} рядом с базой (sync.json),
+// путь переопределяется WORKHORSE_SYNC_CONFIG; env-переменные
+// WORKHORSE_SYNC_URL / WORKHORSE_SYNC_TOKEN / WORKHORSE_SYNC_JOURNAL_ID
+// перекрывают значения файла. Нет ни файла, ни env → синк выключен (null) — это норма.
+export function loadSyncConfig({ dbPath, env = process.env, log = console.error } = {}) {
+	const resolvedDbPath = dbPath ?? defaultDbPath(env);
+	const configPath = env.WORKHORSE_SYNC_CONFIG ?? join(dirname(resolvedDbPath), "sync.json");
+
+	let fileConfig = {};
+	if (existsSync(configPath)) {
+		try {
+			fileConfig = JSON.parse(readFileSync(configPath, "utf8"));
+		} catch {
+			log(`workhorse-sync: конфиг не парсится, игнорирую: ${configPath}`);
+			fileConfig = {};
+		}
+	}
+
+	const config = {
+		url: env.WORKHORSE_SYNC_URL ?? fileConfig.url,
+		token: env.WORKHORSE_SYNC_TOKEN ?? fileConfig.token,
+		journalId: env.WORKHORSE_SYNC_JOURNAL_ID ?? fileConfig.journalId,
+	};
+	if (!config.url && !config.token && !config.journalId) return null;
+	return config;
+}
+
+// Запись конфига синка: JSON {url, token, journalId} по тому же пути, откуда
+// его читает loadSyncConfig (WORKHORSE_SYNC_CONFIG ?? sync.json рядом с базой).
+// Перезапись существующего файла — осознанное действие пользователя (connect).
+// Возвращает путь записанного файла.
+export function writeSyncConfig({ dbPath, env = process.env, config }) {
+	const resolvedDbPath = dbPath ?? defaultDbPath(env);
+	const configPath = env.WORKHORSE_SYNC_CONFIG ?? join(dirname(resolvedDbPath), "sync.json");
+	writeFileSync(configPath, `${JSON.stringify(config, null, "\t")}\n`);
+	return configPath;
+}
+
+// Дефолтный id журнала: <username>-<hostname>, нормализованный в [a-z0-9-]
+// (строчные буквы, всё прочее — дефис, серии дефисов схлопнуты, края обрезаны).
+export function defaultJournalId({ username, host } = {}) {
+	const raw = `${username ?? userInfo().username}-${host ?? hostname()}`;
+	return (
+		raw
+			.toLowerCase()
+			.replace(/[^a-z0-9-]+/g, "-")
+			.replace(/-+/g, "-")
+			.replace(/^-|-$/g, "") || "journal"
+	);
+}
+
+// URL инбокса намерений выводится из url синка заменой последнего сегмента
+// пути (journal-sync → journal-inbox): один конфиг — меньше настройки.
+export function inboxUrlFromSyncUrl(syncUrl) {
+	const url = new URL(syncUrl);
+	url.pathname = url.pathname
+		.replace(/\/+$/, "")
+		.replace(/[^/]*$/, "journal-inbox");
+	return url.toString();
+}
+
+// Локальный payload хранится TEXT-JSON; облачная схема ждёт объект.
+function parsePayload(text) {
+	try {
+		const parsed = JSON.parse(text);
+		return typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)
+			? parsed
+			: {};
+	} catch {
+		return {};
+	}
+}
+
+// Пуш журнала: {pushed, lastSeq} либо {error} — без исключений наружу.
+// Базу открывает read-only: пушер — транспорт, журнал он не меняет никогда.
+export async function pushJournal({ dbPath, config, log = () => {} }) {
+	if (!config) return { pushed: 0, disabled: true };
+	if (!config.url || !config.token || !config.journalId) {
+		return { error: "конфиг синка неполный: нужны url, token и journalId" };
+	}
+
+	try {
+		// Заголовок — как ждёт authenticateMcpRequest: Authorization: Bearer <McpToken>
+		const headers = {
+			authorization: `Bearer ${config.token}`,
+			"content-type": "application/json",
+		};
+
+		const cursorUrl = new URL(config.url);
+		cursorUrl.searchParams.set("journalId", config.journalId);
+		const cursorRes = await fetch(cursorUrl, { headers });
+		if (!cursorRes.ok) {
+			return { error: `GET курсора: HTTP ${cursorRes.status}` };
+		}
+		const { lastSeq } = await cursorRes.json();
+		if (!Number.isInteger(lastSeq) || lastSeq < 0) {
+			return { error: `GET курсора: облако вернуло некорректный lastSeq (${lastSeq})` };
+		}
+
+		let rows;
+		const db = new DatabaseSync(dbPath, { readOnly: true });
+		try {
+			rows = db
+				.prepare(
+					"SELECT seq, task_id, type, at, payload FROM events WHERE seq > ? ORDER BY seq",
+				)
+				.all(lastSeq);
+		} finally {
+			db.close();
+		}
+		log(`workhorse-sync: событий за курсором ${lastSeq}: ${rows.length}`);
+		if (rows.length === 0) return { pushed: 0, lastSeq };
+
+		let cursor = lastSeq;
+		let pushed = 0;
+		for (let i = 0; i < rows.length; i += BATCH_SIZE) {
+			const batch = rows.slice(i, i + BATCH_SIZE).map((row) => ({
+				seq: row.seq,
+				taskId: row.task_id,
+				type: row.type,
+				at: row.at,
+				payload: parsePayload(row.payload),
+			}));
+			const res = await fetch(config.url, {
+				method: "POST",
+				headers,
+				body: JSON.stringify({ journalId: config.journalId, events: batch }),
+			});
+			if (!res.ok) {
+				return { error: `POST батча: HTTP ${res.status}`, pushed, lastSeq: cursor };
+			}
+			const result = await res.json();
+			cursor = result.lastSeq ?? batch[batch.length - 1].seq;
+			pushed += batch.length;
+			log(`workhorse-sync: батч ${batch.length}, курсор облака ${cursor}`);
+		}
+		return { pushed, lastSeq: cursor };
+	} catch (err) {
+		return { error: err instanceof Error ? err.message : String(err) };
+	}
+}
+
+// ============ CLI: node mcp/sync.mjs / workhorse-sync ============
+
+const isCli =
+	process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
+
+if (isCli) {
+	const dbPath = defaultDbPath(process.env);
+	const config = loadSyncConfig({ dbPath });
+	if (!config) {
+		console.error(
+			"workhorse-sync: синк не настроен — нет sync.json рядом с базой и нет WORKHORSE_SYNC_URL/TOKEN/JOURNAL_ID",
+		);
+		process.exit(1);
+	}
+	const result = await pushJournal({ dbPath, config, log: console.error });
+	if (result.error) {
+		console.error(`workhorse-sync: ${result.error}`);
+		process.exit(1);
+	}
+	console.log(`отправлено ${result.pushed}, курсор ${result.lastSeq}`);
+	process.exit(0);
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "workhorse-ai-mcp",
+  "version": "0.7.2",
+  "private": false,
+  "type": "module",
+  "description": "Delegation journal for orchestrator/worker AI workflows: event sourcing over SQLite with an MCP interface. Zero dependencies.",
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "delegation",
+    "event-sourcing",
+    "sqlite",
+    "ai-agents",
+    "orchestration"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/planado1/planado_app.git",
+    "directory": "apps/workhorse"
+  },
+  "files": [
+    "mcp/",
+    "schema.sql",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "workhorse-mcp": "mcp/server.mjs",
+    "workhorse-sync": "mcp/sync.mjs"
+  },
+  "scripts": {
+    "test": "node --test \"test/*.test.mjs\""
+  },
+  "engines": {
+    "node": ">=22.5"
+  }
+}

package/schema.sql

@@ -0,0 +1,276 @@
+-- workhorse.db — журнал делегирования оркестратор ↔ рабочая лошадка
+-- Event sourcing в миниатюре: events — источник истины (append-only),
+-- tasks/incidents — материализованные проекции, обновляются триггерами.
+
+PRAGMA journal_mode = WAL;
+
+-- ============ источник истины ============
+
+CREATE TABLE IF NOT EXISTS events (
+    seq     INTEGER PRIMARY KEY AUTOINCREMENT,
+    task_id TEXT NOT NULL,
+    type    TEXT NOT NULL CHECK (type IN (
+                'TaskDrafted',      -- payload: project, title, task_text
+                'Delegated',        -- payload: executor
+                'ReportSubmitted',  -- payload: report
+                'Accepted',         -- payload: outcome, verify_commit
+                'ReworkRequested',  -- payload: reason
+                'Failed',           -- payload: reason
+                'IncidentRecorded', -- payload: description, lesson
+                'ArtifactRecorded', -- payload: project, kind, title, body
+                'TaskLinked',       -- payload: to_task_id, kind
+                'ProjectRegistered' -- payload: name, root_path, planado_workspace_id
+            )),
+    payload TEXT NOT NULL DEFAULT '{}',
+    at      TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_events_task ON events(task_id);
+
+-- журнал только дописывается, никогда не правится
+CREATE TRIGGER IF NOT EXISTS events_no_update BEFORE UPDATE ON events
+BEGIN SELECT RAISE(ABORT, 'events are append-only'); END;
+
+CREATE TRIGGER IF NOT EXISTS events_no_delete BEFORE DELETE ON events
+BEGIN SELECT RAISE(ABORT, 'events are append-only'); END;
+
+-- ============ инварианты уровня БД ============
+-- Дублируют серверные guard'ы, чтобы fallback-вставки мимо MCP не ломали протокол.
+
+CREATE TRIGGER IF NOT EXISTS guard_payload_json BEFORE INSERT ON events
+WHEN NOT json_valid(NEW.payload)
+BEGIN SELECT RAISE(ABORT, 'payload must be valid JSON'); END;
+
+CREATE TRIGGER IF NOT EXISTS guard_project_registered BEFORE INSERT ON events
+WHEN NEW.type IN ('TaskDrafted', 'ArtifactRecorded')
+ AND (json_extract(NEW.payload, '$.project') IS NULL
+      OR NOT EXISTS (SELECT 1 FROM projects WHERE name = json_extract(NEW.payload, '$.project')))
+BEGIN SELECT RAISE(ABORT, 'project missing or not registered'); END;
+
+CREATE TRIGGER IF NOT EXISTS guard_redraft BEFORE INSERT ON events
+WHEN NEW.type = 'TaskDrafted'
+ AND EXISTS (SELECT 1 FROM tasks WHERE task_id = NEW.task_id AND status NOT IN ('DRAFT', 'REWORK'))
+BEGIN SELECT RAISE(ABORT, 'task already past DRAFT/REWORK — start a new task'); END;
+
+CREATE TRIGGER IF NOT EXISTS guard_delegated BEFORE INSERT ON events
+WHEN NEW.type = 'Delegated'
+ AND coalesce((SELECT status FROM tasks WHERE task_id = NEW.task_id), 'NONE') NOT IN ('DRAFT', 'REWORK')
+BEGIN SELECT RAISE(ABORT, 'Delegated allowed only from DRAFT/REWORK'); END;
+
+CREATE TRIGGER IF NOT EXISTS guard_report BEFORE INSERT ON events
+WHEN NEW.type = 'ReportSubmitted'
+ AND coalesce((SELECT status FROM tasks WHERE task_id = NEW.task_id), 'NONE') <> 'DELEGATED'
+BEGIN SELECT RAISE(ABORT, 'ReportSubmitted allowed only from DELEGATED'); END;
+
+CREATE TRIGGER IF NOT EXISTS guard_accept_rework BEFORE INSERT ON events
+WHEN NEW.type IN ('Accepted', 'ReworkRequested')
+ AND coalesce((SELECT status FROM tasks WHERE task_id = NEW.task_id), 'NONE') <> 'REPORTED'
+BEGIN SELECT RAISE(ABORT, 'Accepted/ReworkRequested allowed only from REPORTED'); END;
+
+CREATE TRIGGER IF NOT EXISTS guard_failed BEFORE INSERT ON events
+WHEN NEW.type = 'Failed'
+ AND coalesce((SELECT status FROM tasks WHERE task_id = NEW.task_id), 'NONE') NOT IN ('DELEGATED', 'REPORTED', 'REWORK')
+BEGIN SELECT RAISE(ABORT, 'Failed allowed only from DELEGATED/REPORTED/REWORK'); END;
+
+CREATE TRIGGER IF NOT EXISTS guard_link BEFORE INSERT ON events
+WHEN NEW.type = 'TaskLinked'
+ AND (NOT EXISTS (SELECT 1 FROM tasks WHERE task_id = NEW.task_id)
+      OR NOT EXISTS (SELECT 1 FROM tasks WHERE task_id = json_extract(NEW.payload, '$.to_task_id'))
+      OR json_extract(NEW.payload, '$.to_task_id') = NEW.task_id)
+BEGIN SELECT RAISE(ABORT, 'link endpoints must be distinct existing tasks'); END;
+
+-- ============ проекции ============
+
+CREATE TABLE IF NOT EXISTS tasks (
+    task_id       TEXT PRIMARY KEY,
+    project       TEXT,
+    title         TEXT,
+    task_text     TEXT,
+    report_text   TEXT,
+    status        TEXT,  -- DRAFT / DELEGATED / REPORTED / ACCEPTED / REWORK / FAILED
+    outcome       TEXT,  -- accepted / reworked / failed
+    verify_commit TEXT,
+    executor      TEXT,
+    created_at    TEXT,
+    updated_at    TEXT
+);
+
+CREATE TABLE IF NOT EXISTS incidents (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    task_id     TEXT,
+    description TEXT,
+    lesson      TEXT,
+    at          TEXT
+);
+
+-- Реестр проектов: имя = неймспейс задач, root_path = привязка к папке на диске,
+-- planado_workspace_id = маппинг на пространство planado (задачи/артефакты/доки
+-- наследуют workspace через проект). Перерегистрация = обновление.
+CREATE TABLE IF NOT EXISTS projects (
+    name                 TEXT PRIMARY KEY,
+    root_path            TEXT,
+    planado_workspace_id TEXT,
+    at                   TEXT
+);
+
+-- Связи задач: направленные, from → to. continues = «from продолжает to».
+CREATE TABLE IF NOT EXISTS task_links (
+    id        INTEGER PRIMARY KEY AUTOINCREMENT,
+    from_task TEXT NOT NULL,
+    to_task   TEXT NOT NULL,
+    kind      TEXT CHECK (kind IN ('continues', 'relates', 'blocks', 'discovered_from')),
+    at        TEXT,
+    UNIQUE (from_task, to_task, kind)
+);
+
+-- Артефакты: спеки, планы, ADR, решения, заметки. Append-only версии:
+-- повторная запись с тем же (project, kind, title) — новая версия, старая остаётся.
+-- Маппинг на planado: spec/plan → Documentation, adr → Adr, note/decision → Thought.
+CREATE TABLE IF NOT EXISTS artifacts (
+    id      INTEGER PRIMARY KEY AUTOINCREMENT,
+    task_id TEXT,   -- опциональная привязка к задаче
+    project TEXT,
+    kind    TEXT CHECK (kind IN ('spec', 'plan', 'adr', 'decision', 'note', 'doc')),
+    title   TEXT,
+    body    TEXT,
+    at      TEXT
+);
+
+-- ============ применение событий ============
+
+CREATE TRIGGER IF NOT EXISTS evt_task_drafted AFTER INSERT ON events
+WHEN NEW.type = 'TaskDrafted'
+BEGIN
+    INSERT INTO tasks(task_id, project, title, task_text, status, created_at, updated_at)
+    VALUES (NEW.task_id,
+            json_extract(NEW.payload, '$.project'),
+            json_extract(NEW.payload, '$.title'),
+            json_extract(NEW.payload, '$.task_text'),
+            'DRAFT', NEW.at, NEW.at)
+    ON CONFLICT(task_id) DO UPDATE SET
+        title      = excluded.title,
+        task_text  = excluded.task_text,
+        updated_at = NEW.at;
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_delegated AFTER INSERT ON events
+WHEN NEW.type = 'Delegated'
+BEGIN
+    UPDATE tasks SET status = 'DELEGATED',
+                     executor = json_extract(NEW.payload, '$.executor'),
+                     updated_at = NEW.at
+    WHERE task_id = NEW.task_id;
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_report_submitted AFTER INSERT ON events
+WHEN NEW.type = 'ReportSubmitted'
+BEGIN
+    UPDATE tasks SET status = 'REPORTED',
+                     report_text = json_extract(NEW.payload, '$.report'),
+                     updated_at = NEW.at
+    WHERE task_id = NEW.task_id;
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_accepted AFTER INSERT ON events
+WHEN NEW.type = 'Accepted'
+BEGIN
+    UPDATE tasks SET status = 'ACCEPTED',
+                     outcome = coalesce(json_extract(NEW.payload, '$.outcome'), 'accepted'),
+                     verify_commit = json_extract(NEW.payload, '$.verify_commit'),
+                     updated_at = NEW.at
+    WHERE task_id = NEW.task_id;
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_rework_requested AFTER INSERT ON events
+WHEN NEW.type = 'ReworkRequested'
+BEGIN
+    UPDATE tasks SET status = 'REWORK', updated_at = NEW.at
+    WHERE task_id = NEW.task_id;
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_failed AFTER INSERT ON events
+WHEN NEW.type = 'Failed'
+BEGIN
+    UPDATE tasks SET status = 'FAILED',
+                     outcome = 'failed',
+                     updated_at = NEW.at
+    WHERE task_id = NEW.task_id;
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_incident_recorded AFTER INSERT ON events
+WHEN NEW.type = 'IncidentRecorded'
+BEGIN
+    INSERT INTO incidents(task_id, description, lesson, at)
+    VALUES (NEW.task_id,
+            json_extract(NEW.payload, '$.description'),
+            json_extract(NEW.payload, '$.lesson'),
+            NEW.at);
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_project_registered AFTER INSERT ON events
+WHEN NEW.type = 'ProjectRegistered'
+BEGIN
+    INSERT INTO projects(name, root_path, planado_workspace_id, at)
+    VALUES (json_extract(NEW.payload, '$.name'),
+            json_extract(NEW.payload, '$.root_path'),
+            json_extract(NEW.payload, '$.planado_workspace_id'),
+            NEW.at)
+    ON CONFLICT(name) DO UPDATE SET
+        root_path            = excluded.root_path,
+        planado_workspace_id = coalesce(excluded.planado_workspace_id, planado_workspace_id),
+        at                   = NEW.at;
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_task_linked AFTER INSERT ON events
+WHEN NEW.type = 'TaskLinked'
+BEGIN
+    INSERT OR IGNORE INTO task_links(from_task, to_task, kind, at)
+    VALUES (NEW.task_id,
+            json_extract(NEW.payload, '$.to_task_id'),
+            json_extract(NEW.payload, '$.kind'),
+            NEW.at);
+END;
+
+CREATE TRIGGER IF NOT EXISTS evt_artifact_recorded AFTER INSERT ON events
+WHEN NEW.type = 'ArtifactRecorded'
+BEGIN
+    INSERT INTO artifacts(task_id, project, kind, title, body, at)
+    VALUES (CASE WHEN NEW.task_id = '_general' THEN NULL ELSE NEW.task_id END,
+            json_extract(NEW.payload, '$.project'),
+            json_extract(NEW.payload, '$.kind'),
+            json_extract(NEW.payload, '$.title'),
+            json_extract(NEW.payload, '$.body'),
+            NEW.at);
+END;
+
+-- ============ полнотекстовый поиск ============
+
+CREATE VIRTUAL TABLE IF NOT EXISTS task_fts USING fts5(
+    title, task_text, report_text,
+    content = 'tasks', content_rowid = 'rowid'
+);
+
+CREATE TRIGGER IF NOT EXISTS tasks_fts_insert AFTER INSERT ON tasks
+BEGIN
+    INSERT INTO task_fts(rowid, title, task_text, report_text)
+    VALUES (NEW.rowid, NEW.title, NEW.task_text, NEW.report_text);
+END;
+
+CREATE TRIGGER IF NOT EXISTS tasks_fts_update AFTER UPDATE ON tasks
+BEGIN
+    INSERT INTO task_fts(task_fts, rowid, title, task_text, report_text)
+    VALUES ('delete', OLD.rowid, OLD.title, OLD.task_text, OLD.report_text);
+    INSERT INTO task_fts(rowid, title, task_text, report_text)
+    VALUES (NEW.rowid, NEW.title, NEW.task_text, NEW.report_text);
+END;
+
+CREATE VIRTUAL TABLE IF NOT EXISTS artifact_fts USING fts5(
+    title, body,
+    content = 'artifacts', content_rowid = 'id'
+);
+
+CREATE TRIGGER IF NOT EXISTS artifacts_fts_insert AFTER INSERT ON artifacts
+BEGIN
+    INSERT INTO artifact_fts(rowid, title, body)
+    VALUES (NEW.id, NEW.title, NEW.body);
+END;