opencode-telegram-bridge 1.0.7 → 1.1.0

package/README.md

@@ -22,30 +22,6 @@ You still need OpenCode running separately:
 opencode serve
 ```
 
-## Develop (for contributors)
-1. Install dependencies:
-
-```bash
-npm install
-```
-
-2. Create `.env` from the example:
-
-```bash
-cp .env.example .env
-```
-
-3. Start OpenCode server in another terminal:
-
-```bash
-opencode serve
-```
-
-4. Run the bot:
-
-```bash
-npm run dev
-```
-
-## Releases
-This project uses Changesets. See `docs/release.md`.
+## Documentation
+See the docs for configuration, usage, and systemd setup:
+https://gabriel-trigo.github.io/opencode-telegram-bridge/

package/bin/opencode-telegram-bridge.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import "../dist/index.js"
+import "../dist/cli.js"

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,159 @@
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import readline from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { runBot } from "./run.js";
+const die = (message) => {
+    console.error(message);
+    process.exit(1);
+};
+const runCommand = (command, args) => {
+    const result = spawnSync(command, args, {
+        encoding: "utf8",
+        stdio: "inherit",
+    });
+    if (result.status !== 0) {
+        throw new Error(`Command failed: ${command} ${args.join(" ")}`);
+    }
+};
+const resolveExecStart = () => {
+    const result = spawnSync("sh", ["-c", "command -v opencode-telegram-bridge"], {
+        encoding: "utf8",
+    });
+    const execStart = result.stdout.trim();
+    if (!execStart || result.status !== 0) {
+        throw new Error("opencode-telegram-bridge not found in PATH");
+    }
+    return execStart;
+};
+const readAnswer = async (prompt, options = {}) => {
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    const suffix = options.defaultValue ? ` (${options.defaultValue})` : "";
+    const answer = (await rl.question(`${prompt}${suffix}: `)).trim();
+    rl.close();
+    if (!answer && options.defaultValue) {
+        return options.defaultValue;
+    }
+    if (!answer && options.required) {
+        throw new Error(`Missing ${prompt}`);
+    }
+    return answer;
+};
+const confirmAnswer = async (prompt, defaultValue = false) => {
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    const suffix = defaultValue ? "(Y/n)" : "(y/N)";
+    const answer = (await rl.question(`${prompt} ${suffix}: `)).trim();
+    rl.close();
+    if (!answer) {
+        return defaultValue;
+    }
+    return answer.toLowerCase().startsWith("y");
+};
+const writeEnvFile = (envPath, values) => {
+    const lines = Object.entries(values).map(([key, value]) => `${key}=${value}`);
+    fs.mkdirSync(path.dirname(envPath), { recursive: true });
+    fs.writeFileSync(envPath, `${lines.join("\n")}\n`, "utf8");
+};
+const writeUnitFile = (unitPath, content) => {
+    fs.mkdirSync(path.dirname(unitPath), { recursive: true });
+    fs.writeFileSync(unitPath, content, "utf8");
+};
+const buildUnitFile = (envPath, execStart) => `
+[Unit]
+Description=OpenCode Telegram Bridge
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+EnvironmentFile=${envPath}
+ExecStart=${execStart}
+Restart=on-failure
+RestartSec=3
+
+[Install]
+WantedBy=default.target
+`;
+const runSetupWizard = async () => {
+    if (process.platform !== "linux") {
+        die("Setup currently supports Linux systemd only. See the docs for manual setup.");
+    }
+    const systemctlCheck = spawnSync("systemctl", ["--user", "--version"], {
+        encoding: "utf8",
+    });
+    if (systemctlCheck.status !== 0) {
+        die("systemctl --user is not available. Install systemd or use manual setup.");
+    }
+    const homeDir = os.homedir();
+    const envPath = path.join(homeDir, ".config", "opencode-telegram-bridge", "opencode-telegram-bridge.env");
+    const unitPath = path.join(homeDir, ".config", "systemd", "user", "opencode-telegram-bridge.service");
+    if (fs.existsSync(envPath) || fs.existsSync(unitPath)) {
+        const overwrite = await confirmAnswer("Existing config found. Overwrite?", false);
+        if (!overwrite) {
+            die("Setup cancelled.");
+        }
+    }
+    const botToken = await readAnswer("TELEGRAM_BOT_TOKEN", { required: true });
+    const allowedUserId = await readAnswer("TELEGRAM_ALLOWED_USER_ID", {
+        required: true,
+    });
+    if (!Number.isInteger(Number(allowedUserId))) {
+        throw new Error("TELEGRAM_ALLOWED_USER_ID must be an integer");
+    }
+    const serverUrl = await readAnswer("OPENCODE_SERVER_URL", {
+        defaultValue: "http://127.0.0.1:4096",
+    });
+    const serverUsername = await readAnswer("OPENCODE_SERVER_USERNAME", {
+        defaultValue: "opencode",
+    });
+    const serverPassword = await readAnswer("OPENCODE_SERVER_PASSWORD", {});
+    const opencodeRestartCommand = await readAnswer("OPENCODE_RESTART_COMMAND", {});
+    const opencodeRestartTimeoutMs = opencodeRestartCommand ? "30000" : "";
+    const execStart = resolveExecStart();
+    writeEnvFile(envPath, {
+        TELEGRAM_BOT_TOKEN: botToken,
+        TELEGRAM_ALLOWED_USER_ID: allowedUserId,
+        OPENCODE_SERVER_URL: serverUrl,
+        OPENCODE_SERVER_USERNAME: serverUsername,
+        OPENCODE_SERVER_PASSWORD: serverPassword,
+        OPENCODE_PROMPT_TIMEOUT_MS: "600000",
+        TELEGRAM_HANDLER_TIMEOUT_MS: "630000",
+        OPENCODE_RESTART_COMMAND: opencodeRestartCommand,
+        OPENCODE_RESTART_TIMEOUT_MS: opencodeRestartTimeoutMs,
+        OPENCODE_BRIDGE_RESTART_COMMAND: "systemctl --user restart opencode-telegram-bridge --no-block",
+        OPENCODE_BRIDGE_RESTART_TIMEOUT_MS: "30000",
+    });
+    const unitFile = buildUnitFile(envPath, execStart);
+    writeUnitFile(unitPath, unitFile);
+    runCommand("systemctl", ["--user", "daemon-reload"]);
+    runCommand("systemctl", ["--user", "enable", "--now", "opencode-telegram-bridge"]);
+    const enableLinger = await confirmAnswer("Enable linger so the service starts on boot without login?", false);
+    if (enableLinger) {
+        const user = os.userInfo().username;
+        const result = spawnSync("sudo", ["loginctl", "enable-linger", user], {
+            encoding: "utf8",
+            stdio: "inherit",
+        });
+        if (result.status !== 0) {
+            console.warn("Failed to enable linger. Run: sudo loginctl enable-linger");
+        }
+    }
+    console.log("Setup complete. Service is running.");
+    console.log(`Env file: ${envPath}`);
+    console.log(`Unit file: ${unitPath}`);
+};
+const command = process.argv[2];
+if (!command) {
+    runBot();
+}
+else if (command === "setup") {
+    runSetupWizard().catch((error) => {
+        die(error instanceof Error ? error.message : "Setup failed.");
+    });
+}
+else {
+    die("Unknown command. Use: opencode-telegram-bridge [setup]");
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import "dotenv/config";
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -1,16 +1,3 @@
-import "dotenv/config";
-import { loadConfig } from "./config.js";
-import { startBot } from "./bot.js";
-import { createOpencodeBridge } from "./opencode.js";
-import { createProjectStore } from "./projects.js";
-import { createChatModelStore, createChatProjectStore, createPersistentSessionStore, } from "./state.js";
-const config = loadConfig();
-const sessionStore = createPersistentSessionStore();
-const opencode = createOpencodeBridge(config.opencode, { sessionStore });
-const projects = createProjectStore();
-const chatProjects = createChatProjectStore();
-const chatModels = createChatModelStore();
-const bot = startBot(config, opencode, projects, chatProjects, chatModels);
-process.once("SIGINT", () => bot.stop("SIGINT"));
-process.once("SIGTERM", () => bot.stop("SIGTERM"));
+import { runBot } from "./run.js";
+runBot();
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAA;AAEtB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;AAC3B,MAAM,YAAY,GAAG,4BAA4B,EAAE,CAAA;AACnD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,CAAA;AACxE,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;AACrC,MAAM,YAAY,GAAG,sBAAsB,EAAE,CAAA;AAC7C,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAA;AACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;AAE1E,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;AAChD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEjC,MAAM,EAAE,CAAA"}

package/dist/run.d.ts

@@ -0,0 +1,3 @@
+import "dotenv/config";
+export declare const runBot: () => import("telegraf").Telegraf<import("telegraf").Context<import("@telegraf/types").Update>>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAA;AAYtB,eAAO,MAAM,MAAM,iGAalB,CAAA"}

package/dist/run.js

@@ -0,0 +1,19 @@
+import "dotenv/config";
+import { loadConfig } from "./config.js";
+import { startBot } from "./bot.js";
+import { createOpencodeBridge } from "./opencode.js";
+import { createProjectStore } from "./projects.js";
+import { createChatModelStore, createChatProjectStore, createPersistentSessionStore, } from "./state.js";
+export const runBot = () => {
+    const config = loadConfig();
+    const sessionStore = createPersistentSessionStore();
+    const opencode = createOpencodeBridge(config.opencode, { sessionStore });
+    const projects = createProjectStore();
+    const chatProjects = createChatProjectStore();
+    const chatModels = createChatModelStore();
+    const bot = startBot(config, opencode, projects, chatProjects, chatModels);
+    process.once("SIGINT", () => bot.stop("SIGINT"));
+    process.once("SIGTERM", () => bot.stop("SIGTERM"));
+    return bot;
+};
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAA;AAEtB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,YAAY,CAAA;AAEnB,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,EAAE;IACzB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAA;IAC3B,MAAM,YAAY,GAAG,4BAA4B,EAAE,CAAA;IACnD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,YAAY,EAAE,CAAC,CAAA;IACxE,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAA;IACrC,MAAM,YAAY,GAAG,sBAAsB,EAAE,CAAA;IAC7C,MAAM,UAAU,GAAG,oBAAoB,EAAE,CAAA;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAA;IAE1E,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;IAChD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAA;IAElD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA"}

package/docs/configuration.md

@@ -1,6 +1,6 @@
 # Configuration
 
-Set these environment variables in `.env` or in your service environment.
+Set these environment variables in your shell or service environment.
 
 ## Required
 - `TELEGRAM_BOT_TOKEN` - Telegram bot token.
@@ -12,10 +12,13 @@ Set these environment variables in `.env` or in your service environment.
 - `OPENCODE_SERVER_PASSWORD` - Basic auth password.
 - `OPENCODE_PROMPT_TIMEOUT_MS` - Prompt timeout in milliseconds (default: 600000).
 - `TELEGRAM_HANDLER_TIMEOUT_MS` - Telegraf handler timeout in milliseconds (default: prompt timeout + 30000).
-- `OPENCODE_RESTART_COMMAND` - Command to restart OpenCode when `/reboot` is used (example: `sudo -n systemctl restart opencode`).
+- `OPENCODE_RESTART_COMMAND` - Command to restart OpenCode when `/reboot` is used (example: `systemctl --user restart opencode --no-block`).
 - `OPENCODE_RESTART_TIMEOUT_MS` - Restart command timeout in milliseconds (default: 30000).
-- `OPENCODE_BRIDGE_RESTART_COMMAND` - Command to restart the Telegram bridge when `/restart` is used (example: `sudo -n systemctl restart opencode-telegram-bridge`).
+- `OPENCODE_BRIDGE_RESTART_COMMAND` - Command to restart the Telegram bridge when `/restart` is used (example: `systemctl --user restart opencode-telegram-bridge --no-block`).
 - `OPENCODE_BRIDGE_RESTART_TIMEOUT_MS` - Restart command timeout in milliseconds (default: 30000).
 
 ## Data storage
 - Project aliases and chat selections are stored in `~/.opencode-telegram-bridge/projects.db`.
+
+## systemd user service
+The setup wizard writes a user service env file at `~/.config/opencode-telegram-bridge/opencode-telegram-bridge.env`.

package/docs/index.md

@@ -1,10 +1,9 @@
 # OpenCode Telegram Bridge
 
-Run a Telegram bot that forwards messages to an OpenCode backend and returns responses. This site is a minimal, markdown-first reference for operating the bridge.
+Run a Telegram bot that forwards messages to an OpenCode backend and returns responses. These docs are for end users and aim to make setup and operation unambiguous.
 
 Start here:
 - Installation
 - Configuration
 - Usage
 - Systemd
-- Release

package/docs/installation.md

@@ -3,40 +3,21 @@
 ## Prerequisites
 - Node.js 18+
 - OpenCode CLI installed and available on PATH (see https://opencode.ai/docs/cli/)
+- OpenCode server running (`opencode serve`)
 
-## Install dependencies
+## Install
 ```bash
-npm install
+npm install -g opencode-telegram-bridge
 ```
 
-## Start OpenCode server
+## Setup (Linux systemd)
 ```bash
-opencode serve
+opencode-telegram-bridge setup
 ```
 
-## Configure environment
-Copy the example file and fill in values:
-```bash
-cp .env.example .env
-```
+Setup currently supports Linux systemd only. On other platforms, run the bot manually.
 
 ## Run the bot
 ```bash
-npm run dev
-```
-
-For production, build and run:
-```bash
-npm run build
-npm start
-```
-
-## Install via npm
-```bash
-npm install -g opencode-telegram-bridge
-```
-
-Run:
-```bash
 opencode-telegram-bridge
 ```

package/docs/systemd.md

@@ -1,30 +1,35 @@
-# systemd Service (Linux)
+# systemd Service (Linux user)
 
-This project ships a systemd unit template in `systemd/opencode-telegram-bridge.service`.
+This project ships a user systemd unit template in `systemd/opencode-telegram-bridge.service`.
 
-## Install
-1. Build the project:
+## Recommended: setup wizard
+```bash
+opencode-telegram-bridge setup
+```
+
+## Manual install
+1. Install the package:
 
 ```bash
-npm install
-npm run build
+npm install -g opencode-telegram-bridge
 ```
 
 2. Copy the service and env files:
 
 ```bash
-sudo mkdir -p /etc/opencode-telegram-bridge
-sudo cp systemd/opencode-telegram-bridge.service /etc/systemd/system/opencode-telegram-bridge.service
-sudo cp systemd/opencode-telegram-bridge.env.example /etc/opencode-telegram-bridge.env
+mkdir -p ~/.config/systemd/user
+mkdir -p ~/.config/opencode-telegram-bridge
+cp systemd/opencode-telegram-bridge.service ~/.config/systemd/user/opencode-telegram-bridge.service
+cp systemd/opencode-telegram-bridge.env.example ~/.config/opencode-telegram-bridge/opencode-telegram-bridge.env
 ```
 
 3. Edit the env file:
 
 ```bash
-sudo nano /etc/opencode-telegram-bridge.env
+nano ~/.config/opencode-telegram-bridge/opencode-telegram-bridge.env
 ```
 
-4. Update the service paths if needed:
+4. Update the service path if needed:
 
 - `ExecStart=/usr/bin/opencode-telegram-bridge`
 - If you installed via npm in a non-standard location, set `ExecStart` to the output of `command -v opencode-telegram-bridge`.
@@ -32,11 +37,18 @@ sudo nano /etc/opencode-telegram-bridge.env
 5. Enable and start:
 
 ```bash
-sudo systemctl daemon-reload
-sudo systemctl enable --now opencode-telegram-bridge
+systemctl --user daemon-reload
+systemctl --user enable --now opencode-telegram-bridge
+```
+
+## Start on boot (optional)
+User services normally start on login. To run on boot without a login session:
+
+```bash
+sudo loginctl enable-linger $(whoami)
 ```
 
 ## Logs
 ```bash
-sudo journalctl -u opencode-telegram-bridge -f
+journalctl --user -u opencode-telegram-bridge -f
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-telegram-bridge",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/systemd/opencode-telegram-bridge.env.example

@@ -6,6 +6,6 @@ OPENCODE_SERVER_PASSWORD=
 OPENCODE_PROMPT_TIMEOUT_MS=600000
 TELEGRAM_HANDLER_TIMEOUT_MS=630000
 OPENCODE_RESTART_COMMAND=
-OPENCODE_RESTART_TIMEOUT_MS=30000
-OPENCODE_BRIDGE_RESTART_COMMAND=
+OPENCODE_RESTART_TIMEOUT_MS=
+OPENCODE_BRIDGE_RESTART_COMMAND=systemctl --user restart opencode-telegram-bridge --no-block
 OPENCODE_BRIDGE_RESTART_TIMEOUT_MS=30000

package/systemd/opencode-telegram-bridge.service

@@ -5,10 +5,10 @@ Wants=network-online.target
 
 [Service]
 Type=simple
-EnvironmentFile=/etc/opencode-telegram-bridge.env
+EnvironmentFile=%h/.config/opencode-telegram-bridge/opencode-telegram-bridge.env
 ExecStart=/usr/bin/opencode-telegram-bridge
 Restart=on-failure
 RestartSec=3
 
 [Install]
-WantedBy=multi-user.target
+WantedBy=default.target

package/docs/release.md

@@ -1,112 +0,0 @@
-# Release
-
-This project is published as an npm package.
-
-## Mental model
-Every CI run (PRs and pushes) requires a changeset for non-doc changes or it
-fails. A push to `main` creates or updates the release PR. A merged PR leads to
-a push to `main`, so it also updates the release PR. The release PR accumulates
-changesets until it is merged. When the release PR is merged, npm publishes a
-new version and a GitHub release is created using the accumulated changesets.
-
-## CI + release flowcharts
-
-### Pull request opened
-```
-PR opened/updated
-        |
-        v
-CI workflow (pull_request)
-  |
-  +--> npm ci
-  +--> changeset check (diff base...head)
-  |      |
-  |      +--> relevant change + no changeset -> FAIL
-  |      +--> docs-only or has changeset     -> OK
-  +--> typecheck + tests + build
-        |
-        v
-      Status checks gate merge to main
-```
-
-### Push to main
-```
-Push to main
-   |
-   v
-CI workflow (push)
-  |
-  +--> npm ci
-  +--> changeset check (diff before...after)
-  |      |
-  |      +--> relevant change + no changeset -> FAIL
-  |      +--> docs-only or has changeset     -> OK
-  +--> typecheck + tests + build
-  |
-  v
-Release workflow (push)
-  |
-  +--> changesets/action
-         |
-         +--> changesets present?
-         |      |
-         |      +--> yes: create/update release PR (changeset-release/main)
-         |      |        (no publish)
-         |      |
-         |      +--> no: run `npm run release` (publish to npm)
-         |
-         +--> if published: create GitHub release tag (unless it already exists)
-```
-
-## Manual release (local)
-1. Add a changeset for your change:
-
-```bash
-npx changeset
-```
-
-2. Version the release:
-
-```bash
-npm run version
-```
-
-3. Publish:
-
-```bash
-npm run release
-```
-
-The `prepublishOnly` script runs the build to ensure `dist/` is included.
-
-## Required setup (GitHub Actions)
-- Configure npm Trusted Publishing for this repo and workflow file (`release.yml`).
-- The workflow requires `id-token: write` permission to publish via OIDC.
-- npm CLI 11.5.1+ is required for trusted publishing.
-
-## CI enforcement
-CI fails if a relevant code change lands without a `.changeset/*.md` file.
-Docs-only updates (`docs/`, `README.md`, `.github/`) do not require a changeset.
-
-## FAQ
-
-### How is the version bump decided?
-You pick it when you run `npx changeset`. The changeset file records whether the
-change is a `patch`, `minor`, or `major`. When you run `npm run version`, all
-pending changesets are read and the highest required bump wins.
-
-### How is the changelog generated?
-The changelog is generated from the text in the changeset files, not from
-commits. Each changeset contributes a short release note entry.
-
-### Does each merged PR cause a new package version?
-No. Merged PRs with changesets update the release PR. A new version is published
-only when the release PR is merged.
-
-### What happens if I push to main without a changeset?
-CI fails. Add a changeset in a follow-up commit and push again. Do not rewrite
-history on main.
-
-### Do I need one changeset per commit or per push?
-No. You need one changeset per release-worthy change (often one per PR). A
-single changeset can cover multiple commits.