@eidola.app/cli 0.2.0

package/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/cli.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+const USAGE = `eidola — Eidola MCP server and Shrine display runtime
+
+Usage:
+  eidola mcp    Start MCP server (stdio)
+  eidola shrine Start Shrine HTTP server
+`;
+async function main() {
+    const subcommand = process.argv[2];
+    if (subcommand === 'mcp') {
+        const { startEidolaMcpServer } = await import('./server.js');
+        const { close } = await startEidolaMcpServer();
+        const shutdown = async (signal) => {
+            console.error('[eidola]', `${signal} received, shutting down...`);
+            await close();
+            process.exit(0);
+        };
+        process.on('SIGINT', () => void shutdown('SIGINT'));
+        process.on('SIGTERM', () => void shutdown('SIGTERM'));
+        return;
+    }
+    if (subcommand === 'shrine') {
+        const shrineUrl = new URL('./shrine/server/index.js', import.meta.url).href;
+        const { startShrineHttpServer } = (await import(shrineUrl));
+        const server = await startShrineHttpServer();
+        const shutdown = () => {
+            server.stop();
+            process.exit(0);
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        return;
+    }
+    if (!subcommand) {
+        console.error(USAGE);
+        process.exit(1);
+    }
+    console.error(`Unknown subcommand: ${subcommand}\n${USAGE}`);
+    process.exit(1);
+}
+main().catch((error) => {
+    console.error('[eidola] failed:', error);
+    process.exit(1);
+});
+export {};
+//# sourceMappingURL=cli.js.map

package/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,MAAM,KAAK,GAAG;;;;;CAKb,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QAC7D,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,oBAAoB,EAAE,CAAC;QAE/C,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAE,EAAE;YACxC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,GAAG,MAAM,6BAA6B,CAAC,CAAC;YAClE,MAAM,KAAK,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QAC5E,MAAM,EAAE,qBAAqB,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAEzD,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;QAE7C,MAAM,QAAQ,GAAG,GAAG,EAAE;YACpB,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO;IACT,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,uBAAuB,UAAU,KAAK,KAAK,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/config.d.ts

@@ -0,0 +1,16 @@
+export interface EidolaPaths {
+    repoRoot: string;
+    engramsDir: string;
+    vesselsDir: string;
+}
+export interface EidolaRuntimeConfig extends EidolaPaths {
+    /** Cursor workspace root — where `.cursor/eidola.json` lives. Set via EIDOLA_WORKSPACE. */
+    workspaceRoot?: string;
+    stateSocketHost: string;
+    stateSocketPort: number;
+    stateBufferSize: number;
+}
+export declare function resolveEidolaPaths(env?: NodeJS.ProcessEnv): EidolaPaths;
+export declare function inferWorkspaceRoot(repoRoot: string, env?: NodeJS.ProcessEnv): string | undefined;
+export declare function resolveEidolaRuntimeConfig(env?: NodeJS.ProcessEnv): EidolaRuntimeConfig;
+//# sourceMappingURL=config.d.ts.map

package/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,2FAA2F;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,WAAW,CAgBpF;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,0BAA0B,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,mBAAmB,CAUpG"}

package/config.js

@@ -0,0 +1,62 @@
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_STATE_BUFFER_SIZE, DEFAULT_STATE_SOCKET_PORT, STATE_SOCKET_HOST, } from './socket/types.js';
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+/** packages/mcp/dist → eidola-repo root in monorepo dev */
+const defaultMonorepoRoot = resolve(moduleDir, '../../..');
+function resolvePackageRoot() {
+    return resolve(moduleDir, '..');
+}
+function isPublishedInstall() {
+    const normalized = resolvePackageRoot().replace(/\\/g, '/');
+    return normalized.includes('/node_modules/');
+}
+export function resolveEidolaPaths(env = process.env) {
+    const published = isPublishedInstall();
+    const repoRoot = resolve(env.EIDOLA_ROOT ?? (published ? process.cwd() : defaultMonorepoRoot));
+    const monorepoEngrams = join(repoRoot, 'engrams');
+    const defaultEngramsDir = env.EIDOLA_ENGRAMS_DIR === undefined && !published && existsSync(monorepoEngrams)
+        ? monorepoEngrams
+        : repoRoot;
+    return {
+        repoRoot,
+        engramsDir: resolve(env.EIDOLA_ENGRAMS_DIR ?? defaultEngramsDir),
+        vesselsDir: resolve(env.EIDOLA_VESSELS_DIR ?? joinPath(repoRoot, 'vessels')),
+    };
+}
+export function inferWorkspaceRoot(repoRoot, env = process.env) {
+    const explicit = env.EIDOLA_WORKSPACE?.trim();
+    if (explicit) {
+        return resolve(explicit);
+    }
+    if (existsSync(join(repoRoot, '.cursor', 'eidola.json'))) {
+        return repoRoot;
+    }
+    return undefined;
+}
+export function resolveEidolaRuntimeConfig(env = process.env) {
+    const paths = resolveEidolaPaths(env);
+    const workspaceRoot = inferWorkspaceRoot(paths.repoRoot, env);
+    return {
+        ...paths,
+        workspaceRoot,
+        stateSocketHost: STATE_SOCKET_HOST,
+        stateSocketPort: parsePositiveInt(env.EIDOLA_STATE_SOCKET_PORT, DEFAULT_STATE_SOCKET_PORT),
+        stateBufferSize: parsePositiveInt(env.EIDOLA_STATE_BUFFER_SIZE, DEFAULT_STATE_BUFFER_SIZE),
+    };
+}
+function parsePositiveInt(raw, fallback) {
+    if (!raw) {
+        return fallback;
+    }
+    const parsed = Number.parseInt(raw, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        return fallback;
+    }
+    return parsed;
+}
+function joinPath(base, segment) {
+    return resolve(base, segment);
+}
+//# sourceMappingURL=config.js.map

package/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,2DAA2D;AAC3D,MAAM,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAE3D,SAAS,kBAAkB;IACzB,OAAO,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC5D,OAAO,UAAU,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;AAC/C,CAAC;AAgBD,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,OAAO,CACtB,GAAG,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CACrE,CAAC;IACF,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,iBAAiB,GACrB,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI,CAAC,SAAS,IAAI,UAAU,CAAC,eAAe,CAAC;QAC/E,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,QAAQ,CAAC;IAEf,OAAO;QACL,QAAQ;QACR,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,iBAAiB,CAAC;QAChE,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;KAC7E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,MAAyB,OAAO,CAAC,GAAG;IAEpC,MAAM,QAAQ,GAAG,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAyB,OAAO,CAAC,GAAG;IAC7E,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO;QACL,GAAG,KAAK;QACR,aAAa;QACb,eAAe,EAAE,iBAAiB;QAClC,eAAe,EAAE,gBAAgB,CAAC,GAAG,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;QAC1F,eAAe,EAAE,gBAAgB,CAAC,GAAG,CAAC,wBAAwB,EAAE,yBAAyB,CAAC;KAC3F,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAuB,EAAE,QAAgB;IACjE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,OAAe;IAC7C,OAAO,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/cursor/auto-activate.d.ts

@@ -0,0 +1,16 @@
+import type { EidolaRuntimeConfig } from '../config.js';
+import type { SessionState } from '../session/state.js';
+import type { StateSocketServer } from '../socket/server.js';
+export interface AutoActivateResult {
+    activated: boolean;
+    engramId?: string;
+    alreadyActive?: boolean;
+    error?: string;
+    code?: string;
+}
+/**
+ * Load active Engram from `.cursor/eidola.json` and broadcast idle to the Shrine.
+ * Idempotent when the same Engram is already bound in session.
+ */
+export declare function autoActivateFromWorkspace(config: EidolaRuntimeConfig, session: SessionState, stateSocket: StateSocketServer | undefined, onWarn?: (message: string) => void): Promise<AutoActivateResult>;
+//# sourceMappingURL=auto-activate.d.ts.map

package/cursor/auto-activate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-activate.d.ts","sourceRoot":"","sources":["../../src/cursor/auto-activate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAaD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,iBAAiB,GAAG,SAAS,EAC1C,MAAM,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAkB,GAC9C,OAAO,CAAC,kBAAkB,CAAC,CA+D7B"}

package/cursor/auto-activate.js

@@ -0,0 +1,79 @@
+import { resolve } from 'node:path';
+import { resolveEngramDirectory } from '../engram/registry.js';
+import { EngramLoadError } from '../engram/types.js';
+import { detectSoulSource } from './soul-source.js';
+import { warnIfStaleSoulCompile } from './stale.js';
+import { cursorRulePath, readWorkspaceConfig } from './workspace-config.js';
+function resolveEngramsDir(config, workspaceConfig) {
+    if (workspaceConfig?.engrams_dir) {
+        return resolve(workspaceConfig.engrams_dir);
+    }
+    return config.engramsDir;
+}
+/**
+ * Load active Engram from `.cursor/eidola.json` and broadcast idle to the Shrine.
+ * Idempotent when the same Engram is already bound in session.
+ */
+export async function autoActivateFromWorkspace(config, session, stateSocket, onWarn = defaultWarn) {
+    const workspaceRoot = config.workspaceRoot;
+    if (!workspaceRoot) {
+        return { activated: false };
+    }
+    let workspaceConfig;
+    try {
+        workspaceConfig = await readWorkspaceConfig(workspaceRoot);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        onWarn(`failed to read workspace config: ${message}`);
+        return { activated: false, error: message, code: 'WORKSPACE_CONFIG_ERROR' };
+    }
+    if (!workspaceConfig?.active_engram_id) {
+        return { activated: false };
+    }
+    const engramId = workspaceConfig.active_engram_id;
+    const active = session.getActive();
+    if (active?.engram.id === engramId) {
+        stateSocket?.broadcastState({ state: 'idle', surface: 'manual' });
+        return { activated: true, engramId, alreadyActive: true };
+    }
+    const engramsDir = resolveEngramsDir(config, workspaceConfig);
+    let directory;
+    try {
+        directory = resolveEngramDirectory(engramsDir, engramId);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        onWarn(`auto-activate: Engram "${engramId}" not found (${message})`);
+        return { activated: false, engramId, error: message, code: 'MISSING_ENGRAM' };
+    }
+    try {
+        const soulSource = await detectSoulSource(workspaceRoot, engramId);
+        await session.load(directory, soulSource);
+        stateSocket?.broadcastState({ state: 'idle', surface: 'manual' });
+        await warnIfStaleSoulCompile({
+            engramDirectory: directory,
+            mdcPath: cursorRulePath(workspaceRoot, engramId),
+            workspaceConfig,
+        });
+        return { activated: true, engramId };
+    }
+    catch (error) {
+        if (error instanceof EngramLoadError) {
+            onWarn(`auto-activate: ${error.message}`);
+            return {
+                activated: false,
+                engramId,
+                error: error.message,
+                code: error.code,
+            };
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        onWarn(`auto-activate failed: ${message}`);
+        return { activated: false, engramId, error: message, code: 'INTERNAL_ERROR' };
+    }
+}
+function defaultWarn(message) {
+    console.error('[eidola-mcp]', message);
+}
+//# sourceMappingURL=auto-activate.js.map

package/cursor/auto-activate.js.map

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

package/cursor/compile.d.ts

@@ -0,0 +1,13 @@
+import type { LoadedEngram } from '../engram/types.js';
+import type { CompiledCursorRule } from './types.js';
+/** Split compiled `.mdc` into frontmatter block and Soul body. */
+export declare function parseCompiledCursorRule(content: string): {
+    frontmatter: string;
+    body: string;
+};
+/**
+ * Compile Engram Soul prose into a Cursor always-on rule (`.mdc`).
+ * Body is SOUL.md verbatim — no YAML or frontmatter leakage into Soul prose.
+ */
+export declare function compileSoulToCursorRule(engram: LoadedEngram): CompiledCursorRule;
+//# sourceMappingURL=compile.d.ts.map

package/cursor/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/cursor/compile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmBrD,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAe9F;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,YAAY,GAAG,kBAAkB,CAYhF"}

package/cursor/compile.js

@@ -0,0 +1,47 @@
+import { computeSoulHash } from './hash.js';
+function escapeYamlDoubleQuoted(value) {
+    return value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+const FRONTMATTER_DELIMITER = '---';
+function buildFrontmatter(description) {
+    const safeDescription = escapeYamlDoubleQuoted(description);
+    return [
+        FRONTMATTER_DELIMITER,
+        'alwaysApply: true',
+        `description: "${safeDescription}"`,
+        FRONTMATTER_DELIMITER,
+        '',
+    ].join('\n');
+}
+/** Split compiled `.mdc` into frontmatter block and Soul body. */
+export function parseCompiledCursorRule(content) {
+    if (!content.startsWith(`${FRONTMATTER_DELIMITER}\n`)) {
+        throw new Error('Compiled Cursor rule is missing YAML frontmatter.');
+    }
+    const closeIndex = content.indexOf(`\n${FRONTMATTER_DELIMITER}\n`, FRONTMATTER_DELIMITER.length + 1);
+    if (closeIndex === -1) {
+        throw new Error('Compiled Cursor rule frontmatter is not closed.');
+    }
+    const frontmatterEnd = closeIndex + 1 + `${FRONTMATTER_DELIMITER}\n`.length;
+    return {
+        frontmatter: content.slice(0, frontmatterEnd),
+        body: content.slice(frontmatterEnd),
+    };
+}
+/**
+ * Compile Engram Soul prose into a Cursor always-on rule (`.mdc`).
+ * Body is SOUL.md verbatim — no YAML or frontmatter leakage into Soul prose.
+ */
+export function compileSoulToCursorRule(engram) {
+    const soul = engram.soul.replace(/\r\n/g, '\n');
+    const soulHash = computeSoulHash(soul);
+    const frontmatter = buildFrontmatter(engram.engram.name);
+    const content = `${frontmatter}${soul}`;
+    return {
+        engramId: engram.engram.id,
+        name: engram.engram.name,
+        soulHash,
+        content,
+    };
+}
+//# sourceMappingURL=compile.js.map

package/cursor/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/cursor/compile.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC,SAAS,gBAAgB,CAAC,WAAmB;IAC3C,MAAM,eAAe,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC5D,OAAO;QACL,qBAAqB;QACrB,mBAAmB;QACnB,iBAAiB,eAAe,GAAG;QACnC,qBAAqB;QACrB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,qBAAqB,IAAI,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,qBAAqB,IAAI,EAAE,qBAAqB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrG,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,cAAc,GAAG,UAAU,GAAG,CAAC,GAAG,GAAG,qBAAqB,IAAI,CAAC,MAAM,CAAC;IAC5E,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC;QAC7C,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAoB;IAC1D,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,GAAG,WAAW,GAAG,IAAI,EAAE,CAAC;IAExC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE;QAC1B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;QACxB,QAAQ;QACR,OAAO;KACR,CAAC;AACJ,CAAC"}

package/cursor/ensure-shrine.d.ts

@@ -0,0 +1,25 @@
+import type { EidolaRuntimeConfig } from '../config.js';
+export interface LaunchShrineResult {
+    launched: boolean;
+    alreadyRunning: boolean;
+    surface?: string;
+    pid?: number;
+    skipped?: boolean;
+    reason?: string;
+    mode?: 'http';
+    url?: string;
+    restarted?: boolean;
+}
+export interface LaunchShrineOptions {
+    requestedSurface?: string;
+}
+/**
+ * Spawn Shrine — HTTP server for browser-based display surfaces.
+ * Invoked via MCP `awaken` or `pnpm ensure:shrine`.
+ */
+export declare function launchShrine(config: EidolaRuntimeConfig, onLog?: (message: string) => void, options?: LaunchShrineOptions): Promise<LaunchShrineResult>;
+/** @deprecated Use launchShrine */
+export declare const ensureShrineRunning: typeof launchShrine;
+/** @deprecated Use LaunchShrineResult */
+export type EnsureShrineResult = LaunchShrineResult;
+//# sourceMappingURL=ensure-shrine.d.ts.map

package/cursor/ensure-shrine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-shrine.d.ts","sourceRoot":"","sources":["../../src/cursor/ensure-shrine.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAqBxD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2ED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,GAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAiB,EAC7C,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA4G7B;AAED,mCAAmC;AACnC,eAAO,MAAM,mBAAmB,qBAAe,CAAC;AAEhD,yCAAyC;AACzC,MAAM,MAAM,kBAAkB,GAAG,kBAAkB,CAAC"}

package/cursor/ensure-shrine.js

@@ -0,0 +1,168 @@
+import { access } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isShrineRunning, readShrineLock, removeShrineLock, stopShrine, writeShrineLock, } from './shrine-lock.js';
+import { isHttpShrineSurface, normalizeShrineSurfaceInput, resolveShrineSurface, shrineHttpPort, shrineHttpUrl, shrineSurfaceEnv, decomposeLegacySurface, } from './shrine-surface.js';
+import { readWorkspaceConfig, writeWorkspaceConfig } from './workspace-config.js';
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isPublishedInstall(packageRoot) {
+    return packageRoot.replace(/\\/g, '/').includes('/node_modules/');
+}
+function resolveMcpPackageRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '..');
+}
+function shrineHttpEntryCandidates(appRoot) {
+    const packageRoot = resolveMcpPackageRoot();
+    const candidates = [join(packageRoot, 'shrine', 'server', 'index.js')];
+    if (!isPublishedInstall(packageRoot)) {
+        candidates.push(join(appRoot, 'packages', 'shrine', 'dist', 'server', 'index.js'));
+    }
+    return candidates;
+}
+function shrineHttpStartCommand(appRoot, envOverrides) {
+    const env = { ...process.env, ...envOverrides };
+    if (process.env.EIDOLA_WORKSPACE) {
+        env.EIDOLA_WORKSPACE = process.env.EIDOLA_WORKSPACE;
+    }
+    const packageRoot = resolveMcpPackageRoot();
+    const shrineEntry = shrineHttpEntryCandidates(appRoot).find((path) => existsSync(path));
+    if (shrineEntry) {
+        return {
+            command: process.execPath,
+            args: [shrineEntry],
+            cwd: dirname(shrineEntry),
+            env,
+        };
+    }
+    if (isPublishedInstall(packageRoot)) {
+        return {
+            command: process.execPath,
+            args: [join(packageRoot, 'cli.js'), 'shrine'],
+            cwd: packageRoot,
+            env,
+        };
+    }
+    return {
+        command: process.execPath,
+        args: [join(appRoot, 'packages', 'shrine', 'dist', 'server', 'index.js')],
+        cwd: join(appRoot, 'packages', 'shrine'),
+        env,
+    };
+}
+async function shrineHttpBuildReady(appRoot) {
+    return shrineHttpEntryCandidates(appRoot).some((path) => existsSync(path));
+}
+/**
+ * Spawn Shrine — HTTP server for browser-based display surfaces.
+ * Invoked via MCP `awaken` or `pnpm ensure:shrine`.
+ */
+export async function launchShrine(config, onLog = defaultLog, options = {}) {
+    const workspaceRoot = config.workspaceRoot;
+    if (!workspaceRoot) {
+        return { launched: false, alreadyRunning: false, skipped: true, reason: 'no_workspace' };
+    }
+    let workspaceConfig = null;
+    try {
+        workspaceConfig = await readWorkspaceConfig(workspaceRoot);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        onLog(`launch-shrine: workspace config error: ${message}`);
+        return { launched: false, alreadyRunning: false, skipped: true, reason: 'config_error' };
+    }
+    if (options.requestedSurface?.trim()) {
+        const normalizedSurface = normalizeShrineSurfaceInput(options.requestedSurface);
+        const decomposed = decomposeLegacySurface(normalizedSurface);
+        const mergedConfig = {
+            ...(workspaceConfig ?? {}),
+            shrine_surface: decomposed.legacyValue,
+            shrine_aspect_ratio: decomposed.aspectRatio,
+            shrine_surface_mode: decomposed.surfaceMode,
+        };
+        await writeWorkspaceConfig(workspaceRoot, mergedConfig);
+        workspaceConfig = mergedConfig;
+    }
+    if (process.env.EIDOLA_SKIP_SHRINE_LAUNCH === '1') {
+        return { launched: false, alreadyRunning: false, skipped: true, reason: 'disabled_env' };
+    }
+    const surface = resolveShrineSurface({
+        configSurface: workspaceConfig?.shrine_surface,
+        aspectRatio: workspaceConfig?.shrine_aspect_ratio,
+        surfaceMode: workspaceConfig?.shrine_surface_mode,
+    });
+    const httpMode = isHttpShrineSurface(surface);
+    const targetSurface = surface.preset === 'custom' ? `${surface.width}x${surface.height}` : surface.preset;
+    if (!httpMode) {
+        onLog(`launch-shrine: surface "${targetSurface}" requires Electron, which has been removed — use a browser-compatible surface`);
+        return { launched: false, alreadyRunning: false, skipped: true, reason: 'electron_removed' };
+    }
+    let restarted = false;
+    if (await isShrineRunning(workspaceRoot)) {
+        const lock = await readShrineLock(workspaceRoot);
+        if (lock?.surface === targetSurface) {
+            return {
+                launched: false,
+                alreadyRunning: true,
+                surface: surface.preset,
+                mode: 'http',
+                url: shrineHttpUrl(shrineHttpPort()),
+            };
+        }
+        await stopShrine(workspaceRoot);
+        restarted = true;
+    }
+    else {
+        const staleLock = await readShrineLock(workspaceRoot);
+        if (staleLock) {
+            await removeShrineLock(workspaceRoot);
+        }
+    }
+    if (!(await shrineHttpBuildReady(config.repoRoot))) {
+        onLog('launch-shrine: shrine HTTP server not built — run pnpm build in eidola-repo first');
+        return { launched: false, alreadyRunning: false, skipped: true, reason: 'not_built' };
+    }
+    const { command, args, cwd, env } = shrineHttpStartCommand(config.repoRoot, shrineSurfaceEnv(surface));
+    const child = spawn(command, args, {
+        cwd,
+        detached: true,
+        stdio: 'ignore',
+        env,
+    });
+    child.unref();
+    const port = shrineHttpPort();
+    const url = shrineHttpUrl(port);
+    const lock = {
+        pid: child.pid ?? 0,
+        surface: surface.preset,
+        started_at: new Date().toISOString(),
+    };
+    if (lock.pid > 0) {
+        await writeShrineLock(workspaceRoot, lock);
+    }
+    onLog(`launch-shrine: HTTP ${surface.preset} at ${url} (pid ${lock.pid || 'unknown'})`);
+    return {
+        launched: true,
+        alreadyRunning: false,
+        surface: surface.preset,
+        pid: lock.pid > 0 ? lock.pid : undefined,
+        mode: 'http',
+        url,
+        restarted: restarted || undefined,
+    };
+}
+/** @deprecated Use launchShrine */
+export const ensureShrineRunning = launchShrine;
+function defaultLog(message) {
+    console.error('[eidola]', message);
+}
+//# sourceMappingURL=ensure-shrine.js.map

package/cursor/ensure-shrine.js.map

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

package/cursor/hash.d.ts

@@ -0,0 +1,3 @@
+/** SHA-256 hex digest of normalized Soul prose (LF line endings). */
+export declare function computeSoulHash(soul: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/cursor/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/cursor/hash.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/cursor/hash.js

@@ -0,0 +1,7 @@
+import { createHash } from 'node:crypto';
+/** SHA-256 hex digest of normalized Soul prose (LF line endings). */
+export function computeSoulHash(soul) {
+    const normalized = soul.replace(/\r\n/g, '\n');
+    return createHash('sha256').update(normalized, 'utf8').digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/cursor/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/cursor/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC/C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC"}

package/cursor/shrine-lock.d.ts

@@ -0,0 +1,17 @@
+export declare const SHRINE_LOCK_FILENAME = "eidola-shrine.lock";
+export interface ShrineLockFile {
+    pid: number;
+    surface: string;
+    started_at: string;
+}
+export declare function shrineLockPath(workspaceRoot: string): string;
+export declare function isProcessAlive(pid: number): boolean;
+export declare function readShrineLock(workspaceRoot: string): Promise<ShrineLockFile | null>;
+export declare function writeShrineLock(workspaceRoot: string, lock: ShrineLockFile): Promise<void>;
+export declare function removeShrineLock(workspaceRoot: string): Promise<void>;
+export declare function isShrineRunning(workspaceRoot: string): Promise<boolean>;
+export declare function stopShrine(workspaceRoot: string): Promise<{
+    stopped: boolean;
+    pid?: number;
+}>;
+//# sourceMappingURL=shrine-lock.d.ts.map

package/cursor/shrine-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-lock.d.ts","sourceRoot":"","sources":["../../src/cursor/shrine-lock.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,oBAAoB,uBAAuB,CAAC;AAEzD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAYnD;AAED,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAmB1F;AAED,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG;AAED,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS3E;AAED,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7E;AAED,wBAAsB,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBnG"}