1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
//! What:
//! Copying the ignored state of a linked worktree into a new one,
//! with staging,
//! journal and recovery.
//! Why:
//! The copy is a transaction of its own with many small steps.
//!
//! In TS you'd write (pseudocode):
//! ```ts
//! // worktree_copying/index.ts: one `export * from './file'` per module below.
//! ```
/// The one failure type of the linked-worktree ignored-state copy and its diagnostics.
/// Which linked worktrees a worktree-creating Git command registered, before and after it ran.
/// The ignored source paths a linked-worktree copy selects, and the path validation every selection passes.
/// What a copy from a main checkout leaves out: caches, optionally run records, and other checkouts.
/// The deterministic parent-first manifest of a copy, and the mode application to a staged copy.
/// Exact comparison of manifest entries against the filesystem, and the source stability check after staging.
/// The private, validated stage of one source's ignored state beside a destination worktree.
/// The exclusive creation of one destination entry from the stage, and the identity captured after it.
/// Installation of a validated stage into a new worktree, with preflight, batches and rollback on failure.
/// Removal of the paths a failed installation created, only where their identity and content still prove them cli-git's own.
/// The durable journal of one copy: exact encoding, strict validation, private storage and removal.
/// The durable claim on a stage container's name, and the removal of stages an interrupted copy left behind.
/// The append-only install log of one stage: per-batch intents and creations, with resumption.
/// One journaled installation to an end, resumption from the log, and synchronization of a created worktree.
/// The process that owns one item of a copy transaction, written into the item's name, and the proof that it still runs.
/// Recovery of interrupted copies: registration checks, discards with notices, resumption, and the pending check.
/// The linked-worktree ignored-state copy around one forwarded Git invocation: the integrator's entry point.
/// Which forwarded invocations the copy applies to, and the child run that performs it.