@umudik/task-bridge 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 umudik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# task-bridge
+
+Epic ve task yönetimi için tek backend, web paneli ve Android uygulaması.
+
+Projeler workflow stage’leri üzerinden ilerler; mobil veya web’den task açılır, yorumlar inbox’a düşer, worker kuyruğu otomasyon/agent tarafından tüketilir.
+
+## Repo
+
+| Dizin | Ne |
+|-------|-----|
+| `apps/backend` | Fastify API, SQLite, worker queue |
+| `apps/web` | React dashboard (Vite) |
+| `apps/mobile` | Android (Kotlin + Compose) |
+| `apps/mcp` | MCP server for AI agents |
+
+## Geliştirme
+
+```powershell
+copy .env.example .env
+npm install
+npm run dev
+```
+
+| Servis | URL |
+|--------|-----|
+| Web UI | http://localhost:5173/app/login |
+| API | http://localhost:3000 |
+
+İlk kurulumda web’den `/setup` ile admin oluştur, sonra `/app/login`.
+
+## npx ile çalıştır
+
+Build edilmiş API + web tek paket olarak npm'de (`@umudik/task-bridge`):
+
+```bash
+npx @umudik/task-bridge
+```
+
+| Opsiyon | Açıklama |
+|---------|----------|
+| `-p, --port <port>` | Dinlenecek port (varsayılan 3000 / `$PORT`) |
+| `-d, --data <dir>` | SQLite veritabanı dizini (varsayılan `./task-bridge-data`) |
+
+```bash
+npx @umudik/task-bridge --port 8080 --data ./tb-data
+```
+
+Aç: **http://localhost:3000/app/login** — ilk açılışta `/app/setup` ile admin oluştur. Veritabanı çalıştırdığın klasörde `task-bridge-data/bridge.db` olarak kalır.
+
+## API (agent / otomasyon)
+
+OpenAPI 3.1 spec backend’de yaşar ve çalışan sunucudan JSON olarak okunur:
+
+```
+GET /api/docs
+```
+
+Kaynak: `apps/backend/src/openapi.ts`
+
+## MCP (AI agents)
+
+Cursor / Claude Desktop → [apps/mcp/README.md](apps/mcp/README.md)
+
+Stdio MCP server; Task Bridge API’yi tool olarak sunar. `.cursor/mcp.json` örneği repoda.
+
+## Deploy & mobil
+
+Sunucu (API + web) → `npx @umudik/task-bridge` (yukarıdaki npx bölümü)
+
+Web UI detayları → [apps/web/README.md](apps/web/README.md)
+
+Android → [apps/mobile/README.md](apps/mobile/README.md)
+
+## License
+MIT

package/apps/backend/dist/config.js

@@ -0,0 +1,26 @@
+function getEnv(key) {
+    const keys = Object.keys(process.env);
+    for (let i = 0; i < keys.length; i += 1) {
+        const envKey = keys[i];
+        if (envKey !== key) {
+            continue;
+        }
+        const value = process.env[envKey];
+        if (value === null) {
+            return null;
+        }
+        return value;
+    }
+    return null;
+}
+let configPort = 3000;
+if ("PORT" in process.env) {
+    const rawPort = process.env["PORT"];
+    if (rawPort !== null) {
+        configPort = Number(rawPort);
+    }
+}
+export const config = {
+    port: configPort,
+    databasePath: getEnv("DATABASE_PATH") || getEnv("BRIDGE_DB_PATH") || "",
+};

package/apps/backend/dist/db/epic-workflow-db.js

@@ -0,0 +1,125 @@
+import { getProjectsDb } from "./projects-db.js";
+import { parseWorkflowStateData, serializeWorkflowStateData, } from "../domain/workflow-state.js";
+export function migrateEpicWorkflowTables() {
+    const db = getProjectsDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS epics (
+      id INTEGER PRIMARY KEY,
+      project_id TEXT NOT NULL,
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      stage_id TEXT,
+      created_by TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_epics_project_id ON epics(project_id);
+
+    CREATE TABLE IF NOT EXISTS workflow_state (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      epic_id INTEGER NOT NULL UNIQUE,
+      state_json TEXT NOT NULL DEFAULT '{}',
+      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+      FOREIGN KEY (epic_id) REFERENCES epics(id)
+    );
+  `);
+}
+export function listEpicRows(filter) {
+    migrateEpicWorkflowTables();
+    const db = getProjectsDb();
+    const id = filter.id;
+    const projectId = filter.projectId;
+    if (id > 0) {
+        return db.prepare("SELECT * FROM epics WHERE id = ?").all(id);
+    }
+    if (projectId !== "") {
+        return db
+            .prepare("SELECT * FROM epics WHERE project_id = ? ORDER BY updated_at DESC")
+            .all(projectId);
+    }
+    return db.prepare("SELECT * FROM epics ORDER BY updated_at DESC").all();
+}
+export function insertEpicRow(input) {
+    migrateEpicWorkflowTables();
+    const db = getProjectsDb();
+    const now = new Date().toISOString();
+    db.prepare(`INSERT INTO epics (id, project_id, title, description, stage_id, created_by, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(input.id, input.projectId, input.title, input.description, input.stageId, input.createdBy || "system", now, now);
+    const rows = listEpicRows({ id: input.id, projectId: "" });
+    const row = rows[0];
+    if (!row)
+        throw new Error("Failed to insert epic");
+    return row;
+}
+export function updateEpicStageRow(epicId, stageId) {
+    migrateEpicWorkflowTables();
+    getProjectsDb()
+        .prepare(`UPDATE epics SET stage_id = ?, updated_at = datetime('now') WHERE id = ?`)
+        .run(stageId, epicId);
+}
+export function updateEpicSpecRow(epicId, input) {
+    migrateEpicWorkflowTables();
+    const rows = listEpicRows({ id: epicId, projectId: "" });
+    if (rows.length === 0)
+        return;
+    const row = rows[0];
+    if (!row)
+        return;
+    let title = row.title;
+    if (input.title !== null)
+        title = input.title;
+    let description = row.description;
+    if (input.description !== null)
+        description = input.description;
+    getProjectsDb()
+        .prepare(`UPDATE epics SET title = ?, description = ?, updated_at = datetime('now') WHERE id = ?`)
+        .run(title, description, epicId);
+}
+export function listWorkflowStateRows(filter) {
+    migrateEpicWorkflowTables();
+    const db = getProjectsDb();
+    if (filter.epicId > 0) {
+        return db
+            .prepare("SELECT * FROM workflow_state WHERE epic_id = ?")
+            .all(filter.epicId);
+    }
+    return db.prepare("SELECT * FROM workflow_state ORDER BY epic_id ASC").all();
+}
+export function getEpicWorkflowStateData(epicId) {
+    const rows = listWorkflowStateRows({ epicId });
+    const row = rows[0];
+    if (!row)
+        return null;
+    return parseWorkflowStateData(row.state_json);
+}
+export function insertWorkflowStateRow(epicId, data) {
+    migrateEpicWorkflowTables();
+    const db = getProjectsDb();
+    const payload = serializeWorkflowStateData(data);
+    db.prepare(`INSERT INTO workflow_state (epic_id, state_json, updated_at) VALUES (?, ?, datetime('now'))`).run(epicId, payload);
+    const rows = listWorkflowStateRows({ epicId });
+    const row = rows[0];
+    if (!row)
+        throw new Error("Failed to insert workflow state");
+    return row;
+}
+export function saveEpicWorkflowStateData(epicId, data) {
+    migrateEpicWorkflowTables();
+    const payload = serializeWorkflowStateData(data);
+    const db = getProjectsDb();
+    const existing = listWorkflowStateRows({ epicId });
+    if (existing.length === 0) {
+        insertWorkflowStateRow(epicId, data);
+        return data;
+    }
+    db.prepare(`UPDATE workflow_state SET state_json = ?, updated_at = datetime('now') WHERE epic_id = ?`).run(payload, epicId);
+    return data;
+}
+export function mutateEpicWorkflowState(epicId, mutator) {
+    const data = getEpicWorkflowStateData(epicId);
+    if (!data)
+        return null;
+    mutator(data);
+    return saveEpicWorkflowStateData(epicId, data);
+}

package/apps/backend/dist/db/library-db.js

@@ -0,0 +1,123 @@
+import { getProjectsDb } from "./projects-db.js";
+function migrateLibraryTables() {
+    const db = getProjectsDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS libraries (
+      id TEXT PRIMARY KEY,
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+    CREATE TABLE IF NOT EXISTS library_documents (
+      id TEXT PRIMARY KEY,
+      library_id TEXT NOT NULL,
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+      FOREIGN KEY (library_id) REFERENCES libraries(id) ON DELETE CASCADE
+    );
+    CREATE INDEX IF NOT EXISTS idx_library_documents_library_id ON library_documents(library_id);
+    CREATE TABLE IF NOT EXISTS library_document_links (
+      document_id TEXT NOT NULL,
+      task_id INTEGER NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      PRIMARY KEY (document_id, task_id),
+      FOREIGN KEY (document_id) REFERENCES library_documents(id) ON DELETE CASCADE
+    );
+    CREATE INDEX IF NOT EXISTS idx_library_document_links_task_id ON library_document_links(task_id);
+  `);
+}
+function ensureMigrated() {
+    migrateLibraryTables();
+}
+export function listLibraryRows(filter) {
+    ensureMigrated();
+    const id = filter.id;
+    if (id !== "") {
+        return getProjectsDb()
+            .prepare(`SELECT id, title, description, updated_at FROM libraries WHERE id = ?`)
+            .all(id);
+    }
+    return getProjectsDb()
+        .prepare(`SELECT id, title, description, updated_at FROM libraries ORDER BY title COLLATE NOCASE ASC`)
+        .all();
+}
+export function insertLibraryRow(row) {
+    ensureMigrated();
+    getProjectsDb()
+        .prepare(`INSERT INTO libraries (id, title, description, updated_at) VALUES (?, ?, ?, datetime('now'))`)
+        .run(row.id, row.title, row.description);
+}
+export function updateLibraryRow(id, patch) {
+    ensureMigrated();
+    getProjectsDb()
+        .prepare(`UPDATE libraries SET title = ?, description = ?, updated_at = datetime('now') WHERE id = ?`)
+        .run(patch.title, patch.description, id);
+}
+export function deleteLibraryRow(id) {
+    ensureMigrated();
+    const db = getProjectsDb();
+    db.prepare(`DELETE FROM library_document_links WHERE document_id IN (SELECT id FROM library_documents WHERE library_id = ?)`).run(id);
+    db.prepare(`DELETE FROM library_documents WHERE library_id = ?`).run(id);
+    db.prepare(`DELETE FROM libraries WHERE id = ?`).run(id);
+}
+export function listLibraryDocumentRows(filter) {
+    ensureMigrated();
+    const documentId = filter.documentId;
+    const libraryId = filter.libraryId;
+    if (documentId !== "") {
+        return getProjectsDb()
+            .prepare(`SELECT id, library_id, title, description, updated_at FROM library_documents WHERE id = ?`)
+            .all(documentId);
+    }
+    if (libraryId !== "") {
+        return getProjectsDb()
+            .prepare(`SELECT id, library_id, title, description, updated_at FROM library_documents WHERE library_id = ? ORDER BY title COLLATE NOCASE ASC`)
+            .all(libraryId);
+    }
+    return getProjectsDb()
+        .prepare(`SELECT id, library_id, title, description, updated_at FROM library_documents ORDER BY title COLLATE NOCASE ASC`)
+        .all();
+}
+export function insertLibraryDocumentRow(row) {
+    ensureMigrated();
+    getProjectsDb()
+        .prepare(`INSERT INTO library_documents (id, library_id, title, description, updated_at) VALUES (?, ?, ?, ?, datetime('now'))`)
+        .run(row.id, row.libraryId, row.title, row.description);
+}
+export function updateLibraryDocumentRow(id, patch) {
+    ensureMigrated();
+    getProjectsDb()
+        .prepare(`UPDATE library_documents SET title = ?, description = ?, updated_at = datetime('now') WHERE id = ?`)
+        .run(patch.title, patch.description, id);
+}
+export function deleteLibraryDocumentRow(id) {
+    ensureMigrated();
+    const db = getProjectsDb();
+    db.prepare(`DELETE FROM library_document_links WHERE document_id = ?`).run(id);
+    db.prepare(`DELETE FROM library_documents WHERE id = ?`).run(id);
+}
+export function insertLibraryDocumentLink(documentId, taskId) {
+    ensureMigrated();
+    getProjectsDb()
+        .prepare(`INSERT OR IGNORE INTO library_document_links (document_id, task_id, created_at) VALUES (?, ?, datetime('now'))`)
+        .run(documentId, taskId);
+}
+export function deleteLibraryDocumentLink(documentId, taskId) {
+    ensureMigrated();
+    getProjectsDb()
+        .prepare(`DELETE FROM library_document_links WHERE document_id = ? AND task_id = ?`)
+        .run(documentId, taskId);
+}
+export function listLibraryDocumentLinkRowsForTask(taskId) {
+    ensureMigrated();
+    return getProjectsDb()
+        .prepare(`SELECT document_id, task_id, created_at FROM library_document_links WHERE task_id = ? ORDER BY created_at ASC`)
+        .all(taskId);
+}
+export function listLibraryDocumentLinkRowsForDocument(documentId) {
+    ensureMigrated();
+    return getProjectsDb()
+        .prepare(`SELECT document_id, task_id, created_at FROM library_document_links WHERE document_id = ? ORDER BY created_at ASC`)
+        .all(documentId);
+}

package/apps/backend/dist/db/projects-db.js

@@ -0,0 +1,110 @@
+import Database from "better-sqlite3";
+import { mkdirSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { config } from "../config.js";
+import { DEFAULT_WORKFLOW_TEMPLATE_ID } from "../domain/workflow-template-id.js";
+const moduleDir = dirname(fileURLToPath(import.meta.url));
+function resolveDatabasePath() {
+    if (config.databasePath)
+        return config.databasePath;
+    return join(moduleDir, "..", "..", "..", "..", "data", "bridge.db");
+}
+let db = null;
+function columnExists(database, table, column) {
+    const rows = database.prepare(`PRAGMA table_info(${table})`).all();
+    return rows.some((row) => row.name === column);
+}
+function migrate(database) {
+    database.exec(`
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      repo_path TEXT NOT NULL DEFAULT '',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS users (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      email TEXT NOT NULL UNIQUE,
+      password_hash TEXT NOT NULL,
+      role TEXT NOT NULL DEFAULT 'read-write',
+      is_system_admin INTEGER NOT NULL DEFAULT 0,
+      token TEXT NOT NULL UNIQUE,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+  `);
+    if (!columnExists(database, "projects", "description")) {
+        database.exec("ALTER TABLE projects ADD COLUMN description TEXT NOT NULL DEFAULT ''");
+    }
+    if (!columnExists(database, "projects", "workflow_template_id")) {
+        database.exec(`ALTER TABLE projects ADD COLUMN workflow_template_id TEXT NOT NULL DEFAULT '${DEFAULT_WORKFLOW_TEMPLATE_ID}'`);
+    }
+    if (!columnExists(database, "users", "must_change_password")) {
+        database.exec("ALTER TABLE users ADD COLUMN must_change_password INTEGER NOT NULL DEFAULT 0");
+    }
+    database
+        .prepare(`UPDATE projects SET workflow_template_id = ? WHERE trim(workflow_template_id) = ''`)
+        .run(DEFAULT_WORKFLOW_TEMPLATE_ID);
+}
+export function getProjectsDb() {
+    if (db)
+        return db;
+    const path = resolveDatabasePath();
+    mkdirSync(dirname(path), { recursive: true });
+    db = new Database(path);
+    db.pragma("journal_mode = WAL");
+    migrate(db);
+    return db;
+}
+export function countProjects() {
+    const row = getProjectsDb()
+        .prepare("SELECT COUNT(*) AS count FROM projects")
+        .get();
+    return row.count;
+}
+export function listProjectRows() {
+    return getProjectsDb()
+        .prepare("SELECT id, name, repo_path, description, workflow_template_id FROM projects ORDER BY name COLLATE NOCASE")
+        .all();
+}
+export function listProjectRowsById(id) {
+    if (id === "")
+        return [];
+    return getProjectsDb()
+        .prepare("SELECT id, name, repo_path, description, workflow_template_id FROM projects WHERE id = ?")
+        .all(id);
+}
+export function upsertProjectRow(id, name, repoPath) {
+    getProjectsDb()
+        .prepare(`INSERT INTO projects (id, name, repo_path, updated_at)
+       VALUES (?, ?, ?, datetime('now'))
+       ON CONFLICT(id) DO UPDATE SET
+         name = excluded.name,
+         repo_path = excluded.repo_path,
+         updated_at = datetime('now')`)
+        .run(id, name || id, repoPath);
+}
+export function insertProjectRow(id, name, repoPath, description = "", workflowTemplateId = DEFAULT_WORKFLOW_TEMPLATE_ID) {
+    try {
+        getProjectsDb()
+            .prepare(`INSERT INTO projects (id, name, repo_path, description, workflow_template_id, updated_at)
+         VALUES (?, ?, ?, ?, ?, datetime('now'))`)
+            .run(id, name || id, repoPath, description, workflowTemplateId);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function updateProjectRow(id, input) {
+    if (listProjectRowsById(id).length === 0)
+        return false;
+    const result = getProjectsDb()
+        .prepare(`UPDATE projects SET name = ?, repo_path = ?, description = ?, workflow_template_id = ?, updated_at = datetime('now') WHERE id = ?`)
+        .run(input.name, input.repoPath, input.description, input.workflowTemplateId, id);
+    return result.changes > 0;
+}