|
173 | 173 | - Pass threshold for all docgen tasks: 0.7 overall score |
174 | 174 | - Ground truth covers 4 major Terraform v1.10 changes: S3 backend IAM role deprecation + native state locking, moved blocks syntax, sensitive marks in conditionals, ephemeral resources/values |
175 | 175 | --- |
| 176 | +## 2026-02-16 - US-008 |
| 177 | +- Created docgen-migration-002: Envoy External Processing (ext_proc) Filter Migration Guide (v1.30 → v1.31) |
| 178 | +- Files created: |
| 179 | + - benchmarks/ccb_docgen/docgen-migration-002/task.toml (category=migration_guide, language=cpp, difficulty=hard, time_limit_sec=1200) |
| 180 | + - benchmarks/ccb_docgen/docgen-migration-002/instruction.md (covers ext_proc filter: observability mode, new config fields, upstream filter support) |
| 181 | + - benchmarks/ccb_docgen/docgen-migration-002/tests/ground_truth.json (4 scoring categories: breaking_changes, migration_steps, code_examples, documentation_structure) |
| 182 | + - benchmarks/ccb_docgen/docgen-migration-002/tests/test.sh (copied from docgen-migration-001, generic Python-based verifier) |
| 183 | + - benchmarks/ccb_docgen/docgen-migration-002/environment/Dockerfile (git worktrees for v1.30.0 and v1.31.0) |
| 184 | +- Files modified: |
| 185 | + - configs/docgen_2config.sh (added docgen-migration-002 to ALL_TASK_IDS and TASK_SG_REPO_NAMES) |
| 186 | + - configs/selected_benchmark_tasks.json (registered task with mcp_benefit_score=0.880, total_selected: 197→198) |
| 187 | +- **Learnings for future iterations:** |
| 188 | + - Envoy v1.30.0 → v1.31.0 focus: ext_proc filter configuration changes (narrower scope than full xDS v2→v3 migration) |
| 189 | + - Used WebSearch and WebFetch to research Envoy release notes from official docs (v1.30.0 April 2024, v1.31.0 July 2024) |
| 190 | + - Found specific commits via WebFetch from GitHub releases: v1.30.0 (50ea83e602), v1.31.0 (7b8baff175) |
| 191 | + - Key breaking changes: observability_mode deprecates async_mode, HTTP/2 codec default change (oghttp2 → true), upstream filter chain support |
| 192 | + - Ground truth covers 5 breaking changes (observability mode, HTTP/2 codec, ProcessingMode, upstream filters, new config fields), 5 migration steps, 4 code examples |
| 193 | + - Same 4-category scoring as docgen-migration-001: breaking_changes (0.50), migration_steps (0.30), code_examples (0.15), documentation_structure (0.05) |
| 194 | + - MCP benefit score (0.880) reflects high cross_file_deps (0.93) and semantic_search_potential (0.94) for finding API changes across proto/impl |
| 195 | + - Weight validation critical: verified all category weights sum to 1.0 and top-level weights sum to 1.0 |
| 196 | + - Dockerfile pattern matches docgen-migration-001: git worktrees for two versions, remove main clone to save space |
| 197 | + - Ext_proc filter spans: api/envoy/extensions/filters/http/ext_proc/v3/ (proto), source/extensions/filters/http/ext_proc/ (impl), docs/root/configuration/http/http_filters/ext_proc_filter.rst (docs) |
| 198 | + - Migration tasks benefit most from MCP (task_category_weight=0.75) compared to API reference (0.70) and architecture (0.65) |
| 199 | +--- |
0 commit comments