Keep a built leaf when the view lags the tree

[onechat] / README.rst

diff --git a/README.rst b/README.rst
index 362eeebd7d3d807a38dbeb2ce08d50a02e7569f1..04dcafb923096b07be3965e6b847bc706e8f39d0 100644 (file)
--- a/README.rst
+++ b/README.rst
@@ -32,7 +32,7 @@ field is an error.
 
    {
      "endpoint": "chatgpt",
 
    {
      "endpoint": "chatgpt",

-     "compactor": {"model": "gpt-6-luna", "effort": "high"}
+     "compactor": {"model": "gpt-6.1-sol", "effort": "high"}

    }
 
 ``endpoint``
    }
 
 ``endpoint``


@@ -43,7 +43,46 @@ field is an error.
 
 ``compactor``
    The model and the reasoning effort of the summaries. The defaults are
 
 ``compactor``
    The model and the reasoning effort of the summaries. The defaults are

-   ``gpt-6-luna`` and ``high``.
+   ``gpt-6.1-sol`` and ``high``.
+
+*******
+ Login
+*******
+
+The ``chatgpt`` endpoint needs a login with a ChatGPT account:
+
+.. code:: console
+
+   onechat login
+
+The command shows a link and a code. Open the link on any device, enter
+the code, and approve the login. Device code login must be allowed in
+the ChatGPT security settings. OneChat writes the tokens to
+``auth.json`` in the data directory, with mode 0600, and refreshes them
+before they expire. The file belongs to OneChat only. Do not share it
+with the Codex CLI, because each program rotates the refresh token and
+logs the other out.
+
+*******
+ Probe
+*******
+
+``onechat probe LOG COUNT [BUILDS]`` measures the compactor on a log. It
+appends the first COUNT messages of LOG, one JSON object ``{"kind",
+"text"}`` on each line, to a new chat in ``probe/`` in the data
+directory, and builds its tree with real model calls. The calls use the
+quota of the account. The run stops at the first failed call, after 660
+calls, or when the used percent of a quota window grows by more than 15
+points. At the end it reports the calls per message, the cached share of
+the input tokens, the retries, the line sizes, and the quota at the
+first and the last call. BUILDS, from 1 to 8, limits the model calls at
+once in the run.
+
+A test writes a generated log of readable made-up messages:
+
+.. code:: console
+
+   ONECHAT_PROBE_LOG=probe.jsonl go test -run TestProbeLogHasTheSyntheticMix

 
 *************
  Development
 
 *************
  Development