spawn-cli 0.1.6__tar.gz → 0.1.8__tar.gz

{spawn_cli-0.1.6/src/spawn_cli.egg-info → spawn_cli-0.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawn-cli
-Version: 0.1.6
+Version: 0.1.8
 Summary: A minimal installable Python CLI package.
 License: MIT
 Classifier: License :: OSI Approved :: MIT License

{spawn_cli-0.1.6 → spawn_cli-0.1.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "spawn-cli"
-version = "0.1.6"
+version = "0.1.8"
 description = "A minimal installable Python CLI package."
 readme = "README.md"
 requires-python = ">=3.10"

{spawn_cli-0.1.6 → spawn_cli-0.1.8}/src/spawn_cli/cli.py

@@ -40,6 +40,15 @@ def build_parser() -> argparse.ArgumentParser:
         ),
     )
 
+    sub.add_parser(
+        "refresh",
+        help="Sync core config from defaults and rebuild IDE renders",
+        description=(
+            "Merge bundled defaults into spawn/.core/config.yaml, then refresh skills, MCP, "
+            "agent ignore, navigation, gitignore metadata, and IDE entry points."
+        ),
+    )
+
     rules_p = sub.add_parser(
         "rules",
         help="Rebuild navigation mandatory reads from spawn/rules/",
@@ -321,6 +330,9 @@ def _dispatch(args: argparse.Namespace, target_root: Path) -> int:
     with spawn_lock(target_root):
         if cmd == "rules":
             return _dispatch_rules(args, target_root)
+        if cmd == "refresh":
+            hl.refresh_repository(target_root)
+            return 0
         if cmd == "ide":
             return _dispatch_ide(args, target_root)
         if cmd == "extension":

{spawn_cli-0.1.6 → spawn_cli-0.1.8}/src/spawn_cli/core/high_level.py

@@ -222,6 +222,36 @@ def refresh_rules_navigation(target_root: Path) -> None:
     ll.save_rules_navigation(target_root)
 
 
+def refresh_repository(target_root: Path) -> None:
+    """Sync core config from package defaults and rebuild all IDE-facing metadata."""
+    _require_init(target_root)
+    ll.merge_core_config_from_defaults(target_root)
+    needs_skill = _any_extension_has_skill_files(target_root)
+    needs_mcp = _any_extension_has_mcp_servers(target_root)
+    for ide in ll.list_ides(target_root):
+        _warn_capability_gaps(
+            ide,
+            ide_get(ide).detect(target_root).capabilities,
+            needs_skill_render=needs_skill,
+            needs_mcp_merge=needs_mcp,
+        )
+    merged_any = False
+    for ide in ll.list_ides(target_root):
+        for ext in ll.list_extensions(target_root):
+            names = refresh_mcp(target_root, ide, ext, emit_mcp_merged_notice=False)
+            if names:
+                merged_any = True
+        _refresh_skills_all_extensions_for_ide(target_root, ide)
+    for ide in ll.list_ides(target_root):
+        refresh_agent_ignore(target_root, ide)
+    if merged_any:
+        print(MCP_MERGED_NOTICE)
+    refresh_gitignore(target_root)
+    refresh_navigation(target_root)
+    for ide in ll.list_ides(target_root):
+        refresh_entry_point(target_root, ide)
+
+
 def _refresh_extension_core(target_root: Path, extension: str) -> None:
     needs_skill = _any_extension_has_skill_files(target_root)
     needs_mcp = bool(ll.list_mcp(target_root, extension).servers)
@@ -536,6 +566,7 @@ __all__ = [
     "refresh_gitignore",
     "refresh_mcp",
     "refresh_navigation",
+    "refresh_repository",
     "refresh_rules_navigation",
     "refresh_skills",
     "reinstall_extension",

{spawn_cli-0.1.6 → spawn_cli-0.1.8}/src/spawn_cli/core/low_level.py

@@ -18,7 +18,7 @@ from spawn_cli.io.json_io import load_json
 from spawn_cli.io.paths import ensure_dir
 from spawn_cli.io.text_io import read_lines, write_lines
 from spawn_cli.io.yaml_io import configure_yaml_dump, load_yaml, save_yaml
-from spawn_cli.models.config import ExtensionConfig, FileMode, IdeList, ReadFlag
+from spawn_cli.models.config import CoreConfig, ExtensionConfig, FileMode, IdeList, ReadFlag
 from spawn_cli.models.mcp import McpCapabilities, McpEnvVar, McpServer, McpTransport, NormalizedMcp
 from spawn_cli.models.skill import SkillFileRef, SkillMetadata, SkillRawInfo
 
@@ -294,14 +294,59 @@ def _norm_read_path(path_str: str) -> str:
     return Path(path_str).as_posix().replace("\\", "/")
 
 
+def _navigation_rules_refs_from_section(section: Any) -> list[SkillFileRef]:
+    out: list[SkillFileRef] = []
+    if not isinstance(section, list):
+        return out
+    for grp in section:
+        if not isinstance(grp, dict):
+            continue
+        rules_raw = grp.get("rules")
+        if not isinstance(rules_raw, list):
+            continue
+        for entry in rules_raw:
+            if not isinstance(entry, dict):
+                continue
+            path_raw = entry.get("path")
+            if not isinstance(path_raw, str) or not path_raw.strip():
+                continue
+            desc_raw = entry.get("description")
+            desc = "" if desc_raw is None else str(desc_raw)
+            out.append(SkillFileRef(file=path_raw.strip(), description=desc))
+    return out
+
+
+def _navigation_yaml_rules_refs(target_root: Path) -> tuple[list[SkillFileRef], list[SkillFileRef]]:
+    """Return (read-required rules, read-contextual rules) from merged navigation.yaml."""
+    path = _spawn(target_root) / "navigation.yaml"
+    raw = load_yaml(path)
+    if not isinstance(raw, dict):
+        return [], []
+    rr = raw.get("read-required")
+    cq = raw.get("read-contextual")
+    return (
+        _navigation_rules_refs_from_section(rr if isinstance(rr, list) else []),
+        _navigation_rules_refs_from_section(cq if isinstance(cq, list) else []),
+    )
+
+
 def _required_read_description_for_path(
-    p: str, merged_global: list[SkillFileRef], local_req: list[SkillFileRef], cfg_ext: ExtensionConfig
+    p: str,
+    merged_global: list[SkillFileRef],
+    local_req: list[SkillFileRef],
+    cfg_ext: ExtensionConfig,
+    nav_rules_required: list[SkillFileRef] | None = None,
 ) -> str:
+    nk = _norm_read_path(p)
+    if nav_rules_required:
+        for r in nav_rules_required:
+            if _norm_read_path(r.file) == nk and r.description:
+                return r.description
     for r in merged_global:
-        if r.file == p and r.description:
+        if _norm_read_path(r.file) == nk and r.description:
             return r.description
     for r in local_req:
-        if r.file == p and r.description:
+        if _norm_read_path(r.file) == nk and r.description:
             return r.description
     return _describe_path(cfg_ext, p)
 
@@ -314,6 +359,7 @@ def generate_skills_metadata(target_root: Path, extension: str) -> list[SkillMet
     merged_global_auto = _flatten_global_refs_ordered(target_root, get_auto_read_global_all(target_root))
     local_required = get_required_read_ext_local(target_root, extension)
     local_auto = get_auto_read_local(target_root, extension)
+    nav_rules_required, nav_rules_contextual = _navigation_yaml_rules_refs(target_root)
 
     metas: list[SkillMetadata] = []
     for skill_path in list_skills(target_root, extension):
@@ -331,10 +377,19 @@ def generate_skills_metadata(target_root: Path, extension: str) -> list[SkillMet
                     continue
                 seen_norm.add(nk)
                 required_paths.append(fp)
+        for ref in nav_rules_required:
+            nk = _norm_read_path(ref.file)
+            if nk in seen_norm:
+                continue
+            seen_norm.add(nk)
+            required_paths.append(ref.file)
+
         required_out = [
             SkillFileRef(
                 file=p,
-                description=_required_read_description_for_path(p, merged_global_required, local_required, cfg_ext),
+                description=_required_read_description_for_path(
+                    p, merged_global_required, local_required, cfg_ext, nav_rules_required
+                ),
             )
             for p in required_paths
         ]
@@ -355,6 +410,12 @@ def generate_skills_metadata(target_root: Path, extension: str) -> list[SkillMet
                 continue
             seen_auto.add(key)
             auto_out.append(ar)
+        for ar in nav_rules_contextual:
+            key = _norm_read_path(ar.file)
+            if key in required_key_set or key in seen_auto:
+                continue
+            seen_auto.add(key)
+            auto_out.append(ar)
 
         metas.append(
             SkillMetadata(
@@ -451,8 +512,6 @@ def get_navigation_metadata(target_root: Path, extension: str) -> dict:
 
 def get_core_agent_ignore(target_root: Path) -> list[str]:
     path = _spawn(target_root) / ".core" / "config.yaml"
-    from spawn_cli.models.config import CoreConfig
-
     data = load_yaml(path)
     if not data:
         return []
@@ -460,6 +519,47 @@ def get_core_agent_ignore(target_root: Path) -> list[str]:
     return list(core.agent_ignore)
 
 
+def merge_core_config_from_defaults(target_root: Path) -> None:
+    """Merge bundled default core config into ``spawn/.core/config.yaml``.
+
+    ``version`` becomes the bundled default. ``agent-ignore`` is the bundled
+    list (in resource order) followed by any existing patterns not present in
+    the default set.
+    """
+    path = _spawn(target_root) / ".core" / "config.yaml"
+    if not path.is_file():
+        raise SpawnError("spawn/.core/config.yaml is missing; run spawn init.")
+    bundled_txt = (
+        resources.files("spawn_cli.resources")
+        .joinpath("default_core_config.yaml")
+        .read_text(encoding="utf-8")
+    )
+    yparse = YAML(typ="safe")
+    raw_default = yparse.load(bundled_txt)
+    if not isinstance(raw_default, dict):
+        raise SpawnError("internal error: bundled default core config is not a mapping")
+    try:
+        default_core = CoreConfig.model_validate(raw_default)
+    except Exception as e:
+        raise SpawnError(f"internal error: bundled default core config invalid: {e}") from e
+    raw_existing = load_yaml(path)
+    if not raw_existing:
+        raise SpawnError(
+            "spawn/.core/config.yaml is empty or invalid; restore it or run spawn init again."
+        )
+    try:
+        current = CoreConfig.model_validate(raw_existing)
+    except Exception as e:
+        raise SpawnError(f"invalid spawn/.core/config.yaml: {e}") from e
+    default_set = set(default_core.agent_ignore)
+    merged_ignore = list(default_core.agent_ignore)
+    for g in current.agent_ignore:
+        if g not in default_set:
+            merged_ignore.append(g)
+    out = CoreConfig(version=default_core.version, agent_ignore=merged_ignore)
+    save_yaml(path, out.model_dump(by_alias=True))
+
+
 def get_ext_agent_ignore(target_root: Path, extension: str) -> list[str]:
     cfg = _load_ext_config(target_root, extension)
     return list(cfg.agent_ignore)
@@ -890,6 +990,7 @@ __all__ = [
     "list_ides",
     "list_mcp",
     "list_skills",
+    "merge_core_config_from_defaults",
     "METADATA_TEMP_MAX_AGE_SECONDS",
     "normalize_skill_name",
     "prune_metadata_temp",

{spawn_cli-0.1.6 → spawn_cli-0.1.8/src/spawn_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spawn-cli
-Version: 0.1.6
+Version: 0.1.8
 Summary: A minimal installable Python CLI package.
 License: MIT
 Classifier: License :: OSI Approved :: MIT License

{spawn_cli-0.1.6 → spawn_cli-0.1.8}/tests/test_cli.py

@@ -88,6 +88,28 @@ def test_spawn_rules_refresh(tmp_path, monkeypatch):
     mock_refresh.assert_called_once_with(root)
 
 
+def test_spawn_refresh(tmp_path, monkeypatch):
+    monkeypatch.chdir(tmp_path)
+    from spawn_cli.core import low_level as ll
+
+    ll.init(tmp_path)
+    root = tmp_path.resolve()
+    mock_repo = MagicMock()
+
+    with patch("spawn_cli.cli.spawn_lock", _noop_lock), patch(
+        "spawn_cli.cli.hl.refresh_repository", mock_repo
+    ):
+        assert main(["refresh"]) == 0
+
+    mock_repo.assert_called_once_with(root)
+
+
+def test_spawn_refresh_need_init(tmp_path, monkeypatch, capsys):
+    monkeypatch.chdir(tmp_path)
+    assert main(["refresh"]) == 1
+    assert "need init before" in capsys.readouterr().err
+
+
 def test_spawn_ide_list_supported_ides(tmp_path, monkeypatch, capsys):
     monkeypatch.chdir(tmp_path)
     (tmp_path / "spawn").mkdir()