@nan0web/release 1.0.3 → 3.1.0

package/README.md

@@ -6,29 +6,36 @@ Project management as code, Git-native, GPG-signed, and test-driven.
 
 Unlike traditional project tools that require constant syncing or manual updates,
 `@nan0web/release` enforces project structure where:
+
 - Tasks are represented as tests in `.test.js` files.
 - Status is tracked via test outcomes.
 - Team roles and approvals are stored in structured files.
 - All changes are signed, versioned, and composable.
 
+
 This ensures:
+
 - Clear, automatable project tracking.
 - Immutable release notes and retro reflections.
 - Zero ambiguity – tasks don't exist unless tested.
 
+
 ## Installation
 
 How to install with pnpm?
+
 ```bash
 pnpm add @nan0web/release
 ```
 
 How to install with npm?
+
 ```bash
 npm install @nan0web/release
 ```
 
 How to install with yarn?
+
 ```bash
 yarn add @nan0web/release
 ```
@@ -38,14 +45,15 @@ yarn add @nan0web/release
 Start by initializing a new release:
 
 How to initialize a new release version?
+
 ```bash
-release init v1.0.0
+nan0release init v1.0.0
 ```
 
-const cli = ReleaseCLi()
 Show release details:
 
 How to show release information?
+
 ```bash
 release show [--full]
 ```
@@ -58,66 +66,66 @@ console.info(release.version) // v1.0.0
 List all releases in the project:
 
 How to list all releases?
+
 ```bash
-release list [--json]
+nan0release list [--json]
 ```
 
-const cli = ReleaseCLi()
 Add a chat message to the current release:
 
 How to write a release chat message?
+
 ```bash
-release chat write --user alice "Issue with the build pipeline"
+nan0release chat write --user alice "Issue with the build pipeline"
 ```
 
-const cli = ReleaseCLi()
 Host a static server for viewing releases:
 
 How to host release UI?
+
 ```bash
-release host [--webui] [--port 3000]
+nan0release host [--webui] [--port 3000]
 ```
 
-const cli = ReleaseCLi()
 Serve all release files for local inspection:
 
 How to serve release static assets?
+
 ```bash
-release serve [--port 8080]
+nan0release serve [--port 8080]
 ```
 
-const cli = ReleaseCLi()
 Validate release tasks and integrity:
 
 How to validate release tasks?
+
 ```bash
-release validate [--ignore-fail]
+nan0release validate [--ignore-fail]
 ```
 
-const release = new Release({
-version: 'v1.0.0',
-createdAt: new Date('2025-08-20'),
-})
 Seal the release with retro reflection:
 
 How to seal a release?
+
 ```bash
-release seal [--message "All core APIs are stable and tested"]
+nan0release seal [--message "All core APIs are stable and tested"]
 ```
 
-const cli = ReleaseCLi()
 ## Core Concepts
 
 ### 1. Release as Object
 
 A `Release` is a structured class containing:
+
 - `version`: release identifier (vX.Y.Z).
 - `createdAt`, `startAt`, `planAt`, `completeAt`: datetime milestones.
 - `document`: parsed markdown document with structure-aware parsing.
 
+
 Each property is typed and validated automatically via JSDoc and runtime parsing.
 
 How to instantiate a Release?
+
 ```js
 import { Release } from '@nan0web/release'
 const release = new Release({
@@ -130,11 +138,14 @@ console.info(release.createdAt instanceof Date) // ← true
 ### 2. Release Document Parsing
 
 A `ReleaseDocument` extends `@nan0web/markdown` with:
+
 - Structured parsing of markdown release notes
 - Extraction of sections and tasks
 - Team and role parsing from markdown frontmatter or code
 
+
 How to parse release notes markdown into structured data?
+
 ```js
 import { ReleaseDocument } from '@nan0web/release'
 const md = `# v1.0.0 - 2025-08-20
@@ -151,11 +162,14 @@ console.info(doc.document.children instanceof Array) // ← true
 ### 3. Person & Team Structures
 
 A `Person` instance includes:
+
 - `name`: HumanName
 - `gender`: HumanGender
 - `contacts`: array of HumanContact
 
+
 How to create a Person with typed properties?
+
 ```js
 import { Person } from '@nan0web/release'
 const person = new Person({
@@ -176,6 +190,7 @@ Tasks are registered as `taskId` → `testFilePath` in `ProjectManagement`.
 Their status is derived by running `node:test` suites.
 
 How to register and validate tasks as tests?
+
 ```js
 import { ProjectManagement } from '@nan0web/release'
 const pm = new ProjectManagement()
@@ -195,11 +210,14 @@ console.info(results.pending.includes('task-2')) // ← true
 
 The `ReleaseManager` coordinates releases and validates readiness.
 It ensures:
+
 - All registered tests pass
 - Version is correctly incremented
 - Git tag is applied if all validations succeed
 
+
 How to execute a release after validation?
+
 ```js
 import { ReleaseManager, ProjectManagement } from '@nan0web/release'
 const pm = new ProjectManagement()
@@ -213,11 +231,14 @@ console.info(result.published) // ← true
 ### Changelog Integration
 
 Using `ChangelogTaskManager`, you can:
+
 - Extract task definitions from changelog entries
 - Generate corresponding test files
 - Automate task progression in CI
 
+
 How to parse changelog and extract tasks?
+
 ```js
 import { ChangelogTaskManager } from '@nan0web/release'
 const ctm = new ChangelogTaskManager()
@@ -239,6 +260,7 @@ Uses JSDoc and .d.ts files for autocompletion
 Try the package in the terminal:
 
 How to run playground demo?
+
 ```bash
 git clone https://github.com/nan0web/release.git
 cd release
@@ -251,6 +273,7 @@ pnpm run playground
 To verify the project is ready, run:
 
 How to check project status before publishing?
+
 ```bash
 npm test
 npm run test:coverage
@@ -264,3 +287,5 @@ How to contribute? - [check here](./CONTRIBUTING.md)
 ## License
 
 How to license ISC? - [check here](./LICENSE)
+
+

package/bin/nan0release.js

@@ -1,42 +1,6 @@
 #!/usr/bin/env node
 
-import process from 'node:process'
+import { bootstrapApp } from '@nan0web/ui-cli'
+import { App } from '../src/domain/App.js'
 
-import { OutputMessage } from '@nan0web/co'
-import Logger from '@nan0web/log'
-
-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 OutputLogger(Logger.detectLevel(process.argv))
-
-async function main(argv = []) {
-	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.slice(2)).catch((err) => {
-	logger.error('❌ Unhandled error:', err.message || err)
-	if (err.stack) logger.debug(err.stack)
-	process.exit(1)
-})
+bootstrapApp(App)

package/knip.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://unpkg.com/knip@5/schema.json",
+  "entry": [
+    "src/index.js",
+    "bin/nan0release.js",
+    "src/README.md.js"
+  ],
+  "project": ["src/**/*.js", "bin/*.js"],
+  "ignoreDependencies": [
+    "@nan0web/log",
+    "@nan0web/ui",
+    "@nan0web/ui-cli",
+    "@nan0web/logos",
+    "@nan0web/markdown",
+    "@nan0web/db",
+    "@nan0web/db-fs",
+    "@nan0web/types",
+    "@nan0web/co",
+    "@nan0web/changelog"
+  ]
+}

package/nan0web.nan0

@@ -0,0 +1,16 @@
+name: "@nan0web/release"
+agents:
+  - id: 'release-manager'
+    description: 'Release & NPM Publication Manager'
+    workflows:
+      - 'src/agents/workflows/release.md'
+      - 'src/agents/workflows/npm-release.md'
+    inspectors:
+      - 'src/agents/inspectors/package-hygiene.md'
+  - id: 'git-reviewer'
+    description: 'Architectural Git Commit Validator'
+    workflows:
+      - 'src/agents/workflows/commit.md'
+      - 'src/agents/workflows/zero-tolerance-git.md'
+    inspectors:
+      - 'src/agents/inspectors/git-reviewer.md'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nan0web/release",
-  "version": "1.0.3",
+  "version": "3.1.0",
   "description": "Project Management as Code, Git-Native, GPG-Signed, Test-Driven",
   "main": "src/index.js",
   "types": "types/index.d.ts",
@@ -10,22 +10,22 @@
     "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"
+    "@nan0web/log": "3.1.0",
+    "@nan0web/co": "3.1.0",
+    "@nan0web/markdown": "3.1.0",
+    "@nan0web/db-fs": "3.1.0",
+    "@nan0web/types": "3.1.0",
+    "@nan0web/changelog": "3.1.0",
+    "@nan0web/db": "3.1.0",
+    "@nan0web/ui": "3.1.0",
+    "@nan0web/logos": "3.1.0",
+    "@nan0web/ui-cli": "3.1.0"
   },
   "devDependencies": {
-    "@nan0web/test": "^1.1.3",
+    "@types/node": "^25.6.0",
     "husky": "^9.1.7",
-    "knip": "^5.86.0"
+    "knip": "^5.86.0",
+    "@nan0web/test": "3.1.0"
   },
   "scripts": {
     "build": "tsc",

package/src/README.md.js

@@ -4,7 +4,7 @@ import { readFile } from 'node:fs/promises'
 import FS from '@nan0web/db-fs'
 import { NoConsole } from '@nan0web/log'
 import { DatasetParser, DocsParser, runSpawn } from '@nan0web/test'
-import ReleaseCLi from './ui/cli/ReleaseCLi.js'
+import { App } from './index.js'
 import Release from './Release.js'
 import ReleaseDocument from './Release/Document.js'
 import Person from './Release/Person.js'
@@ -100,11 +100,10 @@ function testRender() {
 	it('How to initialize a new release version?', () => {
 		/**
 		 * ```bash
-		 * release init v1.0.0
+		 * nan0release init v1.0.0
 		 * ```
 		 */
-		const cli = ReleaseCLi()
-		assert.ok(cli.logger)
+		assert.ok(new App().constructor.command.options)
 	})
 
 	/**
@@ -132,11 +131,10 @@ function testRender() {
 	it('How to list all releases?', () => {
 		/**
 		 * ```bash
-		 * release list [--json]
+		 * nan0release list [--json]
 		 * ```
 		 */
-		const cli = ReleaseCLi()
-		assert.ok(cli.logger)
+		assert.ok(new App().constructor.command.options)
 	})
 
 	/**
@@ -146,11 +144,10 @@ function testRender() {
 	it('How to write a release chat message?', () => {
 		/**
 		 * ```bash
-		 * release chat write --user alice "Issue with the build pipeline"
+		 * nan0release chat write --user alice "Issue with the build pipeline"
 		 * ```
 		 */
-		const cli = ReleaseCLi()
-		assert.ok(cli.logger)
+		assert.ok(new App().constructor.command.options)
 	})
 
 	/**
@@ -160,11 +157,10 @@ function testRender() {
 	it('How to host release UI?', () => {
 		/**
 		 * ```bash
-		 * release host [--webui] [--port 3000]
+		 * nan0release host [--webui] [--port 3000]
 		 * ```
 		 */
-		const cli = ReleaseCLi()
-		assert.ok(cli.logger)
+		assert.ok(new App().constructor.command.options)
 	})
 
 	/**
@@ -174,11 +170,10 @@ function testRender() {
 	it('How to serve release static assets?', () => {
 		/**
 		 * ```bash
-		 * release serve [--port 8080]
+		 * nan0release serve [--port 8080]
 		 * ```
 		 */
-		const cli = ReleaseCLi()
-		assert.ok(cli.logger)
+		assert.ok(new App().constructor.command.options)
 	})
 
 	/**
@@ -188,9 +183,10 @@ function testRender() {
 	it('How to validate release tasks?', () => {
 		/**
 		 * ```bash
-		 * release validate [--ignore-fail]
+		 * nan0release validate [--ignore-fail]
 		 * ```
 		 */
+		assert.ok(true)
 		const release = new Release({
 			version: 'v1.0.0',
 			createdAt: new Date('2025-08-20'),
@@ -205,11 +201,10 @@ function testRender() {
 	it('How to seal a release?', () => {
 		/**
 		 * ```bash
-		 * release seal [--message "All core APIs are stable and tested"]
+		 * nan0release seal [--message "All core APIs are stable and tested"]
 		 * ```
 		 */
-		const cli = ReleaseCLi()
-		assert.ok(cli.logger)
+		assert.ok(new App().constructor.command.options)
 	})
 
 	/**
@@ -404,7 +399,10 @@ Release milestone includes UI polish and core API stabilization.
 		assert.ok(pkg.scripts?.playground)
 		const response = await runSpawn('git', ['remote', 'get-url', 'origin'])
 		assert.ok(response.code === 0)
-		assert.ok(response.text.trim().endsWith(':nan0web/release.git'))
+		assert.ok(
+			response.text.trim().endsWith('nan0web/monorepo.git') ||
+				response.text.trim().endsWith('nan0web/release.git'),
+		)
 	})
 
 	/**

package/src/Release/Person.js

@@ -1,4 +1,4 @@
-import { HumanName, HumanContact, HumanGender } from '@nan0web/verse'
+import { HumanName, HumanContact, HumanGender } from '@nan0web/logos'
 
 export default class Person {
 	/** @type {HumanName} */

package/src/agents/inspectors/git-reviewer.md

@@ -0,0 +1,35 @@
+---
+description: Architectural Git Commit & Diff Validator Subagent
+---
+
+# 🐙 Git Reviewer
+
+**INPUTS REQUIRED:**
+
+- `[PROJECT_MD]` (The 5-phase architectural spec, e.g. project.md from root)
+- `[DIFF]` (The git diff patch output `git diff --cached`)
+
+**SYSTEM PROMPT (Agnostic AI API Persona):**
+You are an isolated, Agnostic Zero-Hallucination Git Reviewer. You do not code. You do not converse. You compare the semantic integrity of the `[DIFF]` against the core architecture.
+
+You must evaluate the snippet rigorously based on structural integrity and specific rules provided.
+There is no ambiguity: any deviation from the preset `[PROJECT_MD]` libraries or patterns must be strictly caught.
+To reject a `[DIFF]`, provide the specific file name, the line number of code, and the specific phase of `[PROJECT_MD]` that it contradicts.
+
+**OBJECTIVE:**
+Ensure the developer is not sneaking in "hotfixes" that break structural agreements ("Zero-Trust Git Review").
+
+- Locate any deviations from predefined libraries or patterns.
+- Locate undocumented mutations in the `data/` or `ui/` layer.
+- Ensure only required files are staged.
+
+**STRICT OUTPUT CONTRACT:**
+
+```json
+{
+  "score": 85,
+  "errors": [
+    "File 'src/index.js' introduces direct 'node:fs' usage instead of '@nan0web/db-fs', contradicting Phase 2 of project.md."
+  ]
+}
+```

package/src/agents/inspectors/package-hygiene.md

@@ -0,0 +1,63 @@
+---
+description: Гігієна пакету — обовʼязкові скрипти, конвеєр test:all, knip, .npmignore
+---
+
+# 🧹 Гігієна Пакету (Package Hygiene)
+
+## 1. Обов'язкові скрипти у кожному пакеті
+
+- `"knip": "knip --production"` — перевірка невикористаних файлів, експортів та залежностей.
+- `"audit": "pnpm audit --prod || true"` — інформативна перевірка вразливостей. `|| true` бо `pnpm audit` monorepo-wide — вразливості сусідніх пакетів не повинні блокувати реліз.
+- `"release:spec": "node --test \"releases/**/*.spec.js\""` — контрактні тести відкритого релізу.
+- `"test:release": "node --test \"src/test/releases/**/*.test.js\""` — регресійні тести закритих релізів.
+
+## 2. Повний конвеєр (`test:all`)
+
+```
+test → test:docs → build → test:release → knip → audit
+```
+
+- Всі кроки через `&&` — мають бути зеленими.
+
+## 3. Knip Конфігурація (`knip.json`)
+
+- `entry`: головний `src/index.js`.
+- `ignore`: `play/`, `releases/`, `types/`, `src/README.md.js`.
+- `ignoreDependencies`: dev-інструменти (`husky`, `@nan0web/test`, тощо).
+
+## 4. `.npmignore` (ОБОВ'ЯЗКОВО у кожному пакеті)
+
+Без `.npmignore` npm використовує `.gitignore`, що пропускає dev-артефакти в публікацію.
+Мінімальний шаблон:
+
+```
+# Tests
+src/**/*.test.js
+src/test/
+types/test/
+
+# ProvenDoc generator
+src/README.md.js
+
+# Dev files
+play/
+releases/
+docs/
+knip.json
+system.md
+next.md
+tsconfig.json
+.editorconfig
+CONTRIBUTING.md
+
+# LLiMo / AI artifacts
+chat/
+.datasets/
+me.md
+
+# Generated
+dist/
+.cache/
+```
+
+**Перевірка**: `npm pack --dry-run` перед кожним `npm publish`.

package/src/agents/workflows/commit.md

@@ -0,0 +1,28 @@
+---
+description: Safe Commit Workflow (No Auto-Run)
+---
+
+# Safe Commit Procedure
+
+1. **Check Status**:
+   - Run `git status` to see what is staged/modified.
+   - Run `git diff --stat` to see the scope of changes.
+
+2. **Verify Integrity**:
+   - IF (and only if) tests exist, run them: `npm run test:all`.
+   - Ensure the build passes: `npm run build` (if applicable, must be included in test:all).
+
+3. **Formulate Message**:
+   - Create a concise, semantic commit message (e.g., `fix: ...`, `feat: ...`).
+   - Describe WHAT changed and WHY.
+
+4. **PROPOSE Command**:
+   - **DO NOT RUN THE COMMIT COMMAND.**
+   - Output the suggested command string:
+     ```bash
+     git add . && git commit -m "Your proposed message"
+     ```
+   - Ask the user: "Shall I execute this?"
+
+5. **Execute (On User Approval)**:
+   - Only after receiving explicit "Yes" or "Do it", run the command.

package/src/agents/workflows/npm-release.md

@@ -0,0 +1,40 @@
+---
+description: /release — Публікація пакету в NPM (Smart Test & Build & Publish)
+---
+
+// turbo-all
+
+До релізую НЕ МАЮТЬ потрапляти так файли:
+
+- .agent/
+- .vscode/
+- docs/
+- src/**/*.test.js{x}
+- src/test/
+- src/README.md.js{x}
+
+Мають потрапляти:
+
+- package.json
+- LICENSE
+- README.md
+- bin/
+- src/
+- types/
+
+1. **Повна перевірка (Safety First)**: Запусти локальну перевірку пакету.
+
+   ```bash
+   pnpm test:all
+   ```
+
+2. **Публікація в NPM**: Виконай стандартний скрипт релізу.
+
+   ```bash
+   npm run release
+   ```
+
+3. **Верифікація статусів**: Перевір статус пакетів у монорепо.
+   ```bash
+   npm run test:status
+   ```