winclean-cli 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, winclean contributors
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -1,3 +1,41 @@
-# Temporary Holding Version
+# winclean
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Windows temp and cache cleaner. Ships a self-contained `win32-x64` executable;
+no Dart SDK required.
+
+## Install
+
+```powershell
+npm install -g winclean-cli
+```
+
+## Usage
+
+```powershell
+winclean              # interactive TUI: pick targets, watch progress, review results
+winclean --dry-run    # report what would be deleted
+winclean --json       # machine-readable output
+winclean --quiet      # print only the total
+winclean --older-than 7d
+```
+
+Run `winclean --help` for all options.
+
+## Safety
+
+- Cleaning requires selected targets; nothing is deleted until you confirm.
+- Protected paths (`SystemRoot`, `USERPROFILE`, `LOCALAPPDATA`, `APPDATA`,
+  `ProgramFiles`, `ProgramData`) are never cleaned.
+- Windows Temp and Windows Update cache need an elevated shell.
+- `--dry-run` previews without deleting.
+
+## Requirements
+
+- Windows x64
+- Node.js 18 or newer (only for the npm launcher)
+
+The interactive TUI needs both stdin and stdout attached to a terminal.
+Redirected or piped output uses plain text or JSON instead.
+
+The executable is not code-signed. Windows Smart App Control may block
+unsigned programs; if Windows blocks it, use a signed release when available.

package/bin/winclean.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawn } = require('node:child_process');
+const path = require('node:path');
+
+const exe = path.join(__dirname, '..', 'vendor', 'winclean.exe');
+
+const child = spawn(exe, process.argv.slice(2), { stdio: 'inherit' });
+
+child.on('error', (error) => {
+  console.error(`winclean: failed to launch ${exe}: ${error.message}`);
+  process.exit(1);
+});
+
+child.on('close', (code) => {
+  process.exit(code === null ? 1 : code);
+});

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "winclean-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Windows temp and cache cleaner with an interactive TUI",
+  "license": "BSD-3-Clause",
+  "author": "winclean contributors",
+  "bin": {
+    "winclean": "bin/winclean.js"
+  },
+  "files": [
+    "bin/winclean.js",
+    "vendor/winclean.exe",
+    "README.md",
+    "LICENSE"
+  ],
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "windows",
+    "cleaner",
+    "temp",
+    "cache",
+    "cli",
+    "tui",
+    "disk"
+  ],
+  "scripts": {
+    "prepack": "node scripts/check-artifact.js"
+  }
+}