@lumenflow/core 2.2.2 → 2.3.2

package/dist/domain/orchestration.schemas.js

@@ -5,8 +5,8 @@
  * Single source of truth - types are inferred from these schemas.
  *
  * @module orchestration.schemas
- * @see {@link ./orchestration.types.mjs} - Types inferred from these schemas
- * @see {@link ./orchestration.constants.mjs} - Constants used in validation
+ * @see {@link ./orchestration.types.ts} - Types inferred from these schemas
+ * @see {@link ./orchestration.constants.ts} - Constants used in validation
  */
 import { z } from 'zod';
 import { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, DOD_TOTAL, } from './orchestration.constants.js';

package/dist/domain/orchestration.types.d.ts

@@ -5,8 +5,8 @@
  * Single source of truth - schemas validate at runtime, types at compile time.
  *
  * @module orchestration.types
- * @see {@link ./orchestration.schemas.mjs} - Schemas these types are inferred from
- * @see {@link ./orchestration.constants.mjs} - Constants and derived types
+ * @see {@link ./orchestration.schemas.ts} - Schemas these types are inferred from
+ * @see {@link ./orchestration.constants.ts} - Constants and derived types
  */
 import type { z } from 'zod';
 import type { GlobalStatusSchema, AgentMetricSchema, WUProgressSchema, TimelineEventSchema, AlertSchema, SuggestionSchema, ExecutionPlanSchema, UserChoiceSchema, DashboardDataSchema } from './orchestration.schemas.js';

package/dist/domain/orchestration.types.js

@@ -5,8 +5,8 @@
  * Single source of truth - schemas validate at runtime, types at compile time.
  *
  * @module orchestration.types
- * @see {@link ./orchestration.schemas.mjs} - Schemas these types are inferred from
- * @see {@link ./orchestration.constants.mjs} - Constants and derived types
+ * @see {@link ./orchestration.schemas.ts} - Schemas these types are inferred from
+ * @see {@link ./orchestration.constants.ts} - Constants and derived types
  */
 // Re-export const values as well
 export { LANES, AGENT_NAMES, SEVERITY_LEVELS, AGENT_RESULT_STATUSES, TIMELINE_EVENT_TYPES, EVENT_SEVERITY_LEVELS, USER_CHOICE_OPTIONS, MANDATORY_AGENT_NAMES, } from './orchestration.constants.js';

package/dist/error-handler.d.ts

@@ -1,19 +1,19 @@
 /**
- * @file error-handler.mjs
+ * @file error-handler.ts
  * @description Structured error handling with error codes
  * WU-1082: Extract shared utilities (eliminate die() duplication)
  * WU-1006: Library-First - use path.basename() instead of manual split
  *
  * Replaces die() function in:
- * - tools/wu-claim.mjs
- * - tools/wu-done.mjs
- * - tools/wu-block.mjs
- * - tools/wu-unblock.mjs
- * - tools/wu-create.mjs
- * - tools/wu-cleanup.mjs
- * - tools/gates-pre-commit.mjs
- * - tools/validate.mjs
- * - tools/guard-worktree-commit.mjs
+ * - tools/wu-claim.ts
+ * - tools/wu-done.ts
+ * - tools/wu-block.ts
+ * - tools/wu-unblock.ts
+ * - tools/wu-create.ts
+ * - tools/wu-cleanup.ts
+ * - tools/gates-pre-commit.ts
+ * - tools/validate.ts
+ * - tools/guard-worktree-commit.ts
  */
 /**
  * Structured error class with error codes and details

package/dist/error-handler.js

@@ -1,19 +1,19 @@
 /**
- * @file error-handler.mjs
+ * @file error-handler.ts
  * @description Structured error handling with error codes
  * WU-1082: Extract shared utilities (eliminate die() duplication)
  * WU-1006: Library-First - use path.basename() instead of manual split
  *
  * Replaces die() function in:
- * - tools/wu-claim.mjs
- * - tools/wu-done.mjs
- * - tools/wu-block.mjs
- * - tools/wu-unblock.mjs
- * - tools/wu-create.mjs
- * - tools/wu-cleanup.mjs
- * - tools/gates-pre-commit.mjs
- * - tools/validate.mjs
- * - tools/guard-worktree-commit.mjs
+ * - tools/wu-claim.ts
+ * - tools/wu-done.ts
+ * - tools/wu-block.ts
+ * - tools/wu-unblock.ts
+ * - tools/wu-create.ts
+ * - tools/wu-cleanup.ts
+ * - tools/gates-pre-commit.ts
+ * - tools/validate.ts
+ * - tools/guard-worktree-commit.ts
  */
 import path from 'node:path';
 /**

package/dist/file-classifiers.d.ts

@@ -3,13 +3,13 @@
  * File Classifiers
  *
  * Shared utilities for classifying file types.
- * Consolidates duplicated classification logic from wu-validator.mjs
- * and code-path-validator.mjs.
+ * Consolidates duplicated classification logic from wu-validator.ts
+ * and code-path-validator.ts.
  *
  * WU-1848: DRY Consolidation - Eliminate duplicated code patterns
  *
- * @see tools/lib/wu-validator.mjs - Original isTestFile, isMarkdownFile
- * @see tools/lib/code-path-validator.mjs - Duplicated implementations
+ * @see tools/lib/wu-validator.ts - Original isTestFile, isMarkdownFile
+ * @see tools/lib/code-path-validator.ts - Duplicated implementations
  */
 /**
  * Prefixes for paths that qualify as documentation-only.
@@ -30,8 +30,8 @@ declare const TEST_FILE_PATTERNS: readonly RegExp[];
  * Check if a file path is a test file
  *
  * Detects test files by extension and directory patterns:
- * - *.test.ts, *.test.tsx, *.test.js, *.test.jsx, *.test.mjs
- * - *.spec.ts, *.spec.tsx, *.spec.js, *.spec.jsx, *.spec.mjs
+ * - *.test.ts, *.test.tsx, *.test.js, *.test.jsx, *.test.ts
+ * - *.spec.ts, *.spec.tsx, *.spec.js, *.spec.jsx, *.spec.ts
  * - Files in __tests__ directories
  * - *.test-utils.* files
  * - *.mock.* files

package/dist/file-classifiers.js

@@ -3,13 +3,13 @@
  * File Classifiers
  *
  * Shared utilities for classifying file types.
- * Consolidates duplicated classification logic from wu-validator.mjs
- * and code-path-validator.mjs.
+ * Consolidates duplicated classification logic from wu-validator.ts
+ * and code-path-validator.ts.
  *
  * WU-1848: DRY Consolidation - Eliminate duplicated code patterns
  *
- * @see tools/lib/wu-validator.mjs - Original isTestFile, isMarkdownFile
- * @see tools/lib/code-path-validator.mjs - Duplicated implementations
+ * @see tools/lib/wu-validator.ts - Original isTestFile, isMarkdownFile
+ * @see tools/lib/code-path-validator.ts - Duplicated implementations
  */
 /**
  * Prefixes for paths that qualify as documentation-only.
@@ -36,8 +36,8 @@ const TEST_FILE_PATTERNS = Object.freeze([
  * Check if a file path is a test file
  *
  * Detects test files by extension and directory patterns:
- * - *.test.ts, *.test.tsx, *.test.js, *.test.jsx, *.test.mjs
- * - *.spec.ts, *.spec.tsx, *.spec.js, *.spec.jsx, *.spec.mjs
+ * - *.test.ts, *.test.tsx, *.test.js, *.test.jsx, *.test.ts
+ * - *.spec.ts, *.spec.tsx, *.spec.js, *.spec.jsx, *.spec.ts
  * - Files in __tests__ directories
  * - *.test-utils.* files
  * - *.mock.* files

package/dist/gates-config.d.ts

@@ -10,6 +10,7 @@
  * @module gates-config
  */
 import { z } from 'zod';
+import { type CoverageMode } from './resolve-policy.js';
 /**
  * Schema for a gate command - either a string or an object with options
  */
@@ -130,3 +131,76 @@ export declare function resolveGatesConfig(projectRoot: string): GatesExecutionC
  * @returns True if the gate should be skipped
  */
 export declare function shouldSkipGate(gateName: keyof Omit<GatesExecutionConfig, 'preset' | 'coverage'>, config: GatesExecutionConfig, skipFlags: Record<string, boolean>): boolean;
+/**
+ * WU-1191: Lane health gate mode
+ * Controls how lane health check behaves during gates
+ */
+export type LaneHealthMode = 'warn' | 'error' | 'off';
+/**
+ * WU-1191: Load lane health configuration from .lumenflow.config.yaml
+ *
+ * Configuration format:
+ * ```yaml
+ * gates:
+ *   lane_health: warn|error|off
+ * ```
+ *
+ * @param projectRoot - Project root directory
+ * @returns Lane health mode ('warn', 'error', or 'off'), defaults to 'warn'
+ */
+export declare function loadLaneHealthConfig(projectRoot: string): LaneHealthMode;
+/**
+ * WU-1262: Resolved coverage configuration
+ * Contains threshold and mode derived from methodology policy
+ */
+export interface CoverageConfig {
+    /** Coverage threshold (0-100) */
+    threshold: number;
+    /** Coverage mode (block, warn, or off) */
+    mode: CoverageMode;
+}
+/**
+ * WU-1262: Resolve coverage configuration from methodology policy
+ *
+ * Uses resolvePolicy() to determine coverage defaults based on methodology.testing:
+ * - tdd: 90% threshold, block mode
+ * - test-after: 70% threshold, warn mode
+ * - none: 0% threshold, off mode
+ *
+ * Precedence (highest to lowest):
+ * 1. Explicit gates.minCoverage / gates.enableCoverage
+ * 2. methodology.overrides.coverage_threshold / coverage_mode
+ * 3. methodology.testing template defaults
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved coverage configuration
+ */
+export declare function resolveCoverageConfig(projectRoot: string): CoverageConfig;
+/**
+ * WU-1280: Resolved test policy configuration
+ * Extends CoverageConfig with tests_required from methodology policy
+ */
+export interface TestPolicy extends CoverageConfig {
+    /** Whether tests are required for completion (from methodology.testing) */
+    tests_required: boolean;
+}
+/**
+ * WU-1280: Resolve test policy from methodology configuration
+ *
+ * Returns the full test policy including coverage config AND tests_required.
+ * This is used by gates to determine whether test failures should block or warn.
+ *
+ * Methodology mapping:
+ * - tdd: 90% threshold, block mode, tests_required=true
+ * - test-after: 70% threshold, warn mode, tests_required=true
+ * - none: 0% threshold, off mode, tests_required=false
+ *
+ * When tests_required=false:
+ * - Test failures produce WARNINGS instead of FAILURES
+ * - Gates continue but log the test failures
+ * - Coverage gate is effectively skipped (mode='off')
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved test policy including tests_required
+ */
+export declare function resolveTestPolicy(projectRoot: string): TestPolicy;

package/dist/gates-config.js

@@ -13,6 +13,13 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import * as yaml from 'yaml';
 import { z } from 'zod';
+// WU-1262: Import resolvePolicy for methodology-driven coverage defaults
+// Note: resolvePolicy uses type-only import from lumenflow-config-schema, avoiding circular dependency
+import { resolvePolicy, getDefaultPolicy, MethodologyConfigSchema, } from './resolve-policy.js';
+/**
+ * Config file name constant to avoid duplicate string literals
+ */
+const CONFIG_FILE_NAME = '.lumenflow.config.yaml';
 /**
  * Default timeout for gate commands (2 minutes)
  */
@@ -160,7 +167,7 @@ export function expandPreset(preset) {
  * @returns Gates execution config, or null if not configured
  */
 export function loadGatesConfig(projectRoot) {
-    const configPath = path.join(projectRoot, '.lumenflow.config.yaml');
+    const configPath = path.join(projectRoot, CONFIG_FILE_NAME);
     if (!fs.existsSync(configPath)) {
         return null;
     }
@@ -175,6 +182,7 @@ export function loadGatesConfig(projectRoot) {
         // Validate the config
         const result = GatesExecutionConfigSchema.safeParse(executionConfig);
         if (!result.success) {
+            // eslint-disable-next-line no-console -- Intentional warning for invalid config
             console.warn('Warning: Invalid gates.execution config:', result.error.message);
             return null;
         }
@@ -187,7 +195,8 @@ export function loadGatesConfig(projectRoot) {
         return merged;
     }
     catch (error) {
-        console.warn('Warning: Failed to parse .lumenflow.config.yaml:', error instanceof Error ? error.message : String(error));
+        // eslint-disable-next-line no-console -- Intentional warning for parse failure
+        console.warn(`Warning: Failed to parse ${CONFIG_FILE_NAME}:`, error instanceof Error ? error.message : String(error));
         return null;
     }
 }
@@ -246,3 +255,201 @@ export function shouldSkipGate(gateName, config, skipFlags) {
     }
     return false;
 }
+/**
+ * Schema for lane health mode validation
+ */
+const LaneHealthModeSchema = z.enum(['warn', 'error', 'off']);
+/**
+ * Default lane health mode (advisory by default)
+ */
+const DEFAULT_LANE_HEALTH_MODE = 'warn';
+/**
+ * WU-1191: Load lane health configuration from .lumenflow.config.yaml
+ *
+ * Configuration format:
+ * ```yaml
+ * gates:
+ *   lane_health: warn|error|off
+ * ```
+ *
+ * @param projectRoot - Project root directory
+ * @returns Lane health mode ('warn', 'error', or 'off'), defaults to 'warn'
+ */
+export function loadLaneHealthConfig(projectRoot) {
+    const configPath = path.join(projectRoot, CONFIG_FILE_NAME);
+    if (!fs.existsSync(configPath)) {
+        return DEFAULT_LANE_HEALTH_MODE;
+    }
+    try {
+        const content = fs.readFileSync(configPath, 'utf8');
+        const data = yaml.parse(content);
+        // Check if gates.lane_health is configured
+        const laneHealthConfig = data?.gates?.lane_health;
+        if (laneHealthConfig === undefined) {
+            return DEFAULT_LANE_HEALTH_MODE;
+        }
+        // Validate the config value
+        const result = LaneHealthModeSchema.safeParse(laneHealthConfig);
+        if (!result.success) {
+            // eslint-disable-next-line no-console -- Intentional warning for invalid config
+            console.warn(`Warning: Invalid gates.lane_health value '${laneHealthConfig}', expected 'warn', 'error', or 'off'. Using default 'warn'.`);
+            return DEFAULT_LANE_HEALTH_MODE;
+        }
+        return result.data;
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console -- Intentional warning for parse failure
+        console.warn(`Warning: Failed to parse ${CONFIG_FILE_NAME} for lane_health config:`, error instanceof Error ? error.message : String(error));
+        return DEFAULT_LANE_HEALTH_MODE;
+    }
+}
+/**
+ * WU-1262: Resolve coverage configuration from methodology policy
+ *
+ * Uses resolvePolicy() to determine coverage defaults based on methodology.testing:
+ * - tdd: 90% threshold, block mode
+ * - test-after: 70% threshold, warn mode
+ * - none: 0% threshold, off mode
+ *
+ * Precedence (highest to lowest):
+ * 1. Explicit gates.minCoverage / gates.enableCoverage
+ * 2. methodology.overrides.coverage_threshold / coverage_mode
+ * 3. methodology.testing template defaults
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved coverage configuration
+ */
+export function resolveCoverageConfig(projectRoot) {
+    const configPath = path.join(projectRoot, CONFIG_FILE_NAME);
+    // Load raw config to detect explicit vs default values
+    let rawConfig = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            const content = fs.readFileSync(configPath, 'utf8');
+            rawConfig = yaml.parse(content) ?? {};
+        }
+        catch {
+            // Fall through to use defaults
+            rawConfig = {};
+        }
+    }
+    // If no config file, use default policy
+    if (Object.keys(rawConfig).length === 0) {
+        const defaultPolicy = getDefaultPolicy();
+        return {
+            threshold: defaultPolicy.coverage_threshold,
+            mode: defaultPolicy.coverage_mode,
+        };
+    }
+    // Parse methodology config manually to avoid circular dependency with lumenflow-config-schema.ts
+    // (lumenflow-config-schema.ts imports GatesExecutionConfigSchema from this file)
+    const methodologyRaw = rawConfig.methodology;
+    const gatesRaw = rawConfig.gates;
+    // Build a minimal config object with only what resolvePolicy needs
+    // Parse methodology with Zod to get defaults
+    const methodology = MethodologyConfigSchema.parse(methodologyRaw ?? {});
+    // Build the config structure that resolvePolicy expects
+    const minimalConfig = {
+        methodology: methodologyRaw, // Pass raw methodology for explicit detection
+        gates: {
+            minCoverage: gatesRaw?.minCoverage,
+            enableCoverage: gatesRaw?.enableCoverage,
+        },
+    };
+    // Resolve policy using the methodology configuration
+    // Pass rawConfig to detect explicit gates.* settings vs Zod defaults
+    const policy = resolvePolicy({
+        methodology,
+        gates: {
+            // Default gates values from schema
+            maxEslintWarnings: 100,
+            enableCoverage: gatesRaw?.enableCoverage !== undefined ? Boolean(gatesRaw.enableCoverage) : true,
+            minCoverage: typeof gatesRaw?.minCoverage === 'number' ? gatesRaw.minCoverage : 90,
+            enableSafetyCriticalTests: true,
+            enableInvariants: true,
+        },
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Minimal type for config
+    }, {
+        rawConfig: minimalConfig,
+    });
+    return {
+        threshold: policy.coverage_threshold,
+        mode: policy.coverage_mode,
+    };
+}
+/**
+ * WU-1280: Resolve test policy from methodology configuration
+ *
+ * Returns the full test policy including coverage config AND tests_required.
+ * This is used by gates to determine whether test failures should block or warn.
+ *
+ * Methodology mapping:
+ * - tdd: 90% threshold, block mode, tests_required=true
+ * - test-after: 70% threshold, warn mode, tests_required=true
+ * - none: 0% threshold, off mode, tests_required=false
+ *
+ * When tests_required=false:
+ * - Test failures produce WARNINGS instead of FAILURES
+ * - Gates continue but log the test failures
+ * - Coverage gate is effectively skipped (mode='off')
+ *
+ * @param projectRoot - Project root directory
+ * @returns Resolved test policy including tests_required
+ */
+export function resolveTestPolicy(projectRoot) {
+    const configPath = path.join(projectRoot, CONFIG_FILE_NAME);
+    // Load raw config to detect explicit vs default values
+    let rawConfig = {};
+    if (fs.existsSync(configPath)) {
+        try {
+            const content = fs.readFileSync(configPath, 'utf8');
+            rawConfig = yaml.parse(content) ?? {};
+        }
+        catch {
+            // Fall through to use defaults
+            rawConfig = {};
+        }
+    }
+    // If no config file, use default policy (TDD)
+    if (Object.keys(rawConfig).length === 0) {
+        const defaultPolicy = getDefaultPolicy();
+        return {
+            threshold: defaultPolicy.coverage_threshold,
+            mode: defaultPolicy.coverage_mode,
+            tests_required: defaultPolicy.tests_required,
+        };
+    }
+    // Parse methodology config manually to avoid circular dependency with lumenflow-config-schema.ts
+    const methodologyRaw = rawConfig.methodology;
+    const gatesRaw = rawConfig.gates;
+    // Parse methodology with Zod to get defaults
+    const methodology = MethodologyConfigSchema.parse(methodologyRaw ?? {});
+    // Build the config structure that resolvePolicy expects
+    const minimalConfig = {
+        methodology: methodologyRaw, // Pass raw methodology for explicit detection
+        gates: {
+            minCoverage: gatesRaw?.minCoverage,
+            enableCoverage: gatesRaw?.enableCoverage,
+        },
+    };
+    // Resolve policy using the methodology configuration
+    const policy = resolvePolicy({
+        methodology,
+        gates: {
+            // Default gates values from schema
+            maxEslintWarnings: 100,
+            enableCoverage: gatesRaw?.enableCoverage !== undefined ? Boolean(gatesRaw.enableCoverage) : true,
+            minCoverage: typeof gatesRaw?.minCoverage === 'number' ? gatesRaw.minCoverage : 90,
+            enableSafetyCriticalTests: true,
+            enableInvariants: true,
+        },
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Minimal type for config
+    }, {
+        rawConfig: minimalConfig,
+    });
+    return {
+        threshold: policy.coverage_threshold,
+        mode: policy.coverage_mode,
+        tests_required: policy.tests_required,
+    };
+}

package/dist/git-adapter.d.ts

@@ -1,20 +1,20 @@
 /**
- * @file git-adapter.mjs
+ * @file git-adapter.ts
  * @description Git operations adapter using simple-git library
  * WU-1082: Extract shared utilities (eliminate run() duplication)
  * WU-1213: Refactor to use simple-git library (eliminate execSync)
  * WU-2242: Add runtime type assertions to prevent silent API misuse
  *
  * Replaces run() function in:
- * - tools/wu-claim.mjs
- * - tools/wu-done.mjs
- * - tools/wu-block.mjs
- * - tools/wu-unblock.mjs
- * - tools/wu-create.mjs
- * - tools/wu-cleanup.mjs
- * - tools/gates-pre-commit.mjs
- * - tools/validate.mjs
- * - tools/guard-worktree-commit.mjs
+ * - tools/wu-claim.ts
+ * - tools/wu-done.ts
+ * - tools/wu-block.ts
+ * - tools/wu-unblock.ts
+ * - tools/wu-create.ts
+ * - tools/wu-cleanup.ts
+ * - tools/gates-pre-commit.ts
+ * - tools/validate.ts
+ * - tools/guard-worktree-commit.ts
  */
 import { type SimpleGit } from 'simple-git';
 interface GitAdapterOptions {
@@ -242,7 +242,7 @@ export declare class GitAdapter {
      * Get commit log
      *
      * WU-1749: Bug 4 fix - Add log() method for counting commits.
-     * Used by wu-done-retry-helpers.mjs to count previous completion attempts.
+     * Used by wu-done-retry-helpers.ts to count previous completion attempts.
      *
      * @param {object} [options] - Log options
      * @param {number} [options.maxCount] - Maximum number of commits to return

package/dist/git-adapter.js

@@ -1,20 +1,20 @@
 /**
- * @file git-adapter.mjs
+ * @file git-adapter.ts
  * @description Git operations adapter using simple-git library
  * WU-1082: Extract shared utilities (eliminate run() duplication)
  * WU-1213: Refactor to use simple-git library (eliminate execSync)
  * WU-2242: Add runtime type assertions to prevent silent API misuse
  *
  * Replaces run() function in:
- * - tools/wu-claim.mjs
- * - tools/wu-done.mjs
- * - tools/wu-block.mjs
- * - tools/wu-unblock.mjs
- * - tools/wu-create.mjs
- * - tools/wu-cleanup.mjs
- * - tools/gates-pre-commit.mjs
- * - tools/validate.mjs
- * - tools/guard-worktree-commit.mjs
+ * - tools/wu-claim.ts
+ * - tools/wu-done.ts
+ * - tools/wu-block.ts
+ * - tools/wu-unblock.ts
+ * - tools/wu-create.ts
+ * - tools/wu-cleanup.ts
+ * - tools/gates-pre-commit.ts
+ * - tools/validate.ts
+ * - tools/guard-worktree-commit.ts
  */
 import { simpleGit } from 'simple-git';
 import { existsSync, rmSync } from 'node:fs';
@@ -385,7 +385,7 @@ export class GitAdapter {
      * Get commit log
      *
      * WU-1749: Bug 4 fix - Add log() method for counting commits.
-     * Used by wu-done-retry-helpers.mjs to count previous completion attempts.
+     * Used by wu-done-retry-helpers.ts to count previous completion attempts.
      *
      * @param {object} [options] - Log options
      * @param {number} [options.maxCount] - Maximum number of commits to return

package/dist/git-context-extractor.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 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.
+ */
+/**
+ * A pair of files frequently changed together
+ */
+export interface CoOccurrence {
+    file1: string;
+    file2: string;
+    /** Number of commits where both files were changed */
+    count: number;
+}
+/**
+ * Ownership signal for a path (file or directory)
+ */
+export interface OwnershipSignal {
+    /** The path being analyzed */
+    path: string;
+    /** Primary contributor (most commits), null if none */
+    primaryOwner: string | null;
+    /** All contributors with their commit counts */
+    contributors: string[];
+    /** Total commits touching this path */
+    commitCount: number;
+}
+/**
+ * Churn metric for a file
+ */
+export interface ChurnMetric {
+    filePath: string;
+    additions: number;
+    deletions: number;
+    /** Churn score = additions + deletions */
+    churnScore: number;
+    /** Number of commits modifying this file */
+    commitCount: number;
+}
+/**
+ * Complete git context extracted from repository
+ */
+export interface GitContext {
+    coOccurrences: CoOccurrence[];
+    ownership: OwnershipSignal[];
+    churn: ChurnMetric[];
+    hasLimitedHistory: boolean;
+    error?: string;
+}
+/**
+ * Options for git context extraction
+ */
+export interface GitContextOptions {
+    /** Maximum number of commits to analyze */
+    maxCommits?: number;
+    /** Limit history to commits since this date */
+    since?: string;
+}
+/**
+ * Options for co-occurrence extraction
+ */
+interface CoOccurrenceOptions {
+    maxResults?: number;
+    maxCommits?: number;
+    since?: string;
+}
+/**
+ * Options for churn metrics extraction
+ */
+interface ChurnOptions {
+    excludePatterns?: string[];
+    maxResults?: number;
+    maxCommits?: number;
+    since?: string;
+}
+/**
+ * Options for summarizing git context
+ */
+interface SummarizeOptions {
+    /** Approximate max tokens (chars / 4 as rough estimate) */
+    maxTokens?: number;
+}
+/**
+ * Extract complete git context from a repository
+ */
+export declare function extractGitContext(projectRoot: string, options?: GitContextOptions): GitContext;
+/**
+ * Extract file co-occurrence patterns from git history
+ */
+export declare function getFileCoOccurrence(projectRoot: string, options?: CoOccurrenceOptions): CoOccurrence[];
+/**
+ * Extract ownership signals for specified paths.
+ * Note: paths are validated internally and not derived from user input.
+ */
+export declare function getOwnershipSignals(projectRoot: string, paths: string[]): OwnershipSignal[];
+/**
+ * Extract churn metrics for the repository
+ */
+export declare function getChurnMetrics(projectRoot: string, options?: ChurnOptions): ChurnMetric[];
+/**
+ * Summarize git context for LLM prompt inclusion
+ *
+ * Produces a token-efficient summary that fits within specified limits.
+ */
+export declare function summarizeGitContext(context: GitContext, options?: SummarizeOptions): string;
+export {};