@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,68 @@
1
+ # audit --mode live
2
+
3
+ Read only for a requested live audit; do not load the offline sibling. Commands
4
+ are examples for an operator holding read-only authorization; the skill does not
5
+ run them. GeminiDB operation names for `hcloud` were not found on an allowlisted
6
+ official reference page in this pass, so the resource sections below record
7
+ `**No live command:**` rather than guess an operation name.
8
+
9
+ ## Before any command
10
+
11
+ - Confirm the approved principal, Huawei Cloud account, IAM project, Region and
12
+ exact instance. Stop on any mismatch; never switch target to make a command work.
13
+ - Use a read-only role. Write output to a private directory (`umask 077`). Never
14
+ print keys, connection strings or customer data.
15
+ - KooCLI invokes API operations as `hcloud [options] <service> <operation>` [GDB-E901].
16
+ The local profile check below shows only profile name, mode and Region, not
17
+ credentials [GDB-E902]. It does not prove the remote principal: confirm the
18
+ account and IAM user manually in the console and stop on mismatch.
19
+
20
+ ```bash
21
+ set -euo pipefail
22
+ : "${HCLOUD_PROFILE:?Approved KooCLI profile name}"
23
+ : "${EXPECTED_REGION:?Approved Region}"
24
+ umask 077
25
+ audit_dir=$(mktemp -d)
26
+ hcloud configure list --cli-output=json --cli-query="profiles[].{Name:name,Mode:mode,Region:region}" > "$audit_dir/profiles.json" # [GDB-E902]
27
+ jq -e --arg p "$HCLOUD_PROFILE" --arg r "$EXPECTED_REGION" 'map(select(.Name==$p and .Region==$r))|length==1' "$audit_dir/profiles.json"
28
+ ```
29
+
30
+ ## Backup and restore
31
+
32
+ **No live command:** `hcloud GaussDBforNoSQL` operation names (for example for the backup list and automated backup policy) are not stated on any allowlisted official page I fetched. The API reference pages document `GET /v3.1/{project_id}/instances/{instance_id}/backups/policy` and `GET /v3.1/{project_id}/backups`, and the KooCLI guide says the CLI calls API operations, but no page maps them to an `hcloud` operation name. Use the console Backups view meanwhile.
33
+
34
+ ## Disaster recovery and replication
35
+
36
+ **No live command:** no CLI command documented; searched the GeminiDB API reference and KooCLI user guide. Review DR pairing and AZ layout in the console.
37
+
38
+ ## Cost
39
+
40
+ **No live command:** billing lives in the Billing Center and BSS, not the GeminiDB resource API; no read-only BSS operation was fetched and cited.
41
+
42
+ ## Monitoring
43
+
44
+ **No live command:** Cloud Eye alarm and metric reads were not fetched and cited in this pass; review alarms in the Cloud Eye console.
45
+
46
+ ## Performance
47
+
48
+ **No live command:** no control-plane CLI command documented for slow query or key analysis that was fetched and cited; use the console.
49
+
50
+ ## IAM
51
+
52
+ **No live command:** identity reads are secret-adjacent or were not fetched; review policy attachments for the audit principal in the IAM console.
53
+
54
+ ## Tagging
55
+
56
+ **No live command:** no tag-listing operation was fetched and cited; read instance tags in the console.
57
+
58
+ ## Encryption
59
+
60
+ **No live command:** no documented CLI command was fetched and cited; check disk encryption and the DEW key in the console (status cannot change after purchase).
61
+
62
+ ## Network isolation
63
+
64
+ **No live command:** no documented CLI command was fetched and cited; check security group, EIP and NAT bindings in the console.
65
+
66
+ ## Audit logging
67
+
68
+ **No live command:** CTS trace reads were not fetched and cited; query traces in the CTS console.
@@ -0,0 +1,108 @@
1
+ # audit --mode offline
2
+
3
+ No cloud CLI, network call, credential or customer data. Inputs are the repository
4
+ (IaC, application config, client code) and sanitized exports supplied by the user.
5
+ Commands are local only. Checks follow [the operations reference](../../operations.md).
6
+ Patterns are case-insensitive and cover API and snake_case spellings; adapt them to
7
+ the IaC provider in use rather than assuming an attribute name.
8
+
9
+ ## Backup and restore
10
+
11
+ - Automated backup policy present with `keep_days` and `start_time` set deliberately, not left to a default [GDB-E102].
12
+ - Manual-backup and restore runbooks: restore creates a new instance, never in place [GDB-E106].
13
+ - Incremental/PITR, table-level and cross-region backup need a service ticket; flag IaC that assumes them [GDB-E104] [GDB-E110].
14
+ - Cross-region backup is unsupported with disk encryption [GDB-E112].
15
+
16
+ ```bash
17
+ rg -n -i 'backup_strategy|keep.?days|start.?time|backup.?(policy|period)|recycle' --glob '*.tf' --glob '*.json' --glob '*.yaml' --glob '*.md' .
18
+ ```
19
+
20
+ ## Disaster recovery and replication
21
+
22
+ - Nodes spread across three AZs where DR matters [GDB-E120].
23
+ - Intra-region and cross-region DR are OBT and ticket-gated; check dependence on them [GDB-E115] [GDB-E119].
24
+ - Clients handle a DR switch by moving to the new connection address [GDB-E117].
25
+ - No RPO/RTO figure is documented; flag any hard-coded target as unsupported [GDB-E122].
26
+
27
+ ```bash
28
+ rg -n -i 'availability.?zone|\bazs?\b|dual.?active|disaster|failover|contact.?points|connection.?address' --glob '*.tf' --glob '*.json' --glob '*.yaml' --glob '*.properties' .
29
+ ```
30
+
31
+ ## Cost
32
+
33
+ - Billing mode (prepaid vs pay-per-use) and node specification are explicit [GDB-E124] [GDB-E123].
34
+ - Storage autoscaling has a capped storage limit [GDB-E125].
35
+ - Backup space above the free allowance, EIP and NAT gateway resources are accounted for [GDB-E10] [GDB-E126].
36
+
37
+ ```bash
38
+ rg -n -i 'pay.?mode|charging|period|auto.?(expansion|scal)|disk.?auto|flavor|spec.?code|bandwidth|\beip\b' --glob '*.tf' --glob '*.json' --glob '*.yaml' .
39
+ ```
40
+
41
+ ## Monitoring
42
+
43
+ - Cloud Eye alarms on namespace `SYS.NoSQL` for storage, CPU, memory, latency and pending tasks [GDB-E127] [GDB-E128].
44
+ - Event alarms for faulty instance/node, primary-standby switch and backup failure [GDB-E129].
45
+ - BigKey/HotKey events alarmed [GDB-E130]; slow query timeout set [GDB-E131].
46
+
47
+ ```bash
48
+ rg -n -i 'SYS\.NoSQL|cassandra[0-9]{3}_|nosql[0-9]{3}_|NoSQLFaulty|slow_query_log|alarm' --glob '*.tf' --glob '*.json' --glob '*.yaml' .
49
+ ```
50
+
51
+ ## Performance
52
+
53
+ - Client code and models keep partitions under 100,000 rows or 100 MB and rows within 64 KB [GDB-E05] [GDB-E04].
54
+ - Prefer TTL over mass deletes; no reliance on transactions [GDB-E07] [GDB-E06].
55
+ - Node count at most 50 with N/2 spare headroom [GDB-E08].
56
+
57
+ ```bash
58
+ rg -n -i 'using ttl|default_time_to_live|\bdelete from\b|\bblob\b|batch|if not exists' --glob '*.cql' --glob '*.java' --glob '*.py' --glob '*.go' --glob '*.ts' .
59
+ ```
60
+
61
+ ## IAM
62
+
63
+ - Identity uses `GeminiDB ReadOnlyAccess` for review and avoids blanket FullAccess [GDB-E09] [GDB-E134].
64
+ - Deny on `nosql:instance:delete` alongside broad grants [GDB-E134].
65
+ - Autoscaling agency actions are granted deliberately [GDB-E136].
66
+
67
+ ```bash
68
+ rg -n -i 'GeminiDB (FullAccess|ReadOnlyAccess)|nosql:[a-z]+:[a-z*]+|gaussdbfornosql|"Action"|"Effect"' --glob '*.tf' --glob '*.json' --glob '*.yaml' .
69
+ ```
70
+
71
+ ## Tagging
72
+
73
+ - Tags set at creation, at most 20 per instance, one value per key [GDB-E138] [GDB-E139].
74
+ - No access decision relies on tags alone [GDB-E140].
75
+
76
+ ```bash
77
+ rg -n -i 'tags?\b|tag_key|tag_value' --glob '*.tf' --glob '*.json' --glob '*.yaml' .
78
+ ```
79
+
80
+ ## Encryption
81
+
82
+ - Disk encryption selected at purchase with a DEW key; cannot be changed later [GDB-E141].
83
+ - Key lifecycle controls prevent disable or deletion of an in-use key [GDB-E142].
84
+ - SSL enabled in client config, TLS 1.2 or later [GDB-E143].
85
+
86
+ ```bash
87
+ rg -n -i 'disk.?encrypt|kms|cmk|\bssl\b|\btls\b|truststore|enable_ssl' --glob '*.tf' --glob '*.json' --glob '*.yaml' --glob '*.properties' --glob '*.java' --glob '*.py' .
88
+ ```
89
+
90
+ ## Network isolation
91
+
92
+ - No EIP bound to nodes; prefer a NAT gateway [GDB-E144] [GDB-E146].
93
+ - Security group inbound rules are narrow and not 0.0.0.0/0 [GDB-E145] [GDB-E147].
94
+ - Non-default port used [GDB-E147].
95
+
96
+ ```bash
97
+ rg -n -i 'security_group_id|security.?group|0\.0\.0\.0/0|\beip\b|public.?ip|vpc_id|subnet_id|\bport\b' --glob '*.tf' --glob '*.json' --glob '*.yaml' .
98
+ ```
99
+
100
+ ## Audit logging
101
+
102
+ - CTS tracker configured for control-plane operations; console keeps seven days [GDB-E149] [GDB-E150].
103
+ - LTS log shipping referenced where audit/slow logs are required [GDB-E152].
104
+ - Do not claim data-plane audit; none is documented for Cassandra [GDB-E151].
105
+
106
+ ```bash
107
+ rg -n -i '\bcts\b|tracker|\blts\b|log.?group|log.?stream|audit' --glob '*.tf' --glob '*.json' --glob '*.yaml' .
108
+ ```
@@ -0,0 +1,23 @@
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
+ - Service: Huawei Cloud GeminiDB, Cassandra API (cluster instances).. Other GeminiDB APIs are out of scope.
10
+ - Select sections of [the operations reference](../operations.md); unselected sections are out of scope.
11
+ - An audit is a technical risk review, not a compliance attestation.
12
+ - Selecting live mode collects nothing and grants no permission; an authorized
13
+ operator must run any command.
14
+
15
+ ## Findings
16
+
17
+ For each finding give: severity, section, evidence (file:line, or sanitized command
18
+ output with its retrieval time), the expectation from the operations reference with
19
+ its evidence ID, impact, the smallest proposed fix and how to verify it.
20
+
21
+ - PASS only for a check actually performed. Missing evidence is UNVERIFIED.
22
+ - An absent repository setting does not prove the live setting is off.
23
+ - Propose fixes; never apply them as part of the audit.
@@ -0,0 +1,83 @@
1
+ # Evidence ledger — Huawei Cloud GeminiDB
2
+
3
+ Every material claim in [geminidb-design-guide.md](geminidb-design-guide.md)
4
+ cites one row below as `[GDB-Exx]`. `tests/validate-skill-references.py` fails
5
+ the build if a citation has no row, a row is never cited, or a source is not on
6
+ support.huaweicloud.com.
7
+
8
+ Scope: **GeminiDB** (multi-model NoSQL), with design depth for the **GeminiDB
9
+ Cassandra API**. DDS (Document Database Service) is covered by
10
+ `huawei-gaussdb-rds-dba`. `VERIFIED` = the section was retrieved on the
11
+ retrieval date and supports the claim as worded; it is documentation
12
+ verification, not a behavioral test. Provider marketing statements are recorded
13
+ as claims to test, not as proven behavior.
14
+
15
+ | ID | Claim | Source | Section | Retrieved | Status |
16
+ | --- | --- | --- | --- | --- | --- |
17
+ | GDB-E01 | GeminiDB is a distributed, multi-model NoSQL service with decoupled storage and compute, compatible with Redis, DynamoDB, Cassandra, HBase, InfluxDB and MongoDB APIs. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_introduction.html> | What Is GeminiDB? | 2026-11-08 | VERIFIED |
18
+ | GDB-E02 | The GeminiDB Mongo API has reached End of Support: new instances cannot be created, no technical support (features, vulnerability fixes, patches, tickets) is provided, and its SLA no longer applies. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_introduction.html> | Note on GeminiDB Mongo API | 2026-11-08 | VERIFIED |
19
+ | GDB-E03 | API selection: Redis API (key-value), DynamoDB-Compatible API (key-value, over HTTPS; Huawei describes it as completely compatible with Amazon DynamoDB for migration without refactoring), Cassandra API (wide-column, CQL), HBase API (wide-column), Influx API (time series). | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_introduction.html> | How Do I Select an API? | 2026-11-08 | VERIFIED |
20
+ | GDB-E04 | GeminiDB Cassandra rules: storing BLOBs in the database is not recommended (use OBS or dedicated file storage); a row's key plus value at most 64 KB and average row size at most 10 KB; define data-deletion policies so data does not accumulate without bound. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_11_0205.html> | Basic Design, Rules 1-3 | 2026-11-08 | VERIFIED |
21
+ | GDB-E05 | Partition keys must distribute workload evenly to avoid data skew, BigKey (too much data in one partition, up to OOM) and HotKey (bursty access to one key) issues; one partition key may hold at most 100,000 rows and 100 MB. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_11_0205.html> | Basic Design, Rules 4-6 | 2026-11-08 | VERIFIED |
22
+ | GDB-E06 | GeminiDB Cassandra writes are strongly consistent, including concurrent writes and across tables, but transactions are not supported; DRS migration is eventually consistent. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_11_0205.html> | Basic Design, Rule 7 | 2026-11-08 | VERIFIED |
23
+ | GDB-E07 | Keep an instance at or below 50 nodes and shard vertically or horizontally beyond that; avoid tombstones by using TTL instead of mass deletes, deleting by primary key, deleting at most 1,000 rows at a time within a partition key, and not repeatedly deleting large ranges in one partition. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_11_0205.html> | Basic Design, Rules 8-9 | 2026-11-08 | VERIFIED |
24
+ | GDB-E08 | Sizing guidance: recommended no more than 50 billion records per table, no more than 100 tables per database and 20-50 fields per table; add N/2 redundant nodes for fault scenarios and keep per-node CPU at or below 50% under typical load. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_11_0205.html> | Design Suggestions 1-2 | 2026-11-08 | VERIFIED |
25
+ | GDB-E09 | IAM system policies for GeminiDB (project-level): `GeminiDB FullAccess` (full permissions) and `GeminiDB ReadOnlyAccess` (read-only). | <https://support.huaweicloud.com/intl/en-us/usermanual-permissions/iam_01_0001.html> | System-defined Policies/Roles | 2026-11-08 | VERIFIED |
26
+ | GDB-E10 | Billing is instance specifications plus storage, optional backup storage beyond a free allowance equal to purchased storage (then OBS rates), and public-network traffic; modes are pay-per-use (hourly) or yearly/monthly and can be switched. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_01_0100.html> | Billing | 2026-11-08 | VERIFIED |
27
+ | GDB-E11 | Per-request CQL consistency levels, fine-grained (custom) GeminiDB permissions, region availability and SDK/driver versions were not retrieved in this pass. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_introduction.html> | What Is GeminiDB? | 2026-11-08 | UNVERIFIED |
28
+ | GDB-E12 | GeminiDB Cassandra supports automated backups (retention set in days, deleted on expiry) and manual full backups (kept until deleted, even after instance deletion); full and incremental backups are enabled by default; backup data cannot be downloaded or exported; cross-region backups store automated full backups in a destination region for restore to a new instance there. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0229.html> | Data Backup overview | 2026-11-08 | VERIFIED |
29
+ | GDB-E13 | Point-in-time restore replays incremental backups over the last full backup, requires the automated backup policy to be enabled, and restores into a new, independent instance with the same API, type, version and CPU type. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0116.html> | Restoring to a Specified Point in Time | 2026-11-08 | VERIFIED |
30
+ | GDB-E101 | GeminiDB Cassandra manual backups are user-initiated full backups kept until deleted; automated backups follow a policy (time window, cycle, retention) and cannot be deleted manually while the policy is enabled. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0229.html> | Overview, Backup Methods: "Manual backups are user-initiated full backups of DB instances and can be retained until you manually delete them." | 2026-11-08 | VERIFIED |
31
+ | GDB-E102 | Automated backup retention defaults to seven days and can be set from 1 to 3,660 days; full backups start within one hour of the scheduled window; a retention shorter than seven days still backs up daily. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0518.html> | Automated Backup Policy: "Automated backup files are saved for seven days by default. You can set the retention period from 1 to 3,660 days." | 2026-11-08 | VERIFIED |
32
+ | GDB-E103 | Incremental backups are generated every 15 minutes once enabled; differential type restores to a specified point in time and PITR type to any point in time. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0518.html> | Automated Backup Policy: "Incremental Backup Interval: Incremental backups are generated every 15 minutes." | 2026-11-08 | VERIFIED |
33
+ | GDB-E104 | Enabling incremental backup, and PITR backup, requires submitting a service ticket to Huawei Cloud customer service. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0518.html> | Usage Notes: "To enable PITR backup, submit a service ticket on the console to contact the customer service." | 2026-11-08 | VERIFIED |
34
+ | GDB-E105 | CONFLICT on automated backup retention: the Cassandra page says Retention Period can be set from 1 to 3,660 days (quote: Automated backup files are saved for seven days by default. You can set the retention period from 1 to 3,660 days.) while the GeminiDB Security > Fault Recovery page says backups are stored for a preset retention period of 1 to 35 days (quote: The backups are stored based on the preset retention period (1 to 35 days).). The Cassandra-specific page is used for this skill; the 1-35 day figure is not applied to Cassandra. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0518.html> | Automated Backup Policy: "Automated backup files are saved for seven days by default. You can set the retention period from 1 to 3,660 days." | 2026-11-08 | CONFLICT |
35
+ | GDB-E106 | Restoring a Cassandra backup always creates a new, independent instance: restoration to the current instance is not supported, the new instance needs at least the original node count and storage, and the administrator password must be reset. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0009.html> | Restoring to a New Instance, Precautions: "Restoration to the current instance is not supported." | 2026-11-08 | VERIFIED |
36
+ | GDB-E107 | A restored instance uses the same parameter group as the original and keeps the same API type and engine version, which cannot be changed. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0009.html> | Restoring to a New Instance, Precautions: "The restored instance uses the same parameter group as the original instance." | 2026-11-08 | VERIFIED |
37
+ | GDB-E108 | GeminiDB Mongo API (End of Support) documents restoration to a new or an existing instance, whereas the Cassandra pages document restoration to a new instance only; the Mongo behaviour is not applied to Cassandra. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_01_0060.html> | Fault Recovery: "For details about how to restore GeminiDB Mongo instance data, see Restoring Data to a New or an Existing Instance." | 2026-11-08 | VERIFIED |
38
+ | GDB-E109 | Database- and table-level PITR restores selected databases or tables (at most 50) into a new instance and requires an incremental backup policy; the original instance data is not affected. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0180l.html> | Restoring Databases or Tables to a Specified Point in Time, Precautions: "Only databases and tables can be restored to a new instance at a specified time point." | 2026-11-08 | VERIFIED |
39
+ | GDB-E110 | Table-level backups need a service ticket to enable, can be automated or manual, and automated table-level retention ranges from 1 to 732 days. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0135.html> | Managing Database-/Table-level Backups, Usage Notes: "To enable the table-level backup, choose Service Tickets > Create Service Ticket in the upper right corner of the console and contact the customer service." | 2026-11-08 | VERIFIED |
40
+ | GDB-E111 | Cross-region backup replicates only automated full backups to one destination region (retention 1 to 1825 days), needs a service ticket, and is available only for instances with classic storage. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0007.html> | Managing Cross-Region Backups, Usage Notes: "Currently, this function is available only for GeminiDB Cassandra instances with classic storage." | 2026-11-08 | VERIFIED |
41
+ | GDB-E112 | Cross-region backup is not supported for instances with disk encryption enabled. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0007.html> | Managing Cross-Region Backups, Restoring from a cross-region backup: "Cross-region backup is not supported for instances with disk encryption enabled." | 2026-11-08 | VERIFIED |
42
+ | GDB-E113 | The recycle bin is enabled by default, cannot be disabled, keeps backups of deleted instances for seven days by default and is free; an instance can be rebuilt from a recycle-bin backup. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0201.html> | Using the GeminiDB Cassandra Instance Recycle Bin, Usage Notes: "The recycle bin is enabled by default and cannot be disabled. By default, backups in the recycle bin are retained for seven days." | 2026-11-08 | VERIFIED |
43
+ | GDB-E114 | Backup upload consumes resources on the instance: CPU usage may rise by 5% to 15%, memory by about 300 MB, and per-node upload bandwidth to OBS is 20 to 70 MB/s. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0518.html> | Usage Notes: "CPU usage may increase by 5% to 15% due to the additional resource consumption during backup upload." | 2026-11-08 | VERIFIED |
44
+ | GDB-E115 | Intra-region DR (a primary instance with one DR instance) is in OBT and requires a service ticket; the DR instance needs more than half the primary node count and at least three nodes. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0079.html> | Creating a DR Instance, Usage Notes: "This function is now in OBT. To use it, choose Service Tickets > Create Service Ticket in the upper right corner of the console and contact the customer service." | 2026-11-08 | VERIFIED |
45
+ | GDB-E116 | DR instance synchronization does not support Lucene indexes, Cassandra views, counter tables or TRUNCATE. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0079.html> | Creating a DR Instance, Usage Notes: "The DR instance synchronization does not support Lucene indexes, Cassandra views, counter tables, or TRUNCATE." | 2026-11-08 | VERIFIED |
46
+ | GDB-E117 | Intra-region DR switchover is condition-driven: the DR instance is promoted to primary when the configured faulty-node percentage (50 to 100 percent) and optional synchronization-latency threshold are met, after which applications must update the connection address. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0083.html> | Configuring DR Switchover Conditions, Scenarios: "If the primary instance fails due to an unexpected disaster and the specified switchover conditions are met, the DR instance is promoted to primary." | 2026-11-08 | VERIFIED |
47
+ | GDB-E118 | Cross-region dual-active DR provides bidirectional synchronization between two Cassandra instances in different regions; each instance can serve requests and the surviving one takes over on failure. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0701.html> | Overview: "GeminiDB Cassandra supports cross-region dual-active DR and bidirectional synchronization between two instances at different sites." | 2026-11-08 | VERIFIED |
48
+ | GDB-E119 | Cross-region dual-active DR is in OBT, needs a service ticket, is limited to classic storage, requires an empty target instance in a different CIDR block with equal or higher specifications and the same administrator password, and does not synchronize Lucene indexes, views, counter tables or TRUNCATE. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0702.html> | Creating an Active-Active Relationship, Usage Notes: "This function is only available to instances with classic storage." | 2026-11-08 | VERIFIED |
49
+ | GDB-E120 | Instances can be deployed in a single AZ or across three AZs with nodes evenly distributed for disaster recovery. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0002.html> | Buying a GeminiDB Cassandra Instance, AZ: "If you want to deploy an instance across AZs for disaster recovery, select three AZs." | 2026-11-08 | VERIFIED |
50
+ | GDB-E121 | GeminiDB Cassandra API uses a DFV pool with three-copy storage and lists intra-region DR, cross-region dual-active DR, multi-AZ deployment, N-1 fault tolerance and autoscaling as resilience measures. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_01_0057.html> | Resilience: "GeminiDB Cassandra API uses the DFV pool with three-copy storage and supports 24/7 online writes." | 2026-11-08 | VERIFIED |
51
+ | GDB-E122 | No numeric RPO, RTO or availability SLA percentage was found for GeminiDB Cassandra in the product, DR, FAQ or security pages searched; the FAQ only gives the availability formula as one minus failure duration over total service duration. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/cassandra_faq_0003.html> | What Is GeminiDB Cassandra Instance Availability?: "DB instance availability = (1 – Failure duration/Total service duration) × 100%" | 2026-11-08 | UNVERIFIED |
52
+ | GDB-E123 | Cassandra billing items are instance specifications (vCPUs and memory), storage space, backup space beyond the free quota, and public network (EIP) bandwidth or traffic. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0146.html> | Billing Items: "You will be billed for instance specifications, storage space, backup space, and EIP bandwidths." | 2026-11-08 | VERIFIED |
53
+ | GDB-E124 | Billing modes are yearly/monthly (prepaid) and pay-per-use, and the mode can be changed later. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0141.html> | Billing Overview: "Pay-per-use: You can start using the GeminiDB instance first and then pay as you go." | 2026-11-08 | VERIFIED |
54
+ | GDB-E125 | Storage autoscaling is charged for the storage it adds and needs an account balance and the RDSAccessProjectResource agency. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_cassandra_storage.html> | Configuring Storage Autoscaling, Usage Notes: "After autoscaling is enabled, you are automatically charged based on the amount of storage added." | 2026-11-08 | VERIFIED |
55
+ | GDB-E126 | A public NAT gateway and its EIP are billed separately; an EIP left after unbinding a pay-per-use gateway address keeps incurring charges until released. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0013.html> | Binding a Public Gateway Address, Usage Notes: "After the public gateway is unbound from a GeminiDB Cassandra instance, the associated EIP is retained." | 2026-11-08 | VERIFIED |
56
+ | GDB-E127 | Cassandra metrics are reported to Cloud Eye in namespace SYS.NoSQL with dimensions cassandra_cluster_id and cassandra_node_id at 1-minute raw granularity, for example nosql005_disk_usage, cassandra001_cpu_usage, cassandra002_mem_usage, cassandra015_read_latency, cassandra016_write_latency, cassandra037_pending_write. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0011.html> | Supported Metrics: "This section describes GeminiDB Cassandra API metrics reported to Cloud Eye as well as their namespaces and dimensions." | 2026-11-08 | VERIFIED |
57
+ | GDB-E128 | Recommended alarms: storage usage, CPU usage and memory usage above 80% for 3 consecutive periods; read and write latency above 900 ms; pending read or write tasks above 3,000, all Major severity. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_01_0018.html> | Suggestions on Alarm Rules of GeminiDB Cassandra Instance Metrics: "This section describes recommended alarm rules of GeminiDB Cassandra instances." | 2026-11-08 | VERIFIED |
58
+ | GDB-E129 | Cloud Eye event monitoring covers events in namespace SYS.NoSQL such as NoSQLFaultyDBInstance, NoSQLFaultyDBNode, NoSQLPrimaryStandbySwitched and backup-failure events. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0033.html> | Supported Events: "Event monitoring provides data collection, query, and alarm reporting for events." | 2026-11-08 | VERIFIED |
59
+ | GDB-E130 | BigKey and HotKey detection raises events that can be alarmed on in Cloud Eye; a key accessed more than 100,000 times per minute is a HotKey, and a partition over 100,000 rows or 100 MB is a BigKey. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/cassandra_faq_0030.html> | How Do I Detect and Resolve BigKey and HotKey Issues?: "GeminiDB Cassandra supports BigKey detection and alarms. On the Cloud Eye console, you can configure BigKey alarms for instances." | 2026-11-08 | VERIFIED |
60
+ | GDB-E131 | Slow query logs record statements slower than slow_query_log_timeout_in_ms (default 500 ms) and up to 2,000 logs can be exported at a time. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0028.html> | Viewing and Exporting Slow Query Logs, Scenarios: "Slow query logs record statements whose execution time exceeds the slow_query_log_timeout_in_ms threshold" | 2026-11-08 | VERIFIED |
61
+ | GDB-E132 | Enabling SSL prolongs connection response time and increases CPU usage, and the change requires an instance restart. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_ssl_0002.html> | Encrypting Data over SSL, Usage Notes: "Enabling SSL will prolong network connection response and increase CPU usage." | 2026-11-08 | VERIFIED |
62
+ | GDB-E133 | IAM supports role/policy-based authorization and identity policy-based authorization; the two models are not interoperable and Huawei recommends identity policy-based authorization. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_01_0011.html> | GeminiDB Permission Management: "IAM supports role/policy-based authorization and identity policy-based authorization." | 2026-11-08 | VERIFIED |
63
+ | GDB-E134 | A custom policy using the nosql:instance:delete action can deny instance deletion for a user who holds GeminiDB FullAccess; Deny takes precedence over Allow. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_04_0002.html> | Using IAM Roles or Policies, Example Custom Policies: "If you grant the GeminiDB FullAccess system policy to a user but do not want the user to delete GeminiDB instances" | 2026-11-08 | VERIFIED |
64
+ | GDB-E135 | Identity-policy custom policies use the gaussdbfornosql action prefix with Resource and service-specific Condition elements, and the system identity policy GeminiDBReadOnlyPolicy is available. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_04_0044.html> | Using IAM Identity Policies, Example Custom Identity Policies: "When creating a custom identity policy, use the Resource element to specify the resources the identity policy applies to" | 2026-11-08 | VERIFIED |
65
+ | GDB-E136 | Storage autoscaling for IAM users needs GeminiDB FullAccess plus IAM agency actions (iam:agencies:createAgency and related) or the Security Administrator role. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_01_0011.html> | GeminiDB Permission Management, Role/Policy-based Authorization: "To use storage autoscaling, configure the following actions for IAM users:" | 2026-11-08 | VERIFIED |
66
+ | GDB-E137 | The database administrator account is rwuser with an 8 to 32 character password; the pages read did not document per-user CQL roles or data-plane RBAC. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_11_1215.html> | Constraints, Security: "Can contain at least two types of the following characters: uppercase letters, lowercase letters, digits, and special characters" | 2026-11-08 | VERIFIED |
67
+ | GDB-E138 | Instances can be tagged when or after creation through Tag Management Service; at most 20 tags per instance, one value per key. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0014.html> | Managing GeminiDB Cassandra Instance Tags, Usage Notes: "A maximum of 20 tags can be added for each instance." | 2026-11-08 | VERIFIED |
68
+ | GDB-E139 | Tag keys are up to 128 characters and values up to 255 characters, and tags can be set when buying an instance and used to search instances. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0014.html> | Managing GeminiDB Cassandra Instance Tags: "Adding tags to GeminiDB Cassandra instances helps you better identify and manage them." | 2026-11-08 | VERIFIED |
69
+ | GDB-E140 | The GeminiDB IAM pages searched do not state that tag conditions can scope Cassandra permissions; identity policies mention only service-specific condition keys without listing tag keys. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_04_0044.html> | Using IAM Identity Policies, Example Custom Identity Policies: "use the Condition element (service-specific condition keys) to control when the identity policy is in effect" | 2026-11-08 | UNVERIFIED |
70
+ | GDB-E141 | Disk encryption is chosen when buying an instance (Disable means data is not encrypted; Enable stores data in ciphertext using a key from Data Encryption Workshop), and the encryption status and key cannot be changed afterwards. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0002.html> | Buying a GeminiDB Cassandra Instance, Disk Encryption: "After an instance is created, the disk encryption status and the key cannot be changed." | 2026-11-08 | VERIFIED |
71
+ | GDB-E142 | The key used for disk encryption cannot be disabled, deleted or frozen while in use, otherwise the database becomes unavailable; a shared key from another account needs an agency and RAM sharing. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0002.html> | Buying a GeminiDB Cassandra Instance, Disk Encryption: "The key cannot be disabled, deleted, or frozen when being used. Otherwise, the database becomes unavailable." | 2026-11-08 | VERIFIED |
72
+ | GDB-E143 | SSL for GeminiDB Cassandra supports only TLS 1.2 or later; instances offer both non-SSL and SSL connection modes. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_ssl_0002.html> | Encrypting Data over SSL, Usage Notes: "The SSL function of GeminiDB Cassandra API supports only TLS 1.2 or later. TLS 1.0 and TLS 1.1 are not supported." | 2026-11-08 | VERIFIED |
73
+ | GDB-E144 | GeminiDB Cassandra instances are reachable only over a private network by default; public access needs an EIP on a node or a public NAT gateway address. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0009.html> | Connecting to a GeminiDB Cassandra Instance over a Public Network, Scenarios: "By default, GeminiDB Cassandra instances are accessible only over a private network to help ensure data security and access efficiency." | 2026-11-08 | VERIFIED |
74
+ | GDB-E145 | Security groups control inbound access (TCP only); one security group can be associated with only one Cassandra instance. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0004.html> | Setting a Security Group Rule for a GeminiDB Cassandra Instance, Usage Notes: "One security group can be associated with only one GeminiDB Cassandra instance." | 2026-11-08 | VERIFIED |
75
+ | GDB-E146 | A public gateway address uses a one-way DNAT rule on a public NAT gateway so only configured inbound ports reach the instance private IP; EIPs bound directly to nodes increase security risk. Gateway binding is limited to classic storage. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_02_0013.html> | Binding a Public Gateway Address, Scenarios: "With a NAT gateway, public access is implemented as a one-way DNAT rule on the public NAT gateway" | 2026-11-08 | VERIFIED |
76
+ | GDB-E147 | Security best practice: do not bind EIPs to instances for Internet access, deploy on an internal network behind routers or firewalls, and change the default port 8635. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_01_0019.html> | Security Best Practices, Avoiding Binding EIPs: "Do not bind EIPs to GeminiDB Cassandra instances for Internet access." | 2026-11-08 | VERIFIED |
77
+ | GDB-E148 | No VPC endpoint (VPCEP) or private-link access path for GeminiDB Cassandra was found in the Cassandra user guide or security pages searched. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_01_0054.html> | Identity Authentication and Access Control: "A VPC is a logically isolated, configurable, and manageable virtual network." | 2026-11-08 | UNVERIFIED |
78
+ | GDB-E149 | CTS records operations on GeminiDB Cassandra instances (for example NoSQLCreateInstance, NoSQLDeleteInstance, NoSQLCreateBackup, NoSQLSetBackupPolicy, NoSQLAddTags) for query, audit and backtracking. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0017.html> | Key GeminiDB Cassandra Operations Supported by CTS: "With CTS, you can record operations on GeminiDB Cassandra instances for later queries, audit, and backtracking." | 2026-11-08 | VERIFIED |
79
+ | GDB-E150 | The CTS console keeps the last seven days of operation records. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_03_0018.html> | Querying Traces: "The CTS console stores the last seven days of operation records." | 2026-11-08 | VERIFIED |
80
+ | GDB-E151 | The GeminiDB security overview says CTS can record management and data traces of GeminiDB, but the Cassandra CTS page lists only management operations on instances, backups, tags and parameter templates. | <https://support.huaweicloud.com/intl/en-us/productdesc-nosql/nosql_01_0056.html> | Audit and Logs: "After you enable CTS and configure a tracker, CTS can record management and data traces of GeminiDB for auditing." | 2026-11-08 | VERIFIED |
81
+ | GDB-E152 | Cassandra best practices state that after access logs are configured, audit, error and slow query logs are uploaded to LTS; no Cassandra page describing how to enable audit logs was found. | <https://support.huaweicloud.com/intl/en-us/cassandraug-nosql/nosql_01_0019.html> | Security Best Practices, Configuring Instance Access Logs: "After access logs are configured, new audit, error, and slow query logs of GeminiDB Cassandra instances will be uploaded to LTS for management." | 2026-11-08 | VERIFIED |
82
+ | GDB-E901 | KooCLI calls cloud service API operations with commands of the form `hcloud [options] <service> <operation> [--param=value ...]`. | <https://support.huaweicloud.com/intl/en-us/productdesc-hcli/hcli_01_002.html> | Command: "Commands are operation instructions provided by KooCLI to configure the working environment or call open APIs of cloud services." | 2026-11-09 | VERIFIED |
83
+ | GDB-E902 | `hcloud configure list` queries the local KooCLI profile list and supports `--cli-output` and `--cli-query` filtering, so a profile check can omit credential fields. | <https://support.huaweicloud.com/intl/en-us/usermanual-hcli/hcli_03_004_01.html> | Querying System Parameters in the Profile List: "Run the following command to query system parameters in the profile list." | 2026-11-09 | VERIFIED |
@@ -0,0 +1,114 @@
1
+ # Huawei Cloud GeminiDB design guide
2
+
3
+ Load this for GeminiDB API selection, GeminiDB Cassandra API data modeling,
4
+ consistency, deletion and capacity rules, IAM or billing questions. Every
5
+ bracketed ID resolves in [evidence-ledger.md](evidence-ledger.md). Text without
6
+ an ID is labeled inference or recommendation.
7
+
8
+ GeminiDB is **one service with several compatible APIs** on a decoupled
9
+ storage/compute architecture [GDB-E01]. Treat "compatible" as API and driver
10
+ compatibility to test *(inference)*. It does not mean that open-source Cassandra, MongoDB or AWS
11
+ DynamoDB operational guarantees carry over. Verify each one.
12
+
13
+ ## API selection
14
+
15
+ | Need | API | Status | Evidence |
16
+ | --- | --- | --- | --- |
17
+ | Key-value, Redis protocol | GeminiDB Redis API | available | [GDB-E03] |
18
+ | Key-value, DynamoDB protocol (migration) | GeminiDB DynamoDB-Compatible API | available; "completely compatible" is a provider claim to test, not proven behavior | [GDB-E03] |
19
+ | Wide-column, CQL | GeminiDB Cassandra API | available | [GDB-E03] |
20
+ | Wide-column, HBase ecosystem | GeminiDB HBase API | available | [GDB-E03] |
21
+ | Time series | GeminiDB Influx API | available | [GDB-E03] |
22
+ | Document, MongoDB protocol | **GeminiDB Mongo API: End of Support** | no new instances, no support, no SLA | [GDB-E02] |
23
+
24
+ **Reject new designs on the GeminiDB Mongo API.** It has reached End of
25
+ Support [GDB-E02]. For MongoDB-compatible workloads use DDS, which is covered
26
+ by the `huawei-gaussdb-rds-dba` skill. Treat existing Mongo API instances as a
27
+ migration risk to schedule. *(recommendation)*
28
+
29
+ For the DynamoDB-Compatible API, require a compatibility test of every
30
+ operation, condition expression, index and consistency behavior the workload
31
+ uses before migration. Huawei's "completely compatible" statement [GDB-E03] is
32
+ not a substitute. *(recommendation)*
33
+
34
+ ## GeminiDB Cassandra API: data modeling rules
35
+
36
+ - **Row size:** key plus value at most 64 KB per row, average at most 10 KB.
37
+ Store BLOBs in OBS, not the database [GDB-E04].
38
+ - **Partition keys:** distribute load evenly. Avoid BigKey (too much data in
39
+ one partition, which can cause OOM) and HotKey (bursts on one key) [GDB-E05].
40
+ Hard caps per partition key: **100,000 rows and 100 MB** [GDB-E05]. Any
41
+ partition key that grows without bound (one per tenant, one per device
42
+ forever) breaks these. Put a time bucket or other bounding component in the
43
+ key. *(recommendation)*
44
+ - **Retention:** every table needs a data-deletion policy [GDB-E04]. Use TTL
45
+ instead of mass deletes. Delete by primary key, at most 1,000 rows at a time
46
+ within one partition key, and never repeatedly delete large ranges in one
47
+ partition, which causes tombstones [GDB-E07].
48
+ - **Scale:** keep an instance at or below 50 nodes, then shard vertically (by
49
+ functional module) or horizontally (splitting one large table's data across
50
+ databases) [GDB-E07]. Guidance limits are about 50
51
+ billion records per table, 100 tables per database and 20-50 fields per table
52
+ [GDB-E08].
53
+
54
+ ## Consistency and transactions
55
+
56
+ - Writes are **strongly consistent**, including concurrent writes and across
57
+ tables, but **no transactions** are supported [GDB-E06]. Multi-row or
58
+ multi-table invariants need application-level design (idempotency,
59
+ compensation). *(inference)*
60
+ - Migrations through DRS are eventually consistent [GDB-E06]. Cut-over plans
61
+ need a verification window.
62
+ - Per-request CQL consistency levels were not verified [GDB-E11]. Do not
63
+ assume open-source Cassandra's `ONE`/`QUORUM` semantics apply.
64
+
65
+ ## Capacity
66
+
67
+ Size for peak QPS and data growth, add **N/2 redundant nodes** for failure
68
+ scenarios, and keep per-node CPU at or below 50% under typical load [GDB-E08].
69
+ A design that runs at 80% CPU in steady state has no failover headroom.
70
+ *(inference)*
71
+
72
+ ## IAM
73
+
74
+ System policies are `GeminiDB FullAccess` and `GeminiDB ReadOnlyAccess`
75
+ [GDB-E09]. Give operators and reviewers ReadOnlyAccess by default, and grant
76
+ FullAccess only to the identities that manage instances, scoped to the
77
+ project. *(recommendation)* Custom fine-grained permissions were not verified
78
+ [GDB-E11].
79
+
80
+ ## Billing
81
+
82
+ Cost is instance specifications plus storage. On top of that come backup
83
+ storage beyond a free allowance equal to the purchased storage (then OBS
84
+ rates), and public-network traffic. Billing is pay-per-use (hourly) or
85
+ yearly/monthly, and the two can be switched [GDB-E10]. Prices are not in this
86
+ ledger. Cost numbers need a freshly fetched price page.
87
+
88
+ ## Backup and recovery
89
+
90
+ - Automated and manual backups exist, full and incremental are on by default,
91
+ and backup data **cannot be downloaded or exported** [GDB-E12]. Exports for
92
+ audit or offline copies need a separate data-export path. *(inference)*
93
+ - Cross-region backups keep automated full backups in another region for
94
+ restore to a **new instance** there [GDB-E12]. That is the documented
95
+ regional DR path.
96
+ - Point-in-time restore needs the automated backup policy enabled, and it
97
+ restores into a **new, independent instance** [GDB-E13]. Plan the client
98
+ cut-over. *(recommendation)*
99
+
100
+ ## Not verified
101
+
102
+ CQL consistency levels, custom permissions, region availability and driver
103
+ versions [GDB-E11]. Fetch the
104
+ official page or label the point an assumption.
105
+
106
+ ## When to push back
107
+
108
+ - Any new workload on the GeminiDB Mongo API [GDB-E02].
109
+ - DynamoDB-Compatible migration without a per-operation compatibility test.
110
+ - Unbounded partition keys, rows over 64 KB, or BLOBs in the database.
111
+ - Mass deletes instead of TTL, or no deletion policy at all.
112
+ - Instances planned beyond 50 nodes without sharding.
113
+ - Steady-state CPU above 50%, or no N/2 failure headroom.
114
+ - Transactions assumed on the Cassandra API.
@@ -0,0 +1,135 @@
1
+ # Huawei Cloud GeminiDB operations
2
+
3
+ Operational coverage for Huawei Cloud GeminiDB, Cassandra API (cluster instances). Every section uses the
4
+ same heading and states one status. Cite evidence rows from
5
+ [the evidence ledger](evidence-ledger.md) as `[GDB-Exx]`.
6
+ `tests/validate-nosql-operations.py` enforces this structure.
7
+
8
+ Statuses:
9
+
10
+ - `VERIFIED`: the provider documents the capability; every statement below cites a
11
+ VERIFIED row.
12
+ - `PARTIAL`: some of it is documented and some is not, or it is limited (by tier,
13
+ mode, Region or API); say which part is which.
14
+ - `UNSUPPORTED`: provider documentation states the capability does not exist. Cite it.
15
+ - `UNVERIFIED`: no official page settled it in this pass. Say what was searched.
16
+ - `NOT APPLICABLE`: the capability does not apply to this service. Say why.
17
+
18
+ Scope: the GeminiDB Cassandra API. GeminiDB is multi-model and its APIs differ in backup, DR and
19
+ logging features, so nothing below is generalised from another API. The Mongo API has reached End
20
+ of Support [GDB-E02]; DDS is covered in `huawei-gaussdb-rds-dba`. Monitoring is Cloud Eye, audit is
21
+ CTS, access control is IAM and keys are DEW (KMS), each checked below.
22
+
23
+ ## Backup and restore
24
+
25
+ **Status:** PARTIAL
26
+
27
+ Documented and usable: automated and manual backups. Gated or limited: incremental, PITR, table-level and cross-region backup.
28
+
29
+ - Automated and manual backups are supported; manual backups are full backups kept until deleted, even after the instance is deleted. Backups are OBS-hosted, cannot be downloaded or exported, and full plus incremental backups are enabled by default [GDB-E12] [GDB-E101].
30
+ - Automated retention defaults to 7 days with a policy-defined range of 1 to 3,660 days; a full backup starts within one hour of the window [GDB-E102]. CONFLICT: the generic GeminiDB Fault Recovery page says 1 to 35 days; this reference uses the Cassandra page and does not apply 1 to 35 days [GDB-E105].
31
+ - Incremental backups run every 15 minutes; differential type restores to a chosen point in time and PITR type to any point. The Cassandra page says enabling incremental or PITR backup needs a service ticket [GDB-E103] [GDB-E104].
32
+ - Restore always creates a new, independent instance (no in-place restore), with at least the original nodes and storage, same API, version and parameter group, and a new administrator password [GDB-E106] [GDB-E107] [GDB-E13]. The Mongo API differs and documents restore to an existing instance; that is not applied here [GDB-E108].
33
+ - Table-level backup needs a service ticket; database/table PITR restores up to 50 selected objects into a new instance [GDB-E110] [GDB-E109].
34
+ - Cross-region backup copies only automated full backups, needs a ticket, is classic-storage only and is unsupported with disk encryption [GDB-E111] [GDB-E112].
35
+ - A recycle bin (on by default, 7 days) lets you rebuild a deleted instance [GDB-E113]. Backup uploads cost CPU and bandwidth, so schedule off-peak windows [GDB-E114].
36
+
37
+ ## Disaster recovery and replication
38
+
39
+ **Status:** PARTIAL
40
+
41
+ Documented: multi-AZ deployment, intra-region DR and cross-region dual-active DR. Both DR modes are OBT (open beta) and ticket-gated, and no RPO, RTO or availability percentage was found.
42
+
43
+ - Nodes can be spread evenly across three AZs for DR; the storage layer keeps three copies and the service lists N-1 fault tolerance [GDB-E120] [GDB-E121].
44
+ - Intra-region DR pairs one primary with one DR instance. It is in OBT, needs a service ticket, and the DR instance needs more than half the primary nodes and at least three [GDB-E115]. Lucene indexes, views, counter tables and TRUNCATE are not synchronised [GDB-E116].
45
+ - Failover is condition-driven rather than manual-only: the DR instance is promoted when a configured faulty-node percentage and optional replication-latency limit are met, and applications must then switch to the new connection address [GDB-E117].
46
+ - Cross-region dual-active DR gives bidirectional synchronisation between two instances in different regions [GDB-E118]. It is OBT, classic storage only, needs an empty target with matching or larger specifications and the same administrator password [GDB-E119].
47
+ - UNVERIFIED: no numeric RPO, RTO or SLA figure was found in the DR, FAQ or security pages searched; only the availability formula is given [GDB-E122]. The Mongo API SLA no longer applies [GDB-E02].
48
+
49
+ ## Cost
50
+
51
+ **Status:** VERIFIED
52
+
53
+ Billing dimensions only. Official pricing: <https://www.huaweicloud.com/intl/en-us/pricing/index.html?tab=detail#/nosql> (GeminiDB Price Calculator, linked from the billing page).
54
+
55
+ - Billed dimensions are instance specifications (vCPUs and memory times node count), storage space, backup space above the free allowance, and public network bandwidth or traffic [GDB-E123] [GDB-E10].
56
+ - Free backup storage equals purchased storage; the excess is billed at OBS-based rates [GDB-E10].
57
+ - Modes are yearly/monthly (prepaid) and pay-per-use, and can be switched [GDB-E124] [GDB-E10].
58
+ - Storage autoscaling charges for the storage it adds, so cap the storage limit [GDB-E125].
59
+ - A public NAT gateway and EIP are separate billed resources, and an EIP kept after unbinding still bills if pay-per-use [GDB-E126].
60
+
61
+ ## Monitoring
62
+
63
+ **Status:** VERIFIED
64
+
65
+ Monitoring is Cloud Eye.
66
+
67
+ - Cassandra metrics go to Cloud Eye in namespace `SYS.NoSQL`, dimensions `cassandra_cluster_id,cassandra_node_id`, 1-minute raw period; examples are `nosql005_disk_usage`, `cassandra001_cpu_usage`, `cassandra002_mem_usage`, `cassandra015_read_latency`, `cassandra016_write_latency` and `cassandra037_pending_write` [GDB-E127].
68
+ - Recommended alarms: storage, CPU and memory above 80% for 3 periods; read or write latency above 900 ms; pending read or write tasks above 3,000; all Major [GDB-E128].
69
+ - Event monitoring in the same namespace covers `NoSQLFaultyDBInstance`, `NoSQLFaultyDBNode`, `NoSQLPrimaryStandbySwitched` and backup, resize and node failures; alarm on backup-failure events [GDB-E129].
70
+ - BigKey and HotKey detections surface as events and can be alarmed in Cloud Eye [GDB-E130].
71
+
72
+ ## Performance
73
+
74
+ **Status:** PARTIAL
75
+
76
+ Documented: data-model limits and signals. Not found: a throttling error code or provisioned-throughput model (capacity is node-based).
77
+
78
+ - Partition keys must spread load; a partition over 100,000 rows or 100 MB is a BigKey, and one key above 100,000 accesses per minute is a HotKey [GDB-E05] [GDB-E130].
79
+ - Keep rows within 64 KB (key plus value), avoid BLOBs, stay at or below 50 nodes, and prefer TTL over mass deletes to avoid tombstones [GDB-E04] [GDB-E07].
80
+ - Size for N/2 spare nodes and per-node CPU at or below 50% under typical load [GDB-E08]. Writes are strongly consistent but transactions are unsupported [GDB-E06].
81
+ - Slow query logging defaults to 500 ms (`slow_query_log_timeout_in_ms`) [GDB-E131].
82
+ - Backups and SSL both add load: backup upload raises CPU 5% to 15% and per-node upload is 20 to 70 MB/s; SSL raises CPU [GDB-E114] [GDB-E132].
83
+ - UNVERIFIED: no documented throttling or rate-limit error codes for Cassandra were found in the pages searched.
84
+
85
+ ## IAM
86
+
87
+ **Status:** PARTIAL
88
+
89
+ Control plane is documented; data-plane (CQL role) authorization is not.
90
+
91
+ - IAM supports role/policy-based and identity policy-based authorization (not interoperable; identity policies recommended) [GDB-E133].
92
+ - System policies are `GeminiDB FullAccess` and `GeminiDB ReadOnlyAccess`, project-level [GDB-E09]; the identity-policy equivalent includes `GeminiDBReadOnlyPolicy` with the `gaussdbfornosql` action prefix [GDB-E135].
93
+ - Least privilege: grant ReadOnlyAccess for review and use a custom Deny on `nosql:instance:delete` alongside FullAccess [GDB-E134].
94
+ - Autoscaling needs extra IAM agency actions or the Security Administrator role, so grant them deliberately [GDB-E136].
95
+ - Data plane: the administrator account is `rwuser`; per-user CQL roles were not documented in pages read [GDB-E137].
96
+
97
+ ## Tagging
98
+
99
+ **Status:** PARTIAL
100
+
101
+ - Instances support tags via Tag Management Service: up to 20 per instance, one value per key [GDB-E138].
102
+ - Key up to 128 and value up to 255 characters; settable at creation and searchable [GDB-E139].
103
+ - UNVERIFIED: tag-based access control for GeminiDB was not found; identity policies mention only service-specific condition keys [GDB-E140].
104
+
105
+ ## Encryption
106
+
107
+ **Status:** PARTIAL
108
+
109
+ Key service is DEW (KMS).
110
+
111
+ - Disk encryption is chosen at purchase using a key from Data Encryption Workshop; status and key cannot change afterwards [GDB-E141].
112
+ - The key must not be disabled, deleted or frozen while in use or the database becomes unavailable; shared keys need an agency [GDB-E142].
113
+ - Disk encryption excludes cross-region backups [GDB-E112].
114
+ - In transit, SSL is optional per instance and supports TLS 1.2 or later only [GDB-E143].
115
+ - UNVERIFIED: whether encryption at rest is on by default in every console flow, and key-type restrictions, were not stated on the pages read.
116
+
117
+ ## Network isolation
118
+
119
+ **Status:** PARTIAL
120
+
121
+ - Instances are private-network-only by default; public access needs an EIP on a node or a public NAT gateway address [GDB-E144].
122
+ - Security groups restrict inbound TCP; one security group can be associated with only one instance [GDB-E145].
123
+ - Prefer a public NAT gateway (one-way DNAT) to a node EIP, available for classic storage only [GDB-E146].
124
+ - Best practice: no Internet EIP, internal network behind firewalls, non-default port [GDB-E147].
125
+ - UNVERIFIED: no VPC endpoint (VPCEP) path for Cassandra was found [GDB-E148].
126
+
127
+ ## Audit logging
128
+
129
+ **Status:** PARTIAL
130
+
131
+ Audit is CTS for the control plane.
132
+
133
+ - CTS records Cassandra management operations such as create, delete, backup, tag and parameter changes [GDB-E149]; the console retains seven days [GDB-E150].
134
+ - The security overview mentions management and data traces, but the Cassandra CTS page lists management operations only [GDB-E151].
135
+ - Best practices say audit, error and slow query logs can be sent to LTS, but no Cassandra procedure for enabling audit logs was found [GDB-E152].
@@ -40,7 +40,7 @@ If the task is not Huawei Cloud-related, direct the user to the appropriate prov
40
40
  | `compute` | ECS instances, AS (Auto Scaling), IMS (images), DeH (Dedicated Host), CSBS snapshots |
41
41
  | `containers` | CCE (Cloud Container Engine), SWR (registry), ASM (Service Mesh), IEF (Intelligent Edge Fabric) |
42
42
  | `serverless` | FunctionGraph, ServiceStage, CSE (Spring Cloud/ServiceComb) |
43
- | `database` | GaussDB (MySQL/PG/Oracle), RDS, DDS (MongoDB-compatible), database proxy, HA architecture |
43
+ | `database` | GaussDB (MySQL/PG/Oracle), RDS, DDS (MongoDB-compatible), GeminiDB (NoSQL), database proxy, HA architecture |
44
44
  | `data-analytics` | DWS (GaussDB DWS), DLI (Spark/Flink), MRS, DataArts Studio |
45
45
  | `data-replication` | DRS (migration + real-time sync), CDM (batch ETL), DMS (Kafka) |
46
46
  | `ai-ml` | ModelArts training (GPU/NPU), Pangu foundation models, AI Gallery, MLOps pipelines |
@@ -66,6 +66,7 @@ If the task is not Huawei Cloud-related, direct the user to the appropriate prov
66
66
  | `huawei-cce-container-platform-operator-agent` | containers | Operating CCE clusters, SWR registries, ASM service mesh, IEF edge node management |
67
67
  | `huawei-functiongraph-serverless-operator-agent` | serverless | Deploying or operating FunctionGraph, ServiceStage applications, CSE microservice governance |
68
68
  | `huawei-gaussdb-rds-dba-agent` | database | Managing GaussDB (MySQL/PG/Oracle), RDS, DDS, database proxy, HA and backup architecture |
69
+ | `huawei-geminidb-architect-agent` | database | Reviewing GeminiDB API choice (Redis, DynamoDB-Compatible, Cassandra, HBase, Influx; Mongo API end of support), Cassandra API partition-key, deletion and sharding rules, failure-headroom capacity; static review only |
69
70
  | `huawei-dws-dli-data-analyst-agent` | data-analytics | Operating DWS data warehouse, DLI serverless Spark/Flink, MRS, DataArts Studio pipelines |
70
71
  | `huawei-drs-data-replication-operator-agent` | data-replication | Planning or executing DRS migrations/sync, CDM batch ETL jobs, DMS Kafka cluster operations |
71
72
  | `huawei-modelarts-mlops-engineer-agent` | ai-ml | Managing ModelArts training jobs (GPU/NPU cost governance), Pangu model deployment, MLOps pipelines |
@@ -54,6 +54,8 @@ Load these only when needed:
54
54
  - [Workflow and output contract](references/workflow-and-output.md) — use when executing the full lifecycle operation or formatting the final answer.
55
55
  - [Safety checklist](references/safety-checklist.md) — use before any database mutation; contains the hard-stop conditions that must all be confirmed before proceeding.
56
56
  - [Official sources](references/official-sources.md) — use when grounding IONOS DBaaS service behavior or checking the source list.
57
+ - [MongoDB operations](references/mongodb-operations.md) — MongoDB only: backup and restore, disaster recovery, billing dimensions, monitoring, performance, IAM, tagging, encryption, network isolation and audit logging, each cited to the evidence ledger.
58
+ - [Audit](references/commands/audit.md) — offline or live audit against the operations reference; load only when an audit is requested.
57
59
 
58
60
  ## Response minimum
59
61