@nan0web/release 1.0.1 → 1.0.2

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,24 +1,28 @@
 {
 	"name": "@nan0web/release",
-	"version": "1.0.1",
+	"version": "1.0.2",
 	"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"
+		"release": "./bin/nan0release.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": "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",
@@ -26,18 +30,21 @@
 		"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"
+		"@nan0web/changelog": "*",
+		"@nan0web/co": "*",
+		"@nan0web/db": "*",
+		"@nan0web/db-fs": "*",
+		"@nan0web/log": "*",
+		"@nan0web/markdown": "*",
+		"@nan0web/types": "*",
+		"@nan0web/ui": "*",
+		"@nan0web/ui-cli": "*",
+		"@nan0web/verse": "*",
+		"supports-color": "^10.2.2"
 	},
 	"devDependencies": {
-		"@nan0web/test": "workspace:*",
-		"husky": "^9.1.7"
+		"@nan0web/test": "*",
+		"husky": "^9.1.7",
+		"knip": "^5.85.0"
 	}
 }

package/src/Release/Document.js

@@ -1,5 +1,5 @@
-import Markdown, { MDElement, MDHeading1, MDHeading2, MDHeading3 } from "@nan0web/markdown"
-import Person from "./Person.js"
+import Markdown, { MDElement, MDHeading1, MDHeading2, MDHeading3 } from '@nan0web/markdown'
+import Person from './Person.js'
 
 class ReleaseDocument extends Markdown {
 	/** @type {Person[]} */
@@ -20,15 +20,10 @@ class ReleaseDocument extends Markdown {
 	 */
 	constructor(options = {}) {
 		super()
-		const {
-			team = [],
-			roles = new Map(),
-			version = "",
-			date
-		} = options
+		const { team = [], roles = new Map(), version = '', date } = options
 		this.version = String(version)
 		this.date = date ? new Date(date) : undefined
-		this.team = team.map(t => Person.from(t))
+		this.team = team.map((t) => Person.from(t))
 		this.roles = new Map(roles)
 	}
 
@@ -43,13 +38,13 @@ class ReleaseDocument extends Markdown {
 
 		const h1s = this.document.filter((el) => el instanceof MDHeading1)
 		if (h1s.length !== 1) {
-			throw new TypeError("Release document must have exactly one H1 heading with version and date")
+			throw new TypeError('Release document must have exactly one H1 heading with version and date')
 		}
 
-		const h1Content = h1s[0].content ?? ""
-		const [versionPart, ...dateParts] = h1Content.split(" - ")
+		const h1Content = h1s[0].content ?? ''
+		const [versionPart, ...dateParts] = h1Content.split(' - ')
 		this.version = versionPart.trim()
-		this.date = new Date(dateParts.join(" - ").trim())
+		this.date = new Date(dateParts.join(' - ').trim())
 
 		const sections = []
 		/** @type {{title: string, tasks: Array} | null} */
@@ -58,11 +53,10 @@ class ReleaseDocument extends Markdown {
 			if (el instanceof MDHeading2) {
 				currentSection = {
 					title: el.content.trim(),
-					tasks: []
+					tasks: [],
 				}
 				sections.push(currentSection)
-			}
-			else if (el instanceof MDHeading3 && currentSection) {
+			} else if (el instanceof MDHeading3 && currentSection) {
 				const content = el.content.trim()
 				const statusMatch = content.match(/^(\w+)\s*(.+)$/)
 				const slugMatch = content.match(/\[([^\]]+)\]$/)
@@ -84,7 +78,7 @@ class ReleaseDocument extends Markdown {
 				currentSection.tasks.push({
 					content: taskContent,
 					status: status,
-					slug: slug
+					slug: slug,
 				})
 			}
 		}
@@ -98,7 +92,7 @@ class ReleaseDocument extends Markdown {
 	 */
 	static from(input) {
 		if (input instanceof ReleaseDocument) return input
-		if (typeof input === "string") {
+		if (typeof input === 'string') {
 			const doc = new ReleaseDocument()
 			doc.parse(input)
 			return doc
@@ -107,4 +101,4 @@ class ReleaseDocument extends Markdown {
 	}
 }
 
-export default ReleaseDocument
+export default ReleaseDocument

package/src/Release/MarkdownToTest.js

@@ -11,22 +11,22 @@ class MarkdownToTest {
 	generateTests(markdown) {
 		const lines = markdown.split('\n')
 		const versionMatch = markdown.match(/^#\s+(v[\d.]+)\s*-\s*(\d{4}-\d{2}-\d{2})/)
-		
+
 		if (!versionMatch) {
 			throw new Error('Markdown must start with version header: # vX.Y.Z - YYYY-MM-DD')
 		}
-		
+
 		const [, version, date] = versionMatch
 		let testCode = this.generateImports()
 		testCode += this.generateDescribeHeader(version, date)
-		
+
 		const sections = this.extractSections(lines)
 		testCode += this.generateSectionTests(sections)
-		
+
 		testCode += '})\n'
 		return testCode
 	}
-	
+
 	/**
 	 * Generate import statements for node:test
 	 * @returns {string} Import code
@@ -37,7 +37,7 @@ import { ok, strictEqual } from "node:assert"
 
 `
 	}
-	
+
 	/**
 	 * Generate main describe block header
 	 * @param {string} version - Release version
@@ -48,7 +48,7 @@ import { ok, strictEqual } from "node:assert"
 		return `describe("${version} - ${date}", () => {
 `
 	}
-	
+
 	/**
 	 * Extract sections from markdown lines
 	 * @param {string[]} lines - Markdown lines
@@ -59,20 +59,20 @@ import { ok, strictEqual } from "node:assert"
 		const sections = []
 		/** @type {{title: string, tasks: Array<{content: string, status: string, slug: string}>} | null} */
 		let currentSection = null
-		
+
 		for (let i = 0; i < lines.length; i++) {
 			const line = lines[i]
-			
+
 			// H2 section
 			if (line.startsWith('## ')) {
 				currentSection = {
 					title: line.slice(3).trim(),
-					tasks: /** @type {Array<{content: string, status: string, slug: string}>} */([])
+					tasks: /** @type {Array<{content: string, status: string, slug: string}>} */ ([]),
 				}
 				sections.push(currentSection)
 				continue
 			}
-			
+
 			// H3 task
 			if (line.startsWith('###') && currentSection) {
 				const statusMatch = line.match(/^###( Draft| InProgress)? \*\*(.+)\*\* \[(.+)\]$/)
@@ -81,16 +81,16 @@ import { ok, strictEqual } from "node:assert"
 					currentSection.tasks.push({
 						content,
 						status: status ? status.trim() : 'Done',
-						slug
+						slug,
 					})
 				}
 				continue
 			}
 		}
-		
+
 		return sections
 	}
-	
+
 	/**
 	 * Generate test code for sections and their tasks
 	 * @param {Array<{title: string, tasks: Array}>} sections - Sections with tasks
@@ -98,40 +98,42 @@ import { ok, strictEqual } from "node:assert"
 	 */
 	generateSectionTests(sections) {
 		let code = ''
-		
-		sections.forEach(section => {
+
+		sections.forEach((section) => {
 			code += `	describe("${section.title}", () => {
 `
-			
-			section.tasks.forEach(/** @param {{status: string, content: string}} task */task => {
-				switch (task.status) {
-					case 'Draft':
-						code += `		it.todo("${task.content}", () => {
+
+			section.tasks.forEach(
+				/** @param {{status: string, content: string}} task */ (task) => {
+					switch (task.status) {
+						case 'Draft':
+							code += `		it.todo("${task.content}", () => {
 			ok(false, "Draft task - not yet implemented")
 		})
 `
-						break
-					case 'InProgress':
-						code += `		it.skip("${task.content}", () => {
+							break
+						case 'InProgress':
+							code += `		it.skip("${task.content}", () => {
 			ok(false, "In progress task - not yet completed")
 		})
 `
-						break
-					default: // Done
-						code += `		it("${task.content}", () => {
+							break
+						default: // Done
+							code += `		it("${task.content}", () => {
 			ok(true, "Task completed successfully")
 		})
 `
-						break
-				}
-			})
-			
+							break
+					}
+				},
+			)
+
 			code += `	})
 `
 		})
-		
+
 		return code
 	}
 }
 
-export default MarkdownToTest
+export default MarkdownToTest

package/src/Release/Person.js

@@ -1,4 +1,4 @@
-import { HumanName, HumanContact, HumanGender } from "@nan0web/verse"
+import { HumanName, HumanContact, HumanGender } from '@nan0web/verse'
 
 export default class Person {
 	/** @type {HumanName} */
@@ -8,14 +8,10 @@ export default class Person {
 	/** @type {HumanContact[]} */
 	contacts
 	constructor(input = {}) {
-		const {
-			name = new HumanName([]),
-			gender = new HumanGender(-1),
-			contacts = []
-		} = input
+		const { name = new HumanName([]), gender = new HumanGender(-1), contacts = [] } = input
 		this.name = HumanName.from(name)
 		this.gender = HumanGender.from(gender)
-		this.contacts = contacts.map(c => HumanContact.from(c))
+		this.contacts = contacts.map((c) => HumanContact.from(c))
 	}
 	/**
 	 * @param {*} input
@@ -26,4 +22,3 @@ export default class Person {
 		return new Person(input)
 	}
 }
-