codeer-cli 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

codeer_cli/commands/kb.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import argparse
 import json
 import time
 from pathlib import Path
@@ -106,6 +107,8 @@ 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")
     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")
@@ -116,6 +119,8 @@ 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")
     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")
@@ -195,6 +200,7 @@ def _faq_summary(faq: dict) -> dict:
         "id": faq.get("id"),
         "context_object_id": faq.get("context_object_id"),
         "question": faq.get("question"),
+        "ranges": faq.get("ranges") or [],
         "has_question_embedding": faq.get("has_question_embedding"),
         "updated_at": faq.get("updated_at"),
     }
@@ -211,6 +217,20 @@ def _dry_run(path: str | None, result: dict) -> int:
     return 0
 
 
+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)
+    except ValueError as exc:
+        raise argparse.ArgumentTypeError("expected START_LINE:END_LINE") from exc
+    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}
+
+
 def _parse_config_json(config_json: str | None) -> dict | None:
     if not config_json:
         return None
@@ -384,6 +404,8 @@ def run_faq_get(args, client) -> int:
 
 def run_faq_create(args, client) -> int:
     body = {"context_object_id": args.context_object_id, "question": args.question}
+    if args.ranges is not None:
+        body["ranges"] = args.ranges
     if args.dry_run:
         return _dry_run(
             args.out,
@@ -403,6 +425,7 @@ def run_faq_create(args, client) -> int:
             client,
             context_object_id=args.context_object_id,
             question=args.question,
+            ranges=args.ranges,
         )
     )
     _print_and_write(args.out, faq)
@@ -410,8 +433,8 @@ def run_faq_create(args, client) -> int:
 
 
 def run_faq_update(args, client) -> int:
-    if args.context_object_id is None and args.question is None:
-        log("error: provide --context-object-id or --question")
+    if args.context_object_id is None and args.question is None and args.ranges is None:
+        log("error: provide --context-object-id, --question, or --range")
         return 2
 
     body: dict[str, object] = {}
@@ -419,6 +442,8 @@ def run_faq_update(args, client) -> int:
         body["context_object_id"] = args.context_object_id
     if args.question is not None:
         body["question"] = args.question
+    if args.ranges is not None:
+        body["ranges"] = args.ranges
 
     if args.dry_run:
         return _dry_run(
@@ -440,6 +465,7 @@ def run_faq_update(args, client) -> int:
             faq_id=args.faq_id,
             context_object_id=args.context_object_id,
             question=args.question,
+            ranges=args.ranges,
         )
     )
     _print_and_write(args.out, faq)

codeer_cli/kb.py

@@ -252,11 +252,12 @@ def create_context_obj_faq(
     *,
     context_object_id: int,
     question: str,
+    ranges: Optional[list[dict[str, int]]] = None,
 ) -> dict:
-    return client.post(
-        _faq_base(),
-        json={"context_object_id": context_object_id, "question": question},
-    )
+    body: dict[str, Any] = {"context_object_id": context_object_id, "question": question}
+    if ranges is not None:
+        body["ranges"] = ranges
+    return client.post(_faq_base(), json=body)
 
 
 def update_context_obj_faq(
@@ -265,12 +266,15 @@ def update_context_obj_faq(
     faq_id: int,
     context_object_id: Optional[int] = None,
     question: Optional[str] = None,
+    ranges: Optional[list[dict[str, int]]] = None,
 ) -> dict:
     body: dict[str, Any] = {}
     if context_object_id is not None:
         body["context_object_id"] = context_object_id
     if question is not None:
         body["question"] = question
+    if ranges is not None:
+        body["ranges"] = ranges
     return client.patch(f"{_faq_base()}/{faq_id}", json=body)
 
 

{codeer_cli-0.1.2.dist-info → codeer_cli-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codeer-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Command line tools for managing Codeer agents over the Codeer API.
 Project-URL: Homepage, https://www.codeer.ai
 Author: Codeer.AI
@@ -184,12 +184,14 @@ override matching JSON keys.
 
 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`.
+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.
 
 ```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 "..." --dry-run
+codeer kb faq-create --context-object-id <snapshot-object-id> --question "..." --range 12:18 --dry-run
 ```
 
 After reviewing the dry-run output, rerun the create/update/delete command

{codeer_cli-0.1.2.dist-info → codeer_cli-0.1.3.dist-info}/RECORD

@@ -7,7 +7,7 @@ codeer_cli/client.py,sha256=LpHVqf1IYNg1wFfIHnO9q4xg2h3IiGOitzCnvwB-Bcw,9809
 codeer_cli/constants.py,sha256=D1pV3wCoqYybrKGKeoupYjjFWLfaFviKp1yL7oh6Qso,2323
 codeer_cli/eval_.py,sha256=EsH8f8nT8x9MFlUhpHWSAU4aNPkNceD-Tw5GM15Ae1I,14157
 codeer_cli/histories.py,sha256=tk28git_peX4x703CIDU8u72JtlGaytyrtlHfxlK-7A,5979
-codeer_cli/kb.py,sha256=Y1tLWGLJ9ck92Rwyi2zy3-tkJNautbSRvpXkSVqB9ac,10188
+codeer_cli/kb.py,sha256=--0MvZJ2OsIbzLh-4TQ-wR7dVK42eaXw-L0qDGFOaxg,10417
 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
@@ -15,9 +15,9 @@ codeer_cli/commands/agent.py,sha256=amvfVVrbPOkbYKCGvA6EJB30C-aY6WSdfR7u7FklXbs,
 codeer_cli/commands/check.py,sha256=lTxolx1mIJ8jldPhJ5FXqie9nbCLVOO-sDPOHTSy1-w,3817
 codeer_cli/commands/eval_cmd.py,sha256=yvqjPXMOE7V0Hv53iEW5HvIo610dgiIG4BpKGWzZY4I,46965
 codeer_cli/commands/history.py,sha256=Jv7t0GhSZcbZ8OuIXZT34CixXt7ECEVP3nZ-WW_Ya9E,12026
-codeer_cli/commands/kb.py,sha256=lIoYfP3_VY_S6R9P9r5pcItEjxJY5Tx_eO7eY1n6Gao,23285
+codeer_cli/commands/kb.py,sha256=vXwgiGHYrLywm3O41-D__7m3d1uZUcw3YYuxKH-08i0,24528
 codeer_cli/commands/profile.py,sha256=IdlXC_6cqobsfN3JRrAnt-1OgBUsIFneS9QtR4Un6Kc,6521
-codeer_cli-0.1.2.dist-info/METADATA,sha256=k610R7Tw9ZrPKME69coKFJ1aF-sZWx-5JEX_8glgWx8,5156
-codeer_cli-0.1.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-codeer_cli-0.1.2.dist-info/entry_points.txt,sha256=-nXIrlm5SR5r7gg3y8AS0tN66MwmvNHsrlwLNQNGD50,47
-codeer_cli-0.1.2.dist-info/RECORD,,
+codeer_cli-0.1.3.dist-info/METADATA,sha256=lI76CTicsBTRGXZStaOs6I5kK98Pwf7-PV3XtIlxFsA,5291
+codeer_cli-0.1.3.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+codeer_cli-0.1.3.dist-info/entry_points.txt,sha256=-nXIrlm5SR5r7gg3y8AS0tN66MwmvNHsrlwLNQNGD50,47
+codeer_cli-0.1.3.dist-info/RECORD,,