@intentius/chant-lexicon-docker 0.26.0 → 0.28.0

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 (6) hide show
  1. package/dist/codegen/versions.d.ts +35 -4
  2. package/dist/codegen/versions.d.ts.map +1 -1
  3. package/dist/integrity.json +2 -2
  4. package/dist/manifest.json +1 -1
  5. package/package.json +2 -2
  6. package/src/codegen/versions.ts +36 -5
package/dist/codegen/versions.d.ts CHANGED
@@ -1,11 +1,42 @@
1
1
  /**
2
2
  * Pinned URLs and version tags for upstream Docker specs.
3
3
  */
4
- /** Compose Spec JSON Schema — master branch */
5
- export declare const COMPOSE_SPEC_URL = "https://raw.githubusercontent.com/compose-spec/compose-spec/master/schema/compose-spec.json";
4
+ /**
5
+ * Pinned commit of compose-spec/compose-spec (#1146).
6
+ *
7
+ * compose-spec/compose-spec has no tagged releases, so unlike
8
+ * ENGINE_API_URL below (pinned to the `v27.3.1` tag) there is no version tag
9
+ * to pin against — codegen used to fetch the default branch directly (the
10
+ * repo's default branch is `main`; the old URL fetched `master`, a legacy
11
+ * alias GitHub still redirects, but a moving-branch alias all the same).
12
+ * That meant a cold cache picked up whatever upstream state had landed since
13
+ * the cache last expired, while a warm cache kept serving whatever was
14
+ * current when it was last filled — the exact CI nondeterminism this fix
15
+ * closed for azure (#1144).
16
+ *
17
+ * Pinning to a commit SHA makes generation reproducible regardless of cache
18
+ * state. Bump policy: #523's scheduled lexicon-upgrade cron (rolling-spec
19
+ * bucket) is meant to propose bumps to this constant as a reviewable PR once
20
+ * built. Until then, bump by hand: take the current `main` HEAD sha from
21
+ * https://github.com/compose-spec/compose-spec/commits/main, regenerate, fix
22
+ * up any composite left referencing a renamed or vanished export, and update
23
+ * this constant + comment.
24
+ */
25
+ export declare const COMPOSE_SPEC_COMMIT = "11296e387ba76c77db1db768b9153a4304a3c9bd";
26
+ /** Compose Spec JSON Schema — pinned to COMPOSE_SPEC_COMMIT, not a moving branch */
27
+ export declare const COMPOSE_SPEC_URL = "https://raw.githubusercontent.com/compose-spec/compose-spec/11296e387ba76c77db1db768b9153a4304a3c9bd/schema/compose-spec.json";
6
28
  /** Docker Engine API OpenAPI spec (v1.45) */
7
29
  export declare const ENGINE_API_URL = "https://raw.githubusercontent.com/moby/moby/v27.3.1/api/swagger.yaml";
8
- /** Cache filenames under ~/.chant/ */
9
- export declare const COMPOSE_SPEC_CACHE = "docker-compose-spec.json";
30
+ /**
31
+ * Cache filenames under ~/.chant/.
32
+ *
33
+ * COMPOSE_SPEC_CACHE embeds the pin so a stale schema file fetched before a
34
+ * bump can never satisfy the new pin: restoring an old ~/.chant (e.g. a CI
35
+ * cache partial-key fallback, or a developer's pre-existing cache) simply
36
+ * misses this filename and re-downloads, instead of silently serving
37
+ * pre-bump schema under a name that still matches (#1146, mirroring azure's
38
+ * AZURE_SCHEMA_COMMIT-keyed cache filename, #1144).
39
+ */
40
+ export declare const COMPOSE_SPEC_CACHE = "docker-compose-spec-11296e387ba76c77db1db768b9153a4304a3c9bd.json";
10
41
  export declare const ENGINE_API_CACHE = "docker-engine-api.yaml";
11
42
  //# sourceMappingURL=versions.d.ts.map
package/dist/codegen/versions.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/codegen/versions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,gGACkE,CAAC;AAEhG,6CAA6C;AAC7C,eAAO,MAAM,cAAc,yEAC6C,CAAC;AAEzE,sCAAsC;AACtC,eAAO,MAAM,kBAAkB,6BAA6B,CAAC;AAC7D,eAAO,MAAM,gBAAgB,2BAA2B,CAAC"}
1
+ {"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../../src/codegen/versions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,mBAAmB,6CAA6C,CAAC;AAE9E,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,kIAAgH,CAAC;AAE9I,6CAA6C;AAC7C,eAAO,MAAM,cAAc,yEAC6C,CAAC;AAEzE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,sEAAoD,CAAC;AACpF,eAAO,MAAM,gBAAgB,2BAA2B,CAAC"}
package/dist/integrity.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "algorithm": "sha256",
3
3
  "artifacts": {
4
- "manifest.json": "6e5d5490ab2bde038358cd66c7fa9b380db13343eb00f589fb39be18ac6ae98e",
4
+ "manifest.json": "f2908739e307ee2e8fa3ba0c835337fa83d52f5b258bc693fc3ca890af925311",
5
5
  "meta.json": "ae27dc809e705d37a645ee83b9789c50051282f7891d21d6b9e6ce8d111624ff",
6
6
  "types/index.d.ts": "758f989ff86af54284d7f841a2db2259038d51ce1f3ed839a5d8e83fa20d95b8",
7
7
  "rules/no-latest-tag.ts": "efd060453d8ca3d5b85c3972906c6650b6f63eb5f67cb6cdb0f16a41cad91228",
@@ -15,5 +15,5 @@
15
15
  "skills/chant-docker.md": "3ff0708e3c76e245f202948949c768464563af2b60cc9aa2ca52f494ef8357f1",
16
16
  "skills/chant-docker-patterns.md": "ad1b0196d8150b2df579a699ff107f604340c799c04f3460ebf65003e287b12a"
17
17
  },
18
- "composite": "93052d6203ca441ab35695c08a2d278fe17de15a4ce7cdbcf1c3840236213edc"
18
+ "composite": "13c42f2d9ba6d41f41b6a81f0ebc4b0509d22bd299be86f23f18792f229c9444"
19
19
  }
package/dist/manifest.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "docker",
3
- "version": "0.26.0",
3
+ "version": "0.28.0",
4
4
  "chantVersion": ">=0.1.0",
5
5
  "namespace": "Docker",
6
6
  "intrinsics": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@intentius/chant-lexicon-docker",
3
- "version": "0.26.0",
3
+ "version": "0.28.0",
4
4
  "description": "Docker lexicon for chant — declarative IaC in TypeScript",
5
5
  "license": "Apache-2.0",
6
6
  "homepage": "https://intentius.io/chant",
@@ -67,7 +67,7 @@
67
67
  "typescript": "^5.9.3"
68
68
  },
69
69
  "peerDependencies": {
70
- "@intentius/chant": "^0.26.0",
70
+ "@intentius/chant": "^0.28.0",
71
71
  "typescript": "^5.9.3"
72
72
  }
73
73
  }
package/src/codegen/versions.ts CHANGED
@@ -2,14 +2,45 @@
2
2
  * Pinned URLs and version tags for upstream Docker specs.
3
3
  */
4
4
 
5
- /** Compose Spec JSON Schema — master branch */
6
- export const COMPOSE_SPEC_URL =
7
- "https://raw.githubusercontent.com/compose-spec/compose-spec/master/schema/compose-spec.json";
5
+ /**
6
+ * Pinned commit of compose-spec/compose-spec (#1146).
7
+ *
8
+ * compose-spec/compose-spec has no tagged releases, so unlike
9
+ * ENGINE_API_URL below (pinned to the `v27.3.1` tag) there is no version tag
10
+ * to pin against — codegen used to fetch the default branch directly (the
11
+ * repo's default branch is `main`; the old URL fetched `master`, a legacy
12
+ * alias GitHub still redirects, but a moving-branch alias all the same).
13
+ * That meant a cold cache picked up whatever upstream state had landed since
14
+ * the cache last expired, while a warm cache kept serving whatever was
15
+ * current when it was last filled — the exact CI nondeterminism this fix
16
+ * closed for azure (#1144).
17
+ *
18
+ * Pinning to a commit SHA makes generation reproducible regardless of cache
19
+ * state. Bump policy: #523's scheduled lexicon-upgrade cron (rolling-spec
20
+ * bucket) is meant to propose bumps to this constant as a reviewable PR once
21
+ * built. Until then, bump by hand: take the current `main` HEAD sha from
22
+ * https://github.com/compose-spec/compose-spec/commits/main, regenerate, fix
23
+ * up any composite left referencing a renamed or vanished export, and update
24
+ * this constant + comment.
25
+ */
26
+ export const COMPOSE_SPEC_COMMIT = "11296e387ba76c77db1db768b9153a4304a3c9bd";
27
+
28
+ /** Compose Spec JSON Schema — pinned to COMPOSE_SPEC_COMMIT, not a moving branch */
29
+ export const COMPOSE_SPEC_URL = `https://raw.githubusercontent.com/compose-spec/compose-spec/${COMPOSE_SPEC_COMMIT}/schema/compose-spec.json`;
8
30
 
9
31
  /** Docker Engine API OpenAPI spec (v1.45) */
10
32
  export const ENGINE_API_URL =
11
33
  "https://raw.githubusercontent.com/moby/moby/v27.3.1/api/swagger.yaml";
12
34
 
13
- /** Cache filenames under ~/.chant/ */
14
- export const COMPOSE_SPEC_CACHE = "docker-compose-spec.json";
35
+ /**
36
+ * Cache filenames under ~/.chant/.
37
+ *
38
+ * COMPOSE_SPEC_CACHE embeds the pin so a stale schema file fetched before a
39
+ * bump can never satisfy the new pin: restoring an old ~/.chant (e.g. a CI
40
+ * cache partial-key fallback, or a developer's pre-existing cache) simply
41
+ * misses this filename and re-downloads, instead of silently serving
42
+ * pre-bump schema under a name that still matches (#1146, mirroring azure's
43
+ * AZURE_SCHEMA_COMMIT-keyed cache filename, #1144).
44
+ */
45
+ export const COMPOSE_SPEC_CACHE = `docker-compose-spec-${COMPOSE_SPEC_COMMIT}.json`;
15
46
  export const ENGINE_API_CACHE = "docker-engine-api.yaml";