memoryhub-cli 0.2.0__tar.gz → 0.3.0__tar.gz

{memoryhub_cli-0.2.0 → memoryhub_cli-0.3.0}/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 All notable changes to the `memoryhub-cli` package.
 
+## [0.3.0] — 2026-04-09
+
+- **Campaign & domain parameter support (#164)**: Added `--project-id` flag to
+  search, read, write, delete, and history commands. Added `--domain` flag to
+  search and write. When `.memoryhub.yaml` has campaigns configured, `project_id`
+  is auto-loaded from the config so the flag can be omitted.
+
+## [0.2.0] — 2026-04-09
+
+- Added campaign enrollment prompt to `memoryhub config init` (#160).
+- API key check after config init (#153).
+
 ## [0.1.1] — 2026-04-09
 
 - Fix ruff lint errors (import sorting, `Optional` → `X | Y` annotations,

{memoryhub_cli-0.2.0 → memoryhub_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memoryhub-cli
-Version: 0.2.0
+Version: 0.3.0
 Summary: CLI client for MemoryHub — centralized, governed memory for AI agents
 Project-URL: Homepage, https://github.com/redhat-ai-americas/memory-hub
 Project-URL: Repository, https://github.com/redhat-ai-americas/memory-hub
@@ -52,11 +52,17 @@ memoryhub read <memory-id>
 # Write a new memory
 memoryhub write "Use Podman, not Docker" --scope user --weight 0.9
 
+# Campaign-scoped operations (requires project enrollment)
+memoryhub search "shared patterns" --project-id my-project --domain React
+memoryhub write "Use vLLM for embeddings" --project-id my-project --domain ML
+
 # Set up project-level memory loading
 memoryhub config init
 memoryhub config regenerate
 ```
 
+The `--project-id` flag enables campaign-scoped memory access. When your project is enrolled in campaigns via `.memoryhub.yaml`, the CLI auto-loads the project identifier from config, so you can omit the flag in most cases. Use `--domain` to tag writes or boost domain-matching results in search.
+
 ## Project configuration
 
 `memoryhub config` generates a project-local `.memoryhub.yaml` and a companion `.claude/rules/memoryhub-loading.md` rule file. Both files are meant to be committed so every contributor's agent inherits the same loading policy.

{memoryhub_cli-0.2.0 → memoryhub_cli-0.3.0}/README.md

@@ -23,11 +23,17 @@ memoryhub read <memory-id>
 # Write a new memory
 memoryhub write "Use Podman, not Docker" --scope user --weight 0.9
 
+# Campaign-scoped operations (requires project enrollment)
+memoryhub search "shared patterns" --project-id my-project --domain React
+memoryhub write "Use vLLM for embeddings" --project-id my-project --domain ML
+
 # Set up project-level memory loading
 memoryhub config init
 memoryhub config regenerate
 ```
 
+The `--project-id` flag enables campaign-scoped memory access. When your project is enrolled in campaigns via `.memoryhub.yaml`, the CLI auto-loads the project identifier from config, so you can omit the flag in most cases. Use `--domain` to tag writes or boost domain-matching results in search.
+
 ## Project configuration
 
 `memoryhub config` generates a project-local `.memoryhub.yaml` and a companion `.claude/rules/memoryhub-loading.md` rule file. Both files are meant to be committed so every contributor's agent inherits the same loading policy.

{memoryhub_cli-0.2.0 → memoryhub_cli-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "memoryhub-cli"
-version = "0.2.0"
+version = "0.3.0"
 description = "CLI client for MemoryHub — centralized, governed memory for AI agents"
 readme = "README.md"
 license = "Apache-2.0"

{memoryhub_cli-0.2.0 → memoryhub_cli-0.3.0}/src/memoryhub_cli/__init__.py

@@ -1,3 +1,3 @@
 """MemoryHub CLI client."""
 
-__version__ = "0.2.0"
+__version__ = "0.3.0"

{memoryhub_cli-0.2.0 → memoryhub_cli-0.3.0}/src/memoryhub_cli/main.py

@@ -58,6 +58,21 @@ def _get_client():
     )
 
 
+def _get_project_id_default() -> str | None:
+    """Try to load project_id from .memoryhub.yaml campaigns config.
+
+    Returns the project directory name as the project identifier when
+    campaigns are configured, or None when no config/campaigns exist.
+    """
+    try:
+        config = load_project_config()  # auto-discovers .memoryhub.yaml
+        if config.memory_loading.campaigns:
+            return Path.cwd().name
+    except Exception:
+        pass
+    return None
+
+
 def _run(coro):
     """Run an async coroutine."""
     return asyncio.run(coro)
@@ -110,15 +125,23 @@ def search(
     query: str = typer.Argument(..., help="Search query"),
     scope: str | None = typer.Option(None, "--scope", "-s", help="Filter by scope"),
     max_results: int = typer.Option(10, "--max", "-n", help="Maximum results"),
+    project_id: str | None = typer.Option(
+        None, "--project-id", "-p", help="Project ID for campaign access",
+    ),
+    domains: list[str] | None = typer.Option(
+        None, "--domain", help="Domain tags to boost",
+    ),
     json_output: bool = typer.Option(False, "--json", "-j", help="Output as JSON"),
 ):
     """Search memories using semantic similarity."""
     client = _get_client()
+    _project_id = project_id or _get_project_id_default()
 
     async def _do():
         async with client:
             return await client.search(
                 query, scope=scope, max_results=max_results,
+                project_id=_project_id, domains=domains or None,
             )
 
     result = _run(_do())
@@ -158,14 +181,18 @@ def search(
 @app.command()
 def read(
     memory_id: str = typer.Argument(..., help="Memory UUID"),
+    project_id: str | None = typer.Option(
+        None, "--project-id", "-p", help="Project ID for campaign access",
+    ),
     json_output: bool = typer.Option(False, "--json", "-j", help="Output as JSON"),
 ):
     """Read a memory by ID."""
     client = _get_client()
+    _project_id = project_id or _get_project_id_default()
 
     async def _do():
         async with client:
-            return await client.read(memory_id)
+            return await client.read(memory_id, project_id=_project_id)
 
     memory = _run(_do())
 
@@ -193,6 +220,12 @@ def write(
     weight: float = typer.Option(0.7, "--weight", "-w", help="Priority weight 0.0-1.0"),
     parent_id: str | None = typer.Option(None, "--parent", help="Parent memory ID"),
     branch_type: str | None = typer.Option(None, "--branch-type", help="Branch type"),
+    project_id: str | None = typer.Option(
+        None, "--project-id", "-p", help="Project ID for campaign access",
+    ),
+    domains: list[str] | None = typer.Option(
+        None, "--domain", help="Domain tags",
+    ),
     json_output: bool = typer.Option(False, "--json", "-j", help="Output as JSON"),
 ):
     """Write a new memory.
@@ -210,12 +243,14 @@ def write(
         raise typer.Exit(1)
 
     client = _get_client()
+    _project_id = project_id or _get_project_id_default()
 
     async def _do():
         async with client:
             return await client.write(
                 content, scope=scope, weight=weight,
                 parent_id=parent_id, branch_type=branch_type,
+                project_id=_project_id, domains=domains or None,
             )
 
     result = _run(_do())
@@ -240,6 +275,9 @@ def write(
 def delete(
     memory_id: str = typer.Argument(..., help="Memory UUID to delete"),
     force: bool = typer.Option(False, "--force", "-f", help="Skip confirmation"),
+    project_id: str | None = typer.Option(
+        None, "--project-id", "-p", help="Project ID for campaign access",
+    ),
     json_output: bool = typer.Option(False, "--json", "-j", help="Output as JSON"),
 ):
     """Soft-delete a memory and its version chain."""
@@ -249,10 +287,11 @@ def delete(
             raise typer.Abort()
 
     client = _get_client()
+    _project_id = project_id or _get_project_id_default()
 
     async def _do():
         async with client:
-            return await client.delete(memory_id)
+            return await client.delete(memory_id, project_id=_project_id)
 
     result = _run(_do())
 
@@ -270,14 +309,21 @@ def delete(
 def history(
     memory_id: str = typer.Argument(..., help="Memory UUID"),
     max_versions: int = typer.Option(20, "--max", "-n", help="Maximum versions to show"),
+    project_id: str | None = typer.Option(
+        None, "--project-id", "-p", help="Project ID for campaign access",
+    ),
     json_output: bool = typer.Option(False, "--json", "-j", help="Output as JSON"),
 ):
     """Show version history for a memory."""
     client = _get_client()
+    _project_id = project_id or _get_project_id_default()
 
     async def _do():
         async with client:
-            return await client.get_history(memory_id, max_versions=max_versions)
+            return await client.get_history(
+                memory_id, max_versions=max_versions,
+                project_id=_project_id,
+            )
 
     result = _run(_do())
 

{memoryhub_cli-0.2.0 → memoryhub_cli-0.3.0}/tests/test_project_config.py

@@ -6,12 +6,11 @@ from pathlib import Path
 
 import pytest
 import yaml
-
 from memoryhub import (
     CONFIG_FILENAME,
-    ProjectConfig,
     load_project_config,
 )
+
 from memoryhub_cli.project_config import (
     GENERATED_RULE_NAME,
     LEGACY_RULE_NAME,
@@ -425,3 +424,89 @@ def test_rewrite_rule_file_does_not_touch_yaml(tmp_path: Path):
     # YAML untouched.
     assert yaml_path.stat().st_mtime == yaml_mtime_before
     assert "pattern: eager" in yaml_path.read_text()
+
+
+# ── CLI option wiring: project_id and domains ────────────────────────────
+
+
+def _strip_ansi(text: str) -> str:
+    """Remove ANSI escape codes from text for reliable assertions."""
+    import re
+
+    return re.sub(r"\x1b\[[0-9;]*m", "", text)
+
+
+def test_search_accepts_project_id_option():
+    """--project-id is recognized by the search command."""
+    from typer.testing import CliRunner
+
+    from memoryhub_cli.main import app
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["search", "--help"])
+    assert result.exit_code == 0
+    text = _strip_ansi(result.stdout)
+    assert "--project-id" in text, f"--project-id not in: {text}"
+
+
+def test_search_accepts_domain_option():
+    """--domain is recognized by the search command."""
+    from typer.testing import CliRunner
+
+    from memoryhub_cli.main import app
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["search", "--help"])
+    assert result.exit_code == 0
+    text = _strip_ansi(result.stdout)
+    assert "--domain" in text, f"--domain not in: {text}"
+
+
+def test_write_accepts_project_id_and_domain_options():
+    """--project-id and --domain are recognized by the write command."""
+    from typer.testing import CliRunner
+
+    from memoryhub_cli.main import app
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["write", "--help"])
+    assert result.exit_code == 0
+    text = _strip_ansi(result.stdout)
+    assert "--project-id" in text, f"--project-id not in: {text}"
+    assert "--domain" in text, f"--domain not in: {text}"
+
+
+def test_read_accepts_project_id_option():
+    from typer.testing import CliRunner
+
+    from memoryhub_cli.main import app
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["read", "--help"])
+    assert result.exit_code == 0
+    text = _strip_ansi(result.stdout)
+    assert "--project-id" in text, f"--project-id not in: {text}"
+
+
+def test_delete_accepts_project_id_option():
+    from typer.testing import CliRunner
+
+    from memoryhub_cli.main import app
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["delete", "--help"])
+    assert result.exit_code == 0
+    text = _strip_ansi(result.stdout)
+    assert "--project-id" in text, f"--project-id not in: {text}"
+
+
+def test_history_accepts_project_id_option():
+    from typer.testing import CliRunner
+
+    from memoryhub_cli.main import app
+
+    runner = CliRunner()
+    result = runner.invoke(app, ["history", "--help"])
+    assert result.exit_code == 0
+    text = _strip_ansi(result.stdout)
+    assert "--project-id" in text, f"--project-id not in: {text}"