@nan0web/release 3.2.0 → 3.4.0

package/src/domain/inspect/ReleaseAuditor.js

@@ -0,0 +1,508 @@
+import { AuditorModel } from '@nan0web/inspect/domain/AuditorModel'
+import { show, progress, result } from '@nan0web/ui'
+
+/**
+ * @typedef {Object} ReleaseDiagnostic
+ * @property {'error' | 'warning' | 'info'} level
+ * @property {string} code
+ * @property {string} [check]
+ * @property {string} [file]
+ * @property {string} error
+ * @property {string} [suggestion]
+ * @property {string} [fix]
+ */
+
+/**
+ * ReleaseAuditor — Architecture auditor and validator for PM-as-Code release structures.
+ */
+export class ReleaseAuditor extends AuditorModel {
+	static alias = 'release'
+
+	static changed = {
+		help: 'Only inspect modified workspaces/releases',
+		default: false,
+		type: 'boolean',
+		alias: 'c',
+	}
+
+	static all = {
+		help: 'Audit all registered projects in releases.txt',
+		default: false,
+		type: 'boolean',
+		alias: 'a',
+	}
+
+	static registryFile = {
+		help: 'Path to releases.txt registry file',
+		default: 'releases.txt',
+		type: 'string',
+		alias: 'f',
+	}
+
+	static UI = {
+		title: 'PM-as-Code Release Structure Auditor',
+		header: '🔍 Running Release Quality & Compliance Audit for {$dir}...',
+		skipped: 'Release audit skipped (capped by active session)',
+		missingPackageJson: 'Missing package.json in {$dir}',
+		noReleasesDir: 'No release directories found under {$dir}',
+		releasesFound: 'Discovered {$count} release(s) in {$dir}',
+		releaseHeader: 'Auditing Release [v{$version}] at {$path}',
+		releaseDocCompleted: 'Release document valid: {$file} ({$done}/{$total} tasks completed)',
+		missingReleaseDoc: 'Missing release.md, task.md, or plan.md in {$path}',
+		missingUserDoc: 'Missing user.md metrics document in {$path}',
+		incompleteUserMetrics: 'user.md in {$path} is missing Hours, Iterations, or RRS score',
+		userMetricsValid: 'user.md metrics valid (Hours: {$hours}h, Iterations: {$iterations}, RRS: {$rrs})',
+		ambiguousContracts: 'Both task.spec.js (WIP) and task.test.js (Closed) exist simultaneously in {$path}',
+		missingContract: 'Missing contract test in {$path} (task.spec.js or task.test.js required)',
+		activeContractWip: 'Active contract present: task.spec.js [WIP]',
+		sealedRegressionClosed: 'Sealed regression test present: task.test.js [CLOSED]',
+		orphanFile: 'Orphan file found in releases/ root: {$file}',
+		summary: 'Release Audit Complete: {$releases} release(s) checked | Status: {$status} | Errors: {$errors} | Warnings: {$warnings}',
+		Diagnostics: {
+			MISSING_PACKAGE_JSON: {
+				level: 'error',
+				code: 'MISSING_PACKAGE_JSON',
+				message: 'Missing package.json in {$dir}',
+				fix: 'Ensure package.json exists with valid name and version.',
+			},
+			MISSING_RELEASES_DIR: {
+				level: 'error',
+				code: 'MISSING_RELEASES_DIR',
+				message: 'No release directories found under {$dir}',
+				fix: 'Initialize release directory: pnpm exec release init v0.1.0',
+			},
+			MISSING_RELEASE_MD: {
+				level: 'error',
+				code: 'MISSING_RELEASE_MD',
+				message: 'Missing release.md or task.md in {$path}',
+				fix: 'Create {$path}/release.md with release scope, user stories, and acceptance checklist.',
+			},
+			MISSING_USER_MD: {
+				level: 'warning',
+				code: 'MISSING_USER_MD',
+				message: 'Missing user.md metrics document in {$path}',
+				fix: 'Create {$path}/user.md containing Execution Metrics (Hours, Iterations, and RRS score).',
+			},
+			INCOMPLETE_USER_METRICS: {
+				level: 'warning',
+				code: 'INCOMPLETE_USER_METRICS',
+				message: 'user.md in {$path} is missing hours, iterations or RRS score',
+				fix: 'Update {$path}/user.md with sections: "Витрачений час розробки (Годин):", "Кількість ітерацій:", "Фінальний бал RRS:".',
+			},
+			AMBIGUOUS_CONTRACTS: {
+				level: 'error',
+				code: 'AMBIGUOUS_CONTRACTS',
+				message: 'Both task.spec.js and task.test.js exist simultaneously in {$path}',
+				fix: 'If release is still active, keep task.spec.js. If release is sealed/closed, keep task.test.js.',
+			},
+			MISSING_CONTRACT: {
+				level: 'error',
+				code: 'MISSING_CONTRACT',
+				message: 'No contract test found in {$path} (missing task.spec.js or task.test.js)',
+				fix: 'Create contract test {$path}/task.spec.js for TDD verification.',
+			},
+			ORPHAN_RELEASE_FILE: {
+				level: 'warning',
+				code: 'ORPHAN_RELEASE_FILE',
+				message: 'Orphan file "{$file}" located directly in releases/ directory outside of version folders',
+				fix: 'Move "{$file}" into the appropriate version directory (e.g. releases/vX.Y.Z/) or backlog.md.',
+			},
+			PROCEDURAL_RELEASE_ARTIFACT: {
+				level: 'warning',
+				code: 'PROCEDURAL_RELEASE_ARTIFACT',
+				message: 'Procedural artifact "{$file}" found in release {$path}. Releases must be pure Data-Driven.',
+				fix: 'Remove "{$file}". Use data-driven *.nan0 documents and multimodal runners (serve releases/) instead of ad-hoc HTML/JS.',
+			},
+		},
+	}
+
+	/**
+	 * @param {Partial<ReleaseAuditor> | Record<string, any>} [data={}]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options={}]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {boolean} */ this.changed = Boolean(data.changed || (options && 'changed' in options ? /** @type {any} */ (options).changed : false))
+		/** @type {boolean} */ this.all = Boolean(data.all || (options && 'all' in options ? /** @type {any} */ (options).all : false))
+		/** @type {string} */ this.registryFile = String(data.registryFile || 'releases.txt')
+	}
+
+	/**
+	 * Runs the PM-as-Code release audit.
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, any, any>}
+	 */
+	async *run() {
+		const db = this._.db
+		/** @type {import('@nan0web/i18n').TFunction} */
+		const t = this._.t || ((key, params) => {
+			let str = String(key || '')
+			if (params) {
+				for (const [k, v] of Object.entries(params)) {
+					str = str.replaceAll(`{$${k}}`, String(v)).replaceAll(`{${k}}`, String(v))
+				}
+			}
+			return str
+		})
+
+		if (await this.isCapped()) {
+			yield progress(t(ReleaseAuditor.UI.skipped))
+			return result({
+				success: true,
+				skipped: true,
+				errors: [],
+				warnings: [],
+				checkedReleases: [],
+			})
+		}
+
+		yield progress(t(ReleaseAuditor.UI.header, { dir: this.dir }))
+
+		/** @type {ReleaseDiagnostic[]} */
+		const errors = []
+		/** @type {ReleaseDiagnostic[]} */
+		const warnings = []
+		const checkedReleases = []
+
+		const projectRoot = this.dir === '.' || !this.dir ? '' : `${this.dir.replace(/\/+$/, '')}/`
+
+		// 1. Check package.json if auditing specific directory
+		if (projectRoot) {
+			const hasPkg = await this.fileExists('package.json')
+			if (!hasPkg) {
+				const diagDef = ReleaseAuditor.UI.Diagnostics.MISSING_PACKAGE_JSON
+				const err = {
+					level: /** @type {'error'} */ ('error'),
+					code: diagDef.code,
+					check: 'package.json',
+					file: `${projectRoot}package.json`,
+					error: t(diagDef.message, { dir: this.dir }),
+					fix: t(diagDef.fix, { dir: this.dir }),
+				}
+				errors.push(err)
+				yield show(err.error, 'error')
+			}
+		}
+
+		// 2. Discover release directories
+		const releaseDirs = await this.#discoverReleases(db, projectRoot)
+
+		if (releaseDirs.length === 0) {
+			const diagDef = ReleaseAuditor.UI.Diagnostics.MISSING_RELEASES_DIR
+			const err = {
+				level: /** @type {'error'} */ ('error'),
+				code: diagDef.code,
+				check: 'releases/',
+				file: `${projectRoot}releases/`,
+				error: t(diagDef.message, { dir: this.dir }),
+				fix: t(diagDef.fix, { dir: this.dir }),
+			}
+			errors.push(err)
+			yield show(err.error, 'error')
+		} else {
+			yield show(t(ReleaseAuditor.UI.releasesFound, { count: releaseDirs.length, dir: this.dir }), 'info')
+		}
+
+		// 3. Check each release directory
+		for (const rel of releaseDirs) {
+			const relPath = rel.path
+			yield show(t(ReleaseAuditor.UI.releaseHeader, { version: rel.version, path: relPath }))
+
+			// A. Check release.md / task.md / plan.md
+			let releaseContent = null
+			let releaseDocFile = ''
+			for (const docFile of ['release.md', 'task.md', 'plan.md']) {
+				try {
+					const doc = await db.loadDocument(`${relPath}/${docFile}`, null)
+					if (doc) {
+						releaseContent = String(doc)
+						releaseDocFile = `${relPath}/${docFile}`
+						break
+					}
+				} catch {}
+			}
+
+			if (!releaseContent) {
+				const diagDef = ReleaseAuditor.UI.Diagnostics.MISSING_RELEASE_MD
+				const err = {
+					level: /** @type {'error'} */ ('error'),
+					code: diagDef.code,
+					check: 'release.md',
+					file: `${relPath}/release.md`,
+					error: t(diagDef.message, { path: relPath }),
+					fix: t(diagDef.fix, { path: relPath }),
+				}
+				errors.push(err)
+				yield show(err.error, 'error')
+			} else {
+				const { done, total } = this.#countTasks(releaseContent)
+				yield show(
+					t(ReleaseAuditor.UI.releaseDocCompleted, {
+						file: releaseDocFile.split('/').pop(),
+						done,
+						total,
+					}),
+					'success'
+				)
+			}
+
+			// B. Check user.md metrics
+			let userDoc = null
+			try {
+				userDoc = await db.loadDocument(`${relPath}/user.md`, null)
+			} catch {}
+
+			if (!userDoc) {
+				const diagDef = ReleaseAuditor.UI.Diagnostics.MISSING_USER_MD
+				const warn = {
+					level: /** @type {'warning'} */ ('warning'),
+					code: diagDef.code,
+					check: 'user.md',
+					file: `${relPath}/user.md`,
+					error: t(diagDef.message, { path: relPath }),
+					fix: t(diagDef.fix, { path: relPath }),
+				}
+				warnings.push(warn)
+				yield show(warn.error, 'warn')
+			} else {
+				const userStr = typeof userDoc === 'object' ? JSON.stringify(userDoc) : String(userDoc)
+				const hasHours =
+					/витрачений час/i.test(userStr) ||
+					/hours/i.test(userStr) ||
+					userDoc.hours !== undefined ||
+					userDoc.time !== undefined
+				const hasIters =
+					/кількість ітерацій/i.test(userStr) ||
+					/iterations/i.test(userStr) ||
+					userDoc.iterations !== undefined
+				const hasRrs =
+					/rrs/i.test(userStr) ||
+					/score/i.test(userStr) ||
+					userDoc.rrs !== undefined
+
+				if (!hasHours || !hasIters || !hasRrs) {
+					const diagDef = ReleaseAuditor.UI.Diagnostics.INCOMPLETE_USER_METRICS
+					const warn = {
+						level: /** @type {'warning'} */ ('warning'),
+						code: diagDef.code,
+						check: 'user.md',
+						file: `${relPath}/user.md`,
+						error: t(diagDef.message, { path: relPath }),
+						fix: t(diagDef.fix, { path: relPath }),
+					}
+					warnings.push(warn)
+					yield show(warn.error, 'warn')
+				} else {
+					yield show(t(ReleaseAuditor.UI.userMetricsValid, { hours: 'ok', iterations: 'ok', rrs: 'ok' }), 'success')
+				}
+			}
+
+			// C. Check contract tests (task.spec.js / task.test.js)
+			let hasSpec = false
+			let hasTest = false
+			try {
+				const spec = await db.loadDocument(`${relPath}/task.spec.js`, null)
+				if (spec) hasSpec = true
+			} catch {}
+
+			try {
+				const test = await db.loadDocument(`${relPath}/task.test.js`, null)
+				if (test) hasTest = true
+			} catch {}
+
+			if (hasSpec && hasTest) {
+				const diagDef = ReleaseAuditor.UI.Diagnostics.AMBIGUOUS_CONTRACTS
+				const err = {
+					level: /** @type {'error'} */ ('error'),
+					code: diagDef.code,
+					check: 'task.spec.js',
+					file: `${relPath}/task.spec.js`,
+					error: t(diagDef.message, { path: relPath }),
+					fix: t(diagDef.fix, { path: relPath }),
+				}
+				errors.push(err)
+				yield show(err.error, 'error')
+			} else if (!hasSpec && !hasTest) {
+				const diagDef = ReleaseAuditor.UI.Diagnostics.MISSING_CONTRACT
+				const err = {
+					level: /** @type {'error'} */ ('error'),
+					code: diagDef.code,
+					check: 'task.spec.js',
+					file: `${relPath}/task.spec.js`,
+					error: t(diagDef.message, { path: relPath }),
+					fix: t(diagDef.fix, { path: relPath }),
+				}
+				errors.push(err)
+				yield show(err.error, 'error')
+			} else if (hasSpec) {
+				yield show(t(ReleaseAuditor.UI.activeContractWip), 'success')
+			} else if (hasTest) {
+				yield show(t(ReleaseAuditor.UI.sealedRegressionClosed), 'success')
+			}
+
+			// D. Check for prohibited procedural artifacts (index.html, play.js)
+			for (const procName of ['index.html', 'play.js']) {
+				try {
+					const hasProc = await db.loadDocument(`${relPath}/${procName}`, null)
+					if (hasProc) {
+						const diagDef = ReleaseAuditor.UI.Diagnostics.PROCEDURAL_RELEASE_ARTIFACT
+						const warn = {
+							level: /** @type {'warning'} */ ('warning'),
+							code: diagDef.code,
+							check: procName,
+							file: `${relPath}/${procName}`,
+							error: t(diagDef.message, { file: procName, path: relPath }),
+							fix: t(diagDef.fix, { file: procName, path: relPath }),
+						}
+						warnings.push(warn)
+						yield show(warn.error, 'warn')
+					}
+				} catch {}
+			}
+
+			checkedReleases.push({
+				version: rel.version,
+				path: rel.path,
+				valid: errors.filter((e) => e.file?.startsWith(relPath)).length === 0,
+			})
+		}
+
+		// 4. Check for orphan files in releases/ root
+		const orphanFiles = await this.#findOrphanReleaseFiles(db, projectRoot)
+		for (const orphan of orphanFiles) {
+			const diagDef = ReleaseAuditor.UI.Diagnostics.ORPHAN_RELEASE_FILE
+			const warn = {
+				level: /** @type {'warning'} */ ('warning'),
+				code: diagDef.code,
+				check: orphan,
+				file: `${projectRoot}releases/${orphan}`,
+				error: t(diagDef.message, { file: orphan }),
+				fix: t(diagDef.fix, { file: orphan }),
+			}
+			warnings.push(warn)
+			yield show(warn.error, 'warn')
+		}
+
+		const isSuccess = errors.length === 0
+		yield show(
+			t(ReleaseAuditor.UI.summary, {
+				releases: checkedReleases.length,
+				status: isSuccess ? 'PASSED' : 'FAILED',
+				errors: errors.length,
+				warnings: warnings.length,
+			}),
+			isSuccess ? 'success' : 'warn'
+		)
+
+		return result({
+			success: isSuccess,
+			errors,
+			warnings,
+			checkedReleases,
+			diagnostics: [...errors, ...warnings],
+		})
+	}
+
+	/**
+	 * Count tasks in markdown content
+	 * @param {string} content
+	 * @returns {{ done: number, total: number }}
+	 */
+	#countTasks(content = '') {
+		let total = 0
+		let done = 0
+		for (const line of content.split('\n')) {
+			const m = line.match(/^[-*+]?\s*(?:\[([ xX])\]|\d+\.\s*\[([ xX])\])\s*(.+)$/)
+			if (m) {
+				total++
+				if ((m[1] || m[2] || '').toLowerCase() === 'x') done++
+			}
+		}
+		return { done, total }
+	}
+
+	/**
+	 * Discover release version directories using database
+	 * @param {any} db
+	 * @param {string} projectRoot
+	 * @returns {Promise<Array<{ version: string, path: string }>>}
+	 */
+	async #discoverReleases(db, projectRoot) {
+		const results = []
+		const releasesUri = `${projectRoot}releases`.replace(/^\/+/, '') || 'releases'
+
+		try {
+			if (typeof db.listDir === 'function') {
+				const queue = [{ uri: releasesUri, depth: 0 }]
+				while (queue.length > 0) {
+					const item = queue.shift()
+					if (!item || item.depth > 3) continue
+					let entries = []
+					try {
+						entries = await db.listDir(item.uri)
+					} catch {
+						continue
+					}
+					if (!Array.isArray(entries)) continue
+
+					for (const entry of entries) {
+						const rawName = entry.name || (entry.path || '').split('/').pop() || ''
+						const name = rawName.replace(/\/$/, '')
+						const isDir = Boolean(
+							entry.stat?.isDirectory ||
+							entry.isDirectory ||
+							entry.isDir ||
+							rawName.endsWith('/')
+						)
+
+						const dirMatch = name.match(/^v(\d+\.\d+\.\d+[a-zA-Z0-9._-]*)/)
+						if (dirMatch) {
+							const version = dirMatch[1]
+							const entryPath = entry.path ? entry.path.replace(/\/$/, '') : `${item.uri}/${name}`
+							const normalizedPath = entryPath.replace(/^\.\//, '')
+							if (!results.find((r) => r.path === normalizedPath)) {
+								results.push({ version, path: normalizedPath })
+							}
+						} else if (isDir && !name.startsWith('.') && name !== 'node_modules' && name !== '_') {
+							const nextUri = entry.path ? entry.path.replace(/\/$/, '') : `${item.uri}/${name}`
+							queue.push({ uri: nextUri, depth: item.depth + 1 })
+						}
+					}
+				}
+			}
+		} catch {}
+
+		return results
+	}
+
+	/**
+	 * Find orphan files inside releases/ directory using db
+	 * @param {any} db
+	 * @param {string} projectRoot
+	 * @returns {Promise<string[]>}
+	 */
+	async #findOrphanReleaseFiles(db, projectRoot) {
+		const orphans = []
+		const releasesUri = `${projectRoot}releases`.replace(/^\/+/, '') || 'releases'
+
+		try {
+			if (typeof db.listDir === 'function') {
+				const entries = await db.listDir(releasesUri, { depth: 0 })
+				for (const entry of entries) {
+					const isFile = !entry.isDirectory && (entry.isFile || !entry.isDir)
+					const name = entry.name || (entry.path || '').split('/').pop() || ''
+					if (
+						isFile &&
+						!['index.js', 'current.js', 'README.md', 'backlog.md'].includes(name) &&
+						!name.startsWith('.')
+					) {
+						orphans.push(name)
+					}
+				}
+			}
+		} catch {}
+
+		return orphans
+	}
+}
+
+export default ReleaseAuditor

package/src/domain/inspect/ReleaseAuditor.story.js

@@ -0,0 +1,136 @@
+import { describe, it } from 'node:test'
+import assert from 'node:assert/strict'
+import DB from '@nan0web/db'
+import { ReleaseAuditor } from './ReleaseAuditor.js'
+import { AuditorModel } from '@nan0web/inspect'
+
+describe('ReleaseAuditor OLMUI Scenario & Architecture Auditor', () => {
+	it('inherits from AuditorModel and has release alias', () => {
+		assert.equal(ReleaseAuditor.alias, 'release')
+		assert.ok(Object.prototype.isPrototypeOf.call(AuditorModel, ReleaseAuditor))
+	})
+
+	it('successfully audits a valid release structure without diagnostics errors', async () => {
+		const pkgJson = { name: '@nan0web/sample-pkg', version: '1.0.0' }
+		const releaseMd = `# v1.0.0 - 2026-09-01
+## Tasks
+- [x] Done task
+`
+		const userMd = `---
+name: user-feedback
+version: 1.0.0
+---
+## ⏱ 1. Метрики Виконання
+- **Витрачений час розробки (Годин):** \`4.5h\`
+- **Кількість ітерацій (Test Runs / Refactors):** \`10\`
+- **Фінальний бал RRS (Release Readiness Score):** \`324\`
+`
+		const taskSpec = `import { describe, it } from 'node:test'
+import assert from 'node:assert/strict'
+describe('contract', () => {
+	it('passes', () => assert.ok(true))
+})
+`
+		const db = new DB({
+			predefined: [
+				['packages/sample-pkg/package.json', pkgJson],
+				['packages/sample-pkg/releases/1/0/v1.0.0/release.md', releaseMd],
+				['packages/sample-pkg/releases/1/0/v1.0.0/user.md', userMd],
+				['packages/sample-pkg/releases/1/0/v1.0.0/task.spec.js', taskSpec],
+			],
+		})
+		await db.connect()
+
+		const auditor = new ReleaseAuditor({ dir: 'packages/sample-pkg' }, { db })
+		await auditor.init()
+
+		const gen = auditor.run()
+		let step = await gen.next()
+		const intents = []
+		while (!step.done) {
+			intents.push(step.value)
+			step = await gen.next()
+		}
+
+		const res = step.value?.data || step.value
+		assert.ok(res.success)
+		assert.equal(res.errors.length, 0)
+		assert.equal(res.checkedReleases.length, 1)
+	})
+
+	it('detects missing release documents, user.md, and contract files with actionable diagnostics', async () => {
+		const pkgJson = { name: '@nan0web/broken-pkg', version: '2.0.0' }
+		const db = new DB({
+			predefined: [
+				['packages/broken-pkg/package.json', pkgJson],
+				['packages/broken-pkg/releases/2/0/v2.0.0/dummy.txt', 'empty'],
+			],
+		})
+		await db.connect()
+
+		const auditor = new ReleaseAuditor({ dir: 'packages/broken-pkg' }, { db })
+		await auditor.init()
+
+		const gen = auditor.run()
+		let step = await gen.next()
+		while (!step.done) {
+			step = await gen.next()
+		}
+
+		const res = step.value?.data || step.value
+		assert.equal(res.success, false)
+		assert.ok(res.errors.length >= 2)
+
+		const codes = res.errors.map((e) => e.code || e.check)
+		assert.ok(codes.includes('MISSING_RELEASE_MD') || codes.includes('release.md'))
+		assert.ok(codes.includes('MISSING_CONTRACT') || codes.includes('task.spec.js'))
+	})
+
+	it('detects ambiguous contracts when both task.spec.js and task.test.js exist', async () => {
+		const db = new DB({
+			predefined: [
+				['packages/ambig/package.json', { name: '@nan0web/ambig', version: '1.0.0' }],
+				['packages/ambig/releases/1/0/v1.0.0/release.md', '# Release\n- [ ] Task'],
+				['packages/ambig/releases/1/0/v1.0.0/user.md', 'Hours: 1.0h\nIterations: 2\nRRS: 300'],
+				['packages/ambig/releases/1/0/v1.0.0/task.spec.js', '// spec'],
+				['packages/ambig/releases/1/0/v1.0.0/task.test.js', '// test'],
+			],
+		})
+		await db.connect()
+
+		const auditor = new ReleaseAuditor({ dir: 'packages/ambig' }, { db })
+		await auditor.init()
+
+		const gen = auditor.run()
+		let step = await gen.next()
+		while (!step.done) {
+			step = await gen.next()
+		}
+
+		const res = step.value?.data || step.value
+		assert.equal(res.success, false)
+		const codes = res.errors.map((e) => e.code || e.check)
+		assert.ok(codes.includes('AMBIGUOUS_CONTRACTS') || codes.includes('contracts'))
+	})
+
+	it('skips execution gracefully if auditor is capped by active session', async () => {
+		const db = new DB({
+			predefined: [
+				['.agent/active_session.json', { disabledInspectors: ['release'] }],
+				['packages/any/package.json', { name: 'any' }],
+			],
+		})
+		await db.connect()
+
+		const auditor = new ReleaseAuditor({ dir: 'packages/any' }, { db })
+		await auditor.init()
+
+		const gen = auditor.run()
+		let step = await gen.next()
+		while (!step.done) {
+			step = await gen.next()
+		}
+		const res = step.value?.data || step.value
+		assert.ok(res.skipped)
+	})
+})

package/src/domain/templates/release.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html lang="uk" data-bs-theme="dark">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Releases Catalog — NaN•Web</title>
+  <style>
+    :root {
+      --bg: #0f172a;
+      --surface: #1e293b;
+      --accent: #38bdf8;
+      --text: #f8fafc;
+      --text-dim: #94a3b8;
+      --border: #334155;
+    }
+    body { font-family: system-ui, -apple-system, sans-serif; background: var(--bg); color: var(--text); margin: 0; padding: 2.5rem 1.5rem; display: flex; justify-content: center; line-height: 1.6; }
+    .container { max-width: 880px; width: 100%; }
+    h1, h2, h3 { color: #fff; font-weight: 700; margin-top: 1.5rem; }
+    h1 { font-size: 2rem; border-bottom: 1px solid var(--border); padding-bottom: 0.8rem; }
+    a { color: var(--accent); text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    table { width: 100%; border-collapse: collapse; margin: 1.5rem 0; background: var(--surface); border-radius: 8px; overflow: hidden; }
+    th, td { padding: 0.85rem 1rem; text-align: left; border-bottom: 1px solid var(--border); }
+    th { background: rgba(0,0,0,0.2); font-weight: 600; color: var(--accent); }
+    pre { background: var(--surface); padding: 1rem; border-radius: 8px; border: 1px solid var(--border); overflow-x: auto; color: #a5b4fc; font-family: monospace; }
+    blockquote { border-left: 4px solid var(--accent); margin: 1rem 0; padding: 0.5rem 1rem; background: var(--surface); border-radius: 0 8px 8px 0; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    {{CONTENT}}
+  </div>
+</body>
+</html>