kestrel-feature-code 0.1.0__tar.gz → 0.2.0__tar.gz

kestrel_feature_code-0.2.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.DS_Store
+.venv/
+*.egg-info/
+dist/

{kestrel_feature_code-0.1.0 → kestrel_feature_code-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kestrel-feature-code
-Version: 0.1.0
+Version: 0.2.0
 Summary: Codebase tooling feature for Kestrel Sovereign — read, search, edit, lint, test, commit, rollback with approval gates
 Project-URL: Homepage, https://kestrelsovereign.com
 Project-URL: Source, https://github.com/KestrelSovereignAI/kestrel-feature-code
@@ -23,7 +23,7 @@ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Build Tools
 Requires-Python: <3.14,>=3.11
-Requires-Dist: kestrel-sovereign-sdk<1,>=0.2
+Requires-Dist: kestrel-sovereign-sdk<1,>=0.4
 Provides-Extra: test
 Requires-Dist: pytest-asyncio>=1.1.0; extra == 'test'
 Requires-Dist: pytest>=8.0.0; extra == 'test'
@@ -39,7 +39,9 @@ Codebase tooling feature for Kestrel Sovereign agents — 10 tools spanning read
 uv pip install kestrel-feature-code
 ```
 
-The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.features` entry point — install it alongside `kestrel-sovereign` and `CodeEditFeature` registers itself at startup.
+The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.features` entry point — install it alongside `kestrel-sovereign` and `CodeFeature` registers itself at startup.
+
+> **v0.2.0 rename:** `CodeEditFeature` → `CodeFeature`. The old name is kept as a deprecated alias through v0.2.x for entry-point and import cutover; importing it emits a `DeprecationWarning`. Removed in v0.3.0. All `@tool` methods now return `kestrel_sdk.tools.result.ToolResult` (was: `Dict[str, Any]`); see kestrel-sovereign #1042 for the honesty contract.
 
 ## Configuration
 
@@ -64,7 +66,7 @@ The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.f
 
 ## Dependencies
 
-- `kestrel-sovereign-sdk>=0.2,<1` — base `Feature`, `tool`, `ToolCategory`
+- `kestrel-sovereign-sdk>=0.4,<1` — base `Feature`, `tool`, `ToolCategory`, `ToolResult`
 
 No runtime dependency on `kestrel-sovereign` itself; the feature operates against any codebase via `KESTREL_CODE_ROOT`.
 

{kestrel_feature_code-0.1.0 → kestrel_feature_code-0.2.0}/README.md

@@ -8,7 +8,9 @@ Codebase tooling feature for Kestrel Sovereign agents — 10 tools spanning read
 uv pip install kestrel-feature-code
 ```
 
-The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.features` entry point — install it alongside `kestrel-sovereign` and `CodeEditFeature` registers itself at startup.
+The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.features` entry point — install it alongside `kestrel-sovereign` and `CodeFeature` registers itself at startup.
+
+> **v0.2.0 rename:** `CodeEditFeature` → `CodeFeature`. The old name is kept as a deprecated alias through v0.2.x for entry-point and import cutover; importing it emits a `DeprecationWarning`. Removed in v0.3.0. All `@tool` methods now return `kestrel_sdk.tools.result.ToolResult` (was: `Dict[str, Any]`); see kestrel-sovereign #1042 for the honesty contract.
 
 ## Configuration
 
@@ -33,7 +35,7 @@ The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.f
 
 ## Dependencies
 
-- `kestrel-sovereign-sdk>=0.2,<1` — base `Feature`, `tool`, `ToolCategory`
+- `kestrel-sovereign-sdk>=0.4,<1` — base `Feature`, `tool`, `ToolCategory`, `ToolResult`
 
 No runtime dependency on `kestrel-sovereign` itself; the feature operates against any codebase via `KESTREL_CODE_ROOT`.
 

kestrel_feature_code-0.2.0/kestrel_feature_code/__init__.py

@@ -0,0 +1,61 @@
+"""
+Kestrel Feature Code — codebase tooling for Kestrel Sovereign agents.
+
+Registers ``CodeFeature`` (renamed from ``CodeEditFeature`` in
+v0.2.0) via the ``kestrel_sovereign.features`` entry-point group;
+auto-discovered when installed alongside kestrel-sovereign.
+
+The feature covers general codebase tooling — read, search, diff,
+lint, logs, test — alongside the approval-gated mutation tools (edit,
+commit, rollback, restart). All mutation requires explicit user
+approval; read-only operations do not. Returns
+``kestrel_sdk.tools.result.ToolResult`` from every @tool surface.
+
+Tools:
+    !code-read <path>           Read a source file
+    !code-search <pattern>      Search for text in codebase
+    !code-edit <path>           Edit a source file (requires approval)
+    !code-diff <path>           Show uncommitted changes
+    !code-commit <message>      Commit staged changes (requires approval)
+    !code-restart               Signal server restart (requires approval)
+    !code-test [path]           Run pytest tests
+    !code-lint [path]           Run ruff linter
+    !code-logs                  View recent application logs
+    !code-rollback [commit]     Rollback to previous commit (requires approval)
+"""
+
+from importlib.metadata import PackageNotFoundError, version as _version
+
+from .feature import CodeFeature
+
+try:
+    __version__ = _version("kestrel-feature-code")
+except PackageNotFoundError:
+    __version__ = "0.0.0+local"
+
+__all__ = ["CodeFeature", "__version__"]
+
+
+def __getattr__(name: str):
+    """Lazy backward-compat for ``from kestrel_feature_code import
+    CodeEditFeature``. Removed in v0.3.0.
+
+    Emits the DeprecationWarning here directly (not via the
+    ``feature`` submodule's __getattr__) so the stacklevel points at
+    the user's import site. Going through the submodule alias would
+    add an extra frame and attribute the warning to ``__init__.py``
+    instead of the user's code.
+    """
+    if name == "CodeEditFeature":
+        import warnings
+        warnings.warn(
+            "CodeEditFeature is a deprecated alias for CodeFeature; "
+            "the alias will be removed in v0.3.0. Update imports to "
+            "``from kestrel_feature_code import CodeFeature``.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return CodeFeature
+    raise AttributeError(
+        f"module 'kestrel_feature_code' has no attribute {name!r}"
+    )