[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M757YCQXFPG16V3CM9044JC8":3,"skill-same:01M757YCQXFPG16V3CM9044JC8":64},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":41,"commitSha":42,"skillDirectory":43,"forksCount":44,"repositoryHtmlUrl":45,"repositoryHomepageUrl":46,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":48,"updatedAt":49,"install":50,"resources":63},"01M757YCQXFPG16V3CM9044JC8","ci-pipeline-hardening",null,"Fix CI gates: bounded subsets, parity, coverage baselines.","lukemcqueen\u002Fsteadfaste-fleet","lukemcqueen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F405240?v=4","01M757MHPAGRXTJAT46SKZP98R","Luke McQueen","01M757MHPZ573KP8DT9GB8SBQ7",4,"MIT","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fci-pipeline-hardening\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: ci-pipeline-hardening\ndescription: \"Fix CI gates: bounded subsets, parity, coverage baselines.\"\nversion: 1.0.0\nauthor: Titus\nlicense: MIT\nplatforms: [linux, macos]\nmetadata:\n  hermes:\n    tags: [ci, gitlab, github-actions, gates, coverage, typecheck]\n    related_skills: [ci-cd-pipeline, test-driven-development]\n---\n\n# CI Pipeline Hardening\n\nClass-level playbook for auditing and fixing an existing CI pipeline before a\nrelease — the gap-analysis pass you run when a review or story says \"CI is\nmissing\u002Fbroken\" but a pipeline file already exists. Focus: gate correctness,\nbounded subsets, coverage honesty, and the small command pitfalls that break\njobs silently.\n\n## When to Use\n\n- A review\u002Fstory claims \"no CI in repo\" or \"CI gate missing\" — verify first\n- test-api runs the FULL suite and takes 20-30+ min or OOMs on small DBs\n- A lint\u002Ftypecheck job wraps an npm script with `npx`\n- Coverage NFR rows in an ADR have percentages but zero measurements\n- A parity\u002Fconsistency script exists but nothing in CI calls it\n\n## Verify the Claim First\n\nBefore believing a review that says CI is absent, check history — reviews are\nwritten against a commit and go stale fast:\n\n```bash\ngit log --oneline --all -- .gitlab-ci.yml .github\u002Fworkflows\u002Fci.yml .circleci\n```\n\nOne review dated 2026-08-20 claimed \"no CI in repo\" while `.gitlab-ci.yml` had\nbeen committed 12 days earlier. Trust git, not the review's assertion.\n\n## Audit Checklist (run against the pipeline file)\n\n- [ ] **Typecheck command**: does any step use `npx \u003Cflags> \u003Ccmd>` with flags AFTER the command? `npx tsc --noEmit --prefix apps\u002Fweb` passes `--prefix` to tsc → job fails. Fix: `npm run typecheck --prefix apps\u002Fweb` (npm accepts `--prefix` after the subcommand) or `npx --prefix apps\u002Fweb tsc --noEmit`. npx and npm flag placement are NOT symmetric.\n- [ ] **Full suite as push gate**: if pytest runs everything, bound it. Full suite 30+ min with OOM risk on a small dev DB is not a push gate. Pick a core subset that proves release-critical paths (health, lookups, iswc, multitenant, golden fixtures, webhooks, shares) — ~109 tests ≈ 23s — and keep the full suite runnable via the local runner.\n- [ ] **Consistency\u002Fparity scripts wired in**: `grep` the pipeline for any repo consistency gate (e.g. `scripts\u002Fcheck_job_parity.py`). A gate that isn't in CI is not a gate. Call it BEFORE the tests it guards.\n- [ ] **Coverage measured, not asserted**: `pytest --cov=app --cov-report=xml` and `vitest run --coverage` must exist in the pipeline, and the numbers must be recorded in the test-strategy ADR — with ratcheting targets (e.g. web 56% → 80% over two waves), not a bare \">90%\" claim.\n- [ ] **YAML validity**: validate before merging (`python -c \"import yaml; yaml.safe_load(open('.gitlab-ci.yml'))\"` from a venv with PyYAML).\n- [ ] **Run every command locally with identical args**: you can't always trigger the runner — prove each CI step locally with the same flags, and say so honestly in the report.\n\n## Coverage Baseline Workflow\n\n1. Run the bounded API subset with coverage: `pytest \u003Ccore-files> --cov=app --cov-report=term-missing` — record total % and test count.\n2. Run web coverage: `vitest run --coverage` — record statements\u002Flines %.\n3. Update the test-strategy ADR: status → Implemented\u002Fmeasured, NFR rows re-baselined with real numbers and rationale, ratcheting targets named.\n4. Wire both into CI (`--cov-report=xml` artifact for API; `-- --coverage` for web).\n\n## Verification\n\n- `tsc --noEmit` → 0 errors (also catches fixture drift — see below)\n- Bounded subset green (e.g. 109\u002F109 in ~23s)\n- Parity\u002Fconsistency gate PASS (e.g. 51\u002F51)\n- Pipeline YAML parses\n- ADR shows measured numbers, not assertions\n\n## Pitfalls\n\n- **Schema field additions break typed test fixtures** (typecheck gate is the trap-catcher, not vitest — loose runtime mocks pass vitest but fail `tsc`). When an API type gains required fields (e.g. m26 name separation added `firstname\u002Ffirstname_ko\u002Flastname\u002Flastname_ko` to MemberRead\u002FPublisherRead\u002FCreatorListRead and `first_name\u002Flast_name` to UserResponse), 22 errors across 8 web fixture files appeared. Fix fixtures in the SAME change as the type change — never defer to a \"separate cleanup PR\" — then re-run `tsc --noEmit` to 0 errors. Publishers keep nulls (never auto-split); realistic parts for members\u002Fcreators.\n- **`test-web` needs `-- --coverage` passthrough**: `npm run test --prefix apps\u002Fweb` runs `vitest run` without coverage; add `-- --coverage` to exercise the cov report in CI.\n- **Transient DB recovery**: `asyncpg.exceptions.CannotConnectNowError: the database system is in recovery mode` is a known postgres blip — retry the run after ~15s before investigating.\n","# CI Pipeline Hardening\n\nClass-level playbook for auditing and fixing an existing CI pipeline before a\nrelease — the gap-analysis pass you run when a review or story says \"CI is\nmissing\u002Fbroken\" but a pipeline file already exists. Focus: gate correctness,\nbounded subsets, coverage honesty, and the small command pitfalls that break\njobs silently.\n\n## When to Use\n\n- A review\u002Fstory claims \"no CI in repo\" or \"CI gate missing\" — verify first\n- test-api runs the FULL suite and takes 20-30+ min or OOMs on small DBs\n- A lint\u002Ftypecheck job wraps an npm script with `npx`\n- Coverage NFR rows in an ADR have percentages but zero measurements\n- A parity\u002Fconsistency script exists but nothing in CI calls it\n\n## Verify the Claim First\n\nBefore believing a review that says CI is absent, check history — reviews are\nwritten against a commit and go stale fast:\n\n```bash\ngit log --oneline --all -- .gitlab-ci.yml .github\u002Fworkflows\u002Fci.yml .circleci\n```\n\nOne review dated 2026-08-20 claimed \"no CI in repo\" while `.gitlab-ci.yml` had\nbeen committed 12 days earlier. Trust git, not the review's assertion.\n\n## Audit Checklist (run against the pipeline file)\n\n- [ ] **Typecheck command**: does any step use `npx \u003Cflags> \u003Ccmd>` with flags AFTER the command? `npx tsc --noEmit --prefix apps\u002Fweb` passes `--prefix` to tsc → job fails. Fix: `npm run typecheck --prefix apps\u002Fweb` (npm accepts `--prefix` after the subcommand) or `npx --prefix apps\u002Fweb tsc --noEmit`. npx and npm flag placement are NOT symmetric.\n- [ ] **Full suite as push gate**: if pytest runs everything, bound it. Full suite 30+ min with OOM risk on a small dev DB is not a push gate. Pick a core subset that proves release-critical paths (health, lookups, iswc, multitenant, golden fixtures, webhooks, shares) — ~109 tests ≈ 23s — and keep the full suite runnable via the local runner.\n- [ ] **Consistency\u002Fparity scripts wired in**: `grep` the pipeline for any repo consistency gate (e.g. `scripts\u002Fcheck_job_parity.py`). A gate that isn't in CI is not a gate. Call it BEFORE the tests it guards.\n- [ ] **Coverage measured, not asserted**: `pytest --cov=app --cov-report=xml` and `vitest run --coverage` must exist in the pipeline, and the numbers must be recorded in the test-strategy ADR — with ratcheting targets (e.g. web 56% → 80% over two waves), not a bare \">90%\" claim.\n- [ ] **YAML validity**: validate before merging (`python -c \"import yaml; yaml.safe_load(open('.gitlab-ci.yml'))\"` from a venv with PyYAML).\n- [ ] **Run every command locally with identical args**: you can't always trigger the runner — prove each CI step locally with the same flags, and say so honestly in the report.\n\n## Coverage Baseline Workflow\n\n1. Run the bounded API subset with coverage: `pytest \u003Ccore-files> --cov=app --cov-report=term-missing` — record total % and test count.\n2. Run web coverage: `vitest run --coverage` — record statements\u002Flines %.\n3. Update the test-strategy ADR: status → Implemented\u002Fmeasured, NFR rows re-baselined with real numbers and rationale, ratcheting targets named.\n4. Wire both into CI (`--cov-report=xml` artifact for API; `-- --coverage` for web).\n\n## Verification\n\n- `tsc --noEmit` → 0 errors (also catches fixture drift — see below)\n- Bounded subset green (e.g. 109\u002F109 in ~23s)\n- Parity\u002Fconsistency gate PASS (e.g. 51\u002F51)\n- Pipeline YAML parses\n- ADR shows measured numbers, not assertions\n\n## Pitfalls\n\n- **Schema field additions break typed test fixtures** (typecheck gate is the trap-catcher, not vitest — loose runtime mocks pass vitest but fail `tsc`). When an API type gains required fields (e.g. m26 name separation added `firstname\u002Ffirstname_ko\u002Flastname\u002Flastname_ko` to MemberRead\u002FPublisherRead\u002FCreatorListRead and `first_name\u002Flast_name` to UserResponse), 22 errors across 8 web fixture files appeared. Fix fixtures in the SAME change as the type change — never defer to a \"separate cleanup PR\" — then re-run `tsc --noEmit` to 0 errors. Publishers keep nulls (never auto-split); realistic parts for members\u002Fcreators.\n- **`test-web` needs `-- --coverage` passthrough**: `npm run test --prefix apps\u002Fweb` runs `vitest run` without coverage; add `-- --coverage` to exercise the cov report in CI.\n- **Transient DB recovery**: `asyncpg.exceptions.CannotConnectNowError: the database system is in recovery mode` is a known postgres blip — retry the run after ~15s before investigating.\n",{"name":5,"author":24,"license":15,"version":25,"metadata":26,"platforms":38,"description":7},"Titus","1.0.0",{"hermes":27},{"tags":28,"related_skills":35},[29,30,31,32,33,34],"ci","gitlab","github-actions","gates","coverage","typecheck",[36,37],"ci-cd-pipeline","test-driven-development",[39,40],"linux","macos","main","2e6aa8d15ab0a366c90be54f61bf9c6e97015e83","skills\u002Fdevops\u002Fci-pipeline-hardening",1,"https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet","steadfaste.com","https:\u002F\u002Fgithub.com\u002Flukemcqueen","AI Architect | Building Hermes Cortex: governed multi-agent AI for autonomous software engineering | Enterprise Tech Consultant","2026-11-14 22:33:34",{"source":8,"skillName":5,"commands":51,"prompt":61,"zipAvailable":62},[52,55,58],{"tool":53,"command":54},"npx","npx skills add lukemcqueen\u002Fsteadfaste-fleet --skill ci-pipeline-hardening",{"tool":56,"command":57},"bunx","bunx skills add lukemcqueen\u002Fsteadfaste-fleet --skill ci-pipeline-hardening",{"tool":59,"command":60},"pnpm","pnpm dlx skills add lukemcqueen\u002Fsteadfaste-fleet --skill ci-pipeline-hardening","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fci-pipeline-hardening\u002FSKILL.md",true,[],[65,73,80,87,94,101],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":72},"01M7DXY4G8NSVB59K8B6S2AQNP","macbook-linux-maintenance","Legacy MacBook Linux fixes: GPU wedge, reboot hang, thermal.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fmacbook-linux-maintenance\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":74,"name":75,"nameZh":6,"description":76,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":77,"categories":78,"keywords":79,"publishedAt":72},"01M7DXXYJCXFJ3TGB84ZQ8KFE6","governance-regression-triage","Triage a host's governance issues: what changed.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fgovernance-regression-triage\u002FSKILL.md",[],[],{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":86,"publishedAt":72},"01M7DXXSAP1G8FDRJAMXQGBBMK","enforcement-immutability","Use when enforcement files lose their immutable flag.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fenforcement-immutability\u002FSKILL.md",[],[],{"skillNo":88,"name":89,"nameZh":6,"description":90,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":72},"01M78SSDQVRYX64Y16X32TC0NS","steadfaste-fleet-repo-deploy","Use when committing to the steadfaste-fleet repo.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fsteadfaste-fleet-repo-deploy\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":72},"01M78SS928F3R2RJAYVW4E30CE","steadfaste-fleet-maintenance","Maintain an installed Steadfaste Fleet instance — update both the upstream Hermes Agent and the fleet repo layer, merge diverged histories, sync skills safely, and troubleshoot common issues. Covers the dual-update workflow (hermes update + fleet-update.sh), encrypted brain data backup, mycortex import, and recovery techniques.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Fsteadfaste-fleet-maintenance\u002FSKILL.md",[],[],{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":72},"01M78SP1CHW0T0BWE5ZT6JBPX8","fleet-preflight","DEPRECATED alias — merged into survey-before-action (2026-08-20). Load survey-before-action instead; its \"Repo-Specific Pre-Flight\" section covers git search, Hermes boundary, and deployment verification.","https:\u002F\u002Fgithub.com\u002Flukemcqueen\u002Fsteadfaste-fleet\u002Fblob\u002Fmain\u002Fskills\u002Fdevops\u002Ffleet-preflight\u002FSKILL.md",[],[]]