caruso 0.7.6 → 0.7.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c881250221622ad116a1da441ca090a80fa1830f3d51b675b4a0919853d82287
-  data.tar.gz: 4276216066d112d8bed3e99c5d2928bd6d28ba1b44c4d2847f95f0f9447b803f
+  metadata.gz: af75d0db21770fa0559c36964cbca4cd51e80f8c96eb8097a1d41f0281ce70e3
+  data.tar.gz: 12bff57c9d9891b5abc54d2d2dd4a854ceb34faf8e3c5ad026ac3c51a0705944
 SHA512:
-  metadata.gz: ebf987777a3b98062f132330f17ba646840085cd63a123c04d944997002c42c1049cb325f0eb66dfee4ecb0dfb4127b279a96e6a298aa73b1bb61f56ce7caba5
-  data.tar.gz: fe109bde2907c60ef0c15f3eaa4e4ea7fc1a4f98d2f0c05f7ceaad78b7e2ab0ea7c632fa7851497df8630aeff7adb145f7bab093059af136519cfdb80ad62e5d
+  metadata.gz: cadbe6b5022e9ae58c79d8cf3fdc9750e71f10f3d6c90f920fbb3e2be18da127977e14d725a4b36ec629cfc69008cd4c8a58203492f6748185557bf0f3567fe3
+  data.tar.gz: 616a955c75e3c1e4aff04a18f282248dbf677d01ce85be4f224db2e6b08418e59fcd4b1ba9db0dda8f485e8f9684b127153f0df44c917571683c782cb45f697b

data/AGENTS.md

@@ -6,21 +6,14 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 Caruso is a Ruby gem CLI that bridges the gap between AI coding assistants. It fetches "steering documentation" (commands, agents, skills) from Claude Code Marketplaces and converts them to formats compatible with other IDEs, currently Cursor.
 
-## Source of Truth: Claude Code Documentation
+## Source of Truth: Official Documentation
 
-**IMPORTANT:** The official Claude Code marketplace and plugin specifications are located in `/Users/philipp/code/caruso/reference/`:
+**IMPORTANT:** The authoritative sources for Claude Code and Cursor specifications are the official docs. Reference links are in `/Users/philipp/code/caruso/reference/`:
 
-- `marketplace.md` - Marketplace structure and specification
-- `plugins.md` - Plugin format and configuration
-- `plugins_reference.md` - Component configuration fields and metadata
+- `claude_code.md` - Links to official Claude Code docs (hooks, plugins, marketplaces, skills)
+- `cursor.md` - Links to official Cursor docs (hooks, modes, rules, commands)
 
-**These reference documents are the authoritative source for:**
-- Marketplace.json schema and plugin metadata format
-- Component configuration fields (`commands`, `agents`, `skills`, `hooks`, `mcpServers`)
-- Expected directory structures and file patterns
-- Metadata requirements and validation rules
-
-When implementing features or fixing bugs related to marketplace compatibility, **always consult these reference files first**. If the implementation conflicts with the reference docs, the reference docs are correct and the code should be updated to match.
+When implementing features or fixing bugs, **always fetch the latest docs from these official URLs**. If the implementation conflicts with the official docs, the docs are correct and the code should be updated to match.
 
 ## Development Commands
 
@@ -271,6 +264,9 @@ Results are deduplicated with `.uniq`.
 
 Version is managed in `lib/caruso/version.rb`.
 
+# Rules
+- **NEVER force-push.** No `git push --force`, `git push --force-with-lease`, or `git push origin <tag> --force`. If a tag or commit was pushed wrong, fix forward with a new version.
+
 # Memory
 - The goal is a clean, correct, consistent implementation. Never implement fallbacks that hide errors or engage in defensive programming.
 - **Idempotency**: Removal commands (`marketplace remove`, `plugin uninstall`) are designed to be idempotent. They exit successfully (0) if the target does not exist. This is intentional for automation friendliness and is NOT considered "hiding errors".

data/lib/caruso/adapters/command_adapter.rb

@@ -40,9 +40,9 @@ module Caruso
         # We don't need globs or alwaysApply (those are for rules)
         # Just return content as-is, Claude Code commands are already compatible
 
-        # Add note about bash execution if it contains ! prefix
+        # Convert ```! auto-execute blocks to ```bash with run instruction
         if content.include?("`!")
-          add_bash_execution_note(content)
+          convert_auto_execute_blocks(content)
         else
           content
         end
@@ -57,14 +57,9 @@ module Caruso
         YAML
       end
 
-      def add_bash_execution_note(content)
-        match = content.match(/\A---\s*\n(.*?)\n---\s*\n/m)
-        return content unless match
-
-        note = "\n**Note:** This command originally used Claude Code's `!` prefix for bash execution. " \
-               "Cursor does not support this feature. The bash commands are documented below for reference.\n"
-
-        "---\n#{match[1]}\n---\n#{note}#{match.post_match}"
+      def convert_auto_execute_blocks(content)
+        # Replace ```! with ```bash and add instruction to run
+        content.gsub("```!\n", "```bash\n")
       end
 
       def save_command_file(relative_path, content)

data/lib/caruso/scripts/cc_stop_wrapper.sh

@@ -1,14 +1,17 @@
 #!/bin/bash
-# Translates Claude Code stop hook output to Cursor format.
+# Translates Claude Code stop hook I/O to Cursor format.
 #
-# CC stop hooks communicate via:
-#   Exit 2 + stderr reason       -> block (continue conversation)
-#   Exit 0 + {"decision":"block","reason":"..."} -> block
-#   Exit 0 + anything else       -> allow stop
+# INPUT translation (stdin):
+#   Cursor may pass transcript_path: null. CC hooks that read the transcript
+#   would bail out. We provide a minimal dummy transcript so the hook can
+#   proceed past transcript gates (completion promise won't match, but the
+#   core loop/block logic still works).
 #
-# Cursor stop hooks expect:
-#   Exit 0 + {"followup_message":"..."} -> continue with message
-#   Exit 0 + no output                 -> allow stop
+# OUTPUT translation (stdout):
+#   CC: exit 2 + stderr reason       -> block
+#   CC: exit 0 + {"decision":"block","reason":"..."} -> block
+#   Cursor: exit 0 + {"followup_message":"..."} -> continue with message
+#   Cursor: exit 0 + no output                 -> allow stop
 #
 # Usage: cc_stop_wrapper.sh <original-script> [args...]
 
@@ -18,9 +21,21 @@ SCRIPT="$1"
 shift
 
 STDERR_TMP=$(mktemp) || exit 1
-trap 'rm -f "$STDERR_TMP"' EXIT
+FAKE_TRANSCRIPT=""
+trap 'rm -f "$STDERR_TMP" "$FAKE_TRANSCRIPT"' EXIT
 
-OUTPUT=$("$SCRIPT" "$@" 2>"$STDERR_TMP")
+# Read and patch stdin: ensure transcript_path points to a readable file
+INPUT=$(cat)
+if [ -n "$INPUT" ] && command -v jq >/dev/null 2>&1; then
+  TP=$(echo "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)
+  if [ -z "$TP" ] || [ "$TP" = "null" ] || [ ! -f "$TP" ]; then
+    FAKE_TRANSCRIPT=$(mktemp) || exit 1
+    echo '{"role":"assistant","message":{"content":[{"type":"text","text":""}]}}' > "$FAKE_TRANSCRIPT"
+    INPUT=$(echo "$INPUT" | jq --arg tp "$FAKE_TRANSCRIPT" '.transcript_path = $tp')
+  fi
+fi
+
+OUTPUT=$(echo "$INPUT" | "$SCRIPT" "$@" 2>"$STDERR_TMP")
 EXIT_CODE=$?
 
 # CC exit 2 = block with stderr reason

data/lib/caruso/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Caruso
-  VERSION = "0.7.6"
+  VERSION = "0.7.7"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: caruso
 version: !ruby/object:Gem::Version
-  version: 0.7.6
+  version: 0.7.7
 platform: ruby
 authors:
 - Philipp Comans