@rcpooley/concord 0.1.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 (176) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +318 -0
  3. package/bin/concord.service +69 -0
  4. package/dist/age.d.ts +20 -0
  5. package/dist/age.d.ts.map +1 -0
  6. package/dist/age.js +58 -0
  7. package/dist/age.js.map +1 -0
  8. package/dist/cli/main.d.ts +3 -0
  9. package/dist/cli/main.d.ts.map +1 -0
  10. package/dist/cli/main.js +301 -0
  11. package/dist/cli/main.js.map +1 -0
  12. package/dist/daemon.d.ts +4 -0
  13. package/dist/daemon.d.ts.map +1 -0
  14. package/dist/daemon.js +394 -0
  15. package/dist/daemon.js.map +1 -0
  16. package/dist/eval-config.d.ts +2 -0
  17. package/dist/eval-config.d.ts.map +1 -0
  18. package/dist/eval-config.js +45 -0
  19. package/dist/eval-config.js.map +1 -0
  20. package/dist/exec.d.ts +168 -0
  21. package/dist/exec.d.ts.map +1 -0
  22. package/dist/exec.js +313 -0
  23. package/dist/exec.js.map +1 -0
  24. package/dist/git.d.ts +59 -0
  25. package/dist/git.d.ts.map +1 -0
  26. package/dist/git.js +265 -0
  27. package/dist/git.js.map +1 -0
  28. package/dist/hook.d.ts +37 -0
  29. package/dist/hook.d.ts.map +1 -0
  30. package/dist/hook.js +89 -0
  31. package/dist/hook.js.map +1 -0
  32. package/dist/index.d.ts +18 -0
  33. package/dist/index.d.ts.map +1 -0
  34. package/dist/index.js +15 -0
  35. package/dist/index.js.map +1 -0
  36. package/dist/init.d.ts +76 -0
  37. package/dist/init.d.ts.map +1 -0
  38. package/dist/init.js +236 -0
  39. package/dist/init.js.map +1 -0
  40. package/dist/loader.d.ts +35 -0
  41. package/dist/loader.d.ts.map +1 -0
  42. package/dist/loader.js +230 -0
  43. package/dist/loader.js.map +1 -0
  44. package/dist/module.d.ts +116 -0
  45. package/dist/module.d.ts.map +1 -0
  46. package/dist/module.js +100 -0
  47. package/dist/module.js.map +1 -0
  48. package/dist/modules/apt/index.d.ts +45 -0
  49. package/dist/modules/apt/index.d.ts.map +1 -0
  50. package/dist/modules/apt/index.js +249 -0
  51. package/dist/modules/apt/index.js.map +1 -0
  52. package/dist/modules/apt/schema.d.ts +63 -0
  53. package/dist/modules/apt/schema.d.ts.map +1 -0
  54. package/dist/modules/apt/schema.js +75 -0
  55. package/dist/modules/apt/schema.js.map +1 -0
  56. package/dist/modules/checkout/index.d.ts +88 -0
  57. package/dist/modules/checkout/index.d.ts.map +1 -0
  58. package/dist/modules/checkout/index.js +382 -0
  59. package/dist/modules/checkout/index.js.map +1 -0
  60. package/dist/modules/checkout/schema.d.ts +52 -0
  61. package/dist/modules/checkout/schema.d.ts.map +1 -0
  62. package/dist/modules/checkout/schema.js +132 -0
  63. package/dist/modules/checkout/schema.js.map +1 -0
  64. package/dist/modules/cloudflare/api.d.ts +64 -0
  65. package/dist/modules/cloudflare/api.d.ts.map +1 -0
  66. package/dist/modules/cloudflare/api.js +98 -0
  67. package/dist/modules/cloudflare/api.js.map +1 -0
  68. package/dist/modules/cloudflare/index.d.ts +74 -0
  69. package/dist/modules/cloudflare/index.d.ts.map +1 -0
  70. package/dist/modules/cloudflare/index.js +374 -0
  71. package/dist/modules/cloudflare/index.js.map +1 -0
  72. package/dist/modules/cloudflare/schema.d.ts +62 -0
  73. package/dist/modules/cloudflare/schema.d.ts.map +1 -0
  74. package/dist/modules/cloudflare/schema.js +85 -0
  75. package/dist/modules/cloudflare/schema.js.map +1 -0
  76. package/dist/modules/docker/index.d.ts +83 -0
  77. package/dist/modules/docker/index.d.ts.map +1 -0
  78. package/dist/modules/docker/index.js +470 -0
  79. package/dist/modules/docker/index.js.map +1 -0
  80. package/dist/modules/docker/registry.d.ts +35 -0
  81. package/dist/modules/docker/registry.d.ts.map +1 -0
  82. package/dist/modules/docker/registry.js +95 -0
  83. package/dist/modules/docker/registry.js.map +1 -0
  84. package/dist/modules/docker/render.d.ts +45 -0
  85. package/dist/modules/docker/render.d.ts.map +1 -0
  86. package/dist/modules/docker/render.js +162 -0
  87. package/dist/modules/docker/render.js.map +1 -0
  88. package/dist/modules/docker/schema.d.ts +231 -0
  89. package/dist/modules/docker/schema.d.ts.map +1 -0
  90. package/dist/modules/docker/schema.js +335 -0
  91. package/dist/modules/docker/schema.js.map +1 -0
  92. package/dist/modules/docker/sweeper.d.ts +64 -0
  93. package/dist/modules/docker/sweeper.d.ts.map +1 -0
  94. package/dist/modules/docker/sweeper.js +94 -0
  95. package/dist/modules/docker/sweeper.js.map +1 -0
  96. package/dist/modules/file/index.d.ts +79 -0
  97. package/dist/modules/file/index.d.ts.map +1 -0
  98. package/dist/modules/file/index.js +305 -0
  99. package/dist/modules/file/index.js.map +1 -0
  100. package/dist/modules/file/schema.d.ts +45 -0
  101. package/dist/modules/file/schema.d.ts.map +1 -0
  102. package/dist/modules/file/schema.js +114 -0
  103. package/dist/modules/file/schema.js.map +1 -0
  104. package/dist/modules/index.d.ts +20 -0
  105. package/dist/modules/index.d.ts.map +1 -0
  106. package/dist/modules/index.js +11 -0
  107. package/dist/modules/index.js.map +1 -0
  108. package/dist/modules/porkbun/api.d.ts +36 -0
  109. package/dist/modules/porkbun/api.d.ts.map +1 -0
  110. package/dist/modules/porkbun/api.js +62 -0
  111. package/dist/modules/porkbun/api.js.map +1 -0
  112. package/dist/modules/porkbun/index.d.ts +50 -0
  113. package/dist/modules/porkbun/index.d.ts.map +1 -0
  114. package/dist/modules/porkbun/index.js +236 -0
  115. package/dist/modules/porkbun/index.js.map +1 -0
  116. package/dist/modules/porkbun/schema.d.ts +38 -0
  117. package/dist/modules/porkbun/schema.d.ts.map +1 -0
  118. package/dist/modules/porkbun/schema.js +39 -0
  119. package/dist/modules/porkbun/schema.js.map +1 -0
  120. package/dist/modules/script/index.d.ts +43 -0
  121. package/dist/modules/script/index.d.ts.map +1 -0
  122. package/dist/modules/script/index.js +116 -0
  123. package/dist/modules/script/index.js.map +1 -0
  124. package/dist/modules/script/schema.d.ts +25 -0
  125. package/dist/modules/script/schema.d.ts.map +1 -0
  126. package/dist/modules/script/schema.js +63 -0
  127. package/dist/modules/script/schema.js.map +1 -0
  128. package/dist/modules/systemd/index.d.ts +93 -0
  129. package/dist/modules/systemd/index.d.ts.map +1 -0
  130. package/dist/modules/systemd/index.js +394 -0
  131. package/dist/modules/systemd/index.js.map +1 -0
  132. package/dist/modules/systemd/render.d.ts +41 -0
  133. package/dist/modules/systemd/render.d.ts.map +1 -0
  134. package/dist/modules/systemd/render.js +252 -0
  135. package/dist/modules/systemd/render.js.map +1 -0
  136. package/dist/modules/systemd/schema.d.ts +293 -0
  137. package/dist/modules/systemd/schema.d.ts.map +1 -0
  138. package/dist/modules/systemd/schema.js +302 -0
  139. package/dist/modules/systemd/schema.js.map +1 -0
  140. package/dist/modules/systemd/sweeper.d.ts +31 -0
  141. package/dist/modules/systemd/sweeper.d.ts.map +1 -0
  142. package/dist/modules/systemd/sweeper.js +77 -0
  143. package/dist/modules/systemd/sweeper.js.map +1 -0
  144. package/dist/plans.d.ts +132 -0
  145. package/dist/plans.d.ts.map +1 -0
  146. package/dist/plans.js +315 -0
  147. package/dist/plans.js.map +1 -0
  148. package/dist/records.d.ts +37 -0
  149. package/dist/records.d.ts.map +1 -0
  150. package/dist/records.js +100 -0
  151. package/dist/records.js.map +1 -0
  152. package/dist/registry.d.ts +38 -0
  153. package/dist/registry.d.ts.map +1 -0
  154. package/dist/registry.js +31 -0
  155. package/dist/registry.js.map +1 -0
  156. package/dist/runner.d.ts +48 -0
  157. package/dist/runner.d.ts.map +1 -0
  158. package/dist/runner.js +150 -0
  159. package/dist/runner.js.map +1 -0
  160. package/dist/scheduler.d.ts +36 -0
  161. package/dist/scheduler.d.ts.map +1 -0
  162. package/dist/scheduler.js +77 -0
  163. package/dist/scheduler.js.map +1 -0
  164. package/dist/schema.d.ts +762 -0
  165. package/dist/schema.d.ts.map +1 -0
  166. package/dist/schema.js +185 -0
  167. package/dist/schema.js.map +1 -0
  168. package/dist/secret.d.ts +24 -0
  169. package/dist/secret.d.ts.map +1 -0
  170. package/dist/secret.js +3 -0
  171. package/dist/secret.js.map +1 -0
  172. package/dist/ui.d.ts +62 -0
  173. package/dist/ui.d.ts.map +1 -0
  174. package/dist/ui.js +288 -0
  175. package/dist/ui.js.map +1 -0
  176. package/package.json +57 -0
@@ -0,0 +1,249 @@
1
+ import { Module } from '../../module.js';
2
+ const SOURCES_DIR = '/etc/apt/sources.list.d';
3
+ const KEYRING_DIR = '/etc/apt/keyrings';
4
+ export const sourcesPath = (name) => `${SOURCES_DIR}/${name}.sources`;
5
+ export const keyPath = (name) => `${KEYRING_DIR}/${name}.asc`;
6
+ /** `'curl'` or `{ name: 'curl', version: '8.5.0-2' }`. */
7
+ const pkgName = (p) => (typeof p === 'string' ? p : p.name);
8
+ const pkgVersion = (p) => (typeof p === 'string' ? undefined : p.version);
9
+ // ------------------------------------------------------------ rendering ----
10
+ /**
11
+ * `${codename}` → the host's release codename.
12
+ *
13
+ * Production is `resolute` (26.04), the test VM is `noble` (24.04) — without
14
+ * this, one config cannot serve both.
15
+ */
16
+ function substitute(value, codename) {
17
+ return value.replace(/\$\{codename\}/g, codename);
18
+ }
19
+ /** deb822 — the modern format, preferred by Ubuntu 24.04+. */
20
+ export function renderSources(repo, codename) {
21
+ const sub = (s) => substitute(s, codename);
22
+ const lines = [
23
+ `Types: ${(repo.types ?? ['deb']).join(' ')}`,
24
+ `URIs: ${sub(repo.uri)}`,
25
+ `Suites: ${repo.suites.map(sub).join(' ')}`,
26
+ `Components: ${repo.components.map(sub).join(' ')}`,
27
+ ];
28
+ if (repo.architectures?.length) {
29
+ lines.push(`Architectures: ${repo.architectures.join(' ')}`);
30
+ }
31
+ lines.push(`Signed-By: ${keyPath(repo.name)}`);
32
+ return lines.join('\n') + '\n';
33
+ }
34
+ const normalizeKey = (k) => k.trim() + '\n';
35
+ // --------------------------------------------------------------- module ----
36
+ export class AptModule extends Module {
37
+ config;
38
+ kind = 'apt';
39
+ #codename;
40
+ constructor(config) {
41
+ super(config.id, config.host);
42
+ this.config = config;
43
+ }
44
+ /** Cached per run — it cannot change under us mid-reconcile. */
45
+ codename() {
46
+ if (this.#codename)
47
+ return this.#codename;
48
+ const r = this.exec.run('lsb_release', ['-cs']);
49
+ const value = r.stdout.trim();
50
+ if (r.status !== 0 || !value) {
51
+ throw new Error(`${this.kind}:${this.id}: could not determine the release codename ` +
52
+ `(lsb_release -cs). \${codename} cannot be resolved.`);
53
+ }
54
+ this.#codename = value;
55
+ return value;
56
+ }
57
+ async desired() {
58
+ const codename = this.codename();
59
+ const names = new Set();
60
+ for (const r of this.config.repos ?? []) {
61
+ if (names.has(r.name)) {
62
+ throw new Error(`${this.kind}:${this.id}: duplicate repo "${r.name}"`);
63
+ }
64
+ names.add(r.name);
65
+ }
66
+ const wanted = (this.config.packages ?? []).map(pkgName);
67
+ const both = wanted.filter((n) => (this.config.absent ?? []).includes(n));
68
+ if (both.length) {
69
+ throw new Error(`${this.kind}:${this.id}: ${both.join(', ')} declared in both packages and absent — pick one.`);
70
+ }
71
+ const dupes = wanted.filter((n, i) => wanted.indexOf(n) !== i);
72
+ if (dupes.length) {
73
+ throw new Error(`${this.kind}:${this.id}: ${dupes.join(', ')} declared twice in packages`);
74
+ }
75
+ return {
76
+ repos: (this.config.repos ?? []).map((r) => ({
77
+ name: r.name,
78
+ sources: renderSources(r, codename),
79
+ key: normalizeKey(r.key),
80
+ })),
81
+ packages: [
82
+ ...(this.config.packages ?? []).map((p) => ({
83
+ name: pkgName(p),
84
+ installed: true,
85
+ ...(pkgVersion(p) !== undefined ? { version: pkgVersion(p) } : {}),
86
+ })),
87
+ ...(this.config.absent ?? []).map((name) => ({ name, installed: false })),
88
+ ],
89
+ };
90
+ }
91
+ async read() {
92
+ const repos = (this.config.repos ?? []).map((r) => ({
93
+ name: r.name,
94
+ sources: this.exec.readFileMaybe(sourcesPath(r.name)),
95
+ key: normalizeKey(this.exec.readFileMaybe(keyPath(r.name))),
96
+ }));
97
+ const declared = [
98
+ ...(this.config.packages ?? []).map(pkgName),
99
+ ...(this.config.absent ?? []),
100
+ ];
101
+ const installed = new Map();
102
+ if (declared.length) {
103
+ // dpkg-query writes "no packages found" to stderr and keeps going for the
104
+ // rest, so absence is read from the OUTPUT, never from the exit code.
105
+ const r = this.exec.run('dpkg-query', [
106
+ '-W',
107
+ '-f=${binary:Package}\t${db:Status-Status}\t${Version}\n',
108
+ ...declared,
109
+ ]);
110
+ for (const line of r.stdout.split('\n')) {
111
+ const [name, status, version] = line.split('\t');
112
+ // "config-files" = removed but not purged. That is NOT installed.
113
+ if (name && status === 'installed')
114
+ installed.set(name, version ?? '');
115
+ }
116
+ }
117
+ return {
118
+ repos,
119
+ packages: declared.map((name) => ({
120
+ name,
121
+ installed: installed.has(name),
122
+ ...(installed.has(name) ? { version: installed.get(name) } : {}),
123
+ })),
124
+ };
125
+ }
126
+ diff(actual, desired) {
127
+ const ops = [];
128
+ const actualRepos = new Map(actual.repos.map((r) => [r.name, r]));
129
+ for (const want of desired.repos) {
130
+ const have = actualRepos.get(want.name);
131
+ const missing = !have?.sources;
132
+ if (missing || have.sources !== want.sources || have.key !== want.key) {
133
+ const what = missing
134
+ ? 'add'
135
+ : [
136
+ have.sources !== want.sources ? 'sources' : null,
137
+ have.key !== want.key ? 'key' : null,
138
+ ]
139
+ .filter(Boolean)
140
+ .join(' + ');
141
+ ops.push({
142
+ kind: missing ? 'create' : 'update',
143
+ entity: 'repo',
144
+ id: `repo/${want.name}`,
145
+ summary: missing
146
+ ? `add apt repo ${want.name}`
147
+ : `update apt repo ${want.name} (${what})`,
148
+ repo: want,
149
+ before: have,
150
+ });
151
+ }
152
+ }
153
+ const actualPkgs = new Map(actual.packages.map((p) => [p.name, p]));
154
+ for (const want of desired.packages) {
155
+ const have = actualPkgs.get(want.name);
156
+ const isInstalled = have?.installed ?? false;
157
+ if (want.installed && !isInstalled) {
158
+ ops.push({
159
+ kind: 'create',
160
+ entity: 'package',
161
+ id: `package/${want.name}`,
162
+ summary: want.version
163
+ ? `install ${want.name}=${want.version}`
164
+ : `install ${want.name}`,
165
+ packageName: want.name,
166
+ version: want.version,
167
+ });
168
+ }
169
+ else if (want.installed && want.version && have?.version !== want.version) {
170
+ // Only when the config PINS a version. An unpinned package is left at
171
+ // whatever is installed — this module is additive, not an upgrader.
172
+ ops.push({
173
+ kind: 'update',
174
+ entity: 'package',
175
+ id: `package/${want.name}`,
176
+ summary: `pin ${want.name} ${have?.version} -> ${want.version}`,
177
+ packageName: want.name,
178
+ version: want.version,
179
+ });
180
+ }
181
+ else if (!want.installed && isInstalled) {
182
+ ops.push({
183
+ kind: 'delete',
184
+ entity: 'package',
185
+ id: `package/${want.name}`,
186
+ summary: `remove ${want.name}`,
187
+ packageName: want.name,
188
+ });
189
+ }
190
+ }
191
+ return ops;
192
+ }
193
+ async apply(ops) {
194
+ // Repos first — a package may only exist in a repo this run is adding.
195
+ const repoOps = ops.filter((o) => o.entity === 'repo');
196
+ for (const op of repoOps) {
197
+ const r = op.repo;
198
+ this.exec.writeFileAsRoot(keyPath(r.name), r.key, '0644');
199
+ this.exec.writeFileAsRoot(sourcesPath(r.name), r.sources, '0644');
200
+ // A legacy one-line list of the same name would make apt see the repo
201
+ // twice; drop it now that the .sources file owns it.
202
+ this.exec.sudo(['rm', '-f', `${SOURCES_DIR}/${r.name}.list`]);
203
+ this.log(` ✓ ${op.kind}: ${op.summary}`);
204
+ }
205
+ const pkgOps = ops.filter((o) => o.entity === 'package' && (o.kind === 'create' || o.kind === 'update'));
206
+ const toInstall = pkgOps.map((o) => (o.version ? `${o.packageName}=${o.version}` : o.packageName));
207
+ // A pin can move BACKWARDS — the whole point here was aligning a host that
208
+ // had drifted forward. apt refuses that without an explicit flag.
209
+ const downgrading = ops.some((o) => o.entity === 'package' && o.kind === 'update');
210
+ const toRemove = ops
211
+ .filter((o) => o.entity === 'package' && o.kind === 'delete')
212
+ .map((o) => o.packageName);
213
+ // Only pay for the index refresh when something actually needs it.
214
+ if (repoOps.length || toInstall.length) {
215
+ this.log(' refreshing package index (apt-get update)');
216
+ this.exec.sudo(['apt-get', 'update', '-qq']);
217
+ }
218
+ if (toInstall.length) {
219
+ this.exec.sudo([
220
+ 'env',
221
+ 'DEBIAN_FRONTEND=noninteractive',
222
+ 'apt-get',
223
+ 'install',
224
+ '-y',
225
+ '-qq',
226
+ ...(downgrading ? ['--allow-downgrades'] : []),
227
+ ...toInstall,
228
+ ]);
229
+ for (const op of pkgOps)
230
+ this.log(` ✓ ${op.kind === 'update' ? 'pin' : 'install'}: ${op.summary}`);
231
+ }
232
+ if (toRemove.length) {
233
+ // `remove`, not `purge` — purge destroys config files, a far bigger blast
234
+ // radius than "this package should not be here".
235
+ this.exec.sudo([
236
+ 'env',
237
+ 'DEBIAN_FRONTEND=noninteractive',
238
+ 'apt-get',
239
+ 'remove',
240
+ '-y',
241
+ '-qq',
242
+ ...toRemove,
243
+ ]);
244
+ for (const p of toRemove)
245
+ this.log(` ✓ remove: ${p}`);
246
+ }
247
+ }
248
+ }
249
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/apt/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * A vendor apt repository — a source list plus its signing key.
4
+ *
5
+ * The key is inline in the config on purpose: a fresh host must never
6
+ * trust-on-first-use by fetching a key over the network at converge time. It is
7
+ * a PUBLIC key, so committing it in plaintext is correct — this is not a secret.
8
+ */
9
+ export declare const AptRepoSchema: z.ZodObject<{
10
+ name: z.ZodString;
11
+ uri: z.ZodString;
12
+ suites: z.ZodArray<z.ZodString>;
13
+ components: z.ZodArray<z.ZodString>;
14
+ architectures: z.ZodOptional<z.ZodArray<z.ZodString>>;
15
+ types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
16
+ deb: "deb";
17
+ "deb-src": "deb-src";
18
+ }>>>;
19
+ key: z.ZodString;
20
+ }, z.core.$strict>;
21
+ /**
22
+ * A package name, or a name pinned to an exact version.
23
+ *
24
+ * Pinning exists because *when a host was built* otherwise decides which
25
+ * version it runs — the same class of problem as a docker network's subnet
26
+ * depending on creation order. It matters most for tooling whose behaviour the
27
+ * reconciler depends on: `docker-compose-plugin` computes the config hashes
28
+ * that decide whether a compose project has drifted, and different releases
29
+ * answer that differently.
30
+ *
31
+ * Versions are the full apt version string, e.g.
32
+ * `5.3.1-1~ubuntu.26.04~resolute` — `apt-cache madison <pkg>` lists them.
33
+ */
34
+ export declare const PackageSpecSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
35
+ name: z.ZodString;
36
+ version: z.ZodString;
37
+ }, z.core.$strict>]>;
38
+ export declare const AptConfigSchema: z.ZodObject<{
39
+ type: z.ZodLiteral<"apt">;
40
+ id: z.ZodString;
41
+ host: z.ZodString;
42
+ repos: z.ZodOptional<z.ZodArray<z.ZodObject<{
43
+ name: z.ZodString;
44
+ uri: z.ZodString;
45
+ suites: z.ZodArray<z.ZodString>;
46
+ components: z.ZodArray<z.ZodString>;
47
+ architectures: z.ZodOptional<z.ZodArray<z.ZodString>>;
48
+ types: z.ZodOptional<z.ZodArray<z.ZodEnum<{
49
+ deb: "deb";
50
+ "deb-src": "deb-src";
51
+ }>>>;
52
+ key: z.ZodString;
53
+ }, z.core.$strict>>>;
54
+ packages: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
55
+ name: z.ZodString;
56
+ version: z.ZodString;
57
+ }, z.core.$strict>]>>>;
58
+ absent: z.ZodOptional<z.ZodArray<z.ZodString>>;
59
+ }, z.core.$strict>;
60
+ export type PackageSpec = z.output<typeof PackageSpecSchema>;
61
+ export type AptRepoConfig = z.output<typeof AptRepoSchema>;
62
+ export type AptConfig = z.output<typeof AptConfigSchema>;
63
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/apt/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;kBAoBf,CAAA;AAEX;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB;;;oBAG5B,CAAA;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;kBA+BjB,CAAA;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAC5D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,aAAa,CAAC,CAAA;AAC1D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,eAAe,CAAC,CAAA"}
@@ -0,0 +1,75 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * A vendor apt repository — a source list plus its signing key.
4
+ *
5
+ * The key is inline in the config on purpose: a fresh host must never
6
+ * trust-on-first-use by fetching a key over the network at converge time. It is
7
+ * a PUBLIC key, so committing it in plaintext is correct — this is not a secret.
8
+ */
9
+ export const AptRepoSchema = z
10
+ .object({
11
+ /** Becomes `<name>.sources` and `<name>.asc`. */
12
+ name: z
13
+ .string()
14
+ .regex(/^[a-z0-9][a-z0-9._-]*$/, 'must be a safe filename fragment'),
15
+ uri: z.string().url(),
16
+ /**
17
+ * `${codename}` resolves to the host's `lsb_release -cs`.
18
+ *
19
+ * Not a nicety — production is `resolute` (26.04) and the test VM is `noble`
20
+ * (24.04), so a hardcoded suite means one config cannot serve both.
21
+ */
22
+ suites: z.array(z.string().min(1)).min(1),
23
+ components: z.array(z.string().min(1)).min(1),
24
+ architectures: z.array(z.string().min(1)).optional(),
25
+ types: z.array(z.enum(['deb', 'deb-src'])).optional(),
26
+ /** ASCII-armoured public key block. */
27
+ key: z.string().includes('BEGIN PGP PUBLIC KEY BLOCK'),
28
+ })
29
+ .strict();
30
+ /**
31
+ * A package name, or a name pinned to an exact version.
32
+ *
33
+ * Pinning exists because *when a host was built* otherwise decides which
34
+ * version it runs — the same class of problem as a docker network's subnet
35
+ * depending on creation order. It matters most for tooling whose behaviour the
36
+ * reconciler depends on: `docker-compose-plugin` computes the config hashes
37
+ * that decide whether a compose project has drifted, and different releases
38
+ * answer that differently.
39
+ *
40
+ * Versions are the full apt version string, e.g.
41
+ * `5.3.1-1~ubuntu.26.04~resolute` — `apt-cache madison <pkg>` lists them.
42
+ */
43
+ export const PackageSpecSchema = z.union([
44
+ z.string().min(1),
45
+ z.object({ name: z.string().min(1), version: z.string().min(1) }).strict(),
46
+ ]);
47
+ export const AptConfigSchema = z
48
+ .object({
49
+ type: z.literal('apt'),
50
+ id: z
51
+ .string()
52
+ .regex(/^[a-z0-9][a-z0-9-]*$/, 'must be kebab-case, starting alphanumeric'),
53
+ /**
54
+ * Which host this runs on — a key of the config's `hosts` registry.
55
+ *
56
+ * REQUIRED, with no default. A silently-defaulting host is a way to run
57
+ * something on the wrong machine, and "wherever Concord happens to be
58
+ * running" is not a property a config should depend on.
59
+ */
60
+ host: z.string().min(1),
61
+ repos: z.array(AptRepoSchema).optional(),
62
+ /**
63
+ * Packages that must be installed.
64
+ *
65
+ * ⚠️ ADDITIVE. Unlike every other module, the declared set is NOT the whole
66
+ * truth — a host has ~1,100 packages and treating undeclared as "delete"
67
+ * would wipe the OS. Anything not named here is left alone; removal requires
68
+ * naming it in `absent`.
69
+ */
70
+ packages: z.array(PackageSpecSchema).optional(),
71
+ /** The only packages that will ever be uninstalled. `remove`, not `purge`. */
72
+ absent: z.array(z.string().min(1)).optional(),
73
+ })
74
+ .strict();
75
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/modules/apt/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,iDAAiD;IACjD,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,KAAK,CAAC,wBAAwB,EAAE,kCAAkC,CAAC;IACtE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACrB;;;;;OAKG;IACH,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACrD,uCAAuC;IACvC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CACvD,CAAC;KACD,MAAM,EAAE,CAAA;AAEX;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE;CAC3E,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,EAAE,EAAE,CAAC;SACF,MAAM,EAAE;SACR,KAAK,CAAC,sBAAsB,EAAE,2CAA2C,CAAC;IAG7E;;;;;;OAMG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAExC;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;IAE/C,8EAA8E;IAC9E,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAC;KACD,MAAM,EAAE,CAAA"}
@@ -0,0 +1,88 @@
1
+ import { Module, type BaseOp } from '../../module.js';
2
+ import type { CheckoutConfig } from './schema.js';
3
+ export type { CheckoutConfig, CheckoutEntry } from './schema.js';
4
+ export interface CheckoutRecord {
5
+ name: string;
6
+ /** A readable git repository exists at `path`. */
7
+ present: boolean;
8
+ commit: string | null;
9
+ /**
10
+ * Tracked files differ from HEAD.
11
+ *
12
+ * UNTRACKED files are deliberately not counted: `reset --hard` leaves them
13
+ * and this module never runs `git clean`, so they are never at risk and must
14
+ * not block an update. Were they counted, a checkout with a stray build
15
+ * artifact would refuse to deploy forever.
16
+ */
17
+ dirty: boolean;
18
+ /**
19
+ * The branch HEAD is on; null when detached (or unknown).
20
+ *
21
+ * EVIDENCE, not desire — nothing converges a tree onto a branch for its own
22
+ * sake. In preserve mode it is a gate: a tree checked out on some OTHER
23
+ * branch is someone's work in progress, and `reset --hard` there would
24
+ * repoint THEIR branch at the tracked tip.
25
+ */
26
+ branch: string | null;
27
+ /**
28
+ * What `origin` points at on disk. Declared state, unlike `branch`: the
29
+ * clean URL is derivable from the config, and the idiom this module replaced
30
+ * left a token-bearing one behind — drift, repaired even when the commit
31
+ * already matches.
32
+ */
33
+ remote: string | null;
34
+ }
35
+ export interface CheckoutState {
36
+ checkouts: CheckoutRecord[];
37
+ }
38
+ export interface CheckoutOp extends BaseOp {
39
+ entity: 'checkout';
40
+ name: string;
41
+ /** The commit this op converges to. Carried so apply never re-resolves. */
42
+ commit: string;
43
+ }
44
+ /**
45
+ * Git working trees on a host.
46
+ *
47
+ * ADDITIVE, like `apt`, `file` and `systemd`: `owned()` stays empty and no
48
+ * sweeper exists, so an undeclared checkout is never touched. That is the right
49
+ * default here because the host has legitimate unmanaged state of this kind,
50
+ * often a great deal of it: a development machine can carry dozens of
51
+ * hand-made checkouts. "Remove the directory on undeclare"
52
+ * pointed at one of those is a data-loss bug, not host-truth.
53
+ */
54
+ export declare class CheckoutModule extends Module<CheckoutState, CheckoutOp> {
55
+ #private;
56
+ private readonly config;
57
+ readonly kind = "checkout";
58
+ constructor(config: CheckoutConfig);
59
+ private get checkouts();
60
+ private entry;
61
+ private stampPath;
62
+ desired(): Promise<CheckoutState>;
63
+ /**
64
+ * One script for every checkout on the host, because this runs on every
65
+ * reconcile including plans and each `runScript` is an SSH round trip.
66
+ *
67
+ * Local git only — no fetch, no `ls-remote`, no credential. The scripts this
68
+ * module replaces hit the network from the host on every single guard; tips
69
+ * are resolved once on the primary now.
70
+ */
71
+ read(): Promise<CheckoutState>;
72
+ private parse;
73
+ diff(actual: CheckoutState, desired: CheckoutState): CheckoutOp[];
74
+ apply(ops: CheckoutOp[]): Promise<void>;
75
+ /**
76
+ * The outer half runs as root: it can write the stamp, and it is the only
77
+ * thing that may `sudo -u`. Every git command runs in the INNER half, as the
78
+ * tree's owner.
79
+ *
80
+ * The token is interpolated into the script BODY, which travels over stdin —
81
+ * never argv, which is world-readable in /proc. It is exported to the inner
82
+ * shell and referenced only by NAME inside the credential helper, so it does
83
+ * not reach argv there either, and — unlike the `remote set-url` idiom this
84
+ * replaces — it is never written into `.git/config` on disk.
85
+ */
86
+ private script;
87
+ }
88
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/checkout/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAErD,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAA;AAEhE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAyBhE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;;;;;;OAOG;IACH,KAAK,EAAE,OAAO,CAAA;IACd;;;;;;;OAOG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,cAAc,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,UAAW,SAAQ,MAAM;IACxC,MAAM,EAAE,UAAU,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAA;CACf;AAID;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC;;IAQvD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,SAAkB,IAAI,cAAa;gBAON,MAAM,EAAE,cAAc;IAInD,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,SAAS;IAMX,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IA6DvC;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC;IAwCpC,OAAO,CAAC,KAAK;IAsCb,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,GAAG,UAAU,EAAE;IAuE3D,KAAK,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD7C;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM;CAmGf"}