sailfork / t3code-github / apps/ server/ src/ triage/ TriageService.ts

import {
  type AuthClientPresentationMetadata,
  ServerPrepareTriageError,
  type ServerPrepareTriageInput,
  type ServerPrepareTriageResult,
} from "@t3tools/contracts";
import * as Context from "effect/Context";
import * as Effect from "effect/Effect";
import * as FileSystem from "effect/FileSystem";
import * as Layer from "effect/Layer";
import * as Path from "effect/Path";

import packageJson from "../../package.json" with { type: "json" };
import * as ServerConfig from "../config.ts";
import * as GitVcsDriver from "../vcs/GitVcsDriver.ts";
import { buildTriageAppPrompt, type TriageSourceClone } from "./triagePrompt.ts";
import { triageSourceCacheDir, writeTriageSession } from "./triageSession.ts";

const T3CODE_REPOSITORY_URL = "https://github.com/pingdotgg/t3code";

// No tty: a credential prompt would hang until the timeout, so git must fail
// instead. An empty GIT_ASKPASS also skips core.askPass and SSH_ASKPASS helpers.
const GIT_ENV = {
  GIT_TERMINAL_PROMPT: "0",
  GIT_ASKPASS: "",
  // English messages without overriding LC_CTYPE, which a global post-checkout hook inherits.
  LANGUAGE: "C",
} satisfies NodeJS.ProcessEnv;

/** Starts in-app triage sessions: the same files `t3 triage` writes, plus a source clone. */
export class TriageService extends Context.Service<
  TriageService,
  {
    readonly prepare: (
      input: ServerPrepareTriageInput,
    ) => Effect.Effect<ServerPrepareTriageResult, ServerPrepareTriageError>;
  }
>()("t3/triage/TriageService") {}

const describeClient = (client: AuthClientPresentationMetadata) =>
  [
    client.label ?? "an unknown client",
    client.appVersion === undefined ? undefined : `version ${client.appVersion}`,
    client.os === undefined ? undefined : `on ${client.os}`,
    client.browser === undefined ? undefined : `in ${client.browser}`,
    client.webDeployment === "hosted" ? "(app.t3.codes)" : undefined,
  ]
    .filter((part) => part !== undefined)
    .join(" ");

/** Picks the release tag for `version`, or `main` when the build has no tag. */
export const pickSourceRef = (lsRemoteOutput: string, version: string) => {
  const commits = new Map(
    lsRemoteOutput
      .split("\n")
      .map((line) => line.trim().split("\t"))
      .filter((fields): fields is [string, string] => fields.length === 2)
      .map(([commit, ref]) => [ref, commit]),
  );
  const tag = `v${version}`;
  // Annotated tags list the tag object first and the commit as `^{}`.
  const tagCommit = commits.get(`refs/tags/${tag}^{}`) ?? commits.get(`refs/tags/${tag}`);
  if (tagCommit !== undefined) return { ref: tag, commit: tagCommit };
  const mainCommit = commits.get("refs/heads/main");
  return mainCommit === undefined ? undefined : { ref: "main", commit: mainCommit };
};

const make = Effect.gen(function* () {
  const config = yield* ServerConfig.ServerConfig;
  const git = yield* GitVcsDriver.GitVcsDriver;
  const fs = yield* FileSystem.FileSystem;
  const path = yield* Path.Path;
  const sourceDir = triageSourceCacheDir(config.baseDir, path);
  // Beside the cache, not in it: the playbook has agents prune the cache, and a
  // clone in progress must not look like a stale entry. Same filesystem, so the
  // finished clone moves in with a rename.
  const stagingDir = `${sourceDir}-staging`;
  const serverVersion = packageJson.version;

  const runGit = (operation: string, cwd: string, args: ReadonlyArray<string>, timeoutMs: number) =>
    git.execute({ operation: `TriageService.${operation}`, cwd, args, timeoutMs, env: GIT_ENV });

  // Clones outlive the request that started them: a fresh clone takes tens of
  // seconds, and the user is writing their description meanwhile.
  const serviceScope = yield* Effect.scope;
  // Clones a previous server process left half done.
  yield* fs.remove(stagingDir, { recursive: true }).pipe(Effect.ignore);

  // Fetches the exact commit `ls-remote` resolved, so the folder the session
  // names is the one that appears even when main moves meanwhile.
  const cloneSource = Effect.fn("TriageService.cloneSource")(function* (commit: string) {
    yield* fs.makeDirectory(stagingDir, { recursive: true });
    const staging = yield* fs.makeTempDirectory({ directory: stagingDir, prefix: "clone-" });
    const directory = path.join(sourceDir, commit);
    yield* Effect.gen(function* () {
      yield* runGit("initSource", staging, ["init", "--quiet"], 10_000);
      yield* runGit(
        "addSourceRemote",
        staging,
        ["remote", "add", "origin", T3CODE_REPOSITORY_URL],
        10_000,
      );
      yield* runGit(
        "fetchSource",
        staging,
        ["fetch", "--depth", "1", "--filter=blob:none", "origin", commit],
        600_000,
      );
      yield* runGit("checkoutSource", staging, ["checkout", "--quiet", "FETCH_HEAD"], 600_000);
      yield* fs.rename(staging, directory).pipe(
        // A concurrent session cloned the same commit first; keep theirs.
        Effect.catch((error) =>
          fs
            .exists(directory)
            .pipe(Effect.flatMap((exists) => (exists ? Effect.void : Effect.fail(error)))),
        ),
      );
    }).pipe(
      // Gone after a successful rename; otherwise a failed or losing clone.
      Effect.ensuring(fs.remove(staging, { recursive: true }).pipe(Effect.ignore)),
    );
  });

  // Release tags never move, so one lookup serves every later session. Builds
  // with no tag track main, which does move, so they look it up each time.
  let releaseSource: { readonly ref: string; readonly commit: string } | undefined;
  const resolveSource = Effect.fn("TriageService.resolveSource")(function* () {
    if (releaseSource !== undefined) return releaseSource;
    const tag = `refs/tags/v${serverVersion}`;
    const listed = yield* runGit(
      "resolveSourceRef",
      sourceDir,
      ["ls-remote", T3CODE_REPOSITORY_URL, tag, `${tag}^{}`, "refs/heads/main"],
      // Triage still starts without source; a dead network should not stall it.
      5_000,
    );
    const source = pickSourceRef(listed.stdout, serverVersion);
    if (source?.ref !== "main") releaseSource = source;
    return source;
  });

  // Commits with a clone running, so sessions started meanwhile share it.
  const cloning = new Set<string>();

  // The playbook's own layout: one folder per commit under the source cache, so
  // the agent finds and reuses this clone instead of making another. The folder
  // appears only once the clone is complete.
  const startSourceClone = Effect.fn("TriageService.startSourceClone")(function* () {
    yield* fs.makeDirectory(sourceDir, { recursive: true });
    const source = yield* resolveSource();
    if (source === undefined) {
      return {
        _tag: "failed",
        serverVersion,
        reason: "the repository listed neither the release tag nor main.",
      } satisfies TriageSourceClone;
    }
    const directory = path.join(sourceDir, source.commit);
    if (yield* fs.exists(directory)) {
      // Our clones appear only when complete, but an agent may have cloned
      // here by hand and stopped partway.
      // Without its own .git, rev-parse would read a parent repository.
      const head = (yield* fs.exists(path.join(directory, ".git")))
        ? yield* runGit("checkSource", directory, ["rev-parse", "HEAD"], 10_000).pipe(
            Effect.map((result) => result.stdout.trim()),
            Effect.orElseSucceed(() => ""),
          )
        : "";
      return head === source.commit
        ? ({ _tag: "cloned", directory, serverVersion, ...source } as const)
        : ({
            _tag: "failed",
            serverVersion,
            reason: `${directory} exists but is not a complete checkout of ${source.commit}. Remove it first.`,
          } satisfies TriageSourceClone);
    }
    if (!cloning.has(source.commit)) {
      cloning.add(source.commit);
      yield* cloneSource(source.commit).pipe(
        Effect.ignoreCause({ log: true }),
        Effect.ensuring(Effect.sync(() => cloning.delete(source.commit))),
        Effect.forkIn(serviceScope),
      );
    }
    return { _tag: "cloning", directory, serverVersion, ...source } as const;
  });

  const prepare: TriageService["Service"]["prepare"] = Effect.fn("TriageService.prepare")(
    function* (input) {
      const sourceClone = yield* startSourceClone().pipe(
        Effect.catch((error) =>
          Effect.succeed<TriageSourceClone>({
            _tag: "failed",
            serverVersion,
            reason: error.message,
          }),
        ),
      );
      const session = yield* writeTriageSession({
        baseDir: config.baseDir,
        paths: config,
        entry: { kind: "app", client: describeClient(input.client) },
        server: `running (pid ${String(process.pid)}, version ${serverVersion}); this session runs inside it`,
        sourceClone,
      }).pipe(
        Effect.provideService(FileSystem.FileSystem, fs),
        Effect.provideService(Path.Path, path),
        Effect.mapError((cause) => new ServerPrepareTriageError({ cause })),
      );
      return { prompt: buildTriageAppPrompt(session.promptFilePath) };
    },
  );

  return TriageService.of({ prepare });
});

export const layer = Layer.effect(TriageService, make);