footnote-data 0.2.0 → 0.4.0

package/README.md

@@ -8,8 +8,10 @@ and severance terms parsed from SEC filings. Counts are measured, matches are
 exact-or-absent, and absence of evidence is always distinguished from evidence
 of absence.
 
-Free keys get trust/posture answers (WARN, H-1B, debarment). The
-volume/series datasets — H-2, PERM, OPT — are **Data Pro**; a free key hitting
+Free keys get trust/posture answers (WARN, H-1B, debarment) — 50 calls/day over the
+last 30 days. **Developer** ($29/mo) keeps the same datasets at 1,000 calls/day with a
+year of WARN depth. The volume/series datasets — H-2, PERM, OPT — are **Data Pro**
+($79/mo or $790/yr, 10,000 calls/day, 24-month window); a free or Developer key hitting
 them gets a `403 upgrade_required` that names the dataset and the way up, never
 a silent 404. `footnote datasets` lists every holding with its `access` tier.
 
@@ -58,7 +60,7 @@ for live data.
 ### WARN layoff notices
 
 ```bash
-# Recent notices, newest first (free tier: last 30 days)
+# Recent notices, newest first (free: last 30 days · Developer: last 365 · Pro: 24 months)
 footnote warn recent --state CA --days 14 --limit 25
 
 # Search by employer across states with a date window and pagination
@@ -89,6 +91,7 @@ footnote h1b employer "Databricks"
 
 # Top sponsors by certified filing volume (free tier: top 25)
 footnote h1b top-sponsors --limit 10
+footnote h1b active-sponsors --limit 10   # certified-to-employ-today, by covered positions
 
 # Petition OUTCOMES (USCIS) + current attestation INTENT (LCA), in one view
 footnote sponsorship "Meta Platforms"
@@ -280,6 +283,7 @@ that apply to that call.
 | `warn states` | `GET /api/data/v1/warn/states` |
 | `h1b employer` | `GET /api/data/v1/h1b/employer` |
 | `h1b top-sponsors` | `GET /api/data/v1/h1b/top-sponsors` |
+| `h1b active-sponsors` | `GET /api/data/v1/h1b/active-sponsors` |
 | `sponsorship` | `GET /api/data/v1/sponsorship/employer` |
 | `enforcement` | `GET /api/data/v1/enforcement/employer` |
 | `litigation` | `GET /api/data/v1/litigation/employer` |

package/footnote.mjs

@@ -82,6 +82,13 @@ export const COMMANDS = [
     summary: "Top H-1B sponsors by certified filing volume",
     flags: { limit: "posInt" },
   },
+  {
+    name: "h1b active-sponsors",
+    path: "/api/data/v1/h1b/active-sponsors",
+    route: "app/api/data/v1/h1b/active-sponsors/route.ts",
+    summary: "Employers with certified LCA windows covering today, by covered positions",
+    flags: { limit: "posInt" },
+  },
   {
     name: "sponsorship",
     path: "/api/data/v1/sponsorship/employer",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "footnote-data",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "The official Footnote CLI \u2014 career intelligence from the public record: WARN layoffs, H-1B & green-card sponsorship, H-2 seasonal labor, PERM, OPT, DOL debarment, certified wages, and federal enforcement, straight from usefootnote.com's Data API.",
   "keywords": [
     "layoffs",