@namzu/cli 29.0.1 → 30.0.0

package/dist/schedule/commands/args.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `namzu schedule <verb>` arguments: `--flag value`, `--flag=value`,
+ * repeatable flags and positionals, parsed without a library so every verb
+ * reports an unknown flag by name.
+ */
+import { type SchedulePaths } from '../paths.js';
+export interface ParsedArgs {
+    readonly positionals: string[];
+    readonly flags: Map<string, string[]>;
+    readonly unknown: string[];
+}
+/** Parse `argv` against the flags this verb takes: `name` (value) or `name!` (boolean). */
+export declare function parseArgs(argv: readonly string[], spec: readonly string[]): ParsedArgs;
+export declare function flag(args: ParsedArgs, name: string): string | undefined;
+export declare function has(args: ParsedArgs, name: string): boolean;
+/** `--home` wins over `NAMZU_HOME` and the default. */
+export declare function pathsFor(args: ParsedArgs): SchedulePaths;
+/** `90s`, `30m`, `2h`, `1d` or plain milliseconds. */
+export declare function parseMs(label: string, text: string | undefined): number | undefined;
+export declare function parseCount(label: string, text: string | undefined): number | undefined;
+export declare function interactive(): boolean;
+//# sourceMappingURL=args.d.ts.map

package/dist/schedule/commands/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../../src/schedule/commands/args.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,KAAK,aAAa,EAAiB,MAAM,aAAa,CAAA;AAE/D,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAmCtF;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,uDAAuD;AACvD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,CAGxD;AAED,sDAAsD;AACtD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAQnF;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMtF;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/schedule/commands/args.js

@@ -0,0 +1,80 @@
+/**
+ * `namzu schedule <verb>` arguments: `--flag value`, `--flag=value`,
+ * repeatable flags and positionals, parsed without a library so every verb
+ * reports an unknown flag by name.
+ */
+import { resolve } from 'node:path';
+import { resolveNamzuHome } from '../../integrations/state/home.js';
+import { schedulePaths } from '../paths.js';
+/** Parse `argv` against the flags this verb takes: `name` (value) or `name!` (boolean). */
+export function parseArgs(argv, spec) {
+    const takesValue = new Set(spec.filter((s) => !s.endsWith('!')));
+    const booleans = new Set(spec.filter((s) => s.endsWith('!')).map((s) => s.slice(0, -1)));
+    const flags = new Map();
+    const positionals = [];
+    const unknown = [];
+    let onlyPositionals = false;
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (onlyPositionals || !arg.startsWith('--') || arg === '--') {
+            if (arg === '--' && !onlyPositionals) {
+                onlyPositionals = true;
+                continue;
+            }
+            positionals.push(arg);
+            continue;
+        }
+        const eq = arg.indexOf('=');
+        const name = arg.slice(2, eq > 0 ? eq : undefined);
+        if (booleans.has(name)) {
+            flags.set(name, ['true']);
+            continue;
+        }
+        if (!takesValue.has(name)) {
+            unknown.push(arg);
+            continue;
+        }
+        const value = eq > 0 ? arg.slice(eq + 1) : argv[++i];
+        if (value === undefined) {
+            unknown.push(`${arg} (needs a value)`);
+            continue;
+        }
+        flags.set(name, [...(flags.get(name) ?? []), value]);
+    }
+    return { positionals, flags, unknown };
+}
+export function flag(args, name) {
+    return args.flags.get(name)?.at(-1);
+}
+export function has(args, name) {
+    return args.flags.has(name);
+}
+/** `--home` wins over `NAMZU_HOME` and the default. */
+export function pathsFor(args) {
+    const home = flag(args, 'home');
+    return schedulePaths(home ? resolve(home) : resolveNamzuHome());
+}
+/** `90s`, `30m`, `2h`, `1d` or plain milliseconds. */
+export function parseMs(label, text) {
+    if (text === undefined)
+        return undefined;
+    const match = /^(\d+)(ms|s|m|h|d)?$/.exec(text.trim());
+    if (!match)
+        throw new Error(`${label}: "${text}" is not a duration (write 90s, 30m, 2h, 1d)`);
+    const n = Number(match[1]);
+    const unit = match[2] ?? 'ms';
+    const scale = { ms: 1, s: 1_000, m: 60_000, h: 3_600_000, d: 86_400_000 };
+    return n * (scale[unit] ?? 1);
+}
+export function parseCount(label, text) {
+    if (text === undefined)
+        return undefined;
+    const n = Number(text.replaceAll('_', ''));
+    if (!Number.isSafeInteger(n) || n < 0)
+        throw new Error(`${label}: "${text}" is not a whole number`);
+    return n;
+}
+export function interactive() {
+    return Boolean(process.stdin.isTTY && process.stderr.isTTY);
+}
+//# sourceMappingURL=args.js.map

package/dist/schedule/commands/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../../src/schedule/commands/args.ts"],"names":[],"mappings":"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"}

package/dist/schedule/commands/confirm-prompt.d.ts

@@ -0,0 +1,6 @@
+/**
+ * A yes/no question on the terminal, for confirmations that must come from
+ * a person at a keyboard. Default no.
+ */
+export declare function askYesNo(question: string): Promise<boolean>;
+//# sourceMappingURL=confirm-prompt.d.ts.map

package/dist/schedule/commands/confirm-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-prompt.d.ts","sourceRoot":"","sources":["../../../src/schedule/commands/confirm-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3D"}

package/dist/schedule/commands/confirm-prompt.js

@@ -0,0 +1,21 @@
+/**
+ * A yes/no question on the terminal, for confirmations that must come from
+ * a person at a keyboard. Default no.
+ */
+import { createInterface } from 'node:readline';
+export function askYesNo(question) {
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stderr, terminal: true });
+        let answered = false;
+        rl.question(`${question} [y/N] `, (answer) => {
+            answered = true;
+            rl.close();
+            resolve(/^y(es)?$/i.test(answer.trim()));
+        });
+        rl.once('close', () => {
+            if (!answered)
+                resolve(false);
+        });
+    });
+}
+//# sourceMappingURL=confirm-prompt.js.map

package/dist/schedule/commands/confirm-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-prompt.js","sourceRoot":"","sources":["../../../src/schedule/commands/confirm-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAE/C,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACxC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5F,IAAI,QAAQ,GAAG,KAAK,CAAA;QACpB,EAAE,CAAC,QAAQ,CAAC,GAAG,QAAQ,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5C,QAAQ,GAAG,IAAI,CAAA;YACf,EAAE,CAAC,KAAK,EAAE,CAAA;YACV,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACzC,CAAC,CAAC,CAAA;QACF,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACrB,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,KAAK,CAAC,CAAA;QAC9B,CAAC,CAAC,CAAA;IACH,CAAC,CAAC,CAAA;AACH,CAAC"}

package/dist/schedule/commands/lifecycle.d.ts

@@ -0,0 +1,39 @@
+/**
+ * `schedule pause | resume | remove | run-now | prune`.
+ *
+ * Resuming does not catch up what came due while the job was paused: the
+ * resume is a definition change, and the evaluator counts from it.
+ */
+import type { CommandContext } from '../../commands/types.js';
+import { EXIT_UNAVAILABLE } from '../../exit-codes.js';
+import { type FireDependencies } from '../fire/fire.js';
+import type { SchedulePaths } from '../paths.js';
+import type { ScheduleJobState } from '../types.js';
+export declare function pauseCommand(ctx: CommandContext, argv: readonly string[], resume?: boolean): Promise<number>;
+export declare function removeCommand(ctx: CommandContext, argv: readonly string[]): Promise<number>;
+/**
+ * Record the end of a job's parked run that was answered elsewhere (the TUI)
+ * and has since finished, as a scheduler's tick would. A scheduler that
+ * answers is asked to look now instead; with none, it is settled here.
+ * Idempotent: a run is settled only while the job's state still names it as
+ * parked and its turn is over, so a scheduler settling it too finds nothing
+ * left. Returns the job's state afterwards, or `undefined` for no such job.
+ */
+export declare function settleAnsweredPark(paths: SchedulePaths, jobId: string): Promise<ScheduleJobState | undefined>;
+export declare function runNowCommand(ctx: CommandContext, argv: readonly string[], 
+/** Test seam: what the foreground run is given. */
+fireDeps?: Omit<FireDependencies, 'keepLogging'>): Promise<number>;
+/**
+ * `schedule prune`: list — and with `--delete`, remove — run files and the
+ * sessions of runs that ended before `--older-than` (default 30 days).
+ * Sessions of runs still parked are never touched.
+ *
+ * A removed job's runs are included (without `--job`): `remove` keeps its
+ * history and run files, and nothing else would ever reach them. Once none
+ * of its runs is left, its history goes too.
+ */
+export declare function pruneCommand(ctx: CommandContext, argv: readonly string[]): Promise<number>;
+/** The size of what the scheduler keeps, for `status`. */
+export declare function scheduleDiskUsage(root: string): number;
+export { EXIT_UNAVAILABLE };
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/schedule/commands/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/schedule/commands/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAW,gBAAgB,EAAc,MAAM,qBAAqB,CAAA;AAO3E,OAAO,EAAE,KAAK,gBAAgB,EAAW,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAahD,OAAO,KAAK,EAGX,gBAAgB,EAEhB,MAAM,aAAa,CAAA;AAIpB,wBAAsB,YAAY,CACjC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,UAAQ,GACZ,OAAO,CAAC,MAAM,CAAC,CA8CjB;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqEjG;AAgDD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACvC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAIvC;AAED,wBAAsB,aAAa,CAClC,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,SAAS,MAAM,EAAE;AACvB,mDAAmD;AACnD,QAAQ,GAAE,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAM,GAClD,OAAO,CAAC,MAAM,CAAC,CAoJjB;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoJhG;AAoFD,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}