automagik-forge 0.1.11 → 0.1.13

package/backend/.sqlx/query-b2b2c6b4d0b1a347b5c4cb63c3a46a265d4db53be9554989a814b069d0af82f2.json

@@ -0,0 +1,62 @@
+{
+  "db_name": "SQLite",
+  "query": "SELECT id as \"id!: Uuid\", name, git_repo_path, setup_script, dev_script, cleanup_script, created_at as \"created_at!: DateTime<Utc>\", updated_at as \"updated_at!: DateTime<Utc>\" FROM projects ORDER BY created_at DESC",
+  "describe": {
+    "columns": [
+      {
+        "name": "id!: Uuid",
+        "ordinal": 0,
+        "type_info": "Blob"
+      },
+      {
+        "name": "name",
+        "ordinal": 1,
+        "type_info": "Text"
+      },
+      {
+        "name": "git_repo_path",
+        "ordinal": 2,
+        "type_info": "Text"
+      },
+      {
+        "name": "setup_script",
+        "ordinal": 3,
+        "type_info": "Text"
+      },
+      {
+        "name": "dev_script",
+        "ordinal": 4,
+        "type_info": "Text"
+      },
+      {
+        "name": "cleanup_script",
+        "ordinal": 5,
+        "type_info": "Text"
+      },
+      {
+        "name": "created_at!: DateTime<Utc>",
+        "ordinal": 6,
+        "type_info": "Text"
+      },
+      {
+        "name": "updated_at!: DateTime<Utc>",
+        "ordinal": 7,
+        "type_info": "Text"
+      }
+    ],
+    "parameters": {
+      "Right": 0
+    },
+    "nullable": [
+      true,
+      false,
+      false,
+      true,
+      true,
+      true,
+      false,
+      false
+    ]
+  },
+  "hash": "b2b2c6b4d0b1a347b5c4cb63c3a46a265d4db53be9554989a814b069d0af82f2"
+}

package/backend/.sqlx/query-c50d2ff0b12e5bcc81e371089ee2d007e233e7db93aefba4fef08e7aa68f5ab7.json

@@ -0,0 +1,20 @@
+{
+  "db_name": "SQLite",
+  "query": "SELECT id as \"id!: Uuid\" FROM tasks WHERE id = $1 AND project_id = $2",
+  "describe": {
+    "columns": [
+      {
+        "name": "id!: Uuid",
+        "ordinal": 0,
+        "type_info": "Blob"
+      }
+    ],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": [
+      true
+    ]
+  },
+  "hash": "c50d2ff0b12e5bcc81e371089ee2d007e233e7db93aefba4fef08e7aa68f5ab7"
+}

package/backend/.sqlx/query-c614e6056b244ca07f1b9d44e7edc9d5819225c6f8d9e077070c6e518a17f50b.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "DELETE FROM tasks WHERE id = $1 AND project_id = $2",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": []
+  },
+  "hash": "c614e6056b244ca07f1b9d44e7edc9d5819225c6f8d9e077070c6e518a17f50b"
+}

package/backend/.sqlx/query-c67259be8bf4ee0cfd32167b2aa3b7fe9192809181a8171bf1c2d6df731967ae.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "UPDATE execution_processes \n               SET status = $1, exit_code = $2, completed_at = $3, updated_at = datetime('now') \n               WHERE id = $4",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 4
+    },
+    "nullable": []
+  },
+  "hash": "c67259be8bf4ee0cfd32167b2aa3b7fe9192809181a8171bf1c2d6df731967ae"
+}

package/backend/.sqlx/query-d2d0a1b985ebbca6a2b3e882a221a219f3199890fa640afc946ef1a792d6d8de.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "UPDATE tasks SET status = $3, updated_at = CURRENT_TIMESTAMP WHERE id = $1 AND project_id = $2",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 3
+    },
+    "nullable": []
+  },
+  "hash": "d2d0a1b985ebbca6a2b3e882a221a219f3199890fa640afc946ef1a792d6d8de"
+}

package/backend/.sqlx/query-d30aa5786757f32bf2b9c5fe51a45e506c71c28c5994e430d9b0546adb15ffa2.json

@@ -0,0 +1,20 @@
+{
+  "db_name": "SQLite",
+  "query": "\n                SELECT COUNT(*) as \"count!: i64\"\n                FROM projects\n                WHERE id = $1\n            ",
+  "describe": {
+    "columns": [
+      {
+        "name": "count!: i64",
+        "ordinal": 0,
+        "type_info": "Integer"
+      }
+    ],
+    "parameters": {
+      "Right": 1
+    },
+    "nullable": [
+      false
+    ]
+  },
+  "hash": "d30aa5786757f32bf2b9c5fe51a45e506c71c28c5994e430d9b0546adb15ffa2"
+}

package/backend/.sqlx/query-d3b9ea1de1576af71b312924ce7f4ea8ae5dbe2ac138ea3b4470f2d5cd734846.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "UPDATE executor_sessions \n               SET prompt = $1, updated_at = datetime('now') \n               WHERE id = $2",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": []
+  },
+  "hash": "d3b9ea1de1576af71b312924ce7f4ea8ae5dbe2ac138ea3b4470f2d5cd734846"
+}

package/backend/.sqlx/query-ed8456646fa69ddd412441955f06ff22bfb790f29466450735e0b8bb1bc4ec94.json

@@ -0,0 +1,12 @@
+{
+  "db_name": "SQLite",
+  "query": "UPDATE execution_processes SET stdout = COALESCE(stdout, '') || $1, updated_at = datetime('now') WHERE id = $2",
+  "describe": {
+    "columns": [],
+    "parameters": {
+      "Right": 2
+    },
+    "nullable": []
+  },
+  "hash": "ed8456646fa69ddd412441955f06ff22bfb790f29466450735e0b8bb1bc4ec94"
+}

package/backend/Cargo.toml

@@ -0,0 +1,71 @@
+[package]
+name = "automagik-forge"
+version = "0.1.13"
+edition = "2021"
+default-run = "automagik-forge"
+build = "build.rs"
+
+[lib]
+name = "automagik_forge"
+path = "src/lib.rs"
+
+[lints.clippy]
+uninlined-format-args = "allow"
+
+[dependencies]
+tokio = { workspace = true }
+tokio-util = { version = "0.7" }
+axum = { workspace = true }
+tower-http = { workspace = true }
+serde = { workspace = true }
+serde_json = { workspace = true }
+anyhow = { workspace = true }
+tracing = { workspace = true }
+tracing-subscriber = { workspace = true }
+sqlx = { version = "0.8.6", features = ["runtime-tokio-rustls", "sqlite", "chrono", "uuid"] }
+chrono = { version = "0.4", features = ["serde"] }
+uuid = { version = "1.0", features = ["v4", "serde"] }
+ts-rs = { version = "9.0", features = ["uuid-impl", "chrono-impl", "no-serde-warnings"] }
+dirs = "5.0"
+xdg = "3.0"
+git2 = "0.18"
+async-trait = "0.1"
+libc = "0.2"
+rust-embed = "8.2"
+mime_guess = "2.0"
+directories = "6.0.0"
+open = "5.3.2"
+pathdiff = "0.2.1"
+ignore = "0.4"
+command-group = { version = "5.0", features = ["with-tokio"] }
+nix = { version = "0.29", features = ["signal", "process"] }
+openssl-sys = { workspace = true }
+rmcp = { version = "0.3.0", features = ["server", "transport-io", "transport-sse-server"] }
+schemars = "0.8"
+regex = "1.11.1"
+notify-rust = "4.11"
+octocrab = "0.44"
+os_info = "3.12.0"
+sentry = { version = "0.41.0", features = ["anyhow", "backtrace", "panic", "debug-images"] }
+sentry-tower = "0.41.0"
+sentry-tracing = { version = "0.41.0", features = ["backtrace"] }
+reqwest = { version = "0.11", features = ["json"] }
+strip-ansi-escapes = "0.2.1"
+urlencoding = "2.1.3"
+lazy_static = "1.4"
+futures-util = "0.3"
+async-stream = "0.3"
+json-patch = "2.0"
+dotenvy = "0.15"
+utoipa = { version = "5.1.0", features = ["axum_extras", "chrono", "uuid"] }
+utoipa-axum = { version = "0.1.0" }
+utoipa-swagger-ui = { version = "8.0.0", features = ["axum"] }
+
+[dev-dependencies]
+tempfile = "3.8"
+tower = { version = "0.4", features = ["util"] }
+
+[build-dependencies]
+dotenv = "0.15"
+ts-rs = { version = "9.0", features = ["uuid-impl", "chrono-impl", "no-serde-warnings"] }
+

package/backend/build.rs

@@ -0,0 +1,32 @@
+use std::{fs, path::Path};
+
+fn main() {
+    dotenv::dotenv().ok();
+
+    if let Ok(api_key) = std::env::var("POSTHOG_API_KEY") {
+        println!("cargo:rustc-env=POSTHOG_API_KEY={}", api_key);
+    }
+    if let Ok(api_endpoint) = std::env::var("POSTHOG_API_ENDPOINT") {
+        println!("cargo:rustc-env=POSTHOG_API_ENDPOINT={}", api_endpoint);
+    }
+    if let Ok(api_key) = std::env::var("GITHUB_APP_ID") {
+        println!("cargo:rustc-env=GITHUB_APP_ID={}", api_key);
+    }
+    if let Ok(api_endpoint) = std::env::var("GITHUB_APP_CLIENT_ID") {
+        println!("cargo:rustc-env=GITHUB_APP_CLIENT_ID={}", api_endpoint);
+    }
+
+    // Create frontend/dist directory if it doesn't exist
+    let dist_path = Path::new("../frontend/dist");
+    if !dist_path.exists() {
+        println!("cargo:warning=Creating dummy frontend/dist directory for compilation");
+        fs::create_dir_all(dist_path).unwrap();
+
+        // Create a dummy index.html
+        let dummy_html = r#"<!DOCTYPE html>
+<html><head><title>Build frontend first</title></head>
+<body><h1>Please build the frontend</h1></body></html>"#;
+
+        fs::write(dist_path.join("index.html"), dummy_html).unwrap();
+    }
+}

package/backend/migrations/20250617183714_init.sql

@@ -0,0 +1,44 @@
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE projects (
+    id            BLOB PRIMARY KEY,
+    name          TEXT NOT NULL,
+    git_repo_path TEXT NOT NULL DEFAULT '' UNIQUE,
+    setup_script  TEXT DEFAULT '',
+    created_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    updated_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec'))
+);
+
+CREATE TABLE tasks (
+    id          BLOB PRIMARY KEY,
+    project_id  BLOB NOT NULL,
+    title       TEXT NOT NULL,
+    description TEXT,
+    status      TEXT NOT NULL DEFAULT 'todo'
+                   CHECK (status IN ('todo','inprogress','done','cancelled','inreview')),
+    created_at  TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    updated_at  TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+);
+
+CREATE TABLE task_attempts (
+    id            BLOB PRIMARY KEY,
+    task_id       BLOB NOT NULL,
+    worktree_path TEXT NOT NULL,
+    merge_commit  TEXT,
+    executor      TEXT,
+    stdout        TEXT,
+    stderr        TEXT,
+    created_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    updated_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE
+);
+
+CREATE TABLE task_attempt_activities (
+    id              BLOB PRIMARY KEY,
+    task_attempt_id BLOB NOT NULL,
+    status          TEXT NOT NULL DEFAULT 'init'
+                       CHECK (status IN ('init','setuprunning','setupcomplete','setupfailed','executorrunning','executorcomplete','executorfailed','paused')),    note            TEXT,
+    created_at      TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    FOREIGN KEY (task_attempt_id) REFERENCES task_attempts(id) ON DELETE CASCADE
+);

package/backend/migrations/20250620212427_execution_processes.sql

@@ -0,0 +1,25 @@
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE execution_processes (
+    id                BLOB PRIMARY KEY,
+    task_attempt_id   BLOB NOT NULL,
+    process_type      TEXT NOT NULL DEFAULT 'setupscript'
+                         CHECK (process_type IN ('setupscript','codingagent','devserver')),
+    status            TEXT NOT NULL DEFAULT 'running'
+                         CHECK (status IN ('running','completed','failed','killed')),
+    command           TEXT NOT NULL,
+    args              TEXT,  -- JSON array of arguments
+    working_directory TEXT NOT NULL,
+    stdout            TEXT,
+    stderr            TEXT,
+    exit_code         INTEGER,
+    started_at        TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    completed_at      TEXT,
+    created_at        TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    updated_at        TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    FOREIGN KEY (task_attempt_id) REFERENCES task_attempts(id) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_execution_processes_task_attempt_id ON execution_processes(task_attempt_id);
+CREATE INDEX idx_execution_processes_status ON execution_processes(status);
+CREATE INDEX idx_execution_processes_type ON execution_processes(process_type);

package/backend/migrations/20250620214100_remove_stdout_stderr_from_task_attempts.sql

@@ -0,0 +1,28 @@
+PRAGMA foreign_keys = ON;
+
+-- Remove stdout and stderr columns from task_attempts table
+-- These are now tracked in the execution_processes table for better granularity
+
+-- SQLite doesn't support DROP COLUMN directly, so we need to recreate the table
+-- First, create a new table without stdout and stderr
+CREATE TABLE task_attempts_new (
+    id            BLOB PRIMARY KEY,
+    task_id       BLOB NOT NULL,
+    worktree_path TEXT NOT NULL,
+    merge_commit  TEXT,
+    executor      TEXT,
+    created_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    updated_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE
+);
+
+-- Copy data from old table to new table (excluding stdout and stderr)
+INSERT INTO task_attempts_new (id, task_id, worktree_path, merge_commit, executor, created_at, updated_at)
+SELECT id, task_id, worktree_path, merge_commit, executor, created_at, updated_at
+FROM task_attempts;
+
+-- Drop the old table
+DROP TABLE task_attempts;
+
+-- Rename the new table to the original name
+ALTER TABLE task_attempts_new RENAME TO task_attempts;

package/backend/migrations/20250621120000_relate_activities_to_execution_processes.sql

@@ -0,0 +1,23 @@
+-- Migration to relate task_attempt_activities to execution_processes instead of task_attempts
+-- This migration will:
+-- 1. Drop and recreate the task_attempt_activities table with execution_process_id
+-- 2. Clear existing data as it cannot be migrated meaningfully
+
+-- Drop the existing table (this will wipe existing activity data)
+DROP TABLE IF EXISTS task_attempt_activities;
+
+-- Create the new table structure with execution_process_id foreign key
+CREATE TABLE task_attempt_activities (
+    id TEXT PRIMARY KEY,
+    execution_process_id TEXT NOT NULL REFERENCES execution_processes(id) ON DELETE CASCADE,
+    status TEXT NOT NULL,
+    note TEXT,
+    created_at DATETIME NOT NULL DEFAULT (datetime('now')),
+    FOREIGN KEY (execution_process_id) REFERENCES execution_processes(id) ON DELETE CASCADE
+);
+
+-- Create index for efficient lookups by execution_process_id
+CREATE INDEX idx_task_attempt_activities_execution_process_id ON task_attempt_activities(execution_process_id);
+
+-- Create index for efficient lookups by created_at for ordering
+CREATE INDEX idx_task_attempt_activities_created_at ON task_attempt_activities(created_at);

package/backend/migrations/20250623120000_executor_sessions.sql

@@ -0,0 +1,17 @@
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE executor_sessions (
+    id                    BLOB PRIMARY KEY,
+    task_attempt_id       BLOB NOT NULL,
+    execution_process_id  BLOB NOT NULL,
+    session_id            TEXT,  -- External session ID from Claude/Amp
+    prompt                TEXT,  -- The prompt sent to the executor
+    created_at            TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    updated_at            TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    FOREIGN KEY (task_attempt_id) REFERENCES task_attempts(id) ON DELETE CASCADE,
+    FOREIGN KEY (execution_process_id) REFERENCES execution_processes(id) ON DELETE CASCADE
+);
+
+CREATE INDEX idx_executor_sessions_task_attempt_id ON executor_sessions(task_attempt_id);
+CREATE INDEX idx_executor_sessions_execution_process_id ON executor_sessions(execution_process_id);
+CREATE INDEX idx_executor_sessions_session_id ON executor_sessions(session_id);

package/backend/migrations/20250623130000_add_executor_type_to_execution_processes.sql

@@ -0,0 +1,4 @@
+PRAGMA foreign_keys = ON;
+
+-- Add executor_type column to execution_processes table
+ALTER TABLE execution_processes ADD COLUMN executor_type TEXT;

package/backend/migrations/20250625000000_add_dev_script_to_projects.sql

@@ -0,0 +1,4 @@
+PRAGMA foreign_keys = ON;
+
+-- Add dev_script column to projects table
+ALTER TABLE projects ADD COLUMN dev_script TEXT DEFAULT '';

package/backend/migrations/20250701000000_add_branch_to_task_attempts.sql

@@ -0,0 +1,2 @@
+-- Add branch column to task_attempts table
+ALTER TABLE task_attempts ADD COLUMN branch TEXT NOT NULL DEFAULT '';

package/backend/migrations/20250701000001_add_pr_tracking_to_task_attempts.sql

@@ -0,0 +1,5 @@
+-- Add PR tracking fields to task_attempts table
+ALTER TABLE task_attempts ADD COLUMN pr_url TEXT;
+ALTER TABLE task_attempts ADD COLUMN pr_number INTEGER;
+ALTER TABLE task_attempts ADD COLUMN pr_status TEXT; -- open, closed, merged
+ALTER TABLE task_attempts ADD COLUMN pr_merged_at DATETIME;

package/backend/migrations/20250701120000_add_assistant_message_to_executor_sessions.sql

@@ -0,0 +1,2 @@
+-- Add summary column to executor_sessions table
+ALTER TABLE executor_sessions ADD COLUMN summary TEXT;

package/backend/migrations/20250708000000_add_base_branch_to_task_attempts.sql

@@ -0,0 +1,2 @@
+-- Add base_branch column to task_attempts table with default value
+ALTER TABLE task_attempts ADD COLUMN base_branch TEXT NOT NULL DEFAULT 'main';

package/backend/migrations/20250709000000_add_worktree_deleted_flag.sql

@@ -0,0 +1,2 @@
+-- Add worktree_deleted flag to track when worktrees are cleaned up
+ALTER TABLE task_attempts ADD COLUMN worktree_deleted BOOLEAN NOT NULL DEFAULT FALSE;

package/backend/migrations/20250710000000_add_setup_completion.sql

@@ -0,0 +1,3 @@
+-- Add setup completion tracking to task_attempts table
+-- This enables automatic setup script execution for recreated worktrees
+ALTER TABLE task_attempts ADD COLUMN setup_completed_at DATETIME;

package/backend/migrations/20250715154859_add_task_templates.sql

@@ -0,0 +1,25 @@
+-- Add task templates tables
+CREATE TABLE task_templates (
+    id            BLOB PRIMARY KEY,
+    project_id    BLOB,  -- NULL for global templates
+    title         TEXT NOT NULL,
+    description   TEXT,
+    template_name TEXT NOT NULL,  -- Display name for the template
+    created_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    updated_at    TEXT NOT NULL DEFAULT (datetime('now', 'subsec')),
+    FOREIGN KEY (project_id) REFERENCES projects(id) ON DELETE CASCADE
+);
+
+-- Add index for faster queries
+CREATE INDEX idx_task_templates_project_id ON task_templates(project_id);
+
+-- Add unique constraints to prevent duplicate template names within same scope
+-- For project-specific templates: unique within each project
+CREATE UNIQUE INDEX idx_task_templates_unique_name_project 
+ON task_templates(project_id, template_name) 
+WHERE project_id IS NOT NULL;
+
+-- For global templates: unique across all global templates
+CREATE UNIQUE INDEX idx_task_templates_unique_name_global 
+ON task_templates(template_name) 
+WHERE project_id IS NULL;

package/backend/migrations/20250716143725_add_default_templates.sql

@@ -0,0 +1,174 @@
+-- Add default global templates
+
+-- 1. Bug Analysis template
+INSERT INTO task_templates (
+    id,
+    project_id,
+    title,
+    description,
+    template_name,
+    created_at,
+    updated_at
+) VALUES (
+    randomblob(16),
+    NULL, -- Global template
+    'Analyze codebase for potential bugs and issues',
+    'Perform a comprehensive analysis of the project codebase to identify potential bugs, code smells, and areas of improvement.
+
+## Analysis Checklist:
+
+### 1. Static Code Analysis
+- [ ] Run linting tools to identify syntax and style issues
+- [ ] Check for unused variables, imports, and dead code
+- [ ] Identify potential type errors or mismatches
+- [ ] Look for deprecated API usage
+
+### 2. Common Bug Patterns
+- [ ] Check for null/undefined reference errors
+- [ ] Identify potential race conditions
+- [ ] Look for improper error handling
+- [ ] Check for resource leaks (memory, file handles, connections)
+- [ ] Identify potential security vulnerabilities (XSS, SQL injection, etc.)
+
+### 3. Code Quality Issues
+- [ ] Identify overly complex functions (high cyclomatic complexity)
+- [ ] Look for code duplication
+- [ ] Check for missing or inadequate input validation
+- [ ] Identify hardcoded values that should be configurable
+
+### 4. Testing Gaps
+- [ ] Identify untested code paths
+- [ ] Check for missing edge case tests
+- [ ] Look for inadequate error scenario testing
+
+### 5. Performance Concerns
+- [ ] Identify potential performance bottlenecks
+- [ ] Check for inefficient algorithms or data structures
+- [ ] Look for unnecessary database queries or API calls
+
+## Deliverables:
+1. Prioritized list of identified issues
+2. Recommendations for fixes
+3. Estimated effort for addressing each issue',
+    'Bug Analysis',
+    datetime('now', 'subsec'),
+    datetime('now', 'subsec')
+);
+
+-- 2. Unit Test template
+INSERT INTO task_templates (
+    id,
+    project_id,
+    title,
+    description,
+    template_name,
+    created_at,
+    updated_at
+) VALUES (
+    randomblob(16),
+    NULL, -- Global template
+    'Add unit tests for [component/function]',
+    'Write unit tests to improve code coverage and ensure reliability.
+
+## Unit Testing Checklist
+
+### 1. Identify What to Test
+- [ ] Run coverage report to find untested functions
+- [ ] List the specific functions/methods to test
+- [ ] Note current coverage percentage
+
+### 2. Write Tests
+- [ ] Test the happy path (expected behavior)
+- [ ] Test edge cases (empty inputs, boundaries)
+- [ ] Test error cases (invalid inputs, exceptions)
+- [ ] Mock external dependencies
+- [ ] Use descriptive test names
+
+### 3. Test Quality
+- [ ] Each test focuses on one behavior
+- [ ] Tests can run independently
+- [ ] No hardcoded values that might change
+- [ ] Clear assertions that verify the behavior
+
+## Examples to Cover:
+- Normal inputs → Expected outputs
+- Empty/null inputs → Proper handling
+- Invalid inputs → Error cases
+- Boundary values → Edge case behavior
+
+## Goal
+Achieve at least 80% coverage for the target component
+
+## Deliverables
+1. New test file(s) with comprehensive unit tests
+2. Updated coverage report
+3. All tests passing',
+    'Add Unit Tests',
+    datetime('now', 'subsec'),
+    datetime('now', 'subsec')
+);
+
+-- 3. Code Refactoring template
+INSERT INTO task_templates (
+    id,
+    project_id,
+    title,
+    description,
+    template_name,
+    created_at,
+    updated_at
+) VALUES (
+    randomblob(16),
+    NULL, -- Global template
+    'Refactor [component/module] for better maintainability',
+    'Improve code structure and maintainability without changing functionality.
+
+## Refactoring Checklist
+
+### 1. Identify Refactoring Targets
+- [ ] Run code analysis tools (linters, complexity analyzers)
+- [ ] Identify code smells (long methods, duplicate code, large classes)
+- [ ] Check for outdated patterns or deprecated approaches
+- [ ] Review areas with frequent bugs or changes
+
+### 2. Plan the Refactoring
+- [ ] Define clear goals (what to improve and why)
+- [ ] Ensure tests exist for current functionality
+- [ ] Create a backup branch
+- [ ] Break down into small, safe steps
+
+### 3. Common Refactoring Actions
+- [ ] Extract methods from long functions
+- [ ] Remove duplicate code (DRY principle)
+- [ ] Rename variables/functions for clarity
+- [ ] Simplify complex conditionals
+- [ ] Extract constants from magic numbers/strings
+- [ ] Group related functionality into modules
+- [ ] Remove dead code
+
+### 4. Maintain Functionality
+- [ ] Run tests after each change
+- [ ] Keep changes small and incremental
+- [ ] Commit frequently with clear messages
+- [ ] Verify no behavior has changed
+
+### 5. Code Quality Improvements
+- [ ] Apply consistent formatting
+- [ ] Update to modern syntax/features
+- [ ] Improve error handling
+- [ ] Add type annotations (if applicable)
+
+## Success Criteria
+- All tests still pass
+- Code is more readable and maintainable
+- No new bugs introduced
+- Performance not degraded
+
+## Deliverables
+1. Refactored code with improved structure
+2. All tests passing
+3. Brief summary of changes made',
+    'Code Refactoring',
+    datetime('now', 'subsec'),
+    datetime('now', 'subsec')
+);