feat(packaging): add deb and rpm desktop targets

.gitignore

@@ -14,6 +14,7 @@ build/
 .logs/
 release/
 release-mock/
+packaging-output/
 .t3
 .idea/
 apps/web/.playwright

package.json

@@ -33,6 +33,8 @@
     "dist:desktop:dmg:arm64": "node scripts/build-desktop-artifact.ts --platform mac --target dmg --arch arm64",
     "dist:desktop:dmg:x64": "node scripts/build-desktop-artifact.ts --platform mac --target dmg --arch x64",
     "dist:desktop:linux": "node scripts/build-desktop-artifact.ts --platform linux --target AppImage --arch x64",
+    "dist:desktop:deb": "node scripts/build-desktop-artifact.ts --platform linux --target deb --arch x64 --output-dir packaging-output",
+    "dist:desktop:rpm": "node scripts/build-desktop-artifact.ts --platform linux --target rpm --arch x64 --output-dir packaging-output",
     "dist:desktop:win": "node scripts/build-desktop-artifact.ts --platform win --target nsis",
     "dist:desktop:win:arm64": "node scripts/build-desktop-artifact.ts --platform win --target nsis --arch arm64",
     "dist:desktop:win:x64": "node scripts/build-desktop-artifact.ts --platform win --target nsis --arch x64",

scripts/build-desktop-artifact.test.ts

@@ -498,6 +498,43 @@ it.layer(NodeServices.layer)("build-desktop-artifact", (it) => {
     }).pipe(Effect.provide(ConfigProvider.layer(ConfigProvider.fromEnv({ env: {} })))),
   );
 
+  it.effect("includes distribution metadata in Linux package builds", () =>
+    Effect.gen(function* () {
+      const config = yield* createBuildConfig(
+        "linux",
+        "deb",
+        "1.2.3",
+        false,
+        false,
+        undefined,
+        undefined,
+      );
+
+      const linux = config.linux as Record<string, unknown>;
+      assert.deepStrictEqual(linux.target, ["deb"]);
+      assert.equal(linux.executableName, "t3code");
+      assert.equal(linux.category, "Development");
+      assert.equal(linux.maintainer, "T3 Tools <support@t3.gg>");
+      assert.equal(linux.vendor, "T3 Tools");
+      assert.equal(linux.synopsis, "A desktop GUI for AI coding agents");
+      assert.equal(linux.syncDesktopName, true);
+
+      const deb = config.deb as Record<string, unknown>;
+      assert.deepStrictEqual(deb.depends, [
+        "libgtk-3-0",
+        "libnotify4",
+        "libnss3",
+        "libxss1",
+        "libxtst6",
+        "xdg-utils",
+        "libatspi2.0-0",
+        "libuuid1",
+        "libsecret-1-0",
+        "libasound2t64 | libasound2",
+      ]);
+    }).pipe(Effect.provide(ConfigProvider.layer(ConfigProvider.fromEnv({ env: {} })))),
+  );
+
   it("promotes target fff binaries to direct staged dependencies", () => {
     assert.deepStrictEqual(resolveFffNativeDependencies("mac", "arm64", "0.9.4"), {
       "@ff-labs/fff-bin-darwin-arm64": "0.9.4",

scripts/build-desktop-artifact.ts

@@ -112,6 +112,19 @@ const PLATFORM_CONFIG: Record<typeof BuildPlatform.Type, PlatformConfig> = {
   },
 };
 
+const DEB_DEPENDENCIES = [
+  "libgtk-3-0",
+  "libnotify4",
+  "libnss3",
+  "libxss1",
+  "libxtst6",
+  "xdg-utils",
+  "libatspi2.0-0",
+  "libuuid1",
+  "libsecret-1-0",
+  "libasound2t64 | libasound2",
+] as const;
+
 interface BuildCliInput {
   readonly platform: Option.Option<typeof BuildPlatform.Type>;
   readonly target: Option.Option<string>;
@@ -570,6 +583,9 @@ interface StagePackageJson {
   readonly packageManager: string;
   readonly description: string;
   readonly author: string;
+  readonly homepage: string;
+  readonly license: string;
+  readonly desktopName: string;
   readonly main: string;
   readonly build: Record<string, unknown>;
   readonly dependencies: Record<string, unknown>;
@@ -1447,12 +1463,22 @@ export const createBuildConfig = Effect.fn("createBuildConfig")(function* (
       executableName: "t3code",
       icon: "icons",
       category: "Development",
+      maintainer: "T3 Tools <support@t3.gg>",
+      vendor: "T3 Tools",
+      synopsis: "A desktop GUI for AI coding agents",
+      syncDesktopName: true,
       desktop: {
         entry: {
           StartupWMClass: "t3code",
         },
       },
     };
+
+    if (target === "deb") {
+      buildConfig.deb = {
+        depends: [...DEB_DEPENDENCIES],
+      };
+    }
   }
 
   if (platform === "win") {
@@ -1760,8 +1786,11 @@ const buildDesktopArtifact = Effect.fn("buildDesktopArtifact")(function* (
     t3codeCommitHash: commitHash,
     private: true,
     packageManager: rootPackageJson.packageManager,
-    description: "T3 Code desktop build",
-    author: "T3 Tools",
+    description: "A desktop GUI for AI coding agents such as Codex, Claude, Cursor, and OpenCode.",
+    author: "T3 Tools <support@t3.gg>",
+    homepage: "https://github.com/pingdotgg/t3code",
+    license: "MIT",
+    desktopName: "t3code.desktop",
     main: "apps/desktop/dist-electron/main.cjs",
     build: yield* createBuildConfig(
       options.platform,