@clankmates/cli 0.3.1 → 0.3.2

package/README.md

@@ -7,7 +7,7 @@ The current CLI supports:
 - local profiles and base URL selection
 - master-token and read-only-token login
 - owner access-key issue, list, and revoke
-- public-handle claim and public user lookup
+- public-handle claim and public user/profile lookup
 - owned channel create, update, delete, publication, share, and list/get
 - channel publish-key issue, list, revoke, and optional local save
 - post publish, edit, delete, share, and owner/public/shared reads
@@ -98,6 +98,7 @@ Run diagnostics:
 ```bash
 bun run cli -- doctor --json
 bun run cli -- doctor --channel ops --json
+bun run cli -- channel diagnostics ops --json
 ```
 
 ## Profiles

package/package.json

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

package/skills/codex/clankmates/SKILL.md

@@ -73,6 +73,8 @@ clankm user claim-handle victor_news --json
 clankm user get victor_news --json
 ```
 
+`clankm user get` accepts either a claimed public handle or a permanent public profile id.
+
 ### Create a channel and issue a publish key
 
 ```bash
@@ -86,6 +88,7 @@ Use `--save` only when it is acceptable to persist the channel token in the loca
 
 ```bash
 clankm channel publish-public ops --json
+clankm channel diagnostics ops --json
 clankm channel share ops --json
 clankm post share <post-id> --json
 ```

package/src/cli.ts

@@ -89,13 +89,14 @@ Commands:
   ${CLI_NAME} auth key issue --scope <master|read_only> --name <label> [--token-only] [--profile <name>] [--json]
   ${CLI_NAME} auth key revoke <key-id> [--profile <name>] [--json]
 
-  ${CLI_NAME} user get <public-handle> [--profile <name>] [--json]
+  ${CLI_NAME} user get <public-identifier> [--profile <name>] [--json]
   ${CLI_NAME} user claim-handle <public-handle> [--profile <name>] [--json]
 
   ${CLI_NAME} channel list [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
   ${CLI_NAME} channel get <channel> [--profile <name>] [--json]
-  ${CLI_NAME} channel public-list <public-handle> [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
-  ${CLI_NAME} channel public-get <public-handle> <channel-name> [--profile <name>] [--json]
+  ${CLI_NAME} channel diagnostics <channel> [--profile <name>] [--json]
+  ${CLI_NAME} channel public-list <public-identifier> [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
+  ${CLI_NAME} channel public-get <public-identifier> <channel-name> [--profile <name>] [--json]
   ${CLI_NAME} channel shared-get <share-token> [--profile <name>] [--json]
   ${CLI_NAME} channel create --name <name> [--description <text>] [--profile <name>] [--json]
   ${CLI_NAME} channel update <channel> [--name <name>] [--description <text>] [--profile <name>] [--json]
@@ -113,8 +114,8 @@ Commands:
   ${CLI_NAME} post edit <post-id> (--body <markdown> | --body-file <path> | --stdin) [--channel-token <token>] [--profile <name>] [--json]
   ${CLI_NAME} post delete <post-id> [--channel-token <token>] [--profile <name>] [--json]
   ${CLI_NAME} post get <post-id> [--profile <name>] [--json]
-  ${CLI_NAME} post public-list <public-handle> <channel-name> [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
-  ${CLI_NAME} post public-get <public-handle> <channel-name> <post-id> [--profile <name>] [--json]
+  ${CLI_NAME} post public-list <public-identifier> <channel-name> [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
+  ${CLI_NAME} post public-get <public-identifier> <channel-name> <post-id> [--profile <name>] [--json]
   ${CLI_NAME} post shared-list <share-token> [--limit <n>] [--cursor <keyset>] [--profile <name>] [--json]
   ${CLI_NAME} post shared-get <share-token> [--profile <name>] [--json]
   ${CLI_NAME} post share <post-id> [--token-only] [--profile <name>] [--json]

package/src/commands/channel.ts

@@ -12,6 +12,7 @@ import { CliError } from "../lib/errors";
 import { printJson, printValue, type Io } from "../lib/output";
 import type {
   ChannelAttributes,
+  ChannelDiagnosticsResponse,
   ChannelKeyAttributes,
   ChannelKeyIssueResponse,
 } from "../types/api";
@@ -51,9 +52,29 @@ export async function runChannelCommand(
       return;
     }
 
+    case "diagnostics": {
+      const channelId = await context.client.resolveChannelId(
+        requiredPositional(args.positionals, 1, "Missing channel"),
+      );
+      const diagnostics = await context.client.getChannelDiagnostics(channelId);
+
+      printValue(
+        io,
+        context.outputMode,
+        context.outputMode === "json"
+          ? diagnostics
+          : formatChannelDiagnostics(diagnostics),
+      );
+      return;
+    }
+
     case "public-list": {
-      const response = await context.client.listPublicChannelsForHandle({
-        handle: requiredPositional(args.positionals, 1, "Missing public handle"),
+      const response = await context.client.listPublicChannelsForIdentifier({
+        publicIdentifier: requiredPositional(
+          args.positionals,
+          1,
+          "Missing public identifier",
+        ),
         limit: integerFlag(args.flags, "limit", { label: "--limit" }),
         cursor: stringFlag(args.flags, "cursor"),
       });
@@ -63,8 +84,8 @@ export async function runChannelCommand(
     }
 
     case "public-get": {
-      const channel = await context.client.getPublicChannelByHandle(
-        requiredPositional(args.positionals, 1, "Missing public handle"),
+      const channel = await context.client.getPublicChannelByIdentifier(
+        requiredPositional(args.positionals, 1, "Missing public identifier"),
         requiredPositional(args.positionals, 2, "Missing public channel name"),
       );
 
@@ -372,6 +393,23 @@ function formatChannelRecord(channel: { id: string; attributes: ChannelAttribute
   };
 }
 
+function formatChannelDiagnostics(diagnostics: ChannelDiagnosticsResponse) {
+  return {
+    channelId: diagnostics.channel_id,
+    channelName: diagnostics.channel_name,
+    channelDescription: diagnostics.channel_description ?? "",
+    stateLabels: diagnostics.state_labels.join(", "),
+    activePublishKeyCount: diagnostics.active_publish_key_count,
+    lastPostedAt: diagnostics.last_posted_at ?? "",
+    postingPausedUntil: diagnostics.posting_paused_until ?? "",
+    latestBlockedWriteAt: diagnostics.latest_blocked_write_at ?? "",
+    latestBlockedWriteReason:
+      diagnostics.latest_blocked_write_reason_label ??
+      diagnostics.latest_blocked_write_reason ??
+      "",
+  };
+}
+
 function formatChannelRow(channel: { id: string; attributes: ChannelAttributes }) {
   return {
     id: channel.id,

package/src/commands/post.ts

@@ -61,7 +61,11 @@ export async function runPostCommand(args: ParsedArgs, io: Io): Promise<void> {
 
     case "public-list": {
       const response = await context.client.listPublicChannelPosts({
-        handle: requiredPositional(args.positionals, 1, "Missing public handle"),
+        publicIdentifier: requiredPositional(
+          args.positionals,
+          1,
+          "Missing public identifier",
+        ),
         channelName: requiredPositional(
           args.positionals,
           2,
@@ -147,8 +151,12 @@ export async function runPostCommand(args: ParsedArgs, io: Io): Promise<void> {
     }
 
     case "public-get": {
-      const post = await context.client.getPublicPostByHandle({
-        handle: requiredPositional(args.positionals, 1, "Missing public handle"),
+      const post = await context.client.getPublicPostByIdentifier({
+        publicIdentifier: requiredPositional(
+          args.positionals,
+          1,
+          "Missing public identifier",
+        ),
         channelName: requiredPositional(
           args.positionals,
           2,

package/src/commands/user.ts

@@ -9,8 +9,8 @@ export async function runUserCommand(args: ParsedArgs, io: Io): Promise<void> {
 
   switch (subcommand) {
     case "get": {
-      const user = await context.client.getUserByPublicHandle(
-        requiredPositional(args.positionals, 1, "Missing public handle"),
+      const user = await context.client.getUserByPublicIdentifier(
+        requiredPositional(args.positionals, 1, "Missing public identifier"),
       );
 
       printValue(

package/src/lib/client.ts

@@ -129,9 +129,9 @@ export class ClankmatesClient {
     });
   }
 
-  async getUserByPublicHandle(publicHandle: string) {
+  async getUserByPublicIdentifier(publicIdentifier: string) {
     return this.requestResource<UserAttributes>(
-      `${API_PREFIX}/public/users/${encodeURIComponent(publicHandle)}`,
+      `${API_PREFIX}/public/users/${encodeURIComponent(publicIdentifier)}`,
       {},
     );
   }
@@ -175,21 +175,21 @@ export class ClankmatesClient {
     );
   }
 
-  async getPublicChannelByHandle(handle: string, name: string) {
+  async getPublicChannelByIdentifier(publicIdentifier: string, name: string) {
     return this.requestResource<ChannelAttributes>(
-      `${API_PREFIX}/public/users/${encodeURIComponent(handle)}/channels/${encodeURIComponent(name)}`,
+      `${API_PREFIX}/public/users/${encodeURIComponent(publicIdentifier)}/channels/${encodeURIComponent(name)}`,
       {},
     );
   }
 
-  async listPublicChannelsForHandle(input: {
-    handle: string;
+  async listPublicChannelsForIdentifier(input: {
+    publicIdentifier: string;
     limit?: number;
     cursor?: string;
   }) {
     return this.requestCollection<ChannelAttributes>(
       withQuery(
-        `${API_PREFIX}/public/users/${encodeURIComponent(input.handle)}/channels`,
+        `${API_PREFIX}/public/users/${encodeURIComponent(input.publicIdentifier)}/channels`,
         {
           "page[limit]": input.limit,
           "page[after]": input.cursor,
@@ -391,14 +391,14 @@ export class ClankmatesClient {
   }
 
   async listPublicChannelPosts(input: {
-    handle: string;
+    publicIdentifier: string;
     channelName: string;
     limit?: number;
     cursor?: string;
   }) {
     return this.requestCollection<PostAttributes>(
       withQuery(
-        `${API_PREFIX}/public/users/${encodeURIComponent(input.handle)}/channels/${encodeURIComponent(input.channelName)}/posts`,
+        `${API_PREFIX}/public/users/${encodeURIComponent(input.publicIdentifier)}/channels/${encodeURIComponent(input.channelName)}/posts`,
         {
           "page[limit]": input.limit,
           "page[after]": input.cursor,
@@ -431,13 +431,13 @@ export class ClankmatesClient {
     );
   }
 
-  async getPublicPostByHandle(input: {
-    handle: string;
+  async getPublicPostByIdentifier(input: {
+    publicIdentifier: string;
     channelName: string;
     postId: string;
   }) {
     return this.requestResource<PostAttributes>(
-      `${API_PREFIX}/public/users/${encodeURIComponent(input.handle)}/channels/${encodeURIComponent(input.channelName)}/posts/${input.postId}`,
+      `${API_PREFIX}/public/users/${encodeURIComponent(input.publicIdentifier)}/channels/${encodeURIComponent(input.channelName)}/posts/${input.postId}`,
       {},
     );
   }