@lumy-pack/line-lore 0.0.6 → 0.0.8

package/dist/core/ancestry/ancestry.d.ts

@@ -5,7 +5,38 @@ export interface AncestryResult {
     subject: string;
 }
 export declare const DEFAULT_ANCESTRY_TIMEOUT = 30000;
+/**
+ * @deprecated Use {@link findMergeCommits} (plural) instead.
+ * Returns only the first verified merge commit. The plural version returns
+ * multiple candidates from both first-parent and full ancestry paths.
+ */
 export declare function findMergeCommit(commitSha: string, options?: GitExecOptions & {
     ref?: string;
 }): Promise<AncestryResult | null>;
-export declare function extractPRFromMergeMessage(subject: string): number | null;
+/**
+ * Verify that a merge commit actually introduced the target commit
+ * through its branch side (non-first parent), not from the mainline.
+ *
+ * Dual condition:
+ * 1. Target IS an ancestor of at least one non-first parent (branch side)
+ * 2. Target is NOT an ancestor of the first parent (mainline side)
+ *
+ * Returns false on git command failure (fail-skip policy).
+ */
+export declare function verifyMergeIntroducesCommit(targetSha: string, mergeResult: AncestryResult, options?: GitExecOptions): Promise<boolean>;
+/**
+ * Multi-candidate merge commit search.
+ * Returns up to MAX_CANDIDATES verified merge commits from both first-parent
+ * and full ancestry paths, deduplicated by mergeCommitSha and ordered with
+ * first-parent results first.
+ *
+ * Unlike `findMergeCommit` (singular) which returns only the first verified candidate,
+ * this function enables callers to iterate through multiple candidates when the
+ * first one doesn't yield a PR (e.g., bulk merge with non-standard message).
+ */
+export declare function findMergeCommits(commitSha: string, options?: GitExecOptions & {
+    ref?: string;
+}): Promise<AncestryResult[]>;
+/** Retrieve the subject line of a single commit. Returns null on git failure. */
+export declare function getCommitSubject(sha: string, options?: GitExecOptions): Promise<string | null>;
+export declare function extractPRFromMergeMessage(subject: string, platform?: string): number | null;

package/dist/core/ancestry/index.d.ts

@@ -1,2 +1,2 @@
-export { extractPRFromMergeMessage, findMergeCommit } from './ancestry.js';
+export { extractPRFromMergeMessage, findMergeCommit, findMergeCommits, getCommitSubject, verifyMergeIntroducesCommit, } from './ancestry.js';
 export type { AncestryResult } from './ancestry.js';

package/dist/core/blame/blame.d.ts

@@ -1,3 +1,3 @@
-import type { BlameResult, BlameStageResult, GitExecOptions, LineRange } from '../../types/index.js';
-export declare function executeBlame(file: string, lineRange: LineRange, options?: GitExecOptions): Promise<BlameResult[]>;
+import type { BlameExecOptions, BlameResult, BlameStageResult, GitExecOptions, LineRange } from '../../types/index.js';
+export declare function executeBlame(file: string, lineRange: LineRange, options?: BlameExecOptions): Promise<BlameResult[]>;
 export declare function analyzeBlameResults(results: BlameResult[], filePath: string, options?: GitExecOptions): Promise<BlameStageResult[]>;

package/dist/core/index.d.ts

@@ -1,6 +1,6 @@
 export { analyzeBlameResults, executeBlame, isCosmeticDiff, parsePorcelainOutput, } from './blame/index.js';
 export { compareSymbolMaps, computeContentHash, computeExactHash, computeStructuralHash, extractSymbols, findContainingSymbol, findMatchAcrossFiles, traceByAst, } from './ast-diff/index.js';
-export { extractPRFromMergeMessage, findMergeCommit, } from './ancestry/index.js';
+export { extractPRFromMergeMessage, findMergeCommit, findMergeCommits, } from './ancestry/index.js';
 export type { AncestryResult } from './ancestry/index.js';
 export { computePatchId, findPatchIdMatch, resetPatchIdCache, } from './patch-id/index.js';
 export type { PatchIdResult } from './patch-id/index.js';

package/dist/core/pr-lookup/index.d.ts

@@ -1 +1,2 @@
 export { lookupPR, resetPRCache } from './pr-lookup.js';
+export type { PRLookupResult, ResolvedVia } from './pr-lookup.js';

package/dist/core/pr-lookup/pr-lookup.d.ts

@@ -1,15 +1,31 @@
 import type { RepoIdentity } from '../../cache/index.js';
 import type { GitExecOptions, PRInfo, PlatformAdapter } from '../../types/index.js';
+export type ResolvedVia = 'api' | 'ancestry' | 'message' | 'patch-id';
+export interface PRLookupResult extends PRInfo {
+    resolvedVia: ResolvedVia;
+}
 export interface PRLookupOptions extends GitExecOptions {
     noCache?: boolean;
     /** Return cached results only — skip all fallback strategies */
     cacheOnly?: boolean;
     deep?: boolean;
     repoId?: RepoIdentity;
-    /** Skip Strategy 4 (patch-id scan) — set automatically for partial clone environments */
+    /** Skip Strategy 5 (patch-id scan) — set automatically for partial clone environments */
     skipPatchIdScan?: boolean;
+    /** Preferred base branch for PR selection — when multiple PRs match, prefer the one targeting this branch */
+    preferredBase?: string;
+    /** Platform type for platform-aware merge message parsing */
+    platform?: string;
 }
+/**
+ * Multi-strategy PR lookup pipeline:
+ *   Strategy 1: Cache
+ *   Strategy 2: API direct (ground truth — Level 2)
+ *   Strategy 3: Ancestry-path + merge commit verification (structural proof)
+ *   Strategy 4: Blame commit message parsing (heuristic — squash merge detection)
+ *   Strategy 5: Patch-ID matching + recursion (last resort)
+ */
 export declare function lookupPR(commitSha: string, adapter: PlatformAdapter | null, options?: PRLookupOptions, 
 /** @internal recursion depth tracker — do not set from external callers */
-_recursionDepth?: number): Promise<PRInfo | null>;
+_recursionDepth?: number): Promise<PRLookupResult | null>;
 export declare function resetPRCache(): void;