@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/fs/upload.js.map

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

package/dist/builtins/fs/xattr.args.d.ts

@@ -1,44 +1,18 @@
 /** The one attribute a feed carries. */
 export declare const XATTR_TAG: string;
-/** How `setfattr` is spelled. */
-export declare const SETFATTR_USAGE: string;
-/** How `getfattr` is spelled. */
-export declare const GETFATTR_USAGE: string;
-/** A parsed `setfattr` invocation. */
-export interface SetfattrArgs {
-    /** Set a value (`-n`), or remove (`-x`). */
-    mode: 'set' | 'remove';
-    /** The value to set or remove; null removes every value (`-x` alone). */
-    value: string | null;
-    paths: string[];
-    error: string | null;
-}
-/** A parsed `getfattr` invocation. */
-export interface GetfattrArgs {
-    paths: string[];
-    error: string | null;
-}
-/**
- * Reads a `setfattr` invocation. Unknown flags and attributes are refused by name.
- *
- * @param args - The tokens after the verb.
- * @returns The parsed invocation, its error set when it is wrong.
- */
-export declare function setfattrArgs_parse(args: ReadonlyArray<string>): SetfattrArgs;
-/**
- * Reads a `getfattr` invocation. `-n tag` is accepted (it is the only
- * attribute); `-d` (dump all) reads the same.
- *
- * @param args - The tokens after the verb.
- * @returns The parsed invocation, its error set when it is wrong.
- */
-export declare function getfattrArgs_parse(args: ReadonlyArray<string>): GetfattrArgs;
+/** The names that attribute answers to: `tag`, and `user.tag` as Linux namespaces it. */
+export declare const XATTR_NAMES: readonly ['tag', 'user.tag'];
 /**
  * The feed a path names: an id, a `feed_N`, a path through `/feeds/` as
  * setfacl reads it, or the projection `/proc/jobs/feed_N`.
  *
  * @param target - The path as typed.
  * @returns The feed id, or null.
+ *
+ * @example
+ * ```ts
+ * xattrTarget_resolve('/proc/jobs/feed_12'); // 12
+ * ```
  */
 export declare function xattrTarget_resolve(target: string): number | null;
 /**
@@ -48,5 +22,10 @@ export declare function xattrTarget_resolve(target: string): number | null;
  * @param path - The path as named.
  * @param tags - The tag names.
  * @returns The block.
+ *
+ * @example
+ * ```ts
+ * xattr_render('feed_12', ['urgent']); // '# file: feed_12\ntag="urgent"'
+ * ```
  */
 export declare function xattr_render(path: string, tags: ReadonlyArray<string>): string;

package/dist/builtins/fs/xattr.args.js

@@ -1,117 +1,34 @@
 /**
- * @file Shared `setfattr` / `getfattr` command-line grammar.
+ * @file The words of a feed's tags: the one attribute, the targets a feed
+ * is named by, and `getfattr`'s dump.
  *
  * A feed's tags are, in POSIX terms, an extended attribute: `setfattr -n
  * tag -v urgent feed_12` hangs one, `getfattr feed_12` reads them. One
  * attribute exists, `tag` (also spelled `user.tag`), and it holds many
  * values — CUBE's tags on the feed.
  *
- * Dependency-free, as `acl.args.ts` is: the engine graph cannot be loaded
- * under jest, so a grammar inside the builtin is a grammar nothing tests.
+ * The line itself is parsed against each command's declaration
+ * (`xattr.ts`). Dependency-free, as `acl.args.ts` is, so these are tested
+ * without the engine.
  *
  * @module
  */
 import { aclTarget_resolve } from './acl.args.js';
 /** The one attribute a feed carries. */
 export const XATTR_TAG = 'tag';
-/** How `setfattr` is spelled. */
-export const SETFATTR_USAGE = 'setfattr: usage: setfattr -n tag -v <value> <path>... | setfattr -x tag [-v <value>] <path>...';
-/** How `getfattr` is spelled. */
-export const GETFATTR_USAGE = 'getfattr: usage: getfattr [-n tag] <path>...';
-/**
- * Whether an attribute name is the one a feed carries.
- *
- * @param name - The name as typed.
- * @returns True for `tag` and `user.tag`.
- */
-function name_isTag(name) {
-    return name === XATTR_TAG || name === `user.${XATTR_TAG}`;
-}
-/**
- * Reads a `setfattr` invocation. Unknown flags and attributes are refused by name.
- *
- * @param args - The tokens after the verb.
- * @returns The parsed invocation, its error set when it is wrong.
- */
-export function setfattrArgs_parse(args) {
-    let mode = null;
-    let name = null;
-    let value = null;
-    const paths = [];
-    const fail = (error) => ({ mode: 'set', value: null, paths: [], error });
-    for (let i = 0; i < args.length; i += 1) {
-        const token = args[i] ?? '';
-        if (token === '-n' || token === '--name' || token === '-x' || token === '--remove') {
-            const given = args[i + 1];
-            if (given === undefined)
-                return fail(`setfattr: option '${token}' requires an argument\n${SETFATTR_USAGE}`);
-            mode = token === '-n' || token === '--name' ? 'set' : 'remove';
-            name = given;
-            i += 1;
-        }
-        else if (token === '-v' || token === '--value') {
-            const given = args[i + 1];
-            if (given === undefined)
-                return fail(`setfattr: option '${token}' requires an argument\n${SETFATTR_USAGE}`);
-            value = given;
-            i += 1;
-        }
-        else if (token.startsWith('-')) {
-            return fail(`setfattr: invalid option -- '${token.replace(/^-+/, '')}'\n${SETFATTR_USAGE}`);
-        }
-        else {
-            paths.push(token);
-        }
-    }
-    if (mode === null || name === null)
-        return fail(SETFATTR_USAGE);
-    if (!name_isTag(name))
-        return fail(`setfattr: ${name}: Operation not supported (a feed carries one attribute, tag)`);
-    if (mode === 'set' && (value === null || value.trim() === ''))
-        return fail(`setfattr: -n ${name} needs -v <value>\n${SETFATTR_USAGE}`);
-    if (paths.length === 0)
-        return fail(SETFATTR_USAGE);
-    return { mode, value: value === null ? null : value.trim(), paths, error: null };
-}
-/**
- * Reads a `getfattr` invocation. `-n tag` is accepted (it is the only
- * attribute); `-d` (dump all) reads the same.
- *
- * @param args - The tokens after the verb.
- * @returns The parsed invocation, its error set when it is wrong.
- */
-export function getfattrArgs_parse(args) {
-    const paths = [];
-    for (let i = 0; i < args.length; i += 1) {
-        const token = args[i] ?? '';
-        if (token === '-n' || token === '--name') {
-            const given = args[i + 1];
-            if (given === undefined)
-                return { paths: [], error: `getfattr: option '${token}' requires an argument\n${GETFATTR_USAGE}` };
-            if (!name_isTag(given))
-                return { paths: [], error: `getfattr: ${given}: No such attribute (a feed carries one attribute, tag)` };
-            i += 1;
-        }
-        else if (token === '-d' || token === '--dump') {
-            continue;
-        }
-        else if (token.startsWith('-')) {
-            return { paths: [], error: `getfattr: invalid option -- '${token.replace(/^-+/, '')}'\n${GETFATTR_USAGE}` };
-        }
-        else {
-            paths.push(token);
-        }
-    }
-    if (paths.length === 0)
-        return { paths: [], error: GETFATTR_USAGE };
-    return { paths, error: null };
-}
+/** The names that attribute answers to: `tag`, and `user.tag` as Linux namespaces it. */
+export const XATTR_NAMES = ['tag', 'user.tag'];
 /**
  * The feed a path names: an id, a `feed_N`, a path through `/feeds/` as
  * setfacl reads it, or the projection `/proc/jobs/feed_N`.
  *
  * @param target - The path as typed.
  * @returns The feed id, or null.
+ *
+ * @example
+ * ```ts
+ * xattrTarget_resolve('/proc/jobs/feed_12'); // 12
+ * ```
  */
 export function xattrTarget_resolve(target) {
     const held = aclTarget_resolve(target);
@@ -127,6 +44,11 @@ export function xattrTarget_resolve(target) {
  * @param path - The path as named.
  * @param tags - The tag names.
  * @returns The block.
+ *
+ * @example
+ * ```ts
+ * xattr_render('feed_12', ['urgent']); // '# file: feed_12\ntag="urgent"'
+ * ```
  */
 export function xattr_render(path, tags) {
     return [`# file: ${path}`, ...tags.map((tag) => `${XATTR_TAG}="${tag.replace(/"/g, '\\"')}"`)].join('\n');

package/dist/builtins/fs/xattr.args.js.map

@@ -1 +1 @@
-{"version":3,"file":"xattr.args.js","sourceRoot":"","sources":["../../../src/builtins/fs/xattr.args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xattr.args.js","sourceRoot":"","sources":["../../../src/builtins/fs/xattr.args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,wCAAwC;AACxC,MAAM,CAAC,MAAM,SAAS,GAAW,KAAK,CAAC;AAEvC,yFAAyF;AACzF,MAAM,CAAC,MAAM,WAAW,GAAiC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAE7E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,IAAI,GAAkB,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,MAAM,SAAS,GAA4B,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACtF,OAAO,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAA2B;IACpE,OAAO,CAAC,WAAW,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,SAAS,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5H,CAAC"}

package/dist/builtins/fs/xattr.d.ts

@@ -1,17 +1,107 @@
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
- * Reads the tags a feed wears, in `getfattr`'s dump shape.
+ * `getfattr [-d] [-n tag] <path>…`: the declaration.
  *
- * @param args - Raw argument tokens.
- * @returns An envelope carrying the rendered blocks and a model of them.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [getfattrCommand] }, 'backend');
+ * ```
+ */
+export declare const getfattrCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "path";
+        readonly kind: "cfsPath";
+        readonly repeat: true;
+        readonly glob: true;
+        readonly summary: "The feeds: an id, feed_N, any path through /feeds/, or /proc/jobs/feed_N";
+    }];
+    readonly options: {
+        readonly name: {
+            readonly short: "n";
+            readonly long: "name";
+            readonly summary: "The attribute to read (only tag exists)";
+            readonly value: {
+                readonly name: "name";
+                readonly kind: "enum";
+                readonly values: readonly ["tag", "user.tag"];
+            };
+        };
+        readonly dump: {
+            readonly short: "d";
+            readonly long: "dump";
+            readonly summary: "Dump every attribute (the default)";
+        };
+    };
+}>;
+/**
+ * `getfattr` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `getfattr`.
+ * @returns The tags, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_getfattr(['feed_12']);
+ * ```
  */
 export declare function builtin_getfattr(args: string[]): Promise<CommandEnvelope>;
 /**
- * Hangs a tag on feeds (`-n tag -v <value>`), or takes one off (`-x tag -v
- * <value>`), or takes every tag off (`-x tag`, as setfattr removes the
- * whole attribute). Silent on success, as setfattr is; a refusal is named.
+ * `setfattr -n tag -v <value> <path>… | -x tag [-v <value>] <path>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [setfattrCommand] }, 'backend');
+ * ```
+ */
+export declare const setfattrCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "path";
+        readonly kind: "cfsPath";
+        readonly repeat: true;
+        readonly glob: true;
+        readonly summary: "The feeds: an id, feed_N, any path through /feeds/, or /proc/jobs/feed_N";
+    }];
+    readonly options: {
+        readonly name: {
+            readonly short: "n";
+            readonly long: "name";
+            readonly summary: "The attribute to set (only tag exists)";
+            readonly value: {
+                readonly name: "name";
+                readonly kind: "enum";
+                readonly values: readonly ["tag", "user.tag"];
+            };
+        };
+        readonly value: {
+            readonly short: "v";
+            readonly long: "value";
+            readonly summary: "The tag";
+            readonly value: {
+                readonly name: "value";
+                readonly kind: "word";
+            };
+        };
+        readonly remove: {
+            readonly short: "x";
+            readonly long: "remove";
+            readonly summary: "Remove the tag given by -v, or every tag without -v";
+            readonly value: {
+                readonly name: "name";
+                readonly kind: "enum";
+                readonly values: readonly ["tag", "user.tag"];
+            };
+        };
+    };
+}>;
+/**
+ * `setfattr` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `setfattr`.
+ * @returns An envelope, empty on success, or the refusal of a bad line.
  *
- * @param args - Raw argument tokens.
- * @returns An envelope, empty on success.
+ * @example
+ * ```ts
+ * await builtin_setfattr(['-x', 'tag', 'feed_12']);
+ * ```
  */
 export declare function builtin_setfattr(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/fs/xattr.js

@@ -2,16 +2,42 @@
  * @file `setfattr` and `getfattr` — a feed's tags.
  *
  * CUBE's freeform tags on a feed are, in POSIX terms, the values of one
- * extended attribute, `tag`. The capability lives in the kernel
- * (`feedTags_list`, `feedTag_add`, `feedTag_remove`); this is its shell face.
+ * extended attribute, `tag`. Each command is declared in one record: the
+ * attribute's name is one of the words it answers to, the feeds are path
+ * operands that glob. The capability lives in the kernel (`feedTags_list`,
+ * `feedTag_add`, `feedTag_remove`); this is its shell face.
+ *
+ * Key components:
+ * - setfattrCommand, getfattrCommand: the declarations.
+ * - builtin_setfattr, builtin_getfattr: each declaration run over words already split.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_setfattr(['-n', 'tag', '-v', 'urgent', 'feed_12']);
+ * ```
+ *
+ * Dependencies: cumin's tag calls; the target and dump words (`xattr.args.ts`).
  *
  * @module
  */
+import chalk from 'chalk';
 import { feedTags_list, feedTag_add, feedTag_remove } from '@fnndsc/cumin';
-import { getfattrArgs_parse, setfattrArgs_parse, xattrTarget_resolve, xattr_render, } from './xattr.args.js';
+import { xattrTarget_resolve, xattr_render } from './xattr.args.js';
 import { error_stripDebugPrefix } from '../utils.js';
 import { errorStack } from '@fnndsc/fond';
 import { envelope_ok, envelope_error } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
+import { commandUsage_render } from '../../core/commandUsage.js';
+import { exitCode_set } from '../../core/handlerRun.js';
+/** The feeds a line names, as both commands take them. */
+const FEEDS_OPERAND = {
+    name: 'path',
+    kind: 'cfsPath',
+    repeat: true,
+    glob: true,
+    summary: 'The feeds: an id, feed_N, any path through /feeds/, or /proc/jobs/feed_N',
+};
 /**
  * A refusal, on a line of its own.
  *
@@ -31,19 +57,24 @@ function error_said(fallback) {
     const error = errorStack.stack_pop();
     return error?.message ?? fallback;
 }
+/** What a `getfattr` line may hold. */
+const GETFATTR_GRAMMAR = {
+    operands: [FEEDS_OPERAND],
+    options: {
+        name: { short: 'n', long: 'name', summary: 'The attribute to read (only tag exists)', value: { name: 'name', kind: 'enum', values: ['tag', 'user.tag'] } },
+        dump: { short: 'd', long: 'dump', summary: 'Dump every attribute (the default)' },
+    },
+};
 /**
  * Reads the tags a feed wears, in `getfattr`'s dump shape.
  *
- * @param args - Raw argument tokens.
+ * @param args - The line, parsed.
  * @returns An envelope carrying the rendered blocks and a model of them.
  */
-export async function builtin_getfattr(args) {
-    const parsed = getfattrArgs_parse(args);
-    if (parsed.error !== null)
-        return refusal(parsed.error);
+async function getfattr_run(args) {
     const blocks = [];
     const model = [];
-    for (const path of parsed.paths) {
+    for (const path of args.operands.path) {
         const feedId = xattrTarget_resolve(path);
         if (feedId === null)
             return refusal(`getfattr: '${path}' does not name a feed`);
@@ -56,45 +87,153 @@ export async function builtin_getfattr(args) {
     }
     return envelope_ok(`${blocks.join('\n\n')}\n`, { kind: 'fs.xattr', data: model });
 }
+/**
+ * `getfattr [-d] [-n tag] <path>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [getfattrCommand] }, 'backend');
+ * ```
+ */
+export const getfattrCommand = command_declare({
+    name: 'getfattr',
+    grammar: GETFATTR_GRAMMAR,
+    help: {
+        summary: 'Show the tags a feed wears',
+        description: 'Show a feed\'s tags in getfattr\'s dump shape: a # file: line, then one tag="…" line per tag.',
+        category: 'Sharing',
+        posix: { group: 'Files', differs: 'a feed\'s tags, as extended attributes' },
+        examples: [
+            'getfattr feed_12',
+            'getfattr -n tag /home/me/feeds/feed_12',
+        ],
+    },
+    // Reading a feed's tags changes nothing of the session.
+    holds: [],
+    handler: getfattr_run,
+});
+/**
+ * `getfattr` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `getfattr`.
+ * @returns The tags, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_getfattr(['feed_12']);
+ * ```
+ */
+export async function builtin_getfattr(args) {
+    return declaredCommand_run(getfattrCommand, args);
+}
+/** What a `setfattr` line may hold. */
+const SETFATTR_GRAMMAR = {
+    operands: [FEEDS_OPERAND],
+    options: {
+        name: { short: 'n', long: 'name', summary: 'The attribute to set (only tag exists)', value: { name: 'name', kind: 'enum', values: ['tag', 'user.tag'] } },
+        value: { short: 'v', long: 'value', summary: 'The tag', value: { name: 'value', kind: 'word' } },
+        remove: { short: 'x', long: 'remove', summary: 'Remove the tag given by -v, or every tag without -v', value: { name: 'name', kind: 'enum', values: ['tag', 'user.tag'] } },
+    },
+};
+/**
+ * A refusal of a line that says neither what to set nor what to remove, or
+ * a set without its value, with the usage.
+ *
+ * @param reason - What is missing.
+ * @returns The error envelope.
+ */
+function setfattrLine_refuse(reason) {
+    exitCode_set(1);
+    return envelope_error('', undefined, `${chalk.red(`setfattr: ${reason}; usage: ${commandUsage_render(setfattrCommand)}`)}\n`);
+}
 /**
  * Hangs a tag on feeds (`-n tag -v <value>`), or takes one off (`-x tag -v
  * <value>`), or takes every tag off (`-x tag`, as setfattr removes the
  * whole attribute). Silent on success, as setfattr is; a refusal is named.
  *
- * @param args - Raw argument tokens.
+ * @param args - The line, parsed.
  * @returns An envelope, empty on success.
  */
-export async function builtin_setfattr(args) {
-    const parsed = setfattrArgs_parse(args);
-    if (parsed.error !== null)
-        return refusal(parsed.error);
+async function setfattr_run(args) {
+    const { name, remove } = args.options;
+    if (name !== undefined && remove !== undefined)
+        return setfattrLine_refuse('-n sets and -x removes; give one');
+    if (name === undefined && remove === undefined)
+        return setfattrLine_refuse('-n tag or -x tag is needed');
+    const mode = name !== undefined ? 'set' : 'remove';
+    const value = args.options.value === undefined ? null : args.options.value.trim();
+    if (mode === 'set' && (value === null || value === ''))
+        return setfattrLine_refuse(`-n ${name ?? 'tag'} needs -v <value>`);
     const changed = [];
-    for (const path of parsed.paths) {
+    for (const path of args.operands.path) {
         const feedId = xattrTarget_resolve(path);
         if (feedId === null)
             return refusal(`setfattr: '${path}' does not name a feed`);
         let names;
-        if (parsed.mode === 'remove' && parsed.value === null) {
+        if (mode === 'remove' && value === null) {
             const held = await feedTags_list(feedId);
             if (!held.ok)
                 return refusal(error_said(`setfattr: could not read the tags of feed ${feedId}`));
             names = held.value.map((tag) => tag.name);
         }
         else {
-            names = [parsed.value ?? ''];
+            names = [value ?? ''];
         }
-        for (const name of names) {
-            const done = parsed.mode === 'set' ? await feedTag_add(feedId, name) : await feedTag_remove(feedId, name);
+        for (const tagName of names) {
+            const done = mode === 'set' ? await feedTag_add(feedId, tagName) : await feedTag_remove(feedId, tagName);
             if (!done.ok) {
-                const said = error_stripDebugPrefix(error_said(`could not ${parsed.mode === 'set' ? 'add' : 'remove'} tag ${name}`));
+                const said = error_stripDebugPrefix(error_said(`could not ${mode === 'set' ? 'add' : 'remove'} tag ${tagName}`));
                 return refusal(`setfattr: ${path}: ${said}`);
             }
-            if (parsed.mode === 'remove' && parsed.value !== null && !done.value) {
-                return refusal(`setfattr: ${path}: tag="${name}": No such attribute value`);
+            if (mode === 'remove' && value !== null && !done.value) {
+                return refusal(`setfattr: ${path}: tag="${tagName}": No such attribute value`);
             }
-            changed.push({ feedId, tag: name, done: done.value });
+            changed.push({ feedId, tag: tagName, done: done.value });
         }
     }
-    return envelope_ok('', { kind: 'fs.xattr.changed', data: { mode: parsed.mode, changed } });
+    return envelope_ok('', { kind: 'fs.xattr.changed', data: { mode, changed } });
+}
+/**
+ * `setfattr -n tag -v <value> <path>… | -x tag [-v <value>] <path>…`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [setfattrCommand] }, 'backend');
+ * ```
+ */
+export const setfattrCommand = command_declare({
+    name: 'setfattr',
+    grammar: SETFATTR_GRAMMAR,
+    help: {
+        summary: 'Hang a tag on a feed, or take it off',
+        description: 'A feed\'s tags are the values of one extended attribute, tag (also user.tag): CUBE\'s '
+            + 'freeform labels. -n tag -v <value> hangs one of your tags (a folder under /proc/tags: '
+            + 'mkdir /proc/tags/<name> makes a tag, and naming one that does not exist is an error); '
+            + '-x tag -v <value> takes it off; -x tag alone takes every tag off, as '
+            + 'setfattr removes the whole attribute. A feed is named by id, by feed_N, by any path '
+            + 'through /feeds/, or by its projection /proc/jobs/feed_N. Silent on success.',
+        category: 'Sharing',
+        posix: { group: 'Files', differs: 'tags on a feed, as extended attributes' },
+        examples: [
+            'setfattr -n tag -v urgent feed_12',
+            'setfattr -n tag -v review feed_12 feed_13',
+            'setfattr -x tag -v urgent /proc/jobs/feed_12',
+        ],
+    },
+    handler: setfattr_run,
+});
+/**
+ * `setfattr` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `setfattr`.
+ * @returns An envelope, empty on success, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_setfattr(['-x', 'tag', 'feed_12']);
+ * ```
+ */
+export async function builtin_setfattr(args) {
+    return declaredCommand_run(setfattrCommand, args);
 }
 //# sourceMappingURL=xattr.js.map

package/dist/builtins/fs/xattr.js.map

@@ -1 +1 @@
-{"version":3,"file":"xattr.js","sourceRoot":"","sources":["../../../src/builtins/fs/xattr.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"xattr.js","sourceRoot":"","sources":["../../../src/builtins/fs/xattr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAgB,MAAM,eAAe,CAAC;AACzF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,UAAU,EAAkC,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,eAAe,EAA8C,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,0DAA0D;AAC1D,MAAM,aAAa,GAAG;IACpB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI;IACV,OAAO,EAAE,0EAA0E;CAC3E,CAAC;AAEX;;;;;GAKG;AACH,SAAS,OAAO,CAAC,OAAe;IAC9B,OAAO,cAAc,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,SAAS,UAAU,CAAC,QAAgB;IAClC,MAAM,KAAK,GAA6B,UAAU,CAAC,SAAS,EAAE,CAAC;IAC/D,OAAO,KAAK,EAAE,OAAO,IAAI,QAAQ,CAAC;AACpC,CAAC;AAED,uCAAuC;AACvC,MAAM,gBAAgB,GAAG;IACvB,QAAQ,EAAE,CAAC,aAAa,CAAC;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,yCAAyC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE;QAC1J,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oCAAoC,EAAE;KAClF;CACgC,CAAC;AAEpC;;;;;GAKG;AACH,KAAK,UAAU,YAAY,CAAC,IAA+C;IACzE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAA4D,EAAE,CAAC;IAC1E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAkB,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC,CAAC;QAChF,MAAM,IAAI,GAAsB,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,OAAO,OAAO,CAAC,UAAU,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAC,CAAC;QAChG,MAAM,IAAI,GAAa,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAY,EAAU,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1E,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;IAC7C,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,gBAAgB;IACzB,IAAI,EAAE;QACJ,OAAO,EAAE,4BAA4B;QACrC,WAAW,EAAE,+FAA+F;QAC5G,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,wCAAwC,EAAE;QAC5E,QAAQ,EAAE;YACR,kBAAkB;YAClB,wCAAwC;SACzC;KACF;IACD,wDAAwD;IACxD,KAAK,EAAE,EAAE;IACT,OAAO,EAAE,YAAY;CACtB,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,OAAO,mBAAmB,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,uCAAuC;AACvC,MAAM,gBAAgB,GAAG;IACvB,QAAQ,EAAE,CAAC,aAAa,CAAC;IACzB,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wCAAwC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE;QACzJ,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;QAChG,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,qDAAqD,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE;KAC3K;CACgC,CAAC;AAEpC;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,MAAc;IACzC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChB,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,MAAM,YAAY,mBAAmB,CAAC,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;AAChI,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,YAAY,CAAC,IAA+C;IACzE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;IACtC,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC,kCAAkC,CAAC,CAAC;IAC/G,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC,4BAA4B,CAAC,CAAC;IACzG,MAAM,IAAI,GAAqB,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IACrE,MAAM,KAAK,GAAkB,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACjG,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAAE,OAAO,mBAAmB,CAAC,MAAM,IAAI,IAAI,KAAK,mBAAmB,CAAC,CAAC;IAC3H,MAAM,OAAO,GAA0D,EAAE,CAAC;IAC1E,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,MAAM,GAAkB,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACxD,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC,CAAC;QAChF,IAAI,KAAe,CAAC;QACpB,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,GAAsB,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC;YAC5D,IAAI,CAAC,IAAI,CAAC,EAAE;gBAAE,OAAO,OAAO,CAAC,UAAU,CAAC,6CAA6C,MAAM,EAAE,CAAC,CAAC,CAAC;YAChG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAY,EAAU,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,KAAK,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACxB,CAAC;QACD,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAoB,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC1H,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;gBACb,MAAM,IAAI,GAAW,sBAAsB,CAAC,UAAU,CAAC,aAAa,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,QAAQ,OAAO,EAAE,CAAC,CAAC,CAAC;gBACzH,OAAO,OAAO,CAAC,aAAa,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC;YACD,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACvD,OAAO,OAAO,CAAC,aAAa,IAAI,UAAU,OAAO,4BAA4B,CAAC,CAAC;YACjF,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AAChF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;IAC7C,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,gBAAgB;IACzB,IAAI,EAAE;QACJ,OAAO,EAAE,sCAAsC;QAC/C,WAAW,EACT,wFAAwF;cACtF,wFAAwF;cACxF,wFAAwF;cACxF,uEAAuE;cACvE,sFAAsF;cACtF,6EAA6E;QACjF,QAAQ,EAAE,SAAS;QACnB,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,wCAAwC,EAAE;QAC5E,QAAQ,EAAE;YACR,mCAAmC;YACnC,2CAA2C;YAC3C,8CAA8C;SAC/C;KACF;IACD,OAAO,EAAE,YAAY;CACtB,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,OAAO,mBAAmB,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC"}