@vibecodetown/mcp-server 1.3.1 → 1.5.0

package/build/index.js

@@ -13,10 +13,8 @@
  *   3 = BLOCK (차단)
  *   1 = ERROR (인프라/엔진 오류)
  */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
+import { createRequire } from 'node:module';
+import { getPackageVersion } from './kernel/paths.js';
 /**
  * VERSION SSOT:
  * - package.json#version을 단일 진실로 사용한다.
@@ -26,38 +24,15 @@ function readPackageVersion() {
     // 1) require 기반 (빌드 후에도 상대 경로가 유지되는 경우 가장 간단)
     try {
         const require = createRequire(import.meta.url);
-        const pkg = require("../package.json");
-        if (pkg?.version && typeof pkg.version === "string")
+        const pkg = require('../package.json');
+        if (pkg?.version && typeof pkg.version === 'string')
             return pkg.version;
     }
     catch {
         // ignore and fall back
     }
-    // 2) fs fallback: build 디렉토리 구조가 달라져도 최대한 탐색
-    // src/index.ts → build/index.js 로 변환되는 것을 고려해서 상위 탐색
-    try {
-        const __dirname = path.dirname(fileURLToPath(import.meta.url));
-        const candidates = [
-            path.resolve(__dirname, "../package.json"),
-            path.resolve(__dirname, "../../package.json"),
-            path.resolve(process.cwd(), "package.json"),
-        ];
-        for (const candidate of candidates) {
-            try {
-                const raw = fs.readFileSync(candidate, "utf8");
-                const parsed = JSON.parse(raw);
-                if (parsed?.version && typeof parsed.version === "string")
-                    return parsed.version;
-            }
-            catch {
-                // continue
-            }
-        }
-    }
-    catch {
-        // ignore
-    }
-    return "0.0.0"; // fail-safe (테스트로 잠금)
+    // 2) paths.ts SSOT fallback
+    return getPackageVersion();
 }
 export const VERSION = readPackageVersion();
 export const EXIT_CODES = {
@@ -69,63 +44,63 @@ export const EXIT_CODES = {
 // ============================================================
 // Skill Loader
 // ============================================================
-export { SkillLoader, createSkillLoader, } from "./skill-loader.js";
+export { SkillLoader, createSkillLoader, } from './skill-loader.js';
 // ============================================================
 // Evidence Report
 // ============================================================
-export { EvidenceReportGenerator, generateEvidenceReport, generateEvidenceReportFromRunDir, saveEvidenceReport, saveEvidenceReportFromRunDir, generatePrComment, generatePrCommentFromRunDir, savePrComment, savePrCommentFromRunDir, } from "./evidence-report.js";
+export { EvidenceReportGenerator, generateEvidenceReport, generateEvidenceReportFromRunDir, saveEvidenceReport, saveEvidenceReportFromRunDir, generatePrComment, generatePrCommentFromRunDir, savePrComment, savePrCommentFromRunDir, } from './evidence-report.js';
 // ============================================================
 // Profile Configuration
 // ============================================================
-export { ProfileManager, loadProfileFromEnv, filterSkillsByProfile, requireFeature, getAvailableProfiles, PROFILES, MVP_PROFILE, PRO_PROFILE, ALL_PROFILE, } from "./profile-config.js";
+export { ProfileManager, loadProfileFromEnv, filterSkillsByProfile, requireFeature, getAvailableProfiles, PROFILES, MVP_PROFILE, PRO_PROFILE, ALL_PROFILE, } from './profile-config.js';
 // ============================================================
 // License Manager
 // ============================================================
-export { LicenseManager, loadEntitlements, setupEngineEnvironment, getLicenseDir, getLicensePath, } from "./license-manager.js";
+export { LicenseManager, loadEntitlements, setupEngineEnvironment, getLicenseDir, getLicensePath, } from './license-manager.js';
 // ============================================================
 // Correction Messages (훈계 프롬프트)
 // ============================================================
-export { pathViolationMessage, readOnlyViolationMessage, commandSafetyMessage, licenseRestrictionMessage, iterationLimitMessage, scopeDriftMessage, missingWorkOrderMessage, missingDecisionMessage, formatCorrectionForAgent, formatCorrectionForUser, } from "./correction-messages.js";
+export { pathViolationMessage, readOnlyViolationMessage, commandSafetyMessage, licenseRestrictionMessage, iterationLimitMessage, scopeDriftMessage, missingWorkOrderMessage, missingDecisionMessage, formatCorrectionForAgent, formatCorrectionForUser, } from './correction-messages.js';
 // ============================================================
 // Sync Packet Builder
 // ============================================================
-export { SyncPacketBuilder, buildSyncPacket, encryptSyncPacket, decryptSyncPacket, generateRunId, } from "./sync-packet-builder.js";
+export { SyncPacketBuilder, buildSyncPacket, encryptSyncPacket, decryptSyncPacket, generateRunId, } from './sync-packet-builder.js';
 // ============================================================
 // Background Sync Worker
 // ============================================================
-export { BackgroundSyncWorker, flushQueueInBackground, queueAndFlush, getQueueDir, getDlqDir, } from "./background-sync-worker.js";
+export { BackgroundSyncWorker, flushQueueInBackground, queueAndFlush, getQueueDir, getDlqDir, } from './background-sync-worker.js';
 // ============================================================
 // Sync Manager (Dashboard Sync)
 // ============================================================
-export { OfflineQueue, getDefaultQueueDir, } from "./offline-queue.js";
-export { SyncManager, sendEncryptedPacket, } from "./sync-manager.js";
+export { OfflineQueue, getDefaultQueueDir, } from './offline-queue.js';
+export { SyncManager, sendEncryptedPacket, } from './sync-manager.js';
 // ============================================================
 // Dashboard Server (Local MVP)
 // ============================================================
-export { startDashboardServer, } from "./dashboard/server.js";
+export { startDashboardServer, } from './dashboard/server.js';
 // ============================================================
 // Report Generator
 // ============================================================
 export { ReportGenerator, generatePdfReport, generateHtmlReport, generateMarkdownReport, 
 // CI Summary based HTML (SSOT)
-generateHtmlFromCiSummary, writeHtmlReportFromCiSummary, writeHtmlReportFromCiSummarySafe, } from "./report-generator.js";
+generateHtmlFromCiSummary, writeHtmlReportFromCiSummary, writeHtmlReportFromCiSummarySafe, } from './report-generator.js';
 // ============================================================
 // Deep Link Utilities
 // ============================================================
-export { createVscodeLink, createJetBrainsLink, renderTerminalLink, renderPlainLink, supportsOsc8, renderViolationLinks, buildViolationLinks, createReportLink, renderSummaryWithLink, } from "./deep-link.js";
+export { createVscodeLink, createJetBrainsLink, renderTerminalLink, renderPlainLink, supportsOsc8, renderViolationLinks, buildViolationLinks, createReportLink, renderSummaryWithLink, } from './deep-link.js';
 // ============================================================
 // Reviewer UX Types
 // ============================================================
-export { VERDICT_TO_SIGNAL, SIGNAL_EMOJI, } from "./reviewer-ux-types.js";
+export { VERDICT_TO_SIGNAL, SIGNAL_EMOJI, } from './reviewer-ux-types.js';
 // ============================================================
 // Decision Log Reader
 // ============================================================
-export { readDecisionLog, readRecentDecisions, hasDecisionEvidence, findDecisionLogPath, } from "./decision-log-reader.js";
+export { readDecisionLog, readRecentDecisions, hasDecisionEvidence, findDecisionLogPath, } from './decision-log-reader.js';
 // ============================================================
 // Review History
 // ============================================================
-export { recordReviewHistory, getHotspotFiles, hasReviewHistory, getHistoryEntryCount, cleanupOldHistory, } from "./review-history.js";
+export { recordReviewHistory, getHotspotFiles, hasReviewHistory, getHistoryEntryCount, cleanupOldHistory, } from './review-history.js';
 // ============================================================
 // Config Loader (policy.yaml + overrides merge)
 // ============================================================
-export { loadVibeCiConfig, loadVibeCiConfigSafe, createDefaultConfig, createDefaultPolicy, } from "./config/load-config.js";
+export { loadVibeCiConfig, loadVibeCiConfigSafe, createDefaultConfig, createDefaultPolicy, } from './config/load-config.js';

package/build/kernel/async-fs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Async file system helpers.
+ *
+ * Thin wrappers around node:fs/promises for common patterns.
+ * All functions are fail-safe (return null/false on error).
+ */
+/**
+ * Read and parse a JSON file. Returns null on any error.
+ */
+export declare function readJsonFileAsync<T>(p: string): Promise<T | null>;
+/**
+ * Write a JSON file with pretty-printing. Creates parent directory if needed.
+ */
+export declare function writeJsonFileAsync(p: string, v: unknown): Promise<void>;
+/**
+ * Check if a file/directory exists (async).
+ */
+export declare function existsAsync(p: string): Promise<boolean>;
+/**
+ * Read a text file. Returns null on any error.
+ */
+export declare function readTextFileAsync(p: string): Promise<string | null>;

package/build/kernel/async-fs.js

@@ -0,0 +1,50 @@
+/**
+ * Async file system helpers.
+ *
+ * Thin wrappers around node:fs/promises for common patterns.
+ * All functions are fail-safe (return null/false on error).
+ */
+import { readFile, writeFile, access, mkdir } from 'node:fs/promises';
+import * as path from 'node:path';
+/**
+ * Read and parse a JSON file. Returns null on any error.
+ */
+export async function readJsonFileAsync(p) {
+    try {
+        const raw = await readFile(p, 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Write a JSON file with pretty-printing. Creates parent directory if needed.
+ */
+export async function writeJsonFileAsync(p, v) {
+    await mkdir(path.dirname(p), { recursive: true });
+    await writeFile(p, JSON.stringify(v, null, 2));
+}
+/**
+ * Check if a file/directory exists (async).
+ */
+export async function existsAsync(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read a text file. Returns null on any error.
+ */
+export async function readTextFileAsync(p) {
+    try {
+        return await readFile(p, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}

package/build/kernel/atomic_writer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Atomic File Writer
+ *
+ * Writes files atomically using write-to-temp-then-rename pattern.
+ * Prevents data corruption when process crashes during write.
+ *
+ * Pattern: write to temp file → rename (atomic on POSIX/NTFS)
+ * Guarantee: target file is either fully written or unchanged.
+ *
+ * @since v1.35.0 (P35)
+ */
+/**
+ * Write data to a file atomically.
+ *
+ * Uses write-to-temp-then-rename to ensure the target file is never
+ * partially written. Either the write fully succeeds or the original
+ * file remains unchanged.
+ *
+ * @param filePath - Target file path (parent directory created if needed)
+ * @param data - File content as string
+ */
+export declare function writeFileAtomic(filePath: string, data: string): void;

package/build/kernel/atomic_writer.js

@@ -0,0 +1,43 @@
+/**
+ * Atomic File Writer
+ *
+ * Writes files atomically using write-to-temp-then-rename pattern.
+ * Prevents data corruption when process crashes during write.
+ *
+ * Pattern: write to temp file → rename (atomic on POSIX/NTFS)
+ * Guarantee: target file is either fully written or unchanged.
+ *
+ * @since v1.35.0 (P35)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+/**
+ * Write data to a file atomically.
+ *
+ * Uses write-to-temp-then-rename to ensure the target file is never
+ * partially written. Either the write fully succeeds or the original
+ * file remains unchanged.
+ *
+ * @param filePath - Target file path (parent directory created if needed)
+ * @param data - File content as string
+ */
+export function writeFileAtomic(filePath, data) {
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    const suffix = crypto.randomBytes(4).toString('hex');
+    const tmpPath = `${filePath}.${suffix}.tmp`;
+    try {
+        fs.writeFileSync(tmpPath, data, 'utf-8');
+        fs.renameSync(tmpPath, filePath);
+    }
+    catch (err) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch {
+            // temp cleanup best-effort
+        }
+        throw err;
+    }
+}

package/build/kernel/blocks/assembler.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Context Assembler — Chain-based intelligent context packing
+ *
+ * Assembles a token-budgeted context window around a target block
+ * by traversing its chain and applying priority-based packing:
+ *
+ *   Phase 1: Focus block (full, never truncated)
+ *   Phase 2: Immediate neighbors (full)
+ *   Phase 3: Distant ancestors (skeleton — signatures only)
+ *   Phase 4: Distant descendants (full, budget permitting)
+ *
+ * @since v1.7.0
+ */
+import type { SemanticBlock, BlockSearchResult } from './types.js';
+import type { BlockStore } from './store.js';
+export interface AssembleOptions {
+    /** Maximum token budget (default: 1800 per pack_policy recommended) */
+    maxTokens?: number;
+    /** Blocks farther than this from focus get skeleton treatment (default: 2) */
+    skeletonDepth?: number;
+}
+export interface QueryAssembleOptions {
+    /** Maximum token budget (default: 1800) */
+    maxTokens?: number;
+    /** Number of search results to consider (default: 5) */
+    topK?: number;
+    /** Skeleton depth for chain context (default: 2) */
+    skeletonDepth?: number;
+}
+/**
+ * DI interface for search backends (in-memory or DB FTS).
+ * kernel/blocks/ does NOT import db_sync/ directly — this interface enables DI.
+ */
+export interface QuerySearchBackend {
+    search(query: string, topK?: number): Promise<BlockSearchResult[]>;
+}
+export interface IncludedBlock {
+    block: SemanticBlock;
+    mode: 'full' | 'skeleton';
+    tokens: number;
+}
+export interface AssembledContext {
+    /** Ordered list of included blocks (document order) */
+    blocks: IncludedBlock[];
+    /** Total tokens consumed */
+    totalTokens: number;
+    /** Index of focus block within blocks[] */
+    focusIndex: number;
+    /** Source file path from chain */
+    sourcePath: string;
+    /** Chain root hash */
+    rootHash: string;
+    /** True if some blocks were excluded due to budget */
+    truncated: boolean;
+}
+/**
+ * Estimate token count from text (word-count approximation).
+ * Same approach as chunking.ts estimateTokens().
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Code-aware token estimation with special-character and identifier correction.
+ *
+ * BPE tokenizers split special characters into individual tokens and break
+ * long camelCase/snake_case identifiers into sub-words. This function applies
+ * empirical correction factors to word count for better accuracy on code.
+ *
+ * @returns Estimated token count (typically 20-40% higher than word count for code)
+ */
+export declare function estimateCodeTokens(code: string): number;
+/**
+ * Strip function/method bodies, keeping only signatures.
+ * Handles nested braces for multi-level blocks.
+ */
+export declare function skeletonize(code: string): string;
+export declare class ContextAssembler {
+    private store;
+    constructor(store: BlockStore);
+    /**
+     * Assemble a token-budgeted context around a target block.
+     *
+     * @param targetBlockId - Block to focus on
+     * @param options - Token budget and skeleton depth
+     * @returns Assembled context with included blocks and metadata
+     */
+    assemble(targetBlockId: string, options?: AssembleOptions): AssembledContext;
+    /**
+     * Assemble context from a query string using a search backend.
+     *
+     * Flow:
+     * 1. Search for relevant blocks via searchBackend
+     * 2. If top result found, assemble chain context around it
+     * 3. Attach additional search results as supplementary blocks
+     *
+     * @param query - Search query
+     * @param searchBackend - DI search backend (DB FTS or in-memory)
+     * @param options - Token budget and search params
+     * @returns Assembled context, or null if no results
+     */
+    assembleFromQuery(query: string, searchBackend: QuerySearchBackend, options?: QueryAssembleOptions): Promise<AssembledContext | null>;
+}

package/build/kernel/blocks/assembler.js

@@ -0,0 +1,254 @@
+/**
+ * Context Assembler — Chain-based intelligent context packing
+ *
+ * Assembles a token-budgeted context window around a target block
+ * by traversing its chain and applying priority-based packing:
+ *
+ *   Phase 1: Focus block (full, never truncated)
+ *   Phase 2: Immediate neighbors (full)
+ *   Phase 3: Distant ancestors (skeleton — signatures only)
+ *   Phase 4: Distant descendants (full, budget permitting)
+ *
+ * @since v1.7.0
+ */
+// ============================================================================
+// Utilities
+// ============================================================================
+/**
+ * Estimate token count from text (word-count approximation).
+ * Same approach as chunking.ts estimateTokens().
+ */
+export function estimateTokens(text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return 0;
+    return trimmed.split(/\s+/).length;
+}
+/**
+ * Code-aware token estimation with special-character and identifier correction.
+ *
+ * BPE tokenizers split special characters into individual tokens and break
+ * long camelCase/snake_case identifiers into sub-words. This function applies
+ * empirical correction factors to word count for better accuracy on code.
+ *
+ * @returns Estimated token count (typically 20-40% higher than word count for code)
+ */
+export function estimateCodeTokens(code) {
+    const trimmed = code.trim();
+    if (!trimmed)
+        return 0;
+    const words = trimmed.split(/\s+/);
+    const wordCount = words.length;
+    // Count special characters that BPE typically tokenizes individually
+    let specials = 0;
+    for (let i = 0; i < trimmed.length; i++) {
+        const ch = trimmed[i];
+        if ('{}()[];:.,<>=!&|?+-*/^~@#%'.includes(ch)) {
+            specials++;
+        }
+    }
+    // Count long identifiers that BPE splits into sub-words
+    let longIdBonus = 0;
+    for (const word of words) {
+        if (word.length >= 20) {
+            longIdBonus += 1.5;
+        }
+        else if (word.length >= 12) {
+            longIdBonus += 0.5;
+        }
+    }
+    return Math.ceil(wordCount + specials * 0.3 + longIdBonus);
+}
+/**
+ * Strip function/method bodies, keeping only signatures.
+ * Handles nested braces for multi-level blocks.
+ */
+export function skeletonize(code) {
+    let result = '';
+    let depth = 0;
+    let firstBrace = true;
+    for (let i = 0; i < code.length; i++) {
+        const ch = code[i];
+        if (ch === '{') {
+            if (depth === 0 && firstBrace) {
+                result += '{ /* ... */ }';
+                firstBrace = false;
+            }
+            depth++;
+        }
+        else if (ch === '}') {
+            depth--;
+            if (depth < 0)
+                depth = 0;
+        }
+        else if (depth === 0) {
+            result += ch;
+        }
+    }
+    return result.trim() || code;
+}
+// ============================================================================
+// Context Assembler
+// ============================================================================
+export class ContextAssembler {
+    store;
+    constructor(store) {
+        this.store = store;
+    }
+    /**
+     * Assemble a token-budgeted context around a target block.
+     *
+     * @param targetBlockId - Block to focus on
+     * @param options - Token budget and skeleton depth
+     * @returns Assembled context with included blocks and metadata
+     */
+    assemble(targetBlockId, options) {
+        const maxTokens = options?.maxTokens ?? 1800;
+        const skeletonDepth = options?.skeletonDepth ?? 2;
+        // Step 1: Get target block
+        const targetBlock = this.store.get(targetBlockId);
+        if (!targetBlock) {
+            throw new Error(`Block not found: ${targetBlockId}`);
+        }
+        // Step 2: Get full chain
+        const chainBlocks = this.store.getChainBlocks(targetBlock.root_hash);
+        if (!chainBlocks || chainBlocks.length === 0) {
+            throw new Error(`Chain not found for root_hash: ${targetBlock.root_hash}`);
+        }
+        const chain = this.store.getChain(targetBlock.root_hash);
+        if (!chain) {
+            throw new Error(`Chain metadata not found: ${targetBlock.root_hash}`);
+        }
+        // Step 3: Find target position
+        const targetIdx = chainBlocks.findIndex(b => b.block_id === targetBlockId);
+        if (targetIdx < 0) {
+            throw new Error(`Block ${targetBlockId} not found in its chain`);
+        }
+        let remaining = maxTokens;
+        const slots = new Array(chainBlocks.length).fill(null);
+        let totalIncluded = 0;
+        // Phase 1: Focus block (always full, never skipped)
+        const focusTokens = estimateTokens(targetBlock.content);
+        slots[targetIdx] = {
+            idx: targetIdx,
+            entry: { block: targetBlock, mode: 'full', tokens: focusTokens },
+        };
+        remaining -= focusTokens;
+        totalIncluded++;
+        // Phase 2: Immediate neighbors (full mode)
+        for (const offset of [-1, 1]) {
+            const ni = targetIdx + offset;
+            if (ni >= 0 && ni < chainBlocks.length && remaining > 0) {
+                const neighbor = chainBlocks[ni];
+                const tokens = estimateTokens(neighbor.content);
+                if (tokens <= remaining) {
+                    slots[ni] = {
+                        idx: ni,
+                        entry: { block: neighbor, mode: 'full', tokens },
+                    };
+                    remaining -= tokens;
+                    totalIncluded++;
+                }
+            }
+        }
+        // Phase 3: Distant ancestors (skeleton mode)
+        for (let i = targetIdx - skeletonDepth; i >= 0 && remaining > 0; i--) {
+            if (slots[i])
+                continue;
+            const ancestor = chainBlocks[i];
+            const skeleton = skeletonize(ancestor.content);
+            const tokens = estimateTokens(skeleton);
+            if (tokens <= remaining) {
+                slots[i] = {
+                    idx: i,
+                    entry: { block: ancestor, mode: 'skeleton', tokens },
+                };
+                remaining -= tokens;
+                totalIncluded++;
+            }
+        }
+        // Phase 4: Distant descendants (full mode, budget permitting)
+        for (let i = targetIdx + skeletonDepth; i < chainBlocks.length && remaining > 0; i++) {
+            if (slots[i])
+                continue;
+            const descendant = chainBlocks[i];
+            const tokens = estimateTokens(descendant.content);
+            if (tokens <= remaining) {
+                slots[i] = {
+                    idx: i,
+                    entry: { block: descendant, mode: 'full', tokens },
+                };
+                remaining -= tokens;
+                totalIncluded++;
+            }
+        }
+        // Collect in document order
+        const blocks = [];
+        let focusIndex = -1;
+        for (const slot of slots) {
+            if (slot) {
+                if (slot.idx === targetIdx) {
+                    focusIndex = blocks.length;
+                }
+                blocks.push(slot.entry);
+            }
+        }
+        return {
+            blocks,
+            totalTokens: maxTokens - remaining,
+            focusIndex,
+            sourcePath: chain.source_path,
+            rootHash: chain.root_hash,
+            truncated: totalIncluded < chainBlocks.length,
+        };
+    }
+    /**
+     * Assemble context from a query string using a search backend.
+     *
+     * Flow:
+     * 1. Search for relevant blocks via searchBackend
+     * 2. If top result found, assemble chain context around it
+     * 3. Attach additional search results as supplementary blocks
+     *
+     * @param query - Search query
+     * @param searchBackend - DI search backend (DB FTS or in-memory)
+     * @param options - Token budget and search params
+     * @returns Assembled context, or null if no results
+     */
+    async assembleFromQuery(query, searchBackend, options) {
+        const topK = options?.topK ?? 5;
+        const maxTokens = options?.maxTokens ?? 1800;
+        const skeletonDepth = options?.skeletonDepth ?? 2;
+        const results = await searchBackend.search(query, topK);
+        if (results.length === 0) {
+            return null;
+        }
+        // Use top-1 result as focus block → assemble chain context
+        const topResult = results[0];
+        try {
+            return this.assemble(topResult.block.block_id, { maxTokens, skeletonDepth });
+        }
+        catch {
+            // Chain not found in store → fall back to search results only
+            const blocks = [];
+            let totalTokens = 0;
+            for (const r of results) {
+                const tokens = estimateTokens(r.block.content);
+                if (totalTokens + tokens > maxTokens)
+                    break;
+                blocks.push({ block: r.block, mode: 'full', tokens });
+                totalTokens += tokens;
+            }
+            if (blocks.length === 0)
+                return null;
+            return {
+                blocks,
+                totalTokens,
+                focusIndex: 0,
+                sourcePath: topResult.block.source_ref,
+                rootHash: topResult.block.root_hash,
+                truncated: results.length > blocks.length,
+            };
+        }
+    }
+}