@jafreck/lore 0.2.0 → 0.2.2

package/dist/lore-server/tools/blame.d.ts

@@ -0,0 +1,159 @@
+/**
+ * @module lore-server/tools/blame
+ *
+ * MCP tool: line-level git blame, line-range history, and ownership metadata.
+ */
+import type { Database } from '../db.js';
+import { type CommitWithFiles } from './history.js';
+export declare const toolDef: {
+    readonly name: "lore_blame";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly path: {
+                readonly type: "string";
+                readonly description: "Absolute file path as stored in the knowledge-base index.";
+            };
+            readonly line: {
+                readonly type: "number";
+                readonly description: "Single line number to blame (1-based).";
+            };
+            readonly start_line: {
+                readonly type: "number";
+                readonly description: "Range start line (1-based, inclusive).";
+            };
+            readonly end_line: {
+                readonly type: "number";
+                readonly description: "Range end line (1-based, inclusive). Defaults to start_line.";
+            };
+            readonly ref: {
+                readonly type: "string";
+                readonly description: "Git ref to blame against (default: HEAD).";
+            };
+            readonly branch: {
+                readonly type: "string";
+                readonly description: "Optional indexed branch to disambiguate file lookup.";
+            };
+            readonly mode: {
+                readonly type: "string";
+                readonly enum: readonly ["blame", "history", "ownership"];
+                readonly description: "Query mode (default: \"blame\").";
+            };
+            readonly symbol: {
+                readonly type: "string";
+                readonly description: "Optional symbol name to resolve to an indexed file + line range.";
+            };
+            readonly scope: {
+                readonly type: "string";
+                readonly enum: readonly ["file", "directory"];
+                readonly description: "Ownership mode scope. If omitted, inferred from `path`.";
+            };
+        };
+        readonly required: readonly [];
+    };
+};
+export type BlameMode = 'blame' | 'history' | 'ownership';
+export interface BlameArgs {
+    path?: string;
+    line?: number;
+    start_line?: number;
+    end_line?: number;
+    ref?: string;
+    branch?: string;
+    mode?: BlameMode;
+    symbol?: string;
+    scope?: 'file' | 'directory';
+}
+export interface BlameLine {
+    line: number;
+    commit_sha: string;
+    author: string;
+    author_email: string;
+    timestamp: number;
+    summary: string;
+    text: string;
+}
+export interface BlameRiskSignals {
+    recency: {
+        latest_timestamp: number | null;
+        days_since_latest: number | null;
+        level: 'low' | 'medium' | 'high' | 'unknown';
+    };
+    author_dispersion: {
+        distinct_authors: number;
+        sample_size: number;
+        ratio: number;
+        level: 'low' | 'medium' | 'high' | 'unknown';
+    };
+    churn: {
+        total_churn: number;
+        commit_count: number;
+        average_churn_per_commit: number;
+        level: 'low' | 'medium' | 'high' | 'unknown';
+    };
+    overall: 'low' | 'medium' | 'high' | 'unknown';
+}
+export interface ResolvedBlameSymbol {
+    name: string;
+    kind: string;
+    path: string;
+    branch: string;
+    start_line: number;
+    end_line: number;
+}
+export interface BlameResult {
+    path: string;
+    ref: string;
+    start_line: number;
+    end_line: number;
+    lines: BlameLine[];
+    commits?: CommitWithFiles[];
+    risk?: BlameRiskSignals;
+    resolved_symbol?: ResolvedBlameSymbol;
+}
+export interface BlameHistoryEntry {
+    commit_sha: string;
+    author: string;
+    author_email: string;
+    timestamp: number;
+    summary: string;
+    patch: string;
+    commit_context?: CommitWithFiles;
+}
+export interface BlameHistoryResult {
+    mode: 'history';
+    path: string;
+    ref: string;
+    start_line: number;
+    end_line: number;
+    count: number;
+    history: BlameHistoryEntry[];
+    commits: CommitWithFiles[];
+    risk: BlameRiskSignals;
+    resolved_symbol?: ResolvedBlameSymbol;
+}
+export interface OwnershipAuthor {
+    author: string;
+    author_email: string;
+    lines: number;
+    share: number;
+    commit_count: number;
+}
+export interface BlameOwnershipResult {
+    mode: 'ownership';
+    scope: 'file' | 'directory';
+    path: string;
+    ref: string;
+    files_analyzed: number;
+    start_line?: number;
+    end_line?: number;
+    total_lines: number;
+    ownership: OwnershipAuthor[];
+    commits: CommitWithFiles[];
+    risk: BlameRiskSignals;
+    resolved_symbol?: ResolvedBlameSymbol;
+}
+/** Execute lore_blame mode routing against the indexed repository metadata. */
+export declare function handler(db: Database.Database, args: BlameArgs): BlameResult | BlameHistoryResult | BlameOwnershipResult;
+//# sourceMappingURL=blame.d.ts.map

package/dist/lore-server/tools/blame.d.ts.map

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