@creeperhost/modlens-mcp 1.6.20 → 1.6.22

package/dist/hosted-policy.js

@@ -0,0 +1,354 @@
+import { createHash, timingSafeEqual } from "node:crypto";
+import { getDb } from "./db.js";
+import { guardHostedMod, attachLicenseNotices } from "./hosted-mod-license.js";
+export function hostedLimits(env = process.env) {
+    const number = (key, fallback) => {
+        if (env[key] === undefined)
+            return fallback;
+        const value = Number(env[key]);
+        if (!Number.isSafeInteger(value) || value < 1 || value > 1_000_000_000) {
+            throw new Error(`${key} must be a positive integer no larger than 1000000000`);
+        }
+        return value;
+    };
+    return {
+        lines: number("MODLENS_HOSTED_SOURCE_LINES", 200),
+        responseBytes: number("MODLENS_HOSTED_RESPONSE_BYTES", 128 * 1024),
+        dailyBytes: number("MODLENS_HOSTED_DAILY_BYTES", 5 * 1024 * 1024),
+        periodBytes: number("MODLENS_HOSTED_PERIOD_BYTES", 50 * 1024 * 1024),
+        dailyRequests: number("MODLENS_HOSTED_DAILY_REQUESTS", 1000),
+        minuteRequests: number("MODLENS_HOSTED_MINUTE_REQUESTS", 120),
+    };
+}
+export class HostedPolicyError extends Error {
+}
+/** Only an authenticated gateway may choose the stable account identifier. */
+export function hostedPrincipal(headers, secret) {
+    if (!secret)
+        return "shared"; // Never trust user-supplied IDs, bearer tokens, IPs or session IDs.
+    const provided = headers["x-modlens-proxy-secret"];
+    const user = headers["x-modlens-user-id"];
+    const digest = (value) => createHash("sha256").update(value).digest();
+    if (typeof provided !== "string" || !timingSafeEqual(digest(provided), digest(secret))
+        || typeof user !== "string" || !user.trim() || user.length > 256 || /[\r\n\x00]/.test(user)) {
+        throw new HostedPolicyError("Authenticated gateway identity required.");
+    }
+    return digest(user).toString("hex");
+}
+/** Team claims are accepted only from the authenticated gateway. */
+export function hostedMinecraftSourceTeams(env = process.env, secret) {
+    if (env.MODLENS_HOSTED_MC_SOURCE !== "1")
+        return new Set();
+    if (!secret || secret.length < 32)
+        throw new Error("MODLENS_HOSTED_MC_SOURCE requires MODLENS_HOSTED_PROXY_SECRET");
+    const teams = (env.MODLENS_HOSTED_MC_SOURCE_TEAMS ?? "").split(",").map(value => value.trim()).filter(Boolean);
+    if (!teams.length || teams.some(value => !/^[a-zA-Z0-9._:-]{1,128}$/.test(value))) {
+        throw new Error("MODLENS_HOSTED_MC_SOURCE_TEAMS requires valid comma-separated team IDs");
+    }
+    return new Set(teams);
+}
+export function hostedMinecraftSourceAccess(headers, teams) {
+    const team = headers["x-modlens-team-id"];
+    return typeof team === "string" && teams.has(team);
+}
+// Fail closed: new tools/actions must be reviewed before becoming remotely available.
+// Cache population and filesystem/registry administration stay on the operator's local interface.
+export const HOSTED_ACTIONS = {
+    report_issue: ["help", "prepare"],
+    runtime: ["help", "setup", "status", "sessions", "launch", "events", "command", "artifact"],
+    mod_license: ["check", "local_plan"],
+    mod: ["get", "search", "dependencies", "dep_graph", "version_conflicts", "source_urls", "decompile_class", "source", "search_source", "search_indexed", "search_semantic", "graph_query", "graph_report"],
+    mod_bytecode: ["search_class", "class_members", "bytecode", "find_refs", "cross_refs", "inheritance", "diff", "diff_detailed", "find_implementors", "scan_registrations", "annotated_by", "event_listeners", "optional_integrations", "network_payloads", "config_schema"],
+    mod_mixins: ["targets", "resolve", "conflicts", "targets_in_package", "at_conflicts", "at_entries", "aw_entries"],
+    platform: ["search", "check_updates", "batch_check_updates"],
+    modpacks_ch: ["search", "featured", "info", "manifest", "resolve_pack", "list_versions", "search_mods", "mod_info", "search_ftb_mods", "ftb_mod_info", "list_pack_versions", "list_pack_files", "find_mod_in_packs"],
+    mc_versions: ["list_mc", "list_neoforge", "list_forge", "list_fabric"],
+    mc_source: ["search_class", "source_info", "index_status", "get_source", "bytecode", "class_members", "find_refs", "inheritance", "diff", "diff_detailed", "search_code", "search_indexed", "search_events", "validate_aw", "analyze_mixin", "search_semantic"],
+    mappings: ["find", "parchment", "list_parchment", "parchment_summary"],
+    docs: ["get", "search", "list", "semantic_search"],
+    primers: ["get", "by_version", "search", "list", "semantic_search"],
+    mc_registry: ["blocks", "commands", "registries", "sounds", "item_components", "registry_entries", "mcmeta_versions"],
+    mc_data: ["tags", "find_tags_for", "recipes", "get_recipe", "find_recipes_for", "loot_tables", "get_loot_table", "lang", "blockstate", "model", "model_tree", "biomes", "get_biome", "damage_types", "enchantments", "get_enchantment", "advancements", "get_advancement", "structures", "get_structure", "particles", "get_particle", "entity_attributes"],
+    mc_files: ["get_data", "get_asset", "list_files", "diff", "atlas", "compare", "changelog"],
+    mod_jar: ["lang", "sounds", "atlas", "registry_entries", "manifest", "list_configs", "get_config"],
+    mod_data: ["list", "get", "diff", "trace_item"],
+    mod_tags: ["namespaces", "contributors", "expand", "mod_list", "find_conflicts", "search"],
+    mixin_scan: ["list_mods", "conflict_matrix", "class_detail", "hotspots"],
+    gradle: ["get_files", "search", "compare_deps"],
+    project: ["upload_begin", "upload_chunk", "upload_finish", "upload_abort", "list", "info", "classes", "source", "search", "members", "bytecode"],
+    reports: [""],
+    pack_tools: ["asset_conflicts", "vanilla_overrides", "sidedness", "pack_sidedness", "complexity", "pack_changelog", "data_conflicts", "health"],
+    analyze_crash_log: [""],
+    find_missing_deps: [""],
+};
+export function hostedActions(tool, allowMinecraftSource = false) {
+    const actions = HOSTED_ACTIONS[tool];
+    if (tool !== "mc_source" || allowMinecraftSource)
+        return actions;
+    return actions.filter(action => action !== "bytecode");
+}
+const rawSource = (tool, action) => (tool === "mc_source" && ["get_source", "bytecode"].includes(String(action)))
+    || (tool === "mod" && ["source", "decompile_class"].includes(String(action)))
+    || (tool === "mod_bytecode" && action === "bytecode")
+    || (tool === "project" && ["source", "bytecode"].includes(String(action)));
+export function prepareHostedArgs(tool, input, limits, allowMinecraftSource = false) {
+    const args = { ...input };
+    if (!hostedActions(tool, allowMinecraftSource)?.includes(String(args.action ?? ""))) {
+        throw new HostedPolicyError("This operation is available only to the server operator locally.");
+    }
+    if (tool === "project" && !allowMinecraftSource && ["source", "bytecode"].includes(String(args.action))
+        && /^net[./]minecraft[./]/i.test(String(args.className ?? ""))) {
+        throw new HostedPolicyError("Minecraft source is unavailable on public hosted access.");
+    }
+    if (args.savePath !== undefined || args.scriptsDir !== undefined || args.configDir !== undefined) {
+        throw new HostedPolicyError("Host filesystem operations are unavailable remotely.");
+    }
+    if (tool === "mod_jar" && args.action === "get_config" && !/\.(?:json|json5|toml|cfg|conf|properties|ya?ml)$/i.test(String(args.path ?? ""))) {
+        throw new HostedPolicyError("Specify a configuration file path.");
+    }
+    if (tool === "mc_files" && args.branch !== undefined && !["data", "assets", "registries", "summary", "diff", "atlas"].includes(String(args.branch))) {
+        throw new HostedPolicyError("Unsupported data branch.");
+    }
+    for (const key of ["limit", "top", "budget"]) {
+        if (args[key] !== undefined) {
+            if (!Number.isSafeInteger(args[key]) || Number(args[key]) < 1)
+                throw new HostedPolicyError(`${key} must be a positive integer.`);
+            args[key] = Math.min(Number(args[key]), key === "budget" ? 2000 : 50);
+        }
+    }
+    if (rawSource(tool, args.action)) {
+        for (const key of ["startLine", "endLine", "maxLines"]) {
+            if (args[key] !== undefined && (!Number.isSafeInteger(args[key]) || Number(args[key]) < 1)) {
+                throw new HostedPolicyError(`${key} must be a positive integer.`);
+            }
+        }
+        const start = Number(args.startLine ?? 1);
+        if (start > Number.MAX_SAFE_INTEGER - limits.lines)
+            throw new HostedPolicyError("Invalid source range.");
+        if (args.endLine !== undefined && Number(args.endLine) < start)
+            throw new HostedPolicyError("Invalid source range.");
+        args.startLine = start;
+        args.maxLines = Math.min(Number(args.maxLines ?? limits.lines), limits.lines);
+        if (args.endLine !== undefined)
+            args.endLine = Math.min(Number(args.endLine), start + Number(args.maxLines) - 1);
+    }
+    // Keep exploration useful without unbounded empty searches / directory listings.
+    if (tool === "mod" && args.action === "source" && !args.path)
+        throw new HostedPolicyError("Specify a source file path or use a class search.");
+    if ((String(args.action).startsWith("search") || args.action === "classes")
+        && !(typeof args.query === "string" && args.query.trim())
+        && !(typeof args.className === "string" && args.className.trim())) {
+        throw new HostedPolicyError("Provide a focused search query.");
+    }
+    return args;
+}
+/** Atomic shared-database accounting: session churn, parallel calls and restarts do not reset it. */
+export class HostedBudget {
+    database;
+    now;
+    ready;
+    constructor(database = getDb, now = Date.now) {
+        this.database = database;
+        this.now = now;
+    }
+    async charge(subject, limits, requests, bytes) {
+        const db = await this.database();
+        if (!this.ready)
+            this.ready = db.$executeRawUnsafe(`CREATE TABLE IF NOT EXISTS hosted_usage (
+            subject TEXT PRIMARY KEY, minute BIGINT NOT NULL, minute_requests BIGINT NOT NULL,
+            day BIGINT NOT NULL, daily_requests BIGINT NOT NULL, daily_bytes BIGINT NOT NULL,
+            period BIGINT NOT NULL, period_bytes BIGINT NOT NULL
+        )`).then(() => { }).catch(e => { this.ready = undefined; throw e; });
+        await this.ready;
+        const time = this.now();
+        const minute = Math.floor(time / 60_000), day = Math.floor(time / 86_400_000), period = Math.floor(day / 30);
+        // A single conditional UPSERT serializes checks and updates on every supported backend.
+        const rows = await db.$queryRawUnsafe(`
+            INSERT INTO hosted_usage (subject, minute, minute_requests, day, daily_requests, daily_bytes, period, period_bytes)
+            SELECT CAST($1 AS TEXT), CAST($2 AS BIGINT), CAST($5 AS BIGINT), CAST($3 AS BIGINT),
+                CAST($5 AS BIGINT), CAST($6 AS BIGINT), CAST($4 AS BIGINT), CAST($6 AS BIGINT)
+            WHERE $5 <= $7 AND $5 <= $8 AND $6 <= $9 AND $6 <= $10
+            ON CONFLICT (subject) DO UPDATE SET
+                minute = $2, minute_requests = CASE WHEN hosted_usage.minute = $2 THEN hosted_usage.minute_requests ELSE 0 END + $5,
+                day = $3, daily_requests = CASE WHEN hosted_usage.day = $3 THEN hosted_usage.daily_requests ELSE 0 END + $5,
+                daily_bytes = CASE WHEN hosted_usage.day = $3 THEN hosted_usage.daily_bytes ELSE 0 END + $6,
+                period = $4, period_bytes = CASE WHEN hosted_usage.period = $4 THEN hosted_usage.period_bytes ELSE 0 END + $6
+            WHERE (CASE WHEN hosted_usage.minute = $2 THEN hosted_usage.minute_requests ELSE 0 END) + $5 <= $7
+                AND (CASE WHEN hosted_usage.day = $3 THEN hosted_usage.daily_requests ELSE 0 END) + $5 <= $8
+                AND (CASE WHEN hosted_usage.day = $3 THEN hosted_usage.daily_bytes ELSE 0 END) + $6 <= $9
+                AND (CASE WHEN hosted_usage.period = $4 THEN hosted_usage.period_bytes ELSE 0 END) + $6 <= $10
+            RETURNING subject`, subject, minute, day, period, requests, bytes, limits.minuteRequests, limits.dailyRequests, limits.dailyBytes, limits.periodBytes);
+        if (!rows.length)
+            throw new HostedPolicyError("Hosted analysis allowance reached. Try again later or contact the operator for a higher allowance.");
+    }
+}
+const privateKeys = /^(?:jarPath|decompPath|sourcePath|graphPath|cacheRoot|indexPath|cachedAt|outDir|outputDir|savedTo|decompiled|indexed|embeddedCount|embedSource|embedUpdatedAt)$/i;
+const sourceKeys = /^(?:source|content|text|snippet|answer|bytecode|result|raw)$/i;
+export function boundHostedResult(tool, args, result, limits, allowMinecraftSource = false) {
+    if (result.isError)
+        return failure("Request failed. Check the arguments or ask the operator to inspect the server log.");
+    if (tool === "mc_source" && !allowMinecraftSource && args.action === "get_source") {
+        result = { content: result.content.map(block => {
+                if (block.type !== "text")
+                    throw new HostedPolicyError("This response format is unavailable remotely.");
+                let value;
+                try {
+                    value = JSON.parse(block.text);
+                }
+                catch {
+                    throw new HostedPolicyError("Minecraft source preparation unavailable.");
+                }
+                if (!value || typeof value !== "object")
+                    throw new HostedPolicyError("Minecraft source preparation unavailable.");
+                const info = value;
+                if (typeof info.version !== "string" || typeof info.className !== "string" || typeof info.cached !== "boolean"
+                    || typeof info.indexed !== "boolean" || !(info.totalLines === null || Number.isSafeInteger(info.totalLines))
+                    || !["ready", "preparing", "busy", "failed"].includes(String(info.status))) {
+                    throw new HostedPolicyError("Minecraft source preparation unavailable.");
+                }
+                return { type: "text", text: JSON.stringify({ version: info.version, className: info.className,
+                        cached: info.cached, indexed: info.indexed, totalLines: info.totalLines, status: info.status }) };
+            }) };
+    }
+    if (tool === "mc_source" && !allowMinecraftSource && ["search_code", "search_indexed"].includes(String(args.action))) {
+        result = { content: result.content.map(block => {
+                if (block.type !== "text")
+                    throw new HostedPolicyError("This response format is unavailable remotely.");
+                let rows;
+                try {
+                    rows = JSON.parse(block.text);
+                }
+                catch {
+                    throw new HostedPolicyError("Minecraft search response unavailable.");
+                }
+                if (!Array.isArray(rows))
+                    throw new HostedPolicyError("Minecraft search response unavailable.");
+                const projected = rows.map(row => {
+                    if (!row || typeof row !== "object")
+                        throw new HostedPolicyError("Minecraft search response unavailable.");
+                    const item = row;
+                    if (args.action === "search_indexed") {
+                        if (typeof item.className !== "string")
+                            throw new HostedPolicyError("Minecraft search response unavailable.");
+                        return { className: item.className };
+                    }
+                    if (typeof item.file !== "string" || typeof item.line !== "number")
+                        throw new HostedPolicyError("Minecraft search response unavailable.");
+                    return { file: item.file.replace(/\\/g, "/"), line: item.line };
+                });
+                return { type: "text", text: JSON.stringify(projected) };
+            }) };
+    }
+    if (tool === "project" && !allowMinecraftSource && args.action === "search") {
+        result = { content: result.content.map(block => {
+                if (block.type !== "text")
+                    throw new HostedPolicyError("This response format is unavailable remotely.");
+                let value;
+                try {
+                    value = JSON.parse(block.text);
+                }
+                catch {
+                    throw new HostedPolicyError("Project search response unavailable.");
+                }
+                if (!value || typeof value !== "object" || !Array.isArray(value.results))
+                    throw new HostedPolicyError("Project search response unavailable.");
+                const data = value;
+                return { type: "text", text: JSON.stringify({ ...data,
+                        results: data.results.filter(row => typeof row?.className === "string" && !/^net[./]minecraft[./]/i.test(row.className)),
+                    }) };
+            }) };
+    }
+    let truncated = false;
+    let remainingLines = limits.lines;
+    const clip = (text) => {
+        const lines = text.split(/\r\n|\n|\r/);
+        let value = lines.slice(0, remainingLines).join("\n");
+        if (lines.length > remainingLines)
+            truncated = true;
+        remainingLines = Math.max(0, remainingLines - lines.length);
+        // Byte caps also handle generated/minified one-line classes and multibyte Unicode.
+        const bytes = Buffer.from(value);
+        const stringBytes = Math.min(32 * 1024, Math.floor(limits.responseBytes / 2));
+        if (bytes.length > stringBytes) {
+            let end = stringBytes;
+            while (end > 0 && (bytes[end] & 0xc0) === 0x80)
+                end--;
+            value = bytes.subarray(0, end).toString("utf8");
+            truncated = true;
+        }
+        return value;
+    };
+    const clean = (value, key = "", depth = 0) => {
+        if (depth > 20) {
+            truncated = true;
+            return null;
+        }
+        if (typeof value === "string") {
+            if (tool === "project" && args.action === "bytecode" && key === "result") {
+                value = value.split(/\r\n|\n|\r/).slice(Number(args.startLine ?? 1) - 1, Number(args.startLine ?? 1) - 1 + Number(args.maxLines ?? limits.lines)).join("\n");
+            }
+            return sourceKeys.test(key) ? clip(value) : value;
+        }
+        if (Array.isArray(value))
+            return value.map(v => clean(v, key, depth + 1));
+        if (value && typeof value === "object")
+            return Object.fromEntries(Object.entries(value)
+                .filter(([k]) => !privateKeys.test(k)).map(([k, v]) => [k, clean(v, k, depth + 1)]));
+        return value;
+    };
+    const content = [];
+    for (const block of result.content) {
+        // No file/resource links, binary payloads, hidden structuredContent or metadata bypasses.
+        if (block.type !== "text")
+            throw new HostedPolicyError("This response format is unavailable remotely.");
+        let value;
+        // Source text must not evade line limits by happening to parse as JSON.
+        try {
+            value = rawSource(tool, args.action) && tool !== "project" ? undefined : JSON.parse(block.text);
+        }
+        catch {
+            value = undefined;
+        }
+        let text;
+        // Bytecode/mod source implementations that lack pagination are sliced before clipping.
+        if (rawSource(tool, args.action) && value === undefined && !(tool === "mc_source" && args.action === "get_source") && !(tool === "mod" && args.action === "source")) {
+            text = clip(block.text.split(/\r\n|\n|\r/).slice(Number(args.startLine ?? 1) - 1, Number(args.startLine ?? 1) - 1 + Number(args.maxLines ?? limits.lines)).join("\n"));
+        }
+        else
+            text = value === undefined ? clip(block.text) : JSON.stringify(clean(value));
+        content.push({ type: "text", text });
+    }
+    if (truncated)
+        content.push({ type: "text", text: "Response limited. Narrow the query or request a specific source range." });
+    if (Buffer.byteLength(JSON.stringify(content)) > limits.responseBytes) {
+        throw new HostedPolicyError("Response too large. Narrow the query or request a smaller source range.");
+    }
+    return { content };
+}
+function failure(text) {
+    return { isError: true, content: [{ type: "text", text }] };
+}
+export async function runHostedTool(tool, input, subject, limits, budget, run, allowMinecraftSource = false) {
+    try {
+        await budget.charge(subject, limits, 1, 0);
+        const args = prepareHostedArgs(tool, input, limits, allowMinecraftSource);
+        const review = await guardHostedMod(tool, args);
+        const result = review.blocked
+            ? boundHostedResult("mod_license", { action: "check" }, review.blocked, limits)
+            : attachLicenseNotices(boundHostedResult(tool, args, await run(args), limits, allowMinecraftSource), review.notices ?? []);
+        // License notices must remain complete even when all 200 source lines are
+        // used. Reject the whole response if source plus notices exceeds the cap.
+        if (Buffer.byteLength(JSON.stringify(result.content)) > limits.responseBytes) {
+            throw new HostedPolicyError("Source and required license notices exceed the response limit. Request a smaller source range or use the local workflow.");
+        }
+        // Charge before release, atomically, including search snippets, bytecode and alternate routes.
+        await budget.charge(subject, limits, 0, Buffer.byteLength(JSON.stringify(result.content)));
+        return result;
+    }
+    catch (error) {
+        if (!(error instanceof HostedPolicyError))
+            console.error("[modlens] hosted policy failure", error);
+        return failure(error instanceof HostedPolicyError ? error.message : "Hosted request unavailable. Contact the operator.");
+    }
+}
+//# sourceMappingURL=hosted-policy.js.map

package/dist/hosted-policy.js.map

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

package/dist/launcher.js

@@ -19,105 +19,120 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
 import { spawnSync } from "child_process";
-const __dirname = dirname(fileURLToPath(import.meta.url));
-// ── Resolve paths (mirrors env-path.ts but without importing it so we can
-//    load the .env before any other imports trigger DB connections) ──────────
-const PKG_ROOT = join(__dirname, "..");
-const IS_INSTALLED = !existsSync(join(PKG_ROOT, ".git"));
 import { homedir } from "os";
-const MODLENS_HOME = process.env.MODLENS_HOME ?? (IS_INSTALLED ? join(homedir(), ".modlens") : PKG_ROOT);
-const ENV_FILE = IS_INSTALLED ? join(MODLENS_HOME, ".env") : join(PKG_ROOT, ".env");
-const VERSION_FILE = join(MODLENS_HOME, "version");
-// ── Load .env early so DB connection picks up DATABASE_URL ───────────────────
-for (const ep of [ENV_FILE, join(PKG_ROOT, ".env")]) {
-    if (existsSync(ep)) {
-        for (const line of readFileSync(ep, "utf8").split("\n")) {
-            const m = line.match(/^([^#=]+)=(.*)$/);
-            if (m)
-                process.env[m[1].trim()] ??= m[2].trim().replace(/^["']|["']$/g, "");
-        }
-        break;
-    }
-}
-const args = process.argv.slice(2);
-// Project utilities do not need a database or first-run bootstrap.
-if (args[0] === "--gradle-init-script") {
-    console.log(join(PKG_ROOT, "scripts", "gradle", "modlens.init.gradle"));
-    process.exit(0);
-}
-if (args[0] === "--project-upload") {
-    process.argv = [process.argv[0], join(PKG_ROOT, "scripts", "project-upload.mjs"), ...args.slice(1)];
-    await import(new URL("../scripts/project-upload.mjs", import.meta.url).href);
-    process.exit(process.exitCode ?? 0);
-}
-if (args[0] === "--project") {
-    process.argv = [process.argv[0], join(PKG_ROOT, "dist", "cli.js"), "project", ...args.slice(1)];
-    await import("./cli.js");
-    process.exit(process.exitCode ?? 0);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Runtime-only local helper: no DB bootstrap, server .env, or MCP configuration.
+if (process.argv[2] === "--local-mod") {
+    delete process.env.MCP_PORT;
+    const { localModCli } = await import("./local-mod.js");
+    process.exitCode = await localModCli(process.argv.slice(3));
 }
-const wantSetup = args.includes("--setup");
-// Bootstrap embedded SQLite only when nothing else is configured. A
-// pre-supplied DATABASE_URL (e.g. Postgres via a container env var) opts out, so
-// `docker run -e DATABASE_URL=postgresql://…` works without a stray SQLite db.
-const isFirstRun = IS_INSTALLED && !existsSync(ENV_FILE) && !process.env.DATABASE_URL;
-// ── Explicit setup wizard (--setup) ─────────────────────────────────────────
-// Opt-in interactive configuration (Postgres, semantic search, MCP client, …).
-if (wantSetup) {
-    mkdirSync(MODLENS_HOME, { recursive: true });
-    const result = spawnSync(process.execPath, [join(PKG_ROOT, "dist", "setup.js")], {
-        stdio: "inherit",
-        env: { ...process.env, MODLENS_HOME },
-    });
-    process.exit(result.status ?? 0);
+else if (process.argv[2] === "--runtime") {
+    delete process.env.MCP_PORT;
+    const { runtimeCli } = await import("./runtime/cli.js");
+    process.exitCode = await runtimeCli(process.argv.slice(3));
 }
-// ── Zero-config first run: bootstrap embedded SQLite ─────────────────────────
-// No interactive wizard — copy the prebuilt schema'd template database into
-// ~/.modlens/data so the server can start immediately with no external services.
-// Power users can switch to Postgres/semantic search any time with `--setup`.
-if (isFirstRun) {
-    mkdirSync(MODLENS_HOME, { recursive: true });
-    const dataDir = join(MODLENS_HOME, "data");
-    mkdirSync(dataDir, { recursive: true });
-    const dbPath = join(dataDir, "modlens.db");
-    if (!existsSync(dbPath)) {
-        const template = join(PKG_ROOT, "prisma", "backends", "template.db");
-        if (!existsSync(template)) {
-            console.error("[modlens] template.db is missing from the package — cannot bootstrap SQLite.\n[modlens] Run `npx @creeperhost/modlens-mcp --setup` to configure a database manually.");
-            process.exit(1);
+else
+    await startMcp();
+async function startMcp() {
+    // ── Resolve paths (mirrors env-path.ts but without importing it so we can
+    //    load the .env before any other imports trigger DB connections) ──────────
+    const PKG_ROOT = join(__dirname, "..");
+    const IS_INSTALLED = !existsSync(join(PKG_ROOT, ".git"));
+    const MODLENS_HOME = process.env.MODLENS_HOME ?? (IS_INSTALLED ? join(homedir(), ".modlens") : PKG_ROOT);
+    const ENV_FILE = IS_INSTALLED ? join(MODLENS_HOME, ".env") : join(PKG_ROOT, ".env");
+    const VERSION_FILE = join(MODLENS_HOME, "version");
+    // ── Load .env early so DB connection picks up DATABASE_URL ───────────────────
+    for (const ep of [ENV_FILE, join(PKG_ROOT, ".env")]) {
+        if (existsSync(ep)) {
+            for (const line of readFileSync(ep, "utf8").split("\n")) {
+                const m = line.match(/^([^#=]+)=(.*)$/);
+                if (m)
+                    process.env[m[1].trim()] ??= m[2].trim().replace(/^["']|["']$/g, "");
+            }
+            break;
         }
-        copyFileSync(template, dbPath);
     }
-    const dbUrl = `file:${dbPath}`;
-    writeFileSync(ENV_FILE, `MODLENS_PROFILE=lightweight\nDATABASE_URL=${dbUrl}\n`);
-    process.env.DATABASE_URL ??= dbUrl;
-    // Record the current version so the migration step below treats this fresh
-    // install as already up to date (template.db already has the right schema).
-    const freshVersion = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8")).version;
-    writeFileSync(VERSION_FILE, freshVersion + "\n");
-    console.error(`[modlens] First run — initialized embedded SQLite database at ${dbPath}`);
-    console.error("[modlens] Run `npx @creeperhost/modlens-mcp --setup` to switch to Postgres or enable semantic search.");
-}
-// ── Version check + auto-migrate (installed mode only) ───────────────────────
-if (IS_INSTALLED) {
-    const pkgVersion = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8")).version;
-    const storedVersion = existsSync(VERSION_FILE) ? readFileSync(VERSION_FILE, "utf8").trim() : null;
-    if (storedVersion !== pkgVersion) {
-        console.error(`[modlens] Version changed (${storedVersion ?? "none"} → ${pkgVersion}), running migrations...`);
-        const result = spawnSync(process.execPath, [join(PKG_ROOT, "scripts", "post-update.mjs")], {
+    const args = process.argv.slice(2);
+    // Project utilities do not need a database or first-run bootstrap.
+    if (args[0] === "--gradle-init-script") {
+        console.log(join(PKG_ROOT, "scripts", "gradle", "modlens.init.gradle"));
+        process.exit(0);
+    }
+    if (args[0] === "--project-upload") {
+        process.argv = [process.argv[0], join(PKG_ROOT, "scripts", "project-upload.mjs"), ...args.slice(1)];
+        await import(new URL("../scripts/project-upload.mjs", import.meta.url).href);
+        process.exit(process.exitCode ?? 0);
+    }
+    if (args[0] === "--project") {
+        process.argv = [process.argv[0], join(PKG_ROOT, "dist", "cli.js"), "project", ...args.slice(1)];
+        await import("./cli.js");
+        process.exit(process.exitCode ?? 0);
+    }
+    const wantSetup = args.includes("--setup");
+    // Bootstrap embedded SQLite only when nothing else is configured. A
+    // pre-supplied DATABASE_URL (e.g. Postgres via a container env var) opts out, so
+    // `docker run -e DATABASE_URL=postgresql://…` works without a stray SQLite db.
+    const isFirstRun = IS_INSTALLED && !existsSync(ENV_FILE) && !process.env.DATABASE_URL;
+    // ── Explicit setup wizard (--setup) ─────────────────────────────────────────
+    // Opt-in interactive configuration (Postgres, semantic search, MCP client, …).
+    if (wantSetup) {
+        mkdirSync(MODLENS_HOME, { recursive: true });
+        const result = spawnSync(process.execPath, [join(PKG_ROOT, "dist", "setup.js")], {
             stdio: "inherit",
             env: { ...process.env, MODLENS_HOME },
         });
-        if (result.status === 0) {
-            mkdirSync(MODLENS_HOME, { recursive: true });
-            writeFileSync(VERSION_FILE, pkgVersion + "\n");
+        process.exit(result.status ?? 0);
+    }
+    // ── Zero-config first run: bootstrap embedded SQLite ─────────────────────────
+    // No interactive wizard — copy the prebuilt schema'd template database into
+    // ~/.modlens/data so the server can start immediately with no external services.
+    // Power users can switch to Postgres/semantic search any time with `--setup`.
+    if (isFirstRun) {
+        mkdirSync(MODLENS_HOME, { recursive: true });
+        const dataDir = join(MODLENS_HOME, "data");
+        mkdirSync(dataDir, { recursive: true });
+        const dbPath = join(dataDir, "modlens.db");
+        if (!existsSync(dbPath)) {
+            const template = join(PKG_ROOT, "prisma", "backends", "template.db");
+            if (!existsSync(template)) {
+                console.error("[modlens] template.db is missing from the package — cannot bootstrap SQLite.\n[modlens] Run `npx @creeperhost/modlens-mcp --setup` to configure a database manually.");
+                process.exit(1);
+            }
+            copyFileSync(template, dbPath);
         }
-        else {
-            console.error("[modlens] Migration had errors — server may not start correctly.");
+        const dbUrl = `file:${dbPath}`;
+        writeFileSync(ENV_FILE, `MODLENS_PROFILE=lightweight\nDATABASE_URL=${dbUrl}\n`);
+        process.env.DATABASE_URL ??= dbUrl;
+        // Record the current version so the migration step below treats this fresh
+        // install as already up to date (template.db already has the right schema).
+        const freshVersion = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8")).version;
+        writeFileSync(VERSION_FILE, freshVersion + "\n");
+        console.error(`[modlens] First run — initialized embedded SQLite database at ${dbPath}`);
+        console.error("[modlens] Run `npx @creeperhost/modlens-mcp --setup` to switch to Postgres or enable semantic search.");
+    }
+    // ── Version check + auto-migrate (installed mode only) ───────────────────────
+    if (IS_INSTALLED) {
+        const pkgVersion = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8")).version;
+        const storedVersion = existsSync(VERSION_FILE) ? readFileSync(VERSION_FILE, "utf8").trim() : null;
+        if (storedVersion !== pkgVersion) {
+            console.error(`[modlens] Version changed (${storedVersion ?? "none"} → ${pkgVersion}), running migrations...`);
+            const result = spawnSync(process.execPath, [join(PKG_ROOT, "scripts", "post-update.mjs")], {
+                stdio: "inherit",
+                env: { ...process.env, MODLENS_HOME },
+            });
+            if (result.status === 0) {
+                mkdirSync(MODLENS_HOME, { recursive: true });
+                writeFileSync(VERSION_FILE, pkgVersion + "\n");
+            }
+            else {
+                console.error("[modlens] Migration had errors — server may not start correctly.");
+            }
         }
     }
+    // ── Start server ──────────────────────────────────────────────────────────────
+    // Dynamic import so all the above env-loading completes before any module
+    // that reads process.env at import time (e.g. db.ts) is evaluated.
+    await import("./server.js");
 }
-// ── Start server ──────────────────────────────────────────────────────────────
-// Dynamic import so all the above env-loading completes before any module
-// that reads process.env at import time (e.g. db.ts) is evaluated.
-await import("./server.js");
 //# sourceMappingURL=launcher.js.map