moai-adk 0.34.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

moai_adk/templates/.claude/output-styles/moai/r2d2.md

@@ -526,6 +526,81 @@ Example Application:
 
 ---
 
+## Insight Protocol (Explanary Mode Integration)
+
+### What Are Insights?
+
+Insights are educational interjections that explain the "why" behind implementation choices, codebase patterns, and technical decisions. They help developers understand not just what code does, but why it was written that way.
+
+### Insight Format
+
+```
+★ Insight ─────────────────────────────────────
+[Explanatory content about the decision/pattern]
+─────────────────────────────────────────────────
+```
+
+### When to Add Insights
+
+Add an Insight after:
+
+1. **Code Blocks**: Explain why this specific pattern or approach was chosen
+   - Why this library/framework?
+   - Why this architecture pattern?
+   - What alternatives were considered?
+
+2. **Technical Decisions**: Explain trade-offs and rationale
+   - Performance vs. maintainability considerations
+   - Security implications
+   - Scalability concerns
+
+3. **Architecture Choices**: Explain structural decisions
+   - Why this component structure?
+   - Why these dependencies?
+   - How does this fit the overall system?
+
+4. **Tests**: Explain testing strategy
+   - Why this specific test case?
+   - What edge cases are covered?
+   - What's the testing philosophy?
+
+### Insight Content Guidelines
+
+Each Insight should include:
+
+**What**: Clear statement of what was done
+**Why**: Rationale for the approach
+**Alternatives Considered**: Other options and why they were not chosen (optional but valuable)
+**Implications**: Any important consequences or considerations
+
+Example Insight:
+```
+★ Insight ─────────────────────────────────────
+This code uses the Repository Pattern to separate data access logic from business logic.
+
+Why: This makes the codebase easier to test and maintain. Business logic doesn't need to know about database specifics.
+
+Alternatives Considered:
+- Active Record: Simpler but couples domain logic to data access
+- Data Mapper: More complex but offers cleaner separation
+
+Implications: You'll need to create a new Repository interface when adding new data sources.
+─────────────────────────────────────────────────
+```
+
+### Insight vs. Existing R2-D2 Sections
+
+| Section | Purpose | When Used |
+|---------|---------|-----------|
+| 💡 REQUEST ANALYSIS | Summarize user request | Start of task |
+| 📊 PROPOSED STRATEGY | Explain overall approach | Planning phase |
+| ★ Insight | Explain specific decision | After code/decision |
+| ✅ RESULT SUMMARY | What was accomplished | End of phase |
+
+Insights complement existing R2-D2 sections by providing deeper context for specific technical choices, whereas REQUEST ANALYSIS and PROPOSED STRATEGY operate at the task level.
+
+---
+
 ## Response Template
 
 🤖 R2-D2 ★ Code Insight ───────────────────────────────────
@@ -542,6 +617,10 @@ Phase-based Implementation with Verification at Each Step
 
 ✅ RESULT SUMMARY: What was accomplished
 
+★ Insight ─────────────────────────────────────
+(Optional) Explain key implementation choices, patterns used, and alternatives considered
+─────────────────────────────────────────────────
+
 ❓ NEXT DIRECTION: Use AskUserQuestion to determine next steps and priorities
 
 ---
@@ -554,7 +633,11 @@ Every interaction should feel like working with an experienced colleague who ask
 
 ---
 
-Version: 2.1.0 (Philosopher Framework Integration)
-Last Updated: 2025-12-19
+Version: 2.2.0 (Explanary Style Insights Integration)
+Last Updated: 2026-01-06
 Compliance: Documentation Standards, User Interaction Architecture, AskUserQuestion Constraints
-New Features: Strategic Thinking section with First Principles, Trade-off Matrix, Cognitive Bias Check
+New Features:
+- Insight Protocol section for educational interjections
+- ★ Insight block in Response Template for explaining implementation choices
+- Guidelines for when and how to add Insights
+Changes from v2.1.0: Added Explanary-style Insights integration to help developers understand the "why" behind code decisions

moai_adk/templates/.claude/output-styles/moai/yoda.md

@@ -354,6 +354,6 @@ Your role is to develop true technical masters through theoretical wisdom, not j
 
 ---
 
-Version: 2.0.0 (CLAUDE.md v8.1.0 Compliance)
-Last Updated: 2025-12-04
+Version: 2.1.0 (CLAUDE.md v9.0.0 Compliance)
+Last Updated: 2026-01-06
 Compliance: Documentation Standards, User Interaction Architecture, AskUserQuestion Constraints

moai_adk/templates/.claude/settings.json

@@ -1,21 +1,11 @@
 {
-  "companyAnnouncements": [
-    "🗿 MoAI-ADK: SPEC-First TDD with 135+ Skills and Context7 integration",
-    "📋 Commands: /moai:0-project (Setup) → /moai:1-plan (SPEC) → /moai:2-run (TDD) → /moai:3-sync (Docs)",
-    "🤖 Agents: 7-Tier hierarchy (workflow → core → domain → mcp → factory → support → ai)",
-    "🔄 Workflow: RED-GREEN-REFACTOR cycle with Git 3-Mode strategy (Manual/Personal/Team)",
-    "✅ Quality: TRUST 5 principles with ≥90% test coverage enforced",
-    "📚 Context7: Real-time library docs for hallucination-free code generation",
-    "🎯 Core Commands: /moai:1-plan generates SPEC → /moai:2-run implements TDD → /moai:3-sync creates docs",
-    "⚡ Agent Examples: workflow-tdd (TDD cycle), code-backend (API), mcp-context7 (docs), factory-skill (Skills)"
-  ],
   "hooks": {
     "SessionStart": [
       {
         "hooks": [
           {
             "type": "command",
-            "command": "uv run {{PROJECT_DIR}}/.claude/hooks/moai/session_start__show_project_info.py"
+            "command": "uv run \"{{PROJECT_DIR}}\"/.claude/hooks/moai/session_start__show_project_info.py"
           }
         ]
       }
@@ -25,7 +15,41 @@
         "hooks": [
           {
             "type": "command",
-            "command": "uv run {{PROJECT_DIR}}/.claude/hooks/moai/session_end__auto_cleanup.py"
+            "command": "uv run \"{{PROJECT_DIR}}\"/.claude/hooks/moai/session_end__auto_cleanup.py &"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run \"{{PROJECT_DIR}}\"/.claude/hooks/moai/pre_tool__security_guard.py",
+            "timeout": 5000
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write|Edit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "uv run \"{{PROJECT_DIR}}\"/.claude/hooks/moai/post_tool__code_formatter.py",
+            "timeout": 30000
+          },
+          {
+            "type": "command",
+            "command": "uv run \"{{PROJECT_DIR}}\"/.claude/hooks/moai/post_tool__linter.py",
+            "timeout": 60000
+          },
+          {
+            "type": "command",
+            "command": "uv run \"{{PROJECT_DIR}}\"/.claude/hooks/moai/post_tool__ast_grep_scan.py",
+            "timeout": 30000
           }
         ]
       }
@@ -34,89 +58,118 @@
   "permissions": {
     "defaultMode": "default",
     "allow": [
-      "Task",
       "AskUserQuestion",
-      "Skill",
-      "Read",
-      "Write",
+      "BashOutput",
       "Edit",
+      "Glob",
+      "Grep",
+      "KillShell",
       "MultiEdit",
       "NotebookEdit",
-      "Grep",
-      "Glob",
+      "Read",
+      "Skill",
+      "Task",
       "TodoWrite",
       "WebFetch",
       "WebSearch",
-      "BashOutput",
-      "KillShell",
-      "mcp__context7__resolve-library-id",
+      "Write",
       "mcp__context7__get-library-docs",
+      "mcp__context7__resolve-library-id",
       "mcp__sequential-thinking__*",
       "Bash(git status:*)",
       "Bash(git log:*)",
       "Bash(git diff:*)",
-      "Bash(git branch:*)",
       "Bash(git show:*)",
+      "Bash(git blame:*)",
+      "Bash(git branch:*)",
       "Bash(git remote:*)",
-      "Bash(git tag:*)",
       "Bash(git config:*)",
-      "Bash(rg:*)",
-      "Bash(ls:*)",
-      "Bash(echo:*)",
-      "Bash(which:*)",
-      "Bash(make:*)",
-      "Bash(python:*)",
-      "Bash(uv:*)",
-      "Bash(pytest:*)",
-      "Bash(mypy:*)",
-      "Bash(ruff:*)",
-      "Bash(black:*)",
-      "Bash(coverage:*)",
-      "Bash(moai-adk:*)",
-      "Bash(moai:*)",
-      "Bash(gh pr create:*)",
-      "Bash(gh pr view:*)",
-      "Bash(gh pr list:*)",
-      "Bash(gh repo view:*)",
+      "Bash(git tag:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)",
+      "Bash(git pull:*)",
+      "Bash(git fetch:*)",
+      "Bash(git checkout:*)",
+      "Bash(git switch:*)",
+      "Bash(git stash:*)",
+      "Bash(git merge:*)",
+      "Bash(git revert:*)",
       "Bash(gh issue:*)",
-      "Bash(mkdir:*)",
-      "Bash(touch:*)",
-      "Bash(cp:*)",
-      "Bash(mv:*)",
+      "Bash(gh pr:*)",
+      "Bash(gh repo view:*)",
+      "Bash(ls:*)",
+      "Bash(cat:*)",
+      "Bash(less:*)",
+      "Bash(head:*)",
+      "Bash(tail:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
       "Bash(tree:*)",
-      "Bash(diff:*)",
+      "Bash(pwd:*)",
       "Bash(wc:*)",
+      "Bash(diff:*)",
+      "Bash(comm:*)",
       "Bash(sort:*)",
       "Bash(uniq:*)",
-      "Bash(xargs:*)",
-      "Bash(comm:*)",
+      "Bash(cut:*)",
+      "Bash(awk:*)",
+      "Bash(sed:*)",
+      "Bash(basename:*)",
+      "Bash(dirname:*)",
+      "Bash(realpath:*)",
+      "Bash(readlink:*)",
+      "Bash(cp:*)",
+      "Bash(mv:*)",
+      "Bash(mkdir:*)",
+      "Bash(touch:*)",
+      "Bash(rsync:*)",
+      "Bash(curl:*)",
+      "Bash(jq:*)",
+      "Bash(yq:*)",
+      "Bash(python:*)",
+      "Bash(python3:*)",
+      "Bash(node:*)",
+      "Bash(npm:*)",
+      "Bash(npx:*)",
+      "Bash(uv:*)",
+      "Bash(pip:*)",
+      "Bash(pip3:*)",
+      "Bash(black:*)",
+      "Bash(ruff:*)",
+      "Bash(pylint:*)",
+      "Bash(flake8:*)",
+      "Bash(mypy:*)",
+      "Bash(eslint:*)",
+      "Bash(prettier:*)",
+      "Bash(pytest:*)",
+      "Bash(coverage:*)",
+      "Bash(make:*)",
+      "Bash(ast-grep:*)",
+      "Bash(sg:*)",
+      "Bash(rg:*)",
+      "Bash(echo:*)",
+      "Bash(printf:*)",
+      "Bash(test:*)",
+      "Bash(true:*)",
+      "Bash(false:*)",
+      "Bash(which:*)",
+      "Bash(type:*)",
+      "Bash(man:*)",
+      "Bash(pydoc:*)",
       "Bash(lsof:*)",
       "Bash(time:*)",
-      "Bash(cat:*)",
-      "Bash(find:*)",
-      "Bash(sed:*)",
-      "Bash(python3:*)"
+      "Bash(xargs:*)",
+      "Bash(moai-adk:*)",
+      "Bash(moai:*)"
     ],
     "ask": [
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(git push:*)",
-      "Bash(git merge:*)",
-      "Bash(git checkout:*)",
-      "Bash(git rebase:*)",
-      "Bash(git reset:*)",
-      "Bash(git stash:*)",
-      "Bash(git revert:*)",
-      "Bash(gh pr merge:*)",
-      "Bash(uv add:*)",
-      "Bash(uv remove:*)",
-      "Bash(pip install:*)",
-      "Bash(pip3 install:*)",
       "Bash(rm:*)",
       "Bash(sudo:*)",
-      "Bash(rm -rf:*)"
+      "Bash(chmod:*)",
+      "Bash(chown:*)",
+      "Read(./.env)",
+      "Read(./.env.*)"
     ],
     "deny": [
       "Read(./secrets/**)",
@@ -141,32 +194,56 @@
       "Glob(~/.config/gcloud/**)",
       "Bash(rm -rf /:*)",
       "Bash(rm -rf /*:*)",
+      "Bash(rm -rf ~:*)",
+      "Bash(rm -rf ~/*:*)",
       "Bash(rm -rf C\\:/:*)",
       "Bash(rm -rf C\\:/*:*)",
       "Bash(del /S /Q C\\:/:*)",
       "Bash(rmdir /S /Q C\\:/:*)",
+      "Bash(git push --force:*)",
+      "Bash(git push -f:*)",
+      "Bash(git push --force-with-lease:*)",
+      "Bash(git reset --hard:*)",
+      "Bash(git clean -fd:*)",
+      "Bash(git clean -fdx:*)",
+      "Bash(git rebase -i:*)",
       "Bash(format:*)",
       "Bash(chmod -R 777:*)",
+      "Bash(chmod 777:*)",
       "Bash(dd:*)",
       "Bash(mkfs:*)",
       "Bash(fdisk:*)",
       "Bash(reboot:*)",
       "Bash(shutdown:*)",
-      "Bash(git push --force:*)",
-      "Bash(git push --force-with-lease:*)",
-      "Bash(git reset --hard:*)",
-      "Bash(git rebase -i:*)"
+      "Bash(init:*)",
+      "Bash(systemctl:*)",
+      "Bash(kill -9:*)",
+      "Bash(killall:*)",
+      "Bash(DROP DATABASE:*)",
+      "Bash(DROP TABLE:*)",
+      "Bash(TRUNCATE:*)",
+      "Bash(DELETE FROM:*)",
+      "Bash(mongo:*)",
+      "Bash(mongosh:*)",
+      "Bash(redis-cli FLUSHALL:*)",
+      "Bash(redis-cli FLUSHDB:*)",
+      "Bash(psql -c DROP:*)",
+      "Bash(mysql -e DROP:*)"
     ]
   },
   "statusLine": {
     "type": "command",
-    "command": "uv run moai-adk statusline",
+    "command": "moai-adk statusline",
     "padding": 0,
     "refreshInterval": 300
   },
-  "outputStyle": "R2-D2",
+  "outputStyle": "Mr.Alfred",
   "cleanupPeriodDays": 30,
   "env": {
-    "MOAI_CONFIG_SOURCE": "sections"
+    "MOAI_CONFIG_SOURCE": "sections",
+    "ENABLE_TOOL_SEARCH": "1",
+    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
+    "MAX_THINKING_TOKENS": "31999",
+    "CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS": "55555"
   }
-}
+}