docs(readme): beta.6 ai + telemetry README pass (shipped surface, one-vocabulary)#610
Merged
Conversation
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01WVCH2JZKKMDJU3A7jxDxPo
rickylabs
added
area:plugin-ai
area:telemetry
priority:p1
rickylabs
marked this pull request as ready for review
July 11, 2026 07:28
This was referenced Jul 11, 2026
Merged
Merged
rickylabs
added a commit
that referenced
this pull request
Jul 11, 2026
…h:false claims (#448) (#647) Fills the AI pillar for the beta.7 docs cut (D9): - ai/index.md: story-template pass — layered stack pitch, two-planes law, engine-as-design-center, one factual comparison (Medusa/Convex), MCP card, and a beta.7-shipped callout replacing the beta.2-pending state. - ai/mcp.md: fills the #433 stub — MCP *client* stack story (transports, injected auth, multi-server pool, ui:// safe render path), one factual Encore-server comparison, explicit "client, not server" non-claim. - ai/engine.md: replaced "Available from 0.0.1-beta.2 / not published" callout with the published beta.7 state; rewrote "Generated runtime registries" as direct registry wiring + a caveated "generate ai not shipped" note (shipped targets: plugins, runtime-schemas, aspire). - ai/durable-chat.md: dropped the stale "[beta.2 engine]" framing; pinned the JSR line to @netscript/fresh@0.0.1-beta.7. Every present-tense symbol claim traces to deno doc of the published @netscript/ai@0.0.1-beta.7 surface (gate satisfied) or the PR #610 READMEs. Grep clean for beta.2/publish:false and positioning-law forbidden patterns across the pillar. deno task verify green (build + check:links + check:caveats). Refs #448 Claude-Session: https://claude.ai/code/session_01DiTbVL2p3zLYc9AxxpK8iG Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
rickylabs
added a commit
that referenced
this pull request
Jul 11, 2026
…ery read side (#445) (#649) Reframe the observability pillar around the build-efficiency law: the verification turn ("did the change work across every process?") is the expensive turn, and NetScript closes it inside the framework. telemetry.md: - elevator-pitch intro (verification-turn / agent self-verify framing) - "one grouped trace" story spine (Flow-B: trigger → scheduler → queue → job.execute → SDK rpc.client callback; createFanInLinks span links; gate-enforced; gen_ai.* for AI turns) - telemetry ports/adapters + #402 attribute convention mechanism paragraph - service/RPC/HTTP tracing: registerORPCInstrumentation + first-party createHonoTracingMiddleware - new "Close the loop" section: typed TelemetryQueryPort read side + the single factual Encore comparison (MCP trace access vs in-language port) index.md: pitch-led intro, "read a trace back in code" next-step, convention link. All present-tense API claims trace to deno doc (query.ts/orpc.ts) + canonical README (PR #610); published beta.7 surface only. deno task verify green (build + 23019 links resolve + 27 caveats resolve). Refs #445 Claude-Session: https://claude.ai/code/session_01DiTbVL2p3zLYc9AxxpK8iG Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
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
1 participant
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
Single-pass README alignment for everything beta.6 touched, with
deno docas ground truth (shipped surface only):packages/telemetry(ports/adapters, all subpaths incl. new./hono, [telemetry T1] Framework telemetry convention (TC-1..14) + attribute-namespacing law #402 convention split, fan-in span links / Flow-B,AspireTelemetryQuery) andpackages/ai(agent-loop telemetry via injected port withgen_ai.*spans,./mcptransport pool +uiResources, providers,RenderUiToolInputseam)../ai/render-ui+ McpUiWidget +ui:add ai), plugins/workers (recordSharedWorkerMetrics), plugin-ai-core + plugins/ai (consistent client-side-MCP/telemetry-port vocabulary, no scaffolded-MCP-server claims).Refs #609, #601. Markdown-only; no source changes.
Validation
doc:lintclean forpackages/telemetryandpackages/aideno fmt --checkclean on all 10 touched READMEsdeno doc/ source before mention; JSR publish state respected (no unpublished-version install claims)Lane
Claude (Fable 5 low) documentation lane under the CLAUDE.md documentation-authoring exception; supervised by orchestrator
fb43bc3e, Tier-A reviewed.