opensquid 0.5.395

package/dist/codex/activate.js

@@ -0,0 +1,329 @@
+/**
+ * Codex activation evaluation — decide whether a codex's `detected_by`
+ * matches the current project context (typically `process.cwd()`).
+ *
+ * Used by the recall handler to filter out lessons from codexes that
+ * don't apply to the active project. Without this, recall would
+ * surface React-specific lessons inside a Rust project (cross-codex
+ * contamination).
+ *
+ * Coverage:
+ *   - file_exists / dir_exists / file_match / file_glob → filesystem-evaluated
+ *   - user_pinned → always true (codex was explicitly installed)
+ *   - all_of / any_of → recursive combinators
+ *   - memory_match / conversation_signal → default true (need runtime
+ *     context the recall handler doesn't carry; orchestrator (O3) is
+ *     the proper place for these)
+ */
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { getCodex } from "./store.js";
+import { isCompositeCodex, isFocusedCodex } from "./types.js";
+// ---------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------
+/**
+ * Evaluate a codex's activation against a project context.
+ *
+ * - Composite codexes are not directly activatable; treat as inactive
+ *   here (their `includes` activate independently via their own
+ *   `detected_by`).
+ * - Focused codex with no `detected_by`: defaults to active (the codex
+ *   author wanted always-on).
+ * - `activation_scope: user` + `user_pinned`: always active.
+ * - Otherwise: evaluate the `detected_by` list (any-of semantics —
+ *   matching ANY listed signal activates).
+ */
+export async function isCodexActive(codex, cwd) {
+    if (isCompositeCodex(codex))
+        return false;
+    if (!isFocusedCodex(codex))
+        return false;
+    return isFocusedCodexActive(codex, cwd);
+}
+async function isFocusedCodexActive(codex, cwd) {
+    // No detection signals declared → activate (author wanted always-on).
+    if (!codex.detected_by || codex.detected_by.length === 0)
+        return true;
+    // Top-level list = OR — any matching signal activates.
+    for (const detection of codex.detected_by) {
+        if (await evaluateDetection(detection, cwd))
+            return true;
+    }
+    return false;
+}
+/**
+ * Evaluate a single detection signal against a project context.
+ *
+ * Returns false on unknown kinds (forward-compat — future engine
+ * versions could add detection kinds opensquid doesn't recognize yet;
+ * fail closed rather than over-activate).
+ */
+export async function evaluateDetection(detection, cwd) {
+    switch (detection.kind) {
+        case "user_pinned":
+            return true;
+        case "file_exists":
+            return fileExistsAt(path.resolve(cwd, detection.path));
+        case "dir_exists":
+            return dirExistsAt(path.resolve(cwd, detection.path));
+        case "file_match":
+            return fileMatches(path.resolve(cwd, detection.path), detection.matches);
+        case "file_glob":
+            return globAtLeast(cwd, detection.pattern, detection.min_count ?? 1);
+        case "all_of": {
+            for (const c of detection.conditions) {
+                if (!(await evaluateDetection(c, cwd)))
+                    return false;
+            }
+            return true;
+        }
+        case "any_of": {
+            for (const c of detection.conditions) {
+                if (await evaluateDetection(c, cwd))
+                    return true;
+            }
+            return false;
+        }
+        case "memory_match":
+        case "conversation_signal":
+            // These need runtime context the recall handler doesn't carry.
+            // Defaulting to true is the conservative choice: don't filter
+            // lessons out solely because we can't evaluate these signals here.
+            // Orchestrator (O3) will evaluate them properly.
+            return true;
+        default: {
+            // Forward-compat: unknown kinds → fail closed.
+            // Exhaustiveness check at compile time via the `never` cast.
+            const _exhaustive = detection;
+            void _exhaustive;
+            return false;
+        }
+    }
+}
+// ---------------------------------------------------------------------
+// Activation cache (per-cwd, per-recall-handler-session)
+// ---------------------------------------------------------------------
+/**
+ * Caches codex activation decisions for one project context.
+ *
+ * Reuse across multiple recall calls in the same session — avoids
+ * re-reading codex.yaml files on every recall. Per-cwd because the
+ * answer depends on the project being worked in.
+ */
+export class CodexActivationCache {
+    cwd;
+    rootDir;
+    decisions = new Map();
+    constructor(cwd, rootDir) {
+        this.cwd = cwd;
+        this.rootDir = rootDir;
+    }
+    /** Returns true iff the codex's `detected_by` matches this cwd. */
+    async isActive(codexId) {
+        let pending = this.decisions.get(codexId);
+        if (!pending) {
+            pending = this.evaluate(codexId);
+            this.decisions.set(codexId, pending);
+        }
+        return pending;
+    }
+    async evaluate(codexId) {
+        try {
+            const codex = await getCodex(codexId, { rootDir: this.rootDir });
+            return isCodexActive(codex, this.cwd);
+        }
+        catch {
+            // Missing or malformed codex → treat as inactive. Lessons from
+            // an uninstalled codex shouldn't surface even if they're still
+            // in the lesson store (stale state).
+            return false;
+        }
+    }
+}
+// ---------------------------------------------------------------------
+// Lesson → codex id extraction
+// ---------------------------------------------------------------------
+/**
+ * Extract the codex id from a lesson description.
+ *
+ * opensquid's codex CLI seeds lessons with descriptions like:
+ *   "before any git push or release (codex:loop-engineering-workflow)"
+ *
+ * Returns null for lessons not seeded from a codex (the pre-codex
+ * lessons created by `lesson.create` without `pack_id`).
+ */
+export function extractCodexId(description) {
+    const m = description.match(/\(codex:([a-z0-9][a-z0-9._-]{0,127})\)\s*$/);
+    return m ? m[1] : null;
+}
+// ---------------------------------------------------------------------
+// Filesystem primitives
+// ---------------------------------------------------------------------
+async function fileExistsAt(p) {
+    try {
+        const stat = await fs.stat(p);
+        return stat.isFile();
+    }
+    catch {
+        return false;
+    }
+}
+async function dirExistsAt(p) {
+    try {
+        const stat = await fs.stat(p);
+        return stat.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function fileMatches(filePath, matches) {
+    let content;
+    try {
+        content = await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return false;
+    }
+    // Try JSON first (the most common manifest format). Fall back to
+    // tolerant key-presence check for non-JSON files.
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        // Non-JSON: do a substring check on the dotted-path key. Coarse
+        // but correct for the "contains" use case.
+        for (const key of Object.keys(matches)) {
+            if (!content.includes(key))
+                return false;
+        }
+        return true;
+    }
+    for (const [keyPath, _expected] of Object.entries(matches)) {
+        const value = walkPath(parsed, keyPath);
+        // MVP semantics: a key being PRESENT (truthy + non-null) at the
+        // path means "match." Full semver-range matching is future work;
+        // for activation gating, key-presence is sufficient — a project
+        // with `dependencies.react` defined IS a React project.
+        if (value === undefined || value === null || value === "")
+            return false;
+    }
+    return true;
+}
+function walkPath(obj, dottedPath) {
+    const parts = dottedPath.split(".");
+    let cur = obj;
+    for (const part of parts) {
+        if (cur === null || cur === undefined)
+            return undefined;
+        if (typeof cur !== "object")
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+async function globAtLeast(cwd, pattern, minCount) {
+    // Lightweight glob — supports `**/*.ext` and `dir/**/*.{a,b}` patterns.
+    // Avoids pulling in a full glob dependency for one detection kind.
+    const matches = await collectGlobMatches(cwd, pattern);
+    return matches.length >= minCount;
+}
+async function collectGlobMatches(cwd, pattern) {
+    // Split into a fixed-prefix and the matchable tail. Walk only what
+    // the tail says.
+    const segments = pattern.split("/");
+    let prefix = cwd;
+    let firstWildcard = -1;
+    for (let i = 0; i < segments.length; i++) {
+        if (segments[i].includes("*")) {
+            firstWildcard = i;
+            break;
+        }
+        prefix = path.join(prefix, segments[i]);
+    }
+    if (firstWildcard === -1) {
+        // No wildcards — the pattern is literal; check existence directly.
+        try {
+            await fs.access(prefix);
+            return [prefix];
+        }
+        catch {
+            return [];
+        }
+    }
+    const tail = segments.slice(firstWildcard).join("/");
+    const fileRegex = globTailToRegex(tail);
+    const results = [];
+    await walkDir(prefix, "", fileRegex, results);
+    return results;
+}
+async function walkDir(rootAbs, relPath, fileRegex, out) {
+    let entries;
+    try {
+        entries = await fs.readdir(path.join(rootAbs, relPath), {
+            withFileTypes: true,
+        });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const childRel = relPath ? `${relPath}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            await walkDir(rootAbs, childRel, fileRegex, out);
+        }
+        else if (entry.isFile() && fileRegex.test(childRel)) {
+            out.push(path.join(rootAbs, childRel));
+        }
+    }
+}
+function globTailToRegex(tail) {
+    // Translate a glob tail (supports `**`, `*`, `{a,b}`) into a regex.
+    let re = "";
+    let i = 0;
+    while (i < tail.length) {
+        const c = tail[i];
+        if (c === "*" && tail[i + 1] === "*") {
+            re += ".*";
+            i += 2;
+            if (tail[i] === "/")
+                i++;
+        }
+        else if (c === "*") {
+            re += "[^/]*";
+            i++;
+        }
+        else if (c === "?") {
+            re += "[^/]";
+            i++;
+        }
+        else if (c === "{") {
+            const end = tail.indexOf("}", i);
+            if (end === -1) {
+                re += "\\{";
+                i++;
+                continue;
+            }
+            const opts = tail.slice(i + 1, end).split(",");
+            re += `(?:${opts.map(escapeRegexLiteral).join("|")})`;
+            i = end + 1;
+        }
+        else if (".+^$()|\\".includes(c)) {
+            re += "\\" + c;
+            i++;
+        }
+        else {
+            re += c;
+            i++;
+        }
+    }
+    return new RegExp(`^${re}$`);
+}
+function escapeRegexLiteral(s) {
+    return s.replace(/[.+*?^$()|[\]\\{}]/g, "\\$&");
+}
+//# sourceMappingURL=activate.js.map

package/dist/codex/activate.js.map

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

package/dist/codex/activate.test.js

@@ -0,0 +1,229 @@
+import * as crypto from "node:crypto";
+import { promises as fs } from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { CodexActivationCache, evaluateDetection, extractCodexId, isCodexActive, } from "./activate.js";
+import { installCodex } from "./store.js";
+let tmpCwd;
+let tmpStore;
+beforeEach(async () => {
+    const uniq = crypto.randomUUID();
+    tmpCwd = path.join(os.tmpdir(), `oscli-activate-cwd-${uniq}`);
+    tmpStore = path.join(os.tmpdir(), `oscli-activate-store-${uniq}`);
+    await fs.mkdir(tmpCwd, { recursive: true });
+    await fs.mkdir(tmpStore, { recursive: true });
+});
+afterEach(async () => {
+    await fs.rm(tmpCwd, { recursive: true, force: true });
+    await fs.rm(tmpStore, { recursive: true, force: true });
+});
+// ---------------------------------------------------------------------
+// extractCodexId
+// ---------------------------------------------------------------------
+describe("extractCodexId", () => {
+    it("extracts id from codex-suffixed description", () => {
+        expect(extractCodexId("before any push (codex:loop-engineering-workflow)")).toBe("loop-engineering-workflow");
+    });
+    it("trims trailing whitespace tolerantly", () => {
+        expect(extractCodexId("rule (codex:x)  ")).toBe("x");
+    });
+    it("returns null when no suffix", () => {
+        expect(extractCodexId("some legacy lesson description")).toBeNull();
+    });
+    it("returns null for non-id-shaped content in parens", () => {
+        expect(extractCodexId("see (PR #42)")).toBeNull();
+        expect(extractCodexId("see (codex:Bad-Id)")).toBeNull();
+    });
+});
+// ---------------------------------------------------------------------
+// evaluateDetection — filesystem signals
+// ---------------------------------------------------------------------
+describe("evaluateDetection: file_exists", () => {
+    it("matches when file present", async () => {
+        await fs.writeFile(path.join(tmpCwd, "package.json"), "{}", "utf8");
+        expect(await evaluateDetection({ kind: "file_exists", path: "package.json" }, tmpCwd)).toBe(true);
+    });
+    it("misses when file absent", async () => {
+        expect(await evaluateDetection({ kind: "file_exists", path: "package.json" }, tmpCwd)).toBe(false);
+    });
+    it("misses when path is a directory", async () => {
+        await fs.mkdir(path.join(tmpCwd, "package.json"));
+        expect(await evaluateDetection({ kind: "file_exists", path: "package.json" }, tmpCwd)).toBe(false);
+    });
+});
+describe("evaluateDetection: dir_exists", () => {
+    it("matches when dir present", async () => {
+        await fs.mkdir(path.join(tmpCwd, "src/components/atoms"), { recursive: true });
+        expect(await evaluateDetection({ kind: "dir_exists", path: "src/components/atoms" }, tmpCwd)).toBe(true);
+    });
+    it("misses when dir absent", async () => {
+        expect(await evaluateDetection({ kind: "dir_exists", path: "src/components/atoms" }, tmpCwd)).toBe(false);
+    });
+});
+describe("evaluateDetection: file_match (JSON)", () => {
+    it("matches when dotted path resolves to a truthy value", async () => {
+        await fs.writeFile(path.join(tmpCwd, "package.json"), JSON.stringify({ dependencies: { react: "^19.0.0" } }), "utf8");
+        expect(await evaluateDetection({
+            kind: "file_match",
+            path: "package.json",
+            matches: { "dependencies.react": ">=19" },
+        }, tmpCwd)).toBe(true);
+    });
+    it("misses when dotted path is missing", async () => {
+        await fs.writeFile(path.join(tmpCwd, "package.json"), JSON.stringify({ name: "x" }), "utf8");
+        expect(await evaluateDetection({
+            kind: "file_match",
+            path: "package.json",
+            matches: { "dependencies.react": ">=19" },
+        }, tmpCwd)).toBe(false);
+    });
+    it("misses when file is absent", async () => {
+        expect(await evaluateDetection({
+            kind: "file_match",
+            path: "package.json",
+            matches: { "dependencies.react": ">=19" },
+        }, tmpCwd)).toBe(false);
+    });
+});
+describe("evaluateDetection: file_glob", () => {
+    it("matches when min_count met", async () => {
+        await fs.mkdir(path.join(tmpCwd, "data"));
+        await fs.writeFile(path.join(tmpCwd, "data/sample1.h5ad"), "", "utf8");
+        await fs.writeFile(path.join(tmpCwd, "data/sample2.h5ad"), "", "utf8");
+        expect(await evaluateDetection({ kind: "file_glob", pattern: "**/*.h5ad", min_count: 2 }, tmpCwd)).toBe(true);
+    });
+    it("misses when below min_count", async () => {
+        await fs.mkdir(path.join(tmpCwd, "data"));
+        await fs.writeFile(path.join(tmpCwd, "data/sample1.h5ad"), "", "utf8");
+        expect(await evaluateDetection({ kind: "file_glob", pattern: "**/*.h5ad", min_count: 2 }, tmpCwd)).toBe(false);
+    });
+    it("skips node_modules + dot-dirs during walk", async () => {
+        await fs.mkdir(path.join(tmpCwd, "node_modules/foo"), { recursive: true });
+        await fs.mkdir(path.join(tmpCwd, ".git"), { recursive: true });
+        await fs.writeFile(path.join(tmpCwd, "node_modules/foo/x.h5ad"), "", "utf8");
+        await fs.writeFile(path.join(tmpCwd, ".git/x.h5ad"), "", "utf8");
+        expect(await evaluateDetection({ kind: "file_glob", pattern: "**/*.h5ad", min_count: 1 }, tmpCwd)).toBe(false);
+    });
+});
+describe("evaluateDetection: user_pinned", () => {
+    it("always returns true", async () => {
+        expect(await evaluateDetection({ kind: "user_pinned" }, tmpCwd)).toBe(true);
+    });
+});
+describe("evaluateDetection: all_of / any_of", () => {
+    it("all_of requires every condition", async () => {
+        await fs.writeFile(path.join(tmpCwd, "a"), "", "utf8");
+        expect(await evaluateDetection({
+            kind: "all_of",
+            conditions: [
+                { kind: "file_exists", path: "a" },
+                { kind: "file_exists", path: "b" },
+            ],
+        }, tmpCwd)).toBe(false);
+        await fs.writeFile(path.join(tmpCwd, "b"), "", "utf8");
+        expect(await evaluateDetection({
+            kind: "all_of",
+            conditions: [
+                { kind: "file_exists", path: "a" },
+                { kind: "file_exists", path: "b" },
+            ],
+        }, tmpCwd)).toBe(true);
+    });
+    it("any_of accepts any single match", async () => {
+        await fs.writeFile(path.join(tmpCwd, "a"), "", "utf8");
+        expect(await evaluateDetection({
+            kind: "any_of",
+            conditions: [
+                { kind: "file_exists", path: "a" },
+                { kind: "file_exists", path: "b" },
+            ],
+        }, tmpCwd)).toBe(true);
+    });
+});
+describe("evaluateDetection: memory_match / conversation_signal", () => {
+    it("memory_match defaults to true (runtime context not available here)", async () => {
+        expect(await evaluateDetection({ kind: "memory_match", memory_kind: "profession", value: "clinician" }, tmpCwd)).toBe(true);
+    });
+    it("conversation_signal defaults to true", async () => {
+        expect(await evaluateDetection({ kind: "conversation_signal", contains: ["case law"] }, tmpCwd)).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------
+// isCodexActive
+// ---------------------------------------------------------------------
+describe("isCodexActive", () => {
+    function focused(detected_by) {
+        return {
+            id: "test",
+            version: "1.0.0",
+            detected_by,
+        };
+    }
+    it("composite codexes are inactive (includes activate via their own detected_by)", async () => {
+        const composite = {
+            id: "x",
+            kind: "composite",
+            version: "1.0.0",
+            includes: [{ id: "a", semver: ">=1" }],
+        };
+        expect(await isCodexActive(composite, tmpCwd)).toBe(false);
+    });
+    it("focused codex with no detected_by defaults to active", async () => {
+        expect(await isCodexActive(focused(undefined), tmpCwd)).toBe(true);
+        expect(await isCodexActive(focused([]), tmpCwd)).toBe(true);
+    });
+    it("top-level detected_by list = OR semantics", async () => {
+        await fs.writeFile(path.join(tmpCwd, "tsconfig.json"), "{}", "utf8");
+        expect(await isCodexActive(focused([
+            { kind: "file_exists", path: "Cargo.toml" }, // miss
+            { kind: "file_exists", path: "tsconfig.json" }, // hit
+        ]), tmpCwd)).toBe(true);
+    });
+    it("no matching detection → inactive", async () => {
+        expect(await isCodexActive(focused([{ kind: "file_exists", path: "Cargo.toml" }]), tmpCwd)).toBe(false);
+    });
+});
+// ---------------------------------------------------------------------
+// CodexActivationCache
+// ---------------------------------------------------------------------
+describe("CodexActivationCache", () => {
+    it("returns true for an installed user_pinned codex", async () => {
+        const codex = {
+            id: "wf",
+            version: "1.0.0",
+            activation_scope: "user",
+            detected_by: [{ kind: "user_pinned" }],
+        };
+        await installCodex(codex, { rootDir: tmpStore });
+        const cache = new CodexActivationCache(tmpCwd, tmpStore);
+        expect(await cache.isActive("wf")).toBe(true);
+    });
+    it("returns false when detected_by doesn't match cwd", async () => {
+        const codex = {
+            id: "react-19",
+            version: "1.0.0",
+            detected_by: [{ kind: "file_exists", path: "package.json" }],
+        };
+        await installCodex(codex, { rootDir: tmpStore });
+        const cache = new CodexActivationCache(tmpCwd, tmpStore);
+        expect(await cache.isActive("react-19")).toBe(false);
+    });
+    it("returns false for non-installed codex (stale lesson reference)", async () => {
+        const cache = new CodexActivationCache(tmpCwd, tmpStore);
+        expect(await cache.isActive("ghost-codex")).toBe(false);
+    });
+    it("caches the same decision across repeated lookups", async () => {
+        const codex = {
+            id: "wf",
+            version: "1.0.0",
+            detected_by: [{ kind: "user_pinned" }],
+        };
+        await installCodex(codex, { rootDir: tmpStore });
+        const cache = new CodexActivationCache(tmpCwd, tmpStore);
+        const a = await cache.isActive("wf");
+        const b = await cache.isActive("wf");
+        expect(a).toBe(true);
+        expect(b).toBe(true);
+    });
+});