@codewizard-dt/bootstrap 2.19.0 → 2.21.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.
- package/lib/scripts/README.md +27 -18
- package/lib/scripts/bootstrap-prefs.js +18 -0
- package/lib/scripts/install-global.sh +19 -4
- package/lib/scripts/install-obsidian.sh +294 -0
- package/lib/scripts/lib.sh +17 -0
- package/lib/scripts/merge-gitignore.sh +152 -95
- package/lib/scripts/setup-deployment.sh +1 -1
- package/lib/scripts/sync-wiki-scaffold.sh +13 -6
- package/lib/scripts/templates/bootstrap-prefs-schema.json +32 -5
- package/lib/scripts/templates/file-suggestion.sh +13 -5
- package/lib/skills/bootstrap-config/SKILL.md +11 -5
- package/lib/skills/research/SKILL.md +24 -3
- package/lib/skills/task-add/SKILL.md +4 -0
- package/lib/skills/task-audit/SKILL.md +2 -0
- package/package.json +1 -1
- package/raw/guides/dataview-queries.md +66 -0
|
@@ -242,71 +242,107 @@ elif [ "$review_sections" -eq 1 ]; then
|
|
|
242
242
|
echo ".gitignore: no changes made in $PROJECT_DIR"
|
|
243
243
|
fi
|
|
244
244
|
|
|
245
|
-
# Machine-local git exclusion for bootstrap agent state
|
|
246
|
-
# go into .gitignore: Serena (ignore_all_files_in_gitignore:
|
|
247
|
-
# Code's Grep mirror .gitignore and would go blind on the wiki.
|
|
248
|
-
# has identical semantics for git, is never committed (a
|
|
249
|
-
# offered per-machine), and is invisible to Serena — its
|
|
250
|
-
# only files named ".gitignore", so the dirs stay
|
|
251
|
-
# to every tool: ripgrep-class walkers and Claude
|
|
252
|
-
# info/exclude. That is why install-global.sh
|
|
253
|
-
# and registers it as the fileSuggestion
|
|
254
|
-
# listed under the sentinel
|
|
245
|
+
# Machine-local git exclusion for bootstrap agent state and preference files.
|
|
246
|
+
# These dirs must NEVER go into .gitignore: Serena (ignore_all_files_in_gitignore:
|
|
247
|
+
# true) and Claude Code's Grep mirror .gitignore and would go blind on the wiki.
|
|
248
|
+
# .git/info/exclude has identical semantics for git, is never committed (a
|
|
249
|
+
# per-machine choice, offered per-machine), and is invisible to Serena — its
|
|
250
|
+
# GitignoreParser reads only files named ".gitignore", so the dirs stay
|
|
251
|
+
# navigable. It is NOT invisible to every tool: ripgrep-class walkers and Claude
|
|
252
|
+
# Code's @ file picker do honor info/exclude. That is why install-global.sh
|
|
253
|
+
# installs ~/.claude/file-suggestion.sh and registers it as the fileSuggestion
|
|
254
|
+
# picker — it re-includes exactly the paths listed under the sentinel below.
|
|
255
|
+
#
|
|
256
|
+
# ONE sentinel, shared by both mechanisms below (wiki/agent-state dirs and the
|
|
257
|
+
# bootstrap-prefs files), so file-suggestion.sh's single hardcoded SENTINEL
|
|
258
|
+
# always matches regardless of which mechanism ran, in which order, or which
|
|
259
|
+
# options got picked. Generic text — not "wiki", not "preferences" — because
|
|
260
|
+
# it's read back only by name, never by content.
|
|
255
261
|
GIT_EXCLUDE="$PROJECT_DIR/.git/info/exclude"
|
|
256
|
-
EXCLUDE_SENTINEL="# bootstrap
|
|
257
|
-
|
|
258
|
-
#
|
|
259
|
-
#
|
|
260
|
-
#
|
|
261
|
-
#
|
|
262
|
-
#
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
if (at + 3 < NR && line[at + 4] !~ /^[[:space:]]*#/) exit 1
|
|
275
|
-
exit 0
|
|
276
|
-
}
|
|
277
|
-
' "$1"
|
|
278
|
-
}
|
|
262
|
+
EXCLUDE_SENTINEL="# bootstrap machine-local (autocomplete-visible)"
|
|
263
|
+
|
|
264
|
+
# The sentinel text this mechanism used before the two blocks were unified.
|
|
265
|
+
# Scrubbed on sight by exclude_ensure_paths so upgrading an existing project
|
|
266
|
+
# (like one that only ever answered the prefs.gitTracking question) cleans up
|
|
267
|
+
# the stale header automatically instead of leaving two competing sentinels.
|
|
268
|
+
LEGACY_PREFS_SENTINEL="# bootstrap preferences (machine-local)"
|
|
269
|
+
|
|
270
|
+
# Every path bootstrap ever excludes here, in the fixed order they're packed
|
|
271
|
+
# into the block when present. Each is independently optional — the block can
|
|
272
|
+
# hold anywhere from zero of these (the proactive empty case) to all five.
|
|
273
|
+
KNOWN_EXCLUDE_PATHS=(".serena/" "raw/" "wiki/" ".claude/bootstrap-prefs.json" ".claude/bootstrap-prefs.README.md")
|
|
274
|
+
|
|
275
|
+
# Set by exclude_ensure_paths after every call: 1 if the file's content changed,
|
|
276
|
+
# 0 if it was already exactly the desired shape (byte-identical, left untouched
|
|
277
|
+
# — mtime and permissions included). Callers use this to decide whether a
|
|
278
|
+
# repair/no-op message is worth printing.
|
|
279
|
+
EXCLUDE_CHANGED=0
|
|
279
280
|
|
|
280
|
-
# A user's own entry sitting INSIDE the sentinel block
|
|
281
|
-
# our block at the bottom
|
|
282
|
-
#
|
|
283
|
-
# user's view of their own
|
|
281
|
+
# A user's own entry sitting INSIDE the sentinel block that isn't one of
|
|
282
|
+
# KNOWN_EXCLUDE_PATHS. exclude_ensure_paths re-appends our block at the bottom
|
|
283
|
+
# and leaves such an entry above it: git still excludes it, but the picker stops
|
|
284
|
+
# re-including it, so say so rather than change the user's view of their own
|
|
285
|
+
# file silently.
|
|
284
286
|
exclude_stranded() {
|
|
285
287
|
[ -f "$1" ] || return 0
|
|
286
|
-
|
|
288
|
+
# Space-joined, not newline-joined: BSD awk (macOS's default /usr/bin/awk)
|
|
289
|
+
# rejects a `-v` value containing an embedded newline ("newline in string").
|
|
290
|
+
# None of KNOWN_EXCLUDE_PATHS' fixed entries contain a space, so this is safe.
|
|
291
|
+
awk -v sentinel="$EXCLUDE_SENTINEL" -v known="$(printf '%s ' "${KNOWN_EXCLUDE_PATHS[@]}")" '
|
|
292
|
+
BEGIN { kc = split(known, klines, " ") }
|
|
287
293
|
$0 == sentinel { in_block = 1; next }
|
|
288
294
|
in_block && /^[[:space:]]*#/ { in_block = 0 }
|
|
289
|
-
in_block && $0 !~ /^[[:space:]]*$/
|
|
290
|
-
|
|
295
|
+
in_block && $0 !~ /^[[:space:]]*$/ {
|
|
296
|
+
is_known = 0
|
|
297
|
+
for (i = 1; i <= kc; i++) if ($0 == klines[i]) { is_known = 1; break }
|
|
298
|
+
if (!is_known) print " " $0
|
|
299
|
+
}
|
|
291
300
|
' "$1"
|
|
292
301
|
}
|
|
293
302
|
|
|
294
|
-
#
|
|
295
|
-
#
|
|
296
|
-
#
|
|
297
|
-
#
|
|
298
|
-
#
|
|
299
|
-
|
|
300
|
-
|
|
303
|
+
# exclude_ensure_paths <file> [path...]: idempotently ensure the sentinel is
|
|
304
|
+
# present in <file> exactly once, immediately followed by every
|
|
305
|
+
# KNOWN_EXCLUDE_PATHS entry that is either already anywhere in the file (so a
|
|
306
|
+
# prior run's, or the other mechanism's, entries survive) or passed as an
|
|
307
|
+
# argument here — packed in KNOWN_EXCLUDE_PATHS order, terminated by a "#"
|
|
308
|
+
# comment or EOF. Everything else in the file survives verbatim and in its
|
|
309
|
+
# original relative order (this file may hold the user's own exclusions); the
|
|
310
|
+
# legacy pre-unification header is scrubbed on sight. A file already in exactly
|
|
311
|
+
# this shape is left byte-identical (EXCLUDE_CHANGED=0) so repeated/no-op calls
|
|
312
|
+
# never show up as a diff.
|
|
313
|
+
exclude_ensure_paths() {
|
|
314
|
+
local file="$1"; shift
|
|
315
|
+
local src="$file" tmp mode="" p a
|
|
316
|
+
local want=()
|
|
301
317
|
[ -f "$src" ] || src=/dev/null
|
|
318
|
+
|
|
319
|
+
for p in "${KNOWN_EXCLUDE_PATHS[@]}"; do
|
|
320
|
+
if [ -f "$src" ] && grep -qFx -- "$p" "$src"; then
|
|
321
|
+
want+=("$p")
|
|
322
|
+
continue
|
|
323
|
+
fi
|
|
324
|
+
for a in "$@"; do
|
|
325
|
+
if [ "$a" = "$p" ]; then want+=("$p"); break; fi
|
|
326
|
+
done
|
|
327
|
+
done
|
|
328
|
+
|
|
302
329
|
if [ -f "$file" ]; then
|
|
303
330
|
mode=$(stat -f '%Lp' "$file" 2>/dev/null || stat -c '%a' "$file" 2>/dev/null || true)
|
|
304
331
|
fi
|
|
305
332
|
mkdir -p "$(dirname "$file")" || return 1
|
|
306
333
|
tmp=$(mktemp "$(dirname "$file")/.bootstrap-exclude.XXXXXX") || return 1
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
|
|
334
|
+
# Space-joined, not newline-joined: BSD awk (macOS's default /usr/bin/awk)
|
|
335
|
+
# rejects a `-v` value containing an embedded newline ("newline in string").
|
|
336
|
+
# `want` only ever holds entries from the fixed, space-free KNOWN_EXCLUDE_PATHS.
|
|
337
|
+
awk -v sentinel="$EXCLUDE_SENTINEL" -v legacy="$LEGACY_PREFS_SENTINEL" \
|
|
338
|
+
-v wanted="$(printf '%s ' ${want[@]+"${want[@]}"})" '
|
|
339
|
+
BEGIN { n = 0; prev_blank = 1; dropped = 0; wc = split(wanted, wlines, " ") }
|
|
340
|
+
$0 == sentinel || $0 == legacy { dropped = 1; next }
|
|
341
|
+
{
|
|
342
|
+
is_known = 0
|
|
343
|
+
for (i = 1; i <= wc; i++) if (wlines[i] != "" && $0 == wlines[i]) { is_known = 1; break }
|
|
344
|
+
}
|
|
345
|
+
is_known { dropped = 1; next }
|
|
310
346
|
{
|
|
311
347
|
if ($0 ~ /^[[:space:]]*$/) {
|
|
312
348
|
if (prev_blank && dropped) next
|
|
@@ -322,23 +358,29 @@ exclude_normalize() {
|
|
|
322
358
|
if (n == 1 && keep[1] ~ /^[[:space:]]*$/) n = 0
|
|
323
359
|
for (i = 1; i <= n; i++) print keep[i]
|
|
324
360
|
print sentinel
|
|
325
|
-
|
|
326
|
-
print "raw/"
|
|
327
|
-
print "wiki/"
|
|
361
|
+
for (i = 1; i <= wc; i++) if (wlines[i] != "") print wlines[i]
|
|
328
362
|
}
|
|
329
363
|
' "$src" > "$tmp" || { rm -f "$tmp"; return 1; }
|
|
364
|
+
|
|
365
|
+
if [ -f "$file" ] && cmp -s "$file" "$tmp"; then
|
|
366
|
+
rm -f "$tmp"
|
|
367
|
+
EXCLUDE_CHANGED=0
|
|
368
|
+
return 0
|
|
369
|
+
fi
|
|
330
370
|
mv -f "$tmp" "$file" || { rm -f "$tmp"; return 1; }
|
|
331
371
|
if [ -n "$mode" ]; then chmod "$mode" "$file" 2>/dev/null || true; fi
|
|
372
|
+
EXCLUDE_CHANGED=1
|
|
332
373
|
return 0
|
|
333
374
|
}
|
|
334
375
|
|
|
335
376
|
# Normalize and report. Never fatal: this runs under `set -euo pipefail` from
|
|
336
377
|
# run_project_sync and must not abort the user's setup.
|
|
337
378
|
exclude_apply() {
|
|
379
|
+
local file="$1"; shift
|
|
338
380
|
local stranded
|
|
339
|
-
stranded=$(exclude_stranded "$
|
|
340
|
-
if !
|
|
341
|
-
echo " Warning: could not update $
|
|
381
|
+
stranded=$(exclude_stranded "$file")
|
|
382
|
+
if ! exclude_ensure_paths "$file" "$@"; then
|
|
383
|
+
echo " Warning: could not update $file — left unchanged."
|
|
342
384
|
return 1
|
|
343
385
|
fi
|
|
344
386
|
if [ -n "$stranded" ]; then
|
|
@@ -349,7 +391,30 @@ exclude_apply() {
|
|
|
349
391
|
return 0
|
|
350
392
|
}
|
|
351
393
|
|
|
394
|
+
# Guarantees the shared sentinel exists even if nothing is excluded yet, so any
|
|
395
|
+
# bootstrap feature — this run or a future one — always finds the same anchor
|
|
396
|
+
# regardless of which of the prompts below get accepted or declined. A bare
|
|
397
|
+
# comment line excludes nothing, so writing it needs no consent prompt. Stays
|
|
398
|
+
# quiet unless this call is what introduces the sentinel for the very first
|
|
399
|
+
# time on a file with no bootstrap-managed paths yet — otherwise the branches
|
|
400
|
+
# below describe whatever they changed themselves.
|
|
401
|
+
exclude_ensure_sentinel() {
|
|
402
|
+
local file="$1" had_sentinel=false had_known=false p
|
|
403
|
+
if [ -f "$file" ]; then
|
|
404
|
+
grep -qFx -- "$EXCLUDE_SENTINEL" "$file" 2>/dev/null && had_sentinel=true
|
|
405
|
+
for p in "${KNOWN_EXCLUDE_PATHS[@]}"; do
|
|
406
|
+
grep -qFx -- "$p" "$file" 2>/dev/null && { had_known=true; break; }
|
|
407
|
+
done
|
|
408
|
+
fi
|
|
409
|
+
exclude_apply "$file" || return 0
|
|
410
|
+
if [ "$EXCLUDE_CHANGED" -eq 1 ] && [ "$had_sentinel" = false ] && [ "$had_known" = false ]; then
|
|
411
|
+
echo " .git/info/exclude: added shared bootstrap sentinel (machine-local; nothing excluded yet)"
|
|
412
|
+
fi
|
|
413
|
+
}
|
|
414
|
+
|
|
352
415
|
if [ -d "$PROJECT_DIR/.git" ]; then
|
|
416
|
+
exclude_ensure_sentinel "$GIT_EXCLUDE"
|
|
417
|
+
|
|
353
418
|
exclude_missing=0
|
|
354
419
|
exclude_added=""
|
|
355
420
|
for p in ".serena/" "raw/" "wiki/"; do
|
|
@@ -360,21 +425,20 @@ if [ -d "$PROJECT_DIR/.git" ]; then
|
|
|
360
425
|
exclude_added="${exclude_added} + ${p} (.git/info/exclude)"$'\n'
|
|
361
426
|
done
|
|
362
427
|
|
|
363
|
-
if
|
|
364
|
-
: # already canonical — leave the file byte-identical
|
|
365
|
-
elif [ "$exclude_missing" -gt 0 ]; then
|
|
428
|
+
if [ "$exclude_missing" -gt 0 ]; then
|
|
366
429
|
# Accepting newly hides paths from git, so this stays a consent prompt.
|
|
367
430
|
#
|
|
368
431
|
# `gitignore.infoExclude` is declines-only: a decline records `false` and
|
|
369
432
|
# suppresses the re-offer, an accept records NOTHING, because accepting
|
|
370
|
-
# changes the world and
|
|
371
|
-
# sticky. Keep this key distinct from
|
|
372
|
-
# .gitignore section pass) and
|
|
373
|
-
# themselves) — declining one must
|
|
433
|
+
# changes the world and exclude_ensure_paths's byte-identical no-op above
|
|
434
|
+
# already makes it sticky. Keep this key distinct from
|
|
435
|
+
# `gitignore.offerSectionUpdates` (the .gitignore section pass) and
|
|
436
|
+
# `prefs.gitTracking` (the preference files themselves) — declining one must
|
|
437
|
+
# never disable another.
|
|
374
438
|
if [ "$(prefs_get gitignore.infoExclude "$PROJECT_DIR")" = "false" ]; then
|
|
375
439
|
echo " .git/info/exclude: skipped (remembered answer gitignore.infoExclude=false — change with /bootstrap-config)."
|
|
376
|
-
elif prompt_yn "
|
|
377
|
-
if exclude_apply; then
|
|
440
|
+
elif prompt_yn " Add .serena/, raw/, and wiki/ to git's local ignore list (.git/info/exclude, this machine only)? [y/N]: "; then
|
|
441
|
+
if exclude_apply "$GIT_EXCLUDE" ".serena/" "raw/" "wiki/"; then
|
|
378
442
|
printf '%s' "$exclude_added"
|
|
379
443
|
echo " Note: this protects only this clone — teammates opt in by running 'npx @codewizard-dt/bootstrap update' themselves."
|
|
380
444
|
fi
|
|
@@ -386,7 +450,9 @@ if [ -d "$PROJECT_DIR/.git" ]; then
|
|
|
386
450
|
# not change, only the picker's view of it. A pure repair, so no prompt —
|
|
387
451
|
# deliberately regardless of the stored `gitignore.infoExclude` value, since
|
|
388
452
|
# a decline refuses newly hiding paths, not repairing a sentinel.
|
|
389
|
-
|
|
453
|
+
# exclude_apply is a byte-identical no-op when the block is already
|
|
454
|
+
# canonical, so EXCLUDE_CHANGED gates the message.
|
|
455
|
+
if exclude_apply "$GIT_EXCLUDE" ".serena/" "raw/" "wiki/" && [ "$EXCLUDE_CHANGED" -eq 1 ]; then
|
|
390
456
|
echo " .git/info/exclude: reordered .serena/, raw/, wiki/ under the bootstrap sentinel (git unchanged; restores @-autocomplete)"
|
|
391
457
|
fi
|
|
392
458
|
fi
|
|
@@ -466,42 +532,33 @@ if has_tty; then
|
|
|
466
532
|
echo " .git/info/exclude: $PROJECT_DIR is not a git repository — nothing to exclude; the preference files stay visible to git."
|
|
467
533
|
else
|
|
468
534
|
prefs_written=0
|
|
535
|
+
prefs_added=""
|
|
469
536
|
for p in "$PREFS_VALUES_PATH" "$PREFS_README_PATH"; do
|
|
470
537
|
if [ -f "$GIT_EXCLUDE" ] && grep -qFx -- "$p" "$GIT_EXCLUDE"; then
|
|
471
538
|
continue
|
|
472
539
|
fi
|
|
540
|
+
prefs_written=$((prefs_written + 1))
|
|
541
|
+
prefs_added="${prefs_added} + ${p} (.git/info/exclude)"$'\n'
|
|
542
|
+
done
|
|
543
|
+
# Same shared sentinel and merge function the wiki-dirs block above
|
|
544
|
+
# uses — both mechanisms converge on one block so file-suggestion.sh's
|
|
545
|
+
# single hardcoded SENTINEL always matches, regardless of which of the
|
|
546
|
+
# two ran first or which options were chosen. exclude_ensure_paths only
|
|
547
|
+
# adds paths it's asked for (or that were already present), so this
|
|
548
|
+
# never force-adds .serena/, raw/, or wiki/ for a user who declined
|
|
549
|
+
# that separately — and it scrubs the legacy pre-unification header on
|
|
550
|
+
# sight if this project still has it.
|
|
551
|
+
if exclude_apply "$GIT_EXCLUDE" "$PREFS_VALUES_PATH" "$PREFS_README_PATH"; then
|
|
473
552
|
if [ "$prefs_written" -eq 0 ]; then
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
553
|
+
if [ "$EXCLUDE_CHANGED" -eq 1 ]; then
|
|
554
|
+
echo " .git/info/exclude: already excludes the bootstrap preference files (repositioned under the shared bootstrap sentinel)."
|
|
555
|
+
else
|
|
556
|
+
echo " .git/info/exclude: already excludes the bootstrap preference files."
|
|
477
557
|
fi
|
|
478
|
-
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
# what exclude_is_canonical accepts as the block terminator; and
|
|
482
|
-
# exclude_stranded stops scanning at the first "#", so our entries
|
|
483
|
-
# are never reported as stranded inside the bootstrap block.
|
|
484
|
-
printf '# bootstrap preferences (machine-local)\n' >> "$GIT_EXCLUDE"
|
|
558
|
+
else
|
|
559
|
+
printf '%s' "$prefs_added"
|
|
560
|
+
echo " Note: this hides them on THIS machine only — teammates are unaffected."
|
|
485
561
|
fi
|
|
486
|
-
printf '%s\n' "$p" >> "$GIT_EXCLUDE"
|
|
487
|
-
echo " + $p (.git/info/exclude)"
|
|
488
|
-
prefs_written=$((prefs_written + 1))
|
|
489
|
-
done
|
|
490
|
-
if [ "$prefs_written" -eq 0 ]; then
|
|
491
|
-
echo " .git/info/exclude: already excludes the bootstrap preference files."
|
|
492
|
-
else
|
|
493
|
-
echo " Note: this hides them on THIS machine only — teammates are unaffected."
|
|
494
|
-
fi
|
|
495
|
-
# Verify rather than trust: a file left non-canonical is silently
|
|
496
|
-
# rewritten by exclude_normalize on every future run. Repair ONLY when
|
|
497
|
-
# the sentinel is already present — exclude_apply would otherwise create
|
|
498
|
-
# the block and hide .serena/, raw/, wiki/ from a user who just declined
|
|
499
|
-
# exactly that above. A later normalize pass leaves our lines intact,
|
|
500
|
-
# because its scrub only removes the sentinel and those three paths.
|
|
501
|
-
if [ -f "$GIT_EXCLUDE" ] \
|
|
502
|
-
&& grep -qFx -- "$EXCLUDE_SENTINEL" "$GIT_EXCLUDE" \
|
|
503
|
-
&& ! exclude_is_canonical "$GIT_EXCLUDE"; then
|
|
504
|
-
exclude_apply || true
|
|
505
562
|
fi
|
|
506
563
|
fi
|
|
507
564
|
;;
|
|
@@ -75,7 +75,7 @@ fi
|
|
|
75
75
|
# the topology the scaffolded CI implements. Landed before the Claude run so
|
|
76
76
|
# it survives a timeout.
|
|
77
77
|
mkdir -p "$PROJECT_DIR/wiki/guides"
|
|
78
|
-
rsync -
|
|
78
|
+
rsync -a --checksum --out-format=' + %n' "$GUIDE" "$PROJECT_DIR/wiki/guides/deployment-strategy.md"
|
|
79
79
|
|
|
80
80
|
TASK="$(sed "s|__PROJECT_DIR__|$PROJECT_DIR|g" "$TEMPLATE")"
|
|
81
81
|
|
|
@@ -45,19 +45,26 @@ mkdir -p \
|
|
|
45
45
|
"$PROJECT_DIR/wiki/work/bugs" \
|
|
46
46
|
"$PROJECT_DIR/wiki/guides"
|
|
47
47
|
|
|
48
|
+
# rsync flags shared by every call below: content-based comparison (not
|
|
49
|
+
# mtime — each `npx` run extracts a fresh package copy with new mtimes, which
|
|
50
|
+
# would otherwise make every file look "changed" on every run), no directory
|
|
51
|
+
# mtime writes (same reason, applied to directories), and a minimal one-line
|
|
52
|
+
# report per file actually transferred instead of the full recursive listing.
|
|
53
|
+
RSYNC_FLAGS=(-a --checksum --omit-dir-times --out-format=' + %n')
|
|
54
|
+
|
|
48
55
|
# 2. COPY-ONCE: index.md, log.md, hot.md, .gitkeep files — project-owned after creation, never overwrite
|
|
49
56
|
# Exclude conventions.md and lifecycle.md (those are always-refresh, handled in step 3).
|
|
50
|
-
rsync
|
|
57
|
+
rsync "${RSYNC_FLAGS[@]}" --ignore-existing \
|
|
51
58
|
--exclude 'conventions.md' \
|
|
52
59
|
--exclude 'lifecycle.md' \
|
|
53
60
|
--exclude 'dashboard.html' \
|
|
54
61
|
"$TEMPLATES/" "$PROJECT_DIR/wiki/"
|
|
55
62
|
|
|
56
63
|
# 3. ALWAYS-REFRESH: spec docs (conventions.md, lifecycle.md) and dashboard.html that remain template-owned; always overwrite
|
|
57
|
-
rsync
|
|
58
|
-
rsync
|
|
64
|
+
rsync "${RSYNC_FLAGS[@]}" "$TEMPLATES/conventions.md" "$PROJECT_DIR/wiki/conventions.md"
|
|
65
|
+
rsync "${RSYNC_FLAGS[@]}" "$TEMPLATES/dashboard.html" "$PROJECT_DIR/wiki/dashboard.html"
|
|
59
66
|
for fam in requirements decisions roadmaps tasks uat bugs; do
|
|
60
|
-
rsync
|
|
67
|
+
rsync "${RSYNC_FLAGS[@]}" "$TEMPLATES/work/$fam/lifecycle.md" "$PROJECT_DIR/wiki/work/$fam/lifecycle.md"
|
|
61
68
|
done
|
|
62
69
|
|
|
63
70
|
# 4. GUIDES: tiered delivery into target wiki/guides/ (template-owned
|
|
@@ -83,9 +90,9 @@ OPTIONAL_GUIDES="evals-framework.md type-checking-templates"
|
|
|
83
90
|
deliver_guide() {
|
|
84
91
|
# $1 = guide name (file or dir under GUIDES_SRC)
|
|
85
92
|
if [ -d "$GUIDES_SRC/$1" ]; then
|
|
86
|
-
rsync
|
|
93
|
+
rsync "${RSYNC_FLAGS[@]}" "$GUIDES_SRC/$1/" "$GUIDES_DST/$1/"
|
|
87
94
|
else
|
|
88
|
-
rsync
|
|
95
|
+
rsync "${RSYNC_FLAGS[@]}" "$GUIDES_SRC/$1" "$GUIDES_DST/"
|
|
89
96
|
fi
|
|
90
97
|
}
|
|
91
98
|
|
|
@@ -47,8 +47,8 @@
|
|
|
47
47
|
"gitignore.infoExclude": {
|
|
48
48
|
"scope": "project",
|
|
49
49
|
"consumer": "installer",
|
|
50
|
-
"summary": "
|
|
51
|
-
"detail": "Asked by merge-gitignore.sh:
|
|
50
|
+
"summary": "Add .serena/, raw/, and wiki/ to git's local ignore list via .git/info/exclude",
|
|
51
|
+
"detail": "Asked by merge-gitignore.sh:440 when one or more of .serena/, raw/, wiki/ are not yet excluded. true writes them under the bootstrap sentinel in .git/info/exclude — machine-local, never committed, and unlike .gitignore it does not blind Serena or ripgrep-class walkers; the installed fileSuggestion script restores @-autocomplete for those paths. false leaves git tracking them here; teammates opt in separately by running update themselves. This is INDEPENDENT of the .gitignore section pass governed by gitignore.offerSectionUpdates: declining or disabling sections never disables the info/exclude mechanism, and a pure sentinel repair (all three already excluded elsewhere in the file) runs with no prompt at all regardless of this key. See also prefs.gitTracking, which decides how git treats the preferences file itself — a different question from these three directories.",
|
|
52
52
|
"values": "true | false",
|
|
53
53
|
"default": null,
|
|
54
54
|
"askedBy": "merge-gitignore.sh"
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
"scope": "project",
|
|
67
67
|
"consumer": "installer",
|
|
68
68
|
"summary": "Install a specific optional guide into wiki/guides/",
|
|
69
|
-
"detail": "One key per entry in sync-wiki-scaffold.sh's OPTIONAL_GUIDES list (sync-wiki-scaffold.sh:
|
|
69
|
+
"detail": "One key per entry in sync-wiki-scaffold.sh's OPTIONAL_GUIDES list (sync-wiki-scaffold.sh:88), keyed by the exact entry text including any extension — today that is guides.evals-framework.md and guides.type-checking-templates. true delivers the guide into wiki/guides/ on every run; false keeps it out and suppresses the per-run prompt. A guide already present in wiki/guides/ (or in the legacy .docs/guides/) is refreshed regardless of this key — existing opt-in wins, because the file on disk is the stronger signal than a stored answer. The required guide tier is never gated by these keys.",
|
|
70
70
|
"values": "true | false",
|
|
71
71
|
"default": null,
|
|
72
72
|
"askedBy": "sync-wiki-scaffold.sh",
|
|
@@ -104,7 +104,7 @@
|
|
|
104
104
|
"scope": "global",
|
|
105
105
|
"consumer": "installer",
|
|
106
106
|
"summary": "Registration scope for the Context7 MCP",
|
|
107
|
-
"detail": "Asked by prompt_scope in lib.sh:
|
|
107
|
+
"detail": "Asked by prompt_scope in lib.sh:404 ('Scope for context7 — [u]ser (default) or [p]roject?'). prompt_scope emits exactly two answers, 'user' and 'project' — it has no local-scope branch, and any reply that does not begin with p or P falls through to user. 'user' registers Context7 once for every project on this machine; 'project' writes the registration into the current project's shareable .mcp.json.",
|
|
108
108
|
"values": "user | project",
|
|
109
109
|
"default": null,
|
|
110
110
|
"askedBy": "lib.sh"
|
|
@@ -118,11 +118,29 @@
|
|
|
118
118
|
"default": null,
|
|
119
119
|
"askedBy": "install-mcps.sh"
|
|
120
120
|
},
|
|
121
|
+
"obsidian.installApp": {
|
|
122
|
+
"scope": "global",
|
|
123
|
+
"consumer": "installer",
|
|
124
|
+
"summary": "Install the Obsidian desktop app via the native package manager",
|
|
125
|
+
"detail": "Asked by install-obsidian.sh when the Obsidian desktop app is not yet installed on this machine. true installs it via the native package manager — brew on macOS, flatpak on Linux — and, per the standard sticky-prompt semantics, keeps offering it again on every subsequent run until it is actually present. false means the installer stops offering it: the prompt is never shown again on this machine until the key is changed or removed via /bootstrap-config. The app itself is machine-wide, not tied to any one project, which is why this key is global scope, matching mcp.playwright's scope choice.",
|
|
126
|
+
"values": "true | false",
|
|
127
|
+
"default": null,
|
|
128
|
+
"askedBy": "install-obsidian.sh"
|
|
129
|
+
},
|
|
130
|
+
"obsidian.plugins": {
|
|
131
|
+
"scope": "project",
|
|
132
|
+
"consumer": "installer",
|
|
133
|
+
"summary": "Install the bundled Obsidian plugin set (Dataview, Graph Link Types, Breadcrumbs)",
|
|
134
|
+
"detail": "Asked by install-obsidian.sh. This is a single bundled prompt covering all three recommended community plugins together — Dataview, Graph Link Types, and Breadcrumbs — rather than one key per plugin, because Dataview is a hard prerequisite for the other two: both Graph Link Types and Breadcrumbs read fields that Dataview indexes, so installing them separately would let a user accept Graph Link Types or Breadcrumbs without Dataview and end up with plugins that silently don't work. true installs and refreshes all three plugin folders into .obsidian/plugins/ and enables them in .obsidian/community-plugins.json on every run. false means the installer stops offering the bundle again until the key is changed or removed via /bootstrap-config. Plugin files live inside this project's own .obsidian/ directory, which is why this key is project scope, matching guides.*'s scope choice.",
|
|
135
|
+
"values": "true | false",
|
|
136
|
+
"default": null,
|
|
137
|
+
"askedBy": "install-obsidian.sh"
|
|
138
|
+
},
|
|
121
139
|
"skills.pruneOrphans": {
|
|
122
140
|
"scope": "global",
|
|
123
141
|
"consumer": "installer",
|
|
124
142
|
"summary": "Delete stale skill folders in ~/.claude/skills/ left by the wiki rename",
|
|
125
|
-
"detail": "Asked by install-global.sh:
|
|
143
|
+
"detail": "Asked by install-global.sh:72 when any renamed-away skill folder (the adr-* and prd-* families) is still present in ~/.claude/skills/. true removes those folders with rm -rf; false keeps them, and they continue to appear as duplicate slash commands alongside their renamed replacements. The list of orphan names is fixed in the script — this key does not decide which folders qualify, only whether the deletion runs.",
|
|
126
144
|
"values": "true | false",
|
|
127
145
|
"default": null,
|
|
128
146
|
"askedBy": "install-global.sh"
|
|
@@ -154,6 +172,15 @@
|
|
|
154
172
|
"default": true,
|
|
155
173
|
"askedBy": "install-global.sh"
|
|
156
174
|
},
|
|
175
|
+
"research.autoIngest": {
|
|
176
|
+
"scope": "either",
|
|
177
|
+
"consumer": "skill",
|
|
178
|
+
"summary": "Whether /research automatically wiki-ingests its saved report",
|
|
179
|
+
"detail": "Governs what happens right after Phase 5 writes raw/research/<slug>/index.md — it never runs when that write was suppressed (research.persistToRaw=false, a per-run --no-save, or a declined ask), because there is then no raw/ file to ingest. true immediately follows the full lib/skills/wiki-ingest/SKILL.md procedure against the file just written, non-interactively — Step 2's user checkpoint is skipped because the report was just delivered in this same reply, and the skill proceeds straight through the summary page, entity/concept pages, and the index + log entries. false leaves the wiki untouched and keeps suggesting the manual '/wiki-ingest raw/research/<slug>/index.md' command, which is today's behaviour. 'ask' prompts before ingesting this one report and never writes the answer back to the store — a different mechanism from the per-run override on research.persistToRaw, serving the same 'not this one' need at the ingest step instead of the save step.",
|
|
180
|
+
"values": "true | false | ask",
|
|
181
|
+
"default": false,
|
|
182
|
+
"askedBy": "install-global.sh"
|
|
183
|
+
},
|
|
157
184
|
"uatGenerate.promoteTests": {
|
|
158
185
|
"scope": "either",
|
|
159
186
|
"consumer": "skill",
|
|
@@ -7,9 +7,16 @@
|
|
|
7
7
|
# .git/info/exclude (and recent versions suggest only git-tracked files), so the
|
|
8
8
|
# machine-local excludes written by merge-gitignore.sh blind @-autocomplete on
|
|
9
9
|
# .serena/, raw/, and wiki/. This script re-includes exactly the paths listed
|
|
10
|
-
# under the bootstrap sentinel in .git/info/exclude — a user's other
|
|
11
|
-
# hidden entries stay hidden, and a project with no sentinel block
|
|
12
|
-
# `rg --files` behaviour.
|
|
10
|
+
# under the ONE shared bootstrap sentinel in .git/info/exclude — a user's other
|
|
11
|
+
# deliberately hidden entries stay hidden, and a project with no sentinel block
|
|
12
|
+
# gets plain `rg --files` behaviour. merge-gitignore.sh writes every
|
|
13
|
+
# machine-local exclusion it manages (wiki/agent-state dirs AND the
|
|
14
|
+
# bootstrap-prefs files) under this same sentinel, regardless of which of its
|
|
15
|
+
# prompts got answered or in what order — but re-inclusion below only ever
|
|
16
|
+
# checks `-d`, so of those, only the directories (.serena/, raw/, wiki/) come
|
|
17
|
+
# back in suggestions; the bootstrap-prefs files are plain files and are
|
|
18
|
+
# silently skipped, staying git-excluded but @-invisible. That's intentional,
|
|
19
|
+
# not a bug.
|
|
13
20
|
#
|
|
14
21
|
# Contract (community-verified; not fully spelled out in the settings docs):
|
|
15
22
|
# stdin JSON object with a "query" field
|
|
@@ -23,7 +30,7 @@
|
|
|
23
30
|
# stdout only, and stray stderr is visible noise on every keystroke.
|
|
24
31
|
exec 2>/dev/null
|
|
25
32
|
|
|
26
|
-
SENTINEL='# bootstrap
|
|
33
|
+
SENTINEL='# bootstrap machine-local (autocomplete-visible)'
|
|
27
34
|
MAX_RESULTS=15
|
|
28
35
|
|
|
29
36
|
# --- query -------------------------------------------------------------------
|
|
@@ -58,7 +65,8 @@ list_base() {
|
|
|
58
65
|
|
|
59
66
|
# --- sentinel-scoped re-inclusion -------------------------------------------
|
|
60
67
|
# Emit the lines between the bootstrap sentinel comment and the next comment
|
|
61
|
-
# line (or EOF) in .git/info/exclude — expected values are .serena/, raw/,
|
|
68
|
+
# line (or EOF) in .git/info/exclude — expected values are .serena/, raw/,
|
|
69
|
+
# wiki/, and (skipped below by the `-d` check) the two bootstrap-prefs files.
|
|
62
70
|
sentinel_entries() {
|
|
63
71
|
[ -f .git/info/exclude ] || return 0
|
|
64
72
|
awk -v sentinel="$SENTINEL" '
|
|
@@ -22,16 +22,22 @@ Bootstrap remembers your answers to installer and skill prompts in two flat JSON
|
|
|
22
22
|
`argument-hint: [view | edit | reset] [--global | --project]`
|
|
23
23
|
|
|
24
24
|
- A mode word (`view` / `edit` / `reset`) preselects the mode and skips the Step C question. Steps A and B still run, and the Step B2 summary is still printed first — a mode word skips a question, never the state read.
|
|
25
|
-
- `--global` / `--project` preselects the layer for reads and pins the write layer
|
|
25
|
+
- `--global` / `--project` preselects the layer for reads and pins the write layer. A pinned layer that the chosen key's `scope` forbids is refused by the helper itself (BUG-0009), not silently redirected — Step E offers only permitted layers so the refusal is rarely hit in practice.
|
|
26
26
|
- No arguments = the full interactive flow.
|
|
27
27
|
|
|
28
28
|
---
|
|
29
29
|
|
|
30
30
|
## Step A — Locate the helper, the schema, and the layers
|
|
31
31
|
|
|
32
|
-
1. Resolve the helper path.
|
|
32
|
+
1. Resolve the helper path. There are exactly two valid locations — never search anywhere else, and never search under a project's own `lib/scripts/` (that path exists only inside the bootstrap-claude source repo checkout itself, never in a project that merely installed it):
|
|
33
|
+
- **If the current project is this bootstrap-claude repo itself** (dev checkout — `lib/scripts/bootstrap-prefs.js` exists relative to the project root): use that repo-local copy.
|
|
34
|
+
- **Otherwise (any installed/target project, the common case):** the helper lives at the fixed, project-independent path `~/.claude/bootstrap-prefs.js`, installed there by `install-global.sh` precisely so it's reachable from arbitrary projects. Use that path directly — do not `ls`/`find` for it first.
|
|
35
|
+
- If neither location has the file, abort with this exact message and stop:
|
|
33
36
|
> No bootstrap preference helper found. Run `npx @codewizard-dt/bootstrap update` (or `./lib/scripts/install-global.sh --skip-mcps`) to install it, then re-run `/bootstrap-config`.
|
|
34
|
-
2. Resolve the schema path
|
|
37
|
+
2. Resolve the schema path — it is **not** beside the helper when installed:
|
|
38
|
+
- Repo-local case: `lib/scripts/templates/bootstrap-prefs-schema.json`.
|
|
39
|
+
- Installed case: `~/.claude/templates/bootstrap-prefs-schema.json`. (The helper resolves the schema as `<its own dir>/templates/...`, and the installer deliberately places it there — see `install-global.sh`'s step 6 comment.)
|
|
40
|
+
The helper already defaults to the path matching its own location, so pass `--schema <path>` **only** when a non-default schema was located.
|
|
35
41
|
3. Determine `PROJECT_DIR` — the current working directory when inside a git repo / project, otherwise none. Record whether each layer's file exists:
|
|
36
42
|
- project layer: `<PROJECT_DIR>/.claude/bootstrap-prefs.json`
|
|
37
43
|
- global layer: `~/.claude/bootstrap-prefs.json`
|
|
@@ -106,7 +112,7 @@ Skip this question entirely when a mode word was supplied as an argument — but
|
|
|
106
112
|
5. When the chosen key has `consumer: skill`, print this heavier banner:
|
|
107
113
|
> This is a **skill preference**. Changing it changes what a slash command actually does the next time it runs — not merely whether the installer asks you a question.
|
|
108
114
|
|
|
109
|
-
Name the affected command from the entry's `askedBy` / `summary` — e.g. `gitCommit.versionBump` changes what `/git-commit` does on every commit. The `consumer: skill` population is `gitCommit.versionBump`, `gitCommit.autoPush`, `research.persistToRaw`, `uatGenerate.promoteTests`, and `gitignore.offerSectionUpdates`. Every other key is `consumer: installer` and gets the lighter framing: it only affects whether a setup/update script prompts you.
|
|
115
|
+
Name the affected command from the entry's `askedBy` / `summary` — e.g. `gitCommit.versionBump` changes what `/git-commit` does on every commit. The `consumer: skill` population is `gitCommit.versionBump`, `gitCommit.autoPush`, `research.persistToRaw`, `research.autoIngest`, `uatGenerate.promoteTests`, and `gitignore.offerSectionUpdates`. Every other key is `consumer: installer` and gets the lighter framing: it only affects whether a setup/update script prompts you.
|
|
110
116
|
|
|
111
117
|
## Step E — Choose the value and the layer (edit mode)
|
|
112
118
|
|
|
@@ -118,7 +124,7 @@ Skip this question entirely when a mode word was supplied as an argument — but
|
|
|
118
124
|
- `scope: global` → the global layer only.
|
|
119
125
|
- `scope: either` → ask which, explaining that **project wins over global, per key**.
|
|
120
126
|
|
|
121
|
-
Never offer a layer the key's `scope` makes inert. The helper's `--set`
|
|
127
|
+
Never offer a layer the key's `scope` makes inert. The helper's `--set` itself now refuses a write into a layer the key's `scope` forbids (exit 1, nothing written — BUG-0009) — attempting to write a `global`-scope key into a project file is rejected rather than silently accepted and later filed under "Unrecognized keys" with a never-consulted reason. This step exists so the user is never offered a choice that would hit that refusal, not because the helper depends on it.
|
|
122
128
|
3. If `scope` requires the project layer but no project directory was resolved in Step A, abort that edit with an explanation. Do not fall back to the global layer.
|
|
123
129
|
4. Confirm with one final `AskUserQuestion` (`Yes, apply` / `No, cancel`) showing the exact command about to run:
|
|
124
130
|
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: research
|
|
3
|
-
description: Deep research on a topic using codebase analysis, library docs, and web search — by default also writes the report plus its primary sources to raw/research/<slug>/ (preference-gated by research.persistToRaw; findings are always delivered in the reply)
|
|
3
|
+
description: Deep research on a topic using codebase analysis, library docs, and web search — by default also writes the report plus its primary sources to raw/research/<slug>/ (preference-gated by research.persistToRaw; findings are always delivered in the reply), and can auto-fold a saved report into wiki/ (preference-gated by research.autoIngest)
|
|
4
4
|
category: researching
|
|
5
5
|
model: claude-sonnet-5
|
|
6
6
|
effort: high
|
|
@@ -242,18 +242,38 @@ Rules for this phase:
|
|
|
242
242
|
|
|
243
243
|
---
|
|
244
244
|
|
|
245
|
+
## Phase 5b: Auto-Ingest Gate (only when Phase 5 actually wrote files)
|
|
246
|
+
|
|
247
|
+
This gate governs whether the report just written under `raw/research/<slug>/` is immediately folded into `wiki/`, instead of leaving `/wiki-ingest raw/research/<slug>/index.md` as a manual follow-up. **Skip this phase entirely when Phase 5 wrote nothing** — a suppressed save (stored `false`, a per-run `--no-save`/`--no-persist`, or a declined `ask`) leaves no `raw/` file to ingest.
|
|
248
|
+
|
|
249
|
+
Read the preference once, after Phase 5 completes:
|
|
250
|
+
|
|
251
|
+
```bash
|
|
252
|
+
node ~/.claude/bootstrap-prefs.js --get research.autoIngest --project . 2>/dev/null || echo unset
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
| Value | Behaviour |
|
|
256
|
+
|-------|-----------|
|
|
257
|
+
| `true` | Immediately follow the full procedure in `lib/skills/wiki-ingest/SKILL.md` against the file just written (`raw/research/<slug>/index.md`), non-interactively — skip Step 2's user-checkpoint pause (the report was just delivered in this same reply, so there is nothing new to confirm before proceeding) and go straight through writing/updating the summary page, entity/concept pages, and the `wiki/index.md` + `wiki/log.md` entries. |
|
|
258
|
+
| `false` | Do nothing further. Keep suggesting `/wiki-ingest raw/research/<slug>/index.md` as a manual next step, per Phase 6. |
|
|
259
|
+
| `ask` | Before ingesting, ask the user (AskUserQuestion) whether to fold this report into the wiki now. Honour the answer for **this run only** — never write it back to the store. |
|
|
260
|
+
| `unset` | Do nothing further (today's behaviour — the schema default is `false`), and add one line: "research.autoIngest is unanswered — /research does not auto-ingest by default. Set it with: node ~/.claude/bootstrap-prefs.js --set research.autoIngest --value <true\|false\|ask> --global" |
|
|
261
|
+
|
|
262
|
+
---
|
|
263
|
+
|
|
245
264
|
## Phase 6: Confirm & Suggest Next Steps
|
|
246
265
|
|
|
247
266
|
**If the files were written**, tell the user:
|
|
248
267
|
- The paths written (`raw/research/<slug>/index.md` and `raw/research/<slug>/sources.md`)
|
|
249
268
|
- A 2–4 bullet summary of the recommendation
|
|
250
|
-
-
|
|
269
|
+
- **If Phase 5b ingested the report**: say so, and name the wiki pages it created or updated — do not also suggest `/wiki-ingest`, it already ran.
|
|
270
|
+
- **Otherwise**: that the report is now a `raw/` ground-truth source: **"Run `/wiki-ingest raw/research/<slug>/index.md` to synthesize this research into the knowledge base."**
|
|
251
271
|
- Any follow-on `/task-add` or `/decision-create` suggested by the findings
|
|
252
272
|
|
|
253
273
|
**If nothing was persisted** (stored `false`, a per-run `--no-save`/`--no-persist` override, or a declined `ask`), tell the user:
|
|
254
274
|
- That no files were written, and which of the three reasons applies
|
|
255
275
|
- The same 2–4 bullet summary of the recommendation
|
|
256
|
-
- Skip the `/wiki-ingest` suggestion entirely — there is no `raw/` file to ingest
|
|
276
|
+
- Skip the `/wiki-ingest` suggestion entirely — there is no `raw/` file to ingest, and Phase 5b never ran either
|
|
257
277
|
- Any follow-on `/task-add` or `/decision-create` suggested by the findings
|
|
258
278
|
|
|
259
279
|
---
|
|
@@ -279,3 +299,4 @@ Rules for this phase:
|
|
|
279
299
|
7) **Never overwrite `raw/` files**: if a target already exists, write `<name>-2.md` / `-3.md` instead, carrying only non-redundant new/changed data with a cross-reference to the prior file
|
|
280
300
|
8) **No fabricated sources**: every row in `sources.md` is a source you actually consulted; mark unsupported claims as inferences rather than inventing citations
|
|
281
301
|
9) **`raw/research/` is the only `raw/` path this skill may write to** — never modify or delete anything elsewhere under `raw/`
|
|
302
|
+
10) **Only run Phase 5b when Phase 5 actually wrote files** — the `research.autoIngest` gate is meaningless (and must not run) against a suppressed save; when it does run with `true`, it hands off to `lib/skills/wiki-ingest/SKILL.md`'s own rules (atomic pages, contradiction callouts, index + log updates), which apply exactly as they do for a manually invoked `/wiki-ingest`
|