@tungcorn/spacelens 0.1.1 → 0.1.3

package/README.md

@@ -3,9 +3,10 @@
 SpaceLens is native C++ storage intelligence for Windows.
 
 This npm package is an installation channel. It contains the complete
-v0.1.1 distribution: the desktop GUI and the read-only CLI, plus the Qt
-6.8.3 runtime those binaries need. Node and npm are required only to
-install and launch this package. SpaceLens itself remains native C++.
+v0.1.3 distribution: the desktop GUI, the read-only CLI, and the
+read-only MCP server, plus the Qt 6.8.3 runtime the GUI needs. Node
+and npm are required only to install and launch this package.
+SpaceLens itself remains native C++.
 
 This is not a Node SDK. The wrappers do not add commands, transform
 JSON, or authorize filesystem maintenance.
@@ -31,25 +32,33 @@ download further GitHub or npm assets.
 
 ```text
 spacelens
+spacelens-mcp
 spacelens-gui
 ```
 
-CLI examples (real verbs from SpaceLens v0.1.1):
+- `spacelens` — command-line storage intelligence
+- `spacelens-mcp` — read-only stdio MCP server for AI agents
+- `spacelens-gui` — native desktop interface
+
+CLI examples:
 
 ```text
 spacelens version
 spacelens help
 spacelens capabilities --json
-spacelens scan C:\path\to\folder --json
-spacelens top C:\path\to\folder --json
+spacelens overview C:\path\to\folder --json
+spacelens opportunities C:\path\to\folder --json
 ```
 
 `spacelens ... --json` is safe for scripts and agents: the launcher
 prints no banner and does not rewrite native stdout.
 
+`spacelens-mcp` is stdio MCP. Pair it with an MCP client. The
+launcher prints no banner; stdout is protocol only.
+
 ## Safety
 
-The CLI is read-only.
+The CLI and MCP adapter are read-only.
 
 ```text
 spacelens capabilities --json
@@ -57,14 +66,14 @@ spacelens capabilities --json
 
 reports `filesystem_mutation: false`.
 
-The CLI cannot recycle, restore, delete, move, or declare locations.
+They cannot recycle, restore, delete, move, or declare locations.
 Filesystem maintenance remains GUI-only and explicitly human-authorized
 (Recycle Bin, after confirmation). The npm wrapper exposes no mutation
-API.
+API. AI recommendation is not filesystem permission.
 
 Uninstalling the npm package removes the staged binaries and shims. It
 does not delete `%LOCALAPPDATA%\SpaceLens\` (indexes, review state,
-maintenance history).
+maintenance history, hash cache).
 
 ## License
 

package/bin/spacelens-mcp.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+'use strict';
+
+const { exitWithNative } = require('./launch.js');
+
+process.exit(exitWithNative('spacelens-mcp.exe', process.argv.slice(2)));

package/licenses/QT_SOURCE_OFFER.md

@@ -1,7 +1,7 @@
 # Written offer of Qt 6.8.3 corresponding source
 
 This is a maintainer-controlled written offer for the Qt libraries
-dynamically shipped with SpaceLens 0.1.1. It is not legal advice.
+dynamically shipped with SpaceLens 0.1.3. It is not legal advice.
 It is not the SpaceLens MIT license. Qt remains under the licenses
 declared by the Qt 6.8.3 kit.
 
@@ -9,10 +9,13 @@ declared by the Qt 6.8.3 kit.
 
 The SpaceLens maintainer offers to give you a copy of the Corresponding
 Source for the Qt 6.8.3 modules and plugins actually distributed with
-`spacelens-v0.1.1-windows-x64.zip`, for as long as SpaceLens continues
+`spacelens-v0.1.3-windows-x64.zip`, for as long as SpaceLens continues
 to distribute those binaries and for at least three years after each
 such distribution. The same offer remains in force for the historical
-v0.1.0 GUI-only archive `spacelens-gui-v0.1.0-windows-x64.zip`.
+v0.1.2 unified archive `spacelens-v0.1.2-windows-x64.zip`, the
+historical v0.1.1 unified archive `spacelens-v0.1.1-windows-x64.zip`,
+and the historical v0.1.0 GUI-only archive
+`spacelens-gui-v0.1.0-windows-x64.zip`.
 
 The source offered is the official Qt 6.8.3 open-source source archive
 identified in `packaging/qt-source/SOURCE_IDENTITY.txt`:

package/native/README.txt

@@ -1,17 +1,19 @@
 SpaceLens (complete Windows distribution)
 
-This archive is the recommended SpaceLens install. It contains both
+This archive is the recommended SpaceLens install. It contains three
 interfaces of the same product:
 
   spacelens-gui.exe   desktop analyzer
   spacelens.exe       read-only CLI for terminals, scripts, and agents
+  spacelens-mcp.exe   read-only stdio MCP server for AI harnesses
 
 Cleanup Review and Recycle Bin maintenance stay human-authorized in the
-GUI. The CLI in this folder cannot delete, recycle, restore, move, or
-declare locations. `spacelens capabilities --json` reports
-filesystem_mutation: false.
+GUI. The CLI and MCP adapter in this folder cannot delete, recycle,
+restore, move, or declare locations. `spacelens capabilities --json`
+reports filesystem_mutation: false. AI recommendation is not
+filesystem permission.
 
-Do not also install the optional CLI-only archive if you already have
+Do not also install the optional headless archive if you already have
 this complete package. Both expose the `spacelens` command.
 
 The official Microsoft Visual C++ Redistributable (x64) is a runtime
@@ -19,12 +21,12 @@ prerequisite. Qt runtime libraries in this folder were deployed with
 windeployqt --no-compiler-runtime --no-system-d3d-compiler
 --no-system-dxc-compiler from the Qt 6.8.3 shared kit.
 
-v0.1.1 prerelease binaries are unsigned.
+v0.1.3 binaries are unsigned.
 
 SpaceLens-owned files in this archive are licensed under MIT.
 See LICENSE. Qt remains under its own licenses (LGPL-3.0-only option
-for this dynamic build). Qt is not MIT. Adding spacelens.exe to this
-archive does not change Qt's license.
+for this dynamic build). Qt is not MIT. Adding spacelens.exe or
+spacelens-mcp.exe to this archive does not change Qt's license.
 
 licenses\ holds:
   - verbatim GNU LGPL-3.0 and GPL-3.0 texts

package/native/licenses/QT_SOURCE_OFFER.md

@@ -1,7 +1,7 @@
 # Written offer of Qt 6.8.3 corresponding source
 
 This is a maintainer-controlled written offer for the Qt libraries
-dynamically shipped with SpaceLens 0.1.1. It is not legal advice.
+dynamically shipped with SpaceLens 0.1.3. It is not legal advice.
 It is not the SpaceLens MIT license. Qt remains under the licenses
 declared by the Qt 6.8.3 kit.
 
@@ -9,10 +9,13 @@ declared by the Qt 6.8.3 kit.
 
 The SpaceLens maintainer offers to give you a copy of the Corresponding
 Source for the Qt 6.8.3 modules and plugins actually distributed with
-`spacelens-v0.1.1-windows-x64.zip`, for as long as SpaceLens continues
+`spacelens-v0.1.3-windows-x64.zip`, for as long as SpaceLens continues
 to distribute those binaries and for at least three years after each
 such distribution. The same offer remains in force for the historical
-v0.1.0 GUI-only archive `spacelens-gui-v0.1.0-windows-x64.zip`.
+v0.1.2 unified archive `spacelens-v0.1.2-windows-x64.zip`, the
+historical v0.1.1 unified archive `spacelens-v0.1.1-windows-x64.zip`,
+and the historical v0.1.0 GUI-only archive
+`spacelens-gui-v0.1.0-windows-x64.zip`.
 
 The source offered is the official Qt 6.8.3 open-source source archive
 identified in `packaging/qt-source/SOURCE_IDENTITY.txt`:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tungcorn/spacelens",
-  "version": "0.1.1",
-  "description": "Native Windows storage intelligence. This package installs the desktop GUI and the read-only CLI.",
+  "version": "0.1.3",
+  "description": "Native Windows storage intelligence. This package installs the desktop GUI, the read-only CLI, and the read-only MCP server.",
   "license": "MIT",
   "author": "tungcorn",
   "homepage": "https://github.com/tungcorn/spacelens",
@@ -19,6 +19,7 @@
     "disk",
     "cli",
     "gui",
+    "mcp",
     "disk-usage"
   ],
   "os": [
@@ -32,7 +33,8 @@
   },
   "bin": {
     "spacelens": "bin/spacelens.js",
-    "spacelens-gui": "bin/spacelens-gui.js"
+    "spacelens-gui": "bin/spacelens-gui.js",
+    "spacelens-mcp": "bin/spacelens-mcp.js"
   },
   "files": [
     "bin/",