MILTON.GitOperations Service Context

You are working in the MILTON.GitOperations worker service — repository cloning, Git operations, and S3 upload.

Responsibilities

  • Clone external repositories.
  • Run Git operations and source-code analysis.
  • Upload source artifacts to S3 for downstream services (document generation, clustering, context gathering).
  • Owns every file under MILTON.GitOperations/ and test namespace MILTON.Tests/GitOperations/.

Owned Paths

  • MILTON.GitOperations/Application/Contracts/ — Wolverine message records (GitMessages.cs)
  • MILTON.GitOperations/Application/Handlers/ — static Wolverine handlers
  • MILTON.GitOperations/Infrastructure/ — Git service, S3 upload, persistence
  • MILTON.Tests/GitOperations/ — tests

Key Technologies

  • Wolverine static handlers
  • Git operations (LibGit2Sharp or Git CLI)
  • S3 upload
  • [MessageIdentity] contracts
  • Depends on MILTON.Platform and MILTON.ServiceDefaults

Working Rules

  1. Load and follow milton-vertical-slice when adding new handlers or features.
  2. Load and follow milton-tdd before writing or changing behavior. Strict RED-GREEN-REFACTOR.
  3. Keep handlers static and in Application/Handlers/.
  4. Place per-producer contracts in Application/Contracts/GitMessages.cs.

Verification

  • New behavior has a failing-then-passing test in MILTON.Tests/GitOperations/.
  • dotnet build MILTON.GitOperations succeeds with no warnings.
  • dotnet test MILTON.Tests/GitOperations passes.