meeting-noter 1.2.0__tar.gz → 1.3.0__tar.gz

{meeting_noter-1.2.0 → meeting_noter-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meeting-noter
-Version: 1.2.0
+Version: 1.3.0
 Summary: Offline meeting transcription for macOS with automatic meeting detection
 Author: Victor
 License: MIT

{meeting_noter-1.2.0 → meeting_noter-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "meeting-noter"
-version = "1.2.0"
+version = "1.3.0"
 description = "Offline meeting transcription for macOS with automatic meeting detection"
 readme = "README.md"
 license = {text = "MIT"}

{meeting_noter-1.2.0 → meeting_noter-1.3.0}/src/meeting_noter/__init__.py

@@ -1,3 +1,3 @@
 """Meeting Noter - Offline meeting transcription with virtual audio devices."""
 
-__version__ = "1.2.0"
+__version__ = "1.3.0"

{meeting_noter-1.2.0 → meeting_noter-1.3.0}/src/meeting_noter/cli.py

@@ -262,7 +262,12 @@ def daemon(output_dir: Optional[str], foreground: bool, name: Optional[str]):
 
 @cli.command()
 def status():
-    """Show Meeting Noter status."""
+    """Show Meeting Noter status.
+
+    \b
+    Examples:
+        meeting-noter status    # Check if recording or watching
+    """
     import os
     from meeting_noter.daemon import read_pid_file, is_process_running
 
@@ -331,7 +336,12 @@ def _get_current_recording_name() -> str | None:
 
 @cli.command()
 def shutdown():
-    """Stop all Meeting Noter processes (daemon, watcher)."""
+    """Stop all Meeting Noter processes (daemon, watcher).
+
+    \b
+    Examples:
+        meeting-noter shutdown    # Stop recording and watcher
+    """
     import subprocess
     import os
     import signal
@@ -372,7 +382,14 @@ def shutdown():
 @click.option("--follow", "-f", is_flag=True, help="Follow log output (like tail -f)")
 @click.option("--lines", "-n", default=50, help="Number of lines to show")
 def logs(follow: bool, lines: int):
-    """View Meeting Noter logs."""
+    """View Meeting Noter logs.
+
+    \b
+    Examples:
+        meeting-noter logs           # Show last 50 lines
+        meeting-noter logs -n 100    # Show last 100 lines
+        meeting-noter logs -f        # Follow log output (Ctrl+C to stop)
+    """
     import subprocess
 
     log_file = Path.home() / ".meeting-noter.log"
@@ -392,6 +409,11 @@ def logs(follow: bool, lines: int):
 
 
 @cli.command("list")
+@click.option(
+    "--transcripts", "-t",
+    is_flag=True,
+    help="List transcripts instead of recordings",
+)
 @click.option(
     "--output-dir", "-o",
     type=click.Path(exists=True),
@@ -402,22 +424,118 @@ def logs(follow: bool, lines: int):
     "--limit", "-n",
     type=int,
     default=10,
-    help="Number of recordings to show",
+    help="Number of items to show",
+)
+@require_setup
+def list_recordings(transcripts: bool, output_dir: Optional[str], limit: int):
+    """List recent meeting recordings or transcripts.
+
+    \b
+    Examples:
+        meeting-noter list             # Show last 10 recordings
+        meeting-noter list -t          # Show last 10 transcripts
+        meeting-noter list -t -n 20    # Show last 20 transcripts
+    """
+    config = get_config()
+
+    if transcripts:
+        from meeting_noter.output.favorites import list_transcripts_with_favorites
+        path = Path(output_dir) if output_dir else config.transcripts_dir
+        list_transcripts_with_favorites(path, limit)
+    else:
+        from meeting_noter.output.writer import list_recordings as _list_recordings
+        path = Path(output_dir) if output_dir else config.recordings_dir
+        _list_recordings(path, limit)
+
+
+@cli.command("search")
+@click.argument("query")
+@click.option(
+    "--case-sensitive", "-c",
+    is_flag=True,
+    help="Case-sensitive search",
+)
+@click.option(
+    "--limit", "-n",
+    type=int,
+    default=20,
+    help="Max results to show",
+)
+@click.option(
+    "--transcripts-dir", "-d",
+    type=click.Path(),
+    default=None,
+    help="Override transcripts directory",
 )
 @require_setup
-def list_recordings(output_dir: Optional[str], limit: int):
-    """List recent meeting recordings.
+def search(query: str, case_sensitive: bool, limit: int, transcripts_dir: Optional[str]):
+    """Search across all meeting transcripts.
 
     \b
     Examples:
-        meeting-noter list          # Show last 10 recordings
-        meeting-noter list -n 20    # Show last 20 recordings
+        meeting-noter search "action items"
+        meeting-noter search "API" --case-sensitive
+        meeting-noter search "standup" -n 5
     """
-    from meeting_noter.output.writer import list_recordings as _list_recordings
+    from meeting_noter.output.searcher import search_transcripts
 
     config = get_config()
-    path = Path(output_dir) if output_dir else config.recordings_dir
-    _list_recordings(path, limit)
+    path = Path(transcripts_dir) if transcripts_dir else config.transcripts_dir
+    search_transcripts(path, query, case_sensitive, limit)
+
+
+@cli.group("favorites", invoke_without_command=True)
+@click.pass_context
+@require_setup
+def favorites(ctx):
+    """Manage favorite transcripts.
+
+    \b
+    Examples:
+        meeting-noter favorites              # List all favorites
+        meeting-noter favorites add file.txt # Add to favorites
+        meeting-noter favorites add --latest # Add most recent transcript
+        meeting-noter favorites remove file  # Remove from favorites
+    """
+    if ctx.invoked_subcommand is None:
+        # Default: list favorites
+        from meeting_noter.output.favorites import list_favorites
+
+        config = get_config()
+        list_favorites(config.transcripts_dir)
+
+
+@favorites.command("add")
+@click.argument("filename", required=False)
+@click.option("--latest", "-l", is_flag=True, help="Add the most recent transcript")
+@require_setup
+def favorites_add(filename: Optional[str], latest: bool):
+    """Add a transcript to favorites.
+
+    \b
+    Examples:
+        meeting-noter favorites add meeting.txt
+        meeting-noter favorites add --latest
+    """
+    from meeting_noter.output.favorites import add_favorite
+
+    config = get_config()
+    add_favorite(config.transcripts_dir, filename, latest)
+
+
+@favorites.command("remove")
+@click.argument("filename")
+@require_setup
+def favorites_remove(filename: str):
+    """Remove a transcript from favorites.
+
+    \b
+    Examples:
+        meeting-noter favorites remove meeting.txt
+    """
+    from meeting_noter.output.favorites import remove_favorite
+
+    remove_favorite(filename)
 
 
 @cli.command()

{meeting_noter-1.2.0 → meeting_noter-1.3.0}/src/meeting_noter/config.py

@@ -160,6 +160,40 @@ class Config:
         """Set setup completion status."""
         self._data["setup_complete"] = value
 
+    @property
+    def favorites(self) -> list[str]:
+        """Get list of favorite transcript filenames."""
+        return self._data.get("favorites", [])
+
+    @favorites.setter
+    def favorites(self, value: list[str]) -> None:
+        """Set list of favorite transcript filenames."""
+        self._data["favorites"] = value
+
+    def add_favorite(self, filename: str) -> bool:
+        """Add a transcript to favorites. Returns True if added, False if already exists."""
+        favorites = self.favorites
+        if filename not in favorites:
+            favorites.append(filename)
+            self.favorites = favorites
+            self.save()
+            return True
+        return False
+
+    def remove_favorite(self, filename: str) -> bool:
+        """Remove a transcript from favorites. Returns True if removed, False if not found."""
+        favorites = self.favorites
+        if filename in favorites:
+            favorites.remove(filename)
+            self.favorites = favorites
+            self.save()
+            return True
+        return False
+
+    def is_favorite(self, filename: str) -> bool:
+        """Check if a transcript is a favorite."""
+        return filename in self.favorites
+
     def __getitem__(self, key: str) -> Any:
         """Get config value by key."""
         return self._data.get(key, DEFAULT_CONFIG.get(key))

meeting_noter-1.3.0/src/meeting_noter/output/favorites.py

@@ -0,0 +1,189 @@
+"""Favorites management for meeting transcripts."""
+
+from __future__ import annotations
+
+import click
+from pathlib import Path
+from datetime import datetime
+from typing import Optional
+
+from meeting_noter.config import get_config
+
+
+def list_favorites(transcripts_dir: Path) -> None:
+    """List all favorite transcripts.
+
+    Args:
+        transcripts_dir: Directory containing transcript files
+    """
+    config = get_config()
+    favorites = config.favorites
+
+    if not favorites:
+        click.echo(click.style("No favorites yet.", fg="yellow"))
+        click.echo("\nAdd favorites with: meeting-noter favorites add <filename>")
+        click.echo("Or use: meeting-noter favorites add --latest")
+        return
+
+    click.echo()
+    click.echo(click.style("Favorite Transcripts", bold=True))
+    click.echo("=" * 50)
+    click.echo()
+
+    found_count = 0
+    missing_count = 0
+
+    for idx, filename in enumerate(favorites, 1):
+        filepath = transcripts_dir / filename
+        if filepath.exists():
+            found_count += 1
+            # Get file info
+            stat = filepath.stat()
+            mod_time = datetime.fromtimestamp(stat.st_mtime)
+            date_str = mod_time.strftime("%Y-%m-%d %H:%M")
+
+            # Display: index, filename prominently, then date
+            click.echo(
+                click.style(f"  {idx}. ", fg="cyan")
+                + click.style(filename, fg="green", bold=True)
+            )
+            click.echo(f"     ★ {date_str}")
+        else:
+            missing_count += 1
+            click.echo(
+                click.style(f"  {idx}. ", fg="cyan")
+                + click.style(filename, fg="red", strikethrough=True)
+            )
+            click.echo(click.style("     (file not found)", fg="red"))
+
+    click.echo()
+    click.echo(f"Total: {found_count} favorites")
+    if missing_count > 0:
+        click.echo(
+            click.style(
+                f"Warning: {missing_count} favorite(s) no longer exist",
+                fg="yellow"
+            )
+        )
+    click.echo()
+
+
+def add_favorite(
+    transcripts_dir: Path,
+    filename: Optional[str] = None,
+    latest: bool = False
+) -> None:
+    """Add a transcript to favorites.
+
+    Args:
+        transcripts_dir: Directory containing transcript files
+        filename: Name of transcript file to add
+        latest: If True, add the most recent transcript
+    """
+    config = get_config()
+
+    if latest:
+        # Find the most recent transcript
+        txt_files = sorted(
+            transcripts_dir.glob("*.txt"),
+            key=lambda p: p.stat().st_mtime,
+            reverse=True,
+        )
+        if not txt_files:
+            click.echo(click.style("No transcripts found.", fg="red"))
+            return
+        filename = txt_files[0].name
+
+    if not filename:
+        click.echo(click.style("Error: Specify a filename or use --latest", fg="red"))
+        return
+
+    # Check if file exists
+    filepath = transcripts_dir / filename
+    if not filepath.exists():
+        # Try adding .txt extension
+        if not filename.endswith(".txt"):
+            filepath = transcripts_dir / f"{filename}.txt"
+            if filepath.exists():
+                filename = f"{filename}.txt"
+            else:
+                click.echo(click.style(f"File not found: {filename}", fg="red"))
+                click.echo(f"Looking in: {transcripts_dir}")
+                return
+        else:
+            click.echo(click.style(f"File not found: {filename}", fg="red"))
+            click.echo(f"Looking in: {transcripts_dir}")
+            return
+
+    if config.add_favorite(filename):
+        click.echo(
+            click.style("★ ", fg="yellow")
+            + f"Added to favorites: "
+            + click.style(filename, fg="green")
+        )
+    else:
+        click.echo(click.style(f"Already a favorite: {filename}", fg="yellow"))
+
+
+def remove_favorite(filename: str) -> None:
+    """Remove a transcript from favorites.
+
+    Args:
+        filename: Name of transcript file to remove
+    """
+    config = get_config()
+
+    # Handle with or without .txt extension
+    if not filename.endswith(".txt"):
+        if f"{filename}.txt" in config.favorites:
+            filename = f"{filename}.txt"
+
+    if config.remove_favorite(filename):
+        click.echo(
+            click.style("☆ ", fg="cyan")
+            + f"Removed from favorites: "
+            + click.style(filename, fg="green")
+        )
+    else:
+        click.echo(click.style(f"Not a favorite: {filename}", fg="yellow"))
+
+
+def list_transcripts_with_favorites(transcripts_dir: Path, limit: int = 10) -> None:
+    """List transcripts with favorite status indicated.
+
+    Args:
+        transcripts_dir: Directory containing transcript files
+        limit: Maximum number of transcripts to show
+    """
+    config = get_config()
+
+    if not transcripts_dir.exists():
+        click.echo(click.style(f"Directory not found: {transcripts_dir}", fg="red"))
+        return
+
+    txt_files = sorted(
+        transcripts_dir.glob("*.txt"),
+        key=lambda p: p.stat().st_mtime,
+        reverse=True,
+    )
+
+    if not txt_files:
+        click.echo(click.style("No transcripts found.", fg="yellow"))
+        return
+
+    click.echo(f"\nTranscripts in {transcripts_dir}:\n")
+
+    for txt_file in txt_files[:limit]:
+        stat = txt_file.stat()
+        mod_time = datetime.fromtimestamp(stat.st_mtime)
+        date_str = mod_time.strftime("%Y-%m-%d %H:%M")
+
+        is_fav = config.is_favorite(txt_file.name)
+        star = click.style("★ ", fg="yellow") if is_fav else "  "
+
+        click.echo(f"{star}{date_str}  {txt_file.name}")
+
+    if len(txt_files) > limit:
+        click.echo(f"\n  ... and {len(txt_files) - limit} more")
+
+    click.echo(f"\nTotal: {len(txt_files)} transcripts")

meeting_noter-1.3.0/src/meeting_noter/output/searcher.py

@@ -0,0 +1,218 @@
+"""Search functionality for meeting transcripts."""
+
+from __future__ import annotations
+
+import re
+import click
+from pathlib import Path
+from dataclasses import dataclass
+from typing import Optional
+
+
+@dataclass
+class SearchMatch:
+    """A single match within a transcript file."""
+
+    line_number: int
+    line: str
+    timestamp: Optional[str] = None
+
+
+@dataclass
+class FileSearchResult:
+    """Search results for a single transcript file."""
+
+    filepath: Path
+    matches: list[SearchMatch]
+
+    @property
+    def match_count(self) -> int:
+        return len(self.matches)
+
+
+def _extract_timestamp(line: str) -> Optional[str]:
+    """Extract timestamp from line if present (e.g., [05:32] or [01:23:45])."""
+    match = re.match(r"^\[(\d{1,2}:\d{2}(?::\d{2})?)\]", line.strip())
+    if match:
+        return match.group(1)
+    return None
+
+
+def _truncate_line(line: str, max_length: int = 80) -> str:
+    """Truncate line to max length with ellipsis."""
+    line = line.strip()
+    if len(line) <= max_length:
+        return line
+    return line[: max_length - 3] + "..."
+
+
+def _highlight_match(line: str, query: str, case_sensitive: bool) -> str:
+    """Highlight matching text in the line."""
+    if case_sensitive:
+        pattern = re.escape(query)
+    else:
+        pattern = re.compile(re.escape(query), re.IGNORECASE)
+
+    def replace_with_highlight(match):
+        return click.style(match.group(0), bold=True, fg="yellow")
+
+    if case_sensitive:
+        return re.sub(pattern, replace_with_highlight, line)
+    else:
+        return pattern.sub(replace_with_highlight, line)
+
+
+def _search_file(
+    filepath: Path,
+    query: str,
+    case_sensitive: bool,
+    context_lines: int = 1,
+) -> Optional[FileSearchResult]:
+    """Search a single file for the query.
+
+    Returns FileSearchResult if matches found, None otherwise.
+    """
+    try:
+        content = filepath.read_text(encoding="utf-8", errors="ignore")
+    except Exception:
+        return None
+
+    lines = content.splitlines()
+    matches: list[SearchMatch] = []
+
+    search_query = query if case_sensitive else query.lower()
+
+    for i, line in enumerate(lines):
+        search_line = line if case_sensitive else line.lower()
+
+        if search_query in search_line:
+            timestamp = _extract_timestamp(line)
+            matches.append(
+                SearchMatch(
+                    line_number=i + 1,
+                    line=line,
+                    timestamp=timestamp,
+                )
+            )
+
+    if matches:
+        return FileSearchResult(filepath=filepath, matches=matches)
+    return None
+
+
+def search_transcripts(
+    transcripts_dir: Path,
+    query: str,
+    case_sensitive: bool = False,
+    limit: int = 20,
+    context_lines: int = 1,
+) -> None:
+    """Search across all meeting transcripts.
+
+    Args:
+        transcripts_dir: Directory containing transcript files
+        query: Search query string
+        case_sensitive: Whether to perform case-sensitive search
+        limit: Maximum number of matches to display
+        context_lines: Number of context lines around matches (not yet implemented)
+    """
+    if not query.strip():
+        click.echo(click.style("Error: Search query cannot be empty.", fg="red"))
+        return
+
+    if not transcripts_dir.exists():
+        click.echo(click.style(f"Directory not found: {transcripts_dir}", fg="red"))
+        return
+
+    # Find all transcript files
+    txt_files = sorted(
+        transcripts_dir.glob("*.txt"),
+        key=lambda p: p.stat().st_mtime,
+        reverse=True,
+    )
+
+    if not txt_files:
+        click.echo(click.style("No transcripts found.", fg="yellow"))
+        click.echo(f"\nTranscripts directory: {transcripts_dir}")
+        click.echo("Record and transcribe meetings to search them.")
+        return
+
+    # Search all files
+    results: list[FileSearchResult] = []
+    for txt_file in txt_files:
+        result = _search_file(txt_file, query, case_sensitive, context_lines)
+        if result:
+            results.append(result)
+
+    if not results:
+        click.echo(click.style(f'No results found for "{query}"', fg="yellow"))
+        click.echo(f"\nSearched {len(txt_files)} transcripts in {transcripts_dir}")
+        if not case_sensitive:
+            click.echo("Tip: Use --case-sensitive for exact matching.")
+        return
+
+    # Sort by match count (most matches first)
+    results.sort(key=lambda r: r.match_count, reverse=True)
+
+    # Count total matches
+    total_matches = sum(r.match_count for r in results)
+    total_files = len(results)
+
+    # Display header
+    click.echo()
+    matches_word = "match" if total_matches == 1 else "matches"
+    files_word = "transcript" if total_files == 1 else "transcripts"
+    click.echo(
+        click.style(
+            f"Found {total_matches} {matches_word} in {total_files} {files_word}:",
+            bold=True,
+        )
+    )
+    click.echo()
+
+    # Display results
+    matches_shown = 0
+    limit_reached = False
+    for result in results:
+        if matches_shown >= limit:
+            limit_reached = True
+            break
+
+        # File header
+        match_word = "match" if result.match_count == 1 else "matches"
+        click.echo(
+            click.style(f"{result.filepath.name}", fg="green", bold=True)
+            + f" ({result.match_count} {match_word})"
+        )
+
+        # Show matches (limited)
+        for match in result.matches:
+            if matches_shown >= limit:
+                limit_reached = True
+                break
+
+            # Format the line
+            prefix = f"  [{match.timestamp}] " if match.timestamp else "  "
+            line_text = match.line
+            if match.timestamp:
+                # Remove timestamp from line since we're showing it in prefix
+                line_text = re.sub(r"^\[\d{1,2}:\d{2}(?::\d{2})?\]\s*", "", line_text)
+
+            truncated = _truncate_line(line_text, 70)
+            highlighted = _highlight_match(truncated, query, case_sensitive)
+
+            click.echo(f"{prefix}...{highlighted}...")
+            matches_shown += 1
+
+        click.echo()
+
+    # Show remaining count if limit was reached
+    if limit_reached and matches_shown < total_matches:
+        remaining = total_matches - matches_shown
+        click.echo(
+            click.style(f"... and {remaining} more matches", fg="cyan")
+        )
+        click.echo()
+
+    # Footer
+    click.echo(f"Searched {len(txt_files)} transcripts in {transcripts_dir}")