@compilr-dev/cli 0.5.0 → 0.5.2

package/dist/utils/token-tracker.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Token Tracker
+ *
+ * Tracks token usage breakdown for debugging and optimization.
+ * Estimates are calculated when the agent is created and updated
+ * as context changes (messages added, etc.).
+ */
+import type { TokenBreakdown } from './token-types.js';
+export interface TokenEstimates {
+    system: number;
+    role: number;
+    tools: number;
+    context: number;
+    history: number;
+}
+/**
+ * Count tokens using tiktoken (cl100k_base encoding)
+ */
+export declare function estimateTokens(text: string | undefined): number;
+/**
+ * Count tokens for a JSON object (tool definition, etc.)
+ */
+export declare function estimateJsonTokens(obj: unknown): number;
+/**
+ * Set static token estimates (called at agent creation)
+ */
+export declare function setStaticEstimates(estimates: {
+    system: number;
+    role: number;
+    tools: number;
+    context: number;
+}): void;
+/**
+ * Update history token estimate (called before each request)
+ */
+export declare function updateHistoryEstimate(historyTokens: number): void;
+/**
+ * Update cache info from API response
+ */
+export declare function updateCacheInfo(cacheRead: number, cacheCreation: number): void;
+/**
+ * Get current breakdown for display
+ */
+export declare function getTokenBreakdown(): TokenBreakdown;
+/**
+ * Get total estimated tokens
+ */
+export declare function getTotalEstimate(): number;
+/**
+ * Reset all estimates (for new agent/session)
+ */
+export declare function resetEstimates(): void;
+/**
+ * Format breakdown for display (compact form)
+ * Example: "sys:2k role:1k tools:12k ctx:0.4k hist:3k"
+ */
+export declare function formatBreakdownCompact(): string;
+/**
+ * Format cache info for display
+ * Example: "cached:18k new:5k"
+ */
+export declare function formatCacheInfo(): string | null;

package/dist/utils/token-tracker.js

@@ -0,0 +1,150 @@
+/**
+ * Token Tracker
+ *
+ * Tracks token usage breakdown for debugging and optimization.
+ * Estimates are calculated when the agent is created and updated
+ * as context changes (messages added, etc.).
+ */
+import { getEncoding } from 'js-tiktoken';
+import { formatTokens } from './format-tokens.js';
+// Lazy-initialized tiktoken encoder
+let encoder = null;
+function getEncoder() {
+    if (!encoder) {
+        encoder = getEncoding('cl100k_base');
+    }
+    return encoder;
+}
+// =============================================================================
+// Singleton State
+// =============================================================================
+let currentEstimates = {
+    system: 0,
+    role: 0,
+    tools: 0,
+    context: 0,
+    history: 0,
+};
+let lastCacheRead = 0;
+let lastCacheCreation = 0;
+// =============================================================================
+// Estimation Helpers
+// =============================================================================
+/**
+ * Count tokens using tiktoken (cl100k_base encoding)
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return getEncoder().encode(text).length;
+}
+/**
+ * Count tokens for a JSON object (tool definition, etc.)
+ */
+export function estimateJsonTokens(obj) {
+    const json = JSON.stringify(obj);
+    return getEncoder().encode(json).length;
+}
+// =============================================================================
+// Public API
+// =============================================================================
+/**
+ * Set static token estimates (called at agent creation)
+ */
+export function setStaticEstimates(estimates) {
+    currentEstimates = {
+        ...currentEstimates,
+        ...estimates,
+    };
+}
+/**
+ * Update history token estimate (called before each request)
+ */
+export function updateHistoryEstimate(historyTokens) {
+    currentEstimates.history = historyTokens;
+}
+/**
+ * Update cache info from API response
+ */
+export function updateCacheInfo(cacheRead, cacheCreation) {
+    lastCacheRead = cacheRead;
+    lastCacheCreation = cacheCreation;
+}
+/**
+ * Get current breakdown for display
+ */
+export function getTokenBreakdown() {
+    return {
+        system: currentEstimates.system,
+        role: currentEstimates.role,
+        tools: currentEstimates.tools,
+        context: currentEstimates.context,
+        history: currentEstimates.history,
+        cacheRead: lastCacheRead > 0 ? lastCacheRead : undefined,
+        cacheCreation: lastCacheCreation > 0 ? lastCacheCreation : undefined,
+    };
+}
+/**
+ * Get total estimated tokens
+ */
+export function getTotalEstimate() {
+    return (currentEstimates.system +
+        currentEstimates.role +
+        currentEstimates.tools +
+        currentEstimates.context +
+        currentEstimates.history);
+}
+/**
+ * Reset all estimates (for new agent/session)
+ */
+export function resetEstimates() {
+    currentEstimates = {
+        system: 0,
+        role: 0,
+        tools: 0,
+        context: 0,
+        history: 0,
+    };
+    lastCacheRead = 0;
+    lastCacheCreation = 0;
+}
+/**
+ * Format breakdown for display (compact form)
+ * Example: "sys:2k role:1k tools:12k ctx:0.4k hist:3k"
+ */
+export function formatBreakdownCompact() {
+    const parts = [];
+    if (currentEstimates.system > 0) {
+        parts.push(`sys:${formatTokens(currentEstimates.system)}`);
+    }
+    if (currentEstimates.role > 0) {
+        parts.push(`role:${formatTokens(currentEstimates.role)}`);
+    }
+    if (currentEstimates.tools > 0) {
+        parts.push(`tools:${formatTokens(currentEstimates.tools)}`);
+    }
+    if (currentEstimates.context > 0) {
+        parts.push(`ctx:${formatTokens(currentEstimates.context)}`);
+    }
+    if (currentEstimates.history > 0) {
+        parts.push(`hist:${formatTokens(currentEstimates.history)}`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Format cache info for display
+ * Example: "cached:18k new:5k"
+ */
+export function formatCacheInfo() {
+    if (lastCacheRead === 0 && lastCacheCreation === 0) {
+        return null;
+    }
+    const parts = [];
+    if (lastCacheRead > 0) {
+        parts.push(`cached:${formatTokens(lastCacheRead)}`);
+    }
+    if (lastCacheCreation > 0) {
+        parts.push(`new:${formatTokens(lastCacheCreation)}`);
+    }
+    return parts.join(' ');
+}

package/dist/utils/token-types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Token Breakdown Types
+ *
+ * Extracted from ui/types.ts so foundation-layer code (token-tracker)
+ * can reference it without importing from the domain layer.
+ */
+/**
+ * Detailed breakdown of input token components.
+ * Helps debug and optimize token usage.
+ */
+export interface TokenBreakdown {
+    system: number;
+    role: number;
+    tools: number;
+    context: number;
+    history: number;
+    cacheRead?: number;
+    cacheCreation?: number;
+}
+/**
+ * Create an empty token breakdown
+ */
+export declare function emptyTokenBreakdown(): TokenBreakdown;

package/dist/utils/token-types.js

@@ -0,0 +1,18 @@
+/**
+ * Token Breakdown Types
+ *
+ * Extracted from ui/types.ts so foundation-layer code (token-tracker)
+ * can reference it without importing from the domain layer.
+ */
+/**
+ * Create an empty token breakdown
+ */
+export function emptyTokenBreakdown() {
+    return {
+        system: 0,
+        role: 0,
+        tools: 0,
+        context: 0,
+        history: 0,
+    };
+}

package/dist/utils/types/config-types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Compilr Config Types
+ *
+ * Extracted from templates/config-json.ts so foundation-layer code
+ * (utils/project-status) can reference it without importing from
+ * the data layer.
+ */
+export interface CompilrConfig {
+    version: string;
+    project: {
+        name: string;
+        description: string;
+        createdAt: string;
+    };
+    paths: {
+        /** Absolute path to the project/code repository */
+        project: string;
+        /** Absolute path to the docs repository (two-repo pattern only) */
+        docs: string | null;
+        /** Directory where .compilr/config.json lives (for reference) */
+        workflowRoot: string;
+    };
+    settings: {
+        repoPattern: 'single' | 'two-repo';
+        techStack: string;
+        codingStandards: string;
+    };
+    sessions: {
+        count: number;
+        lastSession: string | null;
+    };
+}

package/dist/utils/types/config-types.js

@@ -0,0 +1,8 @@
+/**
+ * Compilr Config Types
+ *
+ * Extracted from templates/config-json.ts so foundation-layer code
+ * (utils/project-status) can reference it without importing from
+ * the data layer.
+ */
+export {};

package/dist/utils/update-checker.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Update checker utility
+ *
+ * Queries npm registry to check for new versions of @compilr-dev/cli
+ */
+export interface UpdateInfo {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+    releaseUrl: string;
+    npmUrl: string;
+}
+/**
+ * Check npm registry for the latest version
+ */
+export declare function checkForUpdates(): Promise<UpdateInfo>;
+/**
+ * Format update notification message
+ */
+export declare function formatUpdateMessage(info: UpdateInfo): string;
+/**
+ * Perform the update via npm
+ * Returns true if update was successful
+ */
+export declare function performUpdate(): Promise<{
+    success: boolean;
+    message: string;
+}>;

package/dist/utils/update-checker.js

@@ -0,0 +1,106 @@
+/**
+ * Update checker utility
+ *
+ * Queries npm registry to check for new versions of @compilr-dev/cli
+ */
+import { VERSION } from './version.js';
+/**
+ * Check npm registry for the latest version
+ */
+export async function checkForUpdates() {
+    const packageName = '@compilr-dev/cli';
+    const registryUrl = `https://registry.npmjs.org/${packageName}/latest`;
+    try {
+        const response = await fetch(registryUrl, {
+            headers: {
+                Accept: 'application/json',
+            },
+            // Short timeout to not block startup
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok) {
+            throw new Error(`Registry returned ${String(response.status)}`);
+        }
+        const data = (await response.json());
+        const latestVersion = data.version;
+        return {
+            currentVersion: VERSION,
+            latestVersion,
+            updateAvailable: isNewerVersion(latestVersion, VERSION),
+            releaseUrl: `https://github.com/compilr-dev/cli/releases/tag/v${latestVersion}`,
+            npmUrl: `https://www.npmjs.com/package/${packageName}`,
+        };
+    }
+    catch {
+        // Network error or timeout - return no update available
+        return {
+            currentVersion: VERSION,
+            latestVersion: VERSION,
+            updateAvailable: false,
+            releaseUrl: '',
+            npmUrl: `https://www.npmjs.com/package/${packageName}`,
+        };
+    }
+}
+/**
+ * Compare semantic versions
+ * Returns true if version1 > version2
+ */
+function isNewerVersion(version1, version2) {
+    const v1Parts = version1.split('.').map(Number);
+    const v2Parts = version2.split('.').map(Number);
+    for (let i = 0; i < Math.max(v1Parts.length, v2Parts.length); i++) {
+        const v1 = v1Parts[i] || 0;
+        const v2 = v2Parts[i] || 0;
+        if (v1 > v2)
+            return true;
+        if (v1 < v2)
+            return false;
+    }
+    return false;
+}
+/**
+ * Format update notification message
+ */
+export function formatUpdateMessage(info) {
+    if (!info.updateAvailable) {
+        return '';
+    }
+    return [
+        `Update available: v${info.currentVersion} → v${info.latestVersion}`,
+        `Run: npm update -g @compilr-dev/cli`,
+    ].join('\n');
+}
+/**
+ * Perform the update via npm
+ * Returns true if update was successful
+ */
+export async function performUpdate() {
+    const { spawn } = await import('child_process');
+    return new Promise((resolve) => {
+        const child = spawn('npm', ['update', '-g', '@compilr-dev/cli'], {
+            stdio: 'inherit',
+            shell: true,
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve({
+                    success: true,
+                    message: 'Update completed. Please restart the CLI.',
+                });
+            }
+            else {
+                resolve({
+                    success: false,
+                    message: `Update failed with exit code ${String(code ?? 'unknown')}. Try running: npm update -g @compilr-dev/cli`,
+                });
+            }
+        });
+        child.on('error', (error) => {
+            resolve({
+                success: false,
+                message: `Update failed: ${error.message}. Try running: npm update -g @compilr-dev/cli`,
+            });
+        });
+    });
+}

package/dist/utils/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Version Constant
+ *
+ * Reads the version from package.json so foundation-layer code
+ * (update-checker) doesn't need to import from the app-layer index.ts.
+ */
+export declare const VERSION: string;

package/dist/utils/version.js

@@ -0,0 +1,10 @@
+/**
+ * Version Constant
+ *
+ * Reads the version from package.json so foundation-layer code
+ * (update-checker) doesn't need to import from the app-layer index.ts.
+ */
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+export const VERSION = pkg.version;

package/dist/utils/vscode-detect.d.ts

@@ -0,0 +1,39 @@
+/**
+ * VS Code Detection & Extension Auto-Install
+ *
+ * Detects whether the CLI is running inside VS Code's integrated terminal
+ * and manages installation of the compilr-diff-companion extension.
+ *
+ * Foundation layer — no imports from domain or app layers.
+ */
+/**
+ * Check if the CLI is running inside VS Code's integrated terminal.
+ * Checks multiple env vars that VS Code sets.
+ */
+export declare function isInVSCode(): boolean;
+/**
+ * Check if the `code` CLI command is available on PATH.
+ * Cached after first call.
+ */
+export declare function isCodeCliAvailable(): boolean;
+/**
+ * Check if VS Code diff integration is available (in VS Code + code CLI works).
+ */
+export declare function isVSDiffAvailable(): boolean;
+/** Result of ensureExtensionInstalled() */
+export interface ExtensionInstallResult {
+    /** Whether the extension is installed and ready */
+    installed: boolean;
+    /** Whether a fresh install/upgrade just happened (reload needed to activate) */
+    needsReload: boolean;
+}
+/**
+ * Ensure the compilr-diff-companion extension is installed (and up to date).
+ *
+ * - If not installed: installs the bundled VSIX → needsReload = true
+ * - If installed but older version: upgrades → needsReload = true
+ * - If already current: no-op → needsReload = false
+ *
+ * Runs silently. Result is cached for the session — only runs once.
+ */
+export declare function ensureExtensionInstalled(): Promise<ExtensionInstallResult>;

package/dist/utils/vscode-detect.js

@@ -0,0 +1,137 @@
+/**
+ * VS Code Detection & Extension Auto-Install
+ *
+ * Detects whether the CLI is running inside VS Code's integrated terminal
+ * and manages installation of the compilr-diff-companion extension.
+ *
+ * Foundation layer — no imports from domain or app layers.
+ */
+import { execSync } from 'child_process';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+// =============================================================================
+// Detection (cached at module level — env vars don't change mid-session)
+// =============================================================================
+let _isInVSCode = null;
+let _isCodeCliAvailable = null;
+/**
+ * Check if the CLI is running inside VS Code's integrated terminal.
+ * Checks multiple env vars that VS Code sets.
+ */
+export function isInVSCode() {
+    if (_isInVSCode !== null)
+        return _isInVSCode;
+    _isInVSCode = Boolean(process.env.TERM_PROGRAM === 'vscode' ||
+        process.env.VSCODE_GIT_IPC_HANDLE ||
+        process.env.VSCODE_INJECTION);
+    return _isInVSCode;
+}
+/**
+ * Check if the `code` CLI command is available on PATH.
+ * Cached after first call.
+ */
+export function isCodeCliAvailable() {
+    if (_isCodeCliAvailable !== null)
+        return _isCodeCliAvailable;
+    try {
+        execSync('which code', { stdio: ['pipe', 'pipe', 'pipe'] });
+        _isCodeCliAvailable = true;
+    }
+    catch {
+        _isCodeCliAvailable = false;
+    }
+    return _isCodeCliAvailable;
+}
+/**
+ * Check if VS Code diff integration is available (in VS Code + code CLI works).
+ */
+export function isVSDiffAvailable() {
+    return isInVSCode() && isCodeCliAvailable();
+}
+// =============================================================================
+// Extension Version
+// =============================================================================
+/** Version of the bundled extension (must match vscode-extension/package.json) */
+const BUNDLED_EXTENSION_VERSION = '0.0.2';
+/**
+ * Get the installed version of the compilr-diff-companion extension.
+ * Returns null if not installed.
+ */
+function getInstalledExtensionVersion() {
+    try {
+        const output = execSync('code --list-extensions --show-versions', {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 10_000,
+        });
+        for (const line of output.split('\n')) {
+            if (line.startsWith('compilr.compilr-diff-companion@')) {
+                return line.split('@')[1].trim();
+            }
+        }
+    }
+    catch {
+        // code CLI not available or failed
+    }
+    return null;
+}
+// =============================================================================
+// Extension Install
+// =============================================================================
+let _extensionCheckDone = false;
+/**
+ * Ensure the compilr-diff-companion extension is installed (and up to date).
+ *
+ * - If not installed: installs the bundled VSIX → needsReload = true
+ * - If installed but older version: upgrades → needsReload = true
+ * - If already current: no-op → needsReload = false
+ *
+ * Runs silently. Result is cached for the session — only runs once.
+ */
+export function ensureExtensionInstalled() {
+    if (_extensionCheckDone)
+        return Promise.resolve({ installed: true, needsReload: false });
+    try {
+        const installedVersion = getInstalledExtensionVersion();
+        // Skip if already at or above bundled version
+        if (installedVersion && compareVersions(installedVersion, BUNDLED_EXTENSION_VERSION) >= 0) {
+            _extensionCheckDone = true;
+            return Promise.resolve({ installed: true, needsReload: false });
+        }
+        // Resolve VSIX path relative to this module's compiled location
+        // In dist/: dist/utils/vscode-detect.js -> dist/compilr-diff-companion.vsix
+        const __filename = fileURLToPath(import.meta.url);
+        const __dirname = path.dirname(__filename);
+        const vsixPath = path.resolve(__dirname, '..', 'compilr-diff-companion.vsix');
+        execSync(`code --install-extension "${vsixPath}" --force`, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 30_000,
+        });
+        _extensionCheckDone = true;
+        // Extension was just installed/upgraded — needs VS Code reload to activate
+        return Promise.resolve({ installed: true, needsReload: true });
+    }
+    catch {
+        // Silent failure — VS Code diff is optional
+        return Promise.resolve({ installed: false, needsReload: false });
+    }
+}
+/**
+ * Compare two semver strings. Returns:
+ *  -1 if a < b
+ *   0 if a == b
+ *   1 if a > b
+ */
+function compareVersions(a, b) {
+    const pa = a.split('.').map(Number);
+    const pb = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (va < vb)
+            return -1;
+        if (va > vb)
+            return 1;
+    }
+    return 0;
+}