export const FOSSAPP_KNOWLEDGE: KnowledgeBase = {
  appName: 'FOSSAPP',
  appDescription: '...',
  lastUpdated: '2025-12-31',  // ← UPDATE THIS!

  features: {
    featureName: {
      name: 'Feature Display Name',
      description: 'One-sentence summary',
      capabilities: [
        'What users can do',
        'Main features',
      ],
      limitations: [
        'What users cannot do',
        'Known constraints',
      ],
      howTo: {
        'actionName': 'Step-by-step instructions',
      },
      statuses: {
        'statusCode': 'What this status means',
      },
    },
  },

  commonQuestions: {
    'How do I...?': 'Answer with specifics',
  },
}

// Add to features object in knowledge-base.ts
newFeature: {
  name: 'New Feature',
  description: 'What this feature does in one sentence',
  capabilities: [
    'List what users can do',
    'Focus on value, not implementation',
  ],
  limitations: [
    'What they cannot do (if any)',
  ],
  howTo: {
    'commonTask': 'Navigate to... → Click... → Enter...',
  },
},

// Adding the "Reports" feature
reports: {
  name: 'Reports',
  description: 'Generate PDF reports for projects with product lists and specifications',
  capabilities: [
    'Generate project summary reports',
    'Export product specifications to PDF',
    'Include pricing and availability data',
    'Send reports via email',
  ],
  limitations: [
    'Reports are generated asynchronously (may take 30-60 seconds)',
    'Maximum 1000 products per report',
  ],
  howTo: {
    'generateReport': 'Navigate to Projects → Select project → Reports tab → Click "Generate Report"',
    'emailReport': 'After generation, click "Email" and enter recipient address',
  },
},

// Find the relevant feature and ADD to capabilities array
projects: {
  name: 'Projects',
  // ... existing fields
  capabilities: [
    'Existing capability 1',
    'Existing capability 2',
    'NEW: Your new capability',  // ← ADD THIS
  ],
  howTo: {
    // ... existing howTo
    'newAction': 'How to use the new capability',  // ← ADD THIS
  },
},

// Added project archiving capability
projects: {
  name: 'Projects',
  capabilities: [
    'Create and manage projects with customer association',
    'Organize projects into phases and areas',
    'Archive completed projects',  // ← NEW
  ],
  howTo: {
    // ... existing
    'archiveProject': 'Open project → Click menu (⋮) → Select "Archive"',  // ← NEW
  },
},

// Add to statuses object
projects: {
  // ... existing fields
  statuses: {
    'draft': 'Initial project state, still being set up',
    'quotation': 'Project is in quotation phase',
    'approved': 'Project has been approved by client',
    'archived': 'Project is archived and read-only',  // ← NEW
  },
},

// Update description and/or add limitation
tiles: {
  name: 'Tiles',
  description: 'Generate DWG tiles from product selections with background processing',  // ← UPDATED
  capabilities: [
    'Create tile layouts from product placements',
    'Monitor generation progress in real-time',  // ← UPDATED
  ],
  limitations: [
    'Generation is asynchronous (30-120 seconds)',  // ← ADDED
    'Maximum 20 products per tile',
  ],
},

// You added a new "Export to Excel" feature
// But forgot to update knowledge-base.ts

User: "Can I export projects to Excel?"
AI: "I don't have information about Excel export capabilities."
// ← USER FRUSTRATED!

capabilities: [
  'Manage products',  // ❌ TOO VAGUE
]

// Better:
capabilities: [
  'Search products by keyword, supplier, or ETIM class',
  'Filter products by specifications (IP rating, CCT, power)',
  'View detailed product specifications and datasheets',
  'Add products to project areas with quantities',
]

// You added a complex workflow but no instructions

User: "How do I generate a tile?"
AI: "I know tiles exist but I don't have detailed instructions on how to generate them."
// ← USER CONFUSED!

// Old entry (no longer accurate)
tiles: {
  capabilities: [
    'Generate tiles synchronously',  // ❌ WRONG NOW
  ],
}

// Feature changed to async but knowledge base wasn't updated

// NEW FILE: src/app/favorites/page.tsx
// NEW FILE: src/lib/actions/favorites.ts
// NEW API: src/app/api/favorites/route.ts

// KNOWLEDGE BASE UPDATE REQUIRED:

favorites: {
  name: 'Favorites',
  description: 'Save and organize your favorite products for quick access',
  capabilities: [
    'Mark products as favorites from any product card',
    'View all favorites in one place',
    'Organize favorites into custom lists',
    'Share favorite lists with team members',
    'Add favorites directly to project areas',
  ],
  limitations: [
    'Maximum 500 favorites per user',
    'Shared lists are read-only for recipients',
  ],
  howTo: {
    'addFavorite': 'Click the star icon on any product card',
    'viewFavorites': 'Navigate to Favorites from the main menu',
    'createList': 'Go to Favorites → Click "New List" → Name your list',
    'shareList': 'Open a list → Click share icon → Enter email addresses',
  },
},

// ALSO UPDATE:
commonQuestions: {
  'Can I save products for later?': 'Yes! Use the Favorites feature to bookmark products. Click the star icon on any product card.',
  'How do I organize my favorite products?': 'Create custom lists in the Favorites section. You can organize by project, product type, or any way that makes sense to you.',
},

// DON'T FORGET:
lastUpdated: '2025-12-31',  // ← Update this!

// ❌ Developer perspective
capabilities: [
  'Execute RPC function for supplier aggregation',
]

// ✅ User perspective
capabilities: [
  'View product counts grouped by supplier',
]

// ❌ Generic
'Search for items in the database'

// ✅ Specific
'Search 56,000+ lighting products from Delta Light, Modular, and other suppliers'

limitations: [
  'Maximum 1000 products per project area',
  'Project names must be unique per customer',
  'Cannot delete areas with products (remove products first)',
]