feat(usc,ecfr): emit alt-granularity outputs in incremental updates

  Wire update-usc.sh and update-ecfr.sh to re-emit title/chapter (and
  part, for eCFR) outputs alongside the section convert, and rsync them
  to the VPS. Reuses the already-computed changed-title list so only
  touched titles are regenerated on incremental runs.

Author: chris-c-thomas

scripts/update-ecfr.sh

@@ -12,12 +12,12 @@
 # Steps:
 #   1. Detect changed titles via eCFR API metadata
 #   2. Download changed title XML from eCFR API
-#   3. Convert changed titles to Markdown (writeFileIfChanged preserves mtimes)
+#   3. Convert changed titles to Markdown at all granularities (section, title, chapter, part)
 #   4. Generate highlights for changed sections (mtime-based, skippable)
 #   5. Regenerate eCFR nav JSON
 #   6. Regenerate sitemaps
 #   7. Save checkpoint
-#   8. Rsync content + nav + sitemaps to VPS
+#   8. Rsync content (all granularities) + nav + sitemaps to VPS
 #   9. Incremental search index on VPS
 #
 # Requires:
@@ -157,9 +157,18 @@ if [ "$DEPLOY_ONLY" = false ]; then
   $CLI download-ecfr $TITLE_ARG
   echo ""
 
-  # Step 3: Convert
+  # Step 3: Convert at every granularity. Section is the default output; title,
+  # chapter, and part re-emit the same parsed AST at higher levels for the
+  # Astro app's browsable landing pages. writeFileIfChanged preserves mtimes.
   echo "--- Step 3/7: Converting eCFR titles ($TITLE_ARG)"
+  echo "    section granularity"
   $CLI convert-ecfr $TITLE_ARG $CURRENCY_ARG
+  echo "    title granularity"
+  $CLI convert-ecfr $TITLE_ARG $CURRENCY_ARG -g title -o ./output-title
+  echo "    chapter granularity"
+  $CLI convert-ecfr $TITLE_ARG $CURRENCY_ARG -g chapter -o ./output-chapter
+  echo "    part granularity"
+  $CLI convert-ecfr $TITLE_ARG $CURRENCY_ARG -g part -o ./output-part
   echo ""
 
   # Step 4: Highlights (optional)
@@ -208,6 +217,21 @@ if [ -d "output/ecfr" ]; then
   rsync -avz --checksum output/ecfr/ "${VPS_HOST}:${CONTENT_DEST}/ecfr/sections/"
 fi
 
+if [ -d "output-title/ecfr" ]; then
+  echo "    eCFR titles"
+  rsync -avz output-title/ecfr/ "${VPS_HOST}:${CONTENT_DEST}/ecfr/titles/"
+fi
+
+if [ -d "output-chapter/ecfr" ]; then
+  echo "    eCFR chapters"
+  rsync -avz output-chapter/ecfr/ "${VPS_HOST}:${CONTENT_DEST}/ecfr/chapters/"
+fi
+
+if [ -d "output-part/ecfr" ]; then
+  echo "    eCFR parts"
+  rsync -avz output-part/ecfr/ "${VPS_HOST}:${CONTENT_DEST}/ecfr/parts/"
+fi
+
 if [ -d "apps/astro/public/nav" ]; then
   echo "    Nav JSON"
   rsync -avz --delete apps/astro/public/nav/ "${VPS_HOST}:${NAV_DEST}/"

scripts/update-usc.sh

@@ -11,12 +11,12 @@
 # Steps:
 #   1. Check latest OLRC release point against stored checkpoint
 #   2. Download all USC titles (bulk zip)
-#   3. Convert all titles to Markdown (writeFileIfChanged preserves mtimes)
+#   3. Convert all titles to Markdown at every granularity (section, title, chapter)
 #   4. Generate highlights for changed sections (mtime-based, skippable)
 #   5. Regenerate USC nav JSON
 #   6. Regenerate sitemaps
 #   7. Save new release point
-#   8. Rsync content + nav + sitemaps to VPS
+#   8. Rsync content (all granularities) + nav + sitemaps to VPS
 #   9. Incremental search index on VPS
 #
 # Requires:
@@ -140,9 +140,16 @@ if [ "$DEPLOY_ONLY" = false ]; then
   $CLI download-usc --all
   echo ""
 
-  # Step 3: Convert
+  # Step 3: Convert at every granularity. Section is the default output; title
+  # and chapter re-emit the same parsed AST at higher levels for the Astro
+  # app's browsable landing pages. writeFileIfChanged preserves mtimes.
   echo "--- Step 3/7: Converting USC titles"
+  echo "    section granularity"
   $CLI convert-usc --all
+  echo "    title granularity"
+  $CLI convert-usc --all -g title -o ./output-title
+  echo "    chapter granularity"
+  $CLI convert-usc --all -g chapter -o ./output-chapter
   echo ""
 
   # Step 4: Highlights (optional)
@@ -193,6 +200,16 @@ if [ -d "output/usc" ]; then
   rsync -avz --checksum output/usc/ "${VPS_HOST}:${CONTENT_DEST}/usc/sections/"
 fi
 
+if [ -d "output-title/usc" ]; then
+  echo "    USC titles"
+  rsync -avz output-title/usc/ "${VPS_HOST}:${CONTENT_DEST}/usc/titles/"
+fi
+
+if [ -d "output-chapter/usc" ]; then
+  echo "    USC chapters"
+  rsync -avz output-chapter/usc/ "${VPS_HOST}:${CONTENT_DEST}/usc/chapters/"
+fi
+
 if [ -d "apps/astro/public/nav" ]; then
   echo "    Nav JSON"
   rsync -avz --delete apps/astro/public/nav/ "${VPS_HOST}:${NAV_DEST}/"