@elaraai/east-plugin 0.0.0-stage → 1.0.87

package/dist/lib/codex-hook.d.ts

@@ -0,0 +1,64 @@
+import type { HookInput } from "./hook-io.js";
+import { type PatchFile } from "./codex-tools.js";
+import type { SearchHookReply } from "./search-hooks.js";
+/** What a Codex tool call touches: the files it writes or reads, and the command or patch it runs. */
+export interface CodexToolCall {
+    /** The tool's name. */
+    tool: string;
+    /** The shell command or the patch, as the tool's input holds it. */
+    command: string;
+    /** Whether the tool runs a shell command. */
+    shell: boolean;
+    /** The files a patch adds, updates, moves or deletes. */
+    patches: PatchFile[];
+    /** The file a file tool names, resolved against the working directory. */
+    filePath: string | undefined;
+    /** Every file the call writes or reads, each once (a deleted file excluded). */
+    paths: string[];
+}
+/**
+ * What a Codex tool call touches.
+ *
+ * @param event - The hook's event
+ * @returns The files, command and patch of the call
+ */
+export declare function codexToolCall(event: HookInput): CodexToolCall;
+/** The Codex search gate's configuration. */
+export interface CodexSearchGateOptions {
+    /** The tools whose call in a transcript counts as a search. */
+    searchTools: readonly string[];
+    /** Matches a search or fetch tool's MCP name, whatever server name Codex gives it. */
+    searchToolName: RegExp;
+    /** The instruction a write of corpus code with no search on record meets (`gateText(...)`). */
+    gateText: string;
+    /** The reminder a read of the corpus gets (`readText(...)`). */
+    readText: string;
+    /** Whether a file tool reaches for the corpus (`corpusReadFor(scope)`). */
+    isCorpusRead(tool: string, input: Record<string, unknown>): boolean;
+    /** Matches a shell command that reaches for the corpus. */
+    shellSweep: RegExp;
+    /** Matches the corpus's code in a file's text, before or after the write. */
+    corpusCode: RegExp;
+    /** The prefix of the per-session marker in the temporary directory that records a search seen. */
+    markerPrefix: string;
+    /** The environment variable that makes the gate refuse the write when it is `deny`. */
+    requireSearchEnv: string;
+}
+/** East's Codex gate. */
+export declare const EAST_CODEX_SEARCH_GATE: CodexSearchGateOptions;
+/**
+ * The search-first gate for a Codex tool call. After a successful search or
+ * fetch it records the search (`"recorded"`) — the stable hook event, not the
+ * transcript's undocumented wire format. Before a call, it reminds a read of
+ * the corpus, and gives a write of corpus code with no search on record the
+ * instruction to search first: a reminder, or a refusal when the options'
+ * environment variable is `deny`.
+ *
+ * @param event - The hook's event
+ * @param options - The gate's configuration
+ * @param call - What the call touches, when the hook has read it already for
+ *   its own use, so the patch or the command is parsed once
+ * @returns The reply before a call, `"recorded"` after a search, else null
+ */
+export declare function codexSearchGate(event: HookInput, options: CodexSearchGateOptions, call?: CodexToolCall): Promise<SearchHookReply | "recorded" | null>;
+//# sourceMappingURL=codex-hook.d.ts.map

package/dist/lib/codex-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-hook.d.ts","sourceRoot":"","sources":["../../lib/codex-hook.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOzD,sGAAsG;AACtG,MAAM,WAAW,aAAa;IAC5B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,yDAAyD;IACzD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gFAAgF;IAChF,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAc7D;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,sFAAsF;IACtF,cAAc,EAAE,MAAM,CAAC;IACvB,+FAA+F;IAC/F,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;IACpE,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,kGAAkG;IAClG,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,yBAAyB;AACzB,eAAO,MAAM,sBAAsB,EAAE,sBAUpC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,sBAAsB,EAC/B,IAAI,GAAE,aAAoC,GACzC,OAAO,CAAC,eAAe,GAAG,UAAU,GAAG,IAAI,CAAC,CA6B9C"}

package/dist/lib/codex-hook.js

@@ -0,0 +1,94 @@
+import { readFile } from "node:fs/promises";
+import { existsSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { patchFiles, shellReadPaths } from "./codex-tools.js";
+import { writtenPaths } from "./bash-writes.js";
+import { SEARCH_TOOLS, searchedInTranscript } from "./transcript.js";
+import { GATE_TEXT, READ_TEXT, isExampleCorpusRead } from "./search-guidance.js";
+/**
+ * What a Codex tool call touches.
+ *
+ * @param event - The hook's event
+ * @returns The files, command and patch of the call
+ */
+export function codexToolCall(event) {
+    const cwd = event.cwd || process.cwd();
+    const input = event.tool_input ?? {};
+    const command = typeof input.command === 'string' ? input.command : typeof input['cmd'] === 'string' ? input['cmd'] : '';
+    const tool = event.tool_name ?? '';
+    const patches = tool === 'apply_patch' ? patchFiles(command, cwd) : [];
+    const shell = ['Bash', 'exec_command', 'shell_command'].includes(tool);
+    const filePath = typeof input.file_path === 'string' ? resolve(cwd, input.file_path) : undefined;
+    const paths = [...new Set([
+            ...patches.filter(p => !p.deleted).map(p => p.path),
+            ...(shell ? [...writtenPaths(command, cwd), ...shellReadPaths(command, cwd)] : []),
+            ...(filePath ? [filePath] : []),
+        ])];
+    return { tool, command, shell, patches, filePath, paths };
+}
+/** East's Codex gate. */
+export const EAST_CODEX_SEARCH_GATE = {
+    searchTools: SEARCH_TOOLS,
+    searchToolName: /__(?:search_east_examples|get_east_example)$/,
+    gateText: GATE_TEXT,
+    readText: READ_TEXT,
+    isCorpusRead: isExampleCorpusRead,
+    shellSweep: /node_modules\/@elaraai(?:\/|\b)|\.examples\.tsx?/,
+    corpusCode: /@elaraai\/east|(?:from|import)\s+east\b/,
+    markerPrefix: "east-codex-search-",
+    requireSearchEnv: "EAST_REQUIRE_SEARCH",
+};
+/**
+ * The search-first gate for a Codex tool call. After a successful search or
+ * fetch it records the search (`"recorded"`) — the stable hook event, not the
+ * transcript's undocumented wire format. Before a call, it reminds a read of
+ * the corpus, and gives a write of corpus code with no search on record the
+ * instruction to search first: a reminder, or a refusal when the options'
+ * environment variable is `deny`.
+ *
+ * @param event - The hook's event
+ * @param options - The gate's configuration
+ * @param call - What the call touches, when the hook has read it already for
+ *   its own use, so the patch or the command is parsed once
+ * @returns The reply before a call, `"recorded"` after a search, else null
+ */
+export async function codexSearchGate(event, options, call = codexToolCall(event)) {
+    const input = event.tool_input ?? {};
+    const marker = join(tmpdir(), options.markerPrefix + createHash('sha256').update(event.session_id ?? '').digest('hex'));
+    if (event.hook_event_name === 'PostToolUse') {
+        if (call.tool.startsWith('mcp__') && options.searchToolName.test(call.tool)) {
+            if (event.tool_response?.['isError'] !== true)
+                writeFileSync(marker, 'searched');
+            return 'recorded';
+        }
+        return null;
+    }
+    const context = [];
+    if (options.isCorpusRead(call.tool, input) || (call.shell && options.shellSweep.test(call.command))) {
+        context.push(options.readText);
+    }
+    const writes = call.tool === 'apply_patch' ? call.patches.filter(p => !p.deleted) :
+        call.shell ? writtenPaths(call.command, event.cwd || process.cwd()).map(path => ({ path, originalPath: path, code: call.command })) :
+            call.filePath && ['Edit', 'Write'].includes(call.tool) ? [{ path: call.filePath, originalPath: call.filePath, code: input.content ?? input.new_string ?? '' }] : [];
+    let corpusWrite = false;
+    for (const file of writes) {
+        if (!/\.(tsx?|js|py)$/.test(file.path))
+            continue;
+        let old = '';
+        try {
+            old = await readFile(file.originalPath, 'utf8');
+        }
+        catch { /* new file */ }
+        if (options.corpusCode.test(old + '\n' + file.code))
+            corpusWrite = true;
+    }
+    if (corpusWrite && !existsSync(marker) && !(event.transcript_path && await searchedInTranscript(event.transcript_path, options.searchTools))) {
+        if (process.env[options.requireSearchEnv] === 'deny')
+            return { decision: 'deny', text: options.gateText };
+        context.push(options.gateText);
+    }
+    return context.length > 0 ? { decision: 'context', text: context.join('\n\n') } : null;
+}
+//# sourceMappingURL=codex-hook.js.map

package/dist/lib/codex-hook.js.map

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

package/dist/lib/codex-skills.d.ts

@@ -0,0 +1,38 @@
+/** The names a skill is adapted between. */
+export interface SkillNames {
+    /** The Claude Code MCP prefix of the plugin's tools, which Codex drops (`mcp__plugin_east_east__`). */
+    claudeToolPrefix: string;
+    /** How Claude Code names the plugin's skills (`/east:`). */
+    claudeSkillPrefix: string;
+    /** How Codex names them (`$east-codex-plugin:`). */
+    codexSkillPrefix: string;
+    /** The Claude Code plugin's name (`east-claude-plugin`). */
+    claudePlugin: string;
+    /** The Codex plugin's name (`east-codex-plugin`). */
+    codexPlugin: string;
+}
+/** East's names. */
+export declare const EAST_SKILL_NAMES: SkillNames;
+/**
+ * A skill's text adapted for Codex: the names, the words, and a description
+ * Codex takes — at most 1024 characters with no angle brackets, the whole of
+ * a longer or bracketed one kept in the body.
+ *
+ * @param text - The SKILL.md as written for Claude Code
+ * @param names - The names it is adapted between (default East's)
+ * @returns The SKILL.md for Codex
+ * @throws {Error} When the skill has no frontmatter
+ */
+export declare function adaptSkill(text: string, names?: SkillNames): string;
+/**
+ * Writes a Codex plugin's skills as real files: every skill directory under
+ * `sources`, its Markdown adapted and every other file copied through any
+ * symlink.
+ *
+ * @param sources - The directory of skill directories, as written for Claude Code
+ * @param target - The Codex plugin's `skills` directory
+ * @param names - The names they are adapted between (default East's)
+ * @returns The skills written, by directory name
+ */
+export declare function materializeSkills(sources: string, target: string, names?: SkillNames): Promise<string[]>;
+//# sourceMappingURL=codex-skills.d.ts.map

package/dist/lib/codex-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-skills.d.ts","sourceRoot":"","sources":["../../lib/codex-skills.ts"],"names":[],"mappings":"AASA,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,uGAAuG;IACvG,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,gBAAgB,EAAE,MAAM,CAAC;IACzB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,oBAAoB;AACpB,eAAO,MAAM,gBAAgB,EAAE,UAM9B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,UAA6B,GAAG,MAAM,CA0BrF;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,UAA6B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBhI"}

package/dist/lib/codex-skills.js

@@ -0,0 +1,80 @@
+import { readdir, readFile, mkdir, writeFile, cp } from "node:fs/promises";
+import { join } from "node:path";
+/** East's names. */
+export const EAST_SKILL_NAMES = {
+    claudeToolPrefix: "mcp__plugin_east_east__",
+    claudeSkillPrefix: "/east:",
+    codexSkillPrefix: "$east-codex-plugin:",
+    claudePlugin: "east-claude-plugin",
+    codexPlugin: "east-codex-plugin",
+};
+/**
+ * A skill's text adapted for Codex: the names, the words, and a description
+ * Codex takes — at most 1024 characters with no angle brackets, the whole of
+ * a longer or bracketed one kept in the body.
+ *
+ * @param text - The SKILL.md as written for Claude Code
+ * @param names - The names it is adapted between (default East's)
+ * @returns The SKILL.md for Codex
+ * @throws {Error} When the skill has no frontmatter
+ */
+export function adaptSkill(text, names = EAST_SKILL_NAMES) {
+    text = text.replaceAll(names.claudeToolPrefix, '')
+        .replaceAll(names.claudeSkillPrefix, names.codexSkillPrefix)
+        .replaceAll(names.claudePlugin, names.codexPlugin)
+        .replaceAll('Claude Code', 'Codex')
+        .replaceAll("the Claude plugin's language server", "the Codex plugin's LSP bridge and hooks")
+        .replaceAll('the Claude plugin LSP', 'the Codex plugin diagnostic hooks and LSP bridge')
+        .replaceAll('Claude plugin', 'Codex plugin')
+        .replaceAll('Generated-with-Claude-Code', 'Generated-with-Codex')
+        .replace(/End every commit with the trailer:\n\s*`Co-Authored-By: Claude[^`]+`/, 'Use the repository attribution policy for the actual contributing agent.')
+        .replaceAll('${CLAUDE_PLUGIN_ROOT}', '${PLUGIN_ROOT}');
+    const frontmatter = /^(---\r?\n)([\s\S]*?)(\r?\n---\r?\n)/.exec(text);
+    if (!frontmatter)
+        throw new Error('Missing skill frontmatter');
+    let details = '';
+    const metadata = frontmatter[2].replace(/^description: (.+)$/m, (_line, value) => {
+        // The shared skill catalog uses JSON-compatible double-quoted YAML strings.
+        const original = JSON.parse(value);
+        let description = original.replaceAll('<', '(').replaceAll('>', ')');
+        if (description.length > 1024) {
+            description = description.slice(0, 940).replace(/\s+\S*$/, '') + '… See the detailed scope below.';
+        }
+        if (description !== original)
+            details = `\n## Detailed skill scope\n\n${original}\n`;
+        return 'description: ' + JSON.stringify(description);
+    });
+    // Preserve all discovery detail in the body, including text too long for metadata.
+    return frontmatter[1] + metadata + frontmatter[3] + details + text.slice(frontmatter[0].length);
+}
+/**
+ * Writes a Codex plugin's skills as real files: every skill directory under
+ * `sources`, its Markdown adapted and every other file copied through any
+ * symlink.
+ *
+ * @param sources - The directory of skill directories, as written for Claude Code
+ * @param target - The Codex plugin's `skills` directory
+ * @param names - The names they are adapted between (default East's)
+ * @returns The skills written, by directory name
+ */
+export async function materializeSkills(sources, target, names = EAST_SKILL_NAMES) {
+    const written = [];
+    for (const entry of await readdir(sources, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const source = join(sources, entry.name);
+        const skill = join(target, entry.name);
+        await mkdir(skill, { recursive: true });
+        for (const file of await readdir(source, { withFileTypes: true })) {
+            const input = join(source, file.name);
+            const output = join(skill, file.name);
+            if (file.name.endsWith('.md'))
+                await writeFile(output, adaptSkill(await readFile(input, 'utf8'), names));
+            else
+                await cp(input, output, { recursive: true, dereference: true });
+        }
+        written.push(entry.name);
+    }
+    return written;
+}
+//# sourceMappingURL=codex-skills.js.map

package/dist/lib/codex-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-skills.js","sourceRoot":"","sources":["../../lib/codex-skills.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAsBjC,oBAAoB;AACpB,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,gBAAgB,EAAE,yBAAyB;IAC3C,iBAAiB,EAAE,QAAQ;IAC3B,gBAAgB,EAAE,qBAAqB;IACvC,YAAY,EAAE,oBAAoB;IAClC,WAAW,EAAE,mBAAmB;CACjC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAoB,gBAAgB;IAC3E,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC/C,UAAU,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,gBAAgB,CAAC;SAC3D,UAAU,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,WAAW,CAAC;SACjD,UAAU,CAAC,aAAa,EAAE,OAAO,CAAC;SAClC,UAAU,CAAC,qCAAqC,EAAE,yCAAyC,CAAC;SAC5F,UAAU,CAAC,uBAAuB,EAAE,kDAAkD,CAAC;SACvF,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC;SAC3C,UAAU,CAAC,4BAA4B,EAAE,sBAAsB,CAAC;SAChE,OAAO,CAAC,sEAAsE,EAAE,0EAA0E,CAAC;SAC3J,UAAU,CAAC,uBAAuB,EAAE,gBAAgB,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,sCAAsC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/D,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;QACxF,4EAA4E;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAW,CAAC;QAC7C,IAAI,WAAW,GAAG,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrE,IAAI,WAAW,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;YAC9B,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,iCAAiC,CAAC;QACrG,CAAC;QACD,IAAI,WAAW,KAAK,QAAQ;YAAE,OAAO,GAAG,gCAAgC,QAAQ,IAAI,CAAC;QACrF,OAAO,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IACH,mFAAmF;IACnF,OAAO,WAAW,CAAC,CAAC,CAAE,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAE,GAAG,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACpG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe,EAAE,MAAc,EAAE,QAAoB,gBAAgB;IAC3G,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACpE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACxC,KAAK,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,MAAM,SAAS,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;;gBACpG,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/lib/codex-tools.d.ts

@@ -0,0 +1,11 @@
+export interface PatchFile {
+    path: string;
+    code: string;
+    deleted: boolean;
+    originalPath: string;
+}
+/** Extract file boundaries and added/context text from Codex's apply_patch input. */
+export declare function patchFiles(command: string, cwd: string): PatchFile[];
+/** Concrete source paths in ordinary shell reads. No glob expansion or shell execution. */
+export declare function shellReadPaths(command: string, cwd: string): string[];
+//# sourceMappingURL=codex-tools.d.ts.map

package/dist/lib/codex-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-tools.d.ts","sourceRoot":"","sources":["../../lib/codex-tools.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE;AACjG,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,CAgBpE;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAYrE"}

package/dist/lib/codex-tools.js

@@ -0,0 +1,41 @@
+import { resolve } from "node:path";
+/** Extract file boundaries and added/context text from Codex's apply_patch input. */
+export function patchFiles(command, cwd) {
+    const files = [];
+    let current;
+    for (const line of command.split(/\r?\n/)) {
+        const header = /^\*\*\* (Add|Update|Delete) File: (.+)$/.exec(line);
+        if (header) {
+            const path = resolve(cwd, header[2]);
+            current = { path, originalPath: path, code: "", deleted: header[1] === "Delete" };
+            files.push(current);
+        }
+        else if (line.startsWith('*** Move to: ') && current) {
+            current.path = resolve(cwd, line.slice(13));
+        }
+        else if (current && (line.startsWith('+') || line.startsWith(' '))) {
+            current.code += line.slice(1) + '\n';
+        }
+    }
+    return files;
+}
+/** Concrete source paths in ordinary shell reads. No glob expansion or shell execution. */
+export function shellReadPaths(command, cwd) {
+    const paths = new Set();
+    let dir = cwd;
+    for (const segment of command.split(/&&|;|\n|\|/)) {
+        const tokens = [...segment.matchAll(/"([^"\n]*)"|'([^'\n]*)'|([^\s]+)/g)].map(m => m[1] ?? m[2] ?? m[3]);
+        if (tokens[0] === 'cd' && tokens[1]) {
+            dir = resolve(dir, tokens[1]);
+            continue;
+        }
+        if (!['cat', 'head', 'tail', 'sed', 'rg', 'grep', 'less', 'more'].includes(tokens[0] ?? ''))
+            continue;
+        for (const token of tokens.slice(1)) {
+            if (!token.startsWith('-') && !/[*?$`]/.test(token) && /\.(tsx?|js|py)$/.test(token))
+                paths.add(resolve(dir, token));
+        }
+    }
+    return [...paths];
+}
+//# sourceMappingURL=codex-tools.js.map

package/dist/lib/codex-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-tools.js","sourceRoot":"","sources":["../../lib/codex-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,qFAAqF;AACrF,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,GAAW;IACrD,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,IAAI,OAA8B,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,yCAAyC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC;YACtC,OAAO,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAClF,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,IAAI,OAAO,EAAE,CAAC;YACvD,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACrE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACvC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,GAAW;IACzD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,mCAAmC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QAC1G,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACjF,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,SAAS;QACtG,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACvH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/dist/lib/diagnostics-client.d.ts

@@ -0,0 +1,9 @@
+/** Fire-and-forget: ensure a daemon is running for this workspace so the first
+ * edit doesn't pay process-spawn latency. Probes the socket and only spawns if
+ * nothing is listening (so a live daemon is never disrupted). */
+export declare function warmDaemon(workspace: string): void;
+/** Get the `<east-code-review>` text for `file` from the daemon (lazily
+ * spawning it if absent). Returns `""` when clean and `null` when the daemon
+ * could not be reached within `budgetMs` — callers degrade to a silent no-op. */
+export declare function getDiagnosticsText(workspace: string, file: string, budgetMs?: number): Promise<string | null>;
+//# sourceMappingURL=diagnostics-client.d.ts.map

package/dist/lib/diagnostics-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-client.d.ts","sourceRoot":"","sources":["../../lib/diagnostics-client.ts"],"names":[],"mappings":"AA8EA;;iEAEiE;AACjE,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAiBlD;AAED;;iFAEiF;AACjF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAO,GACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwBxB"}

package/dist/lib/diagnostics-client.js

@@ -0,0 +1,123 @@
+import { createConnection } from "node:net";
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { tmpdir } from "node:os";
+import { existsSync, unlinkSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+// One resident daemon per installed plugin version, keyed on the bundled daemon
+// path (which lives under the versioned plugin cache dir) — NOT the workspace.
+// It serves every project: createDiagnosticsService caches a LanguageService per
+// tsconfig, so each project cold-loads once and then stays warm. This avoids
+// per-directory daemon churn, and a new plugin version spawns a fresh daemon
+// instead of reusing a stale one.
+function daemonSocket() {
+    const hash = createHash("sha1").update(daemonEntry()).digest("hex").slice(0, 16);
+    return join(tmpdir(), `east-diag-${hash}.sock`);
+}
+// Inlined by esbuild into .build/hooks/diagnose.js, so import.meta.url is that
+// path: .build/hooks → up one to .build, then daemon/server.js.
+function daemonEntry() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), "..", "daemon", "server.js");
+}
+function tryRequest(socketPath, file, timeoutMs) {
+    return new Promise((resolveResult) => {
+        const conn = createConnection(socketPath);
+        let buffer = "";
+        let settled = false;
+        const settle = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            conn.destroy();
+            resolveResult(result);
+        };
+        const timer = setTimeout(() => settle({ kind: "timeout" }), timeoutMs);
+        timer.unref();
+        conn.on("connect", () => conn.write(`${JSON.stringify({ file })}\n`));
+        conn.on("data", (chunk) => {
+            buffer += chunk.toString("utf8");
+            const newline = buffer.indexOf("\n");
+            if (newline < 0)
+                return;
+            try {
+                const response = JSON.parse(buffer.slice(0, newline));
+                settle(response.ok === true ? { kind: "text", text: response.text ?? "" } : { kind: "error" });
+            }
+            catch {
+                settle({ kind: "error" });
+            }
+        });
+        conn.on("error", (err) => {
+            settle(err.code === "ECONNREFUSED" || err.code === "ENOENT" ? { kind: "refused" } : { kind: "error" });
+        });
+    });
+}
+function spawnDaemon(socketPath, workspace) {
+    const entry = daemonEntry();
+    if (!existsSync(entry))
+        return;
+    try {
+        spawn(process.execPath, [entry], {
+            detached: true,
+            stdio: "ignore",
+            env: { ...process.env, EAST_DIAG_SOCKET: socketPath, EAST_DIAG_CWD: workspace },
+        }).unref();
+    }
+    catch {
+        /* ignore */
+    }
+}
+/** Fire-and-forget: ensure a daemon is running for this workspace so the first
+ * edit doesn't pay process-spawn latency. Probes the socket and only spawns if
+ * nothing is listening (so a live daemon is never disrupted). */
+export function warmDaemon(workspace) {
+    const socketPath = daemonSocket();
+    const conn = createConnection(socketPath);
+    conn.on("connect", () => conn.destroy());
+    conn.on("error", (err) => {
+        conn.destroy();
+        if (err.code === "ECONNREFUSED" || err.code === "ENOENT") {
+            if (existsSync(socketPath)) {
+                try {
+                    unlinkSync(socketPath);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            spawnDaemon(socketPath, workspace);
+        }
+    });
+}
+/** Get the `<east-code-review>` text for `file` from the daemon (lazily
+ * spawning it if absent). Returns `""` when clean and `null` when the daemon
+ * could not be reached within `budgetMs` — callers degrade to a silent no-op. */
+export async function getDiagnosticsText(workspace, file, budgetMs = 4000) {
+    const socketPath = daemonSocket();
+    const deadline = Date.now() + budgetMs;
+    let spawned = false;
+    while (Date.now() < deadline) {
+        const attempt = await tryRequest(socketPath, file, Math.min(1500, deadline - Date.now()));
+        if (attempt.kind === "text")
+            return attempt.text;
+        if (attempt.kind === "refused" && !spawned) {
+            // No live daemon: clear any stale socket file, then spawn one.
+            if (existsSync(socketPath)) {
+                try {
+                    unlinkSync(socketPath);
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+            spawnDaemon(socketPath, workspace);
+            spawned = true;
+        }
+        // refused-after-spawn (still starting) or timeout (warming): wait and retry.
+        await new Promise((r) => setTimeout(r, 200));
+    }
+    return null;
+}
+//# sourceMappingURL=diagnostics-client.js.map

package/dist/lib/diagnostics-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-client.js","sourceRoot":"","sources":["../../lib/diagnostics-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQzC,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,6EAA6E;AAC7E,6EAA6E;AAC7E,kCAAkC;AAClC,SAAS,YAAY;IACnB,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,IAAI,CAAC,MAAM,EAAE,EAAE,aAAa,IAAI,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,+EAA+E;AAC/E,gEAAgE;AAChE,SAAS,WAAW;IAClB,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB,EAAE,IAAY,EAAE,SAAiB;IACrE,OAAO,IAAI,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;QACnC,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,MAAqB,EAAQ,EAAE;YAC7C,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,aAAa,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACvE,KAAK,CAAC,KAAK,EAAE,CAAC;QAEd,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAChC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO;YACxB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAoC,CAAC;gBACzF,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACjG,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAC9C,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,UAAkB,EAAE,SAAiB;IACxD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO;IAC/B,IAAI,CAAC;QACH,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE;YAC/B,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,QAAQ;YACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,gBAAgB,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE;SAChF,CAAC,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,YAAY;IACd,CAAC;AACH,CAAC;AAED;;iEAEiE;AACjE,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;QAC9C,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACzD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,UAAU,CAAC,UAAU,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;YACD,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;iFAEiF;AACjF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,IAAY,EACZ,QAAQ,GAAG,IAAI;IAEf,MAAM,UAAU,GAAG,YAAY,EAAE,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC;IACvC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1F,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,OAAO,CAAC,IAAI,CAAC;QACjD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3C,+DAA+D;YAC/D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,UAAU,CAAC,UAAU,CAAC,CAAC;gBACzB,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY;gBACd,CAAC;YACH,CAAC;YACD,WAAW,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YACnC,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,6EAA6E;QAC7E,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/east-index.d.ts

@@ -0,0 +1,3 @@
+/** The path of East's `index.json` in the installed `@elaraai/east-plugin`. */
+export declare const EAST_INDEX_PATH: string;
+//# sourceMappingURL=east-index.d.ts.map

package/dist/lib/east-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"east-index.d.ts","sourceRoot":"","sources":["../../lib/east-index.ts"],"names":[],"mappings":"AAQA,+EAA+E;AAC/E,eAAO,MAAM,eAAe,EAAE,MAAoE,CAAC"}

package/dist/lib/east-index.js

@@ -0,0 +1,9 @@
+import { fileURLToPath } from "node:url";
+// East's own example index as the published package ships it: `index.json` at
+// the package root, two directories above this module's `dist/lib/`. A plugin
+// that builds on East's serves it beside its own corpus (`loadIndexes`), or
+// copies it into its bundle at build time, as East's plugins do — a bundled
+// module no longer sits where this path is reckoned from.
+/** The path of East's `index.json` in the installed `@elaraai/east-plugin`. */
+export const EAST_INDEX_PATH = fileURLToPath(new URL("../../index.json", import.meta.url));
+//# sourceMappingURL=east-index.js.map

package/dist/lib/east-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"east-index.js","sourceRoot":"","sources":["../../lib/east-index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,4EAA4E;AAC5E,0DAA0D;AAE1D,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAW,aAAa,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/lib/east-project.d.ts

@@ -0,0 +1,49 @@
+/** Which language(s) an East project is authored in. A project may be both. */
+export type EastLanguage = "typescript" | "python";
+interface PackageJson {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}
+export declare function findPackageJson(startDir: string): Promise<PackageJson | null>;
+/**
+ * The `pyproject.toml` that governs `startDir`, as text: the nearest one at
+ * or above it that depends on an east-py distribution, else the nearest one
+ * at all. A uv workspace member has its own pyproject — that is what makes it
+ * a member — and it usually says nothing about East, so stopping at the first
+ * file found would call every member a non-East project while the root
+ * declares otherwise; the walk continues past a pyproject that does not
+ * mention east-py (the same rule `east.diagnostics.config` applies).
+ *
+ * `uv.lock` is deliberately NOT read. This runs on a hot path — every session
+ * start, every subagent start, every gated write, and every reviewed file — and
+ * a lockfile is large (~1 MB in this repo), so reading one per call to
+ * substring-match it was real work repeated constantly. It was also wrong:
+ * a lockfile lists TRANSITIVE resolutions, so a TypeScript-only project that
+ * merely resolved an East distribution somewhere in its graph was reported as
+ * a python East project and handed the python cheat-sheet. A project that
+ * authors East in python declares it in a `pyproject.toml` of its own.
+ */
+export declare function findPyProject(startDir: string): Promise<string | null>;
+export declare function detectEastSkills(pkg: PackageJson | null): string[];
+/** The east-py skills a pyproject.toml text depends on. */
+export declare function detectPythonSkills(pyproject: string | null): string[];
+export interface EastProjectInfo {
+    isEast: boolean;
+    skills: string[];
+    /** The language(s) detected — drives which rule cheat-sheet an agent is given. */
+    languages: EastLanguage[];
+    pkg: PackageJson | null;
+}
+/**
+ * What kind of East project `cwd` sits in.
+ *
+ * Both ecosystems count. A project whose East dependency is declared only in
+ * `pyproject.toml` — no package.json anywhere — is an East project, and used
+ * to report `isEast: false`, so the session and subagent hooks injected
+ * nothing at all for it: no skill list, no rule cheat-sheet. (The diagnose and
+ * pre-write hooks never consulted this, gating on an `import east` instead,
+ * which is why diagnostics worked there while orientation did not.)
+ */
+export declare function getEastProjectInfo(cwd: string): Promise<EastProjectInfo>;
+export {};
+//# sourceMappingURL=east-project.d.ts.map

package/dist/lib/east-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"east-project.d.ts","sourceRoot":"","sources":["../../lib/east-project.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;AAsBnD,UAAU,WAAW;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAYnF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAe5E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,EAAE,CAalE;AAED,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAOrE;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,kFAAkF;IAClF,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAS9E"}