@ahood/cli 0.3.4 → 0.3.6

package/README.md

@@ -29,30 +29,32 @@ For CI or any non-interactive environment, set `AHOOD_TOKEN` instead of running
 
 ## Commands
 
-<!-- Kept in sync by hand with cli/src/help.ts's COMMANDS_HELP (the terminal
-     --help output's source) and app/docs/page.tsx's COMMANDS array -- update
-     all three when a command changes. -->
+<!-- Generated from src/help.ts's COMMANDS_HELP by scripts/sync-readme.mjs --
+     do not hand-edit the table below. Run `npm run sync-readme` after
+     changing COMMANDS_HELP to regenerate it. -->
 
+<!-- COMMANDS_TABLE_START -->
 | Command | What it does |
 | --- | --- |
-| `ahood login` | Device-code browser login, stores a token at `~/.config/ahood/credentials.json` (or `$XDG_CONFIG_HOME/ahood/`). |
+| `ahood login` | Device-code browser login, stores a token locally. |
 | `ahood logout` | Removes the stored token. |
 | `ahood whoami [--json]` | Reports whether your stored token still authenticates. |
 | `ahood search <query> [--json] [--limit <n>]` | Search published skills. |
-| `ahood view <owner>/<skill> [--json] [--web]` (alias: `show`) | Show a single skill's details -- tags, license, homepage, repository, dates, etc. -- without installing it, or open its page in a browser. |
-| `ahood versions <owner>/<skill> [--json]` | List a skill's published-version history -- version, changelog, size, and publish date. Most-recent first. |
-| `ahood list-mine [--json]` | List your own skills, public and private, with their visibility and download/star counts. |
-| `ahood add <owner>/<skill>[@version]` | Install into `.claude/skills/<owner>/<skill>/`, pinned in `.claude/skills.lock.json`. |
-| `ahood update [<owner>/<skill> ...] [--dry-run] [--json]` | Move the lockfile pin(s) forward to the latest version. One skill failing to update doesn't stop the rest. `--dry-run` previews current vs. latest version (plus the changelog for anything behind) without installing anything; add `--json` for structured output. |
-| `ahood remove <owner>/<skill>` | Uninstall and unpin (local only -- does not affect the published skill). |
-| `ahood edit <owner>/<skill> [--tagline] [--tags] [--license] [--visibility] [--homepage] [--repository]` | Update a skill you own. Only the flags you pass are changed; requires the `publish` scope. |
-| `ahood unpublish <owner>/<skill>[@version] [--yes]` | Without `@version`, deletes the skill from the registry for every consumer, not just your local install. With `@version`, yanks just that version instead of deleting the whole skill -- it's marked yanked, not removed; existing lockfile pins still resolve, but new installs are warned off it. Prompts for a typed "yes" confirmation, or pass `--yes` for scripts/CI. |
+| `ahood view\|show <owner>/<skill> [--json] [--web]` | Show a single skill's details -- tags, license, homepage, repository, dates, and more -- without installing it (alias: ahood show). |
+| `ahood versions <owner>/<skill> [--json]` | List a skill's published-version history -- version, changelog, size, and publish date. |
+| `ahood list-mine [--json]` | List your own skills, public and private. |
+| `ahood add <owner>/<skill>[@version]` | Install a skill into .claude/skills/, pinned in the lockfile. |
+| `ahood update [<owner>/<skill> ...] [--dry-run] [--json]` | Move the lockfile pin(s) forward to the latest version, for one skill or all installed skills at once. |
+| `ahood remove <owner>/<skill>` | Uninstall and unpin a skill (local only). |
+| `ahood edit <owner>/<skill> [--tagline] [--tags] [--license] [--visibility] [--homepage] [--repository]` | Update a skill you own, changing only the flags you pass. |
+| `ahood unpublish <owner>/<skill>[@version] [--yes]` | Delete a skill from the registry for every consumer, or yank a single version, not just your local install (prompts for confirmation unless --yes is passed). |
 | `ahood star <owner>/<skill>` | Star a skill. |
 | `ahood unstar <owner>/<skill>` | Remove your star from a skill. |
-| `ahood init [name]` | Scaffold a new skill folder with a minimal, valid `SKILL.md` -- `./<name>/SKILL.md` if a name is given, `./SKILL.md` otherwise. Refuses to overwrite an existing `SKILL.md`. |
-| `ahood publish <owner>/<skill>@<version> [--path <dir>] [--name] [--tagline] [--tags] [--license] [--homepage] [--repository] [--json]` | Publish a new version of a skill from a folder containing `SKILL.md` (defaults to the current directory). If the skill doesn't exist yet, creates it first -- `--name` is required in that case; `--tagline`/`--tags`/`--license`/`--homepage`/`--repository` are optional and only used at creation. Processing (validation, checksumming, secret scanning) happens server-side after upload; this command polls and reports the final published/failed status. `--json` suppresses human progress lines and prints one `{version,status,...}` JSON object on completion instead. The legacy form `ahood publish <path> --owner <owner> --slug <skill> --version <x.y.z>` is still accepted. |
-| `ahood token create <name>\|list [--json]\|revoke <id>` | Manage personal API tokens. Creating a token requires an existing logged-in session -- see the docs. |
+| `ahood init [name]` | Scaffold a new skill folder with a minimal, valid SKILL.md. |
+| `ahood publish <owner>/<skill>@<version> [--path <dir>] [--name <text>] [--tagline <text>] [--tags <comma,separated>] [--license <id>] [--homepage <url>] [--repository <url>] [--json]` | Publish a new version of a skill from a folder containing SKILL.md, creating the skill first if it doesn't already exist. |
+| `ahood token create <name>\|list [--json]\|revoke <id> [--yes]` | Manage personal API tokens. |
 | `ahood completion <bash\|zsh\|fish>` | Print a shell completion script for the command names. |
+<!-- COMMANDS_TABLE_END -->
 
 Run `ahood help`, `ahood help <command>`, or `ahood <command> --help` for the same reference directly in your terminal. `ahood --version` prints the installed CLI version.
 

package/dist/commands/edit.js

@@ -48,4 +48,7 @@ export async function edit(args) {
         body: JSON.stringify(body),
     });
     console.log(`Updated ${owner}/${updated.slug}: tagline=${JSON.stringify(updated.tagline)}, license=${JSON.stringify(updated.license)}, visibility=${updated.visibility}, tags=[${updated.tags.join(", ")}]`);
+    if (updated.tags_warning) {
+        console.warn(`WARNING: ${updated.tags_warning}`);
+    }
 }

package/dist/commands/unpublish.js

@@ -55,8 +55,18 @@ export async function unpublish(args) {
         // just scoped one level down to skill_versions.yanked_at/yanked_reason
         // instead of skills.deleted_at. Mirroring that existing verb/path
         // convention rather than inventing a new one.
-        await apiJson(`/api/v1/skills/${encodeURIComponent(owner)}/${encodeURIComponent(skill)}/versions/${encodeURIComponent(version)}`, { method: "DELETE" });
+        const result = await apiJson(`/api/v1/skills/${encodeURIComponent(owner)}/${encodeURIComponent(skill)}/versions/${encodeURIComponent(version)}`, { method: "DELETE" });
         console.log(`Yanked ${key}. Existing lockfile pins still resolve; new installs will be warned off it.`);
+        // yankVersion (lib/skills/mutations.ts) still returns ok:true here even
+        // when the yank itself succeeded but the latest_version_id recompute
+        // that follows it failed -- it attaches this field instead of failing
+        // the whole request, since the yank already took effect. Discarding the
+        // response body would silently drop that signal (ahood-cli#68): the
+        // pointer could now be stale with nothing in the terminal to say so, and
+        // a later `ahood add owner/skill` trusts latest_version_id completely.
+        if (result.latest_version_warning) {
+            console.warn(`WARNING: ${result.latest_version_warning}`);
+        }
         return;
     }
     const { owner, skill } = parseOwnerSkill(spec, USAGE);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahood/cli",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "CLI for ahood, a registry for installing and publishing Claude Code skills.",
   "license": "MIT",
   "homepage": "https://github.com/AlexKay28/ahood-cli",
@@ -28,7 +28,8 @@
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "prepublishOnly": "npm run build",
-    "test": "vitest run"
+    "test": "vitest run",
+    "sync-readme": "node scripts/sync-readme.mjs"
   },
   "dependencies": {
     "tar-stream": "^3.2.1"