@vzn/vx-otel 0.0.636 → 0.0.638

package/README.md

@@ -16,7 +16,7 @@ npm install -D @vzn/vx @vzn/vx-otel   # or: pnpm add -D -w · yarn add -D (-W on
 ```
 
 ```ts
-// vx.workspace.ts
+// .vx/workspace.ts
 import { defineWorkspace } from '@vzn/vx/config'
 import { otel } from '@vzn/vx-otel'
 
@@ -131,7 +131,7 @@ otel({
   says how many more);
 - a child span per stage of the run, named by the stage (`startup`,
   `load configs`, `git enumeration`, `classify + probe`, `run graph`,
-  `record history`, …, the stages `VX_TIMING` prints), with
+  `record history`, …, the stages `VX_DEBUG_TIMING` prints), with
   `vx.stage.name`: where the time before the first task and after the
   last went. The stages ahead of the run lock end before the `vx.run`
   span starts.
@@ -192,14 +192,14 @@ same CPU live as with one send at the end (median of 10: 815 ms both).
 No send ever holds a task: a task's end only queues its records. A collector
 that never answers holds nothing either: at the end of the run every send
 still in flight is cut at core's teardown deadline (3 s,
-`VX_TEARDOWN_TIMEOUT_MS`), and the process exits.
+`VX_RUN_TEARDOWN_TIMEOUT`), and the process exits.
 
 ## Behavior note
 
 This replaces core's previous hardcoded OTel emit, which fired automatically
 whenever `OTEL_EXPORTER_OTLP_ENDPOINT` was set. OTel is now a **plugin**: the
 env var alone no longer auto-exports — you must declare `otel()` in
-`vx.workspace.ts`. Telemetry is observe-only and can never change, slow, or
+`.vx/workspace.ts`. Telemetry is observe-only and can never change, slow, or
 fail a run (every export is buffered, time-bounded, and swallows errors).
 
 A collector shedding load (`429`, `502`, `503`, `504`, or a dropped
@@ -219,5 +219,5 @@ userinfo and query string replaced by `***`, so an endpoint that carries
 its credential in the URL does not leak it into a CI log. The run stays
 green either way; a collector that
 takes too long is cut off by core's end-of-run deadline
-(`VX_TEARDOWN_TIMEOUT_MS`, 3 s by default) with a line saying the buffered
+(`VX_RUN_TEARDOWN_TIMEOUT`, 3 s by default) with a line saying the buffered
 records were lost.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vzn/vx-otel",
-  "version": "0.0.636",
+  "version": "0.0.638",
   "license": "MIT",
   "description": "OpenTelemetry exporter for vx — a telemetry plugin mapping runs to OTLP traces + metrics (CI/CD + VCS semantic conventions).",
   "keywords": [
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@vzn/vx": "^0.0.636"
+    "@vzn/vx": "^0.0.638"
   },
   "repository": {
     "type": "git",

package/src/index.ts

@@ -1,6 +1,6 @@
 // Public API for @vzn/vx-otel — the OpenTelemetry exporter plugin for vx.
 //
-// Usage in vx.workspace.ts:
+// Usage in .vx/workspace.ts:
 //   import { defineWorkspace } from '@vzn/vx'
 //   import { otel } from '@vzn/vx-otel'
 //   export default defineWorkspace({ plugins: [otel()] })

package/src/otlp.ts

@@ -249,7 +249,7 @@ export function taskSpanEvents(t: TaskTelemetry, endUnixNano: string): OtlpSpanE
 const MAX_VIOLATION_EVENTS = 100
 
 /**
- * A child span of the run for one of its stages (`VX_TIMING`'s marks):
+ * A child span of the run for one of its stages (`VX_DEBUG_TIMING`'s marks):
  * where the time before the first task and after the last one went. Named
  * by the stage, a fixed set. The stages ahead of the run lock end before
  * the run span starts.

package/src/plugin.ts

@@ -5,7 +5,7 @@
 //
 // This replaces core's old hardcoded `attachOtelEmit` (logs-only, fired
 // unconditionally when OTEL_EXPORTER_OTLP_ENDPOINT was set). OTel is now a
-// plugin — declare it in vx.workspace.ts. The trade: the env var ALONE no
+// plugin — declare it in .vx/workspace.ts. The trade: the env var ALONE no
 // longer auto-exports; you must `defineWorkspace({ plugins: [otel()] })`.
 
 import {
@@ -392,7 +392,7 @@ const OTEL_PLUGIN_KEYS: PluginOptionKinds<OtelPluginOptions> = {
 }
 
 /**
- * The OpenTelemetry exporter plugin. Declared in vx.workspace.ts via
+ * The OpenTelemetry exporter plugin. Declared in .vx/workspace.ts via
  * `defineWorkspace({ plugins: [otel()] })`. Contributes a telemetry sink that
  * maps each run to OTLP traces (a `vx.run` root span + `vx.task` children),
  * metrics, and one log record per executed task, over OTLP/HTTP JSON.