pi-for-excel-python-bridge 0.1.0-pre → 0.1.1-pre

package/README.md

@@ -13,19 +13,19 @@ This command:
 1. Ensures `mkcert` exists (installs via Homebrew on macOS if missing)
 2. Creates certificates in `~/.pi-for-excel/certs/` when needed
 3. Starts the bridge at `https://localhost:3340`
+4. Runs in real local execution mode by default
 
-Default mode is `stub` (safe simulated responses).
-
-For real local execution mode:
+To force safe simulated mode:
 
 ```bash
-PYTHON_BRIDGE_MODE=real npx pi-for-excel-python-bridge
+PYTHON_BRIDGE_MODE=stub npx pi-for-excel-python-bridge
 ```
 
 Then in Pi for Excel:
 
-1. Run `/experimental python-bridge-url https://localhost:3340`
-2. (Optional) run `/experimental python-bridge-token <token>` if you set `PYTHON_BRIDGE_TOKEN`
+1. The default Python bridge URL is already `https://localhost:3340`
+2. (Optional) set `/experimental python-bridge-url <url>` to use a non-default URL
+3. (Optional) run `/experimental python-bridge-token <token>` if you set `PYTHON_BRIDGE_TOKEN`
 
 ## Publishing (maintainers)
 

package/cli.mjs

@@ -174,12 +174,23 @@ function applyDefaultPort(env) {
   }
 }
 
+function applyDefaultMode(env) {
+  const configuredMode = typeof env.PYTHON_BRIDGE_MODE === "string"
+    ? env.PYTHON_BRIDGE_MODE.trim()
+    : "";
+
+  if (configuredMode.length === 0) {
+    env.PYTHON_BRIDGE_MODE = "real";
+  }
+}
+
 function startBridge(bridgeArgs) {
   fs.mkdirSync(certDir, { recursive: true });
   console.log(`[${PACKAGE_TAG}] Using certificate directory: ${certDir}`);
 
   const childEnv = { ...process.env };
   applyDefaultPort(childEnv);
+  applyDefaultMode(childEnv);
 
   if (typeof childEnv.PI_FOR_EXCEL_CERT_DIR !== "string" || childEnv.PI_FOR_EXCEL_CERT_DIR.trim().length === 0) {
     childEnv.PI_FOR_EXCEL_CERT_DIR = certDir;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-for-excel-python-bridge",
-  "version": "0.1.0-pre",
+  "version": "0.1.1-pre",
   "description": "One-command local HTTPS Python / LibreOffice bridge helper for Pi for Excel.",
   "type": "module",
   "bin": {