@hasna/configs 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 (58) hide show
  1. package/README.md +264 -0
  2. package/dashboard/dist/assets/index-DQ3P1g1z.css +1 -0
  3. package/dashboard/dist/assets/index-DbXmAL_d.js +11 -0
  4. package/dashboard/dist/index.html +14 -0
  5. package/dashboard/dist/vite.svg +1 -0
  6. package/dist/cli/index.d.ts +3 -0
  7. package/dist/cli/index.d.ts.map +1 -0
  8. package/dist/cli/index.js +3087 -0
  9. package/dist/db/configs.d.ts +10 -0
  10. package/dist/db/configs.d.ts.map +1 -0
  11. package/dist/db/configs.test.d.ts +2 -0
  12. package/dist/db/configs.test.d.ts.map +1 -0
  13. package/dist/db/database.d.ts +7 -0
  14. package/dist/db/database.d.ts.map +1 -0
  15. package/dist/db/machines.d.ts +8 -0
  16. package/dist/db/machines.d.ts.map +1 -0
  17. package/dist/db/machines.test.d.ts +2 -0
  18. package/dist/db/machines.test.d.ts.map +1 -0
  19. package/dist/db/profiles.d.ts +11 -0
  20. package/dist/db/profiles.d.ts.map +1 -0
  21. package/dist/db/profiles.test.d.ts +2 -0
  22. package/dist/db/profiles.test.d.ts.map +1 -0
  23. package/dist/db/snapshots.d.ts +8 -0
  24. package/dist/db/snapshots.d.ts.map +1 -0
  25. package/dist/db/snapshots.test.d.ts +2 -0
  26. package/dist/db/snapshots.test.d.ts.map +1 -0
  27. package/dist/index.d.ts +17 -0
  28. package/dist/index.d.ts.map +1 -0
  29. package/dist/index.js +896 -0
  30. package/dist/lib/apply.d.ts +11 -0
  31. package/dist/lib/apply.d.ts.map +1 -0
  32. package/dist/lib/apply.test.d.ts +2 -0
  33. package/dist/lib/apply.test.d.ts.map +1 -0
  34. package/dist/lib/export.d.ts +12 -0
  35. package/dist/lib/export.d.ts.map +1 -0
  36. package/dist/lib/import.d.ts +14 -0
  37. package/dist/lib/import.d.ts.map +1 -0
  38. package/dist/lib/sync.d.ts +19 -0
  39. package/dist/lib/sync.d.ts.map +1 -0
  40. package/dist/lib/sync.test.d.ts +2 -0
  41. package/dist/lib/sync.test.d.ts.map +1 -0
  42. package/dist/lib/template.d.ts +10 -0
  43. package/dist/lib/template.d.ts.map +1 -0
  44. package/dist/lib/template.test.d.ts +2 -0
  45. package/dist/lib/template.test.d.ts.map +1 -0
  46. package/dist/mcp/index.d.ts +3 -0
  47. package/dist/mcp/index.d.ts.map +1 -0
  48. package/dist/mcp/index.js +662 -0
  49. package/dist/mcp/mcp.test.d.ts +2 -0
  50. package/dist/mcp/mcp.test.d.ts.map +1 -0
  51. package/dist/server/index.d.ts +7 -0
  52. package/dist/server/index.d.ts.map +1 -0
  53. package/dist/server/index.js +2390 -0
  54. package/dist/server/server.test.d.ts +2 -0
  55. package/dist/server/server.test.d.ts.map +1 -0
  56. package/dist/types/index.d.ts +152 -0
  57. package/dist/types/index.d.ts.map +1 -0
  58. package/package.json +78 -0
@@ -0,0 +1,3087 @@
1
+ #!/usr/bin/env bun
2
+ // @bun
3
+ var __create = Object.create;
4
+ var __getProtoOf = Object.getPrototypeOf;
5
+ var __defProp = Object.defineProperty;
6
+ var __getOwnPropNames = Object.getOwnPropertyNames;
7
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
8
+ var __toESM = (mod, isNodeMode, target) => {
9
+ target = mod != null ? __create(__getProtoOf(mod)) : {};
10
+ const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
11
+ for (let key of __getOwnPropNames(mod))
12
+ if (!__hasOwnProp.call(to, key))
13
+ __defProp(to, key, {
14
+ get: () => mod[key],
15
+ enumerable: true
16
+ });
17
+ return to;
18
+ };
19
+ var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
20
+ var __require = import.meta.require;
21
+
22
+ // node_modules/commander/lib/error.js
23
+ var require_error = __commonJS((exports) => {
24
+ class CommanderError extends Error {
25
+ constructor(exitCode, code, message) {
26
+ super(message);
27
+ Error.captureStackTrace(this, this.constructor);
28
+ this.name = this.constructor.name;
29
+ this.code = code;
30
+ this.exitCode = exitCode;
31
+ this.nestedError = undefined;
32
+ }
33
+ }
34
+
35
+ class InvalidArgumentError extends CommanderError {
36
+ constructor(message) {
37
+ super(1, "commander.invalidArgument", message);
38
+ Error.captureStackTrace(this, this.constructor);
39
+ this.name = this.constructor.name;
40
+ }
41
+ }
42
+ exports.CommanderError = CommanderError;
43
+ exports.InvalidArgumentError = InvalidArgumentError;
44
+ });
45
+
46
+ // node_modules/commander/lib/argument.js
47
+ var require_argument = __commonJS((exports) => {
48
+ var { InvalidArgumentError } = require_error();
49
+
50
+ class Argument {
51
+ constructor(name, description) {
52
+ this.description = description || "";
53
+ this.variadic = false;
54
+ this.parseArg = undefined;
55
+ this.defaultValue = undefined;
56
+ this.defaultValueDescription = undefined;
57
+ this.argChoices = undefined;
58
+ switch (name[0]) {
59
+ case "<":
60
+ this.required = true;
61
+ this._name = name.slice(1, -1);
62
+ break;
63
+ case "[":
64
+ this.required = false;
65
+ this._name = name.slice(1, -1);
66
+ break;
67
+ default:
68
+ this.required = true;
69
+ this._name = name;
70
+ break;
71
+ }
72
+ if (this._name.length > 3 && this._name.slice(-3) === "...") {
73
+ this.variadic = true;
74
+ this._name = this._name.slice(0, -3);
75
+ }
76
+ }
77
+ name() {
78
+ return this._name;
79
+ }
80
+ _concatValue(value, previous) {
81
+ if (previous === this.defaultValue || !Array.isArray(previous)) {
82
+ return [value];
83
+ }
84
+ return previous.concat(value);
85
+ }
86
+ default(value, description) {
87
+ this.defaultValue = value;
88
+ this.defaultValueDescription = description;
89
+ return this;
90
+ }
91
+ argParser(fn) {
92
+ this.parseArg = fn;
93
+ return this;
94
+ }
95
+ choices(values) {
96
+ this.argChoices = values.slice();
97
+ this.parseArg = (arg, previous) => {
98
+ if (!this.argChoices.includes(arg)) {
99
+ throw new InvalidArgumentError(`Allowed choices are ${this.argChoices.join(", ")}.`);
100
+ }
101
+ if (this.variadic) {
102
+ return this._concatValue(arg, previous);
103
+ }
104
+ return arg;
105
+ };
106
+ return this;
107
+ }
108
+ argRequired() {
109
+ this.required = true;
110
+ return this;
111
+ }
112
+ argOptional() {
113
+ this.required = false;
114
+ return this;
115
+ }
116
+ }
117
+ function humanReadableArgName(arg) {
118
+ const nameOutput = arg.name() + (arg.variadic === true ? "..." : "");
119
+ return arg.required ? "<" + nameOutput + ">" : "[" + nameOutput + "]";
120
+ }
121
+ exports.Argument = Argument;
122
+ exports.humanReadableArgName = humanReadableArgName;
123
+ });
124
+
125
+ // node_modules/commander/lib/help.js
126
+ var require_help = __commonJS((exports) => {
127
+ var { humanReadableArgName } = require_argument();
128
+
129
+ class Help {
130
+ constructor() {
131
+ this.helpWidth = undefined;
132
+ this.minWidthToWrap = 40;
133
+ this.sortSubcommands = false;
134
+ this.sortOptions = false;
135
+ this.showGlobalOptions = false;
136
+ }
137
+ prepareContext(contextOptions) {
138
+ this.helpWidth = this.helpWidth ?? contextOptions.helpWidth ?? 80;
139
+ }
140
+ visibleCommands(cmd) {
141
+ const visibleCommands = cmd.commands.filter((cmd2) => !cmd2._hidden);
142
+ const helpCommand = cmd._getHelpCommand();
143
+ if (helpCommand && !helpCommand._hidden) {
144
+ visibleCommands.push(helpCommand);
145
+ }
146
+ if (this.sortSubcommands) {
147
+ visibleCommands.sort((a, b) => {
148
+ return a.name().localeCompare(b.name());
149
+ });
150
+ }
151
+ return visibleCommands;
152
+ }
153
+ compareOptions(a, b) {
154
+ const getSortKey = (option) => {
155
+ return option.short ? option.short.replace(/^-/, "") : option.long.replace(/^--/, "");
156
+ };
157
+ return getSortKey(a).localeCompare(getSortKey(b));
158
+ }
159
+ visibleOptions(cmd) {
160
+ const visibleOptions = cmd.options.filter((option) => !option.hidden);
161
+ const helpOption = cmd._getHelpOption();
162
+ if (helpOption && !helpOption.hidden) {
163
+ const removeShort = helpOption.short && cmd._findOption(helpOption.short);
164
+ const removeLong = helpOption.long && cmd._findOption(helpOption.long);
165
+ if (!removeShort && !removeLong) {
166
+ visibleOptions.push(helpOption);
167
+ } else if (helpOption.long && !removeLong) {
168
+ visibleOptions.push(cmd.createOption(helpOption.long, helpOption.description));
169
+ } else if (helpOption.short && !removeShort) {
170
+ visibleOptions.push(cmd.createOption(helpOption.short, helpOption.description));
171
+ }
172
+ }
173
+ if (this.sortOptions) {
174
+ visibleOptions.sort(this.compareOptions);
175
+ }
176
+ return visibleOptions;
177
+ }
178
+ visibleGlobalOptions(cmd) {
179
+ if (!this.showGlobalOptions)
180
+ return [];
181
+ const globalOptions = [];
182
+ for (let ancestorCmd = cmd.parent;ancestorCmd; ancestorCmd = ancestorCmd.parent) {
183
+ const visibleOptions = ancestorCmd.options.filter((option) => !option.hidden);
184
+ globalOptions.push(...visibleOptions);
185
+ }
186
+ if (this.sortOptions) {
187
+ globalOptions.sort(this.compareOptions);
188
+ }
189
+ return globalOptions;
190
+ }
191
+ visibleArguments(cmd) {
192
+ if (cmd._argsDescription) {
193
+ cmd.registeredArguments.forEach((argument) => {
194
+ argument.description = argument.description || cmd._argsDescription[argument.name()] || "";
195
+ });
196
+ }
197
+ if (cmd.registeredArguments.find((argument) => argument.description)) {
198
+ return cmd.registeredArguments;
199
+ }
200
+ return [];
201
+ }
202
+ subcommandTerm(cmd) {
203
+ const args = cmd.registeredArguments.map((arg) => humanReadableArgName(arg)).join(" ");
204
+ return cmd._name + (cmd._aliases[0] ? "|" + cmd._aliases[0] : "") + (cmd.options.length ? " [options]" : "") + (args ? " " + args : "");
205
+ }
206
+ optionTerm(option) {
207
+ return option.flags;
208
+ }
209
+ argumentTerm(argument) {
210
+ return argument.name();
211
+ }
212
+ longestSubcommandTermLength(cmd, helper) {
213
+ return helper.visibleCommands(cmd).reduce((max, command) => {
214
+ return Math.max(max, this.displayWidth(helper.styleSubcommandTerm(helper.subcommandTerm(command))));
215
+ }, 0);
216
+ }
217
+ longestOptionTermLength(cmd, helper) {
218
+ return helper.visibleOptions(cmd).reduce((max, option) => {
219
+ return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
220
+ }, 0);
221
+ }
222
+ longestGlobalOptionTermLength(cmd, helper) {
223
+ return helper.visibleGlobalOptions(cmd).reduce((max, option) => {
224
+ return Math.max(max, this.displayWidth(helper.styleOptionTerm(helper.optionTerm(option))));
225
+ }, 0);
226
+ }
227
+ longestArgumentTermLength(cmd, helper) {
228
+ return helper.visibleArguments(cmd).reduce((max, argument) => {
229
+ return Math.max(max, this.displayWidth(helper.styleArgumentTerm(helper.argumentTerm(argument))));
230
+ }, 0);
231
+ }
232
+ commandUsage(cmd) {
233
+ let cmdName = cmd._name;
234
+ if (cmd._aliases[0]) {
235
+ cmdName = cmdName + "|" + cmd._aliases[0];
236
+ }
237
+ let ancestorCmdNames = "";
238
+ for (let ancestorCmd = cmd.parent;ancestorCmd; ancestorCmd = ancestorCmd.parent) {
239
+ ancestorCmdNames = ancestorCmd.name() + " " + ancestorCmdNames;
240
+ }
241
+ return ancestorCmdNames + cmdName + " " + cmd.usage();
242
+ }
243
+ commandDescription(cmd) {
244
+ return cmd.description();
245
+ }
246
+ subcommandDescription(cmd) {
247
+ return cmd.summary() || cmd.description();
248
+ }
249
+ optionDescription(option) {
250
+ const extraInfo = [];
251
+ if (option.argChoices) {
252
+ extraInfo.push(`choices: ${option.argChoices.map((choice) => JSON.stringify(choice)).join(", ")}`);
253
+ }
254
+ if (option.defaultValue !== undefined) {
255
+ const showDefault = option.required || option.optional || option.isBoolean() && typeof option.defaultValue === "boolean";
256
+ if (showDefault) {
257
+ extraInfo.push(`default: ${option.defaultValueDescription || JSON.stringify(option.defaultValue)}`);
258
+ }
259
+ }
260
+ if (option.presetArg !== undefined && option.optional) {
261
+ extraInfo.push(`preset: ${JSON.stringify(option.presetArg)}`);
262
+ }
263
+ if (option.envVar !== undefined) {
264
+ extraInfo.push(`env: ${option.envVar}`);
265
+ }
266
+ if (extraInfo.length > 0) {
267
+ return `${option.description} (${extraInfo.join(", ")})`;
268
+ }
269
+ return option.description;
270
+ }
271
+ argumentDescription(argument) {
272
+ const extraInfo = [];
273
+ if (argument.argChoices) {
274
+ extraInfo.push(`choices: ${argument.argChoices.map((choice) => JSON.stringify(choice)).join(", ")}`);
275
+ }
276
+ if (argument.defaultValue !== undefined) {
277
+ extraInfo.push(`default: ${argument.defaultValueDescription || JSON.stringify(argument.defaultValue)}`);
278
+ }
279
+ if (extraInfo.length > 0) {
280
+ const extraDescription = `(${extraInfo.join(", ")})`;
281
+ if (argument.description) {
282
+ return `${argument.description} ${extraDescription}`;
283
+ }
284
+ return extraDescription;
285
+ }
286
+ return argument.description;
287
+ }
288
+ formatHelp(cmd, helper) {
289
+ const termWidth = helper.padWidth(cmd, helper);
290
+ const helpWidth = helper.helpWidth ?? 80;
291
+ function callFormatItem(term, description) {
292
+ return helper.formatItem(term, termWidth, description, helper);
293
+ }
294
+ let output = [
295
+ `${helper.styleTitle("Usage:")} ${helper.styleUsage(helper.commandUsage(cmd))}`,
296
+ ""
297
+ ];
298
+ const commandDescription = helper.commandDescription(cmd);
299
+ if (commandDescription.length > 0) {
300
+ output = output.concat([
301
+ helper.boxWrap(helper.styleCommandDescription(commandDescription), helpWidth),
302
+ ""
303
+ ]);
304
+ }
305
+ const argumentList = helper.visibleArguments(cmd).map((argument) => {
306
+ return callFormatItem(helper.styleArgumentTerm(helper.argumentTerm(argument)), helper.styleArgumentDescription(helper.argumentDescription(argument)));
307
+ });
308
+ if (argumentList.length > 0) {
309
+ output = output.concat([
310
+ helper.styleTitle("Arguments:"),
311
+ ...argumentList,
312
+ ""
313
+ ]);
314
+ }
315
+ const optionList = helper.visibleOptions(cmd).map((option) => {
316
+ return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
317
+ });
318
+ if (optionList.length > 0) {
319
+ output = output.concat([
320
+ helper.styleTitle("Options:"),
321
+ ...optionList,
322
+ ""
323
+ ]);
324
+ }
325
+ if (helper.showGlobalOptions) {
326
+ const globalOptionList = helper.visibleGlobalOptions(cmd).map((option) => {
327
+ return callFormatItem(helper.styleOptionTerm(helper.optionTerm(option)), helper.styleOptionDescription(helper.optionDescription(option)));
328
+ });
329
+ if (globalOptionList.length > 0) {
330
+ output = output.concat([
331
+ helper.styleTitle("Global Options:"),
332
+ ...globalOptionList,
333
+ ""
334
+ ]);
335
+ }
336
+ }
337
+ const commandList = helper.visibleCommands(cmd).map((cmd2) => {
338
+ return callFormatItem(helper.styleSubcommandTerm(helper.subcommandTerm(cmd2)), helper.styleSubcommandDescription(helper.subcommandDescription(cmd2)));
339
+ });
340
+ if (commandList.length > 0) {
341
+ output = output.concat([
342
+ helper.styleTitle("Commands:"),
343
+ ...commandList,
344
+ ""
345
+ ]);
346
+ }
347
+ return output.join(`
348
+ `);
349
+ }
350
+ displayWidth(str) {
351
+ return stripColor(str).length;
352
+ }
353
+ styleTitle(str) {
354
+ return str;
355
+ }
356
+ styleUsage(str) {
357
+ return str.split(" ").map((word) => {
358
+ if (word === "[options]")
359
+ return this.styleOptionText(word);
360
+ if (word === "[command]")
361
+ return this.styleSubcommandText(word);
362
+ if (word[0] === "[" || word[0] === "<")
363
+ return this.styleArgumentText(word);
364
+ return this.styleCommandText(word);
365
+ }).join(" ");
366
+ }
367
+ styleCommandDescription(str) {
368
+ return this.styleDescriptionText(str);
369
+ }
370
+ styleOptionDescription(str) {
371
+ return this.styleDescriptionText(str);
372
+ }
373
+ styleSubcommandDescription(str) {
374
+ return this.styleDescriptionText(str);
375
+ }
376
+ styleArgumentDescription(str) {
377
+ return this.styleDescriptionText(str);
378
+ }
379
+ styleDescriptionText(str) {
380
+ return str;
381
+ }
382
+ styleOptionTerm(str) {
383
+ return this.styleOptionText(str);
384
+ }
385
+ styleSubcommandTerm(str) {
386
+ return str.split(" ").map((word) => {
387
+ if (word === "[options]")
388
+ return this.styleOptionText(word);
389
+ if (word[0] === "[" || word[0] === "<")
390
+ return this.styleArgumentText(word);
391
+ return this.styleSubcommandText(word);
392
+ }).join(" ");
393
+ }
394
+ styleArgumentTerm(str) {
395
+ return this.styleArgumentText(str);
396
+ }
397
+ styleOptionText(str) {
398
+ return str;
399
+ }
400
+ styleArgumentText(str) {
401
+ return str;
402
+ }
403
+ styleSubcommandText(str) {
404
+ return str;
405
+ }
406
+ styleCommandText(str) {
407
+ return str;
408
+ }
409
+ padWidth(cmd, helper) {
410
+ return Math.max(helper.longestOptionTermLength(cmd, helper), helper.longestGlobalOptionTermLength(cmd, helper), helper.longestSubcommandTermLength(cmd, helper), helper.longestArgumentTermLength(cmd, helper));
411
+ }
412
+ preformatted(str) {
413
+ return /\n[^\S\r\n]/.test(str);
414
+ }
415
+ formatItem(term, termWidth, description, helper) {
416
+ const itemIndent = 2;
417
+ const itemIndentStr = " ".repeat(itemIndent);
418
+ if (!description)
419
+ return itemIndentStr + term;
420
+ const paddedTerm = term.padEnd(termWidth + term.length - helper.displayWidth(term));
421
+ const spacerWidth = 2;
422
+ const helpWidth = this.helpWidth ?? 80;
423
+ const remainingWidth = helpWidth - termWidth - spacerWidth - itemIndent;
424
+ let formattedDescription;
425
+ if (remainingWidth < this.minWidthToWrap || helper.preformatted(description)) {
426
+ formattedDescription = description;
427
+ } else {
428
+ const wrappedDescription = helper.boxWrap(description, remainingWidth);
429
+ formattedDescription = wrappedDescription.replace(/\n/g, `
430
+ ` + " ".repeat(termWidth + spacerWidth));
431
+ }
432
+ return itemIndentStr + paddedTerm + " ".repeat(spacerWidth) + formattedDescription.replace(/\n/g, `
433
+ ${itemIndentStr}`);
434
+ }
435
+ boxWrap(str, width) {
436
+ if (width < this.minWidthToWrap)
437
+ return str;
438
+ const rawLines = str.split(/\r\n|\n/);
439
+ const chunkPattern = /[\s]*[^\s]+/g;
440
+ const wrappedLines = [];
441
+ rawLines.forEach((line) => {
442
+ const chunks = line.match(chunkPattern);
443
+ if (chunks === null) {
444
+ wrappedLines.push("");
445
+ return;
446
+ }
447
+ let sumChunks = [chunks.shift()];
448
+ let sumWidth = this.displayWidth(sumChunks[0]);
449
+ chunks.forEach((chunk) => {
450
+ const visibleWidth = this.displayWidth(chunk);
451
+ if (sumWidth + visibleWidth <= width) {
452
+ sumChunks.push(chunk);
453
+ sumWidth += visibleWidth;
454
+ return;
455
+ }
456
+ wrappedLines.push(sumChunks.join(""));
457
+ const nextChunk = chunk.trimStart();
458
+ sumChunks = [nextChunk];
459
+ sumWidth = this.displayWidth(nextChunk);
460
+ });
461
+ wrappedLines.push(sumChunks.join(""));
462
+ });
463
+ return wrappedLines.join(`
464
+ `);
465
+ }
466
+ }
467
+ function stripColor(str) {
468
+ const sgrPattern = /\x1b\[\d*(;\d*)*m/g;
469
+ return str.replace(sgrPattern, "");
470
+ }
471
+ exports.Help = Help;
472
+ exports.stripColor = stripColor;
473
+ });
474
+
475
+ // node_modules/commander/lib/option.js
476
+ var require_option = __commonJS((exports) => {
477
+ var { InvalidArgumentError } = require_error();
478
+
479
+ class Option {
480
+ constructor(flags, description) {
481
+ this.flags = flags;
482
+ this.description = description || "";
483
+ this.required = flags.includes("<");
484
+ this.optional = flags.includes("[");
485
+ this.variadic = /\w\.\.\.[>\]]$/.test(flags);
486
+ this.mandatory = false;
487
+ const optionFlags = splitOptionFlags(flags);
488
+ this.short = optionFlags.shortFlag;
489
+ this.long = optionFlags.longFlag;
490
+ this.negate = false;
491
+ if (this.long) {
492
+ this.negate = this.long.startsWith("--no-");
493
+ }
494
+ this.defaultValue = undefined;
495
+ this.defaultValueDescription = undefined;
496
+ this.presetArg = undefined;
497
+ this.envVar = undefined;
498
+ this.parseArg = undefined;
499
+ this.hidden = false;
500
+ this.argChoices = undefined;
501
+ this.conflictsWith = [];
502
+ this.implied = undefined;
503
+ }
504
+ default(value, description) {
505
+ this.defaultValue = value;
506
+ this.defaultValueDescription = description;
507
+ return this;
508
+ }
509
+ preset(arg) {
510
+ this.presetArg = arg;
511
+ return this;
512
+ }
513
+ conflicts(names) {
514
+ this.conflictsWith = this.conflictsWith.concat(names);
515
+ return this;
516
+ }
517
+ implies(impliedOptionValues) {
518
+ let newImplied = impliedOptionValues;
519
+ if (typeof impliedOptionValues === "string") {
520
+ newImplied = { [impliedOptionValues]: true };
521
+ }
522
+ this.implied = Object.assign(this.implied || {}, newImplied);
523
+ return this;
524
+ }
525
+ env(name) {
526
+ this.envVar = name;
527
+ return this;
528
+ }
529
+ argParser(fn) {
530
+ this.parseArg = fn;
531
+ return this;
532
+ }
533
+ makeOptionMandatory(mandatory = true) {
534
+ this.mandatory = !!mandatory;
535
+ return this;
536
+ }
537
+ hideHelp(hide = true) {
538
+ this.hidden = !!hide;
539
+ return this;
540
+ }
541
+ _concatValue(value, previous) {
542
+ if (previous === this.defaultValue || !Array.isArray(previous)) {
543
+ return [value];
544
+ }
545
+ return previous.concat(value);
546
+ }
547
+ choices(values) {
548
+ this.argChoices = values.slice();
549
+ this.parseArg = (arg, previous) => {
550
+ if (!this.argChoices.includes(arg)) {
551
+ throw new InvalidArgumentError(`Allowed choices are ${this.argChoices.join(", ")}.`);
552
+ }
553
+ if (this.variadic) {
554
+ return this._concatValue(arg, previous);
555
+ }
556
+ return arg;
557
+ };
558
+ return this;
559
+ }
560
+ name() {
561
+ if (this.long) {
562
+ return this.long.replace(/^--/, "");
563
+ }
564
+ return this.short.replace(/^-/, "");
565
+ }
566
+ attributeName() {
567
+ if (this.negate) {
568
+ return camelcase(this.name().replace(/^no-/, ""));
569
+ }
570
+ return camelcase(this.name());
571
+ }
572
+ is(arg) {
573
+ return this.short === arg || this.long === arg;
574
+ }
575
+ isBoolean() {
576
+ return !this.required && !this.optional && !this.negate;
577
+ }
578
+ }
579
+
580
+ class DualOptions {
581
+ constructor(options) {
582
+ this.positiveOptions = new Map;
583
+ this.negativeOptions = new Map;
584
+ this.dualOptions = new Set;
585
+ options.forEach((option) => {
586
+ if (option.negate) {
587
+ this.negativeOptions.set(option.attributeName(), option);
588
+ } else {
589
+ this.positiveOptions.set(option.attributeName(), option);
590
+ }
591
+ });
592
+ this.negativeOptions.forEach((value, key) => {
593
+ if (this.positiveOptions.has(key)) {
594
+ this.dualOptions.add(key);
595
+ }
596
+ });
597
+ }
598
+ valueFromOption(value, option) {
599
+ const optionKey = option.attributeName();
600
+ if (!this.dualOptions.has(optionKey))
601
+ return true;
602
+ const preset = this.negativeOptions.get(optionKey).presetArg;
603
+ const negativeValue = preset !== undefined ? preset : false;
604
+ return option.negate === (negativeValue === value);
605
+ }
606
+ }
607
+ function camelcase(str) {
608
+ return str.split("-").reduce((str2, word) => {
609
+ return str2 + word[0].toUpperCase() + word.slice(1);
610
+ });
611
+ }
612
+ function splitOptionFlags(flags) {
613
+ let shortFlag;
614
+ let longFlag;
615
+ const shortFlagExp = /^-[^-]$/;
616
+ const longFlagExp = /^--[^-]/;
617
+ const flagParts = flags.split(/[ |,]+/).concat("guard");
618
+ if (shortFlagExp.test(flagParts[0]))
619
+ shortFlag = flagParts.shift();
620
+ if (longFlagExp.test(flagParts[0]))
621
+ longFlag = flagParts.shift();
622
+ if (!shortFlag && shortFlagExp.test(flagParts[0]))
623
+ shortFlag = flagParts.shift();
624
+ if (!shortFlag && longFlagExp.test(flagParts[0])) {
625
+ shortFlag = longFlag;
626
+ longFlag = flagParts.shift();
627
+ }
628
+ if (flagParts[0].startsWith("-")) {
629
+ const unsupportedFlag = flagParts[0];
630
+ const baseError = `option creation failed due to '${unsupportedFlag}' in option flags '${flags}'`;
631
+ if (/^-[^-][^-]/.test(unsupportedFlag))
632
+ throw new Error(`${baseError}
633
+ - a short flag is a single dash and a single character
634
+ - either use a single dash and a single character (for a short flag)
635
+ - or use a double dash for a long option (and can have two, like '--ws, --workspace')`);
636
+ if (shortFlagExp.test(unsupportedFlag))
637
+ throw new Error(`${baseError}
638
+ - too many short flags`);
639
+ if (longFlagExp.test(unsupportedFlag))
640
+ throw new Error(`${baseError}
641
+ - too many long flags`);
642
+ throw new Error(`${baseError}
643
+ - unrecognised flag format`);
644
+ }
645
+ if (shortFlag === undefined && longFlag === undefined)
646
+ throw new Error(`option creation failed due to no flags found in '${flags}'.`);
647
+ return { shortFlag, longFlag };
648
+ }
649
+ exports.Option = Option;
650
+ exports.DualOptions = DualOptions;
651
+ });
652
+
653
+ // node_modules/commander/lib/suggestSimilar.js
654
+ var require_suggestSimilar = __commonJS((exports) => {
655
+ var maxDistance = 3;
656
+ function editDistance(a, b) {
657
+ if (Math.abs(a.length - b.length) > maxDistance)
658
+ return Math.max(a.length, b.length);
659
+ const d = [];
660
+ for (let i = 0;i <= a.length; i++) {
661
+ d[i] = [i];
662
+ }
663
+ for (let j = 0;j <= b.length; j++) {
664
+ d[0][j] = j;
665
+ }
666
+ for (let j = 1;j <= b.length; j++) {
667
+ for (let i = 1;i <= a.length; i++) {
668
+ let cost = 1;
669
+ if (a[i - 1] === b[j - 1]) {
670
+ cost = 0;
671
+ } else {
672
+ cost = 1;
673
+ }
674
+ d[i][j] = Math.min(d[i - 1][j] + 1, d[i][j - 1] + 1, d[i - 1][j - 1] + cost);
675
+ if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
676
+ d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
677
+ }
678
+ }
679
+ }
680
+ return d[a.length][b.length];
681
+ }
682
+ function suggestSimilar(word, candidates) {
683
+ if (!candidates || candidates.length === 0)
684
+ return "";
685
+ candidates = Array.from(new Set(candidates));
686
+ const searchingOptions = word.startsWith("--");
687
+ if (searchingOptions) {
688
+ word = word.slice(2);
689
+ candidates = candidates.map((candidate) => candidate.slice(2));
690
+ }
691
+ let similar = [];
692
+ let bestDistance = maxDistance;
693
+ const minSimilarity = 0.4;
694
+ candidates.forEach((candidate) => {
695
+ if (candidate.length <= 1)
696
+ return;
697
+ const distance = editDistance(word, candidate);
698
+ const length = Math.max(word.length, candidate.length);
699
+ const similarity = (length - distance) / length;
700
+ if (similarity > minSimilarity) {
701
+ if (distance < bestDistance) {
702
+ bestDistance = distance;
703
+ similar = [candidate];
704
+ } else if (distance === bestDistance) {
705
+ similar.push(candidate);
706
+ }
707
+ }
708
+ });
709
+ similar.sort((a, b) => a.localeCompare(b));
710
+ if (searchingOptions) {
711
+ similar = similar.map((candidate) => `--${candidate}`);
712
+ }
713
+ if (similar.length > 1) {
714
+ return `
715
+ (Did you mean one of ${similar.join(", ")}?)`;
716
+ }
717
+ if (similar.length === 1) {
718
+ return `
719
+ (Did you mean ${similar[0]}?)`;
720
+ }
721
+ return "";
722
+ }
723
+ exports.suggestSimilar = suggestSimilar;
724
+ });
725
+
726
+ // node_modules/commander/lib/command.js
727
+ var require_command = __commonJS((exports) => {
728
+ var EventEmitter = __require("events").EventEmitter;
729
+ var childProcess = __require("child_process");
730
+ var path = __require("path");
731
+ var fs = __require("fs");
732
+ var process2 = __require("process");
733
+ var { Argument, humanReadableArgName } = require_argument();
734
+ var { CommanderError } = require_error();
735
+ var { Help, stripColor } = require_help();
736
+ var { Option, DualOptions } = require_option();
737
+ var { suggestSimilar } = require_suggestSimilar();
738
+
739
+ class Command extends EventEmitter {
740
+ constructor(name) {
741
+ super();
742
+ this.commands = [];
743
+ this.options = [];
744
+ this.parent = null;
745
+ this._allowUnknownOption = false;
746
+ this._allowExcessArguments = false;
747
+ this.registeredArguments = [];
748
+ this._args = this.registeredArguments;
749
+ this.args = [];
750
+ this.rawArgs = [];
751
+ this.processedArgs = [];
752
+ this._scriptPath = null;
753
+ this._name = name || "";
754
+ this._optionValues = {};
755
+ this._optionValueSources = {};
756
+ this._storeOptionsAsProperties = false;
757
+ this._actionHandler = null;
758
+ this._executableHandler = false;
759
+ this._executableFile = null;
760
+ this._executableDir = null;
761
+ this._defaultCommandName = null;
762
+ this._exitCallback = null;
763
+ this._aliases = [];
764
+ this._combineFlagAndOptionalValue = true;
765
+ this._description = "";
766
+ this._summary = "";
767
+ this._argsDescription = undefined;
768
+ this._enablePositionalOptions = false;
769
+ this._passThroughOptions = false;
770
+ this._lifeCycleHooks = {};
771
+ this._showHelpAfterError = false;
772
+ this._showSuggestionAfterError = true;
773
+ this._savedState = null;
774
+ this._outputConfiguration = {
775
+ writeOut: (str) => process2.stdout.write(str),
776
+ writeErr: (str) => process2.stderr.write(str),
777
+ outputError: (str, write) => write(str),
778
+ getOutHelpWidth: () => process2.stdout.isTTY ? process2.stdout.columns : undefined,
779
+ getErrHelpWidth: () => process2.stderr.isTTY ? process2.stderr.columns : undefined,
780
+ getOutHasColors: () => useColor() ?? (process2.stdout.isTTY && process2.stdout.hasColors?.()),
781
+ getErrHasColors: () => useColor() ?? (process2.stderr.isTTY && process2.stderr.hasColors?.()),
782
+ stripColor: (str) => stripColor(str)
783
+ };
784
+ this._hidden = false;
785
+ this._helpOption = undefined;
786
+ this._addImplicitHelpCommand = undefined;
787
+ this._helpCommand = undefined;
788
+ this._helpConfiguration = {};
789
+ }
790
+ copyInheritedSettings(sourceCommand) {
791
+ this._outputConfiguration = sourceCommand._outputConfiguration;
792
+ this._helpOption = sourceCommand._helpOption;
793
+ this._helpCommand = sourceCommand._helpCommand;
794
+ this._helpConfiguration = sourceCommand._helpConfiguration;
795
+ this._exitCallback = sourceCommand._exitCallback;
796
+ this._storeOptionsAsProperties = sourceCommand._storeOptionsAsProperties;
797
+ this._combineFlagAndOptionalValue = sourceCommand._combineFlagAndOptionalValue;
798
+ this._allowExcessArguments = sourceCommand._allowExcessArguments;
799
+ this._enablePositionalOptions = sourceCommand._enablePositionalOptions;
800
+ this._showHelpAfterError = sourceCommand._showHelpAfterError;
801
+ this._showSuggestionAfterError = sourceCommand._showSuggestionAfterError;
802
+ return this;
803
+ }
804
+ _getCommandAndAncestors() {
805
+ const result = [];
806
+ for (let command = this;command; command = command.parent) {
807
+ result.push(command);
808
+ }
809
+ return result;
810
+ }
811
+ command(nameAndArgs, actionOptsOrExecDesc, execOpts) {
812
+ let desc = actionOptsOrExecDesc;
813
+ let opts = execOpts;
814
+ if (typeof desc === "object" && desc !== null) {
815
+ opts = desc;
816
+ desc = null;
817
+ }
818
+ opts = opts || {};
819
+ const [, name, args] = nameAndArgs.match(/([^ ]+) *(.*)/);
820
+ const cmd = this.createCommand(name);
821
+ if (desc) {
822
+ cmd.description(desc);
823
+ cmd._executableHandler = true;
824
+ }
825
+ if (opts.isDefault)
826
+ this._defaultCommandName = cmd._name;
827
+ cmd._hidden = !!(opts.noHelp || opts.hidden);
828
+ cmd._executableFile = opts.executableFile || null;
829
+ if (args)
830
+ cmd.arguments(args);
831
+ this._registerCommand(cmd);
832
+ cmd.parent = this;
833
+ cmd.copyInheritedSettings(this);
834
+ if (desc)
835
+ return this;
836
+ return cmd;
837
+ }
838
+ createCommand(name) {
839
+ return new Command(name);
840
+ }
841
+ createHelp() {
842
+ return Object.assign(new Help, this.configureHelp());
843
+ }
844
+ configureHelp(configuration) {
845
+ if (configuration === undefined)
846
+ return this._helpConfiguration;
847
+ this._helpConfiguration = configuration;
848
+ return this;
849
+ }
850
+ configureOutput(configuration) {
851
+ if (configuration === undefined)
852
+ return this._outputConfiguration;
853
+ Object.assign(this._outputConfiguration, configuration);
854
+ return this;
855
+ }
856
+ showHelpAfterError(displayHelp = true) {
857
+ if (typeof displayHelp !== "string")
858
+ displayHelp = !!displayHelp;
859
+ this._showHelpAfterError = displayHelp;
860
+ return this;
861
+ }
862
+ showSuggestionAfterError(displaySuggestion = true) {
863
+ this._showSuggestionAfterError = !!displaySuggestion;
864
+ return this;
865
+ }
866
+ addCommand(cmd, opts) {
867
+ if (!cmd._name) {
868
+ throw new Error(`Command passed to .addCommand() must have a name
869
+ - specify the name in Command constructor or using .name()`);
870
+ }
871
+ opts = opts || {};
872
+ if (opts.isDefault)
873
+ this._defaultCommandName = cmd._name;
874
+ if (opts.noHelp || opts.hidden)
875
+ cmd._hidden = true;
876
+ this._registerCommand(cmd);
877
+ cmd.parent = this;
878
+ cmd._checkForBrokenPassThrough();
879
+ return this;
880
+ }
881
+ createArgument(name, description) {
882
+ return new Argument(name, description);
883
+ }
884
+ argument(name, description, fn, defaultValue) {
885
+ const argument = this.createArgument(name, description);
886
+ if (typeof fn === "function") {
887
+ argument.default(defaultValue).argParser(fn);
888
+ } else {
889
+ argument.default(fn);
890
+ }
891
+ this.addArgument(argument);
892
+ return this;
893
+ }
894
+ arguments(names) {
895
+ names.trim().split(/ +/).forEach((detail) => {
896
+ this.argument(detail);
897
+ });
898
+ return this;
899
+ }
900
+ addArgument(argument) {
901
+ const previousArgument = this.registeredArguments.slice(-1)[0];
902
+ if (previousArgument && previousArgument.variadic) {
903
+ throw new Error(`only the last argument can be variadic '${previousArgument.name()}'`);
904
+ }
905
+ if (argument.required && argument.defaultValue !== undefined && argument.parseArg === undefined) {
906
+ throw new Error(`a default value for a required argument is never used: '${argument.name()}'`);
907
+ }
908
+ this.registeredArguments.push(argument);
909
+ return this;
910
+ }
911
+ helpCommand(enableOrNameAndArgs, description) {
912
+ if (typeof enableOrNameAndArgs === "boolean") {
913
+ this._addImplicitHelpCommand = enableOrNameAndArgs;
914
+ return this;
915
+ }
916
+ enableOrNameAndArgs = enableOrNameAndArgs ?? "help [command]";
917
+ const [, helpName, helpArgs] = enableOrNameAndArgs.match(/([^ ]+) *(.*)/);
918
+ const helpDescription = description ?? "display help for command";
919
+ const helpCommand = this.createCommand(helpName);
920
+ helpCommand.helpOption(false);
921
+ if (helpArgs)
922
+ helpCommand.arguments(helpArgs);
923
+ if (helpDescription)
924
+ helpCommand.description(helpDescription);
925
+ this._addImplicitHelpCommand = true;
926
+ this._helpCommand = helpCommand;
927
+ return this;
928
+ }
929
+ addHelpCommand(helpCommand, deprecatedDescription) {
930
+ if (typeof helpCommand !== "object") {
931
+ this.helpCommand(helpCommand, deprecatedDescription);
932
+ return this;
933
+ }
934
+ this._addImplicitHelpCommand = true;
935
+ this._helpCommand = helpCommand;
936
+ return this;
937
+ }
938
+ _getHelpCommand() {
939
+ const hasImplicitHelpCommand = this._addImplicitHelpCommand ?? (this.commands.length && !this._actionHandler && !this._findCommand("help"));
940
+ if (hasImplicitHelpCommand) {
941
+ if (this._helpCommand === undefined) {
942
+ this.helpCommand(undefined, undefined);
943
+ }
944
+ return this._helpCommand;
945
+ }
946
+ return null;
947
+ }
948
+ hook(event, listener) {
949
+ const allowedValues = ["preSubcommand", "preAction", "postAction"];
950
+ if (!allowedValues.includes(event)) {
951
+ throw new Error(`Unexpected value for event passed to hook : '${event}'.
952
+ Expecting one of '${allowedValues.join("', '")}'`);
953
+ }
954
+ if (this._lifeCycleHooks[event]) {
955
+ this._lifeCycleHooks[event].push(listener);
956
+ } else {
957
+ this._lifeCycleHooks[event] = [listener];
958
+ }
959
+ return this;
960
+ }
961
+ exitOverride(fn) {
962
+ if (fn) {
963
+ this._exitCallback = fn;
964
+ } else {
965
+ this._exitCallback = (err) => {
966
+ if (err.code !== "commander.executeSubCommandAsync") {
967
+ throw err;
968
+ } else {}
969
+ };
970
+ }
971
+ return this;
972
+ }
973
+ _exit(exitCode, code, message) {
974
+ if (this._exitCallback) {
975
+ this._exitCallback(new CommanderError(exitCode, code, message));
976
+ }
977
+ process2.exit(exitCode);
978
+ }
979
+ action(fn) {
980
+ const listener = (args) => {
981
+ const expectedArgsCount = this.registeredArguments.length;
982
+ const actionArgs = args.slice(0, expectedArgsCount);
983
+ if (this._storeOptionsAsProperties) {
984
+ actionArgs[expectedArgsCount] = this;
985
+ } else {
986
+ actionArgs[expectedArgsCount] = this.opts();
987
+ }
988
+ actionArgs.push(this);
989
+ return fn.apply(this, actionArgs);
990
+ };
991
+ this._actionHandler = listener;
992
+ return this;
993
+ }
994
+ createOption(flags, description) {
995
+ return new Option(flags, description);
996
+ }
997
+ _callParseArg(target, value, previous, invalidArgumentMessage) {
998
+ try {
999
+ return target.parseArg(value, previous);
1000
+ } catch (err) {
1001
+ if (err.code === "commander.invalidArgument") {
1002
+ const message = `${invalidArgumentMessage} ${err.message}`;
1003
+ this.error(message, { exitCode: err.exitCode, code: err.code });
1004
+ }
1005
+ throw err;
1006
+ }
1007
+ }
1008
+ _registerOption(option) {
1009
+ const matchingOption = option.short && this._findOption(option.short) || option.long && this._findOption(option.long);
1010
+ if (matchingOption) {
1011
+ const matchingFlag = option.long && this._findOption(option.long) ? option.long : option.short;
1012
+ throw new Error(`Cannot add option '${option.flags}'${this._name && ` to command '${this._name}'`} due to conflicting flag '${matchingFlag}'
1013
+ - already used by option '${matchingOption.flags}'`);
1014
+ }
1015
+ this.options.push(option);
1016
+ }
1017
+ _registerCommand(command) {
1018
+ const knownBy = (cmd) => {
1019
+ return [cmd.name()].concat(cmd.aliases());
1020
+ };
1021
+ const alreadyUsed = knownBy(command).find((name) => this._findCommand(name));
1022
+ if (alreadyUsed) {
1023
+ const existingCmd = knownBy(this._findCommand(alreadyUsed)).join("|");
1024
+ const newCmd = knownBy(command).join("|");
1025
+ throw new Error(`cannot add command '${newCmd}' as already have command '${existingCmd}'`);
1026
+ }
1027
+ this.commands.push(command);
1028
+ }
1029
+ addOption(option) {
1030
+ this._registerOption(option);
1031
+ const oname = option.name();
1032
+ const name = option.attributeName();
1033
+ if (option.negate) {
1034
+ const positiveLongFlag = option.long.replace(/^--no-/, "--");
1035
+ if (!this._findOption(positiveLongFlag)) {
1036
+ this.setOptionValueWithSource(name, option.defaultValue === undefined ? true : option.defaultValue, "default");
1037
+ }
1038
+ } else if (option.defaultValue !== undefined) {
1039
+ this.setOptionValueWithSource(name, option.defaultValue, "default");
1040
+ }
1041
+ const handleOptionValue = (val, invalidValueMessage, valueSource) => {
1042
+ if (val == null && option.presetArg !== undefined) {
1043
+ val = option.presetArg;
1044
+ }
1045
+ const oldValue = this.getOptionValue(name);
1046
+ if (val !== null && option.parseArg) {
1047
+ val = this._callParseArg(option, val, oldValue, invalidValueMessage);
1048
+ } else if (val !== null && option.variadic) {
1049
+ val = option._concatValue(val, oldValue);
1050
+ }
1051
+ if (val == null) {
1052
+ if (option.negate) {
1053
+ val = false;
1054
+ } else if (option.isBoolean() || option.optional) {
1055
+ val = true;
1056
+ } else {
1057
+ val = "";
1058
+ }
1059
+ }
1060
+ this.setOptionValueWithSource(name, val, valueSource);
1061
+ };
1062
+ this.on("option:" + oname, (val) => {
1063
+ const invalidValueMessage = `error: option '${option.flags}' argument '${val}' is invalid.`;
1064
+ handleOptionValue(val, invalidValueMessage, "cli");
1065
+ });
1066
+ if (option.envVar) {
1067
+ this.on("optionEnv:" + oname, (val) => {
1068
+ const invalidValueMessage = `error: option '${option.flags}' value '${val}' from env '${option.envVar}' is invalid.`;
1069
+ handleOptionValue(val, invalidValueMessage, "env");
1070
+ });
1071
+ }
1072
+ return this;
1073
+ }
1074
+ _optionEx(config, flags, description, fn, defaultValue) {
1075
+ if (typeof flags === "object" && flags instanceof Option) {
1076
+ throw new Error("To add an Option object use addOption() instead of option() or requiredOption()");
1077
+ }
1078
+ const option = this.createOption(flags, description);
1079
+ option.makeOptionMandatory(!!config.mandatory);
1080
+ if (typeof fn === "function") {
1081
+ option.default(defaultValue).argParser(fn);
1082
+ } else if (fn instanceof RegExp) {
1083
+ const regex = fn;
1084
+ fn = (val, def) => {
1085
+ const m = regex.exec(val);
1086
+ return m ? m[0] : def;
1087
+ };
1088
+ option.default(defaultValue).argParser(fn);
1089
+ } else {
1090
+ option.default(fn);
1091
+ }
1092
+ return this.addOption(option);
1093
+ }
1094
+ option(flags, description, parseArg, defaultValue) {
1095
+ return this._optionEx({}, flags, description, parseArg, defaultValue);
1096
+ }
1097
+ requiredOption(flags, description, parseArg, defaultValue) {
1098
+ return this._optionEx({ mandatory: true }, flags, description, parseArg, defaultValue);
1099
+ }
1100
+ combineFlagAndOptionalValue(combine = true) {
1101
+ this._combineFlagAndOptionalValue = !!combine;
1102
+ return this;
1103
+ }
1104
+ allowUnknownOption(allowUnknown = true) {
1105
+ this._allowUnknownOption = !!allowUnknown;
1106
+ return this;
1107
+ }
1108
+ allowExcessArguments(allowExcess = true) {
1109
+ this._allowExcessArguments = !!allowExcess;
1110
+ return this;
1111
+ }
1112
+ enablePositionalOptions(positional = true) {
1113
+ this._enablePositionalOptions = !!positional;
1114
+ return this;
1115
+ }
1116
+ passThroughOptions(passThrough = true) {
1117
+ this._passThroughOptions = !!passThrough;
1118
+ this._checkForBrokenPassThrough();
1119
+ return this;
1120
+ }
1121
+ _checkForBrokenPassThrough() {
1122
+ if (this.parent && this._passThroughOptions && !this.parent._enablePositionalOptions) {
1123
+ throw new Error(`passThroughOptions cannot be used for '${this._name}' without turning on enablePositionalOptions for parent command(s)`);
1124
+ }
1125
+ }
1126
+ storeOptionsAsProperties(storeAsProperties = true) {
1127
+ if (this.options.length) {
1128
+ throw new Error("call .storeOptionsAsProperties() before adding options");
1129
+ }
1130
+ if (Object.keys(this._optionValues).length) {
1131
+ throw new Error("call .storeOptionsAsProperties() before setting option values");
1132
+ }
1133
+ this._storeOptionsAsProperties = !!storeAsProperties;
1134
+ return this;
1135
+ }
1136
+ getOptionValue(key) {
1137
+ if (this._storeOptionsAsProperties) {
1138
+ return this[key];
1139
+ }
1140
+ return this._optionValues[key];
1141
+ }
1142
+ setOptionValue(key, value) {
1143
+ return this.setOptionValueWithSource(key, value, undefined);
1144
+ }
1145
+ setOptionValueWithSource(key, value, source) {
1146
+ if (this._storeOptionsAsProperties) {
1147
+ this[key] = value;
1148
+ } else {
1149
+ this._optionValues[key] = value;
1150
+ }
1151
+ this._optionValueSources[key] = source;
1152
+ return this;
1153
+ }
1154
+ getOptionValueSource(key) {
1155
+ return this._optionValueSources[key];
1156
+ }
1157
+ getOptionValueSourceWithGlobals(key) {
1158
+ let source;
1159
+ this._getCommandAndAncestors().forEach((cmd) => {
1160
+ if (cmd.getOptionValueSource(key) !== undefined) {
1161
+ source = cmd.getOptionValueSource(key);
1162
+ }
1163
+ });
1164
+ return source;
1165
+ }
1166
+ _prepareUserArgs(argv, parseOptions) {
1167
+ if (argv !== undefined && !Array.isArray(argv)) {
1168
+ throw new Error("first parameter to parse must be array or undefined");
1169
+ }
1170
+ parseOptions = parseOptions || {};
1171
+ if (argv === undefined && parseOptions.from === undefined) {
1172
+ if (process2.versions?.electron) {
1173
+ parseOptions.from = "electron";
1174
+ }
1175
+ const execArgv = process2.execArgv ?? [];
1176
+ if (execArgv.includes("-e") || execArgv.includes("--eval") || execArgv.includes("-p") || execArgv.includes("--print")) {
1177
+ parseOptions.from = "eval";
1178
+ }
1179
+ }
1180
+ if (argv === undefined) {
1181
+ argv = process2.argv;
1182
+ }
1183
+ this.rawArgs = argv.slice();
1184
+ let userArgs;
1185
+ switch (parseOptions.from) {
1186
+ case undefined:
1187
+ case "node":
1188
+ this._scriptPath = argv[1];
1189
+ userArgs = argv.slice(2);
1190
+ break;
1191
+ case "electron":
1192
+ if (process2.defaultApp) {
1193
+ this._scriptPath = argv[1];
1194
+ userArgs = argv.slice(2);
1195
+ } else {
1196
+ userArgs = argv.slice(1);
1197
+ }
1198
+ break;
1199
+ case "user":
1200
+ userArgs = argv.slice(0);
1201
+ break;
1202
+ case "eval":
1203
+ userArgs = argv.slice(1);
1204
+ break;
1205
+ default:
1206
+ throw new Error(`unexpected parse option { from: '${parseOptions.from}' }`);
1207
+ }
1208
+ if (!this._name && this._scriptPath)
1209
+ this.nameFromFilename(this._scriptPath);
1210
+ this._name = this._name || "program";
1211
+ return userArgs;
1212
+ }
1213
+ parse(argv, parseOptions) {
1214
+ this._prepareForParse();
1215
+ const userArgs = this._prepareUserArgs(argv, parseOptions);
1216
+ this._parseCommand([], userArgs);
1217
+ return this;
1218
+ }
1219
+ async parseAsync(argv, parseOptions) {
1220
+ this._prepareForParse();
1221
+ const userArgs = this._prepareUserArgs(argv, parseOptions);
1222
+ await this._parseCommand([], userArgs);
1223
+ return this;
1224
+ }
1225
+ _prepareForParse() {
1226
+ if (this._savedState === null) {
1227
+ this.saveStateBeforeParse();
1228
+ } else {
1229
+ this.restoreStateBeforeParse();
1230
+ }
1231
+ }
1232
+ saveStateBeforeParse() {
1233
+ this._savedState = {
1234
+ _name: this._name,
1235
+ _optionValues: { ...this._optionValues },
1236
+ _optionValueSources: { ...this._optionValueSources }
1237
+ };
1238
+ }
1239
+ restoreStateBeforeParse() {
1240
+ if (this._storeOptionsAsProperties)
1241
+ throw new Error(`Can not call parse again when storeOptionsAsProperties is true.
1242
+ - either make a new Command for each call to parse, or stop storing options as properties`);
1243
+ this._name = this._savedState._name;
1244
+ this._scriptPath = null;
1245
+ this.rawArgs = [];
1246
+ this._optionValues = { ...this._savedState._optionValues };
1247
+ this._optionValueSources = { ...this._savedState._optionValueSources };
1248
+ this.args = [];
1249
+ this.processedArgs = [];
1250
+ }
1251
+ _checkForMissingExecutable(executableFile, executableDir, subcommandName) {
1252
+ if (fs.existsSync(executableFile))
1253
+ return;
1254
+ const executableDirMessage = executableDir ? `searched for local subcommand relative to directory '${executableDir}'` : "no directory for search for local subcommand, use .executableDir() to supply a custom directory";
1255
+ const executableMissing = `'${executableFile}' does not exist
1256
+ - if '${subcommandName}' is not meant to be an executable command, remove description parameter from '.command()' and use '.description()' instead
1257
+ - if the default executable name is not suitable, use the executableFile option to supply a custom name or path
1258
+ - ${executableDirMessage}`;
1259
+ throw new Error(executableMissing);
1260
+ }
1261
+ _executeSubCommand(subcommand, args) {
1262
+ args = args.slice();
1263
+ let launchWithNode = false;
1264
+ const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
1265
+ function findFile(baseDir, baseName) {
1266
+ const localBin = path.resolve(baseDir, baseName);
1267
+ if (fs.existsSync(localBin))
1268
+ return localBin;
1269
+ if (sourceExt.includes(path.extname(baseName)))
1270
+ return;
1271
+ const foundExt = sourceExt.find((ext) => fs.existsSync(`${localBin}${ext}`));
1272
+ if (foundExt)
1273
+ return `${localBin}${foundExt}`;
1274
+ return;
1275
+ }
1276
+ this._checkForMissingMandatoryOptions();
1277
+ this._checkForConflictingOptions();
1278
+ let executableFile = subcommand._executableFile || `${this._name}-${subcommand._name}`;
1279
+ let executableDir = this._executableDir || "";
1280
+ if (this._scriptPath) {
1281
+ let resolvedScriptPath;
1282
+ try {
1283
+ resolvedScriptPath = fs.realpathSync(this._scriptPath);
1284
+ } catch {
1285
+ resolvedScriptPath = this._scriptPath;
1286
+ }
1287
+ executableDir = path.resolve(path.dirname(resolvedScriptPath), executableDir);
1288
+ }
1289
+ if (executableDir) {
1290
+ let localFile = findFile(executableDir, executableFile);
1291
+ if (!localFile && !subcommand._executableFile && this._scriptPath) {
1292
+ const legacyName = path.basename(this._scriptPath, path.extname(this._scriptPath));
1293
+ if (legacyName !== this._name) {
1294
+ localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
1295
+ }
1296
+ }
1297
+ executableFile = localFile || executableFile;
1298
+ }
1299
+ launchWithNode = sourceExt.includes(path.extname(executableFile));
1300
+ let proc;
1301
+ if (process2.platform !== "win32") {
1302
+ if (launchWithNode) {
1303
+ args.unshift(executableFile);
1304
+ args = incrementNodeInspectorPort(process2.execArgv).concat(args);
1305
+ proc = childProcess.spawn(process2.argv[0], args, { stdio: "inherit" });
1306
+ } else {
1307
+ proc = childProcess.spawn(executableFile, args, { stdio: "inherit" });
1308
+ }
1309
+ } else {
1310
+ this._checkForMissingExecutable(executableFile, executableDir, subcommand._name);
1311
+ args.unshift(executableFile);
1312
+ args = incrementNodeInspectorPort(process2.execArgv).concat(args);
1313
+ proc = childProcess.spawn(process2.execPath, args, { stdio: "inherit" });
1314
+ }
1315
+ if (!proc.killed) {
1316
+ const signals = ["SIGUSR1", "SIGUSR2", "SIGTERM", "SIGINT", "SIGHUP"];
1317
+ signals.forEach((signal) => {
1318
+ process2.on(signal, () => {
1319
+ if (proc.killed === false && proc.exitCode === null) {
1320
+ proc.kill(signal);
1321
+ }
1322
+ });
1323
+ });
1324
+ }
1325
+ const exitCallback = this._exitCallback;
1326
+ proc.on("close", (code) => {
1327
+ code = code ?? 1;
1328
+ if (!exitCallback) {
1329
+ process2.exit(code);
1330
+ } else {
1331
+ exitCallback(new CommanderError(code, "commander.executeSubCommandAsync", "(close)"));
1332
+ }
1333
+ });
1334
+ proc.on("error", (err) => {
1335
+ if (err.code === "ENOENT") {
1336
+ this._checkForMissingExecutable(executableFile, executableDir, subcommand._name);
1337
+ } else if (err.code === "EACCES") {
1338
+ throw new Error(`'${executableFile}' not executable`);
1339
+ }
1340
+ if (!exitCallback) {
1341
+ process2.exit(1);
1342
+ } else {
1343
+ const wrappedError = new CommanderError(1, "commander.executeSubCommandAsync", "(error)");
1344
+ wrappedError.nestedError = err;
1345
+ exitCallback(wrappedError);
1346
+ }
1347
+ });
1348
+ this.runningCommand = proc;
1349
+ }
1350
+ _dispatchSubcommand(commandName, operands, unknown) {
1351
+ const subCommand = this._findCommand(commandName);
1352
+ if (!subCommand)
1353
+ this.help({ error: true });
1354
+ subCommand._prepareForParse();
1355
+ let promiseChain;
1356
+ promiseChain = this._chainOrCallSubCommandHook(promiseChain, subCommand, "preSubcommand");
1357
+ promiseChain = this._chainOrCall(promiseChain, () => {
1358
+ if (subCommand._executableHandler) {
1359
+ this._executeSubCommand(subCommand, operands.concat(unknown));
1360
+ } else {
1361
+ return subCommand._parseCommand(operands, unknown);
1362
+ }
1363
+ });
1364
+ return promiseChain;
1365
+ }
1366
+ _dispatchHelpCommand(subcommandName) {
1367
+ if (!subcommandName) {
1368
+ this.help();
1369
+ }
1370
+ const subCommand = this._findCommand(subcommandName);
1371
+ if (subCommand && !subCommand._executableHandler) {
1372
+ subCommand.help();
1373
+ }
1374
+ return this._dispatchSubcommand(subcommandName, [], [this._getHelpOption()?.long ?? this._getHelpOption()?.short ?? "--help"]);
1375
+ }
1376
+ _checkNumberOfArguments() {
1377
+ this.registeredArguments.forEach((arg, i) => {
1378
+ if (arg.required && this.args[i] == null) {
1379
+ this.missingArgument(arg.name());
1380
+ }
1381
+ });
1382
+ if (this.registeredArguments.length > 0 && this.registeredArguments[this.registeredArguments.length - 1].variadic) {
1383
+ return;
1384
+ }
1385
+ if (this.args.length > this.registeredArguments.length) {
1386
+ this._excessArguments(this.args);
1387
+ }
1388
+ }
1389
+ _processArguments() {
1390
+ const myParseArg = (argument, value, previous) => {
1391
+ let parsedValue = value;
1392
+ if (value !== null && argument.parseArg) {
1393
+ const invalidValueMessage = `error: command-argument value '${value}' is invalid for argument '${argument.name()}'.`;
1394
+ parsedValue = this._callParseArg(argument, value, previous, invalidValueMessage);
1395
+ }
1396
+ return parsedValue;
1397
+ };
1398
+ this._checkNumberOfArguments();
1399
+ const processedArgs = [];
1400
+ this.registeredArguments.forEach((declaredArg, index) => {
1401
+ let value = declaredArg.defaultValue;
1402
+ if (declaredArg.variadic) {
1403
+ if (index < this.args.length) {
1404
+ value = this.args.slice(index);
1405
+ if (declaredArg.parseArg) {
1406
+ value = value.reduce((processed, v) => {
1407
+ return myParseArg(declaredArg, v, processed);
1408
+ }, declaredArg.defaultValue);
1409
+ }
1410
+ } else if (value === undefined) {
1411
+ value = [];
1412
+ }
1413
+ } else if (index < this.args.length) {
1414
+ value = this.args[index];
1415
+ if (declaredArg.parseArg) {
1416
+ value = myParseArg(declaredArg, value, declaredArg.defaultValue);
1417
+ }
1418
+ }
1419
+ processedArgs[index] = value;
1420
+ });
1421
+ this.processedArgs = processedArgs;
1422
+ }
1423
+ _chainOrCall(promise, fn) {
1424
+ if (promise && promise.then && typeof promise.then === "function") {
1425
+ return promise.then(() => fn());
1426
+ }
1427
+ return fn();
1428
+ }
1429
+ _chainOrCallHooks(promise, event) {
1430
+ let result = promise;
1431
+ const hooks = [];
1432
+ this._getCommandAndAncestors().reverse().filter((cmd) => cmd._lifeCycleHooks[event] !== undefined).forEach((hookedCommand) => {
1433
+ hookedCommand._lifeCycleHooks[event].forEach((callback) => {
1434
+ hooks.push({ hookedCommand, callback });
1435
+ });
1436
+ });
1437
+ if (event === "postAction") {
1438
+ hooks.reverse();
1439
+ }
1440
+ hooks.forEach((hookDetail) => {
1441
+ result = this._chainOrCall(result, () => {
1442
+ return hookDetail.callback(hookDetail.hookedCommand, this);
1443
+ });
1444
+ });
1445
+ return result;
1446
+ }
1447
+ _chainOrCallSubCommandHook(promise, subCommand, event) {
1448
+ let result = promise;
1449
+ if (this._lifeCycleHooks[event] !== undefined) {
1450
+ this._lifeCycleHooks[event].forEach((hook) => {
1451
+ result = this._chainOrCall(result, () => {
1452
+ return hook(this, subCommand);
1453
+ });
1454
+ });
1455
+ }
1456
+ return result;
1457
+ }
1458
+ _parseCommand(operands, unknown) {
1459
+ const parsed = this.parseOptions(unknown);
1460
+ this._parseOptionsEnv();
1461
+ this._parseOptionsImplied();
1462
+ operands = operands.concat(parsed.operands);
1463
+ unknown = parsed.unknown;
1464
+ this.args = operands.concat(unknown);
1465
+ if (operands && this._findCommand(operands[0])) {
1466
+ return this._dispatchSubcommand(operands[0], operands.slice(1), unknown);
1467
+ }
1468
+ if (this._getHelpCommand() && operands[0] === this._getHelpCommand().name()) {
1469
+ return this._dispatchHelpCommand(operands[1]);
1470
+ }
1471
+ if (this._defaultCommandName) {
1472
+ this._outputHelpIfRequested(unknown);
1473
+ return this._dispatchSubcommand(this._defaultCommandName, operands, unknown);
1474
+ }
1475
+ if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
1476
+ this.help({ error: true });
1477
+ }
1478
+ this._outputHelpIfRequested(parsed.unknown);
1479
+ this._checkForMissingMandatoryOptions();
1480
+ this._checkForConflictingOptions();
1481
+ const checkForUnknownOptions = () => {
1482
+ if (parsed.unknown.length > 0) {
1483
+ this.unknownOption(parsed.unknown[0]);
1484
+ }
1485
+ };
1486
+ const commandEvent = `command:${this.name()}`;
1487
+ if (this._actionHandler) {
1488
+ checkForUnknownOptions();
1489
+ this._processArguments();
1490
+ let promiseChain;
1491
+ promiseChain = this._chainOrCallHooks(promiseChain, "preAction");
1492
+ promiseChain = this._chainOrCall(promiseChain, () => this._actionHandler(this.processedArgs));
1493
+ if (this.parent) {
1494
+ promiseChain = this._chainOrCall(promiseChain, () => {
1495
+ this.parent.emit(commandEvent, operands, unknown);
1496
+ });
1497
+ }
1498
+ promiseChain = this._chainOrCallHooks(promiseChain, "postAction");
1499
+ return promiseChain;
1500
+ }
1501
+ if (this.parent && this.parent.listenerCount(commandEvent)) {
1502
+ checkForUnknownOptions();
1503
+ this._processArguments();
1504
+ this.parent.emit(commandEvent, operands, unknown);
1505
+ } else if (operands.length) {
1506
+ if (this._findCommand("*")) {
1507
+ return this._dispatchSubcommand("*", operands, unknown);
1508
+ }
1509
+ if (this.listenerCount("command:*")) {
1510
+ this.emit("command:*", operands, unknown);
1511
+ } else if (this.commands.length) {
1512
+ this.unknownCommand();
1513
+ } else {
1514
+ checkForUnknownOptions();
1515
+ this._processArguments();
1516
+ }
1517
+ } else if (this.commands.length) {
1518
+ checkForUnknownOptions();
1519
+ this.help({ error: true });
1520
+ } else {
1521
+ checkForUnknownOptions();
1522
+ this._processArguments();
1523
+ }
1524
+ }
1525
+ _findCommand(name) {
1526
+ if (!name)
1527
+ return;
1528
+ return this.commands.find((cmd) => cmd._name === name || cmd._aliases.includes(name));
1529
+ }
1530
+ _findOption(arg) {
1531
+ return this.options.find((option) => option.is(arg));
1532
+ }
1533
+ _checkForMissingMandatoryOptions() {
1534
+ this._getCommandAndAncestors().forEach((cmd) => {
1535
+ cmd.options.forEach((anOption) => {
1536
+ if (anOption.mandatory && cmd.getOptionValue(anOption.attributeName()) === undefined) {
1537
+ cmd.missingMandatoryOptionValue(anOption);
1538
+ }
1539
+ });
1540
+ });
1541
+ }
1542
+ _checkForConflictingLocalOptions() {
1543
+ const definedNonDefaultOptions = this.options.filter((option) => {
1544
+ const optionKey = option.attributeName();
1545
+ if (this.getOptionValue(optionKey) === undefined) {
1546
+ return false;
1547
+ }
1548
+ return this.getOptionValueSource(optionKey) !== "default";
1549
+ });
1550
+ const optionsWithConflicting = definedNonDefaultOptions.filter((option) => option.conflictsWith.length > 0);
1551
+ optionsWithConflicting.forEach((option) => {
1552
+ const conflictingAndDefined = definedNonDefaultOptions.find((defined) => option.conflictsWith.includes(defined.attributeName()));
1553
+ if (conflictingAndDefined) {
1554
+ this._conflictingOption(option, conflictingAndDefined);
1555
+ }
1556
+ });
1557
+ }
1558
+ _checkForConflictingOptions() {
1559
+ this._getCommandAndAncestors().forEach((cmd) => {
1560
+ cmd._checkForConflictingLocalOptions();
1561
+ });
1562
+ }
1563
+ parseOptions(argv) {
1564
+ const operands = [];
1565
+ const unknown = [];
1566
+ let dest = operands;
1567
+ const args = argv.slice();
1568
+ function maybeOption(arg) {
1569
+ return arg.length > 1 && arg[0] === "-";
1570
+ }
1571
+ let activeVariadicOption = null;
1572
+ while (args.length) {
1573
+ const arg = args.shift();
1574
+ if (arg === "--") {
1575
+ if (dest === unknown)
1576
+ dest.push(arg);
1577
+ dest.push(...args);
1578
+ break;
1579
+ }
1580
+ if (activeVariadicOption && !maybeOption(arg)) {
1581
+ this.emit(`option:${activeVariadicOption.name()}`, arg);
1582
+ continue;
1583
+ }
1584
+ activeVariadicOption = null;
1585
+ if (maybeOption(arg)) {
1586
+ const option = this._findOption(arg);
1587
+ if (option) {
1588
+ if (option.required) {
1589
+ const value = args.shift();
1590
+ if (value === undefined)
1591
+ this.optionMissingArgument(option);
1592
+ this.emit(`option:${option.name()}`, value);
1593
+ } else if (option.optional) {
1594
+ let value = null;
1595
+ if (args.length > 0 && !maybeOption(args[0])) {
1596
+ value = args.shift();
1597
+ }
1598
+ this.emit(`option:${option.name()}`, value);
1599
+ } else {
1600
+ this.emit(`option:${option.name()}`);
1601
+ }
1602
+ activeVariadicOption = option.variadic ? option : null;
1603
+ continue;
1604
+ }
1605
+ }
1606
+ if (arg.length > 2 && arg[0] === "-" && arg[1] !== "-") {
1607
+ const option = this._findOption(`-${arg[1]}`);
1608
+ if (option) {
1609
+ if (option.required || option.optional && this._combineFlagAndOptionalValue) {
1610
+ this.emit(`option:${option.name()}`, arg.slice(2));
1611
+ } else {
1612
+ this.emit(`option:${option.name()}`);
1613
+ args.unshift(`-${arg.slice(2)}`);
1614
+ }
1615
+ continue;
1616
+ }
1617
+ }
1618
+ if (/^--[^=]+=/.test(arg)) {
1619
+ const index = arg.indexOf("=");
1620
+ const option = this._findOption(arg.slice(0, index));
1621
+ if (option && (option.required || option.optional)) {
1622
+ this.emit(`option:${option.name()}`, arg.slice(index + 1));
1623
+ continue;
1624
+ }
1625
+ }
1626
+ if (maybeOption(arg)) {
1627
+ dest = unknown;
1628
+ }
1629
+ if ((this._enablePositionalOptions || this._passThroughOptions) && operands.length === 0 && unknown.length === 0) {
1630
+ if (this._findCommand(arg)) {
1631
+ operands.push(arg);
1632
+ if (args.length > 0)
1633
+ unknown.push(...args);
1634
+ break;
1635
+ } else if (this._getHelpCommand() && arg === this._getHelpCommand().name()) {
1636
+ operands.push(arg);
1637
+ if (args.length > 0)
1638
+ operands.push(...args);
1639
+ break;
1640
+ } else if (this._defaultCommandName) {
1641
+ unknown.push(arg);
1642
+ if (args.length > 0)
1643
+ unknown.push(...args);
1644
+ break;
1645
+ }
1646
+ }
1647
+ if (this._passThroughOptions) {
1648
+ dest.push(arg);
1649
+ if (args.length > 0)
1650
+ dest.push(...args);
1651
+ break;
1652
+ }
1653
+ dest.push(arg);
1654
+ }
1655
+ return { operands, unknown };
1656
+ }
1657
+ opts() {
1658
+ if (this._storeOptionsAsProperties) {
1659
+ const result = {};
1660
+ const len = this.options.length;
1661
+ for (let i = 0;i < len; i++) {
1662
+ const key = this.options[i].attributeName();
1663
+ result[key] = key === this._versionOptionName ? this._version : this[key];
1664
+ }
1665
+ return result;
1666
+ }
1667
+ return this._optionValues;
1668
+ }
1669
+ optsWithGlobals() {
1670
+ return this._getCommandAndAncestors().reduce((combinedOptions, cmd) => Object.assign(combinedOptions, cmd.opts()), {});
1671
+ }
1672
+ error(message, errorOptions) {
1673
+ this._outputConfiguration.outputError(`${message}
1674
+ `, this._outputConfiguration.writeErr);
1675
+ if (typeof this._showHelpAfterError === "string") {
1676
+ this._outputConfiguration.writeErr(`${this._showHelpAfterError}
1677
+ `);
1678
+ } else if (this._showHelpAfterError) {
1679
+ this._outputConfiguration.writeErr(`
1680
+ `);
1681
+ this.outputHelp({ error: true });
1682
+ }
1683
+ const config = errorOptions || {};
1684
+ const exitCode = config.exitCode || 1;
1685
+ const code = config.code || "commander.error";
1686
+ this._exit(exitCode, code, message);
1687
+ }
1688
+ _parseOptionsEnv() {
1689
+ this.options.forEach((option) => {
1690
+ if (option.envVar && option.envVar in process2.env) {
1691
+ const optionKey = option.attributeName();
1692
+ if (this.getOptionValue(optionKey) === undefined || ["default", "config", "env"].includes(this.getOptionValueSource(optionKey))) {
1693
+ if (option.required || option.optional) {
1694
+ this.emit(`optionEnv:${option.name()}`, process2.env[option.envVar]);
1695
+ } else {
1696
+ this.emit(`optionEnv:${option.name()}`);
1697
+ }
1698
+ }
1699
+ }
1700
+ });
1701
+ }
1702
+ _parseOptionsImplied() {
1703
+ const dualHelper = new DualOptions(this.options);
1704
+ const hasCustomOptionValue = (optionKey) => {
1705
+ return this.getOptionValue(optionKey) !== undefined && !["default", "implied"].includes(this.getOptionValueSource(optionKey));
1706
+ };
1707
+ this.options.filter((option) => option.implied !== undefined && hasCustomOptionValue(option.attributeName()) && dualHelper.valueFromOption(this.getOptionValue(option.attributeName()), option)).forEach((option) => {
1708
+ Object.keys(option.implied).filter((impliedKey) => !hasCustomOptionValue(impliedKey)).forEach((impliedKey) => {
1709
+ this.setOptionValueWithSource(impliedKey, option.implied[impliedKey], "implied");
1710
+ });
1711
+ });
1712
+ }
1713
+ missingArgument(name) {
1714
+ const message = `error: missing required argument '${name}'`;
1715
+ this.error(message, { code: "commander.missingArgument" });
1716
+ }
1717
+ optionMissingArgument(option) {
1718
+ const message = `error: option '${option.flags}' argument missing`;
1719
+ this.error(message, { code: "commander.optionMissingArgument" });
1720
+ }
1721
+ missingMandatoryOptionValue(option) {
1722
+ const message = `error: required option '${option.flags}' not specified`;
1723
+ this.error(message, { code: "commander.missingMandatoryOptionValue" });
1724
+ }
1725
+ _conflictingOption(option, conflictingOption) {
1726
+ const findBestOptionFromValue = (option2) => {
1727
+ const optionKey = option2.attributeName();
1728
+ const optionValue = this.getOptionValue(optionKey);
1729
+ const negativeOption = this.options.find((target) => target.negate && optionKey === target.attributeName());
1730
+ const positiveOption = this.options.find((target) => !target.negate && optionKey === target.attributeName());
1731
+ if (negativeOption && (negativeOption.presetArg === undefined && optionValue === false || negativeOption.presetArg !== undefined && optionValue === negativeOption.presetArg)) {
1732
+ return negativeOption;
1733
+ }
1734
+ return positiveOption || option2;
1735
+ };
1736
+ const getErrorMessage = (option2) => {
1737
+ const bestOption = findBestOptionFromValue(option2);
1738
+ const optionKey = bestOption.attributeName();
1739
+ const source = this.getOptionValueSource(optionKey);
1740
+ if (source === "env") {
1741
+ return `environment variable '${bestOption.envVar}'`;
1742
+ }
1743
+ return `option '${bestOption.flags}'`;
1744
+ };
1745
+ const message = `error: ${getErrorMessage(option)} cannot be used with ${getErrorMessage(conflictingOption)}`;
1746
+ this.error(message, { code: "commander.conflictingOption" });
1747
+ }
1748
+ unknownOption(flag) {
1749
+ if (this._allowUnknownOption)
1750
+ return;
1751
+ let suggestion = "";
1752
+ if (flag.startsWith("--") && this._showSuggestionAfterError) {
1753
+ let candidateFlags = [];
1754
+ let command = this;
1755
+ do {
1756
+ const moreFlags = command.createHelp().visibleOptions(command).filter((option) => option.long).map((option) => option.long);
1757
+ candidateFlags = candidateFlags.concat(moreFlags);
1758
+ command = command.parent;
1759
+ } while (command && !command._enablePositionalOptions);
1760
+ suggestion = suggestSimilar(flag, candidateFlags);
1761
+ }
1762
+ const message = `error: unknown option '${flag}'${suggestion}`;
1763
+ this.error(message, { code: "commander.unknownOption" });
1764
+ }
1765
+ _excessArguments(receivedArgs) {
1766
+ if (this._allowExcessArguments)
1767
+ return;
1768
+ const expected = this.registeredArguments.length;
1769
+ const s = expected === 1 ? "" : "s";
1770
+ const forSubcommand = this.parent ? ` for '${this.name()}'` : "";
1771
+ const message = `error: too many arguments${forSubcommand}. Expected ${expected} argument${s} but got ${receivedArgs.length}.`;
1772
+ this.error(message, { code: "commander.excessArguments" });
1773
+ }
1774
+ unknownCommand() {
1775
+ const unknownName = this.args[0];
1776
+ let suggestion = "";
1777
+ if (this._showSuggestionAfterError) {
1778
+ const candidateNames = [];
1779
+ this.createHelp().visibleCommands(this).forEach((command) => {
1780
+ candidateNames.push(command.name());
1781
+ if (command.alias())
1782
+ candidateNames.push(command.alias());
1783
+ });
1784
+ suggestion = suggestSimilar(unknownName, candidateNames);
1785
+ }
1786
+ const message = `error: unknown command '${unknownName}'${suggestion}`;
1787
+ this.error(message, { code: "commander.unknownCommand" });
1788
+ }
1789
+ version(str, flags, description) {
1790
+ if (str === undefined)
1791
+ return this._version;
1792
+ this._version = str;
1793
+ flags = flags || "-V, --version";
1794
+ description = description || "output the version number";
1795
+ const versionOption = this.createOption(flags, description);
1796
+ this._versionOptionName = versionOption.attributeName();
1797
+ this._registerOption(versionOption);
1798
+ this.on("option:" + versionOption.name(), () => {
1799
+ this._outputConfiguration.writeOut(`${str}
1800
+ `);
1801
+ this._exit(0, "commander.version", str);
1802
+ });
1803
+ return this;
1804
+ }
1805
+ description(str, argsDescription) {
1806
+ if (str === undefined && argsDescription === undefined)
1807
+ return this._description;
1808
+ this._description = str;
1809
+ if (argsDescription) {
1810
+ this._argsDescription = argsDescription;
1811
+ }
1812
+ return this;
1813
+ }
1814
+ summary(str) {
1815
+ if (str === undefined)
1816
+ return this._summary;
1817
+ this._summary = str;
1818
+ return this;
1819
+ }
1820
+ alias(alias) {
1821
+ if (alias === undefined)
1822
+ return this._aliases[0];
1823
+ let command = this;
1824
+ if (this.commands.length !== 0 && this.commands[this.commands.length - 1]._executableHandler) {
1825
+ command = this.commands[this.commands.length - 1];
1826
+ }
1827
+ if (alias === command._name)
1828
+ throw new Error("Command alias can't be the same as its name");
1829
+ const matchingCommand = this.parent?._findCommand(alias);
1830
+ if (matchingCommand) {
1831
+ const existingCmd = [matchingCommand.name()].concat(matchingCommand.aliases()).join("|");
1832
+ throw new Error(`cannot add alias '${alias}' to command '${this.name()}' as already have command '${existingCmd}'`);
1833
+ }
1834
+ command._aliases.push(alias);
1835
+ return this;
1836
+ }
1837
+ aliases(aliases) {
1838
+ if (aliases === undefined)
1839
+ return this._aliases;
1840
+ aliases.forEach((alias) => this.alias(alias));
1841
+ return this;
1842
+ }
1843
+ usage(str) {
1844
+ if (str === undefined) {
1845
+ if (this._usage)
1846
+ return this._usage;
1847
+ const args = this.registeredArguments.map((arg) => {
1848
+ return humanReadableArgName(arg);
1849
+ });
1850
+ return [].concat(this.options.length || this._helpOption !== null ? "[options]" : [], this.commands.length ? "[command]" : [], this.registeredArguments.length ? args : []).join(" ");
1851
+ }
1852
+ this._usage = str;
1853
+ return this;
1854
+ }
1855
+ name(str) {
1856
+ if (str === undefined)
1857
+ return this._name;
1858
+ this._name = str;
1859
+ return this;
1860
+ }
1861
+ nameFromFilename(filename) {
1862
+ this._name = path.basename(filename, path.extname(filename));
1863
+ return this;
1864
+ }
1865
+ executableDir(path2) {
1866
+ if (path2 === undefined)
1867
+ return this._executableDir;
1868
+ this._executableDir = path2;
1869
+ return this;
1870
+ }
1871
+ helpInformation(contextOptions) {
1872
+ const helper = this.createHelp();
1873
+ const context = this._getOutputContext(contextOptions);
1874
+ helper.prepareContext({
1875
+ error: context.error,
1876
+ helpWidth: context.helpWidth,
1877
+ outputHasColors: context.hasColors
1878
+ });
1879
+ const text = helper.formatHelp(this, helper);
1880
+ if (context.hasColors)
1881
+ return text;
1882
+ return this._outputConfiguration.stripColor(text);
1883
+ }
1884
+ _getOutputContext(contextOptions) {
1885
+ contextOptions = contextOptions || {};
1886
+ const error = !!contextOptions.error;
1887
+ let baseWrite;
1888
+ let hasColors;
1889
+ let helpWidth;
1890
+ if (error) {
1891
+ baseWrite = (str) => this._outputConfiguration.writeErr(str);
1892
+ hasColors = this._outputConfiguration.getErrHasColors();
1893
+ helpWidth = this._outputConfiguration.getErrHelpWidth();
1894
+ } else {
1895
+ baseWrite = (str) => this._outputConfiguration.writeOut(str);
1896
+ hasColors = this._outputConfiguration.getOutHasColors();
1897
+ helpWidth = this._outputConfiguration.getOutHelpWidth();
1898
+ }
1899
+ const write = (str) => {
1900
+ if (!hasColors)
1901
+ str = this._outputConfiguration.stripColor(str);
1902
+ return baseWrite(str);
1903
+ };
1904
+ return { error, write, hasColors, helpWidth };
1905
+ }
1906
+ outputHelp(contextOptions) {
1907
+ let deprecatedCallback;
1908
+ if (typeof contextOptions === "function") {
1909
+ deprecatedCallback = contextOptions;
1910
+ contextOptions = undefined;
1911
+ }
1912
+ const outputContext = this._getOutputContext(contextOptions);
1913
+ const eventContext = {
1914
+ error: outputContext.error,
1915
+ write: outputContext.write,
1916
+ command: this
1917
+ };
1918
+ this._getCommandAndAncestors().reverse().forEach((command) => command.emit("beforeAllHelp", eventContext));
1919
+ this.emit("beforeHelp", eventContext);
1920
+ let helpInformation = this.helpInformation({ error: outputContext.error });
1921
+ if (deprecatedCallback) {
1922
+ helpInformation = deprecatedCallback(helpInformation);
1923
+ if (typeof helpInformation !== "string" && !Buffer.isBuffer(helpInformation)) {
1924
+ throw new Error("outputHelp callback must return a string or a Buffer");
1925
+ }
1926
+ }
1927
+ outputContext.write(helpInformation);
1928
+ if (this._getHelpOption()?.long) {
1929
+ this.emit(this._getHelpOption().long);
1930
+ }
1931
+ this.emit("afterHelp", eventContext);
1932
+ this._getCommandAndAncestors().forEach((command) => command.emit("afterAllHelp", eventContext));
1933
+ }
1934
+ helpOption(flags, description) {
1935
+ if (typeof flags === "boolean") {
1936
+ if (flags) {
1937
+ this._helpOption = this._helpOption ?? undefined;
1938
+ } else {
1939
+ this._helpOption = null;
1940
+ }
1941
+ return this;
1942
+ }
1943
+ flags = flags ?? "-h, --help";
1944
+ description = description ?? "display help for command";
1945
+ this._helpOption = this.createOption(flags, description);
1946
+ return this;
1947
+ }
1948
+ _getHelpOption() {
1949
+ if (this._helpOption === undefined) {
1950
+ this.helpOption(undefined, undefined);
1951
+ }
1952
+ return this._helpOption;
1953
+ }
1954
+ addHelpOption(option) {
1955
+ this._helpOption = option;
1956
+ return this;
1957
+ }
1958
+ help(contextOptions) {
1959
+ this.outputHelp(contextOptions);
1960
+ let exitCode = Number(process2.exitCode ?? 0);
1961
+ if (exitCode === 0 && contextOptions && typeof contextOptions !== "function" && contextOptions.error) {
1962
+ exitCode = 1;
1963
+ }
1964
+ this._exit(exitCode, "commander.help", "(outputHelp)");
1965
+ }
1966
+ addHelpText(position, text) {
1967
+ const allowedValues = ["beforeAll", "before", "after", "afterAll"];
1968
+ if (!allowedValues.includes(position)) {
1969
+ throw new Error(`Unexpected value for position to addHelpText.
1970
+ Expecting one of '${allowedValues.join("', '")}'`);
1971
+ }
1972
+ const helpEvent = `${position}Help`;
1973
+ this.on(helpEvent, (context) => {
1974
+ let helpStr;
1975
+ if (typeof text === "function") {
1976
+ helpStr = text({ error: context.error, command: context.command });
1977
+ } else {
1978
+ helpStr = text;
1979
+ }
1980
+ if (helpStr) {
1981
+ context.write(`${helpStr}
1982
+ `);
1983
+ }
1984
+ });
1985
+ return this;
1986
+ }
1987
+ _outputHelpIfRequested(args) {
1988
+ const helpOption = this._getHelpOption();
1989
+ const helpRequested = helpOption && args.find((arg) => helpOption.is(arg));
1990
+ if (helpRequested) {
1991
+ this.outputHelp();
1992
+ this._exit(0, "commander.helpDisplayed", "(outputHelp)");
1993
+ }
1994
+ }
1995
+ }
1996
+ function incrementNodeInspectorPort(args) {
1997
+ return args.map((arg) => {
1998
+ if (!arg.startsWith("--inspect")) {
1999
+ return arg;
2000
+ }
2001
+ let debugOption;
2002
+ let debugHost = "127.0.0.1";
2003
+ let debugPort = "9229";
2004
+ let match;
2005
+ if ((match = arg.match(/^(--inspect(-brk)?)$/)) !== null) {
2006
+ debugOption = match[1];
2007
+ } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+)$/)) !== null) {
2008
+ debugOption = match[1];
2009
+ if (/^\d+$/.test(match[3])) {
2010
+ debugPort = match[3];
2011
+ } else {
2012
+ debugHost = match[3];
2013
+ }
2014
+ } else if ((match = arg.match(/^(--inspect(-brk|-port)?)=([^:]+):(\d+)$/)) !== null) {
2015
+ debugOption = match[1];
2016
+ debugHost = match[3];
2017
+ debugPort = match[4];
2018
+ }
2019
+ if (debugOption && debugPort !== "0") {
2020
+ return `${debugOption}=${debugHost}:${parseInt(debugPort) + 1}`;
2021
+ }
2022
+ return arg;
2023
+ });
2024
+ }
2025
+ function useColor() {
2026
+ if (process2.env.NO_COLOR || process2.env.FORCE_COLOR === "0" || process2.env.FORCE_COLOR === "false")
2027
+ return false;
2028
+ if (process2.env.FORCE_COLOR || process2.env.CLICOLOR_FORCE !== undefined)
2029
+ return true;
2030
+ return;
2031
+ }
2032
+ exports.Command = Command;
2033
+ exports.useColor = useColor;
2034
+ });
2035
+
2036
+ // node_modules/commander/index.js
2037
+ var require_commander = __commonJS((exports) => {
2038
+ var { Argument } = require_argument();
2039
+ var { Command } = require_command();
2040
+ var { CommanderError, InvalidArgumentError } = require_error();
2041
+ var { Help } = require_help();
2042
+ var { Option } = require_option();
2043
+ exports.program = new Command;
2044
+ exports.createCommand = (name) => new Command(name);
2045
+ exports.createOption = (flags, description) => new Option(flags, description);
2046
+ exports.createArgument = (name, description) => new Argument(name, description);
2047
+ exports.Command = Command;
2048
+ exports.Option = Option;
2049
+ exports.Argument = Argument;
2050
+ exports.Help = Help;
2051
+ exports.CommanderError = CommanderError;
2052
+ exports.InvalidArgumentError = InvalidArgumentError;
2053
+ exports.InvalidOptionArgumentError = InvalidArgumentError;
2054
+ });
2055
+
2056
+ // node_modules/commander/esm.mjs
2057
+ var import__ = __toESM(require_commander(), 1);
2058
+ var {
2059
+ program,
2060
+ createCommand,
2061
+ createArgument,
2062
+ createOption,
2063
+ CommanderError,
2064
+ InvalidArgumentError,
2065
+ InvalidOptionArgumentError,
2066
+ Command,
2067
+ Argument,
2068
+ Option,
2069
+ Help
2070
+ } = import__.default;
2071
+
2072
+ // src/cli/index.tsx
2073
+ import chalk from "chalk";
2074
+ import { existsSync as existsSync6, readFileSync as readFileSync4 } from "fs";
2075
+ import { homedir as homedir3 } from "os";
2076
+ import { join as join5, resolve as resolve6 } from "path";
2077
+
2078
+ // src/types/index.ts
2079
+ class ConfigNotFoundError extends Error {
2080
+ constructor(id) {
2081
+ super(`Config not found: ${id}`);
2082
+ this.name = "ConfigNotFoundError";
2083
+ }
2084
+ }
2085
+
2086
+ class ProfileNotFoundError extends Error {
2087
+ constructor(id) {
2088
+ super(`Profile not found: ${id}`);
2089
+ this.name = "ProfileNotFoundError";
2090
+ }
2091
+ }
2092
+
2093
+ class ConfigApplyError extends Error {
2094
+ constructor(message) {
2095
+ super(message);
2096
+ this.name = "ConfigApplyError";
2097
+ }
2098
+ }
2099
+
2100
+ // src/db/database.ts
2101
+ import { Database } from "bun:sqlite";
2102
+ import { existsSync, mkdirSync } from "fs";
2103
+ import { dirname, join, resolve } from "path";
2104
+ import { randomUUID } from "crypto";
2105
+ function getDbPath() {
2106
+ if (process.env["CONFIGS_DB_PATH"]) {
2107
+ return process.env["CONFIGS_DB_PATH"];
2108
+ }
2109
+ const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
2110
+ return join(home, ".configs", "configs.db");
2111
+ }
2112
+ function ensureDir(filePath) {
2113
+ if (filePath === ":memory:" || filePath.startsWith("file::memory:"))
2114
+ return;
2115
+ const dir = dirname(resolve(filePath));
2116
+ if (!existsSync(dir)) {
2117
+ mkdirSync(dir, { recursive: true });
2118
+ }
2119
+ }
2120
+ function uuid() {
2121
+ return randomUUID();
2122
+ }
2123
+ function now() {
2124
+ return new Date().toISOString();
2125
+ }
2126
+ function slugify(name) {
2127
+ return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
2128
+ }
2129
+ var MIGRATIONS = [
2130
+ `
2131
+ CREATE TABLE IF NOT EXISTS configs (
2132
+ id TEXT PRIMARY KEY,
2133
+ name TEXT NOT NULL,
2134
+ slug TEXT NOT NULL UNIQUE,
2135
+ kind TEXT NOT NULL DEFAULT 'file',
2136
+ category TEXT NOT NULL,
2137
+ agent TEXT NOT NULL DEFAULT 'global',
2138
+ target_path TEXT,
2139
+ format TEXT NOT NULL DEFAULT 'text',
2140
+ content TEXT NOT NULL DEFAULT '',
2141
+ description TEXT,
2142
+ tags TEXT NOT NULL DEFAULT '[]',
2143
+ is_template INTEGER NOT NULL DEFAULT 0,
2144
+ version INTEGER NOT NULL DEFAULT 1,
2145
+ created_at TEXT NOT NULL,
2146
+ updated_at TEXT NOT NULL,
2147
+ synced_at TEXT
2148
+ );
2149
+
2150
+ CREATE TABLE IF NOT EXISTS config_snapshots (
2151
+ id TEXT PRIMARY KEY,
2152
+ config_id TEXT NOT NULL REFERENCES configs(id) ON DELETE CASCADE,
2153
+ content TEXT NOT NULL,
2154
+ version INTEGER NOT NULL,
2155
+ created_at TEXT NOT NULL
2156
+ );
2157
+
2158
+ CREATE TABLE IF NOT EXISTS profiles (
2159
+ id TEXT PRIMARY KEY,
2160
+ name TEXT NOT NULL,
2161
+ slug TEXT NOT NULL UNIQUE,
2162
+ description TEXT,
2163
+ created_at TEXT NOT NULL,
2164
+ updated_at TEXT NOT NULL
2165
+ );
2166
+
2167
+ CREATE TABLE IF NOT EXISTS profile_configs (
2168
+ profile_id TEXT NOT NULL REFERENCES profiles(id) ON DELETE CASCADE,
2169
+ config_id TEXT NOT NULL REFERENCES configs(id) ON DELETE CASCADE,
2170
+ sort_order INTEGER NOT NULL DEFAULT 0,
2171
+ PRIMARY KEY (profile_id, config_id)
2172
+ );
2173
+
2174
+ CREATE TABLE IF NOT EXISTS machines (
2175
+ id TEXT PRIMARY KEY,
2176
+ hostname TEXT NOT NULL UNIQUE,
2177
+ os TEXT,
2178
+ last_applied_at TEXT,
2179
+ created_at TEXT NOT NULL
2180
+ );
2181
+
2182
+ CREATE TABLE IF NOT EXISTS schema_version (
2183
+ version INTEGER PRIMARY KEY
2184
+ );
2185
+
2186
+ INSERT OR IGNORE INTO schema_version (version) VALUES (1);
2187
+ `
2188
+ ];
2189
+ var _db = null;
2190
+ function getDatabase(path) {
2191
+ if (_db)
2192
+ return _db;
2193
+ const dbPath = path || getDbPath();
2194
+ ensureDir(dbPath);
2195
+ const db = new Database(dbPath);
2196
+ db.run("PRAGMA journal_mode = WAL");
2197
+ db.run("PRAGMA foreign_keys = ON");
2198
+ applyMigrations(db);
2199
+ _db = db;
2200
+ return db;
2201
+ }
2202
+ function applyMigrations(db) {
2203
+ let currentVersion = 0;
2204
+ try {
2205
+ const row = db.query("SELECT version FROM schema_version ORDER BY version DESC LIMIT 1").get();
2206
+ currentVersion = row?.version ?? 0;
2207
+ } catch {
2208
+ currentVersion = 0;
2209
+ }
2210
+ for (let i = currentVersion;i < MIGRATIONS.length; i++) {
2211
+ db.run(MIGRATIONS[i]);
2212
+ db.run(`INSERT OR REPLACE INTO schema_version (version) VALUES (${i + 1})`);
2213
+ }
2214
+ }
2215
+
2216
+ // src/db/configs.ts
2217
+ function rowToConfig(row) {
2218
+ return {
2219
+ ...row,
2220
+ tags: JSON.parse(row.tags || "[]"),
2221
+ is_template: !!row.is_template,
2222
+ kind: row.kind,
2223
+ category: row.category,
2224
+ agent: row.agent,
2225
+ format: row.format
2226
+ };
2227
+ }
2228
+ function uniqueSlug(name, db, excludeId) {
2229
+ const base = slugify(name);
2230
+ let slug = base;
2231
+ let i = 1;
2232
+ while (true) {
2233
+ const existing = db.query("SELECT id FROM configs WHERE slug = ?").get(slug);
2234
+ if (!existing || existing.id === excludeId)
2235
+ return slug;
2236
+ slug = `${base}-${i++}`;
2237
+ }
2238
+ }
2239
+ function createConfig(input, db) {
2240
+ const d = db || getDatabase();
2241
+ const id = uuid();
2242
+ const ts = now();
2243
+ const slug = uniqueSlug(input.name, d);
2244
+ const tags = JSON.stringify(input.tags || []);
2245
+ d.run(`INSERT INTO configs (id, name, slug, kind, category, agent, target_path, format, content, description, tags, is_template, version, created_at, updated_at, synced_at)
2246
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, NULL)`, [
2247
+ id,
2248
+ input.name,
2249
+ slug,
2250
+ input.kind ?? "file",
2251
+ input.category,
2252
+ input.agent ?? "global",
2253
+ input.target_path ?? null,
2254
+ input.format ?? "text",
2255
+ input.content,
2256
+ input.description ?? null,
2257
+ tags,
2258
+ input.is_template ? 1 : 0,
2259
+ ts,
2260
+ ts
2261
+ ]);
2262
+ return getConfig(id, d);
2263
+ }
2264
+ function getConfig(idOrSlug, db) {
2265
+ const d = db || getDatabase();
2266
+ const row = d.query("SELECT * FROM configs WHERE id = ? OR slug = ?").get(idOrSlug, idOrSlug);
2267
+ if (!row)
2268
+ throw new ConfigNotFoundError(idOrSlug);
2269
+ return rowToConfig(row);
2270
+ }
2271
+ function getConfigById(id, db) {
2272
+ const d = db || getDatabase();
2273
+ const row = d.query("SELECT * FROM configs WHERE id = ?").get(id);
2274
+ if (!row)
2275
+ throw new ConfigNotFoundError(id);
2276
+ return rowToConfig(row);
2277
+ }
2278
+ function listConfigs(filter, db) {
2279
+ const d = db || getDatabase();
2280
+ const conditions = [];
2281
+ const params = [];
2282
+ if (filter?.category) {
2283
+ conditions.push("category = ?");
2284
+ params.push(filter.category);
2285
+ }
2286
+ if (filter?.agent) {
2287
+ conditions.push("agent = ?");
2288
+ params.push(filter.agent);
2289
+ }
2290
+ if (filter?.kind) {
2291
+ conditions.push("kind = ?");
2292
+ params.push(filter.kind);
2293
+ }
2294
+ if (filter?.is_template !== undefined) {
2295
+ conditions.push("is_template = ?");
2296
+ params.push(filter.is_template ? 1 : 0);
2297
+ }
2298
+ if (filter?.search) {
2299
+ conditions.push("(name LIKE ? OR description LIKE ? OR content LIKE ?)");
2300
+ const q = `%${filter.search}%`;
2301
+ params.push(q, q, q);
2302
+ }
2303
+ if (filter?.tags && filter.tags.length > 0) {
2304
+ const tagConditions = filter.tags.map(() => "tags LIKE ?").join(" OR ");
2305
+ conditions.push(`(${tagConditions})`);
2306
+ for (const tag of filter.tags)
2307
+ params.push(`%"${tag}"%`);
2308
+ }
2309
+ const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
2310
+ const rows = d.query(`SELECT * FROM configs ${where} ORDER BY category, name`).all(...params);
2311
+ return rows.map(rowToConfig);
2312
+ }
2313
+ function updateConfig(idOrSlug, input, db) {
2314
+ const d = db || getDatabase();
2315
+ const existing = getConfig(idOrSlug, d);
2316
+ const ts = now();
2317
+ const updates = ["updated_at = ?", "version = version + 1"];
2318
+ const params = [ts];
2319
+ if (input.name !== undefined) {
2320
+ updates.push("name = ?", "slug = ?");
2321
+ params.push(input.name, uniqueSlug(input.name, d, existing.id));
2322
+ }
2323
+ if (input.kind !== undefined) {
2324
+ updates.push("kind = ?");
2325
+ params.push(input.kind);
2326
+ }
2327
+ if (input.category !== undefined) {
2328
+ updates.push("category = ?");
2329
+ params.push(input.category);
2330
+ }
2331
+ if (input.agent !== undefined) {
2332
+ updates.push("agent = ?");
2333
+ params.push(input.agent);
2334
+ }
2335
+ if (input.target_path !== undefined) {
2336
+ updates.push("target_path = ?");
2337
+ params.push(input.target_path);
2338
+ }
2339
+ if (input.format !== undefined) {
2340
+ updates.push("format = ?");
2341
+ params.push(input.format);
2342
+ }
2343
+ if (input.content !== undefined) {
2344
+ updates.push("content = ?");
2345
+ params.push(input.content);
2346
+ }
2347
+ if (input.description !== undefined) {
2348
+ updates.push("description = ?");
2349
+ params.push(input.description);
2350
+ }
2351
+ if (input.tags !== undefined) {
2352
+ updates.push("tags = ?");
2353
+ params.push(JSON.stringify(input.tags));
2354
+ }
2355
+ if (input.is_template !== undefined) {
2356
+ updates.push("is_template = ?");
2357
+ params.push(input.is_template ? 1 : 0);
2358
+ }
2359
+ if (input.synced_at !== undefined) {
2360
+ updates.push("synced_at = ?");
2361
+ params.push(input.synced_at);
2362
+ }
2363
+ params.push(existing.id);
2364
+ d.run(`UPDATE configs SET ${updates.join(", ")} WHERE id = ?`, params);
2365
+ return getConfigById(existing.id, d);
2366
+ }
2367
+ function getConfigStats(db) {
2368
+ const d = db || getDatabase();
2369
+ const rows = d.query("SELECT category, COUNT(*) as count FROM configs GROUP BY category").all();
2370
+ const stats = { total: 0 };
2371
+ for (const row of rows) {
2372
+ stats[row.category] = row.count;
2373
+ stats["total"] = (stats["total"] || 0) + row.count;
2374
+ }
2375
+ return stats;
2376
+ }
2377
+
2378
+ // src/db/profiles.ts
2379
+ function rowToProfile(row) {
2380
+ return { ...row };
2381
+ }
2382
+ function uniqueProfileSlug(name, db, excludeId) {
2383
+ const base = slugify(name);
2384
+ let slug = base;
2385
+ let i = 1;
2386
+ while (true) {
2387
+ const existing = db.query("SELECT id FROM profiles WHERE slug = ?").get(slug);
2388
+ if (!existing || existing.id === excludeId)
2389
+ return slug;
2390
+ slug = `${base}-${i++}`;
2391
+ }
2392
+ }
2393
+ function createProfile(input, db) {
2394
+ const d = db || getDatabase();
2395
+ const id = uuid();
2396
+ const ts = now();
2397
+ const slug = uniqueProfileSlug(input.name, d);
2398
+ d.run("INSERT INTO profiles (id, name, slug, description, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)", [id, input.name, slug, input.description ?? null, ts, ts]);
2399
+ return getProfile(id, d);
2400
+ }
2401
+ function getProfile(idOrSlug, db) {
2402
+ const d = db || getDatabase();
2403
+ const row = d.query("SELECT * FROM profiles WHERE id = ? OR slug = ?").get(idOrSlug, idOrSlug);
2404
+ if (!row)
2405
+ throw new ProfileNotFoundError(idOrSlug);
2406
+ return rowToProfile(row);
2407
+ }
2408
+ function listProfiles(db) {
2409
+ const d = db || getDatabase();
2410
+ return d.query("SELECT * FROM profiles ORDER BY name").all().map(rowToProfile);
2411
+ }
2412
+ function deleteProfile(idOrSlug, db) {
2413
+ const d = db || getDatabase();
2414
+ const existing = getProfile(idOrSlug, d);
2415
+ d.run("DELETE FROM profiles WHERE id = ?", [existing.id]);
2416
+ }
2417
+ function addConfigToProfile(profileIdOrSlug, configId, db) {
2418
+ const d = db || getDatabase();
2419
+ const profile = getProfile(profileIdOrSlug, d);
2420
+ const maxRow = d.query("SELECT MAX(sort_order) as max_order FROM profile_configs WHERE profile_id = ?").get(profile.id);
2421
+ const order = (maxRow?.max_order ?? -1) + 1;
2422
+ d.run("INSERT OR IGNORE INTO profile_configs (profile_id, config_id, sort_order) VALUES (?, ?, ?)", [profile.id, configId, order]);
2423
+ }
2424
+ function removeConfigFromProfile(profileIdOrSlug, configId, db) {
2425
+ const d = db || getDatabase();
2426
+ const profile = getProfile(profileIdOrSlug, d);
2427
+ d.run("DELETE FROM profile_configs WHERE profile_id = ? AND config_id = ?", [profile.id, configId]);
2428
+ }
2429
+ function getProfileConfigs(profileIdOrSlug, db) {
2430
+ const d = db || getDatabase();
2431
+ const profile = getProfile(profileIdOrSlug, d);
2432
+ const rows = d.query("SELECT config_id FROM profile_configs WHERE profile_id = ? ORDER BY sort_order").all(profile.id);
2433
+ if (rows.length === 0)
2434
+ return [];
2435
+ const ids = rows.map((r) => r.config_id);
2436
+ return listConfigs(undefined, d).filter((c) => ids.includes(c.id));
2437
+ }
2438
+
2439
+ // src/db/snapshots.ts
2440
+ function createSnapshot(configId, content, version, db) {
2441
+ const d = db || getDatabase();
2442
+ const id = uuid();
2443
+ const ts = now();
2444
+ d.run("INSERT INTO config_snapshots (id, config_id, content, version, created_at) VALUES (?, ?, ?, ?, ?)", [id, configId, content, version, ts]);
2445
+ return { id, config_id: configId, content, version, created_at: ts };
2446
+ }
2447
+ function listSnapshots(configId, db) {
2448
+ const d = db || getDatabase();
2449
+ return d.query("SELECT * FROM config_snapshots WHERE config_id = ? ORDER BY version DESC").all(configId);
2450
+ }
2451
+ function getSnapshot(id, db) {
2452
+ const d = db || getDatabase();
2453
+ return d.query("SELECT * FROM config_snapshots WHERE id = ?").get(id);
2454
+ }
2455
+
2456
+ // src/lib/apply.ts
2457
+ import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync } from "fs";
2458
+ import { dirname as dirname2, resolve as resolve2 } from "path";
2459
+ import { homedir } from "os";
2460
+ function expandPath(p) {
2461
+ if (p.startsWith("~/")) {
2462
+ return resolve2(homedir(), p.slice(2));
2463
+ }
2464
+ return resolve2(p);
2465
+ }
2466
+ async function applyConfig(config, opts = {}) {
2467
+ if (!config.target_path) {
2468
+ throw new ConfigApplyError(`Config "${config.name}" is a reference (kind=reference) and has no target_path \u2014 cannot apply to disk.`);
2469
+ }
2470
+ const path = expandPath(config.target_path);
2471
+ const previousContent = existsSync2(path) ? readFileSync(path, "utf-8") : null;
2472
+ const changed = previousContent !== config.content;
2473
+ if (!opts.dryRun) {
2474
+ const dir = dirname2(path);
2475
+ if (!existsSync2(dir)) {
2476
+ mkdirSync2(dir, { recursive: true });
2477
+ }
2478
+ if (previousContent !== null && changed) {
2479
+ const db2 = opts.db || getDatabase();
2480
+ createSnapshot(config.id, previousContent, config.version, db2);
2481
+ }
2482
+ writeFileSync(path, config.content, "utf-8");
2483
+ const db = opts.db || getDatabase();
2484
+ updateConfig(config.id, { synced_at: now() }, db);
2485
+ }
2486
+ return {
2487
+ config_id: config.id,
2488
+ path,
2489
+ previous_content: previousContent,
2490
+ new_content: config.content,
2491
+ dry_run: opts.dryRun ?? false,
2492
+ changed
2493
+ };
2494
+ }
2495
+ async function applyConfigs(configs, opts = {}) {
2496
+ const results = [];
2497
+ for (const config of configs) {
2498
+ if (config.kind === "reference")
2499
+ continue;
2500
+ results.push(await applyConfig(config, opts));
2501
+ }
2502
+ return results;
2503
+ }
2504
+
2505
+ // src/lib/sync.ts
2506
+ import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
2507
+ import { extname, join as join2, relative } from "path";
2508
+ import { homedir as homedir2 } from "os";
2509
+ function detectCategory(filePath) {
2510
+ const p = filePath.toLowerCase().replace(homedir2(), "~");
2511
+ if (p.includes("/.claude/rules/") || p.endsWith("claude.md") || p.endsWith("agents.md") || p.endsWith("gemini.md"))
2512
+ return "rules";
2513
+ if (p.includes("/.claude/") || p.includes("/.codex/") || p.includes("/.gemini/") || p.includes("/.cursor/"))
2514
+ return "agent";
2515
+ if (p.includes(".mcp.json") || p.includes("mcp"))
2516
+ return "mcp";
2517
+ if (p.includes(".zshrc") || p.includes(".zprofile") || p.includes(".bashrc") || p.includes(".bash_profile"))
2518
+ return "shell";
2519
+ if (p.includes(".gitconfig") || p.includes(".gitignore"))
2520
+ return "git";
2521
+ if (p.includes(".npmrc") || p.includes("tsconfig") || p.includes("bunfig"))
2522
+ return "tools";
2523
+ if (p.includes(".secrets"))
2524
+ return "secrets_schema";
2525
+ return "tools";
2526
+ }
2527
+ function detectAgent(filePath) {
2528
+ const p = filePath.toLowerCase().replace(homedir2(), "~");
2529
+ if (p.includes("/.claude/") || p.endsWith("claude.md"))
2530
+ return "claude";
2531
+ if (p.includes("/.codex/") || p.endsWith("agents.md"))
2532
+ return "codex";
2533
+ if (p.includes("/.gemini/") || p.endsWith("gemini.md"))
2534
+ return "gemini";
2535
+ if (p.includes(".zshrc") || p.includes(".zprofile") || p.includes(".bashrc"))
2536
+ return "zsh";
2537
+ if (p.includes(".gitconfig") || p.includes(".gitignore"))
2538
+ return "git";
2539
+ if (p.includes(".npmrc"))
2540
+ return "npm";
2541
+ return "global";
2542
+ }
2543
+ function detectFormat(filePath) {
2544
+ const ext = extname(filePath).toLowerCase();
2545
+ if (ext === ".json")
2546
+ return "json";
2547
+ if (ext === ".toml")
2548
+ return "toml";
2549
+ if (ext === ".yaml" || ext === ".yml")
2550
+ return "yaml";
2551
+ if (ext === ".md" || ext === ".markdown")
2552
+ return "markdown";
2553
+ if (ext === ".ini" || ext === ".cfg")
2554
+ return "ini";
2555
+ return "text";
2556
+ }
2557
+ var SKIP_PATTERNS = [".db", ".db-shm", ".db-wal", ".log", ".lock", ".DS_Store", "node_modules", ".git"];
2558
+ function shouldSkip(p) {
2559
+ return SKIP_PATTERNS.some((pat) => p.includes(pat));
2560
+ }
2561
+ function walkDir(dir, files = []) {
2562
+ const entries = readdirSync(dir, { withFileTypes: true });
2563
+ for (const entry of entries) {
2564
+ const full = join2(dir, entry.name);
2565
+ if (shouldSkip(full))
2566
+ continue;
2567
+ if (entry.isDirectory()) {
2568
+ walkDir(full, files);
2569
+ } else if (entry.isFile()) {
2570
+ files.push(full);
2571
+ }
2572
+ }
2573
+ return files;
2574
+ }
2575
+ async function syncFromDir(dir, opts = {}) {
2576
+ const d = opts.db || getDatabase();
2577
+ const absDir = expandPath(dir);
2578
+ if (!existsSync3(absDir)) {
2579
+ return { added: 0, updated: 0, unchanged: 0, skipped: [`Directory not found: ${absDir}`] };
2580
+ }
2581
+ const files = opts.recursive !== false ? walkDir(absDir) : readdirSync(absDir).map((f) => join2(absDir, f)).filter((f) => statSync(f).isFile());
2582
+ const result = { added: 0, updated: 0, unchanged: 0, skipped: [] };
2583
+ const allConfigs = listConfigs(undefined, d);
2584
+ for (const file of files) {
2585
+ if (shouldSkip(file)) {
2586
+ result.skipped.push(file);
2587
+ continue;
2588
+ }
2589
+ try {
2590
+ const content = readFileSync2(file, "utf-8");
2591
+ const targetPath = file.startsWith(homedir2()) ? file.replace(homedir2(), "~") : file;
2592
+ const existing = allConfigs.find((c) => c.target_path === targetPath);
2593
+ if (!existing) {
2594
+ if (!opts.dryRun) {
2595
+ const name = relative(absDir, file);
2596
+ createConfig({
2597
+ name,
2598
+ category: detectCategory(file),
2599
+ agent: detectAgent(file),
2600
+ target_path: targetPath,
2601
+ format: detectFormat(file),
2602
+ content
2603
+ }, d);
2604
+ }
2605
+ result.added++;
2606
+ } else if (existing.content !== content) {
2607
+ if (!opts.dryRun) {
2608
+ updateConfig(existing.id, { content }, d);
2609
+ }
2610
+ result.updated++;
2611
+ } else {
2612
+ result.unchanged++;
2613
+ }
2614
+ } catch {
2615
+ result.skipped.push(file);
2616
+ }
2617
+ }
2618
+ return result;
2619
+ }
2620
+ async function syncToDir(dir, opts = {}) {
2621
+ const d = opts.db || getDatabase();
2622
+ const absDir = expandPath(dir);
2623
+ const normalizedDir = dir.startsWith("~/") ? dir : absDir.replace(homedir2(), "~");
2624
+ const configs = listConfigs(undefined, d).filter((c) => c.target_path && (c.target_path.startsWith(normalizedDir) || c.target_path.startsWith(absDir)));
2625
+ const result = { added: 0, updated: 0, unchanged: 0, skipped: [] };
2626
+ for (const config of configs) {
2627
+ if (config.kind === "reference")
2628
+ continue;
2629
+ try {
2630
+ const r = await applyConfig(config, { dryRun: opts.dryRun, db: d });
2631
+ if (r.changed) {
2632
+ existsSync3(expandPath(config.target_path)) ? result.updated++ : result.added++;
2633
+ } else {
2634
+ result.unchanged++;
2635
+ }
2636
+ } catch {
2637
+ result.skipped.push(config.target_path || config.id);
2638
+ }
2639
+ }
2640
+ return result;
2641
+ }
2642
+ function diffConfig(config) {
2643
+ if (!config.target_path)
2644
+ return "(reference \u2014 no target path)";
2645
+ const path = expandPath(config.target_path);
2646
+ if (!existsSync3(path))
2647
+ return `(file not found on disk: ${path})`;
2648
+ const diskContent = readFileSync2(path, "utf-8");
2649
+ if (diskContent === config.content)
2650
+ return "(no diff \u2014 identical)";
2651
+ const stored = config.content.split(`
2652
+ `);
2653
+ const disk = diskContent.split(`
2654
+ `);
2655
+ const lines = [`--- stored (DB)`, `+++ disk (${path})`];
2656
+ const maxLen = Math.max(stored.length, disk.length);
2657
+ for (let i = 0;i < maxLen; i++) {
2658
+ const s = stored[i];
2659
+ const d = disk[i];
2660
+ if (s === d) {
2661
+ if (s !== undefined)
2662
+ lines.push(` ${s}`);
2663
+ } else {
2664
+ if (s !== undefined)
2665
+ lines.push(`-${s}`);
2666
+ if (d !== undefined)
2667
+ lines.push(`+${d}`);
2668
+ }
2669
+ }
2670
+ return lines.join(`
2671
+ `);
2672
+ }
2673
+
2674
+ // src/lib/export.ts
2675
+ import { existsSync as existsSync4, mkdirSync as mkdirSync3, rmSync, writeFileSync as writeFileSync2 } from "fs";
2676
+ import { join as join3, resolve as resolve4 } from "path";
2677
+ import { tmpdir } from "os";
2678
+ async function exportConfigs(outputPath, opts = {}) {
2679
+ const d = opts.db || getDatabase();
2680
+ const configs = listConfigs(opts.filter, d);
2681
+ const absOutput = resolve4(outputPath);
2682
+ const tmpDir = join3(tmpdir(), `configs-export-${Date.now()}`);
2683
+ const contentsDir = join3(tmpDir, "contents");
2684
+ try {
2685
+ mkdirSync3(contentsDir, { recursive: true });
2686
+ const manifest = {
2687
+ version: "1.0.0",
2688
+ exported_at: now(),
2689
+ configs: configs.map(({ content: _content, ...meta }) => meta)
2690
+ };
2691
+ writeFileSync2(join3(tmpDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf-8");
2692
+ for (const config of configs) {
2693
+ const fileName = `${config.slug}.${config.format === "text" ? "txt" : config.format}`;
2694
+ writeFileSync2(join3(contentsDir, fileName), config.content, "utf-8");
2695
+ }
2696
+ const proc = Bun.spawn(["tar", "czf", absOutput, "-C", tmpDir, "."], {
2697
+ stdout: "pipe",
2698
+ stderr: "pipe"
2699
+ });
2700
+ const exitCode = await proc.exited;
2701
+ if (exitCode !== 0) {
2702
+ const stderr = await new Response(proc.stderr).text();
2703
+ throw new Error(`tar failed: ${stderr}`);
2704
+ }
2705
+ return { path: absOutput, count: configs.length };
2706
+ } finally {
2707
+ if (existsSync4(tmpDir)) {
2708
+ rmSync(tmpDir, { recursive: true, force: true });
2709
+ }
2710
+ }
2711
+ }
2712
+
2713
+ // src/lib/import.ts
2714
+ import { existsSync as existsSync5, mkdirSync as mkdirSync4, readFileSync as readFileSync3, rmSync as rmSync2 } from "fs";
2715
+ import { join as join4, resolve as resolve5 } from "path";
2716
+ import { tmpdir as tmpdir2 } from "os";
2717
+ async function importConfigs(bundlePath, opts = {}) {
2718
+ const d = opts.db || getDatabase();
2719
+ const conflict = opts.conflict ?? "skip";
2720
+ const absPath = resolve5(bundlePath);
2721
+ const tmpDir = join4(tmpdir2(), `configs-import-${Date.now()}`);
2722
+ const result = { created: 0, updated: 0, skipped: 0, errors: [] };
2723
+ try {
2724
+ mkdirSync4(tmpDir, { recursive: true });
2725
+ const proc = Bun.spawn(["tar", "xzf", absPath, "-C", tmpDir], {
2726
+ stdout: "pipe",
2727
+ stderr: "pipe"
2728
+ });
2729
+ const exitCode = await proc.exited;
2730
+ if (exitCode !== 0) {
2731
+ const stderr = await new Response(proc.stderr).text();
2732
+ throw new Error(`tar extraction failed: ${stderr}`);
2733
+ }
2734
+ const manifestPath = join4(tmpDir, "manifest.json");
2735
+ if (!existsSync5(manifestPath))
2736
+ throw new Error("Invalid bundle: missing manifest.json");
2737
+ const manifest = JSON.parse(readFileSync3(manifestPath, "utf-8"));
2738
+ for (const meta of manifest.configs) {
2739
+ try {
2740
+ const ext = meta.format === "text" ? "txt" : meta.format;
2741
+ const contentFile = join4(tmpDir, "contents", `${meta.slug}.${ext}`);
2742
+ const content = existsSync5(contentFile) ? readFileSync3(contentFile, "utf-8") : "";
2743
+ let existing = null;
2744
+ try {
2745
+ existing = getConfig(meta.slug, d);
2746
+ } catch {}
2747
+ if (existing) {
2748
+ if (conflict === "skip") {
2749
+ result.skipped++;
2750
+ } else if (conflict === "overwrite" || conflict === "version") {
2751
+ updateConfig(existing.id, { content, description: meta.description ?? undefined, tags: meta.tags }, d);
2752
+ result.updated++;
2753
+ }
2754
+ } else {
2755
+ createConfig({
2756
+ name: meta.name,
2757
+ kind: meta.kind,
2758
+ category: meta.category,
2759
+ agent: meta.agent,
2760
+ target_path: meta.target_path ?? undefined,
2761
+ format: meta.format,
2762
+ content,
2763
+ description: meta.description ?? undefined,
2764
+ tags: meta.tags,
2765
+ is_template: meta.is_template
2766
+ }, d);
2767
+ result.created++;
2768
+ }
2769
+ } catch (err) {
2770
+ result.errors.push(`${meta.slug}: ${err instanceof Error ? err.message : String(err)}`);
2771
+ }
2772
+ }
2773
+ return result;
2774
+ } finally {
2775
+ if (existsSync5(tmpDir)) {
2776
+ rmSync2(tmpDir, { recursive: true, force: true });
2777
+ }
2778
+ }
2779
+ }
2780
+
2781
+ // src/lib/template.ts
2782
+ var VAR_PATTERN = /\{\{([A-Z0-9_]+)(?::([^}]*))?\}\}/g;
2783
+ function extractTemplateVars(content) {
2784
+ const vars = new Map;
2785
+ let match;
2786
+ VAR_PATTERN.lastIndex = 0;
2787
+ while ((match = VAR_PATTERN.exec(content)) !== null) {
2788
+ const name = match[1];
2789
+ const description = match[2] ?? null;
2790
+ if (!vars.has(name)) {
2791
+ vars.set(name, { name, description, required: true });
2792
+ }
2793
+ }
2794
+ return Array.from(vars.values());
2795
+ }
2796
+
2797
+ // src/cli/index.tsx
2798
+ var pkg = { version: "0.1.0" };
2799
+ function fmtConfig(c, format) {
2800
+ if (format === "json")
2801
+ return JSON.stringify(c, null, 2);
2802
+ if (format === "compact")
2803
+ return `${c.slug} [${c.category}/${c.agent}] ${c.kind === "reference" ? "(ref)" : c.target_path ?? "(no path)"}`;
2804
+ return [
2805
+ `${chalk.bold(c.name)} ${chalk.dim(`(${c.slug})`)}`,
2806
+ ` ${chalk.cyan("category:")} ${c.category} ${chalk.cyan("agent:")} ${c.agent} ${chalk.cyan("kind:")} ${c.kind}`,
2807
+ ` ${chalk.cyan("format:")} ${c.format} ${chalk.cyan("version:")} ${c.version}${c.target_path ? ` ${chalk.cyan("path:")} ${c.target_path}` : ""}`,
2808
+ c.description ? ` ${chalk.dim(c.description)}` : "",
2809
+ c.tags.length > 0 ? ` ${chalk.dim("tags: " + c.tags.join(", "))}` : ""
2810
+ ].filter(Boolean).join(`
2811
+ `);
2812
+ }
2813
+ program.command("list").alias("ls").description("List stored configs").option("-c, --category <cat>", "filter by category").option("-a, --agent <agent>", "filter by agent").option("-k, --kind <kind>", "filter by kind (file|reference)").option("-t, --tag <tag>", "filter by tag").option("-s, --search <query>", "search name/description/content").option("-f, --format <fmt>", "output format: table|json|compact", "table").action(async (opts) => {
2814
+ const configs = listConfigs({
2815
+ category: opts.category,
2816
+ agent: opts.agent,
2817
+ kind: opts.kind,
2818
+ tags: opts.tag ? [opts.tag] : undefined,
2819
+ search: opts.search
2820
+ });
2821
+ if (configs.length === 0) {
2822
+ console.log(chalk.dim("No configs found."));
2823
+ return;
2824
+ }
2825
+ if (opts.format === "json") {
2826
+ console.log(JSON.stringify(configs, null, 2));
2827
+ return;
2828
+ }
2829
+ for (const c of configs) {
2830
+ console.log(fmtConfig(c, opts.format));
2831
+ if (opts.format === "table")
2832
+ console.log();
2833
+ }
2834
+ console.log(chalk.dim(`${configs.length} config(s)`));
2835
+ });
2836
+ program.command("show <id>").description("Show a config's content and metadata").option("-f, --format <fmt>", "output format: table|json|content", "table").action(async (id, opts) => {
2837
+ try {
2838
+ const c = getConfig(id);
2839
+ if (opts.format === "json") {
2840
+ console.log(JSON.stringify(c, null, 2));
2841
+ return;
2842
+ }
2843
+ if (opts.format === "content") {
2844
+ console.log(c.content);
2845
+ return;
2846
+ }
2847
+ console.log(fmtConfig(c, "table"));
2848
+ console.log();
2849
+ console.log(chalk.bold("Content:"));
2850
+ console.log(chalk.dim("\u2500".repeat(60)));
2851
+ console.log(c.content);
2852
+ } catch (e) {
2853
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
2854
+ process.exit(1);
2855
+ }
2856
+ });
2857
+ program.command("add <path>").description("Ingest a file into the config DB").option("-n, --name <name>", "config name (defaults to filename)").option("-c, --category <cat>", "category override").option("-a, --agent <agent>", "agent override").option("-k, --kind <kind>", "kind: file|reference", "file").option("--template", "mark as template (has {{VAR}} placeholders)").action(async (filePath, opts) => {
2858
+ const abs = resolve6(filePath);
2859
+ if (!existsSync6(abs)) {
2860
+ console.error(chalk.red(`File not found: ${abs}`));
2861
+ process.exit(1);
2862
+ }
2863
+ const content = readFileSync4(abs, "utf-8");
2864
+ const targetPath = abs.startsWith(homedir3()) ? abs.replace(homedir3(), "~") : abs;
2865
+ const name = opts.name || filePath.split("/").pop();
2866
+ const config = createConfig({
2867
+ name,
2868
+ kind: opts.kind ?? "file",
2869
+ category: opts.category ?? detectCategory(abs),
2870
+ agent: opts.agent ?? detectAgent(abs),
2871
+ target_path: opts.kind === "reference" ? null : targetPath,
2872
+ format: detectFormat(abs),
2873
+ content,
2874
+ is_template: opts.template ?? false
2875
+ });
2876
+ console.log(chalk.green("\u2713") + ` Added: ${chalk.bold(config.name)} ${chalk.dim(`(${config.slug})`)}`);
2877
+ });
2878
+ program.command("apply <id>").description("Apply a config to its target_path on disk").option("--dry-run", "preview without writing").option("--force", "overwrite even if unchanged").action(async (id, opts) => {
2879
+ try {
2880
+ const config = getConfig(id);
2881
+ const result = await applyConfig(config, { dryRun: opts.dryRun });
2882
+ const status = opts.dryRun ? chalk.yellow("[dry-run]") : result.changed ? chalk.green("\u2713") : chalk.dim("=");
2883
+ const change = result.changed ? "changed" : "unchanged";
2884
+ console.log(`${status} ${result.path} ${chalk.dim(`(${change})`)}`);
2885
+ } catch (e) {
2886
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
2887
+ process.exit(1);
2888
+ }
2889
+ });
2890
+ program.command("diff <id>").description("Show diff between stored config and disk").action(async (id) => {
2891
+ try {
2892
+ const config = getConfig(id);
2893
+ const diff = diffConfig(config);
2894
+ console.log(diff);
2895
+ } catch (e) {
2896
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
2897
+ process.exit(1);
2898
+ }
2899
+ });
2900
+ program.command("sync").description("Bulk sync a directory with the DB").option("-d, --dir <dir>", "directory to sync (default: ~/.claude)", "~/.claude").option("--from-disk", "read files from disk into DB (default)").option("--to-disk", "apply DB configs back to disk").option("--dry-run", "preview without writing").action(async (opts) => {
2901
+ const toDisk = opts.toDisk;
2902
+ if (toDisk) {
2903
+ const result = await syncToDir(opts.dir, { dryRun: opts.dryRun });
2904
+ console.log(chalk.green(`\u2713`) + ` Synced to disk: +${result.added} updated:${result.updated} unchanged:${result.unchanged} skipped:${result.skipped.length}`);
2905
+ } else {
2906
+ const result = await syncFromDir(opts.dir, { dryRun: opts.dryRun });
2907
+ console.log(chalk.green(`\u2713`) + ` Synced from disk: +${result.added} updated:${result.updated} unchanged:${result.unchanged} skipped:${result.skipped.length}`);
2908
+ }
2909
+ });
2910
+ program.command("export").description("Export configs as a tar.gz bundle").option("-o, --output <path>", "output file", "./configs-export.tar.gz").option("-c, --category <cat>", "filter by category").action(async (opts) => {
2911
+ const result = await exportConfigs(opts.output, {
2912
+ filter: opts.category ? { category: opts.category } : undefined
2913
+ });
2914
+ console.log(chalk.green("\u2713") + ` Exported ${result.count} configs to ${result.path}`);
2915
+ });
2916
+ program.command("import <file>").description("Import configs from a tar.gz bundle").option("--overwrite", "overwrite existing configs").action(async (file, opts) => {
2917
+ const result = await importConfigs(file, {
2918
+ conflict: opts.overwrite ? "overwrite" : "skip"
2919
+ });
2920
+ console.log(chalk.green("\u2713") + ` Import complete: +${result.created} updated:${result.updated} skipped:${result.skipped}`);
2921
+ if (result.errors.length > 0) {
2922
+ console.log(chalk.red("Errors:"));
2923
+ for (const e of result.errors)
2924
+ console.log(chalk.red(" " + e));
2925
+ }
2926
+ });
2927
+ program.command("whoami").description("Show setup summary").action(async () => {
2928
+ const dbPath = process.env["CONFIGS_DB_PATH"] || join5(homedir3(), ".configs", "configs.db");
2929
+ const stats = getConfigStats();
2930
+ console.log(chalk.bold("@hasna/configs") + chalk.dim(" v" + pkg.version));
2931
+ console.log(chalk.cyan("DB:") + " " + dbPath);
2932
+ console.log(chalk.cyan("Total configs:") + " " + (stats["total"] || 0));
2933
+ console.log();
2934
+ console.log(chalk.bold("By category:"));
2935
+ const categories = ["agent", "rules", "mcp", "shell", "secrets_schema", "workspace", "git", "tools"];
2936
+ for (const cat of categories) {
2937
+ const count = stats[cat] || 0;
2938
+ if (count > 0)
2939
+ console.log(` ${chalk.cyan(cat.padEnd(16))} ${count}`);
2940
+ }
2941
+ const profiles = listProfiles();
2942
+ if (profiles.length > 0) {
2943
+ console.log();
2944
+ console.log(chalk.bold("Profiles:") + chalk.dim(` (${profiles.length})`));
2945
+ for (const p of profiles)
2946
+ console.log(` ${chalk.cyan(p.name)} ${chalk.dim(`(${p.slug})`)}`);
2947
+ }
2948
+ });
2949
+ var profileCmd = program.command("profile").description("Manage config profiles (named bundles)");
2950
+ profileCmd.command("list").description("List all profiles").action(async () => {
2951
+ const profiles = listProfiles();
2952
+ if (profiles.length === 0) {
2953
+ console.log(chalk.dim("No profiles."));
2954
+ return;
2955
+ }
2956
+ for (const p of profiles) {
2957
+ const configs = getProfileConfigs(p.id);
2958
+ console.log(`${chalk.bold(p.name)} ${chalk.dim(`(${p.slug})`)} \u2014 ${configs.length} config(s)`);
2959
+ if (p.description)
2960
+ console.log(` ${chalk.dim(p.description)}`);
2961
+ }
2962
+ });
2963
+ profileCmd.command("create <name>").description("Create a new profile").option("-d, --description <desc>", "profile description").action(async (name, opts) => {
2964
+ const p = createProfile({ name, description: opts.description });
2965
+ console.log(chalk.green("\u2713") + ` Created profile: ${chalk.bold(p.name)} ${chalk.dim(`(${p.slug})`)}`);
2966
+ });
2967
+ profileCmd.command("show <id>").description("Show profile and its configs").action(async (id) => {
2968
+ try {
2969
+ const p = getProfile(id);
2970
+ const configs = getProfileConfigs(id);
2971
+ console.log(chalk.bold(p.name) + chalk.dim(` (${p.slug})`));
2972
+ if (p.description)
2973
+ console.log(chalk.dim(p.description));
2974
+ console.log(chalk.cyan(`${configs.length} config(s):`));
2975
+ for (const c of configs)
2976
+ console.log(` ${c.slug} ${chalk.dim(`[${c.category}]`)}`);
2977
+ } catch (e) {
2978
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
2979
+ process.exit(1);
2980
+ }
2981
+ });
2982
+ profileCmd.command("add <profile> <config>").description("Add a config to a profile").action(async (profile, config) => {
2983
+ try {
2984
+ const c = getConfig(config);
2985
+ addConfigToProfile(profile, c.id);
2986
+ console.log(chalk.green("\u2713") + ` Added ${c.slug} to profile ${profile}`);
2987
+ } catch (e) {
2988
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
2989
+ process.exit(1);
2990
+ }
2991
+ });
2992
+ profileCmd.command("remove <profile> <config>").description("Remove a config from a profile").action(async (profile, config) => {
2993
+ try {
2994
+ const c = getConfig(config);
2995
+ removeConfigFromProfile(profile, c.id);
2996
+ console.log(chalk.green("\u2713") + ` Removed ${c.slug} from profile ${profile}`);
2997
+ } catch (e) {
2998
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
2999
+ process.exit(1);
3000
+ }
3001
+ });
3002
+ profileCmd.command("apply <id>").description("Apply all configs in a profile to disk").option("--dry-run", "preview without writing").action(async (id, opts) => {
3003
+ try {
3004
+ const configs = getProfileConfigs(id);
3005
+ const results = await applyConfigs(configs, { dryRun: opts.dryRun });
3006
+ let changed = 0;
3007
+ for (const r of results) {
3008
+ const status = opts.dryRun ? chalk.yellow("[dry-run]") : r.changed ? chalk.green("\u2713") : chalk.dim("=");
3009
+ console.log(`${status} ${r.path}`);
3010
+ if (r.changed)
3011
+ changed++;
3012
+ }
3013
+ console.log(chalk.dim(`
3014
+ ${changed}/${results.length} changed`));
3015
+ } catch (e) {
3016
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
3017
+ process.exit(1);
3018
+ }
3019
+ });
3020
+ profileCmd.command("delete <id>").description("Delete a profile").action(async (id) => {
3021
+ try {
3022
+ const p = getProfile(id);
3023
+ deleteProfile(id);
3024
+ console.log(chalk.green("\u2713") + ` Deleted profile: ${p.name}`);
3025
+ } catch (e) {
3026
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
3027
+ process.exit(1);
3028
+ }
3029
+ });
3030
+ var snapshotCmd = program.command("snapshot").description("Manage config version history");
3031
+ snapshotCmd.command("list <config>").description("List snapshots for a config").action(async (configId) => {
3032
+ try {
3033
+ const c = getConfig(configId);
3034
+ const snaps = listSnapshots(c.id);
3035
+ if (snaps.length === 0) {
3036
+ console.log(chalk.dim("No snapshots."));
3037
+ return;
3038
+ }
3039
+ for (const s of snaps) {
3040
+ console.log(` v${s.version} ${chalk.dim(s.created_at)} ${chalk.dim(s.id)}`);
3041
+ }
3042
+ } catch (e) {
3043
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
3044
+ process.exit(1);
3045
+ }
3046
+ });
3047
+ snapshotCmd.command("show <id>").description("Show a snapshot's content").action(async (id) => {
3048
+ const snap = getSnapshot(id);
3049
+ if (!snap) {
3050
+ console.error(chalk.red("Snapshot not found: " + id));
3051
+ process.exit(1);
3052
+ }
3053
+ console.log(snap.content);
3054
+ });
3055
+ snapshotCmd.command("restore <config> <snapshot-id>").description("Restore a config to a snapshot version").action(async (configId, snapId) => {
3056
+ try {
3057
+ const snap = getSnapshot(snapId);
3058
+ if (!snap) {
3059
+ console.error(chalk.red("Snapshot not found: " + snapId));
3060
+ process.exit(1);
3061
+ }
3062
+ updateConfig(configId, { content: snap.content });
3063
+ console.log(chalk.green("\u2713") + ` Restored ${configId} to snapshot v${snap.version}`);
3064
+ } catch (e) {
3065
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
3066
+ process.exit(1);
3067
+ }
3068
+ });
3069
+ var templateCmd = program.command("template").description("Work with template configs");
3070
+ templateCmd.command("vars <id>").description("Show template variables").action(async (id) => {
3071
+ try {
3072
+ const c = getConfig(id);
3073
+ const vars = extractTemplateVars(c.content);
3074
+ if (vars.length === 0) {
3075
+ console.log(chalk.dim("No template variables found."));
3076
+ return;
3077
+ }
3078
+ for (const v of vars) {
3079
+ console.log(` ${chalk.cyan("{{" + v.name + "}}")}${v.description ? chalk.dim(" \u2014 " + v.description) : ""}`);
3080
+ }
3081
+ } catch (e) {
3082
+ console.error(chalk.red(e instanceof Error ? e.message : String(e)));
3083
+ process.exit(1);
3084
+ }
3085
+ });
3086
+ program.version(pkg.version).name("configs");
3087
+ program.parse(process.argv);