mirror of https://github.com/SHOGGOTH-SECTOR/sica-fondt.git synced 2026-08-01 08:30:20 +00:00

Consolidate 22 sibling repos into layered organism structure

Place useful parts of the surrounding repos into sica-fondt by layer, per the
body model (Ada = membrane; brain/endocrine/capabilities/knowledge non-Ada):

- brain/        LLM reasoning + providers (dapr, hermes, MoMoA)
- capabilities/ REPRAG sidecars: hermes tools/skills, dapr tools, parallel
                dispatch, A51 channels, and the OSINT cluster
- knowledge/    LORAG corpus: 754 cyber-skills, agency personas, secure-coding,
                MITRE ATT&CK data
- reference/    defensive threat-reference (C3, shhbruh doc) + AdaYaml parser

License handling: AGPL sources (worldosint, advanced_evolution, mercury,
Reticulum) and GPL DeTTECT are SPEC-only clean-room/port descriptions — no
copyleft code copied. MIT/Apache/data parts copied as working trees.

Safety: shhbruh escape/persistence material and C3 covert-C2 kept as reference
only, not wired into the running organism. See CONSOLIDATION.md.

https://claude.ai/code/session_01UehUqEXXJJCsHoA4voCU5c

2026-06-10 06:53:01 +00:00

1.7 KiB

Raw Blame History

API Reference: Cloud Security Posture Management Agent

Dependencies

Library	Version	Purpose
boto3	>=1.28	AWS SDK for Security Hub findings and compliance
prowler	>=4.0	Open-source cloud security scanner (optional, via subprocess)

CLI Usage

python scripts/agent.py \
  --profile security-audit \
  --region us-east-1 \
  --output-dir /reports/ \
  --output cspm_report.json

Functions

`get_securityhub_client(profile, region)`

Creates boto3 Security Hub client.

`get_findings_summary(client, max_results) -> dict`

Calls client.get_findings() filtered to NEW/ACTIVE findings, groups by severity.

`get_compliance_summary(client) -> list`

Calls client.get_enabled_standards() then describe_standards_controls() per standard. Returns compliance percentages.

`run_prowler_scan(profile, region) -> dict`

Executes prowler aws --output-formats json via subprocess with 10-minute timeout.

`generate_report(client, profile, region) -> dict`

Combines Security Hub and Prowler results into unified CSPM report.

boto3 Security Hub Methods

Method	Purpose
`get_findings(Filters, MaxResults)`	Retrieve active findings
`get_enabled_standards()`	List enabled compliance standards
`describe_standards_controls(StandardsSubscriptionArn)`	Control-level compliance

Output Schema

{
  "summary": {"finding_counts": {"CRITICAL": 3, "HIGH": 12}, "total_findings": 45},
  "compliance_standards": [{"standard": "cis-aws-foundations-benchmark", "compliance_pct": 78.5}],
  "recommendations": ["Remediate 3 CRITICAL findings immediately"]
}

1.7 KiB Raw Blame History