Skip to content

Latest commit

 

History

History
518 lines (435 loc) · 29.4 KB

FEATURE_MATRIX.md

File metadata and controls

518 lines (435 loc) · 29.4 KB

Eggsec Feature Matrix

Maintenance model: This matrix is the canonical reference for all feature flags across the eggsec workspace. The authoritative runtime registry is feature_registry! in crates/eggsec/src/config/feature_registry.rs — this document is a human-readable rendering of that registry plus additional metadata (implied features, metadata IDs). When adding or modifying a feature, update the registry first, then update this file to match.

Fail-closed contract: Unknown feature names in policy checks return false. The feature_state() function returns FeatureState::Unknown for unrecognized names.

Scope: Covers the main eggsec crate (51 features) and domain crate features. Does not repeat domain crate internals (those are documented in their own Cargo.toml comments).


1. Feature Inventory and Classification

Categories:

Category Meaning
Protocol/front-end adapter Exposes a serving surface (REST, gRPC, WebSocket, MCP)
Domain capability Enables a domain's core functionality (scanning, assessment)
Domain protocol exposure marker Opt-in MCP/agent exposure for a domain
Report/output Adds report generation or export formats
Storage/integration Adds persistence or external service integration
Backend/driver dependency Pulls in a specific driver crate for a domain
Platform-sensitive/lab-only Requires root, CAP_NET_ADMIN, or lab-only hardware
Marker-only No dependencies; compile-time gate only

1.1 Main Crate Features

Feature Category Implied Features Declaring Crate In Defaults Affects Programmatic Exposure OperationMetadata IDs DomainDescriptor IDs
tool-api Marker-only — eggsec No Yes (required by programmatic surfaces) all all
insecure-tls Marker-only — eggsec No No — —
rest-api Protocol/front-end adapter tool-api eggsec No Yes (REST surface) all (REST-exposed) all (REST-exposed)
ws-api Protocol/front-end adapter axum/ws eggsec No Yes (WebSocket surface) all all
grpc-api Protocol/front-end adapter tool-api eggsec No Yes (gRPC surface) all (gRPC-exposed) all (gRPC-exposed)
stress-testing Domain capability pnet, pnet_packet, socket2, nix, libc, surge-ping, eggsec-nse?/stress-testing eggsec No No stress-test —
packet-inspection Domain capability pnet, pnet_packet, libc eggsec No No packet —
nse Domain capability tool-api, pinned external eggsec-nse eggsec No No (manual/TUI only) nse —
nse-ssh2 Backend/driver dependency nse, ssh2, eggsec-nse/nse-ssh2 eggsec No No nse —
nse-sandbox Domain capability nse, eggsec-nse/sandbox eggsec No No nse —
advanced-hunting Marker-only — eggsec No Yes (MCP-exposed) hunt —
compliance Marker-only — eggsec No Yes (MCP-exposed) compliance —
external-integrations Marker-only — eggsec No Yes (MCP-exposed) integrations —
finding-workflow Marker-only — eggsec No Yes (MCP-exposed) workflow —
vuln-management Marker-only — eggsec No Yes (MCP-exposed) vuln —
ai-integration Domain capability tool-api, eventsource-stream, semver eggsec No No — —
websocket Domain capability tokio-tungstenite eggsec No No — —
headless-browser Domain capability headless_chrome eggsec No Yes (MCP-exposed) browser —
database Storage/integration sqlx eggsec No Yes (MCP-exposed) storage —
db-pentest Domain capability sqlx, eggsec-db-lab, eggsec-db-lab/db-drivers eggsec No Yes (MCP via marker) db-pentest db-pentest
db-pentest-mssql-tiberius Backend/driver dependency tiberius, eggsec-db-lab/mssql eggsec No No — —
db-pentest-mongodb Backend/driver dependency mongodb, bson, eggsec-db-lab/mongodb eggsec No No — —
db-pentest-redis Backend/driver dependency redis, eggsec-db-lab/redis eggsec No No — —
db-pentest-mcp Domain protocol exposure marker db-pentest, eggsec-db-lab/mcp eggsec No Yes (MCP surface) db-pentest db-pentest
c2-mcp Domain protocol exposure marker c2 eggsec No Yes (MCP surface) c2 —
container Domain capability kube, k8s-openapi eggsec No No — —
cloud Marker-only — eggsec No No — —
sbom Report/output cyclonedx-bom, spdx, walkdir eggsec No No — —
git-secrets Marker-only — eggsec No No — —
pdf Report/output printpdf eggsec No No — —
udp-scan Platform-sensitive/lab-only eggsec-udp-scan (libc) eggsec No No — —
wireless Marker-only — eggsec No Yes (MCP-exposed) wireless —
wireless-advanced Platform-sensitive/lab-only wireless eggsec No No — —
evasion Marker-only — eggsec No No (manual/TUI only) evasion —
postex Marker-only — eggsec No No (manual/TUI only) postex —
c2 Domain capability postex, evasion eggsec No Yes (MCP via marker) c2 —
mobile Domain capability eggsec-mobile-lab, zip, plist eggsec No No (manual/TUI only) mobile-static mobile-static
mobile-dynamic Domain capability mobile, eggsec-mobile-lab/mobile-dynamic eggsec No No mobile-dynamic mobile-dynamic
api-schema Marker-only — eggsec No No — —
web-proxy Domain capability eggsec-web-proxy, tokio-tungstenite, h2, http, prost, prost-types eggsec No Yes (MCP via marker) proxy-intercept —
web-proxy-mcp Domain protocol exposure marker web-proxy, eggsec-web-proxy/web-proxy-mcp eggsec No Yes (MCP surface) proxy-intercept —
transparent-proxy Domain capability web-proxy, eggsec-web-proxy/transparent-proxy eggsec No No — —
dynamic-plugins Domain capability web-proxy, eggsec-web-proxy/dynamic-plugins eggsec No No — —
email-notifications Process-host adapter lettre eggsec No No — —
logging-subscriber Process-host adapter tracing-subscriber, tracing-appender eggsec No No — —
cli Process-host adapter clap, clap_complete eggsec Yes No — —
config-watch Process-host adapter notify, notify-debouncer-mini eggsec No No — —
full Meta/aggregate (developer/lab) see Cargo.toml eggsec No No — —

1.1a Daemon Crate Features

Feature Category Implied Features Declaring Crate In Defaults Notes
http-api Protocol/front-end adapter axum, async-stream, futures eggsec-daemon No HTTP/SSE transport for daemon (loopback-only default bind)
full-executor Execution adapter dep:eggsec eggsec-daemon No Real task execution via EggsecRuntimeExecutor (enforcement + dispatch). Without this flag, the daemon uses a conservative capability set by default (safe subset only, excluding hazardous task families) unless no-op stub is used.

Daemon capability profiles:

Profile Description Hazardous Tasks
full() All 30 task kinds (requires full-executor) Included
conservative() Safe subset only (default when full-executor is enabled but lab mode is not configured) Excluded (stress, packet, wireless-deauth, postex, c2, evasion)
noop() No task kinds (no full-executor feature) None

1.1b CLI Crate Features

eggsec-cli has 38 features. Three are local to the binary shell; the rest are thin pass-throughs that forward an engine feature (and, where a TUI feature exists, eggsec-tui?<feature>). crates/eggsec-cli/Cargo.toml is canonical.

Feature Category Implied Features Declaring Crate In Defaults Notes
tui Protocol/front-end adapter dep:eggsec-tui eggsec-cli Yes Terminal UI adapter
daemon-client Protocol/front-end adapter dep:eggsec-daemon, dep:eggsec-daemon-protocol, dep:tokio-util, eggsec/daemon-client eggsec-cli No Daemon client CLI commands
headless Marker-only — eggsec-cli No Headless/CI builds (no TUI, no daemon client)

Pass-throughs to the engine (each also forwards to eggsec-tui? when a matching TUI feature exists): nse, headless-browser, compliance, database, external-integrations, finding-workflow, vuln-management, wireless, wireless-advanced, mobile, mobile-dynamic, stress-testing, packet-inspection, udp-scan, advanced-hunting, tool-api, rest-api, ai-integration, websocket, grpc-api, ws-api, container, sbom, cloud, git-secrets, pdf, api-schema, insecure-tls.

mobile, db-pentest, web-proxy, evasion, postex, c2, db-pentest-mcp, web-proxy-mcp, c2-mcp, nse-ssh2, nse-sandbox, compliance-adjacent platform modes, transparent-proxy, and dynamic-plugins are not re-exported by eggsec-cli; enable them on the engine directly.

1.2 Domain Crate Features

Crate Feature Category Implies Notes
Standalone eggsec-nse nse Domain capability — Lua VM for NSE script execution
Standalone eggsec-nse nse-ssh2 Backend/driver dependency nse, ssh2 SSH2/libssh2-backed NSE support
Standalone eggsec-nse sandbox Domain capability — Restrict dangerous Lua operations
Standalone eggsec-nse stress-testing Domain capability — NSE stress-testing primitives
eggsec-db-lab db-drivers Domain capability — Core DB pentest driver abstractions
eggsec-db-lab mssql Backend/driver dependency — Real MSSQL client (tiberius)
eggsec-db-lab mongodb Backend/driver dependency — Real MongoDB client
eggsec-db-lab redis Backend/driver dependency — Real Redis client
eggsec-db-lab mcp Domain protocol exposure marker — MCP tool registration for db-pentest
eggsec-web-proxy web-proxy Domain capability — Core HTTP/HTTPS/WebSocket proxy
eggsec-web-proxy web-proxy-mcp Domain protocol exposure marker — MCP tool registration for web-proxy
eggsec-web-proxy transparent-proxy Domain capability — iptables/nftables REDIRECT mode
eggsec-web-proxy dynamic-plugins Domain capability — Dynamic plugin loading from .so/.dylib
eggsec-mobile-lab mobile-dynamic Domain capability — ADB + logcat + Frida runtime testing

Knowledge-corpus leaves — near-empty-dependency data crates reached only through the engine's pub use facades (scanner::service_data, recon::secrets, fuzzer::payloads, plus the udp-scan feature gate). The seam is one-directional: the corpus owns data, the engine owns I/O. eggsec-service-db, eggsec-secrets, and eggsec-payloads are unconditional engine dependencies (not feature-gated); eggsec-udp-scan is behind the udp-scan feature. None of the four declares a test-util feature. Deep dive: architecture/knowledge_corpus.md.

1.3 Defaults

The engine default feature set is default = [] (empty library default, Phase E WS2: no process-host capability). CLI types and command dispatch are opt-in via cli (enabled explicitly by eggsec-cli, eggsec-tui, and daemon full-executor). The full meta-feature is a curated developer/lab aggregate of 28 pinned members — not an exhaustive "enable everything" flag. Its exact membership is declared once in FULL_MEMBERS (crates/eggsec/src/config/feature_registry.rs) and checked against the full = [...] array in crates/eggsec/Cargo.toml; every excluded feature carries a machine-checked reason in FULL_EXCLUDED_WITH_REASON. Users build with explicit feature flags, the full lab aggregate, or the exhaustive per-feature sweep (make check-features-individual).

The eggsec-cli crate has default = ["tui"]. Build with --no-default-features for headless usage, or --no-default-features --features daemon-client for daemon client mode.


2. Feature Naming Conventions

Pattern Convention Examples
Base domain feature <domain> db-pentest, mobile, wireless, web-proxy, nse, udp-scan
Protocol exposure marker <domain>-mcp db-pentest-mcp, web-proxy-mcp, c2-mcp
Backend driver <domain>-<backend> db-pentest-mongodb, db-pentest-redis
Advanced extension <domain>-advanced wireless-advanced
Platform-sensitive driver <domain>-<driver> db-pentest-mssql-tiberius (pure-Rust TDS)
Meta/aggregate full Curated lab aggregate (28 pinned members; see §1.3)

Naming consistency: All features follow these patterns consistently. No deviations observed.


3. Build Profiles and Test Matrix

3.1 Profiles

minimal — No default features

cargo check -p eggsec --no-default-features
cargo test --lib -p eggsec --no-default-features

manual-standard — CLI/TUI plus standard manual workflows (default build)

cargo build --release -p eggsec-cli
cargo test --lib -p eggsec
cargo clippy --lib -p eggsec

protocol — Tool API plus REST/gRPC/WebSocket

cargo check -p eggsec --features rest-api
cargo check -p eggsec --features grpc-api
cargo check -p eggsec --features ws-api
cargo test --lib -p eggsec --features rest-api
cargo test --lib -p eggsec --features grpc-api

Requires system deps: grpc-api needs the protobuf compiler. The generated Rust proto code is checked in, so only descriptor regeneration requires protoc.

database-lab — Database domain and selected driver features

cargo check -p eggsec --features db-pentest
cargo check -p eggsec --features db-pentest,db-pentest-mssql-tiberius
cargo check -p eggsec --features db-pentest,db-pentest-mongodb
cargo check -p eggsec --features db-pentest,db-pentest-redis
cargo check -p eggsec --features db-pentest,db-pentest-mcp
cargo test --lib -p eggsec --features db-pentest
cargo test -p eggsec-db-lab

mobile-lab — Mobile static and optional dynamic runtime workflows

cargo check -p eggsec --features mobile
cargo check -p eggsec --features mobile-dynamic
cargo test --lib -p eggsec --features mobile
cargo test --lib -p eggsec --features mobile-dynamic
cargo test -p eggsec-mobile-lab

proxy-lab — Web proxy domain and optional protocol exposure marker

cargo check -p eggsec --features web-proxy
cargo check -p eggsec --features web-proxy-mcp
cargo test --lib -p eggsec --features web-proxy
cargo test -p eggsec-web-proxy

advanced-lab — Explicitly opt-in advanced/lab-only features

cargo check -p eggsec --features wireless
cargo check -p eggsec --features wireless-advanced
cargo check -p eggsec --features evasion
cargo check -p eggsec --features postex
cargo check -p eggsec --features c2
cargo check -p eggsec --features stress-testing
cargo check -p eggsec --features nse
cargo test --lib -p eggsec --features wireless
cargo test --lib -p eggsec --features evasion
cargo test --lib -p eggsec --features postex
cargo test --lib -p eggsec --features c2
cargo test --lib -p eggsec --features stress-testing
cargo test -p eggsec --features nse,cli --test nse_tests --test nse_integration_tests
# Runtime-owned checks run in https://github.com/eggstack/eggsec-nse/actions.

docs-metadata — Broad metadata/doc validation without heavy optional dependencies

cargo check --workspace --no-default-features
cargo test -p eggsec --test metadata_consistency

full — Curated developer/lab aggregate (not a production profile)

The full meta-feature enables 28 pinned members, including advanced/lab-only capabilities (wireless-advanced, evasion, postex, c2, mobile-dynamic). It deliberately excludes test-only markers (test-helpers), security-risk flags (insecure-tls), protocol exposure markers (*-mcp, which stay opt-in while their base domains are aggregated), backend drivers (db-pentest-mongodb, db-pentest-mssql-tiberius, db-pentest-redis), platform modes (nse-ssh2, nse-sandbox, udp-scan), separate serving surfaces (grpc-api, ws-api), special output/plugin modes (pdf, transparent-proxy, dynamic-plugins), deferred marker gates (api-schema, cloud, git-secrets, daemon-client), and the implicit base (tool-api, transitively enabled via rest-api/nse/ai-integration). The complete exclusion table with reasons is FULL_EXCLUDED_WITH_REASON (crates/eggsec/src/config/feature_registry.rs); the exhaustive oracle is make check-features-individual. It is intended for development, integration testing, and explicit lab builds. full is not a conservative user/default profile and should not be recommended for production or standard deployment.

cargo check -p eggsec --features full
cargo test --lib -p eggsec --features full

cli-headless — Headless CLI (no TUI, no daemon client)

cargo check -p eggsec-cli --no-default-features
cargo test -p eggsec-cli --no-default-features

cli-daemon-client — Daemon client CLI commands

cargo check -p eggsec-cli --no-default-features --features daemon-client
cargo test -p eggsec-cli --no-default-features --features daemon-client

daemon-http — Daemon with HTTP/SSE transport

cargo check -p eggsec-daemon --features http-api
cargo test -p eggsec-daemon --features http-api

daemon-full-executor — Daemon with real task execution

cargo check -p eggsec-daemon --features full-executor
cargo test -p eggsec-daemon --features full-executor

3.2 System Dependency Requirements

Profile Required System Dep Install (Debian/Ubuntu)
packet-inspection libpcap-dev apt install libpcap-dev
nse libssl-dev apt install libssl-dev
nse-ssh2 libssh2-dev apt install libssh2-dev
wireless / wireless-advanced wireless-tools (iwlist) apt install wireless-tools
grpc-api protobuf-compiler apt install protobuf-compiler
mobile-dynamic ADB + Android device Android SDK Platform Tools
stress-testing Raw sockets CAP_NET_RAW or root

4. Feature-to-Metadata Cross-Reference

Feature OperationMetadata IDs DomainDescriptor IDs Programmatic Exposure
rest-api all REST-exposed ops all REST-exposed domains Yes (REST server)
grpc-api all gRPC-exposed ops all gRPC-exposed domains Yes (gRPC server)
ws-api all ops (WebSocket transport) — Yes (WebSocket server)
nse nse — No (manual/TUI only)
db-pentest db-pentest db-pentest Yes (via db-pentest-mcp)
db-pentest-mcp db-pentest db-pentest Yes (MCP surface)
c2 c2 — Yes (via c2-mcp)
c2-mcp c2 — Yes (MCP surface)
web-proxy proxy-intercept — Yes (via web-proxy-mcp)
web-proxy-mcp proxy-intercept — Yes (MCP surface)
wireless wireless — Yes (MCP-exposed)
wireless-advanced wireless-deauth — No (manual/TUI only)
mobile mobile-static mobile-static No (manual/TUI only)
mobile-dynamic mobile-dynamic mobile-dynamic No (lab-only)
advanced-hunting hunt — Yes (MCP-exposed)
headless-browser browser — Yes (MCP-exposed)
compliance compliance — Yes (MCP-exposed)
database storage — Yes (MCP-exposed)
external-integrations integrations — Yes (MCP-exposed)
finding-workflow workflow — Yes (MCP-exposed)
vuln-management vuln — Yes (MCP-exposed)
stress-testing stress-test — No
packet-inspection packet — No
evasion evasion — No (manual/TUI only)
postex postex — No (manual/TUI only)
container — — No
sbom — — No
pdf — — No
cloud — — No
git-secrets — — No
api-schema — — No
tool-api all all Required base
insecure-tls — — No
ai-integration — — No
websocket — — No
transparent-proxy — — No
dynamic-plugins — — No
db-pentest-mssql-tiberius — — No
db-pentest-mongodb — — No
db-pentest-redis — — No
nse-ssh2 — — No
nse-sandbox — — No

5. Safety Invariants

  1. Feature presence is not authorization. Runtime policy (EnforcementContext) is always required before dispatch. Enabling db-pentest does not grant permission to run database pentests — --allow-db-pentest and scope rules are mandatory.

  2. The full meta-feature is a developer/lab aggregate, not a safe default. It includes advanced features like wireless-advanced, evasion, postex, and c2. Standard deployment should use explicit feature flags. full is for development, integration testing, and lab builds.

  3. Protocol exposure markers are opt-in. db-pentest-mcp, web-proxy-mcp, and c2-mcp are not defaults and are not included in any base profile. Domains are standalone defense-lab surfaces unless the marker is explicitly enabled.

  4. Domain base features are clearly distinguished from protocol exposure features. A domain's core capability (e.g., db-pentest) and its MCP exposure marker (e.g., db-pentest-mcp) are separate features. The base feature enables the domain; the marker registers it with MCP/agent surfaces.

  5. Strict profiles never honor manual overrides. MCP, REST, gRPC, and agent surfaces use EnforcementContext::evaluate() as a mandatory pre-dispatch gate. Warn and RequireConfirmation outcomes are denied in strict mode.

  6. Marker-only features have no dependencies. Features like advanced-hunting, compliance, wireless, evasion, postex, and cloud are compile-time gates only. They do not pull optional crates and are safe for all build environments.

  7. Backend driver features require the base domain feature. db-pentest-mongodb is a no-op without db-pentest. The main crate enforces this via dep: syntax and domain crate feature forwarding.


6. Python Bindings (eggsec-python)

The eggsec-python crate provides PyO3/maturin Python bindings. Its feature flags mirror engine features via Cargo forwarding — enabling web-proxy in Python compiles the same eggsec features as cargo check -p eggsec --features web-proxy.

6.1 Feature-to-Python Mapping

Python Feature Engine Feature Stability Notes
full-no-system aggregate — websocket, git-secrets, sbom, container (no system deps)
websocket websocket provisional WebSocket security testing
git-secrets git-secrets provisional Git secret detection
sbom sbom provisional SBOM generation
db-pentest db-pentest provisional Database pentest (requires eggsec-db-lab)
db-pentest-mongodb db-pentest-mongodb provisional MongoDB pentest
db-pentest-redis db-pentest-redis provisional Redis pentest
web-proxy web-proxy experimental Web proxy MITM (requires eggsec-web-proxy)
mobile mobile provisional APK/IPA static analysis
mobile-dynamic mobile-dynamic experimental Android dynamic testing (requires ADB)
packet-inspection packet-inspection experimental Packet capture (parser-only on most platforms)
stress-testing stress-testing experimental Stress testing (raw sockets, root required)
nse nse provisional Nmap NSE scripts (requires eggsec-nse)
container container provisional K8s/Docker scanning
daemon-client — provisional Daemon session access (no engine feature)
headless-browser headless-browser experimental Headless browser testing (requires Chromium)
advanced-hunting advanced-hunting experimental Advanced vulnerability hunting
compliance — provisional Compliance framework mapping
wireless wireless experimental WiFi scanning (requires wireless-tools, root)
evasion evasion experimental Evasion technique detection
postex postex experimental Post-exploitation simulation
c2 c2 experimental C2 framework simulation
ai-integration ai-integration experimental AI-assisted finding analysis
external-integrations external-integrations experimental External issue-tracker integrations

Default wheel: core + scanner + endpoint discovery + service fingerprinting + recon + WAF + reporting + async API. full aggregate is the curated 28-member engine lab set (not conservative/production).

6.2 Operation Stability Matrix

Operation Function Sync Async Engine Dispatch Policy Events Cancellation Stability
Port scan scan_ports ✓ ✓ ✓ ✓ ✓ ✓ stable
Endpoint scan scan_endpoints ✓ ✓ ✓ ✓ ✓ ✓ stable
Fingerprint fingerprint_services ✓ ✓ ✓ ✓ ✓ ✓ stable
DNS recon recon_dns ✓ ✓ ✓ ✓ — — stable
TLS inspect inspect_tls ✓ ✓ ✓ ✓ — — stable
Tech detect detect_technology ✓ ✓ ✓ ✓ — — stable
WAF detect detect_waf ✓ ✓ ✓ ✓ — — stable
WAF validate validate_waf ✓ ✓ ✓ ✓ — ✓ stable
HTTP fuzz fuzz_http ✓ ✓ ✓ ✓ — ✓ stable
Load test load_test_http ✓ ✓ ✓ ✓ ✓ ✓ stable
Consolidated recon run_consolidated_recon ✓ ✓ ✓ ✓ — — stable
GraphQL test graphql_test ✓ ✓ ✓ ✓ — — stable
OAuth test oauth_test ✓ ✓ ✓ ✓ — — stable
Auth test auth_test ✓ ✓ ✓ ✓ — — stable
DB probe db_probe ✓ ✓ — ✓ — — stable
APK analyze analyze_apk ✓ ✓ — ✓ — — stable
Docker scan scan_docker_image ✓ ✓ — ✓ — — stable
NSE run nse_run ✓ ✓ — ✓ — — stable
Traceroute run_traceroute ✓ ✓ — ✓ — — provisional
Daemon connect daemon_connect — ✓ — — ✓ — provisional
Wireless scan wireless_scan ✓ ✓ — ✓ — — experimental
Evasion scan evasion_scan ✓ ✓ — ✓ — — experimental
Postex scan postex_scan ✓ ✓ — ✓ — — experimental
C2 scan c2_scan ✓ ✓ — ✓ — — experimental
Browser test browser_test ✓ ✓ — ✓ — — experimental
Hunt test hunt_test ✓ ✓ — ✓ — — experimental
AI analyze ai_analyze_finding ✓ ✓ — ✓ — — experimental
Stress test stress_test ✓ ✓ — ✓ — — experimental
Mobile dynamic dynamic_mobile_analysis — ✓ — ✓ — — experimental

Updating This Document

This document is manually maintained. When adding or modifying a feature:

  1. Update [features] in crates/eggsec/Cargo.toml
  2. Register the feature in feature_registry! (crates/eggsec/src/config/feature_registry.rs) — unknown feature names resolve to FeatureState::Unknown and policy checks fail closed
  3. Update OperationMetadata in crates/eggsec-policy/src/catalog.rs (if operation-related). crates/eggsec/src/config/policy_catalog.rs and config/policy.rs are facades over eggsec-policy, not the source of truth.
  4. Update DomainDescriptor in crates/eggsec/src/domain/mod.rs (if domain-related)
  5. Run cargo test --lib -p eggsec to verify metadata consistency
  6. Update this file to reflect the new feature (category, dependencies, metadata IDs, etc.)
  7. Run cargo test -p eggsec --test metadata_consistency to validate cross-references
  8. Run make check-features-individual — the exhaustive per-feature oracle
  9. If Python bindings are affected, update [features] in crates/eggsec-python/Cargo.toml and Section 6 above. The extras source of truth is [project.optional-dependencies] in crates/eggsec-python/pyproject.toml, not the Cargo table.