caliper-harness 0.1.2 → 0.1.3

package/README.md

@@ -3,28 +3,31 @@
 Local models, practical coding tools and project memory.
 
 ```sh
-npm install -g caliper-harness
-cd your-project
+npm install caliper-harness
 caliper
 ```
 
-The installer downloads the complete application for macOS Apple Silicon,
-Windows x64, or Linux x64/ARM64. Node 20 or newer is needed for this launcher.
-On Windows, the launcher checks the Microsoft Visual C++ runtime before starting.
-If it is missing or outdated, the shared prerequisite helper downloads Microsoft’s
-installer directly and may request administrator approval or a restart. An already
-compatible installation needs no download. Caliper does not bundle Microsoft’s
-installer or runtime DLLs.
+Installation downloads the complete application and registers `caliper` for your
+user account. If your current terminal cannot find it, open a new terminal;
+installation cannot change the PATH of a terminal that is already running. You
+can then enter any project directory and run `caliper`.
+
+Plain npm installation creates `node_modules` and npm package files in the
+installation directory. To avoid those files in a project, install globally with
+`npm install -g caliper-harness`; npm supplies the global command in that case.
+
+Supported platforms are macOS Apple Silicon, Windows x64 and Linux x64/ARM64.
+Node 20 or newer is needed for the npm launcher. On Windows, the launcher checks
+the Microsoft Visual C++ runtime before starting. If it is missing or outdated,
+the shared prerequisite helper downloads Microsoft's installer directly and may
+request administrator approval or a restart. A compatible installation needs no
+download. Caliper does not bundle Microsoft's installer or runtime DLLs.
 
 Model weights and tools belonging to your project remain yours to install.
 
 Caliper offers available updates at startup. Use `/update` to download an update
-for your next launch, or `npm install -g caliper-harness@latest`.
+for your next launch, or repeat your npm installation with `caliper-harness@latest`.
 
 Your settings, graph and sessions live in your operating system's user-data
 folder, separate from application versions. Updates preserve previous versions
 and never delete your project work or model files.
-
-For a project-local installation, `npm install caliper-harness` followed by
-`npx caliper` works too; npm creates `node_modules` in that project. Use the global
-command above to keep project directories free of installation files.

package/install.cjs

@@ -72,6 +72,23 @@ async function activateNative(root) {
     child.on('error',reject);child.on('exit',code=>code===0?resolve():reject(new Error(`Native installation activation failed (${code}); previous selection preserved`)));
   });
 }
+async function registerCommand(root) {
+  // Global npm installs already register the package's bin entry. Local npm
+  // installs need the same per-user registration as downloaded app folders.
+  if (process.env.npm_config_global === 'true') return;
+  let command = '/bin/sh', args = [path.join(root, 'install.sh')];
+  if (process.platform === 'win32') {
+    if (!process.env.SystemRoot) throw new Error('SystemRoot unavailable; cannot register Caliper command');
+    command = path.join(process.env.SystemRoot, 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+    // Register the installed folder in place; do not copy its runtime again.
+    args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', path.join(root, 'install-windows.ps1'), '-TargetDirectory', root];
+  }
+  await new Promise((resolve, reject) => {
+    const child = spawn(command, args, {stdio: 'inherit', windowsHide: false});
+    child.on('error', reject);
+    child.on('exit', code => code === 0 ? resolve() : reject(new Error(`Caliper command registration failed (${code}); application retained at ${root}`)));
+  });
+}
 async function install(base = home(), download = get, activate = activateNative) {
   if (!supported.includes(identity)) throw new Error(`No Caliper product bundle for ${identity}. Supported: ${supported.join(', ')}`);
   const parent = path.join(base, 'versions', version, identity);
@@ -118,5 +135,5 @@ async function install(base = home(), download = get, activate = activateNative)
     return root;
   } finally { fs.rmSync(stage, { recursive: true, force: true }); }
 }
-if (require.main === module) install().then(root => console.log(`Caliper ${version} installed: ${root}\nRun caliper from your project directory.`)).catch(error => { console.error(`Caliper installation failed: ${error.message}`); process.exitCode = 1; });
-module.exports = { home, executable, validate, install, identity, version, ensurePrerequisites, activateNative };
+if (require.main === module) install().then(async root => { await registerCommand(root); console.log(`Caliper ${version} installed: ${root}\nRun caliper from your project directory. Reopen your terminal if the command is not found.`); }).catch(error => { console.error(`Caliper installation failed: ${error.message}`); process.exitCode = 1; });
+module.exports = { home, executable, validate, install, identity, version, ensurePrerequisites, activateNative, registerCommand };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caliper-harness",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A local coding harness with tools, planning and durable project memory",
   "license": "MIT",
   "repository": "github:santiagoaraoz2001-sketch/caliper-harness",