@principal-ai/principal-view-core 0.5.16 → 0.5.17

package/dist/index.d.ts

@@ -18,6 +18,8 @@ export { CanvasConverter } from './utils/CanvasConverter';
 export type { ReactFlowNode, ReactFlowEdge } from './utils/CanvasConverter';
 export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
 export type { ValidationResult } from './telemetry/event-validator';
+export { analyzeCoverage } from './telemetry/coverage';
+export type { CoverageMetrics, NodeCoverage, CanvasNode as CoverageCanvasNode } from './telemetry/coverage';
 export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
 export type { CodegenOptions, CodegenResult, CodeGenerator } from './codegen/type-generator';
 export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAC3G,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EACV,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGrF,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAC3G,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG5G,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EACV,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGrF,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -20,6 +20,8 @@ export * from './types/canvas';
 export { CanvasConverter } from './utils/CanvasConverter';
 // Export telemetry event validation
 export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
+// Export telemetry coverage analysis
+export { analyzeCoverage } from './telemetry/coverage';
 // Export code generation
 export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
 // Export trace-to-canvas conversion

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAMlE,iBAAiB;AACjB,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,oCAAoC;AACpC,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG3G,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGjG,oCAAoC;AACpC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQzE,qDAAqD;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,gCAAgC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,mCAAmC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,sBAAsB;AACtB,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAMlE,iBAAiB;AACjB,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,oCAAoC;AACpC,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG3G,qCAAqC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGjG,oCAAoC;AACpC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQzE,qDAAqD;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,gCAAgC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,mCAAmC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,sBAAsB;AACtB,cAAc,SAAS,CAAC"}

package/dist/telemetry/coverage.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Telemetry Coverage Analysis
+ *
+ * Measures observability coverage by analyzing which canvas nodes have
+ * OpenTelemetry instrumentation in their source files.
+ */
+export interface CanvasNode {
+    id: string;
+    text?: string;
+    anchors?: Array<{
+        path?: string;
+    }>;
+    [key: string]: any;
+}
+export interface Canvas {
+    nodes?: CanvasNode[];
+    [key: string]: any;
+}
+export interface NodeCoverage {
+    nodeId: string;
+    filePaths: string[];
+    hasInstrumentation: boolean;
+    instrumentedFiles: string[];
+    missingFiles: string[];
+}
+export interface CoverageMetrics {
+    totalNodes: number;
+    nodesWithFiles: number;
+    nodesWithInstrumentation: number;
+    coveragePercentage: number;
+    nodeCoverage: NodeCoverage[];
+    canvasFiles: string[];
+}
+/**
+ * Generate telemetry coverage report from canvas files
+ */
+export declare function analyzeCoverage(rootDir: string): Promise<CoverageMetrics>;
+//# sourceMappingURL=coverage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../src/telemetry/coverage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,MAAM,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAmFD;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqC/E"}

package/dist/telemetry/coverage.js

@@ -0,0 +1,113 @@
+/**
+ * Telemetry Coverage Analysis
+ *
+ * Measures observability coverage by analyzing which canvas nodes have
+ * OpenTelemetry instrumentation in their source files.
+ */
+import { readFile, access } from 'fs/promises';
+import { resolve } from 'path';
+import { glob } from 'glob';
+/**
+ * Extract file paths from a canvas node anchors (REQUIRED)
+ */
+function extractFilePaths(node) {
+    const paths = [];
+    if (node.anchors) {
+        for (const anchor of node.anchors) {
+            if (anchor.path) {
+                paths.push(anchor.path);
+            }
+        }
+    }
+    return paths;
+}
+/**
+ * Check if a file has OpenTelemetry instrumentation
+ */
+async function hasInstrumentation(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const hasOtelImport = content.includes('@opentelemetry/api');
+        const hasTracer = /getTracer|startSpan|addEvent/.test(content);
+        const hasTestOtel = /['"]\.\.?\/.*test\/otel-setup['"]/.test(content);
+        return hasOtelImport || hasTracer || hasTestOtel;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if file exists
+ */
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Analyze coverage for a single canvas node
+ */
+async function analyzeNodeCoverage(node, rootDir) {
+    const filePaths = extractFilePaths(node);
+    const instrumentedFiles = [];
+    const missingFiles = [];
+    for (const path of filePaths) {
+        const fullPath = resolve(rootDir, path);
+        const exists = await fileExists(fullPath);
+        if (!exists) {
+            missingFiles.push(path);
+            continue;
+        }
+        const instrumented = await hasInstrumentation(fullPath);
+        if (instrumented) {
+            instrumentedFiles.push(path);
+        }
+    }
+    return {
+        nodeId: node.id,
+        filePaths,
+        hasInstrumentation: instrumentedFiles.length > 0,
+        instrumentedFiles,
+        missingFiles
+    };
+}
+/**
+ * Generate telemetry coverage report from canvas files
+ */
+export async function analyzeCoverage(rootDir) {
+    const canvasFiles = await glob('**/*.otel.canvas', {
+        cwd: rootDir,
+        absolute: true,
+        dot: true,
+        ignore: ['**/node_modules/**']
+    });
+    const allNodeCoverage = [];
+    for (const canvasFile of canvasFiles) {
+        const content = await readFile(canvasFile, 'utf-8');
+        const canvas = JSON.parse(content);
+        if (!canvas.nodes || canvas.nodes.length === 0) {
+            continue;
+        }
+        for (const node of canvas.nodes) {
+            const coverage = await analyzeNodeCoverage(node, rootDir);
+            allNodeCoverage.push(coverage);
+        }
+    }
+    const nodesWithFiles = allNodeCoverage.filter(n => n.filePaths.length > 0);
+    const nodesWithInstrumentation = allNodeCoverage.filter(n => n.hasInstrumentation);
+    return {
+        totalNodes: allNodeCoverage.length,
+        nodesWithFiles: nodesWithFiles.length,
+        nodesWithInstrumentation: nodesWithInstrumentation.length,
+        coveragePercentage: nodesWithFiles.length > 0
+            ? (nodesWithInstrumentation.length / nodesWithFiles.length) * 100
+            : 0,
+        nodeCoverage: allNodeCoverage,
+        canvasFiles: canvasFiles.map(f => f.replace(rootDir + '/', ''))
+    };
+}
+//# sourceMappingURL=coverage.js.map

package/dist/telemetry/coverage.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/principal-view-core",
-  "version": "0.5.16",
+  "version": "0.5.17",
   "description": "Core logic and types for graph-based principal view framework",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/index.ts

@@ -38,6 +38,10 @@ export type { ReactFlowNode, ReactFlowEdge } from './utils/CanvasConverter';
 export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
 export type { ValidationResult } from './telemetry/event-validator';
 
+// Export telemetry coverage analysis
+export { analyzeCoverage } from './telemetry/coverage';
+export type { CoverageMetrics, NodeCoverage, CanvasNode as CoverageCanvasNode } from './telemetry/coverage';
+
 // Export code generation
 export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
 export type { CodegenOptions, CodegenResult, CodeGenerator } from './codegen/type-generator';

package/src/telemetry/coverage.ts

@@ -0,0 +1,162 @@
+/**
+ * Telemetry Coverage Analysis
+ *
+ * Measures observability coverage by analyzing which canvas nodes have
+ * OpenTelemetry instrumentation in their source files.
+ */
+
+import { readFile, access } from 'fs/promises';
+import { resolve } from 'path';
+import { glob } from 'glob';
+
+export interface CanvasNode {
+  id: string;
+  text?: string;
+  anchors?: Array<{ path?: string }>;
+  [key: string]: any;
+}
+
+export interface Canvas {
+  nodes?: CanvasNode[];
+  [key: string]: any;
+}
+
+export interface NodeCoverage {
+  nodeId: string;
+  filePaths: string[];
+  hasInstrumentation: boolean;
+  instrumentedFiles: string[];
+  missingFiles: string[];
+}
+
+export interface CoverageMetrics {
+  totalNodes: number;
+  nodesWithFiles: number;
+  nodesWithInstrumentation: number;
+  coveragePercentage: number;
+  nodeCoverage: NodeCoverage[];
+  canvasFiles: string[];
+}
+
+/**
+ * Extract file paths from a canvas node anchors (REQUIRED)
+ */
+function extractFilePaths(node: CanvasNode): string[] {
+  const paths: string[] = [];
+
+  if (node.anchors) {
+    for (const anchor of node.anchors) {
+      if (anchor.path) {
+        paths.push(anchor.path);
+      }
+    }
+  }
+
+  return paths;
+}
+
+/**
+ * Check if a file has OpenTelemetry instrumentation
+ */
+async function hasInstrumentation(filePath: string): Promise<boolean> {
+  try {
+    const content = await readFile(filePath, 'utf-8');
+
+    const hasOtelImport = content.includes('@opentelemetry/api');
+    const hasTracer = /getTracer|startSpan|addEvent/.test(content);
+    const hasTestOtel = /['"]\.\.?\/.*test\/otel-setup['"]/.test(content);
+
+    return hasOtelImport || hasTracer || hasTestOtel;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Check if file exists
+ */
+async function fileExists(filePath: string): Promise<boolean> {
+  try {
+    await access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Analyze coverage for a single canvas node
+ */
+async function analyzeNodeCoverage(
+  node: CanvasNode,
+  rootDir: string
+): Promise<NodeCoverage> {
+  const filePaths = extractFilePaths(node);
+  const instrumentedFiles: string[] = [];
+  const missingFiles: string[] = [];
+
+  for (const path of filePaths) {
+    const fullPath = resolve(rootDir, path);
+    const exists = await fileExists(fullPath);
+
+    if (!exists) {
+      missingFiles.push(path);
+      continue;
+    }
+
+    const instrumented = await hasInstrumentation(fullPath);
+    if (instrumented) {
+      instrumentedFiles.push(path);
+    }
+  }
+
+  return {
+    nodeId: node.id,
+    filePaths,
+    hasInstrumentation: instrumentedFiles.length > 0,
+    instrumentedFiles,
+    missingFiles
+  };
+}
+
+/**
+ * Generate telemetry coverage report from canvas files
+ */
+export async function analyzeCoverage(rootDir: string): Promise<CoverageMetrics> {
+  const canvasFiles = await glob('**/*.otel.canvas', {
+    cwd: rootDir,
+    absolute: true,
+    dot: true,
+    ignore: ['**/node_modules/**']
+  });
+
+  const allNodeCoverage: NodeCoverage[] = [];
+
+  for (const canvasFile of canvasFiles) {
+    const content = await readFile(canvasFile, 'utf-8');
+    const canvas: Canvas = JSON.parse(content);
+
+    if (!canvas.nodes || canvas.nodes.length === 0) {
+      continue;
+    }
+
+    for (const node of canvas.nodes) {
+      const coverage = await analyzeNodeCoverage(node, rootDir);
+      allNodeCoverage.push(coverage);
+    }
+  }
+
+  const nodesWithFiles = allNodeCoverage.filter(n => n.filePaths.length > 0);
+  const nodesWithInstrumentation = allNodeCoverage.filter(n => n.hasInstrumentation);
+
+  return {
+    totalNodes: allNodeCoverage.length,
+    nodesWithFiles: nodesWithFiles.length,
+    nodesWithInstrumentation: nodesWithInstrumentation.length,
+    coveragePercentage: nodesWithFiles.length > 0
+      ? (nodesWithInstrumentation.length / nodesWithFiles.length) * 100
+      : 0,
+    nodeCoverage: allNodeCoverage,
+    canvasFiles: canvasFiles.map(f => f.replace(rootDir + '/', ''))
+  };
+}

package/src/utils/GraphConverter.test.ts

@@ -9,6 +9,8 @@ import {
   markTestFailed,
   setSpanAttribute,
   exportSpans,
+  log,
+  recordLog,
 } from '../../test/otel-setup';
 
 describe('GraphConverter', () => {
@@ -24,11 +26,25 @@ describe('GraphConverter', () => {
     });
 
     try {
+      // TRACE log at test start (automatically correlated with testSpan)
+      log('TRACE', 'Entering test case for simple config conversion', {
+        'service.name': 'graph-converter-service',
+        'service.version': '1.0.0',
+      });
+
       // Setup - record as event
       addEvent(testSpan, 'setup.started', {
         description: 'Creating test configuration with 2 nodes and 1 edge',
       });
 
+      // INFO log during setup
+      log('INFO', 'Initializing test configuration', {
+        'service.name': 'graph-converter-service',
+      }, {
+        'config.nodeCount': 2,
+        'config.edgeCount': 1,
+      });
+
       const config: PathBasedGraphConfiguration = {
         metadata: {
           name: 'Test Config',
@@ -70,6 +86,15 @@ describe('GraphConverter', () => {
         'config.edges': 1,
       });
 
+      // DEBUG log with structured data after setup
+      log('DEBUG', {
+        phase: 'setup-complete',
+        nodeTypes: Object.keys(config.nodeTypes),
+        edgeTypes: Object.keys(config.edgeTypes),
+      }, {
+        'service.name': 'graph-converter-service',
+      });
+
       // Execution - record as event
       // Note: execution happens in GraphConverter.ts, not the test file
       addEvent(testSpan, 'execution.started', {
@@ -78,8 +103,25 @@ describe('GraphConverter', () => {
         'code.lineno': 15,
       });
 
+      // INFO log before conversion
+      log('INFO', 'Starting graph conversion process', {
+        'service.name': 'graph-converter-service',
+      }, {
+        'operation': 'configToGraph',
+        'inputSize.bytes': JSON.stringify(config).length,
+      });
+
       const result = GraphConverter.configToGraph(config);
 
+      // DEBUG log after conversion with result details
+      log('DEBUG', 'Conversion completed successfully', {
+        'service.name': 'graph-converter-service',
+      }, {
+        'output.nodeCount': result.nodes.length,
+        'output.edgeCount': result.edges.length,
+        'processingTime.ms': 5,
+      });
+
       addEvent(testSpan, 'execution.complete', {
         'result.nodes.count': result.nodes.length,
         'result.edges.count': result.edges.length,
@@ -92,6 +134,13 @@ describe('GraphConverter', () => {
         assertions: 'Verifying nodes and edges structure',
       });
 
+      // INFO log at assertion phase
+      log('INFO', 'Running assertions on converted graph', {
+        'service.name': 'graph-converter-service',
+      }, {
+        'totalAssertions': 11,
+      });
+
       expect(result.nodes).toHaveLength(2);
       expect(result.edges).toHaveLength(1);
 
@@ -116,8 +165,24 @@ describe('GraphConverter', () => {
         'assertions.failed': 0,
       });
 
+      // INFO log on successful test completion
+      log('INFO', 'All assertions passed - test successful', {
+        'service.name': 'graph-converter-service',
+      }, {
+        'test.status': 'passed',
+        'test.duration.ms': Date.now() - testSpan.startTime,
+      });
+
       markTestPassed(testSpan);
     } catch (error) {
+      // ERROR log on failure
+      log('ERROR', `Test failed: ${(error as Error).message}`, {
+        'service.name': 'graph-converter-service',
+      }, {
+        'test.status': 'failed',
+        'error.type': (error as Error).name,
+      });
+
       addEvent(testSpan, 'test.failed', {
         error: (error as Error).message,
       });
@@ -125,6 +190,20 @@ describe('GraphConverter', () => {
       throw error;
     } finally {
       endSpan(testSpan);
+
+      // Uncorrelated log after span ends (simulating cleanup/background task)
+      recordLog({
+        severity: 'DEBUG',
+        body: 'Test cleanup completed',
+        resource: {
+          'service.name': 'test-cleanup-service',
+          'cleanup.type': 'post-test',
+        },
+        attributes: {
+          'test.name': 'should convert simple config to nodes and edges',
+        },
+        // No traceId/spanId - this is an uncorrelated log
+      });
     }
   });