@raishin/vanguard-frontier-agentic 3.18.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +8 -1
- package/.cursor-plugin/plugin.json +8 -1
- package/.github/plugin/marketplace.json +1 -1
- package/README.md +21 -21
- package/agents/AGENTS.md +4 -4
- package/agents/README.md +7 -7
- package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
- package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
- package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
- package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
- package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
- package/catalog/agents.json +204 -1
- package/catalog/asset-integrity.json +620 -75
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +2074 -527
- package/catalog/skills.json +314 -14
- package/package.json +8 -2
- package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
- package/powers/vanguard-alibaba/POWER.md +1 -1
- package/powers/vanguard-aws/POWER.md +1 -1
- package/powers/vanguard-azure/POWER.md +1 -1
- package/powers/vanguard-gcp/POWER.md +1 -1
- package/powers/vanguard-huawei/POWER.md +1 -1
- package/powers/vanguard-oci/POWER.md +1 -1
- package/rules/codex/cloud-provenance-rule.md +1 -1
- package/scripts/generate-kiro-powers.mjs +2 -2
- package/skills/alibaba/README.md +2 -1
- package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
- package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
- package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
- package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
- package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
- package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
- package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
- package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
- package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
- package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
- package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
- package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
- package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
- package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
- package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
- package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
- package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
- package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
- package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
- package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
- package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
- package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
- package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
- package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
- package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
- package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
- package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
- package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
- package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
- package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
- package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
- package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
- package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
- package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
- package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
- package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
- package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
- package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
- package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
- package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
- package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
- package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
- package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-maestro/SKILL.md +1 -1
- package/skills/aws/aws-maestro/metadata.json +1 -1
- package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
- package/skills/azure/azure-ai-foundry-ops-governor/SKILL.md +2 -2
- package/skills/azure/azure-aks-platform-operator/SKILL.md +1 -1
- package/skills/azure/azure-app-service-production-readiness/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +5 -3
- package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
- package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
- package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
- package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
- package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
- package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
- package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
- package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
- package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
- package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
- package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
- package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
- package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
- package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
- package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
- package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
- package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
- package/skills/azure/azure-cosmosdb-performance-investigator/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +7 -3
- package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
- package/skills/azure/azure-cost-estimation-review/SKILL.md +1 -1
- package/skills/azure/azure-cost-optimization-governor/SKILL.md +1 -1
- package/skills/azure/azure-entra-id-specialist/SKILL.md +1 -1
- package/skills/azure/azure-governance-policy-guardrails/SKILL.md +1 -1
- package/skills/azure/azure-identity-governance-review/SKILL.md +1 -1
- package/skills/azure/azure-key-vault-secret-lifecycle-auditor/SKILL.md +1 -1
- package/skills/azure/azure-landing-zone-architect/SKILL.md +1 -1
- package/skills/azure/azure-maestro/SKILL.md +2 -1
- package/skills/azure/azure-migrate-landing-zone-cutover/SKILL.md +1 -1
- package/skills/azure/azure-network-topology-review/SKILL.md +1 -1
- package/skills/azure/azure-observability-investigator/SKILL.md +1 -1
- package/skills/azure/azure-platform-automation-devops/SKILL.md +1 -1
- package/skills/azure/azure-private-endpoint-adoption-planner/SKILL.md +1 -1
- package/skills/azure/azure-rbac-review/SKILL.md +1 -1
- package/skills/azure/azure-resilience-bcdr-review/SKILL.md +1 -1
- package/skills/azure/azure-resource-health-incident-triage/SKILL.md +1 -1
- package/skills/azure/azure-role-selector/SKILL.md +1 -1
- package/skills/azure/azure-security-posture-hardening/SKILL.md +1 -1
- package/skills/azure/azure-subscription-resource-organization/SKILL.md +1 -1
- package/skills/azure/azure-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-reliability-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-security-review/SKILL.md +1 -1
- package/skills/contabo/contabo-security-hardening/SKILL.md +1 -1
- package/skills/cross-functional/agentic-board-protocol/SKILL.md +1 -1
- package/skills/cross-functional/copilot-data-readiness-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-case-capsule/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-data-exposure-escalation-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-live-change-approval-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-risk-taxonomy/SKILL.md +1 -1
- package/skills/databricks/databricks-lakehouse-engineering-at-azure/SKILL.md +1 -1
- package/skills/databricks/databricks-unity-catalog-governance-at-azure/SKILL.md +1 -1
- package/skills/dotnet/dotnet-performance-aot-review/SKILL.md +1 -1
- package/skills/frontend/vue-router-navigation-security-review/SKILL.md +1 -1
- package/skills/gcp/README.md +2 -1
- package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
- package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
- package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
- package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
- package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
- package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
- package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
- package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
- package/skills/gcp/gcp-maestro/SKILL.md +2 -1
- package/skills/huawei/README.md +2 -1
- package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
- package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
- package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
- package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
- package/skills/huawei/huawei-maestro/SKILL.md +2 -1
- package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
- package/skills/java/java-application-server-exit/SKILL.md +1 -1
- package/skills/java/java-jvm-performance-and-gc/SKILL.md +1 -1
- package/skills/java/java-resilience-pattern/SKILL.md +1 -1
- package/skills/java/java-test-architecture/SKILL.md +1 -1
- package/skills/java/java-transaction-and-consistency/SKILL.md +1 -1
- package/skills/kubernetes/kubernetes-rbac-review/SKILL.md +1 -1
- package/skills/marketing/analytics-data-minimization-review/SKILL.md +1 -1
- package/skills/microsoft/d365-customer-insights-journeys/SKILL.md +1 -1
- package/skills/microsoft/fabric-analytics-engineering/SKILL.md +1 -1
- package/skills/microsoft/m365-defender-xdr-security-operations/SKILL.md +1 -1
- package/skills/microsoft/m365-purview-data-security-compliance/SKILL.md +1 -1
- package/skills/oci/README.md +6 -1
- package/skills/oci/oci-autonomous-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-certificates-issuer-review/SKILL.md +1 -1
- package/skills/oci/oci-cloud-guard-responder/SKILL.md +1 -1
- package/skills/oci/oci-compute-instance-agent-operator/SKILL.md +1 -1
- package/skills/oci/oci-compute-platform-operator/SKILL.md +1 -1
- package/skills/oci/oci-cost-finops-analyst/SKILL.md +1 -1
- package/skills/oci/oci-database-platform-dba/SKILL.md +1 -1
- package/skills/oci/oci-dbtools-sql-analyst/SKILL.md +1 -1
- package/skills/oci/oci-devops-container-platform-engineer/SKILL.md +1 -1
- package/skills/oci/oci-exadata-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-exadata-platform-architect/SKILL.md +1 -1
- package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md +1 -1
- package/skills/oci/oci-goldengate-replication-operator/SKILL.md +1 -1
- package/skills/oci/oci-identity-access-governor/SKILL.md +1 -1
- package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md +1 -1
- package/skills/oci/oci-limits-capacity-planner/SKILL.md +1 -1
- package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-network-security-rule-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-oke-rollout-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-resource-manager-stack-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-vault-key-destruction-guard/SKILL.md +1 -1
- package/skills/oci/oci-load-balancer-traffic-engineer/SKILL.md +1 -1
- package/skills/oci/oci-maestro/SKILL.md +1 -1
- package/skills/oci/oci-migration-cutover-architect/SKILL.md +1 -1
- package/skills/oci/oci-multi-cloud-architect/SKILL.md +1 -1
- package/skills/oci/oci-mysql-heatwave-ai-specialist/SKILL.md +1 -1
- package/skills/oci/oci-network-architect/SKILL.md +1 -1
- package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
- package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
- package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
- package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
- package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
- package/skills/oci/oci-nosql-pattern/README.md +81 -0
- package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
- package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
- package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
- package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
- package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
- package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
- package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
- package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
- package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
- package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
- package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
- package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
- package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
- package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
- package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
- package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
- package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
- package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
- package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
- package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
- package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
- package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
- package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
- package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
- package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
- package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
- package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
- package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
- package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
- package/skills/oci/oci-observability-incident-responder/SKILL.md +1 -1
- package/skills/oci/oci-recovery-service-operator/SKILL.md +1 -1
- package/skills/oci/oci-registry-artifact-governor/SKILL.md +1 -1
- package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md +1 -1
- package/skills/oci/oci-security-compliance-reviewer/SKILL.md +1 -1
- package/skills/oci/oci-solution-architect/SKILL.md +1 -1
- package/skills/oci/oci-storage-backup-steward/SKILL.md +1 -1
- package/skills/oci/oci-support-incident-coordinator/SKILL.md +1 -1
- package/skills/oci/oci-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-reliability-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-security-review/SKILL.md +1 -1
- package/skills/oci/oracle-oci-mcp-grounded-advisor/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-cost-finops-analyst/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-live-kms-key-destruction-guard/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/salesforce/salesforce-agentforce-risk-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-apex-lwc-code-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-devsecops-pipeline-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-flow-automation-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-infrastructure-audit-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-integration-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-marketing-consent-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-metadata-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-org-assessment-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-permission-model-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-release-readiness-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-zero-trust-maturity-skill/SKILL.md +1 -1
- package/skills/sap/sap-analytics-cloud-planning-governance/SKILL.md +1 -1
- package/skills/sap/sap-btp-governance-review/SKILL.md +1 -1
- package/skills/sap/sap-cloud-alm-sre-incident-review/SKILL.md +1 -1
- package/skills/sap/sap-datasphere-data-product-architecture/SKILL.md +1 -1
- package/skills/sap/sap-ewm-tm-logistics-execution-review/SKILL.md +1 -1
- package/skills/sap/sap-finance-fico-controls-review/SKILL.md +1 -1
- package/skills/sap/sap-hana-cloud-performance-cost/SKILL.md +1 -1
- package/skills/sap/sap-hypercare-incident-commander-review/SKILL.md +1 -1
- package/skills/sap/sap-integration-suite-review/SKILL.md +1 -1
- package/skills/sap/sap-joule-governance-adoption-review/SKILL.md +1 -1
- package/skills/sap/sap-license-btp-consumption-finops-review/SKILL.md +1 -1
- package/skills/sap/sap-manufacturing-execution-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-mdg-master-data-quality-review/SKILL.md +1 -1
- package/skills/sap/sap-order-to-cash-review/SKILL.md +1 -1
- package/skills/sap/sap-procurement-ariba-value-leakage-review/SKILL.md +1 -1
- package/skills/sap/sap-release-change-collision-review/SKILL.md +1 -1
- package/skills/sap/sap-rise-sla-vendor-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-security-iam-grc-sod-review/SKILL.md +1 -1
- package/skills/sap/sap-signavio-process-mining-value/SKILL.md +1 -1
- package/skills/sap/sap-successfactors-hr-process-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-supply-chain-ibp-resilience-review/SKILL.md +1 -1
- package/skills/sap/sap-testing-quality-gate-review/SKILL.md +1 -1
- package/skills/sap/sap-transformation-portfolio-triage-review/SKILL.md +1 -1
- package/skills/sap/sap-treasury-cash-risk-review/SKILL.md +1 -1
- package/skills/scaleway/scaleway-kapsule-platform-operator/SKILL.md +1 -1
- package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/scaleway/scaleway-network-architect/SKILL.md +1 -1
- package/templates/nosql-audit-template.md +127 -0
- package/templates/nosql-operations-template.md +60 -0
- package/tests/_generate_maestro_routing_fixtures.py +11 -0
- package/tests/fixtures/README.md +2 -2
- package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
- package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
- package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
- package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
- package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
- package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
- package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
- package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
- package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
- package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
- package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
- package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
- package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
- package/tests/requirements-ci.txt +8 -0
- package/tests/test-marketplace-validators.py +7 -1
- package/tests/validate-agent-frontmatter-schema.py +7 -1
- package/tests/validate-aws-skill-quality.py +7 -0
- package/tests/validate-kiro-powers.py +8 -1
- package/tests/validate-nosql-audit.py +741 -0
- package/tests/validate-nosql-operations.py +136 -0
- package/tests/validate-nosql-pattern-evals.py +96 -0
- package/tests/validate-nosql-scenarios.py +94 -0
- package/tests/validate-skill-frontmatter-schema.py +7 -1
- package/tests/validate-skill-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
- package/tests/validate-skill-yaml-strict.py +84 -0
|
@@ -3,9 +3,9 @@ name: azure-cosmosdb-platform-operator
|
|
|
3
3
|
description: Use this skill for Azure Cosmos DB platform operations and design review, especially accounts, databases, containers, partition-key design, throughput and RU posture, consistency choices, indexing, throttling, multi-region replication, private connectivity, and Cosmos DB evidence-guided discovery.
|
|
4
4
|
allowed-tools: Read Grep Glob
|
|
5
5
|
metadata:
|
|
6
|
-
author: github: VincentChuWaiChow
|
|
7
|
-
version: 0.1.
|
|
8
|
-
updated: "2026-
|
|
6
|
+
author: "github: VincentChuWaiChow"
|
|
7
|
+
version: 0.1.4
|
|
8
|
+
updated: "2026-11-08"
|
|
9
9
|
category: platform
|
|
10
10
|
---
|
|
11
11
|
|
|
@@ -44,7 +44,11 @@ Do not use this skill as a substitute for:
|
|
|
44
44
|
Load these only when needed:
|
|
45
45
|
|
|
46
46
|
- [Operations guide](references/cosmosdb-platform-operations.md) — use for service-specific pitfalls, design rules, verification targets, and pushback criteria.
|
|
47
|
+
- [Consistency, capacity and data-plane security](references/consistency-capacity-security.md) — use for the five consistency levels, session tokens, request-level overrides, integrated cache, serverless vs provisioned vs autoscale, logical-partition limits, and Entra ID data-plane vs control-plane RBAC.
|
|
48
|
+
- [Evidence ledger](references/evidence-ledger.md) — use when a claim must be traced to its Microsoft Learn source; cite its `[COSMOS-Exx]` IDs for material service claims.
|
|
47
49
|
- [MCP and evidence path](references/mcp-and-evidence.md) — use when choosing documentation-based evidence, sampled read-only Azure evidence, or sanitized user evidence.
|
|
50
|
+
- [Operations: NoSQL API](references/operations.md), [MongoDB API](references/operations-mongodb.md), [Cassandra API](references/operations-cassandra.md) — per-API backup and restore, disaster recovery, billing dimensions, monitoring, performance, IAM, tagging, encryption, network isolation and audit logging; load only the API in question.
|
|
51
|
+
- [Audit](references/commands/audit.md) — offline or live audit against the operations reference; load only when an audit is requested.
|
|
48
52
|
- [Safety checklist](references/safety-checklist.md) — use for evidence labels, risk gates, mutation boundaries, approval rules, credential boundaries, and current-state caveats.
|
|
49
53
|
- [Workflow and output contract](references/workflow-and-output.md) — use when executing the full review, applying stress checks, or formatting the final answer.
|
|
50
54
|
- [Official sources](references/official-sources.md) — use when you need the detailed Microsoft documentation list or source notes.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"id": "azure-cosmosdb-platform-operator",
|
|
3
3
|
"name": "Azure Cosmos DB Platform Operator",
|
|
4
|
-
"version": "0.1.
|
|
4
|
+
"version": "0.1.4",
|
|
5
5
|
"type": "skill",
|
|
6
6
|
"provider": "azure",
|
|
7
7
|
"harnesses": [
|
|
@@ -24,10 +24,13 @@
|
|
|
24
24
|
"https://learn.microsoft.com/en-us/azure/cosmos-db/hierarchical-partition-keys",
|
|
25
25
|
"https://learn.microsoft.com/en-us/azure/reliability/reliability-cosmos-db",
|
|
26
26
|
"https://learn.microsoft.com/en-us/azure/cosmos-db/hierarchical-partition-keys-unlimited-scale",
|
|
27
|
-
"https://learn.microsoft.com/en-us/azure/cosmos-db/failover-considerations-for-private-endpoints"
|
|
27
|
+
"https://learn.microsoft.com/en-us/azure/cosmos-db/failover-considerations-for-private-endpoints",
|
|
28
|
+
"https://learn.microsoft.com/en-us/azure/cosmos-db/integrated-cache",
|
|
29
|
+
"https://learn.microsoft.com/en-us/azure/cosmos-db/throughput-serverless",
|
|
30
|
+
"https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-connect-role-based-access-control"
|
|
28
31
|
],
|
|
29
32
|
"security_notes": "Do not approve a partition key, indexing posture, consistency change, or cross-partition query strategy without checking workload shape, RU impact, transactional scope, and least-privilege access implications.",
|
|
30
|
-
"last_verified": "2026-
|
|
33
|
+
"last_verified": "2026-11-08",
|
|
31
34
|
"path": "skills/azure/azure-cosmosdb-platform-operator",
|
|
32
35
|
"author": "github: VincentChuWaiChow"
|
|
33
36
|
}
|
|
@@ -0,0 +1,180 @@
|
|
|
1
|
+
# audit --mode live
|
|
2
|
+
|
|
3
|
+
Commands are examples for an operator holding read-only authorization; the skill
|
|
4
|
+
does not run them. They read control-plane metadata only. Compare results with the
|
|
5
|
+
operations reference for the API in scope:
|
|
6
|
+
[NoSQL](../../operations.md), [MongoDB](../../operations-mongodb.md),
|
|
7
|
+
[Cassandra](../../operations-cassandra.md). Per-API sub-bullets below say which
|
|
8
|
+
commands apply; run only those for the API under audit.
|
|
9
|
+
|
|
10
|
+
## Before any command
|
|
11
|
+
|
|
12
|
+
- Confirm the approved principal, subscription, tenant, Region and exact account.
|
|
13
|
+
Stop on any mismatch; never switch target to make a command work.
|
|
14
|
+
- Use a read-only role. Write output to a private temp directory (`umask 077`).
|
|
15
|
+
Never print keys, connection strings or customer data; no key or connection
|
|
16
|
+
string command is part of this audit.
|
|
17
|
+
- Control-plane commands only: no data-plane shell, no item, document or row reads.
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
set -euo pipefail
|
|
21
|
+
: "${EXPECTED_SUBSCRIPTION_ID:?Approved subscription ID}" "${COSMOS_RG:?Approved resource group}" \
|
|
22
|
+
"${COSMOS_ACCOUNT:?Approved Cosmos DB account name}" "${COSMOS_LOCATION:?Approved Region}"
|
|
23
|
+
umask 077
|
|
24
|
+
audit_dir=$(mktemp -d)
|
|
25
|
+
az account show --output json > "$audit_dir/identity.json" # [COSMOS-E901]
|
|
26
|
+
jq -e --arg s "$EXPECTED_SUBSCRIPTION_ID" '.id == $s' "$audit_dir/identity.json" > /dev/null \
|
|
27
|
+
|| { echo "Subscription mismatch; stop" >&2; exit 1; }
|
|
28
|
+
az cosmosdb show --name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json > "$audit_dir/account.json" # [COSMOS-E902]
|
|
29
|
+
jq -e --arg l "$COSMOS_LOCATION" '(.location|ascii_downcase|gsub(" ";"")) == ($l|ascii_downcase|gsub(" ";""))' \
|
|
30
|
+
"$audit_dir/account.json" > /dev/null || { echo "Region mismatch; stop" >&2; exit 1; } # [COSMOS-E920]
|
|
31
|
+
COSMOS_ACCOUNT_ID=$(jq -r '.id' "$audit_dir/account.json")
|
|
32
|
+
```
|
|
33
|
+
|
|
34
|
+
The Region check compares the account's `location` with `COSMOS_LOCATION`, ignoring
|
|
35
|
+
case and spaces, so `West US` and `westus` match.
|
|
36
|
+
|
|
37
|
+
The account JSON written above is reused by the sections below with local `jq`.
|
|
38
|
+
Fields absent from it are UNVERIFIED, not off.
|
|
39
|
+
|
|
40
|
+
## Backup and restore
|
|
41
|
+
|
|
42
|
+
- All APIs: inspect the backup policy and restorable-account metadata of the
|
|
43
|
+
account. Which fields the output carries is not enumerated on the CLI page.
|
|
44
|
+
- NoSQL, MongoDB, Cassandra: the same account-level commands apply; restore
|
|
45
|
+
options per API are in the operations files.
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
jq '.backupPolicy' "$audit_dir/account.json" # [COSMOS-E902]
|
|
49
|
+
az cosmosdb restorable-database-account list --account-name "$COSMOS_ACCOUNT" --output json # [COSMOS-E903]
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
## Disaster recovery and replication
|
|
53
|
+
|
|
54
|
+
- All APIs: regions, failover priority, zone redundancy and write-region flags come
|
|
55
|
+
from the account JSON; absent fields are UNVERIFIED.
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
jq '{locations, writeLocations, readLocations, enableAutomaticFailover, enableMultipleWriteLocations}' "$audit_dir/account.json" # [COSMOS-E902]
|
|
59
|
+
az cosmosdb list --resource-group "$COSMOS_RG" --output table # [COSMOS-E902]
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
## Cost
|
|
63
|
+
|
|
64
|
+
**No live command:** billing and cost data live in Azure Cost Management and the
|
|
65
|
+
billing APIs, not in the Cosmos DB resource API; the CLI reference pages read
|
|
66
|
+
(`az cosmosdb` and its sql, mongodb and cassandra groups) show no read-only cost
|
|
67
|
+
command. Use the throughput commands in Performance for provisioned RU/s only.
|
|
68
|
+
|
|
69
|
+
## Monitoring
|
|
70
|
+
|
|
71
|
+
- All APIs: list the metric definitions the account exposes, then read a bounded
|
|
72
|
+
window of aggregated platform metrics. Metric names come from the definitions
|
|
73
|
+
output; the names below are those in the operations reference.
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
account_id="$COSMOS_ACCOUNT_ID"
|
|
77
|
+
az monitor metrics list-definitions --resource "$account_id" --output table # [COSMOS-E908]
|
|
78
|
+
az monitor metrics list --resource "$account_id" --metrics NormalizedRUConsumption --offset 1d --interval PT1H --aggregation Maximum --output json # [COSMOS-E907] [COSMOS-E126] [COSMOS-E921]
|
|
79
|
+
az monitor metrics list --resource "$account_id" --metrics TotalRequests --offset 1d --interval PT1H --aggregation Count --output json # [COSMOS-E907] [COSMOS-E921]
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## Performance
|
|
83
|
+
|
|
84
|
+
- Throughput and key design per API; `throughput show` fails for a container that
|
|
85
|
+
has no dedicated throughput (it may use shared database throughput).
|
|
86
|
+
- NoSQL: set `COSMOS_SQL_DATABASE`, `COSMOS_SQL_CONTAINER`.
|
|
87
|
+
- MongoDB: set `COSMOS_MONGO_DATABASE`, `COSMOS_MONGO_COLLECTION`.
|
|
88
|
+
- Cassandra: set `COSMOS_CASSANDRA_KEYSPACE`, `COSMOS_CASSANDRA_TABLE`.
|
|
89
|
+
|
|
90
|
+
**NoSQL:**
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
: "${COSMOS_SQL_DATABASE:?Approved database}" "${COSMOS_SQL_CONTAINER:?Approved container}"
|
|
94
|
+
az cosmosdb sql database list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output table # [COSMOS-E909]
|
|
95
|
+
az cosmosdb sql container show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_SQL_DATABASE" --name "$COSMOS_SQL_CONTAINER" --output json # [COSMOS-E910]
|
|
96
|
+
az cosmosdb sql container throughput show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_SQL_DATABASE" --name "$COSMOS_SQL_CONTAINER" --output json # [COSMOS-E911]
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
**MongoDB (RU-based):**
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
: "${COSMOS_MONGO_DATABASE:?Approved database}" "${COSMOS_MONGO_COLLECTION:?Approved collection}"
|
|
103
|
+
az cosmosdb mongodb database list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output table # [COSMOS-E913]
|
|
104
|
+
az cosmosdb mongodb collection show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_MONGO_DATABASE" --name "$COSMOS_MONGO_COLLECTION" --output json # [COSMOS-E914]
|
|
105
|
+
az cosmosdb mongodb collection throughput show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --database-name "$COSMOS_MONGO_DATABASE" --name "$COSMOS_MONGO_COLLECTION" --output json # [COSMOS-E915]
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**Cassandra:**
|
|
109
|
+
|
|
110
|
+
```bash
|
|
111
|
+
: "${COSMOS_CASSANDRA_KEYSPACE:?Approved keyspace}" "${COSMOS_CASSANDRA_TABLE:?Approved table}"
|
|
112
|
+
az cosmosdb cassandra keyspace list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output table # [COSMOS-E917]
|
|
113
|
+
az cosmosdb cassandra table show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --keyspace-name "$COSMOS_CASSANDRA_KEYSPACE" --name "$COSMOS_CASSANDRA_TABLE" --output json # [COSMOS-E918]
|
|
114
|
+
az cosmosdb cassandra table throughput show --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --keyspace-name "$COSMOS_CASSANDRA_KEYSPACE" --name "$COSMOS_CASSANDRA_TABLE" --output json # [COSMOS-E919]
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
## IAM
|
|
118
|
+
|
|
119
|
+
- Account flags such as `disableLocalAuth` and `disableKeyBasedMetadataWriteAccess`
|
|
120
|
+
come from the account JSON; absent fields are UNVERIFIED.
|
|
121
|
+
- NoSQL and MongoDB: list data-plane role definitions. Cassandra: the role commands
|
|
122
|
+
found are extension commands; not covered here, so check identity settings from
|
|
123
|
+
the account JSON and the operations file.
|
|
124
|
+
|
|
125
|
+
**All APIs:**
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
jq '{disableLocalAuth, disableKeyBasedMetadataWriteAccess}' "$audit_dir/account.json" # [COSMOS-E902]
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
**NoSQL:**
|
|
132
|
+
|
|
133
|
+
```bash
|
|
134
|
+
az cosmosdb sql role definition list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json # [COSMOS-E912]
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
**MongoDB:**
|
|
138
|
+
|
|
139
|
+
```bash
|
|
140
|
+
az cosmosdb mongodb role definition list --account-name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json # [COSMOS-E916]
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
## Tagging
|
|
144
|
+
|
|
145
|
+
- All APIs: tags are on the account resource; inspect the account JSON. Database
|
|
146
|
+
and container tagging is not confirmed in the operations files.
|
|
147
|
+
|
|
148
|
+
```bash
|
|
149
|
+
jq '{tags}' "$audit_dir/account.json" # [COSMOS-E902]
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
## Encryption
|
|
153
|
+
|
|
154
|
+
- All APIs: customer-managed key URI and identity come from the account JSON; the
|
|
155
|
+
key itself is never read. Absent fields are UNVERIFIED.
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
jq '{keyVaultKeyUri, defaultIdentity, minimalTlsVersion}' "$audit_dir/account.json" # [COSMOS-E902]
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
## Network isolation
|
|
162
|
+
|
|
163
|
+
- All APIs: public access, IP rules and virtual network rules from the account
|
|
164
|
+
JSON; list virtual network rules and private endpoint connections.
|
|
165
|
+
|
|
166
|
+
```bash
|
|
167
|
+
jq '{publicNetworkAccess, ipRules, isVirtualNetworkFilterEnabled, virtualNetworkRules}' "$audit_dir/account.json" # [COSMOS-E902]
|
|
168
|
+
az cosmosdb network-rule list --name "$COSMOS_ACCOUNT" --resource-group "$COSMOS_RG" --output json # [COSMOS-E904]
|
|
169
|
+
az network private-endpoint-connection list --id "$COSMOS_ACCOUNT_ID" --output json # [COSMOS-E905]
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
## Audit logging
|
|
173
|
+
|
|
174
|
+
- All APIs: list the diagnostic settings on the account and compare the enabled
|
|
175
|
+
categories with the operations file for that API (control plane and API request
|
|
176
|
+
categories).
|
|
177
|
+
|
|
178
|
+
```bash
|
|
179
|
+
az monitor diagnostic-settings list --resource "$COSMOS_ACCOUNT_ID" --output json # [COSMOS-E906]
|
|
180
|
+
```
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
# audit --mode offline
|
|
2
|
+
|
|
3
|
+
Inputs are the repository (Bicep, ARM, Terraform, application and client config)
|
|
4
|
+
and sanitized exports supplied by the user. No Azure CLI, network call, credential
|
|
5
|
+
or customer data. Commands are local only (`rg`, `grep`, `jq`, `find`, `git`,
|
|
6
|
+
`terraform show` on a saved plan). Property names follow the ARM
|
|
7
|
+
`Microsoft.DocumentDB/databaseAccounts` template reference; patterns are
|
|
8
|
+
case-insensitive so camelCase and snake_case spellings both match. Compare
|
|
9
|
+
findings with the operations reference for the API in scope:
|
|
10
|
+
[NoSQL](../../operations.md), [MongoDB](../../operations-mongodb.md),
|
|
11
|
+
[Cassandra](../../operations-cassandra.md).
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
: "${REPO:?Approved repository path}"
|
|
15
|
+
cd "$REPO"
|
|
16
|
+
rg -n -i 'Microsoft\.DocumentDB/databaseAccounts' --glob '*.bicep' --glob '*.json' --glob '*.tf'
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Backup and restore
|
|
20
|
+
|
|
21
|
+
- Check `backupPolicy`: `type` (Periodic or Continuous), `continuousModeProperties`
|
|
22
|
+
tier, and for periodic `backupIntervalInMinutes`, `backupRetentionIntervalInHours`
|
|
23
|
+
and `backupStorageRedundancy`.
|
|
24
|
+
- NoSQL: a continuous account cannot return to periodic, so flag any template that
|
|
25
|
+
flips the type. MongoDB and Cassandra: confirm which backup modes the operations
|
|
26
|
+
file lists for that API before judging.
|
|
27
|
+
- Look for restore settings (`createMode`, `restoreParameters`, `restoreMode`) left
|
|
28
|
+
in a template that is re-applied routinely.
|
|
29
|
+
- Firewall, virtual network, private endpoint and data-plane role settings are not
|
|
30
|
+
restored; look for IaC that recreates them.
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
rg -n -i 'backup.?policy|continuous.?mode|periodic.?mode|backup.?interval|backup.?retention|backup.?storage.?redundancy|create.?mode|restore.?(parameters|mode)' --glob '*.bicep' --glob '*.json' --glob '*.tf'
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## Disaster recovery and replication
|
|
37
|
+
|
|
38
|
+
- Check `locations` entries for `failoverPriority` and `isZoneRedundant` per region,
|
|
39
|
+
`enableAutomaticFailover` and `enableMultipleWriteLocations`.
|
|
40
|
+
- NoSQL: serverless accounts are single-region. MongoDB and Cassandra: check the
|
|
41
|
+
operations file for the multi-region behavior of that API.
|
|
42
|
+
- Check `consistencyPolicy` against the stated RPO needs; Strong is not available
|
|
43
|
+
with multiple write regions in the NoSQL reference.
|
|
44
|
+
- Client code: look for preferred or excluded region settings and retry policy.
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
rg -n -i 'locations|failover.?priority|is.?zone.?redundant|enable.?automatic.?failover|enable.?multiple.?write.?locations|consistency.?policy|default.?consistency|preferred.?regions|excluded.?regions' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
## Cost
|
|
51
|
+
|
|
52
|
+
- Throughput mode: provisioned, autoscale (maximum throughput) or serverless;
|
|
53
|
+
look for oversized fixed RU/s and for `capacity.totalThroughputLimit`.
|
|
54
|
+
- Features that add billing dimensions per the operations file: extra regions,
|
|
55
|
+
`enableMultipleWriteLocations`, analytical storage, zone redundancy, continuous
|
|
56
|
+
backup tiers, diagnostic export to Log Analytics.
|
|
57
|
+
- Do not write prices or amounts; record dimensions only.
|
|
58
|
+
- NoSQL, MongoDB and Cassandra each list their own meters; use the file for the API
|
|
59
|
+
in scope.
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
rg -n -i 'autoscale|max.?throughput|throughput|total.?throughput.?limit|enable.?analytical.?storage|serverless' --glob '*.bicep' --glob '*.json' --glob '*.tf'
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
## Monitoring
|
|
66
|
+
|
|
67
|
+
- Look for alert rules or metric alerts on the account resource (for example on
|
|
68
|
+
`NormalizedRUConsumption` and `TotalRequests`) and who owns them.
|
|
69
|
+
- Check client code and logs for handling of HTTP 429 and retry settings, so
|
|
70
|
+
throttling is visible and not only masked by SDK retries.
|
|
71
|
+
- MongoDB: look for request-charge and 16500 handling; Cassandra: look for
|
|
72
|
+
`OverloadedException` handling. Confirm the exact codes in the operations file.
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
rg -n -i 'NormalizedRUConsumption|TotalRequests|metric.?alert|429|too.?many.?requests|max.?retry|retry.?(policy|options)' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Performance
|
|
79
|
+
|
|
80
|
+
- Partition key choice in container or collection definitions (`partitionKey`,
|
|
81
|
+
shard key, Cassandra partition key); flag keys with low cardinality or skew.
|
|
82
|
+
- Indexing policy (`indexingPolicy`) that indexes everything on write-heavy paths,
|
|
83
|
+
or composite indexes missing for sorted queries (NoSQL).
|
|
84
|
+
- Client singletons and connection mode; cross-partition or unbounded queries in
|
|
85
|
+
hot paths.
|
|
86
|
+
- MongoDB and Cassandra: use the performance section of the operations file for
|
|
87
|
+
API-specific limits.
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
rg -n -i 'partition.?key|shard.?key|indexing.?policy|composite.?indexes|included.?paths|excluded.?paths|cross.?partition|enable.?cross.?partition' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
## IAM
|
|
94
|
+
|
|
95
|
+
- `disableLocalAuth` set to true where Microsoft Entra ID is the intended data
|
|
96
|
+
access path; flag connection strings or account keys in repository config.
|
|
97
|
+
- `disableKeyBasedMetadataWriteAccess` for control-plane changes.
|
|
98
|
+
- NoSQL data-plane RBAC role definitions and assignments are separate resources
|
|
99
|
+
from Azure RBAC; check their scope and that built-in roles are preferred.
|
|
100
|
+
- MongoDB: native role-based access (`EnableMongoRoleBasedAccessControl` capability
|
|
101
|
+
per the operations file). Cassandra: confirm identity options in its file.
|
|
102
|
+
- The second command looks for account keys and credentialed connection strings; it
|
|
103
|
+
lists files only. Never print the matching line.
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
rg -n -i 'disable.?local.?auth|disable.?key.?based.?metadata.?write.?access|sqlRoleAssignments|sqlRoleDefinitions|role.?definition.?id|principal.?id|EnableMongoRoleBasedAccessControl' --glob '!node_modules' .
|
|
107
|
+
rg -l -i 'AccountEndpoint=|AccountKey=|mongodb(\+srv)?://[^ ]*@' --glob '!node_modules' .
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## Tagging
|
|
111
|
+
|
|
112
|
+
- Check the `tags` object on the account resource for the owner, environment and
|
|
113
|
+
data-classification keys the organization requires.
|
|
114
|
+
- Container and database tagging is not confirmed in the operations file; do not
|
|
115
|
+
report missing tags there as a defect without evidence.
|
|
116
|
+
- Look for Azure Policy definitions or assignments that require tags.
|
|
117
|
+
|
|
118
|
+
```bash
|
|
119
|
+
rg -n -i '\btags\b' --glob '*.bicep' --glob '*.json' --glob '*.tf'
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## Encryption
|
|
123
|
+
|
|
124
|
+
- Customer-managed key: `keyVaultKeyUri` on the account and `defaultIdentity`;
|
|
125
|
+
the operations file lists the Key Vault prerequisites.
|
|
126
|
+
- `minimalTlsVersion` and client-side TLS settings; flag TLS below the documented
|
|
127
|
+
minimum or certificate validation disabled in client code.
|
|
128
|
+
- Confirm the identity type used for key access per the operations file.
|
|
129
|
+
|
|
130
|
+
```bash
|
|
131
|
+
rg -n -i 'key.?vault.?key.?uri|default.?identity|minimal.?tls.?version|tls.?version|ssl.?invalid|verify.?cert|trust.?all|insecure.?skip' --glob '*.bicep' --glob '*.json' --glob '*.tf' --glob '*.cs' --glob '*.java' --glob '*.py' --glob '*.ts'
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
## Network isolation
|
|
135
|
+
|
|
136
|
+
- `publicNetworkAccess`, `ipRules`, `isVirtualNetworkFilterEnabled`,
|
|
137
|
+
`virtualNetworkRules` and `networkAclBypass`; flag open or wide ranges.
|
|
138
|
+
- Private endpoint resources (`Microsoft.Network/privateEndpoints`) and the group
|
|
139
|
+
id each uses for the API in scope.
|
|
140
|
+
- Private DNS zones linked for the account endpoints; a private endpoint without
|
|
141
|
+
DNS resolution does not isolate clients.
|
|
142
|
+
|
|
143
|
+
```bash
|
|
144
|
+
rg -n -i 'public.?network.?access|ip.?rules|is.?virtual.?network.?filter.?enabled|virtual.?network.?rules|network.?acl.?bypass|privateEndpoints|private.?link|privatelink\.' --glob '*.bicep' --glob '*.json' --glob '*.tf'
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
## Audit logging
|
|
148
|
+
|
|
149
|
+
- A `Microsoft.Insights/diagnosticSettings` resource scoped to the account with the
|
|
150
|
+
log categories the operations file names (control plane and, per API, data-plane
|
|
151
|
+
request categories).
|
|
152
|
+
- Destination (Log Analytics, Storage, Event Hubs) and retention owner. For
|
|
153
|
+
Cassandra, full-text diagnostics can log query parameters (PII); check the
|
|
154
|
+
warning in its operations file.
|
|
155
|
+
- Disabling key-based metadata writes keeps control-plane changes on the audited
|
|
156
|
+
path.
|
|
157
|
+
|
|
158
|
+
```bash
|
|
159
|
+
rg -n -i 'diagnosticSettings|ControlPlaneRequests|DataPlaneRequests|MongoRequests|CassandraRequests|QueryRuntimeStatistics|log.?analytics|workspace.?id' --glob '*.bicep' --glob '*.json' --glob '*.tf'
|
|
160
|
+
```
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# audit
|
|
2
|
+
|
|
3
|
+
Load only for an audit request. Offline is the default. After reading this file,
|
|
4
|
+
load **only** the selected variant: [offline](audit/offline.md) or
|
|
5
|
+
[live](audit/live.md). Do not read both.
|
|
6
|
+
|
|
7
|
+
## Scope
|
|
8
|
+
|
|
9
|
+
- Name the API (NoSQL, MongoDB RU-based, Cassandra), the account, the resources
|
|
10
|
+
and the selected sections of the operations reference for that API:
|
|
11
|
+
[NoSQL](../operations.md), [MongoDB](../operations-mongodb.md),
|
|
12
|
+
[Cassandra](../operations-cassandra.md). Load only the operations file for the
|
|
13
|
+
API in question; unselected sections and APIs are out of scope.
|
|
14
|
+
- Azure DocumentDB (vCore-based, MongoDB compatible) is a separate service and is
|
|
15
|
+
out of scope.
|
|
16
|
+
- An audit is a technical risk review, not a compliance attestation.
|
|
17
|
+
|
|
18
|
+
## Findings
|
|
19
|
+
|
|
20
|
+
For each finding give: severity, section, evidence (file:line, or sanitized command
|
|
21
|
+
output with its retrieval time), the expectation from the operations reference with
|
|
22
|
+
its evidence ID, impact, the smallest proposed fix and how to verify it.
|
|
23
|
+
|
|
24
|
+
- PASS only for a check actually performed. Missing evidence is UNVERIFIED.
|
|
25
|
+
- An absent repository setting does not prove the live setting is off.
|
|
26
|
+
- Propose fixes; never apply them as part of the audit.
|
package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md
ADDED
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
# Cosmos DB for NoSQL: consistency, capacity and data-plane security
|
|
2
|
+
|
|
3
|
+
Load this for consistency-level choice, session tokens, the integrated cache,
|
|
4
|
+
serverless vs provisioned vs autoscale, logical-partition limits, or Entra ID
|
|
5
|
+
data-plane RBAC. Every bracketed ID resolves in
|
|
6
|
+
[evidence-ledger.md](evidence-ledger.md). Text without an ID is labeled
|
|
7
|
+
inference or recommendation. API for NoSQL only.
|
|
8
|
+
|
|
9
|
+
## Consistency
|
|
10
|
+
|
|
11
|
+
| Level | Read RU cost | What it gives | Region-outage RPO (more than one region) | Evidence |
|
|
12
|
+
| --- | --- | --- | --- | --- |
|
|
13
|
+
| Strong | 2x | linearizable reads; writes commit in every region; **not available with multiple write regions**; spans over 5,000 miles blocked by default | 0 | [COSMOS-E02] [COSMOS-E17] [COSMOS-E18] |
|
|
14
|
+
| Bounded staleness | 2x | reads lag by at most K versions or T time | K and T | [COSMOS-E02] [COSMOS-E18] |
|
|
15
|
+
| Session | 1x | read-your-writes per session; the most widely used level | under 15 min | [COSMOS-E03] [COSMOS-E18] |
|
|
16
|
+
| Consistent prefix | 1x | transactional-batch writes become visible together; single-document writes behave eventually | under 15 min | [COSMOS-E04] [COSMOS-E18] |
|
|
17
|
+
| Eventual | 1x | staleness-tolerant reads | under 15 min | [COSMOS-E01] [COSMOS-E18] |
|
|
18
|
+
|
|
19
|
+
- Read consistency is scoped to one read within a logical partition
|
|
20
|
+
[COSMOS-E01]. Cross-partition invariants need application design, not a
|
|
21
|
+
stronger level. *(inference)*
|
|
22
|
+
- Strong across regions costs write latency of about twice the round trip to
|
|
23
|
+
the farthest region plus 10 ms at p99 [COSMOS-E17]. Choosing multi-region
|
|
24
|
+
writes rules Strong out entirely [COSMOS-E17]. Treat "multi-write + strong"
|
|
25
|
+
as a contradiction to resolve, not a configuration. *(recommendation)*
|
|
26
|
+
- A single-region account has RPO under 240 minutes at every level
|
|
27
|
+
[COSMOS-E18]. A consistency level is not a DR plan.
|
|
28
|
+
|
|
29
|
+
### Session tokens: where read-your-writes quietly breaks
|
|
30
|
+
|
|
31
|
+
- Tokens are **partition-bound**. Per the consistency-levels page, a client
|
|
32
|
+
that has not written to a physical partition has no cached token for it and
|
|
33
|
+
reads it as eventual [COSMOS-E03]. Read responses also return a session
|
|
34
|
+
token, which Microsoft's examples pass explicitly on later reads
|
|
35
|
+
[COSMOS-E21]. Whether a given SDK caches read-acquired tokens automatically
|
|
36
|
+
is not documented, so do not tell a read-only service that it must write to
|
|
37
|
+
get session behavior. Check that SDK's behavior first. *(inference)*
|
|
38
|
+
- A **re-created client** (pod restart, per-request client construction,
|
|
39
|
+
serverless cold start) loses its token cache and reads as eventual until the
|
|
40
|
+
cache is rebuilt [COSMOS-E03]. To see writes made before the restart, carry
|
|
41
|
+
their session token forward explicitly [COSMOS-E03] [COSMOS-E21]. Per-request `CosmosClient` construction
|
|
42
|
+
therefore also breaks session guarantees, on top of its connection cost.
|
|
43
|
+
*(inference)*
|
|
44
|
+
- Read-your-writes across services (a write in API A, then a read in worker B)
|
|
45
|
+
requires passing the session token, **unmodified** [COSMOS-E03].
|
|
46
|
+
|
|
47
|
+
### Overriding consistency per request
|
|
48
|
+
|
|
49
|
+
- `ConsistencyLevel` overrides can only **relax** below the account default
|
|
50
|
+
[COSMOS-E05].
|
|
51
|
+
- `ReadConsistencyStrategy` can also **strengthen** above it (for example
|
|
52
|
+
`LatestCommitted`, `GlobalStrong`) and wins when both are set
|
|
53
|
+
[COSMOS-E05]. It is **preview**, **direct mode only** [COSMOS-E05], and
|
|
54
|
+
documented only for Java SDK v4.69+ and .NET SDK v3.46+ [COSMOS-E06]. Do not
|
|
55
|
+
recommend it for Python, JavaScript or Go, or for production paths that
|
|
56
|
+
cannot accept preview behavior. *(recommendation)*
|
|
57
|
+
- Because it needs direct mode and the integrated cache needs gateway mode
|
|
58
|
+
[COSMOS-E08], one client cannot use both. *(inference)*
|
|
59
|
+
- Read-path changes only: write RU cost does not change with level
|
|
60
|
+
[COSMOS-E02].
|
|
61
|
+
|
|
62
|
+
## Integrated cache (dedicated gateway)
|
|
63
|
+
|
|
64
|
+
All three must hold for a cache hit [COSMOS-E08]:
|
|
65
|
+
|
|
66
|
+
1. the client uses the **dedicated gateway endpoint**;
|
|
67
|
+
2. the client uses **gateway mode**. .NET and Java default to direct mode and
|
|
68
|
+
silently miss the cache [COSMOS-E08];
|
|
69
|
+
3. the read is **Session or Eventual**. Strong, Bounded staleness and
|
|
70
|
+
Consistent prefix bypass it [COSMOS-E07].
|
|
71
|
+
|
|
72
|
+
Staleness is bounded by `MaxIntegratedCacheStaleness` (default 5 min). A value
|
|
73
|
+
of 0 means reads never use the cache, although writes still populate it
|
|
74
|
+
[COSMOS-E07] [COSMOS-E08]. Production use needs at least three gateway nodes
|
|
75
|
+
for SLA coverage, and the gateway carries no latency SLA [COSMOS-E09]. Reject
|
|
76
|
+
the cache when reads rarely repeat, the app needs Strong or Bounded staleness,
|
|
77
|
+
or a direct-mode app cannot switch. *(recommendation)*
|
|
78
|
+
|
|
79
|
+
## Capacity model
|
|
80
|
+
|
|
81
|
+
| Mode | Use when | Hard limits | Evidence |
|
|
82
|
+
| --- | --- | --- | --- |
|
|
83
|
+
| Provisioned (manual) | steady, predictable traffic | 429s if consumption exceeds provisioned RU/s | [COSMOS-E12] |
|
|
84
|
+
| Autoscale | variable traffic | scales 0.1 x Tmax to Tmax; billed at hourly peak (min 0.1 x Tmax) | [COSMOS-E13] |
|
|
85
|
+
| Serverless | intermittent, low average-to-peak | **cannot add regions after creation** while serverless; no throughput or latency guarantee; 5,000 RU/s per physical partition; no shared-throughput DB | [COSMOS-E10] [COSMOS-E11] [COSMOS-E19] |
|
|
86
|
+
|
|
87
|
+
Any mode is capped at **10,000 RU/s and 20 GB per logical partition**, and
|
|
88
|
+
work beyond a physical partition's share is rate-limited [COSMOS-E12]. A hot or
|
|
89
|
+
large partition-key value is a modeling defect that no capacity mode fixes.
|
|
90
|
+
Use hierarchical partition keys (up to three levels) when one key value would
|
|
91
|
+
exceed 20 GB [COSMOS-E12].
|
|
92
|
+
|
|
93
|
+
- Autoscale avoids 429s only while total consumption stays within the
|
|
94
|
+
configured range [COSMOS-E13]. A hot partition can still be rate-limited
|
|
95
|
+
[COSMOS-E12], and shared-database autoscale lets one container's burst
|
|
96
|
+
throttle the others [COSMOS-E13]. Prefer container-level autoscale.
|
|
97
|
+
*(recommendation)*
|
|
98
|
+
- A serverless account cannot add regions after creation [COSMOS-E10]. The
|
|
99
|
+
only path to multi-region is an **in-place, one-time, irreversible**
|
|
100
|
+
conversion to provisioned throughput, which has no duration SLA and blocks
|
|
101
|
+
management operations while it runs [COSMOS-E20]. "Serverless now, DR
|
|
102
|
+
later" therefore means a planned capacity-mode migration, an approved
|
|
103
|
+
change window, and losing serverless billing for good. If DR is a known
|
|
104
|
+
requirement, start on provisioned or autoscale. *(recommendation)*
|
|
105
|
+
- Prices are not in this ledger. A cost estimate must cite a freshly retrieved
|
|
106
|
+
Azure pricing page or be labeled an assumption.
|
|
107
|
+
|
|
108
|
+
## Data-plane vs control-plane security
|
|
109
|
+
|
|
110
|
+
These are **two different RBAC systems**:
|
|
111
|
+
|
|
112
|
+
| Plane | Covers | Mechanism | Evidence |
|
|
113
|
+
| --- | --- | --- | --- |
|
|
114
|
+
| Data plane | item CRUD, queries, change feed, stored procedures, conflict feed | Cosmos DB native RBAC (`sqlRoleDefinitions`/`sqlRoleAssignments`); built-in Data Reader / Data Contributor | [COSMOS-E14] |
|
|
115
|
+
| Control plane | keys and connection strings, backup/restore, databases/containers, account properties | Azure RBAC | [COSMOS-E15] |
|
|
116
|
+
|
|
117
|
+
Review rules:
|
|
118
|
+
|
|
119
|
+
- An Azure RBAC assignment does not grant data access through native
|
|
120
|
+
data-plane RBAC. Check both planes separately. *(inference from E14/E15)*
|
|
121
|
+
- **But keys bridge the planes.** A control-plane role that can read account
|
|
122
|
+
keys or connection strings [COSMOS-E15] obtains a credential that works for
|
|
123
|
+
data access unless key auth is disabled [COSMOS-E16]. Treat key-listing
|
|
124
|
+
permissions as data access. *(inference)*
|
|
125
|
+
- Data-plane roles have no `notDataActions`. Build least privilege by listing
|
|
126
|
+
allowed `dataActions` only [COSMOS-E14]. Scope to a database or container,
|
|
127
|
+
not the account, where the workload allows. *(recommendation)*
|
|
128
|
+
- Data-plane assignments cannot be managed in the portal [COSMOS-E14]. Expect
|
|
129
|
+
CLI, PowerShell or IaC evidence.
|
|
130
|
+
- Whoever holds control-plane `sqlRoleAssignments/write` can grant themselves
|
|
131
|
+
data access [COSMOS-E14]. Treat that permission as data-sensitive.
|
|
132
|
+
*(inference)*
|
|
133
|
+
- For Entra-only workloads, disable key auth with `disableLocalAuth=true` and
|
|
134
|
+
verify that a key-based connection fails [COSMOS-E16]. That is an account
|
|
135
|
+
mutation: it needs an explicit target, confirmation that no consumer still
|
|
136
|
+
uses keys, a rollback plan and approval.
|
package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md
CHANGED
|
@@ -36,7 +36,7 @@ Microsoft Learn describes Cosmos DB as an account containing databases and conta
|
|
|
36
36
|
|
|
37
37
|
- Multi-region account configuration does not prove application failover unless SDK preferred regions, retries, conflict handling, and remaining-region capacity are verified.
|
|
38
38
|
- Private endpoints can break regional resilience if DNS zones, VNet links, forwarding, and local regional endpoint paths are not designed deliberately.
|
|
39
|
-
- Strong, bounded staleness, session, and eventual consistency have different availability, RPO, and throughput implications; do not treat consistency as a cosmetic setting.
|
|
39
|
+
- Strong, bounded staleness, session, consistent prefix, and eventual consistency (all five levels; see `consistency-capacity-security.md`) have different availability, RPO, and throughput implications; do not treat consistency as a cosmetic setting.
|
|
40
40
|
- Control-plane changes during an affected-region outage can delay recovery; do not mutate write region, consistency, throughput, networking, or failover priorities casually.
|
|
41
41
|
- Backup protects data recovery scenarios; it is not a substitute for live availability, failover routing, or tested application DR.
|
|
42
42
|
|