@catladder/cli 5.3.0 → 5.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/dist/apps/cli/src/release/changesetCheckJob.js +17 -10
  2. package/dist/apps/cli/src/release/changesetCheckJob.js.map +1 -1
  3. package/dist/bundles/catci/index.js +1 -1
  4. package/dist/bundles/catenv/index.js +42 -7
  5. package/dist/bundles/cli/index.js +42 -7
  6. package/dist/bundles/skills/catladder-deploys/SKILL.md +8 -1
  7. package/dist/bundles/skills/catladder-deploys/references/deploy-types.md +1 -1
  8. package/dist/bundles/skills/catladder-migrate-release-method/SKILL.md +4 -3
  9. package/dist/bundles/skills/catladder-releases/SKILL.md +12 -7
  10. package/dist/packages/pipeline/src/backends/gitlab/createGitlabJobs.js +7 -2
  11. package/dist/packages/pipeline/src/backends/gitlab/createGitlabJobs.js.map +1 -1
  12. package/dist/packages/pipeline/src/backends/gitlab/gitlabReleaseJobs.js +5 -3
  13. package/dist/packages/pipeline/src/backends/gitlab/gitlabReleaseJobs.js.map +1 -1
  14. package/dist/packages/pipeline/src/backends/types.d.ts +6 -2
  15. package/dist/packages/pipeline/src/customImages/hash.d.ts +4 -0
  16. package/dist/packages/pipeline/src/customImages/hash.js +3 -0
  17. package/dist/packages/pipeline/src/customImages/hash.js.map +1 -1
  18. package/dist/packages/pipeline/src/customImages/jobImagesPlan.d.ts +2 -1
  19. package/dist/packages/pipeline/src/customImages/jobImagesPlan.js +21 -1
  20. package/dist/packages/pipeline/src/customImages/jobImagesPlan.js.map +1 -1
  21. package/dist/packages/pipeline/src/pipeline/generatePipelineFiles.js +1 -1
  22. package/dist/packages/pipeline/src/pipeline/generatePipelineFiles.js.map +1 -1
  23. package/dist/packages/pipeline/src/utils/writeFiles.d.ts +2 -1
  24. package/dist/packages/pipeline/src/utils/writeFiles.js +5 -0
  25. package/dist/packages/pipeline/src/utils/writeFiles.js.map +1 -1
  26. package/dist/skills/catladder-deploys/SKILL.md +8 -1
  27. package/dist/skills/catladder-deploys/references/deploy-types.md +1 -1
  28. package/dist/skills/catladder-migrate-release-method/SKILL.md +4 -3
  29. package/dist/skills/catladder-releases/SKILL.md +12 -7
  30. package/dist/tsconfig.tsbuildinfo +1 -1
  31. package/package.json +1 -1
  32. package/src/release/__tests__/changesetCheckJob.test.ts +68 -0
  33. package/src/release/changesetCheckJob.ts +18 -10
@@ -1 +1 @@
1
- {"version":3,"file":"writeFiles.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/utils/writeFiles.ts"],"names":[],"mappings":";;;AAAA,0CAAwC;AACxC,+BAAiC;AAQjC;;;;GAIG;AACU,QAAA,qBAAqB,GAChC,2CAA2C,CAAC;AAMjC,QAAA,oBAAoB,GAAqB;IACpD,iEAAiE;IACjE,SAAS,EAAE,CAAC;IACZ,4DAA4D;IAC5D,kBAAkB,EAAE,IAAI;IACxB,qEAAqE;IACrE,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF,MAAa,UAAU;IACd,MAAM,CAAC,MAAM,CAAC,MAAc;QACjC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAES,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,OAAe;;QACxD,MAAM,kBAAkB,GACtB,MAAM,CAAA,MAAA,MAAA,IAAI,CAAC,MAAM,CAAC,KAAK,0CAAE,wBAAwB,mDAAG;YAClD,GAAG,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACxC,OAAO;SACR,CAAC,CAAA,CAAC;QACL,MAAM,IAAA,oBAAS,EAAC,IAAI,EAAE,kBAAkB,aAAlB,kBAAkB,cAAlB,kBAAkB,GAAI,OAAO,EAAE;YACnD,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAAC,kBAAkB,CAAC,IAAY;;QAC7C,MAAM,QAAQ,GAAG,MAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,mCAAI,EAAE,CAAC;QAC7C,OAAO;YACL,QAAQ;YACR,IAAI;YACJ,SAAS,EAAE,MAAA,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,mCAAI,EAAE;SACvC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,qBAAqB,CAAC,IAAY,EAAE,OAAe;QAC9D,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAC7B,IAAY,EACZ,OAAe,EACf,OAAyB;QAEzB,MAAM,IAAI,CAAC,YAAY,CACrB,IAAI,EACJ,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACvE,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,IAAS;;QAChD,MAAM,eAAe,GAAG,MAAM,CAAA,MAAA,MAAA,IAAI,CAAC,MAAM,CAAC,KAAK,0CAAE,wBAAwB,mDACvE;YACE,GAAG,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI;SACL,CACF,CAAA,CAAC;QACF,OAAO,IAAI,CAAC,kBAAkB,CAC5B,IAAI,EACJ,IAAA,gBAAS,EAAC,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,IAAI,EAAE,4BAAoB,CAAC,EACxD;YACE,WAAW,EAAE,GAAG;SACjB,CACF,CAAC;IACJ,CAAC;IAES,sBAAsB,CAAC,WAAmB;QAClD,OAAO;YACL,mDAAmD;YACnD,6BAAqB;YACrB,sCAAsC;YACtC,mDAAmD;SACpD;aACE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC;aACvC,IAAI,CAAC,IAAI,CAAC;aACV,MAAM,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;CACF;AA5ED,gCA4EC"}
1
+ {"version":3,"file":"writeFiles.js","sourceRoot":"","sources":["../../../../../../../packages/pipeline/src/utils/writeFiles.ts"],"names":[],"mappings":"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"}
@@ -124,7 +124,14 @@ publishes `publishDir` (default `"public"`). Review environments
124
124
  automatically publish under an `mr-<iid>` path prefix — every merge
125
125
  request gets its own site preview (the prefix is exposed to the build
126
126
  as `$PAGES_PREFIX`). The gitlab environment url points at the
127
- published site. GitLab-only for now.
127
+ published site.
128
+
129
+ **MR previews need GitLab Premium/Ultimate** (parallel deployments /
130
+ `pages.path_prefix`). On GitLab CE/Free the prefix is ignored and the
131
+ review job publishes to the site root, silently overwriting the main
132
+ site — on such instances set `env: { review: false }` on the pages
133
+ component. Ask which tier the instance runs when unsure (a self-hosted
134
+ `git.<company>` instance is often CE).
128
135
 
129
136
  ```ts
130
137
  docs: {
@@ -65,7 +65,7 @@ resources with `yarn catladder project setup`; detect drift with
65
65
  - `publishDir?: string` — output directory relative to the repo root, default `"public"`.
66
66
  - `requiresInstall?: boolean` — run the package-manager install (yarn/pnpm) first (`requiresYarnInstall` is a deprecated alias).
67
67
  - `jobImage?: GitlabJobImage`; also accepts `cache`.
68
- - Review envs publish under an `mr-<iid>` path prefix (parallel deployments → MR previews; exposed as `$PAGES_PREFIX`); other envs publish at the root. The environment url is the published pages url.
68
+ - Review envs publish under an `mr-<iid>` path prefix (parallel deployments → MR previews; exposed as `$PAGES_PREFIX`); other envs publish at the root. Parallel deployments are GitLab Premium/Ultimate — on CE/Free the prefix is ignored and a review deploy overwrites the main site, so set `env: { review: false }` there. The environment url is the published pages url.
69
69
  - Defaults to `allowFailure: true`.
70
70
 
71
71
  ## `dockerTag`
@@ -184,9 +184,10 @@ changesets — see the `catladder-config` skill.
184
184
  pending bump = next release `vA.B.C`*. If that is not what the user
185
185
  expects, the bump levels are wrong.
186
186
  - The merge request now runs the **`🦋 changeset check`** job. It should
187
- report the pending changesets and that same version. A yellow check
188
- only means "this MR adds no changeset" — for the migration MR itself
189
- that is not the case, so expect it green.
187
+ report the pending changesets and that same version. A "⚠️ adds no
188
+ changeset" warning in the report only means "this MR adds no
189
+ changeset" — for the migration MR itself that is not the case, so
190
+ expect it to list the backfilled changesets.
190
191
  - Do **not** hand-write `CHANGELOG.md`. The release job prepends the new
191
192
  section; anything you write by hand there gets duplicated.
192
193
  - Leave any `.releaserc` / `release.config.js` alone if the project has
@@ -96,18 +96,23 @@ Changesets projects get a **`🦋 changeset check`** job in every
96
96
  merge-request pipeline. It reports what merging would do — the
97
97
  changesets this MR adds, everything pending, and the version the next
98
98
  release would get (with a changelog preview) — and **warns without
99
- blocking** (`allow_failure`) when the MR adds no changeset:
99
+ blocking** when the MR adds no changeset. The job itself stays green on
100
+ both platforms: the warning lives in the report, the job log and the
101
+ sticky comment.
100
102
 
101
103
  - **GitLab**: report in the job log and as an exposed artifact
102
104
  (`changeset-report.md`) in the MR widget. If the project makes
103
105
  `GL_TOKEN` available to MR pipelines it also maintains a sticky MR
104
106
  comment (opt-in — an api-scope token in MR pipelines is a security
105
- trade-off).
106
- - **GitHub**: maintains a sticky PR comment via the workflow token; the
107
- job stays green and reports a warning annotation (github has no
108
- yellow job state, and a red job would read like a real failure).
109
-
110
- A yellow changeset-check job on an MR is a prompt to ask: is this
107
+ trade-off). The job deliberately does not turn yellow: gitlab only
108
+ resolves exposed artifacts of successful jobs, so a failed
109
+ `allow_failure` job leaves the MR widget spinning on "Loading
110
+ artifacts".
111
+ - **GitHub**: maintains a sticky PR comment via the workflow token and
112
+ reports a warning annotation (github has no yellow job state, and a
113
+ red job would read like a real failure).
114
+
115
+ A "⚠️ adds no changeset" report on an MR is a prompt to ask: is this
111
116
  change user-facing? If yes, add a changeset; if not, ignore it.
112
117
 
113
118
  ## The security-audit gate