bash-classify 0.1.0__tar.gz → 0.1.2__tar.gz

bash_classify-0.1.2/.claude-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "bash-classify",
+  "description": "Bash command classifier with Claude Code plugin for auto-allowing readonly commands",
+  "metadata": {
+    "pluginRoot": "./coding-agent-plugins/claude-code"
+  },
+  "plugins": [
+    {
+      "name": "bash-classify-hook",
+      "description": "Auto-allows readonly bash commands in Claude Code using bash-classify",
+      "version": "0.1.2",
+      "author": {
+        "name": "Filip Procházka",
+        "url": "https://github.com/fprochazka"
+      },
+      "source": ".",
+      "category": "security",
+      "homepage": "https://github.com/fprochazka/bash-classify"
+    }
+  ]
+}

{bash_classify-0.1.0 → bash_classify-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bash-classify
-Version: 0.1.0
+Version: 0.1.2
 Summary: Classify bash commands as READONLY, WRITE, DANGEROUS, or UNKNOWN
 Project-URL: Homepage, https://github.com/fprochazka/bash-classify
 Project-URL: Repository, https://github.com/fprochazka/bash-classify
@@ -61,35 +61,29 @@ $ echo 'find . -name "*.pyc" -delete' | bash-classify | jq '.classification'
 "DANGEROUS"
 ```
 
-## Claude Code hook
-
-Install as a Claude Code hook to auto-allow read-only commands and require approval for everything else:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.command' | bash-classify",
-            "timeout": 5000,
-            "on_output": [
-              {
-                "matcher": "\"classification\": \"READONLY\"",
-                "action": "approve"
-              }
-            ]
-          }
-        ]
-      }
-    ]
-  }
-}
+## Claude Code plugin
+
+The repo includes a Claude Code plugin that auto-allows readonly bash commands via a `PreToolUse` hook.
+
+```bash
+# Install the bash-classify CLI
+uv tool install bash-classify
+
+# Add the marketplace and install the plugin
+claude plugin marketplace add fprochazka/bash-classify
+claude plugin install bash-classify-hook@fprochazka-bash-classify
 ```
 
+To upgrade after a new release:
+
+```bash
+uv tool upgrade bash-classify
+claude plugin marketplace update fprochazka-bash-classify
+claude plugin update bash-classify-hook@fprochazka-bash-classify
+```
+
+Once installed, any Bash tool call classified as `READONLY` is auto-approved — no permission prompt. Everything else (WRITE, DANGEROUS, UNKNOWN) still requires confirmation.
+
 ## Command database
 
 The classification database includes 120+ command definitions covering common Unix utilities, package managers, container tools, cloud CLIs, and more.
@@ -142,6 +136,24 @@ uv run pytest
 
 To add or modify command definitions, see [docs/classification-guidance.md](docs/classification-guidance.md). All YAML files in `src/bash_classify/commands/` are validated against a [JSON Schema](schemas/command.schema.json) — your IDE will provide autocomplete if it supports the `# $schema:` comment.
 
+## Releasing
+
+Version is derived automatically from git tags via `hatch-vcs` — no manual version bumping needed.
+
+Before tagging, bump the version in both plugin manifest files:
+
+- `coding-agent-plugins/claude-code/.claude-plugin/plugin.json`
+- `.claude-plugin/marketplace.json`
+
+Then tag and push:
+
+```bash
+git tag v<version>
+git push origin v<version>
+```
+
+The `publish.yml` GitHub Action builds and publishes to PyPI automatically via trusted publishing.
+
 ## License
 
 [MIT](LICENSE)

{bash_classify-0.1.0 → bash_classify-0.1.2}/README.md

@@ -32,35 +32,29 @@ $ echo 'find . -name "*.pyc" -delete' | bash-classify | jq '.classification'
 "DANGEROUS"
 ```
 
-## Claude Code hook
-
-Install as a Claude Code hook to auto-allow read-only commands and require approval for everything else:
-
-```json
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "echo \"$CLAUDE_TOOL_INPUT\" | jq -r '.command' | bash-classify",
-            "timeout": 5000,
-            "on_output": [
-              {
-                "matcher": "\"classification\": \"READONLY\"",
-                "action": "approve"
-              }
-            ]
-          }
-        ]
-      }
-    ]
-  }
-}
+## Claude Code plugin
+
+The repo includes a Claude Code plugin that auto-allows readonly bash commands via a `PreToolUse` hook.
+
+```bash
+# Install the bash-classify CLI
+uv tool install bash-classify
+
+# Add the marketplace and install the plugin
+claude plugin marketplace add fprochazka/bash-classify
+claude plugin install bash-classify-hook@fprochazka-bash-classify
 ```
 
+To upgrade after a new release:
+
+```bash
+uv tool upgrade bash-classify
+claude plugin marketplace update fprochazka-bash-classify
+claude plugin update bash-classify-hook@fprochazka-bash-classify
+```
+
+Once installed, any Bash tool call classified as `READONLY` is auto-approved — no permission prompt. Everything else (WRITE, DANGEROUS, UNKNOWN) still requires confirmation.
+
 ## Command database
 
 The classification database includes 120+ command definitions covering common Unix utilities, package managers, container tools, cloud CLIs, and more.
@@ -113,6 +107,24 @@ uv run pytest
 
 To add or modify command definitions, see [docs/classification-guidance.md](docs/classification-guidance.md). All YAML files in `src/bash_classify/commands/` are validated against a [JSON Schema](schemas/command.schema.json) — your IDE will provide autocomplete if it supports the `# $schema:` comment.
 
+## Releasing
+
+Version is derived automatically from git tags via `hatch-vcs` — no manual version bumping needed.
+
+Before tagging, bump the version in both plugin manifest files:
+
+- `coding-agent-plugins/claude-code/.claude-plugin/plugin.json`
+- `.claude-plugin/marketplace.json`
+
+Then tag and push:
+
+```bash
+git tag v<version>
+git push origin v<version>
+```
+
+The `publish.yml` GitHub Action builds and publishes to PyPI automatically via trusted publishing.
+
 ## License
 
 [MIT](LICENSE)

{bash_classify-0.1.0 → bash_classify-0.1.2}/coding-agent-plugins/claude-code/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bash-classify-hook",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Auto-allows readonly bash commands in Claude Code using bash-classify",
   "author": {
     "name": "Filip Prochazka"

{bash_classify-0.1.0 → bash_classify-0.1.2}/coding-agent-plugins/claude-code/hooks/classify-bash.sh

@@ -36,7 +36,7 @@ classification=$(echo "$classification_output" | jq -r '.classification // empty
 
 if [[ "$classification" == "READONLY" ]]; then
   # Auto-allow readonly commands
-  echo '{"hookSpecificOutput":{"permissionDecision":"allow"}}'
+  echo '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"allow"}}'
 fi
 
 # For anything else (WRITE, DANGEROUS, UNKNOWN), output nothing

{bash_classify-0.1.0 → bash_classify-0.1.2}/src/bash_classify/cli.py

@@ -95,7 +95,33 @@ def main() -> None:
         1 - parse error (invalid bash syntax)
         2 - internal error
     """
+    if len(sys.argv) > 1 and sys.argv[1] in ("-h", "--help"):
+        print("Usage: bash-classify < command")
+        print("       echo 'ls -la' | bash-classify")
+        print()
+        print("Reads a bash expression from stdin, classifies it, and outputs JSON.")
+        print()
+        print("Exit codes:")
+        print("  0  successfully classified")
+        print("  1  empty input")
+        print("  2  internal error")
+        sys.exit(0)
+
+    if len(sys.argv) > 1 and sys.argv[1] in ("-v", "--version"):
+        from importlib.metadata import version
+
+        print(f"bash-classify {version('bash-classify')}")
+        sys.exit(0)
+
     try:
+        import select
+
+        # Timeout if no data arrives within 5 seconds
+        ready, _, _ = select.select([sys.stdin], [], [], 5.0)
+        if not ready:
+            print("bash-classify: timed out waiting for input on stdin (use --help for usage)", file=sys.stderr)
+            sys.exit(1)
+
         expression = sys.stdin.read().strip()
         if not expression:
             sys.exit(1)

bash_classify-0.1.0/.claude-plugin/marketplace.json

@@ -1,13 +0,0 @@
-{
-  "name": "bash-classify",
-  "description": "Bash command classifier with Claude Code plugin for auto-allowing readonly commands",
-  "metadata": {
-    "pluginRoot": "./coding-agent-plugins/claude-code"
-  },
-  "plugins": [
-    {
-      "name": "bash-classify-hook",
-      "source": "."
-    }
-  ]
-}