@nan0web/release 1.0.0

package/bin/lib/functions.test.js

@@ -0,0 +1,138 @@
+import { describe, it } from 'node:test'
+import assert from 'node:assert'
+import { existsSync, writeFileSync, unlinkSync, mkdirSync, readFileSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawnSync } from 'node:child_process'
+
+import {
+	getPackageManagerCommands,
+	checkPackageJson,
+	checkPreCommits,
+	runCommand,
+	checkUncommitted,
+	tagExists,
+	tagRelease,
+	detectPackageManager,
+} from './functions.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const tempDir = resolve(__dirname, 'temp')
+const tempPackageJson = resolve(tempDir, 'package.json')
+
+describe('functions.js', () => {
+	// Setup temporary directory and package.json for testing
+	if (!existsSync(tempDir)) mkdirSync(tempDir)
+	writeFileSync(tempPackageJson, JSON.stringify({ name: 'test-package' }))
+
+	it('detectPackageManager returns correct package manager', () => {
+		// Create temporary lock files to simulate package managers
+		const pnpmLock = resolve(tempDir, 'pnpm-lock.yaml')
+		const yarnLock = resolve(tempDir, 'yarn.lock')
+
+		writeFileSync(pnpmLock, '')
+		assert.strictEqual(detectPackageManager(), 'pnpm')
+		unlinkSync(pnpmLock)
+
+		writeFileSync(yarnLock, '')
+		assert.strictEqual(detectPackageManager(), 'yarn')
+		unlinkSync(yarnLock)
+
+		// Default case (npm)
+		assert.strictEqual(detectPackageManager(), 'npm')
+	})
+
+	it('getPackageManagerCommands returns correct commands', () => {
+		const pnpmCommands = getPackageManagerCommands('pnpm')
+		assert.ok(pnpmCommands.cacheClean)
+		assert.ok(pnpmCommands.install)
+		assert.ok(pnpmCommands.update)
+		assert.ok(pnpmCommands.prune)
+		assert.ok(pnpmCommands.outdated)
+		assert.ok(pnpmCommands.build)
+		assert.ok(pnpmCommands.lint)
+		assert.ok(pnpmCommands.test)
+		assert.ok(pnpmCommands.list)
+		assert.ok(pnpmCommands.storeStatus)
+	})
+
+	it('checkPackageJson validates required scripts and dependencies', () => {
+		const result = checkPackageJson(tempPackageJson, true)
+		assert.strictEqual(result, 0)
+
+		const pkg = JSON.parse(readFileSync(tempPackageJson, 'utf8'))
+		assert.ok(pkg.scripts.dev)
+		assert.ok(pkg.scripts.build)
+		assert.ok(pkg.scripts.preview)
+		assert.ok(pkg.scripts.test)
+		assert.ok(pkg.scripts.clean)
+		assert.ok(pkg.devDependencies.husky)
+	})
+
+	it('checkPreCommits handles missing pre-commit file', () => {
+		const result = checkPreCommits(tempPackageJson, true)
+		assert.strictEqual(result, 0)
+
+		const huskyDir = resolve(tempDir, '.husky')
+		const preCommitFile = resolve(huskyDir, 'pre-commit')
+		assert.ok(existsSync(preCommitFile))
+	})
+
+	it('runCommand executes shell commands', () => {
+		// This test will pass if the command runs successfully
+		assert.doesNotThrow(() => {
+			runCommand('echo "test"', 'Failed to echo')
+		})
+	})
+
+	it('checkUncommitted validates git status', () => {
+		// This test assumes no uncommitted changes in the test environment
+		assert.doesNotThrow(() => {
+			checkUncommitted({ devDependencies: {}, dependencies: {} })
+		})
+	})
+
+	it('tagExists checks for existing git tags', () => {
+		// Assuming no tags exist initially
+		assert.strictEqual(tagExists('v0.0.0'), false)
+	})
+
+	it('tagRelease creates and pushes git tags', () => {
+		// Mock version for testing
+		const version = '0.0.1-test'
+		const tag = `v${version}`
+
+		// Create tag
+		spawnSync('git', ['tag', '-a', tag, '-m', `Release version ${version}`], { cwd: tempDir })
+
+		// Test tag exists
+		assert.strictEqual(tagExists(tag), true)
+
+		// Clean up tag
+		spawnSync('git', ['tag', '-d', tag], { cwd: tempDir })
+	})
+
+	it('tagRelease handles existing tags', () => {
+		const version = '0.0.2-test'
+		const tag = `v${version}`
+
+		// Create tag first
+		spawnSync('git', ['tag', '-a', tag, '-m', `Release version ${version}`], { cwd: tempDir })
+
+		// Should not create tag again
+		const logger = new Logger({ level: 'info' })
+		const originalLog = logger.warn
+		let warnCalled = false
+		logger.warn = () => { warnCalled = true }
+
+		tagRelease(version)
+		assert.ok(warnCalled)
+
+		// Clean up tag
+		spawnSync('git', ['tag', '-d', tag], { cwd: tempDir })
+	})
+
+	// Cleanup
+	unlinkSync(tempPackageJson)
+})

package/bin/nan0release.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+import process from "node:process"
+import { Command } from "@nan0web/co"
+import Logger from '@nan0web/log'
+import PublishCommand from "../src/commands/PublishCommand.js"
+
+class PrefixedLogger extends Logger {
+	static PREFIX = Logger.style("nan0release", { bgColor: "magenta", color: "white" })
+	get PREFIX() {
+		return /** @type {typeof PrefixedLogger} */ (this.constructor).PREFIX
+	}
+	info(...args) {
+		return super.info(this.PREFIX, ...args)
+	}
+	error(...args) {
+		return super.error(this.PREFIX, ...args)
+	}
+	warn(...args) {
+		return super.warn(this.PREFIX, ...args)
+	}
+	success(...args) {
+		return super.success(this.PREFIX, ...args)
+	}
+	debug(...args) {
+		return super.debug(this.PREFIX, ...args)
+	}
+}
+
+const logger = new PrefixedLogger(Logger.detectLevel(process.argv))
+
+const mainCommand = new Command({
+	name: "nan0release",
+	help: "Release utilities for nan0web packages",
+	logger,
+	subcommands: [
+		new PublishCommand({ logger }),
+	]
+})
+
+async function main(argv = []) {
+	const msg = mainCommand.parse(argv.slice(2))
+	logger.log(Logger.style(Logger.LOGO, { color: "magenta" }))
+
+	if (msg.subCommand) {
+		const cmd = mainCommand.getCommand(msg.subCommand)
+		await cmd.run(msg.subCommandMessage)
+	} else {
+		logger.info(mainCommand.runHelp())
+	}
+}
+
+main(process.argv).catch(err => {
+	logger.error("❌ Unhandled error:", err.message || err)
+	if (err.stack) logger.debug(err.stack)
+	process.exit(1)
+})

package/bin/release.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+import ReleaseCLI from '../src/ReleaseCLI.js'
+
+/**
+ * Entry point for the release CLI application
+ */
+const cli = new ReleaseCLI()
+cli.run(process.argv.slice(2)).catch(error => {
+	console.error(error)
+	process.exit(1)
+})

package/bin/release.test.js

@@ -0,0 +1,73 @@
+import { describe, it } from 'node:test'
+import assert from 'node:assert/strict'
+import FS from "@nan0web/db-fs"
+import { existsSync, writeFileSync, unlinkSync, mkdirSync, readFileSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import main from './release.js'
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = dirname(__filename)
+const tempDir = resolve(__dirname, 'temp')
+const tempPackageJson = resolve(tempDir, 'package.json')
+
+const fs = new FS()
+
+describe('release.js', async () => {
+	await fs.connect()
+	const tempDir = "tmp/release"
+	const db = fs.extract(tempDir)
+	await db.writeDocument("package.json", {
+		name: 'test-package',
+		version: '0.0.1-test'
+	})
+
+	// Mock process.cwd to return tempDir
+	const originalCwd = process.cwd
+	process.cwd = () => tempDir
+
+	it('main function processes release command', async () => {
+		// Test with ignore flags to avoid actual git operations
+		const result = await main(['--ignore-uncommitted', '--ignore-fail-tests', '--ignore-tag'])
+		assert.ok(result.includes('Release completed'))
+	})
+
+	it('main function processes prepare command', async () => {
+		const resultP= await main(['prepare'])
+		assert.ok(result.includes('Prepare completed'))
+	})
+
+	it('ReleaseCommand handles package.json validation', async () => {
+		// Create a package.json without required scripts
+		writeFileSync(tempPackageJson, JSON.stringify({
+			name: 'test-package',
+			version: '0.0.1-test'
+		}))
+
+		// Should exit with error when missing scripts
+		try {
+			await main(['--ignore-uncommitted', '--ignore-fail-tests', '--ignore-tag'])
+			assert.fail('Should have exited with error')
+		} catch (err) {
+			assert.ok(err.message.includes('Missing required scripts'))
+		}
+
+		// Should fix when --fix flag is used
+		const result = await main(['--ignore-uncommitted', '--ignore-fail-tests', '--ignore-tag', '--fix'])
+		assert.ok(result.includes('Release completed'))
+
+		// Verify package.json was fixed
+		const pkg = JSON.parse(readFileSync(tempPackageJson, 'utf8'))
+		assert.ok(pkg.scripts.dev)
+		assert.ok(pkg.scripts.build)
+		assert.ok(pkg.scripts.preview)
+		assert.ok(pkg.scripts.test)
+		assert.ok(pkg.scripts.clean)
+		assert.ok(pkg.devDependencies.husky)
+	})
+
+	// Cleanup
+	process.cwd = originalCwd
+	await db.dropDocument("package.json")
+})

package/bin/temp/package.json

@@ -0,0 +1 @@
+{"name":"test-package","version":"0.0.1-test"}

package/docs/system.uk.md

@@ -0,0 +1,413 @@
+# 🤙 `system.md` — специфікація проєкту `@nan0web/release`
+
+<blockquote style="padding: 2rem 1rem; background-image: linear-gradient(33deg, #00f6, #ff03)">
+<ul>
+<li>Прогрес — це пройдені тести.</li>
+<li>Правда знаходиться в Git.</li>
+<li>Ідентичність підтверджена підписом.</li>
+<li>Дисципліна — це любов.</li>
+</ul>
+</blockquote>
+
+Це канонічна специфікація для **`nan0web/release`**:  
+Лаконічна, орієнтована на тести, система управління проєктами, створена для Git.
+
+Створена для розумних команд, які цінують **правду, чіткість і завершеність**.
+
+---
+
+## 🎯 Ціль
+
+Замінити припущення в управлінні проєктами на **виконувану правду**.
+
+Визначати кожне завдання, команду та схвалення в коді — а потім дозволити тестам і підписам **підтвердити прогрес**.
+
+Без нарад. Без оновлень. Без слів.
+
+Лише те, що пройшло, що підписано і що закомічено.
+
+---
+
+## 🧘‍♂️ Філософія
+
+1. **Лаконічність > Складність**  
+   Мінімальна структура. Максимальна чіткість.
+
+2. **Код > Завдання**  
+   Завдання живуть в Git. Якщо не протестовано — не виконано.
+
+3. **Прогрес через тести**  
+   Статус завдання = результат тесту. Ніяких ручних оновлень.
+
+4. **Асинхронна комунікація**  
+   Чат є архівним. Виживають лише рішення.
+
+5. **Робота офлайн, працюємо з Git**  
+   Працюємо без інтернету. Випускаємо з інтегритетом.
+
+6. **Ідентичність доведена**  
+   Ти — той, за кого ти підписуєшся — не той, ким ти себе називаєш.
+
+7. **Команда – це клас**  
+   Ролі, контакти, очікування — все визначено в коді.
+
+8. **Ти — те, що ти випускаєш**  
+   Твій результат — це твоя репутація. Git це доводить.
+
+> _"Будь правдивим. Роби. Вчись. Повторюй."_
+
+---
+
+## 📁 Структура даних
+
+```
+releases/
+  1/
+    0/
+      v1.0.0/                           ← Корінь релізу
+        release.md                      ← Нотатки до релізу (завдання, розділи)
+        release.js                      ← Команда, ролі, конфігурація (клас Release)
+        release.test.js                 ← Набір тестів (вхідна точка CI)
+        test/
+          {username}/                   ← Опціональний простір
+            tasks.test.js               ← Користувацькі тести
+        chat/                           ← Обговорення релізу
+          2025/08/18/
+            162000420.{username}.md     ← Повідомлення (часова мітка + користувач)
+        task/
+          ux.logo/                      ← Завдання за slug
+            config.json                 ← { assignee, priority, dependsOn }
+            approved/
+              ceo.json                  ← Запис схвалення (GPG-підписаний)
+            chat/
+              2025/08/18/
+                162000420.{username}.md ← Повідомлення по конкретному завданню
+        assets/                         ← Дизайни, документи, результати
+        retro.md                        ← Фінальне спостереження (запечатаний)
+        .cache/                         ← gitignored: стан читання, сесія
+
+.recover/{username}/                    ← Оголошення втрати ключа
+.well-known/keys.json                   ← Реєстр публічних ключів
+.nanorc.js                              ← Конфігурація проєкту (необов'язкова)
+```
+
+> ✅ Усі дані під контролем версій, перевіряються, повторювані.
+
+---
+
+## 🔄 Робочий процес
+
+```mermaid
+flowchart TD
+    A[Початок релізу] --> B[Визначення команди в release.js]
+    B --> C[Написання release.md з завданнями]
+    C --> D[Написання release.test.js або test/@user/tasks.test.js]
+    D --> E[Commit → CI запускає тести]
+    E --> F{Тести пройшли?}
+    F -->|Ні| G[Блокування CI, невиконаний реліз]
+    F -->|Так| H[Завдання виконане]
+    H --> I[Оновити поступ, ETA]
+    I --> J[Чат: Обговорення заклинених завдань асинхронно]
+    J --> K[Схвалення: Файл в approved/ceo.json]
+    K --> L[Усі тести пройшли → Тег v1.0.0]
+    L --> M[Запечатати реліз, написати retro.md]
+```
+
+Основні правила:
+
+- Немає завдання "виконане" доки тесту не пройшов
+- Немає випуску без тегу
+- Немає схвалення без `.json` файлу і підтвердженням ідентичності
+
+---
+
+## 🔐 Ідентичність та GPG Підпис
+
+### 🔑 Чому GPG?
+
+GPG дає **криптографічне підтвердження** того, хто зробив коміт чи схвалення.
+
+Це не опціонально.  
+Це **основа довіри**.
+
+### ✅ Налаштування GPG Ключа (в кожному repo)
+
+1. **Генерація GPG ключа**
+
+   ```bash
+   gpg --full-generate-key
+   ```
+
+   - Type: `1` (RSA and RSA)
+   - Size: `4096`
+   - Expires: `0` (ніколи)
+   - Name: `UserName`
+   - Email: `email@example.com`
+
+2. **Перегляд ключів**
+
+   ```bash
+   gpg --list-secret-keys --keyid-format=long
+   ```
+
+   Отримаємо:
+
+   ```
+   sec   rsa4096/ABC123456789 2025-01-01 [SC]
+         Key fingerprint = 123A 456B 789C ...
+   uid                 [ultimate] UserName <email@example.com>
+   ```
+
+3. **Налаштування Git (в кожному repo)**
+
+   ```bash
+   cd /path/to/your/repo
+
+   git config user.name "UserName"
+   git config user.email "email@example.com"
+   git config user.signingkey ABC123456789
+   git config commit.gpgsign true
+   ```
+
+4. **Тест коміту з підписом**
+
+   ```bash
+   git commit -S -m "First signed commit"
+   ```
+
+   > Вас попросять passphrase.
+
+5. **Перевірка підпису**
+   ```bash
+   git log --show-signature -1
+   ```
+   Перевірити:
+   ```
+   gpg: Good signature from "UserName <email@example.com>"
+   ```
+
+> ❗ Ніколи не використовуйте `--global` для `user.signingkey` або `commit.gpgsign`  
+> Ідентичність залежить від **контексту** — одне repo, одна роль, один ключ.
+
+---
+
+## 🔄 Втрата ключа: Відновлення ідентичності
+
+**Ви не можете відновити втрачений приватний ключ.**  
+Але ви можете довести перехід.
+
+### 3-крокова процедура відновлення
+
+#### 1. **Написати декларацію переходу (якщо можливо)**
+
+Якщо ще маєте доступ до старого ключа, підпишіть:
+
+```text
+Я, UserName <email@example.com>, володів GPG ключем: ABC123456789
+Станом на 2025-08-20, я втратив доступ до нього.
+Мій новий ключ: DEF987654321
+Підписано: [GPG clearsign цього повідомлення зі старим ключем]
+```
+
+Записується як:
+
+```
+.recover/username/rotation-2025-08-20.md
+```
+
+#### 2. **Оновлення ідентичності в проєкті**
+
+```js
+// releases/1/0/v1.0.0.js
+class Members {
+	static UserName = new Person({
+		name: "UserName",
+		contacts: [new Contact("https://example.com")],
+		gpgKey: "DEF987654321", // новий ключ
+		revokedKey: "ABC123456789", // старий, втрачений ключ
+	});
+}
+```
+
+Або в `.well-known/keys.json`:
+
+```json
+{
+	"user": "ya.raslove",
+	"currentKey": "DEF987654321",
+	"revokedKeys": [
+		{
+			"key": "ABC123456789",
+			"revokedAt": "2025-08-20",
+			"proof": "/recovery/ya.raslove/rotation-2025-08-20.md"
+		}
+	]
+}
+```
+
+#### 3. **CI валідує перехід**
+
+На першому коміті з новим ключем:
+
+- CI перевіряє валідність ключа
+- Шукає доказ переходу
+- Блокує, якщо ключ непідписаний або без пояснення
+
+---
+
+## 🛠 CLI Команди
+
+| Команда                                            | Опис                       |
+| -------------------------------------------------- | -------------------------- |
+| `nan0release`                                      | Показ статуса релізу       |
+| `nan0release v1.0.0`                               | Показ конкретного релізу   |
+| `nan0release ls`                                   | Список релізів              |
+| `nan0release todo`                                 | Список моїх завдань        |
+| `nan0release todo > todo.md`                       | Експорт завдань            |
+| `nan0release chat write "msg"`                     | Написати у загальний чат   |
+| `nan0release chat write ux.logo "help needed"`    | Написати у конкретний чат |
+| `nan0release validate`                             | Перевірити структуру, тести, GPG |
+| `nan0release serve`                                | Запустити локальний сервер |
+| `nan0release host --webui`                         | Хостити онлайн з автентифікацією |
+| `nan0release init v1.0.0`                          | Створити новий реліз       |
+| `nan0release seal v1.0.0`                          | Зробити реліз незмінним    |
+
+> Усі команди працюють з CI. Вивід через `--json`, `--quiet`.
+
+---
+
+## 🧪 Життєвий цикл завдання
+
+| Стан               | Як реалізовано                          |
+| ------------------ | ---------------------------------------- |
+| `todo`             | Тест визначено через `it.todo()`         |
+| `in-progress`      | Тест написано, але не пройшов            |
+| `done`             | Тест пройдено, жодних ручних оновлень    |
+| `blocked`          | Залежить від іншого завдання/схвалення   |
+| `skipped`          | `it.skip()` — рідко використовується    |
+
+Статус є **виводимий**, ніколи не написаний.
+
+---
+
+## ✅ Система схвалення
+
+Схвалення — це **GPG-підписані JSON файли**:
+
+```
+task/ux.logo/approved/ceo.json
+```
+
+```json
+{
+	"by": "UserName <email@example.com>",
+	"sign": "gpg:DEF987654321",
+	"time": "2025-08-20T12:00:00Z"
+}
+```
+
+Тестування:
+
+```js
+it("CEO approved logo", () => {
+	expect(fileExists("task/ux.logo/approved/ceo.json")).toBe(true);
+});
+```
+
+Дозволяється кілька схвалень:
+
+- `ceo.json`, `cfo.json`, `legal.json`
+
+CI перевіряє наявність файлу — **ви доводите це**.
+
+---
+
+## 🔒 Валідація на коміт
+
+Git hook (через `husky` або `simple-git-hooks`) запускає:
+
+```bash
+nan0release validate
+```
+
+Помилка, якщо:
+
+- Завдання згадано, але немає тестів
+- Виконавець не існує в `release.js`
+- Відсутній GPG підпис на важливому коміті
+- Ключ — не поточний
+- Спроба редагування пройденого завдання
+
+Блокує `git commit` до виправлення.
+
+> Правда підтверджена в джерелах.
+
+---
+
+## 🌐 Хостинг та інтерфейс
+
+### `nan0release serve`
+
+- Запускає локальний сервер
+- Подає WebUI (`@nan0web/release-ui-lit`)
+- Індекс у пам’яті для пошуку
+- Без автентифікації (лише локально)
+
+### `nan0release host --webui`
+
+- Хостується онлайн
+- Вимагає GPG автентифікації (через challenge-response)
+- Синхронує `.cache` з Redis (необов’язково)
+- WebSockets для миттєвих оновлень
+
+> UI = ті ж дані, що й CLI. Лише візуалізація.
+
+---
+
+## 🧩 `.nan0rc.js` (Необов’язково)
+
+```js
+// .nanorc.js
+export default {
+	git: {
+		user: "UserName",
+		email: "email@example.com",
+		signingKey: "ABC123456789",
+		gpgsign: true,
+	},
+	hooks: {
+		"on-release-done": "git tag v1.0.0",
+		"on-task-fail": "echo @pm: task failure",
+	},
+};
+```
+
+Використовується:
+
+```bash
+nan0release init --trust-config
+```
+
+---
+
+## Формат нотаток релізу
+
+- `h1` - версія і дата релізу `# vX.Y.Z - YYYY-MM-DD`
+- `h2` - розділ релізу
+- `h3` - заголовок завдання з його описом
+
+---
+
+## 📜 Остаточна правда
+
+> **Проєкт не той, який ви сказали.**  
+> **Він той, який тести пройшли.**  
+> **Він той, який коміти що демонструють.**  
+> **Він той, який підписи підтверджують.**
+
+`nan0web/release` — це не інструмент.  
+Це **система дисципліни** для тих, хто шукає майстерності.
+
+Починайте з малого.  
+Будьте правдивими.  
+Робіть релізи.