Align historical baseline with living Perch 2 deployment

README.md

@@ -17,15 +17,20 @@ datasets:
 
 InsectNet v0.1.0 is a preserved research classifier for scoring insect- and amphibian-related acoustic classes from frozen BirdNET v2.4 output logits.
 
-This Hugging Face repository is the model-release mirror. The canonical source, tests, package, and GitHub Release are at [github.com/vortexpjeff/insectnet](https://github.com/vortexpjeff/insectnet).
+This repository preserves one canonical v0.1 release identity and also carries separately
+versioned Perch 2 research candidates. It does **not** publish live sensor addresses,
+deployment credentials, exact collection locations, private media, or an unattended
+capture service.
 
-This repository intentionally contains one model artifact and one release identity. It does **not** publish live sensor addresses, deployment credentials, exact collection locations, private media, or an unattended capture service.
+Public discovery and versioned downloads are organized in the
+[The Vortex Project — Multi-Taxa Bioacoustics](https://huggingface.co/collections/TheVortexProject/the-vortex-project-multi-taxa-bioacoustics-6a6d92a9e0938f507e931388)
+Hugging Face collection. GitHub remains the source, tests, and release-engineering surface.
 
 ## Release identity
 
 ```text
 Release:  insectnet-v0.1.0
-Artifact: classifier.joblib
+Artifact: src/insectnet/data/classifier.joblib
 SHA-256: 5e6ecfc68d78a2cf2e9e9e47da5cb58d696e8de354fd620cfcccc5db9da48702
 Bytes:    474,892
 Status:   historical research reference
@@ -72,10 +77,9 @@ The model file does not embed thresholds, a version number, or its original trai
 - device addresses or credentials;
 - exact collection locations;
 - raw or private field audio;
-- later experimental model candidates;
 - claims of production readiness.
 
-The original live sidecar diverged from the public v0.1 source during field experiments. That runtime is not republished here until it can be recovered, tested, and released under a separate reviewed version.
+The original v0.1 live sidecar diverged from this public source during early field experiments and is not a current deployment target. It has been superseded operationally by the separately versioned Perch 2 specialist architecture; the preserved v0.1 artifact remains a historical BirdNET-logit reference.
 
 ## Verify the preserved artifact
 
@@ -112,6 +116,34 @@ The command returns one probability per declared class. These scores are model a
 - The classifier relies on BirdNET logits and cannot score raw audio by itself.
 - There is no validated automated-decision threshold policy in this release.
 
+## Perch 2 research artifacts and field heads
+
+Three provenance-locked specialist lines were trained and audited in July 2026. None
+replaces the preserved BirdNET-logit v0.1 artifact. Each line has an explicit public
+research boundary and a separate operational status. FrogNet's public mirror contains
+the exact checked JSON/NPZ bundle used by its private review-only field head; the public
+InsectNet and ChickenNet research artifacts must not be conflated with later private
+field bundles.
+
+| Candidate | Status | Key external result |
+|---|---|---|
+| [ChickenNet Research 0.1.0](models/chickennet-research-0.1.0-perch2/MODEL_CARD.md) | frozen public joblib not deployed; later private JSON/NPZ successor operates as a review-only field head | 33/42 broad-head hits on a locked iNaturalist chicken challenge; 10/1,308 candidate activations on a private local confound set |
+| [InsectNet Research 0.2.0](models/insectnet-research-0.2.0-perch2/MODEL_CARD.md) | frozen public joblib not deployed; later private JSON/NPZ successor operates as a review-only field head | 11/26 broad activations on an untouched iNaturalist dog challenge |
+| [FrogNet Research 0.1.0](models/frognet-research-0.1.0-perch2/MODEL_CARD.md) | public noncommercial research artifact; exact strict bundle deployed privately for review | 1,253/1,308 local frog-window activations and 0/3,781 tested confound activations at threshold `0.95` |
+
+All three lines consume 1,536-dimensional Google Perch 2 embeddings from five-second,
+32 kHz mono windows. They include exact model/data hashes, grouped split reports,
+hierarchy contracts, source summaries, and challenge reports. They do not include Perch
+weights or source audio.
+
+## Training strategy
+
+[`docs/PERCH2_TRAINING_STRATEGY.md`](docs/PERCH2_TRAINING_STRATEGY.md) records the
+provenance-first design used for the Perch 2 specialist heads. The current FrogNet
+research and operational contract is frozen in [`docs/FROGNET_FIELD_PROBE.md`](docs/FROGNET_FIELD_PROBE.md).
+The dated architecture and artifact-versus-runtime boundary for all three living heads is
+recorded in [`docs/LIVING_DEPLOYMENT.md`](docs/LIVING_DEPLOYMENT.md).
+
 ## Provenance
 
 The surviving records identify these source families:
@@ -121,11 +153,11 @@ The surviving records identify these source families:
 - **iNaturalist audio:** licenses vary per recording; the original per-record manifest is unavailable.
 - **Private field negatives:** not redistributed.
 
-See [`PROVENANCE.md`](PROVENANCE.md) and the release manifest for the exact surviving claims and gaps.
+See [`docs/PROVENANCE.md`](docs/PROVENANCE.md) and the release manifest for the exact surviving claims and gaps.
 
 ## Privacy and security
 
-The public release intentionally omits exact collection location, network topology, account names, credentials, private paths, and raw evidence. See [`SECURITY_AND_PRIVACY.md`](SECURITY_AND_PRIVACY.md).
+The public release intentionally omits exact collection location, network topology, account names, credentials, private paths, and raw evidence. See [`docs/SECURITY_AND_PRIVACY.md`](docs/SECURITY_AND_PRIVACY.md).
 
 ## License