@mirnoorata/codexa 0.2.0

package/dist/mcp-repo-root.js

@@ -0,0 +1,322 @@
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { runCommand } from "./command.js";
+const FOCUSED_REPO_LINE_PATTERN = /\bfocused\s+(?:project|repo|repository)\s*:\s*(?:`([^`]+)`|([^\r\n#]+))/iu;
+const DEFAULT_REPO_LINE_PATTERN = /\bdefault\s+(?:repo|repository)\s*:\s*(?:`([^`]+)`|([^\r\n#|]+))/iu;
+const ACTIVE_PROJECT_FOCUS_LINE_PATTERN = /\bactive\s+project\s+focus\s*:/iu;
+const BACKTICKED_ABSOLUTE_PATH_PATTERN = /`(\/[^`]+)`/u;
+const ACTIVE_PROJECT_FOCUS_REPO_PATTERN = /\b(?:via\s+)?(?:repo|repository)\s+(\/[^\s#|.,;:]+)/iu;
+const COMPACT_PROJECT_LINE_PATTERN = /^\s*(?:[-*]\s*)?project\s*:\s*(?:`([^`]+)`|([^\r\n#]+))/iu;
+const HEADING_PATTERN = /^\s{0,3}#{1,6}\s+(.+?)\s*#*\s*$/u;
+export async function shouldPreferConfiguredRepoRoot(configuredRootInput, options = {}) {
+    const configuredRoot = path.resolve(configuredRootInput);
+    if (options.workspaceFocusFile || options.workspaceSessionId) {
+        return false;
+    }
+    try {
+        await fs.access(path.join(configuredRoot, ".codex", "config.toml"));
+    }
+    catch {
+        return false;
+    }
+    return !(await localWorkspaceFocusOverridesConfiguredRoot(configuredRoot));
+}
+export async function resolveMcpRepoRoot(configuredRootInput, options = {}) {
+    const configuredRoot = path.resolve(configuredRootInput);
+    const configuredRootIsGitRepo = (await gitRootFor(configuredRoot)) !== null;
+    const workspaceRoutingRequested = Boolean(options.workspaceFocusFile || options.workspaceSessionId);
+    if (configuredRootIsGitRepo && options.preferConfiguredRoot && !workspaceRoutingRequested) {
+        return { configuredRoot, repoRoot: configuredRoot, source: "configured-root" };
+    }
+    for await (const candidate of focusFileRepoCandidates(configuredRoot, options)) {
+        const repoRoot = await validatedRepoRoot(candidate);
+        const insideConfiguredRoot = repoRoot ? await isInsideOrSamePath(repoRoot, configuredRoot) : false;
+        if (repoRoot && insideConfiguredRoot) {
+            return {
+                configuredRoot,
+                repoRoot,
+                source: candidate.source,
+                focusFile: candidate.focusFile,
+                focusReason: candidate.focusReason,
+                workspaceSessionId: candidate.workspaceSessionId,
+                warnings: candidate.warnings
+            };
+        }
+        if (candidate.strict) {
+            throw new Error(`Codexa MCP workspace session${candidate.workspaceSessionId ? ` ${candidate.workspaceSessionId}` : ""} resolved to an invalid or out-of-workspace repo in ${candidate.focusFile ?? "workspace focus"}: ${candidate.path}`);
+        }
+    }
+    if (configuredRootIsGitRepo) {
+        return { configuredRoot, repoRoot: configuredRoot, source: "configured-root" };
+    }
+    for (const candidate of environmentRepoCandidates()) {
+        const repoRoot = await validatedRepoRoot(candidate);
+        if (repoRoot) {
+            return { configuredRoot, repoRoot, source: candidate.source, focusReason: "environment" };
+        }
+    }
+    const focusFiles = focusFileCandidates(configuredRoot, options).map((file) => path.resolve(file));
+    const focusHint = focusFiles.length > 0
+        ? ` Add an "Active Focus" project line or "Focused project: /absolute/path/to/repo" to ${focusFiles.join(" or ")}.`
+        : "";
+    throw new Error(`Codexa MCP configured root is not a git repository and no focused git repository could be resolved: ${configuredRoot}. Set CODEXA_REPO or CODEXA_FOCUSED_REPO to a git repository.${focusHint}`);
+}
+function environmentRepoCandidates() {
+    return [process.env.CODEXA_REPO, process.env.CODEXA_FOCUSED_REPO]
+        .filter((value) => typeof value === "string" && value.trim().length > 0)
+        .map((value) => ({ path: value, source: "environment" }));
+}
+async function* focusFileRepoCandidates(configuredRoot, options) {
+    for (const focusFile of focusFileCandidates(configuredRoot, options)) {
+        const focusFilePath = path.resolve(focusFile);
+        const selection = await readFocusedRepoPaths(focusFilePath, options);
+        for (const repoPath of selection.paths) {
+            yield {
+                path: repoPath,
+                source: "workspace-focus-file",
+                focusFile: focusFilePath,
+                focusReason: selection.focusReason,
+                workspaceSessionId: selection.workspaceSessionId,
+                strict: selection.strict,
+                warnings: selection.warnings
+            };
+        }
+    }
+}
+function focusFileCandidates(configuredRoot, options) {
+    const candidates = [
+        options.workspaceFocusFile,
+        process.env.CODEXA_WORKSPACE_FOCUS_FILE,
+        path.join(configuredRoot, ".codex", "WORKING.md")
+    ].filter((value) => typeof value === "string" && value.trim().length > 0);
+    return [...new Set(candidates.map((candidate) => path.resolve(candidate)))];
+}
+async function readFocusedRepoPaths(focusFile, options) {
+    let text;
+    try {
+        text = await fs.readFile(focusFile, "utf8");
+    }
+    catch {
+        return emptyFocusFileSelection();
+    }
+    const workspaceSessionId = normalizeWorkspaceSessionId(options.workspaceSessionId ?? process.env.CODEXA_WORKSPACE_SESSION ?? process.env.SESSION_ID);
+    const selectedSessionPaths = [];
+    const explicitPaths = [];
+    const activeSessionPaths = [];
+    const defaultPaths = [];
+    let activeSessionRowsSeen = 0;
+    let inActiveFocusSection = false;
+    let inActiveSessionsSection = false;
+    let activeSessionSessionColumn = -1;
+    let activeSessionRepoColumn = -1;
+    let activeSessionStatusColumn = -1;
+    for (const line of text.split(/\r?\n/u)) {
+        const heading = HEADING_PATTERN.exec(line);
+        if (heading) {
+            const headingText = heading[1].trim().toLowerCase();
+            inActiveFocusSection = headingText === "active focus";
+            inActiveSessionsSection = headingText === "active sessions";
+            activeSessionSessionColumn = -1;
+            activeSessionRepoColumn = -1;
+            activeSessionStatusColumn = -1;
+            continue;
+        }
+        const focusedMatch = FOCUSED_REPO_LINE_PATTERN.exec(line);
+        if (focusedMatch) {
+            pushFocusedRepoPath(explicitPaths, focusedMatch[1] ?? focusedMatch[2] ?? "");
+            continue;
+        }
+        const activeProjectFocusPath = activeProjectFocusPathFromLine(line);
+        if (activeProjectFocusPath) {
+            pushFocusedRepoPath(explicitPaths, activeProjectFocusPath);
+            continue;
+        }
+        const defaultRepoMatch = DEFAULT_REPO_LINE_PATTERN.exec(line);
+        if (defaultRepoMatch) {
+            pushFocusedRepoPath(defaultPaths, defaultRepoMatch[1] ?? defaultRepoMatch[2] ?? "");
+            continue;
+        }
+        if (inActiveFocusSection) {
+            const projectMatch = COMPACT_PROJECT_LINE_PATTERN.exec(line);
+            if (projectMatch) {
+                pushFocusedRepoPath(explicitPaths, projectMatch[1] ?? projectMatch[2] ?? "");
+            }
+        }
+        if (inActiveSessionsSection) {
+            const cells = markdownTableCells(line);
+            if (!cells) {
+                continue;
+            }
+            if (isMarkdownSeparatorRow(cells)) {
+                continue;
+            }
+            const lowerCells = cells.map((cell) => cell.trim().toLowerCase());
+            const repoColumn = lowerCells.indexOf("repo");
+            if (repoColumn >= 0) {
+                activeSessionSessionColumn = lowerCells.indexOf("session");
+                activeSessionRepoColumn = repoColumn;
+                activeSessionStatusColumn = lowerCells.indexOf("status");
+                continue;
+            }
+            if (activeSessionRepoColumn >= 0 && activeSessionRepoColumn < cells.length) {
+                const status = activeSessionStatusColumn >= 0 ? cells[activeSessionStatusColumn]?.trim().toLowerCase() : "";
+                if (isActiveSessionStatus(status)) {
+                    activeSessionRowsSeen += 1;
+                    pushFocusedRepoPath(activeSessionPaths, cells[activeSessionRepoColumn] ?? "");
+                    if (workspaceSessionId && activeSessionSessionColumn >= 0 && normalizeWorkspaceSessionId(cells[activeSessionSessionColumn] ?? "") === workspaceSessionId) {
+                        pushFocusedRepoPath(selectedSessionPaths, cells[activeSessionRepoColumn] ?? "");
+                    }
+                }
+            }
+        }
+    }
+    if (workspaceSessionId && activeSessionRowsSeen > 0 && selectedSessionPaths.length === 0) {
+        throw new Error(`Codexa MCP workspace session ${workspaceSessionId} is not active in ${path.resolve(focusFile)}`);
+    }
+    return firstUnambiguousPriority([
+        { paths: selectedSessionPaths, focusReason: "selected-session", allowFallbackWhenAmbiguous: false, strict: true, workspaceSessionId },
+        { paths: explicitPaths, focusReason: "explicit-focus", allowFallbackWhenAmbiguous: false, strict: false },
+        { paths: activeSessionPaths, focusReason: "active-session", allowFallbackWhenAmbiguous: false, strict: false },
+        { paths: defaultPaths, focusReason: "workspace-default", allowFallbackWhenAmbiguous: false, strict: false }
+    ], focusFile);
+}
+function emptyFocusFileSelection() {
+    return { paths: [], strict: false, warnings: [] };
+}
+function activeProjectFocusPathFromLine(line) {
+    if (!ACTIVE_PROJECT_FOCUS_LINE_PATTERN.test(line)) {
+        return undefined;
+    }
+    return BACKTICKED_ABSOLUTE_PATH_PATTERN.exec(line)?.[1] ?? ACTIVE_PROJECT_FOCUS_REPO_PATTERN.exec(line)?.[1];
+}
+function pushFocusedRepoPath(paths, raw) {
+    const cleaned = raw.trim().replace(/^`|`$/gu, "").replace(/[.,;:]+$/u, "");
+    if (cleaned) {
+        paths.push(cleaned);
+    }
+}
+function uniquePaths(paths) {
+    return [...new Set(paths)];
+}
+function firstUnambiguousPriority(groups, focusFile) {
+    let deferredAmbiguity = null;
+    const warnings = [];
+    for (const group of groups) {
+        const paths = uniquePaths(group.paths);
+        if (paths.length === 0) {
+            continue;
+        }
+        const normalized = uniquePaths(paths.map((entry) => normalizeCandidatePath(entry)).filter((entry) => Boolean(entry)));
+        if (normalized.length > 1) {
+            if (group.allowFallbackWhenAmbiguous) {
+                deferredAmbiguity = deferredAmbiguity ?? { focusReason: group.focusReason, paths: normalized };
+                warnings.push(`Codexa MCP ${group.focusReason ?? "workspace"} focus is ambiguous in ${path.resolve(focusFile)}: ${normalized.join(", ")}. Falling back to lower-priority focus.`);
+                continue;
+            }
+            throw new Error(`Codexa MCP workspace focus is ambiguous in ${path.resolve(focusFile)}: ${normalized.join(", ")}`);
+        }
+        return {
+            paths,
+            focusReason: group.focusReason,
+            workspaceSessionId: group.workspaceSessionId,
+            strict: group.strict,
+            warnings
+        };
+    }
+    if (deferredAmbiguity) {
+        throw new Error(`Codexa MCP workspace focus is ambiguous in ${path.resolve(focusFile)}: ${deferredAmbiguity.paths.join(", ")}`);
+    }
+    return { paths: [], strict: false, warnings };
+}
+function markdownTableCells(line) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith("|") || !trimmed.endsWith("|")) {
+        return null;
+    }
+    return trimmed
+        .slice(1, -1)
+        .split("|")
+        .map((cell) => cell.trim());
+}
+function isMarkdownSeparatorRow(cells) {
+    return cells.length > 0 && cells.every((cell) => /^:?-{3,}:?$/u.test(cell.trim()));
+}
+function isActiveSessionStatus(status) {
+    return ["active", "in_progress", "running"].includes(String(status ?? "").trim().toLowerCase());
+}
+function normalizeCandidatePath(candidate) {
+    const trimmed = candidate.trim();
+    if (!trimmed || !path.isAbsolute(trimmed)) {
+        return null;
+    }
+    return path.resolve(trimmed);
+}
+function normalizeWorkspaceSessionId(candidate) {
+    const trimmed = candidate?.trim().replace(/^`|`$/gu, "");
+    return trimmed ? trimmed : undefined;
+}
+async function validatedRepoRoot(candidate) {
+    const repoRoot = normalizeCandidatePath(candidate.path);
+    return repoRoot ? await gitRootFor(repoRoot) : null;
+}
+async function gitRootFor(candidate) {
+    try {
+        const stat = await fs.stat(candidate);
+        if (!stat.isDirectory()) {
+            return null;
+        }
+    }
+    catch {
+        return null;
+    }
+    const result = await runCommand("git", ["-C", candidate, "rev-parse", "--show-toplevel"], {
+        timeoutMs: 2_500,
+        maxBufferBytes: 64 * 1024
+    });
+    const root = result.stdout.trim();
+    return result.ok && root.length > 0 ? path.resolve(root) : null;
+}
+async function isInsideOrSamePath(candidate, root) {
+    const [realCandidate, realRoot] = await Promise.all([realPathOrResolved(candidate), realPathOrResolved(root)]);
+    const relative = path.relative(realRoot, realCandidate);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+async function isSamePath(left, right) {
+    const [realLeft, realRight] = await Promise.all([realPathOrResolved(left), realPathOrResolved(right)]);
+    return realLeft === realRight;
+}
+async function realPathOrResolved(candidate) {
+    try {
+        return await fs.realpath(candidate);
+    }
+    catch {
+        return path.resolve(candidate);
+    }
+}
+async function localWorkspaceFocusOverridesConfiguredRoot(configuredRoot) {
+    const focusFile = path.join(configuredRoot, ".codex", "WORKING.md");
+    try {
+        await fs.access(focusFile);
+    }
+    catch {
+        return false;
+    }
+    let selection;
+    try {
+        selection = await readFocusedRepoPaths(focusFile, {});
+    }
+    catch {
+        return true;
+    }
+    for (const candidatePath of selection.paths) {
+        const repoRoot = await validatedRepoRoot({ path: candidatePath, source: "workspace-focus-file" });
+        if (!repoRoot || !(await isInsideOrSamePath(repoRoot, configuredRoot))) {
+            continue;
+        }
+        if (!(await isSamePath(repoRoot, configuredRoot))) {
+            return true;
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=mcp-repo-root.js.map

package/dist/mcp-repo-root.js.map

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

package/dist/mcp-tool-catalog.d.ts

@@ -0,0 +1,2 @@
+export { ADVANCED_MCP_TOOL_NAMES, MCP_TOOL_CATALOG, MCP_TOOL_NAMES, MCP_TOOL_REGISTRY, MEMORY_RECORDING_MCP_TOOL_NAMES, NO_SOURCE_MUTATION_CONTRACT, PRIMARY_CODEX_LOOP, PRIMARY_MCP_TOOL_NAMES, SOURCE_CONTEXT_MCP_TOOL_NAMES, mcpToolRegistryEntry } from "./mcp/tool-registry.js";
+export type { McpToolCatalogEntry, McpToolName, McpToolPhase, McpToolRegistryEntry, McpToolTier } from "./mcp/tool-registry.js";

package/dist/mcp-tool-catalog.js

@@ -0,0 +1,2 @@
+export { ADVANCED_MCP_TOOL_NAMES, MCP_TOOL_CATALOG, MCP_TOOL_NAMES, MCP_TOOL_REGISTRY, MEMORY_RECORDING_MCP_TOOL_NAMES, NO_SOURCE_MUTATION_CONTRACT, PRIMARY_CODEX_LOOP, PRIMARY_MCP_TOOL_NAMES, SOURCE_CONTEXT_MCP_TOOL_NAMES, mcpToolRegistryEntry } from "./mcp/tool-registry.js";
+//# sourceMappingURL=mcp-tool-catalog.js.map

package/dist/mcp-tool-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-catalog.js","sourceRoot":"","sources":["../src/mcp-tool-catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,+BAA+B,EAC/B,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,6BAA6B,EAC7B,oBAAoB,EACrB,MAAM,wBAAwB,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,11 @@
+import type { QueryOptions } from "./types.js";
+export { compactMcpResult, compactNonPostEditMcpResult, compactPostEditMcpResult } from "./mcp/compaction.js";
+export { MCP_TOOL_CATALOG, PRIMARY_CODEX_LOOP, PRIMARY_MCP_TOOL_NAMES } from "./mcp-tool-catalog.js";
+export type McpTransportKind = "stdio" | "http";
+export interface ServeMcpHttpOptions {
+    host?: string;
+    port: number;
+    endpoint?: string;
+}
+export declare function serveMcp(repoRoot: string, options?: QueryOptions): Promise<void>;
+export declare function serveMcpHttp(repoRoot: string, options: QueryOptions | undefined, httpOptions: ServeMcpHttpOptions): Promise<void>;