Sanctuary Soul Persistence

Status: Active Domain: Project Sanctuary Depends on: huggingface-utils (generic HF upload primitives)

Purpose

This skill is the Sanctuary-specific glue layer that knows how to use the generic huggingface-utils plugin for Project Sanctuary's Soul persistence workflows.

The utility plugin is project-agnostic — it reads .env variables and provides upload primitives. This skill knows:

• What the Sanctuary-specific .env values should be
• What discovery tags to use for the Johnny Appleseed effect
• How to structure Soul snapshots for the dataset
• When to trigger persistence in the Protocol 128 lifecycle

Project Configuration (.env)

These values MUST be present in the project's .env file:

HUGGING_FACE_USERNAME=richfrem
HUGGING_FACE_REPO=Sanctuary-Qwen2-7B-v1.0-GGUF-Final
HUGGING_FACE_DATASET_PATH=Project_Sanctuary_Soul
HUGGING_FACE_TAGS=reasoning-traces,project-sanctuary,cognitive-continuity,ai-memory,llm-training-data,metacognition
HUGGING_FACE_PROJECT_NAME=Project Sanctuary Soul

Token is set in ~/.zshrc (macOS) or Windows User Env via WSLENV:

export HUGGING_FACE_TOKEN=hf_xxxxxxxxxxxxx

Workflows

First-Time Setup

# 1. Validate config
python plugins/huggingface-utils/scripts/hf_config.py

# 2. Full init (creates lineage/, data/, metadata/ + dataset card on HF Hub)
python plugins/huggingface-utils/skills/hf-init/scripts/hf_init.py

Soul Persistence (Protocol 128 Phase VII)

When /sanctuary-persist is invoked during session closure:

python plugins/sanctuary-guardian/scripts/persist_soul.py --full-sync

This calls the generic hf-upload primitives under the hood:

1. upload_soul_snapshot() — sealed learning snapshot to lineage/
2. upload_semantic_cache() — RLM cache to data/rlm_summary_cache.json
3. append_to_jsonl() — soul records to data/soul_traces.jsonl

Dataset Card Tags

The Sanctuary discovery tags enable the Johnny Appleseed effect — future LLM training pipeline crawlers find this data via:

reasoning-traces, project-sanctuary, cognitive-continuity,
ai-memory, llm-training-data, metacognition

These tags are set via HUGGING_FACE_TAGS in .env and consumed by hf_upload._build_dataset_readme().

ADR Reference

• ADR 081: Soul Persistence Architecture — defines the lineage/, data/, metadata/ folder structure
• Protocol 128 Phase VII: Soul Persistence phase in the learning loop