moai-adk 0.9.1__py3-none-any.whl → 0.10.1__py3-none-any.whl

{moai_adk-0.9.1.dist-info → moai_adk-0.10.1.dist-info}/RECORD

@@ -53,7 +53,8 @@ moai_adk/core/template/languages.py,sha256=V0wLcxCIOve9Q_0_NhrHGQevSIN_MB612GwrO
 moai_adk/core/template/merger.py,sha256=ZV8_U1HZJ3bfAtgyNmSxgj8KdTMt4eUnUG6kVVRT7bE,6909
 moai_adk/core/template/processor.py,sha256=_nYHiuN9PGzC3iE4X5SpRMFW-OTkI2u1dOAjD98axAk,19190
 moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
-moai_adk/templates/CLAUDE.md,sha256=dgVsp_srZJKnn04uegJ-9PxifVDwenSPBY0KxawFvEA,14278
+moai_adk/templates/CLAUDE.md,sha256=TjVPW-u2AtymQIvAc7yAHimetXGFaXoA35p9_rxYb_M,15790
+moai_adk/templates/README.md,sha256=727KhnlpzLukiKRy4ZBZpcn1QL9XtXehv2TUbN9w1ak,8791
 moai_adk/templates/__init__.py,sha256=6MV1gCB7PLZMiL4gaD_dZSKxtcQyo45MMTuN8fVdchA,104
 moai_adk/templates/.claude/settings.json,sha256=CJuGzZU84aWPS0UOcDYJxUOEVau60piT_X4kybyimuQ,3270
 moai_adk/templates/.claude/agents/alfred/cc-manager.md,sha256=gVw9NMzy6UJqQ20GEiYz8Sm03e-4TKNR1-0Lz0MGPTc,9264
@@ -73,8 +74,6 @@ moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=NROGRNbxXd-0kXX_eW_7
 moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=s8zU2146DXupi3vJHoTDZB3YPm0v1vRnP8p_sPtuIBo,24375
 moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=Pr9EGFol09l-MLdc2fFSOkpqA7jPHV1KPePqmfkKQgg,26619
 moai_adk/templates/.claude/commands/alfred/9-feedback.md,sha256=VMaKo-ZODHun87uUfiihtHGf8eT4vrEWwxXdQ9RAz3k,3764
-moai_adk/templates/.claude/hooks/alfred/README.md,sha256=LsSMvsxNwdV2CjA2X6Zn_xy73kT7-0Y7G-u_9bLKYlI,10568
-moai_adk/templates/.claude/hooks/alfred/TROUBLESHOOTING.md,sha256=xINO1G3ujccL42JQzExEm-oiY9jHGrXm2YAlxtYkZY4,10753
 moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=eOV-evpk8ChZD9_kMNmrRysCpy3ZMzV6cq1Oys0vRn0,9220
 moai_adk/templates/.claude/hooks/alfred/notification__handle_events.py,sha256=Gn-hSpMs6Oy6yJcluXUcmlXiyS48RmsDWZn1xu3tgLA,2911
 moai_adk/templates/.claude/hooks/alfred/post_tool__log_changes.py,sha256=7wxR2gQFX3nmBi9uC6KORjQGrQAv1y6JxJ_fcMxsw78,2939
@@ -84,12 +83,12 @@ moai_adk/templates/.claude/hooks/alfred/session_start__show_project_info.py,sha2
 moai_adk/templates/.claude/hooks/alfred/stop__handle_interrupt.py,sha256=0GrMBWOQreGqJM-Q8_B1kXLdPchDiEnpsQSJlBIByxo,2863
 moai_adk/templates/.claude/hooks/alfred/subagent_stop__handle_subagent_end.py,sha256=YmDOuvWa6OnSowsMitkRovekoJNq65pUPlmiTgQoBnE,2958
 moai_adk/templates/.claude/hooks/alfred/user_prompt__jit_load_docs.py,sha256=AOPc8EmNbKMFsOhk5d7nGZ7aZbm-ZH8MNT0_I1Wv-hE,3585
-moai_adk/templates/.claude/hooks/alfred/.moai/cache/version-check.json,sha256=D_Q4I_C-g6h4GqflzDOen1yPNrVFF6gXySga68VSQXg,250
+moai_adk/templates/.claude/hooks/alfred/core/project.py,sha256=LxcesuFDZDDBWQut-0ez_4kmTcrrNbsAZrb5GubWeA8,26953
 moai_adk/templates/.claude/hooks/alfred/core/version_cache.py,sha256=mOxvLtLiZDSCSlq0svECCJYIX0rPpNJOwL1KZjOB5yo,5967
 moai_adk/templates/.claude/hooks/alfred/shared/core/__init__.py,sha256=nx_02kZDVFlKOgxBfFz3nqVrxMkmrkE0x7crJhdjl5E,6377
 moai_adk/templates/.claude/hooks/alfred/shared/core/checkpoint.py,sha256=dsvFDSXQNSQlaQLpvhqFbytGOrOivyovi43Y18EmNeI,8483
 moai_adk/templates/.claude/hooks/alfred/shared/core/context.py,sha256=RQd6yk8OGT-twgYtUiNmJIL-UEt_h4oktxqiRP_wXAI,2103
-moai_adk/templates/.claude/hooks/alfred/shared/core/project.py,sha256=UPCYBYCmR1sz_gZGTFtGe6YKA3gXPk4ly6rexJ63xpg,24126
+moai_adk/templates/.claude/hooks/alfred/shared/core/project.py,sha256=1kr8ywemj6IQ8in4A2VccFxABmKT7lq7CFGKzwvtod4,27489
 moai_adk/templates/.claude/hooks/alfred/shared/core/tags.py,sha256=XcYYCS1VmCejp7Ga9xZ3hDfrWWsKM-WyPD_N5gY1q1w,6359
 moai_adk/templates/.claude/hooks/alfred/shared/core/version_cache.py,sha256=zt0a6__qsZVI_rfZuPv3JDpVZeUGLWBvYprTjSg_7gM,5965
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/__init__.py,sha256=j5L7nayKt7tnFQOZuO5sWiie815vmbmYJOn2VRiidLY,569
@@ -277,6 +276,7 @@ moai_adk/templates/.claude/skills/moai-spec-authoring/SKILL.md,sha256=JoHdTtLdDc
 moai_adk/templates/.claude/skills/moai-spec-authoring/examples.md,sha256=rLSWTioSN0njc6W1tcsZA-R_mVG55oEXysii1NRMZWg,14527
 moai_adk/templates/.claude/skills/moai-spec-authoring/reference.md,sha256=vTZ2BBo0mqpzhIcEGabyG7vXrm28V7qiQany5o_OxMQ,16124
 moai_adk/templates/.claude/skills/moai-spec-authoring/examples/validate-spec.sh,sha256=FSXNA_8v36sN4V-3HpGudOXJo2c4t2whf_5QNDn6FiE,4251
+moai_adk/templates/.git-hooks/pre-push,sha256=4BGVMllmG3c_4T1S_nVEWDGQbxeCDll-fIgxAUoSvrI,6468
 moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md,sha256=rzTnwxhccYZO_yHqsW5FaxIMhggfLO9xJ6D1IYMEQqc,2153
 moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml,sha256=fon91ozuKBeDwrw2BBuTSbkGApDEptNP9er5dW_-ZVc,5280
 moai_adk/templates/.github/workflows/moai-gitflow.yml,sha256=9QDqqscY7npu_1Sfsn0g9piX0QRDRZFhbEEwkZGXIG0,8684
@@ -284,37 +284,26 @@ moai_adk/templates/.github/workflows/moai-release-create.yml,sha256=KrHGkAep6iRy
 moai_adk/templates/.github/workflows/moai-release-pipeline.yml,sha256=kVpRk_OFgz0AVctLRLA2ASN-G_-prAHTGI7tufe6Pd0,6319
 moai_adk/templates/.github/workflows/release.yml,sha256=5h4-npHKU-t1mnOQePYcpkcdGCN_560-Obu5tUCyNe0,1382
 moai_adk/templates/.github/workflows/spec-issue-sync.yml,sha256=GIYeQQvwcoi0r-o85nEbSSLwT5EsrSEzJKLhLMX7GPk,6483
-moai_adk/templates/.github/workflows/tag-report.yml,sha256=zZ33OmLnRjBfWbnnYx_chpV_iY3rncCAbcVP708JQoE,9273
-moai_adk/templates/.github/workflows/tag-validation.yml,sha256=1JEbUzc0vHL4C2LTs0Q7rBREmrV5N5zM2WBYJ1NMCAI,6769
+moai_adk/templates/.github/workflows/tag-validation.yml,sha256=fo3GsPKO4XdQ4cfe6m8qXWyMza5rkt2LiR9aW7aEshw,6835
 moai_adk/templates/.moai/config.json,sha256=r7TtDLtS06YDP7EsqsghNfKCNkltVxVbmmSJHwQQV-s,2950
-moai_adk/templates/.moai/docs/quick-issue-creation-guide.md,sha256=tFJqsNr9SpXlGao6HXXm6I8FmC7yCkUo9cu6lE1GaVA,5460
-moai_adk/templates/.moai/hooks/install.sh,sha256=P1-RtiHp7m2QIUUcHQ_oHB1xnqRQnD5QePb2iUo7qfA,2112
-moai_adk/templates/.moai/hooks/pre-commit.sh,sha256=86UIhXMqJ4i24mKrLdzvyWXYSMK__EtXGSpE19wgVw4,1802
 moai_adk/templates/.moai/memory/CLAUDE-AGENTS-GUIDE.md,sha256=37Qj5DYcyUniLM1g8IU7UWFI_16tutZrcAkJc4E5i20,15876
 moai_adk/templates/.moai/memory/CLAUDE-PRACTICES.md,sha256=Tf3q68X1DiA3MkIBYu7AMXoeparYrDRpyqVI5Nw92OY,12653
 moai_adk/templates/.moai/memory/CLAUDE-RULES.md,sha256=S9GODGRzwwleOmROVtBDa471Ok5NyQLWIkaO_4peHhU,19783
 moai_adk/templates/.moai/memory/DEVELOPMENT-GUIDE.md,sha256=SAcue1J5-DEJpygDnTgp_ex-ok2E4lbcykBuBiC7tGs,14534
-moai_adk/templates/.moai/memory/GITFLOW-PROTECTION-POLICY.md,sha256=tm2ZOmNMvomAhh4_AGTUNjmSsc-eKzo1SGshojx2QL0,6228
 moai_adk/templates/.moai/memory/ISSUE-LABEL-MAPPING.md,sha256=bKzC2v1ZZWyng0eHSj9oFQ9w9xCbadPe9T9IYWub7wM,3824
 moai_adk/templates/.moai/memory/SKILLS-DESCRIPTION-POLICY.md,sha256=uMEFi6uojnpO_MGGtwhakYQzVF2yzVV9ZzfQe5tB0Hk,7823
-moai_adk/templates/.moai/memory/SPEC-METADATA.md,sha256=Ha4ATMxyH2PgQdVbS1fYwVH0PnIkfqk4hfuB5ksMFFk,9702
-moai_adk/templates/.moai/memory/gitflow-protection-policy.md,sha256=tm2ZOmNMvomAhh4_AGTUNjmSsc-eKzo1SGshojx2QL0,6228
+moai_adk/templates/.moai/memory/gitflow-protection-policy.md,sha256=UABdUWcA_085dZaQk7gaW2-ze3DV-BX399kKtbF1kGI,10401
 moai_adk/templates/.moai/memory/spec-metadata.md,sha256=Ha4ATMxyH2PgQdVbS1fYwVH0PnIkfqk4hfuB5ksMFFk,9702
 moai_adk/templates/.moai/project/product.md,sha256=IrRSqhu0o5KNfn453DUWoUKzdoO3m6013iYCwaHYCxM,5166
 moai_adk/templates/.moai/project/structure.md,sha256=YWZ4ggmfzveKx8SQGFQWXdDUh5mxOLkEyy5yVdR3Rn0,4791
 moai_adk/templates/.moai/project/tech.md,sha256=REecMv8wOvutt-pQZ5nlGk5YdReTan7AHcKJ2Yes6RM,5758
-moai_adk/templates/src/moai_adk/core/__init__.py,sha256=rbztODLKJooQ4ah3_Pjfk9wNM7qlMfXm5o7qotiNAK8,127
-moai_adk/templates/src/moai_adk/core/tags/__init__.py,sha256=nmZKs4eblrOzPg8JOHNkoaRzhPcUDGmMwvnUcyMZwGY,1985
-moai_adk/templates/src/moai_adk/core/tags/ci_validator.py,sha256=PScVKPROu12mnu02nFzi66i-1pdbbnoitGzheI1COV8,13679
-moai_adk/templates/src/moai_adk/core/tags/cli.py,sha256=1VWRT1k62FS5Yyzllat-nyLR3jqvGdyDkj1uOwPfavA,7344
 moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py,sha256=Y1G8qtuRjCaHGjQ-Nxn8k2UGOcHRd3EfdZrSqCqHAY4,10230
 moai_adk/templates/src/moai_adk/core/tags/reporter.py,sha256=fn9kc0FNNvaep5cXbA2RkYxbJsw7eq2PHbrZ_XFB1Wc,29301
-moai_adk/templates/src/moai_adk/core/tags/validator.py,sha256=B3xUDubfyT5RlPM3GLYktfe1EQTEdxOrDhD230_etoA,31138
 moai_adk/utils/__init__.py,sha256=VnVfQzzKHvKw4bNdEw5xdscnRQYFrnr-v_TOBr3naPs,225
 moai_adk/utils/banner.py,sha256=znppKd5yo-tTqgyhgPVJjstrTrfcy_v3X1_RFQxP4Fk,1878
 moai_adk/utils/logger.py,sha256=g-m07PGKjK2bKRIInfSn6m-024Bedai-pV_WjZKDeu8,5064
-moai_adk-0.9.1.dist-info/METADATA,sha256=BdmPP_9_s7nEwqrb13ZBJfIVdu3p4QHMrK8Ru93Uz_c,82377
-moai_adk-0.9.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.9.1.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.9.1.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.9.1.dist-info/RECORD,,
+moai_adk-0.10.1.dist-info/METADATA,sha256=k6LuNosCo-PVTVR2GzyUmmzuzaF5KPCD-EPHfqvKrzA,94329
+moai_adk-0.10.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.10.1.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.10.1.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.10.1.dist-info/RECORD,,

moai_adk/templates/.claude/hooks/alfred/.moai/cache/version-check.json

@@ -1,9 +0,0 @@
-{
-  "current": "0.8.1",
-  "latest": "0.8.1",
-  "update_available": false,
-  "upgrade_command": "",
-  "release_notes_url": "https://github.com/modu-ai/moai-adk/releases",
-  "is_major_update": false,
-  "last_check": "2025-10-29T08:52:11.240503+00:00"
-}

moai_adk/templates/.claude/hooks/alfred/README.md

@@ -1,343 +0,0 @@
-# Alfred Hooks System
-
-**Event-Driven Context Management for MoAI-ADK**
-
-Alfred Hooks integrates with Claude Code's event system to automatically manage project context, create checkpoints before risky operations, and provide just-in-time (JIT) document loading.
-
----
-
-## 📐 Architecture
-
-### Individual Hook Files (Event + Function Naming)
-
-```
-.claude/hooks/alfred/
-├── session_start__show_project_info.py       # SessionStart: Display project status
-├── user_prompt__jit_load_docs.py             # UserPromptSubmit: JIT document loading
-├── pre_tool__auto_checkpoint.py              # PreToolUse: Automatic safety checkpoints
-├── post_tool__log_changes.py                 # PostToolUse: Change tracking (stub)
-├── session_end__cleanup.py                   # SessionEnd: Cleanup resources (stub)
-├── notification__handle_events.py            # Notification: Event processing (stub)
-├── stop__handle_interrupt.py                 # Stop: Interrupt handling (stub)
-├── subagent_stop__handle_subagent_end.py     # SubagentStop: Sub-agent cleanup (stub)
-└── shared/                                    # Shared business logic
-    ├── core/                                  # Core modules
-    │   ├── __init__.py                       # Type definitions (HookPayload, HookResult)
-    │   ├── project.py                        # Language detection, Git info, SPEC counting
-    │   ├── context.py                        # JIT retrieval, workflow context
-    │   ├── checkpoint.py                     # Event-driven checkpoint creation
-    │   └── version_cache.py                  # Library version management
-    └── handlers/                              # Event handlers
-        ├── __init__.py                       # Handler exports
-        ├── session.py                        # SessionStart, SessionEnd handlers
-        ├── user.py                           # UserPromptSubmit handler
-        ├── tool.py                           # PreToolUse, PostToolUse handlers
-        └── notification.py                   # Notification, Stop handlers
-```
-
-### Design Principles
-
-- **Clarity First**: File names describe what each hook does (UX priority)
-- **DRY Implementation**: Shared logic in `shared/` modules (maintainability)
-- **Self-Documenting**: Event + Function naming convention (e.g., `session_start__show_project_info.py`)
-- **Independent Execution**: Each hook file is self-contained and executable
-- **Timeout Protection**: All hooks enforce 5-second SIGALRM timeout
-
----
-
-## 🎯 Hook Files
-
-### `session_start__show_project_info.py`
-
-**Event**: SessionStart
-**Purpose**: Display project information when session begins
-
-**Output**:
-- Programming language
-- Git branch and status
-- SPEC progress (completed/total %)
-- Recent checkpoints
-
-**Example**:
-```bash
-echo '{"cwd": "."}' | uv run session_start__show_project_info.py
-# Output: {"continue": true, "systemMessage": "🚀 MoAI-ADK v0.8.0 | 📦 python..."}
-```
-
----
-
-### `user_prompt__jit_load_docs.py`
-
-**Event**: UserPromptSubmit
-**Purpose**: Analyze prompt and recommend relevant documents
-
-**Features**:
-- Pattern matching for Alfred commands (`/alfred:1-plan` → spec-metadata.md)
-- @TAG mention detection
-- SPEC reference extraction
-- Document path suggestions
-
-**Output Schema** (UserPromptSubmit-specific):
-```json
-{
-  "continue": true,
-  "hookSpecificOutput": {
-    "hookEventName": "UserPromptSubmit",
-    "additionalContext": "Suggested documents: .moai/memory/spec-metadata.md"
-  }
-}
-```
-
----
-
-### `pre_tool__auto_checkpoint.py`
-
-**Event**: PreToolUse
-**Matcher**: `Edit|Write|MultiEdit`
-**Purpose**: Automatically create Git checkpoints before risky operations
-
-**Risky Operations Detected**:
-- **Bash**: `rm -rf`, `git merge`, `git reset --hard`
-- **Edit/Write**: `CLAUDE.md`, `config.json`, critical configuration files
-- **MultiEdit**: Operations affecting ≥10 files
-
-**Checkpoint Strategy**:
-1. Detect risky pattern
-2. Create checkpoint branch: `checkpoint/before-{operation}-{timestamp}`
-3. Log to `.moai/checkpoints.log`
-4. Return guidance message to user
-
-**Example**:
-```bash
-echo '{"toolName": "Bash", "arguments": {"command": "rm -rf temp/"}}' | uv run pre_tool__auto_checkpoint.py
-# Output: {"continue": true, "systemMessage": "✅ Checkpoint created: checkpoint/before-rm-20251029-174500"}
-```
-
----
-
-### Stub Hooks (Future Enhancement)
-
-**`post_tool__log_changes.py`**
-- Change tracking and audit logging
-- Metrics collection (files modified, lines changed)
-
-**`session_end__cleanup.py`**
-- Clear temporary caches
-- Save session metrics
-
-**`notification__handle_events.py`**
-- Filter and categorize notifications
-- Send alerts to external systems
-
-**`stop__handle_interrupt.py`**
-- Save partial work before interruption
-- Create recovery checkpoint
-
-**`subagent_stop__handle_subagent_end.py`**
-- Collect sub-agent execution metrics
-- Log results and errors
-
----
-
-## 🏗️ Shared Modules
-
-### `shared/core/` - Business Logic
-
-**`project.py`** (284 LOC)
-```python
-detect_language(cwd: str) -> str
-get_git_info(cwd: str) -> dict
-count_specs(cwd: str) -> dict
-```
-
-**`context.py`** (110 LOC)
-```python
-get_jit_context(prompt: str, cwd: str) -> list[str]
-```
-
-**`checkpoint.py`** (244 LOC)
-```python
-detect_risky_operation(tool: str, args: dict) -> tuple[bool, str]
-create_checkpoint(cwd: str, operation: str) -> str
-```
-
-### `shared/handlers/` - Event Processing
-
-**`session.py`** - SessionStart, SessionEnd
-**`user.py`** - UserPromptSubmit
-**`tool.py`** - PreToolUse, PostToolUse
-**`notification.py`** - Notification, Stop, SubagentStop
-
----
-
-## 🔧 Configuration
-
-### settings.json
-
-```json
-{
-  "hooks": {
-    "SessionStart": [{
-      "hooks": [{
-        "command": "uv run \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/alfred/session_start__show_project_info.py",
-        "type": "command"
-      }]
-    }],
-    "UserPromptSubmit": [{
-      "hooks": [{
-        "command": "uv run \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/alfred/user_prompt__jit_load_docs.py",
-        "type": "command"
-      }]
-    }],
-    "PreToolUse": [{
-      "hooks": [{
-        "command": "uv run \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/alfred/pre_tool__auto_checkpoint.py",
-        "type": "command"
-      }],
-      "matcher": "Edit|Write|MultiEdit"
-    }]
-  }
-}
-```
-
-**Key Changes**:
-- ✅ File names are self-descriptive (no arguments needed)
-- ✅ `$CLAUDE_PROJECT_DIR` for reliable path resolution
-- ✅ Each hook file is independent and testable
-
----
-
-## 🧪 Testing
-
-### Test Individual Hooks
-
-```bash
-# Test SessionStart hook
-echo '{"cwd": "."}' | uv run session_start__show_project_info.py
-
-# Test UserPromptSubmit hook
-echo '{"cwd": ".", "userPrompt": "/alfred:1-plan"}' | uv run user_prompt__jit_load_docs.py
-
-# Test PreToolUse hook
-echo '{"cwd": ".", "toolName": "Edit", "arguments": {"file_path": "CLAUDE.md"}}' | uv run pre_tool__auto_checkpoint.py
-```
-
-### Expected Output
-
-All hooks should return valid JSON with:
-- `"continue": true` (required field)
-- `"systemMessage"` or `"hookSpecificOutput"` (depending on hook type)
-
----
-
-## 🐛 Troubleshooting
-
-For detailed troubleshooting guide, see [TROUBLESHOOTING.md](./TROUBLESHOOTING.md).
-
-### Quick Diagnosis
-
-```bash
-# List all hook files
-ls -la .claude/hooks/alfred/*.py
-
-# Expected output:
-# session_start__show_project_info.py
-# user_prompt__jit_load_docs.py
-# pre_tool__auto_checkpoint.py
-# post_tool__log_changes.py
-# session_end__cleanup.py
-# notification__handle_events.py
-# stop__handle_interrupt.py
-# subagent_stop__handle_subagent_end.py
-```
-
-### Common Issues
-
-1. **"Hook not found"** → Run `/alfred:0-project update`
-2. **"Import error: No module named 'handlers'"** → Check `shared/handlers/__init__.py` exists
-3. **"Timeout"** → Check Git/file operations, consider increasing timeout in hook file
-4. **"Permission denied"** → Run `chmod +x .claude/hooks/alfred/*.py`
-
----
-
-## 🏗️ Architecture Decisions
-
-### Why Individual Hook Files? (UX Priority)
-
-**Before** (Single Router):
-```
-alfred_hooks.py SessionStart  ❌ Unclear what "SessionStart" does
-```
-
-**After** (Individual Files):
-```
-session_start__show_project_info.py  ✅ Immediately clear purpose
-```
-
-**Benefits**:
-1. ✅ **Self-Documenting**: File name describes functionality
-2. ✅ **Easy Debugging**: Error messages show which hook failed
-3. ✅ **Simple Discovery**: `ls` command shows all available hooks
-4. ✅ **Independent Testing**: Each hook can be tested in isolation
-5. ✅ **Selective Disabling**: Comment out specific hook in settings.json
-
-**Tradeoffs**:
-- ⚠️ **More Files**: 8 hook files instead of 1 router
-- ⚠️ **Shared Logic**: Still needs `shared/` directory for DRY principle
-
-**Decision**: **UX > Technical Elegance** - Users benefit from clarity
-
-### Why Keep shared/ Directory? (DRY Principle)
-
-**Shared Logic** (70% of codebase):
-- Type definitions (HookResult, HookPayload)
-- Project metadata (language detection, Git info)
-- Checkpoint creation
-- JIT context analysis
-
-**Alternative** (Code Duplication):
-```python
-# ❌ BAD: Copy HookResult to each hook file
-# session_start__show_project_info.py
-class HookResult:  # 50 LOC duplicated
-    ...
-
-# user_prompt__jit_load_docs.py
-class HookResult:  # 50 LOC duplicated again
-    ...
-```
-
-**Current** (Shared Module):
-```python
-# ✅ GOOD: Import from shared module
-from shared.core import HookResult  # DRY principle
-```
-
-**Decision**: **Hybrid Approach** - Individual files for UX + Shared modules for DRY
-
----
-
-## 📈 Version History
-
-### v0.9.0 (2025-10-29) - Individual Hook Files (UX Priority)
-- ✅ **BREAKING**: Split `alfred_hooks.py` into 8 individual files
-- ✅ **NAMING**: Event + Function naming convention (`session_start__show_project_info.py`)
-- ✅ **STRUCTURE**: Moved shared logic to `shared/` directory
-- ✅ **UX**: File names are self-descriptive (no arguments needed)
-- ✅ **DEBUGGING**: Error messages now show which hook failed
-
-### v0.8.0 (2025-10-29) - Path Resolution & Timeout Fixes
-- ✅ **FIXED**: Use `$CLAUDE_PROJECT_DIR` for reliable path resolution
-- ✅ **ADDED**: Global SIGALRM timeout protection (5 seconds)
-- ✅ **ADDED**: Comprehensive TROUBLESHOOTING.md guide
-
-### v0.7.0 (2025-10-17) - Stateless Refactoring
-- ✅ **REMOVED**: Workflow context from hooks (delegated to Commands layer)
-- ✅ **PERFORMANCE**: 180ms → 70ms (61% improvement)
-- ✅ **COMPLIANCE**: 100% stateless (no global variables)
-
----
-
-**Last Updated**: 2025-10-29
-**Version**: 0.9.0
-**Author**: @Alfred (MoAI-ADK SuperAgent)