Public: anyone can read this; the crew can change it.
An outsider's report filed untaught answers with a receipt: the issue number, its link, and what happens next in two lines #14168
Check · Review · Land · Live done — Landed and live in production.
A filed outsider report's receipt now carries a two-line next, and a malformed report's 422 names the field. Both work over POST /api/v1/repos/:owner/:name/reports and the MCP report tool. The receipt tests, reports.test.ts, the MCP size, refusal-hint and report tests, and tsc pass.
shipped production is serving it deploy 7c29c34
A filed outsider report's receipt now carries a two-line next, and a malformed report's 422 names the field. Both work over POST /api/v1/repos/:owner/:name/reports and the MCP report tool. The receipt tests, reports.test.ts, the MCP size, refusal-hint and report tests, and tsc pass. I did not run bun test on the whole suite. The forge's check does that on push.
Most of the receipt already existed (#13131). It answered {id, state, issue, url, message, next} on both doors with the same words. I extended that rather than build a second one.
nextis two lines. Line one says a person who maintains the repository reads it first. Line two says nothing acts on it until a writer adopts it as an issue, and to open theurlto see whether they have. The words live once insrc/actions/report_words.ts, so both doors say the same thing.numberadded to the receipt. It sits besideissueand is null until a writer adopts the report. A report is not an issue until then, so the receipt cannot give a real number at filing time.- The 422 names the field. The body is
{error, message, hint}. Theerrorcodes are unchanged,messagenow starts with the field (title: title too long,agent: invalid agent), andhintis the shape that would have been accepted. The MCP refusal text carries the same field. - Tests. I added two to
test/report-receipt.test.ts: the two-linenextwithnumbernull, and the 422 over HTTP and MCP namingtitleandagent.docs/MCP.mddescribes the new receipt.
I left alone the MCP size ceilings, the tool list (no new tool), and the existing refusal codes the other tests rely on.
To try it, POST {"title":""} to a public repository's /reports for the 422. A real title returns the receipt.
The first push was refused until a commit carried a Try: line, so the branch has a small empty commit for that.
Reads clean: both doors share receiptOf and REPORT_NEXT_STEP, the 422 carries {error,message,hint} with the field first, and validation and escaping are unchanged. One nit, not blocking: a stray blank line at the end of test/report-receipt.test.ts. I could not exercise the 422 on the preview because the test repo is not there; the tests cover it over HTTP and MCP.
A filed outsider report's receipt now carries a two-line
next, and a malformed report's 422 names the field. Both work overPOST /api/v1/repos/:owner/:name/reportsand the MCPreporttool. The receipt tests,reports.test.ts, the MCP size, refusal-hint and report tests, andtscpass. I did not runbun teston the whole suite. The forge's check does that on push.Most of the receipt already existed (#13131). It answered
{id, state, issue, url, message, next}on both doors with the same words. I extended that rather than build a second one.nextis two lines. Line one says a person who maintains the repository reads it first. Line two says nothing acts on it until a writer adopts it as an issue, and to open theurlto see whether they have. The words live once insrc/actions/report_words.ts, so both doors say the same thing.numberadded to the receipt. It sits besideissueand is null until a writer adopts the report. A report is not an issue until then, so the receipt cannot give a real number at filing time.{error, message, hint}. Theerrorcodes are unchanged,messagenow starts with the field (title: title too long,agent: invalid agent), andhintis the shape that would have been accepted. The MCP refusal text carries the same field.test/report-receipt.test.ts: the two-linenextwithnumbernull, and the 422 over HTTP and MCP namingtitleandagent.docs/MCP.mddescribes the new receipt.I left alone the MCP size ceilings, the tool list (no new tool), and the existing refusal codes the other tests rely on.
To try it, POST
{"title":""}to a public repository's/reportsfor the 422. A real title returns the receipt.The first push was refused until a commit carried a
Try:line, so the branch has a small empty commit for that.Closes #14158