@raishin/vanguard-frontier-agentic 3.18.0 → 3.20.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude-plugin/marketplace.json +2 -2
- package/.claude-plugin/plugin.json +8 -1
- package/.cursor-plugin/plugin.json +8 -1
- package/.github/plugin/marketplace.json +1 -1
- package/README.md +21 -21
- package/agents/AGENTS.md +4 -4
- package/agents/README.md +7 -7
- package/agents/alibaba/alibaba-tablestore-architect-agent/AGENT.md +54 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/codex.toml +11 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/alibaba/alibaba-tablestore-architect-agent/metadata.json +39 -0
- package/agents/aws/aws-dynamodb-patterns-agent/AGENT.md +53 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/codex.toml +23 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/copilot.agent.md +42 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/cursor.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/gemini.agent.md +38 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/aws/aws-dynamodb-patterns-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/aws/aws-dynamodb-patterns-agent/metadata.json +39 -0
- package/agents/azure/azure-cosmosdb-application-developer-agent/metadata.json +4 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/AGENT.md +53 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/cursor.agent.md +37 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/azure/azure-cosmosdb-pattern-agent/metadata.json +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/AGENT.md +54 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/codex.toml +11 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/gcp/gcp-bigtable-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/gcp/gcp-bigtable-architect-agent/metadata.json +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/AGENT.md +54 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/codex.toml +11 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/cursor.agent.md +38 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/huawei/huawei-geminidb-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/huawei/huawei-geminidb-architect-agent/metadata.json +38 -0
- package/agents/oci/oci-nosql-database-architect-agent/AGENT.md +54 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/claude-code.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/codex.toml +11 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/copilot.agent.md +43 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/cursor.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/gemini.agent.md +39 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-database-architect-agent/harnesses/kiro-ide.agent.md +37 -0
- package/agents/oci/oci-nosql-database-architect-agent/metadata.json +39 -0
- package/agents/oci/oci-nosql-pattern-agent/AGENT.md +53 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/claude-code.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/codex.toml +23 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/copilot.agent.md +42 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/cursor.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/gemini.agent.md +38 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-cli.agent.json +5 -0
- package/agents/oci/oci-nosql-pattern-agent/harnesses/kiro-ide.agent.md +36 -0
- package/agents/oci/oci-nosql-pattern-agent/metadata.json +38 -0
- package/catalog/agents.json +204 -1
- package/catalog/asset-integrity.json +620 -75
- package/catalog/install-roles.json +19 -1
- package/catalog/model-assignments.json +231 -0
- package/catalog/skill-manifest.json +2074 -527
- package/catalog/skills.json +314 -14
- package/package.json +8 -2
- package/plugins/vanguard-frontier-agentic/.codex-plugin/plugin.json +1 -1
- package/powers/vanguard-alibaba/POWER.md +1 -1
- package/powers/vanguard-aws/POWER.md +1 -1
- package/powers/vanguard-azure/POWER.md +1 -1
- package/powers/vanguard-gcp/POWER.md +1 -1
- package/powers/vanguard-huawei/POWER.md +1 -1
- package/powers/vanguard-oci/POWER.md +1 -1
- package/rules/codex/cloud-provenance-rule.md +1 -1
- package/scripts/generate-kiro-powers.mjs +2 -2
- package/skills/alibaba/README.md +2 -1
- package/skills/alibaba/alibaba-maestro/SKILL.md +2 -1
- package/skills/alibaba/alibaba-tablestore-architect/SKILL.md +69 -0
- package/skills/alibaba/alibaba-tablestore-architect/metadata.json +28 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/live.md +110 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit/offline.md +119 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/commands/audit.md +22 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/evidence-ledger.md +87 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/operations.md +190 -0
- package/skills/alibaba/alibaba-tablestore-architect/references/tablestore-design-guide.md +159 -0
- package/skills/aws/aws-documentdb-architect/SKILL.md +43 -0
- package/skills/aws/aws-documentdb-architect/metadata.json +26 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/live.md +135 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit/offline.md +127 -0
- package/skills/aws/aws-documentdb-architect/references/commands/audit.md +23 -0
- package/skills/aws/aws-documentdb-architect/references/evidence-ledger.md +52 -0
- package/skills/aws/aws-documentdb-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-documentdb-architect/references/operations.md +165 -0
- package/skills/aws/aws-documentdb-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-documentdb-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/SKILL.md +5 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/metadata.json +7 -3
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/consistency-indexing-replication.md +103 -0
- package/skills/aws/aws-dynamodb-data-modeling-performance-review/references/evidence-ledger.md +38 -0
- package/skills/aws/aws-dynamodb-patterns/CHANGELOG.md +87 -0
- package/skills/aws/aws-dynamodb-patterns/README.md +132 -0
- package/skills/aws/aws-dynamodb-patterns/SKILL.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/assets/bedrock-embedding-input.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/content-review.json +6 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table-with-lsi.json +41 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.json +27 -0
- package/skills/aws/aws-dynamodb-patterns/assets/create-table.sh +37 -0
- package/skills/aws/aws-dynamodb-patterns/assets/embedding-flow.py +89 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-input.json +13 -0
- package/skills/aws/aws-dynamodb-patterns/assets/query-pages.mjs +54 -0
- package/skills/aws/aws-dynamodb-patterns/assets/stream-read-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-index-read-policy.json +20 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table-resource-policy.json +22 -0
- package/skills/aws/aws-dynamodb-patterns/assets/table.cfn.yaml +55 -0
- package/skills/aws/aws-dynamodb-patterns/assets/typed-vector-item.json +15 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-create-table.json +23 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search-policy.json +11 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-search.json +10 -0
- package/skills/aws/aws-dynamodb-patterns/assets/vector-table.cfn.yaml +41 -0
- package/skills/aws/aws-dynamodb-patterns/evals/audit.test.py +87 -0
- package/skills/aws/aws-dynamodb-patterns/evals/backup-restore.test.py +163 -0
- package/skills/aws/aws-dynamodb-patterns/evals/commands.test.py +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/create-table.test.py +99 -0
- package/skills/aws/aws-dynamodb-patterns/evals/data-vectors-maintenance.test.py +201 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-commands.test.py +162 -0
- package/skills/aws/aws-dynamodb-patterns/evals/embedding-flow.test.py +167 -0
- package/skills/aws/aws-dynamodb-patterns/evals/eval.md +328 -0
- package/skills/aws/aws-dynamodb-patterns/evals/evals.json +185 -0
- package/skills/aws/aws-dynamodb-patterns/evals/modes.test.py +195 -0
- package/skills/aws/aws-dynamodb-patterns/evals/operations.test.py +288 -0
- package/skills/aws/aws-dynamodb-patterns/evals/query-pages.test.mjs +156 -0
- package/skills/aws/aws-dynamodb-patterns/evals/readme-and-loading.test.py +69 -0
- package/skills/aws/aws-dynamodb-patterns/evals/verify.py +166 -0
- package/skills/aws/aws-dynamodb-patterns/metadata.json +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/README.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/live.md +64 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit/offline.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/audit.md +65 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/aws-cli.md +206 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/on-demand.md +36 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup/pitr.md +41 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/backup.md +27 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/design.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/embedding.md +200 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/feature-plan.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/help.md +28 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/performance-test.md +95 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/recovery-target.md +47 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/refactor.md +82 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/on-demand.md +32 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore/pitr.md +42 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/restore.md +76 -0
- package/skills/aws/aws-dynamodb-patterns/references/commands/select.md +22 -0
- package/skills/aws/aws-dynamodb-patterns/references/data-types-and-vectors.md +175 -0
- package/skills/aws/aws-dynamodb-patterns/references/embedding-integrations.md +237 -0
- package/skills/aws/aws-dynamodb-patterns/references/encryption.md +156 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-index.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/evidence-ledger.md +373 -0
- package/skills/aws/aws-dynamodb-patterns/references/iam-and-access.md +173 -0
- package/skills/aws/aws-dynamodb-patterns/references/language-adapters.md +251 -0
- package/skills/aws/aws-dynamodb-patterns/references/lsi-vs-gsi.md +116 -0
- package/skills/aws/aws-dynamodb-patterns/references/maintenance.md +56 -0
- package/skills/aws/aws-dynamodb-patterns/references/modeling.md +131 -0
- package/skills/aws/aws-dynamodb-patterns/references/monitoring.md +137 -0
- package/skills/aws/aws-dynamodb-patterns/references/official-sources.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/operations.md +130 -0
- package/skills/aws/aws-dynamodb-patterns/references/provisioning.md +110 -0
- package/skills/aws/aws-dynamodb-patterns/references/recovery-and-replicas.md +148 -0
- package/skills/aws/aws-dynamodb-patterns/references/runtime-contract.md +140 -0
- package/skills/aws/aws-dynamodb-patterns/references/safety-checklist.md +35 -0
- package/skills/aws/aws-dynamodb-patterns/references/sources.md +170 -0
- package/skills/aws/aws-dynamodb-patterns/references/streams-and-dax.md +160 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow-and-output.md +34 -0
- package/skills/aws/aws-dynamodb-patterns/references/workflow.md +133 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/review_due.py +61 -0
- package/skills/aws/aws-dynamodb-patterns/scripts/select_mode.py +127 -0
- package/skills/aws/aws-keyspaces-architect/SKILL.md +43 -0
- package/skills/aws/aws-keyspaces-architect/metadata.json +26 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/live.md +118 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit/offline.md +125 -0
- package/skills/aws/aws-keyspaces-architect/references/commands/audit.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/evidence-ledger.md +49 -0
- package/skills/aws/aws-keyspaces-architect/references/official-sources.md +15 -0
- package/skills/aws/aws-keyspaces-architect/references/operations.md +154 -0
- package/skills/aws/aws-keyspaces-architect/references/safety-checklist.md +22 -0
- package/skills/aws/aws-keyspaces-architect/references/workflow-and-output.md +22 -0
- package/skills/aws/aws-maestro/SKILL.md +1 -1
- package/skills/aws/aws-maestro/metadata.json +1 -1
- package/skills/aws/aws-maestro/references/workflow-and-output.md +1 -0
- package/skills/azure/azure-ai-foundry-ops-governor/SKILL.md +2 -2
- package/skills/azure/azure-aks-platform-operator/SKILL.md +1 -1
- package/skills/azure/azure-app-service-production-readiness/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-application-developer/SKILL.md +5 -3
- package/skills/azure/azure-cosmosdb-application-developer/metadata.json +1 -1
- package/skills/azure/azure-cosmosdb-pattern/CHANGELOG.md +10 -0
- package/skills/azure/azure-cosmosdb-pattern/README.md +102 -0
- package/skills/azure/azure-cosmosdb-pattern/SKILL.md +69 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/account.arm.json +59 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/content-review.json +9 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/order.json +10 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/provision.sh +32 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/runtime.mjs +99 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-indexing-policy.json +7 -0
- package/skills/azure/azure-cosmosdb-pattern/assets/vector-policy.json +3 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/eval.md +32 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/fixtures/recovery-continuous.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/prompts.json +24 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/report.md +54 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/runtime.test.mjs +146 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/source-evidence.json +28 -0
- package/skills/azure/azure-cosmosdb-pattern/evals/test_package.py +355 -0
- package/skills/azure/azure-cosmosdb-pattern/metadata.json +25 -0
- package/skills/azure/azure-cosmosdb-pattern/references/access-control.md +42 -0
- package/skills/azure/azure-cosmosdb-pattern/references/change-feed-and-integrations.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/live.md +17 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit/offline.md +15 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/audit.md +8 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/azure-cli.md +39 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/continuous.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup/periodic.md +28 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/backup.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/design.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/feature-plan.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/help.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/performance-test.md +24 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/recovery-target.md +30 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/refactor.md +14 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-deleted-resource.md +55 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/continuous-new-account.md +50 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore/periodic-support.md +27 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/restore.md +13 -0
- package/skills/azure/azure-cosmosdb-pattern/references/commands/select.md +11 -0
- package/skills/azure/azure-cosmosdb-pattern/references/data-types-and-vectors.md +51 -0
- package/skills/azure/azure-cosmosdb-pattern/references/embedding-integrations.md +56 -0
- package/skills/azure/azure-cosmosdb-pattern/references/encryption.md +53 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-index.md +72 -0
- package/skills/azure/azure-cosmosdb-pattern/references/evidence-ledger.md +174 -0
- package/skills/azure/azure-cosmosdb-pattern/references/indexing-and-capacity.md +37 -0
- package/skills/azure/azure-cosmosdb-pattern/references/language-adapters.md +112 -0
- package/skills/azure/azure-cosmosdb-pattern/references/maintenance.md +19 -0
- package/skills/azure/azure-cosmosdb-pattern/references/modeling.md +44 -0
- package/skills/azure/azure-cosmosdb-pattern/references/monitoring.md +23 -0
- package/skills/azure/azure-cosmosdb-pattern/references/provisioning.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/recovery.md +31 -0
- package/skills/azure/azure-cosmosdb-pattern/references/replication.md +22 -0
- package/skills/azure/azure-cosmosdb-pattern/references/runtime-contract.md +43 -0
- package/skills/azure/azure-cosmosdb-pattern/references/sources.md +61 -0
- package/skills/azure/azure-cosmosdb-pattern/references/workflow.md +18 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/recovery_guard.py +96 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/review_due.py +26 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/select_mode.py +108 -0
- package/skills/azure/azure-cosmosdb-pattern/scripts/validate_assets.py +53 -0
- package/skills/azure/azure-cosmosdb-performance-investigator/SKILL.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/SKILL.md +7 -3
- package/skills/azure/azure-cosmosdb-platform-operator/metadata.json +6 -3
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/live.md +180 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit/offline.md +160 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/commands/audit.md +26 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/consistency-capacity-security.md +136 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/cosmosdb-platform-operations.md +1 -1
- package/skills/azure/azure-cosmosdb-platform-operator/references/evidence-ledger.md +242 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-cassandra.md +178 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations-mongodb.md +202 -0
- package/skills/azure/azure-cosmosdb-platform-operator/references/operations.md +126 -0
- package/skills/azure/azure-cost-estimation-review/SKILL.md +1 -1
- package/skills/azure/azure-cost-optimization-governor/SKILL.md +1 -1
- package/skills/azure/azure-entra-id-specialist/SKILL.md +1 -1
- package/skills/azure/azure-governance-policy-guardrails/SKILL.md +1 -1
- package/skills/azure/azure-identity-governance-review/SKILL.md +1 -1
- package/skills/azure/azure-key-vault-secret-lifecycle-auditor/SKILL.md +1 -1
- package/skills/azure/azure-landing-zone-architect/SKILL.md +1 -1
- package/skills/azure/azure-maestro/SKILL.md +2 -1
- package/skills/azure/azure-migrate-landing-zone-cutover/SKILL.md +1 -1
- package/skills/azure/azure-network-topology-review/SKILL.md +1 -1
- package/skills/azure/azure-observability-investigator/SKILL.md +1 -1
- package/skills/azure/azure-platform-automation-devops/SKILL.md +1 -1
- package/skills/azure/azure-private-endpoint-adoption-planner/SKILL.md +1 -1
- package/skills/azure/azure-rbac-review/SKILL.md +1 -1
- package/skills/azure/azure-resilience-bcdr-review/SKILL.md +1 -1
- package/skills/azure/azure-resource-health-incident-triage/SKILL.md +1 -1
- package/skills/azure/azure-role-selector/SKILL.md +1 -1
- package/skills/azure/azure-security-posture-hardening/SKILL.md +1 -1
- package/skills/azure/azure-subscription-resource-organization/SKILL.md +1 -1
- package/skills/azure/azure-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-reliability-review/SKILL.md +1 -1
- package/skills/azure/azure-waf-security-review/SKILL.md +1 -1
- package/skills/contabo/contabo-security-hardening/SKILL.md +1 -1
- package/skills/cross-functional/agentic-board-protocol/SKILL.md +1 -1
- package/skills/cross-functional/copilot-data-readiness-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-case-capsule/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-data-exposure-escalation-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-live-change-approval-protocol/SKILL.md +1 -1
- package/skills/cross-functional/salesforce-risk-taxonomy/SKILL.md +1 -1
- package/skills/databricks/databricks-lakehouse-engineering-at-azure/SKILL.md +1 -1
- package/skills/databricks/databricks-unity-catalog-governance-at-azure/SKILL.md +1 -1
- package/skills/dotnet/dotnet-performance-aot-review/SKILL.md +1 -1
- package/skills/frontend/vue-router-navigation-security-review/SKILL.md +1 -1
- package/skills/gcp/README.md +2 -1
- package/skills/gcp/gcp-bigtable-architect/SKILL.md +71 -0
- package/skills/gcp/gcp-bigtable-architect/metadata.json +28 -0
- package/skills/gcp/gcp-bigtable-architect/references/bigtable-design-guide.md +156 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/live.md +122 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit/offline.md +140 -0
- package/skills/gcp/gcp-bigtable-architect/references/commands/audit.md +21 -0
- package/skills/gcp/gcp-bigtable-architect/references/evidence-ledger.md +83 -0
- package/skills/gcp/gcp-bigtable-architect/references/operations.md +111 -0
- package/skills/gcp/gcp-firebase-developer/SKILL.md +6 -3
- package/skills/gcp/gcp-firebase-developer/metadata.json +14 -4
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/live.md +124 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit/offline.md +146 -0
- package/skills/gcp/gcp-firebase-developer/references/commands/audit.md +27 -0
- package/skills/gcp/gcp-firebase-developer/references/evidence-ledger.md +190 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-mongodb-operations.md +189 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore-operations.md +202 -0
- package/skills/gcp/gcp-firebase-developer/references/firestore.md +122 -0
- package/skills/gcp/gcp-maestro/SKILL.md +2 -1
- package/skills/huawei/README.md +2 -1
- package/skills/huawei/huawei-gaussdb-rds-dba/SKILL.md +7 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/metadata.json +12 -4
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit/offline.md +106 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/dds-operations.md +135 -0
- package/skills/huawei/huawei-gaussdb-rds-dba/references/evidence-ledger.md +87 -0
- package/skills/huawei/huawei-geminidb-architect/SKILL.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/metadata.json +26 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/live.md +68 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit/offline.md +108 -0
- package/skills/huawei/huawei-geminidb-architect/references/commands/audit.md +23 -0
- package/skills/huawei/huawei-geminidb-architect/references/evidence-ledger.md +83 -0
- package/skills/huawei/huawei-geminidb-architect/references/geminidb-design-guide.md +114 -0
- package/skills/huawei/huawei-geminidb-architect/references/operations.md +135 -0
- package/skills/huawei/huawei-maestro/SKILL.md +2 -1
- package/skills/ionos/ionos-live-database-lifecycle-guard/SKILL.md +2 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/live.md +87 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit/offline.md +109 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/commands/audit.md +27 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/evidence-ledger.md +69 -0
- package/skills/ionos/ionos-live-database-lifecycle-guard/references/mongodb-operations.md +220 -0
- package/skills/java/java-application-server-exit/SKILL.md +1 -1
- package/skills/java/java-jvm-performance-and-gc/SKILL.md +1 -1
- package/skills/java/java-resilience-pattern/SKILL.md +1 -1
- package/skills/java/java-test-architecture/SKILL.md +1 -1
- package/skills/java/java-transaction-and-consistency/SKILL.md +1 -1
- package/skills/kubernetes/kubernetes-rbac-review/SKILL.md +1 -1
- package/skills/marketing/analytics-data-minimization-review/SKILL.md +1 -1
- package/skills/microsoft/d365-customer-insights-journeys/SKILL.md +1 -1
- package/skills/microsoft/fabric-analytics-engineering/SKILL.md +1 -1
- package/skills/microsoft/m365-defender-xdr-security-operations/SKILL.md +1 -1
- package/skills/microsoft/m365-purview-data-security-compliance/SKILL.md +1 -1
- package/skills/oci/README.md +6 -1
- package/skills/oci/oci-autonomous-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-certificates-issuer-review/SKILL.md +1 -1
- package/skills/oci/oci-cloud-guard-responder/SKILL.md +1 -1
- package/skills/oci/oci-compute-instance-agent-operator/SKILL.md +1 -1
- package/skills/oci/oci-compute-platform-operator/SKILL.md +1 -1
- package/skills/oci/oci-cost-finops-analyst/SKILL.md +1 -1
- package/skills/oci/oci-database-platform-dba/SKILL.md +1 -1
- package/skills/oci/oci-dbtools-sql-analyst/SKILL.md +1 -1
- package/skills/oci/oci-devops-container-platform-engineer/SKILL.md +1 -1
- package/skills/oci/oci-exadata-database-architect/SKILL.md +1 -1
- package/skills/oci/oci-exadata-platform-architect/SKILL.md +1 -1
- package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md +1 -1
- package/skills/oci/oci-goldengate-replication-operator/SKILL.md +1 -1
- package/skills/oci/oci-identity-access-governor/SKILL.md +1 -1
- package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md +1 -1
- package/skills/oci/oci-limits-capacity-planner/SKILL.md +1 -1
- package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-network-security-rule-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-oke-rollout-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-resource-manager-stack-guard/SKILL.md +1 -1
- package/skills/oci/oci-live-vault-key-destruction-guard/SKILL.md +1 -1
- package/skills/oci/oci-load-balancer-traffic-engineer/SKILL.md +1 -1
- package/skills/oci/oci-maestro/SKILL.md +1 -1
- package/skills/oci/oci-migration-cutover-architect/SKILL.md +1 -1
- package/skills/oci/oci-multi-cloud-architect/SKILL.md +1 -1
- package/skills/oci/oci-mysql-heatwave-ai-specialist/SKILL.md +1 -1
- package/skills/oci/oci-network-architect/SKILL.md +1 -1
- package/skills/oci/oci-nosql-database-architect/SKILL.md +73 -0
- package/skills/oci/oci-nosql-database-architect/metadata.json +28 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/live.md +136 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit/offline.md +150 -0
- package/skills/oci/oci-nosql-database-architect/references/commands/audit.md +28 -0
- package/skills/oci/oci-nosql-database-architect/references/evidence-ledger.md +96 -0
- package/skills/oci/oci-nosql-database-architect/references/nosql-design-guide.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/operations.md +194 -0
- package/skills/oci/oci-nosql-database-architect/references/sdk-matrix.md +43 -0
- package/skills/oci/oci-nosql-pattern/CHANGELOG.md +8 -0
- package/skills/oci/oci-nosql-pattern/README.md +81 -0
- package/skills/oci/oci-nosql-pattern/SKILL.md +62 -0
- package/skills/oci/oci-nosql-pattern/assets/content-review.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/create-table.sh +32 -0
- package/skills/oci/oci-nosql-pattern/assets/index-keys.json +11 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-export.json +22 -0
- package/skills/oci/oci-nosql-pattern/assets/migrator-import.json +29 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.ddl +9 -0
- package/skills/oci/oci-nosql-pattern/assets/orders.tf +46 -0
- package/skills/oci/oci-nosql-pattern/assets/query-pages.mjs +33 -0
- package/skills/oci/oci-nosql-pattern/assets/query.json +13 -0
- package/skills/oci/oci-nosql-pattern/assets/query.sql +1 -0
- package/skills/oci/oci-nosql-pattern/assets/recovery-manifest.example.json +35 -0
- package/skills/oci/oci-nosql-pattern/assets/row.json +10 -0
- package/skills/oci/oci-nosql-pattern/assets/table-limits.json +6 -0
- package/skills/oci/oci-nosql-pattern/evals/cli-shapes.json +222 -0
- package/skills/oci/oci-nosql-pattern/evals/eval.md +26 -0
- package/skills/oci/oci-nosql-pattern/evals/prompts.json +89 -0
- package/skills/oci/oci-nosql-pattern/evals/report.md +41 -0
- package/skills/oci/oci-nosql-pattern/evals/test_package.py +350 -0
- package/skills/oci/oci-nosql-pattern/evals/test_runtime.mjs +77 -0
- package/skills/oci/oci-nosql-pattern/metadata.json +25 -0
- package/skills/oci/oci-nosql-pattern/references/access.md +29 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/live.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit/offline.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/audit.md +6 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/migrator.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup/sdk.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/backup.md +7 -0
- package/skills/oci/oci-nosql-pattern/references/commands/design.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/feature-plan.md +10 -0
- package/skills/oci/oci-nosql-pattern/references/commands/help.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/performance-test.md +12 -0
- package/skills/oci/oci-nosql-pattern/references/commands/refactor.md +9 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/migrator.md +13 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore/sdk.md +11 -0
- package/skills/oci/oci-nosql-pattern/references/commands/restore.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/commands/select.md +8 -0
- package/skills/oci/oci-nosql-pattern/references/embedding-integrations.md +25 -0
- package/skills/oci/oci-nosql-pattern/references/encryption.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-index.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/evidence-ledger.md +73 -0
- package/skills/oci/oci-nosql-pattern/references/indexes.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/language-adapters.md +160 -0
- package/skills/oci/oci-nosql-pattern/references/maintenance.md +15 -0
- package/skills/oci/oci-nosql-pattern/references/modeling.md +26 -0
- package/skills/oci/oci-nosql-pattern/references/monitoring.md +21 -0
- package/skills/oci/oci-nosql-pattern/references/provisioning.md +44 -0
- package/skills/oci/oci-nosql-pattern/references/recovery-boundary.md +32 -0
- package/skills/oci/oci-nosql-pattern/references/replicas.md +18 -0
- package/skills/oci/oci-nosql-pattern/references/runtime-contract.md +23 -0
- package/skills/oci/oci-nosql-pattern/references/sources.md +57 -0
- package/skills/oci/oci-nosql-pattern/references/ttl.md +19 -0
- package/skills/oci/oci-nosql-pattern/references/types-and-vectors.md +27 -0
- package/skills/oci/oci-nosql-pattern/scripts/check_recovery.py +52 -0
- package/skills/oci/oci-nosql-pattern/scripts/review_due.py +32 -0
- package/skills/oci/oci-nosql-pattern/scripts/select_mode.py +96 -0
- package/skills/oci/oci-observability-incident-responder/SKILL.md +1 -1
- package/skills/oci/oci-recovery-service-operator/SKILL.md +1 -1
- package/skills/oci/oci-registry-artifact-governor/SKILL.md +1 -1
- package/skills/oci/oci-resource-search-inventory-analyst/SKILL.md +1 -1
- package/skills/oci/oci-security-compliance-reviewer/SKILL.md +1 -1
- package/skills/oci/oci-solution-architect/SKILL.md +1 -1
- package/skills/oci/oci-storage-backup-steward/SKILL.md +1 -1
- package/skills/oci/oci-support-incident-coordinator/SKILL.md +1 -1
- package/skills/oci/oci-waf-cost-optimization-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-reliability-review/SKILL.md +1 -1
- package/skills/oci/oci-waf-security-review/SKILL.md +1 -1
- package/skills/oci/oracle-oci-mcp-grounded-advisor/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-cost-finops-analyst/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-live-kms-key-destruction-guard/SKILL.md +1 -1
- package/skills/ovhcloud/ovhcloud-mongodb-architect/SKILL.md +43 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/metadata.json +25 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/live.md +90 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit/offline.md +112 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/evidence-ledger.md +93 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/official-sources.md +15 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/operations.md +216 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/ovhcloud/ovhcloud-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/salesforce/salesforce-agentforce-risk-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-apex-lwc-code-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-devsecops-pipeline-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-flow-automation-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-infrastructure-audit-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-integration-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-marketing-consent-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-metadata-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-org-assessment-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-permission-model-review-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-release-readiness-skill/SKILL.md +1 -1
- package/skills/salesforce/salesforce-zero-trust-maturity-skill/SKILL.md +1 -1
- package/skills/sap/sap-analytics-cloud-planning-governance/SKILL.md +1 -1
- package/skills/sap/sap-btp-governance-review/SKILL.md +1 -1
- package/skills/sap/sap-cloud-alm-sre-incident-review/SKILL.md +1 -1
- package/skills/sap/sap-datasphere-data-product-architecture/SKILL.md +1 -1
- package/skills/sap/sap-ewm-tm-logistics-execution-review/SKILL.md +1 -1
- package/skills/sap/sap-finance-fico-controls-review/SKILL.md +1 -1
- package/skills/sap/sap-hana-cloud-performance-cost/SKILL.md +1 -1
- package/skills/sap/sap-hypercare-incident-commander-review/SKILL.md +1 -1
- package/skills/sap/sap-integration-suite-review/SKILL.md +1 -1
- package/skills/sap/sap-joule-governance-adoption-review/SKILL.md +1 -1
- package/skills/sap/sap-license-btp-consumption-finops-review/SKILL.md +1 -1
- package/skills/sap/sap-manufacturing-execution-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-mdg-master-data-quality-review/SKILL.md +1 -1
- package/skills/sap/sap-order-to-cash-review/SKILL.md +1 -1
- package/skills/sap/sap-procurement-ariba-value-leakage-review/SKILL.md +1 -1
- package/skills/sap/sap-release-change-collision-review/SKILL.md +1 -1
- package/skills/sap/sap-rise-sla-vendor-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-security-iam-grc-sod-review/SKILL.md +1 -1
- package/skills/sap/sap-signavio-process-mining-value/SKILL.md +1 -1
- package/skills/sap/sap-successfactors-hr-process-risk-review/SKILL.md +1 -1
- package/skills/sap/sap-supply-chain-ibp-resilience-review/SKILL.md +1 -1
- package/skills/sap/sap-testing-quality-gate-review/SKILL.md +1 -1
- package/skills/sap/sap-transformation-portfolio-triage-review/SKILL.md +1 -1
- package/skills/sap/sap-treasury-cash-risk-review/SKILL.md +1 -1
- package/skills/scaleway/scaleway-kapsule-platform-operator/SKILL.md +1 -1
- package/skills/scaleway/scaleway-managed-mongodb-architect/SKILL.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/metadata.json +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/live.md +99 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit/offline.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/commands/audit.md +24 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/evidence-ledger.md +43 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/official-sources.md +14 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/operations.md +114 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/safety-checklist.md +22 -0
- package/skills/scaleway/scaleway-managed-mongodb-architect/references/workflow-and-output.md +22 -0
- package/skills/scaleway/scaleway-network-architect/SKILL.md +1 -1
- package/templates/nosql-audit-template.md +127 -0
- package/templates/nosql-operations-template.md +60 -0
- package/tests/_generate_maestro_routing_fixtures.py +11 -0
- package/tests/fixtures/README.md +2 -2
- package/tests/fixtures/alibaba-maestro-routing/expected/050-happy-tablestore-partition-key.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/expected/adv-tablestore-not-polardb.json +6 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/050-happy-tablestore-partition-key.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/inputs/adv-tablestore-not-polardb.json +7 -0
- package/tests/fixtures/alibaba-maestro-routing/taxonomy.json +13 -0
- package/tests/fixtures/aws-maestro-routing/expected/042-happy-dynamodb-patterns.json +6 -0
- package/tests/fixtures/aws-maestro-routing/expected/043-happy-dynamodb-vector-index.json +6 -0
- package/tests/fixtures/aws-maestro-routing/inputs/042-happy-dynamodb-patterns.json +7 -0
- package/tests/fixtures/aws-maestro-routing/inputs/043-happy-dynamodb-vector-index.json +7 -0
- package/tests/fixtures/aws-maestro-routing/taxonomy.json +15 -1
- package/tests/fixtures/azure-maestro-routing/expected/028-happy-cosmosdb-pattern-feature-plan.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/029-happy-cosmosdb-pattern-refactor.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-hot-partition-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-partition-key-not-key-vault.json +6 -0
- package/tests/fixtures/azure-maestro-routing/expected/adv-cosmos-throttling-investigation.json +6 -0
- package/tests/fixtures/azure-maestro-routing/inputs/028-happy-cosmosdb-pattern-feature-plan.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/029-happy-cosmosdb-pattern-refactor.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-hot-partition-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-partition-key-not-key-vault.json +7 -0
- package/tests/fixtures/azure-maestro-routing/inputs/adv-cosmos-throttling-investigation.json +7 -0
- package/tests/fixtures/azure-maestro-routing/taxonomy.json +21 -2
- package/tests/fixtures/gcp-maestro-routing/expected/049-happy-bigtable-row-key.json +6 -0
- package/tests/fixtures/gcp-maestro-routing/expected/adv-bigtable-not-firestore.json +8 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/049-happy-bigtable-row-key.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/inputs/adv-bigtable-not-firestore.json +7 -0
- package/tests/fixtures/gcp-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/huawei-maestro-routing/expected/050-happy-geminidb-cassandra-partition.json +6 -0
- package/tests/fixtures/huawei-maestro-routing/expected/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/050-happy-geminidb-cassandra-partition.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/inputs/adv-geminidb-mongo-routes-dds.json +7 -0
- package/tests/fixtures/huawei-maestro-routing/taxonomy.json +15 -0
- package/tests/fixtures/nosql-scenarios/scenarios.json +472 -0
- package/tests/fixtures/oci-maestro-routing/expected/031-happy-nosql-database-architect.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/032-happy-nosql-global-active-table.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/033-happy-nosql-pattern-recovery.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/034-happy-nosql-pattern-refactor.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-live-mutation.json +6 -0
- package/tests/fixtures/oci-maestro-routing/expected/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/031-happy-nosql-database-architect.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/032-happy-nosql-global-active-table.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/033-happy-nosql-pattern-recovery.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/034-happy-nosql-pattern-refactor.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-live-mutation.json +7 -0
- package/tests/fixtures/oci-maestro-routing/inputs/adv-nosql-not-autonomous.json +7 -0
- package/tests/fixtures/oci-maestro-routing/taxonomy.json +27 -0
- package/tests/requirements-ci.txt +8 -0
- package/tests/test-marketplace-validators.py +7 -1
- package/tests/validate-agent-frontmatter-schema.py +7 -1
- package/tests/validate-aws-skill-quality.py +7 -0
- package/tests/validate-kiro-powers.py +8 -1
- package/tests/validate-nosql-audit.py +741 -0
- package/tests/validate-nosql-operations.py +136 -0
- package/tests/validate-nosql-pattern-evals.py +96 -0
- package/tests/validate-nosql-scenarios.py +94 -0
- package/tests/validate-skill-frontmatter-schema.py +7 -1
- package/tests/validate-skill-manifest.py +6 -1
- package/tests/validate-skill-references.py +225 -0
- package/tests/validate-skill-yaml-strict.py +84 -0
|
@@ -0,0 +1,741 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
"""Gate: every NoSQL skill has a lazy-loaded audit with offline and live variants.
|
|
3
|
+
|
|
4
|
+
Covers each skill directory in ``validate-nosql-operations.py``'s ``SERVICES`` plus
|
|
5
|
+
the ported pattern skills. Each skill must ship:
|
|
6
|
+
|
|
7
|
+
* ``references/commands/audit.md`` (the router), linked from ``SKILL.md``;
|
|
8
|
+
* ``references/commands/audit/offline.md`` and ``references/commands/audit/live.md``,
|
|
9
|
+
linked from the router and **not** from ``SKILL.md``, so an agent loads the
|
|
10
|
+
router first and then exactly one variant;
|
|
11
|
+
* a router that says to load only one variant.
|
|
12
|
+
|
|
13
|
+
For the operations skills (not the pattern skills, whose audit is feature-based and
|
|
14
|
+
canonical upstream), both variants carry the ten operations headings in order, and
|
|
15
|
+
every live section either has a command block plus a citation, or a
|
|
16
|
+
``**No live command:**`` line giving the reason.
|
|
17
|
+
|
|
18
|
+
Command safety is an allowlist, checked on every fenced block in either variant
|
|
19
|
+
(only blocks tagged as data such as ``json`` or ``yaml`` are skipped; ``console``
|
|
20
|
+
blocks are rejected). Each block is lexed with shell rules, so commands after
|
|
21
|
+
``if``/``then``/``!``/``{``, after ``&&``/``||``/``|``/``;``, inside ``$(...)``,
|
|
22
|
+
backticks, process substitution and ``${VAR:-$(...)}`` defaults are all checked, and ``"${name[@]}"`` heads are
|
|
23
|
+
expanded from their array definition, which is frozen: the array may appear
|
|
24
|
+
nowhere else in the file:
|
|
25
|
+
|
|
26
|
+
* every command head must be on the mode's allowlist (``LIVE_HEADS`` or
|
|
27
|
+
``OFFLINE_HEADS``); wrappers such as ``env``, ``xargs``, ``bash -c``, ``eval``,
|
|
28
|
+
absolute paths and heads taken from variables are rejected;
|
|
29
|
+
* live: a cloud CLI's action (the last word of its subcommand path) starts with a
|
|
30
|
+
read verb; no path word is mutating, secret-reading (``keys``, ``secret``,
|
|
31
|
+
``connection strings``, ...) or a data-plane read (``query``, ``get-item``,
|
|
32
|
+
``read-rows``, ...); no confirmation-bypass or decryption flag; ``curl`` takes only
|
|
33
|
+
allowlisted options and GET; ``python3`` runs only a quoted heredoc that imports
|
|
34
|
+
``json``/``sys`` (listed attributes only) and calls ``open(path)`` directly, read-only;
|
|
35
|
+
* offline: no cloud CLI, network tool or data shell; ``terraform``/``tofu`` only
|
|
36
|
+
``show``; ``rg --pre``, ``find -exec``/``-delete``, ``git -c`` and non-read git
|
|
37
|
+
subcommands are rejected; ``python3`` only runs the skill's own ``scripts/*.py``;
|
|
38
|
+
* ``rg``/``grep`` searches for credential patterns list file names only (``-l``),
|
|
39
|
+
so an audit never prints a secret it finds;
|
|
40
|
+
* heredoc delimiters are quoted (an unquoted body would expand ``$(...)``), and
|
|
41
|
+
arithmetic expansion and ANSI-C quoting are rejected;
|
|
42
|
+
* every evidence ID cited in a live file is a VERIFIED row of the skill's ledger,
|
|
43
|
+
and every ID cited in an offline file exists.
|
|
44
|
+
|
|
45
|
+
The file shapes live in ``templates/nosql-audit-template.md``. Never weaken a rule
|
|
46
|
+
to get green; reword the command or record ``**No live command:**`` instead.
|
|
47
|
+
"""
|
|
48
|
+
|
|
49
|
+
import ast
|
|
50
|
+
import importlib.util
|
|
51
|
+
import re
|
|
52
|
+
import sys
|
|
53
|
+
from dataclasses import dataclass, field
|
|
54
|
+
from pathlib import Path
|
|
55
|
+
|
|
56
|
+
REPO = Path(__file__).resolve().parents[1]
|
|
57
|
+
_spec = importlib.util.spec_from_file_location("nosql_ops", REPO / "tests/validate-nosql-operations.py")
|
|
58
|
+
_ops = importlib.util.module_from_spec(_spec)
|
|
59
|
+
_spec.loader.exec_module(_ops)
|
|
60
|
+
|
|
61
|
+
PATTERN_SKILLS = [
|
|
62
|
+
"skills/aws/aws-dynamodb-patterns",
|
|
63
|
+
"skills/oci/oci-nosql-pattern",
|
|
64
|
+
"skills/azure/azure-cosmosdb-pattern",
|
|
65
|
+
]
|
|
66
|
+
SKILLS = sorted({skill for skill, _ in _ops.SERVICES.values()} | set(PATTERN_SKILLS))
|
|
67
|
+
SECTIONS = _ops.SECTIONS
|
|
68
|
+
ROUTER = "references/commands/audit.md"
|
|
69
|
+
VARIANTS = {"offline": "references/commands/audit/offline.md", "live": "references/commands/audit/live.md"}
|
|
70
|
+
NO_LIVE = "**No live command:**"
|
|
71
|
+
|
|
72
|
+
CLOUD_CLIS = {"aws", "az", "gcloud", "oci", "aliyun", "hcloud", "scw", "ovhcloud", "ionosctl", "cbt", "bq", "firebase"}
|
|
73
|
+
DATA_SHELLS = {"mongosh", "mongo", "cqlsh", "mongodump", "mongoexport", "mongorestore", "mongoimport"}
|
|
74
|
+
NETWORK_TOOLS = {"curl", "wget"}
|
|
75
|
+
SHELL_UTILS = {":", "echo", "printf", "test", "[", "true", "false"}
|
|
76
|
+
LIVE_HEADS = CLOUD_CLIS | SHELL_UTILS | {"umask", "mktemp", "mkdir", "set", "exit", "grep", "jq", "curl", "python3"}
|
|
77
|
+
OFFLINE_HEADS = SHELL_UTILS | {"rg", "grep", "jq", "find", "git", "head", "tail", "sort", "wc", "cd", "terraform", "tofu",
|
|
78
|
+
"python3"}
|
|
79
|
+
KEYWORDS = {"if", "then", "else", "elif", "fi", "do", "done", "while", "until", "{", "}", "!"}
|
|
80
|
+
|
|
81
|
+
READ_VERBS = {"describe", "get", "list", "show", "ls", "view", "info", "status", "inspect", "lookup", "whoami"}
|
|
82
|
+
READ_EXCEPTIONS = {("gcloud", "logging", "read")} # audit-log entries, not customer data
|
|
83
|
+
MUTATING_EXACT = {"set", "add", "untag", "run", "put", "stop", "exec", "move", "edit", "copy", "grant", "apply", "patch",
|
|
84
|
+
"deploy", "drop", "write", "cancel", "purge", "rotate", "revoke", "assign", "unassign", "promote", "rename",
|
|
85
|
+
"replace", "scale", "resize", "attach", "detach", "upload", "invoke", "insert", "reset", "clone", "change",
|
|
86
|
+
"start", "reboot", "migrate", "upgrade", "terminate", "kill", "truncate", "decrypt", "encrypt", "sign"}
|
|
87
|
+
MUTATING_PREFIX = ("create", "delete", "update", "modify", "restore", "remove", "enable", "disable", "import", "export",
|
|
88
|
+
"failover", "switchover", "register", "deregister", "execute")
|
|
89
|
+
SECRET_WORDS = {"keys", "secret", "secrets", "secretsmanager", "password", "passwords", "credential", "credentials",
|
|
90
|
+
"token", "tokens", "decryption", "decrypt"}
|
|
91
|
+
SECRET_PAIRS = {("connection", "string"), ("connection", "strings"), ("access", "key"), ("master", "key")}
|
|
92
|
+
DATA_WORDS = {"item", "items", "row", "rows", "record", "records", "query", "scan", "statement", "statements",
|
|
93
|
+
"document", "documents", "object", "objects", "range", "read"}
|
|
94
|
+
DATA_ACTIONS = {"lookup", "count", "select", "sample", "sample-row-keys"} # whole action, e.g. cbt lookup
|
|
95
|
+
LISTABLE_DATA = {"object", "objects"} # listing object names (backup inventory) is metadata
|
|
96
|
+
BYPASS_FLAGS = {"--force", "--yes", "-y", "--assume-yes", "--no-confirm", "--quiet-confirm"}
|
|
97
|
+
|
|
98
|
+
CURL_FLAGS = {"--silent", "--show-error", "--fail", "--fail-with-body", "--location", "--compressed", "--globoff"}
|
|
99
|
+
CURL_VALUE_FLAGS = {"--header", "--max-time", "--connect-timeout", "--output", "--write-out", "--retry", "--url",
|
|
100
|
+
"--request"}
|
|
101
|
+
CURL_SHORT = {"s": False, "S": False, "f": False, "L": False, "g": False, "H": True, "m": True, "o": True, "w": True,
|
|
102
|
+
"X": True}
|
|
103
|
+
GIT_READ = {"log", "show", "grep", "ls-files", "diff", "blame", "rev-parse", "status"}
|
|
104
|
+
FIND_BANNED = {"-exec", "-execdir", "-ok", "-okdir", "-delete", "-fprint", "-fprint0", "-fprintf", "-fls"}
|
|
105
|
+
PY_IMPORTS = {"json", "sys"}
|
|
106
|
+
PY_ATTRS = {"sys": {"argv", "exit", "stdin", "stdout", "stderr"},
|
|
107
|
+
"json": {"load", "loads", "dump", "dumps", "JSONDecodeError"}} # sys.modules would reach os
|
|
108
|
+
PY_BANNED_NAMES = {"__import__", "exec", "eval", "compile", "getattr", "setattr", "globals", "locals", "vars",
|
|
109
|
+
"breakpoint", "input", "__builtins__"}
|
|
110
|
+
CREDENTIAL_PATTERN = re.compile(r"accountkey|sharedaccesskey|passw|secret|private.?key|api.?key|token|"
|
|
111
|
+
r"://[^\s/]*:[^\s/]*@|mongodb(\+srv)?://", re.IGNORECASE)
|
|
112
|
+
NAMES_ONLY = {"-l", "--files-with-matches", "-c", "--count", "-q", "--quiet"}
|
|
113
|
+
DATA_LANGS = {"json", "jsonc", "yaml", "yml", "hcl", "toml", "xml", "csv", "diff", "markdown", "md"}
|
|
114
|
+
SESSION_LANGS = {"console", "shell-session", "sh-session", "terminal", "shellsession"}
|
|
115
|
+
OPERATORS = ["&&", "||", ";;", "|&", ";", "&", "|", "(", ")"]
|
|
116
|
+
REDIRECTS = ["&>>", "<<<", "<<-", "<<", ">>", "&>", ">&", "<&", ">|", "<>", "<", ">"]
|
|
117
|
+
NAME = r"[A-Za-z_]\w*"
|
|
118
|
+
|
|
119
|
+
|
|
120
|
+
@dataclass
|
|
121
|
+
class Word:
|
|
122
|
+
value: str # after quote removal; expansions kept as written
|
|
123
|
+
raw: str # source text
|
|
124
|
+
dynamic: bool # contains a parameter expansion or substitution
|
|
125
|
+
quoted: bool
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
@dataclass
|
|
129
|
+
class Token:
|
|
130
|
+
kind: str # "word", "op", "redir"
|
|
131
|
+
text: str = ""
|
|
132
|
+
word: Word | None = None
|
|
133
|
+
heredoc: dict | None = None
|
|
134
|
+
|
|
135
|
+
|
|
136
|
+
@dataclass
|
|
137
|
+
class Command:
|
|
138
|
+
words: list[Word]
|
|
139
|
+
heredocs: list[dict] = field(default_factory=list)
|
|
140
|
+
aliases: dict = field(default_factory=dict) # array definitions in force where it runs
|
|
141
|
+
|
|
142
|
+
|
|
143
|
+
class Lexer:
|
|
144
|
+
"""A small shell lexer: quotes, escapes, comments, operators, redirections,
|
|
145
|
+
heredocs, ``$(...)``, backticks and process substitution. Anything it cannot
|
|
146
|
+
model safely is reported as a problem (fail closed)."""
|
|
147
|
+
|
|
148
|
+
def __init__(self, text: str) -> None:
|
|
149
|
+
self.s = text
|
|
150
|
+
self.i = 0
|
|
151
|
+
self.problems: list[str] = []
|
|
152
|
+
self.nested: list[list[Token]] = []
|
|
153
|
+
self.pending: list[dict] = []
|
|
154
|
+
|
|
155
|
+
def run(self, close: bool = False) -> list[Token]:
|
|
156
|
+
s, tokens, depth = self.s, [], 0
|
|
157
|
+
chars: list[str] = []
|
|
158
|
+
state = {"raw_start": None, "dynamic": False, "quoted": False}
|
|
159
|
+
|
|
160
|
+
def flush() -> None:
|
|
161
|
+
if state["raw_start"] is not None:
|
|
162
|
+
word = Word("".join(chars), s[state["raw_start"]:self.i], state["dynamic"], state["quoted"])
|
|
163
|
+
tokens.append(Token("word", word=word))
|
|
164
|
+
if len(tokens) >= 2 and tokens[-2].kind == "redir" and tokens[-2].heredoc is not None:
|
|
165
|
+
doc = tokens[-2].heredoc
|
|
166
|
+
doc["delim"] = word.value
|
|
167
|
+
doc["quoted"] = word.quoted or "\\" in word.raw
|
|
168
|
+
self.pending.append(doc)
|
|
169
|
+
chars.clear()
|
|
170
|
+
state.update(raw_start=None, dynamic=False, quoted=False)
|
|
171
|
+
|
|
172
|
+
def begin() -> None:
|
|
173
|
+
if state["raw_start"] is None:
|
|
174
|
+
state["raw_start"] = self.i
|
|
175
|
+
|
|
176
|
+
while self.i < len(s):
|
|
177
|
+
c = s[self.i]
|
|
178
|
+
if c == "\\":
|
|
179
|
+
if s[self.i + 1:self.i + 2] == "\n":
|
|
180
|
+
self.i += 2
|
|
181
|
+
continue
|
|
182
|
+
begin()
|
|
183
|
+
chars.append(s[self.i + 1:self.i + 2])
|
|
184
|
+
self.i += 2
|
|
185
|
+
continue
|
|
186
|
+
if c in " \t":
|
|
187
|
+
flush()
|
|
188
|
+
self.i += 1
|
|
189
|
+
continue
|
|
190
|
+
if c == "\n":
|
|
191
|
+
flush()
|
|
192
|
+
tokens.append(Token("op", "\n"))
|
|
193
|
+
self.i += 1
|
|
194
|
+
self.read_heredocs()
|
|
195
|
+
continue
|
|
196
|
+
if c == "#" and state["raw_start"] is None:
|
|
197
|
+
end = s.find("\n", self.i)
|
|
198
|
+
self.i = len(s) if end < 0 else end
|
|
199
|
+
continue
|
|
200
|
+
if c == "'":
|
|
201
|
+
begin()
|
|
202
|
+
end = s.find("'", self.i + 1)
|
|
203
|
+
if end < 0:
|
|
204
|
+
self.problems.append("unterminated single quote")
|
|
205
|
+
end = len(s)
|
|
206
|
+
chars.append(s[self.i + 1:end])
|
|
207
|
+
state["quoted"] = True
|
|
208
|
+
self.i = end + 1
|
|
209
|
+
continue
|
|
210
|
+
if c == '"':
|
|
211
|
+
begin()
|
|
212
|
+
state["quoted"] = True
|
|
213
|
+
self.i += 1
|
|
214
|
+
while self.i < len(s) and s[self.i] != '"':
|
|
215
|
+
d = s[self.i]
|
|
216
|
+
if d == "\\" and s[self.i + 1:self.i + 2] in ('"', "\\", "$", "`", "\n"):
|
|
217
|
+
if s[self.i + 1] != "\n":
|
|
218
|
+
chars.append(s[self.i + 1])
|
|
219
|
+
self.i += 2
|
|
220
|
+
elif d in "$`":
|
|
221
|
+
state["dynamic"] |= self.expansion(chars)
|
|
222
|
+
else:
|
|
223
|
+
chars.append(d)
|
|
224
|
+
self.i += 1
|
|
225
|
+
if self.i >= len(s):
|
|
226
|
+
self.problems.append("unterminated double quote")
|
|
227
|
+
self.i += 1
|
|
228
|
+
continue
|
|
229
|
+
if c in "$`":
|
|
230
|
+
begin()
|
|
231
|
+
state["dynamic"] |= self.expansion(chars)
|
|
232
|
+
continue
|
|
233
|
+
if c in "<>" and s[self.i + 1:self.i + 2] == "(":
|
|
234
|
+
begin()
|
|
235
|
+
self.i += 2
|
|
236
|
+
self.nested.append(self.run(close=True))
|
|
237
|
+
chars.append("<(...)")
|
|
238
|
+
state["dynamic"] = True
|
|
239
|
+
continue
|
|
240
|
+
if c in "|&;()<>":
|
|
241
|
+
if c in "<>" and state["raw_start"] is not None and "".join(chars).isdigit():
|
|
242
|
+
chars.clear()
|
|
243
|
+
state.update(raw_start=None, dynamic=False, quoted=False)
|
|
244
|
+
flush()
|
|
245
|
+
if close and c == ")" and depth == 0:
|
|
246
|
+
self.i += 1
|
|
247
|
+
return tokens
|
|
248
|
+
op = next((o for o in REDIRECTS if s.startswith(o, self.i)), None)
|
|
249
|
+
if op and not (op == "&" or s.startswith("&&", self.i)):
|
|
250
|
+
token = Token("redir", op)
|
|
251
|
+
if op in ("<<", "<<-"):
|
|
252
|
+
token.heredoc = {"strip": op == "<<-", "body": None}
|
|
253
|
+
tokens.append(token)
|
|
254
|
+
self.i += len(op)
|
|
255
|
+
continue
|
|
256
|
+
op = next(o for o in OPERATORS if s.startswith(o, self.i))
|
|
257
|
+
depth += {"(": 1, ")": -1}.get(op, 0)
|
|
258
|
+
tokens.append(Token("op", op))
|
|
259
|
+
self.i += len(op)
|
|
260
|
+
continue
|
|
261
|
+
begin()
|
|
262
|
+
chars.append(c)
|
|
263
|
+
self.i += 1
|
|
264
|
+
flush()
|
|
265
|
+
if close:
|
|
266
|
+
self.problems.append("unterminated $( or <( substitution")
|
|
267
|
+
for doc in self.pending:
|
|
268
|
+
self.problems.append(f"heredoc '{doc['delim']}' has no terminator")
|
|
269
|
+
self.pending = []
|
|
270
|
+
return tokens
|
|
271
|
+
|
|
272
|
+
def expansion(self, chars: list[str]) -> bool:
|
|
273
|
+
"""Consume one $-expansion or backtick at self.i; return True (dynamic)."""
|
|
274
|
+
s = self.s
|
|
275
|
+
if s[self.i] == "`":
|
|
276
|
+
end = self.i + 1
|
|
277
|
+
while end < len(s) and s[end] != "`":
|
|
278
|
+
end += 2 if s[end] == "\\" else 1
|
|
279
|
+
inner = Lexer(s[self.i + 1:end])
|
|
280
|
+
self.nested.append(inner.run())
|
|
281
|
+
self.nested += inner.nested
|
|
282
|
+
self.problems += inner.problems
|
|
283
|
+
chars.append("`...`")
|
|
284
|
+
self.i = end + 1
|
|
285
|
+
return True
|
|
286
|
+
nxt = s[self.i + 1:self.i + 2]
|
|
287
|
+
if s.startswith("$((", self.i):
|
|
288
|
+
self.problems.append("arithmetic expansion $((...)) is not allowed")
|
|
289
|
+
if nxt == "'":
|
|
290
|
+
self.problems.append("ANSI-C quoting $'...' is not allowed")
|
|
291
|
+
if nxt == "(":
|
|
292
|
+
self.i += 2
|
|
293
|
+
self.nested.append(self.run(close=True))
|
|
294
|
+
chars.append("$(...)")
|
|
295
|
+
return True
|
|
296
|
+
if s.startswith("${!", self.i):
|
|
297
|
+
self.problems.append("indirect expansion ${!...} is not allowed")
|
|
298
|
+
if nxt == "{":
|
|
299
|
+
# Walk the body: ${X:-$(cmd)} and ${X:-`cmd`} run cmd, so nested
|
|
300
|
+
# substitutions are lexed like any other; nested ${ } keep depth.
|
|
301
|
+
body, depth = ["${"], 1
|
|
302
|
+
self.i += 2
|
|
303
|
+
while self.i < len(s) and depth:
|
|
304
|
+
d = s[self.i]
|
|
305
|
+
if d == "\\":
|
|
306
|
+
body.append(s[self.i:self.i + 2])
|
|
307
|
+
self.i += 2
|
|
308
|
+
elif s.startswith("${", self.i):
|
|
309
|
+
body.append("${")
|
|
310
|
+
depth += 1
|
|
311
|
+
self.i += 2
|
|
312
|
+
elif d in "$`":
|
|
313
|
+
self.expansion(body)
|
|
314
|
+
else:
|
|
315
|
+
body.append(d)
|
|
316
|
+
depth -= d == "}"
|
|
317
|
+
self.i += 1
|
|
318
|
+
if depth:
|
|
319
|
+
self.problems.append("unterminated ${...} expansion")
|
|
320
|
+
chars.append("".join(body))
|
|
321
|
+
return True
|
|
322
|
+
match = re.match(r"\$(" + NAME + r"|[0-9@*#?$!-])", s[self.i:])
|
|
323
|
+
if match:
|
|
324
|
+
chars.append(match.group(0))
|
|
325
|
+
self.i += len(match.group(0))
|
|
326
|
+
return True
|
|
327
|
+
chars.append("$")
|
|
328
|
+
self.i += 1
|
|
329
|
+
return False
|
|
330
|
+
|
|
331
|
+
def read_heredocs(self) -> None:
|
|
332
|
+
for doc in self.pending:
|
|
333
|
+
body = []
|
|
334
|
+
while self.i < len(self.s):
|
|
335
|
+
end = self.s.find("\n", self.i)
|
|
336
|
+
end = len(self.s) if end < 0 else end
|
|
337
|
+
line = self.s[self.i:end]
|
|
338
|
+
self.i = end + 1
|
|
339
|
+
if (line.lstrip("\t") if doc["strip"] else line) == doc["delim"]:
|
|
340
|
+
doc["body"] = "\n".join(body)
|
|
341
|
+
break
|
|
342
|
+
body.append(line)
|
|
343
|
+
else:
|
|
344
|
+
self.problems.append(f"heredoc '{doc['delim']}' has no terminator")
|
|
345
|
+
doc["body"] = "\n".join(body)
|
|
346
|
+
if not doc["quoted"]:
|
|
347
|
+
self.problems.append(f"heredoc '{doc['delim']}' must use a quoted delimiter (<<'{doc['delim']}')")
|
|
348
|
+
self.pending = []
|
|
349
|
+
|
|
350
|
+
|
|
351
|
+
def split_commands(tokens: list[Token], aliases: dict[str, list[Word]], problems: list[str]) -> list[Command]:
|
|
352
|
+
commands, current, heredocs = [], [], []
|
|
353
|
+
skip_next, array_name, array_words = False, None, []
|
|
354
|
+
for token in tokens:
|
|
355
|
+
if array_name is not None:
|
|
356
|
+
if token.kind == "op" and token.text == ")":
|
|
357
|
+
if array_name in aliases:
|
|
358
|
+
problems.append(f"array '{array_name}' is defined twice; define each command array once")
|
|
359
|
+
aliases[array_name] = array_words
|
|
360
|
+
array_name, array_words = None, []
|
|
361
|
+
elif token.kind == "word":
|
|
362
|
+
array_words.append(token.word)
|
|
363
|
+
continue
|
|
364
|
+
if token.kind == "op":
|
|
365
|
+
if token.text == "(" and current and re.fullmatch(NAME + "=", current[-1].raw):
|
|
366
|
+
array_name = current.pop().raw[:-1]
|
|
367
|
+
continue
|
|
368
|
+
commands.append(Command(current, heredocs, dict(aliases)))
|
|
369
|
+
current, heredocs = [], []
|
|
370
|
+
continue
|
|
371
|
+
if token.kind == "redir":
|
|
372
|
+
skip_next = True
|
|
373
|
+
if token.heredoc is not None:
|
|
374
|
+
heredocs.append(token.heredoc)
|
|
375
|
+
continue
|
|
376
|
+
if skip_next:
|
|
377
|
+
skip_next = False
|
|
378
|
+
continue
|
|
379
|
+
current.append(token.word)
|
|
380
|
+
commands.append(Command(current, heredocs, dict(aliases)))
|
|
381
|
+
result = []
|
|
382
|
+
for command in commands:
|
|
383
|
+
words = command.words
|
|
384
|
+
while True:
|
|
385
|
+
while words and re.match(NAME + "=", words[0].raw):
|
|
386
|
+
words = words[1:]
|
|
387
|
+
if words and not words[0].quoted and words[0].raw in KEYWORDS:
|
|
388
|
+
words = words[1:]
|
|
389
|
+
continue
|
|
390
|
+
break
|
|
391
|
+
if words and words[0].raw in {"for", "select", "case"}:
|
|
392
|
+
problems.append(f"'{words[0].raw}' is not allowed in an audit block; write the commands out")
|
|
393
|
+
continue
|
|
394
|
+
if words:
|
|
395
|
+
alias = re.fullmatch(r'"?\$\{(' + NAME + r')\[@\]\}"?', words[0].raw)
|
|
396
|
+
if alias:
|
|
397
|
+
if alias.group(1) not in command.aliases:
|
|
398
|
+
problems.append(f"array '{alias.group(1)}' is used before it is defined")
|
|
399
|
+
continue
|
|
400
|
+
words = command.aliases[alias.group(1)] + words[1:]
|
|
401
|
+
result.append(Command(words, command.heredocs))
|
|
402
|
+
return result
|
|
403
|
+
|
|
404
|
+
|
|
405
|
+
def parse_block(block: str, aliases: dict[str, list[Word]]) -> tuple[list[Command], list[str]]:
|
|
406
|
+
lexer = Lexer(block)
|
|
407
|
+
tokens = lexer.run()
|
|
408
|
+
problems = list(lexer.problems)
|
|
409
|
+
commands = []
|
|
410
|
+
for stream in [tokens] + lexer.nested:
|
|
411
|
+
commands += split_commands(stream, aliases, problems)
|
|
412
|
+
return commands, problems
|
|
413
|
+
|
|
414
|
+
|
|
415
|
+
def commands(block: str) -> list[list[str]]:
|
|
416
|
+
"""Token values of every simple command in a shell block (array heads expanded)."""
|
|
417
|
+
parsed, _ = parse_block(block, {})
|
|
418
|
+
return [[word.value for word in command.words] for command in parsed]
|
|
419
|
+
|
|
420
|
+
|
|
421
|
+
def is_cli(tokens: list[str]) -> bool:
|
|
422
|
+
return tokens[0] in CLOUD_CLIS
|
|
423
|
+
|
|
424
|
+
|
|
425
|
+
def pieces(word: str) -> list[str]:
|
|
426
|
+
"""Split a subcommand word on hyphens and CamelCase (aliyun/hcloud actions)."""
|
|
427
|
+
found = []
|
|
428
|
+
for part in word.split("-"):
|
|
429
|
+
found += [w.lower() for w in re.findall(r"[A-Z]+(?![a-z])|[A-Z]?[a-z0-9]+", part)]
|
|
430
|
+
return found
|
|
431
|
+
|
|
432
|
+
|
|
433
|
+
def is_path_word(word: Word) -> bool:
|
|
434
|
+
return not word.dynamic and bool(re.fullmatch(r"[A-Za-z][A-Za-z0-9-]*", word.value))
|
|
435
|
+
|
|
436
|
+
|
|
437
|
+
def cli_path(words: list[Word]) -> list[str]:
|
|
438
|
+
"""Subcommand path: leading bare words after the CLI, skipping global options."""
|
|
439
|
+
path, i = [], 1
|
|
440
|
+
while i < len(words):
|
|
441
|
+
word = words[i]
|
|
442
|
+
if word.value.startswith("-") and not word.dynamic:
|
|
443
|
+
if path:
|
|
444
|
+
break
|
|
445
|
+
if "=" not in word.value and i + 1 < len(words) and not is_path_word(words[i + 1]):
|
|
446
|
+
i += 1
|
|
447
|
+
i += 1
|
|
448
|
+
continue
|
|
449
|
+
if not is_path_word(word):
|
|
450
|
+
break
|
|
451
|
+
path.append(word.value)
|
|
452
|
+
i += 1
|
|
453
|
+
return path
|
|
454
|
+
|
|
455
|
+
|
|
456
|
+
def shown(words: list[Word]) -> str:
|
|
457
|
+
return " ".join(word.value for word in words)[:120]
|
|
458
|
+
|
|
459
|
+
|
|
460
|
+
def cli_problems(words: list[Word]) -> list[str]:
|
|
461
|
+
text = shown(words)
|
|
462
|
+
path = cli_path(words)
|
|
463
|
+
if not path:
|
|
464
|
+
return [f"no subcommand found in '{text}'"]
|
|
465
|
+
problems = []
|
|
466
|
+
all_pieces = [p for word in path for p in pieces(word)]
|
|
467
|
+
action = pieces(path[-1])
|
|
468
|
+
for part in all_pieces:
|
|
469
|
+
if part in MUTATING_EXACT or part.startswith(MUTATING_PREFIX):
|
|
470
|
+
problems.append(f"mutating word '{part}' in '{text}'")
|
|
471
|
+
if part in SECRET_WORDS:
|
|
472
|
+
problems.append(f"secret-reading word '{part}' in '{text}'")
|
|
473
|
+
if part in DATA_WORDS and not (part in LISTABLE_DATA and action[:1] in (["list"], ["ls"])) \
|
|
474
|
+
and (words[0].value, *path) not in READ_EXCEPTIONS:
|
|
475
|
+
problems.append(f"data-plane word '{part}' in '{text}'; audit control-plane metadata only")
|
|
476
|
+
if path[-1].lower() in DATA_ACTIONS:
|
|
477
|
+
problems.append(f"data-plane action '{path[-1]}' in '{text}'; audit control-plane metadata only")
|
|
478
|
+
for pair in zip(all_pieces, all_pieces[1:]):
|
|
479
|
+
if pair in SECRET_PAIRS:
|
|
480
|
+
problems.append(f"secret-reading words '{' '.join(pair)}' in '{text}'")
|
|
481
|
+
for word in words[1:]:
|
|
482
|
+
if word.value.startswith("-"):
|
|
483
|
+
flag = word.value.split("=", 1)[0]
|
|
484
|
+
if flag in BYPASS_FLAGS:
|
|
485
|
+
problems.append(f"confirmation-bypass flag '{flag}' in '{text}'")
|
|
486
|
+
if any(p in SECRET_WORDS for p in pieces(flag.lstrip("-"))):
|
|
487
|
+
problems.append(f"secret-reading flag '{flag}' in '{text}'")
|
|
488
|
+
if (words[0].value, *path) not in READ_EXCEPTIONS and (not action or action[0] not in READ_VERBS):
|
|
489
|
+
problems.append(f"action '{path[-1]}' is not a read ({', '.join(sorted(READ_VERBS))}) in '{text}'")
|
|
490
|
+
return problems
|
|
491
|
+
|
|
492
|
+
|
|
493
|
+
def curl_problems(words: list[Word]) -> list[str]:
|
|
494
|
+
text, problems, i = shown(words), [], 1
|
|
495
|
+
while i < len(words):
|
|
496
|
+
value = words[i].value
|
|
497
|
+
method = None
|
|
498
|
+
if words[i].dynamic and not words[i].quoted:
|
|
499
|
+
problems.append(f"unquoted expansion '{words[i].raw}' can inject curl options in '{text}'")
|
|
500
|
+
if value.startswith("--"):
|
|
501
|
+
name, eq, arg = value.partition("=")
|
|
502
|
+
if name in CURL_VALUE_FLAGS:
|
|
503
|
+
if not eq:
|
|
504
|
+
i += 1
|
|
505
|
+
arg = words[i].value if i < len(words) else ""
|
|
506
|
+
if name == "--request":
|
|
507
|
+
method = arg
|
|
508
|
+
elif name not in CURL_FLAGS or eq:
|
|
509
|
+
problems.append(f"curl option '{name}' is not allowed in '{text}'")
|
|
510
|
+
elif value.startswith("-") and len(value) > 1 and not words[i].dynamic:
|
|
511
|
+
j = 1
|
|
512
|
+
while j < len(value):
|
|
513
|
+
flag = value[j]
|
|
514
|
+
if flag not in CURL_SHORT:
|
|
515
|
+
problems.append(f"curl option '-{flag}' is not allowed in '{text}'")
|
|
516
|
+
break
|
|
517
|
+
if CURL_SHORT[flag]:
|
|
518
|
+
arg = value[j + 1:]
|
|
519
|
+
if not arg:
|
|
520
|
+
i += 1
|
|
521
|
+
arg = words[i].value if i < len(words) else ""
|
|
522
|
+
if flag == "X":
|
|
523
|
+
method = arg
|
|
524
|
+
break
|
|
525
|
+
j += 1
|
|
526
|
+
if method is not None and method.upper() != "GET":
|
|
527
|
+
problems.append(f"curl uses method '{method}' in '{text}'; GET only")
|
|
528
|
+
i += 1
|
|
529
|
+
return problems
|
|
530
|
+
|
|
531
|
+
|
|
532
|
+
def python_problems(command: Command, mode: str, skill: Path) -> list[str]:
|
|
533
|
+
words, text = command.words, shown(command.words)
|
|
534
|
+
if mode == "offline":
|
|
535
|
+
script = words[1].value if len(words) > 1 else ""
|
|
536
|
+
if re.fullmatch(r"scripts/[\w-]+\.py", script) and (skill / script).is_file():
|
|
537
|
+
return []
|
|
538
|
+
return [f"offline python3 may only run the skill's own scripts/*.py: '{text}'"]
|
|
539
|
+
if len(words) < 2 or words[1].value != "-" or len(command.heredocs) != 1:
|
|
540
|
+
return [f"live python3 must read a quoted heredoc script ('python3 - <<'PY''): '{text}'"]
|
|
541
|
+
try:
|
|
542
|
+
tree = ast.parse(command.heredocs[0]["body"] or "")
|
|
543
|
+
except SyntaxError as error:
|
|
544
|
+
return [f"python3 heredoc does not parse ({error.msg}): '{text}'"]
|
|
545
|
+
problems = []
|
|
546
|
+
direct = {id(node.func) for node in ast.walk(tree) if isinstance(node, ast.Call)}
|
|
547
|
+
attr_bases = {id(node.value) for node in ast.walk(tree) if isinstance(node, ast.Attribute)}
|
|
548
|
+
for node in ast.walk(tree):
|
|
549
|
+
if isinstance(node, ast.ImportFrom):
|
|
550
|
+
problems.append(f"python3 heredoc uses 'from {node.module} import'; use 'import json' or 'import sys'")
|
|
551
|
+
elif isinstance(node, ast.Import):
|
|
552
|
+
problems += [f"python3 heredoc imports '{a.name}'{' as ' + a.asname if a.asname else ''}; "
|
|
553
|
+
f"only {sorted(PY_IMPORTS)}, unaliased" for a in node.names
|
|
554
|
+
if a.name not in PY_IMPORTS or a.asname]
|
|
555
|
+
elif isinstance(node, ast.Name) and node.id == "open" and id(node) not in direct:
|
|
556
|
+
problems.append("python3 heredoc refers to 'open' without calling it; call open(path) directly")
|
|
557
|
+
elif isinstance(node, ast.Name) and node.id in PY_ATTRS and id(node) not in attr_bases:
|
|
558
|
+
problems.append(f"python3 heredoc uses module '{node.id}' as a value; use only its listed attributes")
|
|
559
|
+
elif isinstance(node, ast.Attribute) and isinstance(node.value, ast.Name) and node.value.id in PY_ATTRS \
|
|
560
|
+
and node.attr not in PY_ATTRS[node.value.id]:
|
|
561
|
+
problems.append(f"python3 heredoc uses '{node.value.id}.{node.attr}'; allowed: "
|
|
562
|
+
f"{sorted(PY_ATTRS[node.value.id])}")
|
|
563
|
+
elif isinstance(node, ast.Starred) or (isinstance(node, ast.keyword) and node.arg is None):
|
|
564
|
+
problems.append("python3 heredoc unpacks arguments (*/**); pass them literally so the check sees them")
|
|
565
|
+
elif isinstance(node, ast.Name) and node.id in PY_BANNED_NAMES:
|
|
566
|
+
problems.append(f"python3 heredoc uses '{node.id}'")
|
|
567
|
+
elif isinstance(node, ast.Attribute) and node.attr.startswith("__"):
|
|
568
|
+
problems.append(f"python3 heredoc uses dunder attribute '{node.attr}'")
|
|
569
|
+
elif isinstance(node, ast.Call) and isinstance(node.func, ast.Name) and node.func.id == "open" \
|
|
570
|
+
and (len(node.args) != 1 or node.keywords):
|
|
571
|
+
problems.append("python3 heredoc may only call open(path) read-only")
|
|
572
|
+
return problems
|
|
573
|
+
|
|
574
|
+
|
|
575
|
+
def command_problems(command: Command, mode: str, skill: Path) -> list[str]:
|
|
576
|
+
words = command.words
|
|
577
|
+
head, text = words[0].value, shown(words)
|
|
578
|
+
if words[0].dynamic:
|
|
579
|
+
return [f"command name comes from an expansion in '{text}'; name the program literally"]
|
|
580
|
+
allowed = LIVE_HEADS if mode == "live" else OFFLINE_HEADS
|
|
581
|
+
if head in DATA_SHELLS:
|
|
582
|
+
return [f"data-plane shell '{head}' in '{text}'; audit control-plane metadata only"]
|
|
583
|
+
if head not in allowed:
|
|
584
|
+
if mode == "offline" and (head in CLOUD_CLIS or head in NETWORK_TOOLS):
|
|
585
|
+
return [f"'{head}' in offline audit ('{text}'); offline means no cloud, CLI or network call"]
|
|
586
|
+
return [f"'{head}' is not an allowed {mode} audit command ('{text}'); allowed: {' '.join(sorted(allowed))}"]
|
|
587
|
+
if head in CLOUD_CLIS:
|
|
588
|
+
return cli_problems(words)
|
|
589
|
+
if head == "curl":
|
|
590
|
+
return curl_problems(words)
|
|
591
|
+
if head == "python3":
|
|
592
|
+
return python_problems(command, mode, skill)
|
|
593
|
+
values = [word.value for word in words]
|
|
594
|
+
if head == "printf" and any(v == "-v" or v.startswith("-v") for v in values[1:2]):
|
|
595
|
+
return [f"'printf -v' assigns a variable: '{text}'"]
|
|
596
|
+
if head in {"terraform", "tofu"} and (len(values) < 2 or values[1] != "show"):
|
|
597
|
+
return [f"'{text}' can reach a provider; offline allows only '{head} show' on a saved plan"]
|
|
598
|
+
if head in {"rg", "grep"} and any(CREDENTIAL_PATTERN.search(v) for v in values[1:]) \
|
|
599
|
+
and not any(v in NAMES_ONLY or re.fullmatch(r"-[A-Za-z]*[lcq][A-Za-z]*", v) for v in values[1:]):
|
|
600
|
+
return [f"'{text}' searches for credentials and would print them; list file names only (-l)"]
|
|
601
|
+
if head == "rg" and any(v == "--pre" or v.startswith("--pre=") for v in values):
|
|
602
|
+
return [f"'rg --pre' runs a program: '{text}'"]
|
|
603
|
+
if head == "find" and FIND_BANNED & set(values):
|
|
604
|
+
return [f"find action {sorted(FIND_BANNED & set(values))} runs or deletes: '{text}'"]
|
|
605
|
+
if head == "sort" and any(v.startswith("--compress-program") for v in values):
|
|
606
|
+
return [f"'sort --compress-program' runs a program: '{text}'"]
|
|
607
|
+
if head == "git":
|
|
608
|
+
rest = values[1:]
|
|
609
|
+
while rest and rest[0] in {"-C", "--git-dir", "--work-tree", "--no-pager"}:
|
|
610
|
+
rest = rest[1:] if rest[0] == "--no-pager" else rest[2:]
|
|
611
|
+
sub = next((v for v in rest if not v.startswith("-")), "")
|
|
612
|
+
if any(v in {"-c", "--config-env"} or v.startswith("--config-env=") for v in values[1:]) \
|
|
613
|
+
or sub not in GIT_READ:
|
|
614
|
+
return [f"git must be a read subcommand ({', '.join(sorted(GIT_READ))}) without -c: '{text}'"]
|
|
615
|
+
return []
|
|
616
|
+
|
|
617
|
+
|
|
618
|
+
def fenced_blocks(text: str) -> list[tuple[str, str]]:
|
|
619
|
+
"""Every fenced code block as (language, body), at any indent and with ``` or ~~~."""
|
|
620
|
+
blocks, lines, i = [], text.splitlines(), 0
|
|
621
|
+
while i < len(lines):
|
|
622
|
+
match = re.match(r"^(\s*)(`{3,}|~{3,})\s*([^`\s]*)", lines[i])
|
|
623
|
+
if not match:
|
|
624
|
+
i += 1
|
|
625
|
+
continue
|
|
626
|
+
indent, fence, lang = len(match.group(1)), match.group(2), match.group(3).lower()
|
|
627
|
+
body, i = [], i + 1
|
|
628
|
+
while i < len(lines) and not re.fullmatch(r"\s*" + re.escape(fence[0]) + "{" + str(len(fence)) + r",}\s*",
|
|
629
|
+
lines[i]):
|
|
630
|
+
line = lines[i]
|
|
631
|
+
body.append(line[min(indent, len(line) - len(line.lstrip(" "))):])
|
|
632
|
+
i += 1
|
|
633
|
+
blocks.append((lang, "\n".join(body) + "\n"))
|
|
634
|
+
i += 1
|
|
635
|
+
return blocks
|
|
636
|
+
|
|
637
|
+
|
|
638
|
+
def shell_blocks(text: str, where: str, errors: list[str]) -> list[str]:
|
|
639
|
+
found = []
|
|
640
|
+
for lang, body in fenced_blocks(text):
|
|
641
|
+
if lang in SESSION_LANGS:
|
|
642
|
+
errors.append(f"{where}: a ```{lang} block mixes commands and output; use ```bash for commands")
|
|
643
|
+
elif lang not in DATA_LANGS:
|
|
644
|
+
found.append(body)
|
|
645
|
+
return found
|
|
646
|
+
|
|
647
|
+
|
|
648
|
+
def array_problems(blocks: list[str], aliases: dict[str, list[Word]]) -> list[str]:
|
|
649
|
+
"""A command array may appear only in its one definition and as a whole "${name[@]}"
|
|
650
|
+
head. Any other mention (name=x, name[0]=, name+=, ${name:=...}, ${name[0]}, a loop
|
|
651
|
+
or printf -v target) could change what runs, so it is rejected outright."""
|
|
652
|
+
text = "\n".join(re.sub(r"(^|\s)#.*$", r"\1", block, flags=re.MULTILINE) for block in blocks)
|
|
653
|
+
problems = []
|
|
654
|
+
for name in aliases:
|
|
655
|
+
mentions = len(re.findall(r"(?<![\w])" + name + r"(?!\w)", text))
|
|
656
|
+
allowed = text.count(name + "=(") + text.count("${" + name + "[@]}")
|
|
657
|
+
if mentions != allowed:
|
|
658
|
+
problems.append(f"array '{name}' is mentioned outside its one definition and \"${{{name}[@]}}\" "
|
|
659
|
+
"uses; command arrays may not be assigned, indexed or modified")
|
|
660
|
+
return problems
|
|
661
|
+
|
|
662
|
+
|
|
663
|
+
def sections(text: str) -> dict[str, str]:
|
|
664
|
+
starts = [m.start() for m in re.finditer(r"^## ", text, re.MULTILINE)] + [len(text)]
|
|
665
|
+
found = {}
|
|
666
|
+
for begin, end in zip(starts, starts[1:]):
|
|
667
|
+
block = text[begin:end]
|
|
668
|
+
found[block.splitlines()[0][3:].strip()] = block
|
|
669
|
+
return found
|
|
670
|
+
|
|
671
|
+
|
|
672
|
+
def check(skill_rel: str, errors: list[str]) -> None:
|
|
673
|
+
skill = REPO / skill_rel
|
|
674
|
+
pattern = skill_rel in PATTERN_SKILLS
|
|
675
|
+
skill_md = (skill / "SKILL.md").read_text(encoding="utf-8")
|
|
676
|
+
router = skill / ROUTER
|
|
677
|
+
if not router.exists():
|
|
678
|
+
errors.append(f"{skill_rel}: missing {ROUTER}")
|
|
679
|
+
return
|
|
680
|
+
if f"]({ROUTER})" not in skill_md:
|
|
681
|
+
errors.append(f"{skill_rel}: SKILL.md does not link {ROUTER}; no agent would load the audit")
|
|
682
|
+
router_text = router.read_text(encoding="utf-8")
|
|
683
|
+
if not re.search(r"\b(only|Do not read both)\b", router_text):
|
|
684
|
+
errors.append(f"{skill_rel}/{ROUTER}: must say to load only the selected variant")
|
|
685
|
+
rows = _ops.ledger_status(skill)
|
|
686
|
+
for mode, rel in VARIANTS.items():
|
|
687
|
+
where = f"{skill_rel}/{rel}"
|
|
688
|
+
path = skill / rel
|
|
689
|
+
if not path.exists():
|
|
690
|
+
errors.append(f"{where}: missing")
|
|
691
|
+
continue
|
|
692
|
+
if f"]({rel.removeprefix('references/commands/')})" not in router_text:
|
|
693
|
+
errors.append(f"{skill_rel}/{ROUTER}: does not link {rel.removeprefix('references/commands/')}")
|
|
694
|
+
if f"]({rel})" in skill_md:
|
|
695
|
+
errors.append(f"{skill_rel}: SKILL.md links {rel} directly; link only the router so variants load lazily")
|
|
696
|
+
text = path.read_text(encoding="utf-8")
|
|
697
|
+
blocks = shell_blocks(text, where, errors)
|
|
698
|
+
aliases: dict[str, list[Word]] = {}
|
|
699
|
+
for block in blocks:
|
|
700
|
+
parsed, problems = parse_block(block, aliases)
|
|
701
|
+
errors += [f"{where}: {p}" for p in problems]
|
|
702
|
+
for command in parsed:
|
|
703
|
+
errors += [f"{where}: {p}" for p in command_problems(command, mode, skill)]
|
|
704
|
+
errors += [f"{where}: {p}" for p in array_problems(blocks, aliases)]
|
|
705
|
+
for evidence in _ops.MARKER_RE.findall(text):
|
|
706
|
+
if evidence not in rows:
|
|
707
|
+
errors.append(f"{where}: {evidence} has no row in the skill's evidence ledger")
|
|
708
|
+
elif mode == "live" and rows[evidence] != "VERIFIED":
|
|
709
|
+
errors.append(f"{where}: cites {evidence}, whose ledger status is {rows[evidence]}; live commands need VERIFIED sources")
|
|
710
|
+
if pattern:
|
|
711
|
+
continue
|
|
712
|
+
if not blocks:
|
|
713
|
+
errors.append(f"{where}: needs at least one bash command block")
|
|
714
|
+
headings = [h for h in re.findall(r"^## (.+?)\s*$", text, re.MULTILINE) if h in SECTIONS]
|
|
715
|
+
if headings != SECTIONS:
|
|
716
|
+
errors.append(f"{where}: sections must be exactly {SECTIONS} in order; found {headings}")
|
|
717
|
+
continue
|
|
718
|
+
if mode == "live":
|
|
719
|
+
for title, block in sections(text).items():
|
|
720
|
+
if title not in SECTIONS:
|
|
721
|
+
continue
|
|
722
|
+
has_command = bool(shell_blocks(block, where, [])) and bool(_ops.MARKER_RE.search(block))
|
|
723
|
+
if not has_command and NO_LIVE not in block:
|
|
724
|
+
errors.append(f"{where} [{title}]: needs a cited command block or a '{NO_LIVE}' line with the reason")
|
|
725
|
+
|
|
726
|
+
|
|
727
|
+
def main() -> int:
|
|
728
|
+
errors: list[str] = []
|
|
729
|
+
for skill_rel in SKILLS:
|
|
730
|
+
check(skill_rel, errors)
|
|
731
|
+
if errors:
|
|
732
|
+
for error in errors:
|
|
733
|
+
print(f"FAIL: {error}")
|
|
734
|
+
print(f"validate-nosql-audit: {len(errors)} problem(s)")
|
|
735
|
+
return 1
|
|
736
|
+
print(f"validate-nosql-audit: OK ({len(SKILLS)} skills, offline and live audit variants)")
|
|
737
|
+
return 0
|
|
738
|
+
|
|
739
|
+
|
|
740
|
+
if __name__ == "__main__":
|
|
741
|
+
sys.exit(main())
|