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

package/dist/commands/knowledge.js

@@ -0,0 +1,146 @@
+import { run, readContent, isJson } from "./helpers.js";
+export function registerKnowledgeCommands(program, api) {
+    const knowledge = program.command("knowledge").description("Manage knowledge entries (terms & math concepts)");
+    // ── knowledge list ──
+    knowledge
+        .command("list")
+        .description("List knowledge entries (terms and math concepts)")
+        .option("--domain <domain>", "Filter: all, glossary, or math")
+        .option("--status <status>", "Filter by status: draft or published")
+        .option("--difficulty <n>", "Filter by difficulty 1-5 (math only)")
+        .option("--search <keyword>", "Search keyword")
+        .option("--page <n>", "Page number (default 1)")
+        .option("--page-size <n>", "Page size (default 20, max 100)")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const params = new URLSearchParams();
+        params.set("action", "list");
+        if (opts.domain)
+            params.set("domain", opts.domain);
+        if (opts.status)
+            params.set("status", opts.status);
+        if (opts.difficulty)
+            params.set("difficulty", opts.difficulty);
+        if (opts.search)
+            params.set("search", opts.search);
+        if (opts.page)
+            params.set("page", opts.page);
+        if (opts.pageSize)
+            params.set("pageSize", opts.pageSize);
+        await run(() => api.get(`/api/cli/knowledge?${params.toString()}`), isJson(opts));
+    });
+    // ── knowledge get ──
+    knowledge
+        .command("get <id>")
+        .description("Get a knowledge entry by id")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.get(`/api/cli/knowledge?action=get&id=${encodeURIComponent(id)}`), isJson(opts));
+    });
+    // ── knowledge create ──
+    knowledge
+        .command("create")
+        .description("Create a knowledge entry. Use --math to add math enhancement (difficulty, formulas, etc.)")
+        .requiredOption("--title <title>", "Entry title")
+        .requiredOption("--terms <terms>", "Match terms, pipe-separated (e.g. 'Promise|Thenable')")
+        .requiredOption("--brief <brief>", "Short description for hover tooltip (<=200 chars)")
+        .option("--slug <slug>", "Entry slug (auto-generated if empty)")
+        .option("--content-file <path>", "Markdown content from file")
+        .option("--status <status>", "Status: draft or published")
+        .option("--auto-link", "Enable auto-highlight matching")
+        .option("--math", "Mark as math concept (enables math enhancement fields)")
+        .option("--difficulty <n>", "Math difficulty 1-5 (1=beginner, 5=expert)")
+        .option("--formulas <latex>", "Core formulas (LaTeX)")
+        .option("--notation <notation>", "Symbol notation (JSON or plain text)")
+        .option("--prerequisites <slugs>", "Prerequisite slugs (comma-separated)")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const data = {
+            title: opts.title,
+            terms: opts.terms,
+            brief: opts.brief,
+        };
+        if (opts.slug)
+            data.slug = opts.slug;
+        if (opts.contentFile)
+            data.content = readContent(opts.contentFile);
+        if (opts.status)
+            data.status = opts.status;
+        if (opts.autoLink !== undefined)
+            data.autoLink = opts.autoLink;
+        if (opts.math) {
+            const mathEnhancement = {};
+            if (opts.difficulty)
+                mathEnhancement.difficulty = parseInt(opts.difficulty, 10);
+            if (opts.formulas)
+                mathEnhancement.formulas = opts.formulas;
+            if (opts.notation)
+                mathEnhancement.notation = opts.notation;
+            if (opts.prerequisites)
+                mathEnhancement.prerequisites = opts.prerequisites;
+            data.mathEnhancement = mathEnhancement;
+        }
+        await run(() => api.post("/api/cli/knowledge", { action: "create", data }), isJson(opts));
+    });
+    // ── knowledge update ──
+    knowledge
+        .command("update <id>")
+        .description("Update a knowledge entry. Pass --math to add/update math enhancement.")
+        .option("--title <title>", "Entry title")
+        .option("--terms <terms>", "Match terms")
+        .option("--brief <brief>", "Short description")
+        .option("--content-file <path>", "Markdown content from file")
+        .option("--status <status>", "Status: draft or published")
+        .option("--auto-link <bool>", "Enable auto-highlight (true/false)")
+        .option("--math", "Update math enhancement fields")
+        .option("--difficulty <n>", "Math difficulty 1-5")
+        .option("--formulas <latex>", "Core formulas (LaTeX)")
+        .option("--notation <notation>", "Symbol notation")
+        .option("--prerequisites <slugs>", "Prerequisite slugs")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        const data = {};
+        if (opts.title)
+            data.title = opts.title;
+        if (opts.terms)
+            data.terms = opts.terms;
+        if (opts.brief)
+            data.brief = opts.brief;
+        if (opts.contentFile)
+            data.content = readContent(opts.contentFile);
+        if (opts.status)
+            data.status = opts.status;
+        if (opts.autoLink !== undefined)
+            data.autoLink = opts.autoLink === "true";
+        if (opts.math) {
+            const mathEnhancement = {};
+            if (opts.difficulty)
+                mathEnhancement.difficulty = parseInt(opts.difficulty, 10);
+            if (opts.formulas)
+                mathEnhancement.formulas = opts.formulas;
+            if (opts.notation)
+                mathEnhancement.notation = opts.notation;
+            if (opts.prerequisites)
+                mathEnhancement.prerequisites = opts.prerequisites;
+            data.mathEnhancement = mathEnhancement;
+        }
+        await run(() => api.post("/api/cli/knowledge", { action: "update", id, data }), isJson(opts));
+    });
+    // ── knowledge delete ──
+    knowledge
+        .command("delete <id>")
+        .description("Permanently delete a knowledge entry")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.post("/api/cli/knowledge", { action: "delete", id }), isJson(opts));
+    });
+    // ── knowledge find ──
+    knowledge
+        .command("find <keyword>")
+        .description("Find or suggest creating a knowledge entry by keyword")
+        .option("--json", "Output as JSON")
+        .action(async (keyword, opts) => {
+        await run(() => api.get(`/api/cli/knowledge?action=find_or_suggest&keyword=${encodeURIComponent(keyword)}`), isJson(opts));
+    });
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/commands/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../src/commands/knowledge.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,UAAU,yBAAyB,CAAC,OAAgB,EAAE,GAAc;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,kDAAkD,CAAC,CAAC;IAE/G,uBAAuB;IACvB,SAAS;SACN,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CAAC,mBAAmB,EAAE,gCAAgC,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,sCAAsC,CAAC;SACnE,MAAM,CAAC,kBAAkB,EAAE,sCAAsC,CAAC;SAClE,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;SAC9C,MAAM,CAAC,YAAY,EAAE,yBAAyB,CAAC;SAC/C,MAAM,CAAC,iBAAiB,EAAE,iCAAiC,CAAC;SAC5D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,UAAU;YAAE,MAAM,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEL,sBAAsB;IACtB,SAAS;SACN,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,oCAAoC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACvG,CAAC,CAAC,CAAC;IAEL,yBAAyB;IACzB,SAAS;SACN,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,2FAA2F,CAAC;SACxG,cAAc,CAAC,iBAAiB,EAAE,aAAa,CAAC;SAChD,cAAc,CAAC,iBAAiB,EAAE,uDAAuD,CAAC;SAC1F,cAAc,CAAC,iBAAiB,EAAE,mDAAmD,CAAC;SACtF,MAAM,CAAC,eAAe,EAAE,sCAAsC,CAAC;SAC/D,MAAM,CAAC,uBAAuB,EAAE,4BAA4B,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,CAAC;SACzD,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE,wDAAwD,CAAC;SAC1E,MAAM,CAAC,kBAAkB,EAAE,4CAA4C,CAAC;SACxE,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;SACrD,MAAM,CAAC,uBAAuB,EAAE,sCAAsC,CAAC;SACvE,MAAM,CAAC,yBAAyB,EAAE,sCAAsC,CAAC;SACzE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,IAAI,GAA4B;YACpC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC;QACF,IAAI,IAAI,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrC,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,eAAe,GAA4B,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,UAAU;gBAAE,eAAe,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAChF,IAAI,IAAI,CAAC,QAAQ;gBAAE,eAAe,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5D,IAAI,IAAI,CAAC,QAAQ;gBAAE,eAAe,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5D,IAAI,IAAI,CAAC,aAAa;gBAAE,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YAC3E,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACzC,CAAC;QACD,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEL,yBAAyB;IACzB,SAAS;SACN,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,uEAAuE,CAAC;SACpF,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC;SACxC,MAAM,CAAC,iBAAiB,EAAE,aAAa,CAAC;SACxC,MAAM,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;SAC9C,MAAM,CAAC,uBAAuB,EAAE,4BAA4B,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,CAAC;SACzD,MAAM,CAAC,oBAAoB,EAAE,oCAAoC,CAAC;SAClE,MAAM,CAAC,QAAQ,EAAE,gCAAgC,CAAC;SAClD,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,CAAC;SACjD,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;SACrD,MAAM,CAAC,uBAAuB,EAAE,iBAAiB,CAAC;SAClD,MAAM,CAAC,yBAAyB,EAAE,oBAAoB,CAAC;SACvD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxC,IAAI,IAAI,CAAC,WAAW;YAAE,IAAI,CAAC,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnE,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC;QAC1E,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,eAAe,GAA4B,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,UAAU;gBAAE,eAAe,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YAChF,IAAI,IAAI,CAAC,QAAQ;gBAAE,eAAe,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5D,IAAI,IAAI,CAAC,QAAQ;gBAAE,eAAe,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YAC5D,IAAI,IAAI,CAAC,aAAa;gBAAE,eAAe,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;YAC3E,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACzC,CAAC;QACD,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEL,yBAAyB;IACzB,SAAS;SACN,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,sCAAsC,CAAC;SACnD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEL,uBAAuB;IACvB,SAAS;SACN,OAAO,CAAC,gBAAgB,CAAC;SACzB,WAAW,CAAC,uDAAuD,CAAC;SACpE,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QAC9B,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,qDAAqD,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7H,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/post.d.ts

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

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

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

package/dist/commands/post.js

@@ -0,0 +1,207 @@
+import { run, readContent, readStdin, isJson } from "./helpers.js";
+export function registerPostCommands(program, api) {
+    const post = program.command("post").description("Manage blog posts");
+    // ── post list ──
+    post
+        .command("list")
+        .description("List all posts (admin view, includes drafts)")
+        .option("--status <status>", "Filter by status: draft or published")
+        .option("--q <keyword>", "Search by title or slug")
+        .option("--limit <n>", "Limit number of results (max 100)")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        await run(() => api.get("/api/cli/posts", {
+            status: opts.status,
+            q: opts.q,
+            limit: opts.limit,
+        }), isJson(opts));
+    });
+    // ── post get ──
+    post
+        .command("get <id>")
+        .description("Get full post detail by id (uuid). For posts >5000 words, use 'outline' + 'section' instead")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.get(`/api/cli/posts/${encodeURIComponent(id)}`), isJson(opts));
+    });
+    // ── post refs ──
+    post
+        .command("refs")
+        .description("List posts for site reference (id/title/slug/status). Use before creating internal links")
+        .option("--q <keyword>", "Search keyword")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        await run(() => api.get("/api/cli/posts", { mode: "reference", q: opts.q }), isJson(opts));
+    });
+    // ── post create ──
+    post
+        .command("create")
+        .description("Create a new post. Content is required (use --content-file or --stdin)")
+        .requiredOption("--title <title>", "Post title")
+        .option("--slug <slug>", "Post slug (auto-generated if empty)")
+        .option("--content-file <path>", "Read content from file")
+        .option("--stdin", "Read content from stdin")
+        .option("--status <status>", "Post status: draft or published (default: draft)")
+        .option("--excerpt <excerpt>", "Post excerpt")
+        .option("--cover-image <url>", "Cover image URL")
+        .option("--seo-title <title>", "SEO title")
+        .option("--seo-description <desc>", "SEO description")
+        .option("--canonical-url <url>", "Canonical URL")
+        .option("--comments-enabled", "Enable comments (default: true)")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const content = opts.stdin ? readStdin() : readContent(opts.contentFile);
+        const body = { title: opts.title, content };
+        if (opts.slug)
+            body.slug = opts.slug;
+        if (opts.status)
+            body.status = opts.status;
+        if (opts.excerpt)
+            body.excerpt = opts.excerpt;
+        if (opts.coverImage)
+            body.coverImage = opts.coverImage;
+        if (opts.seoTitle)
+            body.seoTitle = opts.seoTitle;
+        if (opts.seoDescription)
+            body.seoDescription = opts.seoDescription;
+        if (opts.canonicalUrl)
+            body.canonicalUrl = opts.canonicalUrl;
+        if (opts.commentsEnabled !== undefined)
+            body.commentsEnabled = opts.commentsEnabled;
+        await run(() => api.post("/api/cli/posts", body), isJson(opts));
+    });
+    // ── post update ──
+    post
+        .command("update <id>")
+        .description("Full update of a post. For large posts, use 'outline' + 'replace-section' instead")
+        .requiredOption("--title <title>", "Post title")
+        .option("--content-file <path>", "Read content from file")
+        .option("--stdin", "Read content from stdin")
+        .option("--slug <slug>", "Post slug")
+        .option("--status <status>", "Post status: draft or published")
+        .option("--excerpt <excerpt>", "Post excerpt")
+        .option("--cover-image <url>", "Cover image URL")
+        .option("--seo-title <title>", "SEO title")
+        .option("--seo-description <desc>", "SEO description")
+        .option("--canonical-url <url>", "Canonical URL")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        const body = { title: opts.title };
+        if (opts.contentFile || opts.stdin) {
+            body.content = opts.stdin ? readStdin() : readContent(opts.contentFile);
+        }
+        if (opts.slug)
+            body.slug = opts.slug;
+        if (opts.status)
+            body.status = opts.status;
+        if (opts.excerpt)
+            body.excerpt = opts.excerpt;
+        if (opts.coverImage)
+            body.coverImage = opts.coverImage;
+        if (opts.seoTitle)
+            body.seoTitle = opts.seoTitle;
+        if (opts.seoDescription)
+            body.seoDescription = opts.seoDescription;
+        if (opts.canonicalUrl)
+            body.canonicalUrl = opts.canonicalUrl;
+        await run(() => api.patch(`/api/cli/posts/${encodeURIComponent(id)}`, body), isJson(opts));
+    });
+    // ── post publish ──
+    post
+        .command("publish <id>")
+        .description("Publish a post (set status to published)")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.patch(`/api/cli/posts/${encodeURIComponent(id)}/status`, { status: "published" }), isJson(opts));
+    });
+    // ── post unpublish ──
+    post
+        .command("unpublish <id>")
+        .description("Unpublish a post (set status to draft)")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.patch(`/api/cli/posts/${encodeURIComponent(id)}/status`, { status: "draft" }), isJson(opts));
+    });
+    // ── post delete ──
+    post
+        .command("delete <id>")
+        .description("Permanently delete a post. Use with caution.")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.delete(`/api/cli/posts/${encodeURIComponent(id)}`), isJson(opts));
+    });
+    // ── post append ──
+    post
+        .command("append <id>")
+        .description("Append content to the end of a post. For long posts, use 'create' skeleton + multiple 'append'.")
+        .requiredOption("--content-file <path>", "Read content from file")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        const content = readContent(opts.contentFile);
+        await run(() => api.patch(`/api/cli/posts/${encodeURIComponent(id)}/append`, { content }), isJson(opts));
+    });
+    // ── post outline ──
+    post
+        .command("outline <id>")
+        .description("Get post section outline (saves tokens vs reading full content)")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.get(`/api/cli/posts/${encodeURIComponent(id)}/outline`), isJson(opts));
+    });
+    // ── post section ──
+    post
+        .command("section <id>")
+        .description("Read a single section by --index or --heading")
+        .option("--index <n>", "Section index (0-based, from 'outline')")
+        .option("--heading <text>", "Section heading text")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.get(`/api/cli/posts/${encodeURIComponent(id)}/sections`, {
+            index: opts.index,
+            heading: opts.heading,
+        }), isJson(opts));
+    });
+    // ── post replace-section ──
+    post
+        .command("replace-section <id>")
+        .description("Replace a section by --index or --heading with new content")
+        .requiredOption("--content-file <path>", "Read new content from file")
+        .option("--index <n>", "Section index (0-based, from 'outline')")
+        .option("--heading <text>", "Section heading text")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        const newContent = readContent(opts.contentFile);
+        const body = { newContent };
+        if (opts.index !== undefined)
+            body.sectionIndex = parseInt(opts.index, 10);
+        if (opts.heading)
+            body.sectionHeading = opts.heading;
+        await run(() => api.patch(`/api/cli/posts/${encodeURIComponent(id)}/replace-section`, body), isJson(opts));
+    });
+    // ── post insert-section ──
+    post
+        .command("insert-section <id>")
+        .description("Insert a new section after the specified index (-1 = beginning)")
+        .requiredOption("--after-index <n>", "Insert after this section index (-1 for beginning)")
+        .requiredOption("--content-file <path>", "Read content from file")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        const content = readContent(opts.contentFile);
+        await run(() => api.post(`/api/cli/posts/${encodeURIComponent(id)}/insert-section`, {
+            afterIndex: parseInt(opts.afterIndex, 10),
+            content,
+        }), isJson(opts));
+    });
+    // ── post validate ──
+    post
+        .command("validate")
+        .description("Validate markdown content (run before create/update)")
+        .option("--content-file <path>", "Read content from file")
+        .option("--stdin", "Read content from stdin")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const content = opts.stdin ? readStdin() : readContent(opts.contentFile);
+        await run(() => api.post("/api/cli/validate", { content }), isJson(opts));
+    });
+}
+//# sourceMappingURL=post.js.map

package/dist/commands/post.js.map

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

package/dist/commands/scout.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"scout.d.ts","sourceRoot":"","sources":["../../src/commands/scout.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,CA0C5E"}

package/dist/commands/scout.js

@@ -0,0 +1,48 @@
+import { readFileSync } from "node:fs";
+import { run, isJson } from "./helpers.js";
+export function registerScoutCommands(program, api) {
+    const scout = program.command("scout").description("Search Scout knowledge engine items");
+    // ── scout search ──
+    scout
+        .command("search")
+        .description("Search Scout collected high-quality tech items")
+        .option("--keyword <keyword>", "Search keyword (matches title and summary)")
+        .option("--category <category>", "Category filter (e.g. AI, LLM, Web Development)")
+        .option("--min-score <n>", "Minimum overall score (0-10, default 6)")
+        .option("--limit <n>", "Max results (default 10, max 30)")
+        .option("--since <date>", "Earliest fetch date (ISO date string, e.g. 2026-01-01)")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const query = {};
+        if (opts.keyword)
+            query.keyword = opts.keyword;
+        if (opts.category)
+            query.category = opts.category;
+        if (opts.minScore !== undefined)
+            query.minScore = opts.minScore;
+        if (opts.limit !== undefined)
+            query.limit = opts.limit;
+        if (opts.since)
+            query.since = opts.since;
+        await run(() => api.get("/api/cli/scout/items", query), isJson(opts));
+    });
+    // ── scout add-refs ──
+    scout
+        .command("add-refs <postId>")
+        .description("Add reference sources to a post (from Scout or external)")
+        .requiredOption("--refs-file <path>", "JSON file: [{title, url, summary?, sourceName?, scoutItemId?}]")
+        .option("--json", "Output as JSON")
+        .action(async (postId, opts) => {
+        const references = JSON.parse(readFileSync(opts.refsFile, "utf-8"));
+        await run(() => api.post("/api/cli/scout/references", { postId, references }), isJson(opts));
+    });
+    // ── scout refs ──
+    scout
+        .command("refs <postId>")
+        .description("List all references of a post")
+        .option("--json", "Output as JSON")
+        .action(async (postId, opts) => {
+        await run(() => api.get("/api/cli/scout/references", { postId }), isJson(opts));
+    });
+}
+//# sourceMappingURL=scout.js.map

package/dist/commands/scout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scout.js","sourceRoot":"","sources":["../../src/commands/scout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,GAAc;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,qCAAqC,CAAC,CAAC;IAE1F,qBAAqB;IACrB,KAAK;SACF,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,qBAAqB,EAAE,4CAA4C,CAAC;SAC3E,MAAM,CAAC,uBAAuB,EAAE,iDAAiD,CAAC;SAClF,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,CAAC;SACpE,MAAM,CAAC,aAAa,EAAE,kCAAkC,CAAC;SACzD,MAAM,CAAC,gBAAgB,EAAE,wDAAwD,CAAC;SAClF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACrB,MAAM,KAAK,GAAgD,EAAE,CAAC;QAC9D,IAAI,IAAI,CAAC,OAAO;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC/C,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAClD,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAChE,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvD,IAAI,IAAI,CAAC,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEL,uBAAuB;IACvB,KAAK;SACF,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,0DAA0D,CAAC;SACvE,cAAc,CAAC,oBAAoB,EAAE,gEAAgE,CAAC;SACtG,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;QACpE,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEL,mBAAmB;IACnB,KAAK;SACF,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SAClC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC7B,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,2BAA2B,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/series.d.ts

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

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

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

package/dist/commands/series.js

@@ -0,0 +1,101 @@
+import { run, isJson } from "./helpers.js";
+export function registerSeriesCommands(program, api) {
+    const series = program.command("series").description("Manage article series");
+    // ── series list ──
+    series
+        .command("list")
+        .description("List all series")
+        .option("--published", "Only show published series")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        await run(() => api.get("/api/cli/series", opts.published ? { published: "true" } : {}), isJson(opts));
+    });
+    // ── series get ──
+    series
+        .command("get <id>")
+        .description("Get series detail (with posts and order)")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.get(`/api/cli/series/${encodeURIComponent(id)}`), isJson(opts));
+    });
+    // ── series create ──
+    series
+        .command("create")
+        .description("Create a new series")
+        .requiredOption("--slug <slug>", "URL slug (lowercase, numbers, hyphens)")
+        .requiredOption("--title <title>", "Series title")
+        .option("--description <desc>", "Series description")
+        .option("--cover-image <url>", "Cover image URL")
+        .option("--published", "Publish immediately")
+        .option("--json", "Output as JSON")
+        .action(async (opts) => {
+        const body = { slug: opts.slug, title: opts.title };
+        if (opts.description)
+            body.description = opts.description;
+        if (opts.coverImage)
+            body.coverImage = opts.coverImage;
+        body.isPublished = opts.published ?? false;
+        await run(() => api.post("/api/cli/series", body), isJson(opts));
+    });
+    // ── series update ──
+    series
+        .command("update <id>")
+        .description("Update series metadata")
+        .option("--title <title>", "Series title")
+        .option("--description <desc>", "Series description")
+        .option("--cover-image <url>", "Cover image URL")
+        .option("--published <bool>", "Publish status (true/false)")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        const body = {};
+        if (opts.title)
+            body.title = opts.title;
+        if (opts.description)
+            body.description = opts.description;
+        if (opts.coverImage)
+            body.coverImage = opts.coverImage;
+        if (opts.published !== undefined)
+            body.isPublished = opts.published === "true";
+        await run(() => api.patch(`/api/cli/series/${encodeURIComponent(id)}`, body), isJson(opts));
+    });
+    // ── series delete ──
+    series
+        .command("delete <id>")
+        .description("Delete a series (posts are not deleted, only associations)")
+        .option("--json", "Output as JSON")
+        .action(async (id, opts) => {
+        await run(() => api.delete(`/api/cli/series/${encodeURIComponent(id)}`), isJson(opts));
+    });
+    // ── series add-post ──
+    series
+        .command("add-post <seriesId> <postId>")
+        .description("Add a post to a series (optionally at a specific position)")
+        .option("--order <n>", "Position in series (0-based)")
+        .option("--json", "Output as JSON")
+        .action(async (seriesId, postId, opts) => {
+        const body = { postId };
+        if (opts.order !== undefined)
+            body.orderIndex = parseInt(opts.order, 10);
+        await run(() => api.post(`/api/cli/series/${encodeURIComponent(seriesId)}/posts`, body), isJson(opts));
+    });
+    // ── series remove-post ──
+    series
+        .command("remove-post <seriesId> <postId>")
+        .description("Remove a post from a series")
+        .option("--json", "Output as JSON")
+        .action(async (seriesId, postId, opts) => {
+        await run(() => api.post(`/api/cli/series/${encodeURIComponent(seriesId)}/posts/remove`, { postId }), isJson(opts));
+    });
+    // ── series reorder ──
+    series
+        .command("reorder <seriesId>")
+        .description("Reorder posts in a series")
+        .requiredOption("--post-ids <ids...>", "Post IDs in new order")
+        .option("--json", "Output as JSON")
+        .action(async (seriesId, opts) => {
+        await run(() => api.post(`/api/cli/series/${encodeURIComponent(seriesId)}/reorder`, {
+            postIds: opts.postIds,
+        }), isJson(opts));
+    });
+}
+//# sourceMappingURL=series.js.map

package/dist/commands/series.js.map

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

package/dist/commands/skills.d.ts

@@ -0,0 +1,3 @@
+import type { Command } from "commander";
+export declare function registerSkillsCommand(program: Command): void;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/commands/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyEzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAO5D"}