@jagilber-org/index-server 1.19.1

package/dist/services/toolRegistry.zod.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getZodEnhancedRegistry = getZodEnhancedRegistry;
+exports.getZodSchema = getZodSchema;
+exports.hasZodSchema = hasZodSchema;
+const zod_1 = require("zod");
+const toolRegistry_1 = require("./toolRegistry");
+/**
+ * Complete Zod schema registry for all MCP index tools.
+ * Zod schemas provide runtime validation with richer type inference.
+ * JSON Schemas in the base registry remain the external protocol contract.
+ */
+// ── Reusable primitives ──────────────────────────────────────────────────────
+const zEmpty = zod_1.z.object({}).passthrough();
+const zStringId = zod_1.z.object({ id: zod_1.z.string().min(1) }).strict();
+// ── Index dispatcher ───────────────────────────────────────────────────────
+const zDispatch = zod_1.z.object({
+    action: zod_1.z.enum([
+        'list', 'listScoped', 'get', 'getEnhanced', 'search', 'query', 'categories', 'diff', 'export',
+        'add', 'import', 'remove', 'reload', 'groom', 'repair', 'enrich',
+        'governanceHash', 'governanceUpdate',
+        'health', 'inspect', 'dir', 'capabilities', 'batch',
+        'manifestStatus', 'manifestRefresh', 'manifestRepair'
+    ]),
+    id: zod_1.z.string().optional(),
+    q: zod_1.z.string().optional(),
+    keywords: zod_1.z.array(zod_1.z.string()).optional(),
+    ids: zod_1.z.array(zod_1.z.string()).optional(),
+    category: zod_1.z.string().optional(),
+    contentType: zod_1.z.string().optional(),
+    text: zod_1.z.string().optional(),
+    includeCategories: zod_1.z.boolean().optional(),
+    caseSensitive: zod_1.z.boolean().optional(),
+    categoriesAny: zod_1.z.array(zod_1.z.string()).optional(),
+    categoriesAll: zod_1.z.array(zod_1.z.string()).optional(),
+    clientHash: zod_1.z.string().optional(),
+    metaOnly: zod_1.z.boolean().optional(),
+    limit: zod_1.z.number().optional(),
+    offset: zod_1.z.number().optional(),
+    entry: zod_1.z.object({}).passthrough().optional(),
+    overwrite: zod_1.z.boolean().optional(),
+    lax: zod_1.z.boolean().optional(),
+    entries: zod_1.z.union([zod_1.z.array(zod_1.z.object({}).passthrough()), zod_1.z.string()]).optional(),
+    source: zod_1.z.string().optional(),
+    mode: zod_1.z.unknown().optional(),
+    owner: zod_1.z.string().optional(),
+    status: zod_1.z.string().optional(),
+    bump: zod_1.z.enum(['patch', 'minor', 'major', 'none']).optional(),
+    lastReviewedAt: zod_1.z.string().optional(),
+    nextReviewDue: zod_1.z.string().optional(),
+    missingOk: zod_1.z.boolean().optional(),
+    force: zod_1.z.boolean().optional(),
+    dryRun: zod_1.z.boolean().optional()
+}).passthrough();
+// ── Index CRUD ─────────────────────────────────────────────────────────────
+const zIndexEntry = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    title: zod_1.z.string().min(1).optional(),
+    body: zod_1.z.string().min(1).max(1000000),
+    rationale: zod_1.z.string().optional(),
+    priority: zod_1.z.number().int().min(1).max(100).optional(),
+    audience: zod_1.z.string().optional(),
+    requirement: zod_1.z.string().optional(),
+    categories: zod_1.z.array(zod_1.z.string()).max(50).optional(),
+    deprecatedBy: zod_1.z.string().optional(),
+    riskScore: zod_1.z.number().optional()
+}).strict();
+const zAdd = zod_1.z.object({
+    entry: zIndexEntry,
+    overwrite: zod_1.z.boolean().optional(),
+    lax: zod_1.z.boolean().optional()
+}).strict();
+const zImport = zod_1.z.object({
+    entries: zod_1.z.union([
+        zod_1.z.array(zod_1.z.object({
+            id: zod_1.z.string(),
+            title: zod_1.z.string(),
+            body: zod_1.z.string().max(1000000),
+            rationale: zod_1.z.string().optional(),
+            priority: zod_1.z.number(),
+            audience: zod_1.z.string(),
+            requirement: zod_1.z.string(),
+            categories: zod_1.z.array(zod_1.z.string()).optional(),
+            mode: zod_1.z.string().optional()
+        }).passthrough()).min(1),
+        zod_1.z.string()
+    ]).optional(),
+    source: zod_1.z.string().optional(),
+    mode: zod_1.z.enum(['skip', 'overwrite']).optional()
+}).strict();
+const zRemove = zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1),
+    missingOk: zod_1.z.boolean().optional(),
+    force: zod_1.z.boolean().optional(),
+    dryRun: zod_1.z.boolean().optional()
+}).strict();
+const zGroom = zod_1.z.object({
+    mode: zod_1.z.object({
+        dryRun: zod_1.z.boolean().optional(),
+        removeDeprecated: zod_1.z.boolean().optional(),
+        mergeDuplicates: zod_1.z.boolean().optional(),
+        purgeLegacyScopes: zod_1.z.boolean().optional(),
+        remapCategories: zod_1.z.boolean().optional()
+    }).strict().optional()
+}).strict();
+const zNormalize = zod_1.z.object({
+    dryRun: zod_1.z.boolean().optional(),
+    forceCanonical: zod_1.z.boolean().optional()
+}).strict();
+const zInspect = zStringId;
+// ── Governance ───────────────────────────────────────────────────────────────
+const zGovernanceUpdate = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    owner: zod_1.z.string().min(1).optional(),
+    status: zod_1.z.enum(['approved', 'draft', 'deprecated']).optional(),
+    lastReviewedAt: zod_1.z.string().optional(),
+    nextReviewDue: zod_1.z.string().optional(),
+    bump: zod_1.z.enum(['patch', 'minor', 'major', 'none']).optional()
+}).strict();
+// ── Search ───────────────────────────────────────────────────────────────────
+const zSearch = zod_1.z.object({
+    keywords: zod_1.z.array(zod_1.z.string().min(1).max(100)).min(1).max(10),
+    mode: zod_1.z.enum(['keyword', 'regex', 'semantic']).default('keyword').optional(),
+    limit: zod_1.z.number().int().min(1).max(100).default(50).optional(),
+    includeCategories: zod_1.z.boolean().default(false).optional(),
+    caseSensitive: zod_1.z.boolean().default(false).optional(),
+    contentType: zod_1.z.enum(['instruction', 'template', 'chat-session', 'reference', 'example', 'agent']).optional()
+}).strict();
+// ── Diagnostics ──────────────────────────────────────────────────────────────
+const zDiagnostics = zod_1.z.object({
+    includeTrace: zod_1.z.boolean().optional()
+}).strict();
+// ── Feedback ─────────────────────────────────────────────────────────────────
+const zFeedbackSubmit = zod_1.z.object({
+    type: zod_1.z.enum(['issue', 'status', 'security', 'feature-request', 'bug-report', 'performance', 'usability', 'other']),
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    title: zod_1.z.string().min(1).max(200),
+    description: zod_1.z.string().min(1).max(10000),
+    context: zod_1.z.object({}).passthrough().optional(),
+    metadata: zod_1.z.object({}).passthrough().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).max(10).optional()
+}).strict();
+const zFeedbackList = zod_1.z.object({
+    type: zod_1.z.enum(['issue', 'status', 'security', 'feature-request', 'bug-report', 'performance', 'usability', 'other']).optional(),
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']).optional(),
+    status: zod_1.z.enum(['new', 'acknowledged', 'in-progress', 'resolved', 'closed']).optional(),
+    limit: zod_1.z.number().int().min(1).max(200).optional(),
+    offset: zod_1.z.number().int().min(0).optional(),
+    since: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional()
+}).strict();
+const zFeedbackGet = zStringId;
+const zFeedbackUpdate = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    status: zod_1.z.enum(['new', 'acknowledged', 'in-progress', 'resolved', 'closed']).optional(),
+    metadata: zod_1.z.object({}).passthrough().optional()
+}).strict();
+const zFeedbackStats = zod_1.z.object({
+    since: zod_1.z.string().optional()
+}).strict();
+const zFeedbackDispatch = zod_1.z.object({
+    action: zod_1.z.enum(['submit', 'list', 'get', 'update', 'stats', 'health', 'rate']),
+    instructionId: zod_1.z.string().optional(),
+    rating: zod_1.z.enum(['useful', 'not-useful', 'outdated', 'incomplete']).optional(),
+    comment: zod_1.z.string().max(1000).optional(),
+    type: zod_1.z.enum(['issue', 'status', 'security', 'feature-request', 'bug-report', 'performance', 'usability', 'other']).optional(),
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']).optional(),
+    title: zod_1.z.string().max(200).optional(),
+    description: zod_1.z.string().max(10000).optional(),
+    body: zod_1.z.string().max(10000).optional(),
+    id: zod_1.z.string().optional(),
+    status: zod_1.z.enum(['new', 'acknowledged', 'in-progress', 'resolved', 'closed']).optional(),
+    limit: zod_1.z.number().int().min(1).max(200).optional(),
+    offset: zod_1.z.number().int().min(0).optional(),
+    since: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    metadata: zod_1.z.object({}).passthrough().optional()
+}).passthrough();
+// ── Usage ────────────────────────────────────────────────────────────────────
+const zUsageTrack = zod_1.z.object({
+    id: zod_1.z.string().min(1),
+    action: zod_1.z.enum(['retrieved', 'applied', 'cited']).optional(),
+    signal: zod_1.z.enum(['helpful', 'not-relevant', 'outdated', 'applied']).optional(),
+    comment: zod_1.z.string().max(256).optional()
+}).strict();
+const zHotset = zod_1.z.object({
+    limit: zod_1.z.number().int().min(1).max(100).optional()
+}).strict();
+const zUsageFlush = zod_1.z.object({
+    id: zod_1.z.string().optional(),
+    before: zod_1.z.string().optional()
+}).strict();
+// ── Graph ────────────────────────────────────────────────────────────────────
+const zGraphExport = zod_1.z.object({
+    includeEdgeTypes: zod_1.z.array(zod_1.z.enum(['primary', 'category', 'belongs'])).max(3).optional(),
+    maxEdges: zod_1.z.number().int().min(0).optional(),
+    format: zod_1.z.enum(['json', 'dot', 'mermaid']).optional(),
+    enrich: zod_1.z.boolean().optional(),
+    includeCategoryNodes: zod_1.z.boolean().optional(),
+    includeUsage: zod_1.z.boolean().optional()
+}).strict();
+// ── Prompt review ────────────────────────────────────────────────────────────
+const zPromptReview = zod_1.z.object({
+    prompt: zod_1.z.string().min(1)
+}).strict();
+// ── Promote from repo ────────────────────────────────────────────────────────
+const zPromoteFromRepo = zod_1.z.object({
+    repoPath: zod_1.z.string().min(1),
+    scope: zod_1.z.enum(['all', 'governance', 'specs', 'docs', 'instructions']).default('all').optional(),
+    force: zod_1.z.boolean().default(false).optional(),
+    dryRun: zod_1.z.boolean().default(false).optional(),
+    repoId: zod_1.z.string().optional()
+}).strict();
+// ── Bootstrap ────────────────────────────────────────────────────────────────
+const zBootstrapRequest = zod_1.z.object({
+    rationale: zod_1.z.string().optional()
+}).strict();
+const zBootstrapConfirm = zod_1.z.object({
+    token: zod_1.z.string().min(1)
+}).strict();
+const zBootstrap = zod_1.z.object({
+    action: zod_1.z.enum(['request', 'confirm', 'status']),
+    rationale: zod_1.z.string().optional(),
+    token: zod_1.z.string().optional()
+}).passthrough();
+// ── Integrity ────────────────────────────────────────────────────────────────
+const zGatesEvaluate = zEmpty;
+const zIntegrityVerify = zEmpty;
+const zIntegrityManifest = zEmpty;
+// ── Meta / Activation ────────────────────────────────────────────────────────
+const zMetaCheckActivation = zod_1.z.object({
+    toolName: zod_1.z.string().optional()
+}).strict();
+// ── Diagnostics stress tools ─────────────────────────────────────────────────
+const zDiagnosticsBlock = zod_1.z.object({
+    ms: zod_1.z.number().min(0).max(10000)
+}).strict();
+const zDiagnosticsMicrotaskFlood = zod_1.z.object({
+    count: zod_1.z.number().min(0).max(200000).optional()
+}).strict();
+const zDiagnosticsMemoryPressure = zod_1.z.object({
+    mb: zod_1.z.number().min(1).max(512).optional()
+}).strict();
+// ── Manifest ─────────────────────────────────────────────────────────────────
+const zManifestStatus = zEmpty;
+const zManifestRefresh = zEmpty;
+const zManifestRepair = zEmpty;
+// ═══════════════════════════════════════════════════════════════════════════════
+// Complete tool -> Zod schema mapping for all registered tools
+// ═══════════════════════════════════════════════════════════════════════════════
+const zodMap = {
+    // Core tools
+    'health_check': zEmpty,
+    'index_dispatch': zDispatch,
+    'index_search': zSearch,
+    'prompt_review': zPromptReview,
+    'help_overview': zEmpty,
+    'feedback_dispatch': zFeedbackDispatch,
+    'bootstrap': zBootstrap,
+    // Extended tools
+    'graph_export': zGraphExport,
+    'usage_track': zUsageTrack,
+    'usage_hotset': zHotset,
+    'index_add': zAdd,
+    'index_import': zImport,
+    'index_remove': zRemove,
+    'index_reload': zEmpty,
+    'index_governanceHash': zEmpty,
+    'index_governanceUpdate': zGovernanceUpdate,
+    'gates_evaluate': zGatesEvaluate,
+    'integrity_verify': zIntegrityVerify,
+    'metrics_snapshot': zEmpty,
+    'promote_from_repo': zPromoteFromRepo,
+    'index_schema': zEmpty,
+    // Admin tools
+    'feedback_submit': zFeedbackSubmit,
+    'feedback_list': zFeedbackList,
+    'feedback_get': zFeedbackGet,
+    'feedback_update': zFeedbackUpdate,
+    'feedback_stats': zFeedbackStats,
+    'feedback_health': zEmpty,
+    'meta_tools': zEmpty,
+    'meta_activation_guide': zEmpty,
+    'meta_check_activation': zMetaCheckActivation,
+    'feature_status': zEmpty,
+    'index_health': zEmpty,
+    'index_diagnostics': zDiagnostics,
+    'index_repair': zEmpty,
+    'index_groom': zGroom,
+    'index_enrich': zEmpty,
+    'index_normalize': zNormalize,
+    'usage_flush': zUsageFlush,
+    'manifest_status': zManifestStatus,
+    'manifest_refresh': zManifestRefresh,
+    'manifest_repair': zManifestRepair,
+    'bootstrap_request': zBootstrapRequest,
+    'bootstrap_confirmFinalize': zBootstrapConfirm,
+    'bootstrap_status': zEmpty,
+    'index_inspect': zInspect,
+    'index_debug': zEmpty,
+    'integrity_manifest': zIntegrityManifest,
+    'diagnostics_block': zDiagnosticsBlock,
+    'diagnostics_microtaskFlood': zDiagnosticsMicrotaskFlood,
+    'diagnostics_memoryPressure': zDiagnosticsMemoryPressure,
+};
+function getZodEnhancedRegistry() {
+    const base = (0, toolRegistry_1.getToolRegistry)({ tier: 'admin' });
+    for (const e of base) {
+        const zSchema = zodMap[e.name];
+        if (zSchema) {
+            e.zodSchema = zSchema;
+        }
+    }
+    return base;
+}
+/** Get the Zod schema for a specific tool by name */
+function getZodSchema(toolName) {
+    return zodMap[toolName];
+}
+/** Check if a tool has a Zod schema registered */
+function hasZodSchema(toolName) {
+    return toolName in zodMap;
+}

package/dist/services/tracing.d.ts

@@ -0,0 +1,26 @@
+export type TraceLevel = 0 | 1 | 2 | 3 | 4;
+export interface TraceRecord {
+    ts: string;
+    t: number;
+    lvl: TraceLevel;
+    label: string;
+    data?: unknown;
+    func?: string;
+    pid: number;
+    session: string;
+}
+export declare function currentTraceLevel(): TraceLevel;
+export declare function traceEnabled(min?: TraceLevel): boolean;
+export declare function getTraceBuffer(): TraceRecord[];
+export declare function dumpTraceBufferNow(target?: string): void;
+export declare function emitTrace(label: string, data: unknown, min?: TraceLevel): void;
+export declare function getTraceFile(): string | null;
+export interface TraceEnvSummary {
+    level: TraceLevel;
+    file?: string | null;
+    session: string;
+    categories?: string[];
+    maxFileSize?: number;
+    rotationIndex: number;
+}
+export declare function summarizeTraceEnv(): TraceEnvSummary;

package/dist/services/tracing.js

@@ -0,0 +1,260 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currentTraceLevel = currentTraceLevel;
+exports.traceEnabled = traceEnabled;
+exports.getTraceBuffer = getTraceBuffer;
+exports.dumpTraceBufferNow = dumpTraceBufferNow;
+exports.emitTrace = emitTrace;
+exports.getTraceFile = getTraceFile;
+exports.summarizeTraceEnv = summarizeTraceEnv;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const runtimeConfig_1 = require("../config/runtimeConfig");
+let cachedLevel = 0;
+let lastLevelCheck = 0;
+let traceStream = null;
+let traceFilePath = null;
+let traceBytesWritten = 0;
+let rotationIndex = 0;
+let cachedSessionId = null;
+let maxFileSize = 0;
+const traceBuffer = [];
+let bufferExitHookRegistered = false;
+function computeTraceLevel() {
+    const cfg = (0, runtimeConfig_1.getRuntimeConfig)();
+    const tracing = cfg.tracing;
+    const traceTokens = cfg.trace;
+    let level;
+    switch (tracing.level) {
+        case 'verbose':
+            level = 4;
+            break;
+        case 'trace':
+            level = 3;
+            break;
+        case 'debug':
+            level = 2;
+            break;
+        case 'info':
+        case 'warn':
+        case 'error':
+            level = 1;
+            break;
+        default:
+            level = 0;
+    }
+    if (traceTokens.has('traceAll'))
+        level = 4;
+    if (cfg.index.fileTrace)
+        level = Math.max(level, 3);
+    if (traceTokens.has('visibilityDiag'))
+        level = Math.max(level, 1);
+    if (level === 0 && (tracing.persist || tracing.file))
+        level = 1;
+    return level;
+}
+function currentTraceLevel() {
+    const now = Date.now();
+    if (now - lastLevelCheck > 1500) {
+        cachedLevel = computeTraceLevel();
+        lastLevelCheck = now;
+    }
+    return cachedLevel;
+}
+function traceEnabled(min = 1) {
+    return currentTraceLevel() >= min;
+}
+function resolveSessionId() {
+    if (cachedSessionId)
+        return cachedSessionId;
+    const tracing = (0, runtimeConfig_1.getRuntimeConfig)().tracing;
+    const provided = tracing.sessionId && tracing.sessionId.trim().length ? tracing.sessionId.trim() : undefined;
+    cachedSessionId = provided || Math.random().toString(36).slice(2, 10);
+    return cachedSessionId;
+}
+function categoriesAllow(label, categories) {
+    if (!categories.size)
+        return true;
+    const tokens = label
+        .replace(/^\[/, '')
+        .replace(/]$/, '')
+        .split(':')
+        .map(s => s.replace(/^trace/, '').trim())
+        .filter(Boolean);
+    for (const token of tokens) {
+        if (categories.has(token))
+            return true;
+    }
+    return false;
+}
+function ensureTraceStream(tracingCfg) {
+    if (traceStream)
+        return;
+    let file = tracingCfg.file;
+    if (!file && tracingCfg.persist) {
+        const dir = tracingCfg.dir || path_1.default.join(process.cwd(), 'logs', 'trace');
+        try {
+            if (!fs_1.default.existsSync(dir))
+                fs_1.default.mkdirSync(dir, { recursive: true });
+        }
+        catch { /* ignore */ }
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+        file = path_1.default.join(dir, `trace-${stamp}.jsonl`);
+    }
+    if (!file)
+        return;
+    try {
+        traceStream = fs_1.default.createWriteStream(file, { flags: 'a' });
+        traceFilePath = file;
+        traceBytesWritten = 0;
+        rotationIndex = 0;
+        maxFileSize = tracingCfg.maxFileSizeBytes || 0;
+    }
+    catch {
+        traceStream = null;
+        traceFilePath = null;
+        traceBytesWritten = 0;
+        rotationIndex = 0;
+        maxFileSize = 0;
+    }
+}
+function rotateIfNeeded() {
+    if (!traceStream || !traceFilePath)
+        return;
+    if (!maxFileSize || traceBytesWritten < maxFileSize)
+        return;
+    try {
+        traceStream.end();
+    }
+    catch { /* ignore */ }
+    rotationIndex += 1;
+    const base = traceFilePath.replace(/\.jsonl$/, '');
+    const rotated = `${base}.${rotationIndex}.jsonl`;
+    try {
+        traceStream = fs_1.default.createWriteStream(rotated, { flags: 'a' });
+        traceFilePath = rotated;
+        traceBytesWritten = 0;
+    }
+    catch {
+        traceStream = null;
+        traceFilePath = null;
+        traceBytesWritten = 0;
+    }
+}
+function resolveCaller(callsiteEnabled) {
+    if (!callsiteEnabled && currentTraceLevel() < 4)
+        return undefined;
+    const err = new Error();
+    if (!err.stack)
+        return undefined;
+    const frames = err.stack.split('\n').slice(3);
+    for (const frame of frames) {
+        const match = frame.match(/at\s+([^\s(]+)/);
+        if (match && match[1] && match[1] !== 'Object.emitTrace')
+            return match[1];
+    }
+    return undefined;
+}
+function defaultBufferFile() {
+    return path_1.default.join(process.cwd(), 'logs', 'trace', 'trace-buffer.json');
+}
+function ensureBufferExitHook(bufferCfg) {
+    if (bufferExitHookRegistered)
+        return;
+    if (bufferCfg.sizeBytes && (bufferCfg.dumpOnExit || bufferCfg.file)) {
+        bufferExitHookRegistered = true;
+        try {
+            process.on('exit', () => dumpTraceBuffer());
+        }
+        catch { /* ignore */ }
+    }
+}
+function pushBuffer(rec, bufferCfg) {
+    ensureBufferExitHook(bufferCfg);
+    const size = bufferCfg.sizeBytes;
+    if (!size)
+        return;
+    traceBuffer.push(rec);
+    if (traceBuffer.length > size)
+        traceBuffer.splice(0, traceBuffer.length - size);
+}
+function dumpTraceBuffer(file) {
+    const bufferCfg = (0, runtimeConfig_1.getRuntimeConfig)().tracing.buffer;
+    if (!bufferCfg.sizeBytes || !traceBuffer.length)
+        return;
+    const target = file || bufferCfg.file || defaultBufferFile();
+    try {
+        const dir = path_1.default.dirname(target);
+        if (!fs_1.default.existsSync(dir))
+            fs_1.default.mkdirSync(dir, { recursive: true });
+        fs_1.default.writeFileSync(target, JSON.stringify({ size: traceBuffer.length, records: traceBuffer }, null, 2));
+    }
+    catch { /* ignore */ }
+}
+function getTraceBuffer() { return traceBuffer.slice(); }
+function dumpTraceBufferNow(target) { dumpTraceBuffer(target); }
+function emitTrace(label, data, min = 1) {
+    const cfg = (0, runtimeConfig_1.getRuntimeConfig)();
+    const tracing = cfg.tracing;
+    if (!traceEnabled(min))
+        return;
+    if (!categoriesAllow(label, tracing.categories))
+        return;
+    const now = Date.now();
+    const rec = {
+        ts: new Date(now).toISOString(),
+        t: now,
+        lvl: currentTraceLevel(),
+        label,
+        data,
+        pid: process.pid,
+        session: resolveSessionId(),
+    };
+    const caller = resolveCaller(tracing.callsite);
+    if (caller)
+        rec.func = caller;
+    pushBuffer(rec, tracing.buffer);
+    try {
+        // eslint-disable-next-line no-console
+        console.error(label, JSON.stringify(rec));
+    }
+    catch { /* ignore */ }
+    if (!(tracing.persist || tracing.file))
+        return;
+    ensureTraceStream(tracing);
+    const stream = traceStream;
+    if (!stream)
+        return;
+    const line = `${label} ${JSON.stringify(rec)}\n`;
+    try {
+        stream.write(line);
+        traceBytesWritten += Buffer.byteLength(line);
+        rotateIfNeeded();
+        if (tracing.fsync) {
+            const fd = stream.fd;
+            if (typeof fd === 'number' && fd >= 0) {
+                try {
+                    fs_1.default.fsyncSync(fd);
+                }
+                catch { /* ignore */ }
+            }
+        }
+    }
+    catch { /* ignore */ }
+}
+function getTraceFile() { return traceFilePath; }
+function summarizeTraceEnv() {
+    const tracing = (0, runtimeConfig_1.getRuntimeConfig)().tracing;
+    const categories = tracing.categories.size ? Array.from(tracing.categories.values()) : undefined;
+    return {
+        level: currentTraceLevel(),
+        file: traceFilePath,
+        session: resolveSessionId(),
+        categories,
+        maxFileSize,
+        rotationIndex,
+    };
+}