> ## 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.

# DSOM State Sync Skill

> Executes Semantic Compaction locally by analyzing a Git diff and updating current_state.dsom using OpenAI. Deep State of Mind framework.

## Purpose

This skill allows AI agents to manually execute the **Semantic Compaction** process outside of the standard GitHub Actions PR workflow. It analyzes a provided diff file and uses an LLM to condense and append significant architectural changes into the project's compressed memory tier (`.agents/brain/current_state.dsom`).

## Prerequisites

1. **Python & `uv`**: The `uv` package manager must be available on the system.
2. **Gemini API Key (Optional)**: The environment variable `GEMINI_API_KEY` or `GOOGLE_API_KEY` can be set in the executing terminal to leverage the Gemini AI API for compaction. If neither credential is set, the system automatically falls back to a zero-API local Semantic Compaction engine.
3. **Diff File**: A valid Git diff file or text file containing changes must be prepared.

## Execution Flow

When tasked with running the state sync locally, execute the following terminal command (ensure you replace `<diff_file>` with the actual path to your diff):

```bash theme={null}
uv run --with requests==2.34.2 --with pyyaml==6.0.3 .github/scripts/action_update_dsom.py <diff_file> .agents/brain/current_state.dsom
```

### Execution Rules

1. **Never write the API key to disk**: If the API key is not present in the environment, instruct the human operator to export it manually in their terminal session before proceeding.
2. **Review before execution**: Generate the diff file locally first (e.g., `git diff > local.diff`) and verify its contents to prevent bloating the compaction prompt with irrelevant artifact changes.
3. **Verify Timestamp**: After successful execution, check `.agents/brain/current_state.dsom` to ensure the `timestamp` in the OKF frontmatter was correctly updated.

***

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


## Related topics

- [DSOM Automated State Sync](/governance/dsom-automated-state-sync.md)
- [sod-palace-sync](/skills/sod-palace-sync.md)
- [Google Jules & Google Antigravity Collaborative Sync](/skills/jules-antigravity-sync.md)
- [eod-palace-sync](/skills/eod-palace-sync.md)
- [Mintlify MDX Compiler & One-Way Sync](/skills/mintlify-docs-compiler.md)