lightman_ai 0.21.1__tar.gz → 0.22.0__tar.gz

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lightman_ai
-Version: 0.21.1
+Version: 0.22.0
 Summary: LLM-powered cybersecurity news aggregator.
 Author-email: sdn4z <imsdn4z@gmail.com>
 License-File: LICENSE
@@ -18,7 +18,7 @@ Description-Content-Type: text/markdown
 
 # 🔍 Lightman AI
 
-> **AI-Powered Cybersecurity News Intelligence Platform*
+> LLM-Powered Cybersecurity News Intelligence Platform
 
 ---
 
@@ -49,7 +49,9 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
 
 ## 🚀 Quick Start
 
-### pip
+### Installation
+
+#### pip
 
 1. **Install Lightman AI**:
    ```bash
@@ -78,10 +80,13 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
    ```bash
    lightman run
    ```
+#### Docker
+1. **Pull the image**
+   ```bash
+   docker pull elementsinteractive/lightman-ai:latest
+   ```
 
-### Docker
-
-1. **Create configuration file**:
+2. **Create configuration file**:
    ```bash
    echo '[default]
    agent = "openai"
@@ -92,7 +97,7 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
    development = "Analyze cybersecurity news for relevance to our organization."' > lightman.toml
    ```
 
-2. **Run with Docker**:
+3. **Run with Docker**:
    ```bash
    docker run --rm \
      -v $(pwd)/lightman.toml:/app/lightman.toml \
@@ -101,55 +106,37 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
      lightman run --config-file /app/lightman.toml --score 7
    ```
 
-4. **View results**: Lightman will analyze cybersecurity news and output relevant articles that meet your score threshold.
-
-## 📥 Installation
-
-### Docker
-Lightman AI has an available Docker image on Docker Hub:
-
-```bash
-# Pull the latest image
-docker pull elementsinteractive/lightman-ai:latest
-
-# Create your configuration file
+## 🔧 Usage
 
-   echo '[default]
-   agent = "openai"
-   score_threshold = 8
-   prompt = "development"
-   
-   [prompts]
-   development = "Analyze cybersecurity news for relevance to our organization."' > lightman.toml
-   ```
+### CLI Options
 
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--agent` | AI agent to use (`openai`, `gemini`) | From config file |
+| `--score` | Minimum relevance score (1-10) | From config file |
+| `--prompt` | Prompt template name | From config file |
+| `--config-file` | Path to configuration file | `lightman.toml` |
+| `--config` | Configuration section to use | `default` |
+| `--env-file` | Path to environment variables file | `.env` |
+| `--dry-run` | Preview results without taking action | `false` |
+| `--prompt-file` | File containing prompt templates | `lightman.toml` |
+| `--start-date` | Start date to retrieve articles | False |
+| `--today` | Retrieve articles from today | False |
+| `--yesterday` | Retrieve articles from yesterday | False |
 
-# Run with mounted configuration
-```bash
-docker run -d \
-  --name lightman-ai \
-  -v $(pwd)/lightman.toml:/app/lightman.toml \
-  -e OPENAI_API_KEY="your-api-key" \
-  elementsinteractive/lightman-ai:latest \
-  lightman run --config-file /app/lightman.toml
-```
+### Environment Variables:
+lightman-ai uses the following environment variables:
 
-**Docker Environment Variables:**
 - `OPENAI_API_KEY` - Your OpenAI API key
 - `GOOGLE_API_KEY` - Your Google Gemini API key
 - `SERVICE_DESK_URL` - Service desk instance URL (optional)
 - `SERVICE_DESK_USER` - Service desk username (optional)
 - `SERVICE_DESK_TOKEN` - Service desk API token (optional)
+- `TIME_ZONE` - Your time zone (optional, defaults to UTC. i.e. "Europe/Amsterdam".)
 
+By default, it will try to load a `.env` file. You can also specify a different path with the `--env-file` option.
 
 
-### Development Installation
-```bash
-git clone git@github.com:elementsinteractive/lightman-ai.git
-cd lightman_ai
-just venv  # Creates virtual environment and installs dependencies
-```
-
 ## ⚙️ Configuration
 
 Lightman AI uses TOML configuration files for flexible setup. Create a `lightman.toml` file:
@@ -203,30 +190,8 @@ custom_prompt = """
 Your custom analysis prompt here...
 """
 ```
-### Environment Variables
-
-Set up your AI provider credentials:
-
-```bash
-# For OpenAI
-export OPENAI_API_KEY="your-openai-api-key"
-
-# For Google Gemini
-export GOOGLE_API_KEY="your-google-api-key"
-
-# Optional: Service desk integration
-export SERVICE_DESK_URL="https://your-company.atlassian.net"
-export SERVICE_DESK_USER="your-username"
-export SERVICE_DESK_TOKEN="your-api-token"
-
-```
-You can also specify a different path for your .env file with the `--env-file` option
-
-
-## 🔧 Usage
-
-### Basic Usage
 
+### Examples
 ```bash
 # Run with default settings
 lightman run
@@ -242,67 +207,30 @@ lightman run --env-file production.env --agent openai --score 8
 
 # Dry run (preview results without creating service desk tickets)
 lightman run --dry-run --agent openai --score 9
-```
 
-### Command Line Options
+# Retrieve all the news from today
+lightman run --agent openai --score 8 --prompt security_critical --today
 
-| Option | Description | Default |
-|--------|-------------|---------|
-| `--agent` | AI agent to use (`openai`, `gemini`) | From config file |
-| `--score` | Minimum relevance score (1-10) | From config file |
-| `--prompt` | Prompt template name | From config file |
-| `--config-file` | Path to configuration file | `lightman.toml` |
-| `--config` | Configuration section to use | `default` |
-| `--env-file` | Path to environment variables file | `.env` |
-| `--dry-run` | Preview results without taking action | `false` |
-| `--prompt-file` | File containing prompt templates | `lightman.toml` |
-
-### Example Workflows
-
-**Daily Security Monitoring**:
-```bash
-# Local installation
-lightman run --agent openai --score 8 --prompt security_critical
-
-# With custom environment file
-lightman run --env-file production.env --agent openai --score 8
-
-# Docker 
-docker run --rm \
-  -v $(pwd)/lightman.toml:/app/lightman.toml \
-  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
-  elementsinteractive/lightman-ai:latest \
-  lightman run --config-file /app/lightman.toml --score 8
+# Retrieve all the news from yesterday
+lightman run --agent openai --score 8 --prompt security_critical --yesterday
 ```
 
 
-**Weekly Risk Assessment**:
-```bash
-# Local installation
-lightman run --agent gemini --score 6 --prompt weekly_assessment
-
-# With environment-specific settings
-lightman run --env-file weekly.env --agent gemini --score 6
-
-# Docker 
-docker run --rm \
-  -v $(pwd)/lightman.toml:/app/lightman.toml \
-  -e GOOGLE_API_KEY="$GOOGLE_API_KEY" \
-  elementsinteractive/lightman-ai:latest \
-  lightman run --config-file /app/lightman.toml --agent gemini --score 6
-```
+### Development Installation
+In order to fully use the provided setup for local development and testing, this project requires the following dependencies:
+- Python 3.13
+- [just](https://github.com/casey/just)
+- [uv](https://docs.astral.sh/uv/getting-started/installation/)
 
-**Integration Testing**:
+Then simply:
 ```bash
-# Test configuration without creating tickets
-lightman run --dry-run --config testing
-
-# Test with staging environment
-lightman run --env-file staging.env --dry-run --config testing
+git clone git@github.com:elementsinteractive/lightman-ai.git
+cd lightman_ai
+just venv  # Creates virtual environment and installs dependencies
+just test  # Runs the tests
+just eval  # Runs the evaluation framework
 ```
 
-
-
 ## 📊 Evaluation & Testing
 
 Lightman AI includes a comprehensive evaluation framework to test and optimize AI agent performance:
@@ -364,11 +292,17 @@ This approach ensures that performance metrics reflect real-world usage scenario
 **Make sure to fill in the `RELEVANT_ARTICLES` with the ones you classify as relevant, so that you can compare the accuracy after running the `eval` script.*** 
 
 ## Sentry 
+Sentry is **optional**: the application does not require it to function, and all features will work even if Sentry is not configured or fails to start.
+If you install the project via pip and want Sentry installed, run:
+
+```bash
+   pip install lightman-ai[sentry]
+```
+Sentry comes by default with the Docker image. If you don't want to use it, simply do not set `SENTRY_DSN` env variable.
 
-- The application will automatically pick up and use environment variables if they are present in your environment or `.env` file.
-- To enable Sentry error monitoring, set the `SENTRY_DSN` environment variable. This is **mandatory** for Sentry to be enabled. If `SENTRY_DSN` is not set, Sentry will be skipped and the application will run normally.
-- If Sentry fails to initialize for any reason (e.g., network issues, invalid DSN), the application will log a warning and continue execution without error monitoring.
-- Sentry is **optional**: the application does not require it to function, and all features will work even if Sentry is not configured or fails to start.
+The application will automatically pick up and use environment variables if they are present in your environment or `.env` file.
+To enable Sentry, set the `SENTRY_DSN` environment variable. This is **mandatory** for Sentry to be enabled. If `SENTRY_DSN` is not set, Sentry will be skipped and the application will run normally.
+If Sentry fails to initialize for any reason (e.g., network issues, invalid DSN), the application will log a warning and continue execution without error monitoring, and logging to stdout.
 
 ## 📄 License
 

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/README.md

@@ -1,6 +1,6 @@
 # 🔍 Lightman AI
 
-> **AI-Powered Cybersecurity News Intelligence Platform*
+> LLM-Powered Cybersecurity News Intelligence Platform
 
 ---
 
@@ -31,7 +31,9 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
 
 ## 🚀 Quick Start
 
-### pip
+### Installation
+
+#### pip
 
 1. **Install Lightman AI**:
    ```bash
@@ -60,10 +62,13 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
    ```bash
    lightman run
    ```
+#### Docker
+1. **Pull the image**
+   ```bash
+   docker pull elementsinteractive/lightman-ai:latest
+   ```
 
-### Docker
-
-1. **Create configuration file**:
+2. **Create configuration file**:
    ```bash
    echo '[default]
    agent = "openai"
@@ -74,7 +79,7 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
    development = "Analyze cybersecurity news for relevance to our organization."' > lightman.toml
    ```
 
-2. **Run with Docker**:
+3. **Run with Docker**:
    ```bash
    docker run --rm \
      -v $(pwd)/lightman.toml:/app/lightman.toml \
@@ -83,55 +88,37 @@ Lightman AI is an intelligent cybersecurity news aggregation and risk assessment
      lightman run --config-file /app/lightman.toml --score 7
    ```
 
-4. **View results**: Lightman will analyze cybersecurity news and output relevant articles that meet your score threshold.
-
-## 📥 Installation
-
-### Docker
-Lightman AI has an available Docker image on Docker Hub:
-
-```bash
-# Pull the latest image
-docker pull elementsinteractive/lightman-ai:latest
-
-# Create your configuration file
+## 🔧 Usage
 
-   echo '[default]
-   agent = "openai"
-   score_threshold = 8
-   prompt = "development"
-   
-   [prompts]
-   development = "Analyze cybersecurity news for relevance to our organization."' > lightman.toml
-   ```
+### CLI Options
 
+| Option | Description | Default |
+|--------|-------------|---------|
+| `--agent` | AI agent to use (`openai`, `gemini`) | From config file |
+| `--score` | Minimum relevance score (1-10) | From config file |
+| `--prompt` | Prompt template name | From config file |
+| `--config-file` | Path to configuration file | `lightman.toml` |
+| `--config` | Configuration section to use | `default` |
+| `--env-file` | Path to environment variables file | `.env` |
+| `--dry-run` | Preview results without taking action | `false` |
+| `--prompt-file` | File containing prompt templates | `lightman.toml` |
+| `--start-date` | Start date to retrieve articles | False |
+| `--today` | Retrieve articles from today | False |
+| `--yesterday` | Retrieve articles from yesterday | False |
 
-# Run with mounted configuration
-```bash
-docker run -d \
-  --name lightman-ai \
-  -v $(pwd)/lightman.toml:/app/lightman.toml \
-  -e OPENAI_API_KEY="your-api-key" \
-  elementsinteractive/lightman-ai:latest \
-  lightman run --config-file /app/lightman.toml
-```
+### Environment Variables:
+lightman-ai uses the following environment variables:
 
-**Docker Environment Variables:**
 - `OPENAI_API_KEY` - Your OpenAI API key
 - `GOOGLE_API_KEY` - Your Google Gemini API key
 - `SERVICE_DESK_URL` - Service desk instance URL (optional)
 - `SERVICE_DESK_USER` - Service desk username (optional)
 - `SERVICE_DESK_TOKEN` - Service desk API token (optional)
+- `TIME_ZONE` - Your time zone (optional, defaults to UTC. i.e. "Europe/Amsterdam".)
 
+By default, it will try to load a `.env` file. You can also specify a different path with the `--env-file` option.
 
 
-### Development Installation
-```bash
-git clone git@github.com:elementsinteractive/lightman-ai.git
-cd lightman_ai
-just venv  # Creates virtual environment and installs dependencies
-```
-
 ## ⚙️ Configuration
 
 Lightman AI uses TOML configuration files for flexible setup. Create a `lightman.toml` file:
@@ -185,30 +172,8 @@ custom_prompt = """
 Your custom analysis prompt here...
 """
 ```
-### Environment Variables
-
-Set up your AI provider credentials:
-
-```bash
-# For OpenAI
-export OPENAI_API_KEY="your-openai-api-key"
-
-# For Google Gemini
-export GOOGLE_API_KEY="your-google-api-key"
-
-# Optional: Service desk integration
-export SERVICE_DESK_URL="https://your-company.atlassian.net"
-export SERVICE_DESK_USER="your-username"
-export SERVICE_DESK_TOKEN="your-api-token"
-
-```
-You can also specify a different path for your .env file with the `--env-file` option
-
-
-## 🔧 Usage
-
-### Basic Usage
 
+### Examples
 ```bash
 # Run with default settings
 lightman run
@@ -224,67 +189,30 @@ lightman run --env-file production.env --agent openai --score 8
 
 # Dry run (preview results without creating service desk tickets)
 lightman run --dry-run --agent openai --score 9
-```
 
-### Command Line Options
+# Retrieve all the news from today
+lightman run --agent openai --score 8 --prompt security_critical --today
 
-| Option | Description | Default |
-|--------|-------------|---------|
-| `--agent` | AI agent to use (`openai`, `gemini`) | From config file |
-| `--score` | Minimum relevance score (1-10) | From config file |
-| `--prompt` | Prompt template name | From config file |
-| `--config-file` | Path to configuration file | `lightman.toml` |
-| `--config` | Configuration section to use | `default` |
-| `--env-file` | Path to environment variables file | `.env` |
-| `--dry-run` | Preview results without taking action | `false` |
-| `--prompt-file` | File containing prompt templates | `lightman.toml` |
-
-### Example Workflows
-
-**Daily Security Monitoring**:
-```bash
-# Local installation
-lightman run --agent openai --score 8 --prompt security_critical
-
-# With custom environment file
-lightman run --env-file production.env --agent openai --score 8
-
-# Docker 
-docker run --rm \
-  -v $(pwd)/lightman.toml:/app/lightman.toml \
-  -e OPENAI_API_KEY="$OPENAI_API_KEY" \
-  elementsinteractive/lightman-ai:latest \
-  lightman run --config-file /app/lightman.toml --score 8
+# Retrieve all the news from yesterday
+lightman run --agent openai --score 8 --prompt security_critical --yesterday
 ```
 
 
-**Weekly Risk Assessment**:
-```bash
-# Local installation
-lightman run --agent gemini --score 6 --prompt weekly_assessment
-
-# With environment-specific settings
-lightman run --env-file weekly.env --agent gemini --score 6
-
-# Docker 
-docker run --rm \
-  -v $(pwd)/lightman.toml:/app/lightman.toml \
-  -e GOOGLE_API_KEY="$GOOGLE_API_KEY" \
-  elementsinteractive/lightman-ai:latest \
-  lightman run --config-file /app/lightman.toml --agent gemini --score 6
-```
+### Development Installation
+In order to fully use the provided setup for local development and testing, this project requires the following dependencies:
+- Python 3.13
+- [just](https://github.com/casey/just)
+- [uv](https://docs.astral.sh/uv/getting-started/installation/)
 
-**Integration Testing**:
+Then simply:
 ```bash
-# Test configuration without creating tickets
-lightman run --dry-run --config testing
-
-# Test with staging environment
-lightman run --env-file staging.env --dry-run --config testing
+git clone git@github.com:elementsinteractive/lightman-ai.git
+cd lightman_ai
+just venv  # Creates virtual environment and installs dependencies
+just test  # Runs the tests
+just eval  # Runs the evaluation framework
 ```
 
-
-
 ## 📊 Evaluation & Testing
 
 Lightman AI includes a comprehensive evaluation framework to test and optimize AI agent performance:
@@ -346,11 +274,17 @@ This approach ensures that performance metrics reflect real-world usage scenario
 **Make sure to fill in the `RELEVANT_ARTICLES` with the ones you classify as relevant, so that you can compare the accuracy after running the `eval` script.*** 
 
 ## Sentry 
+Sentry is **optional**: the application does not require it to function, and all features will work even if Sentry is not configured or fails to start.
+If you install the project via pip and want Sentry installed, run:
+
+```bash
+   pip install lightman-ai[sentry]
+```
+Sentry comes by default with the Docker image. If you don't want to use it, simply do not set `SENTRY_DSN` env variable.
 
-- The application will automatically pick up and use environment variables if they are present in your environment or `.env` file.
-- To enable Sentry error monitoring, set the `SENTRY_DSN` environment variable. This is **mandatory** for Sentry to be enabled. If `SENTRY_DSN` is not set, Sentry will be skipped and the application will run normally.
-- If Sentry fails to initialize for any reason (e.g., network issues, invalid DSN), the application will log a warning and continue execution without error monitoring.
-- Sentry is **optional**: the application does not require it to function, and all features will work even if Sentry is not configured or fails to start.
+The application will automatically pick up and use environment variables if they are present in your environment or `.env` file.
+To enable Sentry, set the `SENTRY_DSN` environment variable. This is **mandatory** for Sentry to be enabled. If `SENTRY_DSN` is not set, Sentry will be skipped and the application will run normally.
+If Sentry fails to initialize for any reason (e.g., network issues, invalid DSN), the application will log a warning and continue execution without error monitoring, and logging to stdout.
 
 ## 📄 License
 

lightman_ai-0.22.0/VERSION

@@ -0,0 +1 @@
+v0.22.0

lightman_ai-0.22.0/src/lightman_ai/ai/base/exceptions.py

@@ -0,0 +1,4 @@
+from lightman_ai.core.exceptions import BaseLightmanError
+
+
+class BaseAgentError(BaseLightmanError): ...

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/src/lightman_ai/ai/gemini/exceptions.py

@@ -2,10 +2,10 @@ from collections.abc import Generator
 from contextlib import contextmanager
 from typing import Any
 
-from lightman_ai.core.exceptions import BaseHackermanError
+from lightman_ai.core.exceptions import BaseLightmanError
 
 
-class BaseGeminiError(BaseHackermanError): ...
+class BaseGeminiError(BaseLightmanError): ...
 
 
 class GeminiError(BaseGeminiError): ...

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/src/lightman_ai/ai/openai/exceptions.py

@@ -4,13 +4,13 @@ from collections.abc import Generator
 from contextlib import contextmanager
 from typing import Any, override
 
-from lightman_ai.core.exceptions import BaseHackermanError
+from lightman_ai.core.exceptions import BaseLightmanError
 from pydantic_ai.exceptions import ModelHTTPError
 
 from openai import RateLimitError
 
 
-class BaseOpenAIError(BaseHackermanError): ...
+class BaseOpenAIError(BaseLightmanError): ...
 
 
 class UnknownOpenAIError(BaseOpenAIError): ...

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/src/lightman_ai/cli.py

@@ -1,7 +1,6 @@
 import logging
-from datetime import date, datetime, time
+from datetime import date
 from importlib import metadata
-from zoneinfo import ZoneInfo
 
 import click
 from dotenv import load_dotenv
@@ -10,8 +9,10 @@ from lightman_ai.constants import DEFAULT_CONFIG_FILE, DEFAULT_CONFIG_SECTION, D
 from lightman_ai.core.config import FileConfig, FinalConfig, PromptConfig
 from lightman_ai.core.exceptions import ConfigNotFoundError, InvalidConfigError, PromptNotFoundError
 from lightman_ai.core.sentry import configure_sentry
-from lightman_ai.core.settings import settings
+from lightman_ai.core.settings import Settings
+from lightman_ai.exceptions import MultipleDateSourcesError
 from lightman_ai.main import lightman
+from lightman_ai.utils import get_start_date
 
 logger = logging.getLogger("lightman")
 
@@ -58,7 +59,7 @@ def entry_point() -> None:
 @click.option(
     "--env-file",
     type=str,
-    default=DEFAULT_ENV_FILE,
+    default=None,
     help=(f"Path to the environment file. Defaults to `{DEFAULT_ENV_FILE}`."),
 )
 @click.option(
@@ -70,6 +71,7 @@ def entry_point() -> None:
 )
 @click.option("--start-date", type=click.DateTime(formats=["%Y-%m-%d"]), help="Start date to retrieve articles")
 @click.option("--today", is_flag=True, help="Retrieve articles from today.")
+@click.option("--yesterday", is_flag=True, help="Retrieve articles from yesterday.")
 def run(
     agent: str,
     prompt: str,
@@ -78,41 +80,37 @@ def run(
     score: int | None,
     config_file: str,
     config: str,
-    env_file: str,
+    env_file: str | None,
     dry_run: bool,
     start_date: date | None,
     today: bool,
+    yesterday: bool,
 ) -> int:
     """
     Entrypoint of the application.
 
-    Holds no logic. It calls the main method and returns 0 when succesful .
+    Holds no logic. It loads the configuration, calls the main method and returns 0 when succesful .
     """
-    load_dotenv(env_file)
+    load_dotenv(env_file or DEFAULT_ENV_FILE)  # TODO refs: #112
     configure_sentry()
 
-    if start_date and today:
-        raise click.UsageError("--today and --start-date cannot be set at the same time.")
-    elif today:
-        now = datetime.now(ZoneInfo(settings.TIME_ZONE))
-        start_datetime = datetime.combine(now, time(0, 0), tzinfo=ZoneInfo(settings.TIME_ZONE))
-    elif isinstance(start_date, date):
-        start_datetime = datetime.combine(start_date, time(0, 0), tzinfo=ZoneInfo(settings.TIME_ZONE))
-    else:
-        start_datetime = None
+    settings = Settings.try_load_from_file(env_file)
+    try:
+        start_datetime = get_start_date(settings, yesterday, today, start_date)
+    except MultipleDateSourcesError as e:
+        raise click.UsageError(e.args[0]) from e
 
     try:
         prompt_config = PromptConfig.get_config_from_file(path=prompt_file)
         config_from_file = FileConfig.get_config_from_file(config_section=config, path=config_file)
         final_config = FinalConfig.init_from_dict(
             data={
-                "agent": agent or config_from_file.agent,
+                "agent": agent or config_from_file.agent or settings.AGENT,
                 "prompt": prompt or config_from_file.prompt,
-                "score_threshold": score or config_from_file.score_threshold,
+                "score_threshold": score or config_from_file.score_threshold or settings.SCORE,
                 "model": model or config_from_file.model,
             }
         )
-
         prompt_text = prompt_config.get_prompt(final_config.prompt)
     except (InvalidConfigError, PromptNotFoundError, ConfigNotFoundError) as err:
         raise click.BadParameter(err.args[0]) from None
@@ -122,8 +120,8 @@ def run(
         prompt=prompt_text,
         score_threshold=final_config.score_threshold,
         dry_run=dry_run,
-        project_key=config_from_file.service_desk_project_key,
-        request_id_type=config_from_file.service_desk_request_id_type,
+        service_desk_project_key=config_from_file.service_desk_project_key,
+        service_desk_request_id_type=config_from_file.service_desk_request_id_type,
         model=final_config.model,
         start_date=start_datetime,
     )

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/src/lightman_ai/core/exceptions.py

@@ -1,7 +1,7 @@
-class BaseHackermanError(Exception): ...
+class BaseLightmanError(Exception): ...
 
 
-class BaseConfigError(BaseHackermanError): ...
+class BaseConfigError(BaseLightmanError): ...
 
 
 class InvalidConfigError(BaseConfigError): ...

lightman_ai-0.22.0/src/lightman_ai/core/settings.py

@@ -0,0 +1,30 @@
+import logging
+from pathlib import Path
+from typing import Any, Self
+
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+logger = logging.getLogger("lightman")
+
+
+class Settings(BaseSettings):
+    def __init__(self, *args: Any, **kwargs: Any) -> None:
+        super().__init__(*args, **kwargs)
+
+    AGENT: str = "openai"
+    SCORE: int = 8
+    TIME_ZONE: str = "UTC"
+    model_config = SettingsConfigDict(extra="ignore")
+
+    @classmethod
+    def try_load_from_file(cls, env_file: str | None = None) -> Self:
+        """
+        Initialize Settings class and returns an instance.
+
+        It tries to load env variables from the env file. Variables set in the environment take precendence.
+
+        If the env file is not present, it continues execution, following pydantic-settings' behaviour.
+        """
+        if env_file and not Path(env_file).exists():
+            logger.warning("env file `%s` not found.", env_file)
+        return cls(_env_file=env_file)

lightman_ai-0.22.0/src/lightman_ai/exceptions.py

@@ -0,0 +1,5 @@
+from lightman_ai.core.exceptions import BaseLightmanError
+
+
+class MultipleDateSourcesError(BaseLightmanError):
+    """Exception for when more than one date source is provided."""

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/src/lightman_ai/integrations/service_desk/exceptions.py

@@ -4,12 +4,12 @@ from contextlib import asynccontextmanager
 from typing import Any
 
 import httpx
-from lightman_ai.core.exceptions import BaseHackermanError
+from lightman_ai.core.exceptions import BaseLightmanError
 
 logger = logging.getLogger("lightman")
 
 
-class BaseServiceDeskError(BaseHackermanError):
+class BaseServiceDeskError(BaseLightmanError):
     """Base exception for all SERVICE_DESK integration errors."""
 
 

{lightman_ai-0.21.1 → lightman_ai-0.22.0}/src/lightman_ai/main.py

@@ -24,17 +24,17 @@ def _classify_articles(articles: ArticlesList, agent: BaseAgent) -> SelectedArti
 def _create_service_desk_issues(
     selected_articles: list[SelectedArticle],
     service_desk_client: ServiceDeskIntegration,
-    project_key: str,
-    request_id_type: str,
+    service_desk_project_key: str,
+    service_desk_request_id_type: str,
 ) -> None:
     async def schedule_task(article: SelectedArticle) -> None:
         try:
             description = f"*Why is relevant:*\n{article.why_is_relevant}\n\n*Source:* {article.link}\n\n*Score:* {article.relevance_score}/10"
             await service_desk_client.create_request_of_type(
-                project_key=project_key,
+                project_key=service_desk_project_key,
                 summary=article.title,
                 description=description,
-                request_id_type=request_id_type,
+                request_id_type=service_desk_request_id_type,
             )
             logger.info("Created issue for article %s", article.link)
         except Exception:
@@ -57,8 +57,8 @@ def lightman(
     agent: str,
     prompt: str,
     score_threshold: int,
-    project_key: str | None = None,
-    request_id_type: str | None = None,
+    service_desk_project_key: str | None = None,
+    service_desk_request_id_type: str | None = None,
     dry_run: bool = False,
     model: str | None = None,
     start_date: datetime | None = None,
@@ -83,15 +83,15 @@ def lightman(
         logger.info("No articles found to be relevant. Total returned articles by AI %s", len(classified_articles))
 
     if not dry_run:
-        if not project_key or not request_id_type:
+        if not service_desk_project_key or not service_desk_request_id_type:
             raise ValueError("Missing Service Desk's project key or request id type")
 
         service_desk_client = ServiceDeskIntegration.from_env()
         _create_service_desk_issues(
             selected_articles=selected_articles,
             service_desk_client=service_desk_client,
-            project_key=project_key,
-            request_id_type=request_id_type,
+            service_desk_project_key=service_desk_project_key,
+            service_desk_request_id_type=service_desk_request_id_type,
         )
 
     return selected_articles

lightman_ai-0.22.0/src/lightman_ai/utils.py

@@ -0,0 +1,25 @@
+from datetime import date, datetime, time, timedelta
+from zoneinfo import ZoneInfo
+
+from lightman_ai.core.settings import Settings
+from lightman_ai.exceptions import MultipleDateSourcesError
+
+
+def get_start_date(settings: Settings, yesterday: bool, today: bool, start_date: date | None) -> datetime | None:
+    mutually_exclusive_date_fields = [x for x in [start_date, today, yesterday] if x]
+
+    if len(mutually_exclusive_date_fields) > 1:
+        raise MultipleDateSourcesError(
+            "--today, --yesterday and --start-date are mutually exclusive. Set one at a time."
+        )
+
+    if today:
+        now = datetime.now(ZoneInfo(settings.TIME_ZONE))
+        return datetime.combine(now, time(0, 0), tzinfo=ZoneInfo(settings.TIME_ZONE))
+    elif yesterday:
+        yesterday_date = datetime.now(ZoneInfo(settings.TIME_ZONE)) - timedelta(days=1)
+        return datetime.combine(yesterday_date, time(0, 0), tzinfo=ZoneInfo(settings.TIME_ZONE))
+    elif isinstance(start_date, date):
+        return datetime.combine(start_date, time(0, 0), tzinfo=ZoneInfo(settings.TIME_ZONE))
+    else:
+        return None

lightman_ai-0.21.1/VERSION

@@ -1 +0,0 @@
-v0.21.1

lightman_ai-0.21.1/src/lightman_ai/ai/base/exceptions.py

@@ -1,4 +0,0 @@
-from lightman_ai.core.exceptions import BaseHackermanError
-
-
-class BaseAgentError(BaseHackermanError): ...

lightman_ai-0.21.1/src/lightman_ai/core/settings.py

@@ -1,14 +0,0 @@
-from typing import Any
-
-from pydantic_settings import BaseSettings
-
-
-class Settings(BaseSettings):
-    def __init__(self, *args: Any, **kwargs: Any) -> None:
-        super().__init__(*args, **kwargs)
-
-    PARALLEL_WORKERS: int = 5
-    TIME_ZONE: str = "UTC"
-
-
-settings = Settings()