File size: 3,711 Bytes
f7b909f
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
# Initial Commit Contents

This file defines the deployed contents of the lightweight ENCODE Space and its
separate private runtime-artifact bucket.

## Application and deployment

- `README.md` β€” project overview and Hugging Face Space metadata.
- `docs/ai/COMMIT_CONTENTS.md` β€” this auditable release inventory.
- `Dockerfile` β€” CPU-only backend container listening on port 7860.
- `netlify.toml` and `deploy/` β€” Netlify build/Drop package that proxies the
  static frontend's API requests to the Hugging Face Space backend.
- `.dockerignore` β€” excludes development-only files from container builds.
- `.gitignore` β€” excludes `data/` and the generated parts of `outputs/`.
- `src/requirements.txt` β€” pinned Python runtime dependencies.

## Backend

- `src/backend/app.py` β€” FastAPI application and HTTP endpoints.
- `src/backend/codesearch.py` β€” medical-code retrieval.
- `src/backend/retriever.py` β€” phenotype retrieval using Vidul's fine-tuned
  embeddings.
- `src/backend/encode.py` β€” annotation and response handling.
- `src/backend/graph.py` β€” phenotype detail graph construction.
- `src/backend/models.py` β€” registry of the retrieval models the UI may offer.
- `src/backend/rxnav.py` β€” conservative, cached RxNAV/RxNorm completion for
  medication mappings that are absent from packaged outputs.
- `src/backend/__init__.py` β€” backend package marker.

## Frontend

- `src/frontend/index.html` β€” browser application shell.
- `src/frontend/app.js` β€” search, review, and annotation behavior.
- `src/frontend/styles.css` β€” application styling.

## Private bucket: runtime model and indexes

- `outputs/models/bge_ft_va/` β€” Vidul's fine-tuned model weights, tokenizer,
  and configuration.
- `outputs/indexes/bge_ft_va/icd_index/` β€” diagnosis FAISS index and metadata.
- `outputs/indexes/bge_ft_va/med_index/` β€” medication FAISS index and metadata.
- `outputs/indexes/bge_ft_va/ndc_index/` β€” NDC FAISS index and metadata.
- `outputs/indexes/bge_ft_va/labchem_index/` β€” LOINC/lab FAISS index and metadata.
- `outputs/indexes/bge_ft_va/cpt_index/` β€” procedure FAISS index and metadata.
- `outputs/embeddings/bge_ft_va/code.npy`
- `outputs/embeddings/bge_ft_va/code_meta.json`
- `outputs/embeddings/bge_ft_va/config.json`
- `outputs/embeddings/bge_ft_va/metadata.npy`
- `outputs/embeddings/bge_ft_va/metadata_ids.json`

## Private bucket: runtime phenotype records

- `outputs/canonical/algorithm_components.jsonl`
- `outputs/canonical/canonical_phenotypes.jsonl`
- `outputs/canonical/cipher_links.jsonl`
- `outputs/canonical/code_descriptions.jsonl`
- `outputs/canonical/lab_loinc_map.jsonl`
- `outputs/canonical/loinc_terms.jsonl`
- `outputs/canonical/med_ingredient_map.jsonl`
- `outputs/canonical/rxcui_ingredient_map.jsonl`

## Verification

- `tests/test_retrieval.py` β€” focused tests for the retained dense-retrieval
  path.
- `tests/test_rxnav_and_deployment.py` β€” RxNAV provenance and Netlify Drop
  deployment checks.

## Explicitly excluded

Everything under `data/` (raw VA exports, the original application bundle, and
the LOINC and RxNorm distribution archives) and everything the pipeline writes to
`outputs/` β€” training, evaluation, reranker, facet, profiling, and cached
results, generated demos, and annotations β€” is excluded from the Space upload,
along with local environments, credentials, and editor settings.

The release contains one retrieval path: Vidul's fine-tuned model, prebuilt
embeddings, and exact dense search. Large runtime assets are stored in
`hf://buckets/hiasgnpsadgd/encode-artifacts` and mounted read-only at
`/home/user/app/outputs`; they are not committed to the Space repository or
copied into the Docker image.