mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-08-01 08:30:20 +00:00
24f816b6a3
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
3.0 KiB
3.0 KiB
API Reference: Implementing Immutable Backup with Restic
Core Functions
| Function | Parameters | Returns |
|---|---|---|
init_repository(repo_url, password, s3_config) |
Repository URL, password, optional S3 credentials | Init result dict |
create_backup(repo_url, password, source_paths, tags, exclude) |
Repo, password, paths list, optional tags/excludes | Snapshot summary |
verify_backup_integrity(repo_url, password, read_data) |
Repo, password, whether to verify data blobs | Verification result |
list_snapshots(repo_url, password) |
Repo, password | Snapshot list with metadata |
apply_retention_policy(repo_url, password, keep_*) |
Repo, password, retention counts | Pruning result |
test_restore(repo_url, password, snapshot_id) |
Repo, password, snapshot to restore | Restore test result |
get_repository_stats(repo_url, password) |
Repo, password | Size, dedup ratio, file count |
S3 Object Lock Configuration
| Function | Parameters | Returns |
|---|---|---|
configure_s3_object_lock(bucket, retention_days, mode) |
Bucket name, days, COMPLIANCE or GOVERNANCE | Config result |
Restic Commands Wrapped
| Command | Description |
|---|---|
restic init |
Initialize encrypted repository |
restic backup --json |
Create snapshot with JSON progress |
restic check --read-data |
Full integrity verification |
restic snapshots --json |
List snapshots |
restic forget --prune |
Apply retention and reclaim space |
restic restore |
Extract files from snapshot |
restic stats --json |
Repository size statistics |
CLI Usage
# Initialize repository
python agent.py --repo s3:s3.amazonaws.com/my-backups --action init
# Backup with tags
python agent.py --repo s3:s3.amazonaws.com/my-backups --action backup \
--source /var/lib/postgresql /etc --tags database config
# Full pipeline: backup + verify + retention + restore test
python agent.py --repo s3:s3.amazonaws.com/my-backups --action full-pipeline \
--source /srv/data --keep-daily 7 --keep-weekly 4
Retention Policy Defaults
| Parameter | Default | Description |
|---|---|---|
keep-daily |
7 | Keep 7 daily snapshots |
keep-weekly |
4 | Keep 4 weekly snapshots |
keep-monthly |
12 | Keep 12 monthly snapshots |
keep-yearly |
2 | Keep 2 yearly snapshots |
Python Libraries
| Library | Version | Purpose |
|---|---|---|
subprocess |
stdlib | Execute restic CLI commands |
hashlib |
stdlib | SHA-256 verification of restored files |
tempfile |
stdlib | Temporary restore target directories |
json |
stdlib | Parse restic JSON output |
References
- Restic Documentation: https://restic.readthedocs.io/
- AWS S3 Object Lock: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
- resticpy Python Wrapper: https://mtlynch.github.io/resticpy/
- Veeam 3-2-1-1-0 Strategy: https://www.veeam.com/blog/321-backup-rule.html