@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,194 @@
1
+ # Oracle NoSQL Database Cloud Service design guide
2
+
3
+ Load this for table, key, consistency, capacity, limits, TTL, child-table,
4
+ Global Active table, backup or IAM questions. Every bracketed ID resolves in
5
+ [evidence-ledger.md](evidence-ledger.md). Anything without an ID is labeled
6
+ **inference** or **recommendation** and must be presented that way.
7
+
8
+ Do not import DynamoDB or Cosmos DB vocabulary. NDCS has *shard keys* (not
9
+ partition keys); *read units and write units*, which Oracle abbreviates RU and
10
+ WU but which are not DynamoDB RCUs/WCUs or Cosmos DB Request Units; and
11
+ *Global Active tables* (not DynamoDB global tables). Their guarantees differ.
12
+
13
+ ## Capability matrix
14
+
15
+ | Area | Status | What is verified | Evidence |
16
+ | --- | --- | --- | --- |
17
+ | Data model | SUPPORTED | Fixed-schema tables and schema-less JSON columns | [OCI-NOSQL-E14] |
18
+ | Primary / shard key | SUPPORTED | Shard key is a portion of the primary key; both are immutable after creation | [OCI-NOSQL-E02] [OCI-NOSQL-E04] |
19
+ | Read consistency | SUPPORTED | EVENTUAL or ABSOLUTE, per handle or per read; ABSOLUTE costs 2x read units | [OCI-NOSQL-E03] |
20
+ | Transactions | CONDITIONAL | ACID only across records sharing a shard key (or one parent-child hierarchy) | [OCI-NOSQL-E05] [OCI-NOSQL-E08] |
21
+ | Capacity | CONDITIONAL | Provisioned or On-Demand; 1 KB units; hard per-table caps; mode switch once per day | [OCI-NOSQL-E01] [OCI-NOSQL-E15] [OCI-NOSQL-E23] |
22
+ | Table limits | SUPPORTED | 5 indexes/table, 512 KB rows, 30 tables/region | [OCI-NOSQL-E24] |
23
+ | TTL | SUPPORTED | Table default plus per-row override, HOURS or DAYS | [OCI-NOSQL-E07] |
24
+ | Parent-child tables | SUPPORTED | Shared shard key, inherited primary key, no referential integrity | [OCI-NOSQL-E08] |
25
+ | Multi-region | CONDITIONAL | Global Active tables: async active-active, latest-timestamp wins, frozen schema; not in dedicated hosted environments | [OCI-NOSQL-E09] [OCI-NOSQL-E10] [OCI-NOSQL-E12] [OCI-NOSQL-E30] |
26
+ | Backup / restore | CONDITIONAL | Customer-run, via Oracle's migrator tool to Object Storage | [OCI-NOSQL-E30] |
27
+ | IAM | SUPPORTED | Verb-to-permission mapping on `nosql-rows`, `nosql-tables`, `nosql-indexes`; table-name scoping | [OCI-NOSQL-E13] [OCI-NOSQL-E29] |
28
+ | SDKs | CONDITIONAL | Java, Python, Node.js, Go, .NET verified; Spring Data and Rust repos exist but details unverified | [OCI-NOSQL-E16] [OCI-NOSQL-E21] [OCI-NOSQL-E32] [OCI-NOSQL-E33] |
29
+ | Private networking | CONDITIONAL | Service gateway path from a VCN (solution page); no NDCS-specific private endpoint found | [OCI-NOSQL-E34] [OCI-NOSQL-E22] |
30
+ | Customer-managed keys | CONDITIONAL | Dedicated environment only; AES-256 in OCI KMS; single-version keys only | [OCI-NOSQL-E35] |
31
+ | Pricing, quota increases | UNVERIFIED | Not found this pass; do not assert | [OCI-NOSQL-E22] |
32
+
33
+ ## Key design
34
+
35
+ The primary key and shard key are permanent [OCI-NOSQL-E04]. Treat key design
36
+ as a one-way door: a wrong shard key means a new table plus a data migration,
37
+ not an ALTER. That alone justifies refusing to approve a schema without an
38
+ access-pattern list. *(inference from E04)*
39
+
40
+ Shard key decision checklist [OCI-NOSQL-E05]:
41
+
42
+ 1. **Cardinality** — high-cardinality identifiers (`customerID`, `userID`)
43
+ spread data; low-cardinality fields (country, status) create hot shards.
44
+ 2. **Atomicity** — if a business operation must commit several records
45
+ atomically, those records must share a shard key. This pulls toward
46
+ *coarser* shard keys and directly conflicts with cardinality. Name the
47
+ trade-off explicitly; do not paper over it.
48
+ 3. **Uniform distribution** — no single shard should cap system capacity.
49
+ 4. **Query isolation** — a query that does not target one shard runs on all
50
+ shards. Make the frequent queries shard-targeted.
51
+
52
+ If no shard key is declared, the full primary key is used [OCI-NOSQL-E06].
53
+ That gives the widest distribution and the narrowest transaction scope.
54
+ *(inference)*
55
+
56
+ **Parent-child tables** model 1:N relationships with ACID writes across the
57
+ hierarchy [OCI-NOSQL-E08]. Referential integrity is not enforced and a parent
58
+ cannot be dropped before its children [OCI-NOSQL-E08], so orphan prevention is
59
+ the application's job. *(inference)*
60
+
61
+ ## Consistency
62
+
63
+ | Need | Choose | Cost | Evidence |
64
+ | --- | --- | --- | --- |
65
+ | Read-your-latest-write for a key in this region | ABSOLUTE | 2x read units | [OCI-NOSQL-E03] |
66
+ | Latency/cost-sensitive reads that tolerate staleness | EVENTUAL | 1x read units | [OCI-NOSQL-E03] |
67
+ | Latest value across regions on a Global Active table | **Not available** — remote updates are always eventually consistent | — | [OCI-NOSQL-E10] |
68
+
69
+ Set consistency per read for the few reads that need ABSOLUTE rather than on
70
+ the handle for everything; the handle-wide setting doubles every read's cost
71
+ [OCI-NOSQL-E03]. *(recommendation)*
72
+
73
+ ## Capacity, limits and cost
74
+
75
+ - Units are 1 KB granular: a read unit is up to 1 KB/s of eventually
76
+ consistent reads, a write unit up to 1 KB/s of writes [OCI-NOSQL-E15].
77
+ Row size, not row count, drives units. ABSOLUTE reads double the read
78
+ figure [OCI-NOSQL-E03].
79
+ - **Writes can cost reads.** Conditional puts (IfAbsent/IfPresent), UPDATE
80
+ statements and deletes consume read units at the absolute (x2) rate in
81
+ addition to write units [OCI-NOSQL-E25]. A write-heavy workload with
82
+ conditional writes needs read capacity too.
83
+ - **Index updates consume write units** [OCI-NOSQL-E15], and a table may have
84
+ at most 5 indexes [OCI-NOSQL-E24]. Each index is a standing write cost and a
85
+ scarce slot; the default answer to "add an index?" is "show the query that
86
+ needs it." *(recommendation)*
87
+ - Rows are capped at 512 KB [OCI-NOSQL-E24]; a growing JSON document needs a
88
+ child table or splitting before it hits that ceiling. *(recommendation)*
89
+ - **Hard per-table ceilings** [OCI-NOSQL-E23]: Provisioned up to 40,000 read
90
+ and 20,000 write units; On-Demand only up to 10,000 read and 5,000 write
91
+ units, and only 3 On-Demand tables per region. A table that may exceed the
92
+ On-Demand ceiling must be Provisioned.
93
+ - **Mode switches are rationed** [OCI-NOSQL-E23]: capacity mode can change
94
+ only once per day, and limits can decrease at most four times per 24 hours
95
+ (increases are unlimited). A failover or cost plan that flips mode or shrinks
96
+ capacity repeatedly will fail. Size for peak, then scale down deliberately.
97
+ - Prices and quota increases are volatile and were not retrieved
98
+ [OCI-NOSQL-E22]. Any cost estimate must cite a pricing page fetched at the
99
+ time of the estimate, or be labeled an assumption. Do not use
100
+ hosted-environment totals: the source contradicts itself [OCI-NOSQL-E31].
101
+
102
+ ## TTL
103
+
104
+ Table TTL defaults to zero (never expire), takes HOURS or DAYS, and a row TTL
105
+ overrides the table value [OCI-NOSQL-E07]. Expired rows stop being retrievable
106
+ and are later purged from disk [OCI-NOSQL-E07], but no purge timing is given.
107
+ Do not use TTL as an exact business-deletion deadline (for example legal
108
+ erasure) unless purge timing has been verified separately. *(inference)*
109
+
110
+ ## Backup and restore
111
+
112
+ Backup and restore are the **customer's** responsibility, using Oracle's
113
+ migrator tool and Object Storage [OCI-NOSQL-E30]. Treat "the cloud backs it up"
114
+ as a defect. A design is not READY without a scheduled export, a tested
115
+ restore and a stated RPO/RTO. *(recommendation)* A restore writes to a table,
116
+ so it is a mutation under the approval rules in `SKILL.md`.
117
+
118
+ ## Global Active tables
119
+
120
+ Use for regional DR or local-latency reads with active-active writes
121
+ [OCI-NOSQL-E09]. They are not available in a dedicated hosted environment
122
+ [OCI-NOSQL-E30]. Before approving, confirm all of:
123
+
124
+ - [ ] The schema is frozen (`with schema frozen`, or `with schema frozen force`
125
+ if there are no JSON columns) [OCI-NOSQL-E12]. Any later schema change
126
+ means **dropping all replicas, altering, and re-adding them**
127
+ [OCI-NOSQL-E26]. That is a multi-region production change. Include at
128
+ least one JSON column, as Oracle recommends, to avoid it [OCI-NOSQL-E26].
129
+ - [ ] The application tolerates **latest-timestamp-wins** conflict resolution
130
+ [OCI-NOSQL-E09]. Counters, balances and inventory decrements written in
131
+ two regions will lose updates. *(inference)* Route those writes to one
132
+ home region or redesign them.
133
+ - [ ] Nothing depends on cross-region transactions or cross-region ABSOLUTE
134
+ reads; both are region-local [OCI-NOSQL-E10].
135
+ - [ ] Global keys do not use identity columns, which Oracle advises against in
136
+ most cases because they are not unique across replicas [OCI-NOSQL-E11].
137
+ - [ ] Child tables are planned: a child of a Global Active table is a
138
+ singleton unless its schema is frozen and a replica is added to it too
139
+ [OCI-NOSQL-E27].
140
+ - [ ] The receiver region has the same-name compartment, no same-name table,
141
+ and the replica's IAM grants are planned [OCI-NOSQL-E11].
142
+ - [ ] Each region's write capacity covers replicated incoming writes, which are
143
+ billed [OCI-NOSQL-E25], and failover peak load. Remember mode switches
144
+ are once per day [OCI-NOSQL-E23]. *(recommendation)*
145
+
146
+ ## IAM least privilege
147
+
148
+ | Workload | Statement | Grants | Evidence |
149
+ | --- | --- | --- | --- |
150
+ | Read-only service or report | `read nosql-rows` | NOSQL_ROWS_READ | [OCI-NOSQL-E13] |
151
+ | Writer that never deletes | `use nosql-rows` | + NOSQL_ROWS_INSERT | [OCI-NOSQL-E13] |
152
+ | Writer that deletes | `manage nosql-rows` | + NOSQL_ROWS_DELETE | [OCI-NOSQL-E13] |
153
+ | Capacity / schema operator | `use nosql-tables` | + NOSQL_TABLE_ALTER (limits, ALTER TABLE) | [OCI-NOSQL-E29] |
154
+ | Table lifecycle | `manage nosql-tables` | + NOSQL_TABLE_CREATE, NOSQL_TABLE_DROP | [OCI-NOSQL-E29] |
155
+ | Index lifecycle | `manage nosql-indexes` | index create/drop | [OCI-NOSQL-E13] |
156
+
157
+ Rules:
158
+
159
+ - Application identities get `nosql-rows` verbs only: `read`, `use`, or
160
+ `manage nosql-rows` when the application must delete rows [OCI-NOSQL-E13].
161
+ Keep every `nosql-tables` and `nosql-indexes` verb off application
162
+ identities, because even `use nosql-tables` allows ALTER TABLE and limit
163
+ changes [OCI-NOSQL-E29]. *(recommendation)*
164
+ - Scope to a compartment, never the tenancy, and narrow to one table with
165
+ `target.nosql-table.name` where possible [OCI-NOSQL-E29].
166
+ - On Global Active tables, row permissions are **per region** and do not stop
167
+ replication: a write allowed in one region reaches every replica regardless
168
+ of the receiving region's permissions [OCI-NOSQL-E28]. The effective write
169
+ policy is the most permissive region's. *(inference)*
170
+ - Replica add/drop needs NOSQL_TABLE_ALTER in the sender and every receiver
171
+ region, plus NOSQL_TABLE_CREATE or NOSQL_TABLE_DROP in the target receiver
172
+ [OCI-NOSQL-E28].
173
+ - Policy statements must use real group and compartment names supplied by the
174
+ user; never invent them.
175
+
176
+ ## When to push back
177
+
178
+ - Shard key proposed without the access patterns and the atomicity
179
+ requirement.
180
+ - Low-cardinality shard key (tenant, status, country, date bucket).
181
+ - "Use ABSOLUTE everywhere to be safe" without a cost line.
182
+ - On-Demand for a table whose peak may exceed 10,000 read or 5,000 write units
183
+ [OCI-NOSQL-E23].
184
+ - A plan that relies on switching capacity mode more than once a day
185
+ [OCI-NOSQL-E23].
186
+ - Global Active table for multi-region counters or read-modify-write without a
187
+ home-region write rule, or for a dedicated hosted environment
188
+ [OCI-NOSQL-E30].
189
+ - No backup schedule or untested restore [OCI-NOSQL-E30].
190
+ - Any claim about an NDCS private endpoint, pricing or quota increases without a
191
+ freshly retrieved source [OCI-NOSQL-E22].
192
+ - CMEK planned on a shared (non-dedicated) environment, or a key rotation plan
193
+ that relies on multi-version keys [OCI-NOSQL-E35].
194
+ - Confusing NDCS with Autonomous Database or Oracle Database JSON features.
@@ -0,0 +1,194 @@
1
+ # Oracle NoSQL Database Cloud Service operations
2
+
3
+ Operational coverage for Oracle NoSQL Database Cloud Service (NDCS) on OCI. This is
4
+ not Autonomous Database and not on-premises Oracle NoSQL Database. Every section uses the
5
+ same heading and states one status. Cite evidence rows from
6
+ [the evidence ledger](evidence-ledger.md) as `[OCI-NOSQL-Exx]`.
7
+ `tests/validate-nosql-operations.py` enforces this structure.
8
+
9
+ Statuses:
10
+
11
+ - `VERIFIED`: the provider documents the capability; every statement below cites a
12
+ VERIFIED row.
13
+ - `PARTIAL`: some of it is documented and some is not, or it is limited (by tier,
14
+ mode, Region or API); say which part is which.
15
+ - `UNSUPPORTED`: provider documentation states the capability does not exist. Cite it.
16
+ - `UNVERIFIED`: no official page settled it in this pass. Say what was searched.
17
+ - `NOT APPLICABLE`: the capability does not apply to this service. Say why.
18
+
19
+ ## Backup and restore
20
+
21
+ **Status:** PARTIAL
22
+
23
+ - Documented (VERIFIED): backup and restore are the customer's job. Oracle supplies
24
+ the NoSQL Database Migrator, which can export a table to OCI Object Storage and
25
+ restore a table from those files. [OCI-NOSQL-E30] [OCI-NOSQL-E101]
26
+ - Oracle's own example copies a table to a JSON file in Object Storage for periodic
27
+ backups, run from Cloud Shell. The schedule is yours to build. [OCI-NOSQL-E102]
28
+ - Restore target: the migrator writes into a sink table. If the sink table exists with
29
+ a different schema the migration fails; with the same schema, rows with matching
30
+ primary keys are overwritten when the overwrite setting is true. [OCI-NOSQL-E102]
31
+ - Not documented (UNVERIFIED): any native on-demand, scheduled or point-in-time
32
+ backup, retention limit, or statement of what a restore leaves out (indexes, TTL,
33
+ IAM policies, tags). Searched the Features, Plan, Global Active, Monitor, Policies,
34
+ migrator, What's New and release-notes pages. [OCI-NOSQL-E126]
35
+ - Design consequence: treat any exported file set as the only recovery copy, secure
36
+ the Object Storage bucket, and test a restore into a scratch table.
37
+ Global Active replicas are redundancy, not backups: a bad write replicates. [OCI-NOSQL-E28]
38
+
39
+ ## Disaster recovery and replication
40
+
41
+ **Status:** PARTIAL
42
+
43
+ - Inside a region, data is stored across multiple Availability Domains, or Fault
44
+ Domains in single-AD regions, so a single AD or FD loss leaves data reachable.
45
+ [OCI-NOSQL-E103]
46
+ - Cross-region: Global Active tables replicate active-active and asynchronously;
47
+ concurrent conflicts resolve by latest timestamp. [OCI-NOSQL-E09]
48
+ - Failover mode: when a region is unavailable, the application requests are redirected
49
+ to a region holding a replica, where reads and writes continue; the failed
50
+ region resynchronizes on return. No service-driven automatic failover switch is
51
+ documented, so the redirect is application or DNS logic you own. [OCI-NOSQL-E104]
52
+ - ACID transactions and ABSOLUTE consistency are local to one region; data replicated
53
+ from another region is read as eventually consistent. [OCI-NOSQL-E10]
54
+ - Lag is observable (Replica Lag metric) but the pages searched state no RPO or RTO
55
+ figure (UNVERIFIED); do not promise one. [OCI-NOSQL-E105] [OCI-NOSQL-E114] [OCI-NOSQL-E126]
56
+ - Limits: a dedicated hosted environment does not support Global Active tables, and a
57
+ schema change after replicas exist needs all replicas dropped first.
58
+ [OCI-NOSQL-E30] [OCI-NOSQL-E26]
59
+
60
+ ## Cost
61
+
62
+ **Status:** VERIFIED
63
+
64
+ Billing dimensions only (what is billed and how it scales). Official pricing page:
65
+ <https://www.oracle.com/database/nosql/pricing/> and the Cost Estimator on the Oracle
66
+ Cloud website. Never write unit prices or currency amounts here.
67
+
68
+ - Capacity modes: Provisioned Capacity (fixed read/write throughput and storage) or
69
+ On-Demand Capacity (Oracle manages read/write capacity, storage still limited); a
70
+ dedicated hosted environment is a third, flat-fee option. [OCI-NOSQL-E01] [OCI-NOSQL-E107]
71
+ - Dimensions: read units, write units and GB of storage per month. A write unit covers
72
+ up to 1 KB per second, index updates consume write units, and ABSOLUTE reads consume
73
+ twice the read units of EVENTUAL. [OCI-NOSQL-E15] [OCI-NOSQL-E03] [OCI-NOSQL-E108]
74
+ - Hidden consumers: conditional puts, query-based updates and deletes consume read
75
+ units as well as write units. [OCI-NOSQL-E25]
76
+ - Replication: a Global Active table adds a second component, incoming replicated
77
+ writes at each regional replica, charged on writes consumed. [OCI-NOSQL-E106]
78
+ [OCI-NOSQL-E25]
79
+ - Dedicated hosted environment: one monthly price for the whole environment instead
80
+ of per-unit charges. [OCI-NOSQL-E107]
81
+ - Autoscale or on-demand invoices reflect actual consumption; log the units returned
82
+ by each API call to reconcile. [OCI-NOSQL-E108]
83
+ - Guardrails: compartment quotas on read units, write units and table size, and
84
+ per-table limits (including at most four capacity decreases per 24 hours).
85
+ [OCI-NOSQL-E116] [OCI-NOSQL-E23]
86
+
87
+ ## Monitoring
88
+
89
+ **Status:** VERIFIED
90
+
91
+ - Service: OCI Monitoring; namespace `oci_nosql`; dimensions `resourceId` and
92
+ `tableName`. [OCI-NOSQL-E110]
93
+ - Metrics: `ReadUnits`, `WriteUnits`, `StorageGB`, `ReadThrottleCount`,
94
+ `WriteThrottleCount`, `StorageThrottleCount`, `MaxShardSizeUsagePercent`, and
95
+ Replica Lag (extra dimension `replica`, milliseconds). [OCI-NOSQL-E110] [OCI-NOSQL-E114]
96
+ - Recommended alarm: `MaxShardSizeUsagePercent` at about 90 percent, notified through
97
+ OCI Notifications. Alarm on the throttle counts too (an inference from the
98
+ documented meaning of those metrics). [OCI-NOSQL-E111] [OCI-NOSQL-E112]
99
+ - Events: table actions (create, drop, alter, index, replica, compartment move) emit
100
+ OCI Events for rules and notifications. [OCI-NOSQL-E115]
101
+ - Caveat: StorageGB is truncated and refreshed with delay; under 1 GB can show as 0.
102
+ [OCI-NOSQL-E110]
103
+
104
+ ## Performance
105
+
106
+ **Status:** VERIFIED
107
+
108
+ - Throttling signal: a throttling exception usually means the provisioned throughput
109
+ was exceeded; if frequent, raise Read Units, Write Units or storage. Watch the three
110
+ throttle-count metrics. [OCI-NOSQL-E112] [OCI-NOSQL-E110]
111
+ - Hot shards: data is sharded on the shard key. Low-cardinality keys cause hot
112
+ shards. [OCI-NOSQL-E02] [OCI-NOSQL-E05]
113
+ - Storage hotspot: when `MaxShardSizeUsagePercent` reaches 100, writes stop even if
114
+ allocated storage is not used up. Pick a high-cardinality shard key and limit child
115
+ tables, since a hierarchy shares one shard key. [OCI-NOSQL-E113] [OCI-NOSQL-E08]
116
+ - Limits that bind: per-table read/write units (provisioned and on-demand maxima),
117
+ 5 indexes per table, 512 KB per row, 4 DDL operations per minute per region.
118
+ [OCI-NOSQL-E23] [OCI-NOSQL-E24]
119
+ - ABSOLUTE consistency costs double the read units. [OCI-NOSQL-E03]
120
+
121
+ ## IAM
122
+
123
+ **Status:** VERIFIED
124
+
125
+ - Model: OCI IAM policies (groups, dynamic groups, compartments). Three NoSQL resource
126
+ types: `nosql-tables` (table DDL and limits), `nosql-rows` (data) and `nosql-indexes`.
127
+ Verbs are cumulative: inspect, read, use, manage. [OCI-NOSQL-E117]
128
+ - Control plane versus data plane: `nosql-tables` USE adds ALTER (UpdateTable,
129
+ change TableLimits); MANAGE adds create and drop. `nosql-rows` READ allows get and
130
+ SELECT, USE adds insert and update, MANAGE adds delete. [OCI-NOSQL-E29] [OCI-NOSQL-E13]
131
+ - Least privilege: scope statements to a compartment and to one table with
132
+ `target.nosql-table.name` or `target.nosql-table.id`. Give applications `nosql-rows`
133
+ rights only; keep `nosql-tables` MANAGE with administrators. [OCI-NOSQL-E117] [OCI-NOSQL-E29]
134
+ - Workloads on OCI use instance or resource principals, which need a dynamic group
135
+ and policy first. [OCI-NOSQL-E118]
136
+ - Global Active tables replicate changes regardless of user permission, and adding or
137
+ dropping replicas needs ALTER in every region involved. [OCI-NOSQL-E28]
138
+
139
+ ## Tagging
140
+
141
+ **Status:** PARTIAL
142
+
143
+ - Supported (VERIFIED): OCI tags attach to a Global Active table, and tags are not
144
+ replicated, so each region's replica carries its own. [OCI-NOSQL-E119]
145
+ - Table events carry `freeformTags` in their payload. [OCI-NOSQL-E115]
146
+ - Not documented (UNVERIFIED): tag-based access control. The policy reference lists
147
+ only `target.nosql-table.id` and `target.nosql-table.name` as NoSQL variables, so
148
+ name- or OCID-based scoping is the documented route. [OCI-NOSQL-E117]
149
+ - Defined-tag namespaces, tag defaults and cost-tracking behaviour for NoSQL tables
150
+ were not confirmed in this pass. [OCI-NOSQL-E126]
151
+
152
+ ## Encryption
153
+
154
+ **Status:** VERIFIED
155
+
156
+ - At rest: data is encrypted on disk with AES 256 under an Oracle-managed master key
157
+ by default. [OCI-NOSQL-E120] [OCI-NOSQL-E35]
158
+ - Customer-managed keys: CMEK only in a dedicated environment. The key lives in an OCI
159
+ KMS vault, must be AES-256 symmetric, and only single-version keys are supported;
160
+ backups of that environment in Object Storage use the same key. [OCI-NOSQL-E35]
161
+ - Key state changes are logged by OCI Audit, and an `EncryptionKeyStatus` metric
162
+ supports alarms. [OCI-NOSQL-E122]
163
+ - In transit: HTTPS; Oracle states connections require TLS 1.2 and wallet-based
164
+ authentication. [OCI-NOSQL-E120] [OCI-NOSQL-E121]
165
+
166
+ ## Network isolation
167
+
168
+ **Status:** PARTIAL
169
+
170
+ - Documented (VERIFIED): a service gateway gives a VCN private access to supported
171
+ Oracle services over the Oracle network fabric, without internet traffic. An Oracle
172
+ reference architecture uses it for NDCS. [OCI-NOSQL-E123] [OCI-NOSQL-E34]
173
+ - Not documented (UNVERIFIED): an NDCS-specific private endpoint, a setting that
174
+ disables the public endpoint, or IP allow-listing. Earlier and current searches found
175
+ none. Do not claim them. [OCI-NOSQL-E22] [OCI-NOSQL-E126]
176
+ - Workaround to design for: private subnet, service gateway route, IAM scoping and
177
+ TLS; the endpoint stays a public regional name otherwise. This is judgment, not a
178
+ documented guarantee. [OCI-NOSQL-E121]
179
+ - Dedicated hosted environments get their own endpoint name, but the page does not
180
+ describe it as private. [OCI-NOSQL-E30]
181
+
182
+ ## Audit logging
183
+
184
+ **Status:** PARTIAL
185
+
186
+ - Control plane (VERIFIED): Oracle states it logs DDL API calls on NoSQL tables and
187
+ makes the logs available to you; OCI Audit records supported public API calls as
188
+ events. [OCI-NOSQL-E124] [OCI-NOSQL-E125]
189
+ - Events service adds create, drop, alter, index and replica events for rules and
190
+ alerts. [OCI-NOSQL-E115]
191
+ - Data plane (UNVERIFIED): no page states whether row operations (get, put, query)
192
+ appear in OCI Audit. Do not assume row-level auditing; log access in the
193
+ application. [OCI-NOSQL-E125] [OCI-NOSQL-E126]
194
+ - CMEK key state changes are audited in dedicated environments. [OCI-NOSQL-E122]
@@ -0,0 +1,43 @@
1
+ # Oracle NoSQL SDK compatibility matrix
2
+
3
+ Load this only when the task involves application code. These are the
4
+ **Oracle NoSQL SDKs**. Do not substitute Oracle Database drivers (JDBC,
5
+ `python-oracledb`, `node-oracledb`). They target a different product.
6
+
7
+ "Documentation-verified" means the package name and API shape were read from
8
+ the provider's README or docs on the retrieval date. No example below was
9
+ compiled or executed in this repository.
10
+
11
+ | Language | Package | Runtime | Client / auth entry point | Status | Evidence |
12
+ | --- | --- | --- | --- | --- | --- |
13
+ | Java | Maven `com.oracle.nosql.sdk:nosqldriver` | Java 11+ | `NoSQLHandleConfig` + `SignatureProvider`, `NoSQLHandleFactory.createNoSQLHandle` | documentation-verified | [OCI-NOSQL-E17] [OCI-NOSQL-E20] |
14
+ | Python | `borneo` (+ `oci` for the cloud service) | Python 3.12+ | `NoSQLHandle(NoSQLHandleConfig(endpoint, provider))`, `borneo.iam.SignatureProvider` | documentation-verified | [OCI-NOSQL-E18] |
15
+ | Node.js / TypeScript | `oracle-nosqldb` | Node.js 24.0.0+; TypeScript 5.0.x+ | `NoSQLClient` | documentation-verified | [OCI-NOSQL-E19] |
16
+ | Go | `github.com/oracle/nosql-go-sdk/nosqldb` | Go 1.24+ | `nosqldb.NewClient(cfg)` + `iam.NewSignatureProviderFromFile` | documentation-verified | [OCI-NOSQL-E32] |
17
+ | .NET / C# | NuGet `Oracle.NoSQL.SDK` | .NET 10.0+ | `NoSQLClient` + `IAMAuthorizationProvider` | documentation-verified | [OCI-NOSQL-E33] |
18
+ | Spring Data, Rust | official repos exist | not verified | not verified | unverified | [OCI-NOSQL-E16] [OCI-NOSQL-E21] |
19
+
20
+ Version pins: the Java README shows a version number inside its Maven
21
+ snippet. That is an example, not a statement of the latest release. Resolve the
22
+ current version from the package registry at implementation time; never copy a
23
+ pinned version from this file.
24
+
25
+ ## Rules for generated code
26
+
27
+ 1. **Authentication.** Use `SignatureProvider` with the user's OCI config
28
+ profile, or an instance/resource principal where the runtime supports it.
29
+ Never embed keys, fingerprints, tenancy OCIDs or passphrases in code.
30
+ Instance/resource-principal class names were not verified in this pass, so
31
+ look them up in the SDK API reference before writing them. *(rule)*
32
+ 2. **Consistency.** Default to EVENTUAL and opt specific reads into ABSOLUTE
33
+ (2x read units) [OCI-NOSQL-E03].
34
+ 3. **Table creation in code.** `TableRequest` with DDL and `TableLimits` is
35
+ the documented Java shape [OCI-NOSQL-E20]. Table DDL in application
36
+ start-up paths is a production-mutation risk: keep it in deployment
37
+ tooling behind approval. *(recommendation)*
38
+ 4. **Unverified SDKs.** For Spring Data or Rust, say the details are
39
+ unverified [OCI-NOSQL-E21]. Fetch that SDK's README before
40
+ writing any code. Do not translate Java method names into another language.
41
+ 5. **Throttling and retries.** Retry behavior and the exception class names
42
+ for limit-exceeded errors were not verified in this pass. Look them up in the
43
+ SDK API reference; do not invent exception names.
@@ -0,0 +1,8 @@
1
+ # Changelog
2
+
3
+ ## 1.0.0 — 2026-11-08
4
+
5
+ Initial Oracle NoSQL Cloud package: lazy command/feature selector; provider-native
6
+ model/security/runtime; customer export/import recovery; DDL/Terraform/CLI;
7
+ portable adapter examples; offline guards and June/December read-only reminder.
8
+ No cloud execution, scheduling, host registration or SDK compilation implied.
@@ -0,0 +1,81 @@
1
+ # oci-nosql-pattern
2
+
3
+ Provider-correct Oracle NoSQL Database Cloud Service guidance, version **1.0.0**.
4
+ Start at [SKILL.md](SKILL.md). This is not Oracle AI Database/Autonomous SQL.
5
+ No installation, registration, live operation, background job or measured savings
6
+ is implied. Templates and local fake tests are not service/runtime acceptance.
7
+
8
+ ## Triggers
9
+
10
+ Host-dependent agent requests; from this folder the real offline selector accepts
11
+ the same normal/slash-prefixed syntax and returns JSON `read` paths only.
12
+
13
+ | Intent | Trigger | Output / boundary |
14
+ |---|---|---|
15
+ | Help | `/oci-nosql-pattern help` | Commands/features only, then stop |
16
+ | Choose domains | `/oci-nosql-pattern select --features iam,encryption` | Selected guides, no OCI activation |
17
+ | Model access | `/oci-nosql-pattern design --features core,indexes,ttl` | Access matrix, shard choice, SQL/index alternatives, requested code/IaC |
18
+ | Change code/schema | `/oci-nosql-pattern refactor --features core,indexes` | Small compatible diff; backfill/cutover/rollback plan if needed |
19
+ | Offline audit | `/oci-nosql-pattern audit --mode offline --features iam,encryption,backup` | Sanitized/local evidence, no OCI inspection |
20
+ | Metadata audit | `/oci-nosql-pattern audit --mode live --features ttl,monitoring` | Authorized exact-target metadata only, no row scans/remediation |
21
+ | Performance plan | `/oci-nosql-pattern performance-test --environment nonproduction --duration-seconds 30 --max-requests 500 --max-concurrency 2` | Positive caps and further rate/cost/stop requirements; no run |
22
+ | Configure lifecycle | `/oci-nosql-pattern feature-plan --features ttl --action configure` | Proposed TTL change, not deployment |
23
+ | Security plan | `/oci-nosql-pattern feature-plan --features encryption,iam --action configure` | Managed/dedicated CMEK and rights prerequisites |
24
+ | Export plan | `/oci-nosql-pattern backup --method migrator --features backup,encryption` | Customer-managed JSON/Object Storage export, no snapshot/PITR promise |
25
+ | SDK export plan | `/oci-nosql-pattern backup --method sdk` | App-owned bounded page exporter contract, not a supplied backup service |
26
+ | Import plan | `/oci-nosql-pattern restore --method migrator` | Exact export/NEW table/schema/TTL approval and validation |
27
+ | SDK import plan | `/oci-nosql-pattern restore --method sdk` | App-owned conditional importer contract, no source overwrite |
28
+ | AI boundary | `/oci-nosql-pattern select --features vectors,embeddings,iam` | Numeric arrays/source provenance and external retrieval architecture |
29
+
30
+ Default features: `core`; backup/restore: `backup`. Default audit: offline; default
31
+ method: migrator. `--method pitr`, unknown features, empty bundles, unsafe action
32
+ combinations and nonpositive performance limits fail. Native ANN/vector enablement
33
+ is unsupported by this package: no verified NDCS native API in the reviewed docs.
34
+
35
+ ```bash
36
+ python3 scripts/select_mode.py /oci-nosql-pattern audit --features iam,encryption
37
+ python3 scripts/review_due.py --as-of 2026-11-08 # replace with actual client date
38
+ ```
39
+
40
+ ## Feature combinations
41
+
42
+ Only named paths load; indirect `embeddings`/`backup` routes do not load sibling
43
+ methods or live audit instructions. Unselected scope is not implicitly healthy.
44
+
45
+ | Bundle | Features | Tradeoff |
46
+ |---|---|---|
47
+ | Query/correctness | `core,indexes,ttl` | Shard locality, continuation, row expiration |
48
+ | Security | `iam,encryption` | Compartment/table access and dedicated CMEK prerequisites |
49
+ | Capacity | `core,indexes,monitoring` | Hot shards, consumed RU/WU and throttles |
50
+ | Recovery | `backup,ttl,encryption` | Export integrity, original expiry and key retention |
51
+ | Regional | `replicas,monitoring` | Replication lag/conflicts, not historical recovery |
52
+ | Semantic retrieval | `vectors,embeddings,iam` | App generation plus separately approved vector service |
53
+
54
+ ## Manual workflow combinations
55
+
56
+ One command at a time, not `combo` or an automatic pipeline. Every transition
57
+ retains its own authorization; selecting a plan does not apply it.
58
+
59
+ | Goal | Manual sequence | Gate |
60
+ |---|---|---|
61
+ | New model | design → offline audit | Review actual DDL/code; approve deploy separately |
62
+ | Safe refactor | offline audit → refactor → performance-test | Data compatibility, rollback and separately bounded approved test |
63
+ | Recovery drill | backup migrator → restore migrator → live audit | Export evidence/NEW target approval; application validation before cutover |
64
+ | CMEK review | offline audit → feature-plan configure → live audit | Dedicated environment/service-owner plan; no fake table `kms_key_id` |
65
+ | Retrieval | select vectors/embeddings → design → performance-test | Separate vector store IAM/model/dimension/tenant and recall ground truth |
66
+
67
+ ## Included artifacts and verification
68
+
69
+ [Provisioning](references/provisioning.md) selects matching [DDL](assets/orders.ddl),
70
+ [Terraform](assets/orders.tf) and guarded [OCI CLI](assets/create-table.sh). Either
71
+ IaC or CLI owns a NEW table, never both. Customer recovery uses reviewed Migrator
72
+ JSON templates and an intentionally incomplete manifest that fails the offline
73
+ [safety checker](scripts/check_recovery.py). No export/import is executed here.
74
+ [Adapters](references/language-adapters.md) cover JS/TS, Java, Rust, Kotlin via
75
+ Java, PHP/other REST integration plus Python/Go/.NET. Only the dependency-free
76
+ injected JS runtime helper is executed by local tests; SDK snippets are uncompiled.
77
+
78
+ Review every June and December; next **2026-12-01**. [Maintenance](references/maintenance.md)
79
+ is read-only on load, overdue stays overdue, and partial edits are not full audits.
80
+ See [sources/evidence](references/sources.md), [evals](evals/eval.md) and
81
+ [adversarial prompts](evals/prompts.json). No all-language/runtime-proof claim.
@@ -0,0 +1,62 @@
1
+ ---
2
+ name: oci-nosql-pattern
3
+ description: "Design, implement, refactor and audit Oracle NoSQL Database Cloud Service access patterns in any language. Use for shard/primary keys, SQL/secondary indexes, continuation, same-shard transactions, consistency/version/TTL, OCI IAM/encryption, replicas, metrics, Terraform/DDL/OCI CLI, embeddings boundaries, bounded performance plans and customer-owned export/import recovery. Lazy command/feature routes; not Oracle SQL Database, native vector/PITR enablement or permission for live access."
4
+ allowed-tools: Read Grep Glob Bash(python3 scripts/select_mode.py:*) Bash(python3 scripts/review_due.py:*)
5
+ metadata:
6
+ author: "github: VincentChuWaiChow"
7
+ version: "1.0.0"
8
+ updated: "2026-11-09"
9
+ category: data
10
+ ---
11
+
12
+ # OCI NoSQL Pattern
13
+
14
+ | Always-on rule | Required behavior |
15
+ |---|---|
16
+ | Scope | Oracle NoSQL Database Cloud Service (NDCS), not Oracle Database/Autonomous SQL, on-prem snapshots or DynamoDB |
17
+ | Safety | No cloud, credentials, installs, data reads/writes, export/import or load on skill load; preserve current IaC owner/data |
18
+ | Authorization | Before live metadata reads confirm principal, tenancy, region, compartment, table and permitted evidence; writes/load/recovery need exact separate approval |
19
+ | Evidence | Separate request, proposed plan, local checks, control-plane readback and application proof; label facts, assumptions and UNVERIFIED |
20
+ | Loading | Read only selected command/features and selected audit/recovery method; do not recursively read links or sibling guides |
21
+ | Language | Use existing SDK/language; no forced ORM or native capability invented to match another provider |
22
+
23
+ Recognize `/oci-nosql-pattern <command>` only when the host supports skill discovery;
24
+ `$oci-nosql-pattern` or plain language may also select it. No host registration.
25
+ The real local selector emits paths, not execution:
26
+ `python3 scripts/select_mode.py /oci-nosql-pattern <command> [options]`.
27
+
28
+ | Command | Load only selected route |
29
+ |---|---|
30
+ | help | [Help](references/commands/help.md); show commands and stop |
31
+ | select | [Feature selection](references/commands/select.md) |
32
+ | design | [Access-pattern design](references/commands/design.md) |
33
+ | refactor | [Compatibility and migration](references/commands/refactor.md) |
34
+ | audit | [Audit](references/commands/audit.md), then selected offline/live variant |
35
+ | performance-test | [Bounded plan](references/commands/performance-test.md), not a run |
36
+ | feature-plan | [Lifecycle plan](references/commands/feature-plan.md), not application |
37
+ | backup | [Backup](references/commands/backup.md), then selected migrator/sdk method |
38
+ | restore | [Restore](references/commands/restore.md), then selected migrator/sdk method; NEW target only |
39
+
40
+ | Task/feature | Read only when selected |
41
+ |---|---|
42
+ | core | [Model](references/modeling.md) and [runtime](references/runtime-contract.md) |
43
+ | indexes | [Secondary indexes](references/indexes.md); no LSI/GSI classification |
44
+ | iam | [OCI access](references/access.md) |
45
+ | encryption | [Managed versus dedicated CMEK](references/encryption.md) |
46
+ | ttl | [Expiration](references/ttl.md) |
47
+ | replicas | [Global Active Tables](references/replicas.md), not backup |
48
+ | monitoring | [Metrics](references/monitoring.md) |
49
+ | vectors | [Types/native capability boundary](references/types-and-vectors.md) |
50
+ | embeddings | [Generation/source/retrieval integration](references/embedding-integrations.md) |
51
+ | backup | [Customer recovery boundary](references/recovery-boundary.md), not every method |
52
+ | Provisioning requested | [Terraform/DDL/CLI](references/provisioning.md), then selected asset |
53
+ | Language requested | [Adapters](references/language-adapters.md), matching section only |
54
+ | Current capability/source question | [Dated sources](references/sources.md) |
55
+ | Due review or skill edits | [Maintenance](references/maintenance.md) or [eval contract](evals/eval.md) |
56
+
57
+ Audit defaults offline; recovery defaults migrator. Unknown/unsupported options fail
58
+ closed. `vectors` is informational; native ANN activation and `--method pitr` fail.
59
+ Bundles/manual sequences select scope only, never persistent activation or a chain.
60
+ At substantive use run `scripts/review_due.py --as-of YYYY-MM-DD` with the actual
61
+ client-local date. Review every June/December; next **2026-12-01**. Due/overdue:
62
+ load Maintenance and remind the user; never roll forward or schedule notifications.
@@ -0,0 +1,10 @@
1
+ {
2
+ "schema_version": 1,
3
+ "last_full_review": "2026-11-08",
4
+ "next_review": "2026-12-01",
5
+ "cadence_months": [
6
+ 6,
7
+ 12
8
+ ],
9
+ "scope": "Initial official-documentation review and local package checks; no OCI runtime proof"
10
+ }
@@ -0,0 +1,32 @@
1
+ #!/usr/bin/env bash
2
+ # Illustrative billable NEW-table operation. Never invoked on skill load.
3
+ set -euo pipefail
4
+ : "${OCI_PROFILE:?approved existing profile}"
5
+ : "${OCI_REGION:?approved region}"
6
+ : "${TENANCY_OCID:?approved tenancy OCID}"
7
+ : "${COMPARTMENT_OCID:?approved compartment OCID}"
8
+ : "${PRINCIPAL_OCID:?externally verified approved principal OCID}"
9
+ : "${TABLE_NAME:?approved NEW table name}"
10
+ [[ "$TABLE_NAME" =~ ^[A-Za-z][A-Za-z0-9_]{0,63}$ ]] || { echo "Unsafe name" >&2; exit 1; }
11
+ asset_dir=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
12
+ oci_cmd=(oci --profile "$OCI_PROFILE" --region "$OCI_REGION")
13
+ # These metadata reads confirm reachable targets, NOT the current principal identity.
14
+ observed_tenancy=$("${oci_cmd[@]}" iam tenancy get --tenancy-id "$TENANCY_OCID" --query data.id --raw-output)
15
+ [[ "$observed_tenancy" == "$TENANCY_OCID" ]] || { echo "Tenancy mismatch" >&2; exit 1; }
16
+ observed_compartment=$("${oci_cmd[@]}" iam compartment get --compartment-id "$COMPARTMENT_OCID" --query data.id --raw-output)
17
+ [[ "$observed_compartment" == "$COMPARTMENT_OCID" ]] || { echo "Compartment mismatch" >&2; exit 1; }
18
+ printf 'Declared principal=%s tenancy=%s compartment=%s region=%s NEW table=%s\n' "$PRINCIPAL_OCID" "$TENANCY_OCID" "$COMPARTMENT_OCID" "$OCI_REGION" "$TABLE_NAME"
19
+ read -r -p "After independent principal verification, type CREATE ${TABLE_NAME}: " confirmation
20
+ [[ "$confirmation" == "CREATE ${TABLE_NAME}" ]] || exit 1
21
+ ddl=$(cat "$asset_dir/orders.ddl")
22
+ ddl=${ddl/CREATE TABLE orders_v1/CREATE TABLE ${TABLE_NAME}}
23
+ # No IF NOT EXISTS, adoption, cleanup or deletion. A conflict is a hard stop.
24
+ "${oci_cmd[@]}" nosql table create --compartment-id "$COMPARTMENT_OCID" --name "$TABLE_NAME" \
25
+ --ddl-statement "$ddl" --table-limits "file://${asset_dir}/table-limits.json" \
26
+ --is-auto-reclaimable false --freeform-tags '{"purpose":"orders-example"}' --wait-for-state SUCCEEDED --max-wait-seconds 1200
27
+ "${oci_cmd[@]}" nosql index create --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME" \
28
+ --index-name tenant_status_created --keys "file://${asset_dir}/index-keys.json" \
29
+ --is-if-not-exists false --wait-for-state SUCCEEDED --max-wait-seconds 1200
30
+ # Readback is not application acceptance, ownership or backup proof.
31
+ "${oci_cmd[@]}" nosql table get --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME"
32
+ "${oci_cmd[@]}" nosql index get --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME" --index-name tenant_status_created
@@ -0,0 +1,11 @@
1
+ [
2
+ {
3
+ "columnName": "tenantId"
4
+ },
5
+ {
6
+ "columnName": "status"
7
+ },
8
+ {
9
+ "columnName": "createdAt"
10
+ }
11
+ ]