spike(framework): prove whether native OTel adds value beyond the measurement journal
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 45/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Active
- Domain
- observability-sre
Research direction
Use the issue's same-session Claude Code comparison as the starting point, examining native OpenTelemetry data alongside the local-file readings and published AIDD JSON Lines journal. Record fields, task and step attribution, correlation reliability, privacy boundaries, and duplicate-accounting risks for each source. Done means the evidence supports retaining or rejecting each integration, and any interoperability claim names a consumer and proves consent, reception, and total preservation.
Written by the indexing model from the issue text.
Description
Question
Does native OpenTelemetry data add information or interoperability that the shipped AIDD measurement journal cannot provide?
Current baseline
AIDD already reads the files AI tools write, enriches them with task and step attribution, and stores a published JSON Lines record locally. aidd-telemetry:01-cost is its first reader. Measurement requires project opt-in, a person may refuse it locally, and the record contract excludes prompts, code, and diffs.
A hosted destination may be chosen by the person with separate consent. No destination, transport, or OpenTelemetry route is mandatory.
Evidence required
- Compare, on the same Claude Code session, native OTel data with the local-file reading and AIDD journal.
- State for each source: available fields, missing fields, attribution to task and step, correlation reliability, privacy boundary, and risk of duplicate accounting.
- Do not generalize the Claude result to another tool without equivalent evidence.
- Name an actual destination or consumer that cannot use the published record contract, if interoperability is claimed as the value.
Decision outcomes
- No material gain: retain the local journal and do not add an OTel receiver or exporter.
- Better source data: propose only the bounded native-source integration, including precedence and deduplication with local readings.
- Destination interoperability is necessary: propose only the output mapping, consent, delivery proof, and retained totals. JSON Lines remains the local source of truth.
Out of scope
- Migrating local storage to OTel.
- Selecting or embedding a hosted destination.
- Collecting any field outside the published record contract.
- Declaring an external total a billing amount without its provenance.
Acceptance criteria
- One same-session comparison documents coverage, correlation, and duplicate handling for native OTel and the local journal.
- The outcome states whether native OTel changes a user-relevant decision, with evidence.
- Any external-output proposal names its consumer and proves consent, reception, and total preservation.
- The result explicitly retains or rejects each candidate integration; no transport is adopted by implication.
- Dominant language
- TypeScript
- Stars
- 481
- Forks
- 45
- Avg merge
- 19h 38m
- Merged PRs (30d)
- 108
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from ai-driven-dev/framework
-
refactor(aidd-orchestrator): the check zone says when to stop, and reviews its axes in one round Open
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#887 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
ai-driven-dev/framework#873 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 85/100
ai-driven-dev/framework#872 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
ai-driven-dev/framework#625 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
ai-driven-dev/framework#467 · 1 comment ·
All issues in ai-driven-dev/framework
Similar issues
-
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
mksglu/context-mode#1200 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
jaegertracing/jaeger-ui#4506 ·
-
area:desktop area:ui bug platform:macos
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
anthropics/claude-code#96687 ·
-
good first issue
Difficulty 1/5 Under an hour Newbie friendliness 95/100
AOSSIE-Org/DebateAI#582 · 2 comments ·