From 8ea2795d88e40a0a67adf0d87f2d887f933a591e Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Thu, 8 Oct 2026 14:24:27 +0200 Subject: [PATCH] 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 Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2 --- CHANGES.md | 3 ++- VERSION | 2 +- docs/reference/commands/raw-material-and-uploads.md | 2 +- tools/CONTRACT.md | 2 +- tools/chemenu/commands/raw_cmd.py | 5 ++--- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/CHANGES.md b/CHANGES.md index 67da680..0fd801d 100644 --- a/CHANGES.md +++ b/CHANGES.md @@ -14,7 +14,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model. --- -## 9.0.0-beta.16 - 2026-10-08 - raw derive reads PDF and Outlook MSG through lazily imported packages; doctor shows each import filter +## 9.0.0-beta.17 - 2026-10-08 - raw pending names only the raw fetch pair as a bundle; a derived document is a folder **Author:** Torben Nehmer @@ -46,6 +46,7 @@ place only: `instructions/dev/version-parts.md` § The candidate model. - Rebase-Review Gate: Anzeigename in Hilfe- und Fehlertexten von sync und publish angeglichen - tools/README.md: Asset-Modus beschreibt Entpacken in den eigenen Ordner, Wiederholung und Zurückrollen - Gitea-Wiki als generierter Spiegel von docs/: Konverter, Push-Skript, Workflows +- raw pending names only the raw fetch pair as a bundle; a derived document is a folder ### Tutorials: installation in English, and a first source to a first answer (#191) diff --git a/VERSION b/VERSION index f0560d2..fe92d2e 100644 --- a/VERSION +++ b/VERSION @@ -1 +1 @@ -9.0.0-beta.16 +9.0.0-beta.17 diff --git a/docs/reference/commands/raw-material-and-uploads.md b/docs/reference/commands/raw-material-and-uploads.md index f7391ca..82be1e3 100644 --- a/docs/reference/commands/raw-material-and-uploads.md +++ b/docs/reference/commands/raw-material-and-uploads.md @@ -291,7 +291,7 @@ tools/wikitool raw pending --json **Behaviour** -- 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. diff --git a/tools/CONTRACT.md b/tools/CONTRACT.md index 52711b1..f8f8a97 100644 --- a/tools/CONTRACT.md +++ b/tools/CONTRACT.md @@ -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. diff --git a/tools/chemenu/commands/raw_cmd.py b/tools/chemenu/commands/raw_cmd.py index 9a13d97..ea8615f 100644 --- a/tools/chemenu/commands/raw_cmd.py +++ b/tools/chemenu/commands/raw_cmd.py @@ -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 "