@repolensai/cli 0.1.1

package/lib/auth-store.d.ts

@@ -0,0 +1,21 @@
+export type StoredCliAuthConfig = {
+  appUrl: string | null;
+  token: string | null;
+  user?: { email?: string | null } | null;
+  loggedInAt?: string | null;
+  tokenStore?: {
+    type: "keychain" | "file";
+    service?: string | null;
+    account?: string | null;
+  } | null;
+};
+
+export function buildCliKeychainDescriptor(
+  appUrl: string | null | undefined,
+  email: string | null | undefined,
+): {
+  service: string;
+  account: string;
+};
+
+export function normalizeStoredCliAuthConfig(raw: unknown): StoredCliAuthConfig | null;

package/lib/auth-store.mjs

@@ -0,0 +1,68 @@
+/**
+ * @typedef {{
+ *   appUrl: string | null;
+ *   token: string | null;
+ *   user?: { email?: string | null } | null;
+ *   loggedInAt?: string | null;
+ *   tokenStore?: {
+ *     type: "keychain" | "file";
+ *     service?: string | null;
+ *     account?: string | null;
+ *   } | null;
+ * }} StoredCliAuthConfig
+ */
+
+const KEYCHAIN_SERVICE_PREFIX = "com.repolens.cli";
+
+/**
+ * @param {string | null | undefined} appUrl
+ * @param {string | null | undefined} email
+ */
+export function buildCliKeychainDescriptor(appUrl, email) {
+  const normalizedAppUrl = (appUrl ?? "").trim().replace(/\/$/, "");
+  const normalizedEmail = (email ?? "").trim().toLowerCase() || "default";
+
+  return {
+    service: normalizedAppUrl
+      ? `${KEYCHAIN_SERVICE_PREFIX}:${normalizedAppUrl}`
+      : KEYCHAIN_SERVICE_PREFIX,
+    account: normalizedEmail,
+  };
+}
+
+/**
+ * @param {unknown} raw
+ * @returns {StoredCliAuthConfig | null}
+ */
+export function normalizeStoredCliAuthConfig(raw) {
+  if (!raw || typeof raw !== "object") {
+    return null;
+  }
+
+  const candidate = /** @type {Record<string, unknown>} */ (raw);
+  const tokenStore = candidate.tokenStore && typeof candidate.tokenStore === "object"
+    ? /** @type {Record<string, unknown>} */ (candidate.tokenStore)
+    : null;
+
+  return {
+    appUrl: typeof candidate.appUrl === "string" ? candidate.appUrl : null,
+    token: typeof candidate.token === "string" ? candidate.token : null,
+    user: candidate.user && typeof candidate.user === "object"
+      ? /** @type {{email?: string | null}} */ (candidate.user)
+      : null,
+    loggedInAt: typeof candidate.loggedInAt === "string" ? candidate.loggedInAt : null,
+    tokenStore: tokenStore && tokenStore.type === "keychain"
+      ? {
+          type: "keychain",
+          service: typeof tokenStore.service === "string" ? tokenStore.service : null,
+          account: typeof tokenStore.account === "string" ? tokenStore.account : null,
+        }
+      : tokenStore && tokenStore.type === "file"
+        ? {
+            type: "file",
+            service: null,
+            account: null,
+          }
+        : null,
+  };
+}

package/lib/git-history.d.ts

@@ -0,0 +1,214 @@
+export interface EvolutionCommit {
+  sha: string;
+  date: string;
+  author: string;
+  subject: string;
+}
+
+export interface EvolutionAuthorStat {
+  author: string;
+  commits: number;
+}
+
+export interface CommitTheme {
+  label: string;
+  commits: number;
+  examples: string[];
+}
+
+export interface HotspotFileStat {
+  filePath: string;
+  additions: number;
+  deletions: number;
+  touchedCommits: number;
+  score: number;
+}
+
+export interface DirectoryStat {
+  directoryPath: string;
+  fileCount: number;
+  touchedCommits: number;
+  additions: number;
+  deletions: number;
+  score: number;
+}
+
+export interface RenameHistoryEntry {
+  commit: string;
+  fromPath: string;
+  toPath: string;
+}
+
+export interface OwnershipAuthorStat {
+  author: string;
+  commits: number;
+  lastTouchedAt: string;
+  lastSubject: string;
+}
+
+export interface BlameOwnerStat {
+  author: string;
+  lines: number;
+  commits: number;
+}
+
+export interface FileOwnerStat {
+  filePath: string;
+  primaryOwner: string;
+  ownerCommits: number;
+  touchedCommits: number;
+  lastTouchedAt: string;
+  lastSubject: string;
+  additions: number;
+  deletions: number;
+}
+
+export interface ReadingOrderEntry {
+  path: string;
+  reason: string;
+}
+
+export interface TraceScoreBreakdown {
+  path: number;
+  content: number;
+  symbol: number;
+  definition: number;
+  hotspot: number;
+  history: number;
+  ownership: number;
+  blame: number;
+  rename: number;
+  total: number;
+}
+
+export interface TraceMatchLine {
+  filePath: string;
+  lineNumber: number;
+  preview: string;
+}
+
+export function collectEvolutionReport(params: {
+  cwd: string;
+  targetPath: string;
+  sinceRef?: string | null;
+  limit?: number;
+  exec: (args: string[], runtimeOptions?: { allowFailure?: boolean }) => string;
+}): {
+  targetPath: string;
+  pathKind: "file" | "directory";
+  sinceRef: string | null;
+  generatedAt: string;
+  trackedFileCount: number;
+  commitCount: number;
+  commits: EvolutionCommit[];
+  authors: EvolutionAuthorStat[];
+  fileStats: HotspotFileStat[];
+  topFiles: HotspotFileStat[];
+  directoryStats: DirectoryStat[];
+  commitThemes: CommitTheme[];
+  whyChanged: string;
+  renameHistory: RenameHistoryEntry[];
+};
+
+export function collectHotspotReport(params: {
+  sinceRef?: string;
+  limit?: number;
+  exec: (args: string[], runtimeOptions?: { allowFailure?: boolean }) => string;
+}): {
+  sinceRef: string;
+  generatedAt: string;
+  files: HotspotFileStat[];
+};
+
+export function collectOwnershipReport(params: {
+  cwd: string;
+  targetPath: string;
+  sinceRef?: string | null;
+  limit?: number;
+  exec: (args: string[], runtimeOptions?: { allowFailure?: boolean }) => string;
+}): {
+  targetPath: string;
+  pathKind: "file" | "directory";
+  sinceRef: string | null;
+  generatedAt: string;
+  trackedFileCount: number;
+  owners: OwnershipAuthorStat[];
+  blameOwners: BlameOwnerStat[];
+  fileOwners: FileOwnerStat[];
+  renameHistory: RenameHistoryEntry[];
+};
+
+export function collectStartHereReport(params: {
+  cwd: string;
+  targetPath: string;
+  sinceRef?: string | null;
+  limit?: number;
+  exec: (args: string[], runtimeOptions?: { allowFailure?: boolean }) => string;
+}): {
+  targetPath: string;
+  pathKind: "file" | "directory";
+  sinceRef: string | null;
+  generatedAt: string;
+  trackedFileCount: number;
+  summary: string;
+  commitThemes: CommitTheme[];
+  whyChanged: string;
+  readingOrder: ReadingOrderEntry[];
+  hotspotFiles: HotspotFileStat[];
+  directoryStats: DirectoryStat[];
+  owners: OwnershipAuthorStat[];
+  fileOwners: FileOwnerStat[];
+  recentCommits: EvolutionCommit[];
+  renameHistory: RenameHistoryEntry[];
+};
+
+export function collectTraceReport(params: {
+  cwd: string;
+  query: string;
+  sinceRef?: string | null;
+  limit?: number;
+  exec: (args: string[], runtimeOptions?: { allowFailure?: boolean }) => string;
+}): {
+  query: string;
+  sinceRef: string | null;
+  generatedAt: string;
+  matches: Array<{
+    filePath: string;
+    score: number;
+    matchType: string;
+    matchSignals: string[];
+    matchedLines: TraceMatchLine[];
+    scoreBreakdown: TraceScoreBreakdown;
+    evolution: ReturnType<typeof collectEvolutionReport>;
+    ownership: ReturnType<typeof collectOwnershipReport>;
+  }>;
+};
+
+export function parseCommitLog(raw: string): EvolutionCommit[];
+export function parseNumstatLog(raw: string): Array<{
+  commit: string;
+  filePath: string;
+  additions: number;
+  deletions: number;
+}>;
+export function parseBlamePorcelain(raw: string): Array<{
+  commit: string;
+  author: string;
+  lineCount: number;
+}>;
+export function parseGrepResults(raw: string): TraceMatchLine[];
+export function parseNameStatusLog(raw: string): Array<{
+  commit: string;
+  status: string;
+  fromPath: string;
+  toPath: string | null;
+}>;
+export function parseDetailedNumstatLog(raw: string): Array<{
+  commit: string;
+  date: string;
+  author: string;
+  subject: string;
+  filePath: string;
+  additions: number;
+  deletions: number;
+}>;