@reftrixmcp/mcp-server 0.1.7

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,265 @@
+"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

@@ -0,0 +1 @@
+{"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

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

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

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

package/dist/scripts/backfill-embeddings.js

@@ -0,0 +1,385 @@
+#!/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