SIGN IN SIGN UP

docs: bring the documentation set up to 0.14.0 (#94)

Three cross-cutting documents did not mention @vymalo/opencode-otel at
all despite it being a published plugin, and three still described the
tsc build that oxc replaced.

- architecture.md gains otel as the suite's only observer: the hooks and
  events it subscribes to, that its single mutation is a traceparent
  fetch wrapper rather than an auth one, and how it flushes without a
  dispose hook.
- security.md gains its posture: no content capture, unconditional
  credential stripping from git remotes, credential-helper stdout never
  logged, machine-and-project identity rather than developer, and the
  cardinality and egress switches.
- troubleshooting.md gains five symptom-keyed entries, all citing event
  names verified against source.
- The otel package README covers the credential helper, export-failure
  visibility and repository metadata, which all postdate it.
- README, CONTRIBUTING, docs/browser.md now describe the oxc build, and
  CONTRIBUTING states the isolatedDeclarations authoring rule — every
  export needs a locally-readable type — which was written down nowhere
  a contributor would look.

Corrections found while verifying rather than assumed:

- The hook count was wrong everywhere, including in a released changelog
  entry. Docs said otel observes "5 of 19" hooks; it has observed 9
  since 0.13.0, when chat.params, permission.ask,
  experimental.text.complete and experimental.compaction.autocontinue
  were added. Counted from the returned hook object and the Hooks
  interface, not copied from prose. The 16-of-32 event figure checked
  out.
- CONTRIBUTING told maintainers to tag the commit and publish a GitHub
  Release. The repo deliberately has neither — releases are a
  publish.yml dispatch — so following it would have done the one thing
  CLAUDE.md forbids. It also listed five published packages; there are
  eight.
- README called the suite "five small plugins" in three places.
- GETTING_STARTED linked to README#all-three-together, which does not
  exist; the heading is "Stacking the belt". Verified the emoji-heading
  anchor against GitHub's rendered output rather than guessing the slug.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
S
Stephane SEGNING LAMBOU committed
d6a367334aa34a2494e9d723b97c26475beed5f4
Parent: 7c0bead
Committed by GitHub <noreply@github.com> on 8/15/2026, 10:06:41 AM