@allpepper/task-orchestrator 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# task-orchestrator-bun
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.8. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@allpepper/task-orchestrator",
+  "version": "0.1.0",
+  "description": "MCP server for hierarchical task orchestration with SQLite persistence",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "task-orchestrator": "src/server.ts"
+  },
+  "files": [
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/__tests__"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alioshr/task-orchestrator.git"
+  },
+  "keywords": ["mcp", "task-orchestrator", "claude", "ai", "bun", "sqlite"],
+  "author": "alioshr",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/alioshr/task-orchestrator/issues"
+  },
+  "homepage": "https://github.com/alioshr/task-orchestrator#readme",
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "scripts": {
+    "start": "bun run src/server.ts",
+    "dev": "bun --watch run src/server.ts",
+    "test": "bun test",
+    "prepublishOnly": "bun test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "semantic-release": "^24.0.0",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}

package/src/db/client.ts

@@ -0,0 +1,34 @@
+import { Database } from 'bun:sqlite';
+import { mkdirSync } from 'fs';
+import { dirname } from 'path';
+
+const DB_PATH = process.env.DATABASE_PATH || 'data/tasks.db';
+
+// Ensure directory exists
+mkdirSync(dirname(DB_PATH), { recursive: true });
+
+export const db = new Database(DB_PATH);
+
+// Set pragmas for performance and correctness
+db.run('PRAGMA journal_mode = WAL');
+db.run('PRAGMA busy_timeout = 5000');
+db.run('PRAGMA foreign_keys = ON');
+db.run('PRAGMA synchronous = NORMAL');
+
+// Transaction helper
+export function transaction<T>(fn: () => T): T {
+  return db.transaction(fn)();
+}
+
+// UUID helper - generates a random UUID v4 as hex string (no dashes)
+export function generateId(): string {
+  const bytes = crypto.getRandomValues(new Uint8Array(16));
+  bytes[6] = (bytes[6]! & 0x0f) | 0x40;
+  bytes[8] = (bytes[8]! & 0x3f) | 0x80;
+  return Array.from(bytes).map(b => b.toString(16).padStart(2, '0')).join('');
+}
+
+// Timestamp helper
+export function now(): string {
+  return new Date().toISOString();
+}

package/src/db/index.ts

@@ -0,0 +1 @@
+export {};

package/src/db/migrate.ts

@@ -0,0 +1,51 @@
+import { db } from './client';
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+
+// Create migrations tracking table
+db.run(`
+  CREATE TABLE IF NOT EXISTS _migrations (
+    version INTEGER PRIMARY KEY,
+    name TEXT NOT NULL,
+    applied_at TEXT NOT NULL
+  )
+`);
+
+interface Migration {
+  version: number;
+  name: string;
+  sql: string;
+}
+
+function loadMigrations(): Migration[] {
+  const migrationsDir = join(dirname(import.meta.path), 'migrations');
+  const files = ['001_initial_schema.sql'];
+
+  return files.map((file, i) => ({
+    version: i + 1,
+    name: file,
+    sql: readFileSync(join(migrationsDir, file), 'utf-8')
+  }));
+}
+
+export function runMigrations(): void {
+  const migrations = loadMigrations();
+  const applied = new Set(
+    db.query<{ version: number }, []>('SELECT version FROM _migrations')
+      .all()
+      .map(r => r.version)
+  );
+
+  for (const migration of migrations) {
+    if (applied.has(migration.version)) continue;
+
+    console.log(`Applying migration ${migration.version}: ${migration.name}`);
+    db.transaction(() => {
+      db.run(migration.sql);
+      db.run(
+        'INSERT INTO _migrations (version, name, applied_at) VALUES (?, ?, ?)',
+        [migration.version, migration.name, new Date().toISOString()]
+      );
+    })();
+  }
+}

package/src/db/migrations/001_initial_schema.sql

@@ -0,0 +1,160 @@
+-- Consolidated v2.0 schema for Task Orchestrator Bun.js port
+-- Combines Kotlin V1-V7 migrations, strips locking tables
+
+CREATE TABLE IF NOT EXISTS projects (
+    id TEXT PRIMARY KEY,
+    name VARCHAR(255) NOT NULL,
+    summary TEXT NOT NULL,
+    description TEXT,
+    status VARCHAR(20) NOT NULL CHECK (status IN ('PLANNING', 'IN_DEVELOPMENT', 'ON_HOLD', 'CANCELLED', 'COMPLETED', 'ARCHIVED')),
+    version INTEGER NOT NULL DEFAULT 1,
+    created_at TEXT NOT NULL,
+    modified_at TEXT NOT NULL,
+    search_vector TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);
+CREATE INDEX IF NOT EXISTS idx_projects_created_at ON projects(created_at);
+CREATE INDEX IF NOT EXISTS idx_projects_modified_at ON projects(modified_at);
+CREATE INDEX IF NOT EXISTS idx_projects_version ON projects(version);
+CREATE INDEX IF NOT EXISTS idx_projects_search_vector ON projects(search_vector);
+
+CREATE TABLE IF NOT EXISTS templates (
+    id TEXT PRIMARY KEY,
+    name VARCHAR(200) NOT NULL UNIQUE,
+    description TEXT NOT NULL,
+    target_entity_type VARCHAR(50) NOT NULL,
+    is_built_in INTEGER NOT NULL DEFAULT 0,
+    is_protected INTEGER NOT NULL DEFAULT 0,
+    is_enabled INTEGER NOT NULL DEFAULT 1,
+    created_by VARCHAR(200),
+    tags TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    modified_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_templates_target_entity_type ON templates(target_entity_type);
+CREATE INDEX IF NOT EXISTS idx_templates_is_built_in ON templates(is_built_in);
+CREATE INDEX IF NOT EXISTS idx_templates_is_enabled ON templates(is_enabled);
+
+CREATE TABLE IF NOT EXISTS features (
+    id TEXT PRIMARY KEY,
+    project_id TEXT,
+    name TEXT NOT NULL,
+    summary TEXT NOT NULL,
+    description TEXT,
+    status VARCHAR(20) NOT NULL CHECK (status IN ('DRAFT', 'PLANNING', 'IN_DEVELOPMENT', 'TESTING', 'VALIDATING', 'PENDING_REVIEW', 'BLOCKED', 'ON_HOLD', 'DEPLOYED', 'COMPLETED', 'ARCHIVED')),
+    priority VARCHAR(10) NOT NULL CHECK (priority IN ('HIGH', 'MEDIUM', 'LOW')),
+    version INTEGER NOT NULL DEFAULT 1,
+    created_at TEXT NOT NULL,
+    modified_at TEXT NOT NULL,
+    search_vector TEXT,
+    FOREIGN KEY (project_id) REFERENCES projects(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_features_project_id ON features(project_id);
+CREATE INDEX IF NOT EXISTS idx_features_status ON features(status);
+CREATE INDEX IF NOT EXISTS idx_features_priority ON features(priority);
+CREATE INDEX IF NOT EXISTS idx_features_created_at ON features(created_at);
+CREATE INDEX IF NOT EXISTS idx_features_modified_at ON features(modified_at);
+CREATE INDEX IF NOT EXISTS idx_features_version ON features(version);
+CREATE INDEX IF NOT EXISTS idx_features_search_vector ON features(search_vector);
+CREATE INDEX IF NOT EXISTS idx_features_status_priority ON features(status, priority);
+CREATE INDEX IF NOT EXISTS idx_features_project_status ON features(project_id, status);
+
+CREATE TABLE IF NOT EXISTS entity_tags (
+    id TEXT PRIMARY KEY,
+    entity_id TEXT NOT NULL,
+    entity_type VARCHAR(20) NOT NULL,
+    tag VARCHAR(100) NOT NULL,
+    created_at TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_entity_tags_unique ON entity_tags(entity_id, entity_type, tag);
+CREATE INDEX IF NOT EXISTS idx_entity_tags_tag ON entity_tags(tag);
+CREATE INDEX IF NOT EXISTS idx_entity_tags_entity ON entity_tags(entity_id, entity_type);
+
+CREATE TABLE IF NOT EXISTS sections (
+    id TEXT PRIMARY KEY,
+    entity_type VARCHAR(50) NOT NULL,
+    entity_id TEXT NOT NULL,
+    title VARCHAR(200) NOT NULL,
+    usage_description TEXT NOT NULL,
+    content TEXT NOT NULL,
+    content_format VARCHAR(50) NOT NULL,
+    ordinal INTEGER NOT NULL,
+    tags TEXT NOT NULL,
+    version INTEGER NOT NULL DEFAULT 1,
+    created_at TEXT NOT NULL,
+    modified_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_sections_entity ON sections(entity_type, entity_id);
+CREATE INDEX IF NOT EXISTS idx_sections_entity_id ON sections(entity_id);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_sections_entity_ordinal ON sections(entity_type, entity_id, ordinal);
+
+CREATE TABLE IF NOT EXISTS template_sections (
+    id TEXT PRIMARY KEY,
+    template_id TEXT NOT NULL,
+    title VARCHAR(200) NOT NULL,
+    usage_description TEXT NOT NULL,
+    content_sample TEXT NOT NULL,
+    content_format VARCHAR(50) NOT NULL,
+    ordinal INTEGER NOT NULL,
+    is_required INTEGER NOT NULL DEFAULT 0,
+    tags TEXT NOT NULL,
+    FOREIGN KEY (template_id) REFERENCES templates(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_template_sections_template_id ON template_sections(template_id);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_template_sections_template_ordinal ON template_sections(template_id, ordinal);
+
+CREATE TABLE IF NOT EXISTS tasks (
+    id TEXT PRIMARY KEY,
+    project_id TEXT,
+    feature_id TEXT,
+    title TEXT NOT NULL,
+    summary TEXT NOT NULL,
+    description TEXT,
+    status VARCHAR(20) NOT NULL CHECK (status IN ('BACKLOG', 'PENDING', 'IN_PROGRESS', 'IN_REVIEW', 'CHANGES_REQUESTED', 'TESTING', 'READY_FOR_QA', 'INVESTIGATING', 'BLOCKED', 'ON_HOLD', 'DEPLOYED', 'COMPLETED', 'CANCELLED', 'DEFERRED')),
+    priority VARCHAR(20) NOT NULL CHECK (priority IN ('HIGH', 'MEDIUM', 'LOW')),
+    complexity INTEGER NOT NULL,
+    version INTEGER NOT NULL DEFAULT 1,
+    last_modified_by TEXT,
+    lock_status VARCHAR(20) NOT NULL DEFAULT 'UNLOCKED' CHECK (lock_status IN ('UNLOCKED', 'LOCKED_EXCLUSIVE', 'LOCKED_SHARED', 'LOCKED_SECTION')),
+    created_at TEXT NOT NULL,
+    modified_at TEXT NOT NULL,
+    search_vector TEXT,
+    FOREIGN KEY (project_id) REFERENCES projects(id),
+    FOREIGN KEY (feature_id) REFERENCES features(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_tasks_project_id ON tasks(project_id);
+CREATE INDEX IF NOT EXISTS idx_tasks_feature_id ON tasks(feature_id);
+CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
+CREATE INDEX IF NOT EXISTS idx_tasks_priority ON tasks(priority);
+CREATE INDEX IF NOT EXISTS idx_tasks_version ON tasks(version);
+CREATE INDEX IF NOT EXISTS idx_tasks_lock_status ON tasks(lock_status);
+CREATE INDEX IF NOT EXISTS idx_tasks_last_modified_by ON tasks(last_modified_by);
+CREATE INDEX IF NOT EXISTS idx_tasks_search_vector ON tasks(search_vector);
+CREATE INDEX IF NOT EXISTS idx_tasks_status_priority ON tasks(status, priority);
+CREATE INDEX IF NOT EXISTS idx_tasks_feature_status ON tasks(feature_id, status);
+CREATE INDEX IF NOT EXISTS idx_tasks_project_status ON tasks(project_id, status);
+CREATE INDEX IF NOT EXISTS idx_tasks_priority_created ON tasks(priority DESC, created_at ASC);
+CREATE INDEX IF NOT EXISTS idx_tasks_project_feature ON tasks(project_id, feature_id);
+CREATE INDEX IF NOT EXISTS idx_tasks_status_priority_complexity ON tasks(status, priority, complexity);
+CREATE INDEX IF NOT EXISTS idx_tasks_feature_status_priority ON tasks(feature_id, status, priority);
+
+CREATE TABLE IF NOT EXISTS dependencies (
+    id TEXT PRIMARY KEY,
+    from_task_id TEXT NOT NULL,
+    to_task_id TEXT NOT NULL,
+    type VARCHAR(20) NOT NULL CHECK (type IN ('BLOCKS', 'IS_BLOCKED_BY', 'RELATES_TO')),
+    created_at TEXT NOT NULL,
+    FOREIGN KEY (from_task_id) REFERENCES tasks(id),
+    FOREIGN KEY (to_task_id) REFERENCES tasks(id)
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_dependencies_unique ON dependencies(from_task_id, to_task_id, type);
+CREATE INDEX IF NOT EXISTS idx_dependencies_from_task_id ON dependencies(from_task_id);
+CREATE INDEX IF NOT EXISTS idx_dependencies_to_task_id ON dependencies(to_task_id);

package/src/domain/index.ts

@@ -0,0 +1 @@
+export {};

package/src/domain/types.ts

@@ -0,0 +1,225 @@
+/**
+ * Domain Types for Task Orchestrator v2.0
+ *
+ * All TypeScript interfaces and enums for the domain model.
+ * Based on the v2.0 schema specification.
+ */
+
+// ============================================================================
+// Enums
+// ============================================================================
+
+export enum ProjectStatus {
+  PLANNING = 'PLANNING',
+  IN_DEVELOPMENT = 'IN_DEVELOPMENT',
+  ON_HOLD = 'ON_HOLD',
+  CANCELLED = 'CANCELLED',
+  COMPLETED = 'COMPLETED',
+  ARCHIVED = 'ARCHIVED'
+}
+
+export enum FeatureStatus {
+  DRAFT = 'DRAFT',
+  PLANNING = 'PLANNING',
+  IN_DEVELOPMENT = 'IN_DEVELOPMENT',
+  TESTING = 'TESTING',
+  VALIDATING = 'VALIDATING',
+  PENDING_REVIEW = 'PENDING_REVIEW',
+  BLOCKED = 'BLOCKED',
+  ON_HOLD = 'ON_HOLD',
+  DEPLOYED = 'DEPLOYED',
+  COMPLETED = 'COMPLETED',
+  ARCHIVED = 'ARCHIVED'
+}
+
+export enum TaskStatus {
+  BACKLOG = 'BACKLOG',
+  PENDING = 'PENDING',
+  IN_PROGRESS = 'IN_PROGRESS',
+  IN_REVIEW = 'IN_REVIEW',
+  CHANGES_REQUESTED = 'CHANGES_REQUESTED',
+  TESTING = 'TESTING',
+  READY_FOR_QA = 'READY_FOR_QA',
+  INVESTIGATING = 'INVESTIGATING',
+  BLOCKED = 'BLOCKED',
+  ON_HOLD = 'ON_HOLD',
+  DEPLOYED = 'DEPLOYED',
+  COMPLETED = 'COMPLETED',
+  CANCELLED = 'CANCELLED',
+  DEFERRED = 'DEFERRED'
+}
+
+export enum Priority {
+  HIGH = 'HIGH',
+  MEDIUM = 'MEDIUM',
+  LOW = 'LOW'
+}
+
+export enum ContentFormat {
+  PLAIN_TEXT = 'PLAIN_TEXT',
+  MARKDOWN = 'MARKDOWN',
+  JSON = 'JSON',
+  CODE = 'CODE'
+}
+
+export enum EntityType {
+  PROJECT = 'PROJECT',
+  FEATURE = 'FEATURE',
+  TASK = 'TASK',
+  TEMPLATE = 'TEMPLATE',
+  SECTION = 'SECTION'
+}
+
+export enum DependencyType {
+  BLOCKS = 'BLOCKS',
+  IS_BLOCKED_BY = 'IS_BLOCKED_BY',
+  RELATES_TO = 'RELATES_TO'
+}
+
+export enum LockStatus {
+  UNLOCKED = 'UNLOCKED',
+  LOCKED_EXCLUSIVE = 'LOCKED_EXCLUSIVE',
+  LOCKED_SHARED = 'LOCKED_SHARED',
+  LOCKED_SECTION = 'LOCKED_SECTION'
+}
+
+// ============================================================================
+// Interfaces
+// ============================================================================
+
+export interface Project {
+  id: string;
+  name: string;
+  summary: string;
+  description?: string;
+  status: ProjectStatus;
+  version: number;
+  createdAt: Date;
+  modifiedAt: Date;
+  searchVector?: string;
+  tags?: string[];
+}
+
+export interface Feature {
+  id: string;
+  projectId?: string;
+  name: string;
+  summary: string;
+  description?: string;
+  status: FeatureStatus;
+  priority: Priority;
+  version: number;
+  createdAt: Date;
+  modifiedAt: Date;
+  searchVector?: string;
+  tags?: string[];
+}
+
+export interface Task {
+  id: string;
+  projectId?: string;
+  featureId?: string;
+  title: string;
+  summary: string;
+  description?: string;
+  status: TaskStatus;
+  priority: Priority;
+  complexity: number;
+  version: number;
+  lastModifiedBy?: string;
+  lockStatus: LockStatus;
+  createdAt: Date;
+  modifiedAt: Date;
+  searchVector?: string;
+  tags?: string[];
+}
+
+export interface Section {
+  id: string;
+  entityType: EntityType;
+  entityId: string;
+  title: string;
+  usageDescription: string;
+  content: string;
+  contentFormat: ContentFormat;
+  ordinal: number;
+  tags: string;
+  version: number;
+  createdAt: Date;
+  modifiedAt: Date;
+}
+
+export interface Template {
+  id: string;
+  name: string;
+  description: string;
+  targetEntityType: EntityType;
+  isBuiltIn: boolean;
+  isProtected: boolean;
+  isEnabled: boolean;
+  createdBy?: string;
+  tags: string;
+  createdAt: Date;
+  modifiedAt: Date;
+}
+
+export interface TemplateSection {
+  id: string;
+  templateId: string;
+  title: string;
+  usageDescription: string;
+  contentSample: string;
+  contentFormat: ContentFormat;
+  ordinal: number;
+  isRequired: boolean;
+  tags: string;
+}
+
+export interface Dependency {
+  id: string;
+  fromTaskId: string;
+  toTaskId: string;
+  type: DependencyType;
+  createdAt: Date;
+}
+
+export interface EntityTag {
+  id: string;
+  entityId: string;
+  entityType: EntityType;
+  tag: string;
+  createdAt: Date;
+}
+
+// ============================================================================
+// Result Type
+// ============================================================================
+
+export type Result<T> =
+  | { success: true; data: T }
+  | { success: false; error: string; code?: string };
+
+// ============================================================================
+// Error Types
+// ============================================================================
+
+export class NotFoundError extends Error {
+  constructor(entity: string, id: string) {
+    super(`${entity} not found: ${id}`);
+    this.name = 'NotFoundError';
+  }
+}
+
+export class ValidationError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'ValidationError';
+  }
+}
+
+export class ConflictError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = 'ConflictError';
+  }
+}

package/src/index.ts

@@ -0,0 +1,7 @@
+// Re-export everything for library consumers
+export * from './domain';
+export * from './repos';
+export * from './services/workflow';
+export * from './services/status-validator';
+export { db } from './db/client';
+export { runMigrations } from './db/migrate';