Review what the builder offered

A source becomes a durable review before it becomes a choice. A later regional change starts a new review or returns one decision to questions; it never rewrites the earlier package.

1 · Start with the source
Route /house/settings/reconcile/:reviewId · Entry. Project settings and an active billing handoff open the same synced review; neither invents one.
Review a builder document

Start with the plan or package your builder gave you. I will show what it offers before anything changes.

This reviewWaiting for a source
What stays putYour earlier decisions
Choose a source Back to project settings
The task has an identity

The entry row carries the synced review ID. It is not a fresh upload screen and cannot silently replace a previous record.

2 · Choose the source
Route /house/settings/reconcile/:reviewId · State source-selection. An already retained builder package and a new upload are separate choices.
Choose the source

Use a document already on this project, or add the newer package.

Already on this project
Hollis cabinet package.pdfAdded by Dave · 18 MayUse this
A newer source
Plan or packageUpload a file

The document is retained as soon as the server acknowledges it, even if the next step cannot start.

Use this builder package Back to review
3 · Reading the source
Route /house/settings/reconcile/:reviewId · State processing. The durable attempt keeps working after this screen is left.
Reading the builder package

This can take a moment. You do not need to keep this screen open.

Looking for the decisions this package makes, not guessing at anything it does not say.

SourceHollis cabinet package.pdf
StatusReading
Leave and return to project settings
4 · Reading stopped
Route /house/settings/reconcile/:reviewId · State failed. A stable failure leaves the source and the earlier review on the record.
I could not read this package

Nothing was changed. Your builder package is still here.

The package did not produce a usable review. Try this source again, or choose a different plan or package.

Retained sourceHollis cabinet package.pdf
Earlier decisionsUnchanged
Try this package againChoose a different sourceBack to project settings
5 · Ready to compare
Route /house/settings/reconcile/:reviewId · State ready. The extractor has settled one candidate set; comparison is a separate route.
Your builder package is ready

Review what it offered before it changes your project questions.

SourceHollis cabinet package.pdf
What is nextCompare each offer with your record
Compare what it offeredBack to project settings
6 · A newer review is ready
Route /house/settings/reconcile/:reviewId · State successor. A replacement source starts a new immutable review; it does not change the finished one.
The newer package is ready

This is a new review of the newer source. The earlier package remains part of the record.

Earlier reviewCompleted 18 May
New sourceCabinet revision 3.pdf
Compare the newer offerBack to project settings
7 · Source review while offline
Route /house/settings/reconcile/:reviewId · State offline. Synced facts stay readable; attaching, retrying, and starting a successor wait for a connection.
You are offline

The last synced review is still here. I will not pretend a source was attached until the connection returns.

Last synced sourceHollis cabinet package.pdf
Review statusWaiting for a source

Choose, retry, and compare when you are connected again.

Back to project settings
8 · Compare the first offer
Route /house/settings/reconcile/:reviewId/compare · State initial-comparison. A candidate with no earlier assertion is an offer, not an automatic decision.
What the package offered

Choose the offers that fit this build. Nothing applies until you record this review.

New decisions

Inset cabinet doors

Cabinet package · sheet 4

Soft-close drawer slides

Cabinet package · sheet 6

Record these choicesBack to review
A first offer can be empty

The journey never treats candidate output as a command. An empty successful extraction is still an answer and has its own frame below.

9 · Compare the newer offer
Route /house/settings/reconcile/:reviewId/compare · State successor-comparison. A newer source must answer for each package-backed assertion it would replace, retain, or clear.
What changed in the newer package

The earlier package said one thing. Choose what this newer source should do with it.

New offerInset cabinet doors
ReplacesShaker cabinet fronts

From Cabinet revision 3.pdf · earlier review completed 18 May

Cabinet fronts

Replace with the newer offer

The source says inset doors.

Keep the earlier package answer

Return this decision to questions

Record these choicesBack to review
10 · Nothing new was found
Route /house/settings/reconcile/:reviewId/compare · State empty-extraction. Zero candidates is a successful result, not a missing loading state.
Nothing new was found

The package was read successfully. It did not offer a decision HouseChalk can responsibly add.

SourceHollis cabinet package.pdf
ResultNo new offers
Record this reviewBack to review
11 · Look again at what moved
Route /house/settings/reconcile/:reviewId/compare · State conflict-recovery. A completion conflict keeps only choices whose decision timestamp did not move.
One decision changed while you reviewed

Your unchanged choices are still here. Look again at the decision that moved before recording the review.

Look againKitchen tile
Still chosenInset cabinet doors
Review kitchen tile againBack to review
12 · The review is recorded
Route /house/settings/reconcile/:reviewId/compare · State completion. The exact adoption and disposition partition is now a durable record.
Review recorded

The package and the choices you made from it are now part of this project’s record.

Recorded fromHollis cabinet package.pdf
NextProject settings
Back to project settings
13 · Comparison while offline
Route /house/settings/reconcile/:reviewId/compare · State offline. Synced candidates and prior assertions remain readable; recording waits for connection.
You can still read this review

The last synced offer and earlier package answers are here. I will not record a partial choice without a connection.

New offerInset cabinet doors
ReplacesShaker cabinet fronts

Last synced from Cabinet revision 3.pdf

Record the review when you are connected again.

Back to review
14 · Regional list changed
Route /house/settings/reconcile/:reviewId/remediate/:decisionId · State retained-source. The earlier package stays on the record while one decision is repaired.
Review what the builder offered

The regional options changed after this package set the cabinet hardware. Choose how to reconcile this one decision.

Earlier packageHollis cabinet package.pdf
Package answerMatte brass pulls
Process the earlier package againChoose a newer plan or packageReturn this decision to questionsBack to review
Three outcomes, one record rule

Reprocess creates a successor from the retained source; replacement retains the new document before starting its successor; clear is an attributed package-mode clear. None edits the completed review.

15 · Replace the source
Route /house/settings/reconcile/:reviewId/remediate/:decisionId · State replacement. A new plan or builder package is retained before its successor is attempted.
Use the newer builder package

Choose the source that should answer for this regional change.

Builder package
Cabinet revision 3.pdf
The new document remains on the project once it is saved.
Upload and start the newer reviewBack to regional repair
16 · Return this decision to questions
Route /house/settings/reconcile/:reviewId/remediate/:decisionId · State clear. Clear is a separate, attributed package-mode act; the earlier package remains visible.
Return cabinet hardware to questions

This does not erase the earlier package. It returns this decision to the project’s active questions.

Will stay in the recordHollis cabinet package.pdf
Will changeCabinet hardware becomes a project question
Return cabinet hardware to questionsBack to regional repair
17 · Regional repair while offline
Route /house/settings/reconcile/:reviewId/remediate/:decisionId · State offline. The source and explanation remain readable; all three outcomes wait for connection.
You are offline

You can see why this decision needs repair. Reprocess, replacement, and clear wait until the project can be updated.

Earlier packageHollis cabinet package.pdf
DecisionCabinet hardware
Back to review
18 · The saved source still needs a next step
Route /house/settings/reconcile/:reviewId/remediate/:decisionId · State conflict. The replacement document is retained after a successor conflict; retry does not ask for the file again.
The newer package is saved

Starting the newer review is the only step left. You do not need to upload the package again.

Saved sourceCabinet revision 3.pdf
What did not happenThe newer review did not start
Start the newer review againBack to review