ssqch 0.12.0 → 0.13.1

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 (130) hide show
  1. package/bundled/completions/bash +66 -8
  2. package/bundled/completions/elvish +23 -4
  3. package/bundled/completions/fish +36 -25
  4. package/bundled/completions/powershell +25 -4
  5. package/bundled/completions/zsh +44 -10
  6. package/bundled/docs/agents.md +2 -2
  7. package/bundled/docs/build-summary.md +1 -1
  8. package/bundled/docs/comparing-builds.md +2 -2
  9. package/bundled/docs/configuring.md +3 -6
  10. package/bundled/docs/deploying.md +1 -1
  11. package/bundled/docs/field-guide.md +4 -4
  12. package/bundled/docs/github-pages.md +1 -0
  13. package/bundled/docs/index.md +1 -1
  14. package/bundled/docs/install.md +1 -1
  15. package/bundled/docs/known-gaps.md +1 -1
  16. package/bundled/docs/markdown.md +8 -12
  17. package/bundled/docs/nav.yml +5 -1
  18. package/bundled/docs/netlify.md +4 -2
  19. package/bundled/docs/patrol.md +48 -0
  20. package/bundled/docs/plugins.md +6 -6
  21. package/bundled/docs/robots.md +85 -0
  22. package/bundled/docs/seo.md +2 -38
  23. package/bundled/docs/serving-markdown.md +142 -0
  24. package/bundled/docs/template-languages.md +1 -1
  25. package/bundled/docs/templates.md +1 -1
  26. package/bundled/docs/trailheads/from-hugo.md +5 -3
  27. package/bundled/docs/trailheads/from-jekyll.md +54 -13
  28. package/bundled/docs/trailheads/from-mkdocs.md +15 -12
  29. package/bundled/docs/trailheads/from-vitepress.md +13 -11
  30. package/bundled/docs/trailheads.md +3 -3
  31. package/bundled/docs/where-values-come-from.md +5 -5
  32. package/bundled/docs/writing-plugins.md +69 -0
  33. package/bundled/ssqch.d.ts +118 -44
  34. package/bundled/starter/engines/index.edge +1 -0
  35. package/bundled/starter/engines/index.ejs +1 -0
  36. package/bundled/starter/engines/index.hbs +1 -0
  37. package/bundled/starter/engines/index.liquid +1 -0
  38. package/bundled/starter/engines/layout.edge +7 -0
  39. package/bundled/starter/engines/layout.ejs +4 -0
  40. package/bundled/starter/engines/layout.hbs +4 -0
  41. package/bundled/starter/engines/layout.liquid +4 -0
  42. package/bundled/starter/src/_data/site.json +1 -0
  43. package/bundled/starter/src/_includes/layout.jinja +4 -0
  44. package/bundled/starter/src/index.jinja +1 -0
  45. package/bundled/starter/ssqch.config.js +14 -1
  46. package/bundled/starter-docs/engines/edge/base.edge +7 -0
  47. package/bundled/starter-docs/engines/edge/doc.edge +4 -0
  48. package/bundled/starter-docs/engines/ejs/base.ejs +4 -0
  49. package/bundled/starter-docs/engines/ejs/doc.ejs +4 -0
  50. package/bundled/starter-docs/engines/hbs/base.hbs +4 -0
  51. package/bundled/starter-docs/engines/hbs/doc.hbs +3 -0
  52. package/bundled/starter-docs/engines/liquid/base.liquid +4 -0
  53. package/bundled/starter-docs/engines/liquid/doc.liquid +4 -0
  54. package/bundled/starter-docs/src/_data/site.json +1 -0
  55. package/bundled/starter-docs/src/_includes/base.jinja +4 -0
  56. package/bundled/starter-docs/src/_includes/doc.jinja +4 -0
  57. package/bundled/starter-docs/src/assets/docs.css +4 -0
  58. package/bundled/starter-docs/src/assets/docs.js +17 -0
  59. package/bundled/starter-docs/ssqch.config.js +14 -1
  60. package/lib/assets.js +9 -9
  61. package/lib/chunk-25WERNDD.js +112 -0
  62. package/lib/{chunk-4ZMNLWE4.js → chunk-2BJFGKOE.js} +2 -2
  63. package/lib/{chunk-M2BBE2C3.js → chunk-3ZTRIO6O.js} +18 -17
  64. package/lib/{chunk-57HLSKZS.js → chunk-4AZFCSGJ.js} +2 -2
  65. package/lib/{chunk-ULQHJ4TS.js → chunk-55WXDGO4.js} +3 -3
  66. package/lib/{chunk-JX43SJHU.js → chunk-6FY77I4M.js} +24 -22
  67. package/lib/{chunk-RY3KLUQ3.js → chunk-6OUCRDYI.js} +267 -202
  68. package/lib/{chunk-EVFNYUTR.js → chunk-6U5VIQVY.js} +5 -5
  69. package/lib/{chunk-N3IZ44XY.js → chunk-7U5GWTEH.js} +88 -54
  70. package/lib/{chunk-VTYQ3JKL.js → chunk-AIJNG6MJ.js} +2 -2
  71. package/lib/{chunk-IIBZPHAW.js → chunk-C2Q7JKFI.js} +8 -8
  72. package/lib/{chunk-6CSH757V.js → chunk-DFJFHULZ.js} +33 -8
  73. package/lib/{chunk-XVV7JJK7.js → chunk-ENWDM2RW.js} +40 -39
  74. package/lib/{chunk-JUALMFW3.js → chunk-ER72RPD6.js} +1 -1
  75. package/lib/{chunk-RFREB3SI.js → chunk-F3JPNFCZ.js} +7 -7
  76. package/lib/{chunk-LLOA3QXV.js → chunk-FENJHLNM.js} +3 -2
  77. package/lib/{chunk-UU43WIZG.js → chunk-FJML7INB.js} +4 -2
  78. package/lib/{chunk-IZCF4UH3.js → chunk-FQZDUDFK.js} +1 -1
  79. package/lib/chunk-GM5SHCTU.js +272 -0
  80. package/lib/{chunk-GVHQ37JE.js → chunk-GSNRAGKQ.js} +10 -5
  81. package/lib/{chunk-L2IY4P6O.js → chunk-GU7BBYWB.js} +3 -3
  82. package/lib/{chunk-RGYJQYW3.js → chunk-HDKU6LRI.js} +32 -5
  83. package/lib/{chunk-IQUGLVZY.js → chunk-K5WZ2VYK.js} +4 -4
  84. package/lib/{chunk-JVT5ZRRH.js → chunk-OOKBXQAY.js} +5 -5
  85. package/lib/{chunk-MOLTDO5A.js → chunk-SNQOHNXE.js} +1 -1
  86. package/lib/{chunk-Z3XH4KWX.js → chunk-SPIFZBIW.js} +1 -1
  87. package/lib/{chunk-FNNXRVSU.js → chunk-T5IUI7W7.js} +10 -10
  88. package/lib/{chunk-5HEZ3WUQ.js → chunk-TGSVSG2G.js} +2 -2
  89. package/lib/{chunk-3GROJ3TY.js → chunk-U2KEMVXO.js} +24 -17
  90. package/lib/{chunk-4B3N44SN.js → chunk-UHRBPZ4A.js} +3 -3
  91. package/lib/{chunk-GWWA5Y3X.js → chunk-ULCT3PAV.js} +1 -1
  92. package/lib/{chunk-7RGEWDLF.js → chunk-UZNUS7RP.js} +10 -8
  93. package/lib/{chunk-DZ5F5XSI.js → chunk-V3G2QGL3.js} +10 -105
  94. package/lib/{chunk-DOHOKUGB.js → chunk-VILOEVK7.js} +50 -26
  95. package/lib/{chunk-DXMDXHV7.js → chunk-WGAIE3DD.js} +15 -14
  96. package/lib/{chunk-G3RFQDKO.js → chunk-WUCRAV36.js} +8 -6
  97. package/lib/{chunk-52ROOMBZ.js → chunk-XYAWJTHM.js} +9 -9
  98. package/lib/{chunk-L3K7MMFC.js → chunk-YA23NDMW.js} +2 -2
  99. package/lib/{chunk-R7PBREXL.js → chunk-YNJNMQWU.js} +8 -5
  100. package/lib/{chunk-AK7ZKSZP.js → chunk-ZMG25MXF.js} +17 -16
  101. package/lib/cli.js +56 -34
  102. package/lib/elements.js +9 -9
  103. package/lib/from-hugo.js +36 -0
  104. package/lib/from-jekyll.js +41 -0
  105. package/lib/from-mkdocs.js +49 -0
  106. package/lib/from-vitepress.js +49 -0
  107. package/lib/image.js +10 -10
  108. package/lib/links.js +9 -9
  109. package/lib/llms.js +619 -54
  110. package/lib/minify.js +10 -10
  111. package/lib/redirects.js +9 -9
  112. package/lib/robots.js +87 -0
  113. package/lib/rss.js +22 -12
  114. package/lib/sass.js +10 -10
  115. package/lib/sitemap.js +22 -33
  116. package/lib/ssqch.js +5 -5
  117. package/lib/vue.js +14 -13
  118. package/package.json +21 -1
  119. package/types/from-hugo.d.ts +5 -0
  120. package/types/from-jekyll.d.ts +11 -0
  121. package/types/from-mkdocs.d.ts +11 -0
  122. package/types/from-vitepress.d.ts +5 -0
  123. package/types/index.d.ts +45 -29
  124. package/types/llms.d.ts +18 -8
  125. package/types/robots.d.ts +13 -0
  126. package/types/sass.d.ts +1 -1
  127. package/types/sitemap.d.ts +3 -5
  128. package/wasm/markdown.wasm +0 -0
  129. /package/lib/{chunk-JX43SJHU.js.LEGAL.txt → chunk-6FY77I4M.js.LEGAL.txt} +0 -0
  130. /package/lib/{chunk-R7PBREXL.js.LEGAL.txt → chunk-YNJNMQWU.js.LEGAL.txt} +0 -0
@@ -34,6 +34,9 @@ _ssqch() {
34
34
  ssqch,footprint)
35
35
  cmd="ssqch__subcmd__footprint"
36
36
  ;;
37
+ ssqch,patrol)
38
+ cmd="ssqch__subcmd__patrol"
39
+ ;;
37
40
  ssqch,help)
38
41
  cmd="ssqch__subcmd__help"
39
42
  ;;
@@ -46,8 +49,8 @@ _ssqch() {
46
49
  ssqch,init)
47
50
  cmd="ssqch__subcmd__init"
48
51
  ;;
49
- ssqch,inspect)
50
- cmd="ssqch__subcmd__inspect"
52
+ ssqch,trace)
53
+ cmd="ssqch__subcmd__trace"
51
54
  ;;
52
55
  ssqch,new)
53
56
  cmd="ssqch__subcmd__new"
@@ -76,6 +79,9 @@ _ssqch() {
76
79
  ssqch__subcmd__help,footprint)
77
80
  cmd="ssqch__subcmd__help__subcmd__footprint"
78
81
  ;;
82
+ ssqch__subcmd__help,patrol)
83
+ cmd="ssqch__subcmd__help__subcmd__patrol"
84
+ ;;
79
85
  ssqch__subcmd__help,help)
80
86
  cmd="ssqch__subcmd__help__subcmd__help"
81
87
  ;;
@@ -88,8 +94,8 @@ _ssqch() {
88
94
  ssqch__subcmd__help,init)
89
95
  cmd="ssqch__subcmd__help__subcmd__init"
90
96
  ;;
91
- ssqch__subcmd__help,inspect)
92
- cmd="ssqch__subcmd__help__subcmd__inspect"
97
+ ssqch__subcmd__help,trace)
98
+ cmd="ssqch__subcmd__help__subcmd__trace"
93
99
  ;;
94
100
  ssqch__subcmd__help,new)
95
101
  cmd="ssqch__subcmd__help__subcmd__new"
@@ -107,7 +113,7 @@ _ssqch() {
107
113
 
108
114
  case "${cmd}" in
109
115
  ssqch)
110
- opts="-o -q -v -h -V --root --output --base --offline --env --quiet --verbose --help --version build serve new inspect completions diff footprint init types baseline scout capabilities docs help"
116
+ opts="-o -q -v -h -V --root --output --base --offline --env --quiet --verbose --help --version build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help"
111
117
  if [[ ${cur} == -* || ${COMP_CWORD} -eq 1 ]] ; then
112
118
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
113
119
  return 0
@@ -388,8 +394,46 @@ _ssqch() {
388
394
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
389
395
  return 0
390
396
  ;;
397
+ ssqch__subcmd__patrol)
398
+ opts="-o -q -v -h --format --root --output --base --offline --env --quiet --verbose --help"
399
+ if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
400
+ COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
401
+ return 0
402
+ fi
403
+ case "${prev}" in
404
+ --format)
405
+ COMPREPLY=($(compgen -f "${cur}"))
406
+ return 0
407
+ ;;
408
+ --root)
409
+ COMPREPLY=($(compgen -f "${cur}"))
410
+ return 0
411
+ ;;
412
+ --output)
413
+ COMPREPLY=($(compgen -f "${cur}"))
414
+ return 0
415
+ ;;
416
+ -o)
417
+ COMPREPLY=($(compgen -f "${cur}"))
418
+ return 0
419
+ ;;
420
+ --base)
421
+ COMPREPLY=($(compgen -f "${cur}"))
422
+ return 0
423
+ ;;
424
+ --env)
425
+ COMPREPLY=($(compgen -f "${cur}"))
426
+ return 0
427
+ ;;
428
+ *)
429
+ COMPREPLY=()
430
+ ;;
431
+ esac
432
+ COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
433
+ return 0
434
+ ;;
391
435
  ssqch__subcmd__help)
392
- opts="build serve new inspect completions diff footprint init types baseline scout capabilities docs help"
436
+ opts="build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help"
393
437
  if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
394
438
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
395
439
  return 0
@@ -486,6 +530,20 @@ _ssqch() {
486
530
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
487
531
  return 0
488
532
  ;;
533
+ ssqch__subcmd__help__subcmd__patrol)
534
+ opts=""
535
+ if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
536
+ COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
537
+ return 0
538
+ fi
539
+ case "${prev}" in
540
+ *)
541
+ COMPREPLY=()
542
+ ;;
543
+ esac
544
+ COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
545
+ return 0
546
+ ;;
489
547
  ssqch__subcmd__help__subcmd__help)
490
548
  opts=""
491
549
  if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
@@ -542,7 +600,7 @@ _ssqch() {
542
600
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
543
601
  return 0
544
602
  ;;
545
- ssqch__subcmd__help__subcmd__inspect)
603
+ ssqch__subcmd__help__subcmd__trace)
546
604
  opts=""
547
605
  if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
548
606
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
@@ -696,7 +754,7 @@ _ssqch() {
696
754
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
697
755
  return 0
698
756
  ;;
699
- ssqch__subcmd__inspect)
757
+ ssqch__subcmd__trace)
700
758
  opts="-o -q -v -h --field --format --root --output --base --offline --env --quiet --verbose --help"
701
759
  if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
702
760
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
@@ -35,10 +35,11 @@ set edit:completion:arg-completer[ssqch] = {|@words|
35
35
  cand build 'Build the site (default)'
36
36
  cand serve 'Build, serve, watch for changes and live-reload the browser'
37
37
  cand new 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
38
- cand inspect 'Show where a page comes from, and which level of the data cascade set each value'
38
+ cand trace 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value'
39
39
  cand completions 'Print a completion script for your shell, so Tab finishes commands and options'
40
40
  cand diff 'Compare two builds of a site: URLs added and removed, and what changed on each page'
41
41
  cand footprint 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
42
+ cand patrol 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
42
43
  cand init 'Create a starter site (config, layout, five posts, data and editor types)'
43
44
  cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
44
45
  cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
@@ -100,7 +101,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
100
101
  cand -h 'Print help'
101
102
  cand --help 'Print help'
102
103
  }
103
- &'ssqch;inspect'= {
104
+ &'ssqch;trace'= {
104
105
  cand --field 'One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)'
105
106
  cand --format 'text or json'
106
107
  cand --root 'Project root (defaults to the current directory)'
@@ -168,6 +169,21 @@ set edit:completion:arg-completer[ssqch] = {|@words|
168
169
  cand -h 'Print help'
169
170
  cand --help 'Print help'
170
171
  }
172
+ &'ssqch;patrol'= {
173
+ cand --format 'text or json'
174
+ cand --root 'Project root (defaults to the current directory)'
175
+ cand -o 'Override the output directory (relative to the root)'
176
+ cand --output 'Override the output directory (relative to the root)'
177
+ cand --base 'Serve the site under a path, like /repo/ (overrides the config''s `base`)'
178
+ cand --env 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)'
179
+ cand --offline 'Don''t use the network: `fetch()` answers from the copies its `cache` option saved'
180
+ cand -q 'Print only warnings and errors'
181
+ cand --quiet 'Print only warnings and errors'
182
+ cand -v 'Also list the slowest images to encode'
183
+ cand --verbose 'Also list the slowest images to encode'
184
+ cand -h 'Print help'
185
+ cand --help 'Print help'
186
+ }
171
187
  &'ssqch;init'= {
172
188
  cand --starter 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)'
173
189
  cand --engine 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs'
@@ -258,10 +274,11 @@ set edit:completion:arg-completer[ssqch] = {|@words|
258
274
  cand build 'Build the site (default)'
259
275
  cand serve 'Build, serve, watch for changes and live-reload the browser'
260
276
  cand new 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
261
- cand inspect 'Show where a page comes from, and which level of the data cascade set each value'
277
+ cand trace 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value'
262
278
  cand completions 'Print a completion script for your shell, so Tab finishes commands and options'
263
279
  cand diff 'Compare two builds of a site: URLs added and removed, and what changed on each page'
264
280
  cand footprint 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
281
+ cand patrol 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
265
282
  cand init 'Create a starter site (config, layout, five posts, data and editor types)'
266
283
  cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
267
284
  cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
@@ -276,7 +293,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
276
293
  }
277
294
  &'ssqch;help;new'= {
278
295
  }
279
- &'ssqch;help;inspect'= {
296
+ &'ssqch;help;trace'= {
280
297
  }
281
298
  &'ssqch;help;completions'= {
282
299
  }
@@ -284,6 +301,8 @@ set edit:completion:arg-completer[ssqch] = {|@words|
284
301
  }
285
302
  &'ssqch;help;footprint'= {
286
303
  }
304
+ &'ssqch;help;patrol'= {
305
+ }
287
306
  &'ssqch;help;init'= {
288
307
  }
289
308
  &'ssqch;help;types'= {
@@ -36,10 +36,11 @@ complete -c ssqch -n "__fish_ssqch_needs_command" -s V -l version -d 'Print vers
36
36
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "build" -d 'Build the site (default)'
37
37
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "serve" -d 'Build, serve, watch for changes and live-reload the browser'
38
38
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "new" -d 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
39
- complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "inspect" -d 'Show where a page comes from, and which level of the data cascade set each value'
39
+ complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "trace" -d 'Follow a page\'s tracks: where it comes from, and which level of the data cascade set each value'
40
40
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "completions" -d 'Print a completion script for your shell, so Tab finishes commands and options'
41
41
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "diff" -d 'Compare two builds of a site: URLs added and removed, and what changed on each page'
42
42
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "footprint" -d 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
43
+ complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "patrol" -d 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
43
44
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "init" -d 'Create a starter site (config, layout, five posts, data and editor types)'
44
45
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "types" -d 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
45
46
  complete -c ssqch -n "__fish_ssqch_needs_command" -f -a "baseline" -d 'Build the site with its old generator in fresh copies and compare the builds'
@@ -81,16 +82,16 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand new" -l offline -d 'Don\'t u
81
82
  complete -c ssqch -n "__fish_ssqch_using_subcommand new" -s q -l quiet -d 'Print only warnings and errors'
82
83
  complete -c ssqch -n "__fish_ssqch_using_subcommand new" -s v -l verbose -d 'Also list the slowest images to encode'
83
84
  complete -c ssqch -n "__fish_ssqch_using_subcommand new" -s h -l help -d 'Print help'
84
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -l field -d 'One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)' -r
85
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -l format -d 'text or json' -r
86
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -l root -d 'Project root (defaults to the current directory)' -r -F
87
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
88
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
89
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -l env -d 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)' -r
90
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -l offline -d 'Don\'t use the network: `fetch()` answers from the copies its `cache` option saved'
91
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -s q -l quiet -d 'Print only warnings and errors'
92
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -s v -l verbose -d 'Also list the slowest images to encode'
93
- complete -c ssqch -n "__fish_ssqch_using_subcommand inspect" -s h -l help -d 'Print help'
85
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l field -d 'One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)' -r
86
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l format -d 'text or json' -r
87
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l root -d 'Project root (defaults to the current directory)' -r -F
88
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
89
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
90
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l env -d 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)' -r
91
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -l offline -d 'Don\'t use the network: `fetch()` answers from the copies its `cache` option saved'
92
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s q -l quiet -d 'Print only warnings and errors'
93
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s v -l verbose -d 'Also list the slowest images to encode'
94
+ complete -c ssqch -n "__fish_ssqch_using_subcommand trace" -s h -l help -d 'Print help'
94
95
  complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -l root -d 'Project root (defaults to the current directory)' -r -F
95
96
  complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
96
97
  complete -c ssqch -n "__fish_ssqch_using_subcommand completions" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
@@ -117,14 +118,23 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s v -l verbose -d 'Al
117
118
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s h -l help -d 'Print help'
118
119
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l top -d 'How many of the heaviest pages and files to list (0 for none)' -r
119
120
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l format -d 'text or json' -r
121
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l format -d 'text or json' -r
120
122
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l root -d 'Project root (defaults to the current directory)' -r -F
123
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l root -d 'Project root (defaults to the current directory)' -r -F
121
124
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
125
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s o -l output -d 'Override the output directory (relative to the root)' -r -F
122
126
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
127
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l base -d 'Serve the site under a path, like /repo/ (overrides the config\'s `base`)' -r
123
128
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l env -d 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)' -r
129
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l env -d 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)' -r
124
130
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -l offline -d 'Don\'t use the network: `fetch()` answers from the copies its `cache` option saved'
131
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -l offline -d 'Don\'t use the network: `fetch()` answers from the copies its `cache` option saved'
125
132
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s q -l quiet -d 'Print only warnings and errors'
133
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s q -l quiet -d 'Print only warnings and errors'
126
134
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s v -l verbose -d 'Also list the slowest images to encode'
135
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s v -l verbose -d 'Also list the slowest images to encode'
127
136
  complete -c ssqch -n "__fish_ssqch_using_subcommand footprint" -s h -l help -d 'Print help'
137
+ complete -c ssqch -n "__fish_ssqch_using_subcommand patrol" -s h -l help -d 'Print help'
128
138
  complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l starter -d 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)' -r
129
139
  complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l engine -d 'The template language for the starter\'s layouts and templates: jinja, njk, edge, liquid, hbs or ejs' -r
130
140
  complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l root -d 'Project root (defaults to the current directory)' -r -F
@@ -180,17 +190,18 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -l offline -d 'Don\'t
180
190
  complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s q -l quiet -d 'Print only warnings and errors'
181
191
  complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s v -l verbose -d 'Also list the slowest images to encode'
182
192
  complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s h -l help -d 'Print help'
183
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "build" -d 'Build the site (default)'
184
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "serve" -d 'Build, serve, watch for changes and live-reload the browser'
185
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "new" -d 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
186
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "inspect" -d 'Show where a page comes from, and which level of the data cascade set each value'
187
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "completions" -d 'Print a completion script for your shell, so Tab finishes commands and options'
188
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "diff" -d 'Compare two builds of a site: URLs added and removed, and what changed on each page'
189
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "footprint" -d 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
190
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "init" -d 'Create a starter site (config, layout, five posts, data and editor types)'
191
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "types" -d 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
192
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "baseline" -d 'Build the site with its old generator in fresh copies and compare the builds'
193
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "scout" -d 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move'
194
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "capabilities" -d 'Say what this binary supports: template languages, modules, config options and optional features'
195
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "docs" -d 'Read the documentation for this version: a command, config option, function or topic'
196
- complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new inspect completions diff footprint init types baseline scout capabilities docs help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
193
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "build" -d 'Build the site (default)'
194
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "serve" -d 'Build, serve, watch for changes and live-reload the browser'
195
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "new" -d 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
196
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "trace" -d 'Follow a page\'s tracks: where it comes from, and which level of the data cascade set each value'
197
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "completions" -d 'Print a completion script for your shell, so Tab finishes commands and options'
198
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "diff" -d 'Compare two builds of a site: URLs added and removed, and what changed on each page'
199
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "footprint" -d 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
200
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "patrol" -d 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions'
201
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "init" -d 'Create a starter site (config, layout, five posts, data and editor types)'
202
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "types" -d 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
203
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "baseline" -d 'Build the site with its old generator in fresh copies and compare the builds'
204
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "scout" -d 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move'
205
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "capabilities" -d 'Say what this binary supports: template languages, modules, config options and optional features'
206
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "docs" -d 'Read the documentation for this version: a command, config option, function or topic'
207
+ complete -c ssqch -n "__fish_ssqch_using_subcommand help; and not __fish_seen_subcommand_from build serve new trace completions diff footprint patrol init types baseline scout capabilities docs help" -f -a "help" -d 'Print this message or the help of the given subcommand(s)'
@@ -38,10 +38,11 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
38
38
  [CompletionResult]::new('build', 'build', [CompletionResultType]::ParameterValue, 'Build the site (default)')
39
39
  [CompletionResult]::new('serve', 'serve', [CompletionResultType]::ParameterValue, 'Build, serve, watch for changes and live-reload the browser')
40
40
  [CompletionResult]::new('new', 'new', [CompletionResultType]::ParameterValue, 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in')
41
- [CompletionResult]::new('inspect', 'inspect', [CompletionResultType]::ParameterValue, 'Show where a page comes from, and which level of the data cascade set each value')
41
+ [CompletionResult]::new('trace', 'trace', [CompletionResultType]::ParameterValue, 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value')
42
42
  [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a completion script for your shell, so Tab finishes commands and options')
43
43
  [CompletionResult]::new('diff', 'diff', [CompletionResultType]::ParameterValue, 'Compare two builds of a site: URLs added and removed, and what changed on each page')
44
44
  [CompletionResult]::new('footprint', 'footprint', [CompletionResultType]::ParameterValue, 'Show how much a build weighs: its files by kind, and the heaviest pages and files')
45
+ [CompletionResult]::new('patrol', 'patrol', [CompletionResultType]::ParameterValue, 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions')
45
46
  [CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
46
47
  [CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
47
48
  [CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
@@ -107,7 +108,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
107
108
  [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
108
109
  break
109
110
  }
110
- 'ssqch;inspect' {
111
+ 'ssqch;trace' {
111
112
  [CompletionResult]::new('--field', '--field', [CompletionResultType]::ParameterName, 'One field of its data, in full, with every level that set it (a dotted path reaches inside: hero.alt)')
112
113
  [CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
113
114
  [CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
@@ -179,6 +180,22 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
179
180
  [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
180
181
  break
181
182
  }
183
+ 'ssqch;patrol' {
184
+ [CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
185
+ [CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
186
+ [CompletionResult]::new('-o', '-o', [CompletionResultType]::ParameterName, 'Override the output directory (relative to the root)')
187
+ [CompletionResult]::new('--output', '--output', [CompletionResultType]::ParameterName, 'Override the output directory (relative to the root)')
188
+ [CompletionResult]::new('--base', '--base', [CompletionResultType]::ParameterName, 'Serve the site under a path, like /repo/ (overrides the config''s `base`)')
189
+ [CompletionResult]::new('--env', '--env', [CompletionResultType]::ParameterName, 'development or production (default: $SSQCH_ENV, $NODE_ENV, then production for `build` and development for `serve`)')
190
+ [CompletionResult]::new('--offline', '--offline', [CompletionResultType]::ParameterName, 'Don''t use the network: `fetch()` answers from the copies its `cache` option saved')
191
+ [CompletionResult]::new('-q', '-q', [CompletionResultType]::ParameterName, 'Print only warnings and errors')
192
+ [CompletionResult]::new('--quiet', '--quiet', [CompletionResultType]::ParameterName, 'Print only warnings and errors')
193
+ [CompletionResult]::new('-v', '-v', [CompletionResultType]::ParameterName, 'Also list the slowest images to encode')
194
+ [CompletionResult]::new('--verbose', '--verbose', [CompletionResultType]::ParameterName, 'Also list the slowest images to encode')
195
+ [CompletionResult]::new('-h', '-h', [CompletionResultType]::ParameterName, 'Print help')
196
+ [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
197
+ break
198
+ }
182
199
  'ssqch;init' {
183
200
  [CompletionResult]::new('--starter', '--starter', [CompletionResultType]::ParameterName, 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)')
184
201
  [CompletionResult]::new('--engine', '--engine', [CompletionResultType]::ParameterName, 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs')
@@ -275,10 +292,11 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
275
292
  [CompletionResult]::new('build', 'build', [CompletionResultType]::ParameterValue, 'Build the site (default)')
276
293
  [CompletionResult]::new('serve', 'serve', [CompletionResultType]::ParameterValue, 'Build, serve, watch for changes and live-reload the browser')
277
294
  [CompletionResult]::new('new', 'new', [CompletionResultType]::ParameterValue, 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in')
278
- [CompletionResult]::new('inspect', 'inspect', [CompletionResultType]::ParameterValue, 'Show where a page comes from, and which level of the data cascade set each value')
295
+ [CompletionResult]::new('trace', 'trace', [CompletionResultType]::ParameterValue, 'Follow a page''s tracks: where it comes from, and which level of the data cascade set each value')
279
296
  [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a completion script for your shell, so Tab finishes commands and options')
280
297
  [CompletionResult]::new('diff', 'diff', [CompletionResultType]::ParameterValue, 'Compare two builds of a site: URLs added and removed, and what changed on each page')
281
298
  [CompletionResult]::new('footprint', 'footprint', [CompletionResultType]::ParameterValue, 'Show how much a build weighs: its files by kind, and the heaviest pages and files')
299
+ [CompletionResult]::new('patrol', 'patrol', [CompletionResultType]::ParameterValue, 'Check a build for what agents and crawlers read: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions')
282
300
  [CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
283
301
  [CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
284
302
  [CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
@@ -297,7 +315,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
297
315
  'ssqch;help;new' {
298
316
  break
299
317
  }
300
- 'ssqch;help;inspect' {
318
+ 'ssqch;help;trace' {
301
319
  break
302
320
  }
303
321
  'ssqch;help;completions' {
@@ -309,6 +327,9 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
309
327
  'ssqch;help;footprint' {
310
328
  break
311
329
  }
330
+ 'ssqch;help;patrol' {
331
+ break
332
+ }
312
333
  'ssqch;help;init' {
313
334
  break
314
335
  }
@@ -98,7 +98,7 @@ _arguments "${_arguments_options[@]}" : \
98
98
  ':path -- The new file, from the input folder (posts/pine-cones.md), or a folder, with --title:_default' \
99
99
  && ret=0
100
100
  ;;
101
- (inspect)
101
+ (trace)
102
102
  _arguments "${_arguments_options[@]}" : \
103
103
  '--field=[One field of its data, in full, with every level that set it (a dotted path reaches inside\: hero.alt)]:NAME:_default' \
104
104
  '--format=[text or json]:FORMAT:_default' \
@@ -179,6 +179,24 @@ _arguments "${_arguments_options[@]}" : \
179
179
  '::dir -- The build folder (default\: the site'\''s output folder):_files' \
180
180
  && ret=0
181
181
  ;;
182
+ (patrol)
183
+ _arguments "${_arguments_options[@]}" : \
184
+ '--format=[text or json]:FORMAT:_default' \
185
+ '--root=[Project root (defaults to the current directory)]:ROOT:_files' \
186
+ '-o+[Override the output directory (relative to the root)]:OUTPUT:_files' \
187
+ '--output=[Override the output directory (relative to the root)]:OUTPUT:_files' \
188
+ '--base=[Serve the site under a path, like /repo/ (overrides the config'\''s \`base\`)]:BASE:_default' \
189
+ '--env=[development or production (default\: \$SSQCH_ENV, \$NODE_ENV, then production for \`build\` and development for \`serve\`)]:ENV:_default' \
190
+ '--offline[Don'\''t use the network\: \`fetch()\` answers from the copies its \`cache\` option saved]' \
191
+ '-q[Print only warnings and errors]' \
192
+ '--quiet[Print only warnings and errors]' \
193
+ '-v[Also list the slowest images to encode]' \
194
+ '--verbose[Also list the slowest images to encode]' \
195
+ '-h[Print help]' \
196
+ '--help[Print help]' \
197
+ '::dir -- The build folder (default\: the site'\''s output folder):_files' \
198
+ && ret=0
199
+ ;;
182
200
  (init)
183
201
  _arguments "${_arguments_options[@]}" : \
184
202
  '--starter=[What to start with\: site (a small blog) or docs (documentation with a sidebar, tabs and search)]:NAME:_default' \
@@ -305,7 +323,7 @@ _arguments "${_arguments_options[@]}" : \
305
323
  _arguments "${_arguments_options[@]}" : \
306
324
  && ret=0
307
325
  ;;
308
- (inspect)
326
+ (trace)
309
327
  _arguments "${_arguments_options[@]}" : \
310
328
  && ret=0
311
329
  ;;
@@ -321,6 +339,10 @@ _arguments "${_arguments_options[@]}" : \
321
339
  _arguments "${_arguments_options[@]}" : \
322
340
  && ret=0
323
341
  ;;
342
+ (patrol)
343
+ _arguments "${_arguments_options[@]}" : \
344
+ && ret=0
345
+ ;;
324
346
  (init)
325
347
  _arguments "${_arguments_options[@]}" : \
326
348
  && ret=0
@@ -360,10 +382,11 @@ _ssqch_commands() {
360
382
  'build:Build the site (default)' \
361
383
  'serve:Build, serve, watch for changes and live-reload the browser' \
362
384
  'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
363
- 'inspect:Show where a page comes from, and which level of the data cascade set each value' \
385
+ 'trace:Follow a page'\''s tracks\: where it comes from, and which level of the data cascade set each value' \
364
386
  'completions:Print a completion script for your shell, so Tab finishes commands and options' \
365
387
  'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
366
388
  'footprint:Show how much a build weighs\: its files by kind, and the heaviest pages and files' \
389
+ 'patrol:Check a build for what agents and crawlers read\: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions' \
367
390
  'init:Create a starter site (config, layout, five posts, data and editor types)' \
368
391
  'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
369
392
  'baseline:Build the site with its old generator in fresh copies and compare the builds' \
@@ -404,16 +427,22 @@ _ssqch__subcmd__footprint_commands() {
404
427
  local commands; commands=()
405
428
  _describe -t commands 'ssqch footprint commands' commands "$@"
406
429
  }
430
+ (( $+functions[_ssqch__subcmd__patrol_commands] )) ||
431
+ _ssqch__subcmd__patrol_commands() {
432
+ local commands; commands=()
433
+ _describe -t commands 'ssqch patrol commands' commands "$@"
434
+ }
407
435
  (( $+functions[_ssqch__subcmd__help_commands] )) ||
408
436
  _ssqch__subcmd__help_commands() {
409
437
  local commands; commands=(
410
438
  'build:Build the site (default)' \
411
439
  'serve:Build, serve, watch for changes and live-reload the browser' \
412
440
  'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
413
- 'inspect:Show where a page comes from, and which level of the data cascade set each value' \
441
+ 'trace:Follow a page'\''s tracks\: where it comes from, and which level of the data cascade set each value' \
414
442
  'completions:Print a completion script for your shell, so Tab finishes commands and options' \
415
443
  'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
416
444
  'footprint:Show how much a build weighs\: its files by kind, and the heaviest pages and files' \
445
+ 'patrol:Check a build for what agents and crawlers read\: robots.txt, the sitemap, llms.txt, Markdown copies, headings and descriptions' \
417
446
  'init:Create a starter site (config, layout, five posts, data and editor types)' \
418
447
  'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
419
448
  'baseline:Build the site with its old generator in fresh copies and compare the builds' \
@@ -454,6 +483,11 @@ _ssqch__subcmd__help__subcmd__footprint_commands() {
454
483
  local commands; commands=()
455
484
  _describe -t commands 'ssqch help footprint commands' commands "$@"
456
485
  }
486
+ (( $+functions[_ssqch__subcmd__help__subcmd__patrol_commands] )) ||
487
+ _ssqch__subcmd__help__subcmd__patrol_commands() {
488
+ local commands; commands=()
489
+ _describe -t commands 'ssqch help patrol commands' commands "$@"
490
+ }
457
491
  (( $+functions[_ssqch__subcmd__help__subcmd__help_commands] )) ||
458
492
  _ssqch__subcmd__help__subcmd__help_commands() {
459
493
  local commands; commands=()
@@ -469,10 +503,10 @@ _ssqch__subcmd__help__subcmd__init_commands() {
469
503
  local commands; commands=()
470
504
  _describe -t commands 'ssqch help init commands' commands "$@"
471
505
  }
472
- (( $+functions[_ssqch__subcmd__help__subcmd__inspect_commands] )) ||
473
- _ssqch__subcmd__help__subcmd__inspect_commands() {
506
+ (( $+functions[_ssqch__subcmd__help__subcmd__trace_commands] )) ||
507
+ _ssqch__subcmd__help__subcmd__trace_commands() {
474
508
  local commands; commands=()
475
- _describe -t commands 'ssqch help inspect commands' commands "$@"
509
+ _describe -t commands 'ssqch help trace commands' commands "$@"
476
510
  }
477
511
  (( $+functions[_ssqch__subcmd__help__subcmd__new_commands] )) ||
478
512
  _ssqch__subcmd__help__subcmd__new_commands() {
@@ -504,10 +538,10 @@ _ssqch__subcmd__init_commands() {
504
538
  local commands; commands=()
505
539
  _describe -t commands 'ssqch init commands' commands "$@"
506
540
  }
507
- (( $+functions[_ssqch__subcmd__inspect_commands] )) ||
508
- _ssqch__subcmd__inspect_commands() {
541
+ (( $+functions[_ssqch__subcmd__trace_commands] )) ||
542
+ _ssqch__subcmd__trace_commands() {
509
543
  local commands; commands=()
510
- _describe -t commands 'ssqch inspect commands' commands "$@"
544
+ _describe -t commands 'ssqch trace commands' commands "$@"
511
545
  }
512
546
  (( $+functions[_ssqch__subcmd__new_commands] )) ||
513
547
  _ssqch__subcmd__new_commands() {
@@ -67,7 +67,7 @@ ssqch serve --port 0 --ready-file .cache/ready.json &
67
67
 
68
68
  `ok` is whether that first build worked (the server keeps running either way, and rebuilds when a file changes). The file is deleted when the server starts, so one from an earlier run never counts, and it's written again when a changed config loads, since `output` and `base` can change with it.
69
69
 
70
- The other commands with JSON are [`ssqch inspect --format json`](where-values-come-from.md) (where a page's data came from) and [`ssqch diff --format json`](comparing-builds.md) (what a change did to the output; it exits with 0, 1 or 2 like `diff`).
70
+ The other commands with JSON are [`ssqch trace --format json`](where-values-come-from.md) (where a page's data came from) and [`ssqch diff --format json`](comparing-builds.md) (what a change did to the output; it exits with 0, 1 or 2 like `diff`).
71
71
 
72
72
  ## Moving a site with an agent
73
73
 
@@ -76,6 +76,6 @@ Every move from another generator so far ran the same loop: build the old site,
76
76
  1. **Reference builds you can trust.** `ssqch baseline "<old build command>"` builds the old site with its own generator three times, each in a fresh copy with every file's time pinned and `TZ=UTC`, into `.cache/ssqch/baseline/ref-1` to `-3`, and names what changes by itself (the build's time, ids from `Math.random()`): pin it, or note an `--ignore` pattern for it, before anything else. After the move's first commit, build the commit before it: `--commit <rev>`. When builds vary, run more of them (`--runs 20`): the summary counts how many builds agree on each file and names the one most like the others, and `.cache/ssqch/baseline/ref-common` has each file's most common version, which is the one to compare with. A commit that needs a fix to build at all takes `--patch fix.patch`; a tool that won't follow a link out of its folder (Hugo's `js.Build`) takes `--copy-installs` (a `hugo` command gets it by itself). Watch the first build's warnings: GitHub Pages' placeholder `github.com/pages/...` URLs mean the reference build is wrong on every page.
77
77
  2. **What the move takes.** `ssqch scout` finds the old generator and lists what the site uses that needs doing, each with its file and line and ssqch's way to do it (or "not in ssqch yet"), with the `ssqch baseline` command for step 1; `--format json` has it as data. `--write-draft` writes the config draft and the other new files, and `--patch move.patch` writes the mechanical edits as a patch to read and `git apply`. Run it again at any point to see what's left. `ssqch docs --from <generator>` has that generator's words with ssqch's for each, and its trailhead.
78
78
  3. **A build that works.** Build into an empty folder (files an earlier build left count as differences): `rm -rf dist && TZ=UTC ssqch build --format json`, until `ok` is true. Each error has a `code`, a `file` and a `line`.
79
- 4. **The biggest group first.** `ssqch diff .cache/ssqch/baseline/ref-1 dist --format json --lines 0` lists the changes on more than one file as `groups`, the most files first. One cause (a filter that formats dates another way, a layout that lost a `<meta>`) is often hundreds of pages, and fixing it shows what's under it. Each change on a page says which heading it's under (`@ under #its-id`, or `at` in the JSON), to find it in the source, and the notes call out what moves a reader: a changed `<title>`, canonical link or redirect, ids that links point at, and a feed's entries. Build and compare again after each fix. What browsers read the same (attribute order, quotes, entities, `<br/>`), fingerprints and image ids don't count, so what's left is a real difference.
79
+ 4. **The biggest group first.** `ssqch diff .cache/ssqch/baseline/ref-1 dist --format json --lines 0` lists the changes on more than one file as `groups`, the most files first. One cause (a filter that formats dates another way, a layout that lost a `<meta>`) is often hundreds of pages, and fixing it shows what's under it. Each change on a page says which heading it's under (`@ under #its-id`, or `at` in the JSON), to find it in the source, and the notes call out what moves a reader: a changed `<title>`, canonical link or redirect, ids that links point at, and a feed's entries. Build and compare again after each fix. What browsers read the same (attribute order, quotes, entities, percent-encoding in URLs, `<br/>`), fingerprints and image ids don't count, so what's left is a real difference.
80
80
  5. **Done is a decision.** Stop at `No differences`, or when what's left is on purpose: write each one down with why (an `--ignore` pattern with a comment, or a line in the move's notes). `ssqch diff --exact` shows the bytes that still differ, such as a minifier's.
81
81
  6. **Then ssqch's own features,** one at a time (its Markdown, highlighting, minifying, `toc()`), with a diff after each, so every change in the output has one cause.
@@ -13,7 +13,7 @@ Built in 110 ms (production)
13
13
  Time setup 1.11 ms, data 1.31 ms, read 32.3 ms, paginate 2.81 ms, render 7.56 ms, write 55.9 ms, copy 193 µs, after 9.21 ms
14
14
  ```
15
15
 
16
- - **The first line** is `First confirmed siting. Built in ...` for a site's first build (there's no `.cache/ssqch/output-files.json` yet), which is every build on a CI machine that doesn't keep `.cache`.
16
+ - **The first line** is `First confirmed sighting. Built in ...` for a site's first build (there's no `.cache/ssqch/output-files.json` yet), which is every build on a CI machine that doesn't keep `.cache`.
17
17
  - **Pages** also says what's different from the last build to that folder: `(2 new, 1 gone)` when a page appeared or stopped being written (a post you added, a permalink you changed), and `(3 changed)` in `ssqch serve`, which leaves a page alone when it comes out the same.
18
18
  - **Drafts** is in production builds that left `draft: true` pages out: `Drafts 3 unconfirmed (built in development only)`, or `3 left out` when the report's themed line is another one.
19
19
  - **Removed** is the stale files `leaveNoTrace` deleted: `Removed 2 stale files, left no trace`, or just `2 stale files`.
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Comparing two builds"
2
+ title: "Has the stump moved? Comparing two builds"
3
3
  description: "A build that succeeds isn't proof that an upgrade, a refactor or a migration left the site alone."
4
4
  ---
5
5
  <img align="right" src="../../../docs/assets/stickers/footprint.svg" alt="" width="96">
@@ -15,7 +15,7 @@ ssqch diff dist-before dist
15
15
 
16
16
  ```text
17
17
  Comparing dist-before with dist
18
- Ignoring asset fingerprints, image ids, integrity hashes, the generator's version, Vue's and Astro's scope ids and fragment markers, whitespace between tags, and how tags are written where browsers read them the same (attribute order, quotes, entities, `<br/>`) (--exact compares bytes).
18
+ Ignoring asset fingerprints, image ids, integrity hashes, the generator's version, Vue's and Astro's scope ids and fragment markers, whitespace between tags, and how tags are written where browsers read them the same (attribute order, quotes, entities, percent-encoding in URLs, `<br/>`) (--exact compares bytes).
19
19
 
20
20
  Added (1)
21
21
  + /trails/cedar/