feat: add contributor institution field across docs, data, and website

Add institution to contributor schema in study index.json files,
build script, website display, upload form, and contribution docs.
Defaults to "Independent Researcher" if left blank.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: assassin808

co_website/app/api/contribute/upload/route.ts

@@ -139,6 +139,8 @@ export async function POST(request: NextRequest) {
     const formData = await request.formData();
     const file = formData.get("file") as File | null;
     const contributorGithub = normalizeGithub(String(formData.get("contributor_github") || ""));
+    const contributorName = String(formData.get("contributor_name") || "").trim();
+    const contributorInstitution = String(formData.get("contributor_institution") || "Independent Researcher").trim();
     if (!file || !(file instanceof File)) {
       return NextResponse.json({ success: false, errors: ["No file provided."] }, { status: 400 });
     }
@@ -223,7 +225,7 @@ export async function POST(request: NextRequest) {
       authors: Array.isArray(meta.authors) ? meta.authors : [],
       year: typeof meta.year === "number" ? meta.year : null,
       description: typeof meta.summary === "string" ? meta.summary : typeof meta.abstract === "string" ? meta.abstract : "",
-      contributors: [{ github: contributorGithub }],
+      contributors: [{ name: contributorName || undefined, github: contributorGithub, institution: contributorInstitution }],
     };
     pathToContent.set(
       `studies/${studyId}/index.json`,

co_website/app/studies/[studyId]/page.tsx

@@ -15,7 +15,7 @@ export async function generateStaticParams() {
   }
 }
 
-type Contributor = { name: string; github?: string };
+type Contributor = { name: string; github?: string; institution?: string };
 type StudyEntry = {
   study_id: string;
   title: string;
@@ -93,7 +93,7 @@ export default async function StudyDetailPage({
               <h2 className="text-xl font-semibold text-gray-900 font-serif mb-4">Contributors</h2>
               <ul className="flex flex-wrap gap-3">
                 {study.contributors.map((c) => (
-                  <li key={c.name}>
+                  <li key={c.name} className="flex items-baseline gap-1">
                     {c.github ? (
                       <a
                         href={c.github}
@@ -106,6 +106,9 @@ export default async function StudyDetailPage({
                     ) : (
                       <span className="text-gray-600">{c.name}</span>
                     )}
+                    {c.institution && (
+                      <span className="text-sm text-gray-400">({c.institution})</span>
+                    )}
                   </li>
                 ))}
               </ul>

co_website/app/studies/page.tsx

@@ -2,7 +2,7 @@ import { promises as fs } from "fs";
 import path from "path";
 import Link from "next/link";
 
-type Contributor = { name: string; github?: string };
+type Contributor = { name: string; github?: string; institution?: string };
 type StudySummary = {
   study_id: string;
   title: string;

co_website/components/ContributeUploadForm.tsx

@@ -7,6 +7,8 @@ type Result = { success: true; pr_url: string } | { success: false; errors: stri
 export default function ContributeUploadForm() {
   const [file, setFile] = useState<File | null>(null);
   const [contributorGithub, setContributorGithub] = useState("");
+  const [contributorName, setContributorName] = useState("");
+  const [contributorInstitution, setContributorInstitution] = useState("");
   const [dragActive, setDragActive] = useState(false);
   const [loading, setLoading] = useState(false);
   const [result, setResult] = useState<Result | null>(null);
@@ -48,6 +50,8 @@ export default function ContributeUploadForm() {
       const formData = new FormData();
       formData.append("file", file);
       formData.append("contributor_github", contributorGithub.trim());
+      formData.append("contributor_name", contributorName.trim());
+      formData.append("contributor_institution", contributorInstitution.trim() || "Independent Researcher");
       try {
         const res = await fetch("/api/contribute/upload", {
           method: "POST",
@@ -62,11 +66,19 @@ export default function ContributeUploadForm() {
         setLoading(false);
       }
     },
-    [file, contributorGithub]
+    [file, contributorGithub, contributorName, contributorInstitution]
   );
 
   return (
     <form onSubmit={handleSubmit} className="space-y-4">
+      <input
+        type="text"
+        value={contributorName}
+        onChange={(e) => setContributorName(e.target.value)}
+        placeholder="Your name (required)"
+        className="w-full rounded-md border border-gray-300 px-3 py-2 text-sm text-gray-900 placeholder:text-gray-400 focus:border-cyan-500 focus:outline-none"
+        required
+      />
       <input
         type="text"
         value={contributorGithub}
@@ -75,6 +87,13 @@ export default function ContributeUploadForm() {
         className="w-full rounded-md border border-gray-300 px-3 py-2 text-sm text-gray-900 placeholder:text-gray-400 focus:border-cyan-500 focus:outline-none"
         required
       />
+      <input
+        type="text"
+        value={contributorInstitution}
+        onChange={(e) => setContributorInstitution(e.target.value)}
+        placeholder="Institution (leave blank for Independent Researcher)"
+        className="w-full rounded-md border border-gray-300 px-3 py-2 text-sm text-gray-900 placeholder:text-gray-400 focus:border-cyan-500 focus:outline-none"
+      />
       <div
         onDragEnter={handleDrag}
         onDragLeave={handleDrag}

co_website/data/studies_index.json

@@ -146,7 +146,8 @@
       "contributors": [
         {
           "name": "Guankai Zhai",
-          "github": "https://github.com/zgk2003"
+          "github": "https://github.com/zgk2003",
+          "institution": "Stanford University"
         }
       ]
     },
@@ -163,7 +164,8 @@
       "contributors": [
         {
           "name": "Yuanjun Feng",
-          "github": "https://github.com/diana3135"
+          "github": "https://github.com/diana3135",
+          "institution": "University of Lausanne"
         }
       ]
     }

docs/build_study_files.md

@@ -26,7 +26,13 @@ This file lives at the root of your study directory. The website reads it for th
 
 **Required fields:** `title` (string), `authors` (string[]), `year` (number | null), `description` (string) — all non-empty.
 
-**Optional:** `contributors` — array of `{"name": "...", "github": "..."}` so you get credit on the site.
+**Optional:** `contributors` — array of objects so you get credit on the site.
+
+| Field | Required | Description |
+|-------|----------|-------------|
+| `name` | Yes | Your full name |
+| `github` | No | Your GitHub profile URL |
+| `institution` | No | Your university or organization. Use `"Independent Researcher"` if unaffiliated |
 
 ```json
 {
@@ -35,7 +41,11 @@ This file lives at the root of your study directory. The website reads it for th
   "year": 1977,
   "description": "People overestimate how many others share their beliefs and behaviors.",
   "contributors": [
-    { "name": "Your Name", "github": "https://github.com/your-username" }
+    {
+      "name": "Your Name",
+      "github": "https://github.com/your-username",
+      "institution": "Stanford University"
+    }
   ]
 }
 ```

docs/submit_study.md

@@ -34,14 +34,20 @@ git push origin contrib-yourgithubid-013
 
 Head to GitHub and open a **Pull Request** targeting the `dev` branch. Include a brief description of the study and any notes for reviewers.
 
-Make sure your `index.json` includes a `contributors` field with your name and GitHub link — CI will verify this matches your GitHub account:
+Make sure your `index.json` includes a `contributors` field with your name, GitHub link, and institution — CI will verify your GitHub ID matches the PR author:
 
 ```json
 "contributors": [
-  { "name": "Your Name", "github": "https://github.com/your-username" }
+  {
+    "name": "Your Name",
+    "github": "https://github.com/your-username",
+    "institution": "Stanford University"
+  }
 ]
 ```
 
+If you are not affiliated with a university or organization, use `"Independent Researcher"` as your institution.
+
 ### What happens after you hit "Create PR"
 
 - **CI** runs `verify_study.sh` and `build_studies_index.py` automatically. It also checks that the `contributors` GitHub ID in your `index.json` matches the PR author.

scripts/build_studies_index.py

@@ -57,6 +57,8 @@ def build_index() -> list[dict]:
                 if c.get("github"):
                     gh = str(c["github"]).strip()
                     nc["github"] = gh if gh.startswith("http") else f"https://github.com/{gh.lstrip('/')}"
+                if c.get("institution"):
+                    nc["institution"] = c["institution"]
                 contributors.append(nc)
         entry = {
             "study_id": study_dir.name,

studies/study_013/index.json

@@ -10,7 +10,8 @@
   "contributors": [
     {
       "name": "Guankai Zhai",
-      "github": "https://github.com/zgk2003"
+      "github": "https://github.com/zgk2003",
+      "institution": "Stanford University"
     }
   ]
 }

studies/study_014/index.json

@@ -8,6 +8,10 @@
   "year": 2011,
   "description": "This study investigates how auctioneers set reserve prices in second-price sealed-bid auctions. A well-established theoretical result, assuming risk neutrality of the seller, is that the optimal reserve price should not depend on the number of participating bidders. In a set of controlled laboratory experiments, it is found that seller behavior often deviates from the theoretical benchmarks: sellers systematically increase their reserve prices as the number of bidders grows, contrary to standard auction theory.",
   "contributors": [
-    { "name": "Yuanjun Feng", "github": "https://github.com/diana3135" }
+    {
+      "name": "Yuanjun Feng",
+      "github": "https://github.com/diana3135",
+      "institution": "University of Lausanne"
+    }
   ]
 }