proagents 1.0.0 → 1.0.1
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.
- package/lib/commands/init.js +122 -11
- package/package.json +1 -1
- package/proagents/PROAGENTS.md +54 -0
- package/proagents/README.md +17 -17
- package/proagents/WORKFLOW.md +110 -110
- package/proagents/active-features/README.md +9 -9
- package/proagents/adr/README.md +15 -15
- package/proagents/api-versioning/changelog-template.md +4 -4
- package/proagents/api-versioning/deprecation-workflow.md +6 -6
- package/proagents/api-versioning/versioning-strategy.md +5 -5
- package/proagents/automation/ai-behavior-rules.md +1 -1
- package/proagents/automation/auto-decisions.md +6 -6
- package/proagents/cache/README.md +1 -1
- package/proagents/changelog/README.md +16 -16
- package/proagents/changelog/entry-template.md +4 -4
- package/proagents/cli/README.md +1 -1
- package/proagents/cli/slash-commands.md +202 -202
- package/proagents/collaboration/sessions.md +6 -6
- package/proagents/config/integrations/README.md +1 -1
- package/proagents/contract-testing/README.md +5 -5
- package/proagents/contract-testing/schema-validation.md +6 -6
- package/proagents/cost/cost-template.md +6 -6
- package/proagents/cost/estimation-framework.md +5 -5
- package/proagents/database/migration-workflow.md +6 -6
- package/proagents/database/rollback-scripts.md +6 -6
- package/proagents/database/safety-checks.md +6 -6
- package/proagents/examples/backend-nodejs/workflow-example.md +1 -1
- package/proagents/examples/web-frontend-react/workflow-example.md +1 -1
- package/proagents/existing-projects/README.md +3 -3
- package/proagents/existing-projects/challenges.md +1 -1
- package/proagents/existing-projects/coexistence-mode.md +8 -8
- package/proagents/existing-projects/compatibility-assessment.md +12 -12
- package/proagents/existing-projects/gradual-adoption.md +14 -14
- package/proagents/existing-projects/migration-strategies.md +7 -7
- package/proagents/existing-projects/pattern-reconciliation.md +10 -10
- package/proagents/existing-projects/team-onboarding.md +23 -23
- package/proagents/existing-projects/technical-debt-handling.md +24 -24
- package/proagents/getting-started/README.md +3 -3
- package/proagents/getting-started/ai-training-setup.md +24 -24
- package/proagents/getting-started/pm-integration.md +22 -22
- package/proagents/getting-started/prompt-engineering.md +4 -4
- package/proagents/getting-started/team-onboarding.md +5 -5
- package/proagents/git/branch-strategy.md +10 -10
- package/proagents/git/commit-conventions.md +5 -5
- package/proagents/git/pr-workflow.md +5 -5
- package/proagents/git/rollback-procedures.md +7 -7
- package/proagents/ide-integration/README.md +1 -1
- package/proagents/ide-integration/cline-config.md +10 -10
- package/proagents/ide-integration/continue-config.md +1 -1
- package/proagents/ide-integration/cursor-rules.md +10 -10
- package/proagents/ide-integration/github-copilot.md +4 -4
- package/proagents/ide-integration/windsurf-rules.md +9 -9
- package/proagents/learning/adaptation.md +10 -10
- package/proagents/learning/data-collection.md +9 -9
- package/proagents/learning/reports.md +14 -14
- package/proagents/metrics/README.md +6 -6
- package/proagents/metrics/code-quality-kpis.md +6 -6
- package/proagents/metrics/deployment-metrics.md +6 -6
- package/proagents/metrics/developer-productivity.md +5 -5
- package/proagents/metrics/learning-effectiveness.md +6 -6
- package/proagents/migrations/from-claude-projects.md +7 -6
- package/proagents/migrations/from-cursor-rules.md +1 -1
- package/proagents/notifications/templates.md +3 -3
- package/proagents/parallel-features/README.md +5 -5
- package/proagents/parallel-features/conflict-detection.md +6 -6
- package/proagents/parallel-features/dependency-management.md +7 -7
- package/proagents/parallel-features/merge-coordination.md +8 -8
- package/proagents/parallel-features/tracking-system.md +7 -7
- package/proagents/performance/bundle-analysis.md +4 -4
- package/proagents/performance/load-testing.md +7 -7
- package/proagents/performance/runtime-metrics.md +6 -6
- package/proagents/performance/web-vitals.md +6 -6
- package/proagents/plugins/README.md +1 -1
- package/proagents/plugins/creating-plugins.md +1 -1
- package/proagents/plugins/plugin-api.md +2 -2
- package/proagents/plugins/plugin-registry.md +3 -3
- package/proagents/proagents.config.yaml +32 -9
- package/proagents/prompts/00-init-wizard.md +18 -18
- package/proagents/prompts/00-init.md +93 -93
- package/proagents/prompts/01-analysis.md +5 -5
- package/proagents/prompts/02-requirements.md +8 -8
- package/proagents/prompts/03-ui-design.md +14 -14
- package/proagents/prompts/04-planning.md +10 -10
- package/proagents/prompts/05-implementation.md +10 -10
- package/proagents/prompts/06-testing.md +14 -14
- package/proagents/prompts/06.5-code-review.md +8 -8
- package/proagents/prompts/07-documentation.md +142 -20
- package/proagents/prompts/08-deployment.md +12 -12
- package/proagents/prompts/09-rollback.md +12 -12
- package/proagents/prompts/README.md +4 -4
- package/proagents/prompts/accessibility/README.md +6 -6
- package/proagents/prompts/accessibility/audit.md +3 -3
- package/proagents/prompts/accessibility/wcag.md +1 -1
- package/proagents/prompts/debugging/README.md +4 -4
- package/proagents/prompts/debugging/performance-debug.md +5 -5
- package/proagents/prompts/debugging/systematic.md +4 -4
- package/proagents/prompts/performance/README.md +4 -4
- package/proagents/prompts/performance/analyze.md +4 -4
- package/proagents/prompts/refactoring/README.md +4 -4
- package/proagents/prompts/refactoring/code-smells.md +9 -9
- package/proagents/prompts/refactoring/patterns.md +6 -6
- package/proagents/prompts/security-audit/README.md +6 -6
- package/proagents/prompts/security-audit/code-review.md +5 -5
- package/proagents/reverse-engineering/README.md +21 -21
- package/proagents/reverse-engineering/architecture-extraction.md +6 -6
- package/proagents/reverse-engineering/code-analysis.md +6 -6
- package/proagents/reverse-engineering/dependency-mapping.md +10 -10
- package/proagents/reverse-engineering/diagram-generation.md +9 -9
- package/proagents/reverse-engineering/documentation-generation.md +7 -7
- package/proagents/reverse-engineering/pattern-detection.md +8 -8
- package/proagents/reverse-engineering/quality-assessment.md +10 -10
- package/proagents/rules/README.md +7 -7
- package/proagents/rules/custom-rules.md +8 -8
- package/proagents/runbooks/README.md +9 -9
- package/proagents/runbooks/dependency-vulnerability.md +4 -4
- package/proagents/runbooks/incident-response.md +12 -12
- package/proagents/runbooks/performance-degradation.md +5 -5
- package/proagents/runbooks/production-debugging.md +5 -5
- package/proagents/scaffolding/nextjs/README.md +10 -10
- package/proagents/scaffolding/nodejs/README.md +10 -10
- package/proagents/scaffolding/project-types.md +7 -7
- package/proagents/scaffolding/react/README.md +6 -6
- package/proagents/scaffolding/react-native/README.md +10 -10
- package/proagents/security/owasp-checklist.md +3 -3
- package/proagents/security/sast-guide.md +6 -6
- package/proagents/security/security-report-template.md +5 -5
- package/proagents/security/vulnerability-scanning.md +6 -6
- package/proagents/slash-commands.json +50 -75
- package/proagents/standards/README.md +4 -4
- package/proagents/standards/architecture-patterns.md +10 -10
- package/proagents/standards/naming-conventions-template.md +4 -4
- package/proagents/standards/override-system.md +8 -8
- package/proagents/team/code-ownership.md +4 -4
- package/proagents/team/communication-templates.md +6 -6
- package/proagents/team/handoff-protocol.md +4 -4
- package/proagents/team/ide-setup/cursor.md +1 -1
- package/proagents/templates/README.md +1 -1
- package/proagents/templates/release-notes.md +214 -0
- package/proagents/ui-integration/figma-guide.md +3 -3
- package/proagents/ui-integration/manual-export-guide.md +2 -2
- package/proagents/ui-integration/sketch-interpretation.md +2 -2
- package/proagents/webhooks/events.md +3 -3
- package/proagents/workflow-modes/README.md +11 -11
- package/proagents/workflow-modes/deferred-tracking.md +12 -12
- package/proagents/workflow-modes/entry-modes.md +16 -16
- package/proagents/workflow-modes/guardrails.md +7 -7
- package/proagents/workflow-modes/mode-detection.md +7 -7
- package/proagents/workflow-modes/mode-switching.md +9 -9
|
@@ -314,12 +314,12 @@ reverse_engineering:
|
|
|
314
314
|
|
|
315
315
|
---
|
|
316
316
|
|
|
317
|
-
##
|
|
317
|
+
## Commands
|
|
318
318
|
|
|
319
319
|
| Command | Description |
|
|
320
320
|
|---------|-------------|
|
|
321
|
-
|
|
|
322
|
-
|
|
|
323
|
-
|
|
|
324
|
-
|
|
|
325
|
-
|
|
|
321
|
+
| `pa:re-architecture` | Full architecture extraction |
|
|
322
|
+
| `pa:re-architecture --diagram` | Generate architecture diagrams |
|
|
323
|
+
| `pa:re-architecture --modules` | Extract module structure |
|
|
324
|
+
| `pa:re-architecture --layers` | Identify layers |
|
|
325
|
+
| `pa:re-architecture --boundaries` | Analyze boundaries |
|
|
@@ -366,12 +366,12 @@ reverse_engineering:
|
|
|
366
366
|
|
|
367
367
|
---
|
|
368
368
|
|
|
369
|
-
##
|
|
369
|
+
## Commands
|
|
370
370
|
|
|
371
371
|
| Command | Description |
|
|
372
372
|
|---------|-------------|
|
|
373
|
-
|
|
|
374
|
-
|
|
|
375
|
-
|
|
|
376
|
-
|
|
|
377
|
-
|
|
|
373
|
+
| `pa:re-analyze` | Full code analysis |
|
|
374
|
+
| `pa:re-analyze --file [path]` | Analyze specific file |
|
|
375
|
+
| `pa:re-analyze --complexity` | Complexity analysis |
|
|
376
|
+
| `pa:re-analyze --types` | Type coverage analysis |
|
|
377
|
+
| `pa:re-analyze --functions` | Function analysis |
|
|
@@ -552,16 +552,16 @@ reverse_engineering:
|
|
|
552
552
|
|
|
553
553
|
---
|
|
554
554
|
|
|
555
|
-
##
|
|
555
|
+
## Commands
|
|
556
556
|
|
|
557
557
|
| Command | Description |
|
|
558
558
|
|---------|-------------|
|
|
559
|
-
|
|
|
560
|
-
|
|
|
561
|
-
|
|
|
562
|
-
|
|
|
563
|
-
|
|
|
564
|
-
|
|
|
565
|
-
|
|
|
566
|
-
|
|
|
567
|
-
|
|
|
559
|
+
| `pa:re-deps` | Full dependency analysis |
|
|
560
|
+
| `pa:re-deps --internal` | Internal modules only |
|
|
561
|
+
| `pa:re-deps --external` | External packages only |
|
|
562
|
+
| `pa:re-deps --circular` | Find circular dependencies |
|
|
563
|
+
| `pa:re-deps --dead` | Find dead/unused code |
|
|
564
|
+
| `pa:re-deps --security` | Security vulnerability check |
|
|
565
|
+
| `pa:re-deps --impact [file]` | Impact analysis for file |
|
|
566
|
+
| `pa:re-deps --outdated` | List outdated packages |
|
|
567
|
+
| `pa:re-deps --tree` | Show dependency tree |
|
|
@@ -572,15 +572,15 @@ Clicking a node in the diagram navigates to:
|
|
|
572
572
|
|
|
573
573
|
---
|
|
574
574
|
|
|
575
|
-
##
|
|
575
|
+
## Commands
|
|
576
576
|
|
|
577
577
|
| Command | Description |
|
|
578
578
|
|---------|-------------|
|
|
579
|
-
|
|
|
580
|
-
|
|
|
581
|
-
|
|
|
582
|
-
|
|
|
583
|
-
|
|
|
584
|
-
|
|
|
585
|
-
|
|
|
586
|
-
|
|
|
579
|
+
| `pa:re-diagrams` | Generate all diagrams |
|
|
580
|
+
| `pa:re-diagrams --type components` | Component hierarchy only |
|
|
581
|
+
| `pa:re-diagrams --type dependencies` | Module dependencies only |
|
|
582
|
+
| `pa:re-diagrams --type database` | Database schema only |
|
|
583
|
+
| `pa:re-diagrams --type api` | API routes only |
|
|
584
|
+
| `pa:re-diagrams --type flow` | Data flow diagrams |
|
|
585
|
+
| `pa:re-diagrams --format svg` | Export as SVG |
|
|
586
|
+
| `pa:re-diagrams --module auth` | Diagrams for specific module |
|
|
@@ -456,13 +456,13 @@ reverse_engineering:
|
|
|
456
456
|
|
|
457
457
|
---
|
|
458
458
|
|
|
459
|
-
##
|
|
459
|
+
## Commands
|
|
460
460
|
|
|
461
461
|
| Command | Description |
|
|
462
462
|
|---------|-------------|
|
|
463
|
-
|
|
|
464
|
-
|
|
|
465
|
-
|
|
|
466
|
-
|
|
|
467
|
-
|
|
|
468
|
-
|
|
|
463
|
+
| `pa:re-docs` | Generate all documentation |
|
|
464
|
+
| `pa:re-docs --api` | Generate API docs only |
|
|
465
|
+
| `pa:re-docs --components` | Generate component docs |
|
|
466
|
+
| `pa:re-docs --modules` | Generate module docs |
|
|
467
|
+
| `pa:re-docs --database` | Generate database docs |
|
|
468
|
+
| `pa:re-docs --readme` | Generate project README |
|
|
@@ -556,14 +556,14 @@ reverse_engineering:
|
|
|
556
556
|
|
|
557
557
|
---
|
|
558
558
|
|
|
559
|
-
##
|
|
559
|
+
## Commands
|
|
560
560
|
|
|
561
561
|
| Command | Description |
|
|
562
562
|
|---------|-------------|
|
|
563
|
-
|
|
|
564
|
-
|
|
|
565
|
-
|
|
|
566
|
-
|
|
|
567
|
-
|
|
|
568
|
-
|
|
|
569
|
-
|
|
|
563
|
+
| `pa:re-patterns` | Detect all patterns |
|
|
564
|
+
| `pa:re-patterns --type architecture` | Architecture patterns only |
|
|
565
|
+
| `pa:re-patterns --type components` | Component patterns only |
|
|
566
|
+
| `pa:re-patterns --type state` | State management patterns |
|
|
567
|
+
| `pa:re-patterns --type naming` | Naming conventions only |
|
|
568
|
+
| `pa:re-patterns --report` | Generate full report |
|
|
569
|
+
| `pa:re-patterns --inconsistencies` | Show inconsistencies only |
|
|
@@ -718,16 +718,16 @@ reverse_engineering:
|
|
|
718
718
|
|
|
719
719
|
---
|
|
720
720
|
|
|
721
|
-
##
|
|
721
|
+
## Commands
|
|
722
722
|
|
|
723
723
|
| Command | Description |
|
|
724
724
|
|---------|-------------|
|
|
725
|
-
|
|
|
726
|
-
|
|
|
727
|
-
|
|
|
728
|
-
|
|
|
729
|
-
|
|
|
730
|
-
|
|
|
731
|
-
|
|
|
732
|
-
|
|
|
733
|
-
|
|
|
725
|
+
| `pa:re-quality` | Full quality assessment |
|
|
726
|
+
| `pa:re-quality --complexity` | Complexity analysis only |
|
|
727
|
+
| `pa:re-quality --debt` | Technical debt analysis |
|
|
728
|
+
| `pa:re-quality --smells` | Code smell detection |
|
|
729
|
+
| `pa:re-quality --security` | Security assessment |
|
|
730
|
+
| `pa:re-quality --tests` | Test quality analysis |
|
|
731
|
+
| `pa:re-quality --module [name]` | Analyze specific module |
|
|
732
|
+
| `pa:re-quality --trends` | Show quality trends |
|
|
733
|
+
| `pa:re-quality --report` | Generate full report |
|
|
@@ -47,8 +47,8 @@ rules:
|
|
|
47
47
|
### 3. Run Validation
|
|
48
48
|
|
|
49
49
|
```bash
|
|
50
|
-
|
|
51
|
-
|
|
50
|
+
pa:rules-check # Check all rules
|
|
51
|
+
pa:rules-check --fix # Auto-fix where possible
|
|
52
52
|
```
|
|
53
53
|
|
|
54
54
|
---
|
|
@@ -169,11 +169,11 @@ configuration:
|
|
|
169
169
|
|
|
170
170
|
---
|
|
171
171
|
|
|
172
|
-
##
|
|
172
|
+
## Commands
|
|
173
173
|
|
|
174
174
|
| Command | Description |
|
|
175
175
|
|---------|-------------|
|
|
176
|
-
|
|
|
177
|
-
|
|
|
178
|
-
|
|
|
179
|
-
|
|
|
176
|
+
| `pa:rules-check` | Run rule validation |
|
|
177
|
+
| `pa:rules-list` | List all active rules |
|
|
178
|
+
| `pa:rules-add` | Add new rule |
|
|
179
|
+
| `pa:rules-disable [id]` | Disable a rule |
|
|
@@ -741,14 +741,14 @@ proagents rules-check --staged-only --fail-on-error
|
|
|
741
741
|
|
|
742
742
|
---
|
|
743
743
|
|
|
744
|
-
##
|
|
744
|
+
## Commands
|
|
745
745
|
|
|
746
746
|
| Command | Description |
|
|
747
747
|
|---------|-------------|
|
|
748
|
-
|
|
|
749
|
-
|
|
|
750
|
-
|
|
|
751
|
-
|
|
|
752
|
-
|
|
|
753
|
-
|
|
|
754
|
-
|
|
|
748
|
+
| `pa:rules-check` | Run all rule validations |
|
|
749
|
+
| `pa:rules-check --fix` | Auto-fix violations |
|
|
750
|
+
| `pa:rules-list` | List all active rules |
|
|
751
|
+
| `pa:rules-add` | Interactive rule creation |
|
|
752
|
+
| `pa:rules-disable [id]` | Disable a rule |
|
|
753
|
+
| `pa:rules-explain [id]` | Explain what a rule does |
|
|
754
|
+
| `pa:rules-report` | Generate violations report |
|
|
@@ -38,16 +38,16 @@ Runbooks provide step-by-step procedures for handling incidents, debugging produ
|
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
40
|
# 1. Assess the situation
|
|
41
|
-
|
|
41
|
+
pa:runbook incident assess
|
|
42
42
|
|
|
43
43
|
# 2. Start incident response
|
|
44
|
-
|
|
44
|
+
pa:runbook incident start --severity SEV2 --description "Login failures"
|
|
45
45
|
|
|
46
46
|
# 3. Follow guided steps
|
|
47
|
-
|
|
47
|
+
pa:runbook incident guide
|
|
48
48
|
|
|
49
49
|
# 4. Close incident
|
|
50
|
-
|
|
50
|
+
pa:runbook incident close --resolution "Fixed auth service timeout"
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
---
|
|
@@ -56,19 +56,19 @@ Runbooks provide step-by-step procedures for handling incidents, debugging produ
|
|
|
56
56
|
|
|
57
57
|
```bash
|
|
58
58
|
# List available runbooks
|
|
59
|
-
|
|
59
|
+
pa:runbook list
|
|
60
60
|
|
|
61
61
|
# Start a runbook
|
|
62
|
-
|
|
62
|
+
pa:runbook start <runbook-name>
|
|
63
63
|
|
|
64
64
|
# View runbook steps
|
|
65
|
-
|
|
65
|
+
pa:runbook view <runbook-name>
|
|
66
66
|
|
|
67
67
|
# Log runbook execution
|
|
68
|
-
|
|
68
|
+
pa:runbook log --action "Restarted service"
|
|
69
69
|
|
|
70
70
|
# Generate post-mortem
|
|
71
|
-
|
|
71
|
+
pa:runbook postmortem --incident INC-123
|
|
72
72
|
```
|
|
73
73
|
|
|
74
74
|
---
|
|
@@ -114,7 +114,7 @@ npx depcruise --output-type dot src | dot -T svg > deps.svg
|
|
|
114
114
|
|
|
115
115
|
```bash
|
|
116
116
|
# 1. Notify security team immediately
|
|
117
|
-
|
|
117
|
+
pa:security alert --severity critical --cve CVE-2024-XXXXX
|
|
118
118
|
|
|
119
119
|
# 2. Check for signs of exploitation
|
|
120
120
|
grep -r "vulnerable_pattern" /var/log/app/
|
|
@@ -161,14 +161,14 @@ Rules:
|
|
|
161
161
|
|
|
162
162
|
```bash
|
|
163
163
|
# Create tracking issue
|
|
164
|
-
|
|
164
|
+
pa:security issue create \
|
|
165
165
|
--title "Vulnerability in lodash < 4.17.21" \
|
|
166
166
|
--severity medium \
|
|
167
167
|
--cve CVE-2024-XXXXX \
|
|
168
168
|
--due-date "2024-01-22"
|
|
169
169
|
|
|
170
170
|
# Add to sprint planning
|
|
171
|
-
|
|
171
|
+
pa:jira add-to-sprint --issue SEC-123 --sprint current
|
|
172
172
|
```
|
|
173
173
|
|
|
174
174
|
---
|
|
@@ -470,7 +470,7 @@ npm install <package>@latest # Update to absolute latest
|
|
|
470
470
|
npm install <package>@X.Y.Z # Install specific version
|
|
471
471
|
|
|
472
472
|
# Create security PR
|
|
473
|
-
|
|
473
|
+
pa:security fix --cve CVE-XXXX --create-pr
|
|
474
474
|
```
|
|
475
475
|
|
|
476
476
|
---
|
|
@@ -59,7 +59,7 @@ This runbook provides a structured approach to responding to production incident
|
|
|
59
59
|
pd incident acknowledge --id <incident-id>
|
|
60
60
|
|
|
61
61
|
# Or via Slack
|
|
62
|
-
|
|
62
|
+
pa:incident acknowledge
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
### 1.2 Initial Assessment
|
|
@@ -82,7 +82,7 @@ Based on assessment, classify the incident:
|
|
|
82
82
|
|
|
83
83
|
```bash
|
|
84
84
|
# Update incident severity
|
|
85
|
-
|
|
85
|
+
pa:incident severity set SEV2 --reason "Auth service affecting 30% of users"
|
|
86
86
|
```
|
|
87
87
|
|
|
88
88
|
### 1.4 Notify Stakeholders
|
|
@@ -283,7 +283,7 @@ npm run test:integration
|
|
|
283
283
|
pd incident resolve --id <incident-id>
|
|
284
284
|
|
|
285
285
|
# Final Slack update
|
|
286
|
-
|
|
286
|
+
pa:incident close --resolution "Rolled back problematic change, service restored"
|
|
287
287
|
```
|
|
288
288
|
|
|
289
289
|
### 4.4 Final Communication
|
|
@@ -373,10 +373,10 @@ git commit -m "Add connection pool troubleshooting steps"
|
|
|
373
373
|
|
|
374
374
|
```bash
|
|
375
375
|
# Track action items
|
|
376
|
-
|
|
376
|
+
pa:incident action-items list --incident INC-2024-0115
|
|
377
377
|
|
|
378
378
|
# Update status
|
|
379
|
-
|
|
379
|
+
pa:incident action-items update <item-id> --status complete
|
|
380
380
|
```
|
|
381
381
|
|
|
382
382
|
---
|
|
@@ -429,23 +429,23 @@ git commit -m "Add connection pool troubleshooting steps"
|
|
|
429
429
|
|
|
430
430
|
```bash
|
|
431
431
|
# Start incident
|
|
432
|
-
|
|
432
|
+
pa:incident start --severity SEV2 --description "Login failures"
|
|
433
433
|
|
|
434
434
|
# Update status
|
|
435
|
-
|
|
435
|
+
pa:incident update --status investigating --message "Checking logs"
|
|
436
436
|
|
|
437
437
|
# Change severity
|
|
438
|
-
|
|
438
|
+
pa:incident severity set SEV1 --reason "Complete outage"
|
|
439
439
|
|
|
440
440
|
# Add timeline entry
|
|
441
|
-
|
|
441
|
+
pa:incident timeline add "Identified root cause: DB connection exhaustion"
|
|
442
442
|
|
|
443
443
|
# Escalate
|
|
444
|
-
|
|
444
|
+
pa:incident escalate --to @sre-team --reason "Need database access"
|
|
445
445
|
|
|
446
446
|
# Resolve
|
|
447
|
-
|
|
447
|
+
pa:incident resolve --summary "Rolled back to v1.2.3"
|
|
448
448
|
|
|
449
449
|
# Generate post-mortem
|
|
450
|
-
|
|
450
|
+
pa:incident postmortem generate
|
|
451
451
|
```
|
|
@@ -483,19 +483,19 @@ For users with 100 items, latency increased from 100ms to 800ms.
|
|
|
483
483
|
|
|
484
484
|
```bash
|
|
485
485
|
# Start performance investigation
|
|
486
|
-
|
|
486
|
+
pa:perf investigate --service my-service
|
|
487
487
|
|
|
488
488
|
# Quick metrics check
|
|
489
|
-
|
|
489
|
+
pa:perf status
|
|
490
490
|
|
|
491
491
|
# Generate performance report
|
|
492
|
-
|
|
492
|
+
pa:perf report --period "last-24h"
|
|
493
493
|
|
|
494
494
|
# Scale service
|
|
495
|
-
|
|
495
|
+
pa:perf scale my-service --replicas 10
|
|
496
496
|
|
|
497
497
|
# Enable performance mode
|
|
498
|
-
|
|
498
|
+
pa:perf optimize --enable-cache --enable-compression
|
|
499
499
|
```
|
|
500
500
|
|
|
501
501
|
---
|
|
@@ -47,7 +47,7 @@ export READONLY_MODE=true
|
|
|
47
47
|
echo $ENVIRONMENT # Should show "production"
|
|
48
48
|
|
|
49
49
|
# Alert the team
|
|
50
|
-
|
|
50
|
+
pa:debug start --reason "Investigating ticket #1234"
|
|
51
51
|
```
|
|
52
52
|
|
|
53
53
|
---
|
|
@@ -435,16 +435,16 @@ gh pr create --title "Fix N+1 query in dashboard loading"
|
|
|
435
435
|
|
|
436
436
|
```bash
|
|
437
437
|
# Start debug session
|
|
438
|
-
|
|
438
|
+
pa:debug start --ticket TICKET-1234
|
|
439
439
|
|
|
440
440
|
# Log findings
|
|
441
|
-
|
|
441
|
+
pa:debug log "Found N+1 query in dashboard loading"
|
|
442
442
|
|
|
443
443
|
# Share findings
|
|
444
|
-
|
|
444
|
+
pa:debug share --channel #engineering
|
|
445
445
|
|
|
446
446
|
# End session
|
|
447
|
-
|
|
447
|
+
pa:debug end --summary "Root cause: N+1 query, fix deployed"
|
|
448
448
|
```
|
|
449
449
|
|
|
450
450
|
---
|
|
@@ -563,16 +563,16 @@ export async function POST(request: NextRequest) {
|
|
|
563
563
|
|
|
564
564
|
---
|
|
565
565
|
|
|
566
|
-
##
|
|
566
|
+
## Commands (Next.js-specific)
|
|
567
567
|
|
|
568
568
|
| Command | Description |
|
|
569
569
|
|---------|-------------|
|
|
570
|
-
|
|
|
571
|
-
|
|
|
572
|
-
|
|
|
573
|
-
|
|
|
574
|
-
|
|
|
575
|
-
|
|
|
576
|
-
|
|
|
577
|
-
|
|
|
578
|
-
|
|
|
570
|
+
| `pa:page [route]` | Generate new page |
|
|
571
|
+
| `pa:api [route]` | Generate API route |
|
|
572
|
+
| `pa:component [name]` | Generate component |
|
|
573
|
+
| `pa:layout [route]` | Generate layout |
|
|
574
|
+
| `pa:loading [route]` | Generate loading UI |
|
|
575
|
+
| `pa:error [route]` | Generate error UI |
|
|
576
|
+
| `pa:hook [name]` | Generate custom hook |
|
|
577
|
+
| `pa:service [name]` | Generate service |
|
|
578
|
+
| `pa:model [name]` | Generate Prisma model |
|
|
@@ -543,16 +543,16 @@ export { router as resourceRoutes };
|
|
|
543
543
|
|
|
544
544
|
---
|
|
545
545
|
|
|
546
|
-
##
|
|
546
|
+
## Commands (Node.js-specific)
|
|
547
547
|
|
|
548
548
|
| Command | Description |
|
|
549
549
|
|---------|-------------|
|
|
550
|
-
|
|
|
551
|
-
|
|
|
552
|
-
|
|
|
553
|
-
|
|
|
554
|
-
|
|
|
555
|
-
|
|
|
556
|
-
|
|
|
557
|
-
|
|
|
558
|
-
|
|
|
550
|
+
| `pa:route [name]` | Generate new route + controller + service |
|
|
551
|
+
| `pa:controller [name]` | Generate controller |
|
|
552
|
+
| `pa:service [name]` | Generate service |
|
|
553
|
+
| `pa:middleware [name]` | Generate middleware |
|
|
554
|
+
| `pa:validator [name]` | Generate Zod validator |
|
|
555
|
+
| `pa:model [name]` | Generate Prisma model |
|
|
556
|
+
| `pa:migrate` | Run database migrations |
|
|
557
|
+
| `pa:seed` | Run database seeding |
|
|
558
|
+
| `pa:docs` | Generate OpenAPI docs |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Project Type Selection
|
|
2
2
|
|
|
3
|
-
Interactive project type selection during
|
|
3
|
+
Interactive project type selection during `pa:init` command.
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
@@ -390,12 +390,12 @@ Each type includes:
|
|
|
390
390
|
|
|
391
391
|
---
|
|
392
392
|
|
|
393
|
-
##
|
|
393
|
+
## Commands
|
|
394
394
|
|
|
395
395
|
| Command | Description |
|
|
396
396
|
|---------|-------------|
|
|
397
|
-
|
|
|
398
|
-
|
|
|
399
|
-
|
|
|
400
|
-
|
|
|
401
|
-
|
|
|
397
|
+
| `pa:init` | Start with project type selection |
|
|
398
|
+
| `pa:init --type web` | Skip selection, use web frontend |
|
|
399
|
+
| `pa:init --type mobile --framework react-native` | Full preset |
|
|
400
|
+
| `pa:init --wizard` | Full interactive wizard |
|
|
401
|
+
| `pa:init --quick` | Minimal setup |
|
|
@@ -388,12 +388,12 @@ describe('MyComponent', () => {
|
|
|
388
388
|
|
|
389
389
|
---
|
|
390
390
|
|
|
391
|
-
##
|
|
391
|
+
## Commands (React-specific)
|
|
392
392
|
|
|
393
393
|
| Command | Description |
|
|
394
394
|
|---------|-------------|
|
|
395
|
-
|
|
|
396
|
-
|
|
|
397
|
-
|
|
|
398
|
-
|
|
|
399
|
-
|
|
|
395
|
+
| `pa:component [name]` | Generate new component |
|
|
396
|
+
| `pa:hook [name]` | Generate custom hook |
|
|
397
|
+
| `pa:page [name]` | Generate page component |
|
|
398
|
+
| `pa:service [name]` | Generate service |
|
|
399
|
+
| `pa:store [name]` | Generate Zustand store |
|
|
@@ -461,16 +461,16 @@ src/components/Button/
|
|
|
461
461
|
|
|
462
462
|
---
|
|
463
463
|
|
|
464
|
-
##
|
|
464
|
+
## Commands (React Native-specific)
|
|
465
465
|
|
|
466
466
|
| Command | Description |
|
|
467
467
|
|---------|-------------|
|
|
468
|
-
|
|
|
469
|
-
|
|
|
470
|
-
|
|
|
471
|
-
|
|
|
472
|
-
|
|
|
473
|
-
|
|
|
474
|
-
|
|
|
475
|
-
|
|
|
476
|
-
|
|
|
468
|
+
| `pa:screen [name]` | Generate new screen |
|
|
469
|
+
| `pa:component [name]` | Generate component |
|
|
470
|
+
| `pa:hook [name]` | Generate custom hook |
|
|
471
|
+
| `pa:navigator [name]` | Generate navigator |
|
|
472
|
+
| `pa:service [name]` | Generate service |
|
|
473
|
+
| `pa:run ios` | Run on iOS simulator |
|
|
474
|
+
| `pa:run android` | Run on Android emulator |
|
|
475
|
+
| `pa:build ios` | Build iOS release |
|
|
476
|
+
| `pa:build android` | Build Android release |
|
|
@@ -382,9 +382,9 @@ app.get('/fetch', async (req, res) => {
|
|
|
382
382
|
|
|
383
383
|
---
|
|
384
384
|
|
|
385
|
-
##
|
|
385
|
+
## Commands
|
|
386
386
|
|
|
387
387
|
| Command | Description |
|
|
388
388
|
|---------|-------------|
|
|
389
|
-
|
|
|
390
|
-
|
|
|
389
|
+
| `pa:owasp-check` | Run OWASP checklist |
|
|
390
|
+
| `pa:security-review` | Full security review |
|
|
@@ -462,12 +462,12 @@ security:
|
|
|
462
462
|
|
|
463
463
|
---
|
|
464
464
|
|
|
465
|
-
##
|
|
465
|
+
## Commands
|
|
466
466
|
|
|
467
467
|
| Command | Description |
|
|
468
468
|
|---------|-------------|
|
|
469
|
-
|
|
|
470
|
-
|
|
|
471
|
-
|
|
|
472
|
-
|
|
|
473
|
-
|
|
|
469
|
+
| `pa:security-scan` | Run full SAST scan |
|
|
470
|
+
| `pa:security-scan --quick` | Run quick security lint |
|
|
471
|
+
| `pa:security-scan --file [path]` | Scan specific file |
|
|
472
|
+
| `pa:security-report` | Generate security report |
|
|
473
|
+
| `pa:security-fix [issue-id]` | Get fix guidance |
|
|
@@ -333,11 +333,11 @@ For rapid assessments:
|
|
|
333
333
|
|
|
334
334
|
---
|
|
335
335
|
|
|
336
|
-
##
|
|
336
|
+
## Commands
|
|
337
337
|
|
|
338
338
|
| Command | Description |
|
|
339
339
|
|---------|-------------|
|
|
340
|
-
|
|
|
341
|
-
|
|
|
342
|
-
|
|
|
343
|
-
|
|
|
340
|
+
| `pa:security-report` | Generate full security report |
|
|
341
|
+
| `pa:security-report --quick` | Generate quick check |
|
|
342
|
+
| `pa:security-report --template` | Get blank template |
|
|
343
|
+
| `pa:security-report --export pdf` | Export as PDF |
|
|
@@ -318,12 +318,12 @@ security:
|
|
|
318
318
|
|
|
319
319
|
---
|
|
320
320
|
|
|
321
|
-
##
|
|
321
|
+
## Commands
|
|
322
322
|
|
|
323
323
|
| Command | Description |
|
|
324
324
|
|---------|-------------|
|
|
325
|
-
|
|
|
326
|
-
|
|
|
327
|
-
|
|
|
328
|
-
|
|
|
329
|
-
|
|
|
325
|
+
| `pa:security-scan` | Run security scan |
|
|
326
|
+
| `pa:security-deps` | Scan dependencies |
|
|
327
|
+
| `pa:security-sast` | Run SAST analysis |
|
|
328
|
+
| `pa:security-secrets` | Scan for secrets |
|
|
329
|
+
| `pa:security-report` | Generate security report |
|