feat(api): document the Observability group (Wave 2)

Ships generated references for @imqueue/async-logger 3.2.0,
@imqueue/opentelemetry-instrumentation-imqueue 3.3.1 and @imqueue/dd-trace
3.1.0 — 142 pages, all three at 100% summary coverage, following the
doc-block passes released in those versions.

The /api/ landing page and llms.txt gain an Observability section from the
package config; no template edit per package. sitemap-api.xml 176 -> 239
URLs, and /api/search-index.json 530 -> 672 entries with zero empty
summaries.

Two smaller changes ride along:

* The exclusive-tag chip dropped its "one of" suffix. `tracing & APM` is the
  first exclusive tag to render — Wave 1's `events & caching` is not one — so
  this markup had never been seen. The rule stays in the hover tooltip and in
  llms.txt, where it reads as a sentence rather than two words crammed into a
  pill.
* The three placeholder blurbs ("OpenTelemetry instrumentation for @imqueue.")
  are replaced with ones that say what each package does. They show on the
  landing page and in llms.txt.

Author: Mikhus

functions/api/async-logger/[[path]].js

@@ -0,0 +1,7 @@
+// GENERATED by scripts/build-api-docs.js — do not edit by hand.
+// Cloudflare Pages Function — /api/async-logger/*
+// Resolves retired @imqueue/async-logger version URLs onto the kept version trees.
+// See lib/api-redirects.js for the policy and why this is not in _redirects.
+import { handleApiRequest } from "../../../lib/api-handler.js";
+
+export const onRequest = handleApiRequest;

functions/api/dd-trace/[[path]].js

@@ -0,0 +1,7 @@
+// GENERATED by scripts/build-api-docs.js — do not edit by hand.
+// Cloudflare Pages Function — /api/dd-trace/*
+// Resolves retired @imqueue/dd-trace version URLs onto the kept version trees.
+// See lib/api-redirects.js for the policy and why this is not in _redirects.
+import { handleApiRequest } from "../../../lib/api-handler.js";
+
+export const onRequest = handleApiRequest;

functions/api/opentelemetry-instrumentation-imqueue/[[path]].js

@@ -0,0 +1,7 @@
+// GENERATED by scripts/build-api-docs.js — do not edit by hand.
+// Cloudflare Pages Function — /api/opentelemetry-instrumentation-imqueue/*
+// Resolves retired @imqueue/opentelemetry-instrumentation-imqueue version URLs onto the kept version trees.
+// See lib/api-redirects.js for the policy and why this is not in _redirects.
+import { handleApiRequest } from "../../../lib/api-handler.js";
+
+export const onRequest = handleApiRequest;

lib/api-versions.js

@@ -8,5 +8,8 @@ export const API_VERSIONS = {
   "rpc": { "latest": "3.5.1", "archives": ["2.1.0","1.17.1"] },
   "pg-pubsub": { "latest": "3.0.4", "archives": [] },
   "pg-cache": { "latest": "5.0.4", "archives": [] },
-  "tag-cache": { "latest": "3.0.3", "archives": [] }
+  "tag-cache": { "latest": "3.0.3", "archives": [] },
+  "async-logger": { "latest": "3.2.0", "archives": [] },
+  "opentelemetry-instrumentation-imqueue": { "latest": "3.3.1", "archives": [] },
+  "dd-trace": { "latest": "3.1.0", "archives": [] }
 };

scripts/lib/api-packages.js

@@ -161,32 +161,35 @@ const PACKAGES = [
     // Untagged on purpose: not part of the CLI's exclusive tracing pair, and a
     // service can run it alongside either tracer.
     tags: [],
-    blurb: 'Configurable async logger over winston for @imqueue services.',
+    blurb: 'Non-blocking logger over winston, with file and HTTP transports '
+      + 'configured from the environment.',
     cliId: null,
     latestOnly: true,
-    status: 'planned',
+    status: 'shipped',
     wave: 2,
   },
   {
     name: 'opentelemetry-instrumentation-imqueue',
     tier: 2,
     group: 'Observability',
     tags: ['tracing & APM'],
-    blurb: 'OpenTelemetry instrumentation for @imqueue.',
+    blurb: 'OpenTelemetry instrumentation for @imqueue/rpc — every RPC traced, '
+      + 'with no changes to service or client code.',
     cliId: 'opentelemetry',
     latestOnly: true,
-    status: 'planned',
+    status: 'shipped',
     wave: 2,
   },
   {
     name: 'dd-trace',
     tier: 2,
     group: 'Observability',
     tags: ['tracing & APM'],
-    blurb: 'Datadog tracing integration for @imqueue.',
+    blurb: 'Datadog APM tracing for @imqueue/rpc — a drop-in dd-trace '
+      + 'replacement that traces every RPC.',
     cliId: 'dd-trace',
     latestOnly: true,
-    status: 'planned',
+    status: 'shipped',
     wave: 2,
   },
 

src/_data/apiVersions.json

@@ -24,5 +24,17 @@
   "tag-cache": {
     "latest": "3.0.3",
     "archives": []
+  },
+  "async-logger": {
+    "latest": "3.2.0",
+    "archives": []
+  },
+  "opentelemetry-instrumentation-imqueue": {
+    "latest": "3.3.1",
+    "archives": []
+  },
+  "dd-trace": {
+    "latest": "3.1.0",
+    "archives": []
   }
 }

src/org/api/async-logger/latest/async-logger._default.md

@@ -0,0 +1,24 @@
+---
+title: "_default variable · @imqueue/async-logger"
+description: "A Logger configured from the environment, constructed at import time."
+apiCrumbs: [{"name":"API reference","url":"/api/"},{"name":"@imqueue/async-logger","url":"/api/async-logger/latest/"},{"name":"_default","url":"/api/async-logger/latest/async-logger._default/"}]
+---
+
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+# \_default variable
+
+A [Logger](/api/async-logger/latest/async-logger.logger/) configured from the environment, constructed at import time.
+
+**Signature:**
+
+```typescript
+_default: Logger
+```
+
+## Remarks
+
+Shared by every module that imports it, which is normally what you want — one set of transports per process. Construct [Logger](/api/async-logger/latest/async-logger.logger/) directly instead when you need different metadata or transports for a particular subsystem.
+
+Because it is built at import time, `LOGGER_TRANSPORTS` and `LOGGER_METADATA` must already be set when this module is first imported; changing them later has no effect on this instance.
+

src/org/api/async-logger/latest/async-logger.anyjson.md

@@ -0,0 +1,23 @@
+---
+title: "AnyJson type · @imqueue/async-logger"
+description: "Any value that survives JSON.stringify unchanged."
+apiCrumbs: [{"name":"API reference","url":"/api/"},{"name":"@imqueue/async-logger","url":"/api/async-logger/latest/"},{"name":"AnyJson","url":"/api/async-logger/latest/async-logger.anyjson/"}]
+---
+
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+# AnyJson type
+
+Any value that survives `JSON.stringify` unchanged.
+
+**Signature:**
+
+```typescript
+export type AnyJson = boolean | number | string | null | undefined | JsonArray | JsonObject;
+```
+**References:** [JsonArray](/api/async-logger/latest/async-logger.jsonarray/)<!-- -->, [JsonObject](/api/async-logger/latest/async-logger.jsonobject/)
+
+## Remarks
+
+A structural copy of the type in `@imqueue/core`<!-- -->, declared here so the logger needs no runtime dependency on the queue library. The shapes match exactly, so values remain assignable in both directions.
+

src/org/api/async-logger/latest/async-logger.asyncloggeroptions.md

@@ -0,0 +1,85 @@
+---
+title: "AsyncLoggerOptions interface · @imqueue/async-logger"
+description: "Explicit configuration for a Logger, replacing what it would otherwise read from the environment."
+apiCrumbs: [{"name":"API reference","url":"/api/"},{"name":"@imqueue/async-logger","url":"/api/async-logger/latest/"},{"name":"AsyncLoggerOptions","url":"/api/async-logger/latest/async-logger.asyncloggeroptions/"}]
+---
+
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+# AsyncLoggerOptions interface
+
+Explicit configuration for a [Logger](/api/async-logger/latest/async-logger.logger/)<!-- -->, replacing what it would otherwise read from the environment.
+
+**Signature:**
+
+```typescript
+export interface AsyncLoggerOptions 
+```
+
+## Remarks
+
+Both fields are read independently: pass only `metadata` and the transports still come from `LOGGER_TRANSPORTS`<!-- -->, and vice versa. Passing an empty `transports` array is not the same as omitting it — an empty array means "console only", while omitting it falls back to the environment.
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[metadata](/api/async-logger/latest/async-logger.asyncloggeroptions.metadata/)
+
+
+</td><td>
+
+
+</td><td>
+
+[JsonObject](/api/async-logger/latest/async-logger.jsonobject/)
+
+
+</td><td>
+
+Fields attached to every record sent to a transport, such as a source or environment tag. Does not affect console output.
+
+
+</td></tr>
+<tr><td>
+
+[transports](/api/async-logger/latest/async-logger.asyncloggeroptions.transports/)
+
+
+</td><td>
+
+
+</td><td>
+
+[TransportOptions](/api/async-logger/latest/async-logger.transportoptions/)<!-- -->\[\]
+
+
+</td><td>
+
+Transports to log through. Each entry is created and attached at construction time; entries with `enabled: false` are skipped.
+
+
+</td></tr>
+</tbody></table>
+

src/org/api/async-logger/latest/async-logger.asyncloggeroptions.metadata.md

@@ -0,0 +1,18 @@
+---
+title: "AsyncLoggerOptions.metadata property · @imqueue/async-logger"
+description: "Fields attached to every record sent to a transport, such as a source or environment tag. Does not affect console output."
+apiCrumbs: [{"name":"API reference","url":"/api/"},{"name":"@imqueue/async-logger","url":"/api/async-logger/latest/"},{"name":"AsyncLoggerOptions","url":"/api/async-logger/latest/async-logger.asyncloggeroptions/"},{"name":"metadata","url":"/api/async-logger/latest/async-logger.asyncloggeroptions.metadata/"}]
+sitemap: false
+---
+
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+# AsyncLoggerOptions.metadata property
+
+Fields attached to every record sent to a transport, such as a source or environment tag. Does not affect console output.
+
+**Signature:**
+
+```typescript
+metadata: JsonObject;
+```