@eidola.app/cli 0.2.0

package/cursor/shrine-lock.js

@@ -0,0 +1,82 @@
+import { readFile, unlink, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export const SHRINE_LOCK_FILENAME = 'eidola-shrine.lock';
+export function shrineLockPath(workspaceRoot) {
+    return join(workspaceRoot, '.cursor', SHRINE_LOCK_FILENAME);
+}
+export function isProcessAlive(pid) {
+    if (!Number.isInteger(pid) || pid <= 0) {
+        return false;
+    }
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = error.code;
+        return code === 'EPERM';
+    }
+}
+export async function readShrineLock(workspaceRoot) {
+    const lockPath = shrineLockPath(workspaceRoot);
+    try {
+        const raw = await readFile(lockPath, 'utf8');
+        const parsed = JSON.parse(raw);
+        if (typeof parsed.pid !== 'number' || typeof parsed.started_at !== 'string') {
+            return null;
+        }
+        if (typeof parsed.surface !== 'string') {
+            return null;
+        }
+        return parsed;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function writeShrineLock(workspaceRoot, lock) {
+    const lockPath = shrineLockPath(workspaceRoot);
+    await writeFile(lockPath, `${JSON.stringify(lock, null, 2)}\n`, 'utf8');
+}
+export async function removeShrineLock(workspaceRoot) {
+    try {
+        await unlink(shrineLockPath(workspaceRoot));
+    }
+    catch (error) {
+        const code = error.code;
+        if (code !== 'ENOENT') {
+            throw error;
+        }
+    }
+}
+export async function isShrineRunning(workspaceRoot) {
+    const lock = await readShrineLock(workspaceRoot);
+    if (!lock) {
+        return false;
+    }
+    return isProcessAlive(lock.pid);
+}
+export async function stopShrine(workspaceRoot) {
+    const lock = await readShrineLock(workspaceRoot);
+    if (!lock) {
+        return { stopped: false };
+    }
+    const pid = lock.pid;
+    if (!isProcessAlive(pid)) {
+        await removeShrineLock(workspaceRoot);
+        return { stopped: false, pid };
+    }
+    try {
+        process.kill(pid);
+    }
+    catch {
+        // Process may have exited between liveness check and kill.
+    }
+    await removeShrineLock(workspaceRoot);
+    return { stopped: true, pid };
+}
+//# sourceMappingURL=shrine-lock.js.map

package/cursor/shrine-lock.js.map

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

package/cursor/shrine-surface.d.ts

@@ -0,0 +1,40 @@
+export type ShrineSurfacePresetId = 'ultrawide-4-1' | 'square-1-1' | 'widescreen-16-9' | 'kraken-elite-v2';
+export type ShrineLayoutTier = 'ultrawide' | 'square' | 'widescreen';
+export interface ShrineSurface {
+    preset: ShrineSurfacePresetId | 'custom';
+    width: number;
+    height: number;
+    circularMask?: boolean;
+    layoutTier?: ShrineLayoutTier;
+}
+export declare const SHRINE_SURFACE_PRESETS: Record<ShrineSurfacePresetId, {
+    width: number;
+    height: number;
+    circularMask?: boolean;
+    layoutTier?: ShrineLayoutTier;
+}>;
+export declare const DEFAULT_SHRINE_SURFACE_PRESET: ShrineSurfacePresetId;
+export declare function normalizeShrineSurfaceInput(value: string): string;
+export declare const DEFAULT_SHRINE_HTTP_PORT = 9743;
+export interface ResolveShrineSurfaceInput {
+    surfaceEnv?: string | undefined;
+    widthEnv?: string | undefined;
+    heightEnv?: string | undefined;
+    configSurface?: string | undefined;
+    aspectRatio?: string | undefined;
+    surfaceMode?: string | undefined;
+}
+export type ShrineAspectRatioId = 'ultrawide-4-1' | 'widescreen-16-9' | 'square-1-1';
+export type ShrineSurfaceModeId = 'browser' | 'kraken';
+export declare function decomposeLegacySurface(legacy: string): {
+    aspectRatio: ShrineAspectRatioId;
+    surfaceMode: ShrineSurfaceModeId;
+    legacyValue: string;
+};
+export declare function resolveShrineSurface(input?: ResolveShrineSurfaceInput): ShrineSurface;
+/** All surfaces now run as HTTP — Electron removed in Phase 4.1. Always returns true. */
+export declare function isHttpShrineSurface(_surface: ShrineSurface): boolean;
+export declare function shrineHttpPort(): number;
+export declare function shrineHttpUrl(port?: number): string;
+export declare function shrineSurfaceEnv(surface: ShrineSurface): NodeJS.ProcessEnv;
+//# sourceMappingURL=shrine-surface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shrine-surface.d.ts","sourceRoot":"","sources":["../../src/cursor/shrine-surface.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAC7B,eAAe,GACf,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,qBAAqB,GAAG,QAAQ,CAAC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CACzC,qBAAqB,EACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAWzF,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,qBAAuC,CAAC;AASpF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiBjE;AAED,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,yBAAyB;IACxC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,iBAAiB,GAAG,YAAY,CAAC;AACrF,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,QAAQ,CAAC;AA0BvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG;IACtD,WAAW,EAAE,mBAAmB,CAAC;IACjC,WAAW,EAAE,mBAAmB,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,CAiBA;AAmCD,wBAAgB,oBAAoB,CAAC,KAAK,GAAE,yBAA8B,GAAG,aAAa,CAsCzF;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAEpE;AAED,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAyB,GAAG,MAAM,CAErE;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,UAAU,CAO1E"}

package/cursor/shrine-surface.js

@@ -0,0 +1,152 @@
+export const SHRINE_SURFACE_PRESETS = {
+    'ultrawide-4-1': { width: 1920, height: 480, layoutTier: 'ultrawide' },
+    'square-1-1': { width: 640, height: 640, layoutTier: 'square' },
+    'widescreen-16-9': { width: 1920, height: 1080, layoutTier: 'widescreen' },
+    'kraken-elite-v2': {
+        width: 640,
+        height: 640,
+        circularMask: true,
+        layoutTier: 'square',
+    },
+};
+export const DEFAULT_SHRINE_SURFACE_PRESET = 'ultrawide-4-1';
+const KRAKEN_SURFACE_ALIASES = new Set([
+    'kraken',
+    'kraken-lcd',
+    'kraken-elite',
+    'kraken-elite-v2',
+]);
+export function normalizeShrineSurfaceInput(value) {
+    const trimmed = value.trim();
+    const lower = trimmed.toLowerCase();
+    if (KRAKEN_SURFACE_ALIASES.has(lower)) {
+        return 'kraken-elite-v2';
+    }
+    if (lower in SHRINE_SURFACE_PRESETS) {
+        return lower;
+    }
+    if (parseCustomDimensions(trimmed)) {
+        return trimmed;
+    }
+    return trimmed;
+}
+export const DEFAULT_SHRINE_HTTP_PORT = 9743;
+const ASPECT_RATIO_PRESETS = {
+    'ultrawide-4-1': { width: 1920, height: 480, layoutTier: 'ultrawide' },
+    'widescreen-16-9': { width: 1920, height: 1080, layoutTier: 'widescreen' },
+    'square-1-1': { width: 640, height: 640, layoutTier: 'square' },
+};
+function isAspectRatioId(value) {
+    return value in ASPECT_RATIO_PRESETS;
+}
+function normalizeSurfaceMode(value) {
+    const lower = value.trim().toLowerCase();
+    if (lower === 'browser' || lower === 'standard') {
+        return 'browser';
+    }
+    if (KRAKEN_SURFACE_ALIASES.has(lower) || lower === 'kraken') {
+        return 'kraken';
+    }
+    return null;
+}
+export function decomposeLegacySurface(legacy) {
+    const normalized = normalizeShrineSurfaceInput(legacy);
+    if (normalized === 'kraken-elite-v2') {
+        return {
+            aspectRatio: 'square-1-1',
+            surfaceMode: 'kraken',
+            legacyValue: 'kraken-elite-v2',
+        };
+    }
+    if (isAspectRatioId(normalized)) {
+        return { aspectRatio: normalized, surfaceMode: 'browser', legacyValue: normalized };
+    }
+    return {
+        aspectRatio: 'ultrawide-4-1',
+        surfaceMode: 'browser',
+        legacyValue: DEFAULT_SHRINE_SURFACE_PRESET,
+    };
+}
+function composeFromDisplayFields(aspectRatio, surfaceMode) {
+    const aspect = ASPECT_RATIO_PRESETS[aspectRatio];
+    if (surfaceMode === 'kraken') {
+        const kraken = SHRINE_SURFACE_PRESETS['kraken-elite-v2'];
+        return {
+            preset: 'kraken-elite-v2',
+            width: aspect.width,
+            height: aspect.height,
+            circularMask: kraken.circularMask,
+            layoutTier: aspect.layoutTier,
+        };
+    }
+    return { preset: aspectRatio, ...aspect };
+}
+function parseCustomDimensions(value) {
+    const match = value.trim().match(/^(\d+)\s*[x×]\s*(\d+)$/i);
+    if (!match) {
+        return null;
+    }
+    const width = Number.parseInt(match[1] ?? '', 10);
+    const height = Number.parseInt(match[2] ?? '', 10);
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0) {
+        return null;
+    }
+    return { preset: 'custom', width, height };
+}
+export function resolveShrineSurface(input = {}) {
+    const widthEnv = input.widthEnv ?? process.env.EIDOLA_SHRINE_WIDTH;
+    const heightEnv = input.heightEnv ?? process.env.EIDOLA_SHRINE_HEIGHT;
+    if (widthEnv?.trim() && heightEnv?.trim()) {
+        const width = Number.parseInt(widthEnv.trim(), 10);
+        const height = Number.parseInt(heightEnv.trim(), 10);
+        if (Number.isFinite(width) && Number.isFinite(height) && width > 0 && height > 0) {
+            return { preset: 'custom', width, height };
+        }
+    }
+    const aspectRatio = input.aspectRatio?.trim();
+    const surfaceMode = input.surfaceMode?.trim();
+    if (aspectRatio && surfaceMode && isAspectRatioId(aspectRatio)) {
+        const mode = normalizeSurfaceMode(surfaceMode);
+        if (mode) {
+            return composeFromDisplayFields(aspectRatio, mode);
+        }
+    }
+    const surfaceRaw = input.surfaceEnv?.trim() ||
+        input.configSurface?.trim() ||
+        process.env.EIDOLA_SHRINE_SURFACE?.trim() ||
+        DEFAULT_SHRINE_SURFACE_PRESET;
+    const custom = parseCustomDimensions(surfaceRaw);
+    if (custom) {
+        return custom;
+    }
+    const preset = SHRINE_SURFACE_PRESETS[surfaceRaw];
+    if (preset) {
+        return { preset: surfaceRaw, ...preset };
+    }
+    const fallback = SHRINE_SURFACE_PRESETS[DEFAULT_SHRINE_SURFACE_PRESET];
+    return { preset: DEFAULT_SHRINE_SURFACE_PRESET, ...fallback };
+}
+/** All surfaces now run as HTTP — Electron removed in Phase 4.1. Always returns true. */
+export function isHttpShrineSurface(_surface) {
+    return true;
+}
+export function shrineHttpPort() {
+    const raw = process.env.EIDOLA_SHRINE_HTTP_PORT?.trim();
+    if (!raw) {
+        return DEFAULT_SHRINE_HTTP_PORT;
+    }
+    const port = Number.parseInt(raw, 10);
+    return Number.isFinite(port) && port > 0 ? port : DEFAULT_SHRINE_HTTP_PORT;
+}
+export function shrineHttpUrl(port = shrineHttpPort()) {
+    return `http://127.0.0.1:${port}/shrine`;
+}
+export function shrineSurfaceEnv(surface) {
+    const env = {
+        EIDOLA_SHRINE_SURFACE: surface.preset === 'custom' ? `${surface.width}x${surface.height}` : surface.preset,
+        EIDOLA_SHRINE_WIDTH: String(surface.width),
+        EIDOLA_SHRINE_HEIGHT: String(surface.height),
+    };
+    return env;
+}
+//# sourceMappingURL=shrine-surface.js.map

package/cursor/shrine-surface.js.map

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

package/cursor/soul-source.d.ts

@@ -0,0 +1,3 @@
+export type SoulSource = 'cursor_rule' | 'injection' | 'none';
+export declare function detectSoulSource(workspaceRoot: string | undefined, engramId: string): Promise<Exclude<SoulSource, 'none'>>;
+//# sourceMappingURL=soul-source.d.ts.map

package/cursor/soul-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"soul-source.d.ts","sourceRoot":"","sources":["../../src/cursor/soul-source.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9D,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAWtC"}

package/cursor/soul-source.js

@@ -0,0 +1,15 @@
+import { access } from 'node:fs/promises';
+import { cursorRulePath } from './workspace-config.js';
+export async function detectSoulSource(workspaceRoot, engramId) {
+    if (!workspaceRoot) {
+        return 'injection';
+    }
+    try {
+        await access(cursorRulePath(workspaceRoot, engramId));
+        return 'cursor_rule';
+    }
+    catch {
+        return 'injection';
+    }
+}
+//# sourceMappingURL=soul-source.js.map

package/cursor/soul-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"soul-source.js","sourceRoot":"","sources":["../../src/cursor/soul-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,aAAiC,EACjC,QAAgB;IAEhB,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtD,OAAO,aAAa,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC;IACrB,CAAC;AACH,CAAC"}

package/cursor/stale.d.ts

@@ -0,0 +1,12 @@
+import type { EidolaWorkspaceConfig } from './types.js';
+export interface StaleSoulCompileCheck {
+    engramDirectory: string;
+    mdcPath: string;
+    workspaceConfig?: EidolaWorkspaceConfig;
+}
+/**
+ * Warn on stderr when SOUL.md content no longer matches the compiled rule hash.
+ * Non-blocking — MCP startup and link-engram validation call this for visibility only.
+ */
+export declare function warnIfStaleSoulCompile(check: StaleSoulCompileCheck): Promise<boolean>;
+//# sourceMappingURL=stale.d.ts.map

package/cursor/stale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale.d.ts","sourceRoot":"","sources":["../../src/cursor/stale.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuC3F"}

package/cursor/stale.js

@@ -0,0 +1,41 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { computeSoulHash } from './hash.js';
+import { parseCompiledCursorRule } from './compile.js';
+/**
+ * Warn on stderr when SOUL.md content no longer matches the compiled rule hash.
+ * Non-blocking — MCP startup and link-engram validation call this for visibility only.
+ */
+export async function warnIfStaleSoulCompile(check) {
+    const soulPath = join(check.engramDirectory, 'SOUL.md');
+    let soulContent;
+    try {
+        soulContent = await readFile(soulPath, 'utf8');
+    }
+    catch {
+        return false;
+    }
+    const currentHash = computeSoulHash(soulContent);
+    const storedHash = check.workspaceConfig?.soul_hash;
+    if (storedHash && storedHash !== currentHash) {
+        const engramId = check.workspaceConfig?.active_engram_id ?? 'unknown';
+        console.error(`[eidola] Stale Cursor rule: SOUL.md changed since last compile (hash mismatch). Re-run: pnpm link-engram ${engramId}`);
+        return true;
+    }
+    let mdcContent;
+    try {
+        mdcContent = await readFile(check.mdcPath, 'utf8');
+    }
+    catch {
+        return false;
+    }
+    const { body } = parseCompiledCursorRule(mdcContent);
+    const compiledBodyHash = computeSoulHash(body);
+    if (compiledBodyHash !== currentHash) {
+        const engramId = check.workspaceConfig?.active_engram_id ?? 'unknown';
+        console.error(`[eidola] Stale Cursor rule: compiled .mdc body does not match SOUL.md. Re-run: pnpm link-engram ${engramId}`);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=stale.js.map

package/cursor/stale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale.js","sourceRoot":"","sources":["../../src/cursor/stale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AASvD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAA4B;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;IACxD,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,EAAE,SAAS,CAAC;IAEpD,IAAI,UAAU,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,EAAE,gBAAgB,IAAI,SAAS,CAAC;QACtE,OAAO,CAAC,KAAK,CACX,4GAA4G,QAAQ,EAAE,CACvH,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IACrD,MAAM,gBAAgB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAE/C,IAAI,gBAAgB,KAAK,WAAW,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,eAAe,EAAE,gBAAgB,IAAI,SAAS,CAAC;QACtE,OAAO,CAAC,KAAK,CACX,mGAAmG,QAAQ,EAAE,CAC9G,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/cursor/types.d.ts

@@ -0,0 +1,24 @@
+export interface EidolaWorkspaceConfig {
+    /** Active Engram slug — matches directory name and compiled rule filename. */
+    active_engram_id: string;
+    /** Optional override for Engram directory root. Defaults to `{EIDOLA_ROOT}/engrams`. */
+    engrams_dir?: string;
+    /** SHA-256 hex of SOUL.md at last compile — used for stale-rule detection. */
+    soul_hash: string;
+    /** ISO-8601 timestamp when the Cursor rule was last compiled. */
+    compiled_at: string;
+    /** Legacy shrine preset — kept in sync when display settings change. */
+    shrine_surface?: string;
+    /** Aspect ratio layout: `ultrawide-4-1`, `widescreen-16-9`, `square-1-1`. */
+    shrine_aspect_ratio?: string;
+    /** Display surface: `browser` or `kraken`. */
+    shrine_surface_mode?: string;
+}
+export interface CompiledCursorRule {
+    engramId: string;
+    name: string;
+    soulHash: string;
+    /** Full `.mdc` file content including frontmatter. */
+    content: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/cursor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cursor/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB,wFAAwF;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8CAA8C;IAC9C,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/cursor/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/cursor/types.js.map

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

package/cursor/workspace-config.d.ts

@@ -0,0 +1,13 @@
+import type { EidolaWorkspaceConfig } from './types.js';
+export declare const EIDOLA_WORKSPACE_CONFIG_FILENAME = "eidola.json";
+export declare function workspaceConfigPath(workspaceRoot: string): string;
+export declare function cursorRulePath(workspaceRoot: string, engramId: string): string;
+export declare function readWorkspaceConfig(workspaceRoot: string): Promise<EidolaWorkspaceConfig | null>;
+export declare function writeWorkspaceConfig(workspaceRoot: string, config: EidolaWorkspaceConfig): Promise<void>;
+export declare function buildWorkspaceConfig(params: {
+    engramId: string;
+    soulHash: string;
+    engramsDir?: string;
+    shrineSurface?: EidolaWorkspaceConfig['shrine_surface'];
+}): EidolaWorkspaceConfig;
+//# sourceMappingURL=workspace-config.d.ts.map

package/cursor/workspace-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-config.d.ts","sourceRoot":"","sources":["../../src/cursor/workspace-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,eAAO,MAAM,gCAAgC,gBAAgB,CAAC;AAE9D,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAsB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAYtG;AAED,wBAAsB,oBAAoB,CACxC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,qBAAqB,CAAC,gBAAgB,CAAC,CAAC;CACzD,GAAG,qBAAqB,CAgBxB"}

package/cursor/workspace-config.js

@@ -0,0 +1,44 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+export const EIDOLA_WORKSPACE_CONFIG_FILENAME = 'eidola.json';
+export function workspaceConfigPath(workspaceRoot) {
+    return join(workspaceRoot, '.cursor', EIDOLA_WORKSPACE_CONFIG_FILENAME);
+}
+export function cursorRulePath(workspaceRoot, engramId) {
+    return join(workspaceRoot, '.cursor', 'rules', `${engramId}.mdc`);
+}
+export async function readWorkspaceConfig(workspaceRoot) {
+    const configPath = workspaceConfigPath(workspaceRoot);
+    try {
+        const raw = await readFile(configPath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function writeWorkspaceConfig(workspaceRoot, config) {
+    const cursorDir = join(workspaceRoot, '.cursor');
+    await mkdir(cursorDir, { recursive: true });
+    const configPath = workspaceConfigPath(workspaceRoot);
+    await writeFile(configPath, `${JSON.stringify(config, null, 2)}\n`, 'utf8');
+}
+export function buildWorkspaceConfig(params) {
+    const config = {
+        active_engram_id: params.engramId,
+        soul_hash: params.soulHash,
+        compiled_at: new Date().toISOString(),
+    };
+    if (params.engramsDir) {
+        config.engrams_dir = params.engramsDir;
+    }
+    if (params.shrineSurface) {
+        config.shrine_surface = params.shrineSurface;
+    }
+    return config;
+}
+//# sourceMappingURL=workspace-config.js.map

package/cursor/workspace-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-config.js","sourceRoot":"","sources":["../../src/cursor/workspace-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,CAAC,MAAM,gCAAgC,GAAG,aAAa,CAAC;AAE9D,MAAM,UAAU,mBAAmB,CAAC,aAAqB;IACvD,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,gCAAgC,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,aAAqB,EAAE,QAAgB;IACpE,OAAO,IAAI,CAAC,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,QAAQ,MAAM,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,aAAqB;IAC7D,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACtD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAC;QACnD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,aAAqB,EACrB,MAA6B;IAE7B,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;IACjD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAKpC;IACC,MAAM,MAAM,GAA0B;QACpC,gBAAgB,EAAE,MAAM,CAAC,QAAQ;QACjC,SAAS,EAAE,MAAM,CAAC,QAAQ;QAC1B,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;IAEF,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/engram/loader.d.ts

@@ -0,0 +1,3 @@
+import { type LoadedEngram } from './types.js';
+export declare function loadEngramFromDirectory(directory: string): Promise<LoadedEngram>;
+//# sourceMappingURL=loader.d.ts.map

package/engram/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/engram/loader.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AA0ChE,wBAAsB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CA6BtF"}

package/engram/loader.js

@@ -0,0 +1,60 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+import { EngramLoadError } from './types.js';
+import { parseEngramYaml, parseVesselYaml } from './parse.js';
+const REQUIRED_FILES = ['SOUL.md', 'vessel.yaml', 'engram.yaml'];
+async function readRequiredFile(directory, filename) {
+    const filePath = join(directory, filename);
+    try {
+        return await readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT') {
+            throw new EngramLoadError(`Engram directory is missing required file "${filename}".`, 'MISSING_FILE', directory);
+        }
+        throw error;
+    }
+}
+function parseYamlFile(content, filename, parser) {
+    let raw;
+    try {
+        raw = yaml.load(content);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new EngramLoadError(`Failed to parse ${filename}: ${message}`, 'INVALID_YAML', undefined);
+    }
+    try {
+        return parser(raw);
+    }
+    catch (error) {
+        if (error instanceof EngramLoadError) {
+            throw error;
+        }
+        const message = error instanceof Error ? error.message : String(error);
+        throw new EngramLoadError(`Invalid ${filename}: ${message}`, 'INVALID_FIELD', undefined);
+    }
+}
+export async function loadEngramFromDirectory(directory) {
+    for (const filename of REQUIRED_FILES) {
+        await readRequiredFile(directory, filename);
+    }
+    const [soul, vesselContent, engramContent] = await Promise.all(REQUIRED_FILES.map((filename) => readRequiredFile(directory, filename)));
+    const engram = parseYamlFile(engramContent, 'engram.yaml', parseEngramYaml);
+    const vessel = parseYamlFile(vesselContent, 'vessel.yaml', parseVesselYaml);
+    if (engram.id !== undefined) {
+        const dirName = directory.replace(/[/\\]+$/, '').split(/[/\\]/).pop();
+        if (dirName && dirName !== engram.id) {
+            throw new EngramLoadError(`Engram id "${engram.id}" does not match directory name "${dirName}".`, 'ID_MISMATCH', directory);
+        }
+    }
+    return {
+        directory,
+        soul: soul.replace(/\r\n/g, '\n'),
+        engram,
+        vessel,
+    };
+}
+//# sourceMappingURL=loader.js.map

package/engram/loader.js.map

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

package/engram/parse.d.ts

@@ -0,0 +1,4 @@
+import { type EngramConfig, type VesselConfig } from './types.js';
+export declare function parseEngramYaml(raw: unknown): EngramConfig;
+export declare function parseVesselYaml(raw: unknown): VesselConfig;
+//# sourceMappingURL=parse.d.ts.map

package/engram/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/engram/parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAwBnF,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAqD1D;AAkHD,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAyD1D"}