{
  "schemaVersion": 1,
  "reviewedOn": "2026-10-25",
  "source": {
    "repository": "https://github.com/nikbearbrown/the-reallocation-engine",
    "commit": "015843d5047dbadff05068495e4c5db5cd9945f4",
    "contribution": "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/CONTRIBUTING.md"
  },
  "scope": "Audited active tree, archive file index and selected source files; not exhaustive historical Git research.",
  "limitation": "No calibrated personal probability, current H-1B forecast or eligibility determination.",
  "coverage": {
    "kind": "observed historical file presence",
    "rows": 30369,
    "populated": 1557,
    "missing": 28812,
    "definition": "At least one of Total Approvals, Total Denials, Approval_Rate, median_salary_offered, top_job_titles_sponsored is present.",
    "sha256": "eccdee2addf472b1639269f42eec693b083b7ce251347d5fd0b2856cfdae6270",
    "sourceUrl": "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/data/80-days-to-stay/80-days-csv/mapped_student_employment_targets_v3.csv",
    "warning": "Presence is not accuracy, current willingness or personal odds. Government vintages and original match provenance are unknown."
  },
  "projects": [
    {
      "id": "data",
      "title": "80 Days employer evidence",
      "status": "Historical dataset",
      "description": "The original SEC funding → DOL / USCIS employer-history project. The surviving mapped CSV has company, headquarters, funding and aggregated sponsorship fields. It is a foundation for research, not a live employer directory.",
      "method": "Presence audit: populated rows ÷ all rows. Approval_Rate is an inherited aggregate with no recoverable fiscal-year denominator in this file.",
      "verification": "Recounted all 30,369 rows. 1,557 have any of five H-1B fields; 28,812 have none. SHA-256 matches the May audit. Latest funding date: 2025-09-26.",
      "limit": "No raw LCA / USCIS inputs, fiscal years, SOC, worksite, match method or match score in this snapshot. Historical copy paths are not extra datasets. Missing fields do not mean no sponsorship.",
      "task": "Recover source releases and join lineage; separate initial and continuing petitions, filing years and worksites before showing employer comparisons.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/data/80-days-to-stay/80-days-csv/mapped_student_employment_targets_v3.csv",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/data/80-days-to-stay/data/SEC_DOL_H1b_data_mapped-join-validation-audit.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/data/80-days-to-stay/80-days-day-08/README.md"
      ]
    },
    {
      "id": "sponsor-score",
      "title": "Employer sponsorship score",
      "status": "Formula / research proposal",
      "description": "Chapter 7 proposes combining filing activity, petition approvals, funding recency and company size. Its illustrations explain an intended ranking method; no maintained end-to-end implementation of this formula was found.",
      "method": "0.40 × filing signal + 0.30 × approval signal + 0.20 × funding recency + 0.10 × size signal.",
      "verification": "Chapter, design document and illustrations inspected. The design draft proposes Proven ≥ 0.65 and Likely ≥ 0.35; feature normalization and outcome calibration are unspecified. No predictive validation found.",
      "limit": "The manuscript calls the result P(sponsorship), but a weighted sum is not an estimated probability. Funding and filing history cannot establish current willingness for a particular role.",
      "task": "Define the target outcome and denominators, preserve unknowns, reconcile the chapter’s tier warning with the four-tier design draft, and design held-out calibration before predictive claims.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/book/chapters/07-who-sponsors-the-80-days-sponsorship-scorer.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/book/d3/07-who-sponsors-the-80-days-sponsorship-scorer-fig-02.html",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/archive/Projects/the-reallocation-engine-sdd.md"
      ]
    },
    {
      "id": "identity",
      "title": "Employer matching & join audit",
      "status": "Runnable component",
      "description": "Matches SEC entities to supplied LCA employer records, then records the method used. A separate script prepares a deterministic review sample from populated sponsorship rows.",
      "method": "FEIN exact → normalized name exact → fuzzy match at threshold 0.88 → unknown. Sample defaults: 200 rows, seed 80, first 30 for manual review.",
      "verification": "Synthetic FEIN, normalized-name and unmatched cases passed with the difflib fallback. The review script prepares a packet; it does not validate identity against government records.",
      "limit": "Raw source tables are absent. False-match rate is unknown. rapidfuzz and difflib use different matching methods. Exact-name collisions still require review.",
      "task": "Add ambiguous-parent and subsidiary fixtures, preserve candidate matches, measure precision/recall on independently labelled entities and repair obsolete default input paths.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/sec/entity-resolution.py",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/sec/validate-h1b-join-sample.py",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/audit-sec-dol-h1b-data.py"
      ]
    },
    {
      "id": "role-score",
      "title": "“Bayesian” role scorer / oferta",
      "status": "Runnable, uncalibrated heuristic",
      "description": "Consumes supplied role-evidence JSON and optional profile data, then writes Apply / Consider / Skip and a per-term audit trace. It does not collect the components or fit a Bayesian model.",
      "method": "(0.35 × sponsorship input + 0.30 × fit input + 0 × role quality) × liveness × timeline. Apply threshold 0.30; Consider floor 0.20, with additional demotions and overrides.",
      "verification": "Five-row chapter fixture rerun: 2 Apply, 1 Consider, 2 Skip. Current and Summer archive scorer blobs are identical. No hold-out outcome validation found.",
      "limit": "Missing gates default to 1. Out-of-range synthetic inputs yielded 5.2 and Apply. Role quality has zero weight; profile authorization uses broad text matching. These are engineering defects / assumptions, not measured odds.",
      "task": "Validate input ranges, make unknown gates explicit, replace authorization substring matching, and agree on weights and outcomes before advising use.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/score/role-scorer.mjs",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/data/examples/ch11-roles.json",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/oferta.md"
      ]
    },
    {
      "id": "design-variants",
      "title": "Earlier scoring design variants",
      "status": "Conflicting archived proposals",
      "description": "The system design document and plain-language summary predate the implemented chapter scorer. They are earlier attempts at the same system, not separately deployed calculators.",
      "method": "The design document writes a product of four inputs and weights 0.35, 0.30, 0.20 and 0.15, with Apply ≥ 0.45 and Consider ≥ 0.25. Its overview uses a simpler product; the later CLI instead sums weighted votes and multiplies two gates.",
      "verification": "Read the archived design formulas. With inputs bounded by 1, the literal weighted product cannot exceed 0.00315 and can never reach either threshold. No implementation of that literal product was found.",
      "limit": "The proposals conflict internally and with the shipped scorer. Neither multiplication nor a Bayesian label establishes independence, calibration or a personal success probability.",
      "task": "Document a single target quantity and retire contradictory formulas through review; do not port the archived expression into a public probability calculator.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/archive/Projects/the-reallocation-engine-sdd.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/archive/Projects/the-reallocation-engine-plain-summary.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/book/chapters/11-the-bayesian-role-scorer.md"
      ]
    },
    {
      "id": "gates",
      "title": "Two gate-testing attempts",
      "status": "Tests, not two calculators",
      "description": "One harness invokes the actual scorer CLI and mutates a temporary copy as a negative control. The other implements its own scoring functions as a teaching demonstration.",
      "method": "Strong votes must not override closed liveness or timeline gates. Test normal arithmetic, threshold edges, source labels and deliberate additive-gate failures.",
      "verification": "CLI harness: 10 baseline cases passed and all 5 gate-sensitive mutant cases failed as expected. Copied-arithmetic harness: 22 checks passed across 5 examples.",
      "limit": "The copied harness does not prove the shipped scorer behaves correctly. Both use synthetic cases and establish no predictive accuracy.",
      "task": "Extend the CLI tests for absent, malformed and out-of-range inputs; consolidate duplicate teaching logic without losing the negative control.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/score/gate-harness.mjs",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/score/gate-behavior-harness.mjs",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/score/fixtures/gate-cases.json"
      ]
    },
    {
      "id": "timeline",
      "title": "Visa timeline manager & diagrams",
      "status": "Specification / teaching figures",
      "description": "Chapter 10 sketches authorization, hiring and registration windows. Four timeline figures and the Chapter 7 / 11 visuals are explanatory artifacts, not individual eligibility engines.",
      "method": "Compare supplied dates and route a timeline constraint into the role scorer. The current scorer accepts a factor; it does not calculate it from visa dates.",
      "verification": "Chapter and four timeline HTML files inspected. No executable rule-aware date calculator or current cap-selection simulator found in the audited tree.",
      "limit": "Some chapter language is overly categorical. Extensions, cap-gap, status and permission to work require separate, current review. The manuscript cannot serve as a legal rules database.",
      "task": "Build versioned rule fixtures with expert review, including boundary dates and exceptions. Keep dates on-device and show unknown rules explicitly.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/book/chapters/10-the-visa-timeline-manager.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/book/d3/10-the-visa-timeline-manager-fig-02.html",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/book/d3/11-the-bayesian-role-scorer-fig-03.html"
      ]
    },
    {
      "id": "recipes",
      "title": "Sponsorship & OPT case recipes",
      "status": "14 draft variants",
      "description": "The Summer case set covers backend, data/ML, full-stack, NLP, post-offer sponsorship audit, OPT runway, STEM OPT, targeting and career pivots. These are workflow specifications sharing a template, not 14 working calculators.",
      "method": "Source → scope → data shape → script readiness → approval → report gates, with named input/output contracts still containing TODOs.",
      "verification": "All 14 relevant Summer case files are DRAFT, each with 13 or 14 declared open TODOs. Referenced component scripts and anonymized sources are not supplied by those recipes.",
      "limit": "No end-to-end verified run for these case variants was established. A recipe title does not prove that its implementation exists.",
      "task": "Choose one narrow recipe, define its schema, implement one component in the contribution namespace, and add a fictional worked run plus deliberate failure case.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-h1b-sponsorship-audit.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-opt-timeline-fit-company-targeting.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-ml-sponsorship-triage.md"
      ]
    },
    {
      "id": "misclassification",
      "title": "SOC & wage-level mismatch research",
      "status": "Archived research draft",
      "description": "Proposes comparing LLM-inferred occupation and wage level from job text with filed LCA values, then studying employer variation and petition-denial associations.",
      "method": "Proposed mismatch statistics, employer-level random effects and regression. The draft leaves results, model details and validation values as TO DO.",
      "verification": "Draft inspected; empirical results and a runnable pipeline were not found. Its results-shaped prose is not evidence of completed research.",
      "limit": "A model disagreement is not proof of legal misclassification. No measured error rates or causal interpretation are supported.",
      "task": "Define a lawful text corpus, build blinded expert labels, test classifier error and confounders, and replace placeholder claims with measured findings.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/archive/Projects/h1b_misclassification_draft.md"
      ]
    },
    {
      "id": "local-wage",
      "title": "Location-aware wage comparison",
      "status": "Companion implementation",
      "description": "A separate BLS / BEA tool compares occupation-metro wages with local price levels. This supplies defensible location context, not a worksite sponsorship rate or a DOL wage-level assignment.",
      "method": "Adjusted wage = nominal wage ÷ (regional price parity / 100); exact metro-code join. Missing rows remain missing.",
      "verification": "Source inspected; DOMAIN.md records a historical sample with 100 of 112 occupation-metro pairs available and 12 missing. The cited generated report is absent in this checkout; that sample was not independently rerun.",
      "limit": "Occupation-metro survey estimates do not describe a company offer. The role scorer currently gives role quality zero weight.",
      "task": "Keep survey vintage and suppression visible; do not use cost-of-living adjustment to infer H-1B wage levels or selection weights.",
      "sources": [
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/scripts/bls/local-wage-adjustment.py",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/local-wage-adjustment.md",
        "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/DOMAIN.md"
      ]
    }
  ],
  "caseRecipes": [
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-backend-swe-opt-triage.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-data-ml-h1b-triage.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-ds-faang-opt-runway.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-fullstack-swe-sponsor-triage.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-funded-systems-analyst.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-h1b-sponsorship-audit.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-ic-layout-fit.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-ml-sponsorship-triage.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-new-grad-platform-data-engineering.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-nlp-ml-sponsorship-triage.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-opt-timeline-fit-company-targeting.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-phd-econ-to-industry.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-tpm-pivot.md",
    "https://github.com/nikbearbrown/the-reallocation-engine/blob/015843d5047dbadff05068495e4c5db5cd9945f4/recipes/cases/2026su/case-ux-designer-stem-opt.md"
  ],
  "reproducibleExamples": {
    "selection": {
      "kind": "synthetic, equal-weight toy; not current H-1B rules",
      "inputs": {
        "pool": 1000,
        "slots": 250,
        "seed": 80,
        "trials": 500
      },
      "exactProbability": 0.25,
      "simulation": {
        "selected": 129,
        "trials": 500,
        "rate": 0.258,
        "seed": 80
      },
      "algorithm": "For each independent trial: state = (1664525 * state + 1013904223) mod 2^32; select if state / 2^32 < slots / pool. Initial unsigned state is seed.",
      "warning": "Simulation variation is not a real-world uncertainty interval; repeats assume unchanged hypothetical conditions."
    },
    "calendar": {
      "kind": "arbitrary example, UTC elapsed-day arithmetic only",
      "inputs": {
        "start": "2026-10-25",
        "end": "2027-06-30",
        "milestone": "2027-03-15"
      },
      "result": {
        "duration": 248,
        "remaining": 107,
        "inside": true,
        "position": 56.85483870967742
      },
      "warning": "No immigration rules, extensions or permission-to-work determination."
    }
  }
}
