Add post tag subcommand for tag management

Add support for managing post tags via CLI:
- post tag list: list all tags with pagination
- post tag get: show tag details
- post tag create: create a new tag
- post tag update: update an existing tag
- post tag delete: delete a tag

The implementation follows the same nested CLI pattern as comment reply.

Author: ruibaby

src/commands/post/__test__/tag-entry.spec.ts

@@ -0,0 +1,38 @@
+import { describe, expect, it, vi } from "vitest";
+
+import { tryRunPostCommand } from "../index.js";
+
+// Mock the tag module
+vi.mock("../tag.js", () => ({
+  buildTagCli: vi.fn(() => {
+    const mockCli = {
+      outputHelp: vi.fn(),
+      parse: vi.fn(),
+      matchedCommand: undefined,
+      args: [],
+      runMatchedCommand: vi.fn(),
+    };
+    return mockCli;
+  }),
+}));
+
+describe("tryRunPostCommand", () => {
+  const mockRuntime = {
+    getClientsForOptions: vi.fn(),
+  } as unknown as Parameters<typeof tryRunPostCommand>[1];
+
+  it("returns false for non-post commands", async () => {
+    const result = await tryRunPostCommand(["other"], mockRuntime);
+    expect(result).toBe(false);
+  });
+
+  it("handles tag subcommand", async () => {
+    const result = await tryRunPostCommand(["post", "tag", "list"], mockRuntime);
+    expect(result).toBe(true);
+  });
+
+  it("handles bare tag subcommand", async () => {
+    const result = await tryRunPostCommand(["post", "tag"], mockRuntime);
+    expect(result).toBe(true);
+  });
+});

src/commands/post/format.ts

@@ -1,4 +1,4 @@
-import type { ListedPostList, Post } from "@halo-dev/api-client";
+import type { ListedPostList, Post, Tag, TagList } from "@halo-dev/api-client";
 import Table from "cli-table3";
 import dayjs from "dayjs";
 import stringWidth from "string-width";
@@ -145,3 +145,91 @@ export function printPostDetail(detail: PostDetailPayload, json = false): void {
 
   process.stdout.write('\nUse "--json" to view the full content payload.\n');
 }
+
+function getTagListWidths(): number[] {
+  const width = resolveTerminalWidth();
+  const nameWidth = 36;
+  const slugWidth = 24;
+  const colorWidth = 10;
+  const createdAtWidth = 17;
+  const reservedWidth = nameWidth + slugWidth + colorWidth + createdAtWidth + 8;
+  const displayNameWidth = Math.min(Math.max(20, width - reservedWidth), 40);
+  return [nameWidth, displayNameWidth, slugWidth, colorWidth, createdAtWidth];
+}
+
+export function printTagList(list: TagList, json = false): void {
+  if (json) {
+    printJson(list);
+    return;
+  }
+
+  const widths = getTagListWidths();
+  const table = new Table({
+    head: ["NAME", "DISPLAY NAME", "SLUG", "COLOR", "CREATED AT"],
+    colWidths: widths,
+    colAligns: ["left", "left", "left", "left", "left"],
+    style: {
+      compact: true,
+      head: [],
+      border: [],
+      "padding-left": 0,
+      "padding-right": 0,
+    },
+    wordWrap: false,
+    chars: {
+      top: "",
+      "top-mid": "",
+      "top-left": "",
+      "top-right": "",
+      bottom: "",
+      "bottom-mid": "",
+      "bottom-left": "",
+      "bottom-right": "",
+      left: "",
+      "left-mid": "",
+      mid: "",
+      "mid-mid": "",
+      right: "",
+      "right-mid": "",
+      middle: "  ",
+    },
+  });
+
+  for (const item of list.items) {
+    table.push([
+      item.metadata.name,
+      truncateDisplayText(item.spec.displayName, widths[1]!),
+      truncateDisplayText(item.spec.slug, widths[2]!),
+      item.spec.color ?? "",
+      formatTimestamp(item.metadata.creationTimestamp ?? undefined),
+    ]);
+  }
+
+  process.stdout.write(`${table.toString()}\n`);
+  printPaginationFooter({
+    page: list.page,
+    size: list.size,
+    total: list.total,
+    totalPages: list.totalPages,
+    hasNext: list.hasNext,
+    hasPrevious: list.hasPrevious,
+    itemLabel: "tag",
+  });
+}
+
+export function printTag(tag: Tag, json = false, successMessage?: string): void {
+  if (json) {
+    printJson(tag);
+    return;
+  }
+
+  if (successMessage) {
+    process.stdout.write(`${successMessage}\n\n`);
+  }
+
+  printDetailObject({
+    metadata: tag.metadata,
+    spec: tag.spec,
+    status: tag.status,
+  });
+}

src/commands/post/index.ts

@@ -6,7 +6,7 @@ import { checkbox, input } from "@inquirer/prompts";
 import axios from "axios";
 import cac, { type CAC } from "cac";
 
-import { tryRunCommandCliRoute } from "../../utils/command-router.js";
+import { tryRunCommandCliRoute, tryRunNestedCliRoute } from "../../utils/command-router.js";
 import { confirmDangerousAction } from "../../utils/confirmation.js";
 import { DEFAULT_CONTENT_RAW_TYPE, renderContentByRawType } from "../../utils/content.js";
 import { CliError } from "../../utils/errors.js";
@@ -38,6 +38,7 @@ import {
   resolvePostMarkdownImportPayload,
   writePostMarkdownDocument,
 } from "./markdown.js";
+import { buildTagCli } from "./tag.js";
 import type { PostMutationInput } from "./types.js";
 
 interface PostCommandOptions {
@@ -1072,6 +1073,8 @@ function buildPostCli(runtime: RuntimeContext): CAC {
       });
     });
 
+  postCli.command("tag", "Tag management commands");
+
   postCli.usage("<command> [flags]");
   postCli.example((bin) => `${bin} list --page 1 --size 20`);
   postCli.example((bin) => `${bin} get my-post --json`);
@@ -1097,6 +1100,21 @@ function buildPostCli(runtime: RuntimeContext): CAC {
 }
 
 export async function tryRunPostCommand(args: string[], runtime: RuntimeContext): Promise<boolean> {
+  if (args[0] !== "post") {
+    return false;
+  }
+
+  if (
+    await tryRunNestedCliRoute({
+      branch: "tag",
+      cliName: "halo post tag",
+      args,
+      buildCli: () => buildTagCli(runtime),
+    })
+  ) {
+    return true;
+  }
+
   return tryRunCommandCliRoute({
     command: "post",
     cliName: "halo post",