aiwcli 0.10.3 → 0.11.1

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

@@ -1,305 +0,0 @@
-"""Unified logging for all hooks and libraries.
-
-Provides a single logging interface that replaces:
-- log_hook_error() from hook_utils.py (error-only, plain text)
-- debug.py from cc-native (per-context, plain text)
-- eprint() for diagnostic output (stderr-only, no persistence)
-
-Log format: JSONL (one JSON object per line)
-Log location: _output/hook-log.jsonl (global, all sessions)
-Filter by session using the "sid" field.
-
-Environment variables:
-- HOOK_LOG_DISABLE=1: Disable all file logging
-- HOOK_LOG_LEVEL=warn: Minimum level to log (default: debug)
-- HOOK_ERROR_LOG_DISABLE=1: Legacy alias for HOOK_LOG_DISABLE
-
-Never raises — all errors silently swallowed.
-No buffering — each call is one open+write+close.
-Stdlib only — json, os, sys, datetime, pathlib.
-"""
-
-import json
-import os
-import sys
-from datetime import datetime, timezone
-from pathlib import Path
-from typing import Any, Dict, Optional
-
-_LEVELS = {"debug": 0, "info": 1, "warn": 2, "error": 3}
-
-_MAX_LOG_LINES = 10_000  # Max lines in global log before pruning
-
-# Module-level context path cache.
-# Set once per hook process via set_context_path() or auto-resolved on first use.
-_cached_context_path: Optional[Path] = None
-_context_resolved: bool = False
-
-# Module-level session ID cache.
-# Set once per hook process via set_session_id().
-_cached_session_id: Optional[str] = None
-
-
-def set_session_id(session_id: Optional[str]) -> None:
-    """Set the session ID for this process. All subsequent log calls include it.
-
-    Args:
-        session_id: Claude Code session ID (e.g., "a1b2c3d4")
-                    or None to clear.
-    """
-    global _cached_session_id
-    _cached_session_id = session_id
-
-
-def set_context_path(path: Optional[Path]) -> None:
-    """Set the context path for this process. All subsequent log calls use it.
-
-    Call this once in your hook after resolving the context:
-        from lib.base.logger import set_context_path
-        set_context_path(get_context_dir(context_id, project_root))
-
-    Args:
-        path: Path to context folder (e.g., _output/contexts/<context-id>/)
-              or None to force global-only logging.
-    """
-    global _cached_context_path, _context_resolved
-    _cached_context_path = path
-    _context_resolved = True
-
-
-def _auto_resolve_context_path() -> Optional[Path]:
-    """Try to auto-resolve context path from session_id. Called once per process.
-
-    Uses the context store to look up which context owns this session,
-    then returns its directory path. Falls back to None (global log).
-    """
-    global _cached_context_path, _context_resolved
-    _context_resolved = True  # Don't retry on failure
-
-    try:
-        from ..context.context_store import get_context_by_session_id
-        from .constants import get_context_dir
-
-        # Hook input isn't available here, but we can check if a recent
-        # context dir exists by scanning _output/contexts/ for one that
-        # has a state.json with a matching session
-        # This is too expensive for a logger. Instead, rely on set_context_path().
-    except Exception:
-        pass
-
-    return None
-
-
-def _get_context_path() -> Optional[Path]:
-    """Get the cached context path, auto-resolving on first call."""
-    global _context_resolved
-    if not _context_resolved:
-        _auto_resolve_context_path()
-    return _cached_context_path
-
-
-def _get_min_level() -> int:
-    """Get minimum log level from environment."""
-    env = os.environ.get("HOOK_LOG_LEVEL", "debug").lower()
-    return _LEVELS.get(env, 0)
-
-
-def _is_disabled() -> bool:
-    """Check if file logging is disabled."""
-    if os.environ.get("HOOK_LOG_DISABLE") == "1":
-        return True
-    if os.environ.get("HOOK_ERROR_LOG_DISABLE") == "1":
-        return True
-    return False
-
-
-def _get_project_root() -> Path:
-    """Get project root from environment or cwd."""
-    env_dir = os.environ.get("CLAUDE_PROJECT_DIR", "")
-    return Path(env_dir) if env_dir else Path.cwd()
-
-
-def hook_log(
-    level: str,
-    hook_name: str,
-    message: str,
-    *,
-    component: str = "",
-    data: Any = None,
-    traceback_str: str = "",
-    stderr: bool = True,
-) -> None:
-    """Write a structured log entry to the global hook log.
-
-    All entries go to _output/hook-log.jsonl. Use the "sid" field
-    (set via set_session_id) to filter by session.
-
-    Args:
-        level: "debug" | "info" | "warn" | "error"
-        hook_name: Hook or module name (e.g., "session_end")
-        message: Log message
-        component: Sub-component (e.g., "git", "parse")
-        data: Optional structured data (must be JSON-serializable)
-        traceback_str: Optional traceback string
-        stderr: Also write to stderr (default: True)
-    """
-    try:
-        level_lower = level.lower()
-        level_num = _LEVELS.get(level_lower, 0)
-
-        # Write to stderr if requested
-        if stderr:
-            prefix = f"[{hook_name}]"
-            if component:
-                prefix = f"[{hook_name}:{component}]"
-            print(f"{prefix} {message}", file=sys.stderr)
-            if traceback_str:
-                print(traceback_str, file=sys.stderr)
-
-        # Check if file logging is enabled
-        if _is_disabled():
-            return
-
-        # Check minimum level
-        if level_num < _get_min_level():
-            return
-
-        # Build JSONL entry
-        ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%S.%f")[:-3]
-        entry: Dict[str, Any] = {
-            "ts": ts,
-            "level": level_lower,
-            "hook": hook_name,
-            "msg": message,
-        }
-        if _cached_session_id:
-            entry["sid"] = _cached_session_id
-        if component:
-            entry["component"] = component
-        if data is not None:
-            try:
-                json.dumps(data, default=str)  # Validate serializable
-                entry["data"] = data
-            except (TypeError, ValueError):
-                entry["data"] = str(data)
-        if traceback_str:
-            entry["tb"] = traceback_str.rstrip()
-
-        line = json.dumps(entry, ensure_ascii=True, default=str) + "\n"
-
-        # Always write to global log
-        project_root = _get_project_root()
-        log_path = project_root / "_output" / "hook-log.jsonl"
-
-        log_path.parent.mkdir(parents=True, exist_ok=True)
-
-        # Line-count guard: prune to last _MAX_LOG_LINES
-        if log_path.exists():
-            try:
-                with open(log_path, "r", encoding="utf-8", errors="replace") as f:
-                    existing = f.readlines()
-                if len(existing) > _MAX_LOG_LINES:
-                    with open(log_path, "w", encoding="utf-8") as f:
-                        f.writelines(existing[-_MAX_LOG_LINES:])
-            except OSError:
-                pass
-
-        with open(log_path, "a", encoding="utf-8") as f:
-            f.write(line)
-
-    except Exception:
-        pass  # Never crash
-
-
-def log_debug(hook_name: str, message: str, **kwargs: Any) -> None:
-    """Log a debug-level message."""
-    hook_log("debug", hook_name, message, **kwargs)
-
-
-def log_info(hook_name: str, message: str, **kwargs: Any) -> None:
-    """Log an info-level message."""
-    hook_log("info", hook_name, message, **kwargs)
-
-
-def log_warn(hook_name: str, message: str, **kwargs: Any) -> None:
-    """Log a warn-level message."""
-    hook_log("warn", hook_name, message, **kwargs)
-
-
-def log_error(hook_name: str, message: str, **kwargs: Any) -> None:
-    """Log an error-level message."""
-    hook_log("error", hook_name, message, **kwargs)
-
-
-def log_diagnostic(
-    hook_name: str,
-    phase: str,
-    summary: str,
-    *,
-    inputs: Any = None,
-    decision: Any = None,
-    reasoning: Any = None,
-    component: str = "diag",
-    data: Any = None,
-) -> None:
-    """Log a structured diagnostic entry at a hook decision point.
-
-    Emits a debug-level JSONL entry with tagged, filterable data.
-    Use at key decision points: receive (what came in), decide (what was chosen),
-    result (what happened).
-
-    Args:
-        hook_name: Hook or module name (e.g., "session_start")
-        phase: Decision phase — "receive", "decide", or "result"
-        summary: One-line description (e.g., "source=clear, session=a1b2c3d4")
-        inputs: Input data relevant to this phase
-        decision: The decision made (for "decide" phase)
-        reasoning: Why this decision was made
-        component: Log component tag (default: "diag")
-        data: Extra data to merge into the structured entry
-    """
-    diag_data: Dict[str, Any] = {"phase": phase}
-    if inputs is not None:
-        diag_data["inputs"] = inputs
-    if decision is not None:
-        diag_data["decision"] = decision
-    if reasoning is not None:
-        diag_data["reasoning"] = reasoning
-    if data is not None and isinstance(data, dict):
-        diag_data.update(data)
-    hook_log(
-        "debug",
-        hook_name,
-        f"[DIAG:{phase}] {summary}",
-        component=component,
-        data=diag_data,
-    )
-
-
-def log_hook_error(
-    hook_name: str,
-    error: Exception,
-    hook_event: str = "unknown",
-    traceback_str: str = "",
-) -> None:
-    """Backward-compatible wrapper matching the old hook_utils.log_hook_error signature.
-
-    Delegates to hook_log("error", ...) with the same behavior:
-    - Message capped at 200 chars, newlines stripped
-    - Never raises
-
-    Args:
-        hook_name: Name of the hook
-        error: The exception that occurred
-        hook_event: Hook event type (e.g., "PreToolUse")
-        traceback_str: Optional formatted traceback
-    """
-    msg = str(error).replace("\n", " ").replace("\r", "")[:200]
-    err_type = type(error).__name__
-    hook_log(
-        "error",
-        hook_name,
-        f"[{hook_event}] {err_type}: {msg}",
-        traceback_str=traceback_str,
-        stderr=True,
-    )

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'