monora-ai 2.1.0 → 2.1.4

package/dist/attribution.d.ts

@@ -30,7 +30,7 @@ export interface ProjectRegistration {
     company?: string;
     /** Your role (e.g., "ML Engineer", "DevOps", "CTO") */
     role?: string;
-    /** Work email for best practices updates (never shared) */
+    /** Work email for best practices updates (included in registration payload when enabled) */
     email?: string;
     /** How you found Monora (npm, pypi, github, blog, referral) */
     source?: string;
@@ -260,9 +260,9 @@ export declare function configureHttp(config: {
         eu?: string;
     };
     apiKeyEnv?: string;
-    timeoutMs?: number;
+    timeoutSec?: number;
     retryAttempts?: number;
-    backoffBaseMs?: number;
+    backoffBaseSec?: number;
 }): void;
 /**
  * Send a telemetry event (e.g., startup, shutdown, error).
@@ -305,4 +305,45 @@ export declare function setAuditMetadata(metadata: AuditMetadata): AuditMetadata
  * @returns AuditMetadata object or null.
  */
 export declare function getAuditMetadata(): AuditMetadata | null;
+/**
+ * Check if first-run registration prompt has been shown.
+ *
+ * @returns True if already prompted, false otherwise.
+ */
+export declare function hasShownFirstRunPrompt(): boolean;
+/**
+ * Check if user has registered (either via postinstall or programmatically).
+ *
+ * @returns True if registered, false otherwise.
+ */
+export declare function hasRegistration(): boolean;
+/**
+ * Prompt the user to register their project (interactive, optional).
+ *
+ * @param options - Optional context about the environment.
+ * @returns True if registration was completed, false otherwise.
+ */
+export declare function promptForRegistration(options?: {
+    environment?: string;
+    force?: boolean;
+    silent?: boolean;
+}): Promise<boolean>;
+/**
+ * Show first-run registration prompt if needed.
+ *
+ * This logs a one-time message suggesting the user run `npx monora init`
+ * to register their project for best practices updates. The message is
+ * only shown once per installation.
+ *
+ * @param options - Optional context about the environment.
+ * @returns True if prompt was shown, false if skipped.
+ */
+export declare function showFirstRunPromptIfNeeded(options?: {
+    environment?: string;
+    silent?: boolean;
+}): boolean;
+/**
+ * Reset the first-run prompt state (for testing).
+ */
+export declare function resetFirstRunPrompt(): void;
 //# sourceMappingURL=attribution.d.ts.map

package/dist/attribution.d.ts.map

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

package/dist/attribution.js

@@ -74,28 +74,35 @@ exports.configureHttp = configureHttp;
 exports.sendTelemetryEvent = sendTelemetryEvent;
 exports.setAuditMetadata = setAuditMetadata;
 exports.getAuditMetadata = getAuditMetadata;
+exports.hasShownFirstRunPrompt = hasShownFirstRunPrompt;
+exports.hasRegistration = hasRegistration;
+exports.promptForRegistration = promptForRegistration;
+exports.showFirstRunPromptIfNeeded = showFirstRunPromptIfNeeded;
+exports.resetFirstRunPrompt = resetFirstRunPrompt;
 const crypto = __importStar(require("crypto"));
 const fs = __importStar(require("fs"));
 const http = __importStar(require("http"));
 const https = __importStar(require("https"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
 // HTTP configuration (can be overridden via config or environment)
+// Note: Uses seconds (not milliseconds) for cross-SDK parity with Python
 const HTTP_CONFIG = {
     endpoints: {
         us: process.env.MONORA_ATTRIBUTION_ENDPOINT_US || null,
         eu: process.env.MONORA_ATTRIBUTION_ENDPOINT_EU || null,
     },
     apiKeyEnv: 'MONORA_ATTRIBUTION_KEY',
-    timeoutMs: 5000,
+    timeoutSec: 5,
     retryAttempts: 2,
-    backoffBaseMs: 500,
+    backoffBaseSec: 0.5,
 };
 const retryQueue = [];
 const MAX_RETRY_QUEUE_SIZE = 100;
 let retryTimer = null;
 // Get version from package.json
-let SDK_VERSION = '1.9.0';
+let SDK_VERSION = '2.1.4';
 try {
     const pkgPath = path.join(__dirname, '..', 'package.json');
     if (fs.existsSync(pkgPath)) {
@@ -111,6 +118,8 @@ const INSTALL_ID_PATH = path.join(os.homedir(), '.monora', 'install_id');
 const ATTRIBUTION_STATE_PATH = path.join(os.homedir(), '.monora', 'attribution.json');
 // Registration from postinstall script (collected during npm install)
 const POSTINSTALL_REGISTRATION_PATH = path.join(os.homedir(), '.monora', 'registration.json');
+// First-run prompt state
+const FIRST_RUN_PROMPT_PATH = path.join(os.homedir(), '.monora', 'first_run_prompt.json');
 // Callback registry
 const attributionCallbacks = [];
 // Global state
@@ -547,12 +556,12 @@ function configureHttp(config) {
     }
     if (config.apiKeyEnv)
         HTTP_CONFIG.apiKeyEnv = config.apiKeyEnv;
-    if (config.timeoutMs)
-        HTTP_CONFIG.timeoutMs = config.timeoutMs;
+    if (config.timeoutSec)
+        HTTP_CONFIG.timeoutSec = config.timeoutSec;
     if (config.retryAttempts)
         HTTP_CONFIG.retryAttempts = config.retryAttempts;
-    if (config.backoffBaseMs)
-        HTTP_CONFIG.backoffBaseMs = config.backoffBaseMs;
+    if (config.backoffBaseSec)
+        HTTP_CONFIG.backoffBaseSec = config.backoffBaseSec;
 }
 function getEndpoint(endpointType) {
     ensureStateLoaded();
@@ -571,7 +580,8 @@ async function makeRequest(url, data, timeout, retries) {
     const apiKey = getApiKey();
     if (!apiKey)
         return false;
-    const effectiveTimeout = timeout ?? HTTP_CONFIG.timeoutMs;
+    // Convert seconds to milliseconds for setTimeout
+    const effectiveTimeout = (timeout ?? HTTP_CONFIG.timeoutSec) * 1000;
     const effectiveRetries = retries ?? HTTP_CONFIG.retryAttempts;
     const payload = JSON.stringify({
         ...data,
@@ -628,13 +638,15 @@ async function makeRequest(url, data, timeout, retries) {
             if (success)
                 return true;
             if (attempt < effectiveRetries) {
-                const delay = HTTP_CONFIG.backoffBaseMs * Math.pow(2, attempt) + Math.random() * 100;
+                // Convert seconds to milliseconds for setTimeout
+                const delay = HTTP_CONFIG.backoffBaseSec * 1000 * Math.pow(2, attempt) + Math.random() * 100;
                 await new Promise((resolve) => setTimeout(resolve, delay));
             }
         }
         catch {
             if (attempt < effectiveRetries) {
-                const delay = HTTP_CONFIG.backoffBaseMs * Math.pow(2, attempt) + Math.random() * 100;
+                // Convert seconds to milliseconds for setTimeout
+                const delay = HTTP_CONFIG.backoffBaseSec * 1000 * Math.pow(2, attempt) + Math.random() * 100;
                 await new Promise((resolve) => setTimeout(resolve, delay));
             }
         }
@@ -699,6 +711,7 @@ async function processRetryQueue() {
 }
 /**
  * Send registration to Monora API (internal).
+ * Includes optional email if provided.
  */
 function sendRegistration(registration) {
     if (!sendDataEnabled)
@@ -798,3 +811,177 @@ function getAuditMetadata() {
     ensureStateLoaded();
     return auditMetadata;
 }
+/**
+ * Load the first-run prompt state from disk.
+ */
+function loadFirstRunPromptState() {
+    try {
+        if (!fs.existsSync(FIRST_RUN_PROMPT_PATH)) {
+            return null;
+        }
+        const raw = fs.readFileSync(FIRST_RUN_PROMPT_PATH, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Save the first-run prompt state to disk.
+ */
+function saveFirstRunPromptState(state) {
+    try {
+        const dir = path.dirname(FIRST_RUN_PROMPT_PATH);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        fs.writeFileSync(FIRST_RUN_PROMPT_PATH, JSON.stringify(state, null, 2));
+    }
+    catch {
+        // Silent fail - don't break user's app
+    }
+}
+/**
+ * Check if first-run registration prompt has been shown.
+ *
+ * @returns True if already prompted, false otherwise.
+ */
+function hasShownFirstRunPrompt() {
+    const state = loadFirstRunPromptState();
+    return state !== null && !!state.promptedAt;
+}
+/**
+ * Check if user has registered (either via postinstall or programmatically).
+ *
+ * @returns True if registered, false otherwise.
+ */
+function hasRegistration() {
+    ensureStateLoaded();
+    return currentRegistration !== null;
+}
+/**
+ * Prompt the user to register their project (interactive, optional).
+ *
+ * @param options - Optional context about the environment.
+ * @returns True if registration was completed, false otherwise.
+ */
+async function promptForRegistration(options) {
+    try {
+        if (!process.stdin.isTTY || !process.stdout.isTTY) {
+            return false;
+        }
+        if (!options?.force) {
+            if (options?.environment === 'production') {
+                return false;
+            }
+            if (process.env.CI ||
+                process.env.GITHUB_ACTIONS ||
+                process.env.GITLAB_CI ||
+                process.env.MONORA_SKIP_PROMPT) {
+                return false;
+            }
+            if (hasRegistration()) {
+                return false;
+            }
+        }
+        if (options?.silent) {
+            return false;
+        }
+        console.log('');
+        console.log('Monora SDK optional project registration');
+        console.log('This helps us improve the SDK and share best practices.');
+        console.log('Email is stored locally and only sent if telemetry is enabled.');
+        console.log('');
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        const ask = (question) => new Promise((resolve) => rl.question(question, (answer) => resolve(answer)));
+        try {
+            const confirm = (await ask('Register this project now? [y/N]: ')).trim().toLowerCase();
+            if (confirm !== 'y' && confirm !== 'yes') {
+                return false;
+            }
+            const company = (await ask('Company (optional): ')).trim() || undefined;
+            const role = (await ask('Role (optional): ')).trim() || undefined;
+            const email = (await ask('Work email (optional): ')).trim() || undefined;
+            const source = (await ask('How did you find Monora? (optional): ')).trim() || undefined;
+            const useCase = (await ask('Primary use case (optional): ')).trim() || undefined;
+            registerProject({
+                company,
+                role,
+                email,
+                source,
+                useCase,
+            });
+            return true;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Show first-run registration prompt if needed.
+ *
+ * This logs a one-time message suggesting the user run `npx monora init`
+ * to register their project for best practices updates. The message is
+ * only shown once per installation.
+ *
+ * @param options - Optional context about the environment.
+ * @returns True if prompt was shown, false if skipped.
+ */
+function showFirstRunPromptIfNeeded(options) {
+    // Skip in CI environments
+    if (process.env.CI ||
+        process.env.GITHUB_ACTIONS ||
+        process.env.GITLAB_CI ||
+        process.env.MONORA_SKIP_PROMPT) {
+        return false;
+    }
+    // Skip if already prompted
+    if (hasShownFirstRunPrompt()) {
+        return false;
+    }
+    // Skip if already registered
+    if (hasRegistration()) {
+        // Mark as prompted so we don't check again
+        saveFirstRunPromptState({
+            promptedAt: new Date().toISOString(),
+            sdkVersion: SDK_VERSION,
+            environment: options?.environment,
+        });
+        return false;
+    }
+    // Save state first to avoid showing multiple times in parallel inits
+    saveFirstRunPromptState({
+        promptedAt: new Date().toISOString(),
+        sdkVersion: SDK_VERSION,
+        environment: options?.environment,
+    });
+    // Show the prompt (unless silent mode)
+    if (!options?.silent) {
+        console.log('');
+        console.log('\x1b[36m[Monora]\x1b[0m Register your project for best practices updates:');
+        console.log('         Run: \x1b[33mnpx monora init\x1b[0m');
+        console.log('         Or skip this message by setting MONORA_SKIP_PROMPT=1');
+        console.log('');
+    }
+    return true;
+}
+/**
+ * Reset the first-run prompt state (for testing).
+ */
+function resetFirstRunPrompt() {
+    try {
+        if (fs.existsSync(FIRST_RUN_PROMPT_PATH)) {
+            fs.unlinkSync(FIRST_RUN_PROMPT_PATH);
+        }
+    }
+    catch {
+        // Silent fail
+    }
+}

package/dist/autodetect.d.ts

@@ -1,6 +1,53 @@
 /**
  * Auto-detection utilities for zero-config initialization.
+ *
+ * Provides intelligent project analysis for streamlined setup:
+ * - Framework detection (Next.js, Express, FastAPI, etc.)
+ * - Cloud platform detection (Vercel, AWS, GCP, etc.)
+ * - AI SDK detection with model suggestions
+ * - Optional AI-powered analysis using Claude/GPT
  */
+/**
+ * Result of framework and project detection.
+ */
+export interface FrameworkDetection {
+    /** Detected framework (next, express, fastify, koa, nest, etc.) */
+    framework: string | null;
+    /** Project type (web-app, api, cli, library, monorepo) */
+    projectType: string;
+    /** Detected cloud platform (vercel, aws, gcp, azure, heroku, etc.) */
+    cloudPlatform: string | null;
+    /** Detected AI SDKs with versions */
+    aiSdks: Array<{
+        name: string;
+        version?: string;
+    }>;
+    /** Suggested models based on detected SDKs */
+    suggestedModels: string[];
+    /** Detected language/runtime */
+    runtime: 'node' | 'python' | 'mixed';
+    /** Entry point file if detected */
+    entryPoint: string | null;
+    /** Whether TypeScript is used */
+    typescript: boolean;
+    /** Package manager (npm, yarn, pnpm) */
+    packageManager: string;
+}
+/**
+ * Result of AI-powered project analysis.
+ */
+export interface AIAnalysisResult {
+    /** Suggested preset based on analysis */
+    suggestedPreset: string;
+    /** Suggested configuration overrides */
+    suggestedConfig: Record<string, any>;
+    /** Reasoning for suggestions */
+    reasoning: string;
+    /** Confidence level (0-1) */
+    confidence: number;
+    /** Detected compliance requirements */
+    complianceHints: string[];
+}
 /**
  * Detect which LLM SDKs are installed.
  */
@@ -21,4 +68,25 @@ export declare function autoDetectConfig(): Record<string, any>;
  * Select the appropriate preset based on environment.
  */
 export declare function selectPresetForEnvironment(env: string): string;
+/**
+ * Detect framework, cloud platform, and AI SDKs from project files.
+ *
+ * This performs comprehensive project analysis without requiring user input.
+ */
+export declare function detectFramework(): FrameworkDetection;
+/**
+ * Analyze project using AI (Claude or GPT) for intelligent configuration suggestions.
+ *
+ * This is optional and requires an API key to be available.
+ * Returns null if no AI API key is found or analysis fails.
+ */
+export declare function analyzeProjectWithAI(): Promise<AIAnalysisResult | null>;
+/**
+ * Build a smart configuration based on all detection results.
+ */
+export declare function buildSmartConfig(detection: FrameworkDetection, aiAnalysis: AIAnalysisResult | null, attribution: {
+    email?: string;
+    company?: string;
+    role?: string;
+}): Record<string, any>;
 //# sourceMappingURL=autodetect.d.ts.map

package/dist/autodetect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"autodetect.d.ts","sourceRoot":"","sources":["../src/autodetect.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAmB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA6D1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CA2CtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAwBtD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAc9D"}
+{"version":3,"file":"autodetect.d.ts","sourceRoot":"","sources":["../src/autodetect.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qCAAqC;IACrC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,8CAA8C;IAC9C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gCAAgC;IAChC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACrC,mCAAmC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iCAAiC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAuKD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAmB9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CA6D1C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CA2CtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAwBtD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAc9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,kBAAkB,CA+NpD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAuF7E;AAsID;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,gBAAgB,GAAG,IAAI,EACnC,WAAW,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAmErB"}