@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,136 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: every NoSQL service has a complete, evidence-cited operations reference.
3
+
4
+ Each service in ``SERVICES`` must ship an operations file that:
5
+
6
+ * exists and is linked from its skill's ``SKILL.md`` (otherwise no agent loads it);
7
+ * contains every heading in ``SECTIONS``, once each, in that order;
8
+ * states exactly one ``**Status:**`` per section, from ``STATUSES``;
9
+ * cites at least one evidence row in every section whose status is VERIFIED,
10
+ PARTIAL or UNSUPPORTED, and every cited row exists in the skill's ledger;
11
+ * in a VERIFIED section, cites only rows whose ledger status is VERIFIED;
12
+ * writes no unit prices or currency amounts in the Cost section (billing
13
+ dimensions only; prices go stale by Region and over time).
14
+
15
+ The structure lives in ``templates/nosql-operations-template.md``. Add a service by
16
+ adding its entry here; never weaken a rule to get green.
17
+ """
18
+ from __future__ import annotations
19
+
20
+ import re
21
+ import sys
22
+ from pathlib import Path
23
+
24
+ REPO = Path(__file__).resolve().parents[1]
25
+
26
+ # service -> (skill directory, operations file relative to the skill)
27
+ SERVICES: dict[str, tuple[str, str]] = {
28
+ "Amazon DynamoDB": ("skills/aws/aws-dynamodb-patterns", "references/operations.md"),
29
+ "Amazon DocumentDB": ("skills/aws/aws-documentdb-architect", "references/operations.md"),
30
+ "Amazon Keyspaces": ("skills/aws/aws-keyspaces-architect", "references/operations.md"),
31
+ "Azure Cosmos DB for NoSQL": ("skills/azure/azure-cosmosdb-platform-operator", "references/operations.md"),
32
+ "Azure Cosmos DB for MongoDB": ("skills/azure/azure-cosmosdb-platform-operator", "references/operations-mongodb.md"),
33
+ "Azure Cosmos DB for Apache Cassandra": ("skills/azure/azure-cosmosdb-platform-operator", "references/operations-cassandra.md"),
34
+ "Oracle NoSQL Database Cloud Service": ("skills/oci/oci-nosql-database-architect", "references/operations.md"),
35
+ "Firestore (Native mode)": ("skills/gcp/gcp-firebase-developer", "references/firestore-operations.md"),
36
+ "Firestore with MongoDB compatibility": ("skills/gcp/gcp-firebase-developer", "references/firestore-mongodb-operations.md"),
37
+ "Cloud Bigtable": ("skills/gcp/gcp-bigtable-architect", "references/operations.md"),
38
+ "Alibaba Cloud Tablestore": ("skills/alibaba/alibaba-tablestore-architect", "references/operations.md"),
39
+ "Huawei Cloud GeminiDB": ("skills/huawei/huawei-geminidb-architect", "references/operations.md"),
40
+ "Huawei Cloud DDS": ("skills/huawei/huawei-gaussdb-rds-dba", "references/dds-operations.md"),
41
+ "Scaleway Managed MongoDB": ("skills/scaleway/scaleway-managed-mongodb-architect", "references/operations.md"),
42
+ "OVHcloud Public Cloud Databases for MongoDB": ("skills/ovhcloud/ovhcloud-mongodb-architect", "references/operations.md"),
43
+ "IONOS Cloud DBaaS MongoDB": ("skills/ionos/ionos-live-database-lifecycle-guard", "references/mongodb-operations.md"),
44
+ }
45
+ SECTIONS = [
46
+ "Backup and restore",
47
+ "Disaster recovery and replication",
48
+ "Cost",
49
+ "Monitoring",
50
+ "Performance",
51
+ "IAM",
52
+ "Tagging",
53
+ "Encryption",
54
+ "Network isolation",
55
+ "Audit logging",
56
+ ]
57
+ STATUSES = {"VERIFIED", "PARTIAL", "UNSUPPORTED", "UNVERIFIED", "NOT APPLICABLE"}
58
+ NEEDS_CITATION = {"VERIFIED", "PARTIAL", "UNSUPPORTED"}
59
+ EVIDENCE_ID = r"[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-E\d{2,}"
60
+ MARKER_RE = re.compile(r"\[(" + EVIDENCE_ID + r")\]")
61
+ ROW_RE = re.compile(r"^\|\s*(" + EVIDENCE_ID + r")\s*\|(.*)\|\s*$")
62
+ STATUS_RE = re.compile(r"^\*\*Status:\*\*\s*(.+?)\s*$", re.MULTILINE)
63
+ PRICE_RE = re.compile(r"(?:[$€£¥]\s?\d)|(?:\b\d[\d,.]*\s?(?:USD|EUR|GBP|CNY|RMB|JPY)\b)|(?:\b(?:USD|EUR|GBP|CNY|RMB|JPY)\s?\d)")
64
+
65
+
66
+ def ledger_status(skill: Path) -> dict[str, str]:
67
+ ledger = skill / "references/evidence-ledger.md"
68
+ rows: dict[str, str] = {}
69
+ if ledger.exists():
70
+ for line in ledger.read_text(encoding="utf-8").splitlines():
71
+ match = ROW_RE.match(line.strip())
72
+ if match:
73
+ rows[match.group(1)] = match.group(2).split("|")[-1].strip()
74
+ return rows
75
+
76
+
77
+ def check(service: str, skill_rel: str, ops_rel: str, errors: list[str]) -> None:
78
+ skill = REPO / skill_rel
79
+ ops = skill / ops_rel
80
+ where = f"{service} ({skill_rel}/{ops_rel})"
81
+ if not ops.exists():
82
+ errors.append(f"{where}: operations file missing")
83
+ return
84
+ skill_md = skill / "SKILL.md"
85
+ if not skill_md.exists() or f"]({ops_rel})" not in skill_md.read_text(encoding="utf-8"):
86
+ errors.append(f"{where}: SKILL.md does not link {ops_rel}; no agent would load it")
87
+ text = ops.read_text(encoding="utf-8")
88
+ headings = re.findall(r"^## (.+?)\s*$", text, re.MULTILINE)
89
+ found = [h for h in headings if h in SECTIONS]
90
+ if found != SECTIONS:
91
+ missing = [s for s in SECTIONS if s not in headings]
92
+ errors.append(f"{where}: sections must be exactly {SECTIONS} in order; missing={missing}, found={found}")
93
+ return
94
+ rows = ledger_status(skill)
95
+ starts = [m.start() for m in re.finditer(r"^## ", text, re.MULTILINE)] + [len(text)]
96
+ for begin, end in zip(starts, starts[1:]):
97
+ block = text[begin:end]
98
+ title = block.splitlines()[0][3:].strip()
99
+ if title not in SECTIONS:
100
+ continue
101
+ statuses = STATUS_RE.findall(block)
102
+ if len(statuses) != 1:
103
+ errors.append(f"{where} [{title}]: expected one **Status:** line, found {len(statuses)}")
104
+ continue
105
+ status = statuses[0]
106
+ if status not in STATUSES:
107
+ errors.append(f"{where} [{title}]: status '{status}' not in {sorted(STATUSES)}")
108
+ continue
109
+ cited = MARKER_RE.findall(block)
110
+ if status in NEEDS_CITATION and not cited:
111
+ errors.append(f"{where} [{title}]: status {status} needs at least one evidence citation")
112
+ for evidence in cited:
113
+ if evidence not in rows:
114
+ errors.append(f"{where} [{title}]: {evidence} has no row in the skill's evidence ledger")
115
+ elif status == "VERIFIED" and rows[evidence] != "VERIFIED":
116
+ errors.append(f"{where} [{title}]: VERIFIED section cites {evidence}, whose ledger status is {rows[evidence]}")
117
+ if title == "Cost":
118
+ for price in PRICE_RE.findall(block):
119
+ errors.append(f"{where} [Cost]: unit price or currency amount '{price}'; record billing dimensions only")
120
+
121
+
122
+ def main() -> int:
123
+ errors: list[str] = []
124
+ for service, (skill_rel, ops_rel) in SERVICES.items():
125
+ check(service, skill_rel, ops_rel, errors)
126
+ if errors:
127
+ for error in errors:
128
+ print(f"FAIL: {error}")
129
+ print(f"validate-nosql-operations: {len(errors)} problem(s)")
130
+ return 1
131
+ print(f"validate-nosql-operations: OK ({len(SERVICES)} services x {len(SECTIONS)} sections)")
132
+ return 0
133
+
134
+
135
+ if __name__ == "__main__":
136
+ sys.exit(main())
@@ -0,0 +1,96 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: run the offline evals shipped with the NoSQL pattern skills.
3
+
4
+ The pattern skills ship
5
+ executable helpers (route selectors, review reminders, recovery checks) and example
6
+ assets (shell, Python, Node). Their own evals check them with fake cloud binaries
7
+ and never contact a cloud. Shipping code without running its tests would let a
8
+ broken selector or asset reach every harness, so this gate runs them all.
9
+
10
+ Fails closed when a prerequisite is missing: two eval files lint CloudFormation
11
+ with ``cfn-lint`` (pinned in ``tests/requirements-ci.txt``), and the Node eval needs ``node``.
12
+ Install with ``python3 -m pip install -r tests/requirements-ci.txt``.
13
+
14
+ Also fails if ``.plugin-scanner.toml`` excludes any file this gate executes or
15
+ imports (evals, scripts, assets): code CI runs must stay visible to the HOL
16
+ secret and injection scanner. Matching uses ``fnmatch`` on the repo-relative
17
+ path, the same rule the scanner applies to ``ignore_paths``.
18
+ """
19
+ from __future__ import annotations
20
+
21
+ import os
22
+ import tomllib
23
+ import shutil
24
+ import subprocess
25
+ import sys
26
+ from fnmatch import fnmatch
27
+ from pathlib import Path
28
+
29
+ REPO = Path(__file__).resolve().parents[1]
30
+ SKILLS = [
31
+ REPO / "skills/aws/aws-dynamodb-patterns",
32
+ REPO / "skills/oci/oci-nosql-pattern",
33
+ REPO / "skills/azure/azure-cosmosdb-pattern",
34
+ ]
35
+ TIMEOUT = 300
36
+ SCANNER_CONFIG = REPO / ".plugin-scanner.toml"
37
+ NON_EXECUTABLE = {".md", ".json"}
38
+
39
+
40
+ def scanner_blind_spots() -> list[str]:
41
+ """Executable files of the pattern skills that the scanner config would skip."""
42
+ if not SCANNER_CONFIG.exists():
43
+ return []
44
+ with SCANNER_CONFIG.open("rb") as handle:
45
+ patterns = tomllib.load(handle).get("scanner", {}).get("ignore_paths", [])
46
+ hidden = []
47
+ for skill in SKILLS:
48
+ for path in sorted(skill.rglob("*")):
49
+ if not path.is_file() or path.suffix in NON_EXECUTABLE or "__pycache__" in path.parts:
50
+ continue
51
+ relative = path.relative_to(REPO).as_posix()
52
+ hidden += [f"{relative} (ignore_paths: {pattern})" for pattern in patterns if fnmatch(relative, pattern)]
53
+ return hidden
54
+
55
+
56
+ def main() -> int:
57
+ missing = [tool for tool in ("cfn-lint", "node", "bash") if shutil.which(tool) is None]
58
+ if missing:
59
+ print(f"FAIL: missing prerequisite(s): {', '.join(missing)}. "
60
+ "Install cfn-lint with: python3 -m pip install -r tests/requirements-ci.txt")
61
+ return 1
62
+ hidden = scanner_blind_spots()
63
+ if hidden:
64
+ print("FAIL: .plugin-scanner.toml hides code this gate executes from the scanner:")
65
+ print("\n".join(f" {entry}" for entry in hidden))
66
+ return 1
67
+ commands = []
68
+ for skill in SKILLS:
69
+ found = [(skill, [sys.executable, str(path)]) for path in sorted((skill / "evals").glob("*.py"))]
70
+ found += [(skill, ["node", "--test", str(path)]) for path in sorted((skill / "evals").glob("*.mjs"))]
71
+ if not found:
72
+ print(f"FAIL: no evals found under {skill / 'evals'}")
73
+ return 1
74
+ commands += found
75
+ failures = 0
76
+ for skill, command in commands:
77
+ name = f"{skill.name}/{Path(command[-1]).name}"
78
+ try:
79
+ result = subprocess.run(command, cwd=skill, capture_output=True, text=True, timeout=TIMEOUT,
80
+ env={**os.environ, "PYTHONDONTWRITEBYTECODE": "1"})
81
+ except subprocess.TimeoutExpired:
82
+ print(f"FAIL {name}: timed out after {TIMEOUT}s")
83
+ failures += 1
84
+ continue
85
+ if result.returncode == 0:
86
+ print(f"OK {name}")
87
+ else:
88
+ failures += 1
89
+ print(f"FAIL {name} (exit {result.returncode})")
90
+ print((result.stdout + result.stderr)[-4000:])
91
+ print(f"{len(commands) - failures}/{len(commands)} NoSQL pattern eval files passed")
92
+ return 1 if failures else 0
93
+
94
+
95
+ if __name__ == "__main__":
96
+ sys.exit(main())
@@ -0,0 +1,94 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: every NoSQL behavioral scenario is answerable from the file the skill loads.
3
+
4
+ Reads tests/fixtures/nosql-scenarios/scenarios.json. For each scenario it checks,
5
+ deterministically (no model, no network, no clock):
6
+
7
+ * the target skill exists and its SKILL.md links the scenario's reference file
8
+ (``SKILL.md`` itself is allowed for entry-point rules), so progressive
9
+ disclosure actually reaches the guidance;
10
+ * every required evidence ID is a row in that skill's evidence ledger AND is
11
+ cited in the reference file, so the answer is traceable;
12
+ * every ``must_mention`` phrase occurs in the reference file (case-insensitive),
13
+ so the decisive fact or refusal rule has not been edited away.
14
+
15
+ This does not prove a model answers correctly. ``pass_criteria`` is the rubric
16
+ for live model runs, which stay outside CI because they are not reproducible.
17
+
18
+ Usage: python3 tests/validate-nosql-scenarios.py
19
+ """
20
+ from __future__ import annotations
21
+
22
+ import json
23
+ import re
24
+ import sys
25
+ from pathlib import Path
26
+
27
+ REPO = Path(__file__).resolve().parent.parent
28
+ SCENARIOS = REPO / "tests/fixtures/nosql-scenarios/scenarios.json"
29
+ REQUIRED_KEYS = {"id", "skill", "reference", "prompt", "required_evidence", "must_mention", "pass_criteria"}
30
+
31
+
32
+ def ledger_ids(skill_dir: Path) -> set[str]:
33
+ ledger = skill_dir / "references/evidence-ledger.md"
34
+ if not ledger.exists():
35
+ return set()
36
+ return set(re.findall(r"^\|\s*([A-Z][A-Z0-9-]*-E\d{2,})\s*\|", ledger.read_text(encoding="utf-8"), re.M))
37
+
38
+
39
+ def check(scenario: dict, errors: list[str], seen: set[str]) -> None:
40
+ sid = scenario.get("id", "<missing id>")
41
+ missing = REQUIRED_KEYS - scenario.keys()
42
+ if missing:
43
+ errors.append(f"{sid}: missing keys {sorted(missing)}")
44
+ return
45
+ if sid in seen:
46
+ errors.append(f"{sid}: duplicate scenario id")
47
+ seen.add(sid)
48
+ if len(scenario["pass_criteria"]) < 20 or len(scenario["prompt"]) < 20:
49
+ errors.append(f"{sid}: prompt and pass_criteria must be concrete (>= 20 chars)")
50
+
51
+ skill_dir = REPO / scenario["skill"]
52
+ skill_md = skill_dir / "SKILL.md"
53
+ if not skill_md.exists():
54
+ errors.append(f"{sid}: skill {scenario['skill']} has no SKILL.md")
55
+ return
56
+ reference = skill_dir / scenario["reference"]
57
+ if not reference.exists():
58
+ errors.append(f"{sid}: reference {scenario['reference']} does not exist")
59
+ return
60
+ if scenario["reference"] != "SKILL.md" and f"]({scenario['reference']})" not in skill_md.read_text(encoding="utf-8"):
61
+ errors.append(f"{sid}: SKILL.md does not link {scenario['reference']}; the skill would never load it")
62
+
63
+ text = reference.read_text(encoding="utf-8")
64
+ ids = ledger_ids(skill_dir)
65
+ for evidence in scenario["required_evidence"]:
66
+ if evidence not in ids:
67
+ errors.append(f"{sid}: {evidence} is not a row in the skill's evidence ledger")
68
+ elif f"[{evidence}]" not in text:
69
+ errors.append(f"{sid}: {evidence} is not cited in {scenario['reference']}")
70
+ for phrase in scenario["must_mention"]:
71
+ if phrase.lower() not in text.lower():
72
+ errors.append(f"{sid}: '{phrase}' not found in {scenario['reference']}")
73
+
74
+
75
+ def main() -> int:
76
+ data = json.loads(SCENARIOS.read_text(encoding="utf-8"))
77
+ scenarios = data.get("scenarios", [])
78
+ errors: list[str] = []
79
+ seen: set[str] = set()
80
+ if not scenarios:
81
+ errors.append("no scenarios defined")
82
+ for scenario in scenarios:
83
+ check(scenario, errors, seen)
84
+ if errors:
85
+ print("validate-nosql-scenarios: FAIL", file=sys.stderr)
86
+ for error in errors:
87
+ print(f" - {error}", file=sys.stderr)
88
+ return 1
89
+ print(f"validate-nosql-scenarios: OK ({len(scenarios)} scenarios grounded in their loaded references)")
90
+ return 0
91
+
92
+
93
+ if __name__ == "__main__":
94
+ sys.exit(main())
@@ -29,7 +29,12 @@ def load_json(path: Path):
29
29
 
30
30
  def skill_files(skill_path: Path) -> list[dict]:
31
31
  files: list[dict] = []
32
- for path in sorted(p for p in skill_path.rglob("*") if p.is_file()):
32
+ # Skip interpreter bytecode caches: they are git-ignored, so hashing them makes the
33
+ # manifest depend on whether a skill's scripts happened to run locally (CI never has them).
34
+ for path in sorted(
35
+ p for p in skill_path.rglob("*")
36
+ if p.is_file() and "__pycache__" not in p.parts and p.suffix != ".pyc"
37
+ ):
33
38
  rel = path.relative_to(ROOT).as_posix()
34
39
  data = path.read_bytes()
35
40
  files.append({
@@ -0,0 +1,225 @@
1
+ #!/usr/bin/env python3
2
+ """Gate: skill/agent reference links resolve, and evidence ledgers are traceable.
3
+
4
+ Two checks, both deterministic (no network, no wall clock):
5
+
6
+ 1. Every relative Markdown link in a ``SKILL.md``, ``AGENT.md`` or skill
7
+ ``references/*.md`` file resolves to a file on disk. Progressive disclosure
8
+ depends on these links: a broken one silently drops guidance the entry point
9
+ promised to load.
10
+
11
+ 2. Every plain-text ``references/<file>.md`` mention in a ``SKILL.md`` (for
12
+ example a routing table cell) names a file that exists. Skills often route
13
+ by path in prose rather than by Markdown link, and a promised reference
14
+ that does not exist is the same silent gap as a broken link. Pre-existing
15
+ gaps are listed in ``KNOWN_MISSING_REFERENCES`` so that no new one can be
16
+ added; fixing one forces its removal from the list.
17
+
18
+ 3. Any skill or agent directory that ships ``references/evidence-ledger.md``
19
+ opts into claim-to-source traceability:
20
+
21
+ * every ledger row has a unique evidence ID, an ``https`` URL on an
22
+ allow-listed provider documentation host, a ``YYYY-MM-DD`` retrieval date
23
+ and a status of ``VERIFIED``, ``UNVERIFIED`` or ``CONFLICT``;
24
+ * every ``[EVIDENCE-ID]`` marker cited in that directory's Markdown exists in
25
+ its ledger (no citation to nothing);
26
+ * every ledger row is cited at least once outside the ledger (no orphan
27
+ evidence that nothing depends on).
28
+
29
+ The allow-list is deliberately narrow: a ledger proves provider behaviour, so
30
+ its sources must be the provider's own documentation or SDK repositories.
31
+ Extend ``OFFICIAL_SOURCES`` only with a provider-owned host or org.
32
+
33
+ Usage: python3 tests/validate-skill-references.py
34
+ """
35
+ from __future__ import annotations
36
+
37
+ import re
38
+ import sys
39
+ from pathlib import Path
40
+ from urllib.parse import urlparse
41
+
42
+ REPO = Path(__file__).resolve().parent.parent
43
+
44
+ # host -> allowed path prefixes ("" = any path on that host)
45
+ OFFICIAL_SOURCES: dict[str, tuple[str, ...]] = {
46
+ "docs.oracle.com": ("",),
47
+ "docs.aws.amazon.com": ("",),
48
+ # Provider-owned pricing pages are the authority for billing dimensions in the
49
+ # NoSQL operations references (Cost sections record dimensions, never prices).
50
+ "aws.amazon.com": ("/documentdb/pricing/", "/keyspaces/pricing/", "/dynamodb/pricing/"),
51
+ "learn.microsoft.com": ("",),
52
+ "firebase.google.com": ("/docs/",),
53
+ "cloud.google.com": ("/",),
54
+ "docs.cloud.google.com": ("/",),
55
+ "www.alibabacloud.com": ("/help/",),
56
+ "support.huaweicloud.com": ("/",),
57
+ # Managed MongoDB documentation for the smaller clouds' NoSQL operations references.
58
+ "www.scaleway.com": ("/en/docs/",),
59
+ "help.ovhcloud.com": ("/csm/",),
60
+ "docs.ovhcloud.com": ("/",),
61
+ "docs.ionos.com": ("/cloud/",),
62
+ # Provider-owned CLI references for the NoSQL audit commands: Alibaba's OpenAPI
63
+ # portal CLI pages, and the Scaleway and OVHcloud CLI repositories' command docs.
64
+ "api.alibabacloud.com": ("/api-tools/cli/",),
65
+ "github.com": ("/oracle/", "/aws/", "/awslabs/", "/Azure/", "/googleapis/", "/aliyun/", "/scaleway/", "/ovh/"),
66
+ # GitHub Pages of the github.com/oracle organisation (Oracle NoSQL Node.js SDK reference).
67
+ "oracle.github.io": ("/nosql-node-sdk/",),
68
+ }
69
+
70
+ # Pre-existing, unrelated debt: these SKILL.md files route to reference files
71
+ # that were never written. Listed so the gate blocks *new* gaps today; remove an
72
+ # entry when its file is written (the gate fails on stale entries). Do not add
73
+ # to this list to get green - write the reference or drop the promise instead.
74
+ KNOWN_MISSING_REFERENCES: dict[str, set[str]] = {
75
+ "skills/gcp/gcp-alloydb-ai-developer": {
76
+ "references/ai-functions.md", "references/alloydb-omni.md", "references/hybrid-search.md",
77
+ "references/iam-security.md", "references/model-endpoints.md", "references/vector-search.md",
78
+ },
79
+ "skills/gcp/gcp-firebase-developer": {
80
+ "references/app-check.md", "references/auth.md", "references/emulators.md",
81
+ "references/extensions.md", "references/functions.md", "references/hosting.md",
82
+ "references/security-rules.md",
83
+ },
84
+ "skills/gcp/gcp-gemini-api-developer": {
85
+ "references/batch.md", "references/caching.md", "references/embeddings.md",
86
+ "references/live-api.md", "references/migration.md", "references/safety.md",
87
+ "references/structured-output.md", "references/text-multimodal.md", "references/tools.md",
88
+ "references/tuning.md",
89
+ },
90
+ "skills/gcp/gcp-networking-observability": {
91
+ "references/cloud-nat-analysis.md", "references/connectivity-tests.md",
92
+ "references/firewall-analysis.md", "references/metrics-analysis.md",
93
+ "references/threat-analysis.md", "references/vpc-flow-analysis.md",
94
+ },
95
+ }
96
+
97
+ LINK_RE = re.compile(r"\]\(([^)\s]+)\)")
98
+ PLAIN_REF_RE = re.compile(r"(?<![\w/.-])(references/[A-Za-z0-9._/-]+\.md)")
99
+ EVIDENCE_ID = r"[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-E\d{2,}"
100
+ MARKER_RE = re.compile(r"\[(" + EVIDENCE_ID + r")\]")
101
+ ROW_RE = re.compile(r"^\|\s*(" + EVIDENCE_ID + r")\s*\|(.*)\|\s*$")
102
+ DATE_RE = re.compile(r"^\d{4}-\d{2}-\d{2}$")
103
+ STATUSES = {"VERIFIED", "UNVERIFIED", "CONFLICT"}
104
+ LEDGER_COLUMNS = 5 # claim | source URL | section | retrieved | status
105
+
106
+
107
+ def markdown_files() -> list[Path]:
108
+ files: list[Path] = []
109
+ for root in ("skills", "agents"):
110
+ base = REPO / root
111
+ files += base.rglob("SKILL.md")
112
+ files += base.rglob("AGENT.md")
113
+ files += base.rglob("references/**/*.md") # includes references/commands/** guides
114
+ return sorted(set(files))
115
+
116
+
117
+ def strip_code(text: str) -> str:
118
+ """Drop fenced and inline code so example syntax is never read as a link."""
119
+ text = re.sub(r"```.*?```", "", text, flags=re.S)
120
+ return re.sub(r"`[^`\n]*`", "", text)
121
+
122
+
123
+ def check_links(errors: list[str]) -> int:
124
+ checked = 0
125
+ for path in markdown_files():
126
+ for match in LINK_RE.finditer(strip_code(path.read_text(encoding="utf-8"))):
127
+ target = match.group(1).split("#", 1)[0]
128
+ if not target or re.match(r"^[a-z][a-z0-9+.-]*:", target):
129
+ continue # pure anchor, or an absolute URL / mailto
130
+ checked += 1
131
+ if not (path.parent / target).exists():
132
+ errors.append(f"{path.relative_to(REPO)}: broken relative link '{target}'")
133
+ return checked
134
+
135
+
136
+ def check_plain_references(errors: list[str]) -> int:
137
+ checked = 0
138
+ seen_dirs: set[str] = set()
139
+ for skill_md in sorted((REPO / "skills").rglob("SKILL.md")):
140
+ rel_dir = skill_md.parent.relative_to(REPO).as_posix()
141
+ seen_dirs.add(rel_dir)
142
+ known = KNOWN_MISSING_REFERENCES.get(rel_dir, set())
143
+ for ref in sorted(set(PLAIN_REF_RE.findall(skill_md.read_text(encoding="utf-8")))):
144
+ checked += 1
145
+ exists = (skill_md.parent / ref).exists()
146
+ if not exists and ref not in known:
147
+ errors.append(f"{rel_dir}/SKILL.md: names '{ref}', which does not exist")
148
+ elif exists and ref in known:
149
+ errors.append(f"{rel_dir}: '{ref}' now exists; remove it from KNOWN_MISSING_REFERENCES")
150
+ for rel_dir in sorted(set(KNOWN_MISSING_REFERENCES) - seen_dirs):
151
+ errors.append(f"KNOWN_MISSING_REFERENCES lists '{rel_dir}', which has no SKILL.md")
152
+ return checked
153
+
154
+
155
+ def official(url: str) -> bool:
156
+ parsed = urlparse(url)
157
+ if parsed.scheme != "https" or parsed.hostname not in OFFICIAL_SOURCES:
158
+ return False
159
+ return any(parsed.path.startswith(prefix) for prefix in OFFICIAL_SOURCES[parsed.hostname])
160
+
161
+
162
+ def check_ledger(ledger: Path, errors: list[str]) -> int:
163
+ rel = ledger.relative_to(REPO)
164
+ ids: dict[str, int] = {}
165
+ for lineno, line in enumerate(ledger.read_text(encoding="utf-8").splitlines(), 1):
166
+ row = ROW_RE.match(line.strip())
167
+ if not row:
168
+ continue
169
+ evidence_id = row.group(1)
170
+ cells = [c.strip() for c in row.group(2).split("|")]
171
+ where = f"{rel}:{lineno} {evidence_id}"
172
+ if evidence_id in ids:
173
+ errors.append(f"{where}: duplicate evidence ID (first at line {ids[evidence_id]})")
174
+ ids[evidence_id] = lineno
175
+ if len(cells) != LEDGER_COLUMNS:
176
+ errors.append(f"{where}: expected {LEDGER_COLUMNS} columns after the ID, found {len(cells)}")
177
+ continue
178
+ claim, source, _section, retrieved, status = cells
179
+ url = re.sub(r"^<|>$", "", source)
180
+ if len(claim) < 10:
181
+ errors.append(f"{where}: claim text is missing or too short")
182
+ if not official(url):
183
+ errors.append(f"{where}: source '{url}' is not an https URL on an allow-listed provider host")
184
+ if not DATE_RE.match(retrieved):
185
+ errors.append(f"{where}: retrieved date '{retrieved}' is not YYYY-MM-DD")
186
+ if status not in STATUSES:
187
+ errors.append(f"{where}: status '{status}' not in {sorted(STATUSES)}")
188
+ if not ids:
189
+ errors.append(f"{rel}: ledger has no evidence rows")
190
+ return 0
191
+
192
+ cited: set[str] = set()
193
+ for md in ledger.parent.parent.rglob("*.md"):
194
+ if md == ledger:
195
+ continue
196
+ for marker in MARKER_RE.findall(md.read_text(encoding="utf-8")):
197
+ cited.add(marker)
198
+ if marker not in ids:
199
+ errors.append(f"{md.relative_to(REPO)}: cites [{marker}] which is not in {rel}")
200
+ for orphan in sorted(set(ids) - cited):
201
+ errors.append(f"{rel}: {orphan} is never cited outside the ledger")
202
+ return len(ids)
203
+
204
+
205
+ def main() -> int:
206
+ errors: list[str] = []
207
+ links = check_links(errors)
208
+ plain = check_plain_references(errors)
209
+ ledgers = sorted((REPO / "skills").rglob("references/evidence-ledger.md"))
210
+ ledgers += sorted((REPO / "agents").rglob("references/evidence-ledger.md"))
211
+ rows = sum(check_ledger(ledger, errors) for ledger in ledgers)
212
+ if errors:
213
+ print("validate-skill-references: FAIL", file=sys.stderr)
214
+ for error in errors:
215
+ print(f" - {error}", file=sys.stderr)
216
+ return 1
217
+ print(
218
+ f"validate-skill-references: OK ({links} relative links and {plain} plain-text reference paths resolved; "
219
+ f"{len(ledgers)} evidence ledgers, {rows} rows traced)"
220
+ )
221
+ return 0
222
+
223
+
224
+ if __name__ == "__main__":
225
+ sys.exit(main())