@codemap-ai/core 0.2.0

package/dist/lib/markdown-fence.js

@@ -0,0 +1,98 @@
+const FENCE_LANGUAGE_BY_EXTENSION = {
+    bash: "bash",
+    c: "c",
+    cc: "cpp",
+    cjs: "js",
+    cpp: "cpp",
+    cs: "csharp",
+    css: "css",
+    dart: "dart",
+    go: "go",
+    h: "c",
+    hpp: "cpp",
+    html: "html",
+    java: "java",
+    js: "js",
+    json: "json",
+    jsonc: "jsonc",
+    jsx: "jsx",
+    kt: "kotlin",
+    kts: "kotlin",
+    md: "md",
+    mdx: "mdx",
+    mjs: "js",
+    php: "php",
+    py: "py",
+    rb: "ruby",
+    rs: "rust",
+    sh: "bash",
+    sql: "sql",
+    swift: "swift",
+    toml: "toml",
+    ts: "ts",
+    tsx: "tsx",
+    vue: "vue",
+    xml: "xml",
+    yaml: "yaml",
+    yml: "yaml",
+};
+const FENCE_LANGUAGE_BY_NAME = {
+    bash: "bash",
+    c: "c",
+    "c#": "csharp",
+    csharp: "csharp",
+    "c++": "cpp",
+    cpp: "cpp",
+    css: "css",
+    dart: "dart",
+    go: "go",
+    html: "html",
+    java: "java",
+    javascript: "js",
+    js: "js",
+    json: "json",
+    jsonc: "jsonc",
+    kotlin: "kotlin",
+    markdown: "md",
+    md: "md",
+    php: "php",
+    python: "py",
+    py: "py",
+    ruby: "ruby",
+    rust: "rust",
+    shell: "bash",
+    sh: "bash",
+    sql: "sql",
+    swift: "swift",
+    text: "text",
+    ts: "ts",
+    tsx: "tsx",
+    typescript: "ts",
+    vue: "vue",
+    xml: "xml",
+    yaml: "yaml",
+};
+function normalizeExtension(extension) {
+    const normalized = extension?.trim().toLowerCase().replace(/^\./, "");
+    return normalized || null;
+}
+function extensionFromPath(path) {
+    const clean = path?.trim().split("?")[0]?.replace(/^[ab]\//, "");
+    const extension = clean?.split(".").pop();
+    return normalizeExtension(extension);
+}
+function normalizeLanguage(language) {
+    const normalized = language?.trim().toLowerCase();
+    return normalized || null;
+}
+export function markdownFenceLanguage(input) {
+    const extension = normalizeExtension(input.extension) ?? extensionFromPath(input.path);
+    const language = normalizeLanguage(input.language);
+    return ((extension ? FENCE_LANGUAGE_BY_EXTENSION[extension] : undefined) ??
+        (language ? FENCE_LANGUAGE_BY_NAME[language] : undefined) ??
+        "");
+}
+export function markdownFenceStart(input) {
+    return `\`\`\`${markdownFenceLanguage(input)}`;
+}
+//# sourceMappingURL=markdown-fence.js.map

package/dist/lib/markdown-fence.js.map

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

package/dist/lib/mcp-auth.d.ts

@@ -0,0 +1,39 @@
+import type { McpAuthClaimResponse, McpAuthMeResponse, McpAuthStatusResponse, McpStartAuthResponse } from "@codemap-ai/shared";
+import { type McpConfigUser, type McpServerConfig } from "../config.js";
+import { type CodeMapClient } from "./codemap-api.js";
+export type StartAuthResponse = McpStartAuthResponse;
+export type AuthStatusResponse = McpAuthStatusResponse;
+export type ClaimAuthResponse = McpAuthClaimResponse;
+export interface WaitForAuthResult {
+    authenticated: boolean;
+    status: AuthStatusResponse["status"];
+    apiUrl: string;
+    user: McpConfigUser | null;
+    expiresAt: string | null;
+    timedOut?: boolean;
+}
+export declare function startMcpLogin(client: CodeMapClient): Promise<McpStartAuthResponse>;
+export declare function getMcpAuthStatus(client: CodeMapClient, sessionId: string): Promise<McpAuthStatusResponse>;
+export declare function getMcpWhoAmI(client: CodeMapClient): Promise<McpAuthMeResponse>;
+export declare function claimMcpAuthSession(client: CodeMapClient, sessionId: string): Promise<McpAuthClaimResponse>;
+export declare function persistAuthorizedSession(config: McpServerConfig, status: Pick<ClaimAuthResponse, "apiUrl" | "apiKey" | "user">): Promise<void>;
+export declare function pollMcpAuthUntilDone(config: McpServerConfig, sessionId: string, options?: {
+    expiresAt?: string | null;
+    pollIntervalMs?: number | null;
+    maxWaitMs?: number | null;
+}): Promise<WaitForAuthResult>;
+export declare function runLoginFlow(config: McpServerConfig): Promise<{
+    openedBrowser: boolean;
+    authorizeUrl: string;
+    user: McpConfigUser | null;
+    apiUrl: string;
+}>;
+export declare function tryOpenLoginBrowser(authorizeUrl: string): Promise<boolean>;
+export declare function waitForLoginAuthorization(config: McpServerConfig, startResponse: StartAuthResponse): Promise<{
+    sessionId: string;
+    status: "authorized";
+    expiresAt: string | null;
+    apiUrl: string;
+    user: McpConfigUser | null;
+}>;
+//# sourceMappingURL=mcp-auth.d.ts.map

package/dist/lib/mcp-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-auth.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,eAAe,EAErB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG3E,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AACrD,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AACvD,MAAM,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAGrD,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa,iCAQxD;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,kCAI9E;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,aAAa,8BAIvD;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iCAKjF;AAED,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC,iBAyB9D;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,GACA,OAAO,CAAC,iBAAiB,CAAC,CA0G5B;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,eAAe;;;;;GAYzD;AAED,wBAAsB,mBAAmB,CAAC,YAAY,EAAE,MAAM,oBAO7D;AAED,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,eAAe,EACvB,aAAa,EAAE,iBAAiB;;;;;;GA0BjC"}

package/dist/lib/mcp-auth.js

@@ -0,0 +1,184 @@
+import os from "node:os";
+import { saveGlobalConfig, } from "../config.js";
+import { createCodeMapClient } from "./codemap-api.js";
+import { openUrlInBrowser } from "./open-url.js";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export async function startMcpLogin(client) {
+    return client.request("/mcp/auth/start", {
+        method: "POST",
+        body: {
+            clientName: "CodeMap MCP",
+            deviceName: os.hostname(),
+        },
+    });
+}
+export async function getMcpAuthStatus(client, sessionId) {
+    return client.request("/mcp/auth/status", {
+        query: { sessionId },
+    });
+}
+export async function getMcpWhoAmI(client) {
+    return client.request("/mcp/auth/me", {
+        authRequired: true,
+    });
+}
+export async function claimMcpAuthSession(client, sessionId) {
+    return client.request("/mcp/auth/claim", {
+        method: "POST",
+        body: { sessionId },
+    });
+}
+export async function persistAuthorizedSession(config, status) {
+    if (!status.apiKey) {
+        throw new Error("Cannot persist MCP auth session without an API key.");
+    }
+    const auth = {
+        method: "api_key",
+        createdAt: new Date().toISOString(),
+        lastValidatedAt: new Date().toISOString(),
+    };
+    const apiUrl = status.apiUrl || config.apiUrl;
+    await saveGlobalConfig({
+        globalConfigPath: config.globalConfigPath,
+        apiUrl,
+        apiToken: status.apiKey,
+        user: status.user ?? null,
+        auth,
+    });
+    config.apiUrl = apiUrl;
+    config.apiToken = status.apiKey;
+    config.user = status.user ?? null;
+    config.auth = auth;
+}
+export async function pollMcpAuthUntilDone(config, sessionId, options) {
+    // Client created once for the lifetime of this poll loop
+    const client = createCodeMapClient(config);
+    const pollIntervalMs = options?.pollIntervalMs && options.pollIntervalMs > 0
+        ? options.pollIntervalMs
+        : 2000;
+    let effectiveExpiresAt = options?.expiresAt ?? null;
+    const startedAtMs = Date.now();
+    const maxWaitMs = options?.maxWaitMs !== undefined && options.maxWaitMs !== null
+        ? Math.max(0, options.maxWaitMs)
+        : null;
+    while (true) {
+        const status = await getMcpAuthStatus(client, sessionId);
+        if (!effectiveExpiresAt && status.expiresAt) {
+            effectiveExpiresAt = status.expiresAt;
+        }
+        const expiresAtMs = effectiveExpiresAt
+            ? new Date(effectiveExpiresAt).getTime()
+            : null;
+        if (status.status === "authorized") {
+            try {
+                const claimResult = await claimMcpAuthSession(client, sessionId);
+                await persistAuthorizedSession(config, claimResult);
+                return {
+                    authenticated: true,
+                    status: "authorized",
+                    apiUrl: claimResult.apiUrl || config.apiUrl,
+                    user: claimResult.user ?? null,
+                    expiresAt: claimResult.expiresAt ?? effectiveExpiresAt,
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                if (message.includes("already been claimed")) {
+                    throw new Error("Authorization completed, but the CodeMap MCP API key was already claimed by another client or request.");
+                }
+                throw error;
+            }
+        }
+        if (status.status === "expired") {
+            return {
+                authenticated: false,
+                status: "expired",
+                apiUrl: status.apiUrl || config.apiUrl,
+                user: status.user ?? null,
+                expiresAt: effectiveExpiresAt,
+            };
+        }
+        if (status.status === "denied") {
+            return {
+                authenticated: false,
+                status: "denied",
+                apiUrl: status.apiUrl || config.apiUrl,
+                user: status.user ?? null,
+                expiresAt: effectiveExpiresAt,
+            };
+        }
+        const nowMs = Date.now();
+        if (expiresAtMs !== null && nowMs >= expiresAtMs) {
+            return {
+                authenticated: false,
+                status: "expired",
+                apiUrl: status.apiUrl || config.apiUrl,
+                user: status.user ?? null,
+                expiresAt: effectiveExpiresAt,
+            };
+        }
+        if (maxWaitMs !== null && nowMs - startedAtMs >= maxWaitMs) {
+            return {
+                authenticated: false,
+                status: "pending",
+                apiUrl: status.apiUrl || config.apiUrl,
+                user: status.user ?? null,
+                expiresAt: effectiveExpiresAt,
+                timedOut: true,
+            };
+        }
+        const sleepMs = Math.min(pollIntervalMs, expiresAtMs !== null ? Math.max(0, expiresAtMs - nowMs) : pollIntervalMs, maxWaitMs !== null
+            ? Math.max(0, maxWaitMs - (nowMs - startedAtMs))
+            : pollIntervalMs);
+        if (sleepMs <= 0) {
+            continue;
+        }
+        await sleep(sleepMs);
+    }
+}
+export async function runLoginFlow(config) {
+    const client = createCodeMapClient(config);
+    const startResponse = await startMcpLogin(client);
+    const openedBrowser = await tryOpenLoginBrowser(startResponse.authorizeUrl);
+    const result = await waitForLoginAuthorization(config, startResponse);
+    return {
+        openedBrowser,
+        authorizeUrl: startResponse.authorizeUrl,
+        user: result.user ?? null,
+        apiUrl: result.apiUrl || config.apiUrl,
+    };
+}
+export async function tryOpenLoginBrowser(authorizeUrl) {
+    try {
+        await openUrlInBrowser(authorizeUrl);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function waitForLoginAuthorization(config, startResponse) {
+    const result = await pollMcpAuthUntilDone(config, startResponse.sessionId, {
+        expiresAt: startResponse.expiresAt,
+        pollIntervalMs: startResponse.pollIntervalMs,
+    });
+    if (result.status === "authorized") {
+        return {
+            sessionId: startResponse.sessionId,
+            status: "authorized",
+            expiresAt: result.expiresAt,
+            apiUrl: result.apiUrl,
+            user: result.user,
+        };
+    }
+    if (result.status === "expired") {
+        throw new Error("MCP login session expired before authorization completed.");
+    }
+    if (result.status === "denied") {
+        throw new Error("MCP login was denied.");
+    }
+    throw new Error("MCP login timed out before authorization completed.");
+}
+//# sourceMappingURL=mcp-auth.js.map

package/dist/lib/mcp-auth.js.map

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

package/dist/lib/monorepo-root.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Find the monorepo root directory from a given cwd.
+ * Uses @manypkg/get-packages (supports pnpm/yarn/npm/bun workspaces).
+ * Falls back to git toplevel, then cwd itself.
+ */
+export declare function findMonorepoRoot(cwd: string): Promise<string>;
+//# sourceMappingURL=monorepo-root.d.ts.map

package/dist/lib/monorepo-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo-root.d.ts","sourceRoot":"","sources":["../../src/lib/monorepo-root.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAanE"}

package/dist/lib/monorepo-root.js

@@ -0,0 +1,23 @@
+import { getPackages } from "@manypkg/get-packages";
+import { spawnSync } from "node:child_process";
+/**
+ * Find the monorepo root directory from a given cwd.
+ * Uses @manypkg/get-packages (supports pnpm/yarn/npm/bun workspaces).
+ * Falls back to git toplevel, then cwd itself.
+ */
+export async function findMonorepoRoot(cwd) {
+    try {
+        const { rootDir } = await getPackages(cwd);
+        return rootDir;
+    }
+    catch {
+        // getPackages throws when no package.json found or not a monorepo.
+        // Fall back to git toplevel.
+        const git = spawnSync("git", ["rev-parse", "--show-toplevel"], {
+            encoding: "utf8",
+            cwd,
+        });
+        return git.stdout?.trim() || cwd;
+    }
+}
+//# sourceMappingURL=monorepo-root.js.map

package/dist/lib/monorepo-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo-root.js","sourceRoot":"","sources":["../../src/lib/monorepo-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,6BAA6B;QAC7B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE;YAC7D,QAAQ,EAAE,MAAM;YAChB,GAAG;SACJ,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/lib/onboarding.d.ts

@@ -0,0 +1,5 @@
+type OnboardingTarget = "claude" | "cursor" | "codex" | "gemini" | "opencode" | "copilot";
+export declare function buildOnboardingGuide(target: OnboardingTarget | "all"): string;
+export declare function isOnboardingTarget(value: string): value is OnboardingTarget;
+export {};
+//# sourceMappingURL=onboarding.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAAA,KAAK,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAkG1F,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,MAAM,CAO7E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E"}

package/dist/lib/onboarding.js

@@ -0,0 +1,96 @@
+const DIVIDER = "─".repeat(50);
+const MCP_JSON_SNIPPET = (key) => [
+    `  {`,
+    `    "${key}": {`,
+    `      "codemap-mcp": {`,
+    `        "command": "npx",`,
+    `        "args": ["-y", "@codemap-ai/cli"]`,
+    `      }`,
+    `    }`,
+    `  }`,
+].join("\n");
+const COMMON_STEPS_AFTER_SERVER = [
+    "",
+    "2. Authenticate",
+    "   $ codemap login",
+    "",
+    "3. Verify (inside the editor / agent)",
+    "   Call: ping  →  expect reply \"pong\"",
+    "",
+    "4. Link this project",
+    "   Call: link_project",
+    "         (or create_project if no CodeMap project exists yet)",
+    "",
+    "5. Build local index",
+    "   Call: refresh_local_index",
+].join("\n");
+const FOOTER = [
+    "",
+    DIVIDER,
+    "  Done! For every broad task, start with:",
+    "  explore_task(task=<description>) when files are unclear",
+    DIVIDER,
+].join("\n");
+function guide(title, step1Lines) {
+    return [
+        DIVIDER,
+        `  CodeMap MCP — ${title} Setup`,
+        DIVIDER,
+        "",
+        ...step1Lines,
+        COMMON_STEPS_AFTER_SERVER,
+        FOOTER,
+    ].join("\n");
+}
+const GUIDES = {
+    claude: guide("Claude Code", [
+        "1. Add MCP server",
+        "   $ claude mcp add codemap-mcp -- npx -y @codemap-ai/cli",
+    ]),
+    cursor: guide("Cursor", [
+        "1. Add MCP server — create or edit .cursor/mcp.json:",
+        MCP_JSON_SNIPPET("mcpServers"),
+        "   Then restart Cursor.",
+    ]),
+    codex: guide("Codex", [
+        "1. Add MCP server — add to ~/.codex/config.toml:",
+        "  [mcp_servers.codemap]",
+        "  command = \"npx\"",
+        "  args = [\"-y\", \"@codemap-ai/cli\"]",
+    ]),
+    gemini: guide("Gemini CLI", [
+        "1. Add MCP server — edit ~/.gemini/settings.json:",
+        MCP_JSON_SNIPPET("mcpServers"),
+    ]),
+    opencode: guide("OpenCode", [
+        "1. Add MCP server — edit opencode.json (project root):",
+        [
+            "  {",
+            "    \"mcp\": {",
+            "      \"codemap-mcp\": {",
+            "        \"command\": \"npx\",",
+            "        \"args\": [\"-y\", \"@codemap-ai/cli\"],",
+            "        \"enabled\": true",
+            "      }",
+            "    }",
+            "  }",
+        ].join("\n"),
+    ]),
+    copilot: guide("GitHub Copilot (VS Code)", [
+        "1. Add MCP server — create or edit .vscode/mcp.json:",
+        MCP_JSON_SNIPPET("servers"),
+        "   Then reload VS Code (Ctrl+Shift+P → Developer: Reload Window).",
+    ]),
+};
+export function buildOnboardingGuide(target) {
+    if (target === "all") {
+        return Object.keys(GUIDES)
+            .map((t) => GUIDES[t])
+            .join("\n\n");
+    }
+    return GUIDES[target];
+}
+export function isOnboardingTarget(value) {
+    return value in GUIDES;
+}
+//# sourceMappingURL=onboarding.js.map

package/dist/lib/onboarding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.js","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAE/B,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE,CACvC;IACE,KAAK;IACL,QAAQ,GAAG,MAAM;IACjB,wBAAwB;IACxB,2BAA2B;IAC3B,2CAA2C;IAC3C,SAAS;IACT,OAAO;IACP,KAAK;CACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEf,MAAM,yBAAyB,GAAG;IAChC,EAAE;IACF,iBAAiB;IACjB,oBAAoB;IACpB,EAAE;IACF,uCAAuC;IACvC,yCAAyC;IACzC,EAAE;IACF,sBAAsB;IACtB,uBAAuB;IACvB,+DAA+D;IAC/D,EAAE;IACF,sBAAsB;IACtB,8BAA8B;CAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,MAAM,GAAG;IACb,EAAE;IACF,OAAO;IACP,2CAA2C;IAC3C,2DAA2D;IAC3D,OAAO;CACR,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAS,KAAK,CAAC,KAAa,EAAE,UAAoB;IAChD,OAAO;QACL,OAAO;QACP,mBAAmB,KAAK,QAAQ;QAChC,OAAO;QACP,EAAE;QACF,GAAG,UAAU;QACb,yBAAyB;QACzB,MAAM;KACP,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,MAAM,GAAqC;IAC/C,MAAM,EAAE,KAAK,CAAC,aAAa,EAAE;QAC3B,mBAAmB;QACnB,2DAA2D;KAC5D,CAAC;IAEF,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE;QACtB,sDAAsD;QACtD,gBAAgB,CAAC,YAAY,CAAC;QAC9B,yBAAyB;KAC1B,CAAC;IAEF,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE;QACpB,kDAAkD;QAClD,yBAAyB;QACzB,qBAAqB;QACrB,wCAAwC;KACzC,CAAC;IAEF,MAAM,EAAE,KAAK,CAAC,YAAY,EAAE;QAC1B,mDAAmD;QACnD,gBAAgB,CAAC,YAAY,CAAC;KAC/B,CAAC;IAEF,QAAQ,EAAE,KAAK,CAAC,UAAU,EAAE;QAC1B,wDAAwD;QACxD;YACE,KAAK;YACL,gBAAgB;YAChB,0BAA0B;YAC1B,+BAA+B;YAC/B,kDAAkD;YAClD,2BAA2B;YAC3B,SAAS;YACT,OAAO;YACP,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC;KACb,CAAC;IAEF,OAAO,EAAE,KAAK,CAAC,0BAA0B,EAAE;QACzC,sDAAsD;QACtD,gBAAgB,CAAC,SAAS,CAAC;QAC3B,mEAAmE;KACpE,CAAC;CACH,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,MAAgC;IACnE,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAQ,MAAM,CAAC,IAAI,CAAC,MAAM,CAAwB;aAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;aACrB,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,IAAI,MAAM,CAAC;AACzB,CAAC"}

package/dist/lib/open-url.d.ts

@@ -0,0 +1,7 @@
+export declare function isSupportedUrl(value: string): boolean;
+export declare function getOpenCommand(url: string): {
+    command: string;
+    args: string[];
+};
+export declare function openUrlInBrowser(url: string): Promise<void>;
+//# sourceMappingURL=open-url.d.ts.map

package/dist/lib/open-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-url.d.ts","sourceRoot":"","sources":["../../src/lib/open-url.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,WAO3C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM;;;EAkBzC;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,iBASjD"}

package/dist/lib/open-url.js

@@ -0,0 +1,38 @@
+import { spawn } from "node:child_process";
+export function isSupportedUrl(value) {
+    try {
+        const parsed = new URL(value);
+        return parsed.protocol === "http:" || parsed.protocol === "https:";
+    }
+    catch {
+        return false;
+    }
+}
+export function getOpenCommand(url) {
+    switch (process.platform) {
+        case "darwin":
+            return {
+                command: "open",
+                args: [url],
+            };
+        case "win32":
+            return {
+                command: "cmd",
+                args: ["/c", "start", "", url],
+            };
+        default:
+            return {
+                command: "xdg-open",
+                args: [url],
+            };
+    }
+}
+export async function openUrlInBrowser(url) {
+    const launcher = getOpenCommand(url);
+    const child = spawn(launcher.command, launcher.args, {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+}
+//# sourceMappingURL=open-url.js.map

package/dist/lib/open-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-url.js","sourceRoot":"","sources":["../../src/lib/open-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO;gBACL,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC;QACJ,KAAK,OAAO;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC;aAC/B,CAAC;QACJ;YACE,OAAO;gBACL,OAAO,EAAE,UAAU;gBACnB,IAAI,EAAE,CAAC,GAAG,CAAC;aACZ,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAErC,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE;QACnD,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;IAEH,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/lib/regex-utils.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeRegex(str: string): string;
+//# sourceMappingURL=regex-utils.d.ts.map

package/dist/lib/regex-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-utils.d.ts","sourceRoot":"","sources":["../../src/lib/regex-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C"}

package/dist/lib/regex-utils.js

@@ -0,0 +1,4 @@
+export function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=regex-utils.js.map

package/dist/lib/regex-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"regex-utils.js","sourceRoot":"","sources":["../../src/lib/regex-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACpD,CAAC"}

package/dist/lib/server-instructions.d.ts

@@ -0,0 +1,2 @@
+export declare function buildServerInstructions(): string;
+//# sourceMappingURL=server-instructions.d.ts.map

package/dist/lib/server-instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-instructions.d.ts","sourceRoot":"","sources":["../../src/lib/server-instructions.ts"],"names":[],"mappings":"AAAA,wBAAgB,uBAAuB,IAAI,MAAM,CAgChD"}

package/dist/lib/server-instructions.js

@@ -0,0 +1,34 @@
+export function buildServerInstructions() {
+    return `
+You are working in a CodeMap-indexed repository.
+
+## MANDATORY WORKFLOW
+
+1. BEFORE ANY BROAD TASK WITH UNCLEAR FILES → call \`explore_task(task=<description>)\`.
+2. BEFORE READING FILES → call \`explore_task\` or \`search_codebase\`. Never read files blindly.
+3. BEFORE EDITING HIGH-BLAST FILES (blast_radius ≥ 10) → call \`find_related_files\` first.
+4. AFTER EDITS → call \`diff\` to verify scope, then \`reimport(wait=true)\` if index changed.
+
+## TOOL ROUTING (quick reference)
+
+| Situation | Tool to call |
+|---|---|
+| New broad task | explore_task → get_file → get_file |
+| "Which files to read?" | find_related_files |
+| Symbol / keyword lookup | search_codebase or symbol |
+| Impact analysis | symbol / symbol |
+| Read specific symbol body | get_file(include=["symbols"], symbol_names=[...]) |
+| Survey file structure | get_file(include=["outline"]) |
+| After edits | diff → reimport(wait=true) |
+
+## HARD GATES — never skip
+
+- Do NOT grep / cat / read source files before checking CodeMap tools first.
+- Do NOT edit a file with blast_radius ≥ 10 without calling find_related_files first.
+- Do NOT declare a task complete without reviewing diff.
+- Do NOT call get_file(include=["content"]) when include=["symbols"] or include=["outline"] would suffice.
+
+Skipping these gates causes missed dependencies, broken imports, and regressions.
+`.trim();
+}
+//# sourceMappingURL=server-instructions.js.map

package/dist/lib/server-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-instructions.js","sourceRoot":"","sources":["../../src/lib/server-instructions.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,uBAAuB;IACrC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BR,CAAC,IAAI,EAAE,CAAC;AACT,CAAC"}

package/dist/lib/session-context.d.ts

@@ -0,0 +1,2 @@
+export declare function buildSessionContext(cwd: string): Promise<string>;
+//# sourceMappingURL=session-context.d.ts.map

package/dist/lib/session-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-context.d.ts","sourceRoot":"","sources":["../../src/lib/session-context.ts"],"names":[],"mappings":"AAaA,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8BtE"}