npm - proagents - Versions diffs - 1.6.19 → 1.6.21 - Mend

proagents 1.6.19 → 1.6.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (143) hide show

package/.claude/settings.local.json +13 -1
package/.proagents/.cursorrules +25 -10
package/.proagents/.windsurfrules +25 -10
package/.proagents/AGENTS.md +30 -11
package/.proagents/AI_INSTRUCTIONS.md +86 -30
package/.proagents/BOLT.md +25 -10
package/.proagents/CLAUDE.md +25 -10
package/.proagents/GEMINI.md +25 -10
package/.proagents/KIRO.md +25 -10
package/.proagents/LOVABLE.md +25 -10
package/.proagents/PROAGENTS.md +96 -343
package/.proagents/REPLIT.md +25 -10
package/.proagents/activity.log +1 -0
package/.proagents/custom-commands.yaml +0 -1
package/.proagents/docs/command-details.md +1 -2
package/.proagents/getting-started/ai-training-setup.md +0 -1
package/.proagents/performance/README.md +59 -0
package/.proagents/performance/bundle-analysis.md +375 -0
package/.proagents/performance/load-testing.md +563 -0
package/.proagents/performance/runtime-metrics.md +489 -0
package/.proagents/performance/web-vitals.md +425 -0
package/.proagents/platforms.yaml +66 -0
package/.proagents/proagents.config.yaml +0 -1
package/.proagents/prompts/ai-add.md +80 -0
package/.proagents/prompts/ai-list.md +41 -0
package/.proagents/prompts/ai-remove.md +112 -0
package/.proagents/prompts/ai-sync.md +96 -0
package/.proagents/workflow-modes/entry-modes.md +1 -6
package/lib/commands/ai.js +100 -48
package/lib/commands/init.js +89 -22
package/package.json +1 -1
package/.proagents/ANTIGRAVITY.md +0 -61
package/.proagents/CHATGPT.md +0 -57
package/.proagents/GROQ.md +0 -57
package/.proagents/api-versioning/README.md +0 -257
package/.proagents/api-versioning/changelog-template.md +0 -225
package/.proagents/api-versioning/deprecation-workflow.md +0 -470
package/.proagents/api-versioning/versioning-strategy.md +0 -291
package/.proagents/automation/README.md +0 -38
package/.proagents/automation/ai-behavior-rules.md +0 -339
package/.proagents/automation/ai-prompt-injection.md +0 -331
package/.proagents/automation/auto-decisions.md +0 -535
package/.proagents/automation/decision-defaults.yaml +0 -317
package/.proagents/cache/README.md +0 -110
package/.proagents/cache/analysis-metadata.json +0 -76
package/.proagents/cache/conventions.json +0 -125
package/.proagents/cache/dependencies.json +0 -85
package/.proagents/cache/features.json +0 -115
package/.proagents/cache/patterns.json +0 -105
package/.proagents/cache/schemas/conventions-schema.json +0 -138
package/.proagents/cache/schemas/dependencies-schema.json +0 -95
package/.proagents/cache/schemas/features-schema.json +0 -104
package/.proagents/cache/schemas/metadata-schema.json +0 -83
package/.proagents/cache/schemas/patterns-schema.json +0 -136
package/.proagents/cache/schemas/structure-schema.json +0 -72
package/.proagents/cache/structure.json +0 -109
package/.proagents/checklists/README.md +0 -261
package/.proagents/checklists/code-quality.md +0 -137
package/.proagents/checklists/code-review.md +0 -148
package/.proagents/checklists/pr-checklist.md +0 -78
package/.proagents/checklists/pre-deployment.md +0 -132
package/.proagents/checklists/pre-implementation.md +0 -80
package/.proagents/checklists/testing.md +0 -120
package/.proagents/checkpoints.json +0 -13
package/.proagents/cicd/README.md +0 -338
package/.proagents/cicd/azure-devops.md +0 -267
package/.proagents/cicd/github-actions.md +0 -375
package/.proagents/cicd/gitlab-ci.md +0 -278
package/.proagents/cicd/jenkins.md +0 -317
package/.proagents/collaboration/README.md +0 -143
package/.proagents/collaboration/roles.md +0 -248
package/.proagents/collaboration/sessions.md +0 -390
package/.proagents/collaboration/sync.md +0 -358
package/.proagents/cost/README.md +0 -48
package/.proagents/cost/cost-template.md +0 -283
package/.proagents/cost/estimation-framework.md +0 -287
package/.proagents/database/README.md +0 -72
package/.proagents/database/examples/001-create-users.sql +0 -129
package/.proagents/database/examples/002-add-preferences.sql +0 -94
package/.proagents/database/examples/003-add-index.sql +0 -105
package/.proagents/database/examples/004-rename-column.sql +0 -122
package/.proagents/database/examples/005-add-foreign-key.sql +0 -142
package/.proagents/database/examples/006-data-migration.sql +0 -196
package/.proagents/database/examples/007-drop-column.sql +0 -163
package/.proagents/database/examples/README.md +0 -89
package/.proagents/database/migration-workflow.md +0 -478
package/.proagents/database/rollback-scripts.md +0 -487
package/.proagents/database/safety-checks.md +0 -447
package/.proagents/git/README.md +0 -68
package/.proagents/git/branch-strategy.md +0 -164
package/.proagents/git/commit-conventions.md +0 -241
package/.proagents/git/pr-workflow.md +0 -286
package/.proagents/git/rollback-procedures.md +0 -416
package/.proagents/ide-integration/README.md +0 -124
package/.proagents/ide-integration/cline-config.md +0 -429
package/.proagents/ide-integration/continue-config.md +0 -380
package/.proagents/ide-integration/cursor-rules.md +0 -280
package/.proagents/ide-integration/github-copilot.md +0 -384
package/.proagents/ide-integration/windsurf-rules.md +0 -314
package/.proagents/integrations/README.md +0 -97
package/.proagents/integrations/pm/README.md +0 -344
package/.proagents/learning/README.md +0 -136
package/.proagents/learning/adaptation.md +0 -305
package/.proagents/learning/data-collection.md +0 -283
package/.proagents/learning/implementation-guide.md +0 -865
package/.proagents/learning/reports.md +0 -306
package/.proagents/mcp/README.md +0 -133
package/.proagents/mcp/context-providers.md +0 -442
package/.proagents/mcp/server-config.md +0 -306
package/.proagents/mcp/tools-definition.md +0 -513
package/.proagents/pm-integration/README.md +0 -151
package/.proagents/pm-integration/asana.md +0 -346
package/.proagents/pm-integration/github-issues.md +0 -308
package/.proagents/pm-integration/gitlab-issues.md +0 -482
package/.proagents/pm-integration/jira.md +0 -364
package/.proagents/pm-integration/linear.md +0 -409
package/.proagents/pm-integration/notion.md +0 -275
package/.proagents/pm-integration/sync-config.md +0 -533
package/.proagents/pm-integration/trello.md +0 -159
package/.proagents/rules/README.md +0 -179
package/.proagents/rules/custom-rules-template.yaml +0 -286
package/.proagents/rules/custom-rules.md +0 -754
package/.proagents/rules/validation-rules-template.yaml +0 -517
package/.proagents/runbooks/README.md +0 -219
package/.proagents/runbooks/dependency-vulnerability.md +0 -505
package/.proagents/runbooks/incident-response.md +0 -451
package/.proagents/runbooks/performance-degradation.md +0 -584
package/.proagents/runbooks/production-debugging.md +0 -489
package/.proagents/sprints/README.md +0 -58
package/.proagents/team/README.md +0 -256
package/.proagents/team/code-ownership.md +0 -306
package/.proagents/team/communication-templates.md +0 -441
package/.proagents/team/handoff-protocol.md +0 -380
package/.proagents/team/ide-setup/README.md +0 -103
package/.proagents/team/ide-setup/cursor.md +0 -276
package/.proagents/team/ide-setup/jetbrains.md +0 -330
package/.proagents/team/ide-setup/neovim.md +0 -640
package/.proagents/team/ide-setup/vscode.md +0 -348
package/.proagents/team/onboarding.md +0 -278
package/.proagents/time-tracking.json +0 -19
package/.proagents/troubleshooting/README.md +0 -730
package/.proagents/troubleshooting/ai-issues.md +0 -601
package/.proagents/troubleshooting/workflow-issues.md +0 -571

package/.proagents/performance/web-vitals.md ADDED Viewed

@@ -0,0 +1,425 @@
+# Web Vitals Performance Guide
+Monitor and optimize Core Web Vitals for better user experience.
+---
+## Core Web Vitals
+### LCP - Largest Contentful Paint
+**What:** Time until largest content element is visible
+**Target:** < 2.5 seconds
+**Measures:** Loading performance
+### FID - First Input Delay
+**What:** Time from first interaction to browser response
+**Target:** < 100 milliseconds
+**Measures:** Interactivity
+### CLS - Cumulative Layout Shift
+**What:** Visual stability (unexpected layout shifts)
+**Target:** < 0.1
+**Measures:** Visual stability
+---
+## Measuring Web Vitals
+### Using web-vitals Library
+```javascript
+// Install
+npm install web-vitals
+// Usage
+import { getCLS, getFID, getLCP, getFCP, getTTFB } from 'web-vitals';
+function sendToAnalytics(metric) {
+  console.log(metric);
+  // Send to analytics service
+  analytics.track('Web Vitals', {
+    name: metric.name,
+    value: metric.value,
+    rating: metric.rating,  // 'good', 'needs-improvement', 'poor'
+    id: metric.id,
+  });
+}
+getCLS(sendToAnalytics);
+getFID(sendToAnalytics);
+getLCP(sendToAnalytics);
+getFCP(sendToAnalytics);
+getTTFB(sendToAnalytics);
+```
+### React Integration
+```javascript
+// In React app
+import { useEffect } from 'react';
+import { getCLS, getFID, getLCP } from 'web-vitals';
+function App() {
+  useEffect(() => {
+    getCLS(console.log);
+    getFID(console.log);
+    getLCP(console.log);
+  }, []);
+  return <MainApp />;
+}
+// Or in reportWebVitals.js (Create React App)
+const reportWebVitals = (onPerfEntry) => {
+  if (onPerfEntry && onPerfEntry instanceof Function) {
+    import('web-vitals').then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => {
+      getCLS(onPerfEntry);
+      getFID(onPerfEntry);
+      getFCP(onPerfEntry);
+      getLCP(onPerfEntry);
+      getTTFB(onPerfEntry);
+    });
+  }
+};
+```
+### Lighthouse
+```bash
+# CLI
+npm install -g lighthouse
+lighthouse https://example.com --output html --output-path report.html
+# Chrome DevTools
+1. Open DevTools (F12)
+2. Go to Lighthouse tab
+3. Click "Generate report"
+```
+---
+## Optimizing LCP
+### Common LCP Elements
+- `<img>` elements
+- `<video>` poster images
+- Elements with background-image
+- Block-level text elements
+### Optimization Techniques
+#### 1. Optimize Images
+```html
+<!-- Use modern formats -->
+<picture>
+  <source srcset="image.avif" type="image/avif">
+  <source srcset="image.webp" type="image/webp">
+  <img src="image.jpg" alt="...">
+</picture>
+<!-- Responsive images -->
+<img
+  srcset="small.jpg 300w,
+          medium.jpg 600w,
+          large.jpg 1200w"
+  sizes="(max-width: 600px) 300px,
+         (max-width: 1200px) 600px,
+         1200px"
+  src="medium.jpg"
+  alt="..."
+>
+<!-- Preload LCP image -->
+<link rel="preload" as="image" href="hero-image.webp">
+```
+#### 2. Optimize Server Response
+```javascript
+// Enable caching
+app.use((req, res, next) => {
+  res.setHeader('Cache-Control', 'public, max-age=31536000');
+  next();
+});
+// Use CDN
+// Configure CDN for static assets
+// Enable compression
+const compression = require('compression');
+app.use(compression());
+```
+#### 3. Preload Critical Resources
+```html
+<head>
+  <!-- Preload critical CSS -->
+  <link rel="preload" href="critical.css" as="style">
+  <!-- Preload fonts -->
+  <link rel="preload" href="font.woff2" as="font" type="font/woff2" crossorigin>
+  <!-- Preconnect to origins -->
+  <link rel="preconnect" href="https://api.example.com">
+  <link rel="dns-prefetch" href="https://cdn.example.com">
+</head>
+```
+---
+## Optimizing FID
+### Optimization Techniques
+#### 1. Break Up Long Tasks
+```javascript
+// BAD: Long blocking task
+function processData(data) {
+  // 1000ms of work
+  data.forEach(item => heavyComputation(item));
+}
+// GOOD: Break into chunks
+async function processData(data) {
+  const chunks = chunkArray(data, 100);
+  for (const chunk of chunks) {
+    chunk.forEach(item => heavyComputation(item));
+    // Yield to main thread
+    await new Promise(resolve => setTimeout(resolve, 0));
+  }
+}
+```
+#### 2. Use Web Workers
+```javascript
+// Heavy computation in worker
+const worker = new Worker('worker.js');
+worker.postMessage({ data: largeDataSet });
+worker.onmessage = (event) => {
+  console.log('Processed:', event.data);
+};
+// worker.js
+self.onmessage = (event) => {
+  const result = heavyComputation(event.data);
+  self.postMessage(result);
+};
+```
+#### 3. Defer Non-Critical JavaScript
+```html
+<!-- Defer non-critical scripts -->
+<script src="analytics.js" defer></script>
+<script src="non-critical.js" defer></script>
+<!-- Async for independent scripts -->
+<script src="independent.js" async></script>
+```
+#### 4. Lazy Load Components
+```javascript
+// React
+const HeavyComponent = React.lazy(() => import('./HeavyComponent'));
+function App() {
+  return (
+    <Suspense fallback={<Loading />}>
+      <HeavyComponent />
+    </Suspense>
+  );
+}
+```
+---
+## Optimizing CLS
+### Common Causes
+1. Images without dimensions
+2. Ads/embeds without reserved space
+3. Dynamically injected content
+4. Web fonts causing FOIT/FOUT
+### Optimization Techniques
+#### 1. Always Set Image Dimensions
+```html
+<!-- Always specify width and height -->
+<img src="image.jpg" width="800" height="600" alt="...">
+<!-- Or use aspect-ratio -->
+<style>
+  .image-container {
+    aspect-ratio: 16 / 9;
+  }
+</style>
+```
+#### 2. Reserve Space for Dynamic Content
+```css
+/* Reserve space for ads */
+.ad-container {
+  min-height: 250px;
+}
+/* Skeleton for loading content */
+.skeleton {
+  min-height: 200px;
+  background: linear-gradient(90deg, #f0f0f0 25%, #e0e0e0 50%, #f0f0f0 75%);
+  background-size: 200% 100%;
+  animation: loading 1.5s infinite;
+}
+```
+#### 3. Optimize Font Loading
+```css
+/* Use font-display */
+@font-face {
+  font-family: 'CustomFont';
+  src: url('font.woff2') format('woff2');
+  font-display: swap;
+}
+/* Or use optional for non-critical fonts */
+@font-face {
+  font-family: 'NiceToHave';
+  src: url('font.woff2') format('woff2');
+  font-display: optional;
+}
+```
+```html
+<!-- Preload critical fonts -->
+<link rel="preload" href="font.woff2" as="font" type="font/woff2" crossorigin>
+```
+#### 4. Avoid Inserting Content Above Existing
+```javascript
+// BAD: Insert at top
+container.prepend(newElement);
+// GOOD: Insert below fold or with reserved space
+reservedSpace.appendChild(newElement);
+```
+---
+## Performance Budget
+```javascript
+// performance-budget.json
+{
+  "budgets": [
+    {
+      "resourceSizes": [
+        { "resourceType": "script", "budget": 150 },
+        { "resourceType": "image", "budget": 300 },
+        { "resourceType": "stylesheet", "budget": 50 },
+        { "resourceType": "total", "budget": 500 }
+      ],
+      "timings": [
+        { "metric": "largest-contentful-paint", "budget": 2500 },
+        { "metric": "first-input-delay", "budget": 100 },
+        { "metric": "cumulative-layout-shift", "budget": 0.1 },
+        { "metric": "time-to-interactive", "budget": 3500 }
+      ]
+    }
+  ]
+}
+```
+---
+## Monitoring Dashboard
+```markdown
+# Web Vitals Dashboard
+## Current Performance
+| Metric | P75 Value | Target | Status |
+|--------|-----------|--------|--------|
+| LCP | 2.1s | < 2.5s | ✅ Good |
+| FID | 80ms | < 100ms | ✅ Good |
+| CLS | 0.15 | < 0.1 | ⚠️ Needs Improvement |
+| FCP | 1.5s | < 1.8s | ✅ Good |
+| TTFB | 300ms | < 600ms | ✅ Good |
+## Trends (Last 30 Days)
+LCP: ████████░░ Improved 15%
+FID: ██████████ Stable
+CLS: ██████░░░░ Degraded 5%
+## Top Issues
+1. CLS on product pages (0.2)
+   - Cause: Images without dimensions
+   - Fix: Add width/height attributes
+2. LCP on homepage (2.8s)
+   - Cause: Large hero image
+   - Fix: Optimize and preload image
+```
+---
+## CI/CD Integration
+```yaml
+# .github/workflows/performance.yml
+name: Performance Check
+on: pull_request
+jobs:
+  lighthouse:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Run Lighthouse
+        uses: treosh/lighthouse-ci-action@v9
+        with:
+          urls: |
+            https://example.com/
+            https://example.com/products
+          budgetPath: ./performance-budget.json
+          uploadArtifacts: true
+      - name: Check Web Vitals
+        run: |
+          if [ "$LCP" -gt 2500 ]; then
+            echo "LCP exceeds budget"
+            exit 1
+          fi
+```
+---
+## Commands
+| Command | Description |
+|---------|-------------|
+| `pa:perf-vitals` | Check Web Vitals |
+| `pa:perf-lcp` | Analyze LCP |
+| `pa:perf-cls` | Analyze CLS |
+| `pa:perf-fid` | Analyze FID |
+| `pa:perf-report` | Generate performance report |

package/.proagents/platforms.yaml ADDED Viewed

@@ -0,0 +1,66 @@
+# ProAgents Supported AI Platforms
+# Single source of truth - used by code and AI assistants
+#
+# To add a new platform:
+# 1. Add entry below with id, name, file, desc
+# 2. Create the instruction file in .proagents/
+# 3. Run: proagents ai add
+ide:
+  label: "IDE-based AI Assistants"
+  platforms:
+    - id: claude
+      name: Claude Code
+      file: CLAUDE.md
+      desc: Anthropic Claude in terminal/IDE
+    - id: cursor
+      name: Cursor
+      file: .cursorrules
+      desc: Cursor AI IDE
+    - id: windsurf
+      name: Windsurf
+      file: .windsurfrules
+      desc: Codeium Windsurf IDE
+    - id: copilot
+      name: GitHub Copilot
+      file: .github/copilot-instructions.md
+      desc: GitHub Copilot
+    - id: kiro
+      name: AWS Kiro
+      file: KIRO.md
+      desc: AWS Kiro IDE
+    - id: gemini
+      name: Gemini
+      file: GEMINI.md
+      desc: Google Gemini / AI Studio
+web:
+  label: "Web-based AI Platforms"
+  platforms:
+    - id: replit
+      name: Replit AI
+      file: REPLIT.md
+      desc: Replit Ghostwriter
+    - id: bolt
+      name: Bolt.new
+      file: BOLT.md
+      desc: StackBlitz Bolt
+    - id: lovable
+      name: Lovable
+      file: LOVABLE.md
+      desc: Lovable (GPT Engineer)
+# Auto-handled platforms (use AGENTS.md, no separate file needed)
+auto_handled:
+  - ChatGPT
+  - Groq
+  - Antigravity
+  - Codex CLI
+  - OpenAI API

package/.proagents/proagents.config.yaml CHANGED Viewed

@@ -67,7 +67,6 @@ documentation:
     internal:
       feature_docs: "./.proagents/active-features/"  # Feature-specific docs
       dev_changelog: "./.proagents/changelog/"       # Detailed dev notes
-      analysis: "./.proagents/cache/"                # Codebase analysis
       learning: "./.proagents/.learning/"            # AI learning data
   required_for_all_modes: true

package/.proagents/prompts/ai-add.md ADDED Viewed

@@ -0,0 +1,80 @@
+# pa:ai-add - Add AI Platform
+Add a new AI platform configuration to this project.
+## Steps
+### 1. Read Available Platforms
+**IMPORTANT:** Always read the authoritative list first - do not hallucinate platforms.
+```bash
+cat .proagents/platforms.yaml
+```
+### 2. Show Options to User
+Display platforms grouped by category:
+```
+IDE-based AI Assistants:
+  1. claude    - Claude Code (CLAUDE.md)
+  2. cursor    - Cursor (.cursorrules)
+  3. windsurf  - Windsurf (.windsurfrules)
+  4. copilot   - GitHub Copilot (.github/copilot-instructions.md)
+  5. kiro      - AWS Kiro (KIRO.md)
+  6. gemini    - Gemini (GEMINI.md)
+Web-based AI Platforms:
+  7. replit    - Replit AI (REPLIT.md)
+  8. bolt      - Bolt.new (BOLT.md)
+  9. lovable   - Lovable (LOVABLE.md)
+Auto-handled (use AGENTS.md):
+  - ChatGPT, Groq, Antigravity, Codex CLI, OpenAI API
+Which platform to add?
+```
+### 3. Create the File
+After user selects platform:
+1. **Read source template** from `.proagents/{file}`
+2. **Check if target file exists** in project root:
+   - If exists: Merge using markers (append ProAgents section)
+   - If not exists: Create new file with markers
+3. **Wrap content with markers:**
+   ```
+   <!-- PROAGENTS_START -->
+   {content from template}
+   <!-- PROAGENTS_END -->
+   ```
+### 4. Update Config
+Add platform to `ai_platforms` array in `./proagents.config.yaml`:
+```yaml
+ai_platforms:
+  - claude
+  - cursor
+  - {new_platform}  # Add this
+```
+### 5. Confirm
+```
+Added {platform_name}!
+  File: {file_path}
+  Config updated: ./proagents.config.yaml
+```
+## Merge Rules
+When target file already exists:
+1. **Has PROAGENTS markers:** Update content between markers only
+2. **No markers:** Append ProAgents section at end with markers
+3. **Never overwrite** user's existing configuration

package/.proagents/prompts/ai-list.md ADDED Viewed

@@ -0,0 +1,41 @@
+# pa:ai-list - List AI Platforms
+Show which AI platforms are configured for this project.
+## Steps
+1. **Read config file:**
+   ```bash
+   cat ./proagents.config.yaml
+   ```
+2. **Extract `ai_platforms` array** from the config
+3. **Display installed platforms:**
+   ```
+   Installed AI Platforms:
+   - Claude Code (CLAUDE.md)
+   - Cursor (.cursorrules)
+   - ...
+   ```
+4. **Show available platforms** (not yet installed):
+   - Read `.proagents/platforms.yaml` for full list
+   - Compare with installed list
+   - Show what can be added
+## Output Format
+```
+Installed AI Platforms:
+  [x] claude - Claude Code
+  [x] cursor - Cursor
+Available to Add:
+  [ ] windsurf - Windsurf
+  [ ] copilot - GitHub Copilot
+  [ ] gemini - Gemini
+  ...
+Use pa:ai-add to add more platforms.
+```