mitsupi 1.0.0

package/skills/openscad/tools/extract-params.sh

@@ -0,0 +1,147 @@
+#!/bin/bash
+# Extract customizable parameters from an OpenSCAD file
+# Usage: extract-params.sh input.scad [--json]
+#
+# Parses parameter declarations with special comments:
+#   param = value;           // [min:max] Description
+#   param = value;           // [min:step:max] Description  
+#   param = value;           // [opt1, opt2] Description
+#   param = value;           // Description only
+
+set -e
+
+if [ $# -lt 1 ]; then
+    echo "Usage: $0 input.scad [--json]"
+    exit 1
+fi
+
+INPUT="$1"
+JSON_OUTPUT=false
+
+if [ "$2" = "--json" ]; then
+    JSON_OUTPUT=true
+fi
+
+if [ ! -f "$INPUT" ]; then
+    echo "Error: File not found: $INPUT"
+    exit 1
+fi
+
+# Extract parameters using Python for better parsing
+extract_params() {
+    python3 -c '
+import sys
+import re
+
+filename = sys.argv[1]
+in_block = 0
+
+with open(filename, "r") as f:
+    for line in f:
+        # Track block depth (skip params inside modules/functions)
+        in_block += line.count("{") - line.count("}")
+        if in_block > 0:
+            continue
+            
+        # Match: varname = value; // comment
+        match = re.match(r"^\s*([a-zA-Z_][a-zA-Z0-9_]*)\s*=\s*([^;]+);\s*(?://\s*(.*))?", line)
+        if not match:
+            continue
+            
+        var_name = match.group(1)
+        value = match.group(2).strip()
+        comment = match.group(3) or ""
+        
+        # Determine type
+        if value in ("true", "false"):
+            var_type = "boolean"
+        elif re.match(r"^-?\d+$", value):
+            var_type = "integer"
+        elif re.match(r"^-?\d*\.?\d+$", value):
+            var_type = "number"
+        elif value.startswith("\"") and value.endswith("\""):
+            var_type = "string"
+            value = value[1:-1]  # Remove quotes
+        elif value.startswith("["):
+            var_type = "array"
+        else:
+            var_type = "expression"
+        
+        # Parse comment for range/options
+        range_val = ""
+        options_val = ""
+        description = comment
+        
+        range_match = re.match(r"\[([^\]]+)\]\s*(.*)", comment)
+        if range_match:
+            bracket_content = range_match.group(1)
+            description = range_match.group(2)
+            
+            # Check if numeric range (contains :) or options (contains ,)
+            if ":" in bracket_content and not "," in bracket_content:
+                range_val = bracket_content
+            else:
+                options_val = bracket_content
+        
+        # Output pipe-delimited
+        print(f"{var_name}|{value}|{var_type}|{range_val}|{options_val}|{description}")
+' "$INPUT"
+}
+
+if [ "$JSON_OUTPUT" = true ]; then
+    echo "["
+    first=true
+    while IFS='|' read -r name value type range options description; do
+        if [ "$first" = true ]; then
+            first=false
+        else
+            echo ","
+        fi
+        
+        # Escape quotes in values
+        value=$(echo "$value" | sed 's/"/\\"/g')
+        description=$(echo "$description" | sed 's/"/\\"/g')
+        
+        # Build JSON object
+        printf '  {\n'
+        printf '    "name": "%s",\n' "$name"
+        printf '    "value": "%s",\n' "$value"
+        printf '    "type": "%s"' "$type"
+        
+        if [ -n "$range" ]; then
+            printf ',\n    "range": "%s"' "$range"
+        fi
+        if [ -n "$options" ]; then
+            printf ',\n    "options": "%s"' "$options"
+        fi
+        if [ -n "$description" ]; then
+            printf ',\n    "description": "%s"' "$description"
+        fi
+        printf '\n  }'
+    done < <(extract_params)
+    echo ""
+    echo "]"
+else
+    echo "Parameters in: $INPUT"
+    echo "==============================================="
+    printf "%-20s %-15s %-10s %s\n" "NAME" "VALUE" "TYPE" "CONSTRAINT/DESC"
+    echo "-----------------------------------------------"
+    
+    while IFS='|' read -r name value type range options description; do
+        constraint=""
+        if [ -n "$range" ]; then
+            constraint="[$range]"
+        elif [ -n "$options" ]; then
+            constraint="[$options]"
+        fi
+        if [ -n "$description" ]; then
+            if [ -n "$constraint" ]; then
+                constraint="$constraint $description"
+            else
+                constraint="$description"
+            fi
+        fi
+        
+        printf "%-20s %-15s %-10s %s\n" "$name" "$value" "$type" "$constraint"
+    done < <(extract_params)
+fi

package/skills/openscad/tools/multi-preview.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+# Generate preview images from multiple angles
+# Usage: multi-preview.sh input.scad output_dir/ [-D 'var=value']
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+check_openscad
+
+if [ $# -lt 2 ]; then
+    echo "Usage: $0 input.scad output_dir/ [-D 'var=value' ...]"
+    exit 1
+fi
+
+INPUT="$1"
+OUTPUT_DIR="$2"
+shift 2
+
+# Collect -D parameters
+DEFINES=()
+while [ $# -gt 0 ]; do
+    case "$1" in
+        -D)
+            shift
+            DEFINES+=("-D" "$1")
+            ;;
+    esac
+    shift
+done
+
+mkdir -p "$OUTPUT_DIR"
+
+# Get base name without extension
+BASENAME=$(basename "$INPUT" .scad)
+
+echo "Generating multi-angle previews for: $INPUT"
+echo "Output directory: $OUTPUT_DIR"
+echo ""
+
+# Define angles as name:camera pairs
+# Camera format: translate_x,translate_y,translate_z,rot_x,rot_y,rot_z,distance
+ANGLES="iso:0,0,0,55,0,25,0
+front:0,0,0,90,0,0,0
+back:0,0,0,90,0,180,0
+left:0,0,0,90,0,90,0
+right:0,0,0,90,0,-90,0
+top:0,0,0,0,0,0,0"
+
+echo "$ANGLES" | while IFS=: read -r angle camera; do
+    output="$OUTPUT_DIR/${BASENAME}_${angle}.png"
+    
+    echo "  Rendering $angle view..."
+    $OPENSCAD \
+        --camera="$camera" \
+        --imgsize="800,600" \
+        --colorscheme="Tomorrow Night" \
+        --autocenter \
+        --viewall \
+        "${DEFINES[@]}" \
+        -o "$output" \
+        "$INPUT" 2>/dev/null
+done
+
+echo ""
+echo "Generated previews:"
+ls -la "$OUTPUT_DIR"/${BASENAME}_*.png

package/skills/openscad/tools/preview.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# Generate a preview PNG from an OpenSCAD file
+# Usage: preview.sh input.scad output.png [options]
+#
+# Options:
+#   --camera=x,y,z,rx,ry,rz,dist  Camera position
+#   --size=WxH                     Image size (default: 800x600)
+#   -D 'var=value'                 Set parameter value
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+check_openscad
+
+if [ $# -lt 2 ]; then
+    echo "Usage: $0 input.scad output.png [--camera=...] [--size=WxH] [-D 'var=val']"
+    echo ""
+    echo "Camera format: x,y,z,rotx,roty,rotz,distance"
+    echo "Common cameras:"
+    echo "  Isometric: --camera=0,0,0,55,0,25,200"
+    echo "  Front:     --camera=0,0,0,90,0,0,200"
+    echo "  Top:       --camera=0,0,0,0,0,0,200"
+    exit 1
+fi
+
+INPUT="$1"
+OUTPUT="$2"
+shift 2
+
+# Defaults
+CAMERA="0,0,0,55,0,25,0"
+SIZE="800,600"
+DEFINES=()
+
+# Parse options
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --camera=*)
+            CAMERA="${1#--camera=}"
+            ;;
+        --size=*)
+            SIZE="${1#--size=}"
+            SIZE="${SIZE/x/,}"
+            ;;
+        -D)
+            shift
+            DEFINES+=("-D" "$1")
+            ;;
+        *)
+            echo "Unknown option: $1"
+            exit 1
+            ;;
+    esac
+    shift
+done
+
+# Ensure output directory exists
+mkdir -p "$(dirname "$OUTPUT")"
+
+# Run OpenSCAD
+echo "Rendering preview: $INPUT -> $OUTPUT"
+$OPENSCAD \
+    --camera="$CAMERA" \
+    --imgsize="${SIZE}" \
+    --colorscheme="Tomorrow Night" \
+    --autocenter \
+    --viewall \
+    "${DEFINES[@]}" \
+    -o "$OUTPUT" \
+    "$INPUT"
+
+echo "Preview saved to: $OUTPUT"

package/skills/openscad/tools/render-with-params.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+# Render OpenSCAD with parameters from a JSON file
+# Usage: render-with-params.sh input.scad params.json output.stl|output.png
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+check_openscad
+
+if [ $# -lt 3 ]; then
+    echo "Usage: $0 input.scad params.json output.[stl|png]"
+    echo ""
+    echo "params.json format:"
+    echo '  {"width": 60, "height": 40, "include_lid": true}'
+    exit 1
+fi
+
+INPUT="$1"
+PARAMS_FILE="$2"
+OUTPUT="$3"
+
+if [ ! -f "$INPUT" ]; then
+    echo "Error: Input file not found: $INPUT"
+    exit 1
+fi
+
+if [ ! -f "$PARAMS_FILE" ]; then
+    echo "Error: Params file not found: $PARAMS_FILE"
+    exit 1
+fi
+
+# Build -D arguments from JSON
+DEFINES=()
+while IFS= read -r line; do
+    # Parse each key-value pair
+    key=$(echo "$line" | cut -d'=' -f1)
+    value=$(echo "$line" | cut -d'=' -f2-)
+    
+    if [ -n "$key" ]; then
+        DEFINES+=("-D" "$key=$value")
+    fi
+done < <(
+    # Use python or jq to parse JSON to key=value lines
+    if command -v python3 &> /dev/null; then
+        python3 -c "
+import json
+with open('$PARAMS_FILE') as f:
+    params = json.load(f)
+for k, v in params.items():
+    if isinstance(v, bool):
+        print(f'{k}={str(v).lower()}')
+    elif isinstance(v, str):
+        print(f'{k}=\"{v}\"')
+    else:
+        print(f'{k}={v}')
+"
+    elif command -v jq &> /dev/null; then
+        jq -r 'to_entries | .[] | "\(.key)=\(.value)"' "$PARAMS_FILE"
+    else
+        echo "Error: Requires python3 or jq to parse JSON"
+        exit 1
+    fi
+)
+
+echo "Rendering with parameters from: $PARAMS_FILE"
+echo "Parameters: ${DEFINES[*]}"
+
+# Determine output type and set appropriate options
+EXT="${OUTPUT##*.}"
+case "$EXT" in
+    stl|STL)
+        $OPENSCAD "${DEFINES[@]}" -o "$OUTPUT" "$INPUT"
+        ;;
+    png|PNG)
+        $OPENSCAD "${DEFINES[@]}" \
+            --camera="0,0,0,55,0,25,0" \
+            --imgsize="800,600" \
+            --colorscheme="Tomorrow Night" \
+            --autocenter --viewall \
+            -o "$OUTPUT" "$INPUT"
+        ;;
+    *)
+        echo "Unsupported output format: $EXT"
+        echo "Supported: stl, png"
+        exit 1
+        ;;
+esac
+
+echo "Output saved: $OUTPUT"

package/skills/openscad/tools/validate.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# Validate an OpenSCAD file for syntax errors
+# Usage: validate.sh input.scad
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "$SCRIPT_DIR/common.sh"
+
+check_openscad
+
+if [ $# -lt 1 ]; then
+    echo "Usage: $0 input.scad"
+    exit 1
+fi
+
+INPUT="$1"
+
+if [ ! -f "$INPUT" ]; then
+    echo "Error: File not found: $INPUT"
+    exit 1
+fi
+
+echo "Validating: $INPUT"
+
+# Create temp file for output
+TEMP_OUTPUT=$(mktemp /tmp/openscad_validate.XXXXXX.echo)
+trap "rm -f $TEMP_OUTPUT" EXIT
+
+# Run OpenSCAD with echo output (fastest way to check syntax)
+# Using --export-format=echo just parses and evaluates without rendering
+if $OPENSCAD -o "$TEMP_OUTPUT" --export-format=echo "$INPUT" 2>&1; then
+    echo "✓ Syntax OK"
+    
+    # Check for warnings in stderr
+    if [ -s "$TEMP_OUTPUT" ]; then
+        echo ""
+        echo "Echo output:"
+        cat "$TEMP_OUTPUT"
+    fi
+    
+    exit 0
+else
+    echo "✗ Validation failed"
+    exit 1
+fi

package/skills/pi-share/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: pi-share
+description: "Load and parse session transcripts from shittycodingagent.ai/buildwithpi.ai/buildwithpi.com (pi-share) URLs. Fetches gists, decodes embedded session data, and extracts conversation history."
+---
+
+# pi-share / buildwithpi Session Loader
+
+Load and parse session transcripts from pi-share URLs (shittycodingagent.ai, buildwithpi.ai, buildwithpi.com).
+
+## When to Use
+
+**Loading sessions:** Use this skill when the user provides a URL like:
+- `https://shittycodingagent.ai/session/?<gist_id>`
+- `https://buildwithpi.ai/session/?<gist_id>`
+- `https://buildwithpi.com/session/?<gist_id>`
+- Or just a gist ID like `46aee35206aefe99257bc5d5e60c6121`
+
+**Human summaries:** Use `--human-summary` when the user asks you to:
+- Summarize what a human did in a pi/coding agent session
+- Understand how a user interacted with an agent
+- Analyze user behavior, steering patterns, or prompting style
+- Get a human-centric view of a session (not what the agent did, but what the human did)
+
+The human summary focuses on: initial goals, re-prompts, steering/corrections, interventions, and overall prompting style.
+
+## How It Works
+
+1. Session exports are stored as GitHub Gists
+2. The URL contains a gist ID after the `?`
+3. The gist contains a `session.html` file with base64-encoded session data
+4. The helper script fetches and decodes this to extract the full conversation
+
+## Usage
+
+```bash
+# Get full session data (default)
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs "<url-or-gist-id>"
+
+# Get just the header
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --header
+
+# Get entries as JSON lines (one entry per line)
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --entries
+
+# Get the system prompt
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --system
+
+# Get tool definitions
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --tools
+
+# Get human-centric summary (what did the human do in this session?)
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs <gist-id> --human-summary
+```
+
+## Human Summary
+
+The `--human-summary` flag generates a ~300 word summary focused on the human's experience:
+- What was their initial goal?
+- How often did they re-prompt or steer the agent?
+- What kind of interventions did they make? (corrections, clarifications, frustration)
+- How specific or vague were their instructions?
+
+This uses claude-haiku-4-5 via `pi -p` to analyze the condensed session transcript.
+
+## Session Data Structure
+
+The decoded session contains:
+
+```typescript
+interface SessionData {
+  header: {
+    type: "session";
+    version: number;
+    id: string;           // Session UUID
+    timestamp: string;    // ISO timestamp
+    cwd: string;          // Working directory
+  };
+  entries: SessionEntry[];  // Conversation entries (JSON lines format)
+  leafId: string | null;    // Current branch leaf
+  systemPrompt?: string;    // System prompt text
+  tools?: { name: string; description: string }[];
+}
+```
+
+Entry types include:
+- `message` - User/assistant/toolResult messages with content blocks
+- `model_change` - Model switches  
+- `thinking_level_change` - Thinking mode changes
+- `compaction` - Context compaction events
+
+Message content block types:
+- `text` - Text content
+- `toolCall` - Tool invocation with `toolName` and `args`
+- `thinking` - Model thinking content
+- `image` - Embedded images
+
+## Example: Analyze a Session
+
+```bash
+# Pipe entries through jq to filter
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs "<url>" --entries | jq 'select(.type == "message" and .message.role == "user")'
+
+# Count tool calls
+node ~/.pi/agent/skills/pi-share/fetch-session.mjs "<url>" --entries | jq -s '[.[] | select(.type == "message") | .message.content[]? | select(.type == "toolCall")] | length'
+```