@neikyun/ciel 6.11.3 → 6.13.1

package/assets/.claude/hooks/pre-tool-write.sh

@@ -1,12 +1,12 @@
 #!/bin/bash
 # Ciel — PreToolUse hook for Write/Edit
 # Trigger: PreToolUse on Write|Edit
-# Purpose: inject faire-gatekeeper + dispatch gate + pipeline reminders before code write
-# Critical files get additional stride-analyzer hint
-# Always exits 0 (never blocks), outputs reminders via stderr (reliable channel)
-# Dispatch counter: /tmp/ciel_dispatched set by SubagentStart hooks (ciel-researcher/explorer)
+# Purpose: BLOCK source code writes until dispatch gate passes (v8 — enforcement)
+# Test files and non-code files pass through (always allowed).
+# Escape hatch: [CIEL_GATE_BYPASS] anywhere in the tool input bypasses the gate.
+# Dispatch tracker: /tmp/ciel_dispatched.* (created by SubagentStart hooks)
 
-INPUT=$(cat)
+INPUT=$(cat 2>/dev/null || echo "{}")
 
 FILE_PATH=$(echo "$INPUT" | python3 -c "
 import sys, json
@@ -22,14 +22,56 @@ except:
 
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-}"
 
+# === BYPASS CHECK ===
+# [CIEL_GATE_BYPASS] anywhere in the input is an intentional override
+if echo "$INPUT" | grep -q '\[CIEL_GATE_BYPASS\]'; then
+  echo "[CIEL] Gate bypassed via [CIEL_GATE_BYPASS] — allowing write to $(basename "$FILE_PATH")" >&2
+  exit 0
+fi
+
+# === FILE CLASSIFICATION ===
+# Source code files that require dispatch before editing
+IS_SOURCE=0
+if echo "$FILE_PATH" | grep -qE '\.(kt|java|ts|tsx|js|jsx|py|go|rs|rb|php|cs|cpp|c|swift|scala|vue|svelte)$'; then
+  IS_SOURCE=1
+fi
+
+# Test files always pass (test-first RED)
+IS_TEST=0
+if echo "$FILE_PATH" | grep -qE '\.(test|spec)\.|_test\.|_spec\.|/test/|/tests/|/__tests__/'; then
+  IS_TEST=1
+fi
+
 # === DISPATCH GATE CHECK ===
-# /tmp/ciel_dispatched is created by SubagentStart hooks when ciel-researcher/explorer dispatch
+# /tmp/ciel_dispatched.* files created by SubagentStart hooks when Ciel agents dispatch
 DISPATCHED=0
-DISPATCH_FLAG="/tmp/ciel_dispatched"
-if [ -f "$DISPATCH_FLAG" ]; then
+if ls /tmp/ciel_dispatched.* >/dev/null 2>&1; then
   DISPATCHED=1
 fi
 
+# === DEPTH CHECK ===
+# Read depth classification from UserPromptSubmit hook (auto-bypass for Trivial)
+TASK_DEPTH="Standard"
+if [ -n "$PROJECT_DIR" ] && [ -f "$PROJECT_DIR/.ciel/last-depth" ]; then
+  TASK_DEPTH=$(cat "$PROJECT_DIR/.ciel/last-depth" 2>/dev/null || echo "Standard")
+fi
+
+# === DISPATCH GATE — BLOCK (v8 enforcement) ===
+# Block source code edits when no Ciel agent has been dispatched.
+# Auto-bypass for Trivial tasks (depth classified by UserPromptSubmit hook).
+# Skip non-code files (docs, config, JSON, YAML, etc.) — safe to edit inline.
+# Skip test files — test-first RED means tests must be written before source.
+if [ "$IS_SOURCE" -eq 1 ] && [ "$IS_TEST" -eq 0 ] && [ "$DISPATCHED" -eq 0 ] && [ "$TASK_DEPTH" != "Trivial" ]; then
+  echo "[CIEL DISPATCH GATE] BLOCKED: Write to $(basename "$FILE_PATH")" >&2
+  echo "" >&2
+  echo "  Depth: $TASK_DEPTH — no Ciel agent dispatched yet." >&2
+  echo "  Dispatch ciel-researcher + ciel-explorer in parallel (Agent tool)," >&2
+  echo "  with relevant domain skill names in the dispatch prompt." >&2
+  echo "" >&2
+  echo "  This is actually a Trivial task? Use [CIEL_GATE_BYPASS]." >&2
+  exit 2
+fi
+
 # === FILE TRACK COUNT (RELIRE GATE) ===
 COUNT=0
 if [ -n "$PROJECT_DIR" ] && [ -f "$PROJECT_DIR/.ciel/tracked-files.json" ]; then
@@ -40,31 +82,14 @@ except: print(0)
 " 2>/dev/null || echo "0")
 fi
 
-# Build warnings
-WARNINGS=""
-
-# Dispatch gate warning (no dispatched agents on non-trivial write)
-if [ "$DISPATCHED" -eq 0 ] && [ "$COUNT" -ge 1 ]; then
-  WARNINGS="${WARNINGS}[DISPATCH GATE] WARNING: Writing file ${FILE_PATH} without prior Task() dispatch (ciel-researcher + ciel-explorer). Was this classified as Trivial? If Standard+, dispatch subagents BEFORE writing code."
-fi
-
-# RELIRE gate warning
+# RELIRE gate warning (3+ files → critic required)
 if [ "${COUNT:-0}" -ge 2 ] 2>/dev/null; then
-  PIPELINE_WARN=" | CIEL PIPELINE: ${COUNT} file(s) edited. Have researcher+explorer been dispatched? If 3+ files: ciel-critic MODE=RELIRE required before merge."
-  WARNINGS="${WARNINGS}${PIPELINE_WARN}"
-fi
-
-# If only dispatch gate fires, prefix to std err
-if [ -n "$WARNINGS" ]; then
-  echo "[CIEL PRE-WRITE]" >&2
-  echo "$WARNINGS" | while IFS= read -r line; do
-    echo "  $line" >&2
-  done
+  echo "[CIEL RELIRE GATE] ${COUNT} file(s) edited — dispatch ciel-critic MODE=RELIRE when done." >&2
 fi
 
 # === FAIRE GATE REMINDER ===
-# Skip non-code files
-if ! echo "$FILE_PATH" | grep -qE '\.(kt|java|ts|tsx|js|jsx|py|go|rs|rb|php|cs|cpp|c|swift|scala|vue|svelte|sql|sh|json|yaml|yml|toml)$'; then
+# Skip non-code files for faire gate
+if [ "$IS_SOURCE" -eq 0 ] && [ "$IS_TEST" -eq 0 ]; then
   exit 0
 fi
 
@@ -75,9 +100,9 @@ if echo "$FILE_PATH" | grep -qiE '(auth|Auth|security|Security|Token|Session|Pas
 fi
 
 if $CRITICAL; then
-  echo "  [CIEL] Critical path: invoke faire-gatekeeper, stride-analyzer must have run, test-first (RED)." >&2
+  echo "  [CIEL] Critical path: invoke faire-gatekeeper, stride-analyzer must have run, test-first (RED). After FAIRE: TESTER (run test suite)." >&2
 else
-  echo "  [CIEL] Standard path: invoke faire-gatekeeper (alternatives, idiomatic, quality, removal, test-first)." >&2
+  echo "  [CIEL] Standard path: invoke faire-gatekeeper (alternatives, idiomatic, quality, removal, test-first). After FAIRE: TESTER (run test suite)." >&2
 fi
 
 exit 0

package/assets/.claude/hooks/session-start.sh

@@ -88,7 +88,14 @@ try:
         lines = [f\"  [{mid}, {m.get('trigger_count', 0)}x] {m.get('title', '?')}\" for mid, m in top]
         total = len(active)
         more = f' (+{total - len(top)} more)' if total > len(top) else ''
-        print(f'Cued-recall memory active ({total} memories{more}):\\n' + '\\n'.join(lines))
+        promo = [(mid, m) for mid, m in mems.items() if (m.get('trigger_count') or 0) >= 5 and str(m.get('file', '')).startswith('episodes/')]
+        promo_hint = ''
+        if promo:
+            promo.sort(key=lambda x: -(x[1].get('trigger_count') or 0))
+            promo_names = ', '.join([m.get('title', '?') for _, m in promo[:3]])
+            more_promo = f' +{len(promo) - 3} more' if len(promo) > 3 else ''
+            promo_hint = '\\nConsolidation candidates (' + str(len(promo)) + ' episodes >=5 triggers): ' + promo_names + more_promo + '. Run memoire-consolidator.'
+        print(f'Cued-recall memory active ({total} memories{more}):\\n' + '\\n'.join(lines) + promo_hint)
 except Exception:
     print('')
 " 2>/dev/null || echo "")
@@ -103,6 +110,20 @@ elif [[ -d "$CWD/.ciel" ]] || [[ -f "$CWD/.claude/settings.json" ]] || [[ -f "$C
   MSG+=$'\n'"No cued-recall memory yet. Run /ciel-memory-bootstrap to scan project for ingestable tribal docs (lessons.md, ciel-overlay.md, .claude/rules/, etc.)."
 fi
 
+# ─── Pre-flight checklist — injected into every session ──────────────────────
+MSG+=$'\n'"---"
+MSG+=$'\n'"Checklist pre-vol (verifier avant chaque tache) :"
+MSG+=$'\n'"  Logs : structured JSON + correlation ID par requete ?"
+MSG+=$'\n'"  Backups : RPO/RTO definis ? Test de restore fait ?"
+MSG+=$'\n'"  Cache : TTL + strategie d'invalidation en place ?"
+MSG+=$'\n'"  Timeouts : explicites (connect/read/request) — pas d'infini ?"
+MSG+=$'\n'"  Securite : auth, injection, CSRF, rate limiting verifies ?"
+MSG+=$'\n'"  Metriques : RED (Rate, Errors, Duration) exposees par endpoint ?"
+MSG+=$'\n'"  Deploiement : CI/CD automatise, health check, rollback possible ?"
+MSG+=$'\n'"  Pagination : cursor-based, limite max definie ?"
+MSG+=$'\n'"  Erreurs : structurees (code + message + details) ?"
+MSG+=$'\n'"  Angles morts : 3 choses identifiees qui manquent dans la demande ?"
+
 # ─── Update check (throttled to once per 24h, never blocks) ──────────────────
 # Fetches GitHub VERSION non-blocking (max 2s). Any failure → silent skip.
 MANIFEST="$HOME/.ciel/manifest.json"

package/assets/.claude/hooks/session-version-check.sh

@@ -5,7 +5,7 @@
 set -euo pipefail
 
 PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$(cd "$(dirname "$0")/.." && pwd)}"
-LOCAL_VERSION=$(cat "$PROJECT_DIR/VERSION" 2>/dev/null || echo "0.0.0")
+LOCAL_VERSION=$(cat "$PROJECT_DIR/.ciel/version" 2>/dev/null || cat "$PROJECT_DIR/VERSION" 2>/dev/null || echo "0.0.0" || true)
 
 REMOTE_VERSION=$(curl -fsSL --connect-timeout 3 "https://raw.githubusercontent.com/KaosKyun/Ciel/main/VERSION" 2>/dev/null || true)
 

package/assets/.claude/hooks/stop.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# Ciel — Stop hook
+# Trigger: Claude finishes responding (end of task)
+# Purpose: (1) inject meta-critiquer instruction; (2) if on default branch with
+# 3+ unreleased feat/fix commits, prepend a release-gate reminder.
+#
+# Claude Code Stop-hook schema rejects hookSpecificOutput.additionalContext
+# (it is only valid for UserPromptSubmit/PostToolUse). The documented way to
+# steer the model at Stop is {"decision":"block","reason":"..."} — the reason
+# is surfaced as an instruction the model must address.
+#
+# Both meta-critiquer and release-gate are combined into a single `reason`
+# field so only one block event fires per Stop. The existing stop_hook_active
+# loop guard handles re-entry for both.
+
+INPUT=$(cat 2>/dev/null || echo "{}")
+
+ACTIVE=$(python3 -c "
+import sys, json
+try:
+    d = json.loads(sys.argv[1])
+    print('true' if d.get('stop_hook_active', False) else 'false')
+except Exception:
+    print('false')
+" "$INPUT" 2>/dev/null || echo "false")
+
+if [ "$ACTIVE" = "true" ]; then
+  exit 0
+fi
+
+# Fail-safe: block at most once per 60s window even if stop_hook_active
+# is not set (older Claude Code versions, parsing edge cases, plugin
+# auto-discovery re-invoking the same hook from multiple registrations).
+# Without this, the same Stop event can fire 9 times → CC overrides the
+# hook and emits the "blocked turn 9 times" warning.
+PROJECT_KEY=$(echo "${CLAUDE_PROJECT_DIR:-$PWD}" | (shasum 2>/dev/null || sha1sum 2>/dev/null || md5sum 2>/dev/null || md5 -q 2>/dev/null || cksum 2>/dev/null) | cut -c1-12)
+LAST_BLOCK_FILE="${TMPDIR:-/tmp}/ciel-stop-last-block-${PROJECT_KEY}"
+NOW=$(date +%s)
+LAST=$(cat "$LAST_BLOCK_FILE" 2>/dev/null || echo 0)
+if [ $((NOW - LAST)) -lt 60 ]; then
+  exit 0
+fi
+echo "$NOW" > "$LAST_BLOCK_FILE" 2>/dev/null || true
+
+CWD=$(python3 -c "
+import sys, json
+try:
+    d = json.loads(sys.argv[1])
+    print(d.get('cwd', ''))
+except Exception:
+    print('')
+" "$INPUT" 2>/dev/null || echo "")
+
+# Release-gate check — writes RG_MSG if it should fire
+RG_MSG=""
+check_release_gate() {
+  local cwd="$1"
+  [ -z "$cwd" ] && return 1
+  command -v git >/dev/null 2>&1 || return 1
+  git -C "$cwd" rev-parse --git-dir >/dev/null 2>&1 || return 1
+
+  local current default
+  current=$(git -C "$cwd" rev-parse --abbrev-ref HEAD 2>/dev/null)
+  default=$(git -C "$cwd" symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's@^refs/remotes/origin/@@')
+  [ -z "$default" ] && default="main"
+  [ "$current" = "$default" ] || return 1
+
+  local snooze="$cwd/.ciel-release-snooze"
+  if [ -f "$snooze" ] && find "$snooze" -mmin -60 2>/dev/null | grep -q .; then
+    return 1
+  fi
+
+  local last_tag range pending
+  last_tag=$(git -C "$cwd" describe --tags --abbrev=0 2>/dev/null || echo "")
+  if [ -z "$last_tag" ]; then
+    range="HEAD"
+  else
+    range="$last_tag..HEAD"
+  fi
+  pending=$(git -C "$cwd" log "$range" --oneline 2>/dev/null | grep -cE '^[a-f0-9]+ (feat|fix)(\(|:|!)' || echo 0)
+
+  [ "$pending" -ge 3 ] || return 1
+
+  local tag_label="${last_tag:-<no previous tag>}"
+  RG_MSG="CIEL RELEASE-GATE — $pending feat/fix commit(s) on $default since $tag_label without a release. Actions: (1) bump VERSION per conventional-commit scope (feat=minor, fix=patch, feat!/fix!=major), (2) append CHANGELOG.md entry, (3) git tag -a v<N.N.N>, (4) gh release create v<N.N.N> --generate-notes. Invoke changelog-updater + release-publisher skills. Snooze 60min: touch .ciel-release-snooze."
+  return 0
+}
+
+META_MSG="CIEL STOP — 30s META-CRITIQUER obligatoire avant de declarer fini: (1) depth match? (2) new failure mode → Guard? (3) user correction → memoire (capture to .ciel/memory/episodes/ via memory-engine.py)? (4) stale branches? (5) uncovered issues? (6) context health? (7) session-progress.md written? (8) dead code sweep (ruff/knip/Detekt)? (9) agent-discovered pattern → memoire capture (if you noticed a reusable pattern, bug, or convention not yet in .ciel/memory/ — call memory-engine.py capture with --captured-from=agent-observed)? (10) 5+ triggers without promotion → invoke memoire-consolidator? Invoke meta-critiquer skill then memoire."
+
+if check_release_gate "$CWD"; then
+  MSG="$RG_MSG
+
+$META_MSG"
+else
+  MSG="$META_MSG"
+fi
+
+python3 -c "
+import json, sys
+print(json.dumps({'decision': 'block', 'reason': sys.argv[1]}))
+" "$MSG"
+
+exit 0

package/assets/.claude/hooks/subagent-stop.sh

@@ -0,0 +1,54 @@
+#!/bin/bash
+# Ciel — SubagentStop hook
+# Trigger: subagent finishes
+# Purpose: log agent report size to eval log; warn if < 200 tokens on Standard/Critical task
+# Passive — does not inject context, just logs
+
+INPUT=$(cat 2>/dev/null || echo "{}")
+
+# Extract agent name + result size (rough word count)
+AGENT=$(echo "$INPUT" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    print(d.get('agent_type', d.get('subagent_type', 'unknown')))
+except:
+    print('unknown')
+" 2>/dev/null || echo "unknown")
+
+RESULT=$(echo "$INPUT" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    result = d.get('result', d.get('output', ''))
+    print(len(result.split()) if result else 0)
+except:
+    print(0)
+" 2>/dev/null || echo "0")
+
+# Rough token estimate: 1 word ≈ 1.33 tokens
+TOKENS=$((RESULT * 133 / 100))
+
+# Log to evals/results (if CIEL_TRACE_ID set)
+# Uses mkdir-based locking for atomic JSONL appends (portable, no flock dependency)
+if [[ -n "${CIEL_TRACE_ID:-}" ]]; then
+  LOG_DIR="$HOME/.ciel/evals/results"
+  mkdir -p "$LOG_DIR" 2>/dev/null || true
+  LOCK_DIR="$LOG_DIR/.write.lock"
+  # Spin-wait with 1s timeout to avoid infinite block
+  for _ in $(seq 1 10); do
+    if mkdir "$LOCK_DIR" 2>/dev/null; then
+      echo "{\"trace_id\":\"$CIEL_TRACE_ID\",\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"agent\":\"$AGENT\",\"tokens\":$TOKENS}" >> "$LOG_DIR/subagent-stops.jsonl" 2>/dev/null || true
+      rmdir "$LOCK_DIR" 2>/dev/null || true
+      break
+    fi
+    sleep 0.1
+  done
+fi
+
+# Warn if truncation suspected
+if [[ $TOKENS -lt 200 && $TOKENS -gt 0 ]]; then
+  echo "CIEL WARN — $AGENT agent report is only ${TOKENS} tokens. Suspect truncation on Standard/Critical task. Consider re-dispatching with narrower scope." >&2
+fi
+
+exit 0

package/assets/.claude/hooks/track-file.sh

@@ -2,8 +2,8 @@
 # CIEL FILE TRACKING: log modified files for RELIRE trigger
 # exit 0 = allow (always)
 
-INPUT=$(cat)
-FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.filePath // ""')
+INPUT=$(cat 2>/dev/null || echo "{}")
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // .tool_input.filePath // ""' 2>/dev/null || echo "")
 TRACK_FILE="$CLAUDE_PROJECT_DIR/.ciel/tracked-files.json"
 
 if [ -z "$FILE_PATH" ] || [ -z "$CLAUDE_PROJECT_DIR" ]; then

package/assets/.claude/hooks/user-prompt-submit.sh

@@ -17,21 +17,12 @@ except:
 
 [ -z "$PROMPT" ] && exit 0
 
-# Mechanical depth signals
-DEPTH="Standard"  # default
-REASON=""
-
-# Check for Critical signals
-if echo "$PROMPT" | grep -qiE '\b(auth|authenti|author|jwt|oauth|password|secret|token|session|payment|credit.card|migration.*schema|2fa|mfa|encryption|credential|cookie.*security)\b'; then
-  DEPTH="Critical"
-  REASON="auth/security/payment keyword detected"
-fi
-
-# Check for Trivial signals (only if not Critical)
-if [[ "$DEPTH" != "Critical" ]] && echo "$PROMPT" | grep -qiE '\b(rename|typo|copyright|comment|readme|1-line|one.line|fix.typo|spelling)\b'; then
-  DEPTH="Trivial"
-  REASON="rename/typo/docs keyword detected"
-fi
+# Depth classification is model-driven, not regex-driven.
+# Default to Standard — the model reclassifies via depth-classifier skill at DOCS step
+# and writes the result to .ciel/last-depth (read by pre-tool-write gate).
+# No mechanical keyword detection — regex is too imprecise for AI-driven tasks.
+DEPTH="Standard"
+REASON="model reclassifies via depth-classifier at DOCS — write to .ciel/last-depth"
 
 DISPATCH_GATE=""
 if [[ "$DEPTH" == "Standard" || "$DEPTH" == "Critical" ]]; then
@@ -103,6 +94,11 @@ if [[ -n "$ENGINE_PATH" ]] && [[ -n "$PROJECT_DIR" ]] && [[ -f "$PROJECT_DIR/.ci
   MEMORY_OUTPUT=$(python3 "$ENGINE_PATH" query --prompt "$PROMPT" --cwd "$PROJECT_DIR" --depth "$DEPTH_LOWER" 2>/dev/null || echo "")
 fi
 
+# Persist depth classification for downstream hooks (pre-tool-write gate reads this)
+if [ -n "${CLAUDE_PROJECT_DIR:-}" ]; then
+  echo "$DEPTH" > "$CLAUDE_PROJECT_DIR/.ciel/last-depth" 2>/dev/null || true
+fi
+
 MSG_BASE="CIEL depth hint: $DEPTH ($REASON).$DISPATCH_GATE$META_GATE$INTERVENTION_GATE Invoke depth-classifier if ambiguous before routing pipeline."
 
 # Emit JSON via python to handle newlines and quoting safely

package/assets/.claude/settings.json

@@ -15,12 +15,26 @@
     "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
   },
   "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR/.claude/hooks/user-prompt-submit.sh\""
+          }
+        ]
+      }
+    ],
     "SessionStart": [
       {
         "hooks": [
           {
             "type": "command",
-            "command": "echo \"[CIEL v6] Session started — Pipeline: DOCS → QUOI → ASK → AVEC QUOI → DIVERGE → RECHERCHE → CODEBASE → EVALUER → ASK2 → FAIRE → RELIRE → PROUVER → MEMOIRE → META\" && { ! [ -x \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-version-check.sh\" ] || \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-version-check.sh\"; }"
+            "command": "\"$CLAUDE_PROJECT_DIR/.claude/hooks/session-start.sh\""
+          },
+          {
+            "type": "command",
+            "command": "{ ! [ -x \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-version-check.sh\" ] || \"$CLAUDE_PROJECT_DIR/.claude/hooks/session-version-check.sh\"; }"
           }
         ]
       }
@@ -80,7 +94,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "touch /tmp/ciel_dispatched && echo \"[CIEL] Explorer started: $(date -u +%Y-%m-%dT%H:%M:%SZ)\" >> \"$CLAUDE_PROJECT_DIR/.ciel/exploration-log.md\""
+            "command": "echo \"$(date +%s)\" > \"/tmp/ciel_dispatched.$$\" && echo \"[CIEL] Explorer started: $(date -u +%Y-%m-%dT%H:%M:%SZ)\" >> \"$CLAUDE_PROJECT_DIR/.ciel/exploration-log.md\""
           }
         ]
       },
@@ -89,7 +103,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "touch /tmp/ciel_dispatched && echo \"[CIEL] Researcher started: $(date -u +%Y-%m-%dT%H:%M:%SZ)\" >> \"$CLAUDE_PROJECT_DIR/.ciel/subagent-log.md\""
+            "command": "echo \"$(date +%s)\" > \"/tmp/ciel_dispatched.$$\" && echo \"[CIEL] Researcher started: $(date -u +%Y-%m-%dT%H:%M:%SZ)\" >> \"$CLAUDE_PROJECT_DIR/.ciel/subagent-log.md\""
           }
         ]
       },
@@ -98,7 +112,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo \"[CIEL] Critic started: $(date -u +%Y-%m-%dT%H:%M:%SZ)\" >> \"$CLAUDE_PROJECT_DIR/.ciel/subagent-log.md\""
+            "command": "echo \"$(date +%s)\" > \"/tmp/ciel_dispatched.$$\" && echo \"[CIEL] Critic started: $(date -u +%Y-%m-%dT%H:%M:%SZ)\" >> \"$CLAUDE_PROJECT_DIR/.ciel/subagent-log.md\""
           }
         ]
       }

package/assets/AGENTS.md

@@ -78,7 +78,7 @@ The `ciel.ts` plugin injects depth classification on every user prompt and RELIR
 Ciel ships a `.mcp.json` template at the repo root with two opt-in servers: `playwright` (visual critique) and `context7` (live official docs). Register them via:
 
 ```bash
-bash ~/.claude/plugins/ciel/scripts/install.sh --with-mcp=playwright,context7
+bash <(curl -fsSL https://raw.githubusercontent.com/KaosKyun/Ciel/main/scripts/install.sh) --with-mcp=playwright,context7
 ```
 
 **Important** — OpenCode issue #2319: plugin hooks (`tool.execute.before/after`) do NOT fire for MCP tool calls. The `playwright-visual-critic` skill orchestrates the flow explicitly (navigate → snapshot → dispatch `@ciel-critic`) rather than relying on auto-triggered hooks. When you use a visual-critique workflow, dispatch the critic agent yourself after capture.