@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/settings/index.d.ts

@@ -9,6 +9,9 @@ export type NotificationMode = 'auto' | 'enabled' | 'disabled';
 export type OutputStyle = 'default' | 'compact' | 'verbose';
 export type EditorMode = 'normal' | 'vim' | 'emacs';
 export type ProviderType = 'auto' | 'claude' | 'openai' | 'gemini' | 'ollama';
+export type StartupMode = 'menu' | 'repl';
+export type ProjectStartupMode = 'last' | 'off';
+export type MascotSetting = 'none' | 'random' | 'neutral' | 'thinking' | 'looking_left' | 'looking_right' | 'sleeping' | 'alert' | 'error' | 'success' | 'success_minimal' | 'searching' | 'skeptical';
 export interface Settings {
     theme?: string;
     defaultProvider: ProviderType;
@@ -24,6 +27,10 @@ export interface Settings {
     notifications: NotificationMode;
     outputStyle: OutputStyle;
     editorMode: EditorMode;
+    startupMode: StartupMode;
+    projectStartup: ProjectStartupMode;
+    lastProjectId: number | null;
+    mascot: MascotSetting;
 }
 /**
  * Get all settings (cached)
@@ -62,6 +69,14 @@ export declare const getPermissionMode: () => PermissionMode;
 export declare const getNotificationMode: () => NotificationMode;
 export declare const getOutputStyle: () => OutputStyle;
 export declare const getEditorMode: () => EditorMode;
+export declare const getStartupMode: () => StartupMode;
+export declare const getProjectStartupMode: () => ProjectStartupMode;
+export declare const getLastProjectId: () => number | null;
+export declare const getMascotSetting: () => MascotSetting;
+/**
+ * Remember the last opened project (for 'last' mode)
+ */
+export declare function setLastProjectId(projectId: number): void;
 /**
  * Map internal permission mode to display value
  */
@@ -78,3 +93,11 @@ export declare function notificationModeToDisplay(mode: NotificationMode): strin
  * Map display value to internal notification mode
  */
 export declare function displayToNotificationMode(display: string): NotificationMode;
+/**
+ * Map internal project startup mode to display value
+ */
+export declare function projectStartupModeToDisplay(mode: ProjectStartupMode): string;
+/**
+ * Map display value to internal project startup mode
+ */
+export declare function displayToProjectStartupMode(display: string): ProjectStartupMode;

package/dist/settings/index.js

@@ -33,6 +33,13 @@ const DEFAULT_SETTINGS = {
     notifications: 'auto',
     outputStyle: 'default',
     editorMode: 'normal',
+    // Startup default
+    startupMode: 'menu',
+    // Project startup defaults
+    projectStartup: 'last', // Default: load last opened project
+    lastProjectId: null,
+    // Mascot default
+    mascot: 'neutral', // Default: show neutral mascot with logo
 };
 // =============================================================================
 // In-memory cache
@@ -80,6 +87,12 @@ export function getSettings() {
     }
     const stored = loadFromDisk();
     settingsCache = { ...DEFAULT_SETTINGS, ...stored };
+    // Migration: convert deprecated 'cwd' to 'off'
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    if (settingsCache.projectStartup === 'cwd') {
+        settingsCache.projectStartup = 'off';
+        saveToDisk(settingsCache);
+    }
     return settingsCache;
 }
 /**
@@ -138,6 +151,19 @@ export const getPermissionMode = () => getSetting('permissionMode');
 export const getNotificationMode = () => getSetting('notifications');
 export const getOutputStyle = () => getSetting('outputStyle');
 export const getEditorMode = () => getSetting('editorMode');
+// Startup getter
+export const getStartupMode = () => getSetting('startupMode');
+// Project startup getters
+export const getProjectStartupMode = () => getSetting('projectStartup');
+export const getLastProjectId = () => getSetting('lastProjectId');
+// Mascot getter
+export const getMascotSetting = () => getSetting('mascot');
+/**
+ * Remember the last opened project (for 'last' mode)
+ */
+export function setLastProjectId(projectId) {
+    setSetting('lastProjectId', projectId);
+}
 // =============================================================================
 // Display Value Mappers (for config overlay)
 // =============================================================================
@@ -193,3 +219,25 @@ export function displayToNotificationMode(display) {
             return 'auto';
     }
 }
+/**
+ * Map internal project startup mode to display value
+ */
+export function projectStartupModeToDisplay(mode) {
+    switch (mode) {
+        case 'last':
+            return 'Last opened';
+        case 'off':
+            return 'Off';
+    }
+}
+/**
+ * Map display value to internal project startup mode
+ */
+export function displayToProjectStartupMode(display) {
+    switch (display) {
+        case 'Off':
+            return 'off';
+        default:
+            return 'last';
+    }
+}

package/dist/settings/paths.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Path Configuration Module
+ *
+ * Centralized path configuration with safety guards.
+ * Inspired by ATLAS CLI config/index.ts
+ *
+ * Priority order:
+ * 1. Environment variable (COMPILR_*)
+ * 2. Config file (~/.compilr-dev/settings.json)
+ * 3. Default/derived value
+ */
+export interface PathConfig {
+    workspacePath?: string;
+    projectsPath?: string;
+    dataPath?: string;
+    allowedPaths?: string[];
+    requireProjectMatch?: boolean;
+    deleteProtection?: boolean;
+}
+export interface ResolvedPathConfig {
+    workspacePath: string;
+    projectsPath: string;
+    dataPath: string;
+    allowedPaths: string[];
+    requireProjectMatch: boolean;
+    deleteProtection: boolean;
+}
+/**
+ * Get the data directory (where config, DB, credentials live)
+ * Priority: ENV > config > default
+ */
+export declare function getDataPath(): string;
+/**
+ * Get the workspace root directory
+ * Priority: ENV > config > default
+ */
+export declare function getWorkspacePath(): string;
+/**
+ * Get the projects directory
+ * Priority: ENV > config > derived from workspace
+ */
+export declare function getProjectsPath(): string;
+/**
+ * Get all allowed paths for delete operations
+ */
+export declare function getAllowedDeletePaths(): string[];
+/**
+ * Check if delete protection is enabled (default: true)
+ */
+export declare function isDeleteProtectionEnabled(): boolean;
+/**
+ * Check if project match warning is enabled (default: true)
+ */
+export declare function isProjectMatchRequired(): boolean;
+/**
+ * Get resolved configuration for display
+ */
+export declare function getResolvedPathConfig(): ResolvedPathConfig;
+/**
+ * Set workspace path
+ */
+export declare function setWorkspacePath(p: string): void;
+/**
+ * Set projects path
+ */
+export declare function setProjectsPath(p: string): void;
+/**
+ * Set data path
+ */
+export declare function setDataPath(p: string): void;
+/**
+ * Enable/disable delete protection
+ */
+export declare function setDeleteProtection(enabled: boolean): void;
+/**
+ * Enable/disable project match warning
+ */
+export declare function setProjectMatchRequired(enabled: boolean): void;
+/**
+ * Add an allowed path for delete operations
+ */
+export declare function addAllowedPath(p: string): void;
+/**
+ * Remove an allowed path
+ */
+export declare function removeAllowedPath(p: string): void;
+/**
+ * Clear all custom allowed paths
+ */
+export declare function clearAllowedPaths(): void;
+/**
+ * Get the database file path
+ */
+export declare function getDatabasePath(): string;
+/**
+ * Get the credentials file path
+ */
+export declare function getCredentialsPath(): string;
+/**
+ * Get the settings file path
+ */
+export declare function getSettingsPath(): string;
+/**
+ * Ensure data directory exists
+ */
+export declare function ensureDataDirectory(): void;
+/**
+ * Ensure projects directory exists
+ */
+export declare function ensureProjectsDirectory(): void;

package/dist/settings/paths.js

@@ -0,0 +1,264 @@
+/**
+ * Path Configuration Module
+ *
+ * Centralized path configuration with safety guards.
+ * Inspired by ATLAS CLI config/index.ts
+ *
+ * Priority order:
+ * 1. Environment variable (COMPILR_*)
+ * 2. Config file (~/.compilr-dev/settings.json)
+ * 3. Default/derived value
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// =============================================================================
+// Constants
+// =============================================================================
+const CONFIG_DIR = path.join(os.homedir(), '.compilr-dev');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'settings.json');
+const DEFAULT_DATA_PATH = CONFIG_DIR;
+const DEFAULT_WORKSPACE_PATH = os.homedir();
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Load path config from disk
+ */
+function loadPathConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const data = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            const settings = JSON.parse(data);
+            return {
+                workspacePath: settings.workspacePath,
+                projectsPath: settings.projectsPath,
+                dataPath: settings.dataPath,
+                allowedPaths: settings.allowedPaths,
+                requireProjectMatch: settings.requireProjectMatch,
+                deleteProtection: settings.deleteProtection,
+            };
+        }
+    }
+    catch {
+        // Ignore errors, return empty config
+    }
+    return {};
+}
+/**
+ * Save path config to disk (merges with existing settings)
+ */
+function savePathConfig(pathConfig) {
+    try {
+        let existingSettings = {};
+        if (fs.existsSync(CONFIG_FILE)) {
+            const data = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            existingSettings = JSON.parse(data);
+        }
+        const merged = { ...existingSettings, ...pathConfig };
+        fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2), 'utf-8');
+    }
+    catch (error) {
+        console.error('Failed to save path config:', error);
+    }
+}
+/**
+ * Expand ~ to home directory and resolve path
+ */
+function expandPath(p) {
+    if (p.startsWith('~/')) {
+        return path.join(os.homedir(), p.slice(2));
+    }
+    return path.resolve(p);
+}
+// =============================================================================
+// Public API - Getters
+// =============================================================================
+/**
+ * Get the data directory (where config, DB, credentials live)
+ * Priority: ENV > config > default
+ */
+export function getDataPath() {
+    if (process.env.COMPILR_DATA_PATH) {
+        return expandPath(process.env.COMPILR_DATA_PATH);
+    }
+    const config = loadPathConfig();
+    return config.dataPath ? expandPath(config.dataPath) : DEFAULT_DATA_PATH;
+}
+/**
+ * Get the workspace root directory
+ * Priority: ENV > config > default
+ */
+export function getWorkspacePath() {
+    if (process.env.COMPILR_WORKSPACE_PATH) {
+        return expandPath(process.env.COMPILR_WORKSPACE_PATH);
+    }
+    const config = loadPathConfig();
+    return config.workspacePath ? expandPath(config.workspacePath) : DEFAULT_WORKSPACE_PATH;
+}
+/**
+ * Get the projects directory
+ * Priority: ENV > config > derived from workspace
+ */
+export function getProjectsPath() {
+    if (process.env.COMPILR_PROJECTS_PATH) {
+        return expandPath(process.env.COMPILR_PROJECTS_PATH);
+    }
+    const config = loadPathConfig();
+    return config.projectsPath ? expandPath(config.projectsPath) : path.join(getWorkspacePath(), 'projects');
+}
+/**
+ * Get all allowed paths for delete operations
+ */
+export function getAllowedDeletePaths() {
+    const config = loadPathConfig();
+    const paths = [getProjectsPath()];
+    if (config.allowedPaths) {
+        paths.push(...config.allowedPaths.map(expandPath));
+    }
+    return paths.map((p) => path.resolve(p));
+}
+/**
+ * Check if delete protection is enabled (default: true)
+ */
+export function isDeleteProtectionEnabled() {
+    const config = loadPathConfig();
+    return config.deleteProtection ?? true;
+}
+/**
+ * Check if project match warning is enabled (default: true)
+ */
+export function isProjectMatchRequired() {
+    const config = loadPathConfig();
+    return config.requireProjectMatch ?? true;
+}
+/**
+ * Get resolved configuration for display
+ */
+export function getResolvedPathConfig() {
+    const config = loadPathConfig();
+    return {
+        workspacePath: getWorkspacePath(),
+        projectsPath: getProjectsPath(),
+        dataPath: getDataPath(),
+        allowedPaths: config.allowedPaths?.map(expandPath) || [],
+        requireProjectMatch: config.requireProjectMatch ?? true,
+        deleteProtection: config.deleteProtection ?? true,
+    };
+}
+// =============================================================================
+// Public API - Setters
+// =============================================================================
+/**
+ * Set workspace path
+ */
+export function setWorkspacePath(p) {
+    const config = loadPathConfig();
+    config.workspacePath = expandPath(p);
+    savePathConfig(config);
+}
+/**
+ * Set projects path
+ */
+export function setProjectsPath(p) {
+    const config = loadPathConfig();
+    config.projectsPath = expandPath(p);
+    savePathConfig(config);
+}
+/**
+ * Set data path
+ */
+export function setDataPath(p) {
+    const config = loadPathConfig();
+    config.dataPath = expandPath(p);
+    savePathConfig(config);
+}
+/**
+ * Enable/disable delete protection
+ */
+export function setDeleteProtection(enabled) {
+    const config = loadPathConfig();
+    config.deleteProtection = enabled;
+    savePathConfig(config);
+}
+/**
+ * Enable/disable project match warning
+ */
+export function setProjectMatchRequired(enabled) {
+    const config = loadPathConfig();
+    config.requireProjectMatch = enabled;
+    savePathConfig(config);
+}
+/**
+ * Add an allowed path for delete operations
+ */
+export function addAllowedPath(p) {
+    const config = loadPathConfig();
+    const normalized = expandPath(p);
+    if (!config.allowedPaths) {
+        config.allowedPaths = [];
+    }
+    if (!config.allowedPaths.includes(normalized)) {
+        config.allowedPaths.push(normalized);
+        savePathConfig(config);
+    }
+}
+/**
+ * Remove an allowed path
+ */
+export function removeAllowedPath(p) {
+    const config = loadPathConfig();
+    const normalized = expandPath(p);
+    if (config.allowedPaths) {
+        config.allowedPaths = config.allowedPaths.filter((existing) => expandPath(existing) !== normalized);
+        savePathConfig(config);
+    }
+}
+/**
+ * Clear all custom allowed paths
+ */
+export function clearAllowedPaths() {
+    const config = loadPathConfig();
+    config.allowedPaths = [];
+    savePathConfig(config);
+}
+// =============================================================================
+// Utility Functions
+// =============================================================================
+/**
+ * Get the database file path
+ */
+export function getDatabasePath() {
+    return path.join(getDataPath(), 'projects.db');
+}
+/**
+ * Get the credentials file path
+ */
+export function getCredentialsPath() {
+    return path.join(getDataPath(), 'credentials.enc');
+}
+/**
+ * Get the settings file path
+ */
+export function getSettingsPath() {
+    return path.join(getDataPath(), 'settings.json');
+}
+/**
+ * Ensure data directory exists
+ */
+export function ensureDataDirectory() {
+    const dataPath = getDataPath();
+    if (!fs.existsSync(dataPath)) {
+        fs.mkdirSync(dataPath, { recursive: true });
+    }
+}
+/**
+ * Ensure projects directory exists
+ */
+export function ensureProjectsDirectory() {
+    const projectsPath = getProjectsPath();
+    if (!fs.existsSync(projectsPath)) {
+        fs.mkdirSync(projectsPath, { recursive: true });
+    }
+}

package/dist/templates/compilr-md.js

@@ -163,14 +163,15 @@ function generateSingleRepoStructure() {
     return `\`\`\`
 {project}/
 ├── .compilr/              # Workflow files
-│   ├── backlog.md         # Task tracking
 │   ├── architecture/      # ADRs, coding standards
 │   └── sessions/          # Session notes
 ├── src/                   # Source code
 ├── COMPILR.md             # This file
 ├── package.json
 └── README.md
-\`\`\``;
+\`\`\`
+
+**Note:** Backlog/tasks are tracked in the compilr database. Use \`/backlog\` command to view.`;
 }
 function generateTwoRepoStructure(name) {
     return `\`\`\`
@@ -182,8 +183,10 @@ ${name}/                   # Code repository
 ${name}-docs/              # Documentation repository
 ├── .compilr/
 ├── COMPILR.md             # This file
-├── 01-planning/           # Backlog, roadmap
+├── 01-planning/           # Roadmap
 ├── 02-architecture/       # ADRs, standards
 └── 04-session-notes/      # Session history
-\`\`\``;
+\`\`\`
+
+**Note:** Backlog/tasks are tracked in the compilr database. Use \`/backlog\` command to view.`;
 }

package/dist/templates/index.js

@@ -8,7 +8,7 @@ import * as path from 'path';
 import { execSync } from 'child_process';
 export * from './types.js';
 import { generateCompilrMd } from './compilr-md.js';
-import { generateBacklogMd } from './backlog-md.js';
+// generateBacklogMd removed - backlog is now tracked in database
 import { generateCodingStandardsMd } from './coding-standards.js';
 import { generateConfigJson } from './config-json.js';
 import { generateReadmeMd } from './readme-md.js';
@@ -67,9 +67,8 @@ function generateSingleRepoProject(config, basePath, filesCreated) {
         { path: path.join(projectPath, 'package.json'), content: generatePackageJson(config) },
         { path: path.join(projectPath, '.gitignore'), content: generateGitignore(config) },
         { path: path.join(projectPath, 'tsconfig.json'), content: generateTsconfig(config) },
-        // .compilr files
+        // .compilr files (backlog is now tracked in database, not as file)
         { path: path.join(projectPath, '.compilr', 'config.json'), content: generateConfigJson(config, projectPath) },
-        { path: path.join(projectPath, '.compilr', 'backlog.md'), content: generateBacklogMd(config) },
         { path: path.join(projectPath, '.compilr', 'roadmap.md'), content: generateRoadmapMd(config) },
         {
             path: path.join(projectPath, '.compilr', 'architecture', 'coding-standards.md'),
@@ -143,7 +142,7 @@ function generateTwoRepoProject(config, basePath, filesCreated) {
         { path: path.join(docsPath, 'COMPILR.md'), content: generateCompilrMd(config) },
         { path: path.join(docsPath, '.compilr', 'config.json'), content: generateConfigJson(config, projectPath, docsPath) },
         { path: path.join(docsPath, '00-requirements', 'PRD.md'), content: generatePrdMd(config) },
-        { path: path.join(docsPath, '01-planning', 'backlog.md'), content: generateBacklogMd(config) },
+        // backlog.md removed - backlog is now tracked in database
         { path: path.join(docsPath, '01-planning', 'roadmap.md'), content: generateRoadmapMd(config) },
         {
             path: path.join(docsPath, '02-architecture', 'coding-standards.md'),

package/dist/themes/colors.js

@@ -10,8 +10,10 @@
  *   console.log(s.primary('Hello'));  // Colored with theme's primary
  *   console.log(s.muted('dim text')); // Colored with theme's muted
  */
-import chalk from 'chalk';
+import { Chalk } from 'chalk';
 import { getCurrentTheme } from './registry.js';
+// Force color output (level 3 = 24-bit true color)
+const chalk = new Chalk({ level: 3 });
 // =============================================================================
 // Style Creation
 // =============================================================================

package/dist/themes/registry.d.ts

@@ -1,43 +1,12 @@
 /**
  * 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 type { Theme, ThemeConfig } from './types.js';
-/**
- * Get all available themes
- */
-export declare function getAllThemes(): Theme[];
-/**
- * Get curated/featured themes
- */
-export declare function getCuratedThemes(): Theme[];
-/**
- * Get theme by ID
- */
-export declare function getThemeById(id: string): Theme | undefined;
-/**
- * Search themes by name (case-insensitive)
- */
-export declare function searchThemes(query: string): Theme[];
-/**
- * Filter themes by type
- */
-export declare function filterThemesByType(type: 'all' | 'dark' | 'light'): Theme[];
-/**
- * Search and filter themes
- */
-export declare function searchAndFilterThemes(query: string, type: 'all' | 'dark' | 'light'): Theme[];
-/**
- * Get theme count
- */
-export declare function getThemeCount(): {
-    total: number;
-    dark: number;
-    light: number;
-    curated: number;
-};
+import type { ThemeConfig } from './types.js';
+import type { Theme } from '@compilr-dev/editor-core/themes';
+export { getAllThemes, getCuratedThemes, getThemeById, searchThemes, filterThemesByType, searchAndFilterThemes, getThemeStats as getThemeCount, } from '@compilr-dev/editor-core/themes';
 /**
  * Load theme config
  */