anvil-dev-framework 0.1.6

package/global/tools/anvil-issue.py

@@ -0,0 +1,432 @@
+#!/usr/bin/env python3
+"""
+Anvil Issue CLI - Local issue tracking for Anvil Framework.
+
+Commands:
+    list    - List issues (optionally filtered by status)
+    create  - Create a new issue
+    show    - Show issue details
+    update  - Update an existing issue
+    move    - Change issue status
+    assign  - Assign issue to an agent
+    stats   - Show issue statistics
+
+Examples:
+    anvil-issue list
+    anvil-issue list --status todo
+    anvil-issue create --title "Fix bug" --priority high
+    anvil-issue show LOCAL-001
+    anvil-issue move LOCAL-001 --to in_progress
+    anvil-issue assign LOCAL-001 --agent agent-xyz
+"""
+
+import argparse
+import sys
+from pathlib import Path
+
+# Add lib directory to path
+sys.path.insert(0, str(Path(__file__).parent.parent / "lib"))
+
+from issue_models import IssueStatus, Priority
+from local_provider import LocalJsonProvider
+
+
+def get_provider() -> LocalJsonProvider:
+    """Get the local provider instance."""
+    return LocalJsonProvider()
+
+
+def format_priority(priority: Priority) -> str:
+    """Format priority with color indicators."""
+    icons = {
+        Priority.URGENT: "P0",
+        Priority.HIGH: "P1",
+        Priority.MEDIUM: "P2",
+        Priority.LOW: "P3",
+        Priority.NONE: "P4"
+    }
+    return icons.get(priority, "P?")
+
+
+def format_status(status: IssueStatus) -> str:
+    """Format status for display."""
+    icons = {
+        IssueStatus.BACKLOG: "[ ]",
+        IssueStatus.TODO: "[·]",
+        IssueStatus.IN_PROGRESS: "[→]",
+        IssueStatus.IN_REVIEW: "[?]",
+        IssueStatus.DONE: "[✓]",
+        IssueStatus.CANCELLED: "[✗]"
+    }
+    return icons.get(status, "[?]")
+
+
+def cmd_list(args):
+    """List issues."""
+    provider = get_provider()
+
+    # Parse status filter
+    status_filter = None
+    if args.status:
+        try:
+            status_filter = IssueStatus(args.status.lower().replace("-", "_"))
+        except ValueError:
+            print(f"Unknown status: {args.status}")
+            print(f"Valid: {', '.join(s.value for s in IssueStatus)}")
+            return 1
+
+    issues = provider.list_issues(status=status_filter, limit=args.limit)
+
+    if not issues:
+        print("No issues found.")
+        return 0
+
+    # Print header
+    print(f"\n{'ID':<12} {'Pri':<4} {'Status':<12} {'Title':<40}")
+    print("-" * 72)
+
+    for issue in issues:
+        status_str = issue.status.value.replace("_", " ").title()
+        title = issue.title[:38] + ".." if len(issue.title) > 40 else issue.title
+        print(f"{issue.identifier:<12} {format_priority(issue.priority):<4} {status_str:<12} {title:<40}")
+
+    print(f"\nTotal: {len(issues)} issue(s)")
+    return 0
+
+
+def cmd_create(args):
+    """Create a new issue."""
+    provider = get_provider()
+
+    # Parse priority
+    priority = Priority.MEDIUM
+    if args.priority:
+        priority_map = {
+            "urgent": Priority.URGENT, "p0": Priority.URGENT,
+            "high": Priority.HIGH, "p1": Priority.HIGH,
+            "medium": Priority.MEDIUM, "p2": Priority.MEDIUM,
+            "low": Priority.LOW, "p3": Priority.LOW,
+            "none": Priority.NONE, "p4": Priority.NONE
+        }
+        priority = priority_map.get(args.priority.lower(), Priority.MEDIUM)
+
+    # Parse labels
+    labels = []
+    if args.labels:
+        labels = [lbl.strip() for lbl in args.labels.split(",")]
+
+    issue = provider.create_issue(
+        title=args.title,
+        description=args.description or "",
+        priority=priority,
+        labels=labels,
+        parent_id=args.parent
+    )
+
+    print(f"\nCreated: {issue.identifier}")
+    print(f"  Title: {issue.title}")
+    print(f"  Priority: {format_priority(issue.priority)}")
+    print(f"  Status: {issue.status.value}")
+    if issue.labels:
+        print(f"  Labels: {', '.join(issue.labels)}")
+
+    return 0
+
+
+def cmd_show(args):
+    """Show issue details."""
+    provider = get_provider()
+    issue = provider.get_issue(args.identifier)
+
+    if not issue:
+        print(f"Issue not found: {args.identifier}")
+        return 1
+
+    print(f"\n{issue.identifier}: {issue.title}")
+    print("-" * 50)
+    print(f"Status:    {issue.status.value.replace('_', ' ').title()}")
+    print(f"Priority:  {format_priority(issue.priority)} ({issue.priority.to_display()})")
+
+    if issue.description:
+        print(f"\nDescription:\n{issue.description}")
+
+    if issue.labels:
+        print(f"\nLabels: {', '.join(issue.labels)}")
+
+    if issue.assigned_agent:
+        print(f"Assigned: {issue.assigned_agent}")
+
+    if issue.parent_id:
+        print(f"Parent: {issue.parent_id}")
+
+    print(f"\nCreated:  {issue.created_at.strftime('%Y-%m-%d %H:%M') if issue.created_at else 'N/A'}")
+    print(f"Updated:  {issue.updated_at.strftime('%Y-%m-%d %H:%M') if issue.updated_at else 'N/A'}")
+
+    if issue.completed_at:
+        print(f"Completed: {issue.completed_at.strftime('%Y-%m-%d %H:%M')}")
+
+    return 0
+
+
+def cmd_update(args):
+    """Update an existing issue."""
+    provider = get_provider()
+
+    # Check issue exists
+    existing = provider.get_issue(args.identifier)
+    if not existing:
+        print(f"Issue not found: {args.identifier}")
+        return 1
+
+    # Parse priority if provided
+    priority = None
+    if args.priority:
+        priority_map = {
+            "urgent": Priority.URGENT, "p0": Priority.URGENT,
+            "high": Priority.HIGH, "p1": Priority.HIGH,
+            "medium": Priority.MEDIUM, "p2": Priority.MEDIUM,
+            "low": Priority.LOW, "p3": Priority.LOW,
+            "none": Priority.NONE, "p4": Priority.NONE
+        }
+        priority = priority_map.get(args.priority.lower())
+
+    # Parse labels if provided
+    labels = None
+    if args.labels:
+        labels = [lbl.strip() for lbl in args.labels.split(",")]
+
+    issue = provider.update_issue(
+        identifier=args.identifier,
+        title=args.title,
+        description=args.description,
+        priority=priority,
+        labels=labels
+    )
+
+    print(f"\nUpdated: {issue.identifier}")
+    print(f"  Title: {issue.title}")
+    print(f"  Priority: {format_priority(issue.priority)}")
+    print(f"  Status: {issue.status.value}")
+
+    return 0
+
+
+def cmd_move(args):
+    """Change issue status."""
+    provider = get_provider()
+
+    # Check issue exists
+    existing = provider.get_issue(args.identifier)
+    if not existing:
+        print(f"Issue not found: {args.identifier}")
+        return 1
+
+    # Parse target status
+    status_map = {
+        "backlog": IssueStatus.BACKLOG,
+        "todo": IssueStatus.TODO,
+        "in-progress": IssueStatus.IN_PROGRESS,
+        "in_progress": IssueStatus.IN_PROGRESS,
+        "inprogress": IssueStatus.IN_PROGRESS,
+        "in-review": IssueStatus.IN_REVIEW,
+        "in_review": IssueStatus.IN_REVIEW,
+        "inreview": IssueStatus.IN_REVIEW,
+        "done": IssueStatus.DONE,
+        "cancelled": IssueStatus.CANCELLED,
+        "canceled": IssueStatus.CANCELLED
+    }
+
+    target_status = status_map.get(args.to.lower())
+    if not target_status:
+        print(f"Unknown status: {args.to}")
+        print("Valid: backlog, todo, in-progress, in-review, done, cancelled")
+        return 1
+
+    old_status = existing.status.value
+    issue = provider.update_issue(args.identifier, status=target_status)
+
+    print(f"\n{issue.identifier}: {old_status} → {issue.status.value}")
+
+    return 0
+
+
+def cmd_assign(args):
+    """Assign issue to an agent."""
+    provider = get_provider()
+
+    # Check issue exists
+    existing = provider.get_issue(args.identifier)
+    if not existing:
+        print(f"Issue not found: {args.identifier}")
+        return 1
+
+    if args.unassign:
+        issue = provider.unassign_agent(args.identifier)
+        print(f"\n{issue.identifier}: Unassigned")
+    else:
+        if not args.agent:
+            print("Error: --agent required (or use --unassign)")
+            return 1
+        issue = provider.assign_to_agent(args.identifier, args.agent)
+        print(f"\n{issue.identifier}: Assigned to {args.agent}")
+
+    return 0
+
+
+def cmd_stats(args):
+    """Show issue statistics."""
+    provider = get_provider()
+    stats = provider.get_statistics()
+
+    print("\n=== Issue Statistics ===\n")
+    print(f"Total Issues: {stats['total']}")
+    print(f"Assigned:     {stats['assigned']}")
+    print(f"Unassigned:   {stats['unassigned']}")
+
+    print("\n--- By Status ---")
+    for status, count in sorted(stats['by_status'].items()):
+        print(f"  {status.replace('_', ' ').title():<15} {count}")
+
+    print("\n--- By Priority ---")
+    for priority, count in sorted(stats['by_priority'].items()):
+        print(f"  {priority:<15} {count}")
+
+    return 0
+
+
+def cmd_ready(args):
+    """Show issues ready to work on."""
+    provider = get_provider()
+    issues = provider.get_ready_issues()
+
+    if not issues:
+        print("\nNo issues ready to work on.")
+        return 0
+
+    print("\n=== Ready to Work ===\n")
+    print(f"{'ID':<12} {'Pri':<4} {'Title':<50}")
+    print("-" * 68)
+
+    for issue in issues[:args.limit]:
+        title = issue.title[:48] + ".." if len(issue.title) > 50 else issue.title
+        print(f"{issue.identifier:<12} {format_priority(issue.priority):<4} {title:<50}")
+
+    print(f"\nShowing {min(len(issues), args.limit)} of {len(issues)} ready issue(s)")
+    return 0
+
+
+def cmd_delete(args):
+    """Delete an issue."""
+    provider = get_provider()
+
+    # Check issue exists
+    existing = provider.get_issue(args.identifier)
+    if not existing:
+        print(f"Issue not found: {args.identifier}")
+        return 1
+
+    if args.hard:
+        success = provider.hard_delete_issue(args.identifier)
+        action = "Deleted permanently"
+    else:
+        success = provider.delete_issue(args.identifier)
+        action = "Cancelled"
+
+    if success:
+        print(f"\n{args.identifier}: {action}")
+        return 0
+    else:
+        print(f"\nFailed to delete {args.identifier}")
+        return 1
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Anvil Issue CLI - Local issue tracking",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  anvil-issue list                          List all issues
+  anvil-issue list --status todo            List todo issues
+  anvil-issue create --title "Fix bug"      Create new issue
+  anvil-issue show LOCAL-001                Show issue details
+  anvil-issue move LOCAL-001 --to done      Change status
+  anvil-issue assign LOCAL-001 --agent xyz  Assign to agent
+  anvil-issue stats                         Show statistics
+  anvil-issue ready                         Show ready work
+"""
+    )
+
+    subparsers = parser.add_subparsers(dest="command", help="Command to run")
+
+    # list command
+    list_parser = subparsers.add_parser("list", help="List issues")
+    list_parser.add_argument("--status", "-s", help="Filter by status")
+    list_parser.add_argument("--limit", "-n", type=int, default=50, help="Max issues to show")
+
+    # create command
+    create_parser = subparsers.add_parser("create", help="Create an issue")
+    create_parser.add_argument("--title", "-t", required=True, help="Issue title")
+    create_parser.add_argument("--description", "-d", help="Issue description")
+    create_parser.add_argument("--priority", "-p", help="Priority (urgent/high/medium/low)")
+    create_parser.add_argument("--labels", "-l", help="Comma-separated labels")
+    create_parser.add_argument("--parent", help="Parent issue identifier")
+
+    # show command
+    show_parser = subparsers.add_parser("show", help="Show issue details")
+    show_parser.add_argument("identifier", help="Issue identifier (e.g., LOCAL-001)")
+
+    # update command
+    update_parser = subparsers.add_parser("update", help="Update an issue")
+    update_parser.add_argument("identifier", help="Issue identifier")
+    update_parser.add_argument("--title", "-t", help="New title")
+    update_parser.add_argument("--description", "-d", help="New description")
+    update_parser.add_argument("--priority", "-p", help="New priority")
+    update_parser.add_argument("--labels", "-l", help="New labels (comma-separated)")
+
+    # move command
+    move_parser = subparsers.add_parser("move", help="Change issue status")
+    move_parser.add_argument("identifier", help="Issue identifier")
+    move_parser.add_argument("--to", required=True, help="Target status")
+
+    # assign command
+    assign_parser = subparsers.add_parser("assign", help="Assign issue to agent")
+    assign_parser.add_argument("identifier", help="Issue identifier")
+    assign_parser.add_argument("--agent", "-a", help="Agent ID to assign")
+    assign_parser.add_argument("--unassign", "-u", action="store_true", help="Remove assignment")
+
+    # stats command
+    subparsers.add_parser("stats", help="Show statistics")
+
+    # ready command
+    ready_parser = subparsers.add_parser("ready", help="Show ready work")
+    ready_parser.add_argument("--limit", "-n", type=int, default=10, help="Max issues")
+
+    # delete command
+    delete_parser = subparsers.add_parser("delete", help="Delete an issue")
+    delete_parser.add_argument("identifier", help="Issue identifier")
+    delete_parser.add_argument("--hard", action="store_true", help="Permanently delete")
+
+    args = parser.parse_args()
+
+    if not args.command:
+        parser.print_help()
+        return 0
+
+    commands = {
+        "list": cmd_list,
+        "create": cmd_create,
+        "show": cmd_show,
+        "update": cmd_update,
+        "move": cmd_move,
+        "assign": cmd_assign,
+        "stats": cmd_stats,
+        "ready": cmd_ready,
+        "delete": cmd_delete
+    }
+
+    return commands[args.command](args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

package/global/tools/anvil-memory/CLAUDE.md

@@ -0,0 +1,49 @@
+# Anvil Memory
+
+> Persistent memory system for the Anvil framework.
+
+## Overview
+
+Anvil Memory provides SQLite-backed persistent storage for observations, sessions, checkpoints, and Ralph iterations. It replaces Claude-Mem with a proprietary solution integrated into the Anvil framework.
+
+## Tech Stack
+
+- **Runtime**: Bun (use `bun` instead of `node`)
+- **Database**: SQLite via `bun:sqlite`
+- **Language**: TypeScript (strict mode)
+
+## Commands
+
+```bash
+bun run dev          # Run from source
+bun run build        # Compile to dist/anvil-memory
+bun run test         # Run tests
+bun run typecheck    # Check types
+```
+
+## Architecture
+
+```
+src/
+├── index.ts         # CLI entry point
+├── types.ts         # Type definitions
+├── db.ts            # Database operations
+└── commands/        # Command handlers
+    ├── init.ts
+    ├── observe.ts
+    ├── search.ts
+    └── ...
+```
+
+## Database
+
+- Location: `~/.anvil/memory.db`
+- Schema: See `src/db.ts` for migrations
+- Uses FTS5 for full-text search
+
+## Key Patterns
+
+1. **Use bun:sqlite** - Don't use better-sqlite3 or other libraries
+2. **FTS5 sync** - Triggers keep FTS tables in sync
+3. **JSON for arrays** - Store concepts/files as JSON arrays
+4. **ISO timestamps** - All timestamps in ISO 8601 format

package/global/tools/anvil-memory/README.md

@@ -0,0 +1,42 @@
+# Anvil Memory
+
+Persistent memory system for the Anvil framework.
+
+## Installation
+
+```bash
+cd global/tools/anvil-memory
+bun install
+bun run build
+```
+
+## Usage
+
+```bash
+# Initialize database
+anvil-memory init
+
+# Create observation
+anvil-memory observe --type feature --title "Added auth" --content "Details..."
+
+# Search
+anvil-memory search "authentication" --limit 10
+
+# Get by ID
+anvil-memory get 42
+
+# Generate context
+anvil-memory context --limit 20 --format inject
+```
+
+## Development
+
+```bash
+bun run dev          # Run from source
+bun run test         # Run tests
+bun run typecheck    # Type check
+```
+
+## License
+
+MIT

package/global/tools/anvil-memory/bun.lock

@@ -0,0 +1,25 @@
+{
+  "lockfileVersion": 1,
+  "workspaces": {
+    "": {
+      "name": "anvil-memory",
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5",
+      },
+    },
+  },
+  "packages": {
+    "@types/bun": ["@types/bun@1.3.5", "", { "dependencies": { "bun-types": "1.3.5" } }, "sha512-RnygCqNrd3srIPEWBd5LFeUYG7plCoH2Yw9WaZGyNmdTEei+gWaHqydbaIRkIkcbXwhBT94q78QljxN0Sk838w=="],
+
+    "@types/node": ["@types/node@25.0.3", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-W609buLVRVmeW693xKfzHeIV6nJGGz98uCPfeXI1ELMLXVeKYZ9m15fAMSaUPBHYLGFsVRcMmSCksQOrZV9BYA=="],
+
+    "bun-types": ["bun-types@1.3.5", "", { "dependencies": { "@types/node": "*" } }, "sha512-inmAYe2PFLs0SUbFOWSVD24sg1jFlMPxOjOSSCYqUgn4Hsc3rDc7dFvfVYjFPNHtov6kgUeulV4SxbuIV/stPw=="],
+
+    "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
+
+    "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+  }
+}

package/global/tools/anvil-memory/bunfig.toml

@@ -0,0 +1,9 @@
+# Bun configuration for anvil-memory
+
+[test]
+# Test configuration
+root = "./src"
+
+[install]
+# Package installation settings
+optional = true

package/global/tools/anvil-memory/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "anvil-memory",
+  "version": "0.1.0",
+  "description": "Persistent memory system for Anvil framework",
+  "module": "src/index.ts",
+  "type": "module",
+  "private": true,
+  "bin": {
+    "anvil-memory": "./dist/anvil-memory"
+  },
+  "scripts": {
+    "dev": "bun run src/index.ts",
+    "build": "bun build src/index.ts --compile --outfile dist/anvil-memory",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}