@guiho/runx 0.2.2 → 0.2.4

package/skills/guiho-s-runx/SKILL.md

@@ -1,6 +1,18 @@
 ---
 name: guiho-s-runx
+purpose: Guide agents through safe inspection and execution of RunX command catalogs.
 description: Use when inspecting, creating, validating, organizing, documenting, or running a RunX `runx.yaml` command catalog. This includes listing available project commands, choosing a command by UID or selector, reviewing command descriptions, dry runs, confirmation-gated execution, and agent-safe project automation.
+created: 2026-07-12
+owner: guiho-s-runx
+flags: []
+tags:
+  - agents
+  - runx
+keywords:
+  - runx
+  - citty
+  - command catalog
+  - dry run
 ---
 
 # GUIHO RunX
@@ -30,6 +42,8 @@ commands but does not make them inherently safe: a manifest is trusted code.
   guarantee. Read the command description and command text.
 - Do not add secrets to `runx.yaml`. Use the project's existing environment or
   secret-management workflow.
+- Use `runx <command> --help` for command-specific Citty usage. `runx -h` and
+  `runx -v` are global operations and do not require a manifest.
 
 ## Maintain Manifests
 
@@ -47,6 +61,8 @@ commands but does not make them inherently safe: a manifest is trusted code.
 
 ```text
 runx                         Show the RunX home page and usage.
+runx -h                      Show generated command help.
+runx -v                      Show the installed version.
 runx list                    List the nearest manifest.
 runx describe <uid>          Explain one command without execution.
 runx run <uid> --dry-run     Inspect the execution plan.

package/skills/guiho-s-runx/guiho-s-runx.xdocs.md

@@ -1,17 +1,18 @@
 ---
 subject: guiho-s-runx
-description: Agent workflow for inspecting, validating, and safely executing RunX manifest commands.
+description: Agent workflow for inspecting, validating, getting Citty usage for, and safely executing RunX manifest commands.
 parent: runx-skills
 children: []
 files:
-  SKILL.md: RunX-specific agent instructions and safe execution workflow.
+  SKILL.md: RunX-specific agent instructions, help aliases, and safe execution workflow.
 documents:
-  SKILL.md: RunX-specific agent instructions and safe execution workflow.
+  SKILL.md: RunX-specific agent instructions, Citty help/version guidance, and safe execution workflow.
 tags:
   - agents
   - runx
 keywords:
   - runx
+  - citty
   - command catalog
   - dry run
 flags: []

package/library/flags.d.ts

@@ -1,5 +0,0 @@
-import type { ParsedArgs } from './types.js';
-export declare const parseArgs: (args: string[]) => ParsedArgs;
-export declare const booleanFlag: (flags: ParsedArgs['flags'], name: string) => boolean;
-export declare const stringFlag: (flags: ParsedArgs['flags'], name: string) => string | undefined;
-//# sourceMappingURL=flags.d.ts.map

package/library/flags.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../source/flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAI5C,eAAO,MAAM,SAAS,SAAU,MAAM,EAAE,KAAG,UA8B1C,CAAA;AAED,eAAO,MAAM,WAAW,UAAW,UAAU,CAAC,OAAO,CAAC,QAAQ,MAAM,KAAG,OAA+B,CAAA;AAEtG,eAAO,MAAM,UAAU,UAAW,UAAU,CAAC,OAAO,CAAC,QAAQ,MAAM,KAAG,MAAM,GAAG,SAG9E,CAAA"}

package/library/flags.js

@@ -1,32 +0,0 @@
-const booleanFlags = new Set(['help', 'helpTree', 'helpDocs', 'version', 'verbose', 'dryRun', 'yes']);
-export const parseArgs = (args) => {
-    const positionals = [];
-    const flags = {};
-    for (let index = 0; index < args.length; index += 1) {
-        const value = args[index];
-        if (!value.startsWith('--')) {
-            positionals.push(value);
-            continue;
-        }
-        const [rawName, inlineValue] = value.slice(2).split('=', 2);
-        const name = toCamelCase(rawName);
-        if (inlineValue !== undefined) {
-            flags[name] = inlineValue;
-            continue;
-        }
-        const next = args[index + 1];
-        if (!booleanFlags.has(name) && next && !next.startsWith('--')) {
-            flags[name] = next;
-            index += 1;
-            continue;
-        }
-        flags[name] = true;
-    }
-    return { command: positionals.shift(), positionals, flags };
-};
-export const booleanFlag = (flags, name) => flags[name] === true;
-export const stringFlag = (flags, name) => {
-    const value = flags[name];
-    return typeof value === 'string' ? value : undefined;
-};
-const toCamelCase = (value) => value.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());