@nan0web/release 1.0.3 → 3.1.1

package/src/domain/DepsCommand.js

@@ -0,0 +1,104 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+import { runSpawn } from '@nan0web/test'
+
+export default class DepsCommand extends ModelAsApp {
+	static fix = {
+		help: 'Apply fixes automatically',
+		default: false,
+	}
+	static latest = {
+		help: 'Update @nan0web packages to the latest available versions',
+		default: false,
+	}
+	static UI = {
+		title: 'deps',
+		help: 'Dependencies manager',
+	}
+
+	/**
+	 * @param {Partial<DepsCommand>} [data]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {boolean} Apply fixes automatically */ this.fix
+		/** @type {boolean} Update packages to the latest available versions */ this.latest
+	}
+
+	/**
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+	 */
+	async *run() {
+		const { t, db } = /** @type {any} */ (this._)
+		const pkg = await db.loadDocument('package.json', {})
+		yield show(t('Loaded package.json, {bytes} bytes', { bytes: JSON.stringify(pkg).length }))
+
+		const deps = {
+			devDependencies: pkg?.devDependencies ?? {},
+			dependencies: pkg?.dependencies ?? {},
+			peerDependencies: pkg?.peerDependencies ?? {},
+		}
+		const fixes = new Map()
+		const fails = new Set()
+
+		const isLocal = (ver) =>
+			['workspace:', 'link:'].some((p) => String(ver).toLowerCase().startsWith(p))
+
+		const changes = new Map()
+
+		for (const [group, map] of Object.entries(deps)) {
+			yield show(t('{group} ({count} items)', { group, count: Object.keys(map).length }))
+			for (const [dep, ver] of Object.entries(map ?? {})) {
+				if (isLocal(ver) || this.latest) {
+					const resultSpawn = await runSpawn('npm', ['info', dep, '--json'])
+					if (resultSpawn.code !== 0) {
+						throw new Error(t('Cannot retrieve npm package info'))
+					}
+					try {
+						const data = JSON.parse(resultSpawn.text)
+						if (data.version) {
+							fixes.set(dep, data.version)
+							yield show(t('  {dep}: {ver} → {version}', { dep, ver, version: data.version }), 'warn')
+						} else {
+							fails.add(dep)
+							yield show(t('  {dep}: 404 — not found', { dep }), 'error')
+						}
+					} catch (err) {
+						yield show(String(err), 'error')
+					}
+				} else {
+					yield show(t('  {dep}: {ver}', { dep, ver }), 'success')
+				}
+			}
+		}
+
+		if (fails.size) {
+			throw new Error(t('Some dependencies are not yet published on npm: {list}', { list: [...fails].join(', ') }))
+		}
+
+		if ((this.fix || this.latest) && fixes.size) {
+			for (const [dep, ver] of fixes) {
+				const args = ['install']
+				if (pkg.devDependencies?.[dep]) {
+					pkg.devDependencies[dep] = ver
+					args.push('--save-dev')
+				}
+				if (pkg.dependencies?.[dep]) pkg.dependencies[dep] = ver
+				args.push(dep + '@latest')
+				if (this.latest) {
+					yield show(t('Installing dependency...'))
+					await runSpawn('npm', args)
+				}
+				changes.set(dep, `${dep}: ${ver}`)
+				yield show(t('Fixed {dep} → {ver}', { dep, ver }), 'success')
+			}
+			await db.saveDocument('package.json', pkg)
+			yield show(t('Fixes saved ({count} changes)', { count: changes.size }), 'success')
+			yield show(t('Dependencies fixed'))
+		} else {
+			yield show(t('Run with --fix to apply {count} available fixes', { count: fixes.size }))
+			yield show(t('Dependencies check completed'))
+		}
+		return result({})
+	}
+}

package/src/domain/InitCommand.js

@@ -0,0 +1,57 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+
+export default class InitCommand extends ModelAsApp {
+	static version = {
+		help: 'Release version',
+		default: '',
+		errorRequired: 'Version is required (e.g. --version=1.0.0 or --version=v1.0.0)',
+	}
+	static UI = {
+		title: 'init',
+		help: 'Initialize a new release structure',
+	}
+
+	/**
+	 * @param {Partial<InitCommand>} [data]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Release version */ this.version
+	}
+
+	/**
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+	 */
+	async *run() {
+		const { t, db } = this._
+		if (!this.version) {
+			throw new Error(t(InitCommand.version.errorRequired))
+		}
+		const v = this.version.startsWith('v') ? this.version : `v${this.version}`
+
+		const parts = v.replace('v', '').split('.')
+		const major = parts[0] || '0'
+		const minor = parts[1] || '0'
+
+		const { mkdirSync, writeFileSync } = await import('node:fs')
+		const { join } = await import('node:path')
+
+		const dir = join(process.cwd(), 'releases', major, minor, v)
+		mkdirSync(dir, { recursive: true })
+
+		const taskPath = join(dir, 'task.md')
+		writeFileSync(taskPath, `# Release ${v}\n\n- [ ] Task 1`, 'utf8')
+
+		const specPath = join(dir, 'test.spec.js')
+		writeFileSync(
+			specPath,
+			`import test from 'node:test'\nimport assert from 'node:assert'\n\ntest('Sample spec', () => {\n\tassert.ok(true)\n})\n`,
+			'utf8',
+		)
+
+		yield show(`✅ Initialized release ${v} in ${dir}`, 'success')
+
+		return result({})
+	}
+}

package/src/domain/PublishCommand.js

@@ -0,0 +1,89 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+import { runSpawn } from '@nan0web/test'
+
+export default class PublishCommand extends ModelAsApp {
+	static major = {
+		help: 'Bump major version',
+		default: false,
+	}
+	static minor = {
+		help: 'Bump minor version',
+		default: false,
+	}
+	static patch = {
+		help: 'Bump patch version',
+		default: false,
+	}
+	static UI = {
+		title: 'publish',
+		help: 'Publish npm packages',
+	}
+
+	/**
+	 * @param {Partial<PublishCommand>} [data]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {boolean} Bump major version */ this.major
+		/** @type {boolean} Bump minor version */ this.minor
+		/** @type {boolean} Bump patch version */ this.patch
+	}
+
+	/**
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+	 */
+	async *run() {
+		const bump = this.major ? 'major' : this.minor ? 'minor' : this.patch ? 'patch' : null
+
+		if (bump) {
+			const bumpResult = await runSpawn('npm', ['version', bump])
+			if (bumpResult.code !== 0) throw new Error('Failed to bump version')
+		}
+
+		const db = /** @type {any} */ (this._).db
+		const pkg = await db.loadDocument('package.json', {})
+		const tag = `v${pkg.version}`
+
+		yield show(`🛜 nan0release: publishing @${pkg.name}@${pkg.version}`)
+
+		const diffRes = await runSpawn('git', ['diff', '--quiet'])
+		if (diffRes.code !== 0) throw new Error('Uncommitted changes found')
+
+		const pullRes = await runSpawn('git', ['pull'])
+		if (pullRes.code !== 0) throw new Error('Failed to pull latest changes')
+
+		const cleanRes = await runSpawn('npm', ['run', 'clean'])
+		if (cleanRes.code !== 0) throw new Error('Clean failed')
+
+		const buildRes = await runSpawn('npm', ['run', 'build'])
+		if (buildRes.code !== 0) throw new Error('Build failed')
+
+		const testRes = await runSpawn('npm', ['test'])
+		if (testRes.code !== 0) throw new Error('Tests failed')
+
+		const tagsResult = await runSpawn('git', ['tag'])
+		if (tagsResult.code !== 0) throw new Error('Failed to get tags')
+		const tags = tagsResult.text.split('\n').filter(Boolean)
+
+		if (!tags.includes(tag)) {
+			const tagRes = await runSpawn('git', ['tag', '-a', tag, '-m', `Release ${pkg.version}`])
+			if (tagRes.code !== 0) throw new Error('Tag creation failed')
+			yield show(`Tag ${tag} created`, 'success')
+		} else {
+			yield show(`Tag ${tag} already exists`, 'warn')
+		}
+
+		const pubRes = await runSpawn('pnpm', ['publish', '--access', 'public'])
+		if (pubRes.code !== 0) throw new Error('Publish to npm failed')
+
+		const pushRes = await runSpawn('git', ['push', 'origin', 'main', '--no-verify'])
+		if (pushRes.code !== 0) throw new Error('Git push failed')
+
+		const pushTagsRes = await runSpawn('git', ['push', 'origin', '--tags', '--no-verify'])
+		if (pushTagsRes.code !== 0) throw new Error('Tag push failed')
+
+		yield show(`${pkg.name}@${pkg.version} published.`, 'success')
+		return result({})
+	}
+}

package/src/domain/SpecCommand.js

@@ -0,0 +1,43 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+import { runSpawn } from '@nan0web/test'
+import Scanner from '../Release/Scanner.js'
+
+export default class SpecCommand extends ModelAsApp {
+	static version = {
+		help: 'Release version filter',
+		default: '',
+	}
+	static UI = {
+		title: 'spec',
+		help: 'Run spec testing for the active release',
+	}
+
+	/**
+	 * @param {Partial<SpecCommand>} [data]
+	 * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+	 */
+	constructor(data = {}, options = {}) {
+		super(data, options)
+		/** @type {string} Release version filter */ this.version
+	}
+
+	/**
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+	 */
+	async *run() {
+		yield show(`🛜 nan0release spec ${this.version || 'all'}`)
+		const scanner = new Scanner(process.cwd())
+		const specs = scanner.findSpecs(this.version)
+		if (specs.length === 0) {
+			yield show(`No specs found.`, 'warn')
+			return result({})
+		}
+		const files = specs.map((s) => s.path)
+		const spawnResult = await runSpawn('node', ['--test', ...files])
+		if (spawnResult.code !== 0) {
+			throw new Error('Specs failed')
+		}
+		yield show(`✅ Specs passed`, 'success')
+		return result({})
+	}
+}

package/src/domain/StatusCommand.js

@@ -0,0 +1,25 @@
+import { ModelAsApp, result, show } from '@nan0web/ui'
+import Scanner from '../Release/Scanner.js'
+
+export default class StatusCommand extends ModelAsApp {
+	static UI = {
+		title: 'status',
+		help: 'Show release status',
+	}
+
+	/**
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, import('@nan0web/ui').ResultIntent, any>}
+	 */
+	async *run() {
+		const scanner = new Scanner(process.cwd())
+		const statuses = scanner.status()
+
+		yield show(`🛜 nan0release status`)
+		for (const st of statuses) {
+			yield show(
+				`${st.version.padEnd(10)} | ${st.state.padEnd(6)} | Specs: ${st.specs.length}, Tests: ${st.tests.length}`,
+			)
+		}
+		return result({})
+	}
+}

package/src/index.js

@@ -3,7 +3,12 @@ import ReleaseDocument from './Release/Document.js'
 import Person from './Release/Person.js'
 import Scanner from './Release/Scanner.js'
 import MarkdownToTest from './Release/MarkdownToTest.js'
-import { ProjectManagement, ReleaseManager, TaskTestSuite, ChangelogTaskManager } from './architecture/ProjectManagementAsCode.js'
+import {
+	ProjectManagement,
+	ReleaseManager,
+	TaskTestSuite,
+	ChangelogTaskManager,
+} from './architecture/ProjectManagementAsCode.js'
 
 export {
 	Release,
@@ -14,5 +19,14 @@ export {
 	ProjectManagement,
 	ReleaseManager,
 	TaskTestSuite,
-	ChangelogTaskManager
+	ChangelogTaskManager,
 }
+
+export { ReleaseApp } from './domain/App.js'
+export { default as InitCommand } from './domain/InitCommand.js'
+export { default as CheckCommand } from './domain/CheckCommand.js'
+export { default as CloseCommand } from './domain/CloseCommand.js'
+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'

package/types/Release/Person.d.ts

@@ -12,6 +12,6 @@ export default class Person {
     /** @type {HumanContact[]} */
     contacts: HumanContact[];
 }
-import { HumanName } from '@nan0web/verse';
-import { HumanGender } from '@nan0web/verse';
-import { HumanContact } from '@nan0web/verse';
+import { HumanName } from '@nan0web/logos';
+import { HumanGender } from '@nan0web/logos';
+import { HumanContact } from '@nan0web/logos';

package/types/Team.d.ts

@@ -22,6 +22,6 @@ declare class Person {
     /** @type {HumanContact[]} */
     contacts: HumanContact[];
 }
-import { HumanName } from '@nan0web/verse';
-import { HumanGender } from '@nan0web/verse';
-import { HumanContact } from '@nan0web/verse';
+import { HumanName } from '@nan0web/logos';
+import { HumanGender } from '@nan0web/logos';
+import { HumanContact } from '@nan0web/logos';

package/types/commands/CheckCommand.d.ts

@@ -0,0 +1,24 @@
+export default class CheckCommand extends ModelAsApp {
+    static UI: {
+        title: string;
+        icon: string;
+        description: string;
+    };
+    static name: string;
+    /**
+     * @returns {AsyncGenerator<any, any, any>}
+     */
+    run(): AsyncGenerator<any, any, any>;
+    /**
+     * @param {string} absDir
+     * @returns {Promise<string[]>}
+     */
+    _scanLocal(absDir: string): Promise<string[]>;
+    /**
+     * @param {string} base
+     * @param {string} [dir]
+     * @returns {Promise<string[]>}
+     */
+    _scanDirRecursive(base: string, dir?: string): Promise<string[]>;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/commands/CloseCommand.d.ts

@@ -10,7 +10,7 @@ export default class CloseCommand extends Command {
     run(): AsyncGenerator<OutputMessage, void, unknown>;
 }
 import Command from './Command.js';
-declare class CloseBody {
+declare class CloseBody extends CommandBody {
     static version: {
         help: string;
         defaultValue: string;
@@ -22,4 +22,5 @@ declare class CloseBody {
     version: string;
 }
 import { OutputMessage } from '@nan0web/co';
+import { CommandBody } from './Command.js';
 export {};

package/types/commands/Command.d.ts

@@ -1,5 +1,10 @@
 /** @typedef {import("@nan0web/test/types/exec/runSpawn").SpawnResult} SpawnResult */
+export class CommandBody {
+    static fs: {};
+    static logger: {};
+}
 export default class Command extends UiMessage {
+    static Body: typeof CommandBody;
     /**
      * @param {Partial<UiMessage> & {  }} [input={}]
      */
@@ -8,7 +13,7 @@ export default class Command extends UiMessage {
     fs: DBFS;
     /** @type {Logger} */
     logger: Logger;
-    get Body(): new () => {};
+    get Body(): typeof CommandBody;
     /**
      * Run the command.
      * @param {string} cmd

package/types/commands/DepsCommand.d.ts

@@ -13,7 +13,7 @@ export default class DepsCommand extends Command {
     run(msg?: DepsCommand): AsyncGenerator<OutputMessage>;
 }
 import Command from './Command.js';
-declare class DepsBody {
+declare class DepsBody extends CommandBody {
     static fix: {
         help: string;
         defaultValue: boolean;
@@ -29,4 +29,5 @@ declare class DepsBody {
     latest: boolean;
 }
 import { OutputMessage } from '@nan0web/co';
+import { CommandBody } from './Command.js';
 export {};

package/types/commands/InitCommand.d.ts

@@ -10,7 +10,7 @@ export default class InitCommand extends Command {
     run(): AsyncGenerator<OutputMessage, void, unknown>;
 }
 import Command from './Command.js';
-declare class InitBody {
+declare class InitBody extends CommandBody {
     static version: {
         help: string;
         defaultValue: string;
@@ -22,4 +22,5 @@ declare class InitBody {
     version: string;
 }
 import { OutputMessage } from '@nan0web/co';
+import { CommandBody } from './Command.js';
 export {};

package/types/commands/PublishCommand.d.ts

@@ -10,7 +10,7 @@ export default class PublishCommand extends Command {
     body: PublishBody;
 }
 import Command from './Command.js';
-declare class PublishBody {
+declare class PublishBody extends CommandBody {
     static major: {
         help: string;
         defaultValue: boolean;
@@ -35,4 +35,5 @@ declare class PublishBody {
     /** @type {boolean} */
     patch: boolean;
 }
+import { CommandBody } from './Command.js';
 export {};

package/types/commands/SpecCommand.d.ts

@@ -10,7 +10,7 @@ export default class SpecCommand extends Command {
     run(): AsyncGenerator<OutputMessage, void, unknown>;
 }
 import Command from './Command.js';
-declare class SpecBody {
+declare class SpecBody extends CommandBody {
     static version: {
         help: string;
         defaultValue: string;
@@ -22,4 +22,5 @@ declare class SpecBody {
     version: string;
 }
 import { OutputMessage } from '@nan0web/co';
+import { CommandBody } from './Command.js';
 export {};

package/types/domain/App.d.ts

@@ -0,0 +1,17 @@
+export class ReleaseApp extends ModelAsApp {
+    static command: {
+        help: string;
+        options: (typeof CheckCommand | typeof StatusCommand)[];
+        positional: boolean;
+        default: null;
+    };
+    /**
+     * @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;
+}
+import { ModelAsApp } from "@nan0web/ui";
+import CheckCommand from './CheckCommand.js';
+import StatusCommand from './StatusCommand.js';

package/types/domain/BumpCommand.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Command to bump the version of changed packages in the monorepo.
+ */
+export default class BumpCommand extends ModelAsApp {
+    static version: {
+        help: string;
+        default: string;
+        positional: boolean;
+    };
+    static since: {
+        help: string;
+        default: string;
+        positional: boolean;
+    };
+    static UI: {
+        title: string;
+        help: string;
+        bumping: string;
+        foundChangedPackages: string;
+        detectingChangedPackages: string;
+        noChangesDetected: string;
+        errorDb: string;
+    };
+    /**
+     * @param {Partial<BumpCommand>} [data]
+     * @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;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/CheckCommand.d.ts

@@ -0,0 +1,24 @@
+export default class CheckCommand extends ModelAsApp {
+    static UI: {
+        title: string;
+        icon: string;
+        description: string;
+    };
+    static name: string;
+    /**
+     * @returns {AsyncGenerator<any, any, any>}
+     */
+    run(): AsyncGenerator<any, any, any>;
+    /**
+     * @param {string} absDir
+     * @returns {Promise<string[]>}
+     */
+    _scanLocal(absDir: string): Promise<string[]>;
+    /**
+     * @param {string} base
+     * @param {string} [dir]
+     * @returns {Promise<string[]>}
+     */
+    _scanDirRecursive(base: string, dir?: string): Promise<string[]>;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/CloseCommand.d.ts

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

package/types/domain/DepsCommand.d.ts

@@ -0,0 +1,22 @@
+export default class DepsCommand extends ModelAsApp {
+    static fix: {
+        help: string;
+        default: boolean;
+    };
+    static latest: {
+        help: string;
+        default: boolean;
+    };
+    static UI: {
+        title: string;
+        help: string;
+    };
+    /**
+     * @param {Partial<DepsCommand>} [data]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+     */
+    constructor(data?: Partial<DepsCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {boolean} Apply fixes automatically */ fix: boolean;
+    /** @type {boolean} Update packages to the latest available versions */ latest: boolean;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/InitCommand.d.ts

@@ -0,0 +1,18 @@
+export default class InitCommand extends ModelAsApp {
+    static version: {
+        help: string;
+        default: string;
+        errorRequired: string;
+    };
+    static UI: {
+        title: string;
+        help: string;
+    };
+    /**
+     * @param {Partial<InitCommand>} [data]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+     */
+    constructor(data?: Partial<InitCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {string} Release version */ version: string;
+}
+import { ModelAsApp } from '@nan0web/ui';

package/types/domain/PublishCommand.d.ts

@@ -0,0 +1,27 @@
+export default class PublishCommand extends ModelAsApp {
+    static major: {
+        help: string;
+        default: boolean;
+    };
+    static minor: {
+        help: string;
+        default: boolean;
+    };
+    static patch: {
+        help: string;
+        default: boolean;
+    };
+    static UI: {
+        title: string;
+        help: string;
+    };
+    /**
+     * @param {Partial<PublishCommand>} [data]
+     * @param {Partial<import('@nan0web/ui').ModelAsAppOptions>} [options]
+     */
+    constructor(data?: Partial<PublishCommand>, options?: Partial<import("@nan0web/ui").ModelAsAppOptions>);
+    /** @type {boolean} Bump major version */ major: boolean;
+    /** @type {boolean} Bump minor version */ minor: boolean;
+    /** @type {boolean} Bump patch version */ patch: boolean;
+}
+import { ModelAsApp } from '@nan0web/ui';