Skip to content

docs(ISI-1646): refresh README/docs/CHANGELOG for 0.7.0 + 0.8.0 - #66

Merged
henrikrexed merged 1 commit into
mainfrom
docs/isi-1646-v0.8.0
Jul 8, 2026
Merged

docs(ISI-1646): refresh README/docs/CHANGELOG for 0.7.0 + 0.8.0#66
henrikrexed merged 1 commit into
mainfrom
docs/isi-1646-v0.8.0

Conversation

@henrikrexed

Copy link
Copy Markdown
Owner

Docs v0.7.0 / v0.8.0 refresh (ISI-1646)

Brings README + telemetry docs + CHANGELOG current to main. Parent: ISI-1642. Authoritative source: ISI-1645 technical change summary, verified against src/semconv.ts, src/config.ts, src/hooks.ts and the released tags.

⚠️ Release-framing note (flagged ambiguity)

The parent title said "v0.0.8" and ISI-1645 framed ISI-1605 + ISI-1629 as "unreleased / expected 0.8.0". Since then 0.8.0 was tagged today (2026-07-08) and already contains ISI-1605 (plus ISI-1627, ISI-1628). ISI-1629 is still on a feature branch, not merged to main. This PR documents the true state:

Change Documented as
ISI-1318 error_preview 0.7.0 (released)
ISI-1605 gen_ai content keys 0.8.0 (released today)
ISI-1629 tool-span enrichment Unreleased (feature branch, not yet on main)

Changes

  • README.md — replace stale "What's New in 0.6.0" with 0.8.0 + 0.7.0 sections; add an Unreleased block for ISI-1629; refresh the support matrix (0.7.x/0.8.x).
  • CHANGELOG.md — add an [Unreleased] entry for ISI-1629; dedupe the doubled ISI-1605 (0.8.0) and ISI-1318 (0.7.0) lines.
  • docs/telemetry/traces.md — document openclaw.tool.error_preview (0.7.0) and the ISI-1629 enrichment keys (marked unreleased).
  • docs/configuration.md — document the 6th captureContent flag toolErrorMessages with its object-only default-on behavior table, the gen_ai.* mirrors, and the size caps.
  • docs/backends/dynatrace.md — add an AI Observability section covering the gen_ai.* content keys and the traceloop.span.kind classifier.

Verification

  • mkdocs build --strict — the only 2 warnings are pre-existing on main (getting-started.md → ../README.md#hooks… and traces.md:50 → ../../CHANGELOG.md); all new cross-page anchors resolve cleanly.
  • Scope respected: no OC_COMPACTION_* env keys documented (those belong to ISI-1628).

🤖 Generated with Claude Code

Bring the docs current to `main`. Release framing corrected against the
actual tag state (main shipped 0.8.0 today, containing ISI-1605):

- README: replace stale "What's New in 0.6.0" with 0.8.0 (ISI-1605 GenAI
  content keys, ISI-1627 subagent propagation, ISI-1628 compaction) and
  0.7.0 (ISI-1318 error_preview) sections; add an Unreleased block for the
  not-yet-merged ISI-1629 tool-span enrichment; refresh the support matrix.
- CHANGELOG: add Unreleased entry for ISI-1629; dedupe doubled ISI-1605 /
  ISI-1318 lines so they read cleanly.
- docs/telemetry/traces.md: document openclaw.tool.error_preview (0.7.0) and
  the ISI-1629 enrichment keys (marked unreleased).
- docs/configuration.md: document the 6th captureContent flag
  (toolErrorMessages) with its object-only default-on behavior table, plus
  the gen_ai.* mirrors and size caps.
- docs/backends/dynatrace.md: add an AI Observability section covering the
  gen_ai.* content keys and traceloop.span.kind classifier.

Source of truth: ISI-1645 technical change summary, verified against
src/semconv.ts, src/config.ts, src/hooks.ts and the released tags.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: Paperclip DevOps Engineer <henrik@perfbytes.com>
@cursor

cursor Bot commented Jul 8, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@henrikrexed

Copy link
Copy Markdown
Owner Author

can you review @copilot ?

Copilot AI commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

can you review @copilot ?

Reviewed all five changed files. Here's a summary of what I verified:

CHANGELOG.md

  • [Unreleased] entry for ISI-1629 is accurate (feature branch, not yet in a tagged release)
  • Deduplication of the doubled ISI-1605 / ISI-1627 / ISI-1628 entries is correct — the kept commit hashes match the ones in the released 0.8.0 tag
  • ISI-1318 (0.7.0) entry correctly adds the captureContent.toolErrorMessages gate detail that was missing before

README.md

  • Support matrix correctly reflects the current state: 0.6.x / 0.7.x superseded, 0.8.x active
  • All three feature descriptions for 0.8.0 (ISI-1605, ISI-1627, ISI-1628) are accurate
  • toolErrorMessages default-on behavior description for 0.7.0 matches src/config.ts:normalizeContentCapturePolicy
  • ISI-1629 unreleased block correctly scoped to feature branch

docs/backends/dynatrace.md

  • All five gen_ai.* keys verified against src/semconv.ts
  • traceloop.span.kind values (task / tool) verified against TRACELOOP_SPAN_KIND_TASK / TRACELOOP_SPAN_KIND_TOOL constants
  • Correctly notes traceloop.span.kind emits unconditionally (no content gate) while gen_ai.* content keys are opt-in

docs/configuration.md

  • The toolErrorMessages default behavior table matches the code in src/config.ts exactly (object → default on, boolean false / omitted → off)
  • gen_ai.* mirror documentation is accurate and tied to the correct captureContent flags

docs/telemetry/traces.md

  • openclaw.tool.error_preview attribute name, 1024-char cap, and redact-before-truncate order all verified against src/hooks.ts:248–256
  • ISI-1629 unreleased keys correctly annotated in the table and in the note block

One pre-existing issue (not introduced by this PR): CHANGELOG.md for 0.6.1 still has duplicated bug fix entries — those can be addressed in a separate cleanup if desired.

No issues with the changes themselves. LGTM.

@henrikrexed
henrikrexed merged commit b7dc55d into main Jul 8, 2026
2 checks passed
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.

3 participants