@lumenflow/host 5.0.2

package/dist/git/git-context-extractor.js

@@ -0,0 +1,568 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * Git Context Extractor Module (WU-1190)
+ *
+ * Extracts git history insights for LLM context enrichment:
+ * - Co-occurrence: files frequently changed together
+ * - Ownership: primary contributors to file/directory
+ * - Churn: change frequency metrics (hotspots)
+ *
+ * These signals help the LLM understand codebase relationships
+ * without algorithmic clustering - the LLM interprets the patterns.
+ */
+import { execSync } from 'node:child_process';
+import { SHA1_HEX_LENGTH, GIT_COMMAND_TIMEOUT_MS, GIT_MAX_BUFFER_BYTES, GIT_DEFAULT_MAX_COMMITS, GIT_DEFAULT_MAX_RESULTS, GIT_MIN_COMMIT_COUNT, GIT_MIN_CO_OCCURRENCE_COUNT, GIT_MAX_TOP_LEVEL_DIRS, GIT_SUMMARY_ITEM_LIMIT, CHARS_PER_TOKEN, GIT_DEFAULT_MAX_SUMMARY_TOKENS, GIT_TRUNCATION_PADDING, SECTION_HEADER_LINE_COUNT, } from './git-context-constants.js';
+// Constants
+const DEFAULT_EXCLUDE_PATTERNS = ['*.lock', '*.yaml', '*.yml', '*.json', '*.md', 'pnpm-lock.yaml'];
+// Pre-compiled regex patterns for performance
+// Note: Using atomic groups or possessive quantifiers isn't supported in JS,
+// so some patterns are implemented as functions to avoid backtracking
+const NUMSTAT_LINE_REGEX = /^(\d+|-)\t(\d+|-)\t(.+)$/;
+const DANGEROUS_CHARS_REGEX = /[;&|`$]/;
+/**
+ * Parse shortlog line: "   10\tName <email>"
+ * Manual parsing to avoid slow regex backtracking
+ */
+function parseShortlogFormat(line) {
+    // Skip leading whitespace
+    let i = 0;
+    while (i < line.length && (line.charAt(i) === ' ' || line.charAt(i) === '\t')) {
+        i++;
+    }
+    // Parse digits
+    const digitStart = i;
+    while (i < line.length && line.charAt(i) >= '0' && line.charAt(i) <= '9') {
+        i++;
+    }
+    if (i === digitStart)
+        return null; // No digits found
+    const count = parseInt(line.slice(digitStart, i), 10);
+    // Skip whitespace after digits
+    while (i < line.length && (line.charAt(i) === ' ' || line.charAt(i) === '\t')) {
+        i++;
+    }
+    // Rest is the name
+    const name = line.slice(i).trim();
+    if (!name)
+        return null;
+    return { count, name };
+}
+/**
+ * Check if a string is a git commit hash (40 hex chars)
+ * Uses character-by-character check to avoid slow regex backtracking
+ */
+function isCommitHash(str) {
+    if (str.length !== SHA1_HEX_LENGTH)
+        return false;
+    for (const char of str) {
+        if (!((char >= '0' && char <= '9') || (char >= 'a' && char <= 'f'))) {
+            return false;
+        }
+    }
+    return true;
+}
+const SOURCE_FILE_EXCLUDE_PATTERNS = [
+    /\.lock$/,
+    /lock\.ya?ml$/,
+    /package-lock\.json$/,
+    /yarn\.lock$/,
+    /\.gitignore$/,
+    /\.env/,
+    /node_modules/,
+    /dist\//,
+    /build\//,
+    /\.min\./,
+];
+/**
+ * Execute a git command safely, returning empty string on error.
+ *
+ * SECURITY: Commands are constructed from static arguments (no user input) to prevent injection.
+ * The args array is joined into a command string for execSync.
+ * All callers pass only internally-constructed arguments.
+ */
+function safeGitExec(args, cwd) {
+    try {
+        // Join args into a command string
+        // SECURITY: all args are constructed internally (no user input)
+        const cmd = ['git', ...args].join(' ');
+        // SECURITY: execSync is safe here because:
+        // 1. 'git' is a fixed command from PATH (trusted)
+        // 2. args are internally constructed, not from user input
+        // 3. cwd is validated by the caller (projectRoot from CLI)
+        const result = execSync(cmd, {
+            cwd,
+            encoding: 'utf-8',
+            maxBuffer: GIT_MAX_BUFFER_BYTES,
+            timeout: GIT_COMMAND_TIMEOUT_MS,
+        });
+        return result;
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Check if commit count indicates limited history
+ */
+function hasLimitedCommitCount(projectRoot) {
+    const commitCountStr = safeGitExec(['rev-list', '--count', 'HEAD'], projectRoot).trim();
+    const count = parseInt(commitCountStr, 10) || 0;
+    return { limited: count < GIT_MIN_COMMIT_COUNT, count };
+}
+/**
+ * Extract complete git context from a repository
+ */
+export function extractGitContext(projectRoot, options = {}) {
+    const result = {
+        coOccurrences: [],
+        ownership: [],
+        churn: [],
+        hasLimitedHistory: false,
+    };
+    try {
+        // Check if this is a git repo using execSync directly
+        // SECURITY: This is a static command with no user input
+        // eslint-disable-next-line sonarjs/no-os-command-from-path -- git resolved from PATH; workflow tooling requires git
+        execSync('git rev-parse --is-inside-work-tree', {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+        });
+        const { limited, count } = hasLimitedCommitCount(projectRoot);
+        if (limited) {
+            result.hasLimitedHistory = true;
+            result.error = `Repository has fewer than ${GIT_MIN_COMMIT_COUNT} commits (found ${count})`;
+            return result;
+        }
+        // Extract co-occurrences
+        result.coOccurrences = getFileCoOccurrence(projectRoot, {
+            maxCommits: options.maxCommits ?? GIT_DEFAULT_MAX_COMMITS,
+            since: options.since,
+        });
+        // Get top-level directories for ownership analysis
+        const topDirs = getTopLevelDirs(projectRoot);
+        result.ownership = getOwnershipSignals(projectRoot, topDirs);
+        // Extract churn metrics
+        result.churn = getChurnMetrics(projectRoot, {
+            maxCommits: options.maxCommits ?? GIT_DEFAULT_MAX_COMMITS,
+            since: options.since,
+        });
+    }
+    catch (error) {
+        handleExtractionError(result, error);
+    }
+    return result;
+}
+/**
+ * Handle extraction errors and set appropriate error messages
+ */
+function handleExtractionError(result, error) {
+    result.hasLimitedHistory = true;
+    if (error instanceof Error) {
+        if (error.message.includes('not a git repository')) {
+            result.error = 'not a git repository';
+        }
+        else if (error.message.includes('does not have UnsafeAny commits')) {
+            result.error = 'no commits in repository';
+        }
+        else {
+            result.error = error.message;
+        }
+    }
+}
+/**
+ * Get top-level directories for ownership analysis
+ */
+function getTopLevelDirs(projectRoot) {
+    const output = safeGitExec(['ls-tree', '-d', '--name-only', 'HEAD'], projectRoot);
+    return output
+        .split('\n')
+        .filter((d) => d.trim() && !d.startsWith('.'))
+        .slice(0, GIT_MAX_TOP_LEVEL_DIRS);
+}
+/**
+ * Parse git log output into commits with their files
+ */
+function parseCommitsFromLog(output) {
+    const commits = [];
+    let currentFiles = [];
+    for (const line of output.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed) {
+            if (currentFiles.length > 0) {
+                commits.push([...currentFiles]);
+                currentFiles = [];
+            }
+            continue;
+        }
+        // Skip commit hashes (40 hex chars)
+        if (isCommitHash(trimmed)) {
+            if (currentFiles.length > 0) {
+                commits.push([...currentFiles]);
+                currentFiles = [];
+            }
+            continue;
+        }
+        // Only track source files
+        if (isSourceFile(trimmed)) {
+            currentFiles.push(trimmed);
+        }
+    }
+    if (currentFiles.length > 0) {
+        commits.push(currentFiles);
+    }
+    return commits;
+}
+/**
+ * Count file pair co-occurrences from commits
+ */
+function countFilePairs(commits) {
+    const pairCounts = new Map();
+    for (const files of commits) {
+        if (files.length < 2)
+            continue;
+        // Generate all pairs
+        for (let i = 0; i < files.length; i++) {
+            for (let j = i + 1; j < files.length; j++) {
+                const fileA = files[i];
+                const fileB = files[j];
+                if (!fileA || !fileB)
+                    continue;
+                const pair = [fileA, fileB]
+                    .slice()
+                    .sort((a, b) => a.localeCompare(b))
+                    .join('::');
+                pairCounts.set(pair, (pairCounts.get(pair) ?? 0) + 1);
+            }
+        }
+    }
+    return pairCounts;
+}
+/**
+ * Extract file co-occurrence patterns from git history
+ */
+export function getFileCoOccurrence(projectRoot, options = {}) {
+    const maxCommits = options.maxCommits ?? GIT_DEFAULT_MAX_COMMITS;
+    const maxResults = options.maxResults ?? GIT_DEFAULT_MAX_RESULTS;
+    // Build git log args array (safe - no user input in paths)
+    const args = ['log', `-n`, String(maxCommits)];
+    if (options.since) {
+        args.push(`--since=${options.since}`);
+    }
+    args.push('--name-only', '--pretty=format:%H', '--diff-filter=ACMRT');
+    const output = safeGitExec(args, projectRoot);
+    if (!output.trim()) {
+        return [];
+    }
+    const commits = parseCommitsFromLog(output);
+    const pairCounts = countFilePairs(commits);
+    // Convert to array and filter
+    const coOccurrences = [];
+    for (const [pair, count] of pairCounts.entries()) {
+        if (count >= GIT_MIN_CO_OCCURRENCE_COUNT) {
+            const [file1, file2] = pair.split('::');
+            if (!file1 || !file2)
+                continue;
+            coOccurrences.push({ file1, file2, count });
+        }
+    }
+    // Sort by count descending and limit results (use toSorted to avoid mutation)
+    return coOccurrences
+        .slice()
+        .sort((a, b) => b.count - a.count)
+        .slice(0, maxResults);
+}
+/**
+ * Check if a file is a source file (not config, lock, etc.)
+ */
+function isSourceFile(filePath) {
+    return !SOURCE_FILE_EXCLUDE_PATTERNS.some((pattern) => pattern.test(filePath));
+}
+/**
+ * Parse a single contributor line from shortlog output
+ */
+function parseShortlogLine(line) {
+    const result = parseShortlogFormat(line);
+    if (!result)
+        return null;
+    return {
+        count: result.count,
+        name: result.name,
+    };
+}
+/**
+ * Extract ownership signal for a single path
+ */
+function extractOwnershipForPath(projectRoot, targetPath) {
+    // Validate path doesn't contain dangerous characters
+    if (DANGEROUS_CHARS_REGEX.test(targetPath)) {
+        return {
+            path: targetPath,
+            primaryOwner: null,
+            contributors: [],
+            commitCount: 0,
+        };
+    }
+    // Use array form for safety
+    const args = ['shortlog', '-sne', '--all', '--', targetPath];
+    const output = safeGitExec(args, projectRoot);
+    if (!output.trim()) {
+        return {
+            path: targetPath,
+            primaryOwner: null,
+            contributors: [],
+            commitCount: 0,
+        };
+    }
+    // Parse shortlog output
+    const contributors = [];
+    let totalCommits = 0;
+    for (const line of output.split('\n')) {
+        const parsed = parseShortlogLine(line);
+        if (parsed) {
+            contributors.push(parsed);
+            totalCommits += parsed.count;
+        }
+    }
+    // Sort by commit count descending (use toSorted to avoid mutation)
+    const sorted = contributors.slice().sort((a, b) => b.count - a.count);
+    return {
+        path: targetPath,
+        primaryOwner: sorted[0]?.name ?? null,
+        contributors: sorted.map((c) => c.name),
+        commitCount: totalCommits,
+    };
+}
+/**
+ * Extract ownership signals for specified paths.
+ * Note: paths are validated internally and not derived from user input.
+ */
+export function getOwnershipSignals(projectRoot, paths) {
+    return paths.map((path) => extractOwnershipForPath(projectRoot, path));
+}
+/**
+ * Parse a single numstat line from git log output
+ */
+function parseNumstatLine(line) {
+    const match = NUMSTAT_LINE_REGEX.exec(line);
+    if (!match)
+        return null;
+    const additions = match[1];
+    const deletions = match[2];
+    const filePath = match[3];
+    if (!additions || !deletions || !filePath)
+        return null;
+    return {
+        additions: additions === '-' ? 0 : parseInt(additions, 10),
+        deletions: deletions === '-' ? 0 : parseInt(deletions, 10),
+        filePath,
+    };
+}
+/**
+ * Check if a file matches UnsafeAny exclude pattern using simple glob matching
+ */
+function matchesExcludePattern(filePath, patterns) {
+    return patterns.some((pattern) => {
+        // Simple glob matching using a state machine approach
+        // Avoids control characters and dynamic regex construction
+        return globMatch(filePath, pattern);
+    });
+}
+/**
+ * Simple glob matching without regex
+ * Supports * (match UnsafeAny) and ? (match single char)
+ */
+function globMatch(str, pattern) {
+    let si = 0; // string index
+    let pi = 0; // pattern index
+    let starIdx = -1;
+    let matchIdx = 0;
+    while (si < str.length) {
+        if (pi < pattern.length && (pattern[pi] === '?' || pattern[pi] === str[si])) {
+            // Character match or ? wildcard
+            si++;
+            pi++;
+        }
+        else if (pi < pattern.length && pattern[pi] === '*') {
+            // Star found, mark position
+            starIdx = pi;
+            matchIdx = si;
+            pi++;
+        }
+        else if (starIdx !== -1) {
+            // Mismatch after star, backtrack
+            pi = starIdx + 1;
+            matchIdx++;
+            si = matchIdx;
+        }
+        else {
+            // Mismatch without star
+            return false;
+        }
+    }
+    // Skip trailing stars
+    while (pi < pattern.length && pattern[pi] === '*') {
+        pi++;
+    }
+    return pi === pattern.length;
+}
+/**
+ * Aggregate file statistics from numstat output
+ */
+function aggregateFileStats(output, excludePatterns) {
+    const fileStats = new Map();
+    for (const line of output.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const parsed = parseNumstatLine(trimmed);
+        if (!parsed)
+            continue;
+        // Skip excluded patterns
+        if (matchesExcludePattern(parsed.filePath, excludePatterns))
+            continue;
+        // Skip non-source files
+        if (!isSourceFile(parsed.filePath))
+            continue;
+        const existing = fileStats.get(parsed.filePath) ?? { additions: 0, deletions: 0, commits: 0 };
+        fileStats.set(parsed.filePath, {
+            additions: existing.additions + parsed.additions,
+            deletions: existing.deletions + parsed.deletions,
+            commits: existing.commits + 1,
+        });
+    }
+    return fileStats;
+}
+/**
+ * Extract churn metrics for the repository
+ */
+export function getChurnMetrics(projectRoot, options = {}) {
+    const maxCommits = options.maxCommits ?? GIT_DEFAULT_MAX_COMMITS;
+    const maxResults = options.maxResults ?? GIT_DEFAULT_MAX_RESULTS;
+    const excludePatterns = options.excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS;
+    // Build git log args array
+    const args = ['log', `-n`, String(maxCommits)];
+    if (options.since) {
+        args.push(`--since=${options.since}`);
+    }
+    args.push('--numstat', '--pretty=format:');
+    let output;
+    try {
+        /// SECURITY: all args are constructed internally (no user input)
+        const cmd = ['git', ...args].join(' ');
+        output = execSync(cmd, {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            maxBuffer: GIT_MAX_BUFFER_BYTES,
+            timeout: GIT_COMMAND_TIMEOUT_MS,
+        });
+    }
+    catch {
+        return [];
+    }
+    if (!output.trim()) {
+        return [];
+    }
+    const fileStats = aggregateFileStats(output, excludePatterns);
+    // Convert to array with churn scores
+    const metrics = [];
+    for (const [filePath, stats] of fileStats.entries()) {
+        metrics.push({
+            filePath,
+            additions: stats.additions,
+            deletions: stats.deletions,
+            churnScore: stats.additions + stats.deletions,
+            commitCount: stats.commits,
+        });
+    }
+    // Sort by churn score descending and limit results (use toSorted to avoid mutation)
+    return metrics
+        .slice()
+        .sort((a, b) => b.churnScore - a.churnScore)
+        .slice(0, maxResults);
+}
+/**
+ * Build co-occurrence section for summary
+ */
+function buildCoOccurrenceSection(coOccurrences) {
+    const lines = ['## Co-occurrence Patterns', 'Files frequently changed together:'];
+    for (const co of coOccurrences.slice(0, GIT_SUMMARY_ITEM_LIMIT)) {
+        lines.push(`- ${co.file1} <-> ${co.file2} (${co.count} commits)`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Build ownership section for summary
+ */
+function buildOwnershipSection(ownership) {
+    const lines = ['## Ownership Signals', 'Primary contributors by area:'];
+    for (const own of ownership.filter((o) => o.primaryOwner)) {
+        const ownerName = own.primaryOwner?.split(' <')[0] ?? 'unknown';
+        lines.push(`- ${own.path}: ${ownerName} (${own.commitCount} commits)`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Build churn section for summary
+ */
+function buildChurnSection(churn) {
+    const lines = ['## Churn Hotspots', 'High-change files (potential complexity):'];
+    for (const ch of churn.slice(0, GIT_SUMMARY_ITEM_LIMIT)) {
+        lines.push(`- ${ch.filePath}: ${ch.churnScore} lines changed across ${ch.commitCount} commits`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Truncate a section to fit within character limit
+ */
+function truncateSection(section, maxChars) {
+    if (section.length <= maxChars)
+        return section;
+    const lines = section.split('\n');
+    const header = lines.slice(0, SECTION_HEADER_LINE_COUNT).join('\n');
+    const items = lines.slice(SECTION_HEADER_LINE_COUNT);
+    const availableChars = maxChars - header.length - GIT_TRUNCATION_PADDING;
+    const truncatedItems = [];
+    let currentChars = 0;
+    for (const item of items) {
+        if (currentChars + item.length > availableChars)
+            break;
+        truncatedItems.push(item);
+        currentChars += item.length + 1;
+    }
+    return [header, ...truncatedItems, '(truncated)'].join('\n');
+}
+/**
+ * Summarize git context for LLM prompt inclusion
+ *
+ * Produces a token-efficient summary that fits within specified limits.
+ */
+export function summarizeGitContext(context, options = {}) {
+    const maxTokens = options.maxTokens ?? GIT_DEFAULT_MAX_SUMMARY_TOKENS;
+    const maxChars = maxTokens * CHARS_PER_TOKEN;
+    // Handle limited history case
+    if (context.hasLimitedHistory) {
+        return context.error
+            ? `Git history analysis limited: ${context.error}`
+            : 'Git history analysis limited due to sparse commit history.';
+    }
+    const sections = [];
+    if (context.coOccurrences.length > 0) {
+        sections.push(buildCoOccurrenceSection(context.coOccurrences));
+    }
+    if (context.ownership.length > 0) {
+        sections.push(buildOwnershipSection(context.ownership));
+    }
+    if (context.churn.length > 0) {
+        sections.push(buildChurnSection(context.churn));
+    }
+    let result = sections.join('\n\n');
+    // Truncate if needed
+    if (result.length > maxChars && sections.length > 0) {
+        const charsPerSection = Math.floor(maxChars / sections.length) - GIT_TRUNCATION_PADDING;
+        const truncatedSections = sections.map((s) => truncateSection(s, charsPerSection));
+        result = truncatedSections.join('\n\n');
+    }
+    return result || 'Git history analysis limited due to sparse commit history.';
+}
+//# sourceMappingURL=git-context-extractor.js.map

package/dist/git/git-context-extractor.js.map

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

package/dist/git/git-staged-validator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Git Staged Files Validator
+ *
+ * Centralized validation for staged files requirement.
+ * Extracted from duplicate implementations in wu-block and wu-unblock (WU-1341).
+ *
+ * Used in --no-auto mode to enforce that required files are staged before commit.
+ *
+ * @module git-staged-validator
+ */
+/**
+ * Ensure all required paths are staged in git index
+ *
+ * Validates that specified files/directories are staged for commit.
+ * Supports exact path matching and directory prefix matching.
+ *
+ * @param {Array<string|null|undefined>} paths - Paths to check (null/undefined values filtered out)
+ * @throws {Error} If UnsafeAny required paths are not staged
+ * @returns {Array<string>} List of all staged files
+ *
+ * @example
+ * // All files staged - success
+ * ensureStaged(['<configured-doc-file>', 'tools/script.js']);
+ *
+ * // Directory prefix - matches all files under directory
+ * ensureStaged(['<configured-doc-root>/']);
+ *
+ * // Missing files - throws error
+ * ensureStaged(['<configured-doc-file-1>', '<configured-doc-file-2>']);
+ * // Error: Stage updates for: <configured-doc-file-2>
+ */
+export declare function ensureStaged(paths: Array<string | null | undefined>): string[];
+//# sourceMappingURL=git-staged-validator.d.ts.map

package/dist/git/git-staged-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-staged-validator.d.ts","sourceRoot":"","sources":["../../src/git/git-staged-validator.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,YAkBnE"}

package/dist/git/git-staged-validator.js

@@ -0,0 +1,52 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+import { getGitForCwd } from './git-adapter.js';
+import { die } from '@lumenflow/kernel/primitives/error-handler';
+/**
+ * Git Staged Files Validator
+ *
+ * Centralized validation for staged files requirement.
+ * Extracted from duplicate implementations in wu-block and wu-unblock (WU-1341).
+ *
+ * Used in --no-auto mode to enforce that required files are staged before commit.
+ *
+ * @module git-staged-validator
+ */
+/**
+ * Ensure all required paths are staged in git index
+ *
+ * Validates that specified files/directories are staged for commit.
+ * Supports exact path matching and directory prefix matching.
+ *
+ * @param {Array<string|null|undefined>} paths - Paths to check (null/undefined values filtered out)
+ * @throws {Error} If UnsafeAny required paths are not staged
+ * @returns {Array<string>} List of all staged files
+ *
+ * @example
+ * // All files staged - success
+ * ensureStaged(['<configured-doc-file>', 'tools/script.js']);
+ *
+ * // Directory prefix - matches all files under directory
+ * ensureStaged(['<configured-doc-root>/']);
+ *
+ * // Missing files - throws error
+ * ensureStaged(['<configured-doc-file-1>', '<configured-doc-file-2>']);
+ * // Error: Stage updates for: <configured-doc-file-2>
+ */
+export function ensureStaged(paths) {
+    const git = getGitForCwd();
+    const raw = git.run('git diff --cached --name-only');
+    const staged = raw ? raw.split(/\r?\n/).filter((s) => Boolean(s)) : [];
+    // Filter out null/undefined and check each path
+    const normalizedPaths = paths.filter((p) => typeof p === 'string' && p.length > 0);
+    const missing = normalizedPaths.filter((p) => {
+        // Normalize path: remove trailing slash for directory checks
+        const pathToCheck = p.endsWith('/') ? p.slice(0, -1) : p;
+        return !staged.some((name) => name === pathToCheck || name.startsWith(`${pathToCheck}/`));
+    });
+    if (missing.length) {
+        die(`Stage updates for: ${missing.join(', ')}`);
+    }
+    return staged;
+}
+//# sourceMappingURL=git-staged-validator.js.map