get_job_brief_revision_proposal
Get a job's pending brief-revision proposal
All MCP toolsRead
Read the PENDING proposal the nightly scan wrote for a job's private brief: edits it drew from the team's own decline reasons and evaluation notes, each with its rationale and the surviving evidence rows behind it, plus how many judged candidate pairs applying it would send back for re-judgment. null when nothing is pending — a decided proposal has left the screen too. Nothing changes until apply_job_brief_revision_proposal is called with the items the team chooses; dismiss_job_brief_revision_proposal closes it. The proposal is judgment material about the private brief and is never shown to candidates.
Input schema
{
"type": "object",
"properties": {
"jobId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The job whose pending proposal to read (jobs.id)."
}
},
"required": [
"jobId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Output schema
{
"type": "object",
"properties": {
"jobId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"proposal": {
"anyOf": [
{
"type": "object",
"properties": {
"proposalId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Pass as proposalId to apply or dismiss."
},
"briefVersion": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "The brief version the proposal was generated against."
},
"briefMoved": {
"type": "boolean",
"description": "true when the brief has moved past briefVersion since generation: applying refuses brief_moved and the next scan re-proposes; dismissal stays open."
},
"generatedAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "When the scan generated it (ISO 8601, UTC)."
},
"impact": {
"type": "object",
"properties": {
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"positive": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"even": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"weak": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"total",
"positive",
"even",
"weak"
],
"additionalProperties": false,
"description": "The job's judged candidate pairs and their CURRENT fit readings — how many judgments applying the proposal would send back for re-judgment; never a predicted movement."
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "The item id to pass as itemIds when applying."
},
"kind": {
"type": "string",
"enum": [
"meet_add",
"decline_rephrase",
"question_add"
],
"description": "meet_add — add a sentence to whom to meet; decline_rephrase — rephrase one existing sentence of what makes the team decline (currentText names it); question_add — add a question to confirm at the interview."
},
"currentText": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "For decline_rephrase, the sentence being rephrased as it stands today; null otherwise."
},
"proposedText": {
"type": "string",
"description": "The sentence applying the item would write."
},
"rationale": {
"type": "string",
"description": "Why the scan proposes it — the pattern it read in the evidence."
},
"evidence": {
"type": "object",
"properties": {
"declineCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Surviving decline rows behind this item."
},
"evaluationCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Surviving evaluation rows behind this item."
},
"missingCount": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Evidence rows erased since the proposal was generated — a count only."
},
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The source row (match_declines.id or candidate_evaluations.id)."
},
"source": {
"type": "string",
"enum": [
"decline",
"evaluation"
],
"description": "decline — a recorded decline of a candidate on this job; evaluation — a staff evaluation note."
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The decline kind, or the evaluation grade (S | A | B); null when the evaluation is ungraded."
},
"note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The team's own note on that row (the decline reason or the evaluation note); null when none."
},
"occurredAt": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"description": "When the row was recorded (ISO 8601, UTC)."
}
},
"required": [
"id",
"source",
"label",
"note",
"occurredAt"
],
"additionalProperties": false
},
"description": "The surviving evidence rows, newest first."
}
},
"required": [
"declineCount",
"evaluationCount",
"missingCount",
"entries"
],
"additionalProperties": false
}
},
"required": [
"id",
"kind",
"currentText",
"proposedText",
"rationale",
"evidence"
],
"additionalProperties": false
},
"description": "The proposed edits, in the scan's order."
}
},
"required": [
"proposalId",
"briefVersion",
"briefMoved",
"generatedAt",
"impact",
"items"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "The pending proposal, or null when the job has none pending."
}
},
"required": [
"jobId",
"proposal"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}