> ## 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: checkpoint - Quick Sync

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

# docs/tools/HOWTO-CHECKPOINT.md

> **Standard: DSOM For My AI Protocol v6.1 | Palace v1.0 | GitOps**
> **Tools:** `checkpoint.ps1`, `checkpoint.sh`, `playbooks/dsom/checkpoint-palace.yml`
> **Platforms:** Windows Native (T1), Linux/WSL2 (T2)

***

## 1. Purpose

The `checkpoint` tool is the **agile mid-task preservation algorithm**. While the formal `eod-palace` ritual restricts and gates git commits behind rigid checklist compliance, the checkpoint workflow allows humans and AIs to dump work-in-progress directly into remote servers rapidly.

**Automated steps performed:**

1. Triggers `palace-sync` to parse the git log without forcing a pause or waiting for user interaction.
2. Identifies all currently tracked modifications. Commits them independently safely as `chore(checkpoint): modified tracked files`.
3. Identifies absolutely all untracked configurations. Generates an independent boundary commit `chore(checkpoint): untracked new files`.
4. Executes `git push origin main`.

**Location:**

* `tools/checkpoint.ps1` (Native Windows)
* `tools/checkpoint.sh` (Proxy wrapper)
* `playbooks/dsom/checkpoint-palace.yml` (Ansible)

***

## 2. Prerequisites

| Requirement | Minimum        | Notes                                                                                      |
| :---------- | :------------- | :----------------------------------------------------------------------------------------- |
| Safe state  | Compiling Code | Even though testing is skipped, do not drop a checkpoint that bricks the framework syntax. |

***

## 3. Usage

```powershell theme={null}

# Windows (T1)

.\tools\checkpoint.ps1

```

```bash theme={null}

# WSL2 / Linux (T2)

bash tools/checkpoint.sh

```

***

## 4. Reading the Output & Status Codes

| Event Message                        | Meaning                                   |
| :----------------------------------- | :---------------------------------------- |
| `Committed tracked modifications`    | Previously watched files were updated.    |
| `Committed untracked configurations` | Brand new `.md` or scripts were included. |

*(The script gracefully handles entirely clean workspaces without throwing git or PowerShell null-value execution exceptions.)*

***

## 5. Integration with the Daily Rituals

Use this continuously every 60-90 minutes throughout active development. Since checkpoint operations securely bundle Palace update proposals alongside them recursively, you can run multiple checkpoints safely without disrupting the final End-of-Day Palace reconciliation phase.

***

## 6. Related Documents

| Document                                       | Purpose                                                               |
| :--------------------------------------------- | :-------------------------------------------------------------------- |
| [`HOWTO-EOD-PALACE.md`](HOWTO-EOD-PALACE)      | Use EOD at the absolute end of the human sequence.                    |
| [`HOWTO-PALACE-SYNC.md`](HOWTO-PALACE-SYNC.md) | Details how the background Palace proposal is continuously merged in. |

***

*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-palace-sync](/skills/eod-palace-sync.md)
- [sod-palace-sync](/skills/sod-palace-sync.md)
- [🧠 Deep State of Mind (DSOM) For My AI Protocol](/core-concepts.md)
- [DSOM Quick Start: From Clone to Cognitive Handshake](/quickstart.md)
- [HOWTO: hibernation - Legacy Safety Verifier](/tools/howto-hibernation.md)