@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
package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md
ADDED
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
# Evidence ledger — Amazon DynamoDB
|
|
2
|
+
|
|
3
|
+
Every material claim in
|
|
4
|
+
[consistency-indexing-replication.md](consistency-indexing-replication.md)
|
|
5
|
+
cites one row below as `[DDB-Exx]`. `tests/validate-skill-references.py` fails
|
|
6
|
+
the build if a citation has no row, a row is never cited, or a source is not
|
|
7
|
+
an allow-listed AWS documentation host.
|
|
8
|
+
|
|
9
|
+
Scope: Amazon DynamoDB (key-value/document), current Developer Guide and API
|
|
10
|
+
Reference. Not Amazon DocumentDB or Amazon Keyspaces. `VERIFIED` = the section
|
|
11
|
+
was retrieved on the retrieval date and supports the claim as worded; it is
|
|
12
|
+
documentation verification, not a behavioral test. Region lists and quotas
|
|
13
|
+
are volatile: re-fetch before relying on them.
|
|
14
|
+
|
|
15
|
+
| ID | Claim | Source | Section | Retrieved | Status |
|
|
16
|
+
| --- | --- | --- | --- | --- | --- |
|
|
17
|
+
| DDB-E01 | Tables and LSIs support eventually consistent (default) and strongly consistent reads; all reads from GSIs and DynamoDB Streams are eventually consistent. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadConsistency.html> | DynamoDB read consistency | 2026-11-08 | VERIFIED |
|
|
18
|
+
| DDB-E02 | Eventually consistent reads are half the cost of strongly consistent reads; strong reads are requested with `ConsistentRead=true` on GetItem, Query and Scan. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadConsistency.html> | DynamoDB read consistency | 2026-11-08 | VERIFIED |
|
|
19
|
+
| DDB-E03 | LSIs: up to five per table, same partition key as the base table, sort key of exactly one scalar attribute, and created only at table creation (CreateTable `LocalSecondaryIndexes`). | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LSI.html> | Local secondary indexes | 2026-11-08 | VERIFIED |
|
|
20
|
+
| DDB-E04 | Tables with one or more LSIs have a 10 GB limit per partition key value, counting base-table items plus index items; exceeding it can raise ItemCollectionSizeLimitExceededException and block writes to that collection. The limit does not apply to tables without LSIs or to item collections in GSIs. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LSI.html> | Item collections in Local Secondary Indexes | 2026-11-08 | VERIFIED |
|
|
21
|
+
| DDB-E05 | LSI queries can fetch non-projected attributes from the base table at extra latency and throughput cost; GSI queries cannot fetch non-projected attributes. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/LSI.html> | Attribute projections | 2026-11-08 | VERIFIED |
|
|
22
|
+
| DDB-E06 | A GSI key schema can differ entirely from the table's; GSI key values need not be unique; items lacking the index key attributes are not written to the index (sparse index). | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html> | Using Global Secondary Indexes in DynamoDB | 2026-11-08 | VERIFIED |
|
|
23
|
+
| DDB-E07 | GSIs inherit the table capacity mode; in provisioned mode a GSI has separate throughput, and insufficient GSI write capacity throttles writes to the base table; AWS advises GSI write capacity at least equal to the table's. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html> | Provisioned throughput considerations for Global Secondary Indexes | 2026-11-08 | VERIFIED |
|
|
24
|
+
| DDB-E08 | Each GSI adds write cost and storage (index key, projected attributes and 100 bytes overhead per index item); more GSIs mean higher write cost. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html> | Storage considerations for Global Secondary Indexes | 2026-11-08 | VERIFIED |
|
|
25
|
+
| DDB-E09 | GSIs support multi-attribute keys: up to four partition-key and four sort-key attributes; queries need equality on all partition-key attributes and left-to-right sort-key conditions, and an inequality (>, <, BETWEEN, begins_with) must be the last condition. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/GSI.html> | Multi-attribute key schema | 2026-11-08 | VERIFIED |
|
|
26
|
+
| DDB-E10 | Global tables have two consistency modes, MREC (default) and MRSC; all replicas share one mode and the mode cannot be changed after creation. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Consistency modes | 2026-11-08 | VERIFIED |
|
|
27
|
+
| DDB-E11 | MREC replicates asynchronously, typically within a second; simultaneous writes resolve per item by last writer wins; a strong read returns the latest version only if the item was last written in the reading Region; conditional writes evaluate the local version; replicas can be added or removed. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Multi-Region eventual consistency (MREC) | 2026-11-08 | VERIFIED |
|
|
28
|
+
| DDB-E12 | MRSC replicates synchronously to at least one other Region before acknowledging; strong reads on any replica return the latest version and conditional writes evaluate the latest version; it needs exactly three Regions (three replicas, or two replicas plus a witness) from a published Region list; write and strong-read latency depend on the chosen Regions because they need cross-Region communication. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Multi-Region strong consistency (MRSC) | 2026-11-08 | VERIFIED |
|
|
29
|
+
| DDB-E13 | MRSC conversion requires an empty table; replicas cannot be added later and a single replica or witness cannot be removed (deleting two replicas, or one replica and the witness, converts the remainder to a single-Region table); concurrent cross-Region writes to one item fail with a retryable ReplicatedWriteConflictException. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Multi-Region strong consistency (MRSC) | 2026-11-08 | VERIFIED |
|
|
30
|
+
| DDB-E14 | MRSC does not support TTL, LSIs or transaction operations, and publishes no ReplicationLatency metric; GSIs are supported and remain eventually consistent. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Considerations; Transactions | 2026-11-08 | VERIFIED |
|
|
31
|
+
| DDB-E15 | On MREC global tables, TransactWriteItems/TransactGetItems are atomic only in the invoking Region; other Regions can observe partially applied transactions while replicating. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Transactions | 2026-11-08 | VERIFIED |
|
|
32
|
+
| DDB-E16 | MREC replicas have Streams enabled and they cannot be disabled; their ordering is per item and can differ between replicas. MRSC replicas do not enable Streams by default but can, and their stream records are identical on every replica, including order. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Streams | 2026-11-08 | VERIFIED |
|
|
33
|
+
| DDB-E17 | DAX is a write-through cache: strongly consistent reads and TransactGetItems are passed through to DynamoDB and not cached; the query cache is not invalidated by item updates; writes that bypass DAX leave the item cache stale until eviction. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.consistency.html> | DAX and DynamoDB consistency models | 2026-11-08 | VERIFIED |
|
|
34
|
+
| DDB-E18 | UpdateTable `GlobalSecondaryIndexUpdates` can create a new GSI on an existing table; only one GSI can be created or deleted per UpdateTable operation. | <https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html> | GlobalSecondaryIndexUpdates | 2026-11-08 | VERIFIED |
|
|
35
|
+
| DDB-E19 | Default quotas: 20 GSIs per table and up to 5 LSIs per table. Up to 100 user-specified projected attributes combined across all secondary indexes: the limit counts INCLUDE `NonKeyAttributes` only (the same attribute in two indexes counts twice) and does not apply to KEYS_ONLY or ALL projections. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ServiceQuotas.html> | Secondary indexes | 2026-11-08 | VERIFIED |
|
|
36
|
+
| DDB-E20 | MREC RPO equals the replication delay (usually seconds); MRSC supports an RPO of zero; deletion protection and point-in-time recovery are never synchronized between replicas; writes to global table replicas bypass DAX, so DAX caches on replicas refresh only when their TTL expires. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | RPO; settings synchronization; DAX | 2026-11-08 | VERIFIED |
|
|
37
|
+
| DDB-E21 | DAX pricing, DAX cluster sizing, and whether MREC global tables support LSIs (the page states only the MRSC restriction) were not retrieved in this pass. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/DAX.consistency.html> | DAX and DynamoDB consistency models | 2026-11-08 | UNVERIFIED |
|
|
38
|
+
| DDB-E22 | MREC global tables support TTL deletion; a TTL delete in one Region's replica is replicated to all other replicas. | <https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/V2globaltables_HowItWorks.html> | Time To Live | 2026-11-08 | VERIFIED |
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
# Changelog
|
|
2
|
+
|
|
3
|
+
## 1.8.0 — 2026-11-08
|
|
4
|
+
|
|
5
|
+
- Add separate lazy design/refactor commands, real slash/local router support,
|
|
6
|
+
README triggers/combinations and help routes without expanding execution scope.
|
|
7
|
+
- Cover access-pattern-first table design, code/item updates vs schema migration,
|
|
8
|
+
conditional upserts, online-index readiness and bounded data-preserving cutover.
|
|
9
|
+
- Add separate backup/restore routes with PITR defaults and lazy method-specific
|
|
10
|
+
native backup CLI examples; guard source identity, recovery window/readiness,
|
|
11
|
+
distinct new targets, settings validation and business RPO/RTO acceptance.
|
|
12
|
+
|
|
13
|
+
## 1.7.1 — 2026-11-08
|
|
14
|
+
|
|
15
|
+
- Add human README tables for command triggers, feature bundles and manual workflow
|
|
16
|
+
combinations; keep approval boundaries explicit and examples parser-checked.
|
|
17
|
+
- Shorten SKILL.md to tabular command/task dispatch with essential safety/reminder
|
|
18
|
+
rules; preserve the detailed design/implementation sequence in lazy workflow.md.
|
|
19
|
+
|
|
20
|
+
## 1.7.0 — 2026-11-08
|
|
21
|
+
|
|
22
|
+
- Organize per-command instructions and AWS CLI companions under references/commands/,
|
|
23
|
+
with direct lazy entry dispatch instead of one combined mode procedure.
|
|
24
|
+
- Split audit into offline/local evidence and authorized live-metadata transports;
|
|
25
|
+
add --mode offline/live while preserving legacy --evidence aliases.
|
|
26
|
+
- Accept /aws-dynamodb-patterns as an optional local-selector prefix without claiming
|
|
27
|
+
host registration. Add route-isolation and fake live-read/account/principal guards.
|
|
28
|
+
|
|
29
|
+
## 1.6.0 — 2026-11-08
|
|
30
|
+
|
|
31
|
+
- Add stateless offline select/audit/performance-test/feature-plan command routing
|
|
32
|
+
with selected-only lazy references, positive plan caps and fail-closed inputs.
|
|
33
|
+
- Add scoped audit, bounded performance-testing and feature-change workflows;
|
|
34
|
+
separate mode selection, plans, authorization and actual AWS/runtime evidence.
|
|
35
|
+
- Reject unsupported toggle combinations, including encryption disable, without
|
|
36
|
+
introducing a load engine, persistent activation state or automatic deployment.
|
|
37
|
+
|
|
38
|
+
## 1.5.0 — 2026-11-08
|
|
39
|
+
|
|
40
|
+
- Keep embedding theory and CLI commands on separate selective-loading routes.
|
|
41
|
+
- Add checked Titan input and explicit-target model/native/S3 vector/KB command
|
|
42
|
+
examples, reusing the existing f32 validator rather than duplicating it.
|
|
43
|
+
- Add actual-snippet fake-CLI tests for payloads, quoting, unsafe targets, invalid
|
|
44
|
+
embeddings and incomplete ingestion; retain existing schemas and runtime limits.
|
|
45
|
+
|
|
46
|
+
## 1.4.0 — 2026-11-08
|
|
47
|
+
|
|
48
|
+
- Explain embedding coordinates vs source references, float32 range/significant
|
|
49
|
+
digits/rounding and conservative overflow/underflow checks.
|
|
50
|
+
- Distinguish native DynamoDB, ordinary S3, S3 Vectors and managed Knowledge Bases;
|
|
51
|
+
add an injected-client Titan V2 ingestion/search example with offline tests.
|
|
52
|
+
- Challenge model mixing, stale content, tenant-filter authorization and unmeasured
|
|
53
|
+
quality/cost assumptions without provisioning or changing existing table assets.
|
|
54
|
+
|
|
55
|
+
## 1.3.0 — 2026-11-08
|
|
56
|
+
|
|
57
|
+
- Add June/December content-review reminder, read-only due-status helper and
|
|
58
|
+
honest full-versus-targeted review ledger; no external scheduler created.
|
|
59
|
+
- Document all AttributeValue families and native vector search as ordered numeric
|
|
60
|
+
lists plus vector indexes, not a new VECTOR primitive or mandatory OpenSearch.
|
|
61
|
+
- Add matched optional vector CLI/CFN fixtures, SearchVectors/IAM examples and
|
|
62
|
+
adversarial tests; record strict E3039 incompatibility in cfn-lint 1.60.0.
|
|
63
|
+
|
|
64
|
+
## 1.2.0 — 2026-11-08
|
|
65
|
+
|
|
66
|
+
- Add domain-grouped IAM/resource/tag/ABAC, Streams, DAX, PITR, replica and
|
|
67
|
+
CloudWatch guidance with permission/resource matrices and CLI examples.
|
|
68
|
+
- Add narrowly scoped illustrative identity, stream and cross-account table
|
|
69
|
+
policies plus fake-CLI and negative policy regression tests.
|
|
70
|
+
- Record current Streams tagging support, CLI ABAC-interface gap, and conflicting
|
|
71
|
+
MRSC Region / CloudWatch missing-data documentation; retain existing default
|
|
72
|
+
table and encryption assets.
|
|
73
|
+
|
|
74
|
+
## 1.1.0 — 2026-11-08
|
|
75
|
+
|
|
76
|
+
- Add AWS CLI command cookbook and a dedicated LSI/GSI decision guide, including
|
|
77
|
+
an optional new-table LSI asset; retain the original default table unchanged.
|
|
78
|
+
- Add AWS-owned, AWS-managed and customer-managed encryption decisions, CFN/CLI
|
|
79
|
+
examples, actual key readback and recovery/lifecycle warnings.
|
|
80
|
+
- Add fake-CLI/example tests and index/encryption regression scenarios.
|
|
81
|
+
|
|
82
|
+
## 1.0.0 — 2026-11-08
|
|
83
|
+
|
|
84
|
+
- Introduce access-pattern-first modeling and explicit single/multi-table tradeoffs.
|
|
85
|
+
- Add matched CloudFormation/CLI assets, language adapters and optional Toolbox
|
|
86
|
+
version checks, source provenance and bounded adversarial evaluation.
|
|
87
|
+
- Separate documentation, static/mocked evidence and unverified cloud/runtime claims.
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# aws-dynamodb-patterns
|
|
2
|
+
|
|
3
|
+
Language-neutral DynamoDB access-pattern design and implementation guidance.
|
|
4
|
+
Entry point: [SKILL.md](SKILL.md).
|
|
5
|
+
|
|
6
|
+
Includes a worked customer-orders/sparse-index model, complete CloudFormation and
|
|
7
|
+
AWS CLI table assets, JS/TS pagination, Java/Rust/PHP/Kotlin query excerpts, and a
|
|
8
|
+
recipe for other SDKs. DynamoDB Toolbox is optional and JS/TS-only.
|
|
9
|
+
|
|
10
|
+
## Command triggers
|
|
11
|
+
|
|
12
|
+
Type these as agent requests when the host exposes the skill. They are not host
|
|
13
|
+
commands installed by this package. Instructions live separately under
|
|
14
|
+
`references/commands/`; only the selected command/features and audit variant load.
|
|
15
|
+
|
|
16
|
+
| I want to… | Trigger to type | Outcome / boundary |
|
|
17
|
+
|---|---|---|
|
|
18
|
+
| Discover commands/features | `/aws-dynamodb-patterns help` | Show help and stop; no AWS inspection |
|
|
19
|
+
| Focus on selected features | `/aws-dynamodb-patterns select --features encryption,vectors` | Focused explanation/design; no persistent activation |
|
|
20
|
+
| Design a new table/access pattern | `/aws-dynamodb-patterns design --features core,indexes,encryption` | Access-pattern matrix, keys/indexes, alternatives and requested IaC/SDK code; no creation |
|
|
21
|
+
| Refactor an existing model or access layer | `/aws-dynamodb-patterns refactor --features core,indexes` | Classify change; compatibility, backfill/cutover/rollback plan and small code/IaC diff |
|
|
22
|
+
| Improve item-update safety | `/aws-dynamodb-patterns refactor --features core` | Conditional/versioned updates, upsert and retry semantics; no unnecessary migration |
|
|
23
|
+
| Check/plan continuous recovery | `/aws-dynamodb-patterns backup --method pitr` | Actual PITR status/window, retention and RPO/RTO gaps; no automatic enablement |
|
|
24
|
+
| Plan a native named backup | `/aws-dynamodb-patterns backup --method on-demand --features pitr,encryption` | Approved creation, exact ARN/source and AVAILABLE checks; asynchronous, not an exact-instant snapshot |
|
|
25
|
+
| Recover before an incident | `/aws-dynamodb-patterns restore --method pitr` | Approved point inside observed window; NEW table only; validation before cutover |
|
|
26
|
+
| Recover a named backup | `/aws-dynamodb-patterns restore --method on-demand --features pitr,encryption` | Exact source/available backup ARN, new target, dependency and application recovery checks |
|
|
27
|
+
| Audit code/templates offline | `/aws-dynamodb-patterns audit --mode offline --features iam,encryption,pitr` | Local/sanitized evidence; no AWS or automatic external lookup |
|
|
28
|
+
| Audit live settings | `/aws-dynamodb-patterns audit --mode live --features pitr,monitoring` | Scoped metadata review after read authorization; no scans/remediation |
|
|
29
|
+
| Plan a local performance test | `/aws-dynamodb-patterns performance-test --features core,indexes --environment local` | Bounded plan; local results cannot prove AWS performance |
|
|
30
|
+
| Plan a nonproduction vector test | `/aws-dynamodb-patterns performance-test --features vectors --environment nonproduction --duration-seconds 30 --max-requests 500 --max-concurrency 2` | Requested caps; target/rate/attempt/cost/stop bounds and run approval still required |
|
|
31
|
+
| Plan feature enablement | `/aws-dynamodb-patterns feature-plan --features pitr,streams --action enable` | Proposed desired-state changes, not application |
|
|
32
|
+
| Plan a supported disable | `/aws-dynamodb-patterns feature-plan --features ttl --action disable` | Review retention/expiry implications; no automatic change |
|
|
33
|
+
| Plan encryption configuration | `/aws-dynamodb-patterns feature-plan --features encryption --action configure` | Key ownership/settings; not a generic on/off toggle |
|
|
34
|
+
|
|
35
|
+
The real **offline selector** accepts the same syntax from the skill directory:
|
|
36
|
+
|
|
37
|
+
```bash
|
|
38
|
+
python3 scripts/select_mode.py /aws-dynamodb-patterns audit --mode offline --features iam,encryption
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
It emits JSON routes only; it does not audit, benchmark, enable features or grant
|
|
42
|
+
authorization. Follow the returned [command procedure](references/commands/README.md)
|
|
43
|
+
to do the selected work. Audit defaults offline; omitted features default to core,
|
|
44
|
+
except backup/restore which default to pitr. Their default method is PITR.
|
|
45
|
+
|
|
46
|
+
## Feature combinations
|
|
47
|
+
|
|
48
|
+
Use a bundle with `--features`; it selects scope, not AWS activation. Not every
|
|
49
|
+
action works with every bundle: incompatible feature-plan actions fail together.
|
|
50
|
+
Unselected features are not implicitly healthy or disabled.
|
|
51
|
+
|
|
52
|
+
| Focus | Feature bundle | Useful for |
|
|
53
|
+
|---|---|---|
|
|
54
|
+
| Security/access | `iam,encryption,tags,resource-policy` | Identity/resource/key boundaries and governance |
|
|
55
|
+
| Recovery/lifecycle | `ttl,pitr,replicas` | Expiry, recoverability and regional topology |
|
|
56
|
+
| Latency/capacity | `core,indexes,dax,monitoring` | Access patterns, hot keys, cache and metrics |
|
|
57
|
+
| Change processing | `streams,monitoring` | Consumer lag, retries and observability |
|
|
58
|
+
| Semantic retrieval | `vectors,embeddings,iam` | Model/precision/source mapping and authorized retrieval |
|
|
59
|
+
|
|
60
|
+
## Workflow combinations
|
|
61
|
+
|
|
62
|
+
Run **one command at a time**. These are manual steps, **not an automatic pipeline**
|
|
63
|
+
or a new `combo` command. Each step retains its own scope and approval gate; a
|
|
64
|
+
feature plan is not applied merely because a later audit is selected.
|
|
65
|
+
|
|
66
|
+
| Goal | Suggested sequence | Gate between steps |
|
|
67
|
+
|---|---|---|
|
|
68
|
+
| Design then review | `/aws-dynamodb-patterns design --features core,indexes,encryption` → `/aws-dynamodb-patterns audit --mode offline --features core,indexes,encryption` | Review actual generated artifacts; no implicit table creation or deployment |
|
|
69
|
+
| Refactor then validate | `/aws-dynamodb-patterns audit --mode offline --features core,indexes` → `/aws-dynamodb-patterns refactor --features core,indexes` → `/aws-dynamodb-patterns performance-test --features core,indexes --environment nonproduction` | Protect existing data/contracts; execution and test targets/bounds require separate approval |
|
|
70
|
+
| Business-continuity drill | `/aws-dynamodb-patterns backup --method pitr` → `/aws-dynamodb-patterns restore --method pitr` → `/aws-dynamodb-patterns audit --mode live --features pitr,encryption,monitoring` | Approve recovery point/new target and drill; test data/ACL/dependencies and measured RPO/RTO before separately approved cutover |
|
|
71
|
+
| Review and verify encryption | `/aws-dynamodb-patterns audit --mode offline --features iam,encryption` → `/aws-dynamodb-patterns feature-plan --features encryption --action configure` → `/aws-dynamodb-patterns audit --mode live --features iam,encryption` | Apply changes separately only if approved; live audit needs authorized read scope |
|
|
72
|
+
| Investigate latency | `/aws-dynamodb-patterns audit --mode offline --features core,indexes,monitoring` → `/aws-dynamodb-patterns performance-test --features core,indexes --environment nonproduction` | Review target, dataset, enforced limits, cost and stop thresholds before any run |
|
|
73
|
+
| Evaluate semantic search | `/aws-dynamodb-patterns select --features vectors,embeddings,iam` → `/aws-dynamodb-patterns audit --mode offline --features vectors,embeddings,iam` → `/aws-dynamodb-patterns performance-test --features vectors --environment nonproduction` | Fix model/ground truth and authorization; evaluate recall/freshness, not just self-match |
|
|
74
|
+
|
|
75
|
+
## Commands and decision guides
|
|
76
|
+
|
|
77
|
+
- [Backup](references/commands/backup.md) / [restore](references/commands/restore.md):
|
|
78
|
+
lazy PITR/on-demand procedures, real CLI examples and new-table recovery gates.
|
|
79
|
+
- [Embedding meaning, precision and integrations](references/embedding-integrations.md):
|
|
80
|
+
float32 vs base Number, coordinates vs source references, app-managed Bedrock /
|
|
81
|
+
DynamoDB example and distinct S3 Vectors / Knowledge Bases flows.
|
|
82
|
+
- [Embedding CLI companion](references/commands/embedding.md): separately loaded
|
|
83
|
+
Titan generation, native/S3 vector search and existing-KB sync/status/retrieval.
|
|
84
|
+
- [Data types and native vectors](references/data-types-and-vectors.md): all ten
|
|
85
|
+
AttributeValue tags, ordered numeric embeddings, native vector indexes and
|
|
86
|
+
SearchVectors, with optional CLI/CloudFormation examples and IAM limitations.
|
|
87
|
+
- [AWS CLI commands](references/commands/aws-cli.md): inspect, get/query, service pagination,
|
|
88
|
+
conditional put/update/delete, optional LSI creation, online GSI and TTL/PITR.
|
|
89
|
+
- [LSI vs GSI](references/lsi-vs-gsi.md): choose by partition scope, consistency,
|
|
90
|
+
lifecycle, size, capacity coupling and projection requirements.
|
|
91
|
+
- [Encryption](references/encryption.md): AWS-owned vs AWS-managed `aws/dynamodb`
|
|
92
|
+
vs customer-managed KMS keys; CloudFormation/CLI selection and lifecycle risks.
|
|
93
|
+
- [IAM, tags and access](references/iam-and-access.md): actual IAM actions and
|
|
94
|
+
table/index/stream ARNs, ABAC, resource policies and cross-account safeguards.
|
|
95
|
+
- [Streams and DAX](references/streams-and-dax.md): delivery/checkpoint semantics,
|
|
96
|
+
consumers, cache correctness, client support, networking and service-role rights.
|
|
97
|
+
- [PITR and replicas](references/recovery-and-replicas.md): restore to new tables,
|
|
98
|
+
current-version MREC commands and distinct MRSC requirements.
|
|
99
|
+
- [CloudWatch](references/monitoring.md): correct per-domain metrics/dimensions,
|
|
100
|
+
statistics, alarm missing-data policy and notification verification.
|
|
101
|
+
|
|
102
|
+
The CLI cookbook's domain index groups these commands; it is not an executable
|
|
103
|
+
deployment script. Research uses exposed Context7 and AWS documentation MCPs,
|
|
104
|
+
without installing agents, scheduling background automation or making live changes.
|
|
105
|
+
|
|
106
|
+
## June / December content reminder
|
|
107
|
+
|
|
108
|
+
Review this skill every June and December; the next window starts **1 December
|
|
109
|
+
2026**. [Maintenance](references/maintenance.md) documents the checklist and a
|
|
110
|
+
read-only due-status helper. Missed reviews remain overdue; targeted edits do not
|
|
111
|
+
pretend to complete the full review. This does not register external notifications.
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
# From the skill directory; replace with the actual user/client-local date.
|
|
115
|
+
python3 scripts/review_due.py --as-of 2026-11-08
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
Example **agent prompts**, not shell/slash commands (host installation is separate):
|
|
119
|
+
|
|
120
|
+
```text
|
|
121
|
+
Use aws-dynamodb-patterns to choose LSI vs GSI for this access-pattern matrix.
|
|
122
|
+
Use aws-dynamodb-patterns to generate approved-target CLI query/conditional-write examples; do not execute them.
|
|
123
|
+
Use aws-dynamodb-patterns to compare AWS-managed and customer-managed encryption and show the CloudFormation delta.
|
|
124
|
+
```
|
|
125
|
+
|
|
126
|
+
No AWS operation runs by loading this skill. Examples require explicit target and
|
|
127
|
+
change approval. The skill lives in this repository; installation into any host's
|
|
128
|
+
global skill directory is a separate action, not implied by creation here.
|
|
129
|
+
|
|
130
|
+
See [provisioning](references/provisioning.md), [sources](references/sources.md),
|
|
131
|
+
[eval contract](evals/eval.md), and [changelog](CHANGELOG.md). Local tests do not
|
|
132
|
+
prove AWS runtime acceptance or universal SDK compilation.
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: aws-dynamodb-patterns
|
|
3
|
+
description: "Design, implement, refactor, audit and debug Amazon DynamoDB access patterns in any language. Use for keys/indexes, single/multi-table models, IAM/tags/resource policies, encryption/KMS, TTL/PITR, backup/restore, replicas, Streams/DAX, native vectors/embeddings, Bedrock/S3 integrations, CloudFormation/CLI, bounded performance-test plans and content-freshness reviews. Selective command/feature routes load on demand. Not permission to access AWS, change features or run load."
|
|
4
|
+
allowed-tools: Read Grep Glob Bash(python3 scripts/select_mode.py:*) Bash(python3 scripts/review_due.py:*)
|
|
5
|
+
metadata:
|
|
6
|
+
author: "github: VincentChuWaiChow"
|
|
7
|
+
version: "1.8.0"
|
|
8
|
+
updated: "2026-11-08"
|
|
9
|
+
category: data
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# AWS DynamoDB Patterns
|
|
13
|
+
|
|
14
|
+
Select the smallest relevant route. Do not recursively load linked guides, siblings,
|
|
15
|
+
examples or evals. Instructions/examples are not proof of runtime correctness.
|
|
16
|
+
|
|
17
|
+
## Always-on boundaries
|
|
18
|
+
|
|
19
|
+
- Before live reads confirm account/role, Region, table/index and allowed evidence;
|
|
20
|
+
require exact approval for writes, deployment, backfill, deletion or load tests.
|
|
21
|
+
- Never inspect credentials, print customer items or execute examples on skill load.
|
|
22
|
+
Preserve the current IaC owner/data; no reset/recreation or hidden hot-path scans.
|
|
23
|
+
- Use the existing language/SDK; do not default to an ORM, Toolbox or single-table.
|
|
24
|
+
- Separate facts, assumptions, local checks and runtime evidence. Return selected
|
|
25
|
+
scope, findings and PASS/MISS/UNVERIFIED proportionately; never claim bulletproof.
|
|
26
|
+
|
|
27
|
+
## Command routes
|
|
28
|
+
|
|
29
|
+
Recognize `/aws-dynamodb-patterns <command>` when host discovery supports it;
|
|
30
|
+
Codex may use `$aws-dynamodb-patterns`, or plain language. No host registration is
|
|
31
|
+
performed. Real selector: `python3 scripts/select_mode.py <command>` (paths only).
|
|
32
|
+
|
|
33
|
+
| Command | Read only this route |
|
|
34
|
+
|---|---|
|
|
35
|
+
| help | [Help](references/commands/help.md); show commands and stop |
|
|
36
|
+
| select | [Selected features](references/commands/select.md) |
|
|
37
|
+
| design | [Table/access-pattern design](references/commands/design.md) |
|
|
38
|
+
| refactor | [Existing-model/code updates](references/commands/refactor.md) |
|
|
39
|
+
| backup | [PITR/on-demand protection](references/commands/backup.md), then only the selected method |
|
|
40
|
+
| restore | [New-table recovery](references/commands/restore.md), then only the selected method |
|
|
41
|
+
| audit | [Audit](references/commands/audit.md), then only the chosen offline/live variant |
|
|
42
|
+
| performance-test | [Performance test](references/commands/performance-test.md) |
|
|
43
|
+
| feature-plan | [Feature plan](references/commands/feature-plan.md) |
|
|
44
|
+
|
|
45
|
+
Audit defaults offline. Live mode is an authorization-gated metadata workflow;
|
|
46
|
+
selection is neither approval nor execution. Unknown commands fail; no fallback
|
|
47
|
+
from help into source/environment inspection. Combinations are manual, not chains.
|
|
48
|
+
|
|
49
|
+
## Task routes
|
|
50
|
+
|
|
51
|
+
| Task | Load only when needed |
|
|
52
|
+
|---|---|
|
|
53
|
+
| Broad data-access design/implementation and validation sequence | [Workflow](references/workflow.md), then selected domain detail |
|
|
54
|
+
| Keys, relationships, access patterns, single/multi-table choice | [Modeling](references/modeling.md) |
|
|
55
|
+
| LSI/GSI selection and constraints | [Indexes](references/lsi-vs-gsi.md) |
|
|
56
|
+
| Query/write correctness, cursors, retries, transactions, migration | [Runtime contract](references/runtime-contract.md) |
|
|
57
|
+
| Attribute types, native vector schemas/search | [Data types/vectors](references/data-types-and-vectors.md) |
|
|
58
|
+
| Embedding meaning/precision, Bedrock/S3/KB architecture | [Embedding integrations](references/embedding-integrations.md) |
|
|
59
|
+
| IAM, tags/ABAC, resource policies | [Access](references/iam-and-access.md) |
|
|
60
|
+
| Key ownership, encryption selection/lifecycle | [Encryption](references/encryption.md) |
|
|
61
|
+
| TTL/PITR, recovery, replicas | [Runtime TTL](references/runtime-contract.md) or [recovery](references/recovery-and-replicas.md), as selected |
|
|
62
|
+
| Stream consumers or DAX cache | [Streams/DAX](references/streams-and-dax.md) |
|
|
63
|
+
| Metrics/alarms | [Monitoring](references/monitoring.md) |
|
|
64
|
+
| Table CloudFormation/CLI provisioning | [Provisioning](references/provisioning.md), then selected asset |
|
|
65
|
+
| Language-specific SDK or optional Toolbox | [Adapters](references/language-adapters.md), matching section only |
|
|
66
|
+
| Core AWS or embedding CLI examples | [Core CLI](references/commands/aws-cli.md) or [embedding CLI](references/commands/embedding.md) |
|
|
67
|
+
| Current claims/source provenance | [Sources](references/sources.md) |
|
|
68
|
+
| Due review or skill edits | [Maintenance](references/maintenance.md) or [eval contract](evals/eval.md) |
|
|
69
|
+
|
|
70
|
+
At substantive use (not help), run `scripts/review_due.py --as-of YYYY-MM-DD` with
|
|
71
|
+
the actual client-local date. Review every June/December; if due/overdue load
|
|
72
|
+
Maintenance and remind the user. Never advance the ledger on load or claim a full
|
|
73
|
+
review from a targeted update. This is not a background/calendar notification.
|
|
74
|
+
|
|
75
|
+
## Repository references
|
|
76
|
+
|
|
77
|
+
Load these only when needed:
|
|
78
|
+
|
|
79
|
+
- [Operations reference](references/operations.md) — one-page backup and restore, disaster recovery, billing dimensions, monitoring, performance, IAM, tagging, encryption, network isolation and audit logging.
|
|
80
|
+
- [Workflow and output contract](references/workflow-and-output.md) — which workflow to load and the answer shape.
|
|
81
|
+
- [Official sources](references/official-sources.md) — evidence ledger, evidence index and primary AWS pages.
|
|
82
|
+
- [Safety checklist](references/safety-checklist.md) — before any live read or proposed change.
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"BillingMode": "PAY_PER_REQUEST",
|
|
3
|
+
"DeletionProtectionEnabled": true,
|
|
4
|
+
"AttributeDefinitions": [
|
|
5
|
+
{"AttributeName": "PK", "AttributeType": "S"},
|
|
6
|
+
{"AttributeName": "SK", "AttributeType": "S"},
|
|
7
|
+
{"AttributeName": "GSI1PK", "AttributeType": "S"},
|
|
8
|
+
{"AttributeName": "GSI1SK", "AttributeType": "S"},
|
|
9
|
+
{"AttributeName": "LSI1SK", "AttributeType": "S"}
|
|
10
|
+
],
|
|
11
|
+
"KeySchema": [
|
|
12
|
+
{"AttributeName": "PK", "KeyType": "HASH"},
|
|
13
|
+
{"AttributeName": "SK", "KeyType": "RANGE"}
|
|
14
|
+
],
|
|
15
|
+
"GlobalSecondaryIndexes": [
|
|
16
|
+
{
|
|
17
|
+
"IndexName": "GSI1",
|
|
18
|
+
"KeySchema": [
|
|
19
|
+
{"AttributeName": "GSI1PK", "KeyType": "HASH"},
|
|
20
|
+
{"AttributeName": "GSI1SK", "KeyType": "RANGE"}
|
|
21
|
+
],
|
|
22
|
+
"Projection": {
|
|
23
|
+
"ProjectionType": "INCLUDE",
|
|
24
|
+
"NonKeyAttributes": ["status", "orderId", "totalMinor", "currency"]
|
|
25
|
+
}
|
|
26
|
+
}
|
|
27
|
+
],
|
|
28
|
+
"LocalSecondaryIndexes": [
|
|
29
|
+
{
|
|
30
|
+
"IndexName": "LSI1",
|
|
31
|
+
"KeySchema": [
|
|
32
|
+
{"AttributeName": "PK", "KeyType": "HASH"},
|
|
33
|
+
{"AttributeName": "LSI1SK", "KeyType": "RANGE"}
|
|
34
|
+
],
|
|
35
|
+
"Projection": {
|
|
36
|
+
"ProjectionType": "INCLUDE",
|
|
37
|
+
"NonKeyAttributes": ["status", "orderId"]
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
{
|
|
2
|
+
"BillingMode": "PAY_PER_REQUEST",
|
|
3
|
+
"DeletionProtectionEnabled": true,
|
|
4
|
+
"AttributeDefinitions": [
|
|
5
|
+
{"AttributeName": "PK", "AttributeType": "S"},
|
|
6
|
+
{"AttributeName": "SK", "AttributeType": "S"},
|
|
7
|
+
{"AttributeName": "GSI1PK", "AttributeType": "S"},
|
|
8
|
+
{"AttributeName": "GSI1SK", "AttributeType": "S"}
|
|
9
|
+
],
|
|
10
|
+
"KeySchema": [
|
|
11
|
+
{"AttributeName": "PK", "KeyType": "HASH"},
|
|
12
|
+
{"AttributeName": "SK", "KeyType": "RANGE"}
|
|
13
|
+
],
|
|
14
|
+
"GlobalSecondaryIndexes": [
|
|
15
|
+
{
|
|
16
|
+
"IndexName": "GSI1",
|
|
17
|
+
"KeySchema": [
|
|
18
|
+
{"AttributeName": "GSI1PK", "KeyType": "HASH"},
|
|
19
|
+
{"AttributeName": "GSI1SK", "KeyType": "RANGE"}
|
|
20
|
+
],
|
|
21
|
+
"Projection": {
|
|
22
|
+
"ProjectionType": "INCLUDE",
|
|
23
|
+
"NonKeyAttributes": ["status", "orderId", "totalMinor", "currency"]
|
|
24
|
+
}
|
|
25
|
+
}
|
|
26
|
+
]
|
|
27
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
#!/usr/bin/env bash
|
|
2
|
+
# Example only: execute after explicit approval of the printed target and cost.
|
|
3
|
+
# Requires AWS CLI v2 and an existing authorized profile; no login/install here.
|
|
4
|
+
set -euo pipefail
|
|
5
|
+
: "${AWS_PROFILE:?Select the approved existing profile}"
|
|
6
|
+
: "${AWS_REGION:?Select the approved Region}"
|
|
7
|
+
: "${TABLE_NAME:?Select the approved new table name}"
|
|
8
|
+
: "${EXPECTED_ACCOUNT_ID:?Set the approved target account ID}"
|
|
9
|
+
|
|
10
|
+
asset_dir=$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)
|
|
11
|
+
aws_cmd=(aws --profile "$AWS_PROFILE" --region "$AWS_REGION" --no-cli-pager)
|
|
12
|
+
|
|
13
|
+
# Identity failure stops execution. The caller reviews the role, not just account.
|
|
14
|
+
"${aws_cmd[@]}" sts get-caller-identity
|
|
15
|
+
account_id=$("${aws_cmd[@]}" sts get-caller-identity --query Account --output text)
|
|
16
|
+
if [[ "$account_id" != "$EXPECTED_ACCOUNT_ID" ]]; then
|
|
17
|
+
printf '%s\n' 'Account mismatch: stopped before table creation.' >&2
|
|
18
|
+
exit 1
|
|
19
|
+
fi
|
|
20
|
+
printf 'Target: account=%s profile=%s region=%s new-table=%s\n' \
|
|
21
|
+
"$account_id" "$AWS_PROFILE" "$AWS_REGION" "$TABLE_NAME"
|
|
22
|
+
read -r -p "Type CREATE ${TABLE_NAME} to create this billable resource: " confirmation
|
|
23
|
+
[[ "$confirmation" == "CREATE ${TABLE_NAME}" ]] || exit 1
|
|
24
|
+
|
|
25
|
+
# Existing name yields ResourceInUseException; do not catch it and adopt the table.
|
|
26
|
+
"${aws_cmd[@]}" dynamodb create-table \
|
|
27
|
+
--table-name "$TABLE_NAME" --cli-input-json "file://${asset_dir}/create-table.json"
|
|
28
|
+
"${aws_cmd[@]}" dynamodb wait table-exists --table-name "$TABLE_NAME"
|
|
29
|
+
"${aws_cmd[@]}" dynamodb update-time-to-live --table-name "$TABLE_NAME" \
|
|
30
|
+
--time-to-live-specification 'Enabled=true,AttributeName=expiresAt'
|
|
31
|
+
"${aws_cmd[@]}" dynamodb update-continuous-backups --table-name "$TABLE_NAME" \
|
|
32
|
+
--point-in-time-recovery-specification 'PointInTimeRecoveryEnabled=true'
|
|
33
|
+
|
|
34
|
+
# Readback is control-plane evidence, not application/runtime proof.
|
|
35
|
+
"${aws_cmd[@]}" dynamodb describe-table --table-name "$TABLE_NAME"
|
|
36
|
+
"${aws_cmd[@]}" dynamodb describe-time-to-live --table-name "$TABLE_NAME"
|
|
37
|
+
"${aws_cmd[@]}" dynamodb describe-continuous-backups --table-name "$TABLE_NAME"
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
"""Injected Boto3-style clients; importing this module makes no service calls.
|
|
2
|
+
|
|
3
|
+
Example only: caller owns authorization, chunking, versioned keys, retries, item
|
|
4
|
+
size, and a dedicated COSINE/1024 index for this exact model configuration.
|
|
5
|
+
"""
|
|
6
|
+
import json
|
|
7
|
+
import math
|
|
8
|
+
import struct
|
|
9
|
+
|
|
10
|
+
MODEL_ID = "amazon.titan-embed-text-v2:0"
|
|
11
|
+
DIMENSIONS = 1024
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
def required(*values):
|
|
15
|
+
if any(not isinstance(value, str) or not value.strip() for value in values):
|
|
16
|
+
raise ValueError("Explicit nonempty targets, authenticated tenant and text required")
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def number_values(values, dimensions):
|
|
20
|
+
"""Quantize once, then emit low-level DynamoDB Number tags.
|
|
21
|
+
|
|
22
|
+
This conservative example rejects subnormal values and nonzero underflow;
|
|
23
|
+
that policy is not an assertion that AWS rejects every subnormal value.
|
|
24
|
+
"""
|
|
25
|
+
if type(dimensions) is not int or not 1 <= dimensions <= 4096:
|
|
26
|
+
raise ValueError("Invalid dimensions")
|
|
27
|
+
if not isinstance(values, list) or len(values) != dimensions:
|
|
28
|
+
raise ValueError("Embedding length must match the dedicated index")
|
|
29
|
+
result = []
|
|
30
|
+
for value in values:
|
|
31
|
+
if type(value) not in (int, float):
|
|
32
|
+
raise ValueError("Numeric coordinates required; no bool/string/binary")
|
|
33
|
+
try:
|
|
34
|
+
original = float(value)
|
|
35
|
+
rounded = struct.unpack("!f", struct.pack("!f", original))[0]
|
|
36
|
+
except (OverflowError, struct.error) as error:
|
|
37
|
+
raise ValueError("Coordinate overflows float32") from error
|
|
38
|
+
if not math.isfinite(rounded):
|
|
39
|
+
raise ValueError("NaN/Infinity are not embedding coordinates")
|
|
40
|
+
if (original != 0 and rounded == 0) or 0 < abs(rounded) < 2.0 ** -126:
|
|
41
|
+
raise ValueError("Example policy rejects underflow/subnormal coordinates")
|
|
42
|
+
# Nine significant digits preserve f32 round-trips, not nine decimal places.
|
|
43
|
+
result.append({"N": format(rounded, ".9g")})
|
|
44
|
+
if not any(float(value["N"]) != 0 for value in result):
|
|
45
|
+
raise ValueError("Zero vector is unsuitable for this COSINE example")
|
|
46
|
+
return result
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
def embed_text(bedrock, text):
|
|
50
|
+
required(text)
|
|
51
|
+
response = bedrock.invoke_model(
|
|
52
|
+
modelId=MODEL_ID, contentType="application/json", accept="application/json",
|
|
53
|
+
body=json.dumps({"inputText": text, "dimensions": DIMENSIONS,
|
|
54
|
+
"normalize": True, "embeddingTypes": ["float"]}))
|
|
55
|
+
payload = json.loads(response["body"].read())
|
|
56
|
+
return number_values(payload["embedding"], DIMENSIONS)
|
|
57
|
+
|
|
58
|
+
|
|
59
|
+
def index_chunk(bedrock, dynamodb, table, tenant, chunk_key, text, source):
|
|
60
|
+
"""Billable model call and item write when explicitly invoked by the caller."""
|
|
61
|
+
required(table, tenant, chunk_key, text)
|
|
62
|
+
if not isinstance(source, dict) or set(source) != {"bucket", "key", "version_id"}:
|
|
63
|
+
raise ValueError("Explicit versioned source reference required")
|
|
64
|
+
required(*source.values())
|
|
65
|
+
if source["version_id"] == "null":
|
|
66
|
+
raise ValueError("This example requires a pinned, non-null S3 object version")
|
|
67
|
+
numbers = embed_text(bedrock, text)
|
|
68
|
+
return dynamodb.put_item(
|
|
69
|
+
TableName=table, ConditionExpression="attribute_not_exists(PK)", Item={
|
|
70
|
+
"PK": {"S": chunk_key}, "Tenant": {"S": tenant},
|
|
71
|
+
"Status": {"S": "PUBLISHED"}, "ChunkText": {"S": text},
|
|
72
|
+
"Source": {"M": {key: {"S": value} for key, value in source.items()}},
|
|
73
|
+
"EmbeddingModel": {"S": MODEL_ID},
|
|
74
|
+
"EmbeddingDimensions": {"N": str(DIMENSIONS)},
|
|
75
|
+
"EmbeddingNormalized": {"BOOL": True}, "Embedding": {"L": numbers}})
|
|
76
|
+
|
|
77
|
+
|
|
78
|
+
def search_chunks(bedrock, dynamodb, table, index, tenant, question, top_k=10):
|
|
79
|
+
"""Caller derives tenant/index from trusted configuration, never request input."""
|
|
80
|
+
required(table, index, tenant, question)
|
|
81
|
+
if type(top_k) is not int or not 1 <= top_k <= 100:
|
|
82
|
+
raise ValueError("TopK must be an integer in 1..100")
|
|
83
|
+
return dynamodb.search_vectors(
|
|
84
|
+
TableName=table, IndexName=index, TopK=top_k,
|
|
85
|
+
SearchVector=embed_text(bedrock, question),
|
|
86
|
+
SearchConditionExpression="#tenant = :tenant AND #status = :status",
|
|
87
|
+
ExpressionAttributeNames={"#tenant": "Tenant", "#status": "Status"},
|
|
88
|
+
ExpressionAttributeValues={":tenant": {"S": tenant},
|
|
89
|
+
":status": {"S": "PUBLISHED"}})
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"TableName": "REPLACE_WITH_APPROVED_TABLE",
|
|
3
|
+
"KeyConditionExpression": "#pk = :pk AND begins_with(#sk, :prefix)",
|
|
4
|
+
"ExpressionAttributeNames": {"#pk": "PK", "#sk": "SK"},
|
|
5
|
+
"ExpressionAttributeValues": {
|
|
6
|
+
":pk": {"S": "TENANT#acme#CUSTOMER#c42"},
|
|
7
|
+
":prefix": {"S": "ORDER#"}
|
|
8
|
+
},
|
|
9
|
+
"ConsistentRead": true,
|
|
10
|
+
"ScanIndexForward": false,
|
|
11
|
+
"Limit": 50,
|
|
12
|
+
"ReturnConsumedCapacity": "TOTAL"
|
|
13
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Internal, trusted request input only. query(request) is an injected async SDK
|
|
3
|
+
* adapter. No SDK dependency, network activity or credential lookup on import.
|
|
4
|
+
* Yield whole pages, including empty ones, so callers retain continuation state.
|
|
5
|
+
* This does not validate public cursors, authorize tenants or create snapshots.
|
|
6
|
+
*/
|
|
7
|
+
export async function* queryPages(query, input, { maxPages = 100 } = {}) {
|
|
8
|
+
if (!Number.isInteger(maxPages) || maxPages < 1) {
|
|
9
|
+
throw new RangeError("maxPages must be a positive integer");
|
|
10
|
+
}
|
|
11
|
+
let cursor = input.ExclusiveStartKey;
|
|
12
|
+
for (let page = 0; page < maxPages; page += 1) {
|
|
13
|
+
const request = { ...input };
|
|
14
|
+
// Snapshot the request's continuation reference; never mutate caller input.
|
|
15
|
+
if (cursor && Object.keys(cursor).length > 0) {
|
|
16
|
+
request.ExclusiveStartKey = cursor;
|
|
17
|
+
} else {
|
|
18
|
+
delete request.ExclusiveStartKey;
|
|
19
|
+
}
|
|
20
|
+
const result = await query(request);
|
|
21
|
+
yield result;
|
|
22
|
+
cursor = result.LastEvaluatedKey;
|
|
23
|
+
if (!cursor || Object.keys(cursor).length === 0) return;
|
|
24
|
+
}
|
|
25
|
+
throw new Error("Query page budget exhausted; results are incomplete");
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* Bounded HTTP match-page collector for an internal, authorized Query request.
|
|
30
|
+
* Return the service continuation even after empty/short pages or budget expiry.
|
|
31
|
+
* The API layer must sign/store it and enforce tenant/query binding externally.
|
|
32
|
+
*/
|
|
33
|
+
export async function matchingPage(query, input, { target = 50, maxPages = 10 } = {}) {
|
|
34
|
+
const cap = input.Limit ?? 50;
|
|
35
|
+
for (const value of [target, maxPages, cap]) {
|
|
36
|
+
if (!Number.isInteger(value) || value < 1) {
|
|
37
|
+
throw new RangeError("target, maxPages and Limit must be positive integers");
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
const Items = [];
|
|
41
|
+
let cursor = input.ExclusiveStartKey;
|
|
42
|
+
for (let page = 0; page < maxPages; page += 1) {
|
|
43
|
+
const request = { ...input, Limit: Math.min(cap, target - Items.length) };
|
|
44
|
+
if (cursor && Object.keys(cursor).length > 0) request.ExclusiveStartKey = cursor;
|
|
45
|
+
else delete request.ExclusiveStartKey;
|
|
46
|
+
const result = await query(request);
|
|
47
|
+
// Returned matches <= evaluated items <= requested Limit: no slicing needed.
|
|
48
|
+
Items.push(...(result.Items ?? []));
|
|
49
|
+
cursor = result.LastEvaluatedKey;
|
|
50
|
+
if (!cursor || Object.keys(cursor).length === 0) return { Items };
|
|
51
|
+
if (Items.length === target) return { Items, LastEvaluatedKey: cursor };
|
|
52
|
+
}
|
|
53
|
+
return { Items, LastEvaluatedKey: cursor, WorkBudgetExhausted: true };
|
|
54
|
+
}
|