cli-deadline-monitor

CLI tool for tracking Greek tax deadlines (AADE, EFKA). Real-time monitoring with configurable alerts via Slack, SMS, email, or local files.

# CLI Deadline Monitor

This skill provides comprehensive command-line tools for monitoring Greek government websites and APIs to track tax deadlines, regulatory changes, and compliance requirements in real-time.


## Setup

```bash
# 1. Set data directory
export OPENCLAW_DATA_DIR="/data"

# 2. Ensure jq is installed
which jq || sudo apt install jq

# 3. Ensure client data exists
ls $OPENCLAW_DATA_DIR/clients/*/compliance/obligations.json
```

No external credentials required. This skill reads deadline data from local files only.


## Core Philosophy

- **Real-time Monitoring**: Continuous checking of AADE and EFKA websites for deadline changes
- **API-First Approach**: Use official APIs where available, intelligent scraping where necessary
- **Proactive Alerts**: Early warning system for deadline changes and new requirements
- **CLI Efficiency**: Fast, scriptable commands for integration with automated workflows
- **Reliability**: Robust error handling and fallback mechanisms for critical compliance monitoring

## Key Capabilities

### 1. AADE Deadline Monitoring
- **Tax Return Deadlines**: Monitor individual and corporate tax return due dates
- **VAT Return Tracking**: Monthly and quarterly VAT submission deadlines
- **myDATA Requirements**: Real-time invoice submission deadline monitoring
- **System Status**: TAXIS and myDATA system availability checking
- **Rate Change Alerts**: VAT rate changes and effective dates
- **Form Updates**: New tax forms and requirement changes

### 2. EFKA Social Security Monitoring
- **Contribution Deadlines**: Monthly social security payment due dates
- **Rate Updates**: Changes to social security contribution rates
- **Employer Obligations**: New employer reporting requirements
- **System Maintenance**: EFKA portal downtime and maintenance schedules
- **Legislative Changes**: New social security laws and regulations

### 3. Municipal Tax & License Monitoring
- **Property Tax (TAP)**: Municipal property tax monitoring (0.025%-0.035% of property value)
- **Business License Renewals**: Track municipal business license expiration and renewal requirements
- **Municipal Permits**: Construction, signage, zoning, and operational permits by municipality
- **Waste Collection & Lighting Fees**: Municipality-specific rates and payment schedules
- **Municipal Transfer Tax Surcharge**: 0.09% municipal surcharge on property transfers
- **Local Business Taxes**: Municipality-specific business activity taxes and fees
- **Building Permits**: Municipal construction permit deadlines and requirements

### 3. CLI Command Interface
- **Quick Status Commands**: Fast deadline checking and status overview
- **Automated Scheduling**: Cron-compatible commands for regular monitoring
- **Alert Configuration**: Customizable notification thresholds and methods
- **Batch Processing**: Multiple deadline checks in single command execution
- **Export Options**: JSON, CSV, and structured output formats

### 4. Integration & Automation
- **Email Notifications**: Automated email alerts for deadline changes
- **Notification System**: Alert notifications via configured channels
- **Deadline Tracking**: Deadline alerts and tracking via CLI
- **API Webhooks**: REST API endpoints for external system integration
- **Log Management**: Comprehensive logging of all monitoring activities

## Implementation Guidelines

### Command Structure Design

#### Core CLI Commands
```bash
# Primary monitoring commands
openclaw deadline check aade          # Check all AADE deadlines
openclaw deadline check efka          # Check all EFKA deadlines  
openclaw deadline check all           # Check all government deadlines

# Specific deadline types
openclaw deadline vat monthly         # Monthly VAT return deadlines
openclaw deadline vat quarterly       # Quarterly VAT deadlines
openclaw deadline tax individual      # Individual tax return deadlines
openclaw deadline tax corporate       # Corporate tax deadlines
openclaw deadline social monthly      # Monthly social security deadlines

# Municipal monitoring commands
openclaw deadline municipal --city athens    # Athens municipality deadlines
openclaw deadline municipal --city thessaloniki # Thessaloniki municipality deadlines
openclaw deadline municipal all       # All municipal deadlines by taxpayer location
openclaw licenses check renewals      # Business license renewal deadlines
openclaw permits check construction   # Construction permit deadlines
openclaw municipal rates update       # Municipal tax rate changes

# System status checks
openclaw status aade                  # AADE system availability
openclaw status efka                  # EFKA system status
openclaw status mydata               # myDATA platform status
openclaw status taxis               # TAXIS system status

# Alert management
openclaw alerts setup               # Configure alert preferences
openclaw alerts test                # Test notification systems
openclaw alerts history            # View alert history
openclaw alerts disable            # Temporarily disable alerts
```

#### Advanced Monitoring Commands
```bash
# Historical tracking
openclaw deadline history aade      # Show AADE deadline change history
openclaw deadline compare 2025 2026 # Compare deadlines between years
openclaw deadline export json       # Export deadlines to JSON
openclaw deadline export calendar   # Export to calendar format

# Rate monitoring
openclaw rates vat current          # Current VAT rates
openclaw rates vat changes          # VAT rate change history
openclaw rates social current       # Current social security rates
openclaw rates social changes       # Social security rate changes

# Form and requirement monitoring  
openclaw forms check updates        # Check for new tax forms
openclaw forms download new         # Download updated forms
openclaw requirements changes       # Check requirement changes
```

### API Integration Architecture

#### AADE API Integration
```yaml
AADE_Endpoints:
  taxis_status:
    url: "https://www1.aade.gr/taxisnet/api/status"
    method: "GET"
    auth_required: false
    rate_limit: "100/hour"
    
  mydata_status:
    url: "https://mydatapi.aade.gr/api/status"
    method: "GET" 
    auth_required: false
    rate_limit: "100/hour"
    
  deadline_tracker:
    url: "https://www.aade.gr/api/deadlines/current"
    method: "GET"
    auth_required: false
    rate_limit: "50/hour"
    
  vat_rates:
    url: "https://www.aade.gr/api/rates/vat/current"
    method: "GET"
    auth_required: false
    rate_limit: "20/hour"

AADE_Scraping_Targets:
  deadline_announcements:
    url: "https://www.aade.gr/epiheiriseis/forologikes-ypohreosieis"
    selector: ".announcement-deadline"
    frequency: "every_4_hours"
    
  rate_changes:
    url: "https://www.aade.gr/epiheiriseis/fpa"
    selector: ".rate-change-notice"
    frequency: "daily"
    
  system_maintenance:
    url: "https://www.aade.gr/systima/sytirika-minymata"
    selector: ".maintenance-notice"
    frequency: "hourly"
```

#### EFKA API Integration  
```yaml
EFKA_Endpoints:
  portal_status:
    url: "https://www.efka.gov.gr/api/status"
    method: "GET"
    auth_required: false
    rate_limit: "100/hour"
    
  contribution_rates:
    url: "https://www.efka.gov.gr/api/rates/current"
    method: "GET"
    auth_required: false
    rate_limit: "20/hour"
    
  deadline_tracker:
    url: "https://www.efka.gov.gr/api/deadlines/monthly"
    method: "GET"
    auth_required: false
    rate_limit: "50/hour"

EFKA_Scraping_Targets:
  contribution_deadlines:
    url: "https://www.efka.gov.gr/el/ypodomes/efka/asfalikes-eisfores"
    selector: ".deadline-table"
    frequency: "every_6_hours"
    
  rate_announcements:
    url: "https://www.efka.gov.gr/el/anakoinoseis"
    selector: ".rate-announcement"
    frequency: "daily"
    
  legislative_changes:
    url: "https://www.efka.gov.gr/el/nomothesia"
    selector: ".law-change"
    frequency: "daily"

#### Municipal API Integration
```yaml
Major_Munic