@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,237 @@
1
+ # Embeddings: meaning, precision and AWS integration
2
+
3
+ Documentation checked 2026-11-08. Read this when someone asks what vector numbers
4
+ mean, how many floating-point digits survive, or whether vectors point into S3.
5
+ For index schemas, request shapes and limits, use [native vectors](data-types-and-vectors.md).
6
+ Load [the CLI companion](commands/embedding.md) only when commands are requested;
7
+ do not load it or its request assets merely to explain precision or architecture.
8
+
9
+ ## First correct the mental model
10
+
11
+ An embedding is an ordered array of coordinates produced by a trained model for
12
+ text, images or other supported input. Nearby vectors can represent similar content
13
+ under that model and distance function. A coordinate is **not** a document ID,
14
+ memory address, S3 object offset, URL or reliably human-named concept. The whole
15
+ vector participates in comparison; do not assign a meaning to dimension 17.
16
+
17
+ Keep three different things:
18
+
19
+ | Thing | Example | Job |
20
+ |---|---|---|
21
+ | Content | A paragraph from a manual | Original evidence used to answer |
22
+ | Embedding | `[0.12, -0.04, ...]` | Similarity ranking, not a source locator |
23
+ | Identity/lineage | Document ID, chunk ID, bucket/key/VersionId, model configuration | Retrieve the correct source and track changes |
24
+
25
+ Neither DynamoDB nor S3 Vectors discovers a source object from the coordinates.
26
+ Store that association explicitly in the item/metadata or a separately controlled
27
+ lookup. Content can also live directly in DynamoDB; **S3 is not mandatory**.
28
+ An embedding is not encryption, anonymization, proof of relevance or factual truth.
29
+ Do not expose vectors/content merely because the original document is elsewhere.
30
+
31
+ ## What does “up to what floating point” mean?
32
+
33
+ Separate **dimensions**, **precision**, **numeric range** and **wire format**:
34
+
35
+ | Layer | Actual contract |
36
+ |---|---|
37
+ | Model output | Model-specific dimensions and representations; choose first |
38
+ | DynamoDB base item | Ordered `L` of `N`; Numbers allow up to 38 significant decimal digits, not a native float64 column |
39
+ | DynamoDB vector index | **float32 / f32**; extra base-item precision is lost in the index |
40
+ | S3 Vectors | `data.float32` coordinates; higher-precision SDK inputs are converted to float32 |
41
+ | Runtime | JS/Python/PHP numbers are commonly binary64; that does not turn either index into float64 |
42
+
43
+ Binary32 has 24 significand bits: roughly **7 significant decimal digits**, not
44
+ 7 digits after the decimal point. Six decimal significant digits have the usual
45
+ decimal-to-f32-to-decimal preservation guarantee; nine digits suffice to serialize
46
+ an existing f32 value for round-trip recovery. Printing more digits adds no index
47
+ precision. For example, `1.00000001` rounds to `1.0` in f32. Do not truncate every
48
+ coordinate to a fixed number of decimal places: that can damage small values.
49
+
50
+ - Largest finite magnitude is approximately **3.4028235e38**. This is a format
51
+ boundary, not a useful target value or a guarantee of stable distance arithmetic.
52
+ - Smallest positive *normal* value is approximately **1.17549435e-38**. IEEE f32
53
+ also represents subnormals down to approximately **1.40129846e-45**, with reduced
54
+ precision. Smaller nonzero numbers can round to zero. The cited AWS docs do not
55
+ specify an end-to-end guarantee for subnormal handling in distance computation.
56
+ - Reject NaN, positive/negative Infinity, overflow and wrong dimensions. Define
57
+ underflow/subnormal and all-zero-vector policies; a zero vector has no cosine
58
+ direction. This example conservatively rejects subnormals/nonzero underflow.
59
+ - DynamoDB Number's much wider range (positive 1e-130 to about 1e126, plus negative
60
+ counterparts and zero) is **not** the safe vector-index range.
61
+ - float16/bfloat16 inputs converted to f32 cannot regain lost information. Packed
62
+ binary embeddings are a different representation: do not reinterpret them as
63
+ DynamoDB numeric-list coordinates or S3 Vectors float32 data. Neither service
64
+ exposes a float64 vector-index selection in the contracts cited here.
65
+
66
+ Normalizing a nonzero vector makes its length one; it does not change its
67
+ dimensions, create source links, align different models, or increase precision.
68
+ Do not assume all models always output values in `[-1, 1]`. Persist the model ID,
69
+ revision/deployment, dimension count, normalization and preprocessing/chunking
70
+ version. Same dimensions alone do **not** make two models' spaces comparable.
71
+
72
+ ## Pick one retrieval architecture, not every AWS service
73
+
74
+ | Requirement | Smallest candidate | Ownership/caveat |
75
+ |---|---|---|
76
+ | Operational items and embeddings already belong together | Bedrock model + DynamoDB native index | Application owns ingestion, authorization and retrieval orchestration |
77
+ | Managed document RAG from S3 files | Bedrock Knowledge Bases + S3 Vectors | KB manages parsing/chunking/embedding/ingestion; verify features/Region/quotas |
78
+ | Direct vector storage without a KB | Bedrock or another model + S3 Vectors API | Application owns chunk/source mapping, synchronization and query generation |
79
+ | Workload needs additional lexical/hybrid capabilities | Evaluate OpenSearch or another supported store | Prove feature needs and retrieval quality before adding an engine |
80
+
81
+ These are design candidates, not measured performance/cost recommendations.
82
+ An **ordinary S3 object bucket** holds documents (or serialized vector files).
83
+ Uploading `embedding.json` there does not create semantic search. An **S3 vector
84
+ bucket** holds vector indexes and uses dedicated `s3vectors` APIs. A **DynamoDB
85
+ vector index** belongs to a DynamoDB table and uses `SearchVectors`. It does not
86
+ need or imply an S3 vector bucket, nor automatically mirror into one.
87
+
88
+ ### A. Application-managed DynamoDB retrieval
89
+
90
+ ```text
91
+ Source text (in DynamoDB, or extracted from an authorized versioned S3 object)
92
+ -> deterministic chunking -> Bedrock embedding model -> validate float32/dimensions
93
+ -> DynamoDB item: chunk + source reference + model lineage + L-of-N embedding
94
+ -> native vector index (asynchronous)
95
+
96
+ User question -> SAME embedding configuration -> SearchVectors
97
+ -> candidate PKs -> authorized GetItem/BatchGetItem -> verify current access/revision
98
+ -> chunk text or exact authorized S3 object version -> optional Bedrock generation
99
+ ```
100
+
101
+ [embedding-flow.py](../assets/embedding-flow.py) is an injected-client, low-level
102
+ Boto3-style example; import does nothing and no dependencies are installed. Its
103
+ `index_chunk`/`search_chunks` functions incur service calls **only when invoked**.
104
+ It uses Titan Text Embeddings V2, `amazon.titan-embed-text-v2:0`, **1024** dimensions,
105
+ `normalize: true`, `embeddingTypes: ["float"]`, with COSINE. Titan V2 also supports
106
+ 512/256 dimensions; it cannot produce the existing three-dimensional toy fixture.
107
+ **Do not run this example against that fixture unchanged.**
108
+
109
+ For a separately approved new table, clone the optional vector table asset and set
110
+ the vector index Dimensions to 1024, retaining Tenant HASH / Status INLINE_FILTER
111
+ and COSINE. Review schema/IAM/costs first; dimensions of an existing index are not
112
+ mutable. The current narrow projection returns PK, not all source/chunk fields;
113
+ fetch base items explicitly. Confirm trusted deployment configuration binds that
114
+ index to this exact model/preprocessing generation, not just dimension 1024.
115
+
116
+ Example caller fragment (not a standalone deployment or authorization layer):
117
+
118
+ ```python
119
+ import boto3
120
+ # Import functions from the bundled embedding-flow.py, e.g. after copying it to
121
+ # your application's embedding_flow module. Import does not create clients.
122
+ from embedding_flow import index_chunk, search_chunks
123
+
124
+ # Fill only from reviewed deployment configuration and authenticated server context.
125
+ session = boto3.Session(profile_name=approved_profile, region_name=approved_region)
126
+ bedrock = session.client("bedrock-runtime")
127
+ ddb = session.client("dynamodb") # SDK version must expose search_vectors
128
+ index_chunk(bedrock, ddb, approved_table, authenticated_tenant,
129
+ immutable_tenant_document_version_chunk_key, extracted_chunk_text,
130
+ {"bucket": approved_source_bucket, "key": approved_source_key,
131
+ "version_id": approved_non_null_version_id})
132
+ results = search_chunks(bedrock, ddb, approved_table, approved_index,
133
+ authenticated_tenant, user_question, top_k=10)
134
+ # Results contain candidate keys/scores; authorize and fetch source content next.
135
+ ```
136
+
137
+ The example quantizes to f32 deliberately and serializes with nine significant
138
+ digits as low-level `{"N":"..."}` values. Storage uses `{"L":[...]}`; search uses
139
+ the bare array. Other languages follow the same contract: explicit f32 conversion,
140
+ finite/length checks, ordered numeric serialization and the same model settings.
141
+ For JS use a checked `Math.fround` conversion, not binary bytes from Float32Array;
142
+ Java/Kotlin/Rust use their f32-compatible type/conversion. A document client and a
143
+ low-level AttributeValue client need different marshaling; see [SDK adapters](language-adapters.md).
144
+
145
+ ### B. Managed Knowledge Bases with S3 Vectors
146
+
147
+ ```text
148
+ Ordinary S3 source bucket -> KB synchronization/ingestion
149
+ -> parsing/chunking -> configured Bedrock embedding model
150
+ -> separate S3 vector bucket + vector index
151
+ User question -> KB Retrieve (chunks/citations) or RetrieveAndGenerate (also answer)
152
+ ```
153
+
154
+ S3 Vectors is a documented KB backing store. Current Bedrock StorageConfiguration
155
+ does **not** list DynamoDB as a backing store; do not invent direct managed KB to
156
+ native DynamoDB-vector support. Calling Bedrock yourself is not the same as using
157
+ a Knowledge Base. Recheck support at use time rather than claiming never.
158
+
159
+ With **direct S3 Vectors**, PutVectors uses `vectors[].data.float32`, while
160
+ QueryVectors uses **`queryVector.float32`**. Do not substitute DynamoDB L/N or
161
+ ordinary S3 GetObject APIs. These illustrative requests assume a separately created
162
+ **three-dimensional** S3 vector index, not the 1024-dimensional Titan example:
163
+
164
+ ```json
165
+ {
166
+ "vectorBucketName": "example-vector-bucket",
167
+ "indexName": "example-three-dimensional-index",
168
+ "vectors": [{
169
+ "key": "manual-v17-chunk-1",
170
+ "data": {"float32": [0.1, 0.2, 0.3]},
171
+ "metadata": {"sourceBucket": "example-source", "sourceKey": "manual.txt", "sourceVersion": "v17"}
172
+ }]
173
+ }
174
+ ```
175
+
176
+ ```json
177
+ {
178
+ "vectorBucketName": "example-vector-bucket",
179
+ "indexName": "example-three-dimensional-index",
180
+ "queryVector": {"float32": [0.1, 0.2, 0.3]},
181
+ "topK": 3,
182
+ "returnMetadata": true
183
+ }
184
+ ```
185
+
186
+ A vector key identifies a vector *within its index*; it need not be an S3 object key.
187
+ KB owns its managed metadata/citations; do not assume custom raw-vector writes will
188
+ become retrievable KB chunks. S3 Vectors' strongly consistent writes do not make
189
+ KB ingestion synchronous or DynamoDB vector indexes strongly consistent.
190
+
191
+ ## Failure cases that must survive review
192
+
193
+ - **“S3 upload means searchable now.”** No. An application ingestion job or KB sync
194
+ must succeed. Test create/update/delete, duplicate/out-of-order events and lag;
195
+ use bounded retries, a failure destination and observable ingestion state.
196
+ - **“One chunk key can be overwritten on every retry.”** Stale workers can replace
197
+ newer content. Use tenant/document/version/chunk/model-generation identity and
198
+ conditional/idempotent writes. The example condition prevents overwrites; it is
199
+ not a complete event ledger or source-version arbitration implementation. Publish
200
+ the current revision only after ingestion validation; retire obsolete vectors.
201
+ - **“Changing model only requires changing a string.”** New coordinate space needs
202
+ re-embedding/backfill and a separate index/generation, then measured cutover.
203
+ Do not mix models even when they emit identical dimensions.
204
+ - **“A tenant filter authorizes access.”** Derive it server-side; DynamoDB search
205
+ filters are not IAM row isolation. Revalidate content ACLs/revocation before
206
+ returning chunks or sending them to generation. A source URI grants no access.
207
+ - **“One permission covers everything.”** Separate Bedrock InvokeModel, DynamoDB
208
+ writes/index search/base reads, S3 GetObjectVersion for pinned source versions,
209
+ S3 Vectors actions and applicable KMS permissions. Encryption configuration and
210
+ key access are service-specific; see [encryption](encryption.md).
211
+ - **“More decimals/dimensions/services guarantee better answers.”** Compare labeled
212
+ retrieval recall@k/relevance, filtered/tenant-negative results, source freshness,
213
+ latency and total ingestion/query/storage/generation cost. Measure item bytes;
214
+ base Number encoding is not simply `dimensions * 4`. Respect model input and
215
+ DynamoDB 400 KB item limits. Protect logs and treat retrieved text as untrusted
216
+ data, not instructions; citations and similarity scores are not truth guarantees.
217
+
218
+ ## Primary sources
219
+
220
+ - [DynamoDB precision/constraints](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/VectorSearch.Requirements.html),
221
+ [base Number types](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.NamingRulesDataTypes.html),
222
+ [embedding workflow](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/VectorSearchWorkingWith.html).
223
+ - [IEEE binary formats in Python struct](https://docs.python.org/3/library/struct.html),
224
+ [binary32 constants/significand](https://learn.microsoft.com/en-us/cpp/cpp/floating-limits?view=msvc-170).
225
+ Subnormal floor is derived as 2^-149; this is format math, not a tested AWS promise.
226
+ - [Titan V2 contract](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters-titan-embed-text.html),
227
+ [DynamoDB/Bedrock tutorial](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/VectorSearchTutorial.html).
228
+ - [S3 bucket/API distinction](https://aws.amazon.com/s3/faqs/),
229
+ [S3 PutVectors float32](https://docs.aws.amazon.com/AmazonS3/latest/API/API_S3VectorBuckets_PutVectors.html),
230
+ [S3 QueryVectors shape](https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3vectors-2025-07-15.html),
231
+ [KB integration](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-vectors-bedrock-kb.html),
232
+ [KB storage configuration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_StorageConfiguration.html),
233
+ [KB permissions](https://docs.aws.amazon.com/bedrock/latest/userguide/kb-permissions.html).
234
+
235
+ These are documentation-backed designs plus locally mocked examples. Live IAM,
236
+ SDK/service acceptance, ingestion/retrieval freshness, relevance, latency and cost
237
+ remain **UNVERIFIED**. Do not deploy or claim production readiness from this guide.
@@ -0,0 +1,156 @@
1
+ # DynamoDB encryption: choose who controls the key
2
+
3
+ Encryption at rest is always on. Distinguish three choices; “AWS does the
4
+ encryption” does not identify which one is configured. LSI/GSI data uses the table
5
+ key—there is no separate index-encryption option. This does not replace workload
6
+ authorization, TLS, data minimization or application/client-side encryption needs.
7
+
8
+ ## Decision matrix
9
+
10
+ | Choice | Ownership/control | When it fits | Cost/lifecycle tradeoff |
11
+ |---|---|---|---|
12
+ | AWS-owned key (default) | DynamoDB owns it in its service account; no customer key policy/lifecycle | Standard service encryption without a customer KMS-control requirement | No additional encryption charge; no customer key inventory/control |
13
+ | AWS-managed KMS key `alias/aws/dynamodb` | In your account; AWS controls policy/lifecycle/rotation; you can inspect policy/use in CloudTrail | Need account-visible service KMS key and auditability, not custom policy/control | KMS usage charges/quotas apply; do not claim this is the free default |
14
+ | Customer-managed KMS key | Your existing symmetric encryption key; you own policy, grants, rotation and availability | A concrete customer key-policy, separation-of-duties or lifecycle requirement | KMS charges and operational duties; revocation, disablement or deletion can break access/recovery |
15
+
16
+ Default to the simplest choice satisfying the stated requirement—not a blanket
17
+ “CMKs are always more secure” or compliance certification. A CMK creates a new
18
+ availability dependency. Record data sensitivity, required control/audit evidence,
19
+ key owner, allowed principals/services, rotation, restore and incident ownership.
20
+ Refresh Region-specific KMS pricing before estimating costs; a KMS operation is
21
+ not performed for every DynamoDB item access because table keys are cached.
22
+
23
+ ## CloudFormation (choose one Properties fragment)
24
+
25
+ The shipped [table.cfn.yaml](../assets/table.cfn.yaml) deliberately omits
26
+ SSESpecification and therefore uses the **AWS-owned** key. Omission is not a
27
+ claim of unencrypted storage. For an explicit AWS-owned selection:
28
+
29
+ ```yaml
30
+ SSESpecification:
31
+ SSEEnabled: false
32
+ ```
33
+
34
+ For the AWS-managed DynamoDB KMS key, omit KMSMasterKeyId:
35
+
36
+ ```yaml
37
+ SSESpecification:
38
+ SSEEnabled: true
39
+ SSEType: KMS
40
+ ```
41
+
42
+ For a customer-managed key, first add this template-level parameter (not inside
43
+ the table's Properties). Supply the reviewed, existing key's ARN at deployment:
44
+
45
+ ```yaml
46
+ Parameters:
47
+ KmsKeyArn:
48
+ Type: String
49
+ Description: Existing approved symmetric KMS encryption key ARN in the table Region
50
+ ```
51
+
52
+ Then use this table Properties fragment:
53
+
54
+ ```yaml
55
+ SSESpecification:
56
+ SSEEnabled: true
57
+ SSEType: KMS
58
+ KMSMasterKeyId: !Ref KmsKeyArn
59
+ ```
60
+
61
+ These are mutually exclusive fragments, not standalone templates or permission
62
+ to update a stack. Use a reviewed change set; do not change the default asset or
63
+ create a key/policy as an incidental prerequisite. An alias is resolved when set;
64
+ retargeting that alias later does **not** switch the table's encryption key.
65
+
66
+ ## AWS CLI v2 equivalents (billable mutations; choose one)
67
+
68
+ Use the command cookbook's target/approval rules. Each create is an **alternative
69
+ for a new table**, not three sequential creates with the same name. The base
70
+ asset is unchanged; explicit CLI parameters select the encryption variant.
71
+
72
+ ```bash
73
+ set -euo pipefail
74
+ : "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${TABLE_NAME:?}"
75
+ aws_target=(aws --profile "$AWS_PROFILE" --region "$AWS_REGION" --no-cli-pager --output json)
76
+ # AWS-owned: no SSE override; encryption remains on.
77
+ "${aws_target[@]}" dynamodb create-table --table-name "$TABLE_NAME" \
78
+ --cli-input-json file://assets/create-table.json
79
+ ```
80
+
81
+ ```bash
82
+ # AWS-managed alias/aws/dynamodb, not customer-managed.
83
+ "${aws_target[@]}" dynamodb create-table --table-name "$TABLE_NAME" \
84
+ --cli-input-json file://assets/create-table.json \
85
+ --sse-specification Enabled=true,SSEType=KMS
86
+ ```
87
+
88
+ ```bash
89
+ : "${KMS_KEY_ARN:?Select the approved existing customer-managed key ARN}"
90
+ "${aws_target[@]}" dynamodb create-table --table-name "$TABLE_NAME" \
91
+ --cli-input-json file://assets/create-table.json \
92
+ --sse-specification "Enabled=true,SSEType=KMS,KMSMasterKeyId=$KMS_KEY_ARN"
93
+ ```
94
+
95
+ Wait for table creation and configure/read back TTL/PITR as in Provisioning. For a
96
+ **CLI-owned existing table**, after separately approved key-transition review, use
97
+ one of these alternatives. Keep CloudFormation-owned tables in CloudFormation.
98
+
99
+ ```bash
100
+ # Switch to the AWS-managed key.
101
+ "${aws_target[@]}" dynamodb update-table --table-name "$TABLE_NAME" \
102
+ --sse-specification Enabled=true,SSEType=KMS
103
+ ```
104
+
105
+ ```bash
106
+ # Switch to the reviewed customer-managed key.
107
+ : "${KMS_KEY_ARN:?}"
108
+ "${aws_target[@]}" dynamodb update-table --table-name "$TABLE_NAME" \
109
+ --sse-specification "Enabled=true,SSEType=KMS,KMSMasterKeyId=$KMS_KEY_ARN"
110
+ ```
111
+
112
+ Switching to AWS-owned is also possible with `Enabled=false`; it changes key
113
+ ownership, **not** encryption to plaintext. Require the same approval/policy review
114
+ before weakening a required customer-controlled-key posture.
115
+
116
+ ## Inspect actual key identity and transition completion (authorized metadata reads)
117
+
118
+ ```bash
119
+ "${aws_target[@]}" dynamodb describe-table --table-name "$TABLE_NAME" \
120
+ --query 'Table.{State:TableStatus,SSE:SSEDescription}'
121
+ "${aws_target[@]}" kms describe-key --key-id "$KMS_KEY_ARN" \
122
+ --query 'KeyMetadata.{Arn:Arn,Manager:KeyManager,State:KeyState,Usage:KeyUsage,Spec:KeySpec}'
123
+ ```
124
+
125
+ For AWS-managed, inspect `alias/aws/dynamodb`/the resolved table key ARN instead;
126
+ that alias may not exist until first use. For customer-managed, compare the table's
127
+ resolved KMSMasterKeyArn to the approved ARN and verify KeyManager=CUSTOMER,
128
+ KeyState=Enabled, KeyUsage=ENCRYPT_DECRYPT and a symmetric encryption KeySpec.
129
+ `SSEType=KMS` by itself does not distinguish AWS-managed from customer-managed.
130
+ Absent SSEDescription can be the AWS-owned default, not missing encryption.
131
+ For a KMS transition, require SSEDescription.Status=ENABLED with the expected new
132
+ ARN; do not infer completion from an update response/table waiter alone.
133
+
134
+ ## Permissions, recovery and non-negotiable stops
135
+
136
+ - Verify Region/key compatibility and effective caller IAM **plus** key policy and
137
+ grants authorizing DynamoDB on the caller's behalf. A table-only IAM permission
138
+ is not proof of usable KMS access. Follow AWS's policy/grant conditions (including
139
+ service/account scope), not a blanket wildcard `kms:*` grant or new access key.
140
+ - Preserve original key access through transition, and beyond it for any dependent
141
+ old on-demand backups: they retain their original key and require it for restore.
142
+ Inventory those dependencies and actually test restore before retiring a key.
143
+ - Automatic rotation of the **same** KMS key is not switching to a different key
144
+ ARN; neither alias retargeting nor table switching migrates old backups.
145
+ - Disabling/deleting a customer key or removing required policy/grants can block
146
+ table access. A deleted key can make dependent data/backups irrecoverable. Do
147
+ not provide or run disable/schedule-deletion cleanup as part of this workflow.
148
+ - Verify Global Tables version/replica key settings, Streams, DAX, exports/backups
149
+ and monitoring separately; “table uses my CMK” is not end-to-end encryption proof
150
+ for every adjunct service. DAX does not support a customer-managed key for its
151
+ cluster encryption. SDK Get/Put/Query shapes do not change for server-side KMS.
152
+
153
+ Sources: [encryption choices/cost](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/EncryptionAtRest.html),
154
+ [CLI key selection](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/encryption.tutorial.html),
155
+ [key usage, policies and backup dependencies](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/encryption.usagenotes.html),
156
+ [CloudFormation SSE specification](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-dynamodb-table-ssespecification.html).
@@ -0,0 +1,116 @@
1
+ # Evidence index
2
+
3
+ This index maps the rows of [the evidence ledger](evidence-ledger.md) to the skill
4
+ files they support, and lists every claim that is unconfirmed or conflicting.
5
+
6
+ ## Verification summary
7
+
8
+ Each claim was checked against the AWS page it cites, or the closest official page,
9
+ on 2026-11-08. A mechanical re-check then confirmed that the quoted sentence appears on
10
+ the cited page for every VERIFIED row whose page could be fetched as text. One claim
11
+ was contradicted and fixed (DAX .NET client). UNVERIFIED rows are listed below; treat
12
+ those statements as unconfirmed until re-checked.
13
+
14
+ ## Evidence by topic
15
+
16
+ ### Modeling, indexes, runtime contract, design and refactor
17
+
18
+ Covers modeling.md, lsi-vs-gsi.md, runtime-contract.md, workflow.md, commands/design.md, commands/refactor.md.
19
+
20
+ [DP-E101] [DP-E102] [DP-E103] [DP-E104] [DP-E105] [DP-E106] [DP-E107] [DP-E108]
21
+ [DP-E109] [DP-E110] [DP-E111] [DP-E112] [DP-E113] [DP-E114] [DP-E115] [DP-E116]
22
+ [DP-E117] [DP-E118] [DP-E119] [DP-E120] [DP-E121] [DP-E122] [DP-E123] [DP-E124]
23
+ [DP-E125] [DP-E126] [DP-E127] [DP-E128] [DP-E129] [DP-E130] [DP-E131] [DP-E132]
24
+ [DP-E133] [DP-E134] [DP-E135] [DP-E136] [DP-E137] [DP-E138] [DP-E139] [DP-E140]
25
+ [DP-E141] [DP-E142] [DP-E143] [DP-E144] [DP-E145] [DP-E146] [DP-E147] [DP-E148]
26
+ [DP-E149] [DP-E150] [DP-E151] [DP-E152] [DP-E153] [DP-E154] [DP-E155] [DP-E156]
27
+ [DP-E157] [DP-E158] [DP-E159] [DP-E160]
28
+
29
+ ### Data types, native vectors and embeddings
30
+
31
+ Covers data-types-and-vectors.md, embedding-integrations.md, commands/embedding.md and the vector assets.
32
+
33
+ [DP-E201] [DP-E202] [DP-E203] [DP-E204] [DP-E205] [DP-E206] [DP-E207] [DP-E208]
34
+ [DP-E209] [DP-E210] [DP-E211] [DP-E212] [DP-E213] [DP-E214] [DP-E215] [DP-E216]
35
+ [DP-E217] [DP-E218] [DP-E219] [DP-E220] [DP-E221] [DP-E222] [DP-E223] [DP-E224]
36
+ [DP-E225] [DP-E226] [DP-E227] [DP-E228] [DP-E229] [DP-E230] [DP-E231] [DP-E232]
37
+ [DP-E233] [DP-E234] [DP-E235] [DP-E236] [DP-E237] [DP-E238] [DP-E239] [DP-E240]
38
+ [DP-E241] [DP-E242] [DP-E243] [DP-E244] [DP-E245] [DP-E246] [DP-E248] [DP-E249]
39
+ [DP-E250] [DP-E251] [DP-E252] [DP-E253] [DP-E254] [DP-E255] [DP-E256]
40
+
41
+ ### IAM, encryption, provisioning and CLI
42
+
43
+ Covers iam-and-access.md, encryption.md, provisioning.md, commands/aws-cli.md and the policy, CloudFormation and CLI assets.
44
+
45
+ [DP-E301] [DP-E302] [DP-E303] [DP-E304] [DP-E305] [DP-E306] [DP-E307] [DP-E308]
46
+ [DP-E309] [DP-E310] [DP-E311] [DP-E312] [DP-E313] [DP-E314] [DP-E315] [DP-E316]
47
+ [DP-E317] [DP-E318] [DP-E319] [DP-E320] [DP-E321] [DP-E322] [DP-E323] [DP-E324]
48
+ [DP-E325] [DP-E326] [DP-E327] [DP-E328] [DP-E329] [DP-E330] [DP-E331] [DP-E332]
49
+ [DP-E333] [DP-E334] [DP-E335] [DP-E336] [DP-E337] [DP-E338] [DP-E339] [DP-E340]
50
+ [DP-E341] [DP-E342] [DP-E343] [DP-E344] [DP-E345] [DP-E346] [DP-E347] [DP-E348]
51
+ [DP-E349] [DP-E350] [DP-E351] [DP-E353] [DP-E354] [DP-E355] [DP-E356] [DP-E357]
52
+ [DP-E358] [DP-E359] [DP-E360] [DP-E361] [DP-E362] [DP-E363] [DP-E364] [DP-E365]
53
+ [DP-E366] [DP-E367] [DP-E368] [DP-E369] [DP-E370] [DP-E371] [DP-E372] [DP-E373]
54
+
55
+ ### Backup, restore, replicas, Streams and DAX
56
+
57
+ Covers recovery-and-replicas.md, streams-and-dax.md, commands/backup*, commands/restore*, commands/recovery-target.md.
58
+
59
+ [DP-E401] [DP-E402] [DP-E403] [DP-E404] [DP-E405] [DP-E406] [DP-E407] [DP-E408]
60
+ [DP-E409] [DP-E410] [DP-E411] [DP-E412] [DP-E413] [DP-E414] [DP-E415] [DP-E416]
61
+ [DP-E417] [DP-E418] [DP-E419] [DP-E420] [DP-E421] [DP-E422] [DP-E423] [DP-E424]
62
+ [DP-E425] [DP-E426] [DP-E427] [DP-E428] [DP-E429] [DP-E430] [DP-E431] [DP-E432]
63
+ [DP-E433] [DP-E434] [DP-E435] [DP-E436] [DP-E437] [DP-E438] [DP-E439] [DP-E440]
64
+ [DP-E441] [DP-E442] [DP-E443] [DP-E444] [DP-E445] [DP-E446] [DP-E447] [DP-E448]
65
+ [DP-E449] [DP-E450] [DP-E451] [DP-E452] [DP-E453] [DP-E454] [DP-E455] [DP-E456]
66
+ [DP-E457] [DP-E458]
67
+
68
+ ### Monitoring, SDK adapters, audit and performance tests
69
+
70
+ Covers monitoring.md, language-adapters.md, commands/performance-test.md, commands/audit*, commands/feature-plan.md, commands/select.md and the SDK assets.
71
+
72
+ [DP-E501] [DP-E502] [DP-E503] [DP-E504] [DP-E505] [DP-E506] [DP-E507] [DP-E508]
73
+ [DP-E509] [DP-E510] [DP-E511] [DP-E512] [DP-E513] [DP-E514] [DP-E515] [DP-E516]
74
+ [DP-E517] [DP-E518] [DP-E519] [DP-E520] [DP-E521] [DP-E522] [DP-E523] [DP-E524]
75
+ [DP-E525] [DP-E526] [DP-E527] [DP-E528] [DP-E544] [DP-E545] [DP-E546] [DP-E547]
76
+ [DP-E530] [DP-E531] [DP-E532] [DP-E533] [DP-E534] [DP-E535] [DP-E536] [DP-E537]
77
+ [DP-E538] [DP-E539] [DP-E540] [DP-E541] [DP-E542] [DP-E543]
78
+
79
+ ## Unconfirmed and conflicting claims
80
+
81
+ | Evidence | Status | Claim |
82
+ | --- | --- | --- |
83
+ | [DP-E112] | UNVERIFIED | "base table must have a sort key" for an LSI (lsi-vs-gsi.md:30 (second half)) |
84
+ | [DP-E125] | CONFLICT | LSI cannot be added to an existing table (CFN update of LocalSecondaryIndexes) (lsi-vs-gsi.md:33,164,214 vs CFN property docs) |
85
+ | [DP-E133] | UNVERIFIED | AWS CLI --starting-token/NextToken are not interchangeable with service ExclusiveStartKey/LastEvaluatedKey (runtime-contract.md:33-34) |
86
+ | [DP-E150] | UNVERIFIED | Base-table key schema changes cannot be done in place via UpdateTable (need new table/migration) (runtime-contract.md:110; refactor.md:29) |
87
+ | [DP-E153] | UNVERIFIED | Vector index SearchSchema is separate from generic AttributeDefinitions; vector indexes use SearchSchema (design.md:35-38; workflow.md:62) |
88
+ | [DP-E158] | UNVERIFIED | Key attributes cannot be changed by an UpdateExpression; moving a primary-key value needs a new item (refactor.md:32-34) |
89
+ | [DP-E204] | UNVERIFIED | Key scalar types are S/N/B (not L/M/sets) (D:23) |
90
+ | [DP-E253] | UNVERIFIED | PutVectors can overwrite an existing key (C:330-333) |
91
+ | [DP-E313] | UNVERIFIED | CLI (inspected 2.37.4) has no `dynamodb get-abac-status`; IAM action name is not evidence a CLI op exists (iam-and-access.md:114-117). Note: absence consistent with claim; version-specific |
92
+ | [DP-E320] | UNVERIFIED | Tag on create uses CreateTable `--tags`; CreateTable with tags needs TagResource permission (iam-and-access.md:102-103). Note: flag exists; permission requirement not located |
93
+ | [DP-E322] | UNVERIFIED | `aws:ResourceTag`, `aws:RequestTag`, `aws:TagKeys` support varies by action/resource (iam-and-access.md:110-111). Note: SAR page is JavaScript-rendered; condition keys not readable in this pass |
94
+ | [DP-E345] | UNVERIFIED | AWS-managed key `alias/aws/dynamodb` may not exist until first use (encryption.md:125) |
95
+ | [DP-E348] | UNVERIFIED | Auto rotation of same KMS key is not switching ARN (encryption.md:143-145). Note: partially supported |
96
+ | [DP-E355] | UNVERIFIED | `DeletionPolicy: Retain` / `UpdateReplacePolicy: Retain` keep resources (provisioning.md:64). Note: not fetched |
97
+ | [DP-E361] | UNVERIFIED | TTL may report ENABLING before ENABLED (provisioning.md:97-98; aws-cli.md:306). Note: not fetched |
98
+ | [DP-E367] | UNVERIFIED | put-item `--condition-expression`; update-item with `SET ... REMOVE`; `--expression-attribute-names/values` (aws-cli.md:131-137 (file 241-247)). Note: not fetched |
99
+ | [DP-E368] | UNVERIFIED | `create-table` alt with LSI asset, then `wait table-exists` (aws-cli.md:157-164 (file 267-275)). Note: not fetched |
100
+ | [DP-E371] | UNVERIFIED | TTL is delayed cleanup, not an exact expiry (aws-cli.md:195-200 (file 305-310)). Note: not fetched |
101
+ | [DP-E372] | UNVERIFIED | CLI flags `--cli-input-json file://`, `describe-time-to-live`, `describe-continuous-backups`, existing name yields ResourceInUseException (create-table.sh:15,26-37). Note: cited page is PutResourcePolicy errors, not CreateTable/CLI; flags not confirmed |
102
+ | [DP-E409] | UNVERIFIED | Timestamp and latest flags are mutually exclusive (restore/pitr.md:32,38). Note: no sentence found that says combining is rejected; searched Tutorial and API_RestoreTableToPointInTime |
103
+ | [DP-E412] | UNVERIFIED | Restored table is independent, incl. from a global-table replica; replica topology is not restored (recovery-and-replicas.md:52-54; restore.md:67). Note: searched pointintimerecovery_restores, PointInTimeRecovery.Tutorial, Howitworks, API_RestoreTableToPointInTime, API_RestoreTableFromBackup |
104
+ | [DP-E418] | UNVERIFIED | Native on-demand backup does not require PITR to be enabled (backup.md:21-22). Note: searched CreateBackup, Restore.Tutorial |
105
+ | [DP-E444] | UNVERIFIED | Iterator types TRIM_HORIZON oldest / LATEST newest; dynamodbstreams CLI flags (streams-and-dax.md:50-51 (TRIM_HORIZON/LATEST), 52-55 (CLI get-shard-iterator, describe-stream --limit/--no-paginate, get-records --limit)). Note: CLI examples page not fetched; only API-level wording found |
106
+ | [DP-E445] | UNVERIFIED | IAM actions are dynamodb:DescribeStream/GetShardIterator/GetRecords on stream ARN; ListStreams has no resource-level scope; UpdateTable enables streams (streams-and-dax.md:67-69). Note: API action names confirmed, but IAM action names/resource types not: Service Authorization Reference pages are JS-rendered and returned no text; iam-policy-example-data-stream pages returned empty |
107
+ | [DP-E446] | UNVERIFIED | Mapping setup needs lambda:CreateEventSourceMapping; iam:PassRole only for creating/changing the function execution role (streams-and-dax.md:74-77). Note: lambda-api-permissions-ref and with-ddb fetched; no PassRole / CreateEventSourceMapping text extracted |
108
+ | [DP-E451] | UNVERIFIED | A GSI cannot become strongly consistent through DAX (streams-and-dax.md:105-106) |
109
+ | [DP-E457] | UNVERIFIED | Setup needs dax:CreateCluster and iam:PassRole on the exact role (streams-and-dax.md:143-144). Note: SAR pages JS-rendered |
110
+ | [DP-E510] | UNVERIFIED | ReplicationLatency is "queried in source Region" (references/monitoring.md:69) |
111
+ | [DP-E519] | CONFLICT | Primary sources disagree: user guide says AWS/DynamoDB default is ignore with override; PutMetricAlarm API reference says always ignore (references/monitoring.md:113-121) |
112
+ | [DP-E521] | UNVERIFIED | cloudwatch:ListMetrics/GetMetricStatistics/GetMetricData lack table-level ARN scoping (use Resource *) (references/monitoring.md:123-125) |
113
+ | [DP-E522] | UNVERIFIED | PutMetricAlarm/DescribeAlarms use alarm resources (references/monitoring.md:126-127) |
114
+ | [DP-E523] | UNVERIFIED | Contributor Insights is opt-in (enabled per table or GSI) and has a cost impact; the page does not state that it exposes key values (monitoring.md:62-63; commands/performance-test.md:56) |
115
+ | [DP-E546] | UNVERIFIED | Rust builder methods `.consistent_read`, `.scan_index_forward`, `.limit`, `.set_exclusive_start_key`, `last_evaluated_key` (references/language-adapters.md:176-177) |
116
+ | [DP-E547] | UNVERIFIED | Java 2.x `software.amazon.awssdk:dynamodb`, `QueryRequest.builder()...exclusiveStartKey`, `queryPaginator`, `legacy com.amazonaws.services.dynamodbv2`; PHP `Aws\DynamoDb\DynamoDbClient`, `Marshaler` (references/language-adapters.md:91-120,188-213) |