@shepai/cli 1.2.0 → 1.3.0

package/README.md

@@ -57,7 +57,7 @@ This launches a TUI wizard to:
 
 1. Configure Claude Code authentication (setup token or use existing session)
 2. Start repository analysis
-3. Open the web UI at `http://localhost:3030/`
+3. Open the web UI at `http://localhost:3000/`
 
 ## How It Works
 
@@ -148,7 +148,7 @@ Uses **Repository Pattern** with SQLite:
 | Package Manager | pnpm                                                                                    |
 | CLI Framework   | Commander                                                                               |
 | TUI Framework   | [OpenTUI](https://opentui.com/)                                                         |
-| Web UI          | Next.js + shadcn/ui                                                                     |
+| Web UI          | Next.js 16 + React 19 + shadcn/ui ([@shepai/web](./src/presentation/web/))              |
 | Design System   | Storybook                                                                               |
 | Build Tool      | Vite                                                                                    |
 | Database        | SQLite                                                                                  |
@@ -157,19 +157,36 @@ Uses **Repository Pattern** with SQLite:
 | Embeddings      | [Transformers.js](https://huggingface.co/docs/transformers.js) (local, multiple models) |
 | Testing         | Vitest (unit/integration) + Playwright (e2e)                                            |
 | Methodology     | TDD (Red-Green-Refactor)                                                                |
+| Security        | Trivy, Gitleaks, Semgrep, Hadolint (CI gates)                                           |
+
+## Security
+
+Automated security scanning runs on every push and PR:
+
+| Scanner      | Purpose                                    |
+| ------------ | ------------------------------------------ |
+| **Trivy**    | Dependency & container vulnerability scans |
+| **Gitleaks** | Secret detection in git history            |
+| **Semgrep**  | SAST for TypeScript/JavaScript             |
+| **Hadolint** | Dockerfile best practices                  |
+
+Security gates **block releases** on main—all scanners must pass before npm publish and Docker push.
+
+See [CI/CD Documentation](./docs/development/cicd.md) for details.
 
 ## Documentation
 
-| Document                                           | Description                        |
-| -------------------------------------------------- | ---------------------------------- |
-| [CLAUDE.md](./CLAUDE.md)                           | Guidance for Claude Code instances |
-| [AGENTS.md](./AGENTS.md)                           | Agent system architecture          |
-| [CONTRIBUTING-AGENTS.md](./CONTRIBUTING-AGENTS.md) | AI agent contribution guidelines   |
-| [Architecture](./docs/architecture/)               | System design and patterns         |
-| [Concepts](./docs/concepts/)                       | Core domain concepts               |
-| [Guides](./docs/guides/)                           | User guides and tutorials          |
-| [Development](./docs/development/)                 | Contributing and development setup |
-| [API Reference](./docs/api/)                       | Interface and model documentation  |
+| Document                                           | Description                           |
+| -------------------------------------------------- | ------------------------------------- |
+| [CLAUDE.md](./CLAUDE.md)                           | Guidance for Claude Code instances    |
+| [AGENTS.md](./AGENTS.md)                           | Agent system architecture             |
+| [CONTRIBUTING-AGENTS.md](./CONTRIBUTING-AGENTS.md) | AI agent contribution guidelines      |
+| [Architecture](./docs/architecture/)               | System design and patterns            |
+| [Concepts](./docs/concepts/)                       | Core domain concepts                  |
+| [UI](./docs/ui/)                                   | Web UI architecture and design system |
+| [Guides](./docs/guides/)                           | User guides and tutorials             |
+| [Development](./docs/development/)                 | Contributing and development setup    |
+| [API Reference](./docs/api/)                       | Interface and model documentation     |
 
 ## Contributing
 

package/dist/eslint.config.d.mts

@@ -0,0 +1,3 @@
+declare const _default: import("typescript-eslint").FlatConfig.ConfigArray;
+export default _default;
+//# sourceMappingURL=eslint.config.d.mts.map

package/dist/eslint.config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eslint.config.d.mts","sourceRoot":"","sources":["../eslint.config.mjs"],"names":[],"mappings":""}

package/dist/eslint.config.mjs

@@ -0,0 +1,188 @@
+// @ts-check
+/**
+ * ESLint Flat Config for Shep AI CLI
+ *
+ * This configuration uses ESLint 9+ flat config format with TypeScript support.
+ * It's designed to be scalable and maintainable for a large open source project.
+ *
+ * @see https://eslint.org/docs/latest/use/configure/configuration-files
+ * @see https://typescript-eslint.io/getting-started/
+ */
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import prettierConfig from 'eslint-config-prettier';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import nextPlugin from '@next/eslint-plugin-next';
+export default tseslint.config(
+// =============================================================================
+// Global ignores (replaces .eslintignore)
+// =============================================================================
+{
+    ignores: [
+        // Build outputs
+        'dist/**',
+        'build/**',
+        '**/.next/**',
+        'out/**',
+        '**/storybook-static/**',
+        // Dependencies
+        'node_modules/**',
+        // Generated files
+        'apis/**',
+        '*.generated.*',
+        'coverage/**',
+        'next-env.d.ts',
+        'src/domain/generated/**', // TypeSpec-generated domain models
+        // TypeSpec (handled by tsp linter)
+        'tsp/**',
+        // Test outputs
+        'test-results/**',
+        'playwright-report/**',
+        // Config files that don't need linting
+        '*.config.js',
+        '*.config.mjs',
+        '*.config.cjs',
+    ],
+}, 
+// =============================================================================
+// Base ESLint recommended rules
+// =============================================================================
+eslint.configs.recommended, 
+// =============================================================================
+// TypeScript recommended rules
+// =============================================================================
+...tseslint.configs.recommended, ...tseslint.configs.stylistic, 
+// =============================================================================
+// Project-specific TypeScript rules
+// =============================================================================
+{
+    files: ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'],
+    languageOptions: {
+        parserOptions: {
+            projectService: true,
+            tsconfigRootDir: import.meta.dirname,
+        },
+    },
+    rules: {
+        // -------------------------------------------------------------------------
+        // TypeScript-specific rules
+        // -------------------------------------------------------------------------
+        // Prefer type-only imports for types (tree-shaking friendly)
+        '@typescript-eslint/consistent-type-imports': [
+            'warn',
+            {
+                prefer: 'type-imports',
+                fixStyle: 'inline-type-imports',
+            },
+        ],
+        // Require explicit return types on public methods
+        '@typescript-eslint/explicit-function-return-type': 'off',
+        '@typescript-eslint/explicit-module-boundary-types': 'off',
+        // Allow unused vars with underscore prefix
+        '@typescript-eslint/no-unused-vars': [
+            'warn',
+            {
+                argsIgnorePattern: '^_',
+                varsIgnorePattern: '^_',
+                caughtErrorsIgnorePattern: '^_',
+            },
+        ],
+        // Prefer nullish coalescing
+        '@typescript-eslint/prefer-nullish-coalescing': 'warn',
+        // Prefer optional chaining
+        '@typescript-eslint/prefer-optional-chain': 'warn',
+        // No floating promises (must handle or void)
+        '@typescript-eslint/no-floating-promises': 'off', // Enable when typed linting is set up
+        // No misused promises
+        '@typescript-eslint/no-misused-promises': 'off', // Enable when typed linting is set up
+        // -------------------------------------------------------------------------
+        // General code quality rules
+        // -------------------------------------------------------------------------
+        // Enforce consistent brace style
+        curly: ['warn', 'all'],
+        // Require === and !==
+        eqeqeq: ['error', 'always', { null: 'ignore' }],
+        // No console in production code (warn for now)
+        'no-console': 'warn',
+        // No debugger statements
+        'no-debugger': 'error',
+        // Prefer const over let when variable is not reassigned
+        'prefer-const': 'warn',
+        // Prefer template literals over string concatenation
+        'prefer-template': 'warn',
+        // No var, use let or const
+        'no-var': 'error',
+    },
+}, 
+// =============================================================================
+// JavaScript files (no TypeScript rules)
+// =============================================================================
+{
+    files: ['**/*.js', '**/*.mjs', '**/*.cjs'],
+    ...tseslint.configs.disableTypeChecked,
+}, 
+// =============================================================================
+// CLI presentation layer - allow console statements (intentional user output)
+// =============================================================================
+{
+    files: ['src/presentation/cli/**/*.ts'],
+    rules: {
+        'no-console': 'off',
+    },
+}, 
+// =============================================================================
+// Test files - relaxed rules
+// =============================================================================
+{
+    files: ['**/*.test.ts', '**/*.spec.ts', '**/tests/**/*.ts'],
+    rules: {
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-non-null-assertion': 'off',
+        'no-console': 'off',
+    },
+}, 
+// =============================================================================
+// React/Next.js configuration for web presentation layer
+// =============================================================================
+{
+    files: ['src/presentation/web/**/*.tsx', 'src/presentation/web/**/*.ts'],
+    plugins: {
+        react: reactPlugin,
+        'react-hooks': reactHooksPlugin,
+        '@next/next': nextPlugin,
+    },
+    languageOptions: {
+        parserOptions: {
+            ecmaFeatures: {
+                jsx: true,
+            },
+        },
+    },
+    settings: {
+        react: {
+            version: 'detect',
+        },
+    },
+    rules: {
+        // React rules
+        'react/jsx-uses-react': 'off', // Not needed with React 19 JSX transform
+        'react/react-in-jsx-scope': 'off', // Not needed with React 19 JSX transform
+        'react/prop-types': 'off', // Using TypeScript for prop types
+        'react/jsx-no-target-blank': 'error',
+        'react/jsx-key': 'error',
+        'react/no-array-index-key': 'warn',
+        'react/self-closing-comp': 'warn',
+        // React Hooks rules
+        'react-hooks/rules-of-hooks': 'error',
+        'react-hooks/exhaustive-deps': 'warn',
+        // Next.js rules
+        '@next/next/no-html-link-for-pages': 'error',
+        '@next/next/no-img-element': 'warn',
+        '@next/next/no-sync-scripts': 'error',
+    },
+}, 
+// =============================================================================
+// Prettier compatibility (must be last)
+// =============================================================================
+prettierConfig);

package/dist/src/application/ports/output/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Application Output Ports Module
+ *
+ * Exports repository interfaces (output ports) for the Application layer.
+ * Infrastructure layer provides concrete implementations.
+ */
+export type { ISettingsRepository } from './settings.repository.interface.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/application/ports/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/application/ports/output/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/src/application/ports/output/index.js

@@ -0,0 +1,7 @@
+/**
+ * Application Output Ports Module
+ *
+ * Exports repository interfaces (output ports) for the Application layer.
+ * Infrastructure layer provides concrete implementations.
+ */
+export {};

package/dist/src/application/ports/output/settings.repository.interface.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Settings Repository Interface
+ *
+ * Output port for Settings persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+import type { Settings } from '../../../domain/generated/output.js';
+/**
+ * Repository interface for Settings entity persistence.
+ *
+ * Implementations must:
+ * - Enforce singleton pattern (only one Settings record allowed)
+ * - Handle database connection management
+ * - Provide thread-safe operations
+ */
+export interface ISettingsRepository {
+    /**
+     * Initialize settings for the first time.
+     * Creates a new Settings record in the database.
+     *
+     * @param settings - The settings to initialize with
+     * @throws Error if settings already exist (singleton constraint)
+     */
+    initialize(settings: Settings): Promise<void>;
+    /**
+     * Load existing settings from the database.
+     *
+     * @returns The existing Settings or null if not initialized
+     */
+    load(): Promise<Settings | null>;
+    /**
+     * Update existing settings in the database.
+     *
+     * @param settings - The updated settings to persist
+     * @throws Error if settings don't exist (must initialize first)
+     */
+    update(settings: Settings): Promise<void>;
+}
+//# sourceMappingURL=settings.repository.interface.d.ts.map

package/dist/src/application/ports/output/settings.repository.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.repository.interface.d.ts","sourceRoot":"","sources":["../../../../../src/application/ports/output/settings.repository.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAEjC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C"}

package/dist/src/application/ports/output/settings.repository.interface.js

@@ -0,0 +1,11 @@
+/**
+ * Settings Repository Interface
+ *
+ * Output port for Settings persistence operations.
+ * Implementations handle database-specific logic (SQLite, etc.).
+ *
+ * Following Clean Architecture:
+ * - Domain and Application layers depend on this interface
+ * - Infrastructure layer provides concrete implementations
+ */
+export {};

package/dist/src/application/use-cases/settings/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Settings Use Cases Module
+ *
+ * Exports use cases for Settings entity operations.
+ */
+export { InitializeSettingsUseCase } from './initialize-settings.use-case.js';
+export { LoadSettingsUseCase } from './load-settings.use-case.js';
+export { UpdateSettingsUseCase } from './update-settings.use-case.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/application/use-cases/settings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/settings/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/src/application/use-cases/settings/index.js

@@ -0,0 +1,8 @@
+/**
+ * Settings Use Cases Module
+ *
+ * Exports use cases for Settings entity operations.
+ */
+export { InitializeSettingsUseCase } from './initialize-settings.use-case.js';
+export { LoadSettingsUseCase } from './load-settings.use-case.js';
+export { UpdateSettingsUseCase } from './update-settings.use-case.js';

package/dist/src/application/use-cases/settings/initialize-settings.use-case.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Initialize Settings Use Case
+ *
+ * Handles first-time settings initialization.
+ * Creates default settings if none exist, or returns existing settings.
+ *
+ * Business Rules:
+ * - Only one Settings record allowed (singleton pattern)
+ * - Uses factory defaults for initial values
+ * - Idempotent: safe to call multiple times
+ */
+import type { Settings } from '../../../domain/generated/output.js';
+import type { ISettingsRepository } from '../../ports/output/settings.repository.interface.js';
+/**
+ * Use case for initializing global settings.
+ *
+ * Algorithm:
+ * 1. Check if settings already exist (load from repository)
+ * 2. If exists, return existing settings
+ * 3. If not exists, create defaults and initialize in repository
+ * 4. Return newly created settings
+ */
+export declare class InitializeSettingsUseCase {
+    private readonly settingsRepository;
+    constructor(settingsRepository: ISettingsRepository);
+    /**
+     * Execute the initialize settings use case.
+     *
+     * @returns Existing or newly created Settings
+     */
+    execute(): Promise<Settings>;
+}
+//# sourceMappingURL=initialize-settings.use-case.d.ts.map

package/dist/src/application/use-cases/settings/initialize-settings.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize-settings.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/settings/initialize-settings.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAG/F;;;;;;;;GAQG;AACH,qBACa,yBAAyB;IAGlC,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAG1D;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;CAgBnC"}

package/dist/src/application/use-cases/settings/initialize-settings.use-case.js

@@ -0,0 +1,63 @@
+/**
+ * Initialize Settings Use Case
+ *
+ * Handles first-time settings initialization.
+ * Creates default settings if none exist, or returns existing settings.
+ *
+ * Business Rules:
+ * - Only one Settings record allowed (singleton pattern)
+ * - Uses factory defaults for initial values
+ * - Idempotent: safe to call multiple times
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+import { createDefaultSettings } from '../../../domain/factories/settings-defaults.factory.js';
+/**
+ * Use case for initializing global settings.
+ *
+ * Algorithm:
+ * 1. Check if settings already exist (load from repository)
+ * 2. If exists, return existing settings
+ * 3. If not exists, create defaults and initialize in repository
+ * 4. Return newly created settings
+ */
+let InitializeSettingsUseCase = class InitializeSettingsUseCase {
+    settingsRepository;
+    constructor(settingsRepository) {
+        this.settingsRepository = settingsRepository;
+    }
+    /**
+     * Execute the initialize settings use case.
+     *
+     * @returns Existing or newly created Settings
+     */
+    async execute() {
+        // Check if settings already exist
+        const existingSettings = await this.settingsRepository.load();
+        if (existingSettings) {
+            return existingSettings;
+        }
+        // Create new settings with defaults
+        const newSettings = createDefaultSettings();
+        // Persist to database
+        await this.settingsRepository.initialize(newSettings);
+        return newSettings;
+    }
+};
+InitializeSettingsUseCase = __decorate([
+    injectable(),
+    __param(0, inject('ISettingsRepository')),
+    __metadata("design:paramtypes", [Object])
+], InitializeSettingsUseCase);
+export { InitializeSettingsUseCase };

package/dist/src/application/use-cases/settings/load-settings.use-case.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Load Settings Use Case
+ *
+ * Retrieves existing settings from the database.
+ * Throws error if settings don't exist (must initialize first).
+ *
+ * Business Rules:
+ * - Settings must be initialized before loading
+ * - Returns complete Settings object
+ * - Read-only operation (no mutations)
+ */
+import type { Settings } from '../../../domain/generated/output.js';
+import type { ISettingsRepository } from '../../ports/output/settings.repository.interface.js';
+/**
+ * Use case for loading existing settings.
+ *
+ * Algorithm:
+ * 1. Load settings from repository
+ * 2. If not found, throw error with helpful message
+ * 3. Return settings
+ */
+export declare class LoadSettingsUseCase {
+    private readonly settingsRepository;
+    constructor(settingsRepository: ISettingsRepository);
+    /**
+     * Execute the load settings use case.
+     *
+     * @returns Existing Settings
+     * @throws Error if settings don't exist
+     */
+    execute(): Promise<Settings>;
+}
+//# sourceMappingURL=load-settings.use-case.d.ts.map

package/dist/src/application/use-cases/settings/load-settings.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-settings.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/settings/load-settings.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAE/F;;;;;;;GAOG;AACH,qBACa,mBAAmB;IAG5B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAG1D;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;CASnC"}

package/dist/src/application/use-cases/settings/load-settings.use-case.js

@@ -0,0 +1,57 @@
+/**
+ * Load Settings Use Case
+ *
+ * Retrieves existing settings from the database.
+ * Throws error if settings don't exist (must initialize first).
+ *
+ * Business Rules:
+ * - Settings must be initialized before loading
+ * - Returns complete Settings object
+ * - Read-only operation (no mutations)
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'tsyringe';
+/**
+ * Use case for loading existing settings.
+ *
+ * Algorithm:
+ * 1. Load settings from repository
+ * 2. If not found, throw error with helpful message
+ * 3. Return settings
+ */
+let LoadSettingsUseCase = class LoadSettingsUseCase {
+    settingsRepository;
+    constructor(settingsRepository) {
+        this.settingsRepository = settingsRepository;
+    }
+    /**
+     * Execute the load settings use case.
+     *
+     * @returns Existing Settings
+     * @throws Error if settings don't exist
+     */
+    async execute() {
+        const settings = await this.settingsRepository.load();
+        if (!settings) {
+            throw new Error('Settings not found. Please run initialization first.');
+        }
+        return settings;
+    }
+};
+LoadSettingsUseCase = __decorate([
+    injectable(),
+    __param(0, inject('ISettingsRepository')),
+    __metadata("design:paramtypes", [Object])
+], LoadSettingsUseCase);
+export { LoadSettingsUseCase };

package/dist/src/application/use-cases/settings/update-settings.use-case.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Update Settings Use Case
+ *
+ * Updates existing settings in the database.
+ * Validates input and persists changes.
+ *
+ * Business Rules:
+ * - Settings must exist before updating
+ * - All fields are updatable
+ * - Returns updated settings after persistence
+ */
+import type { Settings } from '../../../domain/generated/output.js';
+import type { ISettingsRepository } from '../../ports/output/settings.repository.interface.js';
+/**
+ * Use case for updating existing settings.
+ *
+ * Algorithm:
+ * 1. Receive updated settings
+ * 2. Persist to repository
+ * 3. Return updated settings
+ */
+export declare class UpdateSettingsUseCase {
+    private readonly settingsRepository;
+    constructor(settingsRepository: ISettingsRepository);
+    /**
+     * Execute the update settings use case.
+     *
+     * @param settings - The updated settings to persist
+     * @returns The updated Settings
+     */
+    execute(settings: Settings): Promise<Settings>;
+}
+//# sourceMappingURL=update-settings.use-case.d.ts.map

package/dist/src/application/use-cases/settings/update-settings.use-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-settings.use-case.d.ts","sourceRoot":"","sources":["../../../../../src/application/use-cases/settings/update-settings.use-case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAE/F;;;;;;;GAOG;AACH,qBACa,qBAAqB;IAG9B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,mBAAmB;IAG1D;;;;;OAKG;IACG,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;CAOrD"}