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

proagents 1.6.20 → 1.6.22

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 (136) hide show

package/.claude/settings.local.json +3 -1
package/.proagents/.cursorrules +1 -1
package/.proagents/.windsurfrules +1 -1
package/.proagents/AGENTS.md +1 -1
package/.proagents/AI_INSTRUCTIONS.md +29 -1
package/.proagents/BOLT.md +1 -1
package/.proagents/CLAUDE.md +1 -1
package/.proagents/GEMINI.md +1 -1
package/.proagents/KIRO.md +1 -1
package/.proagents/LOVABLE.md +1 -1
package/.proagents/REPLIT.md +1 -1
package/.proagents/custom-commands.yaml +1 -2
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 +55 -1
package/.proagents/prompts/11-session-tracking.md +100 -0
package/.proagents/prompts/13-commit.md +426 -0
package/.proagents/workflow-modes/entry-modes.md +1 -6
package/COMMANDS.md +19 -0
package/lib/commands/init.js +62 -11
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/sessions/README.md +0 -5
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

@@ -40,6 +40,61 @@ git:
   commit_convention: "conventional"  # conventional | simple | custom
   require_pr: true
+  # Pre-commit checks for pa:commit
+  pre_commit:
+    enabled: true           # Master toggle for pre-commit checks
+    lint: true              # Run linter before commit
+    type_check: true        # Run type checker before commit
+    test_affected: false    # Run tests for changed files
+  # Safety warnings for pa:commit
+  safety:
+    warn_main_branch: true      # Warn if committing to main/master
+    warn_sensitive_files: true  # Warn for .env, credentials, etc.
+    warn_large_files: true      # Warn if file > threshold
+    large_file_threshold: 1048576  # 1MB in bytes
+    sensitive_patterns:
+      - ".env*"
+      - "credentials*"
+      - "secrets*"
+      - "*.pem"
+      - "*.key"
+      - "id_rsa*"
+# Workflow Configuration
+# Controls how AI handles task size and worktrees
+workflow:
+  # Worktree mode: auto | always-ask | always-branch | always-worktree
+  # - auto: Small tasks use branch (no ask), large tasks ask user
+  # - always-ask: Always ask user for workflow choice
+  # - always-branch: Never use worktree, always simple branch
+  # - always-worktree: Always create worktree for each task
+  worktree_mode: "auto"
+  # Task size indicators for auto mode
+  task_indicators:
+    small:
+      - "fix typo"
+      - "small bug"
+      - "quick fix"
+      - "update text"
+      - "minor change"
+      - "hotfix"
+    large:
+      - "implement"
+      - "create feature"
+      - "refactor"
+      - "new module"
+      - "authentication"
+      - "payment"
+      - "integration"
+      - "migration"
+  # Worktree naming
+  worktree_naming:
+    prefix: "../"  # Relative to current directory
+    format: "{project}-{taskname}"  # e.g., myapp-user-auth
 # Parallel Feature Development
 parallel_features:
   enabled: true
@@ -67,7 +122,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/11-session-tracking.md CHANGED Viewed

@@ -76,6 +76,106 @@ AI: "Fixed the login bug in src/auth/login.ts"
 | `pa:session-start` | Begin work session (AUTO) |
 | `pa:session-end` | End session (AUTO - logs on each change) |
 | `pa:handoff` | Create detailed handoff |
+| `pa:worktree-create "name"` | Create worktree for large task |
+| `pa:worktree-list` | List all active worktrees |
+| `pa:worktree-remove "name"` | Remove worktree after merge |
+---
+## Smart Workflow Mode
+AI automatically detects task size and chooses workflow.
+### Task Size Indicators
+| Small Task | Large Task |
+|------------|------------|
+| "fix typo", "small bug", "quick fix" | "implement", "feature", "refactor" |
+| 1-2 files | Multiple files |
+| Single function | New module |
+### Workflow Decision
+Read `workflow.worktree_mode` from `proagents.config.yaml`:
+- **auto** (default): Small → branch, Large → ask user
+- **always-ask**: Always ask user
+- **always-branch**: Never use worktree
+- **always-worktree**: Always create worktree
+### Small Task (Auto Branch)
+```
+User: "Fix the typo in README"
+AI: [Creates branch, proceeds immediately, no question]
+```
+### Large Task (Ask User)
+```
+User: "Implement user authentication"
+AI:
+═══════════════════════════════════════
+📋 LARGE TASK DETECTED
+Task: "Implement user authentication"
+1. Continue here (current branch)
+2. Create worktree (isolated directory)
+Which approach? [1/2]
+═══════════════════════════════════════
+```
+---
+## Worktree Commands
+### pa:worktree-create "name"
+Creates isolated worktree for task:
+```bash
+git worktree add ../[project]-[name] feature/[name]
+```
+Output:
+```
+═══════════════════════════════════════
+✅ Worktree Created
+Directory: ../myapp-user-auth/
+Branch: feature/user-auth
+Next Steps:
+1. Open the new directory in your IDE
+2. Work there - all changes go to feature/user-auth
+3. When done: pa:worktree-remove "user-auth"
+═══════════════════════════════════════
+```
+### pa:worktree-list
+```bash
+git worktree list
+```
+Output:
+```
+═══════════════════════════════════════
+📁 Active Worktrees
+/path/to/myapp                    main
+/path/to/myapp-user-auth          feature/user-auth [Claude]
+/path/to/myapp-rate-limiting      feature/rate-limiting [Cursor]
+═══════════════════════════════════════
+```
+### pa:worktree-remove "name"
+```bash
+git worktree remove ../myapp-[name]
+```
 ---