kiriya 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -7,6 +7,20 @@ output shapes are kiriya's public API.
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-09-24
+
+### Changed
+
+- An option that takes one of a list of values now declares that list, so an MCP tool
+  offers it as a JSON Schema `enum` instead of naming it only in prose an agent would have
+  to read. Eleven options gained one: `files list --sort`, `files find --type`,
+  `files hash --algo`, `files info --hash`, `files rename --case` and `--only`,
+  `convert case --to`, `convert time --unit`, `gen token --format` and `net dns --type`.
+  Help and the generated reference are unchanged, since a declared list names itself.
+- Tab completion reads the same list, rather than parsing the value name it was displayed
+  under. `docker logs --tail <n|all>` therefore offers nothing instead of offering `n`,
+  which was never a value it took.
+
 ## [0.1.1] - 2026-09-24
 
 ### Changed

package/dist/src/core/presentation/cli/help.js

@@ -85,7 +85,8 @@ function wordmark(context) {
 }
 /** `-i, --ignore-case` or `--to <file>`, as help and the generated docs show an option. */
 export function optionLabel(name, spec) {
-    const value = spec.type === "string" ? ` ${spec.valueName ?? "<value>"}` : "";
+    const named = spec.valueName ?? (spec.choices === undefined ? "<value>" : `<${spec.choices.join("|")}>`);
+    const value = spec.type === "string" ? ` ${named}` : "";
     const short = spec.short === undefined ? "" : `-${spec.short}, `;
     return `${short}--${name}${value}`;
 }

package/dist/src/core/presentation/mcp/tool-definitions.js

@@ -65,13 +65,15 @@ export function inputSchemaOf(commandId, input, translator, access = READING) {
     }
     for (const [name, option] of toolOptions(input, access)) {
         const text = translator.text(message(option.description));
+        // Choices belong in the enum, where a client can act on them, rather than in prose it must read.
         const description = option.valueName === undefined ? text : `${text} ${option.valueName}`;
+        const choices = option.choices === undefined ? {} : { enum: [...option.choices] };
         if (option.type === "boolean")
             claim(name, { type: "boolean", description });
         else if (option.multiple === true)
-            claim(name, { type: "array", items: { type: "string" }, description });
+            claim(name, { type: "array", items: { type: "string", ...choices }, description });
         else
-            claim(name, { type: "string", description });
+            claim(name, { type: "string", ...choices, description });
     }
     return { type: "object", properties, ...(required.length > 0 ? { required } : {}), additionalProperties: false };
 }

package/dist/src/modules/completion/domain/suggest.js

@@ -1,7 +1,11 @@
-/** The values an option lists in its value name, such as `<hex|base64|base64url>`. */
+/**
+ * The values an option takes, when it takes only a list of them. It reads the list the
+ * command declares, rather than parsing the value name it is displayed under, so an option
+ * whose value name merely looks like a list — `--tail <n|all>`, a number or a word — offers
+ * nothing instead of offering `n`.
+ */
 export function optionChoices(option) {
-    const match = /^<([a-z0-9-]+(?:\|[a-z0-9-]+)+)>$/.exec(option.valueName ?? "");
-    return match?.[1]?.split("|") ?? [];
+    return option.choices === undefined ? [] : [...option.choices];
 }
 function ownCommand(module) {
     return module.commands.find((command) => command.verb === "");

package/dist/src/modules/convert/application/convert-case.use-case.js

@@ -11,7 +11,7 @@ export const caseSpec = {
     input: {
         positionals: [valuePositional],
         options: {
-            to: { type: "string", description: "convert.case.option.to", valueName: `<${TEXT_CASES.join("|")}>` },
+            to: { type: "string", description: "convert.case.option.to", choices: TEXT_CASES },
             file: fileOption,
         },
         parse(raw) {

package/dist/src/modules/convert/application/convert-time.use-case.js

@@ -16,7 +16,7 @@ export const timeSpec = {
     idempotent: false,
     input: {
         positionals: [{ name: "value", description: "convert.time.arg.value", required: false, variadic: false }],
-        options: { unit: { type: "string", description: "convert.time.option.unit", valueName: "<auto|seconds|ms>" } },
+        options: { unit: { type: "string", description: "convert.time.option.unit", choices: EPOCH_UNITS } },
         parse(raw) {
             const reader = new RawReader(raw);
             return { value: reader.positional(0), unit: reader.choice("unit", EPOCH_UNITS, "auto") };

package/dist/src/modules/files/application/find-files.use-case.js

@@ -26,7 +26,7 @@ export const findSpec = {
         options: {
             name: { type: "string", description: "files.find.option.name", valueName: "<glob>" },
             ext: { type: "string", description: "files.find.option.ext", valueName: "<extensions>", multiple: true },
-            type: { type: "string", description: "files.find.option.type", valueName: "<file|dir>" },
+            type: { type: "string", description: "files.find.option.type", choices: FIND_TYPES },
             larger: { type: "string", description: "files.find.option.larger", valueName: "<size>" },
             smaller: { type: "string", description: "files.find.option.smaller", valueName: "<size>" },
             newer: { type: "string", description: "files.find.option.newer", valueName: "<time>" },

package/dist/src/modules/files/application/hash-files.use-case.js

@@ -19,7 +19,7 @@ export const hashSpec = {
     input: {
         positionals: [{ name: "paths", description: "files.hash.arg.paths", required: true, variadic: true, path: true }],
         options: {
-            algo: { type: "string", description: "files.hash.option.algo", valueName: `<${HASH_ALGORITHMS.join("|")}>` },
+            algo: { type: "string", description: "files.hash.option.algo", choices: HASH_ALGORITHMS },
             check: { type: "string", description: "files.hash.option.check", valueName: "<hex>" },
         },
         parse(raw) {

package/dist/src/modules/files/application/list-entries.use-case.js

@@ -16,7 +16,7 @@ export const listSpec = {
         positionals: [{ name: "path", description: "files.list.arg.path", required: false, variadic: false, path: true }],
         options: {
             all: { type: "boolean", description: "files.option.all" },
-            sort: { type: "string", description: "files.list.option.sort", valueName: "<name|size|time>" },
+            sort: { type: "string", description: "files.list.option.sort", choices: LIST_SORTS },
             reverse: { type: "boolean", description: "files.list.option.reverse" },
         },
         parse(raw) {

package/dist/src/modules/files/application/rename-paths.use-case.js

@@ -27,11 +27,11 @@ export const renameSpec = {
             { name: "paths", description: "files.rename.arg.paths", required: false, variadic: true, path: true },
         ],
         options: {
-            case: { type: "string", description: "files.rename.option.case", valueName: `<${CASE_STYLES.join("|")}>` },
+            case: { type: "string", description: "files.rename.option.case", choices: CASE_STYLES },
             find: { type: "string", description: "files.rename.option.find", valueName: "<text>" },
             with: { type: "string", description: "files.rename.option.with", valueName: "<text>" },
             recursive: { type: "boolean", description: "files.rename.option.recursive" },
-            only: { type: "string", description: "files.rename.option.only", valueName: "<files|dirs>" },
+            only: { type: "string", description: "files.rename.option.only", choices: ONLY },
             apply: { type: "boolean", description: "files.rename.option.apply" },
             yes: { type: "boolean", description: "files.rename.option.yes", short: "y", terminalOnly: true },
         },

package/dist/src/modules/files/application/show-info.use-case.js

@@ -28,7 +28,7 @@ export const infoSpec = {
     input: {
         positionals: [{ name: "paths", description: "files.info.arg.paths", required: true, variadic: true, path: true }],
         options: {
-            hash: { type: "string", description: "files.info.option.hash", valueName: `<${HASH_ALGORITHMS.join("|")}>` },
+            hash: { type: "string", description: "files.info.option.hash", choices: HASH_ALGORITHMS },
         },
         parse(raw) {
             const reader = new RawReader(raw);

package/dist/src/modules/gen/application/generate-tokens.use-case.js

@@ -11,7 +11,7 @@ export const tokenSpec = {
         positionals: [],
         options: {
             bytes: { type: "string", description: "gen.token.option.bytes", valueName: "<n>" },
-            format: { type: "string", description: "gen.token.option.format", valueName: "<hex|base64|base64url>" },
+            format: { type: "string", description: "gen.token.option.format", choices: TOKEN_FORMATS },
             count: countOption,
         },
         parse(raw) {

package/dist/src/modules/net/application/lookup-name.use-case.js

@@ -16,7 +16,7 @@ export const dnsSpec = {
     input: {
         positionals: [{ name: "name", description: "net.dns.arg.name", required: true, variadic: false }],
         options: {
-            type: { type: "string", description: "net.dns.option.type", valueName: `<${LOOKUP_TYPES.join("|")}>` },
+            type: { type: "string", description: "net.dns.option.type", choices: LOOKUP_TYPES },
         },
         parse(raw) {
             const reader = new RawReader(raw);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kiriya",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "One command-line toolbox for everyday developer work that behaves the same on Windows, Linux and macOS.",
   "mcpName": "io.github.SatPaingOo/kiriya",
   "license": "MIT",