@scolladon/tsgit 1.1.0 → 1.3.0

package/dist/types/index.d.ts

@@ -1,9 +1,9 @@
-import { f as FileSystem, H as HashService, C as Compressor, P as ProgressReporter } from './chunks/context-o5TPfMB2.js';
-export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContextParts, D as DirEntry, e as FileStat, g as Hasher, L as Logger, h as RepositoryConfig, i as RepositoryLayout, j as createContext, n as noopLogger, w as wrapLoggerSanitizer } from './chunks/context-o5TPfMB2.js';
+import { f as FileSystem, H as HashService, C as Compressor, P as ProgressReporter } from './chunks/context-BORy7yXb.js';
+export { A as AuthStrategy, a as AuthorIdentity, b as Context, c as CreateContextParts, D as DirEntry, e as FileStat, g as Hasher, h as HookName, i as HookRequest, j as HookResult, k as HookRunner, L as Logger, l as PromisorFetchOutcome, m as PromisorRemote, n as RepositoryConfig, o as RepositoryLayout, p as createContext, q as noopLogger, w as wrapLoggerSanitizer } from './chunks/context-BORy7yXb.js';
 import { b as HttpTransport } from './chunks/http-transport-DirKfK2S.js';
 export { H as HttpRequest, a as HttpResponse } from './chunks/http-transport-DirKfK2S.js';
-export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, StatusResult, TagAction, TagInfo, TagResult, add, branch, checkout, clone, commit, diff, fetch, init, log, merge, push, reset, revParse, rm, status, tag } from './commands/index.js';
-import './chunks/diff-change-alGRzD_j.js';
+export { AddOptions, AddResult, BranchAction, BranchInfo, BranchResult, CatFileInput, CatFileResult, ChangeEntry, ChangeKind, CheckoutOptions, CheckoutResult, CloneOptions, CloneResult, CommitOptions, CommitResult, DiffOptions, FetchMissingOptions, FetchMissingResult, FetchOptions, FetchResult, InitOptions, InitResult, LogEntry, LogOptions, MergeOptions, MergeResult, PushOptions, PushResult, ReflogAction, ReflogResult, ReflogShowEntry, ResetMode, ResetOptions, ResetResult, RmOptions, RmResult, SparseCheckoutAction, SparseCheckoutResult, StatusResult, SubmodulesAction, SubmodulesResult, TagAction, TagInfo, TagResult, add, branch, catFile, checkout, clone, commit, createPromisorRemote, diff, fetch, fetchMissing, init, log, merge, push, reflog, reset, revParse, rm, sparseCheckout, status, submodules, tag } from './commands/index.js';
+export { C as CatFileBatchEntry, S as SubmoduleEntry } from './chunks/reflog-entry-C2Hsdobk.js';
 
 /**
  * The four adapter ports the facade plumbs into the Context. Each runtime

package/dist/types/index.default.d.cts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-23evW2h-.cjs';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DCR_3RVt.cjs';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.cjs';
-export { P as ProgressReporter } from './chunks/context-D84z1i5F.cjs';
+export { P as ProgressReporter } from './chunks/context-CMrHCVwK.cjs';
 import './commands/index.cjs';
-import './chunks/diff-change-Bm1zvVsC.cjs';
-import './chunks/write-tree-DVp0RJ_r.cjs';
+import './chunks/reflog-entry-DNvSz7S5.cjs';
+import './chunks/write-tree-CuhpWKFo.cjs';
 import './chunks/http-transport-DirKfK2S.cjs';
 
 /**

package/dist/types/index.default.d.ts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-BT7Xq1kJ.js';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DFxFeYi3.js';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.js';
-export { P as ProgressReporter } from './chunks/context-o5TPfMB2.js';
+export { P as ProgressReporter } from './chunks/context-BORy7yXb.js';
 import './commands/index.js';
-import './chunks/diff-change-alGRzD_j.js';
-import './chunks/write-tree-DNjhjS3t.js';
+import './chunks/reflog-entry-C2Hsdobk.js';
+import './chunks/write-tree-Dn1LtIh7.js';
 import './chunks/http-transport-DirKfK2S.js';
 
 /**

package/dist/types/index.node.d.cts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-23evW2h-.cjs';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DCR_3RVt.cjs';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.cjs';
-export { P as ProgressReporter } from './chunks/context-D84z1i5F.cjs';
+export { P as ProgressReporter } from './chunks/context-CMrHCVwK.cjs';
 import './commands/index.cjs';
-import './chunks/diff-change-Bm1zvVsC.cjs';
-import './chunks/write-tree-DVp0RJ_r.cjs';
+import './chunks/reflog-entry-DNvSz7S5.cjs';
+import './chunks/write-tree-CuhpWKFo.cjs';
 import './chunks/http-transport-DirKfK2S.cjs';
 
 /**

package/dist/types/index.node.d.ts

@@ -1,9 +1,9 @@
-import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-BT7Xq1kJ.js';
+import { O as OpenRepositoryOptions, R as Repository } from './chunks/repository-DFxFeYi3.js';
 export { AdapterSet, consoleProgress, detectRuntime, isBrowser, isNode, noopProgress } from './index.js';
-export { P as ProgressReporter } from './chunks/context-o5TPfMB2.js';
+export { P as ProgressReporter } from './chunks/context-BORy7yXb.js';
 import './commands/index.js';
-import './chunks/diff-change-alGRzD_j.js';
-import './chunks/write-tree-DNjhjS3t.js';
+import './chunks/reflog-entry-C2Hsdobk.js';
+import './chunks/write-tree-Dn1LtIh7.js';
 import './chunks/http-transport-DirKfK2S.js';
 
 /**

package/dist/types/primitives/index.d.cts

@@ -1,10 +1,13 @@
-import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-DVp0RJ_r.cjs';
-export { C as CreateCommitInput, D as DiffTreesInput, a as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, b as MAX_GITIGNORE_BYTES, c as MAX_HAVES, d as MAX_INDEX_BYTES, e as MAX_PEEL_DEPTH, f as MAX_PUSH_OBJECTS, g as MAX_SYMBOLIC_REF_DEPTH, h as MAX_WALK_QUEUE_SIZE, i as MAX_WALK_SEEDS, j as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, k as ResolveRefOptions, U as UpdateRefOptions, W as WalkCommitsOptions, l as WalkIgnorePredicate, m as WalkTreeEntry, n as WalkTreeOptions, o as WalkWorkingTreeEntry, p as WalkWorkingTreeOptions, q as createCommit, r as diffTrees, s as getRepoRoot, t as mergeBase, u as readBlob, v as readIndex, w as readObject, x as readTree, y as resolveRef, z as updateRef, A as walkCommits, B as walkTree, E as walkWorkingTree, F as writeObject, H as writeSymbolicRef, J as writeTree } from '../chunks/write-tree-DVp0RJ_r.cjs';
-import { d as FilePath, O as ObjectId, b as Context } from '../chunks/context-D84z1i5F.cjs';
-import { F as FileMode } from '../chunks/diff-change-Bm1zvVsC.cjs';
-export { T as TreeDiff } from '../chunks/diff-change-Bm1zvVsC.cjs';
+import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-CuhpWKFo.cjs';
+export { H as HookInput, c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, s as sparseCheckoutPath, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from '../chunks/write-tree-CuhpWKFo.cjs';
+import { d as FilePath, O as ObjectId, b as Context, R as RefName } from '../chunks/context-CMrHCVwK.cjs';
+import { F as FileMode, A as AuthorIdentity, q as ReflogEntry } from '../chunks/reflog-entry-DNvSz7S5.cjs';
+export { C as CatFileBatchEntry, a as CatFileBatchOptions, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, e as MAX_GITIGNORE_BYTES, f as MAX_GITMODULES_BYTES, g as MAX_HAVES, h as MAX_INDEX_BYTES, i as MAX_PEEL_DEPTH, j as MAX_PUSH_OBJECTS, k as MAX_REFLOG_BYTES, l as MAX_SUBMODULE_DEPTH, m as MAX_SYMBOLIC_REF_DEPTH, n as MAX_WALK_QUEUE_SIZE, o as MAX_WALK_SEEDS, p as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, r as ResolveRefOptions, S as SubmoduleEntry, s as TreeDiff, U as UpdateRefOptions, W as WalkCommitsOptions, u as WalkIgnorePredicate, v as WalkSubmodulesOptions, w as WalkTreeEntry, x as WalkTreeOptions, y as WalkWorkingTreeEntry, z as WalkWorkingTreeOptions } from '../chunks/reflog-entry-DNvSz7S5.cjs';
 import { b as HttpTransport } from '../chunks/http-transport-DirKfK2S.cjs';
 
+/** `true` ⇒ the path is in the sparse set (materialise it). */
+type SparseMatcher = (path: FilePath) => boolean;
+
 /**
  * Pure helper that diffs a current GitIndex against a target tree's flat
  * entry list and emits an ordered ChangesetEntry list. No FS, no ctx; the
@@ -49,6 +52,12 @@ interface ApplyChangesetResult {
     readonly written: number;
     readonly deleted: number;
 }
+/**
+ * `true` when a working-tree file exists at `absPath` but its blob content
+ * hash differs from `expectedId`. An absent file is not dirty. Shared by
+ * `applySparseCheckout`'s narrowing pre-scan (design §9).
+ */
+declare const isWorkingTreeDirty: (ctx: Context, absPath: string, expectedId: string) => Promise<boolean>;
 declare const applyChangeset: (ctx: Context, opts: ApplyChangesetOpts) => Promise<ApplyChangesetResult>;
 
 /**
@@ -77,6 +86,13 @@ declare const applyChangeset: (ctx: Context, opts: ApplyChangesetOpts) => Promis
 interface BuildIndexFromTreeOpts {
     readonly targetTree: ObjectId;
     readonly currentIndex: GitIndex;
+    /**
+     * Sparse-checkout filter. When supplied, an excluded path is rebuilt as a
+     * zero-stat skip-worktree entry and an in-pattern path has any stale
+     * skip-worktree bit cleared. `undefined` ⇒ sparse inactive — the rebuilt
+     * index is byte-identical to the non-sparse behaviour.
+     */
+    readonly sparse?: SparseMatcher;
 }
 declare const buildIndexFromTree: (ctx: Context, opts: BuildIndexFromTreeOpts) => Promise<ReadonlyArray<IndexEntry>>;
 
@@ -91,6 +107,56 @@ interface BuildPackResult {
 }
 declare const buildPack: (ctx: Context, input: BuildPackInput) => Promise<BuildPackResult>;
 
+/**
+ * Subset of `.git/config` that v1 commands consume. Only fields actually used by
+ * commands are typed — the parser ignores everything else (lenient, like git itself).
+ */
+interface ParsedConfig {
+    readonly core?: {
+        readonly bare?: boolean;
+        readonly excludesFile?: string;
+        readonly logAllRefUpdates?: boolean | 'always';
+        readonly hooksPath?: string;
+        readonly sparseCheckout?: boolean;
+        readonly sparseCheckoutCone?: boolean;
+    };
+    readonly user?: {
+        readonly name: string;
+        readonly email: string;
+    };
+    readonly remote?: ReadonlyMap<string, {
+        readonly url?: string;
+        readonly fetch?: ReadonlyArray<string>;
+        /** `remote.<name>.promisor` — true when this is a partial-clone promisor remote. */
+        readonly promisor?: boolean;
+        /** `remote.<name>.partialclonefilter` — the canonical filter spec applied at clone. */
+        readonly partialCloneFilter?: string;
+    }>;
+    readonly branch?: ReadonlyMap<string, {
+        readonly remote?: string;
+        readonly merge?: string;
+    }>;
+    /** `[extensions]` — `partialClone` names the promisor remote of a partial clone. */
+    readonly extensions?: {
+        readonly partialClone?: string;
+    };
+}
+/**
+ * Read and cache `${gitDir}/config`. Missing → empty config (not an error).
+ *
+ * The cache is keyed on `Context` identity; a new context (e.g., after a write
+ * that re-creates the repo) gets a fresh read. Concurrent calls share the same
+ * in-flight promise (per-context single-flight).
+ */
+declare const readConfig: (ctx: Context) => Promise<ParsedConfig>;
+/**
+ * Drop the cached `readConfig` entry for a single `Context`. The production
+ * invalidator: a config write (`updateCoreConfig`) calls this so a subsequent
+ * `readConfig` on the same context re-reads the file instead of serving the
+ * stale parse.
+ */
+declare const invalidateConfigCache: (ctx: Context) => void;
+
 interface EnumeratePushObjectsInput {
     /**
      * Object ids the caller wants on the remote. Each MUST resolve to a
@@ -105,6 +171,14 @@ interface EnumeratePushObjectsInput {
 }
 declare function enumeratePushObjects(ctx: Context, input: EnumeratePushObjectsInput): AsyncIterable<ObjectId>;
 
+/**
+ * Enumerate every current ref: `HEAD`, loose refs under `.git/refs/**`, and
+ * packed-refs entries — deduplicated. Used by `reflog expire` to seed the
+ * reachable-commit walk; not on any hot path.
+ */
+
+declare function enumerateRefs(ctx: Context): Promise<ReadonlyArray<RefName>>;
+
 interface FetchPackInput {
     /** Advertised refs the caller wants. MUST be non-empty (server-side requirement). */
     readonly wants: ReadonlyArray<ObjectId>;
@@ -122,6 +196,17 @@ interface FetchPackInput {
      *
      */
     readonly depth?: number;
+    /**
+     * Partial-clone object filter — a canonical filter spec. When set, a
+     * `filter` line is emitted; the caller must have negotiated the `filter`
+     * capability.
+     */
+    readonly filter?: string;
+    /**
+     * When true, write an empty `pack-<sha>.promisor` sentinel beside the pack
+     * so the objects it references but omits are treated as promised.
+     */
+    readonly promisor?: boolean;
 }
 interface FetchPackResult {
     readonly packPath: string;
@@ -180,6 +265,17 @@ interface MaterializeTreeOpts {
      * 13.1 checkout behaviour: clean files are never spuriously rewritten.
      */
     readonly forceRewriteAll?: boolean;
+    /**
+     * Branch-switch sparse-checkout filter. Honoured ONLY when `paths` is
+     * undefined. A target-tree path the matcher rejects is NOT written to the
+     * working tree; its `newIndexEntries` record carries `skipWorktree: true`
+     * (the index keeps every path — git-faithful). A path the matcher accepts
+     * that the *current* index records as skip-worktree (absent on disk) is
+     * materialised even when its `id` matches, because the current index is
+     * filtered to drop skip-worktree entries before the diff — such a path
+     * classifies as `add`, never `noop`.
+     */
+    readonly sparse?: SparseMatcher;
 }
 interface MaterializeTreeResult {
     readonly newIndexEntries: ReadonlyArray<IndexEntry>;
@@ -188,6 +284,53 @@ interface MaterializeTreeResult {
 }
 declare const materializeTree: (ctx: Context, opts: MaterializeTreeOpts) => Promise<MaterializeTreeResult>;
 
+/**
+ * Hard cap on the `.git/info/sparse-checkout` file — 1 MiB, mirroring
+ * `MAX_GITIGNORE_BYTES`. A plain literal (not `1024 * 1024`) so a boundary test
+ * keyed on the constant cannot drift with an arithmetic mutation of it.
+ */
+declare const MAX_SPARSE_PATTERN_FILE_BYTES = 1048576;
+/**
+ * Read `.git/info/sparse-checkout` as UTF-8 text. An absent file yields
+ * `undefined`; a file whose byte length exceeds
+ * `MAX_SPARSE_PATTERN_FILE_BYTES` throws `SPARSE_PATTERN_FILE_TOO_LARGE`
+ * (checked before decode so an over-cap file never reaches the decoder).
+ */
+declare const readSparsePatternText: (ctx: Context) => Promise<string | undefined>;
+/**
+ * Build the sparse matcher for the current repository. Returns `undefined`
+ * when `core.sparseCheckout` is falsy/absent — sparse is inactive and callers
+ * behave exactly as a non-sparse repo. When active, the matcher is parsed in
+ * the mode `core.sparseCheckoutCone` dictates; a cone file that degrades to
+ * non-cone matching logs one warning.
+ */
+declare const loadSparseMatcher: (ctx: Context) => Promise<SparseMatcher | undefined>;
+
+/**
+ * Committer identity for reflog entries: config `user.*` plus a fresh
+ * timestamp, or a portable fallback when `user.*` is unset. Never throws —
+ * reflog logging must not abort a ref update.
+ */
+declare function resolveReflogIdentity(ctx: Context): Promise<AuthorIdentity>;
+
+/**
+ * Thin I/O layer over `.git/logs/<ref>` reflog files. Append is the hot path;
+ * whole-file rewrite and delete back the `reflog` command's expire / delete.
+ */
+
+/** Append one entry to `ref`'s reflog, creating the file and parents as needed. */
+declare function appendReflog(ctx: Context, ref: RefName, entry: ReflogEntry): Promise<void>;
+/** Read `ref`'s reflog, oldest-first. Returns `[]` when the file is absent. */
+declare function readReflog(ctx: Context, ref: RefName): Promise<ReadonlyArray<ReflogEntry>>;
+/** Whether `ref` has a reflog file at all. */
+declare function reflogExists(ctx: Context, ref: RefName): Promise<boolean>;
+/** Replace `ref`'s reflog with exactly `entries`. Used by expire / delete. */
+declare function writeReflog(ctx: Context, ref: RefName, entries: ReadonlyArray<ReflogEntry>): Promise<void>;
+/** Remove `ref`'s reflog file. A no-op when the file is already absent. */
+declare function deleteReflog(ctx: Context, ref: RefName): Promise<void>;
+/** Every reflog under `.git/logs/`, each as the `RefName` it logs. */
+declare function listReflogs(ctx: Context): Promise<ReadonlyArray<RefName>>;
+
 /**
  * Read `.git/shallow`. Returns an empty set when the file does not exist or
  * contains no oids. Malformed lines are tolerated (skipped) — canonical
@@ -250,5 +393,52 @@ declare const updateShallow: (ctx: Context, updates: ShallowUpdate) => Promise<v
  */
 declare const synthesizeTreeFromIndex: (ctx: Context, entries: ReadonlyArray<IndexEntry>) => Promise<ObjectId>;
 
-export { applyChangeset, buildIndexFromTree, buildPack, computeChangeset, enumeratePushObjects, fetchPack, materializeTree, readShallow, synthesizeTreeFromIndex, updateShallow };
-export type { ApplyChangesetOpts, ApplyChangesetResult, BuildIndexFromTreeOpts, BuildPackInput, BuildPackResult, Changeset, ChangesetEntry, ChangesetStats, EnumeratePushObjectsInput, FetchPackInput, FetchPackResult, MaterializeTreeOpts, MaterializeTreeResult };
+/**
+ * Set `key` under `[section]` / `[section "subsection"]`, preserving every
+ * other byte verbatim.
+ *
+ * - existing section with that key ⇒ its value is replaced;
+ * - existing section without that key ⇒ a `\t<key> = <value>` line is
+ *   inserted right after the header;
+ * - no such section ⇒ `[section]\n\t<key> = <value>\n` is appended.
+ */
+declare const setConfigEntry: (text: string, section: string, subsection: string | undefined, key: string, value: string) => string;
+/** `setConfigEntry` bound to the `[core]` section — kept for legacy callers. */
+declare const setCoreConfigEntry: (text: string, key: string, value: string) => string;
+/** One `key = value` write under `[section]` / `[section "subsection"]`. */
+interface ConfigEntry {
+    readonly section: string;
+    readonly subsection?: string;
+    readonly key: string;
+    readonly value: string;
+}
+/**
+ * Read `${gitDir}/config` (a missing file is treated as `''`), fold
+ * `setConfigEntry` over `entries`, write the result, and invalidate the
+ * per-`Context` `readConfig` cache so a later read sees the new values.
+ */
+declare const updateConfigEntries: (ctx: Context, entries: ReadonlyArray<ConfigEntry>) => Promise<void>;
+/** Fold a batch of `[core]` `key = value` writes via `updateConfigEntries`. */
+declare const updateCoreConfig: (ctx: Context, entries: Record<string, string>) => Promise<void>;
+
+/**
+ * Write the `.git/info/sparse-checkout` pattern file. The command tier
+ * computes the text (via `serializeCone` or raw non-cone lines); this
+ * primitive only persists it (design §7.3).
+ *
+ * @writes
+ *   surface: sparseCheckoutFile
+ *   kind:    byte-identical
+ *   format:  git-sparse-checkout
+ */
+
+/**
+ * Persist `text` to `.git/info/sparse-checkout`. The `.git/info` directory is
+ * created defensively first — `writeUtf8` creates parents on every adapter,
+ * but an explicit `mkdir` keeps the contract clear and survives adapters that
+ * tighten that guarantee.
+ */
+declare const writeSparsePatternText: (ctx: Context, text: string) => Promise<void>;
+
+export { MAX_SPARSE_PATTERN_FILE_BYTES, appendReflog, applyChangeset, buildIndexFromTree, buildPack, computeChangeset, deleteReflog, enumeratePushObjects, enumerateRefs, fetchPack, invalidateConfigCache, isWorkingTreeDirty, listReflogs, loadSparseMatcher, materializeTree, readConfig, readReflog, readShallow, readSparsePatternText, reflogExists, resolveReflogIdentity, setConfigEntry, setCoreConfigEntry, synthesizeTreeFromIndex, updateConfigEntries, updateCoreConfig, updateShallow, writeReflog, writeSparsePatternText };
+export type { ApplyChangesetOpts, ApplyChangesetResult, BuildIndexFromTreeOpts, BuildPackInput, BuildPackResult, Changeset, ChangesetEntry, ChangesetStats, ConfigEntry, EnumeratePushObjectsInput, FetchPackInput, FetchPackResult, MaterializeTreeOpts, MaterializeTreeResult, ParsedConfig };

package/dist/types/primitives/index.d.ts

@@ -1,10 +1,13 @@
-import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-DNjhjS3t.js';
-export { C as CreateCommitInput, D as DiffTreesInput, a as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, b as MAX_GITIGNORE_BYTES, c as MAX_HAVES, d as MAX_INDEX_BYTES, e as MAX_PEEL_DEPTH, f as MAX_PUSH_OBJECTS, g as MAX_SYMBOLIC_REF_DEPTH, h as MAX_WALK_QUEUE_SIZE, i as MAX_WALK_SEEDS, j as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, k as ResolveRefOptions, U as UpdateRefOptions, W as WalkCommitsOptions, l as WalkIgnorePredicate, m as WalkTreeEntry, n as WalkTreeOptions, o as WalkWorkingTreeEntry, p as WalkWorkingTreeOptions, q as createCommit, r as diffTrees, s as getRepoRoot, t as mergeBase, u as readBlob, v as readIndex, w as readObject, x as readTree, y as resolveRef, z as updateRef, A as walkCommits, B as walkTree, E as walkWorkingTree, F as writeObject, H as writeSymbolicRef, J as writeTree } from '../chunks/write-tree-DNjhjS3t.js';
-import { d as FilePath, O as ObjectId, b as Context } from '../chunks/context-o5TPfMB2.js';
-import { F as FileMode } from '../chunks/diff-change-alGRzD_j.js';
-export { T as TreeDiff } from '../chunks/diff-change-alGRzD_j.js';
+import { G as GitIndex, I as IndexEntry } from '../chunks/write-tree-Dn1LtIh7.js';
+export { H as HookInput, c as catFileBatch, a as createCommit, d as diffTrees, g as getRepoRoot, m as mergeBase, r as readBlob, b as readIndex, e as readObject, f as readTree, h as recordRefUpdate, i as resolveRef, j as runHook, s as sparseCheckoutPath, u as updateRef, w as walkCommits, k as walkSubmodules, l as walkTree, n as walkWorkingTree, o as writeObject, p as writeSymbolicRef, q as writeTree } from '../chunks/write-tree-Dn1LtIh7.js';
+import { d as FilePath, O as ObjectId, b as Context, R as RefName } from '../chunks/context-BORy7yXb.js';
+import { F as FileMode, A as AuthorIdentity, q as ReflogEntry } from '../chunks/reflog-entry-C2Hsdobk.js';
+export { C as CatFileBatchEntry, a as CatFileBatchOptions, c as CreateCommitInput, D as DiffTreesInput, d as DiffTreesOptions, M as MAX_COMMIT_MESSAGE_BYTES, e as MAX_GITIGNORE_BYTES, f as MAX_GITMODULES_BYTES, g as MAX_HAVES, h as MAX_INDEX_BYTES, i as MAX_PEEL_DEPTH, j as MAX_PUSH_OBJECTS, k as MAX_REFLOG_BYTES, l as MAX_SUBMODULE_DEPTH, m as MAX_SYMBOLIC_REF_DEPTH, n as MAX_WALK_QUEUE_SIZE, o as MAX_WALK_SEEDS, p as MAX_WORKING_TREE_BLOB_BYTES, R as ReadObjectOptions, r as ResolveRefOptions, S as SubmoduleEntry, s as TreeDiff, U as UpdateRefOptions, W as WalkCommitsOptions, u as WalkIgnorePredicate, v as WalkSubmodulesOptions, w as WalkTreeEntry, x as WalkTreeOptions, y as WalkWorkingTreeEntry, z as WalkWorkingTreeOptions } from '../chunks/reflog-entry-C2Hsdobk.js';
 import { b as HttpTransport } from '../chunks/http-transport-DirKfK2S.js';
 
+/** `true` ⇒ the path is in the sparse set (materialise it). */
+type SparseMatcher = (path: FilePath) => boolean;
+
 /**
  * Pure helper that diffs a current GitIndex against a target tree's flat
  * entry list and emits an ordered ChangesetEntry list. No FS, no ctx; the
@@ -49,6 +52,12 @@ interface ApplyChangesetResult {
     readonly written: number;
     readonly deleted: number;
 }
+/**
+ * `true` when a working-tree file exists at `absPath` but its blob content
+ * hash differs from `expectedId`. An absent file is not dirty. Shared by
+ * `applySparseCheckout`'s narrowing pre-scan (design §9).
+ */
+declare const isWorkingTreeDirty: (ctx: Context, absPath: string, expectedId: string) => Promise<boolean>;
 declare const applyChangeset: (ctx: Context, opts: ApplyChangesetOpts) => Promise<ApplyChangesetResult>;
 
 /**
@@ -77,6 +86,13 @@ declare const applyChangeset: (ctx: Context, opts: ApplyChangesetOpts) => Promis
 interface BuildIndexFromTreeOpts {
     readonly targetTree: ObjectId;
     readonly currentIndex: GitIndex;
+    /**
+     * Sparse-checkout filter. When supplied, an excluded path is rebuilt as a
+     * zero-stat skip-worktree entry and an in-pattern path has any stale
+     * skip-worktree bit cleared. `undefined` ⇒ sparse inactive — the rebuilt
+     * index is byte-identical to the non-sparse behaviour.
+     */
+    readonly sparse?: SparseMatcher;
 }
 declare const buildIndexFromTree: (ctx: Context, opts: BuildIndexFromTreeOpts) => Promise<ReadonlyArray<IndexEntry>>;
 
@@ -91,6 +107,56 @@ interface BuildPackResult {
 }
 declare const buildPack: (ctx: Context, input: BuildPackInput) => Promise<BuildPackResult>;
 
+/**
+ * Subset of `.git/config` that v1 commands consume. Only fields actually used by
+ * commands are typed — the parser ignores everything else (lenient, like git itself).
+ */
+interface ParsedConfig {
+    readonly core?: {
+        readonly bare?: boolean;
+        readonly excludesFile?: string;
+        readonly logAllRefUpdates?: boolean | 'always';
+        readonly hooksPath?: string;
+        readonly sparseCheckout?: boolean;
+        readonly sparseCheckoutCone?: boolean;
+    };
+    readonly user?: {
+        readonly name: string;
+        readonly email: string;
+    };
+    readonly remote?: ReadonlyMap<string, {
+        readonly url?: string;
+        readonly fetch?: ReadonlyArray<string>;
+        /** `remote.<name>.promisor` — true when this is a partial-clone promisor remote. */
+        readonly promisor?: boolean;
+        /** `remote.<name>.partialclonefilter` — the canonical filter spec applied at clone. */
+        readonly partialCloneFilter?: string;
+    }>;
+    readonly branch?: ReadonlyMap<string, {
+        readonly remote?: string;
+        readonly merge?: string;
+    }>;
+    /** `[extensions]` — `partialClone` names the promisor remote of a partial clone. */
+    readonly extensions?: {
+        readonly partialClone?: string;
+    };
+}
+/**
+ * Read and cache `${gitDir}/config`. Missing → empty config (not an error).
+ *
+ * The cache is keyed on `Context` identity; a new context (e.g., after a write
+ * that re-creates the repo) gets a fresh read. Concurrent calls share the same
+ * in-flight promise (per-context single-flight).
+ */
+declare const readConfig: (ctx: Context) => Promise<ParsedConfig>;
+/**
+ * Drop the cached `readConfig` entry for a single `Context`. The production
+ * invalidator: a config write (`updateCoreConfig`) calls this so a subsequent
+ * `readConfig` on the same context re-reads the file instead of serving the
+ * stale parse.
+ */
+declare const invalidateConfigCache: (ctx: Context) => void;
+
 interface EnumeratePushObjectsInput {
     /**
      * Object ids the caller wants on the remote. Each MUST resolve to a
@@ -105,6 +171,14 @@ interface EnumeratePushObjectsInput {
 }
 declare function enumeratePushObjects(ctx: Context, input: EnumeratePushObjectsInput): AsyncIterable<ObjectId>;
 
+/**
+ * Enumerate every current ref: `HEAD`, loose refs under `.git/refs/**`, and
+ * packed-refs entries — deduplicated. Used by `reflog expire` to seed the
+ * reachable-commit walk; not on any hot path.
+ */
+
+declare function enumerateRefs(ctx: Context): Promise<ReadonlyArray<RefName>>;
+
 interface FetchPackInput {
     /** Advertised refs the caller wants. MUST be non-empty (server-side requirement). */
     readonly wants: ReadonlyArray<ObjectId>;
@@ -122,6 +196,17 @@ interface FetchPackInput {
      *
      */
     readonly depth?: number;
+    /**
+     * Partial-clone object filter — a canonical filter spec. When set, a
+     * `filter` line is emitted; the caller must have negotiated the `filter`
+     * capability.
+     */
+    readonly filter?: string;
+    /**
+     * When true, write an empty `pack-<sha>.promisor` sentinel beside the pack
+     * so the objects it references but omits are treated as promised.
+     */
+    readonly promisor?: boolean;
 }
 interface FetchPackResult {
     readonly packPath: string;
@@ -180,6 +265,17 @@ interface MaterializeTreeOpts {
      * 13.1 checkout behaviour: clean files are never spuriously rewritten.
      */
     readonly forceRewriteAll?: boolean;
+    /**
+     * Branch-switch sparse-checkout filter. Honoured ONLY when `paths` is
+     * undefined. A target-tree path the matcher rejects is NOT written to the
+     * working tree; its `newIndexEntries` record carries `skipWorktree: true`
+     * (the index keeps every path — git-faithful). A path the matcher accepts
+     * that the *current* index records as skip-worktree (absent on disk) is
+     * materialised even when its `id` matches, because the current index is
+     * filtered to drop skip-worktree entries before the diff — such a path
+     * classifies as `add`, never `noop`.
+     */
+    readonly sparse?: SparseMatcher;
 }
 interface MaterializeTreeResult {
     readonly newIndexEntries: ReadonlyArray<IndexEntry>;
@@ -188,6 +284,53 @@ interface MaterializeTreeResult {
 }
 declare const materializeTree: (ctx: Context, opts: MaterializeTreeOpts) => Promise<MaterializeTreeResult>;
 
+/**
+ * Hard cap on the `.git/info/sparse-checkout` file — 1 MiB, mirroring
+ * `MAX_GITIGNORE_BYTES`. A plain literal (not `1024 * 1024`) so a boundary test
+ * keyed on the constant cannot drift with an arithmetic mutation of it.
+ */
+declare const MAX_SPARSE_PATTERN_FILE_BYTES = 1048576;
+/**
+ * Read `.git/info/sparse-checkout` as UTF-8 text. An absent file yields
+ * `undefined`; a file whose byte length exceeds
+ * `MAX_SPARSE_PATTERN_FILE_BYTES` throws `SPARSE_PATTERN_FILE_TOO_LARGE`
+ * (checked before decode so an over-cap file never reaches the decoder).
+ */
+declare const readSparsePatternText: (ctx: Context) => Promise<string | undefined>;
+/**
+ * Build the sparse matcher for the current repository. Returns `undefined`
+ * when `core.sparseCheckout` is falsy/absent — sparse is inactive and callers
+ * behave exactly as a non-sparse repo. When active, the matcher is parsed in
+ * the mode `core.sparseCheckoutCone` dictates; a cone file that degrades to
+ * non-cone matching logs one warning.
+ */
+declare const loadSparseMatcher: (ctx: Context) => Promise<SparseMatcher | undefined>;
+
+/**
+ * Committer identity for reflog entries: config `user.*` plus a fresh
+ * timestamp, or a portable fallback when `user.*` is unset. Never throws —
+ * reflog logging must not abort a ref update.
+ */
+declare function resolveReflogIdentity(ctx: Context): Promise<AuthorIdentity>;
+
+/**
+ * Thin I/O layer over `.git/logs/<ref>` reflog files. Append is the hot path;
+ * whole-file rewrite and delete back the `reflog` command's expire / delete.
+ */
+
+/** Append one entry to `ref`'s reflog, creating the file and parents as needed. */
+declare function appendReflog(ctx: Context, ref: RefName, entry: ReflogEntry): Promise<void>;
+/** Read `ref`'s reflog, oldest-first. Returns `[]` when the file is absent. */
+declare function readReflog(ctx: Context, ref: RefName): Promise<ReadonlyArray<ReflogEntry>>;
+/** Whether `ref` has a reflog file at all. */
+declare function reflogExists(ctx: Context, ref: RefName): Promise<boolean>;
+/** Replace `ref`'s reflog with exactly `entries`. Used by expire / delete. */
+declare function writeReflog(ctx: Context, ref: RefName, entries: ReadonlyArray<ReflogEntry>): Promise<void>;
+/** Remove `ref`'s reflog file. A no-op when the file is already absent. */
+declare function deleteReflog(ctx: Context, ref: RefName): Promise<void>;
+/** Every reflog under `.git/logs/`, each as the `RefName` it logs. */
+declare function listReflogs(ctx: Context): Promise<ReadonlyArray<RefName>>;
+
 /**
  * Read `.git/shallow`. Returns an empty set when the file does not exist or
  * contains no oids. Malformed lines are tolerated (skipped) — canonical
@@ -250,5 +393,52 @@ declare const updateShallow: (ctx: Context, updates: ShallowUpdate) => Promise<v
  */
 declare const synthesizeTreeFromIndex: (ctx: Context, entries: ReadonlyArray<IndexEntry>) => Promise<ObjectId>;
 
-export { applyChangeset, buildIndexFromTree, buildPack, computeChangeset, enumeratePushObjects, fetchPack, materializeTree, readShallow, synthesizeTreeFromIndex, updateShallow };
-export type { ApplyChangesetOpts, ApplyChangesetResult, BuildIndexFromTreeOpts, BuildPackInput, BuildPackResult, Changeset, ChangesetEntry, ChangesetStats, EnumeratePushObjectsInput, FetchPackInput, FetchPackResult, MaterializeTreeOpts, MaterializeTreeResult };
+/**
+ * Set `key` under `[section]` / `[section "subsection"]`, preserving every
+ * other byte verbatim.
+ *
+ * - existing section with that key ⇒ its value is replaced;
+ * - existing section without that key ⇒ a `\t<key> = <value>` line is
+ *   inserted right after the header;
+ * - no such section ⇒ `[section]\n\t<key> = <value>\n` is appended.
+ */
+declare const setConfigEntry: (text: string, section: string, subsection: string | undefined, key: string, value: string) => string;
+/** `setConfigEntry` bound to the `[core]` section — kept for legacy callers. */
+declare const setCoreConfigEntry: (text: string, key: string, value: string) => string;
+/** One `key = value` write under `[section]` / `[section "subsection"]`. */
+interface ConfigEntry {
+    readonly section: string;
+    readonly subsection?: string;
+    readonly key: string;
+    readonly value: string;
+}
+/**
+ * Read `${gitDir}/config` (a missing file is treated as `''`), fold
+ * `setConfigEntry` over `entries`, write the result, and invalidate the
+ * per-`Context` `readConfig` cache so a later read sees the new values.
+ */
+declare const updateConfigEntries: (ctx: Context, entries: ReadonlyArray<ConfigEntry>) => Promise<void>;
+/** Fold a batch of `[core]` `key = value` writes via `updateConfigEntries`. */
+declare const updateCoreConfig: (ctx: Context, entries: Record<string, string>) => Promise<void>;
+
+/**
+ * Write the `.git/info/sparse-checkout` pattern file. The command tier
+ * computes the text (via `serializeCone` or raw non-cone lines); this
+ * primitive only persists it (design §7.3).
+ *
+ * @writes
+ *   surface: sparseCheckoutFile
+ *   kind:    byte-identical
+ *   format:  git-sparse-checkout
+ */
+
+/**
+ * Persist `text` to `.git/info/sparse-checkout`. The `.git/info` directory is
+ * created defensively first — `writeUtf8` creates parents on every adapter,
+ * but an explicit `mkdir` keeps the contract clear and survives adapters that
+ * tighten that guarantee.
+ */
+declare const writeSparsePatternText: (ctx: Context, text: string) => Promise<void>;
+
+export { MAX_SPARSE_PATTERN_FILE_BYTES, appendReflog, applyChangeset, buildIndexFromTree, buildPack, computeChangeset, deleteReflog, enumeratePushObjects, enumerateRefs, fetchPack, invalidateConfigCache, isWorkingTreeDirty, listReflogs, loadSparseMatcher, materializeTree, readConfig, readReflog, readShallow, readSparsePatternText, reflogExists, resolveReflogIdentity, setConfigEntry, setCoreConfigEntry, synthesizeTreeFromIndex, updateConfigEntries, updateCoreConfig, updateShallow, writeReflog, writeSparsePatternText };
+export type { ApplyChangesetOpts, ApplyChangesetResult, BuildIndexFromTreeOpts, BuildPackInput, BuildPackResult, Changeset, ChangesetEntry, ChangesetStats, ConfigEntry, EnumeratePushObjectsInput, FetchPackInput, FetchPackResult, MaterializeTreeOpts, MaterializeTreeResult, ParsedConfig };