deepvista-cli 0.1.18__tar.gz → 0.2.0__tar.gz

deepvista_cli-0.2.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.2.0"
+}

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/CHANGELOG.md

@@ -37,6 +37,14 @@ users what's new between the version they have installed and the latest release.
   adopts a pre-existing server-side row instead of failing when the local
   file is missing.
 
+## [0.2.0](https://github.com/DeepVista-AI/deepvista-cli/compare/v0.1.18...v0.2.0) (2026-05-28)
+
+
+### Features
+
+* **DV-853:** productionize the deepvista subagents ([#147](https://github.com/DeepVista-AI/deepvista-cli/issues/147)) ([45e9ba1](https://github.com/DeepVista-AI/deepvista-cli/commit/45e9ba17de08243fe84be3de6826c72116360351))
+* **session:** skip session init for configured CWD patterns (DV-862) ([#148](https://github.com/DeepVista-AI/deepvista-cli/issues/148)) ([df74381](https://github.com/DeepVista-AI/deepvista-cli/commit/df743810ae6dec7c4a520c43d82f1eeae421762b))
+
 ## [0.1.18](https://github.com/DeepVista-AI/deepvista-cli/compare/v0.1.17...v0.1.18) (2026-05-28)
 
 

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepvista-cli
-Version: 0.1.18
+Version: 0.2.0
 Summary: CLI for DeepVista — chat, notes, skills, and memory from your terminal.
 Project-URL: Homepage, https://deepvista.ai
 Project-URL: Repository, https://github.com/DeepVista-AI/deepvista-cli

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/deepvista_cli/agent_catalog.py

@@ -105,7 +105,12 @@ class AgentRoleMeta:
     agent_type: str = ""  # e.g. "claude-code"
     updated_at: str = ""
     count: int = 1  # how many managed agents share this role
-    system_prompt: str = ""  # custom prompt from the agent's config.soul (DV-836); baked as the body
+    # Plain-text system prompt baked verbatim as the subagent body. Sourced
+    # from the managed agent's ``config.system_prompt`` (preferred) or its
+    # older ``config.soul`` (fallback). Persona-skill references are NOT
+    # resolved at export time — the prompt should instruct the agent to load
+    # the persona itself (e.g. "follow persona context card xxxx").
+    system_prompt: str = ""
 
     @property
     def slug(self) -> str:
@@ -207,14 +212,17 @@ def build_agent_markdown(meta: AgentRoleMeta) -> str:
         frontmatter.append(f"x-deepvista-updated-at: {meta.updated_at}")
     frontmatter.append("---")
 
-    # A custom system prompt (config.soul) is authoritative — bake it in as the body
-    # verbatim. Frontmatter (routing, tools, model, preloaded skill) stays templated.
+    # A custom system prompt (config.system_prompt, falling back to config.soul)
+    # is authoritative — bake it in as the body verbatim. Frontmatter (routing,
+    # tools, model, preloaded skill) stays templated. The prompt itself is the
+    # right place to reference a persona context card by id ("…follow persona
+    # context card xxxx"); the agent loads it at runtime via the deepvista skill.
     if meta.system_prompt.strip():
         prompt_body = (
-            "<!-- Generated by `deepvista agents export` from the configured system prompt\n"
-            f"     (config.soul) of your “{meta.agent_name}” managed agent · role: {meta.role}\n"
-            f"     · agent id: {meta.agent_id or 'n/a'}. Edit it in DeepVista — local changes\n"
-            "     are overwritten on the next sync. -->\n\n"
+            "<!-- Generated by `deepvista agents export` from the configured system\n"
+            f"     prompt of your “{meta.agent_name}” managed agent · role: {meta.role}\n"
+            f"     · agent id: {meta.agent_id or 'n/a'}. Edit it in DeepVista — local\n"
+            "     changes are overwritten on the next sync. -->\n\n"
             f"{meta.system_prompt.strip()}\n"
         )
         return "\n".join(frontmatter) + "\n\n" + prompt_body
@@ -290,7 +298,12 @@ def metas_from_agents(agents: list[dict[str, Any]]) -> list[AgentRoleMeta]:
             continue
         updated = str(agent.get("updated_at") or "")
         config = agent.get("config") or {}
-        soul = str(config.get("soul") or "").strip()
+        # DV-853: ``config.system_prompt`` is the public field for the
+        # subagent body. Falls back to the legacy ``config.soul`` so existing
+        # managed agents keep working unchanged. Plain text; persona-card
+        # references are left to the prompt's wording (the agent loads them
+        # at runtime via the preloaded `deepvista` skill).
+        prompt_body = str(config.get("system_prompt") or config.get("soul") or "").strip()
         candidate = AgentRoleMeta(
             role=raw_role,
             agent_name=str(agent.get("name") or ""),
@@ -298,7 +311,7 @@ def metas_from_agents(agents: list[dict[str, Any]]) -> list[AgentRoleMeta]:
             agent_type=str(agent.get("agent_type") or ""),
             updated_at=updated,
             count=1,
-            system_prompt=soul,
+            system_prompt=prompt_body,
         )
         existing = by_role.get(slug)
         if existing is None:

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/deepvista_cli/commands/session.py

@@ -23,6 +23,7 @@ import click
 from deepvista_cli import session_note as sn
 from deepvista_cli.client.http import DeepVistaClient
 from deepvista_cli.client.origin import detect_agent_tool
+from deepvista_cli.config import should_skip_session_cwd
 from deepvista_cli.output.formatter import format_output, output_error
 
 SESSION_CARD_TYPE = "session"
@@ -116,6 +117,29 @@ def session_init(
     """
     from deepvista_cli.commands.agents import load_agent_id_for_active_agent
 
+    if should_skip_session_cwd(cwd):
+        # DV-862: CWD matches ``session_skip_cwd_patterns`` in
+        # ``~/.config/deepvista/config.json``. Drops sub-agent sessions
+        # whose CWD isn't a real working directory — e.g. claude-mem's
+        # observer sub-claude runs with
+        # ``cwd=~/.claude-mem/observer-sessions`` and quotes file paths
+        # from the *primary* session, polluting the vistabase. Downstream
+        # ``tick`` / ``finalize`` self-no-op (no cached card → exit 3) so
+        # guarding ``init`` alone covers the whole lifecycle.
+        format_output(
+            {
+                "skipped": True,
+                "reason": "cwd matches session_skip_cwd_patterns",
+                "cwd": cwd,
+                "session_id": session_id,
+            },
+            ctx.obj.output_format,
+            title="Session init (skipped)",
+            entity_type=SESSION_ENTITY_TYPE,
+            base_url=ctx.obj.auth_url,
+        )
+        return
+
     if agent is None:
         detected_agent, detected_version = detect_agent_tool()
         agent = detected_agent

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/deepvista_cli/config.py

@@ -8,6 +8,7 @@ Resolution order for each setting:
 
 from __future__ import annotations
 
+import fnmatch
 import json
 import os
 from dataclasses import dataclass
@@ -36,6 +37,21 @@ def credentials_path(profile: str = "default") -> Path:
 
 PROFILES_PATH = CONFIG_DIR / "config.json"
 
+# Reserved top-level key in ``config.json`` holding the list of CWD globs
+# that ``deepvista session init`` should skip. Stored as a flat list (not a
+# dict) so it's trivially distinguishable from profile entries and easy for
+# the user to hand-edit. See DV-862.
+SESSION_SKIP_CWD_KEY = "session_skip_cwd_patterns"
+
+# Defaults used when ``config.json`` is missing the key. Skips claude-mem's
+# observer sub-claude (cwd=~/.claude-mem/observer-sessions) so its quoted
+# file paths from the *primary* session don't get mined into bogus File
+# cards (root cause for DV-861).
+DEFAULT_SESSION_SKIP_CWD_PATTERNS: tuple[str, ...] = (
+    "*/.claude-mem/observer-sessions",
+    "*/.claude-mem/observer-sessions/*",
+)
+
 
 # ---------------------------------------------------------------------------
 # Exit codes (following GWS pattern)
@@ -84,8 +100,13 @@ def set_profile(name: str, settings: dict) -> None:
 
 
 def list_profiles() -> dict:
-    """List all profiles."""
-    return _load_profiles()
+    """List all profiles.
+
+    Filters out reserved non-profile keys (e.g.
+    ``session_skip_cwd_patterns``) by keeping only dict-valued entries —
+    profiles are always dicts, reserved settings are lists/scalars.
+    """
+    return {k: v for k, v in _load_profiles().items() if isinstance(v, dict)}
 
 
 def delete_profile(name: str) -> bool:
@@ -98,6 +119,40 @@ def delete_profile(name: str) -> bool:
     return False
 
 
+# ---------------------------------------------------------------------------
+# Session CWD skip patterns (DV-862)
+# ---------------------------------------------------------------------------
+
+
+def get_session_skip_cwd_patterns() -> list[str]:
+    """Return the configured CWD-skip patterns for ``session init``.
+
+    Reads a top-level ``session_skip_cwd_patterns`` list from
+    ``~/.config/deepvista/config.json``. There is no matching setter — edit
+    the file by hand. Falls back to ``DEFAULT_SESSION_SKIP_CWD_PATTERNS``
+    when the key is absent. An explicit empty list disables skipping.
+    """
+    raw = _load_profiles().get(SESSION_SKIP_CWD_KEY)
+    if isinstance(raw, list):
+        return [str(p) for p in raw]
+    return list(DEFAULT_SESSION_SKIP_CWD_PATTERNS)
+
+
+def should_skip_session_cwd(cwd: str | None) -> bool:
+    """Return True iff ``cwd`` matches any configured skip pattern.
+
+    Matching is fnmatch-style (Unix shell globs; ``*`` matches across path
+    separators). The hook payload's ``cwd`` is already absolute on every
+    supported agent, so no resolution is performed here.
+    """
+    if not cwd:
+        return False
+    for pattern in get_session_skip_cwd_patterns():
+        if fnmatch.fnmatchcase(cwd, pattern):
+            return True
+    return False
+
+
 # ---------------------------------------------------------------------------
 # Runtime config — resolved once per invocation
 # ---------------------------------------------------------------------------

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/plugins/claude-code/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "deepvista",
-  "version": "0.1.18",
+  "version": "0.2.0",
   "description": "Remote-managed skill catalog from DeepVista. Auto-syncs thin stubs into the plugin's skills dir on SessionStart; full bodies are lazy-loaded at invocation time.",
   "author": {
     "name": "DeepVista AI",

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/plugins/claude-code/README.md

@@ -78,6 +78,7 @@ Tunable via environment variables (read by the `SessionStart` hook):
 | `${CLAUDE_PLUGIN_ROOT}/agents/dv-<role>.md` | Generated subagent (one per managed-agent role) |
 | `~/.config/deepvista/catalog-state.json` | Last skill-sync timestamp + stub inventory |
 | `~/.config/deepvista/agent-defs-state.json` | Last agent-export timestamp + definition inventory |
+| `~/.config/deepvista/config.json` | CLI profiles + top-level `session_skip_cwd_patterns` list |
 | `~/.config/deepvista/cache/skill-bodies/` | 5-minute TTL cache of fetched bodies |
 | `~/.config/deepvista/logs/catalog-sync.log` | Skill-sync hook stdout/stderr |
 | `~/.config/deepvista/logs/agent-export.log` | Agent-export hook stdout/stderr |
@@ -102,6 +103,24 @@ DEEPVISTA_FORCE_SYNC=1 deepvista skill sync --force
 deepvista agents export --force
 ```
 
+Nested observer/sub-agent sessions showing up in the vistabase (e.g.
+`observer-sessions · <hash>` notes from claude-mem's observer sub-claude)?
+The plugin's SessionStart hook now skips CWDs matching the top-level
+`session_skip_cwd_patterns` list in `~/.config/deepvista/config.json`.
+Defaults cover `~/.claude-mem/observer-sessions`; to extend, edit the file
+and add patterns (fnmatch-style globs):
+
+```jsonc
+{
+  "default": { "api_url": "https://api.deepvista.ai" },
+  "session_skip_cwd_patterns": [
+    "*/.claude-mem/observer-sessions",
+    "*/.claude-mem/observer-sessions/*",
+    "*/scratchpad/*"
+  ]
+}
+```
+
 No agents showing up as `@<role>`? Confirm you have managed agents with roles:
 
 ```

deepvista_cli-0.2.0/plugins/claude-code/commands/deepvista.md

@@ -0,0 +1,129 @@
+---
+description: DeepVista controls — `run` generates + dispatches today's planning note via the daily-planning skill; no args shows help
+argument-hint: "[run]"
+---
+
+DeepVista control surface. Behaviour depends on `$ARGUMENTS`:
+
+- **No argument** (or any value other than `run`) → print the help block below.
+- **`run`** → generate today's *Daily Planning* note via the `daily-planning`
+  skill (if one doesn't already exist), dispatch each `## <role>` section to
+  its matching `@<role>` subagent, and append a consolidated summary back
+  onto the note.
+
+Planning notes are stored as regular DeepVista notes (`type=note`) tagged
+``daily-planning`` + ``date:YYYYMMDD``. No dedicated `deepvista planning`
+CLI command exists — read/write everything via `deepvista notes` and
+`deepvista card +search`.
+
+---
+
+## If `$ARGUMENTS` is empty or not `run`
+
+Print this verbatim, then stop:
+
+> **DeepVista — Claude Code commands**
+>
+> - `/deepvista run` — generate today's *Daily Planning* note (LLM-reasoned,
+>   driven by the `daily-planning` skill: yesterday's progress + last 7 days
+>   of cards → per-role tasks), then dispatch each `## <role>` section to
+>   the matching `@<role>` subagent. Subagent results are appended back to
+>   the planning note under a `## Summary — <timestamp>` block.
+> - `/refresh-skills` — resync the DeepVista skill catalog and agent
+>   definitions immediately (bypasses the 60-minute throttle).
+>
+> **Tips**
+>
+> - Want to draft a plan without dispatching? Just say *"draft today's
+>   planning note"* and the `daily-planning` skill kicks in.
+> - Personalise a subagent's voice by setting `config.system_prompt` on its
+>   managed agent (free text, e.g. *"You are the marketing specialist;
+>   follow persona context card persona-mkt-001."*) and re-running
+>   `/refresh-skills`. The agent loads the persona card at runtime.
+> - Need help with the CLI itself? `deepvista --help` or `deepvista <group> --help`.
+
+## If `$ARGUMENTS` is `run`
+
+Execute the daily-planning dispatch workflow.
+
+### Step 1 — Find today's planning note (or generate one)
+
+```bash
+TODAY=$(date +%Y%m%d)
+deepvista --format json card +search "Daily Planning $TODAY" --limit 5
+```
+
+Walk the result and pick the card with both ``daily-planning`` and
+``date:$TODAY`` in `tags`. Two cases:
+
+- **No match** → today's note doesn't exist. **Load the `daily-planning`
+  skill and follow it end-to-end** to produce today's plan. The skill ends
+  by saving the note via `deepvista notes create`. Re-run the search above
+  to pick up the new note id.
+
+- **Match found** → fetch its full body:
+  ```bash
+  deepvista --format json notes get <note-id>
+  ```
+
+Parse `description` and split on `## ` headings. Treat headings that match
+``Workflow today`` or ``Summary`` (case-insensitive) as reserved; everything
+else is a role section keyed by its heading text (lowercased).
+
+### Step 2 — Dispatch each role section to its subagent
+
+For each `(role, section_markdown)` in the role sections, invoke the
+matching subagent inline. Skip any role with no on-disk `dv-<role>.md`
+definition — the user hasn't registered a managed agent for it yet.
+Example body:
+
+```
+@<role>
+
+You are dispatched from today's Daily Planning note (id: <note_id>).
+
+Your section reads:
+
+<section_markdown>
+
+Complete it end-to-end. Return your deliverable in the standard subagent
+output format (Frame → Deliverable → Sources → Captured).
+```
+
+Collect each subagent's full reply.
+
+### Step 3 — Append a consolidated summary to the note
+
+Build a single markdown block:
+
+```
+## Summary — <YYYY-MM-DD HH:MM>
+
+### @marketing
+<that subagent's reply>
+
+### @engineering
+<that subagent's reply>
+
+…
+```
+
+Read the current body, append the block, write it back:
+
+```bash
+deepvista --format json notes get <note-id>
+# Capture description from JSON, append the block, then:
+deepvista notes update <note-id> --content-file -
+# (pass `description + appended_block` on stdin)
+```
+
+### Step 4 — Report
+
+Tell the user, in two lines:
+
+- Whether the plan was generated this run (and via which skill), or pulled
+  from an existing note.
+- Roles dispatched (and any skipped because no matching subagent existed),
+  plus the planning note URL (`https://app.deepvista.ai/notes/<id>`).
+
+If any step fails, stop and surface the error — do not silently fall through.

deepvista_cli-0.2.0/plugins/claude-code/skills/daily-planning/SKILL.md

@@ -0,0 +1,161 @@
+---
+name: daily-planning
+description: |
+  Generate today's *Daily Planning* note by reading yesterday's plan (and its
+  appended progress summary) along with recent context cards from the last 7
+  days — then reason about what carries over, what's new, and what each
+  registered `@<role>` managed-agent subagent should own today. Save the
+  result as a regular DeepVista note tagged ``daily-planning`` +
+  ``date:YYYYMMDD``. Use when the user runs `/deepvista run` and today's
+  planning note doesn't yet exist, or when the user asks to "draft today's
+  plan", "make today's standup", or "regenerate my daily planning note".
+---
+
+# Daily planning — generate today's plan from yesterday's context
+
+This skill produces today's *Daily Planning* note as an LLM-reasoned plan,
+not a static template. Planning notes are plain `deepvista notes` cards
+(type=note) tagged ``daily-planning`` + ``date:YYYYMMDD`` — there is no
+dedicated `deepvista planning` subcommand. The flow:
+
+1. Read **yesterday's** planning note + appended summary (if it exists).
+2. Read the **last 7 days** of context cards (notes, todos, sessions).
+3. List the **`@<role>` subagents** registered for this user.
+4. Reason about carry-over, new tasks, and blockers.
+5. Save the result as a note via `deepvista notes create`.
+
+The CLI does the data lookups; this skill is the reasoning runbook.
+
+## Step 1 — Read yesterday's plan
+
+Search for yesterday's planning note by tag (titles can be edited; tags
+shouldn't). Hybrid search filtered to `type=note` is the most robust:
+
+```bash
+YESTERDAY=$(date -v-1d +%Y%m%d 2>/dev/null || date -d 'yesterday' +%Y%m%d)
+TODAY=$(date +%Y%m%d)
+
+deepvista --format json card +search "Daily Planning $YESTERDAY" --limit 5
+# If a match is found, fetch its full body:
+# deepvista --format json notes get <id>
+```
+
+Parse `description` (yesterday's full markdown — plan + any
+`## Summary — <timestamp>` blocks that `/deepvista run` appended after
+subagents finished). If nothing matches, treat yesterday as a clean slate.
+
+## Step 2 — Read the last 7 days of context cards
+
+Each call is bounded (`--limit 20`). Skip silently on failure.
+
+```bash
+deepvista --format json notes list --limit 20
+deepvista --format json card list --type todo  --limit 20
+deepvista --format json card list --type session --limit 10
+deepvista --format json card +search "progress OR blocker OR shipped OR next" --limit 10
+```
+
+For each result, keep only items updated in the last 7 days. Extract:
+
+- title
+- last-updated date
+- a one-sentence read of what it implies for today
+
+## Step 3 — List the registered `@<role>` subagents
+
+```bash
+ls "${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/deepvista}/agents/" 2>/dev/null \
+  | grep -E '^dv-.*\.md$' \
+  | sed 's/^dv-//; s/\.md$//'
+```
+
+If the list is empty, default to `marketing,engineering,gtm`. The user can
+register more via `deepvista agents register`.
+
+## Step 4 — Reason about today's plan
+
+You now have:
+
+- Yesterday's plan + appended summaries (assigned vs. shipped).
+- A 7-day rolling window of notes/todos/sessions (the *why* behind today).
+- The list of available `@<role>` subagents (the *who* of today).
+
+Produce markdown that:
+
+1. **Opens with a 2-3 sentence preamble** restating the week's arc — what's
+   in progress, what shipped yesterday, what's next.
+2. **`## Workflow today`** — a short bulleted list of cross-cutting work the
+   *main agent* will run directly (not delegated). Include `/refresh-skills`
+   if subagents are stale; surface explicit user todos; surface blockers.
+3. **One `## <role>` section per registered subagent**, each with:
+   - **1 must-do** — finishable today, traceable to a card or yesterday's
+     summary. Reference the source card id inline (e.g. `(see card-xyz)`).
+   - **0–2 stretch goals** — only if there's spare bandwidth.
+   - **Blockers** — call out anything the role can't proceed without.
+4. **`## Summary`** — leave empty (`_Subagent results land here after
+   `/deepvista run` finishes._`). The `/deepvista run` flow fills it later.
+
+Hard constraints:
+
+- Total length ≤ 600 words. Brevity beats completeness for a daily plan.
+- Every task must trace to a real card, note, or yesterday's summary —
+  never invent work. If a role has nothing genuinely ready, write
+  `- _No queued work today — the {role} specialist is free for ad-hoc
+  requests._` and move on.
+- Use the section headers (`## Workflow today`, `## <role>`, `## Summary`)
+  exactly — the `/deepvista run` slash command parses them by string match.
+
+## Step 5 — Save the plan as a DeepVista note
+
+Pipe the markdown straight into `deepvista notes create` and tag it so
+tomorrow's run finds it:
+
+```bash
+cat <<'PLAN' | deepvista notes create \
+  --title "Daily Planning $TODAY" \
+  --content-file - \
+  --tags "[\"daily-planning\",\"date:$TODAY\",\"source:agent\"]"
+# Daily Planning $TODAY
+
+<preamble>
+
+## Workflow today
+- …
+
+## marketing
+- …
+
+## engineering
+- …
+
+## Summary
+
+_Subagent results land here after `/deepvista run` finishes._
+PLAN
+```
+
+Confirm with the user before running the save (this is a write command).
+Surface the note URL — `https://app.deepvista.ai/notes/<id>` — in the
+response so they can edit any section before `/deepvista run` dispatches it.
+
+## Append a summary after `/deepvista run` finishes
+
+The slash command appends each subagent's reply onto today's note. There is
+no dedicated `append-summary` CLI — use `deepvista notes update`:
+
+```bash
+deepvista notes get <note-id>          # read current description
+# build new_description = current + "\n\n## Summary — <timestamp>\n<consolidated block>\n"
+deepvista notes update <note-id> --content-file -   # pipe new_description on stdin
+```
+
+## Quick reference
+
+| Command | Reads | Writes |
+|---|---|---|
+| `card +search "Daily Planning <date>"` | semantic search across cards | — |
+| `notes get <id>` | one note's full body | — |
+| `notes list --limit 20` | recent notes | — |
+| `card list --type todo` | recent todos | — |
+| `notes create --title ... --content-file - --tags ...` | stdin markdown | new note |
+| `notes update <id> --content-file -` | stdin markdown | replaces the note body |

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepvista-cli"
-version = "0.1.18"
+version = "0.2.0"
 description = "CLI for DeepVista — chat, notes, skills, and memory from your terminal."
 readme = "README.md"
 license = { text = "Apache-2.0" }

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/skills/deepvista/reference/session.md

@@ -54,6 +54,37 @@ deepvista session tick \
 deepvista session finalize --session-id "$CLAUDE_SESSION_ID"
 ```
 
+## Skipping nested sub-agent sessions
+
+`session init` short-circuits when `--cwd` matches any pattern in
+`session_skip_cwd_patterns` (a top-level list in
+`~/.config/deepvista/config.json`). This stops the SessionStart hook from
+recording sub-agent sessions whose CWD is not a real working directory — e.g.
+**claude-mem's observer sub-claude** runs with
+`cwd=~/.claude-mem/observer-sessions` and only quotes file paths from the
+*primary* session; recording it pollutes the vistabase with bogus File cards.
+
+Defaults skip `*/.claude-mem/observer-sessions[/*]`. Patterns are
+fnmatch-style Unix shell globs (`*` matches across `/`). To override, edit
+`~/.config/deepvista/config.json` by hand — add a top-level
+`session_skip_cwd_patterns` list. An explicit empty list disables skipping.
+
+```jsonc
+{
+  "default": { "api_url": "https://api.deepvista.ai" },
+  "session_skip_cwd_patterns": [
+    "*/.claude-mem/observer-sessions",
+    "*/.claude-mem/observer-sessions/*",
+    "*/scratchpad/*"
+  ]
+}
+```
+
+When a session is skipped, `init` emits
+`{"skipped": true, "reason": "cwd matches session_skip_cwd_patterns", ...}`
+and creates no card. Downstream `tick` / `finalize` self-no-op because no
+card was cached (exit 3 "Unknown session", silenced by the hook scripts).
+
 ## See also
 
 - [notes.md](notes.md) — explicit user-authored knowledge.

{deepvista_cli-0.1.18 → deepvista_cli-0.2.0}/uv.lock

@@ -56,7 +56,7 @@ wheels = [
 
 [[package]]
 name = "deepvista-cli"
-version = "0.1.18"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

deepvista_cli-0.1.18/.release-please-manifest.json

@@ -1,3 +0,0 @@
-{
-  ".": "0.1.18"
-}

deepvista_cli-0.1.18/tests/test_agent_catalog.py

@@ -1,225 +0,0 @@
-"""Tests for the managed-agent → Claude Code subagent export pipeline (DV-836)."""
-
-from __future__ import annotations
-
-import time
-from pathlib import Path
-from typing import Any
-
-from deepvista_cli import agent_catalog
-
-# ---------------------------------------------------------------------------
-# Fake client
-# ---------------------------------------------------------------------------
-
-
-class FakeClient:
-    """In-memory stand-in for ``DeepVistaClient`` (GET only)."""
-
-    def __init__(self, agents: list[dict[str, Any]]) -> None:
-        self._agents = agents
-        self.calls: list[tuple[str, dict | None]] = []
-
-    def get(self, path: str, params: dict | None = None) -> Any:
-        self.calls.append((path, params))
-        if path == "/agents":
-            return {"agents": self._agents}
-        raise AssertionError(f"unexpected GET {path}")
-
-
-def _agent(role: str, *, name: str = "", aid: str = "id-x", updated: str = "2026-01-01") -> dict[str, Any]:
-    return {
-        "id": aid,
-        "name": name or f"{role.title()} Claude",
-        "agent_type": "claude-code",
-        "agent_role": role,
-        "updated_at": updated,
-    }
-
-
-# ---------------------------------------------------------------------------
-# slug / render
-# ---------------------------------------------------------------------------
-
-
-def test_slugify_basic():
-    assert agent_catalog.slugify("Marketing") == "marketing"
-    assert agent_catalog.slugify("Go To Market!") == "go-to-market"
-
-
-def test_slugify_fallback_on_empty():
-    assert agent_catalog.slugify("你好", fallback="fallback") == "fallback"
-
-
-def test_file_name_applies_prefix():
-    meta = agent_catalog.AgentRoleMeta(role="marketing", agent_name="M", agent_id="a")
-    assert agent_catalog.file_name(meta, prefix="dv-") == "dv-marketing.md"
-
-
-def test_build_agent_markdown_handle_and_marker():
-    meta = agent_catalog.AgentRoleMeta(
-        role="marketing", agent_name="Marketing Claude", agent_id="abc123", updated_at="2026-05-01"
-    )
-    md = agent_catalog.build_agent_markdown(meta)
-    # Invocation handle is the bare role, so `@marketing` resolves.
-    assert "name: marketing" in md
-    # Carries our marker + provenance so we can safely reclaim it later.
-    assert f"{agent_catalog.AGENT_MARKER}: true" in md
-    assert "x-deepvista-role:" in md
-    assert "x-deepvista-agent-id: abc123" in md
-    # Known role gets its specialist description + preloads the deepvista skill.
-    assert "Marketing specialist for DeepVista" in md
-    assert "skills: deepvista" in md
-    assert "Marketing Claude" in md  # backing managed-agent name in the body
-
-
-def test_build_agent_markdown_generic_role():
-    meta = agent_catalog.AgentRoleMeta(role="legal", agent_name="", agent_id="z")
-    md = agent_catalog.build_agent_markdown(meta)
-    assert "name: legal" in md
-    assert "Legal specialist for DeepVista" in md
-
-
-def test_build_agent_markdown_bakes_custom_soul():
-    """A managed agent with config.soul renders that prompt as the body, not the template."""
-    meta = agent_catalog.AgentRoleMeta(
-        role="marketing",
-        agent_name="Marketing",
-        agent_id="abc123",
-        system_prompt="You are a bespoke marketing brain.\nGround everything in notes.",
-    )
-    md = agent_catalog.build_agent_markdown(meta)
-    # Frontmatter stays templated (routing + preloaded skill + role description).
-    assert "name: marketing" in md
-    assert "skills: deepvista" in md
-    assert "Marketing specialist for DeepVista" in md
-    # Body is the custom prompt verbatim; the default template body is bypassed.
-    assert "You are a bespoke marketing brain." in md
-    assert "Operating procedure" not in md
-
-
-def test_metas_from_agents_reads_config_soul():
-    """config.soul flows into AgentRoleMeta.system_prompt for the export to bake in."""
-    agents = [
-        {
-            "id": "m1",
-            "name": "Marketing",
-            "agent_type": "deepvista-cli",
-            "agent_role": "marketing",
-            "updated_at": "2026-05-27",
-            "config": {"soul": "CUSTOM PROMPT", "machine": "laptop"},
-        }
-    ]
-    metas = agent_catalog.metas_from_agents(agents)
-    assert len(metas) == 1
-    assert metas[0].system_prompt == "CUSTOM PROMPT"
-
-
-# ---------------------------------------------------------------------------
-# grouping
-# ---------------------------------------------------------------------------
-
-
-def test_metas_skip_misc_and_empty():
-    metas = agent_catalog.metas_from_agents([_agent("misc"), _agent(""), _agent("  "), _agent("sales")])
-    assert [m.role for m in metas] == ["sales"]
-
-
-def test_metas_group_by_role_keep_freshest_and_count():
-    metas = agent_catalog.metas_from_agents(
-        [
-            _agent("sales", name="Old Sales", aid="a1", updated="2026-01-01"),
-            _agent("sales", name="New Sales", aid="a2", updated="2026-05-01"),
-            _agent("marketing", aid="b1", updated="2026-02-01"),
-        ]
-    )
-    by_role = {m.role: m for m in metas}
-    assert set(by_role) == {"sales", "marketing"}
-    assert by_role["sales"].agent_id == "a2"  # freshest representative
-    assert by_role["sales"].agent_name == "New Sales"
-    assert by_role["sales"].count == 2
-
-
-# ---------------------------------------------------------------------------
-# curated detection
-# ---------------------------------------------------------------------------
-
-
-def test_curated_names_ignores_our_files(tmp_path: Path):
-    # A hand-curated agent (no marker).
-    (tmp_path / "marketing.md").write_text("---\nname: marketing\n---\nbody\n", encoding="utf-8")
-    # One of ours (carries the marker) — must not count as curated.
-    (tmp_path / "dv-sales.md").write_text(
-        f"---\nname: sales\n{agent_catalog.AGENT_MARKER}: true\n---\n", encoding="utf-8"
-    )
-    assert agent_catalog.curated_names(tmp_path, "dv-") == {"marketing"}
-
-
-def test_plan_skips_curated_role(tmp_path: Path):
-    (tmp_path / "marketing.md").write_text("---\nname: marketing\n---\n", encoding="utf-8")
-    metas = agent_catalog.metas_from_agents([_agent("marketing"), _agent("sales")])
-    plan = agent_catalog.compute_plan(metas, target=tmp_path, prefix="dv-", state={})
-    assert plan.skipped_curated == ["marketing"]
-    assert [m.slug for m in plan.to_add] == ["sales"]
-
-
-# ---------------------------------------------------------------------------
-# plan + apply + end-to-end
-# ---------------------------------------------------------------------------
-
-
-def test_sync_writes_then_idempotent(tmp_path: Path):
-    client = FakeClient([_agent("sales"), _agent("marketing")])
-    res = agent_catalog.sync_agent_defs(client, target=tmp_path, force=True, state_path=tmp_path / "state.json")
-    assert res["ok"] is True
-    assert res["summary"]["added"] == 2
-    assert (tmp_path / "dv-sales.md").exists()
-    assert (tmp_path / "dv-marketing.md").exists()
-
-    # Re-run: nothing changes.
-    res2 = agent_catalog.sync_agent_defs(client, target=tmp_path, force=True, state_path=tmp_path / "state.json")
-    assert res2["summary"] == {"added": 0, "updated": 0, "removed": 0, "unchanged": 2, "skipped_curated": 0}
-
-
-def test_sync_removes_def_when_role_gone(tmp_path: Path):
-    state = tmp_path / "state.json"
-    agent_catalog.sync_agent_defs(
-        FakeClient([_agent("sales"), _agent("marketing")]), target=tmp_path, force=True, state_path=state
-    )
-    assert (tmp_path / "dv-marketing.md").exists()
-
-    # Marketing role disappears server-side → its def is reclaimed.
-    res = agent_catalog.sync_agent_defs(FakeClient([_agent("sales")]), target=tmp_path, force=True, state_path=state)
-    assert res["summary"]["removed"] == 1
-    assert not (tmp_path / "dv-marketing.md").exists()
-    assert (tmp_path / "dv-sales.md").exists()
-
-
-def test_sync_never_deletes_unmarked_file(tmp_path: Path):
-    state = tmp_path / "state.json"
-    agent_catalog.sync_agent_defs(FakeClient([_agent("sales")]), target=tmp_path, force=True, state_path=state)
-    # A file sharing our prefix but without the marker must survive a reclaim.
-    intruder = tmp_path / "dv-sales.md"
-    intruder.write_text("---\nname: sales\n---\nhand edited\n", encoding="utf-8")
-    agent_catalog.sync_agent_defs(FakeClient([]), target=tmp_path, force=True, state_path=state)
-    assert intruder.exists()
-    assert "hand edited" in intruder.read_text(encoding="utf-8")
-
-
-def test_sync_throttled_skips_network(tmp_path: Path):
-    state = tmp_path / "state.json"
-    agent_catalog.save_state({"last_sync_epoch": int(time.time()), "defs": []}, state)
-    client = FakeClient([_agent("sales")])
-    res = agent_catalog.sync_agent_defs(client, target=tmp_path, throttle_min=60, state_path=state)
-    assert res["skipped"] == "throttled"
-    assert client.calls == []  # no network hit
-
-
-def test_dry_run_writes_nothing(tmp_path: Path):
-    client = FakeClient([_agent("sales")])
-    res = agent_catalog.sync_agent_defs(
-        client, target=tmp_path, force=True, dry_run=True, state_path=tmp_path / "s.json"
-    )
-    assert res["dry_run"] is True
-    assert res["plan"]["to_add"] == ["sales"]
-    assert not list(tmp_path.glob("dv-*.md"))