Merge prep: drop 1.28 MB of stale docs, re-enable periphery

Examples/MistDemo/Scripts/lint.sh

@@ -62,8 +62,34 @@ $PACKAGE_DIR/Scripts/header.sh -d  $PACKAGE_DIR/Sources -c "Leo Dion" -o "Bright
 
 # Generated files now automatically include ignore directives via OpenAPI generator configuration
 
+# Periphery cannot find the index store on its own: its location depends on the
+# build system. swiftbuild (the SwiftPM default since Swift 6.2) writes
+# `.build/out`, the native build system writes
+# `.build/<triple>/debug/index/store`, and older toolchains wrote
+# `.build/debug/index/store`. Resolve it here and hand it over explicitly;
+# `--index-store-path` implies `--skip-build`, which is what we want because
+# `swift build --build-tests` already ran above.
+periphery_index_store() {
+	local candidate
+	for candidate in "$PACKAGE_DIR"/.build/*/debug/index/store \
+		"$PACKAGE_DIR"/.build/debug/index/store \
+		"$PACKAGE_DIR"/.build/out; do
+		if [ -d "$candidate/v5/units" ]; then
+			printf '%s\n' "$candidate"
+			return 0
+		fi
+	done
+	return 1
+}
+
 if [ -z "$CI" ]; then
-	run_command periphery scan $PERIPHERY_OPTIONS --disable-update-check
+	if INDEX_STORE_PATH=$(periphery_index_store); then
+		run_command periphery scan $PERIPHERY_OPTIONS \
+			--index-store-path "$INDEX_STORE_PATH" --skip-build \
+			--disable-update-check
+	else
+		echo "Skipping periphery scan (no index store under .build; run swift build first)."
+	fi
 fi
 
 popd

Scripts/lint.sh

@@ -78,17 +78,38 @@ $PACKAGE_DIR/Scripts/header.sh -d  $PACKAGE_DIR/Sources -c "Leo Dion" -o "Bright
 
 # Generated files now automatically include ignore directives via OpenAPI generator configuration
 
-# Periphery is temporarily skipped: Swift PM now writes the index store under a
-# triple-specific path (e.g. `.build/arm64-apple-macosx/debug/index/store`) and
-# periphery still looks for `.build/debug/index/store`. Re-enable once periphery
-# or this script resolves the path. Also skipped in Claude Code web sessions
-# (no Linux binaries; mise unreachable there).
-if [ "${RUN_PERIPHERY:-}" = "1" ] \
-	&& [ -z "$CI" ] \
-	&& [ "${CLAUDE_CODE_REMOTE:-}" != "true" ]; then
-	run_command periphery scan $PERIPHERY_OPTIONS --disable-update-check
+# Periphery cannot find the index store on its own: its location depends on the
+# build system. swiftbuild (the SwiftPM default since Swift 6.2) writes
+# `.build/out`, the native build system writes
+# `.build/<triple>/debug/index/store`, and older toolchains wrote
+# `.build/debug/index/store`. Resolve it here and hand it over explicitly;
+# `--index-store-path` implies `--skip-build`, which is what we want because
+# `swift build --build-tests` already ran above. Skipped in CI (periphery has
+# never run there) and in Claude Code web sessions (no Linux binaries; mise
+# unreachable per above).
+periphery_index_store() {
+	local candidate
+	for candidate in "$PACKAGE_DIR"/.build/*/debug/index/store \
+		"$PACKAGE_DIR"/.build/debug/index/store \
+		"$PACKAGE_DIR"/.build/out; do
+		if [ -d "$candidate/v5/units" ]; then
+			printf '%s\n' "$candidate"
+			return 0
+		fi
+	done
+	return 1
+}
+
+if [ -z "$CI" ] && [ "${CLAUDE_CODE_REMOTE:-}" != "true" ]; then
+	if INDEX_STORE_PATH=$(periphery_index_store); then
+		run_command periphery scan $PERIPHERY_OPTIONS \
+			--index-store-path "$INDEX_STORE_PATH" --skip-build \
+			--disable-update-check
+	else
+		echo "Skipping periphery scan (no index store under .build; run swift build first)."
+	fi
 else
-	echo "Skipping periphery scan (set RUN_PERIPHERY=1 to opt in)."
+	echo "Skipping periphery scan (CI or Claude Code web session)."
 fi
 
 popd

docs/talk-feedback.md

@@ -5,7 +5,7 @@ Notes from the Riverside dry run with Evan and Josh. The Keynote deck lives outs
 ## Source
 
 - Riverside dry run with Evan + Josh
-- Raw transcript: [`transcriptions/transcript.txt`](transcriptions/transcript.txt)
+- Raw transcript: [`docs/transcriptions/transcript.txt`](https://github.com/brightdigit/MistKit/blob/archive/talk-prep-2026-05-17/docs/transcriptions/transcript.txt) (archived at the `archive/talk-prep-2026-05-17` tag; removed from the working tree)
 - Self-reported deck completeness during the run: ~60%
 
 ## What's Working