docs: point provenance to distinct model Git repository

README.md

@@ -17,6 +17,8 @@ tags:
 
 A provenance-locked binary `insect_present` specialist head over frozen 1,536-dimensional Google Perch 2 embeddings.
 
+This repository contains only the Perch 2 InsectNet lineage. The preserved BirdNET-logit InsectNet v0.1 model is a distinct project at [vortexpjeff/insectnet](https://github.com/vortexpjeff/insectnet) and is not an ancestor bundle, embedding source, or runtime dependency of this model.
+
 > **Status: public noncommercial research artifact; these exact checked JSON/NPZ bytes are privately deployed as a review-only field head.** A threshold crossing selects audio for human review. It is not a calibrated probability or a confirmed biological observation.
 
 This repository publishes the exact safe runtime bundle currently used by the `insectnet-dev2-field-probe` field head, plus sanitized aggregate provenance and challenge summaries. It contains no source audio, exact training manifest, coordinates, private observation locations, uploader identities, credentials, private paths, or arbitrary Python serialization.
@@ -125,6 +127,17 @@ The training matrix includes public permissive and noncommercial research lanes.
 
 ## Source
 
-- Source registry and tests: [https://github.com/vortexpjeff/insectnet](https://github.com/vortexpjeff/insectnet)
-- Tagged release tree: [insectnet-research-0.3.0-perch2](https://github.com/vortexpjeff/insectnet/tree/insectnet-research-0.3.0-perch2)
+- Source registry and tests: [https://github.com/vortexpjeff/insectnet-perch2](https://github.com/vortexpjeff/insectnet-perch2)
+- Tagged release tree: [insectnet-research-0.3.0-perch2](https://github.com/vortexpjeff/insectnet-perch2/tree/insectnet-research-0.3.0-perch2)
 - Older public research ancestor: [TheVortexProject/insectnet-research-0.2.0-perch2](https://huggingface.co/TheVortexProject/insectnet-research-0.2.0-perch2)
+## Load the checked deployed bundle
+
+```python
+from pathlib import Path
+from insectnet_perch2.bundle import load_bundle, score_embedding
+
+bundle = load_bundle(Path('bundle'))
+raw_score, review_score = score_embedding(bundle, perch2_embedding)
+```
+
+The input is one finite 1,536-dimensional Perch 2 embedding. Do not feed BirdNET logits or waveforms directly into this head.

SHA256SUMS

@@ -1,8 +1,8 @@
-171cd0fcae65bc1470f473ee6ea0c285f69897e19fb6c3a4496a3be93e7b2592  README.md
+c16271324892f32fd8e165df1f24e15b07908def735f35a5a0de8c6fe531ad7a  README.md
 db885a4922b97b82c80031971e9ebb2638a02bd8893f9585cbe9a019db98399b  bundle/SHA256SUMS
 cacff9ab9f91686ab30b762dbbeae0030a55354c084a35354bbf6fed572eed5a  bundle/model.json
 a57b8eb341cce154d27b5cbcd33100b6abcb4a989e5f5d08d59855dd588c5d58  bundle/weights.npz
 cd7cd533389085715702281d9f0729ab6c21091eae8b8953833ce941a085f43e  release/challenge-summary.json
 71f177139a8d4e46c1a1b1cfe9ccb31cb5cbc438d718471376a7949f08989b79  release/deployed-threshold-replay.json
-36f58d9fff88b32fa51606be6791c989531c75660a384c1dd48df311c30eb712  release/release-manifest.json
+b9cb11954f136e0fdcd602aa3e4b60b0480717673964ff36f5516cb143ecf53d  release/release-manifest.json
 0f5233e081320ba318b5221101c027803f5e18c9e7dc1d24a49901aae15a2efc  release/training-summary.json

release/release-manifest.json

@@ -37,6 +37,6 @@
     "research_noncommercial_windows": 1960
   },
   "schema_version": 1,
-  "source_repository": "https://github.com/vortexpjeff/insectnet",
+  "source_repository": "https://github.com/vortexpjeff/insectnet-perch2",
   "source_tag": "insectnet-research-0.3.0-perch2"
 }