sync: update from private repo (2336949a)

docs/tools/file-provenance.md

@@ -28,18 +28,33 @@ If there is no record (a file that pre-dates the ledger), you get an
 `unknown`-equivalent message — treat the file as possibly belonging to another
 task and verify its contents before overwriting.
 
-## ListWorkspaceFiles({ path?, sourceKind?, createdByTaskId?, lastModifiedByTaskId?, includeUnknown?, limit? })
+## ListWorkspaceFiles({ path?, sourceKind?, createdByTaskId?, lastModifiedByTaskId?, since?, until?, includeUnknown?, limit? })
 
 Returns a bounded listing (default 50, max 200 rows) of known files with a
-one-line provenance summary each. It never returns file contents.
+one-line provenance summary each. It never returns file contents. Each line
+starts with the file's **date**.
 
 Filters:
 
 - `path` — path prefix, e.g. `output/`.
 - `sourceKind` — filter by source kind.
 - `createdByTaskId` / `lastModifiedByTaskId` — filter by task.
+- `since` / `until` — date range, inclusive on both ends. Accepts `YYYY-MM-DD`
+  or a full ISO timestamp; a bare `until` date covers that whole day.
 - `includeUnknown` — set `false` to hide `unknown` / `imported_existing` files.
 
+### The date
+
+A file's date is `last_modified_at`, falling back to `first_seen_at`. Display,
+ordering and `since` / `until` all use that same one date, so a date you read
+off a listing can be pasted straight back into a range filter.
+
+### Selecting only this task's files
+
+The job's context block carries `このタスクの番号: <id>`. Pass it as
+`createdByTaskId` to see only what this task made, or use it to tell your own
+files apart from ones that were already in the workspace.
+
 ## Guidance
 
 - Do NOT blindly edit files whose `source_kind` is `user_input` or whose