crewly 1.4.73 → 1.4.74

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.
@@ -1,14 +1,14 @@
1
1
  ---
2
2
  id: dev-git-workflow
3
- version: 1
3
+ version: 2
4
4
  createdAt: 2026-01-29T00:00:00Z
5
- updatedAt: 2026-01-29T00:00:00Z
5
+ updatedAt: 2026-03-23T00:00:00Z
6
6
  createdBy: system
7
7
  role: developer
8
8
  category: git
9
9
  priority: 10
10
10
  title: Git Workflow
11
- description: Standard git workflow for developers
11
+ description: Standard git workflow for developers — includes branch lifecycle and merge requirements
12
12
  triggers:
13
13
  - commit
14
14
  - push
@@ -30,6 +30,36 @@ tags:
30
30
  - `refactor/{description}` - Code refactoring
31
31
  - `test/{description}` - Adding tests
32
32
 
33
+ ## Branch Lifecycle (MANDATORY)
34
+
35
+ ### Creating Branches
36
+ 1. Always branch from `main`
37
+ 2. Keep branches short-lived (max 1-2 days)
38
+ 3. One feature/fix per branch
39
+
40
+ ### Merging Branches
41
+ 1. **3-Round Review SOP** before merge:
42
+ - Round 1: Self-review — `git diff main..branch`, check code quality, test coverage
43
+ - Round 2: Fix issues found in Round 1, run tests
44
+ - Round 3: Final verification — confirm all tests pass, no regressions
45
+ 2. Merge to main: `git checkout main && git merge --no-ff branch`
46
+ 3. Push main: `git push origin main`
47
+
48
+ ### Branch Cleanup (CRITICAL — DO NOT SKIP)
49
+ 1. **After merge**: Delete the branch immediately
50
+ - Local: `git branch -d feat/my-feature`
51
+ - Remote: `git push origin --delete feat/my-feature`
52
+ 2. **After task completion**: Even if work was committed directly to main, delete any feature branches created
53
+ 3. **Weekly audit**: Team lead checks for stale branches (> 7 days without activity)
54
+ - Branches with 0 commits ahead of main: DELETE immediately (already merged)
55
+ - Branches with unmerged commits: Review and either merge or discard with documented reason
56
+
57
+ ### Branch Hygiene Rules
58
+ - Never leave branches unmerged for more than 3 days without a documented reason
59
+ - Never deploy from a feature branch — always merge to main first, then deploy from main
60
+ - If a branch has conflicts with main, rebase before requesting review
61
+ - After npm publish, verify no feature branches were accidentally left behind
62
+
33
63
  ## Commit Messages
34
64
 
35
65
  Use conventional commits:
@@ -56,3 +86,18 @@ Types: `feat`, `fix`, `refactor`, `test`, `docs`, `chore`
56
86
  2. Run `npm test`
57
87
  3. Run `npm run lint`
58
88
  4. Review your changes: `git diff`
89
+
90
+ ## Before npm Publish
91
+
92
+ 1. Verify all feature branches are merged or deleted
93
+ 2. Run `git branch` — only `main` should remain (plus any active WIP branches with documented reason)
94
+ 3. Run full test suite
95
+ 4. Bump version: `npm version patch`
96
+ 5. Publish: `npm publish`
97
+
98
+ ## Deployment Checklist
99
+
100
+ 1. After deploying Docker images, verify critical pages are accessible (e.g., cli-token, dashboard)
101
+ 2. If using Cloudflare, purge cache after deployment
102
+ 3. Check container health endpoint returns 200
103
+ 4. Verify no regressions in OAuth flows or authentication
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "crewly",
3
- "version": "1.4.73",
3
+ "version": "1.4.74",
4
4
  "type": "module",
5
5
  "description": "Multi-agent orchestration platform for AI coding teams — coordinates Claude Code, Gemini CLI, and Codex agents with a real-time web dashboard",
6
6
  "main": "dist/cli/cli/src/index.js",