docs(raw): raw pending no longer offers a PDF and its converted text as a bundle example (#199)
A derived PDF is a folder since raw derive; the raw/CONTRACT.md example was adapted when the command shipped, the raw pending record and its generated copies were not. Files changed: - CHANGES.md - VERSION - docs/reference/commands/raw-material-and-uploads.md - tools/CONTRACT.md - tools/chemenu/commands/raw_cmd.py Co-Authored-By: Claude Code <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2
This commit is contained in:
1 parent
0e6a50aa98
commit
8ea2795d88
5 files changed
+7
-7
No files matched your search
+1
-1
@@ -1668,7 +1668,7 @@ List what waits in `incoming/`, oldest first, and name the entry an ingest witho
|
||||
|
||||
**NOTES**
|
||||
|
||||
- A candidate is a top-level entry of `incoming/`: a single `file`, a `bundle` of top-level files sharing a stem (a `raw fetch` pair, a PDF and its converted text), or a `folder` with every file below it. Dotfiles, empty directories and their contents are none; `mcp-upload/` is outside `incoming/` and never listed.
|
||||
- A candidate is a top-level entry of `incoming/`: a single `file`, a `bundle` of top-level files sharing a stem (a `raw fetch` pair), or a `folder` with every file below it. Dotfiles, empty directories and their contents are none; `mcp-upload/` is outside `incoming/` and never listed.
|
||||
- Order: oldest first by modification time. A bundle or folder counts as new as its newest file; a tie goes by name. The mtime is when a document last changed only if it was copied with its timestamps kept (`cp -p`, `rsync -a`, an unpacked archive) - for a download or a `raw fetch` it is merely when it was dropped.
|
||||
- Each candidate shows its path(s), kind, file count and mtime, and whether `raw accept` would take it as it stands - the same checks, minus `--fidelity`/`--authority`. One it would refuse is listed with the reason and skipped: it needs a human.
|
||||
- The default is the first candidate `raw accept` would take, and the output names it.
|
||||
|
||||
@@ -1438,8 +1438,7 @@ def _pending_candidates() -> list[_Candidate]:
|
||||
"""The candidates in `incoming/`, oldest first (Gitea #112 E1/E5).
|
||||
|
||||
Only top-level entries count; dotfiles and empty directories are none.
|
||||
Top-level files sharing a stem are one `bundle` - a `raw fetch` pair, a PDF
|
||||
and its converted text. A top-level folder is one `folder`, with every
|
||||
Top-level files sharing a stem are one `bundle` - a `raw fetch` pair. A top-level folder is one `folder`, with every
|
||||
file below it. A unit is as new as its newest part, so a bundle or folder
|
||||
sorts by the newest mtime it holds; a tie goes by the path's bytes."""
|
||||
incoming = _incoming_dir()
|
||||
@@ -1490,7 +1489,7 @@ def _pending_candidates() -> list[_Candidate]:
|
||||
),
|
||||
notes=(
|
||||
"A candidate is a top-level entry of `incoming/`: a single `file`, a `bundle` of "
|
||||
"top-level files sharing a stem (a `raw fetch` pair, a PDF and its converted text), or "
|
||||
"top-level files sharing a stem (a `raw fetch` pair), or "
|
||||
"a `folder` with every file below it. Dotfiles, empty directories and their contents "
|
||||
"are none; `mcp-upload/` is outside `incoming/` and never listed.",
|
||||
"Order: oldest first by modification time. A bundle or folder counts as new as its "
|
||||
|
||||
Reference in new issue
Block a user