deinsoftware · equiman · Apr 25, 2026 · Apr 25, 2026 · Apr 25, 2026 · Apr 25, 2026
diff --git a/.eslintignore b/.eslintignore
diff --git a/.eslintrc.cjs b/.eslintrc.cjs
diff --git a/.vitest/helpers.ts b/.vitest/helpers.ts
@@ -4,7 +4,7 @@ export const testCommandResult = (command: string): string => {
   try {
     const child = execSync(command)
     return child.toString().trim()
-  } catch (error) {
+  } catch {
     return ''
   }
 }
@@ -13,7 +13,7 @@ export const testCommandArray = (command: string): string[] => {
   try {
     const child = execSync(command)
     return child.toString().split('\n')
-  } catch (error) {
+  } catch {
     return ['']
   }
 }
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,12 +1,43 @@
 # Changelog
 
+<!-- http://keepachangelog.com/en/1.0.0/
+Added       for new features.
+Changed     for changes in existing functionality.
+Deprecated  for once-stable features removed in upcoming releases.
+Removed     for deprecated features removed in this release.
+Fixed       for any bug fixes.
+Security    to invite users to upgrade in case of vulnerabilities.
+-->
+
 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.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [3.0.0] - 2026-04-25
+
+### ⚠️ BREAKING CHANGES
+
+- Node.js Requirement: The minimum supported version is now Node.js v20. This change aligns with the underlying updates in the CLI engine and modern security standards.
+
+### Added
+
+- Status Command: Introduced `swpm status` (alias `s`) to show current configuration in different formats (`json`, `json:path`, `plain:path`). Especially useful for CI tools and scripts.
+- Formal validation for the latest Node.js LTS releases.
+
+### Changed
+
+- Major CLI Engine Upgrade: Migrated yargs from v17.7.2 to v18.0.0, providing better performance and modern ESM argument parsing.
+- Dependency Refresh: Comprehensive update of core libraries including chalk, update-notifier, semver, and open to ensure compatibility with the new major version.
+- Typing System: Updated @types/yargs to v17.0.35 for improved developer experience and type safety.
+
+### Fixed
+
+- Security & Vulnerabilities: Applied multiple patches identified by Snyk across the dependency tree.
+- Parser Consistency: Refined the internal command mapping to ensure that flags and aliases behave consistently across all supported package managers (npm, pnpm, yarn, and bun) under the new v18 parser.
+
 ## [2.7.0] - 2026-05-02
 
 ### Added
@@ -622,8 +653,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `pin`, `use`, `get`, `see` and `info` options
 - Pinned validation
 
+[unreleased]: https://github.com/deinsoftware/swpm/compare/v3.0.0...HEAD
+[3.0.0]: https://github.com/deinsoftware/swpm/compare/v2.7.0...v3.0.0
 [2.7.0]: https://github.com/deinsoftware/swpm/compare/v2.6.0...v2.7.0
-[unreleased]: https://github.com/deinsoftware/swpm/compare/v2.8.0...HEAD
 [2.6.0]: https://github.com/deinsoftware/swpm/compare/v2.5.2...v2.6.0
 [2.5.2]: https://github.com/deinsoftware/swpm/compare/v2.5.1...v2.5.2
 [2.5.1]: https://github.com/deinsoftware/swpm/compare/v2.5.0...v2.5.1

diff --git a/CHEATSHEET.md b/CHEATSHEET.md
diff --git a/README.md b/README.md
@@ -19,6 +19,17 @@
   - [Prerequisites](#prerequisites)
   - [Installing](#installing)
 - [swpm](#swpm)
+  - [Help](#help)
+  - [Commands](#commands)
+    - [Install](#install)
+    - [Add](#add)
+    - [Remove](#remove)
+    - [Update](#update)
+    - [Upgrade](#upgrade)
+    - [Interactive](#interactive)
+    - [Open](#open)
+    - [Clean](#clean)
+    - [Status](#status)
 - [swpx](#swpx)
 - [Alias](#alias)
 - [Flags](#flags)
@@ -90,6 +101,7 @@ Commands:
   swpm interactive [args]        update packages interactive       [aliases: ui]
   swpm open [resource] [args]    open in the file explore or browser[aliases: o]
   swpm clean [args]              clean packages                     [aliases: c]
+  swpm status [format]           show information in different formats [aliases: s]
 
 Options:
   -u, --use    use a package manager
@@ -304,7 +316,47 @@ swpm clean [args]
 | `--all`           |       | Run all args and also delete the **.yarn** folder                                    |
 
 > `--fresh` is a good choice when you want to clean the project and reinstall all packages again with `swpm install --frozen` and preserving the lock files intact.  
-> `--all` is a good choice when you want to clean the project and migrate to a different Package Manager or reinstalling all packages and create/update the lock files.  
+> `--all` is a good choice when you want to clean the project and migrate to a different Package Manager or reinstalling all packages and create/update the lock files.
+
+#### Status
+
+Show current configuration in different formats. Useful for CI tools or scripts.
+
+```bash
+swpm status [format]
+```
+
+> Alias: `s`
+
+The `[format]` parameter allows you to choose the output format:
+
+| Format         | Description                                                        |
+| -------------- | ------------------------------------------------------------------ |
+| `json`         | Full information in JSON format (default)                          |
+| `json:<path>`  | A specific property in JSON format (e.g., `json:versions.node`)    |
+| `plain:<path>` | A specific property in plain text (e.g., `plain:using`)            |
+
+**Examples:**
+
+```bash
+swpm status
+# {
+#   "_": "npm",
+#   "using": "npm",
+#   "origin": "pinned",
+#   "versions": {
+#     "swpm": "3.0.0",
+#     "node": "24.15.0",
+#     "npm": "11.12.1"
+#   }
+# }
+
+swpm status json:using
+# "npm"
+
+swpm status plain:using
+# npm
+```
 
 ⇧ [Back to menu](#menu)
 

diff --git a/eslint.config.mjs b/eslint.config.mjs
@@ -0,0 +1,33 @@
+import js from '@eslint/js'
+import tseslint from 'typescript-eslint'
+import globals from 'globals'
+
+export default tseslint.config(
+  {
+    ignores: ['**/build/**', '**/coverage/**', '**/bin/**', '**/dist/**', '**/node_modules/**']
+  },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    languageOptions: {
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+        ...globals.es2021
+      }
+    },
+    rules: {
+      'semi': ['error', 'never'],            // without ;
+      'quotes': ['error', 'single'],         // single quotes
+      'indent': ['error', 2],                // 2 spaces
+      'comma-dangle': ['error', 'never'],    // no trailing comma
+      'object-curly-spacing': ['error', 'always'],
+
+      // Reglas de TypeScript para swpm
+      '@typescript-eslint/no-unused-vars': 'error',
+      '@typescript-eslint/consistent-type-definitions': ['error', 'type'],
+      '@typescript-eslint/no-explicit-any': 'warn'
+    }
+  }
+)