@nan0web/release 3.3.0 → 3.4.0

package/bin/nan0release.js

@@ -1,6 +1,37 @@
 #!/usr/bin/env node
-
+import { existsSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
 import { bootstrapApp } from '@nan0web/ui-cli'
+import DBFS from '@nan0web/db-fs'
 import { ReleaseApp } from '../src/domain/App.js'
 
-bootstrapApp(ReleaseApp)
+function findMonorepoRoot(startDir) {
+	let dir = resolve(startDir)
+	const markers = ['pnpm-workspace.yaml', 'releases.txt']
+	for (let i = 0; i < 10; i++) {
+		for (const marker of markers) {
+			if (existsSync(resolve(dir, marker))) {
+				return dir
+			}
+		}
+		const parent = dirname(dir)
+		if (parent === dir) break
+		dir = parent
+	}
+	return startDir
+}
+
+const startCwd = process.env.INIT_CWD || process.cwd()
+process.env.RELEASE_CWD = startCwd
+const root = findMonorepoRoot(startCwd)
+if (process.cwd() !== root && existsSync(resolve(root, 'releases.txt'))) {
+	process.chdir(root)
+}
+
+const db = new DBFS()
+await db.connect()
+
+bootstrapApp(ReleaseApp, { db }).catch((err) => {
+	console.error(err)
+	process.exit(1)
+})

package/bin/serve.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { existsSync } from 'node:fs'
+import { resolve, dirname } from 'node:path'
+import { bootstrapApp } from '@nan0web/ui-cli'
+import DBFS from '@nan0web/db-fs'
+import { ServeCommand } from '../src/domain/ServeCommand.js'
+
+function findMonorepoRoot(startDir) {
+	let dir = resolve(startDir)
+	const markers = ['pnpm-workspace.yaml', 'releases.txt']
+	for (let i = 0; i < 10; i++) {
+		for (const marker of markers) {
+			if (existsSync(resolve(dir, marker))) {
+				return dir
+			}
+		}
+		const parent = dirname(dir)
+		if (parent === dir) break
+		dir = parent
+	}
+	return startDir
+}
+
+const startCwd = process.env.INIT_CWD || process.cwd()
+process.env.RELEASE_CWD = startCwd
+const root = findMonorepoRoot(startCwd)
+if (process.cwd() !== root && existsSync(resolve(root, 'releases.txt'))) {
+	process.chdir(root)
+}
+
+const db = new DBFS()
+await db.connect()
+
+const res = await bootstrapApp(ServeCommand, { db, noExit: true }).catch((err) => {
+	console.error(err)
+	process.exit(1)
+})
+
+const resultIntent = res?.data || {}
+const data = resultIntent?.data || resultIntent || {}
+if (data.success && data.html) {
+	try {
+		const { createServer } = await import('node:http')
+		const port = data.port || 3131
+		const server = createServer((req, resHttp) => {
+			resHttp.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' })
+			resHttp.end(data.html)
+		})
+
+		server.listen(port, () => {
+			if (data.open) {
+				import('node:child_process')
+					.then(({ exec }) => exec(`open http://localhost:${port}`))
+					.catch(() => {})
+			}
+		})
+
+		const stopServer = () => {
+			server.close(() => {
+				process.exit(0)
+			})
+		}
+
+		process.on('SIGINT', stopServer)
+		process.on('SIGTERM', stopServer)
+	} catch (err) {
+		console.error(`Failed to start HTTP server: ${err.message}`)
+		process.exit(1)
+	}
+} else if (data.success === false) {
+	process.exit(1)
+}
+

package/package.json

@@ -1,31 +1,58 @@
 {
   "name": "@nan0web/release",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Project Management as Code, Git-Native, GPG-Signed, Test-Driven",
   "main": "src/index.js",
   "types": "types/index.d.ts",
   "type": "module",
   "bin": {
     "nan0release": "./bin/nan0release.js",
-    "release": "./bin/nan0release.js"
+    "release": "./bin/nan0release.js",
+    "serve": "./bin/serve.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./src/index.js",
+      "types": "./types/index.d.ts"
+    },
+    "./domain/inspect/ReleaseAuditor": {
+      "import": "./src/domain/inspect/ReleaseAuditor.js",
+      "types": "./types/domain/inspect/ReleaseAuditor.d.ts"
+    },
+    "./domain/CheckCommand": {
+      "import": "./src/domain/CheckCommand.js",
+      "types": "./types/domain/CheckCommand.d.ts"
+    },
+    "./domain/StatusCommand": {
+      "import": "./src/domain/StatusCommand.js",
+      "types": "./types/domain/StatusCommand.d.ts"
+    },
+    "./domain/App": {
+      "import": "./src/domain/App.js",
+      "types": "./types/domain/App.d.ts"
+    },
+    "./domain/*": {
+      "import": "./src/domain/*.js"
+    }
   },
   "dependencies": {
-    "@nan0web/db-fs": "3.3.0",
-    "@nan0web/db": "3.3.0",
-    "@nan0web/types": "3.3.0",
-    "@nan0web/markdown": "3.3.0",
-    "@nan0web/log": "3.3.0",
-    "@nan0web/co": "3.3.0",
-    "@nan0web/changelog": "3.3.0",
-    "@nan0web/logos": "3.3.0",
-    "@nan0web/ui": "3.3.0",
-    "@nan0web/ui-cli": "3.3.0"
+    "@nan0web/changelog": "3.4.0",
+    "@nan0web/db": "3.4.0",
+    "@nan0web/log": "3.4.0",
+    "@nan0web/logos": "3.4.0",
+    "@nan0web/co": "3.4.0",
+    "@nan0web/inspect": "3.4.0",
+    "@nan0web/types": "3.4.0",
+    "@nan0web/ui": "3.4.0",
+    "@nan0web/ui-cli": "3.4.0",
+    "@nan0web/db-fs": "3.4.0",
+    "@nan0web/markdown": "3.4.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
     "husky": "^9.1.7",
-    "knip": "^5.86.0",
-    "@nan0web/test": "3.3.0"
+    "knip": "^5.88.1",
+    "@nan0web/test": "3.4.0"
   },
   "files": [
     "bin",
@@ -39,11 +66,12 @@
     "build": "tsc",
     "clean": "rm -rf .cache/ && rm -rf dist/",
     "clean:modules": "rm -rf node_modules",
-    "test": "node --test \"src/**/*.test.js\"",
-    "test1": "node --test \"src/**/*.test.js\" | nan0test parse --fail",
+    "test": "node --test \"src/**/*.{test,story}.js\"",
+    "test:stories": "node --test \"src/**/*.story.js\"",
+    "test1": "node --test \"src/**/*.{test,story}.js\" | nan0test parse --fail",
     "test:docs": "node --test \"src/README.md.js\"",
     "test:release": "node --test \"releases/**/*.test.js\"",
-    "test:coverage": "node --experimental-test-coverage --test-coverage-include=\"src/**/*.js\" --test-coverage-exclude=\"src/**/*.test.js\" --test \"src/**/*.test.js\"",
+    "test:coverage": "node --experimental-test-coverage --test-coverage-include=\"src/**/*.js\" --test-coverage-exclude=\"src/**/*.{test,story}.js\" --test \"src/**/*.{test,story}.js\"",
     "test:coverage:collect": "nan0test coverage",
     "test:status": "nan0test status",
     "test:all": "npm run test && npm run test:docs && npm run build && npm run knip",

package/src/Release/Document.js

@@ -83,6 +83,7 @@ class ReleaseDocument extends Markdown {
 			}
 		}
 
+		this.sections = sections
 		return result
 	}
 

package/src/Release/Scanner.js

@@ -27,10 +27,11 @@ export default class Scanner {
 	root
 
 	/**
-	 * @param {string} root - Root directory of the project
+	 * @param {string} [root] - Root directory of the project
 	 */
 	constructor(root) {
-		this.root = resolve(root)
+		const targetRoot = root || process.env.INIT_CWD || process.cwd()
+		this.root = resolve(targetRoot)
 	}
 
 	/**

package/src/Release.js

@@ -18,21 +18,21 @@ import Logger from '@nan0web/log'
  */
 export default class Release {
 	/** @type {string} */
-	version
+	version = '0.0.0'
 	/** @type {Date} */
-	createdAt
+	createdAt = new Date()
 	/** @type {Date?} */
-	startAt
+	startAt = null
 	/** @type {Date?} */
-	planAt
+	planAt = null
 	/** @type {Date?} */
-	completeAt
+	completeAt = null
 	/** @type {Map<string, Function>} */
-	tasks
+	tasks = new Map()
 	/** @type {ReleaseDocument} */
 	document
 	/** @type {Logger} */
-	logger
+	logger = new Logger()
 
 	/**
 	 * Creates a Release instance

package/src/domain/App.js

@@ -7,8 +7,19 @@ import PublishCommand from './PublishCommand.js'
 import SpecCommand from './SpecCommand.js'
 import StatusCommand from './StatusCommand.js'
 import BumpCommand from './BumpCommand.js'
+import WebCommand from './WebCommand.js'
+import PreviewCommand from './PreviewCommand.js'
+import ViewCommand from './ViewCommand.js'
+import ListCommand from './ListCommand.js'
+import ServeCommand from './ServeCommand.js'
 
 export class ReleaseApp extends ModelAsApp {
+	static alias = 'release'
+
+	static UI = {
+		title: 'PM-as-Code Release Protocol (nan0release)',
+	}
+
 	static command = {
 		help: 'Subcommand to run',
 		options: [
@@ -20,9 +31,14 @@ export class ReleaseApp extends ModelAsApp {
 			SpecCommand,
 			StatusCommand,
 			BumpCommand,
+			WebCommand,
+			PreviewCommand,
+			ViewCommand,
+			ListCommand,
+			ServeCommand,
 		],
 		positional: true,
-		default: null,
+		default: ViewCommand,
 	}
 
 	/**
@@ -31,6 +47,19 @@ export class ReleaseApp extends ModelAsApp {
 	 */
 	constructor(data = {}, options = {}) {
 		super(data, options)
-		/** @type {ModelAsApp} Subcommand to run */ this.command
+	}
+
+	/**
+	 * Run the main controller logic.
+	 * @returns {AsyncGenerator<import('@nan0web/ui').Intent, any, any>}
+	 */
+	async *run() {
+		if (this.help || !this.command || typeof this.command.run !== 'function') {
+			return yield* super.run()
+		}
+		return yield* this.command.run()
 	}
 }
+
+export default ReleaseApp
+

package/src/domain/BumpCommand.js

@@ -3,8 +3,18 @@ import { runSpawn } from '@nan0web/test'
 
 /**
  * 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 {
+	/** @type {string} Target version */
+	version = '3.1.1'
+	/** @type {string} Git reference to diff against */
+	since = 'v3.1.0'
+	/** @type {boolean} Run without making changes */
+	dryRun = false
+
 	static version = {
 		help: 'Target version to set',
 		default: '3.1.1',
@@ -38,9 +48,6 @@ export default class BumpCommand extends ModelAsApp {
 	 */
 	constructor(data = {}, options = {}) {
 		super(data, options)
-		/** @type {string} Target version */ this.version
-		/** @type {string} Since reference */ this.since
-		/** @type {boolean} Dry run */ this.dryRun
 	}
 
 	/**