@rryando/arcs 3.0.0

package/dist/cli/status-dashboard.js

@@ -0,0 +1,248 @@
+import { execSync } from "node:child_process";
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import pc from "picocolors";
+import { getDataDir } from "../utils/paths.js";
+/**
+ * Show a compact status dashboard when `arcs` is invoked with no args in a TTY.
+ */
+export async function showStatusDashboard() {
+    const cwd = process.cwd();
+    const dataDir = getDataDir();
+    const projectsDir = resolve(dataDir, "projects");
+    // 1. Find project matching cwd
+    const project = findProject(projectsDir, dataDir, cwd);
+    if (!project) {
+        console.log(pc.dim("No ARCS project found for this directory."));
+        return;
+    }
+    // 2. Read tasks
+    const taskCounts = readTaskCounts(resolve(projectsDir, project.slug));
+    // 3. Read plans with diagram info
+    const plans = readPlans(resolve(projectsDir, project.slug));
+    // 4. Render
+    render(project, taskCounts, plans);
+}
+function findProject(projectsDir, dataDir, cwd) {
+    const metaPath = resolve(dataDir, "meta.json");
+    if (!existsSync(metaPath))
+        return null;
+    let rootMeta;
+    try {
+        rootMeta = JSON.parse(readFileSync(metaPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+    if (!rootMeta.projects)
+        return null;
+    for (const node of rootMeta.projects) {
+        const projMetaPath = resolve(projectsDir, node.id, "meta.json");
+        if (!existsSync(projMetaPath))
+            continue;
+        try {
+            const projMeta = JSON.parse(readFileSync(projMetaPath, "utf-8"));
+            const paths = Array.isArray(projMeta.workspacePaths) ? projMeta.workspacePaths : [];
+            for (const wp of paths) {
+                const resolved = wp.startsWith("~") ? resolve(homedir(), wp.slice(2)) : resolve(wp);
+                if (cwd === resolved || cwd.startsWith(`${resolved}/`)) {
+                    return { slug: node.id, name: node.name, status: node.status };
+                }
+            }
+        }
+        catch { }
+    }
+    return null;
+}
+function readTaskCounts(projectDir) {
+    const counts = { backlog: 0, inProgress: 0, done: 0 };
+    const tasksPath = resolve(projectDir, "tasks.md");
+    if (!existsSync(tasksPath))
+        return counts;
+    try {
+        const content = readFileSync(tasksPath, "utf-8");
+        const lines = content.split("\n");
+        for (const line of lines) {
+            if (line.includes("- [ ]"))
+                counts.backlog++;
+            else if (line.includes("- [/]"))
+                counts.inProgress++;
+            else if (line.includes("- [x]"))
+                counts.done++;
+        }
+    }
+    catch {
+        // graceful degradation
+    }
+    return counts;
+}
+function readPlans(projectDir) {
+    const plansDir = resolve(projectDir, "plans");
+    if (!existsSync(plansDir))
+        return [];
+    const plans = [];
+    try {
+        const entries = readdirSync(plansDir);
+        // Find .diagram.mmd files
+        const diagramFiles = entries.filter((e) => e.endsWith(".diagram.mmd"));
+        for (const diagramFile of diagramFiles) {
+            const planId = diagramFile.replace(".diagram.mmd", "");
+            // Try to get plan name from meta
+            const planMetaPath = resolve(plansDir, `${planId}.meta.json`);
+            let planName = planId;
+            if (existsSync(planMetaPath)) {
+                try {
+                    const meta = JSON.parse(readFileSync(planMetaPath, "utf-8"));
+                    if (meta.title)
+                        planName = meta.title;
+                }
+                catch {
+                    // use planId
+                }
+            }
+            // Run manage-diagram.mjs inspect
+            const diagramPath = resolve(plansDir, diagramFile);
+            try {
+                const scriptPath = resolveManageDiagramScript();
+                if (!scriptPath)
+                    continue;
+                const output = execSync(`node "${scriptPath}" inspect "${diagramPath}"`, {
+                    encoding: "utf-8",
+                    timeout: 5000,
+                    stdio: ["pipe", "pipe", "pipe"],
+                });
+                const data = JSON.parse(output);
+                const nodes = data.nodes ?? [];
+                const totalNodes = nodes.length;
+                const doneNodes = nodes.filter((n) => n.status === "done").length;
+                const inProgressNodes = nodes.filter((n) => n.status === "inProgress").length;
+                const blockedNodes = nodes.filter((n) => n.status === "blocked").length;
+                const backlogNodes = totalNodes - doneNodes - inProgressNodes - blockedNodes;
+                // Parse ready from readyComment (format: "T002" or "T002,T003" or "ready=T002,T003")
+                const readyComment = data.readyComment ?? "";
+                let readyIds = [];
+                if (readyComment) {
+                    const eqMatch = readyComment.match(/ready=([A-Z0-9,]+)/i);
+                    if (eqMatch) {
+                        readyIds = eqMatch[1].split(",").map((s) => s.trim());
+                    }
+                    else {
+                        readyIds = readyComment
+                            .split(",")
+                            .map((s) => s.trim())
+                            .filter((s) => /^T\d+$/i.test(s));
+                    }
+                }
+                const nextReadyNode = readyIds.length > 0 ? nodes.find((n) => n.id === readyIds[0]) : undefined;
+                const nextReady = nextReadyNode ? `${nextReadyNode.id} ${nextReadyNode.label ?? ""}` : "";
+                plans.push({
+                    name: planName,
+                    totalNodes,
+                    doneNodes,
+                    inProgressNodes,
+                    blockedNodes,
+                    backlogNodes,
+                    nextReady,
+                });
+            }
+            catch {
+                // If inspect fails, still show the plan without progress
+                plans.push({
+                    name: planName,
+                    totalNodes: 0,
+                    doneNodes: 0,
+                    inProgressNodes: 0,
+                    blockedNodes: 0,
+                    backlogNodes: 0,
+                    nextReady: "",
+                });
+            }
+        }
+    }
+    catch {
+        // graceful degradation
+    }
+    return plans;
+}
+function resolveManageDiagramScript() {
+    // Check local repo path first, then config path
+    const candidates = [
+        resolve(import.meta.dirname, "../../opencode/arcs/skills/to-diagram/scripts/manage-diagram.mjs"),
+        resolve(homedir(), ".config/opencode/skills/arcs/to-diagram/scripts/manage-diagram.mjs"),
+    ];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+function render(project, tasks, plans) {
+    const WIDTH = 60;
+    const innerWidth = WIDTH - 4; // inside box padding
+    // Header box
+    const topLine = `┌─ ${pc.bold("ARCS")} ${"─".repeat(WIDTH - 7)}┐`;
+    const botLine = `└${"─".repeat(WIDTH - 2)}┘`;
+    const dirLine = padRight(`  Dir:     ${process.cwd()}`, innerWidth);
+    const projectLine = padRight(`  Project: ${pc.bold(project.name)} (${project.status})`, innerWidth);
+    const taskParts = [];
+    if (tasks.inProgress > 0)
+        taskParts.push(pc.yellow(`${tasks.inProgress} in-progress`));
+    if (tasks.backlog > 0)
+        taskParts.push(pc.dim(`${tasks.backlog} backlog`));
+    if (tasks.done > 0)
+        taskParts.push(pc.green(`${tasks.done} done`));
+    const taskLine = padRight(`  Tasks:   ${taskParts.join(" · ")}`, innerWidth);
+    console.log(topLine);
+    console.log(`│${dirLine}│`);
+    console.log(`│${projectLine}│`);
+    console.log(`│${taskLine}│`);
+    console.log(botLine);
+    // Plans
+    if (plans.length > 0) {
+        console.log("");
+        console.log("Plans:");
+        for (const plan of plans) {
+            const barWidth = 7;
+            const filled = plan.totalNodes > 0 ? Math.round((plan.doneNodes / plan.totalNodes) * barWidth) : 0;
+            const bar = "█".repeat(filled) + "░".repeat(barWidth - filled);
+            const progress = plan.totalNodes > 0 ? `${plan.doneNodes}/${plan.totalNodes}` : "—";
+            const isDone = plan.totalNodes > 0 && plan.doneNodes === plan.totalNodes;
+            const doneFlag = isDone ? ` ${pc.green("✓ done")}` : "";
+            const name = truncate(plan.name, 30);
+            console.log(`  ▸ ${pc.bold(name.padEnd(30))} ${bar} ${progress.padEnd(5)}${doneFlag}`);
+            // Second line: node status counts + next ready task (only if diagram has nodes)
+            if (plan.totalNodes > 0 && !isDone) {
+                const counts = [];
+                if (plan.doneNodes > 0)
+                    counts.push(pc.green(`✓${plan.doneNodes}`));
+                if (plan.inProgressNodes > 0)
+                    counts.push(pc.yellow(`◉${plan.inProgressNodes}`));
+                if (plan.blockedNodes > 0)
+                    counts.push(pc.red(`✗${plan.blockedNodes}`));
+                if (plan.backlogNodes > 0)
+                    counts.push(pc.dim(`○${plan.backlogNodes}`));
+                const next = plan.nextReady ? `  next: ${truncate(plan.nextReady, 25)}` : "";
+                console.log(`    ${counts.join(" ")}${pc.dim(next)}`);
+            }
+        }
+    }
+    // Hints
+    console.log("");
+    console.log(pc.dim("Hints:"));
+    console.log(pc.dim("  arcs diagram show <plan-id>    tree view"));
+    console.log(pc.dim("  arcs task <slug>               list tasks"));
+}
+function padRight(str, width) {
+    // Strip ANSI for length calculation
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: intentional ANSI escape detection
+    const stripped = str.replace(/\u001b\[[0-9;]*m/g, "");
+    const pad = Math.max(0, width - stripped.length);
+    return str + " ".repeat(pad);
+}
+function truncate(str, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return `${str.slice(0, maxLen - 1)}…`;
+}
+//# sourceMappingURL=status-dashboard.js.map

package/dist/cli/status-dashboard.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { handleCli } from "./cli/index.js";
+async function run() {
+    const args = process.argv.slice(2);
+    // TTY detection: if human at terminal with no args, show status dashboard
+    if (args.length === 0 && process.stdin.isTTY) {
+        const { showStatusDashboard } = await import("./cli/status-dashboard.js");
+        await showStatusDashboard();
+        return;
+    }
+    // Handle CLI subcommands
+    if (args.length > 0) {
+        const handled = await handleCli(args);
+        if (handled)
+            return;
+    }
+    // No recognized command
+    console.error("Unknown command. Run `arcs --help` for usage.");
+    process.exit(1);
+}
+run().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,KAAK,UAAU,GAAG;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,0EAA0E;IAC1E,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7C,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;QAC1E,MAAM,mBAAmB,EAAE,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,yBAAyB;IACzB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,OAAO;YAAE,OAAO;IACtB,CAAC;IAED,wBAAwB;IACxB,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAClB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/retrieval/bm25.d.ts

@@ -0,0 +1,23 @@
+/**
+ * BM25 (Okapi BM25) scoring algorithm for full-text search.
+ */
+export interface Document {
+    id: string;
+    fields: Record<string, string>;
+}
+export interface ScoredResult {
+    id: string;
+    score: number;
+}
+export interface Bm25Index {
+    search(query: string, limit?: number): ScoredResult[];
+}
+/**
+ * Tokenizes input text: lowercase, split on non-alphanumeric, filter short tokens.
+ */
+export declare function tokenize(text: string): string[];
+/**
+ * Creates a BM25 index over the given documents with field weights.
+ */
+export declare function createBm25Index(documents: Document[], fieldWeights: Record<string, number>): Bm25Index;
+//# sourceMappingURL=bm25.d.ts.map

package/dist/retrieval/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../../src/retrieval/bm25.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAAC;CACvD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,SAAS,CAqFX"}

package/dist/retrieval/bm25.js

@@ -0,0 +1,92 @@
+/**
+ * BM25 (Okapi BM25) scoring algorithm for full-text search.
+ */
+const K1 = 1.2;
+const B = 0.75;
+/**
+ * Tokenizes input text: lowercase, split on non-alphanumeric, filter short tokens.
+ */
+export function tokenize(text) {
+    return text
+        .toLowerCase()
+        .split(/[^\p{L}\p{N}]+/u)
+        .filter((t) => t.length >= 2);
+}
+/**
+ * Creates a BM25 index over the given documents with field weights.
+ */
+export function createBm25Index(documents, fieldWeights) {
+    const N = documents.length;
+    const fieldNames = Object.keys(fieldWeights);
+    // Pre-compute: tokenized fields, field lengths, avg field lengths, document frequencies
+    const tokenizedDocs = new Map();
+    const fieldLengthSums = {};
+    const fieldLengthCounts = {};
+    for (const field of fieldNames) {
+        fieldLengthSums[field] = 0;
+        fieldLengthCounts[field] = 0;
+    }
+    for (const doc of documents) {
+        const fieldTokens = new Map();
+        for (const field of fieldNames) {
+            const tokens = tokenize(doc.fields[field] ?? "");
+            fieldTokens.set(field, tokens);
+            fieldLengthSums[field] += tokens.length;
+            fieldLengthCounts[field] += 1;
+        }
+        tokenizedDocs.set(doc.id, fieldTokens);
+    }
+    const avgFieldLen = {};
+    for (const field of fieldNames) {
+        avgFieldLen[field] = N > 0 ? fieldLengthSums[field] / N : 0;
+    }
+    // Document frequency: count each doc once per term (across all fields)
+    const df = new Map();
+    for (const doc of documents) {
+        const fieldTokens = tokenizedDocs.get(doc.id);
+        const termsInDoc = new Set();
+        for (const field of fieldNames) {
+            for (const token of fieldTokens.get(field) ?? []) {
+                termsInDoc.add(token);
+            }
+        }
+        for (const term of termsInDoc) {
+            df.set(term, (df.get(term) ?? 0) + 1);
+        }
+    }
+    return {
+        search(query, limit = 10) {
+            const queryTerms = tokenize(query);
+            if (queryTerms.length === 0 || N === 0)
+                return [];
+            const results = [];
+            for (const doc of documents) {
+                let docScore = 0;
+                const fieldTokens = tokenizedDocs.get(doc.id);
+                for (const term of queryTerms) {
+                    const termDf = df.get(term) ?? 0;
+                    if (termDf === 0)
+                        continue;
+                    const idf = Math.log((N - termDf + 0.5) / (termDf + 0.5) + 1);
+                    for (const field of fieldNames) {
+                        const tokens = fieldTokens.get(field) ?? [];
+                        const tf = tokens.filter((t) => t === term).length;
+                        if (tf === 0)
+                            continue;
+                        const fieldLen = tokens.length;
+                        const avgLen = avgFieldLen[field];
+                        const tfNorm = (tf * (K1 + 1)) / (tf + K1 * (1 - B + B * (fieldLen / (avgLen || 1))));
+                        const weight = fieldWeights[field] ?? 1;
+                        docScore += idf * tfNorm * weight;
+                    }
+                }
+                if (docScore > 0) {
+                    results.push({ id: doc.id, score: docScore });
+                }
+            }
+            results.sort((a, b) => b.score - a.score);
+            return results.slice(0, limit);
+        },
+    };
+}
+//# sourceMappingURL=bm25.js.map

package/dist/retrieval/bm25.js.map

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

package/dist/retrieval/cross-project-search.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Cross-project knowledge search.
+ *
+ * Queries knowledge entries (and optionally plans) across ALL projects in the
+ * DAG, returning results annotated with their source project slug.
+ */
+export interface CrossProjectSearchOptions {
+    query: string;
+    limit?: number;
+    projectSlugs?: string[];
+    includeKnowledge?: boolean;
+    includePlans?: boolean;
+    kind?: string;
+}
+export interface CrossProjectResult {
+    projectSlug: string;
+    entryId: string;
+    entryType: "knowledge" | "plan";
+    title: string;
+    summary: string;
+    score: number;
+    kind?: string;
+    status?: string;
+}
+/**
+ * Search knowledge and/or plan entries across all (or a subset of) projects.
+ * Results are sorted by BM25 score descending and capped at the specified limit.
+ */
+export declare function searchAcrossProjects(options: CrossProjectSearchOptions): Promise<CrossProjectResult[]>;
+//# sourceMappingURL=cross-project-search.d.ts.map

package/dist/retrieval/cross-project-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-project-search.d.ts","sourceRoot":"","sources":["../../src/retrieval/cross-project-search.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,WAAW,GAAG,MAAM,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAkF/B"}

package/dist/retrieval/cross-project-search.js

@@ -0,0 +1,109 @@
+/**
+ * Cross-project knowledge search.
+ *
+ * Queries knowledge entries (and optionally plans) across ALL projects in the
+ * DAG, returning results annotated with their source project slug.
+ */
+import { readRootMeta } from "../utils/dag.js";
+import { getDataDir, getProjectDir } from "../utils/paths.js";
+import { readKnowledgeIndex } from "../utils/project-memory.js";
+import { buildProjectRetrievalIndex } from "./index-builder.js";
+/**
+ * Search knowledge and/or plan entries across all (or a subset of) projects.
+ * Results are sorted by BM25 score descending and capped at the specified limit.
+ */
+export async function searchAcrossProjects(options) {
+    const { query, limit = 10, projectSlugs, includeKnowledge = true, includePlans = false, } = options;
+    if (!query.trim())
+        return [];
+    const dataDir = getDataDir();
+    const rootMeta = await readRootMeta(dataDir);
+    // Determine which projects to search
+    const slugs = projectSlugs && projectSlugs.length > 0
+        ? projectSlugs.filter((s) => rootMeta.projects.some((p) => p.id === s))
+        : rootMeta.projects.map((p) => p.id);
+    // Collect results across all projects
+    const allResults = [];
+    // Use a generous per-project limit to avoid premature truncation before global sort
+    const perProjectLimit = limit * 3;
+    for (const slug of slugs) {
+        let index;
+        try {
+            index = await buildProjectRetrievalIndex(slug);
+        }
+        catch {
+            // Skip projects with missing/corrupt data
+            continue;
+        }
+        if (includeKnowledge) {
+            const knowledgeResults = index.searchKnowledge(query, perProjectLimit);
+            for (const r of knowledgeResults) {
+                // Apply kind filter if specified (BM25 doesn't filter by kind natively)
+                if (options.kind && r.type === "knowledge") {
+                    // We need to check kind from the entry metadata — but ScoredEntry doesn't carry kind.
+                    // We'll do a post-filter below after enrichment.
+                }
+                allResults.push({
+                    projectSlug: slug,
+                    entryId: r.id,
+                    entryType: "knowledge",
+                    title: r.title,
+                    summary: r.summary,
+                    score: r.score,
+                });
+            }
+        }
+        if (includePlans) {
+            const planResults = index.searchPlans(query, perProjectLimit);
+            for (const r of planResults) {
+                allResults.push({
+                    projectSlug: slug,
+                    entryId: r.id,
+                    entryType: "plan",
+                    title: r.title,
+                    summary: r.summary,
+                    score: r.score,
+                });
+            }
+        }
+    }
+    // Sort by score descending
+    allResults.sort((a, b) => b.score - a.score);
+    // Apply kind filter if specified (for knowledge entries only)
+    let filtered = allResults;
+    if (options.kind) {
+        // We need to enrich knowledge entries with their kind to filter.
+        // Since buildProjectRetrievalIndex doesn't expose kind, we do a lazy
+        // enrichment by re-reading knowledge indexes for projects that have results.
+        filtered = await filterByKind(allResults, options.kind);
+    }
+    return filtered.slice(0, limit);
+}
+/**
+ * Post-filter results by knowledge kind. Plan entries pass through unfiltered.
+ */
+async function filterByKind(results, kind) {
+    // Build a map of project -> Set<entryId> that match the kind
+    const kindCache = new Map();
+    const projectSlugs = [
+        ...new Set(results.filter((r) => r.entryType === "knowledge").map((r) => r.projectSlug)),
+    ];
+    for (const slug of projectSlugs) {
+        try {
+            const projectDir = getProjectDir(slug);
+            const knowledgeIndex = await readKnowledgeIndex(projectDir);
+            const matchingIds = new Set(knowledgeIndex.entries.filter((e) => e.kind === kind).map((e) => e.id));
+            kindCache.set(slug, matchingIds);
+        }
+        catch {
+            kindCache.set(slug, new Set());
+        }
+    }
+    return results.filter((r) => {
+        if (r.entryType !== "knowledge")
+            return true;
+        const allowed = kindCache.get(r.projectSlug);
+        return allowed?.has(r.entryId) ?? false;
+    });
+}
+//# sourceMappingURL=cross-project-search.js.map

package/dist/retrieval/cross-project-search.js.map

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

package/dist/retrieval/graph-builder.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds an adjacency index (graph) from project metadata indexes.
+ */
+import type { AdjacencyIndex } from "./graph-types.js";
+export declare function buildAdjacencyIndex(slug: string): Promise<AdjacencyIndex>;
+//# sourceMappingURL=graph-builder.d.ts.map

package/dist/retrieval/graph-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder.d.ts","sourceRoot":"","sources":["../../src/retrieval/graph-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,kBAAkB,CAAC;AA6B7E,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAuL/E"}