System Architecture

src/
├── cli.ts              # CLI entry point
├── index.ts            # Library exports
├── commands/           # CLI command handlers (75+ commands)
├── core/               # Git implementation
│   ├── repository.ts   # Main Repository class
│   ├── object.ts       # Git objects (blob, tree, commit, tag)
│   ├── object-store.ts # Object persistence
│   ├── index.ts        # Staging area
│   ├── refs.ts         # References (branches, tags)
│   ├── protocol/       # Git protocols (Smart HTTP, SSH)
│   └── storage/        # Storage backends
├── server/             # Server infrastructure
│   ├── routes/         # HTTP endpoints
│   ├── ssh/            # SSH server
│   ├── middleware/     # Auth, rate limiting
│   └── sandbox/        # Code execution sandboxes
├── api/                # tRPC API layer
│   └── trpc/           # tRPC routers
├── db/                 # Database schema
│   ├── schema.ts       # Drizzle schema
│   └── auth-schema.ts  # Authentication tables
├── ai/                 # AI features
│   ├── agent.ts        # AI coding agent
│   ├── tools/          # Agent tools
│   └── workflows/      # Multi-step workflows
├── events/             # Event-driven architecture
│   ├── bus.ts          # Event bus
│   └── handlers/       # Event handlers
├── ui/                 # Terminal and web UI
├── search/             # Semantic code search
├── primitives/         # Core abstractions
└── ci/                 # CI/CD execution

class Repository {
  readonly gitDir: string;      // .wit directory
  readonly workDir: string;     // Working directory
  readonly objects: ObjectStore; // Git objects
  readonly index: Index;         // Staging area
  readonly refs: Refs;           // Branches, tags
  readonly journal: Journal;     // Undo history
  readonly mergeManager: MergeManager;
  readonly remotes: RemoteManager;
  // ... more managers
}

interface StorageBackend {
  read(path: string): Promise<Buffer>;
  write(path: string, data: Buffer): Promise<void>;
  exists(path: string): Promise<boolean>;
  delete(path: string): Promise<void>;
  list(prefix: string): Promise<string[]>;
}

// Server
export const repoRouter = router({
  get: protectedProcedure
    .input(z.object({ owner: z.string(), name: z.string() }))
    .query(async ({ input }) => { ... }),
});

// Client - fully typed
const repo = await trpc.repo.get.query({ owner: 'user', name: 'repo' });

export async function myCommand(options: MyOptions) {
  const repo = await Repository.find(process.cwd());
  // Implementation
}

export const myTool = createTool({
  id: 'my-tool',
  description: 'Does something',
  inputSchema: z.object({ ... }),
  execute: async ({ input, context }) => { ... },
});

export function registerMyHandlers() {
  eventBus.on('pr.created', async (event) => {
    // Handle event
  });
}

export const myRouter = router({
  myProcedure: protectedProcedure
    .input(schema)
    .mutation(async ({ input, ctx }) => { ... }),
});

# Required
DATABASE_URL=postgresql://user:pass@host:5432/wit

# Optional - AI features
ANTHROPIC_API_KEY=sk-...
OPENAI_API_KEY=sk-...

# Optional - External integrations
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...

# Optional - Sandbox providers
E2B_API_KEY=...
DAYTONA_API_KEY=...