@softure-ai/blog 0.0.0-stage → 0.1.5

package/dist/cli/command.d.ts

@@ -0,0 +1,9 @@
+import { type CliOutput } from "./run.js";
+export interface RunBlogCommandOptions {
+    readonly argv: readonly string[];
+    readonly cwd: string;
+    readonly output?: CliOutput;
+}
+/** Checks the arguments, loads the config and runs `runBlogCli`. A usage error never loads the config. */
+export declare function runBlogCommand(options: RunBlogCommandOptions): Promise<number>;
+//# sourceMappingURL=command.d.ts.map

package/dist/cli/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgG,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAExI,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC;CAC7B;AAaD,0GAA0G;AAC1G,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpF"}

package/dist/cli/command.js

@@ -0,0 +1,40 @@
+// The `softure-blog` bin. It loads the app's config through `@softure-ai/core/cli`, like
+// `softure migrate` (@softure-ai/db): the file must be loadable by Node itself (`.js`/`.mjs`, or `.ts`
+// where Node strips types). Anything else uses an app script with `runBlogCli` instead (see run.ts).
+import { loadAppConfig, takeConfigOption } from "@softure-ai/core/cli";
+import { BLOG_USAGE, EXIT_FAILED, EXIT_OK, EXIT_USAGE, parseBlogCommand, runBlogCli } from "./run.js";
+const APP_SCRIPT = { runner: "runBlogCli", packageName: "@softure-ai/blog" };
+// The commands that never connect, so a CI job runs them with a config that has no database URL.
+// Any other command (and a new one, until it is listed here) needs the database.
+const COMMANDS_WITHOUT_DATABASE = new Set(["check", "skill-install"]);
+const consoleOutput = {
+    log: (line) => console.log(line),
+    error: (line) => console.error(line),
+};
+/** Checks the arguments, loads the config and runs `runBlogCli`. A usage error never loads the config. */
+export async function runBlogCommand(options) {
+    const output = options.output ?? consoleOutput;
+    const taken = takeConfigOption(options.argv);
+    if (!taken.ok)
+        return refuseUsage(output, taken.problem);
+    const command = parseBlogCommand(taken.argv);
+    if (typeof command === "string")
+        return refuseUsage(output, command);
+    if (command.kind === "help") {
+        output.log(BLOG_USAGE);
+        return EXIT_OK;
+    }
+    const database = COMMANDS_WITHOUT_DATABASE.has(command.kind) ? "optional" : "required";
+    const loaded = await loadAppConfig({ cwd: options.cwd, configPath: taken.configPath, appScript: APP_SCRIPT, database });
+    if (!loaded.ok) {
+        output.error(`softure-blog: ${loaded.problem}`);
+        return EXIT_FAILED;
+    }
+    return runBlogCli({ config: loaded.config, argv: taken.argv, cwd: options.cwd, output });
+}
+function refuseUsage(output, problem) {
+    output.error(`softure-blog: ${problem}`);
+    output.error(BLOG_USAGE);
+    return EXIT_USAGE;
+}
+//# sourceMappingURL=command.js.map

package/dist/cli/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,uGAAuG;AACvG,qGAAqG;AACrG,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAoC,MAAM,UAAU,CAAC;AAQxI,MAAM,UAAU,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,CAAC;AAE7E,iGAAiG;AACjG,iFAAiF;AACjF,MAAM,yBAAyB,GAAqC,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;AAExG,MAAM,aAAa,GAAc;IAC/B,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;CACrC,CAAC;AAEF,0GAA0G;AAC1G,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;IAC/C,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,QAAQ,GAAG,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IACvF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAChD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,WAAW,CAAC,MAAiB,EAAE,OAAe;IACrD,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzB,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,4 @@
+export { runBlogCommand, type RunBlogCommandOptions } from "./command.js";
+export { BLOG_USAGE, EXIT_FAILED, EXIT_OK, EXIT_USAGE, parseBlogCommand, runBlogCli, type BlogCommand, type CliOutput, type RunBlogCliOptions } from "./run.js";
+export { APP_SECTIONS_FILE, DEFAULT_SKILL_COMMAND, DEFAULT_SKILL_DIR, fillRulesTables, findTemplateRuleIds, getSkillValues, listTemplateFiles, readSkillTemplate, renderAppSections, renderBlogSkill, renderSkillTemplate, SKILL_MARKER, type RenderBlogSkillOptions, type SkillFile, type SkillValues, } from "./skill.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAChK,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,5 @@
+// `@softure-ai/blog/cli`: the `softure-blog` command for app scripts and container bundles.
+export { runBlogCommand } from "./command.js";
+export { BLOG_USAGE, EXIT_FAILED, EXIT_OK, EXIT_USAGE, parseBlogCommand, runBlogCli } from "./run.js";
+export { APP_SECTIONS_FILE, DEFAULT_SKILL_COMMAND, DEFAULT_SKILL_DIR, fillRulesTables, findTemplateRuleIds, getSkillValues, listTemplateFiles, readSkillTemplate, renderAppSections, renderBlogSkill, renderSkillTemplate, SKILL_MARKER, } from "./skill.js";
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,cAAc,EAA8B,MAAM,cAAc,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAA4D,MAAM,UAAU,CAAC;AAChK,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,YAAY,GAIb,MAAM,YAAY,CAAC"}

package/dist/cli/run.d.ts

@@ -0,0 +1,62 @@
+import { type Clock, type SoftureConfig } from "@softure-ai/core";
+import { type DatabaseHandle } from "@softure-ai/db";
+import { type PublishGate } from "../db/publish-run.js";
+import type { FetchLike } from "../quality/external-links.js";
+export interface CliOutput {
+    readonly log: (line: string) => void;
+    readonly error: (line: string) => void;
+}
+export interface RunBlogCliOptions {
+    /** The app's config with `blog()` among its modules. */
+    readonly config: SoftureConfig;
+    /** The arguments after the executable, e.g. `["publish", "content/blog", "--commit"]`. */
+    readonly argv: readonly string[];
+    /** Relative paths resolve against it. Default: `process.cwd()`. */
+    readonly cwd?: string;
+    readonly output?: CliOutput;
+    /** Opens the database connection. Default: `createDatabase(url, { max: 1 })`. */
+    readonly openDatabase?: (url: string) => Promise<DatabaseHandle>;
+    /** The gate for files going public. Default: the quality gate of `blog({ quality })`, none with `quality: false`. */
+    readonly gate?: PublishGate;
+    readonly clock?: Clock;
+    /** For `check --external`. Default: the global `fetch`. */
+    readonly fetch?: FetchLike;
+    /** For `check` reading the https sources of `brand.fonts`. Default: the global `fetch`. */
+    readonly fontFetch?: typeof fetch;
+    /** For the IndexNow submit after `publish`. Default: the global `fetch`. */
+    readonly indexNowFetch?: typeof fetch;
+    /** For the cache refresh request after `publish`. Default: the global `fetch`. */
+    readonly refreshFetch?: typeof fetch;
+    /** Where `publish` reads BLOG_REFRESH_SECRET. Default: `process.env`. */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+}
+export declare const EXIT_OK = 0;
+export declare const EXIT_FAILED = 1;
+export declare const EXIT_USAGE = 2;
+export declare const BLOG_USAGE = "Usage:\n  softure-blog publish [<path>...] [--commit] [--withdraw] [--no-indexnow] [--app-url <origin>]\n  softure-blog check [<path>...] [--external] [--today <YYYY-MM-DD>]\n  softure-blog skill install [--dir <path>] [--command <cmd>] [--check]\n\npublish   Brings the blog's tables to the state of the article files. A <path> is a file or a\n          folder (every *.md in it except README.md); without one, blog({ contentDir }).\n          Every file is checked before the first write, and one problem writes nothing.\n  --commit      write the changes; without it, a dry run that shows them and writes nothing\n  --withdraw    publish the one given file as withdrawn, whatever its status\n  --no-indexnow do not submit the changed addresses to IndexNow\n  --app-url     the running app's origin for the cache refresh; default: appOrigin\n          Files going public pass the quality gate first; an error writes nothing.\n          With BLOG_REFRESH_SECRET set, a commit that changed a text asks the running\n          app (refreshBlogCache) to refresh its blog cache, before the IndexNow submit.\n          With seo({ indexNow }) enabled, a commit submits the addresses whose answer\n          changed (the text, its old slug, its listing) to IndexNow; a dry run prints them.\n\ncheck     Runs the quality gate of blog({ quality }) over the files, without a database, and\n          prints every finding as file:line: severity [rule] message. Exits 1 on any error.\n  --external    also request every external link (2xx after redirects)\n  --today       the date to check freshness against; default: today in the app's time zone\n\nskill install\n          Writes the article writing skill, filled from blog({ quality, skill }),\n          into .claude/skills/blog-write. Overwrites only a skill it generated before.\n  --dir         the skill folder; default .claude/skills/blog-write\n  --command     how the skill runs this command; default \"npx softure-blog\"\n  --check       write nothing; exit 1 when the folder differs from what install would write\n\nOptions:\n  --config <file>    the app's softure.config file (bin only)\n  --help             show this help";
+export type BlogCommand = {
+    readonly kind: "help";
+} | {
+    readonly kind: "publish";
+    readonly paths: readonly string[];
+    readonly commit: boolean;
+    readonly withdraw: boolean;
+    readonly indexNow: boolean;
+    /** The origin `--app-url` gives; `null`: `appOrigin`. */
+    readonly appUrl: string | null;
+} | {
+    readonly kind: "check";
+    readonly paths: readonly string[];
+    readonly external: boolean;
+    readonly today: string | null;
+} | {
+    readonly kind: "skill-install";
+    readonly dir: string;
+    readonly command: string;
+    readonly check: boolean;
+};
+/** Runs the command and returns the process exit code: 0 done, 1 refused or failed, 2 usage error. */
+export declare function runBlogCli(options: RunBlogCliOptions): Promise<number>;
+/** The command the arguments name, or why they name none. Reads nothing. */
+export declare function parseBlogCommand(argv: readonly string[]): BlogCommand | string;
+//# sourceMappingURL=run.d.ts.map

package/dist/cli/run.d.ts.map

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