@page.su/ai-blog-cli 0.1.0-beta.1

package/README.md

@@ -0,0 +1,145 @@
+# @page.su/ai-blog-cli
+
+CLI tool for AI agents and humans to write, manage, and publish posts on ai-blog.
+
+## Install
+
+```bash
+# Global install (recommended)
+npm install -g @page.su/ai-blog-cli
+
+# Or use with npx (no install needed)
+npx @page.su/ai-blog-cli post list --json
+```
+
+## Configuration
+
+Create a token at `/admin/settings/tokens` in your ai-blog admin panel, then configure via one of these methods:
+
+### Option A: ~/.aib.env file (recommended)
+
+```bash
+# Create ~/.aib.env with your credentials
+cat > ~/.aib.env << 'EOF'
+AI_BLOG_BASE_URL=https://your-blog.example.com
+AI_BLOG_PAT=aib_pat_your_token_here
+EOF
+```
+
+### Option B: Environment variables
+
+```bash
+export AI_BLOG_BASE_URL=https://your-blog.example.com
+export AI_BLOG_PAT=aib_pat_your_token_here
+```
+
+### Option C: Local .aib.env (project-level override)
+
+Create `.aib.env` in your project directory. Overrides `~/.aib.env` but not environment variables.
+
+### Configuration priority
+
+1. Environment variables (highest)
+2. `./.aib.env` (current directory)
+3. `~/.aib.env` (home directory, lowest)
+
+### Optional settings
+
+| Variable | Default | Description |
+|---|---|---|
+| `AI_BLOG_REQUEST_TIMEOUT_MS` | `30000` | HTTP request timeout in milliseconds |
+
+## Quick start
+
+```bash
+# View skills reference (~500 tokens, for Agent system prompts)
+aib skills
+
+# View all commands
+aib --help
+
+# View command group details
+aib post --help
+
+# Posts
+aib post list --json
+aib post create --title "Title" --content-file draft.md --status draft
+aib post validate --content-file draft.md
+aib post publish <id>
+
+# Large posts (save tokens)
+aib post outline <id>
+aib post section <id> --index 3
+aib post replace-section <id> --index 3 --content-file new.md
+
+# Taxonomy
+aib taxonomy list --json
+
+# Knowledge
+aib knowledge find "Promise"
+
+# Scout research
+aib scout search "LangGraph" --min-score 7 --json
+```
+
+## Commands
+
+| Command group | Description |
+|---|---|
+| `aib post` | Create, read, update, delete, validate posts |
+| `aib demo` | Manage interactive live demos |
+| `aib code-repo` | Manage code repositories (N:1 sharing) |
+| `aib build` | Build advanced markdown syntax blocks |
+| `aib knowledge` | Manage knowledge entries (terms & math) |
+| `aib scout` | Search Scout collected tech items |
+| `aib series` | Manage article series |
+| `aib taxonomy` | Manage categories and tags |
+| `aib comment` | Create comments and manage AI bots |
+| `aib upload` | Upload images to blog OSS |
+| `aib skills` | Output skills reference for Agent prompts |
+
+## Conventions
+
+- Add `--json` to any command for structured JSON output
+- Use `--content-file <path>` for large content (avoids arg length limits)
+- Pipe support: `cat draft.md | aib post validate --stdin`
+- Call `aib <command> --help` for detailed usage
+
+## Agent integration
+
+### Python (subprocess)
+
+```python
+import subprocess, json
+
+# Get skills reference for system prompt
+skills = subprocess.run(["aib", "skills"], capture_output=True, text=True).stdout
+
+# Execute commands and parse JSON
+result = subprocess.run(["aib", "post", "list", "--json"], capture_output=True, text=True)
+posts = json.loads(result.stdout)
+```
+
+### Qoder / Cursor / Claude Code
+
+Agents with shell access can call `aib` directly. Inject `aib skills` output into the system prompt for command discovery.
+
+## Development
+
+```bash
+# Build
+pnpm build
+
+# Dev mode (tsx watch)
+pnpm dev
+
+# Test
+pnpm test
+
+# Publish
+npm publish --access public
+```
+
+## License
+
+MIT

package/dist/api-client.d.ts

@@ -0,0 +1,39 @@
+import type { CliConfig } from "./config.js";
+/**
+ * 对 ai-blog `/api/cli/**` 的薄 HTTP 客户端。
+ *
+ * 设计要点：
+ *  - 自动注入 `Authorization: Bearer <PAT>` 与 `Content-Type: application/json`
+ *  - 自动加 AbortController 超时（避免 stdio 长 hang）
+ *  - 把非 2xx 响应统一抛 `ApiClientError`，含 status / message / issues 三类信息，
+ *    上层 tool 可以直接把 message 透传给 AI 客户端
+ */
+export declare class ApiClientError extends Error {
+    readonly status: number;
+    readonly issues?: unknown;
+    constructor(message: string, status: number, issues?: unknown);
+}
+export interface ApiClient {
+    /** 通用 GET，path 以 `/api/cli/...` 开头 */
+    get<T>(path: string, query?: Record<string, string | number | undefined>): Promise<T>;
+    /** 通用 POST */
+    post<T>(path: string, body?: unknown): Promise<T>;
+    /** 通用 PATCH */
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    /** 通用 DELETE */
+    delete<T>(path: string): Promise<T>;
+    /** 把响应体当成原始文本读取（用于 syntax-spec 资源） */
+    getText(path: string): Promise<string>;
+}
+/**
+ * 当前 CLI 对应的 API 版本号。
+ *
+ * 此版本号对应后端 `CLI_API_CURRENT_VERSION` 常量。
+ * CLI 升级时应同步更新此值，确保与后端兼容。
+ *
+ * 格式：YYYY-MM-DD（日期版本号，类似 Stripe/GitHub 风格）
+ */
+export declare const CLI_CLIENT_API_VERSION = "2026-05-12";
+/** 工厂函数：根据配置创建一个 ApiClient 实例 */
+export declare function createApiClient(config: CliConfig): ApiClient;
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;;;;;;GAQG;AAEH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO;CAM9D;AAED,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACtF,cAAc;IACd,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,eAAe;IACf,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACnD,gBAAgB;IAChB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,sCAAsC;IACtC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AA8DD;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAEnD,iCAAiC;AACjC,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAoF5D"}

package/dist/api-client.js

@@ -0,0 +1,163 @@
+import { readFileSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * 对 ai-blog `/api/cli/**` 的薄 HTTP 客户端。
+ *
+ * 设计要点：
+ *  - 自动注入 `Authorization: Bearer <PAT>` 与 `Content-Type: application/json`
+ *  - 自动加 AbortController 超时（避免 stdio 长 hang）
+ *  - 把非 2xx 响应统一抛 `ApiClientError`，含 status / message / issues 三类信息，
+ *    上层 tool 可以直接把 message 透传给 AI 客户端
+ */
+export class ApiClientError extends Error {
+    status;
+    issues;
+    constructor(message, status, issues) {
+        super(message);
+        this.name = "ApiClientError";
+        this.status = status;
+        this.issues = issues;
+    }
+}
+/** 由 baseUrl + path + query 拼出完整 URL */
+function buildUrl(baseUrl, path, query) {
+    const url = new URL(path.startsWith("/") ? path : `/${path}`, baseUrl);
+    if (query) {
+        for (const [key, value] of Object.entries(query)) {
+            if (value === undefined || value === null) {
+                continue;
+            }
+            url.searchParams.set(key, String(value));
+        }
+    }
+    return url.toString();
+}
+/** 从 fetch Response 解析错误，抛 ApiClientError */
+async function throwApiError(response) {
+    let message = `Request failed with status ${response.status}`;
+    let issues;
+    try {
+        const data = (await response.json());
+        if (typeof data.message === "string" && data.message) {
+            message = data.message;
+        }
+        if (data.issues !== undefined) {
+            issues = data.issues;
+        }
+    }
+    catch {
+        // 非 JSON 响应，保留默认 message
+    }
+    throw new ApiClientError(message, response.status, issues);
+}
+/**
+ * 从 package.json 读取版本号。
+ *
+ * 编译后 dist/api-client.js 位于 dist/ 目录，package.json 在上一级。
+ * 首次读取后缓存，避免重复 I/O。
+ */
+let cachedVersion;
+function readPackageVersion() {
+    if (cachedVersion === undefined) {
+        try {
+            // 编译后 dist/ 下运行时 import.meta.url 指向 dist/api-client.js
+            const distDir = dirname(fileURLToPath(import.meta.url));
+            const pkgPath = resolve(distDir, "..", "package.json");
+            const raw = readFileSync(pkgPath, "utf-8");
+            const pkg = JSON.parse(raw);
+            cachedVersion = pkg.version ?? "0.0.0";
+        }
+        catch {
+            cachedVersion = "0.0.0";
+        }
+    }
+    return cachedVersion;
+}
+/**
+ * 当前 CLI 对应的 API 版本号。
+ *
+ * 此版本号对应后端 `CLI_API_CURRENT_VERSION` 常量。
+ * CLI 升级时应同步更新此值，确保与后端兼容。
+ *
+ * 格式：YYYY-MM-DD（日期版本号，类似 Stripe/GitHub 风格）
+ */
+export const CLI_CLIENT_API_VERSION = "2026-05-12";
+/** 工厂函数：根据配置创建一个 ApiClient 实例 */
+export function createApiClient(config) {
+    const serverVersion = readPackageVersion();
+    const baseHeaders = {
+        Authorization: `Bearer ${config.pat}`,
+        "User-Agent": `ai-blog-cli/${serverVersion}`,
+        "x-api-version": CLI_CLIENT_API_VERSION,
+    };
+    /** 统一发起请求的内部实现 */
+    async function request(method, path, init = {}) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), config.requestTimeoutMs);
+        try {
+            const headers = { ...baseHeaders };
+            let body;
+            if (init.body !== undefined) {
+                headers["Content-Type"] = "application/json";
+                body = JSON.stringify(init.body);
+            }
+            const response = await fetch(buildUrl(config.baseUrl, path, init.query), {
+                method,
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                return throwApiError(response);
+            }
+            // 204 No Content
+            if (response.status === 204) {
+                return undefined;
+            }
+            const contentType = response.headers.get("content-type") ?? "";
+            if (contentType.includes("application/json")) {
+                return (await response.json());
+            }
+            // 非 JSON 响应（如 text/markdown）当字符串返回
+            return (await response.text());
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    return {
+        get(path, query) {
+            return request("GET", path, { query });
+        },
+        post(path, body) {
+            return request("POST", path, { body });
+        },
+        patch(path, body) {
+            return request("PATCH", path, { body });
+        },
+        delete(path) {
+            return request("DELETE", path);
+        },
+        async getText(path) {
+            // 直接绕过 JSON 自动反序列化，单独走一遍以拿到原始文本
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), config.requestTimeoutMs);
+            try {
+                const response = await fetch(buildUrl(config.baseUrl, path), {
+                    method: "GET",
+                    headers: baseHeaders,
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    return throwApiError(response);
+                }
+                return await response.text();
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        },
+    };
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"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"}

package/dist/api-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=api-client.test.d.ts.map

package/dist/api-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.d.ts","sourceRoot":"","sources":["../src/api-client.test.ts"],"names":[],"mappings":""}

package/dist/api-client.test.js

@@ -0,0 +1,83 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { ApiClientError, createApiClient } from "./api-client.js";
+/**
+ * 验证 ApiClient：
+ *  - 自动注入 Authorization 头
+ *  - 自动 JSON 序列化与反序列化
+ *  - 非 2xx 响应抛 ApiClientError，含 message / issues
+ *  - getText 直接返回原始字符串
+ */
+describe("createApiClient", () => {
+    const config = {
+        baseUrl: "https://example.com",
+        pat: "aib_pat_xxxxxx",
+        requestTimeoutMs: 1_000,
+    };
+    let fetchSpy;
+    beforeEach(() => {
+        fetchSpy = vi.spyOn(globalThis, "fetch");
+    });
+    afterEach(() => {
+        fetchSpy.mockRestore();
+    });
+    it("get 成功时返回 JSON 数据并自动带 Authorization", async () => {
+        fetchSpy.mockResolvedValue(new Response(JSON.stringify({ ok: true, items: [1, 2] }), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        }));
+        const client = createApiClient(config);
+        const result = await client.get("/api/cli/posts", { limit: 5 });
+        expect(result.items).toEqual([1, 2]);
+        const callArgs = fetchSpy.mock.calls[0];
+        expect(callArgs[0]).toBe("https://example.com/api/cli/posts?limit=5");
+        const init = callArgs[1];
+        const headers = init.headers;
+        expect(headers.Authorization).toBe(`Bearer ${config.pat}`);
+    });
+    it("post 自动 JSON 序列化 body 并带 Content-Type", async () => {
+        fetchSpy.mockResolvedValue(new Response(JSON.stringify({ ok: true }), {
+            status: 200,
+            headers: { "content-type": "application/json" },
+        }));
+        const client = createApiClient(config);
+        await client.post("/api/cli/build/image", { url: "https://x", alt: "y" });
+        const init = fetchSpy.mock.calls[0][1];
+        expect(init.method).toBe("POST");
+        expect(init.body).toBe(JSON.stringify({ url: "https://x", alt: "y" }));
+        const headers = init.headers;
+        expect(headers["Content-Type"]).toBe("application/json");
+    });
+    it("非 2xx 响应抛 ApiClientError，并保留 message / issues", async () => {
+        fetchSpy.mockResolvedValue(new Response(JSON.stringify({ message: "Invalid payload", issues: { fieldErrors: { title: ["required"] } } }), {
+            status: 400,
+            headers: { "content-type": "application/json" },
+        }));
+        const client = createApiClient(config);
+        await expect(client.post("/api/cli/posts", {})).rejects.toMatchObject({
+            name: "ApiClientError",
+            status: 400,
+            message: "Invalid payload",
+        });
+    });
+    it("ApiClientError 是 Error 子类，instanceof 检查通过", async () => {
+        fetchSpy.mockResolvedValue(new Response("oops", { status: 500 }));
+        const client = createApiClient(config);
+        try {
+            await client.get("/api/cli/posts");
+            throw new Error("expected throw");
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(ApiClientError);
+        }
+    });
+    it("getText 直接返回原始文本", async () => {
+        fetchSpy.mockResolvedValue(new Response("# Hello", {
+            status: 200,
+            headers: { "content-type": "text/markdown" },
+        }));
+        const client = createApiClient(config);
+        const text = await client.getText("/api/cli/syntax-spec/overview");
+        expect(text).toBe("# Hello");
+    });
+});
+//# sourceMappingURL=api-client.test.js.map

package/dist/api-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.js","sourceRoot":"","sources":["../src/api-client.test.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { Command } from "commander";
+import { createApiClient } from "./api-client.js";
+import { loadCliConfig } from "./config.js";
+import { registerPostCommands } from "./commands/post.js";
+import { registerDemoCommands } from "./commands/demo.js";
+import { registerCodeRepoCommands } from "./commands/code-repo.js";
+import { registerBuildCommands } from "./commands/build.js";
+import { registerKnowledgeCommands } from "./commands/knowledge.js";
+import { registerScoutCommands } from "./commands/scout.js";
+import { registerSeriesCommands } from "./commands/series.js";
+import { registerTaxonomyCommands } from "./commands/taxonomy.js";
+import { registerCommentCommands } from "./commands/comments.js";
+import { registerUploadCommands } from "./commands/uploads.js";
+import { registerSkillsCommand } from "./commands/skills.js";
+function readOwnVersion() {
+    const distDir = dirname(fileURLToPath(import.meta.url));
+    const pkgPath = resolve(distDir, "..", "package.json");
+    try {
+        const raw = readFileSync(pkgPath, "utf-8");
+        const pkg = JSON.parse(raw);
+        return pkg.version ?? "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+/**
+ * 创建延迟初始化的 ApiClient 代理。
+ *
+ * 在实际方法被调用时才加载配置和创建客户端，
+ * 这样 --help / --version / skills 等命令不需要环境变量也能运行。
+ */
+function createLazyApi() {
+    let cached = null;
+    return new Proxy({}, {
+        get(_, prop) {
+            if (cached === null) {
+                const config = loadCliConfig();
+                cached = createApiClient(config);
+            }
+            const value = Reflect.get(cached, prop);
+            return typeof value === "function" ? value.bind(cached) : value;
+        },
+    });
+}
+async function main() {
+    const api = createLazyApi();
+    const program = new Command();
+    program
+        .name("aib")
+        .description("AI Blog CLI — write, manage, and publish posts")
+        .version(readOwnVersion());
+    registerPostCommands(program, api);
+    registerDemoCommands(program, api);
+    registerCodeRepoCommands(program, api);
+    registerBuildCommands(program, api);
+    registerKnowledgeCommands(program, api);
+    registerScoutCommands(program, api);
+    registerSeriesCommands(program, api);
+    registerTaxonomyCommands(program, api);
+    registerCommentCommands(program, api);
+    registerUploadCommands(program, api);
+    registerSkillsCommand(program);
+    program.parse();
+}
+main().catch((error) => {
+    console.error(`aib: ${error instanceof Error ? error.message : String(error)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/build.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from "commander";
+import type { ApiClient } from "../api-client.js";
+export declare function registerBuildCommands(program: Command, api: ApiClient): void;
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CA6I5E"}