@nan0web/release 1.0.1 → 1.0.3

package/src/commands/ListCommand.js

@@ -1,56 +0,0 @@
-import SubCommand from "./SubCommand.js"
-import { join } from "node:path"
-import { createReadStream } from "node:fs"
-
-/**
- * ListCommand – prints a concise list of releases found in the current
- * working directory.  It works against the {@link ReleaseDB} instance
- * passed through the `db` option of the parent CLI.
- *
- * Usage:
- *   release list
- *
- * Options:
- *   --json – output JSON instead of a human‑readable list
- */
-export default class ListCommand extends SubCommand {
-	constructor(options = {}) {
-		super(options)
-		this.addOption("json", Boolean, false, "Output as JSON")
-	}
-
-	/**
-	 * Execute the command.
-	 *
-	 * @param {Object} ctx – command context (contains parsed args)
-	 * @returns {Promise<void>}
-	 */
-	async run(ctx) {
-		if (!this.db) {
-			this.logger.warn("No database attached – nothing to list")
-			return
-		}
-
-		const releases = []
-		for await (const entry of this.db.findStream("")) {
-			// Only keep top‑level release directories (e.g. 1/0/v1.0.0)
-			const parts = entry.file.path.split("/")
-			if (parts.length === 3 && /^\d+$/.test(parts[0]) && /^\d+$/.test(parts[1])) {
-				releases.push(entry.file.path)
-			}
-		}
-
-		if (ctx.opts.json) {
-			this.logger.info(JSON.stringify(releases, null, "\t"))
-		} else {
-			if (releases.length === 0) {
-				this.logger.info("No releases found")
-			} else {
-				this.logger.info("Releases:")
-				for (const r of releases) {
-					this.logger.info(` • ${r}`)
-				}
-			}
-		}
-	}
-}

package/src/commands/SealCommand.js

@@ -1,51 +0,0 @@
-import SubCommand from "./SubCommand.js"
-import { mkdir, writeFile } from "node:fs/promises"
-import { join } from "node:path"
-import Release from "../../src/Release.js"
-
-/**
- * SealCommand – finalises a release by writing a `retro.md` file
- * and making the release directory read‑only.  This is a *light* implementation
- * that merely creates a placeholder retro file; a real implementation would
- * also set file system permissions and maybe create a Git tag.
- *
- * Usage:
- *   release seal [--message <text>]
- *
- * Options:
- *   --message – optional retro‑reflection text
- */
-export default class SealCommand extends SubCommand {
-	constructor(options = {}) {
-		super(options)
-		this.addOption("message", String, "", "Retro‑reflection text")
-	}
-
-	/**
-	 * Seal the current release.
-	 *
-	 * @param {Object} ctx – command context
-	 */
-	async run(ctx) {
-		if (!this.db) {
-			this.logger.error("No DB – cannot seal release")
-			return
-		}
-
-		const retroPath = join(this.db.cwd, "retro.md")
-		const content = `# Retro – ${new Date().toISOString().split("T")[0]}
-
-${ctx.opts.message || "*No retro‑reflection provided.*"}\n`
-
-		await writeFile(retroPath, content, "utf8")
-		this.logger.success(`retro.md written to ${retroPath}`)
-
-		// make the folder read‑only (best‑effort – ignore errors on non‑POSIX FS)
-		try {
-			await mkdir(this.db.cwd, { mode: 0o444 })
-			this.logger.info("Release directory set to read‑only")
-		} catch (_) {
-			// not critical – just a hint
-		}
-	}
-}

package/src/commands/ServeCommand.js

@@ -1,53 +0,0 @@
-import SubCommand from "./SubCommand.js"
-import { createServer } from "node:http"
-import { readFile } from "node:fs/promises"
-import { join } from "node:path"
-
-/**
- * ServeCommand – runs a tiny static file server that serves all files
- * inside the current release folder.  It is useful for quick local
- * inspection of assets, markdown, and generated test files.
- *
- * Usage:
- *   release serve [--port <number>]
- */
-export default class ServeCommand extends SubCommand {
-	constructor(options = {}) {
-		super(options)
-		this.addOption("port", Number, 8080, "Port for static server")
-	}
-
-	/**
-	 * Start the static server.
-	 *
-	 * @param {Object} ctx – command context
-	 */
-	async run(ctx) {
-		if (!this.db) {
-			this.logger.error("No DB – cannot serve files")
-			return
-		}
-
-		const root = this.db.cwd
-		const port = ctx.opts.port
-
-		const server = createServer(async (req, res) => {
-			const safePath = req.url?.split("?")[0] || "/"
-			const filePath = join(root, safePath)
-
-			try {
-				const data = await readFile(filePath)
-				res.writeHead(200)
-				res.end(data)
-			} catch (_) {
-				res.writeHead(404)
-				res.end("Not found")
-			}
-		})
-
-		server.listen(port, () => {
-			this.logger.success(`Static server listening on http://localhost:${port}`)
-			this.logger.info(`Serving ${root}`)
-		})
-	}
-}

package/src/commands/ShowCommand.js

@@ -1,58 +0,0 @@
-import SubCommand from "./SubCommand.js"
-import { readFile } from "node:fs/promises"
-import { join } from "node:path"
-
-/**
- * ShowCommand – prints basic information about the current release
- * (version, creation date, and a short excerpt of the markdown notes).
- *
- * Usage:
- *   release show
- *
- * Options:
- *   --full – dump the whole release.md file
- */
-export default class ShowCommand extends SubCommand {
-	constructor(options = {}) {
-		super(options)
-		this.addOption("full", Boolean, false, "Show complete release.md")
-	}
-
-	/**
-	 * Render the release information.
-	 *
-	 * @param {Object} ctx – command context
-	 */
-	async run(ctx) {
-		if (!this.db) {
-			this.logger.error("No DB – cannot locate current release")
-			return
-		}
-
-		// `cwd` points to the current release directory (see CLI)
-		const releaseJsPath = join(this.db.cwd, "release.js")
-		const releaseMdPath = join(this.db.cwd, "release.md")
-
-		try {
-			const { default: release } = await import(releaseJsPath)
-			this.logger.info(`Version      : ${release.version}`)
-			this.logger.info(`Created at   : ${release.createdAt.toISOString()}`)
-			this.logger.info(`Path         : ${this.db.cwd}`)
-		} catch (/** @type {any} */ e) {
-			this.logger.warn(`Unable to import release.js – ${e.message}`)
-		}
-
-		try {
-			const md = await readFile(releaseMdPath, "utf8")
-			if (ctx.opts.full) {
-				this.logger.info("\n=== release.md ===\n")
-				this.logger.info(md)
-			} else {
-				const firstLine = md.split("\n")[0]
-				this.logger.info(`Release note : ${firstLine}`)
-			}
-		} catch (/** @type {any} */ e) {
-			this.logger.warn(`release.md not found – ${e.message}`)
-		}
-	}
-}

package/src/commands/SubCommand.js

@@ -1,21 +0,0 @@
-import { Command } from '@nan0web/co'
-import ReleaseDB from '../db/ReleaseDB.js'
-import Logger from '@nan0web/log'
-
-class SubCommand extends Command {
-	/** @type {Logger} */
-	logger
-	/** @type {ReleaseDB?} */
-	db
-	constructor(options = {}) {
-		const {
-			logger = new Logger(),
-			db,
-		} = options
-		super(options)
-		this.logger = Logger.from(logger)
-		this.db = db ? ReleaseDB.from(db) : null
-	}
-}
-
-export default SubCommand

package/src/commands/ValidateCommand.js

@@ -1,66 +0,0 @@
-import SubCommand from "./SubCommand.js"
-import { readFile } from "node:fs/promises"
-import { join } from "node:path"
-import Release from "../../src/Release.js"
-
-/**
- * ValidateCommand – runs the {@link Release.validate} method for the
- * currently checked‑out release and prints a short summary.
- *
- * Usage:
- *   release validate
- *
- * Options:
- *   --ignore-fail – do not treat failed tasks as a validation error
- */
-export default class ValidateCommand extends SubCommand {
-	constructor(options = {}) {
-		super(options)
-		this.addOption("ignoreFailTests", Boolean, false, "Ignore failed tests")
-	}
-
-	/**
-	 * Execute validation.
-	 *
-	 * @param {Object} ctx – command context
-	 */
-	async run(ctx) {
-		if (!this.db) {
-			this.logger.error("No DB – cannot locate current release")
-			return
-		}
-
-		const releaseJsPath = join(this.db.cwd, "release.js")
-		const releaseMdPath = join(this.db.cwd, "release.md")
-
-		let releaseInst
-		try {
-			const { default: rel } = await import(releaseJsPath)
-			releaseInst = rel
-		} catch (/** @type {any} */ e) {
-			this.logger.error(`Failed to import release.js – ${e.message}`)
-			return
-		}
-
-		// Attach a mock document – the real implementation would parse markdown
-		try {
-			const md = await readFile(releaseMdPath, "utf8")
-			// Very naïve parsing – just store the raw markdown
-			releaseInst.document = md
-		} catch (_) {
-			// ignore – document is optional for validation
-		}
-
-		const result = await releaseInst.validate()
-		const { passed, failed, pending } = result
-
-		if (passed.length) this.logger.success(`✅ Passed: ${passed.join(", ")}`)
-		if (failed.length) this.logger.error(`❌ Failed: ${failed.map(f => f.taskId).join(", ")}`)
-		if (pending.length) this.logger.warn(`● Pending: ${pending.map(p => p.taskId).join(", ")}`)
-
-		if (!ctx.opts.ignoreFailTests && failed.length) {
-			this.logger.error(`Validation failed – ${failed.length} tasks did not pass`)
-			process.exit(1)
-		}
-	}
-}