}j?$SrSSKrSSKrSSKrSSKrSSKJrJr SSKJ r \RR\RR\RR\ 555r\RR\SS5rSrSr\"S S 9"S S 55rS r\"SSS/SSS S9\"SSSS/SSSSS S SS9 \"SSSS/SSSS S S S!9 \"S"S#SS$/S%S&S'S"S S S(S9 \"S)S*SS+/S,S-S'S)S S S.S9 \"S/S0SS1/S2S3S'S)S S S4S9 \"S5S6SS7/S8S9S:S S;9\"SS?/S@SAS'S)S S SBS9 \"SCSDSSE/SFSGS'S S;9\"SHSISSJ/SKSLS'S)S SM9\"SNSOSSP/SQSRS'S)S SM9\"SSSTSSU/SVSWS'S S;9\"SXSYSSZ/S[S\S]SXS S S^S9 \"S_S`S>/SaSb5\"ScSdSe/SfSg5\"ShSiSjSk/SlSmSnSo9\"SpSqSSr/SsStSuSo9\"SvSwSSx/SySzS S{9\"S|S}SS~/SSSSo9\"SSSS/SSSSSS9\"SS/SQSS5\"SSSS/SSSSSS9\"SSS>S/SSS'S)S SS9 \"SSS>S/SS3S'S)S SS9 \"SSS>S/SSSSo9\"SSS>S/SSSS9\"SSS/SSS SS94Vs0sHoR*U_M snrSSSSSS.rSrSr"SS\5rSSjrSSS.rSrSSjrSSjr Sr!gs snf)a^ The one registry of everything BidBrain can run, and the one way a run reports and finishes (Steven 2026-09-02: "check the way all of the runs are set up... it all seems sporadic, sometimes runs work, sometimes they dont, sometimes the icon shows things its not supposed to... the maintenance checks dont always act like the auction house runs. it needs simplified and work correctly, consistently and look the same across all screens"). Before this, the same 17 runs were described in five hand written maps in serve.py (proc slots, stop keys, labels, sites, gates) that had drifted apart, and finished through four separate helpers in four scripts. Now: RUNS one entry per run: key (the db.run_status key, used everywhere, never renamed on the way), label, the argv that starts it, the connection it belongs to, the Settings toggle that gates it, whether it opens a browser window, and its scope (bulk, row, login). progress() the shared progress file write (was daily_run._progress). finish() the terminal write: progress AND the durable run record in one call (was daily_run._finish, purchases_run._finish_sync, lost_bids_run._finish, share_comps._record). A row scoped run writes progress only, by design: one car's problem lives on the purchases page's own bar, never the app wide light. guard() wraps a script's entry point so it CANNOT end without a terminal write: a normal return, a RunSkipped (switched off in Settings, nothing to do), any exception, SystemExit and Ctrl-C all land in finish(). "skipped" is a real phase, grey, never red: off is not broken. Pure data plus file and db writes, no browser, importable by every script and by serve.py. N) dataclassfield)dbdatazrun_progress.json)stockreadingvaluingphotoswritingz glass-loginzclickdealer-loginzdealerkit-login)doneerrorskippedstoppedT)frozenc\rSrSr%\\S'\\S'\\S'\\S'\\S'Sr\\S'Sr\\S 'S r \ \S 'S r \\S 'S r \ \S'Sr \\S'S r\ \S'Srg)Run6keylabelargvbusystartingNsitegateFheadedbulkscopewinconfirmquiet)__name__ __module__ __qualname____firstlineno__str__annotations__tuplerrrboolrrr r!__static_attributes__r"./Users/stevendouglas/BidBrain/bidbrain/runs.pyrr6sa H J K IMD#D#FDE3CGSE4r,rc 2[SX[U5X4S.UD6$)N)rrrrrr")rr))rrrrrkws r-_rr0Fs  Z3%+D ZWY ZZr,runz The daily runz daily_run.pyzA daily run is in progress.zStarting a daily run...)rglasszGlass's checksz--glasszA Glass's pass is in progress.zStarting a Glass's pass...zRun Glass's checks now? A Glass's login window opens on the Mac. Log in there, then it adds Glass's to these cars and re prices.)rrrrr clickdealerzClickdealer stockz --clickdealerz(A Clickdealer stock pass is in progress.z$Starting a Clickdealer stock pass...zWRun the Clickdealer stock refresh now? A Clickdealer window opens on the Mac if needed.)rrrr dealerkit_stockzDealerKit stockz --dealerkitz&A DealerKit stock pass is in progress.z"Starting a DealerKit stock pass... dealerkitzRun the DealerKit stock refresh now? A DealerKit login window opens on the Mac if needed, then it refreshes the in stock and gap flags. Keeps the existing valuations, no re valuing.dealerkit_purchaseszDealerKit purchases pushz--dealerkit-purchasesz*A DealerKit purchases push is in progress.z&Starting a DealerKit purchases push...aPush new purchases into DealerKit now? A DealerKit login window opens on the Mac if needed, then every purchase not already there gets added as a Due In record with its photos, service history documents and purchase price. Retail price is left for you to set.dealerkit_checkzThe DealerKit record checkz--dealerkit-checkz!A DealerKit check is in progress.zStarting a DealerKit check...zCheck every purchase against its real DealerKit record now? This opens a DealerKit window and reads them all, it can take a few minutes.motorway_probezMotorway one off checkz--motorway-probez A Motorway check is in progress.z,Checking Motorway's export and a car page...motorway)rr!dealerkit_surveyzDealerKit costs screen surveyzpurchases_run.pyz--survey-dealerkitz/A DealerKit costs screen survey is in progress.z&Looking at DealerKit's costs screen...zLook at DealerKit's costs screen for one car and write every step down? A DealerKit window opens on the Mac. Nothing is saved on DealerKit.dealerkit_probezDealerKit API probez--dealerkit-probez%A DealerKit API probe is in progress.zProbing DealerKit's APIs...dealerkit_stageszDealerKit stage checkz--dealerkit-stagesz'A DealerKit stage check is in progress.zChecking DealerKit's stages...)rrr!dealerkit_sale_priceszDealerKit sale price readz--dealerkit-sale-pricesz+A DealerKit sale price read is in progress.z#Reading what a sold car went for...sales_backfillzSales history backfillz--sales-backfillz(A sales history backfill is in progress.z'Sending every past sale to Dealer OS...lecapital_fundingzLE Capital funding syncz--lecapital-fundingz*An LE Capital funding sync is in progress.z&Starting an LE Capital funding sync... lecapitalaNSync DealerKit funding with LE Capital now? A window opens on the Mac for LE Capital and, if needed, DealerKit logins, then it reads LE Capital's Current Stock and Stock History and adds or settles DealerKit funding records to match. A value disagreement on a car live on both sides is only ever reported, never changed automatically. purchaseszPurchases syncz A purchases sync is in progress.zStarting a purchases sync... lost_bidszDidn't win synczlost_bids_run.pyz!A Didn't win sync is in progress.zStarting a Didn't win sync... compmatchzCompMatch synczshare_comps.pyz--syncz A CompMatch sync is in progress.zStarting a CompMatch sync...a8Sync CompMatch data with the other dealership on this repo? Pulls their latest comps, then commits and pushes your own (make/model, winning price, retail, mileage, age, transmission, engine size and grade only, never a registration, price breakdown or margin). Needs DEALER_NAME set in your own dealer_config.py.)r watchlistzWatchlist syncz--watchlist-syncz A watchlist sync is in progress.zStarting a watchlist sync...zASync your starred cars to the auction houses' own watchlists now? deep_readzShortlist deep readz --deep-readz%A shortlist deep read is in progress.z*Reading the shortlisted cars' own pages...)r! under_offerzUnder offer checkz --under-offerz$An under offer check is in progress.z Starting an under offer check...z`Check Motorway and Carwow for cars under offer now? Reads both platforms, takes a minute or two.dealer_os_pushzDealer OS pushz--dealer-os-pushz A Dealer OS push is in progress.zStarting a Dealer OS push... dealer_oszSend the current list (shortlisted and held cars, with prices) into Dealer OS now? This happens automatically after every run, so only use this to re send.)rrr install_schedulezTimed jobs setup)zsetup_schedule.pyz --installrBrFz The timed jobs are being set up.z7Setting up the Didn't win and Under offer timed jobs...dealer_os_pullzDealer OS syncz--dealer-os-pullz A Dealer OS sync is in progress.zStarting a Dealer OS sync...zCollect stars, hides, views and run requests made in Dealer OS now? This happens on its own every few seconds while the cockpit server is up, so only use this to force it.dealerkit_push_rowzDealerKit pushz--push-dealerkitz,A DealerKit push for one car is in progress.zStarting a DealerKit push...row)rrrrdealerkit_check_rowzDealerKit record checkz--check-dealerkitz-A DealerKit check for one car is in progress.retail_repricezRe price retail estimatesz--reprice-retailz#A retail re pricing is in progress.zRe pricing retail estimates...zRe price every live car's Retail est. with this dealership's own margin and price ending from Settings? A figure typed in by hand is left alone. A Due in car on DealerKit has the new figure sent there by the next automatic run.purchase_checkzPurchase re readz--check-purchasez"A purchase re read is in progress.zStarting a purchase re read...)rloginz Login windowzlogin.pyzA login window is open.zOpening a login window...)rrMotorwayCarwow Auction4CarszDealer Auction DealerWay)r9carwow auction4cars dealerauction dealerwaycfU[;a[UR$[RX5$)z>What a run_status key is called on screen, platforms included.)RUNSrPLATFORM_LABELSgetrs r- label_forr^s( d{Cy   s ((r,c [R5VVs0sHQupURS:wdMXRURUR URUR S._MS snn$s snnf)ztThe part of the registry a page needs: label, whether to confirm and with what, and whether it is one car's own job.rP)rr rrr)rZitemsrrr rr)krs r-client_registryrcse   <$7(: :AQYY!((ajj: :$ << A4c\rSrSrSrSrg) RunSkippedzRaised by a run that has nothing to do and should say so without being a failure: switched off in Settings, not configured on this Mac, no saved run to work on. Lands as phase "skipped", grey, never red.r"N)r#r$r%r&__doc__r+r"r,r-reresKr,reFc $[[SSS9n[R"XUU[ U5[ R "5U=(d [ RS5S.U5 SSS5 g!,(df  g=f![a gf=f)aWrite the shared progress file every page's bar and light read. Best effort: reporting must never break the run it reports on. `key` names the pass the line belongs to (begin() sets it for the whole pass), so Dealer OS can say "Purchases sync: reading..." rather than a bare line and can tell which pass just finished (Steven 2026-09-08: "it needs to be more clear what is happening at all times").wzutf-8)encodingr)phasemessager totalpartialtsrN) openPROGRESSjsondumpr*time_stater\ Exception)rkrlr rmrnrfs r-progressrxsn (C' 2a II4 %$w-tyy{!6VZZ%689: <3 2 2    s/BAA1(B1 A?;B?B BB)finishedrcU[S'g)zKName the pass this process is, so every progress line it writes carries it.rN)rur]s r-beginr{s F5Mr,c>U(aSOUcSOSn[RU5nU[S'UbUR(d [ XRX45 S[S'UbUR S:wag[ R"XS LUbUOS U35 g![a gf=f) aThe end of one run, both halves at once: the terminal progress write the bar and light watch for, and the durable record the Run menu's board shows. ok=True is done, False is error, None is skipped. A row scoped run writes no record (its outcome belongs to its own page).r Nrr rTryrFz Skipped. ) rZr\rur!rxrrrecord_run_statusrv)rokrlr rmrkr1s r-finishrs FBJyGE ((3-CF5M O -F: 399.  SE/(*Wiyrs D ( wwrwwrwwx'@AB 77<<f&9 : H 9 $   [ uo/$&?Nw >9"=')E '$DRS})NO+L13Y $Dhj+nm-L/1U /$GH8>Kb:c35] 3DdUV6I\8]*,K 3DdZ[1NDV3W)+Y d$:=OQe