spawn-cli 0.1.1__py3-none-any.whl

spawn_cli/io/yaml_io.py

@@ -0,0 +1,32 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from ruamel.yaml import YAML
+
+
+def configure_yaml_dump(yaml: YAML) -> None:
+    """Force block-style collections for dumps (avoid flow `{ ... }` / `[ ... ]` on nested nodes)."""
+
+    yaml.default_flow_style = False
+    yaml.width = 4096
+    yaml.sort_base_mapping_type_on_output = False
+
+
+def load_yaml(path: Path) -> dict:
+    if not path.is_file():
+        return {}
+    yaml = YAML(typ="safe")
+    with path.open("r", encoding="utf-8") as fh:
+        data = yaml.load(fh)
+    return data if isinstance(data, dict) else {}
+
+
+def save_yaml(path: Path, data: dict) -> None:
+    from spawn_cli.io.paths import ensure_dir
+
+    ensure_dir(path.parent)
+    yaml = YAML(typ="safe")
+    configure_yaml_dump(yaml)
+    with path.open("w", encoding="utf-8") as fh:
+        yaml.dump(data, fh)

spawn_cli/models/__init__.py

@@ -0,0 +1,63 @@
+from spawn_cli.models.config import (
+    CoreConfig,
+    ExtensionConfig,
+    ExtensionFileEntry,
+    ExtensionFolderEntry,
+    ExtensionsMeta,
+    FileMode,
+    IdeList,
+    ReadFlag,
+    SetupConfig,
+    SkillEntry,
+    SourceYaml,
+)
+from spawn_cli.models.mcp import (
+    McpCapabilities,
+    McpEnvVar,
+    McpServer,
+    McpTransport,
+    NormalizedMcp,
+)
+from spawn_cli.models.metadata import (
+    RenderedMcpEntry,
+    RenderedMcpMeta,
+    RenderedSkillEntry,
+    RenderedSkillsMeta,
+)
+from spawn_cli.models.navigation import (
+    NavExtGroup,
+    NavFile,
+    NavRulesGroup,
+    NavigationFile,
+)
+from spawn_cli.models.skill import SkillFileRef, SkillMetadata, SkillRawInfo
+
+__all__ = [
+    "CoreConfig",
+    "ExtensionConfig",
+    "ExtensionFileEntry",
+    "ExtensionFolderEntry",
+    "ExtensionsMeta",
+    "FileMode",
+    "IdeList",
+    "ReadFlag",
+    "SetupConfig",
+    "SkillEntry",
+    "SourceYaml",
+    "McpCapabilities",
+    "McpEnvVar",
+    "McpServer",
+    "McpTransport",
+    "NormalizedMcp",
+    "RenderedMcpEntry",
+    "RenderedMcpMeta",
+    "RenderedSkillEntry",
+    "RenderedSkillsMeta",
+    "NavExtGroup",
+    "NavFile",
+    "NavRulesGroup",
+    "NavigationFile",
+    "SkillFileRef",
+    "SkillMetadata",
+    "SkillRawInfo",
+]

spawn_cli/models/config.py

@@ -0,0 +1,111 @@
+from __future__ import annotations
+
+from enum import Enum
+from typing import Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class FileMode(str, Enum):
+    static = "static"
+    artifact = "artifact"
+
+
+class ReadFlag(str, Enum):
+    required = "required"
+    auto = "auto"
+    no = "no"
+
+
+class ExtensionFileEntry(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    description: Optional[str] = None
+    mode: FileMode = FileMode.static
+    globalRead: ReadFlag = ReadFlag.no
+    localRead: ReadFlag = ReadFlag.no
+
+
+class ExtensionFolderEntry(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    mode: FileMode = FileMode.static
+
+
+class SkillEntry(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    name: Optional[str] = None
+    description: Optional[str] = None
+    required_read: list[str] = Field(default_factory=list, alias="required-read")
+
+
+class SetupConfig(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    before_install: Optional[str] = Field(None, alias="before-install")
+    after_install: Optional[str] = Field(None, alias="after-install")
+    before_uninstall: Optional[str] = Field(None, alias="before-uninstall")
+    after_uninstall: Optional[str] = Field(None, alias="after-uninstall")
+    healthcheck: Optional[str] = None
+
+
+class ExtensionConfig(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    name: Optional[str] = None
+    version: str
+    schema_version: int = Field(1, alias="schema")
+    files: dict[str, ExtensionFileEntry] = Field(default_factory=dict)
+    folders: dict[str, ExtensionFolderEntry] = Field(default_factory=dict)
+    agent_ignore: list[str] = Field(default_factory=list, alias="agent-ignore")
+    git_ignore: list[str] = Field(default_factory=list, alias="git-ignore")
+    skills: dict[str, SkillEntry] = Field(default_factory=dict)
+    setup: Optional[SetupConfig] = None
+
+
+class CoreConfig(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    version: str
+    agent_ignore: list[str] = Field(default_factory=list, alias="agent-ignore")
+
+
+class IdeList(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    ides: list[str] = Field(default_factory=list)
+
+
+class SourceYaml(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    class SourceInfo(BaseModel):
+        model_config = ConfigDict(populate_by_name=True)
+
+        type: str
+        path: str
+        branch: Optional[str] = None
+        resolved: Optional[str] = None
+
+    class InstalledInfo(BaseModel):
+        model_config = ConfigDict(populate_by_name=True)
+
+        version: str
+        installedAt: str
+
+    extension: str
+    source: SourceInfo
+    installed: InstalledInfo
+
+
+class ExtensionsMeta(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    class ExtEntry(BaseModel):
+        model_config = ConfigDict(populate_by_name=True)
+
+        path: str
+        branch: Optional[str] = None
+
+    extensions: list[ExtEntry] = Field(default_factory=list)

spawn_cli/models/mcp.py

@@ -0,0 +1,49 @@
+from __future__ import annotations
+
+from typing import Optional
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class McpEnvVar(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    source: str = "user"
+    required: bool = True
+    secret: bool = False
+    value: Optional[str] = None
+
+
+class McpCapabilities(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    tools: bool = True
+    resources: bool = False
+    prompts: bool = False
+
+
+class McpTransport(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    type: str
+    command: Optional[str] = None
+    args: list[str] = Field(default_factory=list)
+    cwd: str = "."
+    url: Optional[str] = None
+    headers: dict[str, str] = Field(default_factory=dict)
+
+
+class McpServer(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    name: str
+    extension: str
+    transport: McpTransport
+    env: dict[str, McpEnvVar] = Field(default_factory=dict)
+    capabilities: McpCapabilities = Field(default_factory=McpCapabilities)
+
+
+class NormalizedMcp(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    servers: list[McpServer] = Field(default_factory=list)

spawn_cli/models/metadata.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class RenderedSkillEntry(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    skill: str
+    path: str
+
+
+class RenderedSkillsMeta(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    extensions: dict[str, list[RenderedSkillEntry]] = Field(default_factory=dict)
+
+
+class RenderedMcpEntry(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    name: str
+
+
+class RenderedMcpMeta(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    extensions: dict[str, list[RenderedMcpEntry]] = Field(default_factory=dict)

spawn_cli/models/navigation.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class NavFile(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    path: str
+    description: str
+
+
+class NavExtGroup(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    ext: str
+    files: list[NavFile] = Field(default_factory=list)
+
+
+class NavRulesGroup(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    rules: list[NavFile] = Field(default_factory=list)
+
+
+class NavigationFile(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    read_required: list[dict] = Field(default_factory=list, alias="read-required")
+    read_contextual: list[dict] = Field(default_factory=list, alias="read-contextual")

spawn_cli/models/skill.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SkillFileRef(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    file: str
+    description: str
+
+
+class SkillRawInfo(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    name: str
+    description: str
+    content: str
+    required_read: list[str] = Field(default_factory=list, alias="required-read")
+
+
+class SkillMetadata(BaseModel):
+    model_config = ConfigDict(populate_by_name=True)
+
+    name: str
+    description: str
+    content: str
+    required_read: list[SkillFileRef] = Field(default_factory=list)
+    auto_read: list[SkillFileRef] = Field(default_factory=list)

spawn_cli/resources/default_core_config.yaml

@@ -0,0 +1,5 @@
+version: "0.1.0"
+agent-ignore:
+  - spawn/**
+  - "!spawn/navigation.yaml"
+  - "!spawn/rules/**"

spawn_cli/warnings_display.py

@@ -0,0 +1,35 @@
+"""CLI-only formatting for SpawnWarning (see task 9 spec)."""
+
+from __future__ import annotations
+
+import sys
+import warnings
+from collections.abc import Callable
+
+from spawn_cli.errors import SpawnWarning
+
+_prev_showwarning: Callable[..., None] | None = None
+
+
+def install_spawn_warning_format() -> None:
+    global _prev_showwarning
+    if _prev_showwarning is not None:
+        return
+    _prev_showwarning = warnings.showwarning
+
+    def showwarning(message, category, filename, lineno, file=None, line=None) -> None:
+        if isinstance(category, type) and issubclass(category, SpawnWarning):
+            text = str(message).strip()
+            print(f"spawn: warning: {text}", file=sys.stderr)
+            return
+        if _prev_showwarning is not None:
+            _prev_showwarning(message, category, filename, lineno, file=file, line=line)
+
+    warnings.showwarning = showwarning  # type: ignore[method-assign]
+
+
+def reset_spawn_warning_format() -> None:
+    global _prev_showwarning
+    if _prev_showwarning is not None:
+        warnings.showwarning = _prev_showwarning
+        _prev_showwarning = None

spawn_cli-0.1.1.dist-info/METADATA

@@ -0,0 +1,11 @@
+Metadata-Version: 2.4
+Name: spawn-cli
+Version: 0.1.1
+Summary: A minimal installable Python CLI package.
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2.0
+Requires-Dist: ruamel.yaml>=0.18
+Requires-Dist: filelock>=3.12
+Requires-Dist: httpx>=0.27
+Requires-Dist: tomli>=2.0; python_version < "3.11"
+Requires-Dist: tomli-w>=1.0

spawn_cli-0.1.1.dist-info/RECORD

@@ -0,0 +1,41 @@
+spawn_cli/__init__.py,sha256=4t_crzhrLum--oyowUMxtjBTzUtWp7oRTF22ewEvJG4,49
+spawn_cli/cli.py,sha256=_72pDJOLNlqTksvf4MPcdmmp-8u3TFIsnumw5xtHH_c,7543
+spawn_cli/errors.py,sha256=1OJx7Ss529EeJkD0WLvNy0I9sKqxDX2bXS6i3mnqN2E,230
+spawn_cli/warnings_display.py,sha256=v4iTUTd4lziJ1Ivxh8-_zbcDaGZdZLEiCcQXo39Ftss,1116
+spawn_cli/core/__init__.py,sha256=a5rOQzNZ55nbXJPXwcTVws20MqhoEAHQ5_Cay1h2mDU,211
+spawn_cli/core/download.py,sha256=C8s2_sDcuKFJZr5YPyB2AOOX8P8aBXumSgunO_r-InA,19203
+spawn_cli/core/errors.py,sha256=gyFGgD5QEUUi218mBOcSQRJv4191XNdRyLW_9d_EUso,132
+spawn_cli/core/high_level.py,sha256=B9CH0H09Tlxw16_H0OLaarYjijVAr-HUP0uX1jG3-04,17377
+spawn_cli/core/low_level.py,sha256=wVp3eTpB_FhJmCVQpZii3IUDWdVAJ5uZ72-_tlSuiq8,30882
+spawn_cli/core/scripts.py,sha256=sowUZPeSGbrxu_hoI05DYjBhrQK7NAiiaw6ed99JwTc,7591
+spawn_cli/ide/__init__.py,sha256=mtpcKkzqP9ykCZUyHxrafUAtF-8w11tOttt79Wi_WYQ,1592
+spawn_cli/ide/_helpers.py,sha256=aXUMCDBdmuttuVE73s7_m-PmFsaAblamQNpjEt3j7sc,5770
+spawn_cli/ide/_stub.py,sha256=9vBgzS6mLLxzTzbC5kIH4Cw9K94s2OLgMs-buLjKhsg,2513
+spawn_cli/ide/_vacancy.py,sha256=uPxQE35U_wr1lD3Cp3ey4Z-cI56CAu9dEvU8I9Iq62g,7058
+spawn_cli/ide/claude_code.py,sha256=4E15jJWEKqlwIUMzGyKaGoX9QRdi0f9vDyo0fWeVLcw,5784
+spawn_cli/ide/codex.py,sha256=03BOU_kAWH3jBNycEhQKyo06vrxr8aAgB-foUle9r4I,4383
+spawn_cli/ide/cursor.py,sha256=w_n4lC5N7uyqO7__VKQrBulY0SKtXMEeqSXTDn1_HjA,4753
+spawn_cli/ide/gemini_cli.py,sha256=sFN-c5yceJnN-VyW7DEASj_KrGT6SnN_DxfWPQPLcxg,4993
+spawn_cli/ide/github_copilot.py,sha256=COMo8TSUur1wHXhMVSlqjRb7wVjnbqh7YxIrMKIQ57g,6304
+spawn_cli/ide/registry.py,sha256=9SfJRlxsrqo1IIb3xizUWKHMzBXggILE-kKksN-OX1g,4334
+spawn_cli/ide/windsurf.py,sha256=aX9HaiM7IPa6b93q9ouzZhi5tRr2PqI2xblfm3aKwTc,3334
+spawn_cli/io/__init__.py,sha256=x8PLDho22PdDmliprX2QnmxyTMDKR9mD0ro7TEkJ1Mg,550
+spawn_cli/io/json_io.py,sha256=wVmuSM61iP9PgSbd3oFjP_KWXAnmgpZxUamb69q18Wo,552
+spawn_cli/io/lock.py,sha256=YKWxfkEIRivZByvfjO3I40JujCkg8v0g9bS36vBP8FE,632
+spawn_cli/io/paths.py,sha256=Yzcv0sAPlkNhBTjmXoVbmPW8VtbklRcDR8WpJCZ354g,557
+spawn_cli/io/text_io.py,sha256=xWYQ4od3JuYKJjHsHn_ylarU3-EZkJ4KTV8Y5m52RfQ,416
+spawn_cli/io/toml_io.py,sha256=sDV_DkqEJtE-7epehlvwR6XSvVgBXy3vjvNGh7olurk,558
+spawn_cli/io/yaml_io.py,sha256=UtQ3WZ_1c97EOC96cAEJ8yjavSV9MaW25SwoS6uXj2o,846
+spawn_cli/models/__init__.py,sha256=Hb8lW9Sc5Liko3uxFp0Dklhmru4LU8kZV4JWWU0EAnY,1254
+spawn_cli/models/config.py,sha256=t4Dx0-_CwSx4YA6pm4DEsLUDZfPYu6HGza5Ws2xpLaI,3035
+spawn_cli/models/mcp.py,sha256=SV6lZaWUAQsNw2xvu9UB0SB7sOl96y1qnMlWHtFbiEc,1193
+spawn_cli/models/metadata.py,sha256=zxg9gvnj8x_L0YU6Hg9Mb3B2ZHt2qtYwEX0rAj0Tn84,658
+spawn_cli/models/navigation.py,sha256=S25xqUgnq0uVEKXs7UjpCqBQ9PifkeSRogMsLnkXMqs,759
+spawn_cli/models/skill.py,sha256=dnzParuZ0xIZ0PcKmS04WFkuiKti_ml5QGusta9aEJw,701
+spawn_cli/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+spawn_cli/resources/default_core_config.yaml,sha256=ecnGtWB3R0eAYEHVkzZWeuh2_wt9EqsFKZf9BurZGUE,95
+spawn_cli-0.1.1.dist-info/METADATA,sha256=iOoIDofwQ9XD0YRoQ_xtc3Z-lDMlJ_2hnvLp0neRh0U,337
+spawn_cli-0.1.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+spawn_cli-0.1.1.dist-info/entry_points.txt,sha256=LPd7krLFNds0otEoDGEJpvDOiubPekGKJvMgcpvQd7M,45
+spawn_cli-0.1.1.dist-info/top_level.txt,sha256=IzK1liuh9tgdhkh6yDvGQvtBDvKYXzSQ86Ty-a50lT8,10
+spawn_cli-0.1.1.dist-info/RECORD,,

spawn_cli-0.1.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

spawn_cli-0.1.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+spawn = spawn_cli.cli:main

spawn_cli-0.1.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+spawn_cli