@kaynooo/cli-stack 0.7.2 → 0.8.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 (3) hide show
  1. package/README.md +1 -18
  2. package/dist/cli.js +281 -573
  3. package/package.json +7 -7
package/README.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # stack
2
2
 
3
- Two stack helpers for Claude Code: a stable port per service name, and an audit of a compose release setup against its `release.config.ts`.
3
+ A stable host port per service name for Claude Code, the same on every machine.
4
4
 
5
5
  ```sh
6
6
  bun install -g @kaynooo/cli-stack
@@ -11,22 +11,5 @@ bun install -g @kaynooo/cli-stack
11
11
  | Command | What it does |
12
12
  | --- | --- |
13
13
  | `stack port <name>` | prints the port the name always hashes to (32-bit FNV-1a, 1024-32767), so a service keeps the same port on every machine |
14
- | `stack audit [dir]` | cross-checks `release.config.ts` in `dir` (the current directory) against the compose files it syncs |
15
14
 
16
15
  `stack port` takes `--min` and `--max` to change the range: the default stops below 32768, where Linux starts handing out ephemeral ports, `--min` refuses anything under 1024, and `--max` goes up to 65535. The hash used to lose precision past 2^53 and the range ran to 65535, so every name now maps to a different port than before; a port already written in a compose file keeps working, only a newly picked one comes out different. When something on this machine already listens on the port it says so on stderr; the number is still printed and the exit code stays 0. `--json` prints `{name, port, listening}`.
17
-
18
- ## Audit
19
-
20
- The checks, in the order they are reported:
21
-
22
- - `sync` and `build`: every `deploySyncFiles` entry, `sourceDir`, `buildContext`, `dockerfile` and buildSecret `src` (a leading `~` is the home directory) exists, and a buildSecret `env` is set in the shell.
23
- - `compose`: `docker compose config` succeeds on the base file and on each overlay merged over it. The base is the shortest compose file name among `deploySyncFiles`.
24
- - `env`: every `${VAR}`, `${VAR:?msg}` or bare `$VAR` without a default is in `requiredServerEnv`, and every listed key is referenced; the `$${VAR}` escape and commented lines are skipped.
25
- - `version`: each `versionEnv` is interpolated by a compose file, and each `*_VERSION` a compose file interpolates is declared by a release.
26
- - `image`, `restart` and `post-deploy`: services the config names exist, and registry images are built by a release.
27
- - `health` and `routing`: restarted services have a healthcheck, ports and traefik labels live in overlays, and `composeArgs` does not drop them.
28
- - `layout`, `nuxt` and `gitignore`: bind mounts appear in the base file's header, `NUXT_*` variables match the runtime config, and `.release-logs` and `.release-worktrees` are ignored.
29
-
30
- Exit codes: 0 no error (warnings allowed), 1 at least one error, 2 no `release.config.ts`. `--json` prints `{ root, composeFiles, findings }` where a finding is `{ level, check, message }`.
31
-
32
- It needs docker for `docker compose config`. When the package `release.config.ts` imports `defineConfig` from is not installed, a stand-in that returns its argument is used.
package/dist/cli.js CHANGED
@@ -1,19 +1,19 @@
1
1
  #!/usr/bin/env -S bun --no-env-file --config=/dev/null
2
2
  // @bun
3
-
4
- // src/cli.ts
5
- import process17 from "process";
6
- // ../kit/src/args.ts
7
- import process9 from "process";
8
- import { parseArgs } from "util";
9
-
10
- // ../kit/src/format.ts
11
- import process7 from "process";
3
+ var __esm = (fn, res, err) => () => {
4
+ if (fn)
5
+ try {
6
+ res = fn(fn = 0);
7
+ } catch (e) {
8
+ err = [e];
9
+ }
10
+ if (err)
11
+ throw err[0];
12
+ return res;
13
+ };
12
14
 
13
15
  // ../kit/src/mode.ts
14
16
  import process2 from "process";
15
- var MODES = new Set(["terminal", "ci", "agent", "pipe"]);
16
- var AGENT_VARIABLES = ["CLAUDECODE", "AI_AGENT"];
17
17
  function isSet(value) {
18
18
  return value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false";
19
19
  }
@@ -27,12 +27,13 @@ function outputMode(stream = process2.stdout, env = process2.env) {
27
27
  return "terminal";
28
28
  return isSet(env.CI) ? "ci" : "pipe";
29
29
  }
30
+ var MODES, AGENT_VARIABLES;
31
+ var init_mode = __esm(() => {
32
+ MODES = new Set(["terminal", "ci", "agent", "pipe"]);
33
+ AGENT_VARIABLES = ["CLAUDECODE", "AI_AGENT"];
34
+ });
30
35
 
31
- // ../kit/src/style.ts
32
- import process6 from "process";
33
-
34
- // ../../node_modules/.bun/@kaynooo+utils@3.0.0+4c7ddab9986847c5/node_modules/@kaynooo/utils/dist/chunk-x450vn3m.js
35
- var G = /^[a-f0-9]+$/i;
36
+ // ../../node_modules/.bun/@kaynooo+utils@3.1.0+4c7ddab9986847c5/node_modules/@kaynooo/utils/dist/chunk-x450vn3m.js
36
37
  function b(r) {
37
38
  let e = r.startsWith("#") ? r.slice(1) : r;
38
39
  if (!G.test(e))
@@ -43,11 +44,6 @@ function b(r) {
43
44
  throw Error(`Invalid hex color length: ${e.length}`);
44
45
  return [Number.parseInt(e.slice(0, 2), 16), Number.parseInt(e.slice(2, 4), 16), Number.parseInt(e.slice(4, 6), 16)];
45
46
  }
46
- var B = { reset: [0, 0], bold: [1, 22], dim: [2, 22], italic: [3, 23], underline: [4, 24], inverse: [7, 27], hidden: [8, 28], strikethrough: [9, 29], black: [30, 39], red: [31, 39], green: [32, 39], yellow: [33, 39], blue: [34, 39], magenta: [35, 39], cyan: [36, 39], white: [37, 39], gray: [90, 39], grey: [90, 39], blackBright: [90, 39], redBright: [91, 39], greenBright: [92, 39], yellowBright: [93, 39], blueBright: [94, 39], magentaBright: [95, 39], cyanBright: [96, 39], whiteBright: [97, 39], bgBlack: [40, 49], bgRed: [41, 49], bgGreen: [42, 49], bgYellow: [43, 49], bgBlue: [44, 49], bgMagenta: [45, 49], bgCyan: [46, 49], bgWhite: [47, 49], bgBlackBright: [100, 49], bgRedBright: [101, 49], bgGreenBright: [102, 49], bgYellowBright: [103, 49], bgBlueBright: [104, 49], bgMagentaBright: [105, 49], bgCyanBright: [106, 49], bgWhiteBright: [107, 49], rgb: (r, e, l, n = "fg") => [`${n === "fg" ? 38 : 48};2;${r};${e};${l}`, n === "fg" ? 39 : 49], hex: (r, e = "fg") => {
47
- let [l, n, c] = b(r);
48
- return [`${e === "fg" ? 38 : 48};2;${l};${n};${c}`, e === "fg" ? 39 : 49];
49
- }, ansi256: (r, e = "fg") => [`${e === "fg" ? 38 : 48};5;${r}`, e === "fg" ? 39 : 49] };
50
- var h = new Set(["", "1", "2", "3", "true"]);
51
47
  function C(r, e = globalThis.process?.env ?? {}) {
52
48
  if (e.FORCE_COLOR !== undefined)
53
49
  return h.has(e.FORCE_COLOR);
@@ -84,13 +80,21 @@ function f(r, e = []) {
84
80
  function Fe(r = {}) {
85
81
  return f(r);
86
82
  }
87
- var o = Fe();
83
+ var G, B, h, o;
84
+ var init_chunk_x450vn3m = __esm(() => {
85
+ G = /^[a-f0-9]+$/i;
86
+ B = { reset: [0, 0], bold: [1, 22], dim: [2, 22], italic: [3, 23], underline: [4, 24], inverse: [7, 27], hidden: [8, 28], strikethrough: [9, 29], black: [30, 39], red: [31, 39], green: [32, 39], yellow: [33, 39], blue: [34, 39], magenta: [35, 39], cyan: [36, 39], white: [37, 39], gray: [90, 39], grey: [90, 39], blackBright: [90, 39], redBright: [91, 39], greenBright: [92, 39], yellowBright: [93, 39], blueBright: [94, 39], magentaBright: [95, 39], cyanBright: [96, 39], whiteBright: [97, 39], bgBlack: [40, 49], bgRed: [41, 49], bgGreen: [42, 49], bgYellow: [43, 49], bgBlue: [44, 49], bgMagenta: [45, 49], bgCyan: [46, 49], bgWhite: [47, 49], bgBlackBright: [100, 49], bgRedBright: [101, 49], bgGreenBright: [102, 49], bgYellowBright: [103, 49], bgBlueBright: [104, 49], bgMagentaBright: [105, 49], bgCyanBright: [106, 49], bgWhiteBright: [107, 49], rgb: (r, e, l, n = "fg") => [`${n === "fg" ? 38 : 48};2;${r};${e};${l}`, n === "fg" ? 39 : 49], hex: (r, e = "fg") => {
87
+ let [l, n, c] = b(r);
88
+ return [`${e === "fg" ? 38 : 48};2;${l};${n};${c}`, e === "fg" ? 39 : 49];
89
+ }, ansi256: (r, e = "fg") => [`${e === "fg" ? 38 : 48};5;${r}`, e === "fg" ? 39 : 49] };
90
+ h = new Set(["", "1", "2", "3", "true"]);
91
+ o = Fe();
92
+ });
88
93
 
89
- // ../kit/src/theme.ts
90
- import { existsSync as existsSync2, readFileSync, statSync } from "fs";
91
- import { homedir as homedir2 } from "os";
92
- import { join as join3, resolve as resolve2 } from "path";
93
- import process5 from "process";
94
+ // ../../node_modules/.bun/@kaynooo+utils@3.1.0+4c7ddab9986847c5/node_modules/@kaynooo/utils/dist/tools/colors.js
95
+ var init_colors = __esm(() => {
96
+ init_chunk_x450vn3m();
97
+ });
94
98
 
95
99
  // ../kit/src/config.ts
96
100
  import { existsSync } from "fs";
@@ -106,6 +110,9 @@ function findUp(names, from = process3.cwd(), stop = () => false) {
106
110
  return;
107
111
  }
108
112
  }
113
+ var init_config = __esm(() => {
114
+ init_args();
115
+ });
109
116
 
110
117
  // ../kit/src/user-config.ts
111
118
  import { homedir } from "os";
@@ -118,36 +125,18 @@ function configBase(where = {}) {
118
125
  function userConfigPath(bin, where = {}) {
119
126
  return join2(configBase(where), "kaynooo-cli", `${bin}.json`);
120
127
  }
128
+ var init_user_config = () => {};
121
129
 
122
130
  // ../kit/src/theme.ts
123
- var ENDS = new Map;
124
- var DEFAULT = {
125
- colors: { accent: "cyan", id: "yellow", path: "blue", label: "dim", value: "bold", ok: "green", warn: "yellow", problem: "red", note: "dim", plan: "magenta", passed: "green", failed: "red", running: "cyan", queued: "yellow", skipped: "dim" },
126
- glyphs: { ok: "\u2713", warn: "\u25B2", problem: "\u2717", note: "\u203A", plan: "\u25C7", passed: "\u2713", failed: "\u2717", running: "\u25CF", queued: "\u25CB", skipped: "-", bar: "\u2501", rule: "\u2500", corner: "\u256D", open: "\u2022", leaf: "\xB7", guide: "\u2502" },
127
- accents: ["cyan", "magenta", "green", "blue", "yellow", "redBright"],
128
- bins: {},
129
- gradient: ["#c084fc", "#67e8f9"]
130
- };
131
- var BRIGHT = { accent: "cyanBright", id: "yellowBright", path: "blueBright", label: "white", value: "bold whiteBright", ok: "greenBright", warn: "yellowBright", problem: "redBright", note: "white", plan: "magentaBright", passed: "greenBright", failed: "redBright", running: "cyanBright", queued: "yellowBright", skipped: "white" };
132
- var MONO = { accent: "bold", id: "bold", path: "underline", label: "dim", value: "bold", ok: "bold", warn: "bold", problem: "bold", note: "dim", plan: "dim", passed: "bold", failed: "bold", running: "bold", queued: "dim", skipped: "dim" };
133
- var ASCII = { ok: "+", warn: "!", problem: "x", note: ">", plan: "?", passed: "+", failed: "x", running: "*", queued: "o", skipped: "-", bar: "#", rule: "-", corner: "+", open: "*", leaf: "-", guide: "|" };
134
- var PRESETS = {
135
- default: {},
136
- "high-contrast": { colors: BRIGHT, accents: ["cyanBright", "magentaBright", "greenBright", "blueBright", "yellowBright", "redBright"], gradient: ["#d8b4fe", "#a5f3fc"] },
137
- mono: { colors: MONO, accents: ["bold"], gradient: undefined },
138
- ascii: { glyphs: ASCII }
139
- };
140
- var STYLES = new Set(["bold", "dim", "italic", "underline", "inverse", "strikethrough", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "gray", "grey", "blackBright", "redBright", "greenBright", "yellowBright", "blueBright", "magentaBright", "cyanBright", "whiteBright"]);
141
- var HEX = /^#[0-9a-f]{6}$/i;
142
- var CONTROL = /\p{Cc}/u;
143
- var MAX_FILE_BYTES = 64 * 1024;
144
- var SPACES = /\s+/;
131
+ import { existsSync as existsSync2, readFileSync, statSync } from "fs";
132
+ import { homedir as homedir2 } from "os";
133
+ import { join as join3, resolve as resolve2 } from "path";
134
+ import process5 from "process";
145
135
  function isColorSpec(spec) {
146
136
  if (typeof spec === "number")
147
137
  return Number.isInteger(spec) && spec >= 0 && spec <= 255;
148
138
  return typeof spec === "string" && spec.trim() !== "" && spec.trim().split(SPACES).every((token) => STYLES.has(token) || HEX.test(token));
149
139
  }
150
- var CUBE = [0, 95, 135, 175, 215, 255];
151
140
  function cubeLevel(channel) {
152
141
  return CUBE.reduce((best, value, level) => Math.abs(value - channel) < Math.abs(CUBE[best] - channel) ? level : best, 0);
153
142
  }
@@ -252,7 +241,6 @@ function applyFile(theme, file, where, warn) {
252
241
  function endsWalk(home) {
253
242
  return (dir) => dir === resolve2(home) || existsSync2(join3(dir, ".git"));
254
243
  }
255
- var warned = new Set;
256
244
  function warnOnce(message) {
257
245
  if (warned.has(message))
258
246
  return;
@@ -289,8 +277,6 @@ function loadTheme({ env = process5.env, from = process5.cwd(), home = homedir2(
289
277
  }
290
278
  return { theme, sources, preset };
291
279
  }
292
- var current;
293
- var currentKey = "";
294
280
  function activeTheme() {
295
281
  const key = `${process5.cwd()}\x00${process5.env.KIT_THEME ?? ""}\x00${process5.env.XDG_CONFIG_HOME ?? ""}`;
296
282
  if (current === undefined || key !== currentKey) {
@@ -299,9 +285,38 @@ function activeTheme() {
299
285
  }
300
286
  return current;
301
287
  }
288
+ var ENDS, DEFAULT, BRIGHT, MONO, ASCII, PRESETS, STYLES, HEX, CONTROL, MAX_FILE_BYTES, SPACES, CUBE, warned, current, currentKey = "";
289
+ var init_theme = __esm(() => {
290
+ init_config();
291
+ init_user_config();
292
+ ENDS = new Map;
293
+ DEFAULT = {
294
+ colors: { accent: "cyan", id: "yellow", path: "blue", label: "dim", value: "bold", ok: "green", warn: "yellow", problem: "red", note: "dim", plan: "magenta", passed: "green", failed: "red", running: "cyan", queued: "yellow", skipped: "dim" },
295
+ glyphs: { ok: "\u2713", warn: "\u25B2", problem: "\u2717", note: "\u203A", plan: "\u25C7", passed: "\u2713", failed: "\u2717", running: "\u25CF", queued: "\u25CB", skipped: "-", bar: "\u2501", rule: "\u2500", corner: "\u256D", open: "\u2022", leaf: "\xB7", guide: "\u2502" },
296
+ accents: ["cyan", "magenta", "green", "blue", "yellow", "redBright"],
297
+ bins: {},
298
+ gradient: ["#c084fc", "#67e8f9"]
299
+ };
300
+ BRIGHT = { accent: "cyanBright", id: "yellowBright", path: "blueBright", label: "white", value: "bold whiteBright", ok: "greenBright", warn: "yellowBright", problem: "redBright", note: "white", plan: "magentaBright", passed: "greenBright", failed: "redBright", running: "cyanBright", queued: "yellowBright", skipped: "white" };
301
+ MONO = { accent: "bold", id: "bold", path: "underline", label: "dim", value: "bold", ok: "bold", warn: "bold", problem: "bold", note: "dim", plan: "dim", passed: "bold", failed: "bold", running: "bold", queued: "dim", skipped: "dim" };
302
+ ASCII = { ok: "+", warn: "!", problem: "x", note: ">", plan: "?", passed: "+", failed: "x", running: "*", queued: "o", skipped: "-", bar: "#", rule: "-", corner: "+", open: "*", leaf: "-", guide: "|" };
303
+ PRESETS = {
304
+ default: {},
305
+ "high-contrast": { colors: BRIGHT, accents: ["cyanBright", "magentaBright", "greenBright", "blueBright", "yellowBright", "redBright"], gradient: ["#d8b4fe", "#a5f3fc"] },
306
+ mono: { colors: MONO, accents: ["bold"], gradient: undefined },
307
+ ascii: { glyphs: ASCII }
308
+ };
309
+ STYLES = new Set(["bold", "dim", "italic", "underline", "inverse", "strikethrough", "black", "red", "green", "yellow", "blue", "magenta", "cyan", "white", "gray", "grey", "blackBright", "redBright", "greenBright", "yellowBright", "blueBright", "magentaBright", "cyanBright", "whiteBright"]);
310
+ HEX = /^#[0-9a-f]{6}$/i;
311
+ CONTROL = /\p{Cc}/u;
312
+ MAX_FILE_BYTES = 64 * 1024;
313
+ SPACES = /\s+/;
314
+ CUBE = [0, 95, 135, 175, 215, 255];
315
+ warned = new Set;
316
+ });
302
317
 
303
318
  // ../kit/src/style.ts
304
- var MARK_WORDS = { ok: "ok:", warn: "warning:", problem: "error:", note: "note:", plan: "would:" };
319
+ import process6 from "process";
305
320
  function takesControlCodes(stream, env = process6.env) {
306
321
  return stream.isTTY === true && env.NO_COLOR === undefined && env.NODE_DISABLE_COLORS === undefined && env.TERM !== "dumb" && outputMode(stream, env) === "terminal";
307
322
  }
@@ -320,17 +335,24 @@ function marked(mark, text, stream, detail, env = process6.env) {
320
335
  function warn(text, detail) {
321
336
  console.error(marked("warn", text, process6.stderr, detail));
322
337
  }
323
- var STATUS_WORDS = {
324
- passed: ["passed", "success", "succeeded", "ok"],
325
- failed: ["failed", "failure", "error", "errored"],
326
- running: ["running", "in_progress", "started", "holding"],
327
- queued: ["queued", "waiting", "pending", "created", "blocked", "scheduled"],
328
- skipped: ["skipped", "cancelled", "canceled", "manual"]
329
- };
330
- var STATUS_OF = new Map(Object.entries(STATUS_WORDS).flatMap(([status, words]) => words.map((word) => [word, status])));
338
+ var MARK_WORDS, STATUS_WORDS, STATUS_OF;
339
+ var init_style = __esm(() => {
340
+ init_colors();
341
+ init_mode();
342
+ init_theme();
343
+ MARK_WORDS = { ok: "ok:", warn: "warning:", problem: "error:", note: "note:", plan: "would:" };
344
+ STATUS_WORDS = {
345
+ passed: ["passed", "success", "succeeded", "ok"],
346
+ failed: ["failed", "failure", "error", "errored"],
347
+ running: ["running", "in_progress", "started", "holding"],
348
+ queued: ["queued", "waiting", "pending", "created", "blocked", "scheduled"],
349
+ skipped: ["skipped", "cancelled", "canceled", "manual"]
350
+ };
351
+ STATUS_OF = new Map(Object.entries(STATUS_WORDS).flatMap(([status, words]) => words.map((word) => [word, status])));
352
+ });
331
353
 
332
354
  // ../kit/src/format.ts
333
- var UNITS = [["d", 86400], ["h", 3600], ["m", 60], ["s", 1]];
355
+ import process7 from "process";
334
356
  function formatSeconds(total) {
335
357
  let rest = Math.max(0, Math.round(total));
336
358
  const amounts = UNITS.map(([unit, size]) => {
@@ -351,19 +373,22 @@ function upTo(text, separator) {
351
373
  const end = text.indexOf(separator);
352
374
  return end === -1 ? text : text.slice(0, end);
353
375
  }
354
- var ESCAPE = String.fromCharCode(27);
355
376
  function jsonText(value, replacer, { stream = process7.stdout, env = process7.env } = {}) {
356
377
  return JSON.stringify(value, replacer, outputMode(stream, env) === "agent" ? undefined : 2);
357
378
  }
358
379
  function printJson(value) {
359
380
  console.log(jsonText(value));
360
381
  }
382
+ var UNITS, ESCAPE;
383
+ var init_format = __esm(() => {
384
+ init_mode();
385
+ init_style();
386
+ UNITS = [["d", 86400], ["h", 3600], ["m", 60], ["s", 1]];
387
+ ESCAPE = String.fromCharCode(27);
388
+ });
361
389
 
362
390
  // ../kit/src/help.ts
363
391
  import process8 from "process";
364
- var OPTIONAL = /(?<!\x1B)\[[^\]]+\]/g;
365
- var USAGE_PREFIX = /^usage:\s*/i;
366
- var FULL_STOP = /\.$/;
367
392
  function usageLine(usage, colors = paint(process8.stdout)) {
368
393
  return `${colors.bold("Usage:")} ${usage.replace(USAGE_PREFIX, "").replaceAll(OPTIONAL, (part) => colors.dim(part))}`;
369
394
  }
@@ -400,7 +425,6 @@ function exampleRows(examples, colors = paint(process8.stdout)) {
400
425
  return [];
401
426
  return ["", colors.bold("Examples:"), ...examples.map((example) => typeof example === "string" ? ` ${example}` : ` ${example[0]} ${colors.dim(`# ${example[1]}`)}`)];
402
427
  }
403
- var MAX_INLINE_CHOICES = 24;
404
428
  function optionRows(options, colors = paint(process8.stdout)) {
405
429
  const rows = Object.entries(options).map(([name, option]) => {
406
430
  const short = option.short === undefined ? " " : `${colors.cyan(`-${option.short}`)}, `;
@@ -415,6 +439,14 @@ function optionRows(options, colors = paint(process8.stdout)) {
415
439
  const width = Math.max(0, ...rows.map((row) => row.width));
416
440
  return rows.map((row) => row.description === "" ? ` ${row.flag}` : ` ${row.flag}${" ".repeat(width - row.width)} ${colors.dim(row.description)}`);
417
441
  }
442
+ var OPTIONAL, USAGE_PREFIX, FULL_STOP, MAX_INLINE_CHOICES = 24;
443
+ var init_help = __esm(() => {
444
+ init_mode();
445
+ init_style();
446
+ OPTIONAL = /(?<!\x1B)\[[^\]]+\]/g;
447
+ USAGE_PREFIX = /^usage:\s*/i;
448
+ FULL_STOP = /\.$/;
449
+ });
418
450
 
419
451
  // ../kit/src/text.ts
420
452
  function distance(a, b) {
@@ -442,8 +474,9 @@ function closest(name, names) {
442
474
  const [best] = names.map((known) => ({ known, far: distance(name, known) })).sort((a, b) => a.far - b.far);
443
475
  return best !== undefined && best.far <= (name.length < 4 ? 1 : 2) ? best.known : undefined;
444
476
  }
477
+ var init_text = () => {};
478
+
445
479
  // ../kit/src/input.ts
446
- var WHOLE = /^\d+$/;
447
480
  function wholeNumber(value, name, fallback, min = 1) {
448
481
  if (value === undefined)
449
482
  return fallback;
@@ -452,40 +485,25 @@ function wholeNumber(value, name, fallback, min = 1) {
452
485
  badUsage(`${name.startsWith("<") ? name : `--${name}`} takes a whole number from ${min}, not ${value}`);
453
486
  return number;
454
487
  }
488
+ var WHOLE;
489
+ var init_input = __esm(() => {
490
+ init_args();
491
+ WHOLE = /^\d+$/;
492
+ });
455
493
 
456
494
  // ../kit/src/args.ts
457
- var DASHES = /^-+/;
495
+ import process9 from "process";
496
+ import { parseArgs } from "util";
458
497
  function jsonOption(holds) {
459
498
  return { type: "boolean", description: holds === undefined ? "print JSON" : `print JSON: ${holds}` };
460
499
  }
461
- class Exit extends Error {
462
- code;
463
- hint;
464
- constructor(message, code, hint) {
465
- super(message);
466
- this.code = code;
467
- this.hint = hint;
468
- }
469
- }
470
500
  function fail(message, code = 2, hint) {
471
501
  throw new Exit(message, code, hint);
472
502
  }
473
-
474
- class UsageError extends Exit {
475
- constructor(message, hint) {
476
- super(message, 2, hint);
477
- }
478
- }
479
503
  function badUsage(message) {
480
504
  throw new UsageError(message);
481
505
  }
482
506
 
483
- class HelpShown extends Exit {
484
- constructor() {
485
- super("help shown", 0);
486
- }
487
- }
488
-
489
507
  class Completing {
490
508
  options;
491
509
  positionals;
@@ -496,11 +514,6 @@ class Completing {
496
514
  this.candidates = candidates;
497
515
  }
498
516
  }
499
- var completion = { active: false };
500
- var OUTPUT_OPTIONS = {
501
- color: { type: "string", choices: ["auto", "always", "never"], description: "auto (the default) colours on a terminal alone" },
502
- plain: { type: "boolean", description: "plain text, no colour or spinner: --color never" }
503
- };
504
517
  function applyOutput(color, plain, env = process9.env) {
505
518
  const when = plain === true ? "never" : color ?? "auto";
506
519
  if (when === "auto")
@@ -654,7 +667,6 @@ function parseError(error) {
654
667
  const message = upTo(error instanceof Error ? error.message : String(error), ". ");
655
668
  return `${message.charAt(0).toLowerCase()}${message.slice(1)}`;
656
669
  }
657
- var UNKNOWN_OPTION = /^unknown option '(-[^']+)'/;
658
670
  function nearestOption(message, options, allowNegative) {
659
671
  const typed = UNKNOWN_OPTION.exec(message)?.[1];
660
672
  if (typed === undefined)
@@ -670,6 +682,54 @@ function nearestOption(message, options, allowNegative) {
670
682
  const meant = closest(word, known.map((flag) => flag.replace(DASHES, "")));
671
683
  return meant === undefined ? undefined : `did you mean ${known.find((flag) => flag.replace(DASHES, "") === meant)}?`;
672
684
  }
685
+ var DASHES, Exit, UsageError, HelpShown, completion, OUTPUT_OPTIONS, UNKNOWN_OPTION;
686
+ var init_args = __esm(() => {
687
+ init_format();
688
+ init_help();
689
+ init_text();
690
+ init_help();
691
+ init_input();
692
+ DASHES = /^-+/;
693
+ Exit = class Exit extends Error {
694
+ code;
695
+ hint;
696
+ constructor(message, code, hint) {
697
+ super(message);
698
+ this.code = code;
699
+ this.hint = hint;
700
+ }
701
+ };
702
+ UsageError = class UsageError extends Exit {
703
+ constructor(message, hint) {
704
+ super(message, 2, hint);
705
+ }
706
+ };
707
+ HelpShown = class HelpShown extends Exit {
708
+ constructor() {
709
+ super("help shown", 0);
710
+ }
711
+ };
712
+ completion = { active: false };
713
+ OUTPUT_OPTIONS = {
714
+ color: { type: "string", choices: ["auto", "always", "never"], description: "auto (the default) colours on a terminal alone" },
715
+ plain: { type: "boolean", description: "plain text, no colour or spinner: --color never" }
716
+ };
717
+ UNKNOWN_OPTION = /^unknown option '(-[^']+)'/;
718
+ });
719
+
720
+ // ../kit/src/folders.ts
721
+ var SKIPPED_FOLDERS;
722
+ var init_folders = __esm(() => {
723
+ init_user_config();
724
+ SKIPPED_FOLDERS = new Set(["node_modules", "vendor", "dist", "build", "target", "coverage", "venv", "__pycache__"]);
725
+ });
726
+
727
+ // src/cli.ts
728
+ import process16 from "process";
729
+
730
+ // ../kit/src/index.ts
731
+ init_args();
732
+
673
733
  // ../kit/src/argv.ts
674
734
  import { readFileSync as readFileSync2, realpathSync } from "fs";
675
735
  import { resolve as resolve3 } from "path";
@@ -694,15 +754,73 @@ function scriptArgs(argv = process10.argv.slice(2), cmdline = commandLine(), scr
694
754
  const after = at === -1 ? [] : cmdline.slice(at + 1);
695
755
  return after[0] === "--" && after.length === argv.length + 1 && argv.every((word, index) => word === after[index + 1]) ? after : argv;
696
756
  }
757
+ // ../kit/src/chart.ts
758
+ init_format();
759
+ init_mode();
760
+ init_style();
761
+ init_theme();
762
+ // ../kit/src/ci.ts
763
+ init_args();
764
+ init_format();
765
+
697
766
  // ../kit/src/progress.ts
767
+ init_format();
768
+ init_style();
769
+ init_theme();
698
770
  var ESC = String.fromCharCode(27);
699
771
  var ESCAPE_CODE = new RegExp(`${ESC}(?:\\[[\\x30-\\x3F]*[\\x20-\\x2F]*[\\x40-\\x7E]|\\][^\\u0007${ESC}]*(?:\\u0007|${ESC}\\\\))`, "y");
700
772
  var RESET_STYLE = `${ESC}[0m`;
701
773
  var CLOSE_LINK = `${ESC}]8;;${ESC}\\`;
774
+
775
+ // ../kit/src/ci.ts
776
+ init_style();
777
+
778
+ // ../kit/src/tool.ts
779
+ init_format();
702
780
  // ../kit/src/cli.ts
781
+ init_args();
703
782
  import { readFileSync as readFileSync3, realpathSync as realpathSync2 } from "fs";
704
783
  import { dirname as dirname3, join as join5 } from "path";
705
- import process13 from "process";
784
+ import process14 from "process";
785
+
786
+ // ../kit/src/askpass.ts
787
+ import process11 from "process";
788
+ var SOCKET_VARIABLE = "KAYNOOO_ASKPASS_SOCKET";
789
+ async function askpassClient(argv) {
790
+ const socketPath = process11.env[SOCKET_VARIABLE];
791
+ if (socketPath === undefined)
792
+ return;
793
+ const request = { prompt: argv[0] ?? "", ...process11.env.SSH_ASKPASS_PROMPT === "none" ? { notice: true } : {} };
794
+ const { promise, resolve } = Promise.withResolvers();
795
+ let received = "";
796
+ try {
797
+ await Bun.connect({
798
+ unix: socketPath,
799
+ socket: {
800
+ open: (socket) => void socket.write(`${JSON.stringify(request)}
801
+ `),
802
+ data: (_, chunk) => {
803
+ received += chunk.toString();
804
+ },
805
+ close: () => resolve(received),
806
+ error: () => resolve("")
807
+ }
808
+ });
809
+ } catch {
810
+ return 1;
811
+ }
812
+ const reply = await promise;
813
+ if (reply === "")
814
+ return 1;
815
+ const { answer } = JSON.parse(reply);
816
+ if (request.notice === true)
817
+ return 0;
818
+ if (answer === undefined)
819
+ return 1;
820
+ process11.stdout.write(`${answer}
821
+ `);
822
+ return 0;
823
+ }
706
824
 
707
825
  // ../kit/src/completions.ts
708
826
  var COMPLETION_SHELLS = ["fish", "bash", "zsh"];
@@ -765,28 +883,34 @@ compdef __kaynooo_cli_complete ${bins.join(" ")}
765
883
  }
766
884
 
767
885
  // ../kit/src/notify.ts
768
- import process11 from "process";
886
+ init_format();
887
+ init_mode();
888
+ import process12 from "process";
769
889
  var NOTIFY_AFTER_MS = 1e4;
770
890
  var CANCELLED = 130;
771
891
  function base64(text) {
772
892
  return Buffer.from(text).toString("base64");
773
893
  }
774
- function notification(title, body, env = process11.env) {
775
- const id = `kit${process11.pid}`;
894
+ function notification(title, body, env = process12.env) {
895
+ const id = `kit${process12.pid}`;
776
896
  const codes = [`\x1B]99;i=${id}:d=0:o=unfocused:e=1;${base64(title)}\x1B\\`, `\x1B]99;i=${id}:p=body:e=1;${base64(body)}\x1B\\`];
777
897
  return codes.map((code) => env.TMUX === undefined || env.TMUX === "" ? code : `\x1BPtmux;${code.replaceAll("\x1B", "\x1B\x1B")}\x1B\\`).join("");
778
898
  }
779
- function notifyEnd(command, code, ms, { stream = process11.stderr, env = process11.env } = {}) {
899
+ function notifyEnd(command, code, ms, { stream = process12.stderr, env = process12.env } = {}) {
780
900
  if (ms < NOTIFY_AFTER_MS || code === CANCELLED || outputMode(stream, env) !== "terminal")
781
901
  return;
782
902
  stream.write(notification(command, code === 0 ? `done in ${formatDuration(ms)}` : `failed with exit ${code} after ${formatDuration(ms)}`, env));
783
903
  }
784
904
 
905
+ // ../kit/src/cli.ts
906
+ init_style();
907
+ init_text();
908
+
785
909
  // ../kit/src/usage.ts
786
910
  import { appendFileSync, mkdirSync } from "fs";
787
911
  import { homedir as homedir3 } from "os";
788
912
  import { dirname as dirname2, isAbsolute, join as join4 } from "path";
789
- import process12 from "process";
913
+ import process13 from "process";
790
914
 
791
915
  // ../kit/src/logs.ts
792
916
  var DAY_MS = 24 * 60 * 60 * 1000;
@@ -800,14 +924,14 @@ var usageError;
800
924
  function noteUsageError(message) {
801
925
  usageError = message;
802
926
  }
803
- function stateHome(env = process12.env) {
927
+ function stateHome(env = process13.env) {
804
928
  const dir = env.XDG_STATE_HOME;
805
929
  return dir !== undefined && isAbsolute(dir) ? dir : join4(homedir3(), ".local", "state");
806
930
  }
807
- function usagePath(env = process12.env) {
931
+ function usagePath(env = process13.env) {
808
932
  return join4(stateHome(env), CLI_FOLDER, "usage.jsonl");
809
933
  }
810
- function usageRecorded(env = process12.env) {
934
+ function usageRecorded(env = process13.env) {
811
935
  const off = env.KAYNOOO_CLI_NO_USAGE;
812
936
  return env.NODE_ENV !== "test" && (off === undefined || off === "" || off === "0");
813
937
  }
@@ -816,12 +940,12 @@ function flagNames(argv) {
816
940
  const names = (end === -1 ? argv : argv.slice(0, end)).filter((word) => word.startsWith("-") && word !== "-").map((word) => word.includes("=") ? word.slice(0, word.indexOf("=")) : word);
817
941
  return [...new Set(names)].filter((name) => name.length <= LONGEST_NAME && FLAG_NAME.test(name));
818
942
  }
819
- function usageEntry(bin, command, argv, code, now = new Date) {
943
+ function usageEntry(bin, command, argv, code, { ms, now = new Date } = {}) {
820
944
  const unknown = code === 2 && usageError !== undefined ? UNKNOWN_OPTION2.exec(usageError)?.[1] : undefined;
821
945
  usageError = undefined;
822
- return { at: now.toISOString(), bin, ...command === undefined ? {} : { command }, flags: flagNames(argv), code, ...unknown === undefined ? {} : { unknown } };
946
+ return { at: now.toISOString(), bin, ...command === undefined ? {} : { command }, flags: flagNames(argv), code, ...unknown === undefined ? {} : { unknown }, ...ms === undefined ? {} : { ms: Math.round(ms) } };
823
947
  }
824
- function recordUsage(entry, env = process12.env) {
948
+ function recordUsage(entry, env = process13.env) {
825
949
  if (!usageRecorded(env))
826
950
  return;
827
951
  try {
@@ -915,8 +1039,8 @@ async function help2({ path, header, summary: lazySummary, commands, defaultComm
915
1039
  `);
916
1040
  }
917
1041
  function printError(prefix, message, hint, cause) {
918
- const colors = paint(process13.stderr);
919
- const styled = takesControlCodes(process13.stderr);
1042
+ const colors = paint(process14.stderr);
1043
+ const styled = takesControlCodes(process14.stderr);
920
1044
  const head = styled ? `${colors.red.bold("error")} ${colors.dim(`${prefix}:`)}` : `error: ${prefix}:`;
921
1045
  const under = (label, text, tint) => text === undefined ? "" : `
922
1046
  ${styled ? tint(label) : `${label}:`} ${text}`;
@@ -959,11 +1083,11 @@ async function dispatch(level, typed, { version, redact }) {
959
1083
  }
960
1084
  }
961
1085
  if (name === undefined && level.path.length > 1) {
962
- console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process13.stderr));
1086
+ console.error(await help2(await expand(level, [...level.path.slice(1), ...argv]), process14.stderr));
963
1087
  return 2;
964
1088
  }
965
1089
  if (name === undefined || name === "help" || name === "--help" || name === "-h") {
966
- console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process13.stdout));
1090
+ console.log(await help2(await expand(level, [...level.path.slice(1), ...argv]), process14.stdout));
967
1091
  return 0;
968
1092
  }
969
1093
  if (level.path.length === 1 && (name === "--version" || name === "-v")) {
@@ -1109,6 +1233,9 @@ function packageVersion(entry = Bun.main) {
1109
1233
  }
1110
1234
  async function runCli(cli, argv = scriptArgs()) {
1111
1235
  const version = cli.version ?? packageVersion();
1236
+ const answered = await askpassClient(argv);
1237
+ if (answered !== undefined)
1238
+ return answered;
1112
1239
  if (argv[0] === COMPLETE)
1113
1240
  return printCandidates(candidates(scopeOf(cli.commands, cli.extraCommands, cli.aliases), cli.defaultCommand, argv.slice(1)));
1114
1241
  if (argv[0] === COMPLETIONS || argv[0]?.startsWith(`${COMPLETIONS}=`) === true)
@@ -1119,7 +1246,7 @@ async function runCli(cli, argv = scriptArgs()) {
1119
1246
  notifyEnd(command === undefined ? cli.name : `${cli.name} ${command}`, code, performance.now() - started);
1120
1247
  if (cli.usage !== false) {
1121
1248
  try {
1122
- recordUsage(usageEntry(cli.name, command, argv, code));
1249
+ recordUsage(usageEntry(cli.name, command, argv, code, { ms: performance.now() - started }));
1123
1250
  } catch {}
1124
1251
  }
1125
1252
  return code;
@@ -1139,465 +1266,47 @@ function commandPath(scope, argv) {
1139
1266
  }
1140
1267
  return path.length === 0 ? undefined : path.join(" ");
1141
1268
  }
1142
- // ../kit/src/compose.ts
1143
- async function captureOutput(argv, { cwd, env } = {}) {
1144
- const run = Bun.spawn(argv, { ...cwd === undefined ? {} : { cwd }, env: { ...process.env, ...env }, stdin: "ignore", stdout: "pipe", stderr: "pipe" });
1145
- const [stdout, stderr, code] = await Promise.all([new Response(run.stdout).text(), new Response(run.stderr).text(), run.exited]);
1146
- return { code, stdout, stderr };
1147
- }
1148
- async function compose(args, { flags = [], ...options } = {}) {
1149
- return captureOutput(["docker", "compose", ...flags, ...args], options);
1150
- }
1151
- function composeError({ code, stderr }) {
1152
- const last = stderr.trim().split(`
1153
- `).at(-1) ?? "";
1154
- return last === "" ? `exit ${code}` : last;
1155
- }
1156
- // ../kit/src/folders.ts
1157
- var SKIPPED_FOLDERS = new Set(["node_modules", "vendor", "dist", "build", "target", "coverage", "venv", "__pycache__"]);
1269
+
1270
+ // ../kit/src/index.ts
1271
+ init_config();
1272
+
1273
+ // ../kit/src/excerpt.ts
1274
+ init_text();
1275
+
1276
+ // ../kit/src/index.ts
1277
+ init_folders();
1278
+ init_format();
1279
+
1280
+ // ../kit/src/git.ts
1281
+ init_args();
1158
1282
  // ../kit/src/limit.ts
1159
- function limitOptions(fallback) {
1160
- return {
1161
- limit: { type: "string", short: "n", description: `show at most this many rows, the rest counted (${fallback})` },
1162
- full: { type: "boolean", description: "show every row" }
1163
- };
1164
- }
1165
- function limitOf(values, fallback) {
1166
- if (values.full === true && values.limit !== undefined)
1167
- badUsage("--limit and --full exclude each other");
1168
- if (values.full === true || values.json === true && values.limit === undefined)
1169
- return Number.POSITIVE_INFINITY;
1170
- return wholeNumber(values.limit, "limit", fallback);
1171
- }
1172
- function moreFooter(more) {
1173
- return `${more} more, rerun with --full`;
1174
- }
1175
- function capped(rows, limit) {
1176
- const more = rows.length - limit;
1177
- return more > 0 ? { shown: rows.slice(0, limit), footer: moreFooter(more) } : { shown: [...rows], footer: undefined };
1178
- }
1283
+ init_args();
1284
+
1285
+ // ../kit/src/index.ts
1286
+ init_mode();
1287
+
1288
+ // ../kit/src/report.ts
1289
+ init_style();
1290
+ init_text();
1179
1291
  // ../kit/src/secrets.ts
1180
1292
  var SECRET_WORDS = new Set(["key", "pass", "pwd", "auth", "salt", "cookie", "session", "jwt", "ssn", "iban", "card", "cvv", "otp"]);
1181
1293
  // ../kit/src/sessions.ts
1182
1294
  var {Glob } = globalThis.Bun;
1183
1295
  var SESSION_FILES = new Glob("*.json");
1184
1296
  var ACCOUNT_DIRS = new Glob("*/sessions");
1185
- // src/commands/audit.ts
1186
- import { homedir as homedir4 } from "os";
1187
- import { resolve as resolve5 } from "path";
1188
- import process16 from "process";
1189
-
1190
- // src/audit/compose.ts
1191
- import { join as join6 } from "path";
1192
- var dockerCompose = async (root, files) => {
1193
- const result = await compose(["config", "--no-interpolate", "--format", "json"], { flags: ["--project-directory", root, ...files.flatMap((file) => ["-f", join6(root, file)])], env: { COMPOSE_FILE: "" } });
1194
- if (result.code !== 0)
1195
- throw new Error(composeError(result));
1196
- return JSON.parse(result.stdout);
1197
- };
1198
-
1199
- // src/audit/render.ts
1200
- import { basename } from "path";
1201
- import process15 from "process";
1202
- var line = (finding) => ` ${marked(finding.level === "error" ? "problem" : "warn", `[${finding.check}] ${finding.message}`, process15.stdout)}`;
1203
- function errorsOf(result) {
1204
- return result.findings.filter((finding) => finding.level === "error");
1205
- }
1206
- function section2(heading, findings, limit) {
1207
- const { shown, footer } = capped(findings, limit);
1208
- return findings.length === 0 ? [] : [heading, ...shown.map(line), ...footer === undefined ? [] : [` ${footer}`], ""];
1209
- }
1210
- function render(result, limit = Number.POSITIVE_INFINITY) {
1211
- const errors = errorsOf(result);
1212
- const warnings = result.findings.filter((finding) => finding.level === "warn");
1213
- if (result.findings.length === 0)
1214
- return marked("ok", `${basename(result.root)}: compose ${result.composeFiles.join(", ")} and release.config.ts agree.`, process15.stdout);
1215
- return [
1216
- ...section2("Errors", errors, limit),
1217
- ...section2("Warnings", warnings, limit),
1218
- `${errors.length} error(s), ${warnings.length} warning(s)`
1219
- ].join(`
1220
- `);
1221
- }
1222
-
1223
- // src/audit/run.ts
1224
- import { existsSync as existsSync5 } from "fs";
1225
- import { join as join9 } from "path";
1226
-
1227
- // src/audit/checks.ts
1228
- import { existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
1229
- import { isAbsolute as isAbsolute2, join as join7, relative, resolve as resolve4 } from "path";
1230
- var ENV_REF = /(?<!\$)\$(?:\{([A-Z_]\w*)(\s*:?[-?+][^}]*)?\}|([A-Z_]\w*))/gi;
1231
- var REQUIRED_OPERATOR = /^\s*:?\?/;
1232
- var COMMENT_START = /(?:^|\s)#.*$/;
1233
- var QUOTES = /['"]/g;
1234
- var YAML_FILE = /\.ya?ml$/;
1235
- var LEADING_DOT_SLASH = /^\.\//;
1236
- var SERVICES_KEY = /^services:/m;
1237
- var EXEC_SERVICE = /\{compose\}(?:\s+--\S+)*\s+(?:exec|run)\s+(?:-\S+\s+)*([\w-]+)/;
1238
- var services = (model) => Object.entries(model?.services ?? {});
1239
- function before(text, separator) {
1240
- const at = text.indexOf(separator);
1241
- return at < 0 ? text : text.slice(0, at);
1242
- }
1243
- var stripDotSlash = (file) => file.replace(LEADING_DOT_SLASH, "");
1244
- function composeLayout(root, config) {
1245
- const composeFiles = (config.deploySyncFiles ?? []).map(stripDotSlash).filter((file) => YAML_FILE.test(file) && existsSync3(join7(root, file)));
1246
- const [base] = composeFiles.toSorted((a, b) => a.length - b.length);
1247
- return { composeFiles, base, overlays: composeFiles.filter((file) => file !== base) };
1248
- }
1249
- function syncFindings(root, config) {
1250
- return (config.deploySyncFiles ?? []).filter((file) => !existsSync3(join7(root, stripDotSlash(file)))).map((file) => ({ level: "error", check: "sync", message: `deploySyncFiles entry does not exist: ${file}` }));
1251
- }
1252
- function buildFindings(root, releases, env, home) {
1253
- const findings = [];
1254
- const missing = (release, key) => {
1255
- const path = release[key];
1256
- if (path !== undefined && path !== "" && !existsSync3(join7(root, path)))
1257
- findings.push({ level: "error", check: "build", message: `${release.slug}: ${key} does not exist: ${path}` });
1258
- };
1259
- for (const release of releases) {
1260
- missing(release, "sourceDir");
1261
- missing(release, "buildContext");
1262
- missing(release, "dockerfile");
1263
- for (const secret of release.buildSecrets ?? []) {
1264
- if (secret.src !== undefined && secret.src !== "") {
1265
- const path = secret.src.startsWith("~") ? join7(home, secret.src.slice(1)) : resolve4(root, secret.src);
1266
- if (!existsSync3(path))
1267
- findings.push({ level: "error", check: "build", message: `${release.slug}: buildSecret "${secret.id}" src does not exist: ${secret.src}` });
1268
- }
1269
- if (secret.env !== undefined && secret.env !== "" && (env[secret.env] ?? "") === "")
1270
- findings.push({ level: "warn", check: "build", message: `${release.slug}: buildSecret "${secret.id}" reads $${secret.env}, unset in this shell` });
1271
- }
1272
- }
1273
- return findings;
1274
- }
1275
- function withoutComment(line) {
1276
- const comment = COMMENT_START.exec(line);
1277
- if (comment === null || (line.slice(0, comment.index).match(QUOTES)?.length ?? 0) % 2 === 1)
1278
- return line;
1279
- return line.slice(0, comment.index);
1280
- }
1281
- function envRefs(root, composeFiles) {
1282
- return composeFiles.flatMap((file) => {
1283
- const text = readFileSync4(join7(root, file), "utf8").split(`
1284
- `).map(withoutComment).join(`
1285
- `);
1286
- return [...text.matchAll(ENV_REF)].map((match) => ({ name: match[1] ?? match[3], defaulted: match[2] !== undefined && !REQUIRED_OPERATOR.test(match[2]), file }));
1287
- });
1288
- }
1289
- function envFindings(refs, required) {
1290
- const findings = [];
1291
- const level = required.length > 0 ? "error" : "warn";
1292
- for (const name of new Set(refs.filter((ref) => !ref.defaulted).map((ref) => ref.name))) {
1293
- if (!name.endsWith("_VERSION") && !required.includes(name))
1294
- findings.push({ level, check: "env", message: `\${${name}} has no default in ${refs.find((ref) => ref.name === name)?.file} and is not in requiredServerEnv` });
1295
- }
1296
- for (const name of required) {
1297
- if (!refs.some((ref) => ref.name === name))
1298
- findings.push({ level: "warn", check: "env", message: `requiredServerEnv lists ${name}, which no compose file references` });
1299
- }
1300
- return findings;
1301
- }
1302
- function versionFindings(refs, releases) {
1303
- const findings = [];
1304
- const inCompose = new Set(refs.filter((ref) => ref.name.endsWith("_VERSION")).map((ref) => ref.name));
1305
- const inConfig = new Set(releases.map((release) => release.versionEnv).filter((name) => typeof name === "string" && name !== ""));
1306
- for (const name of inConfig) {
1307
- if (!inCompose.has(name))
1308
- findings.push({ level: "error", check: "version", message: `versionEnv ${name} is never interpolated by a compose file` });
1309
- }
1310
- for (const name of inCompose) {
1311
- if (!inConfig.has(name))
1312
- findings.push({ level: "error", check: "version", message: `compose interpolates \${${name}}, which no release declares as versionEnv` });
1313
- }
1314
- return findings;
1315
- }
1316
- function imageFindings(config, releases, model) {
1317
- const registry = config.registry ?? "";
1318
- if (registry === "")
1319
- return [];
1320
- const declared = new Set(releases.filter((release) => release.image !== undefined && release.image !== "").map((release) => `${registry}/${release.image}`));
1321
- const findings = [];
1322
- for (const [name, service] of services(model)) {
1323
- const repo = service.image === undefined ? undefined : before(service.image, ":");
1324
- if (repo !== undefined && repo.startsWith(registry) && !declared.has(repo))
1325
- findings.push({ level: "warn", check: "image", message: `service "${name}" pulls ${repo}, which no release in this config builds` });
1326
- }
1327
- return findings;
1328
- }
1329
- function restartFindings(config, releases, model, base) {
1330
- if (model === undefined)
1331
- return [];
1332
- const known = new Set(Object.keys(model.services ?? {}));
1333
- const findings = [];
1334
- for (const release of releases) {
1335
- for (const service of release.restartServices ?? []) {
1336
- if (!known.has(service))
1337
- findings.push({ level: "error", check: "restart", message: `${release.slug}: restartServices names "${service}", absent from ${base}` });
1338
- }
1339
- }
1340
- for (const server of config.servers ?? []) {
1341
- for (const [slug, override] of Object.entries(server.releaseOverrides ?? {})) {
1342
- for (const service of override.restartServices ?? []) {
1343
- if (!known.has(service))
1344
- findings.push({ level: "error", check: "restart", message: `server ${server.name}: releaseOverrides.${slug} names service "${service}", absent from ${base}` });
1345
- }
1346
- }
1347
- }
1348
- return findings;
1349
- }
1350
- function postDeployFindings(releases, model, base) {
1351
- if (model === undefined)
1352
- return [];
1353
- const known = new Set(Object.keys(model.services ?? {}));
1354
- const findings = [];
1355
- for (const release of releases) {
1356
- for (const command of release.postDeployCommands ?? []) {
1357
- const target = EXEC_SERVICE.exec(command)?.[1];
1358
- if (target !== undefined && !known.has(target))
1359
- findings.push({ level: "warn", check: "post-deploy", message: `${release.slug}: post-deploy command targets service "${target}", absent from ${base}` });
1360
- }
1361
- }
1362
- return findings;
1363
- }
1364
- var gatedServices = (releases) => new Set(releases.flatMap((release) => release.restartServices ?? []));
1365
- function healthFindings(gated, model) {
1366
- return [...gated].filter((name) => {
1367
- const service = model?.services?.[name];
1368
- return service !== undefined && (service.healthcheck === undefined || service.healthcheck === null);
1369
- }).map((name) => ({ level: "warn", check: "health", message: `service "${name}" is restarted by a release but declares no healthcheck, so --wait will not gate it` }));
1370
- }
1371
- function routingFindings(config, gated, model, base, overlays) {
1372
- if (overlays.length === 0)
1373
- return [];
1374
- const findings = [];
1375
- for (const name of gated) {
1376
- const service = model?.services?.[name];
1377
- if (service === undefined)
1378
- continue;
1379
- if (service.ports !== undefined && service.ports.length > 0)
1380
- findings.push({ level: "error", check: "routing", message: `service "${name}" publishes ports in ${base}; publishing belongs in an overlay` });
1381
- if (Object.keys(service.labels ?? {}).some((key) => key.startsWith("traefik.")))
1382
- findings.push({ level: "error", check: "routing", message: `service "${name}" carries traefik labels in ${base}; routing belongs in an overlay` });
1383
- }
1384
- const composeArgs = config.composeArgs ?? [];
1385
- if (composeArgs.length > 0)
1386
- findings.push({ level: "error", check: "routing", message: `composeArgs is set (${composeArgs.join(" ")}) while ${overlays.length} overlay(s) exist: -f overrides each server's COMPOSE_FILE and drops them` });
1387
- for (const server of config.servers ?? []) {
1388
- if (server.composeArgs !== undefined && server.composeArgs.length > 0)
1389
- findings.push({ level: "warn", check: "routing", message: `server ${server.name} sets composeArgs; prefer its own COMPOSE_FILE` });
1390
- }
1391
- return findings;
1392
- }
1393
- var SOURCE_END = /:(?![-+?=])/;
1394
- var DEFAULTED_VARIABLE = /\$\{[A-Z_]\w*:?-([^}$]*)\}/gi;
1395
- function relativeSource(root, written) {
1396
- const source = written?.replaceAll(DEFAULTED_VARIABLE, "$1");
1397
- if (source === undefined || source.includes("$"))
1398
- return;
1399
- if (source.startsWith("."))
1400
- return source;
1401
- const inRoot = relative(resolve4(root), source);
1402
- return isAbsolute2(source) && inRoot !== "" && !inRoot.startsWith("..") ? `./${inRoot}` : undefined;
1403
- }
1404
- function layoutFindings(root, base, model) {
1405
- if (base === undefined)
1406
- return [];
1407
- const header = readFileSync4(join7(root, base), "utf8").split(SERVICES_KEY)[0] ?? "";
1408
- const findings = [];
1409
- for (const [name, service] of services(model)) {
1410
- for (const volume of service.volumes ?? []) {
1411
- const source = relativeSource(root, typeof volume === "string" ? volume.split(SOURCE_END)[0] : volume.source);
1412
- if (source !== undefined && !header.includes(stripDotSlash(source)))
1413
- findings.push({ level: "warn", check: "layout", message: `service "${name}" bind-mounts ${source}, absent from the header's expected server layout` });
1414
- }
1415
- }
1416
- return findings;
1417
- }
1418
- function gitignoreFindings(root) {
1419
- const path = join7(root, ".gitignore");
1420
- const text = existsSync3(path) ? readFileSync4(path, "utf8") : "";
1421
- return [".release-logs", ".release-worktrees"].filter((entry) => !text.includes(entry)).map((entry) => ({ level: "warn", check: "gitignore", message: `${entry}/ is not in .gitignore` }));
1422
- }
1423
-
1424
- // src/audit/nuxt.ts
1425
- import { existsSync as existsSync4, readFileSync as readFileSync5 } from "fs";
1426
- import { basename as basename2, join as join8 } from "path";
1427
- var CAMEL_BOUNDARY = /([a-z0-9])([A-Z])/g;
1428
- var KEY = /([A-Z_]\w*)\s*(?:\?\s*)?:/gi;
1429
- var OPENS_BRACE = /^\s*\{/;
1430
- var envVarFor = (key) => key.replace(CAMEL_BOUNDARY, "$1_$2").toUpperCase();
1431
- function braceBody(text, from) {
1432
- const open = text.indexOf("{", from);
1433
- if (open < 0)
1434
- return;
1435
- let depth = 0;
1436
- for (let i = open;i < text.length; i++) {
1437
- if (text[i] === "{")
1438
- depth++;
1439
- else if (text[i] === "}" && --depth === 0)
1440
- return { body: text.slice(open + 1, i), end: i };
1441
- }
1442
- return;
1443
- }
1444
- function leafPaths(body, prefix = []) {
1445
- const paths = [];
1446
- const key = new RegExp(KEY);
1447
- for (let match = key.exec(body);match !== null; match = key.exec(body)) {
1448
- const name = match[1];
1449
- const after = match.index + match[0].length;
1450
- if (OPENS_BRACE.test(body.slice(after))) {
1451
- const inner = braceBody(body, after);
1452
- if (inner === undefined)
1453
- continue;
1454
- paths.push(...leafPaths(inner.body, [...prefix, name]));
1455
- key.lastIndex = inner.end + 1;
1456
- } else {
1457
- paths.push([...prefix, name]);
1458
- }
1459
- }
1460
- return paths;
1461
- }
1462
- function schemaEnvNames(schema, iface, prefix) {
1463
- const at = schema.indexOf(`interface ${iface}`);
1464
- const body = at < 0 ? undefined : braceBody(schema, at);
1465
- return body === undefined ? [] : leafPaths(body.body).map((path) => prefix + path.map(envVarFor).join("_"));
1466
- }
1467
- function nuxtFindings(root, releases, model) {
1468
- const findings = [];
1469
- const dirs = [...new Set(releases.map((release) => release.buildContext).filter((context) => context !== undefined && context !== ""))].map((dir) => join8(root, dir)).filter((dir) => existsSync4(join8(dir, "nuxt.config.ts")));
1470
- for (const dir of dirs) {
1471
- const schemaPath = [join8(dir, ".nuxt/types/schema.d.ts"), join8(dir, ".nuxt/types/runtime-config.d.ts")].find((path) => existsSync4(path));
1472
- let allowed;
1473
- let level = "error";
1474
- let source;
1475
- if (schemaPath !== undefined) {
1476
- const schema = readFileSync5(schemaPath, "utf8");
1477
- allowed = new Set([
1478
- ...schemaEnvNames(schema, "SharedRuntimeConfig", "NUXT_"),
1479
- ...schemaEnvNames(schema, "SharedPublicRuntimeConfig", "NUXT_PUBLIC_")
1480
- ]);
1481
- source = `${basename2(dir)}/${schemaPath.slice(dir.length + 1)}`;
1482
- } else {
1483
- const config = readFileSync5(join8(dir, "nuxt.config.ts"), "utf8");
1484
- const at = config.indexOf("runtimeConfig:");
1485
- const block = at < 0 ? undefined : braceBody(config, at);
1486
- if (block === undefined)
1487
- continue;
1488
- allowed = new Set(leafPaths(block.body).map((path) => path[0] === "public" ? `NUXT_PUBLIC_${path.slice(1).map(envVarFor).join("_")}` : `NUXT_${path.map(envVarFor).join("_")}`));
1489
- level = "warn";
1490
- source = `${basename2(dir)}/nuxt.config.ts (run \`nuxt prepare\` in ${basename2(dir)} for the resolved config, modules included)`;
1491
- }
1492
- for (const [name, service] of Object.entries(model?.services ?? {})) {
1493
- for (const key of Object.keys(service.environment ?? {})) {
1494
- if (key.startsWith("NUXT_") && !allowed.has(key))
1495
- findings.push({ level, check: "nuxt", message: `service "${name}" sets ${key}, which matches no runtimeConfig key in ${source}` });
1496
- }
1497
- }
1498
- }
1499
- return findings;
1500
- }
1501
1297
 
1502
- // src/audit/run.ts
1503
- var CONFIG_FILE = "release.config.ts";
1504
- var DEFINE_CONFIG_IMPORT = /import\s*\{[^}]*\bdefineConfig\b[^}]*\}\s*from\s*['"]([^'"]+)['"]/;
1505
- function installed(specifier, root) {
1506
- try {
1507
- Bun.resolveSync(specifier, root);
1508
- return true;
1509
- } catch {
1510
- return false;
1511
- }
1512
- }
1513
- async function loadConfig(root) {
1514
- const specifier = DEFINE_CONFIG_IMPORT.exec(await Bun.file(join9(root, CONFIG_FILE)).text())?.[1];
1515
- if (specifier !== undefined && !installed(specifier, root)) {
1516
- Bun.plugin({
1517
- name: "release-stand-in",
1518
- setup(build) {
1519
- build.module(specifier, () => ({ exports: { defineConfig: (config) => config }, loader: "object" }));
1520
- }
1521
- });
1522
- }
1523
- const config = (await import(join9(root, CONFIG_FILE))).default;
1524
- if (config === undefined)
1525
- fail(`${CONFIG_FILE} has no default export`);
1526
- return config;
1527
- }
1528
- async function composeModels(options, base, overlays) {
1529
- const findings = [];
1530
- const load = async (files) => {
1531
- try {
1532
- return await options.loadCompose(options.root, files);
1533
- } catch (error) {
1534
- findings.push({ level: "error", check: "compose", message: `docker compose config failed for ${files.join(" + ")}: ${error instanceof Error ? error.message : String(error)}` });
1535
- return;
1536
- }
1537
- };
1538
- if (base === undefined) {
1539
- findings.push({ level: "warn", check: "compose", message: "no compose file among deploySyncFiles, so every check that reads the compose model was skipped" });
1540
- return { model: undefined, findings };
1541
- }
1542
- const model = await load([base]);
1543
- for (const overlay of overlays)
1544
- await load([base, overlay]);
1545
- return { model, findings };
1546
- }
1547
- async function audit(config, options) {
1548
- const { root } = options;
1549
- const releases = config.releases ?? [];
1550
- const required = config.requiredServerEnv ?? [];
1551
- const { composeFiles, base, overlays } = composeLayout(root, config);
1552
- const compose = await composeModels(options, base, overlays);
1553
- const refs = envRefs(root, composeFiles);
1554
- const gated = gatedServices(releases);
1555
- const findings = [
1556
- ...syncFindings(root, config),
1557
- ...buildFindings(root, releases, options.env, options.home),
1558
- ...compose.findings,
1559
- ...envFindings(refs, required),
1560
- ...versionFindings(refs, releases),
1561
- ...imageFindings(config, releases, compose.model),
1562
- ...restartFindings(config, releases, compose.model, base),
1563
- ...postDeployFindings(releases, compose.model, base),
1564
- ...healthFindings(gated, compose.model),
1565
- ...routingFindings(config, gated, compose.model, base, overlays),
1566
- ...layoutFindings(root, base, compose.model),
1567
- ...nuxtFindings(root, releases, compose.model),
1568
- ...gitignoreFindings(root)
1569
- ];
1570
- return { root, composeFiles, findings };
1571
- }
1572
- var hasConfig = (root) => existsSync5(join9(root, CONFIG_FILE));
1573
-
1574
- // src/commands/audit.ts
1575
- var usage2 = `stack audit [dir]
1576
-
1577
- Cross-checks ${CONFIG_FILE} in dir (the current directory) against the compose files it syncs: sync files and build inputs exist, env variables are required or defaulted, versionEnv matches the compose interpolation, restart and post-deploy services exist, healthchecks, routing in overlays, bind mounts documented in the header, Nuxt runtimeConfig keys and .gitignore.
1578
- Lists at most 25 errors and 25 warnings, the count of the rest after them (--limit <n>, --full for all); --json is never cut.
1579
- Needs docker for \`docker compose config\`.
1580
-
1581
- Exits 0 when it finds no error, 1 when it finds one, 2 when there is no ${CONFIG_FILE}.`;
1582
- var AUDIT_LIMIT = 25;
1583
- var options = {
1584
- ...limitOptions(AUDIT_LIMIT),
1585
- json: jsonOption("{ root, composeFiles, findings }")
1586
- };
1587
- async function audit2(args, overrides = {}) {
1588
- const parsed = parse(args, usage2, options);
1589
- const root = resolve5(parsed.positionals[0] ?? ".");
1590
- if (!hasConfig(root)) {
1591
- fail(`no ${CONFIG_FILE} in ${root}`);
1592
- }
1593
- const result = await audit(await loadConfig(root), { root, loadCompose: dockerCompose, env: process16.env, home: homedir4(), ...overrides });
1594
- if (parsed.values.json === true)
1595
- printJson(result);
1596
- else
1597
- console.log(render(result, limitOf(parsed.values, AUDIT_LIMIT)));
1598
- return errorsOf(result).length > 0 ? 1 : 0;
1599
- }
1298
+ // ../kit/src/index.ts
1299
+ init_style();
1300
+ init_text();
1301
+ init_theme();
1302
+ init_user_config();
1600
1303
 
1304
+ // ../kit/src/watch.ts
1305
+ init_args();
1306
+ init_input();
1307
+ init_style();
1308
+ // ../kit/src/workspace-root.ts
1309
+ init_user_config();
1601
1310
  // src/port.ts
1602
1311
  var MIN_PORT = 1024;
1603
1312
  var MAX_PORT = 65535;
@@ -1622,19 +1331,19 @@ function isListening(port) {
1622
1331
  }
1623
1332
 
1624
1333
  // src/commands/port.ts
1625
- var usage3 = `stack port <name>
1334
+ var usage2 = `stack port <name>
1626
1335
 
1627
1336
  Prints the port a name always hashes to (32-bit FNV-1a, ${MIN_PORT}-${DEFAULT_MAX_PORT} by default, below Linux's ephemeral range), so a service keeps the same port on every machine.
1628
1337
  Says on stderr when something already listens on it; the exit code stays 0.
1629
1338
 
1630
1339
  Exits 0 when it printed the port, 2 on a usage error.`;
1631
- var options2 = {
1340
+ var options = {
1632
1341
  min: { type: "string", description: `lowest port (${MIN_PORT}, nothing lower is allowed)` },
1633
1342
  max: { type: "string", description: `highest port (${DEFAULT_MAX_PORT}, up to ${MAX_PORT})` },
1634
1343
  json: jsonOption("{name, port, listening}")
1635
1344
  };
1636
1345
  async function port(args) {
1637
- const parsed = parse(args, usage3, options2);
1346
+ const parsed = parse(args, usage2, options);
1638
1347
  const [name] = parsed.positionals;
1639
1348
  if (name === undefined)
1640
1349
  fail("a name is needed");
@@ -1654,13 +1363,12 @@ async function port(args) {
1654
1363
  }
1655
1364
 
1656
1365
  // src/cli.ts
1657
- process17.exitCode = await runCli({
1366
+ process16.exitCode = await runCli({
1658
1367
  name: "stack",
1659
- about: "a stable port per service name, and a compose release audit",
1660
- replaces: "picking a free host port by hand, and reading compose files against release.config.ts",
1661
- examples: ["stack port api", ["stack audit", "this folder's release setup"]],
1368
+ about: "a stable port per service name",
1369
+ replaces: "picking a free host port by hand",
1370
+ examples: ["stack port api", ["stack port api --json", "the port and whether something listens on it"]],
1662
1371
  commands: {
1663
- port: { run: port, summary: "the port a name always hashes to, with a warning when something already listens on it" },
1664
- audit: { run: audit2, summary: "cross-check release.config.ts against its compose files" }
1372
+ port: { run: port, summary: "the port a name always hashes to, with a warning when something already listens on it" }
1665
1373
  }
1666
1374
  });
package/package.json CHANGED
@@ -1,18 +1,18 @@
1
1
  {
2
2
  "name": "@kaynooo/cli-stack",
3
3
  "type": "module",
4
- "version": "0.7.2",
5
- "description": "stack: a stable port per service name, and an audit of a compose release setup against its release.config.ts.",
4
+ "version": "0.8.0",
5
+ "description": "stack: a stable host port per service name, the same on every machine.",
6
6
  "author": "Kaynooo <contact@kaynooo.fr>",
7
7
  "license": "MIT",
8
- "homepage": "https://git.kaynooo.fr/kaynooo/cli/src/branch/main/packages/stack#readme",
8
+ "homepage": "https://github.com/Kayno0o/cli/tree/main/packages/stack#readme",
9
9
  "repository": {
10
10
  "type": "git",
11
- "url": "git+https://git.kaynooo.fr/kaynooo/cli.git",
11
+ "url": "git+https://github.com/Kayno0o/cli.git",
12
12
  "directory": "packages/stack"
13
13
  },
14
- "bugs": "https://git.kaynooo.fr/kaynooo/cli/issues",
15
- "keywords": ["docker", "compose", "port", "release", "cli", "bun"],
14
+ "bugs": "https://github.com/Kayno0o/cli/issues",
15
+ "keywords": ["docker", "compose", "port", "cli", "bun"],
16
16
  "bin": {
17
17
  "stack": "./dist/cli.js"
18
18
  },
@@ -28,6 +28,6 @@
28
28
  "stack": "$npm_execpath src/cli.ts"
29
29
  },
30
30
  "devDependencies": {
31
- "@kaynooo/cli-kit": "0.41.0"
31
+ "@kaynooo/cli-kit": "0.45.0"
32
32
  }
33
33
  }