@decibelsystems/tools 2.0.0

package/dist/license.js

@@ -0,0 +1,131 @@
+// ============================================================================
+// License Validator — server-side pro tier enforcement
+// ============================================================================
+// Validates DCBL-XXXX-XXXX-XXXX license keys against Supabase.
+// 24-hour in-memory cache with 72-hour offline grace period.
+// ============================================================================
+import { createHash } from 'crypto';
+import { log } from './config.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const KEY_PATTERN = /^DCBL-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/;
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const OFFLINE_GRACE_MS = 72 * 60 * 60 * 1000; // 72 hours
+// Supabase project for license verification (same as extension)
+const SUPABASE_URL = 'https://dfbwpgqvkijogxvxolqe.supabase.co';
+const SUPABASE_ANON_KEY = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImRmYndwZ3F2a2lqb2d4dnhvbHFlIiwicm9sZSI6ImFub24iLCJpYXQiOjE3Mzc1OTk2OTEsImV4cCI6MjA1MzE3NTY5MX0.AvAXbB6CswWCIKZ0zoVha9JEVFqZSMaV3VEhEEDVqxw';
+// ============================================================================
+// License Validator
+// ============================================================================
+export class LicenseValidator {
+    cache = new Map();
+    /**
+     * Validate a license key. Returns tier info.
+     * - Checks format first (fast reject)
+     * - Uses 24h in-memory cache
+     * - Falls back to Supabase REST API
+     * - Offline grace: trusts cache for 72h if Supabase unreachable
+     */
+    async validate(key) {
+        const normalizedKey = key.toUpperCase().trim();
+        // Format gate
+        if (!KEY_PATTERN.test(normalizedKey)) {
+            return { valid: false, tier: 'core' };
+        }
+        const cacheKey = this.hashKey(normalizedKey);
+        const cached = this.cache.get(cacheKey);
+        const now = Date.now();
+        // Check fresh cache (within 24h)
+        if (cached && now - cached.checkedAt < CACHE_TTL_MS) {
+            return { ...cached.result, cached: true };
+        }
+        // Remote validation
+        try {
+            const result = await this.remoteValidate(normalizedKey);
+            this.cache.set(cacheKey, { result, checkedAt: now });
+            return result;
+        }
+        catch {
+            // Offline: trust stale cache within 72h grace period
+            if (cached && now - cached.checkedAt < OFFLINE_GRACE_MS) {
+                log('License: Supabase unreachable, using cached result (offline grace)');
+                return { ...cached.result, cached: true, offline_grace: true };
+            }
+            // No cache and offline: reject (server-side is stricter than extension)
+            log('License: Supabase unreachable and no cached result — rejecting');
+            return { valid: false, tier: 'core' };
+        }
+    }
+    /**
+     * Pre-validate a key on startup (fire and forget).
+     */
+    async prevalidate(key) {
+        try {
+            const result = await this.validate(key);
+            if (result.valid) {
+                log(`License: Pre-validated key (tier: ${result.tier})`);
+            }
+            else {
+                log('License: Pre-validation failed — key is invalid or expired');
+            }
+        }
+        catch (err) {
+            log(`License: Pre-validation error: ${err}`);
+        }
+    }
+    /**
+     * Check if a key is currently valid (from cache only, no network).
+     */
+    getCachedResult(key) {
+        const cacheKey = this.hashKey(key.toUpperCase().trim());
+        const cached = this.cache.get(cacheKey);
+        if (!cached)
+            return null;
+        return cached.result;
+    }
+    hashKey(key) {
+        return createHash('sha256').update(key).digest('hex').substring(0, 16);
+    }
+    async remoteValidate(key) {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 5000);
+        try {
+            const res = await fetch(`${SUPABASE_URL}/rest/v1/licenses?key=eq.${encodeURIComponent(key)}&select=tier,active,expires_at`, {
+                headers: {
+                    'apikey': SUPABASE_ANON_KEY,
+                    'Authorization': `Bearer ${SUPABASE_ANON_KEY}`,
+                },
+                signal: controller.signal,
+            });
+            clearTimeout(timeout);
+            if (!res.ok) {
+                throw new Error(`Supabase returned ${res.status}`);
+            }
+            const rows = await res.json();
+            if (rows.length === 0) {
+                return { valid: false, tier: 'core' };
+            }
+            const row = rows[0];
+            const expired = row.expires_at && new Date(row.expires_at) < new Date();
+            return {
+                valid: row.active && !expired,
+                tier: row.active && !expired ? 'pro' : 'core',
+                expires_at: row.expires_at || undefined,
+            };
+        }
+        catch (err) {
+            clearTimeout(timeout);
+            throw err; // Let caller handle offline case
+        }
+    }
+}
+// Singleton for the daemon process
+let _instance = null;
+export function getLicenseValidator() {
+    if (!_instance) {
+        _instance = new LicenseValidator();
+    }
+    return _instance;
+}
+//# sourceMappingURL=license.js.map

package/dist/license.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license.js","sourceRoot":"","sources":["../src/license.ts"],"names":[],"mappings":"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"}

package/dist/projectPaths.d.ts

@@ -0,0 +1,27 @@
+export interface ProjectConfig {
+    projectId: string;
+    projectName?: string;
+    root: string;
+}
+/**
+ * Resolve project configuration from a project ID.
+ *
+ * Resolution strategy (via projectRegistry):
+ * 1. Check registry for exact ID or alias match
+ * 2. Check DECIBEL_PROJECT_ROOT env var
+ * 3. Check if projectId is a valid absolute path
+ * 4. Walk up from cwd looking for matching project
+ *
+ * @param projectId - The unique identifier for the project (ID, alias, or path)
+ * @returns The project configuration including root path
+ * @throws Error if the project cannot be resolved
+ */
+export declare function resolveProjectRoot(projectId: string): Promise<ProjectConfig>;
+/**
+ * List all known project IDs.
+ * Returns projects from the registry plus any discovered from cwd.
+ *
+ * @returns Array of discovered project IDs
+ */
+export declare function listProjectIds(): string[];
+//# sourceMappingURL=projectPaths.d.ts.map

package/dist/projectPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPaths.d.ts","sourceRoot":"","sources":["../src/projectPaths.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAkCD;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAYxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAezC"}

package/dist/projectPaths.js

@@ -0,0 +1,86 @@
+// ============================================================================
+// Project Path Resolution
+// ============================================================================
+// Helps MCP tools resolve project roots from project IDs.
+// Uses registry-based resolution with fallback to dynamic discovery.
+// ============================================================================
+import fs from 'fs';
+import path from 'path';
+import { resolveProject, listProjects } from './projectRegistry.js';
+// ============================================================================
+// Path Resolution Helpers
+// ============================================================================
+/**
+ * Walk up directory tree looking for a .decibel folder
+ */
+function findDecibelDir(start) {
+    let current = path.resolve(start);
+    while (true) {
+        const candidate = path.join(current, '.decibel');
+        if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) {
+            return current; // Return the project root, not the .decibel folder
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    return undefined;
+}
+/**
+ * Get the project name from a project root directory
+ */
+function getProjectNameFromDir(projectRoot) {
+    return path.basename(projectRoot);
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Resolve project configuration from a project ID.
+ *
+ * Resolution strategy (via projectRegistry):
+ * 1. Check registry for exact ID or alias match
+ * 2. Check DECIBEL_PROJECT_ROOT env var
+ * 3. Check if projectId is a valid absolute path
+ * 4. Walk up from cwd looking for matching project
+ *
+ * @param projectId - The unique identifier for the project (ID, alias, or path)
+ * @returns The project configuration including root path
+ * @throws Error if the project cannot be resolved
+ */
+export async function resolveProjectRoot(projectId) {
+    try {
+        const entry = resolveProject(projectId);
+        return {
+            projectId: entry.id,
+            projectName: entry.name || entry.id,
+            root: entry.path,
+        };
+    }
+    catch (err) {
+        // Re-throw with the helpful error message from registry
+        throw err;
+    }
+}
+/**
+ * List all known project IDs.
+ * Returns projects from the registry plus any discovered from cwd.
+ *
+ * @returns Array of discovered project IDs
+ */
+export function listProjectIds() {
+    const registeredProjects = listProjects();
+    const ids = registeredProjects.map((p) => p.id);
+    // Also check cwd for a local project not in registry
+    const currentProjectRoot = process.env.DECIBEL_PROJECT_ROOT || process.cwd();
+    const discoveredRoot = findDecibelDir(currentProjectRoot);
+    if (discoveredRoot) {
+        const localId = getProjectNameFromDir(discoveredRoot);
+        if (!ids.includes(localId)) {
+            ids.push(localId);
+        }
+    }
+    return ids;
+}
+//# sourceMappingURL=projectPaths.js.map

package/dist/projectPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectPaths.js","sourceRoot":"","sources":["../src/projectPaths.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAC/E,0DAA0D;AAC1D,qEAAqE;AACrE,+EAA+E;AAE/E,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,cAAc,EAAgB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYlF,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YACrE,OAAO,OAAO,CAAC,CAAC,mDAAmD;QACrE,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,WAAmB;IAChD,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,KAAK,GAAiB,cAAc,CAAC,SAAS,CAAC,CAAC;QACtD,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,EAAE;YACnB,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wDAAwD;QACxD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,kBAAkB,GAAG,YAAY,EAAE,CAAC;IAC1C,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAe,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE9D,qDAAqD;IACrD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC7E,MAAM,cAAc,GAAG,cAAc,CAAC,kBAAkB,CAAC,CAAC;IAC1D,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,OAAO,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;QACtD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/projectRegistry.d.ts

@@ -0,0 +1,97 @@
+export interface ProjectEntry {
+    /** Primary ID (usually directory name) */
+    id: string;
+    /** Human-readable name */
+    name?: string;
+    /** Absolute path to project root (contains .decibel/) */
+    path: string;
+    /** Optional aliases (e.g., "senken" -> "senken-trading-agent") */
+    aliases?: string[];
+    /** If true, this is the default project when none specified */
+    default?: boolean;
+}
+export interface ProjectRegistry {
+    version: 1;
+    projects: ProjectEntry[];
+}
+/**
+ * Resolve a project ID or alias to its filesystem path.
+ *
+ * Resolution order:
+ * 1. Check registry for exact ID match
+ * 2. Check registry for alias match
+ * 3. Check DECIBEL_PROJECT_ROOT env var (if ID matches basename)
+ * 4. Check if ID is an absolute path with .decibel
+ * 5. Walk up from cwd looking for .decibel (if ID matches discovered project)
+ *
+ * @param projectId - Project ID, alias, or path
+ * @returns Absolute path to the project root
+ * @throws Error if project cannot be resolved
+ */
+export declare function resolveProject(projectId: string): ProjectEntry;
+/**
+ * List all registered projects
+ */
+export declare function listProjects(): ProjectEntry[];
+/**
+ * Register a new project or update an existing one
+ */
+export declare function registerProject(entry: ProjectEntry): void;
+/**
+ * Remove a project from the registry
+ */
+export declare function unregisterProject(projectId: string): boolean;
+/**
+ * Add an alias to an existing project
+ */
+export declare function addProjectAlias(projectId: string, alias: string): void;
+/**
+ * Get the registry file path (for display/debugging)
+ */
+export declare function getRegistryFilePath(): string;
+/**
+ * Get the default project.
+ * Resolution order:
+ * 1. Project explicitly marked as default
+ * 2. DECIBEL_DEFAULT_PROJECT env var
+ * 3. If only one project registered, use it
+ * 4. Discover from cwd
+ *
+ * @returns The default project entry or undefined if none can be determined
+ */
+export declare function getDefaultProject(): ProjectEntry | undefined;
+/**
+ * Set a project as the default
+ */
+export declare function setDefaultProject(projectId: string): void;
+/**
+ * Normalize projectId from various input formats.
+ * Handles both camelCase (projectId) and snake_case (project_id).
+ * This allows tools to accept inputs from Claude regardless of which format it uses.
+ */
+export declare function normalizeProjectId(input: Record<string, unknown>): string | undefined;
+export interface ResolvedProjectPaths {
+    /** Project ID */
+    id: string;
+    /** Absolute path to project root */
+    projectPath: string;
+    /** Absolute path to .decibel folder */
+    decibelPath: string;
+    /** Helper to get a subdirectory under .decibel */
+    subPath: (...segments: string[]) => string;
+}
+/**
+ * Resolve project and return useful paths.
+ * This is the primary helper for tools to get project paths.
+ *
+ * @param projectId - Project ID, alias, or path (optional, uses default if not provided)
+ * @returns Resolved project paths
+ * @throws Error if project cannot be resolved
+ */
+export declare function resolveProjectPaths(projectId?: string): ResolvedProjectPaths;
+/**
+ * Validate that a write path is within the project's .decibel folder.
+ * Call this before any file write to prevent escaping project boundaries.
+ */
+export declare function validateWritePath(targetPath: string, resolved: ResolvedProjectPaths): void;
+//# sourceMappingURL=projectRegistry.d.ts.map

package/dist/projectRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectRegistry.d.ts","sourceRoot":"","sources":["../src/projectRegistry.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AA2FD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CA8E9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,YAAY,EAAE,CAG7C;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CA8BzD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAa5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CActE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,YAAY,GAAG,SAAS,CA8C5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAiBzD;AAMD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAErF;AAMD,MAAM,WAAW,oBAAoB;IACnC,iBAAiB;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,OAAO,EAAE,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,oBAAoB,CA6B5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAQ1F"}