crewly 1.5.12 → 1.5.13

package/config/skills/_common/lib.sh

@@ -7,6 +7,37 @@
 # Base URL for the Crewly backend API
 CREWLY_API_URL="${CREWLY_API_URL:-http://localhost:8787}"
 
+# -----------------------------------------------------------------------------
+# Universal --file flag preprocessor (#EOF-fix)
+#
+# Fixes Gemini CLI's "unexpected EOF while looking for matching `'" errors.
+#
+# Root cause: When an LLM CLI passes JSON as a shell argument, special chars
+# inside the JSON (single quotes, backticks, parentheses, $variables) get
+# interpreted by the shell BEFORE the script runs, causing parse errors.
+#
+# Solution: The LLM writes JSON to a temp file, then passes --file <path>.
+# This preprocessor detects --file as the first argument, reads the file,
+# and replaces the script's positional parameters with the file contents.
+# All downstream parsing (read_json_input, custom arg loops) works unchanged.
+#
+# Usage (by LLM CLI):
+#   printf '%s' '{"summary":"text with 'quotes'"}' > /tmp/crewly_input.json
+#   bash execute.sh --file /tmp/crewly_input.json
+#
+# This runs at source-time, so every script that sources lib.sh gets it for free.
+# -----------------------------------------------------------------------------
+if [ "${1:-}" = "--file" ] && [ -n "${2:-}" ]; then
+  if [ -f "$2" ]; then
+    _CREWLY_FILE_CONTENT="$(cat "$2")"
+    set -- "$_CREWLY_FILE_CONTENT"
+    unset _CREWLY_FILE_CONTENT
+  else
+    echo '{"error":"File not found: '"$2"'"}' >&2
+    exit 1
+  fi
+fi
+
 # -----------------------------------------------------------------------------
 # read_json_input [arg]
 #

package/config/skills/_common/lib.test.sh

@@ -0,0 +1,164 @@
+#!/bin/bash
+# =============================================================================
+# Tests for lib.sh — shared skills library
+# Covers: --file preprocessor, read_json_input, require_param, error_exit
+# =============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PASS=0
+FAIL=0
+TOTAL=0
+
+# Color output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+assert_eq() {
+  local test_name="$1" expected="$2" actual="$3"
+  TOTAL=$((TOTAL + 1))
+  if [ "$expected" = "$actual" ]; then
+    echo -e "${GREEN}PASS${NC}: $test_name"
+    PASS=$((PASS + 1))
+  else
+    echo -e "${RED}FAIL${NC}: $test_name"
+    echo "  Expected: $expected"
+    echo "  Actual:   $actual"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_contains() {
+  local test_name="$1" expected_substr="$2" actual="$3"
+  TOTAL=$((TOTAL + 1))
+  if echo "$actual" | grep -q "$expected_substr"; then
+    echo -e "${GREEN}PASS${NC}: $test_name"
+    PASS=$((PASS + 1))
+  else
+    echo -e "${RED}FAIL${NC}: $test_name"
+    echo "  Expected to contain: $expected_substr"
+    echo "  Actual: $actual"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+assert_exit_code() {
+  local test_name="$1" expected_code="$2"
+  shift 2
+  local actual_code=0
+  "$@" >/dev/null 2>&1 || actual_code=$?
+  TOTAL=$((TOTAL + 1))
+  if [ "$expected_code" = "$actual_code" ]; then
+    echo -e "${GREEN}PASS${NC}: $test_name"
+    PASS=$((PASS + 1))
+  else
+    echo -e "${RED}FAIL${NC}: $test_name"
+    echo "  Expected exit code: $expected_code"
+    echo "  Actual exit code:   $actual_code"
+    FAIL=$((FAIL + 1))
+  fi
+}
+
+# Create a minimal test skill script that sources lib.sh and echoes $1
+TEMP_DIR=$(mktemp -d)
+trap "rm -rf $TEMP_DIR" EXIT
+
+cat > "$TEMP_DIR/test_skill.sh" << 'SKILL_EOF'
+#!/bin/bash
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# Source lib.sh via the real path
+source "$LIB_PATH"
+# Output the first positional parameter (after preprocessor runs)
+echo "$1"
+SKILL_EOF
+chmod +x "$TEMP_DIR/test_skill.sh"
+
+# Also create a test skill that uses read_json_input
+cat > "$TEMP_DIR/test_read_json.sh" << 'SKILL_EOF'
+#!/bin/bash
+set -euo pipefail
+source "$LIB_PATH"
+INPUT=$(read_json_input "${1:-}")
+echo "$INPUT"
+SKILL_EOF
+chmod +x "$TEMP_DIR/test_read_json.sh"
+
+export LIB_PATH="$SCRIPT_DIR/lib.sh"
+
+echo "=== lib.sh Test Suite ==="
+echo ""
+
+# ---- Test 1: --file flag reads JSON from file ----
+echo '{"key":"value","text":"hello world"}' > "$TEMP_DIR/input.json"
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/input.json")
+assert_eq "--file reads JSON from file" '{"key":"value","text":"hello world"}' "$RESULT"
+
+# ---- Test 2: --file with special characters (the whole point!) ----
+printf '%s' '{"summary":"text with '\''quotes'\'' and (parens) and `backticks`"}' > "$TEMP_DIR/special.json"
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/special.json")
+assert_contains "--file handles single quotes" "quotes" "$RESULT"
+assert_contains "--file handles parentheses" "(parens)" "$RESULT"
+assert_contains "--file handles backticks" "backticks" "$RESULT"
+
+# ---- Test 3: --file with multiline JSON ----
+cat > "$TEMP_DIR/multiline.json" << 'MULTI_EOF'
+{"summary":"line 1\nline 2\nline 3","status":"done"}
+MULTI_EOF
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/multiline.json")
+assert_contains "--file handles multiline content" "line 1" "$RESULT"
+
+# ---- Test 4: --file with nonexistent file fails ----
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "/tmp/nonexistent_crewly_test_file.json" 2>&1 || true)
+assert_contains "--file with missing file reports error" "File not found" "$RESULT"
+
+# ---- Test 5: Direct JSON argument still works (backward compat) ----
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" '{"key":"direct"}')
+assert_eq "Direct JSON argument works" '{"key":"direct"}' "$RESULT"
+
+# ---- Test 6: read_json_input with --file ----
+echo '{"agentId":"dev-1","content":"test memory"}' > "$TEMP_DIR/read_input.json"
+RESULT=$(bash "$TEMP_DIR/test_read_json.sh" --file "$TEMP_DIR/read_input.json")
+assert_contains "read_json_input with --file" "dev-1" "$RESULT"
+
+# ---- Test 7: read_json_input with @filepath ----
+echo '{"agentId":"dev-2","content":"at-file test"}' > "$TEMP_DIR/at_input.json"
+RESULT=$(bash "$TEMP_DIR/test_read_json.sh" "@$TEMP_DIR/at_input.json")
+assert_contains "read_json_input with @filepath" "dev-2" "$RESULT"
+
+# ---- Test 8: read_json_input with stdin pipe ----
+RESULT=$(echo '{"agentId":"dev-3","content":"stdin test"}' | bash "$TEMP_DIR/test_read_json.sh")
+assert_contains "read_json_input with stdin pipe" "dev-3" "$RESULT"
+
+# ---- Test 9: read_json_input with direct JSON arg ----
+RESULT=$(bash "$TEMP_DIR/test_read_json.sh" '{"agentId":"dev-4"}')
+assert_contains "read_json_input with direct arg" "dev-4" "$RESULT"
+
+# ---- Test 10: --file with Unicode content ----
+printf '%s' '{"text":"Chinese: 你好世界, Japanese: こんにちは"}' > "$TEMP_DIR/unicode.json"
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/unicode.json")
+assert_contains "--file handles Unicode" "你好世界" "$RESULT"
+
+# ---- Test 11: --file with dollar signs and variables ----
+printf '%s' '{"text":"Price is $100, env is ${HOME}"}' > "$TEMP_DIR/dollar.json"
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/dollar.json")
+assert_contains "--file preserves dollar signs" '$100' "$RESULT"
+assert_contains "--file preserves \\\${} syntax" '${HOME}' "$RESULT"
+
+# ---- Test 12: --file with newlines in JSON values ----
+printf '%s' '{"text":"line1\nline2\nline3"}' > "$TEMP_DIR/newlines.json"
+RESULT=$(bash "$TEMP_DIR/test_skill.sh" --file "$TEMP_DIR/newlines.json")
+assert_contains "--file preserves escaped newlines" 'line1\\nline2' "$RESULT"
+
+# ---- Test 13: --file with empty JSON ----
+echo '{}' > "$TEMP_DIR/empty.json"
+RESULT=$(bash "$TEMP_DIR/test_read_json.sh" --file "$TEMP_DIR/empty.json")
+assert_eq "--file with empty JSON" '{}' "$RESULT"
+
+echo ""
+echo "=== Results: $PASS/$TOTAL passed, $FAIL failed ==="
+
+if [ "$FAIL" -gt 0 ]; then
+  exit 1
+fi

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.d.ts

@@ -29,6 +29,17 @@ export declare class CommunicationModule implements PromptModule {
      * @returns Formatted markdown communication section
      */
     build(config: ModuleConfig): Promise<string>;
+    /**
+     * Build a skill call example snippet. For gemini-cli runtime, uses --file
+     * pattern to avoid shell escaping EOF errors. For other runtimes, uses
+     * inline JSON argument.
+     *
+     * @param config - Module configuration with runtime type
+     * @param skillPath - Relative path to the skill (e.g., 'core/report-status')
+     * @param jsonExample - Example JSON string for inline mode
+     * @returns Formatted bash code block
+     */
+    private buildSkillExample;
     /**
      * Full orchestrator communication spec — Slack, Chat UI, NOTIFY markers,
      * thread management, message formatting, and notification protocol.

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"communication.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACvD,IAAI,SAAmB;IACvB,QAAQ,SAAK;IACb,SAAS,SAAQ;IACjB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlD;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA0D9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAoBxB"}
+{"version":3,"file":"communication.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IACvD,IAAI,SAAmB;IACvB,QAAQ,SAAK;IACb,SAAS,SAAQ;IACjB,WAAW,UAAQ;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;;OAOG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBlD;;;;;;;;;OASG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA2D9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBxB"}

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.js

@@ -46,11 +46,36 @@ export class CommunicationModule {
         }
         return this.buildWorkerComms(config);
     }
+    /**
+     * Build a skill call example snippet. For gemini-cli runtime, uses --file
+     * pattern to avoid shell escaping EOF errors. For other runtimes, uses
+     * inline JSON argument.
+     *
+     * @param config - Module configuration with runtime type
+     * @param skillPath - Relative path to the skill (e.g., 'core/report-status')
+     * @param jsonExample - Example JSON string for inline mode
+     * @returns Formatted bash code block
+     */
+    buildSkillExample(config, skillPath, jsonExample) {
+        if (config.runtimeType === 'gemini-cli') {
+            return `\`\`\`bash
+printf '%s' '${jsonExample}' > /tmp/crewly_skill_input.json
+bash ${config.agentSkillsPath}/${skillPath}/execute.sh --file /tmp/crewly_skill_input.json
+\`\`\``;
+        }
+        return `\`\`\`bash
+bash ${config.agentSkillsPath}/${skillPath}/execute.sh '${jsonExample}'
+\`\`\``;
+    }
     /**
      * Full orchestrator communication spec — Slack, Chat UI, NOTIFY markers,
      * thread management, message formatting, and notification protocol.
      */
     buildOrchestratorComms(config) {
+        const reportStatusJson = `{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}`;
+        const sendMessageJson = '{"to":"<session>","message":"<msg>"}';
+        const reportExample = this.buildSkillExample(config, 'core/report-status', reportStatusJson);
+        const sendExample = this.buildSkillExample(config, 'core/send-message', sendMessageJson);
         return `## Communication Protocol
 
 ### Message Channels
@@ -100,30 +125,26 @@ When you receive a message from the user (via Slack, Chat UI, or Google Chat):
 This prevents the user from wondering if their message was received or if the agent is stuck.
 
 ### Communication Skills
-\`\`\`bash
-bash ${config.agentSkillsPath}/core/report-status/execute.sh '{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}'
-\`\`\`
-\`\`\`bash
-bash ${config.agentSkillsPath}/core/send-message/execute.sh '{"to":"<session>","message":"<msg>"}'
-\`\`\``;
+${reportExample}
+${sendExample}`;
     }
     /**
      * TL communication — delegation-focused messaging plus basic user comms.
      */
     buildTLComms(config) {
+        const reportStatusJson = `{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}`;
+        const sendMessageJson = '{"to":"<worker-session>","message":"<task or feedback>"}';
+        const reportExample = this.buildSkillExample(config, 'core/report-status', reportStatusJson);
+        const sendExample = this.buildSkillExample(config, 'core/send-message', sendMessageJson);
         return `## Communication Protocol
 
 ### Reporting to Orchestrator
 Use \`report-status\` to keep the orchestrator informed of progress:
-\`\`\`bash
-bash ${config.agentSkillsPath}/core/report-status/execute.sh '{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}'
-\`\`\`
+${reportExample}
 
 ### Messaging Workers
 Use \`send-message\` to communicate with your subordinates:
-\`\`\`bash
-bash ${config.agentSkillsPath}/core/send-message/execute.sh '{"to":"<worker-session>","message":"<task or feedback>"}'
-\`\`\`
+${sendExample}
 
 ### Communication Rules
 1. **Report up** — Keep orchestrator informed of progress and blockers
@@ -136,19 +157,19 @@ bash ${config.agentSkillsPath}/core/send-message/execute.sh '{"to":"<worker-sess
      * Worker communication — compact report-status and send-message only.
      */
     buildWorkerComms(config) {
+        const reportStatusJson = `{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}`;
+        const sendMessageJson = '{"to":"<session>","message":"<msg>"}';
+        const reportExample = this.buildSkillExample(config, 'core/report-status', reportStatusJson);
+        const sendExample = this.buildSkillExample(config, 'core/send-message', sendMessageJson);
         return `## Communication
 
 ### Reporting Progress
 Use \`report-status\` to update your team leader on task progress:
-\`\`\`bash
-bash ${config.agentSkillsPath}/core/report-status/execute.sh '{"sessionName":"${config.sessionName}","status":"<status>","summary":"<summary>","projectPath":"${config.projectPath || config.projectRoot}"}'
-\`\`\`
+${reportExample}
 
 ### Messaging
 Use \`send-message\` to communicate with other agents:
-\`\`\`bash
-bash ${config.agentSkillsPath}/core/send-message/execute.sh '{"to":"<session>","message":"<msg>"}'
-\`\`\`
+${sendExample}
 
 ### Rules
 - Report progress periodically so your team leader stays informed

package/dist/backend/backend/src/services/ai/prompt-modules/communication.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"communication.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAE5F;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,mBAAmB;IAC/B,IAAI,GAAG,eAAe,CAAC;IACvB,QAAQ,GAAG,CAAC,CAAC;IACb,SAAS,GAAG,IAAI,CAAC;IACjB,WAAW,GAAG,IAAI,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,OAAqB;QAClC,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC/B,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC;QACtD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC;QAEzC,4EAA4E;QAC5E,IAAI,cAAc,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YACpF,IAAI,QAAQ,EAAE,CAAC;gBACd,OAAO,QAAQ,CAAC;YACjB,CAAC;YACD,OAAO,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;OAGG;IACK,sBAAsB,CAAC,MAAoB;QAClD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkDF,MAAM,CAAC,eAAe,mDAAmD,MAAM,CAAC,WAAW,8DAA8D,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;;;OAGjM,MAAM,CAAC,eAAe;OACtB,CAAC;IACP,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,MAAoB;QACxC,OAAO;;;;;OAKF,MAAM,CAAC,eAAe,mDAAmD,MAAM,CAAC,WAAW,8DAA8D,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;;;;;;OAMjM,MAAM,CAAC,eAAe;;;;;;;;yEAQ4C,CAAC;IACzE,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,MAAoB;QAC5C,OAAO;;;;;OAKF,MAAM,CAAC,eAAe,mDAAmD,MAAM,CAAC,WAAW,8DAA8D,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW;;;;;;OAMjM,MAAM,CAAC,eAAe;;;;;;uCAMU,CAAC;IACvC,CAAC;CACD"}
+{"version":3,"file":"communication.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/communication.module.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.d.ts

@@ -34,6 +34,20 @@ export declare class SkillsReferenceModule implements PromptModule {
      * Workers get narrow read+execute scope; orchestrators get broader coordination scope.
      */
     private buildCapabilities;
+    /**
+     * Build safe skill calling guide for runtimes with shell escaping issues.
+     *
+     * Gemini CLI's run_shell_command mangles JSON arguments containing quotes,
+     * backticks, and parentheses, causing "unexpected EOF" shell errors.
+     * This guide instructs the agent to write JSON to a temp file first,
+     * then pass --file <path> to avoid shell interpretation entirely.
+     *
+     * Only included for gemini-cli runtime type.
+     *
+     * @param config - Module configuration with runtime type
+     * @returns Safe calling guide markdown, or null if not needed
+     */
+    private buildSafeCallGuide;
     /**
      * Build communication and memory tool instructions.
      */

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlD;;OAEG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB1B"}
+{"version":3,"file":"skills-reference.module.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE1E;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACzD,IAAI,SAAuB;IAC3B,QAAQ,SAAK;IACb,SAAS,SAAO;IAChB,WAAW,UAAS;IAEpB;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAI7C;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAalD;;OAEG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAiCzB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IA2B1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAkB1B"}

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js

@@ -29,7 +29,12 @@ export class SkillsReferenceModule {
         const coreSkills = this.buildCoreSkills(config);
         const capabilities = this.buildCapabilities(config);
         const communication = this.buildCommunication(config);
-        return `${coreSkills}\n\n${capabilities}\n\n${communication}`;
+        const safeCallGuide = this.buildSafeCallGuide(config);
+        const parts = [coreSkills, capabilities, communication];
+        if (safeCallGuide) {
+            parts.push(safeCallGuide);
+        }
+        return parts.join('\n\n');
     }
     /**
      * Build the core skills list — available to all roles.
@@ -74,6 +79,44 @@ export class SkillsReferenceModule {
         }
         return lines.join('\n');
     }
+    /**
+     * Build safe skill calling guide for runtimes with shell escaping issues.
+     *
+     * Gemini CLI's run_shell_command mangles JSON arguments containing quotes,
+     * backticks, and parentheses, causing "unexpected EOF" shell errors.
+     * This guide instructs the agent to write JSON to a temp file first,
+     * then pass --file <path> to avoid shell interpretation entirely.
+     *
+     * Only included for gemini-cli runtime type.
+     *
+     * @param config - Module configuration with runtime type
+     * @returns Safe calling guide markdown, or null if not needed
+     */
+    buildSafeCallGuide(config) {
+        if (config.runtimeType !== 'gemini-cli') {
+            return null;
+        }
+        return `## Safe Skill Calling (MANDATORY)
+
+**CRITICAL:** When calling any bash skill, you MUST use the \`--file\` pattern to avoid shell escaping errors.
+Passing JSON directly as a shell argument will cause "unexpected EOF" errors when the content contains quotes, backticks, or parentheses.
+
+### Required Pattern
+\`\`\`bash
+# Step 1: Write JSON to a temp file (printf preserves all special characters)
+printf '%s' '{"sessionName":"my-agent","status":"done","summary":"Fixed the bug"}' > /tmp/crewly_skill_input.json
+
+# Step 2: Call the skill with --file flag
+bash ${config.agentSkillsPath}/core/report-status/execute.sh --file /tmp/crewly_skill_input.json
+\`\`\`
+
+### Rules
+1. **ALWAYS** use \`printf '%s' '<json>' > /tmp/crewly_skill_input.json\` then \`--file\`
+2. **NEVER** pass JSON directly as a shell argument: \`bash execute.sh '{"key":"value with 'quotes'"}'\`
+3. Use \`/tmp/crewly_skill_input.json\` as the temp file (overwritten each call)
+4. This applies to ALL skills: report-status, send-message, remember, recall, delegate-task, reply-slack, reply-gchat, etc.
+5. For skills that support named flags (reply-slack, reply-gchat), you may also use \`--text-file\` for the message body`;
+    }
     /**
      * Build communication and memory tool instructions.
      */

package/dist/backend/backend/src/services/ai/prompt-modules/skills-reference.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills-reference.module.js","sourceRoot":"","sources":["../../../../../../../backend/src/services/ai/prompt-modules/skills-reference.module.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "crewly",
-  "version": "1.5.12",
+  "version": "1.5.13",
   "type": "module",
   "description": "Multi-agent orchestration platform for AI coding teams — coordinates Claude Code, Gemini CLI, and Codex agents with a real-time web dashboard",
   "main": "dist/cli/cli/src/index.js",