@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
@@ -4,8 +4,8 @@ description: Use this skill for Azure Cosmos DB platform operations and design r
4
4
  allowed-tools: Read Grep Glob
5
5
  metadata:
6
6
  author: "github: VincentChuWaiChow"
7
- version: 0.1.3
8
- updated: "2026-06-05"
7
+ version: 0.1.4
8
+ updated: "2026-11-08"
9
9
  category: platform
10
10
  ---
11
11
 
@@ -44,7 +44,11 @@ Do not use this skill as a substitute for:
44
44
  Load these only when needed:
45
45
 
46
46
  - [Operations guide](references/cosmosdb-platform-operations.md) — use for service-specific pitfalls, design rules, verification targets, and pushback criteria.
47
+ - [Consistency, capacity and data-plane security](references/consistency-capacity-security.md) — use for the five consistency levels, session tokens, request-level overrides, integrated cache, serverless vs provisioned vs autoscale, logical-partition limits, and Entra ID data-plane vs control-plane RBAC.
48
+ - [Evidence ledger](references/evidence-ledger.md) — use when a claim must be traced to its Microsoft Learn source; cite its `[COSMOS-Exx]` IDs for material service claims.
47
49
  - [MCP and evidence path](references/mcp-and-evidence.md) — use when choosing documentation-based evidence, sampled read-only Azure evidence, or sanitized user evidence.
50
+ - [Operations: NoSQL API](references/operations.md), [MongoDB API](references/operations-mongodb.md), [Cassandra API](references/operations-cassandra.md) — per-API backup and restore, disaster recovery, billing dimensions, monitoring, performance, IAM, tagging, encryption, network isolation and audit logging; load only the API in question.
51
+ - [Audit](references/commands/audit.md) — offline or live audit against the operations reference; load only when an audit is requested.
48
52
  - [Safety checklist](references/safety-checklist.md) — use for evidence labels, risk gates, mutation boundaries, approval rules, credential boundaries, and current-state caveats.
49
53
  - [Workflow and output contract](references/workflow-and-output.md) — use when executing the full review, applying stress checks, or formatting the final answer.
50
54
  - [Official sources](references/official-sources.md) — use when you need the detailed Microsoft documentation list or source notes.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "id": "azure-cosmosdb-platform-operator",
3
3
  "name": "Azure Cosmos DB Platform Operator",
4
- "version": "0.1.3",
4
+ "version": "0.1.4",
5
5
  "type": "skill",
6
6
  "provider": "azure",
7
7
  "harnesses": [
@@ -24,10 +24,13 @@
24
24
  "https://learn.microsoft.com/en-us/azure/cosmos-db/hierarchical-partition-keys",
25
25
  "https://learn.microsoft.com/en-us/azure/reliability/reliability-cosmos-db",
26
26
  "https://learn.microsoft.com/en-us/azure/cosmos-db/hierarchical-partition-keys-unlimited-scale",
27
- "https://learn.microsoft.com/en-us/azure/cosmos-db/failover-considerations-for-private-endpoints"
27
+ "https://learn.microsoft.com/en-us/azure/cosmos-db/failover-considerations-for-private-endpoints",
28
+ "https://learn.microsoft.com/en-us/azure/cosmos-db/integrated-cache",
29
+ "https://learn.microsoft.com/en-us/azure/cosmos-db/throughput-serverless",
30
+ "https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-connect-role-based-access-control"
28
31
  ],
29
32
  "security_notes": "Do not approve a partition key, indexing posture, consistency change, or cross-partition query strategy without checking workload shape, RU impact, transactional scope, and least-privilege access implications.",
30
- "last_verified": "2026-06-05",
33
+ "last_verified": "2026-11-08",
31
34
  "path": "skills/azure/azure-cosmosdb-platform-operator",
32
35
  "author": "github: VincentChuWaiChow"
33
36
  }
@@ -0,0 +1,180 @@
1
+ # audit --mode live
2
+
3
+ Commands are examples for an operator holding read-only authorization; the skill
4
+ does not run them. They read control-plane metadata only. Compare results with the
5
+ operations reference for the API in scope:
6
+ [NoSQL](../../operations.md), [MongoDB](../../operations-mongodb.md),
7
+ [Cassandra](../../operations-cassandra.md). Per-API sub-bullets below say which
8
+ commands apply; run only those for the API under audit.
9
+
10
+ ## Before any command
11
+
12
+ - Confirm the approved principal, subscription, tenant, Region and exact account.
13
+ Stop on any mismatch; never switch target to make a command work.
14
+ - Use a read-only role. Write output to a private temp directory (`umask 077`).
15
+ Never print keys, connection strings or customer data; no key or connection
16
+ string command is part of this audit.
17
+ - Control-plane commands only: no data-plane shell, no item, document or row reads.
18
+
19
+ ```bash
20
+ set -euo pipefail
21
+ : "${EXPECTED_SUBSCRIPTION_ID:?Approved subscription ID}" "${COSMOS_RG:?Approved resource group}" \
22
+ "${COSMOS_ACCOUNT:?Approved Cosmos DB account name}" "${COSMOS_LOCATION:?Approved Region}"
23
+ umask 077
24
+ audit_dir=$(mktemp -d)
25
+ az account show --output json > "$audit_dir/identity.json" # [COSMOS-E901]
26
+ jq -e --arg s "$EXPECTED_SUBSCRIPTION_ID" '.id == $s' "$audit_dir/identity.json" > /dev/null \
27
+ || { echo "Subscription mismatch; stop" >&2; exit 1; }
28
+ az cosmosdb show --name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json > "$audit_dir/account.json" # [COSMOS-E902]
29
+ jq -e --arg l "$COSMOS_LOCATION" '(.location|ascii_downcase|gsub(" ";"")) == ($l|ascii_downcase|gsub(" ";""))' \
30
+ "$audit_dir/account.json" > /dev/null || { echo "Region mismatch; stop" >&2; exit 1; } # [COSMOS-E920]
31
+ COSMOS_ACCOUNT_ID=$(jq -r '.id' "$audit_dir/account.json")
32
+ ```
33
+
34
+ The Region check compares the account's `location` with `COSMOS_LOCATION`, ignoring
35
+ case and spaces, so `West US` and `westus` match.
36
+
37
+ The account JSON written above is reused by the sections below with local `jq`.
38
+ Fields absent from it are UNVERIFIED, not off.
39
+
40
+ ## Backup and restore
41
+
42
+ - All APIs: inspect the backup policy and restorable-account metadata of the
43
+ account. Which fields the output carries is not enumerated on the CLI page.
44
+ - NoSQL, MongoDB, Cassandra: the same account-level commands apply; restore
45
+ options per API are in the operations files.
46
+
47
+ ```bash
48
+ jq '.backupPolicy' "$audit_dir/account.json" # [COSMOS-E902]
49
+ az cosmosdb restorable-database-account list --account-name "$COSMOS_ACCOUNT" --output json # [COSMOS-E903]
50
+ ```
51
+
52
+ ## Disaster recovery and replication
53
+
54
+ - All APIs: regions, failover priority, zone redundancy and write-region flags come
55
+ from the account JSON; absent fields are UNVERIFIED.
56
+
57
+ ```bash
58
+ jq '{locations, writeLocations, readLocations, enableAutomaticFailover, enableMultipleWriteLocations}' "$audit_dir/account.json" # [COSMOS-E902]
59
+ az cosmosdb list --resource-group "$COSMOS_RG" --output table # [COSMOS-E902]
60
+ ```
61
+
62
+ ## Cost
63
+
64
+ **No live command:** billing and cost data live in Azure Cost Management and the
65
+ billing APIs, not in the Cosmos DB resource API; the CLI reference pages read
66
+ (`az cosmosdb` and its sql, mongodb and cassandra groups) show no read-only cost
67
+ command. Use the throughput commands in Performance for provisioned RU/s only.
68
+
69
+ ## Monitoring
70
+
71
+ - All APIs: list the metric definitions the account exposes, then read a bounded
72
+ window of aggregated platform metrics. Metric names come from the definitions
73
+ output; the names below are those in the operations reference.
74
+
75
+ ```bash
76
+ account_id="$COSMOS_ACCOUNT_ID"
77
+ az monitor metrics list-definitions --resource "$account_id" --output table # [COSMOS-E908]
78
+ az monitor metrics list --resource "$account_id" --metrics NormalizedRUConsumption --offset 1d --interval PT1H --aggregation Maximum --output json # [COSMOS-E907] [COSMOS-E126] [COSMOS-E921]
79
+ az monitor metrics list --resource "$account_id" --metrics TotalRequests --offset 1d --interval PT1H --aggregation Count --output json # [COSMOS-E907] [COSMOS-E921]
80
+ ```
81
+
82
+ ## Performance
83
+
84
+ - Throughput and key design per API; `throughput show` fails for a container that
85
+ has no dedicated throughput (it may use shared database throughput).
86
+ - NoSQL: set `COSMOS_SQL_DATABASE`, `COSMOS_SQL_CONTAINER`.
87
+ - MongoDB: set `COSMOS_MONGO_DATABASE`, `COSMOS_MONGO_COLLECTION`.
88
+ - Cassandra: set `COSMOS_CASSANDRA_KEYSPACE`, `COSMOS_CASSANDRA_TABLE`.
89
+
90
+ **NoSQL:**
91
+
92
+ ```bash
93
+ : "${COSMOS_SQL_DATABASE:?Approved database}" "${COSMOS_SQL_CONTAINER:?Approved container}"
94
+ az cosmosdb sql database list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output table # [COSMOS-E909]
95
+ az cosmosdb sql container show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_SQL_DATABASE" --name "$COSMOS_SQL_CONTAINER" --output json # [COSMOS-E910]
96
+ az cosmosdb sql container throughput show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_SQL_DATABASE" --name "$COSMOS_SQL_CONTAINER" --output json # [COSMOS-E911]
97
+ ```
98
+
99
+ **MongoDB (RU-based):**
100
+
101
+ ```bash
102
+ : "${COSMOS_MONGO_DATABASE:?Approved database}" "${COSMOS_MONGO_COLLECTION:?Approved collection}"
103
+ az cosmosdb mongodb database list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output table # [COSMOS-E913]
104
+ az cosmosdb mongodb collection show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_MONGO_DATABASE" --name "$COSMOS_MONGO_COLLECTION" --output json # [COSMOS-E914]
105
+ az cosmosdb mongodb collection throughput show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_MONGO_DATABASE" --name "$COSMOS_MONGO_COLLECTION" --output json # [COSMOS-E915]
106
+ ```
107
+
108
+ **Cassandra:**
109
+
110
+ ```bash
111
+ : "${COSMOS_CASSANDRA_KEYSPACE:?Approved keyspace}" "${COSMOS_CASSANDRA_TABLE:?Approved table}"
112
+ az cosmosdb cassandra keyspace list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output table # [COSMOS-E917]
113
+ az cosmosdb cassandra table show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --keyspace-name "$COSMOS_CASSANDRA_KEYSPACE" --name "$COSMOS_CASSANDRA_TABLE" --output json # [COSMOS-E918]
114
+ az cosmosdb cassandra table throughput show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --keyspace-name "$COSMOS_CASSANDRA_KEYSPACE" --name "$COSMOS_CASSANDRA_TABLE" --output json # [COSMOS-E919]
115
+ ```
116
+
117
+ ## IAM
118
+
119
+ - Account flags such as `disableLocalAuth` and `disableKeyBasedMetadataWriteAccess`
120
+ come from the account JSON; absent fields are UNVERIFIED.
121
+ - NoSQL and MongoDB: list data-plane role definitions. Cassandra: the role commands
122
+ found are extension commands; not covered here, so check identity settings from
123
+ the account JSON and the operations file.
124
+
125
+ **All APIs:**
126
+
127
+ ```bash
128
+ jq '{disableLocalAuth, disableKeyBasedMetadataWriteAccess}' "$audit_dir/account.json" # [COSMOS-E902]
129
+ ```
130
+
131
+ **NoSQL:**
132
+
133
+ ```bash
134
+ az cosmosdb sql role definition list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json # [COSMOS-E912]
135
+ ```
136
+
137
+ **MongoDB:**
138
+
139
+ ```bash
140
+ az cosmosdb mongodb role definition list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json # [COSMOS-E916]
141
+ ```
142
+
143
+ ## Tagging
144
+
145
+ - All APIs: tags are on the account resource; inspect the account JSON. Database
146
+ and container tagging is not confirmed in the operations files.
147
+
148
+ ```bash
149
+ jq '{tags}' "$audit_dir/account.json" # [COSMOS-E902]
150
+ ```
151
+
152
+ ## Encryption
153
+
154
+ - All APIs: customer-managed key URI and identity come from the account JSON; the
155
+ key itself is never read. Absent fields are UNVERIFIED.
156
+
157
+ ```bash
158
+ jq '{keyVaultKeyUri, defaultIdentity, minimalTlsVersion}' "$audit_dir/account.json" # [COSMOS-E902]
159
+ ```
160
+
161
+ ## Network isolation
162
+
163
+ - All APIs: public access, IP rules and virtual network rules from the account
164
+ JSON; list virtual network rules and private endpoint connections.
165
+
166
+ ```bash
167
+ jq '{publicNetworkAccess, ipRules, isVirtualNetworkFilterEnabled, virtualNetworkRules}' "$audit_dir/account.json" # [COSMOS-E902]
168
+ az cosmosdb network-rule list --name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json # [COSMOS-E904]
169
+ az network private-endpoint-connection list --id "$COSMOS_ACCOUNT_ID" --output json # [COSMOS-E905]
170
+ ```
171
+
172
+ ## Audit logging
173
+
174
+ - All APIs: list the diagnostic settings on the account and compare the enabled
175
+ categories with the operations file for that API (control plane and API request
176
+ categories).
177
+
178
+ ```bash
179
+ az monitor diagnostic-settings list --resource "$COSMOS_ACCOUNT_ID" --output json # [COSMOS-E906]
180
+ ```
@@ -0,0 +1,160 @@
1
+ # audit --mode offline
2
+
3
+ Inputs are the repository (Bicep, ARM, Terraform, application and client config)
4
+ and sanitized exports supplied by the user. No Azure CLI, network call, credential
5
+ or customer data. Commands are local only (`rg`, `grep`, `jq`, `find`, `git`,
6
+ `terraform show` on a saved plan). Property names follow the ARM
7
+ `Microsoft.DocumentDB/databaseAccounts` template reference; patterns are
8
+ case-insensitive so camelCase and snake_case spellings both match. Compare
9
+ findings with the operations reference for the API in scope:
10
+ [NoSQL](../../operations.md), [MongoDB](../../operations-mongodb.md),
11
+ [Cassandra](../../operations-cassandra.md).
12
+
13
+ ```bash
14
+ : "${REPO:?Approved repository path}"
15
+ cd "$REPO"
16
+ rg -n -i 'Microsoft\.DocumentDB/databaseAccounts' --glob '*.bicep' --glob '*.json' --glob '*.tf'
17
+ ```
18
+
19
+ ## Backup and restore
20
+
21
+ - Check `backupPolicy`: `type` (Periodic or Continuous), `continuousModeProperties`
22
+ tier, and for periodic `backupIntervalInMinutes`, `backupRetentionIntervalInHours`
23
+ and `backupStorageRedundancy`.
24
+ - NoSQL: a continuous account cannot return to periodic, so flag any template that
25
+ flips the type. MongoDB and Cassandra: confirm which backup modes the operations
26
+ file lists for that API before judging.
27
+ - Look for restore settings (`createMode`, `restoreParameters`, `restoreMode`) left
28
+ in a template that is re-applied routinely.
29
+ - Firewall, virtual network, private endpoint and data-plane role settings are not
30
+ restored; look for IaC that recreates them.
31
+
32
+ ```bash
33
+ rg -n -i 'backup.?policy|continuous.?mode|periodic.?mode|backup.?interval|backup.?retention|backup.?storage.?redundancy|create.?mode|restore.?(parameters|mode)' --glob '*.bicep' --glob '*.json' --glob '*.tf'
34
+ ```
35
+
36
+ ## Disaster recovery and replication
37
+
38
+ - Check `locations` entries for `failoverPriority` and `isZoneRedundant` per region,
39
+ `enableAutomaticFailover` and `enableMultipleWriteLocations`.
40
+ - NoSQL: serverless accounts are single-region. MongoDB and Cassandra: check the
41
+ operations file for the multi-region behavior of that API.
42
+ - Check `consistencyPolicy` against the stated RPO needs; Strong is not available
43
+ with multiple write regions in the NoSQL reference.
44
+ - Client code: look for preferred or excluded region settings and retry policy.
45
+
46
+ ```bash
47
+ rg -n -i 'locations|failover.?priority|is.?zone.?redundant|enable.?automatic.?failover|enable.?multiple.?write.?locations|consistency.?policy|default.?consistency|preferred.?regions|excluded.?regions' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
48
+ ```
49
+
50
+ ## Cost
51
+
52
+ - Throughput mode: provisioned, autoscale (maximum throughput) or serverless;
53
+ look for oversized fixed RU/s and for `capacity.totalThroughputLimit`.
54
+ - Features that add billing dimensions per the operations file: extra regions,
55
+ `enableMultipleWriteLocations`, analytical storage, zone redundancy, continuous
56
+ backup tiers, diagnostic export to Log Analytics.
57
+ - Do not write prices or amounts; record dimensions only.
58
+ - NoSQL, MongoDB and Cassandra each list their own meters; use the file for the API
59
+ in scope.
60
+
61
+ ```bash
62
+ rg -n -i 'autoscale|max.?throughput|throughput|total.?throughput.?limit|enable.?analytical.?storage|serverless' --glob '*.bicep' --glob '*.json' --glob '*.tf'
63
+ ```
64
+
65
+ ## Monitoring
66
+
67
+ - Look for alert rules or metric alerts on the account resource (for example on
68
+ `NormalizedRUConsumption` and `TotalRequests`) and who owns them.
69
+ - Check client code and logs for handling of HTTP 429 and retry settings, so
70
+ throttling is visible and not only masked by SDK retries.
71
+ - MongoDB: look for request-charge and 16500 handling; Cassandra: look for
72
+ `OverloadedException` handling. Confirm the exact codes in the operations file.
73
+
74
+ ```bash
75
+ rg -n -i 'NormalizedRUConsumption|TotalRequests|metric.?alert|429|too.?many.?requests|max.?retry|retry.?(policy|options)' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
76
+ ```
77
+
78
+ ## Performance
79
+
80
+ - Partition key choice in container or collection definitions (`partitionKey`,
81
+ shard key, Cassandra partition key); flag keys with low cardinality or skew.
82
+ - Indexing policy (`indexingPolicy`) that indexes everything on write-heavy paths,
83
+ or composite indexes missing for sorted queries (NoSQL).
84
+ - Client singletons and connection mode; cross-partition or unbounded queries in
85
+ hot paths.
86
+ - MongoDB and Cassandra: use the performance section of the operations file for
87
+ API-specific limits.
88
+
89
+ ```bash
90
+ rg -n -i 'partition.?key|shard.?key|indexing.?policy|composite.?indexes|included.?paths|excluded.?paths|cross.?partition|enable.?cross.?partition' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
91
+ ```
92
+
93
+ ## IAM
94
+
95
+ - `disableLocalAuth` set to true where Microsoft Entra ID is the intended data
96
+ access path; flag connection strings or account keys in repository config.
97
+ - `disableKeyBasedMetadataWriteAccess` for control-plane changes.
98
+ - NoSQL data-plane RBAC role definitions and assignments are separate resources
99
+ from Azure RBAC; check their scope and that built-in roles are preferred.
100
+ - MongoDB: native role-based access (`EnableMongoRoleBasedAccessControl` capability
101
+ per the operations file). Cassandra: confirm identity options in its file.
102
+ - The second command looks for account keys and credentialed connection strings; it
103
+ lists files only. Never print the matching line.
104
+
105
+ ```bash
106
+ rg -n -i 'disable.?local.?auth|disable.?key.?based.?metadata.?write.?access|sqlRoleAssignments|sqlRoleDefinitions|role.?definition.?id|principal.?id|EnableMongoRoleBasedAccessControl' --glob '!node_modules' .
107
+ rg -l -i 'AccountEndpoint=|AccountKey=|mongodb(\+srv)?://[^ ]*@' --glob '!node_modules' .
108
+ ```
109
+
110
+ ## Tagging
111
+
112
+ - Check the `tags` object on the account resource for the owner, environment and
113
+ data-classification keys the organization requires.
114
+ - Container and database tagging is not confirmed in the operations file; do not
115
+ report missing tags there as a defect without evidence.
116
+ - Look for Azure Policy definitions or assignments that require tags.
117
+
118
+ ```bash
119
+ rg -n -i '\btags\b' --glob '*.bicep' --glob '*.json' --glob '*.tf'
120
+ ```
121
+
122
+ ## Encryption
123
+
124
+ - Customer-managed key: `keyVaultKeyUri` on the account and `defaultIdentity`;
125
+ the operations file lists the Key Vault prerequisites.
126
+ - `minimalTlsVersion` and client-side TLS settings; flag TLS below the documented
127
+ minimum or certificate validation disabled in client code.
128
+ - Confirm the identity type used for key access per the operations file.
129
+
130
+ ```bash
131
+ rg -n -i 'key.?vault.?key.?uri|default.?identity|minimal.?tls.?version|tls.?version|ssl.?invalid|verify.?cert|trust.?all|insecure.?skip' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
132
+ ```
133
+
134
+ ## Network isolation
135
+
136
+ - `publicNetworkAccess`, `ipRules`, `isVirtualNetworkFilterEnabled`,
137
+ `virtualNetworkRules` and `networkAclBypass`; flag open or wide ranges.
138
+ - Private endpoint resources (`Microsoft.Network/privateEndpoints`) and the group
139
+ id each uses for the API in scope.
140
+ - Private DNS zones linked for the account endpoints; a private endpoint without
141
+ DNS resolution does not isolate clients.
142
+
143
+ ```bash
144
+ rg -n -i 'public.?network.?access|ip.?rules|is.?virtual.?network.?filter.?enabled|virtual.?network.?rules|network.?acl.?bypass|privateEndpoints|private.?link|privatelink\.' --glob '*.bicep' --glob '*.json' --glob '*.tf'
145
+ ```
146
+
147
+ ## Audit logging
148
+
149
+ - A `Microsoft.Insights/diagnosticSettings` resource scoped to the account with the
150
+ log categories the operations file names (control plane and, per API, data-plane
151
+ request categories).
152
+ - Destination (Log Analytics, Storage, Event Hubs) and retention owner. For
153
+ Cassandra, full-text diagnostics can log query parameters (PII); check the
154
+ warning in its operations file.
155
+ - Disabling key-based metadata writes keeps control-plane changes on the audited
156
+ path.
157
+
158
+ ```bash
159
+ rg -n -i 'diagnosticSettings|ControlPlaneRequests|DataPlaneRequests|MongoRequests|CassandraRequests|QueryRuntimeStatistics|log.?analytics|workspace.?id' --glob '*.bicep' --glob '*.json' --glob '*.tf'
160
+ ```
@@ -0,0 +1,26 @@
1
+ # audit
2
+
3
+ Load only for an audit request. Offline is the default. After reading this file,
4
+ load **only** the selected variant: [offline](audit/offline.md) or
5
+ [live](audit/live.md). Do not read both.
6
+
7
+ ## Scope
8
+
9
+ - Name the API (NoSQL, MongoDB RU-based, Cassandra), the account, the resources
10
+ and the selected sections of the operations reference for that API:
11
+ [NoSQL](../operations.md), [MongoDB](../operations-mongodb.md),
12
+ [Cassandra](../operations-cassandra.md). Load only the operations file for the
13
+ API in question; unselected sections and APIs are out of scope.
14
+ - Azure DocumentDB (vCore-based, MongoDB compatible) is a separate service and is
15
+ out of scope.
16
+ - An audit is a technical risk review, not a compliance attestation.
17
+
18
+ ## Findings
19
+
20
+ For each finding give: severity, section, evidence (file:line, or sanitized command
21
+ output with its retrieval time), the expectation from the operations reference with
22
+ its evidence ID, impact, the smallest proposed fix and how to verify it.
23
+
24
+ - PASS only for a check actually performed. Missing evidence is UNVERIFIED.
25
+ - An absent repository setting does not prove the live setting is off.
26
+ - Propose fixes; never apply them as part of the audit.
@@ -0,0 +1,136 @@
1
+ # Cosmos DB for NoSQL: consistency, capacity and data-plane security
2
+
3
+ Load this for consistency-level choice, session tokens, the integrated cache,
4
+ serverless vs provisioned vs autoscale, logical-partition limits, or Entra ID
5
+ data-plane RBAC. Every bracketed ID resolves in
6
+ [evidence-ledger.md](evidence-ledger.md). Text without an ID is labeled
7
+ inference or recommendation. API for NoSQL only.
8
+
9
+ ## Consistency
10
+
11
+ | Level | Read RU cost | What it gives | Region-outage RPO (more than one region) | Evidence |
12
+ | --- | --- | --- | --- | --- |
13
+ | Strong | 2x | linearizable reads; writes commit in every region; **not available with multiple write regions**; spans over 5,000 miles blocked by default | 0 | [COSMOS-E02] [COSMOS-E17] [COSMOS-E18] |
14
+ | Bounded staleness | 2x | reads lag by at most K versions or T time | K and T | [COSMOS-E02] [COSMOS-E18] |
15
+ | Session | 1x | read-your-writes per session; the most widely used level | under 15 min | [COSMOS-E03] [COSMOS-E18] |
16
+ | Consistent prefix | 1x | transactional-batch writes become visible together; single-document writes behave eventually | under 15 min | [COSMOS-E04] [COSMOS-E18] |
17
+ | Eventual | 1x | staleness-tolerant reads | under 15 min | [COSMOS-E01] [COSMOS-E18] |
18
+
19
+ - Read consistency is scoped to one read within a logical partition
20
+ [COSMOS-E01]. Cross-partition invariants need application design, not a
21
+ stronger level. *(inference)*
22
+ - Strong across regions costs write latency of about twice the round trip to
23
+ the farthest region plus 10 ms at p99 [COSMOS-E17]. Choosing multi-region
24
+ writes rules Strong out entirely [COSMOS-E17]. Treat "multi-write + strong"
25
+ as a contradiction to resolve, not a configuration. *(recommendation)*
26
+ - A single-region account has RPO under 240 minutes at every level
27
+ [COSMOS-E18]. A consistency level is not a DR plan.
28
+
29
+ ### Session tokens: where read-your-writes quietly breaks
30
+
31
+ - Tokens are **partition-bound**. Per the consistency-levels page, a client
32
+ that has not written to a physical partition has no cached token for it and
33
+ reads it as eventual [COSMOS-E03]. Read responses also return a session
34
+ token, which Microsoft's examples pass explicitly on later reads
35
+ [COSMOS-E21]. Whether a given SDK caches read-acquired tokens automatically
36
+ is not documented, so do not tell a read-only service that it must write to
37
+ get session behavior. Check that SDK's behavior first. *(inference)*
38
+ - A **re-created client** (pod restart, per-request client construction,
39
+ serverless cold start) loses its token cache and reads as eventual until the
40
+ cache is rebuilt [COSMOS-E03]. To see writes made before the restart, carry
41
+ their session token forward explicitly [COSMOS-E03] [COSMOS-E21]. Per-request `CosmosClient` construction
42
+ therefore also breaks session guarantees, on top of its connection cost.
43
+ *(inference)*
44
+ - Read-your-writes across services (a write in API A, then a read in worker B)
45
+ requires passing the session token, **unmodified** [COSMOS-E03].
46
+
47
+ ### Overriding consistency per request
48
+
49
+ - `ConsistencyLevel` overrides can only **relax** below the account default
50
+ [COSMOS-E05].
51
+ - `ReadConsistencyStrategy` can also **strengthen** above it (for example
52
+ `LatestCommitted`, `GlobalStrong`) and wins when both are set
53
+ [COSMOS-E05]. It is **preview**, **direct mode only** [COSMOS-E05], and
54
+ documented only for Java SDK v4.69+ and .NET SDK v3.46+ [COSMOS-E06]. Do not
55
+ recommend it for Python, JavaScript or Go, or for production paths that
56
+ cannot accept preview behavior. *(recommendation)*
57
+ - Because it needs direct mode and the integrated cache needs gateway mode
58
+ [COSMOS-E08], one client cannot use both. *(inference)*
59
+ - Read-path changes only: write RU cost does not change with level
60
+ [COSMOS-E02].
61
+
62
+ ## Integrated cache (dedicated gateway)
63
+
64
+ All three must hold for a cache hit [COSMOS-E08]:
65
+
66
+ 1. the client uses the **dedicated gateway endpoint**;
67
+ 2. the client uses **gateway mode**. .NET and Java default to direct mode and
68
+ silently miss the cache [COSMOS-E08];
69
+ 3. the read is **Session or Eventual**. Strong, Bounded staleness and
70
+ Consistent prefix bypass it [COSMOS-E07].
71
+
72
+ Staleness is bounded by `MaxIntegratedCacheStaleness` (default 5 min). A value
73
+ of 0 means reads never use the cache, although writes still populate it
74
+ [COSMOS-E07] [COSMOS-E08]. Production use needs at least three gateway nodes
75
+ for SLA coverage, and the gateway carries no latency SLA [COSMOS-E09]. Reject
76
+ the cache when reads rarely repeat, the app needs Strong or Bounded staleness,
77
+ or a direct-mode app cannot switch. *(recommendation)*
78
+
79
+ ## Capacity model
80
+
81
+ | Mode | Use when | Hard limits | Evidence |
82
+ | --- | --- | --- | --- |
83
+ | Provisioned (manual) | steady, predictable traffic | 429s if consumption exceeds provisioned RU/s | [COSMOS-E12] |
84
+ | Autoscale | variable traffic | scales 0.1 x Tmax to Tmax; billed at hourly peak (min 0.1 x Tmax) | [COSMOS-E13] |
85
+ | Serverless | intermittent, low average-to-peak | **cannot add regions after creation** while serverless; no throughput or latency guarantee; 5,000 RU/s per physical partition; no shared-throughput DB | [COSMOS-E10] [COSMOS-E11] [COSMOS-E19] |
86
+
87
+ Any mode is capped at **10,000 RU/s and 20 GB per logical partition**, and
88
+ work beyond a physical partition's share is rate-limited [COSMOS-E12]. A hot or
89
+ large partition-key value is a modeling defect that no capacity mode fixes.
90
+ Use hierarchical partition keys (up to three levels) when one key value would
91
+ exceed 20 GB [COSMOS-E12].
92
+
93
+ - Autoscale avoids 429s only while total consumption stays within the
94
+ configured range [COSMOS-E13]. A hot partition can still be rate-limited
95
+ [COSMOS-E12], and shared-database autoscale lets one container's burst
96
+ throttle the others [COSMOS-E13]. Prefer container-level autoscale.
97
+ *(recommendation)*
98
+ - A serverless account cannot add regions after creation [COSMOS-E10]. The
99
+ only path to multi-region is an **in-place, one-time, irreversible**
100
+ conversion to provisioned throughput, which has no duration SLA and blocks
101
+ management operations while it runs [COSMOS-E20]. "Serverless now, DR
102
+ later" therefore means a planned capacity-mode migration, an approved
103
+ change window, and losing serverless billing for good. If DR is a known
104
+ requirement, start on provisioned or autoscale. *(recommendation)*
105
+ - Prices are not in this ledger. A cost estimate must cite a freshly retrieved
106
+ Azure pricing page or be labeled an assumption.
107
+
108
+ ## Data-plane vs control-plane security
109
+
110
+ These are **two different RBAC systems**:
111
+
112
+ | Plane | Covers | Mechanism | Evidence |
113
+ | --- | --- | --- | --- |
114
+ | Data plane | item CRUD, queries, change feed, stored procedures, conflict feed | Cosmos DB native RBAC (`sqlRoleDefinitions`/`sqlRoleAssignments`); built-in Data Reader / Data Contributor | [COSMOS-E14] |
115
+ | Control plane | keys and connection strings, backup/restore, databases/containers, account properties | Azure RBAC | [COSMOS-E15] |
116
+
117
+ Review rules:
118
+
119
+ - An Azure RBAC assignment does not grant data access through native
120
+ data-plane RBAC. Check both planes separately. *(inference from E14/E15)*
121
+ - **But keys bridge the planes.** A control-plane role that can read account
122
+ keys or connection strings [COSMOS-E15] obtains a credential that works for
123
+ data access unless key auth is disabled [COSMOS-E16]. Treat key-listing
124
+ permissions as data access. *(inference)*
125
+ - Data-plane roles have no `notDataActions`. Build least privilege by listing
126
+ allowed `dataActions` only [COSMOS-E14]. Scope to a database or container,
127
+ not the account, where the workload allows. *(recommendation)*
128
+ - Data-plane assignments cannot be managed in the portal [COSMOS-E14]. Expect
129
+ CLI, PowerShell or IaC evidence.
130
+ - Whoever holds control-plane `sqlRoleAssignments/write` can grant themselves
131
+ data access [COSMOS-E14]. Treat that permission as data-sensitive.
132
+ *(inference)*
133
+ - For Entra-only workloads, disable key auth with `disableLocalAuth=true` and
134
+ verify that a key-based connection fails [COSMOS-E16]. That is an account
135
+ mutation: it needs an explicit target, confirmation that no consumer still
136
+ uses keys, a rollback plan and approval.
@@ -36,7 +36,7 @@ Microsoft Learn describes Cosmos DB as an account containing databases and conta
36
36
 
37
37
  - Multi-region account configuration does not prove application failover unless SDK preferred regions, retries, conflict handling, and remaining-region capacity are verified.
38
38
  - Private endpoints can break regional resilience if DNS zones, VNet links, forwarding, and local regional endpoint paths are not designed deliberately.
39
- - Strong, bounded staleness, session, and eventual consistency have different availability, RPO, and throughput implications; do not treat consistency as a cosmetic setting.
39
+ - Strong, bounded staleness, session, consistent prefix, and eventual consistency (all five levels; see `consistency-capacity-security.md`) have different availability, RPO, and throughput implications; do not treat consistency as a cosmetic setting.
40
40
  - Control-plane changes during an affected-region outage can delay recovery; do not mutate write region, consistency, throughput, networking, or failover priorities casually.
41
41
  - Backup protects data recovery scenarios; it is not a substitute for live availability, failover routing, or tested application DR.
42
42