@howlil/ez-agents 3.4.2 → 3.5.0

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 (74) hide show
  1. package/README.md +77 -2
  2. package/agents/ez-observer-agent.md +260 -0
  3. package/agents/ez-release-agent.md +333 -0
  4. package/agents/ez-requirements-agent.md +377 -0
  5. package/agents/ez-scrum-master-agent.md +242 -0
  6. package/agents/ez-tech-lead-agent.md +267 -0
  7. package/bin/install.js +3221 -3272
  8. package/commands/ez/arch-review.md +102 -0
  9. package/commands/ez/execute-phase.md +11 -0
  10. package/commands/ez/export-session.md +79 -0
  11. package/commands/ez/gather-requirements.md +117 -0
  12. package/commands/ez/git-workflow.md +72 -0
  13. package/commands/ez/hotfix.md +120 -0
  14. package/commands/ez/import-session.md +82 -0
  15. package/commands/ez/list-sessions.md +96 -0
  16. package/commands/ez/package-manager.md +316 -0
  17. package/commands/ez/plan-phase.md +9 -1
  18. package/commands/ez/preflight.md +79 -0
  19. package/commands/ez/progress.md +13 -1
  20. package/commands/ez/release.md +153 -0
  21. package/commands/ez/resume.md +107 -0
  22. package/commands/ez/standup.md +85 -0
  23. package/ez-agents/bin/ez-tools.cjs +1095 -716
  24. package/ez-agents/bin/lib/bdd-validator.cjs +622 -0
  25. package/ez-agents/bin/lib/content-scanner.cjs +238 -0
  26. package/ez-agents/bin/lib/context-cache.cjs +154 -0
  27. package/ez-agents/bin/lib/context-errors.cjs +71 -0
  28. package/ez-agents/bin/lib/context-manager.cjs +220 -0
  29. package/ez-agents/bin/lib/discussion-synthesizer.cjs +458 -0
  30. package/ez-agents/bin/lib/file-access.cjs +207 -0
  31. package/ez-agents/bin/lib/git-errors.cjs +83 -0
  32. package/ez-agents/bin/lib/git-utils.cjs +321 -203
  33. package/ez-agents/bin/lib/git-workflow-engine.cjs +1157 -0
  34. package/ez-agents/bin/lib/index.cjs +46 -2
  35. package/ez-agents/bin/lib/lockfile-validator.cjs +227 -0
  36. package/ez-agents/bin/lib/logger.cjs +124 -154
  37. package/ez-agents/bin/lib/memory-compression.cjs +256 -0
  38. package/ez-agents/bin/lib/metrics-tracker.cjs +406 -0
  39. package/ez-agents/bin/lib/package-manager-detector.cjs +203 -0
  40. package/ez-agents/bin/lib/package-manager-executor.cjs +385 -0
  41. package/ez-agents/bin/lib/package-manager-service.cjs +216 -0
  42. package/ez-agents/bin/lib/release-validator.cjs +614 -0
  43. package/ez-agents/bin/lib/safe-exec.cjs +128 -214
  44. package/ez-agents/bin/lib/session-chain.cjs +304 -0
  45. package/ez-agents/bin/lib/session-errors.cjs +81 -0
  46. package/ez-agents/bin/lib/session-export.cjs +251 -0
  47. package/ez-agents/bin/lib/session-import.cjs +262 -0
  48. package/ez-agents/bin/lib/session-manager.cjs +280 -0
  49. package/ez-agents/bin/lib/tier-manager.cjs +428 -0
  50. package/ez-agents/bin/lib/url-fetch.cjs +170 -0
  51. package/ez-agents/references/metrics-schema.md +118 -0
  52. package/ez-agents/references/planning-config.md +140 -0
  53. package/ez-agents/references/tier-strategy.md +103 -0
  54. package/ez-agents/templates/bdd-feature.md +173 -0
  55. package/ez-agents/templates/discussion.md +68 -0
  56. package/ez-agents/templates/incident-runbook.md +205 -0
  57. package/ez-agents/templates/release-checklist.md +133 -0
  58. package/ez-agents/templates/rollback-plan.md +201 -0
  59. package/ez-agents/workflows/arch-review.md +54 -0
  60. package/ez-agents/workflows/autonomous.md +844 -743
  61. package/ez-agents/workflows/execute-phase.md +45 -0
  62. package/ez-agents/workflows/export-session.md +255 -0
  63. package/ez-agents/workflows/gather-requirements.md +206 -0
  64. package/ez-agents/workflows/help.md +92 -0
  65. package/ez-agents/workflows/hotfix.md +291 -0
  66. package/ez-agents/workflows/import-session.md +303 -0
  67. package/ez-agents/workflows/new-milestone.md +713 -384
  68. package/ez-agents/workflows/new-project.md +1107 -1113
  69. package/ez-agents/workflows/plan-phase.md +22 -0
  70. package/ez-agents/workflows/progress.md +15 -25
  71. package/ez-agents/workflows/release.md +253 -0
  72. package/ez-agents/workflows/resume-session.md +215 -0
  73. package/ez-agents/workflows/standup.md +64 -0
  74. package/package.json +9 -2
@@ -0,0 +1,107 @@
1
+ ---
2
+ name: ez:resume
3
+ description: Resume from last session or navigate session chain
4
+ argument-hint: "[session_id] [--previous|--next|--chain]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - AskUserQuestion
9
+ - Bash
10
+ ---
11
+
12
+ <objective>
13
+ Resume work from the last session or navigate the session chain.
14
+
15
+ This command:
16
+ - Loads the most recent session from .planning/sessions/
17
+ - Displays a formatted summary with model, phase, plan, duration, and last activity
18
+ - Shows incomplete items, open decisions, and file changes
19
+ - Presents recommended next action
20
+ - Waits for user confirmation before proceeding
21
+ - Supports navigation through session chain (previous/next)
22
+ </objective>
23
+
24
+ <execution_context>
25
+ @~/.claude/ez-agents/workflows/resume-session.md
26
+ </execution_context>
27
+
28
+ <context>
29
+ $ARGUMENTS
30
+
31
+ Session ID is optional. If not provided, the last session is loaded.
32
+ </context>
33
+
34
+ <process>
35
+ **Follow the resume-session workflow** from @~/.claude/ez-agents/workflows/resume-session.md.
36
+
37
+ The workflow handles all resumption logic including:
38
+
39
+ 1. **Load last session:**
40
+ - Use ez-tools to access SessionManager
41
+ - Call getLastSession()
42
+ - If no sessions: output "No previous sessions found. Start a new session with your work."
43
+ - Exit
44
+
45
+ 2. **Parse session data:**
46
+ - Extract: metadata (model, phase, plan, started_at, ended_at, status)
47
+ - Extract: context (transcript, tasks, decisions, file_changes)
48
+ - Extract: state (incomplete_tasks, last_action, next_recommended_action)
49
+
50
+ 3. **Generate summary display:**
51
+ - Use box-drawing characters for header:
52
+ ```
53
+ ╔══════════════════════════════════════════════════════════════╗
54
+ ║ SESSION RESUME: {session_id} ║
55
+ ╠══════════════════════════════════════════════════════════════╣
56
+ ║ Model: {model} ║
57
+ ║ Phase: {phase} - {phase_name} ║
58
+ ║ Plan: {plan} - {plan_name} ║
59
+ ║ Duration: {calculated} ║
60
+ ║ Ended: {ended_at formatted} ║
61
+ ╚══════════════════════════════════════════════════════════════╝
62
+ ```
63
+ - Section: "## Last Activity" - shows last completed task and in-progress task
64
+ - Section: "## Incomplete Items" - lists state.incomplete_tasks
65
+ - Section: "## Open Decisions" - lists context.open_questions or "None"
66
+ - Section: "## File Changes" - lists context.file_changes
67
+ - Section: "## Recommended Next Action" - shows state.next_recommended_action
68
+
69
+ 4. **Present options:**
70
+ ```
71
+ What would you like to do?
72
+
73
+ 1. Continue from last task
74
+ 2. Show full transcript
75
+ 3. Export session for handoff
76
+ 4. Navigate session chain
77
+ 5. Start fresh (ignore session)
78
+ 6. Something else
79
+ ```
80
+
81
+ 5. **Handle user choice:**
82
+ - "1" or "Continue":
83
+ - Update STATE.md with session continuity
84
+ - Load session context into conversation
85
+ - Proceed with recommended action
86
+ - "2" or "Show transcript":
87
+ - Display full transcript from session.context.transcript
88
+ - "3" or "Export":
89
+ - Trigger export-session workflow
90
+ - "4" or "Navigate":
91
+ - Show chain visualization
92
+ - Offer: Previous, Next, Jump to specific
93
+ - "5" or "Start fresh":
94
+ - Acknowledge, start new context
95
+ - "6" or "Something else":
96
+ - Enter interactive mode
97
+
98
+ 6. **On confirmation to continue:**
99
+ - Call ez-tools state record-session with stopped-at and resume-file
100
+ - Load relevant context files (PLAN.md, STATE.md, incomplete task files)
101
+ - Output: "Resuming from {session_id}. Last action: {last_action}"
102
+
103
+ **Navigation flags:**
104
+ - `--previous`: Navigate to previous session in chain
105
+ - `--next`: Navigate to next session in chain
106
+ - `--chain`: Show full chain visualization
107
+ </process>
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: ez:standup
3
+ description: Run a sprint standup simulation. Scrum Master agent reports velocity, blockers, and sprint health score.
4
+ argument-hint: "[phase]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Glob
9
+ - Grep
10
+ ---
11
+
12
+ <execution_context>
13
+ @~/.claude/ez-agents/workflows/standup.md
14
+ </execution_context>
15
+
16
+ <process>
17
+ Execute the standup workflow from @~/.claude/ez-agents/workflows/standup.md end-to-end.
18
+ Parse ARGUMENTS for optional phase number before executing.
19
+ </process>
20
+
21
+ # /ez:standup
22
+
23
+ Run a sprint standup simulation. The Scrum Master agent analyzes project state and reports velocity trends, active blockers, and sprint health score.
24
+
25
+ ## Usage
26
+
27
+ ```
28
+ /ez:standup [phase]
29
+ ```
30
+
31
+ ## Arguments
32
+
33
+ | Argument | Description |
34
+ |----------|-------------|
35
+ | `phase` | Optional phase number for phase-specific standup. Defaults to current phase. |
36
+
37
+ ## What It Produces
38
+
39
+ ```
40
+ ## Daily Standup — 2026-03-19
41
+
42
+ ### Yesterday
43
+ - Completed: Phase 17 — Package Manager Flexibility (3 plans)
44
+ - Verified: Phase 17 passed verification (score 4/5)
45
+
46
+ ### Today (Planned)
47
+ - Phase 18: Session Memory — 3 plans ready
48
+ - Next: Execute Phase 18
49
+
50
+ ### Blockers
51
+ None
52
+
53
+ ### Velocity Trend
54
+ ↑ IMPROVING — avg 2.3 plans/session (up from 1.8 last 5 sessions)
55
+
56
+ Sprint Health: 78/100 — SOME FRICTION
57
+ Recommendation: Coverage at 71% — target 80% for medium tier release
58
+ ```
59
+
60
+ ## Sprint Health Score
61
+
62
+ The standup includes a 0-100 sprint health score:
63
+
64
+ | Score | Status | Meaning |
65
+ |-------|--------|---------|
66
+ | 80-100 | HEALTHY | Continue at pace |
67
+ | 60-79 | SOME FRICTION | Address specific warnings |
68
+ | 40-59 | STRUGGLING | Consider scope reduction |
69
+ | <40 | AT RISK | Pause and address blockers |
70
+
71
+ Dimensions tracked: velocity trend, active blockers, deviation rate, requirements coverage, plan completion rate, BDD pass rate.
72
+
73
+ ## When to Use
74
+
75
+ - Before starting a new phase to check team health
76
+ - After a phase completes to see trend
77
+ - When things feel slow — get an objective measure
78
+ - Before a release to check if ready
79
+
80
+ ## Related Commands
81
+
82
+ - `/ez:arch-review` — Technical architecture review
83
+ - `/ez:progress` — Project progress overview
84
+ - `/ez:stats` — Enhanced metrics dashboard
85
+ - `/ez:release` — Release with readiness validation