@shirlytaylor73/smart-search 0.2.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 GuDaStudio
+
+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,188 @@
+# Smart Search
+
+`smart-search` is a CLI-first web and technical-document retrieval tool for AI agents and terminal users. Agents choose task operations; provider selection, credentials, feature matching, timeouts, and fallback remain configuration concerns.
+
+## Install and setup
+
+`smart-search` is implemented in Python. The npm package is an npm wrapper
+that creates an isolated Python runtime and installs the bundled Python CLI.
+
+During the 0.2.0 preview, install the fork-owned package from npm dist-tag
+`next`:
+
+```bash
+npm install -g @shirlytaylor73/smart-search@next
+smart-search setup
+smart-search doctor --format json
+```
+
+After `v0.2.0` is published, stable installations can use
+`@shirlytaylor73/smart-search@latest`.
+
+Python source installation:
+
+```bash
+uv tool install --editable .
+# or
+pip install -e .
+smart-search --version
+```
+
+## Four query capabilities
+
+### search
+
+```bash
+smart-search search answer "latest AI policy updates" --format json
+smart-search search sources "agentic search papers" --limit 5 --mode semantic --include-highlights --format json
+smart-search search similar https://example.com/article --limit 5 --format json
+```
+
+`search sources` supports provider-independent limit, semantic/keyword/auto mode, publication date, include/exclude domains, category, text, and highlights. Providers that do not support required features are excluded automatically.
+
+### docs
+
+```bash
+smart-search docs resolve react hooks --format json
+smart-search docs search "useEffect cleanup" --format json
+smart-search docs search "recent important PRs" --source owner/repo --format json
+smart-search docs tree owner/repo --path src --ref main --format json
+smart-search docs read owner/repo README.md --ref main --format content
+```
+
+### fetch
+
+```bash
+smart-search fetch content https://example.com/article --format content
+smart-search fetch extract https://example.com/product --schema '{"type":"object"}' --format json
+```
+
+- `fetch content` returns readable text or Markdown.
+- `fetch extract` returns structured `data` and optional `raw_evidence`; it never substitutes ordinary Markdown for structured output.
+
+### map
+
+```bash
+smart-search map site https://docs.example.com \
+  --instructions "find authentication and rate-limit pages" \
+  --max-depth 1 \
+  --max-breadth 20 \
+  --limit 50 \
+  --timeout 150 \
+  --format json
+```
+
+`map site` discovers URLs, paths, and link structure within a site. It is not page extraction or repository structure; use `fetch content` and `docs tree` for those tasks.
+
+## Operation/provider mapping
+
+| Operation | Internal candidates |
+|---|---|
+| `search.answer` | xAI Responses, OpenAI-compatible |
+| `search.sources` | Exa, Zhipu Web Search, Zhipu MCP, Tavily, Firecrawl |
+| `search.similar` | Exa |
+| `docs.resolve` | Context7 |
+| `docs.search` | Context7, Exa, Zhipu MCP zread |
+| `docs.tree` | Zhipu MCP zread |
+| `docs.read` | Zhipu MCP zread |
+| `fetch.content` | Tavily, Jina, Zhipu MCP Reader, Firecrawl |
+| `fetch.extract` | Firecrawl structured extraction |
+| `map.site` | Tavily |
+
+Fallback stays within the same operation. `docs.tree` never falls back to Context7, and `fetch.extract` never falls back to readable Markdown.
+
+Maintainers can configure per-operation ordering, disabled providers, timeout, and fallback through the JSON object in `SMART_SEARCH_OPERATION_CONFIG`. Agents do not manage this setting.
+
+## Configuration and diagnostics
+
+```bash
+smart-search setup
+smart-search config path
+smart-search config list
+smart-search config set KEY VALUE
+smart-search config unset KEY
+smart-search doctor --format markdown
+
+smart-search diagnose search sources
+smart-search diagnose docs tree
+smart-search diagnose fetch extract
+smart-search diagnose map site
+smart-search diagnose provider openai-compatible
+smart-search diagnose route "React API docs"
+smart-search diagnose route-calibrate
+smart-search diagnose smoke --mode mock
+```
+
+Common credentials include `XAI_API_KEY`, `OPENAI_COMPATIBLE_API_URL`, `OPENAI_COMPATIBLE_API_KEY`, `EXA_API_KEY`, `CONTEXT7_API_KEY`, `ZHIPU_API_KEY`, `ZHIPU_MCP_API_KEY`, `JINA_API_KEY`, `TAVILY_API_KEY`, and `FIRECRAWL_API_KEY`. `config list` masks secrets.
+
+## Output and exit codes
+
+Query operations support:
+
+```bash
+--format json|markdown|content
+--output PATH
+--debug
+```
+
+The public JSON envelope contains `ok`, `capability`, `operation`, `content`, `sources`, and `elapsed_ms`. Exit codes: `0` success, `2` parameter error, `3` configuration error, `4` network/capability error, and `5` runtime error.
+
+## Migration
+
+### npm package ownership
+
+This repository publishes `@shirlytaylor73/smart-search`. The upstream
+`@konbakuyomu/smart-search` package is a separate package and does not
+receive updates from this fork. Both packages expose the same
+`smart-search` executable, so uninstall the upstream package first:
+
+```bash
+npm uninstall -g @konbakuyomu/smart-search
+npm install -g @shirlytaylor73/smart-search@next
+smart-search -v
+smart-search diagnose smoke --mode mock
+```
+
+The configuration directory does not change, so existing credentials and
+`SMART_SEARCH_OPERATION_CONFIG` values remain available.
+
+### CLI contract
+
+Legacy provider commands are hidden during the compatibility window and map to operations, for example `exa-search` → `search sources`, `exa-similar` → `search similar`, `context7-library` → `docs resolve`, legacy `fetch` → `fetch content`, and legacy `map` → `map site`.
+
+The experimental vertical provider and Deep Research CLI were removed. The calling agent owns research decomposition, evidence comparison, and final writing; paper and vertical retrieval will be extended separately through paper-search.
+
+## Development
+
+```bash
+smart-search dev regression
+python -m compileall -q src tests
+python -m pytest tests -q
+npm test
+```
+
+## Release lanes
+
+Beta releases are started manually through `workflow_dispatch` with an
+explicit `target_ref`, version such as `0.2.0-beta.1`, and npm dist-tag
+`next`. Stable releases use a matching tag such as `v0.2.0` and publish
+to npm dist-tag `latest`. GitHub Actions reads the repository secret
+`NPM_TOKEN` and publishes with provenance.
+
+npm versions are immutable and cannot be renamed in place. Failed beta builds
+must be superseded by a new `0.2.0-beta.N` version.
+
+Release closeout checklist:
+
+1. Compare npm versions/dist-tags and GitHub releases before publishing.
+2. If Actions cannot create a prerelease, publish with
+   `create_github_release=false`, then run
+   `gh release create vX.Y.Z-beta.N --target <commit> --prerelease --latest=false`.
+3. Treat npm `E409` during parallel backfills as a registry concurrency
+   failure and retry serially after checking whether the version exists.
+4. Run a machine-readable gap check between expected npm beta versions and
+   GitHub prereleases.
+5. Install the selected build with
+   `mise use -g "npm:@shirlytaylor73/smart-search@0.2.0-beta.1" -y --pin`,
+   then verify version, regression, smoke, and a non-ASCII JSON pipe through
+   PowerShell `ConvertFrom-Json`.

package/README.zh-CN.md

@@ -0,0 +1,180 @@
+# Smart Search
+
+`smart-search` 是面向 AI Agent 和命令行用户的 CLI-first 网络与技术文档检索工具。Agent 只选择任务 operation；provider、凭据、优先级、feature 匹配、超时和 fallback 由配置与内部服务层管理。
+
+## 安装与初始化
+
+`smart-search` 的实际实现是 Python CLI。npm 包只是 npm 包装器：它会创建
+隔离的 Python runtime，并安装随 npm 包发布的 Python 源码。
+
+0.2.0 预览阶段从 npm `next` 安装当前 fork：
+
+```bash
+npm install -g @shirlytaylor73/smart-search@next
+smart-search setup
+smart-search doctor --format json
+```
+
+`v0.2.0` 发布后，稳定版使用
+`@shirlytaylor73/smart-search@latest`。
+
+也可以直接从源码安装 Python 包：
+
+```bash
+uv tool install --editable .
+# 或
+pip install -e .
+smart-search --version
+```
+
+## 四大查询能力
+
+### search：网络回答与来源发现
+
+```bash
+smart-search search answer "今天有哪些 AI 政策更新" --format json
+smart-search search sources "agentic search papers" --limit 5 --mode semantic --include-highlights --format json
+smart-search search similar https://example.com/article --limit 5 --format json
+```
+
+`search sources` 支持 provider 无关的 `--limit`、`--mode semantic|keyword|auto`、`--start-published-date`、`--include-domains`、`--exclude-domains`、`--category`、`--include-text`、`--include-highlights`。不支持必需 feature 的 provider 会被自动排除。
+
+### docs：技术文档与代码仓库
+
+```bash
+smart-search docs resolve react hooks --format json
+smart-search docs search "useEffect cleanup" --format json
+smart-search docs search "最近的重要 PR" --source owner/repo --format json
+smart-search docs tree owner/repo --path src --ref main --format json
+smart-search docs read owner/repo README.md --ref main --format content
+```
+
+### fetch：已知 URL 内容
+
+```bash
+smart-search fetch content https://example.com/article --format content
+smart-search fetch extract https://example.com/product --schema '{"type":"object"}' --format json
+```
+
+- `fetch content` 返回适合阅读、总结和引用的正文或 Markdown。
+- `fetch extract` 返回结构化 `data` 和可选 `raw_evidence`，不会用普通 Markdown 冒充结构化结果。
+
+### map：站点结构探索
+
+```bash
+smart-search map site https://docs.example.com \
+  --instructions "查找认证和限流页面" \
+  --max-depth 1 \
+  --max-breadth 20 \
+  --limit 50 \
+  --timeout 150 \
+  --format json
+```
+
+`map site` 发现站内 URL、路径和链接结构。它不是单页内容提取，也不是代码仓库目录读取；后两者分别使用 `fetch content` 和 `docs tree`。
+
+## Operation 与 Provider
+
+| Operation | 内部候选 |
+|---|---|
+| `search.answer` | xAI Responses、OpenAI-compatible |
+| `search.sources` | Exa、智谱 Web Search、智谱 MCP、Tavily、Firecrawl |
+| `search.similar` | Exa |
+| `docs.resolve` | Context7 |
+| `docs.search` | Context7、Exa、智谱 MCP zread |
+| `docs.tree` | 智谱 MCP zread |
+| `docs.read` | 智谱 MCP zread |
+| `fetch.content` | Tavily、Jina、智谱 MCP Reader、Firecrawl |
+| `fetch.extract` | Firecrawl 结构化抽取 |
+| `map.site` | Tavily |
+
+Fallback 只在同一个 operation 内发生。例如 `docs.tree` 不会 fallback 到 Context7，`fetch.extract` 不会 fallback 到普通正文。
+
+可用 `SMART_SEARCH_OPERATION_CONFIG` 配置 operation 顺序、禁用项、超时和 fallback，值为 JSON object；普通 Agent 无需读取或修改它。
+
+## 配置与排查
+
+```bash
+smart-search setup
+smart-search config path
+smart-search config list
+smart-search config set KEY VALUE
+smart-search config unset KEY
+smart-search doctor --format markdown
+
+smart-search diagnose search sources
+smart-search diagnose docs tree
+smart-search diagnose fetch extract
+smart-search diagnose map site
+smart-search diagnose provider openai-compatible
+smart-search diagnose route "React API docs"
+smart-search diagnose route-calibrate
+smart-search diagnose smoke --mode mock
+```
+
+主要凭据包括 `XAI_API_KEY`、`OPENAI_COMPATIBLE_API_URL`、`OPENAI_COMPATIBLE_API_KEY`、`EXA_API_KEY`、`CONTEXT7_API_KEY`、`ZHIPU_API_KEY`、`ZHIPU_MCP_API_KEY`、`JINA_API_KEY`、`TAVILY_API_KEY`、`FIRECRAWL_API_KEY`。`config list` 默认脱敏。
+
+## 输出与退出码
+
+所有查询 operation 支持：
+
+```bash
+--format json|markdown|content
+--output PATH
+--debug
+```
+
+公共 JSON 包含 `ok`、`capability`、`operation`、`content`、`sources`、`elapsed_ms`。退出码：`0` 成功、`2` 参数错误、`3` 配置错误、`4` 网络/能力错误、`5` 运行时错误。
+
+## 迁移
+
+### npm 包归属
+
+当前仓库发布 `@shirlytaylor73/smart-search`。上游
+`@konbakuyomu/smart-search` 是另一个独立 npm 包，不会收到当前 fork 的
+更新。两个包都会安装同名 `smart-search` 命令，因此必须先卸载旧包：
+
+```bash
+npm uninstall -g @konbakuyomu/smart-search
+npm install -g @shirlytaylor73/smart-search@next
+smart-search -v
+smart-search diagnose smoke --mode mock
+```
+
+配置目录不会变化，现有 API key 和 `SMART_SEARCH_OPERATION_CONFIG` 无需迁移。
+
+### CLI 契约
+
+旧 provider 命令在兼容期内隐藏并映射到新 operation，例如 `exa-search` → `search sources`、`exa-similar` → `search similar`、`context7-library` → `docs resolve`、旧 `fetch` → `fetch content`、旧 `map` → `map site`。
+
+实验性垂直 provider 与 Deep Research CLI 已移除。研究分解、证据对比和最终写作由上层 Agent 负责；论文与垂直检索后续通过独立 paper-search 扩展。
+
+## 开发验证
+
+```bash
+smart-search dev regression
+python -m compileall -q src tests
+python -m pytest tests -q
+npm test
+```
+
+## 发布通道
+
+beta 通过 `workflow_dispatch` 手动发布，需要指定 `target_ref`、类似
+`0.2.0-beta.1` 的准确版本和 npm `next`。稳定版通过类似 `v0.2.0`
+的 Git tag 发布到 npm `latest`。GitHub Actions 使用仓库 Secret
+`NPM_TOKEN` 完成 npm 认证，并保留 provenance。
+
+npm 版本不可变，已发布版本不能原地改名，只能用新的 beta 版本替代。
+
+发布收尾检查：
+
+1. 先运行 `npm view @shirlytaylor73/smart-search` 并通过
+   `gh release list --repo ShirlyTaylor73/smartsearch --limit 100` 核对现状。
+2. 遇到 npm `E409` 时，先确认版本是否已经存在，再串行重试。
+3. 兼容窗口内可运行旧入口 `smart-search regression` 和
+   `smart-search smoke --mock --format json` 验证迁移提示；新版入口分别是
+   `smart-search dev regression` 和
+   `smart-search diagnose smoke --mode mock --format json`。
+4. Windows 包装层额外执行非 ASCII JSON 管道，并用
+   PowerShell `ConvertFrom-Json` 验证输出。

package/npm/bin/smart-search.js

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+
+const { spawn, spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const packageRoot = path.resolve(__dirname, "..", "..");
+const callerCwd = process.env.INIT_CWD || process.cwd();
+const venvDir = path.join(packageRoot, ".smart-search-python");
+const pythonPath =
+  process.platform === "win32"
+    ? path.join(venvDir, "Scripts", "python.exe")
+    : path.join(venvDir, "bin", "python");
+
+function printReinstallHint() {
+  console.error("Repair it by reinstalling the package:");
+  console.error("  npm install -g @shirlytaylor73/smart-search");
+}
+
+if (!fs.existsSync(pythonPath)) {
+  const postinstall = path.join(packageRoot, "npm", "scripts", "postinstall.js");
+  console.error("smart-search Python runtime is missing; attempting repair...");
+  const repaired = spawnSync(process.execPath, [postinstall], {
+    cwd: packageRoot,
+    stdio: "inherit",
+    windowsHide: true
+  });
+  if (repaired.error) {
+    console.error(`smart-search runtime repair failed: ${repaired.error.message}`);
+    printReinstallHint();
+    process.exit(5);
+  }
+  if (repaired.status !== 0 || !fs.existsSync(pythonPath)) {
+    console.error("smart-search npm wrapper could not find its Python runtime.");
+    console.error(`Expected: ${pythonPath}`);
+    printReinstallHint();
+    process.exit(repaired.status || 5);
+  }
+}
+
+const child = spawn(
+  pythonPath,
+  ["-m", "smart_search.cli", ...process.argv.slice(2)],
+  {
+    cwd: callerCwd,
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      SMART_SEARCH_PACKAGE_ROOT: packageRoot,
+      PYTHONIOENCODING: process.env.PYTHONIOENCODING || "utf-8",
+      PYTHONUTF8: process.env.PYTHONUTF8 || "1"
+    },
+    windowsHide: true
+  }
+);
+
+child.on("error", (error) => {
+  console.error(`Failed to start smart-search: ${error.message}`);
+  process.exit(5);
+});
+
+child.on("close", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code ?? 5);
+});

package/npm/scripts/postinstall.js

@@ -0,0 +1,87 @@
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const packageRoot = path.resolve(__dirname, "..", "..");
+const venvDir = path.join(packageRoot, ".smart-search-python");
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    cwd: packageRoot,
+    stdio: options.stdio || "inherit",
+    encoding: "utf8",
+    windowsHide: true
+  });
+
+  if (result.error) {
+    return { ok: false, error: result.error };
+  }
+  return { ok: result.status === 0, status: result.status, stdout: result.stdout || "" };
+}
+
+function pythonCandidates() {
+  if (process.platform === "win32") {
+    return [
+      { command: "py", args: ["-3"] },
+      { command: "python", args: [] },
+      { command: "python3", args: [] }
+    ];
+  }
+  return [
+    { command: "python3", args: [] },
+    { command: "python", args: [] }
+  ];
+}
+
+function findPython() {
+  const probe = [
+    "-c",
+    "import sys; raise SystemExit(0 if sys.version_info >= (3, 10) else 1)"
+  ];
+
+  for (const candidate of pythonCandidates()) {
+    const result = run(candidate.command, [...candidate.args, ...probe], { stdio: "pipe" });
+    if (result.ok) {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+function venvPython() {
+  return process.platform === "win32"
+    ? path.join(venvDir, "Scripts", "python.exe")
+    : path.join(venvDir, "bin", "python");
+}
+
+const python = findPython();
+if (!python) {
+  console.error("smart-search requires Python 3.10 or newer.");
+  console.error("Install Python, then run: npm install -g @shirlytaylor73/smart-search@latest");
+  process.exit(1);
+}
+
+if (!fs.existsSync(venvPython())) {
+  console.log("Creating smart-search Python runtime...");
+  const created = run(python.command, [...python.args, "-m", "venv", venvDir]);
+  if (!created.ok) {
+    console.error("Failed to create the smart-search Python virtual environment.");
+    process.exit(created.status || 1);
+  }
+}
+
+const py = venvPython();
+
+console.log("Installing smart-search Python package...");
+const install = run(py, [
+  "-m",
+  "pip",
+  "install",
+  "--disable-pip-version-check",
+  packageRoot
+]);
+
+if (!install.ok) {
+  console.error("Failed to install the bundled smart-search Python package.");
+  process.exit(install.status || 1);
+}

package/npm/scripts/resolve-prerelease-version.js

@@ -0,0 +1,108 @@
+const { execFileSync } = require("node:child_process");
+
+function parseArgs(argv) {
+  const args = {
+    prereleaseId: "beta",
+    versionsJson: ""
+  };
+  for (let index = 0; index < argv.length; index += 1) {
+    const arg = argv[index];
+    const next = argv[index + 1];
+    if (arg === "--package") {
+      args.packageName = next;
+      index += 1;
+    } else if (arg === "--base") {
+      args.baseVersion = next;
+      index += 1;
+    } else if (arg === "--id") {
+      args.prereleaseId = next;
+      index += 1;
+    } else if (arg === "--versions-json") {
+      args.versionsJson = next;
+      index += 1;
+    } else if (arg === "--help" || arg === "-h") {
+      printUsage(0);
+    } else {
+      console.error(`Unknown argument: ${arg}`);
+      printUsage(1);
+    }
+  }
+  return args;
+}
+
+function printUsage(exitCode) {
+  console.error(
+    [
+      "Usage: node npm/scripts/resolve-prerelease-version.js --package <name> --base <version> [--id beta]",
+      "",
+      "Options:",
+      "  --versions-json JSON   Use an explicit version list instead of querying npm."
+    ].join("\n")
+  );
+  process.exit(exitCode);
+}
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function readPublishedVersions(packageName, versionsJson) {
+  if (versionsJson) {
+    return JSON.parse(versionsJson);
+  }
+  try {
+    const output = execFileSync("npm", ["view", packageName, "versions", "--json"], {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    return JSON.parse(output);
+  } catch (error) {
+    const stderr = String(error.stderr || "");
+    if (stderr.includes("E404") || stderr.includes("404 Not Found")) {
+      return [];
+    }
+    throw error;
+  }
+}
+
+function resolvePrereleaseVersion(versions, baseVersion, prereleaseId) {
+  const normalizedVersions = Array.isArray(versions) ? versions.filter((version) => typeof version === "string") : [];
+  const escapedBase = escapeRegExp(baseVersion);
+  const escapedId = escapeRegExp(prereleaseId);
+  const prereleasePattern = new RegExp(`^${escapedBase}-${escapedId}\\.(\\d+)$`);
+  const legacyDevPattern = new RegExp(`^${escapedBase}-dev\\..+$`);
+  const existingPrereleaseNumbers = [];
+  let legacyDevCount = 0;
+
+  for (const version of normalizedVersions) {
+    const prereleaseMatch = prereleasePattern.exec(version);
+    if (prereleaseMatch) {
+      existingPrereleaseNumbers.push(Number(prereleaseMatch[1]));
+      continue;
+    }
+    if (legacyDevPattern.test(version)) {
+      legacyDevCount += 1;
+    }
+  }
+
+  const maxExistingPrerelease = existingPrereleaseNumbers.length > 0 ? Math.max(...existingPrereleaseNumbers) : 0;
+  const nextNumber = Math.max(maxExistingPrerelease, legacyDevCount) + 1;
+  return `${baseVersion}-${prereleaseId}.${nextNumber}`;
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  if (!args.packageName || !args.baseVersion) {
+    printUsage(1);
+  }
+  const versions = readPublishedVersions(args.packageName, args.versionsJson);
+  process.stdout.write(resolvePrereleaseVersion(versions, args.baseVersion, args.prereleaseId));
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = {
+  resolvePrereleaseVersion
+};

package/npm/scripts/set-package-version.js

@@ -0,0 +1,35 @@
+const fs = require("node:fs");
+const path = require("node:path");
+
+const version = process.argv[2];
+if (!version) {
+  console.error("Usage: node npm/scripts/set-package-version.js <version>");
+  process.exit(1);
+}
+
+const packageRoot = path.resolve(__dirname, "..", "..");
+const packageJsonPath = path.join(packageRoot, "package.json");
+const packageLockPath = path.join(packageRoot, "package-lock.json");
+const pyprojectPath = path.join(packageRoot, "pyproject.toml");
+
+function writeJsonVersion(filePath) {
+  const data = JSON.parse(fs.readFileSync(filePath, "utf8"));
+  data.version = version;
+  if (data.packages && data.packages[""]) {
+    data.packages[""].version = version;
+  }
+  fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`);
+}
+
+writeJsonVersion(packageJsonPath);
+writeJsonVersion(packageLockPath);
+
+const pyproject = fs.readFileSync(pyprojectPath, "utf8");
+const versionPattern = /^version = ".*"$/m;
+if (!versionPattern.test(pyproject)) {
+  console.error("Could not find the project.version field in pyproject.toml.");
+  process.exit(1);
+}
+
+fs.writeFileSync(pyprojectPath, pyproject.replace(versionPattern, `version = "${version}"`));
+console.log(`Set package version to ${version}.`);