Method clone

packages/diffs/src/codebase/codebase.ts:34–67

* Shells out to `cloneRepository()` from `@autonoma/github` and returns a * `Codebase` rooted at `targetDir`. Clears `targetDir` first so a dangling * tree from a previous crashed run never interferes with the fresh clone. * Throws on any failure (removing the partially-populated `tar

(
        githubClient: GitHubInstallationClient,
        targetDir: string,
        opts: { repoName: string; commitSha: string; baseSha?: string },
    )

 * is a parent directory holding the primary repo plus every dependency as named
 * sibling directories. The `bash` tool runs in `root` either way, so a
 * single-repo checkout behaves exactly as before, while a multi-repo workspace
 * lets the agent reach every repo by its sibling directory name.
 *
 * Get one via `Codebase.clone(...)` (single repo) or `Codebase.cloneWorkspace(...)`
 * (multi-repo), or construct directly (`new Codebase(path)`) when you already
 * have a populated single-repo tree (tests). Reuse across operations is the
 * default; call `dispose()` explicitly to remove the whole workspace.
 *
 * The research agents read the tree through the read-only `bash` tool, which
 * runs shell commands with `root` as its working directory - the `Codebase`
 * itself no longer offers file/search helpers. The agent is trusted internal
 * code reading the user's own repo, so traversal is not sandboxed: a command
 * that escapes `root` (absolute paths, symlinks) gets whatever the shell
 * returns, same as running it yourself.
 */
export class Codebase {
    private readonly logger: Logger;

    /** Every repo checked out in this workspace, primary first. */
    public readonly repos: RepoCheckout[];
    /** Dependencies that were expected but could not be checked out. */
    public readonly unavailableRepos: UnavailableRepo[];

    constructor(
        public readonly root: string,
        repos?: RepoCheckout[],
        unavailableRepos?: UnavailableRepo[],
    ) {
        this.repos = repos ?? [{ name: "primary", role: "primary", relPath: ".", dir: root, headSha: "" }];
        this.unavailableRepos = unavailableRepos ?? [];
        this.logger = rootLogger.child({ name: this.constructor.name, root });
    }

    /** The primary repo checkout (the application's own repo). */
    get primary(): RepoCheckout {
        const primary = this.repos.find((r) => r.role === "primary");
        if (primary == null) throw new Error("Codebase has no primary repo");