codeer-cli 0.1.13__tar.gz → 0.1.15__tar.gz

{codeer_cli-0.1.13 → codeer_cli-0.1.15}/API_REFERENCE.md

@@ -84,6 +84,20 @@ Base path: `/organizations/{org_id}/workspaces/{ws_id}/knowledge_bases`
 | `POST .../files/status` | Batch-poll indexing status by node ID |
 | `GET .../{kb_id}/nodes/{node_id}/content` | Read a file's extracted content |
 
+The workspace API-key external routes used by `codeer-cli` include:
+
+| Method & path | Purpose |
+| --- | --- |
+| `GET /external/knowledge-bases/nodes?parent_id={node_id}` | List KB roots or direct children |
+| `GET /external/knowledge-bases/files/{node_id}/content` | Read one file's extracted snapshot content |
+
+`codeer kb export --node-id <file-id> --file <path>` maps directly to the second
+route. `codeer kb export --node-id <folder-id> --dir <path>` recursively follows
+the first route and calls the second route for every file. Any returned text is
+written as UTF-8 Markdown regardless of indexing status, with that status
+preserved in the manifest. A `null` content response cannot be exported. The
+command does not reconstruct the originally uploaded binary file.
+
 Attach KB files to an agent by listing their node IDs in the agent's
 `unified_tools[].knowledge_node_ids`.
 
@@ -187,8 +201,8 @@ version; it does not currently replace this draft-pinning path.
 | `GET /eval/evaluators?wid=<ws>` | List evaluators |
 | `PUT /eval/evaluators/{id}` | Update |
 | `DELETE /eval/evaluators/{id}` | Delete |
-| `POST /eval/case-evaluator-infos:batch` | Read assigned evaluators/rubrics for cases |
-| `PUT /eval/cases/{case_id}/case-evaluator-infos` | Replace assigned evaluators/rubrics for one case |
+| `POST /external/eval/case-evaluator-infos:batch` | Read assigned evaluators/rubrics for cases through the API-key facade |
+| `PUT /external/eval/cases/{case_id}/case-evaluator-infos` | Replace assigned evaluators/rubrics for one case through the API-key facade |
 | `POST /eval/trigger` | Run explicit assigned `case_evaluator_pairs` pinned to `agent_history_id` |
 | `POST /eval/stop` | Cancel running case+evaluator combo |
 | `POST /eval/rubric` | Set/override the rubric for one (case, evaluator); also creates assignment |
@@ -275,12 +289,12 @@ the public CLI.
 | --- | --- |
 | `POST /api/v2/chats` | Create a persisted history using an agent's current published version |
 | `POST /api/v2/chats/{id}/messages` | Append a turn through structured SSE using the current published version |
-| `GET /api/v2/chats/{id}/messages` | Read persisted Chat V2 conversation parts |
-| `GET /histories?agent_id=X&feedback_filter=improve_feedback&external_user_id=…` | List conversations with filters |
-| `GET /histories/{id}` | Read one history's metadata |
-| `GET /histories/{id}/conversations` | Legacy compact conversation rows; not complete tool I/O |
-| `POST /histories/{hid}/conversations/{cid}/feedbacks` | Leave freeform improvement feedback |
-| `POST /histories/{hid}/conversations/{cid}/score` | Numeric score |
+| `GET /api/v1/external/histories/{id}/messages` | Export persisted diagnostic parts for workspace editors (`history-parts-v1`) |
+| `GET /api/v2/chats/{id}/messages` | Read client-visible parts under the external client-owner contract |
+| `GET /api/v1/external/histories?agent_id=X&feedback_filter=improve_feedback&external_user_id=…` | List conversations with filters |
+| `GET /api/v1/external/histories/{id}` | Read one history's metadata |
+| `GET /api/v1/external/histories/{id}/conversations` | Legacy compact conversation rows; not complete tool I/O |
+| `POST /api/v1/external/histories/{hid}/conversations/{cid}/feedbacks` | Leave freeform improvement feedback |
 
 The CLI exposes the first two operations as `codeer history create` and
 `codeer history send`. Messages explicitly set `stream: true`, consume Chat V2
@@ -289,6 +303,11 @@ per-message SSE read timeout defaults to 240 seconds. A timeout,
 `response.failed`, or disconnect before completion has an uncertain write
 outcome, so read the history before retrying to avoid duplicate turns.
 
+`codeer history conversations` uses the management export by default. Pass
+`--client-visible --user <external-user-id>` only to select the external Chat
+V2 read contract explicitly. The management export includes persisted tool
+calls/results but excludes system prompts and provider raw traces.
+
 `feedback_filter` accepts the `FeedbackFilterType` enum values:
 `no_feedback`, `with_feedback`, `helpful_feedback`, `improve_feedback`.
 
@@ -491,12 +510,13 @@ you can and can't recover from each assistant turn:
 | Tool **outputs** (raw JSON returned by the tool) | same — stored only as derived `primary_sources` for retrieval tools |
 | Reasoning steps mid-turn | `meta.reasoning_steps` is currently always `null` |
 
-Chat V2 improves this contract: structured SSE emits tool calls and returns as
-`response.part.created` / `response.part.completed`, and
-`GET /api/v2/chats/{id}/messages` reads the persisted conversation parts.
-Capture the SSE artifact with `--out` when exact event order matters; use the
-paginated V2 message read for persisted after-the-fact tool I/O. The legacy V1
-history read remains useful for compact turn-level compatibility only.
+Native parts improve this contract: structured SSE emits tool calls and returns
+as `response.part.created` / `response.part.completed`, and the management
+`GET /api/v1/external/histories/{id}/messages` export reads persisted
+after-the-fact tool I/O for workspace editors. The client-owner
+`GET /api/v2/chats/{id}/messages` route remains available for explicitly
+client-visible reads. The legacy V1 history read remains useful for compact
+turn-level compatibility only.
 
 ### 10. A KB has exactly ONE level of folders — no nesting
 

{codeer_cli-0.1.13 → codeer_cli-0.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codeer-cli
-Version: 0.1.13
+Version: 0.1.15
 Summary: Command line tools for managing Codeer agents over the Codeer API.
 Project-URL: Homepage, https://www.codeer.ai
 Author: Codeer.AI
@@ -98,7 +98,8 @@ CODEER_AGENT_ID=<agent-id>
 
 ## Development install
 
-Use an editable install while the CLI is changing quickly:
+Codeer contributors should use an editable install from this checkout, not the
+PyPI package, so the `codeer` command always executes the folder being edited:
 
 ```bash
 cd /path/to/codeer-skills/codeer-cli
@@ -123,6 +124,34 @@ List the active cloud models without opening the Codeer web app:
 codeer model list --type text
 ```
 
+## Custom evaluator judge models
+
+Custom evaluator create/update commands can select a judge LLM model by ID:
+
+```bash
+codeer eval evaluator-create \
+  --name "Correctness" \
+  --system-prompt-template-file evaluator-prompt.txt \
+  --judge-model <model-id> \
+  --dry-run
+
+codeer eval evaluator-update \
+  --evaluator <evaluator-id> \
+  --judge-model <model-id> \
+  --dry-run
+```
+
+Omit the judge-model flags on update to leave the current setting unchanged.
+Use `--clear-judge-model` to explicitly clear the override and return to the
+system default:
+
+```bash
+codeer eval evaluator-update \
+  --evaluator <evaluator-id> \
+  --clear-judge-model \
+  --dry-run
+```
+
 ## Agent human handoff
 
 `codeer agent apply` accepts the same `human_handoff` object as the Agent API.
@@ -197,10 +226,22 @@ Flags:
   for raw eval results, full conversation turns, full rubric matrices, and
   other data that can grow with cases, versions, or turns.
 
-`history conversations` reads Chat V2 parts and follows all pages
-automatically. Its stdout is still a bounded summary; the `--out` artifact is
-the complete client-visible history, including tool calls/results,
-attachments, interactions, feedback, and passthrough metadata.
+`history conversations` defaults to the workspace-editor management export and
+follows all pages automatically. Its stdout is a bounded summary that never
+prints tool arguments or results; the `--out` artifact preserves the complete
+`history-parts-v1` payload, including persisted tool calls/results,
+attachments, feedback, and metadata. System prompts and provider raw traces are
+not part of that export contract, and a missing part does not prove that a tool
+was not executed.
+
+Use the external client-owner contract only when that distinction is the point
+of the test:
+
+```bash
+codeer history conversations <history-id> \
+  --client-visible --user <external-user-id> \
+  --out .codeer/current/client-history-<history-id>.json
+```
 
 Avoid piping large raw JSON directly into agent chat. Prefer `--out`, then ask
 the coding agent to inspect targeted summaries, IDs, failing cases, or selected
@@ -228,6 +269,45 @@ paths containing `*` so the shell passes the wildcard to the CLI. Advanced
 settings can still be passed through `--config-json`; explicit crawler flags
 override matching JSON keys.
 
+## Exporting KB snapshot content
+
+Export one file directly from the content endpoint:
+
+```bash
+codeer kb export \
+  --node-id <file-node-id> \
+  --file guide.md
+```
+
+Or recursively export a folder or an entire KB root:
+
+```bash
+codeer kb export \
+  --node-id <folder-or-kb-root-node-id> \
+  --dir kb-export \
+  --out kb-export-manifest.json
+```
+
+`--file` and `--dir` are mutually exclusive. Single-file mode maps directly to
+the external file-content endpoint and lets the caller choose the exact local
+path. Folder mode recursively lists the node tree, calls that endpoint for each
+file, and writes the extracted snapshot content as UTF-8 Markdown. Existing
+`.md`/`.markdown` names are preserved; other folder-export names receive an
+additional `.md` suffix (for example, `guide.pdf` becomes `guide.pdf.md`) so the
+export is not mistaken for the original binary upload.
+
+The command asks the content endpoint for every file regardless of indexing
+status. If the endpoint returns text, it is exported even when the status is
+not `READY`; the full manifest preserves that server status and marks the file
+as `exported_while_not_ready`. If the endpoint returns `content: null`, the file
+is skipped and the command exits non-zero. Existing target files block the
+entire export before any content is written; pass `--overwrite` only when
+replacing those local files is intended.
+
+This is a snapshot-content export, not an original-file backup. The server API
+returns processed text and does not return the original PDF, DOCX, or other
+binary bytes through this endpoint.
+
 ## KB node rename and delete
 
 Knowledge Base roots, folders, and files are all KnowledgeNodes. Use

{codeer_cli-0.1.13 → codeer_cli-0.1.15}/README.md

@@ -80,7 +80,8 @@ CODEER_AGENT_ID=<agent-id>
 
 ## Development install
 
-Use an editable install while the CLI is changing quickly:
+Codeer contributors should use an editable install from this checkout, not the
+PyPI package, so the `codeer` command always executes the folder being edited:
 
 ```bash
 cd /path/to/codeer-skills/codeer-cli
@@ -105,6 +106,34 @@ List the active cloud models without opening the Codeer web app:
 codeer model list --type text
 ```
 
+## Custom evaluator judge models
+
+Custom evaluator create/update commands can select a judge LLM model by ID:
+
+```bash
+codeer eval evaluator-create \
+  --name "Correctness" \
+  --system-prompt-template-file evaluator-prompt.txt \
+  --judge-model <model-id> \
+  --dry-run
+
+codeer eval evaluator-update \
+  --evaluator <evaluator-id> \
+  --judge-model <model-id> \
+  --dry-run
+```
+
+Omit the judge-model flags on update to leave the current setting unchanged.
+Use `--clear-judge-model` to explicitly clear the override and return to the
+system default:
+
+```bash
+codeer eval evaluator-update \
+  --evaluator <evaluator-id> \
+  --clear-judge-model \
+  --dry-run
+```
+
 ## Agent human handoff
 
 `codeer agent apply` accepts the same `human_handoff` object as the Agent API.
@@ -179,10 +208,22 @@ Flags:
   for raw eval results, full conversation turns, full rubric matrices, and
   other data that can grow with cases, versions, or turns.
 
-`history conversations` reads Chat V2 parts and follows all pages
-automatically. Its stdout is still a bounded summary; the `--out` artifact is
-the complete client-visible history, including tool calls/results,
-attachments, interactions, feedback, and passthrough metadata.
+`history conversations` defaults to the workspace-editor management export and
+follows all pages automatically. Its stdout is a bounded summary that never
+prints tool arguments or results; the `--out` artifact preserves the complete
+`history-parts-v1` payload, including persisted tool calls/results,
+attachments, feedback, and metadata. System prompts and provider raw traces are
+not part of that export contract, and a missing part does not prove that a tool
+was not executed.
+
+Use the external client-owner contract only when that distinction is the point
+of the test:
+
+```bash
+codeer history conversations <history-id> \
+  --client-visible --user <external-user-id> \
+  --out .codeer/current/client-history-<history-id>.json
+```
 
 Avoid piping large raw JSON directly into agent chat. Prefer `--out`, then ask
 the coding agent to inspect targeted summaries, IDs, failing cases, or selected
@@ -210,6 +251,45 @@ paths containing `*` so the shell passes the wildcard to the CLI. Advanced
 settings can still be passed through `--config-json`; explicit crawler flags
 override matching JSON keys.
 
+## Exporting KB snapshot content
+
+Export one file directly from the content endpoint:
+
+```bash
+codeer kb export \
+  --node-id <file-node-id> \
+  --file guide.md
+```
+
+Or recursively export a folder or an entire KB root:
+
+```bash
+codeer kb export \
+  --node-id <folder-or-kb-root-node-id> \
+  --dir kb-export \
+  --out kb-export-manifest.json
+```
+
+`--file` and `--dir` are mutually exclusive. Single-file mode maps directly to
+the external file-content endpoint and lets the caller choose the exact local
+path. Folder mode recursively lists the node tree, calls that endpoint for each
+file, and writes the extracted snapshot content as UTF-8 Markdown. Existing
+`.md`/`.markdown` names are preserved; other folder-export names receive an
+additional `.md` suffix (for example, `guide.pdf` becomes `guide.pdf.md`) so the
+export is not mistaken for the original binary upload.
+
+The command asks the content endpoint for every file regardless of indexing
+status. If the endpoint returns text, it is exported even when the status is
+not `READY`; the full manifest preserves that server status and marks the file
+as `exported_while_not_ready`. If the endpoint returns `content: null`, the file
+is skipped and the command exits non-zero. Existing target files block the
+entire export before any content is written; pass `--overwrite` only when
+replacing those local files is intended.
+
+This is a snapshot-content export, not an original-file backup. The server API
+returns processed text and does not return the original PDF, DOCX, or other
+binary bytes through this endpoint.
+
 ## KB node rename and delete
 
 Knowledge Base roots, folders, and files are all KnowledgeNodes. Use

{codeer_cli-0.1.13 → codeer_cli-0.1.15}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codeer-cli"
-version = "0.1.13"
+version = "0.1.15"
 description = "Command line tools for managing Codeer agents over the Codeer API."
 readme = "README.md"
 requires-python = ">=3.11"

{codeer_cli-0.1.13 → codeer_cli-0.1.15}/src/codeer_cli/cli.py

@@ -3,7 +3,7 @@
     codeer check
     codeer agent list|get|apply|diff|versions
     codeer model list
-    codeer kb list|files|upload|node-rename|node-delete|faq-list|faq-get|faq-create|faq-update|faq-delete
+    codeer kb list|files|export|upload|node-rename|node-delete|faq-list|faq-get|faq-create|faq-update|faq-delete
     codeer eval list|label-list|label-create|label-update|label-delete|case-update|case-delete|evaluators|evaluator-create|evaluator-update|run|export|reconcile|cases-apply|rubrics|rubrics-apply
     codeer history list|get|conversations|negative-feedback|create|send
 """
@@ -31,6 +31,8 @@ Safe workflow for coding agents:
   codeer agent get <agent-id> --full
   codeer kb list
   codeer kb files --kb-id <kb-id>
+  codeer kb export --node-id <file-id> --file guide.md
+  codeer kb export --node-id <folder-id> --dir kb-export
   codeer eval list --agent <agent-id>
   codeer eval label-list
   codeer eval case-update --case <case-id> --input "..." --dry-run

{codeer_cli-0.1.13 → codeer_cli-0.1.15}/src/codeer_cli/commands/eval_cmd.py

@@ -128,6 +128,12 @@ def register(subparsers):
     g.add_argument("--system-prompt-template", help="Evaluator system prompt template text")
     g.add_argument("--system-prompt-template-file", help="Path to evaluator system prompt template")
     p.add_argument("--description", default=None)
+    p.add_argument(
+        "--judge-model",
+        default=None,
+        metavar="MODEL_ID",
+        help="Judge LLM model ID (default: system default)",
+    )
     p.add_argument("--dry-run", action="store_true",
                    help="Validate inputs and print intended mutation without writing server state.")
     p.set_defaults(func=run_evaluator_create)
@@ -140,6 +146,18 @@ def register(subparsers):
     g.add_argument("--system-prompt-template", help="Evaluator system prompt template text")
     g.add_argument("--system-prompt-template-file", help="Path to evaluator system prompt template")
     p.add_argument("--description", default=None)
+    g = p.add_mutually_exclusive_group()
+    g.add_argument(
+        "--judge-model",
+        default=None,
+        metavar="MODEL_ID",
+        help="Set the judge LLM model ID",
+    )
+    g.add_argument(
+        "--clear-judge-model",
+        action="store_true",
+        help="Clear the evaluator override and use the system default judge model",
+    )
     p.add_argument("--dry-run", action="store_true",
                    help="Validate inputs and print intended mutation without writing server state.")
     p.set_defaults(func=run_evaluator_update)
@@ -249,6 +267,7 @@ def _evaluator_summary(evaluator: dict, *, full: bool = False) -> dict:
         "id": evaluator.get("id"),
         "name": evaluator.get("name"),
         "description": evaluator.get("description"),
+        "judge_llm_model_id": evaluator.get("judge_llm_model_id"),
         "system_prompt_template_chars": len(template),
         "has_tool_steps_placeholder": "{tool_steps}" in template,
         "has_output_placeholder": "{output}" in template,
@@ -534,6 +553,10 @@ def run_evaluator_create(args, client) -> int:
             "workspace_id": workspace_id,
             "name": args.name,
             "description": args.description,
+            "judge_model": {
+                "action": "set" if args.judge_model is not None else "use_system_default",
+                "model_id": args.judge_model,
+            },
             "system_prompt_template_chars": len(system_prompt_template or ""),
             "would_write_server_state": True,
             "next_step": "Review this summary, then rerun without --dry-run after approval.",
@@ -545,6 +568,7 @@ def run_evaluator_create(args, client) -> int:
         name=args.name,
         system_prompt_template=system_prompt_template,
         description=args.description,
+        judge_llm_model_id=args.judge_model,
     )
     print_json(_evaluator_summary(evaluator, full=True))
     return 0
@@ -560,13 +584,27 @@ def run_evaluator_update(args, client) -> int:
     else:
         system_prompt_template = args.system_prompt_template
 
-    if args.name is None and args.description is None and system_prompt_template is None:
+    if (
+        args.name is None
+        and args.description is None
+        and system_prompt_template is None
+        and args.judge_model is None
+        and not args.clear_judge_model
+    ):
         log(
             "error: provide at least one of --name, --description, "
-            "--system-prompt-template, --system-prompt-template-file"
+            "--system-prompt-template, --system-prompt-template-file, "
+            "--judge-model, --clear-judge-model"
         )
         return 2
 
+    if args.clear_judge_model:
+        judge_model = {"action": "clear_to_system_default", "model_id": None}
+    elif args.judge_model is not None:
+        judge_model = {"action": "set", "model_id": args.judge_model}
+    else:
+        judge_model = {"action": "unchanged"}
+
     if args.dry_run:
         print_json({
             "dry_run": True,
@@ -574,6 +612,7 @@ def run_evaluator_update(args, client) -> int:
             "evaluator_id": args.evaluator,
             "name": args.name,
             "description": args.description,
+            "judge_model": judge_model,
             "system_prompt_template_chars": (
                 len(system_prompt_template) if system_prompt_template is not None else None
             ),
@@ -582,12 +621,20 @@ def run_evaluator_update(args, client) -> int:
         })
         return 0
 
+    evaluator_kwargs: dict[str, Any] = {
+        "name": args.name,
+        "system_prompt_template": system_prompt_template,
+        "description": args.description,
+    }
+    if args.clear_judge_model:
+        evaluator_kwargs["judge_llm_model_id"] = None
+    elif args.judge_model is not None:
+        evaluator_kwargs["judge_llm_model_id"] = args.judge_model
+
     evaluator = eval_mod.update_evaluator(
         client,
         evaluator_id=args.evaluator,
-        name=args.name,
-        system_prompt_template=system_prompt_template,
-        description=args.description,
+        **evaluator_kwargs,
     )
     print_json(_evaluator_summary(evaluator, full=True))
     return 0

{codeer_cli-0.1.13 → codeer_cli-0.1.15}/src/codeer_cli/commands/history.py

@@ -48,13 +48,17 @@ def register(subparsers):
     # codeer history conversations <id>
     p = sub.add_parser(
         "conversations",
-        help="Summarize all Chat V2 parts in a history. Complete parts/tool payloads require --out.",
+        help="Summarize persisted History parts. Complete parts/tool payloads require --out.",
     )
     p.add_argument("history_id", type=int)
     p.add_argument("--full", action="store_true",
                    help="Require --out and include longer stdout previews; the artifact is always complete.")
     p.add_argument("--out", default=None,
-                   help="Write every unmodified client-visible Chat V2 part to this file.")
+                   help="Write every persisted part allowed by the selected export contract.")
+    p.add_argument("--client-visible", action="store_true",
+                   help="Use the external client-owner Chat V2 contract instead of the management export.")
+    p.add_argument("--user", default=None,
+                   help="external_user_id required with --client-visible.")
     p.set_defaults(func=run_conversations)
 
     # codeer history negative-feedback
@@ -158,10 +162,12 @@ def _history_summary(row: dict, *, full: bool = False) -> dict:
 
 def _part_summary(part: dict, idx: int, *, full: bool = False) -> dict:
     raw_content = part.get("content")
-    if isinstance(raw_content, dict):
+    part_kind = part.get("part_kind")
+    is_tool_part = part_kind in {"tool-call", "tool-return"}
+    if is_tool_part:
+        content_value = None
+    elif isinstance(raw_content, dict):
         content_value = raw_content.get("content")
-        if content_value is None and part.get("part_kind") == "tool-call":
-            content_value = raw_content.get("args")
     else:
         content_value = raw_content
     if isinstance(content_value, str):
@@ -176,7 +182,7 @@ def _part_summary(part: dict, idx: int, *, full: bool = False) -> dict:
         "conversation_id": part.get("conversation_id"),
         "conversation_group_id": part.get("conversation_group_id"),
         "sequence": part.get("sequence"),
-        "part_kind": part.get("part_kind"),
+        "part_kind": part_kind,
         "source": part.get("source"),
         "created_at": part.get("created_at"),
         "content_preview": truncate(content, 600 if full else 240),
@@ -184,6 +190,12 @@ def _part_summary(part: dict, idx: int, *, full: bool = False) -> dict:
         "attachment_count": len(part.get("attached_files") or []),
         "feedback_count": len(part.get("feedbacks") or []),
     }
+    if is_tool_part and isinstance(raw_content, dict):
+        row.update({
+            "tool_name": raw_content.get("tool_name"),
+            "tool_call_id": raw_content.get("tool_call_id"),
+            "outcome": raw_content.get("outcome"),
+        })
     if full:
         row["feedbacks"] = [
             {
@@ -247,24 +259,49 @@ def run_get(args, client) -> int:
 
 
 def run_conversations(args, client) -> int:
-    result = chats_mod.list_messages(client, args.history_id)
-    parts = result.get("messages") or []
     if args.full and not args.out:
         log("error: full conversation payloads are unbounded; pass --out <path>")
         return 2
+    client_visible = bool(getattr(args, "client_visible", False))
+    external_user_id = getattr(args, "user", None)
+    if client_visible and not external_user_id:
+        log("error: --client-visible requires --user <external_user_id>")
+        return 2
+    if external_user_id and not client_visible:
+        log("error: --user is only valid with --client-visible")
+        return 2
+
+    if client_visible:
+        result = chats_mod.list_messages(
+            client,
+            args.history_id,
+            external_user_id=external_user_id,
+        )
+        export_mode = "client-visible"
+    else:
+        result = hist_mod.list_messages(client, args.history_id)
+        export_mode = "management"
+    parts = result.get("messages") or []
     write_json(args.out, result)
     group_ids = {
         p.get("conversation_group_id")
         for p in parts
         if p.get("conversation_group_id")
     }
+    stdout_limit = 50 if args.full else 20
+    shown_parts = parts[:stdout_limit]
     print_json({
         "history_id": args.history_id,
+        "export_mode": export_mode,
+        "export_contract": result.get("export_contract"),
+        "part_revision": result.get("part_revision"),
         "turn_count": len(group_ids),
         "part_count": len(parts),
+        "part_summaries_shown": len(shown_parts),
+        "part_summaries_truncated": len(parts) > len(shown_parts),
         "wrote_full_detail": bool(args.out),
         "stdout_is_summary": True,
-        "parts": [_part_summary(p, i, full=args.full) for i, p in enumerate(parts)],
+        "parts": [_part_summary(p, i, full=args.full) for i, p in enumerate(shown_parts)],
     })
     return 0