Repository navigation
Conversation
Exercise published exports and native Mastra OTLP output at the peer floor and current versions. Keep the exporter and all existing public APIs intact. Co-Authored-By: Claude Code <noreply@anthropic.com>
This was referenced Oct 31, 2026
Document explicit projectName, then FI_PROJECT_NAME, then serviceName consistently in prose and the option reference. Retain executable README assertions for the precedence guidance. Co-Authored-By: Claude Code <noreply@anthropic.com>
Co-Authored-By: Claude Code <noreply@anthropic.com>
Contributor
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Keep
@traceai/mastra: it already integrates with Mastra's native observability exporter bus and official span converter. Replace the obsolete README examples rather than deleting the useful package.FiOTLPTraceExporter/isFiSpanimports, removedtelemetryconfiguration, and Phoenix credentials withcreateFIObservability./legacysubpath.The project default now consistently documents explicit
projectName, thenFI_PROJECT_NAME, thenserviceName. This environment precedence is restored by #529: ship these two PRs together, not the new default wording alone against the old runtime.No runtime APIs, implementation, package versions, or changelog sections change. Release-please should include this README correction in the next package release.
Reproduction
The published
@traceai/mastra@0.2.0README fails before initialization: its root module does not exportFiOTLPTraceExporterorisFiSpan. The same README contract rejects the old instructions with TS2305 (and the removedtelemetryconfiguration).Original published-package validation
Passed offline against published
@traceai/mastra@0.2.0:The contract compiles the actual README TypeScript, initializes its configuration, emits synthetic native Mastra parent/child spans, and decodes the actual localhost OTLP/protobuf request. It checks endpoint and FI headers, project/service resources, span kinds, input/output, parentage, exactly-once export, hidden I/O, and shutdown flushing. No model/vendor APIs or real credentials are used. Both documentation links return HTTP 200.
Compatibility boundaries discovered during verification:
excludeSpanTypes; the README calls this out and the floor test preserves that actual behavior.generateSignalIdmissing). The README therefore pins a matching current set rather than suggesting arbitrary minimum-version combinations.--force; npm still warns about upstream OTel peer ranges.This is an offline integration contract, not a claim of model-provider or Future AGI Cloud end-to-end validation. No merge, tag, or publication is requested by this PR.
Recall round-two validation
origin/devat7cb1d3e42d9e3f80f3f80dc51a87417acdeb0c67completed without conflicts. Full frozen workspace install, release-plan check (129 packages), post-merge README contracts andgit diff --checkpassed.🤖 Generated with Claude Code