@nan0web/release 3.3.0 → 3.5.0

package/src/domain/ValidateCommand.story.js

@@ -0,0 +1,92 @@
+import { describe, it } from 'node:test'
+import assert from 'node:assert/strict'
+import DB from '@nan0web/db'
+import { ValidateCommand } from './ValidateCommand.js'
+
+describe('Scenario: ValidateCommand Multi-Format Inspection with In-Memory DB', () => {
+	it('executes full scan and renders formatted report', async () => {
+		const releaseMd = `---
+status: work
+type: minor
+epic: EPIC-CORE
+sprint: Sprint 1
+tracker: https://github.com/nan0web/nan.web/issues/{id}
+---
+
+# v1.0.0 — Core Release Inspector
+
+## Опис та Мета
+Створення CLI інструменту інспекції релізів.
+
+## Команда
+- **Lead / Architect:** Олександр Снігірьов (@snigirev)
+- **AI Lead Developer:** Agent Antigravity (@agy)
+
+## Робочий План та Задачі
+- [x] [#101] Core inspection logic
+- [ ] [#102] Multi-format reporter
+
+## Паритет Даних
+| Колекція | Очікувано | Фактично | Статус | Коментар |
+| :--- | :---: | :---: | :---: | :--- |
+| releases | 1 | 1 | ✅ OK | Synced |
+`
+		const userMd = `---
+hours: 1.5
+iterations: 4
+rrs: 330
+---
+# Metrics
+Hours: 1.5h
+Iterations: 4
+RRS: 330
+`
+
+		const db = new DB({
+			predefined: [
+				['package.json', { name: '@nan0web/sample', version: '1.0.0' }],
+				['releases/1/0/v1.0.0/release.md', releaseMd],
+				['releases/1/0/v1.0.0/user.md', userMd],
+				['releases/1/0/v1.0.0/task.spec.js', '// spec'],
+			],
+		})
+		await db.connect()
+
+		// 1. Text format
+		const cmdText = new ValidateCommand({ target: '.' }, { db })
+		const genText = cmdText.run()
+		let step = await genText.next()
+		while (!step.done) {
+			step = await genText.next()
+		}
+		const resText = step.value?.data || step.value
+		assert.ok(resText.success)
+		assert.equal(resText.releases.length, 1)
+		assert.match(resText.output, /Release \[v1\.0\.0\] ✅ VALID/)
+		assert.match(resText.output, /Core inspection logic/)
+
+		// 2. JSON format
+		const cmdJson = new ValidateCommand({ target: '.', format: 'json' }, { db })
+		const genJson = cmdJson.run()
+		step = await genJson.next()
+		while (!step.done) {
+			step = await genJson.next()
+		}
+		const resJson = step.value?.data || step.value
+		assert.ok(resJson.success)
+		const parsed = JSON.parse(resJson.output)
+		assert.equal(parsed.releases[0].tasks.length, 2)
+		assert.equal(parsed.releases[0].parity.length, 1)
+
+		// 3. CSV format with file export
+		const cmdCsv = new ValidateCommand({ target: '.', format: 'csv', output: 'export.csv' }, { db })
+		const genCsv = cmdCsv.run()
+		step = await genCsv.next()
+		while (!step.done) {
+			step = await genCsv.next()
+		}
+		const savedCsv = await db.loadDocument('export.csv', null)
+		assert.ok(savedCsv)
+		assert.match(savedCsv, /v1\.0\.0,101,Core inspection logic,done/)
+	})
+})

package/src/domain/ViewCommand.js

@@ -0,0 +1,99 @@
+import { ModelAsApp, show, result, ask } from '@nan0web/ui'
+import { select } from '@nan0web/ui-cli'
+import Scanner from '../Release/Scanner.js'
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+
+/**
+ * ViewCommand - ModelAsApp Subcommand to inspect and view release details across multimodal interfaces.
+ */
+export default class ViewCommand extends ModelAsApp {
+	static alias = 'view'
+
+	static UI = {
+		title: 'view',
+		help: 'View release summary and launch multimodal playgrounds (CLI, TUI, WEB, CHAT, VOICE)',
+		noReleases: 'No releases found in current directory.',
+		selectPrompt: 'Select release version to view:',
+	}
+
+	static version = {
+		help: 'Target release version (e.g. v3.4.0). If omitted, latest version is used.',
+		positional: true,
+		type: 'string',
+		default: '',
+	}
+
+	/**
+	 * @param {Partial<ViewCommand>} [data]
+	 * @param {import('@nan0web/types').ModelOptions} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} */
+		this.version = String(data.version || (options && 'version' in options ? /** @type {any} */ (options).version : ''))
+	}
+
+	async *run() {
+		const targetDir = process.env.RELEASE_CWD || process.env.INIT_CWD || process.cwd()
+		const scanner = new Scanner(targetDir)
+		const statuses = scanner.status()
+
+		if (!statuses.length) {
+			yield show(ViewCommand.UI.noReleases, 'warn')
+			return result({ success: false })
+		}
+
+		// Sort SemVer descending (newest first)
+		const sorted = [...statuses].sort((a, b) => b.version.localeCompare(a.version, undefined, { numeric: true }))
+
+		let targetVer = this.version
+		if (!targetVer) {
+			// If not specified via CLI arguments, pick the newest
+			targetVer = sorted[0].version
+		}
+
+		const current = sorted.find((s) => s.version === targetVer) || sorted[0]
+		targetVer = current.version
+
+		// Find release dir
+		const allSpecs = scanner.findSpecs(targetVer)
+		const allTests = scanner.findTests(targetVer)
+		const entry = allSpecs[0] || allTests[0]
+		const releaseDir = entry ? entry.dir : ''
+
+		let progressStr = '100%'
+		let taskCount = '8/8'
+
+		if (releaseDir) {
+			try {
+				const taskRaw = await readFile(join(releaseDir, 'task.md'), 'utf8')
+				const completed = (taskRaw.match(/- \[[xX]\]/g) || []).length
+				const pending = (taskRaw.match(/- \[ \]/g) || []).length
+				const total = completed + pending
+				if (total > 0) {
+					const pct = Math.round((completed / total) * 100)
+					progressStr = `${pct}%`
+					taskCount = `${completed}/${total}`
+				}
+			} catch {}
+		}
+
+		yield show(`Release ${targetVer}`)
+		yield show(`Progress ${progressStr} (${taskCount})`)
+		yield show('Playground available for CLI, TUI, WEB, CHAT, VOICE to see releases run:')
+		yield show('  pnpm exec serve releases # WEB version (http://localhost:3131)')
+		yield show('  pnpm exec release        # CLI version')
+		yield show('  pnpm exec release --tui  # TUI version')
+		yield show(`  pnpm exec release --chat "Show me a release where I have added ${targetVer} features" # CHAT version`)
+
+		return result({
+			version: targetVer,
+			progress: progressStr,
+			tasks: taskCount,
+			dir: releaseDir,
+		})
+	}
+}
+
+export { ViewCommand }

package/src/domain/WebCommand.js

@@ -0,0 +1,140 @@
+import { ModelAsApp, result, show, progress } from '@nan0web/ui'
+import { DashboardModel } from './Dashboard/DashboardModel.js'
+
+/**
+ * WebCommand - ModelAsApp Subcommand to generate and launch PM-as-Code Web Dashboard.
+ */
+export default class WebCommand extends ModelAsApp {
+	static alias = 'web'
+
+	static UI = {
+		title: 'web',
+		help: 'Generate and launch PM-as-Code Web Dashboard',
+		loading: 'Aggregating release metrics for Web Dashboard...',
+		generated: '✨ Web Dashboard успішно згенеровано: {$path}',
+		serving: '🌐 Web Dashboard запущено: http://localhost:{$port} (Натисніть Ctrl+C для зупинки)',
+	}
+
+	static registryFile = {
+		help: 'Path to releases.txt registry file',
+		default: 'releases.txt',
+		type: 'string',
+		alias: 'f',
+	}
+
+	static out = {
+		help: 'Destination path for HTML dashboard',
+		default: 'apps/release.app/play/index.html',
+		type: 'string',
+		alias: 'o',
+	}
+
+	static port = {
+		help: 'Port to serve HTML dashboard over HTTP (e.g. 3333)',
+		default: 0,
+		type: 'number',
+		alias: 'p',
+	}
+
+	static open = {
+		help: 'Automatically open in browser',
+		default: false,
+		type: 'boolean',
+	}
+
+	/**
+	 * @param {Partial<WebCommand>} [data]
+	 * @param {import('@nan0web/types').ModelOptions} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} */ this.registryFile = String(data.registryFile || 'releases.txt')
+		/** @type {string} */ this.out = String(data.out || 'apps/release.app/play/index.html')
+		/** @type {number} */ this.port = Number(data.port ?? options.port ?? 0)
+		/** @type {boolean} */ this.open = Boolean(data.open ?? options.open ?? false)
+	}
+
+	async *run() {
+		const db = this._?.db || this.db
+		let gitTelemetry = null
+		try {
+			gitTelemetry = await import('../utils/nodejs/GitTelemetry.js')
+		} catch {}
+		const dashboardModel = new DashboardModel(
+			{ registryFile: this.registryFile || 'releases.txt' },
+			{ db, gitTelemetry }
+		)
+		for await (const p of dashboardModel.aggregateStream()) {
+			yield progress(`[${p.current}/${p.total}] Scanning ${p.project}...`, p.current, p.total, {
+				id: 'web-dashboard',
+			})
+		}
+		const summary = dashboardModel.summary
+		const projects = dashboardModel.projects
+
+		// Dynamically load ReleaseDashboard from release.app if available or render inline
+		let html = ''
+		try {
+			const { ReleaseDashboard } =
+				await import('../../../../apps/release.app/src/ui/web/ReleaseDashboard.js')
+			const dashboard = new ReleaseDashboard({ summary, projects })
+			html = dashboard.render()
+		} catch (err) {
+			html = `<!DOCTYPE html><html><body><h1>Dashboard: ${summary.totalProjects} projects</h1><p>${err.message}</p></body></html>`
+		}
+
+		const outPath = this.out || 'apps/release.app/play/index.html'
+		await db.saveDocument(outPath, html)
+
+		yield progress('', 100, { id: 'web-dashboard', stop: 'success' })
+		yield show(WebCommand.UI.generated.replace('{$path}', outPath), 'info')
+
+		if (this.port > 0) {
+			try {
+				const { createServer } = await import('node:http')
+				const server = createServer((req, res) => {
+					res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
+					res.end(html)
+				})
+				server.listen(this.port)
+				yield show(WebCommand.UI.serving.replace('{$port}', String(this.port)), 'success')
+
+				if (this.open) {
+					try {
+						const { exec } = await import('node:child_process')
+						exec(`open http://localhost:${this.port}`)
+					} catch {}
+				}
+
+				if (typeof process !== 'undefined' && process.stdin) {
+					await new Promise((resolve) => {
+						process.on('SIGINT', () => {
+							server.close()
+							resolve(null)
+						})
+					})
+				}
+			} catch (err) {
+				yield show(
+					`⚠️ Не вдалося запустити HTTP сервер на порті ${this.port}: ${err.message}`,
+					'error'
+				)
+			}
+		} else if (this.open) {
+			try {
+				const { exec } = await import('node:child_process')
+				exec(`open "${outPath}"`)
+			} catch {}
+		}
+
+		return result({
+			status: 'ok',
+			outPath,
+			summary,
+			projects,
+			port: this.port,
+		})
+	}
+}
+
+export { WebCommand }