feat: complete SHD MCP plugin workflows and widget

2026-08-24 17:25:38 +03:00
parent 39fb5c02b7
commit 08cf3672a4
86 changed files with 1707 additions and 5 deletions
@@ -0,0 +1,28 @@
+---
+name: shd-estimate-management
+description: Use when the user asks to inspect, compare, validate, create or update SHD estimates, proposals, terms or document contracts.
+---
+
+# SHD estimates and proposal documents
+
+## Read path
+
+1. Resolve the project, proposal, terms document or contract before acting.
+2. Use `shd_list_proposals` and `shd_get_proposal` for proposal registers and
+   details.
+3. Use `shd_list_terms_documents`, `shd_get_terms_document`,
+   `shd_get_terms_document_completeness` and `shd_validate_terms_document` for
+   terms and completeness checks.
+4. Inspect template capabilities before proposing a template-driven change.
+5. Report line items, versions, completeness, approvals and publication state
+   only when those fields are returned by the server.
+
+## Mutations
+
+- Creating, replacing items, requesting approval, publishing, restoring or
+  deleting a proposal/document requires an exact explicit request.
+- Read the latest version and use the tool's concurrency and idempotency fields
+  before a write.
+- Never publish or request approval as a side effect of an audit or comparison.
+
+See `references/estimate-safety.md` before a proposal or terms mutation.
@@ -0,0 +1,5 @@
+interface:
+  display_name: SHD estimates and proposals
+  short_description: Estimate and document workflows
+policy:
+  allow_implicit_invocation: false
@@ -0,0 +1,7 @@
+# Estimate and proposal safety
+
+- Draft, validated, approved and published are separate states.
+- A calculated total is not an approval and a generated PDF is not a
+  publication.
+- Compare revisions before restoring or replacing a document.
+- Keep the project, counterparty and version identifiers in the final report.