aiwcli 0.10.3 → 0.11.1

package/dist/templates/_shared/lib/base/utils.py

@@ -1,263 +0,0 @@
-"""Core utilities for shared context management.
-
-Provides common functions used across all shared modules:
-- eprint: Print to stderr
-- now_local: Get current local datetime
-- project_dir: Get project directory from environment
-- sanitize_filename: Sanitize string for use in filenames
-- generate_context_id: Generate a slug from summary text
-"""
-import os
-import re
-import sys
-from datetime import datetime
-from pathlib import Path
-from typing import Any, Dict, Optional
-
-from .logger import log_debug, log_info, log_warn, log_error
-
-
-def eprint(*args: Any) -> None:
-    """Print to stderr."""
-    print(*args, file=sys.stderr)
-
-
-def now_local() -> datetime:
-    """Get current local datetime."""
-    return datetime.now()
-
-
-def now_iso() -> str:
-    """Get current time as ISO 8601 string."""
-    return datetime.now().isoformat()
-
-
-def project_dir(payload: Optional[Dict[str, Any]] = None) -> Path:
-    """
-    Get project directory from payload or environment.
-
-    Priority:
-    1. CLAUDE_PROJECT_DIR environment variable
-    2. 'cwd' from payload (if provided)
-    3. Current working directory
-
-    Args:
-        payload: Optional hook payload with 'cwd' field
-
-    Returns:
-        Path to project directory
-
-    Note:
-        CLAUDE_PROJECT_DIR is validated to be an absolute path when provided.
-    """
-    p = os.environ.get("CLAUDE_PROJECT_DIR")
-    if p:
-        # Validate that CLAUDE_PROJECT_DIR is an absolute path
-        path = Path(p)
-        if not path.is_absolute():
-            log_warn("utils", "CLAUDE_PROJECT_DIR is not absolute, using cwd instead")
-            p = None
-        else:
-            # Check for suspicious patterns
-            if '..' in str(path):
-                log_warn("utils", "CLAUDE_PROJECT_DIR contains '..' pattern, using cwd instead")
-                p = None
-
-    if not p and payload:
-        p = payload.get("cwd")
-    if not p:
-        p = os.getcwd()
-    return Path(p)
-
-
-# Windows reserved filenames that should be blocked
-_WINDOWS_RESERVED = frozenset([
-    'CON', 'PRN', 'AUX', 'NUL',
-    'COM1', 'COM2', 'COM3', 'COM4', 'COM5', 'COM6', 'COM7', 'COM8', 'COM9',
-    'LPT1', 'LPT2', 'LPT3', 'LPT4', 'LPT5', 'LPT6', 'LPT7', 'LPT8', 'LPT9',
-])
-
-
-def sanitize_filename(s: str, max_len: int = 32, allow_leading_dot: bool = False) -> str:
-    """
-    Sanitize string for use in filename.
-
-    Replaces non-alphanumeric characters (except ._-) with underscores,
-    strips leading/trailing special characters, and truncates.
-
-    Args:
-        s: Input string
-        max_len: Maximum length (default: 32)
-        allow_leading_dot: Whether to allow leading dots (default: False for security)
-
-    Returns:
-        Sanitized filename-safe string
-    """
-    s = re.sub(r"[^A-Za-z0-9._-]+", "_", s)
-    result = s.strip("._-")[:max_len] or "unknown"
-
-    # Remove leading dots unless explicitly allowed (prevents hidden files)
-    if not allow_leading_dot:
-        result = result.lstrip('.')
-
-    # Check for Windows reserved names
-    base_name = result.split('.')[0].upper()
-    if base_name in _WINDOWS_RESERVED:
-        result = f"_{result}"
-
-    return result or "unknown"
-
-
-def sanitize_title(s: str, max_len: int = 50) -> str:
-    """
-    Sanitize title for use in context ID or filename.
-
-    Converts spaces to hyphens, replaces special characters,
-    and normalizes to lowercase.
-
-    Args:
-        s: Input string
-        max_len: Maximum length (default: 50)
-
-    Returns:
-        Sanitized slug-like string
-    """
-    s = s.lower().strip()
-    s = s.replace(' ', '-')
-    s = re.sub(r"[^a-z0-9._-]+", "_", s)
-    s = re.sub(r"[-_]+", "-", s)
-    result = s.strip("._-")[:max_len] or "unknown"
-
-    # Check for Windows reserved names
-    base_name = result.split('.')[0].upper()
-    if base_name in _WINDOWS_RESERVED:
-        result = f"_{result}"
-
-    return result or "unknown"
-
-
-def clean_text_for_slug(text: str) -> str:
-    """
-    Clean text for stop-word matching in slug generation.
-
-    Strips apostrophes (i'm -> im), removes punctuation, normalizes whitespace.
-    This ensures words like "generation," match their stop-word counterparts.
-    """
-    if not text:
-        return ""
-    text = text.lower()
-    text = re.sub(r"'", "", text)          # i'm -> im, you're -> youre
-    text = re.sub(r"[^a-z0-9\s]", " ", text)  # punctuation -> spaces
-    text = re.sub(r"\s+", " ", text).strip()
-    return text
-
-
-def generate_context_id(summary: str, existing_ids: Optional[set] = None) -> str:
-    """
-    Generate a context ID from a summary string.
-
-    Prepends a YYMMDD-HHMM local-time timestamp for visual
-    distinguishability, then filters stop words and slugifies.
-
-    Args:
-        summary: Context summary text
-        existing_ids: Optional set of existing context IDs to avoid
-
-    Returns:
-        Unique context ID string (e.g. '260205-1700-add-user-auth')
-    """
-    # Timestamp prefix using local time, to the minute
-    timestamp = datetime.now().strftime("%y%m%d-%H%M")
-
-    try:
-        if not summary or not summary.strip():
-            base_id = f"{timestamp}-context"
-        else:
-            slug = None
-            # Pre-clean for Tier 2/3: strip punctuation so stop words match
-            cleaned_summary = clean_text_for_slug(summary)
-
-            # Tier 1: AI inference for high-quality keyword slugs
-            try:
-                from .inference import generate_context_id_slug
-                ai_slug = generate_context_id_slug(summary)
-                if ai_slug:
-                    # Post-inference stop-word filter: remove generic words the AI included
-                    from .stop_words import STOP_WORDS
-                    filtered_words = [w for w in ai_slug.split() if w.lower() not in STOP_WORDS and len(w) > 1]
-                    if len(filtered_words) >= 5:
-                        slug = sanitize_title(' '.join(filtered_words), max_len=150)
-                    else:
-                        log_debug("utils", f"AI slug too generic after stop-word filter ({len(filtered_words)} words remain), using fallback")
-            except Exception as e:
-                log_warn("utils", f"AI context ID slug failed, using fallback: {e}")
-
-            # Tier 2: Stop-word filtering on cleaned text
-            if not slug:
-                try:
-                    from .stop_words import STOP_WORDS
-                    words = [w for w in cleaned_summary.split() if w not in STOP_WORDS and len(w) > 1][:12]
-                    if len(words) >= 3:
-                        slug = sanitize_title(' '.join(words), max_len=150)
-                    else:
-                        log_debug("utils", f"Tier 2 too few content words ({len(words)}), falling through to Tier 3")
-                except Exception as e:
-                    log_warn("utils", f"Stop-word fallback failed: {e}")
-
-            # Tier 3: Simple word-length filter on cleaned text (no imports needed)
-            if not slug or slug == "unknown":
-                words = [w for w in cleaned_summary.split() if len(w) > 2][:6]
-                slug = sanitize_title(' '.join(words), max_len=150) if words else "context"
-
-            base_id = f"{timestamp}-{slug}"
-    except Exception as e:
-        log_error("utils", f"Context ID generation failed entirely, using timestamp: {e}")
-        base_id = f"{timestamp}-context"
-
-    if not existing_ids:
-        return base_id
-
-    # Ensure uniqueness by appending counter if needed
-    if base_id not in existing_ids:
-        return base_id
-
-    counter = 2
-    while f"{base_id}-{counter}" in existing_ids:
-        counter += 1
-
-    return f"{base_id}-{counter}"
-
-
-def format_timestamp(dt: Optional[datetime] = None) -> str:
-    """
-    Format datetime for display.
-
-    Args:
-        dt: Datetime to format (default: now)
-
-    Returns:
-        Formatted string like "2026-01-25 10:30:00"
-    """
-    if dt is None:
-        dt = now_local()
-    return dt.strftime("%Y-%m-%d %H:%M:%S")
-
-
-def parse_iso_timestamp(iso_str: str) -> Optional[datetime]:
-    """
-    Parse ISO 8601 timestamp string.
-
-    Args:
-        iso_str: ISO format timestamp
-
-    Returns:
-        datetime object or None if parsing fails
-    """
-    try:
-        # Handle both with and without microseconds
-        if '.' in iso_str:
-            return datetime.fromisoformat(iso_str)
-        else:
-            return datetime.fromisoformat(iso_str.replace('Z', '+00:00'))
-    except (ValueError, TypeError):
-        return None

package/dist/templates/_shared/lib/context/__init__.py

@@ -1,102 +0,0 @@
-"""Context management for AIW CLI templates.
-
-New 2-layer architecture:
-  context_store.py    — CRUD for state.json + index.json
-  context_selector.py — 5-case context selection (session match, caret, plan match, default)
-  context_formatter.py — All display formatting
-  plan_manager.py     — Plan archival, lookup, path extraction
-  task_tracker.py     — Direct state.json task CRUD
-"""
-from .context_store import (
-    ContextState,
-    get_all_contexts,
-    get_context,
-    get_context_by_session_id,
-    create_context,
-    create_context_from_prompt,
-    update_context,
-    complete_context,
-    reopen_context,
-    archive_context,
-    bind_session,
-    update_mode,
-    maybe_activate,
-    load_state,
-    save_state,
-)
-from .context_selector import (
-    determine_context,
-    BlockRequest,
-    parse_chained_caret,
-    resolve_context_by_prefix,
-)
-from .context_formatter import (
-    format_context_list,
-    format_context_created,
-    format_context_picker_stderr,
-    format_active_context_reminder,
-    format_handoff_continuation,
-    format_plan_continuation,
-    format_active_continuation,
-    format_command_feedback,
-    format_relative_time,
-)
-from .plan_manager import (
-    archive_plan,
-    find_latest_plan,
-    extract_plan_path_from_result,
-)
-from .task_tracker import (
-    add_task,
-    update_task,
-    delete_task,
-    get_tasks,
-    generate_task_summary,
-    generate_next_task_id,
-)
-
-__all__ = [
-    # Data model
-    "ContextState",
-    # Context store (CRUD)
-    "get_all_contexts",
-    "get_context",
-    "get_context_by_session_id",
-    "create_context",
-    "create_context_from_prompt",
-    "update_context",
-    "complete_context",
-    "reopen_context",
-    "archive_context",
-    "bind_session",
-    "update_mode",
-    "maybe_activate",
-    "load_state",
-    "save_state",
-    # Context selector
-    "determine_context",
-    "BlockRequest",
-    "parse_chained_caret",
-    "resolve_context_by_prefix",
-    # Formatting
-    "format_context_list",
-    "format_context_created",
-    "format_context_picker_stderr",
-    "format_active_context_reminder",
-    "format_handoff_continuation",
-    "format_plan_continuation",
-    "format_active_continuation",
-    "format_command_feedback",
-    "format_relative_time",
-    # Plan manager
-    "archive_plan",
-    "find_latest_plan",
-    "extract_plan_path_from_result",
-    # Task tracker
-    "add_task",
-    "update_task",
-    "delete_task",
-    "get_tasks",
-    "generate_task_summary",
-    "generate_next_task_id",
-]