ndi-cli 0.6.0__tar.gz → 0.7.0__tar.gz

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ndi-cli
-Version: 0.6.0
+Version: 0.7.0
 Summary: NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools
 Keywords: ndi,cli,document-intelligence,coding-agents
 Author: Nace AI
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Requires-Dist: ndi-sdk>=0.21,<1
+Requires-Dist: ndi-sdk>=0.22,<1
 Requires-Dist: truststore>=0.10.4,<1
 Requires-Python: >=3.11
 Project-URL: Homepage, https://ndi-api.nace.ai
@@ -56,6 +56,7 @@ config location. Workspace-scoped verbs also take `--workspace ID`.
 | `ndi files upload\|list\|get\|delete` | Workspace files (`--ingest` uploads then queues ingestion) |
 | `ndi ingest` | Queue ingestion |
 | `ndi deep-search QUERY` / `ndi fact-search QUERY` | Agentic / single-shot search |
+| `ndi je-testing QUERY` | Journal-entry testing over a ledger package (`--path` to scope it, `--effort` for the level) |
 | `ndi folder-metadata` / `file-metadata` / `read-file` / `ask-file` / `run-sql` / `hybrid-search` | Read-only workspace tools (the sandbox surface) |
 
 ## Sources
@@ -85,4 +86,5 @@ API failures exit 1. Usage / config errors exit 2. Schema-validation
 failures also show up to five field constraints, each limited to 500
 characters; request input and unrelated error-detail fields are omitted.
 
-See `SKILL.md` for the agent-facing guide to the six workspace tools.
+See the [CLI guide](https://docs.ndi.nace.ai/guides/cli) for the full command
+reference. `SKILL.md` is the agent-facing guide to the six workspace tools.

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/README.md

@@ -32,6 +32,7 @@ config location. Workspace-scoped verbs also take `--workspace ID`.
 | `ndi files upload\|list\|get\|delete` | Workspace files (`--ingest` uploads then queues ingestion) |
 | `ndi ingest` | Queue ingestion |
 | `ndi deep-search QUERY` / `ndi fact-search QUERY` | Agentic / single-shot search |
+| `ndi je-testing QUERY` | Journal-entry testing over a ledger package (`--path` to scope it, `--effort` for the level) |
 | `ndi folder-metadata` / `file-metadata` / `read-file` / `ask-file` / `run-sql` / `hybrid-search` | Read-only workspace tools (the sandbox surface) |
 
 ## Sources
@@ -61,4 +62,5 @@ API failures exit 1. Usage / config errors exit 2. Schema-validation
 failures also show up to five field constraints, each limited to 500
 characters; request input and unrelated error-detail fields are omitted.
 
-See `SKILL.md` for the agent-facing guide to the six workspace tools.
+See the [CLI guide](https://docs.ndi.nace.ai/guides/cli) for the full command
+reference. `SKILL.md` is the agent-facing guide to the six workspace tools.

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ndi-cli"
-version = "0.6.0"
+version = "0.7.0"
 description = "NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools"
 readme = "README.md"
 license = "MIT"
@@ -24,7 +24,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "ndi-sdk>=0.21,<1",
+    "ndi-sdk>=0.22,<1",
     "truststore>=0.10.4,<1",
 ]
 

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "ndi-cli"
-version = "0.6.0"
+version = "0.7.0"
 description = "NDI platform CLI: document operations, jobs, workspaces, and the agent workspace tools"
 authors = [
     { name = "Nace AI", email = "engineering@nace.ai" }
@@ -27,7 +27,7 @@ classifiers = [
     "Typing :: Typed",
 ]
 dependencies = [
-    "ndi-sdk>=0.21,<1",
+    "ndi-sdk>=0.22,<1",
     "truststore>=0.10.4,<1",
 ]
 

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/src/ndi_cli/__init__.py

@@ -6,4 +6,4 @@ methods. The six workspace tools (``folder-metadata``, ``file-metadata``,
 in-sandbox surface.
 """
 
-__version__ = "0.6.0"
+__version__ = "0.7.0"

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/src/ndi_cli/_output.py

@@ -6,7 +6,7 @@ import sys
 from collections.abc import Callable
 from pathlib import Path
 
-from ndi_sdk.models.jobs import IngestionResult, Job, ParseResult
+from ndi_sdk.models.jobs import IngestionResult, JetResult, Job, ParseResult
 
 OUTPUT_CHOICES = ("auto", "md", "json", "payload", "id")
 
@@ -108,6 +108,13 @@ def _content_failure(job: Job) -> int:
             file=sys.stderr,
         )
         return 1
+    # A degraded JET run is the same shape: succeeded, but the procedure broke
+    # before it could finalize an answer, so `figures` is empty and only the
+    # working survives. `exhausted` and `partially_performed` stay zero — both
+    # are documented as successful partial answers, not failed work.
+    if isinstance(result, JetResult) and result.degraded:
+        print(f"error: journal-entry testing degraded: {result.degraded}", file=sys.stderr)
+        return 1
     return 0
 
 

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/src/ndi_cli/_render.py

@@ -24,6 +24,7 @@ from ndi_sdk.models.jobs import (
     GroundResult,
     IngestionResult,
     IntelligentSearchResult,
+    JetResult,
     Job,
     ParseResult,
     SplitResult,
@@ -662,6 +663,49 @@ def search_job(job: Job) -> str:
     return job_line(job)
 
 
+def je_testing_job(job: Job) -> str:
+    """The answer, then the numbers behind it — a JET result read at a glance.
+
+    Unlike :func:`search_job` this leads with ``figures``: the answer is prose a
+    person reads, and the figures are the same content a reviewer can check.
+    Each one names the receipt its numbers are readable out of, so
+    ``ndi job <id> -o json`` is the next step rather than the only one.
+    """
+    result = job.result
+    if not isinstance(result, JetResult):
+        return job_line(job)
+    lines: list[str] = []
+    if result.degraded:
+        lines.append(f"degraded: {result.degraded}")
+    if result.answer:
+        lines.append(result.answer.strip())
+    if result.population_statement:
+        lines.append(f"population: {result.population_statement}")
+    if result.figures:
+        lines.append(f"figures ({len(result.figures)}):")
+        for figure in result.figures:
+            if figure.cannot_be_performed:
+                lines.append(f"  {figure.criterion}: not performed")
+            else:
+                value = f" | {figure.value}" if figure.value else ""
+                lines.append(f"  {figure.criterion}: {figure.count}/{figure.population}{value}")
+            # The exception listing is the receipt worth opening: an unfiltered
+            # count points at every row, a listing points at the rows that failed.
+            receipt = figure.exception_listing_result_id or next(iter(figure.result_ids), None)
+            if receipt:
+                lines.append(f"    receipt {receipt}")
+    for discrepancy in result.discrepancies:
+        lines.append(f"discrepancy: {discrepancy}")
+    lines.append(f"evidences ({len(result.evidences)}) | receipts ({len(result.sql_receipts)})")
+    if result.execution_status and result.execution_status != "performed":
+        lines.append(f"execution: {result.execution_status}")
+    if result.quality and result.quality.status != "clean":
+        lines.append(f"quality: {result.quality.status}")
+    if result.exhausted:
+        lines.append("exhausted: step budget ran out before the procedure finished")
+    return "\n".join(lines)
+
+
 def _search_result(answer: str | None, clarification: str | None, evidences: list, *, receipts: int) -> str:
     lines: list[str] = []
     if clarification:

{ndi_cli-0.6.0 → ndi_cli-0.7.0}/src/ndi_cli/_workspace.py

@@ -95,6 +95,17 @@ def add_parsers(sub: argparse._SubParsersAction, common: argparse.ArgumentParser
     add_job_output_args(fact)
     fact.set_defaults(run=_run_fact_search, family="workspace", needs_workspace=True, needs_client=True)
 
+    jet = sub.add_parser("je-testing", parents=[common], help="Run journal-entry testing over a ledger package.")
+    jet.add_argument("query")
+    jet.add_argument("--effort", choices=("low", "medium", "high"), default=None)
+    jet.add_argument("--prefix", default=None, dest="path_prefix")
+    jet.add_argument("--path", action="append", dest="paths", default=None, help="Scope to this file; repeatable.")
+    jet.add_argument("--context", default=None)
+    # No --session-id, for the reason deep-search omits it: a shell has nowhere
+    # to keep a thread. Omitting --effort leaves the deployment's own floor.
+    add_job_output_args(jet)
+    jet.set_defaults(run=_run_je_testing, family="workspace", needs_workspace=True, needs_client=True)
+
 
 def _workspace_id(args: argparse.Namespace, fallback: str) -> str:
     value = getattr(args, "workspace_id", None) or args.workspace or fallback
@@ -224,3 +235,15 @@ def _run_fact_search(client: NdiClient, workspace_id: str, args: argparse.Namesp
         top_k=args.top_k,
     )
     return _finish_job(client, job, args, _render.search_job, "fact-search")
+
+
+def _run_je_testing(client: NdiClient, workspace_id: str, args: argparse.Namespace) -> int:
+    job = client.search.je_testing(
+        workspace_id,
+        query=args.query,
+        context=args.context,
+        effort=args.effort,
+        path_prefix=args.path_prefix,
+        paths=args.paths,
+    )
+    return _finish_job(client, job, args, _render.je_testing_job, "je-testing")