Initial commit: AgentForceTest Salesforce DX project

.github/copilot-instructions.md

@@ -0,0 +1,113 @@
+# Copilot Instructions for AgentForceTest
+
+## Project Overview
+
+This is a **Salesforce DX project** (Agentforce) integrating Jira for project management. The codebase contains:
+
+- **Apex classes** for backend logic (e.g., JiraIntegration.cls)
+- **Lightning Web Components (LWC)** for UI (e.g., accountQuickCreate)
+- **Custom Salesforce objects** (Project\_\_c with Budget, Start Date fields)
+- **SFDX tooling** for deployment and testing
+
+## Architecture & Key Components
+
+### Project Structure
+
+- `force-app/main/default/` - Core SFDX package directory
+  - `classes/` - Apex backend logic
+  - `lwc/` - Lightning Web Components (LWC)
+  - `objects/` - Custom Salesforce objects with metadata
+  - `tabs/`, `layouts/`, `flexipages/` - UI configuration
+- `scripts/` - SOQL queries and Apex scripts for development
+- `config/project-scratch-def.json` - Scratch org configuration
+- `mdapiOut/` - Metadata API deployment artifacts
+
+### Data Integration
+
+- **JiraIntegration.cls** bridges Salesforce with Jira via REST API
+- **Project\_\_c custom object** stores Salesforce-side project data (Budget, Start Date)
+- Integration pattern: Account Quick Create → Project creation → Jira sync
+
+## Development Workflows
+
+### Code Quality & Linting
+
+```bash
+npm run lint                  # Run ESLint on Aura/LWC JS files
+eslint force-app/main/default/lwc/**/*.js --fix  # Auto-fix with flat config
+npm run prettier             # Format all supported file types
+npm run prettier:verify      # Check formatting without changes
+```
+
+### Testing
+
+```bash
+npm run test                 # Run all LWC unit tests
+npm run test:unit:watch     # Watch mode for TDD
+npm run test:unit:debug     # Debug mode
+npm run test:unit:coverage  # Coverage report
+```
+
+**Key detail:** Jest config uses `sfdx-lwc-jest` with mock modules. Test files use `.test.js` suffix.
+
+### Pre-commit Hooks
+
+Configured via `lint-staged` and Husky:
+
+- Automatically runs Prettier on staged files
+- Runs ESLint on LWC/Aura JS
+- Runs Jest tests on LWC components before commit
+
+## Code Conventions
+
+### Apex Classes
+
+- Use `public with sharing` for security
+- Document public methods with JSDoc-style comments
+- Follow: `public String processAccount(String accountId)` pattern
+- Placeholder implementations include return statements with descriptive messages
+
+### LWC Components
+
+- Import from `'lwc'` core: `LightningElement`, `track`, `wire`, etc.
+- Use `@track` for reactive properties
+- Show toasts via `ShowToastEvent` for user feedback
+- Validation: Last Name required (per standard contact requirements), email optional
+- Component files: `<name>.js` (logic), `<name>.html` (template), `<name>.js-meta.xml` (metadata)
+
+### Metadata XML Files
+
+- Custom objects stored as `.object-meta.xml` with field definitions
+- Tab definitions in `tabs/<ObjectName>.tab-meta.xml`
+- All metadata follows Salesforce v65.0 API schema
+- **Important:** Remove compactLayoutAssignment to avoid deployment errors
+
+## External Integrations
+
+### Jira REST API
+
+- **Endpoint:** `https://shaikmosina.atlassian.net/rest/api/2/`
+- **Auth:** Basic auth (email:API_token Base64 encoded)
+- **Usage:** JiraIntegration.cls handles transitions, issue updates
+- **Common operations:** Transition status (e.g., move to "To Do" via transition ID 11)
+
+### Salesforce CLI (SFDX)
+
+- Project uses `sfdx-project.json` (v65.0 API)
+- Namespace: empty (unmanaged package)
+- Default package path: `force-app/`
+
+## Important Patterns & Gotchas
+
+1. **ESLint Config:** Uses modern flat config (`eslint/config`), not legacy `.eslintrc.json`
+2. **Test Isolation:** LWC test rules differ from regular LWC rules (wire adapter warnings disabled)
+3. **Aura + LWC:** Both supported; Aura uses its own ESLint config via `@salesforce/eslint-plugin-aura`
+4. **Metadata Deployment:** Verify all XML files are valid; bad metadata blocks SFDX deployments
+5. **Git Hooks:** Husky requires `npm install`; run `npm run prepare` if hooks don't trigger
+
+## Quick References
+
+- **Salesforce Docs:** https://developer.salesforce.com/tools/vscode/
+- **Salesforce CLI:** https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/
+- **LWC Best Practices:** Review `accountQuickCreate.js` for input handling and validation patterns
+- **API Version:** 65.0 (see sfdx-project.json)