Initial Commit

openspec/archive/2026-05-23-enterprise-audio-fingerprint-python/tasks.md

@@ -0,0 +1,64 @@
+# 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`