@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,195 @@
1
+ #!/usr/bin/env python3
2
+ """Offline command routing checks; never audit AWS or run a load test."""
3
+ import ast
4
+ import importlib.util
5
+ import json
6
+ from pathlib import Path
7
+ import subprocess
8
+ import sys
9
+ import unittest
10
+ from unittest.mock import patch
11
+
12
+ sys.dont_write_bytecode = True
13
+ ROOT = Path(__file__).resolve().parents[1]
14
+ SCRIPT = ROOT / "scripts/select_mode.py"
15
+ spec = importlib.util.spec_from_file_location("modes", SCRIPT)
16
+ modes = importlib.util.module_from_spec(spec)
17
+ spec.loader.exec_module(modes)
18
+
19
+
20
+ def cli(*args):
21
+ return subprocess.run([sys.executable, str(SCRIPT), *args], text=True,
22
+ capture_output=True, timeout=5)
23
+
24
+
25
+ class ModeTests(unittest.TestCase):
26
+ def test_real_help_and_json_command_inventory(self):
27
+ result = cli("--help")
28
+ self.assertEqual(result.returncode, 0, result.stderr)
29
+ self.assertIn("performance-test", result.stdout)
30
+ result = cli("help")
31
+ self.assertEqual(result.returncode, 0, result.stderr)
32
+ data = json.loads(result.stdout)
33
+ self.assertEqual(data["execution"], "none")
34
+ self.assertEqual(data["commands"], ["select", "design", "refactor", "backup", "restore", "audit", "performance-test", "feature-plan"])
35
+
36
+ def test_select_is_scoped_deduplicated_and_stateless(self):
37
+ plan = modes.build_plan(["select", "--features", "encryption,iam,encryption"])
38
+ self.assertEqual(plan["selected_features"], ["encryption", "iam"])
39
+ self.assertEqual(plan["read"], ["references/commands/select.md", "references/encryption.md", "references/iam-and-access.md"])
40
+ self.assertEqual(modes.build_plan(["select"])["selected_features"], ["core"])
41
+ self.assertEqual(plan["execution"], "none")
42
+
43
+ def test_audit_defaults_to_repo_and_never_claims_findings(self):
44
+ plan = modes.build_plan(["audit", "--features", "iam,tags"])
45
+ self.assertEqual(plan["evidence"], "repo")
46
+ self.assertEqual(plan["read"], ["references/commands/audit.md", "references/commands/audit/offline.md", "references/iam-and-access.md"])
47
+ self.assertNotIn("findings", plan)
48
+ live = modes.build_plan(["audit", "--evidence", "live-metadata"])
49
+ self.assertEqual(live["execution"], "none")
50
+ self.assertTrue(live["live_read_approval_required"])
51
+
52
+ def test_performance_produces_bounded_plan_not_measurements(self):
53
+ plan = modes.build_plan(["performance-test", "--features", "vectors",
54
+ "--environment", "nonproduction", "--duration-seconds", "45",
55
+ "--max-requests", "500", "--max-concurrency", "3"])
56
+ self.assertEqual(plan["limits"], {"duration_seconds": 45, "max_requests": 500,
57
+ "max_concurrency": 3})
58
+ self.assertEqual(plan["read"], ["references/commands/performance-test.md", "references/data-types-and-vectors.md"])
59
+ self.assertTrue(plan["run_approval_required"])
60
+ self.assertEqual(plan["execution"], "none")
61
+ self.assertNotIn("latency", plan)
62
+
63
+ def test_feature_plan_is_not_activation_and_rejects_incompatible_actions(self):
64
+ plan = modes.build_plan(["feature-plan", "--features", "pitr,streams", "--action", "enable"])
65
+ self.assertEqual(plan["action"], "enable")
66
+ self.assertEqual(plan["execution"], "none")
67
+ self.assertTrue(plan["change_approval_required"])
68
+ self.assertIn("references/commands/feature-plan.md", plan["read"])
69
+ self.assertEqual(modes.build_plan(["feature-plan", "--features", "encryption",
70
+ "--action", "configure"])["action"], "configure")
71
+ for args in [["feature-plan", "--features", "encryption", "--action", "disable"],
72
+ ["feature-plan", "--features", "core", "--action", "enable"],
73
+ ["feature-plan", "--features", "pitr,encryption", "--action", "enable"]]:
74
+ self.assertEqual(cli(*args).returncode, 2)
75
+
76
+ def test_invalid_modes_features_and_unbounded_inputs_fail_closed(self):
77
+ for args in [["execute"], ["select", "--features", "unknown"],
78
+ ["select", "--features", "pitr,,streams"],
79
+ ["performance-test", "--environment", "production"],
80
+ ["performance-test", "--max-requests", "0"],
81
+ ["performance-test", "--duration-seconds", "-1"],
82
+ ["performance-test", "--max-concurrency", "infinite"],
83
+ ["audit", "--execute"], ["feature-plan", "--action", "enable"]]:
84
+ with self.subTest(args=args):
85
+ result = cli(*args)
86
+ self.assertEqual(result.returncode, 2)
87
+ self.assertFalse(result.stdout)
88
+
89
+ def test_router_does_not_open_references_write_or_run_external_work(self):
90
+ with patch("builtins.open", side_effect=AssertionError("No file reads/writes")), \
91
+ patch.object(Path, "read_text", side_effect=AssertionError("No eager loading")), \
92
+ patch("subprocess.run", side_effect=AssertionError("No subprocess")):
93
+ plan = modes.build_plan(["audit", "--features", "vectors,encryption"])
94
+ self.assertEqual(plan["execution"], "none")
95
+ imports = {node.names[0].name for node in ast.walk(ast.parse(SCRIPT.read_text()))
96
+ if isinstance(node, ast.Import)}
97
+ self.assertEqual(imports, {"argparse", "json", "sys"})
98
+
99
+ def test_every_feature_routes_to_existing_lazy_resources(self):
100
+ for feature in modes.FEATURES:
101
+ plan = modes.build_plan(["select", "--features", feature])
102
+ for relative in plan["read"]:
103
+ self.assertTrue(relative.startswith("references/"))
104
+ self.assertTrue((ROOT / relative).is_file(), relative)
105
+ entry = (ROOT / "SKILL.md").read_text()
106
+ self.assertIn("references/commands/audit.md", entry)
107
+ self.assertIn("Do not recursively load", entry)
108
+ self.assertNotIn("SuccessfulRequestLatency", entry)
109
+
110
+ def test_slash_invocation_matches_real_cli_and_bare_prefix_shows_help(self):
111
+ args = ["audit", "--mode", "live", "--features", "iam"]
112
+ self.assertEqual(modes.build_plan(["/aws-dynamodb-patterns", *args]), modes.build_plan(args))
113
+ result = cli("/aws-dynamodb-patterns", *args)
114
+ self.assertEqual(result.returncode, 0, result.stderr)
115
+ self.assertEqual(json.loads(result.stdout)["audit_mode"], "live")
116
+ self.assertEqual(modes.build_plan(["/aws-dynamodb-patterns"])["read"], ["references/commands/help.md"])
117
+
118
+ def test_offline_and_live_routes_are_mutually_exclusive_and_legacy_flags_work(self):
119
+ for mode, legacy in [("offline", "repo"), ("live", "live-metadata")]:
120
+ with self.subTest(mode=mode):
121
+ plan = modes.build_plan(["audit", "--mode", mode, "--features", "encryption"])
122
+ self.assertEqual(plan, modes.build_plan(["audit", "--evidence", legacy, "--features", "encryption"]))
123
+ self.assertIn(f"references/commands/audit/{mode}.md", plan["read"])
124
+ other = "live" if mode == "offline" else "offline"
125
+ self.assertNotIn(f"references/commands/audit/{other}.md", plan["read"])
126
+ self.assertEqual(plan["live_read_approval_required"], mode == "live")
127
+ self.assertEqual(modes.build_plan(["audit"])["audit_mode"], "offline")
128
+
129
+ def test_conflicting_audit_flags_and_wrong_prefix_fail_closed(self):
130
+ for args in [["audit", "--mode", "live", "--evidence", "repo"],
131
+ ["audit", "--mode", "automatic"], ["/other-skill", "audit"]]:
132
+ result = cli(*args)
133
+ self.assertEqual(result.returncode, 2)
134
+ self.assertFalse(result.stdout)
135
+
136
+ def test_commands_are_separate_files_not_a_flat_or_combined_workflow(self):
137
+ folder = ROOT / "references/commands"
138
+ for name in ["README", "help", "select", "audit", "performance-test", "feature-plan", "aws-cli", "embedding"]:
139
+ self.assertTrue((folder / f"{name}.md").is_file(), name)
140
+ for name in ["modes", "audit", "performance-testing", "feature-plans", "commands", "embedding-commands"]:
141
+ self.assertFalse((ROOT / "references" / f"{name}.md").exists(), name)
142
+ self.assertLess(len((folder / "README.md").read_text().splitlines()), 50)
143
+
144
+ def test_design_and_refactor_have_separate_lazy_routes_and_core_defaults(self):
145
+ for command in ["design", "refactor"]:
146
+ with self.subTest(command=command):
147
+ expected = [f"references/commands/{command}.md", "references/modeling.md", "references/runtime-contract.md"]
148
+ plan = modes.build_plan([command])
149
+ self.assertEqual(plan["read"], expected)
150
+ self.assertEqual(plan["selected_features"], ["core"])
151
+ self.assertEqual(plan["execution"], "none")
152
+ result = cli("/aws-dynamodb-patterns", command, "--features", "indexes,encryption")
153
+ self.assertEqual(result.returncode, 0, result.stderr)
154
+ routed = json.loads(result.stdout)
155
+ self.assertEqual(routed["read"], [f"references/commands/{command}.md",
156
+ "references/lsi-vs-gsi.md", "references/encryption.md"])
157
+ self.assertNotIn("references/workflow.md", routed["read"])
158
+ for flag in ["--execute", "--apply", "--mode"]:
159
+ self.assertEqual(cli(command, flag).returncode, 2)
160
+
161
+ def test_design_and_refactor_are_documented_and_do_not_alias_activation(self):
162
+ entry = (ROOT / "SKILL.md").read_text()
163
+ readme = (ROOT / "README.md").read_text()
164
+ help_doc = (ROOT / "references/commands/help.md").read_text()
165
+ for command in ["design", "refactor"]:
166
+ self.assertIn(f"references/commands/{command}.md", entry)
167
+ self.assertIn(f"/aws-dynamodb-patterns {command} --features", readme)
168
+ self.assertIn(command, help_doc)
169
+ self.assertTrue((ROOT / f"references/commands/{command}.md").is_file())
170
+
171
+ def test_backup_restore_default_to_pitr_and_support_explicit_on_demand(self):
172
+ for command in ["backup", "restore"]:
173
+ with self.subTest(command=command):
174
+ plan = modes.build_plan([command])
175
+ self.assertEqual(plan["method"], "pitr")
176
+ self.assertEqual(plan["selected_features"], ["pitr"])
177
+ self.assertEqual(plan["read"], [f"references/commands/{command}.md",
178
+ "references/commands/recovery-target.md",
179
+ f"references/commands/{command}/pitr.md"])
180
+ self.assertTrue(plan["change_approval_required"])
181
+ self.assertEqual(plan["execution"], "none")
182
+ result = cli("/aws-dynamodb-patterns", command, "--method", "on-demand")
183
+ self.assertEqual(result.returncode, 0, result.stderr)
184
+ self.assertEqual(json.loads(result.stdout)["method"], "on-demand")
185
+ self.assertNotIn(f"references/commands/{command}/pitr.md", json.loads(result.stdout)["read"])
186
+ self.assertNotIn("references/recovery-and-replicas.md", json.loads(result.stdout)["read"])
187
+ self.assertNotIn("references/recovery-and-replicas.md", plan["read"])
188
+ for flags in [["--execute"], ["--method", "unknown"]]:
189
+ self.assertEqual(cli(command, *flags).returncode, 2)
190
+ self.assertEqual(modes.build_plan(["restore"])["target_policy"], "new-table-only")
191
+ self.assertIn("references/recovery-and-replicas.md", modes.build_plan(["select", "--features", "pitr"])["read"])
192
+
193
+
194
+ if __name__ == "__main__":
195
+ unittest.main(verbosity=2)
@@ -0,0 +1,288 @@
1
+ #!/usr/bin/env python3
2
+ """Offline tests for domain command argv and the shipped illustrative policies.
3
+
4
+ The policy checker encodes this package's narrow example contracts, NOT arbitrary
5
+ IAM evaluation. Passing it is not Access Analyzer, simulation or runtime proof.
6
+ Fake CLI execution never uses the real AWS binary, credentials or network.
7
+ """
8
+ import copy
9
+ import json
10
+ import os
11
+ from pathlib import Path
12
+ import re
13
+ import subprocess
14
+ import tempfile
15
+ import unittest
16
+
17
+ ROOT = Path(__file__).resolve().parents[1]
18
+ DOCS = ["iam-and-access.md", "streams-and-dax.md", "recovery-and-replicas.md", "monitoring.md"]
19
+ TABLE = "arn:aws:dynamodb:us-east-1:111122223333:table/Orders"
20
+ INDEX = TABLE + "/index/GSI1"
21
+ STREAM = TABLE + "/stream/2026-11-08T00:00:00.000"
22
+ PRINCIPAL = "arn:aws:iam::444455556666:role/DynamoReader"
23
+ SERVICES = {"sts", "iam", "accessanalyzer", "dynamodb", "dynamodbstreams", "dax", "lambda", "cloudwatch"}
24
+ FAKE = '''#!/usr/bin/env python3
25
+ import json,os,sys
26
+ with open(os.environ["CALL_LOG"],"a") as f: f.write(json.dumps(sys.argv[1:])+"\\n")
27
+ if "Table.GlobalSecondaryIndexes" in sys.argv:
28
+ print(os.environ.get("FAKE_INDEXES",'[{"IndexName":"OrdersByStatus","IndexStatus":"ACTIVE"}]'))
29
+ else: print("{}")
30
+ '''
31
+
32
+
33
+ def blocks(name):
34
+ return re.findall(r"```bash\n(.*?)\n```", (ROOT / "references" / name).read_text(), re.S)
35
+
36
+
37
+ def flag(args, key):
38
+ return args[args.index(key) + 1]
39
+
40
+
41
+ def values(args, key):
42
+ result = []
43
+ for value in args[args.index(key) + 1:]:
44
+ if value.startswith("--"):
45
+ break
46
+ result.append(value)
47
+ return result
48
+
49
+
50
+ def operation(args):
51
+ service = next(value for value in args if value in SERVICES)
52
+ return service, args[args.index(service) + 1]
53
+
54
+
55
+ def run_doc(name, missing=None, overrides=None):
56
+ with tempfile.TemporaryDirectory(prefix="ddb-operations-") as directory:
57
+ root = Path(directory)
58
+ (root / "aws").write_text(FAKE)
59
+ (root / "aws").chmod(0o700)
60
+ (root / "assets").symlink_to(ROOT / "assets", target_is_directory=True)
61
+ env = {
62
+ "PATH": f"{root}:{os.environ['PATH']}", "AWS_PROFILE": "offline-only",
63
+ "AWS_REGION": "us-east-1", "TABLE_NAME": "Orders", "TABLE_ARN": TABLE,
64
+ "STREAM_ARN": STREAM, "SHARD_ID": "shardId-offline", "SHARD_ITERATOR": "offline-iterator",
65
+ "FUNCTION_NAME": "offline-consumer", "DAX_CLUSTER_NAME": "offline-dax",
66
+ "DAX_NODE_TYPE": "dax.r5.large", "DAX_SUBNET_GROUP": "offline-subnets",
67
+ "DAX_SECURITY_GROUP_ID": "sg-00000000", "DAX_ROLE_ARN": "arn:aws:iam::111122223333:role/DaxService",
68
+ "RESTORE_TABLE_NAME": "OrdersRecovered", "REPLICA_REGION": "eu-west-1",
69
+ "IDENTITY_POLICY_FILE": "assets/table-index-read-policy.json",
70
+ "RESOURCE_POLICY_FILE": "assets/table-resource-policy.json", "EXPECTED_REVISION_ID": "observed-r1",
71
+ "METRIC_START_UTC": "2026-11-08T00:00:00Z", "METRIC_END_UTC": "2026-11-08T01:00:00Z",
72
+ "ALARM_NAME": "offline-gsi-throttles", "SNS_TOPIC_ARN": "arn:aws:sns:us-east-1:111122223333:OfflineAlerts",
73
+ "GSI_NAME": "OrdersByStatus",
74
+ "CALL_LOG": str(root / "calls.jsonl"),
75
+ }
76
+ env.update(overrides or {})
77
+ if missing:
78
+ env.pop(missing)
79
+ result = subprocess.run(["bash", "-c", "\n".join(blocks(name))],
80
+ cwd=root, env=env, text=True, capture_output=True, timeout=20)
81
+ log = root / "calls.jsonl"
82
+ calls = [json.loads(line) for line in log.read_text().splitlines()] if log.exists() else []
83
+ return result, calls
84
+
85
+
86
+ def as_list(value):
87
+ return value if isinstance(value, list) else [value]
88
+
89
+
90
+ def check_policy(policy, kind):
91
+ """The three deliberately read-only example shapes, not a general IAM validator."""
92
+ assert policy["Version"] == "2012-10-17"
93
+ found_index = False
94
+ for statement in policy["Statement"]:
95
+ assert statement["Effect"] == "Allow"
96
+ actions = set(as_list(statement["Action"]))
97
+ resources = set(as_list(statement["Resource"]))
98
+ assert all("*" not in a for a in actions)
99
+ assert all("*" not in r for r in resources)
100
+ if kind == "stream":
101
+ assert actions <= {"dynamodb:DescribeStream", "dynamodb:GetShardIterator", "dynamodb:GetRecords"}
102
+ assert resources == {STREAM}
103
+ assert "Principal" not in statement
104
+ else:
105
+ assert actions <= {"dynamodb:GetItem", "dynamodb:BatchGetItem", "dynamodb:Query"}
106
+ assert resources <= {TABLE, INDEX} and resources
107
+ if INDEX in resources:
108
+ assert actions == {"dynamodb:Query"} and TABLE in resources
109
+ found_index = True
110
+ if kind == "resource":
111
+ assert statement["Principal"] == {"AWS": PRINCIPAL}
112
+ assert "dynamodb:BatchGetItem" not in actions
113
+ else:
114
+ assert "Principal" not in statement
115
+ assert actions
116
+ if kind != "stream":
117
+ assert found_index, "The shipped example promises Query on the named index"
118
+
119
+
120
+ class OperationsTests(unittest.TestCase):
121
+ @classmethod
122
+ def setUpClass(cls):
123
+ cls.runs = {name: run_doc(name) for name in DOCS}
124
+
125
+ def test_domain_snippets_syntax_and_explicit_targets(self):
126
+ for name, (result, calls) in self.runs.items():
127
+ with self.subTest(document=name):
128
+ syntax = subprocess.run(["bash", "-n"], input="\n".join(blocks(name)),
129
+ text=True, capture_output=True)
130
+ self.assertEqual(syntax.returncode, 0, syntax.stderr)
131
+ self.assertEqual(result.returncode, 0, result.stderr)
132
+ self.assertTrue(calls)
133
+ for args in calls:
134
+ self.assertEqual(flag(args, "--profile"), "offline-only")
135
+ self.assertIn(flag(args, "--region"), {"us-east-1", "eu-west-1"})
136
+ self.assertIn("--no-cli-pager", args)
137
+ self.assertNotIn("--no-verify-ssl", args)
138
+ self.assertNotIn("--confirm-remove-self-resource-access", args)
139
+
140
+ def test_missing_core_target_fails_before_service_call(self):
141
+ for name in DOCS:
142
+ for variable in ("AWS_PROFILE", "AWS_REGION", "TABLE_NAME"):
143
+ with self.subTest(document=name, missing=variable):
144
+ result, calls = run_doc(name, missing=variable)
145
+ self.assertNotEqual(result.returncode, 0)
146
+ self.assertEqual(calls, [])
147
+
148
+ def test_iam_tags_and_resource_policy_group_arguments(self):
149
+ calls = self.runs["iam-and-access.md"][1]
150
+ actions = {operation(args) for args in calls}
151
+ self.assertIn(("accessanalyzer", "validate-policy"), actions)
152
+ self.assertIn(("iam", "simulate-custom-policy"), actions)
153
+ tagged = set()
154
+ for args in calls:
155
+ service, action = operation(args)
156
+ if action in {"tag-resource", "untag-resource", "list-tags-of-resource"}:
157
+ self.assertIn(flag(args, "--resource-arn"), {TABLE, STREAM})
158
+ if action == "tag-resource":
159
+ tagged.add(flag(args, "--resource-arn"))
160
+ if action == "put-resource-policy":
161
+ self.assertEqual(flag(args, "--resource-arn"), TABLE)
162
+ self.assertEqual(flag(args, "--expected-revision-id"), "observed-r1")
163
+ self.assertEqual(flag(args, "--policy"), "file://assets/table-resource-policy.json")
164
+ if service == "iam":
165
+ json.loads(flag(args, "--policy-input-list"))
166
+ self.assertEqual(set(values(args, "--resource-arns")), {TABLE, INDEX})
167
+ self.assertEqual(tagged, {TABLE, STREAM})
168
+
169
+ def test_stream_and_dax_groups_preserve_distinct_protocol_and_role(self):
170
+ calls = self.runs["streams-and-dax.md"][1]
171
+ for args in calls:
172
+ service, action = operation(args)
173
+ if service == "dynamodbstreams" and action != "get-records":
174
+ self.assertEqual(flag(args, "--stream-arn"), STREAM)
175
+ if action == "get-shard-iterator":
176
+ self.assertEqual(flag(args, "--shard-iterator-type"), "TRIM_HORIZON")
177
+ if action == "get-records":
178
+ self.assertEqual(flag(args, "--limit"), "25")
179
+ if service == "dax" and action == "create-cluster":
180
+ self.assertEqual(flag(args, "--replication-factor"), "3")
181
+ self.assertEqual(flag(args, "--cluster-endpoint-encryption-type"), "TLS")
182
+ self.assertEqual(flag(args, "--sse-specification"), "Enabled=true")
183
+ self.assertIn("--iam-role-arn", args)
184
+ self.assertIn("--security-group-ids", args)
185
+ self.assertIn(("lambda", "list-event-source-mappings"), {operation(a) for a in calls})
186
+
187
+ def test_pitr_and_replica_requests_have_safe_targets(self):
188
+ calls = self.runs["recovery-and-replicas.md"][1]
189
+ actions = {operation(a)[1] for a in calls}
190
+ self.assertNotIn("create-global-table", actions)
191
+ self.assertNotIn("update-global-table", actions)
192
+ for args in calls:
193
+ action = operation(args)[1]
194
+ if action == "restore-table-to-point-in-time":
195
+ self.assertNotEqual(flag(args, "--source-table-name"), flag(args, "--target-table-name"))
196
+ self.assertIn("--use-latest-restorable-time", args)
197
+ self.assertNotIn("--restore-date-time", args)
198
+ if action == "update-table":
199
+ self.assertEqual(flag(args, "--region"), "us-east-1")
200
+ self.assertEqual(json.loads(flag(args, "--replica-updates")),
201
+ [{"Create": {"RegionName": "eu-west-1"}}])
202
+ self.assertTrue(any(flag(a, "--region") == "eu-west-1" for a in calls))
203
+
204
+ def test_unsafe_restore_or_replica_target_is_rejected(self):
205
+ result, calls = run_doc("recovery-and-replicas.md", overrides={"RESTORE_TABLE_NAME": "Orders"})
206
+ self.assertEqual(result.returncode, 64)
207
+ self.assertNotIn("restore-table-to-point-in-time", {operation(a)[1] for a in calls})
208
+ result, calls = run_doc("recovery-and-replicas.md", overrides={"REPLICA_REGION": "us-east-1"})
209
+ self.assertEqual(result.returncode, 64)
210
+ self.assertFalse(any("--replica-updates" in a for a in calls))
211
+
212
+ def test_metrics_and_alarm_match_dimension_and_statistic_contract(self):
213
+ calls = self.runs["monitoring.md"][1]
214
+ metric_names = set()
215
+ for args in calls:
216
+ if "--metric-name" not in args:
217
+ continue
218
+ metric = flag(args, "--metric-name")
219
+ metric_names.add(metric)
220
+ dimensions = {v.split(",")[0].split("=", 1)[1]: v.split("Value=", 1)[1]
221
+ for v in values(args, "--dimensions")}
222
+ if metric in {"SuccessfulRequestLatency", "SystemErrors"}:
223
+ self.assertEqual(set(dimensions), {"TableName", "Operation"})
224
+ if metric == "WriteThrottleEvents":
225
+ self.assertEqual(set(dimensions), {"TableName", "GlobalSecondaryIndexName"})
226
+ self.assertEqual(dimensions["GlobalSecondaryIndexName"], "OrdersByStatus")
227
+ if metric == "ReplicationLatency":
228
+ self.assertEqual(set(dimensions), {"TableName", "ReceivingRegion"})
229
+ if metric == "IteratorAge":
230
+ self.assertEqual(flag(args, "--namespace"), "AWS/Lambda")
231
+ self.assertEqual(flag(args, "--statistics"), "Maximum")
232
+ if metric == "ItemCacheHits":
233
+ self.assertEqual(flag(args, "--namespace"), "AWS/DAX")
234
+ self.assertEqual(set(dimensions), {"ClusterId"})
235
+ if operation(args)[1] == "put-metric-alarm":
236
+ self.assertIn("--alarm-actions", args)
237
+ self.assertIn("--actions-enabled", args)
238
+ self.assertEqual(flag(args, "--treat-missing-data"), "ignore")
239
+ self.assertEqual(flag(args, "--statistic"), "Sum")
240
+ self.assertLessEqual({"ReadThrottleEvents", "WriteThrottleEvents", "SuccessfulRequestLatency",
241
+ "SystemErrors", "ReplicationLatency", "IteratorAge", "ItemCacheHits"}, metric_names)
242
+
243
+ def test_wrong_or_inactive_index_stops_before_metric_or_alarm_calls(self):
244
+ for response in ["[]", "null", '[{"IndexName":"Other","IndexStatus":"ACTIVE"}]',
245
+ '[{"IndexName":"OrdersByStatus","IndexStatus":"CREATING"}]']:
246
+ with self.subTest(response=response):
247
+ result, calls = run_doc("monitoring.md", overrides={"FAKE_INDEXES": response})
248
+ self.assertNotEqual(result.returncode, 0)
249
+ self.assertEqual({operation(args)[0] for args in calls}, {"dynamodb"})
250
+ result, calls = run_doc("monitoring.md", missing="GSI_NAME")
251
+ self.assertNotEqual(result.returncode, 0)
252
+ self.assertEqual(calls, [])
253
+
254
+ def test_shipped_policy_contracts(self):
255
+ for name, kind in [("table-index-read-policy.json", "identity"),
256
+ ("stream-read-policy.json", "stream"),
257
+ ("table-resource-policy.json", "resource")]:
258
+ check_policy(json.loads((ROOT / "assets" / name).read_text()), kind)
259
+
260
+ def test_policy_negative_fixtures(self):
261
+ identity = json.loads((ROOT / "assets/table-index-read-policy.json").read_text())
262
+ stream = json.loads((ROOT / "assets/stream-read-policy.json").read_text())
263
+ resource = json.loads((ROOT / "assets/table-resource-policy.json").read_text())
264
+ fixtures = []
265
+ for field, value in [("Resource", "*"), ("Resource", INDEX),
266
+ ("Action", ["dynamodb:TransactWriteItems"]),
267
+ ("Action", ["dynamodb:ExecuteStatement"])]:
268
+ bad = copy.deepcopy(identity)
269
+ bad["Statement"][0][field] = value
270
+ fixtures.append((bad, "identity"))
271
+ bad = copy.deepcopy(identity)
272
+ bad["Statement"][1]["Resource"] = [TABLE]
273
+ fixtures.append((bad, "identity"))
274
+ for field, value in [("Resource", TABLE), ("Action", ["dynamodbstreams:GetRecords"])]:
275
+ bad = copy.deepcopy(stream)
276
+ bad["Statement"][0][field] = value
277
+ fixtures.append((bad, "stream"))
278
+ bad = copy.deepcopy(resource)
279
+ bad["Statement"][0]["Principal"] = "*"
280
+ fixtures.append((bad, "resource"))
281
+ for number, (policy, kind) in enumerate(fixtures):
282
+ with self.subTest(fixture=number):
283
+ with self.assertRaises(AssertionError):
284
+ check_policy(policy, kind)
285
+
286
+
287
+ if __name__ == "__main__":
288
+ unittest.main(verbosity=2)
@@ -0,0 +1,156 @@
1
+ import test from "node:test";
2
+ import assert from "node:assert/strict";
3
+ import { matchingPage, queryPages } from "../assets/query-pages.mjs";
4
+
5
+ const input = {
6
+ TableName: "OfflineOnly",
7
+ KeyConditionExpression: "#pk = :pk",
8
+ ExpressionAttributeNames: { "#pk": "PK" },
9
+ ExpressionAttributeValues: { ":pk": { S: "TENANT#test" } },
10
+ Limit: 50,
11
+ };
12
+ const key = { PK: { S: "TENANT#test" }, SK: { S: "ORDER#1" } };
13
+
14
+ async function collect(generator) {
15
+ const pages = [];
16
+ for await (const page of generator) pages.push(page);
17
+ return pages;
18
+ }
19
+
20
+ test("empty filtered page continues using the exact typed key", async () => {
21
+ const original = structuredClone(input);
22
+ const calls = [];
23
+ const responses = [
24
+ { Items: [], LastEvaluatedKey: key },
25
+ { Items: [{ SK: { S: "ORDER#2" } }], LastEvaluatedKey: {} },
26
+ ];
27
+ const pages = await collect(queryPages(async request => {
28
+ calls.push(request);
29
+ return responses[calls.length - 1];
30
+ }, input));
31
+ assert.equal(pages.length, 2);
32
+ assert.equal(pages[1].Items[0].SK.S, "ORDER#2");
33
+ assert.equal(calls[1].ExclusiveStartKey, key);
34
+ assert.equal("ExclusiveStartKey" in calls[0], false);
35
+ assert.deepEqual(input, original);
36
+ assert.equal(calls[1].Limit, 50);
37
+ assert.equal(calls[1].KeyConditionExpression, input.KeyConditionExpression);
38
+ });
39
+
40
+ for (const terminal of [undefined, null, {}]) {
41
+ test(`absent/null/empty terminal cursor ends (${JSON.stringify(terminal)})`, async () => {
42
+ let calls = 0;
43
+ const pages = await collect(queryPages(async () => {
44
+ calls += 1;
45
+ return { Items: [], LastEvaluatedKey: terminal };
46
+ }, input));
47
+ assert.equal(calls, 1);
48
+ assert.equal(pages.length, 1);
49
+ });
50
+ }
51
+
52
+ test("nonempty initial cursor is forwarded without rewriting numbers/binary", async () => {
53
+ const cursor = { PK: { N: "9007199254740993" }, SK: { B: new Uint8Array([1, 2]) } };
54
+ await collect(queryPages(async request => {
55
+ assert.equal(request.ExclusiveStartKey, cursor);
56
+ return {};
57
+ }, { ...input, ExclusiveStartKey: cursor }));
58
+ });
59
+
60
+ test("empty initial cursor is omitted", async () => {
61
+ await collect(queryPages(async request => {
62
+ assert.equal("ExclusiveStartKey" in request, false);
63
+ return {};
64
+ }, { ...input, ExclusiveStartKey: {} }));
65
+ });
66
+
67
+ test("page budget reports incompleteness and makes no extra call", async () => {
68
+ let calls = 0;
69
+ await assert.rejects(collect(queryPages(async () => {
70
+ calls += 1;
71
+ return { Items: [], LastEvaluatedKey: key };
72
+ }, input, { maxPages: 2 })), /budget exhausted.*incomplete/);
73
+ assert.equal(calls, 2);
74
+ });
75
+
76
+ test("invalid budgets fail before any SDK call", async () => {
77
+ for (const maxPages of [0, -1, 1.5, NaN, Infinity]) {
78
+ await assert.rejects(collect(queryPages(async () => {
79
+ assert.fail("must not query");
80
+ }, input, { maxPages })), RangeError);
81
+ }
82
+ });
83
+
84
+ test("SDK errors propagate; helper does not silently retry unknown outcomes", async () => {
85
+ const error = new Error("timeout");
86
+ let calls = 0;
87
+ await assert.rejects(collect(queryPages(async () => {
88
+ calls += 1;
89
+ throw error;
90
+ }, input)), failure => failure === error);
91
+ assert.equal(calls, 1);
92
+ });
93
+
94
+ test("caller break stops lazy pagination without another SDK request", async () => {
95
+ let calls = 0;
96
+ for await (const page of queryPages(async () => {
97
+ calls += 1;
98
+ return { Items: [], LastEvaluatedKey: key };
99
+ }, input)) {
100
+ assert.ok(page.LastEvaluatedKey);
101
+ break;
102
+ }
103
+ assert.equal(calls, 1);
104
+ });
105
+
106
+ test("match page uses remaining count, preserving surplus candidates for next page", async () => {
107
+ const all = Array.from({ length: 80 }, (_, n) => ({ id: n }));
108
+ const limits = [];
109
+ // First call evaluates 50 but only 40 match; later calls match every item.
110
+ const query = async request => {
111
+ limits.push(request.Limit);
112
+ const start = request.ExclusiveStartKey?.offset ?? 0;
113
+ const end = Math.min(start + request.Limit, all.length);
114
+ return {
115
+ Items: all.slice(start, end).filter(item => item.id >= 10),
116
+ LastEvaluatedKey: end < all.length ? { offset: end } : {},
117
+ };
118
+ };
119
+ const first = await matchingPage(query, input);
120
+ assert.deepEqual(limits, [50, 10]);
121
+ assert.equal(first.Items.length, 50);
122
+ assert.deepEqual(first.LastEvaluatedKey, { offset: 60 });
123
+ const second = await matchingPage(query, { ...input, ExclusiveStartKey: first.LastEvaluatedKey });
124
+ assert.equal(second.Items.length, 20);
125
+ const returnedIds = [...first.Items, ...second.Items].map(item => item.id);
126
+ assert.deepEqual(returnedIds, all.slice(10).map(item => item.id));
127
+ });
128
+
129
+ test("match page continues after empty page and returns budget cursor", async () => {
130
+ let calls = 0;
131
+ const response = await matchingPage(async () => {
132
+ calls += 1;
133
+ return { Items: [], LastEvaluatedKey: key };
134
+ }, input, { maxPages: 2 });
135
+ assert.equal(calls, 2);
136
+ assert.deepEqual(response.Items, []);
137
+ assert.equal(response.LastEvaluatedKey, key);
138
+ assert.equal(response.WorkBudgetExhausted, true);
139
+ });
140
+
141
+ test("match page handles absent/empty final keys without leaving stale input cursor", async () => {
142
+ for (const terminal of [undefined, {}]) {
143
+ const response = await matchingPage(async request => {
144
+ assert.equal("ExclusiveStartKey" in request, false);
145
+ return { Items: [{ id: 1 }], LastEvaluatedKey: terminal };
146
+ }, { ...input, ExclusiveStartKey: {} });
147
+ assert.deepEqual(response, { Items: [{ id: 1 }] });
148
+ }
149
+ });
150
+
151
+ test("match page rejects invalid work bounds before querying", async () => {
152
+ for (const options of [{ target: 0 }, { target: 1.5 }, { maxPages: -1 }]) {
153
+ await assert.rejects(matchingPage(async () => assert.fail(), input, options), RangeError);
154
+ }
155
+ await assert.rejects(matchingPage(async () => assert.fail(), { ...input, Limit: 0 }), RangeError);
156
+ });