@raishin/vanguard-frontier-agentic 3.18.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +8 -1
- package/.cursor-plugin/plugin.json +8 -1
- package/.github/plugin/marketplace.json +1 -1
- package/README.md +21 -21
- package/agents/AGENTS.md +4 -4
- package/agents/README.md +7 -7
- package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
- package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
- package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
- package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
- package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
- package/catalog/agents.json +204 -1
- package/catalog/asset-integrity.json +620 -75
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +2074 -527
- package/catalog/skills.json +314 -14
- package/package.json +8 -2
- package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
- package/powers/vanguard-alibaba/POWER.md +1 -1
- package/powers/vanguard-aws/POWER.md +1 -1
- package/powers/vanguard-azure/POWER.md +1 -1
- package/powers/vanguard-gcp/POWER.md +1 -1
- package/powers/vanguard-huawei/POWER.md +1 -1
- package/powers/vanguard-oci/POWER.md +1 -1
- package/rules/codex/cloud-provenance-rule.md +1 -1
- package/scripts/generate-kiro-powers.mjs +2 -2
- package/skills/alibaba/README.md +2 -1
- package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
- package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
- package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
- package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
- package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
- package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
- package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
- package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
- package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
- package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
- package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
- package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
- package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
- package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
- package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
- package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
- package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
- package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
- package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
- package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
- package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
- package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
- package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
- package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
- package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
- package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
- package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
- package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
- package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
- package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
- package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
- package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
- package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
- package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
- package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
- package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
- package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
- package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
- package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
- package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
- package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
- package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
- package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-maestro/SKILL.md +1 -1
- package/skills/aws/aws-maestro/metadata.json +1 -1
- package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
- package/skills/azure/azure-ai-foundry-ops-governor/SKILL.md +2 -2
- package/skills/azure/azure-aks-platform-operator/SKILL.md +1 -1
- package/skills/azure/azure-app-service-production-readiness/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +5 -3
- package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
- package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
- package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
- package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
- package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
- package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
- package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
- package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
- package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
- package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
- package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
- package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
- package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
- package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
- package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
- package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
- package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
- package/skills/azure/azure-cosmosdb-performance-investigator/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +7 -3
- package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
- package/skills/azure/azure-cost-estimation-review/SKILL.md +1 -1
- package/skills/azure/azure-cost-optimization-governor/SKILL.md +1 -1
- package/skills/azure/azure-entra-id-specialist/SKILL.md +1 -1
- package/skills/azure/azure-governance-policy-guardrails/SKILL.md +1 -1
- package/skills/azure/azure-identity-governance-review/SKILL.md +1 -1
- package/skills/azure/azure-key-vault-secret-lifecycle-auditor/SKILL.md +1 -1
- package/skills/azure/azure-landing-zone-architect/SKILL.md +1 -1
- package/skills/azure/azure-maestro/SKILL.md +2 -1
- package/skills/azure/azure-migrate-landing-zone-cutover/SKILL.md +1 -1
- package/skills/azure/azure-network-topology-review/SKILL.md +1 -1
- package/skills/azure/azure-observability-investigator/SKILL.md +1 -1
- package/skills/azure/azure-platform-automation-devops/SKILL.md +1 -1
- package/skills/azure/azure-private-endpoint-adoption-planner/SKILL.md +1 -1
- package/skills/azure/azure-rbac-review/SKILL.md +1 -1
- package/skills/azure/azure-resilience-bcdr-review/SKILL.md +1 -1
- package/skills/azure/azure-resource-health-incident-triage/SKILL.md +1 -1
- package/skills/azure/azure-role-selector/SKILL.md +1 -1
- package/skills/azure/azure-security-posture-hardening/SKILL.md +1 -1
- package/skills/azure/azure-subscription-resource-organization/SKILL.md +1 -1
- package/skills/azure/azure-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-reliability-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-security-review/SKILL.md +1 -1
- package/skills/contabo/contabo-security-hardening/SKILL.md +1 -1
- package/skills/cross-functional/agentic-board-protocol/SKILL.md +1 -1
- package/skills/cross-functional/copilot-data-readiness-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-case-capsule/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-data-exposure-escalation-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-live-change-approval-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-risk-taxonomy/SKILL.md +1 -1
- package/skills/databricks/databricks-lakehouse-engineering-at-azure/SKILL.md +1 -1
- package/skills/databricks/databricks-unity-catalog-governance-at-azure/SKILL.md +1 -1
- package/skills/dotnet/dotnet-performance-aot-review/SKILL.md +1 -1
- package/skills/frontend/vue-router-navigation-security-review/SKILL.md +1 -1
- package/skills/gcp/README.md +2 -1
- package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
- package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
- package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
- package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
- package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
- package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
- package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
- package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
- package/skills/gcp/gcp-maestro/SKILL.md +2 -1
- package/skills/huawei/README.md +2 -1
- package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
- package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
- package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
- package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
- package/skills/huawei/huawei-maestro/SKILL.md +2 -1
- package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
- package/skills/java/java-application-server-exit/SKILL.md +1 -1
- package/skills/java/java-jvm-performance-and-gc/SKILL.md +1 -1
- package/skills/java/java-resilience-pattern/SKILL.md +1 -1
- package/skills/java/java-test-architecture/SKILL.md +1 -1
- package/skills/java/java-transaction-and-consistency/SKILL.md +1 -1
- package/skills/kubernetes/kubernetes-rbac-review/SKILL.md +1 -1
- package/skills/marketing/analytics-data-minimization-review/SKILL.md +1 -1
- package/skills/microsoft/d365-customer-insights-journeys/SKILL.md +1 -1
- package/skills/microsoft/fabric-analytics-engineering/SKILL.md +1 -1
- package/skills/microsoft/m365-defender-xdr-security-operations/SKILL.md +1 -1
- package/skills/microsoft/m365-purview-data-security-compliance/SKILL.md +1 -1
- package/skills/oci/README.md +6 -1
- package/skills/oci/oci-autonomous-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-certificates-issuer-review/SKILL.md +1 -1
- package/skills/oci/oci-cloud-guard-responder/SKILL.md +1 -1
- package/skills/oci/oci-compute-instance-agent-operator/SKILL.md +1 -1
- package/skills/oci/oci-compute-platform-operator/SKILL.md +1 -1
- package/skills/oci/oci-cost-finops-analyst/SKILL.md +1 -1
- package/skills/oci/oci-database-platform-dba/SKILL.md +1 -1
- package/skills/oci/oci-dbtools-sql-analyst/SKILL.md +1 -1
- package/skills/oci/oci-devops-container-platform-engineer/SKILL.md +1 -1
- package/skills/oci/oci-exadata-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-exadata-platform-architect/SKILL.md +1 -1
- package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md +1 -1
- package/skills/oci/oci-goldengate-replication-operator/SKILL.md +1 -1
- package/skills/oci/oci-identity-access-governor/SKILL.md +1 -1
- package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md +1 -1
- package/skills/oci/oci-limits-capacity-planner/SKILL.md +1 -1
- package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-network-security-rule-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-oke-rollout-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-resource-manager-stack-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-vault-key-destruction-guard/SKILL.md +1 -1
- package/skills/oci/oci-load-balancer-traffic-engineer/SKILL.md +1 -1
- package/skills/oci/oci-maestro/SKILL.md +1 -1
- package/skills/oci/oci-migration-cutover-architect/SKILL.md +1 -1
- package/skills/oci/oci-multi-cloud-architect/SKILL.md +1 -1
- package/skills/oci/oci-mysql-heatwave-ai-specialist/SKILL.md +1 -1
- package/skills/oci/oci-network-architect/SKILL.md +1 -1
- package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
- package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
- package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
- package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
- package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
- package/skills/oci/oci-nosql-pattern/README.md +81 -0
- package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
- package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
- package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
- package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
- package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
- package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
- package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
- package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
- package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
- package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
- package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
- package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
- package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
- package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
- package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
- package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
- package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
- package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
- package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
- package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
- package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
- package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
- package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
- package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
- package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
- package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
- package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
- package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
- package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
- package/skills/oci/oci-observability-incident-responder/SKILL.md +1 -1
- package/skills/oci/oci-recovery-service-operator/SKILL.md +1 -1
- package/skills/oci/oci-registry-artifact-governor/SKILL.md +1 -1
- package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md +1 -1
- package/skills/oci/oci-security-compliance-reviewer/SKILL.md +1 -1
- package/skills/oci/oci-solution-architect/SKILL.md +1 -1
- package/skills/oci/oci-storage-backup-steward/SKILL.md +1 -1
- package/skills/oci/oci-support-incident-coordinator/SKILL.md +1 -1
- package/skills/oci/oci-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-reliability-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-security-review/SKILL.md +1 -1
- package/skills/oci/oracle-oci-mcp-grounded-advisor/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-cost-finops-analyst/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-live-kms-key-destruction-guard/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/salesforce/salesforce-agentforce-risk-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-apex-lwc-code-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-devsecops-pipeline-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-flow-automation-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-infrastructure-audit-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-integration-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-marketing-consent-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-metadata-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-org-assessment-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-permission-model-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-release-readiness-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-zero-trust-maturity-skill/SKILL.md +1 -1
- package/skills/sap/sap-analytics-cloud-planning-governance/SKILL.md +1 -1
- package/skills/sap/sap-btp-governance-review/SKILL.md +1 -1
- package/skills/sap/sap-cloud-alm-sre-incident-review/SKILL.md +1 -1
- package/skills/sap/sap-datasphere-data-product-architecture/SKILL.md +1 -1
- package/skills/sap/sap-ewm-tm-logistics-execution-review/SKILL.md +1 -1
- package/skills/sap/sap-finance-fico-controls-review/SKILL.md +1 -1
- package/skills/sap/sap-hana-cloud-performance-cost/SKILL.md +1 -1
- package/skills/sap/sap-hypercare-incident-commander-review/SKILL.md +1 -1
- package/skills/sap/sap-integration-suite-review/SKILL.md +1 -1
- package/skills/sap/sap-joule-governance-adoption-review/SKILL.md +1 -1
- package/skills/sap/sap-license-btp-consumption-finops-review/SKILL.md +1 -1
- package/skills/sap/sap-manufacturing-execution-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-mdg-master-data-quality-review/SKILL.md +1 -1
- package/skills/sap/sap-order-to-cash-review/SKILL.md +1 -1
- package/skills/sap/sap-procurement-ariba-value-leakage-review/SKILL.md +1 -1
- package/skills/sap/sap-release-change-collision-review/SKILL.md +1 -1
- package/skills/sap/sap-rise-sla-vendor-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-security-iam-grc-sod-review/SKILL.md +1 -1
- package/skills/sap/sap-signavio-process-mining-value/SKILL.md +1 -1
- package/skills/sap/sap-successfactors-hr-process-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-supply-chain-ibp-resilience-review/SKILL.md +1 -1
- package/skills/sap/sap-testing-quality-gate-review/SKILL.md +1 -1
- package/skills/sap/sap-transformation-portfolio-triage-review/SKILL.md +1 -1
- package/skills/sap/sap-treasury-cash-risk-review/SKILL.md +1 -1
- package/skills/scaleway/scaleway-kapsule-platform-operator/SKILL.md +1 -1
- package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/scaleway/scaleway-network-architect/SKILL.md +1 -1
- package/templates/nosql-audit-template.md +127 -0
- package/templates/nosql-operations-template.md +60 -0
- package/tests/_generate_maestro_routing_fixtures.py +11 -0
- package/tests/fixtures/README.md +2 -2
- package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
- package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
- package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
- package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
- package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
- package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
- package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
- package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
- package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
- package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
- package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
- package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
- package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
- package/tests/requirements-ci.txt +8 -0
- package/tests/test-marketplace-validators.py +7 -1
- package/tests/validate-agent-frontmatter-schema.py +7 -1
- package/tests/validate-aws-skill-quality.py +7 -0
- package/tests/validate-kiro-powers.py +8 -1
- package/tests/validate-nosql-audit.py +741 -0
- package/tests/validate-nosql-operations.py +136 -0
- package/tests/validate-nosql-pattern-evals.py +96 -0
- package/tests/validate-nosql-scenarios.py +94 -0
- package/tests/validate-skill-frontmatter-schema.py +7 -1
- package/tests/validate-skill-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
- package/tests/validate-skill-yaml-strict.py +84 -0
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Modeling — NoSQL API, not renamed DynamoDB
|
|
2
|
+
|
|
3
|
+
Cosmos stores JSON items in containers under a database/account. `id` is a string;
|
|
4
|
+
uniqueness is `(partition-key value, id)` within a container. Point reads require
|
|
5
|
+
both `id` and the exact partition-key value with the correct JSON type. A SQL query
|
|
6
|
+
with an id predicate isn't the same priced/routed operation as a point read.
|
|
7
|
+
|
|
8
|
+
| Pattern | Example route | Choice / tradeoff |
|
|
9
|
+
|---|---|---|
|
|
10
|
+
| Order by authenticated tenant/id | item(`order-42`, `tenant-a`) | `/tenantId` partition, point read |
|
|
11
|
+
| Tenant order history | partition key `tenant-a`, `WHERE c.tenantId=@tenant ORDER BY c.createdAt DESC,c.id ASC` | Composite createdAt DESC/id ASC; paginated |
|
|
12
|
+
| Global operational report | cross-partition bounded query/materialized projection | Fan-out/RUs explicit; not an implicit hot-path scan |
|
|
13
|
+
| Atomic order + outbox | same tenant logical partition | Transactional batch; bulk isn't atomic |
|
|
14
|
+
| Very large/hot tenant | hierarchical `/tenantId`,`/bucket` or explicit tenant-bucket routing | Query/transaction scope changes; evaluate prefixes and complete key tuples |
|
|
15
|
+
|
|
16
|
+
Start with cardinality, distribution and per-tenant peak RU/s/storage, not only
|
|
17
|
+
average traffic. A conventional logical partition is bounded by 20 GB and physical
|
|
18
|
+
partition maximum 10,000 RU/s; a hot logical key cannot use all account throughput.
|
|
19
|
+
Hierarchical partition keys can have up to three levels and a prefix can span
|
|
20
|
+
physical partitions, but complete tuples/transaction bounds still matter. Refresh
|
|
21
|
+
limits/account features before production sizing; a tenant key is not a security
|
|
22
|
+
boundary by itself. Dedicated containers/accounts improve isolation at cost.
|
|
23
|
+
|
|
24
|
+
Partition keys are immutable per item; changing them entails delete/create or a
|
|
25
|
+
reviewed migration, not an in-place patch. Changing the configured key requires a
|
|
26
|
+
new-container/copy strategy appropriate to current features. Keep source live and
|
|
27
|
+
rollbackable; never delete it to make a name reusable.
|
|
28
|
+
|
|
29
|
+
Embed bounded child data when read/updated together and size growth is controlled;
|
|
30
|
+
reference unbounded collections, binary/media in Blob Storage, and large source
|
|
31
|
+
documents. Avoid unbounded arrays and cross-partition pseudo-joins. Materialize
|
|
32
|
+
denormalized views with idempotent consumers and explicit staleness/reconciliation.
|
|
33
|
+
Document unique-key policies before container creation: scoped to logical
|
|
34
|
+
partition, case-sensitive, no sparse uniqueness; missing values behave as null.
|
|
35
|
+
|
|
36
|
+
For multi-tenancy, derive tenant from authenticated server context, enforce it in
|
|
37
|
+
partition routing AND predicates, validate returned rows, bind continuation tokens
|
|
38
|
+
to tenant/query and don't expose account credentials to tenants. Cosmetic SQL
|
|
39
|
+
filtering or a partition-key value alone doesn't restrict data-plane authorization.
|
|
40
|
+
|
|
41
|
+
Sources: [partitioning](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview),
|
|
42
|
+
[hierarchical keys](https://learn.microsoft.com/azure/cosmos-db/hierarchical-partition-keys),
|
|
43
|
+
[unique keys](https://learn.microsoft.com/azure/cosmos-db/unique-keys),
|
|
44
|
+
[limits](https://learn.microsoft.com/azure/cosmos-db/concepts-limits).
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Selected-feature observability
|
|
2
|
+
|
|
3
|
+
Use Azure Monitor namespace `Microsoft.DocumentDB/databaseAccounts` with exact
|
|
4
|
+
account resource ID, database/container/region dimensions. Verify current metric
|
|
5
|
+
definitions/available dimensions and aggregation before generating alarms. Do not
|
|
6
|
+
collect tenant/item content, raw vectors, session/continuation tokens or secrets.
|
|
7
|
+
|
|
8
|
+
| Selected domain | Evidence / signal |
|
|
9
|
+
|---|---|
|
|
10
|
+
| core/indexes/capacity | `TotalRequests` split StatusCode/OperationType/DatabaseName/CollectionName/Region; `TotalRequestUnits`; `NormalizedRUConsumption` Maximum by partition range/physical partition; diagnostic query/index utilization |
|
|
11
|
+
| latency | `ServerSideLatencyDirect` or `ServerSideLatencyGateway`, correct mode/operation/region; SDK end-to-end p95/p99/retries separately. Old `ServerSideLatency` is deprecated, not a recommended new alarm. |
|
|
12
|
+
| throttling/errors | 429 requests/retry-after/cumulative attempts; 403/404/409/412 classification, SDK substatus/activity ID; bounded retry budget |
|
|
13
|
+
| iam/encryption | Entra/data-role/config audit, key availability/expiry/rotation/default identity and denied-access tests; no broad key listing |
|
|
14
|
+
| backup/replication | Actual policy/window/latest restorable point, restore errors/index rebuild, region health/failover and measured RPO/RTO; backup policy alone isn't health |
|
|
15
|
+
| change-feed | Consumer lag, lease/checkpoint age/restart, poison/retry backlog, deletion reconciliation and duplicate-effect tests |
|
|
16
|
+
| vectors/embeddings | Embedding/model-version/dimension failures, vector index build/population, query charges/latency, labeled recall@k/nDCG, freshness and tenant-denial tests |
|
|
17
|
+
|
|
18
|
+
Alarm thresholds follow measured SLO/workload, not copied numbers. Define window,
|
|
19
|
+
statistic/dimensions, missing-data handling, routing/action group, owner, runbook
|
|
20
|
+
and notification test. Diagnostics/log analytics cost/retention and PII minimization
|
|
21
|
+
are separate choices. Missing metrics or untested notifications are UNVERIFIED.
|
|
22
|
+
|
|
23
|
+
Source: [current metrics reference](https://learn.microsoft.com/azure/cosmos-db/monitor-reference).
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Provisioning — illustrative alternatives, not deployment permission
|
|
2
|
+
|
|
3
|
+
Choose [ARM JSON](../assets/account.arm.json) OR [az CLI](../assets/provision.sh),
|
|
4
|
+
never run both sequentially against the same owner/resource. Template is complete
|
|
5
|
+
for a new NoSQL account/database/container, not a full application landing zone.
|
|
6
|
+
Use an existing resource group and separately approved new global account name.
|
|
7
|
+
ARM API version is pinned 2025-04-15; no Bicep compiler/download is necessary.
|
|
8
|
+
|
|
9
|
+
| Invariant | ARM and CLI |
|
|
10
|
+
|---|---|
|
|
11
|
+
| API/account | GlobalDocumentDB NoSQL, Standard offer, explicit account/location |
|
|
12
|
+
| Model | ordersdb/orders, `/tenantId` Hash v2, required string item id |
|
|
13
|
+
| Index | consistent automatic root, exclude `_etag` and payload, composite createdAt DESC/id ASC |
|
|
14
|
+
| Throughput | dedicated container manual 400 RU/s; DB has no shared offer, no serverless/autoscale |
|
|
15
|
+
| Consistency/regions | Session, one non-zone-redundant region, no multi-write/failover |
|
|
16
|
+
| Security | local/key auth disabled, public network Disabled, TLS1.2 minimum |
|
|
17
|
+
| Encryption | service-managed at rest; no keyVaultKeyUri/--key-uri; not plaintext |
|
|
18
|
+
| Backup/TTL | Continuous7Days, container -1 TTL (no default expiry; item opt-in possible) |
|
|
19
|
+
|
|
20
|
+
400 RU/s and one region are **example assumptions**, not production sizing/HA.
|
|
21
|
+
Public access is disabled; without separately approved private endpoint/DNS and
|
|
22
|
+
data RBAC, the example intentionally isn't application-accessible. Do not open
|
|
23
|
+
public network or enable keys to make a sample succeed. App data roles are not
|
|
24
|
+
control-plane Contributor, and no broad role is granted by these assets.
|
|
25
|
+
|
|
26
|
+
Before any execution confirm tenant/subscription/principal/group/location, new
|
|
27
|
+
resource absence and name availability, policy/quotas/cost/network ownership,
|
|
28
|
+
exact plan/what-if, preservation, approval and rollback. `create` can update an
|
|
29
|
+
existing resource; name-absence check is a prerequisite, not a hidden adoption
|
|
30
|
+
fallback. Only a classified NotFound is absence; auth/network/CLI errors stop.
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# Illustrative ARM preview; requires separately authorized Azure reads.
|
|
34
|
+
az deployment group what-if --subscription "$AZ_SUBSCRIPTION" \
|
|
35
|
+
--resource-group "$RESOURCE_GROUP" --template-file assets/account.arm.json \
|
|
36
|
+
--parameters accountName="$ACCOUNT_NAME" location="$LOCATION"
|
|
37
|
+
# Actual deployment is a separate reviewed operation, not implicit in preview.
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
After approved creation inspect provisioning state/error plus exact resource ID,
|
|
41
|
+
kind/API, region, consistency, backup/key/network/auth, container key/index/TTL
|
|
42
|
+
and throughput. Then separately validate real app access/tenant denials and
|
|
43
|
+
requested recovery/performance; successful provisioning isn't runtime proof.
|
|
44
|
+
|
|
45
|
+
Optional vector create (only selected when requested): preserve all base security/
|
|
46
|
+
backup/capacity assumptions, verify account capability `EnableNoSQLVectorSearch`
|
|
47
|
+
and current API/CLI, and create **distinct** `chunks` container using
|
|
48
|
+
`--vector-embeddings @assets/vector-policy.json` plus
|
|
49
|
+
`--idx @assets/vector-indexing-policy.json`, `/tenantId`, dedicated throughput.
|
|
50
|
+
These policies use float32/1536 diskANN; don't silently add a capability to existing
|
|
51
|
+
accounts or assume float16 works in this pinned schema. CMK variant is a reviewed
|
|
52
|
+
delta documented in [encryption](encryption.md), not hidden Key Vault setup.
|
|
53
|
+
|
|
54
|
+
Local JSON/resource/CLI equivalence tests don't validate Azure schema acceptance,
|
|
55
|
+
authorization, deployment, private connectivity or pricing. No az/Bicep was
|
|
56
|
+
installed or provider command executed during package authoring.
|
|
57
|
+
|
|
58
|
+
Sources: [account ARM schema](https://learn.microsoft.com/azure/templates/microsoft.documentdb/2025-04-15/databaseaccounts),
|
|
59
|
+
[container schema](https://learn.microsoft.com/azure/templates/microsoft.documentdb/2025-04-15/databaseaccounts/sqldatabases/containers),
|
|
60
|
+
[az create](https://learn.microsoft.com/cli/azure/cosmosdb#az-cosmosdb-create),
|
|
61
|
+
[container create](https://learn.microsoft.com/cli/azure/cosmosdb/sql/container#az-cosmosdb-sql-container-create).
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Recovery overview — choose one native method lazily
|
|
2
|
+
|
|
3
|
+
Platform-managed backups are distinct from replication, change feed and custom
|
|
4
|
+
exports. No named-backup object/create/download interface is exposed. Don't
|
|
5
|
+
invent AWS Backup/PITR APIs. Backup is present as periodic or continuous mode;
|
|
6
|
+
continuous can't be switched back to periodic. Current continuous documentation
|
|
7
|
+
lists **7, 30 and 35 days**; tool/API support for the newest tier varies.
|
|
8
|
+
|
|
9
|
+
| Need | Selected next path (load only that path) |
|
|
10
|
+
|---|---|
|
|
11
|
+
| Review continuous policy/window | commands/backup/continuous.md |
|
|
12
|
+
| Review scheduled snapshots | commands/backup/periodic.md |
|
|
13
|
+
| Recover corrupted items/account at time | commands/restore/continuous-new-account.md |
|
|
14
|
+
| Recover deleted DB/container into same account | commands/restore/continuous-deleted-resource.md |
|
|
15
|
+
| Recover periodic snapshot | commands/restore/periodic-support.md |
|
|
16
|
+
|
|
17
|
+
Select methods from observed policy and incident, not a renamed AWS command.
|
|
18
|
+
An existing continuous account can recover **deleted** resources in-account;
|
|
19
|
+
that doesn't authorize overwriting an existing container or reverting individual
|
|
20
|
+
items in place. Soft-delete preview is another lifecycle feature, not assumed
|
|
21
|
+
enabled or a replacement for backup; research separately if explicitly requested.
|
|
22
|
+
|
|
23
|
+
Define business RPO/RTO, observed backup readiness/timestamp, protected data/settings,
|
|
24
|
+
keys/identities/IAM, new target or deleted-resource boundary and actual drill
|
|
25
|
+
evidence. Continuous async capture in steady state is documented within about
|
|
26
|
+
100 seconds, not a universal zero-RPO guarantee. RTO depends on data/service/index/
|
|
27
|
+
network and application recovery; measure it, don't promise a fixed duration.
|
|
28
|
+
|
|
29
|
+
Sources: [backup modes](https://learn.microsoft.com/azure/cosmos-db/online-backup-and-restore),
|
|
30
|
+
[continuous](https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-introduction),
|
|
31
|
+
[periodic](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-restore-introduction).
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
# Regional resilience isn't logical recovery
|
|
2
|
+
|
|
3
|
+
Choose single-write/multi-read versus multi-write deliberately; configure region
|
|
4
|
+
priority, availability zones where supported, client preferred regions/discovery,
|
|
5
|
+
consistency, conflict resolution and failover testing through existing IaC owner.
|
|
6
|
+
Strong consistency and multi-region writes aren't interchangeable/simultaneously
|
|
7
|
+
supported choices. Measure client end-to-end latency and region failure behavior,
|
|
8
|
+
not only service-side metrics.
|
|
9
|
+
|
|
10
|
+
Replication propagates bad writes/deletes and isn't PITR. Continuous backups are
|
|
11
|
+
taken in account regions; recovery point requires the source resource/region to
|
|
12
|
+
have existed at that time. Restored new accounts don't automatically recreate
|
|
13
|
+
all original regions/network/roles. Multi-write hub conflict confirmation affects
|
|
14
|
+
restorable mutations/time; use actual region-specific latest restorable timestamp.
|
|
15
|
+
|
|
16
|
+
Define business RPO/RTO, planned/unplanned failover ownership, client/session-token
|
|
17
|
+
behavior, dependency/network/DNS resilience and rollback. No region addition,
|
|
18
|
+
failover, conflict-policy change or recovery drill runs from this guide.
|
|
19
|
+
|
|
20
|
+
Sources: [global distribution](https://learn.microsoft.com/azure/cosmos-db/distribute-data-globally),
|
|
21
|
+
[multi-region writes](https://learn.microsoft.com/azure/cosmos-db/multi-region-writes),
|
|
22
|
+
[continuous recovery](https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-introduction).
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Runtime correctness contract
|
|
2
|
+
|
|
3
|
+
| Concern | Required behavior |
|
|
4
|
+
|---|---|
|
|
5
|
+
| Identity/routing | String `id` and typed partition key; server-derived tenant, parameterized predicates, validate returned tenant |
|
|
6
|
+
| Consistency | Account Strong/BoundedStaleness/Session/ConsistentPrefix/Eventual differs from per-request override. Traditional ConsistencyLevel override can weaken, not strengthen. ReadConsistencyStrategy preview (Java >=4.69/.NET >=3.46; Microsoft pages disagree on whether it is direct mode only [CP-E124], so verify per pinned SDK and mode) can offer stronger Latest Committed/Global Strong reads under documented topology constraints; not universal SDK parity. Strong account consistency isn't multi-write-compatible. |
|
|
7
|
+
| Session | Reuse singleton SDK client/session cache; transfer explicit session token when causality crosses stateless clients. Tokens are partition-bound opaque state, not a global transaction or authorization token. |
|
|
8
|
+
| Optimistic writes | Read `_etag`; conditional replace/patch/delete using If-Match. 412 is stale-state conflict: refetch/reconcile, never retry blindly/convert to unconditional upsert. Create 409 isn't success unless idempotency verifies stored intent. |
|
|
9
|
+
| Transactions | Transactional batch: same full logical partition key AND container, <=100 operations, <=2 MB payload, <=5 seconds. Stored procedures also partition-scoped. Bulk operations/cross-partition queries aren't ACID transactions. |
|
|
10
|
+
| Pagination | SDK continuation token is opaque; keep same query/parameters/tenant/partition/API/SDK context. Empty page can have continuation; don't stop solely on zero rows. Don't truncate a service page and return its end token (skips items). |
|
|
11
|
+
| Query bounds | Positive page size, page/attempt/deadline/RU caps, cancellation. Keep resumption token; no unbounded fetchAll in hot paths. GROUP BY/some DISTINCT and aggregate cross-partition Python queries restrict continuation; newer Python streamable cross-partition queries support it. Verify exact SDK. |
|
|
12
|
+
| Retry | SDK already retries 429; honor `x-ms-retry-after-ms` and cumulative deadline/attempt caps. Never stack unbounded app retries. Distinguish 403/auth, 404 routing/missing, 409 conflict, 412 precondition and 429 throttling. |
|
|
13
|
+
| Ambiguous writes | Timeout/connection loss can follow commit. Idempotency key and read/conditional reconciliation before retry; retrying arbitrary increment/create may duplicate effects. Don't retry unknown outcome as a read. |
|
|
14
|
+
| Diagnostics | Record charge, activity ID, retry/substatus and elapsed time without items/tokens/secrets. Missing charges aren't free requests. |
|
|
15
|
+
|
|
16
|
+
The injected [runtime example](../assets/runtime.mjs) uses actual JavaScript
|
|
17
|
+
`Container.items.query(...).fetchNext()` and `.item(id, pk).replace(...)` signatures,
|
|
18
|
+
but creates no client, installs no package and runs nothing on import. Tests use
|
|
19
|
+
fakes: behavior-contract evidence, not SDK compilation or Cosmos acceptance.
|
|
20
|
+
|
|
21
|
+
## TTL / migration
|
|
22
|
+
|
|
23
|
+
Container TTL absent/null means off; `-1` enables item-level overrides without
|
|
24
|
+
default expiry; positive seconds set default. Item `ttl: -1` opts out; positive
|
|
25
|
+
override controls expiry relative to server `_ts` (last modification). TTL applies
|
|
26
|
+
only when enabled at container. Expired data stops appearing in queries; physical
|
|
27
|
+
deletion is asynchronous and consumes available resources, not a deadline SLA.
|
|
28
|
+
TTL isn't a legal-hold/backup-retention mechanism. Do not claim changing TTL
|
|
29
|
+
recovers deleted items. Restores can replay TTL and immediately delete old data;
|
|
30
|
+
review disable-TTL restore option before recovery.
|
|
31
|
+
|
|
32
|
+
Schema/model changes need versioned readers, backfill checkpoints/idempotency,
|
|
33
|
+
deletion/tombstone reconciliation, bounded RU/cost, dual-write divergence tests,
|
|
34
|
+
domain invariant comparison, approved cutover and preserved rollback source.
|
|
35
|
+
Latest-version change feed alone doesn't capture delete/TTL events; don't claim
|
|
36
|
+
it reproduces an exact snapshot without another mechanism.
|
|
37
|
+
|
|
38
|
+
Sources: [consistency](https://learn.microsoft.com/azure/cosmos-db/consistency-levels),
|
|
39
|
+
[session tokens](https://learn.microsoft.com/azure/cosmos-db/how-to-manage-consistency),
|
|
40
|
+
[transactions/ETag](https://learn.microsoft.com/azure/cosmos-db/database-transactions-optimistic-concurrency),
|
|
41
|
+
[batch limits](https://learn.microsoft.com/azure/cosmos-db/transactional-batch),
|
|
42
|
+
[pagination](https://learn.microsoft.com/cosmos-db/query/pagination),
|
|
43
|
+
[TTL](https://learn.microsoft.com/azure/cosmos-db/time-to-live).
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Primary-source ledger
|
|
2
|
+
|
|
3
|
+
Retrieved **2026-11-08**; scope NoSQL API. Source retrieval is documentation
|
|
4
|
+
evidence, not Azure account/SDK/deployment evidence. See machine-readable
|
|
5
|
+
[tool evidence](../evals/source-evidence.json). No customer/account data was sent.
|
|
6
|
+
|
|
7
|
+
Actual tools used: `mcp__context7__resolve_library_id` then `query_docs` against
|
|
8
|
+
`/websites/learn_microsoft_en-us_azure_cosmos-db`; MicrosoftDocs
|
|
9
|
+
`microsoft_docs_search`/`microsoft_docs_fetch`; Azure `documentation` router
|
|
10
|
+
`learn=true` and `microsoft_code_sample_search`. No Cosmos resource-discovery tool
|
|
11
|
+
was invoked. Azure extension/codegen-bestpractice helpers mentioned by its shared
|
|
12
|
+
description weren't exposed in this tool catalog; no installation/fake tool
|
|
13
|
+
fallback. Official docs retrieval plus offline checks were the available path.
|
|
14
|
+
|
|
15
|
+
| Subject | Primary reference | Applied observation |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| API/SDK scope | [NoSQL overview](https://learn.microsoft.com/azure/cosmos-db/overview), [Rust quickstart](https://learn.microsoft.com/azure/cosmos-db/quickstart-rust) | JSON/NoSQL scope; Rust SDK is first-party public preview, not GA |
|
|
18
|
+
| Routing | [Partitioning](https://learn.microsoft.com/azure/cosmos-db/partitioning-overview) | Logical/physical distribution and hot-key limits |
|
|
19
|
+
| Transactions | [Transactional batch](https://learn.microsoft.com/azure/cosmos-db/transactional-batch) | Same logical partition/container; 100 ops/2 MB/5 seconds |
|
|
20
|
+
| Consistency | [Levels](https://learn.microsoft.com/azure/cosmos-db/consistency-levels), [management/strategy](https://learn.microsoft.com/azure/cosmos-db/how-to-manage-consistency) | Classic override vs newer preview stronger strategies; session tokens |
|
|
21
|
+
| Pagination | [Query pagination](https://learn.microsoft.com/cosmos-db/query/pagination) | Empty pages/opaque tokens and updated Python streamable support |
|
|
22
|
+
| TTL | [TTL](https://learn.microsoft.com/azure/cosmos-db/time-to-live) | Container/item overrides and modification-based expiry |
|
|
23
|
+
| Native vectors | [Vector search](https://learn.microsoft.com/azure/cosmos-db/vector-search), [index policy](https://learn.microsoft.com/azure/cosmos-db/index-policy) | float16 now documented; flat505 vs quantized/diskANN4096; population/lifecycle limits |
|
|
24
|
+
| Embeddings | [Azure OpenAI](https://learn.microsoft.com/azure/ai-foundry/openai/how-to/embeddings) | Generation is separate from storing numeric vectors/source refs |
|
|
25
|
+
| Data/control RBAC | [Entra/RBAC](https://learn.microsoft.com/azure/cosmos-db/how-to-setup-rbac) | Separate Azure management and native Cosmos data roles |
|
|
26
|
+
| Key lifecycle | [CMK](https://learn.microsoft.com/azure/cosmos-db/how-to-setup-cmk) | Identity/Key Vault and periodic/continuous recovery dependencies |
|
|
27
|
+
| Feed | [Change-feed modes](https://learn.microsoft.com/azure/cosmos-db/change-feed-modes) | Latest version misses deletes; all versions/deletes requires continuous backup |
|
|
28
|
+
| Metrics | [Monitor reference](https://learn.microsoft.com/azure/cosmos-db/monitor-reference) | Deprecated generic server latency vs Direct/Gateway current metrics |
|
|
29
|
+
| Backup | [Modes](https://learn.microsoft.com/azure/cosmos-db/online-backup-and-restore), [continuous](https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-introduction), [periodic](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-restore-introduction) | Service now documents 7/30/35-day continuous tiers; periodic is support-assisted |
|
|
30
|
+
| Snapshot policy | [Periodic settings](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-modify-interval-retention) | Bounds/defaults/redundancy change recovery risks |
|
|
31
|
+
| Recovery | [New-account](https://learn.microsoft.com/azure/cosmos-db/restore-account-continuous-backup), [deleted-resource](https://learn.microsoft.com/azure/cosmos-db/how-to-restore-in-account-continuous-backup), [latest timestamp](https://learn.microsoft.com/azure/cosmos-db/get-latest-restore-timestamp), [Support](https://learn.microsoft.com/azure/cosmos-db/periodic-backup-request-data-restore) | Distinct destinations, UTC/window/async/settings/TTL checks |
|
|
32
|
+
| Provisioning | [Account ARM 2025-04-15](https://learn.microsoft.com/azure/templates/microsoft.documentdb/2025-04-15/databaseaccounts), [container ARM](https://learn.microsoft.com/azure/templates/microsoft.documentdb/2025-04-15/databaseaccounts/sqldatabases/containers), [CLI](https://learn.microsoft.com/cli/azure/cosmosdb), [container CLI](https://learn.microsoft.com/cli/azure/cosmosdb/sql/container) | Complete pinned core example; current schema/version subset |
|
|
33
|
+
| JS SDK | [Query examples](https://learn.microsoft.com/javascript/api/overview/azure/cosmos-readme), [RequestOptions](https://learn.microsoft.com/javascript/api/@azure/cosmos/requestoptions) | fetchNext/partition/session/IfMatch signatures; no compilation claim |
|
|
34
|
+
| REST/Java | [REST query](https://learn.microsoft.com/rest/api/cosmos-db/query-documents), [REST auth](https://learn.microsoft.com/rest/api/cosmos-db/access-control-on-cosmosdb-resources), [Java container](https://learn.microsoft.com/java/api/com.azure.cosmos.cosmosasynccontainer) | Portable request/SDK contracts, not invented PHP/Kotlin-native SDKs |
|
|
35
|
+
|
|
36
|
+
## Observed source conflicts / limits
|
|
37
|
+
|
|
38
|
+
- [Same-account restore introduction](https://learn.microsoft.com/azure/cosmos-db/restore-in-account-continuous-backup-introduction)
|
|
39
|
+
explicitly invalidates old tokens/consumer checkpoints and doesn't restore
|
|
40
|
+
pre-deletion feed history. This is an exception to normal deployment checkpoint
|
|
41
|
+
preservation, not a replay promise. Retrieved through MicrosoftDocs full fetch.
|
|
42
|
+
|
|
43
|
+
- New service backup docs include 35 days; core CLI and pinned ARM 2025-04-15
|
|
44
|
+
enumerate 7/30, while newer/extension docs can expose 35. Supplied assets use
|
|
45
|
+
supported seven-day subset; don't force a newer enum into older tools.
|
|
46
|
+
- Vector page includes float16; pinned older ARM enum lacks it. Supplied optional
|
|
47
|
+
vector policy stays float32. No float16 SDK/service test was performed.
|
|
48
|
+
- NoSQL vector/index pages and unified Azure/Fabric index guidance disagree on
|
|
49
|
+
policy mutability/drop/re-add. Conservative guidance uses new generation/container
|
|
50
|
+
and requires exact version confirmation, not “can never change” as universal law.
|
|
51
|
+
- Current Python continuation docs permit streamable cross-partition queries,
|
|
52
|
+
unlike older single-partition-only advice. Aggregates still have restrictions.
|
|
53
|
+
- New ReadConsistencyStrategy is preview (Java >=4.69/.NET >=3.46, direct mode);
|
|
54
|
+
stronger per-read options don't mean every SDK/topology supports them.
|
|
55
|
+
- Some old `/azure/cosmos-db/query/...`, how-to-Java and data-RBAC URLs returned
|
|
56
|
+
unavailable pages. They were replaced with current unified query/Java API/RBAC
|
|
57
|
+
references; no claim that an unavailable retrieval proves feature absence.
|
|
58
|
+
|
|
59
|
+
Refresh mutable claims at use. No runtime SDK/CLI installation/version/service
|
|
60
|
+
acceptance, effective RBAC/key/network posture, performance/recall or actual restore
|
|
61
|
+
was verified. Offline package tests don't close those evidence gaps.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Narrow implementation workflow
|
|
2
|
+
|
|
3
|
+
1. Declare API, workload/tenant trust, existing owner/language/SDK and evidence
|
|
4
|
+
boundaries. Run explicit-date review reminder; don't inspect live state by default.
|
|
5
|
+
2. Select only requested features. Build access patterns before choosing partition
|
|
6
|
+
key, embedding/reference strategy, indexes and capacity; explain alternatives.
|
|
7
|
+
3. Define deterministic negative tests: tenant mismatch, missing/wrong partition,
|
|
8
|
+
ETag conflict, continuation/session behavior, empty page, 429/deadline, unknown
|
|
9
|
+
write result, TTL expiry and incompatible model/vector policy.
|
|
10
|
+
4. Produce minimal existing-stack code and requested IaC/CLI; no auto-provisioning,
|
|
11
|
+
ORM adoption, credentials generation or install. Preserve current source of truth.
|
|
12
|
+
5. Run offline syntax/contracts/fakes, inspect actual diffs and report source gaps.
|
|
13
|
+
Only separately authorized live metadata checks and workload/drill validation
|
|
14
|
+
can prove deployed behavior. Keep deployment/readback/runtime evidence distinct.
|
|
15
|
+
|
|
16
|
+
Deliver selected scope, assumptions, access matrix, small change/example,
|
|
17
|
+
compatibility/migration and validation plan, evidence, remaining risks and
|
|
18
|
+
PASS/MISS/UNVERIFIED. Don't claim that instructions register or enforce host routing.
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Validate supplied sanitized recovery evidence and print a plan. No Azure calls."""
|
|
3
|
+
import argparse
|
|
4
|
+
from datetime import datetime, timezone
|
|
5
|
+
import json
|
|
6
|
+
import re
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def instant(value):
|
|
10
|
+
parsed = datetime.fromisoformat(value.replace("Z", "+00:00"))
|
|
11
|
+
if parsed.tzinfo is None or parsed.utcoffset().total_seconds() != 0:
|
|
12
|
+
raise ValueError("explicit UTC timestamp required")
|
|
13
|
+
return parsed.astimezone(timezone.utc)
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
def plan(e):
|
|
17
|
+
method = e["method"]
|
|
18
|
+
if method not in {"continuous-new-account", "continuous-deleted-resource", "periodic-support"}:
|
|
19
|
+
raise ValueError("unsupported recovery method")
|
|
20
|
+
s, t = e["source"], e["target"]
|
|
21
|
+
for obj, names in [(s, ("subscription", "resource_id", "instance_id", "account", "region", "api")),
|
|
22
|
+
(t, ("subscription", "resource_group", "account", "lookup"))]:
|
|
23
|
+
for name in names:
|
|
24
|
+
if not isinstance(obj.get(name), str) or not obj[name].strip():
|
|
25
|
+
raise ValueError("explicit source/target identity required")
|
|
26
|
+
if s["api"] != "NoSQL" or s["subscription"] != t["subscription"]:
|
|
27
|
+
raise ValueError("NoSQL and same-subscription recovery only")
|
|
28
|
+
expected = rf"/subscriptions/{re.escape(s['subscription'])}/resourceGroups/[^/]+/providers/Microsoft\.DocumentDB/databaseAccounts/{re.escape(s['account'])}"
|
|
29
|
+
if not re.fullmatch(expected, s["resource_id"], re.IGNORECASE) or any(
|
|
30
|
+
not re.fullmatch(r"[a-z0-9][a-z0-9-]{1,42}[a-z0-9]", account)
|
|
31
|
+
for account in (s["account"], t["account"])):
|
|
32
|
+
raise ValueError("source ID/target mismatch")
|
|
33
|
+
if e.get("observed_source_instance_id") != s["instance_id"] or e.get("source_name_unambiguous") is not True:
|
|
34
|
+
raise ValueError("source instance/name ambiguous or drifted")
|
|
35
|
+
point = instant(e["restore_timestamp"])
|
|
36
|
+
if not instant(s["earliest_restorable"]) <= point <= instant(s["latest_restorable"]):
|
|
37
|
+
raise ValueError("point outside observed recovery window")
|
|
38
|
+
if point > instant(e["evidence_as_of"]):
|
|
39
|
+
raise ValueError("future restore point")
|
|
40
|
+
if e.get("disable_ttl") is not True or e.get("key_dependencies_verified") is not True:
|
|
41
|
+
raise ValueError("review TTL preservation/key dependencies first")
|
|
42
|
+
if t["lookup"] != "ResourceNotFound":
|
|
43
|
+
raise ValueError("target exists or absence unproven; errors aren't NotFound")
|
|
44
|
+
argv = None
|
|
45
|
+
if method == "continuous-deleted-resource":
|
|
46
|
+
if s.get("backup_mode") != "Continuous" or t["account"] != s["account"]:
|
|
47
|
+
raise ValueError("in-account restore requires same continuous source account")
|
|
48
|
+
source_group = re.search(r"/resourceGroups/([^/]+)/", s["resource_id"], re.IGNORECASE).group(1)
|
|
49
|
+
if t["resource_group"].lower() != source_group.lower():
|
|
50
|
+
raise ValueError("in-account restore must target the source account's resource group")
|
|
51
|
+
if e.get("deletion_event") != "Delete" or not point < instant(e["deleted_at"]):
|
|
52
|
+
raise ValueError("actual deletion event and pre-deletion point required")
|
|
53
|
+
kind = e.get("resource_kind")
|
|
54
|
+
if kind not in {"database", "container"}:
|
|
55
|
+
raise ValueError("only deleted database/container supported")
|
|
56
|
+
if not isinstance(e.get("database"), str) or not e["database"]:
|
|
57
|
+
raise ValueError("database required")
|
|
58
|
+
if kind == "container" and (not isinstance(e.get("container"), str) or not e["container"]):
|
|
59
|
+
raise ValueError("container required")
|
|
60
|
+
argv = ["az", "cosmosdb", "sql", kind, "restore", "--subscription", t["subscription"],
|
|
61
|
+
"--resource-group", t["resource_group"], "--account-name", s["account"],
|
|
62
|
+
"--name", e["database"] if kind == "database" else e["container"]]
|
|
63
|
+
if kind == "container":
|
|
64
|
+
argv += ["--database-name", e["database"]]
|
|
65
|
+
else:
|
|
66
|
+
if t["account"] == s["account"]:
|
|
67
|
+
raise ValueError("distinct NEW destination required; no source overwrite")
|
|
68
|
+
expected_mode = "Periodic" if method == "periodic-support" else "Continuous"
|
|
69
|
+
if s.get("backup_mode") != expected_mode:
|
|
70
|
+
raise ValueError("observed policy doesn't support selected recovery method")
|
|
71
|
+
if method == "continuous-new-account":
|
|
72
|
+
if e.get("restore_scope") != "full-account" or e.get("approved_restore_scope") != "full-account":
|
|
73
|
+
raise ValueError("helper requires explicit approved full-account restore scope")
|
|
74
|
+
if any(key in e for key in ("database", "container", "databases", "containers", "collections", "databases_to_restore")):
|
|
75
|
+
raise ValueError("helper doesn't implement subset restore; use reviewed manual scope, never broaden")
|
|
76
|
+
argv = ["az", "cosmosdb", "restore", "--subscription", t["subscription"],
|
|
77
|
+
"--resource-group", t["resource_group"], "--account-name", s["account"],
|
|
78
|
+
"--target-database-account-name", t["account"], "--location", s["region"],
|
|
79
|
+
"--disable-local-auth", "true", "--public-network-access", "DISABLED"]
|
|
80
|
+
if argv is not None:
|
|
81
|
+
argv += ["--restore-timestamp", e["restore_timestamp"], "--disable-ttl", "true"]
|
|
82
|
+
return {"execution": "none", "method": method, "change_approval_required": True,
|
|
83
|
+
"source_instance": s["instance_id"], "argv_example": argv,
|
|
84
|
+
"periodic_support_required": method == "periodic-support",
|
|
85
|
+
"acceptance": "settings and application/security/RPO/RTO checks required; waiter insufficient"}
|
|
86
|
+
|
|
87
|
+
|
|
88
|
+
if __name__ == "__main__":
|
|
89
|
+
p = argparse.ArgumentParser(description=__doc__)
|
|
90
|
+
p.add_argument("evidence", help="explicit local sanitized JSON evidence file")
|
|
91
|
+
args = p.parse_args()
|
|
92
|
+
try:
|
|
93
|
+
with open(args.evidence, encoding="utf-8") as handle:
|
|
94
|
+
print(json.dumps(plan(json.load(handle)), indent=2))
|
|
95
|
+
except (ValueError, KeyError, TypeError) as error:
|
|
96
|
+
p.error(str(error))
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Read-only content reminder. Explicit client-local date; never rewrites ledger."""
|
|
3
|
+
import argparse
|
|
4
|
+
from datetime import date
|
|
5
|
+
import json
|
|
6
|
+
from pathlib import Path
|
|
7
|
+
|
|
8
|
+
|
|
9
|
+
def due_status(ledger, as_of):
|
|
10
|
+
due = date.fromisoformat(ledger["next_full_review_due"])
|
|
11
|
+
return {"as_of": as_of.isoformat(), "due": due.isoformat(),
|
|
12
|
+
"status": "overdue" if as_of > due else "due" if as_of == due else "not-due",
|
|
13
|
+
"cadence": "June/December", "next_due_advances_automatically": False,
|
|
14
|
+
"notification": "in-session-only", "last_full_review": ledger["last_full_review"]}
|
|
15
|
+
|
|
16
|
+
|
|
17
|
+
def main():
|
|
18
|
+
p = argparse.ArgumentParser(description=__doc__)
|
|
19
|
+
p.add_argument("--as-of", required=True, type=date.fromisoformat)
|
|
20
|
+
args = p.parse_args()
|
|
21
|
+
ledger = json.loads((Path(__file__).resolve().parents[1] / "assets/content-review.json").read_text())
|
|
22
|
+
print(json.dumps(due_status(ledger, args.as_of), indent=2))
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
if __name__ == "__main__":
|
|
26
|
+
main()
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Local path selector only: no reference reads, network, subprocess or writes."""
|
|
3
|
+
import argparse
|
|
4
|
+
import json
|
|
5
|
+
import sys
|
|
6
|
+
|
|
7
|
+
FEATURES = {
|
|
8
|
+
"core": ["references/modeling.md", "references/runtime-contract.md"],
|
|
9
|
+
"indexes": ["references/indexing-and-capacity.md"],
|
|
10
|
+
"capacity": ["references/indexing-and-capacity.md"],
|
|
11
|
+
"iam": ["references/access-control.md"],
|
|
12
|
+
"encryption": ["references/encryption.md"],
|
|
13
|
+
"ttl": ["references/runtime-contract.md"],
|
|
14
|
+
"backup": ["references/recovery.md"],
|
|
15
|
+
"replication": ["references/replication.md"],
|
|
16
|
+
"change-feed": ["references/change-feed-and-integrations.md"],
|
|
17
|
+
"vectors": ["references/data-types-and-vectors.md"],
|
|
18
|
+
"embeddings": ["references/embedding-integrations.md"],
|
|
19
|
+
"monitoring": ["references/monitoring.md"],
|
|
20
|
+
"provisioning": ["references/provisioning.md"],
|
|
21
|
+
}
|
|
22
|
+
COMMANDS = ("help", "select", "design", "refactor", "audit", "performance-test",
|
|
23
|
+
"feature-plan", "backup", "restore")
|
|
24
|
+
ACTIONS = {
|
|
25
|
+
"ttl": {"enable", "disable", "configure"},
|
|
26
|
+
"indexes": {"configure"}, "capacity": {"configure"},
|
|
27
|
+
"iam": {"configure"}, "encryption": {"configure"},
|
|
28
|
+
"backup": {"configure"}, "replication": {"configure"},
|
|
29
|
+
"change-feed": {"configure"}, "vectors": {"enable", "configure"},
|
|
30
|
+
"embeddings": {"configure"}, "monitoring": {"configure"},
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
def positive(value):
|
|
35
|
+
try:
|
|
36
|
+
number = int(value)
|
|
37
|
+
except ValueError as error:
|
|
38
|
+
raise argparse.ArgumentTypeError("positive integer required") from error
|
|
39
|
+
if number <= 0:
|
|
40
|
+
raise argparse.ArgumentTypeError("positive finite cap required")
|
|
41
|
+
return number
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def build_plan(argv=None):
|
|
45
|
+
argv = list(sys.argv[1:] if argv is None else argv)
|
|
46
|
+
if argv[:1] == ["/azure-cosmosdb-pattern"]:
|
|
47
|
+
argv = argv[1:]
|
|
48
|
+
parser = argparse.ArgumentParser(description=__doc__, allow_abbrev=False)
|
|
49
|
+
sub = parser.add_subparsers(dest="command", required=True)
|
|
50
|
+
for name in COMMANDS:
|
|
51
|
+
p = sub.add_parser(name, allow_abbrev=False)
|
|
52
|
+
if name == "help":
|
|
53
|
+
continue
|
|
54
|
+
p.add_argument("--features", default="backup" if name in {"backup", "restore"} else "core",
|
|
55
|
+
required=name == "feature-plan")
|
|
56
|
+
if name == "audit":
|
|
57
|
+
p.add_argument("--mode", choices=["offline", "live"], default="offline")
|
|
58
|
+
elif name == "backup":
|
|
59
|
+
p.add_argument("--method", choices=["continuous", "periodic"], default="continuous")
|
|
60
|
+
elif name == "restore":
|
|
61
|
+
p.add_argument("--method", choices=["continuous-new-account", "continuous-deleted-resource",
|
|
62
|
+
"periodic-support"], default="continuous-new-account")
|
|
63
|
+
elif name == "performance-test":
|
|
64
|
+
p.add_argument("--environment", choices=["local", "nonproduction"], default="local")
|
|
65
|
+
for option, default in [("duration-seconds", 30), ("max-requests", 500),
|
|
66
|
+
("max-concurrency", 2), ("max-ru", 1000)]:
|
|
67
|
+
p.add_argument("--" + option, type=positive, default=default)
|
|
68
|
+
elif name == "feature-plan":
|
|
69
|
+
p.add_argument("--action", choices=["enable", "disable", "configure"], required=True)
|
|
70
|
+
args = parser.parse_args(argv or ["help"])
|
|
71
|
+
if args.command == "help":
|
|
72
|
+
return {"schema_version": 1, "commands": list(COMMANDS), "features": list(FEATURES),
|
|
73
|
+
"read": ["references/commands/help.md"], "execution": "none"}
|
|
74
|
+
features = list(dict.fromkeys(x.strip() for x in args.features.split(",")))
|
|
75
|
+
if any(f not in FEATURES for f in features):
|
|
76
|
+
parser.error("unknown/empty feature; use help; other Cosmos APIs and AWS features aren't supported")
|
|
77
|
+
if args.command in {"backup", "restore"} and "backup" not in features:
|
|
78
|
+
parser.error("recovery commands require backup in selected features")
|
|
79
|
+
if args.command == "feature-plan":
|
|
80
|
+
for f in features:
|
|
81
|
+
if args.action not in ACTIONS.get(f, set()):
|
|
82
|
+
parser.error(f"{f}: generic {args.action} unsupported; review native lifecycle")
|
|
83
|
+
paths = [f"references/commands/{args.command}.md"]
|
|
84
|
+
out = {"schema_version": 1, "mode": args.command, "selected_features": features,
|
|
85
|
+
"execution": "none", "api": "NoSQL"}
|
|
86
|
+
if args.command == "audit":
|
|
87
|
+
paths.append(f"references/commands/audit/{args.mode}.md")
|
|
88
|
+
out.update(audit_mode=args.mode, live_read_approval_required=args.mode == "live")
|
|
89
|
+
elif args.command in {"backup", "restore"}:
|
|
90
|
+
paths.extend(["references/commands/recovery-target.md",
|
|
91
|
+
f"references/commands/{args.command}/{args.method}.md"])
|
|
92
|
+
out.update(method=args.method, change_approval_required=True)
|
|
93
|
+
if args.command == "restore":
|
|
94
|
+
out["target_policy"] = ("deleted-resource-only-no-overwrite"
|
|
95
|
+
if args.method == "continuous-deleted-resource" else "new-account-only")
|
|
96
|
+
elif args.command == "performance-test":
|
|
97
|
+
out.update(environment=args.environment, run_approval_required=True,
|
|
98
|
+
limits={k: getattr(args, k) for k in ("duration_seconds", "max_requests", "max_concurrency", "max_ru")})
|
|
99
|
+
elif args.command == "feature-plan":
|
|
100
|
+
out.update(action=args.action, change_approval_required=True)
|
|
101
|
+
for feature in features:
|
|
102
|
+
paths.extend(FEATURES[feature])
|
|
103
|
+
out["read"] = list(dict.fromkeys(paths))
|
|
104
|
+
return out
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
if __name__ == "__main__":
|
|
108
|
+
print(json.dumps(build_plan(), indent=2))
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Offline illustrative-model invariants, NOT an Azure ARM schema validator."""
|
|
3
|
+
import json
|
|
4
|
+
from pathlib import Path
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
def validate(template, indexing):
|
|
8
|
+
resources = template["resources"]
|
|
9
|
+
if len(resources) != 3:
|
|
10
|
+
raise ValueError("expected account/database/container only")
|
|
11
|
+
account, db, container = resources
|
|
12
|
+
if [r["type"] for r in resources] != [
|
|
13
|
+
"Microsoft.DocumentDB/databaseAccounts", "Microsoft.DocumentDB/databaseAccounts/sqlDatabases",
|
|
14
|
+
"Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers"]:
|
|
15
|
+
raise ValueError("native resource types changed")
|
|
16
|
+
if any(r["apiVersion"] != "2025-04-15" for r in resources):
|
|
17
|
+
raise ValueError("review pinned API version change")
|
|
18
|
+
if account["kind"] != "GlobalDocumentDB" or account["name"] != "[parameters('accountName')]":
|
|
19
|
+
raise ValueError("NoSQL account/name mismatch")
|
|
20
|
+
p = account["properties"]
|
|
21
|
+
expected = {"databaseAccountOfferType": "Standard", "disableLocalAuth": True,
|
|
22
|
+
"minimalTlsVersion": "Tls12", "publicNetworkAccess": "Disabled",
|
|
23
|
+
"enableAutomaticFailover": False, "enableMultipleWriteLocations": False,
|
|
24
|
+
"consistencyPolicy": {"defaultConsistencyLevel": "Session"},
|
|
25
|
+
"backupPolicy": {"type": "Continuous", "continuousModeProperties": {"tier": "Continuous7Days"}}}
|
|
26
|
+
if any(p.get(key) != value for key, value in expected.items()):
|
|
27
|
+
raise ValueError("account security/capacity/backup invariants changed")
|
|
28
|
+
if "keyVaultKeyUri" in p or "identity" in account or p.get("capabilities"):
|
|
29
|
+
raise ValueError("base model isn't an implicit CMK/serverless/vector configuration")
|
|
30
|
+
if p["locations"] != [{"locationName": "[parameters('location')]", "failoverPriority": 0, "isZoneRedundant": False}]:
|
|
31
|
+
raise ValueError("base region assumptions changed")
|
|
32
|
+
if db["properties"] != {"resource": {"id": "ordersdb"}, "options": {}}:
|
|
33
|
+
raise ValueError("DB shared throughput or ID drift")
|
|
34
|
+
c = container["properties"]
|
|
35
|
+
if c["options"] != {"throughput": 400}:
|
|
36
|
+
raise ValueError("dedicated manual capacity required; no mixed autoscale/serverless")
|
|
37
|
+
if c["resource"]["id"] != "orders" or c["resource"]["partitionKey"] != {"paths": ["/tenantId"], "kind": "Hash", "version": 2}:
|
|
38
|
+
raise ValueError("partition/ID mismatch")
|
|
39
|
+
if c["resource"].get("defaultTtl") != -1 or c["resource"]["indexingPolicy"] != indexing:
|
|
40
|
+
raise ValueError("TTL/indexing CLI-vs-ARM drift")
|
|
41
|
+
expected_index = {"indexingMode": "consistent", "automatic": True,
|
|
42
|
+
"includedPaths": [{"path": "/*"}],
|
|
43
|
+
"excludedPaths": [{"path": "/_etag/?"}, {"path": "/payload/*"}],
|
|
44
|
+
"compositeIndexes": [[{"path": "/createdAt", "order": "descending"}, {"path": "/id", "order": "ascending"}]]}
|
|
45
|
+
if indexing != expected_index:
|
|
46
|
+
raise ValueError("example index doesn't match access pattern")
|
|
47
|
+
return {"status": "PASS", "scope": "local example invariants only", "azure_acceptance": "UNVERIFIED"}
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
if __name__ == "__main__":
|
|
51
|
+
root = Path(__file__).resolve().parents[1] / "assets"
|
|
52
|
+
print(json.dumps(validate(json.loads((root / "account.arm.json").read_text()),
|
|
53
|
+
json.loads((root / "indexing-policy.json").read_text())), indent=2))
|
|
@@ -3,7 +3,7 @@ name: azure-cosmosdb-performance-investigator
|
|
|
3
3
|
description: Use this skill for Azure Cosmos DB performance investigation, especially RU spikes, query latency, throttling, hot partitions, indexing inefficiency, partition-skew analysis, request-charge profiling, diagnostic-log review, and evidence-driven remediation planning.
|
|
4
4
|
allowed-tools: Read Grep Glob WebFetch
|
|
5
5
|
metadata:
|
|
6
|
-
author: github: VincentChuWaiChow
|
|
6
|
+
author: "github: VincentChuWaiChow"
|
|
7
7
|
version: 0.1.3
|
|
8
8
|
updated: "2026-06-05"
|
|
9
9
|
category: data
|