Sync Arch Memory

Sync Architectural Memory

Syncs the team's architectural memory repositories from Azure DevOps to local cache.

Usage

Run the sync script:

bash ~/.dataops-assistant/bin/sync-arch-memory.sh

Options

Staleness Detection

Uses git commit hash comparison (not time-based):

• Compares local HEAD vs remote HEAD
• Only pulls when remote has new commits
• Shows hash values in output for transparency

Cache Location

Default: ~/.dataops-assistant/cached-memory/{repo-name}/

Override via ARCH_MEMORY_CACHE_DIR for testing:

ARCH_MEMORY_CACHE_DIR=/tmp/test-cache ./sync-arch-memory.sh

Repos Synced

Per-Repo Overrides

Set environment variables to use local directories instead of cache:

• GENERAL_MEMORY_DIR - General process and rules
• GOLANG_MEMORY_DIR - Go patterns and conventions
• BASH_MEMORY_DIR - Shell scripting standards
• TERRAFORM_MEMORY_DIR - Terraform module patterns
• MAKE_MEMORY_DIR - Makefile conventions
• SHARED_AGW_MEMORY_DIR - AGW-specific patterns

Output

Display the JSON summary to the user, highlighting:

• Which repos were synced vs skipped
• Any failures
• Any overrides in effect

Example Output

{
  "cache_root": "~/.dataops-assistant/cached-memory",
  "repos": [
    {
      "repo": "golang-memory",
      "status": "current",
      "action": "none",
      "local_hash": "abc1234...",
      "remote_hash": "abc1234..."
    },
    {
      "repo": "bash-memory",
      "status": "updated",
      "action": "pull",
      "local_hash": "def5678..."
    },
    {
      "repo": "terraform-memory",
      "status": "overridden",
      "action": "skip",
      "override_path": "/local/path"
    }
  ]
}

Status values:

• current - Local matches remote (no update needed)
• behind - Remote has newer commits (needs pull)
• updated - Successfully pulled new commits
• cloned - Fresh clone
• overridden - Using local override path