agent_context.json

{
  "name": "br-scratch-keepalive",
  "purpose": "Manage large BR200 scratch datasets with resumable keepalive refresh runs.",
  "disclaimer": "Experimental only. Use entirely at your own risk. You are solely responsible for any loss of data, deletion, corruption, missed refreshes, or other consequences arising from use or non-use of this package. Not for production or real-world operational use. Not an endorsed IU/UITS/BR200 workflow. Not intended to override, bypass, or work around normal scratch-storage deletion policy.",
  "execution_model": {
    "where_to_run": "Inside a BR200 shell session",
    "not_supported": [
      "Running from a local laptop shell against BR200 over SSH alias assumptions",
      "Making scratch archival"
    ]
  },
  "defaults": {
    "profile": "br200",
    "refresh_days": 14,
    "min_refresh_days": 14,
    "partition": "general",
    "cpus": 1,
    "mem": "2G",
    "time_limit": "2:00:00"
  },
  "state": {
    "registry": "Persistent state outside scratch",
    "checkpoints": "Persistent resumable refresh state outside scratch",
    "logs": "Persistent logs outside scratch",
    "sentinel": "A small tool-owned file in the dataset root"
  },
  "core_commands": [
    "scratch-keepalive init --profile br200",
    "scratch-keepalive add --name <name> --path /N/scratch/$USER/... --keep-until YYYY-MM-DD",
    "scratch-keepalive refresh --name <name>",
    "scratch-keepalive install-cron",
    "scratch-keepalive status --name <name>",
    "scratch-keepalive doctor"
  ],
  "scheduler_behavior": {
    "preferred": "scrontab",
    "fallback": "self-resubmitting Slurm job when scrontab is disabled"
  },
  "safety_rules": [
    "Only manage paths under /N/scratch/$USER for the br200 profile",
    "Never delete dataset contents",
    "Treat scratch keepalive as best-effort, not guaranteed persistence",
    "Do not configure BR200 refresh intervals below 14 days",
    "Do not use the tool to evade, bypass, or test the limits of IU or BR200 policy",
    "If site administrators prohibit this workflow, do not use it"
  ]
}