pi-revit 0.1.0 → 0.1.2

package/README.md

@@ -44,29 +44,57 @@ LLM provider, like any Pi session.
 
 ## Install
 
+### One-command install
+
 Close Revit, then in PowerShell:
 
+```powershell
+npx -y pi-revit
+```
+
+This installs the Pi package, builds and deploys the Revit bridge add-in, creates the
+`Documents\pi-revit` workspace, and installs the global `pi-revit` command.
+
+Start Revit (click **Always Load** on the unsigned add-in prompt once) and open any
+project. No panel or ribbon appears — the add-in is headless.
+
+### Manual npm install
+
+Use this if you prefer to run each step yourself:
+
+```powershell
+# 1. Install the Pi package from npm. This registers the pi-revit extension and skill.
+pi install npm:pi-revit
+
+# 2. Go to the installed package folder.
+cd "$env:USERPROFILE\.pi\agent\npm\node_modules\pi-revit"
+
+# 3. Build + deploy the Revit add-in (RevitBridge.dll + the Roslyn DLLs for execute_csharp).
+npm run deploy
+
+# 4. Create the workspace and global pi-revit command.
+npm run setup
+```
+
+For a non-default Revit install location, use the PowerShell deploy script directly and pass
+`-RevitVersion` / `-RevitApiPath`, e.g.:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1 -RevitVersion 2027 -RevitApiPath "D:\Autodesk\Revit 2027"
+```
+
+### Source install
+
+Use this if you want to run directly from the GitHub checkout instead of the npm package:
+
 ```powershell
 git clone https://github.com/Triavision-ai/pi-revit.git
 cd pi-revit
-
-# 1. Build + deploy the Revit add-in (RevitBridge.dll + the Roslyn DLLs for execute_csharp)
-#    Auto-detects every supported Revit (2025+) installed under Program Files and deploys to each.
-#    Only need the .NET SDK for the versions you have (e.g. just .NET 8 if you only run 2025/2026).
-#    For a non-default install location, pass -RevitVersion and -RevitApiPath, e.g.:
-#      ... scripts\deploy.ps1 -RevitVersion 2027 -RevitApiPath "D:\Autodesk\Revit 2027"
 powershell -ExecutionPolicy Bypass -File scripts\deploy.ps1
-
-# 2. Install the Pi package
 pi install ./
-
-# 3. Workspace + global pi-revit command
 powershell -ExecutionPolicy Bypass -File scripts\setup-workspace.ps1
 ```
 
-Start Revit (click **Always Load** on the unsigned add-in prompt once) and open any
-project. No panel or ribbon appears — the add-in is headless.
-
 ## Use it
 
 Open **any terminal** — PowerShell, CMD, or Windows Terminal — and type:
@@ -135,15 +163,28 @@ Plain `pi` from any folder also works; `pi-revit` just adds the right working fo
 
 ## Uninstall
 
-Close Revit, then in PowerShell from the repo:
+### npm install
+
+Close Revit, then in PowerShell:
+
+```powershell
+cd "$env:USERPROFILE\.pi\agent\npm\node_modules\pi-revit"
+powershell -ExecutionPolicy Bypass -File scripts\uninstall.ps1
+pi remove npm:pi-revit
+```
+
+### Source install
+
+Close Revit, then in PowerShell from the GitHub checkout:
 
 ```powershell
 powershell -ExecutionPolicy Bypass -File scripts\uninstall.ps1
 ```
 
 This removes the Revit bridge add-in (every installed Revit version), the global `pi-revit`
-command, the bridge runtime folder (`%APPDATA%\RevitBridge\`), and the Pi package registration.
-Your workspace at `Documents\pi-revit` (notes + session history) is **preserved** — add
-`-RemoveWorkspace` to delete it too, or `-RevitVersion 2026` to target a single Revit version.
-Pi itself is left installed; remove it with `npm uninstall -g @earendil-works/pi-coding-agent` if
-you want.
+command, and the bridge runtime folder (`%APPDATA%\RevitBridge\`). It also removes the Pi
+package registration for source installs; npm installs should additionally run
+`pi remove npm:pi-revit` as shown above. Your workspace at `Documents\pi-revit` (notes + session
+history) is **preserved** — add `-RemoveWorkspace` to delete it too, or `-RevitVersion 2026` to
+target a single Revit version. Pi itself is left installed; remove it with
+`npm uninstall -g @earendil-works/pi-coding-agent` if you want.

package/bin/pi-revit.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const root = path.resolve(__dirname, "..");
+const scriptsDir = path.join(root, "scripts");
+
+function usage() {
+	console.log(`pi-revit installer\n\nUsage:\n  npx -y pi-revit\n\nWhat it does on Windows:\n  1. Runs: pi install npm:pi-revit\n  2. Builds and deploys the Revit bridge add-in\n  3. Creates the Documents\\pi-revit workspace and global pi-revit command\n\nClose Revit before running. Revit 2025, 2026, or 2027 and the matching .NET SDK are required.`);
+}
+
+function fail(message) {
+	console.error(`\npi-revit install failed: ${message}`);
+	process.exit(1);
+}
+
+function commandExists(command) {
+	return spawnSync("where.exe", [command], { stdio: "ignore" }).status === 0;
+}
+
+function run(title, command, args) {
+	console.log(`\n==> ${title}`);
+	const result = spawnSync(command, args, { stdio: "inherit", shell: false });
+	if (result.error) fail(`${command} could not be started: ${result.error.message}`);
+	if (result.status !== 0) process.exit(result.status ?? 1);
+}
+
+function runPowerShellScript(scriptName) {
+	const scriptPath = path.join(scriptsDir, scriptName);
+	if (!fs.existsSync(scriptPath)) fail(`missing script: ${scriptPath}`);
+	run(scriptName, "powershell.exe", ["-ExecutionPolicy", "Bypass", "-File", scriptPath]);
+}
+
+function revitIsRunning() {
+	const result = spawnSync(
+		"powershell.exe",
+		["-NoProfile", "-Command", "if (Get-Process Revit -ErrorAction SilentlyContinue) { exit 0 } else { exit 1 }"],
+		{ stdio: "ignore" },
+	);
+	return result.status === 0;
+}
+
+function waitForEnter() {
+	console.log("\nRevit appears to be running. Close Revit now, then press Enter to continue (or Ctrl+C to cancel).");
+	try {
+		fs.readSync(0, Buffer.alloc(1), 0, 1);
+	} catch {
+		// Non-interactive shell: fall through to the second running check.
+	}
+}
+
+if (process.argv.includes("--help") || process.argv.includes("-h")) {
+	usage();
+	process.exit(0);
+}
+
+if (process.platform !== "win32") {
+	fail("pi-revit's Revit bridge installer supports Windows only.");
+}
+
+if (!commandExists("pi")) {
+	fail("the 'pi' command was not found on PATH. Install Pi first: npm install -g --ignore-scripts @earendil-works/pi-coding-agent");
+}
+
+if (!commandExists("dotnet")) {
+	fail("the 'dotnet' command was not found on PATH. Install the .NET SDK required by your Revit version.");
+}
+
+if (revitIsRunning()) {
+	waitForEnter();
+	if (revitIsRunning()) fail("Revit is still running. Close Revit and run 'npx -y pi-revit' again.");
+}
+
+console.log("pi-revit full installer");
+console.log("This installs the Pi package, deploys the Revit add-in, and creates the workspace/global command.");
+
+run("Install the Pi package from npm", "pi", ["install", "npm:pi-revit"]);
+runPowerShellScript("deploy.ps1");
+runPowerShellScript("setup-workspace.ps1");
+
+console.log("\npi-revit installed.");
+console.log("Next steps:");
+console.log("  1. Start Revit and click Always Load if prompted.");
+console.log("  2. Open a project.");
+console.log("  3. Run: pi-revit");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-revit",
-  "version": "0.1.0",
-  "description": "Native Pi connector for Autodesk Revit through a headless bridge add-in.",
+  "version": "0.1.2",
+  "description": "Native Pi connector for Autodesk Revit. Run npx -y pi-revit for the full Windows install.",
   "author": "Ahmad Altahlawi",
   "license": "MIT",
   "repository": {
@@ -12,11 +12,38 @@
     "url": "https://github.com/Triavision-ai/pi-revit/issues"
   },
   "homepage": "https://github.com/Triavision-ai/pi-revit#readme",
-  "keywords": ["pi-package", "pi-extension", "revit", "bim", "autodesk", "revit-api"],
-  "files": ["extensions/", "skills/", "scripts/", "src/", "workspace/", "README.md"],
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "revit",
+    "bim",
+    "autodesk",
+    "revit-api"
+  ],
+  "bin": {
+    "pi-revit": "bin/pi-revit.js"
+  },
+  "scripts": {
+    "deploy": "powershell -ExecutionPolicy Bypass -File scripts/deploy.ps1",
+    "setup": "powershell -ExecutionPolicy Bypass -File scripts/setup-workspace.ps1",
+    "uninstall:revit": "powershell -ExecutionPolicy Bypass -File scripts/uninstall.ps1"
+  },
+  "files": [
+    "bin/",
+    "extensions/",
+    "skills/",
+    "scripts/",
+    "src/",
+    "workspace/",
+    "README.md"
+  ],
   "pi": {
-    "extensions": ["./extensions/pi-revit/index.ts"],
-    "skills": ["./skills"]
+    "extensions": [
+      "./extensions/pi-revit/index.ts"
+    ],
+    "skills": [
+      "./skills"
+    ]
   },
   "engines": {
     "node": ">=20.3"