kalytera 0.1.0__tar.gz

kalytera-0.1.0/.claude/agents/dev-agent.md

@@ -0,0 +1,21 @@
+# Dev Agent
+
+You are a senior Python engineer building AgentIQ.
+Your job is to implement tasks from docs/TASKS.md one at a time.
+
+## Rules you never break
+- Read CLAUDE.md fully before starting any task
+- Use plan mode for any task touching more than 2 files, schema changes, or refactors
+- Create a branch — never work directly on main
+- One task per session — multi-task prompts produce broken output
+- Never touch evaluation/prompts.py without explicit instruction
+- Never modify the pattern export schema
+- If unsure about design decisions, write questions to docs/QUESTIONS.md and stop
+
+## When you finish a task
+1. Run full test suite: `pytest tests/unit/` and `pytest tests/integration/`
+2. Run linting: `ruff check .` and `mypy . --strict` — all must pass
+3. Update docs/TASKS.md — mark task done with timestamp
+4. Write one-paragraph summary to docs/PROGRESS.md
+5. Commit with message: "feat: [task-id] [description]"
+6. Stop and wait for next session

kalytera-0.1.0/.claude/agents/pm-agent.md

@@ -0,0 +1,34 @@
+# PM Agent
+
+You are the project manager for AgentIQ.
+Your job is to track progress, update the task list, and send daily updates.
+
+## What you do each day
+1. Read docs/TASKS.md — note what was completed since yesterday
+2. Read docs/PROGRESS.md — understand what was built
+3. Read docs/QA_REPORT.md — note any outstanding failures
+4. Read docs/QUESTIONS.md — note any unresolved design questions
+5. Append a daily entry to docs/DAILY_LOG.md — see format below
+6. Update docs/TASKS.md — move completed tasks to Done, reprioritize if needed
+7. Clear docs/QUESTIONS.md after copying questions to DAILY_LOG.md
+
+## Daily log entry format
+---
+## [DATE] Daily Update
+
+**Completed today:**
+- [task-id]: [what was built, one sentence]
+
+**Test status:** [PASSED / FAILED — if failed, what]
+
+**Coverage:** [overall %] | eval/ [%] | patterns/ [%] | causal/ [%]
+
+**Needs your decision:**
+- [any questions from dev agent]
+
+**Tomorrow's priority:**
+- [next task from TASKS.md]
+
+**Blockers:**
+- [anything blocking progress — or "None"]
+---

kalytera-0.1.0/.claude/agents/qa-agent.md

@@ -0,0 +1,19 @@
+# QA Agent
+
+You are a senior QA engineer for AgentIQ.
+Your job is to verify every completed task has adequate test coverage
+and that no regressions were introduced.
+
+## Rules you never break
+- Never modify source code — only test files
+- Run the full test suite: `pytest tests/ --cov=. --cov-report=term-missing`
+- If coverage on evaluation/, patterns/, or causal/ drops below 100%, flag it
+- If overall coverage drops below 80%, flag it
+- Check that every new function has at least one unit test
+- Check that every new API endpoint has at least one integration test
+- Write failures to docs/QA_REPORT.md with: test name, failure reason, suggested fix
+- If all tests pass and coverage is healthy, write "PASSED" to docs/QA_REPORT.md with timestamp
+
+## What you produce
+A docs/QA_REPORT.md entry for every run: timestamp, tasks reviewed, tests run,
+coverage %, failures found, failures fixed, outstanding issues.

kalytera-0.1.0/.claude/commands/daily-build.md

@@ -0,0 +1,25 @@
+# Daily Build
+
+**FOCUS: Get deployed AgentIQ system working end-to-end**
+The core implementation is DONE. We need to fix deployment and verify everything works.
+
+Your Render deployment: https://dashboard.render.com/web/srv-d80919rrjlhs73a48840
+
+Steps:
+1. Read CLAUDE.md and docs/TASKS.md — focus on deployment verification tasks
+2. Check deployment status — is the API responding at your Render URL?
+3. Test database connectivity — can migrations run on PostgreSQL?
+4. Verify all endpoints work with real data
+5. Load seed data for demonstration
+6. Test the Streamlit dashboard
+7. Document what's working and what needs fixes
+8. Update docs/TASKS.md and docs/PROGRESS.md
+9. Stop
+
+**Priority Order:**
+1. TASK-001: Fix deployment issues — get API responding
+2. TASK-002: Database connectivity and migrations  
+3. TASK-004: Test all endpoints with actual data
+4. TASK-008: Load demonstration data
+
+Do NOT build new features. Focus on making the existing implementation work reliably on Render.

kalytera-0.1.0/.claude/commands/daily-report.md

@@ -0,0 +1,6 @@
+# Daily Report
+
+Run the PM agent following rules in .claude/agents/pm-agent.md.
+
+Generate today's DAILY_LOG.md entry. Be specific and factual.
+Do not pad with vague summaries. If nothing was completed, say so clearly.

kalytera-0.1.0/.claude/commands/run-tests.md

@@ -0,0 +1,10 @@
+# Run Tests
+
+Run the QA agent following rules in .claude/agents/qa-agent.md.
+
+Steps:
+1. Run `pytest tests/ --cov=. --cov-report=term-missing`
+2. Check coverage thresholds
+3. Review all new functions for test coverage
+4. Write QA_REPORT.md entry
+5. Stop

kalytera-0.1.0/.claude/session_log.txt

@@ -0,0 +1,366 @@
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended
+[$(date)] Session ended

kalytera-0.1.0/.claude/settings.json

@@ -0,0 +1,50 @@
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "python3 -c \"\nimport sys, json, os\ntry:\n    inp = json.load(sys.stdin)\n    path = inp.get('tool_input', {}).get('file_path', '')\n    root = '/Users/udayshankar/Documents/AgentIQ'\n    rel = os.path.relpath(path, root)\n    depth = len(rel.split(os.sep))\n    blocked = ['_archive', '.git']\n    name = os.path.basename(path)\n    if depth == 1 and path.endswith('.py') and not name in ['config.py', 'setup.py', 'pyproject.toml']:\n        print(f'BLOCK: Creating {name} in project root is not allowed. Place files in the correct module directory.')\n        sys.exit(1)\nexcept: pass\n\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Write",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "ruff check . --quiet"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "echo '[$(date)] Session ended' >> .claude/session_log.txt"
+          }
+        ]
+      }
+    ]
+  },
+  "permissions": {
+    "defaultMode": "acceptEdits",
+    "allow": [
+      "Bash(pytest:*)",
+      "Bash(ruff:*)",
+      "Bash(mypy:*)",
+      "Bash(alembic:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)"
+    ],
+    "deny": [
+      "Bash(rm -rf:*)"
+    ]
+  }
+}

kalytera-0.1.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "WebFetch(domain:arize.com)",
+      "WebFetch(domain:github.com)"
+    ]
+  }
+}

kalytera-0.1.0/.env.example

@@ -0,0 +1,28 @@
+# AgentIQ Configuration
+# Copy this file to .env and fill in your values
+# Never commit .env to git
+
+# Required: Anthropic API key (used by the LLM judge)
+ANTHROPIC_API_KEY=your-anthropic-api-key-here
+
+# Required for Docker self-host: PostgreSQL password
+POSTGRES_PASSWORD=choose-a-strong-password-here
+
+# Database connection
+# Local dev (SQLite, zero config):       leave as-is
+# Docker / self-hosted (PostgreSQL):     postgresql://agentiq:<POSTGRES_PASSWORD>@postgres:5432/agentiq
+# Render (PostgreSQL):                   set automatically by Render
+DATABASE_URL=sqlite:///./agentiq.db
+
+# SDK auth key — SDK callers must send: Authorization: Bearer <key>
+# Leave empty to allow all requests (dev mode / no auth)
+AGENTIQ_API_KEY=
+
+# Dashboard: URL of the AgentIQ API (used by Streamlit to call analytics endpoints)
+# Local dev:     http://localhost:8000
+# Docker:        http://api:8000
+# Render:        https://agentiq-api-z9it.onrender.com
+AGENTIQ_API_ENDPOINT=http://localhost:8000
+
+# Set to "true" to auto-seed 500 demo sessions when API starts and DB is empty
+SEED_ON_STARTUP=false

kalytera-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,59 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      test_pypi:
+        description: "Publish to TestPyPI instead of PyPI"
+        type: boolean
+        default: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: pip install build hatchling
+
+      - name: Build sdist and wheel
+        run: python -m build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: ${{ github.event.inputs.test_pypi == 'true' && 'testpypi' || 'pypi' }}
+      url: ${{ github.event.inputs.test_pypi == 'true' && 'https://test.pypi.org/p/agentiq' || 'https://pypi.org/p/agentiq' }}
+    permissions:
+      id-token: write  # required for trusted publishing (no API token needed)
+
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        if: github.event.inputs.test_pypi == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+      - name: Publish to PyPI
+        if: github.event.inputs.test_pypi != 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1

kalytera-0.1.0/.gitignore

@@ -0,0 +1,43 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+venv/
+env/
+ENV/
+
+# Environment variables
+.env
+.env.local
+
+# Database
+*.db
+*.sqlite3
+agentiq.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Railway
+.railway/
+
+# Test artifacts
+.coverage
+.pytest_cache/
+.tox/
+
+# Deployment scripts (keep local)
+deploy_to_render.py
+auto_deploy.py

kalytera-0.1.0/.python-version

@@ -0,0 +1 @@
+3.11.9