agentic-sdlc 1.6.0 → 1.8.1

package/bin/kb

@@ -1,34 +0,0 @@
-#!/usr/bin/env bash
-# Knowledge Base CLI - Cross-platform entry point
-# Works on Linux, macOS, and Windows (Git Bash/WSL)
-
-# Detect OS
-if [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "win32" ]]; then
-    # Windows (Git Bash)
-    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    PLATFORM="windows"
-elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
-    # Linux
-    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    PLATFORM="linux"
-elif [[ "$OSTYPE" == "darwin"* ]]; then
-    # macOS
-    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    PLATFORM="macos"
-else
-    echo "Unsupported OS: $OSTYPE"
-    exit 1
-fi
-
-# Check if Python is available
-if command -v python3 &> /dev/null; then
-    PYTHON_CMD="python3"
-elif command -v python &> /dev/null; then
-    PYTHON_CMD="python"
-else
-    echo "Error: Python not found. Please install Python 3.7+"
-    exit 1
-fi
-
-# Run the Python CLI
-exec "$PYTHON_CMD" "$SCRIPT_DIR/kb_cli.py" "$@"

package/bin/kb.bat

@@ -1,28 +0,0 @@
-@echo off
-REM Knowledge Base CLI - Windows batch entry point
-REM Usage: kb.bat [command] [args]
-
-setlocal enabledelayedexpansion
-
-REM Get script directory
-set "SCRIPT_DIR=%~dp0"
-
-REM Check for Python
-where python >nul 2>nul
-if %ERRORLEVEL% EQU 0 (
-    set "PYTHON_CMD=python"
-    goto :run
-)
-
-where python3 >nul 2>nul
-if %ERRORLEVEL% EQU 0 (
-    set "PYTHON_CMD=python3"
-    goto :run
-)
-
-echo Error: Python not found. Please install Python 3.7+
-exit /b 1
-
-:run
-REM Run the Python CLI
-"%PYTHON_CMD%" "%SCRIPT_DIR%kb_cli.py" %*

package/bin/kb_cli.py

@@ -1,226 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Knowledge Base CLI - Cross-platform
-Supports Windows, Linux, and macOS
-
-Usage:
-    kb [command] [args]
-    kb.bat [command] [args]  (Windows)
-"""
-
-import sys
-import os
-import platform
-import argparse
-from pathlib import Path
-
-# Set UTF-8 encoding for Windows console
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-        sys.stderr.reconfigure(encoding='utf-8')
-    except:
-        pass
-
-# Add lib directory to path
-SCRIPT_DIR = Path(__file__).parent
-LIB_DIR = SCRIPT_DIR / "lib"
-sys.path.insert(0, str(LIB_DIR))
-
-# Import KB modules
-try:
-    from kb_search import search_kb
-    from kb_add import add_entry
-    from kb_index import update_index
-    from kb_stats import show_stats
-    from kb_list import list_entries
-    from kb_compound import compound_operation
-except ImportError as e:
-    print(f"Error: Could not import KB modules: {e}")
-    print(f"Make sure all required files are in {LIB_DIR}")
-    sys.exit(1)
-
-
-class Colors:
-    """ANSI color codes that work cross-platform"""
-    RESET = '\033[0m'
-    BOLD = '\033[1m'
-    
-    # Foreground colors
-    BLACK = '\033[30m'
-    RED = '\033[31m'
-    GREEN = '\033[32m'
-    YELLOW = '\033[33m'
-    BLUE = '\033[34m'
-    MAGENTA = '\033[35m'
-    CYAN = '\033[36m'
-    WHITE = '\033[37m'
-    
-    # Background colors
-    BG_BLACK = '\033[40m'
-    BG_RED = '\033[41m'
-    BG_GREEN = '\033[42m'
-    BG_YELLOW = '\033[43m'
-    BG_BLUE = '\033[44m'
-    BG_MAGENTA = '\033[45m'
-    BG_CYAN = '\033[46m'
-    BG_WHITE = '\033[47m'
-    
-    @staticmethod
-    def enable_windows_colors():
-        """Enable ANSI colors on Windows"""
-        if platform.system() == 'Windows':
-            try:
-                import ctypes
-                kernel32 = ctypes.windll.kernel32
-                kernel32.SetConsoleMode(kernel32.GetStdHandle(-11), 7)
-            except:
-                pass
-
-
-def print_header():
-    """Print CLI header"""
-    Colors.enable_windows_colors()
-    print(f"{Colors.CYAN}{Colors.BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━{Colors.RESET}")
-    print(f"{Colors.CYAN}{Colors.BOLD}📚 Knowledge Base - Command Line Interface{Colors.RESET}")
-    print(f"{Colors.MAGENTA}   🧠 Integrated with Neo4j Brain{Colors.RESET}")
-    print(f"{Colors.CYAN}{Colors.BOLD}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━{Colors.RESET}")
-    print()
-
-
-def print_help():
-    """Print help message"""
-    print_header()
-    print(f"{Colors.WHITE}{Colors.BOLD}Usage:{Colors.RESET} kb [command] [args]")
-    print()
-    print(f"{Colors.YELLOW}{Colors.BOLD}Commands:{Colors.RESET}")
-    print()
-    print(f"  {Colors.WHITE}search <term>{Colors.RESET}        🔍 Search knowledge base")
-    print(f"                          Example: kb search 'react hydration'")
-    print()
-    print(f"  {Colors.WHITE}add{Colors.RESET}                  ➕ Add new entry (interactive)")
-    print(f"                          Example: kb add")
-    print()
-    print(f"  {Colors.WHITE}index{Colors.RESET}                📇 Update INDEX.md")
-    print(f"                          Example: kb index")
-    print()
-    print(f"  {Colors.WHITE}stats{Colors.RESET}                📊 Show statistics")
-    print(f"                          Example: kb stats")
-    print()
-    print(f"  {Colors.WHITE}list [category]{Colors.RESET}      📋 List all entries (optional: by category)")
-    print(f"                          Example: kb list bugs")
-    print()
-    print(f"  {Colors.WHITE}recent [n]{Colors.RESET}           📅 Show recent entries (default: 10)")
-    print(f"                          Example: kb recent 5")
-    print()
-    print(f"  {Colors.MAGENTA}{Colors.BOLD}compound <action>{Colors.RESET}    🧠 Compound mode with Neo4j integration")
-    print(f"                          Example: kb compound search 'oauth'")
-    print()
-    print(f"  {Colors.WHITE}help{Colors.RESET}                 ❓ Show this help")
-    print()
-    print(f"{Colors.MAGENTA}{Colors.BOLD}Compound Actions:{Colors.RESET}")
-    print(f"  compound search <term>  - Search both file system and Neo4j brain")
-    print(f"  compound add            - Add entry and sync to Neo4j")
-    print(f"  compound sync           - Full sync to Neo4j brain")
-    print(f"  compound query <term>   - Intelligent Neo4j query")
-    print(f"  compound stats          - Show compound system health")
-    print()
-    print(f"{Colors.YELLOW}{Colors.BOLD}Examples:{Colors.RESET}")
-    print(f"  kb search oauth")
-    print(f"  {Colors.MAGENTA}kb compound search oauth{Colors.RESET}")
-    print(f"  kb add")
-    print(f"  {Colors.MAGENTA}kb compound add{Colors.RESET}")
-    print(f"  kb stats")
-    print()
-    print(f"{Colors.CYAN}{Colors.BOLD}💡 Quick Start:{Colors.RESET}")
-    print(f"   1. Search before solving: {Colors.MAGENTA}kb compound search 'your problem'{Colors.RESET}")
-    print(f"   2. Add after solving: {Colors.MAGENTA}kb compound add{Colors.RESET}")
-    print(f"   3. Sync to brain: {Colors.MAGENTA}kb compound sync{Colors.RESET}")
-    print()
-    print(f"{Colors.MAGENTA}{Colors.BOLD}🧠 Neo4j Brain:{Colors.RESET}")
-    print(f"   The compound mode connects KB to Neo4j for intelligent")
-    print(f"   relationship mapping and contextual queries")
-    print()
-
-
-def main():
-    """Main CLI entry point"""
-    Colors.enable_windows_colors()
-    
-    # Parse arguments
-    parser = argparse.ArgumentParser(
-        description='Knowledge Base CLI',
-        add_help=False
-    )
-    parser.add_argument('command', nargs='?', default='help')
-    parser.add_argument('args', nargs='*')
-    
-    args = parser.parse_args()
-    command = args.command.lower()
-    command_args = args.args
-    
-    try:
-        # Execute command
-        if command == 'help' or command == '-h' or command == '--help':
-            print_help()
-        
-        elif command == 'search':
-            if not command_args:
-                print(f"{Colors.RED}❌ Search term required!{Colors.RESET}")
-                print(f"{Colors.YELLOW}Usage: kb search 'term'{Colors.RESET}")
-                sys.exit(1)
-            search_term = ' '.join(command_args)
-            search_kb(search_term)
-        
-        elif command == 'add':
-            add_entry()
-        
-        elif command == 'index':
-            update_index()
-        
-        elif command == 'stats':
-            show_stats()
-        
-        elif command == 'list':
-            category = command_args[0] if command_args else None
-            list_entries(category)
-        
-        elif command == 'recent':
-            count = int(command_args[0]) if command_args else 10
-            list_entries(recent=count)
-        
-        elif command == 'compound':
-            if not command_args:
-                print(f"{Colors.RED}❌ Compound action required!{Colors.RESET}")
-                print(f"{Colors.YELLOW}Usage: kb compound [search|add|sync|query|stats]{Colors.RESET}")
-                sys.exit(1)
-            
-            action = command_args[0].lower()
-            action_args = command_args[1:] if len(command_args) > 1 else []
-            
-            if action in ['search', 'query'] and not action_args:
-                print(f"{Colors.RED}❌ Search/Query term required!{Colors.RESET}")
-                sys.exit(1)
-            
-            search_term = ' '.join(action_args) if action_args else None
-            compound_operation(action, search_term)
-        
-        else:
-            print(f"{Colors.RED}❌ Unknown command: {command}{Colors.RESET}")
-            print()
-            print_help()
-            sys.exit(1)
-    
-    except KeyboardInterrupt:
-        print(f"\n{Colors.YELLOW}⚠️  Operation cancelled by user{Colors.RESET}")
-        sys.exit(0)
-    except Exception as e:
-        print(f"{Colors.RED}❌ Error: {e}{Colors.RESET}")
-        import traceback
-        traceback.print_exc()
-        sys.exit(1)
-
-
-if __name__ == '__main__':
-    main()

package/bin/lib/README.md

@@ -1,411 +0,0 @@
-# Knowledge Base CLI Library
-
-This directory contains the Python library modules for the **Knowledge Base CLI**.
-
-## Overview
-
-The KB CLI is a cross-platform command-line tool for managing the TeamLifecycle knowledge base with optional Neo4j brain integration.
-
-## Architecture
-
-```
-kb_cli.py                    # Main CLI entry point
-    │
-    ├── kb_common.py        # Common utilities
-    ├── kb_search.py        # Search functionality
-    ├── kb_add.py           # Add entries
-    ├── kb_index.py         # Index generation
-    ├── kb_stats.py         # Statistics
-    ├── kb_list.py          # List entries
-    └── kb_compound.py      # Neo4j integration
-```
-
-## Modules
-
-### `kb_common.py`
-**Purpose:** Common utilities and shared functions
-
-**Exports:**
-- `get_kb_path()` - Get knowledge base directory path
-- `parse_yaml_frontmatter()` - Parse YAML frontmatter from markdown
-- `format_date()` - Format dates consistently
-- `get_editor()` - Get platform-specific default editor
-- `Colors` - ANSI color codes class
-
-**Usage:**
-```python
-from kb_common import get_kb_path, Colors
-
-kb_path = get_kb_path()
-print(f"{Colors.GREEN}Success!{Colors.RESET}")
-```
-
-### `kb_search.py`
-**Purpose:** Search knowledge base entries
-
-**Exports:**
-- `search_kb(term: str)` - Search for entries matching term
-
-**Features:**
-- Searches INDEX.md first
-- Falls back to full file search
-- Shows context around matches
-- Displays metadata
-
-**Usage:**
-```python
-from kb_search import search_kb
-
-search_kb("react hydration")
-```
-
-### `kb_add.py`
-**Purpose:** Add new knowledge base entries
-
-**Exports:**
-- `add_entry()` - Interactive entry creation wizard
-
-**Features:**
-- Interactive prompts
-- YAML frontmatter generation
-- Unique filename generation
-- Auto-open in editor
-- Category/priority selection
-
-**Usage:**
-```python
-from kb_add import add_entry
-
-add_entry()  # Interactive wizard
-```
-
-### `kb_index.py`
-**Purpose:** Generate and update INDEX.md
-
-**Exports:**
-- `update_index()` - Scan entries and regenerate INDEX.md
-
-**Features:**
-- Scans all KB entries
-- Extracts metadata
-- Groups by category, priority, date
-- Generates searchable index
-- Shows statistics
-
-**Usage:**
-```python
-from kb_index import update_index
-
-update_index()
-```
-
-### `kb_stats.py`
-**Purpose:** Display knowledge base statistics
-
-**Exports:**
-- `show_stats()` - Calculate and display KB metrics
-
-**Features:**
-- Total entries count
-- Breakdown by category
-- Breakdown by priority
-- Total attempts
-- Time saved calculations
-- Growth trends
-
-**Usage:**
-```python
-from kb_stats import show_stats
-
-show_stats()
-```
-
-### `kb_list.py`
-**Purpose:** List knowledge base entries
-
-**Exports:**
-- `list_entries(category: str = None, recent: int = None)` - List entries
-
-**Features:**
-- List all entries
-- Filter by category
-- Show recent entries
-- Display metadata
-
-**Usage:**
-```python
-from kb_list import list_entries
-
-list_entries()              # All entries
-list_entries("bugs")        # Bugs only
-list_entries(recent=10)     # Last 10 entries
-```
-
-### `kb_compound.py`
-**Purpose:** Neo4j brain integration
-
-**Exports:**
-- `compound_operation(action: str, term: str = None)` - Execute compound operations
-
-**Actions:**
-- `search` - Search file system + Neo4j
-- `add` - Add entry + sync to Neo4j
-- `sync` - Full sync to Neo4j
-- `query` - Intelligent Neo4j queries
-- `stats` - Compound system health
-
-**Features:**
-- Neo4j connection management
-- Graceful fallback if Neo4j unavailable
-- Cross-platform subprocess handling
-- Relationship mapping
-
-**Usage:**
-```python
-from kb_compound import compound_operation
-
-compound_operation("search", "authentication")
-compound_operation("sync")
-compound_operation("stats")
-```
-
-## Dependencies
-
-### Required
-- Python 3.7+
-- Standard library modules:
-  - `os`, `sys`, `pathlib`
-  - `json`, `yaml`
-  - `datetime`, `re`
-  - `subprocess`
-
-### Optional
-- `neo4j` - For Neo4j brain integration
-- `python-dotenv` - For environment variables
-
-Install optional dependencies:
-```bash
-pip install neo4j python-dotenv
-```
-
-## Configuration
-
-### Environment Variables
-Create `.env` file in project root:
-```bash
-# Neo4j Configuration (optional)
-NEO4J_URI=neo4j+s://your-instance.databases.neo4j.io
-NEO4J_USERNAME=neo4j
-NEO4J_PASSWORD=your_password
-NEO4J_DATABASE=neo4j
-```
-
-### Knowledge Base Path
-Default: `.agent/knowledge-base/`
-
-Override with environment variable:
-```bash
-KB_PATH=/custom/path/to/kb
-```
-
-## Entry Format
-
-All KB entries use YAML frontmatter:
-
-```yaml
----
-title: "Entry Title"
-category: bug|feature|architecture|security|performance|platform
-priority: critical|high|medium|low
-sprint: sprint-N
-date: YYYY-MM-DD
-tags: [tag1, tag2, tag3]
-related_files: [path/to/file1, path/to/file2]
-attempts: 3
-time_saved: "2 hours"
----
-
-## Problem
-Description of the issue
-
-## Solution
-How it was solved
-
-## Prevention
-How to avoid in future
-```
-
-## File Naming Convention
-
-Format: `KB-YYYY-MM-DD-###-title-slug.md`
-
-Example: `KB-2026-01-02-001-react-hydration-error.md`
-
-Components:
-- `YYYY-MM-DD` - Creation date
-- `###` - Sequential ID for that day (001, 002, etc.)
-- `title-slug` - URL-friendly title
-
-## Directory Structure
-
-```
-.agent/knowledge-base/
-├── INDEX.md                    # Generated index
-├── bugs/
-│   ├── critical/
-│   ├── high/
-│   ├── medium/
-│   └── low/
-├── features/
-│   ├── authentication/
-│   ├── performance/
-│   ├── integration/
-│   └── ui-ux/
-├── architecture/
-├── security/
-├── performance/
-└── platform-specific/
-    ├── web/
-    ├── mobile/
-    ├── desktop/
-    └── cli/
-```
-
-## Error Handling
-
-All modules use consistent error handling:
-
-```python
-try:
-    # Operation
-    pass
-except FileNotFoundError:
-    print(f"{Colors.RED}❌ File not found{Colors.RESET}")
-except PermissionError:
-    print(f"{Colors.RED}❌ Permission denied{Colors.RESET}")
-except Exception as e:
-    print(f"{Colors.RED}❌ Error: {e}{Colors.RESET}")
-    import traceback
-    traceback.print_exc()
-```
-
-## Color Support
-
-Cross-platform ANSI color support:
-
-```python
-from kb_common import Colors
-
-print(f"{Colors.GREEN}✅ Success{Colors.RESET}")
-print(f"{Colors.RED}❌ Error{Colors.RESET}")
-print(f"{Colors.YELLOW}⚠️  Warning{Colors.RESET}")
-print(f"{Colors.CYAN}ℹ️  Info{Colors.RESET}")
-```
-
-Colors automatically enabled on Windows 10+.
-
-## Testing
-
-### Unit Tests
-```bash
-# Test individual modules
-python -c "from kb_search import search_kb; search_kb('test')"
-python -c "from kb_stats import show_stats; show_stats()"
-```
-
-### Integration Tests
-```bash
-# Test full workflow
-./bin/kb search test
-./bin/kb add
-./bin/kb index
-./bin/kb stats
-```
-
-## Adding New Modules
-
-1. Create new file: `kb_newfeature.py`
-2. Follow module structure:
-   ```python
-   #!/usr/bin/env python3
-   """
-   Module description
-   """
-   from kb_common import Colors, get_kb_path
-   
-   def new_feature():
-       """Feature implementation"""
-       pass
-   ```
-3. Import in `kb_cli.py`
-4. Add command handler
-5. Update this README
-
-## Platform Support
-
-### Windows
-- ✅ Command Prompt
-- ✅ PowerShell
-- ✅ Git Bash
-- ✅ ANSI colors (Windows 10+)
-
-### Linux
-- ✅ Bash
-- ✅ Zsh
-- ✅ Fish
-- ✅ Full ANSI colors
-
-### macOS
-- ✅ Bash
-- ✅ Zsh
-- ✅ Full ANSI colors
-
-## Performance
-
-- **Startup:** ~100-200ms
-- **Search:** ~50-100ms for 100 entries
-- **Index:** ~200-500ms for 100 entries
-- **Neo4j:** +100-300ms for queries
-
-## Troubleshooting
-
-### Import Errors
-```bash
-# Ensure lib directory is in Python path
-export PYTHONPATH="${PYTHONPATH}:/path/to/bin/lib"
-```
-
-### Permission Errors
-```bash
-# Make scripts executable (Linux/macOS)
-chmod +x bin/kb
-chmod +x bin/kb_cli.py
-```
-
-### Neo4j Connection Issues
-```bash
-# Test connection
-python -c "from neo4j import GraphDatabase; print('Neo4j available')"
-
-# Check .env file
-cat .env | grep NEO4J
-```
-
-## Related Files
-
-- `../kb` - Bash entry point
-- `../kb.bat` - Windows entry point
-- `../kb_cli.py` - Main CLI
-- `../../tools/neo4j/` - Neo4j integration scripts
-- `../../.agent/knowledge-base/` - KB entries
-
-## Documentation
-
-- **Main README:** `../README.md`
-- **Cross-Platform Guide:** `../CROSS-PLATFORM-CLI.md`
-- **KB Guide:** `../../docs/KNOWLEDGE-BASE-GUIDE.md`
-- **Neo4j Integration:** `../../docs/NEO4J-COMPOUND-INTEGRATION.md`
-
----
-
-**Note:** This is the **Python KB CLI library**. For the Node.js project CLI, see `../commands/README.md`.

package/bin/lib/__init__.py

@@ -1,7 +0,0 @@
-"""
-Knowledge Base Library
-Cross-platform Python modules for KB operations
-"""
-
-__version__ = '1.0.0'
-__author__ = 'TeamLifecycle'