Repository navigation
Add the Generalization roadmap: refactors toward the generality of the literature - #13
Merged
Merged
Conversation
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.
Adds
LMLRoadmaps/Generalization/, a roadmap of refactors of merged LMLExplore code. It restates existing developments in the generality that the amended Identification (#10), Bandits (#11) and ReinforcementLearning (#12) roadmaps specify. Each target is one PR that restates one development and keeps every result. This is the same design as the completed Refactors roadmap (Completed/Refactors/). Contributor PRs carryRoadmap: Generalization.Why. About fifty items of the three amended roadmaps say that a merged LMLExplore declaration becomes an instance or a corollary of a general form. Examples:
baiTaskwith a mean functional;runReturnwith a discount.Workers will not do these restatements on their own. They pick the next unmet item, and skip any item that a merged PR already covers. Most amended items already have a merged narrow version, so they look done, and new work keeps building on the narrow code. As targets of a roadmap of their own, the restatements become visible and ordered. A worker choosing between a target and an item it unblocks takes the target first. The Conventions also say that a merged narrow version does not cover a target, and that adding a general version beside the narrow one does not meet it.
Contents (only
LMLRoadmaps/Generalization/)Scope and relation to the other roadmaps.
IdentTask.comap, the model of all bandits) and 3.6 (Gaussian costs of half-spaces); ReinforcementLearning 0.6 and 8.1 (measurable ε-greedy policies).klucb/ucbFfrom KL-UCB for exponential families (Bandits 3),gaussianTS(Bandits 5.1), the Gaussian GLR thresholds (Identification 4.2), backward induction andEpisodicMDP.value_le_optValue(ReinforcementLearning 8.2, 8.4).Layer 0, generalizations that new work builds on (16 targets):
sphereTask.β n h; plug-in GLR statistics and Track-and-Stop for any estimator; forced exploration in event form.designOp V₀.runReturn γand onestateMarginal.Layer 1, consolidation (24 targets):
ν : (α → ℝ) → Kernel α ℝdisappears; successive rejects, median elimination and successive elimination through the phased-elimination constructor; transportation costs under per-arm divergence hypotheses, in three PRs; Gaussian costs with arm-dependent variances, in two PRs; one sample-complexity reduction for D- and C-tracking.V₀;dInffor exponential families.(1 − γκ)⁻¹;bellmanEvalOpthroughKernel.integralCLM, with Blackwell's argument proved once; PI/MPI rates from the abstract lemmas; discounted optimality for countable actions; the simulation lemma with a reward error.Layer 2, material Tau Ceti provides (4 targets). LMLExplore's overlap scan covers Mathlib only, so these duplicates went unflagged:
mgf_tilted_muland others);Completion checks and References.
Suggested.lean: the restated signatures where the signature is the point:baiTask ν mean,thresholdingTask ν mean γ, and the identity withcomap;IdentTask.glrtwith thresholds(n : ℕ) → Hist Unit α 𝓨 n → ℝ≥0∞, andisDeltaPAC_glrt;empCost;IsUniformSupwith the restated DP lemmas (order-unit form);exp4IXwithexp3,exp3IXandexp4as instances.General forms already suggested in the area files (Wald, event transfer, chain rule, pseudo-regret, time-varying FTRL,
designOp V₀,runReturn γ,stateMarginal,IsApproxGreedy) are cited by name, not repeated.Points to check
OnlineLearning/AdaHedge.leanto be stated once, inExponentialWeights.lean, and for both bounds to use them. This removes the duplicate telescoping. The stability term of 6.4 is AdaHedge's mixability gap.S ato the hypotheses of Identification 1.4 (continuity, zero exactly on the diagonal, monotone on each side), because the merged proofs useexpFamilyMeans_mem_nhds.MDP.abs_bellman_sub_lea corollary of theboundedMeasurablecontraction, as ReinforcementLearning 0.2 asks. The finite-action version for unbounded integrablevis lost; it has no users.SumRewards.leanfor real observations only. LML'shasLaw_rewardByCount_infinitePiis stated for real rewards, so observations in any𝓨stay with Identification 4.1. That item will restate the same statements once more, generalizing only the observation space.{t < τ}), not the "stopped martingale" proof that Identification 0.3 describes. Both are valid.Task/MeanVector.leantoTask/Classical.lean.weightedMeasureand Tau Ceti'scategoricalMeasure: not a duplicate (real vectors insimplexagainstStdSimplex); switching would be a design change.ContinuousLinearMap.leftInverse_ringInverse/rightInverse_ringInverse: more general than Tau Ceti's pointwise forms.integral_sub_sq_gaussianRealand others) that generalize Tau Ceti lemmas.Environment.bandit,Environment.evalSeqandEnvironment.feedbackKernel; the area READMEs andSuggested.leanfiles usestationaryEnv,onlineEvalEnvandenv.measure, from LMLRoadmaps' older pin.Suggested.leanexp4IXtakesadv : 𝓞 → β → α → ℝ, which a weight-based policy cannot use. Here it isadv : 𝓞 → β → simplex α, as in the mergedexp4.Bandits/StochasticMirrorDescent.lean, a user offtrl_regret_le; target 0.11 keeps that name.Bandits/AsymptoticOptimality.lean, where target 2.3 migratesisLittleO_sub_mul_of_tendsto_div.origin/main(bacf8f7), and the Tau Ceti and LML names at LMLExplore's pins. The claims about how existing proofs generalize come from reading the code; nothing was compiled.Suggested.leanbuilds.Drafted with Claude Opus 5.5 at the request of the code owner, from a target-by-target check of the merged code.
🤖 Generated with Claude Code