feat: US-005 - Create docgen-api-002: Cilium eBPF map API reference

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: LoCoBench Bot

benchmarks/ccb_docgen/docgen-api-002/environment/Dockerfile

@@ -0,0 +1,19 @@
+FROM ubuntu:22.04
+
+RUN apt-get update && apt-get install -y \
+    git \
+    python3 \
+    && rm -rf /var/lib/apt/lists/*
+
+WORKDIR /workspace
+
+# Clone Cilium at specific commit (main 2026-02-16)
+RUN git clone --filter=blob:none --no-checkout https://github.com/cilium/cilium.git repo && \
+    cd repo && \
+    git checkout ad6b298dbdcb9b828a247c54a477a9cfa43eff00 && \
+    git sparse-checkout init --cone && \
+    git sparse-checkout set pkg/bpf pkg/maps pkg/datapath/maps && \
+    git checkout
+
+# Agent writes documentation.md to /workspace/
+# Verifier: /tests/test.sh scores against /tests/ground_truth.json

benchmarks/ccb_docgen/docgen-api-002/instruction.md

@@ -0,0 +1,74 @@
+# Task: Document Cilium eBPF Map API
+
+## Objective
+
+Generate comprehensive API reference documentation for Cilium's eBPF map API in the `pkg/bpf` package. The documentation should serve as a complete reference for developers working with eBPF maps in Cilium.
+
+## Scope
+
+Focus on the Go wrappers in `pkg/bpf` that provide user-space interaction with kernel eBPF maps. Document:
+
+1. **Core Map Type and Creation**
+   - `Map` struct and its primary methods
+   - Map creation functions (`NewMap`, `OpenMap`, `OpenOrCreate`)
+   - Map lifecycle operations (Open, Create, Close, Recreate)
+
+2. **CRUD Operations**
+   - Lookup, Update, Delete operations
+   - Batch operations (BatchLookup, DeleteAll)
+   - Per-CPU map operations
+   - Locked operations (DeleteLocked)
+
+3. **Iteration and Dumping**
+   - Dump methods and callbacks
+   - BatchIterator type and usage
+   - DumpStats for tracking iteration
+
+4. **Pinning and Persistence**
+   - Pin/Unpin operations
+   - BPF filesystem paths (BPFFSRoot, CiliumPath, MapPath)
+   - Map persistence behavior
+
+5. **Key/Value Interfaces**
+   - MapKey, MapValue, MapPerCPUValue interfaces
+   - EndpointKey as concrete example
+
+6. **Event System**
+   - Event types (MapUpdate, MapDelete)
+   - DumpAndSubscribe for event streaming
+   - Event callbacks and handles
+
+7. **Collection Loading**
+   - LoadCollection and LoadAndAssign functions
+   - CollectionOptions
+
+## Requirements
+
+Your documentation must include:
+
+1. **API Method Signatures**: Complete signatures with parameter types and return values
+2. **Behavioral Semantics**:
+   - When maps are pinned vs unpinned
+   - Difference between Create() and CreateUnpinned()
+   - OpenOrCreate() behavior on existing maps
+   - How deletion works within DumpCallback (requires DeleteLocked)
+   - Event subscription lifecycle
+   - Batch iterator retry behavior on ENOSPC
+3. **Usage Examples**: Code snippets showing:
+   - Basic map creation and CRUD
+   - Iteration with BatchIterator
+   - Event subscription and cleanup
+   - Pinning and unpinning maps
+   - Real-world patterns from Cilium internals
+4. **Documentation Structure**: Organize clearly with sections for each category above
+
+## Output Format
+
+Write your documentation to `/workspace/documentation.md` in Markdown format.
+
+## Constraints
+
+- Do NOT include file paths or specific implementation locations in the documentation
+- Focus on API contracts and behavior, not internal implementation details
+- Include enough behavioral detail that users can correctly use the API without reading source code
+- Provide accurate examples that would compile and work correctly

benchmarks/ccb_docgen/docgen-api-002/task.toml

@@ -0,0 +1,11 @@
+[task]
+category = "api_reference"
+name = "docgen-api-002"
+description = "Generate API reference documentation for Cilium's eBPF map API covering map types, CRUD operations, pinning, and lifecycle management"
+language = "go"
+difficulty = "hard"
+time_limit_sec = 1200
+
+[metadata]
+output_format = "/workspace/documentation.md"
+repo = "cilium/cilium"