@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/anchors/project-anchors.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Project Anchors - CLI wrapper for @compilr-dev/agents AnchorManager
+ *
+ * Manages per-project anchor isolation using the library's AnchorManager
+ * with project-scoped persistence based on CLI's dataPath configuration.
+ *
+ * Storage structure:
+ *   {dataPath}/anchors/
+ *     ├── global.json           # Non-project anchors
+ *     └── project-{id}.json     # Per-project anchors
+ */
+import { AnchorManager } from '@compilr-dev/sdk';
+import type { Anchor, AnchorInput, AnchorQueryOptions } from '@compilr-dev/sdk';
+export type { Anchor, AnchorInput, AnchorQueryOptions };
+/**
+ * Get anchor manager for a project (or global if projectId is null)
+ *
+ * Creates a new manager if one doesn't exist, using file-based persistence.
+ *
+ * @param projectId - Project ID, or null for global anchors
+ * @returns AnchorManager instance
+ */
+export declare function getAnchorManager(projectId: string | null): AnchorManager;
+/**
+ * Get the global anchor manager
+ */
+export declare function getGlobalAnchorManager(): AnchorManager;
+/**
+ * Clear all anchors for a project
+ *
+ * Should be called when a project is deleted.
+ *
+ * @param projectId - Project ID to clear
+ * @returns Number of anchors removed
+ */
+export declare function clearProjectAnchors(projectId: string): number;
+/**
+ * Get formatted anchor content for injection into system prompt
+ *
+ * Combines global anchors with project-specific anchors.
+ *
+ * @param projectId - Optional project ID to include project anchors
+ * @returns Formatted anchor string for system prompt
+ */
+export declare function getFormattedAnchors(projectId?: string): string;
+/**
+ * Add an anchor
+ *
+ * Convenience function that routes to the appropriate manager.
+ *
+ * @param input - Anchor input with optional projectId
+ * @returns Created anchor
+ */
+export declare function addAnchor(input: AnchorInput & {
+    projectId?: string;
+}): Anchor;
+/**
+ * Get all anchors across all managers
+ *
+ * @param options - Query options
+ * @returns Array of all anchors
+ */
+export declare function getAllAnchors(options?: AnchorQueryOptions): Anchor[];
+/**
+ * Get list of project IDs that have anchor files
+ */
+export declare function getProjectsWithAnchors(): string[];
+/**
+ * Get anchor statistics
+ */
+export declare function getAnchorStats(): {
+    globalCount: number;
+    projectCounts: Map<string, number>;
+    totalTokens: number;
+};
+/**
+ * Clear all cached managers (useful for testing or refresh)
+ */
+export declare function clearManagerCache(): void;

package/dist/anchors/project-anchors.js

@@ -0,0 +1,202 @@
+/**
+ * Project Anchors - CLI wrapper for @compilr-dev/agents AnchorManager
+ *
+ * Manages per-project anchor isolation using the library's AnchorManager
+ * with project-scoped persistence based on CLI's dataPath configuration.
+ *
+ * Storage structure:
+ *   {dataPath}/anchors/
+ *     ├── global.json           # Non-project anchors
+ *     └── project-{id}.json     # Per-project anchors
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { AnchorManager } from '@compilr-dev/sdk';
+import { getDataPath } from '../settings/paths.js';
+// =============================================================================
+// State
+// =============================================================================
+/**
+ * Cache of anchor managers by project ID (null = global)
+ */
+const managers = new Map();
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Get the anchors directory path
+ */
+function getAnchorsDir() {
+    return path.join(getDataPath(), 'anchors');
+}
+/**
+ * Get the persist path for a project (or global)
+ */
+function getPersistPath(projectId) {
+    const anchorsDir = getAnchorsDir();
+    const filename = projectId ? `project-${projectId}.json` : 'global.json';
+    return path.join(anchorsDir, filename);
+}
+/**
+ * Ensure the anchors directory exists
+ */
+function ensureAnchorsDir() {
+    const anchorsDir = getAnchorsDir();
+    if (!fs.existsSync(anchorsDir)) {
+        fs.mkdirSync(anchorsDir, { recursive: true });
+    }
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Get anchor manager for a project (or global if projectId is null)
+ *
+ * Creates a new manager if one doesn't exist, using file-based persistence.
+ *
+ * @param projectId - Project ID, or null for global anchors
+ * @returns AnchorManager instance
+ */
+export function getAnchorManager(projectId) {
+    if (managers.has(projectId)) {
+        const existing = managers.get(projectId);
+        if (existing)
+            return existing;
+    }
+    ensureAnchorsDir();
+    const manager = new AnchorManager({
+        persistPath: getPersistPath(projectId),
+        // Only include default safety anchors for global manager
+        includeDefaults: projectId === null,
+        maxAnchors: 50,
+        maxTokens: 4000,
+    });
+    managers.set(projectId, manager);
+    return manager;
+}
+/**
+ * Get the global anchor manager
+ */
+export function getGlobalAnchorManager() {
+    return getAnchorManager(null);
+}
+/**
+ * Clear all anchors for a project
+ *
+ * Should be called when a project is deleted.
+ *
+ * @param projectId - Project ID to clear
+ * @returns Number of anchors removed
+ */
+export function clearProjectAnchors(projectId) {
+    const manager = managers.get(projectId);
+    let removed = 0;
+    if (manager) {
+        removed = manager.clear();
+        managers.delete(projectId);
+    }
+    // Also delete the persistence file
+    const filePath = getPersistPath(projectId);
+    if (fs.existsSync(filePath)) {
+        fs.unlinkSync(filePath);
+    }
+    return removed;
+}
+/**
+ * Get formatted anchor content for injection into system prompt
+ *
+ * Combines global anchors with project-specific anchors.
+ *
+ * @param projectId - Optional project ID to include project anchors
+ * @returns Formatted anchor string for system prompt
+ */
+export function getFormattedAnchors(projectId) {
+    const parts = [];
+    // Get global anchors
+    const globalManager = getGlobalAnchorManager();
+    const globalFormatted = globalManager.format();
+    if (globalFormatted) {
+        parts.push(globalFormatted);
+    }
+    // Get project-specific anchors if project ID provided
+    if (projectId) {
+        const projectManager = getAnchorManager(projectId);
+        const projectFormatted = projectManager.format();
+        if (projectFormatted) {
+            if (parts.length > 0) {
+                parts.push(''); // Empty line separator
+                parts.push(`### Project Anchors (${projectId})`);
+            }
+            parts.push(projectFormatted);
+        }
+    }
+    return parts.join('\n');
+}
+/**
+ * Add an anchor
+ *
+ * Convenience function that routes to the appropriate manager.
+ *
+ * @param input - Anchor input with optional projectId
+ * @returns Created anchor
+ */
+export function addAnchor(input) {
+    const manager = getAnchorManager(input.projectId ?? null);
+    return manager.add(input);
+}
+/**
+ * Get all anchors across all managers
+ *
+ * @param options - Query options
+ * @returns Array of all anchors
+ */
+export function getAllAnchors(options) {
+    const allAnchors = [];
+    for (const manager of managers.values()) {
+        allAnchors.push(...manager.getAll(options));
+    }
+    return allAnchors;
+}
+/**
+ * Get list of project IDs that have anchor files
+ */
+export function getProjectsWithAnchors() {
+    const anchorsDir = getAnchorsDir();
+    if (!fs.existsSync(anchorsDir)) {
+        return [];
+    }
+    const files = fs.readdirSync(anchorsDir);
+    const projectIds = [];
+    for (const file of files) {
+        const match = /^project-(.+)\.json$/.exec(file);
+        if (match && match[1]) {
+            projectIds.push(match[1]);
+        }
+    }
+    return projectIds;
+}
+/**
+ * Get anchor statistics
+ */
+export function getAnchorStats() {
+    const globalManager = getGlobalAnchorManager();
+    const projectCounts = new Map();
+    let totalTokens = globalManager.getTotalTokens();
+    // Load all project managers to get stats
+    for (const projectId of getProjectsWithAnchors()) {
+        const manager = getAnchorManager(projectId);
+        projectCounts.set(projectId, manager.size);
+        totalTokens += manager.getTotalTokens();
+    }
+    return {
+        globalCount: globalManager.size,
+        projectCounts,
+        totalTokens,
+    };
+}
+/**
+ * Clear all cached managers (useful for testing or refresh)
+ */
+export function clearManagerCache() {
+    managers.clear();
+}

package/dist/auth/api-client.d.ts

@@ -0,0 +1,124 @@
+/**
+ * API Client for CLI Authentication
+ *
+ * All backend communication goes through Netlify Functions.
+ * No direct Supabase SDK dependency — the server handles Supabase calls.
+ *
+ * Note: This is for USER authentication only — users still bring their own LLM API keys.
+ */
+export interface RefreshTokenResponse {
+    success: boolean;
+    access_token?: string;
+    refresh_token?: string;
+    expires_in?: number;
+    user?: {
+        id: string;
+        email: string;
+    };
+    error?: string;
+}
+export interface ProfileData {
+    user_id: string;
+    email: string;
+    account_type: 'free' | 'pro' | 'team' | 'enterprise';
+    telemetry_enabled: boolean;
+    default_provider: string;
+    default_model: string;
+    default_tier: string;
+    theme: string;
+    total_sessions: number;
+    total_messages: number;
+    first_session_at: string | null;
+    last_session_at: string | null;
+    created_at: string;
+}
+export interface HeartbeatData {
+    session_id: string;
+    cli_version: string;
+    os: string;
+    node_version: string;
+    project_id?: number;
+    total_messages?: number;
+    total_tokens_in?: number;
+    total_tokens_out?: number;
+    commands_used?: Record<string, number>;
+    agents_used?: string[];
+    tools_used?: string[];
+    llm_provider?: string;
+    llm_model?: string;
+}
+export interface DeviceCodeResponse {
+    device_code: string;
+    user_code: string;
+    verification_uri: string;
+    verification_uri_complete: string;
+    expires_in: number;
+    interval: number;
+}
+export interface DeviceTokenResponse {
+    access_token: string;
+    refresh_token: string;
+    token_type: string;
+    expires_in: number;
+    api_token?: string;
+    user: {
+        id: string;
+        email: string;
+    };
+}
+export interface DeviceTokenError {
+    error: 'authorization_pending' | 'slow_down' | 'expired_token' | 'access_denied' | 'invalid_grant' | 'server_error';
+    error_description: string;
+}
+/**
+ * Refresh an access token using a refresh token.
+ * Calls the server-side Netlify function which handles Supabase internally.
+ */
+export declare function refreshToken(refreshTokenValue: string): Promise<RefreshTokenResponse>;
+/**
+ * Send heartbeat to record session.
+ */
+export declare function sendHeartbeat(accessToken: string, data: HeartbeatData): Promise<{
+    success: boolean;
+    telemetry_enabled?: boolean;
+    error?: string;
+}>;
+/**
+ * Get user profile from CLI API.
+ */
+export declare function getProfile(accessToken: string): Promise<{
+    success: boolean;
+    profile?: ProfileData;
+    error?: string;
+}>;
+/**
+ * Update user profile via CLI API.
+ */
+export declare function updateProfile(accessToken: string, updates: Partial<Pick<ProfileData, 'telemetry_enabled' | 'default_provider' | 'default_model' | 'default_tier' | 'theme'>>): Promise<{
+    success: boolean;
+    profile?: ProfileData;
+    error?: string;
+}>;
+/**
+ * Request a device code for CLI authentication.
+ * Returns codes and URLs for the user to authorize.
+ */
+export declare function requestDeviceCode(): Promise<{
+    success: boolean;
+    data?: DeviceCodeResponse;
+    error?: string;
+}>;
+/**
+ * Poll for device token after user authorizes.
+ * Returns tokens on success, or error status if still pending.
+ */
+export declare function pollDeviceToken(deviceCode: string): Promise<{
+    success: boolean;
+    data?: DeviceTokenResponse;
+    error?: DeviceTokenError;
+    networkError?: string;
+}>;
+/**
+ * Get the authorization URL for the device flow.
+ */
+export declare function getAuthorizationUrl(userCode?: string): string;

package/dist/auth/api-client.js

@@ -0,0 +1,261 @@
+/**
+ * API Client for CLI Authentication
+ *
+ * All backend communication goes through Netlify Functions.
+ * No direct Supabase SDK dependency — the server handles Supabase calls.
+ *
+ * Note: This is for USER authentication only — users still bring their own LLM API keys.
+ */
+import * as os from 'os';
+// =============================================================================
+// Configuration
+// =============================================================================
+// API endpoint for CLI-specific operations
+// Use COMPILR_API_URL env var for testing against branch previews
+const API_BASE_URL = process.env.COMPILR_API_URL || 'https://compilr.dev/.netlify/functions';
+// Device flow authorization URL
+// Use COMPILR_WEB_URL env var for testing against branch previews
+const WEB_BASE_URL = process.env.COMPILR_WEB_URL || 'https://compilr.dev';
+const AUTHORIZATION_URL = `${WEB_BASE_URL}/cli/authorize`;
+// =============================================================================
+// Token Refresh (via Netlify Function)
+// =============================================================================
+/**
+ * Refresh an access token using a refresh token.
+ * Calls the server-side Netlify function which handles Supabase internally.
+ */
+export async function refreshToken(refreshTokenValue) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/cli-refresh-token`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({ refresh_token: refreshTokenValue }),
+        });
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.includes('application/json')) {
+            return { success: false, error: `Server returned non-JSON response (${String(response.status)})` };
+        }
+        const result = await response.json();
+        if (!response.ok) {
+            return {
+                success: false,
+                error: result.error ?? `HTTP ${String(response.status)}`,
+            };
+        }
+        return {
+            success: true,
+            access_token: result.access_token,
+            refresh_token: result.refresh_token,
+            expires_in: result.expires_in,
+            user: result.user,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+// =============================================================================
+// CLI API Operations (against our Netlify Functions)
+// =============================================================================
+/**
+ * Send heartbeat to record session.
+ */
+export async function sendHeartbeat(accessToken, data) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/cli-heartbeat`, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(data),
+        });
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.includes('application/json')) {
+            return { success: false, error: `Server returned non-JSON response (${String(response.status)})` };
+        }
+        const result = await response.json();
+        if (!response.ok) {
+            return {
+                success: false,
+                error: result.error ?? `HTTP ${String(response.status)}`,
+            };
+        }
+        return {
+            success: result.success ?? true,
+            telemetry_enabled: result.telemetry_enabled,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+/**
+ * Get user profile from CLI API.
+ */
+export async function getProfile(accessToken) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/cli-profile`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+            },
+        });
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.includes('application/json')) {
+            return { success: false, error: `Server returned non-JSON response (${String(response.status)})` };
+        }
+        const result = await response.json();
+        if (!response.ok) {
+            return {
+                success: false,
+                error: result.error ?? `HTTP ${String(response.status)}`,
+            };
+        }
+        return {
+            success: true,
+            profile: result,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+/**
+ * Update user profile via CLI API.
+ */
+export async function updateProfile(accessToken, updates) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/cli-profile`, {
+            method: 'PATCH',
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(updates),
+        });
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.includes('application/json')) {
+            return { success: false, error: `Server returned non-JSON response (${String(response.status)})` };
+        }
+        const result = await response.json();
+        if (!response.ok) {
+            return {
+                success: false,
+                error: result.error ?? `HTTP ${String(response.status)}`,
+            };
+        }
+        return {
+            success: result.success ?? true,
+            profile: result.profile,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+// =============================================================================
+// Device Flow Authentication
+// =============================================================================
+/**
+ * Request a device code for CLI authentication.
+ * Returns codes and URLs for the user to authorize.
+ */
+export async function requestDeviceCode() {
+    try {
+        const url = `${API_BASE_URL}/cli-device-code`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.includes('application/json')) {
+            return {
+                success: false,
+                error: `Non-JSON response (${String(response.status)}) from: ${url}`,
+            };
+        }
+        if (!response.ok) {
+            const result = await response.json();
+            return {
+                success: false,
+                error: result.error ?? `HTTP ${String(response.status)}`,
+            };
+        }
+        const data = await response.json();
+        return { success: true, data };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+/**
+ * Poll for device token after user authorizes.
+ * Returns tokens on success, or error status if still pending.
+ */
+export async function pollDeviceToken(deviceCode) {
+    try {
+        const response = await fetch(`${API_BASE_URL}/cli-device-token`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                device_code: deviceCode,
+                hostname: os.hostname(),
+            }),
+        });
+        const contentType = response.headers.get('content-type') ?? '';
+        if (!contentType.includes('application/json')) {
+            return {
+                success: false,
+                networkError: `Server returned non-JSON response (${String(response.status)})`,
+            };
+        }
+        const result = await response.json();
+        if (!response.ok) {
+            return {
+                success: false,
+                error: result,
+            };
+        }
+        return {
+            success: true,
+            data: result,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            networkError: error instanceof Error ? error.message : 'Network error',
+        };
+    }
+}
+/**
+ * Get the authorization URL for the device flow.
+ */
+export function getAuthorizationUrl(userCode) {
+    if (userCode) {
+        return `${AUTHORIZATION_URL}?code=${userCode}`;
+    }
+    return AUTHORIZATION_URL;
+}