@nan0web/release 1.0.0

package/.datasets/README.dataset.jsonl

@@ -0,0 +1,19 @@
+{"instruction":"How to install with pnpm?","output":"```bash\npnpm add @nan0web/release\n```\n","context":["h1:@nan0web/release","h2:Installation"],"input":"## Installation\n\n","tags":["@nan0web/release","Installation"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to install with npm?","output":"```bash\nnpm install @nan0web/release\n```\n","context":["h1:@nan0web/release","h2:Installation"],"input":"## Installation\n\n","tags":["@nan0web/release","Installation"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to install with yarn?","output":"```bash\nyarn add @nan0web/release\n```\n","context":["h1:@nan0web/release","h2:Installation"],"input":"## Installation\n\n","tags":["@nan0web/release","Installation"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to initialize a new release version?","output":"```bash\nrelease init v1.0.0\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to show release information?","output":"```bash\nrelease show [--full]\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\nconst cli = new ReleaseCLI()\nShow release details:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to list all releases?","output":"```bash\nrelease list [--json]\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\nconst cli = new ReleaseCLI()\nShow release details:\n\nconst release = new Release({\nversion: \"v1.0.0\",\ncreatedAt: new Date(\"2025-08-20\")\n})\nconsole.info(release.version) // v1.0.0\nList all releases in the project:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to write a release chat message?","output":"```bash\nrelease chat write --user alice \"Issue with the build pipeline\"\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\nconst cli = new ReleaseCLI()\nShow release details:\n\nconst release = new Release({\nversion: \"v1.0.0\",\ncreatedAt: new Date(\"2025-08-20\")\n})\nconsole.info(release.version) // v1.0.0\nList all releases in the project:\n\nconst cli = new ReleaseCLI()\nAdd a chat message to the current release:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to host release UI?","output":"```bash\nrelease host [--webui] [--port 3000]\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\nconst cli = new ReleaseCLI()\nShow release details:\n\nconst release = new Release({\nversion: \"v1.0.0\",\ncreatedAt: new Date(\"2025-08-20\")\n})\nconsole.info(release.version) // v1.0.0\nList all releases in the project:\n\nconst cli = new ReleaseCLI()\nAdd a chat message to the current release:\n\nconst cli = new ReleaseCLI()\nHost a static server for viewing releases:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to serve release static assets?","output":"```bash\nrelease serve [--port 8080]\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\nconst cli = new ReleaseCLI()\nShow release details:\n\nconst release = new Release({\nversion: \"v1.0.0\",\ncreatedAt: new Date(\"2025-08-20\")\n})\nconsole.info(release.version) // v1.0.0\nList all releases in the project:\n\nconst cli = new ReleaseCLI()\nAdd a chat message to the current release:\n\nconst cli = new ReleaseCLI()\nHost a static server for viewing releases:\n\nconst cli = new ReleaseCLI()\nServe all release files for local inspection:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to validate release tasks?","output":"```bash\nrelease validate [--ignore-fail]\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\nconst cli = new ReleaseCLI()\nShow release details:\n\nconst release = new Release({\nversion: \"v1.0.0\",\ncreatedAt: new Date(\"2025-08-20\")\n})\nconsole.info(release.version) // v1.0.0\nList all releases in the project:\n\nconst cli = new ReleaseCLI()\nAdd a chat message to the current release:\n\nconst cli = new ReleaseCLI()\nHost a static server for viewing releases:\n\nconst cli = new ReleaseCLI()\nServe all release files for local inspection:\n\nconst cli = new ReleaseCLI()\nValidate release tasks and integrity:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to seal a release?","output":"```bash\nrelease seal [--message \"All core APIs are stable and tested\"]\n```\n","context":["h1:@nan0web/release","h2:CLI Usage"],"input":"## CLI Usage\n\nStart by initializing a new release:\n\nconst cli = new ReleaseCLI()\nShow release details:\n\nconst release = new Release({\nversion: \"v1.0.0\",\ncreatedAt: new Date(\"2025-08-20\")\n})\nconsole.info(release.version) // v1.0.0\nList all releases in the project:\n\nconst cli = new ReleaseCLI()\nAdd a chat message to the current release:\n\nconst cli = new ReleaseCLI()\nHost a static server for viewing releases:\n\nconst cli = new ReleaseCLI()\nServe all release files for local inspection:\n\nconst cli = new ReleaseCLI()\nValidate release tasks and integrity:\n\nconst release = new Release({\nversion: \"v1.0.0\",\ncreatedAt: new Date(\"2025-08-20\")\n})\nSeal the release with retro reflection:\n\n","tags":["@nan0web/release","CLI Usage"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to instantiate a Release?","output":"```js\nimport { Release } from '@nan0web/release'\nconst release = new Release({\n\tversion: \"v1.0.0\",\n\tcreatedAt: \"2025-08-20T10:00:00Z\"\n})\nconsole.info(release.version) // ← v1.0.0\nconsole.info(release.createdAt instanceof Date) // ← true\n\n```\n","context":["h1:@nan0web/release","h2:Core Concepts","h3:1. Release as Object"],"input":"### 1. Release as Object\n\nA `Release` is a structured class containing:\n\n- `version`: release identifier (vX.Y.Z).\n- `createdAt`, `startAt`, `planAt`, `completeAt`: datetime milestones.\n- `document`: parsed markdown document with structure-aware parsing.\n\nEach property is typed and validated automatically via JSDoc and runtime parsing.\n\n","tags":["@nan0web/release","Core Concepts","1. Release as Object"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to parse release notes markdown into structured data?","output":"```js\nimport { ReleaseDocument } from '@nan0web/release'\nconst md = `# v1.0.0 - 2025-08-20\n\n## Overview\nRelease milestone includes UI polish and core API stabilization.\n\n### Tasks\n### Done **Implement core UI design** [ui.core-design]\n### InProgress **Fix responsive issues in mobile layout** [ui.mobile-fixes]`\n\nconst doc = ReleaseDocument.from(md)\nconsole.info(doc.version) // ← v1.0.0\nconsole.info(doc.date instanceof Date) // ← true\nconsole.info(doc.document.children instanceof Array) // ← true\n\n```\n","context":["h1:@nan0web/release","h2:Core Concepts","h3:2. Release Document Parsing"],"input":"### 2. Release Document Parsing\n\nA `ReleaseDocument` extends `@nan0web/markdown` with:\n\n- Structured parsing of markdown release notes\n- Extraction of sections and tasks\n- Team and role parsing from markdown frontmatter or code\n\n","tags":["@nan0web/release","Core Concepts","2. Release Document Parsing"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to create a Person with typed properties?","output":"```js\nimport { Person } from '@nan0web/release'\nconst person = new Person({\n\tname: [\"Alice\", \"Developer\"],\n\tgender: \"female\",\n\tcontacts: [\"mailto:alice@example.com\"]\n})\nconsole.info(person.name.firstName) // ← Alice\nconsole.info(person.contacts.length >= 0) // ← true\n\n```\n","context":["h1:@nan0web/release","h2:Core Concepts","h3:3. Person & Team Structures"],"input":"### 3. Person & Team Structures\n\nA `Person` instance includes:\n\n- `name`: HumanName\n- `gender`: HumanGender\n- `contacts`: array of HumanContact\n\n","tags":["@nan0web/release","Core Concepts","3. Person & Team Structures"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to register and validate tasks as tests?","output":"```js\nimport { ProjectManagement } from '@nan0web/release'\nconst pm = new ProjectManagement()\npm.registerTask(\"task-1\", \"./tests/task1.test.js\")\npm.registerTask(\"task-2\", \"./tests/task2.test.js\")\n\nconst mockResults = {\n\tpassed: [\"task-1\"],\n\tfailed: [],\n\tpending: [\"task-2\"]\n}\n\npm.validateProjectState = async () => mockResults\nconst results = await pm.validateProjectState()\n\nconsole.info(results.passed.includes(\"task-1\")) // ← true\nconsole.info(results.pending.includes(\"task-2\")) // ← true\n\n```\n","context":["h1:@nan0web/release","h2:Architecture: Project Management as Code","h3:Task Management"],"input":"### Task Management\n\nTasks are registered as `taskId` → `testFilePath` in `ProjectManagement`.\nTheir status is derived by running `node:test` suites.\n\n","tags":["@nan0web/release","Architecture: Project Management as Code","Task Management"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to execute a release after validation?","output":"```js\nimport { ReleaseManager, ProjectManagement } from '@nan0web/release'\nconst pm = new ProjectManagement()\nconst rm = new ReleaseManager(pm)\n\nrm.calculateVersion = () => \"v1.0.1\"\nrm.publish = async () => true\n\nconst result = await rm.executeRelease(\"patch\")\nconsole.info(result.version) // ← v1.0.1\nconsole.info(result.published) // ← true\n\n```\n","context":["h1:@nan0web/release","h2:Architecture: Project Management as Code","h3:Release Processing"],"input":"### Release Processing\n\nThe `ReleaseManager` coordinates releases and validates readiness.\nIt ensures:\n\n- All registered tests pass\n- Version is correctly incremented\n- Git tag is applied if all validations succeed\n\n","tags":["@nan0web/release","Architecture: Project Management as Code","Release Processing"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to parse changelog and extract tasks?","output":"```js\nimport { ChangelogTaskManager } from '@nan0web/release'\nconst ctm = new ChangelogTaskManager()\nconst changelog = `# Changelog\n\n## [1.0.0] - 2025-08-20\n### Added\n- Initial structure [core.init]\n- Release notes support [docs.release-notes]`\n\nconst tasks = ctm.parseChangelog(changelog)\nconsole.info(Array.isArray(tasks)) // ← true\nconsole.info(tasks.length >= 0) // ← true\n\n```\n","context":["h1:@nan0web/release","h2:Architecture: Project Management as Code","h3:Changelog Integration"],"input":"### Changelog Integration\n\nUsing `ChangelogTaskManager`, you can:\n\n- Extract task definitions from changelog entries\n- Generate corresponding test files\n- Automate task progression in CI\n\n","tags":["@nan0web/release","Architecture: Project Management as Code","Changelog Integration"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to run playground demo?","output":"```bash\ngit clone https://github.com/nan0web/release.git\ncd release\npnpm install\npnpm run playground\n```\n","context":["h1:@nan0web/release","h2:CLI Playground"],"input":"## CLI Playground\n\nTry the package in the terminal:\n\n","tags":["@nan0web/release","CLI Playground"],"proven":"assert-in-@nan0web/release"}
+{"instruction":"How to check project status before publishing?","output":"```bash\nnpm test\nnpm run test:coverage\nnpm run test:status\n```\n","context":["h1:@nan0web/release","h2:Project Status"],"input":"## Project Status\n\nTo verify the project is ready, run:\n\n","tags":["@nan0web/release","Project Status"],"proven":"assert-in-@nan0web/release"}

package/.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+indent_style = tab
+indent_size = 2
+charset = utf-8
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.{jsx}]
+indent_style = tab
+indent_size = 2
+
+[*.{nano,yaml}]
+indent_style = space
+indent_size = 2

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+---

package/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing
+
+## Developer Certificate of Origin and License
+By contributing, You accept and agree to the following terms and conditions for your present and future contributions submitted.  
+Except for the license granted herein, You reserve all right, title, and interest in and to your Contributions.  
+All contributions are subject to the Developer Certificate of Origin and license as set out in the LICENSE file.
+
+## Code of Conduct
+As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.  
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of:
+- Level of experience,
+- Gender,
+- Gender identity and expression,
+- Sexual orientation,
+- Disability,
+- Personal appearance,
+- Body size,
+- Race,
+- Ethnicity,
+- Age,
+- Religion.
+
+> We recognize all people as the foundation of humanity, and our actions contribute to the continued existence and growth of our shared humanity.
+
+### Release versioning
+- Keep releases close to the minor versions and publish patches only if required.
+
+### Examples of unacceptable behavior by participants:
+- Use of sexual language or imagery.
+- Derogatory comments or personal attacks.
+- Trolling, public or private harassment.
+- Insults or other unprofessional conduct.
+
+### Enforcement
+Project maintainers have the right and responsibility to:
+- Remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions not aligned with this Code of Conduct.
+- Remove maintainers who violate this Code of Conduct.
+
+Instances of unacceptable behavior can be reported by contacting the project team.
+
+This Code of Conduct is adapted from the [Contributor Covenant, version 1.1.0](https://contributor-covenant.org/version/1/1/0/).

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025, ЯRаСлав (YaRaSLove) <support@yaro.page>
+
+Permission to use, copy, modify, and distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,284 @@
+# @nan0web/release
+
+|Package name|[Status](https://github.com/nan0web/monorepo/blob/main/system.md#написання-сценаріїв)|Documentation|Test coverage|Features|Npm version|
+|---|---|---|---|---|---|
+ |[@nan0web/release](https://github.com/nan0web/release/) |🟢 `97.1%` |🧪 [English 🏴󠁧󠁢󠁥󠁮󠁧󠁿](https://github.com/nan0web/release/blob/main/README.md)<br />[Українською 🇺🇦](https://github.com/nan0web/release/blob/main/docs/uk/README.md) |🟡 `84.2%` |✅ d.ts 📜 system.md 🕹️ playground |— |
+
+Project management as code, Git-native, GPG-signed, and test-driven.
+
+Unlike traditional project tools that require constant syncing or manual updates,
+`@nan0web/release` enforces project structure where:
+- Tasks are represented as tests in `.test.js` files.
+- Status is tracked via test outcomes.
+- Team roles and approvals are stored in structured files.
+- All changes are signed, versioned, and composable.
+
+This ensures:
+- Clear, automatable project tracking.
+- Immutable release notes and retro reflections.
+- Zero ambiguity – tasks don't exist unless tested.
+
+## Installation
+
+How to install with pnpm?
+```bash
+pnpm add @nan0web/release
+```
+
+How to install with npm?
+```bash
+npm install @nan0web/release
+```
+
+How to install with yarn?
+```bash
+yarn add @nan0web/release
+```
+
+## CLI Usage
+
+Start by initializing a new release:
+
+How to initialize a new release version?
+```bash
+release init v1.0.0
+```
+
+const cli = new ReleaseCLI()
+Show release details:
+
+How to show release information?
+```bash
+release show [--full]
+```
+
+const release = new Release({
+version: "v1.0.0",
+createdAt: new Date("2025-08-20")
+})
+console.info(release.version) // v1.0.0
+List all releases in the project:
+
+How to list all releases?
+```bash
+release list [--json]
+```
+
+const cli = new ReleaseCLI()
+Add a chat message to the current release:
+
+How to write a release chat message?
+```bash
+release chat write --user alice "Issue with the build pipeline"
+```
+
+const cli = new ReleaseCLI()
+Host a static server for viewing releases:
+
+How to host release UI?
+```bash
+release host [--webui] [--port 3000]
+```
+
+const cli = new ReleaseCLI()
+Serve all release files for local inspection:
+
+How to serve release static assets?
+```bash
+release serve [--port 8080]
+```
+
+const cli = new ReleaseCLI()
+Validate release tasks and integrity:
+
+How to validate release tasks?
+```bash
+release validate [--ignore-fail]
+```
+
+const release = new Release({
+version: "v1.0.0",
+createdAt: new Date("2025-08-20")
+})
+Seal the release with retro reflection:
+
+How to seal a release?
+```bash
+release seal [--message "All core APIs are stable and tested"]
+```
+
+const cli = new ReleaseCLI()
+## Core Concepts
+
+### 1. Release as Object
+
+A `Release` is a structured class containing:
+- `version`: release identifier (vX.Y.Z).
+- `createdAt`, `startAt`, `planAt`, `completeAt`: datetime milestones.
+- `document`: parsed markdown document with structure-aware parsing.
+
+Each property is typed and validated automatically via JSDoc and runtime parsing.
+
+How to instantiate a Release?
+```js
+import { Release } from '@nan0web/release'
+const release = new Release({
+	version: "v1.0.0",
+	createdAt: "2025-08-20T10:00:00Z"
+})
+console.info(release.version) // ← v1.0.0
+console.info(release.createdAt instanceof Date) // ← true
+
+```
+### 2. Release Document Parsing
+
+A `ReleaseDocument` extends `@nan0web/markdown` with:
+- Structured parsing of markdown release notes
+- Extraction of sections and tasks
+- Team and role parsing from markdown frontmatter or code
+
+How to parse release notes markdown into structured data?
+```js
+import { ReleaseDocument } from '@nan0web/release'
+const md = `# v1.0.0 - 2025-08-20
+
+## Overview
+Release milestone includes UI polish and core API stabilization.
+
+### Tasks
+### Done **Implement core UI design** [ui.core-design]
+### InProgress **Fix responsive issues in mobile layout** [ui.mobile-fixes]`
+
+const doc = ReleaseDocument.from(md)
+console.info(doc.version) // ← v1.0.0
+console.info(doc.date instanceof Date) // ← true
+console.info(doc.document.children instanceof Array) // ← true
+
+```
+### 3. Person & Team Structures
+
+A `Person` instance includes:
+- `name`: HumanName
+- `gender`: HumanGender
+- `contacts`: array of HumanContact
+
+How to create a Person with typed properties?
+```js
+import { Person } from '@nan0web/release'
+const person = new Person({
+	name: ["Alice", "Developer"],
+	gender: "female",
+	contacts: ["mailto:alice@example.com"]
+})
+console.info(person.name.firstName) // ← Alice
+console.info(person.contacts.length >= 0) // ← true
+
+```
+## Architecture: Project Management as Code
+
+This architecture treats tasks as tests, roles as classes, and progress as validated outcomes.
+
+### Task Management
+
+Tasks are registered as `taskId` → `testFilePath` in `ProjectManagement`.
+Their status is derived by running `node:test` suites.
+
+How to register and validate tasks as tests?
+```js
+import { ProjectManagement } from '@nan0web/release'
+const pm = new ProjectManagement()
+pm.registerTask("task-1", "./tests/task1.test.js")
+pm.registerTask("task-2", "./tests/task2.test.js")
+
+const mockResults = {
+	passed: ["task-1"],
+	failed: [],
+	pending: ["task-2"]
+}
+
+pm.validateProjectState = async () => mockResults
+const results = await pm.validateProjectState()
+
+console.info(results.passed.includes("task-1")) // ← true
+console.info(results.pending.includes("task-2")) // ← true
+
+```
+### Release Processing
+
+The `ReleaseManager` coordinates releases and validates readiness.
+It ensures:
+- All registered tests pass
+- Version is correctly incremented
+- Git tag is applied if all validations succeed
+
+How to execute a release after validation?
+```js
+import { ReleaseManager, ProjectManagement } from '@nan0web/release'
+const pm = new ProjectManagement()
+const rm = new ReleaseManager(pm)
+
+rm.calculateVersion = () => "v1.0.1"
+rm.publish = async () => true
+
+const result = await rm.executeRelease("patch")
+console.info(result.version) // ← v1.0.1
+console.info(result.published) // ← true
+
+```
+### Changelog Integration
+
+Using `ChangelogTaskManager`, you can:
+- Extract task definitions from changelog entries
+- Generate corresponding test files
+- Automate task progression in CI
+
+How to parse changelog and extract tasks?
+```js
+import { ChangelogTaskManager } from '@nan0web/release'
+const ctm = new ChangelogTaskManager()
+const changelog = `# Changelog
+
+## [1.0.0] - 2025-08-20
+### Added
+- Initial structure [core.init]
+- Release notes support [docs.release-notes]`
+
+const tasks = ctm.parseChangelog(changelog)
+console.info(Array.isArray(tasks)) // ← true
+console.info(tasks.length >= 0) // ← true
+
+```
+## Java•Script Features
+
+Uses JSDoc and .d.ts files for autocompletion
+
+## CLI Playground
+
+Try the package in the terminal:
+
+How to run playground demo?
+```bash
+git clone https://github.com/nan0web/release.git
+cd release
+pnpm install
+pnpm run playground
+```
+
+## Project Status
+
+To verify the project is ready, run:
+
+How to check project status before publishing?
+```bash
+npm test
+npm run test:coverage
+npm run test:status
+```
+
+## Contributing
+
+How to contribute? - [check here](./CONTRIBUTING.md)
+
+## License
+
+How to license ISC? - [check here](./LICENSE)

package/bin/commands/InitCommand.js

@@ -0,0 +1,10 @@
+import { Command } from "@nan0web/co"
+
+export default class InitCommand extends Command {
+	constructor() {
+		super({
+			name: "init",
+			help: "Initializes the release version by creating file structure and default release.md"
+		})
+	}
+}

package/bin/lib/functions.js

@@ -0,0 +1,240 @@
+import { existsSync } from 'node:fs'
+import { execSync } from 'node:child_process'
+import Logger from '@nan0web/log'
+
+export const GREEN = '\x1b[32m'
+export const RESET = '\x1b[0m'
+export const OK = '✓'
+
+/**
+ * Detect package manager used in the project
+ * @returns {string} - Detected package manager (npm, yarn, pnpm)
+ */
+export function detectPackageManager() {
+	if (existsSync('pnpm-lock.yaml')) return 'pnpm'
+	if (existsSync('yarn.lock')) return 'yarn'
+	if (existsSync('package-lock.json')) return 'npm'
+
+	// Default to npm if no lock file is found
+	return 'npm'
+}
+
+/**
+ * Get package manager specific commands
+ * @param {string} packageManager - Package manager name
+ * @returns {object} - Commands map
+ */
+export function getPackageManagerCommands(packageManager) {
+	const commands = {
+		pnpm: {
+			cacheClean: 'pnpm store prune',
+			install: 'pnpm install',
+			update: 'pnpm update --latest',
+			prune: 'pnpm prune',
+			outdated: 'pnpm outdated',
+			lint: 'pnpm run lint',
+			test: 'pnpm run test',
+			build: 'pnpm run build',
+			clean: 'pnpm run clean',
+			publish: 'pnpm publish --access public',
+			pushTags: "git push origin --tags",
+			push: 'git push',
+			list: 'pnpm list',
+			storeStatus: 'pnpm store status'
+		},
+		yarn: {
+			cacheClean: 'yarn cache clean',
+			install: 'yarn install',
+			update: 'yarn upgrade',
+			prune: 'yarn autoclean --force',
+			outdated: 'yarn outdated',
+			lint: 'yarn run lint',
+			test: 'yarn run test',
+			build: 'yarn run build',
+			clean: 'yarn run clean',
+			publish: 'yarn publish --access public',
+			pushTags: 'git push origin --tags',
+			push: 'git push',
+			list: 'yarn list',
+			storeStatus: null
+		},
+		npm: {
+			cacheClean: 'npm cache clean --force',
+			installF: 'npm install',
+			update: 'npm update',
+			prune: 'npm prune',
+			outdated: 'npm outdated',
+			lint: 'npm run lint',
+			test: 'npm test',
+			build: 'npm run build',
+			clean: 'npm run clean',
+			publish: 'npm publish --access public',
+			pushTags: 'git push origin --tags',
+			push: 'git push',
+			list: 'npm list',
+			storeStatus: null
+		}
+	}
+	return commands[packageManager] || commands.npm
+}
+
+/**
+ * Run shell command
+ * @param {string} command - Command to execute
+ * @param {string} errorMessage - Error message to show if command fails
+ */
+export function runCommand(command, errorMessage) {
+	const logger = new Logger({ level: 'info' })
+	try {
+		logger.debug(`Executing command: ${command}`)
+		execSync(command, { stdio: 'inherit' })
+	} catch (err) {
+		logger.error(errorMessage)
+		logger.debug(err.stack)
+		process.exit(1)
+	}
+}
+
+/**
+ * Check if package.json has required scripts and dependencies
+ * @param {string} packageJsonPath - Path to package.json
+ * @param {boolean} fix - Whether to attempt fixing issues
+ * @returns {number} - Exit code (0 for success)
+ */
+export function checkPackageJson(packageJsonPath, fix = false) {
+	const logger = new Logger({ level: 'info' })
+	try {
+		const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf8'))
+		const requiredScripts = ['dev', 'build', 'preview', 'test', 'clean']
+		const missingScripts = requiredScripts.filter(script => !pkg.scripts?.[script])
+
+		if (missingScripts.length > 0) {
+			logger.warn(`Missing scripts in package.json: ${missingScripts.join(', ')}`)
+			if (fix) {
+				// Add missing scripts with default commands
+				pkg.scripts = pkg.scripts || {}
+				missingScripts.forEach(script => {
+					switch (script) {
+						case 'dev': pkg.scripts.dev = 'vite'; break
+						case 'build': pkg.scripts.build = 'vite build'; break
+						case 'preview': pkg.scripts.preview = 'vite preview'; break
+						case 'test': pkg.scripts.test = 'vitest'; break
+						case 'clean': pkg.scripts.clean = 'rm -rf dist'; break
+					}
+				})
+				writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2))
+				logger.info(`Fixed missing scripts in package.json`)
+			} else {
+				return 1
+			}
+		}
+
+		// Check for husky dependency
+		if (!pkg.devDependencies?.husky) {
+			logger.warn('Missing husky in devDependencies')
+			if (fix) {
+				pkg.devDependencies = pkg.devDependencies || {}
+				pkg.devDependencies.husky = '^8.0.0'
+				writeFileSync(packageJsonPath, JSON.stringify(pkg, null, 2))
+				logger.info('Added husky to devDependencies')
+			} else {
+				return 1
+			}
+		}
+	} catch (err) {
+		logger.error(`Failed to check package.json: ${err.message}`)
+		logger.debug(err.stack)
+		return 1
+	}
+	return 0
+}
+
+/**
+ * Check pre-commit hooks
+ * @param {string} packageJsonPath - Path to package.json
+ * @param {boolean} fix - Whether to attempt fixing issues
+ * @returns {number} - Exit code (0 for success)
+ */
+export function checkPreCommits(packageJsonPath, fix = false) {
+	const logger = new Logger({ level: 'info' })
+	try {
+		const huskyDir = resolve(dirname(packageJsonPath), '.husky')
+		const preCommitFile = resolve(huskyDir, 'pre-commit')
+
+		if (!existsSync(preCommitFile)) {
+			logger.warn('Missing pre-commit hook file')
+			if (fix) {
+				if (!existsSync(huskyDir)) {
+					mkdirSync(huskyDir)
+				}
+				writeFileSync(preCommitFile, '#!/bin/sh\n. "$(dirname "$0")/_/husky.sh"\n\npnpm run test\n')
+				execSync('chmod +x ' + preCommitFile)
+				logger.info('Created pre-commit hook file')
+			} else {
+				return 1
+			}
+		}
+	} catch (err) {
+		logger.error(`Failed to check pre-commit hooks: ${err.message}`)
+		logger.debug(err.stack)
+		return 1
+	}
+	return 0
+}
+
+/**
+ * Check for uncommitted changes
+ * @param {object} params - Parameters
+ * @param {string} params.version - Current version
+ * @param {object} params.devDependencies - Development dependencies
+ * @param {object} params.dependencies - Production dependencies
+ */
+export function checkUncommitted({ version, devDependencies, dependencies }) {
+	const logger = new Logger({ level: 'info' })
+	try {
+		execSync('git diff-index --quiet HEAD --', { stdio: 'ignore' })
+		execSync('git diff-files --quiet', { stdio: 'ignore' })
+	} catch (err) {
+		logger.error(`There are uncommitted changes in your repository at version ${version}`)
+		logger.debug('Dependencies:', dependencies)
+		logger.debug('Dev Dependencies:', devDependencies)
+		logger.debug(err.stack)
+		process.exit(1)
+	}
+}
+
+/**
+ * Check if git tag exists
+ * @param {string} tag - Tag to check
+ * @returns {boolean} - Whether tag exists
+ */
+export function tagExists(tag) {
+	try {
+		execSync(`git rev-parse ${tag}`, { stdio: 'ignore' })
+		return true
+	} catch {
+		return false
+	}
+}
+
+/**
+ * Tag release in git
+ * @param {string} version - Version to tag
+ */
+export function tagRelease(version) {
+	const tag = `v${version}`
+	const logger = new Logger({ level: 'info' })
+
+	if (tagExists(tag)) {
+		logger.warn(`Tag ${tag} already exists`)
+		return
+	}
+
+	try {
+		execSync(`git tag -a ${tag} -m "Release version ${version}"`, { stdio: 'inherit' })
+	} catch (err) {
+		logger.error(`Failed to tag release ${tag}`)
+		logger.debug(err.stack)
+		process.exit(1)
+	}
+}