@massu/core 0.1.1 → 0.4.0

package/dist/hooks/user-prompt.js

@@ -3,12 +3,13 @@ import{createRequire as __cr}from"module";const require=__cr(import.meta.url);
 
 // src/memory-db.ts
 import Database from "better-sqlite3";
-import { dirname as dirname2 } from "path";
+import { dirname as dirname2, basename } from "path";
 import { existsSync as existsSync2, mkdirSync } from "fs";
 
 // src/config.ts
 import { resolve, dirname } from "path";
 import { existsSync, readFileSync } from "fs";
+import { homedir } from "os";
 import { parse as parseYaml } from "yaml";
 import { z } from "zod";
 var DomainConfigSchema = z.object({
@@ -140,6 +141,49 @@ var CloudConfigSchema = z.object({
     audit: z.boolean().default(true)
   }).default({ memory: true, analytics: true, audit: true })
 }).optional();
+var ConventionsConfigSchema = z.object({
+  claudeDirName: z.string().default(".claude").refine(
+    (s) => !s.includes("..") && !s.startsWith("/"),
+    { message: 'claudeDirName must not contain ".." or start with "/"' }
+  ),
+  sessionStatePath: z.string().default(".claude/session-state/CURRENT.md").refine(
+    (s) => !s.includes("..") && !s.startsWith("/"),
+    { message: 'sessionStatePath must not contain ".." or start with "/"' }
+  ),
+  sessionArchivePath: z.string().default(".claude/session-state/archive").refine(
+    (s) => !s.includes("..") && !s.startsWith("/"),
+    { message: 'sessionArchivePath must not contain ".." or start with "/"' }
+  ),
+  knowledgeCategories: z.array(z.string()).default([
+    "patterns",
+    "commands",
+    "incidents",
+    "reference",
+    "protocols",
+    "checklists",
+    "playbooks",
+    "critical",
+    "scripts",
+    "status",
+    "templates",
+    "loop-state",
+    "session-state",
+    "agents"
+  ]),
+  knowledgeSourceFiles: z.array(z.string()).default(["CLAUDE.md", "MEMORY.md", "corrections.md"]),
+  excludePatterns: z.array(z.string()).default(["/ARCHIVE/", "/SESSION-HISTORY/"])
+}).optional();
+var PythonDomainConfigSchema = z.object({
+  name: z.string(),
+  packages: z.array(z.string()),
+  allowed_imports_from: z.array(z.string()).default([])
+});
+var PythonConfigSchema = z.object({
+  root: z.string(),
+  alembic_dir: z.string().optional(),
+  domains: z.array(PythonDomainConfigSchema).default([]),
+  exclude_dirs: z.array(z.string()).default(["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache"])
+}).optional();
 var PathsConfigSchema = z.object({
   source: z.string().default("src"),
   aliases: z.record(z.string(), z.string()).default({ "@": "src" }),
@@ -174,7 +218,9 @@ var RawConfigSchema = z.object({
   security: SecurityConfigSchema,
   team: TeamConfigSchema,
   regression: RegressionConfigSchema,
-  cloud: CloudConfigSchema
+  cloud: CloudConfigSchema,
+  conventions: ConventionsConfigSchema,
+  python: PythonConfigSchema
 }).passthrough();
 var _config = null;
 var _projectRoot = null;
@@ -238,13 +284,24 @@ function getConfig() {
     security: parsed.security,
     team: parsed.team,
     regression: parsed.regression,
-    cloud: parsed.cloud
+    cloud: parsed.cloud,
+    conventions: parsed.conventions,
+    python: parsed.python
   };
+  if (!_config.cloud?.apiKey && process.env.MASSU_API_KEY) {
+    _config.cloud = {
+      enabled: true,
+      sync: { memory: true, analytics: true, audit: true },
+      ..._config.cloud,
+      apiKey: process.env.MASSU_API_KEY
+    };
+  }
   return _config;
 }
 function getResolvedPaths() {
   const config = getConfig();
   const root = getProjectRoot();
+  const claudeDirName = config.conventions?.claudeDirName ?? ".claude";
   return {
     codegraphDbPath: resolve(root, ".codegraph/codegraph.db"),
     dataDbPath: resolve(root, ".massu/data.db"),
@@ -260,22 +317,43 @@ function getResolvedPaths() {
     ),
     extensions: [".ts", ".tsx", ".js", ".jsx"],
     indexFiles: ["index.ts", "index.tsx", "index.js", "index.jsx"],
-    patternsDir: resolve(root, ".claude/patterns"),
-    claudeMdPath: resolve(root, ".claude/CLAUDE.md"),
+    patternsDir: resolve(root, claudeDirName, "patterns"),
+    claudeMdPath: resolve(root, claudeDirName, "CLAUDE.md"),
     docsMapPath: resolve(root, ".massu/docs-map.json"),
     helpSitePath: resolve(root, "../" + config.project.name + "-help"),
-    memoryDbPath: resolve(root, ".massu/memory.db")
+    memoryDbPath: resolve(root, ".massu/memory.db"),
+    knowledgeDbPath: resolve(root, ".massu/knowledge.db"),
+    plansDir: resolve(root, "docs/plans"),
+    docsDir: resolve(root, "docs"),
+    claudeDir: resolve(root, claudeDirName),
+    memoryDir: resolve(homedir(), claudeDirName, "projects", root.replace(/\//g, "-"), "memory"),
+    sessionStatePath: resolve(root, config.conventions?.sessionStatePath ?? `${claudeDirName}/session-state/CURRENT.md`),
+    sessionArchivePath: resolve(root, config.conventions?.sessionArchivePath ?? `${claudeDirName}/session-state/archive`),
+    mcpJsonPath: resolve(root, ".mcp.json"),
+    settingsLocalPath: resolve(root, claudeDirName, "settings.local.json")
   };
 }
 
-// src/memory-schema.ts
+// src/memory-db.ts
+function getMemoryDb() {
+  const dbPath = getResolvedPaths().memoryDbPath;
+  const dir = dirname2(dbPath);
+  if (!existsSync2(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+  const db = new Database(dbPath);
+  db.pragma("journal_mode = WAL");
+  db.pragma("foreign_keys = ON");
+  initMemorySchema(db);
+  return db;
+}
 function initMemorySchema(db) {
   db.exec(`
     -- Sessions table (linked to Claude Code session IDs)
     CREATE TABLE IF NOT EXISTS sessions (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       session_id TEXT UNIQUE NOT NULL,
-      project TEXT NOT NULL DEFAULT 'unknown',
+      project TEXT NOT NULL DEFAULT 'my-project',
       git_branch TEXT,
       started_at TEXT NOT NULL,
       started_at_epoch INTEGER NOT NULL,
@@ -330,9 +408,7 @@ function initMemorySchema(db) {
         content_rowid='id'
       );
     `);
-  } catch (e) {
-    process.stderr.write(`FTS5 setup warning: ${e instanceof Error ? e.message : String(e)}
-`);
+  } catch (_e) {
   }
   db.exec(`
     CREATE TRIGGER IF NOT EXISTS observations_ai AFTER INSERT ON observations BEGIN
@@ -392,9 +468,7 @@ function initMemorySchema(db) {
         content_rowid='id'
       );
     `);
-  } catch (e) {
-    process.stderr.write(`FTS5 setup warning: ${e instanceof Error ? e.message : String(e)}
-`);
+  } catch (_e) {
   }
   db.exec(`
     CREATE TRIGGER IF NOT EXISTS prompts_ai AFTER INSERT ON user_prompts BEGIN
@@ -464,9 +538,7 @@ function initMemorySchema(db) {
         content_rowid=id
       );
     `);
-  } catch (e) {
-    process.stderr.write(`FTS5 setup warning: ${e instanceof Error ? e.message : String(e)}
-`);
+  } catch (_e) {
   }
   db.exec(`
     CREATE TRIGGER IF NOT EXISTS ct_fts_insert AFTER INSERT ON conversation_turns BEGIN
@@ -490,7 +562,7 @@ function initMemorySchema(db) {
     CREATE TABLE IF NOT EXISTS session_quality_scores (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       session_id TEXT NOT NULL UNIQUE,
-      project TEXT NOT NULL DEFAULT 'unknown',
+      project TEXT NOT NULL DEFAULT 'my-project',
       score INTEGER NOT NULL DEFAULT 100,
       security_score INTEGER NOT NULL DEFAULT 100,
       architecture_score INTEGER NOT NULL DEFAULT 100,
@@ -513,7 +585,7 @@ function initMemorySchema(db) {
     CREATE TABLE IF NOT EXISTS session_costs (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       session_id TEXT NOT NULL UNIQUE,
-      project TEXT NOT NULL DEFAULT 'unknown',
+      project TEXT NOT NULL DEFAULT 'my-project',
       input_tokens INTEGER NOT NULL DEFAULT 0,
       output_tokens INTEGER NOT NULL DEFAULT 0,
       cache_read_tokens INTEGER NOT NULL DEFAULT 0,
@@ -740,10 +812,40 @@ function initMemorySchema(db) {
     );
     CREATE INDEX IF NOT EXISTS idx_pending_sync_created ON pending_sync(created_at ASC);
   `);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS license_cache (
+      api_key_hash TEXT PRIMARY KEY,
+      tier TEXT NOT NULL,
+      valid_until TEXT NOT NULL,
+      last_validated TEXT NOT NULL,
+      features TEXT DEFAULT '[]'
+    );
+  `);
+}
+function assignImportance(type, vrResult) {
+  switch (type) {
+    case "decision":
+    case "failed_attempt":
+      return 5;
+    case "cr_violation":
+    case "incident_near_miss":
+      return 4;
+    case "vr_check":
+      return vrResult === "PASS" ? 2 : 4;
+    case "pattern_compliance":
+      return vrResult === "PASS" ? 2 : 4;
+    case "feature":
+    case "bugfix":
+      return 3;
+    case "refactor":
+      return 2;
+    case "file_change":
+    case "discovery":
+      return 1;
+    default:
+      return 3;
+  }
 }
-
-// src/memory-queries.ts
-import { basename } from "path";
 function autoDetectTaskId(planFile) {
   if (!planFile) return null;
   const base = basename(planFile);
@@ -757,6 +859,29 @@ function createSession(db, sessionId, opts) {
     VALUES (?, ?, ?, ?, ?, ?)
   `).run(sessionId, opts?.branch ?? null, opts?.planFile ?? null, taskId, now.toISOString(), Math.floor(now.getTime() / 1e3));
 }
+function addObservation(db, sessionId, type, title, detail, opts) {
+  const now = /* @__PURE__ */ new Date();
+  const importance = opts?.importance ?? assignImportance(type, opts?.evidence?.includes("PASS") ? "PASS" : void 0);
+  const result = db.prepare(`
+    INSERT INTO observations (session_id, type, title, detail, files_involved, plan_item, cr_rule, vr_type, evidence, importance, original_tokens, created_at, created_at_epoch)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).run(
+    sessionId,
+    type,
+    title,
+    detail,
+    JSON.stringify(opts?.filesInvolved ?? []),
+    opts?.planItem ?? null,
+    opts?.crRule ?? null,
+    opts?.vrType ?? null,
+    opts?.evidence ?? null,
+    importance,
+    opts?.originalTokens ?? 0,
+    now.toISOString(),
+    Math.floor(now.getTime() / 1e3)
+  );
+  return Number(result.lastInsertRowid);
+}
 function addUserPrompt(db, sessionId, text, promptNumber) {
   const now = /* @__PURE__ */ new Date();
   db.prepare(`
@@ -768,25 +893,8 @@ function linkSessionToTask(db, sessionId, taskId) {
   db.prepare("UPDATE sessions SET task_id = ? WHERE session_id = ?").run(taskId, sessionId);
 }
 
-// src/memory-db.ts
-var initializedPaths = /* @__PURE__ */ new Set();
-function getMemoryDb() {
-  const dbPath = getResolvedPaths().memoryDbPath;
-  const dir = dirname2(dbPath);
-  if (!existsSync2(dir)) {
-    mkdirSync(dir, { recursive: true });
-  }
-  const db = new Database(dbPath);
-  db.pragma("journal_mode = WAL");
-  db.pragma("foreign_keys = ON");
-  if (!initializedPaths.has(dbPath)) {
-    initMemorySchema(db);
-    initializedPaths.add(dbPath);
-  }
-  return db;
-}
-
 // src/hooks/user-prompt.ts
+import { existsSync as existsSync3 } from "fs";
 async function main() {
   try {
     const input = await readStdin();
@@ -814,6 +922,35 @@ async function main() {
       ).get(session_id);
       const promptNumber = countResult.count + 1;
       addUserPrompt(db, session_id, prompt.trim(), promptNumber);
+      try {
+        const fileRefs = extractFileReferences(prompt);
+        if (fileRefs.length > 0) {
+          const knowledgeDbPath = getResolvedPaths().knowledgeDbPath;
+          if (knowledgeDbPath && existsSync3(knowledgeDbPath)) {
+            const Database2 = (await import("better-sqlite3")).default;
+            const kdb = new Database2(knowledgeDbPath, { readonly: true });
+            try {
+              const placeholders = fileRefs.map(() => "?").join(",");
+              const matches = kdb.prepare(
+                `SELECT DISTINCT file_path FROM knowledge_documents WHERE file_path IN (${placeholders})`
+              ).all(...fileRefs);
+              if (matches.length > 0) {
+                addObservation(
+                  db,
+                  session_id,
+                  "discovery",
+                  `Knowledge entries exist for referenced files`,
+                  `Files with knowledge context: ${matches.map((m) => m.file_path).join(", ")}`,
+                  { importance: 2 }
+                );
+              }
+            } finally {
+              kdb.close();
+            }
+          }
+        }
+      } catch (_knowledgeErr) {
+      }
     } finally {
       db.close();
     }
@@ -821,6 +958,15 @@ async function main() {
   }
   process.exit(0);
 }
+function extractFileReferences(prompt) {
+  const filePattern = /(?:^|\s)((?:src|packages|lib)\/[\w./-]+\.(?:ts|tsx|js|jsx|md))/g;
+  const matches = [];
+  let match;
+  while ((match = filePattern.exec(prompt)) !== null) {
+    matches.push(match[1]);
+  }
+  return [...new Set(matches)];
+}
 async function getGitBranch() {
   try {
     const { spawnSync } = await import("child_process");
@@ -835,14 +981,14 @@ async function getGitBranch() {
   }
 }
 function readStdin() {
-  return new Promise((resolve2) => {
+  return new Promise((resolve3) => {
     let data = "";
     process.stdin.setEncoding("utf-8");
     process.stdin.on("data", (chunk) => {
       data += chunk;
     });
-    process.stdin.on("end", () => resolve2(data));
-    setTimeout(() => resolve2(data), 3e3);
+    process.stdin.on("end", () => resolve3(data));
+    setTimeout(() => resolve3(data), 3e3);
   });
 }
 main();

package/package.json

@@ -1,25 +1,18 @@
 {
   "name": "@massu/core",
-  "version": "0.1.1",
+  "version": "0.4.0",
   "type": "module",
-  "description": "AI Engineering Governance MCP Server - Session memory, feature registry, code intelligence, and rule enforcement",
-  "license": "BSL-1.1",
-  "author": "Massu AI <hello@massu.ai>",
-  "main": "dist/server.js",
-  "exports": {
-    ".": "./dist/server.js",
-    "./cli": "./dist/cli.js"
-  },
+  "description": "AI Engineering Governance MCP Server - Session memory, knowledge system, feature registry, code intelligence, rule enforcement, tiered tooling (12 free / 72 total), 31 workflow commands",
+  "main": "src/server.ts",
   "bin": {
-    "massu": "dist/cli.js"
+    "massu": "./dist/cli.js"
   },
   "scripts": {
     "start": "npx tsx src/server.ts",
     "test": "vitest run",
-    "build": "tsc --noEmit && npm run build:server && npm run build:hooks",
-    "build:server": "esbuild --bundle --platform=node --format=esm --outdir=dist --entry-names=[name] src/server.ts src/cli.ts --external:better-sqlite3 --external:yaml --external:zod --banner:js='import{createRequire as __cr}from\"module\";const require=__cr(import.meta.url);'",
+    "build": "tsc --noEmit && npm run build:cli && npm run build:hooks",
+    "build:cli": "esbuild --bundle --platform=node --format=esm --outfile=dist/cli.js src/cli.ts --external:better-sqlite3 --external:yaml --external:zod --banner:js='#!/usr/bin/env node\nimport{createRequire as __cr}from\"module\";const require=__cr(import.meta.url);'",
     "build:hooks": "esbuild --bundle --platform=node --format=esm --outdir=dist/hooks src/hooks/*.ts --external:better-sqlite3 --external:yaml --external:zod --banner:js='import{createRequire as __cr}from\"module\";const require=__cr(import.meta.url);'",
-    "test:integration": "vitest run src/__tests__/integration/",
     "prepublishOnly": "bash ../../scripts/prepublish-check.sh && npm run build"
   },
   "dependencies": {
@@ -36,7 +29,9 @@
   },
   "files": [
     "src/**/*",
+    "!src/__tests__/**",
     "dist/**/*",
+    "commands/**/*",
     "LICENSE"
   ],
   "keywords": [
@@ -52,11 +47,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/massu-ai/massu.git",
+    "url": "https://github.com/massu-ai/massu.git",
     "directory": "packages/core"
   },
   "bugs": {
     "url": "https://github.com/massu-ai/massu/issues"
   },
-  "homepage": "https://massu.ai"
+  "homepage": "https://github.com/massu-ai/massu#readme"
 }

package/src/adr-generator.ts

@@ -2,14 +2,18 @@
 // Licensed under BSL 1.1 - see LICENSE file for details.
 
 import type Database from 'better-sqlite3';
-import type { ToolDefinition, ToolResult } from './tool-helpers.ts';
-import { p, text } from './tool-helpers.ts';
+import type { ToolDefinition, ToolResult } from './tools.ts';
 import { getConfig } from './config.ts';
 
 // ============================================================
 // ADR (Architecture Decision Record) Auto-Generation
 // ============================================================
 
+/** Prefix a base tool name with the configured tool prefix. */
+function p(baseName: string): string {
+  return `${getConfig().toolPrefix}_${baseName}`;
+}
+
 /** Default decision detection phrases. Configurable via governance.adr.detection_phrases */
 const DEFAULT_DETECTION_PHRASES = ['chose', 'decided', 'switching to', 'moving from', 'going with'];
 
@@ -283,3 +287,6 @@ function handleAdrGenerate(args: Record<string, unknown>, db: Database.Database)
   return text(lines.filter(Boolean).join('\n'));
 }
 
+function text(content: string): ToolResult {
+  return { content: [{ type: 'text', text: content }] };
+}

package/src/analytics.ts

@@ -2,14 +2,18 @@
 // Licensed under BSL 1.1 - see LICENSE file for details.
 
 import type Database from 'better-sqlite3';
-import type { ToolDefinition, ToolResult } from './tool-helpers.ts';
-import { p, text } from './tool-helpers.ts';
+import type { ToolDefinition, ToolResult } from './tools.ts';
 import { getConfig } from './config.ts';
 
 // ============================================================
 // Quality Trend Analytics
 // ============================================================
 
+/** Prefix a base tool name with the configured tool prefix. */
+function p(baseName: string): string {
+  return `${getConfig().toolPrefix}_${baseName}`;
+}
+
 export interface QualityBreakdown {
   security: number;
   architecture: number;
@@ -118,7 +122,6 @@ export function backfillQualityScores(db: Database.Database): number {
     FROM sessions s
     LEFT JOIN session_quality_scores q ON s.session_id = q.session_id
     WHERE q.session_id IS NULL
-    LIMIT 1000
   `).all() as Array<{ session_id: string }>;
 
   let backfilled = 0;
@@ -365,3 +368,6 @@ function handleQualityReport(args: Record<string, unknown>, db: Database.Databas
   return text(lines.join('\n'));
 }
 
+function text(content: string): ToolResult {
+  return { content: [{ type: 'text', text: content }] };
+}

package/src/audit-trail.ts

@@ -2,14 +2,18 @@
 // Licensed under BSL 1.1 - see LICENSE file for details.
 
 import type Database from 'better-sqlite3';
-import type { ToolDefinition, ToolResult } from './tool-helpers.ts';
-import { p, text } from './tool-helpers.ts';
+import type { ToolDefinition, ToolResult } from './tools.ts';
 import { getConfig } from './config.ts';
 
 // ============================================================
 // Compliance Audit Trail
 // ============================================================
 
+/** Prefix a base tool name with the configured tool prefix. */
+function p(baseName: string): string {
+  return `${getConfig().toolPrefix}_${baseName}`;
+}
+
 export interface AuditEntry {
   eventType: 'code_change' | 'rule_enforced' | 'approval' | 'review' | 'commit' | 'compaction';
   actor: 'ai' | 'human' | 'hook' | 'agent';
@@ -129,7 +133,7 @@ export function backfillAuditLog(db: Database.Database): number {
     FROM observations o
     LEFT JOIN audit_log a ON a.evidence = o.detail AND a.session_id = o.session_id
     WHERE a.id IS NULL
-    AND o.type IN ('bugfix', 'cr_violation', 'vr_check', 'incident_near_miss', 'decision')
+    AND o.type IN ('bugfix', 'cr_violation', 'vr_check', 'incident', 'decision')
     ORDER BY o.created_at ASC
     LIMIT 1000
   `).all() as Array<Record<string, unknown>>;
@@ -441,3 +445,6 @@ function handleAuditChain(args: Record<string, unknown>, db: Database.Database):
   return text(lines.join('\n'));
 }
 
+function text(content: string): ToolResult {
+  return { content: [{ type: 'text', text: content }] };
+}

package/src/backfill-sessions.ts

@@ -13,7 +13,7 @@ import { resolve, basename } from 'path';
 import { getMemoryDb, createSession, addObservation, addSummary, addUserPrompt, deduplicateFailedAttempt } from './memory-db.ts';
 import { parseTranscript, extractUserMessages, getLastAssistantMessage } from './transcript-parser.ts';
 import { extractObservationsFromEntries } from './observation-extractor.ts';
-import { getProjectRoot } from './config.ts';
+import { getProjectRoot, getConfig } from './config.ts';
 
 /**
  * Auto-detect the Claude Code project transcript directory.
@@ -22,12 +22,13 @@ import { getProjectRoot } from './config.ts';
 function findTranscriptDir(): string {
   const home = process.env.HOME ?? '~';
   const projectRoot = getProjectRoot();
+  const claudeDirName = getConfig().conventions?.claudeDirName ?? '.claude';
   // Claude Code escapes the path by replacing / with -
   const escapedPath = projectRoot.replace(/\//g, '-');
-  const candidate = resolve(home, '.claude/projects', escapedPath);
+  const candidate = resolve(home, `${claudeDirName}/projects`, escapedPath);
   if (existsSync(candidate)) return candidate;
-  // Fallback: scan .claude/projects/ for directories matching the project name
-  const projectsDir = resolve(home, '.claude/projects');
+  // Fallback: scan projects dir for directories matching the project name
+  const projectsDir = resolve(home, `${claudeDirName}/projects`);
   if (existsSync(projectsDir)) {
     try {
       const entries = readdirSync(projectsDir);

package/src/cli.ts

@@ -43,6 +43,11 @@ async function main(): Promise<void> {
       await runInstallHooks();
       break;
     }
+    case 'install-commands': {
+      const { runInstallCommands } = await import('./commands/install-commands.ts');
+      await runInstallCommands();
+      break;
+    }
     case 'validate-config': {
       const { runValidateConfig } = await import('./commands/doctor.ts');
       await runValidateConfig();
@@ -77,6 +82,7 @@ Commands:
   init              Set up Massu AI in your project (one command, full setup)
   doctor            Check installation health
   install-hooks     Install/update Claude Code hooks
+  install-commands  Install/update slash commands
   validate-config   Validate massu.config.yaml
 
 Options:

package/src/cloud-sync.ts

@@ -166,26 +166,22 @@ export async function syncToCloud(
  * Successfully synced items are removed; failed items get their retry count incremented.
  */
 export async function drainSyncQueue(db: Database.Database): Promise<void> {
-  try {
-    const config = getConfig();
-    if (!config.cloud?.enabled || !config.cloud?.apiKey) return;
-
-    const pending = dequeuePendingSync(db, 10);
-    for (const item of pending) {
-      try {
-        const payload = JSON.parse(item.payload) as SyncPayload;
-        const result = await syncToCloud(db, payload);
-        if (result.success) {
-          removePendingSync(db, item.id);
-        } else {
-          incrementRetryCount(db, item.id, result.error ?? 'Unknown error');
-        }
-      } catch (err) {
-        incrementRetryCount(db, item.id, err instanceof Error ? err.message : String(err));
+  const config = getConfig();
+  if (!config.cloud?.enabled || !config.cloud?.apiKey) return;
+
+  const pending = dequeuePendingSync(db, 10);
+  for (const item of pending) {
+    try {
+      const payload = JSON.parse(item.payload) as SyncPayload;
+      const result = await syncToCloud(db, payload);
+      if (result.success) {
+        removePendingSync(db, item.id);
+      } else {
+        incrementRetryCount(db, item.id, result.error ?? 'Unknown error');
       }
+    } catch (err) {
+      incrementRetryCount(db, item.id, err instanceof Error ? err.message : String(err));
     }
-  } catch (err) {
-    process.stderr.write(`massu: drainSyncQueue failed: ${err instanceof Error ? err.message : String(err)}\n`);
   }
 }