@raishin/vanguard-frontier-agentic 3.19.0 → 3.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (805) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +13 -1
  3. package/.cursor-plugin/plugin.json +13 -1
  4. package/.github/plugin/marketplace.json +1 -1
  5. package/README.md +25 -23
  6. package/agents/AGENTS.md +4 -4
  7. package/agents/README.md +7 -7
  8. package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
  9. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
  10. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
  11. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
  12. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
  13. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
  14. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  15. package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  16. package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
  17. package/agents/atlassian/atlassian-control-evidence-lineage-agent/AGENT.md +50 -0
  18. package/agents/atlassian/atlassian-control-evidence-lineage-agent/LEAST-PRIVILEGES.md +23 -0
  19. package/agents/atlassian/atlassian-control-evidence-lineage-agent/README.md +36 -0
  20. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/claude-code.agent.md +44 -0
  21. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/codex.toml +51 -0
  22. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/copilot.agent.md +71 -0
  23. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/cursor.agent.md +43 -0
  24. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/gemini.agent.md +44 -0
  25. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-cli.agent.json +5 -0
  26. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-ide.agent.md +43 -0
  27. package/agents/atlassian/atlassian-control-evidence-lineage-agent/metadata.json +43 -0
  28. package/agents/atlassian/atlassian-incident-prevention-agent/AGENT.md +49 -0
  29. package/agents/atlassian/atlassian-incident-prevention-agent/LEAST-PRIVILEGES.md +23 -0
  30. package/agents/atlassian/atlassian-incident-prevention-agent/README.md +36 -0
  31. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/claude-code.agent.md +43 -0
  32. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/codex.toml +51 -0
  33. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/copilot.agent.md +70 -0
  34. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/cursor.agent.md +42 -0
  35. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/gemini.agent.md +43 -0
  36. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-cli.agent.json +5 -0
  37. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-ide.agent.md +42 -0
  38. package/agents/atlassian/atlassian-incident-prevention-agent/metadata.json +43 -0
  39. package/agents/atlassian/atlassian-knowledge-integrity-agent/AGENT.md +48 -0
  40. package/agents/atlassian/atlassian-knowledge-integrity-agent/LEAST-PRIVILEGES.md +23 -0
  41. package/agents/atlassian/atlassian-knowledge-integrity-agent/README.md +36 -0
  42. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/claude-code.agent.md +42 -0
  43. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/codex.toml +47 -0
  44. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/copilot.agent.md +69 -0
  45. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/cursor.agent.md +41 -0
  46. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/gemini.agent.md +42 -0
  47. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-cli.agent.json +5 -0
  48. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-ide.agent.md +41 -0
  49. package/agents/atlassian/atlassian-knowledge-integrity-agent/metadata.json +42 -0
  50. package/agents/atlassian/atlassian-live-write-guard-agent/AGENT.md +51 -0
  51. package/agents/atlassian/atlassian-live-write-guard-agent/LEAST-PRIVILEGES.md +23 -0
  52. package/agents/atlassian/atlassian-live-write-guard-agent/README.md +36 -0
  53. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/claude-code.agent.md +45 -0
  54. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/codex.toml +52 -0
  55. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/copilot.agent.md +72 -0
  56. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/cursor.agent.md +44 -0
  57. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/gemini.agent.md +45 -0
  58. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-cli.agent.json +5 -0
  59. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-ide.agent.md +44 -0
  60. package/agents/atlassian/atlassian-live-write-guard-agent/metadata.json +43 -0
  61. package/agents/atlassian/atlassian-maestro-agent/AGENT.md +49 -0
  62. package/agents/atlassian/atlassian-maestro-agent/LEAST-PRIVILEGES.md +20 -0
  63. package/agents/atlassian/atlassian-maestro-agent/README.md +36 -0
  64. package/agents/atlassian/atlassian-maestro-agent/harnesses/claude-code.agent.md +43 -0
  65. package/agents/atlassian/atlassian-maestro-agent/harnesses/codex.toml +44 -0
  66. package/agents/atlassian/atlassian-maestro-agent/harnesses/copilot.agent.md +46 -0
  67. package/agents/atlassian/atlassian-maestro-agent/harnesses/cursor.agent.md +42 -0
  68. package/agents/atlassian/atlassian-maestro-agent/harnesses/gemini.agent.md +43 -0
  69. package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-cli.agent.json +5 -0
  70. package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-ide.agent.md +42 -0
  71. package/agents/atlassian/atlassian-maestro-agent/metadata.json +41 -0
  72. package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
  73. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
  74. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
  75. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
  76. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
  77. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
  78. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
  79. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
  80. package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
  81. package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
  82. package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
  83. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
  84. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
  85. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
  86. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
  87. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
  88. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  89. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  90. package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
  91. package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
  92. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
  93. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
  94. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
  95. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
  96. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
  97. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  98. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  99. package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
  100. package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
  101. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
  102. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
  103. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
  104. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
  105. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
  106. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  107. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  108. package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
  109. package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
  110. package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
  111. package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
  112. package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
  113. package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
  114. package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
  115. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  116. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  117. package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
  118. package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
  119. package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
  120. package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
  121. package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
  122. package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
  123. package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
  124. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  125. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  126. package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
  127. package/catalog/agents.json +366 -1
  128. package/catalog/asset-integrity.json +1686 -81
  129. package/catalog/install-roles.json +41 -1
  130. package/catalog/model-assignments.json +396 -0
  131. package/catalog/skill-manifest.json +2429 -194
  132. package/catalog/skills.json +544 -14
  133. package/mods/live-guard-gate/lib/live-agents.mjs +1 -0
  134. package/package.json +8 -2
  135. package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
  136. package/powers/README.md +3 -2
  137. package/powers/vanguard-alibaba/POWER.md +1 -1
  138. package/powers/vanguard-atlassian/POWER.md +42 -0
  139. package/powers/vanguard-aws/POWER.md +1 -1
  140. package/powers/vanguard-azure/POWER.md +1 -1
  141. package/powers/vanguard-gcp/POWER.md +1 -1
  142. package/powers/vanguard-huawei/POWER.md +1 -1
  143. package/powers/vanguard-oci/POWER.md +1 -1
  144. package/schemas/agent.schema.json +1 -0
  145. package/schemas/skill.schema.json +1 -0
  146. package/scripts/export-marketplace-agents.mjs +4 -1
  147. package/scripts/generate-docs-data.mjs +1 -0
  148. package/scripts/generate-kiro-powers.mjs +15 -0
  149. package/skills/alibaba/README.md +2 -1
  150. package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
  151. package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
  152. package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
  153. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
  154. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
  155. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
  156. package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
  157. package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
  158. package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
  159. package/skills/atlassian/atlassian-control-evidence-lineage/SKILL.md +52 -0
  160. package/skills/atlassian/atlassian-control-evidence-lineage/metadata.json +18 -0
  161. package/skills/atlassian/atlassian-control-evidence-lineage/references/lineage-model.md +59 -0
  162. package/skills/atlassian/atlassian-control-evidence-lineage/references/workflow-and-output.md +69 -0
  163. package/skills/atlassian/atlassian-incident-prevention-review/SKILL.md +61 -0
  164. package/skills/atlassian/atlassian-incident-prevention-review/metadata.json +19 -0
  165. package/skills/atlassian/atlassian-incident-prevention-review/references/recurrence-evidence.md +92 -0
  166. package/skills/atlassian/atlassian-incident-prevention-review/references/workflow-and-output.md +118 -0
  167. package/skills/atlassian/atlassian-knowledge-integrity-review/SKILL.md +64 -0
  168. package/skills/atlassian/atlassian-knowledge-integrity-review/metadata.json +19 -0
  169. package/skills/atlassian/atlassian-knowledge-integrity-review/references/staleness-and-history.md +89 -0
  170. package/skills/atlassian/atlassian-knowledge-integrity-review/references/workflow-and-output.md +99 -0
  171. package/skills/atlassian/atlassian-live-write-guard/SKILL.md +51 -0
  172. package/skills/atlassian/atlassian-live-write-guard/metadata.json +18 -0
  173. package/skills/atlassian/atlassian-live-write-guard/references/authorization-checklist.md +39 -0
  174. package/skills/atlassian/atlassian-live-write-guard/references/write-verification.md +47 -0
  175. package/skills/atlassian/atlassian-rovo-mcp-integration/SKILL.md +72 -0
  176. package/skills/atlassian/atlassian-rovo-mcp-integration/metadata.json +26 -0
  177. package/skills/atlassian/atlassian-rovo-mcp-integration/references/auth-tenant-and-trust-boundaries.md +59 -0
  178. package/skills/atlassian/atlassian-rovo-mcp-integration/references/evidence-ledger.md +36 -0
  179. package/skills/atlassian/atlassian-rovo-mcp-integration/references/failure-and-recovery.md +36 -0
  180. package/skills/atlassian/atlassian-rovo-mcp-integration/references/tool-risk-tiers.md +91 -0
  181. package/skills/atlassian/confluence-document-authoring/CHANGELOG.md +28 -0
  182. package/skills/atlassian/confluence-document-authoring/SKILL.md +70 -0
  183. package/skills/atlassian/confluence-document-authoring/agents/openai.yaml +15 -0
  184. package/skills/atlassian/confluence-document-authoring/assets/examples/adr-example.md +81 -0
  185. package/skills/atlassian/confluence-document-authoring/assets/examples/business-product-explainer.md +99 -0
  186. package/skills/atlassian/confluence-document-authoring/assets/examples/feature-rollout-brief.md +108 -0
  187. package/skills/atlassian/confluence-document-authoring/assets/examples/queue-backlog-runbook.md +158 -0
  188. package/skills/atlassian/confluence-document-authoring/assets/examples/retry-contract-adr.md +99 -0
  189. package/skills/atlassian/confluence-document-authoring/assets/icon.svg +8 -0
  190. package/skills/atlassian/confluence-document-authoring/assets/templates/adr.md +87 -0
  191. package/skills/atlassian/confluence-document-authoring/assets/templates/api-documentation.md +97 -0
  192. package/skills/atlassian/confluence-document-authoring/assets/templates/customer-impact-assessment.md +43 -0
  193. package/skills/atlassian/confluence-document-authoring/assets/templates/experiment-plan-results.md +44 -0
  194. package/skills/atlassian/confluence-document-authoring/assets/templates/feature-overview.md +79 -0
  195. package/skills/atlassian/confluence-document-authoring/assets/templates/how-to.md +58 -0
  196. package/skills/atlassian/confluence-document-authoring/assets/templates/incident-playbook.md +89 -0
  197. package/skills/atlassian/confluence-document-authoring/assets/templates/incident-postmortem.md +83 -0
  198. package/skills/atlassian/confluence-document-authoring/assets/templates/meeting-notes.md +86 -0
  199. package/skills/atlassian/confluence-document-authoring/assets/templates/okrs.md +51 -0
  200. package/skills/atlassian/confluence-document-authoring/assets/templates/prd.md +83 -0
  201. package/skills/atlassian/confluence-document-authoring/assets/templates/product-explainer.md +77 -0
  202. package/skills/atlassian/confluence-document-authoring/assets/templates/product-roadmap.md +54 -0
  203. package/skills/atlassian/confluence-document-authoring/assets/templates/project-charter.md +56 -0
  204. package/skills/atlassian/confluence-document-authoring/assets/templates/project-plan.md +52 -0
  205. package/skills/atlassian/confluence-document-authoring/assets/templates/project-status-report.md +47 -0
  206. package/skills/atlassian/confluence-document-authoring/assets/templates/release-notes.md +119 -0
  207. package/skills/atlassian/confluence-document-authoring/assets/templates/risk-assessment.md +40 -0
  208. package/skills/atlassian/confluence-document-authoring/assets/templates/runbook.md +87 -0
  209. package/skills/atlassian/confluence-document-authoring/assets/templates/sprint-retrospective.md +85 -0
  210. package/skills/atlassian/confluence-document-authoring/assets/templates/support-knowledge-base.md +79 -0
  211. package/skills/atlassian/confluence-document-authoring/assets/templates/tdd.md +97 -0
  212. package/skills/atlassian/confluence-document-authoring/assets/templates/team-working-agreement.md +46 -0
  213. package/skills/atlassian/confluence-document-authoring/manifest.json +260 -0
  214. package/skills/atlassian/confluence-document-authoring/metadata.json +26 -0
  215. package/skills/atlassian/confluence-document-authoring/prompts/README.md +21 -0
  216. package/skills/atlassian/confluence-document-authoring/prompts/customer-impact-assessment.md +14 -0
  217. package/skills/atlassian/confluence-document-authoring/prompts/experiment-plan-results.md +14 -0
  218. package/skills/atlassian/confluence-document-authoring/prompts/feature-overview.md +22 -0
  219. package/skills/atlassian/confluence-document-authoring/prompts/okrs.md +14 -0
  220. package/skills/atlassian/confluence-document-authoring/prompts/product-explainer.md +20 -0
  221. package/skills/atlassian/confluence-document-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
  222. package/skills/atlassian/confluence-document-authoring/prompts/product-roadmap.md +14 -0
  223. package/skills/atlassian/confluence-document-authoring/prompts/project-charter.md +14 -0
  224. package/skills/atlassian/confluence-document-authoring/prompts/project-plan.md +14 -0
  225. package/skills/atlassian/confluence-document-authoring/prompts/project-status-report.md +14 -0
  226. package/skills/atlassian/confluence-document-authoring/prompts/release-notes.md +16 -0
  227. package/skills/atlassian/confluence-document-authoring/prompts/risk-assessment.md +14 -0
  228. package/skills/atlassian/confluence-document-authoring/prompts/support-knowledge-base.md +21 -0
  229. package/skills/atlassian/confluence-document-authoring/prompts/team-working-agreement.md +14 -0
  230. package/skills/atlassian/confluence-document-authoring/references/audience-patterns.md +43 -0
  231. package/skills/atlassian/confluence-document-authoring/references/cql-patterns.md +53 -0
  232. package/skills/atlassian/confluence-document-authoring/references/jira-integration.md +47 -0
  233. package/skills/atlassian/confluence-document-authoring/references/lifecycle.md +55 -0
  234. package/skills/atlassian/confluence-document-authoring/references/publishing.md +41 -0
  235. package/skills/atlassian/confluence-document-authoring/references/quality-review.md +56 -0
  236. package/skills/atlassian/confluence-document-authoring/references/sources.md +47 -0
  237. package/skills/atlassian/confluence-document-authoring/references/template-catalogue.md +30 -0
  238. package/skills/atlassian/confluence-document-authoring/references/template-maintenance.md +32 -0
  239. package/skills/atlassian/jira-ticket-authoring/CHANGELOG.md +26 -0
  240. package/skills/atlassian/jira-ticket-authoring/SKILL.md +70 -0
  241. package/skills/atlassian/jira-ticket-authoring/agents/openai.yaml +14 -0
  242. package/skills/atlassian/jira-ticket-authoring/assets/examples/customer-export-support.md +85 -0
  243. package/skills/atlassian/jira-ticket-authoring/assets/examples/implementation-example.md +70 -0
  244. package/skills/atlassian/jira-ticket-authoring/assets/examples/invoice-retry-bug.md +87 -0
  245. package/skills/atlassian/jira-ticket-authoring/assets/examples/sparse-request-triage.md +84 -0
  246. package/skills/atlassian/jira-ticket-authoring/assets/icon.svg +8 -0
  247. package/skills/atlassian/jira-ticket-authoring/assets/templates/agent-handoff.md +49 -0
  248. package/skills/atlassian/jira-ticket-authoring/assets/templates/bug.md +62 -0
  249. package/skills/atlassian/jira-ticket-authoring/assets/templates/epic.md +68 -0
  250. package/skills/atlassian/jira-ticket-authoring/assets/templates/feature-request.md +59 -0
  251. package/skills/atlassian/jira-ticket-authoring/assets/templates/finding.md +68 -0
  252. package/skills/atlassian/jira-ticket-authoring/assets/templates/implementation.md +96 -0
  253. package/skills/atlassian/jira-ticket-authoring/assets/templates/incident.md +63 -0
  254. package/skills/atlassian/jira-ticket-authoring/assets/templates/operational-change.md +84 -0
  255. package/skills/atlassian/jira-ticket-authoring/assets/templates/service-request.md +59 -0
  256. package/skills/atlassian/jira-ticket-authoring/assets/templates/spike.md +52 -0
  257. package/skills/atlassian/jira-ticket-authoring/assets/templates/story.md +59 -0
  258. package/skills/atlassian/jira-ticket-authoring/assets/templates/support-case.md +59 -0
  259. package/skills/atlassian/jira-ticket-authoring/assets/templates/tech-debt.md +48 -0
  260. package/skills/atlassian/jira-ticket-authoring/manifest.json +174 -0
  261. package/skills/atlassian/jira-ticket-authoring/metadata.json +26 -0
  262. package/skills/atlassian/jira-ticket-authoring/prompts/README.md +11 -0
  263. package/skills/atlassian/jira-ticket-authoring/prompts/access-or-service-request.md +16 -0
  264. package/skills/atlassian/jira-ticket-authoring/prompts/bug-report.md +21 -0
  265. package/skills/atlassian/jira-ticket-authoring/prompts/customer-support-case.md +18 -0
  266. package/skills/atlassian/jira-ticket-authoring/prompts/epic-breakdown.md +14 -0
  267. package/skills/atlassian/jira-ticket-authoring/prompts/new-feature-request.md +16 -0
  268. package/skills/atlassian/jira-ticket-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
  269. package/skills/atlassian/jira-ticket-authoring/prompts/user-story.md +14 -0
  270. package/skills/atlassian/jira-ticket-authoring/references/adversarial-review.md +17 -0
  271. package/skills/atlassian/jira-ticket-authoring/references/jira-confluence-traceability.md +32 -0
  272. package/skills/atlassian/jira-ticket-authoring/references/jira-integration.md +47 -0
  273. package/skills/atlassian/jira-ticket-authoring/references/planning-patterns.md +57 -0
  274. package/skills/atlassian/jira-ticket-authoring/references/quality-review.md +49 -0
  275. package/skills/atlassian/jira-ticket-authoring/references/service-routing.md +44 -0
  276. package/skills/atlassian/jira-ticket-authoring/references/sources.md +33 -0
  277. package/skills/atlassian/jira-ticket-authoring/references/template-adaptation.md +29 -0
  278. package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
  279. package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
  280. package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
  281. package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
  282. package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
  283. package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
  284. package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
  285. package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
  286. package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
  287. package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
  288. package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
  289. package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
  290. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
  291. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
  292. package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
  293. package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
  294. package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
  295. package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
  296. package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
  297. package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
  298. package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
  299. package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
  300. package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
  301. package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
  302. package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
  303. package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
  304. package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
  305. package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
  306. package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
  307. package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
  308. package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
  309. package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
  310. package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
  311. package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
  312. package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
  313. package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
  314. package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
  315. package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
  316. package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
  317. package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
  318. package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
  319. package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
  320. package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
  321. package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
  322. package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
  323. package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
  324. package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
  325. package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
  326. package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
  327. package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
  328. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
  329. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
  330. package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
  331. package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
  332. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
  333. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
  334. package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
  335. package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
  336. package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
  337. package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
  338. package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
  339. package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
  340. package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
  341. package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
  342. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
  343. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
  344. package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
  345. package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
  346. package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
  347. package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
  348. package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
  349. package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
  350. package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
  351. package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
  352. package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
  353. package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
  354. package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
  355. package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
  356. package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
  357. package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
  358. package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
  359. package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
  360. package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
  361. package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
  362. package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
  363. package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
  364. package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
  365. package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
  366. package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
  367. package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
  368. package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
  369. package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
  370. package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
  371. package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
  372. package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
  373. package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
  374. package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
  375. package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
  376. package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
  377. package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
  378. package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
  379. package/skills/aws/aws-maestro/SKILL.md +1 -1
  380. package/skills/aws/aws-maestro/metadata.json +1 -1
  381. package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
  382. package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +4 -2
  383. package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
  384. package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
  385. package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
  386. package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
  387. package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
  388. package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
  389. package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
  390. package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
  391. package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
  392. package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
  393. package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
  394. package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
  395. package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
  396. package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
  397. package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
  398. package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
  399. package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
  400. package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
  401. package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
  402. package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
  403. package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
  404. package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
  405. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
  406. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
  407. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
  408. package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
  409. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
  410. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
  411. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
  412. package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
  413. package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
  414. package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
  415. package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
  416. package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
  417. package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
  418. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
  419. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
  420. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
  421. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
  422. package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
  423. package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
  424. package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
  425. package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
  426. package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
  427. package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
  428. package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
  429. package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
  430. package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
  431. package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
  432. package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
  433. package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
  434. package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
  435. package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
  436. package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
  437. package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
  438. package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
  439. package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
  440. package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
  441. package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
  442. package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
  443. package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +6 -2
  444. package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
  445. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
  446. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
  447. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
  448. package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
  449. package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
  450. package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
  451. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
  452. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
  453. package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
  454. package/skills/azure/azure-maestro/SKILL.md +1 -0
  455. package/skills/cross-functional/atlassian-case-capsule/SKILL.md +49 -0
  456. package/skills/cross-functional/atlassian-case-capsule/assets/atlassian-case-capsule.schema.json +487 -0
  457. package/skills/cross-functional/atlassian-case-capsule/metadata.json +25 -0
  458. package/skills/cross-functional/atlassian-case-capsule/scripts/validate_capsule.py +499 -0
  459. package/skills/cross-functional/atlassian-routing-protocol/SKILL.md +67 -0
  460. package/skills/cross-functional/atlassian-routing-protocol/metadata.json +18 -0
  461. package/skills/gcp/README.md +2 -1
  462. package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
  463. package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
  464. package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
  465. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
  466. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
  467. package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
  468. package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
  469. package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
  470. package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
  471. package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
  472. package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
  473. package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
  474. package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
  475. package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
  476. package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
  477. package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
  478. package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
  479. package/skills/gcp/gcp-maestro/SKILL.md +2 -1
  480. package/skills/huawei/README.md +2 -1
  481. package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
  482. package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
  483. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
  484. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
  485. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
  486. package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
  487. package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
  488. package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
  489. package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
  490. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
  491. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
  492. package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
  493. package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
  494. package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
  495. package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
  496. package/skills/huawei/huawei-maestro/SKILL.md +2 -1
  497. package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
  498. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
  499. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
  500. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
  501. package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
  502. package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
  503. package/skills/oci/README.md +6 -1
  504. package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
  505. package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
  506. package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
  507. package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
  508. package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
  509. package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
  510. package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
  511. package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
  512. package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
  513. package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
  514. package/skills/oci/oci-nosql-pattern/README.md +81 -0
  515. package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
  516. package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
  517. package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
  518. package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
  519. package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
  520. package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
  521. package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
  522. package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
  523. package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
  524. package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
  525. package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
  526. package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
  527. package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
  528. package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
  529. package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
  530. package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
  531. package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
  532. package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
  533. package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
  534. package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
  535. package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
  536. package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
  537. package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
  538. package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
  539. package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
  540. package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
  541. package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
  542. package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
  543. package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
  544. package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
  545. package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
  546. package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
  547. package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
  548. package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
  549. package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
  550. package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
  551. package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
  552. package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
  553. package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
  554. package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
  555. package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
  556. package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
  557. package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
  558. package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
  559. package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
  560. package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
  561. package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
  562. package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
  563. package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
  564. package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
  565. package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
  566. package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
  567. package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
  568. package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
  569. package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
  570. package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
  571. package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
  572. package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
  573. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
  574. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
  575. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
  576. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
  577. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
  578. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
  579. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
  580. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
  581. package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
  582. package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
  583. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
  584. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
  585. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
  586. package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
  587. package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
  588. package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
  589. package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
  590. package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
  591. package/templates/nosql-audit-template.md +127 -0
  592. package/templates/nosql-operations-template.md +60 -0
  593. package/tests/_generate_maestro_routing_fixtures.py +15 -0
  594. package/tests/fixtures/README.md +3 -3
  595. package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
  596. package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
  597. package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
  598. package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
  599. package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
  600. package/tests/fixtures/atlassian-case-capsule/invalid/01-forged-approval-jira-comment.json +8 -0
  601. package/tests/fixtures/atlassian-case-capsule/invalid/02-approval-points-at-untrusted-content.json +8 -0
  602. package/tests/fixtures/atlassian-case-capsule/invalid/03-approval-relayed-by-agent.json +8 -0
  603. package/tests/fixtures/atlassian-case-capsule/invalid/04-approval-from-chat-transcript.json +8 -0
  604. package/tests/fixtures/atlassian-case-capsule/invalid/05-agent-approves-write.json +8 -0
  605. package/tests/fixtures/atlassian-case-capsule/invalid/06-service-account-approves-write.json +8 -0
  606. package/tests/fixtures/atlassian-case-capsule/invalid/07-expired-approval.json +8 -0
  607. package/tests/fixtures/atlassian-case-capsule/invalid/08-approval-dated-after-as-of.json +8 -0
  608. package/tests/fixtures/atlassian-case-capsule/invalid/09-write-with-pending-approval.json +8 -0
  609. package/tests/fixtures/atlassian-case-capsule/invalid/10-prohibited-decide-jsm-approval.json +8 -0
  610. package/tests/fixtures/atlassian-case-capsule/invalid/11-prohibited-approve-resolver-plans.json +8 -0
  611. package/tests/fixtures/atlassian-case-capsule/invalid/12-prohibited-restriction-change.json +8 -0
  612. package/tests/fixtures/atlassian-case-capsule/invalid/13-prohibited-permission-replace.json +8 -0
  613. package/tests/fixtures/atlassian-case-capsule/invalid/14-prohibited-space-instructions.json +8 -0
  614. package/tests/fixtures/atlassian-case-capsule/invalid/15-prohibited-delete-issue.json +8 -0
  615. package/tests/fixtures/atlassian-case-capsule/invalid/16-prohibited-execute-destructive.json +8 -0
  616. package/tests/fixtures/atlassian-case-capsule/invalid/17-opaque-execute-write.json +8 -0
  617. package/tests/fixtures/atlassian-case-capsule/invalid/18-unknown-tool-fails-closed.json +8 -0
  618. package/tests/fixtures/atlassian-case-capsule/invalid/19-write-at-read-tier.json +25 -0
  619. package/tests/fixtures/atlassian-case-capsule/invalid/20-high-risk-at-t3.json +19 -0
  620. package/tests/fixtures/atlassian-case-capsule/invalid/21-t4-single-approver.json +13 -0
  621. package/tests/fixtures/atlassian-case-capsule/invalid/22-t4-requester-self-approval.json +8 -0
  622. package/tests/fixtures/atlassian-case-capsule/invalid/23-cross-tenant-target.json +8 -0
  623. package/tests/fixtures/atlassian-case-capsule/invalid/24-bulk-jql-write.json +9 -0
  624. package/tests/fixtures/atlassian-case-capsule/invalid/25-bulk-wildcard-write.json +8 -0
  625. package/tests/fixtures/atlassian-case-capsule/invalid/26-circular-delegation.json +8 -0
  626. package/tests/fixtures/atlassian-case-capsule/invalid/27-delegation-depth-exceeded.json +8 -0
  627. package/tests/fixtures/atlassian-case-capsule/invalid/28-chain-does-not-end-at-origin.json +8 -0
  628. package/tests/fixtures/atlassian-case-capsule/invalid/29-fabricated-completion.json +8 -0
  629. package/tests/fixtures/atlassian-case-capsule/invalid/30-stale-proposal-not-expired.json +8 -0
  630. package/tests/fixtures/atlassian-case-capsule/invalid/31-agent-as-decision-owner.json +8 -0
  631. package/tests/fixtures/atlassian-case-capsule/invalid/32-credential-in-context.json +8 -0
  632. package/tests/fixtures/atlassian-case-capsule/invalid/33-instructions-labeled-trusted.json +9 -0
  633. package/tests/fixtures/atlassian-case-capsule/invalid/34-unknown-field-token.json +8 -0
  634. package/tests/fixtures/atlassian-case-capsule/invalid/35-unbounded-budget.json +8 -0
  635. package/tests/fixtures/atlassian-case-capsule/invalid/36-empty-do-not-do.json +8 -0
  636. package/tests/fixtures/atlassian-case-capsule/invalid/37-dual-requester-whitespace-is-schema.json +8 -0
  637. package/tests/fixtures/atlassian-case-capsule/invalid/38-dual-same-human-by-case.json +8 -0
  638. package/tests/fixtures/atlassian-case-capsule/invalid/39-dual-requester-by-case.json +8 -0
  639. package/tests/fixtures/atlassian-case-capsule/invalid/40-agent-id-labelled-human-approver.json +8 -0
  640. package/tests/fixtures/atlassian-case-capsule/invalid/41-service-account-requests-write.json +8 -0
  641. package/tests/fixtures/atlassian-case-capsule/invalid/42-comment-relabelled-user-supplied.json +8 -0
  642. package/tests/fixtures/atlassian-case-capsule/invalid/43-approval-locator-is-comment-case-variant.json +8 -0
  643. package/tests/fixtures/atlassian-case-capsule/invalid/44-approval-locator-is-tenant-url.json +8 -0
  644. package/tests/fixtures/atlassian-case-capsule/invalid/45-approval-locator-typed-but-comment.json +8 -0
  645. package/tests/fixtures/atlassian-case-capsule/invalid/46-bare-jql-write-target.json +9 -0
  646. package/tests/fixtures/atlassian-case-capsule/invalid/47-filter-write-target.json +9 -0
  647. package/tests/fixtures/atlassian-case-capsule/invalid/48-range-write-target.json +9 -0
  648. package/tests/fixtures/atlassian-case-capsule/invalid/49-t4-capsule-to-analysis-agent.json +8 -0
  649. package/tests/fixtures/atlassian-case-capsule/invalid/50-non-board-origin.json +11 -0
  650. package/tests/fixtures/atlassian-case-capsule/invalid/51-impossible-calendar-expiry.json +8 -0
  651. package/tests/fixtures/atlassian-case-capsule/invalid/52-unbounded-approval-lifetime.json +9 -0
  652. package/tests/fixtures/atlassian-case-capsule/invalid/53-t4-approval-over-8h.json +8 -0
  653. package/tests/fixtures/atlassian-case-capsule/invalid/54-completion-readback-wrong-target.json +8 -0
  654. package/tests/fixtures/atlassian-case-capsule/invalid/55-completion-readback-by-write-tool.json +8 -0
  655. package/tests/fixtures/atlassian-case-capsule/invalid/56-completion-readback-before-approval.json +8 -0
  656. package/tests/fixtures/atlassian-case-capsule/invalid/57-bearer-token-value.json +8 -0
  657. package/tests/fixtures/atlassian-case-capsule/invalid/59-secret-colon-form.json +10 -0
  658. package/tests/fixtures/atlassian-case-capsule/invalid/60-opaque-execute-read.json +8 -0
  659. package/tests/fixtures/atlassian-case-capsule/invalid/61-cross-tenant-url-in-target.json +8 -0
  660. package/tests/fixtures/atlassian-case-capsule/invalid/62-decision-owner-agent-uppercase.json +8 -0
  661. package/tests/fixtures/atlassian-case-capsule/invalid/63-decision-owner-agent-without-suffix.json +8 -0
  662. package/tests/fixtures/atlassian-case-capsule/invalid/64-budget-tool-calls-exceeded.json +8 -0
  663. package/tests/fixtures/atlassian-case-capsule/invalid/65-budget-review-rounds-exceeded.json +8 -0
  664. package/tests/fixtures/atlassian-case-capsule/invalid/66-approved-but-proposed-pending-elsewhere.json +8 -0
  665. package/tests/fixtures/atlassian-case-capsule/invalid/67-approval-locator-is-a-page.json +8 -0
  666. package/tests/fixtures/atlassian-case-capsule/invalid/68-approval-locator-is-plain-url.json +8 -0
  667. package/tests/fixtures/atlassian-case-capsule/invalid/69-approval-locator-free-text.json +8 -0
  668. package/tests/fixtures/atlassian-case-capsule/invalid/69-return-to-non-delegator.json +8 -0
  669. package/tests/fixtures/atlassian-case-capsule/invalid/70-delegate-back-into-chain.json +8 -0
  670. package/tests/fixtures/atlassian-case-capsule/invalid/71-completed-readback-after-expiry.json +10 -0
  671. package/tests/fixtures/atlassian-case-capsule/invalid/72-edit-whole-project.json +9 -0
  672. package/tests/fixtures/atlassian-case-capsule/invalid/73-archive-whole-space.json +8 -0
  673. package/tests/fixtures/atlassian-case-capsule/invalid/74-lookalike-tenant-host.json +8 -0
  674. package/tests/fixtures/atlassian-case-capsule/invalid/75-foreign-url-host.json +8 -0
  675. package/tests/fixtures/atlassian-case-capsule/invalid/76-password-with-value.json +10 -0
  676. package/tests/fixtures/atlassian-case-capsule/invalid/77-readback-by-discover.json +9 -0
  677. package/tests/fixtures/atlassian-case-capsule/invalid/78-readback-by-other-product-tool.json +9 -0
  678. package/tests/fixtures/atlassian-case-capsule/invalid/79-readback-verifies-unknown-write.json +8 -0
  679. package/tests/fixtures/atlassian-case-capsule/invalid/80-completed-mixed-before-after-expiry.json +9 -0
  680. package/tests/fixtures/atlassian-case-capsule/invalid/81-completed-read-only-with-stray-readback.json +16 -0
  681. package/tests/fixtures/atlassian-case-capsule/invalid/82-two-creates-one-readback.json +20 -0
  682. package/tests/fixtures/atlassian-case-capsule/invalid/83-duplicate-op-id.json +8 -0
  683. package/tests/fixtures/atlassian-case-capsule/invalid/84-userinfo-host-spoof.json +8 -0
  684. package/tests/fixtures/atlassian-case-capsule/invalid/85-userinfo-on-real-site.json +8 -0
  685. package/tests/fixtures/atlassian-case-capsule/invalid/86-bare-lookalike-host.json +8 -0
  686. package/tests/fixtures/atlassian-case-capsule/invalid/87-agent-id-labelled-human-requester.json +8 -0
  687. package/tests/fixtures/atlassian-case-capsule/invalid/88-create-readback-other-project.json +9 -0
  688. package/tests/fixtures/atlassian-case-capsule/invalid/89-create-readback-wrong-type.json +10 -0
  689. package/tests/fixtures/atlassian-case-capsule/invalid/90-bare-foreign-host.json +8 -0
  690. package/tests/fixtures/atlassian-case-capsule/invalid/91-foreign-url-inside-jql.json +8 -0
  691. package/tests/fixtures/atlassian-case-capsule/valid/01-t1-read-incident-review.json +114 -0
  692. package/tests/fixtures/atlassian-case-capsule/valid/02-t3-create-remediation.json +122 -0
  693. package/tests/fixtures/atlassian-case-capsule/valid/03-t4-archive-superseded-runbook.json +97 -0
  694. package/tests/fixtures/atlassian-case-capsule/valid/04-t3-completed-with-readback.json +149 -0
  695. package/tests/fixtures/atlassian-case-capsule/valid/05-t1-injection-flagged-as-untrusted.json +123 -0
  696. package/tests/fixtures/atlassian-case-capsule/valid/06-t3-proposed-awaiting-approval.json +114 -0
  697. package/tests/fixtures/atlassian-case-capsule/valid/07-t3-no-go-rejected-record.json +114 -0
  698. package/tests/fixtures/atlassian-case-capsule/valid/08-t3-expired-record.json +122 -0
  699. package/tests/fixtures/atlassian-case-capsule/valid/09-t3-completed-return-to-delegator.json +150 -0
  700. package/tests/fixtures/atlassian-case-capsule/valid/10-t3-safety-prose-and-atlassian-named-owner.json +123 -0
  701. package/tests/fixtures/atlassian-case-capsule/valid/11-t1-completed-read-only-review.json +115 -0
  702. package/tests/fixtures/atlassian-case-capsule/valid/12-t1-query-with-dotted-literals.json +114 -0
  703. package/tests/fixtures/atlassian-maestro-routing/expected/01-happy-incident-prevention.json +6 -0
  704. package/tests/fixtures/atlassian-maestro-routing/expected/02-happy-control-evidence.json +6 -0
  705. package/tests/fixtures/atlassian-maestro-routing/expected/03-happy-knowledge-integrity.json +6 -0
  706. package/tests/fixtures/atlassian-maestro-routing/expected/04-happy-adr-superseded.json +6 -0
  707. package/tests/fixtures/atlassian-maestro-routing/expected/05-happy-ai-cost.json +6 -0
  708. package/tests/fixtures/atlassian-maestro-routing/expected/06-cross-incident-knowledge.json +7 -0
  709. package/tests/fixtures/atlassian-maestro-routing/expected/07-cross-audit-incident.json +7 -0
  710. package/tests/fixtures/atlassian-maestro-routing/expected/08-gate-create-and-publish.json +6 -0
  711. package/tests/fixtures/atlassian-maestro-routing/expected/09-adv-injection-in-comment.json +6 -0
  712. package/tests/fixtures/atlassian-maestro-routing/expected/10-adv-prohibited-approval.json +6 -0
  713. package/tests/fixtures/atlassian-maestro-routing/expected/11-adv-bulk-delete.json +6 -0
  714. package/tests/fixtures/atlassian-maestro-routing/expected/12-adv-restriction-change.json +6 -0
  715. package/tests/fixtures/atlassian-maestro-routing/expected/13-ambiguous-help.json +4 -0
  716. package/tests/fixtures/atlassian-maestro-routing/expected/14-unsupported-delivery-bottleneck.json +4 -0
  717. package/tests/fixtures/atlassian-maestro-routing/expected/15-direct-authoring-no-specialist.json +4 -0
  718. package/tests/fixtures/atlassian-maestro-routing/expected/16-draft-only-must-not-gate.json +6 -0
  719. package/tests/fixtures/atlassian-maestro-routing/expected/17-adv-restriction-change-no-product-word.json +6 -0
  720. package/tests/fixtures/atlassian-maestro-routing/expected/18-adv-permission-grant.json +6 -0
  721. package/tests/fixtures/atlassian-maestro-routing/expected/19-adv-alert-acknowledge.json +6 -0
  722. package/tests/fixtures/atlassian-maestro-routing/expected/20-adv-purge-without-product-word.json +6 -0
  723. package/tests/fixtures/atlassian-maestro-routing/expected/21-adv-space-ai-instructions.json +6 -0
  724. package/tests/fixtures/atlassian-maestro-routing/expected/22-adv-injection-by-issue-key.json +6 -0
  725. package/tests/fixtures/atlassian-maestro-routing/expected/23-negated-write-does-not-gate.json +6 -0
  726. package/tests/fixtures/atlassian-maestro-routing/expected/24-noun-change-request-not-a-write.json +6 -0
  727. package/tests/fixtures/atlassian-maestro-routing/expected/25-comment-on-whether-not-a-write.json +6 -0
  728. package/tests/fixtures/atlassian-maestro-routing/expected/26-requested-update-gates.json +6 -0
  729. package/tests/fixtures/atlassian-maestro-routing/inputs/01-happy-incident-prevention.json +7 -0
  730. package/tests/fixtures/atlassian-maestro-routing/inputs/02-happy-control-evidence.json +7 -0
  731. package/tests/fixtures/atlassian-maestro-routing/inputs/03-happy-knowledge-integrity.json +7 -0
  732. package/tests/fixtures/atlassian-maestro-routing/inputs/04-happy-adr-superseded.json +7 -0
  733. package/tests/fixtures/atlassian-maestro-routing/inputs/05-happy-ai-cost.json +8 -0
  734. package/tests/fixtures/atlassian-maestro-routing/inputs/06-cross-incident-knowledge.json +7 -0
  735. package/tests/fixtures/atlassian-maestro-routing/inputs/07-cross-audit-incident.json +7 -0
  736. package/tests/fixtures/atlassian-maestro-routing/inputs/08-gate-create-and-publish.json +7 -0
  737. package/tests/fixtures/atlassian-maestro-routing/inputs/09-adv-injection-in-comment.json +8 -0
  738. package/tests/fixtures/atlassian-maestro-routing/inputs/10-adv-prohibited-approval.json +8 -0
  739. package/tests/fixtures/atlassian-maestro-routing/inputs/11-adv-bulk-delete.json +8 -0
  740. package/tests/fixtures/atlassian-maestro-routing/inputs/12-adv-restriction-change.json +8 -0
  741. package/tests/fixtures/atlassian-maestro-routing/inputs/13-ambiguous-help.json +7 -0
  742. package/tests/fixtures/atlassian-maestro-routing/inputs/14-unsupported-delivery-bottleneck.json +7 -0
  743. package/tests/fixtures/atlassian-maestro-routing/inputs/15-direct-authoring-no-specialist.json +7 -0
  744. package/tests/fixtures/atlassian-maestro-routing/inputs/16-draft-only-must-not-gate.json +7 -0
  745. package/tests/fixtures/atlassian-maestro-routing/inputs/17-adv-restriction-change-no-product-word.json +8 -0
  746. package/tests/fixtures/atlassian-maestro-routing/inputs/18-adv-permission-grant.json +8 -0
  747. package/tests/fixtures/atlassian-maestro-routing/inputs/19-adv-alert-acknowledge.json +8 -0
  748. package/tests/fixtures/atlassian-maestro-routing/inputs/20-adv-purge-without-product-word.json +8 -0
  749. package/tests/fixtures/atlassian-maestro-routing/inputs/21-adv-space-ai-instructions.json +8 -0
  750. package/tests/fixtures/atlassian-maestro-routing/inputs/22-adv-injection-by-issue-key.json +8 -0
  751. package/tests/fixtures/atlassian-maestro-routing/inputs/23-negated-write-does-not-gate.json +7 -0
  752. package/tests/fixtures/atlassian-maestro-routing/inputs/24-noun-change-request-not-a-write.json +8 -0
  753. package/tests/fixtures/atlassian-maestro-routing/inputs/25-comment-on-whether-not-a-write.json +8 -0
  754. package/tests/fixtures/atlassian-maestro-routing/inputs/26-requested-update-gates.json +7 -0
  755. package/tests/fixtures/atlassian-maestro-routing/taxonomy.json +68 -0
  756. package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
  757. package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
  758. package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
  759. package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
  760. package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
  761. package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
  762. package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
  763. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
  764. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
  765. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
  766. package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
  767. package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
  768. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
  769. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
  770. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
  771. package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
  772. package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
  773. package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
  774. package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
  775. package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
  776. package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
  777. package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
  778. package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
  779. package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
  780. package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
  781. package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
  782. package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
  783. package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
  784. package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
  785. package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
  786. package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
  787. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
  788. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
  789. package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
  790. package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
  791. package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
  792. package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
  793. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
  794. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
  795. package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
  796. package/tests/requirements-ci.txt +8 -0
  797. package/tests/validate-atlassian-case-capsule.py +24 -0
  798. package/tests/validate-aws-skill-quality.py +7 -0
  799. package/tests/validate-catalog.py +1 -0
  800. package/tests/validate-nosql-audit.py +741 -0
  801. package/tests/validate-nosql-operations.py +136 -0
  802. package/tests/validate-nosql-pattern-evals.py +96 -0
  803. package/tests/validate-nosql-scenarios.py +94 -0
  804. package/tests/validate-skill-manifest.py +6 -1
  805. package/tests/validate-skill-references.py +229 -0
@@ -0,0 +1,136 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: every NoSQL service has a complete, evidence-cited operations reference.
3
+
4
+ Each service in ``SERVICES`` must ship an operations file that:
5
+
6
+ * exists and is linked from its skill's ``SKILL.md`` (otherwise no agent loads it);
7
+ * contains every heading in ``SECTIONS``, once each, in that order;
8
+ * states exactly one ``**Status:**`` per section, from ``STATUSES``;
9
+ * cites at least one evidence row in every section whose status is VERIFIED,
10
+ PARTIAL or UNSUPPORTED, and every cited row exists in the skill's ledger;
11
+ * in a VERIFIED section, cites only rows whose ledger status is VERIFIED;
12
+ * writes no unit prices or currency amounts in the Cost section (billing
13
+ dimensions only; prices go stale by Region and over time).
14
+
15
+ The structure lives in ``templates/nosql-operations-template.md``. Add a service by
16
+ adding its entry here; never weaken a rule to get green.
17
+ """
18
+ from __future__ import annotations
19
+
20
+ import re
21
+ import sys
22
+ from pathlib import Path
23
+
24
+ REPO = Path(__file__).resolve().parents[1]
25
+
26
+ # service -> (skill directory, operations file relative to the skill)
27
+ SERVICES: dict[str, tuple[str, str]] = {
28
+ "Amazon DynamoDB": ("skills/aws/aws-dynamodb-patterns", "references/operations.md"),
29
+ "Amazon DocumentDB": ("skills/aws/aws-documentdb-architect", "references/operations.md"),
30
+ "Amazon Keyspaces": ("skills/aws/aws-keyspaces-architect", "references/operations.md"),
31
+ "Azure Cosmos DB for NoSQL": ("skills/azure/azure-cosmosdb-platform-operator", "references/operations.md"),
32
+ "Azure Cosmos DB for MongoDB": ("skills/azure/azure-cosmosdb-platform-operator", "references/operations-mongodb.md"),
33
+ "Azure Cosmos DB for Apache Cassandra": ("skills/azure/azure-cosmosdb-platform-operator", "references/operations-cassandra.md"),
34
+ "Oracle NoSQL Database Cloud Service": ("skills/oci/oci-nosql-database-architect", "references/operations.md"),
35
+ "Firestore (Native mode)": ("skills/gcp/gcp-firebase-developer", "references/firestore-operations.md"),
36
+ "Firestore with MongoDB compatibility": ("skills/gcp/gcp-firebase-developer", "references/firestore-mongodb-operations.md"),
37
+ "Cloud Bigtable": ("skills/gcp/gcp-bigtable-architect", "references/operations.md"),
38
+ "Alibaba Cloud Tablestore": ("skills/alibaba/alibaba-tablestore-architect", "references/operations.md"),
39
+ "Huawei Cloud GeminiDB": ("skills/huawei/huawei-geminidb-architect", "references/operations.md"),
40
+ "Huawei Cloud DDS": ("skills/huawei/huawei-gaussdb-rds-dba", "references/dds-operations.md"),
41
+ "Scaleway Managed MongoDB": ("skills/scaleway/scaleway-managed-mongodb-architect", "references/operations.md"),
42
+ "OVHcloud Public Cloud Databases for MongoDB": ("skills/ovhcloud/ovhcloud-mongodb-architect", "references/operations.md"),
43
+ "IONOS Cloud DBaaS MongoDB": ("skills/ionos/ionos-live-database-lifecycle-guard", "references/mongodb-operations.md"),
44
+ }
45
+ SECTIONS = [
46
+ "Backup and restore",
47
+ "Disaster recovery and replication",
48
+ "Cost",
49
+ "Monitoring",
50
+ "Performance",
51
+ "IAM",
52
+ "Tagging",
53
+ "Encryption",
54
+ "Network isolation",
55
+ "Audit logging",
56
+ ]
57
+ STATUSES = {"VERIFIED", "PARTIAL", "UNSUPPORTED", "UNVERIFIED", "NOT APPLICABLE"}
58
+ NEEDS_CITATION = {"VERIFIED", "PARTIAL", "UNSUPPORTED"}
59
+ EVIDENCE_ID = r"[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-E\d{2,}"
60
+ MARKER_RE = re.compile(r"\[(" + EVIDENCE_ID + r")\]")
61
+ ROW_RE = re.compile(r"^\|\s*(" + EVIDENCE_ID + r")\s*\|(.*)\|\s*$")
62
+ STATUS_RE = re.compile(r"^\*\*Status:\*\*\s*(.+?)\s*$", re.MULTILINE)
63
+ PRICE_RE = re.compile(r"(?:[$€£¥]\s?\d)|(?:\b\d[\d,.]*\s?(?:USD|EUR|GBP|CNY|RMB|JPY)\b)|(?:\b(?:USD|EUR|GBP|CNY|RMB|JPY)\s?\d)")
64
+
65
+
66
+ def ledger_status(skill: Path) -> dict[str, str]:
67
+ ledger = skill / "references/evidence-ledger.md"
68
+ rows: dict[str, str] = {}
69
+ if ledger.exists():
70
+ for line in ledger.read_text(encoding="utf-8").splitlines():
71
+ match = ROW_RE.match(line.strip())
72
+ if match:
73
+ rows[match.group(1)] = match.group(2).split("|")[-1].strip()
74
+ return rows
75
+
76
+
77
+ def check(service: str, skill_rel: str, ops_rel: str, errors: list[str]) -> None:
78
+ skill = REPO / skill_rel
79
+ ops = skill / ops_rel
80
+ where = f"{service} ({skill_rel}/{ops_rel})"
81
+ if not ops.exists():
82
+ errors.append(f"{where}: operations file missing")
83
+ return
84
+ skill_md = skill / "SKILL.md"
85
+ if not skill_md.exists() or f"]({ops_rel})" not in skill_md.read_text(encoding="utf-8"):
86
+ errors.append(f"{where}: SKILL.md does not link {ops_rel}; no agent would load it")
87
+ text = ops.read_text(encoding="utf-8")
88
+ headings = re.findall(r"^## (.+?)\s*$", text, re.MULTILINE)
89
+ found = [h for h in headings if h in SECTIONS]
90
+ if found != SECTIONS:
91
+ missing = [s for s in SECTIONS if s not in headings]
92
+ errors.append(f"{where}: sections must be exactly {SECTIONS} in order; missing={missing}, found={found}")
93
+ return
94
+ rows = ledger_status(skill)
95
+ starts = [m.start() for m in re.finditer(r"^## ", text, re.MULTILINE)] + [len(text)]
96
+ for begin, end in zip(starts, starts[1:]):
97
+ block = text[begin:end]
98
+ title = block.splitlines()[0][3:].strip()
99
+ if title not in SECTIONS:
100
+ continue
101
+ statuses = STATUS_RE.findall(block)
102
+ if len(statuses) != 1:
103
+ errors.append(f"{where} [{title}]: expected one **Status:** line, found {len(statuses)}")
104
+ continue
105
+ status = statuses[0]
106
+ if status not in STATUSES:
107
+ errors.append(f"{where} [{title}]: status '{status}' not in {sorted(STATUSES)}")
108
+ continue
109
+ cited = MARKER_RE.findall(block)
110
+ if status in NEEDS_CITATION and not cited:
111
+ errors.append(f"{where} [{title}]: status {status} needs at least one evidence citation")
112
+ for evidence in cited:
113
+ if evidence not in rows:
114
+ errors.append(f"{where} [{title}]: {evidence} has no row in the skill's evidence ledger")
115
+ elif status == "VERIFIED" and rows[evidence] != "VERIFIED":
116
+ errors.append(f"{where} [{title}]: VERIFIED section cites {evidence}, whose ledger status is {rows[evidence]}")
117
+ if title == "Cost":
118
+ for price in PRICE_RE.findall(block):
119
+ errors.append(f"{where} [Cost]: unit price or currency amount '{price}'; record billing dimensions only")
120
+
121
+
122
+ def main() -> int:
123
+ errors: list[str] = []
124
+ for service, (skill_rel, ops_rel) in SERVICES.items():
125
+ check(service, skill_rel, ops_rel, errors)
126
+ if errors:
127
+ for error in errors:
128
+ print(f"FAIL: {error}")
129
+ print(f"validate-nosql-operations: {len(errors)} problem(s)")
130
+ return 1
131
+ print(f"validate-nosql-operations: OK ({len(SERVICES)} services x {len(SECTIONS)} sections)")
132
+ return 0
133
+
134
+
135
+ if __name__ == "__main__":
136
+ sys.exit(main())
@@ -0,0 +1,96 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: run the offline evals shipped with the NoSQL pattern skills.
3
+
4
+ The pattern skills ship
5
+ executable helpers (route selectors, review reminders, recovery checks) and example
6
+ assets (shell, Python, Node). Their own evals check them with fake cloud binaries
7
+ and never contact a cloud. Shipping code without running its tests would let a
8
+ broken selector or asset reach every harness, so this gate runs them all.
9
+
10
+ Fails closed when a prerequisite is missing: two eval files lint CloudFormation
11
+ with ``cfn-lint`` (pinned in ``tests/requirements-ci.txt``), and the Node eval needs ``node``.
12
+ Install with ``python3 -m pip install -r tests/requirements-ci.txt``.
13
+
14
+ Also fails if ``.plugin-scanner.toml`` excludes any file this gate executes or
15
+ imports (evals, scripts, assets): code CI runs must stay visible to the HOL
16
+ secret and injection scanner. Matching uses ``fnmatch`` on the repo-relative
17
+ path, the same rule the scanner applies to ``ignore_paths``.
18
+ """
19
+ from __future__ import annotations
20
+
21
+ import os
22
+ import tomllib
23
+ import shutil
24
+ import subprocess
25
+ import sys
26
+ from fnmatch import fnmatch
27
+ from pathlib import Path
28
+
29
+ REPO = Path(__file__).resolve().parents[1]
30
+ SKILLS = [
31
+ REPO / "skills/aws/aws-dynamodb-patterns",
32
+ REPO / "skills/oci/oci-nosql-pattern",
33
+ REPO / "skills/azure/azure-cosmosdb-pattern",
34
+ ]
35
+ TIMEOUT = 300
36
+ SCANNER_CONFIG = REPO / ".plugin-scanner.toml"
37
+ NON_EXECUTABLE = {".md", ".json"}
38
+
39
+
40
+ def scanner_blind_spots() -> list[str]:
41
+ """Executable files of the pattern skills that the scanner config would skip."""
42
+ if not SCANNER_CONFIG.exists():
43
+ return []
44
+ with SCANNER_CONFIG.open("rb") as handle:
45
+ patterns = tomllib.load(handle).get("scanner", {}).get("ignore_paths", [])
46
+ hidden = []
47
+ for skill in SKILLS:
48
+ for path in sorted(skill.rglob("*")):
49
+ if not path.is_file() or path.suffix in NON_EXECUTABLE or "__pycache__" in path.parts:
50
+ continue
51
+ relative = path.relative_to(REPO).as_posix()
52
+ hidden += [f"{relative} (ignore_paths: {pattern})" for pattern in patterns if fnmatch(relative, pattern)]
53
+ return hidden
54
+
55
+
56
+ def main() -> int:
57
+ missing = [tool for tool in ("cfn-lint", "node", "bash") if shutil.which(tool) is None]
58
+ if missing:
59
+ print(f"FAIL: missing prerequisite(s): {', '.join(missing)}. "
60
+ "Install cfn-lint with: python3 -m pip install -r tests/requirements-ci.txt")
61
+ return 1
62
+ hidden = scanner_blind_spots()
63
+ if hidden:
64
+ print("FAIL: .plugin-scanner.toml hides code this gate executes from the scanner:")
65
+ print("\n".join(f" {entry}" for entry in hidden))
66
+ return 1
67
+ commands = []
68
+ for skill in SKILLS:
69
+ found = [(skill, [sys.executable, str(path)]) for path in sorted((skill / "evals").glob("*.py"))]
70
+ found += [(skill, ["node", "--test", str(path)]) for path in sorted((skill / "evals").glob("*.mjs"))]
71
+ if not found:
72
+ print(f"FAIL: no evals found under {skill / 'evals'}")
73
+ return 1
74
+ commands += found
75
+ failures = 0
76
+ for skill, command in commands:
77
+ name = f"{skill.name}/{Path(command[-1]).name}"
78
+ try:
79
+ result = subprocess.run(command, cwd=skill, capture_output=True, text=True, timeout=TIMEOUT,
80
+ env={**os.environ, "PYTHONDONTWRITEBYTECODE": "1"})
81
+ except subprocess.TimeoutExpired:
82
+ print(f"FAIL {name}: timed out after {TIMEOUT}s")
83
+ failures += 1
84
+ continue
85
+ if result.returncode == 0:
86
+ print(f"OK {name}")
87
+ else:
88
+ failures += 1
89
+ print(f"FAIL {name} (exit {result.returncode})")
90
+ print((result.stdout + result.stderr)[-4000:])
91
+ print(f"{len(commands) - failures}/{len(commands)} NoSQL pattern eval files passed")
92
+ return 1 if failures else 0
93
+
94
+
95
+ if __name__ == "__main__":
96
+ sys.exit(main())
@@ -0,0 +1,94 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: every NoSQL behavioral scenario is answerable from the file the skill loads.
3
+
4
+ Reads tests/fixtures/nosql-scenarios/scenarios.json. For each scenario it checks,
5
+ deterministically (no model, no network, no clock):
6
+
7
+ * the target skill exists and its SKILL.md links the scenario's reference file
8
+ (``SKILL.md`` itself is allowed for entry-point rules), so progressive
9
+ disclosure actually reaches the guidance;
10
+ * every required evidence ID is a row in that skill's evidence ledger AND is
11
+ cited in the reference file, so the answer is traceable;
12
+ * every ``must_mention`` phrase occurs in the reference file (case-insensitive),
13
+ so the decisive fact or refusal rule has not been edited away.
14
+
15
+ This does not prove a model answers correctly. ``pass_criteria`` is the rubric
16
+ for live model runs, which stay outside CI because they are not reproducible.
17
+
18
+ Usage: python3 tests/validate-nosql-scenarios.py
19
+ """
20
+ from __future__ import annotations
21
+
22
+ import json
23
+ import re
24
+ import sys
25
+ from pathlib import Path
26
+
27
+ REPO = Path(__file__).resolve().parent.parent
28
+ SCENARIOS = REPO / "tests/fixtures/nosql-scenarios/scenarios.json"
29
+ REQUIRED_KEYS = {"id", "skill", "reference", "prompt", "required_evidence", "must_mention", "pass_criteria"}
30
+
31
+
32
+ def ledger_ids(skill_dir: Path) -> set[str]:
33
+ ledger = skill_dir / "references/evidence-ledger.md"
34
+ if not ledger.exists():
35
+ return set()
36
+ return set(re.findall(r"^\|\s*([A-Z][A-Z0-9-]*-E\d{2,})\s*\|", ledger.read_text(encoding="utf-8"), re.M))
37
+
38
+
39
+ def check(scenario: dict, errors: list[str], seen: set[str]) -> None:
40
+ sid = scenario.get("id", "<missing id>")
41
+ missing = REQUIRED_KEYS - scenario.keys()
42
+ if missing:
43
+ errors.append(f"{sid}: missing keys {sorted(missing)}")
44
+ return
45
+ if sid in seen:
46
+ errors.append(f"{sid}: duplicate scenario id")
47
+ seen.add(sid)
48
+ if len(scenario["pass_criteria"]) < 20 or len(scenario["prompt"]) < 20:
49
+ errors.append(f"{sid}: prompt and pass_criteria must be concrete (>= 20 chars)")
50
+
51
+ skill_dir = REPO / scenario["skill"]
52
+ skill_md = skill_dir / "SKILL.md"
53
+ if not skill_md.exists():
54
+ errors.append(f"{sid}: skill {scenario['skill']} has no SKILL.md")
55
+ return
56
+ reference = skill_dir / scenario["reference"]
57
+ if not reference.exists():
58
+ errors.append(f"{sid}: reference {scenario['reference']} does not exist")
59
+ return
60
+ if scenario["reference"] != "SKILL.md" and f"]({scenario['reference']})" not in skill_md.read_text(encoding="utf-8"):
61
+ errors.append(f"{sid}: SKILL.md does not link {scenario['reference']}; the skill would never load it")
62
+
63
+ text = reference.read_text(encoding="utf-8")
64
+ ids = ledger_ids(skill_dir)
65
+ for evidence in scenario["required_evidence"]:
66
+ if evidence not in ids:
67
+ errors.append(f"{sid}: {evidence} is not a row in the skill's evidence ledger")
68
+ elif f"[{evidence}]" not in text:
69
+ errors.append(f"{sid}: {evidence} is not cited in {scenario['reference']}")
70
+ for phrase in scenario["must_mention"]:
71
+ if phrase.lower() not in text.lower():
72
+ errors.append(f"{sid}: '{phrase}' not found in {scenario['reference']}")
73
+
74
+
75
+ def main() -> int:
76
+ data = json.loads(SCENARIOS.read_text(encoding="utf-8"))
77
+ scenarios = data.get("scenarios", [])
78
+ errors: list[str] = []
79
+ seen: set[str] = set()
80
+ if not scenarios:
81
+ errors.append("no scenarios defined")
82
+ for scenario in scenarios:
83
+ check(scenario, errors, seen)
84
+ if errors:
85
+ print("validate-nosql-scenarios: FAIL", file=sys.stderr)
86
+ for error in errors:
87
+ print(f" - {error}", file=sys.stderr)
88
+ return 1
89
+ print(f"validate-nosql-scenarios: OK ({len(scenarios)} scenarios grounded in their loaded references)")
90
+ return 0
91
+
92
+
93
+ if __name__ == "__main__":
94
+ sys.exit(main())
@@ -29,7 +29,12 @@ def load_json(path: Path):
29
29
 
30
30
  def skill_files(skill_path: Path) -> list[dict]:
31
31
  files: list[dict] = []
32
- for path in sorted(p for p in skill_path.rglob("*") if p.is_file()):
32
+ # Skip interpreter bytecode caches: they are git-ignored, so hashing them makes the
33
+ # manifest depend on whether a skill's scripts happened to run locally (CI never has them).
34
+ for path in sorted(
35
+ p for p in skill_path.rglob("*")
36
+ if p.is_file() and "__pycache__" not in p.parts and p.suffix != ".pyc"
37
+ ):
33
38
  rel = path.relative_to(ROOT).as_posix()
34
39
  data = path.read_bytes()
35
40
  files.append({
@@ -0,0 +1,229 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: skill/agent reference links resolve, and evidence ledgers are traceable.
3
+
4
+ Two checks, both deterministic (no network, no wall clock):
5
+
6
+ 1. Every relative Markdown link in a ``SKILL.md``, ``AGENT.md`` or skill
7
+ ``references/*.md`` file resolves to a file on disk. Progressive disclosure
8
+ depends on these links: a broken one silently drops guidance the entry point
9
+ promised to load.
10
+
11
+ 2. Every plain-text ``references/<file>.md`` mention in a ``SKILL.md`` (for
12
+ example a routing table cell) names a file that exists. Skills often route
13
+ by path in prose rather than by Markdown link, and a promised reference
14
+ that does not exist is the same silent gap as a broken link. Pre-existing
15
+ gaps are listed in ``KNOWN_MISSING_REFERENCES`` so that no new one can be
16
+ added; fixing one forces its removal from the list.
17
+
18
+ 3. Any skill or agent directory that ships ``references/evidence-ledger.md``
19
+ opts into claim-to-source traceability:
20
+
21
+ * every ledger row has a unique evidence ID, an ``https`` URL on an
22
+ allow-listed provider documentation host, a ``YYYY-MM-DD`` retrieval date
23
+ and a status of ``VERIFIED``, ``UNVERIFIED`` or ``CONFLICT``;
24
+ * every ``[EVIDENCE-ID]`` marker cited in that directory's Markdown exists in
25
+ its ledger (no citation to nothing);
26
+ * every ledger row is cited at least once outside the ledger (no orphan
27
+ evidence that nothing depends on).
28
+
29
+ The allow-list is deliberately narrow: a ledger proves provider behaviour, so
30
+ its sources must be the provider's own documentation or SDK repositories.
31
+ Extend ``OFFICIAL_SOURCES`` only with a provider-owned host or org.
32
+
33
+ Usage: python3 tests/validate-skill-references.py
34
+ """
35
+ from __future__ import annotations
36
+
37
+ import re
38
+ import sys
39
+ from pathlib import Path
40
+ from urllib.parse import urlparse
41
+
42
+ REPO = Path(__file__).resolve().parent.parent
43
+
44
+ # host -> allowed path prefixes ("" = any path on that host)
45
+ OFFICIAL_SOURCES: dict[str, tuple[str, ...]] = {
46
+ "docs.oracle.com": ("",),
47
+ "docs.aws.amazon.com": ("",),
48
+ # Provider-owned pricing pages are the authority for billing dimensions in the
49
+ # NoSQL operations references (Cost sections record dimensions, never prices).
50
+ "aws.amazon.com": ("/documentdb/pricing/", "/keyspaces/pricing/", "/dynamodb/pricing/"),
51
+ "learn.microsoft.com": ("",),
52
+ "firebase.google.com": ("/docs/",),
53
+ "cloud.google.com": ("/",),
54
+ "docs.cloud.google.com": ("/",),
55
+ "www.alibabacloud.com": ("/help/",),
56
+ "support.huaweicloud.com": ("/",),
57
+ # Managed MongoDB documentation for the smaller clouds' NoSQL operations references.
58
+ "www.scaleway.com": ("/en/docs/",),
59
+ "help.ovhcloud.com": ("/csm/",),
60
+ "docs.ovhcloud.com": ("/",),
61
+ "docs.ionos.com": ("/cloud/",),
62
+ # Provider-owned CLI references for the NoSQL audit commands: Alibaba's OpenAPI
63
+ # portal CLI pages, and the Scaleway and OVHcloud CLI repositories' command docs.
64
+ "api.alibabacloud.com": ("/api-tools/cli/",),
65
+ # Atlassian developer documentation (Rovo MCP Server guides, Jira Cloud rate limiting)
66
+ # for the atlassian-rovo-mcp-integration ledger; github.com/atlassian/ is the
67
+ # vendor-maintained Rovo MCP Server repository.
68
+ "developer.atlassian.com": ("/cloud/",),
69
+ "github.com": ("/oracle/", "/aws/", "/awslabs/", "/Azure/", "/googleapis/", "/aliyun/", "/scaleway/", "/ovh/", "/atlassian/"),
70
+ # GitHub Pages of the github.com/oracle organisation (Oracle NoSQL Node.js SDK reference).
71
+ "oracle.github.io": ("/nosql-node-sdk/",),
72
+ }
73
+
74
+ # Pre-existing, unrelated debt: these SKILL.md files route to reference files
75
+ # that were never written. Listed so the gate blocks *new* gaps today; remove an
76
+ # entry when its file is written (the gate fails on stale entries). Do not add
77
+ # to this list to get green - write the reference or drop the promise instead.
78
+ KNOWN_MISSING_REFERENCES: dict[str, set[str]] = {
79
+ "skills/gcp/gcp-alloydb-ai-developer": {
80
+ "references/ai-functions.md", "references/alloydb-omni.md", "references/hybrid-search.md",
81
+ "references/iam-security.md", "references/model-endpoints.md", "references/vector-search.md",
82
+ },
83
+ "skills/gcp/gcp-firebase-developer": {
84
+ "references/app-check.md", "references/auth.md", "references/emulators.md",
85
+ "references/extensions.md", "references/functions.md", "references/hosting.md",
86
+ "references/security-rules.md",
87
+ },
88
+ "skills/gcp/gcp-gemini-api-developer": {
89
+ "references/batch.md", "references/caching.md", "references/embeddings.md",
90
+ "references/live-api.md", "references/migration.md", "references/safety.md",
91
+ "references/structured-output.md", "references/text-multimodal.md", "references/tools.md",
92
+ "references/tuning.md",
93
+ },
94
+ "skills/gcp/gcp-networking-observability": {
95
+ "references/cloud-nat-analysis.md", "references/connectivity-tests.md",
96
+ "references/firewall-analysis.md", "references/metrics-analysis.md",
97
+ "references/threat-analysis.md", "references/vpc-flow-analysis.md",
98
+ },
99
+ }
100
+
101
+ LINK_RE = re.compile(r"\]\(([^)\s]+)\)")
102
+ PLAIN_REF_RE = re.compile(r"(?<![\w/.-])(references/[A-Za-z0-9._/-]+\.md)")
103
+ EVIDENCE_ID = r"[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-E\d{2,}"
104
+ MARKER_RE = re.compile(r"\[(" + EVIDENCE_ID + r")\]")
105
+ ROW_RE = re.compile(r"^\|\s*(" + EVIDENCE_ID + r")\s*\|(.*)\|\s*$")
106
+ DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
107
+ STATUSES = {"VERIFIED", "UNVERIFIED", "CONFLICT"}
108
+ LEDGER_COLUMNS = 5 # claim | source URL | section | retrieved | status
109
+
110
+
111
+ def markdown_files() -> list[Path]:
112
+ files: list[Path] = []
113
+ for root in ("skills", "agents"):
114
+ base = REPO / root
115
+ files += base.rglob("SKILL.md")
116
+ files += base.rglob("AGENT.md")
117
+ files += base.rglob("references/**/*.md") # includes references/commands/** guides
118
+ return sorted(set(files))
119
+
120
+
121
+ def strip_code(text: str) -> str:
122
+ """Drop fenced and inline code so example syntax is never read as a link."""
123
+ text = re.sub(r"```.*?```", "", text, flags=re.S)
124
+ return re.sub(r"`[^`\n]*`", "", text)
125
+
126
+
127
+ def check_links(errors: list[str]) -> int:
128
+ checked = 0
129
+ for path in markdown_files():
130
+ for match in LINK_RE.finditer(strip_code(path.read_text(encoding="utf-8"))):
131
+ target = match.group(1).split("#", 1)[0]
132
+ if not target or re.match(r"^[a-z][a-z0-9+.-]*:", target):
133
+ continue # pure anchor, or an absolute URL / mailto
134
+ checked += 1
135
+ if not (path.parent / target).exists():
136
+ errors.append(f"{path.relative_to(REPO)}: broken relative link '{target}'")
137
+ return checked
138
+
139
+
140
+ def check_plain_references(errors: list[str]) -> int:
141
+ checked = 0
142
+ seen_dirs: set[str] = set()
143
+ for skill_md in sorted((REPO / "skills").rglob("SKILL.md")):
144
+ rel_dir = skill_md.parent.relative_to(REPO).as_posix()
145
+ seen_dirs.add(rel_dir)
146
+ known = KNOWN_MISSING_REFERENCES.get(rel_dir, set())
147
+ for ref in sorted(set(PLAIN_REF_RE.findall(skill_md.read_text(encoding="utf-8")))):
148
+ checked += 1
149
+ exists = (skill_md.parent / ref).exists()
150
+ if not exists and ref not in known:
151
+ errors.append(f"{rel_dir}/SKILL.md: names '{ref}', which does not exist")
152
+ elif exists and ref in known:
153
+ errors.append(f"{rel_dir}: '{ref}' now exists; remove it from KNOWN_MISSING_REFERENCES")
154
+ for rel_dir in sorted(set(KNOWN_MISSING_REFERENCES) - seen_dirs):
155
+ errors.append(f"KNOWN_MISSING_REFERENCES lists '{rel_dir}', which has no SKILL.md")
156
+ return checked
157
+
158
+
159
+ def official(url: str) -> bool:
160
+ parsed = urlparse(url)
161
+ if parsed.scheme != "https" or parsed.hostname not in OFFICIAL_SOURCES:
162
+ return False
163
+ return any(parsed.path.startswith(prefix) for prefix in OFFICIAL_SOURCES[parsed.hostname])
164
+
165
+
166
+ def check_ledger(ledger: Path, errors: list[str]) -> int:
167
+ rel = ledger.relative_to(REPO)
168
+ ids: dict[str, int] = {}
169
+ for lineno, line in enumerate(ledger.read_text(encoding="utf-8").splitlines(), 1):
170
+ row = ROW_RE.match(line.strip())
171
+ if not row:
172
+ continue
173
+ evidence_id = row.group(1)
174
+ cells = [c.strip() for c in row.group(2).split("|")]
175
+ where = f"{rel}:{lineno} {evidence_id}"
176
+ if evidence_id in ids:
177
+ errors.append(f"{where}: duplicate evidence ID (first at line {ids[evidence_id]})")
178
+ ids[evidence_id] = lineno
179
+ if len(cells) != LEDGER_COLUMNS:
180
+ errors.append(f"{where}: expected {LEDGER_COLUMNS} columns after the ID, found {len(cells)}")
181
+ continue
182
+ claim, source, _section, retrieved, status = cells
183
+ url = re.sub(r"^<|>$", "", source)
184
+ if len(claim) < 10:
185
+ errors.append(f"{where}: claim text is missing or too short")
186
+ if not official(url):
187
+ errors.append(f"{where}: source '{url}' is not an https URL on an allow-listed provider host")
188
+ if not DATE_RE.match(retrieved):
189
+ errors.append(f"{where}: retrieved date '{retrieved}' is not YYYY-MM-DD")
190
+ if status not in STATUSES:
191
+ errors.append(f"{where}: status '{status}' not in {sorted(STATUSES)}")
192
+ if not ids:
193
+ errors.append(f"{rel}: ledger has no evidence rows")
194
+ return 0
195
+
196
+ cited: set[str] = set()
197
+ for md in ledger.parent.parent.rglob("*.md"):
198
+ if md == ledger:
199
+ continue
200
+ for marker in MARKER_RE.findall(md.read_text(encoding="utf-8")):
201
+ cited.add(marker)
202
+ if marker not in ids:
203
+ errors.append(f"{md.relative_to(REPO)}: cites [{marker}] which is not in {rel}")
204
+ for orphan in sorted(set(ids) - cited):
205
+ errors.append(f"{rel}: {orphan} is never cited outside the ledger")
206
+ return len(ids)
207
+
208
+
209
+ def main() -> int:
210
+ errors: list[str] = []
211
+ links = check_links(errors)
212
+ plain = check_plain_references(errors)
213
+ ledgers = sorted((REPO / "skills").rglob("references/evidence-ledger.md"))
214
+ ledgers += sorted((REPO / "agents").rglob("references/evidence-ledger.md"))
215
+ rows = sum(check_ledger(ledger, errors) for ledger in ledgers)
216
+ if errors:
217
+ print("validate-skill-references: FAIL", file=sys.stderr)
218
+ for error in errors:
219
+ print(f" - {error}", file=sys.stderr)
220
+ return 1
221
+ print(
222
+ f"validate-skill-references: OK ({links} relative links and {plain} plain-text reference paths resolved; "
223
+ f"{len(ledgers)} evidence ledgers, {rows} rows traced)"
224
+ )
225
+ return 0
226
+
227
+
228
+ if __name__ == "__main__":
229
+ sys.exit(main())