@nan0web/release 1.0.1 → 1.0.3

package/releases/1/0/v1.0.0/release.md

@@ -1,121 +0,0 @@
-# v1.0.0 - 2025-08-18
-
-## PM as a code
-
-Project management as a code is real if you believe and do this way.
-
-### Team
-
-#### developer
-
-- YaRaSLove (ЯRаСлав) <support@yaro.page>
-
-#### assistant
-
-- Qwen-3-coder-480b <https://api.cerebras.ai/>
-
-## CLI application
-
-### 1. Git-Native & Version-Controlled Workflow [](./task/git-native.test.js)
-
-- Treats project management like code: everything is versioned, auditable, reversible.
-- No external tools or databases needed — just Git.
-- Natural for developers; lowers barrier to entry for dev-centric teams.
-
-#### Acceptance Criteria
-
-- MUST verify that `git status` does not show any `releases/0/0/v0.0.0/*` files;
-- MUST create all required files according to the structure:
-```text
-release.md                      ← Release notes (tasks, sections)
-release.js                      ← Team, roles, config (class Release)
-release.test.js                 ← Main test suite (CI entrypoint)
-test/
-  {username}/                   ← Optional scope
-    tasks.test.js               ← User-specific tests
-chat/                           ← Release-wide chat
-  2025/08/18/
-    162000420.{username}.md     ← Message (timestamp + user)
-task/
-  ux.logo/                      ← Task by slug
-    config.json                 ← { assignee, priority, dependsOn }
-    approved/
-      ceo.json                  ← Approval record (GPG-signed)
-    chat/
-      2025/08/18/
-        162000420.{username}.md ← Task-specific message
-assets/                         ← Designs, docs, deliverables
-retro.md                        ← Final reflection (sealed)
-.cache/                         ← gitignored: read state, session
-```
-- MUST confirm with `git status` which files are ignored and which are tracked.
-
----
-
-### 2. Test-Driven Project Progress [](./test/YaRaSLove/test-driven.test.js)
-- Tasks become testable units → Pass/fail defines completion.
-- Automates status tracking via CI/CD: "Done" = test passes.
-- Enables **automated QA gates in releases** — powerful for regulated environments.
-
-#### Acceptance Criteria
-- MUST write `release.md` inside the test folder `releases/0/0/v0.0.0/release.md` using proper formatting;
-- MUST initialize the release with `nan0release init v0.0.0`;
-- MUST check the generated tests and compare them against expected templates;
-- MUST prepare tests generated from complete releases notes markdown file with command `nan0release prepare v0.0.0`
-- MUST begin the workflow: all tests start in `todo`, transition states by modifying files and executing tests, validate each state (`todo`, `in progress`, `complete`, `approved`), verify release status and confirm `git tag` commands are executed once all tasks complete.
-- MUST execute `nan0release [status] v0.0.0`
-- MUST execute `nan0release todo v0.0.0`
-- MUST execute `nan0release validate v0.0.0`
-- MUST execute `nan0release seal v0.0.0`
-
-### 3. Transparent & Predictable Progress Tracking [](./test/YaRaSLove/progress-tracking.test.js)
-- Real-time progress %, ETA, and velocity derived from commit history.
-- Immediate visibility through stats (pending/pass/fail).
-- Eliminates manual updates in Jira/Trello → reduces noise and inaccuracies.
-
-#### Acceptance Criteria
-- MUST validate updates occur upon commits (these may be simulated or run within an isolated temporary `.git` environment); ensure CI/CD generates reports which are both testable and consumable by UIs.
-
----
-
-### 4. Integrated Team Communication [](./test/YaRaSLove/chat.test.js)
-- Structured chat per release and task embedded directly in file system.
-- Chronologically ordered, searchable, and version-controlled conversations.
-- `.cache` supports user-specific read/unread states without requiring a central server.
-
-#### Acceptance Criteria
-
-- MUST test by verifying created files after running the following commands:
-- `nan0release chat write "msg"`
-- `nan0release chat write ux.logo "help needed"`
-- `nan0release chat read`
-- `nan0release chat find "help"`
-- `nan0release chat --sender member@example.com`
-- `nan0release chat unread`
-- MUST test both output and resulting file content.
-
----
-
-### 5. Self-Documenting Releases [](./test/YaRaSLove/docs.test.js)
-
-- Structured, machine-readable release notes, always current.
-- Markdown enhanced with YAML frontmatter enables metadata (assignees, dates, etc.).
-- Facilitates automatic generation of changelogs, roadmaps, dashboards.
-
-#### Acceptance Criteria
-
-- MUST validate success and failure outcomes of `nan0release validate` when processing valid and invalid release note formats. It must exit with status code 1 on a failure.
-
----
-
-### 6. Extensible & Composable & Office-First & Decentralized by Design [ci-cd.test.js]
-- Assets such as designs, configurations, and logs stored within the release for full context.
-- Supports custom scripts, hooks, templates (e.g., `pre-release.js`, `post-release.sh`).
-- Seamlessly integrates into CI/CD pipelines.
-- Works offline and independently of external services.
-- No vendor lock-in — all data remains in the repository.
-
-#### Acceptance Criteria
-
-- MUST confirm context preservation by adding test files to assets and validating output of `git status`.
-

package/releases/1/0/v1.0.0/release.test.js

@@ -1,36 +0,0 @@
-import { describe, it } from "node:test"
-import { strict as assert } from "node:assert"
-
-import Release from "./release.js"
-
-/**
- * @todo
- * It must validate the structure of every release.
- * It must be in src/Release.validate().
- * It must validate loaded markdown into document with the file structure
- */
-
-describe("Release v1.0.0", () => {
-	it("has a valid static version", () => {
-		assert.equal(Release.version, "v1.0.0")
-	})
-
-	it("has a valid static date", () => {
-		assert.equal(Release.createdAt, "2025-08-18")
-	})
-
-	it("references a valid Company with name", () => {
-		assert.ok(Release.company)
-		assert.equal(Release.company.name, "NaN•Web")
-	})
-
-	it("has a DevTeam defined in teams", () => {
-		assert.ok(Release.teams.DevTeam)
-		assert.equal(Release.teams.DevTeam.name, "Software development team")
-	})
-
-	it("includes all core models: Person, Contact, Message", () => {
-		assert.ok(typeof Person !== 'undefined' || typeof Release.members.YaRaSLove !== 'undefined')
-		// Note: these would be imported if external deps existed
-	})
-})

package/releases/1/0/v1.0.0/test/YaRaSLove/git-native.test.js

@@ -1,14 +0,0 @@
-import { describe, it } from "node:test"
-import assert from "node:assert/strict"
-
-describe("Git-Native & Version-Controlled Workflow", () => {
-	it("Treats project management like code: everything is versioned, auditable, reversible.", () => {
-
-	})
-	it("No external tools or databases needed — just Git.", () => {
-
-	})
-	it("Natural for developers; lowers barrier to entry for dev-centric teams.", () => {
-
-	})
-})

package/releases/current.js

@@ -1,3 +0,0 @@
-import v1_0_0 from "./1/0/v1.0.0/release.js"
-
-export default v1_0_0

package/releases/index.js

@@ -1,11 +0,0 @@
-import v1_0_0 from "./1/0/v1.0.0/release.js"
-import Release from "../src/Release.js"
-
-/**
- * @type {Record<string, Release>}
- */
-const releases = {
-	v1_0_0
-}
-
-export default releases

package/src/Release/MarkdownToTest.test.js

@@ -1,60 +0,0 @@
-import { describe, it } from "node:test"
-import { strictEqual } from "node:assert"
-import MarkdownToTest from "./MarkdownToTest.js"
-
-describe.skip("MarkdownToTest", () => {
-	it("should generate node:test code from markdown release notes", () => {
-		const parser = new MarkdownToTest()
-		const markdown = `# v1.1.0 - 2025-08-19
-
-## CLI application
-###  **Treats project management like code: everything is versioned, auditable, reversible.** [treats-project-management-like-code-everything-is-versioned-auditable-reversible]
-### Draft **No external tools or databases needed — just Git.** [no-external-tools-or-databases-needed-just-git]
-###  **Natural for developers; lowers barrier to entry for dev-centric teams.** [natural-for-developers-lowers-barrier-to-entry-for-dev-centric-teams]
-
-## UI application
-###  **Drag-and-drop interface** [drag-and-drop-interface]
-###  **Visual tree structure** [visual-tree-structure]`
-
-		const expected = `import { describe, it } from "node:test"
-import { ok, strictEqual } from "node:assert"
-
-describe("v1.1.0 - 2025-08-19", () => {
-	describe("CLI application", () => {
-		it("Treats project management like code: everything is versioned, auditable, reversible.", () => {
-			ok(true, "Task completed successfully")
-		})
-		it.skip("No external tools or databases needed — just Git.", () => {
-			ok(false, "Draft task - not yet implemented")
-		})
-		it("Natural for developers; lowers barrier to entry for dev-centric teams.", () => {
-			ok(true, "Task completed successfully")
-		})
-	})
-	describe("UI application", () => {
-		it("Drag-and-drop interface", () => {
-			ok(true, "Task completed successfully")
-		})
-		it("Visual tree structure", () => {
-			ok(true, "Task completed successfully")
-		})
-	})
-})`
-
-		const result = parser.generateTests(markdown)
-		strictEqual(result.trim(), expected.trim())
-	})
-
-	it("should throw error if markdown doesn't have version header", () => {
-		const parser = new MarkdownToTest()
-		const markdown = `## CLI application
-###  **Treats project management like code** [treats-project-management-like-code]`
-
-		try {
-			parser.generateTests(markdown)
-			throw new Error("Should have thrown an error")
-		} catch (error) {
-			strictEqual(error.message, 'Markdown must start with version header: # vX.Y.Z - YYYY-MM-DD')
-		}
-	})
-})

package/src/ReleaseCLI.js

@@ -1,122 +0,0 @@
-#!/usr/bin/env node
-
-import { Command } from '@nan0web/co'
-import Logger from '@nan0web/log'
-import FS from "@nan0web/db-fs"
-import DB from "./db/ReleaseDB.js"
-import Release from './Release.js'
-import ChatCommand from './commands/ChatCommand.js'
-import HostCommand from './commands/HostCommand.js'
-import InitCommand from './commands/InitCommand.js'
-import ListCommand from './commands/ListCommand.js'
-import SealCommand from './commands/SealCommand.js'
-import ServeCommand from './commands/ServeCommand.js'
-import ShowCommand from './commands/ShowCommand.js'
-import AppCommandMessage from './co/AppCommandMessage.js'
-
-/**
- * CLI application for release management
- */
-export default class ReleaseCLI extends Command {
-	static Message = AppCommandMessage
-	/** @type {Logger} */
-	logger
-	/** @type {DB?} */
-	db
-	/** @type {FS} */
-	fs
-	/** @type {Record<string, Release>} */
-	releases = {}
-	/** @type {Release?} */
-	current = null
-
-	constructor() {
-		super({
-			name: 'release',
-			help: 'Release management CLI tool'
-		})
-		this.logger = new Logger({ icons: true })
-		this.fs = new FS()
-		this.db = null
-		this.addOption('releaseDir', String, '.', 'Release dir')
-		this.addOption('version', String, '0.0.0', 'Release version')
-	}
-
-	/**
-	 * @param {string[] | string} argv
-	 * @returns {AppCommandMessage}
-	 */
-	parse(argv = []) {
-		return AppCommandMessage.from(super.parse(argv))
-	}
-
-	/**
-	 * Run CLI application
-	 * @param {string[]} argv - Command line arguments
-	 * @returns {Promise<void>}
-	 */
-	async run(argv) {
-		const msg = this.parse(argv)
-		await this.fs.connect()
-
-		const rootDb = this.fs.extract(/** @type {string} */(msg.opts.releaseDir))
-
-		const indexStat = await rootDb.statDocument("index.js")
-		const currentStat = await rootDb.statDocument("current.js")
-		if (indexStat.exists && currentStat.exists) {
-			const indexJs = rootDb.absolute("index.js")
-			const currentJs = rootDb.absolute("current.js")
-			try {
-				this.releases = (await import(indexJs)).default
-				this.current = (await import(currentJs)).default
-				this.logger.info(Object.keys(this.releases).length, "release(s) found")
-			} catch (e) {
-				this.logger.error("Failed to load release database", e)
-				this.current = null
-			}
-		} else {
-			this.logger.info("No releases initialized. Use 'release init <version>' to create your first release.")
-		}
-
-		const globalOpts = { logger: this.logger }
-		this.addSubcommand(new ListCommand(globalOpts))
-		this.addSubcommand(new HostCommand(globalOpts))
-		this.addSubcommand(new ServeCommand(globalOpts))
-
-		if (this.current) {
-			this.logger.info("Current release", this.current.version)
-			this.db = DB.from(rootDb.extract(this.current.path))
-			await this.db.connect()
-			const document = await this.db.loadDocument("release.md")
-			const release = new Release({ document, version: this.current.version })
-			const currentOpts = { ...globalOpts, db: this.db }
-			this.addSubcommand(new InitCommand(currentOpts))
-			this.addSubcommand(new ShowCommand(currentOpts))
-			this.addSubcommand(new ChatCommand(currentOpts))
-			this.addSubcommand(new SealCommand(currentOpts))
-		}
-		else {
-			this.logger.info("Provide a release version")
-			this.logger.info(this.generateHelp())
-		}
-		return
-	}
-
-	async loadReleaseFiles() {
-		if (!this.db) return
-		const stream = this.db.findStream("")
-		const started = Date.now()
-		for await (const entry of stream) {
-			const spent = ((Date.now() - started) / 1000).toFixed(3)
-			this.logger.clearLine(this.logger.cursorUp())
-			this.logger.info("Loading ..", spent + "s", this.db.data.size, entry.file.path)
-		}
-		const spent = ((Date.now() - started) / 1000).toFixed(3)
-		this.logger.clearLine(this.logger.cursorUp(/** @type {DB} */(this.db).data.size & 1))
-		const info = [
-			["Loaded in", spent + "s", /** @type {DB} */(this.db).data.size, "document(s)"],
-			["", "", /** @type {DB} */(this.db).releases.length, "release(s)"],
-		]
-		this.logger.table(info, [], { padding: 1 })
-	}
-}

package/src/architecture/ProjectManagementAsCode.test.js

@@ -1,128 +0,0 @@
-import { describe, it } from 'node:test'
-import { strict as assert } from 'node:assert'
-import {
-	ProjectManagement,
-	ReleaseManager,
-	TaskTestSuite,
-	ChangelogTaskManager
-} from './ProjectManagementAsCode.js'
-
-describe('ProjectManagementAsCode Architecture', () => {
-	describe('ProjectManagement', () => {
-		it('should initialize with default configuration', () => {
-			const pm = new ProjectManagement()
-			assert.equal(pm.projectPath, '.')
-			assert.equal(pm.autoTrack, false)
-			assert.ok(pm.tasks instanceof Map)
-		})
-
-		it('should register tasks with their test files', () => {
-			const pm = new ProjectManagement()
-			pm.registerTask('task-1', './tests/task1.test.js')
-			pm.registerTask('task-2', './tests/task2.test.js')
-
-			assert.equal(pm.tasks.size, 2)
-			assert.equal(pm.tasks.get('task-1'), './tests/task1.test.js')
-			assert.equal(pm.tasks.get('task-2'), './tests/task2.test.js')
-		})
-
-		it('should validate project state by running task tests', async () => {
-			const pm = new ProjectManagement()
-			pm.registerTask('task-1', './tests/task1.test.js')
-			pm.registerTask('task-2', './tests/task2.test.js')
-
-			const results = await pm.validateProjectState()
-			assert.ok(results.passed.length >= 0)
-			assert.ok(results.failed.length >= 0)
-			assert.ok(results.pending.length >= 0)
-		})
-	})
-
-	describe('ReleaseManager', () => {
-		it('should initialize with project manager', () => {
-			const pm = new ProjectManagement()
-			const rm = new ReleaseManager(pm)
-
-			assert.equal(rm.projectManager, pm)
-		})
-
-		it.skip('should validate release with version calculation', async () => {
-			const pm = new ProjectManagement()
-			const rm = new ReleaseManager(pm)
-
-			const validation = await rm.validateRelease('1.0.0')
-			assert.equal(validation.version, '1.0.0')
-			assert.ok(validation.timestamp)
-			assert.ok(validation.tasks.total >= 0)
-		})
-
-		it('should execute release process with validation', async () => {
-			const pm = new ProjectManagement()
-			const rm = new ReleaseManager(pm)
-
-			const result = await rm.executeRelease('patch')
-			assert.ok(result.version)
-			assert.ok(result.validation)
-			assert.equal(typeof result.published, 'boolean')
-		})
-
-		it('should block release when tests fail and ignore option is not set', async () => {
-			const pm = new ProjectManagement()
-			const rm = new ReleaseManager(pm)
-
-			// Mock validation to simulate failed tasks
-			rm.projectManager.validateProjectState = async () => ({
-				passed: [],
-				failed: ['task-1'],
-				pending: []
-			})
-
-			try {
-				await rm.executeRelease('patch')
-				assert.fail('Should have thrown an error')
-			} catch (error) {
-				assert.ok(error.message.includes('Release blocked'))
-			}
-		})
-	})
-
-	describe('TaskTestSuite', () => {
-		it.skip('should extend TestSuite with task metadata', () => {
-			const testFunction = () => { }
-			const taskSuite = new TaskTestSuite('task-1', 'Test task description', testFunction)
-
-			assert.equal(taskSuite.taskId, 'task-1')
-			assert.equal(taskSuite.description, 'Test task description')
-			assert.equal(taskSuite.testFunction, testFunction)
-		})
-	})
-
-	describe('ChangelogTaskManager', () => {
-		it('should parse changelog content to extract tasks', () => {
-			const ctm = new ChangelogTaskManager()
-			const changelogContent = `
-# Changelog
-
-## [1.0.0] - 2024-01-01
-### Added
-- Initial release features
-- Core functionality implementation
-`
-
-			const tasks = ctm.parseChangelog(changelogContent)
-			assert.ok(Array.isArray(tasks))
-		})
-
-		it('should generate task tests from changelog entries', async () => {
-			const ctm = new ChangelogTaskManager()
-			const tasks = [
-				{ id: 'task-1', description: 'Implement feature A' },
-				{ id: 'task-2', description: 'Fix bug B' }
-			]
-
-			// This should not throw an error
-			await ctm.generateTaskTests(tasks)
-			assert.ok(true)
-		})
-	})
-})

package/src/co/AppCommandMessage.js

@@ -1,22 +0,0 @@
-import { CommandMessage } from "@nan0web/co"
-import AppCommandOptions from "./AppCommandOptions.js"
-
-export default class AppCommandMessage extends CommandMessage {
-	/** @returns {AppCommandOptions} */
-	get opts() {
-		return /** @type {AppCommandOptions} */ (super.opts)
-	}
-
-	set opts(value) {
-		super.opts = value
-	}
-
-	/**
-	 * @param {*} input
-	 * @returns {AppCommandMessage}
-	 */
-	static from(input) {
-		if (input instanceof AppCommandMessage) return input
-		return new AppCommandMessage(input)
-	}
-}

package/src/commands/ChatCommand.js

@@ -1,56 +0,0 @@
-import SubCommand from "./SubCommand.js"
-import { appendFile, readFile } from "node:fs/promises"
-import { join } from "node:path"
-import AppCommandMessage from "../co/AppCommandMessage.js"
-
-/**
- * ChatCommand – writes a message to the release‑wide chat (chat/…/timestamp.username.md)
- *
- * Usage:
- *   release chat write "your message"
- *
- * Options:
- *   --user <string> – username to embed in the filename (defaults to "anonymous")
- */
-class ChatCommand extends SubCommand {
-	constructor(options = {}) {
-		super(options)
-		this.addOption("user", String, "anonymous", "Chat username")
-		this.addOption("write", Boolean, false, "Write a new chat line")
-	}
-
-	/**
-	 * Run the chat command.
-	 *
-	 * @param {AppCommandMessage} ctx – command context (contains args and opts)
-	 */
-	async run(ctx) {
-		if (!ctx.opts.write) {
-			this.logger.error("No action specified – use --write to add a message")
-			return
-		}
-		if (!this.db) {
-			this.logger.error("No DB – cannot locate chat folder")
-			return
-		}
-
-		const message = ctx.args.join(" ")
-		if (!message) {
-			this.logger.error("Empty message – nothing to write")
-			return
-		}
-
-		const now = Date.now()
-		const username = /** @type {string} */(ctx.opts.user)
-		const chatPath = join(this.db.cwd, "chat", "2025", "08", `${now}.${username}.md`)
-
-		// ensure directory exists
-		const dir = chatPath.split("/").slice(0, -1).join("/")
-		await import("node:fs/promises").then(m => m.mkdir(dir, { recursive: true }))
-
-		await appendFile(chatPath, message + "\n", "utf8")
-		this.logger.success(`Message written to ${chatPath}`)
-	}
-}
-
-export default ChatCommand

package/src/commands/HostCommand.js

@@ -1,63 +0,0 @@
-import SubCommand from "./SubCommand.js"
-import { createServer } from "node:http"
-import { readFile } from "node:fs/promises"
-import { join } from "node:path"
-
-/**
- * HostCommand – starts a minimal HTTP server that serves the current
- * release markdown and a tiny JSON status endpoint.
- *
- * Usage:
- *   release host [--port <number>] [--webui]
- */
-export default class HostCommand extends SubCommand {
-	constructor(options = {}) {
-		super(options)
-		this.addOption("port", Number, 3000, "Port for the HTTP server")
-		this.addOption("webui", Boolean, false, "Serve a simple web UI")
-	}
-
-	/**
-	 * Run the host server.
-	 *
-	 * @param {Object} ctx – command context
-	 */
-	async run(ctx) {
-		const port = ctx.opts.port
-		const releasePath = this.db?.cwd
-		if (!releasePath) {
-			this.logger.error("No release directory (db.cwd) – cannot host")
-			return
-		}
-
-		const mdPath = join(releasePath, "release.md")
-
-		const server = createServer(async (req, res) => {
-			if (req.url === "/") {
-				// simple UI – just render markdown as preformatted text
-				try {
-					const md = await readFile(mdPath, "utf8")
-					const body = ctx.opts.webui
-						? `<html><body><pre>${md}</pre></body></html>`
-						: md
-					res.writeHead(200, { "Content-Type": "text/plain; charset=utf-8" })
-					res.end(body)
-				} catch (e) {
-					res.writeHead(404)
-					res.end("release.md not found")
-				}
-			} else if (req.url === "/status") {
-				res.writeHead(200, { "Content-Type": "application/json" })
-				res.end(JSON.stringify({ version: ctx.opts.version || "unknown" }))
-			} else {
-				res.writeHead(404)
-				res.end("Not found")
-			}
-		})
-
-		server.listen(port, () => {
-			this.logger.success(`Release hosted at http://localhost:${port}`)
-			if (ctx.opts.webui) this.logger.info("Web UI enabled")
-		})
-	}
-}