moflo 4.8.30 → 4.8.31
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.
|
@@ -33,46 +33,24 @@ npx flo doctor --fix # Verify everything is working
|
|
|
33
33
|
|
|
34
34
|
## Building from Source
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
**Full instructions: [`docs/BUILD.md`](../../../docs/BUILD.md)** — the canonical, step-by-step build/test/publish process. Always follow it.
|
|
37
37
|
|
|
38
|
-
|
|
38
|
+
Quick reference (from project root only):
|
|
39
39
|
|
|
40
40
|
```bash
|
|
41
|
-
|
|
42
|
-
npm run build
|
|
43
|
-
npm
|
|
41
|
+
git pull origin main # ALWAYS pull first
|
|
42
|
+
npm run build # tsc -b (project references)
|
|
43
|
+
npm test # 0 failures required
|
|
44
|
+
npm version patch --no-git-tag-version # Bump + sync cli version
|
|
45
|
+
npm run build # Rebuild with new version
|
|
46
|
+
npm publish --otp=XXX # Requires 2FA OTP
|
|
44
47
|
```
|
|
45
48
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
src/tsconfig.base.json → Shared compilerOptions (ES2022, bundler, composite)
|
|
52
|
-
src/@claude-flow/shared/ → Base types (no deps)
|
|
53
|
-
src/@claude-flow/cli/ → CLI + MCP server (depends on shared, swarm)
|
|
54
|
-
src/@claude-flow/hooks/ → Hook system (depends on shared, neural, memory)
|
|
55
|
-
src/@claude-flow/memory/ → Memory backends (no deps)
|
|
56
|
-
src/@claude-flow/guidance/ → Guidance indexing (depends on hooks)
|
|
57
|
-
src/@claude-flow/testing/ → Regression tests (depends on shared, memory, swarm)
|
|
58
|
-
... (17 packages total)
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
### Important Rules
|
|
62
|
-
|
|
63
|
-
1. **Always build from root** — `npm run build` (which runs `tsc -b`) builds all packages in dependency order. Do NOT build individual packages in isolation unless you know what you're doing.
|
|
64
|
-
2. **Never bypass the build** — The `dist/` directories contain compiled JS that ships with `npm publish`. If you edit `.ts` source, you MUST rebuild before publishing.
|
|
65
|
-
3. **Do not work around build errors** — If `tsc -b` fails, fix the type errors. Do not manually compile individual packages to skip errors, as this leads to drift between source and compiled output.
|
|
66
|
-
4. **Sub-packages need `composite: true`** — Every sub-package tsconfig must have `"composite": true` in compilerOptions for project references to work.
|
|
67
|
-
5. **Cross-package imports need `paths`** — If package A imports from `@claude-flow/B`, package A's tsconfig needs both a `"references"` entry and a `"paths"` mapping pointing to B's source.
|
|
68
|
-
|
|
69
|
-
### Publishing
|
|
70
|
-
|
|
71
|
-
```bash
|
|
72
|
-
npm version patch # Bump version (auto-syncs cli sub-package version)
|
|
73
|
-
npm run build # MUST succeed with zero errors
|
|
74
|
-
npm publish --otp=XXX # Requires 2FA OTP
|
|
75
|
-
```
|
|
49
|
+
**Critical rules:**
|
|
50
|
+
- npm only — no pnpm, yarn, or bun
|
|
51
|
+
- Always build from root (`npm run build`) — never cd into subdirectories
|
|
52
|
+
- Never publish without a successful build — `prepublishOnly` masks failures
|
|
53
|
+
- Never publish without tests passing
|
|
76
54
|
|
|
77
55
|
---
|
|
78
56
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "moflo",
|
|
3
|
-
"version": "4.8.
|
|
3
|
+
"version": "4.8.31",
|
|
4
4
|
"description": "MoFlo — AI agent orchestration for Claude Code. Forked from ruflo/claude-flow with patches applied to source, plus feature-level orchestration.",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|