Class CliGitSourceRepository

constructor

• new CliGitSourceRepository(
      dir: string,
      logger?: Logger,
      excludePatterns?: string[],
  ): CliGitSourceRepository

  Parameters

  • dir: string
  • Optionallogger: Logger
  • OptionalexcludePatterns: string[]

  Returns CliGitSourceRepository

Readonlyname

ReadonlyrootUri

Readonlytype

getChangedFilesSince

• getChangedFilesSince(
      prevRevision: string,
      patterns?: string[],
  ): Promise<
      { added: string[]; deleted: string[]; modified: string[] }
      | null,
  >

  Files changed since a given revision. patterns is an optional hint — implementations that support path filtering use it; others return all changed files for the caller to filter. Returns null when the revision is unknown → caller falls back to full scan.

  Parameters

  • prevRevision: string
  • Optionalpatterns: string[]

  Returns Promise<{ added: string[]; deleted: string[]; modified: string[] } | null>

getCodeownersLabels

• getCodeownersLabels(filePath: string): Promise<string[]>

  Returns CODEOWNERS-derived labels for a file (relative path, forward slashes).

  Parameters

  • filePath: string

  Returns Promise<string[]>

getCodeownersResolver

• getCodeownersResolver(): Promise<CodeownersResolver | null>

  Returns the CODEOWNERS resolver for this repo (lazy-loaded, cached).

  Returns Promise<CodeownersResolver | null>

getContext

• getContext(): Promise<string>

  Optional: a human-readable context label. Git: current branch name. S3: bucket + prefix.

  Returns Promise<string>

getCurrentRevision

• getCurrentRevision(): Promise<string>

  An opaque revision identifier covering the whole source. Git: HEAD commit SHA. S3: manifest hash or max version timestamp. Changes whenever any file in the source changes.

  Returns Promise<string>

getFileRevisions

• getFileRevisions(
      files: string[],
      onProgress?: (done: number, total: number) => void,
  ): Promise<Map<string, string>>

  A stable per-file content identifier. CLI git: blob SHA (content-addressed, stable across rebases). S3: ETag (content MD5). Local FS: SHA-256 of file bytes. Changes when and only when file content changes.

  Parameters

  • files: string[]
  • OptionalonProgress: (done: number, total: number) => void

  Returns Promise<Map<string, string>>

getPendingChanges

• getPendingChanges(): Promise<Set<string>>

  Optional: files modified but not yet "committed" to the source. Git: uncommitted working-tree changes. S3 / local FS: return empty Set.

  Returns Promise<Set<string>>

listAll

• listAll(filter?: SourceFilter): AsyncIterable<SourceItem>

  Enumerate all tracked files in HEAD as SourceItems. Labels are pre-populated from CODEOWNERS for each file.

  Parameters

  • Optionalfilter: SourceFilter

  Returns AsyncIterable<SourceItem>