kestrel-feature-github 0.1.0__py3-none-any.whl

kestrel_feature_github/models.py

@@ -0,0 +1,107 @@
+"""Data models for GitHub feature."""
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+from typing import Optional
+
+
+class FileType(Enum):
+    """Type of file in repository."""
+    FILE = "file"
+    DIR = "dir"
+    SYMLINK = "symlink"
+    SUBMODULE = "submodule"
+
+
+@dataclass
+class RepoFile:
+    """A file or directory in a repository."""
+    path: str
+    name: str
+    type: FileType
+    size: int = 0
+    sha: str = ""
+    download_url: Optional[str] = None
+
+    def is_dir(self) -> bool:
+        return self.type == FileType.DIR
+
+    def is_file(self) -> bool:
+        return self.type == FileType.FILE
+
+
+@dataclass
+class FileContent:
+    """Content of a file from repository."""
+    path: str
+    content: str
+    sha: str
+    size: int
+    encoding: str = "utf-8"
+    repo: str = ""
+    ref: str = "main"
+    cached_at: Optional[datetime] = None
+
+
+@dataclass
+class SearchResult:
+    """A search result from GitHub code search."""
+    path: str
+    repo: str
+    name: str
+    sha: str
+    score: float = 0.0
+    html_url: str = ""
+    text_matches: list[dict] = field(default_factory=list)
+
+
+@dataclass
+class CodeDefinition:
+    """A code definition (function, class, etc.) extracted from source."""
+    name: str
+    type: str  # "function", "class", "method", "variable"
+    path: str
+    start_line: int
+    end_line: int
+    signature: str = ""
+    docstring: str = ""
+    source: str = ""
+
+
+@dataclass
+class ComponentManifest:
+    """A component.yaml manifest for a feature."""
+    feature_name: str
+    description: str
+    version: str = "1.0.0"
+    entry_point: str = "feature.py"
+    files: list[str] = field(default_factory=list)
+    tools: list[str] = field(default_factory=list)
+    dependencies: list[str] = field(default_factory=list)
+
+    @classmethod
+    def from_dict(cls, data: dict, feature_name: str) -> "ComponentManifest":
+        """Create from dictionary (parsed YAML).
+
+        Handles both formats for tools:
+        - Simple: ["tool1", "tool2"]
+        - Dict: [{"name": "tool1", "description": "..."}, ...]
+        """
+        # Normalize tools to list of strings
+        raw_tools = data.get("tools", [])
+        tools = []
+        for t in raw_tools:
+            if isinstance(t, dict):
+                tools.append(t.get("name", str(t)))
+            else:
+                tools.append(str(t))
+
+        return cls(
+            feature_name=feature_name,
+            description=data.get("description", ""),
+            version=data.get("version", "1.0.0"),
+            entry_point=data.get("entry_point", "feature.py"),
+            files=data.get("files", []),
+            tools=tools,
+            dependencies=data.get("dependencies", []),
+        )

kestrel_feature_github-0.1.0.dist-info/METADATA

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: kestrel-feature-github
+Version: 0.1.0
+Summary: Kestrel GitHub integration feature
+License: Apache-2.0
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.21.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: kestrel-sovereign-sdk<1,>=0.11
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.23.0; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# kestrel-feature-github
+
+GitHub integration for Kestrel Sovereign agents — manage issues, pull requests, and repositories directly from agent conversations.
+
+## Installation
+
+```bash
+uv pip install kestrel-feature-github
+```
+
+## Dependencies
+
+- `kestrel-sovereign-sdk`
+- `httpx`
+- `pyyaml`
+- `aiosqlite`
+
+## Usage
+
+Once installed, the `GitHubFeature` is automatically discovered by kestrel-sovereign via the `kestrel_sovereign.features` entry point.
+
+See [SKILL.md](SKILL.md) for the full skill reference.
+
+## Configuration
+
+| Variable | Description |
+|----------|-------------|
+| `GITHUB_TOKEN` | GitHub personal access token with repo access |
+
+## Development
+
+```bash
+uv sync --extra test
+uv run --extra test pytest
+```

kestrel_feature_github-0.1.0.dist-info/RECORD

@@ -0,0 +1,12 @@
+kestrel_feature_github/SKILL.md,sha256=tC4PaPdW_5wL6Db1IIv83-vUGhc1_YLa9y25fI5vy44,3852
+kestrel_feature_github/__init__.py,sha256=kPaKHij-tY2MMrsNSPlt4b7gRExhggbyU0P3HXENMFM,150
+kestrel_feature_github/ast_analyzer.py,sha256=_fwk0dhbKWEQsTnjsYzd8qhMFOLBUccutIenaTxEiBM,7971
+kestrel_feature_github/cache.py,sha256=LpCJH7X2e85DjKCyYg303a7X8HgSpyMlUrL4FeEQCDE,9548
+kestrel_feature_github/client.py,sha256=eq5_9b0lZaJ1T0QbauqMPPteyo6m-X867VsLKpJnsPc,17967
+kestrel_feature_github/feature.py,sha256=y9AixAzqAxPw8b8-2K6vq8YbQM5VR4QXCYy-NXm3YZs,24675
+kestrel_feature_github/models.py,sha256=db0FRpw2zvpB24Gzw1NNWxe48f1wJUKqFy3QmNEr3C4,2731
+kestrel_feature_github-0.1.0.dist-info/METADATA,sha256=qDlAojmgRIHqtAPX0t5aVr7BQgZgiXX-Bw-mK67VIdY,1200
+kestrel_feature_github-0.1.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+kestrel_feature_github-0.1.0.dist-info/entry_points.txt,sha256=ojvtumSfwd3xucEr_ypclIml5dJyVOjRtSmjOiJ8GPE,82
+kestrel_feature_github-0.1.0.dist-info/licenses/LICENSE,sha256=hu6c8OxhelXVvfNXUulz6QLts9AT2cgmSDAv2tc5P3I,5206
+kestrel_feature_github-0.1.0.dist-info/RECORD,,

kestrel_feature_github-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

kestrel_feature_github-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[kestrel_sovereign.features]
+GitHubFeature = kestrel_feature_github:GitHubFeature

kestrel_feature_github-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,106 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by the
+copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all other
+entities that control, are controlled by, or are under common control with
+that entity. For the purposes of this definition, "control" means (i) the
+power, direct or indirect, to cause the direction or management of such
+entity, whether by contract or otherwise, or (ii) ownership of fifty percent
+(50%) or more of the outstanding shares, or (iii) beneficial ownership of
+such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation source, and
+configuration files.
+
+"Object" form shall mean any form resulting from mechanical transformation
+or translation of a Source form, including but not limited to compiled object
+code, generated documentation, and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object form,
+that is based on (or derived from) the Work and for which the editorial
+revisions, annotations, elaborations, or other modifications represent, as a
+whole, an original work of authorship. For the purposes of this License,
+Derivative Works shall not include works that remain separable from, or
+merely link (or bind by name) to the interfaces of, the Work and Derivative
+Works thereof.
+
+"Contribution" shall mean any work of authorship, including the original
+version of the Work and any modifications or additions to that Work or
+Derivative Works thereof, that is intentionally submitted to Licensor for
+inclusion in the Work by the copyright owner or by an individual or Legal
+Entity authorized to submit on behalf of the copyright owner.
+
+"Contributor" shall mean Licensor and any individual or Legal Entity on
+behalf of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable copyright license to
+reproduce, prepare Derivative Works of, publicly display, publicly perform,
+sublicense, and distribute the Work and such Derivative Works in Source or
+Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of this
+License, each Contributor hereby grants to You a perpetual, worldwide,
+non-exclusive, no-charge, royalty-free, irrevocable patent license to make,
+have made, use, offer to sell, sell, import, and otherwise transfer the Work.
+
+4. Redistribution. You may reproduce and distribute copies of the Work or
+Derivative Works thereof in any medium, with or without modifications, and in
+Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy
+of this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that
+You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from
+the Source form of the Work, excluding those notices that do not pertain to
+any part of the Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its distribution,
+then any Derivative Works that You distribute must include a readable copy of
+the attribution notices contained within such NOTICE file.
+
+5. Submission of Contributions. Unless You explicitly state otherwise, any
+Contribution intentionally submitted for inclusion in the Work by You to the
+Licensor shall be under the terms and conditions of this License.
+
+6. Trademarks. This License does not grant permission to use the trade names,
+trademarks, service marks, or product names of the Licensor.
+
+7. Disclaimer of Warranty. Unless required by applicable law or agreed to in
+writing, Licensor provides the Work on an "AS IS" BASIS, WITHOUT WARRANTIES
+OR CONDITIONS OF ANY KIND, either express or implied.
+
+8. Limitation of Liability. In no event and under no legal theory, whether in
+tort, contract, or otherwise, unless required by applicable law, shall any
+Contributor be liable to You for damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing the Work
+or Derivative Works thereof, You may choose to offer support, warranty,
+indemnity, or other liability obligations. However, in accepting such
+obligations, You may act only on Your own behalf and on Your sole
+responsibility.