@nan0web/release 1.0.1 → 1.0.3

package/README.md

@@ -1,8 +1,6 @@
 # @nan0web/release
 
-|Package name|[Status](https://github.com/nan0web/monorepo/blob/main/system.md#написання-сценаріїв)|Documentation|Test coverage|Features|Npm version|
-|---|---|---|---|---|---|
- |[@nan0web/release](https://github.com/nan0web/release/) |🟢 `97.1%` |🧪 [English 🏴󠁧󠁢󠁥󠁮󠁧󠁿](https://github.com/nan0web/release/blob/main/README.md)<br />[Українською 🇺🇦](https://github.com/nan0web/release/blob/main/docs/uk/README.md) |🟡 `84.2%` |✅ d.ts 📜 system.md 🕹️ playground |— |
+<!-- %PACKAGE_STATUS% -->
 
 Project management as code, Git-native, GPG-signed, and test-driven.
 
@@ -44,7 +42,7 @@ How to initialize a new release version?
 release init v1.0.0
 ```
 
-const cli = new ReleaseCLI()
+const cli = ReleaseCLi()
 Show release details:
 
 How to show release information?
@@ -53,8 +51,8 @@ release show [--full]
 ```
 
 const release = new Release({
-version: "v1.0.0",
-createdAt: new Date("2025-08-20")
+version: 'v1.0.0',
+createdAt: new Date('2025-08-20'),
 })
 console.info(release.version) // v1.0.0
 List all releases in the project:
@@ -64,7 +62,7 @@ How to list all releases?
 release list [--json]
 ```
 
-const cli = new ReleaseCLI()
+const cli = ReleaseCLi()
 Add a chat message to the current release:
 
 How to write a release chat message?
@@ -72,7 +70,7 @@ How to write a release chat message?
 release chat write --user alice "Issue with the build pipeline"
 ```
 
-const cli = new ReleaseCLI()
+const cli = ReleaseCLi()
 Host a static server for viewing releases:
 
 How to host release UI?
@@ -80,7 +78,7 @@ How to host release UI?
 release host [--webui] [--port 3000]
 ```
 
-const cli = new ReleaseCLI()
+const cli = ReleaseCLi()
 Serve all release files for local inspection:
 
 How to serve release static assets?
@@ -88,7 +86,7 @@ How to serve release static assets?
 release serve [--port 8080]
 ```
 
-const cli = new ReleaseCLI()
+const cli = ReleaseCLi()
 Validate release tasks and integrity:
 
 How to validate release tasks?
@@ -97,8 +95,8 @@ release validate [--ignore-fail]
 ```
 
 const release = new Release({
-version: "v1.0.0",
-createdAt: new Date("2025-08-20")
+version: 'v1.0.0',
+createdAt: new Date('2025-08-20'),
 })
 Seal the release with retro reflection:
 
@@ -107,7 +105,7 @@ How to seal a release?
 release seal [--message "All core APIs are stable and tested"]
 ```
 
-const cli = new ReleaseCLI()
+const cli = ReleaseCLi()
 ## Core Concepts
 
 ### 1. Release as Object
@@ -123,12 +121,11 @@ How to instantiate a Release?
 ```js
 import { Release } from '@nan0web/release'
 const release = new Release({
-	version: "v1.0.0",
-	createdAt: "2025-08-20T10:00:00Z"
+	version: 'v1.0.0',
+	createdAt: '2025-08-20T10:00:00Z',
 })
 console.info(release.version) // ← v1.0.0
 console.info(release.createdAt instanceof Date) // ← true
-
 ```
 ### 2. Release Document Parsing
 
@@ -141,19 +138,15 @@ How to parse release notes markdown into structured data?
 ```js
 import { ReleaseDocument } from '@nan0web/release'
 const md = `# v1.0.0 - 2025-08-20
-
 ## Overview
 Release milestone includes UI polish and core API stabilization.
-
 ### Tasks
 ### Done **Implement core UI design** [ui.core-design]
 ### InProgress **Fix responsive issues in mobile layout** [ui.mobile-fixes]`
-
 const doc = ReleaseDocument.from(md)
 console.info(doc.version) // ← v1.0.0
 console.info(doc.date instanceof Date) // ← true
 console.info(doc.document.children instanceof Array) // ← true
-
 ```
 ### 3. Person & Team Structures
 
@@ -166,13 +159,12 @@ How to create a Person with typed properties?
 ```js
 import { Person } from '@nan0web/release'
 const person = new Person({
-	name: ["Alice", "Developer"],
-	gender: "female",
-	contacts: ["mailto:alice@example.com"]
+	name: ['Alice', 'Developer'],
+	gender: 'female',
+	contacts: ['mailto:alice@example.com'],
 })
 console.info(person.name.firstName) // ← Alice
 console.info(person.contacts.length >= 0) // ← true
-
 ```
 ## Architecture: Project Management as Code
 
@@ -187,21 +179,17 @@ How to register and validate tasks as tests?
 ```js
 import { ProjectManagement } from '@nan0web/release'
 const pm = new ProjectManagement()
-pm.registerTask("task-1", "./tests/task1.test.js")
-pm.registerTask("task-2", "./tests/task2.test.js")
-
+pm.registerTask('task-1', './tests/task1.test.js')
+pm.registerTask('task-2', './tests/task2.test.js')
 const mockResults = {
-	passed: ["task-1"],
+	passed: ['task-1'],
 	failed: [],
-	pending: ["task-2"]
+	pending: ['task-2'],
 }
-
 pm.validateProjectState = async () => mockResults
 const results = await pm.validateProjectState()
-
-console.info(results.passed.includes("task-1")) // ← true
-console.info(results.pending.includes("task-2")) // ← true
-
+console.info(results.passed.includes('task-1')) // ← true
+console.info(results.pending.includes('task-2')) // ← true
 ```
 ### Release Processing
 
@@ -216,14 +204,11 @@ How to execute a release after validation?
 import { ReleaseManager, ProjectManagement } from '@nan0web/release'
 const pm = new ProjectManagement()
 const rm = new ReleaseManager(pm)
-
-rm.calculateVersion = () => "v1.0.1"
+rm.calculateVersion = () => 'v1.0.1'
 rm.publish = async () => true
-
-const result = await rm.executeRelease("patch")
+const result = await rm.executeRelease('patch')
 console.info(result.version) // ← v1.0.1
 console.info(result.published) // ← true
-
 ```
 ### Changelog Integration
 
@@ -237,16 +222,13 @@ How to parse changelog and extract tasks?
 import { ChangelogTaskManager } from '@nan0web/release'
 const ctm = new ChangelogTaskManager()
 const changelog = `# Changelog
-
 ## [1.0.0] - 2025-08-20
 ### Added
 - Initial structure [core.init]
 - Release notes support [docs.release-notes]`
-
 const tasks = ctm.parseChangelog(changelog)
 console.info(Array.isArray(tasks)) // ← true
 console.info(tasks.length >= 0) // ← true
-
 ```
 ## Java•Script Features
 

package/bin/nan0release.js

@@ -1,57 +1,42 @@
 #!/usr/bin/env node
 
-import process from "node:process"
-import { Command } from "@nan0web/co"
+import process from 'node:process'
+
+import { OutputMessage } 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)
+import createReleaseCLI from '../src/ui/cli/ReleaseCLi.js'
+
+class OutputLogger extends Logger {
+	log(first, ...args) {
+		if (first && first instanceof OutputMessage) {
+			if (OutputMessage.TYPES.ERROR === first.type) {
+				return this.error(first.content, ...args)
+			} else if (OutputMessage.TYPES.WARNING === first.type) {
+				return this.warn(first.content, ...args)
+			} else if (OutputMessage.TYPES.SUCCESS === first.type) {
+				return this.success(first.content, ...args)
+			}
+			return this.info(first.content, ...args)
+		}
+		return super.log(first, ...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 }),
-	]
-})
+const logger = new OutputLogger(Logger.detectLevel(process.argv))
 
 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())
+	const cli = createReleaseCLI(argv, logger)
+	logger.info(Logger.style(Logger.LOGO, { color: Logger.MAGENTA }))
+
+	const stream = cli.run()
+	for await (const entry of stream) {
+		logger.info(entry)
 	}
 }
 
-main(process.argv).catch(err => {
-	logger.error("❌ Unhandled error:", err.message || err)
+main(process.argv.slice(2)).catch((err) => {
+	logger.error('❌ Unhandled error:', err.message || err)
 	if (err.stack) logger.debug(err.stack)
 	process.exit(1)
 })

package/package.json

@@ -1,43 +1,49 @@
 {
-	"name": "@nan0web/release",
-	"version": "1.0.1",
-	"description": "Project Management as Code, Git-Native, GPG-Signed, Test-Driven",
-	"main": "src/index.js",
-	"types": "types/index.d.ts",
-	"type": "module",
-	"bin": {
-		"nan0release": "./bin/nan0release.js",
-		"release": "./bin/release.js"
-	},
-	"scripts": {
-		"build": "tsc",
-		"clean": "rm -rf .cache/ && rm -rf dist/",
-		"clean:modules": "rm -rf node_modules",
-		"test": "node --test \"src/**/*.test.js\" | nan0test parse --fail",
-		"test:docs": "node --test \"src/README.md.js\"",
-		"test:release": "node --test \"releases/**/*.test.js\"",
-		"test:coverage": "node --experimental-test-coverage --test-coverage-include=\"src/**/*.js\" --test-coverage-exclude=\"src/**/*.test.js\" --test \"src/**/*.test.js\"",
-		"test:coverage:collect": "nan0test coverage",
-		"test:status": "nan0test status",
-		"release": "node ./bin/nan0release.js publish",
-		"precommit": "npm test",
-		"prepush": "npm test",
-		"prepare": "husky",
-		"playground": "node playground/main.js"
-	},
-	"dependencies": {
-		"@nan0web/changelog": "^0.1.0",
-		"@nan0web/co": "^1.0.0",
-		"@nan0web/db": "^1.0.0",
-		"@nan0web/db-fs": "^1.0.0",
-		"@nan0web/log": "^1.0.0",
-		"@nan0web/markdown": "^1.0.0",
-		"@nan0web/types": "^1.0.0",
-		"@nan0web/verse": "^1.0.0",
-		"supports-color": "^9.4.0"
-	},
-	"devDependencies": {
-		"@nan0web/test": "workspace:*",
-		"husky": "^9.1.7"
-	}
-}
+  "name": "@nan0web/release",
+  "version": "1.0.3",
+  "description": "Project Management as Code, Git-Native, GPG-Signed, Test-Driven",
+  "main": "src/index.js",
+  "types": "types/index.d.ts",
+  "type": "module",
+  "bin": {
+    "nan0release": "./bin/nan0release.js",
+    "release": "./bin/nan0release.js"
+  },
+  "dependencies": {
+    "@nan0web/changelog": "^1.0.0",
+    "@nan0web/co": "^2.0.0",
+    "@nan0web/db": "^1.3.3",
+    "@nan0web/db-fs": "^1.1.4",
+    "@nan0web/log": "^1.1.1",
+    "@nan0web/markdown": "^1.0.2",
+    "@nan0web/types": "^1.4.0",
+    "@nan0web/ui": "^1.8.0",
+    "@nan0web/ui-cli": "^2.9.0",
+    "@nan0web/verse": "^1.0.0",
+    "supports-color": "^10.2.2"
+  },
+  "devDependencies": {
+    "@nan0web/test": "^1.1.3",
+    "husky": "^9.1.7",
+    "knip": "^5.86.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf .cache/ && rm -rf dist/",
+    "clean:modules": "rm -rf node_modules",
+    "test": "node --test \"src/**/*.test.js\"",
+    "test1": "node --test \"src/**/*.test.js\" | nan0test parse --fail",
+    "test:docs": "node --test \"src/README.md.js\"",
+    "test:release": "node --test \"releases/**/*.test.js\"",
+    "test:coverage": "node --experimental-test-coverage --test-coverage-include=\"src/**/*.js\" --test-coverage-exclude=\"src/**/*.test.js\" --test \"src/**/*.test.js\"",
+    "test:coverage:collect": "nan0test coverage",
+    "test:status": "nan0test status",
+    "test:all": "npm run test && npm run test:docs && npm run build && npm run knip",
+    "test:all1": "npm run test && npm run test:docs && npm run test:status && npm run build",
+    "knip": "knip --production",
+    "release": "node ./bin/nan0release.js publish",
+    "precommit": "npm test",
+    "prepush": "npm test",
+    "playground": "node playground/main.js"
+  }
+}

package/project.yaml

@@ -0,0 +1,79 @@
+---
+metadata:
+  description: ""
+  tags: []
+  status: planned
+  locale: uk
+sections:
+  - title: "🧭 Фаза 1: Філософія та Абстракція (The Seed)"
+    content:
+      - "**Місія:** Управління проєктами як код (Project Management as Code). Ми відмовляємось від зовнішніх трекерів задач (Jira, Trello). Проєкт — це набір технічних **контрактів**, які проходять шлях від наміру до імплементації, забезпечуючи реальний статус прогресу автоматично."
+      - "**Базова Абстракція:** Пакет відповідає за логіку та CLI, яка читає Markdown, генерує контракти (`.spec.js`), а потім закриває їх як тести (`.test.js`) з подальшою вічною регресією (тести копіюються в кодову базу)."
+      - "**Глосарій:**"
+      - "- **Release Document**: `release.md` з ТЗ та відомостями про команду."
+      - "- **WIP Контракт**: `*.spec.js`, який падає/у стані `todo`, доки задачу не взяли і не зробили. Оновлює прогрес автоматично при виконанні."
+      - "- **Закритий Контракт**: `*.test.js` (результат команди `close`). Він стає законом і гарантує регресію через `pnpm test`."
+      - "---"
+    tasks: []
+  - title: "📐 Фаза 2: Доменне Моделювання (Data-Driven Models)"
+    content:
+      - "Сутності і моделі, які керують процесом релізу, не мають жорсткої прив'язки до вебу, але описуються як чисті об'єкти:"
+      - "- `Release`: Координує стан (версія, час початку, час завершення)."
+      - "- `ReleaseDocument`: Структурує Markdown у модель (дістає задачі)."
+      - "- `Person`: Типізована перевірка того, хто схвалив дії (через GPG або JSON підпис)."
+      - "- `Scanner`: Абстракція доступу до файлової системи (`releases/`)."
+      - "Статуси відстежуються динамічно через статус тестів: `it.todo` -> `it.skip` -> `it()`."
+      - "---"
+    tasks: []
+  - title: "🛠 Фаза 3: Верифікація Логіки (CLI-First)"
+    content:
+      - "Уся бізнес-логіка @nan0web/release 100% покривається Unit-тестами та CLI командами. Жодного веб-коду. Використовуємо Message-based архітектуру `@nan0web/ui-cli`."
+      - "1. **Команди CLI (`bin/nan0release.js`):**"
+      - "- `deps`, `publish` (реалізовані)."
+      - "- Заплановані (`init`, `spec`, `close`, `status`) інкапсулюють керування `Scanner` та `Release` моделями."
+      - "2. **Contract Lifecycle (Автоматизація прогресу):**"
+      - "- На старті `.spec.js` мають `it.todo()` → задача в беклозі."
+      - "- Коли розробник бере задачу → генерує логіку, змінює на `it()`. При коміті реальний прогрес проекту видно \"зеленим\"."
+      - "- `nan0release close` перейменовує `spec → test` і переносить його в `src/releases/` для 100% автоматичної регресії."
+      - "---"
+    tasks: []
+  - title: "🪐 Фаза 4: Sovereign Workbench (The Master IDE)"
+    content:
+      - "_(Для цього пакету застосовується опціонально, оскільки тут CLI-First)_"
+      - "Пакет `release` є постачальником даних для інших Sandbox-середовищ, де може виводитись:"
+      - "- Dashboard релізу (таблиці статусів `wip/closed/mixed`)."
+      - "- Для цього ми генеруємо `.datasets/README.dataset.jsonl` за допомогою `test:docs`, щоб створювати машиночитабельні знання для LLM-агентів для донавчання або можна користуватись README.md як індексу у реальному часі."
+      - "---"
+    tasks: []
+  - title: "🎨 Фаза 5: Тематизація та Інтерфейс (Theming)"
+    content:
+      - "_(Може застосовуватися при запуску HTML звітів про реліз або Dashboard)_"
+      - "Логіка `release UI` (якщо така з'явиться у додатку `@nan0web/release.app`), буде імпортувати компоненти з `@nan0web/ui-lit` зі строгим слідуванням CSS-змінним (напр. `--co` для кольорів бренду) без створення кастомних стилів."
+      - "---"
+    tasks: []
+  - title: "🏁 Чек-лист готовності пакету (Definition of Done)"
+    content: []
+    tasks:
+      - title: "General"
+        content: []
+        items:
+          - text: "Визначена місія та філософія у `system.md` та `project.md`."
+            completed: true
+          - text: "Робота з Markdown-нотатками та базова доменна логіка (`Scanner`, `Release`)."
+            completed: true
+          - text: "Атомарна операція закриття контрактів (`Scanner.close()`)."
+            completed: true
+          - text: "Всі існуючі специфікації проходять через CLI та `node:test` (22/24 pass, 2 skip)."
+            completed: true
+          - text: "Прогрес автоматизується зміною статусу `spec.js` (todo/skip/pass)."
+            completed: true
+          - text: "Усі CLI сценарії для AGRP (spec, close, init, status) завершені."
+            completed: false
+          - text: "Створені API-ендпоінти для відображення релізного прогресу у React-Dashboard."
+            completed: false
+        total: 7
+        completed: 5
+stats:
+  totalTasks: 7
+  completedTasks: 5
+  progress: 71