@raishin/vanguard-frontier-agentic 3.19.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +8 -1
- package/.cursor-plugin/plugin.json +8 -1
- package/.github/plugin/marketplace.json +1 -1
- package/README.md +21 -21
- package/agents/AGENTS.md +4 -4
- package/agents/README.md +7 -7
- package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
- package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
- package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
- package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
- package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
- package/catalog/agents.json +204 -1
- package/catalog/asset-integrity.json +601 -61
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +1603 -56
- package/catalog/skills.json +314 -14
- package/package.json +7 -2
- package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
- package/powers/vanguard-alibaba/POWER.md +1 -1
- package/powers/vanguard-aws/POWER.md +1 -1
- package/powers/vanguard-azure/POWER.md +1 -1
- package/powers/vanguard-gcp/POWER.md +1 -1
- package/powers/vanguard-huawei/POWER.md +1 -1
- package/powers/vanguard-oci/POWER.md +1 -1
- package/skills/alibaba/README.md +2 -1
- package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
- package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
- package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
- package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
- package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
- package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
- package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
- package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
- package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
- package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
- package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
- package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
- package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
- package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
- package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
- package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
- package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
- package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
- package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
- package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
- package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
- package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
- package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
- package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
- package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
- package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
- package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
- package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
- package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
- package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
- package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
- package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
- package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
- package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
- package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
- package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
- package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
- package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
- package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
- package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
- package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
- package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
- package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-maestro/SKILL.md +1 -1
- package/skills/aws/aws-maestro/metadata.json +1 -1
- package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
- package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +4 -2
- package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
- package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
- package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
- package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
- package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
- package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
- package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
- package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
- package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
- package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
- package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
- package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
- package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
- package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
- package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
- package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
- package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
- package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +6 -2
- package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
- package/skills/azure/azure-maestro/SKILL.md +1 -0
- package/skills/gcp/README.md +2 -1
- package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
- package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
- package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
- package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
- package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
- package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
- package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
- package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
- package/skills/gcp/gcp-maestro/SKILL.md +2 -1
- package/skills/huawei/README.md +2 -1
- package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
- package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
- package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
- package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
- package/skills/huawei/huawei-maestro/SKILL.md +2 -1
- package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
- package/skills/oci/README.md +6 -1
- package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
- package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
- package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
- package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
- package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
- package/skills/oci/oci-nosql-pattern/README.md +81 -0
- package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
- package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
- package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
- package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
- package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
- package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
- package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
- package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
- package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
- package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
- package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
- package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
- package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
- package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
- package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
- package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
- package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
- package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
- package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
- package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
- package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
- package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
- package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
- package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
- package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
- package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
- package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
- package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
- package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
- package/templates/nosql-audit-template.md +127 -0
- package/templates/nosql-operations-template.md +60 -0
- package/tests/_generate_maestro_routing_fixtures.py +11 -0
- package/tests/fixtures/README.md +2 -2
- package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
- package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
- package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
- package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
- package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
- package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
- package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
- package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
- package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
- package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
- package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
- package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
- package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
- package/tests/requirements-ci.txt +8 -0
- package/tests/validate-aws-skill-quality.py +7 -0
- package/tests/validate-nosql-audit.py +741 -0
- package/tests/validate-nosql-operations.py +136 -0
- package/tests/validate-nosql-pattern-evals.py +96 -0
- package/tests/validate-nosql-scenarios.py +94 -0
- package/tests/validate-skill-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
import test from "node:test";
|
|
2
|
+
import assert from "node:assert/strict";
|
|
3
|
+
import {readTenantPage, replaceOrder, retryRead429, vector, buildChunk} from "../assets/runtime.mjs";
|
|
4
|
+
|
|
5
|
+
// Mock SDK values: opaque placeholders, never credentials. Named constants keep
|
|
6
|
+
// them out of `name: "literal"` form so the repository secret scanner stays on
|
|
7
|
+
// for this file with no suppression.
|
|
8
|
+
const MOCK_CONTINUATION = "opaque-token";
|
|
9
|
+
const MOCK_PRIOR_SESSION = "previous-session";
|
|
10
|
+
|
|
11
|
+
function queryContainer(response) {
|
|
12
|
+
const calls = [];
|
|
13
|
+
return {calls, items: {
|
|
14
|
+
query(spec, options) {
|
|
15
|
+
calls.push({spec, options});
|
|
16
|
+
return {async fetchNext() {return response;}};
|
|
17
|
+
}
|
|
18
|
+
}};
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
test("parameterized tenant + partition + opaque/session tokens and complete page", async () => {
|
|
22
|
+
const c = queryContainer({resources: [{id:"1", tenantId:"tenant-a"}], requestCharge:4,
|
|
23
|
+
continuationToken:MOCK_CONTINUATION, headers:{"x-ms-session-token":"session-v"}, activityId:"activity"});
|
|
24
|
+
const page = await readTenantPage(c, {tenant:"tenant-a", sessionToken:MOCK_PRIOR_SESSION});
|
|
25
|
+
assert.equal(c.calls[0].options.partitionKey,"tenant-a");
|
|
26
|
+
assert.deepEqual(c.calls[0].spec.parameters,[{name:"@tenant",value:"tenant-a"}]);
|
|
27
|
+
assert.equal(c.calls[0].options.sessionToken,MOCK_PRIOR_SESSION);
|
|
28
|
+
assert.equal(page.cursor.token,MOCK_CONTINUATION);
|
|
29
|
+
assert.equal(page.sessionToken,"session-v");
|
|
30
|
+
assert.equal(page.charge,4); assert.equal(page.overBudget,false);
|
|
31
|
+
});
|
|
32
|
+
|
|
33
|
+
test("empty page preserves continuation and resumes exactly that query scope", async () => {
|
|
34
|
+
const c = queryContainer({resources:[],requestCharge:2,continuationToken:"next"});
|
|
35
|
+
const page = await readTenantPage(c,{tenant:"a"});
|
|
36
|
+
assert.deepEqual(page.items,[]); assert.ok(page.cursor);
|
|
37
|
+
await readTenantPage(c,{tenant:"a",cursor:page.cursor});
|
|
38
|
+
assert.equal(c.calls[1].options.continuationToken,"next");
|
|
39
|
+
await assert.rejects(readTenantPage(c,{tenant:"b",cursor:page.cursor}),/scope mismatch/);
|
|
40
|
+
assert.equal(c.calls.length,2);
|
|
41
|
+
});
|
|
42
|
+
|
|
43
|
+
test("tenant leak, malformed page, unknown RU and partial-page skipping fail", async () => {
|
|
44
|
+
for(const response of [
|
|
45
|
+
{resources:[{tenantId:"wrong"}],requestCharge:1},
|
|
46
|
+
{resources:[{tenantId:"a"},{tenantId:"a"}],requestCharge:1},
|
|
47
|
+
{resources:[],requestCharge:undefined}, {resources:[],requestCharge:NaN},
|
|
48
|
+
{resources:null,requestCharge:1}, {resources:[],requestCharge:1,continuationToken:42}
|
|
49
|
+
]) await assert.rejects(readTenantPage(queryContainer(response),{tenant:"a",pageSize:1}));
|
|
50
|
+
});
|
|
51
|
+
|
|
52
|
+
test("positive page/RU caps reject invalid values before a client call", async () => {
|
|
53
|
+
const c = queryContainer({resources:[],requestCharge:1});
|
|
54
|
+
for(const args of [{tenant:""},{tenant:"a",pageSize:0},{tenant:"a",pageSize:101},
|
|
55
|
+
{tenant:"a",maxRU:0},{tenant:"a",pageSize:1.5}])
|
|
56
|
+
await assert.rejects(readTenantPage(c,args));
|
|
57
|
+
assert.equal(c.calls.length,0);
|
|
58
|
+
const page = await readTenantPage(queryContainer({resources:[],requestCharge:12}),{tenant:"a",maxRU:10});
|
|
59
|
+
assert.equal(page.overBudget,true); // caller stops; one-page cost known after response.
|
|
60
|
+
});
|
|
61
|
+
|
|
62
|
+
test("ETag replace pins id and tenant and doesn't retry 412", async () => {
|
|
63
|
+
const calls=[];
|
|
64
|
+
const c = {
|
|
65
|
+
item(id, pk) {
|
|
66
|
+
calls.push({id, pk});
|
|
67
|
+
return {
|
|
68
|
+
replace(body, options) {
|
|
69
|
+
calls.push({body, options});
|
|
70
|
+
return Promise.reject(Object.assign(new Error("stale"), {code:412}));
|
|
71
|
+
}
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
};
|
|
75
|
+
await assert.rejects(replaceOrder(c,{tenant:"a",id:"1",body:{tenantId:"a",id:"1"},etag:'"v1"'}),{code:412});
|
|
76
|
+
assert.equal(calls.length,2);
|
|
77
|
+
assert.deepEqual(calls[1].options,{accessCondition:{type:"IfMatch",condition:'"v1"'}});
|
|
78
|
+
for(const args of [{tenant:"a",id:"1",body:{tenantId:"b",id:"1"},etag:"v1"},
|
|
79
|
+
{tenant:"a",id:"1",body:{tenantId:"a",id:"1"},etag:""}])
|
|
80
|
+
await assert.rejects(replaceOrder(c,args));
|
|
81
|
+
assert.equal(calls.length,2);
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
test("429 honors server delay and cumulative attempt/deadline bounds", async () => {
|
|
85
|
+
let now=0, attempts=0; const waits=[];
|
|
86
|
+
const result=await retryRead429(async()=>{
|
|
87
|
+
attempts++; if(attempts<3) throw {code:429,headers:{"x-ms-retry-after-ms":"10"}};
|
|
88
|
+
return "ok";
|
|
89
|
+
},{maxAttempts:3,deadlineMs:100,now:()=>now,sleep:async ms=>{waits.push(ms);now+=ms;}});
|
|
90
|
+
assert.equal(result,"ok"); assert.equal(attempts,3); assert.deepEqual(waits,[10,10]);
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
test("read retry never retries auth/conflict/unknown writes and rejects missing delay", async () => {
|
|
94
|
+
for(const error of [{code:403},{code:412},{code:500},{code:429,headers:{}},
|
|
95
|
+
{code:429,headers:{"x-ms-retry-after-ms":"100"}}]) {
|
|
96
|
+
let attempts=0;
|
|
97
|
+
await assert.rejects(retryRead429(async()=>{attempts++;throw error;},
|
|
98
|
+
{maxAttempts:3,deadlineMs:50,now:()=>0,sleep:async()=>{throw new Error("must not sleep");}}));
|
|
99
|
+
assert.equal(attempts,1);
|
|
100
|
+
}
|
|
101
|
+
let attempts=0;
|
|
102
|
+
await assert.rejects(retryRead429(async()=>{attempts++;throw {code:429,headers:{"x-ms-retry-after-ms":"0"}};},
|
|
103
|
+
{maxAttempts:2,deadlineMs:50,now:()=>0,sleep:async()=>{}}));
|
|
104
|
+
assert.equal(attempts,2);
|
|
105
|
+
});
|
|
106
|
+
|
|
107
|
+
test("vector validates dimensions/type/finite/range and preserves float32 conversion", () => {
|
|
108
|
+
assert.deepEqual(vector([1,2,3],{dimensions:3}),[1,2,3]);
|
|
109
|
+
assert.equal(vector([0.1],{dimensions:1})[0],Math.fround(0.1));
|
|
110
|
+
for(const values of [[1,NaN],[1,Infinity],[1,true],[1,"2"],[1,null],[0,0],[1,1e50],[1,1e-50],"source-url"])
|
|
111
|
+
assert.throws(()=>vector(values,{dimensions:2}));
|
|
112
|
+
for(const dimensions of [0,-1,1.5,4097]) assert.throws(()=>vector([1],{dimensions}));
|
|
113
|
+
assert.throws(()=>vector(Array(506).fill(1),{dimensions:506,indexType:"flat"}));
|
|
114
|
+
assert.throws(()=>vector([1],{dimensions:1,indexType:"fictional"}));
|
|
115
|
+
assert.throws(()=>vector([1],{dimensions:1,dataType:"float16"}),/verify native float16/);
|
|
116
|
+
assert.deepEqual(vector([-128,127],{dimensions:2,dataType:"int8"}),[-128,127]);
|
|
117
|
+
assert.deepEqual(vector([0,255],{dimensions:2,dataType:"uint8"}),[0,255]);
|
|
118
|
+
for(const [values,dataType] of [[[128],"int8"],[[-129],"int8"],[[-1],"uint8"],[[256],"uint8"],[[1.5],"int8"]])
|
|
119
|
+
assert.throws(()=>vector(values,{dimensions:1,dataType}));
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
test("sparse vectors are rejected, never serialized into null coordinates", () => {
|
|
123
|
+
assert.throws(()=>vector([1,,2],{dimensions:3}),/finite numeric/);
|
|
124
|
+
assert.throws(()=>vector(new Array(3),{dimensions:3}),/finite numeric/);
|
|
125
|
+
const trailing=[1]; trailing.length=2;
|
|
126
|
+
assert.throws(()=>vector(trailing,{dimensions:2}),/finite numeric/);
|
|
127
|
+
});
|
|
128
|
+
|
|
129
|
+
const source={account:"syntheticblob",container:"docs",blob:"manual.pdf",versionId:"immutable-v1"};
|
|
130
|
+
test("embedding port is called only explicitly and result pins source/model/tenant", async () => {
|
|
131
|
+
const calls=[]; const embed=async(text,options)=>{calls.push({text,options});return Array(1536).fill(0.1);};
|
|
132
|
+
const result=await buildChunk(embed,{tenant:"a",id:"chunk1",text:"synthetic text",source,model:"model-generation-v1"});
|
|
133
|
+
assert.equal(calls.length,1); assert.equal(calls[0].options.dimensions,1536);
|
|
134
|
+
assert.equal(result.tenantId,"a"); assert.equal(result.source.versionId,"immutable-v1");
|
|
135
|
+
assert.equal(result.embedding.length,1536); assert.equal(result.dataType,"float32");
|
|
136
|
+
});
|
|
137
|
+
|
|
138
|
+
test("bad source or empty context fails before embedding; dimensions/model output verified", async () => {
|
|
139
|
+
let calls=0; const embed=async()=>{calls++;return [1,2];};
|
|
140
|
+
for(const change of [{source:{...source,versionId:"null"}}, {source:{...source,blob:"x?sig=secret"}},
|
|
141
|
+
{source:{account:"x",container:"x",blob:"x"}}, {tenant:""}, {model:""}])
|
|
142
|
+
await assert.rejects(buildChunk(embed,{tenant:"a",id:"1",text:"text",source,model:"v1",...change}));
|
|
143
|
+
assert.equal(calls,0);
|
|
144
|
+
await assert.rejects(buildChunk(embed,{tenant:"a",id:"1",text:"text",source,model:"v1"}),/dimension/);
|
|
145
|
+
assert.equal(calls,1);
|
|
146
|
+
});
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
{
|
|
2
|
+
"checked_on": "2026-11-08",
|
|
3
|
+
"scope": "Public first-party documentation only; no Azure account access",
|
|
4
|
+
"context7": {
|
|
5
|
+
"resolve_tool": "mcp__context7__resolve_library_id",
|
|
6
|
+
"query_tool": "mcp__context7__query_docs",
|
|
7
|
+
"library": "/websites/learn_microsoft_en-us_azure_cosmos-db",
|
|
8
|
+
"resolve_query": "Azure Cosmos DB for NoSQL JavaScript SDK partition key transactional batch ETag continuation tokens session token",
|
|
9
|
+
"queries": [
|
|
10
|
+
"Azure Cosmos DB for NoSQL JavaScript items.query fetchNext continuationToken maxItemCount partitionKey sessionToken accessCondition IfMatch transactional batch API",
|
|
11
|
+
"Azure Cosmos DB Node.js SDK item replace accessCondition type IfMatch condition etag sessionToken RequestOptions"
|
|
12
|
+
],
|
|
13
|
+
"returned_primary_urls": [
|
|
14
|
+
"https://learn.microsoft.com/en-us/azure/cosmos-db/performance-tips-query-sdk",
|
|
15
|
+
"https://learn.microsoft.com/en-us/azure/cosmos-db/how-to-javascript-query-items",
|
|
16
|
+
"https://learn.microsoft.com/en-us/azure/cosmos-db/transactional-batch"
|
|
17
|
+
]
|
|
18
|
+
},
|
|
19
|
+
"provider_tools": [
|
|
20
|
+
{"tool": "mcp__microsoftdocs_mcp__microsoft_docs_search", "topics": ["native vector types/dimensions/indexing", "backup retention and recovery modes", "SDK language support", "CMK identity and restore", "ARM account/container schemas", "pagination", "Java query"]},
|
|
21
|
+
{"tool": "mcp__microsoftdocs_mcp__microsoft_docs_fetch", "topics": ["full vector, continuous, periodic, restore, Entra RBAC, CMK, SDK, ARM and CLI pages listed in references/sources.md"]},
|
|
22
|
+
{"tool": "mcp__azure__documentation", "command": "learn=true", "result": "Discovered documentation search/fetch/code-sample schemas only"},
|
|
23
|
+
{"tool": "mcp__azure__documentation", "command": "microsoft_code_sample_search", "query": "Azure Cosmos DB for NoSQL JavaScript query items partitionKey fetchNext continuationToken", "returned_primary_url": "https://learn.microsoft.com/javascript/api/overview/azure/cosmos-readme?view=azure-node-latest#examples"}
|
|
24
|
+
],
|
|
25
|
+
"observed_drift": ["Continuous35Days newer than pinned CLI/ARM subset", "float16 newer than pinned ARM vector enum", "NoSQL vs unified vector policy mutability guidance differs", "Python streamable cross-partition continuation now supported", "ReadConsistencyStrategy preview can strengthen reads in supported Java/.NET direct mode", "ServerSideLatency deprecated; Direct/Gateway replacements"],
|
|
26
|
+
"tool_gaps": ["Azure extension and generic codegen-bestpractice helpers weren't exposed in active tools", "az not installed; no install attempted"],
|
|
27
|
+
"execution_evidence": "Documentation calls and offline tests only. No Azure resource discovery, deployment, data request, load or restore."
|
|
28
|
+
}
|
|
@@ -0,0 +1,355 @@
|
|
|
1
|
+
"""Offline contract/fake-command tests. Never invokes real Azure CLI or SDK."""
|
|
2
|
+
import ast
|
|
3
|
+
import copy
|
|
4
|
+
from datetime import date
|
|
5
|
+
import importlib.util
|
|
6
|
+
import json
|
|
7
|
+
import os
|
|
8
|
+
from pathlib import Path
|
|
9
|
+
import re
|
|
10
|
+
import subprocess
|
|
11
|
+
import sys
|
|
12
|
+
import tempfile
|
|
13
|
+
import unittest
|
|
14
|
+
from unittest.mock import patch
|
|
15
|
+
|
|
16
|
+
ROOT = Path(__file__).resolve().parents[1]
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
def load(name):
|
|
20
|
+
spec = importlib.util.spec_from_file_location(name, ROOT / "scripts" / (name + ".py"))
|
|
21
|
+
module = importlib.util.module_from_spec(spec)
|
|
22
|
+
spec.loader.exec_module(module)
|
|
23
|
+
return module
|
|
24
|
+
|
|
25
|
+
|
|
26
|
+
SELECT = load("select_mode")
|
|
27
|
+
DUE = load("review_due")
|
|
28
|
+
GUARD = load("recovery_guard")
|
|
29
|
+
ASSETS = load("validate_assets")
|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
def selector(*args):
|
|
33
|
+
return subprocess.run([sys.executable, "-B", str(ROOT / "scripts/select_mode.py"), *args],
|
|
34
|
+
capture_output=True, text=True, timeout=5)
|
|
35
|
+
|
|
36
|
+
|
|
37
|
+
class Package(unittest.TestCase):
|
|
38
|
+
def test_metadata_size_and_exact_name(self):
|
|
39
|
+
skill = (ROOT / "SKILL.md").read_text()
|
|
40
|
+
self.assertIn("name: azure-cosmosdb-pattern\n", skill)
|
|
41
|
+
self.assertIn('version: "1.0.0"', skill)
|
|
42
|
+
self.assertLessEqual(len(skill.splitlines()), 90)
|
|
43
|
+
self.assertLessEqual(len(skill.split()), 900)
|
|
44
|
+
self.assertGreater(skill.count("|---"), 2)
|
|
45
|
+
|
|
46
|
+
def test_all_local_markdown_links_exist(self):
|
|
47
|
+
for file in ROOT.rglob("*.md"):
|
|
48
|
+
for link in re.findall(r"\[[^\]]*\]\(([^)]+)\)", file.read_text()):
|
|
49
|
+
if re.match(r"https?://|#", link):
|
|
50
|
+
continue
|
|
51
|
+
with self.subTest(file=file.name, link=link):
|
|
52
|
+
self.assertTrue((file.parent / link.split("#")[0]).is_file())
|
|
53
|
+
|
|
54
|
+
def test_json_and_all_source_routes(self):
|
|
55
|
+
for path in ROOT.rglob("*.json"):
|
|
56
|
+
json.loads(path.read_text())
|
|
57
|
+
evidence = json.loads((ROOT / "evals/source-evidence.json").read_text())
|
|
58
|
+
self.assertEqual(evidence["checked_on"], "2026-11-08")
|
|
59
|
+
self.assertIn("mcp__context7__query_docs", evidence["context7"]["query_tool"])
|
|
60
|
+
self.assertTrue(any(x.get("command") == "microsoft_code_sample_search" for x in evidence["provider_tools"]))
|
|
61
|
+
|
|
62
|
+
def test_selector_no_reference_read_write_or_cloud_capability(self):
|
|
63
|
+
tree = ast.parse((ROOT / "scripts/select_mode.py").read_text())
|
|
64
|
+
imports = {node.names[0].name for node in ast.walk(tree) if isinstance(node, ast.Import)}
|
|
65
|
+
self.assertEqual(imports, {"argparse", "json", "sys"})
|
|
66
|
+
with patch("builtins.open", side_effect=AssertionError("selector read file")):
|
|
67
|
+
self.assertEqual(SELECT.build_plan(["design"])["execution"], "none")
|
|
68
|
+
|
|
69
|
+
def test_provisioning_asset_invariants(self):
|
|
70
|
+
t = json.loads((ROOT / "assets/account.arm.json").read_text())
|
|
71
|
+
idx = json.loads((ROOT / "assets/indexing-policy.json").read_text())
|
|
72
|
+
self.assertEqual(ASSETS.validate(t, idx)["status"], "PASS")
|
|
73
|
+
self.assertTrue(all(r.get("dependsOn") for r in t["resources"][1:]))
|
|
74
|
+
|
|
75
|
+
def test_negative_provisioning_fixtures(self):
|
|
76
|
+
base = json.loads((ROOT / "assets/account.arm.json").read_text())
|
|
77
|
+
idx = json.loads((ROOT / "assets/indexing-policy.json").read_text())
|
|
78
|
+
changes = [
|
|
79
|
+
lambda t: t["resources"][0].update(kind="MongoDB"),
|
|
80
|
+
lambda t: t["resources"][0]["properties"].update(disableLocalAuth=False),
|
|
81
|
+
lambda t: t["resources"][0]["properties"].update(publicNetworkAccess="Enabled"),
|
|
82
|
+
lambda t: t["resources"][0]["properties"].update(keyVaultKeyUri="https://unreviewed"),
|
|
83
|
+
lambda t: t["resources"][0]["properties"]["backupPolicy"].update(type="Periodic"),
|
|
84
|
+
lambda t: t["resources"][1]["properties"].update(options={"throughput": 400}),
|
|
85
|
+
lambda t: t["resources"][2]["properties"]["options"].update(autoscaleSettings={"maxThroughput": 1000}),
|
|
86
|
+
lambda t: t["resources"][2]["properties"]["resource"]["partitionKey"].update(paths=["/wrong"]),
|
|
87
|
+
lambda t: t["resources"][2]["properties"]["resource"].update(defaultTtl=3600),
|
|
88
|
+
]
|
|
89
|
+
for change in changes:
|
|
90
|
+
t = copy.deepcopy(base); change(t)
|
|
91
|
+
with self.subTest(change=changes.index(change)), self.assertRaises(ValueError):
|
|
92
|
+
ASSETS.validate(t, idx)
|
|
93
|
+
|
|
94
|
+
def test_vector_policy_matches_index(self):
|
|
95
|
+
policy = json.loads((ROOT / "assets/vector-policy.json").read_text())["vectorEmbeddings"][0]
|
|
96
|
+
idx = json.loads((ROOT / "assets/vector-indexing-policy.json").read_text())
|
|
97
|
+
self.assertEqual(policy, {"path": "/embedding", "dataType": "float32", "dimensions": 1536, "distanceFunction": "cosine"})
|
|
98
|
+
self.assertEqual(idx["vectorIndexes"], [{"path": policy["path"], "type": "diskANN"}])
|
|
99
|
+
self.assertIn({"path": "/embedding/*"}, idx["excludedPaths"])
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
class Selector(unittest.TestCase):
|
|
103
|
+
def test_every_command_and_slash_namespace(self):
|
|
104
|
+
for cmd in SELECT.COMMANDS:
|
|
105
|
+
argv = [cmd] + (["--features", "iam", "--action", "configure"] if cmd == "feature-plan" else [])
|
|
106
|
+
with self.subTest(command=cmd):
|
|
107
|
+
normal, prefixed = selector(*argv), selector("/azure-cosmosdb-pattern", *argv)
|
|
108
|
+
self.assertEqual(normal.returncode, 0, normal.stderr)
|
|
109
|
+
self.assertEqual(json.loads(normal.stdout), json.loads(prefixed.stdout))
|
|
110
|
+
for path in json.loads(normal.stdout)["read"]:
|
|
111
|
+
self.assertTrue((ROOT / path).is_file(), path)
|
|
112
|
+
|
|
113
|
+
def test_help_stops_and_audit_defaults_offline(self):
|
|
114
|
+
self.assertEqual(SELECT.build_plan([])["read"], ["references/commands/help.md"])
|
|
115
|
+
offline = SELECT.build_plan(["audit"])
|
|
116
|
+
self.assertEqual(offline["audit_mode"], "offline")
|
|
117
|
+
self.assertFalse(offline["live_read_approval_required"])
|
|
118
|
+
live = SELECT.build_plan(["audit", "--mode", "live", "--features", "monitoring"])
|
|
119
|
+
self.assertTrue(live["live_read_approval_required"])
|
|
120
|
+
self.assertFalse(any("offline.md" in p for p in live["read"]))
|
|
121
|
+
|
|
122
|
+
def test_lazy_features_no_indirect_recovery_sibling_load(self):
|
|
123
|
+
for feature in SELECT.FEATURES:
|
|
124
|
+
paths = SELECT.build_plan(["select", "--features", feature])["read"]
|
|
125
|
+
self.assertEqual(paths, ["references/commands/select.md"] + SELECT.FEATURES[feature])
|
|
126
|
+
self.assertFalse(any("commands/restore/" in path or "commands/backup/" in path for path in paths))
|
|
127
|
+
self.assertNotIn("references/encryption.md", SELECT.build_plan(["design"])["read"])
|
|
128
|
+
|
|
129
|
+
def test_recovery_methods_are_isolated_and_native(self):
|
|
130
|
+
for cmd, methods in [("backup", ["continuous", "periodic"]),
|
|
131
|
+
("restore", ["continuous-new-account", "continuous-deleted-resource", "periodic-support"])]:
|
|
132
|
+
for method in methods:
|
|
133
|
+
plan = SELECT.build_plan([cmd, "--method", method])
|
|
134
|
+
selected = [p for p in plan["read"] if f"commands/{cmd}/" in p]
|
|
135
|
+
self.assertEqual(selected, [f"references/commands/{cmd}/{method}.md"])
|
|
136
|
+
self.assertEqual(plan["execution"], "none")
|
|
137
|
+
|
|
138
|
+
def test_safe_positive_performance_defaults_and_caps(self):
|
|
139
|
+
p = SELECT.build_plan(["performance-test"])
|
|
140
|
+
self.assertEqual(p["environment"], "local")
|
|
141
|
+
self.assertTrue(all(v > 0 for v in p["limits"].values()))
|
|
142
|
+
self.assertTrue(p["run_approval_required"])
|
|
143
|
+
|
|
144
|
+
def test_unsupported_inputs_fail_closed(self):
|
|
145
|
+
bad = [["combo"], ["select", "--features", ""], ["select", "--features", "core,unknown"],
|
|
146
|
+
["select", "--features", "core,"], ["select", "--features", "dax"],
|
|
147
|
+
["backup", "--method", "on-demand"], ["restore", "--method", "pitr"],
|
|
148
|
+
["backup", "--features", "core"], ["audit", "--mode", "execute"],
|
|
149
|
+
["design", "--mode", "live"], ["performance-test", "--environment", "production"],
|
|
150
|
+
["feature-plan", "--features", "encryption", "--action", "disable"],
|
|
151
|
+
["feature-plan", "--features", "backup", "--action", "disable"],
|
|
152
|
+
["feature-plan", "--features", "vectors", "--action", "disable"],
|
|
153
|
+
["select", "--feat", "iam"], ["/azure-cosmosdb-patterns", "help"]]
|
|
154
|
+
for flag in ["--duration-seconds", "--max-requests", "--max-concurrency", "--max-ru"]:
|
|
155
|
+
for value in ["0", "-1", "infinity", "1.5"]:
|
|
156
|
+
bad.append(["performance-test", flag, value])
|
|
157
|
+
for argv in bad:
|
|
158
|
+
with self.subTest(argv=argv):
|
|
159
|
+
result = selector(*argv)
|
|
160
|
+
self.assertNotEqual(result.returncode, 0)
|
|
161
|
+
self.assertFalse(result.stdout.strip())
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
class Reminder(unittest.TestCase):
|
|
165
|
+
def test_dates_never_advance_or_clear_on_partial_update(self):
|
|
166
|
+
path = ROOT / "assets/content-review.json"
|
|
167
|
+
before = path.read_bytes()
|
|
168
|
+
ledger = json.loads(before)
|
|
169
|
+
for day, status in [("2026-11-08", "not-due"), ("2026-12-01", "due"),
|
|
170
|
+
("2026-12-02", "overdue"), ("2027-07-02", "overdue")]:
|
|
171
|
+
with self.subTest(day=day):
|
|
172
|
+
actual = DUE.due_status(ledger, date.fromisoformat(day))
|
|
173
|
+
self.assertEqual(actual["status"], status)
|
|
174
|
+
self.assertEqual(actual["due"], "2026-12-01")
|
|
175
|
+
self.assertIsNone(actual["last_full_review"])
|
|
176
|
+
self.assertEqual(before, path.read_bytes())
|
|
177
|
+
|
|
178
|
+
def test_cli_requires_valid_explicit_date(self):
|
|
179
|
+
for args in [[], ["--as-of", "2026-99-01"]]:
|
|
180
|
+
p = subprocess.run([sys.executable, "-B", str(ROOT / "scripts/review_due.py"), *args],
|
|
181
|
+
capture_output=True, text=True, timeout=5)
|
|
182
|
+
self.assertNotEqual(p.returncode, 0)
|
|
183
|
+
|
|
184
|
+
|
|
185
|
+
class Recovery(unittest.TestCase):
|
|
186
|
+
def evidence(self):
|
|
187
|
+
return json.loads((ROOT / "evals/fixtures/recovery-continuous.json").read_text())
|
|
188
|
+
|
|
189
|
+
def test_new_account_plan_and_no_execution(self):
|
|
190
|
+
plan = GUARD.plan(self.evidence())
|
|
191
|
+
self.assertEqual(plan["argv_example"][:3], ["az", "cosmosdb", "restore"])
|
|
192
|
+
self.assertEqual(plan["execution"], "none")
|
|
193
|
+
self.assertIn("--disable-ttl", plan["argv_example"])
|
|
194
|
+
self.assertIn("--subscription", plan["argv_example"])
|
|
195
|
+
self.assertIn("--resource-group", plan["argv_example"])
|
|
196
|
+
|
|
197
|
+
def test_recovery_negative_evidence(self):
|
|
198
|
+
base = self.evidence()
|
|
199
|
+
mutations = [
|
|
200
|
+
lambda e: e["target"].update(lookup="Forbidden"),
|
|
201
|
+
lambda e: e["target"].update(lookup="timeout"),
|
|
202
|
+
lambda e: e["target"].update(lookup="exists"),
|
|
203
|
+
lambda e: e["target"].update(account=e["source"]["account"]),
|
|
204
|
+
lambda e: e["target"].update(subscription="wrong"),
|
|
205
|
+
lambda e: e["source"].update(api="MongoDB"),
|
|
206
|
+
lambda e: e["source"].update(backup_mode="Periodic"),
|
|
207
|
+
lambda e: e["source"].update(resource_id="/subscriptions/wrong/accounts/other"),
|
|
208
|
+
lambda e: e.update(observed_source_instance_id="different"),
|
|
209
|
+
lambda e: e.update(source_name_unambiguous=False),
|
|
210
|
+
lambda e: e.update(restore_timestamp="2026-10-01T00:00:00Z"),
|
|
211
|
+
lambda e: e.update(restore_timestamp="2026-11-09T00:00:00Z"),
|
|
212
|
+
lambda e: e.update(restore_timestamp="2026-11-08T08:30:00"),
|
|
213
|
+
lambda e: e.update(disable_ttl=False),
|
|
214
|
+
lambda e: e.update(key_dependencies_verified=False),
|
|
215
|
+
lambda e: e.update(method="on-demand"),
|
|
216
|
+
lambda e: e.update(restore_scope="container"),
|
|
217
|
+
lambda e: e.update(approved_restore_scope="unknown"),
|
|
218
|
+
lambda e: e.update(database="ordersdb", container="orders"),
|
|
219
|
+
lambda e: e.update(databases_to_restore=["ordersdb"]),
|
|
220
|
+
]
|
|
221
|
+
for i, mutate in enumerate(mutations):
|
|
222
|
+
e = copy.deepcopy(base); mutate(e)
|
|
223
|
+
with self.subTest(case=i), self.assertRaises(ValueError):
|
|
224
|
+
GUARD.plan(e)
|
|
225
|
+
|
|
226
|
+
def test_deleted_resource_requires_delete_and_absent_scope(self):
|
|
227
|
+
e = self.evidence(); e["method"] = "continuous-deleted-resource"
|
|
228
|
+
e["target"]["account"] = e["source"]["account"]
|
|
229
|
+
e["target"]["resource_group"] = "source-rg"
|
|
230
|
+
e.update(deletion_event="Delete", deleted_at="2026-11-08T08:40:00Z",
|
|
231
|
+
resource_kind="container", database="ordersdb", container="orders")
|
|
232
|
+
p = GUARD.plan(e)
|
|
233
|
+
self.assertEqual(p["argv_example"][:5], ["az", "cosmosdb", "sql", "container", "restore"])
|
|
234
|
+
argv = p["argv_example"]
|
|
235
|
+
self.assertEqual(argv[argv.index("--resource-group") + 1], "source-rg")
|
|
236
|
+
for change in [{"deletion_event": "Update"}, {"deleted_at": "2026-11-08T08:20:00Z"}, {"resource_kind": "item"}]:
|
|
237
|
+
bad = copy.deepcopy(e); bad.update(change)
|
|
238
|
+
with self.assertRaises(ValueError): GUARD.plan(bad)
|
|
239
|
+
# Same account name in a different resource group is not the source account.
|
|
240
|
+
bad = copy.deepcopy(e); bad["target"]["resource_group"] = "recovery-rg"
|
|
241
|
+
with self.assertRaises(ValueError): GUARD.plan(bad)
|
|
242
|
+
|
|
243
|
+
def test_periodic_is_support_only_no_fictional_cli(self):
|
|
244
|
+
e = self.evidence(); e["method"] = "periodic-support"; e["source"]["backup_mode"] = "Periodic"
|
|
245
|
+
p = GUARD.plan(e)
|
|
246
|
+
self.assertIsNone(p["argv_example"])
|
|
247
|
+
self.assertTrue(p["periodic_support_required"])
|
|
248
|
+
|
|
249
|
+
def test_same_account_new_lifetime_recovery_contract(self):
|
|
250
|
+
restore = (ROOT / "references/commands/restore/continuous-deleted-resource.md").read_text()
|
|
251
|
+
feed = (ROOT / "references/change-feed-and-integrations.md").read_text()
|
|
252
|
+
for text in (restore, feed):
|
|
253
|
+
self.assertIn("pre-deletion", text)
|
|
254
|
+
self.assertIn("continuation tokens", text)
|
|
255
|
+
self.assertIn("lifetime", text)
|
|
256
|
+
self.assertIn("restore-in-account-continuous-backup-introduction", text)
|
|
257
|
+
|
|
258
|
+
|
|
259
|
+
FAKE_AZ = '''#!/usr/bin/env python3
|
|
260
|
+
import json, os, sys
|
|
261
|
+
a = sys.argv[1:]
|
|
262
|
+
with open(os.environ["FAKE_LOG"], "a") as f: f.write(json.dumps(a) + "\\n")
|
|
263
|
+
if not a or a[0] != "cosmosdb":
|
|
264
|
+
print("command group must precede --subscription", file=sys.stderr); sys.exit(11)
|
|
265
|
+
for flag in ("--subscription", "--resource-group"):
|
|
266
|
+
if flag not in a: sys.exit(12)
|
|
267
|
+
if any(word in a for word in ("delete", "list-keys", "update", "account")): sys.exit(13)
|
|
268
|
+
verbs = a[:next((i for i, x in enumerate(a) if x.startswith("--")), len(a))]
|
|
269
|
+
if verbs == ["cosmosdb", "show"]:
|
|
270
|
+
mode = os.environ.get("FAKE_LOOKUP", "absent")
|
|
271
|
+
if mode == "exists": print('{"id":"already-present"}'); sys.exit(0)
|
|
272
|
+
print("ERROR: (ResourceNotFound) missing" if mode == "absent" else "ERROR: (Forbidden) denied", file=sys.stderr)
|
|
273
|
+
sys.exit(3)
|
|
274
|
+
if os.environ.get("FAKE_FAIL") == " ".join(verbs): sys.exit(4)
|
|
275
|
+
if verbs not in (["cosmosdb", "create"], ["cosmosdb", "sql", "database", "create"],
|
|
276
|
+
["cosmosdb", "sql", "container", "create"], ["cosmosdb", "restore"],
|
|
277
|
+
["cosmosdb", "sql", "container", "restore"], ["cosmosdb", "sql", "database", "restore"]): sys.exit(14)
|
|
278
|
+
print('{"provisioningState":"Succeeded"}')
|
|
279
|
+
'''
|
|
280
|
+
|
|
281
|
+
|
|
282
|
+
class FakeCLI(unittest.TestCase):
|
|
283
|
+
def run_provision(self, lookup="absent", fail="", approval=True):
|
|
284
|
+
with tempfile.TemporaryDirectory() as d:
|
|
285
|
+
directory = Path(d); fake = directory / "az"; fake.write_text(FAKE_AZ); fake.chmod(0o700)
|
|
286
|
+
log = directory / "log"
|
|
287
|
+
env = os.environ.copy(); env.update(PATH=d + os.pathsep + env["PATH"], FAKE_LOG=str(log),
|
|
288
|
+
AZ_SUBSCRIPTION="sub-test", RESOURCE_GROUP="rg-test", ACCOUNT_NAME="cosmos-test",
|
|
289
|
+
LOCATION="eastus", FAKE_LOOKUP=lookup, FAKE_FAIL=fail,
|
|
290
|
+
APPROVED_TARGET_ID="/subscriptions/sub-test/resourceGroups/rg-test/providers/Microsoft.DocumentDB/databaseAccounts/" + ("cosmos-test" if approval else "wrong"))
|
|
291
|
+
result = subprocess.run(["bash", str(ROOT / "assets/provision.sh")], env=env,
|
|
292
|
+
capture_output=True, text=True, timeout=5, cwd=d)
|
|
293
|
+
calls = [json.loads(line) for line in log.read_text().splitlines()] if log.exists() else []
|
|
294
|
+
return result, calls
|
|
295
|
+
|
|
296
|
+
def test_actual_script_explicit_scope_and_arm_cli_equivalence(self):
|
|
297
|
+
result, calls = self.run_provision()
|
|
298
|
+
self.assertEqual(result.returncode, 0, result.stderr)
|
|
299
|
+
self.assertEqual(len(calls), 4)
|
|
300
|
+
for call in calls:
|
|
301
|
+
self.assertEqual(call[0], "cosmosdb")
|
|
302
|
+
self.assertEqual(call[call.index("--subscription") + 1], "sub-test")
|
|
303
|
+
self.assertEqual(call[call.index("--resource-group") + 1], "rg-test")
|
|
304
|
+
account, container = calls[1], calls[3]
|
|
305
|
+
template = json.loads((ROOT / "assets/account.arm.json").read_text())
|
|
306
|
+
props = template["resources"][0]["properties"]
|
|
307
|
+
for flag, wanted in [("--kind", template["resources"][0]["kind"]),
|
|
308
|
+
("--default-consistency-level", props["consistencyPolicy"]["defaultConsistencyLevel"]),
|
|
309
|
+
("--backup-policy-type", props["backupPolicy"]["type"]),
|
|
310
|
+
("--continuous-tier", props["backupPolicy"]["continuousModeProperties"]["tier"]),
|
|
311
|
+
("--disable-local-auth", "true"), ("--public-network-access", "DISABLED"),
|
|
312
|
+
("--minimal-tls-version", props["minimalTlsVersion"])]:
|
|
313
|
+
self.assertEqual(account[account.index(flag) + 1], wanted)
|
|
314
|
+
resource = template["resources"][2]["properties"]
|
|
315
|
+
self.assertEqual(container[container.index("--partition-key-path") + 1], resource["resource"]["partitionKey"]["paths"][0])
|
|
316
|
+
self.assertEqual(int(container[container.index("--throughput") + 1]), resource["options"]["throughput"])
|
|
317
|
+
self.assertEqual(int(container[container.index("--ttl") + 1]), resource["resource"]["defaultTtl"])
|
|
318
|
+
idx = Path(container[container.index("--idx") + 1][1:])
|
|
319
|
+
self.assertEqual(json.loads(idx.read_text()), resource["resource"]["indexingPolicy"])
|
|
320
|
+
self.assertNotIn("--key-uri", account)
|
|
321
|
+
self.assertNotIn("--max-throughput", container)
|
|
322
|
+
|
|
323
|
+
def test_create_never_adopts_or_treats_forbidden_as_absence(self):
|
|
324
|
+
for lookup in ["exists", "forbidden", "timeout"]:
|
|
325
|
+
result, calls = self.run_provision(lookup=lookup)
|
|
326
|
+
self.assertNotEqual(result.returncode, 0)
|
|
327
|
+
self.assertEqual(len(calls), 1)
|
|
328
|
+
|
|
329
|
+
def test_approval_full_target_mismatch_no_cli(self):
|
|
330
|
+
result, calls = self.run_provision(approval=False)
|
|
331
|
+
self.assertNotEqual(result.returncode, 0); self.assertEqual(calls, [])
|
|
332
|
+
|
|
333
|
+
def test_errors_abort_no_delete_fallback(self):
|
|
334
|
+
result, calls = self.run_provision(fail="cosmosdb create")
|
|
335
|
+
self.assertNotEqual(result.returncode, 0); self.assertEqual(len(calls), 2)
|
|
336
|
+
self.assertFalse(any("delete" in call for call in calls))
|
|
337
|
+
|
|
338
|
+
def test_actual_restore_snippet_with_fake_cli(self):
|
|
339
|
+
doc = (ROOT / "references/commands/restore/continuous-new-account.md").read_text()
|
|
340
|
+
snippet = re.search(r"```bash\n(.*?)```", doc, re.S).group(1)
|
|
341
|
+
with tempfile.TemporaryDirectory() as d:
|
|
342
|
+
directory = Path(d); fake = directory / "az"; fake.write_text(FAKE_AZ); fake.chmod(0o700)
|
|
343
|
+
env = os.environ.copy(); env.update(PATH=d + os.pathsep + env["PATH"], FAKE_LOG=str(directory / "log"),
|
|
344
|
+
AZ_SUBSCRIPTION="sub-test", TARGET_RESOURCE_GROUP="recovery-rg", SOURCE_ACCOUNT="source-cosmos",
|
|
345
|
+
TARGET_ACCOUNT="recovery-cosmos", LOCATION="eastus", RESTORE_TIMESTAMP="2026-11-08T08:30:00Z")
|
|
346
|
+
result = subprocess.run(["bash", "-euc", snippet], env=env, capture_output=True, text=True, timeout=5)
|
|
347
|
+
self.assertEqual(result.returncode, 0, result.stderr)
|
|
348
|
+
calls = [json.loads(line) for line in (directory / "log").read_text().splitlines()]
|
|
349
|
+
self.assertEqual(calls[0][:2], ["cosmosdb", "restore"])
|
|
350
|
+
self.assertEqual(calls[0][calls[0].index("--target-database-account-name") + 1], "recovery-cosmos")
|
|
351
|
+
self.assertEqual(calls[0][calls[0].index("--disable-ttl") + 1], "true")
|
|
352
|
+
|
|
353
|
+
|
|
354
|
+
if __name__ == "__main__":
|
|
355
|
+
unittest.main()
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
{
|
|
2
|
+
"id": "azure-cosmosdb-pattern",
|
|
3
|
+
"name": "Azure Cosmos DB Pattern",
|
|
4
|
+
"type": "skill",
|
|
5
|
+
"provider": "azure",
|
|
6
|
+
"harnesses": [
|
|
7
|
+
"codex",
|
|
8
|
+
"claude-code",
|
|
9
|
+
"cursor",
|
|
10
|
+
"gemini",
|
|
11
|
+
"kiro",
|
|
12
|
+
"other"
|
|
13
|
+
],
|
|
14
|
+
"summary": "Design, implement, refactor and audit Azure Cosmos DB for NoSQL access patterns: partition and id routing, indexing and RUs, consistency and session tokens, transactions and ETags, change feed, vectors, RBAC, encryption, continuous and periodic backup, new-account and in-account restore, monitoring and ARM/CLI provisioning, with command routes that load one guide at a time.",
|
|
15
|
+
"source_type": "adapted",
|
|
16
|
+
"official_docs": [
|
|
17
|
+
"https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-introduction",
|
|
18
|
+
"https://learn.microsoft.com/azure/cosmos-db/how-to-restore-in-account-continuous-backup"
|
|
19
|
+
],
|
|
20
|
+
"security_notes": "Not permission to access Azure. Live reads need a confirmed subscription, resource group, account and container; writes, restores, feature changes and load tests need exact approval. Bundled scripts are offline route selectors, a date-argument review reminder, an asset validator and a sanitized recovery guard.",
|
|
21
|
+
"last_verified": "2026-11-09",
|
|
22
|
+
"path": "skills/azure/azure-cosmosdb-pattern",
|
|
23
|
+
"author": "github: VincentChuWaiChow",
|
|
24
|
+
"version": "1.0.0"
|
|
25
|
+
}
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# Access — control plane isn't data access
|
|
2
|
+
|
|
3
|
+
| Layer | Native mechanism | Boundary |
|
|
4
|
+
|---|---|---|
|
|
5
|
+
| Azure resource management | Azure RBAC actions on Microsoft.DocumentDB account resources | Contributor/Operator controls account configuration, not automatically NoSQL item access |
|
|
6
|
+
| NoSQL data plane | Cosmos SQL role definitions/assignments with `dataActions`, Entra token | Scope account `/`, database `/dbs/<db>` or container `/dbs/<db>/colls/<container>` as required |
|
|
7
|
+
| Account keys | Read/write or read-only keys; broad account access when local auth enabled | Not scoped per tenant; don't list/print/embed keys or expose to browsers |
|
|
8
|
+
| Application tenant | Server-authenticated subject/tenant and trusted route | Partition key/query predicate isn't data RBAC row-level isolation |
|
|
9
|
+
| CMK | Cosmos service/default identity plus Key Vault key permissions | Data reader role doesn't authorize key administration or restore |
|
|
10
|
+
|
|
11
|
+
Prefer managed identity/Entra with existing credential flow. Data Reader built-in
|
|
12
|
+
ID ends `00000000-0000-0000-0000-000000000001`; Data Contributor ends `...0002`.
|
|
13
|
+
Use the account-specific role-definition resource ID and narrow scope. Query/change
|
|
14
|
+
feed access needs appropriate query/change-feed/readMetadata data actions; don't
|
|
15
|
+
copy a role name and assume effective permissions. Custom roles list exact
|
|
16
|
+
supported actions. ARM tags govern metadata/cost, not per-item authorization.
|
|
17
|
+
|
|
18
|
+
Approved creation example only (do not execute on load):
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
az cosmosdb sql role assignment create --subscription "$AZ_SUBSCRIPTION" \
|
|
22
|
+
--resource-group "$RESOURCE_GROUP" --account-name "$ACCOUNT_NAME" \
|
|
23
|
+
--principal-id "$APP_PRINCIPAL_OBJECT_ID" \
|
|
24
|
+
--role-definition-id "$DATA_READER_ROLE_DEFINITION_ID" \
|
|
25
|
+
--scope '/dbs/ordersdb/colls/orders'
|
|
26
|
+
```
|
|
27
|
+
|
|
28
|
+
Principal OBJECT ID isn't app/client ID. Before disabling local auth on an existing
|
|
29
|
+
account, prove all legitimate clients and operations support Entra, data roles
|
|
30
|
+
propagate and break-glass/recovery posture is reviewed; don't lock applications out.
|
|
31
|
+
The new-account example disables local auth deliberately but assigns no broad role.
|
|
32
|
+
Network ingress/private endpoint/DNS/firewall are separate from token authorization.
|
|
33
|
+
|
|
34
|
+
Restore requires management-plane enumerate/restore permissions such as
|
|
35
|
+
`Microsoft.DocumentDB/locations/restorableDatabaseAccounts/read` and applicable
|
|
36
|
+
restore actions, plus permission to create destination resources. Grant the exact
|
|
37
|
+
documented role/scope after reviewing current permission docs; a Data Contributor
|
|
38
|
+
assignment alone can't restore an account. Read-only audit never grants roles.
|
|
39
|
+
|
|
40
|
+
Sources: [Entra and data/control RBAC](https://learn.microsoft.com/azure/cosmos-db/how-to-setup-rbac),
|
|
41
|
+
[native data RBAC](https://learn.microsoft.com/azure/cosmos-db/how-to-connect-role-based-access-control),
|
|
42
|
+
[restore permissions](https://learn.microsoft.com/azure/cosmos-db/continuous-backup-restore-permissions).
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# Change feed / Azure consumers
|
|
2
|
+
|
|
3
|
+
| Mode | Contract |
|
|
4
|
+
|---|---|
|
|
5
|
+
| Latest version (default) | Creates/updates, possibly coalesced to latest version; no deletes/TTL-deletion history |
|
|
6
|
+
| All versions and deletes | NoSQL-only, requires continuous backup; history bounded by configured continuous retention. Verify selected SDK/mode/region/preview support and compatible consumer before enabling; not every Functions binding/processor has parity. |
|
|
7
|
+
|
|
8
|
+
Use existing SDK change-feed iterator/processor or Azure Functions binding for
|
|
9
|
+
the chosen mode. Lease container ownership/throughput, checkpoint persistence,
|
|
10
|
+
scale/rebalance, at-least-once/idempotent processing, per-partition ordering and
|
|
11
|
+
retry/poison-message handling are explicit. Don't promise global total ordering
|
|
12
|
+
or exactly-once effects. Preserve lease/checkpoint state through deployment and
|
|
13
|
+
test restart/rebalance/lag. Consumer data/lease RBAC is distinct from app read RBAC.
|
|
14
|
+
|
|
15
|
+
Exception: same-account deleted-resource restore creates a **new resource lifetime**.
|
|
16
|
+
Invalidate cached session/continuation tokens, restart clients/queries, and restart
|
|
17
|
+
feed listeners from the beginning for that restored lifetime. Old leases/checkpoints
|
|
18
|
+
are evidence, not valid resumption state; pre-deletion feed history isn't restored.
|
|
19
|
+
Idempotent replay/rebuild and business/tombstone/TTL-gap reconciliation are required;
|
|
20
|
+
restarting alone doesn't recover missing history. Load the selected same-account
|
|
21
|
+
restore guide only when this incident/workflow is actually selected.
|
|
22
|
+
|
|
23
|
+
For projections/search/embedding pipelines, stable source version/operation IDs
|
|
24
|
+
deduplicate and prevent stale overwrites. Latest-version mode needs explicit
|
|
25
|
+
tombstones or other deletion reconciliation; a TTL flag followed by eventual TTL
|
|
26
|
+
deletion must allow consumers time to observe the marker. All-versions retention
|
|
27
|
+
isn't an unlimited audit archive or a replacement for backup/restore.
|
|
28
|
+
|
|
29
|
+
Sources: [feed modes](https://learn.microsoft.com/azure/cosmos-db/change-feed-modes),
|
|
30
|
+
[same-account restore lifetime](https://learn.microsoft.com/azure/cosmos-db/restore-in-account-continuous-backup-introduction),
|
|
31
|
+
[processor](https://learn.microsoft.com/azure/cosmos-db/change-feed-processor).
|