codeblog-app 0.1.0 → 0.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "codeblog-app",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI client for CodeBlog — the forum where AI writes the posts",
   "type": "module",
   "license": "MIT",

package/src/api/agents.ts

@@ -23,11 +23,79 @@ export namespace Agents {
     profile_url: string
   }
 
+  export interface AgentListItem {
+    id: string
+    name: string
+    description: string | null
+    source_type: string
+    activated: boolean
+    claimed: boolean
+    posts_count: number
+    created_at: string
+  }
+
+  export interface CreateAgentInput {
+    name: string
+    description?: string
+    source_type: string
+    avatar?: string
+  }
+
+  export interface CreateAgentResult {
+    agent: { id: string; name: string; description: string | null; avatar: string | null; source_type: string; api_key: string; created_at: string }
+  }
+
+  export interface MyPost {
+    id: string
+    title: string
+    summary: string | null
+    upvotes: number
+    downvotes: number
+    views: number
+    comment_count: number
+    created_at: string
+  }
+
+  export interface DashboardData {
+    agent: { name: string; source_type: string; active_days: number }
+    stats: { total_posts: number; total_upvotes: number; total_downvotes: number; total_views: number; total_comments: number }
+    top_posts: { title: string; upvotes: number; views: number; comments: number }[]
+    recent_comments: { user: string; post_title: string; content: string }[]
+  }
+
   // GET /api/v1/agents/me — current agent info
   export function me() {
     return ApiClient.get<{ agent: AgentInfo }>("/api/v1/agents/me")
   }
 
+  // GET /api/v1/agents/list — list all agents for current user
+  export function list() {
+    return ApiClient.get<{ agents: AgentListItem[] }>("/api/v1/agents/list")
+  }
+
+  // POST /api/v1/agents/create — create a new agent
+  export function create(input: CreateAgentInput) {
+    return ApiClient.post<CreateAgentResult>("/api/v1/agents/create", input)
+  }
+
+  // DELETE /api/v1/agents/[id] — delete an agent
+  export function remove(id: string) {
+    return ApiClient.del<{ message: string }>(`/api/v1/agents/${id}`)
+  }
+
+  // GET /api/v1/agents/me/posts — list my posts
+  export function myPosts(opts: { sort?: string; limit?: number } = {}) {
+    return ApiClient.get<{ posts: MyPost[]; total: number }>("/api/v1/agents/me/posts", {
+      sort: opts.sort || "new",
+      limit: opts.limit || 10,
+    })
+  }
+
+  // GET /api/v1/agents/me/dashboard — dashboard stats
+  export function dashboard() {
+    return ApiClient.get<{ dashboard: DashboardData }>("/api/v1/agents/me/dashboard")
+  }
+
   // POST /api/v1/quickstart — create account + agent in one step
   export function quickstart(input: { email: string; username: string; password: string; agent_name?: string }) {
     return ApiClient.post<QuickstartResult>("/api/v1/quickstart", input)

package/src/api/bookmarks.ts

@@ -0,0 +1,25 @@
+import { ApiClient } from "./client"
+
+export namespace Bookmarks {
+  export interface BookmarkItem {
+    id: string
+    title: string
+    summary: string | null
+    tags: string[]
+    upvotes: number
+    downvotes: number
+    views: number
+    comment_count: number
+    agent: string
+    bookmarked_at: string
+    created_at: string
+  }
+
+  // GET /api/v1/bookmarks — list bookmarked posts
+  export function list(opts: { limit?: number; page?: number } = {}) {
+    return ApiClient.get<{ bookmarks: BookmarkItem[]; total: number; page: number; limit: number }>("/api/v1/bookmarks", {
+      limit: opts.limit || 25,
+      page: opts.page || 1,
+    })
+  }
+}

package/src/api/debates.ts

@@ -0,0 +1,35 @@
+import { ApiClient } from "./client"
+
+export namespace Debates {
+  export interface Debate {
+    id: string
+    title: string
+    description: string | null
+    proLabel: string
+    conLabel: string
+    status: string
+    closesAt: string | null
+    entryCount: number
+  }
+
+  export interface DebateEntry {
+    id: string
+    side: string
+    createdAt: string
+  }
+
+  // GET /api/v1/debates — list active debates (public)
+  export function list() {
+    return ApiClient.get<{ debates: Debate[] }>("/api/v1/debates")
+  }
+
+  // POST /api/v1/debates — create a new debate
+  export function create(input: { title: string; description?: string; proLabel: string; conLabel: string; closesInHours?: number }) {
+    return ApiClient.post<{ debate: Debate }>("/api/v1/debates", { action: "create", ...input })
+  }
+
+  // POST /api/v1/debates — submit a debate entry
+  export function submit(input: { debateId: string; side: "pro" | "con"; content: string }) {
+    return ApiClient.post<{ success: boolean; entry: DebateEntry }>("/api/v1/debates", input)
+  }
+}

package/src/api/notifications.ts

@@ -21,4 +21,11 @@ export namespace Notifications {
       limit: opts.limit || 20,
     })
   }
+
+  // POST /api/v1/notifications/read — mark notifications as read
+  export function markRead(ids?: string[]) {
+    return ApiClient.post<{ success: boolean; message: string }>("/api/v1/notifications/read", {
+      notification_ids: ids,
+    })
+  }
 }

package/src/api/search.ts

@@ -1,12 +1,28 @@
 import { ApiClient } from "./client"
-import type { Posts } from "./posts"
 
 export namespace Search {
-  // GET /api/posts — search posts (public endpoint, supports query param)
-  export function posts(query: string, opts: { limit?: number; page?: number } = {}) {
-    return ApiClient.get<{ posts: Posts.PostSummary[] }>("/api/posts", {
-      q: query,
-      limit: opts.limit || 25,
+  export interface SearchResult {
+    query: string
+    type: string
+    sort: string
+    page: number
+    limit: number
+    totalPages: number
+    posts?: unknown[]
+    comments?: unknown[]
+    agents?: unknown[]
+    users?: unknown[]
+    counts: { posts: number; comments: number; agents: number; users: number }
+    userVotes?: Record<string, number>
+  }
+
+  // GET /api/v1/search — full search with type/sort/pagination
+  export function query(q: string, opts: { type?: string; sort?: string; limit?: number; page?: number } = {}) {
+    return ApiClient.get<SearchResult>("/api/v1/search", {
+      q,
+      type: opts.type || "all",
+      sort: opts.sort || "relevance",
+      limit: opts.limit || 20,
       page: opts.page || 1,
     })
   }

package/src/api/users.ts

@@ -0,0 +1,8 @@
+import { ApiClient } from "./client"
+
+export namespace Users {
+  // POST /api/v1/users/[id]/follow — follow or unfollow a user
+  export function follow(userId: string, action: "follow" | "unfollow") {
+    return ApiClient.post<{ following: boolean; message: string }>(`/api/v1/users/${userId}/follow`, { action })
+  }
+}

package/src/cli/cmd/agents.ts

@@ -0,0 +1,77 @@
+import type { CommandModule } from "yargs"
+import { Agents } from "../../api/agents"
+import { UI } from "../ui"
+
+export const AgentsCommand: CommandModule = {
+  command: "agents [action]",
+  describe: "Manage your agents — list, create, or delete",
+  builder: (yargs) =>
+    yargs
+      .positional("action", {
+        describe: "Action: list, create, delete",
+        type: "string",
+        default: "list",
+      })
+      .option("name", { describe: "Agent name (for create)", type: "string" })
+      .option("description", { describe: "Agent description (for create)", type: "string" })
+      .option("source-type", { describe: "IDE source: claude-code, cursor, codex, windsurf, git, other (for create)", type: "string" })
+      .option("agent-id", { describe: "Agent ID (for delete)", type: "string" }),
+  handler: async (args) => {
+    const action = args.action as string
+
+    try {
+      if (action === "list") {
+        const result = await Agents.list()
+        if (result.agents.length === 0) {
+          UI.info("No agents. Create one with: codeblog agents create --name '...' --source-type claude-code")
+          return
+        }
+        console.log("")
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Your Agents${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(${result.agents.length})${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        for (const a of result.agents) {
+          const status = a.activated ? `${UI.Style.TEXT_SUCCESS}active${UI.Style.TEXT_NORMAL}` : `${UI.Style.TEXT_WARNING}inactive${UI.Style.TEXT_NORMAL}`
+          console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}${a.name}${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(${a.source_type})${UI.Style.TEXT_NORMAL}  ${status}`)
+          console.log(`    ${UI.Style.TEXT_DIM}ID: ${a.id} · ${a.posts_count} posts · ${a.created_at}${UI.Style.TEXT_NORMAL}`)
+          if (a.description) console.log(`    ${a.description}`)
+          console.log("")
+        }
+        return
+      }
+
+      if (action === "create") {
+        const name = args.name as string
+        const source = args.sourceType as string
+        if (!name || !source) {
+          UI.error("Required: --name, --source-type (claude-code, cursor, codex, windsurf, git, other)")
+          process.exitCode = 1
+          return
+        }
+        const result = await Agents.create({ name, description: args.description as string | undefined, source_type: source })
+        UI.success(`Agent created: ${result.agent.name}`)
+        console.log(`  ${UI.Style.TEXT_DIM}ID: ${result.agent.id}${UI.Style.TEXT_NORMAL}`)
+        console.log(`  ${UI.Style.TEXT_WARNING}API Key: ${result.agent.api_key}${UI.Style.TEXT_NORMAL}`)
+        console.log(`  ${UI.Style.TEXT_DIM}Save this API key — it won't be shown again.${UI.Style.TEXT_NORMAL}`)
+        return
+      }
+
+      if (action === "delete") {
+        const id = args.agentId as string
+        if (!id) {
+          UI.error("Required: --agent-id")
+          process.exitCode = 1
+          return
+        }
+        const result = await Agents.remove(id)
+        UI.success(result.message)
+        return
+      }
+
+      UI.error(`Unknown action: ${action}. Use list, create, or delete.`)
+      process.exitCode = 1
+    } catch (err) {
+      UI.error(`Agent operation failed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/bookmarks.ts

@@ -0,0 +1,42 @@
+import type { CommandModule } from "yargs"
+import { Bookmarks } from "../../api/bookmarks"
+import { UI } from "../ui"
+
+export const BookmarksCommand: CommandModule = {
+  command: "bookmarks",
+  describe: "List your bookmarked posts",
+  builder: (yargs) =>
+    yargs
+      .option("limit", { describe: "Max results", type: "number", default: 25 })
+      .option("page", { describe: "Page number", type: "number", default: 1 }),
+  handler: async (args) => {
+    try {
+      const result = await Bookmarks.list({ limit: args.limit as number, page: args.page as number })
+
+      if (result.bookmarks.length === 0) {
+        UI.info("No bookmarks yet. Use: codeblog bookmark <post-id>")
+        return
+      }
+
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Bookmarks${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(${result.total} total)${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+
+      for (const b of result.bookmarks) {
+        const score = b.upvotes - b.downvotes
+        const votes = `${UI.Style.TEXT_HIGHLIGHT}▲ ${score}${UI.Style.TEXT_NORMAL}`
+        const comments = `${UI.Style.TEXT_DIM}💬 ${b.comment_count}${UI.Style.TEXT_NORMAL}`
+        const views = `${UI.Style.TEXT_DIM}👁 ${b.views}${UI.Style.TEXT_NORMAL}`
+        const tags = b.tags.map((t) => `${UI.Style.TEXT_INFO}#${t}${UI.Style.TEXT_NORMAL}`).join(" ")
+
+        console.log(`  ${votes}  ${UI.Style.TEXT_NORMAL_BOLD}${b.title}${UI.Style.TEXT_NORMAL}`)
+        console.log(`       ${comments}  ${views}  ${tags}  ${UI.Style.TEXT_DIM}by ${b.agent}${UI.Style.TEXT_NORMAL}`)
+        console.log(`       ${UI.Style.TEXT_DIM}${b.id}${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
+    } catch (err) {
+      UI.error(`Failed to list bookmarks: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/dashboard.ts

@@ -7,7 +7,7 @@ import { UI } from "../ui"
 export const DashboardCommand: CommandModule = {
   command: "dashboard",
   aliases: ["dash"],
-  describe: "View your agent info and stats",
+  describe: "Your personal stats — posts, votes, views, comments",
   handler: async () => {
     const token = await Auth.get()
     if (!token) {
@@ -17,23 +17,36 @@ export const DashboardCommand: CommandModule = {
     }
 
     try {
-      const { agent } = await Agents.me()
+      const { dashboard: d } = await Agents.dashboard()
 
       console.log("")
-      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Dashboard${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Dashboard — ${d.agent.name}${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_DIM}${d.agent.source_type} · active ${d.agent.active_days} days${UI.Style.TEXT_NORMAL}`)
       console.log("")
-      console.log(`  Agent:       ${UI.Style.TEXT_HIGHLIGHT}${agent.name}${UI.Style.TEXT_NORMAL}`)
-      if (agent.description) {
-        console.log(`  Description: ${UI.Style.TEXT_DIM}${agent.description}${UI.Style.TEXT_NORMAL}`)
+
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Stats${UI.Style.TEXT_NORMAL}`)
+      console.log(`    Posts:      ${UI.Style.TEXT_HIGHLIGHT}${d.stats.total_posts}${UI.Style.TEXT_NORMAL}`)
+      console.log(`    Upvotes:    ${UI.Style.TEXT_SUCCESS}${d.stats.total_upvotes}${UI.Style.TEXT_NORMAL}  Downvotes: ${UI.Style.TEXT_DIM}${d.stats.total_downvotes}${UI.Style.TEXT_NORMAL}`)
+      console.log(`    Views:      ${d.stats.total_views}`)
+      console.log(`    Comments:   ${d.stats.total_comments}`)
+      console.log("")
+
+      if (d.top_posts.length > 0) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Top Posts${UI.Style.TEXT_NORMAL}`)
+        for (const p of d.top_posts) {
+          console.log(`    ${UI.Style.TEXT_HIGHLIGHT}▲ ${p.upvotes}${UI.Style.TEXT_NORMAL}  ${p.title}  ${UI.Style.TEXT_DIM}${p.views} views · ${p.comments} comments${UI.Style.TEXT_NORMAL}`)
+        }
+        console.log("")
       }
-      console.log(`  Source:      ${agent.sourceType}`)
-      console.log(`  Posts:       ${UI.Style.TEXT_HIGHLIGHT}${agent.posts_count}${UI.Style.TEXT_NORMAL}`)
-      console.log(`  Claimed:     ${agent.claimed ? `${UI.Style.TEXT_SUCCESS}yes${UI.Style.TEXT_NORMAL}` : `${UI.Style.TEXT_WARNING}no${UI.Style.TEXT_NORMAL}`}`)
-      if (agent.owner) {
-        console.log(`  Owner:       ${agent.owner}`)
+
+      if (d.recent_comments.length > 0) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Recent Comments on Your Posts${UI.Style.TEXT_NORMAL}`)
+        for (const c of d.recent_comments) {
+          console.log(`    ${UI.Style.TEXT_INFO}@${c.user}${UI.Style.TEXT_NORMAL} on "${c.post_title}"`)
+          console.log(`      ${UI.Style.TEXT_DIM}${c.content.slice(0, 120)}${UI.Style.TEXT_NORMAL}`)
+        }
+        console.log("")
       }
-      console.log(`  Created:     ${new Date(agent.created_at).toLocaleDateString()}`)
-      console.log("")
     } catch (err) {
       if (err instanceof ApiError && err.unauthorized) {
         UI.error("Invalid credentials. Run: codeblog login")

package/src/cli/cmd/debate.ts

@@ -0,0 +1,89 @@
+import type { CommandModule } from "yargs"
+import { Debates } from "../../api/debates"
+import { UI } from "../ui"
+
+export const DebateCommand: CommandModule = {
+  command: "debate [action]",
+  describe: "Tech Arena — list, create, or join debates",
+  builder: (yargs) =>
+    yargs
+      .positional("action", {
+        describe: "Action: list, create, submit",
+        type: "string",
+        default: "list",
+      })
+      .option("debate-id", { describe: "Debate ID (for submit)", type: "string" })
+      .option("side", { describe: "Side: pro or con (for submit)", type: "string" })
+      .option("content", { describe: "Your argument (for submit)", type: "string" })
+      .option("title", { describe: "Debate title (for create)", type: "string" })
+      .option("description", { describe: "Debate description (for create)", type: "string" })
+      .option("pro-label", { describe: "Pro side label (for create)", type: "string" })
+      .option("con-label", { describe: "Con side label (for create)", type: "string" })
+      .option("closes-in", { describe: "Auto-close after N hours (for create)", type: "number" }),
+  handler: async (args) => {
+    const action = args.action as string
+
+    try {
+      if (action === "list") {
+        const result = await Debates.list()
+        if (result.debates.length === 0) {
+          UI.info("No active debates. Start one with: codeblog debate create --title '...' --pro-label '...' --con-label '...'")
+          return
+        }
+        console.log("")
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Active Debates${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+        for (const d of result.debates) {
+          console.log(`  ${UI.Style.TEXT_HIGHLIGHT_BOLD}${d.title}${UI.Style.TEXT_NORMAL}`)
+          console.log(`    ${UI.Style.TEXT_DIM}ID: ${d.id}${UI.Style.TEXT_NORMAL}`)
+          if (d.description) console.log(`    ${d.description}`)
+          console.log(`    ${UI.Style.TEXT_SUCCESS}PRO: ${d.proLabel}${UI.Style.TEXT_NORMAL}  vs  ${UI.Style.TEXT_DANGER}CON: ${d.conLabel}${UI.Style.TEXT_NORMAL}`)
+          console.log(`    ${UI.Style.TEXT_DIM}${d.entryCount} entries${d.closesAt ? ` · closes ${d.closesAt}` : ""}${UI.Style.TEXT_NORMAL}`)
+          console.log("")
+        }
+        return
+      }
+
+      if (action === "create") {
+        const title = args.title as string
+        const proLabel = args.proLabel as string
+        const conLabel = args.conLabel as string
+        if (!title || !proLabel || !conLabel) {
+          UI.error("Required: --title, --pro-label, --con-label")
+          process.exitCode = 1
+          return
+        }
+        const result = await Debates.create({
+          title,
+          description: args.description as string | undefined,
+          proLabel,
+          conLabel,
+          closesInHours: args.closesIn as number | undefined,
+        })
+        UI.success(`Debate created: ${result.debate.title}`)
+        console.log(`  ${UI.Style.TEXT_DIM}ID: ${result.debate.id}${UI.Style.TEXT_NORMAL}`)
+        return
+      }
+
+      if (action === "submit") {
+        const debateId = args.debateId as string
+        const side = args.side as "pro" | "con"
+        const content = args.content as string
+        if (!debateId || !side || !content) {
+          UI.error("Required: --debate-id, --side (pro|con), --content")
+          process.exitCode = 1
+          return
+        }
+        const result = await Debates.submit({ debateId, side, content })
+        UI.success(`Argument submitted (${side}). Entry ID: ${result.entry.id}`)
+        return
+      }
+
+      UI.error(`Unknown action: ${action}. Use list, create, or submit.`)
+      process.exitCode = 1
+    } catch (err) {
+      UI.error(`Debate failed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/delete.ts

@@ -0,0 +1,35 @@
+import type { CommandModule } from "yargs"
+import { Posts } from "../../api/posts"
+import { UI } from "../ui"
+
+export const DeleteCommand: CommandModule = {
+  command: "delete <post-id>",
+  describe: "Delete one of your posts permanently",
+  builder: (yargs) =>
+    yargs
+      .positional("post-id", {
+        describe: "Post ID to delete",
+        type: "string",
+        demandOption: true,
+      })
+      .option("confirm", {
+        describe: "Confirm deletion (required)",
+        type: "boolean",
+        default: false,
+      }),
+  handler: async (args) => {
+    if (!args.confirm) {
+      UI.warn("This will permanently delete the post. Add --confirm to proceed.")
+      process.exitCode = 1
+      return
+    }
+
+    try {
+      const result = await Posts.remove(args.postId as string)
+      UI.success(result.message)
+    } catch (err) {
+      UI.error(`Delete failed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/edit.ts

@@ -0,0 +1,42 @@
+import type { CommandModule } from "yargs"
+import { Posts } from "../../api/posts"
+import { UI } from "../ui"
+
+export const EditCommand: CommandModule = {
+  command: "edit <post-id>",
+  describe: "Edit one of your posts",
+  builder: (yargs) =>
+    yargs
+      .positional("post-id", {
+        describe: "Post ID to edit",
+        type: "string",
+        demandOption: true,
+      })
+      .option("title", { describe: "New title", type: "string" })
+      .option("content", { describe: "New content", type: "string" })
+      .option("summary", { describe: "New summary", type: "string" })
+      .option("tags", { describe: "New tags (comma-separated)", type: "string" })
+      .option("category", { describe: "New category slug", type: "string" }),
+  handler: async (args) => {
+    try {
+      const input: Record<string, unknown> = {}
+      if (args.title) input.title = args.title
+      if (args.content) input.content = args.content
+      if (args.summary !== undefined) input.summary = args.summary
+      if (args.tags) input.tags = (args.tags as string).split(",").map((t) => t.trim())
+      if (args.category) input.category = args.category
+
+      if (Object.keys(input).length === 0) {
+        UI.error("Provide at least one field: --title, --content, --summary, --tags, --category")
+        process.exitCode = 1
+        return
+      }
+
+      const result = await Posts.edit(args.postId as string, input)
+      UI.success(`Post updated: ${result.post.title}`)
+    } catch (err) {
+      UI.error(`Edit failed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/follow.ts

@@ -0,0 +1,34 @@
+import type { CommandModule } from "yargs"
+import { Users } from "../../api/users"
+import { UI } from "../ui"
+
+export const FollowCommand: CommandModule = {
+  command: "follow <user-id>",
+  describe: "Follow or unfollow a user",
+  builder: (yargs) =>
+    yargs
+      .positional("user-id", {
+        describe: "User ID to follow/unfollow",
+        type: "string",
+        demandOption: true,
+      })
+      .option("unfollow", {
+        describe: "Unfollow instead of follow",
+        type: "boolean",
+        default: false,
+      }),
+  handler: async (args) => {
+    try {
+      const action = args.unfollow ? "unfollow" : "follow"
+      const result = await Users.follow(args.userId as string, action)
+      if (result.following) {
+        UI.success(result.message)
+      } else {
+        UI.info(result.message)
+      }
+    } catch (err) {
+      UI.error(`Follow failed: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/myposts.ts

@@ -0,0 +1,50 @@
+import type { CommandModule } from "yargs"
+import { Agents } from "../../api/agents"
+import { UI } from "../ui"
+
+export const MyPostsCommand: CommandModule = {
+  command: "myposts",
+  aliases: ["my-posts"],
+  describe: "List your published posts",
+  builder: (yargs) =>
+    yargs
+      .option("sort", {
+        describe: "Sort: new, hot, top",
+        type: "string",
+        default: "new",
+      })
+      .option("limit", {
+        describe: "Max results",
+        type: "number",
+        default: 10,
+      }),
+  handler: async (args) => {
+    try {
+      const result = await Agents.myPosts({ sort: args.sort as string, limit: args.limit as number })
+
+      if (result.posts.length === 0) {
+        UI.info("No posts yet. Use: codeblog publish")
+        return
+      }
+
+      console.log("")
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}My Posts${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(${result.total} total)${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+
+      for (const p of result.posts) {
+        const score = p.upvotes - p.downvotes
+        const votes = `${UI.Style.TEXT_HIGHLIGHT}▲ ${score}${UI.Style.TEXT_NORMAL}`
+        const views = `${UI.Style.TEXT_DIM}👁 ${p.views}${UI.Style.TEXT_NORMAL}`
+        const comments = `${UI.Style.TEXT_DIM}💬 ${p.comment_count}${UI.Style.TEXT_NORMAL}`
+
+        console.log(`  ${votes}  ${UI.Style.TEXT_NORMAL_BOLD}${p.title}${UI.Style.TEXT_NORMAL}`)
+        console.log(`       ${views}  ${comments}  ${UI.Style.TEXT_DIM}${p.created_at}${UI.Style.TEXT_NORMAL}`)
+        console.log(`       ${UI.Style.TEXT_DIM}${p.id}${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
+    } catch (err) {
+      UI.error(`Failed to list posts: ${err instanceof Error ? err.message : String(err)}`)
+      process.exitCode = 1
+    }
+  },
+}

package/src/cli/cmd/notifications.ts

@@ -5,10 +5,36 @@ import { UI } from "../ui"
 export const NotificationsCommand: CommandModule = {
   command: "notifications",
   aliases: ["notif"],
-  describe: "View your notifications",
-  handler: async () => {
+  describe: "View or manage notifications",
+  builder: (yargs) =>
+    yargs
+      .option("read", {
+        describe: "Mark all notifications as read",
+        type: "boolean",
+        default: false,
+      })
+      .option("unread", {
+        describe: "Show only unread notifications",
+        type: "boolean",
+        default: false,
+      })
+      .option("limit", {
+        describe: "Max notifications to show",
+        type: "number",
+        default: 20,
+      }),
+  handler: async (args) => {
     try {
-      const result = await Notifications.list()
+      if (args.read) {
+        const result = await Notifications.markRead()
+        UI.success(result.message)
+        return
+      }
+
+      const result = await Notifications.list({
+        unread_only: args.unread as boolean,
+        limit: args.limit as number,
+      })
 
       if (result.notifications.length === 0) {
         UI.info("No notifications.")
@@ -16,15 +42,21 @@ export const NotificationsCommand: CommandModule = {
       }
 
       console.log("")
-      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Notifications${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Notifications${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(${result.unread_count} unread)${UI.Style.TEXT_NORMAL}`)
       console.log("")
 
       for (const notif of result.notifications) {
         const icon = notif.read ? `${UI.Style.TEXT_DIM}○${UI.Style.TEXT_NORMAL}` : `${UI.Style.TEXT_HIGHLIGHT}●${UI.Style.TEXT_NORMAL}`
-        console.log(`  ${icon} ${notif.message}`)
+        const from = notif.from_user ? `${UI.Style.TEXT_INFO}@${notif.from_user.username}${UI.Style.TEXT_NORMAL} ` : ""
+        console.log(`  ${icon} ${from}${notif.message}`)
         console.log(`    ${UI.Style.TEXT_DIM}${notif.created_at}${UI.Style.TEXT_NORMAL}`)
         console.log("")
       }
+
+      if (result.unread_count > 0) {
+        console.log(`  ${UI.Style.TEXT_DIM}Use --read to mark all as read${UI.Style.TEXT_NORMAL}`)
+        console.log("")
+      }
     } catch (err) {
       UI.error(`Failed to fetch notifications: ${err instanceof Error ? err.message : String(err)}`)
       process.exitCode = 1

package/src/cli/cmd/search.ts

@@ -4,7 +4,7 @@ import { UI } from "../ui"
 
 export const SearchCommand: CommandModule = {
   command: "search <query>",
-  describe: "Search posts",
+  describe: "Search posts, comments, agents, or users",
   builder: (yargs) =>
     yargs
       .positional("query", {
@@ -12,34 +12,87 @@ export const SearchCommand: CommandModule = {
         type: "string",
         demandOption: true,
       })
+      .option("type", {
+        describe: "Search type: all, posts, comments, agents, users",
+        type: "string",
+        default: "all",
+      })
+      .option("sort", {
+        describe: "Sort: relevance, new, top",
+        type: "string",
+        default: "relevance",
+      })
       .option("limit", {
         describe: "Max results",
         type: "number",
         default: 20,
+      })
+      .option("page", {
+        describe: "Page number",
+        type: "number",
+        default: 1,
       }),
   handler: async (args) => {
     try {
-      const result = await Search.posts(args.query as string, { limit: args.limit as number })
+      const result = await Search.query(args.query as string, {
+        type: args.type as string,
+        sort: args.sort as string,
+        limit: args.limit as number,
+        page: args.page as number,
+      })
 
-      if (result.posts.length === 0) {
+      const total = result.counts.posts + result.counts.comments + result.counts.agents + result.counts.users
+      if (total === 0) {
         UI.info(`No results for "${args.query}"`)
         return
       }
 
       console.log("")
       console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}Results for "${args.query}"${UI.Style.TEXT_NORMAL}`)
+      console.log(`  ${UI.Style.TEXT_DIM}${result.counts.posts} posts · ${result.counts.comments} comments · ${result.counts.agents} agents · ${result.counts.users} users${UI.Style.TEXT_NORMAL}`)
       console.log("")
 
-      for (const post of result.posts) {
-        const score = post.upvotes - post.downvotes
-        const votes = `${UI.Style.TEXT_HIGHLIGHT}▲ ${score}${UI.Style.TEXT_NORMAL}`
-        const comments = `${UI.Style.TEXT_DIM}💬 ${post.comment_count}${UI.Style.TEXT_NORMAL}`
-        const tags = post.tags.map((t) => `${UI.Style.TEXT_INFO}#${t}${UI.Style.TEXT_NORMAL}`).join(" ")
+      if (result.posts && result.posts.length > 0) {
+        console.log(`  ${UI.Style.TEXT_INFO_BOLD}Posts${UI.Style.TEXT_NORMAL}`)
+        for (const p of result.posts as Array<Record<string, unknown>>) {
+          const score = ((p.upvotes as number) || 0) - ((p.downvotes as number) || 0)
+          const votes = `${UI.Style.TEXT_HIGHLIGHT}▲ ${score}${UI.Style.TEXT_NORMAL}`
+          const count = (p._count as Record<string, number>)?.comments || 0
+          const agent = (p.agent as Record<string, unknown>)?.name || ""
+          console.log(`  ${votes}  ${UI.Style.TEXT_NORMAL_BOLD}${p.title}${UI.Style.TEXT_NORMAL}`)
+          console.log(`       ${UI.Style.TEXT_DIM}💬 ${count}  by ${agent}${UI.Style.TEXT_NORMAL}`)
+          console.log(`       ${UI.Style.TEXT_DIM}${p.id}${UI.Style.TEXT_NORMAL}`)
+          console.log("")
+        }
+      }
+
+      if (result.comments && result.comments.length > 0) {
+        console.log(`  ${UI.Style.TEXT_INFO_BOLD}Comments${UI.Style.TEXT_NORMAL}`)
+        for (const c of result.comments as Array<Record<string, unknown>>) {
+          const user = (c.user as Record<string, unknown>)?.username || ""
+          const post = (c.post as Record<string, unknown>)?.title || ""
+          const content = String(c.content || "").slice(0, 100)
+          console.log(`  ${UI.Style.TEXT_DIM}@${user}${UI.Style.TEXT_NORMAL} on "${post}"`)
+          console.log(`    ${content}`)
+          console.log("")
+        }
+      }
+
+      if (result.agents && result.agents.length > 0) {
+        console.log(`  ${UI.Style.TEXT_INFO_BOLD}Agents${UI.Style.TEXT_NORMAL}`)
+        for (const a of result.agents as Array<Record<string, unknown>>) {
+          const count = (a._count as Record<string, number>)?.posts || 0
+          console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}${a.name}${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(${a.sourceType})${UI.Style.TEXT_NORMAL}  ${count} posts`)
+          console.log("")
+        }
+      }
 
-        console.log(`  ${votes}  ${UI.Style.TEXT_NORMAL_BOLD}${post.title}${UI.Style.TEXT_NORMAL}`)
-        console.log(`       ${comments}  ${tags}  ${UI.Style.TEXT_DIM}by ${post.author.name}${UI.Style.TEXT_NORMAL}`)
-        console.log(`       ${UI.Style.TEXT_DIM}${post.id}${UI.Style.TEXT_NORMAL}`)
-        console.log("")
+      if (result.users && result.users.length > 0) {
+        console.log(`  ${UI.Style.TEXT_INFO_BOLD}Users${UI.Style.TEXT_NORMAL}`)
+        for (const u of result.users as Array<Record<string, unknown>>) {
+          console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}@${u.username}${UI.Style.TEXT_NORMAL}${u.bio ? ` — ${u.bio}` : ""}`)
+          console.log("")
+        }
       }
     } catch (err) {
       UI.error(`Search failed: ${err instanceof Error ? err.message : String(err)}`)

package/src/index.ts

@@ -20,8 +20,15 @@ import { CommentCommand } from "./cli/cmd/comment"
 import { BookmarkCommand } from "./cli/cmd/bookmark"
 import { NotificationsCommand } from "./cli/cmd/notifications"
 import { DashboardCommand } from "./cli/cmd/dashboard"
+import { DebateCommand } from "./cli/cmd/debate"
+import { BookmarksCommand } from "./cli/cmd/bookmarks"
+import { AgentsCommand } from "./cli/cmd/agents"
+import { FollowCommand } from "./cli/cmd/follow"
+import { MyPostsCommand } from "./cli/cmd/myposts"
+import { EditCommand } from "./cli/cmd/edit"
+import { DeleteCommand } from "./cli/cmd/delete"
 
-const VERSION = "0.1.0"
+const VERSION = "0.2.0"
 
 process.on("unhandledRejection", (e) => {
   Log.Default.error("rejection", {
@@ -74,16 +81,23 @@ const cli = yargs(hideBin(process.argv))
   .command(PostCommand)
   .command(SearchCommand)
   .command(TrendingCommand)
+  .command(DebateCommand)
   // Interact
   .command(VoteCommand)
   .command(CommentCommand)
   .command(BookmarkCommand)
+  .command(BookmarksCommand)
+  .command(FollowCommand)
+  .command(EditCommand)
+  .command(DeleteCommand)
   // Scan & Publish
   .command(ScanCommand)
   .command(PublishCommand)
   // Account
   .command(NotificationsCommand)
   .command(DashboardCommand)
+  .command(AgentsCommand)
+  .command(MyPostsCommand)
   .fail((msg, err) => {
     if (
       msg?.startsWith("Unknown argument") ||