gutterpress 0.10.0 → 0.10.1-beta.2

package/README.md

@@ -133,10 +133,9 @@ The full configuration cascade is `CLI flags > manifest.yaml > preset defaults`.
 
 ## Commands
 
-Gutterpress has 11 subcommands. `new`, `preview`, `build`, and `publish` are the
+Gutterpress has 10 subcommands. `new`, `preview`, `build`, and `publish` are the
 primary author commands; `lint`, `validate`, `audit`, and `preflight` are
-CI / advanced checks; `repair` is the version-history escape hatch; and
-`doctor` reports system readiness. `plugin` manages project plugins. Every
+CI / advanced checks; and `doctor` reports system readiness. `plugin` manages project plugins. Every
 command also accepts `--help` for the authoritative, always-current flag list
 (`gutterpress <command> --help`) — this section is regenerated from the same
 source.
@@ -315,18 +314,6 @@ gutterpress preflight [dir] --pdf <path> [options]
 
 Exits 1 when the computed status is `NO-GO` (errors, or a required check skipped/failed).
 
-### `gutterpress repair`
-
-Diagnose and repair the project's version history — no git knowledge (and no system git) required. Detects the states that block syncing (an update that didn't finish, a leftover lock from a crash, a damaged or missing history) and applies the same safe repair the desktop app offers: a safety-copy zip is saved first, and nothing changes without your confirmation.
-
-```sh
-gutterpress repair [dir]
-
-  --check     Diagnose only — never change anything (exit 1 when repair is needed)
-  --yes       Approve the repair without prompting
-  --force     Repair even if the Gutterpress app appears to have this project open
-```
-
 ### `gutterpress doctor`
 
 Report the Gutterpress version, platform and config paths, and whether each external tool is available. Missing tools include the features that use them and platform-specific installation guidance.
@@ -369,7 +356,7 @@ Every command follows the same exit-code contract, so CI can branch on the resul
 | `2` | Usage — the invocation itself was wrong: a bad flag, positional argument, preset, or value. |
 | `3` | Pipeline — the build/render/export pipeline itself failed for a reason unrelated to usage or findings (I/O error, missing tool, renderer crash). |
 
-This applies uniformly across `build`, `preview`, `lint`, `validate`, `preflight`, `audit`, `repair`, `publish`, `plugin`, `new`, and `doctor`.
+This applies uniformly across `build`, `preview`, `lint`, `validate`, `preflight`, `audit`, `publish`, `plugin`, `new`, and `doctor`.
 
 ## Plugins
 

package/dist/api/index.d.ts

@@ -43,27 +43,24 @@ export { readManifestFields, setManifestFields, setActiveStyles, } from "../lib/
 export type { ProjectConfigFields } from "../lib/manifest-config.ts";
 export { providerFor, restoreVersionWithBackup, isNoChangesError, AUTO_SNAPSHOT_MESSAGE, RESTORE_BACKUP_MESSAGE, HISTORY_PAGE_LIMIT, } from "../lib/source-provider.ts";
 export type { ListHistoryOptions, HistoryPage, } from "../lib/source-provider.ts";
-export { appHeartbeatPath, heartbeatTtlMs, isAppHeartbeatFresh, readAppHeartbeat, removeAppHeartbeat, writeAppHeartbeat, APP_HEARTBEAT_FRESH_MS, } from "../lib/app-heartbeat.ts";
-export type { AppHeartbeat } from "../lib/app-heartbeat.ts";
-export { autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, } from "../lib/host-policy.ts";
+export { autoSnapshotDelayMs, autoSyncDelayMs, isGitInternalPath, AUTO_SNAPSHOT_MIN_MINUTES, AUTO_SNAPSHOT_MAX_MINUTES, AUTO_SNAPSHOT_DEFAULT_MINUTES, AUTO_SYNC_MIN_MINUTES, AUTO_SYNC_MAX_MINUTES, AUTO_SYNC_DEFAULT_MINUTES, AUTO_SYNC_PUSH_INTERVAL_MINUTES, } from "../lib/host-policy.ts";
 export type { AutoSnapshotPolicy, AutoSyncPolicy, } from "../lib/host-policy.ts";
-export { FileTokenStore, defaultConfigDir, redactCredential, extractUrlCredential, migrateUrlCredential, } from "../lib/remote-auth/token-store.ts";
+export { FileTokenStore, defaultConfigDir, extractUrlCredential, } from "../lib/remote-auth/token-store.ts";
 export type { HostCredential, TokenStore, UrlCredentialExtraction, } from "../lib/remote-auth/token-store.ts";
 export { GitHubAuthProvider, resolveGitHubClientId, GITHUB_HOST, } from "../lib/remote-auth/github-auth.ts";
-export type { RemoteAuthProvider, HostCallbacks, DeviceCodeInfo, GitHubAuthProviderOptions, } from "../lib/remote-auth/github-auth.ts";
+export type { HostCallbacks, DeviceCodeInfo, GitHubAuthProviderOptions, } from "../lib/remote-auth/github-auth.ts";
 export { listGitHubRepositories, listGitHubBranches, listRepoBooks, } from "../lib/remote-auth/github-repos.ts";
 export type { RemoteRepository, RemoteBranch, RepoBook, } from "../lib/remote-auth/github-repos.ts";
-export { cloneRepository, readProjectProvenance, provenancePath, sanitizeCloneFolderName, } from "../lib/remote-auth/clone.ts";
-export type { CloneRepositoryOptions, CloneRepositoryResult, CloneProgressEvent, ProjectProvenance, } from "../lib/remote-auth/clone.ts";
+export { cloneRepository, sanitizeCloneFolderName, } from "../lib/remote-auth/clone.ts";
+export type { CloneRepositoryOptions, CloneRepositoryResult, CloneProgressEvent, } from "../lib/remote-auth/clone.ts";
 export { testRemoteAccess, isSshRemoteUrl, } from "../lib/remote-auth/test-access.ts";
 export type { RemoteAccessResult, RemoteAccessFailureReason, TestRemoteAccessOptions, } from "../lib/remote-auth/test-access.ts";
-export { GenericTokenAuthProvider, connectGenericHost, knownForgeTokenUrl, normalizeForgeHost, } from "../lib/remote-auth/generic-auth.ts";
-export type { GenericTokenConnectInput, GenericHostCallbacks, GenericAuthOptions, } from "../lib/remote-auth/generic-auth.ts";
+export { connectGenericHost, knownForgeTokenUrl, } from "../lib/remote-auth/generic-auth.ts";
+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, pullChanges, pushChanges, SYNC_SNAPSHOT_MESSAGE, } from "../lib/remote-auth/sync.ts";
-export type { SyncOutcome, PullOutcome, PushOutcome, SyncProjectOptions, ImageClash, } from "../lib/remote-auth/sync.ts";
-export { keepImageVersion, readImageVersion } from "../lib/remote-auth/image-clash.ts";
+export { syncProject, 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, } from "../lib/publish/run-publish.ts";
 export type { RunPublishOptions, RunPublishResult, } from "../lib/publish/run-publish.ts";
@@ -76,11 +73,5 @@ export { PublishSelectionsStore } from "../lib/publish/selections.ts";
 export type { PublishAccountSelection } from "../lib/publish/selections.ts";
 export { readPublishSettings, setPublishProviderConfig, } from "../lib/publish/manifest-publish.ts";
 export type { PublishProvider, PublishProviderId, PublishProviderInfo, PublishProviderKind, PublishConfigField, PublishArtifact, PublishArtifactFormat, PublishAuthStatus, PublishDeps, PublishListingMetadata, PublishOutcome, PublishProduct, PublishProject, PublishRequest, PreflightIssue, CommandRunner, CommandResult, } from "../lib/publish/types.ts";
-export { repairRepo } from "../lib/remote-auth/recovery/repair.ts";
-export type { RepairOptions, RepairResult } from "../lib/remote-auth/recovery/repair.ts";
-export { classifyFromHealth, isLikelyRepoCorruption, RepoNeedsRecoveryError, isRepoNeedsRecoveryError, STALE_LOCK_MIN_AGE_MS, } from "../lib/remote-auth/recovery/classify.ts";
-export type { RepairNeed } from "../lib/remote-auth/recovery/classify.ts";
-export { inspectRepo, preflightStructuralReason, buildPreflightDiagnostics, verifyRepoReadable, isUnbornRepo, } from "../lib/remote-auth/recovery/inspect.ts";
-export type { RepoHealth } from "../lib/remote-auth/recovery/types.ts";
-export { resolveLogger, shortOid } from "../lib/remote-auth/operation-log.ts";
+export { resolveLogger } from "../lib/remote-auth/operation-log.ts";
 export type { OperationLogger, LogData } from "../lib/remote-auth/operation-log.ts";

package/dist/api/index.js

@@ -1,16 +1,15 @@
 import {
-  APP_HEARTBEAT_FRESH_MS,
   AUTO_SNAPSHOT_DEFAULT_MINUTES,
   AUTO_SNAPSHOT_MAX_MINUTES,
   AUTO_SNAPSHOT_MIN_MINUTES,
   AUTO_SYNC_DEFAULT_MINUTES,
   AUTO_SYNC_MAX_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
+  AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   BUILT_IN_TEMPLATE_IDS,
   BUILT_IN_THEME_IDS,
   FileTokenStore,
   GITHUB_HOST,
-  GenericTokenAuthProvider,
   GitHubAuthProvider,
   MANIFEST_FILENAMES,
   PLUGINS_DIR,
@@ -18,9 +17,7 @@ import {
   PRESET_IDS,
   PublishSelectionsStore,
   RECOMMENDED_PLUGINS,
-  RepoNeedsRecoveryError,
   SNIPPETS_DIR,
-  STALE_LOCK_MIN_AGE_MS,
   SYNC_SNAPSHOT_MESSAGE,
   TARGETS,
   TARGET_IDS,
@@ -28,12 +25,9 @@ import {
   addLocalPlugin,
   addNpmPlugin,
   adoptFolder,
-  appHeartbeatPath,
   applyTheme,
   autoSnapshotDelayMs,
   autoSyncDelayMs,
-  buildPreflightDiagnostics,
-  classifyFromHealth,
   cloneRepository,
   connectGenericHost,
   connectPublishProvider,
@@ -48,19 +42,12 @@ import {
   getPreviousTheme,
   getSystemDiagnostics,
   hasProjectManifest,
-  heartbeatTtlMs,
   importTemplateFromFolder,
   importThemeFromFile,
   importThemeFromFolder,
   importThemeFromUrl,
-  inspectRepo,
-  isAppHeartbeatFresh,
   isGitInternalPath,
-  isLikelyRepoCorruption,
-  isRepoNeedsRecoveryError,
   isSshRemoteUrl,
-  isUnbornRepo,
-  keepImageVersion,
   knownForgeTokenUrl,
   listBuiltInTemplates,
   listBuiltInThemes,
@@ -75,28 +62,16 @@ import {
   listRepoBooks,
   listSnippets,
   loadManifestWithPath,
-  migrateUrlCredential,
-  normalizeForgeHost,
   parseRemoteOrigin,
-  preflightStructuralReason,
-  provenancePath,
   publishConnectionStatus,
   publishCredentialKey,
   publishProviderFor,
   publishTargetFor,
-  pullChanges,
-  pushChanges,
-  readAppHeartbeat,
-  readImageVersion,
   readManifestFields,
-  readProjectProvenance,
   readPublishSettings,
   readSnippet,
   readThemeCss,
-  redactCredential,
-  removeAppHeartbeat,
   removeProjectTheme,
-  repairRepo,
   resolveActiveStyles,
   resolveBuiltInTheme,
   resolveConfig,
@@ -119,15 +94,13 @@ import {
   substituteVariables,
   syncProject,
   testRemoteAccess,
-  validateProjectPlugins,
-  verifyRepoReadable,
-  writeAppHeartbeat
-} from "../index-ge7q9xj3.js";
+  validateProjectPlugins
+} from "../index-h1x7krkg.js";
 import {
   BuildError,
   DEFAULT_PRINT_OPTS,
   readyProbeExpr
-} from "../index-ycpvr0am.js";
+} from "../index-7hrvksrb.js";
 import {
   AUTO_SNAPSHOT_MESSAGE,
   HISTORY_PAGE_LIMIT,
@@ -135,9 +108,8 @@ import {
   isNoChangesError,
   providerFor,
   resolveLogger,
-  restoreVersionWithBackup,
-  shortOid
-} from "../index-mdefp0y5.js";
+  restoreVersionWithBackup
+} from "../index-dtrftayr.js";
 import {
   capabilitiesFor,
   detectProjectSource,
@@ -147,8 +119,6 @@ import {
 } from "../index-v5mp7a6q.js";
 import"../index-37x76zdn.js";
 export {
-  writeAppHeartbeat,
-  verifyRepoReadable,
   validateProjectPlugins,
   testRemoteAccess,
   syncProject,
@@ -156,7 +126,6 @@ export {
   startPreviewServer,
   splitOutPath,
   slugifyProjectName,
-  shortOid,
   setPublishProviderConfig,
   setPluginEnabled,
   setManifestFields,
@@ -177,30 +146,18 @@ export {
   resolveActiveStyles,
   repoSubPath,
   repoRootForSource,
-  repairRepo,
   removeProjectTheme,
-  removeAppHeartbeat,
-  redactCredential,
   readyProbeExpr,
   readThemeCss,
   readSnippet,
   readPublishSettings,
-  readProjectProvenance,
   readManifestFields,
-  readImageVersion,
-  readAppHeartbeat,
-  pushChanges,
-  pullChanges,
   publishTargetFor,
   publishProviderFor,
   publishCredentialKey,
   publishConnectionStatus,
   providerFor,
-  provenancePath,
-  preflightStructuralReason,
   parseRemoteOrigin,
-  normalizeForgeHost,
-  migrateUrlCredential,
   loadManifestWithPath,
   listSnippets,
   listRepoBooks,
@@ -215,20 +172,13 @@ export {
   listBuiltInThemes,
   listBuiltInTemplates,
   knownForgeTokenUrl,
-  keepImageVersion,
-  isUnbornRepo,
   isSshRemoteUrl,
-  isRepoNeedsRecoveryError,
   isNoChangesError,
-  isLikelyRepoCorruption,
   isGitInternalPath,
-  isAppHeartbeatFresh,
-  inspectRepo,
   importThemeFromUrl,
   importThemeFromFolder,
   importThemeFromFile,
   importTemplateFromFolder,
-  heartbeatTtlMs,
   hasProjectManifest,
   getSystemDiagnostics,
   getPreviousTheme,
@@ -245,13 +195,10 @@ export {
   connectPublishProvider,
   connectGenericHost,
   cloneRepository,
-  classifyFromHealth,
   capabilitiesFor,
-  buildPreflightDiagnostics,
   autoSyncDelayMs,
   autoSnapshotDelayMs,
   applyTheme,
-  appHeartbeatPath,
   adoptFolder,
   addNpmPlugin,
   addLocalPlugin,
@@ -259,9 +206,7 @@ export {
   TARGET_IDS,
   TARGETS,
   SYNC_SNAPSHOT_MESSAGE,
-  STALE_LOCK_MIN_AGE_MS,
   SNIPPETS_DIR,
-  RepoNeedsRecoveryError,
   RESTORE_BACKUP_MESSAGE,
   RECOMMENDED_PLUGINS,
   PublishSelectionsStore,
@@ -271,19 +216,18 @@ export {
   MANIFEST_FILENAMES,
   HISTORY_PAGE_LIMIT,
   GitHubAuthProvider,
-  GenericTokenAuthProvider,
   GITHUB_HOST,
   FileTokenStore,
   DEFAULT_PRINT_OPTS,
   BuildError,
   BUILT_IN_THEME_IDS,
   BUILT_IN_TEMPLATE_IDS,
+  AUTO_SYNC_PUSH_INTERVAL_MINUTES,
   AUTO_SYNC_MIN_MINUTES,
   AUTO_SYNC_MAX_MINUTES,
   AUTO_SYNC_DEFAULT_MINUTES,
   AUTO_SNAPSHOT_MIN_MINUTES,
   AUTO_SNAPSHOT_MESSAGE,
   AUTO_SNAPSHOT_MAX_MINUTES,
-  AUTO_SNAPSHOT_DEFAULT_MINUTES,
-  APP_HEARTBEAT_FRESH_MS
+  AUTO_SNAPSHOT_DEFAULT_MINUTES
 };

package/dist/{audit-cvarpa72.js → audit-dce99css.js}

@@ -1,20 +1,20 @@
 import {
   executeAndReport
-} from "./cli-eq5naw4m.js";
+} from "./cli-7n848af2.js";
 import {
   log
-} from "./cli-cqtggsng.js";
+} from "./cli-0z6zf98d.js";
 import {
   UsageError,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-149edp6b.js";
-import"./cli-zfcryxg8.js";
+} from "./cli-ydpf09d9.js";
+import"./cli-eewynen9.js";
 import"./cli-c41yr7he.js";
 import {
   EXIT_CODES
 } from "./cli-46ycxe6r.js";
-import"./cli-k1065rkg.js";
+import"./cli-w692g6dx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/{build-6r502chw.js → build-bj4x0727.js}

@@ -1,10 +1,10 @@
 import {
   runBuild,
   splitOutPath
-} from "./cli-eq5naw4m.js";
+} from "./cli-7n848af2.js";
 import {
   log
-} from "./cli-cqtggsng.js";
+} from "./cli-0z6zf98d.js";
 import {
   UsageError,
   parseEngine,
@@ -12,13 +12,13 @@ import {
   parsePdfxFlavor,
   rejectExtraPositionals,
   rejectUnknownFlags
-} from "./cli-149edp6b.js";
-import"./cli-zfcryxg8.js";
+} from "./cli-ydpf09d9.js";
+import"./cli-eewynen9.js";
 import"./cli-c41yr7he.js";
 import {
   BuildError
 } from "./cli-46ycxe6r.js";
-import"./cli-k1065rkg.js";
+import"./cli-w692g6dx.js";
 import"./cli-v5mp7a6q.js";
 import"./cli-37x76zdn.js";
 

package/dist/checks/source/index.d.ts

@@ -5,3 +5,4 @@ import "./local-refs";
 import "./accessibility-alt-text";
 import "./accessibility-heading-order";
 import "./layout-markers";
+import "./merge-markers";

package/dist/checks/source/merge-markers.d.ts

@@ -0,0 +1,3 @@
+import type { Check } from "../types";
+declare const check: Check;
+export default check;

package/dist/{cli-cqtggsng.js → cli-0z6zf98d.js}

@@ -1,6 +1,6 @@
 import {
   package_default
-} from "./cli-149edp6b.js";
+} from "./cli-ydpf09d9.js";
 import {
   execCapture,
   findTool,
@@ -307,27 +307,6 @@ async function convertToPdfxCmyk(inputPdf, outPdf, config) {
 import { chmod, mkdir, readFile as readFile2, rename as rename2, writeFile as writeFile2 } from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
-function credentialHostKey(hostOrUrl) {
-  const trimmed = String(hostOrUrl ?? "").trim();
-  if (!trimmed)
-    return "";
-  const scp = /^[\w.-]+@([\w.][\w.-]*):/.exec(trimmed);
-  if (scp)
-    return stripWww(scp[1].toLowerCase());
-  const candidate = /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
-  try {
-    const url = new URL(candidate);
-    if (!url.hostname)
-      return "";
-    const host = url.port ? `${url.hostname}:${url.port}`.toLowerCase() : url.hostname.toLowerCase();
-    return stripWww(host);
-  } catch {
-    return "";
-  }
-}
-function stripWww(host) {
-  return host.startsWith("www.") && host.length > 4 ? host.slice(4) : host;
-}
 function defaultConfigDir() {
   const override = process.env.GUTTERPRESS_CONFIG_DIR?.trim();
   if (override)
@@ -422,30 +401,6 @@ class FileTokenStore {
 function normalizeHost(host) {
   return host.trim().toLowerCase();
 }
-function extractUrlCredential(url) {
-  let parsed;
-  try {
-    parsed = new URL(url);
-  } catch {
-    return { cleanUrl: url };
-  }
-  if (!/^https?:$/.test(parsed.protocol))
-    return { cleanUrl: url };
-  if (!parsed.username && !parsed.password)
-    return { cleanUrl: url };
-  const token = parsed.password ? decodeURIComponent(parsed.password) : decodeURIComponent(parsed.username);
-  const username = parsed.password ? decodeURIComponent(parsed.username) : undefined;
-  parsed.username = "";
-  parsed.password = "";
-  const credential = {
-    host: credentialHostKey(parsed.toString()),
-    kind: "token",
-    token,
-    ...username ? { username } : {},
-    createdAt: Date.now()
-  };
-  return { cleanUrl: parsed.toString(), credential };
-}
 
 // src/lib/diagnostics.ts
 import { platform, arch, release } from "node:os";
@@ -559,4 +514,4 @@ async function getSystemDiagnostics() {
   };
 }
 
-export { setLogLevel, debug, info, warn, error, log, resolveGhostscript, hasLiveTransparency, stripAnnotations, stampCreator, convertToPdfxCmyk, PACKAGE_META, PACKAGE_VERSION, credentialHostKey, defaultConfigDir, FileTokenStore, extractUrlCredential, getSystemDiagnostics };
+export { setLogLevel, debug, info, warn, error, log, resolveGhostscript, hasLiveTransparency, stripAnnotations, stampCreator, convertToPdfxCmyk, PACKAGE_META, PACKAGE_VERSION, defaultConfigDir, FileTokenStore, getSystemDiagnostics };