gaia-cli 4.3.6__tar.gz → 4.3.8__tar.gz

{gaia_cli-4.3.6/src/gaia_cli.egg-info → gaia_cli-4.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gaia-cli
-Version: 4.3.6
+Version: 4.3.8
 Summary: Gaia AI Agent Skill Registry CLI
 Author: Gaia contributors
 License: MIT
@@ -167,7 +167,7 @@ Skills rank up through **verifiable evidence** (Class A/B/C) and can be demoted
 **1. Install the CLI**
 
 <!-- gaia:version-start -->
-Current Gaia CLI version: `4.3.6`.
+Current Gaia CLI version: `4.3.8`.
 
 ```bash
 curl -fsSL https://gaia.tiongson.co/install.sh | sh
@@ -212,6 +212,8 @@ packaging-specific tests are skipped locally with guidance to install developer
 
 ```bash
 gaia init --user your-username
+# Detected repo: your-username/your-repo
+# Initialize Gaia on this repository? [Y/n]: Y
 gaia scan
 ```
 
@@ -221,9 +223,11 @@ Detects skills your agent demonstrates.
 
 ```bash
 gaia push
+# Push skills to gaia registry from your-username/your-repo? [Y/n]: Y
 ```
 
 A GitHub issue opens automatically. Maintainers review and promote; your name attaches at 2★.
+If no remote is detected, Gaia will guide you to add one.
 
 **4. Bond your agent (optional)**
 

{gaia_cli-4.3.6 → gaia_cli-4.3.8}/README.md

@@ -118,7 +118,7 @@ Skills rank up through **verifiable evidence** (Class A/B/C) and can be demoted
 **1. Install the CLI**
 
 <!-- gaia:version-start -->
-Current Gaia CLI version: `4.3.6`.
+Current Gaia CLI version: `4.3.8`.
 
 ```bash
 curl -fsSL https://gaia.tiongson.co/install.sh | sh
@@ -163,6 +163,8 @@ packaging-specific tests are skipped locally with guidance to install developer
 
 ```bash
 gaia init --user your-username
+# Detected repo: your-username/your-repo
+# Initialize Gaia on this repository? [Y/n]: Y
 gaia scan
 ```
 
@@ -172,9 +174,11 @@ Detects skills your agent demonstrates.
 
 ```bash
 gaia push
+# Push skills to gaia registry from your-username/your-repo? [Y/n]: Y
 ```
 
 A GitHub issue opens automatically. Maintainers review and promote; your name attaches at 2★.
+If no remote is detected, Gaia will guide you to add one.
 
 **4. Bond your agent (optional)**
 

{gaia_cli-4.3.6 → gaia_cli-4.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "gaia-cli"
-version = "4.3.6"
+version = "4.3.8"
 description = "Gaia AI Agent Skill Registry CLI"
 readme = "README.md"
 requires-python = ">=3.10"

{gaia_cli-4.3.6 → gaia_cli-4.3.8}/src/gaia_cli/graph.py

@@ -39,6 +39,11 @@ def _registry_root(registry_path: str | os.PathLike[str]) -> Path:
 
 def load_graph(registry_path: str | os.PathLike[str] = ".") -> dict[str, Any]:
     graph_path = Path(registry_graph_path(_registry_root(registry_path)))
+    if not graph_path.exists():
+        raise FileNotFoundError(
+            f"Registry graph not found at {graph_path}. "
+            "Run gaia init from a gaia-skill-tree clone."
+        )
     with graph_path.open("r", encoding="utf-8") as f:
         return json.load(f)
 
@@ -1204,7 +1209,11 @@ def graph_command(args: Any) -> None:
     except Exception:
         pass  # Degrade gracefully to canon mode
 
-    out_path = write_graph_artifact(registry_path, output=output, fmt=fmt, user_ctx=user_ctx)
+    try:
+        out_path = write_graph_artifact(registry_path, output=output, fmt=fmt, user_ctx=user_ctx)
+    except FileNotFoundError as exc:
+        print(str(exc), file=sys.stderr)
+        return
     print(f"  saved {out_path}")
 
     # Regenerate the GEXF from current node data

{gaia_cli-4.3.6 → gaia_cli-4.3.8}/src/gaia_cli/main.py

@@ -14,7 +14,7 @@ from gaia_cli.resolver import resolve_skills
 from gaia_cli.combinator import get_combinations
 from gaia_cli.treeManager import load_tree, save_tree, show_status, show_tree
 from gaia_cli.prWriter import open_pr, open_intake_issue
-from gaia_cli.push import build_skill_batch, write_skill_batch, build_proposed_skill, detect_source_repo
+from gaia_cli.push import build_skill_batch, write_skill_batch, build_proposed_skill, detect_source_repo, NonPublicRepoError
 from gaia_cli.embeddings import generate_embeddings
 from gaia_cli.semantic_search import search as semantic_search, load_embeddings
 from gaia_cli.name import find_awakened_skill, promote_to_named, update_batch_lifecycle
@@ -321,6 +321,29 @@ def init_command(args):
     print(f"  user:       {username}")
     print(f"  scanPaths:  {scan_paths}")
 
+    try:
+        source = detect_source_repo({"gaiaUser": username})
+        if sys.stdin.isatty() and not getattr(args, 'yes', False):
+            try:
+                ans = input(f"Detected repo: {source}\nInitialize Gaia on this repository? [Y/n]: ").strip().lower()
+            except (KeyboardInterrupt, EOFError):
+                print()
+                import shutil; shutil.rmtree(config_dir, ignore_errors=True)
+                sys.exit(1)
+            if ans == 'n':
+                import shutil; shutil.rmtree(config_dir, ignore_errors=True)
+                print("Aborted.")
+                return
+    except NonPublicRepoError:
+        print(
+            "\nNo GitHub remote detected in this directory.\n"
+            "  → To unlock the full workflow:\n"
+            "     • Add a remote:  git remote add origin https://github.com/<you>/<repo>\n"
+            "     • Or clone the gaia-skill-tree registry and run gaia init there\n"
+            "Your skills are still scannable and pushable — once linked to a public repo,\n"
+            "approved skills will start at 2★ instead of 1★.\n"
+        )
+
     # If we're inside a registry clone, register its path globally so that
     # commands like `gaia push` work from any project without --registry.
     tree_path = user_tree_path(".", username)
@@ -358,6 +381,11 @@ def scan_command(args):
     scan_result = scan_repo_detailed()
     raw_tokens = {t.lstrip('/') for t in scan_result["tokens"]}
     graph_path = registry_graph_path(args.registry)
+
+    from gaia_cli.registry import bundled_registry_path
+    if not quiet and not use_json and str(args.registry) == str(bundled_registry_path()):
+        print("Note: using bundled registry (no local registry clone found).")
+
     resolved = resolve_skills(raw_tokens, registry_path=graph_path)
     
     username = config.get('gaiaUser')
@@ -387,6 +415,9 @@ def scan_command(args):
         if resolved:
             # Colored skill list with type glyphs
             graph_path_file = registry_graph_path(args.registry)
+            if not os.path.exists(graph_path_file):
+                print("Registry graph not found. Run `gaia init` from a gaia-skill-tree clone.")
+                return
             with open(graph_path_file, 'r', encoding='utf-8') as gf:
                 gdata = json.load(gf)
             smap = {s['id']: s for s in gdata.get('skills', [])}
@@ -769,7 +800,11 @@ def promote_command(args):
 
     tree = load_tree(username, registry_path=args.registry)
     if not tree:
-        print(f"No skill tree found for user '{username}'.")
+        if not os.path.exists(promotion_candidates_path(args.registry)):
+            print("No promotion candidates found. Run `gaia scan` first to detect skills.",
+                  file=sys.stderr)
+        else:
+            print(f"No skill tree found for user '{username}'.", file=sys.stderr)
         return
 
     skill_id = getattr(args, 'skillId', None)
@@ -803,7 +838,12 @@ def promote_command(args):
                 if picked:
                     skill_id = picked
             if not skill_id:
-                print("Usage: gaia promote <skill> or gaia promote --all", file=sys.stderr)
+                from gaia_cli.registry import promotion_candidates_path
+                if not os.path.exists(promotion_candidates_path(args.registry)):
+                    print("No promotion candidates found. Run `gaia scan` first to detect skills.",
+                          file=sys.stderr)
+                else:
+                    print("Usage: gaia promote <skill> or gaia promote --all", file=sys.stderr)
                 sys.exit(2)
         result = promote_from_candidates(username, skill_id, args.registry, new_display_name=display_name)
     except ValueError as exc:
@@ -1020,6 +1060,12 @@ def tree_command(args):
     show_tree(tree, graph_data=graph_data, registry_path=args.registry, mode=mode, canon=canon)
     if tree:
         render_user_tree_outputs(config.get('gaiaUser'), tree, graph_data, args.registry, quiet=False)
+    try:
+        detect_source_repo(config)
+    except NonPublicRepoError:
+        print("\nTip: link a public GitHub repo and approved skills will start at 2★ once named.")
+    except Exception:
+        pass
 
 def fuse_command(args):
     config = load_config()
@@ -1160,7 +1206,29 @@ def push_command(args):
         sys.exit(1)
 
     raw_tokens = scan_repo()
-    batch = build_skill_batch(raw_tokens, config, args.registry)
+    try:
+        batch = build_skill_batch(raw_tokens, config, args.registry)
+        source_repo = batch["sourceRepo"]
+        if sys.stdin.isatty() and not getattr(args, 'yes', False):
+            try:
+                ans = input(f"Push skills to gaia registry from {source_repo}? [Y/n]: ").strip().lower()
+            except (KeyboardInterrupt, EOFError):
+                print()
+                sys.exit(1)
+            if ans == 'n':
+                print("Aborted.")
+                return
+    except NonPublicRepoError as exc:
+        print(
+            "\nYour skills are ready for review!\n"
+            "Skills pushed from outside a public GitHub repo start at 1★ in the registry.\n"
+            "Once you link a public repo, approved skills will start at 2★ instead.\n"
+            "  → Add a remote:  git remote add origin https://github.com/<you>/<repo>\n",
+            file=sys.stderr,
+        )
+        username_fallback = str(exc)
+        batch = build_skill_batch(raw_tokens, config, args.registry,
+                                  source_repo=f"{username_fallback}/local-repo")
 
     # Guard 1: check if empty initially
     if not batch.get("proposedSkills") and not batch.get("knownSkills"):
@@ -1689,6 +1757,7 @@ def get_parser():
     push_parser.add_argument('--dry-run', action='store_true', help="Print the skill batch without writing it")
     push_parser.add_argument('--no-issue', action='store_true', dest='no_issue', help="Write intake record without creating a GitHub issue")
     push_parser.add_argument('--no-pr', action='store_true', dest='no_issue', help=argparse.SUPPRESS)  # backward compat alias
+    push_parser.add_argument('--yes', '-y', action='store_true', dest='yes', help="Skip confirmation prompts")
     propose_parser = subparsers.add_parser('propose', help="Propose a single canonical skill as a named PR")
     propose_parser.add_argument('skillId', help="Canonical skill ID (accepts /skill-id form)")
     propose_parser.add_argument('--target', help="Named skill target in contributor/skill-name format")

{gaia_cli-4.3.6 → gaia_cli-4.3.8}/src/gaia_cli/push.py

@@ -15,6 +15,12 @@ from gaia_cli.registry import registry_graph_path, skill_batches_dir
 
 
 SKILL_ID_RE = re.compile(r"^[a-z][a-z0-9]*(-[a-z0-9]+)*$")
+
+
+class NonPublicRepoError(RuntimeError):
+    """Raised when no public GitHub remote is detected for the working directory."""
+
+
 MIN_PROPOSED_TOKEN_LENGTH = 3
 PROPOSED_STOPWORDS = {
     "a", "an", "and", "are", "as", "at", "be", "by", "for", "from", "in", "is", "it", "of", "on", "or", "that", "the", "to", "was", "were", "with", "already",
@@ -68,7 +74,7 @@ def detect_source_repo(config):
         if host == "github.com" or host.endswith(".github.com"):
             return parsed.path.lstrip("/")
 
-    return f"{config.get('gaiaUser', 'unknown')}/local-repo"
+    raise NonPublicRepoError(config.get('gaiaUser', 'unknown'))
 
 
 def build_proposed_skill(skill_id, source_repo):
@@ -126,11 +132,12 @@ def filter_proposed_ids(valid_tokens, canonical_ids):
     return filtered
 
 
-def build_skill_batch(raw_tokens, config, registry_root, now=None):
+def build_skill_batch(raw_tokens, config, registry_root, now=None, source_repo=None):
     graph_path = registry_graph_path(registry_root)
     canonical_ids = load_canonical_skills(graph_path)
     canonical_map = load_canonical_skill_map(graph_path)
-    source_repo = detect_source_repo(config)
+    if source_repo is None:
+        source_repo = detect_source_repo(config)
     timestamp = now or datetime.now(timezone.utc)
     generated_at = timestamp.replace(microsecond=0).isoformat().replace("+00:00", "Z")
 

{gaia_cli-4.3.6 → gaia_cli-4.3.8}/src/gaia_cli/registry.py

@@ -6,7 +6,7 @@ from importlib import resources
 from pathlib import Path
 
 
-WRITE_COMMANDS = {"push", "propose", "name", "fuse", "embed", "sync", "promote", "graph", "release", "docs", "merge", "split", "add", "evidence"}
+WRITE_COMMANDS = {"push", "propose", "name", "fuse", "embed", "sync", "promote", "release", "docs", "merge", "split", "add", "evidence"}
 
 
 def _gaia_home_dir() -> Path:

{gaia_cli-4.3.6 → gaia_cli-4.3.8/src/gaia_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gaia-cli
-Version: 4.3.6
+Version: 4.3.8
 Summary: Gaia AI Agent Skill Registry CLI
 Author: Gaia contributors
 License: MIT
@@ -167,7 +167,7 @@ Skills rank up through **verifiable evidence** (Class A/B/C) and can be demoted
 **1. Install the CLI**
 
 <!-- gaia:version-start -->
-Current Gaia CLI version: `4.3.6`.
+Current Gaia CLI version: `4.3.8`.
 
 ```bash
 curl -fsSL https://gaia.tiongson.co/install.sh | sh
@@ -212,6 +212,8 @@ packaging-specific tests are skipped locally with guidance to install developer
 
 ```bash
 gaia init --user your-username
+# Detected repo: your-username/your-repo
+# Initialize Gaia on this repository? [Y/n]: Y
 gaia scan
 ```
 
@@ -221,9 +223,11 @@ Detects skills your agent demonstrates.
 
 ```bash
 gaia push
+# Push skills to gaia registry from your-username/your-repo? [Y/n]: Y
 ```
 
 A GitHub issue opens automatically. Maintainers review and promote; your name attaches at 2★.
+If no remote is detected, Gaia will guide you to add one.
 
 **4. Bond your agent (optional)**
 

gaia_cli-4.3.8/tests/test_evidence_inheritance.py

@@ -0,0 +1,97 @@
+"""Tests for the rank-less generic / inherited-evidence model."""
+
+import json
+import os
+import sys
+import unittest
+
+sys.path.insert(
+    0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "src"))
+)
+
+from gaia_cli.evidence import (
+    inherited_evidence,
+    merge_evidence,
+    build_generic_evidence_map,
+)
+
+REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+
+
+class TestInheritedEvidence(unittest.TestCase):
+    def test_named_inherits_generic_capability_evidence(self):
+        generic = {
+            "id": "automated-testing",
+            "evidence": [
+                {"class": "A", "source": "https://arxiv.org/abs/0001"},
+            ],
+        }
+        named = {
+            "id": "x/pytest",
+            "evidence": [
+                {"class": "C", "source": "https://github.com/x/pytest"},
+            ],
+        }
+        pool = inherited_evidence(named, generic)
+        sources = {e["source"] for e in pool}
+        self.assertEqual(
+            sources, {"https://arxiv.org/abs/0001", "https://github.com/x/pytest"}
+        )
+
+    def test_merge_evidence_edge_cases(self):
+        self.assertEqual(merge_evidence(), [])
+        self.assertEqual(merge_evidence(None, None), [])
+        self.assertEqual(merge_evidence([], []), [])
+        self.assertEqual(merge_evidence([{}], [{}]), [{}])
+        self.assertEqual(
+            merge_evidence(
+                None, [{"source": "s1"}], [], [{"source": "s1"}, {"source": "s2"}]
+            ),
+            [{"source": "s1"}, {"source": "s2"}],
+        )
+
+    def test_dedup_by_source(self):
+        shared = {"class": "A", "source": "https://arxiv.org/abs/0001"}
+        pool = merge_evidence([shared], [dict(shared)])
+        self.assertEqual(len(pool), 1)
+
+    def test_no_generic_evidence(self):
+        named = {"id": "x/y", "evidence": [{"class": "C", "source": "s"}]}
+        self.assertEqual(len(inherited_evidence(named, None)), 1)
+
+    def test_build_generic_evidence_map(self):
+        skills = [{"id": "a", "evidence": [{"source": "s"}]}, {"id": "b"}]
+        m = build_generic_evidence_map(skills)
+        self.assertEqual(m["a"], [{"source": "s"}])
+        self.assertEqual(m["b"], [])
+
+
+class TestRanklessGenerics(unittest.TestCase):
+    def test_no_generic_node_has_level_or_demerits(self):
+        graph = json.load(
+            open(os.path.join(REPO_ROOT, "registry", "gaia.json"), encoding="utf-8")
+        )
+        bad = [
+            s["id"]
+            for s in graph["skills"]
+            if "level" in s or "demerits" in s or "realVariants" in s
+        ]
+        self.assertEqual(bad, [], f"Generic refs must be rank-less; offenders: {bad}")
+
+    def test_named_skills_retain_levels(self):
+        idx = json.load(
+            open(
+                os.path.join(REPO_ROOT, "registry", "named-skills.json"),
+                encoding="utf-8",
+            )
+        )
+        valid = {"1★", "2★", "3★", "4★", "5★", "6★"}
+        for entries in idx["buckets"].values():
+            for e in entries:
+                self.assertIn(
+                    e["level"], valid, f"{e['id']} has invalid level {e['level']}"
+                )
+
+
+if __name__ == "__main__":
+    unittest.main()

{gaia_cli-4.3.6 → gaia_cli-4.3.8}/tests/test_workflows.py

@@ -4,7 +4,6 @@ import unittest
 
 REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 AUTO_TRIAGE_PATH = os.path.join(REPO_ROOT, ".github", "workflows", "auto-triage.yml")
-DOCS_REMINDER_PATH = os.path.join(REPO_ROOT, ".github", "workflows", "pr-docs-reminder.yml")
 BRANCH_SCOPE_PATH = os.path.join(REPO_ROOT, ".github", "workflows", "branch-scope.yml")
 
 
@@ -25,21 +24,11 @@ class TestWorkflowConfig(unittest.TestCase):
         with open(BRANCH_SCOPE_PATH, "r", encoding="utf-8") as f:
             content = f.read()
 
-        self.assertIn("unrestricted branches (dev/*, claude/*, codex/*, chore/*) have no forward restriction", content)
+        self.assertIn("unrestricted branches (dev/*, claude/*, codex/*, gemini/*, chore/*) have no forward restriction", content)
         self.assertIn('[ "$PREFIX" != "unrestricted" ]', content)
         self.assertIn("skip-scope-check", content)
         self.assertNotIn("!startsWith(github.head_ref || '', 'dev/')", content)
 
-    def test_pr_docs_reminder_shows_copyable_docs_check(self):
-        with open(DOCS_REMINDER_PATH, "r", encoding="utf-8") as f:
-            content = f.read()
-
-        self.assertIn("pull_request:", content)
-        self.assertIn("Repo Docs Before PR reminder", content)
-        self.assertIn("python scripts/build_docs.py --check", content)
-        self.assertIn("GITHUB_STEP_SUMMARY", content)
-        self.assertNotIn("actions/checkout", content)
-
 
 if __name__ == "__main__":
     unittest.main()

gaia_cli-4.3.6/tests/test_evidence_inheritance.py

@@ -1,62 +0,0 @@
-"""Tests for the rank-less generic / inherited-evidence model."""
-
-import json
-import os
-import sys
-import unittest
-
-sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "src")))
-
-from gaia_cli.evidence import (
-    inherited_evidence,
-    merge_evidence,
-    build_generic_evidence_map,
-)
-
-REPO_ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
-
-
-class TestInheritedEvidence(unittest.TestCase):
-    def test_named_inherits_generic_capability_evidence(self):
-        generic = {"id": "automated-testing", "evidence": [
-            {"class": "A", "source": "https://arxiv.org/abs/0001"},
-        ]}
-        named = {"id": "x/pytest", "evidence": [
-            {"class": "C", "source": "https://github.com/x/pytest"},
-        ]}
-        pool = inherited_evidence(named, generic)
-        sources = {e["source"] for e in pool}
-        self.assertEqual(sources, {"https://arxiv.org/abs/0001", "https://github.com/x/pytest"})
-
-    def test_dedup_by_source(self):
-        shared = {"class": "A", "source": "https://arxiv.org/abs/0001"}
-        pool = merge_evidence([shared], [dict(shared)])
-        self.assertEqual(len(pool), 1)
-
-    def test_no_generic_evidence(self):
-        named = {"id": "x/y", "evidence": [{"class": "C", "source": "s"}]}
-        self.assertEqual(len(inherited_evidence(named, None)), 1)
-
-    def test_build_generic_evidence_map(self):
-        skills = [{"id": "a", "evidence": [{"source": "s"}]}, {"id": "b"}]
-        m = build_generic_evidence_map(skills)
-        self.assertEqual(m["a"], [{"source": "s"}])
-        self.assertEqual(m["b"], [])
-
-
-class TestRanklessGenerics(unittest.TestCase):
-    def test_no_generic_node_has_level_or_demerits(self):
-        graph = json.load(open(os.path.join(REPO_ROOT, "registry", "gaia.json"), encoding="utf-8"))
-        bad = [s["id"] for s in graph["skills"] if "level" in s or "demerits" in s or "realVariants" in s]
-        self.assertEqual(bad, [], f"Generic refs must be rank-less; offenders: {bad}")
-
-    def test_named_skills_retain_levels(self):
-        idx = json.load(open(os.path.join(REPO_ROOT, "registry", "named-skills.json"), encoding="utf-8"))
-        valid = {"1★", "2★", "3★", "4★", "5★", "6★"}
-        for entries in idx["buckets"].values():
-            for e in entries:
-                self.assertIn(e["level"], valid, f"{e['id']} has invalid level {e['level']}")
-
-
-if __name__ == "__main__":
-    unittest.main()