@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/cli/utils/viewer.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import chalk from "chalk";
+import { AnalyticsService } from "../../features/analytics/core/analytics-service.js";
+async function displayAnalyticsDashboard(projectPath) {
+  const service = new AnalyticsService(projectPath || process.cwd());
+  try {
+    await service.syncFromTaskStore();
+    const state = await service.getDashboardState();
+    const { metrics, recentTasks, teamMetrics } = state;
+    console.clear();
+    console.log(chalk.bold.cyan("\nStackMemory Analytics Dashboard\n"));
+    console.log(chalk.gray("\u2500".repeat(50)));
+    console.log(chalk.bold.white("\nKey Metrics\n"));
+    const metricsDisplay = [
+      ["Total Tasks", metrics.totalTasks],
+      ["Completed", chalk.green(metrics.completedTasks)],
+      ["In Progress", chalk.yellow(metrics.inProgressTasks)],
+      ["Blocked", chalk.red(metrics.blockedTasks)],
+      ["Completion Rate", `${metrics.completionRate.toFixed(1)}%`],
+      ["Avg Time to Complete", formatDuration(metrics.averageTimeToComplete)],
+      ["Effort Accuracy", `${metrics.effortAccuracy.toFixed(0)}%`],
+      ["Blocking Issues", metrics.blockingIssuesCount]
+    ];
+    metricsDisplay.forEach(([label, value]) => {
+      console.log(`  ${chalk.gray(String(label).padEnd(20))} ${value}`);
+    });
+    if (metrics.velocityTrend.length > 0) {
+      console.log(chalk.bold.white("\n\u{1F4C9} Velocity Trend (last 7 days)\n"));
+      const maxVelocity = Math.max(...metrics.velocityTrend);
+      const scale = maxVelocity > 0 ? 10 / maxVelocity : 1;
+      metrics.velocityTrend.slice(-7).forEach((velocity, i) => {
+        const bar = "\u2588".repeat(Math.round(velocity * scale));
+        const day = /* @__PURE__ */ new Date();
+        day.setDate(day.getDate() - (6 - i));
+        console.log(
+          `  ${day.toLocaleDateString("en", { weekday: "short" }).padEnd(4)} ${bar} ${velocity}`
+        );
+      });
+    }
+    if (recentTasks.length > 0) {
+      console.log(chalk.bold.white("\nRecent Tasks\n"));
+      recentTasks.slice(0, 5).forEach((task) => {
+        const statePrefix = {
+          completed: "[DONE]",
+          in_progress: "[PROG]",
+          blocked: "[BLCK]",
+          todo: "[TODO]"
+        }[task.state];
+        const priorityColor = {
+          urgent: chalk.red,
+          high: chalk.yellow,
+          medium: chalk.blue,
+          low: chalk.gray
+        }[task.priority];
+        console.log(
+          `  ${statePrefix} ${priorityColor(`[${task.priority.toUpperCase()}]`)} ${task.title.slice(0, 50)}`
+        );
+      });
+    }
+    if (teamMetrics.length > 0) {
+      console.log(chalk.bold.white("\n\u{1F465} Team Performance\n"));
+      teamMetrics.slice(0, 3).forEach((member) => {
+        const bar = "\u2593".repeat(Math.round(member.contributionPercentage / 10));
+        console.log(
+          `  ${member.userName.padEnd(15)} ${bar} ${member.contributionPercentage.toFixed(0)}% (${member.individualMetrics.completedTasks} tasks)`
+        );
+      });
+    }
+    console.log(chalk.gray("\n" + "\u2500".repeat(50)));
+    console.log(
+      chalk.gray(`Last updated: ${state.lastUpdated.toLocaleString()}`)
+    );
+    console.log();
+  } finally {
+    service.close();
+  }
+}
+function formatDuration(ms) {
+  if (ms === 0) return "N/A";
+  const hours = Math.floor(ms / 36e5);
+  const days = Math.floor(hours / 24);
+  if (days > 0) return `${days}d ${hours % 24}h`;
+  if (hours > 0) return `${hours}h`;
+  return "<1h";
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  displayAnalyticsDashboard().catch(console.error);
+}
+export {
+  displayAnalyticsDashboard
+};
+//# sourceMappingURL=viewer.js.map

package/dist/src/cli/utils/viewer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/cli/utils/viewer.ts"],
+  "sourcesContent": ["#!/usr/bin/env node\nimport chalk from 'chalk';\nimport { AnalyticsService } from '../../features/analytics/core/analytics-service.js';\n\nexport async function displayAnalyticsDashboard(\n  projectPath?: string\n): Promise<void> {\n  const service = new AnalyticsService(projectPath || process.cwd());\n\n  try {\n    // Sync from task store before displaying\n    await service.syncFromTaskStore();\n    const state = await service.getDashboardState();\n    const { metrics, recentTasks, teamMetrics } = state;\n\n    console.clear();\n    console.log(chalk.bold.cyan('\\nStackMemory Analytics Dashboard\\n'));\n    console.log(chalk.gray('\u2500'.repeat(50)));\n\n    // Key Metrics\n    console.log(chalk.bold.white('\\nKey Metrics\\n'));\n\n    const metricsDisplay = [\n      ['Total Tasks', metrics.totalTasks],\n      ['Completed', chalk.green(metrics.completedTasks)],\n      ['In Progress', chalk.yellow(metrics.inProgressTasks)],\n      ['Blocked', chalk.red(metrics.blockedTasks)],\n      ['Completion Rate', `${metrics.completionRate.toFixed(1)}%`],\n      ['Avg Time to Complete', formatDuration(metrics.averageTimeToComplete)],\n      ['Effort Accuracy', `${metrics.effortAccuracy.toFixed(0)}%`],\n      ['Blocking Issues', metrics.blockingIssuesCount],\n    ];\n\n    metricsDisplay.forEach(([label, value]) => {\n      console.log(`  ${chalk.gray(String(label).padEnd(20))} ${value}`);\n    });\n\n    // Velocity Trend (mini chart)\n    if (metrics.velocityTrend.length > 0) {\n      console.log(chalk.bold.white('\\n\uD83D\uDCC9 Velocity Trend (last 7 days)\\n'));\n      const maxVelocity = Math.max(...metrics.velocityTrend);\n      const scale = maxVelocity > 0 ? 10 / maxVelocity : 1;\n\n      metrics.velocityTrend.slice(-7).forEach((velocity, i) => {\n        const bar = '\u2588'.repeat(Math.round(velocity * scale));\n        const day = new Date();\n        day.setDate(day.getDate() - (6 - i));\n        console.log(\n          `  ${day.toLocaleDateString('en', { weekday: 'short' }).padEnd(4)} ${bar} ${velocity}`\n        );\n      });\n    }\n\n    // Recent Tasks\n    if (recentTasks.length > 0) {\n      console.log(chalk.bold.white('\\nRecent Tasks\\n'));\n      recentTasks.slice(0, 5).forEach((task) => {\n        const statePrefix = {\n          completed: '[DONE]',\n          in_progress: '[PROG]',\n          blocked: '[BLCK]',\n          todo: '[TODO]',\n        }[task.state];\n\n        const priorityColor = {\n          urgent: chalk.red,\n          high: chalk.yellow,\n          medium: chalk.blue,\n          low: chalk.gray,\n        }[task.priority];\n\n        console.log(\n          `  ${statePrefix} ${priorityColor(`[${task.priority.toUpperCase()}]`)} ${task.title.slice(0, 50)}`\n        );\n      });\n    }\n\n    // Team Performance\n    if (teamMetrics.length > 0) {\n      console.log(chalk.bold.white('\\n\uD83D\uDC65 Team Performance\\n'));\n      teamMetrics.slice(0, 3).forEach((member) => {\n        const bar = '\u2593'.repeat(Math.round(member.contributionPercentage / 10));\n        console.log(\n          `  ${member.userName.padEnd(15)} ${bar} ${member.contributionPercentage.toFixed(0)}% (${member.individualMetrics.completedTasks} tasks)`\n        );\n      });\n    }\n\n    console.log(chalk.gray('\\n' + '\u2500'.repeat(50)));\n    console.log(\n      chalk.gray(`Last updated: ${state.lastUpdated.toLocaleString()}`)\n    );\n    console.log();\n  } finally {\n    service.close();\n  }\n}\n\nfunction formatDuration(ms: number): string {\n  if (ms === 0) return 'N/A';\n  const hours = Math.floor(ms / 3600000);\n  const days = Math.floor(hours / 24);\n  if (days > 0) return `${days}d ${hours % 24}h`;\n  if (hours > 0) return `${hours}h`;\n  return '<1h';\n}\n\n// Allow direct execution\nif (import.meta.url === `file://${process.argv[1]}`) {\n  displayAnalyticsDashboard().catch(console.error);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/config/config-manager.js

@@ -0,0 +1,398 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import * as fs from "fs";
+import * as path from "path";
+import * as yaml from "js-yaml";
+import {
+  DEFAULT_CONFIG,
+  PRESET_PROFILES
+} from "./types.js";
+class ConfigManager {
+  static instance = null;
+  config;
+  configPath;
+  fileWatcher;
+  onChangeCallbacks = [];
+  constructor(configPath) {
+    this.configPath = configPath || path.join(process.cwd(), ".stackmemory", "config.yaml");
+    this.config = this.loadConfig();
+  }
+  /**
+   * Get singleton instance of ConfigManager
+   */
+  static getInstance(configPath) {
+    if (!ConfigManager.instance) {
+      ConfigManager.instance = new ConfigManager(configPath);
+    }
+    return ConfigManager.instance;
+  }
+  /**
+   * Load configuration from file or use defaults
+   */
+  loadConfig() {
+    try {
+      if (fs.existsSync(this.configPath)) {
+        const content = fs.readFileSync(this.configPath, "utf-8");
+        const loaded = yaml.load(content);
+        return this.mergeWithDefaults(loaded);
+      }
+    } catch (error) {
+      console.warn(`Failed to load config from ${this.configPath}:`, error);
+    }
+    return this.mergeWithDefaults({});
+  }
+  /**
+   * Merge loaded config with defaults
+   */
+  mergeWithDefaults(loaded) {
+    const config = {
+      version: loaded.version || DEFAULT_CONFIG.version,
+      profile: loaded.profile,
+      scoring: {
+        weights: {
+          ...DEFAULT_CONFIG.scoring.weights,
+          ...loaded.scoring?.weights
+        },
+        tool_scores: {
+          ...DEFAULT_CONFIG.scoring.tool_scores,
+          ...loaded.scoring?.tool_scores
+        }
+      },
+      retention: {
+        local: {
+          ...DEFAULT_CONFIG.retention.local,
+          ...loaded.retention?.local
+        },
+        remote: {
+          ...DEFAULT_CONFIG.retention.remote,
+          ...loaded.retention?.remote
+        },
+        generational_gc: {
+          ...DEFAULT_CONFIG.retention.generational_gc,
+          ...loaded.retention?.generational_gc
+        }
+      },
+      performance: { ...DEFAULT_CONFIG.performance, ...loaded.performance },
+      profiles: { ...PRESET_PROFILES, ...loaded.profiles }
+    };
+    if (config.profile && config.profiles?.[config.profile]) {
+      this.applyProfile(config, config.profiles[config.profile]);
+    }
+    return config;
+  }
+  /**
+   * Apply a profile to the configuration
+   */
+  applyProfile(config, profile) {
+    if (profile.scoring) {
+      if (profile.scoring.weights) {
+        config.scoring.weights = {
+          ...config.scoring.weights,
+          ...profile.scoring.weights
+        };
+      }
+      if (profile.scoring.tool_scores) {
+        config.scoring.tool_scores = {
+          ...config.scoring.tool_scores,
+          ...profile.scoring.tool_scores
+        };
+      }
+    }
+    if (profile.retention) {
+      if (profile.retention.local) {
+        config.retention.local = {
+          ...config.retention.local,
+          ...profile.retention.local
+        };
+      }
+      if (profile.retention.remote) {
+        config.retention.remote = {
+          ...config.retention.remote,
+          ...profile.retention.remote
+        };
+      }
+      if (profile.retention.generational_gc) {
+        config.retention.generational_gc = {
+          ...config.retention.generational_gc,
+          ...profile.retention.generational_gc
+        };
+      }
+    }
+    if (profile.performance) {
+      config.performance = { ...config.performance, ...profile.performance };
+    }
+  }
+  /**
+   * Validate configuration
+   */
+  validate() {
+    const result = {
+      valid: true,
+      errors: [],
+      warnings: [],
+      suggestions: []
+    };
+    const weights = this.config.scoring.weights;
+    const weightSum = weights.base + weights.impact + weights.persistence + weights.reference;
+    if (Math.abs(weightSum - 1) > 1e-3) {
+      result.errors.push(
+        `Weights must sum to 1.0 (current: ${weightSum.toFixed(3)})`
+      );
+      result.valid = false;
+    }
+    Object.entries(weights).forEach(([key, value]) => {
+      if (value < 0 || value > 1) {
+        result.errors.push(
+          `Weight ${key} must be between 0 and 1 (current: ${value})`
+        );
+        result.valid = false;
+      }
+    });
+    Object.entries(this.config.scoring.tool_scores).forEach(([tool, score]) => {
+      if (score !== void 0 && (score < 0 || score > 1)) {
+        result.errors.push(
+          `Tool score for ${tool} must be between 0 and 1 (current: ${score})`
+        );
+        result.valid = false;
+      }
+    });
+    const youngMs = this.parseDuration(this.config.retention.local.young);
+    const matureMs = this.parseDuration(this.config.retention.local.mature);
+    const oldMs = this.parseDuration(this.config.retention.local.old);
+    if (youngMs >= matureMs) {
+      result.errors.push(
+        "Young retention period must be less than mature period"
+      );
+      result.valid = false;
+    }
+    if (matureMs >= oldMs) {
+      result.errors.push(
+        "Mature retention period must be less than old period"
+      );
+      result.valid = false;
+    }
+    const maxSize = this.parseSize(this.config.retention.local.max_size);
+    const availableSpace = this.getAvailableDiskSpace();
+    if (availableSpace > 0 && maxSize > availableSpace) {
+      result.warnings.push(
+        `max_size (${this.config.retention.local.max_size}) exceeds available disk space`
+      );
+    }
+    if (this.config.performance.retrieval_timeout_ms < 100) {
+      result.warnings.push(
+        "retrieval_timeout_ms < 100ms may be too aggressive"
+      );
+    }
+    if (this.config.performance.max_stack_depth > 1e4) {
+      result.warnings.push("max_stack_depth > 10000 may impact performance");
+    }
+    if (!this.config.profile) {
+      result.suggestions.push("Consider using a profile for your use case");
+    }
+    if (this.config?.scoring?.tool_scores?.search && this.config.scoring.tool_scores.search < 0.5) {
+      result.suggestions.push(
+        "Search tool score seems low - consider increasing for better discovery"
+      );
+    }
+    return result;
+  }
+  /**
+   * Parse duration string to milliseconds
+   */
+  parseDuration(duration) {
+    const match = duration.match(/^(\d+)([hdwm])$/);
+    if (!match) return 0;
+    const value = parseInt(match[1]);
+    const unit = match[2];
+    const multipliers = {
+      h: 36e5,
+      // hours
+      d: 864e5,
+      // days
+      w: 6048e5,
+      // weeks
+      m: 2592e6
+      // months (30 days)
+    };
+    return value * (multipliers[unit] || 0);
+  }
+  /**
+   * Parse size string to bytes
+   */
+  parseSize(size) {
+    const match = size.match(/^(\d+(?:\.\d+)?)([KMGT]B)?$/i);
+    if (!match) return 0;
+    const value = parseFloat(match[1]);
+    const unit = match[2]?.toUpperCase() || "B";
+    const multipliers = {
+      B: 1,
+      KB: 1024,
+      MB: 1024 * 1024,
+      GB: 1024 * 1024 * 1024,
+      TB: 1024 * 1024 * 1024 * 1024
+    };
+    return value * (multipliers[unit] || 1);
+  }
+  /**
+   * Get available disk space (simplified)
+   */
+  getAvailableDiskSpace() {
+    return 0;
+  }
+  /**
+   * Save configuration to file
+   */
+  save() {
+    const dir = path.dirname(this.configPath);
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+    const content = yaml.dump(this.config, {
+      indent: 2,
+      lineWidth: 120,
+      noRefs: true
+    });
+    fs.writeFileSync(this.configPath, content, "utf-8");
+  }
+  /**
+   * Get current configuration
+   */
+  getConfig() {
+    return { ...this.config };
+  }
+  /**
+   * Get a specific configuration value by path
+   * Example: config.get('project.id') returns config.project.id
+   */
+  get(path2) {
+    const keys = path2.split(".");
+    let value = this.config;
+    for (const key of keys) {
+      if (value && typeof value === "object" && key in value) {
+        value = value[key];
+      } else {
+        return void 0;
+      }
+    }
+    return value;
+  }
+  /**
+   * Set active profile
+   */
+  setProfile(profileName) {
+    const allProfiles = { ...PRESET_PROFILES, ...this.config.profiles };
+    if (!allProfiles[profileName]) {
+      return false;
+    }
+    this.config.profile = profileName;
+    this.applyProfile(this.config, allProfiles[profileName]);
+    this.notifyChange();
+    return true;
+  }
+  /**
+   * Update weights
+   */
+  updateWeights(weights) {
+    this.config.scoring.weights = {
+      ...this.config.scoring.weights,
+      ...weights
+    };
+    this.notifyChange();
+  }
+  /**
+   * Update tool scores
+   */
+  updateToolScores(scores) {
+    this.config.scoring.tool_scores = {
+      ...this.config.scoring.tool_scores,
+      ...scores
+    };
+    this.notifyChange();
+  }
+  /**
+   * Enable hot reload
+   */
+  enableHotReload() {
+    if (this.fileWatcher) return;
+    if (fs.existsSync(this.configPath)) {
+      this.fileWatcher = fs.watch(this.configPath, (eventType) => {
+        if (eventType === "change") {
+          const newConfig = this.loadConfig();
+          const validation = this.validate();
+          if (validation.valid) {
+            this.config = newConfig;
+            this.notifyChange();
+            console.log("Configuration reloaded");
+          } else {
+            console.error(
+              "Invalid configuration, keeping previous:",
+              validation.errors
+            );
+          }
+        }
+      });
+    }
+  }
+  /**
+   * Disable hot reload
+   */
+  disableHotReload() {
+    if (this.fileWatcher) {
+      this.fileWatcher.close();
+      this.fileWatcher = void 0;
+    }
+  }
+  /**
+   * Register change callback
+   */
+  onChange(callback) {
+    this.onChangeCallbacks.push(callback);
+  }
+  /**
+   * Notify all change callbacks
+   */
+  notifyChange() {
+    const config = this.getConfig();
+    this.onChangeCallbacks.forEach((cb) => cb(config));
+  }
+  /**
+   * Calculate importance score for a tool
+   */
+  calculateScore(tool, additionalFactors) {
+    const baseScore = this.config.scoring.tool_scores[tool] || 0.5;
+    const weights = this.config.scoring.weights;
+    let score = baseScore * weights.base;
+    if (additionalFactors) {
+      if (additionalFactors.filesAffected !== void 0) {
+        const impactMultiplier = Math.min(
+          additionalFactors.filesAffected / 10,
+          1
+        );
+        score += impactMultiplier * weights.impact;
+      }
+      if (additionalFactors.isPermanent) {
+        score += 0.2 * weights.persistence;
+      }
+      if (additionalFactors.referenceCount !== void 0) {
+        const refMultiplier = Math.min(
+          additionalFactors.referenceCount / 100,
+          1
+        );
+        score += refMultiplier * weights.reference;
+      }
+    }
+    return Math.min(Math.max(score, 0), 1);
+  }
+  /**
+   * Get available profiles
+   */
+  getProfiles() {
+    return { ...PRESET_PROFILES, ...this.config.profiles };
+  }
+}
+export {
+  ConfigManager
+};
+//# sourceMappingURL=config-manager.js.map

package/dist/src/core/config/config-manager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/config/config-manager.ts"],
+  "sourcesContent": ["/**\n * Configuration Manager for StackMemory\n * Handles loading, validation, and management of configuration\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport * as yaml from 'js-yaml';\nimport {\n  StackMemoryConfig,\n  ProfileConfig,\n  DEFAULT_CONFIG,\n  PRESET_PROFILES,\n  ScoringWeights,\n} from './types.js';\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n  suggestions: string[];\n}\n\nexport class ConfigManager {\n  private static instance: ConfigManager | null = null;\n  private config: StackMemoryConfig;\n  private configPath: string;\n  private fileWatcher?: fs.FSWatcher;\n  private onChangeCallbacks: Array<(config: StackMemoryConfig) => void> = [];\n\n  constructor(configPath?: string) {\n    this.configPath =\n      configPath || path.join(process.cwd(), '.stackmemory', 'config.yaml');\n    this.config = this.loadConfig();\n  }\n\n  /**\n   * Get singleton instance of ConfigManager\n   */\n  public static getInstance(configPath?: string): ConfigManager {\n    if (!ConfigManager.instance) {\n      ConfigManager.instance = new ConfigManager(configPath);\n    }\n    return ConfigManager.instance;\n  }\n\n  /**\n   * Load configuration from file or use defaults\n   */\n  private loadConfig(): StackMemoryConfig {\n    try {\n      if (fs.existsSync(this.configPath)) {\n        const content = fs.readFileSync(this.configPath, 'utf-8');\n        const loaded = yaml.load(content) as Partial<StackMemoryConfig>;\n        return this.mergeWithDefaults(loaded);\n      }\n    } catch (error: unknown) {\n      console.warn(`Failed to load config from ${this.configPath}:`, error);\n    }\n    // Deep clone to prevent mutation of DEFAULT_CONFIG\n    return this.mergeWithDefaults({});\n  }\n\n  /**\n   * Merge loaded config with defaults\n   */\n  private mergeWithDefaults(\n    loaded: Partial<StackMemoryConfig>\n  ): StackMemoryConfig {\n    const config: StackMemoryConfig = {\n      version: loaded.version || DEFAULT_CONFIG.version,\n      profile: loaded.profile,\n      scoring: {\n        weights: {\n          ...DEFAULT_CONFIG.scoring.weights,\n          ...loaded.scoring?.weights,\n        },\n        tool_scores: {\n          ...DEFAULT_CONFIG.scoring.tool_scores,\n          ...loaded.scoring?.tool_scores,\n        },\n      },\n      retention: {\n        local: {\n          ...DEFAULT_CONFIG.retention.local,\n          ...loaded.retention?.local,\n        },\n        remote: {\n          ...DEFAULT_CONFIG.retention.remote,\n          ...loaded.retention?.remote,\n        },\n        generational_gc: {\n          ...DEFAULT_CONFIG.retention.generational_gc,\n          ...loaded.retention?.generational_gc,\n        },\n      },\n      performance: { ...DEFAULT_CONFIG.performance, ...loaded.performance },\n      profiles: { ...PRESET_PROFILES, ...loaded.profiles },\n    };\n\n    // Apply active profile if specified\n    if (config.profile && config.profiles?.[config.profile]) {\n      this.applyProfile(config, config.profiles[config.profile]);\n    }\n\n    return config;\n  }\n\n  /**\n   * Apply a profile to the configuration\n   */\n  private applyProfile(\n    config: StackMemoryConfig,\n    profile: ProfileConfig\n  ): void {\n    if (profile.scoring) {\n      if (profile.scoring.weights) {\n        config.scoring.weights = {\n          ...config.scoring.weights,\n          ...profile.scoring.weights,\n        };\n      }\n      if (profile.scoring.tool_scores) {\n        config.scoring.tool_scores = {\n          ...config.scoring.tool_scores,\n          ...profile.scoring.tool_scores,\n        };\n      }\n    }\n\n    if (profile.retention) {\n      if (profile.retention.local) {\n        config.retention.local = {\n          ...config.retention.local,\n          ...profile.retention.local,\n        };\n      }\n      if (profile.retention.remote) {\n        config.retention.remote = {\n          ...config.retention.remote,\n          ...profile.retention.remote,\n        };\n      }\n      if (profile.retention.generational_gc) {\n        config.retention.generational_gc = {\n          ...config.retention.generational_gc,\n          ...profile.retention.generational_gc,\n        };\n      }\n    }\n\n    if (profile.performance) {\n      config.performance = { ...config.performance, ...profile.performance };\n    }\n  }\n\n  /**\n   * Validate configuration\n   */\n  validate(): ValidationResult {\n    const result: ValidationResult = {\n      valid: true,\n      errors: [],\n      warnings: [],\n      suggestions: [],\n    };\n\n    // Validate weights sum to 1.0\n    const weights = this.config.scoring.weights;\n    const weightSum =\n      weights.base + weights.impact + weights.persistence + weights.reference;\n    if (Math.abs(weightSum - 1.0) > 0.001) {\n      result.errors.push(\n        `Weights must sum to 1.0 (current: ${weightSum.toFixed(3)})`\n      );\n      result.valid = false;\n    }\n\n    // Validate weight ranges\n    Object.entries(weights).forEach(([key, value]) => {\n      if (value < 0 || value > 1) {\n        result.errors.push(\n          `Weight ${key} must be between 0 and 1 (current: ${value})`\n        );\n        result.valid = false;\n      }\n    });\n\n    // Validate tool scores\n    Object.entries(this.config.scoring.tool_scores).forEach(([tool, score]) => {\n      if (score !== undefined && (score < 0 || score > 1)) {\n        result.errors.push(\n          `Tool score for ${tool} must be between 0 and 1 (current: ${score})`\n        );\n        result.valid = false;\n      }\n    });\n\n    // Validate retention periods are ordered\n    const youngMs = this.parseDuration(this.config.retention.local.young);\n    const matureMs = this.parseDuration(this.config.retention.local.mature);\n    const oldMs = this.parseDuration(this.config.retention.local.old);\n\n    if (youngMs >= matureMs) {\n      result.errors.push(\n        'Young retention period must be less than mature period'\n      );\n      result.valid = false;\n    }\n    if (matureMs >= oldMs) {\n      result.errors.push(\n        'Mature retention period must be less than old period'\n      );\n      result.valid = false;\n    }\n\n    // Validate max size\n    const maxSize = this.parseSize(this.config.retention.local.max_size);\n    const availableSpace = this.getAvailableDiskSpace();\n    if (availableSpace > 0 && maxSize > availableSpace) {\n      result.warnings.push(\n        `max_size (${this.config.retention.local.max_size}) exceeds available disk space`\n      );\n    }\n\n    // Performance warnings\n    if (this.config.performance.retrieval_timeout_ms < 100) {\n      result.warnings.push(\n        'retrieval_timeout_ms < 100ms may be too aggressive'\n      );\n    }\n\n    if (this.config.performance.max_stack_depth > 10000) {\n      result.warnings.push('max_stack_depth > 10000 may impact performance');\n    }\n\n    // Suggestions\n    if (!this.config.profile) {\n      result.suggestions.push('Consider using a profile for your use case');\n    }\n\n    if (\n      this.config?.scoring?.tool_scores?.search &&\n      this.config.scoring.tool_scores.search < 0.5\n    ) {\n      result.suggestions.push(\n        'Search tool score seems low - consider increasing for better discovery'\n      );\n    }\n\n    return result;\n  }\n\n  /**\n   * Parse duration string to milliseconds\n   */\n  private parseDuration(duration: string): number {\n    const match = duration.match(/^(\\d+)([hdwm])$/);\n    if (!match) return 0;\n\n    const value = parseInt(match[1]);\n    const unit = match[2];\n\n    const multipliers: Record<string, number> = {\n      h: 3600000, // hours\n      d: 86400000, // days\n      w: 604800000, // weeks\n      m: 2592000000, // months (30 days)\n    };\n\n    return value * (multipliers[unit] || 0);\n  }\n\n  /**\n   * Parse size string to bytes\n   */\n  private parseSize(size: string): number {\n    const match = size.match(/^(\\d+(?:\\.\\d+)?)([KMGT]B)?$/i);\n    if (!match) return 0;\n\n    const value = parseFloat(match[1]);\n    const unit = match[2]?.toUpperCase() || 'B';\n\n    const multipliers: Record<string, number> = {\n      B: 1,\n      KB: 1024,\n      MB: 1024 * 1024,\n      GB: 1024 * 1024 * 1024,\n      TB: 1024 * 1024 * 1024 * 1024,\n    };\n\n    return value * (multipliers[unit] || 1);\n  }\n\n  /**\n   * Get available disk space (simplified)\n   */\n  private getAvailableDiskSpace(): number {\n    // This would need platform-specific implementation\n    // For now, return 0 to skip validation\n    return 0;\n  }\n\n  /**\n   * Save configuration to file\n   */\n  save(): void {\n    const dir = path.dirname(this.configPath);\n    if (!fs.existsSync(dir)) {\n      fs.mkdirSync(dir, { recursive: true });\n    }\n\n    const content = yaml.dump(this.config, {\n      indent: 2,\n      lineWidth: 120,\n      noRefs: true,\n    });\n\n    fs.writeFileSync(this.configPath, content, 'utf-8');\n  }\n\n  /**\n   * Get current configuration\n   */\n  getConfig(): StackMemoryConfig {\n    return { ...this.config };\n  }\n\n  /**\n   * Get a specific configuration value by path\n   * Example: config.get('project.id') returns config.project.id\n   */\n  get(path: string): any {\n    const keys = path.split('.');\n    let value: any = this.config;\n    \n    for (const key of keys) {\n      if (value && typeof value === 'object' && key in value) {\n        value = value[key];\n      } else {\n        return undefined;\n      }\n    }\n    \n    return value;\n  }\n\n  /**\n   * Set active profile\n   */\n  setProfile(profileName: string): boolean {\n    const allProfiles = { ...PRESET_PROFILES, ...this.config.profiles };\n    if (!allProfiles[profileName]) {\n      return false;\n    }\n\n    // Apply the profile to current config\n    this.config.profile = profileName;\n    this.applyProfile(this.config, allProfiles[profileName]);\n    this.notifyChange();\n    return true;\n  }\n\n  /**\n   * Update weights\n   */\n  updateWeights(weights: Partial<ScoringWeights>): void {\n    this.config.scoring.weights = {\n      ...this.config.scoring.weights,\n      ...weights,\n    };\n    this.notifyChange();\n  }\n\n  /**\n   * Update tool scores\n   */\n  updateToolScores(scores: Record<string, number>): void {\n    this.config.scoring.tool_scores = {\n      ...this.config.scoring.tool_scores,\n      ...scores,\n    };\n    this.notifyChange();\n  }\n\n  /**\n   * Enable hot reload\n   */\n  enableHotReload(): void {\n    if (this.fileWatcher) return;\n\n    if (fs.existsSync(this.configPath)) {\n      this.fileWatcher = fs.watch(this.configPath, (eventType) => {\n        if (eventType === 'change') {\n          const newConfig = this.loadConfig();\n          const validation = this.validate();\n\n          if (validation.valid) {\n            this.config = newConfig;\n            this.notifyChange();\n            console.log('Configuration reloaded');\n          } else {\n            console.error(\n              'Invalid configuration, keeping previous:',\n              validation.errors\n            );\n          }\n        }\n      });\n    }\n  }\n\n  /**\n   * Disable hot reload\n   */\n  disableHotReload(): void {\n    if (this.fileWatcher) {\n      this.fileWatcher.close();\n      this.fileWatcher = undefined;\n    }\n  }\n\n  /**\n   * Register change callback\n   */\n  onChange(callback: (config: StackMemoryConfig) => void): void {\n    this.onChangeCallbacks.push(callback);\n  }\n\n  /**\n   * Notify all change callbacks\n   */\n  private notifyChange(): void {\n    const config = this.getConfig();\n    this.onChangeCallbacks.forEach((cb) => cb(config));\n  }\n\n  /**\n   * Calculate importance score for a tool\n   */\n  calculateScore(\n    tool: string,\n    additionalFactors?: {\n      filesAffected?: number;\n      isPermanent?: boolean;\n      referenceCount?: number;\n    }\n  ): number {\n    const baseScore = this.config.scoring.tool_scores[tool] || 0.5;\n    const weights = this.config.scoring.weights;\n\n    let score = baseScore * weights.base;\n\n    if (additionalFactors) {\n      // Impact multiplier (files affected)\n      if (additionalFactors.filesAffected !== undefined) {\n        const impactMultiplier = Math.min(\n          additionalFactors.filesAffected / 10,\n          1\n        );\n        score += impactMultiplier * weights.impact;\n      }\n\n      // Persistence bonus\n      if (additionalFactors.isPermanent) {\n        score += 0.2 * weights.persistence;\n      }\n\n      // Reference count\n      if (additionalFactors.referenceCount !== undefined) {\n        const refMultiplier = Math.min(\n          additionalFactors.referenceCount / 100,\n          1\n        );\n        score += refMultiplier * weights.reference;\n      }\n    }\n\n    return Math.min(Math.max(score, 0), 1); // Clamp to [0, 1]\n  }\n\n  /**\n   * Get available profiles\n   */\n  getProfiles(): Record<string, ProfileConfig> {\n    return { ...PRESET_PROFILES, ...this.config.profiles };\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["path"]
+}

package/dist/src/core/config/feature-flags.js

@@ -0,0 +1,76 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+function isLocalOnly() {
+  return process.env["STACKMEMORY_LOCAL"] === "true" || process.env["STACKMEMORY_LOCAL"] === "1" || process.env["LOCAL_ONLY"] === "true";
+}
+function isFeatureEnabled(feature) {
+  if (feature === "core") return true;
+  if (isLocalOnly()) return false;
+  switch (feature) {
+    case "linear":
+      return process.env["STACKMEMORY_LINEAR"] !== "false" && (!!process.env["LINEAR_API_KEY"] || !!process.env["LINEAR_OAUTH_TOKEN"]);
+    case "whatsapp":
+      return process.env["STACKMEMORY_WHATSAPP"] !== "false" && !!process.env["TWILIO_ACCOUNT_SID"];
+    case "chromadb":
+      return process.env["STACKMEMORY_CHROMADB"] === "true";
+    case "aiSummaries":
+      return process.env["STACKMEMORY_AI"] !== "false" && (!!process.env["ANTHROPIC_API_KEY"] || !!process.env["OPENAI_API_KEY"]);
+    case "skills":
+      return process.env["STACKMEMORY_SKILLS"] === "true" || process.env["STACKMEMORY_SKILLS"] === "1";
+    case "ralph":
+      return process.env["STACKMEMORY_RALPH"] !== "false";
+    case "greptile":
+      return process.env["STACKMEMORY_GREPTILE"] !== "false" && !!process.env["GREPTILE_API_KEY"];
+    default:
+      return false;
+  }
+}
+function getFeatureFlags() {
+  return {
+    core: true,
+    linear: isFeatureEnabled("linear"),
+    whatsapp: isFeatureEnabled("whatsapp"),
+    chromadb: isFeatureEnabled("chromadb"),
+    aiSummaries: isFeatureEnabled("aiSummaries"),
+    skills: isFeatureEnabled("skills"),
+    ralph: isFeatureEnabled("ralph"),
+    greptile: isFeatureEnabled("greptile")
+  };
+}
+function logFeatureStatus() {
+  const flags = getFeatureFlags();
+  const local = isLocalOnly();
+  console.log(
+    `StackMemory Mode: ${local ? "LOCAL (no external services)" : "FULL"}`
+  );
+  if (!local) {
+    console.log(
+      `  Linear: ${flags.linear ? "enabled" : "disabled (no API key)"}`
+    );
+    console.log(
+      `  WhatsApp: ${flags.whatsapp ? "enabled" : "disabled (no Twilio)"}`
+    );
+    console.log(`  ChromaDB: ${flags.chromadb ? "enabled" : "disabled"}`);
+    console.log(
+      `  AI Summaries: ${flags.aiSummaries ? "enabled" : "disabled (no API key)"}`
+    );
+    console.log(
+      `  Skills: ${flags.skills ? "enabled" : "disabled (set STACKMEMORY_SKILLS=true)"}`
+    );
+    console.log(
+      `  Ralph: ${flags.ralph ? "enabled" : "disabled (set STACKMEMORY_RALPH=true)"}`
+    );
+    console.log(
+      `  Greptile: ${flags.greptile ? "enabled" : "disabled (no GREPTILE_API_KEY)"}`
+    );
+  }
+}
+export {
+  getFeatureFlags,
+  isFeatureEnabled,
+  isLocalOnly,
+  logFeatureStatus
+};
+//# sourceMappingURL=feature-flags.js.map

package/dist/src/core/config/feature-flags.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/config/feature-flags.ts"],
+  "sourcesContent": ["/**\n * Feature Flags Configuration\n * Controls which external integrations are enabled\n *\n * Set STACKMEMORY_LOCAL=true to run without any external services\n */\n\nexport interface FeatureFlags {\n  // Core features (always available)\n  core: true;\n\n  // External integrations (can be disabled)\n  linear: boolean;\n  whatsapp: boolean;\n  chromadb: boolean;\n  aiSummaries: boolean;\n  skills: boolean;\n  ralph: boolean;\n  greptile: boolean;\n}\n\n/**\n * Check if running in local-only mode\n * When true, all external service integrations are disabled\n */\nexport function isLocalOnly(): boolean {\n  return (\n    process.env['STACKMEMORY_LOCAL'] === 'true' ||\n    process.env['STACKMEMORY_LOCAL'] === '1' ||\n    process.env['LOCAL_ONLY'] === 'true'\n  );\n}\n\n/**\n * Check if a specific feature is enabled\n */\nexport function isFeatureEnabled(feature: keyof FeatureFlags): boolean {\n  if (feature === 'core') return true;\n\n  // In local-only mode, external integrations are disabled\n  if (isLocalOnly()) return false;\n\n  // Check feature-specific env vars\n  switch (feature) {\n    case 'linear':\n      return (\n        process.env['STACKMEMORY_LINEAR'] !== 'false' &&\n        (!!process.env['LINEAR_API_KEY'] || !!process.env['LINEAR_OAUTH_TOKEN'])\n      );\n    case 'whatsapp':\n      return (\n        process.env['STACKMEMORY_WHATSAPP'] !== 'false' &&\n        !!process.env['TWILIO_ACCOUNT_SID']\n      );\n    case 'chromadb':\n      return process.env['STACKMEMORY_CHROMADB'] === 'true';\n    case 'aiSummaries':\n      return (\n        process.env['STACKMEMORY_AI'] !== 'false' &&\n        (!!process.env['ANTHROPIC_API_KEY'] || !!process.env['OPENAI_API_KEY'])\n      );\n    case 'skills':\n      // Skills enabled explicitly or when AI summaries available\n      return (\n        process.env['STACKMEMORY_SKILLS'] === 'true' ||\n        process.env['STACKMEMORY_SKILLS'] === '1'\n      );\n    case 'ralph':\n      // Ralph enabled by default in development (unless explicitly disabled)\n      // For npm package users, must be explicitly enabled\n      return process.env['STACKMEMORY_RALPH'] !== 'false';\n    case 'greptile':\n      // Greptile enabled when API key is available\n      return (\n        process.env['STACKMEMORY_GREPTILE'] !== 'false' &&\n        !!process.env['GREPTILE_API_KEY']\n      );\n    default:\n      return false;\n  }\n}\n\n/**\n * Get all feature flags\n */\nexport function getFeatureFlags(): FeatureFlags {\n  return {\n    core: true,\n    linear: isFeatureEnabled('linear'),\n    whatsapp: isFeatureEnabled('whatsapp'),\n    chromadb: isFeatureEnabled('chromadb'),\n    aiSummaries: isFeatureEnabled('aiSummaries'),\n    skills: isFeatureEnabled('skills'),\n    ralph: isFeatureEnabled('ralph'),\n    greptile: isFeatureEnabled('greptile'),\n  };\n}\n\n/**\n * Log feature flags status (for debugging)\n */\nexport function logFeatureStatus(): void {\n  const flags = getFeatureFlags();\n  const local = isLocalOnly();\n\n  console.log(\n    `StackMemory Mode: ${local ? 'LOCAL (no external services)' : 'FULL'}`\n  );\n  if (!local) {\n    console.log(\n      `  Linear: ${flags.linear ? 'enabled' : 'disabled (no API key)'}`\n    );\n    console.log(\n      `  WhatsApp: ${flags.whatsapp ? 'enabled' : 'disabled (no Twilio)'}`\n    );\n    console.log(`  ChromaDB: ${flags.chromadb ? 'enabled' : 'disabled'}`);\n    console.log(\n      `  AI Summaries: ${flags.aiSummaries ? 'enabled' : 'disabled (no API key)'}`\n    );\n    console.log(\n      `  Skills: ${flags.skills ? 'enabled' : 'disabled (set STACKMEMORY_SKILLS=true)'}`\n    );\n    console.log(\n      `  Ralph: ${flags.ralph ? 'enabled' : 'disabled (set STACKMEMORY_RALPH=true)'}`\n    );\n    console.log(\n      `  Greptile: ${flags.greptile ? 'enabled' : 'disabled (no GREPTILE_API_KEY)'}`\n    );\n  }\n}\n"],
+  "mappings": ";;;;AAyBO,SAAS,cAAuB;AACrC,SACE,QAAQ,IAAI,mBAAmB,MAAM,UACrC,QAAQ,IAAI,mBAAmB,MAAM,OACrC,QAAQ,IAAI,YAAY,MAAM;AAElC;AAKO,SAAS,iBAAiB,SAAsC;AACrE,MAAI,YAAY,OAAQ,QAAO;AAG/B,MAAI,YAAY,EAAG,QAAO;AAG1B,UAAQ,SAAS;AAAA,IACf,KAAK;AACH,aACE,QAAQ,IAAI,oBAAoB,MAAM,YACrC,CAAC,CAAC,QAAQ,IAAI,gBAAgB,KAAK,CAAC,CAAC,QAAQ,IAAI,oBAAoB;AAAA,IAE1E,KAAK;AACH,aACE,QAAQ,IAAI,sBAAsB,MAAM,WACxC,CAAC,CAAC,QAAQ,IAAI,oBAAoB;AAAA,IAEtC,KAAK;AACH,aAAO,QAAQ,IAAI,sBAAsB,MAAM;AAAA,IACjD,KAAK;AACH,aACE,QAAQ,IAAI,gBAAgB,MAAM,YACjC,CAAC,CAAC,QAAQ,IAAI,mBAAmB,KAAK,CAAC,CAAC,QAAQ,IAAI,gBAAgB;AAAA,IAEzE,KAAK;AAEH,aACE,QAAQ,IAAI,oBAAoB,MAAM,UACtC,QAAQ,IAAI,oBAAoB,MAAM;AAAA,IAE1C,KAAK;AAGH,aAAO,QAAQ,IAAI,mBAAmB,MAAM;AAAA,IAC9C,KAAK;AAEH,aACE,QAAQ,IAAI,sBAAsB,MAAM,WACxC,CAAC,CAAC,QAAQ,IAAI,kBAAkB;AAAA,IAEpC;AACE,aAAO;AAAA,EACX;AACF;AAKO,SAAS,kBAAgC;AAC9C,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,iBAAiB,QAAQ;AAAA,IACjC,UAAU,iBAAiB,UAAU;AAAA,IACrC,UAAU,iBAAiB,UAAU;AAAA,IACrC,aAAa,iBAAiB,aAAa;AAAA,IAC3C,QAAQ,iBAAiB,QAAQ;AAAA,IACjC,OAAO,iBAAiB,OAAO;AAAA,IAC/B,UAAU,iBAAiB,UAAU;AAAA,EACvC;AACF;AAKO,SAAS,mBAAyB;AACvC,QAAM,QAAQ,gBAAgB;AAC9B,QAAM,QAAQ,YAAY;AAE1B,UAAQ;AAAA,IACN,qBAAqB,QAAQ,iCAAiC,MAAM;AAAA,EACtE;AACA,MAAI,CAAC,OAAO;AACV,YAAQ;AAAA,MACN,aAAa,MAAM,SAAS,YAAY,uBAAuB;AAAA,IACjE;AACA,YAAQ;AAAA,MACN,eAAe,MAAM,WAAW,YAAY,sBAAsB;AAAA,IACpE;AACA,YAAQ,IAAI,eAAe,MAAM,WAAW,YAAY,UAAU,EAAE;AACpE,YAAQ;AAAA,MACN,mBAAmB,MAAM,cAAc,YAAY,uBAAuB;AAAA,IAC5E;AACA,YAAQ;AAAA,MACN,aAAa,MAAM,SAAS,YAAY,wCAAwC;AAAA,IAClF;AACA,YAAQ;AAAA,MACN,YAAY,MAAM,QAAQ,YAAY,uCAAuC;AAAA,IAC/E;AACA,YAAQ;AAAA,MACN,eAAe,MAAM,WAAW,YAAY,gCAAgC;AAAA,IAC9E;AAAA,EACF;AACF;",
+  "names": []
+}