@raishin/vanguard-frontier-agentic 3.19.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +601 -61
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +1603 -56
- package/catalog/skills.json +314 -14
- package/package.json +7 -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/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-cosmosdb-application-developer/SKILL.md +4 -2
- 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-platform-operator/SKILL.md +6 -2
- 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-maestro/SKILL.md +1 -0
- 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/oci/README.md +6 -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/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/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/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/validate-aws-skill-quality.py +7 -0
- 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-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
|
@@ -0,0 +1,173 @@
|
|
|
1
|
+
# IAM, tags and resource-based access
|
|
2
|
+
|
|
3
|
+
## Target and authority
|
|
4
|
+
|
|
5
|
+
Examples are **not executed**. Each read still needs authorized account/Region/data
|
|
6
|
+
scope; IAM/tag/policy changes require separate reviewed approval. Run selected Bash
|
|
7
|
+
blocks from the skill directory, not this whole page. Do not change access to make
|
|
8
|
+
a diagnostic succeed. These synthetic policy assets must be rendered offline to
|
|
9
|
+
the intended partition, Region, owner table/index/stream and caller principal.
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
set -euo pipefail
|
|
13
|
+
: "${AWS_PROFILE:?}" "${AWS_REGION:?}" "${TABLE_NAME:?}" "${TABLE_ARN:?}"
|
|
14
|
+
aws_target=(aws --profile "$AWS_PROFILE" --region "$AWS_REGION" --no-cli-pager --output json)
|
|
15
|
+
"${aws_target[@]}" sts get-caller-identity
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
The table ARN is `arn:<partition>:dynamodb:<region>:<owner>:table/<table>`.
|
|
19
|
+
Both GSI and LSI use `<table-arn>/index/<name>`; Streams use
|
|
20
|
+
`<table-arn>/stream/<label>`. A table ARN alone is not a wildcard for those children.
|
|
21
|
+
|
|
22
|
+
## Domain: IAM action-to-resource mapping
|
|
23
|
+
|
|
24
|
+
Remove the `dynamodb:` prefix below only for readability, not in actual policies.
|
|
25
|
+
Distinguish service API/CLI names from IAM actions; they are **not** one-to-one.
|
|
26
|
+
|
|
27
|
+
| Application/API operation | Actual IAM permission | Resource scope |
|
|
28
|
+
|---|---|---|
|
|
29
|
+
| GetItem / PutItem / UpdateItem / DeleteItem | Matching action | Table, not an index |
|
|
30
|
+
| BatchGetItem / BatchWriteItem | Matching batch action | Every participating table |
|
|
31
|
+
| Query / Scan table or named GSI/LSI | Query / Scan | Table plus relevant index ARNs; same ARN pattern for both index types |
|
|
32
|
+
| Native vector similarity search | SearchVectors | Named vector index ARN, following its dedicated IAM example; not ordinary Query or FGAC tenant-key conditions |
|
|
33
|
+
| TransactGetItems | GetItem | Every target table |
|
|
34
|
+
| TransactWriteItems | PutItem, UpdateItem, DeleteItem and/or ConditionCheckItem according to its components | Every target table; same-account/same-Region transaction boundary |
|
|
35
|
+
| PartiQL reads / writes | PartiQLSelect / PartiQLInsert / PartiQLUpdate / PartiQLDelete | Select: table/relevant index; writes: table |
|
|
36
|
+
| DescribeTable / CreateTable / UpdateTable / DeleteTable | Matching action | Table; keep administration out of runtime roles |
|
|
37
|
+
| DescribeTimeToLive / UpdateTimeToLive | Matching action | Table |
|
|
38
|
+
| DescribeContinuousBackups / UpdateContinuousBackups | Matching action | Table; PITR is not implied by CRUD access |
|
|
39
|
+
| DescribeStream / GetShardIterator / GetRecords | Matching action, still **dynamodb:** | Stream ARN, not just table or index ARN |
|
|
40
|
+
| ListTables / ListStreams / DescribeLimits / DescribeEndpoints | Matching action | `Resource: "*"` where SAR lists no resource-level support; separate statement if genuinely needed |
|
|
41
|
+
| TagResource / UntagResource / ListTagsOfResource | Matching action | Table **or stream**, not directly an index |
|
|
42
|
+
| GetResourcePolicy / PutResourcePolicy / DeleteResourcePolicy | Matching action | Table or stream; owner administration, not cross-account policy-management rights |
|
|
43
|
+
| GetAbacStatus / UpdateAbacStatus permissions | Matching IAM action | Account/Region setting; `Resource: "*"`; not ordinary runtime access |
|
|
44
|
+
|
|
45
|
+
`dynamodb:TransactWriteItems`, `dynamodb:TransactGetItems` and
|
|
46
|
+
`dynamodb:ExecuteStatement` are not substitute IAM actions. ConditionCheckItem is
|
|
47
|
+
a permission-only action, not a standalone CLI API. Use supported condition keys
|
|
48
|
+
such as `dynamodb:EnclosingOperation` when restricting transactional use; verify
|
|
49
|
+
each action's SAR entry and dependent actions rather than grouping by name.
|
|
50
|
+
|
|
51
|
+
[table-index-read-policy.json](../assets/table-index-read-policy.json) allows only
|
|
52
|
+
GetItem/BatchGetItem on one table and Query on that table plus GSI1. It does not
|
|
53
|
+
grant Scan, writes, metadata discovery, tags, policy administration or Streams.
|
|
54
|
+
If a mapper needs DescribeTable, add it explicitly. Add only the selected LSI's
|
|
55
|
+
index ARN when that path exists. `/index/*` also permits future indexes.
|
|
56
|
+
|
|
57
|
+
This is **resource** isolation, not tenant/row authorization. A query filter or
|
|
58
|
+
projection does not establish tenant access. For supported actions, test
|
|
59
|
+
`dynamodb:LeadingKeys`/attribute conditions against real table/index key shapes;
|
|
60
|
+
Scan does not support LeadingKeys. Do not attach a generic tenant condition to
|
|
61
|
+
unsupported actions or assume every GSI's key equals the base tenant key.
|
|
62
|
+
|
|
63
|
+
### Commands: validate the proposed identity policy (read-only service analysis)
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
: "${IDENTITY_POLICY_FILE:?Path to the reviewed, target-rendered identity JSON}"
|
|
67
|
+
"${aws_target[@]}" accessanalyzer validate-policy \
|
|
68
|
+
--policy-type IDENTITY_POLICY --policy-document "file://$IDENTITY_POLICY_FILE"
|
|
69
|
+
"${aws_target[@]}" iam simulate-custom-policy \
|
|
70
|
+
--policy-input-list "$(cat "$IDENTITY_POLICY_FILE")" \
|
|
71
|
+
--action-names dynamodb:GetItem dynamodb:Query \
|
|
72
|
+
--resource-arns "$TABLE_ARN" "$TABLE_ARN/index/GSI1"
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
Review findings and **per-resource** simulator results, including expected denies
|
|
76
|
+
such as GetItem on an index. A simulator/valid JSON is not proof of the effective
|
|
77
|
+
caller role, SCPs, boundaries, resource policy, KMS access or a live application
|
|
78
|
+
request. Add positive/negative tests for every requested path before claiming
|
|
79
|
+
least privilege. No IAM policy-attachment command is run here.
|
|
80
|
+
|
|
81
|
+
## Domain: tagging and ABAC
|
|
82
|
+
|
|
83
|
+
Table tags are inherited by indexes; indexes cannot be tagged directly. Current
|
|
84
|
+
Streams supports **independent tags and ABAC**, does not inherit table tags and
|
|
85
|
+
cannot be tagged at stream creation. Tag an existing current stream ARN. Separate
|
|
86
|
+
DAX tags and replica configuration must be inspected in their own scopes.
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
"${aws_target[@]}" dynamodb list-tags-of-resource --resource-arn "$TABLE_ARN"
|
|
90
|
+
# Approved table tag mutation. This is not implicit permission to change access tags.
|
|
91
|
+
"${aws_target[@]}" dynamodb tag-resource --resource-arn "$TABLE_ARN" \
|
|
92
|
+
--tags Key=Environment,Value=staging
|
|
93
|
+
# Optional removal is also a separately approved mutation.
|
|
94
|
+
"${aws_target[@]}" dynamodb untag-resource --resource-arn "$TABLE_ARN" \
|
|
95
|
+
--tag-keys Environment
|
|
96
|
+
: "${STREAM_ARN:?Current approved stream ARN, not the table ARN}"
|
|
97
|
+
"${aws_target[@]}" dynamodb tag-resource --resource-arn "$STREAM_ARN" \
|
|
98
|
+
--tags Key=Environment,Value=staging
|
|
99
|
+
"${aws_target[@]}" dynamodb list-tags-of-resource --resource-arn "$STREAM_ARN"
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Tag-on-table-create uses CreateTable's `--tags`; review the additional TagResource
|
|
103
|
+
permission rather than assuming CreateTable alone covers tagging. Never place
|
|
104
|
+
secrets/PII in tags. Eventual tag readback is not immediate authorization proof.
|
|
105
|
+
|
|
106
|
+
ABAC enablement is independent for tables and Streams and scoped to account/Region.
|
|
107
|
+
Audit existing tag-conditioned policies, privilege to mutate authorization tags
|
|
108
|
+
and the documented opt-out window before enabling it. Tag changes can become
|
|
109
|
+
privilege escalation when tag writers control their own access conditions.
|
|
110
|
+
`aws:ResourceTag`, `aws:RequestTag`, `aws:TagKeys` support varies by action/resource;
|
|
111
|
+
verify SAR rather than reusing conditions blindly. Disabled ABAC can change how
|
|
112
|
+
conditions evaluate; tags alone do not enable it.
|
|
113
|
+
|
|
114
|
+
Use the currently supported console/service interface to verify each ABAC status.
|
|
115
|
+
The inspected CLI 2.37.4 rejects `dynamodb get-abac-status` as an unknown operation;
|
|
116
|
+
IAM action names in docs are not evidence that a public CLI operation exists.
|
|
117
|
+
Do not fabricate that command or silently upgrade/install tooling to run it.
|
|
118
|
+
|
|
119
|
+
## Domain: resource-based and cross-account access
|
|
120
|
+
|
|
121
|
+
Use [table-resource-policy.json](../assets/table-resource-policy.json) as an
|
|
122
|
+
illustrative named-external-role read/query policy only. Attach to the **table**;
|
|
123
|
+
express index rights in its statements. A stream can have its own resource policy;
|
|
124
|
+
an index cannot have an independently attached policy.
|
|
125
|
+
|
|
126
|
+
Cross-account data access needs the owner resource policy **and** caller identity
|
|
127
|
+
policy, without applicable explicit deny. Address the owner's full table ARN,
|
|
128
|
+
not a bare name resolved in the caller account. Verify the operation support
|
|
129
|
+
matrix: resource-policy support does not imply cross-account support for every
|
|
130
|
+
API (e.g. policy administration, TTL/PITR settings and PartiQL differ from data
|
|
131
|
+
APIs). AWS-managed-key table encryption does not support this cross-account path;
|
|
132
|
+
customer-managed keys require reviewed cross-account KMS authorization.
|
|
133
|
+
|
|
134
|
+
```bash
|
|
135
|
+
# Owner-context read. Preserve the current document/revision before any change.
|
|
136
|
+
"${aws_target[@]}" dynamodb get-resource-policy --resource-arn "$TABLE_ARN"
|
|
137
|
+
: "${RESOURCE_POLICY_FILE:?Reviewed target-rendered resource policy JSON}"
|
|
138
|
+
: "${EXPECTED_REVISION_ID:?Actual observed revision, or confirmed NO_POLICY}"
|
|
139
|
+
# Owner-context approved mutation. Never force-remove your own management access.
|
|
140
|
+
"${aws_target[@]}" dynamodb put-resource-policy --resource-arn "$TABLE_ARN" \
|
|
141
|
+
--policy "file://$RESOURCE_POLICY_FILE" --expected-revision-id "$EXPECTED_REVISION_ID"
|
|
142
|
+
"${aws_target[@]}" dynamodb get-resource-policy --resource-arn "$TABLE_ARN"
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
Use `NO_POLICY` only after confirming no policy exists, not as fallback for access
|
|
146
|
+
denied, timeouts or revision conflicts. Revision mismatch/absence may both produce
|
|
147
|
+
PolicyNotFoundException. Reconcile first; do not retry a policy write blindly.
|
|
148
|
+
Keep prior policy and bounded propagation/readback expectations; successful policy
|
|
149
|
+
writes have an update interval restriction. Do not set
|
|
150
|
+
`--confirm-remove-self-resource-access` as an error workaround. A new explicit
|
|
151
|
+
deny can break global-table replication or administration; review service-linked
|
|
152
|
+
role paths too. CloudFormation-managed policy content does not guarantee drift
|
|
153
|
+
repair after an out-of-band edit. No deletion/lockout-bypass command is included.
|
|
154
|
+
|
|
155
|
+
## Separate permission domains
|
|
156
|
+
|
|
157
|
+
- [Streams/DAX](streams-and-dax.md): application DAX cluster actions, its service
|
|
158
|
+
role's DynamoDB rights and consumer stream rights are different paths.
|
|
159
|
+
- [Encryption](encryption.md): KMS key policy/grants are not implied by table IAM.
|
|
160
|
+
- [Recovery/replicas](recovery-and-replicas.md): restore/create/replication rights
|
|
161
|
+
and service-linked-role permissions do not belong in a CRUD-only role.
|
|
162
|
+
- [CloudWatch](monitoring.md): metric discovery/analysis, alarm writes, SNS delivery
|
|
163
|
+
and Lambda consumer telemetry are different namespaces/resources.
|
|
164
|
+
|
|
165
|
+
Primary evidence: [service authorization reference](https://docs.aws.amazon.com/service-authorization/latest/reference/list_dynamodb.html),
|
|
166
|
+
[table/index example](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/iam-policy-specific-table-indexes.html),
|
|
167
|
+
[fine-grained conditions](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/specifying-conditions.html),
|
|
168
|
+
[resource-policy APIs/support matrix](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-iam-actions.html),
|
|
169
|
+
[cross-account requirements](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/rbac-cross-account-access.html),
|
|
170
|
+
[PutResourcePolicy](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutResourcePolicy.html),
|
|
171
|
+
[table ABAC](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/attribute-based-access-control.html),
|
|
172
|
+
[stream ABAC](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/abac-streams.html),
|
|
173
|
+
[stream tags](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tagging.Streams.html).
|
|
@@ -0,0 +1,251 @@
|
|
|
1
|
+
# Language adapters: one service contract, many SDKs
|
|
2
|
+
|
|
3
|
+
## Shared contract
|
|
4
|
+
|
|
5
|
+
Use the project's installed SDK version and existing client lifecycle. Resolve its
|
|
6
|
+
current primary docs through Context7 before generating version-sensitive code;
|
|
7
|
+
do not install/upgrade as an implicit side effect. The examples below are small
|
|
8
|
+
integration excerpts, not full runnable projects or a promise of compilation in
|
|
9
|
+
every environment. No credentials are embedded; use workload identity/default
|
|
10
|
+
credential providers and explicit approved Region. Public tenant/cursor validation
|
|
11
|
+
happens before the internal SDK call.
|
|
12
|
+
|
|
13
|
+
[query-input.json](../assets/query-input.json) is the **low-level AttributeValue**
|
|
14
|
+
request for the base-table order list. Replace the table explicitly. Each example
|
|
15
|
+
returns one service page unless it shows a loop; never mistake that for all items.
|
|
16
|
+
The language-independent loop is:
|
|
17
|
+
|
|
18
|
+
```text
|
|
19
|
+
cursor = validated continuation, or absent
|
|
20
|
+
repeat within deadline and page budget:
|
|
21
|
+
page = Query(same table/index/key condition/order, ExclusiveStartKey=cursor)
|
|
22
|
+
process page.Items even if empty
|
|
23
|
+
cursor = page.LastEvaluatedKey
|
|
24
|
+
if cursor absent or empty: finish
|
|
25
|
+
return next cursor if API budget ended, or report incomplete stream
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Do not convert an empty page into end-of-list. Do not combine native-value document
|
|
29
|
+
clients with low-level `{S: ...}`/`{N: ...}` maps. All adapters must retain conditions,
|
|
30
|
+
error classification, precision, cancellation and operation identity—not only keys.
|
|
31
|
+
|
|
32
|
+
When filling a bounded HTTP match page, request at most the number of matches
|
|
33
|
+
still needed, or buffer surplus returned matches. Do not slice a response and
|
|
34
|
+
advance to its LastEvaluatedKey: that loses the matches you discarded. The
|
|
35
|
+
`matchingPage` export in the JS asset implements this remaining-count rule.
|
|
36
|
+
|
|
37
|
+
## JavaScript (AWS SDK v3)
|
|
38
|
+
|
|
39
|
+
Packages: `@aws-sdk/client-dynamodb` for low-level maps; optional
|
|
40
|
+
`@aws-sdk/lib-dynamodb` for native-value document commands. This version uses
|
|
41
|
+
**low-level** maps, matching the JSON asset and other languages:
|
|
42
|
+
|
|
43
|
+
```javascript
|
|
44
|
+
import { DynamoDBClient, QueryCommand } from "@aws-sdk/client-dynamodb";
|
|
45
|
+
import { queryPages } from "./assets/query-pages.mjs";
|
|
46
|
+
|
|
47
|
+
// Within an async application scope. client lifetime belongs to the application.
|
|
48
|
+
const client = new DynamoDBClient({ region: approvedRegion });
|
|
49
|
+
const input = {
|
|
50
|
+
TableName: approvedTable,
|
|
51
|
+
KeyConditionExpression: "#pk = :pk AND begins_with(#sk, :prefix)",
|
|
52
|
+
ExpressionAttributeNames: { "#pk": "PK", "#sk": "SK" },
|
|
53
|
+
ExpressionAttributeValues: {
|
|
54
|
+
":pk": { S: authorizedCustomerPK }, ":prefix": { S: "ORDER#" }
|
|
55
|
+
},
|
|
56
|
+
ConsistentRead: true, ScanIndexForward: false, Limit: 50
|
|
57
|
+
};
|
|
58
|
+
for await (const page of queryPages(
|
|
59
|
+
request => client.send(new QueryCommand(request)), input, { maxPages: 20 }
|
|
60
|
+
)) {
|
|
61
|
+
await consume(page.Items ?? []); // may be empty; queryPages still continues
|
|
62
|
+
}
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
This exhausts up to a page budget; a budget failure reports incomplete results.
|
|
66
|
+
For an HTTP page endpoint, return a signed/stored next cursor instead of draining
|
|
67
|
+
all pages. Pass cancellation/deadline through the application's SDK send adapter.
|
|
68
|
+
|
|
69
|
+
## TypeScript (AWS SDK v3)
|
|
70
|
+
|
|
71
|
+
Use the same JS algorithm; add SDK types instead of casting unknown JSON into
|
|
72
|
+
domain objects. Here is a typed **one-page** boundary:
|
|
73
|
+
|
|
74
|
+
```typescript
|
|
75
|
+
import { DynamoDBClient, QueryCommand } from "@aws-sdk/client-dynamodb";
|
|
76
|
+
import type { QueryCommandInput, QueryCommandOutput } from "@aws-sdk/client-dynamodb";
|
|
77
|
+
|
|
78
|
+
export async function queryOrderPage(
|
|
79
|
+
client: DynamoDBClient, input: QueryCommandInput
|
|
80
|
+
): Promise<QueryCommandOutput> {
|
|
81
|
+
return client.send(new QueryCommand(input));
|
|
82
|
+
}
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Validate decoded items into a domain schema. For `DynamoDBDocumentClient` use
|
|
86
|
+
commands/types from `@aws-sdk/lib-dynamodb` and native values (`":pk": pk`, **not**
|
|
87
|
+
`{S: pk}`). Choose marshalling rules for undefined/null, sets, binary and big/decimal
|
|
88
|
+
numbers. JS `number` cannot represent every DynamoDB Number exactly; configure
|
|
89
|
+
lossless wrappers or explicit numeric strings/decimals and validate at boundaries.
|
|
90
|
+
|
|
91
|
+
## Java (AWS SDK for Java 2.x)
|
|
92
|
+
|
|
93
|
+
Dependency: `software.amazon.awssdk:dynamodb` managed by the project's pinned BOM.
|
|
94
|
+
Do not confuse legacy `com.amazonaws.services.dynamodbv2` with Java SDK 2.x.
|
|
95
|
+
The excerpt uses Java 9+ `Map.of`; on Java 8 populate maps explicitly instead.
|
|
96
|
+
Caller supplies a reusable `DynamoDbClient`, approved table, authorized PK and
|
|
97
|
+
validated low-level cursor. Import `java.util.Map` and
|
|
98
|
+
`software.amazon.awssdk.services.dynamodb.model.*`:
|
|
99
|
+
|
|
100
|
+
```java
|
|
101
|
+
static QueryResponse orderPage(
|
|
102
|
+
DynamoDbClient client, String table, String pk,
|
|
103
|
+
Map<String, AttributeValue> cursor) {
|
|
104
|
+
QueryRequest.Builder req = QueryRequest.builder()
|
|
105
|
+
.tableName(table)
|
|
106
|
+
.keyConditionExpression("#pk = :pk AND begins_with(#sk, :prefix)")
|
|
107
|
+
.expressionAttributeNames(Map.of("#pk", "PK", "#sk", "SK"))
|
|
108
|
+
.expressionAttributeValues(Map.of(
|
|
109
|
+
":pk", AttributeValue.builder().s(pk).build(),
|
|
110
|
+
":prefix", AttributeValue.builder().s("ORDER#").build()))
|
|
111
|
+
.consistentRead(true).scanIndexForward(false).limit(50);
|
|
112
|
+
if (cursor != null && !cursor.isEmpty()) req.exclusiveStartKey(cursor);
|
|
113
|
+
return client.query(req.build());
|
|
114
|
+
}
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
Also import `software.amazon.awssdk.services.dynamodb.DynamoDbClient`.
|
|
118
|
+
Continue using `response.lastEvaluatedKey()`; alternatively use `queryPaginator`
|
|
119
|
+
with explicit application work/deadline bounds. Enhanced Client is optional; its
|
|
120
|
+
bean mapping is not the low-level API. Use `BigDecimal`/exact mappings for numbers.
|
|
121
|
+
|
|
122
|
+
## Kotlin (AWS SDK for Kotlin)
|
|
123
|
+
|
|
124
|
+
Dependency: `aws.sdk.kotlin:dynamodb`, version pinned by the project. Use the native
|
|
125
|
+
Kotlin suspend API or deliberately reuse Java 2.x; do not mix their model types.
|
|
126
|
+
|
|
127
|
+
```kotlin
|
|
128
|
+
import aws.sdk.kotlin.services.dynamodb.DynamoDbClient
|
|
129
|
+
import aws.sdk.kotlin.services.dynamodb.model.AttributeValue
|
|
130
|
+
import aws.sdk.kotlin.services.dynamodb.model.QueryRequest
|
|
131
|
+
import aws.sdk.kotlin.services.dynamodb.model.QueryResponse
|
|
132
|
+
|
|
133
|
+
suspend fun orderPage(
|
|
134
|
+
client: DynamoDbClient, table: String, pk: String,
|
|
135
|
+
cursor: Map<String, AttributeValue>? = null
|
|
136
|
+
): QueryResponse = client.query(QueryRequest {
|
|
137
|
+
tableName = table
|
|
138
|
+
keyConditionExpression = "#pk = :pk AND begins_with(#sk, :prefix)"
|
|
139
|
+
expressionAttributeNames = mapOf("#pk" to "PK", "#sk" to "SK")
|
|
140
|
+
expressionAttributeValues = mapOf(
|
|
141
|
+
":pk" to AttributeValue.S(pk), ":prefix" to AttributeValue.S("ORDER#")
|
|
142
|
+
)
|
|
143
|
+
consistentRead = true
|
|
144
|
+
scanIndexForward = false
|
|
145
|
+
limit = 50
|
|
146
|
+
if (!cursor.isNullOrEmpty()) exclusiveStartKey = cursor
|
|
147
|
+
})
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
Continue while `!response.lastEvaluatedKey.isNullOrEmpty()`; propagate coroutine
|
|
151
|
+
cancellation, close the client at its owning lifecycle boundary, and avoid blocking
|
|
152
|
+
Java clients on coroutine event loops. SDK Number representations need exact parsing.
|
|
153
|
+
|
|
154
|
+
## Rust (AWS SDK for Rust)
|
|
155
|
+
|
|
156
|
+
Dependency: project-pinned `aws-sdk-dynamodb` and a compatible `aws-config`/runtime.
|
|
157
|
+
Accept a configured client and preserve typed `AttributeValue`; this async excerpt
|
|
158
|
+
returns one page and propagates an error instead of panicking:
|
|
159
|
+
|
|
160
|
+
```rust
|
|
161
|
+
use aws_sdk_dynamodb::{Client, types::AttributeValue};
|
|
162
|
+
use aws_sdk_dynamodb::operation::query::QueryOutput;
|
|
163
|
+
use std::collections::HashMap;
|
|
164
|
+
|
|
165
|
+
async fn order_page(
|
|
166
|
+
client: &Client, table: &str, pk: &str,
|
|
167
|
+
cursor: Option<HashMap<String, AttributeValue>>,
|
|
168
|
+
) -> Result<QueryOutput, Box<dyn std::error::Error + Send + Sync>> {
|
|
169
|
+
let page = client.query()
|
|
170
|
+
.table_name(table)
|
|
171
|
+
.key_condition_expression("#pk = :pk AND begins_with(#sk, :prefix)")
|
|
172
|
+
.expression_attribute_names("#pk", "PK")
|
|
173
|
+
.expression_attribute_names("#sk", "SK")
|
|
174
|
+
.expression_attribute_values(":pk", AttributeValue::S(pk.into()))
|
|
175
|
+
.expression_attribute_values(":prefix", AttributeValue::S("ORDER#".into()))
|
|
176
|
+
.consistent_read(true).scan_index_forward(false).limit(50)
|
|
177
|
+
.set_exclusive_start_key(cursor.filter(|key| !key.is_empty()))
|
|
178
|
+
.send().await?;
|
|
179
|
+
Ok(page)
|
|
180
|
+
}
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
Continue with nonempty `last_evaluated_key`; do not assume items or keys are always
|
|
184
|
+
present. Preserve `AttributeValue::N(String)` exactly and handle binary explicitly.
|
|
185
|
+
The boxed error keeps the excerpt small; production code should inspect SDK service
|
|
186
|
+
errors and preserve retry/condition/unknown-outcome distinctions.
|
|
187
|
+
|
|
188
|
+
## PHP (AWS SDK for PHP v3)
|
|
189
|
+
|
|
190
|
+
Dependency: `aws/aws-sdk-php` with the project's lockfile. Caller supplies
|
|
191
|
+
`Aws\DynamoDb\DynamoDbClient`; low-level values are typed arrays:
|
|
192
|
+
|
|
193
|
+
```php
|
|
194
|
+
function orderPage(\Aws\DynamoDb\DynamoDbClient $client, string $table,
|
|
195
|
+
string $pk, array $cursor = []): \Aws\Result {
|
|
196
|
+
$request = [
|
|
197
|
+
'TableName' => $table,
|
|
198
|
+
'KeyConditionExpression' => '#pk = :pk AND begins_with(#sk, :prefix)',
|
|
199
|
+
'ExpressionAttributeNames' => ['#pk' => 'PK', '#sk' => 'SK'],
|
|
200
|
+
'ExpressionAttributeValues' => [
|
|
201
|
+
':pk' => ['S' => $pk], ':prefix' => ['S' => 'ORDER#']
|
|
202
|
+
],
|
|
203
|
+
'ConsistentRead' => true, 'ScanIndexForward' => false, 'Limit' => 50
|
|
204
|
+
];
|
|
205
|
+
if ($cursor !== []) $request['ExclusiveStartKey'] = $cursor;
|
|
206
|
+
return $client->query($request);
|
|
207
|
+
}
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
Continue with `$page['LastEvaluatedKey'] ?? []` until empty; do not stop on an empty
|
|
211
|
+
Items array. `Aws\DynamoDb\Marshaler` is optional: do not double-marshal or turn
|
|
212
|
+
exact Number strings into floats/overflowing platform integers. Catch typed SDK
|
|
213
|
+
exceptions at the application boundary, not by swallowing all failures as empty lists.
|
|
214
|
+
|
|
215
|
+
## Python, Go, C#, Ruby, C++ and other languages
|
|
216
|
+
|
|
217
|
+
Language-neutral support means preserving the service contract, not translating
|
|
218
|
+
method names by intuition. For any other language:
|
|
219
|
+
|
|
220
|
+
1. Resolve its supported AWS SDK and installed version through Context7/current
|
|
221
|
+
primary docs. Prefer the native official SDK; if absent, disclose that gap and
|
|
222
|
+
use a documented compatible client/SigV4 implementation, not handwritten auth.
|
|
223
|
+
2. Map `Query`, typed values, expression aliases, cursor and service errors using
|
|
224
|
+
that client's actual API. For example, boto3's low-level client uses typed maps;
|
|
225
|
+
its resource layer uses native values and `Decimal`, not Python floats.
|
|
226
|
+
3. Reuse the same key fixtures, pagination and concurrent-write tests. Match number,
|
|
227
|
+
binary/set/null/absent encoding. For Go/C# inspect null/empty cursor behavior;
|
|
228
|
+
don't assume it matches JS. Verify paginator laziness, cancellation and retries.
|
|
229
|
+
4. Compile/test in the target dependency lockfile/runtime. If unavailable, label
|
|
230
|
+
examples uncompiled rather than advertising universal runtime compatibility.
|
|
231
|
+
|
|
232
|
+
## Optional DynamoDB Toolbox (JS/TS only)
|
|
233
|
+
|
|
234
|
+
The supplied inspiration explicitly targets **Toolbox v2**. Toolbox is a JS/TS
|
|
235
|
+
query/schema layer over AWS SDK clients, not an AWS service feature or a Java,
|
|
236
|
+
Kotlin, Rust or PHP library. Do not prescribe it to other languages.
|
|
237
|
+
|
|
238
|
+
Inspect `package.json` and lockfile first; resolve that version's primary docs
|
|
239
|
+
through Context7. Check import paths, schema `item`/other constructors, `Entity`,
|
|
240
|
+
`Table`, `.build()` command API, hidden physical keys, pagination and marshalling
|
|
241
|
+
before writing code. Do not mix v1 `attributes`/`schema` examples with v2 (or assume
|
|
242
|
+
current unversioned docs equal v2). First demonstrate equivalent low-level requests,
|
|
243
|
+
then add a wrapper only when the user/project wants it. Wrapper schema validation
|
|
244
|
+
does not create database uniqueness, strong GSI reads or new transaction guarantees.
|
|
245
|
+
|
|
246
|
+
Primary references: [JS v3](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/javascript_dynamodb_code_examples.html),
|
|
247
|
+
[Java 2.x](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProgrammingWithJava.html),
|
|
248
|
+
[Kotlin](https://docs.aws.amazon.com/sdk-for-kotlin/latest/developer-guide/kotlin_dynamodb_code_examples.html),
|
|
249
|
+
[Rust](https://docs.aws.amazon.com/sdk-for-rust/latest/dg/rust_dynamodb_code_examples.html),
|
|
250
|
+
[PHP v3](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/php_dynamodb_code_examples.html),
|
|
251
|
+
[Toolbox](https://www.dynamodbtoolbox.com/).
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
# LSI vs GSI decision guide
|
|
2
|
+
|
|
3
|
+
Start from the request's partition scope and freshness requirement—not “local is
|
|
4
|
+
faster” or “global is unlimited.” First check whether the existing table key can
|
|
5
|
+
serve the query; every added index creates write/storage and operational costs.
|
|
6
|
+
|
|
7
|
+
## Decision sequence
|
|
8
|
+
|
|
9
|
+
1. **Different partition-key attribute or regrouping across customers?** An LSI
|
|
10
|
+
cannot do it; consider a GSI, materialized view or a different primary model.
|
|
11
|
+
A GSI may also reuse the base partition-key attribute—it need not differ.
|
|
12
|
+
2. **Same partition key, different ordering, strong read required?** An LSI is a
|
|
13
|
+
candidate only at **new-table creation**, if the whole item collection is
|
|
14
|
+
demonstrably bounded below 10 GB. A GSI is not a strong-read substitute.
|
|
15
|
+
3. **Already-deployed table without that LSI?** No retrofit. Use an eventual GSI
|
|
16
|
+
if freshness permits; otherwise redesign the authoritative base-key path or
|
|
17
|
+
plan an explicitly approved data migration. Do not silently recreate a table.
|
|
18
|
+
4. **Unbounded collection, unknown growth or throughput isolation needed?** Reject
|
|
19
|
+
the LSI by default. Evaluate a GSI or re-key/bucket the base model, accounting
|
|
20
|
+
for query fan-out. Do not promise strong alternate-key reads from an eventual GSI.
|
|
21
|
+
5. **Cross-partition lookup plus mandatory strong discovery?** Neither an LSI nor
|
|
22
|
+
an ordinary GSI query solves it. An eventual index followed by strong GetItem
|
|
23
|
+
can validate discovered rows but cannot discover rows still missing from it.
|
|
24
|
+
|
|
25
|
+
## Comparison
|
|
26
|
+
|
|
27
|
+
| Criterion | LSI | GSI |
|
|
28
|
+
|---|---|---|
|
|
29
|
+
| Partition key | Exactly the base-table partition-key attribute | Can reuse it or use a different key attribute |
|
|
30
|
+
| Sort key | Required alternate sort key; base table must have a sort key | Optional; partition-only or composite index |
|
|
31
|
+
| Query scope | One known base PK value | One known index PK value; can regroup data from different base PKs |
|
|
32
|
+
| Consistency | Eventual or strong via ConsistentRead | Eventual only; true is rejected |
|
|
33
|
+
| Lifecycle | Define at table creation; cannot add or delete later | Create with table or add/delete online, with backfill/impact review |
|
|
34
|
+
| Size boundary | 10 GB per item collection: base items **plus all LSI entries** sharing a PK value | No LSI-style 10 GB item-collection limit; ordinary service/item/partition limits remain |
|
|
35
|
+
| Provisioned capacity | Reads/writes share the table's allocation | Separate index read/write allocation; overload can still back-pressure base writes |
|
|
36
|
+
| On-demand mode | Table request accounting; no provisioned allocation to set | On-demand index requests still cost money and have limits/hot keys |
|
|
37
|
+
| Unprojected attributes | Can fetch from base table, with additional read/latency cost | Cannot fetch automatically; project fields or issue explicit base reads |
|
|
38
|
+
| Default index count | Up to 5 LSIs/table | Default 20 GSIs/table; verify current adjustable quota |
|
|
39
|
+
| Key uniqueness | Alternate sort values need not be unique | Index key combinations need not be unique |
|
|
40
|
+
| Encryption | Inherits the table key | Inherits the table key; not independently selectable |
|
|
41
|
+
|
|
42
|
+
“Global” does **not** mean global cross-Region strong consistency or an arbitrary
|
|
43
|
+
cross-partition query. Query still requires equality on one index partition key.
|
|
44
|
+
An LSI is not an independently scalable copy of the table and constrains how the
|
|
45
|
+
item collection can be split. Near-limit growth is a design problem, not something
|
|
46
|
+
TTL's delayed deletion or on-demand billing guarantees will solve.
|
|
47
|
+
Native vector indexes are a separate access path with SearchVectors, but they
|
|
48
|
+
also consume the table's GSI quota. See [data types and vectors](data-types-and-vectors.md)
|
|
49
|
+
before assuming the GSI quota is entirely available for ordinary secondary indexes.
|
|
50
|
+
|
|
51
|
+
## Worked choices in this skill's model
|
|
52
|
+
|
|
53
|
+
### New, bounded customer history; strongly read most recently updated orders
|
|
54
|
+
|
|
55
|
+
- Base PK: `TENANT#acme#CUSTOMER#c42`; base SK remains immutable order creation key.
|
|
56
|
+
- Alternate `LSI1SK`: `UPDATED#2026-01-03T09:00:00.000Z#o100` only on order items.
|
|
57
|
+
- Candidate: LSI1 with HASH `PK`, RANGE `LSI1SK`, INCLUDE `status`, `orderId`.
|
|
58
|
+
- It is valid only if PK-level base+all-LSI growth is bounded and strong updated
|
|
59
|
+
ordering is worth permanent capacity/storage coupling. Include a stable tie-break
|
|
60
|
+
ID in the alternate string, rather than relying on unspecified equal-key order.
|
|
61
|
+
- Maintain LSI1SK alongside each relevant update, including close/reopen; lexical
|
|
62
|
+
time ordering requires fixed-width UTC. The example put/close in Commands targets
|
|
63
|
+
the **default** table; adapt writes deliberately before using this alternative.
|
|
64
|
+
|
|
65
|
+
The [new-table CLI asset](../assets/create-table-with-lsi.json) contains the complete
|
|
66
|
+
base/GSI/LSI key definitions. For CloudFormation, the equivalent **property fragment**
|
|
67
|
+
below belongs in a new table's Properties along with the original definitions:
|
|
68
|
+
|
|
69
|
+
```yaml
|
|
70
|
+
# Append {AttributeName: LSI1SK, AttributeType: S} to AttributeDefinitions.
|
|
71
|
+
LocalSecondaryIndexes:
|
|
72
|
+
- IndexName: LSI1
|
|
73
|
+
KeySchema:
|
|
74
|
+
- AttributeName: PK
|
|
75
|
+
KeyType: HASH
|
|
76
|
+
- AttributeName: LSI1SK
|
|
77
|
+
KeyType: RANGE
|
|
78
|
+
Projection:
|
|
79
|
+
ProjectionType: INCLUDE
|
|
80
|
+
NonKeyAttributes: [status, orderId]
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
This is not a standalone template, nor a permitted update to an existing table.
|
|
84
|
+
The default `table.cfn.yaml` is intentionally left without an LSI.
|
|
85
|
+
|
|
86
|
+
### All open orders for a tenant, across customers
|
|
87
|
+
|
|
88
|
+
Choose a sparse GSI keyed by `TENANT#acme#STATUS#OPEN`, not an LSI on the customer
|
|
89
|
+
PK. Accept index lag and atomically maintain/remove GSI keys. A dominant tenant
|
|
90
|
+
can still create a hot index key; shard only with fan-out/merge/cursor design.
|
|
91
|
+
|
|
92
|
+
### Existing large customer history; add a new sort order
|
|
93
|
+
|
|
94
|
+
Do not add an LSI—it is impossible online, and an unbounded collection violates
|
|
95
|
+
its design constraint. If eventual discovery is acceptable, evaluate a new GSI
|
|
96
|
+
(which may reuse the customer PK) and backfill/readiness checks. If strong alternate
|
|
97
|
+
reads are essential, redesign the base layout/migrate; state that cost explicitly.
|
|
98
|
+
|
|
99
|
+
## Decision record and adversarial probes
|
|
100
|
+
|
|
101
|
+
Record chosen/rejected index, request scope/freshness, projected fields, largest
|
|
102
|
+
collection estimate and growth, read/write coupling/skew, and rollout/rollback.
|
|
103
|
+
Reject these proposals explicitly:
|
|
104
|
+
|
|
105
|
+
- “Add an LSI tomorrow on the existing table.” No online operation exists.
|
|
106
|
+
- “Use ConsistentRead=true on the GSI.” It does not enable strong reads.
|
|
107
|
+
- “12 GB for this customer's base+LSIs is okay because billing is on-demand.” No.
|
|
108
|
+
- “Make the LSI partition key tenant-wide instead of customer.” That is a GSI-like
|
|
109
|
+
regrouping, not an LSI on this base table.
|
|
110
|
+
- “Changing the index projection encrypts it with its own KMS key.” Both indexes
|
|
111
|
+
share table encryption; see [Encryption](encryption.md).
|
|
112
|
+
|
|
113
|
+
Sources: [AWS comparison](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/SecondaryIndexes.html),
|
|
114
|
+
[LSI behavior/collections](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LSI.html),
|
|
115
|
+
[GSI behavior](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html),
|
|
116
|
+
[index quotas](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ServiceQuotas.html).
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
# Semiannual content review reminder
|
|
2
|
+
|
|
3
|
+
Review this skill **every June and December**, starting on the first of each
|
|
4
|
+
month. Windows are six months apart, aligned to the calendar—not six months after
|
|
5
|
+
an arbitrary edit. The initial next window is **1 December 2026**. A missed window
|
|
6
|
+
stays overdue until a real full review is completed and recorded.
|
|
7
|
+
|
|
8
|
+
## Local reminder, not a background schedule
|
|
9
|
+
|
|
10
|
+
At the start of substantive skill use, run the read-only helper using the user's
|
|
11
|
+
current local/client date. For example, from this skill directory:
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
python3 scripts/review_due.py --as-of 2026-11-08
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Replace that example date with the actual date. Output is not_due before the
|
|
18
|
+
window, due throughout that June/December, and overdue after an uncompleted
|
|
19
|
+
window. In June 2027, an uncompleted December 2026 review is **still overdue**;
|
|
20
|
+
merely loading the skill never advances the ledger.
|
|
21
|
+
|
|
22
|
+
If due/overdue, remind the user and refresh the time-sensitive claims needed for
|
|
23
|
+
their current task before relying on them. Propose the broader full review; do
|
|
24
|
+
not turn an unrelated bug fix into an unapproved portfolio rewrite.
|
|
25
|
+
|
|
26
|
+
The helper does not write files, send notifications, register crons/calendar
|
|
27
|
+
events, access AWS or schedule an agent. An external notification requires a
|
|
28
|
+
separately requested, available scheduling facility and explicit target/time.
|
|
29
|
+
|
|
30
|
+
## Full review checklist
|
|
31
|
+
|
|
32
|
+
1. Use exposed AWS documentation MCP and Context7 plus current AWS release notes.
|
|
33
|
+
Record verification dates and primary URLs; distinguish service availability
|
|
34
|
+
from installed SDK/CLI/CloudFormation support.
|
|
35
|
+
2. Re-check data types, native vector/index APIs, dimensions/quotas, capacity,
|
|
36
|
+
consistency, filters and unsupported features. Do not assume yesterday's
|
|
37
|
+
“no native vector support” or search-as-new-primitive claim is still correct.
|
|
38
|
+
3. Re-check IAM action/resource/condition mappings, resource policies, cross-account
|
|
39
|
+
access, table/stream tagging and ABAC, KMS ownership and backup dependencies.
|
|
40
|
+
4. Re-check Streams, DAX clients/cache semantics, PITR/restore, MREC/MRSC/replica
|
|
41
|
+
settings and Region support, CloudWatch dimensions/statistics and alarm behavior.
|
|
42
|
+
5. Reconcile conflicting sources explicitly. Validate all affected examples and
|
|
43
|
+
regression/negative cases; inspect diffs against the approved maintenance scope.
|
|
44
|
+
Do not convert simulated calls into live service proof or silently install tools.
|
|
45
|
+
6. Update version/changelog and sources for actual content changes. After the full
|
|
46
|
+
audit passes, record last_full_review and the next future June/December first
|
|
47
|
+
in [content-review.json](../assets/content-review.json). For a full review
|
|
48
|
+
completed on 15 December 2026, next_review_due becomes 2027-06-01; one completed
|
|
49
|
+
on 30 June 2027 produces 2027-12-01. A late January review also next targets June.
|
|
50
|
+
|
|
51
|
+
The initial last_full_review is null deliberately: a targeted capability update
|
|
52
|
+
is not proof that every old topic was re-audited. last_targeted_review records
|
|
53
|
+
focused work only and does not reset the semiannual deadline. Trigger a targeted
|
|
54
|
+
refresh immediately for a relevant AWS announcement/API mismatch or source conflict;
|
|
55
|
+
do not wait six months to correct a known defect. Do not update the ledger on an
|
|
56
|
+
unrun, partial or failed review.
|