aiwcli 0.10.3 → 0.11.0

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

@@ -1,221 +0,0 @@
-"""Stop words for context ID generation.
-
-Generated from analysis of 1,424 prompts, context summaries, and plan files.
-Words that appear frequently but don't help identify the specific task.
-
-Categories organized for maintainability. Add new corpus-derived words to
-the appropriate category or to "Corpus-derived additions" at the end.
-
-ACTION VERBS ARE INTENTIONALLY EXCLUDED from this list:
-add, fix, update, create, implement, refactor, migrate, debug, remove, change,
-move, rename, delete, build, test, deploy, verify, analyze, modify, write, run,
-check, replace, save, sync, load, extract, install, refactor, clean, merge, etc.
-
-These action verbs should REMAIN in context IDs as they identify the task type.
-"""
-
-STOP_WORDS = {
-    # ========================================================================
-    # ARTICLES
-    # ========================================================================
-    'a', 'an', 'the',
-
-    # ========================================================================
-    # PREPOSITIONS
-    # ========================================================================
-    'to', 'for', 'in', 'on', 'at', 'by', 'with', 'from', 'of', 'about',
-    'into', 'over', 'under', 'between', 'through', 'during', 'before', 'after',
-    'above', 'below', 'against', 'among', 'around', 'behind', 'beside', 'besides',
-    'beyond', 'down', 'inside', 'outside', 'near', 'off', 'onto', 'out',
-    'since', 'toward', 'towards', 'until', 'upon', 'within', 'without',
-    'across', 'along', 'via', 'per',
-
-    # ========================================================================
-    # PRONOUNS
-    # ========================================================================
-    # Personal pronouns
-    'i', 'you', 'he', 'she', 'it', 'we', 'they',
-    'me', 'him', 'her', 'us', 'them',
-    'myself', 'yourself', 'himself', 'herself', 'itself', 'ourselves', 'themselves',
-
-    # Possessive pronouns
-    'my', 'your', 'his', 'her', 'its', 'our', 'their',
-    'mine', 'yours', 'hers', 'ours', 'theirs',
-
-    # Demonstrative pronouns
-    'this', 'that', 'these', 'those',
-
-    # Relative pronouns
-    'who', 'whom', 'whose', 'which', 'that',
-
-    # Indefinite pronouns
-    'someone', 'somebody', 'something', 'anyone', 'anybody', 'anything',
-    'everyone', 'everybody', 'everything', 'no one', 'nobody', 'nothing',
-    'one', 'ones',
-
-    # ========================================================================
-    # AUXILIARY/MODAL VERBS
-    # ========================================================================
-    'am', 'is', 'are', 'was', 'were', 'be', 'been', 'being',
-    'have', 'has', 'had', 'having',
-    'do', 'does', 'did', 'doing', 'done',
-    'can', 'could', 'will', 'would', 'shall', 'should', 'may', 'might', 'must',
-
-    # ========================================================================
-    # CONJUNCTIONS
-    # ========================================================================
-    'and', 'or', 'but', 'nor', 'so', 'yet', 'for',
-    'if', 'then', 'else', 'whether', 'unless', 'although', 'though',
-    'because', 'since', 'while', 'whereas', 'whenever', 'wherever',
-
-    # ========================================================================
-    # QUESTION WORDS
-    # ========================================================================
-    'what', 'when', 'where', 'why', 'how',
-
-    # ========================================================================
-    # ADVERBS OF PLACE/TIME
-    # ========================================================================
-    'here', 'there', 'now', 'then', 'always', 'never', 'often', 'sometimes',
-    'already', 'still', 'yet', 'soon', 'later', 'ago', 'today', 'tomorrow',
-    'yesterday', 'currently', 'previously', 'recently', 'immediately',
-    'finally', 'eventually', 'meanwhile', 'afterwards',
-
-    # ========================================================================
-    # NEGATION
-    # ========================================================================
-    'no', 'not', 'none', 'never', 'neither', 'nor',
-    'don', 'doesn', 'didn', 'won', 'wouldn', 'couldn', 'shouldn',
-    'isn', 'aren', 'wasn', 'weren', 'hasn', 'haven', 'hadn',
-
-    # ========================================================================
-    # QUANTIFIERS
-    # ========================================================================
-    'some', 'any', 'all', 'each', 'every', 'both', 'few', 'more', 'most',
-    'many', 'much', 'several', 'other', 'another', 'enough', 'less', 'least',
-    'either', 'neither', 'such',
-
-    # ========================================================================
-    # FILLER/HEDGE WORDS
-    # ========================================================================
-    'just', 'also', 'only', 'really', 'actually', 'basically', 'simply',
-    'very', 'quite', 'rather', 'pretty', 'somewhat', 'almost', 'nearly',
-    'exactly', 'completely', 'entirely', 'totally', 'absolutely',
-    'probably', 'possibly', 'maybe', 'perhaps', 'definitely', 'certainly',
-    'apparently', 'obviously', 'clearly', 'literally', 'essentially',
-
-    # ========================================================================
-    # SPEECH-TO-TEXT FILLERS (STT artifacts from voice input)
-    # ========================================================================
-    'um', 'uh', 'ah', 'oh', 'hmm', 'hm', 'er', 'eh', 'huh',
-    'hey', 'hi', 'hello', 'yeah', 'yep', 'yup', 'nah', 'nope',
-    'gonna', 'gotta', 'wanna', 'kinda', 'sorta',
-    'stuff', 'anyway', 'anyways', 'alright', 'right', 'well',
-
-    # ========================================================================
-    # COMMON REQUEST PHRASES (from corpus: high frequency in prompts)
-    # ========================================================================
-    'want', 'need', 'help', 'please', 'like', 'let', 'get',
-    'think', 'know', 'see', 'try', 'make', 'give', 'take',
-    'look', 'looking', 'trying', 'going', 'getting', 'making',
-
-    # ========================================================================
-    # COMMON NON-ACTION VERBS
-    # ========================================================================
-    'go', 'come', 'put', 'say', 'tell', 'ask', 'find', 'keep',
-    'seem', 'appear', 'become', 'remain', 'stay', 'feel', 'show', 'mean',
-    'include', 'provide', 'require', 'allow', 'expect', 'cause',
-    'follow', 'consider', 'continue', 'start', 'begin', 'end',
-    'contain', 'contain', 'contains',
-
-    # ========================================================================
-    # LINKING/TRANSITION WORDS
-    # ========================================================================
-    'however', 'therefore', 'thus', 'hence', 'otherwise', 'instead',
-    'moreover', 'furthermore', 'nevertheless', 'nonetheless', 'accordingly',
-    'consequently', 'similarly', 'likewise', 'conversely', 'alternatively',
-
-    # ========================================================================
-    # CORPUS-DERIVED HIGH-FREQUENCY NOISE (from 1,424 docs analysis)
-    # ========================================================================
-    # Words appearing in >10% of documents that don't identify the task
-
-    # File extensions/technical noise (appear in paths, not task descriptors)
-    'py', 'md', 'ts', 'json', 'js', 'yaml', 'toml', 'exe', 'bat',
-
-    # Common Claude/coding terms that don't identify specific tasks
-    'using', 'used', 'uses',
-    'based', 'following',
-    'same', 'different', 'specific', 'existing', 'new', 'current', 'first',
-    'full', 'complete', 'single', 'multiple', 'simple',
-    'needed', 'required', 'provided', 'expected', 'correctly',
-    'works', 'working', 'work',
-
-    # Common structural words from plan files
-    'step', 'steps', 'phase', 'below', 'above',
-
-    # Query/clarification language (high frequency in prompts)
-    'questions', 'question', 'clarification',
-
-    # Overly generic terms
-    'thing', 'things', 'way', 'ways', 'kind', 'type', 'types',
-    'example', 'examples', 'case', 'cases',
-    'part', 'parts', 'point', 'points',
-    'time', 'times', 'next', 'last', 'end',
-    'set', 'list', 'group', 'item', 'items',
-
-    # ========================================================================
-    # PROGRAMMING KEYWORDS (code tokens that leak from pasted code)
-    # ========================================================================
-    'self', 'def', 'return', 'import', 'true', 'false', 'none', 'str',
-    'const', 'async', 'class', 'assert', 'except', 'dict', 'len', 'args',
-    'sys', 'eprint', 'elif', 'lambda', 'yield', 'pass',
-
-    # ========================================================================
-    # GENERIC ADJECTIVES (non-specific modifiers)
-    # ========================================================================
-    'high', 'low', 'important', 'critical', 'optional', 'manual',
-    'real', 'empty', 'stable', 'active', 'proper', 'correct',
-    'basic', 'main', 'primary', 'secondary', 'general', 'overall',
-
-    # ========================================================================
-    # GENERIC TECHNICAL NOUNS (common but non-specific)
-    # ========================================================================
-    'information', 'format', 'status', 'method', 'purpose', 'result',
-    'source', 'value', 'option', 'options', 'feature', 'features', 'issue',
-    'process', 'version', 'mode', 'state',
-
-    # ========================================================================
-    # DOCUMENT/CODE STRUCTURE (generic structural terms)
-    # ========================================================================
-    'section', 'lines', 'line', 'folder', 'directory', 'index',
-    'level', 'block', 'chunk', 'region', 'header', 'footer',
-
-    # ========================================================================
-    # FRAGMENT WORDS (artifacts from contractions/tokenization)
-    # ========================================================================
-    're', 'pl', 'aiw', 've', 'll', 'doesn', 't', 's',
-
-    # ========================================================================
-    # CORPUS-DERIVED SHORT NOISE (2026-02 analysis of 131 docs)
-    # ========================================================================
-    # Contractions with punctuation stripped (I'm -> im, etc.)
-    'im', 'ive', 'id', 'ill', 'youre', 'youve', 'youll',
-    'hes', 'shes', 'weve', 'theyre', 'theyve', 'dont', 'doesnt',
-    'didnt', 'wont', 'wouldnt', 'cant', 'couldnt', 'shouldnt', 'isnt',
-    'arent', 'wasnt', 'werent', 'hasnt', 'havent', 'hadnt', 'lets',
-    'thats', 'whats', 'heres', 'theres', 'whos',
-
-    # Filler/noise from corpus (>10% frequency, non-action)
-    'etc', 'up', 'as', 'cc',
-
-    # Number words (common in plans but don't identify task)
-    'two', 'three', 'four', 'five', 'six', 'seven', 'eight', 'nine', 'ten',
-
-    # Single letters (artifacts from lists, paths, variables)
-    'b', 'c', 'd', 'e', 'f', 'g', 'h', 'j', 'k', 'l', 'm', 'n', 'o', 'p',
-    'q', 'r', 'u', 'v', 'w', 'x', 'y', 'z',
-
-    # Short adverbs/fillers from review
-    'too', 'yes', 'ok', 'okay',
-}

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

@@ -1,46 +0,0 @@
-"""Utilities for subprocess calls that invoke Claude Code CLI.
-
-Provides centralized management of environment flags for internal subprocess calls
-(orchestrator, agents, inference) to prevent recursion and unnecessary hook overhead.
-"""
-import os
-from typing import Dict
-
-# Environment variable names - single source of truth
-ENV_INTERNAL_CALL = "AIWCLI_INTERNAL_CALL"
-
-
-def get_internal_subprocess_env() -> Dict[str, str]:
-    """Get environment dict for internal Claude Code subprocess calls.
-
-    This prevents internal subprocess calls (orchestrator, agents, inference)
-    from triggering hooks that would cause recursion or unnecessary overhead.
-
-    All hooks should check is_internal_call() and return early if True.
-
-    Returns:
-        Environment dict with AIWCLI_INTERNAL_CALL flag set
-
-    Example:
-        >>> env = get_internal_subprocess_env()
-        >>> subprocess.run(['claude', '--agent', 'my-agent'], env=env)
-    """
-    env = os.environ.copy()
-    env[ENV_INTERNAL_CALL] = 'true'
-    return env
-
-
-def is_internal_call() -> bool:
-    """Check if current process is an internal subprocess call.
-
-    Hooks should check this at the beginning and return early to avoid
-    recursion and unnecessary processing for internal subprocess calls.
-
-    Returns:
-        True if this is an internal call that should skip hooks
-
-    Example:
-        >>> if is_internal_call():
-        ...     return  # Skip hook processing
-    """
-    return os.environ.get(ENV_INTERNAL_CALL) == 'true'

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",
-]