dsh-git-branch-manage 1.0.4 → 1.0.6

package/lib/git.d.ts

@@ -182,6 +182,28 @@ export declare function switchBranch(exec: Exec, checkoutDir: string, branch: st
  * start point with `checkout` false).
  */
 export declare function createBranch(exec: Exec, cwd: string, name: string, from?: string, checkout?: boolean): Promise<string>;
+/** Outcome of {@link createTag}: the tag created and the commit it points at. */
+export interface TagOutcome {
+    tag: string;
+    hash: string;
+}
+/**
+ * Create a tag at an existing commit (`git tag`). Tags are repository-wide
+ * refs, so the command runs at the repository root.
+ *
+ * A message makes it an ANNOTATED tag (`-a -m`) — the only shape that carries
+ * an author and date, and what `git describe` prefers; without one the tag is
+ * lightweight and is just an alias for the commit. Both are created locally
+ * only: pushing a tag is a deliberate, separate publish step that this panel
+ * does not perform on a menu click.
+ * @param exec - executor seam.
+ * @param repoRoot - main worktree directory.
+ * @param name - tag name (git validates; failures raise GitError).
+ * @param target - commit to tag; absent tags the repository's current HEAD.
+ * @param message - optional annotation message; non-empty = annotated tag.
+ * @returns the tag name and the commit hash it points at.
+ */
+export declare function createTag(exec: Exec, repoRoot: string, name: string, target?: string, message?: string): Promise<TagOutcome>;
 /**
  * Rename a LOCAL branch (`git branch -m`): branch refs are repository-wide,
  * so the command runs at the repository root and every worktree HEAD pointing
@@ -207,6 +229,20 @@ export declare function renameBranch(exec: Exec, repoRoot: string, name: string,
  * @returns the name of the branch that was deleted.
  */
 export declare function deleteBranch(exec: Exec, repoRoot: string, name: string): Promise<string>;
+/**
+ * argv prefix for network READ commands when cn-accelerate is on: the
+ * per-command `url.<base>.insteadOf=https://github.com/` rewrite. Per-command
+ * `git -c` (before the subcommand) rather than the user's global git config —
+ * the plugin must never persist settings on the user's behalf, and one
+ * injected value cannot leak into unrelated git runs. Rewrites
+ * `https://github.com/o/r.git` → `<base>https://github.com/o/r.git`, which is
+ * how public mirror prefixes consume GitHub URLs.
+ * @param prefix - the accelerate URL (raw or normalized); undefined = off.
+ * @returns the `-c` pair to prepend, or `[]` when off or the value is
+ * unusable (an invalid value fails SAFE to a direct connection — config
+ * validation rejects such values at load; this is the defensive path).
+ */
+export declare function accelArgs(prefix: string | undefined): readonly string[];
 /**
  * Sync remote-tracking refs: fetch every remote and prune tracking branches
  * the remotes no longer carry (the CLI equivalent of IDEA's "synchronize
@@ -215,8 +251,10 @@ export declare function deleteBranch(exec: Exec, repoRoot: string, name: string)
  * executor's hard timeout as a GitError.
  * @param exec - executor seam.
  * @param repoRoot - main worktree directory (fetch is repository-wide).
+ * @param accelPrefix - optional cn-accelerate mirror prefix (see
+ * {@link accelArgs}); only the READ half of the network commands gets it.
  */
-export declare function fetchAll(exec: Exec, repoRoot: string): Promise<void>;
+export declare function fetchAll(exec: Exec, repoRoot: string, accelPrefix?: string): Promise<void>;
 /** Outcome of {@link updateBranch}: the branch touched and whether it moved. */
 export interface UpdateOutcome {
     branch: string;
@@ -233,10 +271,12 @@ export interface UpdateOutcome {
  * branch ITS worktree holds.
  * @param exec - executor seam.
  * @param cwd - directory whose checked-out branch is updated.
+ * @param accelPrefix - optional cn-accelerate mirror prefix; feeds ONLY the
+ * fetch phase ({@link fetchAll}) — the `--ff-only` merge is local.
  * @returns the branch name and whether HEAD actually moved (false = the
  * upstream already contained it).
  */
-export declare function updateBranch(exec: Exec, cwd: string): Promise<UpdateOutcome>;
+export declare function updateBranch(exec: Exec, cwd: string, accelPrefix?: string): Promise<UpdateOutcome>;
 /** Outcome of {@link pushBranch}: the branch touched and whether it moved. */
 export interface PushOutcome {
     branch: string;
@@ -249,7 +289,11 @@ export interface PushOutcome {
  * git's own message rather than silently picking one), and `--force` is
  * never passed — a diverged remote refuses rather than losing commits.
  * Runs at the queried directory's own toplevel, so a linked-worktree
- * session pushes the branch ITS worktree holds.
+ * session pushes the branch ITS worktree holds. The cn-accelerate rewrite is
+ * deliberately NEVER injected here (no {@link accelArgs} parameter exists):
+ * public mirrors have no `receive-pack`, and rewriting would turn a
+ * diagnosable direct failure into an opaque mirror failure while leaking the
+ * pushed content to a third party.
  * @param exec - executor seam.
  * @param cwd - directory whose checked-out branch is pushed.
  * @returns the branch and whether the remote-tracking ref changed. A branch
@@ -425,18 +469,34 @@ export interface CommitEntryRaw {
     body: string;
     refs: string[];
 }
+/** The extra log filters the history card's toolbar drives. */
+export interface LogFilter {
+    /** Every ref (local + remote branches, tags) instead of the checkout's
+     * HEAD — the history card's default view. Ignored when `ref` is given. */
+    all?: boolean;
+    /** Committer-author substring/regex, forwarded as `--author=<value>`. */
+    author?: string;
+    /** Lower/upper bound on the commit date, epoch milliseconds. */
+    since?: number;
+    until?: number;
+}
 /**
  * Paginated history of the queried checkout. `ref` is verified with
  * `rev-parse --verify` first, so an arbitrary string can never reach the log
  * arguments as anything but a resolvable rev. An unborn checkout (no commits
  * yet) answers an empty page instead of an error.
+ *
+ * `--topo-order` is unconditional: the history card draws lane lines from
+ * `parents`, and a pure date order would interleave a branch's commits
+ * before their merge base, leaving edges pointing at rows not yet painted.
  * @param exec - executor seam.
  * @param cwd - the checkout directory.
  * @param limit - page size (1..200, validated upstream).
  * @param skip - offset (>= 0, validated upstream).
  * @param ref - optional starting rev; absent = the checkout's HEAD.
+ * @param filter - optional all-refs/author/date window.
  */
-export declare function logHistory(exec: Exec, cwd: string, limit: number, skip: number, ref?: string): Promise<CommitEntryRaw[]>;
+export declare function logHistory(exec: Exec, cwd: string, limit: number, skip: number, ref?: string, filter?: LogFilter): Promise<CommitEntryRaw[]>;
 /** One file row of {@link commitFiles}. */
 export interface CommitFileRow {
     path: string;

package/lib/git.js

@@ -7,7 +7,7 @@ import { execFile } from 'node:child_process';
 import { existsSync, readdirSync } from 'node:fs';
 import { appendFile, mkdir, readFile, rm } from 'node:fs/promises';
 import { basename, dirname, isAbsolute, join, normalize, resolve } from 'node:path';
-import { localBranchName } from './normalize.js';
+import { accelerateUrlError, localBranchName, normalizeAccelerateUrl } from './normalize.js';
 /** Failure of one git invocation: non-zero exit with the stderr text. */
 export class GitError extends Error {
     args;
@@ -433,6 +433,35 @@ export async function createBranch(exec, cwd, name, from, checkout = false) {
     await git(exec, cwd, ['branch', name, from]);
     return name;
 }
+/**
+ * Create a tag at an existing commit (`git tag`). Tags are repository-wide
+ * refs, so the command runs at the repository root.
+ *
+ * A message makes it an ANNOTATED tag (`-a -m`) — the only shape that carries
+ * an author and date, and what `git describe` prefers; without one the tag is
+ * lightweight and is just an alias for the commit. Both are created locally
+ * only: pushing a tag is a deliberate, separate publish step that this panel
+ * does not perform on a menu click.
+ * @param exec - executor seam.
+ * @param repoRoot - main worktree directory.
+ * @param name - tag name (git validates; failures raise GitError).
+ * @param target - commit to tag; absent tags the repository's current HEAD.
+ * @param message - optional annotation message; non-empty = annotated tag.
+ * @returns the tag name and the commit hash it points at.
+ */
+export async function createTag(exec, repoRoot, name, target, message) {
+    const text = message?.trim() ?? '';
+    const args = ['tag'];
+    if (text !== '')
+        args.push('-a', name, '-m', text);
+    else
+        args.push(name);
+    if (target !== undefined && target !== '')
+        args.push(target);
+    await git(exec, repoRoot, args);
+    const hash = (await git(exec, repoRoot, ['rev-list', '-n', '1', name])).trim();
+    return { tag: name, hash };
+}
 /**
  * Rename a LOCAL branch (`git branch -m`): branch refs are repository-wide,
  * so the command runs at the repository root and every worktree HEAD pointing
@@ -464,6 +493,24 @@ export async function deleteBranch(exec, repoRoot, name) {
     await git(exec, repoRoot, ['branch', '-d', name]);
     return name;
 }
+/**
+ * argv prefix for network READ commands when cn-accelerate is on: the
+ * per-command `url.<base>.insteadOf=https://github.com/` rewrite. Per-command
+ * `git -c` (before the subcommand) rather than the user's global git config —
+ * the plugin must never persist settings on the user's behalf, and one
+ * injected value cannot leak into unrelated git runs. Rewrites
+ * `https://github.com/o/r.git` → `<base>https://github.com/o/r.git`, which is
+ * how public mirror prefixes consume GitHub URLs.
+ * @param prefix - the accelerate URL (raw or normalized); undefined = off.
+ * @returns the `-c` pair to prepend, or `[]` when off or the value is
+ * unusable (an invalid value fails SAFE to a direct connection — config
+ * validation rejects such values at load; this is the defensive path).
+ */
+export function accelArgs(prefix) {
+    if (prefix === undefined || accelerateUrlError(prefix) !== undefined)
+        return [];
+    return ['-c', `url.${normalizeAccelerateUrl(prefix)}.insteadOf=https://github.com/`];
+}
 /**
  * Sync remote-tracking refs: fetch every remote and prune tracking branches
  * the remotes no longer carry (the CLI equivalent of IDEA's "synchronize
@@ -472,9 +519,11 @@ export async function deleteBranch(exec, repoRoot, name) {
  * executor's hard timeout as a GitError.
  * @param exec - executor seam.
  * @param repoRoot - main worktree directory (fetch is repository-wide).
+ * @param accelPrefix - optional cn-accelerate mirror prefix (see
+ * {@link accelArgs}); only the READ half of the network commands gets it.
  */
-export async function fetchAll(exec, repoRoot) {
-    await git(exec, repoRoot, ['fetch', '--all', '--prune'], NETWORK_TIMEOUT_MS);
+export async function fetchAll(exec, repoRoot, accelPrefix) {
+    await git(exec, repoRoot, [...accelArgs(accelPrefix), 'fetch', '--all', '--prune'], NETWORK_TIMEOUT_MS);
 }
 /**
  * Update the CURRENT checkout: fetch every remote, then fast-forward the
@@ -487,11 +536,13 @@ export async function fetchAll(exec, repoRoot) {
  * branch ITS worktree holds.
  * @param exec - executor seam.
  * @param cwd - directory whose checked-out branch is updated.
+ * @param accelPrefix - optional cn-accelerate mirror prefix; feeds ONLY the
+ * fetch phase ({@link fetchAll}) — the `--ff-only` merge is local.
  * @returns the branch name and whether HEAD actually moved (false = the
  * upstream already contained it).
  */
-export async function updateBranch(exec, cwd) {
-    await fetchAll(exec, cwd);
+export async function updateBranch(exec, cwd, accelPrefix) {
+    await fetchAll(exec, cwd, accelPrefix);
     const before = (await git(exec, cwd, ['rev-parse', 'HEAD'])).trim();
     await git(exec, cwd, ['merge', '--ff-only', '@{u}']);
     const after = (await git(exec, cwd, ['rev-parse', 'HEAD'])).trim();
@@ -505,7 +556,11 @@ export async function updateBranch(exec, cwd) {
  * git's own message rather than silently picking one), and `--force` is
  * never passed — a diverged remote refuses rather than losing commits.
  * Runs at the queried directory's own toplevel, so a linked-worktree
- * session pushes the branch ITS worktree holds.
+ * session pushes the branch ITS worktree holds. The cn-accelerate rewrite is
+ * deliberately NEVER injected here (no {@link accelArgs} parameter exists):
+ * public mirrors have no `receive-pack`, and rewriting would turn a
+ * diagnosable direct failure into an opaque mirror failure while leaking the
+ * pushed content to a third party.
  * @param exec - executor seam.
  * @param cwd - directory whose checked-out branch is pushed.
  * @returns the branch and whether the remote-tracking ref changed. A branch
@@ -853,13 +908,18 @@ export function parseLogOutput(out) {
  * `rev-parse --verify` first, so an arbitrary string can never reach the log
  * arguments as anything but a resolvable rev. An unborn checkout (no commits
  * yet) answers an empty page instead of an error.
+ *
+ * `--topo-order` is unconditional: the history card draws lane lines from
+ * `parents`, and a pure date order would interleave a branch's commits
+ * before their merge base, leaving edges pointing at rows not yet painted.
  * @param exec - executor seam.
  * @param cwd - the checkout directory.
  * @param limit - page size (1..200, validated upstream).
  * @param skip - offset (>= 0, validated upstream).
  * @param ref - optional starting rev; absent = the checkout's HEAD.
+ * @param filter - optional all-refs/author/date window.
  */
-export async function logHistory(exec, cwd, limit, skip, ref) {
+export async function logHistory(exec, cwd, limit, skip, ref, filter) {
     let start;
     if (ref !== undefined && ref !== '' && ref !== 'HEAD') {
         const verified = await gitMaybe(exec, cwd, ['rev-parse', '--verify', '--quiet', `${ref}^{commit}`]);
@@ -868,10 +928,21 @@ export async function logHistory(exec, cwd, limit, skip, ref) {
         }
         start = verified.trim();
     }
+    // A ref narrows the walk to that ref's ancestry; `--all` is only the
+    // no-ref default. Combining them would list every branch under a
+    // "this branch" filter.
+    const all = filter?.all === true && start === undefined;
+    const author = filter?.author?.trim() ?? '';
+    const since = filter?.since;
+    const until = filter?.until;
     try {
         const out = await git(exec, cwd, [
-            'log', `--max-count=${String(limit)}`, `--skip=${String(skip)}`,
+            'log', `--max-count=${String(limit)}`, `--skip=${String(skip)}`, '--topo-order',
             '--date=iso-strict', `--pretty=format:${LOG_FORMAT}`,
+            ...(all ? ['--all'] : []),
+            ...(author === '' ? [] : [`--author=${author}`]),
+            ...(since === undefined ? [] : [`--since=${new Date(since).toISOString()}`]),
+            ...(until === undefined ? [] : [`--until=${new Date(until).toISOString()}`]),
             ...(start === undefined ? [] : [start]),
         ]);
         return parseLogOutput(out);

package/lib/index.d.ts

@@ -25,6 +25,11 @@ export interface Config {
     /** Post-create configuration files to copy when .worktreeinclude is absent;
      * absent = none. */
     postCreateCopyFiles?: Volatile<string[]> | string[];
+    /** cn-accelerate mirror rewrite for network READ commands (fetch/update);
+     * absent = off. PUSH is never rewritten. */
+    cnAccelerate?: Volatile<boolean> | boolean;
+    /** cn-accelerate mirror prefix; absent = the shipped default. */
+    cnAccelerateUrl?: Volatile<string> | string;
 }
 /** The shipped prune cap (whole storage root, valid git worktrees only). */
 export declare const KEEP_WORKTREES_DEFAULT = 30;
@@ -36,6 +41,13 @@ export declare const KEEP_WORKTREES_DEFAULT = 30;
 export declare const Config: z;
 /** Reject stale or misspelled config keys before defaults can hide them. */
 export declare function validateConfig(config: Config): void;
+/**
+ * The accelerate prefix must be an http(s) URL without whitespace — it is
+ * concatenated with `https://github.com/` into one `url.<base>.insteadOf`
+ * config value, so a space would smuggle arguments and a non-http scheme is
+ * not a fetchable remote. Absent = the shipped default, which passes.
+ */
+export declare function validateCnAccelerateUrl(value: string | undefined): void;
 /**
  * The prune cap must be an integer >= 1: 0 would read as "create then
  * immediately self-delete" (the fresh worktree is excluded, but every other
@@ -60,6 +72,10 @@ export interface SectionConfig {
     keepWorktrees?: number;
     /** Post-create configuration files to copy when .worktreeinclude is absent. */
     postCreateCopyFiles?: string[];
+    /** cn-accelerate mirror rewrite for network READ commands; absent = off. */
+    cnAccelerate?: boolean;
+    /** cn-accelerate mirror prefix; absent = the shipped default. */
+    cnAccelerateUrl?: string;
 }
 /** The section-shaped view of a config: absent keys stay absent
  * (`exactOptionalPropertyTypes`) except the switches, which spell their

package/lib/index.js

@@ -8,9 +8,10 @@
 import { homedir } from 'node:os';
 import z from '@deepseek-ai/schemastery';
 import { childProcessExec } from './git.js';
-import { handleAiCommitMessage, handleChanges, handleCommit, handleCommitFiles, handleCreateBranch, handleCreateWorktree, handleDeleteBranch, handleEnsureDirectory, handleFetch, handleGroupWorktrees, handleInspectWorktree, handleLog, handlePathExists, handlePurgeDirectory, handleRemoveWorktree, handleRenameBranch, handleStage, handleStatus, handleSwitch, handleUpdate, handlePush, handleWorktreesAll, } from './routes.js';
+import { ACCEL_DEFAULT_URL, accelerateUrlError } from './normalize.js';
+import { handleAiCommitMessage, handleChanges, handleCommit, handleCommitFiles, handleCreateBranch, handleCreateTag, handleCreateWorktree, handleDeleteBranch, handleEnsureDirectory, handleFetch, handleGroupWorktrees, handleInspectWorktree, handleLog, handlePathExists, handlePurgeDirectory, handleRemoveWorktree, handleRenameBranch, handleStage, handleStatus, handleSwitch, handleUpdate, handlePush, handleWorktreesAll, } from './routes.js';
 import { validateRootDir } from './settings.js';
-import { ROUTE_AI_COMMIT_MESSAGE, ROUTE_BRANCH, ROUTE_BRANCH_DELETE, ROUTE_BRANCH_RENAME, ROUTE_CHANGES, ROUTE_COMMIT, ROUTE_COMMIT_FILES, ROUTE_ENSURE_DIRECTORY, ROUTE_EXISTS, ROUTE_FETCH, ROUTE_GROUP, ROUTE_INSPECT, ROUTE_LOG, ROUTE_PUSH, ROUTE_PURGE, ROUTE_REMOVE, ROUTE_STAGE, ROUTE_STATUS, ROUTE_SWITCH, ROUTE_UPDATE, ROUTE_WORKTREE, ROUTE_WORKTREES_ALL } from './wire.js';
+import { ROUTE_AI_COMMIT_MESSAGE, ROUTE_BRANCH, ROUTE_BRANCH_DELETE, ROUTE_BRANCH_RENAME, ROUTE_CHANGES, ROUTE_COMMIT, ROUTE_COMMIT_FILES, ROUTE_ENSURE_DIRECTORY, ROUTE_EXISTS, ROUTE_FETCH, ROUTE_GROUP, ROUTE_INSPECT, ROUTE_LOG, ROUTE_PUSH, ROUTE_PURGE, ROUTE_REMOVE, ROUTE_STAGE, ROUTE_STATUS, ROUTE_SWITCH, ROUTE_TAG, ROUTE_UPDATE, ROUTE_WORKTREE, ROUTE_WORKTREES_ALL } from './wire.js';
 export const name = 'dsh-git-branch';
 export const inject = [];
 /** Largest accepted request body (bytes) — these payloads are a few strings. */
@@ -37,10 +38,12 @@ export const Config = z.object({
     autoPruneWorktrees: z.boolean().default(false).volatile(),
     keepWorktrees: z.number().default(KEEP_WORKTREES_DEFAULT).volatile(),
     postCreateCopyFiles: z.array(z.string()).default([]).volatile(),
+    cnAccelerate: z.boolean().default(false).volatile(),
+    cnAccelerateUrl: z.string().default(ACCEL_DEFAULT_URL).volatile(),
 });
 /** Reject stale or misspelled config keys before defaults can hide them. */
 export function validateConfig(config) {
-    const unknown = Object.keys(config).find(key => key !== 'rootDir' && key !== 'groupSidebar' && key !== 'fetchBeforeCreate' && key !== 'autoPruneWorktrees' && key !== 'keepWorktrees' && key !== 'postCreateCopyFiles');
+    const unknown = Object.keys(config).find(key => key !== 'rootDir' && key !== 'groupSidebar' && key !== 'fetchBeforeCreate' && key !== 'autoPruneWorktrees' && key !== 'keepWorktrees' && key !== 'postCreateCopyFiles' && key !== 'cnAccelerate' && key !== 'cnAccelerateUrl');
     if (unknown !== undefined) {
         throw new Error(`GitWorktreeConfig: unknown key "${unknown}"`);
     }
@@ -66,9 +69,27 @@ export function validateConfig(config) {
             throw new Error('GitWorktreeConfig: "postCreateCopyFiles" must be an array of strings');
         }
     }
+    const cnAccelerate = readVolatile(config.cnAccelerate);
+    if (cnAccelerate !== undefined && typeof cnAccelerate !== 'boolean') {
+        throw new Error('GitWorktreeConfig: "cnAccelerate" must be a boolean');
+    }
+    validateCnAccelerateUrl(readVolatile(config.cnAccelerateUrl));
     validateKeepWorktrees(readVolatile(config.keepWorktrees));
     validateRootDir(root);
 }
+/**
+ * The accelerate prefix must be an http(s) URL without whitespace — it is
+ * concatenated with `https://github.com/` into one `url.<base>.insteadOf`
+ * config value, so a space would smuggle arguments and a non-http scheme is
+ * not a fetchable remote. Absent = the shipped default, which passes.
+ */
+export function validateCnAccelerateUrl(value) {
+    if (value === undefined)
+        return;
+    if (typeof value !== 'string' || accelerateUrlError(value) !== undefined) {
+        throw new Error('GitWorktreeConfig: "cnAccelerateUrl" must be an http(s) URL without whitespace');
+    }
+}
 /**
  * The prune cap must be an integer >= 1: 0 would read as "create then
  * immediately self-delete" (the fresh worktree is excluded, but every other
@@ -94,14 +115,18 @@ export function sectionOf(config) {
     const fetchBeforeCreate = readVolatile(config.fetchBeforeCreate);
     const autoPruneWorktrees = readVolatile(config.autoPruneWorktrees);
     const keepWorktrees = readVolatile(config.keepWorktrees);
+    const cnAccelerate = readVolatile(config.cnAccelerate);
+    const cnAccelerateUrl = readVolatile(config.cnAccelerateUrl);
     return {
         ...(rootDir === undefined ? {} : { rootDir }),
         ...(postCreateCopyFiles === undefined ? {} : { postCreateCopyFiles }),
+        ...(cnAccelerateUrl === undefined ? {} : { cnAccelerateUrl }),
         // The composition layer spells the shipped defaults so a user-layer
         // unset can always fall back to them.
         groupSidebar: groupSidebar ?? true,
         fetchBeforeCreate: fetchBeforeCreate ?? false,
         autoPruneWorktrees: autoPruneWorktrees ?? false,
+        cnAccelerate: cnAccelerate ?? false,
         keepWorktrees: keepWorktrees ?? KEEP_WORKTREES_DEFAULT,
     };
 }
@@ -119,6 +144,8 @@ export function apply(ctx, config = {}) {
         sectionRootDir: () => readVolatile(currentConfig().rootDir),
         sectionFetchBeforeCreate: () => readVolatile(currentConfig().fetchBeforeCreate),
         sectionPostCreateCopyFiles: () => readVolatile(currentConfig().postCreateCopyFiles),
+        sectionCnAccelerate: () => readVolatile(currentConfig().cnAccelerate),
+        sectionCnAccelerateUrl: () => readVolatile(currentConfig().cnAccelerateUrl),
         home: () => homedir(),
         envHome: () => process.env.DSH_HOME,
     });
@@ -200,6 +227,7 @@ export function apply(ctx, config = {}) {
         postRoute(ROUTE_COMMIT, 'commit', handleCommit);
         postRoute(ROUTE_LOG, 'log', handleLog);
         postRoute(ROUTE_COMMIT_FILES, 'commit-files', handleCommitFiles);
+        postRoute(ROUTE_TAG, 'tag', handleCreateTag);
         // The AI commit-message route exists only where the host tree provides
         // the dsh-llm service: the injection resolves once the service is up and
         // never fires without it, so an llm-less deployment answers 404 and the

package/lib/normalize.d.ts

@@ -1,7 +1,8 @@
 /**
- * Pure branch/path name normalization for worktree directory placement.
- * Windows-forbidden characters are the governing constraint: a worktree
- * folder name must survive on every platform the host runs on.
+ * Pure name/URL normalization shared by the host (git command assembly,
+ * config validation) and the client (forms). Windows-forbidden characters
+ * govern worktree directory placement: a worktree folder name must survive
+ * on every platform the host runs on.
  */
 /**
  * Turn a branch display name into a single safe directory segment.
@@ -56,3 +57,27 @@ export type BranchNameIssue = 'empty' | 'leadingDash' | 'illegal';
  * @returns the issue kind, or null when the name is acceptable.
  */
 export declare function branchNameIssue(name: string): BranchNameIssue | null;
+/**
+ * Shipped default for the cn-accelerate mirror prefix (the design doc's
+ * `cnAccelerateUrl` default and the popover's「恢复默认」target).
+ */
+export declare const ACCEL_DEFAULT_URL = "https://gh-proxy.com/";
+/** Why a user-typed accelerate URL is not acceptable yet (undefined = fine). */
+export type AccelerateUrlIssue = 'empty' | 'invalid';
+/**
+ * Pre-flight check of the cn-accelerate prefix against what the rewrite can
+ * actually use: non-empty after trim, `http://` or `https://` scheme, and no
+ * whitespace anywhere (a space would break the `url.<base>.insteadOf=<target>`
+ * git config value and smuggle a second argument).
+ * @param value - raw draft text.
+ * @returns the issue kind, or undefined when the value is acceptable.
+ */
+export declare function accelerateUrlError(value: string): AccelerateUrlIssue | undefined;
+/**
+ * Normalize an accepted accelerate URL: trim, and append the trailing `/`
+ * the prefix concatenation requires (`https://gh-proxy.com/` + `o/r.git`
+ * must stay one valid URL). Callers pass the result to `url.<base>.insteadOf`.
+ * @param value - an accepted (non-empty, http(s), whitespace-free) URL.
+ * @returns the prefix ending in `/`.
+ */
+export declare function normalizeAccelerateUrl(value: string): string;

package/lib/normalize.js

@@ -1,7 +1,8 @@
 /**
- * Pure branch/path name normalization for worktree directory placement.
- * Windows-forbidden characters are the governing constraint: a worktree
- * folder name must survive on every platform the host runs on.
+ * Pure name/URL normalization shared by the host (git command assembly,
+ * config validation) and the client (forms). Windows-forbidden characters
+ * govern worktree directory placement: a worktree folder name must survive
+ * on every platform the host runs on.
  */
 /**
  * Turn a branch display name into a single safe directory segment.
@@ -91,3 +92,37 @@ export function branchNameIssue(name) {
         return 'illegal';
     return null;
 }
+/**
+ * Shipped default for the cn-accelerate mirror prefix (the design doc's
+ * `cnAccelerateUrl` default and the popover's「恢复默认」target).
+ */
+export const ACCEL_DEFAULT_URL = 'https://gh-proxy.com/';
+/**
+ * Pre-flight check of the cn-accelerate prefix against what the rewrite can
+ * actually use: non-empty after trim, `http://` or `https://` scheme, and no
+ * whitespace anywhere (a space would break the `url.<base>.insteadOf=<target>`
+ * git config value and smuggle a second argument).
+ * @param value - raw draft text.
+ * @returns the issue kind, or undefined when the value is acceptable.
+ */
+export function accelerateUrlError(value) {
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return 'empty';
+    if (/\s/.test(trimmed))
+        return 'invalid';
+    if (!trimmed.startsWith('http://') && !trimmed.startsWith('https://'))
+        return 'invalid';
+    return undefined;
+}
+/**
+ * Normalize an accepted accelerate URL: trim, and append the trailing `/`
+ * the prefix concatenation requires (`https://gh-proxy.com/` + `o/r.git`
+ * must stay one valid URL). Callers pass the result to `url.<base>.insteadOf`.
+ * @param value - an accepted (non-empty, http(s), whitespace-free) URL.
+ * @returns the prefix ending in `/`.
+ */
+export function normalizeAccelerateUrl(value) {
+    const trimmed = value.trim();
+    return trimmed.endsWith('/') ? trimmed : `${trimmed}/`;
+}

package/lib/routes.d.ts

@@ -4,7 +4,7 @@
  */
 import { type CopyFilesSeams } from './copy-files.js';
 import { type DirExists, type ExcludeSeams, type Exec } from './git.js';
-import type { AiCommitMessageResult, ChangesResult, CommitFilesResult, CommitResult, CreateBranchResult, CreateWorktreeResult, EnsureDirectoryResult, FetchResult, GroupWorkspacesResult, InspectWorktreeResult, LogResult, PathExistsResult, PurgeDirectoryResult, RemoveWorktreeResult, RepoStatus, RouteError, StageResult, SwitchResult, UpdateResult, WorktreesAllResult } from './wire.js';
+import type { AiCommitMessageResult, ChangesResult, CommitFilesResult, CommitResult, CreateBranchResult, CreateTagResult, CreateWorktreeResult, EnsureDirectoryResult, FetchResult, GroupWorkspacesResult, InspectWorktreeResult, LogResult, PathExistsResult, PurgeDirectoryResult, RemoveWorktreeResult, RepoStatus, RouteError, StageResult, SwitchResult, UpdateResult, WorktreesAllResult } from './wire.js';
 /** Everything the handlers need from the host half. */
 export interface RouteDeps {
     exec: Exec;
@@ -14,6 +14,10 @@ export interface RouteDeps {
     sectionFetchBeforeCreate: () => boolean | undefined;
     /** Post-create configuration files to copy when .worktreeinclude is absent. */
     sectionPostCreateCopyFiles?: () => string[] | undefined;
+    /** Whether the cn-accelerate mirror rewrite is on (absent = off). */
+    sectionCnAccelerate?: () => boolean | undefined;
+    /** The cn-accelerate mirror prefix (absent = the shipped default). */
+    sectionCnAccelerateUrl?: () => string | undefined;
     /** User home directory seam. */
     home: () => string;
     /** `$DSH_HOME` environment value seam. */
@@ -46,7 +50,7 @@ export declare function fsMkdirRecursive(path: string): Promise<void>;
 /** One route outcome: HTTP status plus the JSON body. */
 export interface RouteOutcome {
     status: number;
-    body: RepoStatus | CreateWorktreeResult | SwitchResult | CreateBranchResult | FetchResult | UpdateResult | GroupWorkspacesResult | InspectWorktreeResult | RemoveWorktreeResult | PathExistsResult | EnsureDirectoryResult | WorktreesAllResult | PurgeDirectoryResult | ChangesResult | StageResult | CommitResult | LogResult | CommitFilesResult | AiCommitMessageResult | RouteError;
+    body: RepoStatus | CreateWorktreeResult | SwitchResult | CreateBranchResult | FetchResult | UpdateResult | GroupWorkspacesResult | InspectWorktreeResult | RemoveWorktreeResult | PathExistsResult | EnsureDirectoryResult | WorktreesAllResult | PurgeDirectoryResult | ChangesResult | StageResult | CommitResult | LogResult | CommitFilesResult | CreateTagResult | AiCommitMessageResult | RouteError;
 }
 /**
  * POST /group — git belonging facts for a batch of workspace directories.
@@ -270,10 +274,25 @@ export declare const LOG_LIMIT_MAX = 200;
  * POST /log — one page of the queried checkout's history. The optional `ref`
  * is verified server-side (`rev-parse --verify`), an unborn checkout answers
  * an empty page, and everything else surfaces git's own stderr.
+ *
+ * `all` walks every ref instead of HEAD (the history card's default view: one
+ * graph holding all branches, tags, and their merge edges). `author` and the
+ * `since`/`until` window are pushed down to git rather than filtered in the
+ * browser — the card paginates, so a client-side filter would only narrow the
+ * page it already has and silently hide matches on later pages.
  * @param deps - host dependencies.
- * @param body - parsed request body: `{ repoPath, limit?, skip?, ref? }`.
+ * @param body - parsed request body: `{ repoPath, limit?, skip?, ref?, all?, author?, since?, until? }`.
  */
 export declare function handleLog(deps: RouteDeps, body: unknown): Promise<RouteOutcome>;
+/**
+ * POST /tag — create a tag at an existing commit of the queried repository.
+ * The target is restricted to a commit hash (the only shape the history card
+ * sends), so an arbitrary string can never reach `git tag` as a flag; git
+ * validates the tag name itself and a duplicate surfaces as 400.
+ * @param deps - host dependencies.
+ * @param body - parsed request body: `{ repoPath, name, target?, message? }`.
+ */
+export declare function handleCreateTag(deps: RouteDeps, body: unknown): Promise<RouteOutcome>;
 /**
  * POST /commit-files — the files one commit of the queried checkout changed.
  * The hash is verified server-side; unknown revisions answer 400.