npm - proagents - Versions diffs - 1.6.16 → 1.6.18 - Mend

proagents 1.6.16 → 1.6.18

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

package/.claude/settings.local.json +169 -0
package/COMMANDS.md +595 -0
package/README.md +22 -64
package/bin/proagents.js +0 -2
package/lib/commands/init.js +4 -174
package/package.json +2 -7
package/.proagents/ai-models/README.md +0 -141
package/.proagents/ai-models/cost-management.md +0 -362
package/.proagents/ai-models/fallbacks.md +0 -342
package/.proagents/ai-models/model-config.md +0 -318
package/.proagents/ai-models/task-routing.md +0 -503
package/.proagents/ai-training/README.md +0 -155
package/.proagents/ai-training/continuous-learning.md +0 -413
package/.proagents/ai-training/domain-knowledge.md +0 -378
package/.proagents/ai-training/pattern-learning.md +0 -455
package/.proagents/ai-training/training-data.md +0 -337
package/.proagents/ai-training/user-preferences.md +0 -346
package/.proagents/approval-workflows/README.md +0 -146
package/.proagents/approval-workflows/approval-config.md +0 -332
package/.proagents/approval-workflows/approval-stages.md +0 -503
package/.proagents/approval-workflows/emergency-bypass.md +0 -351
package/.proagents/approval-workflows/examples.md +0 -859
package/.proagents/approval-workflows/notifications.md +0 -320
package/.proagents/compliance/README.md +0 -206
package/.proagents/compliance/access-control.md +0 -310
package/.proagents/compliance/audit-logging.md +0 -444
package/.proagents/compliance/compliance-frameworks.md +0 -429
package/.proagents/compliance/reports.md +0 -491
package/.proagents/compliance/retention-policies.md +0 -454
package/.proagents/config-versioning/README.md +0 -120
package/.proagents/config-versioning/changelog.md +0 -300
package/.proagents/config-versioning/rollback.md +0 -283
package/.proagents/config-versioning/versioning.md +0 -330
package/.proagents/contract-testing/README.md +0 -223
package/.proagents/contract-testing/contract-testing.md +0 -614
package/.proagents/contract-testing/pact-integration.md +0 -507
package/.proagents/contract-testing/schema-validation.md +0 -565
package/.proagents/dependency-management/README.md +0 -140
package/.proagents/dependency-management/automation.md +0 -363
package/.proagents/dependency-management/compatibility.md +0 -319
package/.proagents/dependency-management/security-scanning.md +0 -413
package/.proagents/dependency-management/update-policies.md +0 -374
package/.proagents/disaster-recovery/README.md +0 -247
package/.proagents/disaster-recovery/automation.md +0 -366
package/.proagents/disaster-recovery/backup-recovery.md +0 -571
package/.proagents/disaster-recovery/incident-response.md +0 -565
package/.proagents/disaster-recovery/rollback-procedures.md +0 -499
package/.proagents/disaster-recovery/runbooks.md +0 -603
package/.proagents/disaster-recovery/scenarios.md +0 -892
package/.proagents/disaster-recovery/testing.md +0 -438
package/.proagents/environments/README.md +0 -244
package/.proagents/environments/configuration.md +0 -437
package/.proagents/environments/promotion.md +0 -434
package/.proagents/environments/setup.md +0 -420
package/.proagents/examples/README.md +0 -55
package/.proagents/examples/backend-nodejs/README.md +0 -188
package/.proagents/examples/backend-nodejs/complete-conversation.md +0 -601
package/.proagents/examples/backend-nodejs/proagents.config.yaml +0 -415
package/.proagents/examples/backend-nodejs/workflow-example.md +0 -909
package/.proagents/examples/fullstack-nextjs/README.md +0 -155
package/.proagents/examples/fullstack-nextjs/complete-conversation.md +0 -604
package/.proagents/examples/fullstack-nextjs/proagents.config.yaml +0 -287
package/.proagents/examples/fullstack-nextjs/workflow-example.md +0 -553
package/.proagents/examples/mobile-react-native/README.md +0 -171
package/.proagents/examples/mobile-react-native/complete-conversation.md +0 -825
package/.proagents/examples/mobile-react-native/proagents.config.yaml +0 -330
package/.proagents/examples/mobile-react-native/workflow-example.md +0 -723
package/.proagents/examples/web-frontend-react/README.md +0 -125
package/.proagents/examples/web-frontend-react/complete-conversation.md +0 -556
package/.proagents/examples/web-frontend-react/proagents.config.yaml +0 -183
package/.proagents/examples/web-frontend-react/workflow-example.md +0 -603
package/.proagents/existing-projects/README.md +0 -65
package/.proagents/existing-projects/challenges.md +0 -861
package/.proagents/existing-projects/coexistence-mode.md +0 -483
package/.proagents/existing-projects/compatibility-assessment.md +0 -541
package/.proagents/existing-projects/gradual-adoption.md +0 -515
package/.proagents/existing-projects/migration-strategies.md +0 -788
package/.proagents/existing-projects/pattern-reconciliation.md +0 -489
package/.proagents/existing-projects/team-onboarding.md +0 -617
package/.proagents/existing-projects/technical-debt-handling.md +0 -644
package/.proagents/feature-flags/README.md +0 -263
package/.proagents/feature-flags/ab-testing.md +0 -413
package/.proagents/feature-flags/configuration.md +0 -420
package/.proagents/feature-flags/kill-switches.md +0 -444
package/.proagents/feature-flags/rollout-strategies.md +0 -392
package/.proagents/history.log +0 -12
package/.proagents/i18n/README.md +0 -133
package/.proagents/i18n/extraction.md +0 -433
package/.proagents/i18n/tms-integration.md +0 -332
package/.proagents/i18n/translation-workflow.md +0 -413
package/.proagents/i18n/validation.md +0 -355
package/.proagents/logging/README.md +0 -276
package/.proagents/logging/aggregation.md +0 -475
package/.proagents/logging/log-levels.md +0 -376
package/.proagents/logging/sensitive-data.md +0 -423
package/.proagents/logging/structured-logging.md +0 -406
package/.proagents/metrics/README.md +0 -69
package/.proagents/metrics/code-quality-kpis.md +0 -461
package/.proagents/metrics/deployment-metrics.md +0 -517
package/.proagents/metrics/developer-productivity.md +0 -368
package/.proagents/metrics/learning-effectiveness.md +0 -478
package/.proagents/migrations/README.md +0 -77
package/.proagents/migrations/from-claude-projects.md +0 -313
package/.proagents/migrations/from-cursor-rules.md +0 -345
package/.proagents/migrations/from-custom-workflows.md +0 -410
package/.proagents/monitoring/README.md +0 -308
package/.proagents/monitoring/alerting.md +0 -449
package/.proagents/monitoring/dashboards.md +0 -454
package/.proagents/monitoring/health-checks.md +0 -436
package/.proagents/monitoring/metrics.md +0 -434
package/.proagents/multi-project/README.md +0 -170
package/.proagents/multi-project/coordinated-deploy.md +0 -510
package/.proagents/multi-project/cross-project-deps.md +0 -395
package/.proagents/multi-project/unified-changelog.md +0 -477
package/.proagents/multi-project/walkthroughs/monorepo-setup.md +0 -787
package/.proagents/multi-project/workspace-config.md +0 -408
package/.proagents/notifications/README.md +0 -151
package/.proagents/notifications/channels.md +0 -457
package/.proagents/notifications/preferences.md +0 -415
package/.proagents/notifications/routing.md +0 -449
package/.proagents/notifications/scheduling.md +0 -425
package/.proagents/notifications/templates.md +0 -446
package/.proagents/offline-mode/README.md +0 -145
package/.proagents/offline-mode/caching.md +0 -344
package/.proagents/offline-mode/offline-operations.md +0 -312
package/.proagents/offline-mode/queue-specifications.md +0 -679
package/.proagents/offline-mode/sync.md +0 -475
package/.proagents/parallel-features/README.md +0 -85
package/.proagents/parallel-features/conflict-detection.md +0 -226
package/.proagents/parallel-features/dependency-management.md +0 -392
package/.proagents/parallel-features/merge-coordination.md +0 -506
package/.proagents/parallel-features/tracking-system.md +0 -416
package/.proagents/performance/README.md +0 -59
package/.proagents/performance/bundle-analysis.md +0 -375
package/.proagents/performance/load-testing.md +0 -563
package/.proagents/performance/runtime-metrics.md +0 -489
package/.proagents/performance/web-vitals.md +0 -425
package/.proagents/plugins/README.md +0 -139
package/.proagents/plugins/creating-plugins.md +0 -504
package/.proagents/plugins/plugin-api.md +0 -467
package/.proagents/plugins/plugin-registry.md +0 -276
package/.proagents/reporting/README.md +0 -158
package/.proagents/reporting/dashboards.md +0 -366
package/.proagents/reporting/exports.md +0 -524
package/.proagents/reporting/quality-metrics.md +0 -385
package/.proagents/reporting/templates/README.md +0 -56
package/.proagents/reporting/templates/dashboard-config.json +0 -187
package/.proagents/reporting/templates/metrics-queries.md +0 -427
package/.proagents/reporting/templates/react-dashboard.tsx +0 -544
package/.proagents/reporting/templates/widgets.md +0 -451
package/.proagents/reporting/velocity-metrics.md +0 -340
package/.proagents/reverse-engineering/README.md +0 -151
package/.proagents/reverse-engineering/architecture-extraction.md +0 -325
package/.proagents/reverse-engineering/code-analysis.md +0 -377
package/.proagents/reverse-engineering/dependency-mapping.md +0 -567
package/.proagents/reverse-engineering/diagram-generation.md +0 -586
package/.proagents/reverse-engineering/documentation-generation.md +0 -468
package/.proagents/reverse-engineering/pattern-detection.md +0 -569
package/.proagents/reverse-engineering/quality-assessment.md +0 -733
package/.proagents/secrets/README.md +0 -278
package/.proagents/secrets/access-control.md +0 -443
package/.proagents/secrets/rotation.md +0 -403
package/.proagents/secrets/scanning.md +0 -487
package/.proagents/secrets/storage.md +0 -394
package/.proagents/webhooks/README.md +0 -126
package/.proagents/webhooks/endpoints.md +0 -298
package/.proagents/webhooks/events.md +0 -316
package/.proagents/webhooks/payloads.md +0 -325
package/.proagents/webhooks/reliability.md +0 -363
package/.proagents/webhooks/security.md +0 -380

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

@@ -1,425 +0,0 @@
-# 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/plugins/README.md DELETED Viewed

@@ -1,139 +0,0 @@
-# Plugin System
-Extend ProAgents with custom plugins and integrations.
----
-## Overview
-ProAgents supports a plugin architecture that allows you to:
-- Add custom workflow phases
-- Integrate with external tools
-- Create custom commands
-- Add new code generators
-- Implement custom validators
-- Extend reporting capabilities
----
-## Quick Start
-### Install a Plugin
-```bash
-# From npm
-proagents plugin install @proagents/plugin-jira
-# From GitHub
-proagents plugin install github:user/proagents-plugin-custom
-# From local path
-proagents plugin install ./my-plugin
-```
-### Enable Plugin
-```yaml
-# proagents.config.yaml
-plugins:
-  enabled:
-    - "@proagents/plugin-jira"
-    - "@proagents/plugin-slack"
-    - "./custom-plugins/my-plugin"
-```
----
-## Available Official Plugins
-| Plugin | Description |
-|--------|-------------|
-| `@proagents/plugin-jira` | Jira integration |
-| `@proagents/plugin-slack` | Slack notifications |
-| `@proagents/plugin-github` | GitHub Actions integration |
-| `@proagents/plugin-sentry` | Sentry error tracking |
-| `@proagents/plugin-datadog` | Datadog monitoring |
-| `@proagents/plugin-sonarqube` | SonarQube code quality |
----
-## Plugin Types
-### Workflow Plugins
-Extend or modify workflow phases.
-### Integration Plugins
-Connect with external services.
-### Generator Plugins
-Add code generation capabilities.
-### Validator Plugins
-Add custom validation rules.
-### Reporter Plugins
-Add custom report formats.
----
-## Documentation
-- [Plugin API](./plugin-api.md) - Complete API reference
-- [Creating Plugins](./creating-plugins.md) - Build your own plugins
-- [Plugin Registry](./plugin-registry.md) - Browse available plugins
----
-## Configuration
-```yaml
-# proagents.config.yaml
-plugins:
-  # Enabled plugins
-  enabled:
-    - "@proagents/plugin-jira"
-    - "@proagents/plugin-slack"
-  # Plugin-specific configuration
-  config:
-    "@proagents/plugin-jira":
-      baseUrl: "https://company.atlassian.net"
-      projectKey: "PROJ"
-    "@proagents/plugin-slack":
-      webhookUrl: "${SLACK_WEBHOOK_URL}"
-      channel: "#development"
-  # Plugin directories
-  directories:
-    - "./plugins"
-    - "~/.proagents/plugins"
-  # Auto-update settings
-  autoUpdate: false
-```
----
-## Commands
-```bash
-# List installed plugins
-proagents plugin list
-# Install a plugin
-proagents plugin install <plugin-name>
-# Remove a plugin
-proagents plugin remove <plugin-name>
-# Update plugins
-proagents plugin update
-# Create new plugin
-proagents plugin create my-plugin
-# Validate plugin
-proagents plugin validate ./my-plugin
-```