@launch77/cli 1.2.0

package/dist/templates/templates/workspace/turbo.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "globalDependencies": ["**/.env.*local"],
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**", "src/**"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "lint": {
+      "outputs": []
+    },
+    "typecheck": {
+      "outputs": [],
+      "dependsOn": ["^build"]
+    },
+    "test": {
+      "outputs": [],
+      "dependsOn": ["build"]
+    }
+  }
+}

package/dist/templates/workspace/.launch77/workspace.json

@@ -0,0 +1,3 @@
+{
+  "version": "1.0.0"
+}

package/dist/templates/workspace/README.md

@@ -0,0 +1,62 @@
+# Launch77 Workspace
+
+Welcome to your Launch77 workspace! This is a standalone monorepo for building applications with the Launch77 platform.
+
+## Getting Started
+
+### 1. Install Dependencies
+
+```bash
+npm install
+```
+
+### 2. Create Your First App
+
+Use the Launch77 CLI to create apps:
+
+```bash
+# Create a web application
+launch77 app:create webapp my-app
+
+# Create an API
+launch77 app:create api my-api
+
+# Create a marketing site
+launch77 app:create marketing-site my-marketing
+```
+
+## Workspace Structure
+
+```
+.
+├── apps/              # Your applications live here
+├── app-templates/     # Custom app templates (future)
+├── libraries/         # Shared libraries (future)
+├── plugins/          # Custom plugins (future)
+├── package.json      # Workspace configuration
+└── turbo.json        # Turbo build configuration
+```
+
+## Available Commands
+
+```bash
+# Development
+npm run dev          # Start all apps in development mode
+
+# Building
+npm run build        # Build all apps
+
+# Quality Checks
+npm run typecheck    # Type check all apps
+npm run lint         # Lint all apps
+npm run test         # Run tests for all apps
+```
+
+## Learn More
+
+- [Launch77 Documentation](https://launch77.com/docs) (coming soon)
+- [Turborepo Documentation](https://turbo.build/repo/docs)
+
+## Need Help?
+
+Visit [launch77.com](https://launch77.com) for more information.

package/dist/templates/workspace/app-templates/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the app-templates directory is tracked by git

package/dist/templates/workspace/apps/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the apps directory is tracked by git

package/dist/templates/workspace/libraries/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the libraries directory is tracked by git

package/dist/templates/workspace/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "workspace-name",
+  "private": true,
+  "packageManager": "npm@9.0.0",
+  "workspaces": [
+    "apps/*",
+    "libraries/*",
+    "plugins/*",
+    "app-templates/*"
+  ],
+  "scripts": {
+    "dev": "turbo run dev",
+    "build": "turbo run build",
+    "test": "turbo run test",
+    "lint": "turbo run lint",
+    "typecheck": "turbo run typecheck"
+  },
+  "devDependencies": {
+    "turbo": "^2.0.0"
+  }
+}

package/dist/templates/workspace/plugins/.gitkeep

@@ -0,0 +1 @@
+# This file ensures the plugins directory is tracked by git

package/dist/templates/workspace/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "commonjs",
+    "jsx": "preserve",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "baseUrl": "."
+  },
+  "exclude": ["node_modules", "dist", ".next", ".turbo"]
+}

package/dist/templates/workspace/turbo.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://turbo.build/schema.json",
+  "globalDependencies": ["**/.env.*local"],
+  "tasks": {
+    "build": {
+      "dependsOn": ["^build"],
+      "outputs": ["dist/**", ".next/**", "!.next/cache/**", "src/**"]
+    },
+    "dev": {
+      "cache": false,
+      "persistent": true
+    },
+    "lint": {
+      "outputs": []
+    },
+    "typecheck": {
+      "outputs": [],
+      "dependsOn": ["^build"]
+    },
+    "test": {
+      "outputs": [],
+      "dependsOn": ["build"]
+    }
+  }
+}

package/dist/utils/launch77-context.d.ts

@@ -0,0 +1,16 @@
+export type Launch77LocationType = 'workspace-root' | 'workspace-app' | 'unknown';
+export interface Launch77Context {
+    isValid: boolean;
+    locationType: Launch77LocationType;
+    workspaceRoot: string;
+    appsDir: string;
+    workspaceVersion: string;
+    workspaceName: string;
+    appName?: string;
+    packageName: string;
+}
+/**
+ * Detect the Launch77 workspace context from the current working directory
+ */
+export declare function detectLaunch77Context(cwd: string): Promise<Launch77Context>;
+//# sourceMappingURL=launch77-context.d.ts.map

package/dist/utils/launch77-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch77-context.d.ts","sourceRoot":"","sources":["../../src/utils/launch77-context.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,GAAG,eAAe,GAAG,SAAS,CAAA;AAEjF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,oBAAoB,CAAA;IAClC,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AA4ED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAyDjF"}

package/dist/utils/launch77-context.js

@@ -0,0 +1,111 @@
+import * as path from 'path';
+import fs from 'fs-extra';
+const WORKSPACE_MANIFEST = '.launch77/workspace.json';
+/**
+ * Check if a directory contains a Launch77 workspace manifest
+ */
+async function isWorkspaceRoot(dir) {
+    const manifestPath = path.join(dir, WORKSPACE_MANIFEST);
+    return await fs.pathExists(manifestPath);
+}
+/**
+ * Read workspace manifest
+ */
+async function readWorkspaceManifest(workspaceRoot) {
+    const manifestPath = path.join(workspaceRoot, WORKSPACE_MANIFEST);
+    return await fs.readJSON(manifestPath);
+}
+/**
+ * Find the workspace root by traversing up from a starting directory
+ * Looks for .launch77/workspace.json manifest file
+ */
+async function findWorkspaceRoot(startDir) {
+    let currentDir = path.resolve(startDir);
+    const rootDir = path.parse(currentDir).root;
+    while (currentDir !== rootDir) {
+        if (await isWorkspaceRoot(currentDir)) {
+            return currentDir;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+}
+/**
+ * Parse the directory structure to determine location context
+ * Based on patterns:
+ * - apps/[name] → workspace-app
+ * - (empty or root) → workspace-root
+ */
+function parseLocationFromPath(cwdPath, workspaceRoot) {
+    const relativePath = path.relative(workspaceRoot, cwdPath);
+    // At workspace root
+    if (!relativePath || relativePath === '.') {
+        return { locationType: 'workspace-root' };
+    }
+    const parts = relativePath.split(path.sep);
+    // apps/[app-name]/...
+    if (parts[0] === 'apps' && parts.length >= 2) {
+        return {
+            locationType: 'workspace-app',
+            appName: parts[1],
+        };
+    }
+    // Somewhere else in workspace (libraries, plugins, etc.)
+    // Still considered workspace-root for now
+    return { locationType: 'workspace-root' };
+}
+/**
+ * Detect the Launch77 workspace context from the current working directory
+ */
+export async function detectLaunch77Context(cwd) {
+    const resolvedCwd = path.resolve(cwd);
+    // Find the workspace root
+    const workspaceRoot = await findWorkspaceRoot(resolvedCwd);
+    if (!workspaceRoot) {
+        return {
+            isValid: false,
+            locationType: 'unknown',
+            workspaceRoot: '',
+            appsDir: '',
+            workspaceVersion: '',
+            workspaceName: '',
+            packageName: '',
+        };
+    }
+    // Read workspace manifest
+    let manifest;
+    try {
+        manifest = await readWorkspaceManifest(workspaceRoot);
+    }
+    catch (error) {
+        // Manifest exists (we found it) but couldn't read it
+        return {
+            isValid: false,
+            locationType: 'unknown',
+            workspaceRoot: '',
+            appsDir: '',
+            workspaceVersion: '',
+            workspaceName: '',
+            packageName: '',
+        };
+    }
+    // Parse the directory structure to determine location
+    const parsed = parseLocationFromPath(resolvedCwd, workspaceRoot);
+    // Workspace name is the directory name
+    const workspaceName = path.basename(workspaceRoot);
+    // Apps directory is always {workspaceRoot}/apps
+    const appsDir = path.join(workspaceRoot, 'apps');
+    // Package name: @{workspaceName}/{appName} (if in app)
+    const packageName = parsed.appName ? `@${workspaceName}/${parsed.appName}` : '';
+    return {
+        isValid: true,
+        locationType: parsed.locationType,
+        workspaceRoot,
+        appsDir,
+        workspaceVersion: manifest.version,
+        workspaceName,
+        appName: parsed.appName,
+        packageName,
+    };
+}
+//# sourceMappingURL=launch77-context.js.map

package/dist/utils/launch77-context.js.map

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

package/dist/utils/launch77-validation.d.ts

@@ -0,0 +1,17 @@
+import type { Launch77Context } from './launch77-context.js';
+/**
+ * Validation result with helpful error messages
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errorMessage?: string;
+}
+/**
+ * Validate that we're in a workspace context for app:create
+ */
+export declare function validateWorkspaceContext(context: Launch77Context): ValidationResult;
+/**
+ * Validate that we're inside an app directory (for plugin:install - future use)
+ */
+export declare function validateAppContext(context: Launch77Context): ValidationResult;
+//# sourceMappingURL=launch77-validation.d.ts.map

package/dist/utils/launch77-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch77-validation.d.ts","sourceRoot":"","sources":["../../src/utils/launch77-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAgBnF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAwB7E"}

package/dist/utils/launch77-validation.js

@@ -0,0 +1,44 @@
+/**
+ * Validate that we're in a workspace context for app:create
+ */
+export function validateWorkspaceContext(context) {
+    if (!context.isValid) {
+        return {
+            valid: false,
+            errorMessage: 'Must be run from within a Launch77 workspace.\n\n' + 'Create a workspace first:\n' + '  launch77 init my-workspace\n' + '  cd my-workspace',
+        };
+    }
+    if (context.locationType !== 'workspace-root' && context.locationType !== 'workspace-app') {
+        return {
+            valid: false,
+            errorMessage: 'Must be run from workspace root or app directory',
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate that we're inside an app directory (for plugin:install - future use)
+ */
+export function validateAppContext(context) {
+    if (!context.isValid) {
+        return {
+            valid: false,
+            errorMessage: 'Must be run from within a Launch77 workspace app directory',
+        };
+    }
+    // Must be inside an app, not just workspace root
+    if (context.locationType !== 'workspace-app') {
+        return {
+            valid: false,
+            errorMessage: 'plugin:install must be run from within an app directory.\n\n' + 'Navigate to an app:\n' + '  cd apps/<app-name>',
+        };
+    }
+    if (!context.appName) {
+        return {
+            valid: false,
+            errorMessage: 'Could not determine app name from current directory.\nThis is a bug. Please report it.',
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=launch77-validation.js.map

package/dist/utils/launch77-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch77-validation.js","sourceRoot":"","sources":["../../src/utils/launch77-validation.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,OAAwB;IAC/D,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,mDAAmD,GAAG,6BAA6B,GAAG,gCAAgC,GAAG,mBAAmB;SAC3J,CAAA;IACH,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,KAAK,gBAAgB,IAAI,OAAO,CAAC,YAAY,KAAK,eAAe,EAAE,CAAC;QAC1F,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,kDAAkD;SACjE,CAAA;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAwB;IACzD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,4DAA4D;SAC3E,CAAA;IACH,CAAC;IAED,iDAAiD;IACjD,IAAI,OAAO,CAAC,YAAY,KAAK,eAAe,EAAE,CAAC;QAC7C,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,8DAA8D,GAAG,uBAAuB,GAAG,sBAAsB;SAChI,CAAA;IACH,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,wFAAwF;SACvG,CAAA;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACxB,CAAC"}

package/dist/utils/monorepo.d.ts

@@ -0,0 +1,19 @@
+export type LocationType = 'monorepo-root' | 'startup-root' | 'startup-app' | 'unknown';
+export interface MonorepoContext {
+    isValid: boolean;
+    location: LocationType;
+    monorepoRoot: string;
+    appsDir: string | null;
+    startupName?: string;
+    appName?: string;
+    packageName?: string;
+}
+/**
+ * Detect the monorepo context from the current working directory
+ *
+ * @deprecated Use detectLaunch77Context() from launch77-context.ts instead.
+ * This function is maintained for legacy monorepo structure only.
+ * New workspaces created with `launch77 init` should use the new context system.
+ */
+export declare function detectMonorepoContext(cwd: string): Promise<MonorepoContext>;
+//# sourceMappingURL=monorepo.d.ts.map

package/dist/utils/monorepo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monorepo.d.ts","sourceRoot":"","sources":["../../src/utils/monorepo.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG,cAAc,GAAG,aAAa,GAAG,SAAS,CAAA;AAEvF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,YAAY,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAuFD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA2BjF"}

package/dist/utils/monorepo.js

@@ -0,0 +1,100 @@
+import * as path from 'path';
+import fs from 'fs-extra';
+const MONOREPO_ROOT_MARKER = '.launch-monorepo-root.md';
+/**
+ * Check if a directory is the monorepo root by looking for the marker file
+ */
+async function isMonorepoRoot(dir) {
+    const markerPath = path.join(dir, MONOREPO_ROOT_MARKER);
+    return await fs.pathExists(markerPath);
+}
+/**
+ * Find the monorepo root by traversing up from a starting directory
+ * Looks for .launch-monorepo-root.md marker file
+ */
+async function findMonorepoRoot(startDir) {
+    let currentDir = path.resolve(startDir);
+    const rootDir = path.parse(currentDir).root;
+    while (currentDir !== rootDir) {
+        if (await isMonorepoRoot(currentDir)) {
+            return currentDir;
+        }
+        currentDir = path.dirname(currentDir);
+    }
+    return null;
+}
+/**
+ * Parse the directory structure to determine location context
+ * Based on patterns:
+ * - startups/[name] → startup-root
+ * - startups/[name]/apps/[app] → startup-app
+ * - (empty or root) → monorepo-root
+ */
+function parseLocationFromPath(cwdPath, monorepoRoot) {
+    const relativePath = path.relative(monorepoRoot, cwdPath);
+    // At monorepo root
+    if (!relativePath || relativePath === '.') {
+        return { location: 'monorepo-root' };
+    }
+    const parts = relativePath.split(path.sep);
+    // startups/[name]/...
+    if (parts[0] === 'startups' && parts.length >= 2) {
+        const startupName = parts[1];
+        // startups/[name]/apps/[app]
+        if (parts.length >= 4 && parts[2] === 'apps') {
+            return {
+                location: 'startup-app',
+                startupName,
+                appName: parts[3],
+            };
+        }
+        // startups/[name]
+        return {
+            location: 'startup-root',
+            startupName,
+        };
+    }
+    return { location: 'unknown' };
+}
+/**
+ * Determine the apps directory based on location context
+ * Returns null for invalid locations (e.g., monorepo-root, unknown)
+ */
+function getAppsDir(monorepoRoot, location, startupName) {
+    if (location === 'startup-root' || location === 'startup-app') {
+        return path.join(monorepoRoot, 'startups', startupName, 'apps');
+    }
+    return null;
+}
+/**
+ * Detect the monorepo context from the current working directory
+ *
+ * @deprecated Use detectLaunch77Context() from launch77-context.ts instead.
+ * This function is maintained for legacy monorepo structure only.
+ * New workspaces created with `launch77 init` should use the new context system.
+ */
+export async function detectMonorepoContext(cwd) {
+    const resolvedCwd = path.resolve(cwd);
+    // Find the monorepo root
+    const monorepoRoot = await findMonorepoRoot(resolvedCwd);
+    if (!monorepoRoot) {
+        return {
+            isValid: false,
+            location: 'unknown',
+            monorepoRoot: '',
+            appsDir: null,
+        };
+    }
+    // Parse the directory structure to determine location
+    const parsed = parseLocationFromPath(resolvedCwd, monorepoRoot);
+    const appsDir = getAppsDir(monorepoRoot, parsed.location, parsed.startupName);
+    return {
+        isValid: true,
+        location: parsed.location,
+        monorepoRoot,
+        appsDir,
+        startupName: parsed.startupName,
+        appName: parsed.appName,
+    };
+}
+//# sourceMappingURL=monorepo.js.map

package/dist/utils/monorepo.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,32 @@
+import type { MonorepoContext } from './monorepo.js';
+/**
+ * Validation result with helpful error messages
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errorMessage?: string;
+}
+/**
+ * Validate that we're in a startup context (for create-app)
+ */
+export declare function validateStartupContext(context: MonorepoContext): ValidationResult;
+/**
+ * Validate that we're inside an app directory (for plugin:install)
+ */
+export declare function validateAppContext(context: MonorepoContext): ValidationResult;
+/**
+ * Get the app directory path
+ * Returns null if not in an app context
+ */
+export declare function getAppDirectory(context: MonorepoContext): string | null;
+/**
+ * Validate app name format
+ *
+ * App names must follow Launch77 naming conventions:
+ * - Must be lowercase
+ * - Must start with a letter [a-z]
+ * - Can only contain lowercase letters, numbers, and hyphens
+ * - Cannot contain spaces, uppercase, underscores, periods, or special characters
+ */
+export declare function validateAppName(appName: string): ValidationResult;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAuBjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAwB7E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAUvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAoBjE"}

package/dist/utils/validation.js

@@ -0,0 +1,92 @@
+import * as path from 'path';
+import chalk from 'chalk';
+/**
+ * Validate that we're in a startup context (for create-app)
+ */
+export function validateStartupContext(context) {
+    if (!context.isValid) {
+        return {
+            valid: false,
+            errorMessage: 'Must be run from within a Launch77 monorepo (could not find .launch-monorepo-root.md)',
+        };
+    }
+    if (context.location !== 'startup-root' && context.location !== 'startup-app') {
+        return {
+            valid: false,
+            errorMessage: `Command must be run from a startup directory.\n\n` + `${chalk.gray('Current location:')} ${context.location}\n` + `${chalk.gray('Expected:')} Within startups/<startup-name>/\n\n` + `${chalk.yellow('Navigate to a startup first:')}\n` + `  cd startups/<startup-name>/\n\n` + `${chalk.yellow('Or create a startup:')}\n` + `  launch77 create-startup <startup-name>`,
+        };
+    }
+    if (!context.appsDir) {
+        return {
+            valid: false,
+            errorMessage: `Could not determine apps directory for location: ${context.location}\n` + `This is a bug. Please report it.`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate that we're inside an app directory (for plugin:install)
+ */
+export function validateAppContext(context) {
+    if (!context.isValid) {
+        return {
+            valid: false,
+            errorMessage: 'Must be run from within a Launch77 monorepo (could not find .launch-monorepo-root.md)',
+        };
+    }
+    // Must be inside an app, not just a startup
+    if (context.location !== 'startup-app') {
+        return {
+            valid: false,
+            errorMessage: `plugin:install must be run from within an app directory.\n\n` + `${chalk.gray('Current location:')} ${context.location}\n` + `${chalk.gray('Expected:')} startups/<startup-name>/apps/<app-name>/\n\n` + `${chalk.yellow('Navigate to an app directory:')}\n` + `  cd startups/<startup-name>/apps/<app-name>/\n\n` + `${chalk.yellow('Or create an app first:')}\n` + `  cd startups/<startup-name>/\n` + `  launch77 app:create api <app-name>`,
+        };
+    }
+    if (!context.appName) {
+        return {
+            valid: false,
+            errorMessage: `Could not determine app name from current directory.\n` + `This is a bug. Please report it.`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Get the app directory path
+ * Returns null if not in an app context
+ */
+export function getAppDirectory(context) {
+    if (context.location !== 'startup-app') {
+        return null;
+    }
+    if (!context.monorepoRoot || !context.startupName || !context.appName) {
+        return null;
+    }
+    return path.join(context.monorepoRoot, 'startups', context.startupName, 'apps', context.appName);
+}
+/**
+ * Validate app name format
+ *
+ * App names must follow Launch77 naming conventions:
+ * - Must be lowercase
+ * - Must start with a letter [a-z]
+ * - Can only contain lowercase letters, numbers, and hyphens
+ * - Cannot contain spaces, uppercase, underscores, periods, or special characters
+ */
+export function validateAppName(appName) {
+    // Check for empty name
+    if (!appName || appName.trim().length === 0) {
+        return {
+            valid: false,
+            errorMessage: 'App name cannot be empty',
+        };
+    }
+    // Launch77 naming convention: lowercase, letters, numbers, hyphens only
+    const validPattern = /^[a-z][a-z0-9-]*$/;
+    if (!validPattern.test(appName)) {
+        return {
+            valid: false,
+            errorMessage: `Invalid app name: "${appName}"\n\n` + `${chalk.gray('App names must:')}\n` + `  • Be lowercase only\n` + `  • Start with a letter\n` + `  • Can only contain: lowercase letters, numbers, and hyphens\n` + `  • Cannot contain: spaces, uppercase, underscores, periods, or special characters\n\n` + `${chalk.yellow('Valid examples:')}\n` + `  ✓ my-app\n` + `  ✓ myapp\n` + `  ✓ myapp123\n` + `  ✓ app-123\n\n` + `${chalk.red('Invalid examples:')}\n` + `  ✗ MyApp (uppercase)\n` + `  ✗ my_app (underscores)\n` + `  ✗ my.app (periods)\n` + `  ✗ my app (spaces)\n` + `  ✗ @myapp (special characters)\n` + `  ✗ -myapp (starts with hyphen)\n` + `  ✗ 123app (starts with number)`,
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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