fix(cli): keep files received that a host's kept record still lists (#8100)

* fix(cli): keep files received that a host's kept record still lists

When the received-state file names a project as expected and the host
keeps its own copy of that project's record beside the state file, the
received-file checks read the record together with each entry that copy
lists whose path still holds something. A record shortened or emptied
outside the host no longer makes those files read as the person's own.
A kept copy with no list, a doubted one, a link or one that cannot be
read counts every file as received; with no kept copy, nothing changes.

* fix(cli): keep a record's own lines when the host's kept copy cannot be read

A kept copy with no list, or one that cannot be read, now counts every
file as received through its own entry, named by the kept copy's path,
instead of hiding the record's lines from Studio's rename and move
tracking. A copy found only by folder identity counts only when its
identity matches the folder, and a copy that disappears mid-read counts
as no copy.

* docs(cli): say a kept entry whose file is gone is not added back
This commit is contained in:
Michael Wang
2026-11-17 19:04:26 +00:00
committed by GitHub
parent 4a59fef2d0
commit 183bf2a416
5 changed files with 292 additions and 30 deletions
+12
View File
@@ -2901,6 +2901,18 @@ imports projects for you can tell the CLI more by pointing
- The state applies to the project, its subfolders, and any folder that holds it.
- If the variable is set but the file is missing or cannot be parsed, every file
counts as received.
- The app can keep its own copy of an `"expected"` project's record in
`received-records/<sha256 of path>.json` beside the state file, as
`{ "project": "<path>", "files": [...] }` with `path` exactly as the state file
names it. A file that copy lists still counts as received while something is at
its path, even if the project's record no longer lists it. For a project found
only by `dev` and `ino`, the copy counts only when its `"identity"` is
`"<dev>:<ino>:<birth time in ns>"` of the project folder. A copy with
`"files": null` or `"doubted": true`, or one that is a link or cannot be read,
counts every file as received.
- A file the copy lists that is no longer at its path is not added back. A
received file that is renamed after its record entry is removed is judged by
the project's record alone until the app reads the record again.
A file from outside the project folder that would be copied (each file a
composition points at, and each project file that is a link to a file outside