@guiho/runx 0.2.7 → 0.4.0

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

@@ -1,12 +1,12 @@
 ---
 subject: guiho-s-runx
-description: Agent workflow for inspecting, validating, getting Citty usage for, and safely executing RunX manifest commands.
+description: Agent workflow for safe RunX catalog execution and verified native upgrade/list/recovery operations.
 parent: runx-skills
 children: []
 files:
-  SKILL.md: RunX-specific agent instructions, help aliases, and safe execution workflow.
+  SKILL.md: RFC-aligned RunX catalog inspection, execution safety, YAML precedence, agent, and upgrade guidance.
 documents:
-  SKILL.md: RunX-specific agent instructions, Citty help/version guidance, and safe execution workflow.
+  SKILL.md: RunX-specific command execution and verified native self-upgrade workflow.
 tags:
   - agents
   - runx
@@ -15,9 +15,12 @@ keywords:
   - citty
   - command catalog
   - dry run
+  - runx upgrade
+  - recovery install
 flags: []
 status: stable
 ---
 
 The skill makes manifest inspection, UID selection, dry runs, and explicit
-confirmation the default agent workflow for RunX commands.
+confirmation the default agent workflow for RunX commands and teaches agents
+how to interpret transactional native upgrades and their recovery contract.

package/skills/skills.xdocs.md

@@ -16,4 +16,4 @@ flags: []
 status: stable
 ---
 
-Bundled skills ship with RunX and can be installed through `runx agents install`.
+Bundled skills ship with RunX and can be managed through `runx agent skill`.

package/docs/todo/implement-runx-alpha.md

@@ -1,36 +0,0 @@
----
-name: Implement RunX Alpha Command Catalog
-purpose: Define the expected outcome, constraints, and completion signals for task 1 in TODO.md.
-description: Describes the first RunX CLI release and the safety, documentation, and validation constraints that govern it.
-created: 2026-07-12
-flags:
-  - implementation
-tags:
-  - todo
-  - cli
-keywords:
-  - runx
-  - alpha
-owner: runx-todo
----
-
-# Implement RunX Alpha Command Catalog
-
-## Todo Index
-
-- Task: `1. Implement RunX Alpha Command Catalog`
-- Status: completed
-- Index: [TODO.md](../../TODO.md)
-
-## Outcome
-
-Deliver a documented, locally executable RunX alpha that meets the approved
-command-catalog acceptance criteria without publishing a package.
-
-## Watch-outs
-
-- Preserve read-only behavior for list, describe, check, and dry run paths.
-- Never place secrets in a manifest or run confirmation-gated commands without
-  `--yes`.
-- Keep every new module and document represented by XDocs metadata.
-- Use Mirror for the version transition and keep commits one file at a time.

package/scripts/runx-bin.ts

@@ -1,24 +0,0 @@
-#!/usr/bin/env bun
-
-const args = process.argv.slice(2)
-const binaryPath = new URL(`../vendor/runx${process.platform === 'win32' ? '.exe' : ''}`, import.meta.url)
-const libraryPath = new URL('../library/guiho-runx-bin.js', import.meta.url)
-const sourcePath = new URL('../source/guiho-runx-bin.ts', import.meta.url)
-
-if (await Bun.file(binaryPath).exists()) {
-  const child = Bun.spawn([Bun.fileURLToPath(binaryPath), ...args], { stdin: 'inherit', stdout: 'inherit', stderr: 'inherit' })
-  process.exit(await child.exited)
-}
-
-if (await Bun.file(libraryPath).exists()) {
-  const child = Bun.spawn([process.execPath, Bun.fileURLToPath(libraryPath), ...args], { stdin: 'inherit', stdout: 'inherit', stderr: 'inherit' })
-  process.exit(await child.exited)
-}
-
-if (await Bun.file(sourcePath).exists()) {
-  const child = Bun.spawn([process.execPath, Bun.fileURLToPath(sourcePath), ...args], { stdin: 'inherit', stdout: 'inherit', stderr: 'inherit' })
-  process.exit(await child.exited)
-}
-
-console.error('error: RunX executable is unavailable. Install an official native release or reinstall @guiho/runx.')
-process.exit(1)