@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,17 @@
1
+ # Authorized live metadata audit
2
+
3
+ Before any read, confirm tenant/subscription/principal, resource IDs, account API,
4
+ database/container/region, permitted fields and explicit live-read authorization.
5
+ Prefer existing safe MCP metadata tools if offered; discover their schema first.
6
+ Never infer permission from MCP availability or login state.
7
+
8
+ Use a scoped `az cosmosdb show`, container show/throughput show and approved role/
9
+ metric/backup-window metadata only. Explicit `--subscription`, resource group and
10
+ name on every request; never `list-keys`, broad subscription enumeration, item
11
+ queries/exports or credential output. If not authorized or tools unavailable,
12
+ return UNVERIFIED and offer offline evidence, not a login/install workaround.
13
+
14
+ Check returned resource ID/API/region and timestamps before interpreting fields.
15
+ Stop on target drift, unexpected authorization failure, partial errors or any
16
+ proposed mutation. Readback proves settings only, not fresh workload access,
17
+ performance, tenant isolation, key continuity or successful recovery.
@@ -0,0 +1,15 @@
1
+ # Offline audit
2
+
3
+ Use only authorized local code/templates and sanitized supplied metadata. No Azure
4
+ MCP resource discovery, CLI provider calls, SDK requests, credential/environment
5
+ dumps, or automatic external lookup. User-requested current research is separate
6
+ and must contain no private resource/item values.
7
+
8
+ Check selected feature invariants against actual artifacts: partition/id routing,
9
+ tenant parameterization and ETags; index/throughput/consistency assumptions; data
10
+ vs control roles; encryption/key dependencies; backup mode and restore plan;
11
+ vector dimensions/model/policy and metrics. A desired-state template does not
12
+ prove deployment, effective permissions, network connectivity or runtime behavior.
13
+
14
+ Return file/line evidence and proposed tests. Label metadata snapshots stale when
15
+ their date/context is unknown. Do not read customer items to fill an evidence gap.
@@ -0,0 +1,8 @@
1
+ # Audit dispatcher
2
+
3
+ Default **offline**. Load exactly one [offline](audit/offline.md) or
4
+ [live](audit/live.md) procedure according to the selected mode. Do not open both.
5
+ Scope only selected features. Unknown or unselected settings are UNVERIFIED, not
6
+ compliant/disabled. Selection itself grants no permission to access Azure.
7
+ Report severity, evidence location/time, expected vs observed behavior, narrow
8
+ recommendation, missing evidence and PASS/MISS/UNVERIFIED; never auto-remediate.
@@ -0,0 +1,39 @@
1
+ # Scoped Azure CLI cookbook — illustrative, never auto-run
2
+
3
+ Every request pins `--subscription` and `--resource-group` where supported plus
4
+ account/database/container. No `az account set`, implicit current subscription,
5
+ environment dump or `list-keys`. Commands needing extensions are not permission
6
+ to install them. No az was installed during authoring; syntax checked against
7
+ official docs and local fake-command tests, not Azure service acceptance.
8
+
9
+ ```bash
10
+ az cosmosdb show --subscription "$AZ_SUBSCRIPTION" \
11
+ --resource-group "$RESOURCE_GROUP" --name "$ACCOUNT_NAME"
12
+ az cosmosdb sql container show --subscription "$AZ_SUBSCRIPTION" \
13
+ --resource-group "$RESOURCE_GROUP" --account-name "$ACCOUNT_NAME" \
14
+ --database-name ordersdb --name orders
15
+ az cosmosdb sql container throughput show --subscription "$AZ_SUBSCRIPTION" \
16
+ --resource-group "$RESOURCE_GROUP" --account-name "$ACCOUNT_NAME" \
17
+ --database-name ordersdb --name orders
18
+ ```
19
+
20
+ These are authorized metadata reads only. Check returned account ID/API/region;
21
+ settings readback isn't runtime proof. Data CRUD/SQL uses selected SDK/NoSQL REST,
22
+ not a fictional `az cosmosdb query/get-item` management command. See matching
23
+ adapter only. Creation uses gated assets/provision.sh OR ARM under existing owner.
24
+
25
+ An approved periodic policy change (never execute during audit):
26
+
27
+ ```bash
28
+ az cosmosdb update --subscription "$AZ_SUBSCRIPTION" \
29
+ --resource-group "$RESOURCE_GROUP" --name "$ACCOUNT_NAME" \
30
+ --backup-interval 240 --backup-retention 168
31
+ ```
32
+
33
+ Only apply to an observed periodic account after retention/cost/recovery review.
34
+ It doesn't switch continuous back to periodic. Load exact recovery method guide
35
+ for timestamp/window/restore examples; don't preload all restore methods here.
36
+
37
+ Sources: [az cosmosdb](https://learn.microsoft.com/cli/azure/cosmosdb),
38
+ [container](https://learn.microsoft.com/cli/azure/cosmosdb/sql/container),
39
+ [throughput](https://learn.microsoft.com/cli/azure/cosmosdb/sql/container/throughput).
@@ -0,0 +1,30 @@
1
+ # Continuous protection
2
+
3
+ 1. On authorized metadata only, read account `backupPolicy.type` and
4
+ `continuousModeProperties.tier`, API/region, source instance identity and
5
+ resource existence times. Current native retention is 7/30/35 days; don't assume
6
+ the CLI/pinned ARM version exposes 35 merely because service docs list it.
7
+ 2. Capture per-resource/per-region latest restorable timestamp; aggregate recovery
8
+ uses the minimum latest timestamp across required containers. Discover actual
9
+ backup window before selecting a point. Creation/migration/tier-change time
10
+ can shorten usable history; new tier doesn't manufacture older backups.
11
+ 3. Plan periodic→continuous migration or tier change through existing IaC owner.
12
+ Continuous→periodic is unsupported. Shortening tier can lose older recovery
13
+ points; require approved loss/cost analysis. Continuous backup redundancy is
14
+ platform-controlled (local/zone based on region configuration), not a generic
15
+ periodic backup redundancy switch.
16
+ 4. Confirm restore/enumeration permissions, CMK/default identity/old versions and
17
+ recovery target/checks. Return observed/unknown window, RPO/RTO gaps and drill
18
+ plan, not “backup healthy” from policy alone. No backup operation runs here.
19
+
20
+ Authorized metadata example (the installed CLI may need a separately approved
21
+ extension for latest-backup-time; never install automatically):
22
+
23
+ ```bash
24
+ az cosmosdb sql retrieve-latest-backup-time --subscription "$AZ_SUBSCRIPTION" \
25
+ --resource-group "$RESOURCE_GROUP" --account-name "$ACCOUNT_NAME" \
26
+ --database-name ordersdb --container-name orders --location "$LOCATION"
27
+ ```
28
+
29
+ Sources: [continuous introduction](https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-introduction),
30
+ [latest timestamp](https://learn.microsoft.com/azure/cosmos-db/get-latest-restore-timestamp).
@@ -0,0 +1,28 @@
1
+ # Periodic protection
2
+
3
+ Periodic snapshots are automatic, with support-assisted restore; no user-named
4
+ on-demand snapshot equivalent. Default is a backup about every four hours with
5
+ the latest two copies retained (nominal eight hours). Actual completion can lag
6
+ the configured interval; treat RPO as observed, not exactly interval seconds.
7
+
8
+ Account policy bounds: interval **60–1440 minutes**, retention at least **twice
9
+ the interval** and at most **720 hours**. Redundancy choices Geo/Local/Zone depend
10
+ on region/support and residency requirements. Read actual policy before changes.
11
+ Changing redundancy affects future backups, can take twice the interval and
12
+ immediately removes access to older backups per current docs; require explicit
13
+ recovery-loss review. Don't silently choose Geo across residency boundaries.
14
+
15
+ Prepare support access, source/subscription/resource IDs, incident window/UTC,
16
+ required data scope, keys/default identity and new-account destination. For an
17
+ incident, promptly escalate; current docs advise contacting support/increasing
18
+ retention to at least seven days within eight hours to preserve usable snapshots.
19
+ Retention change is still a mutation needing approval; no automatic change here.
20
+
21
+ Deleted-container/database snapshot retention rules can differ from the live
22
+ account's nominal window (docs describe retention for 30 days). Verify exact
23
+ source/snapshot availability with Support; don't make every corruption recoverable
24
+ for 30 days or claim timestamp-precise PITR. Shared-throughput backup/restore has
25
+ database-scope implications. Record RPO/RTO/support-delay uncertainty.
26
+
27
+ Sources: [periodic](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-restore-introduction),
28
+ [interval/retention/redundancy](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-modify-interval-retention).
@@ -0,0 +1,11 @@
1
+ # Backup / protection dispatcher
2
+
3
+ This is a policy/window review and change plan, **not** a user-named snapshot API.
4
+ Default continuous. Read [recovery target](recovery-target.md) and exactly one
5
+ method: [continuous](backup/continuous.md) OR [periodic](backup/periodic.md).
6
+ No named/on-demand backup create/list/download commands are provided because
7
+ Cosmos platform-managed backups aren't exposed as DynamoDB backup objects.
8
+
9
+ Capture policy/tier/retention, observed recoverable bounds, keys/identities,
10
+ regions, permission owner, RPO/RTO and last validated restore drill. Feature
11
+ selection cannot claim a backup exists or satisfy business continuity goals.
@@ -0,0 +1,13 @@
1
+ # Design
2
+
3
+ 1. Confirm NoSQL API, existing ownership, access-pattern matrix, tenant trust,
4
+ item sizes/rates/growth, latency/consistency, transaction and recovery goals.
5
+ 2. Specify `id` and exact partition-key path/value, point-read vs routed-query vs
6
+ cross-partition paths, index policy, per-pattern RU/latency estimates and hot-key
7
+ mitigation. State assumptions rather than inventing production measurements.
8
+ 3. Compare embed/reference/materialized-view and tenant/container/account choices;
9
+ don't default to one container per tenant or copy a DynamoDB single-table model.
10
+ 4. Load selected IAM/key/vector/recovery guides only when in scope. If code/IaC
11
+ requested, use the existing language/owner; load selected adapter/assets only.
12
+ 5. Deliver matrix/model, invariants, small examples, migration/verification plan
13
+ and explicit unresolved constraints. Creating resources is a separate approval.
@@ -0,0 +1,18 @@
1
+ # Feature lifecycle plan
2
+
3
+ Generate a proposal, not a mutation. Confirm current/desired state, API/region/
4
+ SDK and IaC owner, dependencies, irreversibility, cost, compatibility, preview/
5
+ rollout/readback/rollback and approval boundary. Generic actions are conservative:
6
+
7
+ | Feature | Accepted generic action | Native limitation |
8
+ |---|---|---|
9
+ | ttl | enable / disable / configure | Disable changes expiry; never restores deleted items |
10
+ | vectors | enable / configure | No generic disable once enabled; policy changes require verified migration path |
11
+ | indexes, capacity, iam, encryption, backup, replication, change-feed, embeddings, monitoring | configure | No invented global on/off toggle; exact native property/lifecycle required |
12
+ | core, provisioning | none | Use design/refactor/provisioning, not feature toggles |
13
+
14
+ Backup is always present (periodic default or continuous). Continuous → periodic
15
+ isn't supported. Shorter retention can destroy recovery options. Encryption at
16
+ rest isn't an on/off feature. CMK disable/revoke/delete and network opening never
17
+ appear as incidental setup/rollback. Changes to data roles/network are separate
18
+ from feature availability. Multi-region isn't a backup for logical corruption.
@@ -0,0 +1,13 @@
1
+ # Help — stop route
2
+
3
+ Show `select`, `design`, `refactor`, `audit`, `performance-test`, `feature-plan`,
4
+ `backup`, `restore`. Explain NoSQL-only scope, available feature IDs and that this
5
+ is guidance plus an offline selector, not host registration/cloud execution.
6
+ Show one selected example if asked, then stop. Do not inspect repository files,
7
+ credentials, installed SDKs, subscription, resources or source ledger from help.
8
+
9
+ Feature IDs: core, indexes, capacity, iam, encryption, ttl, backup, replication,
10
+ change-feed, vectors, embeddings, monitoring, provisioning.
11
+ Audit defaults offline. Backup defaults continuous; restore defaults
12
+ continuous-new-account. Features default core (recovery: backup).
13
+ Other APIs and AWS-specific features/method names fail, not silently remap.
@@ -0,0 +1,24 @@
1
+ # Bounded performance plan — not a load runner
2
+
3
+ Selector defaults: local, 30 seconds, 500 requests, concurrency 2, 1000 RU budget;
4
+ all caps must be positive. Production is deliberately unsupported. Selection
5
+ never launches traffic, creates data or changes throughput.
6
+
7
+ Specify exact endpoint/tenant/account/container, nonproduction authorization,
8
+ synthetic dataset/cardinality/hot-key distribution, operation mix/item/vector
9
+ sizes, index/SDK/connection mode, consistency and warm/cold states. Local emulator
10
+ results aren't Azure latency/availability/cost proof.
11
+
12
+ Before a separately approved run enforce duration, total attempts INCLUDING
13
+ retries, concurrency, requests/sec, per-operation deadline, overall RU and spend
14
+ budget, cancellation, cleanup ownership and 429/error/latency stop thresholds.
15
+ Unknown RU must stop, not be counted as zero; one request can cross a RU budget
16
+ before its charge is known. Reserve that overshoot and Azure billing uncertainty.
17
+
18
+ Measure p50/p95/p99/end-to-end latency, charges by operation, normalized RU by
19
+ partition, throttling/retries, diagnostics/activity IDs and success/error counts.
20
+ Vector tests also fix recall ground truth, tenant filters, index population/build
21
+ state, nDCG/recall@k and freshness. No self-match-only quality claim.
22
+
23
+ Deliver an executable plan only if requested, always with separately reviewed
24
+ enforcement and exact run approval. No SDK install or cloud traffic on load.
@@ -0,0 +1,30 @@
1
+ # Recovery target contract
2
+
3
+ Record tenant/subscription, source full resource ID **and restorable instance ID**
4
+ (names can be reused), NoSQL API, database/container IDs/RIDs, region existence,
5
+ policy/tier, resource creation/deletion times, incident time and observed latest
6
+ restorable timestamp. Compute bounds dynamically: selected tier AND resource/
7
+ region existence AND observed backup readiness, not `now minus 30 days` alone.
8
+
9
+ Require UTC timezone-aware restore timestamp inside those bounds; source and
10
+ destination in the supported same subscription. Bind exact new account name and
11
+ existing destination resource group for new-account methods. Verify absence by
12
+ authorized lookup: **only a classified ResourceNotFound means absent**. 403,
13
+ timeout, CLI failure or wrong subscription must never trigger create/restore.
14
+
15
+ Deleted-resource mode instead binds source live account, specific Delete event
16
+ and original DB/container name, verifies it is currently absent and timestamp
17
+ precedes deletion. Never overwrite/reuse a currently existing target. Name-race
18
+ or drift is a hard stop, not delete/retry.
19
+
20
+ Confirm caller's restore/enumeration/control permissions separately from data
21
+ roles; preserve source key versions, Key Vault access/default identity and restore
22
+ identity continuity. Fix TTL treatment explicitly to avoid deleting recovered
23
+ data immediately. No automatic network opening, role broadening or key cleanup.
24
+
25
+ After async completion independently read back source/time/destination/createMode,
26
+ API, region, indexes/partition/TTL, consistency/throughput and key identity. Restore
27
+ network/private endpoints/data RBAC/regions/server-side functions as required;
28
+ validate application reads/writes/tenant denials, counts and domain invariants,
29
+ replay/deduplication, dependencies and measured RPO/RTO. Only then propose cutover;
30
+ retain source/rollback until approved. No deletion in this workflow.
@@ -0,0 +1,14 @@
1
+ # Refactor
2
+
3
+ 1. Capture current sanitized contract, API/SDK version, partition/id, indexes,
4
+ throughput, ETag/session behavior, tenant enforcement and existing IaC owner.
5
+ 2. Classify code-only, compatible index change or data-model migration. A new
6
+ partition key or incompatible vector policy can require a new container; never
7
+ drop/recreate or invoke createIfNotExists to hide drift.
8
+ 3. Preserve public adapter behavior. Parameterize queries; handle pagination,
9
+ cancellation/RU/retry bounds and 409/412 explicitly. No speculative ORM rewrite.
10
+ 4. For migration: define source watermark, versioned backfill, idempotency,
11
+ deletes/TTL reconciliation, dual-write divergence, validation, approved cutover
12
+ and rollback window. Change feed latest-version alone misses deletions.
13
+ 5. Deliver minimal diff, negative tests, compatibility/readback checks and risks.
14
+ No backfill, deployment, writes or load without separate explicit authorization.
@@ -0,0 +1,55 @@
1
+ # Continuous restore of a deleted DB/container into the SAME account
2
+
3
+ This method is only for an actual deleted database/container in an existing
4
+ continuous-backup NoSQL account. It isn't item rollback or an overwrite of a live
5
+ resource. Confirm Delete event/resource RID, source instance, time before deletion
6
+ inside observed recoverable window, region, exact original name and currently
7
+ absent target. Any existing target/name race is a hard stop; never delete to fit.
8
+
9
+ Azure CLI docs require 2.58.0+ for in-account restore; verify installed core/help
10
+ and support/preview state of selected command without auto-installing extensions.
11
+ Choose ONE approved operation, not both:
12
+
13
+ ```bash
14
+ # Deleted database: restores child containers too; broader blast radius.
15
+ az cosmosdb sql database restore --subscription "$AZ_SUBSCRIPTION" \
16
+ --resource-group "$RESOURCE_GROUP" --account-name "$ACCOUNT_NAME" \
17
+ --name "$DELETED_DATABASE" --restore-timestamp "$RESTORE_TIMESTAMP" --disable-ttl true
18
+ ```
19
+
20
+ ```bash
21
+ # Deleted container only; database exists.
22
+ az cosmosdb sql container restore --subscription "$AZ_SUBSCRIPTION" \
23
+ --resource-group "$RESOURCE_GROUP" --account-name "$ACCOUNT_NAME" \
24
+ --database-name "$DATABASE_NAME" --name "$DELETED_CONTAINER" \
25
+ --restore-timestamp "$RESTORE_TIMESTAMP" --disable-ttl true
26
+ ```
27
+
28
+ Although service may default omitted timestamp to latest deleted instance, this
29
+ workflow requires explicit UTC timestamp/identity to avoid restoring the wrong
30
+ generation. Prove source/destination/deletion scope before approval. No more than three
31
+ restore operations can be active at once on the same account [CP-E354]; check
32
+ for in-flight restores before starting another. Preserve keys
33
+ and permissions while async restore runs. Inspect InAccount restore activity and
34
+ resource state, then indexes/TTL/RUs/security/app invariants and measured RPO/RTO;
35
+ no acceptance from a waiter alone and no automatic cutover/cleanup.
36
+
37
+ ## Required token / consumer recovery exception
38
+
39
+ Restored resources are treated as new resources. Invalidate old session and query
40
+ continuation tokens; refresh/restart SDK clients and restart queries against the
41
+ restored resource. Do not replay old continuation tokens as though the original
42
+ resource lifetime continued.
43
+
44
+ Restart change-feed listeners from the beginning for the restored resource.
45
+ Only its **post-restore lifetime** events are available; events from before the
46
+ deletion aren't propagated/restored into that feed. Restarting does NOT recreate
47
+ lost pre-deletion history. Preserve old checkpoints as evidence but do not blindly
48
+ reuse them for this new lifetime. Design idempotent replay, downstream business/
49
+ projection reconciliation, explicit tombstone/delete/TTL-gap recovery, and separate
50
+ rebuild from validated restored state if required. Test duplicate/stale effects
51
+ and missing-history scenarios before resuming consumers/cutover.
52
+
53
+ Sources: [same-account recovery](https://learn.microsoft.com/azure/cosmos-db/how-to-restore-in-account-continuous-backup),
54
+ [restored lifetime/token/feed semantics](https://learn.microsoft.com/azure/cosmos-db/restore-in-account-continuous-backup-introduction),
55
+ [resource model](https://learn.microsoft.com/azure/cosmos-db/restore-in-account-continuous-backup-resource-model).
@@ -0,0 +1,50 @@
1
+ # Continuous recovery into a NEW account
2
+
3
+ Apply recovery-target contract first. Bind exact source/restorable instance,
4
+ region present at UTC point, dynamic earliest/latest bounds, destination
5
+ subscription/group/new account and approved scope. Same-subscription only; a
6
+ precreated account isn't the destination. Accidental item corruption normally
7
+ uses this method, not an in-place overwrite.
8
+
9
+ CLI example is an **illustrative approved operation**, never automatically run:
10
+
11
+ ```bash
12
+ az cosmosdb restore --subscription "$AZ_SUBSCRIPTION" \
13
+ --resource-group "$TARGET_RESOURCE_GROUP" --account-name "$SOURCE_ACCOUNT" \
14
+ --target-database-account-name "$TARGET_ACCOUNT" --location "$LOCATION" \
15
+ --restore-timestamp "$RESTORE_TIMESTAMP" --disable-ttl true \
16
+ --disable-local-auth true --public-network-access DISABLED
17
+ ```
18
+
19
+ The CLI uses source account name, not a source-instance argument. Enumerate and
20
+ bind its exact restorable instance first; if reused names are ambiguous, stop and
21
+ use reviewed ARM `createMode: Restore` / `restoreParameters.restoreSource` full
22
+ restorable-resource-ID workflow rather than guessing. No hidden name fallback.
23
+ For partial restore use documented repeated `--databases-to-restore`
24
+ `name=DatabaseName collections=collection1 collection2` CLI shorthand, NOT ARM
25
+ JSON. Verify installed help and bind the exact approved subset before execution.
26
+ A subset of containers in shared-throughput database can't be restored;
27
+ use whole database. CMK requires reviewed `--assign-identity`/`--default-identity`
28
+ and working key access, not the service-managed example copied unchanged.
29
+
30
+ The offline recovery_guard.py helper deliberately supports **full-account only**
31
+ for this method: explicit matching restore_scope/approved_restore_scope are
32
+ required and any subset fields fail. Partial restore remains a reviewed manual
33
+ workflow; it must never silently expand to all-account recovery.
34
+
35
+ Track async provisioning/error status and re-read restoreParameters source/time
36
+ and destination identity; don't retry uncertain outcomes. Recovered data/index
37
+ properties/consistency can be restored, but throughput may not match point in
38
+ time. Reconcile firewall/VNet/private endpoints, data/control RBAC, other regions,
39
+ stored procedures/triggers/UDFs, diagnostics and application dependencies; current
40
+ docs say these settings aren't all restored. Keep public network disabled while
41
+ repairing connectivity through the approved existing network workflow.
42
+
43
+ Explicit `--disable-ttl true` is the example's reviewed preservation choice, not
44
+ a permanent production setting. Validate/re-enable expiry deliberately later.
45
+ Index rebuilding, application/security/domain validation and measured RPO/RTO must
46
+ pass before separately approved cutover. Waiter success alone isn't recovery.
47
+
48
+ Sources: [restore command/workflow](https://learn.microsoft.com/azure/cosmos-db/restore-account-continuous-backup),
49
+ [what is/isn't restored](https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-introduction),
50
+ [CLI restore](https://learn.microsoft.com/cli/azure/cosmosdb#az-cosmosdb-restore).
@@ -0,0 +1,27 @@
1
+ # Periodic restore — Azure Support, not self-service PITR
2
+
3
+ Do not issue `az cosmosdb restore` against periodic backups or invent a named
4
+ backup ARN/ID/download API. Promptly prepare a Support request; no case is opened
5
+ automatically by this skill. Confirm eligible support plan and escalation owner.
6
+
7
+ Supply subscription, original account/resource IDs/API, precise incident UTC
8
+ window, affected DB/container scope, source write region, requested snapshot/new
9
+ account name/resource group and preservation/retention/key dependencies. Do not
10
+ recreate a deleted source or precreate the restore target. Periodic recovery
11
+ creates a new account; exact snapshot availability/time and scope are confirmed
12
+ with Support, not promised by requested timestamp.
13
+
14
+ If source still exists, review approved retention increase promptly to avoid
15
+ overwriting recovery points (docs advise within eight hours). Never execute a
16
+ retention/redundancy change automatically or revoke old keys. Shared-throughput
17
+ database scope and current region restrictions need explicit Support confirmation.
18
+
19
+ Track case and asynchronous operation state; capture resulting source/snapshot/
20
+ destination identity. Reconcile partition/index/TTL/throughput/consistency, IAM,
21
+ CMK/default identity, private endpoints/firewall/DNS, replication, server-side
22
+ functions, consumers/diagnostics and application endpoints. Validate data/domain
23
+ invariants, tenant denials, dependencies and measured RPO/RTO before separately
24
+ approved cutover. Retain source/rollback; no delete/cleanup commands here.
25
+
26
+ Sources: [request restore](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-request-data-restore),
27
+ [periodic behavior](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-restore-introduction).
@@ -0,0 +1,13 @@
1
+ # Restore dispatcher
2
+
3
+ Read [recovery target](recovery-target.md) and **only** the selected procedure:
4
+
5
+ | Method | Procedure | Destination boundary |
6
+ |---|---|---|
7
+ | continuous-new-account (default) | [Continuous new account](restore/continuous-new-account.md) | New account; no overwrite or adoption |
8
+ | continuous-deleted-resource | [Deleted resource](restore/continuous-deleted-resource.md) | Existing continuous account, deleted DB/container only; target name absent |
9
+ | periodic-support | [Periodic support request](restore/periodic-support.md) | Support-assisted new account; no fake self-service PITR |
10
+
11
+ No SDK/CLI operation is authorized by selection. Require exact source/time/region/
12
+ destination approval, encrypted recovery dependencies and validation before any
13
+ separately approved cutover. A successful long-running operation isn't acceptance.
@@ -0,0 +1,11 @@
1
+ # Select features
2
+
3
+ 1. Run the local selector or map the user's explicit features to its `read` list.
4
+ Ask only for missing API/workload information that blocks correctness.
5
+ 2. Read this command and only selected domain guides. A link inside a guide is a
6
+ conditional reference, not permission to preload it. Selecting backup reads the
7
+ overview first; choose one exact method before loading a method procedure.
8
+ 3. Explain native capability, applicability, cost/risk, alternatives, constraints
9
+ and what evidence is missing. Do not convert selection into feature enablement.
10
+ 4. Return one-invocation scope, assumptions, recommended next manual command and
11
+ PASS/MISS/UNVERIFIED. No persistent activation or command chain.
@@ -0,0 +1,51 @@
1
+ # JSON types and native vector search
2
+
3
+ NoSQL API uses JSON: string, number, boolean, null, array and object; missing
4
+ (`undefined` in query semantics) differs from null. No DynamoDB AttributeValue
5
+ tags, native sets, binary/date type or exact arbitrary-precision decimal contract.
6
+ Represent timestamps with explicit canonical UTC strings and money/large integers
7
+ using a reviewed scaled/string representation where IEEE-754 round-trip precision
8
+ would fail. `id` must be a string. Validate finite numeric values and size limits
9
+ (ordinary item maximum 2 MB); store binary/media in Blob Storage with pinned refs.
10
+
11
+ ## Current native capability (checked 2026-11-08)
12
+
13
+ NoSQL **does support native vector indexing and `VectorDistance`**; don't route
14
+ every vector request to AI Search or copy MongoDB vector syntax. Feature/account
15
+ availability must be verified before provision. A vector embedding policy defines
16
+ concrete path, dataType, dimensions and distanceFunction; vector index policy uses
17
+ the same concrete path. Nested array/wildcard vector paths aren't supported.
18
+
19
+ | Setting | Documented values / constraints |
20
+ |---|---|
21
+ | Vector element types | Current vector page: `float32`, `float16`, `int8`, `uint8`; older pinned ARM 2025-04-15 enum lists float32/int8/uint8 only. Use float32 in supplied asset; don't claim float16 works through every SDK/API version. |
22
+ | Numeric meaning | Ordered coordinates, not base64/URI/text; finite numbers; integer vectors must fit int8 -128..127 or uint8 0..255, not just cast arbitrary floats. float16/float32 precision is policy-specific. |
23
+ | Dimensions | One fixed positive dimension count per path; max 505 for flat, 4096 for quantizedFlat/diskANN. Model output must match exactly. |
24
+ | Distance | `cosine`, `dotproduct`, `euclidean`; model normalization/metric must agree |
25
+ | Index | `flat` exact brute force (<=505); `quantizedFlat` quantized brute force; `diskANN` approximate. Last two need >=1000 indexed vectors or fall back to full scan (RU risk). |
26
+ | Capacity | Current vector docs exclude shared-throughput accounts; select dedicated container throughput, not database shared throughput |
27
+ | Lifecycle | Cannot generically disable vector indexing/search once enabled. Mutability docs vary: NoSQL vector/index pages and unified Fabric-flavored policy guidance differ about drop/re-add. Verify exact API/region/SDK; conservative example uses new container/generation, not a universal immutable assertion. |
28
+
29
+ The [vector policy](../assets/vector-policy.json) and
30
+ [vector index](../assets/vector-indexing-policy.json) use cosine float32/1536
31
+ with diskANN, exclude `/embedding/*` from ordinary indexing and retain the vector
32
+ index at `/embedding`. They're optional selected assets, not part of core creates.
33
+ For a deployment, verify account capability `EnableNoSQLVectorSearch` and exact
34
+ CLI/API support, then create a distinct container with these policies; don't
35
+ silently change an existing account's capability list or mutate a live vector model.
36
+
37
+ ```sql
38
+ SELECT TOP @k c.id, c.source,
39
+ VectorDistance(c.embedding, @embedding) AS distance
40
+ FROM c WHERE c.tenantId = @tenant AND c.status = 'published'
41
+ ORDER BY VectorDistance(c.embedding, @embedding)
42
+ ```
43
+
44
+ Parameterize @k/vector/tenant; trusted partition-key routing and authorization are
45
+ still required. Bound top-k and page/attempt/RU budgets. A valid query can still
46
+ scan or have poor recall: measure build status, indexed population, filters,
47
+ recall@k/ground truth/freshness and charge, not one self-match.
48
+
49
+ Sources: [native vectors](https://learn.microsoft.com/azure/cosmos-db/vector-search),
50
+ [index constraints](https://learn.microsoft.com/azure/cosmos-db/how-to-manage-indexing-policy),
51
+ [pinned ARM container schema](https://learn.microsoft.com/azure/templates/microsoft.documentdb/2025-04-15/databaseaccounts/sqldatabases/containers).
@@ -0,0 +1,56 @@
1
+ # Embeddings, source references and Azure integrations
2
+
3
+ Cosmos stores/searches coordinates; a Blob URI, source text or model/deployment
4
+ name isn't an embedding. Generate embeddings through a separately authorized
5
+ Azure OpenAI/Foundry model or reviewed application model. No model call runs on
6
+ skill load and there is no claim Cosmos automatically embeds a stored source URI.
7
+
8
+ | Stage | Explicit contract |
9
+ |---|---|
10
+ | Source | Blob account/container/name AND immutable versionId or equivalent immutable content hash; tenant/ACL/classification, MIME and provenance. Never persist a SAS token as source identity. |
11
+ | Chunk | Stable source-version/chunk ID, offsets, tokenizer/chunking version; minimal text required for retrieval, not an accidental source-data dump |
12
+ | Model | Provider/model/deployment version, dimensions, normalization, dataType/quantization and metric; same contract for document AND query embeddings |
13
+ | Index write | Numeric array, tenantId, id, source ref, model/version and generation; conditional/idempotent write after vector validation |
14
+ | Retrieval | Server-derived tenant, partition routing AND SQL predicate, bounded top-k/RUs, validated result tenant/ACL; authorize source access again before fetching Blob |
15
+ | Update/delete | Source-version idempotency, tombstones/deletion reconciliation, TTL and source ACL/model migration; no mixing incomparable vector spaces |
16
+
17
+ For Azure OpenAI `text-embedding-3-small`/`text-embedding-3-large`, dimensions and
18
+ supported reduction depend on deployed model/API; don't assume 1536 for every model.
19
+ The optional policy is **only** a 1536-dimensional generation. Validate actual
20
+ output count/finiteness/float32 representability before writes. Quantization and
21
+ float16/int8 conversion require measured quality/recall, not an unreviewed cast.
22
+
23
+ Illustrative generation with an **already configured, authorized** Azure OpenAI
24
+ v1-compatible client (`openai`) and approved embedding deployment; no client is
25
+ constructed or request executed by this document:
26
+
27
+ ```javascript
28
+ const generated = await openai.embeddings.create({
29
+ model: approvedDeployment, input: chunkText,
30
+ dimensions: 1536, encoding_format: "float"
31
+ });
32
+ // For a model/deployment supporting this output size; validate before indexing.
33
+ const coordinates = vector(generated.data[0].embedding, {dimensions: 1536});
34
+ // buildChunk's injected embedding port can use this adapter; it is not automatic.
35
+ ```
36
+
37
+ The model-call timeout/attempt/token budget, credential, source authorization and
38
+ output handling are caller-owned. Record actual model version, not deployment
39
+ name alone; changing deployment backing model can invalidate an existing index.
40
+
41
+ | Integration | Coherent use | Avoid |
42
+ |---|---|---|
43
+ | Azure OpenAI / Foundry | App generates versioned coordinates with separate model token/RBAC/network controls | Treating Cosmos RU as embedding token cost or invoking a model automatically |
44
+ | Blob Storage | Immutable originals; Cosmos metadata/chunks/source refs | Base64 blobs in item hot paths or persisted SAS secrets |
45
+ | Azure Functions/change feed | Idempotent enrichment/projection, leases/checkpoints and retry/dead-letter design | Assuming exactly-once or latest-version feed contains deletes |
46
+ | Azure AI Search | Alternative dedicated search index with explicit sync/vectorization/ACL/freshness design | Claiming native Cosmos vector query automatically calls AI Search or that either service enforces tenant ACL from a URI |
47
+ | Azure Monitor/App Insights | Charge/latency/error/activity IDs and quality/freshness metrics | Logging raw sensitive text/vectors/tokens |
48
+
49
+ End-to-end quality needs representative labeled queries, recall/nDCG, tenant
50
+ denials, stale/deleted source behavior and budget. A model+store API success is not
51
+ semantic relevance or production RAG readiness. Use current first-party docs and
52
+ existing SDK for actual model requests; no SDK install is implied.
53
+
54
+ Sources: [Cosmos vector search](https://learn.microsoft.com/azure/cosmos-db/vector-search),
55
+ [Azure OpenAI embeddings](https://learn.microsoft.com/azure/ai-foundry/openai/how-to/embeddings),
56
+ [Azure AI Search vectorization](https://learn.microsoft.com/azure/search/vector-search-integrated-vectorization).
@@ -0,0 +1,53 @@
1
+ # Encryption and key lifecycle
2
+
3
+ At-rest encryption is always enabled. Don't import AWS's three-key-choice model.
4
+
5
+ | Choice | Configuration | Ownership/dependency |
6
+ |---|---|---|
7
+ | Service-managed (default) | Omit `keyVaultKeyUri` / `--key-uri` | Cosmos manages service encryption; omission is not plaintext |
8
+ | Customer-managed (CMK) | Account `keyVaultKeyUri`, declared/default identity and matching Key Vault permissions | Customer owns key availability/rotation/access/retention; extra encryption layer and operational dependency |
9
+ | Client-side encryption | Separate SDK/application design | Not provided automatically by either server-side choice; query/index/key exposure constraints differ |
10
+
11
+ Base ARM/CLI examples use the service-managed default consistently. Never pretend
12
+ setting an arbitrary Key Vault URI alone is a complete CMK deployment.
13
+
14
+ For a **reviewed new CMK account variant**, preserve account/database/container
15
+ model and add an existing approved user-assigned identity resource ID to account
16
+ `identity.type: UserAssigned`, `identity.userAssignedIdentities: {<id>: {}}`,
17
+ `properties.defaultIdentity: UserAssignedIdentity=<id>` and
18
+ `properties.keyVaultKeyUri: https://<vault>.vault.azure.net/keys/<key>` (versionless
19
+ URI for supported rotation flow). CLI equivalents: `--assign-identity "$UAMI_ID"`
20
+ `--default-identity "UserAssignedIdentity=$UAMI_ID" --key-uri "$KEY_URI"`.
21
+ This fragment is illustrative; resolve exact API/identity lifecycle and perform
22
+ authorized readback before deployment. Never create/grant/purge keys as a side effect.
23
+
24
+ Verify Key Vault soft delete AND purge protection, supported RSA key/region/cloud,
25
+ key enabled/expiry, Get/Wrap Key/Unwrap Key (or exact equivalent RBAC role such as
26
+ Key Vault Crypto Service Encryption User), correct principal/default identity,
27
+ service network reachability and existing policy ownership. Current docs require
28
+ public accessibility or trusted-service firewall bypass; a vault accessible only
29
+ through private endpoints isn't sufficient for this integration. Never “fix”
30
+ reachability by opening the vault/network without separate security review.
31
+
32
+ Continuous backup with CMK requires a system- or user-assigned managed identity;
33
+ Cosmos first-party identity isn't supported for this continuous-backup case.
34
+ Periodic backup restore can require the original key version and temporary
35
+ first-party identity access if source used system-assigned identity. Do not blindly
36
+ apply that periodic recipe to continuous backup. Preserve old/new versions and
37
+ permissions during rotation and through dependent backup retention/drill windows.
38
+
39
+ A restored CMK account must have verified key access/default identity, not merely
40
+ copied source identity metadata. Current CMK docs warn identity metadata can remain
41
+ source-bound; assign/rescope a reviewed destination identity with appropriate key
42
+ access, and prove destination works independently before any source retirement.
43
+ Do not delete source/identity or retire old keys after a successful restore waiter.
44
+ Revocation can block data/recovery; disabled/deleted keys can render data inaccessible.
45
+ No key deletion/disable/purge command belongs in cleanup/rollback examples here.
46
+
47
+ Metadata such as resource names, indexed paths and partition-key values isn't
48
+ all hidden by CMK; don't put secrets into those fields. Server-side key choice
49
+ doesn't add tenant row filtering or change item SDK signatures. Azure OpenAI,
50
+ Blob Storage, AI Search and logs have separate encryption/identity lifecycles.
51
+
52
+ Sources: [encryption](https://learn.microsoft.com/azure/cosmos-db/database-encryption-at-rest),
53
+ [CMK identity, backups and restore](https://learn.microsoft.com/azure/cosmos-db/how-to-setup-cmk).