takomi 2.0.4

package/assets/.agent/skills/github-ops/scripts/publish_issues.ps1

@@ -0,0 +1,443 @@
+param(
+    [switch]$DryRun = $false,
+    [switch]$Update = $false,          # Update existing issues instead of skipping
+    [switch]$SyncDates = $false,        # Sync dates to GitHub Project
+    [switch]$AutoArchive = $false,      # Move completed issues to closed/ subfolder
+    [switch]$Force = $false,            # Force sync all files (ignore change detection)
+
+    # Required for SyncDates (auto-detected from repo if not provided)
+    [string]$ProjectOwner = "",
+    [int]$ProjectNumber = 0,
+    [string]$ProjectId = "",
+    [string]$StartDateFieldId = "",
+    [string]$TargetDateFieldId = "",
+    [int]$TargetWeeks = 4,
+    
+    [string]$IssueDir = "docs/issues"
+)
+
+<#
+.SYNOPSIS
+    Smart Issue Sync - Syncs markdown issue specs to GitHub with intelligent change detection.
+
+.DESCRIPTION
+    Features:
+      - SMART SYNC: Only processes files that changed since last run (uses .issue-sync-state.json)
+      - AUTO-ARCHIVE: Moves completed .md files to closed/ subfolder  
+      - AUTO-CLOSE: Closes GitHub issues when all checkboxes are ticked
+      - NATURAL SORT: Processes Issue_1, Issue_2, ... Issue_10 (not 1, 10, 11)
+      - DATE SYNC: Sets Start/Target dates on GitHub Projects
+
+.EXAMPLE
+    # Smart sync (only changed files)
+    .\publish_issues.ps1 -Update -AutoArchive
+
+    # Force full resync
+    .\publish_issues.ps1 -Update -AutoArchive -Force
+
+    # Dry run
+    .\publish_issues.ps1 -Update -AutoArchive -DryRun
+#>
+
+# ============ AUTO-DETECT REPO INFO ============
+$repoJson = gh repo view --json owner,name 2>$null | ConvertFrom-Json
+if (-not $repoJson) {
+    Write-Host "ERROR: Not in a GitHub repository or gh CLI not authenticated" -ForegroundColor Red
+    exit 1
+}
+$REPO_OWNER = $repoJson.owner.login
+$REPO_NAME = $repoJson.name
+$REPO = "$REPO_OWNER/$REPO_NAME"
+
+Write-Host "Repository: $REPO" -ForegroundColor Cyan
+
+# ============ STATE FILE FOR CHANGE DETECTION ============
+$stateFile = Join-Path $IssueDir ".issue-sync-state.json"
+$syncState = @{}
+
+if (Test-Path $stateFile) {
+    try {
+        $syncState = Get-Content $stateFile -Raw | ConvertFrom-Json -AsHashtable
+    } catch {
+        $syncState = @{}
+    }
+}
+
+function Save-SyncState {
+    if (-not $DryRun) {
+        $syncState | ConvertTo-Json -Depth 10 | Set-Content $stateFile -Encoding UTF8
+    }
+}
+
+function Get-FileHash256 {
+    param([string]$Path)
+    $hash = Get-FileHash -Path $Path -Algorithm SHA256
+    return $hash.Hash
+}
+
+function Test-FileChanged {
+    param([string]$FilePath)
+    
+    if ($Force) { return $true }
+    
+    $fileName = Split-Path $FilePath -Leaf
+    $currentHash = Get-FileHash256 -Path $FilePath
+    
+    if ($syncState.ContainsKey($fileName)) {
+        $lastHash = $syncState[$fileName].hash
+        return $currentHash -ne $lastHash
+    }
+    
+    return $true  # New file, never synced
+}
+
+function Update-FileState {
+    param(
+        [string]$FilePath,
+        [string]$Status,  # "synced", "archived"
+        [int]$IssueNumber = 0
+    )
+    
+    $fileName = Split-Path $FilePath -Leaf
+    $syncState[$fileName] = @{
+        hash = (Get-FileHash256 -Path $FilePath)
+        lastSync = (Get-Date -Format "yyyy-MM-ddTHH:mm:ss")
+        status = $Status
+        issueNumber = $IssueNumber
+    }
+}
+
+# ============ VALIDATE SYNC DATES CONFIG ============
+if ($SyncDates) {
+    if (-not $ProjectOwner) { $ProjectOwner = $REPO_OWNER }
+    
+    $missingConfig = @()
+    if ($ProjectNumber -eq 0) { $missingConfig += "-ProjectNumber" }
+    if (-not $ProjectId) { $missingConfig += "-ProjectId" }
+    if (-not $StartDateFieldId) { $missingConfig += "-StartDateFieldId" }
+    if (-not $TargetDateFieldId) { $missingConfig += "-TargetDateFieldId" }
+    
+    if ($missingConfig.Count -gt 0) {
+        Write-Host "ERROR: -SyncDates requires: $($missingConfig -join ', ')" -ForegroundColor Red
+        exit 1
+    }
+}
+
+# ============ FIND ISSUE FILES (Natural Sort) ============
+$closedDir = Join-Path $IssueDir "closed"
+
+# Get files and sort naturally (Issue_1, Issue_2, ... Issue_10)
+$issueFiles = Get-ChildItem "$IssueDir/*.md" -ErrorAction SilentlyContinue | 
+    Where-Object { $_.Name -ne "ALL_ISSUES.md" } |
+    Sort-Object { 
+        if ($_.Name -match 'Issue_(\d+)') { 
+            [int]$matches[1] 
+        } else { 
+            $_.Name 
+        }
+    }
+
+if ($issueFiles.Count -eq 0) {
+    Write-Host "No issue files found in $IssueDir/" -ForegroundColor Yellow
+    exit 0
+}
+
+Write-Host "Found $($issueFiles.Count) issue files" -ForegroundColor Gray
+
+# ============ FILTER TO CHANGED FILES ONLY ============
+$changedFiles = @()
+$skippedFiles = @()
+
+foreach ($file in $issueFiles) {
+    if (Test-FileChanged -FilePath $file.FullName) {
+        $changedFiles += $file
+    } else {
+        $skippedFiles += $file
+    }
+}
+
+if ($skippedFiles.Count -gt 0 -and -not $Force) {
+    Write-Host "Skipping $($skippedFiles.Count) unchanged files" -ForegroundColor DarkGray
+}
+
+if ($changedFiles.Count -eq 0) {
+    Write-Host "No files have changed since last sync. Use -Force to resync all." -ForegroundColor Yellow
+    exit 0
+}
+
+Write-Host "Processing $($changedFiles.Count) changed files..." -ForegroundColor Cyan
+Write-Host ""
+
+# ============ CACHE EXISTING ISSUES ============
+Write-Host "Fetching existing GitHub issues..." -ForegroundColor Gray
+$existingIssues = gh issue list --repo $REPO --state all --limit 500 --json number,title,state | ConvertFrom-Json
+$issueTitleMap = @{}
+$issueStateMap = @{}
+foreach ($issue in $existingIssues) {
+    $issueTitleMap[$issue.title] = $issue.number
+    $issueStateMap[$issue.title] = $issue.state
+}
+Write-Host "Found $($existingIssues.Count) existing issues on GitHub" -ForegroundColor Gray
+Write-Host ""
+
+# ============ HELPER FUNCTIONS ============
+
+function Ensure-Label {
+    param($LabelName)
+    if (-not $DryRun) {
+        $ErrorActionPreference = "SilentlyContinue"
+        gh label create "$LabelName" --repo $REPO --color "0e8a16" 2>$null
+        $ErrorActionPreference = "Continue"
+    }
+}
+
+function Add-ToProject {
+    param([int]$IssueNumber)
+    
+    if (-not $SyncDates -or $DryRun) { return }
+
+    try {
+        $url = "https://github.com/$REPO/issues/$IssueNumber"
+        gh project item-add $ProjectNumber --owner $ProjectOwner --url $url 2>$null
+    } catch { }
+}
+
+function Sync-ProjectDates {
+    param([int]$IssueNumber, [string]$StartDate, [string]$TargetDate)
+    
+    if (-not $SyncDates) { return }
+    
+    Add-ToProject -IssueNumber $IssueNumber
+    
+    $itemsJson = gh project item-list $ProjectNumber --owner $ProjectOwner --format json 2>$null
+    if (-not $itemsJson) { return }
+    
+    $items = $itemsJson | ConvertFrom-Json
+    $item = $items.items | Where-Object { $_.content.number -eq $IssueNumber } | Select-Object -First 1
+    
+    if (-not $item) { return }
+    
+    if (-not $DryRun) {
+        gh project item-edit --id $item.id --project-id $ProjectId --field-id $StartDateFieldId --date $StartDate 2>$null
+        gh project item-edit --id $item.id --project-id $ProjectId --field-id $TargetDateFieldId --date $TargetDate 2>$null
+        Write-Host "    Dates: $StartDate -> $TargetDate" -ForegroundColor Blue
+    }
+}
+
+function Parse-IssueMetadata {
+    param($Content)
+    
+    $result = @{ title = $null; labels = @() }
+    
+    # Try YAML frontmatter
+    if ($Content -match '^---\s*[\r\n]+([\s\S]*?)[\r\n]+---') {
+        $yaml = $matches[1]
+        if ($yaml -match 'title:\s*["\u0027]?([^"\u0027\r\n]+)["\u0027]?') {
+            $result.title = $matches[1].Trim()
+        }
+        if ($yaml -match 'labels:\s*([^\r\n]+)') {
+            $result.labels = ($matches[1].Trim() -split ',') | ForEach-Object { $_.Trim() } | Where-Object { $_ }
+        }
+    }
+    
+    # Try Bold markdown
+    if (-not $result.title -and $Content -match '\*\*Title:\*\*\s*(.+)') {
+        $result.title = $matches[1].Trim()
+    }
+    if ($result.labels.Count -eq 0 -and $Content -match '\*\*Labels:\*\*\s*(.+)') {
+        $result.labels = ($matches[1] -replace '`', '' -replace '\s', '' -split ',') | Where-Object { $_ }
+    }
+    
+    # Try Markdown headers
+    if (-not $result.title -and $Content -match '## Title\s*[\r\n]+(.+)') {
+        $result.title = $matches[1].Trim()
+    }
+    if ($result.labels.Count -eq 0 -and $Content -match '## Labels\s*[\r\n]+(.+)') {
+        $result.labels = ($matches[1] -replace '`', '' -replace '\s', '' -split ',') | Where-Object { $_ }
+    }
+    
+    return $result
+}
+
+function Get-CheckboxStatus {
+    param($Content)
+    
+    $unchecked = [regex]::Matches($Content, '[-*]\s*\[\s*\]').Count
+    $checked = [regex]::Matches($Content, '[-*]\s*\[[xX]\]').Count
+    
+    return @{
+        Total = $unchecked + $checked
+        Checked = $checked
+        AllComplete = (($unchecked + $checked) -gt 0 -and $unchecked -eq 0)
+    }
+}
+
+function Move-ToClosedFolder {
+    param([string]$FilePath)
+    
+    if (-not $AutoArchive) { return }
+    
+    if (-not (Test-Path $closedDir)) {
+        if (-not $DryRun) {
+            New-Item -ItemType Directory -Path $closedDir -Force | Out-Null
+        }
+    }
+    
+    $fileName = Split-Path $FilePath -Leaf
+    $destPath = Join-Path $closedDir $fileName
+    
+    if (-not $DryRun) {
+        Move-Item -Path $FilePath -Destination $destPath -Force
+        # Remove from state since it's archived
+        $syncState.Remove($fileName)
+        Write-Host "    Archived to closed/$fileName" -ForegroundColor DarkMagenta
+    } else {
+        Write-Host "    [DryRun] Would archive to closed/$fileName" -ForegroundColor Gray
+    }
+}
+
+function Get-CleanIssueBody {
+    param($Content)
+    
+    $clean = $Content -replace '(?ms)^---\s*[\r\n]+.*?[\r\n]+---\s*[\r\n]*', ''
+    $clean = $clean -replace '(?ms)^## Title.*?(?=##|\Z)', ''
+    $clean = $clean -replace '(?ms)^## Labels.*?(?=##|\Z)', ''
+    $clean = $clean -replace '(?ms)^# GitHub Issue:.*?(?=##|\Z)', ''
+    return $clean.Trim()
+}
+
+# ============ MAIN LOOP ============
+
+$processedCount = 0
+$archivedCount = 0
+
+foreach ($file in $changedFiles) {
+    $content = Get-Content $file.FullName -Raw
+    $parsed = Parse-IssueMetadata -Content $content
+    
+    if (-not $parsed.title) {
+        Write-Warning "Could not find title for $($file.Name) - skipping"
+        continue
+    }
+
+    $title = $parsed.title
+    # Sanitize title: replace double quotes with single quotes to avoid CLI issues
+    $title = $title -replace '"', "'"
+    $labelArray = $parsed.labels
+    $checkboxStatus = Get-CheckboxStatus -Content $content
+    $isComplete = $checkboxStatus.AllComplete
+    
+    # Calculate dates
+    $fileInfo = Get-Item $file.FullName
+    $startDate = $fileInfo.CreationTime.ToString("yyyy-MM-dd")
+    $targetDate = if ($isComplete) {
+        $fileInfo.LastWriteTime.ToString("yyyy-MM-dd")
+    } else {
+        $fileInfo.CreationTime.AddDays($TargetWeeks * 7).ToString("yyyy-MM-dd")
+    }
+    
+    Write-Host "Processing: $($file.Name)" -ForegroundColor Cyan
+    Write-Host "  Title: $title"
+    if ($checkboxStatus.Total -gt 0) {
+        $color = if ($isComplete) { "Green" } else { "Yellow" }
+        Write-Host "  Checkboxes: $($checkboxStatus.Checked)/$($checkboxStatus.Total)" -ForegroundColor $color
+    }
+
+    $cleanBody = Get-CleanIssueBody -Content $content
+    $tempBodyFile = [System.IO.Path]::GetTempFileName()
+    Set-Content -Path $tempBodyFile -Value $cleanBody -Encoding UTF8
+
+    try {
+        $existingNumber = $issueTitleMap[$title]
+        $currentState = $issueStateMap[$title]
+        
+        if ($existingNumber) {
+            if ($Update) {
+                Write-Host "  Existing: #$existingNumber ($currentState) - UPDATING" -ForegroundColor Yellow
+                
+                foreach ($l in $labelArray) {
+                    if (![string]::IsNullOrWhiteSpace($l)) { Ensure-Label -LabelName $l }
+                }
+                
+                if (-not $DryRun) {
+                    $ghArgs = @("issue", "edit", "$existingNumber", "--repo", "$REPO", "--title", "$title", "--body-file", "$tempBodyFile")
+                    foreach ($l in $labelArray) {
+                        if (![string]::IsNullOrWhiteSpace($l)) {
+                            $ghArgs += "--add-label"; $ghArgs += "$l"
+                        }
+                    }
+                    & gh $ghArgs
+                    
+                    # Close if complete and currently open
+                    if ($isComplete -and $currentState -eq "OPEN") {
+                        gh issue close $existingNumber --repo $REPO --comment "✅ All acceptance criteria completed"
+                        Write-Host "  Closed #$existingNumber" -ForegroundColor Magenta
+                    }
+                    
+                    Write-Host "  Updated #$existingNumber" -ForegroundColor Green
+                    Sync-ProjectDates -IssueNumber $existingNumber -StartDate $startDate -TargetDate $targetDate
+                    Update-FileState -FilePath $file.FullName -Status "synced" -IssueNumber $existingNumber
+                    $processedCount++
+                    
+                    # Archive if complete (whether just closed or already closed)
+                    if ($isComplete) {
+                        Move-ToClosedFolder -FilePath $file.FullName
+                        $archivedCount++
+                    }
+                } else {
+                    Write-Host "  [DryRun] Would update #$existingNumber" -ForegroundColor Gray
+                    if ($isComplete) {
+                        if ($currentState -eq "OPEN") {
+                            Write-Host "  [DryRun] Would CLOSE" -ForegroundColor Magenta
+                        }
+                        Write-Host "  [DryRun] Would ARCHIVE" -ForegroundColor DarkMagenta
+                    }
+                }
+            } else {
+                Write-Host "  Existing: #$existingNumber - SKIPPING (use -Update)" -ForegroundColor DarkGray
+            }
+        } else {
+            Write-Host "  New issue - CREATING" -ForegroundColor Green
+            
+            foreach ($l in $labelArray) {
+                if (![string]::IsNullOrWhiteSpace($l)) { Ensure-Label -LabelName $l }
+            }
+
+            if (-not $DryRun) {
+                $ghArgs = @("issue", "create", "--repo", "$REPO", "--title", "$title", "--body-file", "$tempBodyFile")
+                foreach ($l in $labelArray) {
+                    if (![string]::IsNullOrWhiteSpace($l)) {
+                        $ghArgs += "--label"; $ghArgs += "$l"
+                    }
+                }
+                $issueUrl = & gh $ghArgs
+                
+                if ($issueUrl -match '/issues/(\d+)$') {
+                    $newNum = [int]$matches[1]
+                    Write-Host "  Created #$newNum" -ForegroundColor Green
+                    Sync-ProjectDates -IssueNumber $newNum -StartDate $startDate -TargetDate $targetDate
+                    Update-FileState -FilePath $file.FullName -Status "synced" -IssueNumber $newNum
+                    $processedCount++
+                }
+            } else {
+                Write-Host "  [DryRun] Would create issue" -ForegroundColor Gray
+            }
+        }
+    } finally {
+        if (Test-Path $tempBodyFile) { Remove-Item $tempBodyFile -Force }
+    }
+    Write-Host "-------------------"
+}
+
+# Save state file
+Save-SyncState
+
+Write-Host ""
+Write-Host "Done!" -ForegroundColor Green
+Write-Host "  Processed: $processedCount issues"
+if ($archivedCount -gt 0) {
+    Write-Host "  Archived: $archivedCount completed issues" -ForegroundColor Magenta
+}
+if ($skippedFiles.Count -gt 0 -and -not $Force) {
+    Write-Host "  Skipped: $($skippedFiles.Count) unchanged files" -ForegroundColor DarkGray
+}

package/assets/.agent/skills/github-ops/scripts/smart-ops.ps1

@@ -0,0 +1,128 @@
+# Smart Ops - GitHub Automation Script (PowerShell)
+# Copy to: scripts/smart-ops.ps1
+# Replace {{PLACEHOLDERS}} with actual values
+
+$ErrorActionPreference = "Stop"
+
+# ============ CONFIGURATION ============
+$REPO_OWNER = "{{OWNER}}"
+$REPO_NAME = "{{REPO}}"
+$REPO = "$REPO_OWNER/$REPO_NAME"
+
+# GitHub Projects (optional - leave empty if not using)
+$PROJECT_NUMBER = "{{PROJECT_NUMBER}}"
+$PROJECT_ID = "{{PROJECT_ID}}"
+$STATUS_FIELD_ID = "{{STATUS_FIELD_ID}}"
+$TODO_OPTION_ID = "{{TODO_OPTION_ID}}"
+$IN_PROGRESS_OPTION_ID = "{{IN_PROGRESS_OPTION_ID}}"
+$DONE_OPTION_ID = "{{DONE_OPTION_ID}}"
+$START_DATE_FIELD_ID = "{{START_DATE_FIELD_ID}}"
+$TARGET_DATE_FIELD_ID = "{{TARGET_DATE_FIELD_ID}}"
+
+$DEBUG = $env:DEBUG -eq "1"
+
+# ============ HELPERS ============
+
+function Test-Prerequisites {
+    $errors = 0
+    try { $null = Get-Command gh -ErrorAction Stop } catch {
+        Write-Host "X GitHub CLI not installed" -ForegroundColor Red
+        $errors++
+    }
+    try { $null = gh auth status 2>&1; if ($LASTEXITCODE -ne 0) { throw } } catch {
+        Write-Host "X Not authenticated. Run: gh auth login" -ForegroundColor Red
+        $errors++
+    }
+    if ($errors -gt 0) { exit 1 }
+}
+
+function Get-Today { return (Get-Date -Format "yyyy-MM-dd") }
+function Get-FutureDate { param([int]$Days = 7); return (Get-Date).AddDays($Days).ToString("yyyy-MM-dd") }
+
+# ============ COMMANDS ============
+
+function Start-Scan {
+    Write-Host "Scanning open issues..." -ForegroundColor Cyan
+    gh issue list --repo $REPO --state open --json number,title,labels --limit 20
+}
+
+function Complete-Scan {
+    Write-Host "Issues ready for completion..." -ForegroundColor Cyan
+    gh issue list --repo $REPO --state open --json number,title --limit 20
+    Write-Host "`nToday: $(Get-Today)"
+    Write-Host 'Close with: .\smart-ops.ps1 close [number]' -ForegroundColor Gray
+}
+
+function New-Issue {
+    param([string]$Title, [string]$Body = "", [string]$Labels = "enhancement", [int]$Days = 7)
+    if ([string]::IsNullOrWhiteSpace($Title)) { Write-Host "X Title required" -ForegroundColor Red; return }
+    
+    Write-Host "Creating: $Title (${Days}d)" -ForegroundColor Cyan
+    $url = gh issue create --repo $REPO --title $Title --body $Body --label $Labels
+    
+    if ($url -match '/(\d+)$') {
+        Write-Host "Created #$($Matches[1])" -ForegroundColor Green
+        Write-Host $url
+    }
+}
+
+function Close-Issue {
+    param([string]$Num, [string]$Comment = "Completed")
+    if ([string]::IsNullOrWhiteSpace($Num)) { Write-Host "X Issue number required" -ForegroundColor Red; return }
+    
+    $confirm = Read-Host "Close #${Num}? (y/N)"
+    if ($confirm -ne 'y') { return }
+    
+    gh issue close $Num --repo $REPO --comment $Comment
+    Write-Host "Closed #$Num" -ForegroundColor Green
+}
+
+function Move-ToProgress {
+    param([string]$Id)
+    if ([string]::IsNullOrWhiteSpace($PROJECT_ID)) { Write-Host "X No project configured" -ForegroundColor Red; return }
+    gh project item-edit --id $Id --field-id $STATUS_FIELD_ID --project-id $PROJECT_ID --single-select-option-id $IN_PROGRESS_OPTION_ID
+    Write-Host "-> In Progress" -ForegroundColor Green
+}
+
+function Move-ToDone {
+    param([string]$Id)
+    if ([string]::IsNullOrWhiteSpace($PROJECT_ID)) { Write-Host "X No project configured" -ForegroundColor Red; return }
+    gh project item-edit --id $Id --field-id $STATUS_FIELD_ID --project-id $PROJECT_ID --single-select-option-id $DONE_OPTION_ID
+    Write-Host "-> Done" -ForegroundColor Green
+}
+
+function Show-Help {
+    Write-Host @'
+Smart Ops - GitHub Automation
+
+Usage: .\smart-ops.ps1 [command] [args]
+
+Commands:
+  start                      List open issues
+  complete                   List for completion
+  create [title] [body] [labels] [days]
+  close [number] [comment]
+  progress [item_id]         Move to In Progress
+  done [item_id]             Move to Done
+
+Examples:
+  .\smart-ops.ps1 create "Fix bug" "Description" "bug" 3
+  .\smart-ops.ps1 close 42 "Fixed"
+'@ -ForegroundColor Cyan
+}
+
+# ============ MAIN ============
+
+Test-Prerequisites
+
+$cmd = if ($args.Count -gt 0) { $args[0] } else { "help" }
+
+switch ($cmd.ToLower()) {
+    "start" { Start-Scan }
+    "complete" { Complete-Scan }
+    "create" { New-Issue -Title $args[1] -Body $args[2] -Labels $args[3] -Days ([int]$args[4]) }
+    "close" { Close-Issue -Num $args[1] -Comment $args[2] }
+    "progress" { Move-ToProgress -Id $args[1] }
+    "done" { Move-ToDone -Id $args[1] }
+    default { Show-Help }
+}

package/assets/.agent/skills/github-ops/scripts/smart-ops.sh

@@ -0,0 +1,130 @@
+#!/bin/bash
+# Smart Ops - GitHub Automation Script (Bash)
+# Copy to: scripts/smart-ops.sh
+# Replace {{PLACEHOLDERS}} with actual values
+
+set -e
+
+# ============ CONFIGURATION ============
+REPO_OWNER="{{OWNER}}"
+REPO_NAME="{{REPO}}"
+REPO="${REPO_OWNER}/${REPO_NAME}"
+
+# GitHub Projects (optional - leave empty if not using)
+PROJECT_NUMBER="{{PROJECT_NUMBER}}"
+PROJECT_ID="{{PROJECT_ID}}"
+STATUS_FIELD_ID="{{STATUS_FIELD_ID}}"
+TODO_OPTION_ID="{{TODO_OPTION_ID}}"
+IN_PROGRESS_OPTION_ID="{{IN_PROGRESS_OPTION_ID}}"
+DONE_OPTION_ID="{{DONE_OPTION_ID}}"
+START_DATE_FIELD_ID="{{START_DATE_FIELD_ID}}"
+TARGET_DATE_FIELD_ID="{{TARGET_DATE_FIELD_ID}}"
+
+DEBUG="${DEBUG:-0}"
+
+# ============ HELPERS ============
+
+check_prerequisites() {
+    local errors=0
+    command -v gh &> /dev/null || { echo "❌ GitHub CLI not installed"; errors=$((errors + 1)); }
+    gh auth status &> /dev/null || { echo "❌ Not authenticated. Run: gh auth login"; errors=$((errors + 1)); }
+    [ "$errors" -gt 0 ] && exit 1
+}
+
+get_today() { date +%Y-%m-%d; }
+get_future_date() {
+    local days="${1:-7}"
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        date -v+${days}d +%Y-%m-%d
+    else
+        date -d "+${days} days" +%Y-%m-%d
+    fi
+}
+
+# ============ COMMANDS ============
+
+start_scan() {
+    echo "🔍 Scanning open issues..."
+    gh issue list --repo "$REPO" --state open --json number,title,labels --limit 20
+}
+
+complete_scan() {
+    echo "📋 Issues ready for completion..."
+    gh issue list --repo "$REPO" --state open --json number,title --limit 20
+    echo ""
+    echo "Today: $(get_today)"
+    echo "Close with: ./smart-ops.sh close <number>"
+}
+
+create_issue() {
+    local title="$1"
+    local body="$2"
+    local labels="${3:-enhancement}"
+    local days="${4:-7}"
+    
+    [ -z "$title" ] && { echo "❌ Title required"; return 1; }
+    
+    echo "📝 Creating: $title (${days}d)"
+    gh issue create --repo "$REPO" --title "$title" --body "$body" --label "$labels"
+}
+
+close_issue() {
+    local num="$1"
+    local comment="${2:-Completed}"
+    
+    [ -z "$num" ] && { echo "❌ Issue number required"; return 1; }
+    
+    read -p "Close #$num? (y/N): " -n 1 -r; echo
+    [[ ! $REPLY =~ ^[Yy]$ ]] && return 0
+    
+    gh issue close "$num" --repo "$REPO" --comment "$comment"
+    echo "✅ Closed #$num"
+}
+
+move_to_progress() {
+    local id="$1"
+    [ -z "$PROJECT_ID" ] && { echo "❌ No project configured"; return 1; }
+    gh project item-edit --id "$id" --field-id "$STATUS_FIELD_ID" --project-id "$PROJECT_ID" --single-select-option-id "$IN_PROGRESS_OPTION_ID"
+    echo "✅ → In Progress"
+}
+
+move_to_done() {
+    local id="$1"
+    [ -z "$PROJECT_ID" ] && { echo "❌ No project configured"; return 1; }
+    gh project item-edit --id "$id" --field-id "$STATUS_FIELD_ID" --project-id "$PROJECT_ID" --single-select-option-id "$DONE_OPTION_ID"
+    echo "✅ → Done"
+}
+
+show_help() {
+    cat << 'EOF'
+Smart Ops - GitHub Automation
+
+Usage: ./smart-ops.sh <command> [args]
+
+Commands:
+  start                      List open issues
+  complete                   List for completion
+  create <title> [body] [labels] [days]
+  close <number> [comment]
+  progress <item_id>         Move to In Progress
+  done <item_id>             Move to Done
+
+Examples:
+  ./smart-ops.sh create "Fix bug" "Description" "bug" 3
+  ./smart-ops.sh close 42 "Fixed"
+EOF
+}
+
+# ============ MAIN ============
+
+check_prerequisites
+
+case "${1:-help}" in
+    start) start_scan ;;
+    complete) complete_scan ;;
+    create) create_issue "$2" "$3" "$4" "$5" ;;
+    close) close_issue "$2" "$3" ;;
+    progress) move_to_progress "$2" ;;
+    done) move_to_done "$2" ;;
+    *) show_help ;;
+esac