{"id":601,"date":"2026-03-21T22:52:56","date_gmt":"2026-03-21T14:52:56","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/ci\/"},"modified":"2026-03-21T23:08:57","modified_gmt":"2026-03-21T15:08:57","slug":"ci","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/ci\/","title":{"rendered":"CI Pipeline"},"content":{"rendered":"

CI Pipeline<\/h1>\n

The CI runs on every push to main<\/code> and every pull request. It uses smart scoping to skip expensive jobs when only unrelated areas changed.<\/p>\n

Job Overview<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Job<\/th>\nPurpose<\/th>\nWhen it runs<\/th>\n<\/tr>\n<\/thead>\n
docs-scope<\/code><\/td>\nDetect docs-only changes<\/td>\nAlways<\/td>\n<\/tr>\n
changed-scope<\/code><\/td>\nDetect which areas changed (node\/macos\/android\/windows)<\/td>\nNon-doc changes<\/td>\n<\/tr>\n
check<\/code><\/td>\nTypeScript types, lint, format<\/td>\nNon-docs, node changes<\/td>\n<\/tr>\n
check-docs<\/code><\/td>\nMarkdown lint + broken link check<\/td>\nDocs changed<\/td>\n<\/tr>\n
secrets<\/code><\/td>\nDetect leaked secrets<\/td>\nAlways<\/td>\n<\/tr>\n
build-artifacts<\/code><\/td>\nBuild dist once, share with release-check<\/code><\/td>\nPushes to main<\/code>, node changes<\/td>\n<\/tr>\n
release-check<\/code><\/td>\nValidate npm pack contents<\/td>\nPushes to main<\/code> after build<\/td>\n<\/tr>\n
checks<\/code><\/td>\nNode tests + protocol check on PRs; Bun compat on push<\/td>\nNon-docs, node changes<\/td>\n<\/tr>\n
compat-node22<\/code><\/td>\nMinimum supported Node runtime compatibility<\/td>\nPushes to main<\/code>, node changes<\/td>\n<\/tr>\n
checks-windows<\/code><\/td>\nWindows-specific tests<\/td>\nNon-docs, windows-relevant changes<\/td>\n<\/tr>\n
macos<\/code><\/td>\nSwift lint\/build\/test + TS tests<\/td>\nPRs with macos changes<\/td>\n<\/tr>\n
android<\/code><\/td>\nGradle build + tests<\/td>\nNon-docs, android changes<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Fail-Fast Order<\/h2>\n

Jobs are ordered so cheap checks fail before expensive ones run:<\/p>\n

    \n
  1. docs-scope<\/code> + changed-scope<\/code> + check<\/code> + secrets<\/code> (parallel, cheap gates first)<\/li>\n
  2. PRs: checks<\/code> (Linux Node test split into 2 shards), checks-windows<\/code>, macos<\/code>, android<\/code><\/li>\n
  3. Pushes to main<\/code>: build-artifacts<\/code> + release-check<\/code> + Bun compat + compat-node22<\/code><\/li>\n<\/ol>\n

    Scope logic lives in scripts\/ci-changed-scope.mjs<\/code> and is covered by unit tests in src\/scripts\/ci-changed-scope.test.ts<\/code>.<\/p>\n

    Runners<\/h2>\n\n\n\n\n\n\n\n
    Runner<\/th>\nJobs<\/th>\n<\/tr>\n<\/thead>\n
    blacksmith-16vcpu-ubuntu-2404<\/code><\/td>\nMost Linux jobs, including scope detection<\/td>\n<\/tr>\n
    blacksmith-32vcpu-windows-2025<\/code><\/td>\nchecks-windows<\/code><\/td>\n<\/tr>\n
    macos-latest<\/code><\/td>\nmacos<\/code>, ios<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Local Equivalents<\/h2>\n

    bash theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
    \npnpm check # types + lint + format
    \npnpm test # vitest tests
    \npnpm check:docs # docs format + lint + broken links
    \npnpm release:check # validate npm pack<\/code><\/p>\n","protected":false},"excerpt":{"rendered":"

    CI Pipeline The CI runs on every push to main and every […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-601","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/601","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=601"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/601\/revisions"}],"predecessor-version":[{"id":739,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/601\/revisions\/739"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=601"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=601"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=601"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}