cc-agentic-framework 1.14.1

package/framework/modules/core/templates/config/statusline.sh.template

@@ -0,0 +1,253 @@
+#!/bin/bash
+# Claude Code Statusline - Model-Aware Context Dashboard
+# Tracks context usage with model-aware sizing, cost, duration, and git info
+# Reference: https://codelynx.dev/posts/calculate-claude-code-context
+
+input=$(cat)
+
+MODEL=$(echo "$input" | jq -r '.model.display_name')
+MODEL_ID=$(echo "$input" | jq -r '.model.id // empty')
+CONTEXT_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size')
+TRANSCRIPT_PATH=$(echo "$input" | jq -r '.transcript_path // empty')
+CURRENT_DIR=$(echo "$input" | jq -r '.workspace.current_dir // empty')
+COST_USD=$(echo "$input" | jq -r '.cost.total_cost_usd // empty')
+DURATION_MS=$(echo "$input" | jq -r '.cost.total_duration_ms // empty')
+
+# ANSI color codes
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+ORANGE='\033[38;5;208m'
+RED='\033[0;31m'
+BRIGHT_RED='\033[1;31m'
+CYAN='\033[0;36m'
+DIM='\033[2m'
+RESET='\033[0m'
+
+# Format context size for display (e.g., "1M" or "200K")
+if [ "$CONTEXT_SIZE" -ge 500000 ] 2>/dev/null; then
+    CONTEXT_SIZE_DISPLAY="1M"
+else
+    CONTEXT_SIZE_DISPLAY="200K"
+fi
+
+# Get project name from current directory
+PROJECT_NAME=""
+if [ -n "$CURRENT_DIR" ]; then
+    PROJECT_NAME=$(basename "$CURRENT_DIR")
+fi
+
+# Git info with caching (5s TTL)
+GIT_INFO=""
+GIT_CACHE="/tmp/statusline-git-cache-$$"
+GIT_DIR="${CURRENT_DIR:-.}"
+
+get_git_info() {
+    local branch staged modified
+    branch=$(git -C "$GIT_DIR" rev-parse --abbrev-ref HEAD 2>/dev/null) || return 1
+    staged=$(git -C "$GIT_DIR" diff --cached --numstat 2>/dev/null | wc -l | tr -d ' ')
+    modified=$(git -C "$GIT_DIR" diff --numstat 2>/dev/null | wc -l | tr -d ' ')
+    echo "${branch}:${staged}:${modified}"
+}
+
+# Check cache freshness (5s TTL)
+CACHE_VALID=false
+if [ -f "$GIT_CACHE" ]; then
+    CACHE_AGE=$(( $(date +%s) - $(stat -f %m "$GIT_CACHE" 2>/dev/null || echo 0) ))
+    if [ "$CACHE_AGE" -lt 5 ]; then
+        CACHE_VALID=true
+    fi
+fi
+
+if $CACHE_VALID; then
+    GIT_RAW=$(cat "$GIT_CACHE")
+else
+    GIT_RAW=$(get_git_info)
+    if [ -n "$GIT_RAW" ]; then
+        echo "$GIT_RAW" > "$GIT_CACHE"
+    fi
+fi
+
+if [ -n "$GIT_RAW" ]; then
+    GIT_BRANCH=$(echo "$GIT_RAW" | cut -d: -f1)
+    GIT_STAGED=$(echo "$GIT_RAW" | cut -d: -f2)
+    GIT_MODIFIED=$(echo "$GIT_RAW" | cut -d: -f3)
+    GIT_INFO=" | 🌿 ${GIT_BRANCH}"
+    [ "$GIT_STAGED" -gt 0 ] 2>/dev/null && GIT_INFO="${GIT_INFO} +${GIT_STAGED}"
+    [ "$GIT_MODIFIED" -gt 0 ] 2>/dev/null && GIT_INFO="${GIT_INFO} ~${GIT_MODIFIED}"
+fi
+
+# Format cost
+COST_DISPLAY=""
+if [ -n "$COST_USD" ] && [ "$COST_USD" != "null" ]; then
+    COST_DISPLAY="💰 \$${COST_USD}"
+fi
+
+# Format duration
+DURATION_DISPLAY=""
+if [ -n "$DURATION_MS" ] && [ "$DURATION_MS" != "null" ] && [ "$DURATION_MS" != "0" ]; then
+    TOTAL_SECS=$((DURATION_MS / 1000))
+    MINS=$((TOTAL_SECS / 60))
+    SECS=$((TOTAL_SECS % 60))
+    if [ $MINS -gt 0 ]; then
+        DURATION_DISPLAY="⏱ ${MINS}m ${SECS}s"
+    else
+        DURATION_DISPLAY="⏱ ${SECS}s"
+    fi
+fi
+
+# Function to calculate tokens from transcript (filters sidechains)
+calculate_from_transcript() {
+    local transcript="$1"
+    if [ -f "$transcript" ]; then
+        local usage=$(cat "$transcript" 2>/dev/null | \
+            jq -s '[.[] | select(.isSidechain != true and .isApiErrorMessage != true and .message.usage != null)] | last | .message.usage // empty' 2>/dev/null)
+
+        if [ -n "$usage" ] && [ "$usage" != "null" ] && [ "$usage" != "" ]; then
+            local input_tokens=$(echo "$usage" | jq '.input_tokens // 0')
+            local cache_create=$(echo "$usage" | jq '.cache_creation_input_tokens // 0')
+            local cache_read=$(echo "$usage" | jq '.cache_read_input_tokens // 0')
+            echo "$((input_tokens + cache_create + cache_read)):$cache_create:$cache_read"
+            return 0
+        fi
+    fi
+    return 1
+}
+
+# Function to calculate tokens from current_usage (fallback)
+calculate_from_usage() {
+    local usage=$(echo "$input" | jq '.context_window.current_usage')
+    if [ "$usage" != "null" ] && [ -n "$usage" ]; then
+        local input_tokens=$(echo "$usage" | jq '.input_tokens // 0')
+        local cache_create=$(echo "$usage" | jq '.cache_creation_input_tokens // 0')
+        local cache_read=$(echo "$usage" | jq '.cache_read_input_tokens // 0')
+        echo "$((input_tokens + cache_create + cache_read)):$cache_create:$cache_read"
+        return 0
+    fi
+    return 1
+}
+
+# Try transcript first (accurate, filters sidechains), then fall back to current_usage
+TOKEN_DATA=""
+if [ -n "$TRANSCRIPT_PATH" ]; then
+    TOKEN_DATA=$(calculate_from_transcript "$TRANSCRIPT_PATH")
+fi
+
+if [ -z "$TOKEN_DATA" ]; then
+    TOKEN_DATA=$(calculate_from_usage)
+fi
+
+# Line 1: Model + project + git
+echo -e "${CYAN}[${MODEL}]${RESET} 📁 ${PROJECT_NAME}${GIT_INFO}"
+
+if [ -n "$TOKEN_DATA" ]; then
+    # Parse token data (format: total:cache_create:cache_read)
+    CURRENT_TOKENS=$(echo "$TOKEN_DATA" | cut -d: -f1)
+    CACHE_CREATE_TOKENS=$(echo "$TOKEN_DATA" | cut -d: -f2)
+    CACHE_READ_TOKENS=$(echo "$TOKEN_DATA" | cut -d: -f3)
+
+    # Auto-compact threshold: Claude Code triggers at ~95% of context window
+    AUTOCOMPACT_THRESHOLD=$((CONTEXT_SIZE * 95 / 100))
+
+    # Calculate percentage against autocompact threshold
+    PERCENT_TO_COMPACT=$((CURRENT_TOKENS * 100 / AUTOCOMPACT_THRESHOLD))
+
+    # Calculate tokens remaining until autocompact
+    TOKENS_TO_COMPACT=$((AUTOCOMPACT_THRESHOLD - CURRENT_TOKENS))
+
+    # Format token count (K for thousands)
+    if [ $CURRENT_TOKENS -ge 1000 ]; then
+        TOKEN_DISPLAY="$((CURRENT_TOKENS / 1000))K"
+    else
+        TOKEN_DISPLAY="${CURRENT_TOKENS}"
+    fi
+
+    # Calculate cache hit ratio if cache is being used
+    CACHE_INFO=""
+    if [ $CACHE_READ_TOKENS -gt 0 ]; then
+        TOTAL_CACHEABLE=$((CACHE_CREATE_TOKENS + CACHE_READ_TOKENS))
+        if [ $TOTAL_CACHEABLE -gt 0 ]; then
+            CACHE_HIT_RATIO=$((CACHE_READ_TOKENS * 100 / TOTAL_CACHEABLE))
+            CACHE_INFO=" ${DIM}[Cache: ${CACHE_HIT_RATIO}%]${RESET}"
+        fi
+    fi
+
+    # 5-tier color thresholds with progressive warnings
+    WARNING=""
+    if [ $PERCENT_TO_COMPACT -ge 100 ]; then
+        COLOR=$BRIGHT_RED
+        WARNING=" 💥 COMPACTING"
+    elif [ $PERCENT_TO_COMPACT -ge 90 ]; then
+        COLOR=$RED
+        WARNING=" 🔴 AUTO-COMPACT IMMINENT"
+    elif [ $PERCENT_TO_COMPACT -ge 70 ]; then
+        COLOR=$ORANGE
+        WARNING=" ⚠ COMPACT SOON"
+    elif [ $PERCENT_TO_COMPACT -ge 50 ]; then
+        COLOR=$YELLOW
+    else
+        COLOR=$GREEN
+    fi
+
+    # Create progress bar (20 characters wide) based on autocompact threshold
+    BAR_WIDTH=20
+    FILLED=$((PERCENT_TO_COMPACT * BAR_WIDTH / 100))
+    if [ $FILLED -gt $BAR_WIDTH ]; then
+        FILLED=$BAR_WIDTH
+    fi
+    if [ $FILLED -lt 0 ]; then
+        FILLED=0
+    fi
+    EMPTY=$((BAR_WIDTH - FILLED))
+
+    # Build progress bar with autocompact marker
+    BAR=""
+    for ((i=0; i<FILLED; i++)); do
+        if [ $i -eq $((BAR_WIDTH - 1)) ] && [ $PERCENT_TO_COMPACT -ge 100 ]; then
+            BAR="${BAR}│"
+        else
+            BAR="${BAR}█"
+        fi
+    done
+
+    if [ $FILLED -lt $BAR_WIDTH ]; then
+        BAR="${BAR}│"
+        EMPTY=$((EMPTY - 1))
+    fi
+
+    for ((i=0; i<EMPTY; i++)); do
+        BAR="${BAR}░"
+    done
+
+    # Line 2: Context bar with absolute tokens and context size
+    echo -e "${COLOR}[${BAR}]${RESET} ${PERCENT_TO_COMPACT}% ${DIM}(${TOKEN_DISPLAY}/${CONTEXT_SIZE_DISPLAY})${RESET}${CACHE_INFO}${WARNING}"
+
+    # Line 3: Cost + duration + context remaining
+    LINE3_PARTS=()
+    [ -n "$COST_DISPLAY" ] && LINE3_PARTS+=("$COST_DISPLAY")
+    [ -n "$DURATION_DISPLAY" ] && LINE3_PARTS+=("$DURATION_DISPLAY")
+    CONTEXT_LEFT=$((100 - PERCENT_TO_COMPACT))
+    [ $CONTEXT_LEFT -lt 0 ] && CONTEXT_LEFT=0
+    LINE3_PARTS+=("Context left: ${CONTEXT_LEFT}%")
+
+    # Join parts with " | "
+    LINE3=""
+    for ((i=0; i<${#LINE3_PARTS[@]}; i++)); do
+        [ $i -gt 0 ] && LINE3="${LINE3} | "
+        LINE3="${LINE3}${LINE3_PARTS[$i]}"
+    done
+    echo -e "${DIM}${LINE3}${RESET}"
+else
+    # No usage data
+    echo -e "${GREEN}[│░░░░░░░░░░░░░░░░░░░]${RESET} 0% ${DIM}(0/${CONTEXT_SIZE_DISPLAY})${RESET}"
+
+    LINE3_PARTS=()
+    [ -n "$COST_DISPLAY" ] && LINE3_PARTS+=("$COST_DISPLAY")
+    [ -n "$DURATION_DISPLAY" ] && LINE3_PARTS+=("$DURATION_DISPLAY")
+    LINE3_PARTS+=("Context left: 100%")
+    LINE3=""
+    for ((i=0; i<${#LINE3_PARTS[@]}; i++)); do
+        [ $i -gt 0 ] && LINE3="${LINE3} | "
+        LINE3="${LINE3}${LINE3_PARTS[$i]}"
+    done
+    echo -e "${DIM}${LINE3}${RESET}"
+fi

package/framework/modules/core/templates/context/business-advanced.template.md

@@ -0,0 +1,71 @@
+# Business Context - Advanced Level
+
+<!-- CONTEXT-LEVEL: advanced -->
+<!-- CATEGORY: business -->
+<!-- TOKEN-TARGET: ~1000 -->
+
+> **Purpose:** Detailed business knowledge including features, workflows, and business rules
+>
+> **When loaded:** Loaded with advanced+ context levels
+
+---
+
+## Feature Descriptions
+
+<!-- TEMPLATE: Describe major features in detail, including how they work from a user perspective -->
+
+### Feature 1: [Feature Name]
+
+<!-- TEMPLATE: Describe the feature, its purpose, and how users interact with it -->
+
+### Feature 2: [Feature Name]
+
+<!-- TEMPLATE: Describe the feature, its purpose, and how users interact with it -->
+
+## User Workflows
+
+<!-- TEMPLATE: Document detailed user workflows and journeys through the product -->
+
+### Workflow 1: [Workflow Name]
+
+<!-- TEMPLATE: Describe step-by-step user flow -->
+
+1.
+2.
+3.
+
+### Workflow 2: [Workflow Name]
+
+<!-- TEMPLATE: Describe step-by-step user flow -->
+
+1.
+2.
+3.
+
+## Backlog Priorities
+
+<!-- TEMPLATE: Describe current priorities, what's important now, and what's coming next -->
+
+### Current Focus
+
+<!-- TEMPLATE: What the team is working on right now -->
+
+### Upcoming Priorities
+
+<!-- TEMPLATE: What's planned for the near future -->
+
+## Business Rules and Logic
+
+<!-- TEMPLATE: Document important business rules, constraints, and logic that drive product behavior -->
+
+### Rule 1: [Rule Name]
+
+<!-- TEMPLATE: Describe the business rule and why it exists -->
+
+### Rule 2: [Rule Name]
+
+<!-- TEMPLATE: Describe the business rule and why it exists -->
+
+## Edge Cases and Exceptions
+
+<!-- TEMPLATE: Document important edge cases or exceptional business scenarios -->

package/framework/modules/core/templates/context/business-basic.template.md

@@ -0,0 +1,39 @@
+# Business Context - Basic Level
+
+<!-- CONTEXT-LEVEL: basic -->
+<!-- CATEGORY: business -->
+<!-- TOKEN-TARGET: ~500 -->
+
+> **Purpose:** Core business concepts, product purpose, and domain vocabulary
+>
+> **When loaded:** Always loaded for all agents
+
+---
+
+## Product Overview
+
+<!-- TEMPLATE: Provide a concise description of what your product does and why it exists -->
+
+## Target Users
+
+<!-- TEMPLATE: Describe your primary user personas and their key characteristics -->
+
+## Domain Vocabulary
+
+<!-- TEMPLATE: Define key business terms and domain-specific language that agents need to understand -->
+
+| Term | Definition |
+|------|------------|
+| <!-- TEMPLATE: Add domain terms --> | |
+
+## Key Value Propositions
+
+<!-- TEMPLATE: List the main value propositions or benefits your product provides -->
+
+1.
+2.
+3.
+
+## Core Use Cases
+
+<!-- TEMPLATE: Describe the 2-3 most important use cases or workflows your product supports -->

package/framework/modules/core/templates/context/business-expert.template.md

@@ -0,0 +1,95 @@
+# Business Context - Expert Level
+
+<!-- CONTEXT-LEVEL: expert -->
+<!-- CATEGORY: business -->
+<!-- TOKEN-TARGET: ~1500 -->
+
+> **Purpose:** Strategic business context including product strategy, roadmap, and market positioning
+>
+> **When loaded:** Loaded with expert context level only
+
+---
+
+## Product Strategy
+
+<!-- TEMPLATE: Describe the overarching product strategy and vision for the next 1-2 years -->
+
+### Strategic Goals
+
+<!-- TEMPLATE: List key strategic objectives -->
+
+1.
+2.
+3.
+
+### Success Metrics
+
+<!-- TEMPLATE: Define how you measure strategic success -->
+
+## Roadmap Vision
+
+<!-- TEMPLATE: Describe the product roadmap and major initiatives planned -->
+
+### Near-term (3-6 months)
+
+<!-- TEMPLATE: Describe immediate roadmap items -->
+
+### Medium-term (6-12 months)
+
+<!-- TEMPLATE: Describe medium-term plans -->
+
+### Long-term (12+ months)
+
+<!-- TEMPLATE: Describe long-term vision items -->
+
+## Market Positioning
+
+<!-- TEMPLATE: Describe how your product is positioned in the market -->
+
+### Market Segment
+
+<!-- TEMPLATE: Define your market segment and target market -->
+
+### Differentiation
+
+<!-- TEMPLATE: Explain what makes your product unique or different -->
+
+## Competitive Landscape
+
+<!-- TEMPLATE: Describe the competitive environment -->
+
+### Key Competitors
+
+<!-- TEMPLATE: List and describe main competitors -->
+
+| Competitor | Strengths | Weaknesses |
+|------------|-----------|------------|
+| <!-- TEMPLATE: Add competitors --> | | |
+
+### Competitive Advantages
+
+<!-- TEMPLATE: Describe your competitive advantages -->
+
+## Strategic Constraints
+
+<!-- TEMPLATE: Document strategic constraints, limitations, or dependencies -->
+
+### Business Constraints
+
+<!-- TEMPLATE: Describe business constraints (budget, resources, partnerships, etc.) -->
+
+### Market Constraints
+
+<!-- TEMPLATE: Describe market constraints (regulations, market conditions, etc.) -->
+
+## Strategic Decisions
+
+<!-- TEMPLATE: Document major strategic decisions and their rationale -->
+
+### Decision 1: [Decision Name]
+
+<!-- TEMPLATE: Describe the decision, why it was made, and its implications -->
+
+### Decision 2: [Decision Name]
+
+<!-- TEMPLATE: Describe the decision, why it was made, and its implications -->

package/framework/modules/core/templates/context/process-advanced.template.md

@@ -0,0 +1,141 @@
+# Process Context - Advanced Level
+
+<!-- CONTEXT-LEVEL: advanced -->
+<!-- CATEGORY: process -->
+<!-- TOKEN-TARGET: ~1000 -->
+
+> **Purpose:** Complex processes including incident response, approval flows, and cross-team coordination
+>
+> **When loaded:** Loaded with advanced+ context levels
+
+---
+
+## Incident Response
+
+<!-- TEMPLATE: Describe the incident response process -->
+
+### Incident Classification
+
+<!-- TEMPLATE: Define incident severity levels -->
+
+| Severity | Definition | Response Time |
+|----------|------------|---------------|
+| <!-- TEMPLATE: Add severity levels --> | | |
+
+### Incident Response Workflow
+
+<!-- TEMPLATE: Describe step-by-step incident response process -->
+
+1. **Detection:** <!-- TEMPLATE: How incidents are detected -->
+2. **Assessment:** <!-- TEMPLATE: How severity is assessed -->
+3. **Response:** <!-- TEMPLATE: How the team responds -->
+4. **Resolution:** <!-- TEMPLATE: How incidents are resolved -->
+5. **Post-mortem:** <!-- TEMPLATE: Post-incident review process -->
+
+### On-Call Rotation
+
+<!-- TEMPLATE: Describe on-call rotation and responsibilities -->
+
+## Complex Approval Flows
+
+<!-- TEMPLATE: Document approval processes for significant changes -->
+
+### Architecture Change Approval
+
+<!-- TEMPLATE: Describe process for approving architectural changes -->
+
+### Database Schema Changes
+
+<!-- TEMPLATE: Describe process for database schema changes -->
+
+### Security Change Approval
+
+<!-- TEMPLATE: Describe process for security-related changes -->
+
+## Cross-Team Coordination
+
+<!-- TEMPLATE: Describe how work is coordinated across teams -->
+
+### Dependencies Management
+
+<!-- TEMPLATE: Describe how cross-team dependencies are managed -->
+
+### Communication Protocols
+
+<!-- TEMPLATE: Define communication protocols for cross-team work -->
+
+### Stakeholder Engagement
+
+<!-- TEMPLATE: Describe when and how to engage stakeholders -->
+
+## Release Management
+
+<!-- TEMPLATE: Describe the release management process -->
+
+### Release Planning
+
+<!-- TEMPLATE: Describe how releases are planned -->
+
+### Release Cycle
+
+<!-- TEMPLATE: Define the release cycle and cadence -->
+
+### Release Checklist
+
+<!-- TEMPLATE: Provide release checklist -->
+
+- [ ] <!-- TEMPLATE: Add checklist items -->
+- [ ]
+- [ ]
+
+### Rollback Procedures
+
+<!-- TEMPLATE: Describe rollback procedures -->
+
+## Change Management
+
+<!-- TEMPLATE: Describe the change management process -->
+
+### Change Request Process
+
+<!-- TEMPLATE: Describe how changes are requested and approved -->
+
+### Change Impact Assessment
+
+<!-- TEMPLATE: Describe how change impact is assessed -->
+
+## Tactical Decisions
+
+<!-- TEMPLATE: Document process for making tactical decisions -->
+
+### Decision Framework
+
+<!-- TEMPLATE: Describe framework for making tactical decisions -->
+
+### Decision Authority
+
+<!-- TEMPLATE: Define who has authority to make what decisions -->
+
+## Quality Assurance
+
+<!-- TEMPLATE: Describe detailed QA processes -->
+
+### Testing Levels
+
+<!-- TEMPLATE: Describe different levels of testing -->
+
+### QA Gates
+
+<!-- TEMPLATE: Define quality gates that must be passed -->
+
+## Documentation Standards
+
+<!-- TEMPLATE: Describe documentation requirements and standards -->
+
+### Required Documentation
+
+<!-- TEMPLATE: List what documentation is required for different types of changes -->
+
+### Documentation Review
+
+<!-- TEMPLATE: Describe documentation review process -->

package/framework/modules/core/templates/context/process-basic.template.md

@@ -0,0 +1,87 @@
+# Process Context - Basic Level
+
+<!-- CONTEXT-LEVEL: basic -->
+<!-- CATEGORY: process -->
+<!-- TOKEN-TARGET: ~500 -->
+
+> **Purpose:** Standard workflows including development, review, and deployment processes
+>
+> **When loaded:** Always loaded for all agents
+
+---
+
+## Team Structure
+
+<!-- TEMPLATE: Describe the team structure and key roles -->
+
+### Team Members
+
+<!-- TEMPLATE: List team roles and responsibilities -->
+
+| Role | Responsibilities |
+|------|------------------|
+| <!-- TEMPLATE: Add team roles --> | |
+
+### Communication Channels
+
+<!-- TEMPLATE: Describe primary communication channels and their usage -->
+
+## Development Workflow
+
+<!-- TEMPLATE: Describe the standard development workflow -->
+
+### 1. Task Assignment
+
+<!-- TEMPLATE: Describe how tasks are assigned and tracked -->
+
+### 2. Development Process
+
+<!-- TEMPLATE: Describe the development process (branching, coding, testing) -->
+
+### 3. Code Submission
+
+<!-- TEMPLATE: Describe how code is submitted (PR process, etc.) -->
+
+## Review Process
+
+<!-- TEMPLATE: Describe the code review process -->
+
+### Review Requirements
+
+<!-- TEMPLATE: Define what's required for code review (approvals, checks, etc.) -->
+
+### Review Guidelines
+
+<!-- TEMPLATE: List key things reviewers should look for -->
+
+## Deployment Process
+
+<!-- TEMPLATE: Describe the deployment process -->
+
+### Environments
+
+<!-- TEMPLATE: List environments and their purpose -->
+
+| Environment | Purpose | Deployment Trigger |
+|-------------|---------|-------------------|
+| <!-- TEMPLATE: Add environments --> | | |
+
+### Deployment Steps
+
+<!-- TEMPLATE: Describe standard deployment steps -->
+
+1.
+2.
+3.
+
+## Quality Standards
+
+<!-- TEMPLATE: Describe basic quality standards and expectations -->
+
+### Code Quality
+
+<!-- TEMPLATE: Define code quality expectations -->
+
+### Testing Requirements
+
+<!-- TEMPLATE: Define testing requirements -->