claude-flow-novice 2.18.6 → 2.18.8

package/claude-assets/cfn-extras/skills/google-sheets-api-coordinator/test.sh

@@ -1,174 +0,0 @@
-#!/bin/bash
-set -eu
-
-# google-sheets-api-coordinator/test.sh
-# Test suite for API coordinator
-# Version: 1.0.0
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-TESTS_PASSED=0
-TESTS_FAILED=0
-TESTS_TOTAL=0
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-NC='\033[0m'
-
-assert_success() {
-  local result="$1"
-  local message="${2:-Command should succeed}"
-  ((TESTS_TOTAL++))
-
-  if echo "$result" | jq -e '.success == true' >/dev/null 2>&1; then
-    ((TESTS_PASSED++))
-    echo -e "${GREEN}✓${NC} $message"
-    return 0
-  else
-    ((TESTS_FAILED++))
-    echo -e "${RED}✗${NC} $message"
-    return 1
-  fi
-}
-
-assert_field_equals() {
-  local result="$1"
-  local field="$2"
-  local expected="$3"
-  local message="${4:-Field should equal expected}"
-  ((TESTS_TOTAL++))
-
-  local actual
-  actual=$(echo "$result" | jq -r "$field" 2>/dev/null || echo "ERROR")
-
-  if [ "$actual" = "$expected" ]; then
-    ((TESTS_PASSED++))
-    echo -e "${GREEN}✓${NC} $message"
-    return 0
-  else
-    ((TESTS_FAILED++))
-    echo -e "${RED}✗${NC} $message (got $actual)"
-    return 1
-  fi
-}
-
-test_basic_api_call() {
-  echo ""
-  echo "Testing basic API call..."
-  local result
-  result=$("$SCRIPT_DIR/api-call.sh" \
-    --api-endpoint "spreadsheets.values:get" \
-    --spreadsheet-id "test123")
-  assert_success "$result" "Basic API call should succeed"
-}
-
-test_api_call_with_method() {
-  echo ""
-  echo "Testing API call with custom method..."
-  local result
-  result=$("$SCRIPT_DIR/api-call.sh" \
-    --api-endpoint "spreadsheets:create" \
-    --spreadsheet-id "test123" \
-    --method POST)
-  assert_success "$result" "API call with POST method should work"
-}
-
-test_batch_operation() {
-  echo ""
-  echo "Testing batch operation..."
-  local result
-  result=$("$SCRIPT_DIR/api-call.sh" \
-    --api-endpoint "spreadsheets.values:batchUpdate" \
-    --spreadsheet-id "test123" \
-    --batch-size 100)
-  assert_success "$result" "Batch operation should work"
-}
-
-test_quota_tracking() {
-  echo ""
-  echo "Testing quota tracking..."
-  local result
-  result=$("$SCRIPT_DIR/api-call.sh" \
-    --api-endpoint "spreadsheets.values:get" \
-    --spreadsheet-id "test123" \
-    --quota-limit 300)
-  assert_success "$result" "Quota tracking should work"
-
-  # Check quota remaining field exists
-  if echo "$result" | jq -e '.quota_usage.quota_remaining' >/dev/null 2>&1; then
-    ((TESTS_PASSED++))
-    echo -e "${GREEN}✓${NC} Quota remaining should be tracked"
-  else
-    ((TESTS_FAILED++))
-    echo -e "${RED}✗${NC} Quota remaining should be tracked"
-  fi
-  ((TESTS_TOTAL++))
-}
-
-test_missing_required_params() {
-  echo ""
-  echo "Testing missing required parameters..."
-  local result
-  result=$("$SCRIPT_DIR/api-call.sh" 2>&1 || true)
-  if echo "$result" | grep -q "required"; then
-    ((TESTS_PASSED++))
-    echo -e "${GREEN}✓${NC} Missing params should be rejected"
-  else
-    ((TESTS_FAILED++))
-    echo -e "${RED}✗${NC} Missing params should be rejected"
-  fi
-  ((TESTS_TOTAL++))
-}
-
-test_output_structure() {
-  echo ""
-  echo "Testing output structure..."
-  local result
-  result=$("$SCRIPT_DIR/api-call.sh" \
-    --api-endpoint "spreadsheets.values:get" \
-    --spreadsheet-id "test123")
-
-  local required_fields=("success" "confidence" "api_call" "quota_usage" "metrics" "deliverables")
-  local missing=0
-
-  for field in "${required_fields[@]}"; do
-    if ! echo "$result" | jq -e ".$field" >/dev/null 2>&1; then
-      ((missing++))
-    fi
-  done
-
-  ((TESTS_TOTAL++))
-  if [ $missing -eq 0 ]; then
-    ((TESTS_PASSED++))
-    echo -e "${GREEN}✓${NC} Output should have all required fields"
-  else
-    ((TESTS_FAILED++))
-    echo -e "${RED}✗${NC} Output missing $missing fields"
-  fi
-}
-
-run_tests() {
-  echo "========================================"
-  echo "Running tests for google-sheets-api-coordinator"
-  echo "========================================"
-
-  test_basic_api_call
-  test_api_call_with_method
-  test_batch_operation
-  test_quota_tracking
-  test_missing_required_params
-  test_output_structure
-
-  echo ""
-  echo "========================================"
-  echo "Test Results: $TESTS_PASSED/$TESTS_TOTAL passed"
-  echo "========================================"
-
-  if [ $TESTS_FAILED -gt 0 ]; then
-    exit 1
-  else
-    echo -e "${GREEN}All tests passed!${NC}"
-    exit 0
-  fi
-}
-
-run_tests

package/claude-assets/cfn-extras/skills/google-sheets-api-coordinator/validate.sh

@@ -1,98 +0,0 @@
-#!/bin/bash
-set -eu
-
-# google-sheets-api-coordinator/validate.sh
-# Validates dependencies and configuration
-# Version: 1.0.0
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-VALIDATION_ERRORS=0
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-validate_command() {
-  local cmd="$1"
-  local message="${2:-Command '$cmd' not found}"
-
-  if command -v "$cmd" &>/dev/null; then
-    echo -e "${GREEN}✓${NC} $cmd available"
-    return 0
-  else
-    echo -e "${RED}✗${NC} $message"
-    ((VALIDATION_ERRORS++))
-    return 1
-  fi
-}
-
-validate_file() {
-  local file="$1"
-  local message="${2:-File '$file' not found}"
-
-  if [ -f "$file" ]; then
-    echo -e "${GREEN}✓${NC} $file exists"
-    return 0
-  else
-    echo -e "${RED}✗${NC} $message"
-    ((VALIDATION_ERRORS++))
-    return 1
-  fi
-}
-
-validate_executable() {
-  local file="$1"
-  local message="${2:-File '$file' is not executable}"
-
-  if [ -x "$file" ]; then
-    echo -e "${GREEN}✓${NC} $file is executable"
-    return 0
-  else
-    echo -e "${RED}✗${NC} $message"
-    ((VALIDATION_ERRORS++))
-    return 1
-  fi
-}
-
-main() {
-  echo "========================================"
-  echo "Validating google-sheets-api-coordinator"
-  echo "========================================"
-  echo ""
-
-  echo "Checking dependencies..."
-  validate_command "bash" "Bash shell required"
-  validate_command "jq" "jq (JSON processor) required"
-  validate_command "curl" "curl required for API calls"
-
-  echo ""
-  echo "Checking skill files..."
-  validate_file "$SCRIPT_DIR/SKILL.md" "SKILL.md documentation required"
-  validate_executable "$SCRIPT_DIR/api-call.sh" "api-call.sh must be executable"
-  validate_executable "$SCRIPT_DIR/test.sh" "test.sh must be executable"
-
-  echo ""
-  echo "Testing basic functionality..."
-  if "$SCRIPT_DIR/api-call.sh" --help >/dev/null 2>&1; then
-    echo -e "${GREEN}✓${NC} api-call.sh responds to --help"
-  else
-    echo -e "${RED}✗${NC} api-call.sh help command failed"
-    ((VALIDATION_ERRORS++))
-  fi
-
-  echo ""
-  echo "========================================"
-  echo "Validation Results"
-  echo "========================================"
-
-  if [ $VALIDATION_ERRORS -eq 0 ]; then
-    echo -e "${GREEN}✓ All validations passed${NC}"
-    exit 0
-  else
-    echo -e "${RED}✗ ${VALIDATION_ERRORS} validation errors found${NC}"
-    exit 1
-  fi
-}
-
-main "$@"

package/claude-assets/cfn-extras/skills/google-sheets-decomposition/SKILL.md

@@ -1,269 +0,0 @@
-# Google Sheets Request Decomposition
-
-## Overview
-Analyzes complex Google Sheets requests and decomposes them into atomic micro-sprints with clear dependencies and success criteria.
-
-## Purpose
-Prevents "doing too much at once" by breaking complex spreadsheet operations into progressive, testable units that build toward the end goal.
-
-## Sprint Types
-
-### 1. Schema Sprint
-**Purpose:** Establish spreadsheet structure
-**Operations:**
-- Create/rename sheets
-- Add/remove columns
-- Define data types
-- Set up named ranges
-
-**Dependencies:** None (foundation sprint)
-**Max Operations:** 5 per sprint
-**Success Criteria:**
-- All sheets exist with expected names
-- Column headers match specification
-- Named ranges defined correctly
-
-### 2. Data Sprint
-**Purpose:** Populate or transform spreadsheet data
-**Operations:**
-- Import data from external sources
-- Transform existing data
-- Merge/split columns
-- Clean/normalize values
-
-**Dependencies:** Schema Sprint
-**Max Operations:** 5 per sprint
-**Success Criteria:**
-- Data imported without errors
-- Transformations produce expected output
-- No data loss or corruption
-- Row counts match expectations
-
-### 3. Formula Sprint
-**Purpose:** Add calculated columns and validation rules
-**Operations:**
-- Create formulas (simple to complex)
-- Add data validation rules
-- Implement conditional logic
-- Set up array formulas
-
-**Dependencies:** Schema Sprint, Data Sprint
-**Max Operations:** 5 per sprint
-**Success Criteria:**
-- All formulas return expected types
-- No #REF!, #VALUE!, #N/A errors
-- Validation rules enforce constraints
-- Array formulas expand correctly
-
-### 4. Formatting Sprint
-**Purpose:** Apply visual formatting and conditional styles
-**Operations:**
-- Conditional formatting rules
-- Number/date formats
-- Cell styling (colors, fonts, borders)
-- Column widths/row heights
-
-**Dependencies:** Data Sprint
-**Max Operations:** 5 per sprint
-**Success Criteria:**
-- Formatting rules apply to correct ranges
-- Conditional formatting triggers properly
-- Visual consistency maintained
-
-### 5. Integration Sprint
-**Purpose:** Connect external data sources or services
-**Operations:**
-- Import from databases
-- Connect APIs
-- Link other spreadsheets
-- Set up IMPORTRANGE functions
-
-**Dependencies:** Schema Sprint
-**Max Operations:** 3 per sprint (API quota considerations)
-**Success Criteria:**
-- External connections established
-- Data syncs without errors
-- API quota not exceeded
-- Refresh triggers work correctly
-
-### 6. Automation Sprint
-**Purpose:** Add scripts, triggers, and automations
-**Operations:**
-- Google Apps Script functions
-- Time-based triggers
-- Event-driven triggers
-- Custom functions
-
-**Dependencies:** All previous sprint types
-**Max Operations:** 3 per sprint (complexity considerations)
-**Success Criteria:**
-- Scripts execute without errors
-- Triggers fire on expected events
-- Custom functions return correct values
-- No infinite loop conditions
-
-## Decomposition Algorithm
-
-### Input
-- User request (natural language or structured)
-- Current spreadsheet state (optional)
-- Business requirements
-
-### Process
-1. **Parse Request:** Extract operations and goals
-2. **Classify Operations:** Map to sprint types
-3. **Determine Dependencies:** Build directed acyclic graph (DAG)
-4. **Group Operations:** Batch into sprints (max 5 ops/sprint)
-5. **Order Sprints:** Topological sort based on dependencies
-6. **Generate Success Criteria:** Define testable conditions for each sprint
-
-### Output
-JSON structure:
-```json
-{
-  "request_summary": "...",
-  "total_sprints": 5,
-  "sprints": [
-    {
-      "sprint_id": "schema_001",
-      "sprint_type": "schema",
-      "operations": [
-        "Create sheet 'Sales Data'",
-        "Add columns: Date, Product, Quantity, Revenue",
-        "Define named range 'SalesTable'"
-      ],
-      "dependencies": [],
-      "success_criteria": [
-        "Sheet 'Sales Data' exists",
-        "Columns match: Date, Product, Quantity, Revenue",
-        "Named range 'SalesTable' covers A1:D1000"
-      ],
-      "estimated_api_calls": 3
-    },
-    {
-      "sprint_id": "data_001",
-      "sprint_type": "data",
-      "operations": [
-        "Import CSV from Google Drive",
-        "Parse dates to standard format",
-        "Validate quantity > 0"
-      ],
-      "dependencies": ["schema_001"],
-      "success_criteria": [
-        "All rows imported (expect ~500 rows)",
-        "Date column format: YYYY-MM-DD",
-        "No negative quantities",
-        "No import errors"
-      ],
-      "estimated_api_calls": 2
-    }
-  ]
-}
-```
-
-## Usage
-
-### CLI
-```bash
-./.claude/cfn-extras/skills/google-sheets-decomposition/decompose.sh \
-  --request "Create sales dashboard with pivot tables" \
-  --mode standard \
-  --output /tmp/google-sheets-sprints.json
-```
-
-### From Agent
-```bash
-# Generate decomposition
-DECOMPOSITION=$(bash ./.claude/cfn-extras/skills/google-sheets-decomposition/decompose.sh \
-  --request "$USER_REQUEST" \
-  --mode standard)
-
-# Parse output
-TOTAL_SPRINTS=$(echo "$DECOMPOSITION" | jq -r '.total_sprints')
-```
-
-## Validation Rules
-
-### Per Sprint
-- Maximum 5 operations (3 for Integration/Automation)
-- Clear success criteria (2-5 testable conditions)
-- Explicit dependencies declared
-- Estimated API calls < 10 per sprint
-
-### Across All Sprints
-- No circular dependencies
-- Schema sprints before Data sprints
-- Formula sprints after Data sprints
-- Automation sprints last
-- Total estimated API calls < 100 (quota management)
-
-## Error Handling
-
-### Invalid Request
-```json
-{
-  "error": "INVALID_REQUEST",
-  "message": "Request too vague: 'make it better'",
-  "suggestion": "Specify concrete operations (e.g., 'add revenue column', 'create pivot table')"
-}
-```
-
-### Too Complex
-```json
-{
-  "error": "EXCEEDS_COMPLEXITY_LIMIT",
-  "message": "Request requires 25 sprints, maximum is 15",
-  "suggestion": "Break into multiple user requests or simplify scope"
-}
-```
-
-### Missing Dependencies
-```json
-{
-  "error": "CIRCULAR_DEPENDENCY",
-  "message": "Formula sprint depends on Automation sprint which depends on Formula sprint",
-  "sprints_affected": ["formula_003", "automation_001"]
-}
-```
-
-## Integration with CFN Loop
-
-### Coordinator Usage
-```bash
-# 1. Decompose request
-SPRINTS_JSON=$(decompose.sh --request "$USER_REQUEST" --mode standard)
-
-# 2. Extract sprint count
-TOTAL_SPRINTS=$(echo "$SPRINTS_JSON" | jq -r '.total_sprints')
-
-# 3. Execute sprints sequentially
-for i in $(seq 0 $((TOTAL_SPRINTS - 1))); do
-  SPRINT=$(echo "$SPRINTS_JSON" | jq -r ".sprints[$i]")
-  SPRINT_ID=$(echo "$SPRINT" | jq -r '.sprint_id')
-
-  # Execute CFN Loop for this micro-sprint
-  ./.claude/skills/cfn-loop-orchestration/orchestrate.sh \
-    --task-id "$TASK_ID" \
-    --sprint "$SPRINT" \
-    --mode standard
-done
-```
-
-## Testing
-
-Test script: `./.claude/cfn-extras/skills/google-sheets-decomposition/test-decomposition.sh`
-
-**Test Cases:**
-1. Simple request (1 sprint)
-2. Multi-sprint with dependencies
-3. Complex request (10+ sprints)
-4. Invalid request handling
-5. Circular dependency detection
-6. API quota estimation
-
-**Expected Pass Rate:** ≥0.95 (Standard mode)
-
-## References
-- Google Sheets API Quotas: https://developers.google.com/sheets/api/limits
-- Sprint Types Documentation: `./.claude/cfn-extras/docs/GOOGLE_SHEETS_SPRINTS.md`
-- CFN Loop Integration: `CLAUDE.md` Section 4