@fnndsc/brasa 0.56.1 → 0.56.3

package/dist/builtins/sys/notes.js

@@ -9,7 +9,7 @@
  * disk the daemon runs from (a-readout-names-the-release-it-reads), groups
  * them by the day they were released, and answers a `session.notes` model
  * beneath the text. A change written "Internal: …" is ours alone and is
- * hidden unless `--all` asks.
+ * hidden unless `--all` asks. Declared in one record (`notesCommand`).
  *
  * @module
  */
@@ -18,6 +18,8 @@ import * as fs from 'node:fs';
 import path from 'node:path';
 import { SESSION_NOTES_MODEL_KIND, envelope_ok, envelope_error } from '@fnndsc/menu';
 import chalk from 'chalk';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 /** The packages whose notes an operator reads, in the order a release lists them. */
 export const NOTES_PACKAGES = ['@fnndsc/argus', '@fnndsc/brasa', '@fnndsc/chell', '@fnndsc/calypso', '@fnndsc/porter'];
 /** The default loader: node resolution from here, so a hoisted or nested install both answer. */
@@ -79,33 +81,66 @@ export function notes_gather(loader = notes_load) {
     const dated = [...byMerge.values()].sort((a, b) => (a.date < b.date ? 1 : a.date > b.date ? -1 : 0));
     return { releases: [...dated, ...undated], installed };
 }
-/** Reads the flags; a refusal names the flag. */
-export function notesArgs_parse(args) {
-    const ask = { since: 1, all: false, long: false };
-    for (let i = 0; i < args.length; i++) {
-        const a = args[i];
-        if (a === '--all' || a === '-a')
-            ask.all = true;
-        else if (a === '--long' || a === '-l')
-            ask.long = true;
-        else if (a === '--since' || a === '-s') {
-            const v = args[++i];
-            if (v === undefined)
-                return { refusal: 'notes: --since wants a count or a date (YYYY-MM-DD)' };
-            if (/^\d+$/.test(v))
-                ask.since = Number(v);
-            else if (/^\d{4}-\d{2}-\d{2}$/.test(v))
-                ask.since = v;
-            else
-                return { refusal: `notes: --since wants a count or a date (YYYY-MM-DD), not '${v}'` };
-        }
-        else if (a.startsWith('-'))
-            return { refusal: `notes: unknown flag '${a}' (--since N|DATE, --all, --long)` };
-        else
-            return { refusal: `notes: takes no argument '${a}' (--since N|DATE, --all, --long)` };
-    }
-    return ask;
+/** What a `notes` line may hold. */
+const NOTES_GRAMMAR = {
+    options: {
+        since: { short: 's', long: 'since', summary: 'The last N releases, or every release from a day (YYYY-MM-DD) on', value: { name: 'N|DATE', kind: 'word' } },
+        all: { short: 'a', long: 'all', summary: 'The changes marked Internal too' },
+        long: { short: 'l', long: 'long', summary: 'Each change unfolded beneath its first sentence' },
+    },
+};
+/**
+ * What the options ask for: `--since` read as a count or a day; a refusal
+ * names a value that is neither.
+ *
+ * @param options - The line's options.
+ * @returns The ask, or the refusal.
+ *
+ * @example
+ * ```ts
+ * notesAsk_make({ since: '3', all: true, long: false }); // { since: 3, all: true, long: false }
+ * ```
+ */
+export function notesAsk_make(options) {
+    const ask = { since: 1, all: options.all, long: options.long };
+    const since = options.since;
+    if (since === undefined)
+        return ask;
+    if (/^\d+$/.test(since))
+        return { ...ask, since: Number(since) };
+    if (/^\d{4}-\d{2}-\d{2}$/.test(since))
+        return { ...ask, since };
+    return { refusal: `notes: --since wants a count or a date (YYYY-MM-DD), not '${since}'` };
 }
+/**
+ * The `notes` declaration, reading the notes with a loader.
+ *
+ * @param loader - Reads one package's notes.
+ * @returns The declaration.
+ */
+function notesDeclaration_make(loader) {
+    return command_declare({
+        name: 'notes',
+        grammar: NOTES_GRAMMAR,
+        help: {
+            summary: 'What the installed releases changed, for the operator',
+            description: 'Reads the release notes shipped with the packages installed where this session runs — argus, brasa, chell, calypso, porter — and lists the newest release: one row per change, the package tagged. --since N shows the last N releases, --since DATE everything from a day on; --long unfolds each change beneath its first sentence; --all includes the changes marked Internal. help notes is the same. In ARGUS the WHAT\'S NEW block opens them as a listing.',
+            category: 'General',
+            examples: ['notes', 'notes --since 3', 'notes --since 2026-10-01 --long', 'notes --all'],
+        },
+        holds: [],
+        handler: async (args) => notes_run(args.options, loader),
+    });
+}
+/**
+ * `notes [--since N|DATE] [--all] [--long]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [notesCommand] });
+ * ```
+ */
+export const notesCommand = notesDeclaration_make(notes_load);
 /** The releases the ask selects, internal changes dropped unless asked for. */
 export function notes_select(releases, ask) {
     const chosen = typeof ask.since === 'number'
@@ -145,9 +180,35 @@ export function notes_render(releases, ask) {
     }
     return `${lines.join('\n')}\n`;
 }
-/** `notes [--since N|DATE] [--all] [--long]` */
+/**
+ * `notes` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `notes`.
+ * @param loader - Reads one package's notes; the installed packages' by default.
+ * @returns The notes, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_notes(['--since', '3']);
+ * ```
+ */
 export async function builtin_notes(args, loader = notes_load) {
-    const ask = notesArgs_parse(args);
+    return declaredCommand_run(loader === notes_load ? notesCommand : notesDeclaration_make(loader), args);
+}
+/**
+ * The notes the options ask for, as text over a `session.notes` model.
+ *
+ * @param options - The line's options.
+ * @param loader - Reads one package's notes.
+ * @returns The notes, or the refusal of a `--since` that is neither a count nor a day.
+ *
+ * @example
+ * ```ts
+ * await notes_run({ since: undefined, all: false, long: false }, notes_load);
+ * ```
+ */
+export async function notes_run(options, loader) {
+    const ask = notesAsk_make(options);
     if ('refusal' in ask)
         return envelope_error('', undefined, `${ask.refusal}\n`);
     const gathered = notes_gather(loader);

package/dist/builtins/sys/notes.js.map

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

package/dist/builtins/sys/physicalmode.d.ts

@@ -1,8 +1,29 @@
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
- * Toggles or displays physical filesystem mode.
+ * `physicalmode [on | off]`: the declaration.
  *
- * @param args - Command line arguments: 'on', 'off', or empty to display status.
- * @returns An envelope describing the (possibly updated) physical mode state.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [physicalmodeCommand] }, 'backend');
+ * ```
+ */
+export declare const physicalmodeCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly bare: {
+        readonly summary: "Show whether physical mode is on";
+    };
+    readonly subcommands: {
+        readonly on: {
+            readonly summary: "Enable physical mode (paths used directly)";
+        };
+        readonly off: {
+            readonly summary: "Disable physical mode (use logical-to-physical mapping)";
+        };
+    };
+}>;
+/**
+ * `physicalmode` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `physicalmode`.
+ * @returns The physical mode state, or the refusal of a bad line.
  */
 export declare function builtin_physicalmode(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/sys/physicalmode.js

@@ -1,19 +1,44 @@
 /**
- * @file Builtin physicalmode command.
- * Toggles physical filesystem mode, reported as a command envelope.
+ * @file `physicalmode`: shows or sets whether paths are used as CUBE stores
+ * them, past the logical-to-physical mapping.
+ *
+ * Declared in one record (`physicalmodeCommand`): `on` and `off` are its
+ * subcommands; with neither it says how it stands.
+ *
+ * Key components:
+ * - physicalmodeCommand: the declaration.
+ * - builtin_physicalmode: the declaration run over words already split.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_physicalmode(['on']);
+ * ```
+ *
+ * Dependencies: the session's physical-mode flag.
+ *
+ * @module
  */
 import chalk from 'chalk';
 import { session } from '../../session/index.js';
-import { envelope_ok, envelope_error } from '@fnndsc/menu';
+import { envelope_ok } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
+/** What a `physicalmode` line may hold. */
+const PHYSICALMODE_GRAMMAR = {
+    bare: { summary: 'Show whether physical mode is on' },
+    subcommands: {
+        on: { summary: 'Enable physical mode (paths used directly)' },
+        off: { summary: 'Disable physical mode (use logical-to-physical mapping)' },
+    },
+};
 /**
- * Toggles or displays physical filesystem mode.
+ * Shows or sets physical filesystem mode.
  *
- * @param args - Command line arguments: 'on', 'off', or empty to display status.
+ * @param args - The line, parsed: `on`, `off`, or neither.
  * @returns An envelope describing the (possibly updated) physical mode state.
  */
-export async function builtin_physicalmode(args) {
-    const subcommand = args[0];
-    if (!subcommand) {
+async function physicalmode_run(args) {
+    if (args.subcommand === null) {
         const enabled = session.physicalMode_get();
         const status = enabled ? 'enabled' : 'disabled';
         const detail = enabled
@@ -21,14 +46,43 @@ export async function builtin_physicalmode(args) {
             : chalk.gray('  Paths are resolved through logical-to-physical mapping.');
         return envelope_ok(`Physical filesystem mode: ${chalk.yellow(status)}\n${detail}\n${chalk.gray('\nUsage: physicalmode [on|off]')}\n`, { kind: 'sys.physicalMode', data: { enabled } });
     }
-    if (subcommand === 'on') {
+    if (args.subcommand === 'on') {
         session.physicalMode_set(true);
         return envelope_ok(`${chalk.yellow('[!] Physical filesystem mode enabled')}\n${chalk.gray('    Paths will be used directly without logical-to-physical mapping.')}\n`, { kind: 'sys.physicalMode', data: { enabled: true } });
     }
-    if (subcommand === 'off') {
-        session.physicalMode_set(false);
-        return envelope_ok(`${chalk.green('[+] Physical filesystem mode disabled')}\n${chalk.gray('    Paths will be resolved through logical-to-physical mapping.')}\n`, { kind: 'sys.physicalMode', data: { enabled: false } });
-    }
-    return envelope_error(`${chalk.red(`Unknown argument: ${subcommand}`)}\n${chalk.gray('Usage: physicalmode [on|off]')}\n`);
+    session.physicalMode_set(false);
+    return envelope_ok(`${chalk.green('[+] Physical filesystem mode disabled')}\n${chalk.gray('    Paths will be resolved through logical-to-physical mapping.')}\n`, { kind: 'sys.physicalMode', data: { enabled: false } });
+}
+/**
+ * `physicalmode [on | off]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [physicalmodeCommand] }, 'backend');
+ * ```
+ */
+export const physicalmodeCommand = command_declare({
+    name: 'physicalmode',
+    grammar: PHYSICALMODE_GRAMMAR,
+    help: {
+        summary: 'Toggle or display physical filesystem mode',
+        description: 'Shows whether paths are used directly, as CUBE stores them, or resolved through the logical-to-physical mapping; or turns physical mode on or off.',
+        category: 'Settings',
+        examples: [
+            'physicalmode          # Show current status',
+            'physicalmode on       # Enable physical mode',
+            'physicalmode off      # Disable physical mode',
+        ],
+    },
+    handler: physicalmode_run,
+});
+/**
+ * `physicalmode` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `physicalmode`.
+ * @returns The physical mode state, or the refusal of a bad line.
+ */
+export async function builtin_physicalmode(args) {
+    return declaredCommand_run(physicalmodeCommand, args);
 }
 //# sourceMappingURL=physicalmode.js.map

package/dist/builtins/sys/physicalmode.js.map

@@ -1 +1 @@
-{"version":3,"file":"physicalmode.js","sourceRoot":"","sources":["../../../src/builtins/sys/physicalmode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAc;IACvD,MAAM,UAAU,GAAuB,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,OAAO,GAAY,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACpD,MAAM,MAAM,GAAW,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QACxD,MAAM,MAAM,GAAW,OAAO;YAC5B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC;YAC9E,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC5E,OAAO,WAAW,CAChB,6BAA6B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,IAAI,EACjH,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,WAAW,CAChB,GAAG,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,IAAI,EAClJ,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CACtD,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChC,OAAO,WAAW,CAChB,GAAG,KAAK,CAAC,KAAK,CAAC,uCAAuC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,IAAI,EAC7I,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CACvD,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CACnB,GAAG,KAAK,CAAC,GAAG,CAAC,qBAAqB,UAAU,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CACnG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"physicalmode.js","sourceRoot":"","sources":["../../../src/builtins/sys/physicalmode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAmB,WAAW,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,eAAe,EAA8C,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,2CAA2C;AAC3C,MAAM,oBAAoB,GAAG;IAC3B,IAAI,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE;IACrD,WAAW,EAAE;QACX,EAAE,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE;QAC7D,GAAG,EAAE,EAAE,OAAO,EAAE,yDAAyD,EAAE;KAC5E;CACgC,CAAC;AAEpC;;;;;GAKG;AACH,KAAK,UAAU,gBAAgB,CAAC,IAAmD;IACjF,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAY,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACpD,MAAM,MAAM,GAAW,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QACxD,MAAM,MAAM,GAAW,OAAO;YAC5B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,gEAAgE,CAAC;YAC9E,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QAC5E,OAAO,WAAW,CAChB,6BAA6B,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,IAAI,EACjH,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC/B,OAAO,WAAW,CAChB,GAAG,KAAK,CAAC,MAAM,CAAC,sCAAsC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,sEAAsE,CAAC,IAAI,EAClJ,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CACtD,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO,WAAW,CAChB,GAAG,KAAK,CAAC,KAAK,CAAC,uCAAuC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,iEAAiE,CAAC,IAAI,EAC7I,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CACvD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;IACjD,IAAI,EAAE,cAAc;IACpB,OAAO,EAAE,oBAAoB;IAC7B,IAAI,EAAE;QACJ,OAAO,EAAE,4CAA4C;QACrD,WAAW,EAAE,oJAAoJ;QACjK,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE;YACR,6CAA6C;YAC7C,8CAA8C;YAC9C,+CAA+C;SAChD;KACF;IACD,OAAO,EAAE,gBAAgB;CAC1B,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAc;IACvD,OAAO,mBAAmB,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/builtins/sys/tasks.d.ts

@@ -8,7 +8,9 @@
  * its current operation does, and a second `kill` says so rather than
  * forcing it, because a cloud job cut short can leave its state locked.
  * `wait` follows a job's log until it ends, and its status is the job's:
- * Ctrl-C stops following, never the job.
+ * Ctrl-C stops following, never the job. Declared in one record each
+ * (`killCommand`, `waitCommand`); neither takes an option, so `kill -9` is
+ * refused before it runs.
  *
  * @module
  */
@@ -30,17 +32,84 @@ export declare function jobName_resolve(runner: JobRunner, word: string): JobNam
     error: string;
 };
 /**
- * `kill <task>…`: asks each job to stop.
+ * `kill <task>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [killCommand] });
+ * ```
+ */
+export declare const killCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "task";
+        readonly kind: "word";
+        readonly repeat: true;
+        readonly summary: "Each task: /proc/<source>/<id>, <source>/<id>, %N, or its name";
+    }];
+}>;
+/**
+ * `wait [<task>…]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [waitCommand] });
+ * ```
+ */
+export declare const waitCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "task";
+        readonly kind: "word";
+        readonly optional: true;
+        readonly repeat: true;
+        readonly summary: "Each task, as kill names it; bare, every running task";
+    }];
+}>;
+/**
+ * `kill` over words already split: the declaration's parse and handler.
  *
  * @param args - The words after `kill`.
- * @returns The envelope: quiet on success, a line per job that could not be asked.
+ * @returns Quiet on success, a line per job that could not be asked, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_kill(['%1']);
+ * ```
  */
 export declare function builtin_kill(args: string[]): Promise<CommandEnvelope>;
 /**
- * `wait [<task>…]`: follows each job's log until it ends; bare, every running job.
+ * `wait` over words already split: the declaration's parse and handler.
  *
  * @param args - The words after `wait`.
- * @returns The envelope: failed when a job did not end done, or following was stopped.
+ * @returns Failed when a job did not end done or following was stopped, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_wait(['trial-build']);
+ * ```
  */
 export declare function builtin_wait(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Asks each job to stop.
+ *
+ * @param args - The tasks, as words name them.
+ * @returns The envelope: quiet on success, a line per job that could not be asked.
+ *
+ * @example
+ * ```ts
+ * await kill_run(['/proc/steps/trial-build']);
+ * ```
+ */
+export declare function kill_run(args: readonly string[]): Promise<CommandEnvelope>;
+/**
+ * Follows each job's log until it ends; bare, every running job.
+ *
+ * @param args - The tasks, as words name them; none for every running one.
+ * @returns The envelope: failed when a job did not end done, or following was stopped.
+ *
+ * @example
+ * ```ts
+ * await wait_run([]);
+ * ```
+ */
+export declare function wait_run(args: readonly string[]): Promise<CommandEnvelope>;
 export {};

package/dist/builtins/sys/tasks.js

@@ -8,11 +8,15 @@
  * its current operation does, and a second `kill` says so rather than
  * forcing it, because a cloud job cut short can leave its state locked.
  * `wait` follows a job's log until it ends, and its status is the job's:
- * Ctrl-C stops following, never the job.
+ * Ctrl-C stops following, never the job. Declared in one record each
+ * (`killCommand`, `waitCommand`); neither takes an option, so `kill -9` is
+ * refused before it runs.
  *
  * @module
  */
 import { envelope_error, envelope_ok, taskState_isOver } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 import { runner_get } from '../../core/runner.js';
 import { commandCancellation_enable, commandCancellation_signalGet } from '../../core/cancellation.js';
 import { sink_dataLine } from '../../core/sink.js';
@@ -48,18 +52,100 @@ const STOP_WORDS = {
     'not-running': (record) => `not running (${record?.state ?? 'ended'})`,
     unknown: () => 'no such task',
 };
+/** What a `kill` line may hold. */
+const KILL_GRAMMAR = {
+    operands: [
+        { name: 'task', kind: 'word', repeat: true, summary: 'Each task: /proc/<source>/<id>, <source>/<id>, %N, or its name' },
+    ],
+};
+/** What a `wait` line may hold. */
+const WAIT_GRAMMAR = {
+    operands: [
+        { name: 'task', kind: 'word', optional: true, repeat: true, summary: 'Each task, as kill names it; bare, every running task' },
+    ],
+};
 /**
- * `kill <task>…`: asks each job to stop.
+ * `kill <task>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [killCommand] });
+ * ```
+ */
+export const killCommand = command_declare({
+    name: 'kill',
+    grammar: KILL_GRAMMAR,
+    help: {
+        summary: 'Ask a running task to stop',
+        description: 'Asks each task to stop: /proc/<source>/<id>, <source>/<id>, a joblet\'s %N, or its name alone when one source has it. Quiet when it is asked, as kill is. The task ends when its current operation does: a cloud job cut short can leave its state locked, so a task is never forced, there is no -9, and a second kill says so instead.',
+        category: 'General',
+        posix: { group: 'System', differs: 'stops a session task (/proc/<source>/<id>), never a process; asks, never forces' },
+        examples: ['kill /proc/steps/trial-build', 'kill trial-build', 'kill %1'],
+    },
+    holds: [],
+    handler: async (args) => kill_run(args.operands.task),
+});
+/**
+ * `wait [<task>…]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [waitCommand] });
+ * ```
+ */
+export const waitCommand = command_declare({
+    name: 'wait',
+    grammar: WAIT_GRAMMAR,
+    help: {
+        summary: 'Follow a task until it ends',
+        description: 'Follows each task\'s log until it ends, then says how it ended; bare, every running task. The status is the tasks\': 0 when all ended done. Ctrl-C stops following and leaves the task running; wait again picks it up.',
+        category: 'General',
+        posix: { group: 'System', differs: 'waits on session tasks, following each one\'s log' },
+        examples: ['wait trial-build', 'wait %1', 'wait'],
+    },
+    holds: [],
+    handler: async (args) => wait_run(args.operands.task),
+});
+/**
+ * `kill` over words already split: the declaration's parse and handler.
  *
  * @param args - The words after `kill`.
- * @returns The envelope: quiet on success, a line per job that could not be asked.
+ * @returns Quiet on success, a line per job that could not be asked, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_kill(['%1']);
+ * ```
  */
 export async function builtin_kill(args) {
-    const flag = args.find((word) => word.startsWith('-'));
-    if (flag !== undefined)
-        return envelope_error('', undefined, `kill: ${flag}: a task is never forced; kill asks it to stop\n`);
-    if (args.length === 0)
-        return envelope_error('', undefined, 'kill: usage: kill <task>…\n');
+    return declaredCommand_run(killCommand, args);
+}
+/**
+ * `wait` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `wait`.
+ * @returns Failed when a job did not end done or following was stopped, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_wait(['trial-build']);
+ * ```
+ */
+export async function builtin_wait(args) {
+    return declaredCommand_run(waitCommand, args);
+}
+/**
+ * Asks each job to stop.
+ *
+ * @param args - The tasks, as words name them.
+ * @returns The envelope: quiet on success, a line per job that could not be asked.
+ *
+ * @example
+ * ```ts
+ * await kill_run(['/proc/steps/trial-build']);
+ * ```
+ */
+export async function kill_run(args) {
     const runner = runner_get();
     if (runner === null)
         return envelope_error('', undefined, 'kill: this session runs no tasks\n');
@@ -84,15 +170,17 @@ export async function builtin_kill(args) {
     return envelope_ok('', { kind: 'tasks.kill', data });
 }
 /**
- * `wait [<task>…]`: follows each job's log until it ends; bare, every running job.
+ * Follows each job's log until it ends; bare, every running job.
  *
- * @param args - The words after `wait`.
+ * @param args - The tasks, as words name them; none for every running one.
  * @returns The envelope: failed when a job did not end done, or following was stopped.
+ *
+ * @example
+ * ```ts
+ * await wait_run([]);
+ * ```
  */
-export async function builtin_wait(args) {
-    const flag = args.find((word) => word.startsWith('-'));
-    if (flag !== undefined)
-        return envelope_error('', undefined, `wait: ${flag}: unknown option\n`);
+export async function wait_run(args) {
     const runner = runner_get();
     if (runner === null)
         return args.length === 0 ? envelope_ok('') : envelope_error('', undefined, 'wait: this session runs no tasks\n');

package/dist/builtins/sys/tasks.js.map

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