scios-cli 0.3.1__tar.gz → 0.3.2__tar.gz

{scios_cli-0.3.1 → scios_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scios-cli
-Version: 0.3.1
+Version: 0.3.2
 Summary: Scios unified CLI — dev environment, deployment, database, logs, and more
 Author: Scios Team
 License: Apache-2.0

{scios_cli-0.3.1 → scios_cli-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "scios-cli"
-version = "0.3.1"
+version = "0.3.2"
 description = "Scios unified CLI — dev environment, deployment, database, logs, and more"
 readme = "README.md"
 license = {text = "Apache-2.0"}

{scios_cli-0.3.1 → scios_cli-0.3.2}/scios_cli/ag/local_runner.py

@@ -159,7 +159,7 @@ def _run_node(
     # Match the backend orchestrator's init_args EXACTLY (agent_orchestrator.py):
     # only name + model. Passing the raw node `configuration` collides with fields
     # the primitive __init__ already sets (e.g. `description`) → TypeError.
-    init_args = {"name": agent_name, "model": "gemini-3.5-flash"}
+    init_args = {"name": agent_name, "model": "gemini-3.6-flash"}
 
     node_dir = work_dir / node_id
     node_dir.mkdir(parents=True, exist_ok=True)

scios_cli-0.3.2/scios_cli/ag/plugin.py

@@ -0,0 +1,283 @@
+"""Antigravity Plugin — installs Scios as a global plugin at ~/.gemini/config/plugins/scios/.
+
+Provides MCP servers, skills, rules, and sidecars that work across all workspaces
+without per-workspace `.agents/` duplication. Per the Antigravity plugin spec
+(docs/integrations/antigravity/antigravity-docs-cache/markdown/plugins.md).
+
+Plugin layout:
+    ~/.gemini/config/plugins/scios/
+    ├── plugin.json
+    ├── mcp_config.json         (scios-core + scios-maxwell)
+    ├── hooks.json              (ruff format-on-save)
+    ├── skills/
+    │   └── scios-workflow/
+    │       └── SKILL.md
+    ├── rules/
+    │   └── scios.md
+    └── sidecars/
+        ├── scios-sync/
+        │   ├── sidecar.json
+        │   └── sync.sh
+        └── scios-notifier/
+            ├── sidecar.json
+            └── notify.sh
+
+Sidecar config lives at ~/.gemini/config/config.json (user-controlled enable/disable).
+"""
+from __future__ import annotations
+
+import json
+import shutil
+from pathlib import Path
+from typing import Callable
+
+PLUGIN_DIR = Path.home() / ".gemini" / "config" / "plugins" / "scios"
+CONFIG_FILE = Path.home() / ".gemini" / "config" / "config.json"
+
+SCIOS_BIN = shutil.which("scios") or "scios"
+
+
+def plugin_installed() -> bool:
+    """Check if the global Antigravity plugin is installed."""
+    return (PLUGIN_DIR / "plugin.json").exists()
+
+
+def install_plugin(
+    *,
+    enable_notifier: bool = False,
+    log: Callable[[str], None] = print,
+) -> None:
+    """Write all plugin files and update config.json to enable sidecars."""
+
+    # ── plugin.json ──
+    _write_json(PLUGIN_DIR / "plugin.json", {
+        "name": "scios",
+        "displayName": "Scios Research Platform",
+        "description": "Drive autonomous scientific research — stage-by-stage pipeline, MCP tools, Maxwell assistant.",
+    })
+
+    # ── mcp_config.json ──
+    _write_json(PLUGIN_DIR / "mcp_config.json", {
+        "mcpServers": {
+            "scios-core": {
+                "command": SCIOS_BIN,
+                "args": ["ag", "mcp", "core"],
+                "env": {},
+            },
+            "scios-maxwell": {
+                "command": SCIOS_BIN,
+                "args": ["ag", "mcp", "maxwell"],
+                "env": {},
+            },
+        }
+    })
+    log("  ✓ mcp_config.json (scios-core + scios-maxwell)")
+
+    # ── hooks.json ──
+    _write_json(PLUGIN_DIR / "hooks.json", {
+        "hooks": {
+            "afterFileEdit": [
+                {
+                    "command": "sh -c 'command -v ruff >/dev/null 2>&1 && ruff format \"$FILE\" || true'",
+                    "glob": "agents/*.py",
+                }
+            ]
+        }
+    })
+    log("  ✓ hooks.json (ruff format-on-save)")
+
+    # ── skills/scios-workflow/SKILL.md ──
+    skill_dir = PLUGIN_DIR / "skills" / "scios-workflow"
+    skill_dir.mkdir(parents=True, exist_ok=True)
+    (skill_dir / "SKILL.md").write_text(_WORKFLOW_SKILL)
+    log("  ✓ skills/scios-workflow/SKILL.md")
+
+    # ── rules/scios.md ──
+    rules_dir = PLUGIN_DIR / "rules"
+    rules_dir.mkdir(parents=True, exist_ok=True)
+    (rules_dir / "scios.md").write_text(_RULES)
+    log("  ✓ rules/scios.md")
+
+    # ── sidecars/scios-sync/ ──
+    sync_dir = PLUGIN_DIR / "sidecars" / "scios-sync"
+    sync_dir.mkdir(parents=True, exist_ok=True)
+    _write_json(sync_dir / "sidecar.json", {
+        "description": "Auto-sync: watches agents/*.py and pushes edits to the Scios backend",
+        "display_name": "Scios Sync",
+        "command": SCIOS_BIN,
+        "args": ["ag", "sync"],
+        "restart_policy": "on-failure",
+    })
+    log("  ✓ sidecars/scios-sync (auto-sync agent code)")
+
+    # ── sidecars/scios-notifier/ ──
+    notifier_dir = PLUGIN_DIR / "sidecars" / "scios-notifier"
+    notifier_dir.mkdir(parents=True, exist_ok=True)
+    (notifier_dir / "notify.sh").write_text(_NOTIFIER_SCRIPT)
+    (notifier_dir / "notify.sh").chmod(0o755)
+    _write_json(notifier_dir / "sidecar.json", {
+        "description": "Polls build-execute status every 60s and notifies via agentapi when done",
+        "display_name": "Scios Notifier",
+        "builtin": "schedule",
+        "args": [
+            "*/1 * * * *",
+            "/bin/bash",
+            str(notifier_dir / "notify.sh"),
+        ],
+    })
+    log("  ✓ sidecars/scios-notifier (status polling, opt-in)")
+
+    # ── config.json (enable sidecars) ──
+    _update_config(enable_sync=True, enable_notifier=enable_notifier)
+    log(f"  ✓ config.json (sync: enabled, notifier: {'enabled' if enable_notifier else 'disabled — use --enable-notifier'})")
+
+    log(f"\n✓ Scios plugin installed → {PLUGIN_DIR}")
+
+
+def uninstall_plugin(*, log: Callable[[str], None] = print) -> None:
+    """Remove the plugin directory and config entries."""
+    if PLUGIN_DIR.exists():
+        shutil.rmtree(PLUGIN_DIR)
+        log(f"✓ Removed {PLUGIN_DIR}")
+    _update_config(remove=True)
+    log("✓ Removed sidecar config from config.json")
+
+
+def _update_config(
+    *,
+    enable_sync: bool = True,
+    enable_notifier: bool = False,
+    remove: bool = False,
+) -> None:
+    """Update ~/.gemini/config/config.json to enable/disable Scios sidecars."""
+    config: dict = {}
+    if CONFIG_FILE.exists():
+        try:
+            config = json.loads(CONFIG_FILE.read_text())
+        except (json.JSONDecodeError, OSError):
+            config = {}
+
+    sidecars = config.setdefault("sidecars", {})
+
+    if remove:
+        sidecars.pop("scios/scios-sync", None)
+        sidecars.pop("scios/scios-notifier", None)
+    else:
+        sidecars["scios/scios-sync"] = {"enabled": enable_sync}
+        sidecars["scios/scios-notifier"] = {"enabled": enable_notifier}
+
+    CONFIG_FILE.parent.mkdir(parents=True, exist_ok=True)
+    CONFIG_FILE.write_text(json.dumps(config, indent=2) + "\n")
+
+
+def _write_json(path: Path, data: dict) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(json.dumps(data, indent=2) + "\n")
+
+
+# ---------------------------------------------------------------------------
+# Inlined content (avoids reading from skill files at install time)
+# ---------------------------------------------------------------------------
+
+_WORKFLOW_SKILL = """\
+---
+name: scios-workflow
+description: Runs, optimizes, and explains Scios research workflows in this workspace. Use when the user asks to run the workflow, iterate on an agent, check scores or build-execute progress, optimize, or understand why an execution failed. Applies to any Scios workspace containing scios.toml and an agents/ folder.
+---
+
+# Scios Workflow Skill
+
+This workspace is a Scios research project. Use the `scios-core` MCP tools and the
+`scios` CLI to drive it.
+
+## Common tasks
+- **Run the workflow**: call the `scios_run` tool, or run `scios ag run`. Respect
+  the `mode` in `scios.toml` (local vs cloud). For a one-off cloud run use
+  `scios ag run --mode cloud`.
+- **Check status / scores**: call `scios_status` or run `scios ag status`. Report
+  the `scios_score` and the current build-execute stage.
+- **Explain results**: run `scios ag explain` for scores, per-node trace, and
+  failure diagnostics. This is the most important command after a run.
+- **Edit an agent**: open the relevant file in `agents/`, make the change, save.
+  The sync sidecar pushes it to the backend automatically.
+- **Optimize**: run `scios ag optimize --iterations N` (rides the existing
+  optimizer settings). Larger `compute_scale` in `scios.toml` sizes runs bigger.
+- **Explain a failure**: call `scios_explain` or read `execution/trace_summary.md`
+  and `execution/logs.json`.
+- **Diff after optimize**: run `scios ag diff` to see what the optimizer changed.
+
+## Guidance
+- The backend is the source of truth; files are a view. Don't hand-edit read-only
+  folders (`execution/`, `workflows/`, `datasets/`, `dashboards/`).
+- Prefer the MCP tools for structured results; fall back to the CLI for anything
+  not exposed as a tool.
+"""
+
+_RULES = """\
+---
+trigger: always_on
+---
+
+# Scios Workspace Conventions
+
+This folder is a **Scios research workspace** projected from the Scios backend by
+the `scios ag` CLI. Treat the backend DB as the single source of truth — these
+files are a synced *view*.
+
+## Folder map
+- `agents/*.py` — vibed agent code. **Two-way synced**: editing a file pushes it
+  to the backend (via the sync sidecar or `scios ag push-code`). The first line
+  `# AGENT_ID: <uuid>` is the sync key — **never delete or edit it**.
+- `workflows/definition.json` — the workflow DAG (read-only projection).
+- `execution/` — metrics.json, trace_summary.md, logs.json (read-only).
+- `datasets/` — inline data, `.url` shortcuts (gs://), or `.metadata.json`.
+- `dashboards/` — generated result dashboards (read-only).
+- `scios.toml` — the only local-authoritative file (idea_id, endpoint, mode, budget).
+
+## How to work here
+- To change an agent's behaviour, edit its file in `agents/` and save. The
+  sync sidecar pushes it automatically, or use `scios ag push-code <file>`.
+- To run the workflow: `scios ag run` (mode from `scios.toml`).
+- To check progress/scores: `scios ag status` or `scios ag explain`.
+- Prefer the `scios-core` MCP tools (`scios_run`, `scios_status`, `scios_logs`,
+  `scios_explain`) and the `scios-maxwell` assistant over shelling out manually.
+
+## Hard rules
+- Never edit files under `execution/`, `workflows/`, `datasets/`, `dashboards/`
+  by hand — they are overwritten on the next sync.
+- Never remove the `# AGENT_ID:` header from an agent file.
+- Do not invent new API endpoints; the CLI already wraps the backend.
+"""
+
+_NOTIFIER_SCRIPT = """\
+#!/usr/bin/env bash
+# Scios status notifier — polls build-execute status, notifies via agentapi when done.
+# Runs as a scheduled sidecar (every 60s). Writes state to $ANTIGRAVITY_EXECUTABLE_DATA_DIR.
+
+set -euo pipefail
+
+STATE_DIR="${ANTIGRAVITY_EXECUTABLE_DATA_DIR:-/tmp/scios-notifier}"
+mkdir -p "$STATE_DIR"
+LAST_STATUS_FILE="$STATE_DIR/last_status"
+
+# Get current status (requires scios.toml in CWD or nearest parent)
+STATUS_JSON=$(scios ag status 2>/dev/null | head -5 || true)
+if [[ -z "$STATUS_JSON" ]]; then
+  exit 0  # No workspace mounted, nothing to do
+fi
+
+# Extract status and score
+CURRENT_STATUS=$(echo "$STATUS_JSON" | grep -oP 'status:\\s*\\K\\S+' || echo "unknown")
+SCORE=$(echo "$STATUS_JSON" | grep -oP 'scios_score:\\s*\\K\\S+' || echo "—")
+LAST_STATUS=$(cat "$LAST_STATUS_FILE" 2>/dev/null || echo "unknown")
+
+# Notify only on state transitions to terminal states
+if [[ "$CURRENT_STATUS" != "$LAST_STATUS" ]]; then
+  echo "$CURRENT_STATUS" > "$LAST_STATUS_FILE"
+  if [[ "$CURRENT_STATUS" == "completed" ]]; then
+    agentapi new-conversation "✅ Scios execution completed — scios_score: $SCORE. Run \\`scios ag explain\\` for details." 2>/dev/null || true
+  elif [[ "$CURRENT_STATUS" == "failed" ]]; then
+    agentapi new-conversation "❌ Scios execution failed. Run \\`scios ag explain\\` to see what went wrong." 2>/dev/null || true
+  fi
+fi
+"""

{scios_cli-0.3.1 → scios_cli-0.3.2}/scios_cli/ag/scaffold.py

@@ -301,16 +301,29 @@ def _write(path: Path, content: str, *, limit: int | None = None) -> None:
 
 
 def scaffold(folder: Path, manifest: Manifest, *, log=print) -> None:
-    """(Re)write all Antigravity + VS Code integration files into `folder`."""
+    """(Re)write all Antigravity + VS Code integration files into `folder`.
+
+    If the global Antigravity plugin is installed (~/.gemini/config/plugins/scios/),
+    skip the .agents/ MCP config, rules, skills, and hooks — the plugin provides
+    those globally. Only write workspace-specific files (workflows + .vscode).
+    """
+    from scios_cli.ag.plugin import plugin_installed
+
     agents_dir = folder / ".agents"
+    has_global_plugin = plugin_installed()
+
+    if has_global_plugin:
+        log("  ℹ Global Antigravity plugin detected — skipping .agents/ MCP/rules/skills (provided by plugin)")
+    else:
+        _write(agents_dir / "mcp_config.json", json.dumps(_mcp_config(manifest), indent=2))
+        _write(agents_dir / "rules" / "scios.md", _RULES, limit=CHAR_LIMIT)
+        _write(agents_dir / "skills" / "scios-workflow" / "SKILL.md", _SKILL)
+        _write(agents_dir / "hooks.json", json.dumps(_hooks(), indent=2))
 
-    _write(agents_dir / "mcp_config.json", json.dumps(_mcp_config(manifest), indent=2))
-    _write(agents_dir / "rules" / "scios.md", _RULES, limit=CHAR_LIMIT)
-    _write(agents_dir / "skills" / "scios-workflow" / "SKILL.md", _SKILL)
+    # Workflows are always workspace-specific (they reference workspace commands)
     _write(agents_dir / "workflows" / "scios-run.md", _WF_RUN, limit=CHAR_LIMIT)
     _write(agents_dir / "workflows" / "scios-optimize.md", _WF_OPTIMIZE, limit=CHAR_LIMIT)
     _write(agents_dir / "workflows" / "scios-explain.md", _WF_EXPLAIN, limit=CHAR_LIMIT)
-    _write(agents_dir / "hooks.json", json.dumps(_hooks(), indent=2))
 
     import shutil
 

{scios_cli-0.3.1 → scios_cli-0.3.2}/scios_cli/app.py

@@ -94,6 +94,40 @@ COMMAND_GROUPS = [
 
 
 
+# ── Throttled skill sync (at most once per day) ──────────────────────────
+_SKILL_SYNC_INTERVAL = 86400  # 24 hours in seconds
+
+
+def _maybe_sync_skill() -> None:
+    """Silently sync the agent skill if it hasn't been updated today.
+
+    Writes a timestamp to ~/.scios/.skill_sync_ts. If the file is missing or
+    older than _SKILL_SYNC_INTERVAL, runs ensure_skill_updated(quiet=True).
+    Never blocks, never errors — worst case it's a no-op.
+    """
+    import time
+    from pathlib import Path
+
+    ts_file = Path.home() / ".scios" / ".skill_sync_ts"
+    now = time.time()
+
+    try:
+        if ts_file.exists():
+            last = float(ts_file.read_text().strip())
+            if now - last < _SKILL_SYNC_INTERVAL:
+                return  # Already synced recently
+    except Exception:
+        pass
+
+    try:
+        from scios_cli.commands.setup import ensure_skill_updated
+        ensure_skill_updated(quiet=True)
+        ts_file.parent.mkdir(parents=True, exist_ok=True)
+        ts_file.write_text(str(now))
+    except Exception:
+        pass  # Non-critical — never block CLI on skill sync failure
+
+
 @app.callback()
 def _root_callback(
     ctx: typer.Context,
@@ -107,6 +141,9 @@ def _root_callback(
     # Check Google auth access before any command runs
     check_cli_access()
 
+    # Auto-sync agent skill (at most once per day, silent)
+    _maybe_sync_skill()
+
     if ctx.invoked_subcommand is not None:
         return  # A subcommand was given — let it run