@nan0web/release 3.2.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

@@ -26,6 +26,10 @@ declare class ReleaseDocument extends Markdown {
     version: string;
     /** @type {Date | undefined} */
     date: Date | undefined;
+    sections: {
+        title: string;
+        tasks: any[];
+    }[] | undefined;
 }
 import Markdown from '@nan0web/markdown';
 import Person from './Person.js';

package/types/Release/Scanner.d.ts

@@ -19,9 +19,9 @@
  */
 export default class Scanner {
     /**
-     * @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;
     /**

package/types/domain/App.d.ts

@@ -1,17 +1,33 @@
 export class ReleaseApp extends ModelAsApp {
+    static alias: string;
+    static UI: {
+        title: string;
+    };
     static command: {
         help: string;
-        options: (typeof CheckCommand | typeof StatusCommand)[];
+        options: (typeof CheckCommand | typeof CloseCommand | typeof DepsCommand | typeof PublishCommand | typeof StatusCommand | typeof WebCommand | typeof ListCommand | typeof ServeCommand)[];
         positional: boolean;
-        default: null;
+        default: typeof ViewCommand;
     };
     /**
      * @param {Partial<ReleaseApp>} [data]
      * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
      */
     constructor(data?: Partial<ReleaseApp>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
-    /** @type {ModelAsApp} Subcommand to run */ command: ModelAsApp;
+    /**
+     * Run the main controller logic.
+     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, any, any>}
+     */
+    run(): AsyncGenerator<import("@nan0web/ui").Intent, any, any>;
 }
+export default ReleaseApp;
 import { ModelAsApp } from "@nan0web/ui";
 import CheckCommand from './CheckCommand.js';
+import CloseCommand from './CloseCommand.js';
+import DepsCommand from './DepsCommand.js';
+import PublishCommand from './PublishCommand.js';
 import StatusCommand from './StatusCommand.js';
+import WebCommand from './WebCommand.js';
+import ListCommand from './ListCommand.js';
+import ServeCommand from './ServeCommand.js';
+import ViewCommand from './ViewCommand.js';

package/types/domain/BumpCommand.d.ts

@@ -1,5 +1,8 @@
 /**
  * Command to bump the version of changed packages in the monorepo.
+ * @property {string} version Target version to set
+ * @property {string} since Git reference to diff against
+ * @property {boolean} dryRun Run the command without making any changes
  */
 export default class BumpCommand extends ModelAsApp {
     static version: {
@@ -32,8 +35,11 @@ export default class BumpCommand extends ModelAsApp {
      * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
      */
     constructor(data?: Partial<BumpCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
-    /** @type {string} Target version */ version: string;
-    /** @type {string} Since reference */ since: string;
-    /** @type {boolean} Dry run */ dryRun: boolean;
+    /** @type {string} Target version */
+    version: string;
+    /** @type {string} Git reference to diff against */
+    since: string;
+    /** @type {boolean} Run without making changes */
+    dryRun: boolean;
 }
 import { ModelAsApp } from '@nan0web/ui';

package/types/domain/CheckCommand.d.ts

@@ -1,24 +1,136 @@
-export default class CheckCommand extends ModelAsApp {
+/**
+ * @typedef {Object} DiagnosticItem
+ * @property {'error' | 'warning' | 'info'} level
+ * @property {string} code
+ * @property {string} project
+ * @property {string} message
+ * @property {string} file
+ * @property {string} fix
+ */
+/**
+ * CheckCommand - PM-as-Code Release Structure & Compliance Validator.
+ */
+export class CheckCommand extends ModelAsApp {
+    static alias: string;
     static UI: {
+        errorDbRequired: string;
         title: string;
-        icon: string;
-        description: string;
+        header: string;
+        scanningCount: string;
+        projectHeader: string;
+        missingPackageJson: string;
+        packageJsonValid: string;
+        noReleasesDir: string;
+        releasesDirFound: string;
+        releaseHeader: string;
+        releaseDocCompleted: string;
+        missingReleaseDoc: string;
+        missingUserDoc: string;
+        incompleteUserMetrics: string;
+        userMetricsValid: string;
+        ambiguousContracts: string;
+        missingContract: string;
+        activeContractWip: string;
+        sealedRegressionClosed: string;
+        orphanFile: string;
+        recommendationsHeader: string;
+        recommendationItem: string;
+        summary: string;
+        Diagnostics: {
+            MISSING_PACKAGE_JSON: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_RELEASES_DIR: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_RELEASE_MD: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_USER_MD: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            INCOMPLETE_USER_METRICS: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            AMBIGUOUS_CONTRACTS: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            MISSING_CONTRACT: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+            ORPHAN_RELEASE_FILE: {
+                level: string;
+                code: string;
+                message: string;
+                fix: string;
+            };
+        };
+    };
+    static target: {
+        help: string;
+        default: string;
+        type: string;
+        positional: boolean;
+    };
+    static registryFile: {
+        help: string;
+        default: string;
+        type: string;
+        alias: string;
+    };
+    static all: {
+        help: string;
+        default: boolean;
+        type: string;
+        alias: string;
     };
-    static name: string;
-    /**
-     * @returns {AsyncGenerator<any, any, any>}
-     */
-    run(): AsyncGenerator<any, any, any>;
     /**
-     * @param {string} absDir
-     * @returns {Promise<string[]>}
+     * @param {Partial<CheckCommand>} [data]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
      */
-    _scanLocal(absDir: string): Promise<string[]>;
+    constructor(data?: Partial<CheckCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {string} */ target: string;
+    /** @type {string} */ registryFile: string;
+    /** @type {boolean} */ all: boolean;
     /**
-     * @param {string} base
-     * @param {string} [dir]
-     * @returns {Promise<string[]>}
+     * Execute release structure check
+     * @returns {AsyncGenerator<import('@nan0web/ui').Intent, { success: boolean, diagnostics: DiagnosticItem[], checkedProjects: any[] }, any>}
      */
-    _scanDirRecursive(base: string, dir?: string): Promise<string[]>;
+    run(): AsyncGenerator<import("@nan0web/ui").Intent, {
+        success: boolean;
+        diagnostics: DiagnosticItem[];
+        checkedProjects: any[];
+    }, any>;
+    #private;
 }
+export default CheckCommand;
+export type DiagnosticItem = {
+    level: "error" | "warning" | "info";
+    code: string;
+    project: string;
+    message: string;
+    file: string;
+    fix: string;
+};
 import { ModelAsApp } from '@nan0web/ui';

package/types/domain/CheckCommand.story.d.ts

@@ -0,0 +1 @@
+export {};

package/types/domain/CloseCommand.d.ts

@@ -12,6 +12,7 @@ export default class CloseCommand extends ModelAsApp {
      * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
      */
     constructor(data?: Partial<CloseCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
-    /** @type {string} Release version */ version: string;
+    /** @type {string} Release version */
+    version: string;
 }
 import { ModelAsApp } from '@nan0web/ui';

package/types/domain/Dashboard/Dashboard.story.d.ts

@@ -0,0 +1 @@
+export {};