palaia 2.4.dev2__tar.gz → 2.5__tar.gz

{palaia-2.4.dev2/palaia.egg-info → palaia-2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: palaia
-Version: 2.4.dev2
+Version: 2.5
 Summary: Local, cloud-free memory for OpenClaw agents.
 Author-email: byte5 GmbH <hello@byte5.de>
 License: MIT

{palaia-2.4.dev2 → palaia-2.5}/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: palaia
-version: "2.4.dev2"
+version: "2.5"
 description: >
   Local, crash-safe persistent memory for OpenClaw agents.
   SQLite-backed by default. Semantic search, projects, scopes, auto-capture.
@@ -25,17 +25,18 @@ metadata:
       - command: "python3 -m pip install --upgrade 'palaia[fastembed]' && (npm install -g @byte5ai/palaia@latest 2>/dev/null || true) && palaia doctor --fix && palaia warmup"
         label: "Upgrade Palaia with semantic search (pip + npm plugin) and run health checks"
     postUpdateMessage: >
-      Palaia has been updated to v2.2. New: SQLite default backend, injection priorities,
-      knowledge curation, ContextEngine integration. Run `palaia doctor --fix` to upgrade.
+      Palaia has been updated to v2.4. New: session continuity (automatic briefings and
+      summaries), privacy markers, recency boost, progressive disclosure. Run `palaia doctor --fix` to upgrade.
     plugin:
       slot: memory
       package: "@byte5ai/palaia"
 ---
 
-# Palaia v2.2 — Agent Memory Skill
+# Palaia v2.4 — Agent Memory Skill
 
 Palaia is the memory system for OpenClaw agents. It gives you persistent, searchable, crash-safe memory across sessions. You don't need to understand how it works — just use the commands below.
 
+<!-- begin:install -->
 ## First-Time Setup
 
 When a user asks you to "set up palaia", "enable memory", or "remember things across sessions", run these steps:
@@ -136,6 +137,7 @@ npm install -g @byte5ai/palaia@latest
 ```
 
 After the manual update, `palaia upgrade` will be available for future updates.
+<!-- end:install -->
 
 ## Auto-Check (run every time this skill is loaded)
 
@@ -290,6 +292,9 @@ palaia query "what's the rate limit"
 # Filter by type and status
 palaia query "tasks" --type task --status open
 
+# Filter by tags
+palaia query "session-summary" --tags session-summary
+
 # Search within a project
 palaia query "deploy steps" --project myapp
 
@@ -324,6 +329,9 @@ palaia list
 # Filter by tier, type, status
 palaia list --tier warm --type task --status open --priority high
 
+# Limit results
+palaia list --type task --status open --limit 5
+
 # Filter by project or assignee
 palaia list --project myapp --assignee Elliot
 ```
@@ -575,6 +583,66 @@ Distinguish sessions of the same agent:
 palaia instance set Claw-Main
 ```
 
+### Agent Isolation Mode
+
+For focused agents (Sonnet/Codex) that should only see their own memories:
+
+**1. Configure in `priorities.json`:**
+```json
+{
+  "agents": {
+    "dev-worker": {
+      "scopeVisibility": ["private"],
+      "captureScope": "private",
+      "maxInjectedChars": 2000,
+      "recallMinScore": 0.85
+    }
+  }
+}
+```
+Or via CLI:
+```bash
+palaia priorities set scopeVisibility private --agent dev-worker
+palaia priorities set captureScope private --agent dev-worker
+palaia priorities set maxInjectedChars 2000 --agent dev-worker
+palaia priorities set recallMinScore 0.85 --agent dev-worker
+```
+
+**2. Set agent identity:**
+```bash
+export PALAIA_AGENT=dev-worker
+```
+
+**3. Auto-capture stays on** (crash safety net). Cleanup happens after the work package.
+
+**4. After accepting work:**
+```bash
+palaia prune --agent dev-worker --tags auto-capture --protect-type process
+```
+This removes session noise while preserving learned SOPs.
+
+#### Pre-configured Agent Profiles
+
+| Profile | scopeVisibility | captureScope | maxInjectedChars | recallMinScore | autoCapture |
+|---------|----------------|--------------|-----------------|----------------|-------------|
+| **Isolated Worker** | `["private"]` | `private` | 2000 | 0.85 | true |
+| **Orchestrator** | `["private","team","public"]` | `team` | 4000 | 0.7 | true |
+| **Lean Worker** | `["private"]` | `private` | 1000 | 0.9 | false |
+
+#### Orchestrator Lifecycle (process template)
+
+Save this as a process entry for the orchestrator to recall:
+```bash
+palaia write "## Dev-Agent Lifecycle
+1. Create agent identity: export PALAIA_AGENT=dev-worker-{task-id}
+2. Configure isolation: palaia priorities set scopeVisibility private --agent dev-worker-{task-id}
+3. Configure capture: palaia priorities set captureScope private --agent dev-worker-{task-id}
+4. Assign work package via prompt
+5. After acceptance: palaia prune --agent dev-worker-{task-id} --tags auto-capture --protect-type process
+6. Verify: palaia list --agent dev-worker-{task-id} --type process
+7. Process knowledge persists for future tasks" --type process --tags workflow,orchestration --scope private
+```
+
 ---
 
 ## When to Use What
@@ -590,10 +658,11 @@ palaia instance set Claw-Main
 | Check system health | `palaia status` |
 | Something is wrong | `palaia doctor --fix` |
 | Clean up old entries | `palaia gc` |
+| Clean up agent session noise | `palaia prune --agent NAME --tags auto-capture --protect-type process` |
 | Review accumulated knowledge | `palaia curate analyze` |
 | Share knowledge | `palaia sync export` or `palaia package export` |
 | Check for messages | `palaia memo inbox` |
-| Start of session | `palaia doctor` then `palaia query "active work"` then `palaia memo inbox` |
+| Start of session | Session briefing is now automatic. Just run `palaia doctor` and check `palaia memo inbox`. |
 
 **Do NOT manually write:** facts, decisions, or preferences that came up in the current conversation. Auto-Capture handles these.
 
@@ -632,6 +701,33 @@ palaia init --capture-level <off|minimal|normal|aggressive>
 
 ---
 
+## Session Continuity (NEW in v2.4)
+
+Session continuity gives agents automatic context restoration across sessions. These features work out of the box with the OpenClaw plugin -- no manual setup needed.
+
+### Session Briefings
+On session start, Palaia automatically injects a briefing with the last session summary and any open tasks. This means agents resume work without needing to manually search for context.
+
+### Session Summaries
+When a session ends or resets, Palaia auto-saves a summary of what happened. These are stored as entries with the `session-summary` tag and can be queried:
+```bash
+palaia query "session-summary" --tags session-summary
+```
+
+### Privacy Markers
+Wrap sensitive content in `<private>...</private>` blocks to exclude it from auto-capture. Private blocks are stripped before any extraction runs.
+
+### Recency Boost
+Fresh memories are ranked higher in recall results. The boost factor is configurable via `recallRecencyBoost` (default `0.3`, set to `0` to disable).
+
+### Progressive Disclosure
+When result sets exceed 100 entries, Palaia uses compact mode to keep context manageable. Use `--limit` to control result size explicitly:
+```bash
+palaia list --type task --status open --limit 5
+```
+
+---
+
 ## Plugin Configuration (OpenClaw)
 
 Set in `openclaw.json` under `plugins.entries.palaia.config`:
@@ -649,6 +745,11 @@ Set in `openclaw.json` under `plugins.entries.palaia.config`:
 | `embeddingServer` | `true` | Keep embedding model loaded for fast queries |
 | `showMemorySources` | `true` | Show memory source footnotes |
 | `showCaptureConfirm` | `true` | Show capture confirmations |
+| `sessionSummary` | `true` | Auto-save session summaries on end/reset |
+| `sessionBriefing` | `true` | Load session context on session start |
+| `sessionBriefingMaxChars` | `1500` | Max chars for session briefing injection |
+| `captureToolObservations` | `true` | Track tool usage as session context |
+| `recallRecencyBoost` | `0.3` | Boost factor for fresh memories (0=off) |
 
 ---
 

{palaia-2.4.dev2 → palaia-2.5}/palaia/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: palaia
-version: "2.4.dev2"
+version: "2.5"
 description: >
   Local, crash-safe persistent memory for OpenClaw agents.
   SQLite-backed by default. Semantic search, projects, scopes, auto-capture.
@@ -25,17 +25,18 @@ metadata:
       - command: "python3 -m pip install --upgrade 'palaia[fastembed]' && (npm install -g @byte5ai/palaia@latest 2>/dev/null || true) && palaia doctor --fix && palaia warmup"
         label: "Upgrade Palaia with semantic search (pip + npm plugin) and run health checks"
     postUpdateMessage: >
-      Palaia has been updated to v2.2. New: SQLite default backend, injection priorities,
-      knowledge curation, ContextEngine integration. Run `palaia doctor --fix` to upgrade.
+      Palaia has been updated to v2.4. New: session continuity (automatic briefings and
+      summaries), privacy markers, recency boost, progressive disclosure. Run `palaia doctor --fix` to upgrade.
     plugin:
       slot: memory
       package: "@byte5ai/palaia"
 ---
 
-# Palaia v2.2 — Agent Memory Skill
+# Palaia v2.4 — Agent Memory Skill
 
 Palaia is the memory system for OpenClaw agents. It gives you persistent, searchable, crash-safe memory across sessions. You don't need to understand how it works — just use the commands below.
 
+<!-- begin:install -->
 ## First-Time Setup
 
 When a user asks you to "set up palaia", "enable memory", or "remember things across sessions", run these steps:
@@ -136,6 +137,7 @@ npm install -g @byte5ai/palaia@latest
 ```
 
 After the manual update, `palaia upgrade` will be available for future updates.
+<!-- end:install -->
 
 ## Auto-Check (run every time this skill is loaded)
 
@@ -290,6 +292,9 @@ palaia query "what's the rate limit"
 # Filter by type and status
 palaia query "tasks" --type task --status open
 
+# Filter by tags
+palaia query "session-summary" --tags session-summary
+
 # Search within a project
 palaia query "deploy steps" --project myapp
 
@@ -324,6 +329,9 @@ palaia list
 # Filter by tier, type, status
 palaia list --tier warm --type task --status open --priority high
 
+# Limit results
+palaia list --type task --status open --limit 5
+
 # Filter by project or assignee
 palaia list --project myapp --assignee Elliot
 ```
@@ -575,6 +583,66 @@ Distinguish sessions of the same agent:
 palaia instance set Claw-Main
 ```
 
+### Agent Isolation Mode
+
+For focused agents (Sonnet/Codex) that should only see their own memories:
+
+**1. Configure in `priorities.json`:**
+```json
+{
+  "agents": {
+    "dev-worker": {
+      "scopeVisibility": ["private"],
+      "captureScope": "private",
+      "maxInjectedChars": 2000,
+      "recallMinScore": 0.85
+    }
+  }
+}
+```
+Or via CLI:
+```bash
+palaia priorities set scopeVisibility private --agent dev-worker
+palaia priorities set captureScope private --agent dev-worker
+palaia priorities set maxInjectedChars 2000 --agent dev-worker
+palaia priorities set recallMinScore 0.85 --agent dev-worker
+```
+
+**2. Set agent identity:**
+```bash
+export PALAIA_AGENT=dev-worker
+```
+
+**3. Auto-capture stays on** (crash safety net). Cleanup happens after the work package.
+
+**4. After accepting work:**
+```bash
+palaia prune --agent dev-worker --tags auto-capture --protect-type process
+```
+This removes session noise while preserving learned SOPs.
+
+#### Pre-configured Agent Profiles
+
+| Profile | scopeVisibility | captureScope | maxInjectedChars | recallMinScore | autoCapture |
+|---------|----------------|--------------|-----------------|----------------|-------------|
+| **Isolated Worker** | `["private"]` | `private` | 2000 | 0.85 | true |
+| **Orchestrator** | `["private","team","public"]` | `team` | 4000 | 0.7 | true |
+| **Lean Worker** | `["private"]` | `private` | 1000 | 0.9 | false |
+
+#### Orchestrator Lifecycle (process template)
+
+Save this as a process entry for the orchestrator to recall:
+```bash
+palaia write "## Dev-Agent Lifecycle
+1. Create agent identity: export PALAIA_AGENT=dev-worker-{task-id}
+2. Configure isolation: palaia priorities set scopeVisibility private --agent dev-worker-{task-id}
+3. Configure capture: palaia priorities set captureScope private --agent dev-worker-{task-id}
+4. Assign work package via prompt
+5. After acceptance: palaia prune --agent dev-worker-{task-id} --tags auto-capture --protect-type process
+6. Verify: palaia list --agent dev-worker-{task-id} --type process
+7. Process knowledge persists for future tasks" --type process --tags workflow,orchestration --scope private
+```
+
 ---
 
 ## When to Use What
@@ -590,10 +658,11 @@ palaia instance set Claw-Main
 | Check system health | `palaia status` |
 | Something is wrong | `palaia doctor --fix` |
 | Clean up old entries | `palaia gc` |
+| Clean up agent session noise | `palaia prune --agent NAME --tags auto-capture --protect-type process` |
 | Review accumulated knowledge | `palaia curate analyze` |
 | Share knowledge | `palaia sync export` or `palaia package export` |
 | Check for messages | `palaia memo inbox` |
-| Start of session | `palaia doctor` then `palaia query "active work"` then `palaia memo inbox` |
+| Start of session | Session briefing is now automatic. Just run `palaia doctor` and check `palaia memo inbox`. |
 
 **Do NOT manually write:** facts, decisions, or preferences that came up in the current conversation. Auto-Capture handles these.
 
@@ -632,6 +701,33 @@ palaia init --capture-level <off|minimal|normal|aggressive>
 
 ---
 
+## Session Continuity (NEW in v2.4)
+
+Session continuity gives agents automatic context restoration across sessions. These features work out of the box with the OpenClaw plugin -- no manual setup needed.
+
+### Session Briefings
+On session start, Palaia automatically injects a briefing with the last session summary and any open tasks. This means agents resume work without needing to manually search for context.
+
+### Session Summaries
+When a session ends or resets, Palaia auto-saves a summary of what happened. These are stored as entries with the `session-summary` tag and can be queried:
+```bash
+palaia query "session-summary" --tags session-summary
+```
+
+### Privacy Markers
+Wrap sensitive content in `<private>...</private>` blocks to exclude it from auto-capture. Private blocks are stripped before any extraction runs.
+
+### Recency Boost
+Fresh memories are ranked higher in recall results. The boost factor is configurable via `recallRecencyBoost` (default `0.3`, set to `0` to disable).
+
+### Progressive Disclosure
+When result sets exceed 100 entries, Palaia uses compact mode to keep context manageable. Use `--limit` to control result size explicitly:
+```bash
+palaia list --type task --status open --limit 5
+```
+
+---
+
 ## Plugin Configuration (OpenClaw)
 
 Set in `openclaw.json` under `plugins.entries.palaia.config`:
@@ -649,6 +745,11 @@ Set in `openclaw.json` under `plugins.entries.palaia.config`:
 | `embeddingServer` | `true` | Keep embedding model loaded for fast queries |
 | `showMemorySources` | `true` | Show memory source footnotes |
 | `showCaptureConfirm` | `true` | Show capture confirmations |
+| `sessionSummary` | `true` | Auto-save session summaries on end/reset |
+| `sessionBriefing` | `true` | Load session context on session start |
+| `sessionBriefingMaxChars` | `1500` | Max chars for session briefing injection |
+| `captureToolObservations` | `true` | Track tool usage as session context |
+| `recallRecencyBoost` | `0.3` | Boost factor for fresh memories (0=off) |
 
 ---
 

{palaia-2.4.dev2 → palaia-2.5}/palaia/__init__.py

@@ -4,5 +4,5 @@ Palaia — Local, cloud-free memory for OpenClaw agents.
 
 from __future__ import annotations
 
-__version__ = "2.4.dev2"
+__version__ = "2.5"
 __author__ = "byte5 GmbH"

{palaia-2.4.dev2 → palaia-2.5}/palaia/backends/migrate.py

@@ -51,7 +51,13 @@ def _should_rename(error_count: int, total_count: int) -> bool:
 
 
 def needs_migration(palaia_root: Path) -> bool:
-    """Check if there are flat-file indexes that should be migrated."""
+    """Check if there are flat-file indexes that should be migrated.
+
+    Detects three scenarios:
+    1. Old-style metadata.json / embeddings.json exist (pre-SQLite migration)
+    2. WAL JSON files exist
+    3. Entries on disk but 0 in the database (e.g. backup restore into hot/)
+    """
     metadata_json = palaia_root / "index" / "metadata.json"
     embeddings_json = palaia_root / "index" / "embeddings.json"
     wal_dir = palaia_root / "wal"
@@ -59,7 +65,37 @@ def needs_migration(palaia_root: Path) -> bool:
     has_json = metadata_json.exists() or embeddings_json.exists()
     has_wal_files = wal_dir.exists() and any(wal_dir.glob("*.json"))
 
-    return has_json or has_wal_files
+    if has_json or has_wal_files:
+        return True
+
+    # Scenario 3: Disk entries exist but DB is empty (backup restore)
+    disk_count = 0
+    for tier in ("hot", "warm", "cold"):
+        tier_dir = palaia_root / tier
+        if tier_dir.exists():
+            try:
+                disk_count += sum(1 for _ in tier_dir.glob("*.md"))
+            except (PermissionError, OSError):
+                pass
+        if disk_count > 0:
+            break  # At least one entry found, check DB
+
+    if disk_count > 0:
+        import sqlite3
+
+        db_path = palaia_root / "palaia.db"
+        if db_path.exists():
+            try:
+                conn = sqlite3.connect(str(db_path))
+                row = conn.execute("SELECT COUNT(*) FROM entries").fetchone()
+                db_count = row[0] if row else 0
+                conn.close()
+                if db_count == 0:
+                    return True
+            except Exception:
+                pass
+
+    return False
 
 
 def migrate_to_backend(palaia_root: Path, backend: object) -> MigrationResult:

{palaia-2.4.dev2 → palaia-2.5}/palaia/cli.py

@@ -49,7 +49,17 @@ from palaia.config import (  # noqa: E402
 from palaia.doctor import apply_fixes, format_doctor_report, run_doctor  # noqa: E402
 from palaia.migrate import format_result, migrate  # noqa: E402
 from palaia.store import Store  # noqa: E402
-from palaia.ui import print_header, section, table_multi  # noqa: E402
+from palaia.ui import (  # noqa: E402
+    bold,
+    dim,
+    error_msg,
+    print_header,
+    section,
+    success,
+    sym_arrow,
+    table_multi,
+)
+
 
 # Commands that require a valid init (agent identity set)
 GATED_COMMANDS = frozenset(
@@ -60,6 +70,7 @@ GATED_COMMANDS = frozenset(
         "edit",
         "memo",
         "gc",
+        "prune",
         "export",
         "import",
         "ingest",
@@ -178,9 +189,9 @@ def cmd_init(args):
             args,
         ):
             return 0
-        print(f"Initialized Palaia at {result['path']}")
+        print(success(f"Initialized at {dim(result['path'])}"))
         if result.get("used_default"):
-            print("Initialized with agent: default (use --agent NAME to customize)")
+            print(f"    Agent: default {dim('(use --agent NAME to customize)')}")
 
     # Print all messages from service (chain info, capture level, setup instructions)
     if not getattr(args, "json", False):
@@ -243,7 +254,10 @@ def cmd_write(args):
     ):
         return 0
 
-    print(f"Written: {result['id']}")
+    short_id = result['id'][:12]
+    scope = result.get('scope', 'team')
+    tier = result.get('tier', 'hot')
+    print(success(f"Written {dim(short_id)}  {sym_arrow()}  {tier}/{scope}"))
 
     if significance_detected:
         tags_str = ", ".join(significance_detected)
@@ -294,7 +308,7 @@ def cmd_edit(args):
     if _json_out(result, args):
         return 0
 
-    print(f"Updated: {result['id']}")
+    print(success(f"Updated {dim(result['id'][:12])}"))
     changes = []
     if body is not None:
         changes.append("content")
@@ -304,7 +318,7 @@ def cmd_edit(args):
         if getattr(args, field, None) is not None:
             changes.append(field)
     if changes:
-        print(f"  Changed: {', '.join(changes)}")
+        print(f"    Changed: {', '.join(changes)}")
     return 0
 
 
@@ -506,17 +520,68 @@ def cmd_gc(args):
 
     skip_keys = {"wal_cleaned", "pruned", "pruned_entries"}
     total_moves = sum(v for k, v in result.items() if k not in skip_keys and isinstance(v, int))
-    print("GC complete.")
     if total_moves:
+        print(success("GC complete"))
         for k, v in result.items():
             if v and k not in skip_keys and isinstance(v, int):
-                print(f"  {k}: {v}")
+                print(f"    {k}: {v}")
     else:
-        print("  No tier changes needed.")
+        print(success("GC complete — no tier changes needed"))
     if result.get("wal_cleaned"):
-        print(f"  WAL cleaned: {result['wal_cleaned']} old entries")
+        print(f"    WAL cleaned: {result['wal_cleaned']} old entries")
     if result.get("pruned"):
-        print(f"  Pruned (budget): {result['pruned']} entries")
+        print(f"    Pruned (budget): {result['pruned']} entries")
+    return 0
+
+
+def cmd_prune(args):
+    """Selectively delete entries by agent + tags."""
+    from palaia.services.admin import run_prune
+
+    root = get_root()
+    agent = args.agent
+    tags = [t.strip() for t in args.tags.split(",") if t.strip()]
+    protect_types = None
+    if args.protect_type:
+        protect_types = [t.strip() for t in args.protect_type.split(",") if t.strip()]
+    dry_run = getattr(args, "dry_run", False)
+
+    result = run_prune(root, agent=agent, tags=tags, protect_types=protect_types, dry_run=dry_run)
+
+    if _json_out(result, args):
+        return 0
+
+    entries = result.get("entries", [])
+    count = result.get("pruned", 0)
+
+    if count == 0:
+        print("No matching entries found.")
+        return 0
+
+    if dry_run:
+        rows = [(e["id"], e["title"][:30], e["type"], e["tier"], ",".join(e.get("tags", []))) for e in entries]
+        print(
+            table_multi(
+                headers=("ID", "Title", "Type", "Tier", "Tags"),
+                rows=rows,
+                min_widths=(8, 30, 8, 4, 15),
+            )
+        )
+        print(f"\n{count} entries would be deleted (dry-run).")
+    else:
+        print(f"Pruned {count} entries for agent '{agent}'.")
+        for e in entries:
+            print(f"  {e['id']}  {e['title'][:40]}")
+
+        # Record prune success for prune_reminder graduation (#148)
+        try:
+            from palaia.nudge import NudgeTracker
+            caller = os.environ.get("PALAIA_AGENT") or "default"
+            tracker = NudgeTracker(root)
+            tracker.record_success("prune_reminder", caller)
+        except Exception:
+            pass
+
     return 0
 
 
@@ -541,9 +606,9 @@ def cmd_doctor(args):
     print(format_doctor_report(results, show_fix=show_fix))
 
     if fix_actions:
-        print("\nFixes applied:")
+        print(f"\n  {bold('Fixes applied:')}")
         for action in fix_actions:
-            print(f"  [ok] {action}")
+            print(success(action))
         print()
 
     return 0
@@ -742,17 +807,18 @@ def cmd_setup(args):
 
     # Print action details
     if not getattr(args, "json", False):
+        from palaia.ui import status_label
         for action in result.get("actions", []):
             label = action["action"]
             agent = action["agent"]
             if label == "skip":
-                print(f"  [skip] {agent}: {action.get('reason', '')}")
+                print(f"  {status_label('skip')}  {agent}: {dim(action.get('reason', ''))}")
             elif label == "plan":
-                print(f"  [plan] {agent}: would create .palaia -> {action.get('target', '')}")
+                print(f"  {status_label('info')}  {agent}: would create .palaia {sym_arrow()} {action.get('target', '')}")
             elif label == "ok":
-                print(f"  [ok] {agent}: .palaia -> {action.get('target', '')}")
+                print(success(f"{agent}: .palaia {sym_arrow()} {action.get('target', '')}"))
             elif label == "error":
-                print(f"  [error] {agent}: {action.get('error', '')}")
+                print(error_msg(f"{agent}: {action.get('error', '')}"))
 
     if _json_out(
         {
@@ -1372,6 +1438,7 @@ def main():
         "list": cmd_list,
         "status": cmd_status,
         "gc": cmd_gc,
+        "prune": cmd_prune,
         "setup": cmd_setup,
         "doctor": cmd_doctor,
         "export": cmd_export,

{palaia-2.4.dev2 → palaia-2.5}/palaia/cli_args.py

@@ -169,6 +169,14 @@ def build_parser() -> argparse.ArgumentParser:
     p_gc.add_argument("--budget", action="store_true", help="Prune entries to meet configured budget limits")
     p_gc.add_argument("--json", action="store_true", help="Output as JSON")
 
+    # prune
+    p_prune = sub.add_parser("prune", help="Selectively delete entries by agent + tags")
+    p_prune.add_argument("--agent", required=True, help="Agent name to prune entries for (required)")
+    p_prune.add_argument("--tags", required=True, help="Comma-separated tags to match (required, e.g. auto-capture)")
+    p_prune.add_argument("--protect-type", default=None, help="Comma-separated types to preserve (e.g. process,task)")
+    p_prune.add_argument("--dry-run", action="store_true", help="Show what would be deleted without changing anything")
+    p_prune.add_argument("--json", action="store_true", help="Output as JSON")
+
     # project
     _add_project_subparser(sub)