@raishin/vanguard-frontier-agentic 3.18.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +8 -1
- package/.cursor-plugin/plugin.json +8 -1
- package/.github/plugin/marketplace.json +1 -1
- package/README.md +21 -21
- package/agents/AGENTS.md +4 -4
- package/agents/README.md +7 -7
- package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
- package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
- package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
- package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
- package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
- package/catalog/agents.json +204 -1
- package/catalog/asset-integrity.json +620 -75
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +2074 -527
- package/catalog/skills.json +314 -14
- package/package.json +8 -2
- package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
- package/powers/vanguard-alibaba/POWER.md +1 -1
- package/powers/vanguard-aws/POWER.md +1 -1
- package/powers/vanguard-azure/POWER.md +1 -1
- package/powers/vanguard-gcp/POWER.md +1 -1
- package/powers/vanguard-huawei/POWER.md +1 -1
- package/powers/vanguard-oci/POWER.md +1 -1
- package/rules/codex/cloud-provenance-rule.md +1 -1
- package/scripts/generate-kiro-powers.mjs +2 -2
- package/skills/alibaba/README.md +2 -1
- package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
- package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
- package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
- package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
- package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
- package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
- package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
- package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
- package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
- package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
- package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
- package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
- package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
- package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
- package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
- package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
- package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
- package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
- package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
- package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
- package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
- package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
- package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
- package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
- package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
- package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
- package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
- package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
- package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
- package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
- package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
- package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
- package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
- package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
- package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
- package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
- package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
- package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
- package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
- package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
- package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
- package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
- package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-maestro/SKILL.md +1 -1
- package/skills/aws/aws-maestro/metadata.json +1 -1
- package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
- package/skills/azure/azure-ai-foundry-ops-governor/SKILL.md +2 -2
- package/skills/azure/azure-aks-platform-operator/SKILL.md +1 -1
- package/skills/azure/azure-app-service-production-readiness/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +5 -3
- package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
- package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
- package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
- package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
- package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
- package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
- package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
- package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
- package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
- package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
- package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
- package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
- package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
- package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
- package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
- package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
- package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
- package/skills/azure/azure-cosmosdb-performance-investigator/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +7 -3
- package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
- package/skills/azure/azure-cost-estimation-review/SKILL.md +1 -1
- package/skills/azure/azure-cost-optimization-governor/SKILL.md +1 -1
- package/skills/azure/azure-entra-id-specialist/SKILL.md +1 -1
- package/skills/azure/azure-governance-policy-guardrails/SKILL.md +1 -1
- package/skills/azure/azure-identity-governance-review/SKILL.md +1 -1
- package/skills/azure/azure-key-vault-secret-lifecycle-auditor/SKILL.md +1 -1
- package/skills/azure/azure-landing-zone-architect/SKILL.md +1 -1
- package/skills/azure/azure-maestro/SKILL.md +2 -1
- package/skills/azure/azure-migrate-landing-zone-cutover/SKILL.md +1 -1
- package/skills/azure/azure-network-topology-review/SKILL.md +1 -1
- package/skills/azure/azure-observability-investigator/SKILL.md +1 -1
- package/skills/azure/azure-platform-automation-devops/SKILL.md +1 -1
- package/skills/azure/azure-private-endpoint-adoption-planner/SKILL.md +1 -1
- package/skills/azure/azure-rbac-review/SKILL.md +1 -1
- package/skills/azure/azure-resilience-bcdr-review/SKILL.md +1 -1
- package/skills/azure/azure-resource-health-incident-triage/SKILL.md +1 -1
- package/skills/azure/azure-role-selector/SKILL.md +1 -1
- package/skills/azure/azure-security-posture-hardening/SKILL.md +1 -1
- package/skills/azure/azure-subscription-resource-organization/SKILL.md +1 -1
- package/skills/azure/azure-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-reliability-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-security-review/SKILL.md +1 -1
- package/skills/contabo/contabo-security-hardening/SKILL.md +1 -1
- package/skills/cross-functional/agentic-board-protocol/SKILL.md +1 -1
- package/skills/cross-functional/copilot-data-readiness-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-case-capsule/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-data-exposure-escalation-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-live-change-approval-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-risk-taxonomy/SKILL.md +1 -1
- package/skills/databricks/databricks-lakehouse-engineering-at-azure/SKILL.md +1 -1
- package/skills/databricks/databricks-unity-catalog-governance-at-azure/SKILL.md +1 -1
- package/skills/dotnet/dotnet-performance-aot-review/SKILL.md +1 -1
- package/skills/frontend/vue-router-navigation-security-review/SKILL.md +1 -1
- package/skills/gcp/README.md +2 -1
- package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
- package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
- package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
- package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
- package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
- package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
- package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
- package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
- package/skills/gcp/gcp-maestro/SKILL.md +2 -1
- package/skills/huawei/README.md +2 -1
- package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
- package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
- package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
- package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
- package/skills/huawei/huawei-maestro/SKILL.md +2 -1
- package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
- package/skills/java/java-application-server-exit/SKILL.md +1 -1
- package/skills/java/java-jvm-performance-and-gc/SKILL.md +1 -1
- package/skills/java/java-resilience-pattern/SKILL.md +1 -1
- package/skills/java/java-test-architecture/SKILL.md +1 -1
- package/skills/java/java-transaction-and-consistency/SKILL.md +1 -1
- package/skills/kubernetes/kubernetes-rbac-review/SKILL.md +1 -1
- package/skills/marketing/analytics-data-minimization-review/SKILL.md +1 -1
- package/skills/microsoft/d365-customer-insights-journeys/SKILL.md +1 -1
- package/skills/microsoft/fabric-analytics-engineering/SKILL.md +1 -1
- package/skills/microsoft/m365-defender-xdr-security-operations/SKILL.md +1 -1
- package/skills/microsoft/m365-purview-data-security-compliance/SKILL.md +1 -1
- package/skills/oci/README.md +6 -1
- package/skills/oci/oci-autonomous-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-certificates-issuer-review/SKILL.md +1 -1
- package/skills/oci/oci-cloud-guard-responder/SKILL.md +1 -1
- package/skills/oci/oci-compute-instance-agent-operator/SKILL.md +1 -1
- package/skills/oci/oci-compute-platform-operator/SKILL.md +1 -1
- package/skills/oci/oci-cost-finops-analyst/SKILL.md +1 -1
- package/skills/oci/oci-database-platform-dba/SKILL.md +1 -1
- package/skills/oci/oci-dbtools-sql-analyst/SKILL.md +1 -1
- package/skills/oci/oci-devops-container-platform-engineer/SKILL.md +1 -1
- package/skills/oci/oci-exadata-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-exadata-platform-architect/SKILL.md +1 -1
- package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md +1 -1
- package/skills/oci/oci-goldengate-replication-operator/SKILL.md +1 -1
- package/skills/oci/oci-identity-access-governor/SKILL.md +1 -1
- package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md +1 -1
- package/skills/oci/oci-limits-capacity-planner/SKILL.md +1 -1
- package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-network-security-rule-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-oke-rollout-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-resource-manager-stack-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-vault-key-destruction-guard/SKILL.md +1 -1
- package/skills/oci/oci-load-balancer-traffic-engineer/SKILL.md +1 -1
- package/skills/oci/oci-maestro/SKILL.md +1 -1
- package/skills/oci/oci-migration-cutover-architect/SKILL.md +1 -1
- package/skills/oci/oci-multi-cloud-architect/SKILL.md +1 -1
- package/skills/oci/oci-mysql-heatwave-ai-specialist/SKILL.md +1 -1
- package/skills/oci/oci-network-architect/SKILL.md +1 -1
- package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
- package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
- package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
- package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
- package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
- package/skills/oci/oci-nosql-pattern/README.md +81 -0
- package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
- package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
- package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
- package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
- package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
- package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
- package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
- package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
- package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
- package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
- package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
- package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
- package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
- package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
- package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
- package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
- package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
- package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
- package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
- package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
- package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
- package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
- package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
- package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
- package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
- package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
- package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
- package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
- package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
- package/skills/oci/oci-observability-incident-responder/SKILL.md +1 -1
- package/skills/oci/oci-recovery-service-operator/SKILL.md +1 -1
- package/skills/oci/oci-registry-artifact-governor/SKILL.md +1 -1
- package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md +1 -1
- package/skills/oci/oci-security-compliance-reviewer/SKILL.md +1 -1
- package/skills/oci/oci-solution-architect/SKILL.md +1 -1
- package/skills/oci/oci-storage-backup-steward/SKILL.md +1 -1
- package/skills/oci/oci-support-incident-coordinator/SKILL.md +1 -1
- package/skills/oci/oci-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-reliability-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-security-review/SKILL.md +1 -1
- package/skills/oci/oracle-oci-mcp-grounded-advisor/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-cost-finops-analyst/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-live-kms-key-destruction-guard/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/salesforce/salesforce-agentforce-risk-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-apex-lwc-code-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-devsecops-pipeline-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-flow-automation-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-infrastructure-audit-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-integration-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-marketing-consent-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-metadata-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-org-assessment-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-permission-model-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-release-readiness-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-zero-trust-maturity-skill/SKILL.md +1 -1
- package/skills/sap/sap-analytics-cloud-planning-governance/SKILL.md +1 -1
- package/skills/sap/sap-btp-governance-review/SKILL.md +1 -1
- package/skills/sap/sap-cloud-alm-sre-incident-review/SKILL.md +1 -1
- package/skills/sap/sap-datasphere-data-product-architecture/SKILL.md +1 -1
- package/skills/sap/sap-ewm-tm-logistics-execution-review/SKILL.md +1 -1
- package/skills/sap/sap-finance-fico-controls-review/SKILL.md +1 -1
- package/skills/sap/sap-hana-cloud-performance-cost/SKILL.md +1 -1
- package/skills/sap/sap-hypercare-incident-commander-review/SKILL.md +1 -1
- package/skills/sap/sap-integration-suite-review/SKILL.md +1 -1
- package/skills/sap/sap-joule-governance-adoption-review/SKILL.md +1 -1
- package/skills/sap/sap-license-btp-consumption-finops-review/SKILL.md +1 -1
- package/skills/sap/sap-manufacturing-execution-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-mdg-master-data-quality-review/SKILL.md +1 -1
- package/skills/sap/sap-order-to-cash-review/SKILL.md +1 -1
- package/skills/sap/sap-procurement-ariba-value-leakage-review/SKILL.md +1 -1
- package/skills/sap/sap-release-change-collision-review/SKILL.md +1 -1
- package/skills/sap/sap-rise-sla-vendor-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-security-iam-grc-sod-review/SKILL.md +1 -1
- package/skills/sap/sap-signavio-process-mining-value/SKILL.md +1 -1
- package/skills/sap/sap-successfactors-hr-process-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-supply-chain-ibp-resilience-review/SKILL.md +1 -1
- package/skills/sap/sap-testing-quality-gate-review/SKILL.md +1 -1
- package/skills/sap/sap-transformation-portfolio-triage-review/SKILL.md +1 -1
- package/skills/sap/sap-treasury-cash-risk-review/SKILL.md +1 -1
- package/skills/scaleway/scaleway-kapsule-platform-operator/SKILL.md +1 -1
- package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/scaleway/scaleway-network-architect/SKILL.md +1 -1
- package/templates/nosql-audit-template.md +127 -0
- package/templates/nosql-operations-template.md +60 -0
- package/tests/_generate_maestro_routing_fixtures.py +11 -0
- package/tests/fixtures/README.md +2 -2
- package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
- package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
- package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
- package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
- package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
- package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
- package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
- package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
- package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
- package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
- package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
- package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
- package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
- package/tests/requirements-ci.txt +8 -0
- package/tests/test-marketplace-validators.py +7 -1
- package/tests/validate-agent-frontmatter-schema.py +7 -1
- package/tests/validate-aws-skill-quality.py +7 -0
- package/tests/validate-kiro-powers.py +8 -1
- package/tests/validate-nosql-audit.py +741 -0
- package/tests/validate-nosql-operations.py +136 -0
- package/tests/validate-nosql-pattern-evals.py +96 -0
- package/tests/validate-nosql-scenarios.py +94 -0
- package/tests/validate-skill-frontmatter-schema.py +7 -1
- package/tests/validate-skill-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
- package/tests/validate-skill-yaml-strict.py +84 -0
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
# Modeling from access patterns
|
|
2
|
+
|
|
3
|
+
## Decide what not to build
|
|
4
|
+
|
|
5
|
+
Start with known application operations, not an entity diagram translated one
|
|
6
|
+
table per SQL table and not a compulsory single-table conversion. Compare:
|
|
7
|
+
|
|
8
|
+
| Option | Good fit | Price paid |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| Simple key/value or one entity/table | Direct key access, distinct ownership/lifecycle | More requests for aggregate reads |
|
|
11
|
+
| Single-table, multiple item types | Stable aggregate queries and bounded relationships | Key discipline, denormalization, coupled migration/tooling |
|
|
12
|
+
| Multiple DynamoDB tables | Different access/lifecycle/security needs | Application composition; transactions still have service boundaries |
|
|
13
|
+
| Relational/search/analytics adjunct | Arbitrary joins, text search, broad reporting | Additional store/sync/freshness and operational cost |
|
|
14
|
+
|
|
15
|
+
No option earns a cost or latency claim without item-size, request and skew data.
|
|
16
|
+
Tables do not enforce a schema for non-key attributes. Application schema/version
|
|
17
|
+
validation is still necessary in every SDK or wrapper.
|
|
18
|
+
|
|
19
|
+
## Worked model: customer orders and a tenant's open-order queue
|
|
20
|
+
|
|
21
|
+
Assumptions: moderate per-customer/per-tenant peaks, immutable creation time,
|
|
22
|
+
tenant-local operations, eventual queue visibility acceptable. These are examples,
|
|
23
|
+
not measured sizing. Delimiter-containing IDs must be encoded or rejected
|
|
24
|
+
consistently; normalize timestamps to fixed-width UTC for lexical ordering.
|
|
25
|
+
|
|
26
|
+
| Item | PK | SK | GSI1PK | GSI1SK |
|
|
27
|
+
|---|---|---|---|---|
|
|
28
|
+
| Customer profile | `TENANT#acme#CUSTOMER#c42` | `PROFILE` | absent | absent |
|
|
29
|
+
| Open order | `TENANT#acme#CUSTOMER#c42` | `ORDER#2026-01-02T10:00:00.000Z#o100` | `TENANT#acme#STATUS#OPEN` | `2026-01-02T10:00:00.000Z#o100` |
|
|
30
|
+
| Closed order | Same customer PK | Same immutable order SK | absent | absent |
|
|
31
|
+
|
|
32
|
+
Order attributes: `entityType=Order`, `orderId=o100`, `customerId=c42`,
|
|
33
|
+
`status=OPEN`, `version=1`, `totalMinor=1250`, `currency=USD`.
|
|
34
|
+
Represent money in explicitly bounded integer minor units or exact decimals;
|
|
35
|
+
define scale/currency. Optional `expiresAt` is epoch seconds for disposable records,
|
|
36
|
+
not a default retention policy for financial orders. Do not expire orders casually.
|
|
37
|
+
|
|
38
|
+
### Access paths and actual requests
|
|
39
|
+
|
|
40
|
+
- **Customer profile**: `GetItem(PK, SK=PROFILE)`; strong read optional.
|
|
41
|
+
- **List orders**: `Query(PK = :customer AND begins_with(SK, :orderPrefix))`,
|
|
42
|
+
`:orderPrefix=ORDER#`, descending, `Limit=50`, cursor; strong read optional.
|
|
43
|
+
- **Known order key**: `GetItem(PK, complete immutable order SK)`.
|
|
44
|
+
- **Open queue**: `Query(IndexName=GSI1, GSI1PK=:tenantOpen)`, descending,
|
|
45
|
+
`Limit=50`; no strong reads. The asset projects keys plus `status`, `orderId`,
|
|
46
|
+
`totalMinor`, `currency`; fetch the base item if more fields or current state are
|
|
47
|
+
required. GSI membership can lag even if subsequent base gets are strong.
|
|
48
|
+
- **Order ID only**: unsupported by this layout. Supply customer+creation key,
|
|
49
|
+
introduce a conditional locator item keyed by tenant+order ID, or redesign.
|
|
50
|
+
A locator and order requiring atomic creation may use a transaction. Account for
|
|
51
|
+
its extra item/write/read, Region scope and idempotency.
|
|
52
|
+
- **Monthly totals/search across all customers**: not a free query. Define a
|
|
53
|
+
bounded materialized aggregate or export/search/analytics pipeline with explicit
|
|
54
|
+
freshness and reconciliation rather than scanning on each web request.
|
|
55
|
+
|
|
56
|
+
Single-table co-location here permits a customer aggregate query, but the order
|
|
57
|
+
list alone does not prove that merging the profile is better than two tables.
|
|
58
|
+
|
|
59
|
+
### Sparse index lifecycle
|
|
60
|
+
|
|
61
|
+
Populate **both** GSI key attributes only for qualifying open orders. Closing an
|
|
62
|
+
order must update status/version and remove those keys in the same `UpdateItem`:
|
|
63
|
+
|
|
64
|
+
```json
|
|
65
|
+
{
|
|
66
|
+
"UpdateExpression": "SET #st = :closed, #v = #v + :one REMOVE GSI1PK, GSI1SK",
|
|
67
|
+
"ConditionExpression": "#st = :open AND #v = :expected",
|
|
68
|
+
"ExpressionAttributeNames": {"#st": "status", "#v": "version"},
|
|
69
|
+
"ExpressionAttributeValues": {
|
|
70
|
+
":closed": {"S": "CLOSED"}, ":open": {"S": "OPEN"},
|
|
71
|
+
":one": {"N": "1"}, ":expected": {"N": "1"}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
This is a **fragment**: add the real `TableName` and full `Key`, authorize the
|
|
77
|
+
tenant, and handle the failed condition as a conflict. Reopening must restore both
|
|
78
|
+
keys, matching status and new version in one update. An eventual GSI may still show
|
|
79
|
+
the old entry briefly; queue consumers recheck authoritative state conditionally.
|
|
80
|
+
|
|
81
|
+
## Keys, relationships and indexes
|
|
82
|
+
|
|
83
|
+
For the full selection sequence, comparison and worked alternatives, read
|
|
84
|
+
[LSI vs GSI](lsi-vs-gsi.md). Copyable operations are in [Commands](commands/aws-cli.md).
|
|
85
|
+
|
|
86
|
+
- Composite sort keys encode hierarchy/ranges. Numbers sort numerically only when
|
|
87
|
+
stored as Number keys; string `2` and `10` sort lexically. Use deliberate padding
|
|
88
|
+
or numeric types, consistent case/encoding, tie-break IDs and immutable keys.
|
|
89
|
+
- One-to-many: co-locate bounded child items when read together; paginate large
|
|
90
|
+
collections. Many-to-many: consider two adjacency items/inverted access paths;
|
|
91
|
+
define synchronization/deletion and transaction boundaries. Do not claim joins.
|
|
92
|
+
- GSI: distinct partition/sort keys and independently provisioned throughput when
|
|
93
|
+
provisioned mode is used; eventual reads, storage and write amplification.
|
|
94
|
+
`KEYS_ONLY`, `INCLUDE`, `ALL` trade index size versus extra base reads. A request
|
|
95
|
+
projection is not the same as a physically smaller index projection.
|
|
96
|
+
- LSI: same partition key, alternative sort key, strong reads possible. Create
|
|
97
|
+
only at table creation; cannot add/delete later. With any LSI, each item
|
|
98
|
+
collection (base+LSI data for one PK) has a 10 GB limit. This is **not** a general
|
|
99
|
+
per-key limit on every table. Avoid adding LSIs for hypothetical future queries.
|
|
100
|
+
- GSI non-key uniqueness is not enforced; two items can share an index key.
|
|
101
|
+
Model unique claims under authoritative primary keys with conditions/transactions.
|
|
102
|
+
- A compound query not served by an existing key needs an explicit new access path,
|
|
103
|
+
a bounded client composition, or a different datastore—not arbitrary key predicates.
|
|
104
|
+
|
|
105
|
+
## Skew and cost are part of the model
|
|
106
|
+
|
|
107
|
+
`GSI1PK=OPEN` is a global hot key. Tenant-prefixing limits scope, not heat: one large
|
|
108
|
+
tenant can still dominate. A balanced base table can have an unbalanced index;
|
|
109
|
+
index back-pressure can throttle base writes. Monotonic sort keys can keep new
|
|
110
|
+
writes at one hot edge. On-demand/adaptive capacity do not remove physical limits.
|
|
111
|
+
|
|
112
|
+
For a measured hotspot, choose a stable shard count/function plus time buckets
|
|
113
|
+
where appropriate. Include:
|
|
114
|
+
|
|
115
|
+
1. How writers select the shard and how retries preserve it.
|
|
116
|
+
2. How readers fan out to all required shards/buckets and merge `(time, id)` order.
|
|
117
|
+
3. Per-shard continuation state and any buffered items, bound to a cursor version;
|
|
118
|
+
one `LastEvaluatedKey` cannot represent all shards.
|
|
119
|
+
4. Fan-out costs, empty queries, page/deadline budgets, key evolution and backfill.
|
|
120
|
+
|
|
121
|
+
Estimate base and each affected index separately. A nontransactional 1 KB write
|
|
122
|
+
uses one write unit; read unit baseline is 4 KB, strong versus eventual differs,
|
|
123
|
+
transactions cost more. Use actual operation-level rounding/aggregation rules from
|
|
124
|
+
AWS docs, not `ceil(each item / 4KB)` blindly for Query. Include projected bytes,
|
|
125
|
+
storage, replication, backups, streams/consumers and traffic spikes. Fetch current
|
|
126
|
+
Region/pricing data before quoting money; label estimates rather than promises.
|
|
127
|
+
|
|
128
|
+
Sources: [index guidelines](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-indexes-general.html),
|
|
129
|
+
[sparse indexes](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/bp-indexes-general-sparse-indexes.html),
|
|
130
|
+
[capacity accounting](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/read-write-operations.html),
|
|
131
|
+
[GSI back-pressure](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/gsi-throttling.html).
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
# CloudWatch monitoring by component
|
|
2
|
+
|
|
3
|
+
Start with user-visible latency/error objectives, not a dashboard of averages.
|
|
4
|
+
Distinguish table/index throttling, SDK retry/network time, stream consumer lag,
|
|
5
|
+
replication delay and cache misses. Commands below are examples; metric reads need
|
|
6
|
+
authorized account/Region scope and alarm writes need separate reviewed approval.
|
|
7
|
+
No alarm delivery, endpoint reachability or production health is proved here.
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
set -euo pipefail
|
|
11
|
+
: "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${TABLE_NAME:?}"
|
|
12
|
+
: "${METRIC_START_UTC:?Explicit ISO-8601 start}" "${METRIC_END_UTC:?Explicit ISO-8601 end}"
|
|
13
|
+
: "${GSI_NAME:?Approved observed GSI name, not an assumed default}"
|
|
14
|
+
aws_target=(aws --profile "$AWS_PROFILE" --region "$AWS_REGION" --no-cli-pager --output json)
|
|
15
|
+
# Metadata preflight: stop before index metrics/alarm writes if the GSI is absent or not ACTIVE.
|
|
16
|
+
index_state=$("${aws_target[@]}" dynamodb describe-table --table-name "$TABLE_NAME" \
|
|
17
|
+
--query Table.GlobalSecondaryIndexes)
|
|
18
|
+
printf '%s' "$index_state" | python3 -c \
|
|
19
|
+
'import json,sys; indexes=json.load(sys.stdin); ok=any(i.get("IndexName")==sys.argv[1] and i.get("IndexStatus")=="ACTIVE" for i in (indexes or [])); sys.exit(0 if ok else "Selected GSI is absent or not ACTIVE")' "$GSI_NAME"
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Domain: table and index health
|
|
23
|
+
|
|
24
|
+
| AWS/DynamoDB signal | Correct dimension set / statistic | What not to infer |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| ConsumedReadCapacityUnits / ConsumedWriteCapacityUnits | TableName; add GlobalSecondaryIndexName for a GSI; Sum divided by seconds for a rate | Period sum is not units/second; table-only does not aggregate every GSI |
|
|
27
|
+
| ReadThrottleEvents / WriteThrottleEvents | TableName; add GlobalSecondaryIndexName for GSI; Sum | Balanced table does not exclude a hot index or partial-batch throttling |
|
|
28
|
+
| ThrottledRequests / SystemErrors | TableName **and Operation**; Sum | SystemErrors with only TableName is not the matching series |
|
|
29
|
+
| SuccessfulRequestLatency | TableName + Operation; Average or p95/p99 | Service latency excludes client/network/retry time |
|
|
30
|
+
| UserErrors | Regional/account aggregate, no table dimensions; Sum | Not a per-table metric by inventing a TableName dimension |
|
|
31
|
+
| OnlineIndexPercentageProgress / OnlineIndexThrottleEvents | Documented table/index dimensions; inspect published series | A table ACTIVE waiter does not prove an online index ready |
|
|
32
|
+
|
|
33
|
+
Use documented metric dimensions exactly; extra/missing dimensions select a
|
|
34
|
+
different or nonexistent series rather than filtering a metric. `list-metrics`
|
|
35
|
+
helps discover published series but an absent series may be inactive/sparse, not
|
|
36
|
+
proof the metric or table doesn't exist. Inspect throttle reasons and per-key/index
|
|
37
|
+
signals; don't diagnose every event as insufficient total provisioned capacity.
|
|
38
|
+
|
|
39
|
+
### Commands: discover and query table/GSI metrics
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
"${aws_target[@]}" cloudwatch list-metrics --namespace AWS/DynamoDB \
|
|
43
|
+
--metric-name ReadThrottleEvents --dimensions Name=TableName,Value="$TABLE_NAME" --no-paginate
|
|
44
|
+
"${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
|
|
45
|
+
--metric-name ReadThrottleEvents --dimensions Name=TableName,Value="$TABLE_NAME" \
|
|
46
|
+
--start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
|
|
47
|
+
"${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
|
|
48
|
+
--metric-name WriteThrottleEvents \
|
|
49
|
+
--dimensions Name=TableName,Value="$TABLE_NAME" Name=GlobalSecondaryIndexName,Value="$GSI_NAME" \
|
|
50
|
+
--start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
|
|
51
|
+
"${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
|
|
52
|
+
--metric-name SuccessfulRequestLatency \
|
|
53
|
+
--dimensions Name=TableName,Value="$TABLE_NAME" Name=Operation,Value=Query \
|
|
54
|
+
--start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --extended-statistics p99
|
|
55
|
+
"${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
|
|
56
|
+
--metric-name SystemErrors --dimensions Name=TableName,Value="$TABLE_NAME" Name=Operation,Value=Query \
|
|
57
|
+
--start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
No datapoints is not a positive health verdict. Verify time bounds, metric
|
|
61
|
+
publication/retention granularity, namespace, Region, dimensions and sparse-event
|
|
62
|
+
behavior. Contributor Insights can reveal hot keys but is opt-in/cost-bearing and
|
|
63
|
+
can expose key values; handle activation and access as a separate privacy review.
|
|
64
|
+
|
|
65
|
+
## Domain: replica, stream consumer and cache monitoring
|
|
66
|
+
|
|
67
|
+
| Component | Namespace / metric / dimensions | Interpretation |
|
|
68
|
+
|---|---|---|
|
|
69
|
+
| MREC replication | AWS/DynamoDB / ReplicationLatency / TableName + ReceivingRegion, queried in source Region; Average or Maximum | Observed lag, not a failover/RPO guarantee or MRSC transaction latency metric |
|
|
70
|
+
| Lambda stream consumer | AWS/Lambda / IteratorAge / FunctionName; Maximum | Alert well before 24-hour record retention; also inspect Errors/Throttles Sum and failure destinations |
|
|
71
|
+
| DAX | AWS/DAX / ItemCacheHits, ItemCacheMisses, QueryCacheHits, QueryCacheMisses / ClusterId (or observed ClusterId+NodeId); Sum | Compute hits/(hits+misses), guard zero denominator; separate item/query caches |
|
|
72
|
+
|
|
73
|
+
DAX emits sparse/nonzero signals; an idle cache is not a proven healthy cache.
|
|
74
|
+
Include DAX CPU/memory pressure, errors and throttles, plus application-level
|
|
75
|
+
cache staleness and fallback load. Check actual published dimension sets before
|
|
76
|
+
composing dashboards; do not combine a node series with an aggregate cluster one.
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
: "${REPLICA_REGION:?Destination Region}" "${FUNCTION_NAME:?Consumer function}" "${DAX_CLUSTER_NAME:?Cluster ID}"
|
|
80
|
+
"${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DynamoDB \
|
|
81
|
+
--metric-name ReplicationLatency \
|
|
82
|
+
--dimensions Name=TableName,Value="$TABLE_NAME" Name=ReceivingRegion,Value="$REPLICA_REGION" \
|
|
83
|
+
--start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Maximum
|
|
84
|
+
"${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/Lambda \
|
|
85
|
+
--metric-name IteratorAge --dimensions Name=FunctionName,Value="$FUNCTION_NAME" \
|
|
86
|
+
--start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Maximum
|
|
87
|
+
"${aws_target[@]}" cloudwatch get-metric-statistics --namespace AWS/DAX \
|
|
88
|
+
--metric-name ItemCacheHits --dimensions Name=ClusterId,Value="$DAX_CLUSTER_NAME" \
|
|
89
|
+
--start-time "$METRIC_START_UTC" --end-time "$METRIC_END_UTC" --period 60 --statistics Sum
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
## Domain: alarms, notifications and permission boundaries
|
|
93
|
+
|
|
94
|
+
The following creates/updates one named GSI alarm and can overwrite an existing
|
|
95
|
+
alarm's settings. Inspect the current definition first, review its owner and exact
|
|
96
|
+
delta, and keep a rollback definition. Threshold/window here is illustrative, not
|
|
97
|
+
a workload-calibrated SLO. Wire an approved SNS topic and test subscriptions/topic
|
|
98
|
+
policy and actual delivery separately; an AlarmActions ARN alone proves nothing.
|
|
99
|
+
|
|
100
|
+
```bash
|
|
101
|
+
: "${ALARM_NAME:?Reviewed alarm name}" "${SNS_TOPIC_ARN:?Approved notification topic}"
|
|
102
|
+
"${aws_target[@]}" cloudwatch describe-alarms --alarm-names "$ALARM_NAME"
|
|
103
|
+
# Approved alarm mutation; two of two one-minute periods with at least one event.
|
|
104
|
+
"${aws_target[@]}" cloudwatch put-metric-alarm --alarm-name "$ALARM_NAME" \
|
|
105
|
+
--namespace AWS/DynamoDB --metric-name WriteThrottleEvents \
|
|
106
|
+
--dimensions Name=TableName,Value="$TABLE_NAME" Name=GlobalSecondaryIndexName,Value="$GSI_NAME" \
|
|
107
|
+
--statistic Sum --period 60 --evaluation-periods 2 --datapoints-to-alarm 2 \
|
|
108
|
+
--threshold 0 --comparison-operator GreaterThanThreshold \
|
|
109
|
+
--treat-missing-data ignore --alarm-actions "$SNS_TOPIC_ARN" --actions-enabled
|
|
110
|
+
"${aws_target[@]}" cloudwatch describe-alarms --alarm-names "$ALARM_NAME"
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Current primary sources **disagree**: the CloudWatch user guide describes a default
|
|
114
|
+
of ignore with an override, while PutMetricAlarm's API reference says AWS/DynamoDB
|
|
115
|
+
always ignores missing data even when another setting is supplied. Do not claim
|
|
116
|
+
an override is guaranteed or silently label one source obsolete. This example
|
|
117
|
+
explicitly uses `ignore`, consistent with both descriptions: missing data can leave
|
|
118
|
+
the alarm in a stale state, including ALARM. It is not a heartbeat detector or an
|
|
119
|
+
automatic all-clear policy. Design a verified recovery/healthy signal and test
|
|
120
|
+
OK/ALARM/INSUFFICIENT_DATA transitions and notification delivery in the target
|
|
121
|
+
environment before relying on a different missing-data setting.
|
|
122
|
+
|
|
123
|
+
Metric queries use cloudwatch:ListMetrics/GetMetricStatistics/GetMetricData, not
|
|
124
|
+
dynamodb:GetItem. Account/metric read actions often lack table-level ARN scoping;
|
|
125
|
+
check CloudWatch SAR rather than using a DynamoDB ARN in their Resource field.
|
|
126
|
+
Alarm configuration uses cloudwatch:PutMetricAlarm/DescribeAlarms with appropriate
|
|
127
|
+
alarm resources; SNS delivery/topic administration is a separate service/policy.
|
|
128
|
+
Lambda logs and stream processing likewise have distinct role and resource scopes.
|
|
129
|
+
Keep these operational rights out of ordinary item CRUD roles.
|
|
130
|
+
|
|
131
|
+
Sources: [DynamoDB metrics/dimensions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/metrics-dimensions.html),
|
|
132
|
+
[global-table monitoring](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html),
|
|
133
|
+
[DAX metrics](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/dax-metrics-dimensions-dax.html),
|
|
134
|
+
[Lambda metrics](https://docs.aws.amazon.com/lambda/latest/dg/monitoring-metrics-types.html),
|
|
135
|
+
[missing-data behavior](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarms-and-missing-data.html),
|
|
136
|
+
[PutMetricAlarm API conflict](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_PutMetricAlarm.html),
|
|
137
|
+
[CloudWatch IAM](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazoncloudwatch.html).
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# Official sources (repository adapter)
|
|
2
|
+
|
|
3
|
+
Use AWS documentation as the authority for service behaviour. Third-party skills,
|
|
4
|
+
blogs and model memory are leads, not evidence.
|
|
5
|
+
|
|
6
|
+
## Where the evidence lives
|
|
7
|
+
|
|
8
|
+
- [The evidence ledger](evidence-ledger.md) traces each material AWS claim in this
|
|
9
|
+
skill to the AWS page that was fetched on its retrieval date, with its status
|
|
10
|
+
(VERIFIED, UNVERIFIED or CONFLICT).
|
|
11
|
+
- [The evidence index](evidence-index.md) maps ledger rows to the skill files they cover
|
|
12
|
+
and lists every unconfirmed or conflicting claim.
|
|
13
|
+
- [The source log](sources.md) records how each release was
|
|
14
|
+
researched, including the third-party skills that were read for inspiration only.
|
|
15
|
+
|
|
16
|
+
## Primary AWS documentation
|
|
17
|
+
|
|
18
|
+
- DynamoDB Developer Guide:
|
|
19
|
+
<https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/>
|
|
20
|
+
- DynamoDB API Reference:
|
|
21
|
+
<https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/>
|
|
22
|
+
- AWS CLI `dynamodb` reference:
|
|
23
|
+
<https://docs.aws.amazon.com/cli/latest/reference/dynamodb/>
|
|
24
|
+
- CloudFormation `AWS::DynamoDB::Table`:
|
|
25
|
+
<https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-dynamodb-table.html>
|
|
26
|
+
- Service Authorization Reference (IAM actions and condition keys):
|
|
27
|
+
<https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazondynamodb.html>
|
|
28
|
+
|
|
29
|
+
## Grounding rule
|
|
30
|
+
|
|
31
|
+
Re-fetch the page before relying on a limit, quota, API parameter or IAM action:
|
|
32
|
+
they change. Where two AWS pages disagree, say so and cite both (see the CONFLICT
|
|
33
|
+
rows in the ledger). If no AWS page settles a claim, label it unverified rather than
|
|
34
|
+
inferring it from silence.
|
|
@@ -0,0 +1,130 @@
|
|
|
1
|
+
# Amazon DynamoDB operations
|
|
2
|
+
|
|
3
|
+
Operational coverage for Amazon DynamoDB (control-plane and data-plane APIs; on-demand and provisioned capacity modes; single-Region tables and global tables). Every section uses the
|
|
4
|
+
same heading and states one status. Cite evidence rows from
|
|
5
|
+
[the evidence ledger](evidence-ledger.md) as `[DP-Exx]`.
|
|
6
|
+
`tests/validate-nosql-operations.py` enforces this structure.
|
|
7
|
+
|
|
8
|
+
Statuses:
|
|
9
|
+
|
|
10
|
+
- `VERIFIED`: the provider documents the capability; every statement below cites a
|
|
11
|
+
VERIFIED row.
|
|
12
|
+
- `PARTIAL`: some of it is documented and some is not, or it is limited (by tier,
|
|
13
|
+
mode, Region or API); say which part is which.
|
|
14
|
+
- `UNSUPPORTED`: provider documentation states the capability does not exist. Cite it.
|
|
15
|
+
- `UNVERIFIED`: no official page settled it in this pass. Say what was searched.
|
|
16
|
+
- `NOT APPLICABLE`: the capability does not apply to this service. Say why.
|
|
17
|
+
|
|
18
|
+
## Backup and restore
|
|
19
|
+
|
|
20
|
+
**Status:** VERIFIED
|
|
21
|
+
|
|
22
|
+
- Two backup types: on-demand backups (a table snapshot that DynamoDB stores and manages, created by DynamoDB or by AWS Backup) and continuous point-in-time recovery (PITR) backups. Each on-demand backup copies the entire table and there is no limit on how many you can take [DP-E601]. AWS Backup can run backup plans with schedules and retention policies for DynamoDB tables [DP-E605].
|
|
23
|
+
- PITR recovery period is configurable from 1 to 35 days [DP-E401]; `LatestRestorableDateTime` is typically about five minutes behind the current time [DP-E402]. Disabling and re-enabling PITR resets the start of the recoverable history [DP-E404].
|
|
24
|
+
- Backups and restores consume no provisioned throughput on the table [DP-E602]. On-demand backups are asynchronous and not causally consistent across items: changes within one minute of the request may or may not be included [DP-E416].
|
|
25
|
+
- Restore target is always a new table, never in place: PITR restore creates a new table [DP-E410], restore from a backup creates a new table from a backup ARN [DP-E415], and an existing table is not overwritten [DP-E604].
|
|
26
|
+
- A restore can change GSIs, LSIs, billing mode, provisioned capacity and encryption settings, and can target a different Region from where the backup resides [DP-E603].
|
|
27
|
+
- Not restored automatically (set them again on the restored table): auto scaling policies, IAM policies, CloudWatch metrics and alarms, tags, stream settings, TTL, deletion protection and PITR settings [DP-E411].
|
|
28
|
+
- Deleting a table with PITR enabled creates a system backup retained for 35 days [DP-E413]. All backups are automatically encrypted [DP-E607]; an on-demand backup made before a key change keeps its original key and needs it to restore [DP-E347].
|
|
29
|
+
- Tags and ABAC are not supported on DynamoDB-native backups; AWS Backup is the documented route for ABAC with backups [DP-E606].
|
|
30
|
+
|
|
31
|
+
## Disaster recovery and replication
|
|
32
|
+
|
|
33
|
+
**Status:** VERIFIED
|
|
34
|
+
|
|
35
|
+
- Single-Region options are PITR and backups. The disaster recovery guide lists PITR with an RPO of seconds and an RTO of minutes, in a single Region only [DP-E608].
|
|
36
|
+
- Multi-Region option is global tables, in two consistency modes: multi-Region eventual consistency (MREC) and multi-Region strong consistency (MRSC) [DP-E144] [DP-E146]. MRSC mode cannot be changed after creation [DP-E431].
|
|
37
|
+
- Stated availability SLA: 99.999% for global tables versus 99.99% for single-Region tables [DP-E609].
|
|
38
|
+
- Stated RPO: MREC equals the replication delay between replicas, usually a few seconds [DP-E610]; MRSC supports an RPO of zero [DP-E611]. MREC replication is asynchronous and a strongly consistent read at a replica can miss a write from another Region [DP-E144]. No RTO figure is stated for global tables on the pages read here.
|
|
39
|
+
- Failover mode: the documentation describes shifting application traffic to a healthy replica table, which accepts reads and writes [DP-E612]. Replica placement is your decision: MRSC needs exactly three Regions (three replicas, or two plus a witness) [DP-E429].
|
|
40
|
+
- MREC transactions are not replicated atomically as a group [DP-E145]. PITR, tags, deletion protection and resource policies are not synchronized between replicas, so verify them per Region [DP-E426].
|
|
41
|
+
- Multi-account global tables are MREC only and have a different settings contract [DP-E436]. The MREC replication stream cannot be disabled [DP-E442].
|
|
42
|
+
- Cross-Region recovery from backups is separate from replication: a backup can be restored into a different Region [DP-E603].
|
|
43
|
+
|
|
44
|
+
## Cost
|
|
45
|
+
|
|
46
|
+
**Status:** VERIFIED
|
|
47
|
+
|
|
48
|
+
Pricing: <https://aws.amazon.com/dynamodb/pricing/>. Estimate with the [AWS Pricing Calculator](https://calculator.aws/). No unit prices are recorded here.
|
|
49
|
+
|
|
50
|
+
- Throughput, on-demand: billed per read request unit and write request unit [DP-E613]. Reads are 4 KB increments and writes 1 KB increments; query capacity rounds the total returned size, and filters or projections do not reduce consumed capacity [DP-E127] [DP-E131].
|
|
51
|
+
- Throughput, provisioned: billed on the hourly provisioned read and write capacity, not on consumption [DP-E614]. Reserved capacity is an upfront fee plus a commitment to a minimum provisioned level [DP-E626].
|
|
52
|
+
- Storage: billed on raw item bytes plus a per-item overhead that depends on enabled features [DP-E615]. Usage types differ by table class (Standard or Standard-IA) [DP-E616].
|
|
53
|
+
- Backup: PITR is billed on table size for as long as PITR is enabled [DP-E617]; reducing the recovery window does not reduce the PITR price [DP-E406]. On-demand backups are billed on size and duration [DP-E618]. Restores are billed on total GB restored, including indexes [DP-E619].
|
|
54
|
+
- Replication: global table writes are billed per replica as replicated write units, GSI updates use standard write units [DP-E620]. There is no cross-Region transfer fee for global table replication [DP-E621]. TTL deletes replicate and are charged in the other Regions [DP-E425].
|
|
55
|
+
- Streams: DynamoDB Streams reads are billed in read request units [DP-E622]; Lambda trigger reads and global table replication reads are not charged [DP-E623].
|
|
56
|
+
- Data transfer: no charge for inbound transfer or same-Region transfer to other AWS services; cross-Region transfer is charged on both sides [DP-E624]. Interface (PrivateLink) endpoints are billed, gateway endpoints are not [DP-E648].
|
|
57
|
+
- Adjacent services: Contributor Insights is billed under CloudWatch [DP-E625]; CloudTrail data events and the CloudTrail logs of replication reads are billed by CloudTrail [DP-E660].
|
|
58
|
+
|
|
59
|
+
## Monitoring
|
|
60
|
+
|
|
61
|
+
**Status:** PARTIAL
|
|
62
|
+
|
|
63
|
+
- DynamoDB publishes metrics to Amazon CloudWatch in the `AWS/DynamoDB` namespace [DP-E664]; consumed provisioned throughput is emitted per one-minute period [DP-E663].
|
|
64
|
+
- Capacity and throttling metrics: `ConsumedReadCapacityUnits` and `ConsumedWriteCapacityUnits` (add `GlobalSecondaryIndexName` for an index) [DP-E501]; `ReadThrottleEvents` and `WriteThrottleEvents` [DP-E502]; `ThrottledRequests` and `SystemErrors`, which need both `TableName` and `Operation` [DP-E503]; `UserErrors` is a Regional aggregate without a table dimension [DP-E505].
|
|
65
|
+
- Cause-specific throttle metrics include `ReadKeyRangeThroughputThrottleEvents` for partition limits [DP-E633].
|
|
66
|
+
- Global tables: MREC publishes `ReplicationLatency` with `TableName` and `ReceivingRegion` dimensions [DP-E509]; MRSC does not publish it [DP-E511].
|
|
67
|
+
- Usage metrics integrate with Service Quotas, and CloudWatch alarms can alert when usage approaches a threshold [DP-E665].
|
|
68
|
+
- PARTIAL because: a provider-recommended alarm set was not found on the pages read (searched the metrics and dimensions page, the throttling pages and the monitoring overview, which is JavaScript-rendered and returned no text). Alarm thresholds are therefore your own choice.
|
|
69
|
+
|
|
70
|
+
## Performance
|
|
71
|
+
|
|
72
|
+
**Status:** VERIFIED
|
|
73
|
+
|
|
74
|
+
- Each partition is designed for a maximum of 3,000 read units and 1,000 write units per second [DP-E627]. Adaptive capacity applies to both on-demand and provisioned modes [DP-E628].
|
|
75
|
+
- Throttling has four documented causes: partition (key range) limits in both modes, provisioned throughput exceeded, account-level quotas in on-demand mode, and a configured on-demand maximum throughput [DP-E629]. Each maps to a cause-specific metric [DP-E633].
|
|
76
|
+
- The throttle exception carries `ThrottlingReason` fields naming the resource, operation and limit [DP-E632]. The AWS SDKs automatically retry `ProvisionedThroughputExceededException` [DP-E635].
|
|
77
|
+
- On-demand scaling: new tables sustain up to 4,000 writes and 12,000 reads per second [DP-E636]; tables accommodate up to double the previous peak instantly [DP-E630], and throttling can occur if you exceed double the previous peak within 30 minutes [DP-E631]. An optional maximum throughput per table or index throttles requests above it [DP-E634].
|
|
78
|
+
- Index pressure: an overloaded GSI can throttle base-table writes [DP-E107]; on-demand GSIs still have limits and hot keys [DP-E116].
|
|
79
|
+
- An LSI item collection lives in one partition and is limited to 10 GB per partition key value [DP-E108] [DP-E122].
|
|
80
|
+
|
|
81
|
+
## IAM
|
|
82
|
+
|
|
83
|
+
**Status:** VERIFIED
|
|
84
|
+
|
|
85
|
+
- Identity-based policies use `dynamodb:*` actions. Control-plane actions (`CreateTable`, `UpdateTable`, `DeleteTable`, `DescribeTable`, TTL and continuous-backup actions) apply to the table resource [DP-E307]; `ListTables`, `ListStreams`, `DescribeLimits` and `DescribeEndpoints` have no resource-level scope [DP-E309].
|
|
86
|
+
- Resource ARNs: tables `table/<name>`, indexes `table/<name>/index/<index>`, streams `table/<name>/stream/<label>` [DP-E301].
|
|
87
|
+
- Built-in managed policies: `AmazonDynamoDBFullAccess` [DP-E637] and `AmazonDynamoDBReadOnlyAccess` [DP-E638]. They are broad, so prefer scoped custom policies for production.
|
|
88
|
+
- Least privilege levers: restrict by table and index ARN [DP-E301]; `dynamodb:LeadingKeys` for item-level scoping on supported actions (not `Scan`) [DP-E315]; tag conditions with ABAC [DP-E321].
|
|
89
|
+
- Resource-based policies are supported for tables, indexes and streams [DP-E639]; support differs by API and cross-account use [DP-E325]. IAM Access Analyzer reports cross-account access in them [DP-E640], and Block Public Access is enforced automatically with no setting [DP-E641].
|
|
90
|
+
- Global tables use a service-linked role; an explicit deny of its replication action breaks adding or deleting replicas [DP-E331]. Replica creation needs specific permissions on source and destination [DP-E421].
|
|
91
|
+
|
|
92
|
+
## Tagging
|
|
93
|
+
|
|
94
|
+
**Status:** PARTIAL
|
|
95
|
+
|
|
96
|
+
- Tables can be tagged [DP-E642], tags feed AWS cost reports [DP-E643], and indexes inherit the tags of their table [DP-E317]. Tag operations (`TagResource`, `UntagResource`, `ListTagsOfResource`) apply to a table or stream [DP-E310].
|
|
97
|
+
- Tag-based access control (ABAC) is documented for tables and, separately, for Streams, with enablement scoped per account and Region [DP-E321]. Behaviour of tag conditions when ABAC is disabled differs [DP-E323].
|
|
98
|
+
- Not covered: DynamoDB-native backups cannot be tagged and do not support ABAC [DP-E606]. Tags are not restored with a table [DP-E411] and are not synchronized between global table replicas [DP-E426].
|
|
99
|
+
- PARTIAL because two official pages disagree on Streams: the Tagging page says Streams usage cannot be tagged, while the Streams tagging page documents adding tags to existing streams [DP-E644] [DP-E318]. Test before relying on stream tags.
|
|
100
|
+
|
|
101
|
+
## Encryption
|
|
102
|
+
|
|
103
|
+
**Status:** VERIFIED
|
|
104
|
+
|
|
105
|
+
- At rest: server-side encryption is always on and cannot be disabled; LSIs and GSIs use the base table key [DP-E334] [DP-E120].
|
|
106
|
+
- Key choices: AWS owned key (default, no charge), AWS managed key `alias/aws/dynamodb`, or customer managed key; the latter two incur AWS KMS charges [DP-E335]. For the AWS managed key you can view the policy and audit use in CloudTrail [DP-E336].
|
|
107
|
+
- Customer managed key restrictions: symmetric keys only [DP-E337]; the key policy must grant DynamoDB access, at minimum including `kms:CreateGrant` [DP-E346]; disabling or deleting the key, or removing grants, can block table access [DP-E349]. Global tables add a customer managed key version requirement [DP-E350].
|
|
108
|
+
- Changing keys with `update-table` switches the table key [DP-E343]; older on-demand backups keep their original key and need it to restore [DP-E347]. Table keys are cached, so KMS is not called for every item access [DP-E338].
|
|
109
|
+
- DAX cluster encryption is separate and does not support a customer managed key [DP-E351]. All backups are automatically encrypted [DP-E607].
|
|
110
|
+
- In transit: clients must support TLS 1.2 [DP-E645].
|
|
111
|
+
|
|
112
|
+
## Network isolation
|
|
113
|
+
|
|
114
|
+
**Status:** PARTIAL
|
|
115
|
+
|
|
116
|
+
- Two VPC endpoint types reach DynamoDB: a gateway endpoint (a route-table target over the AWS network) and an interface endpoint using AWS PrivateLink [DP-E646]. Both can coexist in one VPC [DP-E648].
|
|
117
|
+
- Interface endpoints give VPC applications private IP access without public IP addresses [DP-E647]. They are billed; gateway endpoints are not [DP-E648]. PrivateLink is also supported for DynamoDB Streams endpoints [DP-E652].
|
|
118
|
+
- Scope access with a VPC endpoint policy (principal, actions, resources) [DP-E651]. For requests via a VPC endpoint, both the IAM policy and the endpoint policy must authorize `DescribeEndpoints` [DP-E653].
|
|
119
|
+
- PrivateLink limits: 50,000 requests per second per endpoint [DP-E650]; do not override DynamoDB DNS names with private hosted zones, point clients at the endpoint URL instead [DP-E649].
|
|
120
|
+
- PARTIAL because: the documentation read here describes private paths and policy scoping but no setting that turns off the public DynamoDB endpoint for an account or table. Block Public Access applies to resource-based policies, not to the network path [DP-E641]. Two pages also differ on on-premises reach of "VPC endpoints" (Site-to-Site VPN and Direct Connect) without saying which endpoint type the older note means [DP-E654].
|
|
121
|
+
|
|
122
|
+
## Audit logging
|
|
123
|
+
|
|
124
|
+
**Status:** VERIFIED
|
|
125
|
+
|
|
126
|
+
- AWS CloudTrail records DynamoDB API calls from the console, SDKs, PartiQL and the classic API [DP-E655]. Without a trail, recent events stay in CloudTrail Event history [DP-E661].
|
|
127
|
+
- Control-plane events (table, backup, global table, tag, TTL, DAX and Streams describe or list actions) are logged by default [DP-E656]. Backup and restore actions are recorded [DP-E662].
|
|
128
|
+
- Data-plane (item-level) auditing is possible but opt-in: you must enable logging of data plane API activity as CloudTrail data events [DP-E657].
|
|
129
|
+
- Data events can be filtered by resource type (table or stream) to control what is logged and billed [DP-E658]. TTL deletions are not logged [DP-E659].
|
|
130
|
+
- Logging `GetRecords` data events also captures internal global tables replication calls and is billed by CloudTrail, so filter them out [DP-E660].
|
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
# Create the worked-model table
|
|
2
|
+
|
|
3
|
+
Choose **one** owner: CloudFormation **or** direct CLI, not both for the same new
|
|
4
|
+
table. These are examples to inspect and adapt, not instructions to execute during
|
|
5
|
+
skill authoring. Any live AWS call needs authorized target/data scope; creation
|
|
6
|
+
additionally needs approval of the exact change and recurring charges.
|
|
7
|
+
|
|
8
|
+
Both paths define string PK/SK, string GSI1PK/GSI1SK, GSI1 with INCLUDE projection,
|
|
9
|
+
on-demand billing, deletion protection, TTL and PITR. The CLI creates the same keys,
|
|
10
|
+
index and billing first, then configures TTL/PITR through separate APIs.
|
|
11
|
+
|
|
12
|
+
For these ordinary table/GSI examples, only key attributes belong in
|
|
13
|
+
`AttributeDefinitions`. Do **not** add `status`,
|
|
14
|
+
`orderId`, `totalMinor` or every application field there. They are item attributes,
|
|
15
|
+
not key declarations. Sparse membership depends on which items supply GSI keys.
|
|
16
|
+
Native vector indexes are different: their HASH **and INLINE_FILTER** SearchSchema
|
|
17
|
+
attributes need scalar declarations; the embedding list itself does not. See
|
|
18
|
+
[data types and vectors](data-types-and-vectors.md) instead of extending this
|
|
19
|
+
ordinary-index rule to vector indexes.
|
|
20
|
+
|
|
21
|
+
For operational commands and the optional **new-table** LSI alternative, see
|
|
22
|
+
[Commands](commands/aws-cli.md) and [LSI vs GSI](lsi-vs-gsi.md). For deliberate AWS-managed
|
|
23
|
+
or customer-managed KMS selection, use [Encryption](encryption.md). The default
|
|
24
|
+
assets still use an AWS-owned key and no LSI; do not silently change either.
|
|
25
|
+
|
|
26
|
+
## CloudFormation
|
|
27
|
+
|
|
28
|
+
Use [table.cfn.yaml](../assets/table.cfn.yaml). Essential excerpt (not a standalone
|
|
29
|
+
template; the asset includes index attribute definitions and preservation policies):
|
|
30
|
+
|
|
31
|
+
```yaml
|
|
32
|
+
Type: AWS::DynamoDB::Table
|
|
33
|
+
Properties:
|
|
34
|
+
BillingMode: PAY_PER_REQUEST
|
|
35
|
+
DeletionProtectionEnabled: true
|
|
36
|
+
KeySchema:
|
|
37
|
+
- AttributeName: PK
|
|
38
|
+
KeyType: HASH
|
|
39
|
+
- AttributeName: SK
|
|
40
|
+
KeyType: RANGE
|
|
41
|
+
TimeToLiveSpecification:
|
|
42
|
+
AttributeName: expiresAt
|
|
43
|
+
Enabled: true
|
|
44
|
+
PointInTimeRecoverySpecification:
|
|
45
|
+
PointInTimeRecoveryEnabled: true
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
After target/cost approval, create an **unexecuted** change set, inspect it, then
|
|
49
|
+
obtain approval before executing that exact change-set ARN:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
# Run from this skill's directory. All variables are explicit approved values.
|
|
53
|
+
: "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${STACK_NAME:?}" "${TABLE_NAME:?}"
|
|
54
|
+
aws --profile "$AWS_PROFILE" --region "$AWS_REGION" sts get-caller-identity
|
|
55
|
+
cfn-lint assets/table.cfn.yaml # local check only
|
|
56
|
+
aws --profile "$AWS_PROFILE" --region "$AWS_REGION" cloudformation deploy \
|
|
57
|
+
--template-file assets/table.cfn.yaml --stack-name "$STACK_NAME" \
|
|
58
|
+
--parameter-overrides TableName="$TABLE_NAME" --no-execute-changeset
|
|
59
|
+
# Inspect the generated change set. Use its exact ARN for subsequent approved
|
|
60
|
+
# describe-change-set / execute-change-set / wait stack-create-complete calls.
|
|
61
|
+
# An update uses the matching stack-update waiter instead. No implicit execution.
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
`Retain`/`UpdateReplacePolicy: Retain` deliberately keep billable data/resources.
|
|
65
|
+
The named table may prevent replacement; inspect changes rather than forcing it.
|
|
66
|
+
Deletion protection also blocks normal table deletion; disabling it is a separate
|
|
67
|
+
destructive decision, not a default cleanup step. DynamoDB encrypts at rest by
|
|
68
|
+
default; this example leaves the AWS-owned default key. Customer-managed KMS keys
|
|
69
|
+
need separate key policy/IAM, availability, lifecycle and cost review.
|
|
70
|
+
|
|
71
|
+
## AWS CLI v2
|
|
72
|
+
|
|
73
|
+
Inspect [create-table.json](../assets/create-table.json) and
|
|
74
|
+
[create-table.sh](../assets/create-table.sh). Minimal creation shape, **not executed**:
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
: "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${TABLE_NAME:?}"
|
|
78
|
+
aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb create-table \
|
|
79
|
+
--table-name "$TABLE_NAME" --cli-input-json file://assets/create-table.json
|
|
80
|
+
aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb wait table-exists \
|
|
81
|
+
--table-name "$TABLE_NAME"
|
|
82
|
+
aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb update-time-to-live \
|
|
83
|
+
--table-name "$TABLE_NAME" \
|
|
84
|
+
--time-to-live-specification 'Enabled=true,AttributeName=expiresAt'
|
|
85
|
+
aws --profile "$AWS_PROFILE" --region "$AWS_REGION" dynamodb update-continuous-backups \
|
|
86
|
+
--table-name "$TABLE_NAME" \
|
|
87
|
+
--point-in-time-recovery-specification 'PointInTimeRecoveryEnabled=true'
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
The complete shell example adds an account guard and interactive target check.
|
|
91
|
+
Its confirmation prompt is not a substitute for approval of role/Region/resource.
|
|
92
|
+
It fails on an existing table and on any failed step. If TTL/PITR fails **after**
|
|
93
|
+
creation, leave the table intact, read back actual state, and resume only the
|
|
94
|
+
approved missing configuration; do not rerun creation, auto-delete or adopt a
|
|
95
|
+
different table. A create timeout is also an unknown outcome: reconcile first.
|
|
96
|
+
|
|
97
|
+
TTL may report ENABLING before ENABLED; explicitly verify final status when TTL
|
|
98
|
+
is required. Check table and GSI ACTIVE, key/projection/billing, deletion protection,
|
|
99
|
+
PITR ENABLED and TTL attribute/status. A successful create response or table waiter
|
|
100
|
+
does not prove all later settings or application access. Do not auto-delete test
|
|
101
|
+
resources; disclose retained cost and propose separately approved cleanup.
|
|
102
|
+
|
|
103
|
+
The example deliberately excludes LSIs, Streams, Global Tables, alarms, workload
|
|
104
|
+
IAM, tags and on-demand maximum/warm-throughput tuning. Add only when justified;
|
|
105
|
+
it is not a complete production landing zone. On-demand has workload/partition
|
|
106
|
+
limits and is not a cost ceiling. Refresh service quotas and prices for the Region.
|
|
107
|
+
|
|
108
|
+
Sources: [CloudFormation table](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-dynamodb-table.html),
|
|
109
|
+
[CLI CreateTable](https://docs.aws.amazon.com/cli/latest/reference/dynamodb/create-table.html),
|
|
110
|
+
[PITR](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/PointInTimeRecovery.html).
|