@cyanheads/college-scorecard-mcp-server 0.5.0 → 0.6.0

package/AGENTS.md

@@ -1,9 +1,9 @@
 # Developer Protocol
 
 **Server:** college-scorecard-mcp-server
-**Version:** 0.5.0
-**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.18`
-**Engines:** Bun ≥1.4.0, Node ≥24.0.0
+**Version:** 0.6.0
+**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.22`
+**Engines:** Bun ≥1.4.4, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/server` ^2.4.0
 **Zod:** ^4.6.7
 
@@ -185,6 +185,12 @@ Institution earnings cover federally aided undergraduate entrants working and no
 
 `readMetric` distinguishes numbers (including zero), unknown-cause null/absence, and explicit `PS` / `PrivacySuppressed` markers. Suppression flags/counts require the latter; unexpected values are provider contract failures. CIP lookup covers all current NCES CIP 2020 four-digit groups, with exact group/family titles and verified descendant aliases. Program search applies CIP × credential together upstream before school pagination; totals remain school-level.
 
+`src/data/repayment-context.ts` holds dictionary provenance for discontinued declining-balance rates and the separate two- and four-year undergraduate federal Direct Loan borrower statuses. The three-year declining-balance rate uses the 2016–17 file. Profiles and value analysis retain each borrower-status horizon's OPEID6 scope, denominator when available, and reported decimal or bin. Only point estimates carry numeric values. Unsupported status rates yield an unavailable value and a notice. Comparison ranks use the historical three-year rate.
+
+`school.operating` is current operating certification. Actual closure requires separate evidence. School search applies certification, HBCU, locale, price, and completion filters upstream before pagination. Use observed provider support for catalog sort flags, including unsortable pooled full-time retention projections.
+
+Program tool text leads with completion earnings and renders legacy highest-credential values separately. School comparison leaves descriptive metrics, singleton results, shared OPEID6 outcomes, and mixed price periods unranked. Negative dollar selectors normalize to zero with a notice. Earnings vintages deduplicate in caller order. Six-digit CIP lookup resolves to the four-digit group used by program selectors.
+
 ---
 
 ## Context
@@ -356,7 +362,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
 | `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
 | `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
 | `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
-| `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
+| `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity, `.mcpbignore` coverage, plugin manifests, the published `skills/` tree (run by devcheck) |
 | `bun run list-skills` | Print the skill registry |
 | `bun run tree` | Generate directory structure doc |
 | `bun run format` | Auto-fix formatting (safe fixes only) |
@@ -376,7 +382,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
 
 ## Bundling
 
-`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/`, `CLAUDE.md`, `AGENTS.md`, and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
+`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs — `framework-skills/`, `skills/`, `.claude/`, `.agents/`, `AGENTS.md`, and `CLAUDE.md` at a package's root, and `SKILL.md` anywhere (a `skills/` deeper in a package is runtime code and stays); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/`, and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
 
 **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
 
@@ -447,4 +453,6 @@ import { getMyService } from '@/services/my-domain/my-service.js';
 - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
 - [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
 - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
-- [ ] `npm run devcheck` passes
+- [ ] Any new root dev path has a root-anchored line in `.mcpbignore` and passes `bun run bundle` and `lint:packaging`
+- [ ] Field-test verified every gate and identifier claim in the published `skills/college-scorecard-guide` against live tool behavior
+- [ ] `bun run devcheck` passes

package/CLAUDE.md

@@ -1,9 +1,9 @@
 # Developer Protocol
 
 **Server:** college-scorecard-mcp-server
-**Version:** 0.5.0
-**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.18`
-**Engines:** Bun ≥1.4.0, Node ≥24.0.0
+**Version:** 0.6.0
+**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.22`
+**Engines:** Bun ≥1.4.4, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/server` ^2.4.0
 **Zod:** ^4.6.7
 
@@ -185,6 +185,12 @@ Institution earnings cover federally aided undergraduate entrants working and no
 
 `readMetric` distinguishes numbers (including zero), unknown-cause null/absence, and explicit `PS` / `PrivacySuppressed` markers. Suppression flags/counts require the latter; unexpected values are provider contract failures. CIP lookup covers all current NCES CIP 2020 four-digit groups, with exact group/family titles and verified descendant aliases. Program search applies CIP × credential together upstream before school pagination; totals remain school-level.
 
+`src/data/repayment-context.ts` holds dictionary provenance for discontinued declining-balance rates and the separate two- and four-year undergraduate federal Direct Loan borrower statuses. The three-year declining-balance rate uses the 2016–17 file. Profiles and value analysis retain each borrower-status horizon's OPEID6 scope, denominator when available, and reported decimal or bin. Only point estimates carry numeric values. Unsupported status rates yield an unavailable value and a notice. Comparison ranks use the historical three-year rate.
+
+`school.operating` is current operating certification. Actual closure requires separate evidence. School search applies certification, HBCU, locale, price, and completion filters upstream before pagination. Use observed provider support for catalog sort flags, including unsortable pooled full-time retention projections.
+
+Program tool text leads with completion earnings and renders legacy highest-credential values separately. School comparison leaves descriptive metrics, singleton results, shared OPEID6 outcomes, and mixed price periods unranked. Negative dollar selectors normalize to zero with a notice. Earnings vintages deduplicate in caller order. Six-digit CIP lookup resolves to the four-digit group used by program selectors.
+
 ---
 
 ## Context
@@ -356,7 +362,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
 | `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
 | `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
 | `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
-| `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
+| `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity, `.mcpbignore` coverage, plugin manifests, the published `skills/` tree (run by devcheck) |
 | `bun run list-skills` | Print the skill registry |
 | `bun run tree` | Generate directory structure doc |
 | `bun run format` | Auto-fix formatting (safe fixes only) |
@@ -376,7 +382,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
 
 ## Bundling
 
-`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/`, `CLAUDE.md`, `AGENTS.md`, and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
+`npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs — `framework-skills/`, `skills/`, `.claude/`, `.agents/`, `AGENTS.md`, and `CLAUDE.md` at a package's root, and `SKILL.md` anywhere (a `skills/` deeper in a package is runtime code and stays); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/`, and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
 
 **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
 
@@ -447,4 +453,6 @@ import { getMyService } from '@/services/my-domain/my-service.js';
 - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
 - [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
 - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
-- [ ] `npm run devcheck` passes
+- [ ] Any new root dev path has a root-anchored line in `.mcpbignore` and passes `bun run bundle` and `lint:packaging`
+- [ ] Field-test verified every gate and identifier claim in the published `skills/college-scorecard-guide` against live tool behavior
+- [ ] `bun run devcheck` passes

package/README.md

@@ -7,7 +7,7 @@
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.5.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/college-scorecard-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.4.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/college-scorecard-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/college-scorecard-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.4-blueviolet.svg?style=flat-square)](https://bun.sh/)
+[![Version](https://img.shields.io/badge/Version-0.6.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/college-scorecard-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.4.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/college-scorecard-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/college-scorecard-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.4-blueviolet.svg?style=flat-square)](https://bun.sh/)
 
 </div>
 
@@ -35,13 +35,13 @@ US college data from the Department of Education College Scorecard: costs, earni
 
 | Tool | Description |
 |:---|:---|
-| `scorecard_search_schools` | Search institutions by name, location, type, size, acceptance rate, and single-sex flags; sort by supported API fields. Returns core identity and cost metrics. |
-| `scorecard_get_school` | Full institutional profiles — costs, admissions, outcomes, aid, demographics, single-sex flags, and completion rates. |
-| `scorecard_compare_schools` | Normalized side-by-side comparison of 2–5 schools on a named topic. Returns metric values, ordinal ranks, and a comparison summary. |
+| `scorecard_search_schools` | Search institutions by location, price, completion, operating certification, and other school characteristics. Sort by fields with API sort support. |
+| `scorecard_get_school` | Institutional profiles with costs, admissions, aid, demographics, completion, and borrower repayment outcomes. |
+| `scorecard_compare_schools` | Side-by-side comparison of up to five schools. Includes ranks and leaders for eligible metrics. |
 | `scorecard_get_programs` | Paged field-of-study outcomes: completion-based 1/4-year earnings, legacy highest-credential earnings, debt, and campus awards with separate provenance. |
 | `scorecard_search_programs` | Find programs by CIP and credential or keyword, retain degree identity, and rank earnings within each fetched school page. |
 | `scorecard_get_earnings` | Earnings of federally aided undergraduate entrants working and not enrolled, regardless of completion: 6/8/10-year medians, 6/10-year P25/P75, and non-male/male 6-year medians. |
-| `scorecard_value_analysis` | Workflow tool: parallel-fetches cost, debt, repayment, and earnings data, then computes ROI metrics — debt-to-earnings ratio and net price to earnings ratio. |
+| `scorecard_value_analysis` | Combines cost, debt, repayment, and earnings data with debt-to-earnings and net-price-to-earnings ratios. |
 | `scorecard_lookup_cip` | Search all 464 current NCES CIP 2020 four-digit groups by code, keyword, or related program name. Served offline. |
 | `scorecard_list_fields` | Search the Scorecard field catalog by keyword. Returns matching field paths, descriptions, data types, and sort support. Use before passing custom `fields` parameters. |
 
@@ -67,9 +67,10 @@ The [college-scorecard-guide](./skills/college-scorecard-guide/SKILL.md) covers
 
 ### `scorecard_search_schools` <sub>tool</sub>
 
-- Search by name, state, ownership, degree level, size, acceptance rate, CIP code, or ZIP and distance (miles or `km`). `per_page` is capped at 100; `page` is zero-indexed. State lists accept `WA,CA`.
-- Returns core identity and cost metrics for quick scanning.
-- `sort` takes an API expression such as `latest.cost.avg_net_price.overall:asc` (`:desc` reverses it). `men_only` and `women_only` accept true or false.
+- Search by name, state, ownership, degree level, size, acceptance rate, CIP code, or ZIP and distance (miles or `km`). State lists accept `WA,CA`.
+- Apply `max_net_price` (inclusive dollars), `min_completion_rate` (inclusive 0–1), and `locale` (`city`, `suburb`, `town`, or `rural`) before paging. These filters require reported values. Negative price ceilings normalize to $0 with a notice.
+- `operating`, `hbcu`, `men_only`, and `women_only` match explicit true or false values. Omit a flag to include unknown values. `operating: false` means the school lacks current operating certification. Verify actual closure separately.
+- Use `scorecard_list_fields` to choose a supported sort such as `latest.cost.avg_net_price.overall:asc`. Omit sort to preserve API order. `page` starts at zero and `per_page` is capped at 100.
 
 ---
 
@@ -78,22 +79,23 @@ The [college-scorecard-guide](./skills/college-scorecard-guide/SKILL.md) covers
 - Accepts a school ID or an array of up to 1,000. The first 100 distinct IDs are fetched; `missing_ids` lists fetched IDs with no record and `unprocessed_ids` lists the excess.
 - Default profiles cover costs, admissions, outcomes, financial aid, demographics, and completion rates. Custom `fields` returns `selected_fields` with the requested values, and `absent_fields` lists requested paths missing from the response.
 - Projected program arrays use `program_limit` (default 20, capped at 100) and `program_offset`; follow each school's `program_pages` continuation. Raw values and provider positions stay aligned.
-- HBCU and single-sex flags are true/false when known and unknown when absent.
+- Profiles include operating certification, HBCU, and single-sex flags as booleans when known, omitting unknown flags. The discontinued three-year declining-balance rate carries its 2016–17 file, repayment-entry cohorts, and measurement period.
+- `borrower_repayment` reports making progress, default, and paid in full at two and four years for OPEID6-pooled undergraduate federal Direct Loan borrowers. Each horizon has its own provenance and cohort count when available. Published bins are preserved verbatim, and only decimal point estimates have numeric values.
 
 ---
 
 ### `scorecard_compare_schools` <sub>tool</sub>
 
 - Accepts 2–1,000 raw unit IDs and compares the first five distinct normalized IDs on `costs`, `admissions`, `outcomes`, or `aid`. `missing_ids` were queried; `unprocessed_ids` were not.
-- Equal independent values share a rank (1, 1, 3). Missing values, pooled outcome rows containing shared OPEID6 groups, and mixed academic/program-year price rows are unranked.
-- Each cell's `availability` distinguishes available, unavailable, and privacy-suppressed values.
+- Equal eligible values share a rank (1, 1, 3). Admissions metrics, aid participation rates, shared OPEID6 outcome rows, and mixed academic/program-year price rows are unranked. A single found school yields values without ranks or leaders.
+- Each cell's `availability` distinguishes available, unavailable, and privacy-suppressed values. Repayment rows rank the historical three-year declining-balance measure and identify its vintage.
 
 ---
 
 ### `scorecard_get_programs` <sub>tool</sub>
 
 - Accepts one school ID, with optional CIP code (dotted or undotted), `credential_level`, and minimum earnings filters. A school with no matching programs returns an empty collection; a nonexistent school is a lookup error.
-- Completion-based 1/4-year medians and counts carry separate availability and provenance. Legacy `earnings_1yr_median`/`earnings_count` retain highest-credential semantics; their availability and suppression counts remain separate.
+- Text results lead with completion-based one- and four-year medians, counts, and availability. Legacy `earnings_1yr_median` and `earnings_count` appear separately with their highest-credential provenance.
 - `min_earnings` and ordering use completion-based one-year earnings, with no legacy fallback. Page with `limit` (default 20, capped at 100) and `offset`; `total` counts matches before paging, and `nextOffset` is null at the end.
 - `median_debt` is completers' cumulative Stafford/Grad PLUS borrowing. `ipeds_awards_year1` and `ipeds_awards_year2` count awards in each year of the pooled debt cohort, not students.
 
@@ -103,14 +105,14 @@ The [college-scorecard-guide](./skills/college-scorecard-guide/SKILL.md) covers
 
 - Search by CIP code or program name, with optional integer `credential_level` (1–8 and 99), state, ownership, net price, earnings, and debt filters. `page`/`per_page` paginate schools; `offset`/`limit` page matching program rows within that school page.
 - Returns school IDs and names with program metrics, `credential_level`, and `credential_title`. Available earnings sort first; availability, debt, and award fields match `scorecard_get_programs`.
-- `min_earnings` filters locally, so totals and pagination are upstream school counts before filtering. Earnings and debt thresholds are inclusive and exclude unknown values.
+- `min_earnings` filters locally, so totals and pagination are upstream school counts before filtering. Earnings and debt thresholds are inclusive and exclude unknown values. Negative `max_net_price` and `max_debt` normalize to $0 with a notice.
 - Follow `next` until null: it drains program rows on the current school page before advancing. `shown` counts returned programs; `schools_shown` counts fetched schools. Rankings use current completion-based one-year earnings within the fetched page only.
 
 ---
 
 ### `scorecard_get_earnings` <sub>tool</sub>
 
-- Accepts one school ID and optional data-file start `years` from 1996–2025 (file vintages, not entry years). Omit `years` or pass `[]` for the snapshot only.
+- Accepts one school ID and optional data-file start `years` from 1996–2025 (file vintages, not entry years). Duplicate years collapse in caller order. Omit `years` or pass `[]` for the snapshot only.
 - Covers federally aided undergraduate entrants working and not enrolled, regardless of completion: medians at 6/8/10 years after entry, 6/10-year P25/P75, and non-male/male 6-year medians.
 - `current_availability` and `trend[].availability` classify each metric. `current_context` and `trend[].context` give `data_file_year`, `entry_cohorts`, `measurement_years`, and `dollar_year`; values keep the provider's dollar basis, so check it before comparing across vintages.
 
@@ -118,24 +120,25 @@ The [college-scorecard-guide](./skills/college-scorecard-guide/SKILL.md) covers
 
 ### `scorecard_value_analysis` <sub>tool</sub>
 
-- Accepts one school ID; optional `family_income` selects the applicable net price bracket ($0–30k, $30k–48k, $48k–75k, $75k–110k, or $110k+).
+- Accepts one school ID. Optional `family_income` selects the applicable net price bracket ($0–30k, $30k–48k, $48k–75k, $75k–110k, or $110k+). Negative income normalizes to $0 with a notice.
 - Returns ratios alongside their source figures. `effective_net_price` is the price used, and `net_price_basis` is `income_bracket`, `overall`, or `unavailable`.
 - If the bracket is missing, the overall price is used and `data_notes` says so. Ratios require positive annual earnings.
 - Tuition and attendance independently prefer academic-year prices, otherwise reported program-year prices; each has its own basis. Program tuition never substitutes for net price. OPEID6-pooled outcomes are identified alongside campus prices.
+- Returns the same two- and four-year borrower statuses and historical three-year declining-balance context as the default school profile.
 
 ---
 
 ### `scorecard_lookup_cip` <sub>tool</sub>
 
 - Search by nonblank keyword or partial name (default limit 20, capped at 50). Dotted `11.07` and undotted `1107` are equivalent; continue with `offset` and returned `nextOffset` while more results remain.
-- Returns exact group titles and family identities from all 464 current NCES CIP 2020 four-digit groups. Verified six-digit program aliases return their group; no matches return an empty collection with guidance.
+- Returns exact group titles and family identities from all 464 current NCES CIP 2020 four-digit groups. Six-digit queries such as `11.0701` and `110701` resolve to their four-digit group with a notice. Program tools take the four-digit group. No matches return an empty collection with guidance.
 
 ---
 
 ### `scorecard_list_fields` <sub>tool</sub>
 
-- Search 84 curated offline field entries by nonblank query (default limit 30, capped at 100). Use before passing custom `fields` to `scorecard_get_school`.
-- Returns field paths, descriptions, data types, categories, and API sorting support; `tip` flags results containing unsortable fields.
+- Search 94 curated offline field entries by nonblank query (default limit 30, capped at 100). Use before passing custom `fields` to `scorecard_get_school`, including pooled full-time retention for four-year and less-than-four-year institutions.
+- Returns field paths, descriptions, data types, categories, and observed API sorting support. `tip` flags results containing unsortable fields.
 
 ---
 
@@ -159,7 +162,7 @@ The [college-scorecard-guide](./skills/college-scorecard-guide/SKILL.md) covers
 ### `scorecard_compare_prompt` <sub>prompt</sub>
 
 - Arguments: `school_names` (comma-separated list) and `focus` (`costs` | `outcomes` | `programs`), both required
-- `costs` and `outcomes` run school discovery, `scorecard_compare_schools`, profiles, and value analysis. `programs` runs school discovery, CIP lookup, and `scorecard_get_programs` per school, then compares earnings, debt, and IPEDS awards for matching credentials.
+- `costs` and `outcomes` run school discovery, `scorecard_compare_schools`, profiles, and value analysis. `programs` runs school discovery, CIP lookup, and `scorecard_get_programs` per school, then compares completion earnings, debt, and IPEDS awards for matching credentials.
 
 ## Features
 
@@ -170,14 +173,14 @@ College Scorecard-specific:
 - Full College Scorecard API coverage: ~6,500 Title IV institutions, ~2,800 data fields spanning costs, outcomes, demographics, financial aid, and field-of-study earnings
 - Program completion earnings at one and four years, alongside legacy highest-credential outcomes; each series carries its population and vintage
 - Field pre-selection per tool — curated field sets appropriate to each tool's purpose; optional `fields` override for custom queries
-- Embedded CIP taxonomy (464 groups) and field catalog (84 fields) served offline
+- Embedded CIP taxonomy (464 groups) and field catalog (94 fields) served offline
 - Geographic filtering via U.S. zip code + distance radius
 
 Agent-friendly output:
 
 - Availability distinguishes numbers (including zero), missing values, and explicit `PS` / `PrivacySuppressed` provider markers
 - Derived metrics sit alongside source figures in `scorecard_value_analysis`, and `scorecard_compare_schools` adds ordinal ranks
-- School sorting uses indexed API fields; check `scorecard_list_fields` before choosing a sort expression. Six-year earnings does not support API sorting.
+- School sorting uses fields with observed API sort support. Six-year earnings and pooled full-time retention can be projected but cannot be used as sort fields.
 - Provider failures report distinct validation, authentication, throttling, timeout, and availability reasons; availability uses `api_error` and cancellation remains `RequestCancelled`
 
 ## Getting started
@@ -265,7 +268,7 @@ MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 SCORECARD_API_KEY=... bun run start:h
 
 ### Prerequisites
 
-- [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).
+- [Bun v1.4.4](https://bun.sh/) or higher (or Node.js v24+).
 - A College Scorecard API key — free registration at [api.data.gov/signup](https://api.data.gov/signup/). Rate limit: 1,000 requests/hour per key.
 
 ### Installation
@@ -305,12 +308,14 @@ All configuration is validated at startup via Zod schemas in `src/config/server-
 | `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |
 | `MCP_HTTP_PORT` | HTTP server port | `3010` |
 | `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path where the MCP server is mounted | `/mcp` |
-| `MCP_PUBLIC_URL` | Public origin override for TLS-terminating reverse-proxy deployments | none |
+| `MCP_PUBLIC_URL` | Public HTTP or HTTPS base URL for TLS-terminating reverse-proxy deployments. Omit credentials, query parameters, and fragments. | none |
 | `MCP_SESSION_MODE` | HTTP session mode: `stateless`, `stateful`, or `auto` | `stateless` |
 | `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth` | `none` |
+| `MCP_JWT_EXPECTED_AUDIENCE` | Required `aud` claim in JWT mode. An unset audience logs a startup warning. | none |
+| `MCP_JWT_EXPECTED_ISSUER` | Required `iss` claim in JWT mode. Configure it alongside the audience. | none |
 | `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`, etc.) | `info` |
 | `MCP_GC_PRESSURE_INTERVAL_MS` | Opt-in forced-GC loop interval in ms (Bun only); try `60000` if heap grows under HTTP load | `0` (disabled) |
-| `LOGS_DIR` | Directory for log files (Node.js only) | `<project-root>/logs` |
+| `LOGS_DIR` | Directory for log files. Relative paths resolve from the server package root. | `<server-package-root>/logs` |
 | `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1` | `in-memory` |
 | `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) | `false` |
 

package/changelog/0.6.x/0.6.0.md

@@ -0,0 +1,34 @@
+---
+summary: "Filter schools by price, completion, and certification, and compare outcomes with the reported cohorts and measures."
+breaking: true
+security: false
+---
+
+# 0.6.0 — 2026-11-13
+
+## Added
+
+- **`scorecard_search_schools`** filters by maximum net price, minimum completion rate, HBCU status, and locale before pagination. ([#55](https://github.com/cyanheads/college-scorecard-mcp-server/issues/55))
+- **School profiles and value analysis** return two- and four-year undergraduate federal Direct Loan borrower statuses with OPEID6 scope, cohort counts, and the published decimals or bins. ([#58](https://github.com/cyanheads/college-scorecard-mcp-server/issues/58))
+
+## Changed
+
+- Remove inherited titles from concrete school and program resource entries; template titles remain.
+- **Runtime** requires Bun 1.4.4 or later when running on Bun.
+
+## Fixed
+
+- **Three-year declining-balance repayment** carries its discontinued status and 2016–17 file vintage in school profiles, value analysis, and comparisons. ([#51](https://github.com/cyanheads/college-scorecard-mcp-server/issues/51))
+- **Program tools and comparison prompt** lead with completion-based earnings and distinguish the legacy highest-credential series. Program tools render all results as readable text with availability, provenance, and continuation. ([#52](https://github.com/cyanheads/college-scorecard-mcp-server/issues/52))
+- **`scorecard_list_fields`** reports observed API sort support and includes pooled full-time retention for four-year and less-than-four-year institutions. ([#53](https://github.com/cyanheads/college-scorecard-mcp-server/issues/53))
+- **Operating certification** appears where reported in school tools and resources, with an explicit certification filter in school search. ([#54](https://github.com/cyanheads/college-scorecard-mcp-server/issues/54))
+- **`scorecard_compare_schools`** leaves descriptive metrics and single-school results unranked and preserves unranked rows in the comparison prompt. ([#56](https://github.com/cyanheads/college-scorecard-mcp-server/issues/56))
+- **Input normalization** clamps negative dollar inputs to zero with a notice, deduplicates earnings vintages in caller order, and maps six-digit CIP queries to their four-digit group. Exhausted CIP pages explain how to restart. ([#57](https://github.com/cyanheads/college-scorecard-mcp-server/issues/57))
+- **Readable output** preserves reported numeric precision for comparison values, historical repayment, and family income. Upstream HTTP error bodies stay server-side by default.
+- **MCPB packaging** retains runtime files when stripping dependency development files.
+
+## Dependencies
+
+- **`@cyanheads/mcp-ts-core`** ^0.13.18 → ^0.13.22
+- **`@biomejs/biome`** ^2.6.4 → ^2.6.7
+- **`vitest`** ^5.0.5 → ^5.1.0

package/changelog/template.md

@@ -116,14 +116,21 @@ security: false
   resolves to whatever real item already owns 42, and timeline previews pull
   in that unrelated item's metadata.
 
+  Outside reporters: when the issue or PR came from outside the project
+  (`git-wrapup` step 5 says how to tell), thank its author in the same
+  parenthetical, profile linked by full URL for the same reason:
+
+      ([#38](https://github.com/cyanheads/mcp-ts-core/issues/38), thanks [@octocat](https://github.com/octocat)!)
+
   TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
   via `gh release create --notes-from-tag`. It is a condensed digest of this
   entry, never a copy, and its format is owned by the `release-and-publish`
   skill (step 4, "Create the annotated tag"): a short subject line without the
   version, flat headline bullets — no Keep-a-Changelog section headers, no
-  gates line — at most one deps line, issue backlinks, and the changelog link
-  last. In release-PR mode the `git-wrapup` skill authors those bullets as the
-  PR body's `## Changes` and the tag copies them.
+  gates line — at most one deps line, issue backlinks with any outside-reporter
+  thanks, and the changelog link last. In release-PR mode the `git-wrapup`
+  skill authors those bullets as the PR body's `## Changes` and the tag copies
+  them.
 -->
 
 ## Added

package/dist/data/field-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-catalog.d.ts","sourceRoot":"","sources":["../../src/data/field-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB;IAChB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CAClD;AAED,mFAAmF;AACnF,eAAO,MAAM,aAAa,EAAE,UAAU,EAinBrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE,CAsB1E"}
+{"version":3,"file":"field-catalog.d.ts","sourceRoot":"","sources":["../../src/data/field-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB;IAChB,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CAClD;AAED,mFAAmF;AACnF,eAAO,MAAM,aAAa,EAAE,UAAU,EAwpBrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,UAAU,EAAE,CAsB1E"}

package/dist/data/field-catalog.js

@@ -3,6 +3,7 @@
  * Scorecard data dictionary. Static data — no API call required.
  * @module data/field-catalog
  */
+import { BORROWER_REPAYMENT_SERIES, BORROWER_REPAYMENT_STATUSES, borrowerRepaymentField, describeLegacyRepayment, LEGACY_REPAYMENT_CONTEXT, } from './repayment-context.js';
 /** Core field catalog — most decision-relevant fields from the data dictionary. */
 export const FIELD_CATALOG = [
     // Identity
@@ -17,7 +18,7 @@ export const FIELD_CATALOG = [
         path: 'id',
         description: 'Unique unit ID (use for ID-based lookups)',
         type: 'integer',
-        sortable: false,
+        sortable: true,
         category: 'identity',
     },
     {
@@ -101,7 +102,7 @@ export const FIELD_CATALOG = [
         path: 'school.minority_serving.historically_black',
         description: 'Historically Black College or University flag',
         type: 'integer',
-        sortable: false,
+        sortable: true,
         category: 'identity',
     },
     {
@@ -151,70 +152,70 @@ export const FIELD_CATALOG = [
         path: 'latest.cost.net_price.public.by_income_level.0-30000',
         description: 'Net price for family income $0–$30,000 (public institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.public.by_income_level.30001-48000',
         description: 'Net price for family income $30,001–$48,000 (public institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.public.by_income_level.48001-75000',
         description: 'Net price for family income $48,001–$75,000 (public institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.public.by_income_level.75001-110000',
         description: 'Net price for family income $75,001–$110,000 (public institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.public.by_income_level.110001-plus',
         description: 'Net price for family income $110,001+ (public institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.private.by_income_level.0-30000',
         description: 'Net price for family income $0–$30,000 (private institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.private.by_income_level.30001-48000',
         description: 'Net price for family income $30,001–$48,000 (private institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.private.by_income_level.48001-75000',
         description: 'Net price for family income $48,001–$75,000 (private institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.private.by_income_level.75001-110000',
         description: 'Net price for family income $75,001–$110,000 (private institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
         path: 'latest.cost.net_price.private.by_income_level.110001-plus',
         description: 'Net price for family income $110,001+ (private institutions)',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'cost',
     },
     {
@@ -347,31 +348,52 @@ export const FIELD_CATALOG = [
     },
     {
         path: 'latest.repayment.repayment_cohort.3_year_declining_balance',
-        description: 'Share of borrowers paying down principal (declining loan balance) 3 years after entering repayment (0–1)',
+        description: `Share of borrowers paying down principal (declining loan balance) 3 years after entering repayment (0–1), ${describeLegacyRepayment(LEGACY_REPAYMENT_CONTEXT[3])}`,
         type: 'float',
         sortable: false,
         category: 'aid',
     },
     {
         path: 'latest.repayment.repayment_cohort.1_year_declining_balance',
-        description: 'Share of borrowers paying down principal (declining loan balance) 1 year after entering repayment (0–1)',
+        description: `Share of borrowers paying down principal (declining loan balance) 1 year after entering repayment (0–1), ${describeLegacyRepayment(LEGACY_REPAYMENT_CONTEXT[1])}`,
         type: 'float',
         sortable: false,
         category: 'aid',
     },
     {
         path: 'latest.repayment.repayment_cohort.5_year_declining_balance',
-        description: 'Share of borrowers paying down principal (declining loan balance) 5 years after entering repayment (0–1)',
+        description: `Share of borrowers paying down principal (declining loan balance) 5 years after entering repayment (0–1), ${describeLegacyRepayment(LEGACY_REPAYMENT_CONTEXT[5])}`,
         type: 'float',
         sortable: false,
         category: 'aid',
     },
+    ...BORROWER_REPAYMENT_SERIES.flatMap((series) => {
+        const { horizon_years, data_file, repayment_entry_cohorts, measurement_period } = series;
+        const countPath = borrowerRepaymentField(horizon_years, 'count');
+        const vintage = `OPEID6 pooled; ${data_file} file, repayment-entry cohorts ${repayment_entry_cohorts.join(', ')}, measured ${measurement_period.join(', ')}`;
+        return [
+            {
+                path: countPath,
+                description: `Cohort count of undergraduate federal Direct Loan borrowers for the ${horizon_years}-year statuses (${vintage})`,
+                type: 'integer',
+                sortable: false,
+                category: 'aid',
+            },
+            ...Object.values(BORROWER_REPAYMENT_STATUSES).map(({ label, suffix }) => ({
+                path: borrowerRepaymentField(horizon_years, suffix),
+                description: `Share of undergraduate federal Direct Loan borrowers assigned ${label} at ${horizon_years} years, published as a decimal or bin. Denominator is ${countPath} (${vintage})`,
+                type: 'string',
+                sortable: false,
+                category: 'aid',
+            })),
+        ];
+    }),
     // Completion / Outcomes
     {
         path: 'latest.completion.rate_suppressed.overall',
         description: 'Completion rate at 150% normal time (overall)',
         type: 'float',
-        sortable: false,
+        sortable: true,
         category: 'completion',
     },
     {
@@ -385,9 +407,24 @@ export const FIELD_CATALOG = [
         path: 'latest.completion.consumer_rate',
         description: 'Consumer-friendly completion rate',
         type: 'float',
-        sortable: false,
+        sortable: true,
         category: 'completion',
     },
+    // Retention
+    {
+        path: 'latest.student.retention_rate_suppressed.four_year.full_time_pooled',
+        description: 'Pooled share of first-time, full-time bachelor’s or equivalent degree-seeking undergraduates who return the next fall at four-year institutions',
+        type: 'float',
+        sortable: false,
+        category: 'retention',
+    },
+    {
+        path: 'latest.student.retention_rate_suppressed.lt_four_year.full_time_pooled',
+        description: 'Pooled share of first-time, full-time degree- or certificate-seeking undergraduates who return the next fall at less-than-four-year institutions',
+        type: 'float',
+        sortable: false,
+        category: 'retention',
+    },
     // Earnings — Institution Level
     {
         path: 'latest.earnings.6_yrs_after_entry.median',
@@ -530,7 +567,7 @@ export const FIELD_CATALOG = [
         path: 'latest.programs.cip_4_digit.earnings.4_yr.overall_median_earnings',
         description: 'Median earnings of graduates working and not enrolled 4 years after completion, pooled by OPEID6, CIP, and credential',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'programs',
     },
     {
@@ -551,7 +588,7 @@ export const FIELD_CATALOG = [
         path: 'latest.programs.cip_4_digit.code',
         description: 'CIP 4-digit program code (e.g. "11.07")',
         type: 'string',
-        sortable: true,
+        sortable: false,
         category: 'programs',
     },
     {
@@ -579,28 +616,28 @@ export const FIELD_CATALOG = [
         path: 'latest.programs.cip_4_digit.debt.staff_grad_plus.all.all_inst.median',
         description: 'Median cumulative Stafford/Grad PLUS borrowing among completers across institutions at the same academic level',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'programs',
     },
     {
         path: 'latest.programs.cip_4_digit.counts.ipeds_awards1',
         description: 'IPEDS awards in year 1 of the pooled debt cohort; not enrollment or unique students',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'programs',
     },
     {
         path: 'latest.programs.cip_4_digit.counts.ipeds_awards2',
         description: 'IPEDS awards in year 2 of the pooled debt cohort; not enrollment or unique students',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'programs',
     },
     {
         path: 'latest.programs.cip_4_digit.credential.level',
         description: 'Credential level: 1=undergraduate certificate, 2=associate, 3=bachelor, 4=post-baccalaureate certificate, 5=master, 6=doctoral, 7=first professional, 8=graduate/professional certificate, 99=non-credential',
         type: 'integer',
-        sortable: true,
+        sortable: false,
         category: 'programs',
     },
 ];