@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,8 @@
|
|
|
1
|
+
# Restore dispatcher — new destination only
|
|
2
|
+
|
|
3
|
+
Select `restore/migrator.md` OR `restore/sdk.md`. Review exact source export and NEW
|
|
4
|
+
region/compartment/table; never drop/reset/overwrite the source or an existing
|
|
5
|
+
production table. Run the offline manifest checker only if a sanitized manifest is
|
|
6
|
+
provided; its pass is caller-evidence consistency, not cloud verification. Require
|
|
7
|
+
separate import/new-table/cutover approval, IAM/key access and validation. There is
|
|
8
|
+
no `--method pitr` alias or recovered point before an available verified export.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
# Select — scope only
|
|
2
|
+
|
|
3
|
+
Parse the requested feature IDs through `scripts/select_mode.py`; ask only if the
|
|
4
|
+
intended service/API blocks correctness. Return selected features/paths, assumptions
|
|
5
|
+
and unsupported requests. Load only returned guides, not linked children. Selection
|
|
6
|
+
lasts one request; it neither toggles OCI resources nor proves IAM or host routing.
|
|
7
|
+
For `vectors`, explain the reviewed absence of a verified NDCS native ANN interface
|
|
8
|
+
and offer a separately approved vector-service design, never a fictional command.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
# Embedding/source mapping and separate retrieval service
|
|
2
|
+
|
|
3
|
+
Application flow: authenticated source→approved embedding model→validate finite
|
|
4
|
+
numeric vector/model/dimension→persist NoSQL source/provenance→idempotently update
|
|
5
|
+
a separately chosen vector index. NoSQL holds canonical source metadata, not a
|
|
6
|
+
native knowledge-base ingestion/search control plane. OCI Generative AI generation
|
|
7
|
+
and Oracle AI Database vector search are different services; neither silently
|
|
8
|
+
makes NDCS an ANN database. Do not import Bedrock or S3 Vectors commands.
|
|
9
|
+
|
|
10
|
+
Record `tenantId, sourceId, sourceHash, chunkId, model/version, dimension, precision,
|
|
11
|
+
normalization, generatedAt, sourceVersion` with the embedding. A URI is a reference;
|
|
12
|
+
materialize authorized content before generation and honor source deletions/TTL.
|
|
13
|
+
Never mix query/document embedding spaces or version sets. NoSQL and vector-store
|
|
14
|
+
writes are not one transaction: design durable app outbox/reconciliation,
|
|
15
|
+
idempotency, ordering and tombstone propagation; do not invent DynamoDB Streams.
|
|
16
|
+
|
|
17
|
+
For a requested OCI GenAI example, resolve current supported model/region first,
|
|
18
|
+
then use its official `EmbedText` operation with approved non-sensitive text;
|
|
19
|
+
the model's returned embedding length, not a copied constant, fixes dimensions.
|
|
20
|
+
The [validator](../assets/query-pages.mjs) demonstrates only a local contract;
|
|
21
|
+
it does not call a model. Evaluate recall@k vs labeled authorized results, stale
|
|
22
|
+
source/deletion leakage, precision loss, latency/cost and per-tenant filtering.
|
|
23
|
+
|
|
24
|
+
[OCI vector-store concepts](https://docs.oracle.com/en-us/iaas/Content/generative-ai/vector-stores.htm),
|
|
25
|
+
[separate AI Database embedding workflow](https://docs.oracle.com/en/cloud/paas/autonomous-database/vcapi/concepts/vector-table.html), checked 2026-11-08.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Default managed encryption versus dedicated CMEK
|
|
2
|
+
|
|
3
|
+
| Choice | Scope / precondition | Recovery dependency |
|
|
4
|
+
|---|---|---|
|
|
5
|
+
| Oracle-managed master key | NDCS default encryption at rest; application still owns IAM/network/backup security | verify target/table settings, TLS and backup storage controls |
|
|
6
|
+
| Customer-managed master key | NDCS dedicated hosted environment configured for CMEK, OCI Vault/KMS and service-owner onboarding | preserve required keys, grants and environment eligibility throughout retained backups/recovery |
|
|
7
|
+
|
|
8
|
+
Do not invent a per-table Terraform `kms_key_id`/SSE switch in `oci_nosql_table`.
|
|
9
|
+
The bundled IaC is the default-managed path only. Dedicated CMEK configuration is
|
|
10
|
+
a separate owner-approved environment workflow; no live change is supplied here.
|
|
11
|
+
Rotation rewraps storage keys rather than re-encrypting every application record.
|
|
12
|
+
Disable/delete, revoked grants, inaccessible Vault or lost old-key dependencies can
|
|
13
|
+
break availability/recovery; stop destructive key actions and obtain a full usage/
|
|
14
|
+
backup dependency review. Object Storage export encryption is a separately selected
|
|
15
|
+
bucket/key setting, not automatically identical to table encryption. Never print
|
|
16
|
+
plaintext customer records to prove encryption.
|
|
17
|
+
|
|
18
|
+
[Oracle CMEK scope/lifecycle](https://docs.oracle.com/en/cloud/paas/nosql-cloud/icxer/), checked 2026-11-08.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Evidence index
|
|
2
|
+
|
|
3
|
+
This index maps the rows of [the evidence ledger](evidence-ledger.md) to the skill
|
|
4
|
+
files they support, and lists every claim that is unconfirmed or conflicting.
|
|
5
|
+
|
|
6
|
+
## Verification summary
|
|
7
|
+
|
|
8
|
+
Each material claim was checked against the provider page it cites, or the closest
|
|
9
|
+
official page, on 2026-11-09. No claim was contradicted. The orchestrator then re-checked every
|
|
10
|
+
VERIFIED quote mechanically on the cited page; rows it could not confirm were
|
|
11
|
+
downgraded to UNVERIFIED. UNVERIFIED and CONFLICT rows are listed below; treat those
|
|
12
|
+
statements as unconfirmed until re-checked.
|
|
13
|
+
|
|
14
|
+
## Evidence by topic
|
|
15
|
+
|
|
16
|
+
### All references and assets
|
|
17
|
+
|
|
18
|
+
Covers every file under references/ and the Terraform, DDL, JSON, shell and Node assets.
|
|
19
|
+
|
|
20
|
+
[OCP-E101] [OCP-E102] [OCP-E103] [OCP-E104] [OCP-E105] [OCP-E106] [OCP-E107]
|
|
21
|
+
[OCP-E108] [OCP-E109] [OCP-E110] [OCP-E111] [OCP-E112] [OCP-E113] [OCP-E114]
|
|
22
|
+
[OCP-E115] [OCP-E116] [OCP-E117] [OCP-E118] [OCP-E119] [OCP-E120] [OCP-E121]
|
|
23
|
+
[OCP-E122] [OCP-E123] [OCP-E124] [OCP-E125] [OCP-E126] [OCP-E127] [OCP-E128]
|
|
24
|
+
[OCP-E129] [OCP-E130] [OCP-E131] [OCP-E132] [OCP-E133] [OCP-E134] [OCP-E135]
|
|
25
|
+
[OCP-E136] [OCP-E137] [OCP-E138] [OCP-E139] [OCP-E140] [OCP-E141] [OCP-E142]
|
|
26
|
+
[OCP-E143] [OCP-E144] [OCP-E145] [OCP-E146] [OCP-E147] [OCP-E148] [OCP-E149]
|
|
27
|
+
[OCP-E150] [OCP-E151] [OCP-E152] [OCP-E153] [OCP-E154] [OCP-E155] [OCP-E156]
|
|
28
|
+
[OCP-E157] [OCP-E158]
|
|
29
|
+
|
|
30
|
+
## Unconfirmed and conflicting claims
|
|
31
|
+
|
|
32
|
+
| Evidence | Status | Claim |
|
|
33
|
+
| --- | --- | --- |
|
|
34
|
+
| [OCP-E102] | UNVERIFIED | capacity_mode / capacityMode value "PROVISIONED" is valid (assets/orders.tf:29, assets/table-limits.json:2) |
|
|
35
|
+
| [OCP-E104] | UNVERIFIED | No per-table `kms_key_id`/SSE argument exists in `oci_nosql_table` (references/encryption.md:8; references/provisioning.md:15; commands/feature-plan.md:9) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. |
|
|
36
|
+
| [OCP-E108] | UNVERIFIED | `oci iam tenancy get --tenancy-id` and `oci iam compartment get --compartment-id` exist (assets/create-table.sh:14,16) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. |
|
|
37
|
+
| [OCP-E134] | UNVERIFIED | NDCS source params readUnitsPercent, includeTTL, requestTimeoutMs; top-level abortOnError (assets/migrator-export.json:8-10) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. |
|
|
38
|
+
| [OCP-E139] | UNVERIFIED | INTEGER is signed 32-bit, LONG signed 64-bit (references/types-and-vectors.md:3-4) |
|
|
39
|
+
| [OCP-E141] | UNVERIFIED | No native vector type / ANN / HNSW / IVF in NDCS (references/types-and-vectors.md:15; embedding-integrations.md:5-8; sources.md:54; commands/select.md:7) |
|
|
40
|
+
| [OCP-E143] | UNVERIFIED | Indexes consume the table's storage/write budget; no separate GSI capacity (references/indexes.md:12-14) |
|
|
41
|
+
| [OCP-E145] | UNVERIFIED | Parent/child tables share top parent's limits and shard key (references/modeling.md:14-16; replicas) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. |
|
|
42
|
+
| [OCP-E149] | UNVERIFIED | Node package `oracle-nosqldb` exports Consistency / NoSQLClient (language-adapters.md:66,89; sources.md) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. |
|
|
43
|
+
| [OCP-E155] | UNVERIFIED | REST has fewer SQL features than native SDKs (language-adapters.md:79-80,199-203; sources.md:11) |
|
|
44
|
+
| [OCP-E157] | UNVERIFIED | Table name regex caps at 64 chars (references/limits-in-assets: assets/orders.tf:14, create-table.sh:10) |
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Evidence ledger — Oracle NoSQL Database Cloud Service patterns
|
|
2
|
+
|
|
3
|
+
Rows trace material provider claims in this skill to the official page that was
|
|
4
|
+
fetched and read on the retrieval date. [The evidence index](evidence-index.md) maps every
|
|
5
|
+
row to the skill files it covers; `tests/validate-skill-references.py` fails the build
|
|
6
|
+
if a citation has no row, a row is never cited, or a source is not an allow-listed
|
|
7
|
+
host.
|
|
8
|
+
|
|
9
|
+
`VERIFIED` = the cited section was retrieved and supports the claim as worded
|
|
10
|
+
(documentation verification, not a live cloud test). `UNVERIFIED` = no official
|
|
11
|
+
sentence settled it in this pass. `CONFLICT` = two official pages disagree. Limits and
|
|
12
|
+
APIs change: re-fetch before relying on a number.
|
|
13
|
+
|
|
14
|
+
| ID | Claim | Source | Section | Retrieved | Status |
|
|
15
|
+
| --- | --- | --- | --- | --- | --- |
|
|
16
|
+
| OCP-E101 | Terraform `oci_nosql_table` takes compartment_id, name, ddl_statement, is_auto_reclaimable, freeform_tags, table_limits{capacity_mode,max_read_units,max_write_units,max_storage_in_gbs} (assets/orders.tf:22-33; references/provisioning.md:10) | https://docs.oracle.com/en-us/iaas/tools/terraform-provider-oci/latest/docs/r/nosql_table.html | Argument Reference: "`max_read_units` - (Required) (Updatable) Maximum sustained read throughput limit for the table." (also lists compartment_id, ddl_statement, freeform_tags, is_auto_reclaimable, name, capacity_mode, max_storage_in_gbs, m | 2026-11-09 | VERIFIED |
|
|
17
|
+
| OCP-E102 | capacity_mode / capacityMode value "PROVISIONED" is valid (assets/orders.tf:29, assets/table-limits.json:2) | https://docs.oracle.com/en-us/iaas/tools/terraform-provider-oci/latest/docs/r/nosql_table.html | Argument Reference: "The capacity mode of the table. If capacityMode = ON_DEMAND, maxReadUnits and maxWriteUnits are not used". The page names ON_DEMAND only; "PROVISIONED" literal is not spelled out (the GAT page says "provisioned" in pros | 2026-11-09 | UNVERIFIED |
|
|
18
|
+
| OCP-E103 | Terraform `oci_nosql_index`: name, table_name_or_id, compartment_id, is_if_not_exists, repeated `keys { column_name }` (assets/orders.tf:36-45) | https://docs.oracle.com/en-us/iaas/tools/terraform-provider-oci/latest/docs/r/nosql_index.html | Argument Reference: "`keys`- (Required) A set of keys for a secondary index. ... `column_name` - (Required) The name of a column to be included as an index key." and "`is_if_not_exists` - (Optional) If true, the operation completes successf | 2026-11-09 | VERIFIED |
|
|
19
|
+
| OCP-E104 | No per-table `kms_key_id`/SSE argument exists in `oci_nosql_table` (references/encryption.md:8; references/provisioning.md:15; commands/feature-plan.md:9) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. | https://docs.oracle.com/en-us/iaas/tools/terraform-provider-oci/latest/docs/r/nosql_table.html | Argument Reference: Argument list is only compartment_id, ddl_statement, defined_tags, freeform_tags, is_auto_reclaimable, name, table_limits (no key argument) | 2026-11-09 | UNVERIFIED |
|
|
20
|
+
| OCP-E105 | `oci nosql table create` flags: --compartment-id, --name, --ddl-statement, --table-limits (file://), --is-auto-reclaimable, --freeform-tags, --wait-for-state SUCCEEDED, --max-wait-seconds (references/provisioning.md:24-35; assets/create-table.sh:24-26) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/table/create.html | Required/Optional Parameters: "`--ddl-statement` [text] Complete CREATE TABLE DDL statement." ; "`--is-auto-reclaimable` [boolean] True if table can be reclaimed after an idle period." ; wait-for-state accepted values "ACCEPTED, CANCELED, CANCELING, | 2026-11-09 | VERIFIED |
|
|
21
|
+
| OCP-E106 | `oci nosql index create` flags --compartment-id, --table-name-or-id, --index-name, --keys (file://), --is-if-not-exists, --wait-for-state, --max-wait-seconds (assets/create-table.sh:27-29) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/index/create.html | Optional Parameters: "`--keys` [complex type] A set of keys for a secondary index. This is a complex type whose value must be valid JSON. The value can be provided as a string on the command line or passed in as a file using the file://path/ | 2026-11-09 | VERIFIED |
|
|
22
|
+
| OCP-E107 | `oci nosql table get` / `index get` with --compartment-id, --table-name-or-id, --index-name (assets/create-table.sh:30-31; references/provisioning.md:28) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/index/get.html | Parameters: "--index-name [text]", "--table-name-or-id [text]", "--compartment-id, -c [text]" (table get page: "A table name within the compartment, or a table OCID.") | 2026-11-09 | VERIFIED |
|
|
23
|
+
| OCP-E108 | `oci iam tenancy get --tenancy-id` and `oci iam compartment get --compartment-id` exist (assets/create-table.sh:14,16) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/iam/tenancy/get.html | Usage: "oci iam tenancy get --tenancy-id $tenancy_id" ; compartment get: "oci iam compartment get --compartment-id $compartment_id" | 2026-11-09 | UNVERIFIED |
|
|
24
|
+
| OCP-E109 | `oci nosql row get` with repeated `--key 'col:value'` and `--consistency ABSOLUTE` (references/provisioning.md:29) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/row/get.html | Parameters: "An array of strings, each of the format “column-name:value”, representing the primary key of the row." ; consistency "Accepted values are: ABSOLUTE, EVENTUAL" | 2026-11-09 | VERIFIED |
|
|
25
|
+
| OCP-E110 | `oci nosql row update` has `--value`, `--option IF_ABSENT`, `--if-match` (row etag) (references/provisioning.md:31,39-41) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/row/update.html | Optional Parameters: "`--option` Specifies a condition for the put operation. Accepted values are: IF_ABSENT, IF_PRESENT" ; "`--if-match` ... set the if-match parameter to the value of the etag from a previous GET or POST response" (`--value | 2026-11-09 | VERIFIED |
|
|
26
|
+
| OCP-E111 | `oci nosql query prepare --statement ... --query data.statement` returns Base64 prepared statement (references/provisioning.md:33) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/query/prepare.html | Description: "Prepare a SQL statement for use in a query with variable substitution." (--compartment-id, --statement, --is-get-query-plan). Output field name `data.statement` is not on this page; model page says statement is "a Base6 | 2026-11-09 | VERIFIED |
|
|
27
|
+
| OCP-E112 | `oci nosql query execute --from-json` with compartmentId, statement, variables, consistency, limit, maxReadInKbs, timeoutInMs, isPrepared (references/provisioning.md:34; assets/query.json) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/query/execute.html | Optional Parameters: "`--max-read-in-kbs` A limit on the total amount of data read during this operation, in KB." ; "`--is-prepared` If true, the statement is a prepared statement." ; "`--variables` A map of prepared statement variables to v | 2026-11-09 | VERIFIED |
|
|
28
|
+
| OCP-E113 | CLI/REST query pagination uses `opc-next-page` with `--page` (references/provisioning.md:37-38) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/query/execute.html | Optional Parameters: "`--page` The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call." (page does not name the `opc-next-page` header) | 2026-11-09 | VERIFIED |
|
|
29
|
+
| OCP-E114 | REST QueryDetails fields: compartmentId, statement (Base64 if prepared), variables, consistency EVENTUAL/ABSOLUTE, isPrepared, maxReadInKBs, timeoutInMs (assets/query.json:3,8; references/sources.md:28; language-adapters.md:199-203) | https://docs.oracle.com/en-us/iaas/tools/python/latest/api/nosql/models/oci.nosql.models.QueryDetails.html | Attributes: "statement ... A NoSQL SQL query statement; or a Base64-encoded prepared statement." ; "Allowed values for this property are: “EVENTUAL”, “ABSOLUTE”" ; "is_prepared ... If true, the statement is a prepared statement." | 2026-11-09 | VERIFIED |
|
|
30
|
+
| OCP-E115 | nosql-rows: read = NOSQL_ROWS_READ; use adds NOSQL_ROWS_INSERT; manage adds NOSQL_ROWS_DELETE (references/access.md:11) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/odsql/ | Policies reference, Table nosql-rows: "USE / READ + NOSQL_ROWS_INSERT" ; "MANAGE / USE + NOSQL_ROWS_DELETE" ; "READ / NOSQL_ROWS_READ" | 2026-11-09 | VERIFIED |
|
|
31
|
+
| OCP-E116 | Resource types nosql-tables, nosql-indexes; metadata read distinct from create/update/drop/move; index read distinct from create/delete; policy `read nosql-tables`/`read nosql-rows` (references/access.md:10,12; 19-20) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/odsql/ | Table nosql-tables / nosql-indexes: "READ / INSPECT + NOSQL_TABLE_READ / GetTable" ; "MANAGE / USE + NOSQL_TABLE_CREATE" ; "MANAGE / NOSQL_TABLE_DROP" ; "MANAGE / NOSQL_TABLE_MOVE" ; "MANAGE / READ + NOSQL_INDEX_CREATE" | 2026-11-09 | VERIFIED |
|
|
32
|
+
| OCP-E117 | Work requests are a separate scope ("work requests" row) (references/access.md:13) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/odsql/ | Table nosql-tables: "READ / INSPECT + NOSQL_TABLE_READ / ListWorkRequests GetWorkRequest ListWorkRequestErrors ListWorkRequestLogs" — work-request reads are governed by the nosql-tables READ verb, not a separate resource-type. Skill row is | 2026-11-09 | VERIFIED |
|
|
33
|
+
| OCP-E118 | Default 0 = no expiration; changing table default does not rewrite existing rows; expired rows no longer available; per-row override (references/ttl.md:3-5; commands/feature-plan.md:7-8) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/mtiuc/ | Table TTL: "The default value is zero, indicating no expiration time." ; "Updating Table Time to Live (TTL) will not change the TTL value of any existing data in the table." | 2026-11-09 | VERIFIED |
|
|
34
|
+
| OCP-E119 | TTL is in hours/days; `USING TTL 30 DAYS`; boundary rounding (references/ttl.md:3; assets/orders.ddl:9; modeling.md:19) | https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/nosql-cloud/dtddt&id=NSSRE-GUID-6569EE8C-1805-4C7A-A2BF-12831DC1D5CA | CREATE TABLE Statement, ttl_definition: "ttl_definition ::= USING TTL INT_CONSTANT (HOURS / DAYS)" ; "the expiration time is the current time (in UTC) plus N hours/days, rounded up to the next full hour/day." | 2026-11-09 | VERIFIED |
|
|
35
|
+
| OCP-E120 | `PRIMARY KEY(SHARD(tenantId), orderId)` syntax; shard key is a leading portion of primary key (assets/orders.ddl:8; modeling.md:10-13,18) | https://docs.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/nosql-cloud/dtddt&id=NSSRE-GUID-6569EE8C-1805-4C7A-A2BF-12831DC1D5CA | CREATE TABLE Statement: "shard_key_definition ::= SHARD "(" id_list_with_size ")"" ; cloud concepts: "automatically sharded based on a portion of the table primary key, called the shard key" | 2026-11-09 | VERIFIED |
|
|
36
|
+
| OCP-E121 | GAT: index/TTL/storage DDL propagate globally; read/write units and capacity mode are regional; absolute expiration replicated (references/replicas.md:10-11; ttl.md:15-16) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/gasnd/index.html | Scope of DDL operations after regional table replicas are created: "global scope: Add Index, Drop Index, Change in Storage Capacity of the table, Change in table TTL" ; "local scope: Change in Read Units, Change in Write units, Change in Capacity Mode" ; "its expiration time is replicat | 2026-11-09 | VERIFIED |
|
|
37
|
+
| OCP-E122 | Schema must be frozen; replication asynchronous; later schema evolution constrained (references/replicas.md:6-7,9) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/gasnd/index.html | Why must you freeze a table's schema?: "the Oracle NoSQL Cloud Service requires a schema to be frozen for any table that is participating in regional replication." ; "In NDCS the regional table replication is performed asynchronously in the background." | 2026-11-09 | VERIFIED |
|
|
38
|
+
| OCP-E123 | Conflict semantics app-owned; no cross-region serializable transactions; lag (references/replicas.md:7-8,14) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/gasnd/index.html | Global Active Tables: "ACID transactions are local to a region." ; "cause the update with the latest timestamp to win" | 2026-11-09 | VERIFIED |
|
|
39
|
+
| OCP-E124 | Dedicated hosted environments currently document no GAT support (references/replicas.md:11-12; sources.md:10) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/mmmmq/ | Dedicated hosted environment: "Currently, a dedicated hosted environment does not support Global Active Tables." | 2026-11-09 | VERIFIED |
|
|
40
|
+
| OCP-E125 | Namespace `oci_nosql`; metrics ReadUnits, WriteUnits, ReadThrottleCount, WriteThrottleCount, StorageThrottleCount, MaxShardSizeUsagePercent, StorageGB; dimensions resourceId/tableName/replica; replica-lag metric; StorageGB is coarse (references/monitoring.md:3,8-11) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/mgygg/ | Metrics: "emits metrics using the metric namespace oci_nosql." ; "StorageGB ... As this information is generated hourly, you may see values that are out of date" ; "Replica Lag / ... / resourceId tableName replica" ; "MaxShardSiz | 2026-11-09 | VERIFIED |
|
|
41
|
+
| OCP-E126 | NDCS default encryption at rest (references/encryption.md:5; recovery-boundary) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html | Features: "Data is encrypted at rest (on disk) with Advanced Encryption Standard (AES 256)." | 2026-11-09 | VERIFIED |
|
|
42
|
+
| OCP-E127 | Default = Oracle-managed master key; CMEK only in dedicated environment configured for CMEK, via OCI Vault/KMS (references/encryption.md:3-7,9-10) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/icxer/ | Introduction to CMEK: "By default, NDCS uses an Oracle-managed master encryption key." ; "CMEKs must be enabled in a dedicated environment prior to using this functionality." ; "NDCS uses the OCI Key Management Service (KMS) to store your mas | 2026-11-09 | VERIFIED |
|
|
43
|
+
| OCP-E128 | Rotation rewraps keys, not data; disable/delete breaks availability (references/encryption.md:11-14) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/icxer/ | CMEK rotation / lifecycle: "Rotating to a new CMEK does not re-encrypt any data stored in Block Volumes or in Object Storage. It only re-encrypts the Block Volume and Object Storage keys." ; "CMEK disable ... Makes the dedicated environment unavai | 2026-11-09 | VERIFIED |
|
|
44
|
+
| OCP-E129 | Object Storage export encryption is a separate bucket-level key choice (Oracle-managed or a Vault master key), not inherited from table encryption (encryption.md) | https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/encryption.htm | Object Storage Data Encryption: "Assign an Oracle Cloud Infrastructure Vault master encryption key that you control and rotate on a schedule" | 2026-11-09 | VERIFIED |
|
|
45
|
+
| OCP-E130 | Backup/restore is customer responsibility via Migrator + Object Storage; no customer PITR documented (references/recovery-boundary.md:3-5; sources.md:9,54; commands/backup.md:2) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html | Responsibility model: "Customer is responsible for backing up tables on a schedule they choose. Oracle provides a migrator tool that can be used to take a backup and store it in Oracle Object Storage." (absence of PITR: page lists none; absen | 2026-11-09 | VERIFIED |
|
|
46
|
+
| OCP-E131 | Migrator is not snapshot isolation / does not lock (references/recovery-boundary.md:16-17; commands/backup/migrator.md:9) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/using-oracle-nosql-database-migrator.html | Limitation: "Oracle NoSQL Database Migrator does not lock the database during backup and block other users." (recommends no DML/DDL on source during migration) | 2026-11-09 | VERIFIED |
|
|
47
|
+
| OCP-E132 | Migrator source/sink types `nosqldb_cloud`, `object_storage_oci` with format `json`; `runMigrator --config file` (assets/migrator-export.json, migrator-import.json; backup/migrator.md:5-8) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/using-oracle-nosql-database-migrator.html | Supported Sources and Sinks; Run the runMigrator command: "OCI Object Storage (`object_storage_oci`) / JSON (`json`) / Y / Y" ; "Oracle NoSQL Database Cloud Service (`nosqldb_cloud`) / NA / Y / Y" ; "`./runMigrator --config <complete/path/to/the/JSON/config/file>`" | 2026-11-09 | VERIFIED |
|
|
48
|
+
| OCP-E133 | `useInstancePrincipal` only valid on an OCI compute instance; compartment must be OCID with it (assets/migrator-export.json:7; migrator-import.json:16; backup/migrator.md:6-7) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/using-oracle-nosql-database-migrator.html | Instance principal: "It is only supported when the NoSQL Database Migrator tool is used within an OCI compute instance" ; reference: "If the useInstancePrincipal parameter is set to true, the compartment must specify the compartment OCID an | 2026-11-09 | VERIFIED |
|
|
49
|
+
| OCP-E134 | NDCS source params readUnitsPercent, includeTTL, requestTimeoutMs; top-level abortOnError (assets/migrator-export.json:8-10) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/oracle-nosql-database-migrator-reference.html | NoSQL cloud source template: "readUnitsPercent: Percentage of table read units to be used while migrating the NoSQL table. The default value is 90." ; "`abortOnError` ... The default value is true" | 2026-11-09 | UNVERIFIED |
|
|
50
|
+
| OCP-E135 | NDCS sink: schemaInfo{readUnits,writeUnits,storageSize,schemaPath}, writeUnitsPercent, overwrite (false), includeTTL; one DDL statement per line (assets/migrator-import.json:18-26; restore/migrator.md:4-8) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/oracle-nosql-database-migrator-reference.html | NDCS sink template: "The NoSQL Database Migrator does not support more than one DDL statement per line in the `schemaPath` file." ; "If the value is set to false, ... skips those records for which the same primary key already exists in the | 2026-11-09 | VERIFIED |
|
|
51
|
+
| OCP-E136 | "Use a unique empty prefix; do not reuse an old prefix" (sink behaviour) (assets/migrator-export.json:18; backup/migrator.md:11) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/oracle-nosql-database-migrator-reference.html | prefix: "If any object with the same name already exists in the bucket, it is overwritten." | 2026-11-09 | VERIFIED |
|
|
52
|
+
| OCP-E137 | Migrator includeTTL/ttlRelativeDate; skips rows already expired; imported TTL rounded to hour/day (references/ttl.md:11-14; commands/restore) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/oracle-nosql-database-migrator-reference.html | includeTTL / ttlRelativeDate: "If the row has already expired relative to the Reference Time, then it is skipped." ; "the TTL of the imported row might get adjusted to the nearest hour or day." | 2026-11-09 | VERIFIED |
|
|
53
|
+
| OCP-E138 | Types: INTEGER, LONG, FLOAT, DOUBLE, NUMBER (arbitrary precision decimal), STRING, BOOLEAN, BINARY, FIXED_BINARY, TIMESTAMP, ENUM, ARRAY, MAP, RECORD, JSON (references/types-and-vectors.md:3-5) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/rnpxl/ | Data types: "NUMBER / An arbitrary-precision signed decimal number." ; "JSON / Any valid JSON data." | 2026-11-09 | VERIFIED |
|
|
54
|
+
| OCP-E139 | INTEGER is signed 32-bit, LONG signed 64-bit (references/types-and-vectors.md:3-4) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/rnpxl/ | Data types: Page gives only encodings: "INTEGER / ... variable-length encoding that uses 1-4 bytes" / "LONG / ... 1-8 bytes"; "signed 32-bit/64-bit" not stated | 2026-11-09 | UNVERIFIED |
|
|
55
|
+
| OCP-E140 | Row size limit 512 KB (references/types-and-vectors.md:20-21) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html | Service limits: "Maximum row size / Row / Maximum row size. / 512 KB" | 2026-11-09 | VERIFIED |
|
|
56
|
+
| OCP-E141 | No native vector type / ANN / HNSW / IVF in NDCS (references/types-and-vectors.md:15; embedding-integrations.md:5-8; sources.md:54; commands/select.md:7) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/mmmmq/ | Features: Feature list I fetched contains no vector/ANN feature; absence claim cannot be proven by a feature page | 2026-11-09 | UNVERIFIED |
|
|
57
|
+
| OCP-E142 | JSON index declarations reject rows of incompatible type; ARRAY/MAP multikey; `WITH NO NULLS` restricts usable predicates (references/indexes.md:6-9) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/uapto/ | Create index: "The creation of a JSON index will fail if the associated table contains any rows with data that violate the declared data type." ; "IS NULL, and NOT EXISTS predicates cannot be used as index predicates for that index." | 2026-11-09 | VERIFIED |
|
|
58
|
+
| OCP-E143 | Indexes consume the table's storage/write budget; no separate GSI capacity (references/indexes.md:12-14) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/uapto/ | n/a: No sentence found on the pages fetched stating index capacity accounting | 2026-11-09 | UNVERIFIED |
|
|
59
|
+
| OCP-E144 | Index creation is asynchronous (work request) (references/indexes.md:14-15) | https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql/index/create.html | --wait-for-state: "This operation asynchronously creates, modifies or deletes a resource and uses a work request to track the progress of the operation." | 2026-11-09 | VERIFIED |
|
|
60
|
+
| OCP-E145 | Parent/child tables share top parent's limits and shard key (references/modeling.md:14-16; replicas) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. | https://docs.oracle.com/en-us/iaas/tools/terraform-provider-oci/latest/docs/r/nosql_table.html | table_limits: "must be null for child table as child table shares its top parent table’s limits." (shard key: Node writeMany doc "single ancestor table specifying the shard key") | 2026-11-09 | UNVERIFIED |
|
|
61
|
+
| OCP-E146 | ABSOLUTE returns most recent value; costs more read units than EVENTUAL (references/runtime-contract.md:5; modeling) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/cloud-concepts.html | Read Consistency: "ABSOLUTE consistency results in a higher cost, consuming twice the number of read units for the same data relative to EVENTUAL consistency" | 2026-11-09 | VERIFIED |
|
|
62
|
+
| OCP-E147 | put upserts; version/ifAbsent conditions; Node `writeMany` / Java WriteMultiple same-shard atomic; abortOnFail (references/runtime-contract.md:6-7; language-adapters.md:104,74-76) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/pdhxw/index.html | Using APIs to add table data: "perform a sequence of put operations ... that share the same shard key portion of their primary keys as a single atomic write operation using the writeMany method." (Node SDK: "all the specified operations are executed | 2026-11-09 | VERIFIED |
|
|
63
|
+
| OCP-E148 | `putIfVersion(table,row,version,opts)`; condition failure is a successful call, check `success` (language-adapters.md:104-105; runtime-contract.md:6) | https://oracle.github.io/nosql-node-sdk/classes/NoSQLClient.html | putIfVersion / put: "putIfVersion (tableName: string, row: TRow, matchVersion: RowVersion, opt?: PutIfOpt)" ; "failure cases ... are still considered successful as API calls, i.e. they result in PutResult and not NoSQLError." | 2026-11-09 | VERIFIED |
|
|
64
|
+
| OCP-E149 | Node package `oracle-nosqldb` exports Consistency / NoSQLClient (language-adapters.md:66,89; sources.md) Note: the orchestrator's 2026-11-09 mechanical re-check could not confirm this quote on the fetched page (dynamic content, code block or bot protection); treat as unconfirmed. | https://github.com/oracle/nosql-node-sdk | README: "npm install oracle-nosqldb --save" ; "require('oracle-nosqldb').NoSQLClient" | 2026-11-09 | UNVERIFIED |
|
|
65
|
+
| OCP-E150 | Node `client.prepare(sql,{compartment})`; `query` with `queryOptions.compartment/consistency/continuationKey/maxReadKB`; result `rows` + `continuationKey`; empty rows with non-null key valid; loop until key null (language-adapters.md:92,96; assets/query-pages.mjs:3-19; runtime-contract.md:9) | https://oracle.github.io/nosql-node-sdk/interfaces/QueryOpt.html | continuationKey: "it is possible that continuation key is not null, but the query has no more results remaining. In this case the next call to query will result in rows being empty array and next continuation key being null." ; QueryResu | 2026-11-09 | VERIFIED |
|
|
66
|
+
| OCP-E151 | Java `QueryRequest`: setPreparedStatement, setCompartment, setConsistency, setMaxReadKB, isDone, close; result getResults (language-adapters.md:113-125,135-144) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/csnjv/oracle/nosql/driver/ops/QueryRequest.html | Method details: "setCompartment(String compartment)" ; "setMaxReadKB(int maxReadKB)" ; "setPreparedStatement(PreparedStatement preparedStatement)" ; "isDone() Returns true if the query execution is finished" ; close(): "Terminates the q | 2026-11-09 | VERIFIED |
|
|
67
|
+
| OCP-E152 | Rust: QueryRequest exposes execute_batch, which Oracle recommends replacing with execute() and says may be deprecated (language-adapters.md:153-166,170-171) | https://github.com/oracle/nosql-rust-sdk/blob/main/src/query_request.rs | execute_batch doc comment: "This method may be deprecated in future releases" | 2026-11-09 | VERIFIED |
|
|
68
|
+
| OCP-E153 | Rust: execute() runs the query to completion, looping execute_batch() until all results are returned; prepare_only() prepares without returning rows (language-adapters.md:151) | https://github.com/oracle/nosql-rust-sdk/blob/main/src/query_request.rs | execute and prepare_only doc comments: "until all results are returned and all post-processing" / "will result in only the query being prepared, and no result rows being returned" | 2026-11-09 | VERIFIED |
|
|
69
|
+
| OCP-E154 | Official SDK catalog: Java, Python, Go, Node.js, .NET, Rust, Spring; no PHP (language-adapters.md:64-72; sources.md:11) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html | SDKs: Table rows "Oracle NoSQL Java / Python / Go / Node.js / .NET / Rust / Spring SDK"; no PHP row | 2026-11-09 | VERIFIED |
|
|
70
|
+
| OCP-E155 | REST has fewer SQL features than native SDKs (language-adapters.md:79-80,199-203; sources.md:11) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html | n/a: No sentence found on the page fetched | 2026-11-09 | UNVERIFIED |
|
|
71
|
+
| OCP-E156 | OCI Generative AI has an `EmbedText` operation; model's returned embedding length fixes dimensions (embedding-integrations.md:17-19) | https://docs.oracle.com/en-us/iaas/tools/python/latest/api/generative_ai_inference/client/oci.generative_ai_inference.GenerativeAiInferenceClient.html | embed_text: "The Generative AI embedding model transforms each phrase, sentence, or paragraph that you input, into an array with 1024 numbers." ; class description links "create text embeddings" to `EmbedTextResult/EmbedText` | 2026-11-09 | VERIFIED |
|
|
72
|
+
| OCP-E157 | Table name regex caps at 64 chars (references/limits-in-assets: assets/orders.tf:14, create-table.sh:10) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html | Service limits: Page states index/column names "maximum of 64 characters"; no table-name limit sentence fetched (skill itself labels it "example caps") | 2026-11-09 | UNVERIFIED |
|
|
73
|
+
| OCP-E158 | Example capacity 50 RU/50 WU/1 GB is within provisioned limits (assets/table-limits.json; provisioning.md:4) | https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html | Service limits: "40,000 read units and 20,000 write units per table." (non-hosted max provisioned) | 2026-11-09 | VERIFIED |
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
# Native secondary indexes, not LSI/GSI
|
|
2
|
+
|
|
3
|
+
Choose ordered composite keys for equality prefixes then needed range/order fields;
|
|
4
|
+
inspect the actual prepared/query plan and consumed capacity. The example uses
|
|
5
|
+
`CREATE INDEX tenant_status_created ON orders_v1(tenantId,status,createdAt)`.
|
|
6
|
+
Field indexes may cover fixed scalar fields or typed JSON paths. Schema-less JSON
|
|
7
|
+
index declarations can reject rows of incompatible type: profile sanitized shapes
|
|
8
|
+
before backfill and test future writes. ARRAY/MAP multikey indexing is distinct
|
|
9
|
+
from indexing an embedding's coordinates; it does not provide ANN search. Sparse
|
|
10
|
+
`WITH NO NULLS` changes which predicates can use the index; prove missing/null cases.
|
|
11
|
+
|
|
12
|
+
Indexes consume the table's storage/write budget; there is no independent GSI
|
|
13
|
+
provisioned capacity, GSI-only consistency rule or arbitrary global uniqueness.
|
|
14
|
+
Adding an index is asynchronous; read work-request error and final index state,
|
|
15
|
+
then validate representative query correctness/latency. A failure is not permission
|
|
16
|
+
to drop/recreate a table. Plan migration and rate-limited backfill explicitly.
|
|
17
|
+
|
|
18
|
+
[Create-index semantics](https://docs.oracle.com/en/cloud/paas/nosql-cloud/uapto/),
|
|
19
|
+
[Terraform index](https://docs.oracle.com/en-us/iaas/tools/terraform-provider-oci/latest/docs/r/nosql_index.html), checked 2026-11-08.
|
|
@@ -0,0 +1,160 @@
|
|
|
1
|
+
# Portable application contract and language adapters
|
|
2
|
+
|
|
3
|
+
Load only the requested language section. All SDK excerpts below are illustrative,
|
|
4
|
+
uncompiled and unexecuted. No dependency installation is implied. The pure injected
|
|
5
|
+
[JS helper](../assets/query-pages.mjs) alone has executable fake tests.
|
|
6
|
+
|
|
7
|
+
| Language | Verified first-party path / boundary |
|
|
8
|
+
|---|---|
|
|
9
|
+
| JavaScript/TypeScript | Oracle `oracle-nosqldb` native NoSQL Node SDK, not the generic OCI SDK |
|
|
10
|
+
| Java | `oracle.nosql.driver` native SDK; manage a long-lived configured handle |
|
|
11
|
+
| Rust | Oracle `oracle-nosql-rust-sdk`; async API exists; do not label unsupported |
|
|
12
|
+
| Kotlin | Java SDK interop, not a separately claimed Oracle Kotlin NoSQL SDK |
|
|
13
|
+
| PHP | No native PHP NoSQL SDK established by reviewed Oracle SDK catalog; use a reviewed service bridge or OCI-signed REST adapter, not Oracle SQL/OCI8 |
|
|
14
|
+
| Python/Go/.NET | Native NoSQL SDKs listed in official catalog; preserve their own cursor/type/async APIs |
|
|
15
|
+
| Other | Verify current official SDK or implement approved signed REST contract; no invented package |
|
|
16
|
+
|
|
17
|
+
Common port: `get(fullKey, consistency) -> row, opaqueVersion, expiration`; insert-only/
|
|
18
|
+
match-version write -> explicit success/conflict; query prepared+bound variables ->
|
|
19
|
+
rows, opaque continuation, consumed units; same-shard batch with abort semantics.
|
|
20
|
+
Adapters must enforce tenant/table/region, lossless numbers/binary/timestamps, total
|
|
21
|
+
request/retry/time budgets and no data logging. Map SDK-native versions/tokens;
|
|
22
|
+
REST `opc-next-page` is not interchangeable with SDK continuation state. Generic
|
|
23
|
+
OCI REST has fewer SQL features than native NoSQL SDKs; verify query support.
|
|
24
|
+
|
|
25
|
+
## JS / TypeScript
|
|
26
|
+
|
|
27
|
+
Existing configured client and authenticated tenant/approved compartment; identifiers
|
|
28
|
+
are fixed and values are bound. Do not share mutable prepared bindings across
|
|
29
|
+
concurrent tenants. Choose explicit consistency and read/page caps.
|
|
30
|
+
|
|
31
|
+
```javascript
|
|
32
|
+
import { Consistency } from 'oracle-nosqldb';
|
|
33
|
+
import { queryPages } from './query-pages.mjs';
|
|
34
|
+
const sql = 'DECLARE $tenant STRING; SELECT o.tenantId,o.orderId FROM orders_v1 o WHERE o.tenantId=$tenant';
|
|
35
|
+
const prepared = await client.prepare(sql, {compartment: compartmentId});
|
|
36
|
+
prepared.set('$tenant', authenticatedTenant);
|
|
37
|
+
for await (const page of queryPages(client.query.bind(client), prepared, {
|
|
38
|
+
maxPages: 20, maxReadKB: 16,
|
|
39
|
+
queryOptions: {compartment: compartmentId, consistency: Consistency.ABSOLUTE}
|
|
40
|
+
})) {
|
|
41
|
+
consumeAuthorizedRows(page.rows); // no console logging of customer rows
|
|
42
|
+
}
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
TypeScript: type the returned projection and check boundary data at runtime; a
|
|
46
|
+
`query<OrderProjection>` type parameter cannot authorize tenants or validate schema.
|
|
47
|
+
Versioned update: get with full key, then `client.putIfVersion(table,row,result.version,opts)`;
|
|
48
|
+
check `success`; never treat condition failure as automatically retryable.
|
|
49
|
+
|
|
50
|
+
## Java
|
|
51
|
+
|
|
52
|
+
Prepared/bound statement below is supplied by the trusted repository layer; never
|
|
53
|
+
accept arbitrary SQL or a client-provided tenant variable. Own request per iterator.
|
|
54
|
+
|
|
55
|
+
```java
|
|
56
|
+
QueryRequest request = new QueryRequest()
|
|
57
|
+
.setPreparedStatement(boundStatement)
|
|
58
|
+
.setCompartment(compartmentId)
|
|
59
|
+
.setConsistency(Consistency.ABSOLUTE)
|
|
60
|
+
.setMaxReadKB(16);
|
|
61
|
+
try {
|
|
62
|
+
int pages = 0;
|
|
63
|
+
do {
|
|
64
|
+
if (++pages > 20) throw new IllegalStateException("incomplete page budget");
|
|
65
|
+
QueryResult page = handle.query(request);
|
|
66
|
+
consumeAuthorizedRows(page.getResults());
|
|
67
|
+
} while (!request.isDone());
|
|
68
|
+
} finally { request.close(); }
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
## Kotlin via Java SDK
|
|
72
|
+
|
|
73
|
+
`boundStatement` and `compartmentId` have the same trusted provenance as Java;
|
|
74
|
+
Java request setters return the request. Coordinate blocking calls with the
|
|
75
|
+
application's dispatcher/timeouts, not an accidental unbounded request coroutine.
|
|
76
|
+
|
|
77
|
+
```kotlin
|
|
78
|
+
val request = QueryRequest().setPreparedStatement(boundStatement)
|
|
79
|
+
.setCompartment(compartmentId).setConsistency(Consistency.ABSOLUTE)
|
|
80
|
+
.setMaxReadKB(16)
|
|
81
|
+
try {
|
|
82
|
+
var pages = 0
|
|
83
|
+
do {
|
|
84
|
+
check(++pages <= 20) { "incomplete page budget" }
|
|
85
|
+
consumeAuthorizedRows(handle.query(request).results)
|
|
86
|
+
} while (!request.isDone)
|
|
87
|
+
} finally { request.close() }
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Rust native SDK
|
|
91
|
+
|
|
92
|
+
PreparedStatement comes from `prepare_only` against a trusted fixed statement;
|
|
93
|
+
set the authenticated tenant variable on this request, not shared mutable state.
|
|
94
|
+
`execute` collects all results; use reviewed bounded batching for large queries.
|
|
95
|
+
|
|
96
|
+
```rust
|
|
97
|
+
use oracle_nosql_rust_sdk::{QueryRequest, Consistency};
|
|
98
|
+
let mut request = QueryRequest::new_prepared(&prepared)
|
|
99
|
+
.compartment_id(&compartment_id)
|
|
100
|
+
.consistency(&Consistency::Absolute)
|
|
101
|
+
.max_read_kb(16);
|
|
102
|
+
request.set_variable("$tenant", &authenticated_tenant)?;
|
|
103
|
+
let mut pages = 0;
|
|
104
|
+
while !request.is_done() {
|
|
105
|
+
pages += 1;
|
|
106
|
+
if pages > 20 { return Err("incomplete page budget".into()); }
|
|
107
|
+
let mut rows = Vec::new();
|
|
108
|
+
request.execute_batch(&handle, &mut rows).await?;
|
|
109
|
+
consume_authorized_rows(rows)?;
|
|
110
|
+
}
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
Rust SDK 0.1.4 documentation exposes `execute_batch`; its docs say batching may be
|
|
114
|
+
deprecated, so re-check pinned release. This is not all-version compilation proof.
|
|
115
|
+
|
|
116
|
+
## PHP / signed REST bridge
|
|
117
|
+
|
|
118
|
+
The following is an application interface, NOT a fictional Oracle SDK class.
|
|
119
|
+
A separately reviewed implementation uses OCI request signing/native service bridge
|
|
120
|
+
with pre-authorized prepared statement and query parameters. Never hand-copy keys
|
|
121
|
+
into source. Request signer/credential/network tests remain required.
|
|
122
|
+
|
|
123
|
+
```php
|
|
124
|
+
interface NoSqlQueryPort {
|
|
125
|
+
// Contract: rows + nullable opaque next; no credentials/tenant from public input.
|
|
126
|
+
public function page(array $approvedRequest): array;
|
|
127
|
+
}
|
|
128
|
+
function collect(NoSqlQueryPort $port, array $request, int $maxPages = 20): array {
|
|
129
|
+
if ($maxPages < 1) throw new InvalidArgumentException('positive budget');
|
|
130
|
+
$out = [];
|
|
131
|
+
for ($i = 0; $i < $maxPages; $i++) {
|
|
132
|
+
$page = $port->page($request);
|
|
133
|
+
foreach ($page['rows'] as $row) $out[] = $row;
|
|
134
|
+
$next = $page['next'] ?? null;
|
|
135
|
+
if ($next === null) return $out;
|
|
136
|
+
$request['page'] = $next;
|
|
137
|
+
}
|
|
138
|
+
throw new RuntimeException('incomplete page budget');
|
|
139
|
+
}
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
Signed REST uses NoSQL service `Query`/`PrepareStatement`, reviewed endpoint/API
|
|
143
|
+
version, compartment context, prepared Base64 statement, `isPrepared`, bound
|
|
144
|
+
`variables`, consistency and max read KB. Preserve request ID/errors and response
|
|
145
|
+
`opc-next-page`; enforce timeout/retry limits and tenant cursor binding outside the
|
|
146
|
+
port. Do not confuse this JSON REST path with the native SDK binary protocol.
|
|
147
|
+
|
|
148
|
+
## Python / Go / .NET / other
|
|
149
|
+
|
|
150
|
+
Use the existing official NoSQL SDK, not a default generic ORM. Python preserves
|
|
151
|
+
QueryRequest continuation until done; Go follows its documented Query loop; .NET
|
|
152
|
+
QueryAsyncEnumerable manages continuation. In each case test an empty intermediate
|
|
153
|
+
page, bounded completion, partial-result failure, version conflict, cancellation,
|
|
154
|
+
number/TTL round trips and same-shard rejection before claiming compatibility.
|
|
155
|
+
|
|
156
|
+
[Oracle SDK catalog](https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/plan-your-service.html),
|
|
157
|
+
[Node SDK](https://oracle.github.io/nosql-node-sdk/),
|
|
158
|
+
[Java QueryRequest](https://docs.oracle.com/en/cloud/paas/nosql-cloud/csnjv/oracle/nosql/driver/ops/QueryRequest.html),
|
|
159
|
+
[Rust QueryRequest](https://docs.rs/oracle-nosql-rust-sdk/latest/oracle_nosql_rust_sdk/struct.QueryRequest.html),
|
|
160
|
+
[REST query model](https://docs.oracle.com/en-us/iaas/tools/python/latest/api/nosql/models/oci.nosql.models.QueryDetails.html), checked 2026-11-08.
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# June / December content review
|
|
2
|
+
|
|
3
|
+
Next review starts **2026-12-01**. Run the read-only helper with the actual
|
|
4
|
+
client-local date: `python3 scripts/review_due.py --as-of YYYY-MM-DD`.
|
|
5
|
+
It never advances [ledger](../assets/content-review.json), writes files, creates
|
|
6
|
+
cron/calendar/memory tasks or sends notifications. Missed windows stay overdue,
|
|
7
|
+
even across years. A targeted source change is not a complete audit.
|
|
8
|
+
|
|
9
|
+
Full review: verify current NDCS(Cloud, not SQL/on-prem) sources; keys/transactions/
|
|
10
|
+
consistency/TTL; native vector boundary and model/store constraints; IAM/CMEK/hosted
|
|
11
|
+
eligibility; CLI/provider schema; actual customer recovery capabilities/limits;
|
|
12
|
+
SDK languages/signatures; metrics and runtime guards; routes/links/evals and human
|
|
13
|
+
trigger tables. Record lookup failures/uncertainties explicitly. Only after a
|
|
14
|
+
completed documented full review may an explicitly authorized maintainer update
|
|
15
|
+
last_full_review and choose the next June/December 1 ledger date. No automatic roll.
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Model access before choosing layout
|
|
2
|
+
|
|
3
|
+
| Access | Model/query | Tradeoff |
|
|
4
|
+
|---|---|---|
|
|
5
|
+
| One order | full `(tenantId,orderId)` key get | bounded read, tenant from authenticated context |
|
|
6
|
+
| Tenant orders | shard predicate `tenantId = $tenant`; key range if needed | one tenant may become a hot shard |
|
|
7
|
+
| Tenant open orders by time | index `(tenantId,status,createdAt)` and equality leading fields | write/storage amplification; verify chosen query plan |
|
|
8
|
+
| Global analytics | explicit bounded scatter query/export to analytics | not an invisible request-path scan fallback |
|
|
9
|
+
|
|
10
|
+
Shard key is a leading subset of primary-key fields, not a DynamoDB partition-key/
|
|
11
|
+
sort-key pair. Same shard values co-locate records; high-cardinality tenant IDs
|
|
12
|
+
usually distribute, but a dominant tenant needs deliberate bucketing. A bucket in
|
|
13
|
+
the shard key changes query fan-out and atomicity, so quantify both. A secondary
|
|
14
|
+
index does not give separate capacity or a new transaction boundary. Parent/child
|
|
15
|
+
tables share shard keys and parent capacity; hierarchy is an explicit alternative,
|
|
16
|
+
not a requirement to put every entity in one JSON table.
|
|
17
|
+
|
|
18
|
+
Example [DDL](../assets/orders.ddl): fixed identity/status/time/decimal fields,
|
|
19
|
+
flexible `document JSON`, primary `SHARD(tenantId),orderId`, 30-day default TTL.
|
|
20
|
+
This is ephemeral demonstration data; durable financial orders may require no TTL.
|
|
21
|
+
NoSQL schema normalization and SQL dialect are not Oracle Database relational SQL.
|
|
22
|
+
Tenant predicates are application controls, not IAM-enforced per-row isolation;
|
|
23
|
+
separate tables/compartments/principals if the threat model requires that boundary.
|
|
24
|
+
|
|
25
|
+
[Cloud concepts](https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/cloud-concepts.html)
|
|
26
|
+
and [modeling](https://docs.oracle.com/en/database/other-databases/nosql-database/23.1/nsdev/table-modelling-and-design1.html), checked 2026-11-08.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Selected-feature metrics
|
|
2
|
+
|
|
3
|
+
Namespace `oci_nosql`; scope to approved `resourceId`(table OCID), `tableName`,
|
|
4
|
+
and replica dimension where applicable. Do not copy CloudWatch dimensions.
|
|
5
|
+
|
|
6
|
+
| Selected focus | Metrics / evidence | Interpretation |
|
|
7
|
+
|---|---|---|
|
|
8
|
+
| Core/index capacity | ReadUnits,WriteUnits; SDK consumed capacity, client p95/p99 | query/index/consistency/row size and retry amplification |
|
|
9
|
+
| Throttle/hot shard | ReadThrottleCount,WriteThrottleCount,StorageThrottleCount,MaxShardSizeUsagePercent | correlate with target limits and skew; total table average can hide a hot shard |
|
|
10
|
+
| Storage/TTL | StorageGB plus application expiry validation | asynchronous/coarse storage metric is not proof every row expired |
|
|
11
|
+
| replicas | replica lag metric/dimension as published for deployed region | lag/readiness is not backup RPO |
|
|
12
|
+
| recovery | application export manifest age/failures/restore drill duration | custom evidence; do not invent native Backup/PITR metrics |
|
|
13
|
+
| embeddings | app model generation failures, source freshness, deletion lag, recall | not NDCS-native vector metrics |
|
|
14
|
+
|
|
15
|
+
Example MQL intent: `ReadThrottleCount[1m]{resourceId="APPROVED_TABLE_OCID"}.sum()>0`.
|
|
16
|
+
Check actual dimension casing in discovered metric definitions before applying an
|
|
17
|
+
alarm. Use explicit windows/statistics/missing-data behavior and separately verified
|
|
18
|
+
Notifications delivery. Storage metrics may lag; metric silence is not health.
|
|
19
|
+
No alarm/notification is created by this skill.
|
|
20
|
+
|
|
21
|
+
[Published metrics](https://docs.oracle.com/en/cloud/paas/nosql-cloud/mgygg/), checked 2026-11-08.
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
# Illustrative provisioning and core OCI CLI
|
|
2
|
+
|
|
3
|
+
Choose Terraform OR CLI for a NEW table; neither auto-imports/adopts an existing
|
|
4
|
+
table. Default path: Oracle-managed encryption, provisioned 50 RU/50 WU/1 GB,
|
|
5
|
+
no auto-reclaim, 30-day TTL, composite tenant/status/time index. Read the actual
|
|
6
|
+
[DDL](../assets/orders.ddl), [Terraform](../assets/orders.tf), [limits](../assets/table-limits.json)
|
|
7
|
+
and [index keys](../assets/index-keys.json) only when requested. `tenantId` shard
|
|
8
|
+
locality is not row-level IAM. Capacity is illustrative, not production sizing.
|
|
9
|
+
|
|
10
|
+
Terraform: place the DDL beside the module, supply approved region/compartment/new
|
|
11
|
+
name through normal variable inputs, pin an approved OCI provider and retain its
|
|
12
|
+
lockfile. Credentials/principal setup is deliberately external. Obtain an exact
|
|
13
|
+
non-destructive plan before apply; `prevent_destroy` is not a backup or import
|
|
14
|
+
permission. Do not run init/download/deployment as part of loading this skill.
|
|
15
|
+
No per-table CMEK option is supplied. Terraform CLI validation was unavailable in
|
|
16
|
+
the authoring sandbox; see sources. Local fixture tests are not provider validation.
|
|
17
|
+
|
|
18
|
+
The guarded [create-table.sh](../assets/create-table.sh) checks reachable tenancy/
|
|
19
|
+
compartment IDs and explicit typed confirmation, then creates table/index and reads
|
|
20
|
+
metadata back. It declares, but does not attest, the active principal. Independently
|
|
21
|
+
verify principal and compartment ancestry before execution. On errors/timeouts stop
|
|
22
|
+
and inspect exact work requests; never adopt/delete/retry uncertain writes blindly.
|
|
23
|
+
|
|
24
|
+
Core cookbook below is illustrative, not run. Export existing approved `OCI_PROFILE`,
|
|
25
|
+
`OCI_REGION`, `COMPARTMENT_OCID`, `TABLE_NAME` first. Quote every variable.
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
oci --profile "$OCI_PROFILE" --region "$OCI_REGION" nosql table get --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME"
|
|
29
|
+
oci --profile "$OCI_PROFILE" --region "$OCI_REGION" nosql row get --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME" --key 'tenantId:tenant-demo' --key 'orderId:order-demo' --consistency ABSOLUTE
|
|
30
|
+
# Mutation: separate approval; absent condition, not an unconditional upsert.
|
|
31
|
+
oci --profile "$OCI_PROFILE" --region "$OCI_REGION" nosql row update --compartment-id "$COMPARTMENT_OCID" --table-name-or-id "$TABLE_NAME" --value file://assets/row.json --option IF_ABSENT
|
|
32
|
+
# Prepare the reviewed SELECT; replace compartment + Base64 statement in query.json.
|
|
33
|
+
oci --profile "$OCI_PROFILE" --region "$OCI_REGION" nosql query prepare --compartment-id "$COMPARTMENT_OCID" --statement "$(cat assets/query.sql)" --query data.statement --raw-output
|
|
34
|
+
oci --profile "$OCI_PROFILE" --region "$OCI_REGION" nosql query execute --from-json file://assets/query.json
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
REST/CLI query pagination uses returned `opc-next-page` with `--page`, NOT SDK
|
|
38
|
+
`continuationKey`; an empty result with continuation still needs another request.
|
|
39
|
+
Neither pagination path proves snapshot consistency. For conditional updates/deletes
|
|
40
|
+
retain the actual service row version/ETag and correct `--if-match` contract; don't
|
|
41
|
+
substitute a timestamp or table ETag. [Portable runtime contract](runtime-contract.md).
|
|
42
|
+
|
|
43
|
+
[OCI CLI NoSQL](https://docs.oracle.com/en-us/iaas/tools/oci-cli/latest/oci_cli_docs/cmdref/nosql.html),
|
|
44
|
+
[table provider](https://docs.oracle.com/en-us/iaas/tools/terraform-provider-oci/latest/docs/r/nosql_table.html), checked 2026-11-08.
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# Recovery boundary and evidence
|
|
2
|
+
|
|
3
|
+
Oracle's responsibility model assigns table backup/restore to the customer using
|
|
4
|
+
Migrator/Object Storage. Reviewed NDCS APIs do not establish a customer-native PITR
|
|
5
|
+
or named snapshot workflow; do not invent one from Oracle Database/on-prem docs.
|
|
6
|
+
Provider-managed durability or internal CMEK backups do not establish user-selected
|
|
7
|
+
recovery points. This package supports planned Migrator or app-owned SDK exports.
|
|
8
|
+
|
|
9
|
+
For either method record exact source identity/schema, export start/end, quiescence,
|
|
10
|
+
TTL policy, row counts/failures/skips, object versions/checksums, tool version, keys,
|
|
11
|
+
retention and an approved NEW destination. The [example manifest](../assets/recovery-manifest.example.json)
|
|
12
|
+
is intentionally incomplete and rejected until populated with real evidence.
|
|
13
|
+
`check_recovery.py` checks sanitized caller-supplied consistency only; it never calls
|
|
14
|
+
OCI or verifies actual target absence/object bytes. New name alone is not absence.
|
|
15
|
+
|
|
16
|
+
No cross-row snapshot is promised while writes run. Keep DML/DDL quiesced; otherwise
|
|
17
|
+
label a fuzzy interval and cannot promise exact-point recovery. Timestamp-filtered
|
|
18
|
+
exports miss deletes and may race updates; incremental/delta recovery requires an
|
|
19
|
+
independent ordered change/tombstone ledger, reconciliation and tested replay, not
|
|
20
|
+
a modification-time query alone. Multiple-table exports need coordinated quiescence.
|
|
21
|
+
|
|
22
|
+
RPO is the age/coverage of the last verified consistent export at incident time,
|
|
23
|
+
not a fixed advertised number. RTO includes access/key recovery, data transfer,
|
|
24
|
+
new-table/index readiness, metadata reconstruction, application validation and
|
|
25
|
+
approved cutover. Measure both in drills. The usable recovery window is bounded
|
|
26
|
+
by actually retained readable object versions, TTL/deletion policy, keys, schema
|
|
27
|
+
compatibility and capacity; expiration can make an older export unusable. Recreate
|
|
28
|
+
IAM/tags/alarms/replica topology as separately reviewed settings. Never accept a
|
|
29
|
+
work-request waiter alone as restore success.
|
|
30
|
+
|
|
31
|
+
[Responsibility model](https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/features-of-oracle-nosql-database-cloud-service.html),
|
|
32
|
+
[Migrator limitations](https://docs.oracle.com/en/cloud/paas/nosql-cloud/dtddt/using-oracle-nosql-database-migrator.html), checked 2026-11-08.
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
# Global Active Tables are availability, not backup
|
|
2
|
+
|
|
3
|
+
Use the NDCS Global Active Tables workflow, not on-prem multi-region agents or
|
|
4
|
+
DynamoDB global-table flags. Verify eligible table/schema state, supported region
|
|
5
|
+
set and exact SDK/API before planning a replica. Schema freezing constrains later
|
|
6
|
+
evolution; confirm regional write conflict semantics and application conflict
|
|
7
|
+
resolution rather than promising cross-region serializable transactions.
|
|
8
|
+
|
|
9
|
+
Replica initialization is asynchronous and must finish before traffic/failover.
|
|
10
|
+
DDL scope differs: index/TTL/storage changes can propagate, while read/write units
|
|
11
|
+
and capacity mode are regional. Absolute expiration is replicated. Dedicated hosted
|
|
12
|
+
environments currently document no Global Active Tables support: re-check eligibility
|
|
13
|
+
before a combined CMEK/replica plan. Measure lag and test regional client routing,
|
|
14
|
+
identity/key/network readiness and failback. Replication can propagate accidental
|
|
15
|
+
deletes/corruption; retain independent exports and prove restoration separately.
|
|
16
|
+
|
|
17
|
+
[Global Active Tables](https://docs.oracle.com/en/cloud/paas/nosql-cloud/gasnd/index.html),
|
|
18
|
+
[hosted environment limitation](https://docs.oracle.com/en/cloud/paas/nosql-cloud/mmmmq/), checked 2026-11-08.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Runtime correctness contract
|
|
2
|
+
|
|
3
|
+
| Surface | Contract / regression |
|
|
4
|
+
|---|---|
|
|
5
|
+
| Reads | `EVENTUAL` may be stale; `ABSOLUTE` returns current designated-key value at higher RU cost. Do not infer a multi-page transaction snapshot |
|
|
6
|
+
| Writes | `put` upserts; prefer absent/present/version conditions when needed. Preserve opaque SDK row version; a false success/conflict is not a retryable timeout |
|
|
7
|
+
| Transactions | Java `WriteMultiple` / Node `writeMany` provides same-shard atomic operations; unrelated tables/shards are not cross-shard ACID. Use abort-on-fail for dependent conditions |
|
|
8
|
+
| Query | Prepared SQL with declared/bound variables, authenticated tenant predicate; allowlist table/column identifiers, never interpolate user SQL |
|
|
9
|
+
| Pagination | SDK continuation is opaque; continue empty pages with a non-null continuation. Do not replace with OFFSET or assume LIMIT is total completeness |
|
|
10
|
+
| Public cursor | Store/sign/encrypt server-side cursor envelope bound to tenant, query/parameters, region/table/schema and expiry. No raw cross-tenant cursor replay |
|
|
11
|
+
| Retry | Budget elapsed time and total attempts including SDK internal retries; jitter only transient throttling/network/service failures. Do not retry auth/schema failures or blindly repeat ambiguous non-idempotent writes |
|
|
12
|
+
| Capacity | RU/WU cost depends on row/index work; absolute reads cost more. Rate-limit callers and hot shard load; on-demand is not unlimited |
|
|
13
|
+
| Evolution | Preserve old-reader compatibility and key/type contracts; new primary/shard key requires reviewed new-table migration. Cover deletes, expiry and rollback cutoff |
|
|
14
|
+
|
|
15
|
+
[Injected pagination helper](../assets/query-pages.mjs) takes `client.query.bind(client)`
|
|
16
|
+
and a trusted prepared statement; it executes no cloud call on import. It is not
|
|
17
|
+
an authorization layer, exporter or public-cursor codec. SDK objects/version/
|
|
18
|
+
continuation types vary by language; round-trip through that SDK's documented
|
|
19
|
+
serializer, never stringify a binary token opportunistically.
|
|
20
|
+
|
|
21
|
+
[SDK query contract](https://oracle.github.io/nosql-node-sdk/interfaces/QueryResult.html),
|
|
22
|
+
[write APIs](https://docs.oracle.com/en/cloud/paas/nosql-cloud/pdhxw/index.html),
|
|
23
|
+
[consistency](https://docs.oracle.com/en/cloud/paas/nosql-cloud/csnjv/oracle/nosql/driver/Consistency.html), checked 2026-11-08.
|