@synity/bitrix-skills 1.3.0

package/src/features/task-sync/assets/scripts/bitrix-session-check.sh

@@ -0,0 +1,51 @@
+#!/bin/bash
+# SessionStart hook — warns if TASK_ID missing (Hard Rule #17); probes task status;
+# auto-enables time tracking; writes session start ISO for digest.
+# Non-blocking: always exit 0 so Claude session continues.
+
+source "$(dirname "$0")/bitrix-lib.sh"
+
+_b24_preflight || exit 0
+
+PAYLOAD=$(cat)
+SESSION_ID=$(echo "$PAYLOAD" | jq -r '.session_id // "unknown"')
+
+# Write session start timestamp for Stop hook digest (Phase 4)
+SESSION_ENV_FILE="$SESSION_DIR/session-env-${SESSION_ID}"
+BTS_SESSION_START_ISO=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+echo "BTS_SESSION_START_ISO=${BTS_SESSION_START_ISO}" > "$SESSION_ENV_FILE"
+
+TASK_ID=$(find_task_id) || {
+  cat >&2 <<'EOF'
+⚠️  Hard Rule #17 violation: TASK_ID chưa set trong CLAUDE.md
+
+Bitrix Task Sync sẽ KHÔNG hoạt động trong session này.
+Hooks (PreToolUse/PostToolUse/Stop) sẽ silent skip.
+
+Cách fix:
+  1. Mở CLAUDE.md root hoặc CLAUDE.md của feature đang làm
+  2. Thêm block:
+       ## Bitrix Task
+       TASK_ID: <id-từ-Bitrix>
+  3. Reload session
+
+Setup chi tiết: docs/bitrix-task-sync.md
+EOF
+  exit 0
+}
+
+# Wipe stale skill counter from previous session
+rm -f "$SESSION_DIR/skill-counter-${SESSION_ID}" \
+      "$SESSION_DIR/skill-counter-${SESSION_ID}.lock" 2>/dev/null || true
+
+# Probe task status — skip lifecycle if task is closed (STATUS=5)
+TASK_STATUS=$(b24_task_status "$TASK_ID") || true
+if [[ "$TASK_STATUS" == "5" ]]; then
+  echo "BTS_TASK_CLOSED=1" >> "$SESSION_ENV_FILE"
+  exit 0
+fi
+
+# Auto-enable time tracking if not already enabled (Phase 2)
+b24_ensure_timetracking "$TASK_ID" || true
+
+exit 0

package/src/features/task-sync/assets/scripts/bitrix-session-sync.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+# Stop hook — fires when Claude finishes a turn.
+# Posts full session digest: skills + time + tokens + files + commits + plan progress.
+
+source "$(dirname "$0")/bitrix-lib.sh"
+_b24_preflight || exit 0
+
+PAYLOAD=$(cat)
+SESSION_ID=$(echo "$PAYLOAD" | jq -r '.session_id // "unknown"')
+TRANSCRIPT_PATH=$(echo "$PAYLOAD" | jq -r '.transcript_path // ""')
+
+STATE_FILE="$SESSION_DIR/${SESSION_ID}.json"
+[[ ! -f "$STATE_FILE" ]] && exit 0
+
+STATE=$(cat "$STATE_FILE")
+TASK_ID=$(echo "$STATE" | jq -r '.task_meta.task_id // ""')
+[[ -z "$TASK_ID" ]] && exit 0
+
+SKILL_COUNT=$(echo "$STATE" | jq '.skills_run | length')
+[[ "$SKILL_COUNT" -eq 0 ]] && exit 0
+
+SESSION_ENV_FILE="$SESSION_DIR/session-env-${SESSION_ID}"
+SESSION_START=""
+if [[ -f "$SESSION_ENV_FILE" ]]; then
+  source "$SESSION_ENV_FILE" 2>/dev/null || true
+  SESSION_START="${BTS_SESSION_START_ISO:-}"
+fi
+[[ -z "$SESSION_START" ]] && SESSION_START=$(echo "$STATE" | jq -r '.session_start')
+
+# Stop timer crash-safety: if skill crashed mid-run, timer may still be running
+if [[ "${BTS_TASK_CLOSED:-}" != "1" ]]; then
+  b24_timer_stop "$TASK_ID" || true
+fi
+# Wipe counter
+rm -f "$SESSION_DIR/skill-counter-${SESSION_ID}" \
+      "$SESSION_DIR/skill-counter-${SESSION_ID}.lock" 2>/dev/null || true
+
+# Write skills log to tmp file for renderer
+SKILLS_LOG_FILE="$SESSION_DIR/skills-log-${SESSION_ID}.json"
+echo "$STATE" | jq '.skills_run' > "$SKILLS_LOG_FILE"
+
+# Phase 1: accumulate session tokens
+TOKEN_LINE=""
+if [[ -n "$TRANSCRIPT_PATH" && -f "$TRANSCRIPT_PATH" ]]; then
+  TOKEN_LINE=$(b24_finalize_session_tokens "$TASK_ID" "$TRANSCRIPT_PATH") || true
+fi
+# Fallback: probe recent JSONL if transcript_path not in payload.
+# Exclude subagents/ dirs; sort newest-first to pick the right session.
+if [[ -z "$TOKEN_LINE" ]]; then
+  CANDIDATE=$(find "${HOME}/.claude/projects" -maxdepth 2 -name "*.jsonl" \
+    -not -path "*/subagents/*" -newer "$STATE_FILE" 2>/dev/null \
+    | xargs ls -t 2>/dev/null | head -1 || true)
+  if [[ -n "$CANDIDATE" ]]; then
+    TOKEN_LINE=$(b24_finalize_session_tokens "$TASK_ID" "$CANDIDATE") || true
+  fi
+fi
+
+# Resolve active plan dir from state or .claude/active-plan.txt
+PLAN_DIR=""
+ACTIVE_PLAN_FILE="${HOME}/.claude/active-plan.txt"
+if [[ -f "$ACTIVE_PLAN_FILE" ]]; then
+  PLAN_DIR=$(cat "$ACTIVE_PLAN_FILE" | tr -d '[:space:]')
+fi
+[[ -n "$PLAN_DIR" && ! -d "$PLAN_DIR" ]] && PLAN_DIR=""
+
+# Resolve repo root for commit log
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo "")
+
+# Attached files registry (from Phase 3 hook)
+ATTACHED_LOG="$SESSION_DIR/attached-${SESSION_ID}.json"
+
+# Render digest via pure renderer (use bash explicitly — script may not have +x bit)
+SCRIPT_DIR="$(dirname "$0")"
+MSG=$(bash "${SCRIPT_DIR}/bitrix-render-digest.sh" \
+  --session-start  "$SESSION_START" \
+  --skills-log     "$SKILLS_LOG_FILE" \
+  ${PLAN_DIR:+--plan-dir "$PLAN_DIR"} \
+  ${TOKEN_LINE:+--token-line "$TOKEN_LINE"} \
+  ${ATTACHED_LOG:+--attached-log "$ATTACHED_LOG"} \
+  ${REPO_ROOT:+--repo-root "$REPO_ROOT"})
+
+[[ -z "$MSG" ]] && { rm -f "$STATE_FILE" "$SKILLS_LOG_FILE" "$SESSION_ENV_FILE" "$ATTACHED_LOG" 2>/dev/null; exit 0; }
+b24_comment "$TASK_ID" "$MSG" || true
+
+# Clean up session tmp files
+rm -f "$STATE_FILE" "$SKILLS_LOG_FILE" "$SESSION_ENV_FILE" \
+      "$ATTACHED_LOG" "$SESSION_DIR/disk-root-${SESSION_ID}" 2>/dev/null || true
+
+exit 0

package/src/features/task-sync/assets/scripts/bitrix-skill-end.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+# PostToolUse hook — fires after Skill tool returns result
+# Posts result preview + logs elapsed time; decrements skill counter → pauses
+# task timer on last skill (Phase 2); attaches plan/brainstorm artifacts (Phase 3).
+
+source "$(dirname "$0")/bitrix-lib.sh"
+_b24_preflight || exit 0
+
+PAYLOAD=$(cat)
+SESSION_ID=$(echo "$PAYLOAD" | jq -r '.session_id // "unknown"')
+SKILL_NAME=$(echo "$PAYLOAD" | jq -r '.tool_input.skill // "unknown"')
+
+STATE_FILE="$SESSION_DIR/${SESSION_ID}.json"
+[[ ! -f "$STATE_FILE" ]] && exit 0
+
+STATE=$(cat "$STATE_FILE")
+TASK_ID=$(echo "$STATE" | jq -r '.task_meta.task_id // ""')
+[[ -z "$TASK_ID" ]] && exit 0
+
+START_TIME=$(echo "$STATE" | jq -r '.current_skill.start // 0')
+END_TIME=$(date -u +%s)
+ELAPSED_SECONDS=$((END_TIME - START_TIME))
+ELAPSED_MINUTES=$(( (ELAPSED_SECONDS + 59) / 60 ))
+
+# Take first 1500 chars of result as preview
+RESULT=$(echo "$PAYLOAD" | jq -r '.tool_response // ""' | head -c 1500)
+[[ ${#RESULT} -ge 1500 ]] && RESULT="${RESULT}
+..."
+
+# Update session state
+STATE=$(echo "$STATE" | jq \
+  --arg skill "$SKILL_NAME" \
+  --argjson elapsed "$ELAPSED_SECONDS" \
+  --arg result "$RESULT" \
+  '.skills_run += [{skill: $skill, elapsed_seconds: $elapsed, result_preview: $result}]
+   | del(.current_skill)')
+echo "$STATE" > "$STATE_FILE"
+
+# Decrement skill counter; stop native timer on every skill end (records duration automatically)
+_skill_counter_decr "$SESSION_ID" >/dev/null
+SESSION_ENV_FILE="$SESSION_DIR/session-env-${SESSION_ID}"
+if [[ -f "$SESSION_ENV_FILE" ]]; then
+  source "$SESSION_ENV_FILE" 2>/dev/null || true
+fi
+if [[ "${BTS_TASK_CLOSED:-}" != "1" ]]; then
+  b24_timer_stop "$TASK_ID"
+fi
+
+# Phase 3a: sync bitrix-checklist fenced block → Bitrix task checklist (plan/planner only)
+case "$SKILL_NAME" in
+  plan|planner)
+    TOOL_RESPONSE_FULL=$(echo "$PAYLOAD" | jq -r '.tool_response // ""')
+    CHECKLIST_JSON=$(printf '%s' "$TOOL_RESPONSE_FULL" | \
+      awk '/```bitrix-checklist/{flag=1;next}/```/{flag=0}flag' | \
+      jq -e '.' 2>/dev/null || true)
+    if [[ -n "$CHECKLIST_JSON" ]]; then
+      b24_sync_checklist "$TASK_ID" "$CHECKLIST_JSON" >/dev/null || true
+    fi
+    ;;
+esac
+
+# Phase 3b: attach artifact files first so disk links can be included in comment
+DISK_IDS=""
+case "$SKILL_NAME" in
+  plan|planner|brainstorm|cook|research|journal)
+    DISK_IDS=$(_attach_skill_artifacts "$TASK_ID" "$SESSION_ID" "$PAYLOAD" "$SKILL_NAME")
+    ;;
+esac
+
+# Only post "xong" when tool_response has human-readable content (not empty/pure JSON)
+if _has_useful_content "$RESULT"; then
+  EMOJI=$(skill_emoji "$SKILL_NAME")
+  MSG="${EMOJI} [Claude] ${SKILL_NAME} xong (${ELAPSED_MINUTES} phút)
+
+${RESULT}"
+  # Append [disk=ID] links for uploaded artifacts
+  if [[ -n "$DISK_IDS" ]]; then
+    while IFS= read -r did; do
+      [[ -n "$did" ]] && MSG="${MSG}[br]📎 [disk=${did}]"
+    done <<< "$DISK_IDS"
+  fi
+  b24_comment "$TASK_ID" "$MSG" || true
+fi
+
+exit 0
+
+# ── Artifact attach helper ───────────────────────────────────────────────────
+
+_attach_skill_artifacts() {
+  local task_id="$1"
+  local session_id="$2"
+  local payload="$3"
+  local skill_name="$4"
+
+  local attached_files=()
+  local disk_ids=()
+
+  # Path 1: parse ```bitrix-artifact``` fenced block from tool_response
+  local tool_response
+  tool_response=$(echo "$payload" | jq -r '.tool_response // ""')
+  local artifact_path
+  artifact_path=$(printf '%s' "$tool_response" | \
+    awk '/```bitrix-artifact/{flag=1;next}/```/{flag=0}flag' | \
+    jq -r '.path // empty' 2>/dev/null || true)
+
+  if [[ -n "$artifact_path" && -f "$artifact_path" ]]; then
+    local rel_dir; rel_dir=$(dirname "$artifact_path")
+    local drive_id
+    drive_id=$(b24_attach_artifact "$task_id" "$artifact_path" "$session_id" "$rel_dir") || true
+    if [[ -n "$drive_id" ]]; then
+      attached_files+=("$artifact_path")
+      disk_ids+=("$drive_id")
+    fi
+  fi
+
+  # Path 2: fallback — glob .md files in plans/ modified in last 60s
+  if [[ ${#attached_files[@]} -eq 0 ]]; then
+    local glob_pattern=""
+    case "$skill_name" in
+      plan|planner) glob_pattern="plans/*/plan.md plans/*/phase-*.md" ;;
+      brainstorm)   glob_pattern="plans/reports/brainstorm-*.md plans/*/brainstorm-*.md" ;;
+      cook)         glob_pattern="plans/*/plan.md plans/*/phase-*.md plans/reports/*.md" ;;
+      research)     glob_pattern="plans/reports/research-*.md plans/reports/researcher-*.md" ;;
+      journal)      glob_pattern="docs/journal/*.md" ;;
+    esac
+
+    if [[ -n "$glob_pattern" ]]; then
+      local f
+      for f in $glob_pattern; do
+        [[ ! -f "$f" ]] && continue
+        # Only attach recently modified files (within last 60 seconds)
+        local age=$(( $(date -u +%s) - $(date -r "$f" +%s 2>/dev/null || echo 0) ))
+        [[ "$age" -gt 60 ]] && continue
+        local rel_dir; rel_dir=$(dirname "$f")
+        local drive_id
+        drive_id=$(b24_attach_artifact "$task_id" "$f" "$session_id" "$rel_dir") || true
+        if [[ -n "$drive_id" ]]; then
+          attached_files+=("$f")
+          disk_ids+=("$drive_id")
+        fi
+      done
+    fi
+  fi
+
+  # Record attached files to session registry for Stop hook digest (Phase 4)
+  if [[ ${#attached_files[@]} -gt 0 ]]; then
+    local attached_json
+    attached_json=$(printf '%s\n' "${attached_files[@]}" | jq -R . | jq -s .)
+    local attach_log="$SESSION_DIR/attached-${session_id}.json"
+    if [[ -f "$attach_log" ]]; then
+      # Merge with existing list
+      local existing
+      existing=$(cat "$attach_log")
+      echo "$existing $attached_json" | jq -s '.[0] + .[1] | unique' > "$attach_log"
+    else
+      echo "$attached_json" > "$attach_log"
+    fi
+  fi
+
+  # Echo drive IDs to stdout so caller can build [disk=ID] links
+  local did
+  for did in "${disk_ids[@]}"; do
+    echo "$did"
+  done
+}

package/src/features/task-sync/assets/scripts/bitrix-skill-start.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# PreToolUse hook — fires before Skill tool executes
+# Captures full task meta into session state; posts "started" comment;
+# increments skill counter → starts task timer on first skill (Phase 2).
+
+source "$(dirname "$0")/bitrix-lib.sh"
+_b24_preflight || exit 0
+
+PAYLOAD=$(cat)
+SESSION_ID=$(echo "$PAYLOAD" | jq -r '.session_id // "unknown"')
+SKILL_NAME=$(echo "$PAYLOAD" | jq -r '.tool_input.skill // "unknown"')
+SKILL_ARGS=$(echo "$PAYLOAD" | jq -r '.tool_input.args // ""')
+
+STATE_FILE="$SESSION_DIR/${SESSION_ID}.json"
+START_TIME=$(date -u +%s)
+
+# Reuse existing state if present (multiple skills in one session); else bootstrap.
+if [[ -f "$STATE_FILE" ]]; then
+  STATE=$(cat "$STATE_FILE")
+  TASK_META=$(echo "$STATE" | jq -c '.task_meta // empty')
+else
+  TASK_META=$(find_task_meta) || exit 0
+  STATE=$(jq -n \
+    --arg sid "$SESSION_ID" \
+    --argjson meta "$TASK_META" \
+    --arg st "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+    '{session_id: $sid, task_meta: $meta, session_start: $st, skills_run: []}')
+fi
+
+[[ -z "$TASK_META" ]] && exit 0
+TASK_ID=$(echo "$TASK_META" | jq -r '.task_id // ""')
+[[ -z "$TASK_ID" ]] && exit 0
+
+# Skip lifecycle if task was closed at SessionStart
+SESSION_ENV_FILE="$SESSION_DIR/session-env-${SESSION_ID}"
+if [[ -f "$SESSION_ENV_FILE" ]]; then
+  source "$SESSION_ENV_FILE" 2>/dev/null || true
+  [[ "${BTS_TASK_CLOSED:-}" == "1" ]] && exit 0
+fi
+
+STATE=$(echo "$STATE" | jq \
+  --arg skill "$SKILL_NAME" \
+  --arg args "$SKILL_ARGS" \
+  --argjson start "$START_TIME" \
+  '.current_skill = {skill: $skill, args: $args, start: $start}')
+
+echo "$STATE" > "$STATE_FILE"
+
+# Increment skill counter; activate native timer on every skill start
+_skill_counter_incr "$SESSION_ID" >/dev/null
+b24_timer_start "$TASK_ID"
+
+# Only post "bắt đầu" when args carry meaningful context (≥15 chars)
+if [[ ${#SKILL_ARGS} -ge 15 ]]; then
+  EMOJI=$(skill_emoji "$SKILL_NAME")
+  b24_comment "$TASK_ID" "${EMOJI} [Claude] ${SKILL_NAME} bắt đầu: ${SKILL_ARGS}" || true
+fi
+exit 0

package/src/features/task-sync/assets/scripts/lib/bb-formatter.sh

@@ -0,0 +1,110 @@
+#!/bin/bash
+# BB code rendering helpers for Bitrix task chat output.
+# Bitrix renders BB code, NOT markdown. Source this file to use the helpers.
+#
+# Extracted from bitrix-render-digest.sh logic.
+# Depends on: _format_duration from bitrix-lib.sh (source that first).
+#
+# Usage:
+#   source "$(dirname "$0")/bitrix-lib.sh"
+#   source "$(dirname "$0")/bb-formatter.sh"
+
+# Wrap text in [b]...[/b]
+bb_bold() {
+  printf '[b]%s[/b]' "$1"
+}
+
+# Wrap text in [i]...[/i]
+bb_italic() {
+  printf '[i]%s[/i]' "$1"
+}
+
+# Wrap text in [code]...[/code]
+bb_code() {
+  printf '[code]%s[/code]' "$1"
+}
+
+# Wrap text in [quote]...[/quote]
+bb_quote() {
+  printf '[quote]%s[/quote]' "$1"
+}
+
+# Render a URL link: bb_link <url> <label>
+bb_link() {
+  printf '[url=%s]%s[/url]' "$1" "$2"
+}
+
+# Render a Bitrix Drive file attachment tag: bb_disk <drive_file_id>
+bb_disk() {
+  printf '[disk=%s]' "$1"
+}
+
+# Render a bullet list item with Unicode bullet
+bb_bullet() {
+  printf '• %s' "$1"
+}
+
+# Render the session summary header line
+# bb_session_header <session_start_iso>
+bb_session_header() {
+  local start="${1:-?}"
+  printf '[b][Claude] Session summary[/b] (%s)' "$start"
+}
+
+# Render skills section given a skills_log JSON file path.
+# Output: per-skill bullet lines + total line.
+# Requires _format_duration from bitrix-lib.sh.
+# bb_render_skills_section <skills_log_file>
+bb_render_skills_section() {
+  local log_file="$1"
+  [[ ! -f "$log_file" ]] && return 0
+
+  local total_seconds
+  total_seconds=$(jq '[.[].elapsed_seconds // 0] | add // 0' "$log_file")
+  local count
+  count=$(jq 'length' "$log_file")
+
+  local summary=""
+  for ((idx = 0; idx < count; idx++)); do
+    local s_name s_sec s_fmt
+    s_name=$(jq -r ".[$idx].skill // \"?\"" "$log_file")
+    s_sec=$(jq -r ".[$idx].elapsed_seconds // 0" "$log_file")
+    s_fmt=$(_format_duration "$s_sec")
+    summary="${summary}• ${s_name} (${s_fmt})
+"
+  done
+  # Trim trailing newline
+  summary="${summary%$'\n'}"
+
+  local total_fmt
+  total_fmt=$(_format_duration "$total_seconds")
+
+  if [[ -n "$summary" ]]; then
+    printf '%s\n\n[b]Tổng thời gian:[/b] %s' "$summary" "$total_fmt"
+  fi
+}
+
+# Render plan progress section given a plan directory.
+# bb_render_plan_section <plan_dir>
+bb_render_plan_section() {
+  local plan_dir="$1"
+  [[ -z "$plan_dir" || ! -f "${plan_dir}/plan.md" ]] && return 0
+
+  local plan_title plan_status
+  plan_title=$(grep -m1 '^# Plan:' "${plan_dir}/plan.md" | sed 's/^# Plan: *//' || true)
+  plan_status=$(awk '/^---/{c++;next} c==1 && /^status:/{print $2;exit}' "${plan_dir}/plan.md" || true)
+
+  local checked=0 total_boxes=0
+  for f in "${plan_dir}"/phase-*.md; do
+    [[ ! -f "$f" ]] && continue
+    checked=$(( checked + $(grep -c '^\- \[x\]' "$f" 2>/dev/null || echo 0) ))
+    total_boxes=$(( total_boxes + $(grep -c '^\- \[.\]' "$f" 2>/dev/null || echo 0) ))
+  done
+
+  if [[ -n "$plan_title" ]]; then
+    local line="📋 [b]Plan:[/b] ${plan_title}"
+    [[ -n "$plan_status" ]] && line="${line} [${plan_status}]"
+    [[ "$total_boxes" -gt 0 ]] && line="${line} — ${checked}/${total_boxes} tasks done"
+    printf '%s' "$line"
+  fi
+}