@ytinnovation/harness-core 0.0.0

package/dist/spec/command.js

@@ -0,0 +1,201 @@
+import { resolve } from 'node:path';
+import { HarnessError } from '../contracts/errors.js';
+import { loadHarnessConfig } from '../contracts/config.loader.js';
+import { syncSpecTool } from '../mcp/tools/sync-spec.js';
+import { listRemoteTopAssets } from '../assets/remote-list.js';
+import { createEnterpriseAssetClient } from '../cloud/enterprise-asset-client.js';
+import { installPublishedAssetByName, parseInstallTargets } from '../assets/install.js';
+import { renderErrorBlock, renderJson, renderRemoteAssetList, renderSuccessBlock, renderWarningBlock } from '../cli-output/renderers.js';
+function renderSpecHelp(programName = 'harness') {
+    return [
+        '管理 Harness Spec 来源。',
+        '',
+        '用法：',
+        `  ${programName} spec sync [--cwd <path>] [--mount <path>]`,
+        `  ${programName} spec list --remote [--json]`,
+        '',
+        '选项：',
+        '  --cwd <path>    工作区根目录，默认当前目录。',
+        '  --mount <path>  可选 Spec 挂载路径覆盖值。',
+        '  --remote        查看 harness-service 中的热门 Spec 资产。',
+        '  --json          输出机器可读 JSON。',
+        '  -h, --help      查看帮助。',
+        '',
+        'MCP 对齐：',
+        '  harness spec sync 使用与 sync_spec MCP Tool 一致的挂载路径校验逻辑。',
+    ].join('\n');
+}
+function parseSpecSyncArgs(args) {
+    let cwd = process.cwd();
+    let mountPath;
+    let json = false;
+    let help = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+            continue;
+        }
+        if (arg === '--json') {
+            json = true;
+            continue;
+        }
+        if (arg === '--cwd') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('SPEC_INVALID_ARGS', 'Missing value for --cwd.');
+            }
+            cwd = resolve(value);
+            index += 1;
+            continue;
+        }
+        if (arg === '--mount') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('SPEC_INVALID_ARGS', 'Missing value for --mount.');
+            }
+            mountPath = value;
+            index += 1;
+            continue;
+        }
+        throw new HarnessError('SPEC_INVALID_ARGS', `Unknown spec sync option: ${arg}`);
+    }
+    return { cwd, mountPath, json, help };
+}
+export async function runSpecCommand(args, context = {}) {
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(renderSpecHelp());
+        return 0;
+    }
+    const subcommand = args[0];
+    if (subcommand === 'install') {
+        const json = args.includes('--json');
+        let cwd = process.cwd();
+        const rawArgs = args.slice(1).filter((arg) => arg !== '--json');
+        const parsedArgs = [];
+        for (let index = 0; index < rawArgs.length; index += 1) {
+            const arg = rawArgs[index];
+            if (!arg) {
+                continue;
+            }
+            if (arg === '--cwd') {
+                const value = rawArgs[index + 1];
+                if (!value || value.startsWith('--')) {
+                    throw new HarnessError('SPEC_INVALID_ARGS', 'Missing value for --cwd.');
+                }
+                cwd = resolve(value);
+                index += 1;
+                continue;
+            }
+            parsedArgs.push(arg);
+        }
+        const { targets, rest } = parseInstallTargets(parsedArgs);
+        const name = rest[0]?.trim();
+        if (!name || rest.length !== 1) {
+            console.error(renderErrorBlock({
+                title: 'Spec 安装参数无效',
+                message: '用法：harness spec install <name> [--cwd <path>] [--agents] [--target cursor,agents]',
+                code: 'SPEC_INVALID_ARGS',
+            }));
+            return 1;
+        }
+        const client = createEnterpriseAssetClient({ baseUrl: context.baseUrl, fetchImpl: context.fetchImpl });
+        if (!client) {
+            console.error(renderErrorBlock({
+                title: 'Spec 安装失败',
+                message: 'HARNESS_SERVICE_URL is not configured.',
+                code: 'HARNESS_SERVICE_UNAVAILABLE',
+            }));
+            return 1;
+        }
+        try {
+            const result = await installPublishedAssetByName({
+                assetType: 'spec',
+                name,
+                workspaceRoot: cwd,
+                targets,
+                client,
+            });
+            console.log(json ? renderJson(result) : renderSuccessBlock('Spec 安装完成', [
+                ['名称', result.name],
+                ['版本', result.version],
+                ['安装路径', result.targetPaths.join(', ')],
+            ]));
+            return 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(renderErrorBlock({ title: 'Spec 安装失败', message }));
+            return 1;
+        }
+    }
+    if (subcommand === 'list') {
+        const json = args.includes('--json');
+        const listArgs = args.slice(1).filter((arg) => arg !== '--json');
+        const hasRemote = listArgs.includes('--remote');
+        if (!hasRemote || listArgs.some((arg) => arg !== '--remote')) {
+            console.error(renderErrorBlock({
+                title: 'Spec 列表参数无效',
+                message: 'spec list 仅支持 --remote 和 --json。',
+                code: 'SPEC_INVALID_ARGS',
+            }));
+            return 1;
+        }
+        try {
+            const assets = await listRemoteTopAssets({ type: 'spec' });
+            console.log(json ? renderJson({ assets }) : renderRemoteAssetList('远程热门 Specs', assets));
+            return 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(renderErrorBlock({ title: '远程 Spec 列表读取失败', message }));
+            return 1;
+        }
+    }
+    if (subcommand !== 'sync') {
+        throw new HarnessError('SPEC_INVALID_ARGS', `Unknown spec subcommand: ${subcommand}`);
+    }
+    const options = parseSpecSyncArgs(args.slice(1));
+    if (options.help) {
+        console.log(renderSpecHelp());
+        return 0;
+    }
+    const harnessConfig = context.harnessConfig ?? await loadHarnessConfig(options.cwd);
+    const result = await syncSpecTool({ mountPath: options.mountPath }, { workspaceRoot: options.cwd, harnessConfig });
+    if (result.status === 'success' && result.data) {
+        const payload = {
+            status: result.status,
+            message: result.message,
+            syncTool: 'sync_spec',
+            configuredMountPath: result.data.configuredMountPath,
+            resolvedPath: result.data.resolvedPath,
+            sourceType: result.data.sourceType,
+        };
+        console.log(options.json ? renderJson(payload) : renderSuccessBlock('Spec 同步检查通过', [
+            ['消息', result.message],
+            ['工具', 'sync_spec'],
+            ['配置挂载路径', result.data.configuredMountPath],
+            ['解析路径', result.data.resolvedPath],
+            ['来源类型', result.data.sourceType],
+        ]));
+        return 0;
+    }
+    const payload = {
+        status: result.status,
+        message: result.message,
+        syncTool: 'sync_spec',
+        errorCode: result.errorCode,
+    };
+    console.log(options.json ? renderJson(payload) : renderWarningBlock('Spec 同步检查未完成', [
+        ['状态', result.status],
+        ['消息', result.message],
+        ['工具', 'sync_spec'],
+        ['错误码', result.errorCode],
+    ]));
+    return result.status === 'error' ? 1 : 0;
+}
+export function registerSpecCommand(router) {
+    router.register('spec', runSpecCommand);
+}
+export { renderSpecHelp };
+//# sourceMappingURL=command.js.map

package/dist/spec/command.js.map

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

package/dist/telemetry/reporter.d.ts

@@ -0,0 +1,14 @@
+import type { TelemetryEvent } from './types.js';
+export interface TelemetryEventSink {
+    send(event: TelemetryEvent): Promise<void> | void;
+}
+export interface AsyncTelemetryReporter {
+    report(event: TelemetryEvent): void;
+    flush(): Promise<void>;
+}
+export interface CreateAsyncTelemetryReporterOptions {
+    sink: TelemetryEventSink;
+    onError?: (error: unknown, event: TelemetryEvent) => void;
+}
+export declare function createAsyncTelemetryReporter(options: CreateAsyncTelemetryReporterOptions): AsyncTelemetryReporter;
+//# sourceMappingURL=reporter.d.ts.map

package/dist/telemetry/reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.d.ts","sourceRoot":"","sources":["../../src/telemetry/reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3D;AAMD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mCAAmC,GAC3C,sBAAsB,CA6BxB"}

package/dist/telemetry/reporter.js

@@ -0,0 +1,31 @@
+function cloneTelemetryEvent(event) {
+    return JSON.parse(JSON.stringify(event));
+}
+export function createAsyncTelemetryReporter(options) {
+    const onError = options.onError ?? (() => { });
+    const pending = new Set();
+    return {
+        report(event) {
+            let serializedEvent;
+            try {
+                serializedEvent = cloneTelemetryEvent(event);
+            }
+            catch (error) {
+                onError(error, event);
+                return;
+            }
+            const task = Promise.resolve(options.sink.send(serializedEvent))
+                .catch((error) => {
+                onError(error, serializedEvent);
+            })
+                .finally(() => {
+                pending.delete(task);
+            });
+            pending.add(task);
+        },
+        async flush() {
+            await Promise.all(Array.from(pending));
+        },
+    };
+}
+//# sourceMappingURL=reporter.js.map

package/dist/telemetry/reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.js","sourceRoot":"","sources":["../../src/telemetry/reporter.ts"],"names":[],"mappings":"AAgBA,SAAS,mBAAmB,CAAC,KAAqB;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAmB,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAA4C;IAE5C,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAiB,CAAC;IAEzC,OAAO;QACL,MAAM,CAAC,KAAqB;YAC1B,IAAI,eAA+B,CAAC;YAEpC,IAAI,CAAC;gBACH,eAAe,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;iBAC7D,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,OAAO,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;YAClC,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE;gBACZ,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;YAEL,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACzC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/telemetry/sink.d.ts

@@ -0,0 +1,7 @@
+import type { TelemetryEventSink } from './reporter.js';
+export interface LocalTelemetryFileSinkOptions {
+    filePath?: string;
+    maxEvents?: number;
+}
+export declare function createLocalTelemetryFileSink(options?: LocalTelemetryFileSinkOptions): TelemetryEventSink;
+//# sourceMappingURL=sink.d.ts.map

package/dist/telemetry/sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/telemetry/sink.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAuXD,wBAAgB,4BAA4B,CAAC,OAAO,GAAE,6BAAkC,GAAG,kBAAkB,CAoC5G"}

package/dist/telemetry/sink.js

@@ -0,0 +1,309 @@
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+const DEFAULT_TELEMETRY_PATH = join(homedir(), '.harness', 'telemetry.json');
+const DEFAULT_MAX_EVENTS = 1000;
+function parseSnapshot(raw) {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        return null;
+    }
+    const candidate = parsed;
+    if (!Array.isArray(candidate.events)) {
+        return null;
+    }
+    return parsed;
+}
+function toFinitePositiveInt(value, fallback) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+        return fallback;
+    }
+    return Math.floor(value);
+}
+function withDefaultDimensions(event) {
+    return {
+        ...event,
+        projectId: event.projectId?.trim() || 'unknown-project',
+        projectName: event.projectName?.trim() || 'Unknown Project',
+        individualId: event.individualId?.trim() || event.actorId?.trim() || 'unknown-individual',
+        individualLabel: event.individualLabel?.trim() ||
+            event.actorId?.trim() ||
+            event.individualId?.trim() ||
+            'Unknown Individual',
+    };
+}
+function toRecentDateBoundary(isoTimestamp) {
+    const milliseconds = Date.parse(isoTimestamp);
+    if (!Number.isFinite(milliseconds)) {
+        return Number.NEGATIVE_INFINITY;
+    }
+    return milliseconds;
+}
+function toFinishedStatus(status) {
+    return status === 'succeeded' || status === 'failed';
+}
+function calculateRate(success, total) {
+    if (total <= 0) {
+        return null;
+    }
+    return (success / total) * 100;
+}
+function calculatePercentile(values, percentile) {
+    if (values.length === 0) {
+        return null;
+    }
+    const sorted = [...values].sort((left, right) => left - right);
+    const index = Math.max(0, Math.ceil(percentile * sorted.length) - 1);
+    return sorted[index] ?? null;
+}
+function buildSnapshot(events, generatedAt) {
+    const personStats = new Map();
+    const toolStats = new Map();
+    const assetStats = new Map();
+    let assetServiceTotal = 0;
+    let assetServiceSuccess = 0;
+    let templateMatchTotal = 0;
+    let templateMatchSuccess = 0;
+    let dynamicAssemblyTotal = 0;
+    let dynamicAssemblySuccess = 0;
+    let initTotal = 0;
+    let initSuccess = 0;
+    const criticalPathLatencies = [];
+    const lastDayBoundary = Date.parse(generatedAt) - 24 * 60 * 60 * 1000;
+    for (const event of events) {
+        const personId = event.individualId?.trim() || event.actorId?.trim() || 'unknown-individual';
+        const personLabel = event.individualLabel?.trim() ||
+            event.actorId?.trim() ||
+            event.individualId?.trim() ||
+            'Unknown Individual';
+        const person = personStats.get(personId) ?? {
+            label: personLabel,
+            requestFrequency: 0,
+            errorCount: 0,
+        };
+        person.requestFrequency += 1;
+        if ((event.kind === 'command_invocation' ||
+            event.kind === 'skill_usage' ||
+            event.kind === 'mcp_tool_usage') &&
+            event.status === 'failed') {
+            person.errorCount += 1;
+        }
+        if (event.kind === 'gateway_auth_failure') {
+            person.errorCount += 1;
+        }
+        personStats.set(personId, person);
+        const eventTime = toRecentDateBoundary(event.occurredAt);
+        if (event.kind === 'command_invocation') {
+            const toolId = `command:${event.commandName}`;
+            const tool = toolStats.get(toolId) ?? {
+                label: event.commandName,
+                totalCount: 0,
+                dailyCount: 0,
+            };
+            tool.totalCount += 1;
+            if (eventTime >= lastDayBoundary) {
+                tool.dailyCount += 1;
+            }
+            toolStats.set(toolId, tool);
+            const normalizedCommand = event.commandName.toLowerCase();
+            const isInitCommand = normalizedCommand === 'harness init' || normalizedCommand.startsWith('harness init ');
+            if (isInitCommand && toFinishedStatus(event.status)) {
+                initTotal += 1;
+                if (event.status === 'succeeded') {
+                    initSuccess += 1;
+                }
+            }
+            if (normalizedCommand.includes('--mode template-match') && toFinishedStatus(event.status)) {
+                templateMatchTotal += 1;
+                if (event.status === 'succeeded') {
+                    templateMatchSuccess += 1;
+                }
+            }
+            if (normalizedCommand.includes('--mode cloud-auto') && toFinishedStatus(event.status)) {
+                dynamicAssemblyTotal += 1;
+                if (event.status === 'succeeded') {
+                    dynamicAssemblySuccess += 1;
+                }
+            }
+            if (typeof event.durationMs === 'number' && Number.isFinite(event.durationMs) && event.durationMs > 0) {
+                criticalPathLatencies.push(event.durationMs);
+            }
+            continue;
+        }
+        if (event.kind === 'mcp_tool_usage') {
+            const toolId = `mcp:${event.toolName}`;
+            const tool = toolStats.get(toolId) ?? {
+                label: event.toolName,
+                totalCount: 0,
+                dailyCount: 0,
+            };
+            tool.totalCount += 1;
+            if (eventTime >= lastDayBoundary) {
+                tool.dailyCount += 1;
+            }
+            toolStats.set(toolId, tool);
+            if (event.toolName === 'add_skill' || event.toolName === 'update_rule') {
+                assetServiceTotal += 1;
+                if (event.status === 'succeeded') {
+                    assetServiceSuccess += 1;
+                }
+            }
+            if (typeof event.latencyMs === 'number' && Number.isFinite(event.latencyMs) && event.latencyMs > 0) {
+                criticalPathLatencies.push(event.latencyMs);
+            }
+            continue;
+        }
+        if (event.kind === 'skill_usage') {
+            const assetId = `skill:${event.skillName}`;
+            const asset = assetStats.get(assetId) ?? {
+                label: event.skillName,
+                usageFrequency: 0,
+                successCount: 0,
+            };
+            asset.usageFrequency += 1;
+            if (event.status === 'succeeded') {
+                asset.successCount += 1;
+            }
+            assetStats.set(assetId, asset);
+            if (toFinishedStatus(event.status)) {
+                assetServiceTotal += 1;
+                if (event.status === 'succeeded') {
+                    assetServiceSuccess += 1;
+                }
+            }
+            if (typeof event.durationMs === 'number' && Number.isFinite(event.durationMs) && event.durationMs > 0) {
+                criticalPathLatencies.push(event.durationMs);
+            }
+            continue;
+        }
+    }
+    const peopleMetrics = Array.from(personStats.entries()).map(([id, value]) => ({
+        id,
+        label: value.label,
+        tokenConsumption: null,
+        requestFrequency: value.requestFrequency,
+        errorRate: value.requestFrequency === 0 ? 0 : (value.errorCount / value.requestFrequency) * 100,
+    }));
+    const toolMetrics = Array.from(toolStats.entries()).map(([id, value]) => ({
+        id,
+        label: value.label,
+        dailyActivity: value.dailyCount,
+        commandInvocations: value.totalCount,
+    }));
+    const assetMetrics = Array.from(assetStats.entries()).map(([id, value]) => ({
+        id,
+        label: value.label,
+        usageFrequency: value.usageFrequency,
+        executionSuccessRate: value.usageFrequency === 0 ? 0 : (value.successCount / value.usageFrequency) * 100,
+    }));
+    const overviewMetrics = [
+        {
+            key: 'people',
+            label: 'People',
+            value: peopleMetrics.length,
+            description: 'Contributors and request traffic insights.',
+        },
+        {
+            key: 'tools',
+            label: 'Tools',
+            value: toolMetrics.reduce((total, metric) => total + metric.commandInvocations, 0),
+            description: 'CLI and MCP command activity totals.',
+        },
+        {
+            key: 'assets',
+            label: 'Assets',
+            value: assetMetrics.reduce((total, metric) => total + metric.usageFrequency, 0),
+            description: 'Skill and Rule usage and execution outcomes.',
+        },
+    ];
+    const serviceHealthMetrics = [
+        {
+            key: 'asset_service_availability',
+            label: 'Asset service availability',
+            value: calculateRate(assetServiceSuccess, assetServiceTotal),
+            description: 'Availability ratio for Skill and Rule asset operations.',
+        },
+        {
+            key: 'template_match_hit_rate',
+            label: 'Template match hit rate',
+            value: calculateRate(templateMatchSuccess, templateMatchTotal),
+            description: 'Successful template-match init executions over total attempts.',
+        },
+        {
+            key: 'dynamic_assembly_success_rate',
+            label: 'Dynamic assembly success rate',
+            value: calculateRate(dynamicAssemblySuccess, dynamicAssemblyTotal),
+            description: 'Successful cloud-auto dynamic assembly over total attempts.',
+        },
+        {
+            key: 'init_e2e_success_rate',
+            label: 'Init end-to-end success rate',
+            value: calculateRate(initSuccess, initTotal),
+            description: 'Successful harness init runs over completed executions.',
+        },
+        {
+            key: 'critical_path_latency_ms',
+            label: 'Critical path latency',
+            value: calculatePercentile(criticalPathLatencies, 0.95),
+            description: '95th percentile latency across init and MCP critical path events.',
+        },
+    ];
+    return {
+        generatedAt,
+        events,
+        overview: {
+            generatedAt,
+            metrics: overviewMetrics,
+        },
+        serviceHealth: {
+            generatedAt,
+            metrics: serviceHealthMetrics,
+        },
+        people: {
+            generatedAt,
+            metrics: peopleMetrics,
+        },
+        tools: {
+            generatedAt,
+            metrics: toolMetrics,
+        },
+        assets: {
+            generatedAt,
+            metrics: assetMetrics,
+        },
+    };
+}
+export function createLocalTelemetryFileSink(options = {}) {
+    const filePath = options.filePath ?? DEFAULT_TELEMETRY_PATH;
+    const maxEvents = toFinitePositiveInt(options.maxEvents, DEFAULT_MAX_EVENTS);
+    let pendingWrite = Promise.resolve();
+    return {
+        send(event) {
+            pendingWrite = pendingWrite.then(async () => {
+                let existingEvents = [];
+                try {
+                    const existingRaw = await readFile(filePath, 'utf8');
+                    const existingSnapshot = parseSnapshot(existingRaw);
+                    if (existingSnapshot) {
+                        existingEvents = existingSnapshot.events;
+                    }
+                }
+                catch (error) {
+                    const errorCode = typeof error === 'object' && error !== null && 'code' in error ? String(error.code) : '';
+                    if (errorCode !== 'ENOENT') {
+                        throw error;
+                    }
+                }
+                const nextEvent = withDefaultDimensions(event);
+                const merged = [...existingEvents, nextEvent];
+                const bounded = merged.length > maxEvents ? merged.slice(merged.length - maxEvents) : merged;
+                const generatedAt = new Date().toISOString();
+                const snapshot = buildSnapshot(bounded, generatedAt);
+                await mkdir(dirname(filePath), { recursive: true });
+                await writeFile(filePath, `${JSON.stringify(snapshot, null, 2)}\n`, 'utf8');
+            });
+            return pendingWrite;
+        },
+    };
+}
+//# sourceMappingURL=sink.js.map

package/dist/telemetry/sink.js.map

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

package/dist/telemetry/types.d.ts

@@ -0,0 +1,48 @@
+import type { GatewayAuthError } from '../gateway/auth.js';
+import type { SkillSource } from '../skills/types.js';
+export type TelemetryEventKind = 'command_invocation' | 'skill_usage' | 'mcp_tool_usage' | 'gateway_auth_failure';
+export interface TelemetryEventBase {
+    kind: TelemetryEventKind;
+    occurredAt: string;
+    workspaceRoot: string;
+    projectId?: string;
+    projectName?: string;
+    individualId?: string;
+    individualLabel?: string;
+    actorId?: string;
+    requestId?: string;
+}
+export interface CommandInvocationTelemetryEvent extends TelemetryEventBase {
+    kind: 'command_invocation';
+    commandName: string;
+    status: 'started' | 'succeeded' | 'failed';
+    durationMs?: number;
+    errorCode?: string;
+}
+export interface SkillUsageTelemetryEvent extends TelemetryEventBase {
+    kind: 'skill_usage';
+    skillName: string;
+    operation: 'install' | 'remove' | 'search' | 'publish' | 'update';
+    source?: SkillSource | 'url';
+    status: 'started' | 'succeeded' | 'failed';
+    durationMs?: number;
+    errorCode?: string;
+}
+export interface McpToolUsageTelemetryEvent extends TelemetryEventBase {
+    kind: 'mcp_tool_usage';
+    toolName: string;
+    status: 'succeeded' | 'failed';
+    latencyMs?: number;
+    errorCode?: string;
+}
+export interface GatewayAuthFailureTelemetryEvent extends TelemetryEventBase {
+    kind: 'gateway_auth_failure';
+    commandName?: string;
+    toolName?: string;
+    targetModel?: string;
+    failureType: GatewayAuthError['failureType'];
+    errorCode: GatewayAuthError['code'];
+    message: string;
+}
+export type TelemetryEvent = CommandInvocationTelemetryEvent | SkillUsageTelemetryEvent | McpToolUsageTelemetryEvent | GatewayAuthFailureTelemetryEvent;
+//# sourceMappingURL=types.d.ts.map