Pipeline Grammar

Use the pipeline entrypoint for all build/validation workflow commands:

./bin/pipeline <command>

Grammar:

<command> ::= generate | build | test | validate | semantic-graph | semantic-audit | semantic-snapshot | smoke | sitemap | ci | help

Commands

• generate
  Regenerates data-driven interview/video pages plus canonical context summaries from _data/.
• build
  Runs runtime checks, regenerates pages, and builds _site via Jekyll.
• validate
  Runs data integrity checks, SEO/canonical checks, semantic/schema checks, HTMLProofer, and resume/sitemap guardrails against _site.
• semantic-graph
  Generates JSON-LD semantic graph artifacts from rendered _site into tmp/schema-graph.dot and tmp/schema-graph-summary.json.
• semantic-audit
  Generates consolidated semantic quality report in tmp/semantic-quality-report.json.
• semantic-snapshot
  Generates docs/architecture/semantic-graph.md from semantic report artifacts.
• smoke
  Runs Playwright smoke checks against built _site.
• sitemap
  Prints a local sitemap coverage summary (counts by section + URL sample).
• ci
  Full CI core pipeline (build + test + validate).
• help
  Prints grammar and command help.

Common Flows

# Full CI-equivalent local run
./bin/pipeline ci

# Generate semantic graph artifacts from built pages
./bin/pipeline semantic-graph

# Generate consolidated semantic quality report
./bin/pipeline semantic-audit

# Generate docs semantic snapshot from report artifacts
./bin/pipeline semantic-snapshot

# CI + browser smoke checks
./bin/pipeline ci
./bin/pipeline smoke

# Visualize sitemap coverage after a build
./bin/pipeline sitemap

# Build only (useful when iterating on templates/content)
./bin/pipeline build

# Validate existing _site output without rebuilding
./bin/pipeline validate

Notes

• In CI, the workflow runs:
  • ./bin/pipeline ci
  • ./bin/pipeline smoke
• If your shell runtime does not match .tool-versions, pipeline commands fail fast with a version mismatch message.
• Build-time last-modified metadata:
  • ./bin/pipeline build and ./bin/pipeline ci generate git-based post last-modified values into _data/last_modified.yml.
  • Validation ensures each built article page exposes dateModified and matches generated values.

Canonical Script Names

• Generators:
  • bin/sync_interview_asset_links.rb
  • bin/generate_interview_pages.rb
  • bin/generate_video_asset_pages.rb
  • bin/generate_interview_taxonomy_pages.rb
  • bin/generate_context_summaries.rb
  • bin/generate_last_modified.rb
• Validators/reports:
  • bin/validate_data_uniqueness.rb
  • bin/validate_data_integrity.rb
  • bin/validate_resources_output.rb
  • bin/validate_taxonomy_output.rb
  • bin/validate_last_modified_output.rb
  • bin/validate_seo_output.rb
  • bin/validate_public_index_mode.rb
  • bin/validate_semantic_output.rb
  • bin/report_seo_metadata.rb
  • bin/visualize_semantic_graph.rb
  • bin/semantic_audit.rb
  • bin/generate_semantic_snapshot_page.rb
  • bin/visualize_sitemap.rb