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

proagents 1.6.20 → 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 (121) hide show

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/proagents.config.yaml +0 -1
package/.proagents/workflow-modes/entry-modes.md +1 -6
package/lib/commands/init.js +57 -8
package/package.json +1 -1
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/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/workflow-modes/entry-modes.md CHANGED Viewed

@@ -127,8 +127,7 @@ Streamlined workflow for fixing bugs quickly without skipping quality.
 │  Phase 1: Context Scan (2-5 min)                            │
 │  ├── Identify affected files from bug description           │
 │  ├── Scan recent changes (git history)                      │
-│  ├── Check related components                               │
-│  └── Load cached analysis if available                      │
+│  └── Check related components                               │
 │                                                             │
 │  Phase 2: Root Cause Analysis                               │
 │  ├── Identify the bug source                                │
@@ -186,10 +185,6 @@ auto_context:
     components: true
     services: true
     tests: true
-  load_cached:
-    analysis: true
-    patterns: true
 ```
 ### Guardrails

package/lib/commands/init.js CHANGED Viewed

@@ -13,7 +13,6 @@ const __dirname = dirname(__filename);
 const PRESERVE_PATHS = [
   'active-features',           // User's work in progress
   '.learning',                 // Learned patterns
-  'cache',                     // Cached analysis
   'changelog',                 // Change history (user data)
   'worklog',                   // Work context (user data)
   'sessions',                  // Session data
@@ -148,10 +147,9 @@ const CONFIG_FILE = 'proagents.config.yaml';
 const FRAMEWORK_FOLDERS = [
   'prompts',
   'templates',
-  'checklists',
   'standards',
   'examples',
-  'git',
+  'docs',
   'ui-integration',
   'workflow-modes',
   'security',
@@ -161,25 +159,32 @@ const FRAMEWORK_FOLDERS = [
   'scaffolding',
   'cli',
   'adr',
+  'config',
+  'existing-projects',
+  'getting-started',
+];
+// Deprecated folders to remove during update (no longer part of framework)
+const DEPRECATED_FOLDERS = [
   'ai-models',
   'ai-training',
   'api-versioning',
   'approval-workflows',
   'automation',
+  'cache',
+  'checklists',
   'cicd',
   'collaboration',
   'compliance',
   'config-versioning',
-  'config',
   'contract-testing',
   'cost',
   'database',
   'dependency-management',
   'disaster-recovery',
   'environments',
-  'existing-projects',
   'feature-flags',
-  'getting-started',
+  'git',
   'i18n',
   'ide-integration',
   'integrations',
@@ -200,11 +205,19 @@ const FRAMEWORK_FOLDERS = [
   'rules',
   'runbooks',
   'secrets',
+  'sprints',
   'team',
   'troubleshooting',
   'webhooks',
 ];
+// Deprecated files to remove during update
+const DEPRECATED_FILES = [
+  'checkpoints.json',
+  'history.log',
+  'time-tracking.json',
+];
 // Root files to always update (AI files handled separately via platform selection)
 const FRAMEWORK_FILES = [
   'README.md',
@@ -214,6 +227,16 @@ const FRAMEWORK_FILES = [
   'slash-commands.json',
   'AI_INSTRUCTIONS.md',  // Universal instructions kept for reference
   'platforms.yaml',      // Single source of truth for AI platforms
+  // Platform instruction files (updated during init)
+  'AGENTS.md',
+  'CLAUDE.md',
+  '.cursorrules',
+  '.windsurfrules',
+  'GEMINI.md',
+  'BOLT.md',
+  'REPLIT.md',
+  'LOVABLE.md',
+  'KIRO.md',
 ];
 // Universal AI file - always copied to project root (not selectable)
@@ -1019,7 +1042,8 @@ export async function initCommand(options = {}) {
         console.log(chalk.gray('  • active-features/ (your work in progress)'));
         console.log(chalk.gray('  • proagents.config.yaml (your values + new options merged)'));
         console.log(chalk.gray('  • .learning/ (learned patterns)'));
-        console.log(chalk.gray('  • cache/ (analysis cache)\n'));
+        console.log(chalk.gray('  • changelog/ (change history)'));
+        console.log(chalk.gray('  • worklog/ (work context)\n'));
         return;
       } catch (error) {
         console.error(chalk.red('\n✗ Error updating ProAgents:'));
@@ -1114,7 +1138,6 @@ Generated by [ProAgents](https://github.com/prakashpro3/proAgents)
         // Default: Ignore only local data
         gitignoreEntries = [
           '# ProAgents - Local data only (workflow config shared with team)',
-          '.proagents/cache/',
           '.proagents/.learning/',
           '.proagents/sessions/',
           '.proagents/active-features/',
@@ -1340,6 +1363,32 @@ async function smartUpdate(sourceDir, targetDir) {
   }
   console.log(chalk.green(`✓ Updated ${updatedCount} framework folders`));
+  // Remove deprecated folders
+  let removedFolders = 0;
+  for (const folder of DEPRECATED_FOLDERS) {
+    const folderPath = join(targetDir, folder);
+    if (existsSync(folderPath)) {
+      rmSync(folderPath, { recursive: true, force: true });
+      removedFolders++;
+    }
+  }
+  if (removedFolders > 0) {
+    console.log(chalk.green(`✓ Removed ${removedFolders} deprecated folders`));
+  }
+  // Remove deprecated files
+  let removedFiles = 0;
+  for (const file of DEPRECATED_FILES) {
+    const filePath = join(targetDir, file);
+    if (existsSync(filePath)) {
+      rmSync(filePath, { force: true });
+      removedFiles++;
+    }
+  }
+  if (removedFiles > 0) {
+    console.log(chalk.green(`✓ Removed ${removedFiles} deprecated files`));
+  }
   // Restore user files that were migrated (they were saved before folder deletion)
   restoreUserFiles(targetDir, migrationResult);

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "proagents",
-  "version": "1.6.20",
+  "version": "1.6.21",
   "description": "AI-agnostic development workflow framework that automates the full software development lifecycle",
   "type": "module",
   "main": "lib/index.js",