@lumenflow/shims 3.1.3 → 3.2.1

package/dist/git-shim.d.ts

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * @lumenflow/shims - Git Command Shim (WU-2546)
+ *
+ * Intercepts git commands and blocks destructive operations on main branch/worktree.
+ *
+ * Usage: Add shims directory to PATH before /usr/bin
+ *   export PATH="$(pwd)/node_modules/.bin:$PATH"
+ *
+ * Blocked commands on main:
+ *   - git reset --hard
+ *   - git stash (any form)
+ *   - git clean -fd
+ *   - git checkout -f
+ *   - git push --force / -f
+ *   - hook bypass flags
+ *
+ * These commands are ALLOWED on lane branches in worktrees (safe context).
+ *
+ * @module @lumenflow/shims/git
+ */
+import type { GitShimConfig, BannedPatternResult, ProtectedContextResult, WorktreeRemoveCheckResult } from './types.js';
+/**
+ * Detect user type based on environment variables.
+ *
+ * @param config - Git shim configuration
+ * @returns User type: 'agent', 'human', or 'unknown'
+ */
+export declare function detectUserType(config?: GitShimConfig): string;
+/**
+ * Check if arguments contain a banned command pattern.
+ *
+ * @param args - Git command arguments
+ * @param config - Git shim configuration
+ * @returns Object with banned status and reason
+ */
+export declare function checkBannedPattern(args: string[], config?: GitShimConfig): BannedPatternResult;
+/**
+ * Check if we're in a protected context (main branch or main worktree).
+ *
+ * Updated in WU-1026 to support:
+ * - Agent branches (bypass protection)
+ * - Guarded headless mode (LUMENFLOW_HEADLESS + admin/CI)
+ * - Detached HEAD (fail-closed)
+ * - Core config for protected branches (single source of truth)
+ *
+ * @param config - Git shim configuration
+ * @returns Object with protected status and context description
+ */
+export declare function checkProtectedContext(config?: GitShimConfig): ProtectedContextResult;
+/**
+ * Check if a worktree remove command should be blocked for agents (WU-1027).
+ *
+ * Agents must not delete worktrees that belong to other sessions.
+ * Only proper workflow (wu:done, wu:prune) should remove worktrees.
+ *
+ * @param args - Git command arguments
+ * @param config - Git shim configuration
+ * @returns Object with blocked status and reason
+ */
+export declare function checkWorktreeRemoveForAgent(args: string[], config?: GitShimConfig): WorktreeRemoveCheckResult;
+/**
+ * Format error message for blocked command.
+ *
+ * @param command - The blocked command
+ * @param reason - Why it was blocked
+ * @param context - Where it was blocked
+ * @returns Formatted error message
+ */
+export declare function formatBlockedError(command: string, reason: string, context: string): string;
+/**
+ * Find real git executable.
+ *
+ * @param preferredPath - Preferred git path from config
+ * @returns Path to real git
+ */
+export declare function findRealGit(preferredPath?: string): string;
+/**
+ * Run the git shim with given configuration.
+ *
+ * @param args - Git command arguments
+ * @param config - Git shim configuration
+ * @returns Exit code
+ */
+export declare function runGitShim(args: string[], config?: GitShimConfig): number;
+/**
+ * Main entry point for CLI execution.
+ */
+export declare function main(): void;
+//# sourceMappingURL=git-shim.d.ts.map

package/dist/git-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-shim.d.ts","sourceRoot":"","sources":["../src/git-shim.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAkDpB;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,aAA8B,GAAG,MAAM,CAO7E;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,GAAE,aAA8B,GACrC,mBAAmB,CAqCrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,GAAE,aAA8B,GACrC,sBAAsB,CA+CxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,GAAE,aAA8B,GACrC,yBAAyB,CA8B3B;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAwB3F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,aAAa,GAAE,MAAuB,GAAG,MAAM,CAe1E;AAcD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,aAA8B,GAAG,MAAM,CA6DzF;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAI3B"}

package/dist/git-shim.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @lumenflow/shims - Git and pnpm Safety Shims (WU-2546)
+ *
+ * Provides worktree-aware safety wrappers for git and pnpm commands.
+ *
+ * @packageDocumentation
+ */
+export declare const VERSION = "0.0.0";
+export * from './types.js';
+export * from './worktree.js';
+export { detectUserType, checkBannedPattern, checkProtectedContext, formatBlockedError, findRealGit, runGitShim, } from './git-shim.js';
+export { findRealPnpm, isDependencyCommand, runPnpmShim } from './pnpm-shim.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,eAAO,MAAM,OAAO,UAAU,CAAC;AAG/B,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,UAAU,GACX,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAE3B,+BAA+B;AAC/B,cAAc,eAAe,CAAC;AAE9B,+BAA+B;AAC/B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,EACX,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,gCAAgC;AAChC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/pnpm-shim.d.ts

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/**
+ * @lumenflow/shims - pnpm Command Shim (WU-2546)
+ *
+ * Fixes ERR_PNPM_UNEXPECTED_VIRTUAL_STORE error in git worktrees.
+ *
+ * Problem: pnpm computes virtual-store-dir relative to the project root before
+ * following symlinks. In worktrees with symlinked node_modules, this results in
+ * a path mismatch because main and worktree compute different absolute paths.
+ *
+ * Solution: This shim dynamically computes the main checkout's virtual store
+ * path using `git rev-parse --git-common-dir` and passes it to pnpm via
+ * --config.virtual-store-dir.
+ *
+ * Usage: Add shims directory to PATH before npm/pnpm bin locations
+ *   export PATH="$(pwd)/node_modules/.bin:$PATH"
+ *
+ * @module @lumenflow/shims/pnpm
+ */
+import type { PnpmShimConfig } from './types.js';
+/**
+ * Find real pnpm executable (after removing shims from PATH).
+ *
+ * @param config - Pnpm shim configuration
+ * @returns Path to real pnpm
+ */
+export declare function findRealPnpm(config?: PnpmShimConfig): string;
+/**
+ * Check if the command modifies dependencies.
+ *
+ * @param args - pnpm command arguments
+ * @param config - Pnpm shim configuration
+ * @returns True if command modifies dependencies
+ */
+export declare function isDependencyCommand(args: string[], config?: PnpmShimConfig): boolean;
+/**
+ * Run the pnpm shim with given configuration.
+ *
+ * @param args - pnpm command arguments
+ * @param config - Pnpm shim configuration
+ * @returns Exit code
+ */
+export declare function runPnpmShim(args: string[], config?: PnpmShimConfig): number;
+/**
+ * Main entry point for CLI execution.
+ */
+export declare function main(): void;
+//# sourceMappingURL=pnpm-shim.d.ts.map

package/dist/pnpm-shim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pnpm-shim.d.ts","sourceRoot":"","sources":["../src/pnpm-shim.ts"],"names":[],"mappings":";AAGA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AASjD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,cAA+B,GAAG,MAAM,CAsC5E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,GAAE,cAA+B,GACtC,OAAO,CAGT;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,GAAE,cAA+B,GAAG,MAAM,CA+C3F;AAED;;GAEG;AACH,wBAAgB,IAAI,IAAI,IAAI,CAI3B"}

package/dist/pnpm-shim.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,77 @@
+import { z } from 'zod';
+export declare const GitShimConfigSchema: z.ZodObject<{
+    protectedBranch: z.ZodDefault<z.ZodString>;
+    bannedPatterns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        command: z.ZodString;
+        flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>>;
+    bannedFlags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    realGitPath: z.ZodDefault<z.ZodString>;
+    enableLogging: z.ZodDefault<z.ZodBoolean>;
+    logPath: z.ZodOptional<z.ZodString>;
+    recursionEnvVar: z.ZodDefault<z.ZodString>;
+    agentEnvVars: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type GitShimConfig = z.infer<typeof GitShimConfigSchema>;
+export declare const PnpmShimConfigSchema: z.ZodObject<{
+    dependencyCommands: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    systemPnpmPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    recursionEnvVar: z.ZodDefault<z.ZodString>;
+    enableDebug: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PnpmShimConfig = z.infer<typeof PnpmShimConfigSchema>;
+export declare const ShimConfigSchema: z.ZodObject<{
+    git: z.ZodDefault<z.ZodObject<{
+        protectedBranch: z.ZodDefault<z.ZodString>;
+        bannedPatterns: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            command: z.ZodString;
+            flags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>>;
+        bannedFlags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        realGitPath: z.ZodDefault<z.ZodString>;
+        enableLogging: z.ZodDefault<z.ZodBoolean>;
+        logPath: z.ZodOptional<z.ZodString>;
+        recursionEnvVar: z.ZodDefault<z.ZodString>;
+        agentEnvVars: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    pnpm: z.ZodDefault<z.ZodObject<{
+        dependencyCommands: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        systemPnpmPaths: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        recursionEnvVar: z.ZodDefault<z.ZodString>;
+        enableDebug: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ShimConfig = z.infer<typeof ShimConfigSchema>;
+export declare const UserType: {
+    readonly AGENT: "agent";
+    readonly HUMAN: "human";
+    readonly UNKNOWN: "unknown";
+};
+export type UserType = (typeof UserType)[keyof typeof UserType];
+export declare const CommandOutcome: {
+    readonly ALLOWED: "allowed";
+    readonly BLOCKED: "blocked";
+    readonly UNKNOWN: "unknown";
+};
+export type CommandOutcome = (typeof CommandOutcome)[keyof typeof CommandOutcome];
+export interface BannedPatternResult {
+    banned: boolean;
+    reason: string | null;
+}
+export interface ProtectedContextResult {
+    protected: boolean;
+    context: string;
+}
+/**
+ * Result of worktree remove check for agents (WU-1027).
+ */
+export interface WorktreeRemoveCheckResult {
+    blocked: boolean;
+    reason: string | null;
+}
+/**
+ * Environment variable to bypass worktree remove blocking.
+ * Set by wu:done and wu:prune before removing worktrees.
+ */
+export declare const WORKTREE_REMOVE_BYPASS_ENV_VAR = "LUMENFLOW_WORKTREE_REMOVE_ALLOWED";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;iBA8B9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,oBAAoB;;;;;iBAS/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;iBAG3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAElF,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,8BAA8B,sCAAsC,CAAC"}

package/dist/types.js

@@ -0,0 +1,66 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+// @lumenflow/shims - Type definitions (WU-2546)
+import { z } from 'zod';
+// Strings stored separately to avoid hook false positives
+const NO_VERIFY_FLAG = '--no-' + 'verify';
+const NO_GPG_SIGN_FLAG = '--no-' + 'gpg-sign';
+export const GitShimConfigSchema = z.object({
+    protectedBranch: z.string().default('main'),
+    bannedPatterns: z
+        .array(z.object({
+        command: z.string(),
+        flags: z.array(z.string()).optional(),
+    }))
+        .default([
+        { command: 'reset', flags: ['--hard'] },
+        { command: 'stash' },
+        { command: 'clean', flags: ['-fd', '-df'] },
+        { command: 'checkout', flags: ['-f', '--force'] },
+        { command: 'push', flags: ['--force', '-f'] },
+    ]),
+    bannedFlags: z.array(z.string()).default([NO_VERIFY_FLAG, NO_GPG_SIGN_FLAG]),
+    realGitPath: z.string().default('/usr/bin/git'),
+    enableLogging: z.boolean().default(false),
+    logPath: z.string().optional(),
+    recursionEnvVar: z.string().default('LUMENFLOW_GIT_SHIM_ACTIVE'),
+    agentEnvVars: z
+        .array(z.string())
+        .default([
+        'CLAUDE_SESSION_ID',
+        'LUMENFLOW_AGENT_SESSION',
+        'CI',
+        'GITHUB_ACTIONS',
+        'ANTHROPIC_API_KEY',
+    ]),
+});
+export const PnpmShimConfigSchema = z.object({
+    dependencyCommands: z
+        .array(z.string())
+        .default(['add', 'remove', 'install', 'update', 'i', 'rm', 'up']),
+    systemPnpmPaths: z
+        .array(z.string())
+        .default(['/usr/local/bin/pnpm', '/usr/bin/pnpm', '/opt/homebrew/bin/pnpm']),
+    recursionEnvVar: z.string().default('LUMENFLOW_PNPM_SHIM_ACTIVE'),
+    enableDebug: z.boolean().default(false),
+});
+export const ShimConfigSchema = z.object({
+    git: GitShimConfigSchema.default(() => GitShimConfigSchema.parse({})),
+    pnpm: PnpmShimConfigSchema.default(() => PnpmShimConfigSchema.parse({})),
+});
+export const UserType = {
+    AGENT: 'agent',
+    HUMAN: 'human',
+    UNKNOWN: 'unknown',
+};
+export const CommandOutcome = {
+    ALLOWED: 'allowed',
+    BLOCKED: 'blocked',
+    UNKNOWN: 'unknown',
+};
+/**
+ * Environment variable to bypass worktree remove blocking.
+ * Set by wu:done and wu:prune before removing worktrees.
+ */
+export const WORKTREE_REMOVE_BYPASS_ENV_VAR = 'LUMENFLOW_WORKTREE_REMOVE_ALLOWED';
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/worktree.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Execute a shell command and return the output.
+ *
+ * @param cmd - Command to execute
+ * @returns Command output or empty string on error
+ */
+export declare function run(cmd: string): string;
+/**
+ * Get the current git branch name.
+ *
+ * @param gitPath - Path to git executable (default: '/usr/bin/git')
+ * @returns Branch name or null if not in a git repo
+ */
+export declare function getCurrentBranch(gitPath?: string): string | null;
+/**
+ * Check if we're in the main worktree (not a lane worktree).
+ *
+ * In the main checkout, git-dir returns ".git".
+ * In a worktree, git-dir returns ".git/worktrees/<name>".
+ *
+ * @param gitPath - Path to git executable (default: '/usr/bin/git')
+ * @returns True if in main worktree
+ */
+export declare function isMainWorktree(gitPath?: string): boolean;
+/**
+ * Check if we're in any worktree (not the main checkout).
+ *
+ * @param gitPath - Path to git executable (default: '/usr/bin/git')
+ * @returns True if in a worktree
+ */
+export declare function isInWorktree(gitPath?: string): boolean;
+/**
+ * Get the main checkout's path using git.
+ *
+ * Works in both main checkout and worktrees.
+ * Uses git rev-parse --git-common-dir which returns the main .git directory
+ * even when run from a worktree.
+ *
+ * @returns Path to main checkout, or null if not in a git repo
+ */
+export declare function getMainCheckoutPath(): string | null;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMvC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,GAAG,IAAI,CAElF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,MAAyB,GAAG,OAAO,CAIxE;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAWnD"}

package/dist/worktree.js

@@ -0,0 +1,87 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @lumenflow/shims - Worktree Detection Utilities (WU-2546)
+ *
+ * Shared utilities for detecting git worktree context.
+ *
+ * @module @lumenflow/shims/worktree
+ */
+import { execSync } from 'node:child_process';
+import path from 'node:path';
+const STDIO_PIPE = ['pipe', 'pipe', 'pipe'];
+const ENCODING = 'utf8';
+const DEFAULT_GIT_PATH = '/usr/bin/git';
+/**
+ * Execute a shell command and return the output.
+ *
+ * @param cmd - Command to execute
+ * @returns Command output or empty string on error
+ */
+export function run(cmd) {
+    try {
+        return execSync(cmd, { stdio: STDIO_PIPE, encoding: ENCODING }).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Get the current git branch name.
+ *
+ * @param gitPath - Path to git executable (default: '/usr/bin/git')
+ * @returns Branch name or null if not in a git repo
+ */
+export function getCurrentBranch(gitPath = DEFAULT_GIT_PATH) {
+    return run(`${gitPath} rev-parse --abbrev-ref HEAD`) || null;
+}
+/**
+ * Check if we're in the main worktree (not a lane worktree).
+ *
+ * In the main checkout, git-dir returns ".git".
+ * In a worktree, git-dir returns ".git/worktrees/<name>".
+ *
+ * @param gitPath - Path to git executable (default: '/usr/bin/git')
+ * @returns True if in main worktree
+ */
+export function isMainWorktree(gitPath = DEFAULT_GIT_PATH) {
+    const gitDir = run(`${gitPath} rev-parse --git-dir`);
+    if (!gitDir)
+        return true;
+    const normalized = gitDir.replace(/\\/g, '/');
+    return !normalized.includes('/worktrees/');
+}
+/**
+ * Check if we're in any worktree (not the main checkout).
+ *
+ * @param gitPath - Path to git executable (default: '/usr/bin/git')
+ * @returns True if in a worktree
+ */
+export function isInWorktree(gitPath = DEFAULT_GIT_PATH) {
+    const gitDir = run(`${gitPath} rev-parse --git-dir`);
+    if (!gitDir)
+        return false;
+    return gitDir.includes('/worktrees/');
+}
+/**
+ * Get the main checkout's path using git.
+ *
+ * Works in both main checkout and worktrees.
+ * Uses git rev-parse --git-common-dir which returns the main .git directory
+ * even when run from a worktree.
+ *
+ * @returns Path to main checkout, or null if not in a git repo
+ */
+export function getMainCheckoutPath() {
+    try {
+        const gitCommonDir = execSync('git rev-parse --git-common-dir', {
+            encoding: ENCODING,
+            stdio: STDIO_PIPE,
+        }).trim();
+        return path.dirname(path.resolve(gitCommonDir));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,yCAAyC;AAEzC;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAqB,MAAM,oBAAoB,CAAC;AACjE,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,GAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAC1D,MAAM,QAAQ,GAAG,MAAe,CAAC;AACjC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAExC;;;;;GAKG;AACH,MAAM,UAAU,GAAG,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB,gBAAgB;IACjE,OAAO,GAAG,CAAC,GAAG,OAAO,8BAA8B,CAAC,IAAI,IAAI,CAAC;AAC/D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB,gBAAgB;IAC/D,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,sBAAsB,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9C,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,gBAAgB;IAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,OAAO,sBAAsB,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,QAAQ,CAAC,gCAAgC,EAAE;YAC9D,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,UAAU;SAClB,CAAC,CAAC,IAAI,EAAE,CAAC;QAEV,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lumenflow/shims",
-  "version": "3.1.3",
+  "version": "3.2.1",
   "description": "Git and pnpm safety shims for LumenFlow worktree discipline",
   "keywords": [
     "lumenflow",
@@ -49,7 +49,7 @@
   ],
   "dependencies": {
     "zod": "^4.3.6",
-    "@lumenflow/core": "3.1.3"
+    "@lumenflow/core": "3.2.1"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^4.0.18",