Skip to content

docs(changelog): telemetry schema release, plus a brevity pass on the history#157

Merged
indykish merged 1 commit into
mainfrom
chore/m139-telemetry-semantics-changelog
Jul 24, 2026
Merged

docs(changelog): telemetry schema release, plus a brevity pass on the history#157
indykish merged 1 commit into
mainfrom
chore/m139-telemetry-semantics-changelog

Conversation

@indykish

Copy link
Copy Markdown
Contributor

Changelog for agentsfleet/agentsfleet PR #555 — M139_004, telemetry semantic conventions.

What changes

  • A new <Update> for Jul 25, 2026 — tagged Breaking / What's new / Observability. Covers the fleet_agentsfleet_ Prometheus namespace move, the four metric renames with their corrected units, the removal of workspace and tenant identity from metric attributes, bounded model attribution, and standard HTTP span keys. Carries the lease-renewal credit-metric fix under Bug fixes.
  • A brevity pass over the existing history — prose tightened, meaning kept.

On the history edit

docs/CHANGELOG_VOICE.md:16 sanctions this explicitly: "Historical entries are archives. Brevity-pass them; never rewrite the past." No past claim is restated, retracted, or corrected — only prose is tightened.

Every load-bearing category the voice rules enumerate (CHANGELOG_VOICE.md:15) was checked against the diff and survives intact:

Category Status
Error codes UZ-UUIDV7-009, UZ-REQ-001, UZ-AGT-014, UZ-CATALOG-005, UZ-MEM-004, UZ-PROVIDER-004, UZ-RUN-015 all retained
Endpoint paths, methods, status codes retained, including GET /v1/models (200/401), DELETE …/memories/{key} (204), 412 + ETag, retired GET /_um/<key>/cap.json404
Schema columns failure_detail, cost_nanos retained
CLI subcommands and flags retained, including agentsfleet connector list [--workspace <id>] [--json] and every stale-hint command name
Migration steps retained — {"deleted"}{"removed_from_local_state"}
Money amounts $1.20, $0.00 retained

What was cut is rationale and restatement, not fact.

Scope

changelog.mdx only. No other page needed revision: nothing outside the changelog documents /metrics, Prometheus families, or OpenTelemetry metric names, so the renames have no stale page to correct. Verified by grep across all .mdx/.md.

Verification

make lint passes — exit 0, all internal links resolve, no OpenAPI drift.

🤖 Generated with Claude Code

…e history

New entry: metrics move to one `agentsfleet_` namespace with standard
OpenTelemetry names and correct units, bounded model attribution, standard HTTP
span keys, and the renewal debit that never reached the credit series.

Brevity pass over all 44 entries per Indy's direction, cutting narration rather
than meaning: 9218 -> 7743 words with every load-bearing fact retained. Verified
mechanically that no error code (44), route (31), environment variable, or CLI
command was dropped. History is trimmed, never rewritten.

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This repository has used its 100 free open-source review credits for this billing period. An organization admin can enable additional billed reviews, or reviews resume next period.

@indykish
indykish merged commit 22bb52d into main Jul 24, 2026
3 checks passed
@indykish
indykish deleted the chore/m139-telemetry-semantics-changelog branch July 25, 2026 08:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant