sibyl-memory-cli 0.3.22__tar.gz → 0.4.0__tar.gz

{sibyl_memory_cli-0.3.22/src/sibyl_memory_cli.egg-info → sibyl_memory_cli-0.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sibyl-memory-cli
-Version: 0.3.22
+Version: 0.4.0
 Summary: Command-line interface for the Sibyl Memory Plugin. `sibyl init` activates, `sibyl upgrade` runs the staker / subscription flow, `sibyl status` shows current tier and DB stats, `sibyl whoami` gives a one-line account summary, `sibyl devices` lists active devices and supports per-device revoke.
 Author-email: "SIBYL, Sibyl Labs LLC" <sibyl@sibyllabs.org>
 License: MIT
@@ -20,11 +20,11 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sibyl-memory-client>=0.6.1
-Requires-Dist: sibyl-memory-hermes>=0.3.2
+Requires-Dist: sibyl-memory-client>=0.8.0
+Requires-Dist: sibyl-memory-hermes>=0.4.0
 Requires-Dist: pyyaml<7,>=6.0
 Provides-Extra: mcp
-Requires-Dist: sibyl-memory-mcp>=0.1.2; extra == "mcp"
+Requires-Dist: sibyl-memory-mcp>=0.2.0; extra == "mcp"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Dynamic: license-file

{sibyl_memory_cli-0.3.22 → sibyl_memory_cli-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sibyl-memory-cli"
-version = "0.3.22"
+version = "0.4.0"
 description = "Command-line interface for the Sibyl Memory Plugin. `sibyl init` activates, `sibyl upgrade` runs the staker / subscription flow, `sibyl status` shows current tier and DB stats, `sibyl whoami` gives a one-line account summary, `sibyl devices` lists active devices and supports per-device revoke."
 authors = [{ name = "SIBYL, Sibyl Labs LLC", email = "sibyl@sibyllabs.org" }]
 license = { text = "MIT" }
@@ -23,14 +23,14 @@ classifiers = [
   "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
-  "sibyl-memory-client>=0.6.1",
-  "sibyl-memory-hermes>=0.3.2",
+  "sibyl-memory-client>=0.8.0",
+  "sibyl-memory-hermes>=0.4.0",
   "pyyaml>=6.0,<7",
 ]
 
 [project.optional-dependencies]
 mcp = [
-  "sibyl-memory-mcp>=0.1.2",
+  "sibyl-memory-mcp>=0.2.0",
 ]
 dev = [
   "pytest>=7.0",

{sibyl_memory_cli-0.3.22 → sibyl_memory_cli-0.4.0}/src/sibyl_memory_cli/cli.py

@@ -1549,6 +1549,10 @@ def cmd_memory(args: argparse.Namespace) -> int:
     you can inspect any split-brain store that `sibyl status` surfaces.
     """
     from sibyl_memory_client import DEFAULT_TENANT, MemoryClient
+    # THE canonical cause vocabulary (stage 3, 2026-08-31). Imported from the
+    # client, never re-declared here — the CLI prints causes, it does not own
+    # them.
+    from sibyl_memory_client.verdicts import refine_zero
 
     db_path = Path(args.db).expanduser()
     print()
@@ -1582,9 +1586,21 @@ def cmd_memory(args: argparse.Namespace) -> int:
             print(a.kv(f"{cat}/{name}", r.get("status") or "-"))
         return 0
     if op == "search":
-        hits = client.search(args.query, limit=args.limit)
+        # THE VERDICT CONTRACT (stage 3, 2026-08-31). This used to print
+        # "(no matches)" and stop — the terminal-shaped version of the defect
+        # this stage closes: a zero that cannot explain itself. The SDK now
+        # returns a cause on every call, and `refine_zero` pays one COUNT on the
+        # zero path so a brand-new user is told their store is EMPTY rather than
+        # left to conclude their query was wrong.
+        hits = refine_zero(client, client.search(args.query, limit=args.limit))
         if not hits:
             print(a.dim(f"(no matches for {args.query!r})"))
+            verdict = getattr(hits, "verdict", None)
+            if verdict is not None:
+                # Plain language, generated from the enum and never from stored
+                # text, so it is always safe to print to a terminal.
+                print(a.warn_line(verdict.explain()))
+                print(a.dim(f"cause: {verdict.code.value}"))
             return 0
         print(a.eyebrow(f"matches ({len(hits)})"))
         for h in hits:

{sibyl_memory_cli-0.3.22 → sibyl_memory_cli-0.4.0/src/sibyl_memory_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sibyl-memory-cli
-Version: 0.3.22
+Version: 0.4.0
 Summary: Command-line interface for the Sibyl Memory Plugin. `sibyl init` activates, `sibyl upgrade` runs the staker / subscription flow, `sibyl status` shows current tier and DB stats, `sibyl whoami` gives a one-line account summary, `sibyl devices` lists active devices and supports per-device revoke.
 Author-email: "SIBYL, Sibyl Labs LLC" <sibyl@sibyllabs.org>
 License: MIT
@@ -20,11 +20,11 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sibyl-memory-client>=0.6.1
-Requires-Dist: sibyl-memory-hermes>=0.3.2
+Requires-Dist: sibyl-memory-client>=0.8.0
+Requires-Dist: sibyl-memory-hermes>=0.4.0
 Requires-Dist: pyyaml<7,>=6.0
 Provides-Extra: mcp
-Requires-Dist: sibyl-memory-mcp>=0.1.2; extra == "mcp"
+Requires-Dist: sibyl-memory-mcp>=0.2.0; extra == "mcp"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Dynamic: license-file

{sibyl_memory_cli-0.3.22 → sibyl_memory_cli-0.4.0}/src/sibyl_memory_cli.egg-info/SOURCES.txt

@@ -26,4 +26,5 @@ tests/test_quality_fixes_2026_06_30.py
 tests/test_setup.py
 tests/test_status_stores_2026_06_11.py
 tests/test_superpatch_2026_07_05.py
+tests/test_verdict_contract_2026_08_31.py
 tests/test_wiring_fix.py

sibyl_memory_cli-0.4.0/src/sibyl_memory_cli.egg-info/requires.txt

@@ -0,0 +1,9 @@
+sibyl-memory-client>=0.8.0
+sibyl-memory-hermes>=0.4.0
+pyyaml<7,>=6.0
+
+[dev]
+pytest>=7.0
+
+[mcp]
+sibyl-memory-mcp>=0.2.0

sibyl_memory_cli-0.4.0/tests/test_verdict_contract_2026_08_31.py

@@ -0,0 +1,126 @@
+"""The verdict contract in the terminal (stage 3, 2026-08-31).
+
+`sibyl memory search` used to print "(no matches for 'x')" and stop. That is the
+terminal-shaped version of the defect this stage closes: a zero that cannot
+explain itself, and in the CLI's case the person reading it is a new user
+deciding whether the product works. "No matches" against an EMPTY store is the
+single most misleading thing this command could say, and it was what it said.
+
+These tests pin that every zero prints a cause in plain language, that the cause
+is the canonical one from `sibyl_memory_client.verdicts` rather than a
+CLI-local string, and that nothing about a successful search changed.
+"""
+from __future__ import annotations
+
+import ast
+import inspect
+from pathlib import Path
+
+from sibyl_memory_client import MemoryClient
+from sibyl_memory_client.verdicts import GateCause, VerdictCode
+from sibyl_memory_cli import cli
+
+
+def _store(tmp_path: Path) -> Path:
+    d = tmp_path / "memory.db"
+    c = MemoryClient.local(path=d)
+    c.set_entity("partner", "Blocktronics",
+                 {"stage": "active", "note": "token forensics suite"})
+    c.set_entity("partner", "Reppo", {"stage": "negotiation"})
+    return d
+
+
+def _empty_store(tmp_path: Path) -> Path:
+    d = tmp_path / "empty.db"
+    MemoryClient.local(path=d)
+    return d
+
+
+def test_a_zero_result_prints_a_cause_not_just_no_matches(tmp_path, capsys):
+    d = _store(tmp_path)
+    rc = cli.main(["--db", str(d), "memory", "search", "qwzjvxzzyplm"])
+    out = capsys.readouterr().out
+    assert rc == 0
+    assert "(no matches" in out
+    assert f"cause: {VerdictCode.NO_MATCH.value}" in out
+    assert "genuine miss" in out
+
+
+def test_an_empty_store_says_so_instead_of_blaming_the_query(tmp_path, capsys):
+    """The one that matters most to a new user: this is a fixable state, and
+    'no matches' hid that behind what looks like a failed search."""
+    d = _empty_store(tmp_path)
+    rc = cli.main(["--db", str(d), "memory", "search", "anything at all"])
+    out = capsys.readouterr().out
+    assert rc == 0
+    assert f"cause: {VerdictCode.EMPTY_STORE.value}" in out
+    assert "no rows yet" in out
+
+
+def test_the_cause_is_plain_language_a_human_can_act_on(tmp_path, capsys):
+    d = _empty_store(tmp_path)
+    cli.main(["--db", str(d), "memory", "search", "anything at all"])
+    out = capsys.readouterr().out
+    # a sentence, not an enum dump
+    assert "Nothing was returned" in out
+
+
+def test_a_successful_search_is_unchanged(tmp_path, capsys):
+    d = _store(tmp_path)
+    rc = cli.main(["--db", str(d), "memory", "search", "forensics"])
+    out = capsys.readouterr().out
+    assert rc == 0 and "Blocktronics" in out
+    assert "cause:" not in out          # no noise on the success path
+
+# --------------------------------------------------------------------------
+# one vocabulary
+# --------------------------------------------------------------------------
+def _code_only(text: str) -> str:
+    """Strip docstrings and comments, leaving code.
+
+    Parsed, not split on `\"\"\"`. The first version of this helper did
+    `text.replace('\"\"\"', chr(0)).split(chr(0))[0::2]`, which silently INVERTS
+    which half it scans when the marker count is odd — the test would then check
+    the prose and skip the code, and still pass.
+    """
+    try:
+        tree = ast.parse(text)
+    except SyntaxError:                                # pragma: no cover
+        return text
+    spans = []
+    for node in ast.walk(tree):
+        body = getattr(node, "body", None)
+        if not isinstance(body, list):                 # ast.IfExp.body is an expr
+            continue
+        for child in body:
+            if (isinstance(child, ast.Expr)
+                    and isinstance(child.value, ast.Constant)
+                    and isinstance(child.value.value, str)):
+                spans.append((child.lineno, child.end_lineno))
+    drop = {i for a, b in spans for i in range(a, b + 1)}
+    return "\n".join(ln.split("#", 1)[0]
+                     for i, ln in enumerate(text.splitlines(), 1) if i not in drop)
+
+
+#: Derived from the enums, so renaming a cause updates the guard automatically.
+CAUSE_LITERALS = tuple([c.value for c in VerdictCode if c is not VerdictCode.OK]
+                       + [g.value for g in GateCause])
+
+
+def _assert_declares_no_vocabulary(*modules):
+    """BOTH quote styles. These tests originally checked only double quotes, and
+    an adversarial review slipped `_LOCAL_CAUSE_COPY = 'abstained_on'` into the
+    MCP server past a green suite — exactly the drift the guard exists to stop."""
+    offenders = []
+    for mod in modules:
+        code = _code_only(inspect.getsource(mod))
+        for lit in CAUSE_LITERALS:
+            if f'"{lit}"' in code or f"'{lit}'" in code:
+                offenders.append((mod.__name__, lit))
+    assert offenders == [], f"cause strings re-declared outside verdicts.py: {offenders}"
+
+
+def test_the_cli_imports_the_vocabulary_and_declares_none():
+    """One vocabulary, one module. The CLI prints causes; it does not own them."""
+    assert "from sibyl_memory_client.verdicts import refine_zero" in inspect.getsource(cli)
+    _assert_declares_no_vocabulary(cli)

sibyl_memory_cli-0.3.22/src/sibyl_memory_cli.egg-info/requires.txt

@@ -1,9 +0,0 @@
-sibyl-memory-client>=0.6.1
-sibyl-memory-hermes>=0.3.2
-pyyaml<7,>=6.0
-
-[dev]
-pytest>=7.0
-
-[mcp]
-sibyl-memory-mcp>=0.1.2