chore(release): configure pearcecodes fork releases

Author: Pearcekieser

.github/workflows/release.yml

@@ -18,7 +18,7 @@ import { fileURLToPath } from "node:url";
 
 const isDevelopment = Boolean(process.env.VITE_DEV_SERVER_URL);
 const APP_DISPLAY_NAME = isDevelopment ? "T3 Code (Dev)" : "T3 Code (Alpha)";
-const APP_BUNDLE_ID = isDevelopment ? "com.t3tools.t3code.dev" : "com.t3tools.t3code";
+const APP_BUNDLE_ID = isDevelopment ? "com.pearcecodes.t3code.dev" : "com.pearcecodes.t3code";
 const LAUNCHER_VERSION = 2;
 
 const __dirname = dirname(fileURLToPath(import.meta.url));

apps/desktop/scripts/electron-launcher.mjs

@@ -65,7 +65,7 @@ describe("DesktopEnvironment", () => {
       assert.equal(environment.appRoot, "/repo");
       assert.equal(environment.backendEntryPath, "/repo/apps/server/dist/bin.mjs");
       assert.equal(environment.backendCwd, "/repo");
-      assert.equal(environment.appUserModelId, "com.t3tools.t3code.dev");
+      assert.equal(environment.appUserModelId, "com.pearcecodes.t3code.dev");
       assert.equal(environment.linuxWmClass, "t3code-dev");
       assert.deepEqual(
         Option.map(environment.devServerUrl, (url) => url.href),

apps/desktop/src/app/DesktopEnvironment.test.ts

@@ -199,7 +199,7 @@ const makeDesktopEnvironment = Effect.fn("desktop.environment.make")(function* (
     otlpExportIntervalMs: config.otlpExportIntervalMs,
     branding,
     displayName,
-    appUserModelId: isDevelopment ? "com.t3tools.t3code.dev" : "com.t3tools.t3code",
+    appUserModelId: isDevelopment ? "com.pearcecodes.t3code.dev" : "com.pearcecodes.t3code",
     linuxDesktopEntryName: isDevelopment ? "t3code-dev.desktop" : "t3code.desktop",
     linuxWmClass: isDevelopment ? "t3code-dev" : "t3code",
     userDataDirName,

apps/desktop/src/app/DesktopEnvironment.ts

@@ -4,11 +4,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pingdotgg/t3code",
+    "url": "https://github.com/Pearcekieser/t3code",
     "directory": "apps/server"
   },
   "bin": {
-    "t3": "./dist/bin.mjs"
+    "t3code": "./dist/bin.mjs"
   },
   "files": [
     "dist"

apps/server/package.json

@@ -20,6 +20,8 @@ import { fromJsonStringPretty } from "@t3tools/shared/schemaJson";
 import rootPackageJson from "../../../package.json" with { type: "json" };
 import serverPackageJson from "../package.json" with { type: "json" };
 
+const PublishedPackageName = "@pearcecodes/t3code";
+
 interface PackageJson {
   name: string;
   repository: {
@@ -216,7 +218,7 @@ const publishCmd = Command.make(
         Effect.gen(function* () {
           const version = Option.getOrElse(config.appVersion, () => serverPackageJson.version);
           const pkg: PackageJson = {
-            name: serverPackageJson.name,
+            name: PublishedPackageName,
             repository: serverPackageJson.repository,
             bin: serverPackageJson.bin,
             type: serverPackageJson.type,

apps/server/scripts/cli.ts

@@ -248,7 +248,7 @@ it.layer(NodeServices.layer)("bin cli parsing", (it) => {
       if (error._tag !== "ShowHelp") {
         assert.fail(`Expected ShowHelp, got ${error._tag}`);
       }
-      assert.deepEqual(error.commandPath, ["t3", "auth", "pairing", "create"]);
+      assert.deepEqual(error.commandPath, ["t3code", "auth", "pairing", "create"]);
       const ttlError = error.errors[0] as CliError.CliError | undefined;
       if (!ttlError || ttlError._tag !== "InvalidValue") {
         assert.fail(`Expected InvalidValue, got ${String(ttlError?._tag)}`);
@@ -351,7 +351,7 @@ it.layer(NodeServices.layer)("bin cli parsing", (it) => {
       if (error._tag !== "ShowHelp") {
         assert.fail(`Expected ShowHelp, got ${error._tag}`);
       }
-      assert.deepEqual(error.commandPath, ["t3", "project", "add"]);
+      assert.deepEqual(error.commandPath, ["t3code", "project", "add"]);
       const optionError = error.errors[0] as CliError.CliError | undefined;
       if (!optionError || optionError._tag !== "UnrecognizedOption") {
         assert.fail(`Expected UnrecognizedOption, got ${String(optionError?._tag)}`);

apps/server/src/bin.test.ts

@@ -13,7 +13,7 @@ import { runServerCommand, serveCommand, startCommand } from "./cli/server.ts";
 
 const CliRuntimeLayer = Layer.mergeAll(NodeServices.layer, NetService.layer);
 
-export const cli = Command.make("t3", { ...sharedServerCommandFlags }).pipe(
+export const cli = Command.make("t3code", { ...sharedServerCommandFlags }).pipe(
   Command.withDescription("Run the T3 Code server."),
   Command.withHandler((flags) => runServerCommand(flags)),
   Command.withSubcommands([startCommand, serveCommand, authCommand, projectCommand]),

apps/server/src/bin.ts

@@ -0,0 +1,68 @@
+# Pearcecodes Fork Release Setup
+
+This fork is configured for public GitHub Releases, Blacksmith runners, macOS
+signing when Apple credentials are present, and npm publishing under the
+`pearcecodes` npm organization.
+
+## P1 release setup
+
+### GitHub
+
+- Repository: `Pearcekieser/t3code`
+- Keep the repository public so GitHub Releases can be used directly by
+  `electron-updater`.
+- Enable GitHub Actions for the fork.
+- Install the Blacksmith GitHub app for this repository.
+- In repository Actions settings, allow workflows to create and approve pull
+  requests if needed, and set workflow permissions to allow read/write tokens.
+
+The release workflow uses the built-in `GITHUB_TOKEN` for GitHub Releases and
+stable-version bump commits. It does not require a custom release GitHub App.
+
+### npm
+
+- Package: `@pearcecodes/t3code`
+- Binary: `t3code`
+- Access: public
+- Dist-tags:
+  - stable releases publish `latest`
+  - nightly releases publish `nightly`
+
+The internal workspace package remains named `t3` so Effect deterministic
+service keys keep matching source paths. The release publish script rewrites the
+published package name to `@pearcecodes/t3code` immediately before `npm publish`.
+
+Configure npm trusted publishing for `@pearcecodes/t3code`:
+
+- Provider: GitHub Actions
+- Repository: `Pearcekieser/t3code`
+- Workflow file: `.github/workflows/release.yml`
+
+The npm publish job intentionally uses a GitHub-hosted runner, because npm
+trusted publishing does not currently support self-hosted runners. Keep the
+desktop build jobs on Blacksmith, but keep `publish_cli` on `ubuntu-24.04`
+unless this npm restriction changes.
+
+### Apple signing and notarization
+
+Add these GitHub Actions secrets after enrolling in the Apple Developer Program:
+
+- `CSC_LINK`: base64-encoded `.p12` export of the Developer ID Application
+  certificate and private key
+- `CSC_KEY_PASSWORD`: password for the `.p12`
+- `APPLE_API_KEY`: raw App Store Connect API key `.p8` contents
+- `APPLE_API_KEY_ID`: App Store Connect API key ID
+- `APPLE_API_ISSUER`: App Store Connect issuer ID
+
+If any of these are missing, macOS release artifacts are built unsigned.
+
+## P2 hosted web app
+
+The Vercel deployment is intentionally deferred. Planned domains:
+
+- router: `https://code.pearcecodes.com`
+- stable: `latest.code.pearcecodes.com`
+- nightly: `nightly.code.pearcecodes.com`
+
+Before enabling the Vercel job, make `apps/web/vercel.ts` use environment-driven
+hostnames instead of hardcoded `app.t3.codes` origins.