|
|
@@ -1,226 +1,47 @@
|
|
|
-#!/bin/bash
|
|
|
+#!/usr/bin/env bash
|
|
|
# SessionStart hook for OAC plugin
|
|
|
-# Injects using-oac skill and checks .tmp cleanup, .oac config, and context installation
|
|
|
|
|
|
set -euo pipefail
|
|
|
|
|
|
-# Resolve plugin root directory
|
|
|
-PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)}"
|
|
|
+# Determine plugin root directory
|
|
|
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")" && pwd)"
|
|
|
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
|
|
|
SKILL_FILE="${PLUGIN_ROOT}/skills/using-oac/SKILL.md"
|
|
|
-TMP_SESSIONS_DIR=".tmp/sessions"
|
|
|
-CONTEXT_MANIFEST=".context-manifest.json"
|
|
|
-OAC_EXAMPLE="${PLUGIN_ROOT}/.oac.example"
|
|
|
|
|
|
-# Load using-oac skill content
|
|
|
-if [[ ! -f "${SKILL_FILE}" ]]; then
|
|
|
- echo '{"error": "using-oac skill not found at '"${SKILL_FILE}"'"}' >&2
|
|
|
- exit 1
|
|
|
-fi
|
|
|
-
|
|
|
-SKILL_CONTENT=$(cat "${SKILL_FILE}")
|
|
|
-
|
|
|
-# Escape for JSON using parameter substitution (fast method)
|
|
|
-# Replace backslash, double-quote, newline, tab, carriage return
|
|
|
-SKILL_CONTENT="${SKILL_CONTENT//\\/\\\\}" # Backslash
|
|
|
-SKILL_CONTENT="${SKILL_CONTENT//\"/\\\"}" # Double-quote
|
|
|
-SKILL_CONTENT="${SKILL_CONTENT//$'\n'/\\n}" # Newline
|
|
|
-SKILL_CONTENT="${SKILL_CONTENT//$'\t'/\\t}" # Tab
|
|
|
-SKILL_CONTENT="${SKILL_CONTENT//$'\r'/\\r}" # Carriage return
|
|
|
-
|
|
|
-# Check for .oac configuration
|
|
|
-CONFIG_EXISTS=false
|
|
|
-CONFIG_LOCATION=""
|
|
|
-RECOMMENDATIONS=()
|
|
|
-
|
|
|
-if [[ -f ".oac" ]]; then
|
|
|
- CONFIG_EXISTS=true
|
|
|
- CONFIG_LOCATION="project (.oac)"
|
|
|
-elif [[ -f "$HOME/.oac" ]]; then
|
|
|
- CONFIG_EXISTS=true
|
|
|
- CONFIG_LOCATION="global (~/.oac)"
|
|
|
-else
|
|
|
- RECOMMENDATIONS+=("Copy .oac.example to .oac to customize settings")
|
|
|
-fi
|
|
|
-
|
|
|
-# Check for context installation
|
|
|
-CONTEXT_INSTALLED=false
|
|
|
-CONTEXT_AGE_DAYS=0
|
|
|
-CONTEXT_WARNING=""
|
|
|
-
|
|
|
-if [[ -f "${CONTEXT_MANIFEST}" ]]; then
|
|
|
- CONTEXT_INSTALLED=true
|
|
|
-
|
|
|
- # Check age of context manifest (>30 days = suggest update)
|
|
|
- if [[ "$(uname)" == "Darwin" ]]; then
|
|
|
- # macOS
|
|
|
- MANIFEST_MTIME=$(stat -f %m "${CONTEXT_MANIFEST}" 2>/dev/null || echo 0)
|
|
|
- else
|
|
|
- # Linux
|
|
|
- MANIFEST_MTIME=$(stat -c %Y "${CONTEXT_MANIFEST}" 2>/dev/null || echo 0)
|
|
|
- fi
|
|
|
-
|
|
|
- CURRENT_TIME=$(date +%s)
|
|
|
- CONTEXT_AGE_DAYS=$(( (CURRENT_TIME - MANIFEST_MTIME) / 86400 ))
|
|
|
-
|
|
|
- if [[ ${CONTEXT_AGE_DAYS} -gt 30 ]]; then
|
|
|
- CONTEXT_WARNING="⚠️ Context is ${CONTEXT_AGE_DAYS} days old. Consider running /oac:setup --core to update."
|
|
|
- RECOMMENDATIONS+=("Run /oac:setup --core to update context (${CONTEXT_AGE_DAYS} days old)")
|
|
|
- fi
|
|
|
-else
|
|
|
- RECOMMENDATIONS+=("Run /oac:setup --core to download context files")
|
|
|
-fi
|
|
|
-
|
|
|
-# Detect first-time user
|
|
|
-FIRST_TIME_USER=false
|
|
|
-if [[ "${CONFIG_EXISTS}" == "false" ]] && [[ "${CONTEXT_INSTALLED}" == "false" ]]; then
|
|
|
- FIRST_TIME_USER=true
|
|
|
-fi
|
|
|
-
|
|
|
-# Check .tmp/ cleanup needs
|
|
|
-CLEANUP_SCRIPT="${PLUGIN_ROOT}/scripts/cleanup-tmp.sh"
|
|
|
-CLEANUP_WARNING=""
|
|
|
-
|
|
|
-if [[ -x "${CLEANUP_SCRIPT}" ]]; then
|
|
|
- # Check for old .tmp files
|
|
|
- OLD_SESSIONS=0
|
|
|
- OLD_TASKS=0
|
|
|
- OLD_EXTERNAL=0
|
|
|
-
|
|
|
- # Count old sessions (>7 days)
|
|
|
- if [[ -d ".tmp/sessions" ]]; then
|
|
|
- OLD_SESSIONS=$(find ".tmp/sessions" -mindepth 1 -maxdepth 1 -type d -mtime +7 2>/dev/null | wc -l | tr -d ' ')
|
|
|
- fi
|
|
|
-
|
|
|
- # Count old completed tasks (>30 days)
|
|
|
- if [[ -d ".tmp/tasks" ]]; then
|
|
|
- for task_dir in .tmp/tasks/*; do
|
|
|
- if [[ ! -d "$task_dir" ]]; then continue; fi
|
|
|
-
|
|
|
- all_completed=true
|
|
|
- has_subtasks=false
|
|
|
-
|
|
|
- for subtask_file in "$task_dir"/subtask_*.json; do
|
|
|
- if [[ ! -f "$subtask_file" ]]; then continue; fi
|
|
|
- has_subtasks=true
|
|
|
-
|
|
|
- if ! grep -q '"status": "completed"' "$subtask_file" 2>/dev/null; then
|
|
|
- all_completed=false
|
|
|
- break
|
|
|
- fi
|
|
|
-
|
|
|
- if [[ $(find "$subtask_file" -mtime +30 2>/dev/null | wc -l) -eq 0 ]]; then
|
|
|
- all_completed=false
|
|
|
- break
|
|
|
- fi
|
|
|
- done
|
|
|
-
|
|
|
- if [[ "$has_subtasks" == "true" ]] && [[ "$all_completed" == "true" ]]; then
|
|
|
- ((OLD_TASKS++))
|
|
|
- fi
|
|
|
- done
|
|
|
- fi
|
|
|
-
|
|
|
- # Count old external context (>7 days)
|
|
|
- if [[ -d ".tmp/external-context" ]]; then
|
|
|
- OLD_EXTERNAL=$(find ".tmp/external-context" -mindepth 1 -maxdepth 1 -type d -mtime +7 2>/dev/null | wc -l | tr -d ' ')
|
|
|
- fi
|
|
|
-
|
|
|
- TOTAL_OLD=$((OLD_SESSIONS + OLD_TASKS + OLD_EXTERNAL))
|
|
|
-
|
|
|
- if [[ ${TOTAL_OLD} -gt 0 ]]; then
|
|
|
- CLEANUP_WARNING="⚠️ Found ${TOTAL_OLD} old temporary items (${OLD_SESSIONS} sessions, ${OLD_TASKS} tasks, ${OLD_EXTERNAL} external cache). Run cleanup script to review: bash ${CLEANUP_SCRIPT}"
|
|
|
- RECOMMENDATIONS+=("Run cleanup script to remove old temporary files")
|
|
|
- fi
|
|
|
-fi
|
|
|
-
|
|
|
-# Build context injection message
|
|
|
-CONTEXT_MESSAGE="# OpenAgents Control (OAC) Workflow
|
|
|
-
|
|
|
-**EXTREMELY_IMPORTANT**: This skill is automatically loaded for every development task.
|
|
|
-
|
|
|
-${SKILL_CONTENT}"
|
|
|
-
|
|
|
-# Add first-time user welcome
|
|
|
-if [[ "${FIRST_TIME_USER}" == "true" ]]; then
|
|
|
- CONTEXT_MESSAGE="${CONTEXT_MESSAGE}
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-## 👋 Welcome to OpenAgents Control!
|
|
|
-
|
|
|
-This appears to be your first time using OAC. Here's how to get started:
|
|
|
-
|
|
|
-1. **Download context files**: Run \`/oac:setup --core\` to get coding standards and patterns
|
|
|
-2. **Customize settings**: Copy \`.oac.example\` to \`.oac\` to configure your preferences
|
|
|
-3. **Learn the workflow**: Run \`/oac:help\` to see the 6-stage development workflow
|
|
|
-
|
|
|
-Once context is installed, OAC will automatically discover relevant standards and patterns for every task."
|
|
|
-fi
|
|
|
-
|
|
|
-# Add context warning if needed
|
|
|
-if [[ -n "${CONTEXT_WARNING}" ]]; then
|
|
|
- CONTEXT_MESSAGE="${CONTEXT_MESSAGE}
|
|
|
-
|
|
|
----
|
|
|
-
|
|
|
-${CONTEXT_WARNING}"
|
|
|
-fi
|
|
|
-
|
|
|
-# Add cleanup warning if needed
|
|
|
-if [[ -n "${CLEANUP_WARNING}" ]]; then
|
|
|
- CONTEXT_MESSAGE="${CONTEXT_MESSAGE}
|
|
|
+# Read using-oac content
|
|
|
+using_oac_content=$(cat "${SKILL_FILE}" 2>&1 || echo "Error reading using-oac skill")
|
|
|
+
|
|
|
+# Escape string for JSON embedding using bash parameter substitution
|
|
|
+# Each ${s//old/new} is a single C-level pass - orders of magnitude
|
|
|
+# faster than character-by-character loop
|
|
|
+escape_for_json() {
|
|
|
+ local s="$1"
|
|
|
+ s="${s//\\/\\\\}"
|
|
|
+ s="${s//\"/\\\"}"
|
|
|
+ s="${s//$'\n'/\\n}"
|
|
|
+ s="${s//$'\r'/\\r}"
|
|
|
+ s="${s//$'\t'/\\t}"
|
|
|
+ printf '%s' "$s"
|
|
|
+}
|
|
|
|
|
|
----
|
|
|
+using_oac_escaped=$(escape_for_json "$using_oac_content")
|
|
|
|
|
|
-${CLEANUP_WARNING}"
|
|
|
+# Build warning message for first-time users
|
|
|
+warning_message=""
|
|
|
+if [[ ! -f ".context-manifest.json" ]]; then
|
|
|
+ warning_message="\n\n<important-reminder>IN YOUR FIRST REPLY AFTER SEEING THIS MESSAGE YOU MUST TELL THE USER:👋 **Welcome to OpenAgents Control!** To get started, run /oac:setup to download context files. Then use /oac:help to learn the 6-stage workflow.</important-reminder>"
|
|
|
fi
|
|
|
|
|
|
-# Escape context message for JSON
|
|
|
-CONTEXT_MESSAGE="${CONTEXT_MESSAGE//\\/\\\\}"
|
|
|
-CONTEXT_MESSAGE="${CONTEXT_MESSAGE//\"/\\\"}"
|
|
|
-CONTEXT_MESSAGE="${CONTEXT_MESSAGE//$'\n'/\\n}"
|
|
|
-CONTEXT_MESSAGE="${CONTEXT_MESSAGE//$'\t'/\\t}"
|
|
|
-CONTEXT_MESSAGE="${CONTEXT_MESSAGE//$'\r'/\\r}"
|
|
|
+warning_escaped=$(escape_for_json "$warning_message")
|
|
|
|
|
|
-# Build recommendations JSON array
|
|
|
-RECOMMENDATIONS_JSON="["
|
|
|
-FIRST_REC=true
|
|
|
-for rec in "${RECOMMENDATIONS[@]}"; do
|
|
|
- if [[ "${FIRST_REC}" == "true" ]]; then
|
|
|
- FIRST_REC=false
|
|
|
- else
|
|
|
- RECOMMENDATIONS_JSON="${RECOMMENDATIONS_JSON},"
|
|
|
- fi
|
|
|
- # Escape recommendation for JSON
|
|
|
- REC_ESCAPED="${rec//\\/\\\\}"
|
|
|
- REC_ESCAPED="${REC_ESCAPED//\"/\\\"}"
|
|
|
- RECOMMENDATIONS_JSON="${RECOMMENDATIONS_JSON}\"${REC_ESCAPED}\""
|
|
|
-done
|
|
|
-RECOMMENDATIONS_JSON="${RECOMMENDATIONS_JSON}]"
|
|
|
-
|
|
|
-# Output JSON with hookSpecificOutput format
|
|
|
+# Output context injection as JSON
|
|
|
cat <<EOF
|
|
|
{
|
|
|
"hookSpecificOutput": {
|
|
|
"hookEventName": "SessionStart",
|
|
|
- "additionalContext": "<EXTREMELY_IMPORTANT>OAC workflow is active. Follow 6-stage process: Analyze, Plan & Approve, LoadContext, Execute, Validate, Complete.</EXTREMELY_IMPORTANT>",
|
|
|
- "firstTimeUser": ${FIRST_TIME_USER},
|
|
|
- "contextInstalled": ${CONTEXT_INSTALLED},
|
|
|
- "contextAgeDays": ${CONTEXT_AGE_DAYS},
|
|
|
- "configExists": ${CONFIG_EXISTS},
|
|
|
- "configLocation": "${CONFIG_LOCATION}",
|
|
|
- "recommendations": ${RECOMMENDATIONS_JSON},
|
|
|
- "contextInjection": {
|
|
|
- "priority": "EXTREMELY_IMPORTANT",
|
|
|
- "content": "${CONTEXT_MESSAGE}"
|
|
|
- },
|
|
|
- "tmpCleanup": {
|
|
|
- "oldSessions": ${OLD_SESSIONS:-0},
|
|
|
- "oldTasks": ${OLD_TASKS:-0},
|
|
|
- "oldExternal": ${OLD_EXTERNAL:-0},
|
|
|
- "total": ${TOTAL_OLD:-0},
|
|
|
- "warning": "${CLEANUP_WARNING}"
|
|
|
- }
|
|
|
+ "additionalContext": "<EXTREMELY_IMPORTANT>\nYou are using OpenAgents Control (OAC).\n\n**Below is the full content of your 'using-oac' skill - your guide to the 6-stage workflow. For all other skills, use the 'Skill' tool:**\n\n${using_oac_escaped}\n\n${warning_escaped}\n</EXTREMELY_IMPORTANT>"
|
|
|
}
|
|
|
}
|
|
|
EOF
|
|
|
+
|
|
|
+exit 0
|
Darren Hinde