@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,87 @@
1
+ #!/usr/bin/env python3
2
+ """Exercise the live-audit example only with fake metadata; never contact AWS."""
3
+ import json
4
+ import os
5
+ from pathlib import Path
6
+ import re
7
+ import subprocess
8
+ import tempfile
9
+ import unittest
10
+
11
+ ROOT = Path(__file__).resolve().parents[1]
12
+ LIVE = ROOT / "references/commands/audit/live.md"
13
+ PRINCIPAL = "arn:aws:sts::111122223333:assumed-role/ApprovedAuditRole/example"
14
+ FAKE_AWS = r'''#!/usr/bin/env python3
15
+ import json, os, sys
16
+ args = sys.argv[1:]
17
+ with open(os.environ["CALL_LOG"], "a") as log:
18
+ log.write(json.dumps(args) + "\n")
19
+ if "sts" in args and "get-caller-identity" in args:
20
+ print(json.dumps({"Account": os.environ.get("FAKE_ACCOUNT", "111122223333"),
21
+ "Arn": os.environ.get("FAKE_PRINCIPAL", os.environ["EXPECTED_PRINCIPAL_ARN"])}))
22
+ elif "dynamodb" in args and "describe-table" in args:
23
+ print(json.dumps({"Table": {"TableName": args[args.index("--table-name") + 1], "TableStatus": "ACTIVE"}}))
24
+ else:
25
+ raise SystemExit("Forbidden non-metadata operation in audit example")
26
+ '''
27
+
28
+
29
+ def run_live(missing=None, **updates):
30
+ with tempfile.TemporaryDirectory(prefix="audit-offline-test-") as directory:
31
+ root = Path(directory)
32
+ (root / "aws").write_text(FAKE_AWS)
33
+ (root / "aws").chmod(0o700)
34
+ env = {"PATH": f"{root}:{os.environ['PATH']}", "TMPDIR": directory,
35
+ "AWS_PROFILE": "offline-only", "AWS_REGION": "us-east-1", "TABLE_NAME": "OfflineTable",
36
+ "EXPECTED_ACCOUNT_ID": "111122223333", "EXPECTED_PRINCIPAL_ARN": PRINCIPAL,
37
+ "CALL_LOG": str(root / "calls.jsonl"), **updates}
38
+ if missing:
39
+ env.pop(missing)
40
+ script = "\n".join(re.findall(r"```bash\n(.*?)\n```", LIVE.read_text(), re.S))
41
+ result = subprocess.run(["bash", "-c", script], cwd=ROOT, env=env,
42
+ text=True, capture_output=True, timeout=10)
43
+ log = root / "calls.jsonl"
44
+ calls = [json.loads(line) for line in log.read_text().splitlines()] if log.exists() else []
45
+ tables = [json.loads(path.read_text()) for path in root.rglob("table.json")]
46
+ return result, calls, tables
47
+
48
+
49
+ class AuditTests(unittest.TestCase):
50
+ def test_actual_live_example_is_bounded_targeted_metadata_only(self):
51
+ blocks = re.findall(r"```bash\n(.*?)\n```", LIVE.read_text(), re.S)
52
+ self.assertEqual(len(blocks), 1)
53
+ syntax = subprocess.run(["bash", "-n"], input=blocks[0], text=True, capture_output=True)
54
+ self.assertEqual(syntax.returncode, 0, syntax.stderr)
55
+ result, calls, tables = run_live()
56
+ self.assertEqual(result.returncode, 0, result.stderr)
57
+ self.assertEqual(len(calls), 2)
58
+ self.assertIn("get-caller-identity", calls[0])
59
+ self.assertIn("describe-table", calls[1])
60
+ self.assertEqual(calls[1][calls[1].index("--table-name") + 1], "OfflineTable")
61
+ for args in calls:
62
+ self.assertEqual(args[args.index("--profile") + 1], "offline-only")
63
+ self.assertEqual(args[args.index("--region") + 1], "us-east-1")
64
+ self.assertIn("--no-cli-auto-prompt", args)
65
+ self.assertEqual(tables, [{"Table": {"TableName": "OfflineTable", "TableStatus": "ACTIVE"}}])
66
+
67
+ def test_missing_approved_target_stops_before_any_aws_call(self):
68
+ for name in ["AWS_PROFILE", "AWS_REGION", "TABLE_NAME", "EXPECTED_ACCOUNT_ID", "EXPECTED_PRINCIPAL_ARN"]:
69
+ with self.subTest(missing=name):
70
+ result, calls, tables = run_live(missing=name)
71
+ self.assertNotEqual(result.returncode, 0)
72
+ self.assertEqual(calls, [])
73
+ self.assertEqual(tables, [])
74
+
75
+ def test_account_or_principal_drift_stops_before_table_discovery(self):
76
+ for updates in [{"FAKE_ACCOUNT": "999900001111"}, {"FAKE_PRINCIPAL": "different-role"}]:
77
+ with self.subTest(updates=updates):
78
+ result, calls, tables = run_live(**updates)
79
+ self.assertNotEqual(result.returncode, 0)
80
+ self.assertIn("Identity mismatch", result.stderr)
81
+ self.assertEqual(len(calls), 1)
82
+ self.assertIn("get-caller-identity", calls[0])
83
+ self.assertEqual(tables, [])
84
+
85
+
86
+ if __name__ == "__main__":
87
+ unittest.main(verbosity=2)
@@ -0,0 +1,163 @@
1
+ #!/usr/bin/env python3
2
+ """Run real recovery command snippets with fake AWS only; never touch a table."""
3
+ import json
4
+ import os
5
+ from pathlib import Path
6
+ import re
7
+ import subprocess
8
+ import tempfile
9
+ import unittest
10
+
11
+ ROOT = Path(__file__).resolve().parents[1]
12
+ DOCS = ROOT / "references/commands"
13
+ TABLE_ARN = "arn:aws:dynamodb:us-east-1:111122223333:table/Orders"
14
+ BACKUP_ARN = TABLE_ARN + "/backup/01794110400000-example"
15
+ PRINCIPAL = "arn:aws:sts::111122223333:assumed-role/RecoveryRole/example"
16
+ FAKE = r'''#!/usr/bin/env python3
17
+ import json, os, sys
18
+ a = sys.argv[1:]
19
+ with open(os.environ["CALL_LOG"], "a") as log: log.write(json.dumps(a) + "\n")
20
+ if "sts" in a:
21
+ print(json.dumps({"Account": os.environ.get("FAKE_ACCOUNT", "111122223333"),
22
+ "Arn": os.environ.get("FAKE_PRINCIPAL", os.environ["EXPECTED_PRINCIPAL_ARN"])}))
23
+ else:
24
+ op = a[a.index("dynamodb") + 1]
25
+ if op == "describe-table":
26
+ table = {"TableArn": os.environ["SOURCE_ARN"], "TableStatus": "ACTIVE",
27
+ "TableId": os.environ.get("SOURCE_TABLE_ID", "6f1c2a3b-0000-4000-8000-000000000001")}
28
+ if os.environ.get("OMIT_TABLE_ID") == "1": table.pop("TableId")
29
+ print(json.dumps({"Table": table}))
30
+ elif op == "describe-continuous-backups":
31
+ print(json.dumps({"ContinuousBackupsDescription": {"PointInTimeRecoveryDescription": {
32
+ "PointInTimeRecoveryStatus": os.environ.get("PITR_STATUS", "ENABLED"), "RecoveryPeriodInDays": 35,
33
+ "EarliestRestorableDateTime": "2026-11-01T00:00:00Z", "LatestRestorableDateTime": "2026-11-08T02:00:00Z"}}}))
34
+ elif op == "create-backup":
35
+ print(json.dumps({"BackupDetails": {"BackupArn": os.environ["BACKUP_ARN"]}}))
36
+ elif op == "describe-backup":
37
+ print(json.dumps({"BackupDescription": {"BackupDetails": {"BackupStatus": os.environ.get("BACKUP_STATUS", "AVAILABLE")},
38
+ "SourceTableDetails": {"TableArn": os.environ.get("BACKUP_SOURCE", os.environ["SOURCE_ARN"]),
39
+ "TableId": os.environ.get("BACKUP_SOURCE_ID", "6f1c2a3b-0000-4000-8000-000000000001")}}}))
40
+ elif op in {"restore-table-to-point-in-time", "restore-table-from-backup"}:
41
+ if os.environ.get("RESTORE_FAIL") == "1": raise SystemExit("Existing target or unknown restore failure")
42
+ print("{}")
43
+ elif op in {"update-continuous-backups", "wait"}: print("{}")
44
+ else: raise SystemExit("Forbidden/unexpected recovery operation")
45
+ '''
46
+
47
+
48
+ def blocks(name):
49
+ return re.findall(r"```bash\n(.*?)\n```", (DOCS / name).read_text(), re.S)
50
+
51
+
52
+ def run(command, method="pitr", missing=None, **updates):
53
+ with tempfile.TemporaryDirectory(prefix="fake-recovery-") as directory:
54
+ root = Path(directory)
55
+ (root / "aws").write_text(FAKE)
56
+ (root / "aws").chmod(0o700)
57
+ env = {"PATH": f"{root}:{os.environ['PATH']}", "TMPDIR": directory,
58
+ "AWS_PROFILE": "offline-only", "AWS_REGION": "us-east-1", "TABLE_NAME": "Orders",
59
+ "EXPECTED_ACCOUNT_ID": "111122223333", "EXPECTED_PRINCIPAL_ARN": PRINCIPAL,
60
+ "SOURCE_ARN": TABLE_ARN, "BACKUP_ARN": BACKUP_ARN, "BACKUP_NAME": "ApprovedBackup",
61
+ "RECOVERY_DAYS": "35", "RESTORE_TABLE_NAME": "OrdersRecovered",
62
+ "RESTORE_AT": "2026-11-08T01:00:00Z", "CALL_LOG": str(root / "calls.jsonl"), **updates}
63
+ if missing:
64
+ env.pop(missing)
65
+ script = blocks("recovery-target.md")
66
+ if command == "restore":
67
+ before, after = blocks("restore.md")
68
+ script += [before, *blocks(f"restore/{method}.md"), after]
69
+ else:
70
+ script += blocks(f"backup/{method}.md")
71
+ result = subprocess.run(["bash", "-c", "\n".join(script)], cwd=ROOT, env=env,
72
+ text=True, capture_output=True, timeout=15)
73
+ log = root / "calls.jsonl"
74
+ calls = [json.loads(line) for line in log.read_text().splitlines()] if log.exists() else []
75
+ return result, calls
76
+
77
+
78
+ def operations(calls):
79
+ return [args[args.index("dynamodb") + 1] for args in calls if "dynamodb" in args]
80
+
81
+
82
+ class RecoveryTests(unittest.TestCase):
83
+ def test_all_actual_method_snippets_parse_and_target_expected_resources(self):
84
+ for name in ["recovery-target.md", "restore.md", "backup/pitr.md", "backup/on-demand.md",
85
+ "restore/pitr.md", "restore/on-demand.md"]:
86
+ syntax = subprocess.run(["bash", "-n"], input="\n".join(blocks(name)), text=True, capture_output=True)
87
+ self.assertEqual(syntax.returncode, 0, syntax.stderr)
88
+ for command in ["backup", "restore"]:
89
+ for method in ["pitr", "on-demand"]:
90
+ with self.subTest(command=command, method=method):
91
+ result, calls = run(command, method)
92
+ self.assertEqual(result.returncode, 0, result.stderr)
93
+ for args in calls:
94
+ self.assertEqual(args[args.index("--profile") + 1], "offline-only")
95
+ self.assertEqual(args[args.index("--region") + 1], "us-east-1")
96
+ if "--target-table-name" in args:
97
+ self.assertEqual(args[args.index("--target-table-name") + 1], "OrdersRecovered")
98
+ if "--backup-arn" in args:
99
+ self.assertEqual(args[args.index("--backup-arn") + 1], BACKUP_ARN)
100
+ if "--restore-date-time" in args:
101
+ self.assertEqual(args[args.index("--restore-date-time") + 1], "2026-11-08T01:00:00Z")
102
+ self.assertNotIn("--use-latest-restorable-time", args)
103
+ if "--point-in-time-recovery-specification" in args:
104
+ spec = json.loads(args[args.index("--point-in-time-recovery-specification") + 1])
105
+ self.assertEqual(spec, {"PointInTimeRecoveryEnabled": True, "RecoveryPeriodInDays": 35})
106
+ self.assertFalse(any(op.startswith("delete-") for op in operations(calls)))
107
+ if command == "restore":
108
+ expected = "restore-table-to-point-in-time" if method == "pitr" else "restore-table-from-backup"
109
+ self.assertIn(expected, operations(calls))
110
+ self.assertEqual(operations(calls)[-2:], ["wait", "describe-table"])
111
+
112
+ def test_pitr_requires_enabled_history_in_window_and_timezone(self):
113
+ cases = [{"PITR_STATUS": "DISABLED"}, {"RESTORE_AT": "2026-10-01T00:00:00Z"},
114
+ {"RESTORE_AT": "2026-11-09T00:00:00Z"}, {"RESTORE_AT": "2026-11-08T01:00:00"}]
115
+ for case in cases:
116
+ result, calls = run("restore", **case)
117
+ self.assertNotEqual(result.returncode, 0)
118
+ self.assertNotIn("restore-table-to-point-in-time", operations(calls))
119
+ self.assertNotIn("wait", operations(calls))
120
+
121
+ def test_on_demand_requires_available_exact_source_before_restore(self):
122
+ for case in [{"BACKUP_STATUS": "CREATING"}, {"BACKUP_SOURCE": TABLE_ARN + "Wrong"},
123
+ # Same name-based ARN, earlier incarnation of the table: must not restore.
124
+ {"BACKUP_SOURCE_ID": "6f1c2a3b-0000-4000-8000-000000000002"},
125
+ {"OMIT_TABLE_ID": "1"}]:
126
+ result, calls = run("restore", "on-demand", **case)
127
+ self.assertNotEqual(result.returncode, 0)
128
+ self.assertNotIn("restore-table-from-backup", operations(calls))
129
+ self.assertNotIn("wait", operations(calls))
130
+
131
+ def test_same_source_target_or_failed_restore_never_adopts_existing_table(self):
132
+ for case in [{"RESTORE_TABLE_NAME": "Orders"}, {"RESTORE_FAIL": "1"}]:
133
+ result, calls = run("restore", **case)
134
+ self.assertNotEqual(result.returncode, 0)
135
+ self.assertNotIn("wait", operations(calls))
136
+ self.assertFalse(any(op.startswith("delete-") for op in operations(calls)))
137
+
138
+ def test_bad_retention_never_updates_pitr(self):
139
+ for value in ["0", "36", "invalid"]:
140
+ result, calls = run("backup", RECOVERY_DAYS=value)
141
+ self.assertNotEqual(result.returncode, 0)
142
+ self.assertNotIn("update-continuous-backups", operations(calls))
143
+
144
+ def test_missing_target_or_identity_drift_stops_before_discovery(self):
145
+ for name in ["AWS_PROFILE", "AWS_REGION", "TABLE_NAME", "EXPECTED_ACCOUNT_ID", "EXPECTED_PRINCIPAL_ARN"]:
146
+ result, calls = run("backup", missing=name)
147
+ self.assertNotEqual(result.returncode, 0)
148
+ self.assertEqual(calls, [])
149
+ for case in [{"FAKE_ACCOUNT": "999900001111"}, {"FAKE_PRINCIPAL": "WrongRole"}]:
150
+ result, calls = run("backup", **case)
151
+ self.assertNotEqual(result.returncode, 0)
152
+ self.assertEqual(operations(calls), [])
153
+
154
+ def test_async_backup_not_ready_never_recreates_it_to_poll(self):
155
+ result, calls = run("backup", "on-demand", BACKUP_STATUS="CREATING")
156
+ self.assertNotEqual(result.returncode, 0)
157
+ self.assertEqual(operations(calls).count("create-backup"), 1)
158
+ self.assertEqual(operations(calls).count("describe-backup"), 1)
159
+ self.assertNotIn("restore-table-from-backup", operations(calls))
160
+
161
+
162
+ if __name__ == "__main__":
163
+ unittest.main(verbosity=2)
@@ -0,0 +1,185 @@
1
+ #!/usr/bin/env python3
2
+ """Execute documentation snippets with a fake AWS binary; lint actual variants.
3
+
4
+ Requires PyYAML and cfn-lint. No network, credentials or real AWS CLI calls.
5
+ These tests establish syntax/request structure, not service acceptance or semantics.
6
+ """
7
+ import copy
8
+ import json
9
+ import os
10
+ from pathlib import Path
11
+ import re
12
+ import subprocess
13
+ import tempfile
14
+ import unittest
15
+
16
+ import yaml
17
+
18
+ ROOT = Path(__file__).resolve().parents[1]
19
+ KEY_ARN = "arn:aws:kms:us-east-1:111122223333:key/00000000-0000-4000-8000-000000000000"
20
+ FAKE_AWS = '''#!/usr/bin/env python3
21
+ import json,os,sys
22
+ args=sys.argv[1:]
23
+ with open(os.environ["CALL_LOG"],"a") as f: f.write(json.dumps(args)+"\\n")
24
+ service=next(v for v in args if v in ("sts","dynamodb","kms"))
25
+ action=args[args.index(service)+1]
26
+ if service=="dynamodb" and action=="query":
27
+ print(json.dumps({"Items":[],"LastEvaluatedKey":{"PK":{"S":"TENANT#acme#CUSTOMER#c42"},"SK":{"S":"ORDER#next"}}}))
28
+ else: print("{}")
29
+ '''
30
+
31
+
32
+ class CfnLoader(yaml.SafeLoader):
33
+ pass
34
+
35
+
36
+ CfnLoader.add_constructor("!Ref", lambda loader, node: {"Ref": loader.construct_scalar(node)})
37
+ CfnLoader.add_constructor("!GetAtt", lambda loader, node: {"Fn::GetAtt": loader.construct_scalar(node).split(".")})
38
+
39
+
40
+ def blocks(name, language):
41
+ text = (ROOT / "references" / name).read_text()
42
+ return re.findall(r"```" + language + r"\n(.*?)\n```", text, re.S)
43
+
44
+
45
+ def flag(args, name):
46
+ return args[args.index(name) + 1]
47
+
48
+
49
+ def service_action(args):
50
+ service = next(v for v in args if v in ("sts", "dynamodb", "kms"))
51
+ return service, args[args.index(service) + 1]
52
+
53
+
54
+ def run_reference(name, missing=None):
55
+ with tempfile.TemporaryDirectory(prefix="dynamodb-docs-") as directory:
56
+ root = Path(directory)
57
+ (root / "aws").write_text(FAKE_AWS)
58
+ (root / "aws").chmod(0o700)
59
+ (root / "assets").symlink_to(ROOT / "assets", target_is_directory=True)
60
+ env = {"PATH": f"{root}:{os.environ['PATH']}", "AWS_PROFILE": "offline-only",
61
+ "AWS_REGION": "us-east-1", "TABLE_NAME": "OfflineOrders",
62
+ "LSI_TABLE_NAME": "OfflineOrdersWithLSI", "KMS_KEY_ARN": KEY_ARN,
63
+ "CALL_LOG": str(root / "calls.jsonl")}
64
+ if missing:
65
+ env.pop(missing)
66
+ # All alternatives are executed ONLY against mocks to inspect argv.
67
+ result = subprocess.run(["bash", "-c", "\n".join(blocks(name, "bash"))],
68
+ cwd=root, env=env, text=True, capture_output=True, timeout=15)
69
+ log = root / "calls.jsonl"
70
+ calls = [json.loads(s) for s in log.read_text().splitlines()] if log.exists() else []
71
+ return result, calls
72
+
73
+
74
+ class CommandsTests(unittest.TestCase):
75
+ def test_all_bash_snippets_parse_and_are_targeted(self):
76
+ for document in ("commands/aws-cli.md", "encryption.md"):
77
+ with self.subTest(document=document):
78
+ syntax = subprocess.run(["bash", "-n"], input="\n".join(blocks(document, "bash")),
79
+ text=True, capture_output=True)
80
+ self.assertEqual(syntax.returncode, 0, syntax.stderr)
81
+ result, calls = run_reference(document)
82
+ self.assertEqual(result.returncode, 0, result.stderr)
83
+ self.assertTrue(calls)
84
+ for args in calls:
85
+ self.assertEqual(flag(args, "--profile"), "offline-only")
86
+ self.assertEqual(flag(args, "--region"), "us-east-1")
87
+ self.assertIn("--no-cli-pager", args)
88
+ self.assertNotIn("--no-verify-ssl", args)
89
+ if service_action(args)[0] == "dynamodb":
90
+ self.assertIn(flag(args, "--table-name"),
91
+ {"OfflineOrders", "OfflineOrdersWithLSI"})
92
+ for option in ("--key", "--item", "--expression-attribute-values",
93
+ "--expression-attribute-names", "--global-secondary-index-updates",
94
+ "--exclusive-start-key"):
95
+ if option in args:
96
+ json.loads(flag(args, option))
97
+
98
+ def test_missing_target_stops_before_any_aws_call(self):
99
+ for document in ("commands/aws-cli.md", "encryption.md"):
100
+ for name in ("AWS_PROFILE", "AWS_REGION", "TABLE_NAME"):
101
+ with self.subTest(document=document, missing=name):
102
+ result, calls = run_reference(document, missing=name)
103
+ self.assertNotEqual(result.returncode, 0)
104
+ self.assertEqual(calls, [])
105
+
106
+ def test_crud_and_pagination_request_invariants(self):
107
+ result, calls = run_reference("commands/aws-cli.md")
108
+ self.assertEqual(result.returncode, 0, result.stderr)
109
+ queries = [a for a in calls if service_action(a) == ("dynamodb", "query")]
110
+ self.assertEqual(len(queries), 4) # base, base continuation, GSI, LSI
111
+ for args in queries:
112
+ self.assertIn("--no-paginate", args)
113
+ self.assertIn("--exclusive-start-key", queries[1])
114
+ self.assertEqual(json.loads(flag(queries[1], "--exclusive-start-key"))["SK"], {"S": "ORDER#next"})
115
+ for args in queries:
116
+ if "--index-name" in args:
117
+ index = flag(args, "--index-name")
118
+ self.assertIn("--consistent-read" if index == "LSI1" else "--no-consistent-read", args)
119
+ for args in calls:
120
+ if service_action(args)[1] in {"put-item", "update-item", "delete-item"}:
121
+ self.assertIn("--condition-expression", args)
122
+ if "--key" in args:
123
+ self.assertEqual(set(json.loads(flag(args, "--key"))), {"PK", "SK"})
124
+ if service_action(args)[1] == "update-item":
125
+ self.assertIn("REMOVE GSI1PK, GSI1SK", flag(args, "--update-expression"))
126
+
127
+ def test_lsi_is_new_table_only_and_retains_default_schema(self):
128
+ default = json.loads((ROOT / "assets/create-table.json").read_text())
129
+ alternative = json.loads((ROOT / "assets/create-table-with-lsi.json").read_text())
130
+ stripped = copy.deepcopy(alternative)
131
+ lsi = stripped.pop("LocalSecondaryIndexes")
132
+ self.assertEqual(stripped["AttributeDefinitions"].pop(),
133
+ {"AttributeName": "LSI1SK", "AttributeType": "S"})
134
+ self.assertEqual(stripped, default)
135
+ self.assertEqual(lsi[0]["KeySchema"], [
136
+ {"AttributeName": "PK", "KeyType": "HASH"},
137
+ {"AttributeName": "LSI1SK", "KeyType": "RANGE"}])
138
+ _, calls = run_reference("commands/aws-cli.md")
139
+ for args in calls:
140
+ if service_action(args)[1] == "update-table":
141
+ self.assertNotIn("--local-secondary-indexes", args)
142
+ updates = json.loads(flag(args, "--global-secondary-index-updates"))
143
+ self.assertEqual(updates[0]["Create"]["IndexName"], "GSI2")
144
+
145
+ def test_encryption_cli_variants_and_no_dangerous_key_lifecycle(self):
146
+ result, calls = run_reference("encryption.md")
147
+ self.assertEqual(result.returncode, 0, result.stderr)
148
+ creates = [a for a in calls if service_action(a)[1] == "create-table"]
149
+ self.assertEqual(len(creates), 3)
150
+ self.assertNotIn("--sse-specification", creates[0])
151
+ self.assertEqual(flag(creates[1], "--sse-specification"), "Enabled=true,SSEType=KMS")
152
+ self.assertEqual(flag(creates[2], "--sse-specification"),
153
+ "Enabled=true,SSEType=KMS,KMSMasterKeyId=" + KEY_ARN)
154
+ forbidden = {"disable-key", "schedule-key-deletion", "create-key", "put-key-policy"}
155
+ self.assertFalse(forbidden & {service_action(a)[1] for a in calls})
156
+
157
+ def test_actual_cfn_and_cli_variants_lint(self):
158
+ template = yaml.load((ROOT / "assets/table.cfn.yaml").read_text(), Loader=CfnLoader)
159
+ variants = []
160
+ encryption = [yaml.load(b, Loader=CfnLoader) for b in blocks("encryption.md", "yaml")]
161
+ specifications = [b["SSESpecification"] for b in encryption if "SSESpecification" in b]
162
+ self.assertEqual(specifications, [
163
+ {"SSEEnabled": False}, {"SSEEnabled": True, "SSEType": "KMS"},
164
+ {"SSEEnabled": True, "SSEType": "KMS", "KMSMasterKeyId": {"Ref": "KmsKeyArn"}}])
165
+ for spec in specifications:
166
+ variant = copy.deepcopy(template)
167
+ variant["Resources"]["OrdersTable"]["Properties"]["SSESpecification"] = spec
168
+ if "KMSMasterKeyId" in spec:
169
+ for item in encryption:
170
+ variant.setdefault("Parameters", {}).update(item.get("Parameters", {}))
171
+ variants.append(variant)
172
+ lsi = json.loads((ROOT / "assets/create-table-with-lsi.json").read_text())
173
+ variants.append({"Resources": {"Orders": {"Type": "AWS::DynamoDB::Table", "Properties": lsi}}})
174
+ fragment = yaml.safe_load(blocks("lsi-vs-gsi.md", "yaml")[0])
175
+ self.assertEqual(fragment["LocalSecondaryIndexes"], lsi["LocalSecondaryIndexes"])
176
+ with tempfile.TemporaryDirectory(prefix="dynamodb-cfn-") as directory:
177
+ for number, variant in enumerate(variants):
178
+ path = Path(directory) / f"variant-{number}.json"
179
+ path.write_text(json.dumps(variant))
180
+ result = subprocess.run(["cfn-lint", str(path)], capture_output=True, text=True, timeout=30)
181
+ self.assertEqual(result.returncode, 0, result.stdout + result.stderr)
182
+
183
+
184
+ if __name__ == "__main__":
185
+ unittest.main(verbosity=2)
@@ -0,0 +1,99 @@
1
+ #!/usr/bin/env python3
2
+ """Exercise the shell example against a fake aws executable; never calls AWS."""
3
+ import json
4
+ import os
5
+ from pathlib import Path
6
+ import subprocess
7
+ import tempfile
8
+ import unittest
9
+
10
+ SCRIPT = Path(__file__).resolve().parents[1] / "assets/create-table.sh"
11
+ FAKE_AWS = '''#!/usr/bin/env python3
12
+ import json, os, sys
13
+ args = sys.argv[1:]
14
+ with open(os.environ["CALL_LOG"], "a") as log:
15
+ log.write(json.dumps(args) + "\\n")
16
+ service = next(word for word in args if word in ("sts", "dynamodb"))
17
+ action = args[args.index(service) + 1]
18
+ if action == os.environ.get("FAIL_ACTION"):
19
+ sys.exit(42)
20
+ if service == "sts":
21
+ print("000000000000" if "--query" in args else '{"Account":"000000000000","Arn":"offline-role"}')
22
+ else:
23
+ print("{}")
24
+ '''
25
+
26
+
27
+ class ShellExampleTests(unittest.TestCase):
28
+ def run_script(self, *, account="000000000000", confirmation="CREATE OfflineTable",
29
+ fail="", missing=""):
30
+ with tempfile.TemporaryDirectory(prefix="dynamodb-example-") as temp:
31
+ root = Path(temp)
32
+ fake = root / "aws"
33
+ fake.write_text(FAKE_AWS)
34
+ fake.chmod(0o700)
35
+ env = {
36
+ "PATH": f"{temp}:{os.environ['PATH']}",
37
+ "AWS_PROFILE": "offline-only", "AWS_REGION": "us-east-1",
38
+ "TABLE_NAME": "OfflineTable", "EXPECTED_ACCOUNT_ID": account,
39
+ "CALL_LOG": str(root / "calls.jsonl"), "FAIL_ACTION": fail,
40
+ }
41
+ if missing:
42
+ env.pop(missing)
43
+ result = subprocess.run(["bash", str(SCRIPT)], input=confirmation + "\n",
44
+ text=True, capture_output=True, env=env, timeout=10)
45
+ log = root / "calls.jsonl"
46
+ calls = [json.loads(line) for line in log.read_text().splitlines()] if log.exists() else []
47
+ for call in calls:
48
+ self.assertIn("--profile", call)
49
+ self.assertIn("--region", call)
50
+ actions = []
51
+ for call in calls:
52
+ service = next(word for word in call if word in ("sts", "dynamodb"))
53
+ actions.append(call[call.index(service) + 1])
54
+ return result, calls, actions
55
+
56
+ def test_missing_explicit_target_stops_before_any_call(self):
57
+ for variable in ("AWS_PROFILE", "AWS_REGION", "TABLE_NAME", "EXPECTED_ACCOUNT_ID"):
58
+ with self.subTest(variable=variable):
59
+ result, _, actions = self.run_script(missing=variable)
60
+ self.assertNotEqual(result.returncode, 0)
61
+ self.assertEqual(actions, [])
62
+
63
+ def test_wrong_account_stops_before_create(self):
64
+ result, _, actions = self.run_script(account="111111111111")
65
+ self.assertNotEqual(result.returncode, 0)
66
+ self.assertEqual(actions, ["get-caller-identity", "get-caller-identity"])
67
+ self.assertIn("Account mismatch", result.stderr)
68
+
69
+ def test_refused_confirmation_stops_before_create(self):
70
+ result, _, actions = self.run_script(confirmation="no")
71
+ self.assertNotEqual(result.returncode, 0)
72
+ self.assertNotIn("create-table", actions)
73
+
74
+ def test_success_orders_create_wait_config_and_readback(self):
75
+ result, calls, actions = self.run_script()
76
+ self.assertEqual(result.returncode, 0, result.stderr)
77
+ self.assertEqual(actions, [
78
+ "get-caller-identity", "get-caller-identity", "create-table", "wait",
79
+ "update-time-to-live", "update-continuous-backups", "describe-table",
80
+ "describe-time-to-live", "describe-continuous-backups"])
81
+ self.assertIn("table-exists", calls[3])
82
+ self.assertTrue(any(arg.endswith("create-table.json") for arg in calls[2]))
83
+
84
+ def test_existing_or_failed_create_is_not_adopted(self):
85
+ result, _, actions = self.run_script(fail="create-table")
86
+ self.assertEqual(result.returncode, 42)
87
+ self.assertEqual(actions[-1], "create-table")
88
+ self.assertNotIn("update-time-to-live", actions)
89
+
90
+ def test_partial_configuration_failure_does_not_delete_or_continue(self):
91
+ result, _, actions = self.run_script(fail="update-time-to-live")
92
+ self.assertEqual(result.returncode, 42)
93
+ self.assertEqual(actions[-1], "update-time-to-live")
94
+ self.assertNotIn("delete-table", actions)
95
+ self.assertNotIn("update-continuous-backups", actions)
96
+
97
+
98
+ if __name__ == "__main__":
99
+ unittest.main(verbosity=2)