moai-adk 0.8.2__py3-none-any.whl → 0.9.0__py3-none-any.whl

{moai_adk-0.8.2.dist-info → moai_adk-0.9.0.dist-info}/RECORD

@@ -11,10 +11,10 @@ moai_adk/cli/commands/update.py,sha256=yy6fZA2ySJS6Nsr6wBI63eEYAzGXBoRMhb1ZKEwi5
 moai_adk/cli/prompts/__init__.py,sha256=a4_ctS4KEvGtmM9j7z8XIlMkpftohjVb9woUwZu38gE,136
 moai_adk/cli/prompts/init_prompts.py,sha256=OZ_T-b4XfkyXQsKXTwLcDYwmLbaf0k5oZfbi_asTH9M,5226
 moai_adk/core/__init__.py,sha256=1sJO-PHEKF1NmYjeOPPPzn_HRgYln3CKlCpUH4E2Jrs,129
-moai_adk/core/issue_creator.py,sha256=guE8LMi9JaiJkHgIz_gE9pJwjteWLsY4myrYTY6uius,9520
+moai_adk/core/issue_creator.py,sha256=sKhZzXMTc5_8_CIEk7iYBSaCYfq8CawpWMgJjYFrpRE,9547
 moai_adk/core/template_engine.py,sha256=08--7FE4VWQxIBOTooi9irfe2UOjBQPRWOfOtY0RhJE,9023
 moai_adk/core/config/__init__.py,sha256=30Qx-GSN1LLI_9ngNqQ6A6d40J92xK10AQxhKw1-MzU,328
-moai_adk/core/config/migration.py,sha256=KzFGx3kPNoOaZCmAQvNpvlrQq48N3Gj6o2COVV7jciA,3541
+moai_adk/core/config/migration.py,sha256=-rPC1C9EGcBvlCXnQoBOk5ktw7AXSJPX0TXsujr4r5A,3562
 moai_adk/core/diagnostics/__init__.py,sha256=aF-qC2CW0wxZDpxnlh-TILYs3kqwOIj2EjXYEXY-2j8,387
 moai_adk/core/diagnostics/slash_commands.py,sha256=cEH96M5RLxa1JLyoeoRqziBMzAbnN30j04YjNjxM7Ro,4682
 moai_adk/core/git/__init__.py,sha256=Kpq2yU5X5bBBUV8ySYIB1_vMPvfdFS6hTYx2Ue-CoeQ,697
@@ -35,17 +35,17 @@ moai_adk/core/quality/__init__.py,sha256=_uNsbThBLmVLWZCPmEgfFyQqJx3tdef9jhkP9Qo
 moai_adk/core/quality/trust_checker.py,sha256=CN067AiublAH46IBAKEV_I-8Wc0bNaR2dMnMf9n5oBg,15198
 moai_adk/core/quality/validators/__init__.py,sha256=Q53sqQFOK7GnwshPVi0HvUSq_VCvHEL28-V5J_L9LoE,189
 moai_adk/core/quality/validators/base_validator.py,sha256=8Fk5casPdfRtnlEfslIK6mOYsZeZLWIK_MAebWCrNw4,437
-moai_adk/core/tags/__init__.py,sha256=BJ83UcG0lTQMN3wBy4dkmHWLLIkGITmJQYH0CEH3KJM,1986
-moai_adk/core/tags/ci_validator.py,sha256=mZm78VgwLNIoGvw4xYkZLZAJib0LGQ8jZCoFOTkFOew,13754
-moai_adk/core/tags/cli.py,sha256=IKukBQoyjPdB3asrXiuCJpaT8U1Gz26OBauNXKGAJTs,7344
+moai_adk/core/tags/__init__.py,sha256=nmZKs4eblrOzPg8JOHNkoaRzhPcUDGmMwvnUcyMZwGY,1985
+moai_adk/core/tags/ci_validator.py,sha256=PScVKPROu12mnu02nFzi66i-1pdbbnoitGzheI1COV8,13679
+moai_adk/core/tags/cli.py,sha256=1VWRT1k62FS5Yyzllat-nyLR3jqvGdyDkj1uOwPfavA,7344
 moai_adk/core/tags/generator.py,sha256=xVopAAez8K5pNSHWZOGZXEWYIre53lTtfHUlR7i-vNE,3407
 moai_adk/core/tags/inserter.py,sha256=_1lsMTyyrjGidAKqi4y925msHxK6gHLAsu3O8-O2vFM,2823
 moai_adk/core/tags/mapper.py,sha256=ldcfMFzsk-ESKpXAptYydqx2NZ951utqKOXZVTHMeIE,3955
 moai_adk/core/tags/parser.py,sha256=3LpNcL47xT3u4b3Fdf9wYnltChDrNAEV4EtnHqLN1MA,2098
-moai_adk/core/tags/pre_commit_validator.py,sha256=1eA2RLFaFgRHKYKnHWfst_n3_TL8jJiLK53wb2_-dIA,10290
-moai_adk/core/tags/reporter.py,sha256=8KNf5L3PEMcsq0CEJ08c4GQYzt5mYtzDHOsxRBlU1hA,29400
+moai_adk/core/tags/pre_commit_validator.py,sha256=9lFC5bNv1vQbfRusxNdHBl9FBbHDPdyipF5CITBSHMs,10282
+moai_adk/core/tags/reporter.py,sha256=TQEyM2F_4cGreYyI0iJgDTqoR0Y8XL4M0oG4ZX1LBgc,29362
 moai_adk/core/tags/tags.py,sha256=Fylt030vrDqhSWivwRbxxwu_uQhilei0SFk_xVzy9UI,4248
-moai_adk/core/tags/validator.py,sha256=RH4NMX2TMtZ3IfGUHzlk-q0EzWWev5m9dYSehaXfxkE,31138
+moai_adk/core/tags/validator.py,sha256=B3xUDubfyT5RlPM3GLYktfe1EQTEdxOrDhD230_etoA,31138
 moai_adk/core/template/__init__.py,sha256=BB65Zkar2Oywt1_RFtQKIup6HXq20VNQrYqXD_Qp1_g,354
 moai_adk/core/template/backup.py,sha256=44y3QGCKsYqrRPbzkB1xNM9qtpG6kNNMcWR8DnAcPiQ,3228
 moai_adk/core/template/config.py,sha256=ZJU9UKSGF2tkPiwSFReoCkAHGQ0aN2jKmIIQt88x5-o,3532
@@ -54,6 +54,7 @@ moai_adk/core/template/merger.py,sha256=ZV8_U1HZJ3bfAtgyNmSxgj8KdTMt4eUnUG6kVVRT
 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/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
@@ -69,12 +70,10 @@ moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=oQIPS_Pa-VGiTZn4DH1
 moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=W0PwBgmdOhG_tb3dl-G-nFJtdL_0uLxjkGe1PLtUick,10691
 moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=ISdkXhZvwEYCBKVIHYyMGAHInr4ToLf4zVvNSwRVABA,14583
 moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=YFvND5qGRMqYqj9jWOAuv8OABK2eRcAn7cpciqhl92g,46903
-moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=tD_C30pm24yWfwkSOQMYyAQxLgcg4qbYTxpBzCkV3wg,25918
-moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=SVyJQoZJIQWr2rDqz8QTbLFXGney_ev5gT4WoLyU7w8,21270
-moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=jLCRe8UUC2Iof8Kg1rruvw6LS0TILnL7mg5UgdWrBtU,23397
+moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=NROGRNbxXd-0kXX_eW_7m6mSfUNkv6sfw30jJEQI3Zc,29056
+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,14 +83,14 @@ 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/version_cache.py,sha256=qqrID2f7JZsEXXRf4kz_KtwAXBK-g0r-CixuXxM7vig,5972
+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=nnjdVPGShDNirrF2X5KN1lWQ0kfSfYeQBSrrIeig1h8,23496
+moai_adk/templates/.claude/hooks/alfred/shared/core/project.py,sha256=CFgU2JomkOtXUD02DHIYyRF1gNqtLckd7Kuaz83ecMc,26948
 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=qqrID2f7JZsEXXRf4kz_KtwAXBK-g0r-CixuXxM7vig,5972
+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
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/notification.py,sha256=8TcEqGlz4EpLf2lpouaIuhVbpKOVeY31KPmIq2snt9U,662
 moai_adk/templates/.claude/hooks/alfred/shared/handlers/session.py,sha256=WkTiwgwce089eUkY1cT7WdXpSqpbmj-IIWTdRd3Ihqk,7278
@@ -284,36 +283,23 @@ 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=L6NMZhb4q_K4toKvyYG1hvBFT3fBNJaiONtL7OefTCw,6758
 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/CONFIG-SCHEMA.md,sha256=XmvogEnGedRItVc9OABKr4lDNEZhcKZQ3Qa6KlfxE3E,12477
 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=UABdUWcA_085dZaQk7gaW2-ze3DV-BX399kKtbF1kGI,10401
 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=BJ83UcG0lTQMN3wBy4dkmHWLLIkGITmJQYH0CEH3KJM,1986
-moai_adk/templates/src/moai_adk/core/tags/ci_validator.py,sha256=mZm78VgwLNIoGvw4xYkZLZAJib0LGQ8jZCoFOTkFOew,13754
-moai_adk/templates/src/moai_adk/core/tags/cli.py,sha256=IKukBQoyjPdB3asrXiuCJpaT8U1Gz26OBauNXKGAJTs,7344
-moai_adk/templates/src/moai_adk/core/tags/pre_commit_validator.py,sha256=1eA2RLFaFgRHKYKnHWfst_n3_TL8jJiLK53wb2_-dIA,10290
-moai_adk/templates/src/moai_adk/core/tags/reporter.py,sha256=8KNf5L3PEMcsq0CEJ08c4GQYzt5mYtzDHOsxRBlU1hA,29400
-moai_adk/templates/src/moai_adk/core/tags/validator.py,sha256=RH4NMX2TMtZ3IfGUHzlk-q0EzWWev5m9dYSehaXfxkE,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.8.2.dist-info/METADATA,sha256=HHPxuV_a1xMadFqt3DLz-3sbQl40rJUPLMfQYKtExb4,81109
-moai_adk-0.8.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.8.2.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.8.2.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.8.2.dist-info/RECORD,,
+moai_adk-0.9.0.dist-info/METADATA,sha256=qGcW3rCkcOjeWJA4su-DmRl_znCcO_V2dyarpX1aJuE,93964
+moai_adk-0.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.9.0.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.9.0.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.9.0.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)