aiwcli 0.10.2 → 0.11.0

package/dist/templates/_shared/lib/templates/README.md

@@ -1,206 +0,0 @@
-# Shared Templates Module
-
-Centralized templates and formatters for consistent context management output across context formatting, handoff, and hooks.
-
-## Purpose
-
-This module eliminates duplication by providing a single source of truth for:
-- Mode displays (planning, implementing, etc.)
-- Status icons (pending, in_progress, completed)
-- Task rendering formatters
-- Context continuation headers
-- Plan context templates
-- Handoff reason formatting
-
-## Modules
-
-### `formatters.py`
-
-Core formatters and constants for context management output.
-
-#### Constants
-
-```python
-MODE_DISPLAY_MAP = {
-    "planning": "[Planning]",
-    "pending_implementation": "[Plan Ready]",
-    "implementing": "[Implementing]",
-    "none": "",
-}
-
-STATUS_ICON_MAP = {
-    "pending": "⬜",
-    "in_progress": "🔄",
-    "blocked": "🚫",
-    "completed": "✅",
-}
-
-REASON_MAP = {
-    "low_context": "Context window running low",
-    "user_requested": "User requested handoff",
-    "error_recovery": "Error recovery",
-    "session_end": "Session ending",
-}
-```
-
-#### Functions
-
-**`get_mode_display(mode: str) -> str`**
-
-Get display string for in-flight mode.
-
-```python
->>> get_mode_display("planning")
-"[Planning]"
->>> get_mode_display("none")
-""
-```
-
-**`get_status_icon(status: str) -> str`**
-
-Get emoji icon for task status.
-
-```python
->>> get_status_icon("pending")
-"⬜"
->>> get_status_icon("completed")
-"✅"
-```
-
-**`render_task_item(task, show_description=True, max_description_length=100) -> str`**
-
-Render single task with status icon and subject.
-
-```python
-task = {"status": "pending", "subject": "Fix bug", "description": "Details"}
->>> render_task_item(task)
-"- ⬜ [PENDING] Fix bug\n  - Details"
-```
-
-**`render_task_list(tasks, header="Active Tasks", show_description=True) -> str`**
-
-Render list of tasks with header.
-
-```python
-tasks = [{"status": "pending", "subject": "Task 1", "description": "Details"}]
->>> render_task_list(tasks, header="My Tasks")
-"### My Tasks\n\n- ⬜ [PENDING] Task 1\n  - Details\n"
-```
-
-**`format_continuation_header(header_type: str, context_id: str) -> str`**
-
-Format continuation header for various scenarios.
-
-```python
->>> format_continuation_header("resuming", "my-context")
-"## RESUMING FROM HANDOFF: my-context"
-```
-
-Types: `context`, `resuming`, `implementing`, `handoff`
-
-**`format_reason(reason: str) -> str`**
-
-Format handoff reason code as human-readable string.
-
-```python
->>> format_reason("low_context")
-"Context window running low"
-```
-
-### `plan_context.py`
-
-Plan context templates for the add_plan_context hook.
-
-**`get_evaluation_context_reminder() -> str`**
-
-Returns the evaluation context reminder template that prompts Claude to add evaluation context to plans.
-
-## Usage
-
-### In Discovery Functions
-
-```python
-from ..templates.formatters import (
-    get_mode_display,
-    get_status_icon,
-    format_continuation_header,
-)
-
-# Display mode status
-mode_display = get_mode_display(context.in_flight.mode)
-status = f"Context: {context.id} {mode_display}"
-
-# Render task with icon
-icon = get_status_icon(task.status)
-output = f"{icon} {task.subject}"
-
-# Create continuation header
-header = format_continuation_header("implementing", context.id)
-```
-
-### In Document Generator
-
-```python
-from ..templates.formatters import render_task_list, format_reason
-
-# Render task list section
-tasks_md = render_task_list(doc.active_tasks, header="Active Tasks")
-lines.append(tasks_md)
-
-# Format handoff reason
-reason_text = format_reason(doc.reason)
-```
-
-### In Hooks
-
-```python
-from templates.plan_context import get_evaluation_context_reminder
-
-# Get plan context template
-CONTEXT_REMINDER = get_evaluation_context_reminder()
-```
-
-## Dependent Files
-
-Files that import from this module:
-
-- `.aiwcli/_shared/lib/context/context_formatter.py`
-  - Uses: `get_mode_display`, `get_status_icon`, `format_continuation_header`
-
-- `.aiwcli/_shared/lib/handoff/document_generator.py`
-  - Uses: `render_task_list`, `format_continuation_header`, `format_reason`
-
-- `.aiwcli/_cc-native/hooks/add_plan_context.py`
-  - Uses: `get_evaluation_context_reminder`
-
-## Design Principles
-
-1. **Single Source of Truth**: Each constant/function exists in one location only
-2. **Backward Compatible**: All functions preserve existing output formats
-3. **Type Flexible**: Functions handle both Task objects and dicts
-4. **Fail-Safe**: Use `.get()` with defaults for missing keys
-
-## Testing
-
-```bash
-# Test imports
-cd .aiwcli
-python -c "from _shared.lib.templates.formatters import get_mode_display; \
-           assert get_mode_display('planning') == '[Planning]'"
-
-# Test task rendering
-python -c "from _shared.lib.templates.formatters import get_status_icon; \
-           assert get_status_icon('pending') != ''"
-```
-
-## Synchronization
-
-Changes to this module must be synchronized to the template directory:
-
-```bash
-# After editing
-cp .aiwcli/_shared/lib/templates/*.py \
-   packages/cli/src/templates/_shared/lib/templates/
-```
-
-See `CLAUDE.md` for template synchronization requirements.

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

@@ -1,36 +0,0 @@
-"""Shared templates and formatters for context management output.
-
-This module provides centralized templates for:
-- Mode displays (planning, implementing, etc.)
-- Status icons (pending, in_progress, completed)
-- Task rendering
-- Context continuation headers
-
-Used by context_formatter.py, document_generator.py, and hooks.
-"""
-
-from .formatters import (
-    MODE_DISPLAY_MAP,
-    STATUS_ICON_MAP,
-    REASON_MAP,
-    get_mode_display,
-    get_status_icon,
-    render_task_item,
-    render_task_list,
-    format_continuation_header,
-    format_reason,
-)
-from .plan_context import get_evaluation_context_reminder
-
-__all__ = [
-    "MODE_DISPLAY_MAP",
-    "STATUS_ICON_MAP",
-    "REASON_MAP",
-    "get_mode_display",
-    "get_status_icon",
-    "render_task_item",
-    "render_task_list",
-    "format_continuation_header",
-    "format_reason",
-    "get_evaluation_context_reminder",
-]

package/dist/templates/_shared/lib/templates/formatters.py

@@ -1,146 +0,0 @@
-"""Formatters for context management templates.
-
-Provides constants and helper functions for consistent formatting
-across discovery, handoff, and hook output.
-"""
-
-from typing import Any, Dict, List, Optional, Union
-
-# Mode display mapping for in-flight work states
-MODE_DISPLAY_MAP = {
-    "planning": "[Planning]",
-    "pending_implementation": "[Plan Ready]",
-    "implementing": "[Implementing]",
-    "none": "",
-}
-
-# Status icon mapping for task states
-STATUS_ICON_MAP = {
-    "pending": "⬜",
-    "in_progress": "🔄",
-    "blocked": "🚫",
-    "completed": "✅",
-}
-
-
-def get_mode_display(mode: str) -> str:
-    """Get display string for in-flight mode.
-
-    Args:
-        mode: In-flight mode string (planning, implementing, etc.)
-
-    Returns:
-        Display string like "[Planning]" or empty string for "none"
-    """
-    return MODE_DISPLAY_MAP.get(mode, "")
-
-
-def get_status_icon(status: str) -> str:
-    """Get emoji icon for task status.
-
-    Args:
-        status: Task status (pending, in_progress, blocked, completed)
-
-    Returns:
-        Emoji icon like "⬜" or "✅"
-    """
-    return STATUS_ICON_MAP.get(status, "⬜")
-
-
-def render_task_item(
-    task: Union["Task", Dict[str, Any]],
-    show_description: bool = True,
-    max_description_length: int = 100
-) -> str:
-    """Render single task with status icon and subject.
-
-    Args:
-        task: Task object or dict with status, subject, description
-        show_description: Whether to include description
-        max_description_length: Maximum length for description before truncating
-
-    Returns:
-        Formatted string: "- {icon} [{STATUS}] {subject}"
-    """
-    # Handle both Task objects and dicts
-    status = task.get("status") if isinstance(task, dict) else task.status
-    subject = task.get("subject") if isinstance(task, dict) else task.subject
-    description = task.get("description") if isinstance(task, dict) else task.description
-
-    icon = get_status_icon(status)
-    status_text = f"[{status.upper()}]"
-    line = f"- {icon} {status_text} {subject}"
-
-    if show_description and description:
-        truncated = description[:max_description_length]
-        if len(description) > max_description_length:
-            truncated += "..."
-        return f"{line}\n  - {truncated}"
-    return line
-
-
-def render_task_list(
-    tasks: List[Union["Task", Dict[str, Any]]],
-    header: Optional[str] = "Active Tasks",
-    show_description: bool = True
-) -> str:
-    """Render list of tasks with header.
-
-    Args:
-        tasks: List of Task objects or dicts
-        header: Section header text
-        show_description: Whether to show task descriptions
-
-    Returns:
-        Formatted markdown section with task list
-    """
-    lines = [f"### {header}", ""]
-
-    if not tasks:
-        lines.append("No active tasks.")
-    else:
-        for task in tasks:
-            lines.append(render_task_item(task, show_description))
-
-    lines.append("")
-    return "\n".join(lines)
-
-
-def format_continuation_header(header_type: str, context_id: str) -> str:
-    """Format continuation header for various scenarios.
-
-    Args:
-        header_type: Type of continuation (context, resuming, implementing, handoff)
-        context_id: Context identifier
-
-    Returns:
-        Formatted markdown header
-    """
-    headers = {
-        "context": f"## CONTINUING CONTEXT: {context_id}",
-        "resuming": f"## RESUMING FROM HANDOFF: {context_id}",
-        "implementing": f"## CONTINUING IMPLEMENTATION: {context_id}",
-        "handoff": f"# Session Handoff: {context_id}",
-    }
-    return headers.get(header_type, f"## {context_id}")
-
-
-# Handoff reason display mapping
-REASON_MAP = {
-    "low_context": "Context window running low",
-    "user_requested": "User requested handoff",
-    "error_recovery": "Error recovery",
-    "session_end": "Session ending",
-}
-
-
-def format_reason(reason: str) -> str:
-    """Format handoff reason code as human-readable string.
-
-    Args:
-        reason: Reason code (low_context, user_requested, etc.)
-
-    Returns:
-        Human-readable reason string
-    """
-    return REASON_MAP.get(reason, reason)