@revisium/orchestrator 0.0.0

package/dist/host/ensure-revisium.js

@@ -0,0 +1,269 @@
+/**
+ * ensureRevisium() — shared auto-start helper (Round 3).
+ *
+ * Models three distinct states (F7):
+ *   1. HEALTHY     → no-op, return proven runtime.
+ *   2. NO LIVE DAEMON (null runtime or dead pid) → fresh detached spawn + wait.
+ *   3. ALIVE BUT UNHEALTHY → bounded re-poll, then throw (never orphan a live process).
+ *
+ * Called by BOTH `revisium start` command and host bootstrap (DRY extraction, F9).
+ *
+ * TOCTOU / compare-and-delete (F16, F19, F21):
+ *   In state 2 we re-classify IMMEDIATELY before any removal. decideRuntimeAction()
+ *   returns a RuntimeDecision that encodes BOTH the action AND shouldRemove — so the
+ *   identity rule (only remove when the recheck still matches the stale snapshot by pid
+ *   AND startedAt) lives in one tested place and the caller cannot drift from it (F21).
+ *
+ *   The same removeRuntimeIfMatches() helper is shared by the state-2 pre-spawn cleanup
+ *   AND the spawn-timeout cleanup (F19), so neither path can accidentally delete a runtime
+ *   that belongs to a concurrently-started daemon.
+ *
+ * Known limitation — concurrent cold-start (deferred per ТЗ §3.3.5, slice 0001):
+ *   Two host processes starting with no live daemon in the same narrow window can still
+ *   race to spawn — the compare-and-delete re-check narrows the orphan window but does
+ *   NOT serialize spawns. Full cross-process file-locking is intentionally deferred to a
+ *   future slice. The practical guard is the re-check plus the fact that the host path
+ *   only runs for explicit dev:* invocations.
+ */
+import { spawn } from 'node:child_process';
+import { closeSync, existsSync, openSync, readFileSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { baseUrl, findFreePort, getConfig, healthUrl, isAlive, isHealthy, readRuntime, removeRuntime, } from '../cli/config.js';
+import { killTree, parsePort, tailLines, waitForExit, waitHealthy, } from '../cli/commands/revisium-helpers.js';
+const require = createRequire(import.meta.url);
+/** Default cold-start timeout in ms (120 s — matches the existing waitHealthy default). */
+const DEFAULT_TIMEOUT_MS = 120_000;
+/** Default re-poll budget for the alive-but-unhealthy case (consensus MINOR, round 4). */
+const DEFAULT_RECHECK_MS = 20_000;
+/**
+ * Remove runtime.json ONLY if the current file on disk still matches the given snapshot
+ * (same pid AND startedAt). Shared by the state-2 pre-spawn path and the spawn-timeout
+ * cleanup path (F19 / F21 DRY) so neither can accidentally delete a runtime that belongs
+ * to a concurrently-started daemon.
+ *
+ * If the file has been replaced (different identity) or already removed (null), this is a
+ * safe no-op — the file either belongs to another process or was already cleaned up.
+ *
+ * Exported (@internal) for unit testing; production callers should use only the internal
+ * call sites (state-2 pre-spawn cleanup and spawn-timeout cleanup).
+ */
+export function removeRuntimeIfMatches(snapshot) {
+    const current = readRuntime();
+    if (current?.pid === snapshot.pid && current?.startedAt === snapshot.startedAt) {
+        removeRuntime();
+    }
+}
+/**
+ * Decide what action to take in state 2 ("no live daemon" from initial classification)
+ * given the stale snapshot and an immediate re-read immediately before any removal.
+ *
+ * Pure function (no side effects, no I/O) — unit-testable in isolation (F18 / F16 / F21).
+ *
+ * Compare-and-delete contract (F16, F21):
+ *   - shouldRemove is true ONLY when the re-read runtime STILL matches the stale snapshot
+ *     (same pid AND startedAt). This prevents deleting a live runtime written concurrently
+ *     BETWEEN our initial dead-pid read and this re-check.
+ *   - If the re-check shows a DIFFERENT (or new) live pid, the action routes into alive
+ *     paths ('return-running' or 'repoll') and shouldRemove is always false.
+ *
+ * @param stalePidSnapshot - The RuntimeState we observed initially (dead pid), or null.
+ * @param recheck          - The result of readRuntime() immediately before removal.
+ * @param recheckAlive     - Whether recheck.pid is alive (ignored when recheck is null).
+ * @param recheckHealthy   - Whether recheck daemon is healthy (ignored when recheck is null).
+ */
+export function decideRuntimeAction(stalePidSnapshot, recheck, recheckAlive, recheckHealthy) {
+    if (recheck && recheckAlive) {
+        // A concurrent process wrote a live runtime — do NOT delete or spawn over it.
+        if (recheckHealthy)
+            return { action: 'return-running', shouldRemove: false };
+        return { action: 'repoll', shouldRemove: false };
+    }
+    // No live runtime after re-read. Determine whether we may remove the stale file.
+    if (stalePidSnapshot !== null) {
+        // Compare-and-delete identity check (F21): only set shouldRemove=true when the
+        // recheck runtime STILL matches the stale snapshot (same pid AND startedAt).
+        // - recheck null → file already cleaned up by another process; skip remove but proceed.
+        // - recheck present but different identity → new stale entry from a different past run;
+        //   our snapshot doesn't own it — leave it for its owner.
+        const matchesSnapshot = recheck !== null &&
+            recheck.pid === stalePidSnapshot.pid &&
+            recheck.startedAt === stalePidSnapshot.startedAt;
+        return { action: 'remove-and-spawn', shouldRemove: matchesSnapshot };
+    }
+    return { action: 'spawn', shouldRemove: false };
+}
+/**
+ * Classify the daemon state given a snapshot of: the runtime file, whether the
+ * recorded pid is alive, and whether the daemon responds to health checks.
+ *
+ * Pure function (no side effects, no I/O) — unit-testable in isolation (F15).
+ *
+ * - 'healthy'       → pid alive AND health check passed.
+ * - 'alive-unhealthy' → pid alive BUT health check failed (never spawn a second daemon).
+ * - 'no-live-daemon'  → no runtime.json OR recorded pid is dead (safe to spawn fresh).
+ *
+ * Note: the alive-unhealthy case intentionally includes a concurrent-start scenario
+ * where the runtime was written but the daemon is mid-startup (F11): returning
+ * 'alive-unhealthy' rather than 'no-live-daemon' routes callers into the bounded
+ * re-poll path instead of unconditionally spawning a second daemon.
+ */
+export function classifyRuntimeState(rt, alive, healthy) {
+    if (!rt || !alive)
+        return 'no-live-daemon';
+    if (healthy)
+        return 'healthy';
+    return 'alive-unhealthy';
+}
+/**
+ * Handle state 3: alive-but-unhealthy daemon.
+ *
+ * Performs a bounded re-poll. Returns `{alreadyRunning:true}` if the daemon becomes
+ * healthy within `recheckMs`. Throws with an actionable message otherwise — never
+ * removes runtime.json, never spawns (would orphan a live process).
+ */
+async function handleAliveUnhealthy(rt, recheckMs) {
+    const becameHealthy = await waitHealthy(healthUrl(rt.httpPort), recheckMs);
+    if (becameHealthy) {
+        const freshRt = readRuntime();
+        if (!freshRt)
+            throw new Error('runtime.json disappeared during re-poll');
+        return { runtime: freshRt, alreadyRunning: true };
+    }
+    throw new Error(`Revisium (pid ${rt.pid}) is running but unhealthy — run \`revo revisium stop\` and retry`);
+}
+/**
+ * Perform the "re-poll" branch of state 2: a concurrent start wrote a live-but-unhealthy
+ * runtime — poll for late-up rather than spawning a second daemon.
+ */
+async function recheckRepoll(rtRecheck, recheckMs) {
+    const becameHealthy = await waitHealthy(healthUrl(rtRecheck.httpPort), recheckMs);
+    if (becameHealthy) {
+        const freshRt = readRuntime();
+        if (!freshRt)
+            throw new Error('runtime.json disappeared during recheck re-poll');
+        return { runtime: freshRt, alreadyRunning: true };
+    }
+    throw new Error(`Revisium (pid ${rtRecheck.pid}) is running but unhealthy — run \`revo revisium stop\` and retry`);
+}
+/**
+ * Spawn the standalone daemon (detached + unref'd) and wait for health.
+ *
+ * Writes extended runtime.json (F8: includes dataDir). On health timeout, kills the
+ * spawned child, removes its runtime.json (compare-and-delete — F19), and throws.
+ *
+ * @returns EnsureResult from the freshly-written runtime.json (F3: pid-proven ports).
+ */
+async function startAndWaitForHealth(cfg, timeoutMs) {
+    const { httpPort, pgPort, dataDir, logFile, runtimeFile } = cfg;
+    const entry = require.resolve('@revisium/standalone/bin/revisium-standalone.js');
+    const out = openSync(logFile, 'a');
+    const child = spawn(process.execPath, [entry, '--port', String(httpPort), '--pg-port', String(pgPort), '--data', dataDir], { detached: true, stdio: ['ignore', out, out] });
+    closeSync(out);
+    if (!child.pid) {
+        throw new Error('Failed to start standalone Revisium: spawn returned no pid');
+    }
+    child.unref(); // detached — daemon outlives this process
+    // Capture the exact identity of the runtime WE just wrote (F19).
+    const spawnStartedAt = new Date().toISOString();
+    writeFileSync(runtimeFile, JSON.stringify({ httpPort, pgPort, pid: child.pid, startedAt: spawnStartedAt, dataDir }, null, 2));
+    const spawnSnapshot = { pid: child.pid, startedAt: spawnStartedAt };
+    const spawnHealthy = await waitHealthy(healthUrl(httpPort), timeoutMs);
+    if (!spawnHealthy) {
+        // F19: Only removeRuntime() when the file still identifies OUR child (compare-and-delete).
+        const logTail = tailLines(logFile, 20);
+        killTree(child.pid, 'SIGTERM');
+        await waitForExit(child.pid, 20_000);
+        if (isAlive(child.pid))
+            killTree(child.pid, 'SIGKILL');
+        removeRuntimeIfMatches(spawnSnapshot);
+        throw new Error(`Revisium did not become healthy on ${baseUrl(httpPort)} within ${timeoutMs / 1000}s` +
+            ` — see \`revo revisium logs\`\n${logTail}`);
+    }
+    // Re-read the freshly-written runtime.json (F3: pid-proven ports).
+    const written = readRuntime();
+    if (!written)
+        throw new Error('runtime.json disappeared after successful start');
+    return { runtime: written, alreadyRunning: false };
+}
+/**
+ * Ensure the Revisium standalone daemon is running and healthy.
+ *
+ * Three-state logic (F7):
+ *   - State 1: recorded pid alive + healthy → return immediately (alreadyRunning = true).
+ *   - State 2: no runtime.json OR recorded pid is dead → removeRuntime if stale, spawn fresh.
+ *   - State 3: recorded pid alive but unhealthy → bounded re-poll (recheckMs), then THROW
+ *     (never removeRuntime, never spawn — leaves the live process for `revo revisium stop`).
+ *
+ * @returns EnsureResult with the pid-proven runtime (fresh or existing).
+ * @throws if the daemon is alive-but-unhealthy after re-poll, or if spawn times out.
+ */
+export async function ensureRevisium(options = {}) {
+    const { timeoutMs = DEFAULT_TIMEOUT_MS, recheckMs = DEFAULT_RECHECK_MS } = options;
+    const config = getConfig();
+    const rt = readRuntime();
+    const alive = rt ? isAlive(rt.pid) : false;
+    const healthy = rt && alive ? await isHealthy(rt.httpPort) : false;
+    const stateClass = classifyRuntimeState(rt, alive, healthy);
+    // ── State 1: healthy ──────────────────────────────────────────────────────
+    if (stateClass === 'healthy') {
+        return { runtime: rt, alreadyRunning: true };
+    }
+    // ── State 3: alive but unhealthy ─────────────────────────────────────────
+    if (stateClass === 'alive-unhealthy') {
+        return handleAliveUnhealthy(rt, recheckMs);
+    }
+    // ── State 2: no live daemon ───────────────────────────────────────────────
+    //
+    // F16 / F21 compare-and-delete: re-classify IMMEDIATELY before any removal.
+    // decideRuntimeAction() encodes both the action AND shouldRemove so the identity
+    // check lives in one tested pure function (F21).
+    const rtRecheck = readRuntime();
+    const recheckAlive = rtRecheck ? isAlive(rtRecheck.pid) : false;
+    const recheckHealthy = rtRecheck && recheckAlive ? await isHealthy(rtRecheck.httpPort) : false;
+    const decision = decideRuntimeAction(rt, rtRecheck, recheckAlive, recheckHealthy);
+    if (decision.action === 'return-running') {
+        return { runtime: rtRecheck, alreadyRunning: true };
+    }
+    if (decision.action === 'repoll') {
+        return recheckRepoll(rtRecheck, recheckMs);
+    }
+    // action === 'remove-and-spawn' or 'spawn'
+    // F22: removeRuntimeIfMatches re-reads and checks identity AT DELETE TIME.
+    if (decision.shouldRemove)
+        removeRuntimeIfMatches(rtRecheck);
+    const httpPort = await findFreePort(parsePort(options.port, config.preferredPort));
+    // CR5: Two independent findFreePort calls can return the same port when their search
+    // bases overlap. If they collide, re-pick pgPort from httpPort+1 to guarantee distinct ports.
+    let pgPort = await findFreePort(parsePort(options.pgPort, config.preferredPgPort));
+    if (pgPort === httpPort) {
+        pgPort = await findFreePort(httpPort + 1);
+    }
+    const dataDir = options.data ?? config.dataDir;
+    return startAndWaitForHealth({ httpPort, pgPort, dataDir, logFile: config.logFile, runtimeFile: config.runtimeFile }, timeoutMs);
+}
+/** Maximum valid TCP port number (inclusive). */
+const MAX_TCP_PORT = 65535;
+/**
+ * Read the postmaster.pid file to cross-check the pg port from runtime.json (F3).
+ * Returns the pg port if found, or null if the file is absent (older standalone layout).
+ *
+ * CR6: Valid port range is 1–65535 (inclusive). Out-of-range values (e.g. 70000) return null.
+ */
+export function readPostmasterPgPort(dataDir) {
+    const postmasterPid = `${dataDir}/pgdata/postmaster.pid`;
+    if (!existsSync(postmasterPid))
+        return null;
+    try {
+        const lines = readFileSync(postmasterPid, 'utf8').split(/\r?\n/);
+        // Line 4 (index 3) is the pg port according to the PostgreSQL postmaster.pid format.
+        const portStr = lines[3]?.trim();
+        if (!portStr)
+            return null;
+        const port = Number(portStr);
+        return Number.isInteger(port) && port > 0 && port <= MAX_TCP_PORT ? port : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ensure-revisium.js.map

package/dist/host/ensure-revisium.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-revisium.js","sourceRoot":"","sources":["../../src/host/ensure-revisium.ts"],"names":[],"mappings":"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"}

package/dist/host/host.lifecycle.js

@@ -0,0 +1,75 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+/**
+ * HostLifecycle — OnApplicationBootstrap / OnApplicationShutdown.
+ *
+ * Boot order (§2 of the ТЗ):
+ *   1. ensureRevisium() — auto-start if no live daemon; three-state (F7).
+ *   2. Pid-proven pg port from the returned runtime (never resolvePorts() — F3).
+ *   3. Optional postmaster.pid cross-check (F8).
+ *   4. ensurePostgres(provenPgPort) — CREATE DATABASE dbos if absent.
+ *   5. dbosService.setConfig(url) + dbosService.launch().
+ *
+ * Shutdown:
+ *   - DBOS.shutdown() only.
+ *   - INTENTIONALLY does NOT stop the Revisium daemon (Round 3, human decision):
+ *     the daemon is detached+unref'd and is a shared, long-lived process; subsequent
+ *     `revo dev:status <id>` invocations must find the same daemon + embedded Postgres.
+ */
+import { Injectable } from '@nestjs/common';
+import { DbosService } from '../engine/dbos.service.js';
+import { ensureRevisium, readPostmasterPgPort } from './ensure-revisium.js';
+import { dbosSystemDatabaseUrl, ensurePostgres } from '../engine/ensure-postgres.js';
+function isMcpStdioHost() {
+    return process.env.REVO_MCP_STDIO === '1';
+}
+let HostLifecycle = class HostLifecycle {
+    dbosService;
+    constructor(dbosService) {
+        this.dbosService = dbosService;
+    }
+    async onApplicationBootstrap() {
+        // Step 1: Ensure Revisium daemon is running (auto-start if absent).
+        const { runtime } = await ensureRevisium();
+        // Step 2: Pid-proven pg port (F3 — never resolvePorts()).
+        let provenPgPort = runtime.pgPort;
+        // Optional cross-check against postmaster.pid (F8).
+        if (runtime.dataDir) {
+            const pmPort = readPostmasterPgPort(runtime.dataDir);
+            if (pmPort !== null && pmPort !== runtime.pgPort) {
+                throw new Error(`Stale runtime.json: runtime.pgPort=${runtime.pgPort} but postmaster.pid reports port=${pmPort}. ` +
+                    'Restart Revisium: revo revisium stop && revo revisium start');
+            }
+            if (pmPort !== null) {
+                provenPgPort = pmPort;
+            }
+        }
+        // If runtime.dataDir is absent (older standalone), skip cross-check and rely on rt.pgPort.
+        // Step 3: Ensure the `dbos` database exists.
+        await ensurePostgres(provenPgPort);
+        // Step 4+5: Configure + launch DBOS.
+        this.dbosService.setConfig(dbosSystemDatabaseUrl(provenPgPort), {
+            logLevel: isMcpStdioHost() ? 'warn' : undefined,
+        });
+        await this.dbosService.launch();
+    }
+    async onApplicationShutdown() {
+        // Intentional: host does not own the Revisium daemon lifecycle.
+        // Only DBOS.shutdown() runs on exit.
+        // The daemon was spawned detached+unref'd and must outlive the host process.
+        await this.dbosService.shutdown();
+    }
+};
+HostLifecycle = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [DbosService])
+], HostLifecycle);
+export { HostLifecycle };
+//# sourceMappingURL=host.lifecycle.js.map

package/dist/host/host.lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.lifecycle.js","sourceRoot":"","sources":["../../src/host/host.lifecycle.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAiD,MAAM,gBAAgB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAErF,SAAS,cAAc;IACrB,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,GAAG,CAAC;AAC5C,CAAC;AAGM,IAAM,aAAa,GAAnB,MAAM,aAAa;IACK;IAA7B,YAA6B,WAAwB;QAAxB,gBAAW,GAAX,WAAW,CAAa;IAAG,CAAC;IAEzD,KAAK,CAAC,sBAAsB;QAC1B,oEAAoE;QACpE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;QAE3C,0DAA0D;QAC1D,IAAI,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;QAElC,oDAAoD;QACpD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACrD,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CACb,sCAAsC,OAAO,CAAC,MAAM,oCAAoC,MAAM,IAAI;oBAChG,6DAA6D,CAChE,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,YAAY,GAAG,MAAM,CAAC;YACxB,CAAC;QACH,CAAC;QACD,2FAA2F;QAE3F,6CAA6C;QAC7C,MAAM,cAAc,CAAC,YAAY,CAAC,CAAC;QAEnC,qCAAqC;QACrC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,qBAAqB,CAAC,YAAY,CAAC,EAAE;YAC9D,QAAQ,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;SAChD,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,qBAAqB;QACzB,gEAAgE;QAChE,qCAAqC;QACrC,6EAA6E;QAC7E,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;IACpC,CAAC;CACF,CAAA;AAzCY,aAAa;IADzB,UAAU,EAAE;qCAE+B,WAAW;GAD1C,aAAa,CAyCzB"}

package/dist/mcp/mcp-capabilities.js

@@ -0,0 +1,47 @@
+export const MCP_TOOL_NAMES = [
+    'get_status',
+    'doctor',
+    'get_capabilities',
+    'validate_repository',
+    'get_repository_context',
+    'get_project',
+    'create_run',
+    'start_run',
+    'resume_run',
+    'cancel_run',
+    'list_runs',
+    'get_run',
+    'get_run_events',
+    'get_run_log',
+    'get_run_digest',
+    'list_inbox',
+    'get_inbox_item',
+    'get_pending_decisions',
+    'approve_gate',
+    'reject_gate',
+    'answer_question',
+    'resolve_inbox_item',
+    'summarize_gate_risk',
+    'install_playbook',
+    'list_playbooks',
+    'list_roles',
+    'get_role',
+    'list_pipelines',
+    'get_pipeline',
+    'simulate_route',
+    'get_pr_readiness',
+    'list_pr_feedback',
+];
+export const MCP_INSTRUCTIONS = `Revo is a local-first software-development task orchestrator.
+
+Use these tools to manage tasks end-to-end from your coding agent:
+- create and start runs;
+- inspect run status, events, attempts, and digests;
+- resolve human inbox gates and questions;
+- inspect installed playbooks, roles, and pipelines;
+- inspect PR readiness and actionable review feedback before resuming work;
+- validate repository context before starting live work.
+
+This MCP server is local stdio only and does not expose generic Revisium table CRUD.
+Use product-level tools instead of writing raw rows.`;
+//# sourceMappingURL=mcp-capabilities.js.map

package/dist/mcp/mcp-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-capabilities.js","sourceRoot":"","sources":["../../src/mcp/mcp-capabilities.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,YAAY;IACZ,QAAQ;IACR,kBAAkB;IAClB,qBAAqB;IACrB,wBAAwB;IACxB,aAAa;IACb,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,SAAS;IACT,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,YAAY;IACZ,gBAAgB;IAChB,uBAAuB;IACvB,cAAc;IACd,aAAa;IACb,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,kBAAkB;IAClB,gBAAgB;IAChB,YAAY;IACZ,UAAU;IACV,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,kBAAkB;IAClB,kBAAkB;CACV,CAAC;AAIX,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;qDAWqB,CAAC"}

package/dist/mcp/mcp-facade.service.js

@@ -0,0 +1,130 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Injectable } from '@nestjs/common';
+import { TaskControlPlaneApiService, } from '../task-control-plane/task-control-plane-api.service.js';
+import { MCP_TOOL_NAMES } from './mcp-capabilities.js';
+let McpFacadeService = class McpFacadeService {
+    api;
+    constructor(api) {
+        this.api = api;
+    }
+    getCapabilities() {
+        return {
+            transport: 'stdio',
+            auth: 'none',
+            tools: [...MCP_TOOL_NAMES],
+            runnerModes: ['script', 'live'],
+            notes: [
+                'Local stdio MCP server; no remote HTTP listener.',
+                'Tools expose product operations, not generic Revisium row CRUD.',
+                'Live runs use the real Claude runner and git/GitHub integrator.',
+            ],
+        };
+    }
+    getStatus() {
+        return this.api.getStatus();
+    }
+    doctor() {
+        return this.api.doctor();
+    }
+    getProject() {
+        return this.api.getProject();
+    }
+    validateRepository(input) {
+        return this.api.validateRepository(input);
+    }
+    getRepositoryContext(input) {
+        return this.api.getRepositoryContext(input);
+    }
+    createRun(input) {
+        return this.api.createRun(input);
+    }
+    startRun(input) {
+        return this.api.startRun(input);
+    }
+    resumeRun(input) {
+        return this.api.resumeRun(input);
+    }
+    cancelRun(runId) {
+        return this.api.cancelRun(runId);
+    }
+    listRuns(filter) {
+        return this.api.listRuns(filter);
+    }
+    getRun(input) {
+        return this.api.getRun(input);
+    }
+    getRunEvents(input) {
+        return this.api.getRunEvents(input);
+    }
+    getRunLog(input) {
+        return this.api.getRunLog(input);
+    }
+    getRunDigest(runId) {
+        return this.api.getRunDigest(runId);
+    }
+    listInbox(filter) {
+        return this.api.listInbox(filter);
+    }
+    getInboxItem(inboxId) {
+        return this.api.getInboxItem(inboxId);
+    }
+    getPendingDecisions(runId) {
+        return this.api.getPendingDecisions(runId);
+    }
+    approveGate(input) {
+        return this.api.approveGate(input);
+    }
+    rejectGate(input) {
+        return this.api.rejectGate(input);
+    }
+    answerQuestion(input) {
+        return this.api.answerQuestion(input);
+    }
+    resolveInboxItem(input) {
+        return this.api.resolveInboxItem(input);
+    }
+    summarizeGateRisk(inboxId) {
+        return this.api.summarizeGateRisk(inboxId);
+    }
+    installPlaybook(input) {
+        return this.api.installPlaybook(input);
+    }
+    listPlaybooks() {
+        return this.api.listPlaybooks();
+    }
+    listRoles() {
+        return this.api.listRoles();
+    }
+    getRole(roleId) {
+        return this.api.getRole(roleId);
+    }
+    listPipelines() {
+        return this.api.listPipelines();
+    }
+    getPipeline(pipelineId) {
+        return this.api.getPipeline(pipelineId);
+    }
+    simulateRoute(input) {
+        return this.api.simulateRoute(input);
+    }
+    getPrReadiness(input) {
+        return this.api.getPrReadiness(input);
+    }
+    listPrFeedback(input) {
+        return this.api.listPrFeedback(input);
+    }
+};
+McpFacadeService = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [TaskControlPlaneApiService])
+], McpFacadeService);
+export { McpFacadeService };
+//# sourceMappingURL=mcp-facade.service.js.map

package/dist/mcp/mcp-facade.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-facade.service.js","sourceRoot":"","sources":["../../src/mcp/mcp-facade.service.ts"],"names":[],"mappings":"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"}

package/dist/mcp/mcp-stdio.service.js

@@ -0,0 +1,48 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Injectable } from '@nestjs/common';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readPackageVersion } from '../package-info.js';
+import { MCP_INSTRUCTIONS } from './mcp-capabilities.js';
+import { McpFacadeService } from './mcp-facade.service.js';
+import { registerRevoMcpTools } from './mcp-tools.js';
+let McpStdioService = class McpStdioService {
+    facade;
+    constructor(facade) {
+        this.facade = facade;
+    }
+    async start() {
+        const server = new McpServer({ name: 'revo', version: readPackageVersion() }, { instructions: MCP_INSTRUCTIONS });
+        registerRevoMcpTools(server, this.facade);
+        const transport = new StdioServerTransport();
+        const closed = new Promise((resolve, reject) => {
+            transport.onclose = () => resolve();
+            transport.onerror = (error) => reject(error);
+            process.stdin.once('end', resolve);
+            process.stdin.once('close', resolve);
+            process.once('SIGINT', resolve);
+            process.once('SIGTERM', resolve);
+        });
+        try {
+            await server.connect(transport);
+            await closed;
+        }
+        finally {
+            await server.close().catch(() => undefined);
+        }
+    }
+};
+McpStdioService = __decorate([
+    Injectable(),
+    __metadata("design:paramtypes", [McpFacadeService])
+], McpStdioService);
+export { McpStdioService };
+//# sourceMappingURL=mcp-stdio.service.js.map

package/dist/mcp/mcp-stdio.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-stdio.service.js","sourceRoot":"","sources":["../../src/mcp/mcp-stdio.service.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAG/C,IAAM,eAAe,GAArB,MAAM,eAAe;IACG;IAA7B,YAA6B,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEzD,KAAK,CAAC,KAAK;QACT,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAC/C,EAAE,YAAY,EAAE,gBAAgB,EAAE,CACnC,CAAC;QACF,oBAAoB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACnD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;YACpC,SAAS,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAChC,MAAM,MAAM,CAAC;QACf,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF,CAAA;AA3BY,eAAe;IAD3B,UAAU,EAAE;qCAE0B,gBAAgB;GAD1C,eAAe,CA2B3B"}