gutterpress 0.10.0 → 0.10.1-beta.1

package/dist/lib/remote-auth/recovery/inspect.d.ts

@@ -1,75 +0,0 @@
-/**
- * Preflight repo health probe for the sync-recovery subsystem.
- *
- * inspectRepo() reads local filesystem state ONLY — no network, no git objects,
- * never throws. It returns a RepoHealth snapshot that the classifier and policy
- * lookup use to decide which recovery path to take.
- *
- * Reuses:
- *   - gitDirFor (source-provider.ts) for the .git dir path
- *   - hasPendingChanges (source-provider.ts) for local-changes detection
- *
- * Notes on two health facts:
- *   - hasGitDir is true whenever `.git/` EXISTS, even with a missing/corrupt
- *     HEAD (a damaged repo is still a repo — see the inline note at the check).
- *   - hasStaleLock uses the lock sweep's OWN scanner
- *     (findLockCandidates in locks.ts) — one implementation, so
- *     health and handler can never disagree about which locks exist.
- *
- * All probes are best-effort and throw-free (the caller must never see an
- * exception from a preflight probe).
- */
-import type { LogData } from "../operation-log.ts";
-import type { RepairNeed } from "./classify.ts";
-import type { RepoHealth } from "./types.ts";
-/**
- * Probe the local repository and return a RepoHealth snapshot.
- * Never throws — on any error the relevant flag is set conservatively.
- *
- * `checkLocalChanges: false` skips the hasPendingChanges working-tree walk
- * (the one non-trivial probe) and reports hasLocalChanges=false. Use it when
- * only the structural flags matter — e.g. syncProject's preflight, whose
- * pull step immediately performs the same walk anyway (sync-simplicity
- * mandate: no redundant walks on the hot path).
- */
-export declare function inspectRepo(ctx: {
-    repoDir: string;
-    source?: import("../../project-source.ts").ProjectSource;
-}, opts?: {
-    checkLocalChanges?: boolean;
-}): Promise<RepoHealth>;
-/**
- * Confirm the repo's object store is actually readable: resolve HEAD, read
- * its commit, and read its root tree. Throws when any step fails (missing or
- * corrupt object/ref); resolves when the repo is fully readable.
- *
- * Exported so the repair
- * command's diagnosis step and any host check share ONE implementation. `inspectRepo`'s health flags are
- * all filesystem-presence checks (no object is ever read), so they cannot
- * detect object-store corruption on their own — callers that need to catch
- * unreadable objects/refs must run this probe and feed a caught error through
- * `isLikelyRepoCorruption` (classify.ts) to decide whether to repairRepo().
- */
-export declare function verifyRepoReadable(dir: string): Promise<void>;
-/**
- * True when HEAD names a branch that simply has no commits yet — a fresh
- * `git init` before the first snapshot. In that state `verifyRepoReadable`
- * throws the SAME NotFoundError as a damaged ref store, but the repo is
- * healthy, not corrupt. The distinguishing signal is the object store: a
- * fresh repo has NO objects at all, while ref damage on a real repo leaves
- * loose objects and/or packfiles behind.
- */
-export declare function isUnbornRepo(repoDir: string): boolean;
-/**
- * The SINGLE health signal that drove classification. Derived from the KIND
- * classifyFromHealth returned (a pure mapping — it cannot drift from the
- * classifier's decision order, because it never re-implements it).
- */
-export declare function preflightStructuralReason(kind: RepairNeed | null): string;
-/**
- * Build a flat, secret-free record of the preflight decision inputs for the
- * operation log. Every health boolean is recorded (so support can see the FULL
- * picture, not just the one-word kind), plus the opened dir vs repo root, the
- * chosen kind, and the single reason that drove it.
- */
-export declare function buildPreflightDiagnostics(openedDir: string, repoDir: string, health: RepoHealth, kind: RepairNeed | null): LogData;

package/dist/lib/remote-auth/recovery/locks.d.ts

@@ -1,20 +0,0 @@
-export interface LockCandidate {
-    /** Absolute path to the lock file. */
-    path: string;
-    /** Age in ms relative to `now` (now - mtime). */
-    ageMs: number;
-}
-/**
- * Gather every candidate lock file (top-level + refs/**) with its age.
- * Locks that vanish between discovery and stat are simply dropped (a racing
- * delete is fine to ignore). Never throws.
- */
-export declare function findLockCandidates(gitDir: string, now: number): Promise<LockCandidate[]>;
-/**
- * Delete every stale lock under `gitDir` — but ONLY when every candidate is
- * stale (one fresh lock defers the whole sweep; a live process may hold it).
- *
- * Returns "clean" (nothing found), "swept" (all removed), or "fresh"
- * (deferred — the caller should retry later).
- */
-export declare function sweepStaleLocks(gitDir: string, now?: number, minAgeMs?: number): Promise<"clean" | "swept" | "fresh">;

package/dist/lib/remote-auth/recovery/repair.d.ts

@@ -1,29 +0,0 @@
-import type { HostCredential, TokenStore } from "../token-store.ts";
-export interface RepairOptions {
-    projectDir: string;
-    /** Explicit credential; wins over the token store (nuclear re-clone only). */
-    credential?: HostCredential;
-    /** Host-keyed store used to resolve the credential for the remote's host. */
-    tokenStore?: TokenStore;
-    authorName?: string;
-    authorEmail?: string;
-    /** Operation log (same file sync writes to). */
-    logFile?: string;
-}
-export interface RepairResult {
-    status: "repaired" | "retry_later" | "failed";
-    /** One author-language sentence describing the outcome. */
-    message: string;
-    /** Author-language lines describing what was done (for the log/details). */
-    actions: string[];
-    /** Present when the re-clone ran: on-disk backup of the old `.git`. */
-    damagedGitBackupPath?: string;
-    /** Suggested delay before retrying (present on "retry_later"). */
-    retryAfterMs?: number;
-}
-/**
- * Repair a damaged repository. See the module header for the pipeline and
- * invariants. Never throws for expected outcomes — everything is reported
- * through {@link RepairResult}.
- */
-export declare function repairRepo(options: RepairOptions): Promise<RepairResult>;

package/dist/lib/remote-auth/recovery/types.d.ts

@@ -1,39 +0,0 @@
-/**
- * Shared types for the repo health probe + repair pipeline.
- *
- * 2026-08-14 simplification (owner directive): the old handler-dispatch type
- * surface (SyncErrorKind taxonomy, RecoveryContext, RecoveryResult,
- * ManualGuidance, confirmation gates, fault injection) is gone — repair is
- * one automatic pipeline (repair.ts) and needs none of it. What remains is
- * the health snapshot inspect.ts produces.
- */
-export interface RepoHealth {
-    /** True when .git/ exists and looks like a valid git dir. */
-    hasGitDir: boolean;
-    /** Current branch name, or undefined when HEAD is detached. */
-    currentBranch?: string;
-    /** True when HEAD is detached (no named branch). */
-    isDetachedHead: boolean;
-    /**
-     * True when HEAD (or the ref store) could not even be READ — distinct from
-     * a clean detached HEAD, where HEAD resolves fine but points at a commit
-     * instead of a branch. Routes to the re-clone step of repairRepo.
-     */
-    headUnreadable: boolean;
-    /**
-     * True when a leftover git lock file exists (a previous operation may have
-     * died). Detects any of index.lock, HEAD.lock, config.lock, packed-refs.lock,
-     * or a per-ref refs/**\/*.lock — the same set the lock sweep scans.
-     */
-    hasStaleLock: boolean;
-    /** How old the YOUNGEST detected lock file is in milliseconds, when present. */
-    lockAgeMs?: number;
-    /** True when a MERGE_HEAD file exists (interrupted merge). */
-    hasInterruptedMerge: boolean;
-    /** True when a rebase-in-progress directory exists. */
-    hasInterruptedRebase: boolean;
-    /** True when CHERRY_PICK_HEAD exists. */
-    hasInterruptedCherryPick: boolean;
-    /** True when the working tree has uncommitted changes. */
-    hasLocalChanges: boolean;
-}

package/dist/repair-2va4w12t.js

@@ -1,137 +0,0 @@
-import {
-  classifyFromHealth,
-  inspectRepo,
-  isAppHeartbeatFresh,
-  isUnbornRepo,
-  repairRepo,
-  verifyRepoReadable
-} from "./cli-eq5naw4m.js";
-import {
-  FileTokenStore,
-  defaultConfigDir
-} from "./cli-cqtggsng.js";
-import {
-  UsageError,
-  rejectExtraPositionals,
-  rejectUnknownFlags
-} from "./cli-149edp6b.js";
-import"./cli-zfcryxg8.js";
-import"./cli-c41yr7he.js";
-import"./cli-46ycxe6r.js";
-import"./cli-k1065rkg.js";
-import"./cli-v5mp7a6q.js";
-import"./cli-37x76zdn.js";
-
-// src/commands/repair.ts
-import { defineCommand } from "citty";
-import * as readline from "node:readline/promises";
-import path from "node:path";
-async function promptYesNo(question) {
-  if (!process.stdin.isTTY)
-    return false;
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const answer = (await rl.question(`${question} [y/N] `)).trim().toLowerCase();
-    return answer === "y" || answer === "yes";
-  } finally {
-    rl.close();
-  }
-}
-var commandArgs = {
-  dir: {
-    type: "positional",
-    description: "Project directory (defaults to the current directory)",
-    required: false
-  },
-  check: {
-    type: "boolean",
-    description: "Diagnose only — never change anything (exit 1 when repair is needed)",
-    default: false
-  },
-  yes: {
-    type: "boolean",
-    description: "Approve the repair without prompting",
-    default: false
-  },
-  force: {
-    type: "boolean",
-    description: "Repair even if the Gutterpress app appears to have this project open",
-    default: false
-  }
-};
-var repair_default = defineCommand({
-  meta: {
-    name: "repair",
-    description: "Diagnose and repair the project's version history"
-  },
-  args: commandArgs,
-  async run({ args, rawArgs }) {
-    try {
-      rejectUnknownFlags(rawArgs, commandArgs, "repair");
-      rejectExtraPositionals(args._, 1, "repair");
-    } catch (error) {
-      if (error instanceof UsageError) {
-        console.error(error.message);
-        process.exitCode = error.exitCode;
-        return;
-      }
-      throw error;
-    }
-    const openedDir = path.resolve(args.dir ?? ".");
-    const health = await inspectRepo({ repoDir: openedDir });
-    let needsRepair = classifyFromHealth(health, { minLockAgeMs: 0 }) !== null;
-    if (!needsRepair && health.hasGitDir) {
-      try {
-        await verifyRepoReadable(openedDir);
-      } catch {
-        if (!isUnbornRepo(openedDir))
-          needsRepair = true;
-      }
-    }
-    if (!health.hasGitDir)
-      needsRepair = true;
-    if (!needsRepair) {
-      console.log("Your project's version history looks healthy. Nothing to repair.");
-      return;
-    }
-    console.log("Found a problem with this project's version history.");
-    if (args.check) {
-      console.log("\nRun `gutterpress repair` to fix it. Your files will not be changed.");
-      process.exitCode = 1;
-      return;
-    }
-    if (!args.force && await isAppHeartbeatFresh(openedDir)) {
-      console.log(`
-The Gutterpress app appears to have this project open. Close it first, or re-run with --force.`);
-      process.exitCode = 1;
-      return;
-    }
-    if (!args.yes) {
-      console.log(`
-The repair never changes your project files. If history has to be rebuilt,
-` + `the old history folder is kept on disk as a backup and your saved versions
-` + "are brought back into it wherever they are still readable.");
-      if (!await promptYesNo("Repair now?")) {
-        console.log("Nothing was changed.");
-        process.exitCode = 1;
-        return;
-      }
-    }
-    const result = await repairRepo({
-      projectDir: openedDir,
-      tokenStore: new FileTokenStore(defaultConfigDir())
-    });
-    console.log(`
-${result.message}`);
-    for (const action of result.actions)
-      console.log(`  - ${action}`);
-    if (result.damagedGitBackupPath) {
-      console.log(`  - Old history kept at: ${result.damagedGitBackupPath}`);
-    }
-    if (result.status !== "repaired")
-      process.exitCode = 1;
-  }
-});
-export {
-  repair_default as default
-};