@easyoref/cli 1.21.1

package/dist/commands/init.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `easyoref init` — Interactive setup wizard
+ *
+ * Walks user through:
+ *   1. Language selection (ru/en/he)
+ *   2. Bot token input + validation
+ *   3. Chat ID input
+ *   4. Area selection (checkbox)
+ *   5. Generates .env file
+ */
+export declare function init(): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,132 @@
+/**
+ * `easyoref init` — Interactive setup wizard
+ *
+ * Walks user through:
+ *   1. Language selection (ru/en/he)
+ *   2. Bot token input + validation
+ *   3. Chat ID input
+ *   4. Area selection (checkbox)
+ *   5. Generates .env file
+ */
+import { checkbox, input, password, select } from "@inquirer/prompts";
+import chalk from "chalk";
+import { Bot } from "grammy";
+import { writeFileSync } from "node:fs";
+import { AREA_CHOICES } from "../data/areas.js";
+export async function init() {
+    // ── Step 0: Language ───────────────────────────────────
+    const language = await select({
+        message: "🌍 Message language / Язык сообщений / שפת ההודעות:",
+        choices: [
+            { name: "Русский", value: "ru" },
+            { name: "English", value: "en" },
+            { name: "עברית", value: "he" },
+        ],
+    });
+    const t = translations[language];
+    // ── Step 1: Bot Token ──────────────────────────────────
+    const botToken = await password({
+        message: t.botTokenPrompt,
+        validate: (val) => {
+            if (!val || val.length < 10)
+                return t.botTokenRequired;
+            if (!val.includes(":"))
+                return t.botTokenFormat;
+            return true;
+        },
+    });
+    // Validate token by calling Telegram API
+    console.log(chalk.dim(t.validating));
+    try {
+        const bot = new Bot(botToken);
+        const me = await bot.api.getMe();
+        console.log(chalk.green(`  ✅ ${t.botVerified}: @${me.username}`));
+    }
+    catch {
+        console.log(chalk.yellow(`  ⚠️  ${t.botVerifyFailed}`));
+    }
+    // ── Step 2: Chat ID ────────────────────────────────────
+    const chatId = await input({
+        message: t.chatIdPrompt,
+        validate: (val) => {
+            if (!val)
+                return t.chatIdRequired;
+            // Allow negative numbers (groups) and positive (DMs)
+            if (!/^-?\d+$/.test(val))
+                return t.chatIdFormat;
+            return true;
+        },
+    });
+    // ── Step 3: Areas ──────────────────────────────────────
+    const areas = await checkbox({
+        message: t.areasPrompt,
+        choices: AREA_CHOICES,
+        required: true,
+    });
+    // ── Step 4: Write .env ─────────────────────────────────
+    const envContent = [
+        "# EasyOref Configuration",
+        `# Generated by @easyoref/cli on ${new Date().toISOString().split("T")[0]}`,
+        "",
+        `BOT_TOKEN=${botToken}`,
+        `CHAT_ID=${chatId}`,
+        `AREAS=${areas.join(",")}`,
+        `LANGUAGE=${language}`,
+        "HEALTH_PORT=3100",
+        "",
+    ].join("\n");
+    writeFileSync(".env", envContent, "utf-8");
+    console.log("");
+    console.log(chalk.green.bold(`✅ ${t.configSaved}`));
+    console.log("");
+    console.log(chalk.dim(t.nextSteps));
+    console.log(`  ${chalk.cyan("docker compose up -d")}  ${chalk.dim("(Docker)")}`);
+    console.log(`  ${chalk.cyan("npm start")}             ${chalk.dim("(Node.js)")}`);
+    console.log("");
+}
+// ── i18n for the wizard itself ───────────────────────────
+const translations = {
+    ru: {
+        botTokenPrompt: "🤖 Токен бота (от @BotFather):",
+        botTokenRequired: "Токен обязателен",
+        botTokenFormat: "Формат: 123456:ABC-DEF...",
+        validating: "  Проверяем токен...",
+        botVerified: "Бот найден",
+        botVerifyFailed: "Не удалось проверить токен (продолжаем)",
+        chatIdPrompt: "💬 Chat ID группы (отрицательное число):",
+        chatIdRequired: "Chat ID обязателен",
+        chatIdFormat: "Chat ID — число (отрицательное для групп)",
+        areasPrompt: "📍 Выберите районы для мониторинга (пробел = выбрать):",
+        configSaved: "Конфигурация сохранена в .env",
+        nextSteps: "Следующий шаг — запустите бота:",
+    },
+    en: {
+        botTokenPrompt: "🤖 Bot Token (from @BotFather):",
+        botTokenRequired: "Token is required",
+        botTokenFormat: "Format: 123456:ABC-DEF...",
+        validating: "  Validating token...",
+        botVerified: "Bot found",
+        botVerifyFailed: "Could not verify token (continuing anyway)",
+        chatIdPrompt: "💬 Chat ID (negative number for groups):",
+        chatIdRequired: "Chat ID is required",
+        chatIdFormat: "Chat ID must be a number (negative for groups)",
+        areasPrompt: "📍 Select areas to monitor (space = toggle):",
+        configSaved: "Config saved to .env",
+        nextSteps: "Next step — start the bot:",
+    },
+    he: {
+        botTokenPrompt: "🤖 טוקן בוט (מ-@BotFather):",
+        botTokenRequired: "טוקן נדרש",
+        botTokenFormat: "פורמט: 123456:ABC-DEF...",
+        validating: "  מאמת טוקן...",
+        botVerified: "בוט נמצא",
+        botVerifyFailed: "לא ניתן לאמת את הטוקן (ממשיכים)",
+        chatIdPrompt: "💬 Chat ID (מספר שלילי לקבוצות):",
+        chatIdRequired: "Chat ID נדרש",
+        chatIdFormat: "Chat ID חייב להיות מספר (שלילי לקבוצות)",
+        areasPrompt: "📍 בחר אזורים לניטור (רווח = בחירה):",
+        configSaved: "הגדרות נשמרו ל-.env",
+        nextSteps: "שלב הבא — הפעל את הבוט:",
+    },
+};
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,0DAA0D;IAE1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;QAC5B,OAAO,EAAE,qDAAqD;QAC9D,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE;YAChC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE;YAChC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE;SAC/B;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,YAAY,CAAC,QAAqC,CAAC,CAAC;IAE9D,0DAA0D;IAE1D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC,cAAc;QACzB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YAChB,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;gBAAE,OAAO,CAAC,CAAC,gBAAgB,CAAC;YACvD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC,cAAc,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;IAEH,yCAAyC;IACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,WAAW,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,0DAA0D;IAE1D,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,YAAY;QACvB,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE;YAChB,IAAI,CAAC,GAAG;gBAAE,OAAO,CAAC,CAAC,cAAc,CAAC;YAClC,qDAAqD;YACrD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC,YAAY,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC,CAAC;IAEH,0DAA0D;IAE1D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC;QAC3B,OAAO,EAAE,CAAC,CAAC,WAAW;QACtB,OAAO,EAAE,YAAY;QACrB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,0DAA0D;IAE1D,MAAM,UAAU,GAAG;QACjB,0BAA0B;QAC1B,mCAAmC,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;QAC3E,EAAE;QACF,aAAa,QAAQ,EAAE;QACvB,WAAW,MAAM,EAAE;QACnB,SAAS,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;QAC1B,YAAY,QAAQ,EAAE;QACtB,kBAAkB;QAClB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CACpE,CAAC;IACF,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,gBAAgB,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CACrE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAED,4DAA4D;AAE5D,MAAM,YAAY,GAAG;IACnB,EAAE,EAAE;QACF,cAAc,EAAE,gCAAgC;QAChD,gBAAgB,EAAE,kBAAkB;QACpC,cAAc,EAAE,2BAA2B;QAC3C,UAAU,EAAE,sBAAsB;QAClC,WAAW,EAAE,YAAY;QACzB,eAAe,EAAE,yCAAyC;QAC1D,YAAY,EAAE,0CAA0C;QACxD,cAAc,EAAE,oBAAoB;QACpC,YAAY,EAAE,2CAA2C;QACzD,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE,+BAA+B;QAC5C,SAAS,EAAE,iCAAiC;KAC7C;IACD,EAAE,EAAE;QACF,cAAc,EAAE,iCAAiC;QACjD,gBAAgB,EAAE,mBAAmB;QACrC,cAAc,EAAE,2BAA2B;QAC3C,UAAU,EAAE,uBAAuB;QACnC,WAAW,EAAE,WAAW;QACxB,eAAe,EAAE,4CAA4C;QAC7D,YAAY,EAAE,0CAA0C;QACxD,cAAc,EAAE,qBAAqB;QACrC,YAAY,EAAE,gDAAgD;QAC9D,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,sBAAsB;QACnC,SAAS,EAAE,4BAA4B;KACxC;IACD,EAAE,EAAE;QACF,cAAc,EAAE,6BAA6B;QAC7C,gBAAgB,EAAE,WAAW;QAC7B,cAAc,EAAE,0BAA0B;QAC1C,UAAU,EAAE,gBAAgB;QAC5B,WAAW,EAAE,UAAU;QACvB,eAAe,EAAE,iCAAiC;QAClD,YAAY,EAAE,kCAAkC;QAChD,cAAc,EAAE,cAAc;QAC9B,YAAY,EAAE,yCAAyC;QACvD,WAAW,EAAE,sCAAsC;QACnD,WAAW,EAAE,qBAAqB;QAClC,SAAS,EAAE,yBAAyB;KACrC;CACF,CAAC"}

package/dist/commands/list-areas.d.ts

@@ -0,0 +1,4 @@
+/**
+ * `easyoref list-areas` — Print all available Oref area names
+ */
+export declare function listAreas(): void;

package/dist/commands/list-areas.js

@@ -0,0 +1,16 @@
+/**
+ * `easyoref list-areas` — Print all available Oref area names
+ */
+import chalk from "chalk";
+import { AREA_CHOICES } from "../data/areas.js";
+export function listAreas() {
+    console.log(chalk.bold("Available Oref areas for AREAS env var:\n"));
+    console.log(chalk.dim("Copy the Hebrew name (right column) into your .env AREAS field.\n"));
+    const maxName = Math.max(...AREA_CHOICES.map((c) => c.name.length));
+    for (const choice of AREA_CHOICES) {
+        const padded = choice.name.padEnd(maxName + 2);
+        console.log(`  ${padded} ${chalk.cyan(choice.value)}`);
+    }
+    console.log(chalk.dim("\nExample: AREAS=תל אביב - דרום העיר ויפו,גוש דן"));
+}
+//# sourceMappingURL=list-areas.js.map

package/dist/commands/list-areas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-areas.js","sourceRoot":"","sources":["../../src/commands/list-areas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,UAAU,SAAS;IACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CACP,mEAAmE,CACpE,CACF,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpE,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC,CAAC;AAC7E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+#! /usr/bin/env node
+/**
+ * @easyoref/cli — Interactive setup wizard
+ *
+ * Usage:
+ *   npx @easyoref/cli init         — interactive setup
+ *   npx @easyoref/cli list-areas   — show all Oref area names
+ *   npx @easyoref/cli update        — update RPi deployment
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,78 @@
+#! /usr/bin/env node
+/**
+ * @easyoref/cli — Interactive setup wizard
+ *
+ * Usage:
+ *   npx @easyoref/cli init         — interactive setup
+ *   npx @easyoref/cli list-areas   — show all Oref area names
+ *   npx @easyoref/cli update        — update RPi deployment
+ */
+import chalk from "chalk";
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { init } from "./commands/init.js";
+import { listAreas } from "./commands/list-areas.js";
+const command = process.argv[2];
+const args = process.argv.slice(3);
+async function main() {
+    console.log(chalk.bold("\n🚨 EasyOref — Setup Wizard\n"));
+    switch (command) {
+        case "init":
+        case undefined:
+            await init();
+            break;
+        case "list-areas":
+            listAreas();
+            break;
+        case "update":
+            update(args[0]);
+            break;
+        case "--help":
+        case "-h":
+            printHelp();
+            break;
+        default:
+            console.log(chalk.red(`Unknown command: ${command}`));
+            printHelp();
+            process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`${chalk.bold("Commands:")}
+  ${chalk.cyan("init")}                  Interactive setup wizard (default)
+  ${chalk.cyan("list-areas")}           Show all Oref area names with translations
+  ${chalk.cyan("update")}                Update RPi deployment
+  ${chalk.cyan("update /path/to/deploy")} Update in specific directory
+  ${chalk.cyan("--help")}                Show this help message
+`);
+}
+function update(path) {
+    const targetPath = path
+        ? resolve(path)
+        : process.cwd();
+    const composePath = resolve(targetPath, "docker-compose.yml");
+    const envPath = resolve(targetPath, ".env");
+    if (!existsSync(composePath)) {
+        console.log(chalk.yellow(`No docker-compose.yml found in: ${targetPath}`));
+        console.log(chalk.gray("Usage: easyoref update /path/to/deployment"));
+        process.exit(1);
+    }
+    console.log(chalk.cyan(`Updating EasyOref in: ${targetPath}...\n`));
+    try {
+        console.log(chalk.gray("  → docker compose down"));
+        execSync("docker compose down", { cwd: targetPath, stdio: "inherit" });
+        console.log(chalk.gray("\n  → docker compose up --build -d"));
+        execSync("docker compose up --build -d", { cwd: targetPath, stdio: "inherit" });
+        console.log(chalk.green("\n✅ EasyOref updated successfully!"));
+    }
+    catch (err) {
+        console.error(chalk.red("\n❌ Update failed:"), err);
+        process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error(chalk.red("Fatal error:"), err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@easyoref/cli",
+  "version": "1.21.1",
+  "description": "Interactive setup wizard for EasyOref",
+  "type": "module",
+  "bin": {
+    "easyoref": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "easyoref",
+    "oref",
+    "telegram",
+    "cli",
+    "setup-wizard"
+  ],
+  "author": "Mikhail Kogan <kogan.mikhail@gmail.com>",
+  "license": "MIT",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "grammy": "^1.35.0",
+    "@easyoref/shared": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}

package/src/commands/init.ts

@@ -0,0 +1,147 @@
+/**
+ * `easyoref init` — Interactive setup wizard
+ *
+ * Walks user through:
+ *   1. Language selection (ru/en/he)
+ *   2. Bot token input + validation
+ *   3. Chat ID input
+ *   4. Area selection (checkbox)
+ *   5. Generates .env file
+ */
+
+import { checkbox, input, password, select } from "@inquirer/prompts";
+import chalk from "chalk";
+import { Bot } from "grammy";
+import { writeFileSync } from "node:fs";
+import { AREA_CHOICES } from "../data/areas.js";
+
+export async function init(): Promise<void> {
+  // ── Step 0: Language ───────────────────────────────────
+
+  const language = await select({
+    message: "🌍 Message language / Язык сообщений / שפת ההודעות:",
+    choices: [
+      { name: "Русский", value: "ru" },
+      { name: "English", value: "en" },
+      { name: "עברית", value: "he" },
+    ],
+  });
+
+  const t = translations[language as keyof typeof translations];
+
+  // ── Step 1: Bot Token ──────────────────────────────────
+
+  const botToken = await password({
+    message: t.botTokenPrompt,
+    validate: (val) => {
+      if (!val || val.length < 10) return t.botTokenRequired;
+      if (!val.includes(":")) return t.botTokenFormat;
+      return true;
+    },
+  });
+
+  // Validate token by calling Telegram API
+  console.log(chalk.dim(t.validating));
+  try {
+    const bot = new Bot(botToken);
+    const me = await bot.api.getMe();
+    console.log(chalk.green(`  ✅ ${t.botVerified}: @${me.username}`));
+  } catch {
+    console.log(chalk.yellow(`  ⚠️  ${t.botVerifyFailed}`));
+  }
+
+  // ── Step 2: Chat ID ────────────────────────────────────
+
+  const chatId = await input({
+    message: t.chatIdPrompt,
+    validate: (val) => {
+      if (!val) return t.chatIdRequired;
+      // Allow negative numbers (groups) and positive (DMs)
+      if (!/^-?\d+$/.test(val)) return t.chatIdFormat;
+      return true;
+    },
+  });
+
+  // ── Step 3: Areas ──────────────────────────────────────
+
+  const areas = await checkbox({
+    message: t.areasPrompt,
+    choices: AREA_CHOICES,
+    required: true,
+  });
+
+  // ── Step 4: Write .env ─────────────────────────────────
+
+  const envContent = [
+    "# EasyOref Configuration",
+    `# Generated by @easyoref/cli on ${new Date().toISOString().split("T")[0]}`,
+    "",
+    `BOT_TOKEN=${botToken}`,
+    `CHAT_ID=${chatId}`,
+    `AREAS=${areas.join(",")}`,
+    `LANGUAGE=${language}`,
+    "HEALTH_PORT=3100",
+    "",
+  ].join("\n");
+
+  writeFileSync(".env", envContent, "utf-8");
+
+  console.log("");
+  console.log(chalk.green.bold(`✅ ${t.configSaved}`));
+  console.log("");
+  console.log(chalk.dim(t.nextSteps));
+  console.log(
+    `  ${chalk.cyan("docker compose up -d")}  ${chalk.dim("(Docker)")}`,
+  );
+  console.log(
+    `  ${chalk.cyan("npm start")}             ${chalk.dim("(Node.js)")}`,
+  );
+  console.log("");
+}
+
+// ── i18n for the wizard itself ───────────────────────────
+
+const translations = {
+  ru: {
+    botTokenPrompt: "🤖 Токен бота (от @BotFather):",
+    botTokenRequired: "Токен обязателен",
+    botTokenFormat: "Формат: 123456:ABC-DEF...",
+    validating: "  Проверяем токен...",
+    botVerified: "Бот найден",
+    botVerifyFailed: "Не удалось проверить токен (продолжаем)",
+    chatIdPrompt: "💬 Chat ID группы (отрицательное число):",
+    chatIdRequired: "Chat ID обязателен",
+    chatIdFormat: "Chat ID — число (отрицательное для групп)",
+    areasPrompt: "📍 Выберите районы для мониторинга (пробел = выбрать):",
+    configSaved: "Конфигурация сохранена в .env",
+    nextSteps: "Следующий шаг — запустите бота:",
+  },
+  en: {
+    botTokenPrompt: "🤖 Bot Token (from @BotFather):",
+    botTokenRequired: "Token is required",
+    botTokenFormat: "Format: 123456:ABC-DEF...",
+    validating: "  Validating token...",
+    botVerified: "Bot found",
+    botVerifyFailed: "Could not verify token (continuing anyway)",
+    chatIdPrompt: "💬 Chat ID (negative number for groups):",
+    chatIdRequired: "Chat ID is required",
+    chatIdFormat: "Chat ID must be a number (negative for groups)",
+    areasPrompt: "📍 Select areas to monitor (space = toggle):",
+    configSaved: "Config saved to .env",
+    nextSteps: "Next step — start the bot:",
+  },
+  he: {
+    botTokenPrompt: "🤖 טוקן בוט (מ-@BotFather):",
+    botTokenRequired: "טוקן נדרש",
+    botTokenFormat: "פורמט: 123456:ABC-DEF...",
+    validating: "  מאמת טוקן...",
+    botVerified: "בוט נמצא",
+    botVerifyFailed: "לא ניתן לאמת את הטוקן (ממשיכים)",
+    chatIdPrompt: "💬 Chat ID (מספר שלילי לקבוצות):",
+    chatIdRequired: "Chat ID נדרש",
+    chatIdFormat: "Chat ID חייב להיות מספר (שלילי לקבוצות)",
+    areasPrompt: "📍 בחר אזורים לניטור (רווח = בחירה):",
+    configSaved: "הגדרות נשמרו ל-.env",
+    nextSteps: "שלב הבא — הפעל את הבוט:",
+  },
+};

package/src/commands/list-areas.ts

@@ -0,0 +1,24 @@
+/**
+ * `easyoref list-areas` — Print all available Oref area names
+ */
+
+import chalk from "chalk";
+import { AREA_CHOICES } from "../data/areas.js";
+
+export function listAreas(): void {
+  console.log(chalk.bold("Available Oref areas for AREAS env var:\n"));
+  console.log(
+    chalk.dim(
+      "Copy the Hebrew name (right column) into your .env AREAS field.\n",
+    ),
+  );
+
+  const maxName = Math.max(...AREA_CHOICES.map((c) => c.name.length));
+
+  for (const choice of AREA_CHOICES) {
+    const padded = choice.name.padEnd(maxName + 2);
+    console.log(`  ${padded} ${chalk.cyan(choice.value)}`);
+  }
+
+  console.log(chalk.dim("\nExample: AREAS=תל אביב - דרום העיר ויפו,גוש דן"));
+}

package/src/index.ts

@@ -0,0 +1,89 @@
+#! /usr/bin/env node
+/**
+ * @easyoref/cli — Interactive setup wizard
+ *
+ * Usage:
+ *   npx @easyoref/cli init         — interactive setup
+ *   npx @easyoref/cli list-areas   — show all Oref area names
+ *   npx @easyoref/cli update        — update RPi deployment
+ */
+
+import chalk from "chalk";
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { init } from "./commands/init.js";
+import { listAreas } from "./commands/list-areas.js";
+
+const command = process.argv[2];
+const args = process.argv.slice(3);
+
+async function main(): Promise<void> {
+  console.log(chalk.bold("\n🚨 EasyOref — Setup Wizard\n"));
+
+  switch (command) {
+    case "init":
+    case undefined:
+      await init();
+      break;
+    case "list-areas":
+      listAreas();
+      break;
+    case "update":
+      update(args[0]);
+      break;
+    case "--help":
+    case "-h":
+      printHelp();
+      break;
+    default:
+      console.log(chalk.red(`Unknown command: ${command}`));
+      printHelp();
+      process.exit(1);
+  }
+}
+
+function printHelp(): void {
+  console.log(`${chalk.bold("Commands:")}
+  ${chalk.cyan("init")}                  Interactive setup wizard (default)
+  ${chalk.cyan("list-areas")}           Show all Oref area names with translations
+  ${chalk.cyan("update")}                Update RPi deployment
+  ${chalk.cyan("update /path/to/deploy")} Update in specific directory
+  ${chalk.cyan("--help")}                Show this help message
+`);
+}
+
+function update(path?: string): void {
+  const targetPath = path 
+    ? resolve(path) 
+    : process.cwd();
+
+  const composePath = resolve(targetPath, "docker-compose.yml");
+  const envPath = resolve(targetPath, ".env");
+
+  if (!existsSync(composePath)) {
+    console.log(chalk.yellow(`No docker-compose.yml found in: ${targetPath}`));
+    console.log(chalk.gray("Usage: easyoref update /path/to/deployment"));
+    process.exit(1);
+  }
+
+  console.log(chalk.cyan(`Updating EasyOref in: ${targetPath}...\n`));
+
+  try {
+    console.log(chalk.gray("  → docker compose down"));
+    execSync("docker compose down", { cwd: targetPath, stdio: "inherit" });
+
+    console.log(chalk.gray("\n  → docker compose up --build -d"));
+    execSync("docker compose up --build -d", { cwd: targetPath, stdio: "inherit" });
+
+    console.log(chalk.green("\n✅ EasyOref updated successfully!"));
+  } catch (err) {
+    console.error(chalk.red("\n❌ Update failed:"), err);
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error(chalk.red("Fatal error:"), err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true,
+    "composite": true
+  },
+  "references": [{ "path": "../shared" }, { "path": "../monitoring" }],
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}