hf2vespa 0.1.0__tar.gz

hf2vespa-0.1.0/.github/workflows/benchmark.yml

@@ -0,0 +1,79 @@
+# Benchmark workflow for hf-vespa-feed
+# Runs on version tags, publishes results to GitHub Pages, fails on 10% regression
+#
+# SETUP REQUIRED (one-time):
+# 1. Create orphan gh-pages branch:
+#    git checkout --orphan gh-pages
+#    git reset --hard
+#    git commit --allow-empty -m "Initialize gh-pages"
+#    git push origin gh-pages
+#    git checkout master
+#
+# 2. Enable GitHub Pages in repo settings:
+#    Settings -> Pages -> Source: "Deploy from a branch"
+#    Branch: gh-pages, folder: / (root)
+#
+# 3. Ensure GITHUB_TOKEN has write permissions:
+#    Settings -> Actions -> General -> Workflow permissions
+#    Select "Read and write permissions"
+#
+# Results will be visible at: https://<username>.github.io/<repo>/dev/bench/
+
+name: Benchmark
+
+on:
+  push:
+    tags:
+      - 'v*'  # Run on version tags only (e.g., v0.2.0, v1.0.0)
+  workflow_dispatch:  # Allow manual trigger for testing
+
+permissions:
+  contents: write
+  deployments: write
+
+jobs:
+  benchmark:
+    name: Run Benchmarks
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run benchmarks
+        run: |
+          pytest tests/benchmarks/ \
+            --benchmark-enable \
+            --benchmark-only \
+            --benchmark-json=benchmark-results.json \
+            --benchmark-min-rounds=5 \
+            --benchmark-warmup=on \
+            -v
+
+      - name: Store benchmark result
+        uses: benchmark-action/github-action-benchmark@v1
+        with:
+          name: 'Converter Benchmarks'
+          tool: 'pytest'
+          output-file-path: benchmark-results.json
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          auto-push: true
+          # Alert threshold: 110% means 10% slower triggers alert
+          alert-threshold: '110%'
+          # Fail the workflow if benchmark regresses by more than 10%
+          fail-on-alert: true
+          # Comment on commits that cause alerts
+          comment-on-alert: true
+          # Summary comment shows comparison with previous
+          summary-always: true

hf2vespa-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,35 @@
+name: Release
+
+on:
+  push:
+    tags:
+      # Publish on any tag starting with a `v`, e.g., v1.2.3
+      - v*
+
+jobs:
+  pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    # Environment and permissions trusted publishing.
+    environment:
+      # Create this environment in the GitHub repository under Settings -> Environments
+      name: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+      - name: Install Python 3.13
+        run: uv python install 3.13
+      - name: Build
+        run: uv build
+      # Check that basic features work and we didn't miss to include crucial files
+      - name: Smoke test (wheel)
+        run: uv run --isolated --no-project --with dist/*.whl python tests/smoke_test.py
+      - name: Smoke test (source distribution)
+        run: uv run --isolated --no-project --with dist/*.tar.gz python tests/smoke_test.py
+      - name: Publish
+        run: uv publish

hf2vespa-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,31 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Install Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest

hf2vespa-0.1.0/.gitignore

@@ -0,0 +1,51 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Package managers
+uv.lock
+pip-log.txt
+
+# Local test files
+vespa-config.yaml
+vespa-llms.txt
+
+# OS
+.DS_Store
+Thumbs.db

hf2vespa-0.1.0/.planning/MILESTONES.md

@@ -0,0 +1,86 @@
+# Project Milestones: hf-vespa-feed
+
+## v2.0 Vespa Types (Shipped: 2026-02-03)
+
+**Delivered:** Complete Vespa type coverage with hex tensor encoding, sparse/mixed tensors, scalar types, and comprehensive benchmarking infrastructure.
+
+**Phases completed:** 8-11 (9 plans total)
+
+**Key accomplishments:**
+
+- Hex-encoded tensors (int8, bfloat16, float32, float64) with IEEE 754 compliance
+- Sparse tensor support (Vespa cells notation) for term weights
+- Mixed tensor support (blocks notation) for ColBERT-style multi-vector embeddings
+- Position, weighted set, and map scalar type converters
+- 165 tests including Vespa doc-verified correctness and round-trip validation
+- Benchmark infrastructure with 52 tests and GitHub Actions CI with 10% regression detection
+- Comprehensive type reference documentation with 8 cookbook examples
+
+**Stats:**
+
+- 1,788 lines of Python source
+- 1,899 lines of Python tests
+- 778-line README with full type documentation
+- 4 phases, 9 plans
+- Same day completion (2026-02-03)
+
+**Git range:** `feat(08-01)` → `docs(v2.0)`
+
+**What's next:** v3 features (field concatenation, row filtering, DuckDB SQL integration) based on user feedback.
+
+---
+
+## v1.1 User Experience (Shipped: 2026-02-03)
+
+**Delivered:** Config bootstrapping, shell completion, comprehensive documentation, and performance optimizations for better developer experience.
+
+**Phases completed:** 4-7 (7 plans total)
+
+**Key accomplishments:**
+
+- `hf-vespa-feed init <dataset>` generates YAML config from HuggingFace schema with type suggestions
+- `hf-vespa-feed install-completion` adds shell tab completion (bash/zsh/fish)
+- 527-line README with installation guide, CLI reference, and 5-example cookbook
+- Troubleshooting guide for common issues (auth, memory, type errors)
+- `--num-workers` CLI flag for parallel dataset loading (default: CPU count)
+- lru_cache on converter lookups for faster type conversions
+
+**Stats:**
+
+- 1,332 lines of Python
+- 4 phases, 7 plans
+- 2 days from v1.0 to v1.1 ship
+
+**Git range:** `feat(04-01)` → `docs(07)`
+
+**What's next:** Consider v2 features (field concatenation, row filtering, DuckDB integration) based on user feedback.
+
+---
+
+## v1.0 MVP (Shipped: 2026-02-02)
+
+**Delivered:** Production-ready CLI tool for streaming HuggingFace datasets to Vespa JSON feed format with YAML config, type conversions, and error handling.
+
+**Phases completed:** 1-3 (6 plans total)
+
+**Key accomplishments:**
+
+- Streaming CLI tool (`hf-vespa-feed`) with O(1) memory usage
+- Column filtering, renaming, and auto-increment document IDs
+- YAML config support with type conversions (list → tensor)
+- Custom document IDs from dataset columns
+- Error handling modes (`--on-error=fail/skip`) with row-level diagnostics
+- Progress bar and completion statistics with throughput
+
+**Stats:**
+
+- 38 files created/modified
+- 782 lines of Python
+- 3 phases, 6 plans
+- 1 day from start to ship
+
+**Git range:** `bf70cf1` → `7e3b276`
+
+**What's next:** Consider v2 features (field concatenation, row filtering, DuckDB integration) based on user feedback.
+
+---

hf2vespa-0.1.0/.planning/PROJECT.md

@@ -0,0 +1,134 @@
+# hf-vespa-feed
+
+## What This Is
+
+A CLI tool that streams Hugging Face datasets into Vespa's JSON feed format with comprehensive type support. Designed for processing millions of rows efficiently with support for hex-encoded tensors, sparse/mixed tensors, and scalar types. Users define field mappings via YAML config or CLI args, and pipe output directly to `vespa feed -`.
+
+## Core Value
+
+Fast, memory-efficient streaming of HF datasets to Vespa without intermediate files or full dataset loading.
+
+## Current State
+
+**Shipped:** v2.0 (2026-02-03)
+**Source code:** 1,788 lines Python
+**Tests:** 1,899 lines Python (165 tests)
+**Documentation:** 778-line README with type reference
+**Tech stack:** Python 3.10+, typer, datasets, orjson, pydantic, tqdm, ruamel.yaml, pytest-benchmark
+
+## v2.0 Delivered
+
+**Hex Tensor Encoding:**
+- int8, bfloat16, float32, float64 with IEEE 754 compliance
+- Range validation with row-level error context
+
+**Sparse and Mixed Tensors:**
+- Sparse tensor (Vespa cells notation) for term weights
+- Mixed tensor (blocks notation) for ColBERT-style multi-vectors
+- Mixed tensor hex with configurable cell types
+
+**Scalar Types:**
+- Position (geo coordinates with range validation)
+- Weighted set (key-weight pairs)
+- Map (key-value pairs with key stringification)
+
+**Testing Infrastructure:**
+- Vespa doc-verified correctness tests
+- Round-trip byte pattern validation
+- 52 benchmark tests with GitHub Actions CI
+
+## Current Milestone: v2.1 Clean Exit
+
+**Goal:** Fix the "Bad file descriptor" error that appears after successful processing.
+
+**Bug:** After processing completes, users see ugly error messages from HuggingFace's HTTP retry logic even though the process exits successfully. This is confusing and unprofessional.
+
+**Root cause:** The `_cleanup_hf_resources()` function calls `close_session()` which triggers cleanup of HTTP connections in a bad state, causing the error to be printed before `os._exit()` runs.
+
+**Fix approach:**
+1. Suppress HuggingFace HTTP logger at module startup
+2. Remove counterproductive `close_session()` call from cleanup
+
+## Requirements
+
+### Validated
+
+- ✓ Stream HF dataset to Vespa JSON feed format — v1.0
+- ✓ Config-driven field mapping (YAML file or CLI args) — v1.0
+- ✓ Column selection (include only specified columns) — v1.0
+- ✓ Column renaming (HF column → Vespa field name) — v1.0
+- ✓ Type conversion (list → tensor format) — v1.0
+- ✓ Auto-increment document ID — v1.0
+- ✓ Document ID from dataset column — v1.0
+- ✓ Configurable namespace and doctype — v1.0
+- ✓ `--limit N` flag for preview — v1.0
+- ✓ Configurable error handling (fail/skip) — v1.0
+- ✓ Progress indicators and completion statistics — v1.0
+- ✓ Use HF cache (no re-download) — v1.0
+- ✓ Graceful SIGPIPE handling — v1.0
+- ✓ Config bootstrapping from dataset inspection — v1.1
+- ✓ Shell completion installation command — v1.1
+- ✓ Comprehensive README with usage guide and cookbook — v1.1
+- ✓ --num-workers flag for parallel loading — v1.1
+- ✓ Converter caching with lru_cache — v1.1
+- ✓ Hex tensor encoding (int8, bfloat16, float32, float64) — v2.0
+- ✓ Sparse tensor format support — v2.0
+- ✓ Mixed tensor format support — v2.0
+- ✓ Position (geo) type conversion — v2.0
+- ✓ Weighted set type conversion — v2.0
+- ✓ Map type conversion — v2.0
+- ✓ Throughput benchmarking with pytest-benchmark — v2.0
+- ✓ Correctness tests based on Vespa docs examples — v2.0
+
+### Active
+
+- [ ] Clean exit without "Bad file descriptor" error message — v2.1
+- [ ] No visible warnings from HF/PyArrow cleanup on exit — v2.1
+
+### Out of Scope
+
+- Field concatenation — defer to v3
+- Row filtering — defer to v3
+- Default values for missing fields — defer to v3
+- DuckDB integration — defer to v3
+- GUI or web interface — CLI-only tool
+
+## Context
+
+- Target users work with large HF datasets (millions of rows) and Vespa search infrastructure
+- HF datasets library uses Arrow backend, enabling memory-mapped streaming
+- Vespa feed CLI handles progress display, so this tool outputs clean JSON only
+- Vespa document JSON format: `{"put": "id:ns:type::id", "fields": {...}}`
+- HF datasets are cached locally by the library, avoiding redundant downloads
+
+## Constraints
+
+- **Language**: Python — HF datasets library is Python-native, and streaming/Arrow integration is mature
+- **Memory**: Must stream, not load entire dataset — millions of rows won't fit in memory
+- **Output**: Valid JSONL that `vespa feed -` accepts without modification
+- **Dependencies**: Minimize — HF datasets, PyYAML for config, standard library otherwise
+
+## Key Decisions
+
+| Decision | Rationale | Outcome |
+|----------|-----------|---------|
+| Pure HF datasets (no DuckDB for v1) | Simpler architecture, HF handles column ops natively | ✓ Good |
+| YAML config format | Readable, supports nested field definitions | ✓ Good |
+| Default ID format `id:doc:doc::N` | Common pattern, namespace/doctype configurable | ✓ Good |
+| Error handling as CLI flag | Different use cases need different behavior | ✓ Good |
+| Source layout (src/) | Modern Python packaging best practice | ✓ Good |
+| Registry pattern for type converters | Extensible design for future converters | ✓ Good |
+| TTY-aware progress bar | Prevents progress bar from corrupting piped output | ✓ Good |
+| 1-based row numbering in errors | More user-friendly for debugging | ✓ Good |
+| ruamel.yaml for YAML generation | Only library supporting comments in output | ✓ Good |
+| Explicit install-completion command | Cleaner UX than Typer's default flag | ✓ Good |
+| Cache function lookups not results | Prevents memory exhaustion with diverse inputs | ✓ Good |
+| Accept num_workers but document streaming limitation | HuggingFace limitation, reserved for future | ✓ Good |
+| Int8 validates range before struct.pack | Clear error messages with index/row context | ✓ Good |
+| Bfloat16 truncates (not rounds) precision | Matches IEEE 754 bfloat16 behavior | ✓ Good |
+| Sparse tensor uses Vespa cells notation | Standard format for single mapped dimension | ✓ Good |
+| Mixed tensor blocks reuse hex encoders | Consistent encoding, no code duplication | ✓ Good |
+| 10% benchmark regression threshold | Catches regressions without false positives | ✓ Good |
+
+---
+*Last updated: 2026-02-03 after v2.1 milestone started*

hf2vespa-0.1.0/.planning/REQUIREMENTS.md

@@ -0,0 +1,47 @@
+# Requirements: hf-vespa-feed
+
+**Defined:** 2026-02-03
+**Core Value:** Fast, memory-efficient streaming of HF datasets to Vespa without intermediate files or full dataset loading.
+
+## v2.1 Requirements
+
+Bug fix release for clean exit behavior.
+
+### Clean Exit
+
+- [x] **EXIT-01**: No "Bad file descriptor" error message after successful processing
+- [x] **EXIT-02**: No visible warnings from HF/PyArrow cleanup on exit
+- [x] **EXIT-03**: Process exits with code 0 after successful processing (unchanged)
+- [x] **EXIT-04**: New test `test_feed_does_not_hang_on_exit` created and passes
+
+## Out of Scope
+
+Explicitly excluded from v2.1. Documented to prevent scope creep.
+
+| Feature | Reason |
+|---------|--------|
+| Field concatenation | Defer to v3 — feature work, not bug fix |
+| Row filtering | Defer to v3 — feature work, not bug fix |
+| Default values | Defer to v3 — feature work, not bug fix |
+| DuckDB integration | Defer to v3 — feature work, not bug fix |
+| Performance optimization | Not needed — exit cleanup is fast enough |
+
+## Traceability
+
+Which phases cover which requirements.
+
+| Requirement | Phase | Status |
+|-------------|-------|--------|
+| EXIT-01 | Phase 12 | Complete |
+| EXIT-02 | Phase 12 | Complete |
+| EXIT-03 | Phase 12 | Complete |
+| EXIT-04 | Phase 12 | Complete |
+
+**Coverage:**
+- v2.1 requirements: 4 total
+- Mapped to phases: 4
+- Unmapped: 0 ✓
+
+---
+*Requirements defined: 2026-02-03*
+*Last updated: 2026-02-03 after phase 12 complete*

hf2vespa-0.1.0/.planning/ROADMAP.md

@@ -0,0 +1,91 @@
+# Roadmap: hf-vespa-feed
+
+## Milestones
+
+- **v1.0 MVP** — Phases 1-3 (shipped 2026-02-02)
+- **v1.1 User Experience** — Phases 4-7 (shipped 2026-02-03)
+- **v2.0 Vespa Types** — Phases 8-11 (shipped 2026-02-03)
+- **v2.1 Clean Exit** — Phase 12 (active)
+
+## Phases
+
+<details>
+<summary>v1.0 MVP (Phases 1-3) — SHIPPED 2026-02-02</summary>
+
+- [x] Phase 1: Foundation (2/2 plans) — completed 2026-02-02
+- [x] Phase 2: Core Streaming (2/2 plans) — completed 2026-02-02
+- [x] Phase 3: Configuration (2/2 plans) — completed 2026-02-02
+
+See: `.planning/milestones/v1.0-ROADMAP.md` (if exists)
+
+</details>
+
+<details>
+<summary>v1.1 User Experience (Phases 4-7) — SHIPPED 2026-02-03</summary>
+
+- [x] Phase 4: Init Command (1/1 plans) — completed 2026-02-02
+- [x] Phase 5: Shell Completion (1/1 plans) — completed 2026-02-03
+- [x] Phase 6: Documentation (3/3 plans) — completed 2026-02-03
+- [x] Phase 7: Performance (2/2 plans) — completed 2026-02-03
+
+See: `.planning/milestones/v1.1-ROADMAP.md`
+
+</details>
+
+<details>
+<summary>v2.0 Vespa Types (Phases 8-11) — SHIPPED 2026-02-03</summary>
+
+- [x] Phase 8: Scalar Types (1/1 plans) — completed 2026-02-03
+- [x] Phase 9: Dense Hex Encoding (2/2 plans) — completed 2026-02-03
+- [x] Phase 10: Sparse and Mixed Tensors (2/2 plans) — completed 2026-02-03
+- [x] Phase 11: Testing and Benchmarks (4/4 plans) — completed 2026-02-03
+
+See: `.planning/milestones/v2.0-ROADMAP.md`
+
+</details>
+
+### v2.1 Clean Exit (Phase 12) — COMPLETE
+
+- [x] Phase 12: Clean Exit (1/1 plans) — completed 2026-02-03
+
+**Phase 12: Clean Exit**
+
+**Goal:** Fix the "Bad file descriptor" error that appears after successful processing.
+
+**Requirements:** EXIT-01, EXIT-02, EXIT-03, EXIT-04
+
+**Success criteria:**
+1. Running `hf-vespa-feed ... --limit 1000 > /dev/null` shows no error messages on stderr (only progress bar and completion stats)
+2. Process exits with code 0
+3. No visible warnings from HF/PyArrow cleanup
+4. Existing test `test_feed_does_not_hang_on_exit` passes
+
+**Implementation approach (from research):**
+1. Add `logging.getLogger('huggingface_hub.utils._http').setLevel(logging.CRITICAL)` at module top of cli.py
+2. Remove `close_session()` call from `_cleanup_hf_resources()` — it triggers the error and isn't needed since `os._exit()` follows
+3. Keep existing `os._exit()` — required to prevent hang from HF retry loop
+4. Update/fix the existing test to verify clean stderr output
+
+## Progress
+
+**Execution Order:**
+Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7 -> 8 -> 9 -> 10 -> 11 -> 12
+
+| Phase | Milestone | Plans Complete | Status | Completed |
+|-------|-----------|----------------|--------|-----------|
+| 1. Foundation | v1.0 | 2/2 | Complete | 2026-02-02 |
+| 2. Core Streaming | v1.0 | 2/2 | Complete | 2026-02-02 |
+| 3. Configuration | v1.0 | 2/2 | Complete | 2026-02-02 |
+| 4. Init Command | v1.1 | 1/1 | Complete | 2026-02-02 |
+| 5. Shell Completion | v1.1 | 1/1 | Complete | 2026-02-03 |
+| 6. Documentation | v1.1 | 3/3 | Complete | 2026-02-03 |
+| 7. Performance | v1.1 | 2/2 | Complete | 2026-02-03 |
+| 8. Scalar Types | v2.0 | 1/1 | Complete | 2026-02-03 |
+| 9. Dense Hex Encoding | v2.0 | 2/2 | Complete | 2026-02-03 |
+| 10. Sparse and Mixed Tensors | v2.0 | 2/2 | Complete | 2026-02-03 |
+| 11. Testing and Benchmarks | v2.0 | 4/4 | Complete | 2026-02-03 |
+| 12. Clean Exit | v2.1 | 1/1 | Complete | 2026-02-03 |
+
+---
+*Roadmap created: 2026-02-02*
+*Last updated: 2026-02-03 after phase 12 complete*

hf2vespa-0.1.0/.planning/STATE.md

@@ -0,0 +1,66 @@
+# Project State: hf-vespa-feed
+
+## Project Reference
+
+See: `.planning/PROJECT.md` (updated 2026-02-03)
+
+**Core value:** Fast, memory-efficient streaming of HF datasets to Vespa without intermediate files or full dataset loading.
+
+**Current focus:** v2.1 Clean Exit complete
+
+## Current Position
+
+Phase: 12 of 12 (clean-exit)
+Plan: 1 of 1
+Status: Phase complete
+Last activity: 2026-02-03 - Completed 12-01-PLAN.md
+
+```
+v1.0 [====================] 100% Shipped
+v1.1 [====================] 100% Shipped
+v2.0 [====================] 100% Shipped
+v2.1 [====================] 100% Complete
+```
+
+## Milestone History
+
+| Version | Name | Phases | Status | Shipped |
+|---------|------|--------|--------|---------|
+| v1.0 | MVP | 1-3 | Shipped | 2026-02-02 |
+| v1.1 | User Experience | 4-7 | Shipped | 2026-02-03 |
+| v2.0 | Vespa Types | 8-11 | Shipped | 2026-02-03 |
+| v2.1 | Clean Exit | 12 | Complete | 2026-02-03 |
+
+## v2.1 Results
+
+**Bug fixed:** The "Bad file descriptor" error no longer appears after successful processing.
+
+**Solution implemented:**
+1. Suppress HuggingFace HTTP logger at module startup
+2. Add `_cleanup_hf_resources()` function that sets `HF_HUB_OFFLINE` and forces GC
+3. Use `os._exit()` in `run()` to skip Python cleanup that triggers PyArrow bug
+
+**Verification:**
+- All 177 tests pass
+- Manual test shows clean exit with no error messages
+- Exit code is 0
+
+## Accumulated Decisions
+
+| Phase | Decision | Rationale |
+|-------|----------|-----------|
+| 12-research | Remove close_session() call | Triggers the error, not needed since os._exit() follows |
+| 12-research | Suppress HF HTTP logger at startup | Prevents error message from any cleanup path |
+| 12-research | Keep os._exit() | Required to prevent hang from HF retry loop |
+| 12-01 | Set HF_HUB_OFFLINE before cleanup | Prevents HTTP retry loops during garbage collection |
+
+## Session Continuity
+
+Last session: 2026-02-03 13:52 UTC
+Stopped at: Completed 12-01-PLAN.md (v2.1 milestone complete)
+Resume file: None
+Next action: None - v2.1 milestone complete
+
+---
+*State initialized: 2026-02-01*
+*Last updated: 2026-02-03 after completing v2.1 Clean Exit milestone*

hf2vespa-0.1.0/.planning/config.json

@@ -0,0 +1,12 @@
+{
+  "mode": "yolo",
+  "depth": "quick",
+  "parallelization": true,
+  "commit_docs": true,
+  "model_profile": "balanced",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true
+  }
+}