Merge pull request #1 from m0n0x41d/2.2.0_release

2.2.0 release

Author: m0n0x41d

.github/workflows/build-check.yml

@@ -0,0 +1,31 @@
+name: Build Check
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  check-dist-sync:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Run build
+        run: ./build.sh
+
+      - name: Check for uncommitted changes in dist/
+        run: |
+          if [[ -n $(git status dist/ --porcelain) ]]; then
+            echo "::error::dist/ is out of sync with src/commands/"
+            echo ""
+            echo "The following files differ after running build.sh:"
+            git status dist/ --porcelain
+            echo ""
+            echo "Please run ./build.sh and commit the changes to dist/"
+            exit 1
+          fi
+          echo "dist/ is in sync with src/commands/"

CHANGELOG.md

@@ -5,6 +5,49 @@ All notable changes to Crucible Code will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2025-12-14
+
+### Added
+
+#### Multi-Platform Support
+
+- **Four AI coding tools supported**: Claude Code, Cursor, Gemini CLI, Codex CLI
+- **Adapter-based build system**: Source commands in `src/commands/`, platform-specific outputs in `dist/`
+- **Platform adapters**: Transform markdown to platform-specific formats (TOML for Gemini, etc.)
+
+#### Interactive TUI Installer
+
+- **`curl | bash` one-liner install**: `curl -fsSL https://...install.sh | bash -s -- -g`
+- **Interactive platform selection**: Choose which AI tools to install commands for
+- **Global and per-project modes**: `-g` flag for global install, default for project-local
+- **Vim-style navigation**: Arrow keys and j/k for selection
+- **Bash 3.x compatibility**: Works on macOS default shell (no associative arrays)
+
+#### Uninstall Functionality
+
+- **`--uninstall` flag**: Remove installed FPF commands
+- **Auto-detection**: Finds commands in both global and local locations
+- **Platform-specific cleanup**: Only removes selected platforms
+
+#### CI/CD
+
+- **GitHub Actions workflow**: Verifies `dist/` stays in sync with `src/commands/`
+- **Build check on PR/push**: Fails if `./build.sh` produces uncommitted changes
+
+#### Visual Improvements
+
+- **Melted steel gradient**: Red → orange → yellow → white color scheme for ASCII banner
+- **SVG banner for GitHub**: `assets/banner.svg` with same gradient colors
+- **Cleaner TUI**: Simplified instructions, highlighted keys
+
+### Changed
+
+- **Directory structure**: Commands moved from `commands/` to `src/commands/` (source of truth)
+- **Installation targets**: Installer copies from `dist/{platform}/` not source
+- **README**: Updated with new install instructions and SVG banner
+
+---
+
 ## [2.1.0] - 2025-12-13
 
 ### Added

README.md

@@ -1,20 +1,8 @@
-# Crucible Code
+<img src="assets/banner.svg" alt="Crucible Code" width="600">
 
-```
- ______     ______     __  __     ______     __     ______     __         ______       
-/\  ___\   /\  == \   /\ \/\ \   /\  ___\   /\ \   /\  == \   /\ \       /\  ___\      
-\ \ \____  \ \  __<   \ \ \_\ \  \ \ \____  \ \ \  \ \  __<   \ \ \____  \ \  __\      
- \ \_____\  \ \_\ \_\  \ \_____\  \ \_____\  \ \_\  \ \_____\  \ \_____\  \ \_____\    
-  \/_____/   \/_/ /_/   \/_____/   \/_____/   \/_/   \/_____/   \/_____/   \/_____/    
-                                                                                       
-                      ______     ______     _____     ______                           
-                     /\  ___\   /\  __ \   /\  __-.  /\  ___\                          
-                     \ \ \____  \ \ \/\ \  \ \ \/\ \ \ \  __\                          
-                      \ \_____\  \ \_____\  \ \____-  \ \_____\                        
-                       \/_____/   \/_____/   \/____/   \/_____/                        
-```
+**Structured reasoning for AI coding tools** — make better decisions, remember why you made them.
 
-**Structured reasoning for Claude Code** — make better decisions, remember why you made them.
+**Works Exceptionally Well With Claude Code!**
 
 ## The Problem This Solves
 
@@ -33,18 +21,39 @@ FPF gives you a structured way to think through these decisions with Claude as a
 
 ## Quick Start
 
+### One-liner Install
+
+```bash
+# Global install (recommended for personal use)
+curl -fsSL https://raw.githubusercontent.com/m0n0x41d/crucible-code/main/install.sh | bash -s -- -g
+
+# Per-project install (run from project root)
+curl -fsSL https://raw.githubusercontent.com/m0n0x41d/crucible-code/main/install.sh | bash
+```
+
+This launches an interactive installer where you select which AI coding tools to install FPF commands for (Claude Code, Cursor, Gemini CLI, Codex CLI).
+
+**Global** installs to `~/.claude/commands/` etc. — available in all projects.
+**Per-project** installs to `./.claude/commands/` — commit to repo for team use.
+
+### Manual Install
+
 ```bash
-# 1. Install
 git clone https://github.com/m0n0x41d/crucible-code.git
 cd crucible-code
-./install.sh /path/to/your/project
+./install.sh                    # Interactive TUI
+./install.sh --claude -g        # Install Claude Code globally
+./install.sh --all              # Install all platforms
+```
+
+### Initialize in Your Project
 
-# 2. Initialize in your project
+```bash
 cd /path/to/your/project
-# Then in Claude Code:
-/fpf-0-init  # Claude will scan your repo and ask clarifying questions to build project context.
+# Then in your AI coding tool:
+/fpf-0-init  # Creates .fpf/ structure and scans your repo
 
-# 3. Start reasoning
+# Start reasoning
 /fpf-1-hypothesize "How should we handle state synchronization across browser tabs?"
 ```
 

adapters/claude.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Adapter: Claude Code
+# Format: Markdown (native - no transformation needed)
+# Output: dist/claude/
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+SRC_DIR="$ROOT_DIR/src/commands"
+OUT_DIR="$ROOT_DIR/dist/claude"
+
+mkdir -p "$OUT_DIR"
+
+for file in "$SRC_DIR"/*.md; do
+    filename=$(basename "$file")
+    cp "$file" "$OUT_DIR/$filename"
+done
+
+echo "Claude Code: $(ls "$OUT_DIR" | wc -l | tr -d ' ') commands"

adapters/codex.sh

@@ -0,0 +1,34 @@
+#!/bin/bash
+# Adapter: OpenAI Codex CLI
+# Format: Markdown with optional YAML frontmatter
+# Output: dist/codex/
+# Note: Codex uses same $ARGUMENTS syntax as Claude Code
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+SRC_DIR="$ROOT_DIR/src/commands"
+OUT_DIR="$ROOT_DIR/dist/codex"
+
+mkdir -p "$OUT_DIR"
+
+for file in "$SRC_DIR"/*.md; do
+    filename=$(basename "$file")
+    name="${filename%.md}"
+
+    # Extract first heading as description (remove # prefix)
+    description=$(head -20 "$file" | grep -m1 "^#" | sed 's/^#* *//' || echo "FPF command: $name")
+
+    # Create file with YAML frontmatter
+    {
+        echo "---"
+        echo "description: $description"
+        echo "argument-hint: (optional)"
+        echo "---"
+        echo ""
+        cat "$file"
+    } > "$OUT_DIR/$filename"
+done
+
+echo "Codex CLI: $(ls "$OUT_DIR" | wc -l | tr -d ' ') commands"

adapters/cursor.sh

@@ -0,0 +1,20 @@
+#!/bin/bash
+# Adapter: Cursor
+# Format: Markdown (same as Claude Code)
+# Output: dist/cursor/
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+SRC_DIR="$ROOT_DIR/src/commands"
+OUT_DIR="$ROOT_DIR/dist/cursor"
+
+mkdir -p "$OUT_DIR"
+
+for file in "$SRC_DIR"/*.md; do
+    filename=$(basename "$file")
+    cp "$file" "$OUT_DIR/$filename"
+done
+
+echo "Cursor: $(ls "$OUT_DIR" | wc -l | tr -d ' ') commands"

adapters/gemini.sh

@@ -0,0 +1,44 @@
+#!/bin/bash
+# Adapter: Gemini CLI
+# Format: TOML
+# Output: dist/gemini/
+# Transforms: $ARGUMENTS -> {{args}}, Markdown -> TOML wrapper
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ROOT_DIR="$(dirname "$SCRIPT_DIR")"
+SRC_DIR="$ROOT_DIR/src/commands"
+OUT_DIR="$ROOT_DIR/dist/gemini"
+
+mkdir -p "$OUT_DIR"
+
+escape_toml() {
+    # Escape backslashes and quotes for TOML multi-line string
+    sed 's/\\/\\\\/g' | sed 's/"""/\\"""/g'
+}
+
+for file in "$SRC_DIR"/*.md; do
+    filename=$(basename "$file")
+    name="${filename%.md}"
+    toml_file="$OUT_DIR/${name}.toml"
+
+    # Extract first heading as description
+    description=$(head -20 "$file" | grep -m1 "^#" | sed 's/^#* *//' || echo "FPF command: $name")
+    # Escape quotes in description
+    description=$(echo "$description" | sed 's/"/\\"/g')
+
+    # Read content, transform arguments, escape for TOML
+    content=$(cat "$file" | sed 's/\$ARGUMENTS/{{args}}/g' | sed 's/\$\([1-9]\)/{{\1}}/g' | escape_toml)
+
+    # Write TOML file
+    {
+        echo "description = \"$description\""
+        echo ""
+        echo "prompt = \"\"\""
+        echo "$content"
+        echo "\"\"\""
+    } > "$toml_file"
+done
+
+echo "Gemini CLI: $(ls "$OUT_DIR" | wc -l | tr -d ' ') commands"

assets/banner.svg

@@ -0,0 +1,23 @@
+#!/bin/bash
+# Build script: Runs all adapters to generate platform-specific commands
+# Output: dist/{platform}/
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ADAPTERS_DIR="$SCRIPT_DIR/adapters"
+
+echo "Building Crucible Code for all platforms..."
+echo ""
+
+# Clean dist
+rm -rf "$SCRIPT_DIR/dist"
+mkdir -p "$SCRIPT_DIR/dist"
+
+# Run each adapter
+for adapter in "$ADAPTERS_DIR"/*.sh; do
+    bash "$adapter"
+done
+
+echo ""
+echo "Build complete. Output in dist/"