Add files using upload-large-folder tool

mods/diff/hooks/ask/armed-ask/armed-ask.ts

@@ -0,0 +1,9 @@
+/**
+ * The file the person asked about from the pane: its path and its diff as
+ * text, held until the next prompt carries it as context.
+ */
+export type ArmedAsk = {
+  path: string
+  text: string
+  lines: number
+}

mods/diff/hooks/ask/armed-ask/index.ts

@@ -0,0 +1,3 @@
+export type * from './armed-ask.js'
+
+export * as default from '.'

mods/diff/hooks/ask/ask-cut-note/ask-cut-note.ts

@@ -0,0 +1,5 @@
+/**
+ * The line an ask ends with when its diff was cut to fit the prompt.
+ */
+export const ASK_CUT_NOTE =
+  '(The rest of this diff was cut: it did not fit in the prompt.)'

mods/diff/hooks/ask/ask-cut-note/index.ts

@@ -0,0 +1,3 @@
+export * from './ask-cut-note.js'
+
+export * as default from '.'

mods/diff/hooks/backend/types/backend-host/backend-host.ts

@@ -0,0 +1,23 @@
+import type Git from '../../../git'
+import type { Host } from '../../../host'
+
+/**
+ * What pinning a backend takes from the bound host: its raw process runner,
+ * file probes, clock, session start and branch-base listener.
+ *
+ * Each backend names its own program, argv lead, environment and timeout
+ * to the runner; the session's start is read as it stands at each fetch
+ * (a later `session.start` moves it).
+ */
+export type BackendHost = Pick<Host, 'run' | 'readFile'> &
+  Pick<Git.GitDeps, 'mtimeOf' | 'entryKindsOf' | 'onBranchBase'> & {
+    /**
+     * The engine's clock, in milliseconds (`$.clock.now`).
+     */
+    nowMs: () => Promise<number>
+
+    /**
+     * When the current session began, read at each fetch.
+     */
+    sessionStartMsOf: () => number
+  }

mods/diff/hooks/backend/types/backend-host/index.ts

@@ -0,0 +1,3 @@
+export type * from './backend-host.js'
+
+export * as default from '.'

mods/diff/hooks/backend/types/backend-probe/backend-probe.ts

@@ -0,0 +1,10 @@
+import type { Backend } from '../backend'
+import type { BackendHost } from '../backend-host'
+
+/**
+ * Probes the session's directory for one backend's working tree: the
+ * backend when it holds the directory, else null.
+ *
+ * Null too where git should govern it instead (Git.gitBackendOf is git's).
+ */
+export type BackendProbe = (host: BackendHost) => Promise<Backend | null>

mods/diff/hooks/backend/types/backend-probe/index.ts

@@ -0,0 +1,3 @@
+export type * from './backend-probe.js'
+
+export * as default from '.'

mods/diff/hooks/backend/types/backend-words/backend-words.ts

@@ -0,0 +1,29 @@
+/**
+ * The words the pane draws that name the backend.
+ *
+ * What uncommitted mode compares against, the command whose failure the
+ * empty state names, the tool that lists untracked files, and the note
+ * under an untracked row.
+ */
+export type BackendWords = {
+  /**
+   * What the working tree is compared with outside branch mode: `HEAD`.
+   */
+  base: string
+
+  /**
+   * The command a failed fetch could not read: `git diff`.
+   */
+  diffCommand: string
+
+  /**
+   * The program that lists untracked files: `git`.
+   */
+  lister: string
+
+  /**
+   * The dim lines under an untracked row: what it is, and how to get its
+   * line counts (a pasteable command only when the path is safe to paste).
+   */
+  untrackedNoteOf: (path: string, isPasteable: boolean) => readonly string[]
+}

mods/diff/hooks/backend/types/backend-words/index.ts

@@ -0,0 +1,3 @@
+export type * from './backend-words.js'
+
+export * as default from '.'

mods/diff/hooks/backend/types/backend/backend.ts

@@ -0,0 +1,45 @@
+import type Git from '../../../git'
+import type { BackendWords } from '../backend-words'
+
+/**
+ * The version-control system behind the pane, pinned once per session: its
+ * working tree, what it compares, how it words them, and the pane's reads.
+ *
+ * Git is the plugin's own backend; a host may install probes for others,
+ * consulted where no git working tree holds the directory (backendOf).
+ */
+export type Backend = {
+  /**
+   * The working tree's top; every row's path is relative to it.
+   */
+  repository: Pick<Git.Repository, 'toplevel'>
+
+  /**
+   * What the picker offers to compare against, in its order.
+   */
+  baseModes: readonly Git.BaseMode[]
+
+  /**
+   * The pane's words for what this backend compares and runs.
+   */
+  words: BackendWords
+
+  /**
+   * One fetch of the working tree against the mode's base (Git.fetchDiff).
+   */
+  fetchDiff: (mode: Git.BaseMode) => Promise<Git.FetchOutcome>
+
+  /**
+   * One row's hunks against the base its fetch read (Git.fetchFileHunks).
+   */
+  fetchFileHunks: (
+    data: Git.DiffData,
+    file: Git.FileStat,
+  ) => Promise<Git.FileHunks | null>
+
+  /**
+   * A string that changes when the checked-out commit moves
+   * (Git.headKeyOf); empty when it cannot be read this tick.
+   */
+  headKeyOf: () => Promise<string>
+}

mods/diff/hooks/backend/types/backend/index.ts

@@ -0,0 +1,3 @@
+export type * from './backend.js'
+
+export * as default from '.'

mods/diff/hooks/backend/types/index.ts

@@ -0,0 +1,6 @@
+export * from './backend'
+export * from './backend-host'
+export * from './backend-probe'
+export * from './backend-words'
+
+export * as default from '.'

mods/diff/hooks/classify/base-name-of/base-name-of.ts

@@ -0,0 +1,7 @@
+/**
+ * A `/`-separated path's last segment: the file's own name.
+ *
+ * @param path the repository-relative path
+ * @returns the base name
+ */
+export const baseNameOf = (path: string) => path.split('/').at(-1) ?? path

mods/diff/hooks/classify/base-name-of/index.ts

@@ -0,0 +1,3 @@
+export * from './base-name-of.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-generated-file/generated-directories/generated-directories.ts

@@ -0,0 +1,28 @@
+/**
+ * Path segments of build output, vendored code, caches and snapshots, the
+ * engine's excluded directories, matched against `/<path>`.
+ */
+export const GENERATED_DIRECTORIES = [
+  '/dist/',
+  '/build/',
+  '/out/',
+  '/output/',
+  '/node_modules/',
+  '/vendor/',
+  '/vendored/',
+  '/third_party/',
+  '/third-party/',
+  '/external/',
+  '/.next/',
+  '/.nuxt/',
+  '/.svelte-kit/',
+  '/coverage/',
+  '/__pycache__/',
+  '/.tox/',
+  '/venv/',
+  '/.venv/',
+  '/target/release/',
+  '/target/debug/',
+  '.generated/',
+  '/__snapshots__/',
+] as const

mods/diff/hooks/classify/is-generated-file/generated-directories/index.ts

@@ -0,0 +1,3 @@
+export * from './generated-directories.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-generated-file/generated-filename-patterns/generated-filename-patterns.ts

@@ -0,0 +1,21 @@
+/**
+ * File-name shapes of generated code, the engine's excluded file-name
+ * patterns: minified, bundled, stubs, specs, snapshots.
+ */
+export const GENERATED_FILENAME_PATTERNS: readonly RegExp[] = Object.freeze([
+  /\.min\.[a-z]+$/i,
+  /-min\.[a-z]+$/i,
+  /\.bundle\.[a-z]+$/i,
+  /\.generated\.[a-z]+$/i,
+  /\.gen\.[a-z]+$/i,
+  /\.auto\.[a-z]+$/i,
+  /_generated\.[a-z]+$/i,
+  /_gen\.[a-z]+$/i,
+  /\.pb\.(?:go|js|ts|py|rb)$/i,
+  /_pb2?\.py$/i,
+  /\.pb\.h$/i,
+  /\.grpc\.[a-z]+$/i,
+  /\.swagger\.[a-z]+$/i,
+  /\.openapi\.[a-z]+$/i,
+  /\.snap$/i,
+])

mods/diff/hooks/classify/is-generated-file/generated-filename-patterns/index.ts

@@ -0,0 +1,3 @@
+export * from './generated-filename-patterns.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-generated-file/generated-filenames/generated-filenames.ts

@@ -0,0 +1,18 @@
+/**
+ * File names (lowercase) that are lockfiles or shrinkwraps, never hand
+ * written, so their churn is noise in a diff.
+ */
+export const GENERATED_FILENAMES: ReadonlySet<string> = new Set([
+  'package-lock.json',
+  'yarn.lock',
+  'pnpm-lock.yaml',
+  'bun.lockb',
+  'bun.lock',
+  'composer.lock',
+  'gemfile.lock',
+  'cargo.lock',
+  'poetry.lock',
+  'pipfile.lock',
+  'shrinkwrap.json',
+  'npm-shrinkwrap.json',
+])

mods/diff/hooks/classify/is-generated-file/generated-filenames/index.ts

@@ -0,0 +1,3 @@
+export * from './generated-filenames.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-generated-file/generated-suffixes/generated-suffixes.ts

@@ -0,0 +1,15 @@
+/**
+ * Extensions, simple and compound (lowercase), of minified, bundled or
+ * generated output, the engine's excluded extensions.
+ */
+export const GENERATED_SUFFIXES = [
+  '.lock',
+  '.min.js',
+  '.min.css',
+  '.min.html',
+  '.bundle.js',
+  '.bundle.css',
+  '.generated.ts',
+  '.generated.js',
+  '.d.ts',
+] as const

mods/diff/hooks/classify/is-generated-file/generated-suffixes/index.ts

@@ -0,0 +1,3 @@
+export * from './generated-suffixes.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-generated-file/index.ts

@@ -0,0 +1,7 @@
+export * from './generated-directories'
+export * from './generated-filename-patterns'
+export * from './generated-filenames'
+export * from './generated-suffixes'
+export * from './is-generated-file.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-generated-file/is-generated-file.ts

@@ -0,0 +1,29 @@
+import { baseNameOf } from '../base-name-of'
+import { rootedPathOf } from '../rooted-path-of'
+import { GENERATED_DIRECTORIES } from './generated-directories'
+import { GENERATED_FILENAME_PATTERNS } from './generated-filename-patterns'
+import { GENERATED_FILENAMES } from './generated-filenames'
+import { GENERATED_SUFFIXES } from './generated-suffixes'
+
+/**
+ * Whether a repository-relative path names generated or vendored content,
+ * by the Linguist-style rules the engine's own diff panel applies.
+ *
+ * @param path the file's path from the repository root, `/`-separated
+ * @returns whether the diff pane counts it among the tests and generated files
+ */
+export function isGeneratedFile(path: string) {
+  const name = baseNameOf(path).toLowerCase()
+  const rooted = rootedPathOf(path)
+
+  const hasGeneratedSuffix = GENERATED_SUFFIXES.some(suffix =>
+    name.endsWith(suffix),
+  )
+
+  return (
+    GENERATED_FILENAMES.has(name) ||
+    hasGeneratedSuffix ||
+    GENERATED_DIRECTORIES.some(directory => rooted.includes(directory)) ||
+    GENERATED_FILENAME_PATTERNS.some(pattern => pattern.test(name))
+  )
+}

mods/diff/hooks/classify/is-test-file/index.ts

@@ -0,0 +1,5 @@
+export * from './is-test-file.js'
+export * from './test-directories'
+export * from './test-filename-patterns'
+
+export * as default from '.'

mods/diff/hooks/classify/is-test-file/is-test-file.ts

@@ -0,0 +1,21 @@
+import { baseNameOf } from '../base-name-of'
+import { rootedPathOf } from '../rooted-path-of'
+import { TEST_DIRECTORIES } from './test-directories'
+import { TEST_FILENAME_PATTERNS } from './test-filename-patterns'
+
+/**
+ * Whether a repository-relative path is a test, spec, fixture or snapshot,
+ * by the same rules the engine's own diff panel applies.
+ *
+ * @param path the file's path from the repository root, `/`-separated
+ * @returns whether the diff pane counts it among the tests and generated files
+ */
+export function isTestFile(path: string) {
+  const name = baseNameOf(path)
+  const rooted = rootedPathOf(path)
+
+  return (
+    TEST_DIRECTORIES.some(directory => rooted.includes(directory)) ||
+    TEST_FILENAME_PATTERNS.some(pattern => pattern.test(name))
+  )
+}

mods/diff/hooks/classify/is-test-file/test-directories/index.ts

@@ -0,0 +1,3 @@
+export * from './test-directories.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-test-file/test-directories/test-directories.ts

@@ -0,0 +1,16 @@
+/**
+ * Path segments of tests, specs, mocks and fixtures, the engine's test
+ * directories, matched against `/<path>`.
+ */
+export const TEST_DIRECTORIES = [
+  '/test/',
+  '/tests/',
+  '/spec/',
+  '/specs/',
+  '/__tests__/',
+  '/__mocks__/',
+  '/__snapshots__/',
+  '/__fixtures__/',
+  '/fixtures/',
+  '/testdata/',
+] as const

mods/diff/hooks/classify/is-test-file/test-filename-patterns/index.ts

@@ -0,0 +1,3 @@
+export * from './test-filename-patterns.js'
+
+export * as default from '.'

mods/diff/hooks/classify/is-test-file/test-filename-patterns/test-filename-patterns.ts

@@ -0,0 +1,11 @@
+/**
+ * File-name shapes of test files and snapshots, the engine's test file-name
+ * patterns.
+ */
+export const TEST_FILENAME_PATTERNS: readonly RegExp[] = Object.freeze([
+  /\.test\.[a-z]+$/i,
+  /\.spec\.[a-z]+$/i,
+  /_test\.[a-z]+$/i,
+  /_spec\.[a-z]+$/i,
+  /\.snap$/i,
+])

mods/diff/hooks/classify/rooted-path-of/index.ts

@@ -0,0 +1,3 @@
+export * from './rooted-path-of.js'
+
+export * as default from '.'

mods/diff/hooks/classify/rooted-path-of/rooted-path-of.ts

@@ -0,0 +1,8 @@
+/**
+ * A path with exactly one leading `/`, so a directory pattern like `/test/`
+ * matches at the start of a relative path too.
+ *
+ * @param path the repository-relative path
+ * @returns the rooted path
+ */
+export const rootedPathOf = (path: string) => `/${path.replace(/^\/+/, '')}`

mods/diff/hooks/limits/columns/auto-open-min-columns.ts

@@ -0,0 +1,5 @@
+/**
+ * The terminal width from which the first edit opens the pane when the person
+ * never said whether they want it (the built-in sidebar's own 144).
+ */
+export const AUTO_OPEN_MIN_COLUMNS = 144

mods/diff/hooks/limits/columns/dialog-path-reserve.ts

@@ -0,0 +1,5 @@
+/**
+ * The cells an inline file row keeps off its path (DiffFileList's 16 for
+ * the counts, 3 for the pointer, 4 for the frame).
+ */
+export const DIALOG_PATH_RESERVE = 23

mods/diff/hooks/limits/columns/index.ts

@@ -0,0 +1,9 @@
+export * from './auto-open-min-columns.js'
+export * from './dialog-path-reserve.js'
+export * from './open-min-columns.js'
+export * from './pane-right-pad-columns.js'
+export * from './path-floor.js'
+export * from './stat-cells.js'
+export * from './widest-bucket-columns.js'
+
+export * as default from '.'

mods/diff/hooks/limits/columns/open-min-columns.ts

@@ -0,0 +1,8 @@
+/**
+ * The terminal width from which `/diff` opens the pane (the built-in
+ * sidebar's own minimum).
+ *
+ * The first edit opens it from this width too, when the person kept it
+ * open before.
+ */
+export const OPEN_MIN_COLUMNS = 110

mods/diff/hooks/limits/columns/pane-right-pad-columns.ts

@@ -0,0 +1,5 @@
+/**
+ * The blank column the docked pane keeps at its right edge, as the built-in
+ * sidebar's body does (its `paddingX`): rows wrap one column short of it.
+ */
+export const PANE_RIGHT_PAD_COLUMNS = 1

mods/diff/hooks/limits/columns/path-floor.ts

@@ -0,0 +1,5 @@
+/**
+ * The fewest cells a docked file row gives its path, however narrow the
+ * pane (ReplDiffSidebar's 8).
+ */
+export const PATH_FLOOR = 8

mods/diff/hooks/limits/columns/stat-cells.ts

@@ -0,0 +1,5 @@
+/**
+ * The cells a docked file row keeps for its `+N -M` (ReplDiffSidebar's 12):
+ * the path is cut from its start to the rest.
+ */
+export const STAT_CELLS = 12

mods/diff/hooks/limits/columns/widest-bucket-columns.ts

@@ -0,0 +1,4 @@
+/**
+ * The terminal width from which `diff_pane_shown` reports `200_plus`.
+ */
+export const WIDEST_BUCKET_COLUMNS = 200

mods/diff/hooks/limits/sizes/bytes/host-output-cap-bytes.ts

@@ -0,0 +1,5 @@
+/**
+ * The most of a child's stdout `$.process.run` hands back, in bytes
+ * (process-host OUTPUT_LIMIT); a listing that long was cut, silently.
+ */
+export const HOST_OUTPUT_CAP_BYTES = 4 * 1024 * 1024

mods/diff/hooks/limits/sizes/bytes/index.ts

@@ -0,0 +1,4 @@
+export * from './host-output-cap-bytes.js'
+export * from './max-diff-bytes.js'
+
+export * as default from '.'

mods/diff/hooks/limits/sizes/bytes/max-diff-bytes.ts

@@ -0,0 +1,5 @@
+/**
+ * A file whose unified diff text is longer than this is a "large file": its
+ * hunks are not parsed (the built-in panel's size cap).
+ */
+export const MAX_DIFF_BYTES = 1_000_000

mods/diff/hooks/limits/sizes/index.ts

@@ -0,0 +1,11 @@
+export * from './bytes'
+export * from './max-files.js'
+export * from './max-files-for-details.js'
+export * from './max-lines-per-file.js'
+export * from './max-listed-directories.js'
+export * from './max-untracked-probes.js'
+export * from './max-visible-files.js'
+export * from './pane'
+export * from './prompt-context-max-chars.js'
+
+export * as default from '.'

mods/diff/hooks/limits/sizes/max-files-for-details.ts

@@ -0,0 +1,5 @@
+/**
+ * Past this many changed files the shortstat totals alone are kept: no
+ * per-file rows, no hunks, no untracked probe (the built-in panel's cap).
+ */
+export const MAX_FILES_FOR_DETAILS = 500

mods/diff/hooks/limits/sizes/max-files.ts

@@ -0,0 +1,5 @@
+/**
+ * How many per-file rows a diff keeps (the built-in panel's cap); the rest
+ * are counted as "not shown".
+ */
+export const MAX_FILES = 50

mods/diff/hooks/limits/sizes/max-lines-per-file.ts

@@ -0,0 +1,5 @@
+/**
+ * How many diff lines of one file are kept before the body is cut and the
+ * file reads as truncated (GitHub's auto-load limit, as the built-in's).
+ */
+export const MAX_LINES_PER_FILE = 400

mods/diff/hooks/limits/sizes/max-listed-directories.ts

@@ -0,0 +1,9 @@
+/**
+ * How many directories one fetch may list while dating its files; past it
+ * an untracked file reads as pre-session, a tracked one as session work.
+ *
+ * A walk lists only the distinct ancestors of the paths it dates (MAX_FILES
+ * tracked, MAX_UNTRACKED_PROBES untracked), so the budget in effect is the
+ * dated set's own directory count; this caps a pathological spread.
+ */
+export const MAX_LISTED_DIRECTORIES = 512

mods/diff/hooks/limits/sizes/max-untracked-probes.ts

@@ -0,0 +1,5 @@
+/**
+ * How many untracked paths get a timestamp probe per fetch; the rest read as
+ * pre-session, since only MAX_FILES rows could ever show.
+ */
+export const MAX_UNTRACKED_PROBES = 500