@detergent-software/atk 8.9.0-dev.3 → 8.9.0-dev.31

package/build/command-manifest.json

@@ -0,0 +1,1507 @@
+[
+    {
+        "isDefault": false,
+        "name": "audit",
+        "description": "Verify asset integrity via checksum validation",
+        "file": "audit.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "browse",
+        "args": [
+            {
+                "description": "Pre-fill the filter text",
+                "name": "[filter]"
+            }
+        ],
+        "description": "Interactively browse the asset registry",
+        "file": "browse.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Filter assets by organization scope"
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Pre-select asset type filter (e.g., skill, agent, rule)"
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "cache",
+        "args": [
+            {
+                "description": "Cache subcommand: status (default), clean, or clear",
+                "name": "[subcommand]",
+                "choices": [
+                    "clean",
+                    "clear",
+                    "status"
+                ]
+            }
+        ],
+        "description": "Manage the registry cache",
+        "file": "cache.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "checkout",
+        "args": [
+            {
+                "description": "Asset name (kebab-case or @org/name)",
+                "name": "<name>"
+            },
+            {
+                "description": "Destination directory (defaults to ./<name> without the @org prefix)",
+                "name": "[dest]"
+            }
+        ],
+        "description": "Fetch a writable working copy of a registry asset",
+        "file": "checkout.js",
+        "options": [
+            {
+                "flags": "-f, --force",
+                "description": "Allow writing into a non-empty destination",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-V, --version [version]",
+                "description": "Specific version to check out (defaults to latest)"
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "config",
+        "args": [
+            {
+                "description": "Config key",
+                "name": "[key]"
+            },
+            {
+                "description": "Config value (set if provided)",
+                "name": "[value]"
+            }
+        ],
+        "description": "Get, set, list, or reset configuration values",
+        "file": "config.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-R, --reset",
+                "description": "Reset a key to its default value",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "deprecate",
+        "args": [
+            {
+                "description": "Asset or bundle name; accepts @org/name",
+                "name": "<name>"
+            }
+        ],
+        "description": "Deprecate an asset or bundle (or undo it) via PR, without publishing a version",
+        "file": "deprecate.js",
+        "options": [
+            {
+                "flags": "-b, --bundle",
+                "description": "The name is a bundle (same as --type bundle)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-d, --dry-run",
+                "description": "Show what would happen without creating the PR",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-m, --reason [reason]",
+                "description": "Why it is deprecated, shown to everyone who installs it (required unless --undo)"
+            },
+            {
+                "flags": "--replacement [replacement]",
+                "description": "What to use instead: name or @org/name of an asset or bundle in the registry"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Asset type, or \"bundle\", when the name exists more than once in the same scope",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config",
+                    "bundle"
+                ]
+            },
+            {
+                "flags": "--undo",
+                "description": "Remove the deprecation instead of setting it",
+                "defaultValue": false
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Skip confirmation prompt",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "diff",
+        "args": [
+            {
+                "description": "Asset name (supports @org/name syntax)",
+                "name": "<name>"
+            }
+        ],
+        "description": "Show changes between installed and latest version",
+        "file": "diff.js",
+        "options": [
+            {
+                "flags": "-C, --context [context]",
+                "description": "Number of context lines around each change",
+                "parse": "number",
+                "defaultValue": 3
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Organization scope of the asset to diff"
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "doctor",
+        "description": "Check environment health and diagnose issues",
+        "file": "doctor.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "drift",
+        "args": [
+            {
+                "description": "Path to the local asset directory (defaults to the current directory)",
+                "name": "[path]"
+            }
+        ],
+        "description": "Compare a local asset directory against the latest published version",
+        "file": "drift.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-n, --name [name]",
+                "description": "Asset name (name or @org/name) to compare against, overriding the manifest"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-V, --version [version]",
+                "description": "Compare against a specific published version (defaults to latest)"
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "freeze",
+        "args": [
+            {
+                "description": "Asset name to freeze (supports @org/name syntax)",
+                "name": "<name>"
+            }
+        ],
+        "description": "Freeze an installed asset to prevent sync and update from overwriting it",
+        "file": "freeze.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "index",
+        "description": "Agentic Tool Kit — manage assets for AI coding tools",
+        "file": "index.js"
+    },
+    {
+        "isDefault": false,
+        "name": "info",
+        "args": [
+            {
+                "description": "Asset or bundle name (supports name@version and @org/name syntax)",
+                "name": "<name>"
+            }
+        ],
+        "description": "Show details about an asset or bundle",
+        "file": "info.js",
+        "options": [
+            {
+                "flags": "-f, --full",
+                "description": "Show the whole README instead of the first 20 lines",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Filter assets by organization scope"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "-v, --verbose",
+                "description": "Show additional details like checksum",
+                "defaultValue": false
+            },
+            {
+                "flags": "-V, --version [version]",
+                "description": "Show info for a specific version (exact or semver range)"
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "init",
+        "args": [
+            {
+                "description": "Asset type (skill, agent, rule, hook, memory-template, mcp-config, bundle)",
+                "name": "<type>"
+            }
+        ],
+        "description": "Scaffold a new asset or bundle",
+        "file": "init.js",
+        "options": [
+            {
+                "flags": "-a, --author [author]",
+                "description": "Author name"
+            },
+            {
+                "flags": "--bundle-assets [bundle-assets]",
+                "description": "Comma-separated type:name pairs (skips bundle-assets prompt)"
+            },
+            {
+                "flags": "--dependency [dependency...]",
+                "description": "Dependency as type:name[@range], where range is a semver range or latest; repeat or comma-separate (e.g., --dependency skill:my-skill@^1.0.0). Skips the dependency search prompt; --dependency \"\" declares none"
+            },
+            {
+                "flags": "-d, --description [description]",
+                "description": "Short description"
+            },
+            {
+                "flags": "-F, --from [from]",
+                "description": "Fork from an installed asset name or a local file/directory path"
+            },
+            {
+                "flags": "-n, --name [name]",
+                "description": "Asset name (kebab-case)"
+            },
+            {
+                "flags": "-O, --offline",
+                "description": "Skip registry name availability check (as the global --offline does)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Organization scope for the new asset"
+            },
+            {
+                "flags": "--tags [tags]",
+                "description": "Comma-separated tags (skips tags prompt)"
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "install",
+        "args": [
+            {
+                "description": "Asset, bundle, or org scope to install (supports name@version and @org)",
+                "name": "[target]"
+            }
+        ],
+        "description": "Install an asset or bundle (no args syncs from lockfile)",
+        "file": "install.js",
+        "options": [
+            {
+                "flags": "-a, --all",
+                "description": "Install every asset from an org scope without prompting (for `atk install @org`; required with --json or no terminal)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-n, --dry-run",
+                "description": "Show what would be installed without making changes",
+                "defaultValue": false
+            },
+            {
+                "flags": "-f, --force",
+                "description": "Force reinstall even if already installed (with no asset: re-sync every asset, overwriting local edits)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Organization scope to resolve assets from"
+            },
+            {
+                "flags": "-p, --pin",
+                "description": "Pin the asset at the installed version",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache when syncing (no name); installing a name or @org always checks the registry",
+                "defaultValue": false
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Alias for --all: install every asset from an org scope without prompting",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "list",
+        "args": [],
+        "description": "List installed assets",
+        "file": "list.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "--project",
+                "description": "Show only the project, without the user scope",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "login",
+        "description": "Sign in with your Emergent (Microsoft Entra) account",
+        "file": "login.js",
+        "options": [
+            {
+                "flags": "-f, --force",
+                "description": "Discard the current session and sign in again",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "logout",
+        "description": "Sign out of your Emergent account",
+        "file": "logout.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "move",
+        "args": [
+            {
+                "description": "Asset name to move (supports @org/name syntax)",
+                "name": "<name>"
+            }
+        ],
+        "description": "Move an installed asset between the project and the user scope",
+        "file": "move.js",
+        "options": [
+            {
+                "flags": "--dry-run",
+                "description": "Show what would be installed and removed without making changes",
+                "defaultValue": false
+            },
+            {
+                "flags": "-f, --force",
+                "description": "Move a frozen asset with local edits (they are lost), and overwrite files at the target that ATK didn't install",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "The project side of the move (default: the project at the current directory)"
+            },
+            {
+                "flags": "--to <to>",
+                "description": "The scope to move the asset to: user (the user root, ~ by default) or project",
+                "choices": [
+                    "project",
+                    "user"
+                ]
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Asset type, when the name is installed as more than one type",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "outdated",
+        "description": "Show available updates for installed assets",
+        "file": "outdated.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "--project",
+                "description": "Check only the project, without the user scope",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Kept for compatibility: outdated always checks the registry for new versions",
+                "defaultValue": false
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Tool name shown in the output (e.g., claude-code); does not filter results"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "pin",
+        "args": [
+            {
+                "description": "Asset name (supports @org/name); an @version suffix must be the installed version. To pin another version, run atk install <name>@<version> --pin",
+                "name": "<name>"
+            }
+        ],
+        "description": "Pin an installed asset at its installed version",
+        "file": "pin.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "promote",
+        "args": [
+            {
+                "description": "Org-scoped asset or bundle name (e.g. @org/name)",
+                "name": "<name>"
+            }
+        ],
+        "description": "Promote an org-scoped asset or bundle to the global namespace",
+        "file": "promote.js",
+        "options": [
+            {
+                "flags": "-d, --dry-run",
+                "description": "Show what would happen without creating the PR",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "No longer used (the plan always comes from the live registry); kept for compatibility",
+                "defaultValue": false
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Asset type, or \"bundle\", when the name exists more than once in the org",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config",
+                    "bundle"
+                ]
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Skip confirmation prompt",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "prune",
+        "description": "Remove orphaned dependencies",
+        "file": "prune.js",
+        "options": [
+            {
+                "flags": "-n, --dry-run",
+                "description": "Show what would be pruned without making changes",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Skip confirmation prompt",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "publish",
+        "args": [
+            {
+                "description": "Path to asset/bundle directory (with manifest), or path to a raw file/directory to publish without scaffolding. When --update or --from-installed is used, this is an installed asset name",
+                "name": "<path>"
+            },
+            {
+                "description": "More asset folders (each with a manifest.json) to publish with the first in one PR, all or nothing; no bundles",
+                "name": "[paths...]"
+            }
+        ],
+        "description": "Publish one or more assets, or a bundle, to the registry",
+        "file": "publish.js",
+        "options": [
+            {
+                "flags": "--bump [bump]",
+                "description": "Auto-bump version when registry has the same or newer version (patch|minor|major); applies to every asset that needs it",
+                "choices": [
+                    "patch",
+                    "minor",
+                    "major"
+                ]
+            },
+            {
+                "flags": "--description [description]",
+                "description": "Asset description (skips interactive prompt); one path only"
+            },
+            {
+                "flags": "-d, --dry-run",
+                "description": "Show what would happen (including how dependencies resolve) without creating the PR",
+                "defaultValue": false
+            },
+            {
+                "flags": "-f, --force",
+                "description": "Bypass org-mismatch safety check (manifest.org vs lockfile.org)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-i, --from-installed",
+                "description": "Treat the path argument as an installed asset name; one path only",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-m, --message [message]",
+                "description": "Custom message appended to the auto-generated PR description"
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "--reviewer [reviewer]",
+                "description": "Comma-separated GitHub usernames to request as PR reviewers (needs at least one org-scoped asset)"
+            },
+            {
+                "flags": "--tags [tags]",
+                "description": "Comma-separated tags (skips interactive prompt); one path only"
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "--tools [tools]",
+                "description": "Comma-separated list of compatible tools (skips tools-detection prompt); one path only"
+            },
+            {
+                "flags": "-u, --update",
+                "description": "Publish an update using locally modified installed files; one path only",
+                "defaultValue": false
+            },
+            {
+                "flags": "--with [folder...]",
+                "description": "Folder of a new dependency (an asset with a manifest.json) to publish in the same PR; repeat for each one"
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Skip confirmation prompts (use with --description, --tags, etc.)",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "register",
+        "args": [
+            {
+                "description": "Target directory containing the asset files",
+                "name": "<path>"
+            }
+        ],
+        "description": "Drop a manifest.json into an existing local directory",
+        "file": "register.js",
+        "options": [
+            {
+                "flags": "-a, --author [author]",
+                "description": "Author name"
+            },
+            {
+                "flags": "-d, --description [description]",
+                "description": "Short description"
+            },
+            {
+                "flags": "-e, --entrypoint [entrypoint]",
+                "description": "Override auto-detected entrypoint (relative to target dir)"
+            },
+            {
+                "flags": "-f, --force",
+                "description": "Overwrite an existing manifest.json",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-n, --name [name]",
+                "description": "Asset name (kebab-case or @org/name)"
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Organization scope (alternative to @org/ prefix on --name)"
+            },
+            {
+                "flags": "--tags [tags]",
+                "description": "Comma-separated tags"
+            },
+            {
+                "flags": "--tools [tools]",
+                "description": "Comma-separated compatible tools (e.g., claude-code)"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "release-notes",
+        "args": [
+            {
+                "description": "A specific version to show notes for (e.g. 1.3.0)",
+                "name": "[version]"
+            }
+        ],
+        "description": "Show ATK release notes — recent history or a specific version",
+        "file": "release-notes.js",
+        "options": [
+            {
+                "flags": "-a, --all",
+                "description": "Show the full release history instead of just the 15 most recent",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-p, --prerelease",
+                "description": "Include pre-releases (-dev.N, betas) in the listing (default when running a pre-release build)",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "reviewer",
+        "args": [
+            {
+                "description": "Comma-separated GitHub usernames to set as reviewers",
+                "name": "[reviewers]"
+            }
+        ],
+        "description": "Get, set, or clear the designated PR reviewers for org-scoped asset publishes",
+        "file": "reviewer.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-R, --reset",
+                "description": "Clear the configured reviewers",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "schema",
+        "args": [
+            {
+                "description": "Schema to show: skill | agent | rule | hook | memory-template | mcp-config | bundle | adapter | lockfile | config | registry",
+                "name": "<schema>",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config",
+                    "bundle",
+                    "adapter",
+                    "lockfile",
+                    "config",
+                    "registry"
+                ]
+            }
+        ],
+        "description": "Show the schema for an asset type, bundle, adapter, lockfile, config, or registry",
+        "file": "schema.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output JSON Schema instead of the field table",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "search",
+        "args": [
+            {
+                "description": "Search query",
+                "name": "<query>"
+            }
+        ],
+        "description": "Search for assets and bundles in the registry",
+        "file": "search.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Filter assets by organization scope"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-g, --tag [tag]",
+                "description": "Filter by tag"
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Filter by tool compatibility"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by type (skill, agent, rule, hook, memory-template, mcp-config, bundle)"
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "setup",
+        "description": "Initialize ATK in a project or the user scope — select tools and create config files",
+        "file": "setup.js",
+        "options": [
+            {
+                "flags": "--json",
+                "description": "Output as JSON",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Set the organization scope"
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-T, --tool [tools...]",
+                "description": "Tool(s) to configure; repeat the flag or comma-separate (e.g., --tool claude-code --tool codex-cli). Replaces the tools list in .atkrc.json"
+            },
+            {
+                "flags": "--user",
+                "description": "Set up the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Skip interactive prompts (use defaults)",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "sync",
+        "description": "Re-apply drifted installed assets, keeping local edits (use --force to re-apply all)",
+        "file": "sync.js",
+        "options": [
+            {
+                "flags": "-n, --dry-run",
+                "description": "Show what would be synced without making changes",
+                "defaultValue": false
+            },
+            {
+                "flags": "-f, --force",
+                "description": "Force re-sync all assets, not just drifted ones, overwriting local edits",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "thaw",
+        "args": [
+            {
+                "description": "Asset name to thaw",
+                "name": "<name>"
+            }
+        ],
+        "description": "Thaw a frozen asset to allow sync and update to overwrite it again",
+        "file": "thaw.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "uninstall",
+        "args": [
+            {
+                "description": "Asset or bundle name to uninstall",
+                "name": "<name>"
+            }
+        ],
+        "description": "Uninstall an asset or bundle",
+        "file": "uninstall.js",
+        "options": [
+            {
+                "flags": "--no-cascade",
+                "description": "Cascade-remove orphaned dependencies (use --no-cascade to disable)",
+                "defaultValue": true
+            },
+            {
+                "flags": "-n, --dry-run",
+                "description": "Show what would be uninstalled without making changes",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-o, --org [org]",
+                "description": "Org scope of the asset to uninstall (overridden by @org/name syntax)"
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Bypass the registry cache and fetch fresh data",
+                "defaultValue": false
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Uninstall for this tool only (e.g., codex-cli); other tools keep the asset and its lockfile entry"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Type of the asset to uninstall, when the name is installed as more than one type",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Skip confirmation prompt",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "unpin",
+        "args": [
+            {
+                "description": "Asset name to unpin",
+                "name": "<name>"
+            }
+        ],
+        "description": "Remove a version pin from an installed asset",
+        "file": "unpin.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "unpublish",
+        "args": [
+            {
+                "description": "Asset or bundle name; accepts @org/name and optional @version (e.g. my-skill@1.0.0)",
+                "name": "<name>"
+            }
+        ],
+        "description": "Unpublish an asset or bundle from the registry via PR",
+        "file": "unpublish.js",
+        "options": [
+            {
+                "flags": "-d, --dry-run",
+                "description": "Show what would happen without creating the PR",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "No longer used (the plan always comes from the live registry); kept for compatibility",
+                "defaultValue": false
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Asset type, or \"bundle\", when the name exists more than once in the same scope",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config",
+                    "bundle"
+                ]
+            },
+            {
+                "flags": "-y, --yes",
+                "description": "Skip confirmation prompt",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "update",
+        "args": [
+            {
+                "description": "Asset name (updates all if omitted, supports name@version syntax)",
+                "name": "[name]"
+            }
+        ],
+        "description": "Update installed assets",
+        "file": "update.js",
+        "options": [
+            {
+                "flags": "-n, --dry-run",
+                "description": "Show what would be updated without making changes",
+                "defaultValue": false
+            },
+            {
+                "flags": "-f, --force",
+                "description": "Override version pins on targeted assets, and overwrite local edits",
+                "defaultValue": false
+            },
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-r, --refresh",
+                "description": "Kept for compatibility: update always checks the registry for new versions",
+                "defaultValue": false
+            },
+            {
+                "flags": "-T, --tool [tool]",
+                "description": "Target tool (e.g., claude-code)"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Type of the asset to update, when the name is installed as more than one type",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "whoami",
+        "description": "Show who you are signed in as and where the credential came from",
+        "file": "whoami.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            }
+        ]
+    },
+    {
+        "isDefault": false,
+        "name": "why",
+        "args": [
+            {
+                "description": "Asset name",
+                "name": "<name>"
+            }
+        ],
+        "description": "Explain why an asset is installed",
+        "file": "why.js",
+        "options": [
+            {
+                "flags": "-j, --json",
+                "description": "Output raw JSON (for scripting and CI)",
+                "defaultValue": false
+            },
+            {
+                "flags": "-P, --project-root [project-root]",
+                "description": "Override project root directory"
+            },
+            {
+                "flags": "-t, --type [type]",
+                "description": "Filter by asset type (skill, agent, rule, hook, memory-template, mcp-config)",
+                "choices": [
+                    "skill",
+                    "agent",
+                    "rule",
+                    "hook",
+                    "memory-template",
+                    "mcp-config"
+                ]
+            },
+            {
+                "flags": "--user",
+                "description": "Use the user scope (the user root, ~ by default) instead of the project",
+                "defaultValue": false
+            }
+        ]
+    }
+]