A pull's looks

Looks are the pictures of a pull's preview: the forge's own once the deploy is green, and the ones a person or agent attaches (POST …/pulls/:number/looks, MCP attach_look). This is the read side, so an agent can check what it attached.

One list, one rule (pullLooks in src/looks/readable.ts), three doors:

{ items: [{ id, width, says, by, commit, url, at }] }, newest first. url is the same one the POST answers. Beside items comes fit, for the pull's latest commit: one { page, width, scrollWidth, innerWidth, screens, sideways } per page and width that has a stored size (screens = scrollHeight / innerHeight to one decimal, sideways = scrollWidth > innerWidth). Numbers only, no url, owner-taken looks included, for any reader of the pull; a sealed pull's fit is the writers'. Looks without a size are absent.

The home page is pictured at four widths: phone (390 px), narrow (360 px, home only), desktop and the thumb. In the API, MCP and terminal the 360 px look is width: "narrow"; on the pull page it sits beside the phone picture under the caption 360 px, and its dark twin in the dark fold. It counts in the pairs line like the other widths.

Above the pictures on the pull page, and at the top of the terminal screen, one line counts the pages shown beside main and those main has no picture of (4 pages beside main · 1 new to this pull); when main has no pictures at all it says so once. Both doors share the count in src/looks/pairs.ts.

Who sees what is mayFetchLook, the rule the pictures themselves use: a reader who may not read the repository gets 404; a writer sees every look that has a picture; anyone else sees only those taken as nobody, of an app they may enter, and not those of a sealed pull. A look that failed (no picture) is never listed. Only the pull's own preview environment is read, so another pull's or app's looks never appear. A pull with no app or no looks answers items: [].

The check summary's looks

GET …/pulls/:number/checks (and …/commits/:oid/check) answers looks: one { look, screens, sideways, size? } per look the looks service recorded for that commit, size being the measured { scrollWidth, scrollHeight, innerWidth, innerHeight } — so phone /preview-admin/sample/settings#move can be quoted as scrollWidth vs innerWidth. They are taken only for a preview of the forge's own repository (ownerLooksFor), at the pull's head once its preview serves. Each look is filed under the commit the moment it is taken (addCommitLook), not when the round of about fifty ends: a round cut short by a newer head or a restart used to file nothing, and the next round filed only what it still lacked, so the check's list stayed [] or partial. The list now fills as the round goes, and is complete when …/looks lists every page.

A stylesheet change is approved beside its looks

A pull that changes a stylesheet source (src/web/style/) cannot be approved until its preview has a home-page look at phone and desktop width taken at its head (missingHomeLooks in src/looks/style_looks.ts; submitReview answers looks_required, in the same words on the page, API, MCP and terminal). Main's picture of the page sits beside them on the pull page, so the reviewer sees before and after. A comment or a request for changes is never held. A repository with no app has no looks to wait for.

If the preview never takes a home look (a failed boot, say), the approval stays held. Only looks the forge took count, so one attached by hand does not clear it. Fix the boot and push: the new head gets its looks. There is no override: a change that cannot be previewed is sent back to be fixed. A repository with no app is never held.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs