gemcode 0.3.0__tar.gz → 0.3.2__tar.gz

{gemcode-0.3.0/src/gemcode.egg-info → gemcode-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.0
+Version: 0.3.2
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License

{gemcode-0.3.0 → gemcode-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gemcode"
-version = "0.3.0"
+version = "0.3.2"
 description = "Local-first coding agent on Google Gemini + ADK"
 readme = "README.md"
 requires-python = ">=3.11"

{gemcode-0.3.0 → gemcode-0.3.2}/src/gemcode/agent.py

@@ -74,7 +74,7 @@ You operate only inside the user's project directory (current working directory)
 - **`run_command` rules (critical):**
   - `command` must be a **single executable basename** (e.g. `npm`, `npx`, `mkdir`) — **not** `bash`, `sh`, or `cd foo && ...`.
   - Pass argv as `args` (list). To run a command **inside** a subfolder (e.g. Next app in `testing/`), set **`cwd_subdir`** to that relative path (e.g. `"testing"`) and run `npm run dev` there — **never** simulate `cd` with `bash`.
-  - **Scaffolding** (`create-next-app`, etc.): many CLIs require non-interactive mode — pass **`extra_env`** like `{"CI": "1"}` and/or flags supported by that tool (`--yes` where documented).
+  - **Scaffolding** (`create-next-app`, etc.): many CLIs require non-interactive mode — pass **`extra_env_keys`** / **`extra_env_values`** as parallel lists (e.g. `["CI"]` and `["1"]`) and/or flags supported by that tool (`--yes` where documented).
   - **Dev servers** (`npm run dev`, `vite`, etc.) run until stopped: use **`background=True`** so the process detaches; otherwise the tool may time out. You cannot open a *new OS terminal window* from here—background start is the supported way to keep running.
 - **Parallelize:** when you need several **independent** reads or searches (no output from one is required to form the next call), issue them together in one turn so the user gets answers faster. When step B depends on step A's result, run **sequentially**.
 - **Deletion:** use `delete_file` for a single file under the project root; reserve `rm` via `run_command` for unusual cases.

{gemcode-0.3.0 → gemcode-0.3.2}/src/gemcode/cli.py

@@ -49,6 +49,7 @@ def _maybe_prompt_trust(cfg: GemCodeConfig) -> None:
     return
   try:
     print(
+        "\n── GemCode setup (1/3) · Workspace permission ──\n"
         "GemCode needs full access to this workspace folder (files, shell, git):\n"
         f"  {root}\n\n"
         "Trust this folder? [y/N] ",
@@ -86,7 +87,8 @@ def _maybe_prompt_google_api_key() -> None:
     return
   try:
     print(
-        "\nGemCode needs a Google Gemini API key (saved once under ~/.gemcode/).\n"
+        "\n── GemCode setup (2/3) · API key ──\n"
+        "GemCode needs a Google Gemini API key (saved once under ~/.gemcode/).\n"
         "Create one at https://aistudio.google.com/app/apikey\n"
         "Paste your key and press Enter (input is hidden).\n",
         file=sys.stderr,
@@ -115,6 +117,32 @@ def require_google_api_key() -> None:
   )
 
 
+def _initialize_gemcode_project(cfg: GemCodeConfig) -> None:
+  """
+  Create ``<project>/.gemcode/`` and print a short banner the first time it appears.
+
+  Runs after workspace trust + API key are satisfied so a bare ``gemcode`` REPL
+  feels like a guided first-run (Claude Code–style).
+  """
+  root = cfg.project_root.resolve()
+  gem_dir = root / ".gemcode"
+  already_there = gem_dir.is_dir()
+  try:
+    gem_dir.mkdir(parents=True, exist_ok=True)
+  except OSError as e:
+    print(f"[gemcode] warning: could not create {gem_dir}: {e}", file=sys.stderr)
+    return
+  if not already_there:
+    print(
+        "\n── GemCode · Project folder ready ──\n"
+        f"  Workspace: {root}\n"
+        f"  Config & session data: {gem_dir}/\n"
+        "  Optional: add GEMINI.md in the repo root for project context.\n"
+        "── Ready. ──\n",
+        file=sys.stderr,
+    )
+
+
 async def _run_prompt(
   cfg: GemCodeConfig, prompt: str, session_id: str, *, use_mcp: bool
 ) -> str:
@@ -122,6 +150,7 @@ async def _run_prompt(
   _maybe_prompt_trust(cfg)
   _maybe_prompt_google_api_key()
   require_google_api_key()
+  _initialize_gemcode_project(cfg)
   extra: list = []
   if use_mcp:
     from gemcode.mcp_loader import load_mcp_toolsets
@@ -153,6 +182,7 @@ async def _run_repl(cfg: GemCodeConfig, session_id: str, *, use_mcp: bool) -> No
   _maybe_prompt_trust(cfg)
   _maybe_prompt_google_api_key()
   require_google_api_key()
+  _initialize_gemcode_project(cfg)
   extra: list = []
   if use_mcp:
     from gemcode.mcp_loader import load_mcp_toolsets

{gemcode-0.3.0 → gemcode-0.3.2}/src/gemcode/tool_prompt_manifest.py

@@ -120,7 +120,7 @@ You may call tools as follows:
   Notes:
   - Prefer `python -m pip ...` (or `python3 -m pip ...`) so installs stay in the active virtualenv.
   - Do not assume sudo/system package manager access.
-  - `run_command` supports `cwd_subdir` (relative path under the project) instead of `cd`/`bash`; use `extra_env` (e.g. CI=1) for non-interactive installers; use `background=true` for long-running dev servers.
+  - `run_command` supports `cwd_subdir` (relative path under the project) instead of `cd`/`bash`; use parallel `extra_env_keys` / `extra_env_values` (e.g. ["CI"] and ["1"]) for non-interactive installers; use `background=true` for long-running dev servers.
 
 Optional capability tools:
 - Deep research built-ins are {'ON' if deep_research_on else 'OFF'}.

{gemcode-0.3.0 → gemcode-0.3.2}/src/gemcode/tools/shell.py

@@ -7,7 +7,6 @@ import re
 import shutil
 import subprocess
 from pathlib import Path
-from typing import Any
 
 from google.adk.tools.tool_context import ToolContext
 
@@ -18,12 +17,12 @@ from gemcode.tools.shell_gate import consume_confirmed_shell_if_matches
 from gemcode.trust import is_trusted_root
 
 
-def _merge_child_env(extra: dict[str, Any] | None) -> dict[str, str]:
-  """Merge a small set of env vars into os.environ for the child (e.g. CI=1)."""
+def _merge_child_env(keys: list[str], values: list[str]) -> dict[str, str]:
+  """Merge parallel key/value lists into os.environ (Gemini API rejects dict-typed tool params)."""
   out = {**os.environ}
-  if not extra:
+  if not keys and not values:
     return out
-  for k, v in extra.items():
+  for k, v in zip(keys, values):
     if not isinstance(k, str) or not isinstance(v, str):
       continue
     if not re.match(r"^[A-Za-z_][A-Za-z0-9_]*$", k):
@@ -45,7 +44,8 @@ def make_run_command(cfg: GemCodeConfig):
     tool_context: ToolContext | None = None,
     cwd_subdir: str = ".",
     background: bool = False,
-    extra_env: dict[str, str] | None = None,
+    extra_env_keys: list[str] | None = None,
+    extra_env_values: list[str] | None = None,
   ) -> dict:
     """
     Run an allowlisted executable with arguments.
@@ -57,8 +57,9 @@ def make_run_command(cfg: GemCodeConfig):
     For long-running servers (e.g. `npm run dev`), set `background=True` to start
     a detached process and return its PID (non-interactive; no TTY for the child).
 
-    Optional `extra_env` merges env vars for the child (e.g. {"CI": "1"} for
-    non-interactive scaffolding tools).
+    Optional `extra_env_keys` / `extra_env_values` are parallel lists (same length)
+    merged into the child environment (e.g. keys ["CI"], values ["1"] for
+    non-interactive scaffolding tools). Omit both to use the default environment.
     """
     if not trusted:
       return {"error": "Project folder is not trusted. Re-run GemCode and approve folder trust."}
@@ -111,7 +112,17 @@ def make_run_command(cfg: GemCodeConfig):
           )
       }
 
-    child_env = _merge_child_env(extra_env)
+    ek = list(extra_env_keys or [])
+    ev = list(extra_env_values or [])
+    if len(ek) != len(ev):
+      return {
+          "error": (
+              "extra_env_keys and extra_env_values must be parallel lists of the same length "
+              "(one value per key)."
+          ),
+      }
+
+    child_env = _merge_child_env(ek, ev)
 
     if background:
       try:

{gemcode-0.3.0 → gemcode-0.3.2}/src/gemcode/tui/app.py

@@ -303,7 +303,7 @@ async def run_gemcode_tui(
 
     tips = [
       "Tips for getting started",
-      "Run /init to create a .gemcode config",
+      "First run: trust folder, API key, then .gemcode/",
       "Note: Use perm=ask to approve tools",
     ]
     activity = ["Recent activity", "No recent activity"]

{gemcode-0.3.0 → gemcode-0.3.2}/src/gemcode/tui/scrollback.py

@@ -104,7 +104,7 @@ def _dashboard(cfg) -> str:
   ]
   right = [
     "Tips for getting started",
-    "Run /init to create a .gemcode file",
+    "First run creates .gemcode/ (trust + API key)",
     "",
     "Recent activity",
     "No recent activity",

{gemcode-0.3.0 → gemcode-0.3.2/src/gemcode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gemcode
-Version: 0.3.0
+Version: 0.3.2
 Summary: Local-first coding agent on Google Gemini + ADK
 Author: GemCode Contributors
 License:                                  Apache License

{gemcode-0.3.0 → gemcode-0.3.2}/src/gemcode.egg-info/SOURCES.txt

@@ -74,6 +74,7 @@ src/gemcode/web/terminal_repl.py
 tests/test_autocompact.py
 tests/test_capability_routing.py
 tests/test_claude_web_adapter_sse.py
+tests/test_cli_init.py
 tests/test_computer_use_permissions.py
 tests/test_context_budget.py
 tests/test_context_warning.py

gemcode-0.3.2/tests/test_cli_init.py

@@ -0,0 +1,22 @@
+"""First-run project initialization (.gemcode/)."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from gemcode.cli import _initialize_gemcode_project
+from gemcode.config import GemCodeConfig
+
+
+def test_initialize_gemcode_project_creates_dot_gemcode(tmp_path: Path) -> None:
+  cfg = GemCodeConfig(project_root=tmp_path)
+  assert not (tmp_path / ".gemcode").exists()
+  _initialize_gemcode_project(cfg)
+  assert (tmp_path / ".gemcode").is_dir()
+
+
+def test_initialize_gemcode_project_idempotent(tmp_path: Path) -> None:
+  cfg = GemCodeConfig(project_root=tmp_path)
+  _initialize_gemcode_project(cfg)
+  _initialize_gemcode_project(cfg)
+  assert (tmp_path / ".gemcode").is_dir()

{gemcode-0.3.0 → gemcode-0.3.2}/tests/test_tools.py

@@ -118,6 +118,24 @@ def test_run_command_background_returns_pid(tmp_path: Path, monkeypatch) -> None
   assert isinstance(out.get("pid"), int)
 
 
+def test_run_command_extra_env_merges(tmp_path: Path, monkeypatch) -> None:
+  monkeypatch.setenv("GEMCODE_HOME", str(tmp_path / ".gemstate"))
+  trust_root(tmp_path, trusted=True)
+  cfg = GemCodeConfig(project_root=tmp_path)
+  run_command = make_run_command(cfg)
+  ctx = MagicMock()
+  ctx.state = {HITL_STICKY_SESSION_KEY: True}
+  out = run_command(
+      "python3",
+      ["-c", "import os; print(os.environ.get('GEMCODE_TEST_EXTRA', ''))"],
+      extra_env_keys=["GEMCODE_TEST_EXTRA"],
+      extra_env_values=["ok"],
+      tool_context=ctx,
+  )
+  assert out.get("exit_code") == 0
+  assert "ok" in (out.get("stdout") or "")
+
+
 def test_delete_file(tmp_path: Path, monkeypatch) -> None:
   monkeypatch.setenv("GEMCODE_HOME", str(tmp_path / ".gemstate"))
   trust_root(tmp_path, trusted=True)