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,39 @@
+---
+name: shd-airbase-audit
+description: Use when the user asks to inspect AirBase tables, validate project data, find duplicate or broken links, or audit AirBase quality without changing records.
+---
+
+# AirBase audit
+
+See `references/audit-contract.md` for the bounded read and evidence format.
+
+## Workflow
+
+1. Resolve the canonical Base identity. A supplied `project_code` is accepted
+   as the legacy alias only when the server accepts it; prefer the returned
+   Base identity for subsequent calls.
+2. If no table is named, call `shd_airbase_tables` first and select only the
+   relevant tables. Do not load every table by default.
+3. Call `shd_airbase_schema` for each selected table before reading its
+   records. Pass the table explicitly when a single-table audit is requested.
+4. Call `shd_airbase_records` with bounded reads and the selected table.
+5. Compare records with the returned schema and report only evidence visible in
+   the response.
+
+## Findings
+
+Check for duplicate business numbers, missing required values, invalid select
+values, unresolved linked records, orphaned references, conflicting DALI or
+electrical identifiers, formula/derived-field risks and incomplete source data
+when the selected tables expose those fields.
+
+Report `table → record → field → observed value → reason → priority`. Distinguish
+confirmed defects from data that could not be checked because the schema or
+records were unavailable.
+
+## Safety
+
+This workflow is read-only. Do not call create, update, delete, import, bulk
+upsert or generic action tools while auditing. If the user asks to repair
+findings, first present the proposed records and then use the dedicated
+validation/dry-run contract before any explicit write.
@@ -0,0 +1,5 @@
+interface:
+  display_name: AirBase audit
+  short_description: Read-only schema and data audit
+policy:
+  allow_implicit_invocation: false
@@ -0,0 +1,20 @@
+# AirBase audit contract
+
+Use this contract for every read-only AirBase audit.
+
+1. Resolve the canonical Base identity before selecting tables. Treat a
+   user-provided project code as an alias until the server returns the
+   authoritative identity.
+2. Discover tables only when the request does not name them. Do not load every
+   table just to find a possible issue.
+3. Read the schema before records for every selected table. Keep the table
+   name explicit in each subsequent request.
+4. Bound record reads with the smallest useful limit and preserve the server's
+   pagination or truncation metadata.
+5. Report evidence as `table → record → field → observed value → reason →
+   priority`. Mark a finding as unverified when the schema or record needed to
+   prove it was unavailable.
+
+Never repair an audit finding inside the audit workflow. A repair requires a
+separate proposal, an explicit mutation request, the current schema and
+records, the server's validation/dry-run contract, and final readback.