@nan0web/release 3.3.0 → 3.4.0

package/src/domain/templates/release.html.template.js

@@ -0,0 +1,34 @@
+export default `<!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>`

package/src/index.js

@@ -30,3 +30,9 @@ export { default as DepsCommand } from './domain/DepsCommand.js'
 export { default as PublishCommand } from './domain/PublishCommand.js'
 export { default as SpecCommand } from './domain/SpecCommand.js'
 export { default as StatusCommand } from './domain/StatusCommand.js'
+export { default as WebCommand } from './domain/WebCommand.js'
+export { default as PreviewCommand } from './domain/PreviewCommand.js'
+export { RegistryModel } from './domain/Registry/RegistryModel.js'
+export { DashboardModel } from './domain/Dashboard/DashboardModel.js'
+export { ReleaseAuditor } from './domain/inspect/ReleaseAuditor.js'
+

package/src/inspectors/inspect-js.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+// Inspector: checks JavaScript/TypeScript files for syntax errors using `node --check`.
+// Uses git to obtain list of changed files in the current HEAD.
+const { execSync } = require('child_process');
+
+function getChangedFiles() {
+  try {
+    const output = execSync('git diff --name-only --diff-filter=ACM HEAD', { encoding: 'utf8' });
+    return output.split(/\n/).filter(f => f.match(/\.(js|ts)$/));
+  } catch (e) {
+    console.error('Failed to obtain changed files:', e.message);
+    process.exit(1);
+  }
+}
+
+function checkFile(file) {
+  console.log(`🔎 Checking ${file}`);
+  try {
+    execSync(`node --check ${file}`, { stdio: 'inherit' });
+  } catch (e) {
+    console.error(`❌ Syntax error in ${file}`);
+    process.exit(1);
+  }
+}
+
+const files = getChangedFiles();
+if (files.length === 0) {
+  console.log('✅ No JavaScript/TypeScript files changed.');
+  process.exit(0);
+}
+files.forEach(checkFile);
+process.exit(0);

package/src/releases/1/0/v1.0.3/task.test.js

@@ -9,7 +9,7 @@ describe('Release v3.0.0 - Dependency Alignment', () => {
 		const pkgPath = join(process.cwd(), 'package.json')
 		const pkg = JSON.parse(await readFile(pkgPath, 'utf8'))
 
-		assert.ok(/^3\.1\.\d+$/.test(pkg.version), 'Version should start with 3.1')
+		assert.ok(/^3\.\d+\.\d+$/.test(pkg.version), 'Version should start with 3.x')
 		assert.ok(/^(\^1\.8\.0|workspace:\*)$/.test(pkg.dependencies['@nan0web/ui']), '@nan0web/ui should be ^1.8.0 or workspace:*')
 		assert.ok(/^(\^2\.9\.0|workspace:\*)$/.test(pkg.dependencies['@nan0web/ui-cli']), '@nan0web/ui-cli should be ^2.9.0 or workspace:*')
 	})

package/src/utils/nodejs/GitTelemetry.js

@@ -0,0 +1,154 @@
+import fs from 'node:fs'
+import { execSync } from 'node:child_process'
+
+let rootGitStatusCache = null
+let rootGitBranchCache = null
+const gitInfoCache = new Map()
+const gitTelemetryCache = new Map()
+
+/**
+ * Reset internal Git caches (useful for testing or cache invalidation)
+ */
+export function resetGitCache() {
+	rootGitStatusCache = null
+	rootGitBranchCache = null
+	gitInfoCache.clear()
+	gitTelemetryCache.clear()
+}
+
+/**
+ * Retrieve git branch and workspace status (clean / dirty)
+ * @param {string} [projectDir]
+ * @returns {{ branch: string, gitStatus: 'clean' | 'dirty' }}
+ */
+export function getGitInfo(projectDir) {
+	const key = projectDir || process.cwd()
+	const isMonorepoInternal =
+		!projectDir ||
+		projectDir === '.' ||
+		(!projectDir.startsWith('../') && !projectDir.startsWith('/'))
+
+	if (isMonorepoInternal) {
+		if (rootGitStatusCache === null) {
+			try {
+				rootGitBranchCache =
+					execSync('git rev-parse --abbrev-ref HEAD', {
+						cwd: process.cwd(),
+						stdio: ['ignore', 'pipe', 'ignore'],
+						encoding: 'utf8',
+					}).trim() || 'main'
+				rootGitStatusCache = execSync('git status --porcelain', {
+					cwd: process.cwd(),
+					stdio: ['ignore', 'pipe', 'ignore'],
+					encoding: 'utf8',
+				}).trim()
+			} catch {
+				rootGitBranchCache = 'main'
+				rootGitStatusCache = ''
+			}
+		}
+		const normPrefix =
+			projectDir && projectDir !== '.'
+				? `${projectDir.replace(/\/+$/, '')}/`
+				: ''
+		const isDirty = normPrefix
+			? rootGitStatusCache
+					.split('\n')
+					.some((line) => line.slice(3).trim().startsWith(normPrefix))
+			: rootGitStatusCache.length > 0
+
+		return {
+			branch: rootGitBranchCache,
+			gitStatus: isDirty ? 'dirty' : 'clean',
+		}
+	}
+
+	if (gitInfoCache.has(key)) return gitInfoCache.get(key)
+	if (fs.existsSync && !fs.existsSync(key)) {
+		const res = { branch: 'main', gitStatus: 'clean' }
+		gitInfoCache.set(key, res)
+		return res
+	}
+
+	try {
+		const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+			cwd: key,
+			stdio: ['ignore', 'pipe', 'ignore'],
+			encoding: 'utf8',
+		}).trim()
+		const statusOutput = execSync('git status --porcelain', {
+			cwd: key,
+			stdio: ['ignore', 'pipe', 'ignore'],
+			encoding: 'utf8',
+		}).trim()
+		const res = {
+			branch: branch || 'main',
+			gitStatus: statusOutput.length > 0 ? 'dirty' : 'clean',
+		}
+		gitInfoCache.set(key, res)
+		return res
+	} catch {
+		const res = { branch: 'main', gitStatus: 'clean' }
+		gitInfoCache.set(key, res)
+		return res
+	}
+}
+
+/**
+ * Retrieve development hours and iterations from git commit log
+ * @param {string} [projectDir]
+ * @param {string} [releasePath]
+ * @returns {{ hours: number, iterations: number }}
+ */
+export function getGitCommitTelemetry(projectDir, releasePath) {
+	const targetDir = releasePath || projectDir
+	if (!targetDir) return { hours: 0, iterations: 0 }
+	if (gitTelemetryCache.has(targetDir)) return gitTelemetryCache.get(targetDir)
+	if (fs.existsSync && !fs.existsSync(targetDir)) {
+		const res = { hours: 0, iterations: 0 }
+		gitTelemetryCache.set(targetDir, res)
+		return res
+	}
+
+	try {
+		const logOutput = execSync(
+			`git log --format="%at" -n 50 -- "${targetDir}"`,
+			{
+				cwd: process.cwd(),
+				stdio: ['ignore', 'pipe', 'ignore'],
+				encoding: 'utf8',
+			}
+		).trim()
+
+		if (!logOutput) {
+			const res = { hours: 0, iterations: 0 }
+			gitTelemetryCache.set(targetDir, res)
+			return res
+		}
+
+		const timestamps = logOutput
+			.split('\n')
+			.map((t) => parseInt(t.trim(), 10))
+			.filter((t) => !isNaN(t))
+
+		if (timestamps.length < 2) {
+			const res = { hours: 0.5, iterations: timestamps.length }
+			gitTelemetryCache.set(targetDir, res)
+			return res
+		}
+
+		const minT = Math.min(...timestamps)
+		const maxT = Math.max(...timestamps)
+		const diffHours = Math.round(((maxT - minT) / 3600) * 10) / 10
+		const hours = diffHours > 0 ? diffHours : 0.5
+		const iterations = timestamps.length
+
+		const res = { hours, iterations }
+		gitTelemetryCache.set(targetDir, res)
+		return res
+	} catch {
+		const res = { hours: 0, iterations: 0 }
+		gitTelemetryCache.set(targetDir, res)
+		return res
+	}
+}

package/types/Release/Document.d.ts

@@ -1,14 +1,10 @@
-import Markdown, { MDElement } from '@nan0web/markdown';
-import Person from './Person.js';
+export default ReleaseDocument;
 declare class ReleaseDocument extends Markdown {
-    /** @type {Person[]} */
-    team: Person[];
-    /** @type {Map<string, Person[]>} */
-    roles: Map<string, Person[]>;
-    /** @type {string} */
-    version: string;
-    /** @type {Date | undefined} */
-    date: Date | undefined;
+    /**
+     * @param {*} input
+     * @returns {ReleaseDocument}
+     */
+    static from(input: any): ReleaseDocument;
     /**
      * @param {Object} options
      * @param {Array} [options.team] - Release team members
@@ -17,22 +13,23 @@ declare class ReleaseDocument extends Markdown {
      * @param {string} [options.date] - Release date
      */
     constructor(options?: {
-        team?: any[];
-        roles?: Map<any, any> | any[];
-        version?: string;
-        date?: string;
+        team?: any[] | undefined;
+        roles?: any[] | Map<any, any> | undefined;
+        version?: string | undefined;
+        date?: string | undefined;
     });
-    /**
-     * Parse release document content
-     * Extracts version and date from H1 heading
-     * @param {string} input - Markdown content
-     * @returns {MDElement[]}
-     */
-    parse(input: string): MDElement[];
-    /**
-     * @param {*} input
-     * @returns {ReleaseDocument}
-     */
-    static from(input: any): ReleaseDocument;
+    /** @type {Person[]} */
+    team: Person[];
+    /** @type {Map<string, Person[]>} */
+    roles: Map<string, Person[]>;
+    /** @type {string} */
+    version: string;
+    /** @type {Date | undefined} */
+    date: Date | undefined;
+    sections: {
+        title: string;
+        tasks: any[];
+    }[] | undefined;
 }
-export default ReleaseDocument;
+import Markdown from '@nan0web/markdown';
+import Person from './Person.js';

package/types/Release/MarkdownToTest.d.ts

@@ -1,3 +1,4 @@
+export default MarkdownToTest;
 /**
  * MarkdownToTest - generates node:test code from markdown release notes
  * Enables writing release notes first, then generating executable tests
@@ -44,4 +45,3 @@ declare class MarkdownToTest {
         tasks: any[];
     }>): string;
 }
-export default MarkdownToTest;

package/types/Release/Person.d.ts

@@ -1,15 +1,17 @@
-import { HumanName, HumanContact, HumanGender } from '@nan0web/logos';
 export default class Person {
+    /**
+     * @param {*} input
+     * @returns {Person}
+     */
+    static from(input: any): Person;
+    constructor(input?: {});
     /** @type {HumanName} */
     name: HumanName;
     /** @type {HumanGender} */
     gender: HumanGender;
     /** @type {HumanContact[]} */
     contacts: HumanContact[];
-    constructor(input?: {});
-    /**
-     * @param {*} input
-     * @returns {Person}
-     */
-    static from(input: any): Person;
 }
+import { HumanName } from '@nan0web/logos';
+import { HumanGender } from '@nan0web/logos';
+import { HumanContact } from '@nan0web/logos';

package/types/Release/Scanner.d.ts

@@ -1,39 +1,3 @@
-export type ContractEntry = {
-    /**
-     * - Release version (e.g. "v1.0.0")
-     */
-    version: string;
-    /**
-     * - Absolute path to the contract file
-     */
-    path: string;
-    /**
-     * - "spec" or "test"
-     */
-    type: string;
-    /**
-     * - Directory containing the contract
-     */
-    dir: string;
-};
-export type VersionStatus = {
-    /**
-     * - Release version
-     */
-    version: string;
-    /**
-     * - Version state
-     */
-    state: 'wip' | 'closed' | 'mixed';
-    /**
-     * - Paths to spec files
-     */
-    specs: string[];
-    /**
-     * - Paths to test files
-     */
-    tests: string[];
-};
 /**
  * @typedef {Object} ContractEntry
  * @property {string} version - Release version (e.g. "v1.0.0")
@@ -54,13 +18,12 @@ export type VersionStatus = {
  * та плоску: releases/v{version}/
  */
 export default class Scanner {
-    #private;
-    /** @type {string} */
-    root: string;
     /**
-     * @param {string} root - Root directory of the project
+     * @param {string} [root] - Root directory of the project
      */
-    constructor(root: string);
+    constructor(root?: string);
+    /** @type {string} */
+    root: string;
     /**
      * Find all .spec.js files (WIP contracts)
      * @param {string} [version] - Optional version filter
@@ -87,4 +50,41 @@ export default class Scanner {
         closed: number;
         files: string[];
     };
+    #private;
 }
+export type ContractEntry = {
+    /**
+     * - Release version (e.g. "v1.0.0")
+     */
+    version: string;
+    /**
+     * - Absolute path to the contract file
+     */
+    path: string;
+    /**
+     * - "spec" or "test"
+     */
+    type: string;
+    /**
+     * - Directory containing the contract
+     */
+    dir: string;
+};
+export type VersionStatus = {
+    /**
+     * - Release version
+     */
+    version: string;
+    /**
+     * - Version state
+     */
+    state: "wip" | "closed" | "mixed";
+    /**
+     * - Paths to spec files
+     */
+    specs: string[];
+    /**
+     * - Paths to test files
+     */
+    tests: string[];
+};

package/types/Release.d.ts

@@ -1,39 +1,3 @@
-import ReleaseDocument from './Release/Document.js';
-import Logger from '@nan0web/log';
-export type ReleaseConfig = {
-    /**
-     * - Release version
-     */
-    version?: string;
-    /**
-     * -
-     */
-    createdAt?: string | number | Date | undefined;
-    /**
-     * - Alias for createdAt
-     */
-    date?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    startAt?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    planAt?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    completeAt?: string | number | Date | undefined;
-    /**
-     * -
-     */
-    document?: string | ReleaseDocument;
-    /**
-     * - Task map with test functions
-     */
-    tasks?: Map<string, Function>;
-};
 /**
  * @typedef {Object} ReleaseConfig
  * @property {string} [version] - Release version
@@ -49,6 +13,11 @@ export type ReleaseConfig = {
  * Release management class that coordinates task validation and release execution
  */
 export default class Release {
+    /**
+     * Creates a Release instance
+     * @param {ReleaseConfig} config - Release configuration
+     */
+    constructor(config?: ReleaseConfig);
     /** @type {string} */
     version: string;
     /** @type {Date} */
@@ -65,11 +34,6 @@ export default class Release {
     document: ReleaseDocument;
     /** @type {Logger} */
     logger: Logger;
-    /**
-     * Creates a Release instance
-     * @param {ReleaseConfig} config - Release configuration
-     */
-    constructor(config?: ReleaseConfig);
     get path(): string;
     /**
      * Validate release by running all task tests
@@ -83,7 +47,7 @@ export default class Release {
      * @returns {Promise<boolean>} Release success status
      */
     execute(options?: {
-        ignoreFailTests?: boolean;
+        ignoreFailTests?: boolean | undefined;
     }): Promise<boolean>;
     /**
      * Get release progress statistics
@@ -91,3 +55,39 @@ export default class Release {
      */
     getProgress(): Promise<any>;
 }
+export type ReleaseConfig = {
+    /**
+     * - Release version
+     */
+    version?: string | undefined;
+    /**
+     * -
+     */
+    createdAt?: string | number | Date | undefined;
+    /**
+     * - Alias for createdAt
+     */
+    date?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    startAt?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    planAt?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    completeAt?: string | number | Date | undefined;
+    /**
+     * -
+     */
+    document?: string | ReleaseDocument | undefined;
+    /**
+     * - Task map with test functions
+     */
+    tasks?: Map<string, Function> | undefined;
+};
+import ReleaseDocument from './Release/Document.js';
+import Logger from '@nan0web/log';