feat: task templates (vibe-kanban) (#197)

* I've successfully implemented task templates for vibe-kanban with the following features:

- Created a new `task_templates` table with fields for:
  - `id` (UUID primary key)
  - `project_id` (nullable for global templates)
  - `title` (default task title)
  - `description` (default task description)
  - `template_name` (display name for the template)
  - Timestamps for tracking creation/updates

- Created `TaskTemplate` model with full CRUD operations
- Added REST API endpoints:
  - `GET /api/templates` - List all templates
  - `GET /api/templates/global` - List only global templates
  - `GET /api/projects/:project_id/templates` - List templates for a project (includes global)
  - `GET /api/templates/:id` - Get specific template
  - `POST /api/templates` - Create template
  - `PUT /api/templates/:id` - Update template
  - `DELETE /api/templates/:id` - Delete template

1. **Task Creation Dialog**:
   - Added template selector dropdown when creating new tasks
   - Templates are fetched based on project context
   - Selecting a template pre-fills title and description fields
   - User can edit pre-filled values before creating the task

2. **Global Settings**:
   - Added "Task Templates" section to manage global templates
   - Full CRUD interface with table view
   - Create/Edit dialog for template management

3. **Project Settings**:
   - Modified project form to use tabs when editing
   - Added "Task Templates" tab for project-specific templates
   - Same management interface as global settings

- **Scope Management**: Templates can be global (available to all projects) or project-specific
- **User Experience**: Template selection is optional and doesn't interfere with normal task creation
- **Data Validation**: Unique template names within same scope (global or per-project)
- **UI Polish**: Clean interface with loading states, error handling, and confirmation dialogs

The implementation allows users to create reusable task templates that streamline the task creation process by pre-filling common values while still allowing full editing before submission.

* improve styling

* address review comments

* fix unqiue contraint on tempaltes

* distinguish between local and global templates in UI

* keyboard shortcuts for task creation

* add dropdown on project page to select templates

* update types

* add default global task templates

* Add task templates from kanban (#219)

* Create project templates from kanban

* Fixes

* remove duplicate

---------

Co-authored-by: Louis Knight-Webb <louis@bloop.ai>
This commit is contained in:
Gabriel Gordon-Hall
2025-07-16 15:46:42 +01:00
committed by GitHub
parent 4f694f1fc6
commit 471d28defd
29 changed files with 2042 additions and 251 deletions

View File

@@ -98,6 +98,9 @@ fn generate_types_content() -> String {
vibe_kanban::models::task::Task::decl(),
vibe_kanban::models::task::TaskWithAttemptStatus::decl(),
vibe_kanban::models::task::UpdateTask::decl(),
vibe_kanban::models::task_template::TaskTemplate::decl(),
vibe_kanban::models::task_template::CreateTaskTemplate::decl(),
vibe_kanban::models::task_template::UpdateTaskTemplate::decl(),
vibe_kanban::models::task_attempt::TaskAttemptStatus::decl(),
vibe_kanban::models::task_attempt::TaskAttempt::decl(),
vibe_kanban::models::task_attempt::CreateTaskAttempt::decl(),

View File

@@ -29,7 +29,9 @@ mod utils;
use app_state::AppState;
use execution_monitor::execution_monitor;
use models::{ApiResponse, Config};
use routes::{auth, config, filesystem, health, projects, stream, task_attempts, tasks};
use routes::{
auth, config, filesystem, health, projects, stream, task_attempts, task_templates, tasks,
};
use services::PrMonitorService;
async fn echo_handler(
@@ -199,6 +201,7 @@ fn main() -> anyhow::Result<()> {
.merge(tasks::tasks_router())
.merge(task_attempts::task_attempts_router())
.merge(stream::stream_router())
.merge(task_templates::templates_router())
.merge(filesystem::filesystem_router())
.merge(config::config_router())
.merge(auth::auth_router())

View File

@@ -8,3 +8,21 @@ pub struct ApiResponse<T> {
pub data: Option<T>,
pub message: Option<String>,
}
impl<T> ApiResponse<T> {
pub fn success(data: T) -> Self {
Self {
success: true,
data: Some(data),
message: None,
}
}
pub fn error(message: &str) -> Self {
Self {
success: false,
data: None,
message: Some(message.to_string()),
}
}
}

View File

@@ -6,6 +6,7 @@ pub mod project;
pub mod task;
pub mod task_attempt;
pub mod task_attempt_activity;
pub mod task_template;
pub use api_response::ApiResponse;
pub use config::Config;

View File

@@ -0,0 +1,145 @@
use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use sqlx::{FromRow, SqlitePool};
use ts_rs::TS;
use uuid::Uuid;
#[derive(Debug, Clone, FromRow, Serialize, Deserialize, TS)]
#[ts(export)]
pub struct TaskTemplate {
pub id: Uuid,
pub project_id: Option<Uuid>, // None for global templates
pub title: String,
pub description: Option<String>,
pub template_name: String,
pub created_at: DateTime<Utc>,
pub updated_at: DateTime<Utc>,
}
#[derive(Debug, Deserialize, TS)]
#[ts(export)]
pub struct CreateTaskTemplate {
pub project_id: Option<Uuid>,
pub title: String,
pub description: Option<String>,
pub template_name: String,
}
#[derive(Debug, Deserialize, TS)]
#[ts(export)]
pub struct UpdateTaskTemplate {
pub title: Option<String>,
pub description: Option<String>,
pub template_name: Option<String>,
}
impl TaskTemplate {
pub async fn find_all(pool: &SqlitePool) -> Result<Vec<Self>, sqlx::Error> {
sqlx::query_as!(
TaskTemplate,
r#"SELECT id as "id!: Uuid", project_id as "project_id?: Uuid", title, description, template_name, created_at as "created_at!: DateTime<Utc>", updated_at as "updated_at!: DateTime<Utc>"
FROM task_templates
ORDER BY project_id IS NULL DESC, template_name ASC"#
)
.fetch_all(pool)
.await
}
pub async fn find_by_project_id(
pool: &SqlitePool,
project_id: Option<Uuid>,
) -> Result<Vec<Self>, sqlx::Error> {
if let Some(pid) = project_id {
// Return only project-specific templates
sqlx::query_as::<_, TaskTemplate>(
r#"SELECT id, project_id, title, description, template_name, created_at, updated_at
FROM task_templates
WHERE project_id = ?
ORDER BY template_name ASC"#,
)
.bind(pid)
.fetch_all(pool)
.await
} else {
// Return only global templates
sqlx::query_as!(
TaskTemplate,
r#"SELECT id as "id!: Uuid", project_id as "project_id?: Uuid", title, description, template_name, created_at as "created_at!: DateTime<Utc>", updated_at as "updated_at!: DateTime<Utc>"
FROM task_templates
WHERE project_id IS NULL
ORDER BY template_name ASC"#
)
.fetch_all(pool)
.await
}
}
pub async fn find_by_id(pool: &SqlitePool, id: Uuid) -> Result<Option<Self>, sqlx::Error> {
sqlx::query_as!(
TaskTemplate,
r#"SELECT id as "id!: Uuid", project_id as "project_id?: Uuid", title, description, template_name, created_at as "created_at!: DateTime<Utc>", updated_at as "updated_at!: DateTime<Utc>"
FROM task_templates
WHERE id = $1"#,
id
)
.fetch_optional(pool)
.await
}
pub async fn create(pool: &SqlitePool, data: &CreateTaskTemplate) -> Result<Self, sqlx::Error> {
let id = Uuid::new_v4();
sqlx::query_as!(
TaskTemplate,
r#"INSERT INTO task_templates (id, project_id, title, description, template_name)
VALUES ($1, $2, $3, $4, $5)
RETURNING id as "id!: Uuid", project_id as "project_id?: Uuid", title, description, template_name, created_at as "created_at!: DateTime<Utc>", updated_at as "updated_at!: DateTime<Utc>""#,
id,
data.project_id,
data.title,
data.description,
data.template_name
)
.fetch_one(pool)
.await
}
pub async fn update(
pool: &SqlitePool,
id: Uuid,
data: &UpdateTaskTemplate,
) -> Result<Self, sqlx::Error> {
// Get existing template first
let existing = Self::find_by_id(pool, id)
.await?
.ok_or(sqlx::Error::RowNotFound)?;
// Use let bindings to create longer-lived values
let title = data.title.as_ref().unwrap_or(&existing.title);
let description = data.description.as_ref().or(existing.description.as_ref());
let template_name = data
.template_name
.as_ref()
.unwrap_or(&existing.template_name);
sqlx::query_as!(
TaskTemplate,
r#"UPDATE task_templates
SET title = $2, description = $3, template_name = $4, updated_at = datetime('now', 'subsec')
WHERE id = $1
RETURNING id as "id!: Uuid", project_id as "project_id?: Uuid", title, description, template_name, created_at as "created_at!: DateTime<Utc>", updated_at as "updated_at!: DateTime<Utc>""#,
id,
title,
description,
template_name
)
.fetch_one(pool)
.await
}
pub async fn delete(pool: &SqlitePool, id: Uuid) -> Result<u64, sqlx::Error> {
let result = sqlx::query!("DELETE FROM task_templates WHERE id = $1", id)
.execute(pool)
.await?;
Ok(result.rows_affected())
}
}

View File

@@ -5,4 +5,5 @@ pub mod health;
pub mod projects;
pub mod stream;
pub mod task_attempts;
pub mod task_templates;
pub mod tasks;

View File

@@ -0,0 +1,178 @@
use axum::{
extract::{Path, State},
http::StatusCode,
response::IntoResponse,
routing::get,
Json, Router,
};
use uuid::Uuid;
use crate::{
app_state::AppState,
models::{
api_response::ApiResponse,
task_template::{CreateTaskTemplate, TaskTemplate, UpdateTaskTemplate},
},
};
pub async fn list_templates(
State(state): State<AppState>,
) -> Result<impl IntoResponse, (StatusCode, Json<ApiResponse<()>>)> {
match TaskTemplate::find_all(&state.db_pool).await {
Ok(templates) => Ok(Json(ApiResponse::success(templates))),
Err(e) => Err((
StatusCode::INTERNAL_SERVER_ERROR,
Json(ApiResponse::error(&format!(
"Failed to fetch templates: {}",
e
))),
)),
}
}
pub async fn list_project_templates(
State(state): State<AppState>,
Path(project_id): Path<Uuid>,
) -> Result<impl IntoResponse, (StatusCode, Json<ApiResponse<()>>)> {
match TaskTemplate::find_by_project_id(&state.db_pool, Some(project_id)).await {
Ok(templates) => Ok(Json(ApiResponse::success(templates))),
Err(e) => Err((
StatusCode::INTERNAL_SERVER_ERROR,
Json(ApiResponse::error(&format!(
"Failed to fetch templates: {}",
e
))),
)),
}
}
pub async fn list_global_templates(
State(state): State<AppState>,
) -> Result<impl IntoResponse, (StatusCode, Json<ApiResponse<()>>)> {
match TaskTemplate::find_by_project_id(&state.db_pool, None).await {
Ok(templates) => Ok(Json(ApiResponse::success(templates))),
Err(e) => Err((
StatusCode::INTERNAL_SERVER_ERROR,
Json(ApiResponse::error(&format!(
"Failed to fetch global templates: {}",
e
))),
)),
}
}
pub async fn get_template(
State(state): State<AppState>,
Path(template_id): Path<Uuid>,
) -> Result<impl IntoResponse, (StatusCode, Json<ApiResponse<()>>)> {
match TaskTemplate::find_by_id(&state.db_pool, template_id).await {
Ok(Some(template)) => Ok(Json(ApiResponse::success(template))),
Ok(None) => Err((
StatusCode::NOT_FOUND,
Json(ApiResponse::error("Template not found")),
)),
Err(e) => Err((
StatusCode::INTERNAL_SERVER_ERROR,
Json(ApiResponse::error(&format!(
"Failed to fetch template: {}",
e
))),
)),
}
}
pub async fn create_template(
State(state): State<AppState>,
Json(payload): Json<CreateTaskTemplate>,
) -> Result<impl IntoResponse, (StatusCode, Json<ApiResponse<()>>)> {
match TaskTemplate::create(&state.db_pool, &payload).await {
Ok(template) => Ok((StatusCode::CREATED, Json(ApiResponse::success(template)))),
Err(e) => {
if e.to_string().contains("UNIQUE constraint failed") {
Err((
StatusCode::CONFLICT,
Json(ApiResponse::error(
"A template with this name already exists in this scope",
)),
))
} else {
Err((
StatusCode::INTERNAL_SERVER_ERROR,
Json(ApiResponse::error(&format!(
"Failed to create template: {}",
e
))),
))
}
}
}
}
pub async fn update_template(
State(state): State<AppState>,
Path(template_id): Path<Uuid>,
Json(payload): Json<UpdateTaskTemplate>,
) -> Result<impl IntoResponse, (StatusCode, Json<ApiResponse<()>>)> {
match TaskTemplate::update(&state.db_pool, template_id, &payload).await {
Ok(template) => Ok(Json(ApiResponse::success(template))),
Err(e) => {
if matches!(e, sqlx::Error::RowNotFound) {
Err((
StatusCode::NOT_FOUND,
Json(ApiResponse::error("Template not found")),
))
} else if e.to_string().contains("UNIQUE constraint failed") {
Err((
StatusCode::CONFLICT,
Json(ApiResponse::error(
"A template with this name already exists in this scope",
)),
))
} else {
Err((
StatusCode::INTERNAL_SERVER_ERROR,
Json(ApiResponse::error(&format!(
"Failed to update template: {}",
e
))),
))
}
}
}
}
pub async fn delete_template(
State(state): State<AppState>,
Path(template_id): Path<Uuid>,
) -> Result<impl IntoResponse, (StatusCode, Json<ApiResponse<()>>)> {
match TaskTemplate::delete(&state.db_pool, template_id).await {
Ok(0) => Err((
StatusCode::NOT_FOUND,
Json(ApiResponse::error("Template not found")),
)),
Ok(_) => Ok(Json(ApiResponse::success(()))),
Err(e) => Err((
StatusCode::INTERNAL_SERVER_ERROR,
Json(ApiResponse::error(&format!(
"Failed to delete template: {}",
e
))),
)),
}
}
pub fn templates_router() -> Router<AppState> {
Router::new()
.route("/templates", get(list_templates).post(create_template))
.route("/templates/global", get(list_global_templates))
.route(
"/templates/:id",
get(get_template)
.put(update_template)
.delete(delete_template),
)
.route(
"/projects/:project_id/templates",
get(list_project_templates),
)
}