chore: wip

chrisbbreuer · chrisbbreuer · commit e37525d0a87c · 2025-08-08T22:24:00.000-07:00
diff --git a/docs/config.md b/docs/config.md
@@ -472,6 +472,77 @@ const config: LaunchpadConfig = {
 export default config
 ```
 
+### Lifecycle Hooks (preSetup, preActivation, postActivation)
+
+In addition to `postSetup`, Launchpad provides three more lifecycle hooks for fine-grained control:
+
+- preSetup: runs before any installation/services start
+- preActivation: runs after installs/services, just before activation
+- postActivation: runs immediately after activation completes
+
+You can configure them in `launchpad.config.ts` or inline in your dependency file (e.g., `deps.yaml`).
+
+Config file example:
+
+```ts
+// launchpad.config.ts
+import type { LaunchpadConfig } from '@stacksjs/launchpad'
+
+const config: LaunchpadConfig = {
+  preSetup: {
+    enabled: true,
+    commands: [
+      { command: "bash -lc 'echo preSetup'" },
+    ],
+  },
+  preActivation: {
+    enabled: true,
+    commands: [
+      { command: "bash -lc 'echo preActivation'" },
+    ],
+  },
+  postActivation: {
+    enabled: true,
+    commands: [
+      { command: "bash -lc 'echo postActivation'" },
+    ],
+  },
+}
+
+export default config
+```
+
+Dependency file example (inline hooks):
+
+```yaml
+# deps.yaml
+preSetup:
+  enabled: true
+  commands:
+    - { command: "bash -lc 'echo preSetup'" }
+
+postSetup:
+  enabled: true
+  commands:
+    - { command: "bash -lc 'echo postSetup'" }
+
+preActivation:
+  enabled: true
+  commands:
+    - { command: "bash -lc 'echo preActivation'" }
+
+postActivation:
+  enabled: true
+  commands:
+    - { command: "bash -lc 'echo postActivation'" }
+```
+
+Notes:
+- Inline hooks in `deps.yaml` run alongside config hooks of the same phase.
+- preSetup runs before dependency installation and service auto-start.
+- preActivation runs after installation/services and before printing the activation message.
+- postActivation runs after the final activation message.
+
 ## Environment Variables
 
 You can also configure Launchpad using environment variables:
diff --git a/docs/usage.md b/docs/usage.md
@@ -205,6 +205,15 @@ cd ../          # → Automatically deactivates
 # dev environment deactivated
 ```
 
+Hook lifecycle during activation:
+
+- preSetup (before installs/services)
+- postSetup (after environment is prepared)
+- preActivation (after installs/services, before activation message)
+- postActivation (immediately after activation message)
+
+Define hooks in `launchpad.config.ts` or inline in `deps.yaml` (see Configuration → Lifecycle Hooks).
+
 ::: tip Prompt Compatibility
 If you use **Starship prompt** and see timeout warnings like `[WARN] - (starship::utils): Executing command timed out`, add `command_timeout = 5000` to the top of your `~/.config/starship.toml` file. This gives Starship enough time to detect tool versions from Launchpad-managed binaries. See [Troubleshooting](./troubleshooting.md#starship-prompt-timeout-warnings) for details.
 :::
diff --git a/packages/launchpad/src/config.ts b/packages/launchpad/src/config.ts
@@ -54,6 +54,18 @@ export const defaultConfig: LaunchpadConfig = {
     enabled: process.env.LAUNCHPAD_POST_SETUP_ENABLED !== 'false',
     commands: [],
   },
+  preSetup: {
+    enabled: process.env.LAUNCHPAD_PRE_SETUP_ENABLED !== 'false',
+    commands: [],
+  },
+  preActivation: {
+    enabled: process.env.LAUNCHPAD_PRE_ACTIVATION_ENABLED !== 'false',
+    commands: [],
+  },
+  postActivation: {
+    enabled: process.env.LAUNCHPAD_POST_ACTIVATION_ENABLED !== 'false',
+    commands: [],
+  },
   services: {
     enabled: process.env.LAUNCHPAD_SERVICES_ENABLED !== 'false',
     dataDir: process.env.LAUNCHPAD_SERVICES_DATA_DIR || path.join(homedir(), '.local', 'share', 'launchpad', 'services'),
diff --git a/packages/launchpad/src/dev/dump.ts b/packages/launchpad/src/dev/dump.ts
@@ -29,6 +29,49 @@ export interface DumpOptions {
   skipGlobal?: boolean // Skip global package processing for testing
 }
 
+function extractHookCommandsFromDepsYaml(filePath: string, hookName: 'preSetup' | 'postSetup' | 'preActivation' | 'postActivation'): PostSetupCommand[] {
+  try {
+    const content = fs.readFileSync(filePath, 'utf8')
+    const lines = content.split(/\r?\n/)
+    const cmds: PostSetupCommand[] = []
+    let inHook = false
+    let inCommands = false
+    let baseIndent = 0
+    for (let i = 0; i < lines.length; i++) {
+      const raw = lines[i]
+      const indent = raw.length - raw.trimStart().length
+      const line = raw.trim()
+      if (!inHook) {
+        if (line.startsWith(`${hookName}:`)) {
+          inHook = true
+          baseIndent = indent
+        }
+        continue
+      }
+      if (indent <= baseIndent && line.endsWith(':')) {
+        break
+      }
+      if (!inCommands && line.startsWith('commands:')) {
+        inCommands = true
+        continue
+      }
+      if (inCommands) {
+        const m1 = line.match(/command:\s*"([^"]+)"/)
+        const m2 = line.match(/command:\s*'([^']+)'/)
+        if (m1 || m2) {
+          const cmd = (m1?.[1] || m2?.[1]) as string
+          if (cmd && cmd.length > 0)
+            cmds.push({ command: cmd })
+        }
+      }
+    }
+    return cmds
+  }
+  catch {
+    return []
+  }
+}
+
 /**
  * Check if packages are installed in the given environment directory
  */
@@ -199,6 +242,13 @@ export async function detectLaravelProject(dir: string): Promise<{ isLaravel: bo
     // Ignore errors checking migrations
   }
 
+  // Execute project-level post-setup commands if enabled (skip in shell integration fast path)
+  const projectPreSetup = config.preSetup
+  if (projectPreSetup?.enabled && process.env.LAUNCHPAD_SHELL_INTEGRATION !== '1') {
+    const preSetupResults = await executepostSetup(dir, projectPreSetup.commands || [])
+    suggestions.push(...preSetupResults)
+  }
+
   // Execute project-level post-setup commands if enabled (skip in shell integration fast path)
   const projectPostSetup = config.postSetup
   if (projectPostSetup?.enabled && process.env.LAUNCHPAD_SHELL_INTEGRATION !== '1') {
@@ -589,6 +639,20 @@ export async function dump(dir: string, options: DumpOptions = {}): Promise<void
   try {
     // Find dependency file using our comprehensive detection
     const dependencyFile = findDependencyFile(dir)
+    // Early pre-setup hook (before any installs/services) when config present in working dir
+    try {
+      if (dependencyFile) {
+        const fileCmds = extractHookCommandsFromDepsYaml(dependencyFile, 'preSetup')
+        if (fileCmds.length > 0) {
+          await executepostSetup(path.dirname(dependencyFile), fileCmds)
+        }
+      }
+      const projectPreSetup = config.preSetup
+      if (projectPreSetup?.enabled && !shellOutput && !quiet && dependencyFile) {
+        await executepostSetup(path.dirname(dependencyFile), projectPreSetup.commands || [])
+      }
+    }
+    catch {}
 
     if (!dependencyFile) {
       if (!quiet && !shellOutput) {
@@ -840,11 +904,30 @@ export async function dump(dir: string, options: DumpOptions = {}): Promise<void
     if (localPackages.length > 0 || globalPackages.length > 0) {
       await installPackagesOptimized(localPackages, globalPackages, envDir, globalEnvDir, dryrun, quiet)
       // Visual separator after dependency install list
-      try { console.log() }
+      try {
+        console.log()
+      }
       catch {}
     }
 
     // Auto-start services for any project that has services configuration
+    // Pre-activation hook (runs after install/services and before shell activation)
+    const preActivation = config.preActivation
+    if (dependencyFile) {
+      const filePostSetup = extractHookCommandsFromDepsYaml(dependencyFile, 'postSetup')
+      if (filePostSetup.length > 0) {
+        await executepostSetup(projectDir, filePostSetup)
+      }
+    }
+    if (preActivation?.enabled && !isShellIntegration) {
+      await executepostSetup(projectDir, preActivation.commands || [])
+    }
+    if (dependencyFile) {
+      const filePreActivation = extractHookCommandsFromDepsYaml(dependencyFile, 'preActivation')
+      if (filePreActivation.length > 0) {
+        await executepostSetup(projectDir, filePreActivation)
+      }
+    }
     // Suppress interstitial processing messages during service startup phase
     const prevProcessing = process.env.LAUNCHPAD_PROCESSING
     process.env.LAUNCHPAD_PROCESSING = '0'
@@ -858,6 +941,13 @@ export async function dump(dir: string, options: DumpOptions = {}): Promise<void
     await ensureProjectPhpIni(projectDir, envDir)
     await maybeRunLaravelPostSetup(projectDir, envDir, isShellIntegration)
 
+    // Mark environment as ready for fast shell activation on subsequent prompts
+    try {
+      await fs.promises.mkdir(path.join(envDir), { recursive: true })
+      await fs.promises.writeFile(path.join(envDir, '.launchpad_ready'), '1')
+    }
+    catch {}
+
     // Check for Laravel project and provide helpful suggestions
     const laravelInfo = await detectLaravelProject(projectDir)
     if (laravelInfo.isLaravel) {
@@ -885,6 +975,18 @@ export async function dump(dir: string, options: DumpOptions = {}): Promise<void
       const activation = (config.shellActivationMessage || '✅ Environment activated for {path}')
         .replace('{path}', process.cwd())
       console.log(activation)
+
+      // Post-activation hook (file-level then config)
+      if (dependencyFile) {
+        const filePostActivation = extractHookCommandsFromDepsYaml(dependencyFile, 'postActivation')
+        if (filePostActivation.length > 0) {
+          await executepostSetup(projectDir, filePostActivation)
+        }
+      }
+      const postActivation = config.postActivation
+      if (postActivation?.enabled) {
+        await executepostSetup(projectDir, postActivation.commands || [])
+      }
     }
   }
   catch (error) {
diff --git a/packages/launchpad/src/dev/shellcode.ts b/packages/launchpad/src/dev/shellcode.ts
@@ -91,6 +91,23 @@ export function shellcode(testMode: boolean = false): string {
 
   return `
 # Launchpad shell integration - Performance Optimized
+# Ultra-fast init guard: avoid any heavy work during initial shell startup
+if [[ -z "$__LAUNCHPAD_INIT_DONE" ]]; then
+    export __LAUNCHPAD_INIT_DONE=1
+    # Preload minimal global paths only; defer scans to first cd
+    if [[ -d "$HOME/.local/share/launchpad/global/bin" ]]; then
+        case ":$PATH:" in
+            *":$HOME/.local/share/launchpad/global/bin:"*) ;;
+            *) export PATH="$HOME/.local/share/launchpad/global/bin:$PATH" ;;
+        esac
+    fi
+    if [[ -d "$HOME/.local/share/launchpad/global/sbin" ]]; then
+        case ":$PATH:" in
+            *":$HOME/.local/share/launchpad/global/sbin:"*) ;;
+            *) export PATH="$HOME/.local/share/launchpad/global/sbin:$PATH" ;;
+        esac
+    fi
+fi
 # Exit early if shell integration is disabled or in test mode
 if [[ "$LAUNCHPAD_DISABLE_SHELL_INTEGRATION" == "1"${testModeCheck} ]]; then
     return 0 2>/dev/null || exit 0
@@ -726,14 +743,8 @@ __launchpad_chpwd() {
                     eval "$env_output" 2>/dev/null || true
                 fi
 
-                # After activation, attempt to run Laravel post-setup if configured
-                if command -v launchpad >/dev/null 2>&1; then
-                    # Best-effort: run migrate if configured and php works
-                    if command -v php >/dev/null 2>&1; then
-                        # Trigger a lightweight Laravel detect to run post-setup via CLI (quiet)
-                        LAUNCHPAD_SHOW_ENV_MESSAGES=false launchpad dev "$project_dir" --quiet >/dev/null 2>&1 || true
-                    fi
-                fi
+                # Defer post-setup quietly without background job output; precmd hook will refresh
+                touch "$HOME/.cache/launchpad/shell_cache/global_refresh_needed" 2>/dev/null || true
 
                 # Ensure global dependencies are still in PATH after project setup
                 __launchpad_ensure_global_path
@@ -907,7 +918,7 @@ __launchpad_source_hooks_dir() {
 
 # One-time setup on shell initialization
 __launchpad_setup_global_deps
-__launchpad_ensure_global_path
+__launchpad_ensure_global_path_fast
 __launchpad_source_hooks_dir "$HOME/.config/launchpad/hooks/init.d"
 
 # Clear command hash table on initial load
diff --git a/packages/launchpad/src/logging.ts b/packages/launchpad/src/logging.ts
@@ -1,7 +1,6 @@
 /* eslint-disable no-console */
 import fs from 'node:fs'
 import process from 'node:process'
-import { config } from './config'
 
 // Global message deduplication for shell mode
 const shellModeMessageCache = new Set<string>()
diff --git a/packages/launchpad/src/types.ts b/packages/launchpad/src/types.ts
@@ -69,6 +69,21 @@ export interface LaunchpadConfig {
     enabled?: boolean
     commands?: PostSetupCommand[]
   }
+  /** Project-level pre-setup commands (run before any installation/services) */
+  preSetup?: {
+    enabled?: boolean
+    commands?: PostSetupCommand[]
+  }
+  /** Commands to run just before activation (after install/services) */
+  preActivation?: {
+    enabled?: boolean
+    commands?: PostSetupCommand[]
+  }
+  /** Commands to run right after activation completes */
+  postActivation?: {
+    enabled?: boolean
+    commands?: PostSetupCommand[]
+  }
   services?: {
     enabled?: boolean
     autoStart?: boolean
diff --git a/packages/launchpad/test/dev-hooks.test.ts b/packages/launchpad/test/dev-hooks.test.ts
diff --git a/packages/launchpad/test/tmp-hooks/deps.yaml b/packages/launchpad/test/tmp-hooks/deps.yaml
