@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/themes/registry.js

@@ -1,108 +1,23 @@
 /**
  * Theme Registry
  *
- * Load, save, and manage themes.
- * Persistence in ~/.compilr-dev/settings.json
+ * Re-exports theme query functions from @compilr-dev/editor-core/themes.
+ * CLI-specific persistence in ~/.compilr-dev/settings.json
  */
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
 // =============================================================================
+// Re-export theme query functions from editor-core
+// =============================================================================
+export { getAllThemes, getCuratedThemes, getThemeById, searchThemes, filterThemesByType, searchAndFilterThemes, getThemeStats as getThemeCount, } from '@compilr-dev/editor-core/themes';
+import { getAllThemes, getThemeById, DEFAULT_THEME_ID, } from '@compilr-dev/editor-core/themes';
+// =============================================================================
 // Constants
 // =============================================================================
 const CONFIG_DIR = path.join(os.homedir(), '.compilr-dev');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'settings.json');
-const DEFAULT_THEME = 'compilr-dark';
-// =============================================================================
-// Theme Data (loaded once)
-// =============================================================================
-// Load themes from JSON file
-// Resolve path relative to this file's location (works in both src and dist)
-import { fileURLToPath } from 'url';
-import { dirname } from 'path';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-// Try multiple possible locations for themes.json
-function loadThemes() {
-    const possiblePaths = [
-        path.join(__dirname, '../data/themes.json'), // dist/themes -> dist/data
-        path.join(__dirname, '../../src/data/themes.json'), // dist/themes -> src/data
-        path.join(__dirname, '../../data/themes.json'), // src/themes -> data (if running from src)
-    ];
-    for (const themePath of possiblePaths) {
-        if (fs.existsSync(themePath)) {
-            const data = fs.readFileSync(themePath, 'utf-8');
-            return JSON.parse(data);
-        }
-    }
-    throw new Error(`themes.json not found. Tried: ${possiblePaths.join(', ')}`);
-}
-const themesData = loadThemes();
-// =============================================================================
-// Theme Query Functions
-// =============================================================================
-/**
- * Get all available themes
- */
-export function getAllThemes() {
-    return themesData;
-}
-/**
- * Get curated/featured themes
- */
-export function getCuratedThemes() {
-    return themesData.filter((t) => t.curated);
-}
-/**
- * Get theme by ID
- */
-export function getThemeById(id) {
-    return themesData.find((t) => t.id === id);
-}
-/**
- * Search themes by name (case-insensitive)
- */
-export function searchThemes(query) {
-    if (!query.trim())
-        return themesData;
-    const lower = query.toLowerCase();
-    return themesData.filter((t) => t.name.toLowerCase().includes(lower));
-}
-/**
- * Filter themes by type
- */
-export function filterThemesByType(type) {
-    if (type === 'all')
-        return themesData;
-    return themesData.filter((t) => t.type === type);
-}
-/**
- * Search and filter themes
- */
-export function searchAndFilterThemes(query, type) {
-    let results = themesData;
-    // Apply type filter
-    if (type !== 'all') {
-        results = results.filter((t) => t.type === type);
-    }
-    // Apply search
-    if (query.trim()) {
-        const lower = query.toLowerCase();
-        results = results.filter((t) => t.name.toLowerCase().includes(lower));
-    }
-    return results;
-}
-/**
- * Get theme count
- */
-export function getThemeCount() {
-    return {
-        total: themesData.length,
-        dark: themesData.filter((t) => t.type === 'dark').length,
-        light: themesData.filter((t) => t.type === 'light').length,
-        curated: themesData.filter((t) => t.curated).length,
-    };
-}
+const DEFAULT_THEME = DEFAULT_THEME_ID;
 /**
  * Load settings from config file
  */
@@ -172,8 +87,9 @@ export function getCurrentTheme() {
         return defaultTheme;
     }
     // Ultimate fallback - first theme in list
-    currentThemeCache = themesData[0];
-    return themesData[0];
+    const allThemes = getAllThemes();
+    currentThemeCache = allThemes[0];
+    return allThemes[0];
 }
 /**
  * Set current theme

package/dist/themes/types.d.ts

@@ -1,45 +1,10 @@
 /**
  * Theme Types
  *
- * Type definitions for the 418-theme system.
- * Themes sourced from Ghostty terminal themes (MIT licensed).
+ * Re-exports core types from @compilr-dev/editor-core/themes.
+ * CLI-specific types (ThemeConfig, ThemeStyleFunctions) defined here.
  */
-export interface Theme {
-    /** Unique identifier (e.g., "compilr-dark", "dracula") */
-    id: string;
-    /** Display name (e.g., "compilr.dev Dark", "Dracula") */
-    name: string;
-    /** Theme type */
-    type: 'dark' | 'light';
-    /** Source of the theme (e.g., "custom", "ghostty") */
-    source: string;
-    /** Theme author */
-    author?: string;
-    /** Color palette */
-    colors: ThemeColors;
-    /** Whether this is a curated/featured theme */
-    curated?: boolean;
-}
-export interface ThemeColors {
-    /** Background color (e.g., "#0A0A0A") */
-    background: string;
-    /** Foreground/text color (e.g., "#FAFAFA") */
-    foreground: string;
-    /** Primary accent color (e.g., "#FF5722") */
-    primary: string;
-    /** Secondary accent color */
-    secondary?: string;
-    /** Border color */
-    border: string;
-    /** Card/panel background color */
-    card?: string;
-    /** Muted/dim text color */
-    muted: string;
-    /** Selection highlight color */
-    selection: string;
-    /** Cursor color */
-    cursor: string;
-}
+export type { Theme, ThemeColors } from '@compilr-dev/editor-core/themes';
 export interface ThemeConfig {
     /** Currently selected theme ID */
     currentTheme: string;

package/dist/themes/types.js

@@ -1,7 +1,7 @@
 /**
  * Theme Types
  *
- * Type definitions for the 418-theme system.
- * Themes sourced from Ghostty terminal themes (MIT licensed).
+ * Re-exports core types from @compilr-dev/editor-core/themes.
+ * CLI-specific types (ThemeConfig, ThemeStyleFunctions) defined here.
  */
 export {};

package/dist/tools/anchor-tools.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Anchor Tools - Agent tools for managing anchors
+ *
+ * Provides anchor_add and anchor_remove tools that allow
+ * the agent to add critical context that survives compaction.
+ */
+interface AnchorAddInput {
+    /** The anchor content - critical information to preserve */
+    content: string;
+    /** Priority level: 'critical' | 'safety' | 'info' (default: 'info') */
+    priority?: 'critical' | 'safety' | 'info';
+    /** Scope: 'global' or 'project' (default: 'project' if active project, else 'global') */
+    scope?: 'global' | 'project';
+    /** Tags for categorization */
+    tags?: string[];
+}
+interface AnchorRemoveInput {
+    /** ID of the anchor to remove */
+    id: string;
+}
+interface AnchorListInput {
+    /** Filter by scope: 'global' | 'project' | 'all' (default: 'all') */
+    scope?: 'global' | 'project' | 'all';
+    /** Filter by priority */
+    priority?: 'critical' | 'safety' | 'info';
+}
+export declare const anchorAddTool: import("@compilr-dev/agents").Tool<AnchorAddInput>;
+export declare const anchorRemoveTool: import("@compilr-dev/agents").Tool<AnchorRemoveInput>;
+export declare const anchorListTool: import("@compilr-dev/agents").Tool<AnchorListInput>;
+export declare const allAnchorTools: (import("@compilr-dev/agents").Tool<AnchorAddInput> | import("@compilr-dev/agents").Tool<AnchorRemoveInput>)[];
+export {};

package/dist/tools/anchor-tools.js

@@ -0,0 +1,255 @@
+/**
+ * Anchor Tools - Agent tools for managing anchors
+ *
+ * Provides anchor_add and anchor_remove tools that allow
+ * the agent to add critical context that survives compaction.
+ */
+import { defineTool } from '@compilr-dev/agents';
+import { getGlobalAnchorManager, getAnchorManager, } from '../anchors/index.js';
+import { getActiveProject } from './project-db.js';
+// =============================================================================
+// anchor_add Tool
+// =============================================================================
+export const anchorAddTool = defineTool({
+    name: 'anchor_add',
+    description: 'Add critical information that must survive context compaction. ' +
+        'Use this for: project context, important decisions, user preferences, ' +
+        'architectural constraints, or any information that should persist across the entire conversation. ' +
+        'Anchors are always included at the top of the context window.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            content: {
+                type: 'string',
+                description: 'The critical information to preserve. Keep it concise but complete.',
+            },
+            priority: {
+                type: 'string',
+                enum: ['critical', 'safety', 'info'],
+                description: 'Priority level. "critical" for must-never-forget info (user preferences, key constraints), ' +
+                    '"safety" for safety-related context, "info" for general helpful context.',
+            },
+            scope: {
+                type: 'string',
+                enum: ['global', 'project'],
+                description: 'Scope for the anchor. "global" persists across all projects, ' +
+                    '"project" is specific to the current project (requires active project).',
+            },
+            tags: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Optional tags for categorization (e.g., ["architecture", "decision"])',
+            },
+        },
+        required: ['content'],
+    },
+    execute: (input) => {
+        try {
+            // Validate content
+            if (!input.content || input.content.trim().length === 0) {
+                return Promise.resolve({
+                    success: false,
+                    error: 'Anchor content is required and cannot be empty',
+                });
+            }
+            const content = input.content.trim();
+            const priority = input.priority ?? 'info';
+            const activeProject = getActiveProject();
+            // Determine scope
+            let scope = input.scope;
+            if (!scope) {
+                scope = activeProject ? 'project' : 'global';
+            }
+            // Validate project scope
+            if (scope === 'project' && !activeProject) {
+                return Promise.resolve({
+                    success: false,
+                    error: 'Cannot add project-scoped anchor: no active project. Use scope: "global" instead.',
+                });
+            }
+            // Get project ID for project-scoped anchors (validated above that activeProject exists)
+            const projectId = scope === 'project' && activeProject
+                ? String(activeProject.id)
+                : undefined;
+            // Get the appropriate manager
+            const manager = scope === 'global'
+                ? getGlobalAnchorManager()
+                : getAnchorManager(projectId ?? '');
+            // Add the anchor
+            const anchor = manager.add({
+                content,
+                priority,
+                scope: 'persistent', // Anchors persist across sessions
+                tags: input.tags,
+                projectId,
+            });
+            return Promise.resolve({
+                success: true,
+                result: {
+                    id: anchor.id,
+                    content: anchor.content,
+                    priority: anchor.priority,
+                    scope: scope,
+                    tags: anchor.tags,
+                    message: `Anchor added successfully (${scope} scope, ${priority} priority)`,
+                },
+            });
+        }
+        catch (err) {
+            return Promise.resolve({
+                success: false,
+                error: `Failed to add anchor: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    },
+});
+// =============================================================================
+// anchor_remove Tool
+// =============================================================================
+export const anchorRemoveTool = defineTool({
+    name: 'anchor_remove',
+    description: 'Remove an anchor by its ID. Use this to clean up outdated or no longer relevant anchors. ' +
+        'Use anchor_list first to see available anchors and their IDs.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: {
+                type: 'string',
+                description: 'The ID of the anchor to remove',
+            },
+        },
+        required: ['id'],
+    },
+    execute: (input) => {
+        try {
+            if (!input.id || input.id.trim().length === 0) {
+                return Promise.resolve({
+                    success: false,
+                    error: 'Anchor ID is required',
+                });
+            }
+            const id = input.id.trim();
+            const activeProject = getActiveProject();
+            // Try to remove from project anchors first, then global
+            let removed = false;
+            let scope = 'unknown';
+            if (activeProject) {
+                const projectManager = getAnchorManager(String(activeProject.id));
+                if (projectManager.has(id)) {
+                    removed = projectManager.remove(id);
+                    scope = 'project';
+                }
+            }
+            if (!removed) {
+                const globalManager = getGlobalAnchorManager();
+                if (globalManager.has(id)) {
+                    removed = globalManager.remove(id);
+                    scope = 'global';
+                }
+            }
+            if (!removed) {
+                return Promise.resolve({
+                    success: false,
+                    error: `Anchor with ID "${id}" not found`,
+                });
+            }
+            return Promise.resolve({
+                success: true,
+                result: {
+                    id,
+                    scope,
+                    message: `Anchor removed successfully (was ${scope} scope)`,
+                },
+            });
+        }
+        catch (err) {
+            return Promise.resolve({
+                success: false,
+                error: `Failed to remove anchor: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    },
+});
+// =============================================================================
+// anchor_list Tool
+// =============================================================================
+export const anchorListTool = defineTool({
+    name: 'anchor_list',
+    description: 'List all anchors. Returns anchor IDs, content, priority, and scope. ' +
+        'Use this to see what persistent context is available before adding or removing anchors.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            scope: {
+                type: 'string',
+                enum: ['global', 'project', 'all'],
+                description: 'Filter by scope: "global", "project", or "all" (default: "all")',
+            },
+            priority: {
+                type: 'string',
+                enum: ['critical', 'safety', 'info'],
+                description: 'Filter by priority level',
+            },
+        },
+    },
+    execute: (input) => {
+        try {
+            const activeProject = getActiveProject();
+            const scope = input.scope ?? 'all';
+            const anchors = [];
+            // Collect global anchors
+            if (scope === 'global' || scope === 'all') {
+                const globalManager = getGlobalAnchorManager();
+                const globalAnchors = globalManager.getAll({ priority: input.priority });
+                for (const anchor of globalAnchors) {
+                    anchors.push({
+                        id: anchor.id,
+                        content: anchor.content,
+                        priority: anchor.priority,
+                        scope: 'global',
+                        tags: anchor.tags,
+                    });
+                }
+            }
+            // Collect project anchors
+            if ((scope === 'project' || scope === 'all') && activeProject) {
+                const projectManager = getAnchorManager(String(activeProject.id));
+                const projectAnchors = projectManager.getAll({ priority: input.priority });
+                for (const anchor of projectAnchors) {
+                    anchors.push({
+                        id: anchor.id,
+                        content: anchor.content,
+                        priority: anchor.priority,
+                        scope: 'project',
+                        tags: anchor.tags,
+                    });
+                }
+            }
+            // Sort by priority (critical first)
+            const priorityOrder = { critical: 0, safety: 1, info: 2 };
+            anchors.sort((a, b) => {
+                const pa = priorityOrder[a.priority] ?? 2;
+                const pb = priorityOrder[b.priority] ?? 2;
+                return pa - pb;
+            });
+            return Promise.resolve({
+                success: true,
+                result: {
+                    count: anchors.length,
+                    activeProject: activeProject?.displayName ?? null,
+                    anchors,
+                },
+            });
+        }
+        catch (err) {
+            return Promise.resolve({
+                success: false,
+                error: `Failed to list anchors: ${err instanceof Error ? err.message : String(err)}`,
+            });
+        }
+    },
+});
+// =============================================================================
+// Export all anchor tools
+// =============================================================================
+export const allAnchorTools = [anchorAddTool, anchorRemoveTool, anchorListTool];

package/dist/tools/backlog-wrappers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Backlog Tool Wrappers
+ *
+ * These wrappers provide `backlog_read` and `backlog_write` tools that skills expect,
+ * but internally delegate to the `workitem_*` database tools.
+ *
+ * This allows library skills (which reference backlog_*) to work seamlessly
+ * with the CLI's database-backed workitem system.
+ */
+interface BacklogReadInput {
+    /** Get a specific item by ID */
+    id?: string;
+    /** Filter by status */
+    status?: 'backlog' | 'in-progress' | 'done' | 'blocked';
+    /** Filter by type */
+    type?: 'feature' | 'bug' | 'chore' | 'spike';
+    /** Filter by priority */
+    priority?: 'critical' | 'high' | 'medium' | 'low';
+    /** Search in title and description */
+    search?: string;
+    /** Maximum items to return (default: 20) */
+    limit?: number;
+}
+export declare const backlogReadTool: import("@compilr-dev/agents").Tool<BacklogReadInput>;
+interface BacklogWriteInput {
+    /** Action to perform */
+    action: 'add' | 'update' | 'delete' | 'replace';
+    /** Item to add or update (required for add/update) */
+    item?: {
+        id?: string;
+        type?: 'feature' | 'bug' | 'chore' | 'spike';
+        title?: string;
+        description?: string;
+        status?: 'backlog' | 'in-progress' | 'done' | 'blocked';
+        priority?: 'critical' | 'high' | 'medium' | 'low';
+    };
+    /** Item ID to delete (required for delete) */
+    deleteId?: string;
+    /** Full list of items (required for replace action) */
+    items?: Array<{
+        id?: string;
+        type: 'feature' | 'bug' | 'chore' | 'spike';
+        title: string;
+        description?: string;
+        status?: 'backlog' | 'in-progress' | 'done' | 'blocked';
+        priority?: 'critical' | 'high' | 'medium' | 'low';
+    }>;
+}
+export declare const backlogWriteTool: import("@compilr-dev/agents").Tool<BacklogWriteInput>;
+/**
+ * All backlog wrapper tools
+ */
+export declare const backlogWrapperTools: (import("@compilr-dev/agents").Tool<BacklogReadInput> | import("@compilr-dev/agents").Tool<BacklogWriteInput>)[];
+export {};