chore: keep widget sources only

2026-09-17 23:29:09 +03:00
commit e0404617d2
125 changed files with 8935 additions and 0 deletions
@@ -0,0 +1,26 @@
+---
+name: shd-inventory
+description: Use when the user asks to inspect or change SHD inventory items, assets, stock, procurement, reservations, receipts or stocktakes.
+---
+
+# SHD inventory
+
+See `references/inventory-safety.md` before any stock, asset or procurement
+mutation.
+
+## Inspect
+
+- Resolve the project, location, item, asset or procurement identity from
+  server results.
+- Read current stock, lots, reservations, movements, receipts, maintenance,
+  assignments and audit data relevant to the question.
+- Keep available, reserved, received, written-off and counted quantities
+  distinct. Do not calculate an authoritative balance from partial pages.
+
+## Mutations
+
+Reserve, release, receive, write off or close a stocktake only on an explicit
+request. Creating/updating resources and generic inventory actions require the
+same read-before-write and conflict/idempotency handling. Report quantities,
+location, source document, server validation and readback; never silently
+repair a discrepancy by changing stock.
@@ -0,0 +1,5 @@
+interface:
+  display_name: "SHD inventory"
+  short_description: "Audit stock, assets and procurement"
+policy:
+  allow_implicit_invocation: false
@@ -0,0 +1,14 @@
+# Inventory safety contract
+
+Read tools cover items/assets, procurement, locations, movements, lots,
+reservations, receipts, stocktakes, labels, assignments, maintenance and the
+inventory audit log. Use the narrowest `shd_list_inventory_*` or
+`shd_get_inventory_*` tool and preserve pagination.
+
+Side-effecting operations include `shd_reserve_inventory_stock`,
+`shd_release_inventory_stock`, `shd_receive_inventory_stock`,
+`shd_write_off_inventory_stock`, `shd_close_inventory_stocktake`,
+`shd_create_inventory_resource`, `shd_update_inventory_resource` and
+`shd_inventory_action`. Resolve the exact target and latest quantity first;
+require explicit confirmation for irreversible or bulk operations and verify
+the resulting movement/audit record.