@elaraai/east-plugin 0.0.0-stage → 1.0.85

package/dist/lib/plugin-status.d.ts

@@ -0,0 +1,9 @@
+export interface FeatureCheck {
+    name: string;
+    status: "ok" | "warn" | "fail";
+    detail: string;
+}
+/** Inspect the installed plugin + the current project; never throws. */
+export declare function checkPluginStatus(pluginRoot: string, cwd: string): Promise<FeatureCheck[]>;
+export declare function formatStatus(checks: FeatureCheck[]): string;
+//# sourceMappingURL=plugin-status.d.ts.map

package/dist/lib/plugin-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-status.d.ts","sourceRoot":"","sources":["../../lib/plugin-status.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AA2CD,wEAAwE;AACxE,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgHhG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAM3D"}

package/dist/lib/plugin-status.js

@@ -0,0 +1,164 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join, resolve } from "node:path";
+import { buildSearchIndex } from "./search.js";
+import { getEastProjectInfo } from "./east-project.js";
+import { execFile } from "node:child_process";
+import { findEastPy } from "@elaraai/east-diagnostics";
+const ICON = { ok: "✓", warn: "⚠", fail: "✗" };
+function check(name, fn) {
+    return Promise.resolve()
+        .then(fn)
+        .catch((e) => ({ name, status: "fail", detail: `check errored: ${String(e).slice(0, 100)}` }));
+}
+function resolves(fromDir, spec) {
+    try {
+        // Absolute base so module resolution works even when given a relative cwd.
+        return createRequire(resolve(fromDir, "_.js")).resolve(spec);
+    }
+    catch {
+        return undefined;
+    }
+}
+function nearestTsconfig(fromDir) {
+    let dir = resolve(fromDir);
+    for (;;) {
+        const candidate = join(dir, "tsconfig.json");
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+const BUNDLED = [
+    ".build/hooks/session-start.js",
+    ".build/hooks/subagent-start.js",
+    ".build/hooks/pre-write.js",
+    ".build/hooks/pre-read.js",
+    ".build/hooks/diagnose.js",
+    ".build/hooks/diagnose-bash.js",
+    ".build/daemon/server.js",
+    ".build/daemon/lsp.js",
+    ".build/daemon/east-py-lsp.js",
+    ".build/mcp/server.js",
+];
+/** Inspect the installed plugin + the current project; never throws. */
+export async function checkPluginStatus(pluginRoot, cwd) {
+    const checks = [];
+    checks.push(await check("Plugin", () => {
+        const pkg = JSON.parse(readFileSync(join(pluginRoot, existsSync(join(pluginRoot, ".codex-plugin")) ? ".codex-plugin" : ".claude-plugin", "plugin.json"), "utf8"));
+        return { name: "Plugin", status: "ok", detail: `version ${pkg.version ?? "?"} (${pluginRoot})` };
+    }));
+    checks.push(await check("Bundled artifacts", () => {
+        const artifacts = existsSync(join(pluginRoot, ".codex-plugin")) ? [...BUNDLED, ".build/hooks/codex-tools.js"] : BUNDLED;
+        const missing = artifacts.filter((a) => !existsSync(join(pluginRoot, a)));
+        return missing.length === 0
+            ? { name: "Bundled artifacts", status: "ok", detail: `all ${artifacts.length} hook/daemon/MCP bundles present` }
+            : { name: "Bundled artifacts", status: "fail", detail: `missing ${missing.length}: ${missing.join(", ")}` };
+    }));
+    checks.push(await check("Hook configuration", () => {
+        const json = JSON.parse(readFileSync(join(pluginRoot, "hooks", "hooks.json"), "utf8"));
+        const events = Object.keys(json.hooks ?? {});
+        const diagnoseWired = /diagnose\.js|codex-tools\.js/.test(JSON.stringify(json.hooks ?? {}));
+        return {
+            name: "Hook configuration",
+            status: diagnoseWired ? "ok" : "warn",
+            detail: diagnoseWired
+                ? `${events.length} events: ${events.join(", ")}`
+                : `${events.join(", ")} — PostToolUse is NOT wired to diagnose.js (stale install?)`,
+        };
+    }));
+    checks.push(await check("Example search", async () => {
+        const indexPath = join(pluginRoot, "index.json");
+        const data = JSON.parse(readFileSync(indexPath, "utf8"));
+        const entries = data.entries ?? [];
+        const programs = entries.filter((e) => e.ir !== undefined);
+        const python = programs.filter((e) => typeof e.python === "string").length;
+        const index = await buildSearchIndex(indexPath);
+        const hits = index.search("array map", { limit: 3 });
+        const ok = entries.length > 0 && hits.length > 0 && programs.length > 0 && python === programs.length;
+        return {
+            name: "Example search (index + MCP)",
+            status: ok ? "ok" : "warn",
+            detail: `${entries.length} examples indexed, ${programs.length} as IR (${python} with a python rendering); sample query → ${hits.length} hits`,
+        };
+    }));
+    checks.push(await check("Skills", () => {
+        const dirs = readdirSync(join(pluginRoot, "skills"), { withFileTypes: true })
+            .filter((d) => d.isDirectory() && existsSync(join(pluginRoot, "skills", d.name, "SKILL.md")))
+            .map((d) => d.name);
+        return { name: "Skills", status: dirs.length > 0 ? "ok" : "warn", detail: `${dirs.length}: ${dirs.join(", ")}` };
+    }));
+    checks.push(await check("East project (cwd)", async () => {
+        const { isEast, skills } = await getEastProjectInfo(cwd);
+        return {
+            name: "East project (cwd)",
+            status: isEast ? "ok" : "warn",
+            detail: isEast ? `detected: ${skills.join(", ")}` : `${cwd} is not an East project — hooks stay idle here (expected outside East projects)`,
+        };
+    }));
+    checks.push(await check("Diagnostics (python / east-py)", async () => {
+        // Without this check a missing east-py is INVISIBLE: runEastPyLint returns
+        // null, every python file silently gets no review, and the rest of this
+        // report stays green. Two questions: do the rules answer, and can the warm
+        // server (`east-py lsp`, the build tier's home) start.
+        const command = findEastPy(cwd);
+        const run = (args) => new Promise((done) => {
+            execFile(command, args, { timeout: 8000, encoding: "utf-8" }, (error, stdout, stderr) => {
+                done({ ok: error === null, stdout: String(stdout), stderr: String(stderr) });
+            });
+        });
+        const listed = await run(["lint", "--list-rules"]);
+        if (!listed.ok) {
+            return {
+                name: "Diagnostics (python / east-py)",
+                status: "warn",
+                detail: `\`${command}\` did not answer — python East files get NO review until east-py resolves (a project .venv above the file, east-py on PATH, or EAST_PY_LINT)`,
+            };
+        }
+        const rules = listed.stdout.split("\n").filter((l) => l.startsWith("EAS")).length;
+        const probe = await run(["lsp", "--probe"]);
+        return probe.ok
+            ? { name: "Diagnostics (python / east-py)", status: "ok", detail: `${command} — ${rules} rules; ${probe.stdout.trim()} (warm server + build tier)` }
+            : {
+                name: "Diagnostics (python / east-py)",
+                status: "warn",
+                detail: `${command} — ${rules} rules, but \`east-py lsp\` cannot start (${probe.stderr.trim().split("\n")[0] ?? "no reason given"}): the rules still run per change, the build tier is off`,
+            };
+    }));
+    checks.push(await check("Diagnostics (PostToolUse daemon)", () => {
+        const parts = [];
+        let status = "ok";
+        const tsOk = resolves(cwd, "typescript") !== undefined;
+        parts.push(tsOk ? "typescript resolvable" : "typescript NOT resolvable");
+        if (!tsOk)
+            status = "warn";
+        const tsconfig = nearestTsconfig(cwd) !== undefined;
+        parts.push(tsconfig ? "tsconfig found" : "no tsconfig near cwd");
+        if (!tsconfig)
+            status = "warn";
+        const eastOk = resolves(cwd, "@elaraai/east") !== undefined;
+        parts.push(eastOk ? "@elaraai/east resolvable (built)" : "@elaraai/east not resolvable/built");
+        const daemonOk = existsSync(join(pluginRoot, ".build/daemon/server.js"));
+        if (!daemonOk) {
+            parts.push("daemon bundle MISSING");
+            status = "fail";
+        }
+        return {
+            name: "Diagnostics (PostToolUse daemon)",
+            status,
+            detail: `${parts.join("; ")} — ${status === "ok" ? "ready" : status === "fail" ? "broken" : "limited (prereqs missing)"}`,
+        };
+    }));
+    return checks;
+}
+export function formatStatus(checks) {
+    const anyFail = checks.some((c) => c.status === "fail");
+    const anyWarn = checks.some((c) => c.status === "warn");
+    const header = anyFail ? "East plugin status — ISSUES" : anyWarn ? "East plugin status — OK (with notes)" : "East plugin status — OK";
+    const lines = checks.map((c) => `- ${ICON[c.status]} **${c.name}**: ${c.detail}`);
+    return [`## ${header}`, "", ...lines].join("\n");
+}
+//# sourceMappingURL=plugin-status.js.map

package/dist/lib/plugin-status.js.map

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

package/dist/lib/review.d.ts

@@ -0,0 +1,16 @@
+/** Whether the plugin reviews this path at all, by extension and location. */
+export declare function reviewable(filePath: string): boolean;
+/**
+ * The `<east-code-review>` text for one file.
+ *
+ * `""` when the file is clean, `null` when it is not East source, not
+ * reviewable, or no reviewer answered within budget — a transient miss must
+ * stay silent AND stay un-deduped so a retry can succeed.
+ *
+ * Reviews each distinct file CONTENT once per session: the marker is keyed by
+ * session + path + content hash, so re-reads of unchanged content skip while a
+ * real edit re-fires. That is also what keeps a file written by Bash and then
+ * read from being reviewed twice.
+ */
+export declare function reviewFile(sessionId: string, filePath: string): Promise<string | null>;
+//# sourceMappingURL=review.d.ts.map

package/dist/lib/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../lib/review.ts"],"names":[],"mappings":"AAcA,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwC5F"}

package/dist/lib/review.js

@@ -0,0 +1,74 @@
+import { readFile } from "node:fs/promises";
+import { existsSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { tmpdir } from "node:os";
+import { join, dirname, resolve } from "node:path";
+import { getEastProjectInfo } from "./east-project.js";
+import { getDiagnosticsText } from "./diagnostics-client.js";
+import { getPythonDiagnosticsText } from "./east-py-lint.js";
+import { PYTHON_EAST_IMPORT } from "@elaraai/east-diagnostics";
+const EAST_IMPORT_PATTERN = /@elaraai\/east/;
+// Vendored / built / generated trees: never review code the agent doesn't own.
+const SKIP_PATH = /[/\\](node_modules|dist|build|\.venv|\.git)[/\\]/;
+/** Whether the plugin reviews this path at all, by extension and location. */
+export function reviewable(filePath) {
+    if (SKIP_PATH.test(filePath))
+        return false;
+    return /\.(py|ts|tsx|js)$/.test(filePath);
+}
+/**
+ * The `<east-code-review>` text for one file.
+ *
+ * `""` when the file is clean, `null` when it is not East source, not
+ * reviewable, or no reviewer answered within budget — a transient miss must
+ * stay silent AND stay un-deduped so a retry can succeed.
+ *
+ * Reviews each distinct file CONTENT once per session: the marker is keyed by
+ * session + path + content hash, so re-reads of unchanged content skip while a
+ * real edit re-fires. That is also what keeps a file written by Bash and then
+ * read from being reviewed twice.
+ */
+export async function reviewFile(sessionId, filePath) {
+    if (!reviewable(filePath))
+        return null;
+    const python = filePath.endsWith(".py");
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    if (!(python ? PYTHON_EAST_IMPORT : EAST_IMPORT_PATTERN).test(content))
+        return null;
+    // Resolve the East project from the FILE's location, NOT the session cwd:
+    // Claude is frequently launched from elsewhere while editing a project under
+    // a sibling directory. A python file's project is wherever its `.venv` is.
+    const projectDir = dirname(resolve(filePath));
+    if (!python) {
+        const { isEast } = await getEastProjectInfo(projectDir);
+        if (!isEast)
+            return null;
+    }
+    const key = createHash("sha1")
+        .update(`${sessionId}\0${filePath}\0`)
+        .update(content)
+        .digest("hex")
+        .slice(0, 20);
+    const marker = join(tmpdir(), `east-diag-seen-${key}`);
+    if (existsSync(marker))
+        return null;
+    const text = python
+        ? await getPythonDiagnosticsText(filePath)
+        : await getDiagnosticsText(projectDir, filePath);
+    if (text === null)
+        return null; // transient — don't mark, allow a retry
+    try {
+        writeFileSync(marker, "");
+    }
+    catch {
+        /* best-effort dedupe */
+    }
+    return text;
+}
+//# sourceMappingURL=review.js.map

package/dist/lib/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../lib/review.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AAC7C,+EAA+E;AAC/E,MAAM,SAAS,GAAG,kDAAkD,CAAC;AAErE,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,IAAI,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB,EAAE,QAAgB;IAClE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAExC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpF,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;IAC3B,CAAC;IAED,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC;SAC3B,MAAM,CAAC,GAAG,SAAS,KAAK,QAAQ,IAAI,CAAC;SACrC,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,GAAG,EAAE,CAAC,CAAC;IACvD,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,MAAM;QACjB,CAAC,CAAC,MAAM,wBAAwB,CAAC,QAAQ,CAAC;QAC1C,CAAC,CAAC,MAAM,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,wCAAwC;IAExE,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/search-guidance.d.ts

@@ -0,0 +1,44 @@
+/** The names the search-first guidance speaks in. */
+export interface SearchGuidance {
+    /** The search tool as the agent calls it, e.g. `mcp__plugin_east_east__search_east_examples`. */
+    searchTool: string;
+    /** The fetch tool as the agent calls it, e.g. `mcp__plugin_east_east__get_east_example`. */
+    getTool: string;
+    /** What the code, its packages and its skills are called, e.g. `East`. */
+    corpus: string;
+    /** The npm scope whose installed packages the read reminder watches, e.g. `@elaraai`. */
+    scope: string;
+}
+/** East's names. */
+export declare const EAST_GUIDANCE: SearchGuidance;
+/**
+ * The instruction a write of corpus code meets when no search is on record.
+ *
+ * @param g - The names it speaks in
+ * @returns The gate's text
+ */
+export declare function gateText(g: SearchGuidance): string;
+/**
+ * The reminder a read of the installed packages or the examples gets.
+ *
+ * @param g - The names it speaks in
+ * @returns The reminder's text
+ */
+export declare function readText(g: SearchGuidance): string;
+/**
+ * Whether a Read, Grep or Glob reaches for the example corpus: the installed
+ * packages of `scope` or the `*.examples.ts` files. A project's own grep for
+ * its imports of the scope is not a sweep of the packages, and a read of one
+ * project file is never one.
+ *
+ * @param scope - The npm scope whose installed packages count, e.g. `@elaraai`
+ * @returns The check, over a tool's name and input
+ */
+export declare function corpusReadFor(scope: string): (tool: string, input: Record<string, unknown>) => boolean;
+/** East's gate. */
+export declare const GATE_TEXT: string;
+/** East's read reminder. */
+export declare const READ_TEXT: string;
+/** Whether a Read, Grep or Glob reaches for East's corpus. */
+export declare const isExampleCorpusRead: (tool: string, input: Record<string, unknown>) => boolean;
+//# sourceMappingURL=search-guidance.d.ts.map

package/dist/lib/search-guidance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-guidance.d.ts","sourceRoot":"","sources":["../../lib/search-guidance.ts"],"names":[],"mappings":"AAKA,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,iGAAiG;IACjG,UAAU,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,oBAAoB;AACpB,eAAO,MAAM,aAAa,EAAE,cAK3B,CAAC;AAQF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAQlD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAKlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAatG;AAED,mBAAmB;AACnB,eAAO,MAAM,SAAS,EAAE,MAAgC,CAAC;AAEzD,4BAA4B;AAC5B,eAAO,MAAM,SAAS,EAAE,MAAgC,CAAC;AAEzD,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAA4C,CAAC"}

package/dist/lib/search-guidance.js

@@ -0,0 +1,73 @@
+// The search-first guidance (#654): the gate a write of corpus code meets when
+// no example search is on record, and the reminder a read of the installed
+// packages or the examples gets. Spoken in a plugin's own names, so a plugin
+// that builds on East's gives the same guidance over its own corpus.
+/** East's names. */
+export const EAST_GUIDANCE = {
+    searchTool: "mcp__plugin_east_east__search_east_examples",
+    getTool: "mcp__plugin_east_east__get_east_example",
+    corpus: "East",
+    scope: "@elaraai",
+};
+/** A tool's own name, without the `mcp__<server>__` prefix the agent calls it by. */
+function bare(tool) {
+    const at = tool.lastIndexOf("__");
+    return at < 0 ? tool : tool.slice(at + 2);
+}
+/**
+ * The instruction a write of corpus code meets when no search is on record.
+ *
+ * @param g - The names it speaks in
+ * @returns The gate's text
+ */
+export function gateText(g) {
+    return [
+        `STOP: no ${g.corpus} example search on record in this session, and this is ${g.corpus} code.`,
+        `Before writing or changing ${g.corpus} code, search the tested example index — it is the API reference:`,
+        `1. \`${g.searchTool}\` with what you are about to do (language: "python" for east-py, "typescript" otherwise); summaries come back — id, signature, inputs and result.`,
+        `2. \`${g.getTool}\` for the one or two that match, and pattern your code on them.`,
+        `Do not read node_modules/${g.scope}/** or *.examples.ts files instead: the index is the same corpus, exact and far cheaper. Every ${g.corpus} skill requires this step.`,
+    ].join("\n");
+}
+/**
+ * The reminder a read of the installed packages or the examples gets.
+ *
+ * @param g - The names it speaks in
+ * @returns The reminder's text
+ */
+export function readText(g) {
+    return [
+        `Note: the ${g.corpus} example index is the API reference — \`${g.searchTool}\` (then \`${bare(g.getTool)}\`) returns the same tested programs as the ${g.corpus} packages' examples and type declarations, exact, printed in TypeScript or python, at a fraction of the tokens.`,
+        `Reading \`.d.ts\` signatures or sweeping \`*.examples.ts\` files reliably produces broken ${g.corpus} code that still type-checks: the signatures omit the runtime rules. Search instead, and read a specific file only when the search pointed you at it.`,
+    ].join("\n");
+}
+/**
+ * Whether a Read, Grep or Glob reaches for the example corpus: the installed
+ * packages of `scope` or the `*.examples.ts` files. A project's own grep for
+ * its imports of the scope is not a sweep of the packages, and a read of one
+ * project file is never one.
+ *
+ * @param scope - The npm scope whose installed packages count, e.g. `@elaraai`
+ * @returns The check, over a tool's name and input
+ */
+export function corpusReadFor(scope) {
+    const escaped = scope.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const packagePath = new RegExp(`[/\\\\]node_modules[/\\\\]${escaped}[/\\\\]`);
+    // a pattern that sweeps the packages themselves (`node_modules/@elaraai/**`), as opposed to a project's own grep for its `@elaraai/east` imports
+    const packagePattern = new RegExp(`(^|[/\\\\])node_modules[/\\\\]${escaped}([/\\\\]|$)`);
+    const examplesFile = /\.examples\.tsx?$/;
+    return (tool, input) => {
+        const file = typeof input['file_path'] === 'string' ? input['file_path'] : '';
+        const dir = typeof input['path'] === 'string' ? input['path'] : '';
+        const pattern = typeof input['pattern'] === 'string' ? input['pattern'] : '';
+        return tool === 'Read' ? packagePath.test(file) || examplesFile.test(file)
+            : packagePath.test(dir) || packagePattern.test(pattern) || /\.examples\.tsx?/.test(pattern);
+    };
+}
+/** East's gate. */
+export const GATE_TEXT = gateText(EAST_GUIDANCE);
+/** East's read reminder. */
+export const READ_TEXT = readText(EAST_GUIDANCE);
+/** Whether a Read, Grep or Glob reaches for East's corpus. */
+export const isExampleCorpusRead = corpusReadFor(EAST_GUIDANCE.scope);
+//# sourceMappingURL=search-guidance.js.map

package/dist/lib/search-guidance.js.map

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

package/dist/lib/search-hooks.d.ts

@@ -0,0 +1,75 @@
+import { type HookInput } from "./hook-io.js";
+/** What a search-first hook answers: context given to the agent, or the call refused with its reason. */
+export interface SearchHookReply {
+    decision: "context" | "deny";
+    text: string;
+}
+/** The pre-write gate's configuration. */
+export interface SearchGateOptions {
+    /** The tools whose call counts as a search: the plugin's own and, with the East plugin beside it, East's. */
+    searchTools: readonly string[];
+    /** The instruction the gate gives (`gateText(...)`). */
+    gateText: string;
+    /** Whether a file's code is the corpus's: it imports the corpus's packages. */
+    isCorpusCode(code: string, python: boolean): boolean;
+    /** Whether the project at `cwd` is one the gate applies in; every project when absent. */
+    isProject?(cwd: string, python: boolean): Promise<boolean>;
+    /** The prefix of the per-session marker in the temporary directory that remembers a search seen. */
+    markerPrefix: string;
+    /** The environment variable that makes the gate refuse the write when it is `deny`. */
+    requireSearchEnv: string;
+}
+/** East's gate. */
+export declare const EAST_SEARCH_GATE: SearchGateOptions;
+/**
+ * The pre-write gate's answer to an Edit or Write: the instruction to search
+ * first when it writes corpus code and no search is on record, else nothing. A
+ * reminder, or a refusal when the options' environment variable is `deny`.
+ * Once a search is seen, a per-session marker keeps every later write silent,
+ * so a long transcript is read at most once.
+ *
+ * @param event - The PreToolUse event
+ * @param options - The gate's configuration
+ * @returns The reply, or null when the write passes
+ */
+export declare function preWriteGate(event: HookInput, options: SearchGateOptions): Promise<SearchHookReply | null>;
+/** The read reminder's configuration. */
+export interface ReadReminderOptions {
+    /** The reminder (`readText(...)`). */
+    readText: string;
+    /** Whether a Read, Grep or Glob reaches for the corpus (`corpusReadFor(scope)`). */
+    isCorpusRead(tool: string, input: Record<string, unknown>): boolean;
+}
+/** East's reminder. */
+export declare const EAST_READ_REMINDER: ReadReminderOptions;
+/**
+ * The read reminder's answer to a Read, Grep or Glob: the reminder when it
+ * reaches for the corpus, else nothing. Never a refusal.
+ *
+ * @param event - The PreToolUse event
+ * @param options - The reminder's configuration
+ * @returns The reply, or null
+ */
+export declare function preReadReminder(event: HookInput, options: ReadReminderOptions): SearchHookReply | null;
+/**
+ * Writes a hook's reply to stdout, as the host reads it.
+ *
+ * @param hookEventName - The event the hook answers, e.g. `PreToolUse`
+ * @param reply - The reply
+ */
+export declare function writeSearchHookReply(hookEventName: string, reply: SearchHookReply): void;
+/**
+ * Runs the pre-write gate as a hook: reads the event from stdin, writes the
+ * reply, if any, to stdout.
+ *
+ * @param options - The gate's configuration
+ */
+export declare function runPreWriteGate(options: SearchGateOptions): Promise<void>;
+/**
+ * Runs the read reminder as a hook: reads the event from stdin, writes the
+ * reply, if any, to stdout.
+ *
+ * @param options - The reminder's configuration
+ */
+export declare function runPreReadReminder(options: ReadReminderOptions): Promise<void>;
+//# sourceMappingURL=search-hooks.d.ts.map

package/dist/lib/search-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-hooks.d.ts","sourceRoot":"","sources":["../../lib/search-hooks.ts"],"names":[],"mappings":"AAKA,OAAO,EAAqD,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAWjG,yGAAyG;AACzG,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,6GAA6G;IAC7G,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,+EAA+E;IAC/E,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IACrD,0FAA0F;IAC1F,SAAS,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,oGAAoG;IACpG,YAAY,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,mBAAmB;AACnB,eAAO,MAAM,gBAAgB,EAAE,iBAO9B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAmChH;AAED,yCAAyC;AACzC,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;CACrE;AAED,uBAAuB;AACvB,eAAO,MAAM,kBAAkB,EAAE,mBAAgF,CAAC;AAElH;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,mBAAmB,GAAG,eAAe,GAAG,IAAI,CAEtG;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAGxF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGpF"}

package/dist/lib/search-hooks.js

@@ -0,0 +1,117 @@
+import { readFile } from "node:fs/promises";
+import { existsSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { PYTHON_EAST_IMPORT } from "@elaraai/east-diagnostics";
+import { readHookInput, writeHookDecision, writeHookOutput } from "./hook-io.js";
+import { getEastProjectInfo } from "./east-project.js";
+import { SEARCH_TOOLS, searchedInTranscript } from "./transcript.js";
+import { GATE_TEXT, READ_TEXT, isExampleCorpusRead } from "./search-guidance.js";
+/** East's gate. */
+export const EAST_SEARCH_GATE = {
+    searchTools: SEARCH_TOOLS,
+    gateText: GATE_TEXT,
+    isCorpusCode: (code, python) => (python ? PYTHON_EAST_IMPORT : /@elaraai\/east/).test(code),
+    isProject: async (cwd, python) => python || (await getEastProjectInfo(cwd)).isEast,
+    markerPrefix: "east-search-seen",
+    requireSearchEnv: "EAST_REQUIRE_SEARCH",
+};
+/**
+ * The pre-write gate's answer to an Edit or Write: the instruction to search
+ * first when it writes corpus code and no search is on record, else nothing. A
+ * reminder, or a refusal when the options' environment variable is `deny`.
+ * Once a search is seen, a per-session marker keeps every later write silent,
+ * so a long transcript is read at most once.
+ *
+ * @param event - The PreToolUse event
+ * @param options - The gate's configuration
+ * @returns The reply, or null when the write passes
+ */
+export async function preWriteGate(event, options) {
+    const cwd = event.cwd || process.cwd();
+    const filePath = event.tool_input?.file_path;
+    if (!filePath)
+        return null;
+    const python = filePath.endsWith(".py");
+    if (!python && !filePath.endsWith(".ts") && !filePath.endsWith(".tsx") && !filePath.endsWith(".js"))
+        return null;
+    // Is this the corpus's code? A Write carries its content; an Edit only its
+    // diff, so the file on disk (or the new text) says what it is.
+    let code = "";
+    if (event.tool_name === "Write") {
+        code = event.tool_input?.content ?? "";
+    }
+    else if (event.tool_name === "Edit") {
+        try {
+            code = await readFile(filePath, "utf-8");
+        }
+        catch {
+            code = event.tool_input?.new_string ?? "";
+        }
+    }
+    if (!options.isCorpusCode(code, python))
+        return null;
+    if (options.isProject !== undefined && !(await options.isProject(cwd, python)))
+        return null;
+    const marker = join(tmpdir(), `${options.markerPrefix}-${event.session_id}`);
+    if (existsSync(marker))
+        return null;
+    if (event.transcript_path && (await searchedInTranscript(event.transcript_path, options.searchTools))) {
+        try {
+            writeFileSync(marker, options.searchTools.join("\n"));
+        }
+        catch {
+            /* best-effort */
+        }
+        return null;
+    }
+    return { decision: process.env[options.requireSearchEnv] === "deny" ? "deny" : "context", text: options.gateText };
+}
+/** East's reminder. */
+export const EAST_READ_REMINDER = { readText: READ_TEXT, isCorpusRead: isExampleCorpusRead };
+/**
+ * The read reminder's answer to a Read, Grep or Glob: the reminder when it
+ * reaches for the corpus, else nothing. Never a refusal.
+ *
+ * @param event - The PreToolUse event
+ * @param options - The reminder's configuration
+ * @returns The reply, or null
+ */
+export function preReadReminder(event, options) {
+    return options.isCorpusRead(event.tool_name ?? "", event.tool_input ?? {}) ? { decision: "context", text: options.readText } : null;
+}
+/**
+ * Writes a hook's reply to stdout, as the host reads it.
+ *
+ * @param hookEventName - The event the hook answers, e.g. `PreToolUse`
+ * @param reply - The reply
+ */
+export function writeSearchHookReply(hookEventName, reply) {
+    if (reply.decision === "deny")
+        writeHookDecision(hookEventName, "deny", reply.text);
+    else
+        writeHookOutput(hookEventName, reply.text);
+}
+/**
+ * Runs the pre-write gate as a hook: reads the event from stdin, writes the
+ * reply, if any, to stdout.
+ *
+ * @param options - The gate's configuration
+ */
+export async function runPreWriteGate(options) {
+    const reply = await preWriteGate(await readHookInput(), options);
+    if (reply !== null)
+        writeSearchHookReply("PreToolUse", reply);
+}
+/**
+ * Runs the read reminder as a hook: reads the event from stdin, writes the
+ * reply, if any, to stdout.
+ *
+ * @param options - The reminder's configuration
+ */
+export async function runPreReadReminder(options) {
+    const reply = preReadReminder(await readHookInput(), options);
+    if (reply !== null)
+        writeSearchHookReply("PreToolUse", reply);
+}
+//# sourceMappingURL=search-hooks.js.map

package/dist/lib/search-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-hooks.js","sourceRoot":"","sources":["../../lib/search-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,eAAe,EAAkB,MAAM,cAAc,CAAC;AACjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AA8BjF,mBAAmB;AACnB,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,WAAW,EAAE,YAAY;IACzB,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3F,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM;IAClF,YAAY,EAAE,kBAAkB;IAChC,gBAAgB,EAAE,qBAAqB;CACxC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAgB,EAAE,OAA0B;IAC7E,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,SAAS,CAAC;IAC7C,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjH,2EAA2E;IAC3E,+DAA+D;IAC/D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;QAChC,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,OAAO,IAAI,EAAE,CAAC;IACzC,CAAC;SAAM,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,KAAK,CAAC,UAAU,EAAE,UAAU,IAAI,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACrD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5F,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAC7E,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,MAAM,oBAAoB,CAAC,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC;QACtG,IAAI,CAAC;YACH,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;AACrH,CAAC;AAUD,uBAAuB;AACvB,MAAM,CAAC,MAAM,kBAAkB,GAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAElH;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,KAAgB,EAAE,OAA4B;IAC5E,OAAO,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACtI,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAAqB,EAAE,KAAsB;IAChF,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM;QAAE,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;;QAC/E,eAAe,CAAC,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA0B;IAC9D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,MAAM,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,IAAI,KAAK,KAAK,IAAI;QAAE,oBAAoB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA4B;IACnE,MAAM,KAAK,GAAG,eAAe,CAAC,MAAM,aAAa,EAAE,EAAE,OAAO,CAAC,CAAC;IAC9D,IAAI,KAAK,KAAK,IAAI;QAAE,oBAAoB,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;AAChE,CAAC"}