@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,189 @@
|
|
|
1
|
+
# Firestore with MongoDB compatibility operations
|
|
2
|
+
|
|
3
|
+
Operational coverage for Firestore with MongoDB compatibility (Enterprise edition,
|
|
4
|
+
MongoDB-compatible API and drivers). It is a separate mode from Native mode: the
|
|
5
|
+
sections below cite MongoDB-compatibility pages only and do not assume Native-mode
|
|
6
|
+
features apply. Every section uses the same heading and states one status. Cite
|
|
7
|
+
evidence rows from [the evidence ledger](evidence-ledger.md) as `[FS-Exx]`.
|
|
8
|
+
`tests/validate-nosql-operations.py` enforces this structure.
|
|
9
|
+
|
|
10
|
+
Statuses:
|
|
11
|
+
|
|
12
|
+
- `VERIFIED`: the provider documents the capability; every statement below cites a
|
|
13
|
+
VERIFIED row.
|
|
14
|
+
- `PARTIAL`: some of it is documented and some is not, or it is limited (by tier,
|
|
15
|
+
mode, Region or API); say which part is which.
|
|
16
|
+
- `UNSUPPORTED`: provider documentation states the capability does not exist. Cite it.
|
|
17
|
+
- `UNVERIFIED`: no official page settled it in this pass. Say what was searched.
|
|
18
|
+
- `NOT APPLICABLE`: the capability does not apply to this service. Say why.
|
|
19
|
+
|
|
20
|
+
## Backup and restore
|
|
21
|
+
|
|
22
|
+
**Status:** PARTIAL
|
|
23
|
+
|
|
24
|
+
- Verified, scheduled backups: at most one daily and one weekly schedule per
|
|
25
|
+
database [FS-E203], retention up to 14 weeks [FS-E204], stored in the source
|
|
26
|
+
database's location. [FS-E281] Billing must be enabled. [FS-E206]
|
|
27
|
+
- Verified, restore target: a restore writes into a new database. [FS-E205] An
|
|
28
|
+
in-place restore means deleting the database and restoring under the same ID; it
|
|
29
|
+
needs downtime and the original is permanently lost once it starts. [FS-E209]
|
|
30
|
+
[FS-E208]
|
|
31
|
+
- Verified, PITR: disabled by default, minute granularity, 7 days of data. [FS-E210]
|
|
32
|
+
[FS-E211] Recover a subset by reading at a past timestamp and writing back, or the
|
|
33
|
+
whole database by clone or export of a whole-minute timestamp within seven days.
|
|
34
|
+
[FS-E212] PITR storage has no free tier. [FS-E230]
|
|
35
|
+
- Verified, not restored: backups exclude TTL policies, so reapply them after a
|
|
36
|
+
restore. [FS-E202] [FS-E207]
|
|
37
|
+
- Unconfirmed: whether SCRAM user credentials, IAM bindings, change streams or saved
|
|
38
|
+
queries are carried into a restored database. The backup and in-place restore
|
|
39
|
+
pages list only the TTL exclusion; verify these on a restored test database.
|
|
40
|
+
|
|
41
|
+
## Disaster recovery and replication
|
|
42
|
+
|
|
43
|
+
**Status:** PARTIAL
|
|
44
|
+
|
|
45
|
+
- Verified, replication design: regional databases replicate synchronously across at
|
|
46
|
+
least three zones [FS-E213]; multi-region databases across five zones in three
|
|
47
|
+
regions (two serving, one witness). [FS-E214]
|
|
48
|
+
- Verified, no operator action: replication is automatic and needs no extra
|
|
49
|
+
configuration or provisioning. [FS-E216]
|
|
50
|
+
- Verified, availability figures: 99.999 percent for multi-region and 99.99 percent
|
|
51
|
+
for regional. [FS-E215]
|
|
52
|
+
- Verified, locations: multi-region locations eur3, nam5 and nam7 exist, and the
|
|
53
|
+
location cannot be changed after provisioning. [FS-E219]
|
|
54
|
+
- Verified, data-disaster objectives: PITR write-back has a stated recovery time
|
|
55
|
+
objective of 0 and recovery point objective of 1 minute [FS-E217]; a clone reaches
|
|
56
|
+
seven days back with PITR enabled, one hour without. [FS-E218]
|
|
57
|
+
- Unconfirmed: no RTO or RPO is stated for a zone or region outage and no failover
|
|
58
|
+
step (automatic or manual) is described; treat failover as service-managed.
|
|
59
|
+
|
|
60
|
+
## Cost
|
|
61
|
+
|
|
62
|
+
**Status:** VERIFIED
|
|
63
|
+
|
|
64
|
+
- Official pricing: <https://cloud.google.com/firestore/enterprise/pricing>;
|
|
65
|
+
estimate with the Google Cloud pricing calculator at
|
|
66
|
+
<https://cloud.google.com/products/calculator>. Enterprise edition is billed in
|
|
67
|
+
units, not per document as in Standard edition.
|
|
68
|
+
- Read units: data processed (documents or indexes) in 4 KiB tranches. [FS-E220]
|
|
69
|
+
- Write units: data processed in 1 KiB tranches [FS-E221]; index entries written are
|
|
70
|
+
charged as write units. [FS-E225]
|
|
71
|
+
- Event units: data included in each event, in 4 KiB tranches. [FS-E222] Change
|
|
72
|
+
stream storage is billed on captured events and retention. [FS-E228]
|
|
73
|
+
- Real-time update units relate to Native-mode client libraries, not to MongoDB
|
|
74
|
+
compatibility. [FS-E223]
|
|
75
|
+
- Storage includes metadata and index overhead [FS-E224]; backup storage [FS-E227];
|
|
76
|
+
restore on backup size [FS-E279]; PITR storage with no free tier. [FS-E230]
|
|
77
|
+
- Managed deletes, PITR data, backup data, restore and clone operations carry no free
|
|
78
|
+
usage. [FS-E226] Network bandwidth is billed. [FS-E229]
|
|
79
|
+
|
|
80
|
+
## Monitoring
|
|
81
|
+
|
|
82
|
+
**Status:** VERIFIED
|
|
83
|
+
|
|
84
|
+
- Service is Cloud Monitoring; monitored resource `firestore.googleapis.com/Database`
|
|
85
|
+
breaks down by project, location and database ID. [FS-E231]
|
|
86
|
+
- `api/request_latencies` gives latency distributions. [FS-E232]
|
|
87
|
+
- Document metrics `document/read_ops_count`, `document/write_ops_count` and
|
|
88
|
+
`document/delete_ops_count` show read-heavy versus write-heavy load. [FS-E233]
|
|
89
|
+
- Billing metrics `api/billable_read_units`, `api/billable_write_units` and
|
|
90
|
+
`document/billable_managed_delete_write_units` exclude administrator operations.
|
|
91
|
+
[FS-E234]
|
|
92
|
+
- `index/write_count` against `document/write_ops_count` shows index fanout.
|
|
93
|
+
[FS-E235] TTL metrics `document/ttl_deletion_count` and
|
|
94
|
+
`document/ttl_expiration_to_deletion_delays` track TTL. [FS-E236]
|
|
95
|
+
- Predefined dashboards include request latencies, response codes and query stats.
|
|
96
|
+
[FS-E237]
|
|
97
|
+
- Documented alert example: p99 latency over a 5 minute rolling window above 250 ms
|
|
98
|
+
for 5 minutes. [FS-E238] The usage dashboard is an estimate. [FS-E239]
|
|
99
|
+
|
|
100
|
+
## Performance
|
|
101
|
+
|
|
102
|
+
**Status:** PARTIAL
|
|
103
|
+
|
|
104
|
+
- Verified, error signals: `Aborted (112)` means contention [FS-E240];
|
|
105
|
+
`DeadlineExceeded (262)` means the 60 second default deadline passed [FS-E241];
|
|
106
|
+
`InvalidArgument (2)` flags an index entry over 7.5 KiB. [FS-E242]
|
|
107
|
+
- Verified, hotspots: sustained high rates on one document and monotonic indexed
|
|
108
|
+
values such as timestamps can hotspot. [FS-E243] [FS-E244] Ramping too fast can
|
|
109
|
+
cause high latency or deadline errors. [FS-E245]
|
|
110
|
+
- Verified, limits: transactions 270 seconds with 60-second idle expiration [FS-E246];
|
|
111
|
+
at most 40,000 index entries per document and 8 MiB of index entries. [FS-E247]
|
|
112
|
+
- Verified, client: drivers must use TLS and disable retryable writes. [FS-E248]
|
|
113
|
+
- Not documented for this mode: the numeric 500/50/5 ramp rule and a quota-based
|
|
114
|
+
`RESOURCE_EXHAUSTED` signal appear only in Native-mode pages. Do not carry them over.
|
|
115
|
+
|
|
116
|
+
## IAM
|
|
117
|
+
|
|
118
|
+
**Status:** VERIFIED
|
|
119
|
+
|
|
120
|
+
- Control plane uses IAM roles; data-plane MongoDB methods map to `datastore.*`
|
|
121
|
+
permissions (for example, `GetMore` needs the permissions of the call that created
|
|
122
|
+
the cursor). [FS-E249]
|
|
123
|
+
- Clients authenticate with SCRAM, Compute Engine or Cloud Run service accounts, or
|
|
124
|
+
the Google Auth Library. [FS-E280]
|
|
125
|
+
- Data access role `roles/datastore.user` is for developers and service accounts.
|
|
126
|
+
[FS-E250] A new SCRAM credential has no permissions until a role is granted.
|
|
127
|
+
[FS-E254]
|
|
128
|
+
- Narrow control-plane roles: `roles/datastore.userCredsAdmin` [FS-E251] and
|
|
129
|
+
`roles/datastore.restoreAdmin`. [FS-E255]
|
|
130
|
+
- Least privilege: grant roles per database with IAM Conditions [FS-E253]; role
|
|
131
|
+
changes take up to 5 minutes. [FS-E252]
|
|
132
|
+
|
|
133
|
+
## Tagging
|
|
134
|
+
|
|
135
|
+
**Status:** VERIFIED
|
|
136
|
+
|
|
137
|
+
- Resource tags are supported on MongoDB-compatible databases. [FS-E256]
|
|
138
|
+
- Tags can be set at creation and attached to existing databases. [FS-E258]
|
|
139
|
+
[FS-E259]
|
|
140
|
+
- Attaching tags requires `roles/datastore.owner`. [FS-E257]
|
|
141
|
+
- Tag-based access control: tags can drive conditional allow or deny policies, such
|
|
142
|
+
as conditional IAM grants. [FS-E256]
|
|
143
|
+
|
|
144
|
+
## Encryption
|
|
145
|
+
|
|
146
|
+
**Status:** VERIFIED
|
|
147
|
+
|
|
148
|
+
- At rest: all data is encrypted before it is written to disk with no setup.
|
|
149
|
+
[FS-E260]
|
|
150
|
+
- In transit: TLS protects data over the Internet [FS-E261], and drivers must connect
|
|
151
|
+
with TLS. [FS-E248]
|
|
152
|
+
- CMEK restrictions: only on new databases at creation [FS-E262]; the key cannot be
|
|
153
|
+
changed but can be rotated, enabled and disabled [FS-E263]; the KMS key location
|
|
154
|
+
must match the database [FS-E265]; the default CMEK database quota per project is 0
|
|
155
|
+
because the feature is allowlisted. [FS-E264]
|
|
156
|
+
- With CMEK, data in transit or memory and database metadata stay under Google
|
|
157
|
+
default encryption. [FS-E266]
|
|
158
|
+
|
|
159
|
+
## Network isolation
|
|
160
|
+
|
|
161
|
+
**Status:** PARTIAL
|
|
162
|
+
|
|
163
|
+
- Verified, VPC Service Controls: restricting the Firestore API service also
|
|
164
|
+
restricts the bundled Datastore and Key Visualizer API services [FS-E267];
|
|
165
|
+
import and export need the Firestore service agent for full egress protection.
|
|
166
|
+
[FS-E273]
|
|
167
|
+
- Verified, private access: a VM without an external IP reaches the service through
|
|
168
|
+
Private Google Access on its subnet [FS-E269]; the domains support only the MongoDB
|
|
169
|
+
protocol on port 443. [FS-E270]
|
|
170
|
+
- Verified, restricted VIP: needs connectivity to the service VIP domain, which is
|
|
171
|
+
VPC Service Controls compliant [FS-E268]; the public `restricted.firestore.goog`
|
|
172
|
+
records cannot be used, so create a private DNS zone. [FS-E271]
|
|
173
|
+
- Verified, default path: the default domain uses public IP addresses. [FS-E272]
|
|
174
|
+
- Unverified: Private Service Connect endpoints and a setting that disables public
|
|
175
|
+
access. Searched the MongoDB-compatibility docs index, VPC Service Controls and
|
|
176
|
+
Private Google Access pages; none covers them.
|
|
177
|
+
|
|
178
|
+
## Audit logging
|
|
179
|
+
|
|
180
|
+
**Status:** VERIFIED
|
|
181
|
+
|
|
182
|
+
- Audit logging uses service name `datastore.googleapis.com`, covering
|
|
183
|
+
`firestore.googleapis.com`. [FS-E274]
|
|
184
|
+
- `ADMIN_WRITE` methods produce Admin Activity logs. [FS-E275] `DATA_READ`,
|
|
185
|
+
`DATA_WRITE` and `ADMIN_READ` methods produce Data Access logs. [FS-E276]
|
|
186
|
+
- MongoDB data-plane methods (Find, Aggregate, Insert, Update, Delete and others) are
|
|
187
|
+
listed as `DATA_READ` or `DATA_WRITE`, so they can be audited. [FS-E277]
|
|
188
|
+
- The caller is identified through the `AuthenticationInfo` field and caller IP in
|
|
189
|
+
request metadata. [FS-E278]
|
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
# Firestore (Native mode) operations
|
|
2
|
+
|
|
3
|
+
Operational coverage for Firestore in Native mode, Standard edition (Firestore API;
|
|
4
|
+
not Datastore mode, not Realtime Database, not Firestore with MongoDB
|
|
5
|
+
compatibility). Every section uses the same heading and states one status. Cite
|
|
6
|
+
evidence rows from [the evidence ledger](evidence-ledger.md) as `[FS-Exx]`.
|
|
7
|
+
`tests/validate-nosql-operations.py` enforces this structure.
|
|
8
|
+
|
|
9
|
+
Statuses:
|
|
10
|
+
|
|
11
|
+
- `VERIFIED`: the provider documents the capability; every statement below cites a
|
|
12
|
+
VERIFIED row.
|
|
13
|
+
- `PARTIAL`: some of it is documented and some is not, or it is limited (by tier,
|
|
14
|
+
mode, Region or API); say which part is which.
|
|
15
|
+
- `UNSUPPORTED`: provider documentation states the capability does not exist. Cite it.
|
|
16
|
+
- `UNVERIFIED`: no official page settled it in this pass. Say what was searched.
|
|
17
|
+
- `NOT APPLICABLE`: the capability does not apply to this service. Say why.
|
|
18
|
+
|
|
19
|
+
## Backup and restore
|
|
20
|
+
|
|
21
|
+
**Status:** VERIFIED
|
|
22
|
+
|
|
23
|
+
- Two recovery tools exist. Scheduled backups: at most one daily and one weekly
|
|
24
|
+
schedule per database, retention up to 14 weeks, stored in the source database's
|
|
25
|
+
location. [FS-E13] Point-in-time recovery (PITR) is a separate setting, disabled
|
|
26
|
+
by default, that keeps one version per minute for 7 days; without PITR you can
|
|
27
|
+
still read (not export) documents from the past hour. [FS-E12]
|
|
28
|
+
- Backups need billing enabled on the project. [FS-E150] Deleting the source
|
|
29
|
+
database does not delete its backups. [FS-E102]
|
|
30
|
+
- A restore always writes into a new database. [FS-E103] An in-place restore means
|
|
31
|
+
deleting the source database and restoring under the same ID: it needs downtime
|
|
32
|
+
and the original database is permanently lost once it starts. [FS-E151] [FS-E106]
|
|
33
|
+
- Not restored: backups exclude database TTL policies and Firebase Security Rules
|
|
34
|
+
[FS-E101], and a restore does not bring back App Engine search data or blob
|
|
35
|
+
entities from the `(default)` database. [FS-E149] Reapply TTL policies after a
|
|
36
|
+
restore. [FS-E104]
|
|
37
|
+
- Whole-database PITR recovery is a clone or a PITR export; a clone reaches up to
|
|
38
|
+
seven days back with PITR enabled. [FS-E111] A single document or subset is
|
|
39
|
+
recovered with a stale read at a past timestamp, then written back. [FS-E12]
|
|
40
|
+
- Cost of recovery: a restore is billed on backup size [FS-E105]; PITR storage has
|
|
41
|
+
no free tier and needs billing, and stale reads or exports inside the PITR window
|
|
42
|
+
incur read costs. [FS-E17]
|
|
43
|
+
- IAM for recovery is split across predefined roles, for example
|
|
44
|
+
`roles/datastore.backupsAdmin` and `roles/datastore.restoreAdmin`. [FS-E159]
|
|
45
|
+
[FS-E131]
|
|
46
|
+
|
|
47
|
+
## Disaster recovery and replication
|
|
48
|
+
|
|
49
|
+
**Status:** PARTIAL
|
|
50
|
+
|
|
51
|
+
- Verified, replication design: regional databases replicate synchronously across at
|
|
52
|
+
least three zones [FS-E107]; multi-region databases replicate synchronously across
|
|
53
|
+
five zones in three regions (two serving regions and one witness region).
|
|
54
|
+
[FS-E108]
|
|
55
|
+
- Verified, no operator action: replication is handled by Firestore without extra
|
|
56
|
+
configuration or provisioning. [FS-E109] Data keeps being served through the loss
|
|
57
|
+
of a zone (regional) or of a whole region (multi-region). [FS-E11]
|
|
58
|
+
- Verified, availability figures: 99.999 percent for multi-region and 99.99 percent
|
|
59
|
+
for regional databases. [FS-E152]
|
|
60
|
+
- Verified, location is permanent: it cannot be changed after provisioning, so
|
|
61
|
+
choose regional versus multi-region up front. [FS-E11]
|
|
62
|
+
- Verified, data-disaster objectives: the PITR page states a recovery time objective
|
|
63
|
+
of 0 and a recovery point objective of 1 minute for surgical write-back. [FS-E110]
|
|
64
|
+
A PITR export can archive the database to Cloud Storage past the 14-week backup
|
|
65
|
+
maximum. [FS-E153]
|
|
66
|
+
- Unconfirmed: the DR page states availability figures but no RTO or RPO for a
|
|
67
|
+
zone or region outage, and does not describe a failover step (automatic or
|
|
68
|
+
manual). Treat failover as service-managed without a documented objective.
|
|
69
|
+
|
|
70
|
+
## Cost
|
|
71
|
+
|
|
72
|
+
**Status:** VERIFIED
|
|
73
|
+
|
|
74
|
+
- Official pricing: <https://cloud.google.com/firestore/pricing> (also
|
|
75
|
+
<https://firebase.google.com/docs/firestore/pricing>); estimate with the Google
|
|
76
|
+
Cloud pricing calculator at <https://cloud.google.com/products/calculator>.
|
|
77
|
+
- Standard edition bills per document read, written and deleted. [FS-E117]
|
|
78
|
+
- Reads also bill index entries scanned: one read per batch of up to 1000 index
|
|
79
|
+
entries, with documented exceptions. [FS-E116] Aggregation queries bill on index
|
|
80
|
+
entries read, with a minimum of one document read. [FS-E154]
|
|
81
|
+
- Storage is billed including metadata and index overhead [FS-E112]; index
|
|
82
|
+
exemptions reduce storage cost. [FS-E10]
|
|
83
|
+
- Backup storage is billed when backups are enabled [FS-E114]; a restore is billed on
|
|
84
|
+
backup size [FS-E105]; PITR storage is billed separately and has no free tier.
|
|
85
|
+
[FS-E17]
|
|
86
|
+
- TTL deletes, PITR data, backup data, restore operations and clone operations carry
|
|
87
|
+
no free usage and require billing. [FS-E113]
|
|
88
|
+
- Network bandwidth used by requests is billed. [FS-E115]
|
|
89
|
+
|
|
90
|
+
## Monitoring
|
|
91
|
+
|
|
92
|
+
**Status:** VERIFIED
|
|
93
|
+
|
|
94
|
+
- Service is Cloud Monitoring (with the console usage and monitoring dashboards).
|
|
95
|
+
Service runtime metric `api/request_count` carries response code class and gRPC
|
|
96
|
+
status, so it yields the error rate. [FS-E118] `api/request_latencies` gives
|
|
97
|
+
latency distributions. [FS-E155] Service runtime metrics are sampled every 30
|
|
98
|
+
minutes, which smooths the data. [FS-E119]
|
|
99
|
+
- Document metrics `document/read_ops_count`, `document/write_ops_count` and
|
|
100
|
+
`document/delete_ops_count` show read-heavy versus write-heavy load. [FS-E120]
|
|
101
|
+
- TTL: `document/ttl_deletion_count` counts TTL deletes, which are excluded from
|
|
102
|
+
`document/delete_ops_count`. [FS-E156]
|
|
103
|
+
- `index/write_count` against `document/write_ops_count` shows index fanout.
|
|
104
|
+
[FS-E157]
|
|
105
|
+
- Documented alert example: a p99 latency policy over a 5 minute rolling window that
|
|
106
|
+
fires when latency stays above 250 ms for 5 minutes. [FS-E121]
|
|
107
|
+
- The usage dashboard is an estimate; the billing report wins on discrepancy.
|
|
108
|
+
[FS-E122]
|
|
109
|
+
|
|
110
|
+
## Performance
|
|
111
|
+
|
|
112
|
+
**Status:** VERIFIED
|
|
113
|
+
|
|
114
|
+
- Ramp traffic on a new collection with the 500/50/5 rule; automatic document IDs
|
|
115
|
+
are scattered and should not hotspot on writes. [FS-E04] [FS-E05]
|
|
116
|
+
- `ABORTED` can come from traffic that exceeds 500/50/5 or hits hot-spots
|
|
117
|
+
[FS-E123], and from contention between overlapping transactions. [FS-E158]
|
|
118
|
+
- `RESOURCE_EXHAUSTED` occurs when the free tier quota is exceeded without billing
|
|
119
|
+
enabled. [FS-E124] `DEADLINE_EXCEEDED` means an operation exceeded the 60 second
|
|
120
|
+
default deadline. [FS-E125]
|
|
121
|
+
- Sustained high rates on one document can hotspot, and indexed timestamps or other
|
|
122
|
+
monotonic values can hotspot at high rates. [FS-E127] [FS-E128]
|
|
123
|
+
- Write and transaction latency grows with the number of splits involved. [FS-E129]
|
|
124
|
+
- Limits that shape performance: 1 MiB documents and 10 MiB requests [FS-E01]; a
|
|
125
|
+
270-second transaction limit with a 60-second idle expiration [FS-E03]; indexed
|
|
126
|
+
field values over 1,500 bytes fail with `INVALID_ARGUMENT`. [FS-E126]
|
|
127
|
+
- Server client libraries use the database's concurrency mode, PESSIMISTIC by
|
|
128
|
+
default on Standard edition. [FS-E07]
|
|
129
|
+
|
|
130
|
+
## IAM
|
|
131
|
+
|
|
132
|
+
**Status:** VERIFIED
|
|
133
|
+
|
|
134
|
+
- Two access paths: server client libraries are secured with IAM and bypass
|
|
135
|
+
Firebase security rules, while mobile and web SDKs rely on security rules and
|
|
136
|
+
Firebase Auth. [FS-E08]
|
|
137
|
+
- Data-plane role `roles/datastore.user` grants read/write on data and is meant for
|
|
138
|
+
application developers and service accounts. [FS-E130]
|
|
139
|
+
- Control-plane duties have narrower roles: backups (`roles/datastore.backupsAdmin`)
|
|
140
|
+
[FS-E159], restore (`roles/datastore.restoreAdmin`, which also allows creating
|
|
141
|
+
databases) [FS-E131].
|
|
142
|
+
- Scope least privilege by granting the narrowest role on the specific database and
|
|
143
|
+
using IAM Conditions for time-bound or resource-bound access. [FS-E133]
|
|
144
|
+
- Role changes can take up to 5 minutes to apply because IAM permissions are cached.
|
|
145
|
+
[FS-E132]
|
|
146
|
+
- Tags can drive conditional IAM grants. [FS-E134]
|
|
147
|
+
|
|
148
|
+
## Tagging
|
|
149
|
+
|
|
150
|
+
**Status:** VERIFIED
|
|
151
|
+
|
|
152
|
+
- Resource tags (key-value pairs attached through tag bindings) are supported on
|
|
153
|
+
Firestore databases. [FS-E134]
|
|
154
|
+
- Tags can be set when the database is created and attached to existing databases.
|
|
155
|
+
[FS-E160] [FS-E136]
|
|
156
|
+
- Attaching tags to Firestore databases requires the Datastore Owner role
|
|
157
|
+
(`roles/datastore.owner`). [FS-E135]
|
|
158
|
+
- Tag-based access control: tags can conditionally allow or deny policies, for
|
|
159
|
+
example conditional IAM role grants. [FS-E134]
|
|
160
|
+
|
|
161
|
+
## Encryption
|
|
162
|
+
|
|
163
|
+
**Status:** VERIFIED
|
|
164
|
+
|
|
165
|
+
- At rest: all data is encrypted before it is written to disk with no setup. [FS-E137]
|
|
166
|
+
- In transit: TLS protects data over the Internet. [FS-E138]
|
|
167
|
+
- Customer-managed keys (CMEK, Cloud KMS) are available by access request. [FS-E161]
|
|
168
|
+
- CMEK restrictions: enable only when creating a database [FS-E139]; the key cannot
|
|
169
|
+
be changed afterwards but can be rotated, enabled and disabled [FS-E140]; the key
|
|
170
|
+
location must match the database location. [FS-E143]
|
|
171
|
+
- With CMEK, data in transit or memory and database metadata stay under Google
|
|
172
|
+
default encryption. [FS-E141]
|
|
173
|
+
- If the key becomes unavailable, calls fail with `FAILED_PRECONDITION` within 10
|
|
174
|
+
minutes. [FS-E142]
|
|
175
|
+
|
|
176
|
+
## Network isolation
|
|
177
|
+
|
|
178
|
+
**Status:** PARTIAL
|
|
179
|
+
|
|
180
|
+
- Verified: VPC Service Controls perimeters. Restricting the Firestore API service
|
|
181
|
+
also restricts the bundled Datastore and Key Visualizer API services. [FS-E144]
|
|
182
|
+
- Verified: for full egress protection, import and export must use the Firestore
|
|
183
|
+
service agent. [FS-E145]
|
|
184
|
+
- Unverified: private endpoints for Native mode (Private Google Access or Private
|
|
185
|
+
Service Connect guidance) and a setting that disables public access. Searched the
|
|
186
|
+
Firestore Native docs set (VPC Service Controls, regional endpoints, locations,
|
|
187
|
+
security pages); no page covers them. Do not infer them from the MongoDB
|
|
188
|
+
compatibility mode, which has its own Private Google Access page.
|
|
189
|
+
|
|
190
|
+
## Audit logging
|
|
191
|
+
|
|
192
|
+
**Status:** VERIFIED
|
|
193
|
+
|
|
194
|
+
- Cloud Audit Logs for Firestore track administrative and data-access operations.
|
|
195
|
+
[FS-E162]
|
|
196
|
+
- Methods needing `ADMIN_WRITE` permissions produce Admin Activity logs. [FS-E147]
|
|
197
|
+
Methods needing `DATA_READ`, `DATA_WRITE` or `ADMIN_READ` produce Data Access logs,
|
|
198
|
+
so data-plane reads and writes are auditable. [FS-E163]
|
|
199
|
+
- Configure audit logging with service name `datastore.googleapis.com`, which covers
|
|
200
|
+
`firestore.googleapis.com` too. [FS-E146]
|
|
201
|
+
- Gap: individual writes from import, bulk delete and TTL are not audit logged.
|
|
202
|
+
[FS-E148]
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# Cloud Firestore data modeling and operations
|
|
2
|
+
|
|
3
|
+
Load this for Firestore data-model, query, index, transaction, location,
|
|
4
|
+
backup, TTL or security-boundary questions. Every bracketed ID resolves in
|
|
5
|
+
[evidence-ledger.md](evidence-ledger.md). Text without an ID is labeled
|
|
6
|
+
inference or recommendation.
|
|
7
|
+
|
|
8
|
+
Scope: Standard edition, Native mode, unless stated. Firestore is a document
|
|
9
|
+
database: do not transfer DynamoDB, Cosmos DB or Bigtable key or capacity
|
|
10
|
+
concepts to it.
|
|
11
|
+
|
|
12
|
+
## Edition first
|
|
13
|
+
|
|
14
|
+
| Question | Standard | Enterprise | Evidence |
|
|
15
|
+
| --- | --- | --- | --- |
|
|
16
|
+
| MongoDB-compatible drivers? | no | yes ("Firestore with MongoDB compatibility" mode) | [FS-E15] |
|
|
17
|
+
| Single-field indexes | automatic | not automatic; fully customizable | [FS-E10] [FS-E15] |
|
|
18
|
+
| Server-library transaction default | PESSIMISTIC (locks read documents) | OPTIMISTIC | [FS-E07] |
|
|
19
|
+
|
|
20
|
+
In Enterprise, the mode (Native or MongoDB compatibility) is chosen at database
|
|
21
|
+
creation [FS-E15]. Confirm the edition before
|
|
22
|
+
giving any index or concurrency advice, because the defaults invert.
|
|
23
|
+
*(recommendation)*
|
|
24
|
+
|
|
25
|
+
## Limits that shape the model
|
|
26
|
+
|
|
27
|
+
- A document is at most **1 MiB**, subcollections nest at most **100** levels,
|
|
28
|
+
and a document carries at most **40,000 index entries** [FS-E01]. Unbounded
|
|
29
|
+
arrays or maps inside one document hit the size limit and the index-entry
|
|
30
|
+
limit. Model growing lists as subcollections or separate documents.
|
|
31
|
+
*(recommendation)*
|
|
32
|
+
- Composite indexes: 200 per database without billing, 1,000 with billing
|
|
33
|
+
[FS-E02]. Every composite index is a budget decision.
|
|
34
|
+
- Requests are at most 10 MiB, and transactions time out at 270 seconds with a
|
|
35
|
+
60-second idle expiry [FS-E01] [FS-E03]. Long-running read-modify-write logic
|
|
36
|
+
belongs outside a transaction. *(recommendation)*
|
|
37
|
+
|
|
38
|
+
## Write throughput and hotspots
|
|
39
|
+
|
|
40
|
+
- Ramp new collections with **500/50/5**: start at no more than 500 ops/s and
|
|
41
|
+
increase 50% every 5 minutes [FS-E04].
|
|
42
|
+
- Use automatic document IDs. They are scattered and should not hotspot
|
|
43
|
+
[FS-E05]. Avoid monotonically increasing document IDs. *(recommendation)*
|
|
44
|
+
- There is **no fixed per-document write rate**. It "depends highly on the
|
|
45
|
+
workload" [FS-E05]. Do not quote a hard number. Counters and other
|
|
46
|
+
single-document hot spots need sharding or aggregation designs, validated by
|
|
47
|
+
load test. *(recommendation)*
|
|
48
|
+
|
|
49
|
+
## Consistency and transactions
|
|
50
|
+
|
|
51
|
+
- Transactions are serializable, ordered by commit time [FS-E06].
|
|
52
|
+
- Concurrency: mobile/web SDKs are always optimistic. Server libraries follow
|
|
53
|
+
the database setting, which defaults to pessimistic on Standard edition and
|
|
54
|
+
optimistic on Enterprise [FS-E07]. Pessimistic transactions lock what they
|
|
55
|
+
read, so long or wide server-side transactions on Standard edition create
|
|
56
|
+
contention. *(inference)*
|
|
57
|
+
|
|
58
|
+
## Queries and indexes
|
|
59
|
+
|
|
60
|
+
- Single-field indexes are automatic on Standard edition. Composite indexes are
|
|
61
|
+
never created automatically, and exemptions cut storage and write cost
|
|
62
|
+
[FS-E10]. Exempt large or never-queried fields. *(recommendation)*
|
|
63
|
+
- Standard edition limits [FS-E09]:
|
|
64
|
+
- at most 30 disjunctions (fixed)
|
|
65
|
+
- `not-in` takes up to 10 values and cannot combine with `!=`
|
|
66
|
+
- at most one `array-contains` per disjunction
|
|
67
|
+
- A query design that needs more fan-out than these limits allow needs a
|
|
68
|
+
different data model, not a workaround. *(recommendation)*
|
|
69
|
+
|
|
70
|
+
## Security boundary
|
|
71
|
+
|
|
72
|
+
- Firebase security rules are evaluated for **mobile/web SDK** traffic. **Server
|
|
73
|
+
client libraries bypass rules entirely** and are governed by IAM [FS-E08].
|
|
74
|
+
- A backend service account with broad IAM roles can read and write
|
|
75
|
+
everything regardless of rules. Review IAM for every server path, and never
|
|
76
|
+
treat rules as protection against a compromised backend. *(inference)*
|
|
77
|
+
|
|
78
|
+
## Location, backup and recovery
|
|
79
|
+
|
|
80
|
+
- Location is **permanent** after provisioning [FS-E11]. Choose multi-region
|
|
81
|
+
for regional-outage survival, regional for lower cost and write latency
|
|
82
|
+
[FS-E11].
|
|
83
|
+
- PITR is **off by default**. When enabled it keeps one version per minute for
|
|
84
|
+
7 days. Without it, you can read (not export) data from only the past hour
|
|
85
|
+
[FS-E12]. Treat "PITR not enabled" as a finding on production databases.
|
|
86
|
+
*(recommendation)* PITR has no free tier and needs billing enabled, reads or
|
|
87
|
+
exports in the PITR window are billed as reads, and up to one day of PITR
|
|
88
|
+
storage may be charged even if PITR is disabled within a day [FS-E17].
|
|
89
|
+
- Scheduled backups allow one daily and one weekly schedule, keep backups up to
|
|
90
|
+
14 weeks in the source location, and restore to a **new** database [FS-E13].
|
|
91
|
+
The restore plan must cover repointing clients. *(inference)*
|
|
92
|
+
|
|
93
|
+
## TTL
|
|
94
|
+
|
|
95
|
+
TTL deletes typically within 24 hours, and expired documents still appear in
|
|
96
|
+
queries until deleted [FS-E14]. Filter expired documents in queries. Never use
|
|
97
|
+
TTL for exact-time deletion obligations. *(recommendation)*
|
|
98
|
+
|
|
99
|
+
## Server libraries
|
|
100
|
+
|
|
101
|
+
| Language | Install | Evidence |
|
|
102
|
+
| --- | --- | --- |
|
|
103
|
+
| Python | `pip install --upgrade google-cloud-firestore` | [FS-E18] |
|
|
104
|
+
| Node.js | `npm install --save @google-cloud/firestore` | [FS-E18] |
|
|
105
|
+
| Go | `go get cloud.google.com/go/firestore` | [FS-E18] |
|
|
106
|
+
| Java | Maven `com.google.cloud:google-cloud-firestore` via `libraries-bom` | [FS-E18] |
|
|
107
|
+
|
|
108
|
+
Resolve the current version from the package registry. *(rule)*
|
|
109
|
+
|
|
110
|
+
## Datastore mode
|
|
111
|
+
|
|
112
|
+
Datastore compatibility is a database-level setting chosen at creation. Such a
|
|
113
|
+
database accepts Datastore API requests, denies Firestore API requests, and has
|
|
114
|
+
no Firestore real-time capabilities [FS-E19]. The rules in this file do not
|
|
115
|
+
apply to it. Confirm the mode before advising, and do not promise listeners or
|
|
116
|
+
Firestore client SDK features on a Datastore-mode database. *(recommendation)*
|
|
117
|
+
|
|
118
|
+
## Not covered here
|
|
119
|
+
|
|
120
|
+
Billing dimensions (not prices) are in the Cost section of
|
|
121
|
+
[the operations reference](firestore-operations.md). Prices are not encoded: fetch
|
|
122
|
+
the official pricing page or label the answer an assumption.
|
|
@@ -39,7 +39,7 @@ If the task is not GCP-related (e.g., the user describes an AWS or Azure scenari
|
|
|
39
39
|
| `containers` | GKE Standard/Autopilot, node pools, Workload Identity, Binary Authorization, node upgrades |
|
|
40
40
|
| `serverless` | Cloud Run, Cloud Functions gen2, Eventarc, Cloud Endpoints |
|
|
41
41
|
| `data-analytics` | BigQuery, Dataflow, Pub/Sub, Dataproc, Cloud Composer, Dataplex |
|
|
42
|
-
| `database` | AlloyDB, Cloud SQL, Cloud Spanner, Firestore, Memorystore |
|
|
42
|
+
| `database` | AlloyDB, Cloud SQL, Cloud Spanner, Bigtable, Firestore, Memorystore |
|
|
43
43
|
| `ai-ml` | Vertex AI Training/Pipelines, Model Registry, Feature Store, Endpoints, Gemini API, Agent Runtime (formerly Agent Engine) agent review |
|
|
44
44
|
| `security-iam` | IAM, Service Accounts, Workload Identity Federation, Org Policies, VPC Service Controls, Access Context Manager |
|
|
45
45
|
| `networking` | Global VPC, Shared VPC, Cloud Interconnect, Cloud NAT, Cloud DNS, Traffic Director, Apigee, Cloud Armor |
|
|
@@ -64,6 +64,7 @@ If the task is not GCP-related (e.g., the user describes an AWS or Azure scenari
|
|
|
64
64
|
| `gcp-data-pipeline-engineer-agent` | data-analytics | Building or troubleshooting Dataflow pipelines, Pub/Sub topics, Dataproc clusters, Cloud Composer DAGs, Dataplex zones |
|
|
65
65
|
| `gcp-alloydb-cloudsql-dba-agent` | database | Operating AlloyDB clusters, Cloud SQL instances, HA configuration, read replicas, connection pooling, maintenance windows |
|
|
66
66
|
| `gcp-spanner-architect-agent` | database | Designing Cloud Spanner schemas (hotspot avoidance, interleaving), index strategy, processing-unit sizing, global write patterns |
|
|
67
|
+
| `gcp-bigtable-architect-agent` | database | Reviewing Bigtable row-key and hotspot design, column families and garbage collection, app profiles and single- vs multi-cluster routing, replication consistency, node sizing; static review only |
|
|
67
68
|
| `gcp-vertex-ai-mlops-engineer-agent` | ai-ml | Managing Vertex AI training jobs (GPU/TPU cost governance), Pipelines, Model Registry, Feature Store, Endpoints, Gemini API integration |
|
|
68
69
|
| `gcp-agent-runtime-review-agent` | ai-ml | Static review of agents on Agent Runtime (formerly Vertex AI Agent Engine; resource ReasoningEngine), ADK guardrails, runtime identity, revisions, traffic and deletion plans; never deploys |
|
|
69
70
|
| `gcp-iam-least-privilege-review-agent` | security-iam | Auditing IAM bindings, reviewing Service Account key sprawl, designing Workload Identity Federation, evaluating org policy conditions |
|
package/skills/huawei/README.md
CHANGED
|
@@ -8,7 +8,7 @@ This folder contains Huawei Cloud-focused skills curated for this marketplace.
|
|
|
8
8
|
|
|
9
9
|
## Local marketplace portfolio
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
This folder contains these local Huawei Cloud skills (see `catalog/skills.json` for the authoritative inventory):
|
|
12
12
|
|
|
13
13
|
- `huawei-cce-container-platform-operator`
|
|
14
14
|
- `huawei-certificate-manager-issuer-review`
|
|
@@ -25,6 +25,7 @@ As of **2026-05-09**, this folder contains **43** local Huawei Cloud skills:
|
|
|
25
25
|
- `huawei-event-driven-architecture-review`
|
|
26
26
|
- `huawei-functiongraph-serverless-operator`
|
|
27
27
|
- `huawei-gaussdb-rds-dba`
|
|
28
|
+
- `huawei-geminidb-architect`
|
|
28
29
|
- `huawei-iac-change-safety-review`
|
|
29
30
|
- `huawei-iam-least-privilege-review`
|
|
30
31
|
- `huawei-ief-edge-computing-operator`
|
|
@@ -4,8 +4,8 @@ description: Manage Huawei GaussDB (MySQL, PostgreSQL, Oracle-compatible), RDS i
|
|
|
4
4
|
allowed-tools: Read Grep Glob
|
|
5
5
|
metadata:
|
|
6
6
|
author: "github: VincentChuWaiChow"
|
|
7
|
-
version: "0.1.
|
|
8
|
-
updated: "2026-
|
|
7
|
+
version: "0.1.1"
|
|
8
|
+
updated: "2026-11-08"
|
|
9
9
|
category: database
|
|
10
10
|
---
|
|
11
11
|
|
|
@@ -32,7 +32,7 @@ Use this skill for:
|
|
|
32
32
|
- GaussDB for Oracle: Oracle SQL-compatible but with PL/SQL gaps (specific packages, data types, stored procedures) — always test migration before cutover; do not assume compatibility.
|
|
33
33
|
- GaussDB for MySQL: shared storage like Aurora — different architecture from standard MySQL; backup and recovery behavior differs.
|
|
34
34
|
- RDS: conventional per-instance database; parameter group changes may require instance restart.
|
|
35
|
-
- DDS: MongoDB-compatible document store —
|
|
35
|
+
- DDS: MongoDB-compatible document store — shard key selection is irreversible; under ranged sharding a monotonically increasing key concentrates inserts, ranged sharding serves range queries, and hashed sharding distributes data more evenly [HW-DDS-E01]. Choose by query pattern *(recommendation)*. For MongoDB-compatible work use DDS, not the end-of-support GeminiDB Mongo API (see `huawei-geminidb-architect`).
|
|
36
36
|
- Database proxy: connection pooling + read/write splitting — proxy configuration affects all downstream application connections.
|
|
37
37
|
- CBR backup with PITR: point-in-time recovery requires continuous log backup — verify log backup is enabled separately from snapshot backup.
|
|
38
38
|
|
|
@@ -43,7 +43,7 @@ Use this skill for:
|
|
|
43
43
|
- Database deletion without CBR backup is permanently destructive — require CBR backup verification before recommending any database deletion.
|
|
44
44
|
- GaussDB for Oracle PL/SQL compatibility gaps can break migration — require test results for all stored procedures before declaring Oracle migration complete.
|
|
45
45
|
- Failover testing must be coordinated with application teams — never recommend untested failover on production.
|
|
46
|
-
- DDS shard key selection is irreversible — require explicit approval before setting shard keys.
|
|
46
|
+
- DDS shard key selection is irreversible [HW-DDS-E01] — require explicit approval before setting shard keys. Grant `DDS ReadOnlyAccess` for review and `DDS ManageAccess` (all operations except deleting DDS resources) rather than `DDS FullAccess` where deletion is not needed [HW-DDS-E02].
|
|
47
47
|
- Challenge databases without CBR backup, Oracle migrations without compatibility testing, and proxy configurations without health check validation.
|
|
48
48
|
- Load references only when needed.
|
|
49
49
|
|
|
@@ -51,6 +51,9 @@ Use this skill for:
|
|
|
51
51
|
|
|
52
52
|
Load these only when needed:
|
|
53
53
|
|
|
54
|
+
- [DDS operations](references/dds-operations.md) — DDS backup and restore, disaster recovery, billing dimensions, monitoring, performance, IAM, tagging, encryption, network isolation and audit logging.
|
|
55
|
+
- [Audit](references/commands/audit.md) — offline or live audit against the operations reference; load only when an audit is requested.
|
|
56
|
+
- [DDS evidence ledger](references/evidence-ledger.md) — use when a DDS claim must be traced to its Huawei Cloud source.
|
|
54
57
|
- [Official sources](references/official-sources.md) — use when grounding GaussDB, RDS, or DDS service behavior or checking the detailed source list.
|
|
55
58
|
- [Workflow and output contract](references/workflow-and-output.md) — use when executing a full database review or formatting the final answer.
|
|
56
59
|
|
|
@@ -3,17 +3,25 @@
|
|
|
3
3
|
"name": "Huawei GaussDB/RDS DBA",
|
|
4
4
|
"type": "skill",
|
|
5
5
|
"provider": "huawei",
|
|
6
|
-
"harnesses": [
|
|
6
|
+
"harnesses": [
|
|
7
|
+
"codex",
|
|
8
|
+
"claude-code",
|
|
9
|
+
"cursor",
|
|
10
|
+
"gemini",
|
|
11
|
+
"kiro",
|
|
12
|
+
"other"
|
|
13
|
+
],
|
|
7
14
|
"summary": "Manage Huawei GaussDB, RDS instances, DDS MongoDB-compatible document store, database proxy connection pooling, and HA/backup architecture with CBR integration.",
|
|
8
15
|
"source_type": "original",
|
|
9
16
|
"official_docs": [
|
|
10
17
|
"https://support.huaweicloud.com/intl/en-us/gaussdb_mysql/index.html",
|
|
11
18
|
"https://support.huaweicloud.com/intl/en-us/rds/index.html",
|
|
12
|
-
"https://support.huaweicloud.com/intl/en-us/dds/index.html"
|
|
19
|
+
"https://support.huaweicloud.com/intl/en-us/dds/index.html",
|
|
20
|
+
"https://support.huaweicloud.com/intl/en-us/usermanual-dds/dds_01_0061.html"
|
|
13
21
|
],
|
|
14
22
|
"security_notes": "Database deletion without CBR backup is permanently destructive. GaussDB for Oracle PL/SQL gaps can break migration — test all procedures before cutover. Failover testing must be coordinated with application teams.",
|
|
15
|
-
"last_verified": "2026-
|
|
23
|
+
"last_verified": "2026-11-08",
|
|
16
24
|
"path": "skills/huawei/huawei-gaussdb-rds-dba",
|
|
17
25
|
"author": "github: VincentChuWaiChow",
|
|
18
|
-
"version": "0.1.
|
|
26
|
+
"version": "0.1.1"
|
|
19
27
|
}
|