@sprintdock/backend 0.4.2

package/drizzle/meta/0001_snapshot.json

@@ -0,0 +1,379 @@
+{
+  "version": "6",
+  "dialect": "sqlite",
+  "id": "6b3a33b8-8d7c-456a-98ce-725ef426babe",
+  "prevId": "83aff8bf-5357-4a7d-a572-042fd77858fb",
+  "tables": {
+    "plans": {
+      "name": "plans",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "slug": {
+          "name": "slug",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "markdown_content": {
+          "name": "markdown_content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "is_active": {
+          "name": "is_active",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "plans_slug_unique": {
+          "name": "plans_slug_unique",
+          "columns": [
+            "slug"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {},
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "sprints": {
+      "name": "sprints",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "slug": {
+          "name": "slug",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "plan_id": {
+          "name": "plan_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "name": {
+          "name": "name",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "goal": {
+          "name": "goal",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "markdown_content": {
+          "name": "markdown_content",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "order": {
+          "name": "order",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "start_date": {
+          "name": "start_date",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "end_date": {
+          "name": "end_date",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {
+        "sprints_plan_id_slug_unique": {
+          "name": "sprints_plan_id_slug_unique",
+          "columns": [
+            "plan_id",
+            "slug"
+          ],
+          "isUnique": true
+        }
+      },
+      "foreignKeys": {
+        "sprints_plan_id_plans_id_fk": {
+          "name": "sprints_plan_id_plans_id_fk",
+          "tableFrom": "sprints",
+          "tableTo": "plans",
+          "columnsFrom": [
+            "plan_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "task_dependencies": {
+      "name": "task_dependencies",
+      "columns": {
+        "task_id": {
+          "name": "task_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "depends_on_task_id": {
+          "name": "depends_on_task_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "task_dependencies_task_id_tasks_id_fk": {
+          "name": "task_dependencies_task_id_tasks_id_fk",
+          "tableFrom": "task_dependencies",
+          "tableTo": "tasks",
+          "columnsFrom": [
+            "task_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        },
+        "task_dependencies_depends_on_task_id_tasks_id_fk": {
+          "name": "task_dependencies_depends_on_task_id_tasks_id_fk",
+          "tableFrom": "task_dependencies",
+          "tableTo": "tasks",
+          "columnsFrom": [
+            "depends_on_task_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {
+        "task_dependencies_task_id_depends_on_task_id_pk": {
+          "columns": [
+            "task_id",
+            "depends_on_task_id"
+          ],
+          "name": "task_dependencies_task_id_depends_on_task_id_pk"
+        }
+      },
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    },
+    "tasks": {
+      "name": "tasks",
+      "columns": {
+        "id": {
+          "name": "id",
+          "type": "text",
+          "primaryKey": true,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "sprint_id": {
+          "name": "sprint_id",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "title": {
+          "name": "title",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "description": {
+          "name": "description",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "status": {
+          "name": "status",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "priority": {
+          "name": "priority",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "order": {
+          "name": "order",
+          "type": "integer",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false,
+          "default": 0
+        },
+        "assignee": {
+          "name": "assignee",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "tags": {
+          "name": "tags",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": false,
+          "autoincrement": false
+        },
+        "created_at": {
+          "name": "created_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        },
+        "updated_at": {
+          "name": "updated_at",
+          "type": "text",
+          "primaryKey": false,
+          "notNull": true,
+          "autoincrement": false
+        }
+      },
+      "indexes": {},
+      "foreignKeys": {
+        "tasks_sprint_id_sprints_id_fk": {
+          "name": "tasks_sprint_id_sprints_id_fk",
+          "tableFrom": "tasks",
+          "tableTo": "sprints",
+          "columnsFrom": [
+            "sprint_id"
+          ],
+          "columnsTo": [
+            "id"
+          ],
+          "onDelete": "cascade",
+          "onUpdate": "no action"
+        }
+      },
+      "compositePrimaryKeys": {},
+      "uniqueConstraints": {},
+      "checkConstraints": {}
+    }
+  },
+  "views": {},
+  "enums": {},
+  "_meta": {
+    "schemas": {},
+    "tables": {},
+    "columns": {}
+  },
+  "internal": {
+    "indexes": {}
+  }
+}

package/drizzle/meta/_journal.json

@@ -0,0 +1,27 @@
+{
+  "version": "7",
+  "dialect": "sqlite",
+  "entries": [
+    {
+      "idx": 0,
+      "version": "6",
+      "when": 1774083318369,
+      "tag": "0000_fresh_roxanne_simpson",
+      "breakpoints": true
+    },
+    {
+      "idx": 1,
+      "version": "6",
+      "when": 1774179892580,
+      "tag": "0001_sprint_markdown_content",
+      "breakpoints": true
+    },
+    {
+      "idx": 2,
+      "version": "6",
+      "when": 1775200000000,
+      "tag": "0002_task_touched_files",
+      "breakpoints": true
+    }
+  ]
+}

package/drizzle.config.ts

@@ -0,0 +1,14 @@
+/**
+ * package: @sprintdock/backend
+ * author: vikash sharma
+ * description: Drizzle Kit configuration for SQLite schema and migrations.
+ */
+import { defineConfig, type Config } from "drizzle-kit";
+
+const config: Config = defineConfig({
+  dialect: "sqlite",
+  schema: "./src/db/schema/index.ts",
+  out: "./drizzle"
+});
+
+export default config;

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@sprintdock/backend",
+  "version": "0.4.2",
+  "private": false,
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^12.8.0",
+    "drizzle-orm": "^0.38.4",
+    "express": "^5.1.0",
+    "zod": "^4.1.11",
+    "@sprintdock/env-manager": "0.2.2",
+    "@sprintdock/shared": "0.2.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "^5.0.6",
+    "@types/sql.js": "^1.4.10",
+    "@types/supertest": "^7.2.0",
+    "drizzle-kit": "^0.30.5",
+    "sql.js": "^1.12.0",
+    "supertest": "^7.2.2",
+    "tsx": "^4.21.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --dts --format esm --clean",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --import tsx --test tests/**/*.test.ts",
+    "db:generate": "drizzle-kit generate",
+    "clean": "rimraf dist"
+  }
+}

package/src/application/container.ts

@@ -0,0 +1,44 @@
+/**
+ * package: @sprintdock/backend
+ * author: vikash sharma
+ * description: Factory wiring application services and domain services for a repository set.
+ */
+import type { RepositorySet } from "../infrastructure/repositories/repository-factory.js";
+import { PlanDomainService } from "../domain/services/plan-domain.service.js";
+import { SprintDomainService } from "../domain/services/sprint-domain.service.js";
+import { TaskDomainService } from "../domain/services/task-domain.service.js";
+import { PlanService } from "./plan.service.js";
+import { SprintService } from "./sprint.service.js";
+import { TaskService } from "./task.service.js";
+
+/** Application-layer services exposed to protocol adapters. */
+export interface ServiceSet {
+  planService: PlanService;
+  sprintService: SprintService;
+  taskService: TaskService;
+}
+
+/**
+ * Builds domain services and wires application services for the given repositories.
+ */
+export function createApplicationServices(repos: RepositorySet): ServiceSet {
+  const planDomain = new PlanDomainService();
+  const sprintDomain = new SprintDomainService();
+  const taskDomain = new TaskDomainService();
+
+  const planService = new PlanService(repos.plans, planDomain);
+  const sprintService = new SprintService(
+    repos.sprints,
+    repos.plans,
+    planService,
+    sprintDomain
+  );
+  const taskService = new TaskService(
+    repos.tasks,
+    repos.sprints,
+    planService,
+    taskDomain
+  );
+
+  return { planService, sprintService, taskService };
+}

package/src/application/dto/plan-sprint-analytics.dto.ts

@@ -0,0 +1,30 @@
+/**
+ * package: @sprintdock/backend
+ * author: vikash sharma
+ * description: API payload for per-sprint task status analytics within a plan.
+ */
+import type { Sprint } from "../../domain/entities/sprint.entity";
+
+/** Counts keyed by task status for JSON responses. */
+export interface TaskStatusCountsDto {
+  todo: number;
+  in_progress: number;
+  blocked: number;
+  done: number;
+}
+
+export interface SprintTaskAnalyticsDto {
+  sprint: Sprint;
+  tasksByStatus: TaskStatusCountsDto;
+  totalTasks: number;
+}
+
+export interface PlanSprintTaskAnalyticsDto {
+  planId: string;
+  sprints: SprintTaskAnalyticsDto[];
+  rollup: {
+    tasksByStatus: TaskStatusCountsDto;
+    totalTasks: number;
+    sprintCount: number;
+  };
+}

package/src/application/plan.service.ts

@@ -0,0 +1,123 @@
+/**
+ * package: @sprintdock/backend
+ * author: vikash sharma
+ * description: Application service orchestrating plan operations and resolution.
+ */
+import { NotFoundError } from "../errors/backend-errors.js";
+import type {
+  CreatePlanInput,
+  Plan,
+  UpdatePlanInput
+} from "../domain/entities/plan.entity";
+import type { PlanRepository } from "../domain/repositories/plan.repository";
+import type { PlanDomainService } from "../domain/services/plan-domain.service";
+
+/**
+ * Coordinates plan persistence with domain transition rules.
+ */
+export class PlanService {
+  public constructor(
+    private readonly planRepo: PlanRepository,
+    private readonly planDomain: PlanDomainService
+  ) {}
+
+  /** @returns All plans in creation order. */
+  public async listPlans(): Promise<Plan[]> {
+    return this.planRepo.list();
+  }
+
+  /**
+   * Creates a plan and activates it when it is the only plan in storage.
+   */
+  public async createPlan(input: CreatePlanInput): Promise<Plan> {
+    const beforeCount = (await this.planRepo.list()).length;
+    const plan = await this.planRepo.create(input);
+    if (beforeCount === 0) {
+      await this.planRepo.setActive(plan.id);
+      const refreshed = await this.planRepo.findById(plan.id);
+      if (!refreshed) {
+        throw new NotFoundError("Plan", plan.id);
+      }
+      return refreshed;
+    }
+    return plan;
+  }
+
+  /**
+   * Loads a plan by id, then by slug.
+   *
+   * @throws NotFoundError when neither matches.
+   */
+  public async getPlan(idOrSlug: string): Promise<Plan> {
+    const byId = await this.planRepo.findById(idOrSlug);
+    if (byId) {
+      return byId;
+    }
+    const bySlug = await this.planRepo.findBySlug(idOrSlug);
+    if (bySlug) {
+      return bySlug;
+    }
+    throw new NotFoundError("Plan", idOrSlug);
+  }
+
+  /**
+   * @throws NotFoundError when no plan is marked active.
+   */
+  public async getActivePlan(): Promise<Plan> {
+    const active = await this.planRepo.findActive();
+    if (!active) {
+      throw new NotFoundError("Active plan", "none");
+    }
+    return active;
+  }
+
+  /**
+   * Marks the resolved plan as the sole active plan.
+   */
+  public async setActivePlan(idOrSlug: string): Promise<void> {
+    const plan = await this.getPlan(idOrSlug);
+    await this.planRepo.setActive(plan.id);
+  }
+
+  /**
+   * Updates fields; validates plan status transitions through the domain service.
+   */
+  public async updatePlan(
+    idOrSlug: string,
+    input: UpdatePlanInput
+  ): Promise<Plan> {
+    const existing = await this.getPlan(idOrSlug);
+    if (input.status !== undefined && input.status !== existing.status) {
+      this.planDomain.validateTransition(existing.status, input.status);
+    }
+    const updated = await this.planRepo.update(existing.id, input);
+    if (!updated) {
+      throw new NotFoundError("Plan", existing.id);
+    }
+    return updated;
+  }
+
+  /**
+   * Deletes a plan by id.
+   *
+   * @throws NotFoundError when the plan does not exist.
+   */
+  public async deletePlan(id: string): Promise<void> {
+    const deleted = await this.planRepo.delete(id);
+    if (!deleted) {
+      throw new NotFoundError("Plan", id);
+    }
+  }
+
+  /**
+   * Resolves the current plan from an optional id or slug, otherwise the active plan.
+   *
+   * @throws NotFoundError when lookup fails or no active plan exists.
+   */
+  public async resolvePlan(idOrSlug?: string): Promise<Plan> {
+    if (idOrSlug === undefined || idOrSlug === "") {
+      return this.getActivePlan();
+    }
+    return this.getPlan(idOrSlug);
+  }
+}