docs(examples): finish the DX-audit backlog — 5 examples polished, proven, simplified#430
Merged
Merged
Conversation
…oven, simplified Clears the remaining backlog from the examples DX audit (#428). Each fix verified (tc 0, lint clean; the offline-runnable ones run end-to-end $0). - intelligence-drop-in: the headline (OFF tier = $0 intelligence spend) was ASSERTED, never shown. Now the example records inference-only at OFF, flushes, and reads the exported span BACK off the collector to PROVE intelligence_usd=0 (throws otherwise). Dropped the confusing double-client ping ceremony; README rewritten to match (glosses Mode 0 / inference-vs-intelligence, adds a 'Going live' section). Runs $0. - strategy-suite: the authored doubleCheck was a near-clone of built-in refine. Rewrote it as a policy the built-ins DON'T have — require TWO consecutive passes before done (a flake/luck guard) — the real point of defineStrategy. Fixed the README (it listed 4 built-ins but the run compares 2). Runs $0. - agents-of-all-shapes: shipToTangleOtlp hand-rolled the OTLP resourceSpans envelope — the exact wire createOtelExporter produces (the primitive the example itself teaches). Routed it through createOtelExporter (~45 lines → ~25). Aligned npx→pnpm. Runs $0. - self-improving-loop: the n=3 'small-n mirage' warning was restated 4×; trimmed to one authoritative block (the⚠️ at the gate) + brief pointers. - agentic-data-creation: softened an unverifiable future-dated citation (arXiv 2606.25996 / 'Meta FAIR' / 'the paper's Table 1' with specific figures) stated as empirical fact → the real technique name (self-instruct, Wang et al. 2022) + 'illustrative target' framing for the by-construction numbers.
tangletools
approved these changes
Jul 1, 2026
tangletools
left a comment
Contributor
There was a problem hiding this comment.
✅ Auto-approved drewstone PR — 8703e398
This PR was opened by the trusted drewstone account.
The full PR reviewer audit still runs separately and will publish findings if it detects issues.
tangletools · auto-approval · reason: drewstone_author · 2026-07-01T05:24:54Z
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.
Clears the remaining backlog from the examples DX audit (#428). Each fix verified —
tsc0, lint clean, and the offline-runnable ones run end-to-end ($0).intelligence_usd=0(throws otherwise). Dropped the confusing double-client ceremony; README rewritten (glosses Mode 0, adds "Going live").doubleCheckwas a near-clone of built-inrefine. Rewrote it as a policy the built-ins don't have — require two consecutive passes before done (a flake guard) — the real point ofdefineStrategy. Fixed the README (listed 4 built-ins, ran 2).shipToTangleOtlphand-rolled the OTLP envelope — the exact wirecreateOtelExporterproduces (the primitive the example teaches). Routed throughcreateOtelExporter(45→25 lines). npx→pnpm.arXiv 2606.25996/ "Meta FAIR" / "the paper's Table 1" + specific figures) stated as fact → the real technique (self-instruct, Wang et al. 2022) + "illustrative target" framing.The key catch (senior detail)
intelligence-drop-in's original assertion would have failed if I'd naively "read the span back" —recordOutcomedoesn't clamp, so recordingintelligenceUsd: 0.05at OFF was itself wrong (OFF can't have intelligence cost). And the OTLP attribute isloop.tangle.usage.intelligence_usdwithintValue: "0"(string), nottangle.usage.intelligence_usd. Both found by actually running it and dumping the wire payload — not by assuming.Verification: src + examples typecheck 0; lint clean (359 files); intelligence-drop-in / strategy-suite / agents-of-all-shapes all run offline to exit 0.