wogiflow 1.0.0

package/scripts/flow-entropy-monitor.js

@@ -0,0 +1,345 @@
+#!/usr/bin/env node
+
+/**
+ * Wogi Flow - Memory Entropy Monitor
+ *
+ * Monitors memory health and triggers automatic cleanup when needed.
+ *
+ * Commands:
+ *   ./scripts/flow entropy          - Show entropy stats
+ *   ./scripts/flow entropy --auto   - Auto-compact if entropy > threshold
+ *   ./scripts/flow entropy --decay  - Apply relevance decay
+ *   ./scripts/flow entropy --history - Show entropy history
+ *
+ * Part of v1.8.0 - Automatic Memory Management
+ */
+
+const fs = require('fs');
+const path = require('path');
+const memoryDb = require('./flow-memory-db');
+
+// ============================================================
+// Configuration
+// ============================================================
+
+const PROJECT_ROOT = process.env.WOGI_PROJECT_ROOT || process.cwd();
+const CONFIG_PATH = path.join(PROJECT_ROOT, '.workflow', 'config.json');
+
+function loadConfig() {
+  try {
+    if (fs.existsSync(CONFIG_PATH)) {
+      return JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+    }
+  } catch {}
+  return {};
+}
+
+// ============================================================
+// Output Formatting
+// ============================================================
+
+function color(c, text) {
+  const colors = {
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    blue: '\x1b[34m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+    reset: '\x1b[0m'
+  };
+  return `${colors[c] || ''}${text}${colors.reset}`;
+}
+
+function formatEntropy(entropy) {
+  if (entropy < 0.4) return color('green', `${entropy} (healthy)`);
+  if (entropy < 0.7) return color('yellow', `${entropy} (moderate)`);
+  return color('red', `${entropy} (needs cleanup)`);
+}
+
+function formatStatus(status) {
+  switch (status) {
+    case 'healthy': return color('green', 'HEALTHY');
+    case 'moderate': return color('yellow', 'MODERATE');
+    case 'needs_cleanup': return color('red', 'NEEDS CLEANUP');
+    default: return status;
+  }
+}
+
+function formatPercent(value, max) {
+  const pct = max > 0 ? Math.round((value / max) * 100) : 0;
+  const bar = '█'.repeat(Math.floor(pct / 5)) + '░'.repeat(20 - Math.floor(pct / 5));
+  return `${bar} ${pct}%`;
+}
+
+// ============================================================
+// Commands
+// ============================================================
+
+/**
+ * Show entropy statistics
+ */
+async function showEntropy(config) {
+  const memoryConfig = {
+    maxLocalFacts: config.memory?.maxLocalFacts || 1000
+  };
+
+  const stats = await memoryDb.getEntropyStats(memoryConfig);
+
+  console.log(color('cyan', '\nMemory Entropy Report'));
+  console.log('═'.repeat(50));
+
+  console.log(`\nStatus: ${formatStatus(stats.status)}`);
+  console.log(`Entropy Score: ${formatEntropy(stats.entropy)}`);
+
+  console.log(`\n${color('blue', 'Facts')}`);
+  console.log(`  Active:     ${stats.totalFacts}/${stats.maxFacts}`);
+  console.log(`  Capacity:   ${formatPercent(stats.totalFacts, stats.maxFacts)}`);
+  console.log(`  Cold:       ${stats.coldFacts} (archived)`);
+
+  console.log(`\n${color('blue', 'Health Metrics')}`);
+  console.log(`  Avg Relevance:    ${Math.round(stats.avgRelevance * 100)}%`);
+  console.log(`  Never Accessed:   ${stats.neverAccessed} (${Math.round((stats.neverAccessed / Math.max(1, stats.totalFacts)) * 100)}%)`);
+  console.log(`  Low Relevance:    ${stats.lowRelevanceCount} (<30%)`);
+  console.log(`  Avg Age:          ${stats.avgAgeDays} days`);
+
+  console.log(`\n${color('blue', 'Entropy Components')}`);
+  console.log(`  Capacity (30%):      ${Math.round(Math.min(1, stats.totalFacts / stats.maxFacts) * 100)}%`);
+  console.log(`  Age (20%):           ${Math.round(Math.min(1, stats.avgAgeDays / 30) * 100)}%`);
+  console.log(`  Never Accessed (25%):${Math.round((stats.totalFacts > 0 ? stats.neverAccessed / stats.totalFacts : 0) * 100)}%`);
+  console.log(`  Low Relevance (25%): ${Math.round((stats.totalFacts > 0 ? stats.lowRelevanceCount / stats.totalFacts : 0) * 100)}%`);
+
+  if (stats.needsCompaction) {
+    console.log(`\n${color('yellow', '⚠ Memory needs compaction')}`);
+    console.log(`  Run: ${color('cyan', './scripts/flow compact-memory')}`);
+    console.log(`  Or:  ${color('cyan', './scripts/flow entropy --auto')}`);
+  }
+
+  console.log('');
+
+  return stats;
+}
+
+/**
+ * Apply relevance decay to all facts
+ */
+async function applyDecay(config) {
+  const decayConfig = {
+    decayRate: config.automaticMemory?.relevanceDecay?.decayRate || 0.033,
+    neverAccessedPenalty: config.automaticMemory?.relevanceDecay?.neverAccessedPenalty || 0.1
+  };
+
+  console.log(color('cyan', '\nApplying Relevance Decay'));
+  console.log('═'.repeat(50));
+
+  const beforeStats = await memoryDb.getEntropyStats();
+  console.log(`Before: Avg Relevance = ${Math.round(beforeStats.avgRelevance * 100)}%`);
+
+  const result = await memoryDb.applyRelevanceDecay(decayConfig);
+  console.log(`Decayed ${result.decayed} facts`);
+
+  const afterStats = await memoryDb.getEntropyStats();
+  console.log(`After:  Avg Relevance = ${Math.round(afterStats.avgRelevance * 100)}%`);
+
+  // Record metric
+  await memoryDb.recordMemoryMetric('decay');
+
+  console.log(color('green', '\n✓ Relevance decay applied'));
+}
+
+/**
+ * Auto-compact memory if entropy exceeds threshold
+ */
+async function autoCompact(config) {
+  const threshold = config.automaticMemory?.entropyThreshold || 0.7;
+  const memoryConfig = {
+    maxLocalFacts: config.memory?.maxLocalFacts || 1000
+  };
+
+  console.log(color('cyan', '\nAuto-Compact Check'));
+  console.log('═'.repeat(50));
+
+  const stats = await memoryDb.getEntropyStats(memoryConfig);
+  console.log(`Current Entropy: ${formatEntropy(stats.entropy)}`);
+  console.log(`Threshold:       ${threshold}`);
+
+  if (stats.entropy < threshold) {
+    console.log(color('green', '\n✓ Memory is healthy, no compaction needed'));
+    return { compacted: false, reason: 'below_threshold' };
+  }
+
+  console.log(color('yellow', '\n⚠ Entropy exceeds threshold, starting compaction...'));
+
+  const results = {
+    decay: null,
+    demotion: null,
+    merge: null,
+    purge: null
+  };
+
+  // 1. Apply relevance decay
+  console.log('\n1. Applying relevance decay...');
+  results.decay = await memoryDb.applyRelevanceDecay({
+    decayRate: config.automaticMemory?.relevanceDecay?.decayRate || 0.033,
+    neverAccessedPenalty: config.automaticMemory?.relevanceDecay?.neverAccessedPenalty || 0.1
+  });
+  console.log(`   Decayed: ${results.decay.decayed} facts`);
+
+  // 2. Demote low-relevance facts
+  console.log('\n2. Demoting low-relevance facts...');
+  results.demotion = await memoryDb.demoteToColdStorage({
+    relevanceThreshold: config.automaticMemory?.demotion?.relevanceThreshold || 0.3
+  });
+  console.log(`   Demoted: ${results.demotion.demoted} facts`);
+
+  // 3. Merge similar facts
+  console.log('\n3. Merging duplicate facts...');
+  results.merge = await memoryDb.mergeSimilarFacts({
+    mergeSimilarityThreshold: 0.95
+  });
+  console.log(`   Merged: ${results.merge.merged} duplicates`);
+
+  // 4. Purge old cold facts
+  console.log('\n4. Purging old cold storage...');
+  results.purge = await memoryDb.purgeColdFacts({
+    coldRetentionDays: config.automaticMemory?.demotion?.coldRetentionDays || 90
+  });
+  console.log(`   Purged: ${results.purge.purged} facts`);
+
+  // Record metric
+  await memoryDb.recordMemoryMetric('auto_compact');
+
+  // Show after stats
+  const afterStats = await memoryDb.getEntropyStats(memoryConfig);
+
+  console.log(color('cyan', '\nCompaction Results'));
+  console.log('═'.repeat(50));
+  console.log(`Entropy: ${formatEntropy(stats.entropy)} → ${formatEntropy(afterStats.entropy)}`);
+  console.log(`Facts:   ${stats.totalFacts} → ${afterStats.totalFacts}`);
+  console.log(`Cold:    ${stats.coldFacts} → ${afterStats.coldFacts}`);
+
+  console.log(color('green', '\n✓ Memory compaction complete'));
+
+  return {
+    compacted: true,
+    before: stats,
+    after: afterStats,
+    results
+  };
+}
+
+/**
+ * Show entropy history
+ */
+async function showHistory(limit = 30) {
+  console.log(color('cyan', '\nEntropy History'));
+  console.log('═'.repeat(70));
+
+  const metrics = await memoryDb.getMemoryMetrics(limit);
+
+  if (metrics.length === 0) {
+    console.log(color('gray', 'No history available yet.'));
+    return;
+  }
+
+  console.log(`${'Timestamp'.padEnd(20)} ${'Facts'.padEnd(8)} ${'Entropy'.padEnd(10)} ${'Action'}`);
+  console.log('-'.repeat(70));
+
+  for (const m of metrics) {
+    const ts = m.timestamp?.substring(0, 19) || 'N/A';
+    const facts = String(m.total_facts || 0).padEnd(8);
+    const entropy = String(m.entropy_score || 0).padEnd(10);
+    const action = m.action_taken || '-';
+
+    const entropyColor = m.entropy_score < 0.4 ? 'green' : m.entropy_score < 0.7 ? 'yellow' : 'red';
+
+    console.log(`${ts.padEnd(20)} ${facts} ${color(entropyColor, entropy)} ${action}`);
+  }
+
+  console.log('');
+}
+
+/**
+ * Show promotion candidates
+ */
+async function showPromotionCandidates(config) {
+  console.log(color('cyan', '\nPromotion Candidates'));
+  console.log('═'.repeat(70));
+
+  const candidates = await memoryDb.getPromotionCandidates({
+    minRelevance: config.automaticPromotion?.minRelevance || 0.8,
+    minAccessCount: config.automaticPromotion?.threshold || 3
+  });
+
+  if (candidates.length === 0) {
+    console.log(color('gray', 'No facts ready for promotion.'));
+    console.log('Facts need high relevance (80%+) and multiple accesses (3+).\n');
+    return [];
+  }
+
+  console.log(`Found ${color('green', candidates.length)} candidates:\n`);
+
+  for (const c of candidates.slice(0, 10)) {
+    const relevance = Math.round((c.relevance_score || 0) * 100);
+    console.log(`  ${color('green', '●')} [${relevance}%] (${c.access_count}x) ${c.fact.substring(0, 60)}...`);
+    console.log(`    Category: ${c.category || 'general'} | Scope: ${c.scope || 'local'}`);
+  }
+
+  if (candidates.length > 10) {
+    console.log(color('gray', `\n  ... and ${candidates.length - 10} more`));
+  }
+
+  console.log('');
+  return candidates;
+}
+
+// ============================================================
+// Main
+// ============================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+  const config = loadConfig();
+
+  try {
+    if (args.includes('--auto')) {
+      await autoCompact(config);
+    } else if (args.includes('--decay')) {
+      await applyDecay(config);
+    } else if (args.includes('--history')) {
+      const limit = parseInt(args[args.indexOf('--history') + 1]) || 30;
+      await showHistory(limit);
+    } else if (args.includes('--candidates')) {
+      await showPromotionCandidates(config);
+    } else if (args.includes('--help') || args.includes('-h')) {
+      console.log(`
+${color('cyan', 'Memory Entropy Monitor')}
+
+Usage: ./scripts/flow entropy [options]
+
+Options:
+  (none)        Show entropy statistics
+  --auto        Auto-compact if entropy > threshold
+  --decay       Apply relevance decay to all facts
+  --history [n] Show entropy history (last n entries, default 30)
+  --candidates  Show facts ready for promotion
+  --help, -h    Show this help
+
+Examples:
+  ./scripts/flow entropy              # Show current status
+  ./scripts/flow entropy --auto       # Auto-compact if needed
+  ./scripts/flow entropy --history 10 # Show last 10 metrics
+`);
+    } else {
+      await showEntropy(config);
+    }
+  } catch (error) {
+    console.error(color('red', `Error: ${error.message}`));
+    if (process.env.DEBUG) console.error(error.stack);
+    process.exit(1);
+  } finally {
+    memoryDb.closeDatabase();
+  }
+}
+
+main();

package/scripts/flow-export-profile

@@ -0,0 +1,349 @@
+#!/bin/bash
+
+# Wogi Flow - Export Profile
+# Export workflow configuration for team sharing
+# v2.1: Enhanced with rules, learnings, and templates
+
+set -e
+
+WORKFLOW_DIR=".workflow"
+PROFILES_DIR="wogi-profiles"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+DIM='\033[2m'
+NC='\033[0m'
+
+show_help() {
+    echo "Export Workflow Profile"
+    echo ""
+    echo "Usage: flow export-profile <profile-name> [options]"
+    echo ""
+    echo "Categories:"
+    echo "  --rules          Include .claude/rules/ and decisions.md"
+    echo "  --learnings      Include feedback-patterns.md and skill learnings"
+    echo "  --templates      Include sanitized project.md and roadmap templates"
+    echo "  --full           Include everything (all categories)"
+    echo ""
+    echo "Legacy options:"
+    echo "  --include-decisions    Include decisions.md only"
+    echo "  --include-app-map      Include app-map.md (component registry)"
+    echo ""
+    echo "Examples:"
+    echo "  flow export-profile my-team --full"
+    echo "  flow export-profile my-team --rules --learnings"
+    echo "  flow export-profile my-team --include-decisions"
+}
+
+if [ -z "$1" ] || [ "$1" = "--help" ] || [ "$1" = "-h" ]; then
+    show_help
+    exit 0
+fi
+
+PROFILE_NAME="$1"
+shift
+
+# Parse options
+INCLUDE_DECISIONS=false
+INCLUDE_APP_MAP=false
+INCLUDE_RULES=false
+INCLUDE_LEARNINGS=false
+INCLUDE_TEMPLATES=false
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --include-decisions)
+            INCLUDE_DECISIONS=true
+            ;;
+        --include-app-map)
+            INCLUDE_APP_MAP=true
+            ;;
+        --rules)
+            INCLUDE_RULES=true
+            INCLUDE_DECISIONS=true  # Rules require decisions
+            ;;
+        --learnings)
+            INCLUDE_LEARNINGS=true
+            ;;
+        --templates)
+            INCLUDE_TEMPLATES=true
+            ;;
+        --full)
+            INCLUDE_DECISIONS=true
+            INCLUDE_APP_MAP=true
+            INCLUDE_RULES=true
+            INCLUDE_LEARNINGS=true
+            INCLUDE_TEMPLATES=true
+            ;;
+        *)
+            echo -e "${RED}Unknown option: $1${NC}"
+            exit 1
+            ;;
+    esac
+    shift
+done
+
+# Create profiles directory
+mkdir -p "$PROFILES_DIR"
+
+# Create temp directory for profile
+TEMP_DIR=$(mktemp -d)
+PROFILE_DIR="$TEMP_DIR/$PROFILE_NAME"
+mkdir -p "$PROFILE_DIR/agents"
+mkdir -p "$PROFILE_DIR/.workflow"
+
+echo -e "${CYAN}╔══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${CYAN}║  Exporting Profile: $PROFILE_NAME${NC}"
+echo -e "${CYAN}╚══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+
+# Track what's included for metadata
+CONTENTS=""
+
+# ==========================================
+# CORE (always included)
+# ==========================================
+echo -e "${YELLOW}Core Files:${NC}"
+
+echo -e "  ${GREEN}✓${NC} CLAUDE.md"
+cp CLAUDE.md "$PROFILE_DIR/"
+CONTENTS="$CONTENTS\n- CLAUDE.md (core workflow instructions)"
+
+echo -e "  ${GREEN}✓${NC} agents/ ($(ls agents/*.md 2>/dev/null | wc -l | tr -d ' ') personas)"
+cp agents/*.md "$PROFILE_DIR/agents/" 2>/dev/null || true
+CONTENTS="$CONTENTS\n- agents/ (agent personas)"
+
+echo -e "  ${GREEN}✓${NC} config.json"
+cp "$WORKFLOW_DIR/config.json" "$PROFILE_DIR/.workflow/"
+CONTENTS="$CONTENTS\n- .workflow/config.json (configuration)"
+
+# ==========================================
+# RULES & DECISIONS
+# ==========================================
+if [ "$INCLUDE_DECISIONS" = true ] || [ "$INCLUDE_RULES" = true ]; then
+    echo ""
+    echo -e "${YELLOW}Rules & Decisions:${NC}"
+
+    # decisions.md
+    if [ -f "$WORKFLOW_DIR/state/decisions.md" ]; then
+        mkdir -p "$PROFILE_DIR/.workflow/state"
+        cp "$WORKFLOW_DIR/state/decisions.md" "$PROFILE_DIR/.workflow/state/"
+        echo -e "  ${GREEN}✓${NC} decisions.md"
+        CONTENTS="$CONTENTS\n- .workflow/state/decisions.md (project rules)"
+    fi
+
+    # .claude/rules/
+    if [ "$INCLUDE_RULES" = true ] && [ -d ".claude/rules" ]; then
+        mkdir -p "$PROFILE_DIR/.claude/rules"
+        # Copy all rule files except README.md (auto-generated)
+        for file in .claude/rules/*.md; do
+            if [ -f "$file" ] && [ "$(basename "$file")" != "README.md" ]; then
+                cp "$file" "$PROFILE_DIR/.claude/rules/"
+            fi
+        done
+        RULE_COUNT=$(ls "$PROFILE_DIR/.claude/rules/"*.md 2>/dev/null | wc -l | tr -d ' ')
+        if [ "$RULE_COUNT" -gt 0 ]; then
+            echo -e "  ${GREEN}✓${NC} .claude/rules/ ($RULE_COUNT rules)"
+            CONTENTS="$CONTENTS\n- .claude/rules/ (coding rules)"
+        fi
+    fi
+fi
+
+# ==========================================
+# APP MAP (optional)
+# ==========================================
+if [ "$INCLUDE_APP_MAP" = true ] && [ -f "$WORKFLOW_DIR/state/app-map.md" ]; then
+    echo ""
+    echo -e "${YELLOW}Component Registry:${NC}"
+    mkdir -p "$PROFILE_DIR/.workflow/state"
+    cp "$WORKFLOW_DIR/state/app-map.md" "$PROFILE_DIR/.workflow/state/"
+    echo -e "  ${GREEN}✓${NC} app-map.md"
+    CONTENTS="$CONTENTS\n- .workflow/state/app-map.md (component registry)"
+fi
+
+# ==========================================
+# LEARNINGS
+# ==========================================
+if [ "$INCLUDE_LEARNINGS" = true ]; then
+    echo ""
+    echo -e "${YELLOW}Learnings:${NC}"
+
+    # feedback-patterns.md
+    if [ -f "$WORKFLOW_DIR/state/feedback-patterns.md" ]; then
+        mkdir -p "$PROFILE_DIR/.workflow/state"
+        cp "$WORKFLOW_DIR/state/feedback-patterns.md" "$PROFILE_DIR/.workflow/state/"
+        echo -e "  ${GREEN}✓${NC} feedback-patterns.md"
+        CONTENTS="$CONTENTS\n- .workflow/state/feedback-patterns.md (team learnings)"
+    fi
+
+    # Skill learnings (patterns.md and learnings.md from each skill)
+    if [ -d ".claude/skills" ]; then
+        SKILL_COUNT=0
+        for skill_dir in .claude/skills/*/; do
+            if [ -d "$skill_dir/knowledge" ]; then
+                skill_name=$(basename "$skill_dir")
+                mkdir -p "$PROFILE_DIR/.claude/skills/$skill_name/knowledge"
+
+                # Copy patterns.md if exists
+                if [ -f "$skill_dir/knowledge/patterns.md" ]; then
+                    cp "$skill_dir/knowledge/patterns.md" "$PROFILE_DIR/.claude/skills/$skill_name/knowledge/"
+                    SKILL_COUNT=$((SKILL_COUNT + 1))
+                fi
+
+                # Copy learnings.md if exists
+                if [ -f "$skill_dir/knowledge/learnings.md" ]; then
+                    cp "$skill_dir/knowledge/learnings.md" "$PROFILE_DIR/.claude/skills/$skill_name/knowledge/"
+                fi
+            fi
+        done
+
+        if [ "$SKILL_COUNT" -gt 0 ]; then
+            echo -e "  ${GREEN}✓${NC} skill learnings ($SKILL_COUNT skills)"
+            CONTENTS="$CONTENTS\n- .claude/skills/*/knowledge/ (skill learnings)"
+        fi
+    fi
+fi
+
+# ==========================================
+# TEMPLATES (sanitized)
+# ==========================================
+if [ "$INCLUDE_TEMPLATES" = true ]; then
+    echo ""
+    echo -e "${YELLOW}Templates:${NC}"
+    mkdir -p "$PROFILE_DIR/templates"
+
+    # Sanitize and export project.md as template
+    if [ -f "$WORKFLOW_DIR/specs/project.md" ]; then
+        # Create a sanitized template (remove project-specific content)
+        cat > "$PROFILE_DIR/templates/project-template.md" << 'TEMPLATE_EOF'
+# Project Specification Template
+
+## Overview
+<!-- Fill in your project details -->
+**Name**: [PROJECT_NAME]
+**Description**: [PROJECT_DESCRIPTION]
+
+## Tech Stack
+<!-- Detected during onboarding -->
+- **Language**:
+- **Framework**:
+- **Database**:
+- **Package Manager**:
+
+## Architecture
+<!-- Document your architecture here -->
+
+## Key Components
+<!-- Auto-populated from codebase scan -->
+
+## Conventions
+<!-- Team conventions and standards -->
+
+## Goals
+<!-- Current project goals -->
+TEMPLATE_EOF
+        echo -e "  ${GREEN}✓${NC} project-template.md"
+        CONTENTS="$CONTENTS\n- templates/project-template.md"
+    fi
+
+    # Sanitize and export roadmap as template
+    if [ -f "$WORKFLOW_DIR/roadmap/roadmap.md" ]; then
+        cat > "$PROFILE_DIR/templates/roadmap-template.md" << 'ROADMAP_EOF'
+# Project Roadmap Template
+
+## Priority Levels
+- **P0**: Critical - Drop everything
+- **P1**: High - Do today
+- **P2**: Medium - Do this week
+- **P3**: Low - Do when possible
+- **P4**: Backlog - Someday
+
+## Current Sprint
+<!-- Add current sprint items -->
+
+## Upcoming
+<!-- Add upcoming work -->
+
+## Backlog
+<!-- Add backlog items -->
+
+## Completed
+<!-- Move completed items here -->
+ROADMAP_EOF
+        echo -e "  ${GREEN}✓${NC} roadmap-template.md"
+        CONTENTS="$CONTENTS\n- templates/roadmap-template.md"
+    fi
+fi
+
+# ==========================================
+# Create profile info file
+# ==========================================
+cat > "$PROFILE_DIR/PROFILE.md" << EOF
+# Wogi Flow Profile: $PROFILE_NAME
+
+Exported: $(date +%Y-%m-%d\ %H:%M)
+Source: $(git remote get-url origin 2>/dev/null || echo "local")
+Version: 2.1
+
+## Contents
+$(echo -e "$CONTENTS")
+
+## Import Instructions
+
+### New Project (during installation)
+\`\`\`bash
+./scripts/flow install
+# Select option 2: "Import from existing profile"
+# Enter path: $PROFILE_NAME.zip
+\`\`\`
+
+### Existing Project
+\`\`\`bash
+./scripts/flow import-profile $PROFILE_NAME.zip
+\`\`\`
+
+## Import Options
+\`\`\`bash
+# Preview what would be imported
+./scripts/flow import-profile $PROFILE_NAME.zip --dry-run
+
+# Create backup before importing
+./scripts/flow import-profile $PROFILE_NAME.zip --backup
+
+# Skip importing learnings
+./scripts/flow import-profile $PROFILE_NAME.zip --skip-learnings
+\`\`\`
+
+## Configuration Summary
+\`\`\`json
+$(head -30 "$WORKFLOW_DIR/config.json")
+...
+\`\`\`
+EOF
+
+# ==========================================
+# Create zip
+# ==========================================
+OUTPUT_FILE="$PROFILES_DIR/$PROFILE_NAME.zip"
+(cd "$TEMP_DIR" && zip -r "$PROFILE_NAME.zip" "$PROFILE_NAME" > /dev/null)
+mv "$TEMP_DIR/$PROFILE_NAME.zip" "$OUTPUT_FILE"
+
+# Cleanup
+rm -rf "$TEMP_DIR"
+
+# Calculate size
+SIZE=$(ls -lh "$OUTPUT_FILE" | awk '{print $5}')
+
+echo ""
+echo -e "${GREEN}╔══════════════════════════════════════════════════════════╗${NC}"
+echo -e "${GREEN}║  ✓ Profile exported successfully                         ║${NC}"
+echo -e "${GREEN}╚══════════════════════════════════════════════════════════╝${NC}"
+echo ""
+echo -e "  ${CYAN}File:${NC} $OUTPUT_FILE"
+echo -e "  ${CYAN}Size:${NC} $SIZE"
+echo ""
+echo -e "${DIM}Share this file with team members.${NC}"
+echo -e "${DIM}Import with: ./scripts/flow import-profile $OUTPUT_FILE${NC}"