codeer-cli 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

codeer_cli/cli.py

@@ -2,8 +2,8 @@
 
     codeer check
     codeer agent list|get|apply|diff|versions
-    codeer kb list|files|upload|faq-list|faq-get|faq-create|faq-update|faq-delete
-    codeer eval list|case-update|case-delete|evaluators|evaluator-create|evaluator-update|run|export|reconcile|cases-apply|rubrics|rubrics-apply
+    codeer kb list|files|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
 """
 
@@ -28,7 +28,9 @@ Safe workflow for coding agents:
   codeer agent list
   codeer agent get <agent-id> --full
   codeer kb list
+  codeer kb files --kb-id <kb-id>
   codeer eval list --agent <agent-id>
+  codeer eval label-list
   codeer eval case-update --case <case-id> --input "..." --dry-run
   codeer eval evaluators
   codeer agent diff --agent <agent-id> --from-version <n> --to-version <n>
@@ -37,10 +39,13 @@ Safe workflow for coding agents:
 Preview mutations before applying:
   codeer agent apply --payload agent.json --dry-run
   codeer eval case-update --case <case-id> --input "..." --dry-run
+  codeer eval label-create --name "routing" --color "#0969da" --dry-run
   codeer eval case-delete --case <case-id> --dry-run
   codeer eval cases-apply --agent <agent-id> --cases eval_cases.json --dry-run
   codeer eval rubrics-apply --rubrics rubrics.json --dry-run
   codeer kb upload --dir kb --name "Product KB" --dry-run
+  codeer kb node-rename --node-id <node-id> --name "New Name" --dry-run
+  codeer kb node-delete --node-id <node-id> --dry-run
   codeer kb faq-create --context-object-id <snapshot-object-id> --question "..." --dry-run
 
 Use --out <path> for large raw artifacts; stdout defaults to compact summaries.

codeer_cli/commands/eval_cmd.py

@@ -46,6 +46,34 @@ def register(subparsers):
                    help="Write stripped full case payloads to this file; stdout stays compact unless --full.")
     p.set_defaults(func=run_list)
 
+    # codeer eval label-list/create/update/delete
+    p = sub.add_parser("label-list", help="List eval case labels in the workspace")
+    p.add_argument("--workspace", default=None, help="Workspace UUID (default: active API-key workspace)")
+    p.add_argument("--out", default=None)
+    p.set_defaults(func=run_label_list)
+
+    p = sub.add_parser("label-create", help="Create an eval case label; run --dry-run first")
+    p.add_argument("--name", required=True)
+    p.add_argument("--color", default=None, help="Hex color like #0969da (default: server default)")
+    p.add_argument("--workspace", default=None, help="Workspace UUID (default: active API-key workspace)")
+    p.add_argument("--dry-run", action="store_true")
+    p.add_argument("--out", default=None)
+    p.set_defaults(func=run_label_create)
+
+    p = sub.add_parser("label-update", help="Update an eval case label; run --dry-run first")
+    p.add_argument("--label", required=True, dest="label_id", help="Eval case label ID")
+    p.add_argument("--name", default=None)
+    p.add_argument("--color", default=None, help="Hex color like #0969da")
+    p.add_argument("--dry-run", action="store_true")
+    p.add_argument("--out", default=None)
+    p.set_defaults(func=run_label_update)
+
+    p = sub.add_parser("label-delete", help="Delete an eval case label; run --dry-run first")
+    p.add_argument("--label", required=True, dest="label_id", help="Eval case label ID")
+    p.add_argument("--dry-run", action="store_true")
+    p.add_argument("--out", default=None)
+    p.set_defaults(func=run_label_delete)
+
     # codeer eval case-update
     p = sub.add_parser("case-update", help="Update one eval case by UUID; run --dry-run first")
     p.add_argument("--case", required=True, dest="case_id", help="Eval case UUID")
@@ -66,6 +94,11 @@ def register(subparsers):
     g.add_argument("--meta-file", help="Path to new case meta JSON object")
     p.add_argument("--attachment-ids", default=None,
                    help="Comma-separated file UUIDs to set as the case attachments")
+    g = p.add_mutually_exclusive_group()
+    g.add_argument("--label-ids", default=None,
+                   help="Comma-separated eval case label IDs to set on the case")
+    g.add_argument("--clear-labels", action="store_true",
+                   help="Remove all labels from the case")
     p.add_argument("--dry-run", action="store_true",
                    help="Validate inputs and print intended mutation without writing server state.")
     p.add_argument("--out", default=None)
@@ -154,6 +187,8 @@ def register(subparsers):
     p.add_argument("--agent", required=True)
     p.add_argument("--attachments-dir", default=None, dest="attachments_dir")
     p.add_argument("--allow-duplicates", action="store_true")
+    p.add_argument("--create-labels", action="store_true",
+                   help="Create missing labels referenced by manifest case labels.")
     p.add_argument("--dry-run", action="store_true",
                    help="Validate manifest and print intended mutations without writing server state.")
     p.add_argument("--out", default=None)
@@ -184,6 +219,7 @@ def register(subparsers):
 # ---------------------------------------------------------------------------
 
 def _case_summary(case: dict, *, full: bool = False) -> dict:
+    labels = case.get("labels") or []
     row = {
         "id": case.get("id"),
         "input_preview": truncate(case.get("input") or "", 240 if full else 80),
@@ -191,6 +227,11 @@ def _case_summary(case: dict, *, full: bool = False) -> dict:
         "expected_output_chars": len(case.get("expected_output") or ""),
         "note_preview": truncate(case.get("note") or "", 180 if full else 100),
         "attachment_count": len(case.get("attachments") or case.get("attachment_ids") or []),
+        "labels": [
+            {"id": label.get("id"), "name": label.get("name"), "color": label.get("color")}
+            for label in labels
+            if isinstance(label, dict)
+        ],
     }
     if full:
         row["created_at"] = case.get("created_at")
@@ -239,6 +280,116 @@ def run_list(args, client) -> int:
     return 0
 
 
+# ---------------------------------------------------------------------------
+# eval case labels
+# ---------------------------------------------------------------------------
+
+def _workspace_arg_or_default(client, workspace_id: str | None) -> str:
+    if workspace_id:
+        return workspace_id
+    ws, _ = client.resolve_scope()
+    return ws
+
+
+def _label_summary(label: dict) -> dict:
+    return {
+        "id": label.get("id"),
+        "name": label.get("name"),
+        "color": label.get("color"),
+        "workspace_id": label.get("workspace_id"),
+    }
+
+
+def run_label_list(args, client) -> int:
+    workspace_id = _workspace_arg_or_default(client, args.workspace)
+    labels = eval_mod.list_case_labels(client, workspace_id=workspace_id)
+    out = {
+        "workspace_id": workspace_id,
+        "label_count": len(labels),
+        "labels": [_label_summary(label) for label in labels],
+    }
+    print_json(out)
+    write_json(args.out, out)
+    return 0
+
+
+def run_label_create(args, client) -> int:
+    workspace_id = _workspace_arg_or_default(client, args.workspace)
+    if args.dry_run:
+        out = {
+            "dry_run": True,
+            "operation": "label_create",
+            "method": "POST",
+            "path": f"/eval/workspaces/{workspace_id}/case-labels",
+            "workspace_id": workspace_id,
+            "name": args.name,
+            "color": args.color,
+            "would_write_server_state": True,
+            "next_step": "Review this summary, then rerun without --dry-run after approval.",
+        }
+        print_json(out)
+        write_json(args.out, out)
+        return 0
+
+    label = eval_mod.create_case_label(
+        client, workspace_id=workspace_id, name=args.name, color=args.color
+    )
+    out = _label_summary(strip_noisy_fields(label))
+    print_json(out)
+    write_json(args.out, out)
+    return 0
+
+
+def run_label_update(args, client) -> int:
+    if args.name is None and args.color is None:
+        log("error: provide --name and/or --color")
+        return 2
+
+    if args.dry_run:
+        out = {
+            "dry_run": True,
+            "operation": "label_update",
+            "method": "PUT",
+            "path": f"/eval/case-labels/{args.label_id}",
+            "label_id": args.label_id,
+            "updates": {"name": args.name, "color": args.color},
+            "would_write_server_state": True,
+            "next_step": "Review this summary, then rerun without --dry-run after approval.",
+        }
+        print_json(out)
+        write_json(args.out, out)
+        return 0
+
+    label = eval_mod.update_case_label(
+        client, label_id=args.label_id, name=args.name, color=args.color
+    )
+    out = _label_summary(strip_noisy_fields(label))
+    print_json(out)
+    write_json(args.out, out)
+    return 0
+
+
+def run_label_delete(args, client) -> int:
+    if args.dry_run:
+        out = {
+            "dry_run": True,
+            "operation": "label_delete",
+            "method": "DELETE",
+            "path": f"/eval/case-labels/{args.label_id}",
+            "label_id": args.label_id,
+            "would_write_server_state": True,
+            "next_step": "Review this summary, then rerun without --dry-run after approval.",
+        }
+        print_json(out)
+        write_json(args.out, out)
+        return 0
+
+    deleted = strip_noisy_fields(eval_mod.delete_case_label(client, label_id=args.label_id))
+    print_json(deleted)
+    write_json(args.out, deleted)
+    return 0
+
+
 # ---------------------------------------------------------------------------
 # eval case-update / case-delete
 # ---------------------------------------------------------------------------
@@ -274,16 +425,17 @@ def run_case_update(args, client) -> int:
         log(f"error: {e}")
         return 2
     attachment_ids = _ids(args.attachment_ids)
+    label_ids = [] if args.clear_labels else _ids(args.label_ids)
 
     has_update = any(
         value is not None
-        for value in (input_text, expected_output, rubric, note, meta, attachment_ids)
-    )
+        for value in (input_text, expected_output, rubric, note, meta, attachment_ids, label_ids)
+    ) or args.clear_labels
     if not has_update:
         log(
             "error: provide at least one of --input, --input-file, --expected-output, "
             "--expected-output-file, --rubric, --rubric-file, --note, --note-file, "
-            "--meta-json, --meta-file, --attachment-ids"
+            "--meta-json, --meta-file, --attachment-ids, --label-ids, --clear-labels"
         )
         return 2
 
@@ -305,6 +457,7 @@ def run_case_update(args, client) -> int:
                 "note_chars": len(note) if note is not None else None,
                 "meta": meta,
                 "attachment_ids": attachment_ids,
+                "label_ids": label_ids,
             },
             "would_write_server_state": True,
             "next_step": "Review this summary, then rerun without --dry-run after approval.",
@@ -320,6 +473,7 @@ def run_case_update(args, client) -> int:
         expected_output=expected_output,
         rubric=rubric,
         attachment_ids=attachment_ids,
+        label_ids=label_ids,
         meta=meta,
         note=note,
     )
@@ -941,6 +1095,50 @@ def _upload_attachment(client: CodeerClient, *, file_path: Path, workspace_id: s
     return uuid
 
 
+def _manifest_label_names(case: dict) -> list[str]:
+    raw = case.get("labels")
+    if raw is None:
+        return []
+    if not isinstance(raw, list) or not all(isinstance(item, str) for item in raw):
+        raise ValueError(f"case '{case.get('label')}' labels must be a list of label names")
+    return [item.strip() for item in raw if item.strip()]
+
+
+def _manifest_label_ids(case: dict) -> list[str] | None:
+    raw = case.get("label_ids")
+    if raw is None:
+        return None
+    if not isinstance(raw, list) or not all(isinstance(item, str) for item in raw):
+        raise ValueError(f"case '{case.get('label')}' label_ids must be a list of label ID strings")
+    return [item.strip() for item in raw if item.strip()]
+
+
+def _dedupe_preserve_order(items: list[str]) -> list[str]:
+    seen: set[str] = set()
+    out: list[str] = []
+    for item in items:
+        if item in seen:
+            continue
+        seen.add(item)
+        out.append(item)
+    return out
+
+
+def _resolve_case_label_ids(case: dict, labels_by_name: dict[str, dict]) -> tuple[list[str] | None, list[str]]:
+    explicit_ids = _manifest_label_ids(case)
+    label_names = _manifest_label_names(case)
+    if explicit_ids is None and not label_names:
+        return None, []
+
+    resolved_ids = list(explicit_ids or [])
+    for name in label_names:
+        label = labels_by_name.get(name.casefold())
+        if label is None:
+            raise ValueError(f"case '{case.get('label')}' references unknown label '{name}'")
+        resolved_ids.append(str(label["id"]))
+    return _dedupe_preserve_order(resolved_ids), label_names
+
+
 def run_cases_apply(args, client) -> int:
     payload = json.loads(Path(args.cases).read_text())
     cases = payload.get("cases") or []
@@ -961,6 +1159,53 @@ def run_cases_apply(args, client) -> int:
         return 2
 
     workspace_id, _ = client.resolve_scope()
+    try:
+        manifest_label_names = sorted({
+            name
+            for case in cases
+            for name in _manifest_label_names(case)
+        }, key=str.casefold)
+        for case in cases:
+            _manifest_label_ids(case)
+    except ValueError as e:
+        log(f"error: {e}")
+        return 2
+
+    labels_by_name: dict[str, dict] = {}
+    created_labels: list[dict] = []
+    would_create_labels: list[str] = []
+    if manifest_label_names:
+        labels_by_name = {
+            (label.get("name") or "").casefold(): label
+            for label in eval_mod.list_case_labels(client, workspace_id=workspace_id)
+            if label.get("name")
+        }
+        missing_label_names = [
+            name for name in manifest_label_names
+            if name.casefold() not in labels_by_name
+        ]
+        if missing_label_names and not args.create_labels:
+            log(
+                "error: manifest references missing labels: "
+                + ", ".join(missing_label_names)
+                + ". Create them first with `codeer eval label-create`, "
+                + "or rerun cases-apply with --create-labels."
+            )
+            return 2
+        if args.dry_run:
+            would_create_labels = missing_label_names
+            for name in missing_label_names:
+                labels_by_name[name.casefold()] = {
+                    "id": f"(new:{name})",
+                    "name": name,
+                    "color": "#0969da",
+                }
+        else:
+            for name in missing_label_names:
+                log(f"creating label: {name}")
+                label = eval_mod.create_case_label(client, workspace_id=workspace_id, name=name)
+                labels_by_name[name.casefold()] = label
+                created_labels.append(_label_summary(label))
 
     existing_by_input: dict[str, dict] = {}
     if not args.allow_duplicates:
@@ -984,6 +1229,11 @@ def run_cases_apply(args, client) -> int:
             return 2
 
         label = case.get("label", "(unlabeled)")
+        try:
+            case_label_ids, case_label_names = _resolve_case_label_ids(case, labels_by_name)
+        except ValueError as e:
+            log(f"error: {e}")
+            return 2
         attachment_ids: list[str] = []
         for fname in case.get("attachment_files") or []:
             fp = (attach_dir / fname).resolve() if attach_dir else None
@@ -1012,16 +1262,26 @@ def run_cases_apply(args, client) -> int:
                         or attachment_ids
                         or case.get("meta") is not None
                         or case.get("note") is not None
+                        or case_label_ids is not None
                     ),
+                    "labels": case_label_names,
+                    "label_ids": case_label_ids,
                     "rubric_count": len(rubrics),
                 })
                 continue
             log(f"reusing existing case: {label} ({case_id[:8]})")
-            if case.get("expected_output") is not None or attachment_ids or case.get("meta") is not None or case.get("note") is not None:
+            if (
+                case.get("expected_output") is not None
+                or attachment_ids
+                or case.get("meta") is not None
+                or case.get("note") is not None
+                or case_label_ids is not None
+            ):
                 eval_mod.update_case(
                     client, case_id,
                     expected_output=case.get("expected_output"),
                     attachment_ids=attachment_ids or None,
+                    label_ids=case_label_ids,
                     meta=case.get("meta"),
                     note=case.get("note"),
                 )
@@ -1040,6 +1300,8 @@ def run_cases_apply(args, client) -> int:
                 "input_chars": len(case.get("input") or ""),
                 "expected_output_chars": len(case.get("expected_output") or ""),
                 "attachment_count": len(attachment_ids),
+                "labels": case_label_names,
+                "label_ids": case_label_ids,
                 "rubric_count": len(rubrics),
             })
             continue
@@ -1049,6 +1311,7 @@ def run_cases_apply(args, client) -> int:
             client, agent_id=args.agent, input=case["input"],
             expected_output=case.get("expected_output"),
             attachment_ids=attachment_ids or None,
+            label_ids=case_label_ids,
             rubrics_by_evaluator=rubrics, meta=case.get("meta"),
             note=case.get("note"),
         )
@@ -1056,12 +1319,19 @@ def run_cases_apply(args, client) -> int:
         labels.append(label)
         created.append({"case_id": result["id"], "label": label})
 
-    out = {"case_ids": case_ids, "labels": labels, "created": created, "reused": reused}
+    out = {
+        "case_ids": case_ids,
+        "labels": labels,
+        "created": created,
+        "reused": reused,
+        "created_case_labels": created_labels,
+    }
     if args.dry_run:
         out.update({
             "dry_run": True,
             "operation": "cases_apply",
             "agent_id": args.agent,
+            "would_create_case_labels": would_create_labels,
             "updates": dry_run_updates,
             "would_write_server_state": True,
             "next_step": "Review this summary, then rerun without --dry-run after approval.",

codeer_cli/commands/kb.py

@@ -87,6 +87,21 @@ def register(subparsers):
     p.add_argument("--poll-timeout", type=int, default=POLL_TIMEOUT)
     p.set_defaults(func=run_upload)
 
+    p = sub.add_parser("node-rename", help="Rename a KB root, folder, or file node; run --dry-run first")
+    p.add_argument("--node-id", required=True, help="KnowledgeNode UUID")
+    p.add_argument("--name", required=True, help="New display name")
+    p.add_argument("--dry-run", action="store_true",
+                   help="Print intended request without writing server state.")
+    p.add_argument("--out", default=None, help="Write result JSON to this file too")
+    p.set_defaults(func=run_node_rename)
+
+    p = sub.add_parser("node-delete", help="Delete a KB root, folder, or file node and descendants; run --dry-run first")
+    p.add_argument("--node-id", required=True, help="KnowledgeNode UUID")
+    p.add_argument("--dry-run", action="store_true",
+                   help="Print intended request without writing server state.")
+    p.add_argument("--out", default=None, help="Write result JSON to this file too")
+    p.set_defaults(func=run_node_delete)
+
     p = sub.add_parser("faq-list", help="List Context Object FAQ entries")
     p.add_argument("--context-object-id", type=int, default=None,
                    help="Filter to a KB file snapshot_object_id")
@@ -107,8 +122,7 @@ def register(subparsers):
     p.add_argument("--context-object-id", type=int, required=True,
                    help="KB file snapshot_object_id from `codeer kb files`")
     p.add_argument("--question", required=True)
-    p.add_argument("--range", dest="ranges", action="append", type=_parse_faq_range, default=None,
-                   help="Reserve matching chunks that overlap START_LINE:END_LINE; repeatable")
+    _add_faq_range_args(p)
     p.add_argument("--dry-run", action="store_true",
                    help="Print intended request without writing server state.")
     p.add_argument("--out", default=None, help="Write result JSON to this file too")
@@ -119,8 +133,7 @@ def register(subparsers):
     p.add_argument("--context-object-id", type=int, default=None,
                    help="Move FAQ to a different KB file snapshot_object_id")
     p.add_argument("--question", default=None)
-    p.add_argument("--range", dest="ranges", action="append", type=_parse_faq_range, default=None,
-                   help="Replace reserved ranges with START_LINE:END_LINE; repeatable")
+    _add_faq_range_args(p, verb="Replace")
     p.add_argument("--dry-run", action="store_true",
                    help="Print intended request without writing server state.")
     p.add_argument("--out", default=None, help="Write result JSON to this file too")
@@ -217,18 +230,50 @@ def _dry_run(path: str | None, result: dict) -> int:
     return 0
 
 
+def _add_faq_range_args(parser, *, verb: str = "Reserve") -> None:
+    parser.add_argument(
+        "--range",
+        dest="ranges",
+        action="append",
+        type=_parse_faq_range,
+        default=None,
+        help=(
+            f"{verb} matching passages as "
+            "START_LINE:START_COLUMN-END_LINE:END_COLUMN; repeatable"
+        ),
+    )
+
+
 def _parse_faq_range(value: str) -> dict[str, int]:
     try:
-        start_raw, end_raw = value.split(":", 1)
-        start_line = int(start_raw)
-        end_line = int(end_raw)
+        start_raw, end_raw = value.split("-", 1)
+        start_line_raw, start_column_raw = start_raw.split(":", 1)
+        end_line_raw, end_column_raw = end_raw.split(":", 1)
+        faq_range = {
+            "start_line": int(start_line_raw),
+            "start_column": int(start_column_raw),
+            "end_line": int(end_line_raw),
+            "end_column": int(end_column_raw),
+        }
     except ValueError as exc:
-        raise argparse.ArgumentTypeError("expected START_LINE:END_LINE") from exc
+        raise argparse.ArgumentTypeError(
+            "expected START_LINE:START_COLUMN-END_LINE:END_COLUMN"
+        ) from exc
+    _validate_faq_range_position(faq_range)
+    return faq_range
+
+
+def _validate_faq_range_position(faq_range: dict[str, int]) -> None:
+    start_line = faq_range["start_line"]
+    end_line = faq_range["end_line"]
+    start_column = faq_range["start_column"]
+    end_column = faq_range["end_column"]
     if start_line < 1 or end_line < 1:
         raise argparse.ArgumentTypeError("line numbers must be >= 1")
-    if end_line < start_line:
-        raise argparse.ArgumentTypeError("END_LINE must be >= START_LINE")
-    return {"start_line": start_line, "end_line": end_line}
+    if start_column < 0 or end_column < 0:
+        raise argparse.ArgumentTypeError("column numbers must be >= 0")
+    if (end_line, end_column) < (start_line, start_column):
+        raise argparse.ArgumentTypeError("end position must be >= start position")
 
 
 def _parse_config_json(config_json: str | None) -> dict | None:
@@ -383,6 +428,72 @@ def run_upload(args, client) -> int:
     return 0 if not not_ready else 1
 
 
+def run_node_rename(args, client) -> int:
+    workspace_id, organization_id = client.resolve_scope()
+    path = f"/external/knowledge-bases/nodes/{args.node_id}"
+    body = {"name": args.name}
+    if args.dry_run:
+        return _dry_run(
+            args.out,
+            {
+                "dry_run": True,
+                "operation": "kb_node_rename",
+                "method": "PATCH",
+                "path": path,
+                "workspace_id": workspace_id,
+                "organization_id": organization_id,
+                "node_id": args.node_id,
+                "body": body,
+                "would_write_server_state": True,
+                "next_step": "Review this summary, then rerun without --dry-run after approval.",
+            },
+        )
+
+    response = strip_noisy_fields(
+        kb_mod.update_node(
+            client,
+            organization_id=organization_id,
+            workspace_id=workspace_id,
+            node_id=args.node_id,
+            name=args.name,
+        )
+    )
+    _print_and_write(args.out, response)
+    return 0
+
+
+def run_node_delete(args, client) -> int:
+    workspace_id, organization_id = client.resolve_scope()
+    path = f"/external/knowledge-bases/nodes/{args.node_id}"
+    if args.dry_run:
+        return _dry_run(
+            args.out,
+            {
+                "dry_run": True,
+                "operation": "kb_node_delete",
+                "method": "DELETE",
+                "path": path,
+                "workspace_id": workspace_id,
+                "organization_id": organization_id,
+                "node_id": args.node_id,
+                "deletes_descendants": True,
+                "would_write_server_state": True,
+                "next_step": "Review this summary, then rerun without --dry-run after approval.",
+            },
+        )
+
+    response = strip_noisy_fields(
+        kb_mod.delete_node(
+            client,
+            organization_id=organization_id,
+            workspace_id=workspace_id,
+            node_id=args.node_id,
+        )
+    )
+    _print_and_write(args.out, response)
+    return 0
+
+
 def run_faq_list(args, client) -> int:
     faqs = kb_mod.list_context_obj_faqs(
         client,

codeer_cli/eval_.py

@@ -22,6 +22,7 @@ def create_case(
     expected_output: Optional[str] = None,
     rubric: Optional[str] = None,
     attachment_ids: Optional[List[str]] = None,
+    label_ids: Optional[List[str]] = None,
     meta: Optional[dict] = None,
     note: Optional[str] = None,
 ) -> dict:
@@ -41,6 +42,8 @@ def create_case(
         body["rubric"] = rubric
     if attachment_ids:
         body["attachment_ids"] = attachment_ids
+    if label_ids is not None:
+        body["label_ids"] = label_ids
     if meta:
         body["meta"] = meta
     if note is not None:
@@ -64,6 +67,7 @@ def update_case(
     expected_output: Optional[str] = None,
     rubric: Optional[str] = None,
     attachment_ids: Optional[List[str]] = None,
+    label_ids: Optional[List[str]] = None,
     meta: Optional[dict] = None,
     note: Optional[str] = None,
 ) -> dict:
@@ -76,6 +80,8 @@ def update_case(
         body["rubric"] = rubric
     if attachment_ids is not None:
         body["attachment_ids"] = attachment_ids
+    if label_ids is not None:
+        body["label_ids"] = label_ids
     if meta is not None:
         body["meta"] = meta
     if note is not None:
@@ -87,6 +93,44 @@ def delete_case(client: CodeerClient, case_id: str) -> dict:
     return client.delete(f"/external/eval/cases/{case_id}")
 
 
+# --- case labels -----------------------------------------------------------
+
+def list_case_labels(client: CodeerClient, *, workspace_id: str) -> list[dict]:
+    return client.get(f"/eval/workspaces/{workspace_id}/case-labels")
+
+
+def create_case_label(
+    client: CodeerClient,
+    *,
+    workspace_id: str,
+    name: str,
+    color: Optional[str] = None,
+) -> dict:
+    body: dict[str, Any] = {"name": name}
+    if color is not None:
+        body["color"] = color
+    return client.post(f"/eval/workspaces/{workspace_id}/case-labels", json=body)
+
+
+def update_case_label(
+    client: CodeerClient,
+    *,
+    label_id: str,
+    name: Optional[str] = None,
+    color: Optional[str] = None,
+) -> dict:
+    body: dict[str, Any] = {}
+    if name is not None:
+        body["name"] = name
+    if color is not None:
+        body["color"] = color
+    return client.put(f"/eval/case-labels/{label_id}", json=body)
+
+
+def delete_case_label(client: CodeerClient, *, label_id: str) -> dict:
+    return client.delete(f"/eval/case-labels/{label_id}")
+
+
 
 # --- evaluators -----------------------------------------------------------
 
@@ -397,6 +441,7 @@ def create_case_with_rubrics(
     rubrics_by_evaluator: dict[str, str],
     expected_output: Optional[str] = None,
     attachment_ids: Optional[List[str]] = None,
+    label_ids: Optional[List[str]] = None,
     meta: Optional[dict] = None,
     note: Optional[str] = None,
 ) -> dict:
@@ -416,6 +461,7 @@ def create_case_with_rubrics(
         input=input,
         expected_output=expected_output,
         attachment_ids=attachment_ids,
+        label_ids=label_ids,
         meta=meta,
         note=note,
     )

codeer_cli/kb.py

@@ -138,6 +138,16 @@ def update_node(
     return client.patch(f"{_base(organization_id, workspace_id)}/nodes/{node_id}", json=body)
 
 
+def delete_node(
+    client: CodeerClient,
+    *,
+    organization_id: str,
+    workspace_id: str,
+    node_id: str,
+) -> dict:
+    return client.delete(f"{_base(organization_id, workspace_id)}/nodes/{node_id}")
+
+
 def upload_file(
     client: CodeerClient,
     *,

{codeer_cli-0.1.4.dist-info → codeer_cli-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeer-cli
-Version: 0.1.4
+Version: 0.1.6
 Summary: Command line tools for managing Codeer agents over the Codeer API.
 Project-URL: Homepage, https://www.codeer.ai
 Author: Codeer.AI
@@ -180,19 +180,37 @@ 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.
 
+## KB node rename and delete
+
+Knowledge Base roots, folders, and files are all KnowledgeNodes. Use
+`codeer kb list` and `codeer kb files` to find node IDs, then preview mutations
+with `--dry-run`:
+
+```bash
+codeer kb node-rename --node-id <node-id> --name "New Name" --dry-run
+codeer kb node-delete --node-id <node-id> --dry-run
+```
+
+`node-delete` deletes the target node and all descendants. Review the dry-run
+output before rerunning without `--dry-run`.
+
 ## Context Object FAQ
 
 Use Context Object FAQ entries to route high-value questions to a canonical KB
 file when semantic retrieval misses the right source. The FAQ target is a KB
-file's `snapshot_object_id`, shown by `codeer kb files`. Add `--range
-START_LINE:END_LINE` when the route should reserve chunks overlapping a stable
-line range inside that file.
+file's `snapshot_object_id`, shown by `codeer kb files`. Add `--range` when the
+route should reserve a stable passage inside that file. Ranges must include both
+line and column positions so the Codeer UI can map them onto rendered Markdown.
 
 ```bash
 codeer kb files --kb-id <kb-id>
 codeer kb faq-list --context-object-id <snapshot-object-id>
-codeer kb faq-create --context-object-id <snapshot-object-id> --question "..." --range 12:18 --dry-run
+codeer kb faq-create --context-object-id <snapshot-object-id> --question "..." --range 12:0-12:42 --dry-run
+codeer kb faq-update <faq-id> --range 12:0-12:42 --dry-run
 ```
 
+`--range` accepts `START_LINE:START_COLUMN-END_LINE:END_COLUMN`; repeat it to
+reserve multiple passages.
+
 After reviewing the dry-run output, rerun the create/update/delete command
 without `--dry-run` to apply it.

{codeer_cli-0.1.4.dist-info → codeer_cli-0.1.6.dist-info}/RECORD

@@ -2,22 +2,22 @@ codeer_cli/__init__.py,sha256=-0gL8upoSsLAnXAfcRrwqZYJbwG0knzQoFf94O7Nc7c,1817
 codeer_cli/_validate.py,sha256=pKUJa2TyTpERx5xmiYNZRn7tFqDxLZ2fF1rHAf1oz14,5415
 codeer_cli/agents.py,sha256=diodgiGhXlowEi8sbCzcSK1qSeCLF2fBe6QBs3Sq_x8,5617
 codeer_cli/chats.py,sha256=YVrZJhoa-d67o6tzX6riGXsbA-ehyhOxrZ8zRCcJNro,2675
-codeer_cli/cli.py,sha256=jhZxn-8fjdh-Y8exjGMg8e4-kHpDBLaORKOVJ3muiLI,4112
+codeer_cli/cli.py,sha256=g-WR2D5MkaUdc13ZrpRCavXD1940CHE9eBELC034tic,4443
 codeer_cli/client.py,sha256=LpHVqf1IYNg1wFfIHnO9q4xg2h3IiGOitzCnvwB-Bcw,9809
 codeer_cli/constants.py,sha256=D1pV3wCoqYybrKGKeoupYjjFWLfaFviKp1yL7oh6Qso,2323
-codeer_cli/eval_.py,sha256=KwDfnJ50rbpRAHFbwNwYxXsVE5xrsT2bo_mSrcGkCmE,14280
+codeer_cli/eval_.py,sha256=z9RXFiYXOEHPKIh31nbooNe_WmlJ-L63GWBDw3CJhmM,15614
 codeer_cli/histories.py,sha256=tk28git_peX4x703CIDU8u72JtlGaytyrtlHfxlK-7A,5979
-codeer_cli/kb.py,sha256=--0MvZJ2OsIbzLh-4TQ-wR7dVK42eaXw-L0qDGFOaxg,10417
+codeer_cli/kb.py,sha256=Ad4h65NByq5Rq5BTeMghLTKlWRhmOC2jxL0BaTGX3EM,10631
 codeer_cli/parse.py,sha256=qrjZn0MUTjGfucp4cwxy8Pt7WS-0x15kK5F7kWTY8Ps,21818
 codeer_cli/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 codeer_cli/commands/_util.py,sha256=VOB_HMWYzHFNY1ElLOED1HB6fpFpsniqH6Yx3VUlMrY,1644
 codeer_cli/commands/agent.py,sha256=amvfVVrbPOkbYKCGvA6EJB30C-aY6WSdfR7u7FklXbs,14793
 codeer_cli/commands/check.py,sha256=lTxolx1mIJ8jldPhJ5FXqie9nbCLVOO-sDPOHTSy1-w,3817
-codeer_cli/commands/eval_cmd.py,sha256=3ZhXMfCVMiqhlxeXkG97L0yEvlrPyG-gDXhXJcJ3430,52825
+codeer_cli/commands/eval_cmd.py,sha256=3Fi_dwpoJ2hceitACunPtR2kVZ84WT2r_CyL-MaJaMw,62902
 codeer_cli/commands/history.py,sha256=Jv7t0GhSZcbZ8OuIXZT34CixXt7ECEVP3nZ-WW_Ya9E,12026
-codeer_cli/commands/kb.py,sha256=vXwgiGHYrLywm3O41-D__7m3d1uZUcw3YYuxKH-08i0,24528
+codeer_cli/commands/kb.py,sha256=kVEinBVM6NN8_0djOqIQErh46dLmArwFngXMNzvGeAI,28345
 codeer_cli/commands/profile.py,sha256=IdlXC_6cqobsfN3JRrAnt-1OgBUsIFneS9QtR4Un6Kc,6521
-codeer_cli-0.1.4.dist-info/METADATA,sha256=lICuz5mFQVcPakFvTqbulc8almN9T0gVcF5Hi1Sq3kg,5291
-codeer_cli-0.1.4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-codeer_cli-0.1.4.dist-info/entry_points.txt,sha256=-nXIrlm5SR5r7gg3y8AS0tN66MwmvNHsrlwLNQNGD50,47
-codeer_cli-0.1.4.dist-info/RECORD,,
+codeer_cli-0.1.6.dist-info/METADATA,sha256=HDNq9yUPii8TA-KRxu3Mh0sScklObu3pl9OvUthgsdg,5981
+codeer_cli-0.1.6.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+codeer_cli-0.1.6.dist-info/entry_points.txt,sha256=-nXIrlm5SR5r7gg3y8AS0tN66MwmvNHsrlwLNQNGD50,47
+codeer_cli-0.1.6.dist-info/RECORD,,

{codeer_cli-0.1.4.dist-info → codeer_cli-0.1.6.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.30.1
+Generator: hatchling 1.31.0
 Root-Is-Purelib: true
 Tag: py3-none-any