moflo 4.8.29 → 4.8.31

package/.claude/guidance/shipped/moflo.md

@@ -33,46 +33,24 @@ npx flo doctor --fix  # Verify everything is working
 
 ## Building from Source
 
-Moflo is a TypeScript monorepo using **project references** (`tsc -b`). The root `tsconfig.json` is a solution-style config that delegates to `src/tsconfig.json`, which references all 17 `@claude-flow/*` sub-packages.
+**Full instructions: [`docs/BUILD.md`](../../../docs/BUILD.md)** — the canonical, step-by-step build/test/publish process. Always follow it.
 
-### Build Commands
+Quick reference (from project root only):
 
 ```bash
-npm run build          # Runs tsc -b (project references build)
-npm run build:ts       # Build @claude-flow/cli only (legacy shortcut)
-npm run build:guidance # Build @claude-flow/guidance only (legacy shortcut)
+git pull origin main                   # ALWAYS pull first
+npm run build                          # tsc -b (project references)
+npm test                               # 0 failures required
+npm version patch --no-git-tag-version # Bump + sync cli version
+npm run build                          # Rebuild with new version
+npm publish --otp=XXX                  # Requires 2FA OTP
 ```
 
-### Architecture
-
-```
-tsconfig.json              → Solution root (references src/)
-  src/tsconfig.json        → References all @claude-flow/* packages
-    src/tsconfig.base.json → Shared compilerOptions (ES2022, bundler, composite)
-    src/@claude-flow/shared/    → Base types (no deps)
-    src/@claude-flow/cli/       → CLI + MCP server (depends on shared, swarm)
-    src/@claude-flow/hooks/     → Hook system (depends on shared, neural, memory)
-    src/@claude-flow/memory/    → Memory backends (no deps)
-    src/@claude-flow/guidance/  → Guidance indexing (depends on hooks)
-    src/@claude-flow/testing/   → Regression tests (depends on shared, memory, swarm)
-    ... (17 packages total)
-```
-
-### Important Rules
-
-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.
-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.
-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.
-4. **Sub-packages need `composite: true`** — Every sub-package tsconfig must have `"composite": true` in compilerOptions for project references to work.
-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.
-
-### Publishing
-
-```bash
-npm version patch      # Bump version (auto-syncs cli sub-package version)
-npm run build          # MUST succeed with zero errors
-npm publish --otp=XXX  # Requires 2FA OTP
-```
+**Critical rules:**
+- npm only — no pnpm, yarn, or bun
+- Always build from root (`npm run build`) — never cd into subdirectories
+- Never publish without a successful build — `prepublishOnly` masks failures
+- Never publish without tests passing
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moflo",
-  "version": "4.8.29",
+  "version": "4.8.31",
   "description": "MoFlo — AI agent orchestration for Claude Code. Forked from ruflo/claude-flow with patches applied to source, plus feature-level orchestration.",
   "main": "dist/index.js",
   "type": "module",

package/src/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js

@@ -12,7 +12,8 @@ async function getRealSearchFunction() {
             const { searchEntries } = await import('../memory/memory-initializer.js');
             searchEntriesFn = searchEntries;
         }
-        catch {
+        catch (err) {
+            console.error('[hooks-tools] Failed to load memory-initializer searchEntries:', err instanceof Error ? err.message : String(err));
             searchEntriesFn = null;
         }
     }
@@ -26,7 +27,8 @@ async function getRealStoreFunction() {
             const { storeEntry } = await import('../memory/memory-initializer.js');
             storeEntryFn = storeEntry;
         }
-        catch {
+        catch (err) {
+            console.error('[hooks-tools] Failed to load memory-initializer storeEntry:', err instanceof Error ? err.message : String(err));
             storeEntryFn = null;
         }
     }
@@ -1410,11 +1412,15 @@ export const hooksPretrain = {
     handler: async (params) => {
         const repoPath = resolve(params.path || '.');
         const depth = params.depth || 'medium';
-        const fileTypesStr = params.fileTypes || 'ts,js,py,md';
+        // Handle fileTypes as either string ("ts,js,py") or array (["ts","js","py"])
+        const rawFileTypes = params.fileTypes;
+        const fileTypesArr = Array.isArray(rawFileTypes)
+            ? rawFileTypes.map((t) => String(t).trim())
+            : (typeof rawFileTypes === 'string' ? rawFileTypes : 'ts,js,py,md').split(',').map(e => e.trim());
         const startTime = Date.now();
         // Determine file limit by depth
         const fileLimit = depth === 'deep' ? 100 : depth === 'shallow' ? 30 : 60;
-        const extensions = new Set(fileTypesStr.split(',').map(e => e.trim()));
+        const extensions = new Set(fileTypesArr);
         // Phase 1: Retrieve - collect source files
         const retrieveStart = Date.now();
         const files = collectFiles(repoPath, extensions, fileLimit);
@@ -1460,7 +1466,7 @@ export const hooksPretrain = {
         return {
             path: repoPath,
             depth,
-            fileTypes: fileTypesStr,
+            fileTypes: fileTypesArr.join(','),
             stats: {
                 filesAnalyzed: files.length,
                 patternsExtracted: patterns.length,
@@ -2274,7 +2280,7 @@ export const hooksPatternSearch = {
             query: { type: 'string', description: 'Search query' },
             topK: { type: 'number', description: 'Number of results' },
             minConfidence: { type: 'number', description: 'Minimum similarity threshold (0-1)' },
-            namespace: { type: 'string', description: 'Namespace to search (default: pattern)' },
+            namespace: { type: 'string', description: 'Namespace to search (default: patterns)' },
         },
         required: ['query'],
     },
@@ -2282,7 +2288,7 @@ export const hooksPatternSearch = {
         const query = params.query;
         const topK = params.topK || 5;
         const minConfidence = params.minConfidence || 0.3;
-        const namespace = params.namespace || 'pattern';
+        const namespace = params.namespace || 'patterns';
         // Phase 3: Try ReasoningBank search via bridge first
         try {
             const bridge = await import('../memory/memory-bridge.js');
@@ -2338,7 +2344,7 @@ export const hooksPatternSearch = {
                     results: [],
                     searchTimeMs: searchResult.searchTime,
                     backend: 'real-vector-search',
-                    note: searchResult.error || 'No matching patterns found. Store patterns first using memory/store with namespace "pattern".',
+                    note: searchResult.error || 'No matching patterns found. Store patterns first using memory/store with namespace "patterns".',
                 };
             }
             catch (error) {

package/src/@claude-flow/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moflo/cli",
-  "version": "4.8.29",
+  "version": "4.8.31",
   "type": "module",
   "description": "MoFlo CLI — AI agent orchestration with specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",