gutterpress 0.10.10-alpha.1 → 0.10.10-alpha.3

package/dist/api/index.d.ts

@@ -70,7 +70,7 @@ export { connectGenericHost, knownForgeTokenUrl, } from "../lib/remote-auth/gene
 export type { GenericTokenConnectInput, GenericAuthOptions, } from "../lib/remote-auth/generic-auth.ts";
 export { diagnoseProjectRemote, parseRemoteOrigin, forgeKindForHost, } from "../lib/remote-auth/diagnose.ts";
 export type { ProjectRemoteDiagnosis, DiagnoseProjectRemoteOptions, RemoteProtocol, RemoteGuidanceId, ForgeKind, } from "../lib/remote-auth/diagnose.ts";
-export { syncProject, SYNC_SNAPSHOT_MESSAGE, } from "../lib/remote-auth/sync.ts";
+export { syncProject, refreshRemoteCopies, SYNC_SNAPSHOT_MESSAGE, } from "../lib/remote-auth/sync.ts";
 export type { SyncOutcome, SyncProjectOptions, KeptBothFile, } from "../lib/remote-auth/sync.ts";
 export type { SnapshotEntry, InitVersionHistoryOptions, SnapshotOptions, RestoreSnapshotOptions, RestoreVersionOptions, RestoreVersionResult, SourceProvider, } from "../lib/source-provider.ts";
 export { runPublish, resolvePublishRequest, resolvePublishFormat, } from "../lib/publish/run-publish.ts";

package/dist/api/index.js

@@ -90,6 +90,7 @@ import {
   readManifestFields,
   readPublishSettings,
   readSnippet,
+  refreshRemoteCopies,
   removeExtension,
   reorderExtensions,
   requireGoogleClientCredentials,
@@ -123,7 +124,7 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "../index-d4wrww4b.js";
+} from "../index-ryjmpyq6.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
@@ -140,7 +141,7 @@ import {
   resolveLogger,
   restoreVersionWithBackup,
   switchBranch
-} from "../index-f833dtg9.js";
+} from "../index-y01v2fe0.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -188,6 +189,7 @@ export {
   repoRootForSource,
   reorderExtensions,
   removeExtension,
+  refreshRemoteCopies,
   readyProbeExpr,
   readSnippet,
   readPublishSettings,

package/dist/{audit-ek36tf4q.js → audit-sb0abmqy.js}

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{build-bxavfz3j.js → build-e54deg18.js}

@@ -1,23 +1,23 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   parseFormat,
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{cli-tvpq2ht9.js → cli-1prnz7c8.js}

@@ -4,7 +4,7 @@ import {
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.10-alpha.1",
+  version: "0.10.10-alpha.3",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",

package/dist/{cli-vje8g3w8.js → cli-4mtf9ajw.js}

@@ -509,13 +509,45 @@ async function listLocalBranches(dir) {
   if (source.type !== "local-git-folder")
     return null;
   const repoDir = gitScopeFor(source);
-  const [branches, current] = await Promise.all([
+  const [local, current, remotes] = await Promise.all([
     git.listBranches({ fs: gitFs, dir: repoDir }),
     git.currentBranch({ fs: gitFs, dir: repoDir, fullname: false }).catch(() => {
       return;
-    })
+    }),
+    git.listRemotes({ fs: gitFs, dir: repoDir }).catch(() => [])
   ]);
-  return { current: current ?? null, branches };
+  const localNames = new Set(local);
+  const remoteOnly = new Set;
+  for (const { remote } of remotes) {
+    const names = await git.listBranches({ fs: gitFs, dir: repoDir, remote }).catch(() => []);
+    for (const name of names) {
+      if (name === "HEAD")
+        continue;
+      if (!localNames.has(name))
+        remoteOnly.add(name);
+    }
+  }
+  return {
+    current: current ?? null,
+    branches: [...localNames, ...remoteOnly].sort(),
+    remoteOnly: [...remoteOnly].sort()
+  };
+}
+async function resolveCopy(repoDir, branch) {
+  const local = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: `refs/heads/${branch}` }).catch(() => {
+    return;
+  });
+  if (local)
+    return { oid: local };
+  const remotes = await git.listRemotes({ fs: gitFs, dir: repoDir }).catch(() => []);
+  for (const { remote } of remotes) {
+    const oid = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: `refs/remotes/${remote}/${branch}` }).catch(() => {
+      return;
+    });
+    if (oid)
+      return { oid, remote };
+  }
+  throw new Error(`Couldn't find a copy named "${branch}" — it may have been renamed or deleted.`);
 }
 function isCheckoutConflictError(e) {
   return e?.code === "CheckoutConflictError";
@@ -574,9 +606,16 @@ async function switchBranch(options) {
     const fromOid = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: "HEAD" }).catch(() => {
       return;
     });
-    const toOid = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: branch });
+    const { oid: toOid, remote } = await resolveCopy(repoDir, branch);
     try {
-      await git.checkout({ fs: gitFs, dir: repoDir, cache, ref: branch, force: false });
+      await git.checkout({
+        fs: gitFs,
+        dir: repoDir,
+        cache,
+        ref: branch,
+        force: false,
+        ...remote ? { remote } : {}
+      });
     } catch (e) {
       if (isCheckoutConflictError(e)) {
         throw new Error("Couldn't switch copies — some files changed on disk right as the switch " + "started. Try again.", { cause: e });

package/dist/{cli-12epgrva.js → cli-d7k5ykyx.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import {
   execCapture,
   findTool,

package/dist/{cli-5fqr02je.js → cli-x4krgssg.js}

@@ -13,12 +13,12 @@ import {
   stampCreator,
   stripAnnotations,
   warn
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   DEBOUNCE,
   UsageError,
   resolvePort
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import {
   MARGIN_BOX_IGNORED_PROPERTIES,
   RENDER_TIMEOUT_MS,
@@ -42,7 +42,7 @@ import {
 } from "./cli-46ycxe6r.js";
 import {
   hasUncommittedChanges
-} from "./cli-vje8g3w8.js";
+} from "./cli-4mtf9ajw.js";
 import {
   detectProjectSource
 } from "./cli-v5mp7a6q.js";
@@ -11421,7 +11421,7 @@ async function scaffoldProject(options) {
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-2cnc5hry.js");
+      const { providerFor } = await import("./source-provider-51g6mt6y.js");
       const provider = providerFor({ type: "local-folder", path: projectDir });
       await provider.initVersionHistory({
         projectDir,

package/dist/cli.js

@@ -6,7 +6,7 @@ import {
   UsageError,
   package_default,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
@@ -18,16 +18,16 @@ import {
 import { defineCommand, parseArgs, runMain } from "citty";
 import { statSync } from "node:fs";
 var SUBCOMMANDS = {
-  new: () => import("./new-qws45t02.js").then((m) => m.default),
-  preview: () => import("./preview-4c3tcsn4.js").then((m) => m.default),
-  build: () => import("./build-bxavfz3j.js").then((m) => m.default),
-  publish: () => import("./publish-m6bme9a8.js").then((m) => m.default),
-  lint: () => import("./lint-5vbq6yjb.js").then((m) => m.default),
-  validate: () => import("./validate-avtb9drn.js").then((m) => m.default),
-  audit: () => import("./audit-ek36tf4q.js").then((m) => m.default),
-  preflight: () => import("./preflight-4ywt3399.js").then((m) => m.default),
-  doctor: () => import("./doctor-tgmedr7g.js").then((m) => m.default),
-  ext: () => import("./ext-jjzmafve.js").then((m) => m.default)
+  new: () => import("./new-wyhadpt4.js").then((m) => m.default),
+  preview: () => import("./preview-w9bp0fgf.js").then((m) => m.default),
+  build: () => import("./build-e54deg18.js").then((m) => m.default),
+  publish: () => import("./publish-9fn1hjmb.js").then((m) => m.default),
+  lint: () => import("./lint-2pgsfsp6.js").then((m) => m.default),
+  validate: () => import("./validate-v9abv9xs.js").then((m) => m.default),
+  audit: () => import("./audit-sb0abmqy.js").then((m) => m.default),
+  preflight: () => import("./preflight-wbfd5ma1.js").then((m) => m.default),
+  doctor: () => import("./doctor-es2cw92p.js").then((m) => m.default),
+  ext: () => import("./ext-06srzer2.js").then((m) => m.default)
 };
 var VERSION = package_default.version;
 var main = defineCommand({
@@ -52,7 +52,7 @@ async function preflightRequiredInvocations(rawArgs) {
   const [command, ...commandArgs] = rawArgs;
   try {
     if (command === "new") {
-      const { newArgs } = await import("./new-qws45t02.js");
+      const { newArgs } = await import("./new-wyhadpt4.js");
       rejectUnknownFlags(commandArgs, newArgs, "new");
       const parsed = parseArgs(commandArgs, {
         ...newArgs,
@@ -64,7 +64,7 @@ async function preflightRequiredInvocations(rawArgs) {
       return;
     }
     if (command === "preflight") {
-      const { preflightArgs } = await import("./preflight-4ywt3399.js");
+      const { preflightArgs } = await import("./preflight-wbfd5ma1.js");
       rejectUnknownFlags(commandArgs, preflightArgs, "preflight");
       const parsed = parseArgs(commandArgs, {
         ...preflightArgs,
@@ -84,7 +84,7 @@ async function preflightRequiredInvocations(rawArgs) {
       }
       if (subcommand.startsWith("-"))
         return;
-      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-jjzmafve.js");
+      const { EXT_SUBCOMMANDS, extAddArgs, extRemoveArgs, extEnableArgs, extDisableArgs } = await import("./ext-06srzer2.js");
       if (!EXT_SUBCOMMANDS.includes(subcommand)) {
         throw new UsageError(`gutterpress ext: unknown command "${subcommand}"`);
       }

package/dist/{doctor-tgmedr7g.js → doctor-es2cw92p.js}

@@ -1,12 +1,12 @@
 import {
   getSystemDiagnostics,
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-c41yr7he.js";
 import"./cli-46ycxe6r.js";
 import"./cli-37x76zdn.js";

package/dist/{ext-jjzmafve.js → ext-06srzer2.js}

@@ -10,21 +10,21 @@ import {
   removeExtension,
   searchNpmExtensions,
   setExtensionEnabled
-} from "./cli-5fqr02je.js";
-import"./cli-12epgrva.js";
+} from "./cli-x4krgssg.js";
+import"./cli-d7k5ykyx.js";
 import {
   UsageError,
   exitForUsage,
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolveProjectDir
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{index-d4wrww4b.js → index-ryjmpyq6.js}

@@ -29,7 +29,7 @@ import {
   snapshotStagingMarkerPath,
   snapshotWorkingTreeUnlocked,
   withRepoLock
-} from "./index-f833dtg9.js";
+} from "./index-y01v2fe0.js";
 import {
   detectProjectSource,
   syncRemoteFor
@@ -4839,7 +4839,7 @@ import git from "isomorphic-git";
 // package.json
 var package_default = {
   name: "gutterpress",
-  version: "0.10.10-alpha.1",
+  version: "0.10.10-alpha.3",
   description: "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   author: "itlackey",
   license: "MPL-2.0",
@@ -12237,7 +12237,7 @@ async function scaffoldProject(options) {
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-y1kscr1h.js");
+      const { providerFor } = await import("./source-provider-jkppq9fc.js");
       const provider = providerFor({ type: "local-folder", path: projectDir });
       await provider.initVersionHistory({
         projectDir,
@@ -12334,7 +12334,7 @@ styles:
   let versionHistoryError;
   if (requested === "local-git") {
     try {
-      const { providerFor } = await import("./source-provider-y1kscr1h.js");
+      const { providerFor } = await import("./source-provider-jkppq9fc.js");
       const provider = providerFor({ type: "local-folder", path: dir });
       await provider.initVersionHistory({
         projectDir: dir,
@@ -15066,6 +15066,37 @@ async function syncProject(options) {
     }
   });
 }
+async function refreshRemoteCopies(options) {
+  const http3 = options.httpClient ?? defaultGitHttp;
+  try {
+    const dir = await repoDirFor(options.projectDir);
+    const transport = await resolveTransport(dir, {
+      ...options.credential ? { credential: options.credential } : {},
+      ...options.tokenStore ? { tokenStore: options.tokenStore } : {}
+    });
+    await git6.fetch({
+      fs: gitFs,
+      http: http3,
+      dir,
+      remote: transport.remote,
+      singleBranch: false,
+      prune: true,
+      tags: false,
+      ...onAuthFor(transport.credential)
+    });
+    return { refreshed: true };
+  } catch (e) {
+    const message = e?.message ?? "";
+    if (message === MSG_NO_REMOTE || message === MSG_SSH_REMOTE) {
+      return { refreshed: false, reason: "no-remote" };
+    }
+    const status = e?.data?.statusCode;
+    if (status === 401 || status === 403 || status === 404) {
+      return { refreshed: false, reason: "auth" };
+    }
+    return { refreshed: false, reason: "offline" };
+  }
+}
 // src/lib/publish/run-publish.ts
 import { readdir as readdir11, stat as stat11 } from "node:fs/promises";
 import path28 from "node:path";
@@ -16638,4 +16669,4 @@ async function setPublishProviderConfig(projectDir, providerId, values) {
   await writeManifestDoc(file, doc);
   return settingsFromDoc(doc);
 }
-export { DEFAULT_NPM_REGISTRY, npmRegistryUrl, PLUGINS_DIR, BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, loadPluginsWithCss, formatReport, getChecks, getCheckById, resolveCheckSelectors, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, rulePageContainment, checkCss, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importExtensionFromFile, importExtensionFromUrl, MAX_SEARCH_BYTES, SEARCH_KEYWORDS, searchNpmExtensions, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };
+export { DEFAULT_NPM_REGISTRY, npmRegistryUrl, PLUGINS_DIR, BUNDLED_EXTENSIONS, isBundledExtension, isPathSpecifier, parseExtensionSpecifier, PRESET_IDS, PRESETS, TARGETS, TARGET_IDS, publishTargetFor, MANIFEST_FILENAMES, hasProjectManifest, loadManifest, loadManifestWithPath, resolveConfig, SYNC_SNAPSHOT_MESSAGE, log, resolveActiveStyles, listProjectStyles, EXTENSION_MANIFEST_FILENAME, readExtensionMeta, extensionStyleList, extensionEntry, extensionCarries, pathEscapesFolder, assertExtensionContained, resolveExtension, loadPluginsWithCss, formatReport, getChecks, getCheckById, resolveCheckSelectors, ruleRemoteUrls, ruleRiskyProps, ruleSyntax, rulePageContainment, checkCss, inspectImage, runChecks, checkToolAvailability, reportMissingTools, executeValidation, executeAndReport, splitOutPath, runBuild, openPath, startPreviewServer, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics, EXTENSIONS_DIR, RECOMMENDED_EXTENSIONS, BUILT_IN_STYLE_SET_IDS, sameExtension, listProjectExtensions, describeExtension, setExtensionEnabled, reorderExtensions, removeExtension, addExtension, listBuiltInStyleSets, addBuiltInStyleSet, validateProjectExtensions, readExtensionCss, slugifyProjectName, escapeYamlScalar, scaffoldProject, adoptFolder, EXTENSION_KINDS, RESERVED_PREFIX, resolveExtensionPrefix, scaffoldExtension, BUILT_IN_TEMPLATE_IDS, listBuiltInTemplates, saveProjectAsTemplate, listCustomTemplates, importTemplateFromFolder, SNIPPETS_DIR, extractVariables, substituteVariables, listSnippets, readSnippet, saveSnippet, deleteSnippet, listMergedSnippets, readExtensionSnippet, importExtensionFromFile, importExtensionFromUrl, MAX_SEARCH_BYTES, SEARCH_KEYWORDS, searchNpmExtensions, setManifestFields, readManifestFields, setActiveStyles, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, resolveGitHubClientId, GITHUB_HOST, GitHubAuthProvider, GDRIVE_HOST, resolveGoogleClientId, resolveGoogleClientSecret, GOOGLE_NOT_CONFIGURED_MESSAGE, requireGoogleClientCredentials, pkceChallengeFromVerifier, GoogleAuthProvider, revokeGoogleCredential, publishCredentialKey, publishConnectionStatus, listPublishAccounts, connectGoogleDrive, listGitHubRepositories, listRepoBooks, listGitHubBranches, sanitizeCloneFolderName, cloneRepository, isSshRemoteUrl, testRemoteAccess, knownForgeTokenUrl, connectGenericHost, parseRemoteOrigin, forgeKindForHost, diagnoseProjectRemote, syncProject, refreshRemoteCopies, listPublishProviders, publishProviderFor, resolvePublishFormat, resolvePublishRequest, runPublish, connectPublishProvider, disconnectPublishCredential, PublishSelectionsStore, readPublishSettings, setPublishProviderConfig };

package/dist/{index-f833dtg9.js → index-y01v2fe0.js}

@@ -514,13 +514,45 @@ async function listLocalBranches(dir) {
   if (source.type !== "local-git-folder")
     return null;
   const repoDir = gitScopeFor(source);
-  const [branches, current] = await Promise.all([
+  const [local, current, remotes] = await Promise.all([
     git.listBranches({ fs: gitFs, dir: repoDir }),
     git.currentBranch({ fs: gitFs, dir: repoDir, fullname: false }).catch(() => {
       return;
-    })
+    }),
+    git.listRemotes({ fs: gitFs, dir: repoDir }).catch(() => [])
   ]);
-  return { current: current ?? null, branches };
+  const localNames = new Set(local);
+  const remoteOnly = new Set;
+  for (const { remote } of remotes) {
+    const names = await git.listBranches({ fs: gitFs, dir: repoDir, remote }).catch(() => []);
+    for (const name of names) {
+      if (name === "HEAD")
+        continue;
+      if (!localNames.has(name))
+        remoteOnly.add(name);
+    }
+  }
+  return {
+    current: current ?? null,
+    branches: [...localNames, ...remoteOnly].sort(),
+    remoteOnly: [...remoteOnly].sort()
+  };
+}
+async function resolveCopy(repoDir, branch) {
+  const local = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: `refs/heads/${branch}` }).catch(() => {
+    return;
+  });
+  if (local)
+    return { oid: local };
+  const remotes = await git.listRemotes({ fs: gitFs, dir: repoDir }).catch(() => []);
+  for (const { remote } of remotes) {
+    const oid = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: `refs/remotes/${remote}/${branch}` }).catch(() => {
+      return;
+    });
+    if (oid)
+      return { oid, remote };
+  }
+  throw new Error(`Couldn't find a copy named "${branch}" — it may have been renamed or deleted.`);
 }
 function isCheckoutConflictError(e) {
   return e?.code === "CheckoutConflictError";
@@ -579,9 +611,16 @@ async function switchBranch(options) {
     const fromOid = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: "HEAD" }).catch(() => {
       return;
     });
-    const toOid = await git.resolveRef({ fs: gitFs, dir: repoDir, ref: branch });
+    const { oid: toOid, remote } = await resolveCopy(repoDir, branch);
     try {
-      await git.checkout({ fs: gitFs, dir: repoDir, cache, ref: branch, force: false });
+      await git.checkout({
+        fs: gitFs,
+        dir: repoDir,
+        cache,
+        ref: branch,
+        force: false,
+        ...remote ? { remote } : {}
+      });
     } catch (e) {
       if (isCheckoutConflictError(e)) {
         throw new Error("Couldn't switch copies — some files changed on disk right as the switch " + "started. Try again.", { cause: e });

package/dist/index.js

@@ -102,6 +102,7 @@ import {
   readManifestFields,
   readPublishSettings,
   readSnippet,
+  refreshRemoteCopies,
   removeExtension,
   reorderExtensions,
   reportMissingTools,
@@ -142,7 +143,7 @@ import {
   syncProject,
   testRemoteAccess,
   validateProjectExtensions
-} from "./index-d4wrww4b.js";
+} from "./index-ryjmpyq6.js";
 import {
   BUILD_DIAGNOSTIC_CODES
 } from "./index-a0e2253t.js";
@@ -162,7 +163,7 @@ import {
   resolveLogger,
   restoreVersionWithBackup,
   switchBranch
-} from "./index-f833dtg9.js";
+} from "./index-y01v2fe0.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -293,6 +294,7 @@ export {
   repoRootForSource,
   reorderExtensions,
   removeExtension,
+  refreshRemoteCopies,
   readyProbeExpr,
   readSnippet,
   readPublishSettings,

package/dist/lib/remote-auth/sync.d.ts

@@ -1,5 +1,7 @@
+import { defaultGitHttp } from "./git-http.ts";
 import { onAuthFor } from "./transport.ts";
 import type { SyncOutcome, SyncProjectOptions } from "./sync-types.ts";
+import type { HostCredential, TokenStore } from "./token-store.ts";
 export { onAuthFor };
 export { SYNC_SNAPSHOT_MESSAGE } from "./sync-messages.ts";
 export type { KeptBothFile, SyncOutcome, SyncProjectOptions, } from "./sync-types.ts";
@@ -26,3 +28,36 @@ export declare function isUnrelatedHistories(e: unknown): boolean;
  * outcomes — everything is reported through {@link SyncOutcome}.
  */
 export declare function syncProject(options: SyncProjectOptions): Promise<SyncOutcome>;
+/**
+ * Fetch every branch the remote has, so the project's copy list reflects what
+ * exists online rather than only what this clone happened to fetch before.
+ *
+ * The copy picker reads refs off disk (`listLocalBranches`). That makes a
+ * branch pushed from anywhere else — another machine, the web UI, an agent
+ * opening a PR — invisible here until someone runs `git fetch` in a terminal,
+ * which is precisely the thing this app exists to avoid. So the picker calls
+ * this first.
+ *
+ * Unlike `fetchRemoteTip` this deliberately does NOT use `singleBranch`: the
+ * whole point is the branches we do not have yet. It only ever writes
+ * remote-tracking refs (`refs/remotes/<remote>/*`) — no local branch, no
+ * working-tree change, no merge — so it is safe to call on a dirty tree.
+ * `prune` drops tracking refs for branches deleted online, so the list cannot
+ * offer a copy that is gone.
+ *
+ * Best-effort by contract: offline, unauthenticated, or no remote at all
+ * resolves to `{ refreshed: false, reason }` rather than throwing. A stale
+ * list beats an error dialog over a control the author did not explicitly ask
+ * to sync — but it reports WHY, because a picker that silently omits copies
+ * is indistinguishable from a broken one, which is the bug this whole
+ * function exists to fix.
+ */
+export declare function refreshRemoteCopies(options: {
+    projectDir: string;
+    credential?: HostCredential;
+    tokenStore?: TokenStore;
+    httpClient?: typeof defaultGitHttp;
+}): Promise<{
+    refreshed: boolean;
+    reason?: "no-remote" | "auth" | "offline";
+}>;

package/dist/lib/source-provider.d.ts

@@ -239,17 +239,26 @@ export declare const AUTO_SNAPSHOT_MESSAGE = "Automatic snapshot";
  * folder has no version history.
  */
 export declare function restoreVersionWithBackup(options: RestoreVersionOptions): Promise<RestoreVersionResult>;
-/** The project's local copies (git branches) and which one is currently open. */
+/** The project's copies (git branches) and which one is currently open. */
 export interface LocalBranches {
     /** Name of the branch HEAD points to, or `null` on a detached/unborn HEAD. */
     current: string | null;
-    /** Every local branch name (`refs/heads/*`), in no particular order. */
+    /**
+     * Every copy the project can switch to, sorted: local branches
+     * (`refs/heads/*`) plus copies that so far exist only on a remote.
+     */
     branches: string[];
+    /**
+     * The subset of {@link branches} with no local ref yet. Switching to one of
+     * these creates the local copy from the remote and tracks it; the UI uses
+     * this only to say so before it happens.
+     */
+    remoteOnly: string[];
 }
 /** Inputs for {@link switchBranch}. */
 export interface SwitchBranchOptions {
     projectDir: string;
-    /** Local branch name to check out. */
+    /** Branch name to check out — local, or one that so far exists only on a remote. */
     branch: string;
     /** Identity recorded on the automatic pre-switch safety snapshot, if one is taken. */
     authorName?: string;
@@ -272,10 +281,14 @@ export interface SwitchBranchResult {
 /** Snapshot message for the safety snapshot {@link switchBranch} takes before checking out, when the working tree has changes. */
 export declare const SWITCH_BRANCH_SNAPSHOT_MESSAGE = "Saved before switching copy";
 /**
- * List the project's local copies (git branches) and which one is open, for a
+ * List the project's copies (git branches) and which one is open, for a
  * `local-git-folder` project. Returns `null` for any other source type —
  * there is nothing to switch between, and the caller (the Saving settings row)
  * hides the whole control on `null` rather than showing an error.
+ *
+ * Copies that exist only on a remote are included: they are as real to the
+ * author as the local ones, and {@link switchBranch} creates the local branch
+ * on the way in.
  */
 export declare function listLocalBranches(dir: string): Promise<LocalBranches | null>;
 /**

package/dist/{lint-5vbq6yjb.js → lint-2pgsfsp6.js}

@@ -1,21 +1,21 @@
 import {
   MANIFEST_FILENAMES,
   runLint
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{new-qws45t02.js → new-wyhadpt4.js}

@@ -7,15 +7,15 @@ import {
   TARGET_IDS,
   scaffoldExtension,
   scaffoldProject
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   resolveGhostscript
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import {
   isToolAvailable
@@ -23,7 +23,7 @@ import {
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{preflight-4ywt3399.js → preflight-wbfd5ma1.js}

@@ -2,21 +2,21 @@ import {
   executeValidation,
   publishTargetFor,
   reportMissingTools
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{preview-4c3tcsn4.js → preview-w9bp0fgf.js}

@@ -6,10 +6,10 @@ import {
   runBuild,
   splitOutPath,
   startPreviewServer
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   parseFormat,
@@ -17,13 +17,13 @@ import {
   rejectExtraPositionals,
   rejectUnknownFlags,
   resolvePort
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{publish-m6bme9a8.js → publish-9fn1hjmb.js}

@@ -11,22 +11,22 @@ import {
   publishProviderFor,
   resolvePublishFormat,
   runPublish
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   FileTokenStore,
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{source-provider-2cnc5hry.js → source-provider-51g6mt6y.js}

@@ -19,7 +19,7 @@ import {
   stageChanges,
   switchBranch,
   withRepoLock
-} from "./cli-vje8g3w8.js";
+} from "./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 export {

package/dist/{source-provider-y1kscr1h.js → source-provider-jkppq9fc.js}

@@ -19,7 +19,7 @@ import {
   stageChanges,
   switchBranch,
   withRepoLock
-} from "./index-f833dtg9.js";
+} from "./index-y01v2fe0.js";
 import"./index-v5mp7a6q.js";
 import"./index-37x76zdn.js";
 export {

package/dist/{validate-avtb9drn.js → validate-v9abv9xs.js}

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-5fqr02je.js";
+} from "./cli-x4krgssg.js";
 import {
   log
-} from "./cli-12epgrva.js";
+} from "./cli-d7k5ykyx.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-tvpq2ht9.js";
+} from "./cli-1prnz7c8.js";
 import"./cli-k8f9eb12.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-vje8g3w8.js";
+import"./cli-4mtf9ajw.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gutterpress",
-  "version": "0.10.10-alpha.1",
+  "version": "0.10.10-alpha.3",
   "description": "Markdown-to-PDF converter for professional print layout using a native Chromium print engine and Ghostscript.",
   "author": "itlackey",
   "license": "MPL-2.0",