@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,350 @@
1
+ """Local package/actual-selector/actual-snippet tests: never call real OCI."""
2
+ import ast
3
+ import builtins
4
+ import contextlib
5
+ import importlib.util
6
+ import io
7
+ import json
8
+ import os
9
+ from pathlib import Path
10
+ import re
11
+ import socket
12
+ import subprocess
13
+ import sys
14
+ import tempfile
15
+ import unittest
16
+ from unittest.mock import patch
17
+
18
+ ROOT = Path(__file__).resolve().parents[1]
19
+
20
+
21
+ def module(name):
22
+ spec = importlib.util.spec_from_file_location(name, ROOT / "scripts" / f"{name}.py")
23
+ result = importlib.util.module_from_spec(spec)
24
+ spec.loader.exec_module(result)
25
+ return result
26
+
27
+
28
+ selector = module("select_mode")
29
+ review = module("review_due")
30
+ recovery = module("check_recovery")
31
+
32
+
33
+ def fixture_contract(ddl, tf, limits, keys):
34
+ """Controlled asset-equivalence check, NOT an HCL/Oracle DDL parser."""
35
+ def require(condition, message):
36
+ if not condition:
37
+ raise ValueError(message)
38
+ expected_columns = [("tenantId", "STRING"), ("orderId", "STRING"), ("status", "STRING"),
39
+ ("createdAt", "TIMESTAMP(3)"), ("amount", "NUMBER"), ("document", "JSON")]
40
+ columns = re.findall(r"^\s*(\w+)\s+(STRING|TIMESTAMP\(3\)|NUMBER|JSON)\s*,", ddl, re.M)
41
+ require(columns == expected_columns, "column schema changed")
42
+ require(re.search(r"PRIMARY KEY\(SHARD\(tenantId\), orderId\)", ddl), "key mismatch")
43
+ require("USING TTL 30 DAYS" in ddl, "TTL mismatch")
44
+ require("IF NOT EXISTS" not in ddl and "DROP" not in ddl, "unsafe DDL")
45
+ require('source = "oracle/oci"' in tf, "wrong provider")
46
+ require('resource "oci_nosql_table" "orders"' in tf, "table missing")
47
+ require('resource "oci_nosql_index" "tenant_status_created"' in tf, "index missing")
48
+ require('file("${path.module}/orders.ddl")' in tf, "DDL not linked")
49
+ require('"CREATE TABLE orders_v1", "CREATE TABLE ${var.table_name}"' in tf, "name substitution mismatch")
50
+ require('ddl_statement = local.ddl' in tf, "schema path unused")
51
+ require(re.search(r'is_auto_reclaimable\s*=\s*false', tf), "reclaim risk")
52
+ require(re.search(r'is_if_not_exists\s*=\s*false', tf), "adoption risk")
53
+ require(tf.count('prevent_destroy = true') == 2, "destruction guard missing")
54
+ require('kms_key_id' not in tf, "fictional table CMEK")
55
+ mappings = {"max_read_units": "maxReadUnits", "max_write_units": "maxWriteUnits", "max_storage_in_gbs": "maxStorageInGBs"}
56
+ for hcl, cli in mappings.items():
57
+ value = re.search(rf"{hcl}\s*=\s*(\d+)", tf)
58
+ require(value is not None and int(value[1]) == limits[cli], "capacity mismatch")
59
+ require(limits["capacityMode"] == "PROVISIONED" and 'capacity_mode = "PROVISIONED"' in tf, "capacity mode")
60
+ actual_keys = re.findall(r'keys\s*\{\s*column_name\s*=\s*"([^"]+)"\s*\}', tf)
61
+ require(actual_keys == [x["columnName"] for x in keys] == ["tenantId", "status", "createdAt"], "index order")
62
+ return True
63
+
64
+
65
+ class Package(unittest.TestCase):
66
+ def test_entry_metadata_size_and_commands(self):
67
+ text = (ROOT / "SKILL.md").read_text()
68
+ self.assertIn("name: oci-nosql-pattern\n", text)
69
+ self.assertIn('version: "1.0.0"', text)
70
+ self.assertLessEqual(len(text.splitlines()), 90)
71
+ self.assertLessEqual(len(text.split()), 900)
72
+ self.assertGreater(text.count("|"), 50)
73
+ for command in selector.COMMANDS:
74
+ self.assertTrue((ROOT / f"references/commands/{command}.md").is_file())
75
+
76
+ def test_json_and_all_local_markdown_targets(self):
77
+ for file in ROOT.rglob("*.json"):
78
+ json.loads(file.read_text())
79
+ for file in ROOT.rglob("*.md"):
80
+ for target in re.findall(r"\[[^\]]*\]\(([^)]+)\)", file.read_text()):
81
+ if "://" in target or target.startswith("#"):
82
+ continue
83
+ self.assertTrue((file.parent / target.split("#")[0]).exists(), f"{file}: {target}")
84
+
85
+ def test_selector_import_is_stdlib_and_no_execution_primitives(self):
86
+ source = (ROOT / "scripts/select_mode.py").read_text()
87
+ tree = ast.parse(source)
88
+ imports = {node.names[0].name.split(".")[0] for node in ast.walk(tree) if isinstance(node, ast.Import)}
89
+ self.assertEqual(imports, {"argparse", "json", "sys"})
90
+ forbidden = {"open", "read_text", "read_bytes", "write_text", "write_bytes", "exec", "eval", "system", "Popen", "run"}
91
+ calls = {getattr(n.func, "id", getattr(n.func, "attr", "")) for n in ast.walk(tree) if isinstance(n, ast.Call)}
92
+ self.assertFalse(calls & forbidden)
93
+
94
+ def test_documented_cli_input_shapes(self):
95
+ shapes = json.loads((ROOT / "evals/cli-shapes.json").read_text())
96
+ self.assertEqual(shapes["cli_version"], "3.95.0")
97
+ commands = {tuple(x["command"][1:]): x["input_shape"] for x in shapes["evidence"]}
98
+ self.assertEqual(len(commands), 10)
99
+ for command, shape in commands.items():
100
+ if command[0] == "nosql":
101
+ self.assertIn("compartmentId", shape)
102
+ limits = json.loads((ROOT / "assets/table-limits.json").read_text())
103
+ self.assertEqual(set(limits), set(commands[("nosql", "table", "create")]["tableLimits"]))
104
+ query = json.loads((ROOT / "assets/query.json").read_text())
105
+ self.assertTrue(query["isPrepared"])
106
+ self.assertLessEqual(set(query), set(commands[("nosql", "query", "execute")]))
107
+ sql = (ROOT / "assets/query.sql").read_text()
108
+ for variable in query["variables"]:
109
+ self.assertIn(variable, sql)
110
+ self.assertIn("o.tenantId = $tenant", sql)
111
+
112
+ def test_provisioning_fixtures_positive(self):
113
+ self.assertTrue(fixture_contract((ROOT / "assets/orders.ddl").read_text(),
114
+ (ROOT / "assets/orders.tf").read_text(), json.loads((ROOT / "assets/table-limits.json").read_text()),
115
+ json.loads((ROOT / "assets/index-keys.json").read_text())))
116
+
117
+ def test_provisioning_fixtures_negative(self):
118
+ ddl = (ROOT / "assets/orders.ddl").read_text()
119
+ tf = (ROOT / "assets/orders.tf").read_text()
120
+ limits = json.loads((ROOT / "assets/table-limits.json").read_text())
121
+ keys = json.loads((ROOT / "assets/index-keys.json").read_text())
122
+ mutations = [(ddl.replace("SHARD(tenantId)", "SHARD(orderId)"), tf, limits, keys),
123
+ (ddl.replace("NUMBER", "DOUBLE"), tf, limits, keys),
124
+ (ddl.replace("30 DAYS", "3 DAYS"), tf, limits, keys),
125
+ (ddl, tf.replace("max_read_units = 50", "max_read_units = 500"), limits, keys),
126
+ (ddl, tf.replace("prevent_destroy = true", "prevent_destroy = false"), limits, keys),
127
+ (ddl, tf.replace("is_if_not_exists = false", "is_if_not_exists = true"), limits, keys),
128
+ (ddl, tf, limits, list(reversed(keys))),
129
+ (ddl, tf + '\nkms_key_id = "unsupported"\n', limits, keys)]
130
+ for mutation in mutations:
131
+ with self.subTest(mutation=str(mutation)[:80]), self.assertRaises(ValueError):
132
+ fixture_contract(*mutation)
133
+
134
+ def test_migrator_templates_are_cloud_full_export_new_import(self):
135
+ out = json.loads((ROOT / "assets/migrator-export.json").read_text())
136
+ incoming = json.loads((ROOT / "assets/migrator-import.json").read_text())
137
+ self.assertEqual(out["source"]["type"], "nosqldb_cloud")
138
+ self.assertEqual(out["sink"]["type"], "object_storage_oci")
139
+ self.assertEqual(incoming["source"]["type"], "object_storage_oci")
140
+ self.assertEqual(incoming["sink"]["type"], "nosqldb_cloud")
141
+ self.assertNotEqual(out["source"]["table"], incoming["sink"]["table"])
142
+ self.assertNotIn("queryFilter", out["source"])
143
+ self.assertTrue(out["source"]["includeTTL"])
144
+ self.assertTrue(incoming["sink"]["includeTTL"])
145
+ self.assertNotIn("ttlRelativeDate", incoming["sink"])
146
+ self.assertFalse(incoming["sink"]["overwrite"])
147
+ self.assertTrue(incoming["abortOnError"])
148
+ self.assertEqual(set(incoming["sink"]["schemaInfo"]) & {"schemaPath", "useSourceSchema", "defaultSchema"}, {"schemaPath"})
149
+
150
+
151
+ class Routes(unittest.TestCase):
152
+ def parse(self, args):
153
+ return selector.build_plan(args.split())
154
+
155
+ def test_help_and_prefix(self):
156
+ expected = ["references/commands/help.md"]
157
+ for args in [[], ["help"], ["/oci-nosql-pattern"], ["/oci-nosql-pattern", "help"]]:
158
+ self.assertEqual(selector.build_plan(args)["read"], expected)
159
+
160
+ def test_commands_and_every_selected_feature_have_exact_paths(self):
161
+ for command in selector.COMMANDS[1:]:
162
+ for feature, guides in selector.FEATURES.items():
163
+ args = [command, "--features", feature]
164
+ if command == "feature-plan":
165
+ if feature not in selector.ACTIONS:
166
+ continue
167
+ args += ["--action", "configure"]
168
+ result = selector.build_plan(args)
169
+ expected = [f"references/commands/{command}.md"]
170
+ if command == "audit": expected += ["references/commands/audit/offline.md"]
171
+ if command in {"backup", "restore"}: expected += [f"references/commands/{command}/migrator.md"]
172
+ expected += guides
173
+ self.assertEqual(result["read"], list(dict.fromkeys(expected)))
174
+ self.assertEqual(result["execution"], "none")
175
+ self.assertTrue(all((ROOT / x).is_file() for x in result["read"]))
176
+
177
+ def test_selected_variants_do_not_load_siblings_or_indirect_methods(self):
178
+ for mode in ["offline", "live"]:
179
+ p = self.parse(f"audit --mode {mode} --features embeddings,backup")
180
+ self.assertEqual(p["live_read_approval_required"], mode == "live")
181
+ self.assertFalse(any(f"audit/{'live' if mode == 'offline' else 'offline'}" in x for x in p["read"]))
182
+ self.assertFalse(any('/backup/' in x or '/restore/' in x for x in p['read']))
183
+ for command in ["backup", "restore"]:
184
+ for method in ["sdk", "migrator"]:
185
+ p = self.parse(f"{command} --method {method} --features backup,encryption")
186
+ self.assertIn(f"references/commands/{command}/{method}.md", p["read"])
187
+ self.assertFalse(any(f"/{'sdk' if method == 'migrator' else 'migrator'}.md" in x for x in p["read"]))
188
+ self.assertTrue(p["change_approval_required"])
189
+
190
+ def test_routes_never_read_files_or_call_network_processes(self):
191
+ with patch.object(builtins, "open", side_effect=AssertionError("read")), \
192
+ patch.object(Path, "read_text", side_effect=AssertionError("read")), \
193
+ patch.object(Path, "write_text", side_effect=AssertionError("write")), \
194
+ patch.object(socket, "socket", side_effect=AssertionError("network")), \
195
+ patch.object(subprocess, "run", side_effect=AssertionError("process")):
196
+ self.parse("audit --mode live --features backup,embeddings")
197
+ self.parse("restore --method sdk")
198
+
199
+ def test_invalid_actions_and_arguments_fail_closed(self):
200
+ cases = ["unknown", "/wrong help", "select --features ''", "select --features core,", "select --features pitr", "select --features streams",
201
+ "backup --method pitr", "restore --method on-demand", "help --features core", "audit --mode production",
202
+ "feature-plan --features vectors --action enable", "feature-plan --features core --action configure",
203
+ "feature-plan --features ttl,encryption --action disable", "feature-plan --features iam --action enable",
204
+ "performance-test --environment production", "design --mode live", "select --feat core"]
205
+ for flag in ["--duration-seconds", "--max-requests", "--max-concurrency"]:
206
+ cases += [f"performance-test {flag} {x}" for x in ["0", "-1", "nan", "1.5"]]
207
+ for args in cases:
208
+ with self.subTest(args=args), contextlib.redirect_stderr(io.StringIO()), self.assertRaises(SystemExit) as exc:
209
+ self.parse(args)
210
+ self.assertEqual(exc.exception.code, 2)
211
+
212
+ def test_actual_cli_selector(self):
213
+ cli = subprocess.run([sys.executable, str(ROOT / 'scripts/select_mode.py'), '/oci-nosql-pattern', 'audit', '--mode', 'live', '--features', 'iam,encryption'], capture_output=True, text=True, check=True)
214
+ result = json.loads(cli.stdout)
215
+ self.assertEqual(result['execution'], 'none')
216
+ self.assertTrue(result['live_read_approval_required'])
217
+ bad = subprocess.run([sys.executable, str(ROOT / 'scripts/select_mode.py'), 'restore', '--method', 'pitr'], capture_output=True, text=True)
218
+ self.assertEqual(bad.returncode, 2)
219
+ self.assertFalse(bad.stdout)
220
+
221
+
222
+ class ReviewAndRecovery(unittest.TestCase):
223
+ def test_review_dates_do_not_roll_forward_or_write(self):
224
+ path = ROOT / 'assets/content-review.json'
225
+ before = path.read_bytes()
226
+ ledger = json.loads(before)
227
+ for day, status in [('2026-11-08', 'not-due'), ('2026-12-01', 'due'), ('2026-12-02', 'overdue'), ('2030-06-03', 'overdue')]:
228
+ result = review.review_status(day, ledger)
229
+ self.assertEqual(result['status'], status)
230
+ self.assertEqual(result['next_review'], '2026-12-01')
231
+ self.assertFalse(result['writes'])
232
+ run = subprocess.run([sys.executable, str(ROOT / 'scripts/review_due.py'), '--as-of', '2028-01-01'], capture_output=True, text=True, check=True)
233
+ self.assertEqual(json.loads(run.stdout)['status'], 'overdue')
234
+ self.assertEqual(path.read_bytes(), before)
235
+ for day in ['2026-02-31', 'not-a-date']:
236
+ with self.assertRaises(ValueError): review.review_status(day, ledger)
237
+
238
+ def valid_manifest(self):
239
+ m = json.loads((ROOT / 'assets/recovery-manifest.example.json').read_text())
240
+ m['source'] = {'tenancy':'ocid1.tenancy.demo','region':'us-ashburn-1','compartment':'ocid1.compartment.demo','table':'orders_v1','table_ocid':'ocid1.nosqltable.source'}
241
+ m['destination'] = {'region':'us-ashburn-1','compartment':'ocid1.compartment.demo','table':'orders_recovery','exists':False}
242
+ m['backup'].update(namespace='demo', bucket='archive', prefix='unique-export', verified=True, failed_records=0,
243
+ writes_quiesced=True, object_versions=['immutable-version-id'], schema_sha256='a'*64, data_sha256={'part1.json':'b'*64})
244
+ return m
245
+
246
+ def test_recovery_manifest_positive_and_actual_cli(self):
247
+ m = self.valid_manifest()
248
+ result = recovery.validate(m)
249
+ self.assertEqual(result['execution'], 'none')
250
+ self.assertEqual(result['live_evidence'], 'UNVERIFIED')
251
+ self.assertFalse(result['cutover_authorized'])
252
+ with tempfile.TemporaryDirectory() as temp:
253
+ path = Path(temp) / 'manifest.json'; path.write_text(json.dumps(m))
254
+ run = subprocess.run([sys.executable, str(ROOT / 'scripts/check_recovery.py'), str(path)], capture_output=True, text=True, check=True)
255
+ self.assertEqual(json.loads(run.stdout)['status'], 'locally-consistent')
256
+
257
+ def test_recovery_rejects_unsafe_inputs_and_incomplete_example(self):
258
+ mutations = [('destination','table','orders_v1'), ('destination','table','ORDERS_V1'), ('destination','exists',True), ('destination','exists',None),
259
+ ('backup','failed_records',1), ('backup','failed_records',False), ('backup','verified',False), ('backup','writes_quiesced',False),
260
+ ('backup','object_versions',[]), ('backup','object_versions',['']), ('backup','data_sha256',{}), ('backup','schema_sha256','bad'),
261
+ ('backup','export_end','2026-11-07T00:00:00Z'), ('backup','export_start','2026-11-08T00:00:00'),
262
+ ('backup','include_ttl',False), ('source','table_ocid','REPLACE_SOURCE')]
263
+ for group, key, value in mutations:
264
+ m = self.valid_manifest(); m[group][key] = value
265
+ with self.subTest(key=key), self.assertRaises((ValueError, KeyError)):
266
+ recovery.validate(m)
267
+ with self.assertRaises(ValueError):
268
+ recovery.validate(json.loads((ROOT/'assets/recovery-manifest.example.json').read_text()))
269
+
270
+
271
+ FAKE_OCI = r"""#!/usr/bin/env python3
272
+ import json,os,sys
273
+ from pathlib import Path
274
+ args=sys.argv[1:]
275
+ with open(os.environ['CALL_LOG'],'a') as f:f.write(json.dumps(args)+'\n')
276
+ if args[:4] != ['--profile','approved-profile','--region','us-ashburn-1']:sys.exit(90)
277
+ cmd=args[4:7]
278
+ scenario=os.environ.get('SCENARIO','ok')
279
+ if cmd==['iam','tenancy','get']:
280
+ if scenario=='tenancy-error':sys.exit(5)
281
+ print('wrong-tenancy' if scenario=='tenancy-mismatch' else 'ocid1.tenancy.demo')
282
+ elif cmd==['iam','compartment','get']:
283
+ if scenario=='compartment-error':sys.exit(5)
284
+ print('wrong-compartment' if scenario=='compartment-mismatch' else 'ocid1.compartment.demo')
285
+ elif cmd==['nosql','table','create']:
286
+ if scenario=='table-error':sys.exit(6)
287
+ print('{"data":{"state":"SUCCEEDED"}}')
288
+ elif cmd==['nosql','index','create']:
289
+ if scenario=='index-error':sys.exit(7)
290
+ print('{"data":{"state":"SUCCEEDED"}}')
291
+ elif cmd in [['nosql','table','get'],['nosql','index','get']]:
292
+ print('{"data":{"state":"ACTIVE"}}')
293
+ else:sys.exit(99)
294
+ """
295
+
296
+
297
+ class ActualShellSnippet(unittest.TestCase):
298
+ def run_snippet(self, scenario='ok', table='safe_orders', confirmation='CREATE safe_orders\n', remove=None):
299
+ with tempfile.TemporaryDirectory() as temp:
300
+ directory = Path(temp); fake = directory / 'oci'; fake.write_text(FAKE_OCI); fake.chmod(0o755)
301
+ log = directory / 'calls.jsonl'
302
+ env = {**os.environ, 'PATH':str(directory)+os.pathsep+os.environ['PATH'], 'CALL_LOG':str(log), 'SCENARIO':scenario,
303
+ 'OCI_PROFILE':'approved-profile','OCI_REGION':'us-ashburn-1','TENANCY_OCID':'ocid1.tenancy.demo',
304
+ 'COMPARTMENT_OCID':'ocid1.compartment.demo','PRINCIPAL_OCID':'ocid1.user.approved','TABLE_NAME':table}
305
+ if remove:env.pop(remove,None)
306
+ run = subprocess.run(['bash', str(ROOT/'assets/create-table.sh')], input=confirmation, env=env, capture_output=True, text=True, timeout=10)
307
+ calls = [json.loads(x) for x in log.read_text().splitlines()] if log.exists() else []
308
+ return run, calls
309
+
310
+ def test_actual_script_positive_exact_targets_schema_limits_and_order(self):
311
+ run, calls = self.run_snippet()
312
+ self.assertEqual(run.returncode, 0, run.stderr)
313
+ self.assertEqual([x[4:7] for x in calls], [['iam','tenancy','get'],['iam','compartment','get'],['nosql','table','create'],['nosql','index','create'],['nosql','table','get'],['nosql','index','get']])
314
+ for call in calls[2:]:
315
+ self.assertEqual(call[call.index('--compartment-id')+1], 'ocid1.compartment.demo')
316
+ table, index = calls[2:4]
317
+ ddl = table[table.index('--ddl-statement')+1]
318
+ expected = (ROOT/'assets/orders.ddl').read_text().rstrip().replace('CREATE TABLE orders_v1','CREATE TABLE safe_orders')
319
+ self.assertEqual(ddl, expected)
320
+ self.assertEqual(table[table.index('--name')+1], 'safe_orders')
321
+ limits = table[table.index('--table-limits')+1]
322
+ self.assertEqual(json.loads(Path(limits.removeprefix('file://')).read_text()), json.loads((ROOT/'assets/table-limits.json').read_text()))
323
+ self.assertEqual(index[index.index('--table-name-or-id')+1], 'safe_orders')
324
+ self.assertEqual(index[index.index('--is-if-not-exists')+1], 'false')
325
+ self.assertEqual(index[index.index('--keys')+1], f'file://{ROOT}/assets/index-keys.json')
326
+ self.assertEqual(table[table.index('--wait-for-state')+1], 'SUCCEEDED')
327
+
328
+ def test_wrong_target_metadata_and_failed_identity_stop_before_write(self):
329
+ for scenario in ['tenancy-error','tenancy-mismatch','compartment-error','compartment-mismatch']:
330
+ run,calls = self.run_snippet(scenario=scenario)
331
+ self.assertNotEqual(run.returncode,0)
332
+ self.assertFalse(any(x[4:7]==['nosql','table','create'] for x in calls))
333
+
334
+ def test_confirmation_name_and_missing_scope_fail_closed(self):
335
+ for options in [{'confirmation':'yes\n'},{'table':'orders;rm_bad'},{'table':'../orders'},{'remove':'COMPARTMENT_OCID'},{'remove':'PRINCIPAL_OCID'}]:
336
+ run,calls = self.run_snippet(**options)
337
+ self.assertNotEqual(run.returncode,0)
338
+ self.assertFalse(any(x[4]=='nosql' for x in calls))
339
+
340
+ def test_failed_mutation_never_adopts_deletes_or_continues(self):
341
+ for scenario, expected_calls in [('table-error',3),('index-error',4)]:
342
+ run,calls = self.run_snippet(scenario=scenario)
343
+ self.assertNotEqual(run.returncode,0)
344
+ self.assertEqual(len(calls),expected_calls)
345
+ self.assertFalse(any('delete' in x for x in calls))
346
+ self.assertFalse(any(x[4:7]==['nosql','table','get'] for x in calls))
347
+
348
+
349
+ if __name__ == '__main__':
350
+ unittest.main()
@@ -0,0 +1,77 @@
1
+ import test from 'node:test';
2
+ import assert from 'node:assert/strict';
3
+ import {queryPages, validateEmbedding} from '../assets/query-pages.mjs';
4
+
5
+ async function collect(iterator) {
6
+ const rows = [];
7
+ for await (const page of iterator) rows.push(...page.rows);
8
+ return rows;
9
+ }
10
+
11
+ test('actual helper follows empty page continuation and preserves exact opaque token/options', async () => {
12
+ const token = Uint8Array.from([1, 255, 0]);
13
+ const prepared = Object.freeze({serverBoundTenant: 'tenant-A'});
14
+ const queryOptions = Object.freeze({compartment: 'compartment-A', consistency: 'ABSOLUTE'});
15
+ const calls = [];
16
+ const results = [{rows: [], continuationKey: token}, {rows: [{orderId:'one'}]}];
17
+ const query = async (stmt, options) => { calls.push([stmt, options]); return results.shift(); };
18
+ assert.deepEqual(await collect(queryPages(query, prepared, {queryOptions, maxPages:2, maxReadKB:16})), [{orderId:'one'}]);
19
+ assert.equal(calls.length, 2);
20
+ assert.equal(calls[0][0], prepared);
21
+ assert.equal(calls[0][1].compartment, 'compartment-A');
22
+ assert.equal(calls[0][1].consistency, 'ABSOLUTE');
23
+ assert.equal(calls[1][1].continuationKey, token);
24
+ assert.equal(calls[0][1].continuationKey, undefined);
25
+ assert.equal(queryOptions.continuationKey, undefined);
26
+ });
27
+
28
+ test('page budget fails incomplete without unbounded loop or silently succeeding', async () => {
29
+ let calls=0;
30
+ const query=async()=>{calls++; return {rows:[], continuationKey: 'repeat'};};
31
+ await assert.rejects(collect(queryPages(query, {}, {maxPages:3})), /incomplete/);
32
+ assert.equal(calls,3);
33
+ });
34
+
35
+ test('invalid bounds, external cursor and abort fail before SDK call', async () => {
36
+ let calls=0;
37
+ const query=async()=>{calls++; return {rows:[]};};
38
+ for(const options of [{maxPages:0},{maxPages:1.5},{maxReadKB:-1},{maxReadKB:NaN},{maxPages:Infinity},
39
+ {queryOptions:{continuationKey:'public-untrusted'}},{signal:{aborted:true}}]) {
40
+ await assert.rejects(collect(queryPages(query, {}, options)));
41
+ }
42
+ assert.equal(calls,0);
43
+ });
44
+
45
+ test('SDK errors and malformed pages propagate; no hidden retries or partial-success claims', async () => {
46
+ let calls=0;
47
+ await assert.rejects(collect(queryPages(async()=>{calls++; throw new Error('Forbidden');},{})), /Forbidden/);
48
+ assert.equal(calls,1);
49
+ await assert.rejects(collect(queryPages(async()=>({rows:null}),{})), /QueryResult/);
50
+ });
51
+
52
+ const expected={tenantId:'tenant-A',model:'model-v1',dimension:3};
53
+ const valid={values:[0.1,-0.2,0.3],tenantId:'tenant-A',model:'model-v1',dimension:3,sourceId:'doc-1',sourceHash:'hash-1'};
54
+
55
+ test('embedding contract preserves numeric coordinates, tenant/model and source provenance', () => {
56
+ const output=validateEmbedding(valid,expected);
57
+ assert.deepEqual(output,valid);
58
+ assert.notEqual(output.values,valid.values);
59
+ output.values[0]=8;
60
+ assert.equal(valid.values[0],0.1);
61
+ });
62
+
63
+ test('embedding rejects source URI instead of coordinates, nonfinite values and wrong dimensions/spaces/tenant', () => {
64
+ const mutations=[{values:'oci://bucket/source'},{values:[0.1,0.2]},{values:[0.1,NaN,0.3]},
65
+ {values:[0.1,Infinity,0.3]},{values:[0.1,'0.2',0.3]},{dimension:0},{dimension:1.5},
66
+ {tenantId:'tenant-B'},{model:'model-v2'},{sourceId:''},{sourceHash:''},{sourceHash:' '}];
67
+ for(const change of mutations) assert.throws(()=>validateEmbedding({...valid,...change},expected));
68
+ });
69
+
70
+ test('sparse coordinates and sparse source metadata are not finite vectors', () => {
71
+ const sparse=Array(3); sparse[0]=1;
72
+ assert.throws(()=>validateEmbedding({...valid,values:sparse},expected));
73
+ });
74
+
75
+ test('embedding requires an explicit nonempty trusted expected tenant/model', () => {
76
+ assert.throws(()=>validateEmbedding({...valid,tenantId:undefined,model:undefined}, {dimension:3}));
77
+ });
@@ -0,0 +1,25 @@
1
+ {
2
+ "id": "oci-nosql-pattern",
3
+ "name": "OCI NoSQL Pattern",
4
+ "type": "skill",
5
+ "provider": "oci",
6
+ "harnesses": [
7
+ "codex",
8
+ "claude-code",
9
+ "cursor",
10
+ "gemini",
11
+ "kiro",
12
+ "other"
13
+ ],
14
+ "summary": "Design, implement, refactor and audit Oracle NoSQL Database Cloud Service access patterns: shard and primary keys, indexes, continuation, same-shard transactions, consistency, TTL, IAM, encryption, replicas, metrics, Terraform/DDL/OCI CLI and customer-owned export/import recovery, with command routes that load one guide at a time.",
15
+ "source_type": "adapted",
16
+ "official_docs": [
17
+ "https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html",
18
+ "https://docs.oracle.com/en/cloud/paas/nosql-cloud/odsql/"
19
+ ],
20
+ "security_notes": "Not permission to access OCI. Live reads need a confirmed principal, tenancy, region, compartment and table; writes, load tests and export/import recovery need exact approval. Recovery targets a new table. Bundled scripts are offline route selectors, a date-argument review reminder and a sanitized recovery-manifest checker.",
21
+ "last_verified": "2026-11-09",
22
+ "path": "skills/oci/oci-nosql-pattern",
23
+ "author": "github: VincentChuWaiChow",
24
+ "version": "1.0.0"
25
+ }
@@ -0,0 +1,29 @@
1
+ # OCI principals, tenancy/compartment/table scopes
2
+
3
+ Choose an existing approved workload/resource/instance principal where supported;
4
+ do not install auth, read config/key files, login, or print tokens. SDK initialization
5
+ and OCI CLI profiles are different surfaces. A reachable tenancy get and supplied
6
+ `PRINCIPAL_OCID` are not evidence of the active caller identity.
7
+
8
+ | Resource scope | Least-privilege intent |
9
+ |---|---|
10
+ | `nosql-tables` | metadata read distinct from create/update/drop/move |
11
+ | `nosql-rows` | read: `NOSQL_ROWS_READ`; use adds `NOSQL_ROWS_INSERT`; manage adds `NOSQL_ROWS_DELETE` |
12
+ | `nosql-indexes` | inspect/read distinct from index creation/deletion |
13
+ | work requests | exact request status/errors; avoid broad tenancy inventory |
14
+ | recovery storage/key | source read, narrowly scoped destination object write/read, Vault decrypt dependency; never all-resources by default |
15
+
16
+ Illustrative policy statements, not deployed or an entire role:
17
+
18
+ ```text
19
+ Allow dynamic-group OrdersReader to read nosql-tables in compartment Orders
20
+ Allow dynamic-group OrdersReader to read nosql-rows in compartment Orders
21
+ ```
22
+
23
+ Review documented target/table conditions and effective IAM with the security owner;
24
+ these compartment policies alone grant multiple tables, not per-tenant rows.
25
+ Application binds tenant/query on every path, including secondary queries, bulk
26
+ writes, cursor replay and vector retrieval. Do not promise row-level IAM from a
27
+ `tenantId` shard key or infer cross-tenancy grants from a familiar SDK.
28
+
29
+ [NoSQL policy reference](https://docs.oracle.com/en/cloud/paas/nosql-cloud/odsql/), checked 2026-11-08.
@@ -0,0 +1,10 @@
1
+ # Authorized live metadata audit
2
+
3
+ Before any read require exact principal, tenancy, compartment, region, endpoint,
4
+ table OCID/name and approved read-only evidence. Do not print auth configuration,
5
+ customer rows or broad inventory. Use scoped table/index/work-request/usage metadata
6
+ and selected Monitoring/key configuration only. A declared profile/principal is not
7
+ identity attestation; independently verify the active workload/human identity by
8
+ the approved host process. Stop on scope mismatch, authorization failure or drift;
9
+ never silently choose another compartment/region or mutate to repair. Document
10
+ readback time and gaps; ACTIVE/SUCCEEDED is not application/restore correctness.
@@ -0,0 +1,8 @@
1
+ # Offline audit
2
+
3
+ Use only supplied/local sanitized code, DDL, Terraform, plans, policy/metric/export
4
+ metadata fixtures. No OCI command, data query, credentials or automatic external
5
+ lookup. Check query predicates/tenant binding, same-shard transaction assumptions,
6
+ version conflicts/retries, cursor binding, capacity/TTL, selected key/recovery
7
+ settings and IaC ownership. Source verification is a separately requested lookup.
8
+ Report file/line evidence; effective permissions/state/runtime stay UNVERIFIED.
@@ -0,0 +1,6 @@
1
+ # Audit dispatcher
2
+
3
+ Default offline. Load exactly [offline](audit/offline.md) OR [live](audit/live.md), never both.
4
+ Then only selected feature guides. Capture exact evidence origin/time and classify
5
+ findings PASS/MISS/UNVERIFIED; insufficient evidence is not compliance. A live route
6
+ selection does not authorize a read or remediation. Stop on unexpected targets.
@@ -0,0 +1,12 @@
1
+ # Migrator export
2
+
3
+ Use the Oracle NoSQL Database Migrator cloud→Object Storage JSON path, not on-prem
4
+ `kv export`/snapshot utilities. Review [export config](../../../assets/migrator-export.json)
5
+ only for this method; replace all placeholders. Instance-principal auth requires
6
+ an already approved OCI compute identity and least-privilege policies; do not set
7
+ up auth here. Pin/review the existing Migrator release. Intended command after
8
+ approval is `runMigrator --config reviewed-export.json` (not executed by this skill).
9
+ Quiesce DML/DDL, document the window; Migrator is not snapshot isolation. Use a
10
+ unique empty prefix, preserve schema/TTL, stop on any failed/skipped row, record
11
+ immutable object identities/hashes and verify a new-table restore drill. Do not
12
+ reuse an old prefix or treat process exit/log success as recoverability proof.
@@ -0,0 +1,10 @@
1
+ # Application-owned SDK export alternative
2
+
3
+ Design, do not run: bounded primary-shard/SQL iteration into versioned JSON with
4
+ schema, lossless types, original row expiration, hashes and progress manifest.
5
+ Follow every continuation even on empty pages; checkpoints bind exact query/tenant/
6
+ schema and resume only against unchanged quiesced source. SDK pagination is NOT a
7
+ snapshot, native backup, CDC or PITR. Budget every retry/read/storage write. Keep
8
+ all writes quiesced or mark the artifact non-atomic and unable to meet exact-point
9
+ RPO. Test complete key coverage, duplicate handling and restore with representative
10
+ type/TTL cases. Do not promote the query helper into a complete backup tool.
@@ -0,0 +1,7 @@
1
+ # Backup dispatcher
2
+
3
+ Customer-owned recovery, not a native PITR snapshot. Select only `backup/migrator.md`
4
+ or `backup/sdk.md`; use the recovery-boundary guide for shared evidence. Require
5
+ source identity, consistency strategy, quiescence window, retention/key budget,
6
+ exact destination and separately approved read/export/storage writes. No automatic
7
+ backup, schedule or broad scan on load; request/plan is not execution proof.
@@ -0,0 +1,10 @@
1
+ # Design
2
+
3
+ Capture service/API, workload, authenticated tenant, row/retention sizes, request
4
+ rates, latency/staleness objectives and source of truth. Produce an access-pattern
5
+ matrix: full primary key / shard-bounded range / secondary index / explicitly
6
+ priced scatter query. Pick shard keys for distribution and atomicity, not vanity
7
+ single-table parity. State multi-tenant enforcement, schema/JSON tradeoffs,
8
+ continuation and version contracts. Load only selected features; provisioning and
9
+ one language adapter load only when code/IaC is requested. Return alternatives,
10
+ small proposed artifacts and PASS/MISS/UNVERIFIED; do not create a table.
@@ -0,0 +1,10 @@
1
+ # Feature lifecycle plan
2
+
3
+ Return proposed current→desired delta, prerequisites, exact targets, IAM/key cost,
4
+ blast radius, preview, rollback and verification. `ttl` supports planned enable/
5
+ disable/configure; disabling table default does not resurrect expired rows or
6
+ rewrite existing expiration. indexes/replicas allow enable/configure, not generic
7
+ disable (destruction needs its own approved plan). IAM/encryption/monitoring/
8
+ embeddings/backup are configure-only. Native vector enablement and PITR reject.
9
+ Never add `kms_key_id` to a table: dedicated CMEK environment eligibility and
10
+ service-owner procedures come first. No generic switches across every bundle.
@@ -0,0 +1,8 @@
1
+ # Help — show and stop
2
+
3
+ List help/select/design/refactor/audit/performance-test/feature-plan/backup/restore.
4
+ Features: core,indexes,iam,encryption,ttl,replicas,monitoring,vectors,embeddings,backup.
5
+ Audit defaults offline; backup/restore `--method migrator|sdk` defaults migrator.
6
+ `vectors` explains the native capability boundary, not feature activation. There is
7
+ no native PITR/Streams/DAX alias. Run only the local selector if requested; read no
8
+ workspace/cloud/environment/reference siblings from help. No host registration.
@@ -0,0 +1,12 @@
1
+ # Bounded performance plan — no execution
2
+
3
+ Require local or explicit nonproduction target, synthetic/non-sensitive dataset,
4
+ known partition/tenant skew, warm/cold phases, selected SQL/index and consistency.
5
+ Selector defaults: 30 seconds, 500 requests, 2 concurrency; all positive. Also require
6
+ rate ceiling, total attempts including retries, RU/WU/storage/cost cap, timeout,
7
+ p95/p99/error/throttle stop rules, owner and emergency stop. Never infer execution
8
+ approval from this route; no production choice exists. Test hot shard, wide row,
9
+ empty continuation page, version conflict and SDK retry interaction. Capture
10
+ consumed units, latency distribution and sample size; local/fake results cannot
11
+ prove OCI capacity/SLA. External ANN tests add tenant isolation, recall@k and stale
12
+ source/deletion recall metrics; ordinary index latency is not vector quality.
@@ -0,0 +1,9 @@
1
+ # Refactor
2
+
3
+ Inspect supplied code/DDL/IaC and sanitized shape, not production rows. Classify
4
+ code-only, additive schema/index, incompatible key/type or regional change. Preserve
5
+ existing table owner and public contracts. Append compatible fields; changing shard
6
+ or primary key needs a new table and explicit migration/cutover plan. Do not
7
+ recreate, drop, stamp ownership or hide a scan fallback. Specify dual-reader/writer
8
+ compatibility, bounded backfill, expiry preservation, delete/tombstone handling,
9
+ reconciliation and rollback cutoff. A local diff/test is not runtime migration proof.
@@ -0,0 +1,13 @@
1
+ # Migrator import to a new table
2
+
3
+ Review [import config](../../../assets/migrator-import.json) and only the exact
4
+ manifest/object versions. Rewrite the saved schema to the approved NEW table name
5
+ with one DDL statement per line; do not blindly execute source-name DDL or infer
6
+ that `table` renames every saved statement. Include only reviewed create/index DDL;
7
+ no DROP or IF NOT EXISTS. Keep `overwrite:false`, `abortOnError:true`, explicit TTL
8
+ handling. Intended command after approval: `runMigrator --config reviewed-import.json`.
9
+ An existing destination is a stop, even if inserts would be non-overwriting.
10
+ Wait for table/index work requests, independently read ACTIVE state/schema/limits,
11
+ then validate counts/per-key hashes/types/tenant queries/expiry and failed/skipped
12
+ rows. Restore IAM/tags/alarms/key/topology separately. Resume traffic only after a
13
+ separately approved application cutover and rollback rehearsal; waiter alone fails.
@@ -0,0 +1,11 @@
1
+ # Application-owned SDK import alternative
2
+
3
+ Create a separately approved new table with reviewed DDL/capacity/index/security;
4
+ conditional insert-only writes (`putIfAbsent`/equivalent), never upsert over existing
5
+ data. Verify manifest hashes/types first, preserve original absolute expiry rather
6
+ than restart TTL, and record already-expired rows as deliberately excluded. Bound
7
+ retry attempts, reject version conflicts, and reconcile expected keys/duplicates/
8
+ counts. A resumed importer needs an explicit checkpoint/idempotency design; a
9
+ collision is not permission to overwrite. Rebuild selected metadata/dependencies;
10
+ validate application queries and measured RPO/RTO before approved cutover. This is
11
+ a design contract, not a shipped turnkey backup/restore implementation.