@devflow-tools/telemetry 0.16.34 → 0.17.1

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { TelemetryEngine } from "./telemetry-engine.js";
 export { LogWriter, getLogWriter } from "./log-writer.js";
+export { emitSemanticControlLog } from './semantic-log.js';
 export { aggregateHealthStatus, createHealthSnapshot } from "./health-snapshot.js";
 export type { HealthCheckResult, HealthSnapshot, HealthStatus } from "./health-snapshot.js";
 export type { RunMeta, StepMeta, StepEnd, RunEnd, ToolCallEvent, LlmCallEvent, FreeEvent } from "./log-writer.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnF,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC5F,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { TelemetryEngine } from "./telemetry-engine.js";
 export { LogWriter, getLogWriter } from "./log-writer.js";
+export { emitSemanticControlLog } from './semantic-log.js';
 export { aggregateHealthStatus, createHealthSnapshot } from "./health-snapshot.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/semantic-log.d.ts

@@ -0,0 +1,3 @@
+import type { SemanticControlLogEvent } from '@devflow-tools/sdk';
+export declare function emitSemanticControlLog(event: SemanticControlLogEvent): void;
+//# sourceMappingURL=semantic-log.d.ts.map

package/dist/semantic-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-log.d.ts","sourceRoot":"","sources":["../src/semantic-log.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAMlE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,GAAG,IAAI,CAe3E"}

package/dist/semantic-log.js

@@ -0,0 +1,36 @@
+import { getLogWriter } from './log-writer.js';
+const MAX_STRING_LENGTH = 2_000;
+const MAX_ARRAY_LENGTH = 64;
+export function emitSemanticControlLog(event) {
+    try {
+        getLogWriter(event.identity.projectRoot).event({
+            runId: `semantic:${event.identity.sessionId ?? event.identity.projectRoot}`,
+            level: event.level,
+            message: event.event,
+            data: boundValue({
+                identity: event.identity,
+                timestamp: event.timestamp,
+                ...event.data,
+            }),
+        });
+    }
+    catch {
+        // Observability must never alter business behavior.
+    }
+}
+function boundValue(value, depth = 0) {
+    if (depth > 5)
+        return '[depth-limited]';
+    if (typeof value === 'string')
+        return value.slice(0, MAX_STRING_LENGTH);
+    if (typeof value === 'number' || typeof value === 'boolean' || value === null || value === undefined)
+        return value;
+    if (Array.isArray(value))
+        return value.slice(0, MAX_ARRAY_LENGTH).map(item => boundValue(item, depth + 1));
+    if (typeof value !== 'object')
+        return String(value).slice(0, MAX_STRING_LENGTH);
+    return Object.fromEntries(Object.entries(value)
+        .slice(0, MAX_ARRAY_LENGTH)
+        .map(([key, item]) => [key, boundValue(item, depth + 1)]));
+}
+//# sourceMappingURL=semantic-log.js.map

package/dist/semantic-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-log.js","sourceRoot":"","sources":["../src/semantic-log.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAChC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,MAAM,UAAU,sBAAsB,CAAC,KAA8B;IACnE,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC;YAC7C,KAAK,EAAE,YAAY,KAAK,CAAC,QAAQ,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE;YAC3E,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,KAAK;YACpB,IAAI,EAAE,UAAU,CAAC;gBACf,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,GAAG,KAAK,CAAC,IAAI;aACd,CAA4B;SAC9B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IAC3C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IACxE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACnH,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3G,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC;SACvE,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devflow-tools/telemetry",
-  "version": "0.16.34",
+  "version": "0.17.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -17,8 +17,8 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@devflow-tools/database": "0.16.34",
-    "@devflow-tools/sdk": "0.16.34"
+    "@devflow-tools/database": "0.17.1",
+    "@devflow-tools/sdk": "0.17.1"
   },
   "devDependencies": {
     "typescript": "^5.5.0",