@hasna/prompts 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.
@@ -0,0 +1,3082 @@
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 { createRequire } from "module";
2075
+
2076
+ // src/db/database.ts
2077
+ import { Database } from "bun:sqlite";
2078
+ import { join } from "path";
2079
+ import { existsSync, mkdirSync } from "fs";
2080
+ var _db = null;
2081
+ function getDbPath() {
2082
+ if (process.env["PROMPTS_DB_PATH"]) {
2083
+ return process.env["PROMPTS_DB_PATH"];
2084
+ }
2085
+ if (process.env["PROMPTS_DB_SCOPE"] === "project") {
2086
+ let dir = process.cwd();
2087
+ while (true) {
2088
+ const candidate = join(dir, ".prompts", "prompts.db");
2089
+ if (existsSync(join(dir, ".git"))) {
2090
+ return candidate;
2091
+ }
2092
+ const parent = join(dir, "..");
2093
+ if (parent === dir)
2094
+ break;
2095
+ dir = parent;
2096
+ }
2097
+ }
2098
+ const home = process.env["HOME"] || process.env["USERPROFILE"] || "~";
2099
+ return join(home, ".prompts", "prompts.db");
2100
+ }
2101
+ function getDatabase() {
2102
+ if (_db)
2103
+ return _db;
2104
+ const dbPath = getDbPath();
2105
+ if (dbPath !== ":memory:") {
2106
+ const dir = dbPath.substring(0, dbPath.lastIndexOf("/"));
2107
+ if (dir && !existsSync(dir)) {
2108
+ mkdirSync(dir, { recursive: true });
2109
+ }
2110
+ }
2111
+ const db = new Database(dbPath, { create: true });
2112
+ db.exec("PRAGMA journal_mode = WAL");
2113
+ db.exec("PRAGMA busy_timeout = 5000");
2114
+ db.exec("PRAGMA foreign_keys = ON");
2115
+ runMigrations(db);
2116
+ _db = db;
2117
+ return db;
2118
+ }
2119
+ function runMigrations(db) {
2120
+ db.exec(`
2121
+ CREATE TABLE IF NOT EXISTS _migrations (
2122
+ id INTEGER PRIMARY KEY,
2123
+ name TEXT NOT NULL,
2124
+ applied_at TEXT NOT NULL DEFAULT (datetime('now'))
2125
+ )
2126
+ `);
2127
+ const applied = new Set(db.query("SELECT name FROM _migrations").all().map((r) => r.name));
2128
+ const migrations = [
2129
+ {
2130
+ name: "001_initial",
2131
+ sql: `
2132
+ CREATE TABLE IF NOT EXISTS collections (
2133
+ id TEXT PRIMARY KEY,
2134
+ name TEXT NOT NULL UNIQUE,
2135
+ description TEXT,
2136
+ created_at TEXT NOT NULL DEFAULT (datetime('now'))
2137
+ );
2138
+
2139
+ INSERT OR IGNORE INTO collections (id, name, description, created_at)
2140
+ VALUES ('default', 'default', 'Default collection', datetime('now'));
2141
+
2142
+ CREATE TABLE IF NOT EXISTS prompts (
2143
+ id TEXT PRIMARY KEY,
2144
+ name TEXT NOT NULL,
2145
+ slug TEXT NOT NULL UNIQUE,
2146
+ title TEXT NOT NULL,
2147
+ body TEXT NOT NULL,
2148
+ description TEXT,
2149
+ collection TEXT NOT NULL DEFAULT 'default' REFERENCES collections(name) ON UPDATE CASCADE,
2150
+ tags TEXT NOT NULL DEFAULT '[]',
2151
+ variables TEXT NOT NULL DEFAULT '[]',
2152
+ is_template INTEGER NOT NULL DEFAULT 0,
2153
+ source TEXT NOT NULL DEFAULT 'manual',
2154
+ version INTEGER NOT NULL DEFAULT 1,
2155
+ use_count INTEGER NOT NULL DEFAULT 0,
2156
+ last_used_at TEXT,
2157
+ created_at TEXT NOT NULL DEFAULT (datetime('now')),
2158
+ updated_at TEXT NOT NULL DEFAULT (datetime('now'))
2159
+ );
2160
+
2161
+ CREATE TABLE IF NOT EXISTS prompt_versions (
2162
+ id TEXT PRIMARY KEY,
2163
+ prompt_id TEXT NOT NULL REFERENCES prompts(id) ON DELETE CASCADE,
2164
+ body TEXT NOT NULL,
2165
+ version INTEGER NOT NULL,
2166
+ changed_by TEXT,
2167
+ created_at TEXT NOT NULL DEFAULT (datetime('now'))
2168
+ );
2169
+
2170
+ CREATE TABLE IF NOT EXISTS agents (
2171
+ id TEXT PRIMARY KEY,
2172
+ name TEXT NOT NULL UNIQUE,
2173
+ description TEXT,
2174
+ created_at TEXT NOT NULL DEFAULT (datetime('now')),
2175
+ last_seen_at TEXT NOT NULL DEFAULT (datetime('now'))
2176
+ );
2177
+
2178
+ CREATE INDEX IF NOT EXISTS idx_prompts_collection ON prompts(collection);
2179
+ CREATE INDEX IF NOT EXISTS idx_prompts_source ON prompts(source);
2180
+ CREATE INDEX IF NOT EXISTS idx_prompts_is_template ON prompts(is_template);
2181
+ CREATE INDEX IF NOT EXISTS idx_prompts_use_count ON prompts(use_count DESC);
2182
+ CREATE INDEX IF NOT EXISTS idx_prompts_last_used ON prompts(last_used_at DESC);
2183
+ CREATE INDEX IF NOT EXISTS idx_versions_prompt_id ON prompt_versions(prompt_id);
2184
+ `
2185
+ },
2186
+ {
2187
+ name: "002_fts5",
2188
+ sql: `
2189
+ CREATE VIRTUAL TABLE IF NOT EXISTS prompts_fts USING fts5(
2190
+ name,
2191
+ slug,
2192
+ title,
2193
+ body,
2194
+ description,
2195
+ tags,
2196
+ content='prompts',
2197
+ content_rowid='rowid'
2198
+ );
2199
+
2200
+ CREATE TRIGGER IF NOT EXISTS prompts_fts_insert AFTER INSERT ON prompts BEGIN
2201
+ INSERT INTO prompts_fts(rowid, name, slug, title, body, description, tags)
2202
+ VALUES (new.rowid, new.name, new.slug, new.title, new.body, COALESCE(new.description,''), new.tags);
2203
+ END;
2204
+
2205
+ CREATE TRIGGER IF NOT EXISTS prompts_fts_update AFTER UPDATE ON prompts BEGIN
2206
+ INSERT INTO prompts_fts(prompts_fts, rowid, name, slug, title, body, description, tags)
2207
+ VALUES ('delete', old.rowid, old.name, old.slug, old.title, old.body, COALESCE(old.description,''), old.tags);
2208
+ INSERT INTO prompts_fts(rowid, name, slug, title, body, description, tags)
2209
+ VALUES (new.rowid, new.name, new.slug, new.title, new.body, COALESCE(new.description,''), new.tags);
2210
+ END;
2211
+
2212
+ CREATE TRIGGER IF NOT EXISTS prompts_fts_delete AFTER DELETE ON prompts BEGIN
2213
+ INSERT INTO prompts_fts(prompts_fts, rowid, name, slug, title, body, description, tags)
2214
+ VALUES ('delete', old.rowid, old.name, old.slug, old.title, old.body, COALESCE(old.description,''), old.tags);
2215
+ END;
2216
+ `
2217
+ }
2218
+ ];
2219
+ for (const migration of migrations) {
2220
+ if (applied.has(migration.name))
2221
+ continue;
2222
+ db.exec(migration.sql);
2223
+ db.run("INSERT INTO _migrations (name) VALUES (?)", [migration.name]);
2224
+ }
2225
+ }
2226
+ function hasFts(db) {
2227
+ return db.query("SELECT 1 FROM sqlite_master WHERE type='table' AND name='prompts_fts'").get() !== null;
2228
+ }
2229
+ function resolvePrompt(db, idOrSlug) {
2230
+ const byId = db.query("SELECT id FROM prompts WHERE id = ?").get(idOrSlug);
2231
+ if (byId)
2232
+ return byId.id;
2233
+ const bySlug = db.query("SELECT id FROM prompts WHERE slug = ?").get(idOrSlug);
2234
+ if (bySlug)
2235
+ return bySlug.id;
2236
+ const byPrefix = db.query("SELECT id FROM prompts WHERE id LIKE ? LIMIT 2").all(`${idOrSlug}%`);
2237
+ if (byPrefix.length === 1 && byPrefix[0])
2238
+ return byPrefix[0].id;
2239
+ return null;
2240
+ }
2241
+
2242
+ // src/lib/ids.ts
2243
+ function generateSlug(title) {
2244
+ return title.toLowerCase().replace(/[^a-z0-9\s-]/g, "").trim().replace(/\s+/g, "-").replace(/-+/g, "-").substring(0, 80);
2245
+ }
2246
+ function uniqueSlug(baseSlug) {
2247
+ const db = getDatabase();
2248
+ let slug = baseSlug;
2249
+ let i = 2;
2250
+ while (db.query("SELECT 1 FROM prompts WHERE slug = ?").get(slug)) {
2251
+ slug = `${baseSlug}-${i}`;
2252
+ i++;
2253
+ }
2254
+ return slug;
2255
+ }
2256
+ function generatePromptId() {
2257
+ const db = getDatabase();
2258
+ const row = db.query("SELECT id FROM prompts ORDER BY rowid DESC LIMIT 1").get();
2259
+ let next = 1;
2260
+ if (row) {
2261
+ const match = row.id.match(/PRMT-(\d+)/);
2262
+ if (match && match[1]) {
2263
+ next = parseInt(match[1], 10) + 1;
2264
+ }
2265
+ }
2266
+ return `PRMT-${String(next).padStart(5, "0")}`;
2267
+ }
2268
+ function generateId(prefix) {
2269
+ const chars = "abcdefghijklmnopqrstuvwxyz0123456789";
2270
+ let id = prefix + "-";
2271
+ for (let i = 0;i < 8; i++) {
2272
+ id += chars[Math.floor(Math.random() * chars.length)];
2273
+ }
2274
+ return id;
2275
+ }
2276
+
2277
+ // src/db/collections.ts
2278
+ function rowToCollection(row) {
2279
+ return {
2280
+ id: row["id"],
2281
+ name: row["name"],
2282
+ description: row["description"] ?? null,
2283
+ prompt_count: row["prompt_count"] ?? 0,
2284
+ created_at: row["created_at"]
2285
+ };
2286
+ }
2287
+ function listCollections() {
2288
+ const db = getDatabase();
2289
+ const rows = db.query(`SELECT c.*, COUNT(p.id) as prompt_count
2290
+ FROM collections c
2291
+ LEFT JOIN prompts p ON p.collection = c.name
2292
+ GROUP BY c.id
2293
+ ORDER BY c.name`).all();
2294
+ return rows.map(rowToCollection);
2295
+ }
2296
+ function getCollection(name) {
2297
+ const db = getDatabase();
2298
+ const row = db.query(`SELECT c.*, COUNT(p.id) as prompt_count
2299
+ FROM collections c
2300
+ LEFT JOIN prompts p ON p.collection = c.name
2301
+ WHERE c.name = ?
2302
+ GROUP BY c.id`).get(name);
2303
+ if (!row)
2304
+ return null;
2305
+ return rowToCollection(row);
2306
+ }
2307
+ function ensureCollection(name, description) {
2308
+ const db = getDatabase();
2309
+ const existing = db.query("SELECT id FROM collections WHERE name = ?").get(name);
2310
+ if (!existing) {
2311
+ const id = generateId("COL");
2312
+ db.run("INSERT INTO collections (id, name, description) VALUES (?, ?, ?)", [
2313
+ id,
2314
+ name,
2315
+ description ?? null
2316
+ ]);
2317
+ }
2318
+ return getCollection(name);
2319
+ }
2320
+ function movePrompt(promptIdOrSlug, targetCollection) {
2321
+ const db = getDatabase();
2322
+ ensureCollection(targetCollection);
2323
+ const row = db.query("SELECT id FROM prompts WHERE id = ? OR slug = ?").get(promptIdOrSlug, promptIdOrSlug);
2324
+ if (!row)
2325
+ throw new Error(`Prompt not found: ${promptIdOrSlug}`);
2326
+ db.run("UPDATE prompts SET collection = ?, updated_at = datetime('now') WHERE id = ?", [
2327
+ targetCollection,
2328
+ row.id
2329
+ ]);
2330
+ }
2331
+
2332
+ // src/lib/template.ts
2333
+ var VAR_PATTERN = /\{\{\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*(?:\|\s*(.*?)\s*)?\}\}/g;
2334
+ function extractVariables(body) {
2335
+ const vars = new Set;
2336
+ const pattern = new RegExp(VAR_PATTERN.source, "g");
2337
+ let match;
2338
+ while ((match = pattern.exec(body)) !== null) {
2339
+ if (match[1])
2340
+ vars.add(match[1]);
2341
+ }
2342
+ return Array.from(vars);
2343
+ }
2344
+ function extractVariableInfo(body) {
2345
+ const seen = new Map;
2346
+ const pattern = new RegExp(VAR_PATTERN.source, "g");
2347
+ let match;
2348
+ while ((match = pattern.exec(body)) !== null) {
2349
+ const name = match[1];
2350
+ if (!name)
2351
+ continue;
2352
+ const defaultVal = match[2] !== undefined ? match[2] : null;
2353
+ if (!seen.has(name)) {
2354
+ seen.set(name, { name, default: defaultVal, required: defaultVal === null });
2355
+ }
2356
+ }
2357
+ return Array.from(seen.values());
2358
+ }
2359
+ function renderTemplate(body, vars) {
2360
+ const missing = [];
2361
+ const usedDefaults = [];
2362
+ const rendered = body.replace(VAR_PATTERN, (_match, name, defaultVal) => {
2363
+ if (name in vars)
2364
+ return vars[name] ?? "";
2365
+ if (defaultVal !== undefined) {
2366
+ usedDefaults.push(name);
2367
+ return defaultVal;
2368
+ }
2369
+ missing.push(name);
2370
+ return _match;
2371
+ });
2372
+ return { rendered, missing_vars: missing, used_defaults: usedDefaults };
2373
+ }
2374
+
2375
+ // src/types/index.ts
2376
+ class PromptNotFoundError extends Error {
2377
+ constructor(id) {
2378
+ super(`Prompt not found: ${id}`);
2379
+ this.name = "PromptNotFoundError";
2380
+ }
2381
+ }
2382
+
2383
+ class VersionConflictError extends Error {
2384
+ constructor(id) {
2385
+ super(`Version conflict on prompt: ${id}`);
2386
+ this.name = "VersionConflictError";
2387
+ }
2388
+ }
2389
+
2390
+ class DuplicateSlugError extends Error {
2391
+ constructor(slug) {
2392
+ super(`A prompt with slug "${slug}" already exists`);
2393
+ this.name = "DuplicateSlugError";
2394
+ }
2395
+ }
2396
+
2397
+ // src/db/prompts.ts
2398
+ function rowToPrompt(row) {
2399
+ return {
2400
+ id: row["id"],
2401
+ name: row["name"],
2402
+ slug: row["slug"],
2403
+ title: row["title"],
2404
+ body: row["body"],
2405
+ description: row["description"] ?? null,
2406
+ collection: row["collection"],
2407
+ tags: JSON.parse(row["tags"] || "[]"),
2408
+ variables: JSON.parse(row["variables"] || "[]"),
2409
+ is_template: Boolean(row["is_template"]),
2410
+ source: row["source"],
2411
+ version: row["version"],
2412
+ use_count: row["use_count"],
2413
+ last_used_at: row["last_used_at"] ?? null,
2414
+ created_at: row["created_at"],
2415
+ updated_at: row["updated_at"]
2416
+ };
2417
+ }
2418
+ function createPrompt(input) {
2419
+ const db = getDatabase();
2420
+ const slug = input.slug ? input.slug : uniqueSlug(generateSlug(input.title));
2421
+ if (input.slug) {
2422
+ const existing = db.query("SELECT id FROM prompts WHERE slug = ?").get(input.slug);
2423
+ if (existing)
2424
+ throw new DuplicateSlugError(input.slug);
2425
+ }
2426
+ const id = generatePromptId();
2427
+ const name = input.name || input.title;
2428
+ const collection = input.collection || "default";
2429
+ ensureCollection(collection);
2430
+ const tags = JSON.stringify(input.tags || []);
2431
+ const source = input.source || "manual";
2432
+ const vars = extractVariables(input.body);
2433
+ const variables = JSON.stringify(vars.map((v) => ({ name: v, required: true })));
2434
+ const is_template = vars.length > 0 ? 1 : 0;
2435
+ db.run(`INSERT INTO prompts (id, name, slug, title, body, description, collection, tags, variables, is_template, source)
2436
+ VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [id, name, slug, input.title, input.body, input.description ?? null, collection, tags, variables, is_template, source]);
2437
+ db.run(`INSERT INTO prompt_versions (id, prompt_id, body, version, changed_by)
2438
+ VALUES (?, ?, ?, 1, ?)`, [generateId("VER"), id, input.body, input.changed_by ?? null]);
2439
+ return getPrompt(id);
2440
+ }
2441
+ function getPrompt(idOrSlug) {
2442
+ const db = getDatabase();
2443
+ const id = resolvePrompt(db, idOrSlug);
2444
+ if (!id)
2445
+ return null;
2446
+ const row = db.query("SELECT * FROM prompts WHERE id = ?").get(id);
2447
+ if (!row)
2448
+ return null;
2449
+ return rowToPrompt(row);
2450
+ }
2451
+ function requirePrompt(idOrSlug) {
2452
+ const prompt = getPrompt(idOrSlug);
2453
+ if (!prompt)
2454
+ throw new PromptNotFoundError(idOrSlug);
2455
+ return prompt;
2456
+ }
2457
+ function listPrompts(filter = {}) {
2458
+ const db = getDatabase();
2459
+ const conditions = [];
2460
+ const params = [];
2461
+ if (filter.collection) {
2462
+ conditions.push("collection = ?");
2463
+ params.push(filter.collection);
2464
+ }
2465
+ if (filter.is_template !== undefined) {
2466
+ conditions.push("is_template = ?");
2467
+ params.push(filter.is_template ? 1 : 0);
2468
+ }
2469
+ if (filter.source) {
2470
+ conditions.push("source = ?");
2471
+ params.push(filter.source);
2472
+ }
2473
+ if (filter.tags && filter.tags.length > 0) {
2474
+ const tagConditions = filter.tags.map(() => "tags LIKE ?");
2475
+ conditions.push(`(${tagConditions.join(" OR ")})`);
2476
+ for (const tag of filter.tags) {
2477
+ params.push(`%"${tag}"%`);
2478
+ }
2479
+ }
2480
+ const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
2481
+ const limit = filter.limit ?? 100;
2482
+ const offset = filter.offset ?? 0;
2483
+ const rows = db.query(`SELECT * FROM prompts ${where} ORDER BY use_count DESC, updated_at DESC LIMIT ? OFFSET ?`).all([...params, limit, offset]);
2484
+ return rows.map(rowToPrompt);
2485
+ }
2486
+ function updatePrompt(idOrSlug, input) {
2487
+ const db = getDatabase();
2488
+ const prompt = requirePrompt(idOrSlug);
2489
+ const newBody = input.body ?? prompt.body;
2490
+ const vars = extractVariables(newBody);
2491
+ const variables = JSON.stringify(vars.map((v) => ({ name: v, required: true })));
2492
+ const is_template = vars.length > 0 ? 1 : 0;
2493
+ const updated = db.run(`UPDATE prompts SET
2494
+ title = COALESCE(?, title),
2495
+ body = COALESCE(?, body),
2496
+ description = COALESCE(?, description),
2497
+ collection = COALESCE(?, collection),
2498
+ tags = COALESCE(?, tags),
2499
+ variables = ?,
2500
+ is_template = ?,
2501
+ version = version + 1,
2502
+ updated_at = datetime('now')
2503
+ WHERE id = ? AND version = ?`, [
2504
+ input.title ?? null,
2505
+ input.body ?? null,
2506
+ input.description ?? null,
2507
+ input.collection ?? null,
2508
+ input.tags ? JSON.stringify(input.tags) : null,
2509
+ variables,
2510
+ is_template,
2511
+ prompt.id,
2512
+ prompt.version
2513
+ ]);
2514
+ if (updated.changes === 0)
2515
+ throw new VersionConflictError(prompt.id);
2516
+ if (input.body && input.body !== prompt.body) {
2517
+ db.run(`INSERT INTO prompt_versions (id, prompt_id, body, version, changed_by)
2518
+ VALUES (?, ?, ?, ?, ?)`, [generateId("VER"), prompt.id, input.body, prompt.version + 1, input.changed_by ?? null]);
2519
+ }
2520
+ return requirePrompt(prompt.id);
2521
+ }
2522
+ function deletePrompt(idOrSlug) {
2523
+ const db = getDatabase();
2524
+ const prompt = requirePrompt(idOrSlug);
2525
+ db.run("DELETE FROM prompts WHERE id = ?", [prompt.id]);
2526
+ }
2527
+ function usePrompt(idOrSlug) {
2528
+ const db = getDatabase();
2529
+ const prompt = requirePrompt(idOrSlug);
2530
+ db.run("UPDATE prompts SET use_count = use_count + 1, last_used_at = datetime('now') WHERE id = ?", [prompt.id]);
2531
+ return requirePrompt(prompt.id);
2532
+ }
2533
+ function upsertPrompt(input) {
2534
+ const db = getDatabase();
2535
+ const slug = input.slug || generateSlug(input.title);
2536
+ const existing = db.query("SELECT id FROM prompts WHERE slug = ?").get(slug);
2537
+ if (existing) {
2538
+ const prompt2 = updatePrompt(existing.id, {
2539
+ title: input.title,
2540
+ body: input.body,
2541
+ description: input.description,
2542
+ collection: input.collection,
2543
+ tags: input.tags,
2544
+ changed_by: input.changed_by
2545
+ });
2546
+ return { prompt: prompt2, created: false };
2547
+ }
2548
+ const prompt = createPrompt({ ...input, slug });
2549
+ return { prompt, created: true };
2550
+ }
2551
+ function getPromptStats() {
2552
+ const db = getDatabase();
2553
+ const total = db.query("SELECT COUNT(*) as n FROM prompts").get().n;
2554
+ const templates = db.query("SELECT COUNT(*) as n FROM prompts WHERE is_template = 1").get().n;
2555
+ const collections = db.query("SELECT COUNT(DISTINCT collection) as n FROM prompts").get().n;
2556
+ const mostUsed = db.query("SELECT id, name, slug, title, use_count FROM prompts WHERE use_count > 0 ORDER BY use_count DESC LIMIT 10").all();
2557
+ const recentlyUsed = db.query("SELECT id, name, slug, title, last_used_at FROM prompts WHERE last_used_at IS NOT NULL ORDER BY last_used_at DESC LIMIT 10").all();
2558
+ const byCollection = db.query("SELECT collection, COUNT(*) as count FROM prompts GROUP BY collection ORDER BY count DESC").all();
2559
+ const bySource = db.query("SELECT source, COUNT(*) as count FROM prompts GROUP BY source ORDER BY count DESC").all();
2560
+ return { total_prompts: total, total_templates: templates, total_collections: collections, most_used: mostUsed, recently_used: recentlyUsed, by_collection: byCollection, by_source: bySource };
2561
+ }
2562
+
2563
+ // src/db/versions.ts
2564
+ function rowToVersion(row) {
2565
+ return {
2566
+ id: row["id"],
2567
+ prompt_id: row["prompt_id"],
2568
+ body: row["body"],
2569
+ version: row["version"],
2570
+ changed_by: row["changed_by"] ?? null,
2571
+ created_at: row["created_at"]
2572
+ };
2573
+ }
2574
+ function listVersions(promptId) {
2575
+ const db = getDatabase();
2576
+ const rows = db.query("SELECT * FROM prompt_versions WHERE prompt_id = ? ORDER BY version DESC").all(promptId);
2577
+ return rows.map(rowToVersion);
2578
+ }
2579
+ function getVersion(promptId, version) {
2580
+ const db = getDatabase();
2581
+ const row = db.query("SELECT * FROM prompt_versions WHERE prompt_id = ? AND version = ?").get(promptId, version);
2582
+ if (!row)
2583
+ return null;
2584
+ return rowToVersion(row);
2585
+ }
2586
+ function restoreVersion(promptId, version, changedBy) {
2587
+ const db = getDatabase();
2588
+ const ver = getVersion(promptId, version);
2589
+ if (!ver)
2590
+ throw new PromptNotFoundError(`${promptId}@v${version}`);
2591
+ const current = db.query("SELECT version FROM prompts WHERE id = ?").get(promptId);
2592
+ if (!current)
2593
+ throw new PromptNotFoundError(promptId);
2594
+ const newVersion = current.version + 1;
2595
+ db.run(`UPDATE prompts SET body = ?, version = ?, updated_at = datetime('now'),
2596
+ is_template = (CASE WHEN body LIKE '%{{%' THEN 1 ELSE 0 END)
2597
+ WHERE id = ?`, [ver.body, newVersion, promptId]);
2598
+ db.run(`INSERT INTO prompt_versions (id, prompt_id, body, version, changed_by)
2599
+ VALUES (?, ?, ?, ?, ?)`, [generateId("VER"), promptId, ver.body, newVersion, changedBy ?? null]);
2600
+ }
2601
+
2602
+ // src/lib/search.ts
2603
+ function rowToSearchResult(row, snippet) {
2604
+ return {
2605
+ prompt: {
2606
+ id: row["id"],
2607
+ name: row["name"],
2608
+ slug: row["slug"],
2609
+ title: row["title"],
2610
+ body: row["body"],
2611
+ description: row["description"] ?? null,
2612
+ collection: row["collection"],
2613
+ tags: JSON.parse(row["tags"] || "[]"),
2614
+ variables: JSON.parse(row["variables"] || "[]"),
2615
+ is_template: Boolean(row["is_template"]),
2616
+ source: row["source"],
2617
+ version: row["version"],
2618
+ use_count: row["use_count"],
2619
+ last_used_at: row["last_used_at"] ?? null,
2620
+ created_at: row["created_at"],
2621
+ updated_at: row["updated_at"]
2622
+ },
2623
+ score: row["score"] ?? 1,
2624
+ snippet
2625
+ };
2626
+ }
2627
+ function escapeFtsQuery(q) {
2628
+ return q.trim().split(/\s+/).filter(Boolean).map((w) => `"${w.replace(/"/g, '""')}"*`).join(" ");
2629
+ }
2630
+ function searchPrompts(query, filter = {}) {
2631
+ const db = getDatabase();
2632
+ if (!query.trim()) {
2633
+ const prompts = listPrompts(filter);
2634
+ return prompts.map((p) => ({ prompt: p, score: 1 }));
2635
+ }
2636
+ if (hasFts(db)) {
2637
+ const ftsQuery = escapeFtsQuery(query);
2638
+ const conditions = [];
2639
+ const params = [];
2640
+ if (filter.collection) {
2641
+ conditions.push("p.collection = ?");
2642
+ params.push(filter.collection);
2643
+ }
2644
+ if (filter.is_template !== undefined) {
2645
+ conditions.push("p.is_template = ?");
2646
+ params.push(filter.is_template ? 1 : 0);
2647
+ }
2648
+ if (filter.source) {
2649
+ conditions.push("p.source = ?");
2650
+ params.push(filter.source);
2651
+ }
2652
+ if (filter.tags && filter.tags.length > 0) {
2653
+ const tagConds = filter.tags.map(() => "p.tags LIKE ?");
2654
+ conditions.push(`(${tagConds.join(" OR ")})`);
2655
+ for (const tag of filter.tags)
2656
+ params.push(`%"${tag}"%`);
2657
+ }
2658
+ const where = conditions.length > 0 ? `AND ${conditions.join(" AND ")}` : "";
2659
+ const limit = filter.limit ?? 50;
2660
+ const offset = filter.offset ?? 0;
2661
+ try {
2662
+ const rows2 = db.query(`SELECT p.*, bm25(prompts_fts) as score,
2663
+ snippet(prompts_fts, 2, '[', ']', '...', 10) as snippet
2664
+ FROM prompts p
2665
+ INNER JOIN prompts_fts ON prompts_fts.rowid = p.rowid
2666
+ WHERE prompts_fts MATCH ?
2667
+ ${where}
2668
+ ORDER BY bm25(prompts_fts)
2669
+ LIMIT ? OFFSET ?`).all([ftsQuery, ...params, limit, offset]);
2670
+ return rows2.map((r) => rowToSearchResult(r, r["snippet"]));
2671
+ } catch {}
2672
+ }
2673
+ const like = `%${query}%`;
2674
+ const rows = db.query(`SELECT *, 1 as score FROM prompts
2675
+ WHERE (name LIKE ? OR slug LIKE ? OR title LIKE ? OR body LIKE ? OR description LIKE ? OR tags LIKE ?)
2676
+ ORDER BY use_count DESC, updated_at DESC
2677
+ LIMIT ? OFFSET ?`).all([like, like, like, like, like, like, filter.limit ?? 50, filter.offset ?? 0]);
2678
+ return rows.map((r) => rowToSearchResult(r));
2679
+ }
2680
+
2681
+ // src/lib/importer.ts
2682
+ function importFromJson(items, changedBy) {
2683
+ let created = 0;
2684
+ let updated = 0;
2685
+ const errors = [];
2686
+ for (const item of items) {
2687
+ try {
2688
+ const input = {
2689
+ title: item.title,
2690
+ body: item.body,
2691
+ slug: item.slug,
2692
+ description: item.description,
2693
+ collection: item.collection,
2694
+ tags: item.tags,
2695
+ source: "imported",
2696
+ changed_by: changedBy
2697
+ };
2698
+ const { created: wasCreated } = upsertPrompt(input);
2699
+ if (wasCreated)
2700
+ created++;
2701
+ else
2702
+ updated++;
2703
+ } catch (e) {
2704
+ errors.push({ item: item.title, error: e instanceof Error ? e.message : String(e) });
2705
+ }
2706
+ }
2707
+ return { created, updated, errors };
2708
+ }
2709
+ function exportToJson(collection) {
2710
+ const prompts = listPrompts({ collection, limit: 1e4 });
2711
+ return { prompts, exported_at: new Date().toISOString(), collection };
2712
+ }
2713
+
2714
+ // src/cli/index.tsx
2715
+ var require2 = createRequire(import.meta.url);
2716
+ var pkg = require2("../../package.json");
2717
+ var program2 = new Command().name("open-prompts").version(pkg.version).description("Reusable prompt library \u2014 save, search, render prompts from any AI session").option("--json", "Output as JSON");
2718
+ function isJson() {
2719
+ return Boolean(program2.opts()["json"]);
2720
+ }
2721
+ function output(data) {
2722
+ if (isJson()) {
2723
+ console.log(JSON.stringify(data, null, 2));
2724
+ } else {
2725
+ console.log(data);
2726
+ }
2727
+ }
2728
+ function handleError(e) {
2729
+ const msg = e instanceof Error ? e.message : String(e);
2730
+ if (isJson()) {
2731
+ console.log(JSON.stringify({ error: msg }));
2732
+ } else {
2733
+ console.error(chalk.red("Error: " + msg));
2734
+ }
2735
+ process.exit(1);
2736
+ }
2737
+ function fmtPrompt(p) {
2738
+ const tags = p.tags.length > 0 ? chalk.gray(` [${p.tags.join(", ")}]`) : "";
2739
+ const template = p.is_template ? chalk.cyan(" \u25C7") : "";
2740
+ return `${chalk.bold(p.id)} ${chalk.green(p.slug)}${template} ${p.title}${tags} ${chalk.gray(p.collection)}`;
2741
+ }
2742
+ program2.command("save <title>").description("Save a new prompt (or update existing by slug)").option("-b, --body <body>", "Prompt body (use - to read from stdin)").option("-f, --file <path>", "Read body from file").option("-s, --slug <slug>", "Custom slug").option("-d, --description <desc>", "Short description").option("-c, --collection <name>", "Collection", "default").option("-t, --tags <tags>", "Comma-separated tags").option("--source <source>", "Source: manual|ai-session|imported", "manual").option("--agent <name>", "Agent name (for attribution)").action(async (title, opts) => {
2743
+ try {
2744
+ let body = opts["body"] ?? "";
2745
+ if (opts["file"]) {
2746
+ const { readFileSync } = await import("fs");
2747
+ body = readFileSync(opts["file"], "utf-8");
2748
+ } else if (opts["body"] === "-" || !opts["body"] && !opts["file"]) {
2749
+ const chunks = [];
2750
+ for await (const chunk of process.stdin)
2751
+ chunks.push(chunk);
2752
+ body = Buffer.concat(chunks).toString("utf-8").trim();
2753
+ }
2754
+ if (!body)
2755
+ handleError("No body provided. Use --body, --file, or pipe via stdin.");
2756
+ const { prompt, created } = upsertPrompt({
2757
+ title,
2758
+ body,
2759
+ slug: opts["slug"],
2760
+ description: opts["description"],
2761
+ collection: opts["collection"],
2762
+ tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : [],
2763
+ source: opts["source"] || "manual",
2764
+ changed_by: opts["agent"]
2765
+ });
2766
+ if (isJson()) {
2767
+ output(prompt);
2768
+ } else {
2769
+ const action = created ? chalk.green("Created") : chalk.yellow("Updated");
2770
+ console.log(`${action} ${chalk.bold(prompt.id)} \u2014 ${chalk.green(prompt.slug)}`);
2771
+ console.log(chalk.gray(` Title: ${prompt.title}`));
2772
+ console.log(chalk.gray(` Collection: ${prompt.collection}`));
2773
+ if (prompt.is_template) {
2774
+ const vars = extractVariableInfo(prompt.body);
2775
+ console.log(chalk.cyan(` Template vars: ${vars.map((v) => v.name).join(", ")}`));
2776
+ }
2777
+ }
2778
+ } catch (e) {
2779
+ handleError(e);
2780
+ }
2781
+ });
2782
+ program2.command("use <id>").description("Get a prompt's body and increment its use counter").action((id) => {
2783
+ try {
2784
+ const prompt = usePrompt(id);
2785
+ if (isJson()) {
2786
+ output(prompt);
2787
+ } else {
2788
+ console.log(prompt.body);
2789
+ }
2790
+ } catch (e) {
2791
+ handleError(e);
2792
+ }
2793
+ });
2794
+ program2.command("get <id>").description("Get prompt details without incrementing use counter").action((id) => {
2795
+ try {
2796
+ const prompt = getPrompt(id);
2797
+ if (!prompt)
2798
+ handleError(`Prompt not found: ${id}`);
2799
+ output(isJson() ? prompt : fmtPrompt(prompt));
2800
+ } catch (e) {
2801
+ handleError(e);
2802
+ }
2803
+ });
2804
+ program2.command("list").description("List prompts").option("-c, --collection <name>", "Filter by collection").option("-t, --tags <tags>", "Filter by tags (comma-separated)").option("--templates", "Show only templates").option("-n, --limit <n>", "Max results", "50").action((opts) => {
2805
+ try {
2806
+ const prompts = listPrompts({
2807
+ collection: opts["collection"],
2808
+ tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : undefined,
2809
+ is_template: opts["templates"] ? true : undefined,
2810
+ limit: parseInt(opts["limit"]) || 50
2811
+ });
2812
+ if (isJson()) {
2813
+ output(prompts);
2814
+ } else if (prompts.length === 0) {
2815
+ console.log(chalk.gray("No prompts found."));
2816
+ } else {
2817
+ for (const p of prompts)
2818
+ console.log(fmtPrompt(p));
2819
+ console.log(chalk.gray(`
2820
+ ${prompts.length} prompt(s)`));
2821
+ }
2822
+ } catch (e) {
2823
+ handleError(e);
2824
+ }
2825
+ });
2826
+ program2.command("search <query>").description("Full-text search across prompts (FTS5)").option("-c, --collection <name>").option("-t, --tags <tags>").option("-n, --limit <n>", "Max results", "20").action((query, opts) => {
2827
+ try {
2828
+ const results = searchPrompts(query, {
2829
+ collection: opts["collection"],
2830
+ tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : undefined,
2831
+ limit: parseInt(opts["limit"]) || 20
2832
+ });
2833
+ if (isJson()) {
2834
+ output(results);
2835
+ } else if (results.length === 0) {
2836
+ console.log(chalk.gray("No results."));
2837
+ } else {
2838
+ for (const r of results) {
2839
+ console.log(fmtPrompt(r.prompt));
2840
+ if (r.snippet)
2841
+ console.log(chalk.gray(" " + r.snippet));
2842
+ }
2843
+ console.log(chalk.gray(`
2844
+ ${results.length} result(s)`));
2845
+ }
2846
+ } catch (e) {
2847
+ handleError(e);
2848
+ }
2849
+ });
2850
+ program2.command("render <id>").description("Render a template prompt by filling in {{variables}}").option("-v, --var <assignments...>", "Variable assignments as key=value").action((id, opts) => {
2851
+ try {
2852
+ const prompt = usePrompt(id);
2853
+ const vars = {};
2854
+ for (const assignment of opts.var ?? []) {
2855
+ const eq = assignment.indexOf("=");
2856
+ if (eq === -1)
2857
+ handleError(`Invalid var format: ${assignment}. Use key=value`);
2858
+ vars[assignment.slice(0, eq)] = assignment.slice(eq + 1);
2859
+ }
2860
+ const result = renderTemplate(prompt.body, vars);
2861
+ if (isJson()) {
2862
+ output(result);
2863
+ } else {
2864
+ console.log(result.rendered);
2865
+ if (result.missing_vars.length > 0)
2866
+ console.error(chalk.yellow(`
2867
+ Warning: missing vars: ${result.missing_vars.join(", ")}`));
2868
+ if (result.used_defaults.length > 0)
2869
+ console.error(chalk.gray(`Used defaults: ${result.used_defaults.join(", ")}`));
2870
+ }
2871
+ } catch (e) {
2872
+ handleError(e);
2873
+ }
2874
+ });
2875
+ program2.command("templates").description("List template prompts").option("-c, --collection <name>").action((opts) => {
2876
+ try {
2877
+ const prompts = listPrompts({ is_template: true, collection: opts["collection"] });
2878
+ if (isJson()) {
2879
+ output(prompts);
2880
+ } else if (prompts.length === 0) {
2881
+ console.log(chalk.gray("No templates found."));
2882
+ } else {
2883
+ for (const p of prompts) {
2884
+ const vars = extractVariableInfo(p.body);
2885
+ console.log(fmtPrompt(p));
2886
+ console.log(chalk.cyan(` vars: ${vars.map((v) => v.required ? v.name : `${v.name}?`).join(", ")}`));
2887
+ }
2888
+ }
2889
+ } catch (e) {
2890
+ handleError(e);
2891
+ }
2892
+ });
2893
+ program2.command("inspect <id>").description("Show a prompt's variables (for templates)").action((id) => {
2894
+ try {
2895
+ const prompt = getPrompt(id);
2896
+ if (!prompt)
2897
+ handleError(`Prompt not found: ${id}`);
2898
+ const vars = extractVariableInfo(prompt.body);
2899
+ if (isJson()) {
2900
+ output(vars);
2901
+ } else if (vars.length === 0) {
2902
+ console.log(chalk.gray("No template variables found."));
2903
+ } else {
2904
+ console.log(chalk.bold(`Variables for ${prompt.slug}:`));
2905
+ for (const v of vars) {
2906
+ const req = v.required ? chalk.red("required") : chalk.green("optional");
2907
+ const def = v.default !== null ? chalk.gray(` (default: "${v.default}")`) : "";
2908
+ console.log(` ${chalk.bold(v.name)} ${req}${def}`);
2909
+ }
2910
+ }
2911
+ } catch (e) {
2912
+ handleError(e);
2913
+ }
2914
+ });
2915
+ program2.command("update <id>").description("Update a prompt's fields").option("--title <title>").option("-b, --body <body>").option("-d, --description <desc>").option("-c, --collection <name>").option("-t, --tags <tags>").option("--agent <name>").action((id, opts) => {
2916
+ try {
2917
+ const prompt = updatePrompt(id, {
2918
+ title: opts["title"],
2919
+ body: opts["body"],
2920
+ description: opts["description"],
2921
+ collection: opts["collection"],
2922
+ tags: opts["tags"] ? opts["tags"].split(",").map((t) => t.trim()) : undefined,
2923
+ changed_by: opts["agent"]
2924
+ });
2925
+ if (isJson())
2926
+ output(prompt);
2927
+ else
2928
+ console.log(`${chalk.yellow("Updated")} ${chalk.bold(prompt.id)} \u2014 ${chalk.green(prompt.slug)}`);
2929
+ } catch (e) {
2930
+ handleError(e);
2931
+ }
2932
+ });
2933
+ program2.command("delete <id>").description("Delete a prompt").option("-y, --yes", "Skip confirmation").action(async (id, opts) => {
2934
+ try {
2935
+ const prompt = getPrompt(id);
2936
+ if (!prompt)
2937
+ handleError(`Prompt not found: ${id}`);
2938
+ if (!opts.yes && !isJson()) {
2939
+ const { createInterface } = await import("readline");
2940
+ const rl = createInterface({ input: process.stdin, output: process.stdout });
2941
+ await new Promise((resolve) => {
2942
+ rl.question(chalk.yellow(`Delete "${prompt.slug}"? [y/N] `), (ans) => {
2943
+ rl.close();
2944
+ if (ans.toLowerCase() !== "y") {
2945
+ console.log("Cancelled.");
2946
+ process.exit(0);
2947
+ }
2948
+ resolve();
2949
+ });
2950
+ });
2951
+ }
2952
+ deletePrompt(id);
2953
+ if (isJson())
2954
+ output({ deleted: true, id: prompt.id });
2955
+ else
2956
+ console.log(chalk.red(`Deleted ${prompt.slug}`));
2957
+ } catch (e) {
2958
+ handleError(e);
2959
+ }
2960
+ });
2961
+ program2.command("history <id>").description("Show version history for a prompt").action((id) => {
2962
+ try {
2963
+ const prompt = getPrompt(id);
2964
+ if (!prompt)
2965
+ handleError(`Prompt not found: ${id}`);
2966
+ const versions = listVersions(prompt.id);
2967
+ if (isJson()) {
2968
+ output(versions);
2969
+ } else {
2970
+ console.log(chalk.bold(`Version history for ${prompt.slug}:`));
2971
+ for (const v of versions) {
2972
+ const current = v.version === prompt.version ? chalk.green(" \u2190 current") : "";
2973
+ const by = v.changed_by ? chalk.gray(` by ${v.changed_by}`) : "";
2974
+ console.log(` v${v.version} ${chalk.gray(v.created_at)}${by}${current}`);
2975
+ }
2976
+ }
2977
+ } catch (e) {
2978
+ handleError(e);
2979
+ }
2980
+ });
2981
+ program2.command("restore <id> <version>").description("Restore a prompt to a previous version").option("--agent <name>").action((id, version, opts) => {
2982
+ try {
2983
+ const prompt = getPrompt(id);
2984
+ if (!prompt)
2985
+ handleError(`Prompt not found: ${id}`);
2986
+ restoreVersion(prompt.id, parseInt(version), opts["agent"]);
2987
+ if (isJson())
2988
+ output({ restored: true, id: prompt.id, version: parseInt(version) });
2989
+ else
2990
+ console.log(chalk.green(`Restored ${prompt.slug} to v${version}`));
2991
+ } catch (e) {
2992
+ handleError(e);
2993
+ }
2994
+ });
2995
+ program2.command("collections").description("List all collections").action(() => {
2996
+ try {
2997
+ const cols = listCollections();
2998
+ if (isJson()) {
2999
+ output(cols);
3000
+ } else {
3001
+ for (const c of cols) {
3002
+ console.log(`${chalk.bold(c.name)} ${chalk.gray(`${c.prompt_count} prompt(s)`)}`);
3003
+ if (c.description)
3004
+ console.log(chalk.gray(" " + c.description));
3005
+ }
3006
+ }
3007
+ } catch (e) {
3008
+ handleError(e);
3009
+ }
3010
+ });
3011
+ program2.command("move <id> <collection>").description("Move a prompt to a different collection").action((id, collection) => {
3012
+ try {
3013
+ movePrompt(id, collection);
3014
+ if (isJson())
3015
+ output({ moved: true, id, collection });
3016
+ else
3017
+ console.log(`${chalk.green("Moved")} ${id} \u2192 ${chalk.bold(collection)}`);
3018
+ } catch (e) {
3019
+ handleError(e);
3020
+ }
3021
+ });
3022
+ program2.command("export").description("Export prompts as JSON").option("-c, --collection <name>").option("-o, --output <file>", "Write to file instead of stdout").action(async (opts) => {
3023
+ try {
3024
+ const data = exportToJson(opts["collection"]);
3025
+ const json = JSON.stringify(data, null, 2);
3026
+ if (opts["output"]) {
3027
+ const { writeFileSync } = await import("fs");
3028
+ writeFileSync(opts["output"], json);
3029
+ console.log(chalk.green(`Exported ${data.prompts.length} prompt(s) to ${opts["output"]}`));
3030
+ } else {
3031
+ console.log(json);
3032
+ }
3033
+ } catch (e) {
3034
+ handleError(e);
3035
+ }
3036
+ });
3037
+ program2.command("import <file>").description("Import prompts from a JSON file").option("--agent <name>").action(async (file, opts) => {
3038
+ try {
3039
+ const { readFileSync } = await import("fs");
3040
+ const raw = JSON.parse(readFileSync(file, "utf-8"));
3041
+ const items = Array.isArray(raw) ? raw : raw.prompts ?? [];
3042
+ const results = importFromJson(items, opts["agent"]);
3043
+ if (isJson())
3044
+ output(results);
3045
+ else {
3046
+ console.log(chalk.green(`Created: ${results.created}, Updated: ${results.updated}`));
3047
+ if (results.errors.length > 0) {
3048
+ console.error(chalk.red(`Errors: ${results.errors.length}`));
3049
+ for (const e of results.errors)
3050
+ console.error(chalk.red(` ${e.item}: ${e.error}`));
3051
+ }
3052
+ }
3053
+ } catch (e) {
3054
+ handleError(e);
3055
+ }
3056
+ });
3057
+ program2.command("stats").description("Show usage statistics").action(() => {
3058
+ try {
3059
+ const stats = getPromptStats();
3060
+ if (isJson()) {
3061
+ output(stats);
3062
+ } else {
3063
+ console.log(chalk.bold("Prompt Stats"));
3064
+ console.log(` Total: ${stats.total_prompts} Templates: ${stats.total_templates} Collections: ${stats.total_collections}`);
3065
+ if (stats.most_used.length > 0) {
3066
+ console.log(chalk.bold(`
3067
+ Most used:`));
3068
+ for (const p of stats.most_used)
3069
+ console.log(` ${chalk.green(p.slug)} ${chalk.gray(`${p.use_count}\xD7`)}`);
3070
+ }
3071
+ if (stats.by_collection.length > 0) {
3072
+ console.log(chalk.bold(`
3073
+ By collection:`));
3074
+ for (const c of stats.by_collection)
3075
+ console.log(` ${chalk.bold(c.collection)} ${chalk.gray(`${c.count}`)}`);
3076
+ }
3077
+ }
3078
+ } catch (e) {
3079
+ handleError(e);
3080
+ }
3081
+ });
3082
+ program2.parse();