This is the fuel for your hub. Dump as much as you want —
activities, clubs, sports, jobs, research, volunteering, family responsibilities, summer programs,
awards, and anything that makes you you. Messy bullets are fine; the AI will organize them.
More detail → a stronger profile and a smarter college list. Don’t self-edit yet.
{actLines ? `${actLines} line${actLines === 1 ? "" : "s"}` : "Empty — add a few if you can"}
{story.activities.trim().length ? ` · ${story.activities.trim().length.toLocaleString()} chars` : ""}
{REGION_OPTIONS.map((o) => (
{
if (o.id === "any") {
onChange({ ...prefs, regions: ["any"] });
return;
}
const withoutAny = (prefs.regions || []).filter((r) => r !== "any");
const next = withoutAny.includes(o.id)
? withoutAny.filter((r) => r !== o.id)
: [...withoutAny, o.id];
onChange({ ...prefs, regions: next });
}}
>
{o.label}
))}
onChange({ ...prefs, notes: e.target.value })}
rows={4}
placeholder="e.g. Strong CS or engineering · Prefer schools with need-based aid · Stay within 6 hours of home"
/>
);
}
// ── Upload ───────────────────────────────────────────────────────────────
function UploadStep({ uploads, onUploaded }) {
const [busy, setBusy] = React.useState(false);
const [error, setError] = React.useState("");
const fileRef = React.useRef(null);
const upload = async (fileList) => {
if (!fileList || fileList.length === 0) return;
setError("");
setBusy(true);
try {
const fd = new FormData();
for (const f of fileList) fd.append("files", f);
const res = await fetch("/api/upload", { method: "POST", body: fd, credentials: "same-origin" });
const j = await res.json();
if (!res.ok) throw new Error(j.error || "Upload failed.");
onUploaded(j.saved || []);
if (j.errors && j.errors.length) setError(j.errors.join(" · "));
} catch (e) {
setError(e.message);
}
setBusy(false);
if (fileRef.current) fileRef.current.value = "";
};
return (
Upload documentsOptional
Transcript, resume, or activities list. The AI will read these when it builds your hub. You can skip.
{buildStatus === "done" ? "Your hub is ready" : "Building your hub…"}
{buildStatus === "done"
? "Profile, activities, and a preliminary college list are in place. You can refine anything with the copilot."
: "Sending your story and preferences to the AI. This usually takes a minute."}
Confirm the snapshot below, then send everything to {providerLabel || "your AI"}.
It will structure your profile and draft a preliminary college list from your prefs.
);
}
function buildAiPrompt({ draft, story, prefs, mustHave, uploads }) {
const satLine = draft.testOptional
? "Test optional — not reporting SAT/ACT"
: `SAT=${draft.sat || "—"} (${draft.satNote || "no section note"})`;
const must = mustHave.length
? mustHave.map((c) => `- ${c.name}${c.slug ? ` [${c.slug}]` : ""}${c.location ? ` — ${c.location}` : ""}`).join("\n")
: "(none marked as must-include)";
const uploadLine = uploads.length
? uploads.map((u) => `- ${u.name}`).join("\n")
: "(none)";
return `You are completing onboarding for this student. Use your tools to WRITE to the hub — do not only describe what you would do.
## Structured identity (authoritative — save with set_applicant_snapshot + set_profile_identity + set_testing)
- Name: ${draft.name.trim()}
- Grad year: ${draft.gradYear.trim() || "—"}
- Cycle: ${draft.cycle.trim() || (draft.gradYear.trim() ? `Fall ${draft.gradYear.trim()}` : "—")}
- High school: ${draft.hs.trim()}
- Location: ${draft.location.trim() || "—"}
- Intended major: ${draft.intended.trim()}
- GPA weighted: ${draft.gpaWeighted.trim() || "—"}
- GPA unweighted: ${draft.gpaUnweighted.trim() || "—"}
- ${satLine}
## Freeform activities & extracurriculars (parse into set_activities, Common App order, rank 1…)
${story.activities.trim() || "(none provided — leave activities empty or infer lightly from uploads only)"}
## Freeform awards & honors (parse into set_honors; set awards count on snapshot)
${story.awards.trim() || "(none provided)"}
## Other student notes
${story.other.trim() || "(none)"}
## College list preferences
- Strategy: ${prefs.ambition} (${ambitionLabel(prefs.ambition)})
- Application budget: ${typeof prefs.appCount === "number" ? prefs.appCount : "auto ~12"} applications
- Campus settings: ${(prefs.settings || []).join(", ") || "any"}
- Size: ${prefs.size || "any"}
- Regions: ${(prefs.regions || []).join(", ") || "any"}
- Extra constraints: ${prefs.notes.trim() || "(none)"}
## Counselor-grade list rules (MUST follow — not optional)
These match standard US counseling practice (College Board / BigFuture balanced lists; reach–match–safety mix):
1. **Balanced list required.** Every list needs real safeties, targets (backbone), and a limited number of reaches. College Board: often ~5–8 apps is enough when the mix is right; ~8–12 is fine if quality stays high.
2. **Count applications, not campuses.** All UC campuses = ONE application.
3. **Tier honesty for THIS student (GPA/SAT on file above):**
- Safety = clearly above mid-50% / high admit likelihood — and a place they'd happily attend
- Target = mid-50% overlap / solid but not guaranteed
- Reach = selective stretch that is still plausible
- Lottery (sub-~8%, especially sub-~5%: HYP, MIT, Stanford, Caltech, UChicago, Columbia…) = optional spice ONLY, never the bulk
4. **Ambition mapping:**
- ambitious = mild extra risk + **1–2 major-fit dreams** still labeled **reach** (e.g. Northwestern Medill, Michigan, NYU, USC for journalism) — NOT a HYPMS stack
- balanced = classic mix; conservative = lean safer
- For ~3.4–3.6 UW: reaches mostly ~10–25% admit; at most 1–2 under ~8% with clear major fit; targets mostly ~30–55%
5. **Hard ban unless student named the school:** do not add Princeton, Harvard, Yale, MIT, Stanford, Caltech, UChicago, Columbia (or similar sub-5% schools) just because ambition is "ambitious."
6. **Never** re-label a hyper-selective school as "target" for a mid GPA. Hooks help at the margins; they do not invent mid-50% stats.
7. Prefer major/program fit + cost + setting over prestige rank. OOS publics and impacted majors are often harder than overall admit %.
8. At most one binding ED/REA priority school.
9. No duplicate campuses (e.g. "University of Texas" + "UT Austin").
## Must-include schools (keep these; already on the list as priority seeds)
${must}
## College list — ALREADY SEEDED (academically matched) — AUTHORITATIVE STRUCTURE
The server already filled a preliminary shortlist around the must-includes using the student's GPA/SAT + prefs. You will see them in the workspace snapshot.
- **Do NOT replace, gut, or lottery-up the seeded list.** Enrich notes, majors, deadlines, and honest tiers.
- Do NOT call remove_college on seeded schools unless they are clear duplicates.
- If you see pure lotteries already on the list that the student did not request, **remove_college** them and strengthen targets/safeties instead.
- Match reach/target/safety to the real academic profile (e.g. ~3.5 UW + 1500 SAT → mostly 30–55% targets, 15–30% reaches, real safeties; a couple major-fit dreams OK).
- **UC Application = one app for all UC campuses.** Keep a sensible UC mix (not every campus as "reach").
- Use web_search to verify admit rates, deadlines, and major strength before enriching with upsert_college.
- You MAY add 1–3 schools if the list is thin on **targets/safeties**; prefer those tiers over more ultra-reaches.
- If upsert_college is rejected as lottery/ultra, do **not** retry; pick a better-fit school.
## Uploads to read with read_upload if relevant
${uploadLine}
## Required tasks (do all)
1. set_applicant_snapshot + set_profile_identity + set_testing from the structured fields.
2. Parse activities → set_activities (rank by importance; include role, hours, years, desc when present).
3. Parse awards → set_honors; set awards count on the snapshot.
4. Read uploads and merge any extra structured data (coursework, more activities, etc.).
5. Review the seeded college list: enrich tiers/deadlines/major fit; top up **targets/safeties** if thin. Never strip to only must-includes. Never convert the list into mostly sub-10% lotteries. Remove unsolicited HYPMS if present.
6. Set a few critical_dates if you know real deadlines for the list.
7. **Essays / supplements:** The server already opened Essays-tab groups for every school (UC PIQs under slug \`uc-application\`; other schools get Why-us placeholders). When you can, web_search 2–4 priority schools' current supplement prompts and call set_essays with a *partial* supplements map (merge-safe by slug). Prefer real prompts + word limits; skip inventing full prompts for every school if short on turns.
8. Reply with a short plain-text summary: what you saved + school list with tiers and **counts** (e.g. 4 reach / 5 target / 3 safety) + which essay groups are ready. If counts look lottery-heavy, fix before finishing.
Call tools. Empty fields are better than invented numbers.`;
}
// ── Main wizard ──────────────────────────────────────────────────────────
function Onboarding({ data, onComplete }) {
const [step, setStep] = React.useState(0);
const [provider, setProvider] = React.useState(null);
const [mustHave, setMustHave] = React.useState(() => {
const cols = (data && data.colleges) || [];
const priority = cols.filter((c) => c.priority);
// Prefer explicitly marked must-haves; otherwise seed from any existing list.
return priority.length ? priority : cols.slice(0, 5);
});
const [uploads, setUploads] = React.useState(() => (data && data.uploads) || []);
const [err, setErr] = React.useState("");
const [busy, setBusy] = React.useState(false);
const [buildStatus, setBuildStatus] = React.useState("idle"); // idle | building | done
const [buildLog, setBuildLog] = React.useState("");
const a = (data && data.applicant) || {};
const p = (data && data.profile) || {};
const existingStory = (data && data.onboarding && data.onboarding.storyNotes) || {};
const existingPrefs = (data && data.onboarding && data.onboarding.listPrefs) || {};
const [draft, setDraft] = React.useState({
name: a.name || "",
gradYear: p.gradYear != null && p.gradYear !== "" ? String(p.gradYear) : "",
cycle: a.cycle || "",
hs: p.hs || "",
location: p.location || "",
intended: p.intended || "",
gpaWeighted: present(a.gpaWeighted) ? a.gpaWeighted : "",
gpaUnweighted: present(a.gpaUnweighted) ? a.gpaUnweighted : "",
sat: present(a.sat) ? a.sat : present(p.testing && p.testing.sat) ? p.testing.sat : "",
satNote: a.satNote || (p.testing && p.testing.satNote) || "",
testOptional: false,
});
const [story, setStory] = React.useState({
activities: existingStory.activities || "",
awards: existingStory.awards || "",
other: existingStory.other || "",
});
const [prefs, setPrefs] = React.useState({
ambition: existingPrefs.ambition || "balanced",
appCount:
typeof existingPrefs.appCount === "number" && existingPrefs.appCount >= 8
? existingPrefs.appCount
: null,
settings: existingPrefs.settings || [],
size: existingPrefs.size || "any",
regions: existingPrefs.regions || [],
notes: existingPrefs.notes || "",
});
const set = (key) => (e) => setDraft((d) => ({ ...d, [key]: e.target.value }));
const loadStatus = React.useCallback(async () => {
try {
const res = await fetch("/api/ai/status", { credentials: "same-origin", cache: "no-store" });
if (!res.ok) return null;
const j = await res.json();
setProvider(j);
return j;
} catch (e) {
return null;
}
}, []);
React.useEffect(() => {
loadStatus();
}, [loadStatus]);
React.useEffect(() => {
if (data && data.uploads && data.uploads.length) setUploads(data.uploads);
}, [data]);
const connected = provider && provider.active;
const providerLabel = connected
? provider.active === "grok"
? "Grok"
: provider.active === "codex"
? "ChatGPT"
: "AI"
: null;
const identityOk =
draft.name.trim() &&
draft.hs.trim() &&
draft.intended.trim() &&
(draft.gradYear.trim() || draft.cycle.trim());
const academicsOk = present(draft.gpaWeighted) || present(draft.gpaUnweighted);
const canNext = () => {
const id = STEPS[step].id;
if (id === "welcome") return true;
if (id === "connect") return Boolean(connected);
if (id === "identity") return Boolean(identityOk);
if (id === "academics") return Boolean(academicsOk);
if (id === "story") return true;
if (id === "prefs") return true;
if (id === "upload") return true;
if (id === "build") return Boolean(connected) && identityOk && academicsOk;
return false;
};
const stepError = () => {
const id = STEPS[step].id;
if (id === "connect" && !connected) return "Connect Grok or ChatGPT to continue.";
if (id === "identity" && !identityOk) return "Name, high school, intended major, and grad year are required.";
if (id === "academics" && !academicsOk) return "Enter at least one GPA (weighted or unweighted).";
if (id === "build" && !connected) return "AI connection required to build the hub.";
return "";
};
const goNext = () => {
const msg = stepError();
if (msg) {
setErr(msg);
return;
}
setErr("");
if (step < STEPS.length - 1) setStep((s) => s + 1);
};
const goBack = () => {
if (buildStatus === "building") return;
setErr("");
if (step > 0) setStep((s) => s - 1);
};
const finish = async () => {
if (!canNext()) {
setErr(stepError() || "Fill required fields first.");
return;
}
const fresh = await loadStatus();
if (!fresh || !fresh.active) {
setErr("AI connection lost. Go back to Connect and sign in again.");
setStep(1);
return;
}
if (!identityOk || !academicsOk) {
setErr("Some required fields are missing. Go back and complete them.");
return;
}
setBusy(true);
setErr("");
setBuildStatus("building");
setBuildLog("Saving your answers…");
try {
const sat = draft.testOptional ? "—" : draft.sat.trim() || "—";
const satNote = draft.testOptional ? "Test optional" : draft.satNote.trim();
const saveRes = await fetch("/api/workspace", {
method: "POST",
credentials: "same-origin",
headers: { "content-type": "application/json" },
body: JSON.stringify({
action: "complete-onboarding",
applicant: {
name: draft.name.trim(),
cycle: draft.cycle.trim() || (draft.gradYear.trim() ? `Fall ${draft.gradYear.trim()}` : ""),
year: draft.gradYear.trim() ? `Class of ${draft.gradYear.trim()}` : "",
gpaWeighted: draft.gpaWeighted.trim() || "—",
gpaUnweighted: draft.gpaUnweighted.trim() || "—",
sat,
satNote,
},
profile: {
intended: draft.intended.trim(),
hs: draft.hs.trim(),
gradYear: draft.gradYear.trim() || "",
location: draft.location.trim(),
},
testing: { sat, satNote },
storyNotes: {
activities: story.activities,
awards: story.awards,
other: story.other,
},
listPrefs: {
ambition: prefs.ambition || "balanced",
appCount: typeof prefs.appCount === "number" ? prefs.appCount : null,
settings: prefs.settings || [],
size: prefs.size || "any",
regions: prefs.regions || [],
notes: prefs.notes || "",
},
}),
});
const saveJ = await saveRes.json();
if (!saveRes.ok || saveJ.success === false) {
throw new Error(saveJ.error || "Could not save onboarding.");
}
const savedWs = saveJ.data || saveJ;
const seededN = (savedWs.colleges && savedWs.colleges.length) || 0;
setBuildLog(
seededN
? `Seeded ${seededN} schools · structuring profile with AI…`
: "Asking the AI to build your hub…"
);
const prompt = buildAiPrompt({ draft, story, prefs, mustHave, uploads });
const aiPrefs = loadAiPrefs();
const body = {
messages: [{ role: "user", content: prompt }],
};
if (aiPrefs.preferred && aiPrefs.preferred !== "auto") body.provider = aiPrefs.preferred;
if (aiPrefs.grokModel) body.grokModel = aiPrefs.grokModel;
if (aiPrefs.codexModel) body.codexModel = aiPrefs.codexModel;
if (aiPrefs.opencodeModel) body.opencodeModel = aiPrefs.opencodeModel;
const chatRes = await fetch("/api/ai/chat", {
method: "POST",
credentials: "same-origin",
headers: { "content-type": "application/json" },
body: JSON.stringify(body),
});
if (!chatRes.ok || !chatRes.body) {
let msg = `AI request failed (${chatRes.status}).`;
try {
const j = await chatRes.json();
if (j.error) msg = j.error;
} catch (e) {}
throw new Error(msg + " Your basics were saved — open the hub and ask the copilot to finish.");
}
const reader = chatRes.body.getReader();
const dec = new TextDecoder();
let buf = "";
while (true) {
const { done, value } = await reader.read();
if (done) break;
buf += dec.decode(value, { stream: true });
let idx;
while ((idx = buf.indexOf("\n")) >= 0) {
const line = buf.slice(0, idx);
buf = buf.slice(idx + 1);
if (!line.trim()) continue;
let ev;
try {
ev = JSON.parse(line);
} catch (e) {
continue;
}
if (ev.type === "status") {
const soft = window.cfChatStatus && window.cfChatStatus.softenStatusMessage
? window.cfChatStatus.softenStatusMessage(ev.message)
: ev.message;
setBuildLog(soft || "Working…");
} else if (ev.type === "tool") {
const label = window.cfChatStatus && window.cfChatStatus.friendlyToolMessage
? window.cfChatStatus.friendlyToolMessage(ev.name, ev.path)
: "Updating your hub…";
setBuildLog(label);
} else if (ev.type === "error") {
throw new Error(ev.message || "Something went wrong while building.");
} else if (ev.type === "done") {
setBuildLog("Finishing up…");
}
}
}
setBuildLog("Loading your hub…");
const wsRes = await fetch("/api/workspace", { credentials: "same-origin", cache: "no-store" });
const ws = await wsRes.json();
setBuildStatus("done");
setBuildLog("Done");
// Brief beat so the user sees success, then hand off
await new Promise((r) => setTimeout(r, 600));
if (onComplete) await onComplete(ws.data || ws);
} catch (e) {
setBuildStatus("idle");
setBuildLog("");
setErr(e.message || "Could not build hub.");
// Basics may already be saved; still try to unlock if workspace is complete
try {
const wsRes = await fetch("/api/workspace", { credentials: "same-origin", cache: "no-store" });
const ws = await wsRes.json();
const dataWs = ws.data || ws;
if (dataWs && dataWs.onboarding && dataWs.onboarding.completed && onComplete) {
// Offer path forward via error + allow manual open — do not auto-complete on failure mid-build
}
} catch (e2) {}
}
setBusy(false);
};
const id = STEPS[step].id;
const isLast = step === STEPS.length - 1;
const building = buildStatus === "building";
return (
✱College Forge
{id === "welcome" ? (
Get started
Set up your applications hub
Connect an AI, share who you are and as much of your story as you want, tune college-list preferences,
then let the copilot build your hub and a preliminary school list.
Connect Grok or ChatGPT
Basics, academics, activities, awards — pile on detail
List strategy: ambitious, just right, or conservative