claude-flow-novice 2.18.5 → 2.18.6

package/.claude/skills/cfn-config/lib/sanitization/sanitize-environment.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+# CFN Environment Sanitization
+# Sanitizes environment variables and ensures secure execution context
+
+set -euo pipefail
+
+# Function to sanitize environment
+sanitize_environment() {
+    local agent_id="${1:-unknown}"
+    local task_id="${2:-unknown}"
+
+    # Remove sensitive environment variables
+    unset AWS_SECRET_ACCESS_KEY || true
+    unset OPENAI_API_KEY || true
+    unset ANTHROPIC_API_KEY || true
+    unset DATABASE_PASSWORD || true
+
+    # Set safe defaults
+    export NODE_ENV="${NODE_ENV:-production}"
+    export CFN_AGENT_ID="$agent_id"
+    export CFN_TASK_ID="$task_id"
+
+    # Validate critical paths - detect project root dynamically
+    local project_root=""
+    if [ -n "${CFN_PROJECT_ROOT:-}" ]; then
+        project_root="$CFN_PROJECT_ROOT"
+    elif [ -d ".claude" ] && [ -f "package.json" ]; then
+        project_root="$(pwd)"
+    else
+        # Try to find project root by searching upward
+        project_root="$(git rev-parse --show-toplevel 2>/dev/null || echo "$(pwd)")"
+    fi
+    
+    if [ ! -d "$project_root/.claude" ]; then
+        echo "WARNING: CFN project structure not found at $project_root" >&2
+        # Don't fail - continue with sanitization
+    fi
+
+    # Set secure permissions
+    umask 0077
+
+    return 0
+}
+
+# Main execution
+if [ "${BASH_SOURCE[0]}" = "${0}" ]; then
+    sanitize_environment "${1:-}" "${2:-}"
+fi

package/.claude/skills/cfn-conversation-sync/README.md

@@ -0,0 +1,133 @@
+# Conversation Sync Skill
+
+Automatically sync Claude Code conversation sessions from `.codex/sessions` to `.claude.json` for context preservation and backup.
+
+## Quick Start
+
+```bash
+# Sync conversations from last 7 days
+./.claude/skills/conversation-sync/sync-conversations.sh
+
+# Sync for this specific project
+./.claude/skills/conversation-sync/sync-conversations.sh --project claude-flow-novice
+
+# See what would be synced (dry run)
+./.claude/skills/conversation-sync/sync-conversations.sh --dry-run
+```
+
+## Use Cases
+
+### After System Crash
+When WSL, Docker, or VS Code crashes, conversation history in `.codex/sessions` can be referenced in `.claude.json` to restore context:
+
+```bash
+./.claude/skills/conversation-sync/sync-conversations.sh --days 1
+```
+
+### Project Handoff
+Before handing off a project, sync recent conversations for context:
+
+```bash
+./.claude/skills/conversation-sync/sync-conversations.sh --project myproject --days 14
+```
+
+### Backup Before Major Changes
+Create a conversation backup before major refactors:
+
+```bash
+./.claude/skills/conversation-sync/sync-conversations.sh --from 2025-11-01 --to 2025-11-26
+```
+
+## How It Works
+
+1. **Locates** `.codex/sessions` directory (supports Windows and Linux paths)
+2. **Filters** conversation JSONL files by:
+   - Date range (last N days or specific dates)
+   - Project working directory
+3. **Extracts** session metadata (ID, date, file path)
+4. **Updates** `.claude.json` with conversation references
+5. **Preserves** existing conversations (idempotent)
+
+## Options
+
+| Option | Description | Example |
+|--------|-------------|---------|
+| `--days N` | Sync last N days | `--days 14` |
+| `--project NAME` | Filter by project | `--project claude-flow-novice` |
+| `--from DATE` | Start date (YYYY-MM-DD) | `--from 2025-11-20` |
+| `--to DATE` | End date (YYYY-MM-DD) | `--to 2025-11-26` |
+| `--dry-run` | Preview without changes | `--dry-run` |
+| `-h, --help` | Show help | `-h` |
+
+## Output Format
+
+The skill updates `.claude.json`:
+
+```json
+{
+  "conversations": [
+    {
+      "session_id": "rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94",
+      "date": "2025/11/24",
+      "file": "/mnt/c/Users/masha/.codex/sessions/2025/11/24/rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94.jsonl"
+    }
+  ]
+}
+```
+
+## Conversation File Locations
+
+The skill searches these locations:
+
+1. `/mnt/c/Users/{username}/.codex/sessions/` (Windows/WSL)
+2. `~/.codex/sessions/` (Linux)
+3. `/mnt/c/Users/masha/.codex/sessions/` (fallback)
+
+## Requirements
+
+- `bash` 4.0+
+- `jq` (JSON processor)
+  ```bash
+  sudo apt-get install jq
+  ```
+- Read access to `.codex/sessions`
+
+## Safety Features
+
+- **Idempotent**: Safe to run multiple times
+- **Non-destructive**: Preserves existing conversations
+- **Dry-run mode**: Preview before changes
+- **Validation**: Checks file existence and JSON structure
+- **Sorted output**: Newest conversations first
+
+## Troubleshooting
+
+### "Could not find .codex/sessions directory"
+The `.codex` directory is created by Claude Code. Ensure you've used Claude Code at least once.
+
+### "jq is required but not installed"
+Install jq:
+```bash
+sudo apt-get install jq
+```
+
+### No conversations found
+Check date range and project filter. Use `--dry-run` to debug:
+```bash
+./.claude/skills/conversation-sync/sync-conversations.sh --dry-run --days 30
+```
+
+## Integration with Other Skills
+
+This skill can be called from other scripts:
+
+```bash
+# In your automation script
+./.claude/skills/conversation-sync/sync-conversations.sh --project "$PROJECT_NAME" --days 7
+```
+
+## Related
+
+- `.claude.json` - Conversation reference storage
+- `.codex/sessions/` - Source conversation data
+- `CLAUDE.md` - Project instructions (can reference conversations)

package/.claude/skills/cfn-conversation-sync/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: conversation-sync
+description: Sync conversation history from .codex/sessions to .claude.json for context preservation
+version: 1.0.1
+tags: [conversations, sync, backup, context]
+status: production
+triggers:
+  - copy conversations
+  - sync conversations
+  - import sessions
+  - conversation backup
+author: Claude Code
+---
+
+# Conversation Sync Skill
+
+This skill copies Claude Code conversation session files from `.codex/sessions` to the repository's `.claude.json` file for context preservation and backup.
+
+## Purpose
+
+When working across different environments (e.g., after WSL/Docker crashes), conversation history stored in `.codex/sessions` can be referenced in `.claude.json` to maintain context continuity.
+
+## Usage
+
+```bash
+# Sync conversations from last N days (default: 7)
+./.claude/skills/conversation-sync/sync-conversations.sh --days 7
+
+# Sync conversations from a specific project
+./.claude/skills/conversation-sync/sync-conversations.sh --project claude-flow-novice
+
+# Sync conversations from a specific date range
+./.claude/skills/conversation-sync/sync-conversations.sh --from 2025-11-20 --to 2025-11-26
+
+# Dry run (show what would be copied)
+./.claude/skills/conversation-sync/sync-conversations.sh --dry-run
+```
+
+## What It Does
+
+1. Searches `.codex/sessions` for conversation JSONL files
+2. Filters by project working directory (if specified)
+3. Filters by date range
+4. Creates/updates `.claude.json` with references to conversation files
+5. Preserves existing conversations in `.claude.json`
+
+## Output Format
+
+The skill updates `.claude.json` with this structure:
+
+```json
+{
+  "conversations": [
+    {
+      "session_id": "rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94",
+      "date": "2025/11/24",
+      "file": "/mnt/c/Users/masha/.codex/sessions/2025/11/24/rollout-2025-11-24T10-24-43-019ab71c-699f-7052-8ce1-892b6208ba94.jsonl"
+    }
+  ]
+}
+```
+
+## Notes
+
+- Conversation files remain in their original locations
+- Only references are added to `.claude.json`
+- Supports both Windows (`/mnt/c/Users/...`) and Linux paths with automatic normalization
+- Safe to run multiple times (idempotent)
+- Path normalization handles both backslashes (`\`) and forward slashes (`/`)
+- Case-insensitive matching for project filtering (works with mixed-case paths)
+
+## Location of Conversation Data
+
+- **Primary**: `/mnt/c/Users/{username}/.codex/sessions/YYYY/MM/DD/*.jsonl`
+- **Alternate**: `~/.codex/sessions/YYYY/MM/DD/*.jsonl`
+- **Docker mounts**: `/mnt/wsl/docker-desktop-bind-mounts/` (if applicable)
+
+## Requirements
+
+- `jq` - JSON processing
+- `bash` 4.0+
+- Access to `.codex/sessions` directory

package/.claude/skills/cfn-conversation-sync/sync-conversations.sh

@@ -0,0 +1,229 @@
+#!/usr/bin/env bash
+set -eu
+
+# Conversation Sync Script
+# Syncs Claude Code conversation sessions to .claude.json
+
+# Default values
+DAYS=7
+PROJECT=""
+FROM_DATE=""
+TO_DATE=""
+DRY_RUN=false
+CODEX_PATHS=(
+  "/mnt/c/Users/${USER}/.codex/sessions"
+  "${HOME}/.codex/sessions"
+)
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+log_info() {
+  echo -e "${GREEN}[INFO]${NC} $1"
+}
+
+log_warn() {
+  echo -e "${YELLOW}[WARN]${NC} $1"
+}
+
+log_error() {
+  echo -e "${RED}[ERROR]${NC} $1"
+}
+
+show_usage() {
+  cat << EOF
+Usage: $0 [OPTIONS]
+
+Sync Claude Code conversation sessions to .claude.json
+
+OPTIONS:
+  --days N            Sync conversations from last N days (default: 7)
+  --project NAME      Filter by project name (e.g., claude-flow-novice)
+  --from DATE         Start date (YYYY-MM-DD format)
+  --to DATE           End date (YYYY-MM-DD format)
+  --dry-run           Show what would be synced without making changes
+  -h, --help          Show this help message
+
+EXAMPLES:
+  # Sync last 7 days
+  $0
+
+  # Sync last 14 days for specific project
+  $0 --days 14 --project claude-flow-novice
+
+  # Sync specific date range
+  $0 --from 2025-11-20 --to 2025-11-26
+
+  # Dry run
+  $0 --dry-run
+
+EOF
+}
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    --days)
+      DAYS="$2"
+      shift 2
+      ;;
+    --project)
+      PROJECT="$2"
+      shift 2
+      ;;
+    --from)
+      FROM_DATE="$2"
+      shift 2
+      ;;
+    --to)
+      TO_DATE="$2"
+      shift 2
+      ;;
+    --dry-run)
+      DRY_RUN=true
+      shift
+      ;;
+    -h|--help)
+      show_usage
+      exit 0
+      ;;
+    *)
+      log_error "Unknown option: $1"
+      show_usage
+      exit 1
+      ;;
+  esac
+done
+
+# Find .codex/sessions directory
+CODEX_DIR=""
+for path in "${CODEX_PATHS[@]}"; do
+  if [ -d "$path" ]; then
+    CODEX_DIR="$path"
+    log_info "Found .codex/sessions at: $CODEX_DIR"
+    break
+  fi
+done
+
+if [ -z "$CODEX_DIR" ]; then
+  log_error "Could not find .codex/sessions directory"
+  log_error "Searched paths:"
+  printf '  %s\n' "${CODEX_PATHS[@]}"
+  exit 1
+fi
+
+# Check for jq
+if ! command -v jq &> /dev/null; then
+  log_error "jq is required but not installed"
+  log_error "Install with: sudo apt-get install jq"
+  exit 1
+fi
+
+# Calculate date range
+if [ -n "$FROM_DATE" ] && [ -n "$TO_DATE" ]; then
+  DATE_FILTER="-newermt '$FROM_DATE' ! -newermt '$TO_DATE 23:59:59'"
+elif [ -n "$DAYS" ]; then
+  DATE_FILTER="-mtime -$DAYS"
+else
+  DATE_FILTER=""
+fi
+
+# Find session files
+log_info "Searching for conversation files..."
+TEMP_LIST=$(mktemp)
+
+if [ -n "$DATE_FILTER" ]; then
+  eval "find '$CODEX_DIR' -name '*.jsonl' $DATE_FILTER" > "$TEMP_LIST" 2>/dev/null || true
+else
+  find "$CODEX_DIR" -name "*.jsonl" > "$TEMP_LIST" 2>/dev/null || true
+fi
+
+# Filter by project if specified
+if [ -n "$PROJECT" ]; then
+  log_info "Filtering by project: $PROJECT"
+  FILTERED_LIST=$(mktemp)
+
+  while IFS= read -r file; do
+    if [ -f "$file" ]; then
+      cwd=$(head -1 "$file" 2>/dev/null | jq -r '.payload.cwd // empty' 2>/dev/null || echo "")
+      norm_cwd=$(echo "$cwd" | sed 's|\\|/|g' | tr '[:upper:]' '[:lower:]')
+      norm_project=$(echo "$PROJECT" | tr '[:upper:]' '[:lower:]')
+      if [[ "$norm_cwd" == *"$norm_project"* ]]; then
+        echo "$file" >> "$FILTERED_LIST"
+      fi
+    fi
+  done < "$TEMP_LIST"
+
+  mv "$FILTERED_LIST" "$TEMP_LIST"
+fi
+
+# Count sessions found
+SESSION_COUNT=$(wc -l < "$TEMP_LIST")
+log_info "Found $SESSION_COUNT conversation sessions"
+
+if [ "$SESSION_COUNT" -eq 0 ]; then
+  log_warn "No conversations found matching criteria"
+  rm "$TEMP_LIST"
+  exit 0
+fi
+
+# Display found sessions
+if [ "$DRY_RUN" = true ]; then
+  log_info "Dry run - sessions that would be synced:"
+  while IFS= read -r file; do
+    session_id=$(basename "$file" .jsonl)
+    date=$(echo "$file" | grep -oP '\d{4}/\d{2}/\d{2}')
+    echo "  - $session_id ($date)"
+  done < "$TEMP_LIST"
+  rm "$TEMP_LIST"
+  exit 0
+fi
+
+# Read existing .claude.json or create new
+CLAUDE_JSON=".claude.json"
+if [ ! -f "$CLAUDE_JSON" ]; then
+  log_info "Creating new .claude.json"
+  echo '{"conversations":[]}' > "$CLAUDE_JSON"
+fi
+
+# Build new conversations array
+log_info "Building conversation list..."
+NEW_CONVERSATIONS="[]"
+
+# Add existing conversations (to preserve them)
+EXISTING_CONVERSATIONS=$(jq -c '.conversations // []' "$CLAUDE_JSON")
+
+# Add new conversations
+while IFS= read -r file; do
+  session_id=$(basename "$file" .jsonl)
+  date=$(echo "$file" | grep -oP '\d{4}/\d{2}/\d{2}')
+
+  # Check if session already exists
+  EXISTS=$(echo "$EXISTING_CONVERSATIONS" | jq --arg sid "$session_id" 'any(.[]; .session_id == $sid)')
+
+  if [ "$EXISTS" = "false" ]; then
+    NEW_ENTRY=$(jq -n \
+      --arg sid "$session_id" \
+      --arg date "$date" \
+      --arg file "$file" \
+      '{session_id: $sid, date: $date, file: $file}')
+
+    EXISTING_CONVERSATIONS=$(echo "$EXISTING_CONVERSATIONS" | jq --argjson entry "$NEW_ENTRY" '. += [$entry]')
+  fi
+done < "$TEMP_LIST"
+
+# Sort by date (newest first)
+SORTED_CONVERSATIONS=$(echo "$EXISTING_CONVERSATIONS" | jq 'sort_by(.date) | reverse')
+
+# Update .claude.json
+jq --argjson conversations "$SORTED_CONVERSATIONS" '.conversations = $conversations' "$CLAUDE_JSON" > "${CLAUDE_JSON}.tmp"
+mv "${CLAUDE_JSON}.tmp" "$CLAUDE_JSON"
+
+log_info "Successfully synced $SESSION_COUNT conversations to .claude.json"
+log_info "Total conversations in .claude.json: $(jq '.conversations | length' "$CLAUDE_JSON")"
+
+# Cleanup
+rm "$TEMP_LIST"

package/.claude/skills/cfn-dependency-management/SKILL.md

@@ -0,0 +1,118 @@
+---
+name: cfn-dependency-management
+description: Task dependency extraction and context ingestion
+version: 1.1.0
+tags: [mega-skill, dependencies, extraction, ingestion, orchestration]
+status: production
+---
+
+# Dependency Management Skill (Mega-Skill)
+
+**Version:** 1.1.0
+**Purpose:** Task dependency extraction and context ingestion
+**Status:** Production
+**Consolidates:** cfn-dependency-extractor, cfn-dependency-ingestion
+**Confidence:** 9.5/10 (with orchestration layer)
+
+---
+
+## Overview
+
+This mega-skill provides complete dependency handling:
+- **Extractor** - Parse task criteria, identify dependencies, generate execution order
+- **Ingestion** - Consume manifests, inject context, coordinate dependencies
+- **Orchestration** - Unified interface coordinating extraction and ingestion
+
+---
+
+## Directory Structure
+
+```
+dependency-management/
+├── SKILL.md
+├── execute.sh                    # Main orchestration script
+├── cfn-dependency-management.sh  # Skill wrapper entry point
+└── lib/
+    ├── extractor/                # From cfn-dependency-extractor
+    └── ingestion/                # From cfn-dependency-ingestion
+```
+
+---
+
+## Usage
+
+### Main Entry Point
+
+```bash
+# Basic usage
+./cfn-dependency-management.sh --task-description "Implement OAuth2 auth"
+
+# Save to file
+./cfn-dependency-management.sh --task-description "Build admin dashboard" --output-file deps.txt
+
+# Mode-specific execution
+./cfn-dependency-management.sh --task-description "Add user profiles" --mode mvp
+./cfn-dependency-management.sh --task-description "Full system audit" --mode enterprise --verbose
+```
+
+### Modes
+
+- **MVP**: Only P0 critical dependencies (fastest)
+- **Standard**: P0 and P1 dependencies (balanced)
+- **Enterprise**: All dependencies including deprecated (comprehensive)
+
+---
+
+## Pipeline Flow
+
+1. **Extraction** - Analyze task description → produce dependency graph
+2. **Mode Configuration** - Apply mode-specific filters (P0, P1, P2)
+3. **Ingestion** - Consume dependency graph → inject context for execution
+4. **Summary** - Generate execution report with critical path and parallel opportunities
+
+---
+
+## Migration Paths
+
+| Old Path | New Path |
+|----------|----------|
+| cfn-dependency-extractor/ | dependency-management/lib/extractor/ |
+| cfn-dependency-ingestion/ | dependency-management/lib/ingestion/ |
+
+---
+
+## Version History
+
+### 1.1.0 (2025-12-08)
+- Added execute.sh orchestration script
+- Added cfn-dependency-management.sh wrapper entry point
+- Implemented mode-based execution (mvp/standard/enterprise)
+- Added comprehensive help and error handling
+- Fixed coordination between extraction and ingestion
+
+### 1.0.0 (2025-12-02)
+- Consolidated extractor + ingestion into unified dependency pipeline
+
+---
+
+## Pipeline Flow
+
+1. Extractor analyzes task → produces dependency graph
+2. Ingestion consumes graph → injects context for execution
+
+---
+
+## Migration Paths
+
+| Old Path | New Path |
+|----------|----------|
+| cfn-dependency-extractor/ | dependency-management/lib/extractor/ |
+| cfn-dependency-ingestion/ | dependency-management/lib/ingestion/ |
+
+---
+
+## Version History
+
+### 1.0.0 (2025-12-02)
+- Consolidated extractor + ingestion into unified dependency pipeline
+

package/.claude/skills/cfn-dependency-management/cfn-dependency-management.sh

@@ -0,0 +1,18 @@
+#!/bin/bash
+
+# CFN Dependency Management - Skill Wrapper
+# Main entry point for the CFN Loop system
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+MAIN_SCRIPT="${SCRIPT_DIR}/execute.sh"
+
+# Check if the main script exists
+if [[ ! -f "$MAIN_SCRIPT" ]]; then
+    echo "Error: Main execution script not found: $MAIN_SCRIPT" >&2
+    exit 1
+fi
+
+# Forward all arguments to the main script
+exec "$MAIN_SCRIPT" "$@"