yougile-cli 0.8.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 RainyPixel
+
+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,320 @@
+# YouGile Toolkit
+
+CLI утилита для работы с [YouGile API](https://ru.yougile.com/) из командной строки.
+
+## Особенности
+
+- **Standalone бинарник** — работает без Node.js/Bun
+- **Алиасы** — используйте имена колонок и стикеров вместо UUID
+- **Markdown** — описания в Markdown автоматически конвертируются в HTML
+- **Шаблоны** — создавайте задачи из YAML-шаблонов
+- **Интерактивный режим** — удобный wizard для создания задач
+- **Автообновление** — команда `upgrade` для обновления CLI
+- **Чеклисты** — текстовый и JSON форматы
+- **Дедлайны** — поддержка нескольких форматов дат
+- **Спринты** — создание и управление стикерами спринтов
+- **Загрузка файлов** — прикрепление к задачам
+- **Scope система** — фильтрация по проектам и доскам
+
+## Установка
+
+### npm (рекомендуется)
+
+```bash
+npm install -g yougile-cli
+# или
+bun install -g yougile-cli
+# или
+pnpm install -g yougile-cli
+```
+
+### npx (без установки)
+
+```bash
+npx yougile-cli --help
+```
+
+### Обновление
+
+```bash
+npm update -g yougile-cli
+# или
+yougile upgrade
+```
+
+## Быстрый старт
+
+### 1. Инициализация
+
+```bash
+yougile setup
+```
+
+Создаст файл `yougile.config.json` и добавит его в `.gitignore`.
+
+### 2. Настройка конфигурации
+
+Отредактируйте `yougile.config.json`:
+
+```json
+{
+  "companyId": "ваш-company-id",
+  "userId": "ваш-email@example.com",
+  "userPassword": "ваш-пароль"
+}
+```
+
+> **Где найти `companyId`?**
+> В URL вашего YouGile: `https://ru.yougile.com/team/{companyId}/...`
+
+### 3. Получение API ключа
+
+```bash
+yougile auth
+```
+
+### 4. Синхронизация алиасов
+
+```bash
+yougile sync
+```
+
+Это загрузит названия колонок и стикеров, чтобы вы могли использовать их вместо UUID.
+
+## Использование
+
+### Интерактивный режим
+
+```bash
+yougile i
+# или
+yougile interactive
+```
+
+Wizard для создания задач с выбором колонок, стикеров и шаблонов.
+
+### Создание задач
+
+```bash
+# Базовое создание (с алиасами)
+yougile create --title "Моя задача" --column "В работе"
+
+# С описанием в Markdown
+yougile create --title "Задача" --column "В работе" \
+  --description "## Описание\n- Пункт 1\n- Пункт 2"
+
+# Со стикерами (по имени)
+yougile create --title "Баг" --column "В работе" \
+  --priority "P-1" --type "Bug"
+
+# Из шаблона
+yougile create --template bugfix --title "Fix crash"
+
+# С чеклистом
+yougile create --title "Задача" --column "В работе" \
+  --checklist "TODO:[ ] Написать код:[x] Тесты"
+```
+
+### Работа с задачами
+
+```bash
+# Список задач
+yougile list
+yougile list --column "В работе"
+
+# Получить задачу
+yougile get "task-id"
+
+# Переместить
+yougile move "task-id" "Готово"
+
+# Обновить
+yougile update "task-id" --complete
+yougile update "task-id" --title "Новое название"
+yougile update "task-id" --deadline "2025-12-31"
+```
+
+### Шаблоны
+
+```bash
+# Создать примеры шаблонов
+yougile template init
+
+# Список шаблонов
+yougile template list
+
+# Показать шаблон
+yougile template show bugfix
+
+# Использовать шаблон
+yougile create --template bugfix --title "Fix bug"
+```
+
+Шаблоны хранятся в YAML:
+- `.yougile/templates/` — локальные (приоритет)
+- `~/.config/yougile-toolkit/templates/` — глобальные
+
+Пример шаблона (`bugfix.yaml`):
+```yaml
+name: bugfix
+description: Шаблон для багфиксов
+defaults:
+  stickers:
+    Priority: P-2
+    Type: Bug
+  checklist:
+    name: Bug Fix
+    items:
+      - Воспроизвести баг
+      - Написать тест
+      - Исправить
+      - Проверить
+```
+
+### Scope: Фильтрация по проекту/доске
+
+```bash
+# Показать проекты
+yougile select-scope --list-projects
+
+# Установить scope на проект
+yougile select-scope --project "project-id"
+
+# Установить scope на доску
+yougile select-scope --board "board-id"
+
+# Сбросить scope
+yougile select-scope --reset
+```
+
+### Спринты
+
+```bash
+# Список спринтов
+yougile sprint list
+
+# Создать стикер спринтов
+yougile sprint create --name "Спринты команды"
+
+# Добавить спринт
+yougile sprint add "sticker-id" --name "Sprint 1" \
+  --begin "2025-01-01" --end "2025-01-31"
+
+# Обновить спринт
+yougile sprint update "sticker-id" "sprint-id" --name "Sprint 1 Updated"
+```
+
+### Файлы
+
+```bash
+# Загрузить файл
+yougile upload "./document.pdf"
+
+# Создать задачу с файлом
+yougile create --title "Задача" --column "В работе" --attach "./file.pdf"
+```
+
+### Синхронизация и обновление
+
+```bash
+# Синхронизировать алиасы
+yougile sync
+
+# Проверить обновления
+yougile upgrade --check
+
+# Обновить CLI
+yougile upgrade
+```
+
+## Форматы
+
+### Чеклисты
+
+**Текстовый формат (рекомендуется):**
+```bash
+--checklist "TODO:[ ] Пункт 1:[x] Пункт 2"
+```
+
+- `[ ]` — невыполненный
+- `[x]` — выполненный
+- `||` — разделитель между списками
+
+### Даты
+
+Поддерживаемые форматы:
+- `YYYY-MM-DD` (2025-01-31)
+- `DD.MM.YYYY` (31.01.2025)
+- `YYYY-MM-DD HH:MM` (2025-01-31 23:59)
+
+### Стикеры
+
+```bash
+# По имени (рекомендуется, после yougile sync)
+--priority "P-1" --type "Bug"
+
+# Универсальный формат
+--sticker "Priority=P-1" --sticker "Type=Bug"
+
+# JSON (для сложных случаев)
+--stickers '{"sticker-uuid":"state-uuid"}'
+```
+
+## Конфигурация
+
+### yougile.config.json
+
+```json
+{
+  "companyId": "uuid",
+  "userId": "email@example.com",
+  "userPassword": "password",
+  "apiKey": "key",
+  "projectId": "optional-project-scope",
+  "boardId": "optional-board-scope",
+  "aliases": {
+    "columns": {"В работе": "uuid"},
+    "stickers": {"Priority": {"_id": "uuid", "P-1": "state-uuid"}}
+  },
+  "settings": {
+    "autoSync": true,
+    "markdownEnabled": true
+  }
+}
+```
+
+## Rate Limiting
+
+YouGile API: **50 запросов в минуту** на компанию.
+
+## Разработка
+
+```bash
+# Установить зависимости
+bun install
+
+# Запустить CLI в режиме разработки
+bun run dev -- --help
+# или напрямую
+bun src/cli.ts --help
+
+# Собрать бинарники
+bun run build
+
+# Тесты
+bun test
+
+# Проверка типов и линтинг
+bun typecheck
+bun lint
+```
+
+## Лицензия
+
+MIT © [RainyPixel](https://gitverse.ru/RainyPixel)
+
+## Ссылки
+
+- [YouGile API Documentation](https://ru.yougile.com/api-v2)
+- [Gitverse Repository](https://gitverse.ru/onreza/yougile-toolkit)
+- [Issues](https://gitverse.ru/onreza/yougile-toolkit/tasktracker)

package/bin/yougile.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+"use strict";
+
+const { execFileSync } = require("child_process");
+const { join } = require("path");
+
+const ext = process.platform === "win32" ? ".exe" : "";
+const binPath = join(__dirname, "yougile" + ext);
+
+try {
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.status !== undefined) {
+    process.exit(err.status);
+  }
+  throw err;
+}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "yougile-cli",
+  "version": "0.8.2",
+  "description": "CLI утилита для работы с YouGile API из командной строки",
+  "keywords": [
+    "yougile",
+    "cli",
+    "task-management",
+    "project-management",
+    "api",
+    "typescript"
+  ],
+  "homepage": "https://gitverse.ru/onreza/yougile-toolkit",
+  "bugs": {
+    "url": "https://gitverse.ru/onreza/yougile-toolkit/tasktracker"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitverse.ru/onreza/yougile-toolkit.git"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "RainyPixel",
+    "url": "https://gitverse.ru/RainyPixel"
+  },
+  "type": "module",
+  "bin": {
+    "yougile": "bin/yougile.js"
+  },
+  "files": [
+    "bin",
+    "yougile.config.schema.json",
+    "README.md",
+    "LICENSE",
+    "scripts"
+  ],
+  "scripts": {
+    "dev": "bun run src/cli.ts",
+    "build": "bun run scripts/build.ts",
+    "build:native": "bun build src/cli.ts --compile --minify --outfile=dist/yougile",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "test": "bun test",
+    "postinstall": "node scripts/postinstall.js",
+    "release": "onreza-release",
+    "release:dry": "onreza-release --dry-run"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.13",
+    "@commitlint/cli": "^20.4.0",
+    "@commitlint/config-conventional": "^20.4.0",
+    "@commitlint/types": "^20.4.0",
+    "@types/bun": "^1.3.8",
+    "bunli": "0.5.1",
+    "onreza-release": "^2.2.0",
+    "lefthook": "^2.0.16"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@bunli/core": "^0.5.2",
+    "zod": "^4.3.6"
+  }
+}

package/scripts/build.ts

@@ -0,0 +1,74 @@
+#!/usr/bin/env bun
+/**
+ * Скрипт сборки standalone бинарников для всех платформ
+ * Использует bun build --compile напрямую
+ */
+
+import { $ } from "bun";
+
+const ENTRY = "./src/cli.ts";
+const OUTDIR = "./dist";
+const TARGETS = [
+	"bun-linux-x64",
+	"bun-darwin-arm64",
+	"bun-windows-x64",
+];
+
+// Маппинг bun targets на имена платформ (совместимые с onreza-release)
+const TARGET_MAP: Record<string, string> = {
+	"bun-linux-x64": "linux-x64",
+	"bun-darwin-arm64": "darwin-arm64",
+	"bun-windows-x64": "win32-x64",
+};
+
+async function build() {
+	console.log("🔨 Building standalone binaries...\n");
+
+	// Очищаем dist
+	await $`rm -rf ${OUTDIR}`;
+	await $`mkdir -p ${OUTDIR}`;
+
+	for (const target of TARGETS) {
+		const dirName = TARGET_MAP[target];
+		const isWindows = target.includes("windows");
+		const binName = isWindows ? "cli.exe" : "cli";
+		const outPath = `${OUTDIR}/${dirName}/${binName}`;
+
+		console.log(`  📦 ${target}...`);
+
+		try {
+			await $`bun build ${ENTRY} --compile --minify --target=${target} --outfile=${outPath}`.quiet();
+			console.log(`     ✅ ${outPath}`);
+		} catch (error) {
+			console.error(`     ❌ Failed: ${error}`);
+			process.exit(1);
+		}
+	}
+
+	console.log("\n📦 Creating archives...\n");
+
+	for (const target of TARGETS) {
+		const dirName = TARGET_MAP[target];
+		const archiveName = `${dirName}.tar.gz`;
+
+		console.log(`  📦 ${archiveName}...`);
+
+		try {
+			await $`tar -czf ${OUTDIR}/${archiveName} -C ${OUTDIR} ${dirName}`.quiet();
+			// Удаляем директорию после архивации
+			await $`rm -rf ${OUTDIR}/${dirName}`.quiet();
+			console.log(`     ✅ ${archiveName}`);
+		} catch (error) {
+			console.error(`     ❌ Failed: ${error}`);
+			process.exit(1);
+		}
+	}
+
+	console.log("\n✅ Build complete!\n");
+
+	// Показываем размеры
+	const files = await $`ls -lh ${OUTDIR}/*.tar.gz`.text();
+	console.log(files);
+}
+
+build();

package/scripts/postinstall.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+"use strict";
+
+const { platform, arch } = process;
+const https = require("https");
+const http = require("http");
+const { createWriteStream, chmodSync, mkdirSync } = require("fs");
+const { join } = require("path");
+const { createGunzip } = require("zlib");
+const tar = require("tar");
+
+const MANIFEST = {
+  "assets": {
+    "linux-x64": "https://gitverse.ru/sc/sbt/api/v1/attachments/2ffa1246-98b0-4953-a1c0-8caebe256d15",
+    "darwin-arm64": "https://gitverse.ru/sc/sbt/api/v1/attachments/6c6d1443-6a48-4d80-8889-66faf0a4b33e",
+    "win32-x64": "https://gitverse.ru/sc/sbt/api/v1/attachments/1fd283b0-4fbc-4caf-9c76-279607565bc5"
+  },
+  "binName": "yougile",
+  "version": "0.8.2"
+};
+
+const platformKey = `${platform}-${arch}`;
+const downloadUrl = MANIFEST.assets[platformKey];
+
+if (!downloadUrl) {
+  console.warn(`⚠️  No binary available for ${platformKey}, skipping installation`);
+  console.warn(`   Supported platforms: ${Object.keys(MANIFEST.assets).join(", ")}`);
+  process.exit(0);
+}
+
+const binDir = join(__dirname, "..", "bin");
+mkdirSync(binDir, { recursive: true });
+
+/**
+ * Downloads and extracts a tar.gz archive
+ */
+function download(url, redirectCount = 0) {
+  if (redirectCount > 5) {
+    return Promise.reject(new Error("Too many redirects"));
+  }
+
+  return new Promise((resolve, reject) => {
+    const protocol = url.startsWith("https") ? https : http;
+
+    const request = protocol.get(url, (res) => {
+      // Handle redirects
+      if (res.statusCode === 301 || res.statusCode === 302 || res.statusCode === 307 || res.statusCode === 308) {
+        const location = res.headers.location;
+        if (!location) {
+          reject(new Error("Redirect without location header"));
+          return;
+        }
+        download(location, redirectCount + 1).then(resolve).catch(reject);
+        return;
+      }
+
+      if (res.statusCode !== 200) {
+        reject(new Error(`Download failed: HTTP ${res.statusCode}`));
+        return;
+      }
+
+      res
+        .pipe(createGunzip())
+        .pipe(tar.extract({ cwd: binDir }))
+        .on("finish", resolve)
+        .on("error", reject);
+    });
+
+    request.on("error", reject);
+    request.setTimeout(30000, () => {
+      request.destroy();
+      reject(new Error("Download timeout"));
+    });
+  });
+}
+
+console.log(`📦 Installing ${MANIFEST.binName} for ${platformKey}...`);
+
+download(downloadUrl)
+  .then(() => {
+    const binPath = join(binDir, MANIFEST.binName);
+    if (platform !== "win32") {
+      try {
+        chmodSync(binPath, 0o755);
+      } catch (e) {
+        // Ignore chmod errors on some platforms
+      }
+    }
+    console.log(`✅ Installed ${MANIFEST.binName} v${MANIFEST.version}`);
+  })
+  .catch((err) => {
+    console.error(`❌ Failed to install binary: ${err.message}`);
+    console.error(`   URL: ${downloadUrl}`);
+    process.exit(1);
+  });

package/yougile.config.schema.json

@@ -0,0 +1,29 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"additionalProperties": false,
+	"description": "Configuration file for YouGile CLI toolkit",
+	"properties": {
+		"apiKey": {
+			"default": "",
+			"description": "API Key (generated by 'yougile auth' command)",
+			"type": "string"
+		},
+		"companyId": {
+			"description": "Company ID (UUID format)",
+			"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
+			"type": "string"
+		},
+		"userId": {
+			"description": "User email address",
+			"format": "email",
+			"type": "string"
+		},
+		"userPassword": {
+			"description": "User password",
+			"type": "string"
+		}
+	},
+	"required": ["companyId", "userId", "userPassword"],
+	"title": "YouGile Toolkit Configuration",
+	"type": "object"
+}