oh-my-customcode 0.64.3 → 0.65.0

package/dist/cli/index.js

@@ -9325,7 +9325,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.64.3",
+    version: "0.65.0",
     description: "Batteries-included agent harness for Claude Code",
     type: "module",
     bin: {

package/dist/index.js

@@ -1674,7 +1674,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.64.3",
+  version: "0.65.0",
   description: "Batteries-included agent harness for Claude Code",
   type: "module",
   bin: {

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.64.3",
+  "version": "0.65.0",
   "description": "Batteries-included agent harness for Claude Code",
   "type": "module",
   "bin": {

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

@@ -127,6 +127,18 @@
         "description": "Scan TODO.md files for stale items at session start"
       }
     ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/user-prompt-preprocessor.sh"
+          }
+        ],
+        "description": "Advisory pre-processing of user input — skill matching hints and intent analysis"
+      }
+    ],
     "SubagentStart": [
       {
         "matcher": "*",
@@ -159,13 +171,85 @@
         "description": "Record agent outcomes + auto-continue workflow on subagent completion"
       }
     ],
+    "CwdChanged": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/cwd-change-detector.sh"
+          }
+        ],
+        "description": "Auto-detect project type on working directory change (v2.1.83+)"
+      }
+    ],
+    "FileChanged": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash .claude/hooks/scripts/file-change-validator.sh"
+          }
+        ],
+        "description": "Validate externally modified files — advisory staleness warning (v2.1.83+)"
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nmsg=$(echo \"$input\" | jq -r '.message // \"\"' 2>/dev/null)\nif [ -n \"$msg\" ]; then\n  echo \"[Hook] Notification: $msg\" >&2\nfi\necho \"$input\""
+          }
+        ],
+        "description": "Display notifications for long-running operation completions"
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\nteammate=$(echo \"$input\" | jq -r '.teammate_id // \"unknown\"' 2>/dev/null)\necho \"[Hook] TeammateIdle: $teammate — available for reassignment\" >&2\necho \"$input\""
+          }
+        ],
+        "description": "Track idle Agent Teams members for work reassignment"
+      }
+    ],
+    "TaskCreated": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\ntask_id=$(echo \"$input\" | jq -r '.task_id // \"\"' 2>/dev/null)\ndesc=$(echo \"$input\" | jq -r '.description // \"\"' 2>/dev/null | head -c 60)\necho \"[Hook] TaskCreated: $task_id — $desc\" >&2\necho \"$input\""
+          }
+        ],
+        "description": "Log task creation events for Agent Teams coordination"
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "#!/bin/bash\ninput=$(cat)\ntask_id=$(echo \"$input\" | jq -r '.task_id // \"\"' 2>/dev/null)\nresult=$(echo \"$input\" | jq -r '.result // \"\"' 2>/dev/null | head -c 60)\necho \"[Hook] TaskCompleted: $task_id — $result\" >&2\necho \"$input\""
+          }
+        ],
+        "description": "Log task completion events for Agent Teams coordination"
+      }
+    ],
     "PostCompact": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "prompt",
-            "prompt": "Context compacted. RULES ACTIVE.\n\nR007: next response MUST start with ┌─ Agent: claude (default) / └─ Task: {task}\nR008: before EVERY tool call → [claude][model] → Tool: Name / Target: path\nR010: write→delegate to subagent; orchestrator read-only (Read/Glob/Grep); git→mgr-gitnerd\nR009: 2+ independent tasks → parallel agents, same message\nR018: 3+ agents OR review cycle → Agent Teams\n\nAutonomous mode: if /tmp/.claude-autonomous-$PPID exists → simple git (add/commit/push) may run directly; Write/Edit still delegates.\nbypassPermissions does NOT persist across compaction — re-enable if tasks seem blocked.\n\nRe-read CLAUDE.md NOW."
+            "prompt": "Context compacted. RULES ACTIVE.\n\nR007: next response MUST start with ┌─ Agent: claude (default) / └─ Task: {task}\nR008: before EVERY tool call → [claude][model] → Tool: Name / Target: path\nR010: write→delegate to subagent; orchestrator read-only (Read/Glob/Grep); git→mgr-gitnerd\nR009: 2+ independent tasks → parallel agents, same message\nR018: 3+ agents OR review cycle → Agent Teams\nR000: user communication in Korean (한국어); code/files in English — NON-NEGOTIABLE\n\nAutonomous mode: if /tmp/.claude-autonomous-$PPID exists → simple git (add/commit/push) may run directly; Write/Edit still delegates.\nbypassPermissions does NOT persist across compaction — re-enable if tasks seem blocked.\n\nRe-read CLAUDE.md NOW."
           }
         ],
         "description": "Reinforce enforced rules after context compaction — prevents rule amnesia (v2.1.76+)"

package/templates/.claude/hooks/scripts/cwd-change-detector.sh

@@ -0,0 +1,36 @@
+#!/bin/bash
+# CwdChanged hook — detect project type on directory change
+# Advisory only — provides context hints when cwd changes
+
+input=$(cat)
+new_cwd=$(echo "$input" | jq -r '.new_cwd // ""' 2>/dev/null)
+
+if [ -z "$new_cwd" ] || [ ! -d "$new_cwd" ]; then
+  echo "$input"
+  exit 0
+fi
+
+hints=""
+
+# Detect project type indicators
+if [ -f "$new_cwd/package.json" ]; then
+  hints="${hints}[Hook] Node.js project detected\n"
+fi
+if [ -f "$new_cwd/go.mod" ]; then
+  hints="${hints}[Hook] Go project detected\n"
+fi
+if [ -f "$new_cwd/Cargo.toml" ]; then
+  hints="${hints}[Hook] Rust project detected\n"
+fi
+if [ -f "$new_cwd/pyproject.toml" ] || [ -f "$new_cwd/requirements.txt" ]; then
+  hints="${hints}[Hook] Python project detected\n"
+fi
+if [ -f "$new_cwd/CLAUDE.md" ]; then
+  hints="${hints}[Hook] oh-my-customcode project detected\n"
+fi
+
+if [ -n "$hints" ]; then
+  printf "%b" "$hints" >&2
+fi
+
+echo "$input"

package/templates/.claude/hooks/scripts/file-change-validator.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+# FileChanged hook — detect external file modifications
+# Advisory warning when files are modified outside Claude Code
+
+input=$(cat)
+file_path=$(echo "$input" | jq -r '.file_path // ""' 2>/dev/null)
+change_type=$(echo "$input" | jq -r '.change_type // "modified"' 2>/dev/null)
+
+if [ -z "$file_path" ]; then
+  echo "$input"
+  exit 0
+fi
+
+echo "[Hook] External file change detected: ${change_type} ${file_path}" >&2
+
+# Warn about important files
+case "$file_path" in
+  */CLAUDE.md|*/hooks.json|*/settings*.json)
+    echo "[Hook] WARNING: Configuration file changed externally — re-read recommended" >&2
+    ;;
+  *.lock|*lockfile*)
+    echo "[Hook] Lock file changed — dependency state may have shifted" >&2
+    ;;
+esac
+
+echo "$input"

package/templates/.claude/hooks/scripts/user-prompt-preprocessor.sh

@@ -0,0 +1,32 @@
+#!/bin/bash
+# UserPromptSubmit hook — advisory pre-processing of user input
+# Provides skill matching hints based on user input patterns
+# Advisory only — never blocks user prompt submission
+
+input=$(cat)
+user_input=$(echo "$input" | jq -r '.user_input // ""' 2>/dev/null)
+
+if [ -z "$user_input" ]; then
+  echo "$input"
+  exit 0
+fi
+
+# Detect common patterns and provide advisory hints
+hints=""
+
+# Korean session-end signals
+if echo "$user_input" | grep -qiE '(끝|종료|마무리|done|wrap up|end session)'; then
+  hints="${hints}[Hook] Session-end signal detected — R011 memory saves will be triggered\n"
+fi
+
+# Workflow invocation
+if echo "$user_input" | grep -qE '^/'; then
+  hints="${hints}[Hook] Slash command detected\n"
+fi
+
+# Output hints to stderr (advisory)
+if [ -n "$hints" ]; then
+  printf "%b" "$hints" >&2
+fi
+
+echo "$input"

package/templates/.claude/rules/MUST-agent-design.md

@@ -63,6 +63,53 @@ domain: backend              # backend | frontend | data-engineering | devops |
 
 > **Note**: `isolation`, `background`, `maxTurns`, `maxTokens`, `mcpServers`, `hooks`, `permissionMode`, `disallowedTools`, `limitations` are supported in Claude Code v2.1.63+. Hook types `PostCompact`, `Elicitation`, `ElicitationResult` require v2.1.76+. `CwdChanged`, `FileChanged` hook events and `managed-settings.d/` drop-in directory require v2.1.83+. Conditional `if` field for hooks requires v2.1.85+.
 
+## Hook Event Types
+
+All supported hook event types in Claude Code. Agents and skills can reference these in `hooks:` frontmatter.
+
+| Event | Trigger | Data Available | Handler Types | CC Version |
+|-------|---------|---------------|---------------|------------|
+| `PreToolUse` | Before tool execution | tool, tool_input | command, prompt | v2.1.63+ |
+| `PostToolUse` | After tool execution | tool, tool_input, tool_output | command, prompt | v2.1.63+ |
+| `PreCompact` | Before context compaction | — | command, prompt | v2.1.76+ |
+| `PostCompact` | After context compaction | — | command, prompt | v2.1.76+ |
+| `Stop` | Session ending | — | command, prompt | v2.1.63+ |
+| `SessionStart` | Session begins | — | command | v2.1.63+ |
+| `SessionEnd` | Session fully closes | — | command | v2.1.76+ |
+| `SubagentStart` | Subagent spawned | agent_type, model, description | command | v2.1.63+ |
+| `SubagentStop` | Subagent completed | agent_type, model, result | command, prompt | v2.1.63+ |
+| `UserPromptSubmit` | User submits prompt | user_input | command, prompt | v2.1.76+ |
+| `Notification` | Long-running op completes | message | command | v2.1.76+ |
+| `CwdChanged` | Working directory changes | old_cwd, new_cwd | command | v2.1.83+ |
+| `FileChanged` | External file modification | file_path, change_type | command | v2.1.83+ |
+| `Elicitation` | Agent requests user input | question | command, prompt | v2.1.76+ |
+| `ElicitationResult` | User responds to elicitation | answer | command, prompt | v2.1.76+ |
+| `PostMessage` | After message sent | message_type | command | v2.1.76+ |
+| `TeammateIdle` | Agent Teams member idle | teammate_id | command | v2.1.83+ |
+| `TaskCreated` | Task created | task_id, description | command | v2.1.83+ |
+| `TaskCompleted` | Task completed | task_id, result | command | v2.1.83+ |
+
+### Hook Handler Types
+
+| Type | Behavior | Use Case |
+|------|----------|----------|
+| `command` | Execute shell command, stdin receives JSON context | Scripts, validation, logging |
+| `prompt` | Inject text into model context | Rule reinforcement, advisory guidance |
+| `http` | POST to HTTP endpoint | External integrations, webhooks |
+| `agent` | Spawn agent to handle event | Complex event-driven workflows |
+
+### Hook Matcher Syntax
+
+```yaml
+hooks:
+  PreToolUse:
+    - matcher: "tool == \"Edit\""       # Match specific tool
+      if: "Edit(*.md)"                  # Conditional filter (v2.1.85+)
+      command: "echo hook"
+    - matcher: "*"                       # Match all
+      command: "echo hook"
+```
+
 ## Permission Mode Guidance
 
 When spawning agents via the Agent tool, CC applies a default `mode` of `acceptEdits` if not explicitly specified. To maintain consistent permission behavior:

package/templates/.claude/skills/monitoring-setup/SKILL.md

@@ -116,6 +116,75 @@ OTEL_EXPORTER_OTLP_PROTOCOL=grpc
 OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
 ```
 
+## Advanced OTel Configuration
+
+### Additional Metrics
+
+| Metric | Description | Unit |
+|--------|-------------|------|
+| `code_edit_tool.decision` | Edit tool accept/reject decisions | count |
+
+### Exporter Configuration
+
+```json
+{
+  "env": {
+    "OTEL_METRICS_EXPORTER": "otlp",
+    "OTEL_LOGS_EXPORTER": "otlp",
+    "OTEL_EXPORTER_OTLP_PROTOCOL": "grpc",
+    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://localhost:4317",
+    "OTEL_RESOURCE_ATTRIBUTES": "service.name=claude-code,service.version=2.1.85"
+  }
+}
+```
+
+### Cardinality Controls
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `OTEL_LOG_TOOL_DETAILS` | Include tool input/output in logs | `false` |
+| `OTEL_METRICS_INCLUDE_TOOL_NAME` | Include tool name dimension | `true` |
+| `OTEL_METRICS_INCLUDE_MODEL` | Include model dimension | `true` |
+
+### Multi-Exporter Syntax
+
+```bash
+# Send metrics to both console and OTLP
+OTEL_METRICS_EXPORTER=console,otlp
+OTEL_LOGS_EXPORTER=console,otlp
+```
+
+### Prometheus Exporter
+
+```bash
+OTEL_METRICS_EXPORTER=prometheus
+OTEL_EXPORTER_PROMETHEUS_PORT=9464
+```
+
+## Data Privacy
+
+Environment variables to control data collection and telemetry:
+
+| Variable | Description |
+|----------|-------------|
+| `DISABLE_TELEMETRY` | Disable all telemetry collection |
+| `DISABLE_ERROR_REPORTING` | Disable error reporting to Anthropic |
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Disable non-essential network traffic |
+| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Disable feedback survey prompts |
+| `DO_NOT_TRACK` | Standard DNT signal |
+
+### Enterprise Configuration
+
+```json
+{
+  "env": {
+    "DISABLE_TELEMETRY": "1",
+    "DISABLE_ERROR_REPORTING": "1",
+    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
+  }
+}
+```
+
 ## HTTP-Level Inspection (Optional)
 
 For deeper payload-level debugging beyond aggregated metrics, [Claude Inspector](https://github.com/kangraemin/claude-inspector) provides MITM proxy inspection of Claude Code HTTP traffic.

package/templates/guides/claude-code/13-cli-flags.md

@@ -0,0 +1,151 @@
+# Claude Code CLI Flags & Modes
+
+## CLI Flags Reference
+
+| Flag | Description | Example |
+|------|------------|---------|
+| `--worktree` | Run in isolated git worktree | `claude --worktree "fix bug"` |
+| `--remote` | Connect to remote Claude Code instance | `claude --remote` |
+| `--bare` | Minimal UI, no statusline | `claude --bare` |
+| `--agent <name>` | Use specific agent as main thread | `claude --agent lang-golang-expert` |
+| `--agents` | List available agents | `claude --agents` |
+| `--from-pr <url>` | Start from a pull request | `claude --from-pr https://github.com/org/repo/pull/123` |
+| `--chrome` | Enable Chrome browser automation | `claude --chrome` |
+| `--json-schema` | Output JSON schema for structured output | `claude --json-schema schema.json` |
+| `--max-budget-usd <n>` | Set maximum spend cap | `claude --max-budget-usd 5.00` |
+| `--fallback-model <id>` | Model to use when primary unavailable | `claude --fallback-model claude-sonnet-4-6` |
+| `--fork-session` | Fork an existing session | `claude --fork-session` |
+| `--teleport` | Transfer session context to another terminal | `claude --teleport` |
+
+## Headless Mode (`claude -p`)
+
+Headless mode runs Claude Code non-interactively, useful for CI/CD pipelines and automated workflows.
+
+```bash
+# Basic pipe mode
+echo "explain this code" | claude -p
+
+# With JSON output
+echo "list all TODOs" | claude -p --output-format json
+
+# Stream JSON events
+echo "refactor this function" | claude -p --output-format stream-json
+
+# With specific model
+echo "review PR" | claude -p --model claude-sonnet-4-6
+```
+
+### Output Formats
+
+| Format | Flag | Description |
+|--------|------|-------------|
+| Text | (default) | Plain text output |
+| JSON | `--output-format json` | Structured JSON response |
+| Stream JSON | `--output-format stream-json` | Newline-delimited JSON events |
+
+### CI Integration
+
+```yaml
+# GitHub Actions example
+- name: Claude Code Review
+  run: echo "Review this PR for security issues" | claude -p --max-budget-usd 2.00
+  env:
+    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+```
+
+## Scheduled Agents (CronCreate)
+
+Claude Code supports native scheduled agents via `CronCreate`, `CronDelete`, and `CronList` tools.
+
+```bash
+# Create a scheduled agent
+# CronCreate(schedule: "0 9 * * 1-5", prompt: "check for stale PRs", name: "pr-checker")
+
+# List scheduled agents
+# CronList()
+
+# Delete a scheduled agent
+# CronDelete(name: "pr-checker")
+```
+
+### Schedule Format
+
+Standard cron syntax: `minute hour day-of-month month day-of-week`
+
+| Pattern | Description |
+|---------|-------------|
+| `0 9 * * 1-5` | Weekdays at 9:00 AM |
+| `0 */6 * * *` | Every 6 hours |
+| `0 0 * * 0` | Weekly on Sunday midnight |
+
+### RemoteTrigger
+
+For on-demand execution of scheduled agents:
+
+```bash
+# Trigger a scheduled agent immediately
+# RemoteTrigger(name: "pr-checker")
+```
+
+## Auto Mode Configuration
+
+Auto mode allows Claude Code to make decisions about tool permissions autonomously.
+
+### Settings
+
+```json
+{
+  "autoMode": {
+    "environment": "local",
+    "allow": ["Read", "Write", "Edit", "Glob", "Grep"],
+    "soft_deny": ["Bash(rm *)", "Bash(git push --force)"]
+  }
+}
+```
+
+### CLI Commands
+
+```bash
+claude auto-mode defaults    # Show default auto mode settings
+claude auto-mode config      # Configure auto mode
+claude auto-mode critique    # Review auto mode decisions
+```
+
+| Field | Description |
+|-------|-------------|
+| `environment` | Execution context (`local`, `ci`, `container`) |
+| `allow` | Tools auto-approved without prompting |
+| `soft_deny` | Tool patterns that trigger warning before execution |
+
+## Environment Variables
+
+### Model & Behavior
+
+| Variable | Description | Example |
+|----------|-------------|---------|
+| `ANTHROPIC_MODEL` | Override default model | `claude-opus-4-6` |
+| `CLAUDE_CODE_SUBAGENT_MODEL` | Override subagent model | `claude-haiku-4-5` |
+| `CLAUDE_CODE_EFFORT_LEVEL` | Set effort level | `high` |
+| `CLAUDE_CODE_DISABLE_FAST_MODE` | Disable fast mode | `1` |
+
+### Agent Teams
+
+| Variable | Description |
+|----------|-------------|
+| `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` | Enable Agent Teams (`1`) |
+
+### Data Privacy
+
+| Variable | Description |
+|----------|-------------|
+| `DISABLE_TELEMETRY` | Disable all telemetry collection |
+| `DISABLE_ERROR_REPORTING` | Disable error reporting to Anthropic |
+| `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Disable non-essential network traffic |
+| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Disable feedback survey prompts |
+| `DO_NOT_TRACK` | Standard DNT signal — disables tracking |
+
+## Related
+
+- [Monitoring Guide](10-monitoring.md) — OTel metrics and events
+- [Sub-agents Guide](11-sub-agents.md) — Agent spawning and coordination
+- [Workflow Patterns](12-workflow-patterns.md) — Workflow automation

package/templates/guides/claude-code/index.yaml

@@ -54,3 +54,8 @@ documents:
     title: 워크플로우 패턴
     description: AI 에이전트 작업에 적합한 워크플로우 패턴 선택 가이드
     path: ./12-workflow-patterns.md
+
+  - name: cli-flags
+    title: CLI 플래그 및 모드
+    description: CLI 플래그, 헤드리스 모드, 스케줄링, 환경변수 레퍼런스
+    path: ./13-cli-flags.md

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.64.3",
+  "version": "0.65.0",
   "lastUpdated": "2026-03-24T00:00:00.000Z",
   "components": [
     {