@optimizely/ocp-cli 1.2.17 → 1.3.0

package/README.md

@@ -17,13 +17,35 @@ ocp
 ocp <namespace> -h
 ```
 
-## Development
+## Commands
 
-### Forbidden Dependencies
+### `ocp dev-server`
 
-The following dependencies have been intentionally removed from this project and **must not be re-added**:
+Start the local development server for OCP applications.
 
-- `@zaiusinc/app-sdk`
-- `@zaiusinc/node-sdk`
+The `@optimizely/ocp-local-env` package is automatically managed by this command:
+- First run: Automatically installs the package globally
+- Daily check: Checks for updates once per day and auto-upgrades when available
+- No manual installation required
 
-These dependencies were removed to decouple the CLI from app-specific SDKs. An automated test (`src/test/dependencies.test.ts`) enforces this restriction and will fail if these packages are added to `package.json`.
+**Options:**
+- `-p, --port <port>` - Port to run the server on (default: 3000)
+- `-c, --config <path>` - Path to custom config file
+- `--path <path>` - Path to the OCP app root directory (default: current directory)
+- `-v, --verbose` - Enable verbose logging
+- `--no-open` - Don't automatically open browser
+
+**Examples:**
+```bash
+# Start server in current directory on default port
+ocp dev-server start
+
+# Start on custom port
+ocp dev-server start -p 4000
+
+# Start with specific app directory
+ocp dev-server start --path /path/to/my-app
+
+# Short version to start server
+ocp dev
+```

package/dist/commands/Dev.d.ts

@@ -0,0 +1,3 @@
+export declare class Dev {
+    dev(): Promise<void>;
+}

package/dist/commands/Dev.js

@@ -0,0 +1,23 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Dev = void 0;
+const DevServer_1 = require("./dev-server/DevServer");
+const oo_cli_1 = require("oo-cli");
+class Dev {
+    async dev() {
+        const dev = new DevServer_1.DevServerCommand();
+        await dev.start();
+    }
+}
+__decorate([
+    oo_cli_1.command,
+    (0, oo_cli_1.help)('Start the local development server for OCP apps (for more configuration options use ocp dev-server start)')
+], Dev.prototype, "dev", null);
+exports.Dev = Dev;
+//# sourceMappingURL=Dev.js.map

package/dist/commands/Dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dev.js","sourceRoot":"","sources":["../../src/commands/Dev.ts"],"names":[],"mappings":";;;;;;;;;AAAA,sDAAwD;AACxD,mCAAqC;AAErC,MAAa,GAAG;IAID,AAAN,KAAK,CAAC,GAAG;QACd,MAAM,GAAG,GAAG,IAAI,4BAAgB,EAAE,CAAC;QACnC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF;AAJc;IAFZ,gBAAO;IACP,IAAA,aAAI,EAAC,2GAA2G,CAAC;8BAIjH;AAPH,kBAQC"}

package/dist/commands/dev-server/DevServer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Dev Server command - starts the local development server for OCP apps
+ * This is a top-level command (no namespace decorator), so it runs as `ocp dev-server`
+ */
+export declare class DevServerCommand {
+    port: string;
+    config?: string;
+    path?: string;
+    verbose: boolean;
+    noOpen: boolean;
+    private PACKAGE_NAME;
+    start(): Promise<void>;
+    /**
+     * Ensure @optimizely/ocp-local-env is installed globally and up-to-date.
+     * Checks once per day and auto-installs or auto-upgrades as needed.
+     */
+    private ensureOcpLocalEnv;
+    /**
+     * Check if a package is installed globally and return its version.
+     * @returns The installed version or null if not installed
+     */
+    private getInstalledVersion;
+    /**
+     * Get the latest version of a package from npm registry.
+     * @returns The latest version or null if unavailable
+     */
+    private getLatestVersion;
+    /**
+     * Install or update a global npm package.
+     * @param isUpgrade Whether this is an upgrade (affects success message)
+     * @returns True if successful, false otherwise
+     */
+    private installGlobalPackage;
+}

package/dist/commands/dev-server/DevServer.js

@@ -0,0 +1,187 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DevServerCommand = void 0;
+const chalk = require("chalk");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const semver = require("semver");
+const oo_cli_1 = require("oo-cli");
+const die_1 = require("../../lib/die");
+const formatError_1 = require("../../lib/formatError");
+const handleInterrupt_1 = require("../../lib/handleInterrupt");
+const TerminalOutput_1 = require("../../lib/TerminalOutput");
+const TeminalPassthru_1 = require("../../lib/TeminalPassthru");
+/**
+ * Dev Server command - starts the local development server for OCP apps
+ * This is a top-level command (no namespace decorator), so it runs as `ocp dev-server`
+ */
+let DevServerCommand = class DevServerCommand {
+    constructor() {
+        this.PACKAGE_NAME = '@optimizely/ocp-local-env';
+    }
+    async start() {
+        var _a;
+        (0, handleInterrupt_1.handleInterrupt)();
+        try {
+            // Ensure ocp-local-env is installed and up-to-date
+            await this.ensureOcpLocalEnv();
+            // Set environment variables that ocp-local-env expects
+            process.env.OCP_LOCAL_PORT = this.port;
+            if (this.config) {
+                process.env.OCP_LOCAL_CONFIG_PATH = this.config;
+            }
+            process.env.OCP_LOCAL_VERBOSE = this.verbose ? 'true' : 'false';
+            process.env.OCP_LOCAL_OPEN_BROWSER = this.noOpen ? 'false' : 'true';
+            if (this.path) {
+                process.env.APP_ROOT_DIR = this.path;
+            }
+            // Import and call startServer from ocp-local-env (installed globally)
+            // Get the global npm modules path and construct the full package path
+            const globalRoot = TerminalOutput_1.TerminalOutput.exec('npm root -g').stdout.trim();
+            const packagePath = path.join(globalRoot, this.PACKAGE_NAME);
+            // @ts-ignore - Package is installed globally, not in node_modules
+            const { startServer } = await (_a = packagePath, Promise.resolve().then(() => require(_a)));
+            console.log(chalk.gray('Starting OCP local development server...'));
+            await startServer();
+        }
+        catch (e) {
+            (0, die_1.die)((0, formatError_1.formatError)(e));
+        }
+    }
+    /**
+     * Ensure @optimizely/ocp-local-env is installed globally and up-to-date.
+     * Checks once per day and auto-installs or auto-upgrades as needed.
+     */
+    async ensureOcpLocalEnv() {
+        // Ensure ~/.ocp directory exists
+        const ocpDir = path.join(os.homedir(), '.ocp');
+        if (!fs.existsSync(ocpDir)) {
+            fs.mkdirSync(ocpDir, { recursive: true });
+        }
+        const checkFile = path.join(os.homedir(), '.ocp', 'last-ocp-local-env-check');
+        // Check if we should skip (< 24 hours since last check)
+        if (fs.existsSync(checkFile)) {
+            const stats = fs.statSync(checkFile);
+            const hoursSinceCheck = (Date.now() - stats.mtimeMs) / (1000 * 60 * 60);
+            if (hoursSinceCheck < 24) {
+                return; // Skip check
+            }
+        }
+        // Check if installed globally
+        const installedVersion = this.getInstalledVersion();
+        if (!installedVersion) {
+            // Not installed - auto-install
+            console.log(chalk.gray('Installing @optimizely/ocp-local-env globally...'));
+            this.installGlobalPackage(false);
+            fs.writeFileSync(checkFile, '');
+            return;
+        }
+        // Check for updates
+        const latestVersion = await this.getLatestVersion();
+        if (latestVersion && semver.gt(latestVersion, installedVersion)) {
+            // Newer version available - auto-upgrade
+            console.log(chalk.gray(`Upgrading @optimizely/ocp-local-env (${installedVersion} → ${latestVersion})...`));
+            this.installGlobalPackage(true);
+        }
+        // Touch check file
+        fs.writeFileSync(checkFile, '');
+    }
+    /**
+     * Check if a package is installed globally and return its version.
+     * @returns The installed version or null if not installed
+     */
+    getInstalledVersion() {
+        var _a, _b;
+        try {
+            const result = TerminalOutput_1.TerminalOutput.exec(`npm list -g --depth=0 --json ${this.PACKAGE_NAME}`);
+            if (result.status === 0) {
+                const data = JSON.parse(result.stdout);
+                return ((_b = (_a = data.dependencies) === null || _a === void 0 ? void 0 : _a[this.PACKAGE_NAME]) === null || _b === void 0 ? void 0 : _b.version) || null;
+            }
+            return null;
+        }
+        catch (_c) {
+            return null;
+        }
+    }
+    /**
+     * Get the latest version of a package from npm registry.
+     * @returns The latest version or null if unavailable
+     */
+    async getLatestVersion() {
+        try {
+            const result = TerminalOutput_1.TerminalOutput.exec(`npm view ${this.PACKAGE_NAME} version`);
+            if (result.status === 0) {
+                return result.stdout.trim() || null;
+            }
+            return null;
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    /**
+     * Install or update a global npm package.
+     * @param isUpgrade Whether this is an upgrade (affects success message)
+     * @returns True if successful, false otherwise
+     */
+    installGlobalPackage(isUpgrade) {
+        const spec = isUpgrade ? `${this.PACKAGE_NAME}@latest` : this.PACKAGE_NAME;
+        const result = TeminalPassthru_1.TerminalPassthru.exec(`npm install -g ${spec}`);
+        if (result.status === 0) {
+            if (isUpgrade) {
+                // Get the newly installed version for the success message
+                const newVersion = this.getInstalledVersion();
+                console.log(chalk.green(`✓ Updated to version ${newVersion}`));
+            }
+            else {
+                console.log(chalk.green('✓ Installed @optimizely/ocp-local-env'));
+            }
+            return true;
+        }
+        else {
+            console.log(chalk.red('Installation failed. Please install manually with:'));
+            console.log(chalk.red(`  npm install -g ${this.PACKAGE_NAME}`));
+            return false;
+        }
+    }
+};
+__decorate([
+    (0, oo_cli_1.option)('p'),
+    (0, oo_cli_1.help)('Port to run the server on'),
+    (0, oo_cli_1.defaultValue)('3000')
+], DevServerCommand.prototype, "port", void 0);
+__decorate([
+    (0, oo_cli_1.option)('c'),
+    (0, oo_cli_1.help)('Path to custom config file')
+], DevServerCommand.prototype, "config", void 0);
+__decorate([
+    oo_cli_1.option,
+    (0, oo_cli_1.help)('Path to the OCP app root directory')
+], DevServerCommand.prototype, "path", void 0);
+__decorate([
+    (0, oo_cli_1.flag)('v'),
+    (0, oo_cli_1.help)('Enable verbose logging'),
+    (0, oo_cli_1.defaultValue)(false)
+], DevServerCommand.prototype, "verbose", void 0);
+__decorate([
+    (0, oo_cli_1.flag)('no-open'),
+    (0, oo_cli_1.help)('Don\'t automatically open browser'),
+    (0, oo_cli_1.defaultValue)(false)
+], DevServerCommand.prototype, "noOpen", void 0);
+__decorate([
+    oo_cli_1.command,
+    (0, oo_cli_1.help)('Start the local development server for OCP apps')
+], DevServerCommand.prototype, "start", null);
+DevServerCommand = __decorate([
+    (0, oo_cli_1.namespace)('dev-server')
+], DevServerCommand);
+exports.DevServerCommand = DevServerCommand;
+//# sourceMappingURL=DevServer.js.map

package/dist/commands/dev-server/DevServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DevServer.js","sourceRoot":"","sources":["../../../src/commands/dev-server/DevServer.ts"],"names":[],"mappings":"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"}

package/dist/lib/AppPackager.js

@@ -14,7 +14,7 @@ class AppPackager {
         console.log(chalk.gray(`Packaging files in ${this.rootPath}`));
         const files = await globby(['**/*'], {
             gitignore: true,
-            ignore: ['node_modules/**/*', '*.zip', '.git/**/*'],
+            ignore: ['node_modules/**/*', '*.zip', '.git/**/*', '.ocp-local/**/*'],
             cwd: this.rootPath,
             dot: true,
             onlyFiles: true,

package/dist/lib/AppPackager.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppPackager.js","sourceRoot":"","sources":["../../src/lib/AppPackager.ts"],"names":[],"mappings":";;;AAAA,kCAAkC;AAClC,+BAA+B;AAC/B,yBAAyB;AACzB,6BAA6B;AAC7B,iCAAiC;AAEjC,MAAa,WAAW;IAGtB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAE/D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE;YACnC,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,CAAC,mBAAmB,EAAE,OAAO,EAAE,WAAW,CAAC;YACnD,GAAG,EAAE,IAAI,CAAC,QAAQ;YAClB,GAAG,EAAE,IAAI;YACT,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,KAAe;QAChD,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;gBAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;gBACnC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;aAC9C;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;CACF;AAjCD,kCAiCC"}
+{"version":3,"file":"AppPackager.js","sourceRoot":"","sources":["../../src/lib/AppPackager.ts"],"names":[],"mappings":";;;AAAA,kCAAkC;AAClC,+BAA+B;AAC/B,yBAAyB;AACzB,6BAA6B;AAC7B,iCAAiC;AAEjC,MAAa,WAAW;IAGtB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAE/D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE;YACnC,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,CAAC,mBAAmB,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,CAAC;YACtE,GAAG,EAAE,IAAI,CAAC,QAAQ;YAClB,GAAG,EAAE,IAAI;YACT,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,KAAe;QAChD,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACrB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE;gBAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;gBACnC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;aAC9C;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;CACF;AAjCD,kCAiCC"}

package/dist/oo-cli.manifest.json

@@ -1016,6 +1016,78 @@
         }
       ]
     },
+    "dev-server": {
+      "namespaces": {},
+      "commands": [
+        {
+          "path": "commands/dev-server/DevServer.js",
+          "className": "DevServerCommand",
+          "key": "start",
+          "command": "start",
+          "aliases": [],
+          "help": "Start the local development server for OCP apps",
+          "documentation": "TBD",
+          "flags": [
+            {
+              "name": "verbose",
+              "key": "verbose",
+              "aliases": [
+                "v"
+              ],
+              "invertedAliases": [],
+              "help": "Enable verbose logging",
+              "defaultValue": false,
+              "invertible": false,
+              "optional": true
+            },
+            {
+              "name": "noOpen",
+              "key": "noOpen",
+              "aliases": [
+                "no-open"
+              ],
+              "invertedAliases": [],
+              "help": "Don't automatically open browser",
+              "defaultValue": false,
+              "invertible": false,
+              "optional": true
+            }
+          ],
+          "options": [
+            {
+              "name": "port",
+              "key": "port",
+              "aliases": [
+                "p"
+              ],
+              "help": "Port to run the server on",
+              "defaultValue": "3000",
+              "optional": true,
+              "multiple": false
+            },
+            {
+              "name": "config",
+              "key": "config",
+              "aliases": [
+                "c"
+              ],
+              "help": "Path to custom config file",
+              "optional": true,
+              "multiple": false
+            },
+            {
+              "name": "path",
+              "key": "path",
+              "aliases": [],
+              "help": "Path to the OCP app root directory",
+              "optional": true,
+              "multiple": false
+            }
+          ],
+          "params": []
+        }
+      ]
+    },
     "env": {
       "namespaces": {},
       "commands": [
@@ -1369,9 +1441,22 @@
       ]
     }
   },
-  "commands": [],
+  "commands": [
+    {
+      "path": "commands/Dev.js",
+      "className": "Dev",
+      "key": "dev",
+      "command": "dev",
+      "aliases": [],
+      "help": "Start the local development server for OCP apps (for more configuration options use ocp dev-server start)",
+      "documentation": "TBD",
+      "flags": [],
+      "options": [],
+      "params": []
+    }
+  ],
   "package": {
-    "version": "1.2.17",
+    "version": "1.3.0",
     "name": "@optimizely/ocp-cli",
     "license": "Apache-2.0",
     "executable": "ocp"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optimizely/ocp-cli",
-  "version": "1.2.17",
+  "version": "1.3.0",
   "description": "Optimizely Connect Platform command line interface",
   "repository": "https://github.com/ZaiusInc/ocp-cli",
   "license": "Apache-2.0",

package/src/commands/Dev.ts

@@ -0,0 +1,12 @@
+import {DevServerCommand} from './dev-server/DevServer';
+import {command, help} from 'oo-cli';
+
+export class Dev {
+
+  @command
+  @help('Start the local development server for OCP apps (for more configuration options use ocp dev-server start)')
+  public async dev() {
+    const dev = new DevServerCommand();
+    await dev.start();
+  }
+}

package/src/commands/dev-server/DevServer.ts

@@ -0,0 +1,180 @@
+import * as chalk from 'chalk';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import * as semver from 'semver';
+import {command, defaultValue, flag, help, option, namespace} from 'oo-cli';
+import {die} from '../../lib/die';
+import {formatError} from '../../lib/formatError';
+import {handleInterrupt} from '../../lib/handleInterrupt';
+import {TerminalOutput} from '../../lib/TerminalOutput';
+import {TerminalPassthru} from '../../lib/TeminalPassthru';
+
+/**
+ * Dev Server command - starts the local development server for OCP apps
+ * This is a top-level command (no namespace decorator), so it runs as `ocp dev-server`
+ */
+@namespace('dev-server')
+export class DevServerCommand {
+  @option('p')
+  @help('Port to run the server on')
+  @defaultValue('3000')
+  public port!: string;
+
+  @option('c')
+  @help('Path to custom config file')
+  public config?: string;
+
+  @option
+  @help('Path to the OCP app root directory')
+  public path?: string;
+
+  @flag('v')
+  @help('Enable verbose logging')
+  @defaultValue(false)
+  public verbose!: boolean;
+
+  @flag('no-open')
+  @help('Don\'t automatically open browser')
+  @defaultValue(false)
+  public noOpen!: boolean;
+
+  private PACKAGE_NAME = '@optimizely/ocp-local-env';
+
+  @command
+  @help('Start the local development server for OCP apps')
+  public async start() {
+    handleInterrupt();
+
+    try {
+      // Ensure ocp-local-env is installed and up-to-date
+      await this.ensureOcpLocalEnv();
+
+      // Set environment variables that ocp-local-env expects
+      process.env.OCP_LOCAL_PORT = this.port;
+      if (this.config) {
+        process.env.OCP_LOCAL_CONFIG_PATH = this.config;
+      }
+      process.env.OCP_LOCAL_VERBOSE = this.verbose ? 'true' : 'false';
+      process.env.OCP_LOCAL_OPEN_BROWSER = this.noOpen ? 'false' : 'true';
+      if (this.path) {
+        process.env.APP_ROOT_DIR = this.path;
+      }
+
+      // Import and call startServer from ocp-local-env (installed globally)
+      // Get the global npm modules path and construct the full package path
+      const globalRoot = TerminalOutput.exec('npm root -g').stdout.trim();
+      const packagePath = path.join(globalRoot, this.PACKAGE_NAME);
+
+      // @ts-ignore - Package is installed globally, not in node_modules
+      const {startServer} = await import(packagePath);
+
+      console.log(chalk.gray('Starting OCP local development server...'));
+      await startServer();
+    } catch (e: any) {
+      die(formatError(e));
+    }
+  }
+
+  /**
+   * Ensure @optimizely/ocp-local-env is installed globally and up-to-date.
+   * Checks once per day and auto-installs or auto-upgrades as needed.
+   */
+  private async ensureOcpLocalEnv(): Promise<void> {
+    // Ensure ~/.ocp directory exists
+    const ocpDir = path.join(os.homedir(), '.ocp');
+    if (!fs.existsSync(ocpDir)) {
+      fs.mkdirSync(ocpDir, {recursive: true});
+    }
+
+    const checkFile = path.join(os.homedir(), '.ocp', 'last-ocp-local-env-check');
+    // Check if we should skip (< 24 hours since last check)
+    if (fs.existsSync(checkFile)) {
+      const stats = fs.statSync(checkFile);
+      const hoursSinceCheck = (Date.now() - stats.mtimeMs) / (1000 * 60 * 60);
+      if (hoursSinceCheck < 24) {
+        return; // Skip check
+      }
+    }
+
+    // Check if installed globally
+    const installedVersion = this.getInstalledVersion();
+
+    if (!installedVersion) {
+      // Not installed - auto-install
+      console.log(chalk.gray('Installing @optimizely/ocp-local-env globally...'));
+      this.installGlobalPackage(false);
+      fs.writeFileSync(checkFile, '');
+      return;
+    }
+
+    // Check for updates
+    const latestVersion = await this.getLatestVersion();
+    if (latestVersion && semver.gt(latestVersion, installedVersion)) {
+      // Newer version available - auto-upgrade
+      console.log(chalk.gray(`Upgrading @optimizely/ocp-local-env (${installedVersion} → ${latestVersion})...`));
+      this.installGlobalPackage(true);
+    }
+
+    // Touch check file
+    fs.writeFileSync(checkFile, '');
+  }
+
+  /**
+   * Check if a package is installed globally and return its version.
+   * @returns The installed version or null if not installed
+   */
+  private getInstalledVersion(): string | null {
+    try {
+      const result = TerminalOutput.exec(`npm list -g --depth=0 --json ${this.PACKAGE_NAME}`);
+      if (result.status === 0) {
+        const data = JSON.parse(result.stdout);
+        return data.dependencies?.[this.PACKAGE_NAME]?.version || null;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Get the latest version of a package from npm registry.
+   * @returns The latest version or null if unavailable
+   */
+  private async getLatestVersion(): Promise<string | null> {
+    try {
+      const result = TerminalOutput.exec(`npm view ${this.PACKAGE_NAME} version`);
+      if (result.status === 0) {
+        return result.stdout.trim() || null;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * Install or update a global npm package.
+   * @param isUpgrade Whether this is an upgrade (affects success message)
+   * @returns True if successful, false otherwise
+   */
+  private installGlobalPackage(isUpgrade: boolean): boolean {
+    const spec = isUpgrade ? `${this.PACKAGE_NAME}@latest` : this.PACKAGE_NAME;
+    const result = TerminalPassthru.exec(`npm install -g ${spec}`);
+
+    if (result.status === 0) {
+      if (isUpgrade) {
+        // Get the newly installed version for the success message
+        const newVersion = this.getInstalledVersion();
+        console.log(chalk.green(`✓ Updated to version ${newVersion}`));
+      } else {
+        console.log(chalk.green('✓ Installed @optimizely/ocp-local-env'));
+      }
+      return true;
+    } else {
+      console.log(chalk.red('Installation failed. Please install manually with:'));
+      console.log(chalk.red(`  npm install -g ${this.PACKAGE_NAME}`));
+      return false;
+    }
+  }
+}

package/src/lib/AppPackager.ts

@@ -16,7 +16,7 @@ export class AppPackager {
 
     const files = await globby(['**/*'], {
       gitignore: true, // respects .gitignore
-      ignore: ['node_modules/**/*', '*.zip', '.git/**/*'],
+      ignore: ['node_modules/**/*', '*.zip', '.git/**/*', '.ocp-local/**/*'],
       cwd: this.rootPath,
       dot: true,
       onlyFiles: true,