Repository navigation
v2.1.0
🔒 Security release
This release addresses security-relevant issues — updating promptly is recommended.
Upgrade notes
This is a minor release: there are no new required env vars and no manual migration step. Seven migrations run, all additive (details below).
-
Back up first (
docs/05-runbooks/backups.md). Thestart.shpath below doesn't back up for you. -
From v2.0.0, update by hand this one time. The fixed updater ships in v2.1.0, but an update always runs the updater of the version you are leaving. On v2.0.0 or earlier,
./infra/update.sh v2.1.0(and the in-app Update command) still stop safely at the release check, after their backup, without changing anything. Run instead:git fetch --tags && git checkout v2.1.0 ./infra/start.shstart.shrecognises the existing install, keeps every secret, rebuilds and runs the migrations. From v2.1.0 on,./infra/update.sh vX.Y.Zworks again. -
What you will see.
- A short pause while the money columns widen. The money migration widens
assets.purchaseCost,assets.salvageValueandapplications.costPerSeatfromint4tobigint. PostgreSQL rewrites those two tables under a lock for a few seconds, during the update's normal outage. No value changes. - Purchases appears in the navigation for ADMINs and MEMBERs right away; the migrate job's seed applies the new default grants. VIEWERs don't get it unless you grant
purchaseOrder:readin the role matrix. - Settings moved. Outbound email, the AD/LDAP directory and the asset-tag scheme moved from Settings → Instance to their own pages.
/settings/instancekeeps its URL and is now "General & version". - AI document extraction is off until an admin turns it on under Settings → AI.
- A short pause while the money columns widen. The money migration widens
-
⚠️ Purchase documents are not in the backup yet. Files attached to purchases (POs, invoices, delivery notes) live on the attachments volume, which no backup covers yet (#1467, deferred). The purchase's documents panel says so. Until #1467 ships, use the manual workaround indocs/05-runbooks/backups.md, item 7.
Migrations (all additive):
money_bigint: widening only; everyint4value is a validbigint.purchases_core,purchases_flows,purchases_consumables,purchases_phase2: new tables, plus nullable or defaulted columns and foreign keys on existing tables.user_directory_reenabled_at: a nullable column.asset_status_labels: a new table, plus a nullablestatusLabelIdonassets.
Nothing is dropped, renamed or made NOT NULL without a default.
New & Changed
- updt(web): one translated breadcrumb on every settings page (#1533)
- updt(web): condense the reporting agents settings page (#1533)
- updt(web): split instance settings into email, directory and asset tags pages (#1533)
- updt(web): widen the offboarding sheet with impact tiles and a live act preview (#1532)
- updt(web): settings section primitives and grouped side nav (#1533)
- feat(web): a KB move that keeps every source restriction needs no confirmation (#1529)
- feat(web): confirm article and folder moves that may widen their audience (#1529)
- feat(web): classify whether a KB move changes who can read the moved articles (#1529)
- feat(api): derive hasAccessRules on both folder reads (#1299)
- feat(shared): add the derived hasAccessRules flag to the folder read shape (#1299)
- feat(web): show the custom status on the user page's assets tab (#1524)
- updt(web): rebuild the user detail page as a record page (#1525)
- updt(web): rebuild the asset detail page as a record page (#1525)
- feat(web): add the record-page primitives and their state helpers (#1525)
- feat(web): bulk Set status to a plain status clears custom statuses (#1524)
- feat(api): bulk status can ask for the bare built-in status and clear custom ones (#1524)
- feat(web): keep the custom status filter chip while its name is unresolved (#1524)
- feat(web): manage custom asset statuses on a Settings → Taxonomies → Statuses tab (#1524)
- feat(web): name custom statuses in the asset history status changes (#1524)
- feat(web): pick, show and filter custom asset statuses across the asset screens (#1524)
- feat(web): data layer for custom asset statuses and the status-or-label asset writes (#1524)
- feat(web): AI assistant copy and links for custom asset statuses (#1524)
- feat(api): the AI assistant reads, configures and sets custom asset statuses (#1524)
- feat(shared): AI entity type and sentences for custom asset statuses (#1524)
- feat(api): keep the custom status invariant on every asset write path (#1524)
- feat(api): custom asset status module with kind guard and delete-with-reassign (#1524)
- feat(shared): custom asset status schemas and the status-or-label asset contract (#1524)
- feat(api): add the asset_status_labels table and Asset.statusLabelId (#1524)
- updt(web): trim the New purchase from a document comment (#1516)
- feat(web): cover the drop target and the landing card's steps (#1516)
- feat(web): sweep a scan line over the document while the AI reads it (#1516)
- feat(web): drop an invoice on the Purchases list to start a purchase (#1516)
- feat(web): drop an invoice on New purchase and watch it start, through the shared pipeline (#1516)
- feat(web): one pipeline to start a purchase from a document (#1516)
- updt(web): share the byte-size label from the format utils (#1516)
- updt(api): re-project a supplier's purchases only on a rename or a merge (#1499)
- updt(api): gate the purchase indexes inside SearchService.search too (#1499)
- feat(api): re-index suppliers and their purchases after a supplier merge commits (#1499)
- updt: pin the mergeable supplier fields to the schema and reuse them in the web supplier form (#1496)
- updt(api): build single and batch purchase events through one row builder (#1496)
- feat(web): purchases and suppliers groups in the global search palette (#1499)
- feat(api): re-index purchases and suppliers after their writes commit (#1499)
- feat(api): search purchases and suppliers only with purchaseOrder:read (#1499)
- feat(api): index purchases and suppliers in Meilisearch (#1499)
- feat(shared): add purchases and suppliers to the search contract (#1499)
- feat(web): merge a duplicate supplier from its page after a preview (#1496)
- feat(api): merge a duplicate supplier into the one that stays, with a preview (#1496)
- feat(shared): add the supplier merge contract and the SUPPLIER_MERGED purchase event (#1496)
- feat(web): add serial, manufacturer, purchase date, warranty end and cost to the assets column picker (#1511)
- feat(api): carry the purchase cost on asset list rows and sort by purchase date, warranty end and cost (#1511)
- feat(web): open the purchases list on every purchase, newest first (#1507)
- feat(api): purchase cards name the models, consumables, applications and locations they reference, labelled through the caller's own reads (#1478)
- updt(web): read AI_NEVER_AUTO_APPROVE_WARNINGS directly and name the fourth Approve-all exclusion in the pager's docblock (#1478)
- updt(web): read the Approve-all exclusion from the shared AI_NEVER_AUTO_APPROVE_WARNINGS, label notLinkable, cover a purchase from assets' derived lines (#1478)
- feat(web): Ask AI to fill on a purchase document opens the chat with the message ready to send (#1478)
- feat(web): show money with its currency label, purchase lines and linked assets readably on approval cards (#1478)
- feat(web): leave cards that create assets or change money out of Approve all, and say so on the card (#1478)
- feat(web): link purchases, suppliers and purchase documents from the chat, and send a purchase or supplier page as context (#1478)
- feat(web): localize the purchase tools in the chat — entities, warnings, option sources, tool and field labels, sentences (#1478)
- updt(api): request_input reads its paged option lists through one lookup table (#1478)
- feat(shared): export the never-auto-approve warnings so core and the web read one list (#1478)
- feat(api): purchases AI tools — reads, document extraction as untrusted data, and purchase changes as cards (#1478)
- feat(api): request_input offers suppliers and consumables as option lists (#1478)
- feat(api): a purchase document read marks the whole conversation untrusted (#1478)
- feat(api): never auto-approve a tool registered neverAutoApprove, nor a change that creates assets or changes money (#1478)
- feat(shared): purchases in the AI contract — purchase, supplier and document entity types, money and asset warnings, supplier and consumable option sources, purchase sentences (#1478)
- updt(web): follow the extraction contract's per-type size caps, the in-progress and rate refusals, and blank ambiguous dates (#1477)
- feat(web): read a purchase document into a reviewed draft — proposed changes beside the document, nothing saved until confirmed (#1477)
- feat(web): Create purchase from assets selected on the Assets list, linking only, with the assets left out (#1477)
- feat(web): LICENSE lines — the kind and its application, Apply license with the proposal, and Pending units acting per line kind (#1477)
- feat(web): the purchase activity log reads LICENSE_APPLIED, EXTRACTION_RUN and CREATED_FROM_ASSETS (#1477)
- feat(web): data access for document extraction, license lines and create-from-assets (#1477)
- updt(api): drop the unused file name from the extraction port, and say what a provider's own JSON tool is (#1477)
- feat(shared): per-provider extraction types and size caps, the in-progress and rate refusals, an 80-line ceiling (#1477)
- feat(web): the Document extraction switch in Settings → AI, off by default with its disclosure (#1477)
- feat(api): Phase 2 purchase routes, their permissions and AI tool decisions (#1477)
- feat(api): extract a draft from a purchase document — read by lazyit, never saved (#1477)
- feat(api): create a purchase from selected assets, linking them without changing their fields (#1477)
- feat(api): propose and apply a LICENSE line to its application through the applications write path (#1477)
- feat(api): LICENSE lines map to a live application and count applied seats as received (#1477)
- feat(api): a structured-extraction port that reads one file with no tools, over the provider layer (#1477)
- feat(api): read, save and audit the document extraction switch in the AI settings (#1477)
- feat(api): add the extraction switch and the LICENSE line columns, additive (#1477)
- feat(shared): the purchase document extraction draft, status and refusal codes (#1477)
- feat(shared): LICENSE purchase lines, the license proposal and apply, and create purchase from assets (#1477)
- feat(shared): the document extraction AI switch, its disclosure and the media types each provider reads (#1477)
- updt(web): reduce the purchase asset filter gate to the permission check (#1476)
- feat(web): scan serial numbers with the camera into the Receive stock dialog (#1476)
- feat(web): read stock receipts and document label changes in the purchase activity log (#1476)
- feat(web): linked assets per purchase line with unlink, and the not-linked filter in the link picker (#1476)
- feat(web): document type labels on upload and inline edit, on asset and purchase documents (#1476)
- feat(web): receive a consumable line into stock from the purchase and pending units (#1476)
- feat(web): consumable lines in the line editor and on the purchase page (#1476)
- updt(api): apply only authorized purchase filters in the asset list query, whoever calls it (#1476)
- updt(api): derive a line's received count in one function and one shared SQL fragment (#1476)
- updt(shared): let a blank document label clear it on edit, as on upload (#1476)
- feat(api): filter the asset list by purchase line, purchase and linked state under purchaseOrder:read (#1476)
- feat(api): return the purchase's createdAt on an asset's provenance (#1476)
- feat(shared): carry the purchase's createdAt on the asset provenance read (#1476)
- updt(api): answer a receipt whose line changed kind under the lock with a 409, and rewrap the removal note (#1476)
- feat(api): set, edit and suggest the document type label on asset and purchase documents (#1476)
- feat(api): receive consumable purchase lines into stock through the consumables ledger (#1476)
- feat(api): add the consumable line, movement purchase link and document label columns (#1476)
- feat(shared): add consumable purchase lines, the receive-stock contract and the document type label (#1476)
- feat(web): the purchase activity log reads units received, linked, moved and cancelled, and documents added or removed (#1475)
- feat(web): smart entry on the purchase reference, invoice numbers and line description (#1475)
- feat(web): the Pending units tab — open lines by purchase, oldest first, with receive, link and cancel remaining (#1475)
- feat(web): the purchase Documents panel on the asset documents UI, with the not-in-the-backup notice (#1475)
- feat(web): the asset Purchase panel — provenance, documents, differs-from-purchase, link and unlink — only with purchaseOrder:read (#1475)
- feat(web): link existing assets to a purchase line — from the line and in bulk from the Assets list, with the apply-values diff (#1475)
- feat(web): cancel the remaining units of a purchase line, with an optional reason (#1475)
- feat(web): receive units against a purchase line — the Receive stock dialog in purchase mode, From purchase on Receive stock and New asset (#1475)
- updt(api): read the linked purchase in the export only with purchaseOrder:read, require the permission resolver, simplify the line kind check (#1473)
- feat(web): add the purchases flows endpoints and hooks — receive, link, unlink, cancel remaining, pending units, provenance, documents (#1475)
- feat(web): label the purchase link and unlink events in the asset history and the activity reports (#1475)
- updt(api): keep the export select note apart from the list projection and clarify the pending query (#1473)
- feat(api): carry the cost currency in the asset AI tools and decide the new purchase handlers (#1473)
- feat(api): add receive-from-line, link, unlink, cancel remaining, pending units and asset provenance (#1473)
- feat(api): add purchase documents under the asset allowlist (#1473)
- feat(api): receive units against a purchase line and gate the CSV purchase columns (#1473)
- feat(api): append the purchase link history types and the purchase attachment parent (#1473)
- feat: suggest purchase references, invoice numbers and line descriptions (#1473)
- feat(shared): add cost, currency and gated purchase columns to the inventory CSV (#1473)
- feat(shared): add the purchases flows contract — receive, link, cancel, pending units, provenance (#1473)
- feat(web): relabel the application Vendor as Publisher / Fabricante and suggest publishers already in use (#1474)
- feat(web): add the asset currency label and read company and manufacturer suggestions from /suggestions (#1474)
- feat(web): add the Purchases area with list, detail, create and edit, suppliers and activity log, gated on purchaseOrder:read (#1474)
- feat(web): add the purchases, suppliers and suggestions data layer with the display and payload logic (#1474)
- feat(web): add the purchaseOrder permission, capability and domain labels in en and es (#1474)
- feat(api): add purchase order and supplier endpoints with derived receipt, totals and activity log (#1472)
- feat(api): add smart-entry suggestions authorized per source column (#1472)
- feat(api): accept and return the asset purchase currency label (#1472)
- feat(api): add the purchases tables and the asset currency and purchase-line columns (#1472)
- feat(shared): add the purchaseOrder permission domain, read denied to VIEWER by default (#1472)
- feat(shared): add the purchase, supplier and suggestion contracts and the asset currency label (#1472)
- feat(web): money field checks prefilled amounts, marks its Field invalid and echoes ambiguous readings (#1470)
- updt(api): cover the idempotent application restore and drop a vacuous AI tool assertion (#1469)
- feat(web): read money amounts in the viewer's locale and show them as entered (#1470)
- feat(web): suggest previously used companies and manufacturers while typing (#1470)
- feat(web): add the smart-entry ranking, normalization and keyboard model (#1470)
- updt(api): accept 64-bit money amounts in the AI asset and application tools (#1469)
- updt(api): widen the money columns to BigInt and convert them at the API boundary (#1469)
- updt(shared): add the money() primitive and move every money field to it (#1469)
Fixes
- fix(web): give the SMTP security select room for its labels (#1533)
- fix(web): keep the offboarding sheet's columns inside a phone-width sheet (#1532)
- fix(web): line the record pages' side column up with the open tab (#1531)
- fix(web): size the asset status menus to their labels (#1531)
- fix(api): the KB tool previews state the folder audience from the derived flag (#1299)
- fix(api): a reappearing re-enabled person sheds the leftover offboard stamp so a later absence offboards them (#1522)
- fix(api): the migration header names the inactive-to-active flip that sets the mark (#1522)
- fix(shared): trim the SEC-086 schema comments to one line (#1327)
- fix(api): a manual re-enable marks directoryReenabledAt and a manual deactivation clears it (#1522)
- fix(api): the directory sweep never offboards a person an admin re-enabled while they stay absent (#1522)
- fix(web): name the unsafe link type in the shortcuts editor and inline the render check (#1327)
- fix(api): add a nullable User.directoryReenabledAt to record a manual re-enable (#1522)
- fix(api): reactivate only a row that still carries the sync's offboard stamp (#1311)
- fix(api): offboard only a row still active and unstamped, so an admin edit mid-sweep wins (#1311)
- fix(api): drop a spec comment that restates its describe title (#1311)
- fix(api): match the KB folder tool specs to the selected folder writes (#1301)
- fix(web): render unsafe legacy shortcut URLs as plain text in the node modal (#1327)
- fix(shared): refuse executable schemes in infra shortcut URLs on write (#1327)
- fix(api): return the public folder shape from every KB folder write (#1301)
- fix(api): clear the directory offboard stamp on a manual deactivation (#1311)
- fix(api): never stamp a manually deactivated person as directory-offboarded (#1311)
- fix(shared): bound AssetModel.specs on write like Asset.specs (#1329)
- fix(web): drop two comments that restate the name (#1516)
- fix(web): announce every step from a live region mounted before the start (#1516)
- fix(web): portal the drop stage to the body so it covers the assistant panel (#1516)
- fix(web): of several dropped files, start from the first one that can be read (#1516)
- fix(web): the page drop target heals when an element vanishes mid-drag (#1516)
- fix(api): pin the searchable attributes of the purchases and suppliers indexes (#1499)
- fix(web): say it is the duplicate's purchases that move in the merge dialog (#1496)
- fix(api): pin the merge preview's live purchase count query (#1496)
- fix(api): end every asset list sort with the unique id and put empty purchase dates, warranty ends and costs last (#1511)
- fix(web): render the selected count in the Spanish bulk bar and keep the assets bar to one structured row (#1512)
- fix(web): keep a purchase save locked until the page changes after it succeeds (#1508)
- fix(web): take the focus-on-nothing save shortcut only after a click on the form's page, not in the assistant (#1508)
- fix(web): hide Open purchase in the result steps on the purchase's own page, test it through a mocked pathname (#1505)
- fix(web): keep the serial scanner tip live region rendered (#1506)
- fix(web): cap the QR scan box at 640 px to bound decode work on phones (#1506)
- fix(web): hold the asset lookup on its read until it opens, and keep the viewfinder frame steady (#1506)
- fix(web): save the purchase form on Ctrl/Cmd+Enter with focus outside any field (#1508)
- fix(web): show the camera scanner reading, a read taken, and a tip when nothing reads (#1506)
- fix(web): decode camera scans at HD with a per-mode setup, so a laptop webcam reads serials and QR labels (#1506)
- fix(web): close the receive and link dialogs on Back to purchase when already on that purchase (#1505)
- fix(api): name the purchase reference in a stock receipt's movement reason (#1494)
- fix(web): test entity refs from #1492 on purchase cards — by name, by id without a label, and an older card's raw id (#1478)
- fix(web): the Ask AI to fill message carries the document's id for purchase_document_read (#1478)
- fix(web): test that the chat's line kind and link state labels cover the shared enums (#1478)
- fix(web): /copy writes tables row by row with money formatted, a list of amounts is never dropped, and entity refs on purchase lines and linked assets render by name (#1478)
- fix(web): Ask AI to fill starts a new chat when the open one has messages, shows the chat, keeps the draft, drops the message on close or page change, and quotes a sanitized file name (#1478)
- fix(web): type-safe assertion that a folded id is not a column in the purchase card test (#1478)
- fix(api): purchases tools review — the from-assets card lists its lines and flags money, no archived delivery location, warnings before the draft, every warning branch pinned (#1478)
- fix(api): type the purchases tools spec's page fixture and principal read (#1478)
- fix(web): review round — a holder needs one document attached right after it, saved parts lock and the counts are what was written, ?read=1 reads once (#1477)
- fix(web): review round — consent copy for a new purchase from a document, the read action's disclosure, a separate rename error, and no 'nothing was created' after an inline supplier (#1477)
- fix(web): a PDF in the review is a card that opens in a new tab, never framed, so the CSP keeps frame-src 'none' (#1477)
- fix(web): the totals check names the incomplete lines when it cannot compare yet, with a render test of the review (#1477)
- fix(web): the review reads a document on arrival only once permissions and status are known, and leaves unchanged values out (#1477)
- fix(api): extraction review — ambiguous dates blank, trailing minus, per-provider caps, one in flight per person, runs recorded only when sent (#1477)
- fix(web): offer every open asset line under From purchase, past the first page and never for consumable lines (#1476)
- fix(web): keep the typed document type when every dropped file is refused (#1476)
- fix(web): move focus into the serial scanner and the label editor, and back when they close (#1476)
- fix(web): keep a serial held in front of the camera silent for as long as it stays in view (#1476)
- fix(web): stop the camera scanner without throwing when it never started (#1476)
- fix(web): title an asset's purchase by the purchase's recorded date, not the line's (#1476)
- fix(api): refuse an archived location or model when creating, receiving or moving an asset (#1476)
- fix(api): lock the purchase before the line in cancel remaining units, so it cannot deadlock with a line removal (#1476)
- fix(web): link dialog — render the partial-failure result from a snapshot, list every asset whose values differ from apply, re-check the comparison before a move, read the fresh line (#1475)
- fix(web): leave the purchase's delivery location to the API when receiving unless the operator changed it, and show the model in the receive summary (#1475)
- fix(web): read the logged moved assets as a list in the purchase activity (#1475)
- fix(web): move the suggestion query keys to the hook-free query-keys module so server components importing asset hooks build (#1475)
- fix(web): show the model chip of the link picker while the model names load (#1475)
- fix(web): write the new Spanish purchases strings in the catalogs' tú register (#1475)
- fix(api): lock the purchase before linking and on a kind change, lock assets in id order, and call the event writer directly (#1473)
- fix(web): Spanish gender agreement in the batch none-succeeded message (#1474)
- fix(web): refresh smart-entry suggestions after asset, model and application writes (#1474)
- fix(web): print logged amounts with the event's own currency label, wrap notes in dl, link only safe supplier websites (#1474)
- fix(web): lift the pending-units filter in the archived view and for cancelled purchases (#1474)
- fix(web): keep unknown line kinds and stored brand and warranty when editing a line (#1474)
- fix(web): one purchase save at a time, header checked before an inline supplier, repeated-reference hint, labelled radio groups (#1474)
- fix(api): exclude lines of archived purchases from suggestions and cover the route authorization over HTTP (#1472)
- fix(api): lock the purchase row for the identifiability check and return the full removed line (#1472)
- fix(web): keep focus in the smart-entry input on any click inside its list (#1470)
- fix(infra): update.sh trusts release tags by origin/master ancestry, not a signature (#1458)
- fix(infra): cover DIRECTORY_SECRET_KEY in the start.sh tests (#1271)
- fix(infra): document DIRECTORY_SECRET_KEY in the prod env template (#1271)
- fix(infra): generate DIRECTORY_SECRET_KEY in start.sh and append it to an existing .env.prod (#1271)
Full changelog: v2.0.0...v2.1.0