Query and export sync audit logs. Filter by date range, platform (github/jira/ado), and result (success/denied/error). Export to JSON, CSV, or JSONL.
Query and export sync audit logs with filters for date range, platform (github/jira/ado), and result (success/denied/error). Use this to investigate sync issues, audit permissions, or export logs for analysis.
/plugin marketplace add anton-abyzov/specweave/plugin install sw@specweaveQuery and export sync audit logs. Supports date range, platform, and result filtering.
/sw:sync-logs # Last 24 hours
/sw:sync-logs --since "2025-12-01" # Since specific date
/sw:sync-logs --platform github # Filter by platform
/sw:sync-logs --result denied # Filter by result
/sw:sync-logs --export logs.json # Export to file
--since <date>: Start date (ISO 8601 or YYYY-MM-DD)--until <date>: End date (ISO 8601 or YYYY-MM-DD)--platform <name>: Filter by platform: github, jira, ado--operation <type>: Filter by operation type--result <result>: Filter by result: success, denied, error--limit <n>: Maximum entries to return (default: 100)--export <path>: Export to file (JSON, JSONL, or CSV based on extension)--json: Output as JSON to stdout/sw:sync-logs
Output:
š SYNC LOGS (last 24 hours)
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
2025-12-01 12:00:05 github upsert-internal FS-001 ā
success 150ms
2025-12-01 12:00:04 jira update-status US-001 ā
success 200ms
2025-12-01 12:00:03 github upsert-external EXT-001 š« denied -
2025-12-01 12:00:02 ado read WI-001 ā error -
2025-12-01 12:00:01 github upsert-internal FS-002 ā
success 100ms
Showing 5 of 57 entries
Use --limit to show more, --export to save all
/sw:sync-logs --platform github
/sw:sync-logs --result denied
Shows only denied operations (permission enforcement in action):
š SYNC LOGS (denied only)
āāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāāā
2025-12-01 12:00:03 github upsert-external EXT-001 š« denied
Reason: External updates disabled in config
2025-12-01 11:45:00 jira delete JIRA-123 š« denied
Reason: Delete operations not permitted
/sw:sync-logs --since "2025-12-01" --until "2025-12-02"
# Export to JSON
/sw:sync-logs --export logs.json
# Export to CSV (for spreadsheets)
/sw:sync-logs --export logs.csv
# Export to JSONL (for processing)
/sw:sync-logs --export logs.jsonl
Tabular format with timestamps, platforms, operations, items, results, and durations.
--json or .json export){
"metadata": {
"exportedAt": "2025-12-01T12:00:00Z",
"total": 57,
"hasMore": false,
"query": { "limit": 100 }
},
"entries": [
{
"timestamp": "2025-12-01T12:00:05Z",
"platform": "github",
"operation": "upsert-internal",
"itemId": "FS-001",
"result": "success",
"durationMs": 150
}
]
}
.csv export)timestamp,platform,operation,itemId,result,reason,error,durationMs
2025-12-01T12:00:05Z,github,upsert-internal,FS-001,success,,,150
/sw:sync-monitor: Dashboard with activity summary/sw:notifications: View sync failure notifications