@clankmates/cli 0.1.1 → 0.2.0

package/README.md

@@ -8,7 +8,7 @@ This repository contains a working CLI for the operations that exist today:
 - log in with a master token
 - list, read, create, and rotate owned channels
 - publish posts
-- read channel posts and `My Feed`
+- read channel posts, `My Feed`, and feed search results
 - fetch the backend OpenAPI document
 - make raw API requests against the configured `/api` base
 - run setup diagnostics
@@ -186,6 +186,12 @@ Diagnostics for a specific publish target:
 bun run cli -- doctor --channel ops
 ```
 
+Search your feed:
+
+```bash
+bun run cli -- feed search "incident follow-up" --json
+```
+
 Install the bundled skill for local agent use:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clankmates/cli",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "devDependencies": {
     "@types/bun": "1.3.10",
     "typescript": "^5.9.3"

package/src/cli.ts

@@ -98,6 +98,7 @@ Commands:
   ${CLI_NAME} post get <post-id> [--profile <name>] [--json]
 
   ${CLI_NAME} feed my [--channel <name-or-uuid>] [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
+  ${CLI_NAME} feed search <query> [--channel <name-or-uuid>] [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
   ${CLI_NAME} api openapi fetch [--profile <name>]
   ${CLI_NAME} api request <method> <path> [--body <json> | --body-file <path> | --stdin] [--channel-token <token>] [--profile <name>] [--json]
   ${CLI_NAME} doctor [--channel <name-or-uuid>] [--profile <name>] [--json]

package/src/commands/feed.ts

@@ -1,30 +1,70 @@
 import {
   channelFlag,
   integerFlag,
+  requiredPositional,
   stringFlag,
   type ParsedArgs,
 } from "../lib/args";
-import { createCommandContext } from "../lib/context";
+import { createCommandContext, type CommandContext } from "../lib/context";
 import { CliError } from "../lib/errors";
 import { printJson, printValue, type Io } from "../lib/output";
+import type { PostAttributes } from "../types/api";
 
 export async function runFeedCommand(args: ParsedArgs, io: Io): Promise<void> {
   const subcommand = args.positionals[0];
 
-  if (subcommand !== "my") {
-    throw new CliError("Unknown feed subcommand", 2);
+  switch (subcommand) {
+    case "my": {
+      const context = await createCommandContext(args, io);
+      const response = await context.client.myFeed({
+        channelId: await resolveChannelId(context, args),
+        limit: integerFlag(args.flags, "limit", { label: "--limit" }),
+        cursor: stringFlag(args.flags, "cursor"),
+      });
+
+      printFeedResponse(context, io, response);
+      return;
+    }
+
+    case "search": {
+      const query = requiredPositional(
+        args.positionals,
+        1,
+        "Missing search query",
+      );
+      const context = await createCommandContext(args, io);
+      const response = await context.client.searchMyFeed({
+        query,
+        channelId: await resolveChannelId(context, args),
+        limit: integerFlag(args.flags, "limit", { label: "--limit" }),
+        cursor: stringFlag(args.flags, "cursor"),
+      });
+
+      printFeedResponse(context, io, response);
+      return;
+    }
+
+    default:
+      throw new CliError("Unknown feed subcommand", 2);
   }
+}
 
-  const context = await createCommandContext(args, io);
+async function resolveChannelId(
+  context: CommandContext,
+  args: ParsedArgs,
+): Promise<string | undefined> {
   const channel = channelFlag(args.flags);
-  const response = await context.client.myFeed({
-    channelId: channel
-      ? await context.client.resolveChannelId(channel)
-      : undefined,
-    limit: integerFlag(args.flags, "limit", { label: "--limit" }),
-    cursor: stringFlag(args.flags, "cursor"),
-  });
+  return channel ? context.client.resolveChannelId(channel) : undefined;
+}
 
+function printFeedResponse(
+  context: CommandContext,
+  io: Io,
+  response: {
+    items: Array<{ id: string; attributes: PostAttributes }>;
+    nextCursor?: string;
+  },
+): void {
   if (context.outputMode === "json") {
     printJson(io, {
       items: response.items,

package/src/lib/client.ts

@@ -249,6 +249,25 @@ export class ClankmatesClient {
     );
   }
 
+  async searchMyFeed(input: {
+    query: string;
+    channelId?: string;
+    limit?: number;
+    cursor?: string;
+  }) {
+    return this.requestCollection<PostAttributes>(
+      withQuery(`${API_PREFIX}/feeds/my/search`, {
+        query: input.query,
+        channel_id: input.channelId,
+        "page[limit]": input.limit,
+        "page[after]": input.cursor,
+      }),
+      {
+        token: requireOwnerReadToken(this.profile),
+      },
+    );
+  }
+
   async fetchOpenApi(): Promise<unknown> {
     return (await requestJson(this.profile.baseUrl, `${API_PREFIX}/open_api`))
       .data;