WeavePy 0.1.0__tar.gz

weavepy-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,88 @@
+# CI/CD Pipeline for thegent-mesh
+# Applies: CI/CD, TDD, Shift-Left Testing
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Check formatting
+        run: ruff format --check src/
+
+      - name: Run linter
+        run: ruff check src/
+
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          pip install -e ".[dev,test]"
+
+      - name: Run tests
+        run: pytest src/ -v --cov=src --cov-report=xml
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.xml
+
+  type-check:
+    name: Type Check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install mypy
+        run: pip install mypy
+
+      - name: Run type checker
+        run: mypy src/
+
+  security:
+    name: Security Audit
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install bandit
+        run: pip install bandit
+
+      - name: Run security audit
+        run: bandit -r src/

weavepy-0.1.0/AGENTS.md

@@ -0,0 +1,33 @@
+
+# Agent Rules
+
+**This project is managed through AgilePlus.**
+
+## AgilePlus Mandate
+
+All work MUST be tracked in AgilePlus:
+- Reference: /Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus
+- CLI: cd /Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus && agileplus <command>
+
+## Branch Discipline
+
+- Feature branches in repos/worktrees/<project>/<category>/<branch>
+- Canonical repository tracks main only
+- Return to main for merge/integration checkpoints
+
+## Work Requirements
+
+1. Check for AgilePlus spec before implementing
+2. Update work package status as work progresses
+3. No code without corresponding AgilePlus spec
+
+## UTF-8 Encoding
+
+All markdown files must use UTF-8. Avoid smart quotes, em-dashes, and special characters.
+
+```bash
+# Validate encoding (in AgilePlus repo)
+cd /Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus
+agileplus validate-encoding --all --fix
+```
+

weavepy-0.1.0/CLAUDE.md

@@ -0,0 +1,39 @@
+
+# Project Instructions
+
+**This project is managed through AgilePlus.**
+
+## AgilePlus Mandate
+
+All work MUST be tracked in AgilePlus:
+- Reference: /Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus
+- CLI: cd /Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus && agileplus <command>
+
+## Work Requirements
+
+1. Check for AgilePlus spec before implementing
+2. Create spec for new work: agileplus specify --title "<feature>" --description "<desc>"
+3. Update work package status: agileplus status <feature-id> --wp <wp-id> --state <state>
+4. No code without corresponding AgilePlus spec
+
+## Branch Discipline
+
+- Feature branches in repos/worktrees/<project>/<category>/<branch>
+- Canonical repository tracks main only
+- Return to main for merge/integration checkpoints
+
+## UTF-8 Encoding
+
+All markdown files must use UTF-8. Validate with:
+```bash
+cd /Users/kooshapari/CodeProjects/Phenotype/repos/AgilePlus
+agileplus validate-encoding --all --fix
+```
+
+## AgilePlus Reference
+
+- Specs: AgilePlus/kitty-specs/<feature-id>/
+- Docs: AgilePlus/docs/
+- Workflows: AgilePlus/docs/workflow/
+- Worklog: AgilePlus/.work-audit/worklog.md
+

weavepy-0.1.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: WeavePy
+Version: 0.1.0
+Summary: Coordination mesh for multi-agent orchestration
+Author-email: Koosha Pari <koosha@example.com>
+License-Expression: MIT
+Keywords: coordination,mesh,multi-agent,orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Provides-Extra: dev
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: ruff>=0.1; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# thegent-mesh
+
+Coordination mesh for multi-agent orchestration.
+
+## Features
+
+- **Task Queue**: Maildir-style atomic queue for task distribution
+- **Smart Merge**: AST-aware merging (Mergiraf-style) for conflict resolution
+- **Request Coalescing**: Singleflight pattern for deduplicating requests
+- **Coordination**: HLC timestamps, OCC, lease-based file ownership
+- **Git Parallelism**: Parallel git operations with coordination
+- **Process Detection**: Detect and coordinate running processes
+
+## Architecture
+
+Based on thegent's mesh/ module for multi-agent coordination.
+
+## CLI Commands
+
+```bash
+# Task queue operations
+thegent-mesh queue push <task>
+thegent-mesh queue pop
+thegent-mesh queue list
+
+# Merge operations
+thegent-mesh merge <file1> <file2>
+
+# Coordination
+thegent-mesh coord status
+thegent-mesh coord acquire <resource>
+```
+
+## License
+
+MIT

weavepy-0.1.0/README.md

@@ -0,0 +1,36 @@
+# thegent-mesh
+
+Coordination mesh for multi-agent orchestration.
+
+## Features
+
+- **Task Queue**: Maildir-style atomic queue for task distribution
+- **Smart Merge**: AST-aware merging (Mergiraf-style) for conflict resolution
+- **Request Coalescing**: Singleflight pattern for deduplicating requests
+- **Coordination**: HLC timestamps, OCC, lease-based file ownership
+- **Git Parallelism**: Parallel git operations with coordination
+- **Process Detection**: Detect and coordinate running processes
+
+## Architecture
+
+Based on thegent's mesh/ module for multi-agent coordination.
+
+## CLI Commands
+
+```bash
+# Task queue operations
+thegent-mesh queue push <task>
+thegent-mesh queue pop
+thegent-mesh queue list
+
+# Merge operations
+thegent-mesh merge <file1> <file2>
+
+# Coordination
+thegent-mesh coord status
+thegent-mesh coord acquire <resource>
+```
+
+## License
+
+MIT

weavepy-0.1.0/kitty-specs/001-service-mesh/plan.md

@@ -0,0 +1,16 @@
+# Plan: TheGent Mesh
+
+## Timeline: 2024-2026 (Completed)
+
+## Phase 1: Integration (2024)
+- Mesh connection
+- Basic routing
+
+## Phase 2: Management (2025)
+- Traffic policies
+- Discovery
+
+## Verification
+
+- [x] Integration works
+- [ ] Enhanced routing

weavepy-0.1.0/kitty-specs/001-service-mesh/spec.md

@@ -0,0 +1,26 @@
+# Spec: TheGent Mesh
+
+## Meta
+
+- **ID**: 001
+- **Title**: TheGent Mesh
+- **Created**: 2026-03-25
+- **State**: shipped
+
+## Overview
+
+Service mesh integration for TheGent agent communication.
+
+## Past Work (Completed)
+- Mesh integration
+- Traffic management
+- Service discovery
+
+## Future Work
+- Enhanced routing
+- Security policies
+
+## Verification
+
+- Mesh integration works
+- Services communicate

weavepy-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "WeavePy"
+version = "0.1.0"
+description = "Coordination mesh for multi-agent orchestration"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Koosha Pari", email = "koosha@example.com" }
+]
+keywords = ["multi-agent", "coordination", "mesh", "orchestration"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+dependencies = []
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+    "ruff>=0.1",
+    "mypy>=1.0",
+]
+
+[project.scripts]
+thegent-mesh = "thegent_mesh.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/thegent_mesh"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "N", "UP", "B", "C4"]
+ignore = ["E501"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true

weavepy-0.1.0/scripts/agent-run.sh

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# =============================================================================
+# lib/mesh/agent-run.sh — Start Agent in Managed Mesh Session
+# =============================================================================
+
+# Source library dependencies
+LIB_DIR=$(dirname "${BASH_SOURCE[0]}")
+source "$LIB_DIR/session.sh"
+source "$LIB_DIR/inject.sh"
+source "$LIB_DIR/scanner.sh"
+
+MESH_AGENT_TYPE="${1:-claude-code}"
+MESH_AGENT_PROMPT="${2:-}"
+MESH_AGENT_WORKDIR="${3:-$(pwd)}"
+
+# 1. Create session
+# Use a short UUID for session identification
+SESSION_ID=$(uuidgen | tr '[:upper:]' '[:lower:]' | cut -d- -f1)
+SESSION_NAME=$(mesh_session::get_name "$SESSION_ID")
+
+echo "Starting agent $MESH_AGENT_TYPE in session $SESSION_NAME..."
+
+# Create new tmux session in specified working directory
+tmux new-session -d -s "$SESSION_NAME" -c "$MESH_AGENT_WORKDIR"
+
+# 2. Wait for shell ready
+if ! mesh_inject::wait_for_agent "$SESSION_NAME" "shell" 30; then
+    echo "Timeout waiting for shell in $SESSION_NAME"
+    exit 1
+fi
+
+# 3. Start agent
+# Command mapping for common agents
+declare -gA MESH_AGENT_COMMANDS=(
+    ["claude-code"]="claude"
+    ["aider"]="aider"
+    ["cursor"]="cursor"
+)
+CMD="${MESH_AGENT_COMMANDS[$MESH_AGENT_TYPE]:-$MESH_AGENT_TYPE}"
+
+# Inject start command
+mesh_inject::command "$SESSION_NAME" "$CMD"
+
+# 4. Wait for agent ready
+if ! mesh_inject::wait_for_agent "$SESSION_NAME" "$MESH_AGENT_TYPE" 60; then
+    echo "Timeout waiting for agent $MESH_AGENT_TYPE in $SESSION_NAME"
+    # Don't exit, maybe it started but prompt didn't match
+fi
+
+# 5. Send initial prompt
+if [[ -n "$MESH_AGENT_PROMPT" ]]; then
+    mesh_inject::command "$SESSION_NAME" "$MESH_AGENT_PROMPT"
+fi
+
+echo "Agent $MESH_AGENT_TYPE started successfully in session $SESSION_NAME"
+echo "To attach: tmux attach -t $SESSION_NAME"
+echo "$SESSION_NAME"

weavepy-0.1.0/scripts/inject.sh

@@ -0,0 +1,63 @@
+#!/usr/bin/env bash
+# =============================================================================
+# lib/mesh/inject.sh — Reliable tmux Command Injection
+# =============================================================================
+
+MESH_INJECT_DELAY="${MESH_INJECT_DELAY:-1.5}"
+
+mesh_inject::command() {
+    local target="$1" # session:window.pane or session
+    local command="$2"
+    local delay="${3:-$MESH_INJECT_DELAY}"
+
+    # Send keys literally (-l) to avoid tmux interpretation of special chars
+    tmux send-keys -t "$target" -l "$command"
+
+    # Critical delay - prevents command loss in rapid fire or slow agents
+    sleep "$delay"
+
+    # Send Enter to execute
+    tmux send-keys -t "$target" Enter
+}
+
+mesh_inject::wait_for_ready() {
+    local target="$1"
+    local pattern="$2"
+    local timeout="${3:-120}"
+    local interval="${4:-1}"
+    local elapsed=0
+
+    while [ "$elapsed" -lt "$timeout" ]; do
+        local output
+        output=$(tmux capture-pane -p -t "$target" -S -10 2>/dev/null)
+        if echo "$output" | grep -qE "$pattern"; then
+            return 0
+        fi
+        sleep "$interval"
+        elapsed=$((elapsed + interval))
+    done
+    return 1 # Timeout
+}
+
+# Common agent readiness patterns
+declare -gA MESH_READY_PATTERNS=(
+    ["aider"]="^aider>|^───"
+    ["claude-code"]="^>|claude>"
+    ["shell"]="\\$|%|#|➜|❯|>"
+)
+
+mesh_inject::get_ready_pattern() {
+    local agent_type="$1"
+    echo "${MESH_READY_PATTERNS[$agent_type]:-\$|%|#|➜|❯|>}"
+}
+
+mesh_inject::wait_for_agent() {
+    local target="$1"
+    local agent_type="$2"
+    local timeout="${3:-120}"
+
+    local pattern
+    pattern=$(mesh_inject::get_ready_pattern "$agent_type")
+
+    mesh_inject::wait_for_ready "$target" "$pattern" "$timeout"
+}