copilot-designer-portal.sh

#!/bin/bash

# Load central configuration
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
source "${SCRIPT_DIR}/config.sh"

# ══════════════════════════════════════════════════════════════════════
#  PORTAL DESIGNER — Research agent (READ-ONLY)
#  Analyzes the logged-in portal/dashboard UX, admin panel, user flows
#  Writes 10 detailed ideas to ideas/portal_design_latest.md
# ══════════════════════════════════════════════════════════════════════

PROJECT_DIR="${PROJECT_DIR:-/opt/yourproject}"
LOG_FILE="${LOG_FILE:-/opt/copilot-hive/copilot-designer-portal.log}"
NOTIFY="/opt/copilot-hive/notify-smartthings.sh"
IDEAS_DIR="${IDEAS_DIR:-/opt/copilot-hive/ideas}"
COPILOT="/usr/local/bin/copilot"

mkdir -p "$IDEAS_DIR"

PAUSE_FILE="${PAUSE_FILE:-/opt/copilot-hive/.agents-paused}"
AGENT_PAUSE_FILE="${AGENT_PAUSE_FILE:-/opt/copilot-hive/.agent-paused-designer-portal}"
if [ -f "$PAUSE_FILE" ] || [ -f "$AGENT_PAUSE_FILE" ]; then
  echo "$(date) — SKIPPED: Agent paused" >> "$LOG_FILE"
  exit 0
fi

# Prevent concurrent runs of same agent
acquire_agent_lock "designer-portal${PROJECT_ID:+-$PROJECT_ID}" || { echo "$(date) — SKIPPED: Another instance already running" >> "$LOG_FILE"; exit 0; }

echo "======================================" >> "$LOG_FILE"
echo "Portal Designer Started: $(date)" >> "$LOG_FILE"

# ── Urgent Admin Ideas Check ─────────────────────────────────────────────────
_IDEAS_DIR="${IDEAS_DIR:-/opt/copilot-hive/ideas}"
URGENT_IDEA=$(python3 -c "
import json
try:
    with open('${_IDEAS_DIR}/admin_ideas.json') as f:
        data = json.load(f)
    urgent = [i for i in data.get('ideas',[]) if i.get('urgent') and i.get('status')=='pending']
    if urgent:
        idea = urgent[0]
        print(idea['title'] + '|||' + idea['description'] + '|||' + idea['id'])
except: pass
" 2>/dev/null)

if [ -n "$URGENT_IDEA" ]; then
  URGENT_TITLE=$(echo "$URGENT_IDEA" | cut -d'|||' -f1)
  URGENT_DESC=$(echo "$URGENT_IDEA" | cut -d'|||' -f2)
  URGENT_ID=$(echo "$URGENT_IDEA" | cut -d'|||' -f3)
  echo "$(date) — URGENT ADMIN IDEA: $URGENT_TITLE" >> "$LOG_FILE"
  OVERRIDE_PROMPT="You are temporarily a DEVELOPER for Your Project. Your normal role is Portal Designer but the ADMIN has an urgent request.
The source code is at ${PROJECT_DIR}. Docker-compose at /opt/docker-compose/yourproject.yml.
URGENT: ${URGENT_TITLE}
Details: ${URGENT_DESC}
RULES: Implement completely. Do not break existing functionality."
  cd "$PROJECT_DIR"
  "$COPILOT" --prompt "$OVERRIDE_PROMPT" --yolo --allow-all-paths >> "$LOG_FILE" 2>&1
  URGENT_EXIT=$?
  if [ $URGENT_EXIT -eq 0 ]; then
    python3 -c "
import json, datetime
with open('${_IDEAS_DIR}/admin_ideas.json') as f: data = json.load(f)
for i in data['ideas']:
    if i['id'] == '$URGENT_ID':
        i['status'] = 'implemented'; i['urgent'] = False
        i['implemented_at'] = datetime.datetime.now(datetime.timezone.utc).isoformat()
        break
with open('${_IDEAS_DIR}/admin_ideas.json', 'w') as f: json.dump(data, f, indent=2)
" 2>/dev/null
    echo "✅ DONE | $(date '+%Y-%m-%d %H:%M') | admin | $URGENT_TITLE" >> "${_IDEAS_DIR}/implemented.log"
  fi
  if git -C "$PROJECT_DIR" status --porcelain | grep -q .; then
    git -C "$PROJECT_DIR" add -A
    git -C "$PROJECT_DIR" commit -m "urgent: admin request — $URGENT_TITLE

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>"
    git -C "$PROJECT_DIR" push origin main 2>&1 || true
  fi
fi

IMPLEMENTED=""
[ -f "${IDEAS_DIR}/implemented.log" ] && IMPLEMENTED=$(tail -100 "${IDEAS_DIR}/implemented.log" 2>/dev/null)

# ── Load prompt from file if available ────────────────────────────────
PROMPT_FILE="${SCRIPTS_DIR}/prompts/portal-designer.md"
if [ -f "$PROMPT_FILE" ]; then
  PROMPT=$(cat "$PROMPT_FILE")
  echo "Loaded prompt from $PROMPT_FILE" >> "$LOG_FILE"
else
  # Fallback to inline prompt below
PROMPT=$(cat <<'PROMPTEOF'
You are the PORTAL DESIGNER agent for the project at /opt/yourproject. You analyze the logged-in user experience and propose improvements.

You are a READ-ONLY research agent. You CANNOT modify any source code. You analyze and write ideas ONLY.

YOUR FOCUS: The LOGGED-IN EXPERIENCE — everything after a user signs in:
- User dashboard (activity overview, key metrics, status indicators)
- Core workflow UI (the main actions users perform in the app)
- Results/output display (data cards, detail panels, status indicators)
- Report viewing and generation
- Admin panel (user management, system settings, configuration)
- Settings page (profile, notifications, API keys, integrations)
- Data visualizations (charts, graphs, trend lines, heat maps)
- Tables, filters, search, pagination
- Loading states, empty states, error states
- Notifications and toast messages
- Dark mode / theme consistency
- Responsive portal experience on tablets/phones

STEPS:
1. READ the project codebase to understand what it does and what the portal currently looks like
2. Review the database schema and API endpoints to understand data available
3. Search for 3-5 competitors in the same product category and compare their portal UX
4. Identify the TOP 5 most impactful portal improvements

OUTPUT: Write EXACTLY 10 ideas to ideas/portal_design_latest.md in this format:

# 🖥️ Portal Design Ideas — [date]
## Idea 1: [Title]
**Priority:** HIGH/MEDIUM/LOW
**Category:** Dashboard/Workflow/Reports/Admin/Visualizations/Tables/States
**Current state:** What the portal looks like now for this feature
**Proposed change:** Detailed description with specific UI/UX changes
**Why it matters:** User experience impact, retention, professionalism
**Implementation guide:** Step-by-step — files, components, CSS classes, JS logic
**Data requirements:** What API endpoints or DB queries are needed

[repeat for all 10 ideas]

RULES:
- Do NOT modify any source files — ONLY write to ideas/portal_design_latest.md
- Each idea must include enough detail for a developer to implement it fully
- Skip ideas already in the IMPLEMENTED LOG below
- Think like a product designer at a top SaaS company
- Include mockup descriptions or ASCII layouts where helpful

FORMAT: For each idea, include:
- **Priority**: high / medium / low
- **Impact**: 1-10 (10 = game-changing)
- **Effort**: small / medium / large
Order ideas by impact score (highest first).
PROMPTEOF
)
fi  # end prompt file fallback

# Inject project-specific context if available
if [ -n "${PROJECT_CONTEXT:-}" ]; then
  PROMPT="${PROMPT}

═══════════════════════════════════════════════════════════════════════
PROJECT-SPECIFIC CONTEXT:
${PROJECT_CONTEXT}
═══════════════════════════════════════════════════════════════════════"
fi

CONTEXT=$(cat <<CTXEOF

ALREADY IMPLEMENTED (skip these):
${IMPLEMENTED:-  (none yet)}
CTXEOF
)

cd "$IDEAS_DIR" || exit 1

"$COPILOT" --prompt "${PROMPT}${CONTEXT}" --yolo \
  --add-dir "$PROJECT_DIR" \
  --add-dir "$IDEAS_DIR" \
  --allow-all-urls \
  --deny-tool 'shell(git push)' \
  --deny-tool 'shell(git commit)' \
  --deny-tool 'shell(git add)' \
  --deny-tool 'shell(rm:*)' \
  >> "$LOG_FILE" 2>&1

EXIT_CODE=$?
echo "Portal Designer Finished: $(date) (exit: $EXIT_CODE)" >> "$LOG_FILE"

# Validate output file was created with content
OUTPUT_FILE="${IDEAS_DIR}/portal_design_latest.md"
if [ ! -f "$OUTPUT_FILE" ] || [ $(wc -l < "$OUTPUT_FILE" 2>/dev/null || echo 0) -lt 5 ]; then
  echo "⚠ Output file missing or too short — agent may have failed silently" >> "$LOG_FILE"
  "$NOTIFY" "Portal Designer: output file empty or missing" >> "$LOG_FILE" 2>&1
fi

[ $EXIT_CODE -ne 0 ] && "$NOTIFY" "Portal Designer agent failed (exit $EXIT_CODE)" >> "$LOG_FILE" 2>&1
exit $EXIT_CODE