@gzmagyari/kanbanboard 1.0.0

package/db.mjs

@@ -0,0 +1,378 @@
+import Database from 'better-sqlite3';
+import { getDbPath, ensureDirectories } from './lib/paths.mjs';
+
+ensureDirectories();
+
+const dbPath = getDbPath();
+export const db = new Database(dbPath);
+
+db.pragma('journal_mode = WAL');
+db.pragma('foreign_keys = ON');
+
+// Schema versioning (SQLite PRAGMA user_version)
+export const SCHEMA_VERSION = 12;
+export const DEFAULT_PROJECT_ID = 'default';
+
+export const TASK_COLUMNS = [
+  { key: 'ideas', name: 'Ideas' },
+  { key: 'todo', name: 'To do' },
+  { key: 'in_progress', name: 'In Progress' },
+  { key: 'review', name: 'Review' },
+  { key: 'testing', name: 'Testing' },
+  { key: 'done', name: 'Done' }
+];
+
+export const AUTO_COLUMNS = [
+  { key: 'ideas', name: 'Ideas' },
+  { key: 'active', name: 'Active' }
+];
+
+export const ENTITY_TYPES = {
+  task: 'task',
+  recurring: 'recurring',
+  scheduled: 'scheduled',
+  milestone: 'milestone'
+};
+
+export function assertTaskStatus(status) {
+  if (!TASK_COLUMNS.some(c => c.key === status)) {
+    const err = new Error(`Invalid status: ${status}`);
+    err.statusCode = 400;
+    throw err;
+  }
+}
+
+export function assertAutoStatus(status) {
+  if (!AUTO_COLUMNS.some(c => c.key === status)) {
+    const err = new Error(`Invalid status: ${status}`);
+    err.statusCode = 400;
+    throw err;
+  }
+}
+
+export const MILESTONE_COLUMNS = [
+  { key: 'ideas', name: 'Ideas' },
+  { key: 'todo', name: 'To Do' },
+  { key: 'in_progress', name: 'In Progress' },
+  { key: 'done', name: 'Done' }
+];
+
+export function assertMilestoneStatus(status) {
+  if (!MILESTONE_COLUMNS.some(c => c.key === status)) {
+    const err = new Error(`Invalid milestone status: ${status}`);
+    err.statusCode = 400;
+    throw err;
+  }
+}
+
+export const AGENT_STATUSES = ['active', 'inactive'];
+
+export function assertAgentStatus(status) {
+  if (!AGENT_STATUSES.includes(status)) {
+    const err = new Error(`Invalid agent status: ${status}`);
+    err.statusCode = 400;
+    throw err;
+  }
+}
+
+function tableColumns(tableName) {
+  try {
+    return db.prepare(`PRAGMA table_info(${tableName})`).all().map(r => r.name);
+  } catch {
+    return [];
+  }
+}
+
+function hasColumn(tableName, colName) {
+  return tableColumns(tableName).includes(colName);
+}
+
+function addColumnIfMissing(tableName, colName, ddl) {
+  if (hasColumn(tableName, colName)) return;
+  db.exec(`ALTER TABLE ${tableName} ADD COLUMN ${ddl};`);
+}
+
+export function migrate() {
+  const currentVersion = db.pragma('user_version', { simple: true });
+
+  // Base tables (create with latest shape; older DBs will be ALTERed below)
+  // IMPORTANT: do not create indexes referencing new columns until after ALTER TABLE.
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS tasks (
+      id TEXT PRIMARY KEY,
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      status TEXT NOT NULL,
+      detail_text TEXT NOT NULL DEFAULT '',
+      project_id TEXT NOT NULL DEFAULT '${DEFAULT_PROJECT_ID}',
+      parent_id TEXT,
+      deleted_at INTEGER,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_tasks_status_updated ON tasks(status, updated_at);
+
+    CREATE TABLE IF NOT EXISTS automation_tasks (
+      id TEXT PRIMARY KEY,
+      type TEXT NOT NULL, -- 'recurring' | 'scheduled'
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      status TEXT NOT NULL DEFAULT 'ideas', -- 'ideas' | 'active'
+      detail_text TEXT NOT NULL DEFAULT '',
+      project_id TEXT NOT NULL DEFAULT '${DEFAULT_PROJECT_ID}',
+
+      schedule_kind TEXT NOT NULL, -- 'cron' | 'at'
+      expr TEXT,
+      tz TEXT,
+      at_iso TEXT,
+
+      cron_job_id TEXT,
+      cron_enabled INTEGER NOT NULL DEFAULT 1,
+      last_synced_at INTEGER,
+      last_sync_error TEXT,
+
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_auto_type_status_updated ON automation_tasks(type, status, updated_at);
+    CREATE INDEX IF NOT EXISTS idx_auto_status_updated ON automation_tasks(status, updated_at);
+  `);
+
+  // Detect old comments schema (task_id) and migrate before we create new indexes.
+  const commentsCols = tableColumns('comments');
+
+  const hasOld = commentsCols.includes('task_id');
+
+  if (hasOld) {
+    // Old schema existed; rename and rebuild.
+    db.exec(`ALTER TABLE comments RENAME TO comments_old;`);
+
+    const hasProgress = tableColumns('progress_updates').length > 0;
+    if (hasProgress) {
+      db.exec(`ALTER TABLE progress_updates RENAME TO progress_updates_old;`);
+    }
+
+    db.exec(`
+      CREATE TABLE comments (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_type TEXT NOT NULL DEFAULT 'task',
+        entity_id TEXT NOT NULL,
+        author TEXT NOT NULL DEFAULT 'Gabor',
+        text TEXT NOT NULL,
+        created_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE progress_updates (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        entity_type TEXT NOT NULL DEFAULT 'task',
+        entity_id TEXT NOT NULL,
+        author TEXT NOT NULL DEFAULT 'Jarvis',
+        text TEXT NOT NULL,
+        created_at INTEGER NOT NULL
+      );
+    `);
+
+    db.exec(`
+      INSERT INTO comments(id, entity_type, entity_id, author, text, created_at)
+      SELECT id, 'task', task_id, author, text, created_at FROM comments_old;
+    `);
+
+    if (hasProgress) {
+      db.exec(`
+        INSERT INTO progress_updates(id, entity_type, entity_id, author, text, created_at)
+        SELECT id, 'task', task_id, author, text, created_at FROM progress_updates_old;
+      `);
+    }
+
+    db.exec(`
+      DROP TABLE comments_old;
+      DROP TABLE IF EXISTS progress_updates_old;
+    `);
+  }
+
+  // Create shared tables if they still don't exist (fresh DB)
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS comments (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      entity_type TEXT NOT NULL DEFAULT 'task',
+      entity_id TEXT NOT NULL,
+      author TEXT NOT NULL DEFAULT 'Gabor',
+      text TEXT NOT NULL,
+      created_at INTEGER NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS progress_updates (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      entity_type TEXT NOT NULL DEFAULT 'task',
+      entity_id TEXT NOT NULL,
+      author TEXT NOT NULL DEFAULT 'Jarvis',
+      text TEXT NOT NULL,
+      created_at INTEGER NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_comments_entity_created ON comments(entity_type, entity_id, created_at);
+    CREATE INDEX IF NOT EXISTS idx_updates_entity_created ON progress_updates(entity_type, entity_id, created_at);
+  `);
+
+  // Projects
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      scope_text TEXT NOT NULL DEFAULT '',
+      repo_path TEXT,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_projects_updated ON projects(updated_at);
+  `);
+
+  // Ensure new columns exist for older DBs
+  addColumnIfMissing('tasks', 'project_id', `project_id TEXT NOT NULL DEFAULT '${DEFAULT_PROJECT_ID}'`);
+  addColumnIfMissing('tasks', 'parent_id', `parent_id TEXT`);
+  addColumnIfMissing('tasks', 'deleted_at', `deleted_at INTEGER`);
+  addColumnIfMissing('automation_tasks', 'project_id', `project_id TEXT NOT NULL DEFAULT '${DEFAULT_PROJECT_ID}'`);
+  addColumnIfMissing('projects', 'repo_path', `repo_path TEXT`);
+  addColumnIfMissing('projects', 'status_text', `status_text TEXT NOT NULL DEFAULT ''`);
+  addColumnIfMissing('projects', 'guidelines_text', `guidelines_text TEXT NOT NULL DEFAULT ''`);
+  addColumnIfMissing('tasks', 'milestone_id', `milestone_id TEXT`);
+  addColumnIfMissing('tasks', 'assigned_agent_id', `assigned_agent_id TEXT`);
+  addColumnIfMissing('agents', 'role', `role TEXT`);
+
+  // Ensure a default project always exists
+  const now = Date.now();
+  db.prepare(`
+    INSERT OR IGNORE INTO projects (id, name, scope_text, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?)
+  `).run(DEFAULT_PROJECT_ID, 'General', '', now, now);
+
+  // Backfill any NULL/empty project_id values
+  db.prepare(`UPDATE tasks SET project_id = ? WHERE project_id IS NULL OR project_id = ''`).run(DEFAULT_PROJECT_ID);
+  db.prepare(`UPDATE automation_tasks SET project_id = ? WHERE project_id IS NULL OR project_id = ''`).run(DEFAULT_PROJECT_ID);
+
+  // Indexes that rely on new columns (create after ALTER TABLE)
+  db.exec(`
+    CREATE INDEX IF NOT EXISTS idx_tasks_project_status_updated ON tasks(project_id, status, updated_at);
+    CREATE INDEX IF NOT EXISTS idx_tasks_project_parent_updated ON tasks(project_id, parent_id, updated_at);
+    CREATE INDEX IF NOT EXISTS idx_tasks_project_deleted_updated ON tasks(project_id, deleted_at, updated_at);
+    CREATE INDEX IF NOT EXISTS idx_tasks_parent_deleted ON tasks(parent_id, deleted_at);
+
+    CREATE INDEX IF NOT EXISTS idx_auto_project_type_status_updated ON automation_tasks(project_id, type, status, updated_at);
+    CREATE INDEX IF NOT EXISTS idx_auto_project_status_updated ON automation_tasks(project_id, status, updated_at);
+  `);
+
+  // Agent role uniqueness (partial unique index — only where role IS NOT NULL)
+  db.exec(`
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_agents_project_role ON agents(project_id, role) WHERE role IS NOT NULL;
+    CREATE INDEX IF NOT EXISTS idx_tasks_assigned_agent ON tasks(assigned_agent_id);
+  `);
+
+  // LLM run audit log (Phase 3)
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS llm_runs (
+      id TEXT PRIMARY KEY,
+      op TEXT NOT NULL,
+      project_id TEXT,
+      entity_type TEXT,
+      entity_id TEXT,
+      model TEXT NOT NULL,
+      request_json TEXT NOT NULL,
+      response_json TEXT,
+      error TEXT,
+      created_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_llm_runs_created ON llm_runs(created_at);
+    CREATE INDEX IF NOT EXISTS idx_llm_runs_project_created ON llm_runs(project_id, created_at);
+  `);
+
+  // LLM plans (Phase 4: plan -> apply)
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS llm_plans (
+      id TEXT PRIMARY KEY,
+      op TEXT NOT NULL,
+      project_id TEXT NOT NULL,
+      input_text TEXT NOT NULL,
+      plan_json TEXT NOT NULL,
+      llm_run_id TEXT,
+      applied INTEGER NOT NULL DEFAULT 0,
+      applied_at INTEGER,
+      created_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_llm_plans_project_created ON llm_plans(project_id, created_at);
+    CREATE INDEX IF NOT EXISTS idx_llm_plans_op_created ON llm_plans(op, created_at);
+  `);
+
+  // Milestones
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS milestones (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL,
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      status TEXT NOT NULL DEFAULT 'ideas',
+      target_date TEXT,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_milestones_project_status ON milestones(project_id, status, updated_at);
+    CREATE INDEX IF NOT EXISTS idx_tasks_milestone_id ON tasks(milestone_id);
+  `);
+
+  // Chat messages (per-project LLM chat)
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS chat_messages (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL,
+      role TEXT NOT NULL,
+      content TEXT,
+      tool_calls_json TEXT,
+      tool_call_id TEXT,
+      tool_name TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      FOREIGN KEY (project_id) REFERENCES projects(id)
+    );
+    CREATE INDEX IF NOT EXISTS idx_chat_messages_project ON chat_messages(project_id, created_at);
+  `);
+
+  // Agents (configurable Claude Code agents with session persistence)
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS agents (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL,
+      name TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      system_prompt TEXT NOT NULL DEFAULT '',
+      status TEXT NOT NULL DEFAULT 'active',
+      claude_session_id TEXT,
+      repo_path TEXT,
+      allowed_tools TEXT NOT NULL DEFAULT '',
+      max_turns INTEGER DEFAULT 25,
+      dangerously_skip_permissions INTEGER NOT NULL DEFAULT 0,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL
+    );
+    CREATE INDEX IF NOT EXISTS idx_agents_project ON agents(project_id, updated_at);
+  `);
+
+  // Agent run audit log
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS agent_runs (
+      id TEXT PRIMARY KEY,
+      agent_id TEXT NOT NULL,
+      prompt TEXT NOT NULL,
+      result_text TEXT,
+      session_id_used TEXT,
+      session_id_after TEXT,
+      status TEXT NOT NULL DEFAULT 'running',
+      error TEXT,
+      duration_ms INTEGER,
+      created_at INTEGER NOT NULL,
+      completed_at INTEGER
+    );
+    CREATE INDEX IF NOT EXISTS idx_agent_runs_agent ON agent_runs(agent_id, created_at);
+  `);
+
+  if (currentVersion < SCHEMA_VERSION) {
+    db.pragma(`user_version = ${SCHEMA_VERSION}`);
+  }
+}

package/docs/project-manager-chat.md

@@ -0,0 +1,202 @@
+# Project Manager Chat
+
+A per-project conversational AI assistant that can answer questions about the project and create, update, edit, and delete tasks and milestones via natural language.
+
+## Overview
+
+The Chat feature adds a conversational interface to each project. The LLM receives full project context (scope, status, all tasks, all milestones) and can both answer questions and perform actions using OpenAI-compatible tool calls (function calling).
+
+Messages are stored per-project. The LLM sees the last 50 messages as conversation history, maintaining continuity across requests.
+
+## Architecture
+
+### Database
+
+**Table: `chat_messages`** (schema v9)
+
+| Column | Type | Description |
+|--------|------|-------------|
+| `id` | TEXT PK | nanoid |
+| `project_id` | TEXT FK | Links to projects table |
+| `role` | TEXT | `user`, `assistant`, or `tool` |
+| `content` | TEXT | Message text (NULL for tool-call-only assistant messages) |
+| `tool_calls_json` | TEXT | JSON array of tool calls (assistant messages only) |
+| `tool_call_id` | TEXT | References the tool call being responded to (tool messages only) |
+| `tool_name` | TEXT | Which tool was called (tool messages only) |
+| `created_at` | TEXT | ISO 8601 timestamp |
+
+### LLM Integration
+
+Uses the new `llmChatWithTools()` function in `llm.mjs`, which differs from `llmChat()`:
+- Does **not** force `response_format: json_object`
+- Accepts `tools` and `tool_choice` parameters
+- Returns `{ run_id, url, data, content, tool_calls }`
+
+### Tool-Call Loop
+
+When the user sends a message:
+
+1. User message is saved to `chat_messages`
+2. Last 50 messages are loaded and converted to OpenAI message format
+3. System prompt is built with full project context
+4. LLM is called with 8 tool definitions
+5. If the LLM returns tool calls:
+   - Each tool call is executed against the database
+   - Results are saved as `role='tool'` messages
+   - The LLM is called again with the updated conversation
+6. This loops up to **5 iterations** until the LLM returns a text-only response
+7. The final assistant message is saved and returned
+
+## API Endpoints
+
+All endpoints require the `X-API-Key` header if `AI_API_KEY` is configured.
+
+### Send Message
+
+```
+POST /api/projects/:id/chat
+```
+
+**Request:**
+```json
+{
+  "message": "What should I work on next?"
+}
+```
+
+**Response:**
+```json
+{
+  "message": {
+    "id": "abc123",
+    "role": "assistant",
+    "content": "Based on the current status, I'd suggest...",
+    "created_at": "2026-02-11T20:00:00.000Z"
+  },
+  "actions_performed": [
+    {
+      "tool": "create_task",
+      "args": { "title": "Fix login bug", "status": "todo" },
+      "result": { "ok": true, "action": "created_task", "task_id": "xyz789", "title": "Fix login bug" }
+    }
+  ]
+}
+```
+
+### Get Conversation History
+
+```
+GET /api/projects/:id/chat?limit=50
+```
+
+Returns only `user` and `assistant` messages with content (tool-call plumbing messages are filtered out). Messages are ordered oldest-first.
+
+**Response:**
+```json
+{
+  "messages": [
+    {
+      "id": "msg1",
+      "role": "user",
+      "content": "Create a task for fixing the login bug",
+      "tool_calls_json": null,
+      "created_at": "2026-02-11T20:00:00.000Z"
+    },
+    {
+      "id": "msg2",
+      "role": "assistant",
+      "content": "Done! I've created the task 'Fix login bug' in the todo column.",
+      "tool_calls_json": "[{\"id\":\"call_1\",\"function\":{\"name\":\"create_task\",...}}]",
+      "created_at": "2026-02-11T20:00:01.000Z"
+    }
+  ]
+}
+```
+
+### Clear Conversation
+
+```
+DELETE /api/projects/:id/chat
+```
+
+Deletes all messages for the project (including tool-call messages).
+
+**Response:**
+```json
+{
+  "cleared": 42
+}
+```
+
+## Available Tools
+
+The LLM has access to 8 tools for managing tasks and milestones:
+
+### Task Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_task` | Create a new task. Params: `title` (required), `description`, `detail_text`, `status`, `parent_id`, `milestone_id` |
+| `update_task` | Update task fields. Params: `task_id` (required), plus any field to change |
+| `edit_task_field` | Surgical find-and-replace on a text field. Params: `task_id`, `field` (title/description/detail_text), `old_text`, `new_text` |
+| `delete_task` | Soft-delete a task and all its descendants. Params: `task_id` |
+
+### Milestone Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_milestone` | Create a new milestone. Params: `title` (required), `description`, `status`, `target_date` |
+| `update_milestone` | Update milestone fields. Params: `milestone_id` (required), plus any field to change |
+| `edit_milestone_field` | Surgical find-and-replace on a text field. Params: `milestone_id`, `field` (title/description), `old_text`, `new_text` |
+| `delete_milestone` | Delete a milestone and unlink its tasks. Params: `milestone_id` |
+
+### Surgical Edit Tools
+
+The `edit_task_field` and `edit_milestone_field` tools allow the LLM to make precise text edits without rewriting entire fields. The system prompt instructs the LLM to prefer these for small changes.
+
+Example: To change "Implment" to "Implement" in a task description, the LLM calls:
+```json
+{
+  "name": "edit_task_field",
+  "arguments": {
+    "task_id": "abc123",
+    "field": "description",
+    "old_text": "Implment",
+    "new_text": "Implement"
+  }
+}
+```
+
+## System Prompt
+
+The LLM receives a system message containing:
+
+1. **Role instruction** — "You are a Project Manager assistant for {project name}"
+2. **Project scope** — The full `scope_text` (PRD/requirements)
+3. **Current status** — The `status_text` summary
+4. **All milestones** — Status, title, ID, task progress (e.g., "3/7 tasks done")
+5. **All tasks** — ID, status, title, parent, milestone, description snippet, detail snippet (up to 500 tasks, 20K chars)
+
+## Frontend
+
+The Chat tab (tab index 4) appears after Milestones in the tab bar.
+
+**Features:**
+- Message bubbles: user messages right-aligned (blue), assistant messages left-aligned (dark)
+- Tool call summary chip on assistant messages that performed actions (shows tool names)
+- Loading spinner with "Thinking..." text while waiting for LLM response
+- Auto-scroll to bottom on new messages
+- Enter key sends message, Shift+Enter for newline
+- Clear button with confirmation dialog
+- Placeholder message when no project is selected
+- Chat auto-loads when switching to the tab or changing projects
+- Task/milestone boards auto-refresh when the LLM performs actions
+
+## Files Changed
+
+| File | Changes |
+|------|---------|
+| `db.mjs` | Schema v9, `chat_messages` table + index |
+| `llm.mjs` | `llmChatWithTools()` function |
+| `server.mjs` | 8 tool definitions, `buildChatSystemMessage()`, `executeChatToolCall()`, `chatMessagesToLLMMessages()`, 3 API endpoints |
+| `public/index.html` | Chat tab UI, data properties, methods, tab/project watchers |