# Tasks — Migrate `suaveplan-audio-fingerprint` (Python tier) into genesis

> Every checkbox MUST reflect work actually done in this change.

## 0. Pre-flight (non-negotiable)

- [x] 0.1 Confirm clean working tree (`git status` reports nothing) and worktrees accounted for
- [x] 0.2 No stale `.claude/worktrees/` to prune (single agent worktree, this one)
- [x] 0.3 MANIFEST.md regenerated after package landing (step 7.3)

## 1. Spec authoring

- [x] 1.1 Read upstream source `/mnt/s/web/suaveplan/packages/python/audio-fingerprint/` end-to-end
- [x] 1.2 No existing `openspec/specs/audio-fingerprint/spec.md` to read
- [x] 1.3 Read `openspec/AGENTS.md` sections 0–14
- [x] 1.4 Draft `proposal.md`
- [x] 1.5 Fill in `## Source mapping` table
- [x] 1.6 Draft `specs/audio-fingerprint/spec.md`
- [x] 1.7 Every requirement carries `**Verified by:**`

## 2. Implementation (Python)

- [x] 2.1 `src/fingerprint.py` — `AudioFingerprinter` (chromagram, peak detection, constellation hashing, file pipeline, Jaccard matching)
- [x] 2.2 `src/__init__.py` — package marker
- [x] 2.3 `src/api/__init__.py` — re-exports `app`
- [x] 2.4 `src/api/app.py` — FastAPI app with `/`, `/fingerprint`, `/match`, CORS for localhost dev origins

## 3. Implementation (TypeScript bridge)

- [x] 3.1 `src/types/audio-fingerprint.types.ts` — all request/response/config interfaces
- [x] 3.2 `src/client/python-audio-service.ts` — `PythonAudioService` HTTP client
- [x] 3.3 `src/client/index.ts` — explicit named re-export of the client class
- [x] 3.4 `src/types/index.ts` — explicit named type re-exports
- [x] 3.5 `src/index.ts` — package root barrel with explicit named re-exports

## 4. Tests

- [x] 4.1 `tests/test_fingerprint.py` — covers every scenario in the spec delta
- [x] 4.2 `tests/test_api.py` — covers every FastAPI scenario including failure paths
- [x] 4.3 `tests/python-audio-service.test.ts` — covers every TS client scenario
- [x] 4.4 `tests/exports.test.ts` — pins barrel + subpath re-export contract
- [x] 4.5 Every `it(...)` carries `{ timeout: 5000 }` (or 30000 for genuinely async)

## 5. Documentation

- [x] 5.1 Sibling `.md` for every `.ts` source file (`fingerprint-types.md`, `python-audio-service.md`)
- [x] 5.2 `README.md` linking every co-located `.md` under `## Modules`
- [x] 5.3 Sibling `.md` for the two Python implementation files (`fingerprint.md`, `app.md`)

## 6. Pre-archive verification

- [x] 6.1 `pyproject.toml` configures `pytest --cov=src --cov-branch --cov-fail-under=100`
- [x] 6.2 `bunx turbo lint typecheck test --filter=@suaveplan/audio-fingerprint` — green
- [x] 6.3 `bunx turbo test:coverage --filter=@suaveplan/audio-fingerprint` — 100/100/100/100
- [x] 6.4 `micromamba run -n suaveplan-audio-fingerprint pytest --cov=src --cov-branch --cov-fail-under=100` — exits 0
- [x] 6.5 No `// biome-ignore`, no `console.log`, no `any`, no `.skip`, no TODO/FIXME in TS source
- [x] 6.6 No direct `from "vitest"` / `from "bun:test"` imports in tests
- [x] 6.7 Python turbo task not currently wired — documented as follow-up in the migration report; `pytest` is invoked standalone via micromamba

## 7. Archive

- [x] 7.1 Fold `specs/audio-fingerprint/spec.md` into `openspec/specs/audio-fingerprint/spec.md`
- [x] 7.2 Move `openspec/changes/enterprise-audio-fingerprint-python/` → `openspec/archive/2026-05-23-enterprise-audio-fingerprint-python/`
- [x] 7.3 Refresh `MANIFEST.md`