blueprint-sync

Blueprint Sync — Detect Untracked Files

Scan the project filesystem and sync .omniscitus/blueprints/ with reality. Finds user-created files that hooks missed, marks deleted files, and fills empty purpose fields.

When to Use

• User types /blueprint-sync
• User says "sync blueprints", "파일 동기화"
• You notice blueprints might be stale

Instructions

Step 1: Check Prerequisites

If .omniscitus/blueprints/ directory doesn't exist, create it:

mkdir -p .omniscitus/blueprints

Migration: If a legacy .omniscitus/blueprints.yaml (single file) exists, migrate it:

1. Read and parse the single file
2. Group entries by top-level directory (root-level files → _root)
3. Write each group to .omniscitus/blueprints/{dir}.yaml
4. Delete the legacy .omniscitus/blueprints.yaml

Step 2: Scan Filesystem

Use git ls-files to get all tracked (non-ignored) files. This automatically respects .gitignore at all levels (root and nested):

git ls-files --cached --others --exclude-standard \
  | grep -v '^\.omniscitus/' \
  | sort

If not a git repo, fall back to:

find . -type f \
  -not -path "./.git/*" \
  -not -path "./node_modules/*" \
  -not -path "./.omniscitus/*" \
  -not -path "./.next/*" \
  -not -path "./dist/*" \
  -not -path "./build/*" \
  -not -path "./__pycache__/*" \
  -not -path "./.vercel/*" \
  -not -name "*.lock" \
  -not -name ".DS_Store" \
  | sort

Step 3: Compare with Blueprints

Read all .omniscitus/blueprints/*.yaml files. Merge them into a single map for comparison.

Blueprint file mapping rule: A file's blueprint is determined by its top-level directory:

• src/utils/auth.ts → blueprints/src.yaml
• plugins/omniscitus/server.js → blueprints/plugins.yaml
• README.md (root-level) → blueprints/_root.yaml

For each file on disk:

Not in any blueprint → New user-created file. Add to the correct per-directory blueprint with:

• status: active
• source: user:{git user.name} (run git config user.name to get the identity)
• created: from git log --format="%ai" --diff-filter=A -- "{file}" | tail -1 or today
• purpose: ""
• change_count: from git log --oneline -- "{file}" | wc -l