claude-dev-env 1.38.1 → 1.40.0

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 (282) hide show
  1. package/CLAUDE.md +10 -36
  2. package/_shared/pr-loop/audit-reply-template.md +147 -0
  3. package/_shared/pr-loop/fix-protocol.md +25 -4
  4. package/_shared/pr-loop/gh-payloads.md +37 -50
  5. package/_shared/pr-loop/scripts/code_rules_gate.py +0 -60
  6. package/_shared/pr-loop/scripts/config/post_audit_thread_constants.py +199 -0
  7. package/_shared/pr-loop/scripts/config/reviews_disabled_constants.py +8 -0
  8. package/_shared/pr-loop/scripts/post_audit_thread.py +1242 -0
  9. package/_shared/pr-loop/scripts/preflight.py +129 -2
  10. package/_shared/pr-loop/scripts/reviews_disabled.py +59 -0
  11. package/_shared/pr-loop/scripts/tests/test_code_rules_gate.py +0 -19
  12. package/_shared/pr-loop/scripts/tests/test_post_audit_thread.py +1116 -0
  13. package/_shared/pr-loop/scripts/tests/test_post_audit_thread_constants.py +127 -0
  14. package/_shared/pr-loop/scripts/tests/test_preflight.py +41 -0
  15. package/_shared/pr-loop/scripts/tests/test_reviews_disabled.py +36 -0
  16. package/_shared/pr-loop/state-schema.md +1 -1
  17. package/agents/clean-coder.md +2 -2
  18. package/agents/pr-description-writer.md +150 -52
  19. package/bin/install.mjs +6 -7
  20. package/bin/install.test.mjs +8 -0
  21. package/commands/doc-gist.md +16 -0
  22. package/commands/plan.md +0 -2
  23. package/commands/review-plan.md +1 -1
  24. package/docs/CODE_RULES.md +122 -2
  25. package/docs/PR_DESCRIPTION_GUIDE.md +127 -64
  26. package/hooks/blocking/bot_mention_comment_blocker.py +75 -0
  27. package/hooks/blocking/code_rules_enforcer.py +1143 -129
  28. package/hooks/blocking/convergence_gate_blocker.py +130 -0
  29. package/hooks/blocking/destructive_command_blocker.py +74 -0
  30. package/hooks/blocking/gh_body_arg_blocker.py +30 -0
  31. package/hooks/blocking/md_to_html_blocker.py +119 -0
  32. package/hooks/blocking/pr_description_enforcer.py +57 -22
  33. package/hooks/blocking/test_bot_mention_comment_blocker.py +131 -0
  34. package/hooks/blocking/test_code_rules_enforcer.py +21 -0
  35. package/hooks/blocking/test_code_rules_enforcer_any_exempt_files.py +70 -0
  36. package/hooks/blocking/test_code_rules_enforcer_any_imports_and_cast.py +92 -0
  37. package/hooks/blocking/test_code_rules_enforcer_banned_import_alias.py +143 -0
  38. package/hooks/blocking/test_code_rules_enforcer_banned_prefixes.py +152 -0
  39. package/hooks/blocking/test_code_rules_enforcer_bare_except.py +120 -0
  40. package/hooks/blocking/test_code_rules_enforcer_boundary_types.py +175 -0
  41. package/hooks/blocking/test_code_rules_enforcer_cap_meta.py +0 -1
  42. package/hooks/blocking/test_code_rules_enforcer_collection_prefix.py +50 -0
  43. package/hooks/blocking/test_code_rules_enforcer_docstring_format.py +255 -0
  44. package/hooks/blocking/test_code_rules_enforcer_inline_tuple_string_magic.py +130 -0
  45. package/hooks/blocking/test_code_rules_enforcer_stub_implementations.py +141 -0
  46. package/hooks/blocking/test_code_rules_enforcer_test_branching.py +143 -0
  47. package/hooks/blocking/test_code_rules_enforcer_thin_wrapper_files.py +169 -0
  48. package/hooks/blocking/test_code_rules_enforcer_todo_markers.py +99 -0
  49. package/hooks/blocking/test_code_rules_enforcer_typed_dict_pairs.py +141 -0
  50. package/hooks/blocking/test_convergence_gate_blocker.py +63 -0
  51. package/hooks/blocking/test_destructive_command_blocker.py +146 -0
  52. package/hooks/blocking/test_destructive_command_blocker_no_verify.py +102 -0
  53. package/hooks/blocking/test_gh_body_arg_blocker.py +45 -0
  54. package/hooks/blocking/test_md_to_html_blocker.py +317 -0
  55. package/hooks/blocking/test_pr_description_enforcer.py +69 -8
  56. package/hooks/config/any_type_config.py +7 -0
  57. package/hooks/config/banned_identifiers_constants.py +11 -0
  58. package/hooks/config/blocking_check_limits.py +38 -0
  59. package/hooks/config/bot_mention_comment_blocker_constants.py +20 -0
  60. package/hooks/config/code_rules_enforcer_constants.py +53 -0
  61. package/hooks/config/convergence_branch_constants.py +9 -0
  62. package/hooks/config/doc_gist_auto_publish_constants.py +18 -0
  63. package/hooks/config/html_companion_constants.py +20 -0
  64. package/hooks/config/inline_tuple_string_magic_constants.py +22 -0
  65. package/hooks/config/pr_description_enforcer_constants.py +14 -0
  66. package/hooks/config/test_banned_identifiers_constants.py +17 -0
  67. package/hooks/hooks.json +28 -20
  68. package/hooks/pyproject.toml +69 -0
  69. package/hooks/validators/mypy_integration.py +47 -1
  70. package/hooks/validators/run_all_validators.py +3 -3
  71. package/hooks/validators/test_mypy_integration.py +50 -1
  72. package/hooks/workflow/doc_gist_auto_publish.py +144 -0
  73. package/hooks/workflow/md_to_html_companion.py +365 -0
  74. package/hooks/workflow/test_doc_gist_auto_publish.py +117 -0
  75. package/hooks/workflow/test_md_to_html_companion.py +452 -0
  76. package/package.json +1 -1
  77. package/rules/gh-body-file.md +2 -0
  78. package/scripts/Install-SweepEmptyDirs.ps1 +111 -0
  79. package/scripts/check.ps1 +106 -0
  80. package/scripts/config/timing.py +11 -0
  81. package/scripts/sweep_empty_dirs.py +138 -0
  82. package/scripts/sync_to_cursor/rules.py +1 -1
  83. package/scripts/test_sweep_empty_dirs.py +183 -0
  84. package/skills/_shared/pr-loop/prompts/pr-consistency-audit.xml +323 -0
  85. package/skills/_shared/pr-loop/scripts/_cli_utils.py +22 -0
  86. package/skills/_shared/pr-loop/scripts/_path_resolver.py +165 -0
  87. package/skills/_shared/pr-loop/scripts/_xml_utils.py +20 -0
  88. package/skills/_shared/pr-loop/scripts/build_audit_prompt.py +182 -0
  89. package/skills/_shared/pr-loop/scripts/build_fix_prompt.py +185 -0
  90. package/skills/_shared/pr-loop/scripts/config/__init__.py +0 -0
  91. package/skills/_shared/pr-loop/scripts/config/path_resolver_constants.py +78 -0
  92. package/skills/_shared/pr-loop/scripts/init_loop_state.py +135 -0
  93. package/skills/_shared/pr-loop/scripts/teardown_worktrees.py +175 -0
  94. package/skills/_shared/pr-loop/scripts/write_audit_outcomes.py +182 -0
  95. package/skills/_shared/pr-loop/scripts/write_fix_outcomes.py +206 -0
  96. package/skills/bugteam/CONSTRAINTS.md +21 -22
  97. package/skills/bugteam/EXAMPLES.md +3 -3
  98. package/skills/bugteam/PROMPTS.md +227 -67
  99. package/skills/bugteam/SKILL.md +132 -455
  100. package/skills/bugteam/reference/README.md +1 -1
  101. package/skills/bugteam/reference/audit-and-teammates.md +112 -39
  102. package/skills/bugteam/reference/audit-contract.md +4 -22
  103. package/skills/bugteam/reference/copilot-gap-analysis.md +8 -5
  104. package/skills/bugteam/reference/design-rationale.md +2 -2
  105. package/skills/bugteam/reference/github-pr-reviews.md +50 -57
  106. package/skills/bugteam/reference/obstacles/audit-assign-ids.md +13 -0
  107. package/skills/bugteam/reference/obstacles/audit-capture-excerpts.md +13 -0
  108. package/skills/bugteam/reference/obstacles/audit-walk-categories.md +13 -0
  109. package/skills/bugteam/reference/obstacles/audit-write-xml.md +13 -0
  110. package/skills/bugteam/reference/obstacles/fix-append-summary.md +13 -0
  111. package/skills/bugteam/reference/obstacles/fix-apply-fixes.md +13 -0
  112. package/skills/bugteam/reference/obstacles/fix-git-add-commit.md +13 -0
  113. package/skills/bugteam/reference/obstacles/fix-git-push.md +13 -0
  114. package/skills/bugteam/reference/obstacles/fix-post-reply.md +13 -0
  115. package/skills/bugteam/reference/obstacles/fix-publish-summary.md +13 -0
  116. package/skills/bugteam/reference/obstacles/fix-py-compile.md +13 -0
  117. package/skills/bugteam/reference/obstacles/fix-read-files.md +13 -0
  118. package/skills/bugteam/reference/obstacles/fix-resolve-thread.md +13 -0
  119. package/skills/bugteam/reference/obstacles/fix-test-suite.md +13 -0
  120. package/skills/bugteam/reference/obstacles/fix-violation-count.md +13 -0
  121. package/skills/bugteam/reference/obstacles/fix-write-xml.md +13 -0
  122. package/skills/bugteam/reference/team-setup.md +111 -9
  123. package/skills/bugteam/reference/teardown-publish-permissions.md +39 -8
  124. package/skills/bugteam/scripts/README.md +60 -0
  125. package/skills/bugteam/scripts/_claude_permissions_common.py +358 -0
  126. package/skills/bugteam/scripts/bugteam_code_rules_gate.py +976 -0
  127. package/skills/bugteam/scripts/bugteam_fix_hookspath.py +375 -0
  128. package/skills/bugteam/scripts/bugteam_preflight.py +328 -0
  129. package/skills/bugteam/scripts/config/bugteam_code_rules_gate_constants.py +25 -0
  130. package/skills/bugteam/scripts/config/bugteam_fix_hookspath_constants.py +26 -0
  131. package/skills/bugteam/scripts/config/bugteam_preflight_constants.py +35 -0
  132. package/skills/bugteam/scripts/config/claude_permissions_common_constants.py +20 -0
  133. package/skills/bugteam/scripts/config/probe_code_rules_enforcer_check_constants.py +12 -0
  134. package/skills/bugteam/scripts/config/windows_safe_rmtree_constants.py +7 -0
  135. package/skills/bugteam/scripts/grant_project_claude_permissions.py +175 -0
  136. package/skills/bugteam/scripts/probe_code_rules_enforcer_check.py +107 -0
  137. package/skills/bugteam/scripts/revoke_project_claude_permissions.py +220 -0
  138. package/skills/bugteam/scripts/test__claude_permissions_common.py +112 -0
  139. package/skills/bugteam/scripts/test_bugteam_code_rules_gate.py +400 -0
  140. package/skills/bugteam/scripts/test_bugteam_fix_hookspath.py +384 -0
  141. package/skills/bugteam/scripts/test_bugteam_preflight.py +309 -0
  142. package/skills/bugteam/scripts/test_claude_permissions_common.py +195 -0
  143. package/skills/bugteam/scripts/test_grant_project_claude_permissions.py +55 -0
  144. package/skills/bugteam/scripts/test_probe_code_rules_enforcer_check.py +76 -0
  145. package/skills/bugteam/scripts/test_revoke_project_claude_permissions.py +55 -0
  146. package/skills/bugteam/scripts/test_windows_safe_rmtree.py +108 -0
  147. package/skills/bugteam/scripts/windows_safe_rmtree.py +100 -0
  148. package/skills/bugteam/test_skill_additions.py +1 -11
  149. package/skills/code/SKILL.md +176 -0
  150. package/skills/copilot-review/SKILL.md +16 -0
  151. package/skills/doc-gist/SKILL.md +99 -0
  152. package/skills/doc-gist/references/examples/01-exploration-code-approaches.html +453 -0
  153. package/skills/doc-gist/references/examples/02-exploration-visual-designs.html +515 -0
  154. package/skills/doc-gist/references/examples/03-code-review-pr.html +638 -0
  155. package/skills/doc-gist/references/examples/04-code-understanding.html +491 -0
  156. package/skills/doc-gist/references/examples/05-design-system.html +629 -0
  157. package/skills/doc-gist/references/examples/06-component-variants.html +605 -0
  158. package/skills/doc-gist/references/examples/07-prototype-animation.html +455 -0
  159. package/skills/doc-gist/references/examples/08-prototype-interaction.html +396 -0
  160. package/skills/doc-gist/references/examples/09-slide-deck.html +592 -0
  161. package/skills/doc-gist/references/examples/10-svg-illustrations.html +492 -0
  162. package/skills/doc-gist/references/examples/11-status-report.html +528 -0
  163. package/skills/doc-gist/references/examples/12-incident-report.html +596 -0
  164. package/skills/doc-gist/references/examples/13-flowchart-diagram.html +395 -0
  165. package/skills/doc-gist/references/examples/14-research-feature-explainer.html +381 -0
  166. package/skills/doc-gist/references/examples/15-research-concept-explainer.html +368 -0
  167. package/skills/doc-gist/references/examples/16-implementation-plan.html +702 -0
  168. package/skills/doc-gist/references/examples/17-pr-writeup.html +595 -0
  169. package/skills/doc-gist/references/examples/18-editor-triage-board.html +573 -0
  170. package/skills/doc-gist/references/examples/19-editor-feature-flags.html +663 -0
  171. package/skills/doc-gist/references/examples/20-editor-prompt-tuner.html +722 -0
  172. package/skills/doc-gist/references/examples/README.md +5 -0
  173. package/skills/doc-gist/scripts/config/__init__.py +0 -0
  174. package/skills/doc-gist/scripts/config/gist_upload_constants.py +16 -0
  175. package/skills/doc-gist/scripts/gist_upload.py +177 -0
  176. package/skills/doc-gist/scripts/test_gist_upload.py +51 -0
  177. package/skills/findbugs/SKILL.md +96 -2
  178. package/skills/monitor-open-prs/SKILL.md +14 -32
  179. package/skills/monitor-open-prs/test_skill_contract.py +0 -11
  180. package/skills/pr-consistency-audit/SKILL.md +112 -0
  181. package/skills/pr-consistency-audit/reference/detection-rules.md +96 -0
  182. package/skills/pr-consistency-audit/reference/illustrations.md +78 -0
  183. package/skills/pr-converge/SKILL.md +229 -23
  184. package/skills/pr-converge/config/__init__.py +0 -0
  185. package/skills/pr-converge/config/constants.py +63 -0
  186. package/skills/pr-converge/reference/convergence-gates.md +138 -44
  187. package/skills/pr-converge/reference/examples.md +43 -11
  188. package/skills/pr-converge/reference/fix-protocol.md +6 -5
  189. package/skills/pr-converge/reference/ground-rules.md +5 -3
  190. package/skills/pr-converge/reference/multi-pr-orchestration.md +44 -19
  191. package/skills/pr-converge/reference/obstacles/fix-post-replies.md +13 -0
  192. package/skills/pr-converge/reference/obstacles/fix-publish-summary.md +13 -0
  193. package/skills/pr-converge/reference/obstacles/fix-push.md +13 -0
  194. package/skills/pr-converge/reference/obstacles/fix-read-filelines.md +13 -0
  195. package/skills/pr-converge/reference/obstacles/fix-reset-state.md +13 -0
  196. package/skills/pr-converge/reference/obstacles/fix-resolve-threads.md +13 -0
  197. package/skills/pr-converge/reference/obstacles/fix-spawn-clean-coder.md +13 -0
  198. package/skills/pr-converge/reference/obstacles/fix-stage-commit.md +13 -0
  199. package/skills/pr-converge/reference/obstacles/fix-trigger-bugbot.md +13 -0
  200. package/skills/pr-converge/reference/obstacles/fix-write-test.md +13 -0
  201. package/skills/pr-converge/reference/per-tick.md +107 -31
  202. package/skills/pr-converge/reference/state-schema.md +22 -1
  203. package/skills/pr-converge/reference/stop-conditions.md +9 -7
  204. package/skills/pr-converge/scripts/README.md +34 -46
  205. package/skills/pr-converge/scripts/check_bugbot_ci.py +279 -0
  206. package/skills/pr-converge/scripts/check_convergence.py +497 -0
  207. package/skills/pr-converge/scripts/check_pending_reviews.py +154 -0
  208. package/skills/pr-converge/scripts/config/pr_converge_constants.py +118 -0
  209. package/skills/pr-converge/scripts/fetch_copilot_reviews.py +134 -0
  210. package/skills/pr-converge/scripts/post_fix_reply.py +168 -0
  211. package/skills/pr-converge/scripts/test_check_bugbot_ci.py +312 -0
  212. package/skills/pr-converge/workflows/schedule-wakeup-loop.md +5 -12
  213. package/skills/qbug/SKILL.md +157 -27
  214. package/skills/session-log/SKILL.md +216 -114
  215. package/skills/session-tidy/SKILL.md +1 -1
  216. package/skills/skill-builder/SKILL.md +138 -56
  217. package/skills/skill-builder/references/delegation-map.md +72 -113
  218. package/skills/skill-builder/references/progressive-disclosure.md +122 -0
  219. package/skills/skill-builder/references/self-audit-checklist.md +92 -0
  220. package/skills/skill-builder/references/skill-types.md +228 -0
  221. package/skills/skill-builder/references/thariq-x-post-skills.json +33 -0
  222. package/skills/skill-builder/templates/gap-analysis.md +15 -8
  223. package/skills/skill-builder/workflows/improve-skill.md +86 -57
  224. package/skills/skill-builder/workflows/new-skill.md +80 -168
  225. package/skills/skill-builder/workflows/polish-skill.md +78 -54
  226. package/skills/structure-prompt/SKILL.md +50 -0
  227. package/skills/structure-prompt/reference/adversarial-tuning.md +62 -0
  228. package/skills/structure-prompt/reference/block-classification.md +27 -0
  229. package/skills/structure-prompt/reference/canonical-case.md +48 -0
  230. package/skills/structure-prompt/reference/citation-depth.md +70 -0
  231. package/skills/structure-prompt/reference/cleanup.md +33 -0
  232. package/skills/structure-prompt/reference/constraints.md +33 -0
  233. package/skills/structure-prompt/reference/directives.md +37 -0
  234. package/skills/structure-prompt/reference/examples.md +72 -0
  235. package/skills/structure-prompt/reference/instantiation.md +51 -0
  236. package/skills/structure-prompt/reference/output-contract.md +72 -0
  237. package/skills/structure-prompt/reference/per-category.md +23 -0
  238. package/skills/structure-prompt/reference/persona.md +38 -0
  239. package/skills/structure-prompt/reference/research.md +33 -0
  240. package/skills/structure-prompt/reference/structure.md +28 -0
  241. package/agents/code-standards-agent.md +0 -93
  242. package/agents/groq-coder.md +0 -113
  243. package/agents/plan-executor.md +0 -226
  244. package/agents/project-docs-analyzer.md +0 -53
  245. package/agents/project-structure-organizer-agent.md +0 -72
  246. package/agents/skill-to-agent-converter.md +0 -370
  247. package/agents/skill-writer-agent.md +0 -470
  248. package/agents/user-docs-writer.md +0 -67
  249. package/agents/workflow-visual-documenter.md +0 -82
  250. package/commands/readability-review.md +0 -20
  251. package/hooks/mypy.ini +0 -2
  252. package/hooks/notification/attention_needed_notify.py +0 -71
  253. package/hooks/notification/claude_notification_handler.py +0 -67
  254. package/hooks/notification/notification_utils.py +0 -267
  255. package/hooks/notification/subagent_complete_notify.py +0 -381
  256. package/hooks/notification/test_attention_needed_notify.py +0 -47
  257. package/hooks/notification/test_claude_notification_handler.py +0 -54
  258. package/hooks/notification/test_notification_utils.py +0 -91
  259. package/hooks/notification/test_subagent_complete_notify.py +0 -79
  260. package/scripts/config/groq_bugteam_config.py +0 -230
  261. package/scripts/config/test_groq_bugteam_config.py +0 -83
  262. package/scripts/config/test_spec_implementer_prompt.py +0 -32
  263. package/scripts/groq_bugteam.README.md +0 -131
  264. package/scripts/groq_bugteam.py +0 -647
  265. package/scripts/groq_bugteam_dotenv.py +0 -40
  266. package/scripts/groq_bugteam_spec.py +0 -226
  267. package/scripts/test_groq_bugteam.py +0 -529
  268. package/scripts/test_groq_bugteam_apply_fix_from_spec.py +0 -426
  269. package/scripts/test_groq_bugteam_dotenv.py +0 -66
  270. package/scripts/test_groq_bugteam_spec.py +0 -338
  271. package/skills/bugteam/SKILL_EVALS.md +0 -309
  272. package/skills/dream/SKILL.md +0 -118
  273. package/skills/ingest/SKILL.md +0 -40
  274. package/skills/npm-creator/SKILL.md +0 -187
  275. package/skills/readability-review/SKILL.md +0 -127
  276. package/skills/resume-review/SKILL.md +0 -261
  277. package/skills/rule-audit/SKILL.md +0 -307
  278. package/skills/rule-creator/SKILL.md +0 -150
  279. package/skills/searching-obsidian-vault/SKILL.md +0 -131
  280. package/skills/skill-writer/REFERENCE.md +0 -284
  281. package/skills/skill-writer/SKILL.md +0 -222
  282. package/skills/tdd-team/SKILL.md +0 -128
package/skills/doc-gist/references/examples/10-svg-illustrations.html ADDED
@@ -0,0 +1,492 @@
1
+ <!doctype html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1">
6
+ <title>Background jobs — header illustrations</title>
7
+ <style>
8
+ :root {
9
+ --ivory: #FAF9F5;
10
+ --slate: #141413;
11
+ --clay: #D97757;
12
+ --oat: #E3DACC;
13
+ --olive: #788C5D;
14
+ --gray-150:#F0EEE6;
15
+ --gray-300:#D1CFC5;
16
+ --gray-500:#87867F;
17
+ --gray-700:#3D3D3A;
18
+
19
+ --serif: ui-serif, Georgia, "Times New Roman", serif;
20
+ --sans: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
21
+ --mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
22
+ }
23
+
24
+ * { margin: 0; padding: 0; box-sizing: border-box; }
25
+
26
+ body {
27
+ background: var(--ivory);
28
+ color: var(--slate);
29
+ font-family: var(--sans);
30
+ -webkit-font-smoothing: antialiased;
31
+ padding: 64px 24px 96px;
32
+ }
33
+
34
+ .sheet {
35
+ max-width: 760px;
36
+ margin: 0 auto;
37
+ }
38
+
39
+ header { margin-bottom: 56px; }
40
+
41
+ h1 {
42
+ font-family: var(--serif);
43
+ font-weight: 500;
44
+ font-size: 34px;
45
+ letter-spacing: -0.01em;
46
+ margin-bottom: 10px;
47
+ }
48
+
49
+ .lead {
50
+ font-size: 14px;
51
+ line-height: 1.6;
52
+ color: var(--gray-700);
53
+ max-width: 560px;
54
+ }
55
+
56
+ .meta {
57
+ font-family: var(--mono);
58
+ font-size: 11px;
59
+ color: var(--gray-500);
60
+ margin-top: 18px;
61
+ }
62
+
63
+ /* ---------------------------------------------------------------- */
64
+
65
+ figure {
66
+ margin: 0 0 72px 0;
67
+ }
68
+
69
+ .canvas {
70
+ border: 1px solid var(--gray-300);
71
+ border-radius: 12px;
72
+ overflow: hidden;
73
+ background: var(--ivory);
74
+ }
75
+
76
+ .canvas svg { display: block; width: 100%; height: auto; }
77
+
78
+ figcaption {
79
+ display: flex;
80
+ align-items: baseline;
81
+ justify-content: space-between;
82
+ gap: 24px;
83
+ padding: 18px 4px 0;
84
+ }
85
+
86
+ .cap-text { flex: 1; }
87
+
88
+ .cap-title {
89
+ font-family: var(--serif);
90
+ font-size: 19px;
91
+ font-weight: 500;
92
+ margin-bottom: 4px;
93
+ }
94
+
95
+ .cap-sub {
96
+ font-size: 13px;
97
+ line-height: 1.55;
98
+ color: var(--gray-500);
99
+ }
100
+
101
+ .dl {
102
+ flex-shrink: 0;
103
+ font-family: var(--mono);
104
+ font-size: 11px;
105
+ color: var(--slate);
106
+ background: var(--gray-150);
107
+ border: 1px solid var(--gray-300);
108
+ border-radius: 6px;
109
+ padding: 7px 12px;
110
+ cursor: pointer;
111
+ }
112
+ .dl:hover { background: var(--oat); }
113
+ .dl:active { transform: translateY(1px); }
114
+
115
+ /* ----------------------------------------------------------------
116
+ Palette reference strip
117
+ ---------------------------------------------------------------- */
118
+ .palette {
119
+ border-top: 1px solid var(--gray-300);
120
+ padding-top: 36px;
121
+ margin-top: 8px;
122
+ }
123
+
124
+ .palette h2 {
125
+ font-family: var(--serif);
126
+ font-weight: 500;
127
+ font-size: 19px;
128
+ margin-bottom: 18px;
129
+ }
130
+
131
+ .swatches {
132
+ display: grid;
133
+ grid-template-columns: repeat(auto-fill, minmax(112px, 1fr));
134
+ gap: 10px;
135
+ margin-bottom: 32px;
136
+ }
137
+
138
+ .swatch {
139
+ border: 1px solid var(--gray-300);
140
+ border-radius: 8px;
141
+ overflow: hidden;
142
+ background: #fff;
143
+ }
144
+
145
+ .swatch-chip {
146
+ height: 44px;
147
+ }
148
+
149
+ .swatch-meta {
150
+ padding: 8px 10px 10px;
151
+ }
152
+
153
+ .swatch-name {
154
+ font-size: 12px;
155
+ color: var(--gray-700);
156
+ }
157
+
158
+ .swatch-hex {
159
+ font-family: var(--mono);
160
+ font-size: 10px;
161
+ color: var(--gray-500);
162
+ }
163
+
164
+ .notes {
165
+ font-size: 13px;
166
+ line-height: 1.7;
167
+ color: var(--gray-700);
168
+ list-style: none;
169
+ }
170
+
171
+ .notes li {
172
+ padding-left: 18px;
173
+ position: relative;
174
+ margin-bottom: 6px;
175
+ }
176
+
177
+ .notes li::before {
178
+ content: "";
179
+ position: absolute;
180
+ left: 0;
181
+ top: 0.65em;
182
+ width: 8px;
183
+ height: 1px;
184
+ background: var(--gray-500);
185
+ }
186
+ </style>
187
+ </head>
188
+ <body>
189
+ <div class="sheet">
190
+
191
+ <header>
192
+ <h1>Background jobs — header illustrations</h1>
193
+ <p class="lead">
194
+ Three 720×320 hand-drawn SVGs for the Birchline docs section on
195
+ background jobs. Flat fills, 1.5–2px strokes, palette-locked. Each
196
+ exports standalone via the button below it.
197
+ </p>
198
+ <div class="meta">720 × 320 · inline SVG · no external assets</div>
199
+ </header>
200
+
201
+ <!-- ============================================================
202
+ A — Queue
203
+ ============================================================ -->
204
+ <figure>
205
+ <div class="canvas">
206
+ <svg id="ill-queue" xmlns="http://www.w3.org/2000/svg" width="720" height="320" viewBox="0 0 720 320">
207
+ <defs>
208
+ <style>
209
+ .m { font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace; font-size: 11px; }
210
+ .s { font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 12px; }
211
+ </style>
212
+ <marker id="qa" markerWidth="10" markerHeight="10" refX="8" refY="4" orient="auto" markerUnits="userSpaceOnUse">
213
+ <path d="M0,0 L0,8 L8,4 z" fill="#87867F"/>
214
+ </marker>
215
+ </defs>
216
+
217
+ <rect width="720" height="320" fill="#FAF9F5"/>
218
+
219
+ <!-- queue label -->
220
+ <text x="60" y="96" class="s" fill="#87867F">queue</text>
221
+
222
+ <!-- five job rects -->
223
+ <g>
224
+ <rect x="60" y="110" width="70" height="100" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
225
+ <text x="95" y="164" text-anchor="middle" class="m" fill="#3D3D3A">job 5</text>
226
+
227
+ <rect x="140" y="110" width="70" height="100" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
228
+ <text x="175" y="164" text-anchor="middle" class="m" fill="#3D3D3A">job 4</text>
229
+
230
+ <rect x="220" y="110" width="70" height="100" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
231
+ <text x="255" y="164" text-anchor="middle" class="m" fill="#3D3D3A">job 3</text>
232
+
233
+ <rect x="300" y="110" width="70" height="100" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
234
+ <text x="335" y="164" text-anchor="middle" class="m" fill="#3D3D3A">job 2</text>
235
+
236
+ <!-- head of queue, highlighted -->
237
+ <rect x="380" y="110" width="70" height="100" rx="10" fill="#D97757" stroke="#141413" stroke-width="2"/>
238
+ <text x="415" y="164" text-anchor="middle" class="m" fill="#FAF9F5">job 1</text>
239
+ </g>
240
+
241
+ <!-- arrow to worker -->
242
+ <line x1="458" y1="160" x2="522" y2="160" stroke="#87867F" stroke-width="1.5" marker-end="url(#qa)"/>
243
+
244
+ <!-- worker -->
245
+ <rect x="530" y="90" width="130" height="140" rx="10" fill="#E3DACC" stroke="#141413" stroke-width="2"/>
246
+ <text x="595" y="156" text-anchor="middle" class="m" fill="#141413">worker</text>
247
+ <text x="595" y="172" text-anchor="middle" class="m" fill="#87867F">pool=4</text>
248
+
249
+ <!-- annotations -->
250
+ <text x="415" y="234" text-anchor="middle" class="s" fill="#87867F">next to run</text>
251
+ <text x="60" y="258" class="s" fill="#87867F">Jobs are pulled FIFO; the worker leases one at a time.</text>
252
+ </svg>
253
+ </div>
254
+ <figcaption>
255
+ <div class="cap-text">
256
+ <div class="cap-title">Queue</div>
257
+ <div class="cap-sub">For "How jobs are picked up" — intro page header.</div>
258
+ </div>
259
+ <button class="dl" data-target="ill-queue" data-filename="birchline-jobs-queue.svg">Download SVG</button>
260
+ </figcaption>
261
+ </figure>
262
+
263
+ <!-- ============================================================
264
+ B — Retry with backoff
265
+ ============================================================ -->
266
+ <figure>
267
+ <div class="canvas">
268
+ <svg id="ill-retry" xmlns="http://www.w3.org/2000/svg" width="720" height="320" viewBox="0 0 720 320">
269
+ <defs>
270
+ <style>
271
+ .m { font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace; font-size: 11px; }
272
+ .s { font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 12px; }
273
+ </style>
274
+ </defs>
275
+
276
+ <rect width="720" height="320" fill="#FAF9F5"/>
277
+
278
+ <!-- timeline axis -->
279
+ <line x1="60" y1="190" x2="660" y2="190" stroke="#D1CFC5" stroke-width="1.5"/>
280
+ <text x="60" y="214" class="s" fill="#87867F">t = 0</text>
281
+ <text x="660" y="214" text-anchor="end" class="s" fill="#87867F">time →</text>
282
+
283
+ <!-- attempts: exponential spacing at x = 100, 170, 310, 590 -->
284
+ <!-- attempt 1 (fail) -->
285
+ <circle cx="100" cy="190" r="8" fill="#FAF9F5" stroke="#D97757" stroke-width="2"/>
286
+ <line x1="96" y1="186" x2="104" y2="194" stroke="#D97757" stroke-width="1.5"/>
287
+ <line x1="104" y1="186" x2="96" y2="194" stroke="#D97757" stroke-width="1.5"/>
288
+ <text x="100" y="222" text-anchor="middle" class="m" fill="#3D3D3A">try 1</text>
289
+
290
+ <!-- attempt 2 (fail) -->
291
+ <circle cx="170" cy="190" r="8" fill="#FAF9F5" stroke="#D97757" stroke-width="2"/>
292
+ <line x1="166" y1="186" x2="174" y2="194" stroke="#D97757" stroke-width="1.5"/>
293
+ <line x1="174" y1="186" x2="166" y2="194" stroke="#D97757" stroke-width="1.5"/>
294
+ <text x="170" y="222" text-anchor="middle" class="m" fill="#3D3D3A">try 2</text>
295
+
296
+ <!-- attempt 3 (fail) -->
297
+ <circle cx="310" cy="190" r="8" fill="#FAF9F5" stroke="#D97757" stroke-width="2"/>
298
+ <line x1="306" y1="186" x2="314" y2="194" stroke="#D97757" stroke-width="1.5"/>
299
+ <line x1="314" y1="186" x2="306" y2="194" stroke="#D97757" stroke-width="1.5"/>
300
+ <text x="310" y="222" text-anchor="middle" class="m" fill="#3D3D3A">try 3</text>
301
+
302
+ <!-- attempt 4 (success) -->
303
+ <circle cx="590" cy="190" r="9" fill="#788C5D" stroke="#141413" stroke-width="1.5"/>
304
+ <path d="M585,190 L589,194 L596,185" fill="none" stroke="#FAF9F5" stroke-width="1.5" stroke-linecap="round"/>
305
+ <text x="590" y="222" text-anchor="middle" class="m" fill="#3D3D3A">try 4</text>
306
+
307
+ <!-- dashed backoff arcs (loop back over the gap) -->
308
+ <path d="M 100 182 Q 135 130 170 182" fill="none" stroke="#87867F" stroke-width="1.5" stroke-dasharray="4 4"/>
309
+ <text x="135" y="124" text-anchor="middle" class="m" fill="#87867F">+1s</text>
310
+
311
+ <path d="M 170 182 Q 240 110 310 182" fill="none" stroke="#87867F" stroke-width="1.5" stroke-dasharray="4 4"/>
312
+ <text x="240" y="104" text-anchor="middle" class="m" fill="#87867F">+2s</text>
313
+
314
+ <path d="M 310 182 Q 450 80 590 182" fill="none" stroke="#87867F" stroke-width="1.5" stroke-dasharray="4 4"/>
315
+ <text x="450" y="74" text-anchor="middle" class="m" fill="#87867F">+4s</text>
316
+
317
+ <!-- annotation -->
318
+ <text x="60" y="262" class="s" fill="#87867F">Each failure waits twice as long before re-queuing; jitter not pictured.</text>
319
+ </svg>
320
+ </div>
321
+ <figcaption>
322
+ <div class="cap-text">
323
+ <div class="cap-title">Retry with backoff</div>
324
+ <div class="cap-sub">For "Handling failures" — retry policy header.</div>
325
+ </div>
326
+ <button class="dl" data-target="ill-retry" data-filename="birchline-jobs-retry.svg">Download SVG</button>
327
+ </figcaption>
328
+ </figure>
329
+
330
+ <!-- ============================================================
331
+ C — Fan-out
332
+ ============================================================ -->
333
+ <figure>
334
+ <div class="canvas">
335
+ <svg id="ill-fanout" xmlns="http://www.w3.org/2000/svg" width="720" height="320" viewBox="0 0 720 320">
336
+ <defs>
337
+ <style>
338
+ .m { font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace; font-size: 11px; }
339
+ .s { font-family: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif; font-size: 12px; }
340
+ </style>
341
+ <marker id="fa" markerWidth="9" markerHeight="9" refX="7" refY="3.5" orient="auto" markerUnits="userSpaceOnUse">
342
+ <path d="M0,0 L0,7 L7,3.5 z" fill="#87867F"/>
343
+ </marker>
344
+ </defs>
345
+
346
+ <rect width="720" height="320" fill="#FAF9F5"/>
347
+
348
+ <!-- source -->
349
+ <rect x="60" y="128" width="110" height="64" rx="10" fill="#E3DACC" stroke="#141413" stroke-width="2"/>
350
+ <text x="115" y="158" text-anchor="middle" class="m" fill="#141413">enqueue</text>
351
+ <text x="115" y="172" text-anchor="middle" class="m" fill="#87867F">batch()</text>
352
+
353
+ <!-- fan-out arrows: from (170,160) to four shard boxes at x=300 -->
354
+ <line x1="170" y1="160" x2="296" y2="64" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
355
+ <line x1="170" y1="160" x2="296" y2="128" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
356
+ <line x1="170" y1="160" x2="296" y2="192" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
357
+ <line x1="170" y1="160" x2="296" y2="256" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
358
+
359
+ <!-- four shard boxes -->
360
+ <g>
361
+ <rect x="300" y="44" width="120" height="40" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
362
+ <text x="360" y="69" text-anchor="middle" class="m" fill="#3D3D3A">shard 0</text>
363
+
364
+ <rect x="300" y="108" width="120" height="40" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
365
+ <text x="360" y="133" text-anchor="middle" class="m" fill="#3D3D3A">shard 1</text>
366
+
367
+ <rect x="300" y="172" width="120" height="40" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
368
+ <text x="360" y="197" text-anchor="middle" class="m" fill="#3D3D3A">shard 2</text>
369
+
370
+ <rect x="300" y="236" width="120" height="40" rx="10" fill="#F0EEE6" stroke="#3D3D3A" stroke-width="1.5"/>
371
+ <text x="360" y="261" text-anchor="middle" class="m" fill="#3D3D3A">shard 3</text>
372
+ </g>
373
+
374
+ <!-- converge arrows to merge -->
375
+ <line x1="420" y1="64" x2="546" y2="160" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
376
+ <line x1="420" y1="128" x2="546" y2="160" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
377
+ <line x1="420" y1="192" x2="546" y2="160" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
378
+ <line x1="420" y1="256" x2="546" y2="160" stroke="#87867F" stroke-width="1.5" marker-end="url(#fa)"/>
379
+
380
+ <!-- merge box -->
381
+ <rect x="550" y="128" width="110" height="64" rx="10" fill="#788C5D" stroke="#141413" stroke-width="2"/>
382
+ <text x="605" y="158" text-anchor="middle" class="m" fill="#FAF9F5">merge</text>
383
+ <text x="605" y="172" text-anchor="middle" class="m" fill="#E3DACC">await all</text>
384
+
385
+ <!-- annotations -->
386
+ <text x="232" y="42" class="s" fill="#87867F">fan-out</text>
387
+ <text x="486" y="42" text-anchor="end" class="s" fill="#87867F">fan-in</text>
388
+ <text x="60" y="300" class="s" fill="#87867F">Parent job spawns N children, then blocks on a completion barrier.</text>
389
+ </svg>
390
+ </div>
391
+ <figcaption>
392
+ <div class="cap-text">
393
+ <div class="cap-title">Fan-out / fan-in</div>
394
+ <div class="cap-sub">For "Batch and parallel work" — fan-out pattern header.</div>
395
+ </div>
396
+ <button class="dl" data-target="ill-fanout" data-filename="birchline-jobs-fanout.svg">Download SVG</button>
397
+ </figcaption>
398
+ </figure>
399
+
400
+ <!-- ============================================================
401
+ Palette + usage notes
402
+ ============================================================ -->
403
+ <section class="palette">
404
+ <h2>Palette &amp; rules</h2>
405
+
406
+ <div class="swatches">
407
+ <div class="swatch">
408
+ <div class="swatch-chip" style="background:#FAF9F5"></div>
409
+ <div class="swatch-meta">
410
+ <div class="swatch-name">ivory</div>
411
+ <div class="swatch-hex">#FAF9F5</div>
412
+ </div>
413
+ </div>
414
+ <div class="swatch">
415
+ <div class="swatch-chip" style="background:#141413"></div>
416
+ <div class="swatch-meta">
417
+ <div class="swatch-name">slate</div>
418
+ <div class="swatch-hex">#141413</div>
419
+ </div>
420
+ </div>
421
+ <div class="swatch">
422
+ <div class="swatch-chip" style="background:#D97757"></div>
423
+ <div class="swatch-meta">
424
+ <div class="swatch-name">clay</div>
425
+ <div class="swatch-hex">#D97757</div>
426
+ </div>
427
+ </div>
428
+ <div class="swatch">
429
+ <div class="swatch-chip" style="background:#788C5D"></div>
430
+ <div class="swatch-meta">
431
+ <div class="swatch-name">olive</div>
432
+ <div class="swatch-hex">#788C5D</div>
433
+ </div>
434
+ </div>
435
+ <div class="swatch">
436
+ <div class="swatch-chip" style="background:#E3DACC"></div>
437
+ <div class="swatch-meta">
438
+ <div class="swatch-name">oat</div>
439
+ <div class="swatch-hex">#E3DACC</div>
440
+ </div>
441
+ </div>
442
+ <div class="swatch">
443
+ <div class="swatch-chip" style="background:#F0EEE6"></div>
444
+ <div class="swatch-meta">
445
+ <div class="swatch-name">gray-150</div>
446
+ <div class="swatch-hex">#F0EEE6</div>
447
+ </div>
448
+ </div>
449
+ <div class="swatch">
450
+ <div class="swatch-chip" style="background:#D1CFC5"></div>
451
+ <div class="swatch-meta">
452
+ <div class="swatch-name">gray-300</div>
453
+ <div class="swatch-hex">#D1CFC5</div>
454
+ </div>
455
+ </div>
456
+ <div class="swatch">
457
+ <div class="swatch-chip" style="background:#87867F"></div>
458
+ <div class="swatch-meta">
459
+ <div class="swatch-name">gray-500</div>
460
+ <div class="swatch-hex">#87867F</div>
461
+ </div>
462
+ </div>
463
+ </div>
464
+
465
+ <ul class="notes">
466
+ <li>Strokes are 1.5px for neutral boxes, 2px for emphasised containers.</li>
467
+ <li>All rectangles use <code>rx="10"</code>; no drop shadows or gradients.</li>
468
+ <li>Labels inside boxes are 11px mono; annotations outside are 12px sans, gray-500.</li>
469
+ <li>Clay marks "the thing in focus"; olive marks "success / done".</li>
470
+ <li>Each SVG carries its own <code>&lt;style&gt;</code> block so the download stands alone.</li>
471
+ </ul>
472
+ </section>
473
+
474
+ </div>
475
+
476
+ <script>
477
+ document.querySelectorAll('.dl').forEach(function (btn) {
478
+ btn.addEventListener('click', function () {
479
+ var svg = document.getElementById(btn.dataset.target);
480
+ var src = new XMLSerializer().serializeToString(svg);
481
+ var blob = new Blob([src], { type: 'image/svg+xml;charset=utf-8' });
482
+ var url = URL.createObjectURL(blob);
483
+ var a = document.createElement('a');
484
+ a.href = url;
485
+ a.download = btn.dataset.filename || 'illustration.svg';
486
+ a.click();
487
+ setTimeout(function () { URL.revokeObjectURL(url); }, 1000);
488
+ });
489
+ });
490
+ </script>
491
+ </body>
492
+ </html>