aidevops 2.52.1 → 2.53.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (334) hide show
  1. package/README.md +1 -1
  2. package/VERSION +1 -1
  3. package/aidevops.sh +15 -9
  4. package/package.json +4 -4
  5. package/scripts/npm-postinstall.js +6 -7
  6. package/setup.sh +1 -1
  7. package/templates/deploy-templates.sh +144 -0
  8. package/templates/home/.agent/README.md +33 -0
  9. package/templates/home/AGENTS.md +96 -0
  10. package/templates/home/git/.agent/README.md +48 -0
  11. package/templates/home/git/AGENTS.md +97 -0
  12. package/templates/standard-functions.sh +179 -0
  13. package/templates/wordpress-performance-workflow.md +217 -0
  14. package/.agent/AGENTS.md +0 -614
  15. package/.agent/accounts.md +0 -65
  16. package/.agent/aidevops/add-new-mcp-to-aidevops.md +0 -456
  17. package/.agent/aidevops/api-integrations.md +0 -335
  18. package/.agent/aidevops/architecture.md +0 -510
  19. package/.agent/aidevops/configs.md +0 -274
  20. package/.agent/aidevops/docs.md +0 -244
  21. package/.agent/aidevops/extension.md +0 -311
  22. package/.agent/aidevops/mcp-integrations.md +0 -340
  23. package/.agent/aidevops/mcp-troubleshooting.md +0 -162
  24. package/.agent/aidevops/memory-patterns.md +0 -172
  25. package/.agent/aidevops/providers.md +0 -217
  26. package/.agent/aidevops/recommendations.md +0 -321
  27. package/.agent/aidevops/requirements.md +0 -301
  28. package/.agent/aidevops/resources.md +0 -214
  29. package/.agent/aidevops/security-requirements.md +0 -174
  30. package/.agent/aidevops/security.md +0 -350
  31. package/.agent/aidevops/service-links.md +0 -400
  32. package/.agent/aidevops/services.md +0 -357
  33. package/.agent/aidevops/setup.md +0 -153
  34. package/.agent/aidevops/troubleshooting.md +0 -389
  35. package/.agent/aidevops.md +0 -124
  36. package/.agent/build-plus.md +0 -244
  37. package/.agent/content/guidelines.md +0 -109
  38. package/.agent/content.md +0 -87
  39. package/.agent/health.md +0 -59
  40. package/.agent/legal.md +0 -59
  41. package/.agent/loop-state/full-loop.local.md +0 -16
  42. package/.agent/loop-state/ralph-loop.local.md +0 -10
  43. package/.agent/marketing.md +0 -440
  44. package/.agent/memory/README.md +0 -260
  45. package/.agent/onboarding.md +0 -796
  46. package/.agent/plan-plus.md +0 -245
  47. package/.agent/research.md +0 -100
  48. package/.agent/sales.md +0 -333
  49. package/.agent/scripts/101domains-helper.sh +0 -701
  50. package/.agent/scripts/add-missing-returns.sh +0 -140
  51. package/.agent/scripts/agent-browser-helper.sh +0 -311
  52. package/.agent/scripts/agno-setup.sh +0 -712
  53. package/.agent/scripts/ahrefs-mcp-wrapper.js +0 -168
  54. package/.agent/scripts/aidevops-update-check.sh +0 -71
  55. package/.agent/scripts/ampcode-cli.sh +0 -522
  56. package/.agent/scripts/auto-version-bump.sh +0 -156
  57. package/.agent/scripts/autogen-helper.sh +0 -512
  58. package/.agent/scripts/beads-sync-helper.sh +0 -596
  59. package/.agent/scripts/closte-helper.sh +0 -5
  60. package/.agent/scripts/cloudron-helper.sh +0 -321
  61. package/.agent/scripts/codacy-cli-chunked.sh +0 -581
  62. package/.agent/scripts/codacy-cli.sh +0 -442
  63. package/.agent/scripts/code-audit-helper.sh +0 -5
  64. package/.agent/scripts/coderabbit-cli.sh +0 -417
  65. package/.agent/scripts/coderabbit-pro-analysis.sh +0 -238
  66. package/.agent/scripts/commands/code-simplifier.md +0 -86
  67. package/.agent/scripts/commands/full-loop.md +0 -246
  68. package/.agent/scripts/commands/postflight-loop.md +0 -103
  69. package/.agent/scripts/commands/recall.md +0 -182
  70. package/.agent/scripts/commands/remember.md +0 -132
  71. package/.agent/scripts/commands/save-todo.md +0 -175
  72. package/.agent/scripts/commands/session-review.md +0 -154
  73. package/.agent/scripts/comprehensive-quality-fix.sh +0 -106
  74. package/.agent/scripts/context-builder-helper.sh +0 -522
  75. package/.agent/scripts/coolify-cli-helper.sh +0 -674
  76. package/.agent/scripts/coolify-helper.sh +0 -380
  77. package/.agent/scripts/crawl4ai-examples.sh +0 -401
  78. package/.agent/scripts/crawl4ai-helper.sh +0 -1078
  79. package/.agent/scripts/crewai-helper.sh +0 -681
  80. package/.agent/scripts/dev-browser-helper.sh +0 -513
  81. package/.agent/scripts/dns-helper.sh +0 -396
  82. package/.agent/scripts/domain-research-helper.sh +0 -917
  83. package/.agent/scripts/dspy-helper.sh +0 -285
  84. package/.agent/scripts/dspyground-helper.sh +0 -291
  85. package/.agent/scripts/eeat-score-helper.sh +0 -1242
  86. package/.agent/scripts/efficient-return-fix.sh +0 -92
  87. package/.agent/scripts/extract-opencode-prompts.sh +0 -128
  88. package/.agent/scripts/find-missing-returns.sh +0 -113
  89. package/.agent/scripts/fix-auth-headers.sh +0 -104
  90. package/.agent/scripts/fix-common-strings.sh +0 -254
  91. package/.agent/scripts/fix-content-type.sh +0 -100
  92. package/.agent/scripts/fix-error-messages.sh +0 -130
  93. package/.agent/scripts/fix-misplaced-returns.sh +0 -74
  94. package/.agent/scripts/fix-remaining-literals.sh +0 -152
  95. package/.agent/scripts/fix-return-statements.sh +0 -41
  96. package/.agent/scripts/fix-s131-default-cases.sh +0 -249
  97. package/.agent/scripts/fix-sc2155-simple.sh +0 -102
  98. package/.agent/scripts/fix-shellcheck-critical.sh +0 -187
  99. package/.agent/scripts/fix-string-literals.sh +0 -273
  100. package/.agent/scripts/full-loop-helper.sh +0 -773
  101. package/.agent/scripts/generate-opencode-agents.sh +0 -497
  102. package/.agent/scripts/generate-opencode-commands.sh +0 -1629
  103. package/.agent/scripts/generate-skills.sh +0 -366
  104. package/.agent/scripts/git-platforms-helper.sh +0 -640
  105. package/.agent/scripts/gitea-cli-helper.sh +0 -743
  106. package/.agent/scripts/github-cli-helper.sh +0 -702
  107. package/.agent/scripts/gitlab-cli-helper.sh +0 -682
  108. package/.agent/scripts/gsc-add-user-helper.sh +0 -325
  109. package/.agent/scripts/gsc-sitemap-helper.sh +0 -678
  110. package/.agent/scripts/hetzner-helper.sh +0 -485
  111. package/.agent/scripts/hostinger-helper.sh +0 -229
  112. package/.agent/scripts/keyword-research-helper.sh +0 -1815
  113. package/.agent/scripts/langflow-helper.sh +0 -544
  114. package/.agent/scripts/linkedin-automation.py +0 -241
  115. package/.agent/scripts/linter-manager.sh +0 -599
  116. package/.agent/scripts/linters-local.sh +0 -434
  117. package/.agent/scripts/list-keys-helper.sh +0 -488
  118. package/.agent/scripts/local-browser-automation.py +0 -339
  119. package/.agent/scripts/localhost-helper.sh +0 -744
  120. package/.agent/scripts/loop-common.sh +0 -806
  121. package/.agent/scripts/mainwp-helper.sh +0 -728
  122. package/.agent/scripts/markdown-formatter.sh +0 -338
  123. package/.agent/scripts/markdown-lint-fix.sh +0 -311
  124. package/.agent/scripts/mass-fix-returns.sh +0 -58
  125. package/.agent/scripts/mcp-diagnose.sh +0 -167
  126. package/.agent/scripts/mcp-inspector-helper.sh +0 -449
  127. package/.agent/scripts/memory-helper.sh +0 -650
  128. package/.agent/scripts/monitor-code-review.sh +0 -255
  129. package/.agent/scripts/onboarding-helper.sh +0 -706
  130. package/.agent/scripts/opencode-github-setup-helper.sh +0 -797
  131. package/.agent/scripts/opencode-test-helper.sh +0 -213
  132. package/.agent/scripts/pagespeed-helper.sh +0 -464
  133. package/.agent/scripts/pandoc-helper.sh +0 -362
  134. package/.agent/scripts/postflight-check.sh +0 -555
  135. package/.agent/scripts/pre-commit-hook.sh +0 -259
  136. package/.agent/scripts/pre-edit-check.sh +0 -169
  137. package/.agent/scripts/qlty-cli.sh +0 -356
  138. package/.agent/scripts/quality-cli-manager.sh +0 -525
  139. package/.agent/scripts/quality-feedback-helper.sh +0 -462
  140. package/.agent/scripts/quality-fix.sh +0 -263
  141. package/.agent/scripts/quality-loop-helper.sh +0 -1108
  142. package/.agent/scripts/ralph-loop-helper.sh +0 -836
  143. package/.agent/scripts/ralph-upstream-check.sh +0 -341
  144. package/.agent/scripts/secretlint-helper.sh +0 -847
  145. package/.agent/scripts/servers-helper.sh +0 -241
  146. package/.agent/scripts/ses-helper.sh +0 -619
  147. package/.agent/scripts/session-review-helper.sh +0 -404
  148. package/.agent/scripts/setup-linters-wizard.sh +0 -379
  149. package/.agent/scripts/setup-local-api-keys.sh +0 -330
  150. package/.agent/scripts/setup-mcp-integrations.sh +0 -472
  151. package/.agent/scripts/shared-constants.sh +0 -246
  152. package/.agent/scripts/site-crawler-helper.sh +0 -1487
  153. package/.agent/scripts/snyk-helper.sh +0 -940
  154. package/.agent/scripts/sonarcloud-autofix.sh +0 -193
  155. package/.agent/scripts/sonarcloud-cli.sh +0 -191
  156. package/.agent/scripts/sonarscanner-cli.sh +0 -455
  157. package/.agent/scripts/spaceship-helper.sh +0 -747
  158. package/.agent/scripts/stagehand-helper.sh +0 -321
  159. package/.agent/scripts/stagehand-python-helper.sh +0 -321
  160. package/.agent/scripts/stagehand-python-setup.sh +0 -441
  161. package/.agent/scripts/stagehand-setup.sh +0 -439
  162. package/.agent/scripts/system-cleanup.sh +0 -340
  163. package/.agent/scripts/terminal-title-helper.sh +0 -388
  164. package/.agent/scripts/terminal-title-setup.sh +0 -549
  165. package/.agent/scripts/test-stagehand-both-integration.sh +0 -317
  166. package/.agent/scripts/test-stagehand-integration.sh +0 -309
  167. package/.agent/scripts/test-stagehand-python-integration.sh +0 -341
  168. package/.agent/scripts/todo-ready.sh +0 -263
  169. package/.agent/scripts/tool-version-check.sh +0 -362
  170. package/.agent/scripts/toon-helper.sh +0 -469
  171. package/.agent/scripts/twilio-helper.sh +0 -917
  172. package/.agent/scripts/updown-helper.sh +0 -279
  173. package/.agent/scripts/validate-mcp-integrations.sh +0 -250
  174. package/.agent/scripts/validate-version-consistency.sh +0 -131
  175. package/.agent/scripts/vaultwarden-helper.sh +0 -597
  176. package/.agent/scripts/vercel-cli-helper.sh +0 -816
  177. package/.agent/scripts/verify-mirrors.sh +0 -169
  178. package/.agent/scripts/version-manager.sh +0 -831
  179. package/.agent/scripts/webhosting-helper.sh +0 -471
  180. package/.agent/scripts/webhosting-verify.sh +0 -238
  181. package/.agent/scripts/wordpress-mcp-helper.sh +0 -508
  182. package/.agent/scripts/worktree-helper.sh +0 -595
  183. package/.agent/scripts/worktree-sessions.sh +0 -577
  184. package/.agent/seo/dataforseo.md +0 -215
  185. package/.agent/seo/domain-research.md +0 -532
  186. package/.agent/seo/eeat-score.md +0 -659
  187. package/.agent/seo/google-search-console.md +0 -366
  188. package/.agent/seo/gsc-sitemaps.md +0 -282
  189. package/.agent/seo/keyword-research.md +0 -521
  190. package/.agent/seo/serper.md +0 -278
  191. package/.agent/seo/site-crawler.md +0 -387
  192. package/.agent/seo.md +0 -236
  193. package/.agent/services/accounting/quickfile.md +0 -159
  194. package/.agent/services/communications/telfon.md +0 -470
  195. package/.agent/services/communications/twilio.md +0 -569
  196. package/.agent/services/crm/fluentcrm.md +0 -449
  197. package/.agent/services/email/ses.md +0 -399
  198. package/.agent/services/hosting/101domains.md +0 -378
  199. package/.agent/services/hosting/closte.md +0 -177
  200. package/.agent/services/hosting/cloudflare.md +0 -251
  201. package/.agent/services/hosting/cloudron.md +0 -478
  202. package/.agent/services/hosting/dns-providers.md +0 -335
  203. package/.agent/services/hosting/domain-purchasing.md +0 -344
  204. package/.agent/services/hosting/hetzner.md +0 -327
  205. package/.agent/services/hosting/hostinger.md +0 -287
  206. package/.agent/services/hosting/localhost.md +0 -419
  207. package/.agent/services/hosting/spaceship.md +0 -353
  208. package/.agent/services/hosting/webhosting.md +0 -330
  209. package/.agent/social-media.md +0 -69
  210. package/.agent/templates/plans-template.md +0 -114
  211. package/.agent/templates/prd-template.md +0 -129
  212. package/.agent/templates/tasks-template.md +0 -108
  213. package/.agent/templates/todo-template.md +0 -89
  214. package/.agent/tools/ai-assistants/agno.md +0 -471
  215. package/.agent/tools/ai-assistants/capsolver.md +0 -326
  216. package/.agent/tools/ai-assistants/configuration.md +0 -221
  217. package/.agent/tools/ai-assistants/overview.md +0 -209
  218. package/.agent/tools/ai-assistants/status.md +0 -171
  219. package/.agent/tools/ai-assistants/windsurf.md +0 -193
  220. package/.agent/tools/ai-orchestration/autogen.md +0 -406
  221. package/.agent/tools/ai-orchestration/crewai.md +0 -445
  222. package/.agent/tools/ai-orchestration/langflow.md +0 -405
  223. package/.agent/tools/ai-orchestration/openprose.md +0 -487
  224. package/.agent/tools/ai-orchestration/overview.md +0 -362
  225. package/.agent/tools/ai-orchestration/packaging.md +0 -647
  226. package/.agent/tools/browser/agent-browser.md +0 -464
  227. package/.agent/tools/browser/browser-automation.md +0 -400
  228. package/.agent/tools/browser/chrome-devtools.md +0 -282
  229. package/.agent/tools/browser/crawl4ai-integration.md +0 -422
  230. package/.agent/tools/browser/crawl4ai-resources.md +0 -277
  231. package/.agent/tools/browser/crawl4ai-usage.md +0 -416
  232. package/.agent/tools/browser/crawl4ai.md +0 -585
  233. package/.agent/tools/browser/dev-browser.md +0 -341
  234. package/.agent/tools/browser/pagespeed.md +0 -260
  235. package/.agent/tools/browser/playwright.md +0 -266
  236. package/.agent/tools/browser/playwriter.md +0 -310
  237. package/.agent/tools/browser/stagehand-examples.md +0 -456
  238. package/.agent/tools/browser/stagehand-python.md +0 -483
  239. package/.agent/tools/browser/stagehand.md +0 -421
  240. package/.agent/tools/build-agent/agent-review.md +0 -224
  241. package/.agent/tools/build-agent/build-agent.md +0 -784
  242. package/.agent/tools/build-mcp/aidevops-plugin.md +0 -476
  243. package/.agent/tools/build-mcp/api-wrapper.md +0 -445
  244. package/.agent/tools/build-mcp/build-mcp.md +0 -240
  245. package/.agent/tools/build-mcp/deployment.md +0 -401
  246. package/.agent/tools/build-mcp/server-patterns.md +0 -632
  247. package/.agent/tools/build-mcp/transports.md +0 -366
  248. package/.agent/tools/code-review/auditing.md +0 -383
  249. package/.agent/tools/code-review/automation.md +0 -219
  250. package/.agent/tools/code-review/best-practices.md +0 -203
  251. package/.agent/tools/code-review/codacy.md +0 -151
  252. package/.agent/tools/code-review/code-simplifier.md +0 -174
  253. package/.agent/tools/code-review/code-standards.md +0 -309
  254. package/.agent/tools/code-review/coderabbit.md +0 -101
  255. package/.agent/tools/code-review/management.md +0 -155
  256. package/.agent/tools/code-review/qlty.md +0 -248
  257. package/.agent/tools/code-review/secretlint.md +0 -565
  258. package/.agent/tools/code-review/setup.md +0 -250
  259. package/.agent/tools/code-review/snyk.md +0 -563
  260. package/.agent/tools/code-review/tools.md +0 -230
  261. package/.agent/tools/content/summarize.md +0 -353
  262. package/.agent/tools/context/augment-context-engine.md +0 -468
  263. package/.agent/tools/context/context-builder-agent.md +0 -76
  264. package/.agent/tools/context/context-builder.md +0 -375
  265. package/.agent/tools/context/context7.md +0 -371
  266. package/.agent/tools/context/dspy.md +0 -302
  267. package/.agent/tools/context/dspyground.md +0 -374
  268. package/.agent/tools/context/llm-tldr.md +0 -219
  269. package/.agent/tools/context/osgrep.md +0 -488
  270. package/.agent/tools/context/prompt-optimization.md +0 -338
  271. package/.agent/tools/context/toon.md +0 -292
  272. package/.agent/tools/conversion/pandoc.md +0 -304
  273. package/.agent/tools/credentials/api-key-management.md +0 -154
  274. package/.agent/tools/credentials/api-key-setup.md +0 -224
  275. package/.agent/tools/credentials/environment-variables.md +0 -180
  276. package/.agent/tools/credentials/vaultwarden.md +0 -382
  277. package/.agent/tools/data-extraction/outscraper.md +0 -974
  278. package/.agent/tools/deployment/coolify-cli.md +0 -388
  279. package/.agent/tools/deployment/coolify-setup.md +0 -353
  280. package/.agent/tools/deployment/coolify.md +0 -345
  281. package/.agent/tools/deployment/vercel.md +0 -390
  282. package/.agent/tools/git/authentication.md +0 -132
  283. package/.agent/tools/git/gitea-cli.md +0 -193
  284. package/.agent/tools/git/github-actions.md +0 -207
  285. package/.agent/tools/git/github-cli.md +0 -223
  286. package/.agent/tools/git/gitlab-cli.md +0 -190
  287. package/.agent/tools/git/opencode-github-security.md +0 -350
  288. package/.agent/tools/git/opencode-github.md +0 -328
  289. package/.agent/tools/git/opencode-gitlab.md +0 -252
  290. package/.agent/tools/git/security.md +0 -196
  291. package/.agent/tools/git.md +0 -207
  292. package/.agent/tools/opencode/oh-my-opencode.md +0 -375
  293. package/.agent/tools/opencode/opencode-anthropic-auth.md +0 -446
  294. package/.agent/tools/opencode/opencode.md +0 -651
  295. package/.agent/tools/social-media/bird.md +0 -437
  296. package/.agent/tools/task-management/beads.md +0 -336
  297. package/.agent/tools/terminal/terminal-title.md +0 -251
  298. package/.agent/tools/ui/shadcn.md +0 -196
  299. package/.agent/tools/ui/ui-skills.md +0 -115
  300. package/.agent/tools/wordpress/localwp.md +0 -311
  301. package/.agent/tools/wordpress/mainwp.md +0 -391
  302. package/.agent/tools/wordpress/scf.md +0 -527
  303. package/.agent/tools/wordpress/wp-admin.md +0 -729
  304. package/.agent/tools/wordpress/wp-dev.md +0 -940
  305. package/.agent/tools/wordpress/wp-preferred.md +0 -398
  306. package/.agent/tools/wordpress.md +0 -95
  307. package/.agent/workflows/branch/bugfix.md +0 -63
  308. package/.agent/workflows/branch/chore.md +0 -95
  309. package/.agent/workflows/branch/experiment.md +0 -115
  310. package/.agent/workflows/branch/feature.md +0 -59
  311. package/.agent/workflows/branch/hotfix.md +0 -98
  312. package/.agent/workflows/branch/refactor.md +0 -92
  313. package/.agent/workflows/branch/release.md +0 -96
  314. package/.agent/workflows/branch.md +0 -347
  315. package/.agent/workflows/bug-fixing.md +0 -267
  316. package/.agent/workflows/changelog.md +0 -129
  317. package/.agent/workflows/code-audit-remote.md +0 -279
  318. package/.agent/workflows/conversation-starter.md +0 -69
  319. package/.agent/workflows/error-feedback.md +0 -578
  320. package/.agent/workflows/feature-development.md +0 -355
  321. package/.agent/workflows/git-workflow.md +0 -702
  322. package/.agent/workflows/multi-repo-workspace.md +0 -268
  323. package/.agent/workflows/plans.md +0 -709
  324. package/.agent/workflows/postflight.md +0 -604
  325. package/.agent/workflows/pr.md +0 -571
  326. package/.agent/workflows/preflight.md +0 -278
  327. package/.agent/workflows/ralph-loop.md +0 -773
  328. package/.agent/workflows/release.md +0 -498
  329. package/.agent/workflows/session-manager.md +0 -254
  330. package/.agent/workflows/session-review.md +0 -311
  331. package/.agent/workflows/sql-migrations.md +0 -631
  332. package/.agent/workflows/version-bump.md +0 -283
  333. package/.agent/workflows/wiki-update.md +0 -333
  334. package/.agent/workflows/worktree.md +0 -477
@@ -1,341 +0,0 @@
1
- #!/bin/bash
2
- # shellcheck disable=SC2329
3
- # =============================================================================
4
- # Ralph Upstream Check - Compare with Claude Code Plugin
5
- # =============================================================================
6
- # Checks for updates to the upstream Claude Code ralph-wiggum plugin
7
- # and reports any significant changes we might want to incorporate.
8
- #
9
- # Usage:
10
- # ralph-upstream-check.sh [--verbose]
11
- #
12
- # This script is called automatically when starting an OpenCode session
13
- # in the aidevops repository.
14
- #
15
- # Author: AI DevOps Framework
16
- # =============================================================================
17
-
18
- set -euo pipefail
19
-
20
- # =============================================================================
21
- # Constants
22
- # =============================================================================
23
-
24
- readonly UPSTREAM_REPO="anthropics/claude-code"
25
- readonly UPSTREAM_PATH="plugins/ralph-wiggum"
26
- readonly UPSTREAM_API="https://api.github.com/repos/${UPSTREAM_REPO}/contents/${UPSTREAM_PATH}"
27
- readonly CACHE_DIR="$HOME/.cache/aidevops"
28
- readonly CACHE_FILE="${CACHE_DIR}/ralph-upstream-check.json"
29
- readonly CACHE_TTL=86400 # 24 hours in seconds
30
-
31
- # Colors
32
- readonly GREEN='\033[0;32m'
33
- readonly YELLOW='\033[1;33m'
34
- readonly BLUE='\033[0;34m'
35
- readonly NC='\033[0m'
36
-
37
- # =============================================================================
38
- # Helper Functions
39
- # =============================================================================
40
-
41
- verbose=false
42
-
43
- log_info() {
44
- echo -e "${BLUE}[ralph-upstream]${NC} $1"
45
- return 0
46
- }
47
-
48
- log_success() {
49
- echo -e "${GREEN}[ralph-upstream]${NC} $1"
50
- return 0
51
- }
52
-
53
- log_warning() {
54
- echo -e "${YELLOW}[ralph-upstream]${NC} $1"
55
- return 0
56
- }
57
-
58
- log_verbose() {
59
- if [[ "$verbose" == "true" ]]; then
60
- echo -e "${BLUE}[ralph-upstream]${NC} $1"
61
- fi
62
- return 0
63
- }
64
-
65
- # =============================================================================
66
- # Cache Functions
67
- # =============================================================================
68
-
69
- ensure_cache_dir() {
70
- mkdir -p "$CACHE_DIR"
71
- return 0
72
- }
73
-
74
- is_cache_valid() {
75
- if [[ ! -f "$CACHE_FILE" ]]; then
76
- return 1
77
- fi
78
-
79
- local cache_time
80
- cache_time=$(stat -f %m "$CACHE_FILE" 2>/dev/null || stat -c %Y "$CACHE_FILE" 2>/dev/null || echo 0)
81
- local current_time
82
- current_time=$(date +%s)
83
- local age=$((current_time - cache_time))
84
-
85
- if [[ $age -lt $CACHE_TTL ]]; then
86
- return 0
87
- fi
88
- return 1
89
- }
90
-
91
- read_cache() {
92
- if [[ -f "$CACHE_FILE" ]]; then
93
- cat "$CACHE_FILE"
94
- fi
95
- return 0
96
- }
97
-
98
- write_cache() {
99
- local data="$1"
100
- ensure_cache_dir
101
- echo "$data" > "$CACHE_FILE"
102
- return 0
103
- }
104
-
105
- # =============================================================================
106
- # API Functions
107
- # =============================================================================
108
-
109
- fetch_upstream_info() {
110
- local response
111
-
112
- # Try to fetch from GitHub API
113
- if ! response=$(curl -sf -H "Accept: application/vnd.github.v3+json" "$UPSTREAM_API" 2>/dev/null); then
114
- log_verbose "Failed to fetch upstream info (network error or rate limit)"
115
- return 1
116
- fi
117
-
118
- echo "$response"
119
- }
120
-
121
- get_file_sha() {
122
- local json="$1"
123
- local filename="$2"
124
-
125
- echo "$json" | jq -r ".[] | select(.name == \"$filename\") | .sha" 2>/dev/null || echo ""
126
- return 0
127
- }
128
-
129
- fetch_file_content() {
130
- local filename="$1"
131
- local url="https://raw.githubusercontent.com/${UPSTREAM_REPO}/main/${UPSTREAM_PATH}/${filename}"
132
-
133
- curl -sf "$url" 2>/dev/null || echo ""
134
- return 0
135
- }
136
-
137
- # =============================================================================
138
- # Comparison Functions
139
- # =============================================================================
140
-
141
- extract_version() {
142
- local content="$1"
143
- # Try to extract version from plugin.json or package.json
144
- echo "$content" | jq -r '.version // empty' 2>/dev/null || echo "unknown"
145
- return 0
146
- }
147
-
148
- compare_implementations() {
149
- local upstream_readme
150
- local upstream_setup
151
- local changes_found=false
152
-
153
- log_verbose "Fetching upstream README.md..." >&2
154
- upstream_readme=$(fetch_file_content "README.md")
155
-
156
- log_verbose "Fetching upstream setup script..." >&2
157
- upstream_setup=$(fetch_file_content "scripts/setup-ralph-loop.sh")
158
-
159
- # Check for new features in README
160
- if [[ -n "$upstream_readme" ]]; then
161
- # Look for new options we don't have
162
- local new_options
163
- new_options=$(echo "$upstream_readme" | grep -oE '\-\-[a-z-]+' | sort -u | grep -vE 'max-iterations|completion-promise|help' || true)
164
- if [[ -n "$new_options" ]]; then
165
- log_warning "Upstream may have new command-line options:" >&2
166
- echo "$new_options" | head -5 >&2
167
- changes_found=true
168
- fi
169
-
170
- # Check for new sections
171
- local new_sections
172
- new_sections=$(echo "$upstream_readme" | grep -E '^## ' | grep -vE 'What is Ralph|Quick Start|Commands|Philosophy|When to Use|Learn More|Prompt Writing|Completion Promise|State File|Cross-Tool|Monitoring|Real-World|For Help' || true)
173
- if [[ -n "$new_sections" ]]; then
174
- log_warning "Upstream has new documentation sections:" >&2
175
- echo "$new_sections" | head -5 >&2
176
- changes_found=true
177
- fi
178
- fi
179
-
180
- # Check for new features in setup script
181
- if [[ -n "$upstream_setup" ]]; then
182
- # Look for new case options
183
- local upstream_options
184
- upstream_options=$(echo "$upstream_setup" | grep -E '^\s+--[a-z-]+\)' | sed 's/)//' | tr -d ' ' || true)
185
-
186
- local our_options="max-iterations completion-promise help"
187
-
188
- for opt in $upstream_options; do
189
- # Strip leading dashes for comparison
190
- local opt_name="${opt#--}"
191
- if ! echo "$our_options" | grep -qF "$opt_name"; then
192
- log_warning "Upstream has new option: $opt" >&2
193
- changes_found=true
194
- fi
195
- done
196
- fi
197
-
198
- if [[ "$changes_found" == "false" ]]; then
199
- log_success "No significant upstream changes detected" >&2
200
- fi
201
-
202
- echo "$changes_found"
203
- return 0
204
- }
205
-
206
- # =============================================================================
207
- # Main Check Function
208
- # =============================================================================
209
-
210
- check_upstream() {
211
- log_info "Checking for upstream ralph-wiggum plugin updates..."
212
-
213
- # Check cache first
214
- if is_cache_valid; then
215
- local cached
216
- cached=$(read_cache)
217
- local cached_result
218
- cached_result=$(echo "$cached" | jq -r '.result // "unknown"' 2>/dev/null || echo "unknown")
219
-
220
- if [[ "$cached_result" == "no_changes" ]]; then
221
- log_verbose "Cache valid, no changes (checked within 24h)"
222
- return 0
223
- elif [[ "$cached_result" == "changes_found" ]]; then
224
- log_warning "Upstream changes detected (from cache). Run with --verbose for details."
225
- return 0
226
- fi
227
- fi
228
-
229
- # Fetch upstream info
230
- local upstream_info
231
- if ! upstream_info=$(fetch_upstream_info); then
232
- log_verbose "Could not check upstream (offline or rate limited)"
233
- return 0
234
- fi
235
-
236
- # Get current SHAs
237
- local readme_sha
238
- local setup_sha
239
- readme_sha=$(get_file_sha "$upstream_info" "README.md")
240
- setup_sha=$(get_file_sha "$upstream_info" "scripts")
241
-
242
- # Check against cached SHAs
243
- local cached_readme_sha=""
244
- local cached_setup_sha=""
245
- if [[ -f "$CACHE_FILE" ]]; then
246
- cached_readme_sha=$(jq -r '.readme_sha // ""' "$CACHE_FILE" 2>/dev/null || echo "")
247
- cached_setup_sha=$(jq -r '.setup_sha // ""' "$CACHE_FILE" 2>/dev/null || echo "")
248
- fi
249
-
250
- # If SHAs match, no changes
251
- if [[ "$readme_sha" == "$cached_readme_sha" ]] && [[ "$setup_sha" == "$cached_setup_sha" ]] && [[ -n "$cached_readme_sha" ]]; then
252
- log_verbose "Upstream unchanged since last check"
253
- write_cache "{\"result\": \"no_changes\", \"readme_sha\": \"$readme_sha\", \"setup_sha\": \"$setup_sha\", \"checked\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}"
254
- return 0
255
- fi
256
-
257
- # SHAs differ or first check - do detailed comparison
258
- log_info "Upstream files have changed, analyzing..."
259
- local changes_found
260
- changes_found=$(compare_implementations)
261
-
262
- # Update cache
263
- local result="no_changes"
264
- if [[ "$changes_found" == "true" ]]; then
265
- result="changes_found"
266
- log_warning "Review upstream changes: https://github.com/${UPSTREAM_REPO}/tree/main/${UPSTREAM_PATH}"
267
- fi
268
-
269
- write_cache "{\"result\": \"$result\", \"readme_sha\": \"$readme_sha\", \"setup_sha\": \"$setup_sha\", \"checked\": \"$(date -u +%Y-%m-%dT%H:%M:%SZ)\"}"
270
-
271
- return 0
272
- }
273
-
274
- show_help() {
275
- cat << 'EOF'
276
- Ralph Upstream Check - Compare with Claude Code Plugin
277
-
278
- USAGE:
279
- ralph-upstream-check.sh [OPTIONS]
280
-
281
- OPTIONS:
282
- --verbose, -v Show detailed output
283
- --force, -f Force check (ignore cache)
284
- --help, -h Show this help
285
-
286
- DESCRIPTION:
287
- Checks for updates to the upstream Claude Code ralph-wiggum plugin
288
- and reports any significant changes we might want to incorporate.
289
-
290
- Results are cached for 24 hours to avoid excessive API calls.
291
-
292
- This script runs automatically when starting an OpenCode session
293
- in the aidevops repository.
294
-
295
- UPSTREAM:
296
- https://github.com/anthropics/claude-code/tree/main/plugins/ralph-wiggum
297
- EOF
298
- return 0
299
- }
300
-
301
- # =============================================================================
302
- # Main
303
- # =============================================================================
304
-
305
- main() {
306
- local force=false
307
-
308
- while [[ $# -gt 0 ]]; do
309
- case $1 in
310
- --verbose|-v)
311
- verbose=true
312
- shift
313
- ;;
314
- --force|-f)
315
- force=true
316
- shift
317
- ;;
318
- --help|-h)
319
- show_help
320
- return 0
321
- ;;
322
- *)
323
- echo "Unknown option: $1" >&2
324
- show_help
325
- return 1
326
- ;;
327
- esac
328
- done
329
-
330
- # Clear cache if force
331
- if [[ "$force" == "true" ]] && [[ -f "$CACHE_FILE" ]]; then
332
- rm -f "$CACHE_FILE"
333
- fi
334
-
335
- check_upstream
336
-
337
- return 0
338
- }
339
-
340
- main "$@"
341
- exit $?