qyl-mcp-server 7.6.0 → 7.7.0

package/README.md

@@ -27,7 +27,6 @@ its own.
 Both use MCP TypeScript SDK v2: Streamable HTTP through `createMcpHandler`
 and stdio through `serveStdio`, with their documented compatibility defaults.
 One factory serves revision `2026-07-28` and supported 2025-era requests.
-Events require `2026-07-28`.
 The HTTP server serves a product page at `/`; `/mcp` is the only protocol
 endpoint.
 
@@ -63,81 +62,54 @@ an enabled module proves a client has been provisioned.
 
 ## Tools
 
-**Telemetry** — `list_traces`, `get_trace`, `list_sessions`, `search_logs`,
-`ci_log`, `display_traces`, `display_mcp_dashboard`.
-
-`list_traces` filters by a `start_time`/`end_time` window (RFC 3339, start
-inclusive, end exclusive), `service_name` (traces with a span from that
-service) and `errors_only`. `list_sessions` filters by `active_only` and the
-same window on the session start. `search_logs` filters by `trace_id`,
-`session_id`, `service_name`, `severity_min`, a body substring `query` and the
-window. Every list tool pages the same way: the output carries `has_more` and,
-when more exist, `next_cursor`; pass it back as `cursor` with the same filters
-for the next page. A cursor is opaque; one that is not ours is refused with
-`invalid_argument` rather than answered with the first page again.
-
-`get_trace` returns every span by default. `errors_only` selects error spans;
-`max_spans` (1–1000) caps the result after filtering in Collector order.
-`include_attributes=false` omits span, resource, event, link and instrumentation
-scope attribute collections, including any returned root-span copy. Trace
-totals remain the Collector's totals; the text reports matching and returned
-counts. `ci_log.service_prefix` is case-sensitive, defaults to `qyl-ci`, and
-filters both recent runs and individual phase spans.
-
-**Metrics** — `list_metrics`, `get_metric_series`, `query_metric`. Read in that
-order: the catalog gives you an exact instrument name and how many attribute
-streams it has, series discovery tells you which attribute keys are worth
-grouping or filtering on, and the range query answers the actual question —
-a window, a bucket width in whole milliseconds (`step_ms`), a reducer (`avg`,
-`min`, `max`, `sum`, `count`, `last`, `p50`, `p90`, `p95`, `p99`), optional
-`group_by` keys, and optional `matchers`, each `{ key, op, value }` with `op`
-`eq` (exact) or `prefix`; the server serializes them to the Collector's
-`attr` / `attr_prefix` parameters. One bucket spanning the whole window
-collapses the answer to a single number. The catalog and the series list page
-with `cursor` like the telemetry lists.
-
-**App-only** — `fetch_telemetry` is called by the bundled MCP Apps, not by a
-model. Its input is one of four shapes selected by `view` (`traces`, `trace`,
-`logs`, `mcp_stats`); the `trace` view requires `trace_id` at the schema layer.
-
-**Writes** — `create_annotation`, `update_annotation`, `create_saved_query`,
-`update_saved_query` and `delete` change only objects users create in qyl, in
-the caller's Collector project: annotations (plain-text notes of at most 2000
-characters on a trace, span or session) and saved queries (named filters for
-traces, logs or metrics). `delete` takes `kind` (`annotation` or
-`saved_query`; alert rules follow with Contract 11.7.0), `id` and `etag`. No
-tool deletes or edits traces, logs or metrics; retention removes telemetry.
-Updates and deletes send the `etag` as `If-Match`: a stale one fails with
-`precondition_failed`, a duplicate saved-query name with `conflict`.
-`list_saved_queries` and `run_saved_query` read saved queries; `get_trace` and
-`list_sessions` return the annotations on what they read. Demo mode keeps none
-of these objects and refuses these tools.
-
-**Failures** — every failed call returns `isError: true`, the message as text,
-and `structuredContent.error = { code, message, retryable }` with the
-contract's `ToolErrorCode`.
-
-The thirteen read tools carry `readOnlyHint: true` and only query the
-configured collector. The create tools carry `destructiveHint: false` and
-`idempotentHint: false`; the update tools and `delete` carry
-`destructiveHint: true` and `idempotentHint: true`. On the hosted server
-`qyl:read` covers the read tools, `qyl:write` adds the create and update tools,
-and `qyl:delete` adds `delete`.
-
-The `display_*` tools return MCP Apps UI resources as single-file viewers.
-
-Every tool runs inside its request scope. Cancellation: a
-`notifications/cancelled` for the request, or a closed connection, aborts the
-in-flight collector fetch instead of waiting out its timeout. Progress: a
-request that carries a `progressToken` gets `notifications/progress` per
-completed step, one per collector round trip plus a final "Result ready"
-(`ci_log` with a `run_id` reports the flatten into legs as a step of its own).
-Logging: the server declares no `logging` capability and sends no
-`notifications/message`, including when a client supplies a log level.
-Operational error diagnostics go to stderr; native tool timing/status telemetry
-uses OpenTelemetry. Requested progress and cancellation remain available.
-[Source and test commands/output, 2026-10-08](https://github.com/ANcpLua/qyl.mcp/blob/main/docs/evidence/2026-10-08-followup-01.md).
+The server publishes 32 tools, including one app-only read tool. Reads use the collector's
+analysis queries and the generated qyl API contracts.
 
+| Purpose | Tools |
+| --- | --- |
+| Investigate failures | `triage`, `list_failures`, `get_failure_context`, `compare_groups`, `compare_traces`, `verify_fix` |
+| Explore telemetry | `aggregate_telemetry`, `discover_attributes`, `get_agent_run`, `list_releases`, `get_service_map`, `check_telemetry_health`, `get_mcp_stats` |
+| Read executions | `list_sessions`, `list_traces`, `get_trace`, `search_logs`, `ci_log` |
+| Read metrics | `list_metrics`, `get_metric_series`, `query_metric` |
+| Saved questions | `list_saved_queries`, `run_saved_query` |
+| Interactive views | `display_traces`, `display_mcp_dashboard`, `fetch_telemetry` (app-only) |
+| Write project records | `create_annotation`, `update_annotation`, `create_saved_query`, `update_saved_query`, `delete`, `update_failure_status` |
+
+Read tools accept an absolute RFC 3339 time window or `lookback_minutes` and report the
+resolved `window` and `coverage`: examined, matched and returned counts, truncation,
+scan completeness and observation time. Unknown counts are null. Filtering happens before
+pagination; reuse an opaque `next_cursor` with the same filters to continue a page.
+
+Shared matchers support `eq`, `neq`, `in`, `prefix`, `contains`, `exists`, `gt`, `gte`,
+`lt` and `lte`, with span, resource or log scope. Span durations are milliseconds;
+metrics retain their recorded units. Histogram percentiles identify their approximation,
+and cumulative counter changes account for resets. Verification reports insufficient
+traffic as pending rather than calling an unobserved failure fixed.
+
+`get_trace` supports all spans, errors, errors with ancestors, or the critical path,
+selected attributes and correlated logs. `display_traces` preserves the selected span
+and can compare two executions. Notes and bookmarks are created only through explicit
+viewer actions. `display_mcp_dashboard` uses the same MCP aggregates as `get_mcp_stats`,
+shows the numerator and denominator behind rates, classifies failures, and opens matching
+calls from aggregate selections. `fetch_telemetry` serves five app-only views: traces,
+trace, logs, MCP statistics and comparison, with incremental refresh and field selection.
+
+The 26 read tools carry `readOnlyHint: true`. Six write tools change annotations, saved
+queries or failure status in the caller's project. An annotation can target a trace, span,
+session or failure and has optional labels and a classification. A bookmark is a note
+labelled `bookmark`. Updates and deletes require the current `etag`; stale writes are
+rejected. Optional `idempotency_key` on create calls reuses the stored result for 24 hours.
+Omitting it creates a new record. No tool edits or deletes recorded telemetry.
+
+`qyl:read` covers reads, `qyl:write` adds creation and updates, and `qyl:delete` permits
+`delete`. A missing scope returns the supported OAuth step-up challenge. Failed calls
+carry a stable code, retryability, the problem type and field-level validation details
+when available. Secrets are redacted before model text or structured content is returned.
+
+Every tool runs inside its request scope, forwarding cancellation to the collector.
+Requested progress reports completion; no logging notifications are sent to clients.
+Analysis reads require a live collector. Synthetic demo data remains available for local
+UI fixtures, and is never substituted when a collector fails.
 
 Every inbound `tools/call` on a local server — `--stdio`, or HTTP without
 `MCP_PUBLIC_URL` — records only its tool name, timing, status and error type,
@@ -155,14 +127,14 @@ multi-tenant audit log.
 | --- | --- |
 | `QYL_COLLECTOR_URL` | Collector read API base; default `http://127.0.0.1:5100`. Also the OTLP base when set. |
 | `QYL_API_KEY` | Collector credential for reads and OTLP; the write tools need the Collector's `write` and `delete` roles on it. Outgoing only. |
-| `QYL_PROJECT` | Server-owned collector project scope. Unset, the server sends no project-scope header, so the Collector's default project applies; the Events subscription source key records that as `default`. Never accepted as tool input. This is the only place that states the default; other documents link here. |
+| `QYL_PROJECT` | Server-owned collector project scope. Unset, the server sends no project-scope header, so the Collector's default project applies. Never accepted as tool input. This is the only place that states the default; other documents link here. |
 | `MCP_COLLECTOR_PROJECTS` | Optional secret JSON mapping validated Auth0 subjects to project-bound Collector keys; see account isolation below. |
 | `QYL_OTLP_ENDPOINT` | Optional OTLP base for self-telemetry. |
-| `QYL_DEMO=1` | Explicit, visibly labelled demo telemetry. A collector failure never silently substitutes demo data. |
+| `QYL_DEMO=1` | Local synthetic UI fixtures; analysis tools require a live collector. |
 | `QYL_MCP_TELEMETRY=0` | Disable MCP spans, metrics, and operation logs. |
 | `QYL_MCP_CAPTURE_CONTENT=1` | Workbench content capture; native incoming tool-call telemetry never supplies request or response bodies. |
 | `QYL_MCP_NATIVE_STATE_PATH` | Override the native execution-evidence path. |
-| `MCP_EVENTS_STORE` | Persistent Events subscription file; requires Auth0 and the access-check credentials below. |
+| `MCP_EVENTS_STORE` | Optional internal Events subscription file; leave unset for the shared ChatGPT/Claude deployment. |
 | `MCP_EVENTS_AUTH0_CLIENT_ID` / `MCP_EVENTS_AUTH0_CLIENT_SECRET` | Dedicated Management API application with `read:users`, `read:clients`, `read:client_grants`, `read:grants`; resolves CIMD identities and keeps access checks current without storing subscriber tokens. |
 | `MCP_EVENTS_POLL_MS` | Collector polling interval, at least 5000 ms; default 30000 ms. |
 | `PORT` | HTTP listener port; default `3001`. |
@@ -176,6 +148,11 @@ so serving it requires Bun.
 
 ### Account isolation for hosted Auth0
 
+The existing tenant's API scopes, named client grants and mapped-user permissions
+are managed by [the Auth0 configuration and drift checker](https://github.com/ANcpLua/qyl.mcp/tree/main/tools/auth0).
+Run its check before applying changes; it preserves unrelated tenant configuration
+and never creates identities or rotates credentials.
+
 To give a reviewer access to sample data, provision a separate Collector
 project/key through the Collector's `QYL_OTLP_PROJECT_KEYS` configuration and
 assign that key to the reviewer's validated Auth0 subject. Configure the MCP
@@ -197,20 +174,51 @@ existing deployment-wide credential behavior is retained.
 
 Only the verified SDK `AuthInfo.extra.subject` selects the project. Tool inputs
 and request metadata cannot override it. All telemetry tools, viewer refreshes
-and Events queries use that account's project credential. Removing the account
-assignment revokes its Events subscription on the next access check. Project
+use that account's project credential. Project
 keys are redacted from text and structured results, including keys nested in
 this JSON configuration. Keep the map in host secrets and out of the plugin ZIP.
 
 `bun run smoke:projects` from the repository root checks every tool, the
-writes included, viewer query paths, both protocol eras and Events against a
+writes included, viewer query paths and both protocol eras against a
 real local Collector with two temporary projects. Set `QYL_COLLECTOR_PROJECT` to its
 `.csproj` when using a different checkout. The script uses local test identities
 and an in-process signed webhook receiver; the hosted reviewer OAuth login and
 real ChatGPT demonstration are separate checks before upload.
 
+### Seeded analysis verification
+
+The collector fixture `tests/Qyl.Collector.Tests/Fixtures/seed-answer-key.py`
+emits real OTLP data and writes the trace IDs and absolute windows used by
+`server/verify-answer-key.mjs`. Seed a fresh temporary collector database before
+each run because the checks exercise annotations and failure status changes.
+After building this workspace, run the verifier from `server/`:
+
+```sh
+QYL_ANSWER_KEY_FILE=/tmp/qyl-answer-key.json \
+QYL_ANSWER_KEY_COLLECTOR=http://127.0.0.1:5510 \
+QYL_ANSWER_KEY_OTLP=http://127.0.0.1:5518 \
+node --test verify-answer-key.mjs
+```
+
+`QYL_BIN=/path/to/installed/qyl node live-tools-smoke.mjs` additionally checks
+all 32 tools against an isolated collector started by the published CLI.
+
 ## Release notes
 
+### 7.7.0
+
+- Expand to 32 tools: failure triage and lifecycle, trace/group comparisons, fix verification, telemetry aggregation and discovery, agent runs, releases, service maps, telemetry health and MCP statistics.
+- Use the collector's shared typed analysis contracts for filtering, pagination, coverage and saved-query execution; retain official SDKs/exporters and project-scoped authorization.
+- Add responsive trace comparison, explicit note/bookmark controls, dashboard filters and drill-downs, with denominator counts behind rates.
+- Preserve numeric agent token usage during secret redaction, and verify the new surface against real OTLP fixtures plus both protocol eras.
+
+
+### 7.6.1
+
+- Manage existing Auth0 API permissions, client grants and mapped-user permissions with scoped tenant configuration and a drift check.
+
+- Use the qyl-owned semantic conventions package generated from the same registry as C#. MCP attribute names, values, operation events, duration metrics and seconds remain consistent across both languages. The official OpenTelemetry SDKs and exporters and the shared API contracts remain in use.
+
 ### 7.6.0
 
 - Contract 12.0.0 (`@ancplua/qyl-api-schema` 12.0.0, revision

package/dist/analysis-client.d.ts

@@ -0,0 +1,5 @@
+/** Shared HTTP transport; every callable analysis operation is registered by name. */
+import type { CallToolResult } from "@modelcontextprotocol/server";
+import type * as z from "zod/v4";
+import type { ToolScope } from "./request-scope.js";
+export declare function queryAnalysis<Input extends object, Output extends object>(operation: string, input: Input, schema: z.ZodType<Output>, scope: ToolScope): Promise<CallToolResult>;

package/dist/analysis-client.js

@@ -0,0 +1,40 @@
+import { CollectorError, collectorPost, parseCollectorBody } from "./collector.js";
+import { telemetryToolResult } from "./telemetry-redaction.js";
+export async function queryAnalysis(operation, input, schema, scope) {
+    if (process.env.QYL_DEMO === "1") {
+        throw new CollectorError("Analysis needs a live qyl Collector; unset QYL_DEMO to query recorded telemetry.");
+    }
+    const path = `/api/v1/analysis/${operation}`;
+    const deadline = Date.now() + 55_000;
+    let query = input;
+    let previousPageSize = Infinity;
+    for (;;) {
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            throw new CollectorError("The query exceeded its time budget; narrow the time window and matchers.");
+        const response = await collectorPost(path, query, { ...scope.collector, timeoutMs: remaining });
+        const output = parseCollectorBody(response, path, schema);
+        const result = telemetryToolResult(`${operation}: results are in the structured data.`, output);
+        // Bytes give a conservative upper bound even for token-dense identifiers.
+        const bytes = Buffer.byteLength(JSON.stringify(result), "utf8");
+        if (bytes <= 24_000) {
+            await scope.step(`Queried ${operation}`);
+            return result;
+        }
+        // Re-query the collector so its cursor, coverage and totals describe the
+        // smaller page. Never slice a response and leave its paging metadata stale.
+        const args = query;
+        const page = output;
+        const canPage = (operation === "display_traces" && !args.trace_id)
+            || (operation === "fetch_telemetry" && args.view === "traces");
+        if (canPage && Array.isArray(page.traces) && page.traces.length > 1 && page.traces.length < previousPageSize) {
+            previousPageSize = page.traces.length;
+            const limit = Math.max(1, Math.floor(page.traces.length * 24_000 / bytes * 0.8));
+            const window = page.window;
+            query = { ...args, ...window, limit };
+            continue;
+        }
+        throw new CollectorError("The result exceeds the response budget; reduce limit or narrow the time window and matchers.", false, 413, "collector_rejected");
+    }
+}
+//# sourceMappingURL=analysis-client.js.map

package/dist/analysis-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis-client.js","sourceRoot":"","sources":["../src/analysis-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,SAAiB,EACjB,KAAY,EACZ,MAAyB,EACzB,KAAgB;IAEhB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,GAAG,EAAE,CAAC;QACjC,MAAM,IAAI,cAAc,CAAC,kFAAkF,CAAC,CAAC;IAC/G,CAAC;IACD,MAAM,IAAI,GAAG,oBAAoB,SAAS,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IACrC,IAAI,KAAK,GAAW,KAAK,CAAC;IAC1B,IAAI,gBAAgB,GAAG,QAAQ,CAAC;IAChC,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxC,IAAI,SAAS,IAAI,CAAC;YAAE,MAAM,IAAI,cAAc,CAAC,0EAA0E,CAAC,CAAC;QACzH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAChG,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,SAAS,uCAAuC,EAAE,MAAM,CAAC,CAAC;QAChG,0EAA0E;QAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAChE,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;YACpB,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW,SAAS,EAAE,CAAC,CAAC;YACzC,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,yEAAyE;QACzE,4EAA4E;QAC5E,MAAM,IAAI,GAAG,KAAgC,CAAC;QAC9C,MAAM,IAAI,GAAG,MAAiC,CAAC;QAC/C,MAAM,OAAO,GAAG,CAAC,SAAS,KAAK,gBAAgB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;eAC7D,CAAC,SAAS,KAAK,iBAAiB,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACjE,IAAI,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;YAC7G,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC;YACjF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAgE,CAAC;YACrF,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;YACtC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,cAAc,CACtB,8FAA8F,EAC9F,KAAK,EAAE,GAAG,EAAE,oBAAoB,CACjC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/analysis-tools.d.ts

@@ -0,0 +1,3 @@
+/** Named analysis tools backed by the collector's generated query contracts. */
+import type { McpServer } from "@modelcontextprotocol/server";
+export declare function registerAnalysisTools(server: McpServer): void;

package/dist/analysis-tools.js

@@ -0,0 +1,165 @@
+import { compactOutputSchema, contractSchema } from "./contract-validation.js";
+import { runTool } from "./request-scope.js";
+import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS, TELEMETRY_TOOL_AUTH_META } from "./tools.js";
+import { queryAnalysis } from "./analysis-client.js";
+import { collectorPatch, parseCollectorBody } from "./collector.js";
+import { ifMatch } from "./collector-resources.js";
+import { assertToolScopes, toolScopeChallenge } from "./tool-scopes.js";
+import { QYL_MCP_SCOPE, QYL_MCP_WRITE_SCOPE } from "./oauth.js";
+import { telemetryToolResult } from "./telemetry-redaction.js";
+const TriageInputSchema = contractSchema("Mcp.Tools.TriageInput");
+const TriageOutputSchema = contractSchema("Mcp.Tools.TriageOutput");
+const ListFailuresInputSchema = contractSchema("Mcp.Tools.ListFailuresInput");
+const ListFailuresOutputSchema = contractSchema("Mcp.Tools.ListFailuresOutput");
+const GetFailureContextInputSchema = contractSchema("Mcp.Tools.GetFailureContextInput");
+const GetFailureContextOutputSchema = contractSchema("Mcp.Tools.GetFailureContextOutput");
+const CompareGroupsInputSchema = contractSchema("Mcp.Tools.CompareGroupsInput");
+const CompareGroupsOutputSchema = contractSchema("Mcp.Tools.CompareGroupsOutput");
+const CompareTracesInputSchema = contractSchema("Mcp.Tools.CompareTracesInput");
+const CompareTracesOutputSchema = contractSchema("Mcp.Tools.CompareTracesOutput");
+const VerifyFixInputSchema = contractSchema("Mcp.Tools.VerifyFixInput");
+const VerifyFixOutputSchema = contractSchema("Mcp.Tools.VerifyFixOutput");
+const AggregateTelemetryInputSchema = contractSchema("Mcp.Tools.AggregateTelemetryInput");
+const AggregateTelemetryOutputSchema = contractSchema("Mcp.Tools.AggregateTelemetryOutput");
+const DiscoverAttributesInputSchema = contractSchema("Mcp.Tools.DiscoverAttributesInput");
+const DiscoverAttributesOutputSchema = contractSchema("Mcp.Tools.DiscoverAttributesOutput");
+const GetAgentRunInputSchema = contractSchema("Mcp.Tools.GetAgentRunInput");
+const GetAgentRunOutputSchema = contractSchema("Mcp.Tools.GetAgentRunOutput");
+const ListReleasesInputSchema = contractSchema("Mcp.Tools.ListReleasesInput");
+const ListReleasesOutputSchema = contractSchema("Mcp.Tools.ListReleasesOutput");
+const GetServiceMapInputSchema = contractSchema("Mcp.Tools.GetServiceMapInput");
+const GetServiceMapOutputSchema = contractSchema("Mcp.Tools.GetServiceMapOutput");
+const CheckTelemetryHealthInputSchema = contractSchema("Mcp.Tools.CheckTelemetryHealthInput");
+const CheckTelemetryHealthOutputSchema = contractSchema("Mcp.Tools.CheckTelemetryHealthOutput");
+const GetMcpStatsInputSchema = contractSchema("Mcp.Tools.GetMcpStatsInput");
+const GetMcpStatsOutputSchema = contractSchema("Mcp.Tools.GetMcpStatsOutput");
+const UpdateFailureStatusInputSchema = contractSchema("Mcp.Tools.UpdateFailureStatusInput");
+const UpdateFailureStatusOutputSchema = contractSchema("Mcp.Tools.UpdateFailureStatusOutput");
+const FAILURE_WRITE_SCOPES = [QYL_MCP_SCOPE, QYL_MCP_WRITE_SCOPE];
+export function registerAnalysisTools(server) {
+    server.registerTool("triage", {
+        title: "Triage",
+        description: "Rank new or worsening failures, performance regressions, releases and silent services when investigating what changed.",
+        inputSchema: TriageInputSchema,
+        outputSchema: compactOutputSchema(TriageOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("triage", args, TriageOutputSchema, scope)));
+    server.registerTool("list_failures", {
+        title: "List Failures",
+        description: "List failures grouped by stable fingerprints when investigating recurring errors or their recorded status.",
+        inputSchema: ListFailuresInputSchema,
+        outputSchema: compactOutputSchema(ListFailuresOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("list_failures", args, ListFailuresOutputSchema, scope)));
+    server.registerTool("get_failure_context", {
+        title: "Get Failure Context",
+        description: "Return the recorded failure path, correlated logs and comparison evidence when investigating a failed execution.",
+        inputSchema: GetFailureContextInputSchema,
+        outputSchema: compactOutputSchema(GetFailureContextOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_failure_context", args, GetFailureContextOutputSchema, scope)));
+    server.registerTool("compare_groups", {
+        title: "Compare Groups",
+        description: "Compare attribute distributions and durations between two telemetry groups when identifying associations with a failure.",
+        inputSchema: CompareGroupsInputSchema,
+        outputSchema: compactOutputSchema(CompareGroupsOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("compare_groups", args, CompareGroupsOutputSchema, scope)));
+    server.registerTool("compare_traces", {
+        title: "Compare Traces",
+        description: "Align two executions and locate their first divergence when comparing a failing path with another execution.",
+        inputSchema: CompareTracesInputSchema,
+        outputSchema: compactOutputSchema(CompareTracesOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("compare_traces", args, CompareTracesOutputSchema, scope)));
+    server.registerTool("verify_fix", {
+        title: "Verify Fix",
+        description: "Measure failure recurrence and traffic after a change when checking whether enough evidence supports a fix.",
+        inputSchema: VerifyFixInputSchema,
+        outputSchema: compactOutputSchema(VerifyFixOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("verify_fix", args, VerifyFixOutputSchema, scope)));
+    server.registerTool("aggregate_telemetry", {
+        title: "Aggregate Telemetry",
+        description: "Group spans or logs and calculate counts, error rates and durations when comparing operations or attributes.",
+        inputSchema: AggregateTelemetryInputSchema,
+        outputSchema: compactOutputSchema(AggregateTelemetryOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("aggregate_telemetry", args, AggregateTelemetryOutputSchema, scope)));
+    server.registerTool("discover_attributes", {
+        title: "Discover Attributes",
+        description: "List recorded attribute keys, value distributions and convention descriptions when choosing telemetry filters.",
+        inputSchema: DiscoverAttributesInputSchema,
+        outputSchema: compactOutputSchema(DiscoverAttributesOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("discover_attributes", args, DiscoverAttributesOutputSchema, scope)));
+    server.registerTool("get_agent_run", {
+        title: "Get Agent Run",
+        description: "Reconstruct agent and tool execution steps, token usage and repeated calls when investigating an agent run.",
+        inputSchema: GetAgentRunInputSchema,
+        outputSchema: compactOutputSchema(GetAgentRunOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_agent_run", args, GetAgentRunOutputSchema, scope)));
+    server.registerTool("list_releases", {
+        title: "List Releases",
+        description: "List observed service versions and their before-and-after impact when investigating a release.",
+        inputSchema: ListReleasesInputSchema,
+        outputSchema: compactOutputSchema(ListReleasesOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("list_releases", args, ListReleasesOutputSchema, scope)));
+    server.registerTool("get_service_map", {
+        title: "Get Service Map",
+        description: "Return service dependencies and their traffic, error rates and latency when investigating calls between services.",
+        inputSchema: GetServiceMapInputSchema,
+        outputSchema: compactOutputSchema(GetServiceMapOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_service_map", args, GetServiceMapOutputSchema, scope)));
+    server.registerTool("check_telemetry_health", {
+        title: "Check Telemetry Health",
+        description: "Report silent services, orphan spans and missing convention attributes when checking telemetry coverage.",
+        inputSchema: CheckTelemetryHealthInputSchema,
+        outputSchema: compactOutputSchema(CheckTelemetryHealthOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("check_telemetry_health", args, CheckTelemetryHealthOutputSchema, scope)));
+    server.registerTool("get_mcp_stats", {
+        title: "Get MCP Stats",
+        description: "Return MCP request totals, failure classes and latency aggregates when investigating MCP tool health.",
+        inputSchema: GetMcpStatsInputSchema,
+        outputSchema: compactOutputSchema(GetMcpStatsOutputSchema),
+        annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
+        _meta: TELEMETRY_TOOL_AUTH_META,
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("get_mcp_stats", args, GetMcpStatsOutputSchema, scope)));
+    server.registerTool("update_failure_status", {
+        title: "Update Failure Status",
+        description: "Set a failure's status or assignee when recording triage decisions, returning the stored failure available through list_failures.",
+        inputSchema: UpdateFailureStatusInputSchema,
+        outputSchema: compactOutputSchema(UpdateFailureStatusOutputSchema),
+        annotations: { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false },
+        scopeChallenge: toolScopeChallenge("update_failure_status", FAILURE_WRITE_SCOPES),
+        _meta: { securitySchemes: [{ type: "oauth2", scopes: [...FAILURE_WRITE_SCOPES] }] },
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => {
+        assertToolScopes("update_failure_status", FAILURE_WRITE_SCOPES, ctx.http?.authInfo);
+        const { failure_id, etag, ...changes } = args;
+        const path = `/api/v1/failures/${encodeURIComponent(failure_id)}`;
+        const response = await collectorPatch(path, changes, {
+            ...scope.collector,
+            headers: { ...scope.collector.headers, ...ifMatch(etag) },
+        });
+        const output = parseCollectorBody(response, path, UpdateFailureStatusOutputSchema);
+        await scope.step("Failure status saved");
+        return telemetryToolResult("Failure status saved; list_failures returns the current failure.", output);
+    }));
+}
+//# sourceMappingURL=analysis-tools.js.map

package/dist/analysis-tools.js.map

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

package/dist/ci.d.ts

@@ -21,5 +21,5 @@ export declare function filterCiSessions(sessions: QylSession[], servicePrefix?:
 export declare function collectCiPhases(traces: QylTrace[], servicePrefix?: string): CiPhase[];
 export declare function summarizeCiRuns(runs: CiRunSummary[], mode: Mode, servicePrefix?: string): string;
 export declare function summarizeCiRun(runId: string, phases: CiPhase[], mode: Mode, servicePrefix?: string): string;
-/** Register the CI dogfooding block. */
+/** Query all matching CI telemetry before pagination. */
 export declare function registerCiTools(server: McpServer): void;

package/dist/ci.js

@@ -1,7 +1,6 @@
-import { CiLogInputSchema, CiLogOutputSchema, compactOutputSchema, } from "./contract-validation.js";
-import { fetchSessions, fetchSessionTraces } from "./data.js";
+import { compactOutputSchema, contractSchema } from "./contract-validation.js";
+import { queryAnalysis } from "./analysis-client.js";
 import { runTool } from "./request-scope.js";
-import { telemetryToolResult } from "./telemetry-redaction.js";
 import { READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS, TELEMETRY_TOOL_AUTH_META } from "./tools.js";
 /** Resource service-name prefix that marks telemetry as CI-emitted. */
 export const CI_SERVICE_PREFIX = "qyl-ci";
@@ -67,51 +66,15 @@ export function summarizeCiRun(runId, phases, mode, servicePrefix = CI_SERVICE_P
     }
     return `CI run ${runId} (${mode} mode):\n${lines.join("\n")}`;
 }
-/** Register the CI dogfooding block. */
+/** Query all matching CI telemetry before pagination. */
 export function registerCiTools(server) {
     server.registerTool("ci_log", {
         title: "CI Log",
-        description: "Read CI telemetry from qyl when the user wants recent runs or a per-leg " +
-            "phase breakdown with failures first. Any CI can emit this convention: " +
-            `resource service.name starts with service_prefix (default '${CI_SERVICE_PREFIX}'), session.id identifies ` +
-            "the run, and one span per phase carries a ci.leg attribute; failed phases " +
-            "set span status to error. Without run_id, filters the 50 most recent " +
-            "sessions and returns up to limit matching runs (default 10). With run_id, " +
-            "reads up to 100 traces for that session and returns only phases matching " +
-            "the same case-sensitive service prefix; phase output can be large.",
-        inputSchema: CiLogInputSchema,
-        outputSchema: compactOutputSchema(CiLogOutputSchema),
+        description: "List or compare CI runs and phase failures when investigating a build or test regression.",
+        inputSchema: contractSchema("Mcp.Tools.CiLogInput"),
+        outputSchema: compactOutputSchema(contractSchema("Mcp.Tools.CiLogOutput")),
         annotations: READ_ONLY_TELEMETRY_TOOL_ANNOTATIONS,
         _meta: TELEMETRY_TOOL_AUTH_META,
-    }, (args, ctx) => 
-    // A run breakdown is two units a client can watch: the collector round
-    // trip for the run's traces, then the flatten into per-leg phases. The
-    // run list is one round trip.
-    runTool(ctx, args.run_id ? 2 : 1, async (scope) => {
-        const servicePrefix = args.service_prefix ?? CI_SERVICE_PREFIX;
-        if (args.run_id) {
-            const { traces, mode } = await fetchSessionTraces(args.run_id, 100, scope.collector);
-            await scope.step(`Fetched ${traces.length} trace(s) of CI run ${args.run_id}`);
-            const phases = collectCiPhases(traces, servicePrefix);
-            const legs = new Set(phases.map((phase) => phase.leg)).size;
-            await scope.step(`Collected ${phases.length} phase(s) across ${legs} leg(s)`);
-            const output = { run_id: args.run_id, phases, mode };
-            return telemetryToolResult(summarizeCiRun(args.run_id, phases, mode, servicePrefix), output);
-        }
-        const { sessions, mode } = await fetchSessions({ limit: 50 }, scope.collector);
-        const runs = filterCiSessions(sessions, servicePrefix)
-            .slice(0, args.limit ?? 10)
-            .map((session) => ({
-            run_id: session["session_id"],
-            state: session.state,
-            start_time: session.start_time,
-            ...(session.duration_ms === undefined ? {} : { duration_ms: session.duration_ms }),
-            error_count: session.error_count,
-            services: session.services,
-        }));
-        await scope.step(`Found ${runs.length} CI run(s) among ${sessions.length} session(s)`);
-        const output = { runs, mode };
-        return telemetryToolResult(summarizeCiRuns(runs, mode, servicePrefix), output);
-    }));
+    }, (args, ctx) => runTool(ctx, 1, async (scope) => queryAnalysis("ci_log", args, contractSchema("Mcp.Tools.CiLogOutput"), scope)));
 }
 //# sourceMappingURL=ci.js.map

package/dist/ci.js.map

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

package/dist/collector-resources.d.ts

@@ -14,6 +14,12 @@
 import type { Annotation, CreateAnnotationInput, CreateSavedQueryInput, DeletableKind, ListSavedQueriesInput, RunSavedQueryInput, SavedQuery, SavedQueryRunResult, SessionId, TraceId, UpdateAnnotationInput, UpdateSavedQueryInput } from "@ancplua/qyl-api-schema/types";
 import { type CollectorRequestOptions } from "./collector.js";
 import { type ToolScope } from "./request-scope.js";
+/**
+ * The If-Match value for a change. An etag is opaque, but it travels as an
+ * HTTP field value, so one that could not be sent is refused here instead of
+ * failing inside fetch as if the Collector were unreachable.
+ */
+export declare function ifMatch(etag: string): Readonly<Record<string, string>>;
 export declare function createAnnotation(input: CreateAnnotationInput, options: CollectorRequestOptions): Promise<Annotation>;
 export declare function updateAnnotation(input: UpdateAnnotationInput, options: CollectorRequestOptions): Promise<Annotation>;
 export declare function createSavedQuery(input: CreateSavedQueryInput, options: CollectorRequestOptions): Promise<SavedQuery>;