familiar-cli 0.5.2__tar.gz → 0.6.1__tar.gz

{familiar_cli-0.5.2 → familiar_cli-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: familiar-cli
-Version: 0.5.2
+Version: 0.6.1
 Summary: compose and invoke ai agent prompts from reusable templates
 Author-email: cyberwitchery lab <contact@cyberwitchery.com>
 License-Expression: MIT
@@ -20,7 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: dev
-Requires-Dist: ruff; extra == "dev"
+Requires-Dist: ruff==0.16.5; extra == "dev"
 Requires-Dist: mypy; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
@@ -46,18 +46,21 @@ pip install familiar-cli
 ## usage
 
 ```
-usage: familiar [-h] {conjure,invoke,list} ...
+usage: familiar [-h] [--version] [--debug] {conjure,invoke,list,lint} ...
 
 conjure and invoke familiars
 
 positional arguments:
-  {conjure,invoke,list}
+  {conjure,invoke,list,lint}
     conjure             compose system instructions for an agent
     invoke              render an invocation and run the agent
-    list                list available conjurings or invocations
+    list                list available conjurings and invocations
+    lint                lint conjurings and invocations
 
 options:
   -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --debug               show full traceback on error
 ```
 
 conjure conjurings to create system instructions for an agent:
@@ -98,6 +101,12 @@ list available conjurings and invocations:
 familiar list
 ```
 
+lint conjurings and invocations, including local `.familiar/` overrides:
+
+```
+familiar lint
+```
+
 ## customization
 
 add your own conjurings and invocations by creating files in `.familiar/` in your repo:

{familiar_cli-0.5.2 → familiar_cli-0.6.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "familiar-cli"
-version = "0.5.2"
+version = "0.6.1"
 description = "compose and invoke ai agent prompts from reusable templates"
 readme = "readme.md"
 license = "MIT"
@@ -36,7 +36,7 @@ claude = "familiar.agents:ClaudeAgent"
 package-dir = {"" = "src"}
 
 [project.optional-dependencies]
-dev = ["ruff", "mypy", "pytest", "pytest-cov", "bandit"]
+dev = ["ruff==0.16.5", "mypy", "pytest", "pytest-cov", "bandit"]
 
 [tool.setuptools.package-data]
 "familiar.data.conjurings" = ["*.md"]

{familiar_cli-0.5.2 → familiar_cli-0.6.1}/readme.md

@@ -17,18 +17,21 @@ pip install familiar-cli
 ## usage
 
 ```
-usage: familiar [-h] {conjure,invoke,list} ...
+usage: familiar [-h] [--version] [--debug] {conjure,invoke,list,lint} ...
 
 conjure and invoke familiars
 
 positional arguments:
-  {conjure,invoke,list}
+  {conjure,invoke,list,lint}
     conjure             compose system instructions for an agent
     invoke              render an invocation and run the agent
-    list                list available conjurings or invocations
+    list                list available conjurings and invocations
+    lint                lint conjurings and invocations
 
 options:
   -h, --help            show this help message and exit
+  --version             show program's version number and exit
+  --debug               show full traceback on error
 ```
 
 conjure conjurings to create system instructions for an agent:
@@ -69,6 +72,12 @@ list available conjurings and invocations:
 familiar list
 ```
 
+lint conjurings and invocations, including local `.familiar/` overrides:
+
+```
+familiar lint
+```
+
 ## customization
 
 add your own conjurings and invocations by creating files in `.familiar/` in your repo:

{familiar_cli-0.5.2 → familiar_cli-0.6.1}/src/familiar/__init__.py

@@ -2,6 +2,6 @@
 
 from importlib.metadata import version
 
-__all__ = ["agents", "render", "cli"]
+__all__ = ["agents", "cli", "render"]
 
 __version__ = version("familiar-cli")

{familiar_cli-0.5.2 → familiar_cli-0.6.1}/src/familiar/_plugins.py

@@ -3,8 +3,9 @@
 from __future__ import annotations
 
 import warnings
+from collections.abc import Callable
 from importlib.metadata import entry_points
-from typing import Any, Callable
+from typing import Any
 
 
 def load_plugins(
@@ -36,7 +37,8 @@ def load_plugins(
                 )
                 continue
             results.append(obj)
-        except Exception as e:
+        # a broken third-party entry point must not take down the cli
+        except Exception as e:  # noqa: BLE001
             warnings.warn(
                 f"failed to load {label} '{ep.name}': {e}",
                 stacklevel=2,

{familiar_cli-0.5.2 → familiar_cli-0.6.1}/src/familiar/agents.py

@@ -61,7 +61,7 @@ class CodexAgent(Agent):
             if auto:
                 cmd.append("--full-auto")
             cmd.extend(["exec", "--skip-git-repo-check", "-C", str(repo_root), "-"])
-            proc = subprocess.run(cmd, input=prompt, text=True)
+            proc = subprocess.run(cmd, input=prompt, text=True, check=False)
             return proc.returncode
         else:
             cmd = ["codex"]
@@ -108,7 +108,8 @@ def load_agents() -> dict[str, Agent]:
         try:
             instance = cls()
             agents[instance.name] = instance
-        except Exception as e:
+        # a broken agent plugin must not take down the cli
+        except Exception as e:  # noqa: BLE001
             warnings.warn(
                 f"failed to load agent plugin '{cls.__name__}': {e}",
                 stacklevel=2,

{familiar_cli-0.5.2 → familiar_cli-0.6.1}/src/familiar/cli.py

@@ -14,7 +14,7 @@ import warnings
 from importlib.metadata import version
 from pathlib import Path
 
-from .agents import Agent, get_agents, get_agent
+from .agents import Agent, get_agent, get_agents
 from .lint import lint_all
 from .render import (
     NotFoundError,
@@ -46,7 +46,7 @@ def _agent_hint() -> str:
     return f"valid agents: {', '.join(get_agents().keys())}"
 
 
-def _resolve_agent(name: str) -> "Agent":
+def _resolve_agent(name: str) -> Agent:
     """look up an agent by name, raising CliError on unknown names."""
     try:
         return get_agent(name)
@@ -94,6 +94,7 @@ def _remove_worktree(repo_root: Path, worktree_path: Path) -> None:
                 str(worktree_path),
             ],
             capture_output=True,
+            check=False,
         )
         if result.returncode != 0:
             stderr = result.stderr.decode(errors="replace").strip()
@@ -119,8 +120,8 @@ def create_worktree(repo_root: Path) -> Path:
         )
 
     tmpdir = tempfile.mkdtemp(prefix="familiar-")
-    # git worktree add requires the directory to NOT exist.
-    # mkdtemp creates it. let's remove it and let git create it.
+    # git worktree add requires the target to not exist, so remove the
+    # mkdtemp-created directory and let git create it
     os.rmdir(tmpdir)
 
     try:
@@ -509,7 +510,8 @@ def main() -> None:
         if e.hint:
             print(f"hint: {e.hint}", file=sys.stderr)
         raise SystemExit(e.exit_code)
-    except Exception as e:
+    # top-level handler: any unexpected error becomes an exit code, not a traceback
+    except Exception as e:  # noqa: BLE001
         if args.debug:
             traceback.print_exc()
         print(f"error: {e}", file=sys.stderr)