@creeperhost/modlens-mcp 1.6.0 → 1.6.4

package/scripts/backup.mjs

@@ -1,151 +1,151 @@
-// scripts/backup.mjs
-/**
- * Backup the active modlens database.
- * Usage: node scripts/backup.mjs
- * Or via npm: npm run db:backup
- *
- * Backs up to ~/.modlens-backups/<timestamp>-<backend>.<ext>
- * Appends restore instructions to ~/.modlens-backups/README.md
- */
-import { execSync } from "child_process";
-import { cpSync, mkdirSync, existsSync, appendFileSync, copyFileSync } from "fs";
-import { homedir } from "os";
-import { join } from "path";
-import { createRequire } from "module";
-
-const require = createRequire(import.meta.url);
-try { require("dotenv").config(); } catch { /* dotenv optional */ }
-
-const DATABASE_URL = process.env.DATABASE_URL ?? "";
-const BACKUP_ROOT = process.env.MODLENS_BACKUP_DIR ?? join(homedir(), ".modlens-backups");
-
-function detectBackend(url) {
-    if (url.startsWith("file:") || url.endsWith(".db")) return "sqlite";
-    if (url.startsWith("pglite://") || url.startsWith("pglite:")) return "pglite";
-    return "postgres";
-}
-
-function timestamp() {
-    return new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
-}
-
-function ensureDir(dir) {
-    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-}
-
-function appendReadme(root, lines) {
-    ensureDir(root);
-    appendFileSync(join(root, "README.md"), lines.join("\n") + "\n\n");
-}
-
-// ── Postgres backup ──────────────────────────────────────────────────────────
-
-function backupPostgres(url, root = BACKUP_ROOT) {
-    ensureDir(root);
-    const ts = timestamp();
-    const file = join(root, `modlens-postgres-${ts}.sql`);
-
-    try {
-        execSync(`pg_dump "${url}" -f "${file}"`, { stdio: "inherit" });
-    } catch {
-        try {
-            const container = process.env.MODLENS_POSTGRES_CONTAINER ?? "modlens-postgres";
-            execSync(
-                `docker exec ${container} pg_dump "${url}" > "${file}"`,
-                { stdio: "inherit", shell: true },
-            );
-        } catch (e) {
-            throw new Error(
-                `pg_dump failed. Install pg_dump or ensure the postgres container is running.\n${e.message}`,
-            );
-        }
-    }
-
-    const restore = `psql "${url}" < "${file}"`;
-    appendReadme(root, [
-        `## Postgres backup — ${ts}`,
-        `File: ${file}`,
-        `Restore: \`${restore}\``,
-    ]);
-    return { file, restore };
-}
-
-// ── PGlite backup ────────────────────────────────────────────────────────────
-
-function backupPglite(url, root = BACKUP_ROOT) {
-    ensureDir(root);
-    const ts = timestamp();
-    const dataDir = url.replace(/^pglite:\/\//, "");
-    const outDir = join(root, `modlens-pglite-${ts}`);
-
-    if (!existsSync(dataDir)) {
-        throw new Error(`PGlite data directory does not exist: ${dataDir}`);
-    }
-
-    cpSync(dataDir, outDir, { recursive: true });
-
-    const restore = `cp -r "${outDir}" "${dataDir}"`;
-    appendReadme(root, [
-        `## PGlite backup — ${ts}`,
-        `Directory: ${outDir}`,
-        `Restore: \`${restore}\``,
-    ]);
-    return { dir: outDir, restore };
-}
-
-// ── SQLite backup ────────────────────────────────────────────────────────────
-
-function backupSqlite(url, root = BACKUP_ROOT) {
-    ensureDir(root);
-    const ts = timestamp();
-    const dbPath = url.replace(/^file:\/\//, "").replace(/^file:/, "");
-    const file = join(root, `modlens-sqlite-${ts}.db`);
-
-    if (!existsSync(dbPath)) {
-        throw new Error(`SQLite database file does not exist: ${dbPath}`);
-    }
-
-    copyFileSync(dbPath, file);
-
-    const restore = `cp "${file}" "${dbPath}"`;
-    appendReadme(root, [
-        `## SQLite backup — ${ts}`,
-        `File: ${file}`,
-        `Restore: \`${restore}\``,
-    ]);
-    return { file, restore };
-}
-
-// ── Programmatic API ─────────────────────────────────────────────────────────
-
-/**
- * Backup the database at `url` to `backupRoot` (defaults to ~/.modlens-backups).
- * @param {string} url
- * @param {string} [backupRoot]
- * @returns {{ file?: string, dir?: string, restore: string }}
- */
-export async function backup(url, backupRoot) {
-    const root = backupRoot ?? BACKUP_ROOT;
-    const backend = detectBackend(url);
-    if (backend === "postgres") return backupPostgres(url, root);
-    if (backend === "pglite")  return backupPglite(url, root);
-    return backupSqlite(url, root);
-}
-
-// ── CLI entry point ───────────────────────────────────────────────────────────
-
-const isCli = process.argv[1]?.replace(/\\/g, "/").endsWith("backup.mjs");
-if (isCli) {
-    if (!DATABASE_URL) {
-        console.error("DATABASE_URL is not set. Create a .env file or set the variable.");
-        process.exit(1);
-    }
-
-    const backend = detectBackend(DATABASE_URL);
-    console.log(`Backing up ${backend} database...`);
-
-    const result = await backup(DATABASE_URL);
-    console.log(`Backup written: ${result.file ?? result.dir}`);
-    console.log(`Restore command: ${result.restore}`);
-    console.log(`Restore instructions also appended to: ${join(BACKUP_ROOT, "README.md")}`);
-}
+// scripts/backup.mjs
+/**
+ * Backup the active modlens database.
+ * Usage: node scripts/backup.mjs
+ * Or via npm: npm run db:backup
+ *
+ * Backs up to ~/.modlens-backups/<timestamp>-<backend>.<ext>
+ * Appends restore instructions to ~/.modlens-backups/README.md
+ */
+import { execSync } from "child_process";
+import { cpSync, mkdirSync, existsSync, appendFileSync, copyFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { createRequire } from "module";
+
+const require = createRequire(import.meta.url);
+try { require("dotenv").config(); } catch { /* dotenv optional */ }
+
+const DATABASE_URL = process.env.DATABASE_URL ?? "";
+const BACKUP_ROOT = process.env.MODLENS_BACKUP_DIR ?? join(homedir(), ".modlens-backups");
+
+function detectBackend(url) {
+    if (url.startsWith("file:") || url.endsWith(".db")) return "sqlite";
+    if (url.startsWith("pglite://") || url.startsWith("pglite:")) return "pglite";
+    return "postgres";
+}
+
+function timestamp() {
+    return new Date().toISOString().replace(/[:.]/g, "-").slice(0, 19);
+}
+
+function ensureDir(dir) {
+    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+}
+
+function appendReadme(root, lines) {
+    ensureDir(root);
+    appendFileSync(join(root, "README.md"), lines.join("\n") + "\n\n");
+}
+
+// ── Postgres backup ──────────────────────────────────────────────────────────
+
+function backupPostgres(url, root = BACKUP_ROOT) {
+    ensureDir(root);
+    const ts = timestamp();
+    const file = join(root, `modlens-postgres-${ts}.sql`);
+
+    try {
+        execSync(`pg_dump "${url}" -f "${file}"`, { stdio: "inherit" });
+    } catch {
+        try {
+            const container = process.env.MODLENS_POSTGRES_CONTAINER ?? "modlens-postgres";
+            execSync(
+                `docker exec ${container} pg_dump "${url}" > "${file}"`,
+                { stdio: "inherit", shell: true },
+            );
+        } catch (e) {
+            throw new Error(
+                `pg_dump failed. Install pg_dump or ensure the postgres container is running.\n${e.message}`,
+            );
+        }
+    }
+
+    const restore = `psql "${url}" < "${file}"`;
+    appendReadme(root, [
+        `## Postgres backup — ${ts}`,
+        `File: ${file}`,
+        `Restore: \`${restore}\``,
+    ]);
+    return { file, restore };
+}
+
+// ── PGlite backup ────────────────────────────────────────────────────────────
+
+function backupPglite(url, root = BACKUP_ROOT) {
+    ensureDir(root);
+    const ts = timestamp();
+    const dataDir = url.replace(/^pglite:\/\//, "");
+    const outDir = join(root, `modlens-pglite-${ts}`);
+
+    if (!existsSync(dataDir)) {
+        throw new Error(`PGlite data directory does not exist: ${dataDir}`);
+    }
+
+    cpSync(dataDir, outDir, { recursive: true });
+
+    const restore = `cp -r "${outDir}" "${dataDir}"`;
+    appendReadme(root, [
+        `## PGlite backup — ${ts}`,
+        `Directory: ${outDir}`,
+        `Restore: \`${restore}\``,
+    ]);
+    return { dir: outDir, restore };
+}
+
+// ── SQLite backup ────────────────────────────────────────────────────────────
+
+function backupSqlite(url, root = BACKUP_ROOT) {
+    ensureDir(root);
+    const ts = timestamp();
+    const dbPath = url.replace(/^file:\/\//, "").replace(/^file:/, "");
+    const file = join(root, `modlens-sqlite-${ts}.db`);
+
+    if (!existsSync(dbPath)) {
+        throw new Error(`SQLite database file does not exist: ${dbPath}`);
+    }
+
+    copyFileSync(dbPath, file);
+
+    const restore = `cp "${file}" "${dbPath}"`;
+    appendReadme(root, [
+        `## SQLite backup — ${ts}`,
+        `File: ${file}`,
+        `Restore: \`${restore}\``,
+    ]);
+    return { file, restore };
+}
+
+// ── Programmatic API ─────────────────────────────────────────────────────────
+
+/**
+ * Backup the database at `url` to `backupRoot` (defaults to ~/.modlens-backups).
+ * @param {string} url
+ * @param {string} [backupRoot]
+ * @returns {{ file?: string, dir?: string, restore: string }}
+ */
+export async function backup(url, backupRoot) {
+    const root = backupRoot ?? BACKUP_ROOT;
+    const backend = detectBackend(url);
+    if (backend === "postgres") return backupPostgres(url, root);
+    if (backend === "pglite")  return backupPglite(url, root);
+    return backupSqlite(url, root);
+}
+
+// ── CLI entry point ───────────────────────────────────────────────────────────
+
+const isCli = process.argv[1]?.replace(/\\/g, "/").endsWith("backup.mjs");
+if (isCli) {
+    if (!DATABASE_URL) {
+        console.error("DATABASE_URL is not set. Create a .env file or set the variable.");
+        process.exit(1);
+    }
+
+    const backend = detectBackend(DATABASE_URL);
+    console.log(`Backing up ${backend} database...`);
+
+    const result = await backup(DATABASE_URL);
+    console.log(`Backup written: ${result.file ?? result.dir}`);
+    console.log(`Restore command: ${result.restore}`);
+    console.log(`Restore instructions also appended to: ${join(BACKUP_ROOT, "README.md")}`);
+}

package/scripts/check-atm10.mjs

@@ -1,27 +1,27 @@
-import { PrismaClient } from '@prisma/client';
-const db = new PrismaClient();
-
-const stats = await db.mod.aggregate({ _min: { id: true }, _max: { id: true } });
-const totalMods = await db.mod.count();
-const atm10Files = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod' } });
-const atm10WithModId = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', modId: { not: null } } });
-const atm10NotSynced = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', status: 'not_synced' } });
-const atm10AlreadyIngested = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', status: 'already_ingested' } });
-const atm10Ingested = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', status: 'ingested' } });
-
-const lowestAtm10Mod = await db.packFile.findFirst({ where: { packVersionId: 1, modId: { not: null } }, orderBy: { modId: 'asc' }, select: { modId: true, fileName: true } });
-const highestAtm10Mod = await db.packFile.findFirst({ where: { packVersionId: 1, modId: { not: null } }, orderBy: { modId: 'desc' }, select: { modId: true, fileName: true } });
-
-console.log(JSON.stringify({
-    totalModsInDb: totalMods,
-    dbModIdRange: stats,
-    atm10Files,
-    atm10WithModId,
-    atm10Ingested,
-    atm10AlreadyIngested,
-    atm10NotSynced,
-    lowestAtm10Mod,
-    highestAtm10Mod,
-}, null, 2));
-
-await db.$disconnect();
+import { PrismaClient } from '@prisma/client';
+const db = new PrismaClient();
+
+const stats = await db.mod.aggregate({ _min: { id: true }, _max: { id: true } });
+const totalMods = await db.mod.count();
+const atm10Files = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod' } });
+const atm10WithModId = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', modId: { not: null } } });
+const atm10NotSynced = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', status: 'not_synced' } });
+const atm10AlreadyIngested = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', status: 'already_ingested' } });
+const atm10Ingested = await db.packFile.count({ where: { packVersionId: 1, fileType: 'mod', status: 'ingested' } });
+
+const lowestAtm10Mod = await db.packFile.findFirst({ where: { packVersionId: 1, modId: { not: null } }, orderBy: { modId: 'asc' }, select: { modId: true, fileName: true } });
+const highestAtm10Mod = await db.packFile.findFirst({ where: { packVersionId: 1, modId: { not: null } }, orderBy: { modId: 'desc' }, select: { modId: true, fileName: true } });
+
+console.log(JSON.stringify({
+    totalModsInDb: totalMods,
+    dbModIdRange: stats,
+    atm10Files,
+    atm10WithModId,
+    atm10Ingested,
+    atm10AlreadyIngested,
+    atm10NotSynced,
+    lowestAtm10Mod,
+    highestAtm10Mod,
+}, null, 2));
+
+await db.$disconnect();

package/scripts/check-sync.mjs

@@ -1,13 +1,13 @@
-import { readFileSync } from 'fs';
-// Load .env
-for (const line of readFileSync('d:/Downloads/modlens-mcp/.env', 'utf8').split('\n')) {
-    const m = line.match(/^([^#=]+)=(.*)$/);
-    if (m) process.env[m[1].trim()] ??= m[2].trim().replace(/^["']|["']$/g, '');
-}
-import { PrismaClient } from '@prisma/client';
-const db = new PrismaClient();
-const cfFilled = await db.mod.count({ where: { curseforgeId: { not: null } } });
-const mrFilled = await db.mod.count({ where: { modrinthId:   { not: null } } });
-console.log(`curseforgeId populated: ${cfFilled} / 821`);
-console.log(`modrinthId populated:   ${mrFilled} / 821`);
-await db.$disconnect();
+import { readFileSync } from 'fs';
+// Load .env
+for (const line of readFileSync('d:/Downloads/modlens-mcp/.env', 'utf8').split('\n')) {
+    const m = line.match(/^([^#=]+)=(.*)$/);
+    if (m) process.env[m[1].trim()] ??= m[2].trim().replace(/^["']|["']$/g, '');
+}
+import { PrismaClient } from '@prisma/client';
+const db = new PrismaClient();
+const cfFilled = await db.mod.count({ where: { curseforgeId: { not: null } } });
+const mrFilled = await db.mod.count({ where: { modrinthId:   { not: null } } });
+console.log(`curseforgeId populated: ${cfFilled} / 821`);
+console.log(`modrinthId populated:   ${mrFilled} / 821`);
+await db.$disconnect();

package/scripts/create-fts-index.mjs

@@ -1,50 +1,50 @@
-/**
- * Creates the PostgreSQL GIN index for full-text search on mc_source_files.
- * Run via: npm run db:setup
- *
- * CREATE INDEX CONCURRENTLY cannot run inside a Prisma migration transaction,
- * so it lives here as a post-migrate step.
- */
-import { PrismaClient } from "@prisma/client";
-import { readFileSync, existsSync } from "fs";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const envPath = join(__dirname, "..", ".env");
-if (existsSync(envPath)) {
-    for (const line of readFileSync(envPath, "utf8").split("\n")) {
-        const m = line.match(/^([^#=]+)=(.*)$/);
-        if (m) process.env[m[1].trim()] ??= m[2].trim().replace(/^["']|["']$/g, "");
-    }
-}
-
-const prisma = new PrismaClient();
-
-async function main() {
-    // Check if the index already exists to avoid a no-op CONCURRENTLY call
-    const existing = await prisma.$queryRaw`
-        SELECT 1 FROM pg_indexes
-        WHERE schemaname = 'public'
-          AND tablename  = 'mc_source_files'
-          AND indexname  = 'mc_source_files_tsv_idx'
-        LIMIT 1
-    `;
-
-    if (Array.isArray(existing) && existing.length > 0) {
-        console.log("FTS index mc_source_files_tsv_idx already exists — skipping.");
-        return;
-    }
-
-    console.log("Creating GIN FTS index on mc_source_files(content) — this may take a while...");
-    // CONCURRENTLY cannot run inside a transaction; Prisma $executeRaw runs outside one here.
-    await prisma.$executeRawUnsafe(`
-        CREATE INDEX CONCURRENTLY IF NOT EXISTS mc_source_files_tsv_idx
-            ON mc_source_files USING GIN (to_tsvector('simple', content))
-    `);
-    console.log("Done: mc_source_files_tsv_idx created.");
-}
-
-main()
-    .catch((err) => { console.error("Failed to create FTS index:", err); process.exit(1); })
-    .finally(() => prisma.$disconnect());
+/**
+ * Creates the PostgreSQL GIN index for full-text search on mc_source_files.
+ * Run via: npm run db:setup
+ *
+ * CREATE INDEX CONCURRENTLY cannot run inside a Prisma migration transaction,
+ * so it lives here as a post-migrate step.
+ */
+import { PrismaClient } from "@prisma/client";
+import { readFileSync, existsSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const envPath = join(__dirname, "..", ".env");
+if (existsSync(envPath)) {
+    for (const line of readFileSync(envPath, "utf8").split("\n")) {
+        const m = line.match(/^([^#=]+)=(.*)$/);
+        if (m) process.env[m[1].trim()] ??= m[2].trim().replace(/^["']|["']$/g, "");
+    }
+}
+
+const prisma = new PrismaClient();
+
+async function main() {
+    // Check if the index already exists to avoid a no-op CONCURRENTLY call
+    const existing = await prisma.$queryRaw`
+        SELECT 1 FROM pg_indexes
+        WHERE schemaname = 'public'
+          AND tablename  = 'mc_source_files'
+          AND indexname  = 'mc_source_files_tsv_idx'
+        LIMIT 1
+    `;
+
+    if (Array.isArray(existing) && existing.length > 0) {
+        console.log("FTS index mc_source_files_tsv_idx already exists — skipping.");
+        return;
+    }
+
+    console.log("Creating GIN FTS index on mc_source_files(content) — this may take a while...");
+    // CONCURRENTLY cannot run inside a transaction; Prisma $executeRaw runs outside one here.
+    await prisma.$executeRawUnsafe(`
+        CREATE INDEX CONCURRENTLY IF NOT EXISTS mc_source_files_tsv_idx
+            ON mc_source_files USING GIN (to_tsvector('simple', content))
+    `);
+    console.log("Done: mc_source_files_tsv_idx created.");
+}
+
+main()
+    .catch((err) => { console.error("Failed to create FTS index:", err); process.exit(1); })
+    .finally(() => prisma.$disconnect());