@raishin/vanguard-frontier-agentic 1.2.0 → 1.4.0

package/skills/oci/oci-certificates-issuer-review/references/workflow-and-output.md

@@ -0,0 +1,207 @@
+# Workflow and Output Contract
+
+## Review Workflow
+
+### Step 1 — Identify the CA and issuer configuration
+
+Retrieve the OCI cert-manager issuer resource:
+
+```bash
+kubectl get issuer -A -o yaml | grep -A20 "oci\|oracle"
+kubectl get clusterissuer -o yaml | grep -A20 "oci\|oracle"
+```
+
+Extract the CA OCID from the issuer spec. Then inspect the CA in OCI:
+
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid>
+```
+
+Key fields to check:
+- `type` — must be `SUBORDINATE` (not `ROOT`)
+- `lifecycleState` — must be `ACTIVE`
+- `issuerCertificateAuthorityId` — should reference a ROOT CA that is itself INACTIVE or not used for direct issuance
+
+### Step 2 — Validate CA type (root vs subordinate)
+
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid> \
+  --query data.config-type \
+  --raw-output
+```
+
+Expected values:
+- `SUBORDINATE_CA_ISSUED_BY_INTERNAL_CA` — correct for cert-manager usage
+- `ROOT_CA_GENERATED_INTERNALLY` — CRITICAL finding; root directly exposed to cert-manager
+
+Also check the issuer CA's status:
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid> \
+  --query data.lifecycle-state \
+  --raw-output
+```
+
+### Step 3 — Review issuance rules
+
+List issuance rules configured on the CA:
+
+```bash
+oci certs-mgmt certificate-authority get \
+  --certificate-authority-id <ca-ocid> \
+  --query "data.certificate-authority-rules"
+```
+
+Check for:
+
+```json
+{
+  "ruleType": "CERTIFICATE_AUTHORITY_MAX_VALIDITY_RULE",
+  "certificateMaxValidityDuration": "P90D"
+}
+```
+
+And key algorithm restriction:
+
+```json
+{
+  "ruleType": "CERTIFICATE_AUTHORITY_ISSUANCE_EXPIRY_RULE",
+  "leafCertificateMaxValidityDuration": "P90D",
+  "certificateAuthorityMaxValidityDuration": "P3650D"
+}
+```
+
+**Flags:**
+- No issuance rules configured (no validity cap) — MEDIUM (cert-manager can issue 10-year workload certs)
+- Max validity > 365d for leaf certificates — MEDIUM
+- No key algorithm restriction — MEDIUM (RSA-1024 issuance possible)
+
+### Step 4 — Identify authentication method
+
+Check the cert-manager configuration for OCI auth method:
+
+```bash
+# Check if OKE Workload Identity is configured
+kubectl get serviceaccount cert-manager -n cert-manager \
+  -o jsonpath='{.metadata.annotations}'
+```
+
+For OKE Workload Identity, the ServiceAccount should have OCI annotations:
+
+```yaml
+annotations:
+  oci.oraclecloud.com/role-binding: "<dynamic-group-name>"
+```
+
+For Instance Principal auth, check if the cert-manager pod uses the instance metadata endpoint:
+
+```bash
+# Check the cert-manager deployment for OCI config
+kubectl get deployment cert-manager -n cert-manager -o yaml | grep -i "oci\|instance\|workload"
+```
+
+**Auth method comparison:**
+
+| Method | Scope | Risk |
+|--------|-------|------|
+| OKE Workload Identity | ServiceAccount-bound (pod-level) | Correct — minimum scope |
+| Instance Principal | Node-level (all pods on node) | HIGH — any pod can issue certs |
+| User auth (API key) | User credentials in secret | HIGH — credential rotation required |
+
+### Step 5 — Review IAM policy
+
+Retrieve the IAM policy for cert-manager:
+
+```bash
+oci iam policy list --compartment-id <compartment-id> --all \
+  --query "data[?contains(statements[0], 'certificate-authority')]"
+```
+
+Minimum required policy statement:
+
+```
+Allow dynamic-group CertManagerDynamicGroup to use certificate-authorities
+  in compartment <compartment-name>
+  where request.permission='CREATE_CERTIFICATE_REQUEST'
+```
+
+**Flag as HIGH if the policy includes any of:**
+- `manage certificate-authorities` (grants delete, update, disable, schedule-deletion)
+- `manage certificates` without compartment scoping (affects all certs)
+- Wildcard resources or compartment `tenancy` instead of scoped compartment
+
+Additional permissions needed for cert-manager to retrieve issued certs:
+
+```
+Allow dynamic-group CertManagerDynamicGroup to read certificates
+  in compartment <compartment-name>
+```
+
+### Step 6 — Check OCSP reachability
+
+The OCI OCSP endpoint is `ocsp.pki.oraclecloud.com`. Verify reachability from OKE worker nodes:
+
+```bash
+# From within an OKE node or debug pod
+curl -sv https://ocsp.pki.oraclecloud.com/
+```
+
+For OKE clusters with no internet gateway or restrictive security group rules:
+
+```bash
+# Check security list / NSG rules for outbound HTTPS to OCI OCSP
+oci network security-list list --vcn-id <vcn-id> \
+  --query "data[].egress-security-rules[]"
+```
+
+OCI OCSP endpoints use HTTPS (443). Ensure the OKE worker node security group allows outbound TCP/443 to OCI service endpoints. Using a Service Gateway with the `OCI Services in Oracle Services Network` service covers OCI PKI endpoints.
+
+**Flags:**
+- No Service Gateway configured and no internet gateway (OCI OCSP unreachable) — MEDIUM
+- Security group blocks TCP/443 outbound to OCI service network — MEDIUM
+
+### Step 7 — Review certificate version count
+
+```bash
+oci certs-mgmt certificate list-certificate-versions \
+  --certificate-id <cert-ocid> \
+  --all \
+  --query "length(data)"
+```
+
+Each cert rotation by cert-manager creates a new version. Old versions should be cleaned up to avoid high version counts.
+
+**Flags:**
+- Certificate version count > 10 — LOW (storage cost and management overhead)
+- No automated cleanup of old versions configured — LOW
+
+---
+
+## Output Format
+
+### Finding: `<short title>`
+
+| Field | Value |
+|-------|-------|
+| Severity | CRITICAL / HIGH / MEDIUM / LOW |
+| Resource | CA OCID, IAM policy name, or cert name |
+| Evidence | documentation-based / live evidence / inference |
+| Description | What is wrong and its impact on PKI trust |
+| Remediation | OCI CLI command, IAM policy statement, or configuration change |
+
+---
+
+### Overall OCI PKI Trust Posture
+
+| Category | Status |
+|----------|--------|
+| CA hierarchy (subordinate only) | PASS / FAIL |
+| Issuance rules (validity caps) | PASS / FAIL |
+| Authentication method (Workload Identity) | PASS / FAIL |
+| IAM policy scope (minimum permissions) | PASS / FAIL |
+| OCSP reachability | PASS / FAIL |
+| Certificate version lifecycle | PASS / FAIL |
+
+**Verdict:** TRUSTED / UNTRUSTED / CONDITIONAL (list conditions)

package/skills/oci/oci-cloud-guard-responder/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-cloud-guard-responder
 description: Triage and govern OCI Cloud Guard problems, targets, responder recipes, detector findings, and security remediation safely. Use for Cloud Guard reviews, problem prioritization, remediation planning, and compliance evidence when official Oracle MCP tools or documentation fallback are needed.
+allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: security
 ---
 
 # OCI Cloud Guard Responder

package/skills/oci/oci-compute-instance-agent-operator/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-compute-instance-agent-operator
 description: Operate OCI Compute Instance Agent commands and executions safely for diagnostics, automation, and remediation. Use when issuing, tracking, or reviewing instance-agent commands across compute fleets.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: platform
 ---
 
 # OCI Compute Instance Agent Operator

package/skills/oci/oci-compute-platform-operator/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-compute-platform-operator
 description: Operate OCI Compute instances and platform capacity safely with compartment/region confirmation, instance lifecycle guardrails, least-privilege IAM checks, MCP/CLI discovery, and rollback-aware change plans.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: platform
 ---
 
 # OCI Compute Platform Operator

package/skills/oci/oci-cost-finops-analyst/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-cost-finops-analyst
 description: "Analyze Oracle Cloud Infrastructure cost, usage, budgets, tagging, rightsizing, commitment coverage, and FinOps governance. Use when asked to explain OCI spend, investigate cost spikes, build savings plans, review underused resources, design chargeback/showback, or challenge cost-optimization assumptions without breaking reliability."
+allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: finops
 ---
 
 # OCI Cost FinOps Analyst

package/skills/oci/oci-database-platform-dba/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-database-platform-dba
 description: Operate as a ruthless OCI database platform DBA for DB systems, Autonomous Database, Exadata, backups, patching, performance triage, capacity, and IAM-scoped database operations. Use when work touches OCI Database service posture, discovery, troubleshooting, change review, or least-privilege access.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: data
 ---
 
 # OCI Database Platform DBA

package/skills/oci/oci-dbtools-sql-analyst/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-dbtools-sql-analyst
 description: Use OCI Database Tools and database documentation safely for SQL inspection, report definitions, table metadata, and controlled query execution. Use for DBTools connections, read-only SQL analysis, and schema/report exploration.
+allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: data
 ---
 
 # OCI Database Tools SQL Analyst

package/skills/oci/oci-devops-container-platform-engineer/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-devops-container-platform-engineer
 description: "Engineer and review Oracle Cloud Infrastructure DevOps, OKE, OCIR, build/deploy pipelines, Kubernetes platform, and container runtime workflows. Use when asked to inspect OCI Container Engine clusters, DevOps projects, OCIR repositories, CI/CD IAM, deployment safety, cluster operations, image promotion, or container platform reliability."
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: platform
 ---
 
 # OCI DevOps Container Platform Engineer

package/skills/oci/oci-exadata-database-architect/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-exadata-database-architect
 description: Design, review, migrate, and operate Oracle Exadata Database Service across OCI Dedicated Infrastructure, Exascale Infrastructure, Cloud@Customer, and Oracle Database multicloud destinations including Azure, Google Cloud, and AWS, with official-doc grounding.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: data
 ---
 
 # OCI Exadata Database Architect

package/skills/oci/oci-exadata-platform-architect/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-exadata-platform-architect
 description: OCI Design and operate Exadata Database Service across OCI Dedicated Infrastructure, Exadata Cloud@Customer, Oracle Database@Azure, Oracle Database@Google Cloud, and Oracle Database@AWS. Use for Exadata architecture, VM clusters, cloud Exadata infrastructure, Exascale, RAC, Data Guard, backup, migration, compatibility, capacity, network, and multicloud destination reviews.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: platform
 ---
 
 # OCI Exadata Platform Architect

package/skills/oci/oci-fusion-apps-environment-operator/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-fusion-apps-environment-operator
 description: OCI Review Fusion Apps as a Service environment families, environments, lifecycle status, availability, and operational readiness. Use for Fusion environment inventory, status checks, change planning, and support evidence.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: platform
 ---
 
 # OCI Fusion Apps Environment Operator

package/skills/oci/oci-goldengate-replication-operator/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-goldengate-replication-operator
 description: OCI Operate and review Oracle GoldenGate domains, connections, extracts, replicats, checkpoint tables, trails, distribution paths, and replication health. Use for replication setup, lag triage, data movement, and cutover safety.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: data
 ---
 
 # OCI GoldenGate Replication Operator

package/skills/oci/oci-identity-access-governor/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-identity-access-governor
 description: Govern OCI Identity and Access Management with least-privilege policy review, compartment scoping, group/dynamic-group analysis, and safe access-change workflows. Use for OCI IAM policy design, access audits, privilege reduction, identity troubleshooting, or destructive-access risk review.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: compliance
 ---
 
 # OCI Identity Access Governor

package/skills/oci/oci-iot-digital-twin-engineer/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-iot-digital-twin-engineer
 description: Design and operate OCI IoT digital twin adapters, models, instances, relationships, and domain context. Use for digital twin topology, lifecycle, integration, and safe model/relationship changes.
+allowed-tools: Read Grep Glob
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: ai
 ---
 
 # OCI IoT Digital Twin Engineer

package/skills/oci/oci-limits-capacity-planner/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-limits-capacity-planner
 description: Review OCI service limits, quotas, capacity availability, regional subscriptions, and growth risk. Use before deployments, migrations, DR expansion, shape changes, OKE scaling, database scaling, or quota increase requests.
+allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: github: Raishin
   version: 0.1.0
+  updated: "2026-05-05"
+  category: platform
 ---
 
 # OCI Limits Capacity Planner

package/skills/oci/oci-live-autonomous-db-lifecycle-guard/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-live-autonomous-db-lifecycle-guard
 description: Guard Autonomous Database lifecycle changes — scale, start, stop, clone, terminate — with protection-tag enforcement, backup verification, and connection-string impact analysis before any mutation.
+allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: "github: Raishin"
   version: "0.1.0"
+  updated: "2026-05-05"
+  category: data
 ---
 
 # OCI Live Autonomous DB Lifecycle Guard

package/skills/oci/oci-live-cost-budget-runaway-guard/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-live-cost-budget-runaway-guard
 description: Gate OCI budget mutations and GPU/HPC shape provisioning against compartment spend limits, with inventory searches, quota audits, and emergency spend-stop playbooks.
+allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: "github: Raishin"
   version: "0.1.0"
+  updated: "2026-05-05"
+  category: finops
 ---
 
 # OCI Live Cost Budget Runaway Guard

package/skills/oci/oci-live-iam-policy-compartment-guard/SKILL.md

@@ -1,9 +1,12 @@
 ---
 name: oci-live-iam-policy-compartment-guard
 description: Guard OCI IAM policy writes and dynamic group changes with verb-hierarchy audit, compartment scope enforcement, anti-pattern detection (any-user/any-group), and rollback via statement restore.
+allowed-tools: Read Grep Glob WebFetch
 metadata:
   author: "github: Raishin"
   version: "0.1.0"
+  updated: "2026-05-05"
+  category: security
 ---
 
 # OCI Live IAM Policy Compartment Guard

package/skills/oci/oci-live-network-security-rule-guard/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: oci-live-network-security-rule-guard
+description: Guard live OCI Security List and Network Security Group (NSG) rule changes with current-state capture, open-internet and sensitive-port detection, stateful/stateless assessment, and explicit approval before ingress or egress rule mutation. Use only when an intentional network rule change targets a confirmed VCN component.
+allowed-tools: Read Grep Glob WebFetch
+metadata:
+  author: "github: Raishin"
+  version: "0.1.0"
+  updated: "2026-05-05"
+  category: security
+---
+
+# OCI Live Network Security Rule Guard
+
+## Purpose
+
+Act as the guarded live OCI operator for oci-live-network-security-rule-guard work. Security List and NSG rule changes take effect immediately with no native rollback. A wrong ingress rule exposes databases or compute to the internet instantly; a wrong egress rule can black-hole traffic for entire subnets. Treat every rule mutation as irreversible until the previous state is explicitly captured and restoration is confirmed possible.
+
+## When to use
+
+Use this skill when:
+
+- an ingress or egress rule must be added, modified, or removed from an OCI Security List or NSG in a live VCN
+- a network access audit finds over-broad CIDR blocks (`0.0.0.0/0`) or sensitive-port exposures that must be tightened
+- a workload migration requires opening or closing ports and the blast radius must be confirmed before write
+
+## Lean operating rules
+
+- Prefer OCI CLI (`oci`) official documentation when available; fall back to Oracle Cloud docs and sanitized user evidence.
+- Do not execute any Security List or NSG rule mutation until tenancy, compartment, VCN OCID, target Security List or NSG OCID, and exact rule change are all explicit.
+- Capture the complete current rule set (`oci network security-list get` or `oci network nsg rules list`) as rollback evidence before any write.
+- Flag the following as high-severity and require explicit justification before proceeding:
+  - Any ingress rule with source `0.0.0.0/0` (open to internet)
+  - Any egress rule with destination `0.0.0.0/0` and protocol `all` without restriction
+  - Rules permitting port 22 (SSH), 3389 (RDP), 1521/1522 (Oracle DB), 3306 (MySQL), 5432 (PostgreSQL) from `0.0.0.0/0`
+  - Stateless rules on subnets hosting databases or internal APIs (no connection tracking = asymmetric traffic risk)
+  - Changes to Security Lists attached to database subnets (Autonomous DB, Exadata, DB System)
+- If the request skips current-state capture, CIDR scope confirmation, or subnet-criticality assessment, push back.
+- Never print API signing keys, auth tokens, tenancy OCIDs, or instance credentials. Summarize sanitized evidence only.
+- Load references only when needed.
+
+## References
+
+Load these only when needed:
+
+- [Preflight commands](references/preflight-commands.md) — OCI CLI commands to inspect current rules and capture rollback state before any mutation.
+- [Rollback playbook](references/rollback-playbook.md) — how to restore a previous Security List or NSG rule set after a bad change.
+- [Permission model](references/permission-model.md) — least-privilege IAM policy for network rule mutation and read-only audit.
+- [Official sources](references/official-sources.md) — authoritative OCI documentation links.
+
+## Response minimum
+
+Return, at minimum:
+
+- confirmed tenancy, compartment, VCN, and target Security List or NSG OCID
+- current rule set capture (rollback baseline)
+- risk classification of the proposed rule (open-internet / sensitive-port / safe)
+- stateful vs stateless assessment and subnet criticality
+- approval status with explicit business justification
+- rollback command to restore prior rule state
+- post-change connectivity verification steps or refusal reason

package/skills/oci/oci-live-network-security-rule-guard/metadata.json

@@ -0,0 +1,28 @@
+{
+  "id": "oci-live-network-security-rule-guard",
+  "name": "OCI Live Network Security Rule Guard",
+  "type": "skill",
+  "provider": "oci",
+  "harnesses": [
+    "codex",
+    "claude-code",
+    "cursor",
+    "gemini",
+    "kiro",
+    "other"
+  ],
+  "summary": "Guard live OCI Security List and NSG rule changes with current-state capture, open-internet and sensitive-port detection, stateful/stateless assessment, and explicit approval before ingress or egress mutation.",
+  "source_type": "original",
+  "official_docs": [
+    "https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/securitylists.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/networksecuritygroups.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/manage-nsg-security-rules.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/update-securitylist.htm",
+    "https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/path_analyzer.htm"
+  ],
+  "security_notes": "oci network security-list update is a full replace — always capture the complete current rule set before writing. Never approve 0.0.0.0/0 ingress rules on database subnets. Prefer NSGs over Security Lists for production database VNICs to minimize blast radius. Enable VCN Flow Logs before any rule change for forensic coverage.",
+  "last_verified": "2026-05-01",
+  "path": "skills/oci/oci-live-network-security-rule-guard",
+  "author": "github: Raishin",
+  "version": "0.1.0"
+}

package/skills/oci/oci-live-network-security-rule-guard/references/official-sources.md

@@ -0,0 +1,21 @@
+# Official Sources
+
+Load these only when needed:
+
+- [Security Lists](https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/securitylists.htm) — use for Security List model, ingress/egress rule structure, stateful vs stateless semantics, and maximum rule limits.
+- [Network Security Groups](https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/networksecuritygroups.htm) — use for NSG model, VNIC-level vs subnet-level application, and NSG vs Security List trade-offs.
+- [Managing NSG Security Rules](https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/manage-nsg-security-rules.htm) — use for `oci network nsg rules add`, `update`, `remove`, and `list` CLI syntax.
+- [Updating a Security List](https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/update-securitylist.htm) — use for `oci network security-list update` full-replace semantics and required parameters.
+- [Network Path Analyzer](https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/path_analyzer.htm) — use for simulating end-to-end network paths through Security Lists, NSGs, route tables, and gateways before approving a rule change.
+- [VCN Flow Logs](https://docs.oracle.com/en-us/iaas/Content/Network/Concepts/vcn-flow-logs.htm) — use when enabling forensic coverage for a subnet before or after a security rule change.
+- [OCI IAM Policy Reference — Network](https://docs.oracle.com/en-us/iaas/Content/Identity/Reference/networkpolicyreference.htm) — use for least-privilege IAM policy statements covering `security-lists`, `network-security-groups`, and `virtual-network-family`.
+
+## Grounded insights worth carrying into the skill
+
+- `oci network security-list update` performs a **full replace** of the entire ingress or egress rule set — partial updates are not possible. Always pass the complete desired rule list including rules you want to keep.
+- OCI Security Lists are **stateful by default** (`stateless: false`). Return traffic is automatically allowed. Stateless rules require explicit return rules and are a common source of asymmetric traffic failures.
+- NSG rule IDs are required for deletion (`oci network nsg rules remove`). Capture rule IDs from `oci network nsg rules list` before any mutation.
+- A Security List is attached to a subnet, not a VNIC. One change affects every instance in that subnet simultaneously — blast radius scales with subnet size.
+- NSGs are attached to individual VNICs, giving finer-grained control but requiring per-VNIC management. Prefer NSGs for production database servers over Security Lists for reduced blast radius.
+- VCN Flow Logs must be explicitly enabled per subnet — they are not on by default. Without them, there is no record of traffic through an accidentally opened rule.
+- The `0.0.0.0/0` ingress source in OCI context still includes traffic from peered VCNs, DRG-attached networks, and FastConnect circuits if routing allows — it is never safe to assume it means "internet only."

package/skills/oci/oci-live-network-security-rule-guard/references/permission-model.md

@@ -0,0 +1,65 @@
+# Permission Model: OCI Live Network Security Rule Guard
+
+## Least-privilege IAM policy for network rule read (preflight only)
+
+```
+Allow group NetworkAuditors to read virtual-network-family in compartment <compartment>
+Allow group NetworkAuditors to read vcns in compartment <compartment>
+Allow group NetworkAuditors to read security-lists in compartment <compartment>
+Allow group NetworkAuditors to read network-security-groups in compartment <compartment>
+Allow group NetworkAuditors to read subnets in compartment <compartment>
+Allow group NetworkAuditors to read db-systems in compartment <compartment>
+Allow group NetworkAuditors to read autonomous-databases in compartment <compartment>
+```
+
+Read-only audit: use `inspect` or `read` verbs only. Never `manage` for auditors.
+
+## Least-privilege IAM policy for network rule mutation (guarded operator only)
+
+```
+Allow group NetworkOperators to manage security-lists in compartment <compartment>
+Allow group NetworkOperators to manage network-security-groups in compartment <compartment>
+Allow group NetworkOperators to read vcns in compartment <compartment>
+Allow group NetworkOperators to read subnets in compartment <compartment>
+```
+
+Do **not** grant `manage virtual-network-family` — that is broader than needed and includes VCN, route tables, internet gateways, and peering.
+
+## Risk classification by rule type
+
+| Rule | Risk | Reason |
+|---|---|---|
+| Ingress `0.0.0.0/0` any protocol | Critical | Open internet access to entire subnet |
+| Ingress `0.0.0.0/0` port 22 | Critical | SSH from internet — never acceptable in production |
+| Ingress `0.0.0.0/0` port 3389 | Critical | RDP from internet — never acceptable in production |
+| Ingress `0.0.0.0/0` port 1521/1522 | Critical | Oracle DB from internet — data exfiltration path |
+| Ingress `0.0.0.0/0` port 3306/5432 | Critical | MySQL/PostgreSQL from internet |
+| Ingress from VCN CIDR, specific port | Low | Internal only — verify VCN CIDR is not transit-routed |
+| Egress `0.0.0.0/0` all | Medium | Standard but verify no data-loss risk for DB subnets |
+| Stateless rule on DB subnet | High | No connection tracking — asymmetric TCP risk |
+
+## Stateful vs stateless
+
+- **Stateful** (default, `stateless: false`): OCI tracks connection state and automatically allows return traffic. Use for all production workloads.
+- **Stateless** (`stateless: true`): Higher performance, but return traffic requires an explicit rule in the opposite direction. A missing return rule silently drops responses. Only use when performance benchmarked at scale.
+
+## Subnet criticality classification
+
+| Subnet pattern | Classification |
+|---|---|
+| Hosts Autonomous DB, DB System, Exadata | Database — highest protection |
+| Hosts compute instances with public IP | Public compute — ingress rules must be minimal |
+| Private subnet (`prohibit-public-ip: true`) | Internal — `0.0.0.0/0` still covers all VCN-routed traffic |
+| Bastion subnet | Bastion — SSH/RDP ingress from known CIDRs only |
+
+## OCI Network Path Analyzer — preferred verification tool
+
+Before approving a connectivity change, use Path Analyzer to simulate the traffic path:
+```bash
+oci network path-analyzer-test create \
+  --compartment-id <COMPARTMENT_OCID> \
+  --protocol-parameters '{"type":"TCP","destinationPort":<PORT>}' \
+  --source-endpoint '{"type":"COMPUTE_INSTANCE","instanceId":"<INSTANCE_OCID>"}' \
+  --destination-endpoint '{"type":"IP_ADDRESS","address":"<DEST_IP>"}'
+```
+Path Analyzer respects Security Lists, NSGs, route tables, and service gateways — use it as the final approval gate for any rule change.