ssqch 0.11.0 → 0.13.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 (138) hide show
  1. package/bundled/completions/bash +67 -9
  2. package/bundled/completions/elvish +24 -4
  3. package/bundled/completions/fish +37 -25
  4. package/bundled/completions/powershell +26 -4
  5. package/bundled/completions/zsh +45 -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 +7 -4
  9. package/bundled/docs/configuring.md +7 -12
  10. package/bundled/docs/deploying.md +1 -1
  11. package/bundled/docs/field-guide.md +4 -4
  12. package/bundled/docs/github-pages.md +2 -1
  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 +11 -13
  17. package/bundled/docs/nav.yml +6 -1
  18. package/bundled/docs/netlify.md +4 -2
  19. package/bundled/docs/patrol.md +48 -0
  20. package/bundled/docs/plugins.md +6 -4
  21. package/bundled/docs/robots.md +72 -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 +2 -1
  25. package/bundled/docs/templates.md +2 -1
  26. package/bundled/docs/trailheads/from-component-frameworks.md +9 -10
  27. package/bundled/docs/trailheads/from-hugo.md +5 -3
  28. package/bundled/docs/trailheads/from-jekyll.md +54 -13
  29. package/bundled/docs/trailheads/from-mkdocs.md +15 -12
  30. package/bundled/docs/trailheads/from-vitepress.md +142 -0
  31. package/bundled/docs/trailheads.md +5 -5
  32. package/bundled/docs/where-values-come-from.md +5 -5
  33. package/bundled/docs/writing-plugins.md +69 -0
  34. package/bundled/ssqch.d.ts +150 -34
  35. package/bundled/starter/engines/index.edge +1 -0
  36. package/bundled/starter/engines/index.ejs +1 -0
  37. package/bundled/starter/engines/index.hbs +1 -0
  38. package/bundled/starter/engines/index.liquid +1 -0
  39. package/bundled/starter/engines/layout.edge +7 -0
  40. package/bundled/starter/engines/layout.ejs +4 -0
  41. package/bundled/starter/engines/layout.hbs +4 -0
  42. package/bundled/starter/engines/layout.liquid +4 -0
  43. package/bundled/starter/src/_data/site.json +1 -0
  44. package/bundled/starter/src/_includes/layout.jinja +4 -0
  45. package/bundled/starter/src/index.jinja +1 -0
  46. package/bundled/starter/ssqch.config.js +14 -1
  47. package/bundled/starter-docs/engines/edge/base.edge +7 -0
  48. package/bundled/starter-docs/engines/edge/doc.edge +4 -0
  49. package/bundled/starter-docs/engines/ejs/base.ejs +4 -0
  50. package/bundled/starter-docs/engines/ejs/doc.ejs +4 -0
  51. package/bundled/starter-docs/engines/hbs/base.hbs +4 -0
  52. package/bundled/starter-docs/engines/hbs/doc.hbs +3 -0
  53. package/bundled/starter-docs/engines/liquid/base.liquid +4 -0
  54. package/bundled/starter-docs/engines/liquid/doc.liquid +4 -0
  55. package/bundled/starter-docs/src/_data/site.json +1 -0
  56. package/bundled/starter-docs/src/_includes/base.jinja +4 -0
  57. package/bundled/starter-docs/src/_includes/doc.jinja +4 -0
  58. package/bundled/starter-docs/src/assets/docs.css +4 -0
  59. package/bundled/starter-docs/src/assets/docs.js +17 -0
  60. package/bundled/starter-docs/ssqch.config.js +14 -1
  61. package/lib/assets.js +13 -11
  62. package/lib/chunk-25WERNDD.js +112 -0
  63. package/lib/{chunk-H5K2ZE7B.js → chunk-2BJFGKOE.js} +13 -5
  64. package/lib/chunk-2FKYWYAB.js +268 -0
  65. package/lib/{chunk-LJOURBYT.js → chunk-3ZTRIO6O.js} +21 -19
  66. package/lib/{chunk-IOBC665M.js → chunk-4AZFCSGJ.js} +5 -3
  67. package/lib/{chunk-HWW5NCVJ.js → chunk-4Q6WMTER.js} +1 -1
  68. package/lib/{chunk-V2FSMOFX.js → chunk-55WXDGO4.js} +3 -3
  69. package/lib/{chunk-ZR3JYLFB.js → chunk-6FY77I4M.js} +331 -58
  70. package/lib/{chunk-JC54PHIT.js → chunk-6OUCRDYI.js} +514 -141
  71. package/lib/{chunk-ERAIEV3O.js → chunk-6U5VIQVY.js} +9 -7
  72. package/lib/{chunk-Z5OP43HU.js → chunk-7U5GWTEH.js} +455 -94
  73. package/lib/{chunk-CMJ7X5WW.js → chunk-AIJNG6MJ.js} +3 -2
  74. package/lib/{chunk-3K237XAX.js → chunk-C2Q7JKFI.js} +12 -10
  75. package/lib/{chunk-GS5B3CBW.js → chunk-DDV6JEC2.js} +1 -1
  76. package/lib/{chunk-A75EVUJX.js → chunk-DFJFHULZ.js} +47 -20
  77. package/lib/{chunk-KZZS4W2V.js → chunk-ENWDM2RW.js} +45 -42
  78. package/lib/{chunk-I3HYKEEW.js → chunk-ER72RPD6.js} +3 -3
  79. package/lib/chunk-F3JPNFCZ.js +23 -0
  80. package/lib/{chunk-B5E27PLU.js → chunk-FENJHLNM.js} +6 -3
  81. package/lib/{chunk-UU43WIZG.js → chunk-FJML7INB.js} +4 -2
  82. package/lib/{chunk-KCF2Z6N7.js → chunk-FQZDUDFK.js} +5 -3
  83. package/lib/{chunk-GJNIQAIH.js → chunk-GSNRAGKQ.js} +13 -6
  84. package/lib/{chunk-443ZQLVX.js → chunk-GU7BBYWB.js} +5 -4
  85. package/lib/{chunk-X2GAVYV2.js → chunk-HDKU6LRI.js} +110 -748
  86. package/lib/chunk-J3C2LEW7.js +121 -0
  87. package/lib/{chunk-XS4EJSEK.js → chunk-K5WZ2VYK.js} +7 -5
  88. package/lib/{chunk-3HZZY3Y7.js → chunk-OOKBXQAY.js} +7 -6
  89. package/lib/chunk-P2WS4RM4.js +707 -0
  90. package/lib/{chunk-RBNPBTDP.js → chunk-SNQOHNXE.js} +1 -1
  91. package/lib/{chunk-HFSWUTXX.js → chunk-SPIFZBIW.js} +1 -1
  92. package/lib/{chunk-QLUTNR37.js → chunk-T5IUI7W7.js} +12 -11
  93. package/lib/{chunk-ZINLHOX4.js → chunk-TGSVSG2G.js} +3 -2
  94. package/lib/{chunk-2L3HR67O.js → chunk-U2KEMVXO.js} +24 -16
  95. package/lib/{chunk-RYIWYWRQ.js → chunk-UHRBPZ4A.js} +7 -5
  96. package/lib/{chunk-2QTJTEBV.js → chunk-ULCT3PAV.js} +1 -1
  97. package/lib/{chunk-FCM3NYFR.js → chunk-UZNUS7RP.js} +12 -9
  98. package/lib/{chunk-GLJQ4C76.js → chunk-V3G2QGL3.js} +13 -106
  99. package/lib/{chunk-Z44IAMNG.js → chunk-VILOEVK7.js} +60 -28
  100. package/lib/chunk-VJWQSYEG.js +119 -0
  101. package/lib/{chunk-5ELAUHRL.js → chunk-WGAIE3DD.js} +23 -19
  102. package/lib/{chunk-OQGXZYZS.js → chunk-WUCRAV36.js} +13 -7
  103. package/lib/{chunk-RZYAIX2R.js → chunk-XYAWJTHM.js} +11 -10
  104. package/lib/{chunk-OSBEH67S.js → chunk-YA23NDMW.js} +5 -3
  105. package/lib/{chunk-AIMEXBTK.js → chunk-YNJNMQWU.js} +37 -142
  106. package/lib/{chunk-QJ5ZFTML.js → chunk-ZMG25MXF.js} +20 -18
  107. package/lib/cli.js +72 -35
  108. package/lib/elements.js +13 -11
  109. package/lib/from-hugo.js +36 -0
  110. package/lib/from-jekyll.js +41 -0
  111. package/lib/from-mkdocs.js +49 -0
  112. package/lib/from-vitepress.js +49 -0
  113. package/lib/image.js +12 -11
  114. package/lib/links.js +13 -11
  115. package/lib/llms.js +613 -0
  116. package/lib/minify.js +14 -12
  117. package/lib/redirects.js +13 -11
  118. package/lib/robots.js +87 -0
  119. package/lib/rss.js +24 -13
  120. package/lib/sass.js +12 -11
  121. package/lib/sitemap.js +23 -18
  122. package/lib/ssqch.js +6 -5
  123. package/lib/vue.js +400 -0
  124. package/package.json +29 -1
  125. package/types/from-hugo.d.ts +5 -0
  126. package/types/from-jekyll.d.ts +11 -0
  127. package/types/from-mkdocs.d.ts +11 -0
  128. package/types/from-vitepress.d.ts +5 -0
  129. package/types/index.d.ts +51 -31
  130. package/types/llms.d.ts +27 -0
  131. package/types/robots.d.ts +13 -0
  132. package/types/sass.d.ts +1 -1
  133. package/types/sitemap.d.ts +2 -2
  134. package/types/vue.d.ts +17 -0
  135. package/wasm/markdown.wasm +0 -0
  136. package/lib/chunk-RVXGUMFI.js +0 -21
  137. /package/lib/{chunk-ZR3JYLFB.js.LEGAL.txt → chunk-6FY77I4M.js.LEGAL.txt} +0 -0
  138. /package/lib/{chunk-AIMEXBTK.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
@@ -251,7 +257,7 @@ _ssqch() {
251
257
  return 0
252
258
  ;;
253
259
  ssqch__subcmd__diff)
254
- opts="-o -q -v -h --exact --ungrouped --ignore --only --exclude --lines --format --root --output --base --offline --env --quiet --verbose --help"
260
+ opts="-o -q -v -h --exact --ungrouped --text --ignore --only --exclude --lines --format --root --output --base --offline --env --quiet --verbose --help"
255
261
  if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
256
262
  COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
257
263
  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)'
@@ -135,6 +136,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
135
136
  cand --only 'Only compare files matching this glob, like ''**/*.html'' (repeatable)'
136
137
  cand --exclude 'Leave out files matching this glob, like ''img/**'' (repeatable)'
137
138
  cand --ungrouped 'List each file with all its changes, without grouping the ones shared by several files'
139
+ cand --text 'Compare the article text of each page, word by word, and say how much of it matches'
138
140
  cand --lines 'Changed lines to show for each file (0 for all)'
139
141
  cand --format 'text or json'
140
142
  cand --root 'Project root (defaults to the current directory)'
@@ -167,6 +169,21 @@ set edit:completion:arg-completer[ssqch] = {|@words|
167
169
  cand -h 'Print help'
168
170
  cand --help 'Print help'
169
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
+ }
170
187
  &'ssqch;init'= {
171
188
  cand --starter 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)'
172
189
  cand --engine 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs'
@@ -257,10 +274,11 @@ set edit:completion:arg-completer[ssqch] = {|@words|
257
274
  cand build 'Build the site (default)'
258
275
  cand serve 'Build, serve, watch for changes and live-reload the browser'
259
276
  cand new 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
260
- 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'
261
278
  cand completions 'Print a completion script for your shell, so Tab finishes commands and options'
262
279
  cand diff 'Compare two builds of a site: URLs added and removed, and what changed on each page'
263
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'
264
282
  cand init 'Create a starter site (config, layout, five posts, data and editor types)'
265
283
  cand types 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
266
284
  cand baseline 'Build the site with its old generator in fresh copies and compare the builds'
@@ -275,7 +293,7 @@ set edit:completion:arg-completer[ssqch] = {|@words|
275
293
  }
276
294
  &'ssqch;help;new'= {
277
295
  }
278
- &'ssqch;help;inspect'= {
296
+ &'ssqch;help;trace'= {
279
297
  }
280
298
  &'ssqch;help;completions'= {
281
299
  }
@@ -283,6 +301,8 @@ set edit:completion:arg-completer[ssqch] = {|@words|
283
301
  }
284
302
  &'ssqch;help;footprint'= {
285
303
  }
304
+ &'ssqch;help;patrol'= {
305
+ }
286
306
  &'ssqch;help;init'= {
287
307
  }
288
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
@@ -103,6 +104,7 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l ignore -d 'Leave ou
103
104
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l only -d 'Only compare files matching this glob, like \'**/*.html\' (repeatable)' -r
104
105
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l exclude -d 'Leave out files matching this glob, like \'img/**\' (repeatable)' -r
105
106
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l ungrouped -d 'List each file with all its changes, without grouping the ones shared by several files'
107
+ complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l text -d 'Compare the article text of each page, word by word, and say how much of it matches'
106
108
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l lines -d 'Changed lines to show for each file (0 for all)' -r
107
109
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l format -d 'text or json' -r
108
110
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -l root -d 'Project root (defaults to the current directory)' -r -F
@@ -116,14 +118,23 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s v -l verbose -d 'Al
116
118
  complete -c ssqch -n "__fish_ssqch_using_subcommand diff" -s h -l help -d 'Print help'
117
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
118
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
119
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
120
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
121
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
122
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
123
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'
124
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'
125
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'
126
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'
127
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
128
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
129
140
  complete -c ssqch -n "__fish_ssqch_using_subcommand init" -l root -d 'Project root (defaults to the current directory)' -r -F
@@ -179,17 +190,18 @@ complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -l offline -d 'Don\'t
179
190
  complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s q -l quiet -d 'Print only warnings and errors'
180
191
  complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s v -l verbose -d 'Also list the slowest images to encode'
181
192
  complete -c ssqch -n "__fish_ssqch_using_subcommand docs" -s h -l help -d 'Print help'
182
- 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)'
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 "serve" -d 'Build, serve, watch for changes and live-reload the browser'
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 "new" -d 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in'
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 "inspect" -d 'Show where a page comes from, and which level of the data cascade set each value'
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 "completions" -d 'Print a completion script for your shell, so Tab finishes commands and options'
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 "diff" -d 'Compare two builds of a site: URLs added and removed, and what changed on each page'
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 "footprint" -d 'Show how much a build weighs: its files by kind, and the heaviest pages and files'
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 "init" -d 'Create a starter site (config, layout, five posts, data and editor types)'
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 "types" -d 'Write ssqch.d.ts, the types editors use for ssqch.config.js'
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 "baseline" -d 'Build the site with its old generator in fresh copies and compare the builds'
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 "scout" -d 'Scout a site built with another generator: what moving it to ssqch takes, and what remains during a move'
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 "capabilities" -d 'Say what this binary supports: template languages, modules, config options and optional features'
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 "docs" -d 'Read the documentation for this version: a command, config option, function or topic'
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 "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)')
@@ -144,6 +145,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
144
145
  [CompletionResult]::new('--only', '--only', [CompletionResultType]::ParameterName, 'Only compare files matching this glob, like ''**/*.html'' (repeatable)')
145
146
  [CompletionResult]::new('--exclude', '--exclude', [CompletionResultType]::ParameterName, 'Leave out files matching this glob, like ''img/**'' (repeatable)')
146
147
  [CompletionResult]::new('--ungrouped', '--ungrouped', [CompletionResultType]::ParameterName, 'List each file with all its changes, without grouping the ones shared by several files')
148
+ [CompletionResult]::new('--text', '--text', [CompletionResultType]::ParameterName, 'Compare the article text of each page, word by word, and say how much of it matches')
147
149
  [CompletionResult]::new('--lines', '--lines', [CompletionResultType]::ParameterName, 'Changed lines to show for each file (0 for all)')
148
150
  [CompletionResult]::new('--format', '--format', [CompletionResultType]::ParameterName, 'text or json')
149
151
  [CompletionResult]::new('--root', '--root', [CompletionResultType]::ParameterName, 'Project root (defaults to the current directory)')
@@ -178,6 +180,22 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
178
180
  [CompletionResult]::new('--help', '--help', [CompletionResultType]::ParameterName, 'Print help')
179
181
  break
180
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
+ }
181
199
  'ssqch;init' {
182
200
  [CompletionResult]::new('--starter', '--starter', [CompletionResultType]::ParameterName, 'What to start with: site (a small blog) or docs (documentation with a sidebar, tabs and search)')
183
201
  [CompletionResult]::new('--engine', '--engine', [CompletionResultType]::ParameterName, 'The template language for the starter''s layouts and templates: jinja, njk, edge, liquid, hbs or ejs')
@@ -274,10 +292,11 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
274
292
  [CompletionResult]::new('build', 'build', [CompletionResultType]::ParameterValue, 'Build the site (default)')
275
293
  [CompletionResult]::new('serve', 'serve', [CompletionResultType]::ParameterValue, 'Build, serve, watch for changes and live-reload the browser')
276
294
  [CompletionResult]::new('new', 'new', [CompletionResultType]::ParameterValue, 'Create a page from a blueprint (a file in _blueprints/), with its title and date filled in')
277
- [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')
278
296
  [CompletionResult]::new('completions', 'completions', [CompletionResultType]::ParameterValue, 'Print a completion script for your shell, so Tab finishes commands and options')
279
297
  [CompletionResult]::new('diff', 'diff', [CompletionResultType]::ParameterValue, 'Compare two builds of a site: URLs added and removed, and what changed on each page')
280
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')
281
300
  [CompletionResult]::new('init', 'init', [CompletionResultType]::ParameterValue, 'Create a starter site (config, layout, five posts, data and editor types)')
282
301
  [CompletionResult]::new('types', 'types', [CompletionResultType]::ParameterValue, 'Write ssqch.d.ts, the types editors use for ssqch.config.js')
283
302
  [CompletionResult]::new('baseline', 'baseline', [CompletionResultType]::ParameterValue, 'Build the site with its old generator in fresh copies and compare the builds')
@@ -296,7 +315,7 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
296
315
  'ssqch;help;new' {
297
316
  break
298
317
  }
299
- 'ssqch;help;inspect' {
318
+ 'ssqch;help;trace' {
300
319
  break
301
320
  }
302
321
  'ssqch;help;completions' {
@@ -308,6 +327,9 @@ Register-ArgumentCompleter -Native -CommandName 'ssqch' -ScriptBlock {
308
327
  'ssqch;help;footprint' {
309
328
  break
310
329
  }
330
+ 'ssqch;help;patrol' {
331
+ break
332
+ }
311
333
  'ssqch;help;init' {
312
334
  break
313
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' \
@@ -140,6 +140,7 @@ _arguments "${_arguments_options[@]}" : \
140
140
  '*--only=[Only compare files matching this glob, like '\''**/*.html'\'' (repeatable)]:GLOB:_default' \
141
141
  '*--exclude=[Leave out files matching this glob, like '\''img/**'\'' (repeatable)]:GLOB:_default' \
142
142
  '--ungrouped[List each file with all its changes, without grouping the ones shared by several files]' \
143
+ '--text[Compare the article text of each page, word by word, and say how much of it matches]' \
143
144
  '--lines=[Changed lines to show for each file (0 for all)]:LINES:_default' \
144
145
  '--format=[text or json]:FORMAT:_default' \
145
146
  '--root=[Project root (defaults to the current directory)]:ROOT:_files' \
@@ -178,6 +179,24 @@ _arguments "${_arguments_options[@]}" : \
178
179
  '::dir -- The build folder (default\: the site'\''s output folder):_files' \
179
180
  && ret=0
180
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
+ ;;
181
200
  (init)
182
201
  _arguments "${_arguments_options[@]}" : \
183
202
  '--starter=[What to start with\: site (a small blog) or docs (documentation with a sidebar, tabs and search)]:NAME:_default' \
@@ -304,7 +323,7 @@ _arguments "${_arguments_options[@]}" : \
304
323
  _arguments "${_arguments_options[@]}" : \
305
324
  && ret=0
306
325
  ;;
307
- (inspect)
326
+ (trace)
308
327
  _arguments "${_arguments_options[@]}" : \
309
328
  && ret=0
310
329
  ;;
@@ -320,6 +339,10 @@ _arguments "${_arguments_options[@]}" : \
320
339
  _arguments "${_arguments_options[@]}" : \
321
340
  && ret=0
322
341
  ;;
342
+ (patrol)
343
+ _arguments "${_arguments_options[@]}" : \
344
+ && ret=0
345
+ ;;
323
346
  (init)
324
347
  _arguments "${_arguments_options[@]}" : \
325
348
  && ret=0
@@ -359,10 +382,11 @@ _ssqch_commands() {
359
382
  'build:Build the site (default)' \
360
383
  'serve:Build, serve, watch for changes and live-reload the browser' \
361
384
  'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
362
- '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' \
363
386
  'completions:Print a completion script for your shell, so Tab finishes commands and options' \
364
387
  'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
365
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' \
366
390
  'init:Create a starter site (config, layout, five posts, data and editor types)' \
367
391
  'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
368
392
  'baseline:Build the site with its old generator in fresh copies and compare the builds' \
@@ -403,16 +427,22 @@ _ssqch__subcmd__footprint_commands() {
403
427
  local commands; commands=()
404
428
  _describe -t commands 'ssqch footprint commands' commands "$@"
405
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
+ }
406
435
  (( $+functions[_ssqch__subcmd__help_commands] )) ||
407
436
  _ssqch__subcmd__help_commands() {
408
437
  local commands; commands=(
409
438
  'build:Build the site (default)' \
410
439
  'serve:Build, serve, watch for changes and live-reload the browser' \
411
440
  'new:Create a page from a blueprint (a file in _blueprints/), with its title and date filled in' \
412
- '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' \
413
442
  'completions:Print a completion script for your shell, so Tab finishes commands and options' \
414
443
  'diff:Compare two builds of a site\: URLs added and removed, and what changed on each page' \
415
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' \
416
446
  'init:Create a starter site (config, layout, five posts, data and editor types)' \
417
447
  'types:Write ssqch.d.ts, the types editors use for ssqch.config.js' \
418
448
  'baseline:Build the site with its old generator in fresh copies and compare the builds' \
@@ -453,6 +483,11 @@ _ssqch__subcmd__help__subcmd__footprint_commands() {
453
483
  local commands; commands=()
454
484
  _describe -t commands 'ssqch help footprint commands' commands "$@"
455
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
+ }
456
491
  (( $+functions[_ssqch__subcmd__help__subcmd__help_commands] )) ||
457
492
  _ssqch__subcmd__help__subcmd__help_commands() {
458
493
  local commands; commands=()
@@ -468,10 +503,10 @@ _ssqch__subcmd__help__subcmd__init_commands() {
468
503
  local commands; commands=()
469
504
  _describe -t commands 'ssqch help init commands' commands "$@"
470
505
  }
471
- (( $+functions[_ssqch__subcmd__help__subcmd__inspect_commands] )) ||
472
- _ssqch__subcmd__help__subcmd__inspect_commands() {
506
+ (( $+functions[_ssqch__subcmd__help__subcmd__trace_commands] )) ||
507
+ _ssqch__subcmd__help__subcmd__trace_commands() {
473
508
  local commands; commands=()
474
- _describe -t commands 'ssqch help inspect commands' commands "$@"
509
+ _describe -t commands 'ssqch help trace commands' commands "$@"
475
510
  }
476
511
  (( $+functions[_ssqch__subcmd__help__subcmd__new_commands] )) ||
477
512
  _ssqch__subcmd__help__subcmd__new_commands() {
@@ -503,10 +538,10 @@ _ssqch__subcmd__init_commands() {
503
538
  local commands; commands=()
504
539
  _describe -t commands 'ssqch init commands' commands "$@"
505
540
  }
506
- (( $+functions[_ssqch__subcmd__inspect_commands] )) ||
507
- _ssqch__subcmd__inspect_commands() {
541
+ (( $+functions[_ssqch__subcmd__trace_commands] )) ||
542
+ _ssqch__subcmd__trace_commands() {
508
543
  local commands; commands=()
509
- _describe -t commands 'ssqch inspect commands' commands "$@"
544
+ _describe -t commands 'ssqch trace commands' commands "$@"
510
545
  }
511
546
  (( $+functions[_ssqch__subcmd__new_commands] )) ||
512
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`.