@fro.bot/systematic 1.18.7 → 1.19.0

package/skills/rclone/SKILL.md

@@ -0,0 +1,151 @@
+---
+name: rclone
+description: Upload, sync, and manage files across cloud storage providers using rclone. Use when uploading files (images, videos, documents) to S3, Cloudflare R2, Backblaze B2, Google Drive, Dropbox, or any S3-compatible storage. Triggers on "upload to S3", "sync to cloud", "rclone", "backup files", "upload video/image to bucket", or requests to transfer files to remote storage.
+---
+
+# rclone File Transfer Skill
+
+## Setup Check (Always Run First)
+
+Before any rclone operation, verify installation and configuration:
+
+```bash
+# Check if rclone is installed
+command -v rclone >/dev/null 2>&1 && echo "rclone installed: $(rclone version | head -1)" || echo "NOT INSTALLED"
+
+# List configured remotes
+rclone listremotes 2>/dev/null || echo "NO REMOTES CONFIGURED"
+```
+
+### If rclone is NOT installed
+
+Guide the user to install:
+
+```bash
+# macOS
+brew install rclone
+
+# Linux (script install)
+curl https://rclone.org/install.sh | sudo bash
+
+# Or via package manager
+sudo apt install rclone  # Debian/Ubuntu
+sudo dnf install rclone  # Fedora
+```
+
+### If NO remotes are configured
+
+Walk the user through interactive configuration:
+
+```bash
+rclone config
+```
+
+**Common provider setup quick reference:**
+
+| Provider | Type | Key Settings |
+|----------|------|--------------|
+| AWS S3 | `s3` | access_key_id, secret_access_key, region |
+| Cloudflare R2 | `s3` | access_key_id, secret_access_key, endpoint (account_id.r2.cloudflarestorage.com) |
+| Backblaze B2 | `b2` | account (keyID), key (applicationKey) |
+| DigitalOcean Spaces | `s3` | access_key_id, secret_access_key, endpoint (region.digitaloceanspaces.com) |
+| Google Drive | `drive` | OAuth flow (opens browser) |
+| Dropbox | `dropbox` | OAuth flow (opens browser) |
+
+**Example: Configure Cloudflare R2**
+```bash
+rclone config create r2 s3 \
+  provider=Cloudflare \
+  access_key_id=YOUR_ACCESS_KEY \
+  secret_access_key=YOUR_SECRET_KEY \
+  endpoint=ACCOUNT_ID.r2.cloudflarestorage.com \
+  acl=private
+```
+
+**Example: Configure AWS S3**
+```bash
+rclone config create aws s3 \
+  provider=AWS \
+  access_key_id=YOUR_ACCESS_KEY \
+  secret_access_key=YOUR_SECRET_KEY \
+  region=us-east-1
+```
+
+## Common Operations
+
+### Upload single file
+```bash
+rclone copy /path/to/file.mp4 remote:bucket/path/ --progress
+```
+
+### Upload directory
+```bash
+rclone copy /path/to/folder remote:bucket/folder/ --progress
+```
+
+### Sync directory (mirror, deletes removed files)
+```bash
+rclone sync /local/path remote:bucket/path/ --progress
+```
+
+### List remote contents
+```bash
+rclone ls remote:bucket/
+rclone lsd remote:bucket/  # directories only
+```
+
+### Check what would be transferred (dry run)
+```bash
+rclone copy /path remote:bucket/ --dry-run
+```
+
+## Useful Flags
+
+| Flag | Purpose |
+|------|---------|
+| `--progress` | Show transfer progress |
+| `--dry-run` | Preview without transferring |
+| `-v` | Verbose output |
+| `--transfers=N` | Parallel transfers (default 4) |
+| `--bwlimit=RATE` | Bandwidth limit (e.g., `10M`) |
+| `--checksum` | Compare by checksum, not size/time |
+| `--exclude="*.tmp"` | Exclude patterns |
+| `--include="*.mp4"` | Include only matching |
+| `--min-size=SIZE` | Skip files smaller than SIZE |
+| `--max-size=SIZE` | Skip files larger than SIZE |
+
+## Large File Uploads
+
+For videos and large files, use chunked uploads:
+
+```bash
+# S3 multipart upload (automatic for >200MB)
+rclone copy large_video.mp4 remote:bucket/ --s3-chunk-size=64M --progress
+
+# Resume interrupted transfers
+rclone copy /path remote:bucket/ --progress --retries=5
+```
+
+## Verify Upload
+
+```bash
+# Check file exists and matches
+rclone check /local/file remote:bucket/file
+
+# Get file info
+rclone lsl remote:bucket/path/to/file
+```
+
+## Troubleshooting
+
+```bash
+# Test connection
+rclone lsd remote:
+
+# Debug connection issues
+rclone lsd remote: -vv
+
+# Check config
+rclone config show remote
+```
+

package/skills/rclone/scripts/check_setup.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# rclone setup checker - verifies installation and configuration
+
+set -e
+
+echo "=== rclone Setup Check ==="
+echo
+
+# Check if rclone is installed
+if command -v rclone >/dev/null 2>&1; then
+    echo "✓ rclone installed"
+    rclone version | head -1
+    echo
+else
+    echo "✗ rclone NOT INSTALLED"
+    echo
+    echo "Install with:"
+    echo "  macOS:  brew install rclone"
+    echo "  Linux:  curl https://rclone.org/install.sh | sudo bash"
+    echo "          or: sudo apt install rclone"
+    exit 1
+fi
+
+# Check for configured remotes
+REMOTES=$(rclone listremotes 2>/dev/null || true)
+
+if [ -z "$REMOTES" ]; then
+    echo "✗ No remotes configured"
+    echo
+    echo "Run 'rclone config' to set up a remote, or use:"
+    echo
+    echo "  # Cloudflare R2"
+    echo "  rclone config create r2 s3 provider=Cloudflare \\"
+    echo "    access_key_id=KEY secret_access_key=SECRET \\"
+    echo "    endpoint=ACCOUNT_ID.r2.cloudflarestorage.com"
+    echo
+    echo "  # AWS S3"
+    echo "  rclone config create aws s3 provider=AWS \\"
+    echo "    access_key_id=KEY secret_access_key=SECRET region=us-east-1"
+    echo
+    exit 1
+else
+    echo "✓ Configured remotes:"
+    echo "$REMOTES" | sed 's/^/  /'
+    echo
+fi
+
+# Test connectivity for each remote
+echo "Testing remote connectivity..."
+for remote in $REMOTES; do
+    remote_name="${remote%:}"
+    if rclone lsd "$remote" >/dev/null 2>&1; then
+        echo "  ✓ $remote_name - connected"
+    else
+        echo "  ✗ $remote_name - connection failed (check credentials)"
+    fi
+done
+
+echo
+echo "=== Setup Complete ==="

package/skills/resolve-pr-parallel/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: resolve_pr_parallel
+description: Resolve all PR comments using parallel processing. Use when addressing PR review feedback, resolving review threads, or batch-fixing PR comments.
+argument-hint: '[optional: PR number or current PR]'
+disable-model-invocation: true
+allowed-tools: Bash(gh *), Bash(git *), Read
+---
+
+# Resolve PR Comments in Parallel
+
+Resolve all unresolved PR review comments by spawning parallel agents for each thread.
+
+## Context Detection
+
+OpenCode automatically detects git context:
+- Current branch and associated PR
+- All PR comments and review threads
+- Works with any PR by specifying the number
+
+## Workflow
+
+### 1. Analyze
+
+Fetch unresolved review threads using the GraphQL script:
+
+```bash
+bash ${OPENCODE_PLUGIN_ROOT}/skills/resolve-pr-parallel/scripts/get-pr-comments PR_NUMBER
+```
+
+This returns only **unresolved, non-outdated** threads with file paths, line numbers, and comment bodies.
+
+If the script fails, fall back to:
+```bash
+gh pr view PR_NUMBER --json reviews,comments
+gh api repos/{owner}/{repo}/pulls/PR_NUMBER/comments
+```
+
+### 2. Plan
+
+Create a todowrite list of all unresolved items grouped by type:
+- Code changes requested
+- Questions to answer
+- Style/convention fixes
+- Test additions needed
+
+### 3. Implement (PARALLEL)
+
+Spawn a `pr-comment-resolver` agent for each unresolved item in parallel.
+
+If there are 3 comments, spawn 3 agents:
+
+1. task pr-comment-resolver(comment1)
+2. task pr-comment-resolver(comment2)
+3. task pr-comment-resolver(comment3)
+
+Always run all in parallel subagents/Tasks for each Todo item.
+
+### 4. Commit & Resolve
+
+- Commit changes with a clear message referencing the PR feedback
+- Resolve each thread programmatically:
+
+```bash
+bash ${OPENCODE_PLUGIN_ROOT}/skills/resolve-pr-parallel/scripts/resolve-pr-thread THREAD_ID
+```
+
+- Push to remote
+
+### 5. Verify
+
+Re-fetch comments to confirm all threads are resolved:
+
+```bash
+bash ${OPENCODE_PLUGIN_ROOT}/skills/resolve-pr-parallel/scripts/get-pr-comments PR_NUMBER
+```
+
+Should return an empty array `[]`. If threads remain, repeat from step 1.
+
+## Scripts
+
+- [scripts/get-pr-comments](scripts/get-pr-comments) - GraphQL query for unresolved review threads
+- [scripts/resolve-pr-thread](scripts/resolve-pr-thread) - GraphQL mutation to resolve a thread by ID
+
+## Success Criteria
+
+- All unresolved review threads addressed
+- Changes committed and pushed
+- Threads resolved via GraphQL (marked as resolved on GitHub)
+- Empty result from get-pr-comments on verify
+

package/skills/resolve-pr-parallel/scripts/get-pr-comments

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+
+set -e
+
+if [ $# -lt 1 ]; then
+    echo "Usage: get-pr-comments PR_NUMBER [OWNER/REPO]"
+    echo "Example: get-pr-comments 123"
+    echo "Example: get-pr-comments 123 owner/repo"
+    exit 1
+fi
+
+PR_NUMBER=$1
+
+if [ -n "$2" ]; then
+    OWNER=$(echo "$2" | cut -d/ -f1)
+    REPO=$(echo "$2" | cut -d/ -f2)
+else
+    OWNER=$(gh repo view --json owner -q .owner.login 2>/dev/null)
+    REPO=$(gh repo view --json name -q .name 2>/dev/null)
+fi
+
+if [ -z "$OWNER" ] || [ -z "$REPO" ]; then
+    echo "Error: Could not detect repository. Pass OWNER/REPO as second argument."
+    exit 1
+fi
+
+gh api graphql -f owner="$OWNER" -f repo="$REPO" -F pr="$PR_NUMBER" -f query='
+query FetchUnresolvedComments($owner: String!, $repo: String!, $pr: Int!) {
+  repository(owner: $owner, name: $repo) {
+    pullRequest(number: $pr) {
+      title
+      url
+      reviewThreads(first: 100) {
+        totalCount
+        edges {
+          node {
+            id
+            isResolved
+            isOutdated
+            isCollapsed
+            path
+            line
+            startLine
+            diffSide
+            comments(first: 100) {
+              totalCount
+              nodes {
+                id
+                author {
+                  login
+                }
+                body
+                createdAt
+                updatedAt
+                url
+                outdated
+              }
+            }
+          }
+        }
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+      }
+    }
+  }
+}' | jq '.data.repository.pullRequest.reviewThreads.edges | map(select(.node.isResolved == false and .node.isOutdated == false))'

package/skills/resolve-pr-parallel/scripts/resolve-pr-thread

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+set -e
+
+if [ $# -eq 0 ]; then
+    echo "Usage: resolve-pr-thread THREAD_ID"
+    echo "Example: resolve-pr-thread PRRT_kwDOABC123"
+    exit 1
+fi
+
+THREAD_ID=$1
+
+gh api graphql -f threadId="$THREAD_ID" -f query='
+mutation ResolveReviewThread($threadId: ID!) {
+  resolveReviewThread(input: {threadId: $threadId}) {
+    thread {
+      id
+      isResolved
+      path
+      line
+    }
+  }
+}'

package/skills/setup/SKILL.md

@@ -0,0 +1,168 @@
+---
+name: setup
+description: Configure which review agents run for your project. Auto-detects stack and writes systematic.local.md.
+disable-model-invocation: true
+---
+
+# Systematic Setup
+
+Interactive setup for `systematic.local.md` — configures which agents run during `/workflows:review` and `/workflows:work`.
+
+## Step 1: Check Existing Config
+
+Read `systematic.local.md` in the project root. If it exists, display current settings summary and use question:
+
+```
+question: "Settings file already exists. What would you like to do?"
+header: "Config"
+options:
+  - label: "Reconfigure"
+    description: "Run the interactive setup again from scratch"
+  - label: "View current"
+    description: "Show the file contents, then stop"
+  - label: "Cancel"
+    description: "Keep current settings"
+```
+
+If "View current": read and display the file, then stop.
+If "Cancel": stop.
+
+## Step 2: Detect and Ask
+
+Auto-detect the project stack:
+
+```bash
+test -f Gemfile && test -f config/routes.rb && echo "rails" || \
+test -f Gemfile && echo "ruby" || \
+test -f tsconfig.json && echo "typescript" || \
+test -f package.json && echo "javascript" || \
+test -f pyproject.toml && echo "python" || \
+test -f requirements.txt && echo "python" || \
+echo "general"
+```
+
+Use question:
+
+```
+question: "Detected {type} project. How would you like to configure?"
+header: "Setup"
+options:
+  - label: "Auto-configure (Recommended)"
+    description: "Use smart defaults for {type}. Done in one click."
+  - label: "Customize"
+    description: "Choose stack, focus areas, and review depth."
+```
+
+### If Auto-configure → Skip to Step 4 with defaults
+
+- **Rails:** `[kieran-rails-reviewer, dhh-rails-reviewer, code-simplicity-reviewer, security-sentinel, performance-oracle]`
+- **Python:** `[kieran-python-reviewer, code-simplicity-reviewer, security-sentinel, performance-oracle]`
+- **TypeScript:** `[kieran-typescript-reviewer, code-simplicity-reviewer, security-sentinel, performance-oracle]`
+- **General:** `[code-simplicity-reviewer, security-sentinel, performance-oracle, architecture-strategist]`
+
+### If Customize → Step 3
+
+## Step 3: Customize (3 questions)
+
+**a. Stack** — confirm or override:
+
+```
+question: "Which stack should we optimize for?"
+header: "Stack"
+options:
+  - label: "{detected_type} (Recommended)"
+    description: "Auto-detected from project files"
+  - label: "Rails"
+    description: "Ruby on Rails — adds DHH-style and Rails-specific reviewers"
+  - label: "Python"
+    description: "Python — adds Pythonic pattern reviewer"
+  - label: "TypeScript"
+    description: "TypeScript — adds type safety reviewer"
+```
+
+Only show options that differ from the detected type.
+
+**b. Focus areas** — multiSelect:
+
+```
+question: "Which review areas matter most?"
+header: "Focus"
+multiSelect: true
+options:
+  - label: "Security"
+    description: "Vulnerability scanning, auth, input validation (security-sentinel)"
+  - label: "Performance"
+    description: "N+1 queries, memory leaks, complexity (performance-oracle)"
+  - label: "Architecture"
+    description: "Design patterns, SOLID, separation of concerns (architecture-strategist)"
+  - label: "Code simplicity"
+    description: "Over-engineering, YAGNI violations (code-simplicity-reviewer)"
+```
+
+**c. Depth:**
+
+```
+question: "How thorough should reviews be?"
+header: "Depth"
+options:
+  - label: "Thorough (Recommended)"
+    description: "Stack reviewers + all selected focus agents."
+  - label: "Fast"
+    description: "Stack reviewers + code simplicity only. Less context, quicker."
+  - label: "Comprehensive"
+    description: "All above + git history, data integrity, agent-native checks."
+```
+
+## Step 4: Build Agent List and Write File
+
+**Stack-specific agents:**
+- Rails → `kieran-rails-reviewer, dhh-rails-reviewer`
+- Python → `kieran-python-reviewer`
+- TypeScript → `kieran-typescript-reviewer`
+- General → (none)
+
+**Focus area agents:**
+- Security → `security-sentinel`
+- Performance → `performance-oracle`
+- Architecture → `architecture-strategist`
+- Code simplicity → `code-simplicity-reviewer`
+
+**Depth:**
+- Thorough: stack + selected focus areas
+- Fast: stack + `code-simplicity-reviewer` only
+- Comprehensive: all above + `git-history-analyzer, data-integrity-guardian, agent-native-reviewer`
+
+**Plan review agents:** stack-specific reviewer + `code-simplicity-reviewer`.
+
+Write `systematic.local.md`:
+
+```markdown
+---
+review_agents: [{computed agent list}]
+plan_review_agents: [{computed plan agent list}]
+---
+
+# Review Context
+
+Add project-specific review instructions here.
+These notes are passed to all review agents during /workflows:review and /workflows:work.
+
+Examples:
+- "We use Turbo Frames heavily — check for frame-busting issues"
+- "Our API is public — extra scrutiny on input validation"
+- "Performance-critical: we serve 10k req/s on this endpoint"
+```
+
+## Step 5: Confirm
+
+```
+Saved to systematic.local.md
+
+Stack:        {type}
+Review depth: {depth}
+Agents:       {count} configured
+              {agent list, one per line}
+
+Tip: Edit the "Review Context" section to add project-specific instructions.
+     Re-run this setup anytime to reconfigure.
+```