smartwing_knowflow 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shelton Wan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# KnowFlow CLI
+
+`smartwing_knowflow` 是 KnowFlow 的官方命令行工具：通过 API Key 把 Markdown 一键发布到 KnowFlow 社区（AI 自动发布、自动分类）。
+
+## 安装
+
+```bash
+npm i -g smartwing_knowflow
+# 或
+pnpm add -g smartwing_knowflow
+```
+
+要求 Node.js >= 20。
+
+## 配置
+
+```bash
+export KNOWFLOW_SITE="https://knowflow.smartwingtech.com"
+export KNOWFLOW_API_KEY="kf_…"
+```
+
+> API Key 只从环境变量读取，禁止写进命令行参数或提交到代码库。
+
+## 发布
+
+```bash
+knowflow publish ./article.md
+knowflow publish ./article.md --title "自定义标题" --tags ai,workflow
+knowflow publish ./article.md --space team-docs --tags ai
+```
+
+成功时 stdout 输出绝对 URL，退出码 `0`；用法/配置错误 `2`；API/网络错误 `3`。
+
+## 参数
+
+| 参数 | 说明 |
+|---|---|
+| `<file.md>` | 要发布的 Markdown 文件（≤1MB） |
+| `--title` | 覆盖标题，缺省取文件名 |
+| `--space <slug>` | 发布到团队空间 |
+| `--tags <list>` | 逗号分隔标签（≤5 个） |
+| `--site <url>` | 覆盖 `KNOWFLOW_SITE` |
+| `--json` / `--quiet` / `--verbose` | 机器可读 / 静默 / 诊断 |
+
+## 获取 API Key
+
+登录 KnowFlow → 设置页 `/me/settings` → 创建 API Key（`kf_` 前缀，仅展示一次）。
+
+## License
+
+MIT

package/bin/knowflow.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+// The executable is CommonJS so it can load tsup's Node-compatible bundle.
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+require("../dist/entry.cjs");

package/dist/entry.cjs

@@ -0,0 +1,269 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/features/cli/cli.ts
+var import_commander = require("commander");
+
+// src/features/cli/adapters/node-file.adapter.ts
+var import_promises = require("fs/promises");
+var NodeFileAdapter = class {
+  async readText(path, signal) {
+    return (0, import_promises.readFile)(path, { encoding: "utf8", signal });
+  }
+};
+
+// src/features/cli/adapters/fetch-http.adapter.ts
+var import_openapi_fetch = __toESM(require("openapi-fetch"));
+var FetchKnowFlowHttpAdapter = class {
+  client;
+  site;
+  constructor(site) {
+    this.site = site;
+    this.client = (0, import_openapi_fetch.default)({ baseUrl: site });
+  }
+  async publish(body, apiKey, idempotencyKey, signal) {
+    const { data, error, response } = await this.client.POST("/api/v1/posts", {
+      body,
+      headers: {
+        authorization: `Bearer ${apiKey}`,
+        "idempotency-key": idempotencyKey
+      },
+      signal
+    });
+    if (data) {
+      return {
+        ok: true,
+        post: {
+          ...data,
+          url: data.url ? new URL(data.url, this.site).toString() : data.url
+        }
+      };
+    }
+    const payload = typeof error === "object" && error !== null ? error : {};
+    return {
+      ok: false,
+      error: {
+        status: response.status,
+        code: "code" in payload && typeof payload.code === "string" ? payload.code : "HTTP_ERROR",
+        message: "message" in payload && typeof payload.message === "string" ? payload.message : `HTTP ${response.status}`
+      }
+    };
+  }
+};
+
+// src/features/cli/core/config.ts
+var import_zod = require("zod");
+
+// src/features/cli/core/errors.ts
+var EXIT_SUCCESS = 0;
+var EXIT_GENERIC = 1;
+var EXIT_USAGE = 2;
+var EXIT_API = 3;
+var CliError = class extends Error {
+  constructor(code, message, exitCode) {
+    super(message);
+    this.code = code;
+    this.exitCode = exitCode;
+    this.name = "CliError";
+  }
+  code;
+  exitCode;
+};
+
+// src/features/cli/core/config.ts
+var configSchema = import_zod.z.object({
+  apiKey: import_zod.z.string().startsWith("kf_"),
+  site: import_zod.z.string().url().transform((value) => value.replace(/\/$/, ""))
+});
+function resolveCliConfig(flags, env) {
+  const parsed = configSchema.safeParse({
+    apiKey: env.KNOWFLOW_API_KEY,
+    site: flags.site ?? env.KNOWFLOW_SITE
+  });
+  if (!parsed.success) {
+    const missing = [
+      !env.KNOWFLOW_API_KEY ? "KNOWFLOW_API_KEY" : null,
+      !flags.site && !env.KNOWFLOW_SITE ? "KNOWFLOW_SITE" : null
+    ].filter((value) => value !== null);
+    throw new CliError(
+      "CONFIG_REQUIRED",
+      missing.length > 0 ? `Configure ${missing.join(" and ")} or pass the matching flags.` : "KNOWFLOW_API_KEY or KNOWFLOW_SITE is invalid.",
+      EXIT_USAGE
+    );
+  }
+  return parsed.data;
+}
+
+// src/features/cli/io/output.ts
+var CliOutput = class {
+  constructor(stdout, stderr, quiet = false, json = false) {
+    this.stdout = stdout;
+    this.stderr = stderr;
+    this.quiet = quiet;
+    this.json = json;
+  }
+  stdout;
+  stderr;
+  quiet;
+  json;
+  success(url) {
+    if (this.quiet) return;
+    this.stdout.write(this.json ? `${JSON.stringify({ url })}
+` : `${url}
+`);
+  }
+  diagnostic(message) {
+    this.stderr.write(this.json ? `${JSON.stringify({ error: message })}
+` : `${message}
+`);
+  }
+  verbose(message, enabled) {
+    if (enabled) this.stderr.write(`${message}
+`);
+  }
+};
+
+// src/features/cli/publish.service.ts
+var import_node_crypto = require("crypto");
+var import_node_path = require("path");
+var FILE_TIMEOUT_MS = 5e3;
+var HTTP_TIMEOUT_MS = 1e4;
+var MAX_MARKDOWN_BYTES = 1024 * 1024;
+var PublishService = class {
+  constructor(fileAdapter, httpAdapter) {
+    this.fileAdapter = fileAdapter;
+    this.httpAdapter = httpAdapter;
+  }
+  fileAdapter;
+  httpAdapter;
+  async publish(options, apiKey) {
+    let markdown;
+    try {
+      markdown = await this.fileAdapter.readText(
+        options.file,
+        AbortSignal.timeout(FILE_TIMEOUT_MS)
+      );
+    } catch (error) {
+      throw new CliError(
+        "FILE_READ_ERROR",
+        `Unable to read ${options.file}: ${error instanceof Error ? error.message : "unknown error"}`,
+        EXIT_USAGE
+      );
+    }
+    if (!markdown.trim()) {
+      throw new CliError("EMPTY_FILE", "Markdown file is empty.", EXIT_USAGE);
+    }
+    if (Buffer.byteLength(markdown, "utf8") > MAX_MARKDOWN_BYTES) {
+      throw new CliError("FILE_TOO_LARGE", "Markdown file exceeds 1MB.", EXIT_USAGE);
+    }
+    const title = options.title?.trim() || (0, import_node_path.basename)(options.file).replace(/\.md$/i, "");
+    const body = {
+      title,
+      markdown,
+      visibility: options.space ? "space" : "public",
+      ...options.space ? { space_id: options.space } : {},
+      ...options.tags.length > 0 ? { tags: options.tags } : {}
+    };
+    const digest = (0, import_node_crypto.createHash)("sha256").update(JSON.stringify(body)).digest("hex").slice(0, 32);
+    const idempotencyKey = `cli-${digest}`;
+    let result;
+    try {
+      result = await this.httpAdapter.publish(
+        body,
+        apiKey,
+        idempotencyKey,
+        AbortSignal.timeout(HTTP_TIMEOUT_MS)
+      );
+    } catch (error) {
+      throw new CliError(
+        "NETWORK_ERROR",
+        error instanceof Error ? error.message : "Network request failed.",
+        EXIT_API
+      );
+    }
+    if (!result.ok) {
+      throw new CliError(result.error.code, result.error.message, EXIT_API);
+    }
+    if (!result.post.url) {
+      throw new CliError("INVALID_RESPONSE", "API response did not include a post URL.", EXIT_API);
+    }
+    return result.post.url;
+  }
+};
+
+// src/features/cli/cli.ts
+function parseTags(value) {
+  return value ? Array.from(new Set(value.split(",").map((tag) => tag.trim()).filter(Boolean))).slice(0, 5) : [];
+}
+async function runCli(argv, runtime = { env: process.env, stdout: process.stdout, stderr: process.stderr }) {
+  let exitCode = EXIT_SUCCESS;
+  const program = new import_commander.Command().name("knowflow").description("Publish Markdown to KnowFlow").version("0.1.0").showHelpAfterError().exitOverride().configureOutput({
+    writeOut: (text) => runtime.stdout.write(text),
+    writeErr: (text) => runtime.stderr.write(text)
+  });
+  program.command("publish").description("Publish a Markdown file and print its URL").argument("<file.md>", "Markdown file to publish").option("--space <slug>", "Publish to a team space").option("--tags <list>", "Comma-separated tags").option("--title <title>", "Override the file name as title").option("--site <url>", "KnowFlow site (overrides KNOWFLOW_SITE)").option("--json", "Print machine-readable JSON").option("--quiet", "Suppress successful output").option("--verbose", "Print diagnostics to stderr").addHelpText("after", "\nExit codes: 0 success, 1 internal, 2 usage/config, 3 API/network").action(async (file, flags) => {
+    const output = new CliOutput(runtime.stdout, runtime.stderr, flags.quiet, flags.json);
+    try {
+      const config = resolveCliConfig(flags, runtime.env);
+      output.verbose(`Publishing ${file} to ${config.site}`, Boolean(flags.verbose));
+      const service = new PublishService(
+        new NodeFileAdapter(),
+        new FetchKnowFlowHttpAdapter(config.site)
+      );
+      output.success(
+        await service.publish(
+          { file, title: flags.title, space: flags.space, tags: parseTags(flags.tags) },
+          config.apiKey
+        )
+      );
+    } catch (error) {
+      const cliError = error instanceof CliError ? error : new CliError(
+        "INTERNAL",
+        error instanceof Error ? error.message : "Unexpected CLI error",
+        EXIT_GENERIC
+      );
+      output.diagnostic(`${cliError.code}: ${cliError.message}`);
+      exitCode = cliError.exitCode;
+    }
+  });
+  try {
+    await program.parseAsync(argv, { from: "user" });
+  } catch (error) {
+    if (error instanceof import_commander.CommanderError) {
+      return error.exitCode === 0 ? EXIT_SUCCESS : EXIT_USAGE;
+    }
+    throw error;
+  }
+  return exitCode;
+}
+
+// src/features/cli/entry.ts
+void runCli(process.argv.slice(2)).then((exitCode) => {
+  process.exitCode = exitCode;
+}).catch((error) => {
+  process.stderr.write(`${error instanceof Error ? error.message : "Unexpected CLI error"}
+`);
+  process.exitCode = 1;
+});
+//# sourceMappingURL=entry.cjs.map

package/dist/entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/features/cli/cli.ts","../../src/features/cli/adapters/node-file.adapter.ts","../../src/features/cli/adapters/fetch-http.adapter.ts","../../src/features/cli/core/config.ts","../../src/features/cli/core/errors.ts","../../src/features/cli/io/output.ts","../../src/features/cli/publish.service.ts","../../src/features/cli/entry.ts"],"sourcesContent":["import type { Writable } from \"node:stream\";\nimport { Command, CommanderError } from \"commander\";\nimport { NodeFileAdapter } from \"./adapters/node-file.adapter\";\nimport { FetchKnowFlowHttpAdapter } from \"./adapters/fetch-http.adapter\";\nimport { resolveCliConfig } from \"./core/config\";\nimport { CliError, EXIT_GENERIC, EXIT_SUCCESS, EXIT_USAGE } from \"./core/errors\";\nimport { CliOutput } from \"./io/output\";\nimport { PublishService } from \"./publish.service\";\n\ninterface CliRuntime {\n  env: Record<string, string | undefined>;\n  stdout: Writable;\n  stderr: Writable;\n}\n\ninterface PublishFlags {\n  json?: boolean;\n  quiet?: boolean;\n  site?: string;\n  space?: string;\n  tags?: string;\n  title?: string;\n  verbose?: boolean;\n}\n\nfunction parseTags(value: string | undefined): string[] {\n  return value\n    ? Array.from(new Set(value.split(\",\").map((tag) => tag.trim()).filter(Boolean))).slice(0, 5)\n    : [];\n}\n\nexport async function runCli(\n  argv: string[],\n  runtime: CliRuntime = { env: process.env, stdout: process.stdout, stderr: process.stderr },\n): Promise<number> {\n  let exitCode = EXIT_SUCCESS;\n  const program = new Command()\n    .name(\"knowflow\")\n    .description(\"Publish Markdown to KnowFlow\")\n    .version(\"0.1.0\")\n    .showHelpAfterError()\n    .exitOverride()\n    .configureOutput({\n      writeOut: (text) => runtime.stdout.write(text),\n      writeErr: (text) => runtime.stderr.write(text),\n    });\n\n  program\n    .command(\"publish\")\n    .description(\"Publish a Markdown file and print its URL\")\n    .argument(\"<file.md>\", \"Markdown file to publish\")\n    .option(\"--space <slug>\", \"Publish to a team space\")\n    .option(\"--tags <list>\", \"Comma-separated tags\")\n    .option(\"--title <title>\", \"Override the file name as title\")\n    .option(\"--site <url>\", \"KnowFlow site (overrides KNOWFLOW_SITE)\")\n    .option(\"--json\", \"Print machine-readable JSON\")\n    .option(\"--quiet\", \"Suppress successful output\")\n    .option(\"--verbose\", \"Print diagnostics to stderr\")\n    .addHelpText(\"after\", \"\\nExit codes: 0 success, 1 internal, 2 usage/config, 3 API/network\")\n    .action(async (file: string, flags: PublishFlags) => {\n      const output = new CliOutput(runtime.stdout, runtime.stderr, flags.quiet, flags.json);\n      try {\n        const config = resolveCliConfig(flags, runtime.env);\n        output.verbose(`Publishing ${file} to ${config.site}`, Boolean(flags.verbose));\n        const service = new PublishService(\n          new NodeFileAdapter(),\n          new FetchKnowFlowHttpAdapter(config.site),\n        );\n        output.success(\n          await service.publish(\n            { file, title: flags.title, space: flags.space, tags: parseTags(flags.tags) },\n            config.apiKey,\n          ),\n        );\n      } catch (error) {\n        const cliError =\n          error instanceof CliError\n            ? error\n            : new CliError(\n                \"INTERNAL\",\n                error instanceof Error ? error.message : \"Unexpected CLI error\",\n                EXIT_GENERIC,\n              );\n        output.diagnostic(`${cliError.code}: ${cliError.message}`);\n        exitCode = cliError.exitCode;\n      }\n    });\n\n  try {\n    await program.parseAsync(argv, { from: \"user\" });\n  } catch (error) {\n    if (error instanceof CommanderError) {\n      return error.exitCode === 0 ? EXIT_SUCCESS : EXIT_USAGE;\n    }\n    throw error;\n  }\n  return exitCode;\n}","import { readFile } from \"node:fs/promises\";\nimport type { FileAdapter } from \"./file-adapter.interface\";\n\nexport class NodeFileAdapter implements FileAdapter {\n  async readText(path: string, signal: AbortSignal): Promise<string> {\n    // CLI users explicitly select this local path.\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    return readFile(path, { encoding: \"utf8\", signal });\n  }\n}","import createClient from \"openapi-fetch\";\nimport type { paths } from \"../generated/api\";\nimport type {\n  KnowFlowHttpAdapter,\n  PublishBody,\n  PublishResult,\n} from \"./http-adapter.interface\";\n\nexport class FetchKnowFlowHttpAdapter implements KnowFlowHttpAdapter {\n  private readonly client: ReturnType<typeof createClient<paths>>;\n  private readonly site: string;\n\n  constructor(site: string) {\n    this.site = site;\n    this.client = createClient<paths>({ baseUrl: site });\n  }\n\n  async publish(\n    body: PublishBody,\n    apiKey: string,\n    idempotencyKey: string,\n    signal: AbortSignal,\n  ): Promise<PublishResult> {\n    const { data, error, response } = await this.client.POST(\"/api/v1/posts\", {\n      body,\n      headers: {\n        authorization: `Bearer ${apiKey}`,\n        \"idempotency-key\": idempotencyKey,\n      },\n      signal,\n    });\n    if (data) {\n      return {\n        ok: true,\n        post: {\n          ...data,\n          url: data.url ? new URL(data.url, this.site).toString() : data.url,\n        },\n      };\n    }\n\n    const payload = typeof error === \"object\" && error !== null ? error : {};\n    return {\n      ok: false,\n      error: {\n        status: response.status,\n        code: \"code\" in payload && typeof payload.code === \"string\" ? payload.code : \"HTTP_ERROR\",\n        message:\n          \"message\" in payload && typeof payload.message === \"string\"\n            ? payload.message\n            : `HTTP ${response.status}`,\n      },\n    };\n  }\n}","import { z } from \"zod\";\nimport { CliError, EXIT_USAGE } from \"./errors\";\n\nconst configSchema = z.object({\n  apiKey: z.string().startsWith(\"kf_\"),\n  site: z.string().url().transform((value) => value.replace(/\\/$/, \"\")),\n});\n\nexport interface CliConfig {\n  apiKey: string;\n  site: string;\n}\n\nexport function resolveCliConfig(\n  flags: { site?: string },\n  env: Record<string, string | undefined>,\n): CliConfig {\n  const parsed = configSchema.safeParse({\n    apiKey: env.KNOWFLOW_API_KEY,\n    site: flags.site ?? env.KNOWFLOW_SITE,\n  });\n  if (!parsed.success) {\n    const missing = [\n      !env.KNOWFLOW_API_KEY ? \"KNOWFLOW_API_KEY\" : null,\n      !flags.site && !env.KNOWFLOW_SITE ? \"KNOWFLOW_SITE\" : null,\n    ].filter((value): value is string => value !== null);\n    throw new CliError(\n      \"CONFIG_REQUIRED\",\n      missing.length > 0\n        ? `Configure ${missing.join(\" and \")} or pass the matching flags.`\n        : \"KNOWFLOW_API_KEY or KNOWFLOW_SITE is invalid.\",\n      EXIT_USAGE,\n    );\n  }\n  return parsed.data;\n}","export const EXIT_SUCCESS = 0;\nexport const EXIT_GENERIC = 1;\nexport const EXIT_USAGE = 2;\nexport const EXIT_API = 3;\n\nexport class CliError extends Error {\n  constructor(\n    public readonly code: string,\n    message: string,\n    public readonly exitCode: number,\n  ) {\n    super(message);\n    this.name = \"CliError\";\n  }\n}","import type { Writable } from \"node:stream\";\n\nexport class CliOutput {\n  constructor(\n    private readonly stdout: Writable,\n    private readonly stderr: Writable,\n    private readonly quiet = false,\n    private readonly json = false,\n  ) {}\n\n  success(url: string): void {\n    if (this.quiet) return;\n    this.stdout.write(this.json ? `${JSON.stringify({ url })}\\n` : `${url}\\n`);\n  }\n\n  diagnostic(message: string): void {\n    this.stderr.write(this.json ? `${JSON.stringify({ error: message })}\\n` : `${message}\\n`);\n  }\n\n  verbose(message: string, enabled: boolean): void {\n    if (enabled) this.stderr.write(`${message}\\n`);\n  }\n}","import { createHash } from \"node:crypto\";\nimport { basename } from \"node:path\";\nimport type { FileAdapter } from \"./adapters/file-adapter.interface\";\nimport type { KnowFlowHttpAdapter } from \"./adapters/http-adapter.interface\";\nimport { CliError, EXIT_API, EXIT_USAGE } from \"./core/errors\";\n\nconst FILE_TIMEOUT_MS = 5_000;\nconst HTTP_TIMEOUT_MS = 10_000;\nconst MAX_MARKDOWN_BYTES = 1024 * 1024;\n\nexport interface PublishOptions {\n  file: string;\n  title?: string;\n  space?: string;\n  tags: string[];\n}\n\nexport class PublishService {\n  constructor(\n    private readonly fileAdapter: FileAdapter,\n    private readonly httpAdapter: KnowFlowHttpAdapter,\n  ) {}\n\n  async publish(\n    options: PublishOptions,\n    apiKey: string,\n  ): Promise<string> {\n    let markdown: string;\n    try {\n      markdown = await this.fileAdapter.readText(\n        options.file,\n        AbortSignal.timeout(FILE_TIMEOUT_MS),\n      );\n    } catch (error) {\n      throw new CliError(\n        \"FILE_READ_ERROR\",\n        `Unable to read ${options.file}: ${error instanceof Error ? error.message : \"unknown error\"}`,\n        EXIT_USAGE,\n      );\n    }\n    if (!markdown.trim()) {\n      throw new CliError(\"EMPTY_FILE\", \"Markdown file is empty.\", EXIT_USAGE);\n    }\n    if (Buffer.byteLength(markdown, \"utf8\") > MAX_MARKDOWN_BYTES) {\n      throw new CliError(\"FILE_TOO_LARGE\", \"Markdown file exceeds 1MB.\", EXIT_USAGE);\n    }\n\n    const title = options.title?.trim() || basename(options.file).replace(/\\.md$/i, \"\");\n    const body = {\n      title,\n      markdown,\n      visibility: options.space ? (\"space\" as const) : (\"public\" as const),\n      ...(options.space ? { space_id: options.space } : {}),\n      ...(options.tags.length > 0 ? { tags: options.tags } : {}),\n    };\n    const digest = createHash(\"sha256\")\n      .update(JSON.stringify(body))\n      .digest(\"hex\")\n      .slice(0, 32);\n    const idempotencyKey = `cli-${digest}`;\n\n    let result;\n    try {\n      result = await this.httpAdapter.publish(\n        body,\n        apiKey,\n        idempotencyKey,\n        AbortSignal.timeout(HTTP_TIMEOUT_MS),\n      );\n    } catch (error) {\n      throw new CliError(\n        \"NETWORK_ERROR\",\n        error instanceof Error ? error.message : \"Network request failed.\",\n        EXIT_API,\n      );\n    }\n    if (!result.ok) {\n      throw new CliError(result.error.code, result.error.message, EXIT_API);\n    }\n    if (!result.post.url) {\n      throw new CliError(\"INVALID_RESPONSE\", \"API response did not include a post URL.\", EXIT_API);\n    }\n    return result.post.url;\n  }\n}","import { runCli } from \"./cli\";\n\nvoid runCli(process.argv.slice(2))\n\t.then((exitCode) => {\n\t\tprocess.exitCode = exitCode;\n\t})\n\t.catch((error: unknown) => {\n\t\tprocess.stderr.write(`${error instanceof Error ? error.message : \"Unexpected CLI error\"}\\n`);\n\t\tprocess.exitCode = 1;\n\t});"],"mappings":"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","names":["createClient"]}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "smartwing_knowflow",
+  "version": "0.1.0",
+  "description": "KnowFlow 官方 CLI：通过 API Key 一键把 Markdown 发布到 KnowFlow 社区（AI 自动发布、自动分类）",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "knowflow": "bin/knowflow.js"
+  },
+  "files": [
+    "bin/",
+    "dist/",
+    "README.md"
+  ],
+  "keywords": [
+    "knowflow",
+    "markdown",
+    "publish",
+    "api",
+    "cli"
+  ],
+  "dependencies": {
+    "commander": "^14.0.3",
+    "openapi-fetch": "^0.17.0",
+    "zod": "^3.24.1"
+  }
+}