claudeos-core 1.2.2 → 1.2.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [1.2.4] — 2026-04-03
+
+### Changed
+- **50.sync/ rules role clarified** — no longer described as "hooks fallback"; now the primary sync reminder mechanism (`npx claudeos-core refresh`)
+- All 6 pass3 templates updated to reference `npx claudeos-core refresh` instead of PostToolUse hooks
+- All 10 READMEs updated: removed "Automatic plan sync (hooks)" section, plan table now references `refresh` command
+
+### Fixed
+- **`plan-installer`**: malformed `package.json` no longer aborts entire `detectStack()` — Python, DB config, .env, and frontend config detection now continue normally
+
+### Removed
+- **Automatic hook installation removed from `init`** — `installSyncHooks()` function and `[2.5]` step removed from `cli.js`
+  - PostToolUse hooks caused instability: npx cache paths broke across environments, added latency to every Edit/Write
+  - Plan sync is now manual via `npx claudeos-core refresh` (same result, zero complexity)
+- All references to `PostToolUse`, `sync-hook`, and `.claude/settings.json` hooks removed from pass3 templates and READMEs
+
 ## [1.2.1] — 2026-04-02
 
 ### Added

package/README.de.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← Auto-Sync-Regeln
+│       └── 50.sync/                   ← Sync-Erinnerungsregeln
 │
 ├── claudeos-core/                     ← Hauptausgabeverzeichnis
 │   ├── generated/                     ← Analyse-JSON + dynamische Prompts
@@ -368,22 +368,11 @@ Explizit durch den `DO NOT Read`-Abschnitt der standard-reference Regel ausgesch
 
 | Ordner | Ausschlussgrund |
 |---|---|
-| `claudeos-core/plan/` | Master Plan Backups (~340KB). Automatisch durch Hooks synchronisiert. |
+| `claudeos-core/plan/` | Master Plan Backups (~340KB). Verwenden Sie `npx claudeos-core refresh` zur Synchronisation. |
 | `claudeos-core/generated/` | Build-Metadaten JSON. Keine Coding-Referenz. |
 | `claudeos-core/guide/` | Onboarding-Guides für Menschen. |
 | `claudeos-core/mcp-guide/` | MCP Server Dokumentation. Keine Coding-Referenz. |
 
-### Automatische Plan-Synchronisation (Hooks)
-
-Wenn Claude Code eine Standard- oder Rules-Datei bearbeitet, synchronisiert ein PostToolUse Hook automatisch den Master Plan:
-
-```
-AI bearbeitet claudeos-core/standard/10.backend-api/01.controller-patterns.md
-  → sync-hook aktualisiert automatisch plan/10.standard-master.md
-```
-
-Keine manuelle Synchronisation nötig. Der Hook wird automatisch bei `npx claudeos-core init` installiert.
-
 ---
 
 ## Täglicher Arbeitsablauf
@@ -400,7 +389,7 @@ Keine manuelle Synchronisation nötig. Der Hook wird automatisch bei `npx claude
 ### Nach manueller Bearbeitung der Standards
 
 ```bash
-# Wenn Dateien außerhalb von Claude Code bearbeitet wurden (Hooks funktionieren nur innerhalb):
+# Nach dem Bearbeiten von Standard- oder Rules-Dateien:
 npx claudeos-core refresh
 
 # Konsistenz überprüfen

package/README.es.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← Reglas de sincronización automática
+│       └── 50.sync/                   ← Reglas de recordatorio de sincronización
 │
 ├── claudeos-core/                     ← Directorio principal de salida
 │   ├── generated/                     ← JSON de análisis + prompts dinámicos
@@ -368,22 +368,11 @@ Excluidos explícitamente por la sección `DO NOT Read` de la regla standard-ref
 
 | Carpeta | Razón de exclusión |
 |---|---|
-| `claudeos-core/plan/` | Backups de Master Plan (~340KB). Auto-sincronizado por hooks. |
+| `claudeos-core/plan/` | Backups de Master Plan (~340KB). Usa `npx claudeos-core refresh` para sincronizar. |
 | `claudeos-core/generated/` | Metadatos JSON de build. No es referencia de código. |
 | `claudeos-core/guide/` | Guías de onboarding para humanos. |
 | `claudeos-core/mcp-guide/` | Docs de servidor MCP. No es referencia de código. |
 
-### Sincronización automática de Plan (hooks)
-
-Cuando Claude Code edita un archivo standard o rules, un hook PostToolUse sincroniza automáticamente el Master Plan:
-
-```
-AI edita claudeos-core/standard/10.backend-api/01.controller-patterns.md
-  → sync-hook actualiza automáticamente plan/10.standard-master.md
-```
-
-No requiere sincronización manual. El hook se instala automáticamente durante `npx claudeos-core init`.
-
 ---
 
 ## Flujo de Trabajo Diario
@@ -400,7 +389,7 @@ No requiere sincronización manual. El hook se instala automáticamente durante
 ### Después de Editar Estándares Manualmente
 
 ```bash
-# Si editaste archivos fuera de Claude Code (los hooks solo funcionan dentro de Claude Code):
+# Después de editar archivos standard o rules:
 npx claudeos-core refresh
 
 # Verifica que todo sea consistente

package/README.fr.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← Règles de synchronisation auto
+│       └── 50.sync/                   ← Règles de rappel de synchronisation
 │
 ├── claudeos-core/                     ← Répertoire principal de sortie
 │   ├── generated/                     ← JSON d'analyse + prompts dynamiques
@@ -368,22 +368,11 @@ Explicitement exclus par la section `DO NOT Read` de la règle standard-referenc
 
 | Dossier | Raison d'exclusion |
 |---|---|
-| `claudeos-core/plan/` | Sauvegardes Master Plan (~340Ko). Auto-synchronisé par hooks. |
+| `claudeos-core/plan/` | Sauvegardes Master Plan (~340Ko). Utilisez `npx claudeos-core refresh` pour synchroniser. |
 | `claudeos-core/generated/` | JSON de métadonnées build. Pas une référence de code. |
 | `claudeos-core/guide/` | Guides d'onboarding pour humains. |
 | `claudeos-core/mcp-guide/` | Docs serveur MCP. Pas une référence de code. |
 
-### Synchronisation automatique du Plan (hooks)
-
-Quand Claude Code édite un fichier standard ou rules, un hook PostToolUse synchronise automatiquement le Master Plan :
-
-```
-AI édite claudeos-core/standard/10.backend-api/01.controller-patterns.md
-  → sync-hook met à jour automatiquement plan/10.standard-master.md
-```
-
-Aucune synchronisation manuelle nécessaire. Le hook est installé automatiquement lors de `npx claudeos-core init`.
-
 ---
 
 ## Flux de Travail Quotidien
@@ -400,7 +389,7 @@ Aucune synchronisation manuelle nécessaire. Le hook est installé automatiqueme
 ### Après Modification Manuelle des Standards
 
 ```bash
-# Si vous avez édité des fichiers en dehors de Claude Code (les hooks ne fonctionnent qu'à l'intérieur) :
+# Après avoir édité des fichiers standard ou rules :
 npx claudeos-core refresh
 
 # Vérifier la cohérence

package/README.hi.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← ऑटो-सिंक rules
+│       └── 50.sync/                   ← सिंक रिमाइंडर rules
 │
 ├── claudeos-core/                     ← मुख्य आउटपुट डायरेक्टरी
 │   ├── generated/                     ← एनालिसिस JSON + डायनामिक प्रॉम्प्ट्स
@@ -368,22 +368,11 @@ standard-reference रूल के `DO NOT Read` सेक्शन द्व
 
 | फोल्डर | बाहर करने का कारण |
 |---|---|
-| `claudeos-core/plan/` | Master Plan बैकअप (~340KB)। hooks द्वारा ऑटो-सिंक। |
+| `claudeos-core/plan/` | Master Plan बैकअप (~340KB)। `npx claudeos-core refresh` से सिंक करें। |
 | `claudeos-core/generated/` | बिल्ड मेटाडेटा JSON। कोडिंग रेफरेंस नहीं। |
 | `claudeos-core/guide/` | इंसानों के लिए ऑनबोर्डिंग गाइड। |
 | `claudeos-core/mcp-guide/` | MCP सर्वर डॉक्स। कोडिंग रेफरेंस नहीं। |
 
-### ऑटोमैटिक Plan सिंक (hooks)
-
-जब Claude Code standard या rules फाइल एडिट करता है, PostToolUse hook ऑटोमैटिकली Master Plan सिंक करता है:
-
-```
-AI claudeos-core/standard/10.backend-api/01.controller-patterns.md एडिट करता है
-  → sync-hook ऑटोमैटिकली plan/10.standard-master.md अपडेट करता है
-```
-
-मैन्युअल सिंक ज़रूरी नहीं। hook `npx claudeos-core init` के दौरान ऑटोमैटिकली इंस्टॉल होता है।
-
 ---
 
 ## दैनिक वर्कफ़्लो
@@ -400,7 +389,7 @@ AI claudeos-core/standard/10.backend-api/01.controller-patterns.md एडिट
 ### स्टैंडर्ड्स मैन्युअली एडिट करने के बाद
 
 ```bash
-# Claude Code के बाहर फाइल एडिट की है तो (hooks सिर्फ़ Claude Code के अंदर काम करते हैं):
+# standard या rules फाइल एडिट करने के बाद:
 npx claudeos-core refresh
 
 # सब कुछ कंसिस्टेंट है वेरिफाई करें

package/README.ja.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← 自動同期ルール
+│       └── 50.sync/                   ← 同期リマインダールール
 │
 ├── claudeos-core/                     ← メイン出力ディレクトリ
 │   ├── generated/                     ← 分析 JSON + 動的プロンプト
@@ -368,22 +368,11 @@ standard-reference ルールの `DO NOT Read` セクションで明示的に除
 
 | フォルダ | 除外理由 |
 |---|---|
-| `claudeos-core/plan/` | Master Plan バックアップ（~340KB）。hooks で自動同期。 |
+| `claudeos-core/plan/` | Master Plan バックアップ（~340KB）。`npx claudeos-core refresh` で同期。 |
 | `claudeos-core/generated/` | ビルドメタデータ JSON。コーディング参照不要。 |
 | `claudeos-core/guide/` | 人間向けオンボーディングガイド。 |
 | `claudeos-core/mcp-guide/` | MCP サーバードキュメント。コーディング参照不要。 |
 
-### 自動 Plan 同期（hooks）
-
-Claude Code が standard や rules ファイルを編集すると、PostToolUse hook が自動的に Master Plan を同期します：
-
-```
-AI が claudeos-core/standard/10.backend-api/01.controller-patterns.md を編集
-  → sync-hook が自動的に plan/10.standard-master.md を更新
-```
-
-手動同期は不要です。hook は `npx claudeos-core init` 時に自動インストールされます。
-
 ---
 
 ## 日常ワークフロー
@@ -400,7 +389,7 @@ AI が claudeos-core/standard/10.backend-api/01.controller-patterns.md を編集
 ### 標準ファイルを手動編集した後
 
 ```bash
-# Claude Code の外部でファイルを編集した場合（hooks は Claude Code 内でのみ動作）：
+# standard や rules ファイルを編集した後：
 npx claudeos-core refresh
 
 # 整合性を検証

package/README.ko.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← 자동 동기화 규칙
+│       └── 50.sync/                   ← 동기화 리마인더 규칙
 │
 ├── claudeos-core/                     ← 메인 출력 디렉토리
 │   ├── generated/                     ← 분석 JSON + 동적 프롬프트
@@ -386,22 +386,11 @@ standard-reference 규칙의 `DO NOT Read` 섹션으로 명시적으로 제외
 
 | 폴더 | 제외 이유 |
 |---|---|
-| `claudeos-core/plan/` | Master Plan 백업 (~340KB). hooks로 자동 동기화. |
+| `claudeos-core/plan/` | Master Plan 백업 (~340KB). `npx claudeos-core refresh`로 동기화. |
 | `claudeos-core/generated/` | 빌드 메타데이터 JSON. 코딩 참조 아님. |
 | `claudeos-core/guide/` | 사람을 위한 온보딩 가이드. |
 | `claudeos-core/mcp-guide/` | MCP 서버 문서. 코딩 참조 아님. |
 
-### 자동 Plan 동기화 (hooks)
-
-Claude Code가 standard나 rules 파일을 수정하면, PostToolUse hook이 자동으로 Master Plan을 동기화합니다:
-
-```
-AI가 claudeos-core/standard/10.backend-api/01.controller-patterns.md 수정
-  → sync-hook이 자동으로 plan/10.standard-master.md 업데이트
-```
-
-수동 동기화 불필요. hook은 `npx claudeos-core init` 시 자동 설치됩니다.
-
 ---
 
 ## 일상 워크플로우
@@ -418,7 +407,7 @@ AI가 claudeos-core/standard/10.backend-api/01.controller-patterns.md 수정
 ### 표준을 직접 편집한 후
 
 ```bash
-# Claude Code 밖에서 파일을 수정한 경우 (hooks는 Claude Code 안에서만 동작):
+# standard나 rules 파일을 수정한 후:
 npx claudeos-core refresh
 
 # 전체 일관성 확인

package/README.md

@@ -301,7 +301,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← Auto-sync rules
+│       └── 50.sync/                   ← Sync reminder rules
 │
 ├── claudeos-core/                     ← Main output directory
 │   ├── generated/                     ← Analysis JSON + dynamic prompts
@@ -399,22 +399,11 @@ These folders are explicitly excluded via the `DO NOT Read` section in the stand
 
 | Folder | Why excluded |
 |---|---|
-| `claudeos-core/plan/` | Master Plan backups (~340KB). Auto-synced by hooks. |
+| `claudeos-core/plan/` | Master Plan backups (~340KB). Use `npx claudeos-core refresh` to sync. |
 | `claudeos-core/generated/` | Build metadata JSON. Not for coding. |
 | `claudeos-core/guide/` | Onboarding guides for humans. |
 | `claudeos-core/mcp-guide/` | MCP server docs. Not for coding. |
 
-### Automatic plan sync (hooks)
-
-When Claude Code edits a standard or rules file, a PostToolUse hook automatically syncs the change to the Master Plan:
-
-```
-AI edits claudeos-core/standard/10.backend-api/01.controller-patterns.md
-  → sync-hook automatically updates plan/10.standard-master.md
-```
-
-No manual sync needed. The hook is installed automatically during `npx claudeos-core init`.
-
 ---
 
 ## Daily Workflow
@@ -431,7 +420,7 @@ No manual sync needed. The hook is installed automatically during `npx claudeos-
 ### After Manually Editing Standards
 
 ```bash
-# If you edited files outside of Claude Code (hooks only trigger inside Claude Code):
+# After editing standards or rules files:
 npx claudeos-core refresh
 
 # Verify everything is consistent

package/README.ru.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← Правила автосинхронизации
+│       └── 50.sync/                   ← Правила напоминания о синхронизации
 │
 ├── claudeos-core/                     ← Основная директория вывода
 │   ├── generated/                     ← JSON анализа + динамические промпты
@@ -368,22 +368,11 @@ npx claudeos-core restore      # Восстановление Plan → Диск
 
 | Папка | Причина исключения |
 |---|---|
-| `claudeos-core/plan/` | Резервные копии Master Plan (~340КБ). Автосинхронизация через hooks. |
+| `claudeos-core/plan/` | Резервные копии Master Plan (~340КБ). Используйте `npx claudeos-core refresh` для синхронизации. |
 | `claudeos-core/generated/` | JSON метаданных сборки. Не для кодирования. |
 | `claudeos-core/guide/` | Руководства для людей. |
 | `claudeos-core/mcp-guide/` | Документация MCP сервера. Не для кодирования. |
 
-### Автоматическая синхронизация Plan (hooks)
-
-Когда Claude Code редактирует файл standard или rules, хук PostToolUse автоматически синхронизирует Master Plan:
-
-```
-AI редактирует claudeos-core/standard/10.backend-api/01.controller-patterns.md
-  → sync-hook автоматически обновляет plan/10.standard-master.md
-```
-
-Ручная синхронизация не требуется. Хук устанавливается автоматически при `npx claudeos-core init`.
-
 ---
 
 ## Повседневный рабочий процесс
@@ -400,7 +389,7 @@ AI редактирует claudeos-core/standard/10.backend-api/01.controller-pa
 ### После ручного редактирования стандартов
 
 ```bash
-# Если файлы редактировались вне Claude Code (хуки работают только внутри Claude Code):
+# После редактирования файлов standard или rules:
 npx claudeos-core refresh
 
 # Проверить консистентность

package/README.vi.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← Rules đồng bộ tự động
+│       └── 50.sync/                   ← Rules nhắc nhở đồng bộ
 │
 ├── claudeos-core/                     ← Thư mục đầu ra chính
 │   ├── generated/                     ← JSON phân tích + prompt động
@@ -368,22 +368,11 @@ Quy tắc `00.standard-reference.md` hướng dẫn Claude Code Read tài liệu
 
 | Thư mục | Lý do loại trừ |
 |---|---|
-| `claudeos-core/plan/` | Backup Master Plan (~340KB). Tự đồng bộ bằng hooks. |
+| `claudeos-core/plan/` | Backup Master Plan (~340KB). Dùng `npx claudeos-core refresh` để đồng bộ. |
 | `claudeos-core/generated/` | JSON metadata build. Không dùng cho coding. |
 | `claudeos-core/guide/` | Hướng dẫn onboarding cho người dùng. |
 | `claudeos-core/mcp-guide/` | Tài liệu MCP server. Không dùng cho coding. |
 
-### Đồng bộ Plan tự động (hooks)
-
-Khi Claude Code chỉnh sửa file standard hoặc rules, hook PostToolUse tự động đồng bộ Master Plan:
-
-```
-AI chỉnh sửa claudeos-core/standard/10.backend-api/01.controller-patterns.md
-  → sync-hook tự động cập nhật plan/10.standard-master.md
-```
-
-Không cần đồng bộ thủ công. Hook được cài đặt tự động khi chạy `npx claudeos-core init`.
-
 ---
 
 ## Quy Trình Làm Việc Hàng Ngày
@@ -400,7 +389,7 @@ Không cần đồng bộ thủ công. Hook được cài đặt tự động kh
 ### Sau Khi Chỉnh Sửa Thủ Công Standards
 
 ```bash
-# Nếu bạn chỉnh sửa file bên ngoài Claude Code (hooks chỉ hoạt động bên trong Claude Code):
+# Sau khi chỉnh sửa file standard hoặc rules:
 npx claudeos-core refresh
 
 # Xác minh mọi thứ nhất quán

package/README.zh-CN.md

@@ -288,7 +288,7 @@ your-project/
 │       ├── 20.frontend/
 │       ├── 30.security-db/
 │       ├── 40.infra/
-│       └── 50.sync/                   ← 自动同步规则
+│       └── 50.sync/                   ← 同步提醒规则
 │
 ├── claudeos-core/                     ← 主要输出目录
 │   ├── generated/                     ← 分析 JSON + 动态提示
@@ -368,22 +368,11 @@ ClaudeOS-Core 生成的文档，Claude Code 实际读取方式如下：
 
 | 文件夹 | 排除原因 |
 |---|---|
-| `claudeos-core/plan/` | Master Plan 备份（~340KB）。由 hooks 自动同步。 |
+| `claudeos-core/plan/` | Master Plan 备份（~340KB）。使用 `npx claudeos-core refresh` 同步。 |
 | `claudeos-core/generated/` | 构建元数据 JSON。非编码参考。 |
 | `claudeos-core/guide/` | 面向人类的入门指南。 |
 | `claudeos-core/mcp-guide/` | MCP 服务器文档。非编码参考。 |
 
-### 自动 Plan 同步（hooks）
-
-当 Claude Code 编辑 standard 或 rules 文件时，PostToolUse hook 自动同步 Master Plan：
-
-```
-AI 编辑 claudeos-core/standard/10.backend-api/01.controller-patterns.md
-  → sync-hook 自动更新 plan/10.standard-master.md
-```
-
-无需手动同步。hook 在 `npx claudeos-core init` 时自动安装。
-
 ---
 
 ## 日常工作流
@@ -400,7 +389,7 @@ AI 编辑 claudeos-core/standard/10.backend-api/01.controller-patterns.md
 ### 手动编辑标准文件后
 
 ```bash
-# 在 Claude Code 外部编辑了文件时（hooks 仅在 Claude Code 内部触发）：
+# 编辑 standard 或 rules 文件后：
 npx claudeos-core refresh
 
 # 验证一切一致

package/bin/cli.js

@@ -150,64 +150,6 @@ function injectProjectRoot(text) {
   return text.replace(/\{\{PROJECT_ROOT\}\}/g, PROJECT_ROOT);
 }
 
-// ─── Install sync hooks into .claude/settings.json ──────
-function installSyncHooks() {
-  const settingsPath = path.join(PROJECT_ROOT, ".claude/settings.json");
-
-  // Determine sync-hook script path (relative to project root)
-  // Works for both npx (node_modules) and git clone (direct path) usage
-  let syncHookScript;
-  const npxPath = path.join(PROJECT_ROOT, "node_modules/claudeos-core/sync-hook/index.js");
-  const localPath = path.join(TOOLS_DIR, "sync-hook/index.js");
-
-  if (fs.existsSync(npxPath)) {
-    syncHookScript = "node node_modules/claudeos-core/sync-hook/index.js";
-  } else if (fs.existsSync(localPath)) {
-    const relScript = path.relative(PROJECT_ROOT, localPath).replace(/\\/g, "/");
-    syncHookScript = `node ${relScript}`;
-  } else {
-    log("    ⏭️  sync-hook script not found, skipping");
-    return;
-  }
-
-  const hookEntry = {
-    matcher: "Edit|Write",
-    command: `${syncHookScript} "$TOOL_INPUT_FILE"`
-  };
-
-  let settings = {};
-  if (fs.existsSync(settingsPath)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
-    } catch {
-      // Malformed JSON — start fresh but warn
-      log("    ⚠️  Existing settings.json was malformed, recreating");
-      settings = {};
-    }
-  }
-
-  // Ensure hooks.PostToolUse array exists
-  if (!settings.hooks) settings.hooks = {};
-  if (!Array.isArray(settings.hooks.PostToolUse)) settings.hooks.PostToolUse = [];
-
-  // Check if sync-hook is already installed (avoid duplicates)
-  const alreadyInstalled = settings.hooks.PostToolUse.some(
-    (h) => h.command && h.command.includes("sync-hook")
-  );
-
-  if (alreadyInstalled) {
-    log("    ✅ Sync hooks already installed");
-    return;
-  }
-
-  settings.hooks.PostToolUse.push(hookEntry);
-
-  ensureDir(path.dirname(settingsPath));
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-  log("    ✅ Sync hooks installed → .claude/settings.json");
-  log(`    Hook: PostToolUse (Edit|Write) → ${syncHookScript}`);
-}
-
 // ─── Command: init ───────────────────────────────────────
 async function cmdInit() {
   // ─── Prerequisites check ───────────────────────────────────
@@ -308,11 +250,6 @@ async function cmdInit() {
   }
   log("    ✅ Done\n");
 
-  // ─── [2.5] Install sync hooks in .claude/settings.json ────
-  header("[2.5] Installing sync hooks...");
-  installSyncHooks();
-  log("");
-
   // ─── [3] Run plan-installer ─────────────────────────
   header("[3] Analyzing project (plan-installer)...");
   run(`node "${path.join(TOOLS_DIR, "plan-installer/index.js")}"`);

package/bootstrap.sh

@@ -74,6 +74,7 @@ if [ "$VALID" = false ]; then
 fi
 
 export CLAUDEOS_LANG
+export CLAUDEOS_ROOT="$PROJECT_ROOT"
 
 # ─── Prompt placeholder substitution helper ────────────────────
 inject_project_root() {

package/content-validator/index.js

@@ -102,7 +102,7 @@ async function main() {
         errors.push({ file: r, type: "EMPTY", msg: "Empty file" });
         continue;
       }
-      // All rules (except sync) must have paths: ["**/*"] frontmatter
+      // All rules (except sync reminders) must have paths: ["**/*"] frontmatter
       if (!r.includes("50.sync")) {
         const hasFrontmatter = c.startsWith("---");
         const hasPathsKey = c.includes("paths:");

package/health-checker/index.js

@@ -24,14 +24,14 @@ const GEN = path.join(ROOT, "claudeos-core/generated");
 
 function run(name, script) {
   try {
-    const output = execSync(`node ${script}`, {
+    const output = execSync(`node "${script}"`, {
       cwd: ROOT,
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"],
     });
     return { name, ok: true, output };
   } catch (e) {
-    return { name, ok: false, output: e.stdout || "", exitCode: e.status || 1 };
+    return { name, ok: false, output: e.stdout || e.stderr || e.message || "", exitCode: e.status || 1 };
   }
 }
 

package/manifest-generator/index.js

@@ -3,10 +3,9 @@
 /**
  * ClaudeOS-Core — Manifest Generator
  *
- * Role: Generate 4 types of metadata JSON + initialize stale-report
+ * Role: Generate metadata JSON + initialize stale-report
  * Output (claudeos-core/generated/):
  *   - rule-manifest.json   : rules/standard/skills/guide file list + frontmatter
- *   - import-graph.json    : (deprecated — kept for backward compatibility, @import removed)
  *   - sync-map.json        : plan/ <file> block → file path mapping
  *   - plan-manifest.json   : plan/ file list + <file> block count
  *   - stale-report.json    : initialized (each verification tool appends results)
@@ -117,16 +116,7 @@ async function main() {
   fs.writeFileSync(path.join(GEN, "rule-manifest.json"), JSON.stringify(mf, null, 2));
   console.log(`  ✅ rule-manifest.json — ${mf.summary.total} files indexed`);
 
-  // ─── import-graph.json (deprecated — @import removed) ──
-  const gr = {
-    generatedAt: new Date().toISOString(),
-    deprecated: true,
-    note: "@import is not a Claude Code feature and has been removed. Rules now use paths: [\"**/*\"] frontmatter.",
-    nodes: [], edges: [], errors: [],
-    summary: { totalNodes: 0, totalEdges: 0, brokenImports: 0 },
-  };
-  fs.writeFileSync(path.join(GEN, "import-graph.json"), JSON.stringify(gr, null, 2));
-  console.log("  ✅ import-graph.json — deprecated (no @imports)");
+  // import-graph.json removed — @import was never a Claude Code feature
 
   // ─── sync-map.json ─────────────────────────────────────
   const sm = { generatedAt: new Date().toISOString(), mappings: [] };
@@ -158,7 +148,7 @@ async function main() {
     JSON.stringify({ generatedAt: new Date().toISOString(), summary: { totalIssues: 0, status: "initial" } }, null, 2)
   );
   console.log("  ✅ stale-report.json — initialized");
-  console.log("\n  📁 Output: claudeos-core/generated/ (5 files)\n");
+  console.log("\n  📁 Output: claudeos-core/generated/ (4 files)\n");
 }
 
 main().catch(e => { console.error(e); process.exit(1); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudeos-core",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "Auto-generate Claude Code documentation from your actual source code — Standards, Rules, Skills, and Guides tailored to your project",
   "main": "bin/cli.js",
   "bin": {
@@ -10,14 +10,12 @@
     "bin/",
     "content-validator/",
     "health-checker/",
-    "import-linter/",
     "manifest-generator/",
     "pass-json-validator/",
     "pass-prompts/",
     "plan-installer/",
     "plan-validator/",
     "sync-checker/",
-    "sync-hook/",
     "bootstrap.sh",
     "README.md",
     "README.ko.md",

package/pass-json-validator/index.js

@@ -215,9 +215,9 @@ async function main() {
       const normalizedKeys = keys.map(normalize);
       for (const section of sectionsToCheck) {
         const sectionNorm = normalize(section);
-        // Exact normalized match first, then containment (only for names >= 6 chars to avoid false positives)
+        // Exact normalized match first, then check if any key contains the section name (one-direction only to avoid false positives)
         const found = normalizedKeys.some(k => k === sectionNorm)
-          || (sectionNorm.length >= 6 && normalizedKeys.some(k => k.includes(sectionNorm) || sectionNorm.includes(k)));
+          || (sectionNorm.length >= 6 && normalizedKeys.some(k => k.includes(sectionNorm)));
         if (!found) {
           warnings.push({
             file: "pass2-merged.json",

package/pass-prompts/templates/java-spring/pass3.md

@@ -81,8 +81,7 @@ Generation targets:
      List only the standard files that were actually generated above. Include frontend standards only if frontend was detected.
 
 4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
-   - NOTE: Actual sync is handled automatically by hooks in .claude/settings.json (PostToolUse → sync-hook).
-     These rules serve as a backup reminder for AI in case hooks fail or are not installed.
+   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
    - 01.standard-sync.md — Remind AI to update plan/10 when standard is modified
    - 02.rules-sync.md — Remind AI to update plan/20 when rules are modified
    - 03.skills-sync.md — Remind AI to update plan/30 when skills are modified

package/pass-prompts/templates/kotlin-spring/pass3.md

@@ -87,8 +87,7 @@ Generation targets:
      List only the standard files that were actually generated above. Include frontend standards only if frontend was detected.
 
 4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
-   - NOTE: Actual sync is handled automatically by hooks in .claude/settings.json (PostToolUse → sync-hook).
-     These rules serve as a backup reminder for AI in case hooks fail or are not installed.
+   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
    - 01.standard-sync.md — Remind AI to update plan/10 when standard is modified
    - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
    - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified

package/pass-prompts/templates/node-express/pass3.md

@@ -80,8 +80,7 @@ Generation targets:
      List only the standard files that were actually generated above.
 
 4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
-   - NOTE: Actual sync is handled automatically by hooks in .claude/settings.json (PostToolUse → sync-hook).
-     These rules serve as a backup reminder for AI in case hooks fail or are not installed.
+   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
    - 01.standard-sync.md — Remind AI to update plan/10 when standard is modified
    - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
    - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified

package/pass-prompts/templates/node-nextjs/pass3.md

@@ -77,8 +77,7 @@ Generation targets:
      List only the standard files that were actually generated above.
 
 4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
-   - NOTE: Actual sync is handled automatically by hooks in .claude/settings.json (PostToolUse → sync-hook).
-     These rules serve as a backup reminder for AI in case hooks fail or are not installed.
+   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
    - 01.standard-sync.md — Remind AI to update plan/10 when standard is modified
    - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
    - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified

package/pass-prompts/templates/python-django/pass3.md

@@ -80,8 +80,7 @@ Generation targets:
      List only the standard files that were actually generated above.
 
 4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
-   - NOTE: Actual sync is handled automatically by hooks in .claude/settings.json (PostToolUse → sync-hook).
-     These rules serve as a backup reminder for AI in case hooks fail or are not installed.
+   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
    - 01.standard-sync.md — Remind AI to update plan/10 when standard is modified
    - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
    - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified

package/pass-prompts/templates/python-fastapi/pass3.md

@@ -80,8 +80,7 @@ Generation targets:
      List only the standard files that were actually generated above.
 
 4. .claude/rules/50.sync/ (3 sync rules — AI fallback reminders)
-   - NOTE: Actual sync is handled automatically by hooks in .claude/settings.json (PostToolUse → sync-hook).
-     These rules serve as a backup reminder for AI in case hooks fail or are not installed.
+   - NOTE: These rules remind AI to run `npx claudeos-core refresh` after modifying standard/rules/skills files.
    - 01.standard-sync.md — Remind AI to update plan/10 when standard is modified
    - 02.rules-sync.md — Remind AI to update plan/20 when rules is modified
    - 03.skills-sync.md — Remind AI to update plan/30 when skills is modified

package/plan-installer/index.js

@@ -197,7 +197,7 @@ async function detectStack() {
     let pkg;
     try { pkg = JSON.parse(fs.readFileSync(path.join(ROOT, "package.json"), "utf-8")); }
     catch { console.warn("    ⚠️  package.json parse error — skipping Node.js detection"); pkg = null; }
-    if (!pkg) return stack;
+    if (pkg) {
     stack.detected.push("package.json");
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
 
@@ -231,6 +231,7 @@ async function detectStack() {
       : fs.existsSync(path.join(ROOT, "yarn.lock")) ? "yarn" : "npm";
 
     if (pkg.engines && pkg.engines.node && !stack.languageVersion) stack.languageVersion = pkg.engines.node;
+    } // end if (pkg)
   }
 
   // ── Python ──
@@ -1275,6 +1276,11 @@ async function main() {
   const stack = await detectStack();
   console.log(`    Language:    ${stack.language || "unknown"} ${stack.languageVersion || ""}`);
   console.log(`    Framework:   ${stack.framework || "none"} ${stack.frameworkVersion || ""}`);
+  if (!stack.language && !stack.framework) {
+    console.warn("\n  ⚠️  No language or framework detected.");
+    console.warn("  Supported: Java, Kotlin, TypeScript, JavaScript, Python");
+    console.warn("  Ensure you have build.gradle, package.json, pyproject.toml, or requirements.txt in the project root.\n");
+  }
   console.log(`    Frontend:    ${stack.frontend || "none"} ${stack.frontendVersion || ""}`);
   console.log(`    Database:    ${stack.database || "none"}`);
   console.log(`    ORM:         ${stack.orm || "none"}`);
@@ -1288,6 +1294,11 @@ async function main() {
   console.log(`    Total:       ${domains.length} domains`);
   if (rootPackage) console.log(`    Package:     ${rootPackage}`);
   if (frontend.exists) console.log(`    Components:  ${frontend.components} components, ${frontend.pages} pages, ${frontend.hooks} hooks`);
+  if (backendDomains.length === 0 && frontendDomains.length === 0) {
+    console.warn("\n  ⚠️  No domains detected.");
+    console.warn("  Pass 1 will be skipped. Generated output may be minimal.");
+    console.warn("  Check your project structure — see README for supported patterns.\n");
+  }
   console.log();
 
   // Phase 3: Template selection (multi-stack)
@@ -1374,4 +1385,10 @@ async function main() {
   console.log("  ✅ Plan Installer complete\n");
 }
 
-main().catch(e => { console.error(e); process.exit(1); });
+main().catch(e => {
+  console.error(`\n  ❌ Plan Installer failed: ${e.message || e}`);
+  if (e.code === "EACCES" || e.code === "EPERM") {
+    console.error("  Check file/directory permissions.");
+  }
+  process.exit(1);
+});

package/plan-validator/index.js

@@ -126,6 +126,12 @@ async function main() {
       total++;
       const abs = path.join(ROOT, b.path);
 
+      // Block path traversal attempts
+      if (!path.resolve(abs).startsWith(path.resolve(ROOT))) {
+        console.log(`     ⚠️  SKIPPED: ${b.path} (path traversal blocked)`);
+        continue;
+      }
+
       // File does not exist
       if (!fs.existsSync(abs)) {
         if (mode === "--execute") {

package/sync-checker/index.js

@@ -76,7 +76,10 @@ async function main() {
   // ─── [2/2] Plan → Disk: detect orphaned files ───────────────
   console.log("  [2/2] Plan → Disk...");
   for (const m of sm.mappings) {
-    if (!fs.existsSync(path.join(ROOT, m.sourcePath))) {
+    const abs = path.join(ROOT, m.sourcePath);
+    // Skip path traversal attempts
+    if (!path.resolve(abs).startsWith(path.resolve(ROOT))) continue;
+    if (!fs.existsSync(abs)) {
       issues.orphan.push({ path: m.sourcePath, plan: m.planFile });
     }
   }

package/import-linter/index.js

@@ -1,171 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * ClaudeOS-Core — Import Linter (DEPRECATED)
- *
- * @deprecated @import is not a real Claude Code feature and has been removed.
- * Rules now use paths frontmatter with wildcard glob to ensure they are always loaded.
- * This tool is kept for backward compatibility but is no longer run by health-checker.
- *
- * Usage: node claudeos-core-tools/import-linter/index.js
- */
-
-const fs = require("fs");
-const path = require("path");
-const { glob } = require("glob");
-
-const ROOT = process.env.CLAUDEOS_ROOT || path.resolve(__dirname, "../..");
-const SCAN = [
-  ".claude/rules",
-  "claudeos-core/standard",
-  "claudeos-core/skills",
-  "claudeos-core/guide",
-  "claudeos-core/database",
-  "claudeos-core/mcp-guide",
-];
-
-function rel(p) {
-  return path.relative(ROOT, p).replace(/\\/g, "/");
-}
-
-function extractImports(f) {
-  const content = fs.readFileSync(f, "utf-8");
-  const result = [];
-  let inCodeFence = false;
-  content.split("\n").forEach((line, i) => {
-    // Track code fence boundaries to skip @-lines inside code blocks
-    if (/^```/.test(line)) { inCodeFence = !inCodeFence; return; }
-    if (inCodeFence) return;
-    const m = line.match(/^@(\.\.?\/[^\s]+)/);
-    if (m) {
-      const target = path.resolve(path.dirname(f), m[1]);
-      result.push({
-        raw: m[0],
-        rawPath: m[1],
-        resolved: target,
-        resolvedRel: rel(target),
-        exists: fs.existsSync(target),
-        line: i + 1,
-      });
-    }
-  });
-  return result;
-}
-
-function detectCycles(adj) {
-  const cycles = [];
-  const visited = new Set();
-  const inStack = new Set();
-
-  function dfs(n, pathSoFar) {
-    visited.add(n);
-    inStack.add(n);
-    for (const nb of adj[n] || []) {
-      if (!visited.has(nb)) {
-        const c = dfs(nb, [...pathSoFar, nb]);
-        if (c) return c;
-      } else if (inStack.has(nb)) {
-        const ci = pathSoFar.indexOf(nb);
-        return [...pathSoFar.slice(ci), nb];
-      }
-    }
-    inStack.delete(n);
-    return null;
-  }
-
-  for (const n of Object.keys(adj)) {
-    if (!visited.has(n)) {
-      const c = dfs(n, [n]);
-      if (c) cycles.push(c);
-    }
-  }
-  return cycles;
-}
-
-async function main() {
-  console.log("\n╔══════════════════════════════════════╗");
-  console.log("║  ClaudeOS-Core — Import Linter        ║");
-  console.log("╚══════════════════════════════════════╝\n");
-
-  const errors = [];
-  const warnings = [];
-  let totalImports = 0;
-  let totalFiles = 0;
-  const adj = {};
-
-  for (const d of SCAN) {
-    const abs = path.join(ROOT, d);
-    if (!fs.existsSync(abs)) {
-      console.log(`  ⏭️  Skipping: ${d}`);
-      continue;
-    }
-
-    for (const f of await glob("**/*.md", { cwd: abs, absolute: true })) {
-      const r = rel(f);
-      const imps = extractImports(f);
-      if (!imps.length) continue;
-
-      totalFiles++;
-      totalImports += imps.length;
-      adj[r] = [];
-      const seen = new Set();
-
-      for (const i of imps) {
-        adj[r].push(i.resolvedRel);
-
-        if (!i.exists) {
-          errors.push({
-            type: "BROKEN",
-            file: r,
-            line: i.line,
-            target: i.resolvedRel,
-            msg: `${r}:${i.line} → ${i.resolvedRel} (NOT FOUND)`,
-          });
-        }
-
-        if (seen.has(i.resolvedRel)) {
-          warnings.push({
-            type: "DUP",
-            file: r,
-            line: i.line,
-            target: i.resolvedRel,
-            msg: `${r}:${i.line} → ${i.resolvedRel} (DUPLICATE)`,
-          });
-        }
-        seen.add(i.resolvedRel);
-      }
-    }
-  }
-
-  // Cycle detection
-  for (const c of detectCycles(adj)) {
-    errors.push({
-      type: "CIRCULAR",
-      cycle: c,
-      msg: `Circular: ${c.join(" → ")}`,
-    });
-  }
-
-  console.log(`  Scanned ${totalFiles} files, ${totalImports} @imports\n`);
-
-  if (!errors.length && !warnings.length) {
-    console.log(`  ✅ ${totalImports}/${totalImports} valid\n`);
-    process.exit(0);
-  }
-
-  if (errors.length) {
-    console.log(`  ❌ ERRORS (${errors.length}):`);
-    errors.forEach((e) => console.log(`     ${e.msg}`));
-    console.log();
-  }
-  if (warnings.length) {
-    console.log(`  ⚠️  WARNINGS (${warnings.length}):`);
-    warnings.forEach((w) => console.log(`     ${w.msg}`));
-    console.log();
-  }
-
-  console.log(`  Total issues: ${errors.length + warnings.length}\n`);
-  process.exit(errors.length ? 1 : 0);
-}
-
-main().catch(console.error);

package/sync-hook/index.js

@@ -1,203 +0,0 @@
-#!/usr/bin/env node
-
-//
-// ClaudeOS-Core — Sync Hook
-//
-// Role: Automatically sync disk files to Master Plan when files are modified.
-// Triggered by Claude Code hooks (PostToolUse) after Edit/Write operations.
-//
-// How it works:
-//   1. Receives the modified file path from hook environment ($TOOL_INPUT_FILE or argv)
-//   2. Determines which plan file(s) contain this file as a <file> block
-//   3. Reads the current disk content and updates the plan block in-place
-//
-// Mapping:
-//   CLAUDE.md, claudeos-core/standard/    -> plan/10.standard-master.md
-//   .claude/rules/ (except 50.sync/)      -> plan/20.rules-master.md
-//   .claude/rules/50.sync/                -> plan/21.sync-rules-master.md
-//   claudeos-core/skills/10.backend-*/    -> plan/30.backend-skills-master.md
-//   claudeos-core/skills/20.frontend-*/   -> plan/31.frontend-skills-master.md
-//   claudeos-core/guide/                  -> plan/40.guides-master.md
-//
-// Usage:
-//   node claudeos-core-tools/sync-hook/index.js <modified-file-path>
-//
-//   Or via Claude Code hooks (.claude/settings.json):
-//   {
-//     "hooks": {
-//       "PostToolUse": [{
-//         "matcher": "Edit|Write",
-//         "command": "node claudeos-core-tools/sync-hook/index.js \"$TOOL_INPUT_FILE\""
-//       }]
-//     }
-//   }
-//
-
-const fs = require("fs");
-const path = require("path");
-
-const ROOT = process.env.CLAUDEOS_ROOT || process.cwd();
-const PLAN_DIR = path.join(ROOT, "claudeos-core/plan");
-
-// ─── Path → Plan mapping ────────────────────────────────────
-const PLAN_MAP = [
-  { pattern: /^CLAUDE\.md$/,                                    plan: "10.standard-master.md",        format: "file" },
-  { pattern: /^claudeos-core\/standard\//,                      plan: "10.standard-master.md",        format: "file" },
-  { pattern: /^\.claude\/rules\/50\.sync\//,                    plan: "21.sync-rules-master.md",      format: "code" },
-  { pattern: /^\.claude\/rules\//,                              plan: "20.rules-master.md",           format: "file" },
-  { pattern: /^claudeos-core\/skills\/10\.backend/,             plan: "30.backend-skills-master.md",  format: "file" },
-  { pattern: /^claudeos-core\/skills\/20\.frontend/,            plan: "31.frontend-skills-master.md", format: "file" },
-  { pattern: /^claudeos-core\/skills\/00\.shared/,              plan: "30.backend-skills-master.md",  format: "file" },
-  { pattern: /^claudeos-core\/guide\//,                         plan: "40.guides-master.md",          format: "file" },
-  { pattern: /^claudeos-core\/database\//,                      plan: "10.standard-master.md",        format: "file" },
-  { pattern: /^claudeos-core\/mcp-guide\//,                     plan: "10.standard-master.md",        format: "file" },
-];
-
-function rel(filePath) {
-  return path.relative(ROOT, path.resolve(filePath)).replace(/\\/g, "/");
-}
-
-// ─── Find which plan file to update ─────────────────────────
-function findPlanTarget(relPath) {
-  for (const entry of PLAN_MAP) {
-    if (entry.pattern.test(relPath)) {
-      return entry;
-    }
-  }
-  return null;
-}
-
-// ─── Replace <file path="..."> block in plan ────────────────
-function replaceFileBlock(planContent, filePath, newContent) {
-  const escaped = filePath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-  const regex = new RegExp(
-    `(<file\\s+path="${escaped}">\\s*\\n)[\\s\\S]*?(\\n</file>)`,
-    "g"
-  );
-
-  if (!regex.test(planContent)) {
-    return null; // block not found in plan
-  }
-
-  return planContent.replace(regex, `$1${newContent}$2`);
-}
-
-// ─── Replace ```markdown code block in plan ─────────────────
-function replaceCodeBlock(planContent, filePath, newContent) {
-  const cleanPath = filePath.replace(/`/g, "");
-  const headingPattern = new RegExp(
-    `^##\\s+\\d+\\.\\s+\`?${cleanPath.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\`?`,
-    "m"
-  );
-
-  const headingMatch = headingPattern.exec(planContent);
-  if (!headingMatch) return null;
-
-  const afterHeading = planContent.indexOf("```markdown\n", headingMatch.index);
-  if (afterHeading < 0) return null;
-
-  const contentStart = afterHeading + "```markdown\n".length;
-
-  // Find closing ``` respecting nesting
-  let searchPos = contentStart;
-  let closingPos = -1;
-  let nestDepth = 0;
-
-  while (searchPos < planContent.length) {
-    const nextFence = planContent.indexOf("\n```", searchPos);
-    if (nextFence < 0) break;
-
-    const lineAfterFence = planContent.substring(
-      nextFence + 4,
-      planContent.indexOf("\n", nextFence + 4)
-    );
-    const isOpening =
-      lineAfterFence.trim().length > 0 && !lineAfterFence.startsWith("\n");
-
-    if (isOpening) {
-      nestDepth++;
-      searchPos = nextFence + 4;
-    } else if (nestDepth > 0) {
-      nestDepth--;
-      searchPos = nextFence + 4;
-    } else {
-      closingPos = nextFence + 1;
-      break;
-    }
-  }
-
-  if (closingPos < 0) return null;
-
-  return (
-    planContent.substring(0, contentStart) +
-    newContent +
-    "\n" +
-    planContent.substring(closingPos)
-  );
-}
-
-// ─── Main ───────────────────────────────────────────────────
-function main() {
-  // Get modified file path from argument or environment
-  const inputFile = process.argv[2] || process.env.TOOL_INPUT_FILE;
-
-  if (!inputFile) {
-    // Silent exit — hook may fire for non-file operations
-    process.exit(0);
-  }
-
-  const relPath = rel(inputFile);
-
-  // Skip non-.md files
-  if (!relPath.endsWith(".md")) {
-    process.exit(0);
-  }
-
-  // Skip files outside tracked directories
-  const target = findPlanTarget(relPath);
-  if (!target) {
-    process.exit(0);
-  }
-
-  // Skip if plan directory doesn't exist (not yet initialized)
-  if (!fs.existsSync(PLAN_DIR)) {
-    process.exit(0);
-  }
-
-  const planFile = path.join(PLAN_DIR, target.plan);
-
-  // Skip if target plan file doesn't exist
-  if (!fs.existsSync(planFile)) {
-    process.exit(0);
-  }
-
-  const absFile = path.join(ROOT, relPath);
-
-  // Skip if source file was deleted (not our job to handle deletions)
-  if (!fs.existsSync(absFile)) {
-    process.exit(0);
-  }
-
-  // Read current disk content and plan content
-  const diskContent = fs.readFileSync(absFile, "utf-8").trimEnd();
-  const planContent = fs.readFileSync(planFile, "utf-8");
-
-  // Attempt to replace the block
-  let updated;
-  if (target.format === "code") {
-    updated = replaceCodeBlock(planContent, relPath, diskContent);
-  } else {
-    updated = replaceFileBlock(planContent, relPath, diskContent);
-  }
-
-  if (updated && updated !== planContent) {
-    fs.writeFileSync(planFile, updated);
-    // Brief output for hook log (visible in Claude Code)
-    console.log(`[sync-hook] ${relPath} → ${target.plan}`);
-  }
-
-  // Silent exit if no block found (file not yet in plan) or no change
-  process.exit(0);
-}
-
-main();