@raishin/vanguard-frontier-agentic 3.19.0 → 3.20.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 (459) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +8 -1
  3. package/.cursor-plugin/plugin.json +8 -1
  4. package/.github/plugin/marketplace.json +1 -1
  5. package/README.md +21 -21
  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/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
  18. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
  19. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
  20. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
  21. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
  22. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
  23. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
  24. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
  25. package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
  26. package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
  27. package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
  28. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
  29. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
  30. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
  31. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
  32. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
  33. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  34. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  35. package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
  36. package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
  37. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
  38. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
  39. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
  40. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
  41. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
  42. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  43. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  44. package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
  45. package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
  46. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
  47. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
  48. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
  49. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
  50. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
  51. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  52. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  53. package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
  54. package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
  55. package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
  56. package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
  57. package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
  58. package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
  59. package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
  60. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  61. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  62. package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
  63. package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
  64. package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
  65. package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
  66. package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
  67. package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
  68. package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
  69. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  70. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  71. package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
  72. package/catalog/agents.json +204 -1
  73. package/catalog/asset-integrity.json +601 -61
  74. package/catalog/install-roles.json +19 -1
  75. package/catalog/model-assignments.json +231 -0
  76. package/catalog/skill-manifest.json +1603 -56
  77. package/catalog/skills.json +314 -14
  78. package/package.json +7 -2
  79. package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
  80. package/powers/vanguard-alibaba/POWER.md +1 -1
  81. package/powers/vanguard-aws/POWER.md +1 -1
  82. package/powers/vanguard-azure/POWER.md +1 -1
  83. package/powers/vanguard-gcp/POWER.md +1 -1
  84. package/powers/vanguard-huawei/POWER.md +1 -1
  85. package/powers/vanguard-oci/POWER.md +1 -1
  86. package/skills/alibaba/README.md +2 -1
  87. package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
  88. package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
  89. package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
  90. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
  91. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
  92. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
  93. package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
  94. package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
  95. package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
  96. package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
  97. package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
  98. package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
  99. package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
  100. package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
  101. package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
  102. package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
  103. package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
  104. package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
  105. package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
  106. package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
  107. package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
  108. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
  109. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
  110. package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
  111. package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
  112. package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
  113. package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
  114. package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
  115. package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
  116. package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
  117. package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
  118. package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
  119. package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
  120. package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
  121. package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
  122. package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
  123. package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
  124. package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
  125. package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
  126. package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
  127. package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
  128. package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
  129. package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
  130. package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
  131. package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
  132. package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
  133. package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
  134. package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
  135. package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
  136. package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
  137. package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
  138. package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
  139. package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
  140. package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
  141. package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
  142. package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
  143. package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
  144. package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
  145. package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
  146. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
  147. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
  148. package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
  149. package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
  150. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
  151. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
  152. package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
  153. package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
  154. package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
  155. package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
  156. package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
  157. package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
  158. package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
  159. package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
  160. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
  161. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
  162. package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
  163. package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
  164. package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
  165. package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
  166. package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
  167. package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
  168. package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
  169. package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
  170. package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
  171. package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
  172. package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
  173. package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
  174. package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
  175. package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
  176. package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
  177. package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
  178. package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
  179. package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
  180. package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
  181. package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
  182. package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
  183. package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
  184. package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
  185. package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
  186. package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
  187. package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
  188. package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
  189. package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
  190. package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
  191. package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
  192. package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
  193. package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
  194. package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
  195. package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
  196. package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
  197. package/skills/aws/aws-maestro/SKILL.md +1 -1
  198. package/skills/aws/aws-maestro/metadata.json +1 -1
  199. package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
  200. package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +4 -2
  201. package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
  202. package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
  203. package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
  204. package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
  205. package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
  206. package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
  207. package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
  208. package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
  209. package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
  210. package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
  211. package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
  212. package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
  213. package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
  214. package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
  215. package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
  216. package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
  217. package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
  218. package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
  219. package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
  220. package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
  221. package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
  222. package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
  223. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
  224. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
  225. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
  226. package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
  227. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
  228. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
  229. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
  230. package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
  231. package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
  232. package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
  233. package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
  234. package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
  235. package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
  236. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
  237. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
  238. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
  239. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
  240. package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
  241. package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
  242. package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
  243. package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
  244. package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
  245. package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
  246. package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
  247. package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
  248. package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
  249. package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
  250. package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
  251. package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
  252. package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
  253. package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
  254. package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
  255. package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
  256. package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
  257. package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
  258. package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
  259. package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
  260. package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
  261. package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +6 -2
  262. package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
  263. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
  264. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
  265. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
  266. package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
  267. package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
  268. package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
  269. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
  270. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
  271. package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
  272. package/skills/azure/azure-maestro/SKILL.md +1 -0
  273. package/skills/gcp/README.md +2 -1
  274. package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
  275. package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
  276. package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
  277. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
  278. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
  279. package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
  280. package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
  281. package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
  282. package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
  283. package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
  284. package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
  285. package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
  286. package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
  287. package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
  288. package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
  289. package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
  290. package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
  291. package/skills/gcp/gcp-maestro/SKILL.md +2 -1
  292. package/skills/huawei/README.md +2 -1
  293. package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
  294. package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
  295. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
  296. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
  297. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
  298. package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
  299. package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
  300. package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
  301. package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
  302. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
  303. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
  304. package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
  305. package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
  306. package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
  307. package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
  308. package/skills/huawei/huawei-maestro/SKILL.md +2 -1
  309. package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
  310. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
  311. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
  312. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
  313. package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
  314. package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
  315. package/skills/oci/README.md +6 -1
  316. package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
  317. package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
  318. package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
  319. package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
  320. package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
  321. package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
  322. package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
  323. package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
  324. package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
  325. package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
  326. package/skills/oci/oci-nosql-pattern/README.md +81 -0
  327. package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
  328. package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
  329. package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
  330. package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
  331. package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
  332. package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
  333. package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
  334. package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
  335. package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
  336. package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
  337. package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
  338. package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
  339. package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
  340. package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
  341. package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
  342. package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
  343. package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
  344. package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
  345. package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
  346. package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
  347. package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
  348. package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
  349. package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
  350. package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
  351. package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
  352. package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
  353. package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
  354. package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
  355. package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
  356. package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
  357. package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
  358. package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
  359. package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
  360. package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
  361. package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
  362. package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
  363. package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
  364. package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
  365. package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
  366. package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
  367. package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
  368. package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
  369. package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
  370. package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
  371. package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
  372. package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
  373. package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
  374. package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
  375. package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
  376. package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
  377. package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
  378. package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
  379. package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
  380. package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
  381. package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
  382. package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
  383. package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
  384. package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
  385. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
  386. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
  387. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
  388. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
  389. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
  390. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
  391. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
  392. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
  393. package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
  394. package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
  395. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
  396. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
  397. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
  398. package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
  399. package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
  400. package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
  401. package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
  402. package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
  403. package/templates/nosql-audit-template.md +127 -0
  404. package/templates/nosql-operations-template.md +60 -0
  405. package/tests/_generate_maestro_routing_fixtures.py +11 -0
  406. package/tests/fixtures/README.md +2 -2
  407. package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
  408. package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
  409. package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
  410. package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
  411. package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
  412. package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
  413. package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
  414. package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
  415. package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
  416. package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
  417. package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
  418. package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
  419. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
  420. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
  421. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
  422. package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
  423. package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
  424. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
  425. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
  426. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
  427. package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
  428. package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
  429. package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
  430. package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
  431. package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
  432. package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
  433. package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
  434. package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
  435. package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
  436. package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
  437. package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
  438. package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
  439. package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
  440. package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
  441. package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
  442. package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
  443. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
  444. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
  445. package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
  446. package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
  447. package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
  448. package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
  449. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
  450. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
  451. package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
  452. package/tests/requirements-ci.txt +8 -0
  453. package/tests/validate-aws-skill-quality.py +7 -0
  454. package/tests/validate-nosql-audit.py +741 -0
  455. package/tests/validate-nosql-operations.py +136 -0
  456. package/tests/validate-nosql-pattern-evals.py +96 -0
  457. package/tests/validate-nosql-scenarios.py +94 -0
  458. package/tests/validate-skill-manifest.py +6 -1
  459. package/tests/validate-skill-references.py +225 -0
@@ -0,0 +1,11 @@
1
+ {
2
+ "Version": "2012-10-17",
3
+ "Statement": [
4
+ {
5
+ "Sid": "ReadNamedStreamIncarnation",
6
+ "Effect": "Allow",
7
+ "Action": ["dynamodb:DescribeStream", "dynamodb:GetShardIterator", "dynamodb:GetRecords"],
8
+ "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/Orders/stream/2026-11-08T00:00:00.000"
9
+ }
10
+ ]
11
+ }
@@ -0,0 +1,20 @@
1
+ {
2
+ "Version": "2012-10-17",
3
+ "Statement": [
4
+ {
5
+ "Sid": "ReadItemsOnNamedTable",
6
+ "Effect": "Allow",
7
+ "Action": ["dynamodb:GetItem", "dynamodb:BatchGetItem"],
8
+ "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/Orders"
9
+ },
10
+ {
11
+ "Sid": "QueryNamedTableAndIndex",
12
+ "Effect": "Allow",
13
+ "Action": ["dynamodb:Query"],
14
+ "Resource": [
15
+ "arn:aws:dynamodb:us-east-1:111122223333:table/Orders",
16
+ "arn:aws:dynamodb:us-east-1:111122223333:table/Orders/index/GSI1"
17
+ ]
18
+ }
19
+ ]
20
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "Version": "2012-10-17",
3
+ "Statement": [
4
+ {
5
+ "Sid": "NamedExternalRoleReadItems",
6
+ "Effect": "Allow",
7
+ "Principal": {"AWS": "arn:aws:iam::444455556666:role/DynamoReader"},
8
+ "Action": ["dynamodb:GetItem"],
9
+ "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/Orders"
10
+ },
11
+ {
12
+ "Sid": "NamedExternalRoleQuery",
13
+ "Effect": "Allow",
14
+ "Principal": {"AWS": "arn:aws:iam::444455556666:role/DynamoReader"},
15
+ "Action": ["dynamodb:Query"],
16
+ "Resource": [
17
+ "arn:aws:dynamodb:us-east-1:111122223333:table/Orders",
18
+ "arn:aws:dynamodb:us-east-1:111122223333:table/Orders/index/GSI1"
19
+ ]
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,55 @@
1
+ AWSTemplateFormatVersion: '2010-09-09'
2
+ Description: Example customer-orders table with a sparse tenant open-order index
3
+ Parameters:
4
+ TableName:
5
+ Type: String
6
+ MinLength: 3
7
+ MaxLength: 255
8
+ AllowedPattern: '[A-Za-z0-9_.-]+'
9
+ Resources:
10
+ OrdersTable:
11
+ Type: AWS::DynamoDB::Table
12
+ DeletionPolicy: Retain
13
+ UpdateReplacePolicy: Retain
14
+ Properties:
15
+ TableName: !Ref TableName
16
+ BillingMode: PAY_PER_REQUEST
17
+ DeletionProtectionEnabled: true
18
+ AttributeDefinitions:
19
+ - AttributeName: PK
20
+ AttributeType: S
21
+ - AttributeName: SK
22
+ AttributeType: S
23
+ - AttributeName: GSI1PK
24
+ AttributeType: S
25
+ - AttributeName: GSI1SK
26
+ AttributeType: S
27
+ KeySchema:
28
+ - AttributeName: PK
29
+ KeyType: HASH
30
+ - AttributeName: SK
31
+ KeyType: RANGE
32
+ GlobalSecondaryIndexes:
33
+ - IndexName: GSI1
34
+ KeySchema:
35
+ - AttributeName: GSI1PK
36
+ KeyType: HASH
37
+ - AttributeName: GSI1SK
38
+ KeyType: RANGE
39
+ Projection:
40
+ ProjectionType: INCLUDE
41
+ NonKeyAttributes:
42
+ - status
43
+ - orderId
44
+ - totalMinor
45
+ - currency
46
+ TimeToLiveSpecification:
47
+ AttributeName: expiresAt
48
+ Enabled: true
49
+ PointInTimeRecoverySpecification:
50
+ PointInTimeRecoveryEnabled: true
51
+ Outputs:
52
+ TableName:
53
+ Value: !Ref OrdersTable
54
+ TableArn:
55
+ Value: !GetAtt OrdersTable.Arn
@@ -0,0 +1,15 @@
1
+ {
2
+ "PK": {"S": "doc#1"},
3
+ "Tenant": {"S": "example"},
4
+ "Status": {"S": "PUBLISHED"},
5
+ "Title": {"S": "Synthetic three-dimensional example"},
6
+ "Price": {"N": "12.50"},
7
+ "Content": {"B": "SGVsbG8="},
8
+ "Active": {"BOOL": true},
9
+ "DeletedAt": {"NULL": true},
10
+ "Embedding": {"L": [{"N": "0.1"}, {"N": "0.2"}, {"N": "0.3"}]},
11
+ "Metadata": {"M": {"source": {"S": "fixture"}}},
12
+ "Labels": {"SS": ["aws", "example"]},
13
+ "Scores": {"NS": ["1", "2"]},
14
+ "Chunks": {"BS": ["AQI=", "AwQ="]}
15
+ }
@@ -0,0 +1,23 @@
1
+ {
2
+ "BillingMode": "PAY_PER_REQUEST",
3
+ "DeletionProtectionEnabled": true,
4
+ "AttributeDefinitions": [
5
+ {"AttributeName": "PK", "AttributeType": "S"},
6
+ {"AttributeName": "Tenant", "AttributeType": "S"},
7
+ {"AttributeName": "Status", "AttributeType": "S"}
8
+ ],
9
+ "KeySchema": [{"AttributeName": "PK", "KeyType": "HASH"}],
10
+ "VectorIndexes": [
11
+ {
12
+ "IndexName": "EmbeddingIndex",
13
+ "VectorAttribute": {"AttributeName": "Embedding"},
14
+ "Dimensions": 3,
15
+ "DistanceFunction": "COSINE",
16
+ "SearchSchema": [
17
+ {"AttributeName": "Tenant", "SearchSchemaElementType": "HASH"},
18
+ {"AttributeName": "Status", "SearchSchemaElementType": "INLINE_FILTER"}
19
+ ],
20
+ "Projection": {"ProjectionType": "INCLUDE", "NonKeyAttributes": ["Title"]}
21
+ }
22
+ ]
23
+ }
@@ -0,0 +1,11 @@
1
+ {
2
+ "Version": "2012-10-17",
3
+ "Statement": [
4
+ {
5
+ "Sid": "SearchOneVectorIndex",
6
+ "Effect": "Allow",
7
+ "Action": "dynamodb:SearchVectors",
8
+ "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/VectorDocuments/index/EmbeddingIndex"
9
+ }
10
+ ]
11
+ }
@@ -0,0 +1,10 @@
1
+ {
2
+ "TableName": "REPLACE_WITH_APPROVED_VECTOR_TABLE",
3
+ "IndexName": "EmbeddingIndex",
4
+ "SearchVector": [{"N": "0.1"}, {"N": "0.2"}, {"N": "0.3"}],
5
+ "TopK": 10,
6
+ "SearchConditionExpression": "#tenant = :tenant AND #status = :status",
7
+ "ExpressionAttributeNames": {"#tenant": "Tenant", "#status": "Status"},
8
+ "ExpressionAttributeValues": {":tenant": {"S": "example"}, ":status": {"S": "PUBLISHED"}},
9
+ "ReturnConsumedCapacity": "INDEXES"
10
+ }
@@ -0,0 +1,41 @@
1
+ AWSTemplateFormatVersion: '2010-09-09'
2
+ Description: Optional three-dimensional native-vector demonstration, not a production model
3
+ Parameters:
4
+ TableName:
5
+ Type: String
6
+ MinLength: 3
7
+ MaxLength: 255
8
+ AllowedPattern: '[A-Za-z0-9_.-]+'
9
+ Resources:
10
+ VectorDocuments:
11
+ Type: AWS::DynamoDB::Table
12
+ DeletionPolicy: Retain
13
+ UpdateReplacePolicy: Retain
14
+ Properties:
15
+ TableName: !Ref TableName
16
+ BillingMode: PAY_PER_REQUEST
17
+ DeletionProtectionEnabled: true
18
+ AttributeDefinitions:
19
+ - AttributeName: PK
20
+ AttributeType: S
21
+ - AttributeName: Tenant
22
+ AttributeType: S
23
+ - AttributeName: Status
24
+ AttributeType: S
25
+ KeySchema:
26
+ - AttributeName: PK
27
+ KeyType: HASH
28
+ VectorIndexes:
29
+ - IndexName: EmbeddingIndex
30
+ VectorAttribute:
31
+ AttributeName: Embedding
32
+ Dimensions: 3
33
+ DistanceFunction: COSINE
34
+ SearchSchema:
35
+ - AttributeName: Tenant
36
+ SearchSchemaElementType: HASH
37
+ - AttributeName: Status
38
+ SearchSchemaElementType: INLINE_FILTER
39
+ Projection:
40
+ ProjectionType: INCLUDE
41
+ NonKeyAttributes: [Title]
@@ -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)