> ## 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: palace-sync - Kingdom Spatial Mapping

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

# docs/tools/HOWTO-PALACE-SYNC.md

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

***

## 1. Purpose

`palace-sync` is the **Spatial Parser** of the Sovereign Markdown Palace. It bridges the gap between raw Git commits and high-density cognitive closets. By analyzing the path of changed files in git, it automatically maps updates to the correct "Room" in the Palace hierarchy.

**Use it to:**

* Automatically categorize git history since the last sync.
* Generate a **Palace Update Proposal** for AI review.
* Perform a full-history backfill to populate a new Palace from scratch.
* Maintain the spatial integrity of the `wings/` directory.

**Location:**

* `tools/palace-sync.ps1` (Windows)
* `tools/palace-sync.sh` (Linux/WSL2)

***

## 2. Prerequisites

| Requirement    | Minimum               | Notes                                              |
| :------------- | :-------------------- | :------------------------------------------------- |
| Protocol Level | Palace v1.0           | Requires the `wings/` directory structure.         |
| Sync Marker    | `.palace-sync-marker` | Automatically created to track the last sync date. |
| Closets        | `closet.md`           | Rooms must have a closet file to receive updates.  |

***

## 3. Usage

### 3.1 Incremental Sync (EOD Fashion)

```powershell theme={null}
.\tools\palace-sync.ps1

```

```bash theme={null}
bash tools/palace-sync.sh

```

Analyzes commits since the date stored in `.palace-sync-marker`. Used during every End-of-Day ritual.

### 3.2 Full History Backfill

```powershell theme={null}
.\tools\palace-sync.ps1 -Backfill

```

```bash theme={null}
bash tools/palace-sync.sh --backfill

```

Scans the **entire git history** from the first commit. Essential for onboarding an existing repository into the Palace architecture.

***

## 4. Reading the Output & Status Codes

| Label                                | Meaning                           | Action                                          |
| :----------------------------------- | :-------------------------------- | :---------------------------------------------- |
| `✅ No new commits`                   | The Palace is already up to date. | None needed.                                    |
| `📝 Building Proposal`               | Mapping detected changes.         | Wait for the generator to finish.               |
| `📄 File: palace_update_proposal...` | Success.                          | Share this file with the AI for closet updates. |

***

## 5. Implementation Logic (Path Mapping)

The tool uses regex patterns to map files to Rooms:

| Path                   | Wing             | Hall          | Room                    |
| :--------------------- | :--------------- | :------------ | :---------------------- |
| `playbooks/`, `roles/` | `wing_dsom_core` | `hall_events` | `room_sovereign_fabric` |
| `.agents/brain/`       | `wing_dsom_core` | `hall_events` | `room_brain_artifacts`  |
| `tools/`               | `wing_dsom_core` | `hall_facts`  | `room_tooling`          |
| `docs/`                | `wing_dsom_core` | `hall_facts`  | `room_dsom_protocol`    |
| `CHANGELOG.md`         | `wing_dsom_core` | `hall_events` | `room_ledger`           |

***

## 6. Related Documents

| Document                                                        | Purpose                                     |
| :-------------------------------------------------------------- | :------------------------------------------ |
| [`docs/HOWTO-PALACE-ONBOARDING.md`](../HOWTO-PALACE-ONBOARDING) | Guide for first-time Palace setup.          |
| [`docs/MIRROR-OF-KNOWLEDGE.md`](../MIRROR-OF-KNOWLEDGE.md)      | Understanding the underlying memory theory. |

***

*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

- [HOWTO: sod-palace - Start-of-Day Ritual](/tools/howto-sod-palace.md)
- [eod-palace-sync](/skills/eod-palace-sync.md)
- [HOWTO: eod-palace - End-of-Day Saves](/tools/howto-eod-palace.md)
- [🏛️ Digital Sovereignty Operational Model (DSOM)](/governance/digital-sovereignty-model.md)
- [[AGENT] DSOM Cognitive Digital Twin: Project Operational Protocol (v2.0)](/governance/ai-cognitive-twin-protocol.md)