oh-my-customcode 0.35.2 → 0.36.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-customcode",
-  "version": "0.35.2",
+  "version": "0.36.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

package/templates/.claude/hooks/hooks.json

@@ -62,6 +62,16 @@
         ],
         "description": "Suggest manual compaction at logical intervals"
       },
+      {
+        "matcher": "tool == \"Edit\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/content-hash-validator.sh"
+          }
+        ],
+        "description": "Validate file content hash before Edit — advisory staleness warning"
+      },
       {
         "matcher": "tool == \"Task\" || tool == \"Agent\"",
         "hooks": [
@@ -212,6 +222,16 @@
         ],
         "description": "Context budget advisor — track tool usage patterns and advise ecomode activation"
       },
+      {
+        "matcher": "tool == \"Read\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/content-hash-validator.sh"
+          }
+        ],
+        "description": "Store content hashes for Read operations — enables Edit staleness detection"
+      },
       {
         "matcher": "tool == \"Edit\" || tool == \"Write\" || tool == \"Bash\" || tool == \"Task\" || tool == \"Agent\"",
         "hooks": [

package/templates/.claude/hooks/scripts/content-hash-validator.sh

@@ -0,0 +1,73 @@
+#!/bin/bash
+# Content-Hash Validator — Detect stale file state for Edit operations
+# Trigger: PostToolUse on Read (stores hashes), PreToolUse on Edit (validates)
+# Purpose: Advisory warning when file content changed between Read and Edit
+# Protocol: stdin JSON -> validate -> stdout pass-through
+# Always exits 0 (advisory only, never blocks)
+
+set -euo pipefail
+
+input=$(cat)
+
+# Hash store (PPID-scoped, session-only)
+HASH_STORE="/tmp/.claude-content-hashes-${PPID}"
+
+tool_name=$(echo "$input" | jq -r '.tool_name // "unknown"')
+
+case "$tool_name" in
+  "Read")
+    # Store content hash for the file that was just read
+    file_path=$(echo "$input" | jq -r '.tool_input.file_path // ""')
+    output=$(echo "$input" | jq -r '.tool_output.output // ""')
+
+    if [ -n "$file_path" ] && [ -n "$output" ] && [ "$output" != "null" ]; then
+      content_hash=$(echo "$output" | md5 2>/dev/null || echo "$output" | md5sum 2>/dev/null | cut -d' ' -f1 || echo "unknown")
+      timestamp=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+      # Store hash entry (overwrite previous for same file)
+      if [ -f "$HASH_STORE" ]; then
+        # Remove old entry for this file
+        grep -v "\"path\":\"${file_path}\"" "$HASH_STORE" > "${HASH_STORE}.tmp" 2>/dev/null || true
+        mv "${HASH_STORE}.tmp" "$HASH_STORE" 2>/dev/null || true
+      fi
+
+      jq -cn \
+        --arg path "$file_path" \
+        --arg hash "$content_hash" \
+        --arg ts "$timestamp" \
+        '{path: $path, hash: $hash, stored_at: $ts}' >> "$HASH_STORE" 2>/dev/null || true
+    fi
+    ;;
+
+  "Edit")
+    # Validate that file hasn't changed since last Read
+    file_path=$(echo "$input" | jq -r '.tool_input.file_path // ""')
+
+    if [ -n "$file_path" ] && [ -f "$HASH_STORE" ] && [ -f "$file_path" ]; then
+      stored_hash=$(grep "\"path\":\"${file_path}\"" "$HASH_STORE" 2>/dev/null | tail -1 | jq -r '.hash // ""' 2>/dev/null || echo "")
+
+      if [ -n "$stored_hash" ] && [ "$stored_hash" != "unknown" ]; then
+        current_hash=$(md5 -q "$file_path" 2>/dev/null || md5sum "$file_path" 2>/dev/null | cut -d' ' -f1 || echo "unknown")
+
+        if [ "$current_hash" != "unknown" ] && [ "$stored_hash" != "$current_hash" ]; then
+          echo "[Content-Hash] WARNING: $(basename "$file_path") may have changed since last Read" >&2
+          echo "[Content-Hash] Stored hash: ${stored_hash:0:8}... Current: ${current_hash:0:8}..." >&2
+          echo "[Content-Hash] Advisory: re-read the file before editing if unsure" >&2
+        fi
+      fi
+    fi
+    ;;
+esac
+
+# Ring buffer: keep last 200 entries
+if [ -f "$HASH_STORE" ]; then
+  line_count=$(wc -l < "$HASH_STORE" 2>/dev/null || echo "0")
+  if [ "$line_count" -gt 200 ]; then
+    tail -200 "$HASH_STORE" > "${HASH_STORE}.tmp"
+    mv "${HASH_STORE}.tmp" "$HASH_STORE"
+  fi
+fi
+
+# Always pass through
+echo "$input"
+exit 0

package/templates/.claude/rules/SHOULD-memory-integration.md

@@ -157,7 +157,7 @@ User signals session end
        3. Return formatted summary to orchestrator
   → Orchestrator performs MCP saves directly:
        1. claude-mem save (if available via ToolSearch)
-       2. episodic-memory verification (if available via ToolSearch)
+       (episodic-memory auto-indexes after session — no action needed)
   → Orchestrator confirms to user
 ```
 
@@ -170,7 +170,7 @@ MCP tools (claude-mem, episodic-memory) are **orchestrator-scoped** and not inhe
 | Session summary collection | sys-memory-keeper | Domain expertise in memory formatting |
 | Native auto-memory (MEMORY.md) | sys-memory-keeper | Has Write access to memory directory |
 | claude-mem MCP save | Orchestrator | MCP tools only available at orchestrator level |
-| episodic-memory MCP verification | Orchestrator | MCP tools only available at orchestrator level |
+| episodic-memory | Automatic | Conversations are auto-indexed after session ends — no manual action needed |
 
 ### Dual-System Save
 
@@ -178,7 +178,7 @@ MCP tools (claude-mem, episodic-memory) are **orchestrator-scoped** and not inhe
 |--------|-------|------|--------|----------|
 | Native auto-memory | sys-memory-keeper | Write | Update MEMORY.md with session learnings | Yes |
 | claude-mem | Orchestrator | `mcp__plugin_claude-mem_mcp-search__save_memory` | Save session summary with project, tasks, decisions | No (best-effort) |
-| episodic-memory | Orchestrator | `mcp__plugin_episodic-memory_episodic-memory__search` | Verify session is indexed for future retrieval | No (best-effort) |
+| episodic-memory | Automatic | (auto-indexed) | No action needed — conversations are indexed automatically after session ends | N/A |
 
 ### Session-End Self-Check (MANDATORY)
 
@@ -194,12 +194,10 @@ MCP tools (claude-mem, episodic-memory) are **orchestrator-scoped** and not inhe
 ║     YES → Continue (even if it failed)                           ║
 ║     NO  → ToolSearch + save now                                  ║
 ║                                                                   ║
-║  3. Did I attempt episodic-memory verification?                  ║
-║     YES → Continue (even if it failed)                           ║
-║     NO  → ToolSearch + verify now  ← THIS IS THE COMMONLY       ║
-║           SKIPPED STEP. DO NOT SKIP IT.                          ║
+║  Note: episodic-memory auto-indexes conversations after session  ║
+║  ends. No manual action needed — do NOT search as "verification" ║
 ║                                                                   ║
-║  ALL THREE must be attempted before confirming to user.          ║
+║  BOTH steps must be completed before confirming to user.         ║
 ║  "Attempted" means called the tool — failure is OK, skipping     ║
 ║  is NOT.                                                          ║
 ╚══════════════════════════════════════════════════════════════════╝
@@ -209,5 +207,4 @@ MCP tools (claude-mem, episodic-memory) are **orchestrator-scoped** and not inhe
 
 - MCP saves are **non-blocking**: memory failure MUST NOT prevent session from ending
 - If claude-mem unavailable: skip, log warning
-- If episodic-memory unavailable: skip, log warning
-- If both unavailable: warn user, proceed with session end
+- episodic-memory: no action needed (auto-indexed after session)

package/templates/CLAUDE.md.en

@@ -129,6 +129,7 @@ Violation = immediate correction. No exception for "small changes".
 | R016 | Continuous Improvement | **ENFORCED** - Update rules when violations occur |
 | R017 | Sync Verification | **ENFORCED** - Verify sync before structural changes |
 | R018 | Agent Teams | **ENFORCED (Conditional)** - Mandatory for qualifying tasks when Agent Teams enabled |
+| R020 | Completion Verification | **ENFORCED** - Verification required before declaring task complete |
 
 ### SHOULD (Strongly recommended)
 | ID | Rule | Description |
@@ -157,6 +158,7 @@ Violation = immediate correction. No exception for "small changes".
 | `/omcustom:update-external` | Update agents from external sources |
 | `/omcustom:audit-agents` | Audit agent dependencies |
 | `/omcustom:fix-refs` | Fix broken references |
+| `/omcustom:takeover` | Extract canonical spec from existing agent/skill |
 | `/dev-review` | Review code for best practices |
 | `/dev-refactor` | Refactor code |
 | `/memory-save` | Save session context to claude-mem |
@@ -184,9 +186,9 @@ project/
 +-- CLAUDE.md                    # Entry point
 +-- .claude/
 |   +-- agents/                  # Subagent definitions (44 files)
-|   +-- skills/                  # Skills (71 directories)
-|   +-- rules/                   # Global rules (R000-R019)
-|   +-- hooks/                   # Hook scripts (memory, HUD)
+|   +-- skills/                  # Skills (73 directories)
+|   +-- rules/                   # Global rules (R000-R020)
+|   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (ecomode)
 +-- guides/                      # Reference docs (25 topics)
 ```

package/templates/CLAUDE.md.ko

@@ -129,6 +129,7 @@ oh-my-customcode로 구동됩니다.
 | R016 | 지속적 개선 | **강제** - 위반 발생 시 규칙 업데이트 |
 | R017 | 동기화 검증 | **강제** - 구조 변경 전 검증 |
 | R018 | Agent Teams | **강제(조건부)** - Agent Teams 활성화 시 적합한 작업에 필수 사용 |
+| R020 | 완료 검증 | **강제** - 작업 완료 선언 전 검증 필수 |
 
 ### SHOULD (강력 권장)
 | ID | 규칙 | 설명 |
@@ -157,6 +158,7 @@ oh-my-customcode로 구동됩니다.
 | `/omcustom:update-external` | 외부 소스에서 에이전트 업데이트 |
 | `/omcustom:audit-agents` | 에이전트 의존성 감사 |
 | `/omcustom:fix-refs` | 깨진 참조 수정 |
+| `/omcustom:takeover` | 기존 에이전트/스킬에서 canonical spec 추출 |
 | `/dev-review` | 코드 베스트 프랙티스 리뷰 |
 | `/dev-refactor` | 코드 리팩토링 |
 | `/memory-save` | 세션 컨텍스트를 claude-mem에 저장 |
@@ -184,9 +186,9 @@ project/
 +-- CLAUDE.md                    # 진입점
 +-- .claude/
 |   +-- agents/                  # 서브에이전트 정의 (44 파일)
-|   +-- skills/                  # 스킬 (71 디렉토리)
-|   +-- rules/                   # 전역 규칙 (R000-R019)
-|   +-- hooks/                   # 훅 스크립트 (메모리, HUD)
+|   +-- skills/                  # 스킬 (73 디렉토리)
+|   +-- rules/                   # 전역 규칙 (R000-R020)
+|   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- guides/                      # 레퍼런스 문서 (25 토픽)
 ```

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.35.2",
+  "version": "0.36.0",
   "lastUpdated": "2026-03-14T00:00:00.000Z",
   "components": [
     {