> ## Documentation Index
> Fetch the complete documentation index at: https://harisfazillah.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# HOWTO: hibernation - Legacy Safety Verifier

> OKF-compliant documentation for HOWTO-HIBERNATION.md. Deep State of Mind framework. Deep State of Mind framework. Deep State of Mind framework.

# docs/tools/HOWTO-HIBERNATION.md

> **Standard: DSOM For My AI Protocol v6.1 | Core Framework**
> **Tools:** `hibernation.ps1`, `hibernation.sh`
> **Platforms:** Windows Native (T1), Linux/WSL2 (T2)

***

## 1. Purpose

The `hibernation` scripts function as safety gates that strictly prohibit the termination of a computing cycle until certain cognitive markers are recorded in the AI’s memory bank. If an AI or human fails to populate `.agents/brain/task.md` or anchor the session properly in `.agents/brain/walkthrough.md`, the repository refuses to enter a valid shutdown state.

**Location:**

* `tools/hibernation.ps1`
* `tools/hibernation.sh`

***

## 2. Prerequisites

| Requirement        | Minimum          | Notes                                              |
| :----------------- | :--------------- | :------------------------------------------------- |
| Structural Context | `task.md`        | Required to test presence of completed `[x]`.      |
| Structural Context | `walkthrough.md` | Required to scan for `YYYY-MM-DD` literal anchors. |

***

## 3. Usage

```powershell theme={null}
.\tools\hibernation.ps1

```

```bash theme={null}
bash tools/hibernation.sh

```

***

## 4. Reading the Output & Status Codes

| Output Keyword            | Meaning                          | Action Needed                                                          |
| :------------------------ | :------------------------------- | :--------------------------------------------------------------------- |
| `[OK] Progress detected`  | Brain state verified.            | Proceed to EOD push.                                                   |
| `[ERR] No Session Anchor` | AI missed the semantic tracking. | Open `walkthrough.md` and explicitly add `## Mental Anchor -- [Date]`. |
| `HIBERNATION BLOCKED`     | Hard fatal failure exit code 1.  | Read errors above to remediate environment.                            |

***

## 5. Integration with the Daily Rituals

> \[!WARNING]\
> If you are utilizing the advanced spatial navigation protocol (**Palace v1.0**), you primarily do *not* need to run this tool standalone. The `tools/eod-palace.ps1` routines automatically bundle the hibernation safety checkpoints natively inside their operation flow.

Only use `hibernation.sh` directly if you operate in environments pre-dating Palace (e.g. legacy DSOM framework integrations).

***

## 6. Related Documents

| Document                                  | Purpose                                            |
| :---------------------------------------- | :------------------------------------------------- |
| [`HOWTO-EOD-PALACE.md`](HOWTO-EOD-PALACE) | Modern EOD wrapper encompassing Hibernation logic. |

***

*Standard: DSOM For My AI Protocol v6.1 | Palace v1.0 | Harisfazillah Jamel*
*Document Version: v1.0 | Created: 2026-04-08*

***

*Deep State of Mind (DSOM) For My AI Protocol | Harisfazillah Jamel (LinuxMalaysia) | 2026-07-04*
*Standard: UK English | DBP-standard Bahasa Melayu Malaysia (Piawai) | GNU General Public License v3.0*


## Related topics

- [🌙 EOD-RITUAL.md - End-of-Day Ritual](/rituals/end-of-day.md)
- [HOWTO: sod-palace - Start-of-Day Ritual](/tools/howto-sod-palace.md)
- [📖 DSOM Operational Guide (Level 3 - Specialised Tasks)](/governance/operational-guide.md)
- [Automation & Script Audit Ledger](/governance/automation-audit-list.md)
- [🌐 OpenWiki Integration Blueprint & Native Python Emulator Architecture](/governance/openwiki-integration-guide.md)
