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

{deepvista_cli-0.2.0 → deepvista_cli-0.4.0}/.github/workflows/ci.yml

@@ -47,3 +47,29 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: gh skill publish --dry-run
+
+  windows-smoke:
+    runs-on: windows-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Parse install.ps1 (syntax check)
+        shell: pwsh
+        run: |
+          $errors = $null
+          [System.Management.Automation.Language.Parser]::ParseFile("$PWD/install.ps1", [ref]$null, [ref]$errors) | Out-Null
+          if ($errors.Count -gt 0) {
+            $errors | ForEach-Object { Write-Error $_.Message }
+            exit 1
+          }
+          Write-Host "install.ps1 parses cleanly"
+
+      - uses: astral-sh/setup-uv@v6
+        with:
+          enable-cache: true
+
+      - name: Install deepvista CLI from checkout
+        run: uv tool install ".[ui]"
+
+      - name: Smoke test - deepvista --help
+        run: deepvista --help

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

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

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

@@ -37,6 +37,26 @@ 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.4.0](https://github.com/DeepVista-AI/deepvista-cli/compare/v0.3.0...v0.4.0) (2026-06-03)
+
+
+### Features
+
+* **DV-941:** add windows install script and trampoline troubleshooting docs ([#156](https://github.com/DeepVista-AI/deepvista-cli/issues/156)) ([eed7335](https://github.com/DeepVista-AI/deepvista-cli/commit/eed7335ffdc1dfcfd84523ed0e77be066b7fe9c3))
+* **DV-942:** print next-step hints after auth login ([#157](https://github.com/DeepVista-AI/deepvista-cli/issues/157)) ([0fca6c9](https://github.com/DeepVista-AI/deepvista-cli/commit/0fca6c9309623ee690c2c9e16870d528b558fd80))
+
+## [0.3.0](https://github.com/DeepVista-AI/deepvista-cli/compare/v0.2.0...v0.3.0) (2026-05-31)
+
+
+### Features
+
+* **DV-871:** move daily-planning to server; add schedule command ([#151](https://github.com/DeepVista-AI/deepvista-cli/issues/151)) ([7c317e7](https://github.com/DeepVista-AI/deepvista-cli/commit/7c317e7d6f71763f6622354b8581ead8b10ef8ea))
+
+
+### Bug Fixes
+
+* **types:** mark output_error as NoReturn to fix Pyright errors in schedule.py ([#153](https://github.com/DeepVista-AI/deepvista-cli/issues/153)) ([7ac8b12](https://github.com/DeepVista-AI/deepvista-cli/commit/7ac8b12f1b10a94cd6dbe8533b122a2cf8489228))
+
 ## [0.2.0](https://github.com/DeepVista-AI/deepvista-cli/compare/v0.1.18...v0.2.0) (2026-05-28)
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deepvista-cli
-Version: 0.2.0
+Version: 0.4.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
@@ -164,14 +164,52 @@ then `deepvista auth login`).
 
 ### For non-Claude-Code agents (Cursor, OpenCode, OpenClaw, …)
 
+**macOS / Linux (bash):**
+
 ```bash
 curl -sSL https://raw.githubusercontent.com/DeepVista-AI/deepvista-cli/main/install.sh | bash
 ```
 
+**Windows (PowerShell):**
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/DeepVista-AI/deepvista-cli/main/install.ps1 | iex"
+```
+
 The script auto-detects your package manager (`uv`, `pipx`, or `pip`) and copies the consolidated `deepvista` skill into your agent's skill directory (Cursor, OpenCode, OpenClaw, and Claude Code as a fallback). If you upgraded from an earlier release, it also sweeps out the 12 legacy `deepvista-*` skills so you don't end up with both.
 
 Prefer GitHub's CLI? `gh skill install DeepVista-AI/deepvista-cli` works too (GitHub CLI ≥ 2.90, preview).
 
+#### Windows troubleshooting: `uv trampoline failed to canonicalize script path`
+
+On Windows, running `deepvista` may fail with:
+
+```
+error: uv trampoline failed to canonicalize script path
+```
+
+This is a [known uv-on-Windows issue](https://github.com/astral-sh/uv/issues): the launcher (trampoline) that `uv tool install` creates can fail to resolve its own path. It is aggravated by working directories that contain **spaces** (e.g. `C:\Users\you\Claude Folder`) or are inside **OneDrive**-synced folders.
+
+Fixes, in order of preference:
+
+1. **Update uv and reinstall the launcher:**
+
+   ```powershell
+   uv self update
+   uv tool install --reinstall "deepvista-cli[ui]"
+   ```
+
+2. **Run via `uv tool run` as a fallback** (bypasses the broken trampoline entirely):
+
+   ```powershell
+   uv tool run deepvista auth login
+   uv tool run deepvista notes +quick "My first note"
+   ```
+
+3. **Avoid spaces / OneDrive in your working directory.** Run from a path without spaces, e.g. `C:\dev`, rather than `C:\Users\you\Claude Folder`.
+
+The `install.ps1` script performs this check automatically: after installing it runs `deepvista --version`, and if it hits the trampoline error it falls back to `uv tool run deepvista` and prints the guidance above. It also adds `%USERPROFILE%\.local\bin` (uv's tool bin directory) to your user PATH if it isn't already there — restart your shell afterward so new terminals pick it up.
+
 ### Get Started
 
 Open your agent and paste:

{deepvista_cli-0.2.0 → deepvista_cli-0.4.0}/README.md

@@ -135,14 +135,52 @@ then `deepvista auth login`).
 
 ### For non-Claude-Code agents (Cursor, OpenCode, OpenClaw, …)
 
+**macOS / Linux (bash):**
+
 ```bash
 curl -sSL https://raw.githubusercontent.com/DeepVista-AI/deepvista-cli/main/install.sh | bash
 ```
 
+**Windows (PowerShell):**
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/DeepVista-AI/deepvista-cli/main/install.ps1 | iex"
+```
+
 The script auto-detects your package manager (`uv`, `pipx`, or `pip`) and copies the consolidated `deepvista` skill into your agent's skill directory (Cursor, OpenCode, OpenClaw, and Claude Code as a fallback). If you upgraded from an earlier release, it also sweeps out the 12 legacy `deepvista-*` skills so you don't end up with both.
 
 Prefer GitHub's CLI? `gh skill install DeepVista-AI/deepvista-cli` works too (GitHub CLI ≥ 2.90, preview).
 
+#### Windows troubleshooting: `uv trampoline failed to canonicalize script path`
+
+On Windows, running `deepvista` may fail with:
+
+```
+error: uv trampoline failed to canonicalize script path
+```
+
+This is a [known uv-on-Windows issue](https://github.com/astral-sh/uv/issues): the launcher (trampoline) that `uv tool install` creates can fail to resolve its own path. It is aggravated by working directories that contain **spaces** (e.g. `C:\Users\you\Claude Folder`) or are inside **OneDrive**-synced folders.
+
+Fixes, in order of preference:
+
+1. **Update uv and reinstall the launcher:**
+
+   ```powershell
+   uv self update
+   uv tool install --reinstall "deepvista-cli[ui]"
+   ```
+
+2. **Run via `uv tool run` as a fallback** (bypasses the broken trampoline entirely):
+
+   ```powershell
+   uv tool run deepvista auth login
+   uv tool run deepvista notes +quick "My first note"
+   ```
+
+3. **Avoid spaces / OneDrive in your working directory.** Run from a path without spaces, e.g. `C:\dev`, rather than `C:\Users\you\Claude Folder`.
+
+The `install.ps1` script performs this check automatically: after installing it runs `deepvista --version`, and if it hits the trampoline error it falls back to `uv tool run deepvista` and prints the guidance above. It also adds `%USERPROFILE%\.local\bin` (uv's tool bin directory) to your user PATH if it isn't already there — restart your shell afterward so new terminals pick it up.
+
 ### Get Started
 
 Open your agent and paste:

{deepvista_cli-0.2.0 → deepvista_cli-0.4.0}/deepvista_cli/commands/auth.py

@@ -14,6 +14,7 @@ from deepvista_cli.auth.tokens import (
     remove_account,
     switch_active_account,
 )
+from deepvista_cli.client.origin import detect_agent_tool
 from deepvista_cli.config import credentials_path
 from deepvista_cli.output.formatter import format_output, output_error
 
@@ -23,6 +24,37 @@ def auth_group() -> None:
     """Authenticate with DeepVista."""
 
 
+def _print_next_steps() -> None:
+    """Print actionable next-step options after a successful login (DV-942).
+
+    Written to stderr so the JSON result on stdout stays machine-parseable.
+    Suggestions adapt to whoever is driving the CLI (agent vs. terminal).
+    """
+    tool, _version = detect_agent_tool()
+    if tool == "claude-code":
+        steps = [
+            "/refresh-skills — sync the DeepVista skill catalog",
+            'say "Help me get started with DeepVista."',
+            'deepvista notes +quick "<fact>" — capture your first note',
+        ]
+    elif tool == "deepvista-cli":  # direct terminal usage
+        steps = [
+            'deepvista notes +quick "My first note" — capture a note',
+            "deepvista skill list — browse your workflow skills",
+            "deepvista ui — launch the terminal UI",
+            "deepvista chat — talk to your DeepVista agent",
+        ]
+    else:  # some other AI agent is driving us
+        steps = [
+            'deepvista notes +quick "<fact>" — capture a note for the user',
+            "deepvista skill list — discover available workflow skills",
+            'deepvista vistabase +search "<topic>" — recall the user\'s stored context',
+        ]
+    click.echo("\n  What's next? Pick one:", err=True)
+    for step in steps:
+        click.echo(f"    - {step}", err=True)
+
+
 @auth_group.command("login")
 @click.option("--code", default=None, help="One-time auth code from the browser.")
 @click.option("--dry-run", is_flag=True, default=False, help="Preview what would happen without making any changes.")
@@ -64,6 +96,7 @@ def auth_login(ctx: click.Context, code: str | None, dry_run: bool) -> None:
     }
     format_output(result, ctx.obj.output_format)
     click.echo(f"  Logged in as {tokens.email or tokens.user_id}", err=True)
+    _print_next_steps()
 
 
 @auth_group.command("status")

deepvista_cli-0.4.0/deepvista_cli/commands/schedule.py

@@ -0,0 +1,169 @@
+"""deepvista schedule — opt-in recurring runs of the daily-planning skill.
+
+Daily planning generation lives on the DeepVista server (the
+``deepvista-daily-planning`` skill). This command lets the user *explicitly*
+activate a recurring server job that generates today's planning note on a cron
+schedule — nothing runs automatically until the user opts in here, which keeps
+token spend under their control.
+
+Under the hood each "activation" is a row in the server's ``scheduled_jobs``
+table whose ``prompt`` asks the agent to run the daily-planning skill. The
+heartbeat dispatcher drains due rows and runs the agent.
+"""
+
+from __future__ import annotations
+
+import click
+
+from deepvista_cli.client.http import DeepVistaClient
+from deepvista_cli.output.formatter import format_output, output_error
+
+# The server-side workflow skill that generates the planning note.
+DAILY_PLANNING_SKILL = "deepvista-daily-planning"
+# Stable title used to find this job again (activate is idempotent on it).
+JOB_TITLE = "Daily Planning"
+# Cron is evaluated in UTC server-side (no per-user timezone yet — see DV-879).
+DEFAULT_DAILY_CRON = "0 8 * * *"
+DEFAULT_WEEKLY_CRON = "0 8 * * 1"
+
+# Columns shown in `--format table`.
+_JOB_COLUMNS = ["id", "title", "cron_schedule", "enabled", "next_run_at", "last_run_at"]
+
+
+def _client(ctx: click.Context) -> DeepVistaClient:
+    return ctx.obj._client
+
+
+def _find_daily_planning_job(ctx: click.Context) -> dict | None:
+    """Return the existing daily-planning job for this user, or None.
+
+    Matches on the stable ``JOB_TITLE`` so repeated activations re-use the same
+    row instead of stacking duplicates.
+    """
+    data = _client(ctx).get("/scheduled-jobs")
+    for job in data.get("jobs", []):
+        if job.get("title") == JOB_TITLE:
+            return job
+    return None
+
+
+@click.group("schedule")
+def schedule_group() -> None:
+    """Manage the recurring daily-planning job (opt-in)."""
+
+
+@schedule_group.command("activate")
+@click.option("--cron", "cron_schedule", default=None, help="5-field cron in UTC (default: daily 08:00 UTC).")
+@click.option("--weekly", is_flag=True, default=False, help="Run weekly (Mon 08:00 UTC) instead of daily.")
+@click.pass_context
+def schedule_activate(ctx: click.Context, cron_schedule: str | None, weekly: bool) -> None:
+    """Activate the recurring daily-planning job.
+
+    Idempotent: if a daily-planning job already exists it is re-enabled rather
+    than duplicated. To change the cron of an existing job, deactivate + delete
+    it first, then activate again with a new --cron.
+    """
+    cadence = "weekly" if weekly else "daily"
+    if cron_schedule is None:
+        cron_schedule = DEFAULT_WEEKLY_CRON if weekly else DEFAULT_DAILY_CRON
+
+    existing = _find_daily_planning_job(ctx)
+    if existing is not None:
+        if existing.get("enabled"):
+            format_output(
+                {"status": "already_active", "job": existing},
+                ctx.obj.output_format,
+                title="Daily planning already active",
+            )
+            return
+        resp = _client(ctx).patch(f"/scheduled-jobs/{existing['id']}", {"enabled": True})
+        format_output(
+            {"status": "reactivated", "job": resp.get("job", resp)},
+            ctx.obj.output_format,
+            title="Daily planning reactivated",
+        )
+        return
+
+    prompt = (
+        f"Run the {DAILY_PLANNING_SKILL} skill to generate today's daily "
+        f"planning note (cadence: {cadence}). List the workflow Skills that "
+        f"should run today as context-card chips in the note's Planning section."
+    )
+    resp = _client(ctx).post(
+        "/scheduled-jobs",
+        {
+            "prompt": prompt,
+            "cron_schedule": cron_schedule,
+            "title": JOB_TITLE,
+            "enabled": True,
+        },
+    )
+    if not resp.get("success"):
+        output_error(1, "Failed to activate daily planning", resp.get("error", ""))
+    format_output(
+        {"status": "activated", "cadence": cadence, "job": resp.get("job", resp)},
+        ctx.obj.output_format,
+        title="Daily planning activated",
+    )
+
+
+@schedule_group.command("deactivate")
+@click.pass_context
+def schedule_deactivate(ctx: click.Context) -> None:
+    """Disable the daily-planning job (keeps the row so it can be re-activated)."""
+    existing = _find_daily_planning_job(ctx)
+    if existing is None:
+        output_error(1, "No daily-planning job found", "Run: deepvista schedule activate")
+    if not existing.get("enabled"):
+        format_output(
+            {"status": "already_inactive", "job": existing},
+            ctx.obj.output_format,
+            title="Daily planning already inactive",
+        )
+        return
+    resp = _client(ctx).patch(f"/scheduled-jobs/{existing['id']}", {"enabled": False})
+    format_output(
+        {"status": "deactivated", "job": resp.get("job", resp)},
+        ctx.obj.output_format,
+        title="Daily planning deactivated",
+    )
+
+
+@schedule_group.command("list")
+@click.pass_context
+def schedule_list(ctx: click.Context) -> None:
+    """List the caller's scheduled jobs (read-only)."""
+    data = _client(ctx).get("/scheduled-jobs")
+    jobs = data.get("jobs", [])
+    format_output(
+        {"jobs": jobs, "count": len(jobs)},
+        ctx.obj.output_format,
+        columns=_JOB_COLUMNS,
+        title="Scheduled Jobs",
+    )
+
+
+@schedule_group.command("delete")
+@click.argument("job_id", required=False)
+@click.pass_context
+def schedule_delete(ctx: click.Context, job_id: str | None) -> None:
+    """Delete a scheduled job permanently.
+
+    With no JOB_ID, deletes the daily-planning job. Use this (then ``activate``)
+    to change a job's cron, which PATCH can't edit. Pass ``--dry-run`` on the
+    root command to preview without deleting.
+    """
+    if job_id is None:
+        existing = _find_daily_planning_job(ctx)
+        if existing is None:
+            output_error(1, "No daily-planning job found", "Pass a JOB_ID, or run: deepvista schedule list")
+        job_id = existing["id"]
+
+    resp = _client(ctx).delete(f"/scheduled-jobs/{job_id}")
+    if not resp.get("success"):
+        output_error(1, "Failed to delete scheduled job", resp.get("error", ""))
+    format_output(
+        {"status": "deleted", "job_id": job_id},
+        ctx.obj.output_format,
+        title="Scheduled job deleted",
+    )

{deepvista_cli-0.2.0 → deepvista_cli-0.4.0}/deepvista_cli/main.py

@@ -31,6 +31,7 @@ from deepvista_cli.commands.config import config_group
 from deepvista_cli.commands.lint import lint_command
 from deepvista_cli.commands.memory import vistabase_group
 from deepvista_cli.commands.notes import notes_group
+from deepvista_cli.commands.schedule import schedule_group
 from deepvista_cli.commands.session import session_group
 from deepvista_cli.commands.skill import skill_group
 from deepvista_cli.commands.upgrade import upgrade_command
@@ -87,6 +88,8 @@ for _name, _cmd in card_group.commands.items():
 cli.add_command(vistabase_group, name="memory")
 # Agent orchestration
 cli.add_command(agents_group)
+# Opt-in recurring daily-planning job
+cli.add_command(schedule_group)
 # Agent session transcripts (DV-742) — `init` / `tick` / `finalize`
 cli.add_command(session_group)
 # Supporting commands

{deepvista_cli-0.2.0 → deepvista_cli-0.4.0}/deepvista_cli/output/formatter.py

@@ -8,7 +8,7 @@ from __future__ import annotations
 
 import json
 import sys
-from typing import Any
+from typing import Any, NoReturn
 
 import click
 
@@ -170,7 +170,7 @@ def output_table(data: Any, columns: list[str] | None = None, title: str | None
         output_json(data)
 
 
-def output_error(code: int, message: str, detail: str = "") -> None:
+def output_error(code: int, message: str, detail: str = "") -> NoReturn:
     """Write structured error to stderr and exit."""
     err = {"error": {"code": code, "message": message}}
     if detail: