@pmaddire/gcie 0.1.2 → 0.1.4

package/README.md

@@ -49,7 +49,7 @@ cost of sending full repo surfaces to the model.
 Use this when you want a fast drop-in setup for coding agents.
 
 1. Install GCIE CLI in the target repo (via your preferred method: npm link, local wrapper, or direct Python module).
-2. Copy [AGENT_USAGE.md](c:\GBCRSS\AGENT_USAGE.md) into the target repo root.
+2. Copy [GCIE_USAGE.md](c:\GBCRSS\GCIE_USAGE.md) into the target repo root.
 3. Run one index pass:
    - `gcie.cmd index .`
 4. Start using adaptive retrieval immediately:
@@ -105,6 +105,7 @@ npx gcie@latest
 ```
 
 This runs `gcie setup .` in the current repo by default.
+If Python deps are missing, GCIE now bootstraps a local package venv and installs required runtime dependencies automatically on first run.
 
 Optional setup flags are passed through:
 

package/SETUP_ANY_REPO.md

@@ -43,7 +43,7 @@ Re-run indexing after major structural changes.
 
 ## 3) Add Agent Workflow File
 
-Copy `AGENT_USAGE.md` from GCIE into the target repo root.
+Copy `GCIE_USAGE.md` from GCIE into the target repo root.
 
 ## 4) Start With Portable Defaults
 
@@ -51,7 +51,7 @@ Copy `AGENT_USAGE.md` from GCIE into the target repo root.
 gcie.cmd context . "<task>" --intent <edit|debug|refactor|explore> --budget auto
 ```
 
-Then apply the adaptive loop in `AGENT_USAGE.md` if must-have coverage is incomplete.
+Then apply the adaptive loop in `GCIE_USAGE.md` if must-have coverage is incomplete.
 
 ## 5) Use Adaptive Mode Routing
 

package/bin/gcie.js

@@ -5,19 +5,36 @@ const { spawnSync } = require("child_process");
 const { existsSync } = require("fs");
 const { join, resolve, delimiter } = require("path");
 
-function resolvePython(gcieRoot) {
+function run(cmd, args, env, stdio = "inherit") {
+  return spawnSync(cmd, args, { stdio, env });
+}
+
+function resolveVenvPython(gcieRoot) {
   const winVenv = join(gcieRoot, ".venv", "Scripts", "python.exe");
   const nixVenv = join(gcieRoot, ".venv", "bin", "python");
-
   if (existsSync(winVenv)) return winVenv;
   if (existsSync(nixVenv)) return nixVenv;
-
   return null;
 }
 
-function tryCommand(cmd, args, env) {
-  const result = spawnSync(cmd, args, { stdio: "inherit", env });
-  return result.status === 0;
+function createVenv(gcieRoot, env) {
+  const venvDir = join(gcieRoot, ".venv");
+
+  let r = run("py", ["-3", "-m", "venv", venvDir], env, "pipe");
+  if (r.status === 0) return true;
+
+  r = run("python", ["-m", "venv", venvDir], env, "pipe");
+  return r.status === 0;
+}
+
+function installDeps(venvPython, env) {
+  const deps = ["typer", "networkx", "GitPython"];
+  const r = run(venvPython, ["-m", "pip", "install", "--disable-pip-version-check", "--quiet", ...deps], env);
+  return r.status === 0;
+}
+
+function runCli(pythonCmd, cliArgs, env) {
+  return run(pythonCmd, ["-m", "cli.app", ...cliArgs], env);
 }
 
 function main() {
@@ -30,16 +47,39 @@ function main() {
   const env = { ...process.env };
   env.PYTHONPATH = env.PYTHONPATH ? `${gcieRoot}${delimiter}${env.PYTHONPATH}` : gcieRoot;
 
-  const venvPython = resolvePython(gcieRoot);
-  if (venvPython) {
-    process.exit(spawnSync(venvPython, ["-m", "cli.app", ...cliArgs], { stdio: "inherit", env }).status || 0);
+  let venvPython = resolveVenvPython(gcieRoot);
+  if (!venvPython) {
+    console.error("[GCIE] No local venv found. Bootstrapping Python environment...");
+    if (!createVenv(gcieRoot, env)) {
+      console.error("No Python interpreter found. Install Python 3.11+ and retry.");
+      process.exit(1);
+    }
+    venvPython = resolveVenvPython(gcieRoot);
+    if (!venvPython) {
+      console.error("[GCIE] Failed to create .venv.");
+      process.exit(1);
+    }
+    if (!installDeps(venvPython, env)) {
+      console.error("[GCIE] Failed to install Python dependencies (typer, networkx, GitPython).");
+      process.exit(1);
+    }
   }
 
-  if (tryCommand("python", ["-m", "cli.app", ...cliArgs], env)) return;
-  if (tryCommand("py", ["-3", "-m", "cli.app", ...cliArgs], env)) return;
+  let result = runCli(venvPython, cliArgs, env);
+  if (result.status === 0) {
+    process.exit(0);
+  }
+
+  const stderr = (result.stderr || "").toString();
+  if (stderr.includes("No module named") || stderr.includes("ModuleNotFoundError")) {
+    console.error("[GCIE] Missing Python deps detected. Installing required dependencies...");
+    if (installDeps(venvPython, env)) {
+      result = runCli(venvPython, cliArgs, env);
+      process.exit(result.status || 0);
+    }
+  }
 
-  console.error("No Python interpreter found. Create a .venv in the GCIE repo or install Python 3.11+.");
-  process.exit(1);
+  process.exit(result.status || 1);
 }
 
 main();

package/cli/app.py

@@ -127,7 +127,7 @@ def context_slices_cmd(
 def setup_cmd(
     path: str = typer.Argument("."),
     force: bool = typer.Option(False, "--force", help="Overwrite existing setup files"),
-    no_agent_usage: bool = typer.Option(False, "--no-agent-usage", help="Do not copy AGENT_USAGE.md"),
+    no_agent_usage: bool = typer.Option(False, "--no-agent-usage", help="Do not copy GCIE_USAGE.md"),
     no_setup_doc: bool = typer.Option(False, "--no-setup-doc", help="Do not copy SETUP_ANY_REPO.md"),
     no_index: bool = typer.Option(False, "--no-index", help="Skip initial indexing pass"),
 ) -> None:

package/cli/commands/setup.py

@@ -1,73 +1,73 @@
-"""One-command repository setup for GCIE."""
-
-from __future__ import annotations
-
-from pathlib import Path
-
-from context.architecture_bootstrap import ensure_initialized
-
-from .index import run_index
-
-
-def _repo_root() -> Path:
-    return Path(__file__).resolve().parents[2]
-
-
-def _copy_if_needed(source: Path, target: Path, *, force: bool) -> str:
-    if not source.exists():
-        return "source_missing"
-    if target.exists() and not force:
-        return "skipped_existing"
-    target.parent.mkdir(parents=True, exist_ok=True)
-    target.write_text(source.read_text(encoding="utf-8"), encoding="utf-8")
-    return "written"
-
-
-def run_setup(
-    path: str,
-    *,
-    force: bool = False,
-    include_agent_usage: bool = True,
-    include_setup_doc: bool = True,
-    run_index_pass: bool = True,
-) -> dict:
-    """Initialize a repository so GCIE can be used immediately."""
-    target = Path(path).resolve()
-    target.mkdir(parents=True, exist_ok=True)
-
-    config = ensure_initialized(target)
-    gcie_dir = target / ".gcie"
-
-    status: dict[str, object] = {
-        "repo": target.as_posix(),
-        "gcie_dir": gcie_dir.as_posix(),
-        "architecture_initialized": True,
-        "files": {},
-    }
-
-    source_root = _repo_root()
-    copied: dict[str, str] = {}
-
-    if include_agent_usage:
-        copied["AGENT_USAGE.md"] = _copy_if_needed(
-            source_root / "AGENT_USAGE.md",
-            target / "AGENT_USAGE.md",
-            force=force,
-        )
-
-    if include_setup_doc:
-        copied["SETUP_ANY_REPO.md"] = _copy_if_needed(
-            source_root / "SETUP_ANY_REPO.md",
-            target / "SETUP_ANY_REPO.md",
-            force=force,
-        )
-
-    status["files"] = copied
-    status["context_config"] = config
-
-    if run_index_pass:
-        status["index"] = run_index(target.as_posix())
-    else:
-        status["index"] = {"skipped": True}
-
+"""One-command repository setup for GCIE."""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+from context.architecture_bootstrap import ensure_initialized
+
+from .index import run_index
+
+
+def _repo_root() -> Path:
+    return Path(__file__).resolve().parents[2]
+
+
+def _copy_if_needed(source: Path, target: Path, *, force: bool) -> str:
+    if not source.exists():
+        return "source_missing"
+    if target.exists() and not force:
+        return "skipped_existing"
+    target.parent.mkdir(parents=True, exist_ok=True)
+    target.write_text(source.read_text(encoding="utf-8"), encoding="utf-8")
+    return "written"
+
+
+def run_setup(
+    path: str,
+    *,
+    force: bool = False,
+    include_agent_usage: bool = True,
+    include_setup_doc: bool = True,
+    run_index_pass: bool = True,
+) -> dict:
+    """Initialize a repository so GCIE can be used immediately."""
+    target = Path(path).resolve()
+    target.mkdir(parents=True, exist_ok=True)
+
+    config = ensure_initialized(target)
+    gcie_dir = target / ".gcie"
+
+    status: dict[str, object] = {
+        "repo": target.as_posix(),
+        "gcie_dir": gcie_dir.as_posix(),
+        "architecture_initialized": True,
+        "files": {},
+    }
+
+    source_root = _repo_root()
+    copied: dict[str, str] = {}
+
+    if include_agent_usage:
+        copied["GCIE_USAGE.md"] = _copy_if_needed(
+            source_root / "GCIE_USAGE.md",
+            target / "GCIE_USAGE.md",
+            force=force,
+        )
+
+    if include_setup_doc:
+        copied["SETUP_ANY_REPO.md"] = _copy_if_needed(
+            source_root / "SETUP_ANY_REPO.md",
+            target / "SETUP_ANY_REPO.md",
+            force=force,
+        )
+
+    status["files"] = copied
+    status["context_config"] = config
+
+    if run_index_pass:
+        status["index"] = run_index(target.as_posix())
+    else:
+        status["index"] = {"skipped": True}
+
     return status

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmaddire/gcie",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "GraphCode Intelligence Engine one-command setup and context CLI",
   "bin": {
     "gcie": "bin/gcie.js",