@lingjingai/scriptctl 0.25.10 → 0.26.0

package/dist/usecases/changelog.js

@@ -0,0 +1,147 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { CliError, EXIT_INPUT, EXIT_OK, EXIT_USAGE } from "../common.js";
+const VERSION_RE = /^\d+\.\d+\.\d+$/;
+const UNRELEASED = "unreleased";
+function repoRoot() {
+    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "..");
+}
+function changesDir() {
+    return path.join(repoRoot(), "changes");
+}
+function readPackageVersion() {
+    const pkgPath = path.join(repoRoot(), "package.json");
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+    return pkg.version ?? "0.0.0";
+}
+function versionParts(version) {
+    if (!VERSION_RE.test(version)) {
+        throw new CliError("CHANGELOG BLOCKED: version invalid", "Version must use x.y.z.", {
+            exitCode: EXIT_USAGE,
+            required: ["x.y.z"],
+            received: [version || "<empty>"],
+            nextSteps: ["Pass a released version such as `scriptctl changelog 0.25.10`."],
+            errorCode: "CHANGELOG_VERSION_INVALID",
+        });
+    }
+    const [major, minor, patch] = version.split(".").map((part) => Number(part));
+    return [major, minor, patch];
+}
+function compareVersions(a, b) {
+    const av = versionParts(a);
+    const bv = versionParts(b);
+    for (let i = 0; i < 3; i++) {
+        if (av[i] !== bv[i])
+            return av[i] - bv[i];
+    }
+    return 0;
+}
+function listReleasedVersions() {
+    const dir = changesDir();
+    return fs.readdirSync(dir)
+        .filter((name) => name.endsWith(".md"))
+        .map((name) => name.slice(0, -".md".length))
+        .filter((version) => VERSION_RE.test(version))
+        .sort(compareVersions);
+}
+function readChangeFile(version) {
+    return fs.readFileSync(path.join(changesDir(), `${version}.md`), "utf-8").trimEnd();
+}
+function missingVersion(version, available) {
+    return new CliError("CHANGELOG BLOCKED: version not found", `No changelog entry exists for ${version}.`, {
+        exitCode: EXIT_INPUT,
+        required: ["existing changelog version"],
+        received: [version],
+        nextSteps: [
+            available.length > 0
+                ? `Available versions: ${available.join(", ")}`
+                : "Add changes/<version>.md first.",
+        ],
+        errorCode: "CHANGELOG_VERSION_NOT_FOUND",
+    });
+}
+function emptyRange(from, to) {
+    return new CliError("CHANGELOG BLOCKED: range empty", `No released changelog entries found after ${from} through ${to}.`, {
+        exitCode: EXIT_INPUT,
+        required: ["a version range containing released changelog entries"],
+        received: [`--from ${from}`, `--to ${to}`],
+        nextSteps: ["Choose a wider range or run `scriptctl changelog <version>` for a known release."],
+        errorCode: "CHANGELOG_RANGE_EMPTY",
+    });
+}
+function bodyForVersions(versions) {
+    return versions.map(readChangeFile).join("\n\n");
+}
+export function commandChangelog(opts) {
+    const args = opts._args ?? [];
+    const versionArg = args[0]?.trim() ?? "";
+    const from = String(opts.from ?? "").trim();
+    const to = String(opts.to ?? "").trim();
+    const unreleased = Boolean(opts.unreleased);
+    if (args.length > 1) {
+        throw new CliError("CHANGELOG BLOCKED: too many arguments", "changelog accepts at most one version argument.", {
+            exitCode: EXIT_USAGE,
+            required: ["scriptctl changelog [version] [--from X] [--to Y] [--unreleased]"],
+            received: [args.join(" ")],
+            nextSteps: ["Pass a single version, or use --from/--to for a range."],
+            errorCode: "CHANGELOG_TOO_MANY_ARGS",
+        });
+    }
+    if (unreleased && (versionArg || from || to)) {
+        throw new CliError("CHANGELOG BLOCKED: option conflict", "--unreleased cannot combine with version, --from, or --to.", {
+            exitCode: EXIT_USAGE,
+            required: ["either --unreleased, a version, or a --from/--to range"],
+            received: ["--unreleased with another selector"],
+            nextSteps: ["Run `scriptctl changelog --unreleased` by itself."],
+            errorCode: "CHANGELOG_SELECTOR_CONFLICT",
+        });
+    }
+    if (versionArg && (from || to)) {
+        throw new CliError("CHANGELOG BLOCKED: option conflict", "A version argument cannot combine with --from or --to.", {
+            exitCode: EXIT_USAGE,
+            required: ["either a version argument, or --from/--to"],
+            received: [versionArg, from ? `--from ${from}` : "", to ? `--to ${to}` : ""].filter(Boolean),
+            nextSteps: ["Run `scriptctl changelog 0.25.10` or `scriptctl changelog --from 0.25.8 --to 0.25.10`."],
+            errorCode: "CHANGELOG_SELECTOR_CONFLICT",
+        });
+    }
+    if (unreleased) {
+        const body = readChangeFile(UNRELEASED);
+        return [{ title: "CHANGELOG", body, versions: [], unreleased: true }, EXIT_OK];
+    }
+    const available = listReleasedVersions();
+    const current = readPackageVersion();
+    if (versionArg) {
+        versionParts(versionArg);
+        if (!available.includes(versionArg))
+            throw missingVersion(versionArg, available);
+        const body = readChangeFile(versionArg);
+        return [{ title: "CHANGELOG", body, versions: [versionArg], unreleased: false }, EXIT_OK];
+    }
+    if (from || to) {
+        if (!from) {
+            throw new CliError("CHANGELOG BLOCKED: --from missing", "--from is required for range queries.", {
+                exitCode: EXIT_USAGE,
+                required: ["--from <x.y.z>"],
+                received: [to ? `--to ${to}` : "<missing>"],
+                nextSteps: ["Run `scriptctl changelog --from 0.25.8 --to 0.25.10`."],
+                errorCode: "CHANGELOG_FROM_MISSING",
+            });
+        }
+        versionParts(from);
+        const upper = to || current;
+        versionParts(upper);
+        if (!available.includes(upper))
+            throw missingVersion(upper, available);
+        const versions = available.filter((version) => compareVersions(version, from) > 0 && compareVersions(version, upper) <= 0);
+        if (versions.length === 0)
+            throw emptyRange(from, upper);
+        return [{ title: "CHANGELOG", body: bodyForVersions(versions), versions, from, to: upper, unreleased: false }, EXIT_OK];
+    }
+    if (!available.includes(current))
+        throw missingVersion(current, available);
+    const body = readChangeFile(current);
+    return [{ title: "CHANGELOG", body, versions: [current], unreleased: false }, EXIT_OK];
+}
+//# sourceMappingURL=changelog.js.map

package/dist/usecases/changelog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changelog.js","sourceRoot":"","sources":["../../src/usecases/changelog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,EAAe,MAAM,cAAc,CAAC;AAatF,MAAM,UAAU,GAAG,iBAAiB,CAAC;AACrC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,SAAS,QAAQ;IACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,kBAAkB;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,cAAc,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAgB,CAAC;IACzE,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;AAChC,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAAC,oCAAoC,EAAE,yBAAyB,EAAE;YAClF,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,OAAO,CAAC;YACnB,QAAQ,EAAE,CAAC,OAAO,IAAI,SAAS,CAAC;YAChC,SAAS,EAAE,CAAC,gEAAgE,CAAC;YAC7E,SAAS,EAAE,2BAA2B;SACvC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAA6B,CAAC;IACzG,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,eAAe,CAAC,CAAS,EAAE,CAAS;IAC3C,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC,CAAC,CAAE,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,oBAAoB;IAC3B,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC;SACvB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;SAC3C,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;SAC7C,IAAI,CAAC,eAAe,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;AACtF,CAAC;AAED,SAAS,cAAc,CAAC,OAAe,EAAE,SAAmB;IAC1D,OAAO,IAAI,QAAQ,CAAC,sCAAsC,EAAE,iCAAiC,OAAO,GAAG,EAAE;QACvG,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,CAAC,4BAA4B,CAAC;QACxC,QAAQ,EAAE,CAAC,OAAO,CAAC;QACnB,SAAS,EAAE;YACT,SAAS,CAAC,MAAM,GAAG,CAAC;gBAClB,CAAC,CAAC,uBAAuB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAC/C,CAAC,CAAC,iCAAiC;SACtC;QACD,SAAS,EAAE,6BAA6B;KACzC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,EAAU;IAC1C,OAAO,IAAI,QAAQ,CAAC,gCAAgC,EAAE,6CAA6C,IAAI,YAAY,EAAE,GAAG,EAAE;QACxH,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,CAAC,uDAAuD,CAAC;QACnE,QAAQ,EAAE,CAAC,UAAU,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC;QAC1C,SAAS,EAAE,CAAC,kFAAkF,CAAC;QAC/F,SAAS,EAAE,uBAAuB;KACnC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,QAAkB;IACzC,OAAO,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAsB;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAE5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,QAAQ,CAAC,uCAAuC,EAAE,iDAAiD,EAAE;YAC7G,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,kEAAkE,CAAC;YAC9E,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,SAAS,EAAE,CAAC,wDAAwD,CAAC;YACrE,SAAS,EAAE,yBAAyB;SACrC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,QAAQ,CAAC,oCAAoC,EAAE,4DAA4D,EAAE;YACrH,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,wDAAwD,CAAC;YACpE,QAAQ,EAAE,CAAC,oCAAoC,CAAC;YAChD,SAAS,EAAE,CAAC,mDAAmD,CAAC;YAChE,SAAS,EAAE,6BAA6B;SACzC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,QAAQ,CAAC,oCAAoC,EAAE,wDAAwD,EAAE;YACjH,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,CAAC,2CAA2C,CAAC;YACvD,QAAQ,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;YAC5F,SAAS,EAAE,CAAC,wFAAwF,CAAC;YACrG,SAAS,EAAE,6BAA6B;SACzC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;IAErC,IAAI,UAAU,EAAE,CAAC;QACf,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC;YAAE,MAAM,cAAc,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACjF,MAAM,IAAI,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;QACxC,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5F,CAAC;IAED,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,QAAQ,CAAC,mCAAmC,EAAE,uCAAuC,EAAE;gBAC/F,QAAQ,EAAE,UAAU;gBACpB,QAAQ,EAAE,CAAC,gBAAgB,CAAC;gBAC5B,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;gBAC3C,SAAS,EAAE,CAAC,uDAAuD,CAAC;gBACpE,SAAS,EAAE,wBAAwB;aACpC,CAAC,CAAC;QACL,CAAC;QACD,YAAY,CAAC,IAAI,CAAC,CAAC;QACnB,MAAM,KAAK,GAAG,EAAE,IAAI,OAAO,CAAC;QAC5B,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,MAAM,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3H,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzD,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1H,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,MAAM,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;AACzF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingjingai/scriptctl",
-  "version": "0.25.10",
+  "version": "0.26.0",
   "description": "剧本阶段统一 CLI：直转外部素材到 script.json，以及当前最终剧本的读取、校验、原子编辑与批量 patch 精修。",
   "type": "module",
   "bin": {
@@ -10,6 +10,7 @@
   "types": "./dist/cli.d.ts",
   "files": [
     "dist",
+    "changes",
     "README.md"
   ],
   "engines": {