@raishin/vanguard-frontier-agentic 3.19.0 → 3.21.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 (805) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +13 -1
  3. package/.cursor-plugin/plugin.json +13 -1
  4. package/.github/plugin/marketplace.json +1 -1
  5. package/README.md +25 -23
  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/atlassian/atlassian-control-evidence-lineage-agent/AGENT.md +50 -0
  18. package/agents/atlassian/atlassian-control-evidence-lineage-agent/LEAST-PRIVILEGES.md +23 -0
  19. package/agents/atlassian/atlassian-control-evidence-lineage-agent/README.md +36 -0
  20. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/claude-code.agent.md +44 -0
  21. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/codex.toml +51 -0
  22. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/copilot.agent.md +71 -0
  23. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/cursor.agent.md +43 -0
  24. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/gemini.agent.md +44 -0
  25. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-cli.agent.json +5 -0
  26. package/agents/atlassian/atlassian-control-evidence-lineage-agent/harnesses/kiro-ide.agent.md +43 -0
  27. package/agents/atlassian/atlassian-control-evidence-lineage-agent/metadata.json +43 -0
  28. package/agents/atlassian/atlassian-incident-prevention-agent/AGENT.md +49 -0
  29. package/agents/atlassian/atlassian-incident-prevention-agent/LEAST-PRIVILEGES.md +23 -0
  30. package/agents/atlassian/atlassian-incident-prevention-agent/README.md +36 -0
  31. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/claude-code.agent.md +43 -0
  32. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/codex.toml +51 -0
  33. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/copilot.agent.md +70 -0
  34. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/cursor.agent.md +42 -0
  35. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/gemini.agent.md +43 -0
  36. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-cli.agent.json +5 -0
  37. package/agents/atlassian/atlassian-incident-prevention-agent/harnesses/kiro-ide.agent.md +42 -0
  38. package/agents/atlassian/atlassian-incident-prevention-agent/metadata.json +43 -0
  39. package/agents/atlassian/atlassian-knowledge-integrity-agent/AGENT.md +48 -0
  40. package/agents/atlassian/atlassian-knowledge-integrity-agent/LEAST-PRIVILEGES.md +23 -0
  41. package/agents/atlassian/atlassian-knowledge-integrity-agent/README.md +36 -0
  42. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/claude-code.agent.md +42 -0
  43. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/codex.toml +47 -0
  44. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/copilot.agent.md +69 -0
  45. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/cursor.agent.md +41 -0
  46. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/gemini.agent.md +42 -0
  47. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-cli.agent.json +5 -0
  48. package/agents/atlassian/atlassian-knowledge-integrity-agent/harnesses/kiro-ide.agent.md +41 -0
  49. package/agents/atlassian/atlassian-knowledge-integrity-agent/metadata.json +42 -0
  50. package/agents/atlassian/atlassian-live-write-guard-agent/AGENT.md +51 -0
  51. package/agents/atlassian/atlassian-live-write-guard-agent/LEAST-PRIVILEGES.md +23 -0
  52. package/agents/atlassian/atlassian-live-write-guard-agent/README.md +36 -0
  53. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/claude-code.agent.md +45 -0
  54. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/codex.toml +52 -0
  55. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/copilot.agent.md +72 -0
  56. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/cursor.agent.md +44 -0
  57. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/gemini.agent.md +45 -0
  58. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-cli.agent.json +5 -0
  59. package/agents/atlassian/atlassian-live-write-guard-agent/harnesses/kiro-ide.agent.md +44 -0
  60. package/agents/atlassian/atlassian-live-write-guard-agent/metadata.json +43 -0
  61. package/agents/atlassian/atlassian-maestro-agent/AGENT.md +49 -0
  62. package/agents/atlassian/atlassian-maestro-agent/LEAST-PRIVILEGES.md +20 -0
  63. package/agents/atlassian/atlassian-maestro-agent/README.md +36 -0
  64. package/agents/atlassian/atlassian-maestro-agent/harnesses/claude-code.agent.md +43 -0
  65. package/agents/atlassian/atlassian-maestro-agent/harnesses/codex.toml +44 -0
  66. package/agents/atlassian/atlassian-maestro-agent/harnesses/copilot.agent.md +46 -0
  67. package/agents/atlassian/atlassian-maestro-agent/harnesses/cursor.agent.md +42 -0
  68. package/agents/atlassian/atlassian-maestro-agent/harnesses/gemini.agent.md +43 -0
  69. package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-cli.agent.json +5 -0
  70. package/agents/atlassian/atlassian-maestro-agent/harnesses/kiro-ide.agent.md +42 -0
  71. package/agents/atlassian/atlassian-maestro-agent/metadata.json +41 -0
  72. package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
  73. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
  74. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
  75. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
  76. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
  77. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
  78. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
  79. package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
  80. package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
  81. package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
  82. package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
  83. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
  84. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
  85. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
  86. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
  87. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
  88. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  89. package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  90. package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
  91. package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
  92. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
  93. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
  94. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
  95. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
  96. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
  97. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  98. package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  99. package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
  100. package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
  101. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
  102. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
  103. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
  104. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
  105. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
  106. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  107. package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  108. package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
  109. package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
  110. package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
  111. package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
  112. package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
  113. package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
  114. package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
  115. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
  116. package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
  117. package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
  118. package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
  119. package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
  120. package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
  121. package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
  122. package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
  123. package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
  124. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
  125. package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
  126. package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
  127. package/catalog/agents.json +366 -1
  128. package/catalog/asset-integrity.json +1686 -81
  129. package/catalog/install-roles.json +41 -1
  130. package/catalog/model-assignments.json +396 -0
  131. package/catalog/skill-manifest.json +2429 -194
  132. package/catalog/skills.json +544 -14
  133. package/mods/live-guard-gate/lib/live-agents.mjs +1 -0
  134. package/package.json +8 -2
  135. package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
  136. package/powers/README.md +3 -2
  137. package/powers/vanguard-alibaba/POWER.md +1 -1
  138. package/powers/vanguard-atlassian/POWER.md +42 -0
  139. package/powers/vanguard-aws/POWER.md +1 -1
  140. package/powers/vanguard-azure/POWER.md +1 -1
  141. package/powers/vanguard-gcp/POWER.md +1 -1
  142. package/powers/vanguard-huawei/POWER.md +1 -1
  143. package/powers/vanguard-oci/POWER.md +1 -1
  144. package/schemas/agent.schema.json +1 -0
  145. package/schemas/skill.schema.json +1 -0
  146. package/scripts/export-marketplace-agents.mjs +4 -1
  147. package/scripts/generate-docs-data.mjs +1 -0
  148. package/scripts/generate-kiro-powers.mjs +15 -0
  149. package/skills/alibaba/README.md +2 -1
  150. package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
  151. package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
  152. package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
  153. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
  154. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
  155. package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
  156. package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
  157. package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
  158. package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
  159. package/skills/atlassian/atlassian-control-evidence-lineage/SKILL.md +52 -0
  160. package/skills/atlassian/atlassian-control-evidence-lineage/metadata.json +18 -0
  161. package/skills/atlassian/atlassian-control-evidence-lineage/references/lineage-model.md +59 -0
  162. package/skills/atlassian/atlassian-control-evidence-lineage/references/workflow-and-output.md +69 -0
  163. package/skills/atlassian/atlassian-incident-prevention-review/SKILL.md +61 -0
  164. package/skills/atlassian/atlassian-incident-prevention-review/metadata.json +19 -0
  165. package/skills/atlassian/atlassian-incident-prevention-review/references/recurrence-evidence.md +92 -0
  166. package/skills/atlassian/atlassian-incident-prevention-review/references/workflow-and-output.md +118 -0
  167. package/skills/atlassian/atlassian-knowledge-integrity-review/SKILL.md +64 -0
  168. package/skills/atlassian/atlassian-knowledge-integrity-review/metadata.json +19 -0
  169. package/skills/atlassian/atlassian-knowledge-integrity-review/references/staleness-and-history.md +89 -0
  170. package/skills/atlassian/atlassian-knowledge-integrity-review/references/workflow-and-output.md +99 -0
  171. package/skills/atlassian/atlassian-live-write-guard/SKILL.md +51 -0
  172. package/skills/atlassian/atlassian-live-write-guard/metadata.json +18 -0
  173. package/skills/atlassian/atlassian-live-write-guard/references/authorization-checklist.md +39 -0
  174. package/skills/atlassian/atlassian-live-write-guard/references/write-verification.md +47 -0
  175. package/skills/atlassian/atlassian-rovo-mcp-integration/SKILL.md +72 -0
  176. package/skills/atlassian/atlassian-rovo-mcp-integration/metadata.json +26 -0
  177. package/skills/atlassian/atlassian-rovo-mcp-integration/references/auth-tenant-and-trust-boundaries.md +59 -0
  178. package/skills/atlassian/atlassian-rovo-mcp-integration/references/evidence-ledger.md +36 -0
  179. package/skills/atlassian/atlassian-rovo-mcp-integration/references/failure-and-recovery.md +36 -0
  180. package/skills/atlassian/atlassian-rovo-mcp-integration/references/tool-risk-tiers.md +91 -0
  181. package/skills/atlassian/confluence-document-authoring/CHANGELOG.md +28 -0
  182. package/skills/atlassian/confluence-document-authoring/SKILL.md +70 -0
  183. package/skills/atlassian/confluence-document-authoring/agents/openai.yaml +15 -0
  184. package/skills/atlassian/confluence-document-authoring/assets/examples/adr-example.md +81 -0
  185. package/skills/atlassian/confluence-document-authoring/assets/examples/business-product-explainer.md +99 -0
  186. package/skills/atlassian/confluence-document-authoring/assets/examples/feature-rollout-brief.md +108 -0
  187. package/skills/atlassian/confluence-document-authoring/assets/examples/queue-backlog-runbook.md +158 -0
  188. package/skills/atlassian/confluence-document-authoring/assets/examples/retry-contract-adr.md +99 -0
  189. package/skills/atlassian/confluence-document-authoring/assets/icon.svg +8 -0
  190. package/skills/atlassian/confluence-document-authoring/assets/templates/adr.md +87 -0
  191. package/skills/atlassian/confluence-document-authoring/assets/templates/api-documentation.md +97 -0
  192. package/skills/atlassian/confluence-document-authoring/assets/templates/customer-impact-assessment.md +43 -0
  193. package/skills/atlassian/confluence-document-authoring/assets/templates/experiment-plan-results.md +44 -0
  194. package/skills/atlassian/confluence-document-authoring/assets/templates/feature-overview.md +79 -0
  195. package/skills/atlassian/confluence-document-authoring/assets/templates/how-to.md +58 -0
  196. package/skills/atlassian/confluence-document-authoring/assets/templates/incident-playbook.md +89 -0
  197. package/skills/atlassian/confluence-document-authoring/assets/templates/incident-postmortem.md +83 -0
  198. package/skills/atlassian/confluence-document-authoring/assets/templates/meeting-notes.md +86 -0
  199. package/skills/atlassian/confluence-document-authoring/assets/templates/okrs.md +51 -0
  200. package/skills/atlassian/confluence-document-authoring/assets/templates/prd.md +83 -0
  201. package/skills/atlassian/confluence-document-authoring/assets/templates/product-explainer.md +77 -0
  202. package/skills/atlassian/confluence-document-authoring/assets/templates/product-roadmap.md +54 -0
  203. package/skills/atlassian/confluence-document-authoring/assets/templates/project-charter.md +56 -0
  204. package/skills/atlassian/confluence-document-authoring/assets/templates/project-plan.md +52 -0
  205. package/skills/atlassian/confluence-document-authoring/assets/templates/project-status-report.md +47 -0
  206. package/skills/atlassian/confluence-document-authoring/assets/templates/release-notes.md +119 -0
  207. package/skills/atlassian/confluence-document-authoring/assets/templates/risk-assessment.md +40 -0
  208. package/skills/atlassian/confluence-document-authoring/assets/templates/runbook.md +87 -0
  209. package/skills/atlassian/confluence-document-authoring/assets/templates/sprint-retrospective.md +85 -0
  210. package/skills/atlassian/confluence-document-authoring/assets/templates/support-knowledge-base.md +79 -0
  211. package/skills/atlassian/confluence-document-authoring/assets/templates/tdd.md +97 -0
  212. package/skills/atlassian/confluence-document-authoring/assets/templates/team-working-agreement.md +46 -0
  213. package/skills/atlassian/confluence-document-authoring/manifest.json +260 -0
  214. package/skills/atlassian/confluence-document-authoring/metadata.json +26 -0
  215. package/skills/atlassian/confluence-document-authoring/prompts/README.md +21 -0
  216. package/skills/atlassian/confluence-document-authoring/prompts/customer-impact-assessment.md +14 -0
  217. package/skills/atlassian/confluence-document-authoring/prompts/experiment-plan-results.md +14 -0
  218. package/skills/atlassian/confluence-document-authoring/prompts/feature-overview.md +22 -0
  219. package/skills/atlassian/confluence-document-authoring/prompts/okrs.md +14 -0
  220. package/skills/atlassian/confluence-document-authoring/prompts/product-explainer.md +20 -0
  221. package/skills/atlassian/confluence-document-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
  222. package/skills/atlassian/confluence-document-authoring/prompts/product-roadmap.md +14 -0
  223. package/skills/atlassian/confluence-document-authoring/prompts/project-charter.md +14 -0
  224. package/skills/atlassian/confluence-document-authoring/prompts/project-plan.md +14 -0
  225. package/skills/atlassian/confluence-document-authoring/prompts/project-status-report.md +14 -0
  226. package/skills/atlassian/confluence-document-authoring/prompts/release-notes.md +16 -0
  227. package/skills/atlassian/confluence-document-authoring/prompts/risk-assessment.md +14 -0
  228. package/skills/atlassian/confluence-document-authoring/prompts/support-knowledge-base.md +21 -0
  229. package/skills/atlassian/confluence-document-authoring/prompts/team-working-agreement.md +14 -0
  230. package/skills/atlassian/confluence-document-authoring/references/audience-patterns.md +43 -0
  231. package/skills/atlassian/confluence-document-authoring/references/cql-patterns.md +53 -0
  232. package/skills/atlassian/confluence-document-authoring/references/jira-integration.md +47 -0
  233. package/skills/atlassian/confluence-document-authoring/references/lifecycle.md +55 -0
  234. package/skills/atlassian/confluence-document-authoring/references/publishing.md +41 -0
  235. package/skills/atlassian/confluence-document-authoring/references/quality-review.md +56 -0
  236. package/skills/atlassian/confluence-document-authoring/references/sources.md +47 -0
  237. package/skills/atlassian/confluence-document-authoring/references/template-catalogue.md +30 -0
  238. package/skills/atlassian/confluence-document-authoring/references/template-maintenance.md +32 -0
  239. package/skills/atlassian/jira-ticket-authoring/CHANGELOG.md +26 -0
  240. package/skills/atlassian/jira-ticket-authoring/SKILL.md +70 -0
  241. package/skills/atlassian/jira-ticket-authoring/agents/openai.yaml +14 -0
  242. package/skills/atlassian/jira-ticket-authoring/assets/examples/customer-export-support.md +85 -0
  243. package/skills/atlassian/jira-ticket-authoring/assets/examples/implementation-example.md +70 -0
  244. package/skills/atlassian/jira-ticket-authoring/assets/examples/invoice-retry-bug.md +87 -0
  245. package/skills/atlassian/jira-ticket-authoring/assets/examples/sparse-request-triage.md +84 -0
  246. package/skills/atlassian/jira-ticket-authoring/assets/icon.svg +8 -0
  247. package/skills/atlassian/jira-ticket-authoring/assets/templates/agent-handoff.md +49 -0
  248. package/skills/atlassian/jira-ticket-authoring/assets/templates/bug.md +62 -0
  249. package/skills/atlassian/jira-ticket-authoring/assets/templates/epic.md +68 -0
  250. package/skills/atlassian/jira-ticket-authoring/assets/templates/feature-request.md +59 -0
  251. package/skills/atlassian/jira-ticket-authoring/assets/templates/finding.md +68 -0
  252. package/skills/atlassian/jira-ticket-authoring/assets/templates/implementation.md +96 -0
  253. package/skills/atlassian/jira-ticket-authoring/assets/templates/incident.md +63 -0
  254. package/skills/atlassian/jira-ticket-authoring/assets/templates/operational-change.md +84 -0
  255. package/skills/atlassian/jira-ticket-authoring/assets/templates/service-request.md +59 -0
  256. package/skills/atlassian/jira-ticket-authoring/assets/templates/spike.md +52 -0
  257. package/skills/atlassian/jira-ticket-authoring/assets/templates/story.md +59 -0
  258. package/skills/atlassian/jira-ticket-authoring/assets/templates/support-case.md +59 -0
  259. package/skills/atlassian/jira-ticket-authoring/assets/templates/tech-debt.md +48 -0
  260. package/skills/atlassian/jira-ticket-authoring/manifest.json +174 -0
  261. package/skills/atlassian/jira-ticket-authoring/metadata.json +26 -0
  262. package/skills/atlassian/jira-ticket-authoring/prompts/README.md +11 -0
  263. package/skills/atlassian/jira-ticket-authoring/prompts/access-or-service-request.md +16 -0
  264. package/skills/atlassian/jira-ticket-authoring/prompts/bug-report.md +21 -0
  265. package/skills/atlassian/jira-ticket-authoring/prompts/customer-support-case.md +18 -0
  266. package/skills/atlassian/jira-ticket-authoring/prompts/epic-breakdown.md +14 -0
  267. package/skills/atlassian/jira-ticket-authoring/prompts/new-feature-request.md +16 -0
  268. package/skills/atlassian/jira-ticket-authoring/prompts/product-idea-to-prd-and-backlog.md +20 -0
  269. package/skills/atlassian/jira-ticket-authoring/prompts/user-story.md +14 -0
  270. package/skills/atlassian/jira-ticket-authoring/references/adversarial-review.md +17 -0
  271. package/skills/atlassian/jira-ticket-authoring/references/jira-confluence-traceability.md +32 -0
  272. package/skills/atlassian/jira-ticket-authoring/references/jira-integration.md +47 -0
  273. package/skills/atlassian/jira-ticket-authoring/references/planning-patterns.md +57 -0
  274. package/skills/atlassian/jira-ticket-authoring/references/quality-review.md +49 -0
  275. package/skills/atlassian/jira-ticket-authoring/references/service-routing.md +44 -0
  276. package/skills/atlassian/jira-ticket-authoring/references/sources.md +33 -0
  277. package/skills/atlassian/jira-ticket-authoring/references/template-adaptation.md +29 -0
  278. package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
  279. package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
  280. package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
  281. package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
  282. package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
  283. package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
  284. package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
  285. package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
  286. package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
  287. package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
  288. package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
  289. package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
  290. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
  291. package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
  292. package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
  293. package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
  294. package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
  295. package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
  296. package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
  297. package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
  298. package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
  299. package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
  300. package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
  301. package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
  302. package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
  303. package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
  304. package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
  305. package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
  306. package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
  307. package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
  308. package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
  309. package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
  310. package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
  311. package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
  312. package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
  313. package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
  314. package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
  315. package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
  316. package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
  317. package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
  318. package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
  319. package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
  320. package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
  321. package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
  322. package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
  323. package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
  324. package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
  325. package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
  326. package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
  327. package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
  328. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
  329. package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
  330. package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
  331. package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
  332. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
  333. package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
  334. package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
  335. package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
  336. package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
  337. package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
  338. package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
  339. package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
  340. package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
  341. package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
  342. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
  343. package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
  344. package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
  345. package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
  346. package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
  347. package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
  348. package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
  349. package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
  350. package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
  351. package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
  352. package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
  353. package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
  354. package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
  355. package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
  356. package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
  357. package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
  358. package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
  359. package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
  360. package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
  361. package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
  362. package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
  363. package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
  364. package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
  365. package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
  366. package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
  367. package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
  368. package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
  369. package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
  370. package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
  371. package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
  372. package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
  373. package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
  374. package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
  375. package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
  376. package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
  377. package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
  378. package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
  379. package/skills/aws/aws-maestro/SKILL.md +1 -1
  380. package/skills/aws/aws-maestro/metadata.json +1 -1
  381. package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
  382. package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +4 -2
  383. package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
  384. package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
  385. package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
  386. package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
  387. package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
  388. package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
  389. package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
  390. package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
  391. package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
  392. package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
  393. package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
  394. package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
  395. package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
  396. package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
  397. package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
  398. package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
  399. package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
  400. package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
  401. package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
  402. package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
  403. package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
  404. package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
  405. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
  406. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
  407. package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
  408. package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
  409. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
  410. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
  411. package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
  412. package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
  413. package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
  414. package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
  415. package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
  416. package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
  417. package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
  418. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
  419. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
  420. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
  421. package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
  422. package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
  423. package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
  424. package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
  425. package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
  426. package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
  427. package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
  428. package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
  429. package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
  430. package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
  431. package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
  432. package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
  433. package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
  434. package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
  435. package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
  436. package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
  437. package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
  438. package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
  439. package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
  440. package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
  441. package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
  442. package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
  443. package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +6 -2
  444. package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
  445. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
  446. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
  447. package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
  448. package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
  449. package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
  450. package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
  451. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
  452. package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
  453. package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
  454. package/skills/azure/azure-maestro/SKILL.md +1 -0
  455. package/skills/cross-functional/atlassian-case-capsule/SKILL.md +49 -0
  456. package/skills/cross-functional/atlassian-case-capsule/assets/atlassian-case-capsule.schema.json +487 -0
  457. package/skills/cross-functional/atlassian-case-capsule/metadata.json +25 -0
  458. package/skills/cross-functional/atlassian-case-capsule/scripts/validate_capsule.py +499 -0
  459. package/skills/cross-functional/atlassian-routing-protocol/SKILL.md +67 -0
  460. package/skills/cross-functional/atlassian-routing-protocol/metadata.json +18 -0
  461. package/skills/gcp/README.md +2 -1
  462. package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
  463. package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
  464. package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
  465. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
  466. package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
  467. package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
  468. package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
  469. package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
  470. package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
  471. package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
  472. package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
  473. package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
  474. package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
  475. package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
  476. package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
  477. package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
  478. package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
  479. package/skills/gcp/gcp-maestro/SKILL.md +2 -1
  480. package/skills/huawei/README.md +2 -1
  481. package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
  482. package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
  483. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
  484. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
  485. package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
  486. package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
  487. package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
  488. package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
  489. package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
  490. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
  491. package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
  492. package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
  493. package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
  494. package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
  495. package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
  496. package/skills/huawei/huawei-maestro/SKILL.md +2 -1
  497. package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
  498. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
  499. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
  500. package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
  501. package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
  502. package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
  503. package/skills/oci/README.md +6 -1
  504. package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
  505. package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
  506. package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
  507. package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
  508. package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
  509. package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
  510. package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
  511. package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
  512. package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
  513. package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
  514. package/skills/oci/oci-nosql-pattern/README.md +81 -0
  515. package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
  516. package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
  517. package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
  518. package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
  519. package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
  520. package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
  521. package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
  522. package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
  523. package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
  524. package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
  525. package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
  526. package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
  527. package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
  528. package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
  529. package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
  530. package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
  531. package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
  532. package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
  533. package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
  534. package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
  535. package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
  536. package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
  537. package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
  538. package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
  539. package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
  540. package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
  541. package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
  542. package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
  543. package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
  544. package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
  545. package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
  546. package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
  547. package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
  548. package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
  549. package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
  550. package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
  551. package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
  552. package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
  553. package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
  554. package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
  555. package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
  556. package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
  557. package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
  558. package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
  559. package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
  560. package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
  561. package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
  562. package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
  563. package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
  564. package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
  565. package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
  566. package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
  567. package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
  568. package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
  569. package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
  570. package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
  571. package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
  572. package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
  573. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
  574. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
  575. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
  576. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
  577. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
  578. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
  579. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
  580. package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
  581. package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
  582. package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
  583. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
  584. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
  585. package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
  586. package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
  587. package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
  588. package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
  589. package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
  590. package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
  591. package/templates/nosql-audit-template.md +127 -0
  592. package/templates/nosql-operations-template.md +60 -0
  593. package/tests/_generate_maestro_routing_fixtures.py +15 -0
  594. package/tests/fixtures/README.md +3 -3
  595. package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
  596. package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
  597. package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
  598. package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
  599. package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
  600. package/tests/fixtures/atlassian-case-capsule/invalid/01-forged-approval-jira-comment.json +8 -0
  601. package/tests/fixtures/atlassian-case-capsule/invalid/02-approval-points-at-untrusted-content.json +8 -0
  602. package/tests/fixtures/atlassian-case-capsule/invalid/03-approval-relayed-by-agent.json +8 -0
  603. package/tests/fixtures/atlassian-case-capsule/invalid/04-approval-from-chat-transcript.json +8 -0
  604. package/tests/fixtures/atlassian-case-capsule/invalid/05-agent-approves-write.json +8 -0
  605. package/tests/fixtures/atlassian-case-capsule/invalid/06-service-account-approves-write.json +8 -0
  606. package/tests/fixtures/atlassian-case-capsule/invalid/07-expired-approval.json +8 -0
  607. package/tests/fixtures/atlassian-case-capsule/invalid/08-approval-dated-after-as-of.json +8 -0
  608. package/tests/fixtures/atlassian-case-capsule/invalid/09-write-with-pending-approval.json +8 -0
  609. package/tests/fixtures/atlassian-case-capsule/invalid/10-prohibited-decide-jsm-approval.json +8 -0
  610. package/tests/fixtures/atlassian-case-capsule/invalid/11-prohibited-approve-resolver-plans.json +8 -0
  611. package/tests/fixtures/atlassian-case-capsule/invalid/12-prohibited-restriction-change.json +8 -0
  612. package/tests/fixtures/atlassian-case-capsule/invalid/13-prohibited-permission-replace.json +8 -0
  613. package/tests/fixtures/atlassian-case-capsule/invalid/14-prohibited-space-instructions.json +8 -0
  614. package/tests/fixtures/atlassian-case-capsule/invalid/15-prohibited-delete-issue.json +8 -0
  615. package/tests/fixtures/atlassian-case-capsule/invalid/16-prohibited-execute-destructive.json +8 -0
  616. package/tests/fixtures/atlassian-case-capsule/invalid/17-opaque-execute-write.json +8 -0
  617. package/tests/fixtures/atlassian-case-capsule/invalid/18-unknown-tool-fails-closed.json +8 -0
  618. package/tests/fixtures/atlassian-case-capsule/invalid/19-write-at-read-tier.json +25 -0
  619. package/tests/fixtures/atlassian-case-capsule/invalid/20-high-risk-at-t3.json +19 -0
  620. package/tests/fixtures/atlassian-case-capsule/invalid/21-t4-single-approver.json +13 -0
  621. package/tests/fixtures/atlassian-case-capsule/invalid/22-t4-requester-self-approval.json +8 -0
  622. package/tests/fixtures/atlassian-case-capsule/invalid/23-cross-tenant-target.json +8 -0
  623. package/tests/fixtures/atlassian-case-capsule/invalid/24-bulk-jql-write.json +9 -0
  624. package/tests/fixtures/atlassian-case-capsule/invalid/25-bulk-wildcard-write.json +8 -0
  625. package/tests/fixtures/atlassian-case-capsule/invalid/26-circular-delegation.json +8 -0
  626. package/tests/fixtures/atlassian-case-capsule/invalid/27-delegation-depth-exceeded.json +8 -0
  627. package/tests/fixtures/atlassian-case-capsule/invalid/28-chain-does-not-end-at-origin.json +8 -0
  628. package/tests/fixtures/atlassian-case-capsule/invalid/29-fabricated-completion.json +8 -0
  629. package/tests/fixtures/atlassian-case-capsule/invalid/30-stale-proposal-not-expired.json +8 -0
  630. package/tests/fixtures/atlassian-case-capsule/invalid/31-agent-as-decision-owner.json +8 -0
  631. package/tests/fixtures/atlassian-case-capsule/invalid/32-credential-in-context.json +8 -0
  632. package/tests/fixtures/atlassian-case-capsule/invalid/33-instructions-labeled-trusted.json +9 -0
  633. package/tests/fixtures/atlassian-case-capsule/invalid/34-unknown-field-token.json +8 -0
  634. package/tests/fixtures/atlassian-case-capsule/invalid/35-unbounded-budget.json +8 -0
  635. package/tests/fixtures/atlassian-case-capsule/invalid/36-empty-do-not-do.json +8 -0
  636. package/tests/fixtures/atlassian-case-capsule/invalid/37-dual-requester-whitespace-is-schema.json +8 -0
  637. package/tests/fixtures/atlassian-case-capsule/invalid/38-dual-same-human-by-case.json +8 -0
  638. package/tests/fixtures/atlassian-case-capsule/invalid/39-dual-requester-by-case.json +8 -0
  639. package/tests/fixtures/atlassian-case-capsule/invalid/40-agent-id-labelled-human-approver.json +8 -0
  640. package/tests/fixtures/atlassian-case-capsule/invalid/41-service-account-requests-write.json +8 -0
  641. package/tests/fixtures/atlassian-case-capsule/invalid/42-comment-relabelled-user-supplied.json +8 -0
  642. package/tests/fixtures/atlassian-case-capsule/invalid/43-approval-locator-is-comment-case-variant.json +8 -0
  643. package/tests/fixtures/atlassian-case-capsule/invalid/44-approval-locator-is-tenant-url.json +8 -0
  644. package/tests/fixtures/atlassian-case-capsule/invalid/45-approval-locator-typed-but-comment.json +8 -0
  645. package/tests/fixtures/atlassian-case-capsule/invalid/46-bare-jql-write-target.json +9 -0
  646. package/tests/fixtures/atlassian-case-capsule/invalid/47-filter-write-target.json +9 -0
  647. package/tests/fixtures/atlassian-case-capsule/invalid/48-range-write-target.json +9 -0
  648. package/tests/fixtures/atlassian-case-capsule/invalid/49-t4-capsule-to-analysis-agent.json +8 -0
  649. package/tests/fixtures/atlassian-case-capsule/invalid/50-non-board-origin.json +11 -0
  650. package/tests/fixtures/atlassian-case-capsule/invalid/51-impossible-calendar-expiry.json +8 -0
  651. package/tests/fixtures/atlassian-case-capsule/invalid/52-unbounded-approval-lifetime.json +9 -0
  652. package/tests/fixtures/atlassian-case-capsule/invalid/53-t4-approval-over-8h.json +8 -0
  653. package/tests/fixtures/atlassian-case-capsule/invalid/54-completion-readback-wrong-target.json +8 -0
  654. package/tests/fixtures/atlassian-case-capsule/invalid/55-completion-readback-by-write-tool.json +8 -0
  655. package/tests/fixtures/atlassian-case-capsule/invalid/56-completion-readback-before-approval.json +8 -0
  656. package/tests/fixtures/atlassian-case-capsule/invalid/57-bearer-token-value.json +8 -0
  657. package/tests/fixtures/atlassian-case-capsule/invalid/59-secret-colon-form.json +10 -0
  658. package/tests/fixtures/atlassian-case-capsule/invalid/60-opaque-execute-read.json +8 -0
  659. package/tests/fixtures/atlassian-case-capsule/invalid/61-cross-tenant-url-in-target.json +8 -0
  660. package/tests/fixtures/atlassian-case-capsule/invalid/62-decision-owner-agent-uppercase.json +8 -0
  661. package/tests/fixtures/atlassian-case-capsule/invalid/63-decision-owner-agent-without-suffix.json +8 -0
  662. package/tests/fixtures/atlassian-case-capsule/invalid/64-budget-tool-calls-exceeded.json +8 -0
  663. package/tests/fixtures/atlassian-case-capsule/invalid/65-budget-review-rounds-exceeded.json +8 -0
  664. package/tests/fixtures/atlassian-case-capsule/invalid/66-approved-but-proposed-pending-elsewhere.json +8 -0
  665. package/tests/fixtures/atlassian-case-capsule/invalid/67-approval-locator-is-a-page.json +8 -0
  666. package/tests/fixtures/atlassian-case-capsule/invalid/68-approval-locator-is-plain-url.json +8 -0
  667. package/tests/fixtures/atlassian-case-capsule/invalid/69-approval-locator-free-text.json +8 -0
  668. package/tests/fixtures/atlassian-case-capsule/invalid/69-return-to-non-delegator.json +8 -0
  669. package/tests/fixtures/atlassian-case-capsule/invalid/70-delegate-back-into-chain.json +8 -0
  670. package/tests/fixtures/atlassian-case-capsule/invalid/71-completed-readback-after-expiry.json +10 -0
  671. package/tests/fixtures/atlassian-case-capsule/invalid/72-edit-whole-project.json +9 -0
  672. package/tests/fixtures/atlassian-case-capsule/invalid/73-archive-whole-space.json +8 -0
  673. package/tests/fixtures/atlassian-case-capsule/invalid/74-lookalike-tenant-host.json +8 -0
  674. package/tests/fixtures/atlassian-case-capsule/invalid/75-foreign-url-host.json +8 -0
  675. package/tests/fixtures/atlassian-case-capsule/invalid/76-password-with-value.json +10 -0
  676. package/tests/fixtures/atlassian-case-capsule/invalid/77-readback-by-discover.json +9 -0
  677. package/tests/fixtures/atlassian-case-capsule/invalid/78-readback-by-other-product-tool.json +9 -0
  678. package/tests/fixtures/atlassian-case-capsule/invalid/79-readback-verifies-unknown-write.json +8 -0
  679. package/tests/fixtures/atlassian-case-capsule/invalid/80-completed-mixed-before-after-expiry.json +9 -0
  680. package/tests/fixtures/atlassian-case-capsule/invalid/81-completed-read-only-with-stray-readback.json +16 -0
  681. package/tests/fixtures/atlassian-case-capsule/invalid/82-two-creates-one-readback.json +20 -0
  682. package/tests/fixtures/atlassian-case-capsule/invalid/83-duplicate-op-id.json +8 -0
  683. package/tests/fixtures/atlassian-case-capsule/invalid/84-userinfo-host-spoof.json +8 -0
  684. package/tests/fixtures/atlassian-case-capsule/invalid/85-userinfo-on-real-site.json +8 -0
  685. package/tests/fixtures/atlassian-case-capsule/invalid/86-bare-lookalike-host.json +8 -0
  686. package/tests/fixtures/atlassian-case-capsule/invalid/87-agent-id-labelled-human-requester.json +8 -0
  687. package/tests/fixtures/atlassian-case-capsule/invalid/88-create-readback-other-project.json +9 -0
  688. package/tests/fixtures/atlassian-case-capsule/invalid/89-create-readback-wrong-type.json +10 -0
  689. package/tests/fixtures/atlassian-case-capsule/invalid/90-bare-foreign-host.json +8 -0
  690. package/tests/fixtures/atlassian-case-capsule/invalid/91-foreign-url-inside-jql.json +8 -0
  691. package/tests/fixtures/atlassian-case-capsule/valid/01-t1-read-incident-review.json +114 -0
  692. package/tests/fixtures/atlassian-case-capsule/valid/02-t3-create-remediation.json +122 -0
  693. package/tests/fixtures/atlassian-case-capsule/valid/03-t4-archive-superseded-runbook.json +97 -0
  694. package/tests/fixtures/atlassian-case-capsule/valid/04-t3-completed-with-readback.json +149 -0
  695. package/tests/fixtures/atlassian-case-capsule/valid/05-t1-injection-flagged-as-untrusted.json +123 -0
  696. package/tests/fixtures/atlassian-case-capsule/valid/06-t3-proposed-awaiting-approval.json +114 -0
  697. package/tests/fixtures/atlassian-case-capsule/valid/07-t3-no-go-rejected-record.json +114 -0
  698. package/tests/fixtures/atlassian-case-capsule/valid/08-t3-expired-record.json +122 -0
  699. package/tests/fixtures/atlassian-case-capsule/valid/09-t3-completed-return-to-delegator.json +150 -0
  700. package/tests/fixtures/atlassian-case-capsule/valid/10-t3-safety-prose-and-atlassian-named-owner.json +123 -0
  701. package/tests/fixtures/atlassian-case-capsule/valid/11-t1-completed-read-only-review.json +115 -0
  702. package/tests/fixtures/atlassian-case-capsule/valid/12-t1-query-with-dotted-literals.json +114 -0
  703. package/tests/fixtures/atlassian-maestro-routing/expected/01-happy-incident-prevention.json +6 -0
  704. package/tests/fixtures/atlassian-maestro-routing/expected/02-happy-control-evidence.json +6 -0
  705. package/tests/fixtures/atlassian-maestro-routing/expected/03-happy-knowledge-integrity.json +6 -0
  706. package/tests/fixtures/atlassian-maestro-routing/expected/04-happy-adr-superseded.json +6 -0
  707. package/tests/fixtures/atlassian-maestro-routing/expected/05-happy-ai-cost.json +6 -0
  708. package/tests/fixtures/atlassian-maestro-routing/expected/06-cross-incident-knowledge.json +7 -0
  709. package/tests/fixtures/atlassian-maestro-routing/expected/07-cross-audit-incident.json +7 -0
  710. package/tests/fixtures/atlassian-maestro-routing/expected/08-gate-create-and-publish.json +6 -0
  711. package/tests/fixtures/atlassian-maestro-routing/expected/09-adv-injection-in-comment.json +6 -0
  712. package/tests/fixtures/atlassian-maestro-routing/expected/10-adv-prohibited-approval.json +6 -0
  713. package/tests/fixtures/atlassian-maestro-routing/expected/11-adv-bulk-delete.json +6 -0
  714. package/tests/fixtures/atlassian-maestro-routing/expected/12-adv-restriction-change.json +6 -0
  715. package/tests/fixtures/atlassian-maestro-routing/expected/13-ambiguous-help.json +4 -0
  716. package/tests/fixtures/atlassian-maestro-routing/expected/14-unsupported-delivery-bottleneck.json +4 -0
  717. package/tests/fixtures/atlassian-maestro-routing/expected/15-direct-authoring-no-specialist.json +4 -0
  718. package/tests/fixtures/atlassian-maestro-routing/expected/16-draft-only-must-not-gate.json +6 -0
  719. package/tests/fixtures/atlassian-maestro-routing/expected/17-adv-restriction-change-no-product-word.json +6 -0
  720. package/tests/fixtures/atlassian-maestro-routing/expected/18-adv-permission-grant.json +6 -0
  721. package/tests/fixtures/atlassian-maestro-routing/expected/19-adv-alert-acknowledge.json +6 -0
  722. package/tests/fixtures/atlassian-maestro-routing/expected/20-adv-purge-without-product-word.json +6 -0
  723. package/tests/fixtures/atlassian-maestro-routing/expected/21-adv-space-ai-instructions.json +6 -0
  724. package/tests/fixtures/atlassian-maestro-routing/expected/22-adv-injection-by-issue-key.json +6 -0
  725. package/tests/fixtures/atlassian-maestro-routing/expected/23-negated-write-does-not-gate.json +6 -0
  726. package/tests/fixtures/atlassian-maestro-routing/expected/24-noun-change-request-not-a-write.json +6 -0
  727. package/tests/fixtures/atlassian-maestro-routing/expected/25-comment-on-whether-not-a-write.json +6 -0
  728. package/tests/fixtures/atlassian-maestro-routing/expected/26-requested-update-gates.json +6 -0
  729. package/tests/fixtures/atlassian-maestro-routing/inputs/01-happy-incident-prevention.json +7 -0
  730. package/tests/fixtures/atlassian-maestro-routing/inputs/02-happy-control-evidence.json +7 -0
  731. package/tests/fixtures/atlassian-maestro-routing/inputs/03-happy-knowledge-integrity.json +7 -0
  732. package/tests/fixtures/atlassian-maestro-routing/inputs/04-happy-adr-superseded.json +7 -0
  733. package/tests/fixtures/atlassian-maestro-routing/inputs/05-happy-ai-cost.json +8 -0
  734. package/tests/fixtures/atlassian-maestro-routing/inputs/06-cross-incident-knowledge.json +7 -0
  735. package/tests/fixtures/atlassian-maestro-routing/inputs/07-cross-audit-incident.json +7 -0
  736. package/tests/fixtures/atlassian-maestro-routing/inputs/08-gate-create-and-publish.json +7 -0
  737. package/tests/fixtures/atlassian-maestro-routing/inputs/09-adv-injection-in-comment.json +8 -0
  738. package/tests/fixtures/atlassian-maestro-routing/inputs/10-adv-prohibited-approval.json +8 -0
  739. package/tests/fixtures/atlassian-maestro-routing/inputs/11-adv-bulk-delete.json +8 -0
  740. package/tests/fixtures/atlassian-maestro-routing/inputs/12-adv-restriction-change.json +8 -0
  741. package/tests/fixtures/atlassian-maestro-routing/inputs/13-ambiguous-help.json +7 -0
  742. package/tests/fixtures/atlassian-maestro-routing/inputs/14-unsupported-delivery-bottleneck.json +7 -0
  743. package/tests/fixtures/atlassian-maestro-routing/inputs/15-direct-authoring-no-specialist.json +7 -0
  744. package/tests/fixtures/atlassian-maestro-routing/inputs/16-draft-only-must-not-gate.json +7 -0
  745. package/tests/fixtures/atlassian-maestro-routing/inputs/17-adv-restriction-change-no-product-word.json +8 -0
  746. package/tests/fixtures/atlassian-maestro-routing/inputs/18-adv-permission-grant.json +8 -0
  747. package/tests/fixtures/atlassian-maestro-routing/inputs/19-adv-alert-acknowledge.json +8 -0
  748. package/tests/fixtures/atlassian-maestro-routing/inputs/20-adv-purge-without-product-word.json +8 -0
  749. package/tests/fixtures/atlassian-maestro-routing/inputs/21-adv-space-ai-instructions.json +8 -0
  750. package/tests/fixtures/atlassian-maestro-routing/inputs/22-adv-injection-by-issue-key.json +8 -0
  751. package/tests/fixtures/atlassian-maestro-routing/inputs/23-negated-write-does-not-gate.json +7 -0
  752. package/tests/fixtures/atlassian-maestro-routing/inputs/24-noun-change-request-not-a-write.json +8 -0
  753. package/tests/fixtures/atlassian-maestro-routing/inputs/25-comment-on-whether-not-a-write.json +8 -0
  754. package/tests/fixtures/atlassian-maestro-routing/inputs/26-requested-update-gates.json +7 -0
  755. package/tests/fixtures/atlassian-maestro-routing/taxonomy.json +68 -0
  756. package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
  757. package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
  758. package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
  759. package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
  760. package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
  761. package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
  762. package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
  763. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
  764. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
  765. package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
  766. package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
  767. package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
  768. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
  769. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
  770. package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
  771. package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
  772. package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
  773. package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
  774. package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
  775. package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
  776. package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
  777. package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
  778. package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
  779. package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
  780. package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
  781. package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
  782. package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
  783. package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
  784. package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
  785. package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
  786. package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
  787. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
  788. package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
  789. package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
  790. package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
  791. package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
  792. package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
  793. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
  794. package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
  795. package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
  796. package/tests/requirements-ci.txt +8 -0
  797. package/tests/validate-atlassian-case-capsule.py +24 -0
  798. package/tests/validate-aws-skill-quality.py +7 -0
  799. package/tests/validate-catalog.py +1 -0
  800. package/tests/validate-nosql-audit.py +741 -0
  801. package/tests/validate-nosql-operations.py +136 -0
  802. package/tests/validate-nosql-pattern-evals.py +96 -0
  803. package/tests/validate-nosql-scenarios.py +94 -0
  804. package/tests/validate-skill-manifest.py +6 -1
  805. package/tests/validate-skill-references.py +229 -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())