@ahood/cli 0.8.5 → 0.8.6

package/README.md

@@ -244,8 +244,8 @@ Sharing is additive -- it doesn't change `alice/pdf-tools`'s own public/private
 | Command | What it does |
 | --- | --- |
 | `ahood snap create <content> [--tags tag1,tag2] [--json]` | Capture a new private snap, from an argument or piped stdin. |
-| `ahood snap list [--json] [--limit <n>]` | List your own snaps, most recent first. |
-| `ahood snap search <query> [--json] [--limit <n>]` | Search your own snaps by content. |
+| `ahood snap list [--json] [--limit <n>] [--tags tag1,tag2]` | List your own snaps, most recent first. |
+| `ahood snap search <query> [--json] [--limit <n>] [--tags tag1,tag2]` | Search your own snaps by content. |
 | `ahood snap show <id> [--json]` | Print a single snap's full content. |
 | `ahood snap remove <id> [--yes]` | Permanently delete a snap (prompts for confirmation unless --yes is passed). |
 | `ahood snap share <id> [--json]` | Mint (or return the existing) shareable link for a snap. |

package/dist/commands/snap.js

@@ -3,8 +3,8 @@ import { flagValue, parseSearchQuery } from "../flags.js";
 import { confirm } from "../confirm.js";
 import { UsageError } from "../usage-error.js";
 const CREATE_USAGE = "Usage: ahood snap create <content> [--tags tag1,tag2] (or pipe content on stdin)";
-const LIST_USAGE = "Usage: ahood snap list [--json] [--limit <n>]";
-const SEARCH_USAGE = "Usage: ahood snap search <query> [--json] [--limit <n>]";
+const LIST_USAGE = "Usage: ahood snap list [--json] [--limit <n>] [--tags tag1,tag2]";
+const SEARCH_USAGE = "Usage: ahood snap search <query> [--json] [--limit <n>] [--tags tag1,tag2]";
 const SHOW_USAGE = "Usage: ahood snap show <id> [--json]";
 const REMOVE_USAGE = "Usage: ahood snap remove <id> [--yes]";
 const SHARE_USAGE = "Usage: ahood snap share <id> [--json]";
@@ -113,10 +113,19 @@ export async function createSnap(args) {
 export async function listSnaps(args) {
     const jsonOutput = args.includes("--json");
     const limitStr = flagValue(args, "--limit");
+    const tagsStr = flagValue(args, "--tags");
     validateLimit(limitStr, LIST_USAGE);
     const qs = new URLSearchParams();
     if (limitStr !== undefined)
         qs.set("limit", limitStr);
+    // Passed through verbatim rather than split/trimmed the way createSnap's
+    // own --tags is: the server owns what a tag filter means (comma-separated,
+    // ANDed, case-insensitive, 400 past 8 terms) and deliberately keeps an
+    // unstorable term instead of dropping it, since dropping one would silently
+    // broaden the result set. Re-parsing here would be a second implementation
+    // of that contract, free to drift from it (ahood-cli#118).
+    if (tagsStr !== undefined)
+        qs.set("tags", tagsStr);
     const query = qs.toString();
     const { snaps } = await apiJson(`/api/v1/snaps${query ? `?${query}` : ""}`);
     // ?? [], not a bare destructure -- a degraded response (snaps: null)
@@ -127,11 +136,19 @@ export async function listSnaps(args) {
 export async function searchSnaps(args) {
     const jsonOutput = args.includes("--json");
     const limitStr = flagValue(args, "--limit");
-    const query = parseSearchQuery(args, SEARCH_USAGE);
+    const tagsStr = flagValue(args, "--tags");
+    // --tags declared here so its VALUE isn't swallowed into the joined query
+    // string -- `snap search deploy --tags ci` must search for "deploy" filtered
+    // to tag "ci", not for "deploy ci" (ahood-cli#118).
+    const query = parseSearchQuery(args, SEARCH_USAGE, ["--tags"]);
     validateLimit(limitStr, SEARCH_USAGE);
     const qs = new URLSearchParams({ q: query });
     if (limitStr !== undefined)
         qs.set("limit", limitStr);
+    // Verbatim -- see listSnaps' identical pass-through above (ahood-cli#118).
+    // The server ANDs a tag filter with `q`, so this narrows the text results.
+    if (tagsStr !== undefined)
+        qs.set("tags", tagsStr);
     const { snaps } = await apiJson(`/api/v1/snaps?${qs}`);
     // ?? [] -- see listSnaps' identical guard above (ahood-cli#106).
     printSnaps(jsonOutput, snaps ?? [], "No snaps found.");

package/dist/flags.js

@@ -36,8 +36,18 @@ export function flagValue(args, flag) {
 // --limit (both "--limit N" and "--limit=N" forms) from the positional
 // args, rejects any other unrecognized "--" flag, and joins what's left
 // into a single query string.
-export function parseSearchQuery(args, usage) {
-    const queryParts = args.filter((a, i) => a !== "--json" && a !== "--limit" && !a.startsWith("--limit=") && args[i - 1] !== "--limit");
+// `valueFlags` names ADDITIONAL "--flag value" flags this particular command
+// accepts (snap search's --tags, ahood-cli#118), on top of --limit, which
+// every caller takes. Passed per-caller rather than stripping a shared union
+// of every search-ish flag, so `ahood skill search --tags x` still errors on
+// a flag that command doesn't implement instead of silently ignoring it and
+// returning unfiltered results.
+export function parseSearchQuery(args, usage, valueFlags = []) {
+    const stripped = ["--limit", ...valueFlags];
+    const queryParts = args.filter((a, i) => a !== "--json" &&
+        !stripped.includes(a) &&
+        !stripped.some((f) => a.startsWith(`${f}=`)) &&
+        !stripped.includes(args[i - 1]));
     const unknownFlag = queryParts.find((a) => a.startsWith("--"));
     if (unknownFlag)
         throw new UsageError(`Unknown flag: ${unknownFlag}\n${usage}`);

package/dist/help.js

@@ -294,24 +294,29 @@ export const SNAP_COMMANDS_HELP = [
         ],
     },
     {
-        usage: "ahood snap list [--json] [--limit <n>]",
+        usage: "ahood snap list [--json] [--limit <n>] [--tags tag1,tag2]",
         summary: "List your own snaps, most recent first.",
         desc: "List your own snaps: id, a truncated content preview, created_at, a (shared) marker if shared, and " +
-            "any tags in brackets.",
+            "any tags in brackets. --tags narrows the list to snaps carrying every tag given (not any of them), " +
+            "matched case-insensitively.",
         flags: [
-            "--json        Emit the raw snap objects instead of formatted lines.",
-            "--limit <n>   Cap the number of results.",
+            "--json               Emit the raw snap objects instead of formatted lines.",
+            "--limit <n>          Cap the number of results.",
+            "--tags tag1,tag2     Only snaps carrying ALL of these tags. Case-insensitive; at most 8.",
         ],
+        examples: ["ahood snap list --tags deploy", "ahood snap list --tags deploy,bugfix --limit 5"],
     },
     {
-        usage: "ahood snap search <query> [--json] [--limit <n>]",
+        usage: "ahood snap search <query> [--json] [--limit <n>] [--tags tag1,tag2]",
         summary: "Search your own snaps by content.",
-        desc: "Search your own snaps by content. Same output shape as `ahood snap list`.",
+        desc: "Search your own snaps by content. Same output shape as `ahood snap list`. The query matches snap " +
+            "CONTENT only and never a tag -- use --tags to filter by tag, which narrows the text results further.",
         flags: [
-            "--json        Emit the raw snap objects instead of formatted lines.",
-            "--limit <n>   Cap the number of results.",
+            "--json               Emit the raw snap objects instead of formatted lines.",
+            "--limit <n>          Cap the number of results.",
+            "--tags tag1,tag2     Only snaps carrying ALL of these tags. Case-insensitive; at most 8.",
         ],
-        examples: ["ahood snap search flaky-ci"],
+        examples: ["ahood snap search flaky-ci", "ahood snap search deploy --tags ci"],
     },
     {
         usage: "ahood snap show <id> [--json]",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ahood/cli",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "CLI for ahood, a registry for installing and publishing Claude Code skills.",
   "license": "MIT",
   "homepage": "https://github.com/AlexKay28/ahood-cli",