@reftrixmcp/mcp-server 0.1.8 → 0.2.0

package/dist/schemas/mood-brandtone-filters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mood-brandtone-filters.d.ts","sourceRoot":"","sources":["../../src/schemas/mood-brandtone-filters.ts"],"names":[],"mappings":"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"}

package/dist/schemas/mood-brandtone-filters.js

@@ -1,265 +0,0 @@
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.combinedSearchResultSchema = exports.searchResultSchema = exports.combinedSearchRequestSchema = exports.brandToneSearchRequestSchema = exports.moodSearchRequestSchema = exports.extendedLayoutSearchFilterSchema = exports.rrfWeightsSchema = exports.brandToneFilterSchema = exports.moodFilterSchema = exports.BRAND_TONE_ENUM = exports.MOOD_ENUM = void 0;
-exports.parseMoodFilter = parseMoodFilter;
-exports.parseBrandToneFilter = parseBrandToneFilter;
-exports.parseRRFWeights = parseRRFWeights;
-exports.parseSearchResult = parseSearchResult;
-const zod_1 = require("zod");
-/**
- * TASK-04 (GREEN Phase): Zod Schema Implementation
- *
- * Purpose: Define type-safe validation schemas for mood/brandTone filters
- * - moodFilterSchema: Mood filter constraints (primary, secondary, minSimilarity, weight)
- * - brandToneFilterSchema: BrandTone filter constraints (identical structure)
- * - rrfWeightsSchema: Reciprocal Rank Fusion weight validation
- *
- * Constraints:
- * - primary/secondary: Enum of 8 values (professional, playful, minimal, bold, elegant, friendly, corporate, creative)
- * - minSimilarity: Number [0, 1], default 0.5
- * - weight: Number [0, 1], default 0.2
- * - RRF weights: mood + brandTone <= 1.0
- */
-// ========== Enum Definitions ==========
-/**
- * Valid mood values for semantic search
- * Used for layout pattern analysis with emotional/contextual semantics
- */
-exports.MOOD_ENUM = zod_1.z.enum([
-    "professional",
-    "playful",
-    "minimal",
-    "bold",
-    "elegant",
-    "friendly",
-    "corporate",
-    "creative",
-]);
-/**
- * Valid brand tone values for semantic search
- * Identical to Mood enum - represents brand positioning semantics
- */
-exports.BRAND_TONE_ENUM = zod_1.z.enum([
-    "professional",
-    "playful",
-    "minimal",
-    "bold",
-    "elegant",
-    "friendly",
-    "corporate",
-    "creative",
-]);
-// ========== Filter Schemas ==========
-/**
- * Mood Filter Schema
- *
- * Constraints:
- * - primary: Required, must be valid Mood enum value
- * - secondary: Optional, must be valid Mood enum value
- * - minSimilarity: Number [0, 1], default 0.5
- * - weight: Number [0, 1], default 0.2 (used in RRF for combined searches)
- */
-exports.moodFilterSchema = zod_1.z.object({
-    primary: exports.MOOD_ENUM,
-    secondary: exports.MOOD_ENUM.optional(),
-    minSimilarity: zod_1.z.number().min(0).max(1).default(0.5),
-    weight: zod_1.z.number().min(0).max(1).default(0.2),
-});
-/**
- * Brand Tone Filter Schema
- *
- * Constraints: Identical to MoodFilter
- * - primary: Required, must be valid BrandTone enum value
- * - secondary: Optional, must be valid BrandTone enum value
- * - minSimilarity: Number [0, 1], default 0.5
- * - weight: Number [0, 1], default 0.3 (used in RRF for combined searches)
- */
-exports.brandToneFilterSchema = zod_1.z.object({
-    primary: exports.BRAND_TONE_ENUM,
-    secondary: exports.BRAND_TONE_ENUM.optional(),
-    minSimilarity: zod_1.z.number().min(0).max(1).default(0.5),
-    weight: zod_1.z.number().min(0).max(1).default(0.3),
-});
-// ========== RRF (Reciprocal Rank Fusion) Schemas ==========
-/**
- * RRF Weights Schema
- *
- * Defines weight distribution between mood and brandTone results in combined search
- *
- * Constraints:
- * - mood: Number [0, 1], default 0.6 (60% weight)
- * - brandTone: Number [0, 1], default 0.4 (40% weight)
- * - Sum validation: mood + brandTone <= 1.0
- *
- * RRF Formula: score = (mood_score * mood_weight) + (brandTone_score * brandTone_weight)
- */
-exports.rrfWeightsSchema = zod_1.z
-    .object({
-    mood: zod_1.z.number().min(0).max(1).default(0.6),
-    brandTone: zod_1.z.number().min(0).max(1).default(0.4),
-})
-    .refine((data) => {
-    const sum = data.mood + data.brandTone;
-    return sum <= 1.0 + 0.001; // Allow small floating point tolerance
-}, {
-    message: "RRF weights must sum to ≤ 1.0. Recommended: mood + brandTone = 1.0",
-});
-// ========== Combined Search Schemas ==========
-/**
- * Extended Layout Search Filter Schema
- *
- * Includes mood and brandTone filters as optional extensions to existing filters
- */
-exports.extendedLayoutSearchFilterSchema = zod_1.z.object({
-    sectionType: zod_1.z.string().optional(),
-    sourceType: zod_1.z.string().optional(),
-    usageScope: zod_1.z.string().optional(),
-    visualFeatures: zod_1.z
-        .object({
-        theme: zod_1.z
-            .object({
-            type: zod_1.z.string().optional(),
-            minContrastRatio: zod_1.z.number().optional(),
-        })
-            .optional(),
-        colors: zod_1.z
-            .object({
-            dominantColor: zod_1.z.string().optional(),
-            colorTolerance: zod_1.z.number().optional(),
-        })
-            .optional(),
-        density: zod_1.z
-            .object({
-            minContentDensity: zod_1.z.number().optional(),
-            maxContentDensity: zod_1.z.number().optional(),
-        })
-            .optional(),
-        gradient: zod_1.z
-            .object({
-            requireGradient: zod_1.z.boolean().optional(),
-            gradientType: zod_1.z.string().optional(),
-        })
-            .optional(),
-    })
-        .optional(),
-    mood: exports.moodFilterSchema.optional(),
-    brandTone: exports.brandToneFilterSchema.optional(),
-});
-// ========== Search Request Schemas ==========
-/**
- * Mood Search Request Schema
- *
- * Used by MoodBrandToneSearchService.searchByMood()
- */
-exports.moodSearchRequestSchema = zod_1.z.object({
-    filter: exports.moodFilterSchema,
-    limit: zod_1.z.number().min(1).max(100).default(10),
-    offset: zod_1.z.number().min(0).default(0),
-});
-/**
- * Brand Tone Search Request Schema
- *
- * Used by MoodBrandToneSearchService.searchByBrandTone()
- */
-exports.brandToneSearchRequestSchema = zod_1.z.object({
-    filter: exports.brandToneFilterSchema,
-    limit: zod_1.z.number().min(1).max(100).default(10),
-    offset: zod_1.z.number().min(0).default(0),
-});
-/**
- * Combined Search Request Schema
- *
- * Used when both mood and brandTone filters are applied with RRF combination
- */
-exports.combinedSearchRequestSchema = zod_1.z
-    .object({
-    moodFilter: exports.moodFilterSchema.optional(),
-    brandToneFilter: exports.brandToneFilterSchema.optional(),
-    rrfWeights: exports.rrfWeightsSchema.optional(),
-    limit: zod_1.z.number().min(1).max(100).default(10),
-    offset: zod_1.z.number().min(0).default(0),
-})
-    .refine((data) => data.moodFilter || data.brandToneFilter, {
-    message: "At least one of moodFilter or brandToneFilter must be provided",
-});
-// ========== Search Result Schemas ==========
-/**
- * Search Result Schema
- *
- * Result item from searchByMood() or searchByBrandTone()
- */
-exports.searchResultSchema = zod_1.z.object({
-    patternId: zod_1.z.string().uuid(),
-    similarity: zod_1.z.number().min(0).max(1),
-    moodInfo: zod_1.z
-        .object({
-        primary: exports.MOOD_ENUM,
-        secondary: exports.MOOD_ENUM.optional(),
-    })
-        .optional(),
-    brandToneInfo: zod_1.z
-        .object({
-        primary: exports.BRAND_TONE_ENUM,
-        secondary: exports.BRAND_TONE_ENUM.optional(),
-    })
-        .optional(),
-});
-/**
- * Combined Search Result Schema
- *
- * Result from combineResultsWithRRF() with metadata
- */
-exports.combinedSearchResultSchema = zod_1.z.object({
-    results: zod_1.z.array(exports.searchResultSchema),
-    averageSimilarity: zod_1.z.number().min(0).max(1),
-    metadata: zod_1.z.object({
-        moodCount: zod_1.z.number().min(0),
-        brandToneCount: zod_1.z.number().min(0),
-        totalCount: zod_1.z.number().min(0),
-        rrfWeights: exports.rrfWeightsSchema,
-    }),
-});
-// ========== Validation Helper Functions ==========
-/**
- * Validate and parse mood filter input
- *
- * @param input - Raw input to validate
- * @returns Parsed and validated MoodFilter
- * @throws ZodError if validation fails
- */
-function parseMoodFilter(input) {
-    return exports.moodFilterSchema.parse(input);
-}
-/**
- * Validate and parse brand tone filter input
- *
- * @param input - Raw input to validate
- * @returns Parsed and validated BrandToneFilter
- * @throws ZodError if validation fails
- */
-function parseBrandToneFilter(input) {
-    return exports.brandToneFilterSchema.parse(input);
-}
-/**
- * Validate and parse RRF weights
- *
- * @param input - Raw input to validate
- * @returns Parsed and validated RRFWeights
- * @throws ZodError if validation fails
- */
-function parseRRFWeights(input) {
-    return exports.rrfWeightsSchema.parse(input);
-}
-/**
- * Validate search result against schema
- *
- * @param input - Raw result to validate
- * @returns Parsed and validated SearchResult
- * @throws ZodError if validation fails
- */
-function parseSearchResult(input) {
-    return exports.searchResultSchema.parse(input);
-}
-//# sourceMappingURL=mood-brandtone-filters.js.map

package/dist/schemas/mood-brandtone-filters.js.map

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

package/dist/scripts/backfill-embeddings.d.ts

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

package/dist/scripts/backfill-embeddings.d.ts.map

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

package/dist/scripts/backfill-embeddings.js

@@ -1,385 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-// SPDX-FileCopyrightText: 2026 TKMD and Reftrix Contributors
-// SPDX-License-Identifier: AGPL-3.0-only
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Manual Embedding Backfill CLI
- *
- * Finds pages with missing embeddings and generates them.
- * Uses the same logic as the pipeline's post-embedding backfill
- * and the worker startup backfill.
- *
- * **Memory isolation**: When processing all pages (no --url filter),
- * the script spawns a separate child process per site.  Each child
- * loads its own ONNX Runtime, processes one site, then exits —
- * releasing all GPU/CPU memory back to the OS.  This prevents RSS
- * accumulation that occurs when the ONNX Worker Thread processes
- * hundreds of embeddings in a single long-lived process.
- *
- * Usage:
- *   pnpm backfill:embeddings                           # All pages (1 process per site)
- *   pnpm backfill:embeddings -- --dry-run               # Count only, no changes
- *   pnpm backfill:embeddings -- --limit 50              # Process max 50 per page
- *   pnpm backfill:embeddings -- --url stripe.com        # Specific URL (in-process)
- *   pnpm backfill:embeddings -- --chunk-size 10         # Custom chunk size
- *
- * @module scripts/backfill-embeddings
- */
-const database_1 = require("@reftrixmcp/database");
-const ml_1 = require("@reftrixmcp/ml");
-const embedding_backfill_service_1 = require("../services/embedding-backfill.service");
-const layout_embedding_service_1 = require("../services/layout-embedding.service");
-const frame_embedding_service_1 = require("../services/motion/frame-embedding.service");
-const embedding_handler_1 = require("../tools/page/handlers/embedding-handler");
-/* eslint-disable no-console */
-// Load .env.local if present
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_os_1 = __importDefault(require("node:os"));
-const node_path_1 = __importDefault(require("node:path"));
-const node_child_process_1 = require("node:child_process");
-/**
- * Sentinel env var to prevent infinite re-exec loops.
- * Set by ensureLdLibraryPathForCuda() before re-spawning.
- */
-const REEXEC_SENTINEL = "__REFTRIX_CUDA_REEXEC";
-/**
- * Parse .env.local into a key-value map (without modifying process.env).
- */
-function parseEnvLocal() {
-    const envPaths = [
-        node_path_1.default.resolve(process.cwd(), ".env.local"),
-        node_path_1.default.resolve(__dirname, "../../../../.env.local"),
-    ];
-    const envVars = {};
-    for (const envPath of envPaths) {
-        if (node_fs_1.default.existsSync(envPath)) {
-            const content = node_fs_1.default.readFileSync(envPath, "utf-8");
-            for (const line of content.split("\n")) {
-                const trimmed = line.trim();
-                if (!trimmed || trimmed.startsWith("#"))
-                    continue;
-                const [key, ...valueParts] = trimmed.split("=");
-                if (key) {
-                    envVars[key] = valueParts.join("=").replace(/^["']|["']$/g, "");
-                }
-            }
-            break;
-        }
-    }
-    return envVars;
-}
-function loadEnvLocal() {
-    const envVars = parseEnvLocal();
-    for (const [key, value] of Object.entries(envVars)) {
-        if (!process.env[key]) {
-            process.env[key] = value;
-        }
-    }
-}
-/**
- * Ensure LD_LIBRARY_PATH is set at the OS level for CUDA to work.
- *
- * When ONNX_EXECUTION_PROVIDER=cuda is configured (in .env.local or env),
- * LD_LIBRARY_PATH must be set BEFORE the Node.js process starts so that
- * the dynamic linker (ld.so) can find CUDA shared libraries when dlopen()
- * is called by onnxruntime-node.
- *
- * Setting process.env.LD_LIBRARY_PATH at runtime does NOT work because
- * dlopen() reads from the kernel environment (/proc/self/environ), not
- * from Node.js's process.env object.
- *
- * This function detects the mismatch and re-executes the current script
- * with proper LD_LIBRARY_PATH inherited at the OS level.
- *
- * @returns true if execution should continue, false if process will be replaced
- */
-function ensureLdLibraryPathForCuda() {
-    // Already re-executed — don't loop
-    if (process.env[REEXEC_SENTINEL] === "1")
-        return true;
-    // Read .env.local to check if CUDA is requested
-    const envVars = parseEnvLocal();
-    const onnxProvider = process.env.ONNX_EXECUTION_PROVIDER ?? envVars["ONNX_EXECUTION_PROVIDER"];
-    if (onnxProvider !== "cuda" && onnxProvider !== "rocm")
-        return true;
-    // Check if LD_LIBRARY_PATH is already set at the OS level
-    try {
-        const procEnv = node_fs_1.default.readFileSync("/proc/self/environ", "utf-8");
-        if (procEnv.includes("LD_LIBRARY_PATH"))
-            return true;
-    }
-    catch {
-        // Non-Linux or /proc not available — assume OK
-        return true;
-    }
-    // LD_LIBRARY_PATH is needed but not set at the OS level.
-    // Re-exec the current process with proper environment.
-    const ldPath = process.env.LD_LIBRARY_PATH ?? envVars["LD_LIBRARY_PATH"];
-    if (!ldPath) {
-        console.warn("[Backfill] CUDA requested but LD_LIBRARY_PATH not configured. Falling back to CPU.");
-        return true;
-    }
-    console.warn("[Backfill] Re-executing with LD_LIBRARY_PATH for CUDA support...");
-    // Build merged environment: current env + .env.local vars + sentinel
-    const mergedEnv = {};
-    for (const [k, v] of Object.entries(process.env)) {
-        if (v !== undefined)
-            mergedEnv[k] = v;
-    }
-    for (const [k, v] of Object.entries(envVars)) {
-        if (!(k in mergedEnv))
-            mergedEnv[k] = v;
-    }
-    mergedEnv[REEXEC_SENTINEL] = "1";
-    // Ensure LD_LIBRARY_PATH is in the OS-level environment
-    mergedEnv["LD_LIBRARY_PATH"] = ldPath;
-    try {
-        // Re-exec with the same argv and execArgv (--expose-gc etc.),
-        // inheriting stdio for seamless output.
-        // execFileSync blocks until child exits, effectively replacing this process.
-        //
-        // SEC-H3: execFileSync（execSyncではない）を使用。
-        // - execFileSyncはシェル展開なし（コマンドインジェクション不可）
-        // - process.execPath はNode.jsバイナリパス（ユーザー入力なし）
-        // - stdio: 'inherit' は親プロセスのstdio fdを共有（PID等の露出リスクなし）
-        const childArgs = [...process.execArgv, ...process.argv.slice(1)];
-        (0, node_child_process_1.execFileSync)(process.execPath, childArgs, {
-            env: mergedEnv,
-            stdio: "inherit",
-        });
-        // execFileSync returns buffer on success (exit code 0)
-        process.exit(0);
-    }
-    catch (error) {
-        // execFileSync throws if child exits with non-zero code
-        const exitCode = error.status ?? 1;
-        process.exit(exitCode);
-    }
-    // Unreachable, but TypeScript needs it
-    return false;
-}
-/**
- * Sentinel env var set by the orchestrator process when spawning per-site
- * child processes.  Prevents the child from re-entering the orchestrator path.
- */
-const PER_SITE_CHILD_SENTINEL = "__REFTRIX_BACKFILL_CHILD";
-function parseArgs() {
-    const args = process.argv.slice(2);
-    const dryRun = args.includes("--dry-run");
-    const limit = args.includes("--limit")
-        ? parseInt(args[args.indexOf("--limit") + 1] || "0", 10) || undefined
-        : undefined;
-    const urlFilter = args.includes("--url") ? args[args.indexOf("--url") + 1] : undefined;
-    const chunkSize = args.includes("--chunk-size")
-        ? parseInt(args[args.indexOf("--chunk-size") + 1] || "5", 10)
-        : 5;
-    return { dryRun, limit, urlFilter, chunkSize };
-}
-async function main() {
-    // CUDA requires LD_LIBRARY_PATH at the OS level (before dlopen).
-    // If it's only in .env.local, re-exec the process with proper env.
-    if (!ensureLdLibraryPathForCuda())
-        return;
-    loadEnvLocal();
-    // Initialize DI factories — same pattern as page-analyze-worker.ts (lines 108-115)
-    // 1. EmbeddingService factory: LayoutEmbeddingService uses this to get ONNX inference
-    (0, layout_embedding_service_1.setEmbeddingServiceFactory)(() => ml_1.embeddingService);
-    // 2. PrismaClient factories: used by saveSectionEmbedding / saveMotionEmbedding
-    (0, layout_embedding_service_1.setPrismaClientFactory)(() => database_1.prisma);
-    (0, frame_embedding_service_1.setPrismaClientFactory)(() => database_1.prisma);
-    (0, embedding_handler_1.setBackgroundPrismaClientFactory)(() => database_1.prisma);
-    // 3. Shared LayoutEmbeddingService for Background/Motion embedding handlers
-    const sharedLayoutEmbeddingService = new layout_embedding_service_1.LayoutEmbeddingService();
-    (0, embedding_handler_1.setBackgroundEmbeddingServiceFactory)(() => sharedLayoutEmbeddingService);
-    (0, embedding_handler_1.setMotionLayoutEmbeddingServiceFactory)(() => sharedLayoutEmbeddingService);
-    const options = parseArgs();
-    const totalMemGB = (node_os_1.default.totalmem() / 1024 / 1024 / 1024).toFixed(1);
-    const thresholdGB = ((node_os_1.default.totalmem() * 0.7) / 1024 / 1024 / 1024).toFixed(1);
-    console.log("=== Embedding Backfill ===");
-    console.log(`Mode: ${options.dryRun ? "DRY RUN (no changes)" : "LIVE"}`);
-    console.log(`Memory: ${totalMemGB}GB total, threshold ${thresholdGB}GB (70%)`);
-    if (options.limit)
-        console.log(`Limit: ${options.limit} per page`);
-    if (options.urlFilter)
-        console.log(`URL filter: ${options.urlFilter}`);
-    console.log(`Chunk size: ${options.chunkSize}`);
-    console.log("");
-    // Find pages with missing embeddings
-    let pages;
-    if (options.urlFilter) {
-        const webPage = await database_1.prisma.webPage.findFirst({
-            where: { url: { contains: options.urlFilter } },
-            select: { id: true, url: true },
-        });
-        if (!webPage) {
-            console.log(`No web page found matching: ${options.urlFilter}`);
-            process.exit(1);
-        }
-        const coverage = await (0, embedding_backfill_service_1.checkWebPageEmbeddingCoverage)(webPage.id);
-        const missingCount = coverage.reduce((sum, c) => sum + c.missing, 0);
-        if (missingCount === 0) {
-            console.log(`No missing embeddings for ${webPage.url}`);
-            await database_1.prisma.$disconnect();
-            return;
-        }
-        pages = [{ webPageId: webPage.id, url: webPage.url, missingCount }];
-    }
-    else {
-        pages = await (0, embedding_backfill_service_1.findWebPagesWithMissingEmbeddings)();
-    }
-    if (pages.length === 0) {
-        console.log("No pages with missing embeddings found!");
-        await database_1.prisma.$disconnect();
-        return;
-    }
-    const grandTotalMissing = pages.reduce((sum, p) => sum + p.missingCount, 0);
-    console.log(`Found ${pages.length} pages with ${grandTotalMissing} missing embeddings\n`);
-    if (options.dryRun) {
-        for (const { url, missingCount, webPageId } of pages) {
-            console.log(`  ${url}: ${missingCount} missing`);
-            const coverage = await (0, embedding_backfill_service_1.checkWebPageEmbeddingCoverage)(webPageId);
-            for (const c of coverage) {
-                if (c.missing > 0) {
-                    console.log(`    ${c.type}: ${c.missing}/${c.total} missing`);
-                }
-            }
-        }
-        console.log("\n[DRY RUN] No changes made");
-        await database_1.prisma.$disconnect();
-        return;
-    }
-    // When --url is specified (single site) OR we are a per-site child process,
-    // process in-process directly.  Otherwise, orchestrate via child processes.
-    const isSingleSite = !!options.urlFilter || process.env[PER_SITE_CHILD_SENTINEL] === "1";
-    if (isSingleSite) {
-        await backfillSingleProcess(pages, options);
-    }
-    else {
-        await backfillViaChildProcesses(pages, options);
-    }
-}
-/**
- * Process pages in the current process (used for single-site --url mode
- * and when invoked as a per-site child process).
- */
-async function backfillSingleProcess(pages, options) {
-    let grandTotalBackfilled = 0;
-    let grandTotalErrors = 0;
-    for (const { webPageId, url, missingCount } of pages) {
-        console.log(`\n--- Backfilling ${url} (${missingCount} missing) ---`);
-        const startTime = Date.now();
-        const result = await (0, embedding_backfill_service_1.backfillWebPageEmbeddings)(webPageId, {
-            chunkSize: options.chunkSize,
-            onProgress: (type, done, total) => {
-                process.stdout.write(`\r  ${type}: ${done}/${total}`);
-            },
-            onMemoryPressure: (type, rssGB, thresholdGB2, action) => {
-                if (action === "dispose") {
-                    console.warn(`\n  MEMORY PRESSURE at ${type}: RSS ${rssGB}GB > ${thresholdGB2}GB — disposing pipeline...`);
-                }
-                else {
-                    console.warn(`\n  MEMORY SKIP at ${type}: RSS ${rssGB}GB > ${thresholdGB2}GB — recovery failed, skipping`);
-                }
-            },
-        });
-        const elapsed = Math.round((Date.now() - startTime) / 1000);
-        console.log(""); // newline after progress
-        console.log(`  Completed in ${elapsed}s`);
-        console.log(`  Section: ${result.sectionBackfilled}`);
-        console.log(`  Motion: ${result.motionBackfilled}`);
-        console.log(`  Background: ${result.backgroundBackfilled}`);
-        console.log(`  JS Animation: ${result.jsAnimationBackfilled}`);
-        console.log(`  Total: ${result.totalBackfilled}`);
-        if (result.memorySkips > 0) {
-            console.log(`  Memory skips: ${result.memorySkips}`);
-        }
-        if (result.errors.length > 0) {
-            console.log(`  Errors: ${result.errors.length}`);
-            for (const err of result.errors.slice(0, 5)) {
-                console.log(`    - ${err}`);
-            }
-            if (result.errors.length > 5) {
-                console.log(`    ... and ${result.errors.length - 5} more`);
-            }
-        }
-        grandTotalBackfilled += result.totalBackfilled;
-        grandTotalErrors += result.errors.length;
-    }
-    console.log("\n=== Summary ===");
-    console.log(`Total backfilled: ${grandTotalBackfilled}`);
-    console.log(`Total errors: ${grandTotalErrors}`);
-    console.log(`Pages processed: ${pages.length}`);
-    await database_1.prisma.$disconnect();
-    // Explicit exit: Worker Thread (ONNX CUDA) keeps the event loop alive.
-    // Without this, the process hangs after completion.
-    process.exit(0);
-}
-/**
- * Orchestrate backfill by spawning a separate child process per site.
- *
- * Each child process loads its own ONNX Runtime Worker Thread, processes
- * a single site, then exits — releasing all GPU/CPU memory back to the OS.
- * This prevents RSS accumulation across many sites.
- */
-async function backfillViaChildProcesses(pages, options) {
-    console.log(`\nProcessing ${pages.length} sites via per-site child processes (memory isolation)\n`);
-    await database_1.prisma.$disconnect();
-    let completed = 0;
-    let failed = 0;
-    const failedUrls = [];
-    for (const { url, missingCount } of pages) {
-        completed++;
-        console.log(`[${completed}/${pages.length}] Backfilling: ${url} (${missingCount} missing)`);
-        // Build child args: re-invoke this script with --url for the specific site
-        const childArgs = [...process.execArgv, ...process.argv.slice(1), "--url", url];
-        // Merge current env + sentinel to prevent re-entering orchestrator
-        const childEnv = {};
-        for (const [k, v] of Object.entries(process.env)) {
-            if (v !== undefined)
-                childEnv[k] = v;
-        }
-        childEnv[PER_SITE_CHILD_SENTINEL] = "1";
-        // Pass chunk-size if not already in argv
-        if (!process.argv.includes("--chunk-size")) {
-            childArgs.push("--chunk-size", String(options.chunkSize));
-        }
-        const startTime = Date.now();
-        try {
-            // SEC-H3: execFileSync使用（シェル展開なし、コマンドインジェクション不可）
-            (0, node_child_process_1.execFileSync)(process.execPath, childArgs, {
-                env: childEnv,
-                stdio: "inherit",
-                timeout: 600_000, // 10 minutes per site
-            });
-            const elapsed = Math.round((Date.now() - startTime) / 1000);
-            console.log(`  [OK] ${url} done (${elapsed}s)\n`);
-        }
-        catch (error) {
-            const elapsed = Math.round((Date.now() - startTime) / 1000);
-            const exitCode = error.status ?? 1;
-            console.error(`  [FAIL] ${url} (exit ${exitCode}, ${elapsed}s)\n`);
-            failed++;
-            failedUrls.push(url);
-        }
-    }
-    console.log("=== Batch Summary ===");
-    console.log(`Total sites: ${pages.length}`);
-    console.log(`Completed: ${pages.length - failed}`);
-    console.log(`Failed: ${failed}`);
-    if (failedUrls.length > 0) {
-        console.log("Failed URLs:");
-        for (const u of failedUrls) {
-            console.log(`  - ${u}`);
-        }
-    }
-    process.exit(failed > 0 ? 1 : 0);
-}
-main().catch((error) => {
-    console.error("Error:", error);
-    process.exit(1);
-});
-//# sourceMappingURL=backfill-embeddings.js.map