Checklist Map
checklist_mapHow far along am I in a program at a school I am considering? One checklist at any target school, chosen by its name or title (or its checklist_id), line by line against what a person holds. Each held item is compared through the combined check. Two equal sources, four steps run side by side: (1) comparability direct from CourseShelf - the receiver's own published mappings; (2) known equivalencies direct from CourseAtlas, live - what institutions report, CollegeBoard's among them as CourseAtlas carries them; (3) inferred comparability from CourseShelf's comparability anchors (hop 1: an exam at a shared score, a state course, a mapping, crossing kinds); (4) inferred equivalency from CourseAtlas's equivalency anchors (hop 2, its own chain). kind narrows them: known runs 1 and 2, inferred runs 3 and 4, both runs all four. Each landing is joined to the checklist's lines; a GoldRibbon package, when given, adds the lines its prior learning may meet. Each line is met (a known mapping lands a held item on it), reached_by_inference (only an inferred landing reaches it: shown with its path of published links, never counted as met), may_be_met_by_prior_learning, or open, with every way it is reached. Each group gives its lines by state beside the choice rule it prints. Last, what does not count: each held item that reaches no line, with its reason (no rule, below the score, landing on a course this checklist does not require, unresolved, not held, or a source not read - never an absence). A case to show the school, not a verdict; recognition is the school's act. Each row names its current FORM's wording source: source_url, capture_file, catalog_year and source_catalog_name are that one source's, never the record's whole span. A row whose record holds more than one form or more than one source also carries version_count, source_count, first_edition_seen and last_edition_seen, and one sentence saying so in words; a record with one form and one source carries none of them and reads exactly as it always has. The forms themselves, each with its own content and its own sources, come from the one-record get, never from a list. A record last seen in an older edition says so, because the Union keeps a record no current catalog prints.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"target_unitid": "<target_unitid>"
},
"name": "checklist_map"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| held | No | 1 or more things held, the whole list, each as comparable_map takes one: a course { unitid or school, code }, an exam { program, exam, score }, { learning_unit_id } or { certification_ctid }. Compared 5 per call: an answer with more to compare carries `continue.arguments` to send back as they are | |
| kind | No | Optional: known (steps 1-2, the default), inferred (steps 3-4) or both; the inferred steps run only when asked for | |
| depth | No | Optional: the most published links an inferred path may take, 1 to 3 (default 2); carried in continue.arguments, send it back unchanged | |
| carried | No | Set by `continue.arguments`: the map's progress so far, sent back unchanged | |
| package | No | Optional: the person's GoldRibbon package; its prior learning is read on the first call for the lines it may meet | |
| sources | No | Optional information-source selection: all (default), or a nonempty array of distinct numbers: 1 gathered published CourseShelf comparables, 2 school-published CourseAtlas equivalencies, 3 inferred CourseShelf comparability through anchors, 4 inferred CourseAtlas equivalency through anchors. Any combination is allowed. An explicit kind intersects this selection; an empty intersection is invalid. Unselected engines report not_requested. Required identity/reference reads may still be needed. Send continuation arguments unchanged. | |
| audience | No | Optional: who the answer is for. student (the default): a course at the target school itself is met from the student's own transcript, or as entered, unless its grade is failing (F, U, NC) or withdrawn (W). institution: the target's own course counts only with explicit earned-credit or completion evidence. Carried in continue.arguments; send it back unchanged. | |
| checklist | No | The checklist at the target by its program name or award title, e.g. Computer Science, A.S. (TTP); several fitting are listed, never guessed | |
| held_offset | No | Set by `continue.arguments`: the held item to start this call's 5 from | |
| checklist_id | No | Or the checklist's id, from find_checklists | |
| target_unitid | Yes | The school whose checklist is mapped, by IPEDS UNITID, e.g. 240727 | |
| courseatlas_depth | No | Optional: CourseAtlas's chain depth, 1 to 3 (default 2, the transfer map's own); carried in continue.arguments, send it back unchanged |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lines | No | Every line: its actual line_group_id and heading, item identity, alternatives, printed credit fields, state and reached_by (each way: how, held item, actual receiving learning unit, lands_as, band, rule or path, rests_on, minimum_grade, also_needs). held_at_receiver is own-course applicability; unconfirmed earned evidence is not met | |
| counts | No | Line states: met only where shared applicability support establishes an unconditional known or earned receiver-owned landing; inferred, prior-learning and open remain separate. Conditional evidence is retained without a met claim; group allocation determines program progress. | |
| groups | No | Actual group ID, published rule, non-additive status and separate confirmed/inferred_potential allocations, surplus, remaining item IDs/choices, credit lower bounds, nullable satisfaction and missing evidence | |
| limits | No | ||
| credits | No | The lines' printed credits, summed by state, each its own | |
| compared | No | Cumulative item summaries across pages: item, state, reason, lines_reached and incomplete. An incomplete read is not evidence that no mapping exists. | |
| complete | No | Pagination completion: every held item has been visited. Source reads may still be incomplete; inspect compared and the detailed comparison steps. | |
| continue | No | When more held items remain: compared_through, of, and the arguments for the next call (the next 5, with the progress carried); null when every held item is compared | |
| contract | Yes | ||
| checklist | No | ||
| statement | Yes | ||
| candidates | No | When the name fits several checklists, or none | |
| comparisons | No | Full combined answers for this page only: held identity and read_as, state/reason/statement, known mappings, exam tiers with held score placed, inferred landings with supplied paths and conditions, lands_as with applicability, checklist_lines and steps. Retain every page's comparisons; they are not carried into continuation | |
| next_actions | No | ||
| credits_basis | No | Labels credits as sums of line states; these are not allocated program completion credits | |
| does_not_count | No | Each held item that reaches no line: item, reason, statement. Timeout, unread source, unreadable minimum, inactive rule, unresolved target course and a completed search finding no rule are distinct. Landings remain in this page's comparisons even when applicability is unresolved | |
| comparison_scope | No | This page's held_offset, compared_through and total of; comparisons are page-local while compared and line progress remain cumulative | |
| program_progress | No | Published denominator and group-constrained allocations, confirmed progress separately from inferred potential. Each scenario retains allocations, remaining groups, missing inputs, lower bounds and nullable exact applied_credits, credits_remaining and percent_complete. Receiving-unit credits count once. Missing policy, conditions, credit totals or compatible units prevent exact claims. pagination_complete and source_incomplete state the scope of the evidence | |
| source_reads_complete | No | Whether selected source evidence completed, distinct from held-item pagination. A response-window limit, failed read or retained incomplete page prevents a complete-source claim; checklist_map includes prior-learning evidence in this scope. |