feat: add ast-grep SessionStart hook and setup command

.claude/settings.json

@@ -29,22 +29,23 @@
           {
             "type": "command",
             "command": "bunx @pleaseai/code format --stdin",
-            "timeout": 30
+            "timeout": 10
           },
           {
             "type": "command",
             "command": "bunx @pleaseai/code lsp --stdin",
-            "timeout": 60
+            "timeout": 5
           }
         ]
       }
     ]
   },
   "enabledPlugins": {
-    "hookify@claude-plugins-official": false,
+    "hookify@claude-plugins-official": true,
     "github@claude-plugins-official": true,
     "asana@claude-plugins-official": true,
     "typescript-lsp@claude-plugins-official": true,
-    "context7@claude-plugins-official": true
+    "context7@claude-plugins-official": true,
+    "plugin-dev@claude-plugins-official": true
   }
 }

.please/config.json

@@ -72,7 +72,7 @@
   "code_workspace": {
     "enabled": true
   },
-  "lsp": {},
+  "lsp": false,
   "ignore_patterns": [],
   "language": "en",
   "integrations": {

.please/memory/progress.txt

@@ -0,0 +1,8 @@
+# Please:Dev Progress
+Feature: Create documentation site at apps/docs
+Session: 20251221-docs-site
+Phase: 1/8 (Discovery)
+Tasks: 0/0 completed
+Last Task: None
+Last Checkpoint: None
+Updated: 2025-12-21T10:00:00Z

apps/docs/package.json

@@ -11,9 +11,9 @@
   },
   "dependencies": {
     "better-sqlite3": "^12.2.0",
-    "docs-please": "^0.2.5",
+    "docs-please": "^0.2.6",
     "nuxt": "^4.2.1",
-    "zod": "^4.2.1",
+    "zod": "^4.0.0",
     "zod-to-json-schema": "^3.25.0"
   },
   "devDependencies": {

hooks/hooks.json

@@ -1,18 +1,29 @@
 {
   "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bun $CLAUDE_PLUGIN_ROOT/hooks/scripts/ast-grep-context.ts",
+            "timeout": 5
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Write|Edit",
         "hooks": [
           {
             "type": "command",
-            "command": "npx @pleaseai/code format --stdin",
-            "timeout": 30
+            "command": "bunx @pleaseai/code format --stdin",
+            "timeout": 10
           },
           {
             "type": "command",
-            "command": "npx @pleaseai/code lsp --stdin",
-            "timeout": 30
+            "command": "bunx @pleaseai/code lsp --stdin",
+            "timeout": 10
           }
         ]
       }

hooks/scripts/ast-grep-context.ts

@@ -0,0 +1,55 @@
+/**
+ * SessionStart hook script that provides ast-grep context
+ * Outputs JSON with additionalContext for Claude Code sessions
+ */
+
+import { $ } from 'bun'
+
+export const INSTALLED_CONTEXT = `When searching or modifying code, use ast-grep instead of grep, ripgrep, ag, sed, or regex-only tools. ast-grep matches against the AST (Abstract Syntax Tree), enabling safe, language-aware queries and rewrites.
+
+Always prefer ast-grep for code analysis, queries, or refactoring tasks.
+
+For detailed patterns and examples, use the ast-grep skill.`
+
+export const NOT_INSTALLED_CONTEXT = `Consider installing ast-grep for better code search (AST-based, language-aware):
+
+  npx @pleaseai/code setup ast-grep   # Recommended (local cache)
+  brew install ast-grep               # macOS
+  cargo install ast-grep              # Rust
+
+After installation, use ast-grep instead of grep/ripgrep/sed for code operations.`
+
+export async function checkAstGrepInstalled(): Promise<boolean> {
+  return await $`which ast-grep`
+    .quiet()
+    .then(() => true)
+    .catch(() => false)
+}
+
+export function getAdditionalContext(isInstalled: boolean): string {
+  return isInstalled ? INSTALLED_CONTEXT : NOT_INSTALLED_CONTEXT
+}
+
+export interface HookOutput {
+  hookSpecificOutput: {
+    hookEventName: string
+    additionalContext: string
+  }
+}
+
+export function createHookOutput(additionalContext: string): HookOutput {
+  return {
+    hookSpecificOutput: {
+      hookEventName: 'SessionStart',
+      additionalContext,
+    },
+  }
+}
+
+// Only run when executed directly
+if (import.meta.main) {
+  const isInstalled = await checkAstGrepInstalled()
+  const additionalContext = getAdditionalContext(isInstalled)
+  const output = createHookOutput(additionalContext)
+  console.log(JSON.stringify(output))
+}

hooks/scripts/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@pleaseai/hooks-scripts",
+  "type": "module",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Claude Code hook scripts",
+  "author": "Minsu Lee",
+  "license": "MIT",
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "bun test ./test"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  }
+}