@raishin/vanguard-frontier-agentic 3.18.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 (594) 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 +620 -75
  74. package/catalog/install-roles.json +19 -1
  75. package/catalog/model-assignments.json +231 -0
  76. package/catalog/skill-manifest.json +2074 -527
  77. package/catalog/skills.json +314 -14
  78. package/package.json +8 -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/rules/codex/cloud-provenance-rule.md +1 -1
  87. package/scripts/generate-kiro-powers.mjs +2 -2
  88. package/skills/alibaba/README.md +2 -1
  89. package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
  90. package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
  91. package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
  92. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
  93. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
  94. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
  95. package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
  96. package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
  97. package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
  98. package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
  99. package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
  100. package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
  101. package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
  102. package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
  103. package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
  104. package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
  105. package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
  106. package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
  107. package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
  108. package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
  109. package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
  110. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
  111. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
  112. package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
  113. package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
  114. package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
  115. package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
  116. package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
  117. package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
  118. package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
  119. package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
  120. package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
  121. package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
  122. package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
  123. package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
  124. package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
  125. package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
  126. package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
  127. package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
  128. package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
  129. package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
  130. package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
  131. package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
  132. package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
  133. package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
  134. package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
  135. package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
  136. package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
  137. package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
  138. package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
  139. package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
  140. package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
  141. package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
  142. package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
  143. package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
  144. package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
  145. package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
  146. package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
  147. package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
  148. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
  149. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
  150. package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
  151. package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
  152. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
  153. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
  154. package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
  155. package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
  156. package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
  157. package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
  158. package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
  159. package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
  160. package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
  161. package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
  162. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
  163. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
  164. package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
  165. package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
  166. package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
  167. package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
  168. package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
  169. package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
  170. package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
  171. package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
  172. package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
  173. package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
  174. package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
  175. package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
  176. package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
  177. package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
  178. package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
  179. package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
  180. package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
  181. package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
  182. package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
  183. package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
  184. package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
  185. package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
  186. package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
  187. package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
  188. package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
  189. package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
  190. package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
  191. package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
  192. package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
  193. package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
  194. package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
  195. package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
  196. package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
  197. package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
  198. package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
  199. package/skills/aws/aws-maestro/SKILL.md +1 -1
  200. package/skills/aws/aws-maestro/metadata.json +1 -1
  201. package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
  202. package/skills/azure/azure-ai-foundry-ops-governor/SKILL.md +2 -2
  203. package/skills/azure/azure-aks-platform-operator/SKILL.md +1 -1
  204. package/skills/azure/azure-app-service-production-readiness/SKILL.md +1 -1
  205. package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +5 -3
  206. package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
  207. package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
  208. package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
  209. package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
  210. package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
  211. package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
  212. package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
  213. package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
  214. package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
  215. package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
  216. package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
  217. package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
  218. package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
  219. package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
  220. package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
  221. package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
  222. package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
  223. package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
  224. package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
  225. package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
  226. package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
  227. package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
  228. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
  229. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
  230. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
  231. package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
  232. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
  233. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
  234. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
  235. package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
  236. package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
  237. package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
  238. package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
  239. package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
  240. package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
  241. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
  242. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
  243. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
  244. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
  245. package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
  246. package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
  247. package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
  248. package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
  249. package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
  250. package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
  251. package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
  252. package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
  253. package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
  254. package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
  255. package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
  256. package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
  257. package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
  258. package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
  259. package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
  260. package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
  261. package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
  262. package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
  263. package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
  264. package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
  265. package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
  266. package/skills/azure/azure-cosmosdb-performance-investigator/SKILL.md +1 -1
  267. package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +7 -3
  268. package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
  269. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
  270. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
  271. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
  272. package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
  273. package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
  274. package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
  275. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
  276. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
  277. package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
  278. package/skills/azure/azure-cost-estimation-review/SKILL.md +1 -1
  279. package/skills/azure/azure-cost-optimization-governor/SKILL.md +1 -1
  280. package/skills/azure/azure-entra-id-specialist/SKILL.md +1 -1
  281. package/skills/azure/azure-governance-policy-guardrails/SKILL.md +1 -1
  282. package/skills/azure/azure-identity-governance-review/SKILL.md +1 -1
  283. package/skills/azure/azure-key-vault-secret-lifecycle-auditor/SKILL.md +1 -1
  284. package/skills/azure/azure-landing-zone-architect/SKILL.md +1 -1
  285. package/skills/azure/azure-maestro/SKILL.md +2 -1
  286. package/skills/azure/azure-migrate-landing-zone-cutover/SKILL.md +1 -1
  287. package/skills/azure/azure-network-topology-review/SKILL.md +1 -1
  288. package/skills/azure/azure-observability-investigator/SKILL.md +1 -1
  289. package/skills/azure/azure-platform-automation-devops/SKILL.md +1 -1
  290. package/skills/azure/azure-private-endpoint-adoption-planner/SKILL.md +1 -1
  291. package/skills/azure/azure-rbac-review/SKILL.md +1 -1
  292. package/skills/azure/azure-resilience-bcdr-review/SKILL.md +1 -1
  293. package/skills/azure/azure-resource-health-incident-triage/SKILL.md +1 -1
  294. package/skills/azure/azure-role-selector/SKILL.md +1 -1
  295. package/skills/azure/azure-security-posture-hardening/SKILL.md +1 -1
  296. package/skills/azure/azure-subscription-resource-organization/SKILL.md +1 -1
  297. package/skills/azure/azure-waf-cost-optimization-review/SKILL.md +1 -1
  298. package/skills/azure/azure-waf-reliability-review/SKILL.md +1 -1
  299. package/skills/azure/azure-waf-security-review/SKILL.md +1 -1
  300. package/skills/contabo/contabo-security-hardening/SKILL.md +1 -1
  301. package/skills/cross-functional/agentic-board-protocol/SKILL.md +1 -1
  302. package/skills/cross-functional/copilot-data-readiness-protocol/SKILL.md +1 -1
  303. package/skills/cross-functional/salesforce-case-capsule/SKILL.md +1 -1
  304. package/skills/cross-functional/salesforce-data-exposure-escalation-protocol/SKILL.md +1 -1
  305. package/skills/cross-functional/salesforce-live-change-approval-protocol/SKILL.md +1 -1
  306. package/skills/cross-functional/salesforce-risk-taxonomy/SKILL.md +1 -1
  307. package/skills/databricks/databricks-lakehouse-engineering-at-azure/SKILL.md +1 -1
  308. package/skills/databricks/databricks-unity-catalog-governance-at-azure/SKILL.md +1 -1
  309. package/skills/dotnet/dotnet-performance-aot-review/SKILL.md +1 -1
  310. package/skills/frontend/vue-router-navigation-security-review/SKILL.md +1 -1
  311. package/skills/gcp/README.md +2 -1
  312. package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
  313. package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
  314. package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
  315. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
  316. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
  317. package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
  318. package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
  319. package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
  320. package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
  321. package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
  322. package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
  323. package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
  324. package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
  325. package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
  326. package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
  327. package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
  328. package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
  329. package/skills/gcp/gcp-maestro/SKILL.md +2 -1
  330. package/skills/huawei/README.md +2 -1
  331. package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
  332. package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
  333. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
  334. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
  335. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
  336. package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
  337. package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
  338. package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
  339. package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
  340. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
  341. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
  342. package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
  343. package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
  344. package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
  345. package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
  346. package/skills/huawei/huawei-maestro/SKILL.md +2 -1
  347. package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
  348. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
  349. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
  350. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
  351. package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
  352. package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
  353. package/skills/java/java-application-server-exit/SKILL.md +1 -1
  354. package/skills/java/java-jvm-performance-and-gc/SKILL.md +1 -1
  355. package/skills/java/java-resilience-pattern/SKILL.md +1 -1
  356. package/skills/java/java-test-architecture/SKILL.md +1 -1
  357. package/skills/java/java-transaction-and-consistency/SKILL.md +1 -1
  358. package/skills/kubernetes/kubernetes-rbac-review/SKILL.md +1 -1
  359. package/skills/marketing/analytics-data-minimization-review/SKILL.md +1 -1
  360. package/skills/microsoft/d365-customer-insights-journeys/SKILL.md +1 -1
  361. package/skills/microsoft/fabric-analytics-engineering/SKILL.md +1 -1
  362. package/skills/microsoft/m365-defender-xdr-security-operations/SKILL.md +1 -1
  363. package/skills/microsoft/m365-purview-data-security-compliance/SKILL.md +1 -1
  364. package/skills/oci/README.md +6 -1
  365. package/skills/oci/oci-autonomous-database-architect/SKILL.md +1 -1
  366. package/skills/oci/oci-certificates-issuer-review/SKILL.md +1 -1
  367. package/skills/oci/oci-cloud-guard-responder/SKILL.md +1 -1
  368. package/skills/oci/oci-compute-instance-agent-operator/SKILL.md +1 -1
  369. package/skills/oci/oci-compute-platform-operator/SKILL.md +1 -1
  370. package/skills/oci/oci-cost-finops-analyst/SKILL.md +1 -1
  371. package/skills/oci/oci-database-platform-dba/SKILL.md +1 -1
  372. package/skills/oci/oci-dbtools-sql-analyst/SKILL.md +1 -1
  373. package/skills/oci/oci-devops-container-platform-engineer/SKILL.md +1 -1
  374. package/skills/oci/oci-exadata-database-architect/SKILL.md +1 -1
  375. package/skills/oci/oci-exadata-platform-architect/SKILL.md +1 -1
  376. package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md +1 -1
  377. package/skills/oci/oci-goldengate-replication-operator/SKILL.md +1 -1
  378. package/skills/oci/oci-identity-access-governor/SKILL.md +1 -1
  379. package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md +1 -1
  380. package/skills/oci/oci-limits-capacity-planner/SKILL.md +1 -1
  381. package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md +1 -1
  382. package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md +1 -1
  383. package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md +1 -1
  384. package/skills/oci/oci-live-network-security-rule-guard/SKILL.md +1 -1
  385. package/skills/oci/oci-live-oke-rollout-guard/SKILL.md +1 -1
  386. package/skills/oci/oci-live-resource-manager-stack-guard/SKILL.md +1 -1
  387. package/skills/oci/oci-live-vault-key-destruction-guard/SKILL.md +1 -1
  388. package/skills/oci/oci-load-balancer-traffic-engineer/SKILL.md +1 -1
  389. package/skills/oci/oci-maestro/SKILL.md +1 -1
  390. package/skills/oci/oci-migration-cutover-architect/SKILL.md +1 -1
  391. package/skills/oci/oci-multi-cloud-architect/SKILL.md +1 -1
  392. package/skills/oci/oci-mysql-heatwave-ai-specialist/SKILL.md +1 -1
  393. package/skills/oci/oci-network-architect/SKILL.md +1 -1
  394. package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
  395. package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
  396. package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
  397. package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
  398. package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
  399. package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
  400. package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
  401. package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
  402. package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
  403. package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
  404. package/skills/oci/oci-nosql-pattern/README.md +81 -0
  405. package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
  406. package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
  407. package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
  408. package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
  409. package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
  410. package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
  411. package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
  412. package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
  413. package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
  414. package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
  415. package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
  416. package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
  417. package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
  418. package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
  419. package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
  420. package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
  421. package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
  422. package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
  423. package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
  424. package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
  425. package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
  426. package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
  427. package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
  428. package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
  429. package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
  430. package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
  431. package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
  432. package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
  433. package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
  434. package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
  435. package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
  436. package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
  437. package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
  438. package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
  439. package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
  440. package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
  441. package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
  442. package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
  443. package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
  444. package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
  445. package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
  446. package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
  447. package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
  448. package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
  449. package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
  450. package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
  451. package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
  452. package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
  453. package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
  454. package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
  455. package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
  456. package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
  457. package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
  458. package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
  459. package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
  460. package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
  461. package/skills/oci/oci-observability-incident-responder/SKILL.md +1 -1
  462. package/skills/oci/oci-recovery-service-operator/SKILL.md +1 -1
  463. package/skills/oci/oci-registry-artifact-governor/SKILL.md +1 -1
  464. package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md +1 -1
  465. package/skills/oci/oci-security-compliance-reviewer/SKILL.md +1 -1
  466. package/skills/oci/oci-solution-architect/SKILL.md +1 -1
  467. package/skills/oci/oci-storage-backup-steward/SKILL.md +1 -1
  468. package/skills/oci/oci-support-incident-coordinator/SKILL.md +1 -1
  469. package/skills/oci/oci-waf-cost-optimization-review/SKILL.md +1 -1
  470. package/skills/oci/oci-waf-reliability-review/SKILL.md +1 -1
  471. package/skills/oci/oci-waf-security-review/SKILL.md +1 -1
  472. package/skills/oci/oracle-oci-mcp-grounded-advisor/SKILL.md +1 -1
  473. package/skills/ovhcloud/ovhcloud-cost-finops-analyst/SKILL.md +1 -1
  474. package/skills/ovhcloud/ovhcloud-live-kms-key-destruction-guard/SKILL.md +1 -1
  475. package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
  476. package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
  477. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
  478. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
  479. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
  480. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
  481. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
  482. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
  483. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
  484. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
  485. package/skills/salesforce/salesforce-agentforce-risk-review-skill/SKILL.md +1 -1
  486. package/skills/salesforce/salesforce-apex-lwc-code-review-skill/SKILL.md +1 -1
  487. package/skills/salesforce/salesforce-devsecops-pipeline-skill/SKILL.md +1 -1
  488. package/skills/salesforce/salesforce-flow-automation-review-skill/SKILL.md +1 -1
  489. package/skills/salesforce/salesforce-infrastructure-audit-skill/SKILL.md +1 -1
  490. package/skills/salesforce/salesforce-integration-review-skill/SKILL.md +1 -1
  491. package/skills/salesforce/salesforce-marketing-consent-review-skill/SKILL.md +1 -1
  492. package/skills/salesforce/salesforce-metadata-review-skill/SKILL.md +1 -1
  493. package/skills/salesforce/salesforce-org-assessment-skill/SKILL.md +1 -1
  494. package/skills/salesforce/salesforce-permission-model-review-skill/SKILL.md +1 -1
  495. package/skills/salesforce/salesforce-release-readiness-skill/SKILL.md +1 -1
  496. package/skills/salesforce/salesforce-zero-trust-maturity-skill/SKILL.md +1 -1
  497. package/skills/sap/sap-analytics-cloud-planning-governance/SKILL.md +1 -1
  498. package/skills/sap/sap-btp-governance-review/SKILL.md +1 -1
  499. package/skills/sap/sap-cloud-alm-sre-incident-review/SKILL.md +1 -1
  500. package/skills/sap/sap-datasphere-data-product-architecture/SKILL.md +1 -1
  501. package/skills/sap/sap-ewm-tm-logistics-execution-review/SKILL.md +1 -1
  502. package/skills/sap/sap-finance-fico-controls-review/SKILL.md +1 -1
  503. package/skills/sap/sap-hana-cloud-performance-cost/SKILL.md +1 -1
  504. package/skills/sap/sap-hypercare-incident-commander-review/SKILL.md +1 -1
  505. package/skills/sap/sap-integration-suite-review/SKILL.md +1 -1
  506. package/skills/sap/sap-joule-governance-adoption-review/SKILL.md +1 -1
  507. package/skills/sap/sap-license-btp-consumption-finops-review/SKILL.md +1 -1
  508. package/skills/sap/sap-manufacturing-execution-risk-review/SKILL.md +1 -1
  509. package/skills/sap/sap-mdg-master-data-quality-review/SKILL.md +1 -1
  510. package/skills/sap/sap-order-to-cash-review/SKILL.md +1 -1
  511. package/skills/sap/sap-procurement-ariba-value-leakage-review/SKILL.md +1 -1
  512. package/skills/sap/sap-release-change-collision-review/SKILL.md +1 -1
  513. package/skills/sap/sap-rise-sla-vendor-risk-review/SKILL.md +1 -1
  514. package/skills/sap/sap-security-iam-grc-sod-review/SKILL.md +1 -1
  515. package/skills/sap/sap-signavio-process-mining-value/SKILL.md +1 -1
  516. package/skills/sap/sap-successfactors-hr-process-risk-review/SKILL.md +1 -1
  517. package/skills/sap/sap-supply-chain-ibp-resilience-review/SKILL.md +1 -1
  518. package/skills/sap/sap-testing-quality-gate-review/SKILL.md +1 -1
  519. package/skills/sap/sap-transformation-portfolio-triage-review/SKILL.md +1 -1
  520. package/skills/sap/sap-treasury-cash-risk-review/SKILL.md +1 -1
  521. package/skills/scaleway/scaleway-kapsule-platform-operator/SKILL.md +1 -1
  522. package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
  523. package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
  524. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
  525. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
  526. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
  527. package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
  528. package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
  529. package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
  530. package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
  531. package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
  532. package/skills/scaleway/scaleway-network-architect/SKILL.md +1 -1
  533. package/templates/nosql-audit-template.md +127 -0
  534. package/templates/nosql-operations-template.md +60 -0
  535. package/tests/_generate_maestro_routing_fixtures.py +11 -0
  536. package/tests/fixtures/README.md +2 -2
  537. package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
  538. package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
  539. package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
  540. package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
  541. package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
  542. package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
  543. package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
  544. package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
  545. package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
  546. package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
  547. package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
  548. package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
  549. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
  550. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
  551. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
  552. package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
  553. package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
  554. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
  555. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
  556. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
  557. package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
  558. package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
  559. package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
  560. package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
  561. package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
  562. package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
  563. package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
  564. package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
  565. package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
  566. package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
  567. package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
  568. package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
  569. package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
  570. package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
  571. package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
  572. package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
  573. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
  574. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
  575. package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
  576. package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
  577. package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
  578. package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
  579. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
  580. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
  581. package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
  582. package/tests/requirements-ci.txt +8 -0
  583. package/tests/test-marketplace-validators.py +7 -1
  584. package/tests/validate-agent-frontmatter-schema.py +7 -1
  585. package/tests/validate-aws-skill-quality.py +7 -0
  586. package/tests/validate-kiro-powers.py +8 -1
  587. package/tests/validate-nosql-audit.py +741 -0
  588. package/tests/validate-nosql-operations.py +136 -0
  589. package/tests/validate-nosql-pattern-evals.py +96 -0
  590. package/tests/validate-nosql-scenarios.py +94 -0
  591. package/tests/validate-skill-frontmatter-schema.py +7 -1
  592. package/tests/validate-skill-manifest.py +6 -1
  593. package/tests/validate-skill-references.py +225 -0
  594. package/tests/validate-skill-yaml-strict.py +84 -0
@@ -0,0 +1,741 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: every NoSQL skill has a lazy-loaded audit with offline and live variants.
3
+
4
+ Covers each skill directory in ``validate-nosql-operations.py``'s ``SERVICES`` plus
5
+ the ported pattern skills. Each skill must ship:
6
+
7
+ * ``references/commands/audit.md`` (the router), linked from ``SKILL.md``;
8
+ * ``references/commands/audit/offline.md`` and ``references/commands/audit/live.md``,
9
+ linked from the router and **not** from ``SKILL.md``, so an agent loads the
10
+ router first and then exactly one variant;
11
+ * a router that says to load only one variant.
12
+
13
+ For the operations skills (not the pattern skills, whose audit is feature-based and
14
+ canonical upstream), both variants carry the ten operations headings in order, and
15
+ every live section either has a command block plus a citation, or a
16
+ ``**No live command:**`` line giving the reason.
17
+
18
+ Command safety is an allowlist, checked on every fenced block in either variant
19
+ (only blocks tagged as data such as ``json`` or ``yaml`` are skipped; ``console``
20
+ blocks are rejected). Each block is lexed with shell rules, so commands after
21
+ ``if``/``then``/``!``/``{``, after ``&&``/``||``/``|``/``;``, inside ``$(...)``,
22
+ backticks, process substitution and ``${VAR:-$(...)}`` defaults are all checked, and ``"${name[@]}"`` heads are
23
+ expanded from their array definition, which is frozen: the array may appear
24
+ nowhere else in the file:
25
+
26
+ * every command head must be on the mode's allowlist (``LIVE_HEADS`` or
27
+ ``OFFLINE_HEADS``); wrappers such as ``env``, ``xargs``, ``bash -c``, ``eval``,
28
+ absolute paths and heads taken from variables are rejected;
29
+ * live: a cloud CLI's action (the last word of its subcommand path) starts with a
30
+ read verb; no path word is mutating, secret-reading (``keys``, ``secret``,
31
+ ``connection strings``, ...) or a data-plane read (``query``, ``get-item``,
32
+ ``read-rows``, ...); no confirmation-bypass or decryption flag; ``curl`` takes only
33
+ allowlisted options and GET; ``python3`` runs only a quoted heredoc that imports
34
+ ``json``/``sys`` (listed attributes only) and calls ``open(path)`` directly, read-only;
35
+ * offline: no cloud CLI, network tool or data shell; ``terraform``/``tofu`` only
36
+ ``show``; ``rg --pre``, ``find -exec``/``-delete``, ``git -c`` and non-read git
37
+ subcommands are rejected; ``python3`` only runs the skill's own ``scripts/*.py``;
38
+ * ``rg``/``grep`` searches for credential patterns list file names only (``-l``),
39
+ so an audit never prints a secret it finds;
40
+ * heredoc delimiters are quoted (an unquoted body would expand ``$(...)``), and
41
+ arithmetic expansion and ANSI-C quoting are rejected;
42
+ * every evidence ID cited in a live file is a VERIFIED row of the skill's ledger,
43
+ and every ID cited in an offline file exists.
44
+
45
+ The file shapes live in ``templates/nosql-audit-template.md``. Never weaken a rule
46
+ to get green; reword the command or record ``**No live command:**`` instead.
47
+ """
48
+
49
+ import ast
50
+ import importlib.util
51
+ import re
52
+ import sys
53
+ from dataclasses import dataclass, field
54
+ from pathlib import Path
55
+
56
+ REPO = Path(__file__).resolve().parents[1]
57
+ _spec = importlib.util.spec_from_file_location("nosql_ops", REPO / "tests/validate-nosql-operations.py")
58
+ _ops = importlib.util.module_from_spec(_spec)
59
+ _spec.loader.exec_module(_ops)
60
+
61
+ PATTERN_SKILLS = [
62
+ "skills/aws/aws-dynamodb-patterns",
63
+ "skills/oci/oci-nosql-pattern",
64
+ "skills/azure/azure-cosmosdb-pattern",
65
+ ]
66
+ SKILLS = sorted({skill for skill, _ in _ops.SERVICES.values()} | set(PATTERN_SKILLS))
67
+ SECTIONS = _ops.SECTIONS
68
+ ROUTER = "references/commands/audit.md"
69
+ VARIANTS = {"offline": "references/commands/audit/offline.md", "live": "references/commands/audit/live.md"}
70
+ NO_LIVE = "**No live command:**"
71
+
72
+ CLOUD_CLIS = {"aws", "az", "gcloud", "oci", "aliyun", "hcloud", "scw", "ovhcloud", "ionosctl", "cbt", "bq", "firebase"}
73
+ DATA_SHELLS = {"mongosh", "mongo", "cqlsh", "mongodump", "mongoexport", "mongorestore", "mongoimport"}
74
+ NETWORK_TOOLS = {"curl", "wget"}
75
+ SHELL_UTILS = {":", "echo", "printf", "test", "[", "true", "false"}
76
+ LIVE_HEADS = CLOUD_CLIS | SHELL_UTILS | {"umask", "mktemp", "mkdir", "set", "exit", "grep", "jq", "curl", "python3"}
77
+ OFFLINE_HEADS = SHELL_UTILS | {"rg", "grep", "jq", "find", "git", "head", "tail", "sort", "wc", "cd", "terraform", "tofu",
78
+ "python3"}
79
+ KEYWORDS = {"if", "then", "else", "elif", "fi", "do", "done", "while", "until", "{", "}", "!"}
80
+
81
+ READ_VERBS = {"describe", "get", "list", "show", "ls", "view", "info", "status", "inspect", "lookup", "whoami"}
82
+ READ_EXCEPTIONS = {("gcloud", "logging", "read")} # audit-log entries, not customer data
83
+ MUTATING_EXACT = {"set", "add", "untag", "run", "put", "stop", "exec", "move", "edit", "copy", "grant", "apply", "patch",
84
+ "deploy", "drop", "write", "cancel", "purge", "rotate", "revoke", "assign", "unassign", "promote", "rename",
85
+ "replace", "scale", "resize", "attach", "detach", "upload", "invoke", "insert", "reset", "clone", "change",
86
+ "start", "reboot", "migrate", "upgrade", "terminate", "kill", "truncate", "decrypt", "encrypt", "sign"}
87
+ MUTATING_PREFIX = ("create", "delete", "update", "modify", "restore", "remove", "enable", "disable", "import", "export",
88
+ "failover", "switchover", "register", "deregister", "execute")
89
+ SECRET_WORDS = {"keys", "secret", "secrets", "secretsmanager", "password", "passwords", "credential", "credentials",
90
+ "token", "tokens", "decryption", "decrypt"}
91
+ SECRET_PAIRS = {("connection", "string"), ("connection", "strings"), ("access", "key"), ("master", "key")}
92
+ DATA_WORDS = {"item", "items", "row", "rows", "record", "records", "query", "scan", "statement", "statements",
93
+ "document", "documents", "object", "objects", "range", "read"}
94
+ DATA_ACTIONS = {"lookup", "count", "select", "sample", "sample-row-keys"} # whole action, e.g. cbt lookup
95
+ LISTABLE_DATA = {"object", "objects"} # listing object names (backup inventory) is metadata
96
+ BYPASS_FLAGS = {"--force", "--yes", "-y", "--assume-yes", "--no-confirm", "--quiet-confirm"}
97
+
98
+ CURL_FLAGS = {"--silent", "--show-error", "--fail", "--fail-with-body", "--location", "--compressed", "--globoff"}
99
+ CURL_VALUE_FLAGS = {"--header", "--max-time", "--connect-timeout", "--output", "--write-out", "--retry", "--url",
100
+ "--request"}
101
+ CURL_SHORT = {"s": False, "S": False, "f": False, "L": False, "g": False, "H": True, "m": True, "o": True, "w": True,
102
+ "X": True}
103
+ GIT_READ = {"log", "show", "grep", "ls-files", "diff", "blame", "rev-parse", "status"}
104
+ FIND_BANNED = {"-exec", "-execdir", "-ok", "-okdir", "-delete", "-fprint", "-fprint0", "-fprintf", "-fls"}
105
+ PY_IMPORTS = {"json", "sys"}
106
+ PY_ATTRS = {"sys": {"argv", "exit", "stdin", "stdout", "stderr"},
107
+ "json": {"load", "loads", "dump", "dumps", "JSONDecodeError"}} # sys.modules would reach os
108
+ PY_BANNED_NAMES = {"__import__", "exec", "eval", "compile", "getattr", "setattr", "globals", "locals", "vars",
109
+ "breakpoint", "input", "__builtins__"}
110
+ CREDENTIAL_PATTERN = re.compile(r"accountkey|sharedaccesskey|passw|secret|private.?key|api.?key|token|"
111
+ r"://[^\s/]*:[^\s/]*@|mongodb(\+srv)?://", re.IGNORECASE)
112
+ NAMES_ONLY = {"-l", "--files-with-matches", "-c", "--count", "-q", "--quiet"}
113
+ DATA_LANGS = {"json", "jsonc", "yaml", "yml", "hcl", "toml", "xml", "csv", "diff", "markdown", "md"}
114
+ SESSION_LANGS = {"console", "shell-session", "sh-session", "terminal", "shellsession"}
115
+ OPERATORS = ["&&", "||", ";;", "|&", ";", "&", "|", "(", ")"]
116
+ REDIRECTS = ["&>>", "<<<", "<<-", "<<", ">>", "&>", ">&", "<&", ">|", "<>", "<", ">"]
117
+ NAME = r"[A-Za-z_]\w*"
118
+
119
+
120
+ @dataclass
121
+ class Word:
122
+ value: str # after quote removal; expansions kept as written
123
+ raw: str # source text
124
+ dynamic: bool # contains a parameter expansion or substitution
125
+ quoted: bool
126
+
127
+
128
+ @dataclass
129
+ class Token:
130
+ kind: str # "word", "op", "redir"
131
+ text: str = ""
132
+ word: Word | None = None
133
+ heredoc: dict | None = None
134
+
135
+
136
+ @dataclass
137
+ class Command:
138
+ words: list[Word]
139
+ heredocs: list[dict] = field(default_factory=list)
140
+ aliases: dict = field(default_factory=dict) # array definitions in force where it runs
141
+
142
+
143
+ class Lexer:
144
+ """A small shell lexer: quotes, escapes, comments, operators, redirections,
145
+ heredocs, ``$(...)``, backticks and process substitution. Anything it cannot
146
+ model safely is reported as a problem (fail closed)."""
147
+
148
+ def __init__(self, text: str) -> None:
149
+ self.s = text
150
+ self.i = 0
151
+ self.problems: list[str] = []
152
+ self.nested: list[list[Token]] = []
153
+ self.pending: list[dict] = []
154
+
155
+ def run(self, close: bool = False) -> list[Token]:
156
+ s, tokens, depth = self.s, [], 0
157
+ chars: list[str] = []
158
+ state = {"raw_start": None, "dynamic": False, "quoted": False}
159
+
160
+ def flush() -> None:
161
+ if state["raw_start"] is not None:
162
+ word = Word("".join(chars), s[state["raw_start"]:self.i], state["dynamic"], state["quoted"])
163
+ tokens.append(Token("word", word=word))
164
+ if len(tokens) >= 2 and tokens[-2].kind == "redir" and tokens[-2].heredoc is not None:
165
+ doc = tokens[-2].heredoc
166
+ doc["delim"] = word.value
167
+ doc["quoted"] = word.quoted or "\\" in word.raw
168
+ self.pending.append(doc)
169
+ chars.clear()
170
+ state.update(raw_start=None, dynamic=False, quoted=False)
171
+
172
+ def begin() -> None:
173
+ if state["raw_start"] is None:
174
+ state["raw_start"] = self.i
175
+
176
+ while self.i < len(s):
177
+ c = s[self.i]
178
+ if c == "\\":
179
+ if s[self.i + 1:self.i + 2] == "\n":
180
+ self.i += 2
181
+ continue
182
+ begin()
183
+ chars.append(s[self.i + 1:self.i + 2])
184
+ self.i += 2
185
+ continue
186
+ if c in " \t":
187
+ flush()
188
+ self.i += 1
189
+ continue
190
+ if c == "\n":
191
+ flush()
192
+ tokens.append(Token("op", "\n"))
193
+ self.i += 1
194
+ self.read_heredocs()
195
+ continue
196
+ if c == "#" and state["raw_start"] is None:
197
+ end = s.find("\n", self.i)
198
+ self.i = len(s) if end < 0 else end
199
+ continue
200
+ if c == "'":
201
+ begin()
202
+ end = s.find("'", self.i + 1)
203
+ if end < 0:
204
+ self.problems.append("unterminated single quote")
205
+ end = len(s)
206
+ chars.append(s[self.i + 1:end])
207
+ state["quoted"] = True
208
+ self.i = end + 1
209
+ continue
210
+ if c == '"':
211
+ begin()
212
+ state["quoted"] = True
213
+ self.i += 1
214
+ while self.i < len(s) and s[self.i] != '"':
215
+ d = s[self.i]
216
+ if d == "\\" and s[self.i + 1:self.i + 2] in ('"', "\\", "$", "`", "\n"):
217
+ if s[self.i + 1] != "\n":
218
+ chars.append(s[self.i + 1])
219
+ self.i += 2
220
+ elif d in "$`":
221
+ state["dynamic"] |= self.expansion(chars)
222
+ else:
223
+ chars.append(d)
224
+ self.i += 1
225
+ if self.i >= len(s):
226
+ self.problems.append("unterminated double quote")
227
+ self.i += 1
228
+ continue
229
+ if c in "$`":
230
+ begin()
231
+ state["dynamic"] |= self.expansion(chars)
232
+ continue
233
+ if c in "<>" and s[self.i + 1:self.i + 2] == "(":
234
+ begin()
235
+ self.i += 2
236
+ self.nested.append(self.run(close=True))
237
+ chars.append("<(...)")
238
+ state["dynamic"] = True
239
+ continue
240
+ if c in "|&;()<>":
241
+ if c in "<>" and state["raw_start"] is not None and "".join(chars).isdigit():
242
+ chars.clear()
243
+ state.update(raw_start=None, dynamic=False, quoted=False)
244
+ flush()
245
+ if close and c == ")" and depth == 0:
246
+ self.i += 1
247
+ return tokens
248
+ op = next((o for o in REDIRECTS if s.startswith(o, self.i)), None)
249
+ if op and not (op == "&" or s.startswith("&&", self.i)):
250
+ token = Token("redir", op)
251
+ if op in ("<<", "<<-"):
252
+ token.heredoc = {"strip": op == "<<-", "body": None}
253
+ tokens.append(token)
254
+ self.i += len(op)
255
+ continue
256
+ op = next(o for o in OPERATORS if s.startswith(o, self.i))
257
+ depth += {"(": 1, ")": -1}.get(op, 0)
258
+ tokens.append(Token("op", op))
259
+ self.i += len(op)
260
+ continue
261
+ begin()
262
+ chars.append(c)
263
+ self.i += 1
264
+ flush()
265
+ if close:
266
+ self.problems.append("unterminated $( or <( substitution")
267
+ for doc in self.pending:
268
+ self.problems.append(f"heredoc '{doc['delim']}' has no terminator")
269
+ self.pending = []
270
+ return tokens
271
+
272
+ def expansion(self, chars: list[str]) -> bool:
273
+ """Consume one $-expansion or backtick at self.i; return True (dynamic)."""
274
+ s = self.s
275
+ if s[self.i] == "`":
276
+ end = self.i + 1
277
+ while end < len(s) and s[end] != "`":
278
+ end += 2 if s[end] == "\\" else 1
279
+ inner = Lexer(s[self.i + 1:end])
280
+ self.nested.append(inner.run())
281
+ self.nested += inner.nested
282
+ self.problems += inner.problems
283
+ chars.append("`...`")
284
+ self.i = end + 1
285
+ return True
286
+ nxt = s[self.i + 1:self.i + 2]
287
+ if s.startswith("$((", self.i):
288
+ self.problems.append("arithmetic expansion $((...)) is not allowed")
289
+ if nxt == "'":
290
+ self.problems.append("ANSI-C quoting $'...' is not allowed")
291
+ if nxt == "(":
292
+ self.i += 2
293
+ self.nested.append(self.run(close=True))
294
+ chars.append("$(...)")
295
+ return True
296
+ if s.startswith("${!", self.i):
297
+ self.problems.append("indirect expansion ${!...} is not allowed")
298
+ if nxt == "{":
299
+ # Walk the body: ${X:-$(cmd)} and ${X:-`cmd`} run cmd, so nested
300
+ # substitutions are lexed like any other; nested ${ } keep depth.
301
+ body, depth = ["${"], 1
302
+ self.i += 2
303
+ while self.i < len(s) and depth:
304
+ d = s[self.i]
305
+ if d == "\\":
306
+ body.append(s[self.i:self.i + 2])
307
+ self.i += 2
308
+ elif s.startswith("${", self.i):
309
+ body.append("${")
310
+ depth += 1
311
+ self.i += 2
312
+ elif d in "$`":
313
+ self.expansion(body)
314
+ else:
315
+ body.append(d)
316
+ depth -= d == "}"
317
+ self.i += 1
318
+ if depth:
319
+ self.problems.append("unterminated ${...} expansion")
320
+ chars.append("".join(body))
321
+ return True
322
+ match = re.match(r"\$(" + NAME + r"|[0-9@*#?$!-])", s[self.i:])
323
+ if match:
324
+ chars.append(match.group(0))
325
+ self.i += len(match.group(0))
326
+ return True
327
+ chars.append("$")
328
+ self.i += 1
329
+ return False
330
+
331
+ def read_heredocs(self) -> None:
332
+ for doc in self.pending:
333
+ body = []
334
+ while self.i < len(self.s):
335
+ end = self.s.find("\n", self.i)
336
+ end = len(self.s) if end < 0 else end
337
+ line = self.s[self.i:end]
338
+ self.i = end + 1
339
+ if (line.lstrip("\t") if doc["strip"] else line) == doc["delim"]:
340
+ doc["body"] = "\n".join(body)
341
+ break
342
+ body.append(line)
343
+ else:
344
+ self.problems.append(f"heredoc '{doc['delim']}' has no terminator")
345
+ doc["body"] = "\n".join(body)
346
+ if not doc["quoted"]:
347
+ self.problems.append(f"heredoc '{doc['delim']}' must use a quoted delimiter (<<'{doc['delim']}')")
348
+ self.pending = []
349
+
350
+
351
+ def split_commands(tokens: list[Token], aliases: dict[str, list[Word]], problems: list[str]) -> list[Command]:
352
+ commands, current, heredocs = [], [], []
353
+ skip_next, array_name, array_words = False, None, []
354
+ for token in tokens:
355
+ if array_name is not None:
356
+ if token.kind == "op" and token.text == ")":
357
+ if array_name in aliases:
358
+ problems.append(f"array '{array_name}' is defined twice; define each command array once")
359
+ aliases[array_name] = array_words
360
+ array_name, array_words = None, []
361
+ elif token.kind == "word":
362
+ array_words.append(token.word)
363
+ continue
364
+ if token.kind == "op":
365
+ if token.text == "(" and current and re.fullmatch(NAME + "=", current[-1].raw):
366
+ array_name = current.pop().raw[:-1]
367
+ continue
368
+ commands.append(Command(current, heredocs, dict(aliases)))
369
+ current, heredocs = [], []
370
+ continue
371
+ if token.kind == "redir":
372
+ skip_next = True
373
+ if token.heredoc is not None:
374
+ heredocs.append(token.heredoc)
375
+ continue
376
+ if skip_next:
377
+ skip_next = False
378
+ continue
379
+ current.append(token.word)
380
+ commands.append(Command(current, heredocs, dict(aliases)))
381
+ result = []
382
+ for command in commands:
383
+ words = command.words
384
+ while True:
385
+ while words and re.match(NAME + "=", words[0].raw):
386
+ words = words[1:]
387
+ if words and not words[0].quoted and words[0].raw in KEYWORDS:
388
+ words = words[1:]
389
+ continue
390
+ break
391
+ if words and words[0].raw in {"for", "select", "case"}:
392
+ problems.append(f"'{words[0].raw}' is not allowed in an audit block; write the commands out")
393
+ continue
394
+ if words:
395
+ alias = re.fullmatch(r'"?\$\{(' + NAME + r')\[@\]\}"?', words[0].raw)
396
+ if alias:
397
+ if alias.group(1) not in command.aliases:
398
+ problems.append(f"array '{alias.group(1)}' is used before it is defined")
399
+ continue
400
+ words = command.aliases[alias.group(1)] + words[1:]
401
+ result.append(Command(words, command.heredocs))
402
+ return result
403
+
404
+
405
+ def parse_block(block: str, aliases: dict[str, list[Word]]) -> tuple[list[Command], list[str]]:
406
+ lexer = Lexer(block)
407
+ tokens = lexer.run()
408
+ problems = list(lexer.problems)
409
+ commands = []
410
+ for stream in [tokens] + lexer.nested:
411
+ commands += split_commands(stream, aliases, problems)
412
+ return commands, problems
413
+
414
+
415
+ def commands(block: str) -> list[list[str]]:
416
+ """Token values of every simple command in a shell block (array heads expanded)."""
417
+ parsed, _ = parse_block(block, {})
418
+ return [[word.value for word in command.words] for command in parsed]
419
+
420
+
421
+ def is_cli(tokens: list[str]) -> bool:
422
+ return tokens[0] in CLOUD_CLIS
423
+
424
+
425
+ def pieces(word: str) -> list[str]:
426
+ """Split a subcommand word on hyphens and CamelCase (aliyun/hcloud actions)."""
427
+ found = []
428
+ for part in word.split("-"):
429
+ found += [w.lower() for w in re.findall(r"[A-Z]+(?![a-z])|[A-Z]?[a-z0-9]+", part)]
430
+ return found
431
+
432
+
433
+ def is_path_word(word: Word) -> bool:
434
+ return not word.dynamic and bool(re.fullmatch(r"[A-Za-z][A-Za-z0-9-]*", word.value))
435
+
436
+
437
+ def cli_path(words: list[Word]) -> list[str]:
438
+ """Subcommand path: leading bare words after the CLI, skipping global options."""
439
+ path, i = [], 1
440
+ while i < len(words):
441
+ word = words[i]
442
+ if word.value.startswith("-") and not word.dynamic:
443
+ if path:
444
+ break
445
+ if "=" not in word.value and i + 1 < len(words) and not is_path_word(words[i + 1]):
446
+ i += 1
447
+ i += 1
448
+ continue
449
+ if not is_path_word(word):
450
+ break
451
+ path.append(word.value)
452
+ i += 1
453
+ return path
454
+
455
+
456
+ def shown(words: list[Word]) -> str:
457
+ return " ".join(word.value for word in words)[:120]
458
+
459
+
460
+ def cli_problems(words: list[Word]) -> list[str]:
461
+ text = shown(words)
462
+ path = cli_path(words)
463
+ if not path:
464
+ return [f"no subcommand found in '{text}'"]
465
+ problems = []
466
+ all_pieces = [p for word in path for p in pieces(word)]
467
+ action = pieces(path[-1])
468
+ for part in all_pieces:
469
+ if part in MUTATING_EXACT or part.startswith(MUTATING_PREFIX):
470
+ problems.append(f"mutating word '{part}' in '{text}'")
471
+ if part in SECRET_WORDS:
472
+ problems.append(f"secret-reading word '{part}' in '{text}'")
473
+ if part in DATA_WORDS and not (part in LISTABLE_DATA and action[:1] in (["list"], ["ls"])) \
474
+ and (words[0].value, *path) not in READ_EXCEPTIONS:
475
+ problems.append(f"data-plane word '{part}' in '{text}'; audit control-plane metadata only")
476
+ if path[-1].lower() in DATA_ACTIONS:
477
+ problems.append(f"data-plane action '{path[-1]}' in '{text}'; audit control-plane metadata only")
478
+ for pair in zip(all_pieces, all_pieces[1:]):
479
+ if pair in SECRET_PAIRS:
480
+ problems.append(f"secret-reading words '{' '.join(pair)}' in '{text}'")
481
+ for word in words[1:]:
482
+ if word.value.startswith("-"):
483
+ flag = word.value.split("=", 1)[0]
484
+ if flag in BYPASS_FLAGS:
485
+ problems.append(f"confirmation-bypass flag '{flag}' in '{text}'")
486
+ if any(p in SECRET_WORDS for p in pieces(flag.lstrip("-"))):
487
+ problems.append(f"secret-reading flag '{flag}' in '{text}'")
488
+ if (words[0].value, *path) not in READ_EXCEPTIONS and (not action or action[0] not in READ_VERBS):
489
+ problems.append(f"action '{path[-1]}' is not a read ({', '.join(sorted(READ_VERBS))}) in '{text}'")
490
+ return problems
491
+
492
+
493
+ def curl_problems(words: list[Word]) -> list[str]:
494
+ text, problems, i = shown(words), [], 1
495
+ while i < len(words):
496
+ value = words[i].value
497
+ method = None
498
+ if words[i].dynamic and not words[i].quoted:
499
+ problems.append(f"unquoted expansion '{words[i].raw}' can inject curl options in '{text}'")
500
+ if value.startswith("--"):
501
+ name, eq, arg = value.partition("=")
502
+ if name in CURL_VALUE_FLAGS:
503
+ if not eq:
504
+ i += 1
505
+ arg = words[i].value if i < len(words) else ""
506
+ if name == "--request":
507
+ method = arg
508
+ elif name not in CURL_FLAGS or eq:
509
+ problems.append(f"curl option '{name}' is not allowed in '{text}'")
510
+ elif value.startswith("-") and len(value) > 1 and not words[i].dynamic:
511
+ j = 1
512
+ while j < len(value):
513
+ flag = value[j]
514
+ if flag not in CURL_SHORT:
515
+ problems.append(f"curl option '-{flag}' is not allowed in '{text}'")
516
+ break
517
+ if CURL_SHORT[flag]:
518
+ arg = value[j + 1:]
519
+ if not arg:
520
+ i += 1
521
+ arg = words[i].value if i < len(words) else ""
522
+ if flag == "X":
523
+ method = arg
524
+ break
525
+ j += 1
526
+ if method is not None and method.upper() != "GET":
527
+ problems.append(f"curl uses method '{method}' in '{text}'; GET only")
528
+ i += 1
529
+ return problems
530
+
531
+
532
+ def python_problems(command: Command, mode: str, skill: Path) -> list[str]:
533
+ words, text = command.words, shown(command.words)
534
+ if mode == "offline":
535
+ script = words[1].value if len(words) > 1 else ""
536
+ if re.fullmatch(r"scripts/[\w-]+\.py", script) and (skill / script).is_file():
537
+ return []
538
+ return [f"offline python3 may only run the skill's own scripts/*.py: '{text}'"]
539
+ if len(words) < 2 or words[1].value != "-" or len(command.heredocs) != 1:
540
+ return [f"live python3 must read a quoted heredoc script ('python3 - <<'PY''): '{text}'"]
541
+ try:
542
+ tree = ast.parse(command.heredocs[0]["body"] or "")
543
+ except SyntaxError as error:
544
+ return [f"python3 heredoc does not parse ({error.msg}): '{text}'"]
545
+ problems = []
546
+ direct = {id(node.func) for node in ast.walk(tree) if isinstance(node, ast.Call)}
547
+ attr_bases = {id(node.value) for node in ast.walk(tree) if isinstance(node, ast.Attribute)}
548
+ for node in ast.walk(tree):
549
+ if isinstance(node, ast.ImportFrom):
550
+ problems.append(f"python3 heredoc uses 'from {node.module} import'; use 'import json' or 'import sys'")
551
+ elif isinstance(node, ast.Import):
552
+ problems += [f"python3 heredoc imports '{a.name}'{' as ' + a.asname if a.asname else ''}; "
553
+ f"only {sorted(PY_IMPORTS)}, unaliased" for a in node.names
554
+ if a.name not in PY_IMPORTS or a.asname]
555
+ elif isinstance(node, ast.Name) and node.id == "open" and id(node) not in direct:
556
+ problems.append("python3 heredoc refers to 'open' without calling it; call open(path) directly")
557
+ elif isinstance(node, ast.Name) and node.id in PY_ATTRS and id(node) not in attr_bases:
558
+ problems.append(f"python3 heredoc uses module '{node.id}' as a value; use only its listed attributes")
559
+ elif isinstance(node, ast.Attribute) and isinstance(node.value, ast.Name) and node.value.id in PY_ATTRS \
560
+ and node.attr not in PY_ATTRS[node.value.id]:
561
+ problems.append(f"python3 heredoc uses '{node.value.id}.{node.attr}'; allowed: "
562
+ f"{sorted(PY_ATTRS[node.value.id])}")
563
+ elif isinstance(node, ast.Starred) or (isinstance(node, ast.keyword) and node.arg is None):
564
+ problems.append("python3 heredoc unpacks arguments (*/**); pass them literally so the check sees them")
565
+ elif isinstance(node, ast.Name) and node.id in PY_BANNED_NAMES:
566
+ problems.append(f"python3 heredoc uses '{node.id}'")
567
+ elif isinstance(node, ast.Attribute) and node.attr.startswith("__"):
568
+ problems.append(f"python3 heredoc uses dunder attribute '{node.attr}'")
569
+ elif isinstance(node, ast.Call) and isinstance(node.func, ast.Name) and node.func.id == "open" \
570
+ and (len(node.args) != 1 or node.keywords):
571
+ problems.append("python3 heredoc may only call open(path) read-only")
572
+ return problems
573
+
574
+
575
+ def command_problems(command: Command, mode: str, skill: Path) -> list[str]:
576
+ words = command.words
577
+ head, text = words[0].value, shown(words)
578
+ if words[0].dynamic:
579
+ return [f"command name comes from an expansion in '{text}'; name the program literally"]
580
+ allowed = LIVE_HEADS if mode == "live" else OFFLINE_HEADS
581
+ if head in DATA_SHELLS:
582
+ return [f"data-plane shell '{head}' in '{text}'; audit control-plane metadata only"]
583
+ if head not in allowed:
584
+ if mode == "offline" and (head in CLOUD_CLIS or head in NETWORK_TOOLS):
585
+ return [f"'{head}' in offline audit ('{text}'); offline means no cloud, CLI or network call"]
586
+ return [f"'{head}' is not an allowed {mode} audit command ('{text}'); allowed: {' '.join(sorted(allowed))}"]
587
+ if head in CLOUD_CLIS:
588
+ return cli_problems(words)
589
+ if head == "curl":
590
+ return curl_problems(words)
591
+ if head == "python3":
592
+ return python_problems(command, mode, skill)
593
+ values = [word.value for word in words]
594
+ if head == "printf" and any(v == "-v" or v.startswith("-v") for v in values[1:2]):
595
+ return [f"'printf -v' assigns a variable: '{text}'"]
596
+ if head in {"terraform", "tofu"} and (len(values) < 2 or values[1] != "show"):
597
+ return [f"'{text}' can reach a provider; offline allows only '{head} show' on a saved plan"]
598
+ if head in {"rg", "grep"} and any(CREDENTIAL_PATTERN.search(v) for v in values[1:]) \
599
+ and not any(v in NAMES_ONLY or re.fullmatch(r"-[A-Za-z]*[lcq][A-Za-z]*", v) for v in values[1:]):
600
+ return [f"'{text}' searches for credentials and would print them; list file names only (-l)"]
601
+ if head == "rg" and any(v == "--pre" or v.startswith("--pre=") for v in values):
602
+ return [f"'rg --pre' runs a program: '{text}'"]
603
+ if head == "find" and FIND_BANNED & set(values):
604
+ return [f"find action {sorted(FIND_BANNED & set(values))} runs or deletes: '{text}'"]
605
+ if head == "sort" and any(v.startswith("--compress-program") for v in values):
606
+ return [f"'sort --compress-program' runs a program: '{text}'"]
607
+ if head == "git":
608
+ rest = values[1:]
609
+ while rest and rest[0] in {"-C", "--git-dir", "--work-tree", "--no-pager"}:
610
+ rest = rest[1:] if rest[0] == "--no-pager" else rest[2:]
611
+ sub = next((v for v in rest if not v.startswith("-")), "")
612
+ if any(v in {"-c", "--config-env"} or v.startswith("--config-env=") for v in values[1:]) \
613
+ or sub not in GIT_READ:
614
+ return [f"git must be a read subcommand ({', '.join(sorted(GIT_READ))}) without -c: '{text}'"]
615
+ return []
616
+
617
+
618
+ def fenced_blocks(text: str) -> list[tuple[str, str]]:
619
+ """Every fenced code block as (language, body), at any indent and with ``` or ~~~."""
620
+ blocks, lines, i = [], text.splitlines(), 0
621
+ while i < len(lines):
622
+ match = re.match(r"^(\s*)(`{3,}|~{3,})\s*([^`\s]*)", lines[i])
623
+ if not match:
624
+ i += 1
625
+ continue
626
+ indent, fence, lang = len(match.group(1)), match.group(2), match.group(3).lower()
627
+ body, i = [], i + 1
628
+ while i < len(lines) and not re.fullmatch(r"\s*" + re.escape(fence[0]) + "{" + str(len(fence)) + r",}\s*",
629
+ lines[i]):
630
+ line = lines[i]
631
+ body.append(line[min(indent, len(line) - len(line.lstrip(" "))):])
632
+ i += 1
633
+ blocks.append((lang, "\n".join(body) + "\n"))
634
+ i += 1
635
+ return blocks
636
+
637
+
638
+ def shell_blocks(text: str, where: str, errors: list[str]) -> list[str]:
639
+ found = []
640
+ for lang, body in fenced_blocks(text):
641
+ if lang in SESSION_LANGS:
642
+ errors.append(f"{where}: a ```{lang} block mixes commands and output; use ```bash for commands")
643
+ elif lang not in DATA_LANGS:
644
+ found.append(body)
645
+ return found
646
+
647
+
648
+ def array_problems(blocks: list[str], aliases: dict[str, list[Word]]) -> list[str]:
649
+ """A command array may appear only in its one definition and as a whole "${name[@]}"
650
+ head. Any other mention (name=x, name[0]=, name+=, ${name:=...}, ${name[0]}, a loop
651
+ or printf -v target) could change what runs, so it is rejected outright."""
652
+ text = "\n".join(re.sub(r"(^|\s)#.*$", r"\1", block, flags=re.MULTILINE) for block in blocks)
653
+ problems = []
654
+ for name in aliases:
655
+ mentions = len(re.findall(r"(?<![\w])" + name + r"(?!\w)", text))
656
+ allowed = text.count(name + "=(") + text.count("${" + name + "[@]}")
657
+ if mentions != allowed:
658
+ problems.append(f"array '{name}' is mentioned outside its one definition and \"${{{name}[@]}}\" "
659
+ "uses; command arrays may not be assigned, indexed or modified")
660
+ return problems
661
+
662
+
663
+ def sections(text: str) -> dict[str, str]:
664
+ starts = [m.start() for m in re.finditer(r"^## ", text, re.MULTILINE)] + [len(text)]
665
+ found = {}
666
+ for begin, end in zip(starts, starts[1:]):
667
+ block = text[begin:end]
668
+ found[block.splitlines()[0][3:].strip()] = block
669
+ return found
670
+
671
+
672
+ def check(skill_rel: str, errors: list[str]) -> None:
673
+ skill = REPO / skill_rel
674
+ pattern = skill_rel in PATTERN_SKILLS
675
+ skill_md = (skill / "SKILL.md").read_text(encoding="utf-8")
676
+ router = skill / ROUTER
677
+ if not router.exists():
678
+ errors.append(f"{skill_rel}: missing {ROUTER}")
679
+ return
680
+ if f"]({ROUTER})" not in skill_md:
681
+ errors.append(f"{skill_rel}: SKILL.md does not link {ROUTER}; no agent would load the audit")
682
+ router_text = router.read_text(encoding="utf-8")
683
+ if not re.search(r"\b(only|Do not read both)\b", router_text):
684
+ errors.append(f"{skill_rel}/{ROUTER}: must say to load only the selected variant")
685
+ rows = _ops.ledger_status(skill)
686
+ for mode, rel in VARIANTS.items():
687
+ where = f"{skill_rel}/{rel}"
688
+ path = skill / rel
689
+ if not path.exists():
690
+ errors.append(f"{where}: missing")
691
+ continue
692
+ if f"]({rel.removeprefix('references/commands/')})" not in router_text:
693
+ errors.append(f"{skill_rel}/{ROUTER}: does not link {rel.removeprefix('references/commands/')}")
694
+ if f"]({rel})" in skill_md:
695
+ errors.append(f"{skill_rel}: SKILL.md links {rel} directly; link only the router so variants load lazily")
696
+ text = path.read_text(encoding="utf-8")
697
+ blocks = shell_blocks(text, where, errors)
698
+ aliases: dict[str, list[Word]] = {}
699
+ for block in blocks:
700
+ parsed, problems = parse_block(block, aliases)
701
+ errors += [f"{where}: {p}" for p in problems]
702
+ for command in parsed:
703
+ errors += [f"{where}: {p}" for p in command_problems(command, mode, skill)]
704
+ errors += [f"{where}: {p}" for p in array_problems(blocks, aliases)]
705
+ for evidence in _ops.MARKER_RE.findall(text):
706
+ if evidence not in rows:
707
+ errors.append(f"{where}: {evidence} has no row in the skill's evidence ledger")
708
+ elif mode == "live" and rows[evidence] != "VERIFIED":
709
+ errors.append(f"{where}: cites {evidence}, whose ledger status is {rows[evidence]}; live commands need VERIFIED sources")
710
+ if pattern:
711
+ continue
712
+ if not blocks:
713
+ errors.append(f"{where}: needs at least one bash command block")
714
+ headings = [h for h in re.findall(r"^## (.+?)\s*$", text, re.MULTILINE) if h in SECTIONS]
715
+ if headings != SECTIONS:
716
+ errors.append(f"{where}: sections must be exactly {SECTIONS} in order; found {headings}")
717
+ continue
718
+ if mode == "live":
719
+ for title, block in sections(text).items():
720
+ if title not in SECTIONS:
721
+ continue
722
+ has_command = bool(shell_blocks(block, where, [])) and bool(_ops.MARKER_RE.search(block))
723
+ if not has_command and NO_LIVE not in block:
724
+ errors.append(f"{where} [{title}]: needs a cited command block or a '{NO_LIVE}' line with the reason")
725
+
726
+
727
+ def main() -> int:
728
+ errors: list[str] = []
729
+ for skill_rel in SKILLS:
730
+ check(skill_rel, errors)
731
+ if errors:
732
+ for error in errors:
733
+ print(f"FAIL: {error}")
734
+ print(f"validate-nosql-audit: {len(errors)} problem(s)")
735
+ return 1
736
+ print(f"validate-nosql-audit: OK ({len(SKILLS)} skills, offline and live audit variants)")
737
+ return 0
738
+
739
+
740
+ if __name__ == "__main__":
741
+ sys.exit(main())