elevanaltd/test-ci-pipeline

===TEST_CI_PIPELINE=== META: TYPE::SKILL VERSION::1.0 STATUS::ACTIVE COMPRESSION_TIER::AGGRESSIVE DOMAIN::HEPHAESTUS[tool_crafting]⊕HERMES[coordination]

§1::PRIMARY_SOURCE_MANDATORY_FIRST

SOURCE::.hestai/state/context/test-context/RULES.md PRINCIPLE::"POC-proven pattern post-it note - ALWAYS consult BEFORE infrastructure decisions"

CONTAINS::[ CI_pipeline[2-tier_strategy], environment_variables, port_assignments, TRACED_protocol ]

§2::DETAILED_DOCUMENTATION

CI_PIPELINE::.hestai/state/context/test-context/CI-PIPELINE-CONFIGURATION.md->[turborepo_config, github_actions, quality_gates[typecheck->lint->test], secret_management, parallel_execution, artifact_storage]

§3::POC_REFERENCE_WHEN_NEEDED

PROVEN_CI::/Volumes/HestAI-Projects/eav-ops/eav-apps/scripts-web/.github/workflows/ci.yml KEY_SECTIONS::[ lines_43-120::local_supabase_setup[retry_logic], lines_100-109::migration_application[supabase_db_reset], lines_144-161::test_user_creation[auth_admin_api], lines_236-489::preview_branch_integration, lines_258-285::preview_ready_wait[graceful_skip] ]

§4::CRITICAL_PATTERNS_POC_PROVEN

PATTERN_1::CI_STRATEGY_TWO_TIER::[ TIER_1::quality_gates[all_commits]::[ local_supabase_start, migrations_via_reset, create_test_users, RUN::typecheck->lint->test_unit->build, EVIDENCE::POC_ci.yml:10-221 ], TIER_2::preview_integration[PRs_only]::[ wait_preview_ready, export_preview_env, RUN::test_integration, EVIDENCE::POC_ci.yml:236-489 ] ]

PATTERN_2::RETRY_LOGIC::[ PATTERN::supabase_start[3_attempts+300s_timeout+GoTrue_health_check], BECAUSE::"Handles transient Docker/network failures in CI", IMPLEMENTATION::loop[cleanup_between_attempts+health_check_before_proceed], EVIDENCE::POC_ci.yml:52-98 ]

PATTERN_3::PREVIEW_BRANCH_GRACEFUL_SKIP::[ PATTERN::CI_handles_missing_preview[exit_0≠failure], BECAUSE::"Preview branches deleted after merge OR not created for docs-only PRs", CODE::"if(!preview_exists)->echo('No preview - skipping')->exit_0", EVIDENCE::POC_ci.yml:[336-345, 376-392] ]

§5::TURBOREPO_CONFIGURATION

PIPELINE::[ typecheck::{dependsOn:[^typecheck]}, lint::{dependsOn:[^lint,typecheck]}, test::{dependsOn:[^test,lint], outputs:[coverage/]}, build::{dependsOn:[^build,test], outputs:[dist/]} ]

QUALITY_GATE_SEQUENCE::typecheck->lint->test->build[ALL_BLOCKING]

§6::ENVIRONMENT_CONFIGURATION

ROOT_ENV::[ APP_URLS::[VITE_APP_URL_SCRIPTS:http://localhost:3001, VITE_APP_URL_SCENES:http://localhost:3002, ports_3003-3007] ]

CI_OVERRIDES::[ SUPABASE_PREVIEW_URL:https://preview-branch.supabase.co, SUPABASE_PREVIEW_ANON_KEY:sb_publishable_preview_*, VITEST_INTEGRATION:true ]

§7::DIRECTORY_STRUCTURE

TIER_1::OPERATIONAL_CI_SCRIPTS::[ scripts/create-test-users-via-api.mjs::"Used by GitHub Actions (ci.yml:158)", PURPOSE::CI_operational_scripts[run_outside_vitest] ]

TIER_2::TEST_SETUP_VALIDATION::[ tests/migration-validation/::"Migration testing", tests/setup/create-test-users.ts::"Auth Admin API setup helper", PURPOSE::test_setup_scripts+validation_helpers ]

§8::AGENT_CONSULTATION

CONSULT::[ test-methodology-guardian::"TDD workflow alignment, RED->GREEN->REFACTOR compliance", technical-architect::"Test harness architecture decisions, shared utilities structure", critical-engineer::"Production risk from test infrastructure failures" ]

§9::KNOWLEDGE_BASE_REFERENCES

PRIMARY::.hestai/state/context/test-context/RULES.md[POC_proven_patterns]->CONSULT_FIRST

DOCUMENTATION::[ .hestai/state/context/test-context/CI-PIPELINE-CONFIGURATION.md ]

POC_REFERENCE::[ /Volumes/HestAI-Projects/eav-ops/eav-apps/scripts-web/.github/workflows/ci.yml ]

NORTH_STAR::.hestai/north-star/000-UNIVERSAL-EAV_SYSTEM-D1-NORTH-STAR.md[I7:TDD_RED_discipline, I8:production_grade_quality]

§10::WISDOM

CORE_RULE::"POC-proven patterns are post-it notes - consult BEFORE infrastructure decisions" INTEGRATION::[test-infrastructure, supabase-test-harness, build-execution]

===END===