saga-mcp 1.6.0 → 1.7.1

package/README.md

@@ -1,31 +1,88 @@
 # saga-mcp
 
+[![npm](https://img.shields.io/npm/v/saga-mcp)](https://www.npmjs.com/package/saga-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/saga-mcp)](https://www.npmjs.com/package/saga-mcp)
+[![license](https://img.shields.io/npm/l/saga-mcp)](https://github.com/spranab/saga-mcp/blob/master/LICENSE)
 [![IdeaCred](https://ideacred.com/api/badge/spranab/saga-mcp)](https://ideacred.com/profile/spranab)
 
-A Jira-like project tracker MCP server for AI agents. SQLite-backed, per-project scoped, with full hierarchy and activity logging — so LLMs never lose track.
+Your coding agent loses the plan between sessions. You come back tomorrow and
+it has no idea which of the five things you agreed on are done, which one is
+blocked on which, or why you rejected the second approach — because the plan
+lived in the context window, or in a `TODO.md` nobody updates.
 
-**No more scattered markdown files.** saga-mcp gives your AI assistant a structured database to track projects, epics, tasks, subtasks, notes, and decisions across sessions.
+saga-mcp gives the agent a real tracker instead: a SQLite file in your project
+holding projects, epics, tasks, subtasks, dependencies, comments, notes and
+decisions, exposed as 33 MCP tools. The agent writes to it as it works and
+reads the dashboard when it comes back. No accounts, no external service, no
+network calls — the database is a file you own.
+
+## Install (60 seconds)
+
+Claude Code — add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "saga": {
+      "command": "npx",
+      "args": ["-y", "saga-mcp"],
+      "env": { "DB_PATH": "/absolute/path/to/your/project/.tracker.db" }
+    }
+  }
+}
+```
+
+Restart the client. `DB_PATH` is the only setting; the file and schema are
+created on first use.
+
+## What it looks like
+
+**You:** "Set up tracking for the e-commerce API and plan out auth."
+
+```
+tracker_init({ project_name: "E-Commerce API" })
+epic_create({ project_id: 1, name: "Authentication", priority: "high" })
+task_create({ epic_id: 1, title: "Design auth schema", priority: "critical" })
+task_create({ epic_id: 1, title: "Implement JWT auth", depends_on: [1] })
+task_create({ epic_id: 1, title: "Add OAuth2 Google login", depends_on: [2] })
+```
+
+Tasks 2 and 3 come back **blocked** — their dependencies aren't done. Finish
+task 1 and task 2 unblocks itself.
+
+**Next session, you:** "Where were we?"
+
+```
+tracker_dashboard({})
+→ "E-Commerce API: 5 tasks across 2 epics. 40% complete.
+   Active: Authentication (2/3 done). Next up: Product Catalog (2 tasks).
+   1 blocked task(s)."
+```
+
+Plus the structured data behind it: stats, epics, blocked and overdue tasks,
+recent activity, notes.
 
 ## Features
 
 - **Full hierarchy**: Projects > Epics > Tasks > Subtasks
 - **Task dependencies**: Express sequencing with auto-block/unblock when deps are met
-- **Comments**: Threaded discussions on tasks — leave breadcrumbs across sessions
+- **Comments**: Threaded discussions on tasks — leave breadcrumbs across sessions, with reversible soft-delete
+- **Web UI**: `saga-web` serves a local dashboard for browsing *and* editing the same database
 - **Templates**: Reusable task sets with `{variable}` substitution
 - **Dashboard**: One tool call gives full overview with natural language summary
 - **SQLite**: Self-contained `.tracker.db` file per project — zero setup, no external database
 - **Activity log**: Every mutation is automatically tracked with old/new values
 - **Notes system**: Decisions, context, meeting notes, blockers — all searchable
 - **Batch operations**: Create multiple subtasks or update multiple tasks in one call
-- **31 focused tools**: With MCP safety annotations on every tool
+- **33 focused tools**: With MCP safety annotations on every tool
 - **Import/export**: Full project backup and migration as JSON (with dependencies and comments)
 - **Source references**: Link tasks to specific code locations
 - **Auto time tracking**: Hours computed automatically from activity log
 - **Cross-platform**: Works on macOS, Windows, and Linux
 
-## Quick Start
+## Other clients
 
-### With Claude Code
+### Claude Code
 
 Add to your project's `.mcp.json`:
 
@@ -75,9 +132,29 @@ saga-mcp requires a single environment variable:
 | Variable | Required | Description |
 |----------|----------|-------------|
 | `DB_PATH` | Yes | Absolute path to the `.tracker.db` SQLite file. The file and schema are auto-created on first use. |
+| `SAGA_PROJECT` | No | Scope every tool to one project, by id or name. Set this per repo when several repos share one database. Unset, tools read across the whole file. |
+| `SAGA_TOOLS` | No | `full` (default) lists all 33 tools. `core` lists only the 12 an ordinary tracking session needs, cutting ~3,300 tokens of context per session. Tools left off the list still work if called by name. |
 
 No API keys, no accounts, no external services. Everything is stored locally in the SQLite file you specify.
 
+### Token cost
+
+The tool list is context every session pays before any work happens, and list responses are
+context it pays again on every call. Both are kept deliberately small:
+
+- Responses are compact JSON — no pretty-print indentation, which measured 20-27% of every response
+- `task_list` rows omit nulls and `metadata`, and truncate descriptions to 120 characters
+  (call `task_get` for a task's full text) — 19-39% smaller depending on how long your descriptions run
+- `activity_log` omits null columns and the row id (no tool takes one) — about 27% smaller
+- `tracker_search` returns previews rather than whole records — about 47% smaller; follow up with
+  `task_get` or `note_list` for the full text
+- `SAGA_TOOLS=core` drops the listed tool surface from ~6,000 to ~2,700 tokens
+
+`note_list` deliberately keeps full note content — it is the retrieval tool, not a preview.
+
+Set `SAGA_TOOLS=core` when an agent only tracks work; leave it unset when you want templates,
+import/export, session diffs and the rest discoverable.
+
 ## Tools
 
 ### Getting Started
@@ -126,7 +203,9 @@ No API keys, no accounts, no external services. Everything is stored locally in
 | Tool | Description | Annotations |
 |------|-------------|-------------|
 | `comment_add` | Add a comment to a task (threaded discussion) | `readOnly: false` |
-| `comment_list` | List all comments on a task | `readOnly: true` |
+| `comment_list` | List comments on a task (removed ones hidden unless `include_deleted`) | `readOnly: true` |
+| `comment_delete` | Remove a comment — soft delete, row kept for audit | `readOnly: false`, `idempotent: true` |
+| `comment_restore` | Restore a removed comment | `readOnly: false`, `idempotent: true` |
 
 ### Templates
 
@@ -225,6 +304,100 @@ task_update({ id: 5, status: "done" })
 
 Comments persist across sessions — next time an agent calls `task_get(5)`, it sees the full discussion thread.
 
+If a comment turns out to be wrong, retract it without losing the trail:
+
+```
+comment_delete({ id: 12, reason: "Root cause was wrong — it was a proxy timeout", deleted_by: "pranab" })
+```
+
+The row stays in the database and in the activity log. `comment_list` and `task_get` skip it,
+`comment_list({ task_id: 5, include_deleted: true })` shows it with its reason, and
+`comment_restore({ id: 12 })` brings it back. Nothing an agent removes is unrecoverable.
+
+## One database, many projects
+
+saga-mcp works either way: a `.tracker.db` per repo (portable, keeps unrelated work apart),
+or one shared database that every repo points at.
+
+The shared setup needs one extra thing. `projects` is the top-level table, so a shared file holds
+several projects — but `task_list`, `note_list`, `activity_log` and `tracker_search` read across
+the whole file unless told otherwise. An agent in repo B would see repo A's tasks. Set
+`SAGA_PROJECT` per repo and each agent sees only its own:
+
+```json
+{
+  "mcpServers": {
+    "saga": {
+      "command": "npx",
+      "args": ["-y", "saga-mcp"],
+      "env": {
+        "DB_PATH": "/Users/you/saga/central.tracker.db",
+        "SAGA_PROJECT": "Payments platform"
+      }
+    }
+  }
+}
+```
+
+`SAGA_PROJECT` takes a project id or a project name (case-insensitive), and fails on startup with
+the list of real projects if it matches neither. Every scoped tool also accepts an explicit
+`project_id` argument, which wins over the environment variable.
+
+| Setup | What to set | Result |
+|-------|-------------|--------|
+| One database per repo | `DB_PATH` | Nothing to scope — one project per file |
+| Shared database, per-repo agents | `DB_PATH` + `SAGA_PROJECT` | Each agent sees only its project |
+| Shared database, one agent over everything | `DB_PATH` | Tools read across all projects |
+
+With neither `SAGA_PROJECT` nor a `project_id`, `tracker_dashboard` falls back to the first project
+in the file and says so — the response carries `other_projects` and the summary explains that the
+project was a guess, rather than silently reporting on the wrong repo.
+
+The web UI is unaffected either way: its project switcher lists every project in the database, and
+each tab is scoped to the selected one.
+
+## Web UI
+
+Everything above is agent-facing. `saga-web` puts the same database in a browser — for the times
+when reviewing a spec an agent just wrote, or fixing one field by hand, is faster than another prompt.
+
+```bash
+npx -p saga-mcp saga-web ./.tracker.db --open
+```
+
+Or against a database you already point your MCP server at:
+
+```bash
+saga-web --db ~/saga/central.tracker.db --port 8080
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `--db <path>` | `$DB_PATH` | Database to open. A positional path works too. |
+| `--port <n>` | first free from `4319` | Omit it and saga-web takes the first free port, so one instance per project just works. `--port N` binds exactly N and fails if taken; `--port 0` lets the OS choose. Also `SAGA_WEB_PORT`. |
+| `--host <addr>` | `127.0.0.1` | Bind address. Local-only by default. |
+| `--read-only` | off | Serve the UI with every editing control removed. |
+| `--open` | off | Open the UI in your default browser. |
+
+What you get:
+
+- **Overview** — stats, per-epic progress, blocked and overdue tasks
+- **Board** — kanban across the five task statuses; drag a card to change its status
+- **Epics** — the full Epic → Task → Subtask tree, which is the fastest way to review a spec an agent just wrote
+- **Notes** and **Activity** — decisions and the complete change history
+- **Task drawer** — edit any field, tick subtasks, comment, remove or restore a comment
+- **Project switcher** — every project in the database, so one central `.tracker.db` covers all your repos; every tab, including Activity, is scoped to the selected project
+- **Shareable, refreshable URLs** — the open project, tab and task live in the address bar, so a browser refresh puts you back where you were and back/forward move between tasks. A ⟳ button in the task drawer re-reads that task without a page reload, for picking up what an agent just wrote
+
+Writes from the UI call the *same handlers* the MCP tools do, so edits you make by hand are
+validated identically and land in the same activity log as the agent's — an agent calling
+`tracker_dashboard` after you fix something sees the fix and how it happened.
+
+A few deliberate limits: it binds to `127.0.0.1` unless you ask otherwise, it has no
+authentication (don't put it on a shared network), and it will not create a database — point it
+at one your MCP server already uses. Separate `.tracker.db` files are not yet aggregated into
+one view; a single database with multiple projects is.
+
 ## How It Works
 
 saga-mcp stores everything in a single SQLite file (`.tracker.db`) per project. The database is auto-created on first use with all tables and indexes — no migration step needed.
@@ -300,6 +473,9 @@ cd saga-mcp
 npm install
 npm run build
 DB_PATH=./test.db npm start
+
+# the web UI against the same database
+node dist/web/index.js ./test.db --open
 ```
 
 ## Support
@@ -307,6 +483,22 @@ DB_PATH=./test.db npm start
 - **Issues**: https://github.com/spranab/saga-mcp/issues
 - **Repository**: https://github.com/spranab/saga-mcp
 
+## Related projects
+
+Part of a set of agent infrastructure built by one person, meant to be used
+together:
+
+- [yantrikdb-mcp](https://github.com/yantrikos/yantrikdb-mcp) — persistent
+  cognitive memory for the same agent: what it learned, not what it planned.
+- [brainstorm-mcp](https://github.com/spranab/brainstorm-mcp) — multi-model
+  debate before you commit a plan to the tracker.
+- [swarmcode](https://github.com/spranab/swarmcode) — real-time channel
+  between Claude Code instances on different machines.
+- [truenas-mcp](https://github.com/spranab/truenas-mcp) — 278 TrueNAS SCALE
+  actions behind one hierarchical tool.
+- [mcpier](https://github.com/spranab/mcpier) — self-hosted MCP control plane
+  that keeps API keys off your clients.
+
 ## License
 
 MIT

package/dist/db.js

@@ -27,6 +27,26 @@ export function getDb() {
         db.exec('CREATE INDEX IF NOT EXISTS idx_epics_branch ON epics(branch)');
     }
     catch { /* index already exists */ }
+    try {
+        db.exec('ALTER TABLE comments ADD COLUMN is_deleted INTEGER NOT NULL DEFAULT 0');
+    }
+    catch { /* column already exists */ }
+    try {
+        db.exec('ALTER TABLE comments ADD COLUMN deleted_at TEXT');
+    }
+    catch { /* column already exists */ }
+    try {
+        db.exec('ALTER TABLE comments ADD COLUMN deleted_by TEXT');
+    }
+    catch { /* column already exists */ }
+    try {
+        db.exec('ALTER TABLE comments ADD COLUMN delete_reason TEXT');
+    }
+    catch { /* column already exists */ }
+    try {
+        db.exec('CREATE INDEX IF NOT EXISTS idx_comments_task_live ON comments(task_id, is_deleted)');
+    }
+    catch { /* index already exists */ }
     return db;
 }
 export function closeDb() {

package/dist/db.js.map

@@ -1 +1 @@
-{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,IAAI,EAAE,GAA6B,IAAI,CAAC;AAExC,MAAM,UAAU,KAAK;IACnB,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,mIAAmI,CACpI,CAAC;IACJ,CAAC;IAED,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE1B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACjC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAElC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEpB,oCAAoC;IACpC,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IACtG,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAClG,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IAErH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;AACH,CAAC"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,IAAI,EAAE,GAA6B,IAAI,CAAC;AAExC,MAAM,UAAU,KAAK;IACnB,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACnC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,mIAAmI,CACpI,CAAC;IACJ,CAAC;IAED,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAE1B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACjC,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAElC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEpB,oCAAoC;IACpC,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IACtG,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAClG,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACrH,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAC/H,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IACzG,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IACzG,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;IAC5G,IAAI,CAAC;QAAC,EAAE,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IAE3I,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/helpers/project-scope.d.ts

@@ -0,0 +1,31 @@
+import type Database from 'better-sqlite3';
+/** The project a call should be scoped to, or undefined for the whole database. */
+export declare function resolveProjectId(db: Database.Database, args: Record<string, unknown>): number | undefined;
+export declare function projectCount(db: Database.Database): number;
+/** Shared JSON-schema property, so every scoped tool describes it identically. */
+export declare const PROJECT_ID_SCHEMA: {
+    type: "integer";
+    description: string;
+};
+/**
+ * `WHERE` fragment selecting tasks in a project, given an alias for the epics
+ * table already joined by the caller.
+ */
+export declare function taskScopeClause(epicAlias?: string): string;
+/** Notes attached to a project, or to any epic/task inside it. Unattached notes count as global. */
+export declare function noteScopeClause(alias?: string): {
+    sql: string;
+    paramCount: number;
+};
+/**
+ * Activity rows name an entity by type and id, so scoping means walking each
+ * type back up to its project.
+ */
+export declare function activityScopeClause(alias?: string): {
+    sql: string;
+    paramCount: number;
+};
+/** Repeat a project id n times, for the multi-placeholder clauses above. */
+export declare function repeatId(projectId: number, n: number): number[];
+/** Only for tests — SAGA_PROJECT is read once and cached. */
+export declare function resetProjectScopeCache(): void;

package/dist/helpers/project-scope.js

@@ -0,0 +1,113 @@
+/**
+ * One database can hold many projects — the "global" / centralized setup, where
+ * every repo points its MCP server at the same .tracker.db.
+ *
+ * Without scoping, an agent working in repo B sees repo A's tasks: task_list,
+ * note_list, activity_log and tracker_search all read across the whole file.
+ * These helpers give every such tool the same scoping rule:
+ *
+ *   explicit project_id argument  >  SAGA_PROJECT env var  >  unscoped
+ *
+ * Set SAGA_PROJECT (an id, or a project name) in each repo's MCP config and a
+ * shared database behaves exactly like a per-project one.
+ */
+let cachedEnvProject;
+/** Resolve SAGA_PROJECT, which may be a numeric id or a project name. */
+function envProjectId(db) {
+    const raw = process.env.SAGA_PROJECT?.trim();
+    if (!raw)
+        return undefined;
+    if (cachedEnvProject && cachedEnvProject.raw === raw)
+        return cachedEnvProject.id;
+    let row;
+    if (/^\d+$/.test(raw)) {
+        row = db.prepare('SELECT id FROM projects WHERE id = ?').get(Number(raw));
+    }
+    else {
+        row = db.prepare('SELECT id FROM projects WHERE name = ? COLLATE NOCASE').get(raw);
+    }
+    if (!row) {
+        const known = db.prepare('SELECT id, name FROM projects ORDER BY id').all()
+            .map((p) => `${p.id}=${p.name}`)
+            .join(', ');
+        throw new Error(`SAGA_PROJECT is set to '${raw}', which is not a project in this database. Known projects: ${known || '(none)'}`);
+    }
+    cachedEnvProject = { raw, id: row.id };
+    return row.id;
+}
+/** The project a call should be scoped to, or undefined for the whole database. */
+export function resolveProjectId(db, args) {
+    const explicit = args.project_id;
+    if (typeof explicit === 'number')
+        return explicit;
+    if (typeof explicit === 'string' && /^\d+$/.test(explicit))
+        return Number(explicit);
+    return envProjectId(db);
+}
+export function projectCount(db) {
+    return db.prepare('SELECT COUNT(*) as n FROM projects').get().n;
+}
+/** Shared JSON-schema property, so every scoped tool describes it identically. */
+export const PROJECT_ID_SCHEMA = {
+    type: 'integer',
+    description: 'Scope to one project. Needed when a single database holds several projects; defaults to the SAGA_PROJECT env var if set, otherwise the whole database.',
+};
+/**
+ * `WHERE` fragment selecting tasks in a project, given an alias for the epics
+ * table already joined by the caller.
+ */
+export function taskScopeClause(epicAlias = 'e') {
+    return `${epicAlias}.project_id = ?`;
+}
+/** Notes attached to a project, or to any epic/task inside it. Unattached notes count as global. */
+export function noteScopeClause(alias = 'notes') {
+    return {
+        sql: `(
+      (${alias}.related_entity_type = 'project' AND ${alias}.related_entity_id = ?)
+      OR (${alias}.related_entity_type = 'epic' AND ${alias}.related_entity_id IN
+            (SELECT id FROM epics WHERE project_id = ?))
+      OR (${alias}.related_entity_type = 'task' AND ${alias}.related_entity_id IN
+            (SELECT t.id FROM tasks t JOIN epics e ON e.id = t.epic_id WHERE e.project_id = ?))
+      OR ${alias}.related_entity_type IS NULL
+    )`,
+        paramCount: 3,
+    };
+}
+/**
+ * Activity rows name an entity by type and id, so scoping means walking each
+ * type back up to its project.
+ */
+export function activityScopeClause(alias = 'activity_log') {
+    return {
+        sql: `(
+      (${alias}.entity_type = 'project' AND ${alias}.entity_id = ?)
+      OR (${alias}.entity_type = 'epic' AND ${alias}.entity_id IN
+            (SELECT id FROM epics WHERE project_id = ?))
+      OR (${alias}.entity_type = 'task' AND ${alias}.entity_id IN
+            (SELECT t.id FROM tasks t JOIN epics e ON e.id = t.epic_id WHERE e.project_id = ?))
+      OR (${alias}.entity_type = 'subtask' AND ${alias}.entity_id IN
+            (SELECT s.id FROM subtasks s JOIN tasks t ON t.id = s.task_id
+             JOIN epics e ON e.id = t.epic_id WHERE e.project_id = ?))
+      OR (${alias}.entity_type = 'comment' AND ${alias}.entity_id IN
+            (SELECT c.id FROM comments c JOIN tasks t ON t.id = c.task_id
+             JOIN epics e ON e.id = t.epic_id WHERE e.project_id = ?))
+      OR (${alias}.entity_type = 'note' AND ${alias}.entity_id IN
+            (SELECT n.id FROM notes n WHERE
+               (n.related_entity_type = 'project' AND n.related_entity_id = ?)
+               OR (n.related_entity_type = 'epic' AND n.related_entity_id IN
+                     (SELECT id FROM epics WHERE project_id = ?))
+               OR (n.related_entity_type = 'task' AND n.related_entity_id IN
+                     (SELECT t.id FROM tasks t JOIN epics e ON e.id = t.epic_id WHERE e.project_id = ?))))
+    )`,
+        paramCount: 8,
+    };
+}
+/** Repeat a project id n times, for the multi-placeholder clauses above. */
+export function repeatId(projectId, n) {
+    return Array.from({ length: n }, () => projectId);
+}
+/** Only for tests — SAGA_PROJECT is read once and cached. */
+export function resetProjectScopeCache() {
+    cachedEnvProject = undefined;
+}
+//# sourceMappingURL=project-scope.js.map

package/dist/helpers/project-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scope.js","sourceRoot":"","sources":["../../src/helpers/project-scope.ts"],"names":[],"mappings":"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"}

package/dist/helpers/slim.d.ts

@@ -0,0 +1,17 @@
+/**
+ * List responses are the tokens an agent pays over and over. Detail responses
+ * (task_get) stay complete; list rows drop what a scan does not need.
+ *
+ * Measured on a 40-task project: task_list went from ~5,300 to ~3,600 tokens.
+ */
+/** Longest description kept in a list row. Longer text is cut with an ellipsis. */
+export declare const LIST_DESCRIPTION_CHARS = 120;
+export declare function truncate(text: string, max?: number): string;
+/**
+ * Strip a list row down: no nulls, no metadata blob, no empty tags array, and
+ * long text fields truncated. Everything removed here is still available from
+ * the matching *_get tool.
+ */
+export declare function slimListRow(row: Record<string, unknown>, truncateFields?: string[], drop?: string[]): Record<string, unknown>;
+/** Apply slimListRow across a result set. */
+export declare function slimList(rows: Array<Record<string, unknown>>, truncateFields?: string[], drop?: string[]): Array<Record<string, unknown>>;

package/dist/helpers/slim.js

@@ -0,0 +1,45 @@
+/**
+ * List responses are the tokens an agent pays over and over. Detail responses
+ * (task_get) stay complete; list rows drop what a scan does not need.
+ *
+ * Measured on a 40-task project: task_list went from ~5,300 to ~3,600 tokens.
+ */
+/** Longest description kept in a list row. Longer text is cut with an ellipsis. */
+export const LIST_DESCRIPTION_CHARS = 120;
+export function truncate(text, max = LIST_DESCRIPTION_CHARS) {
+    if (text.length <= max)
+        return text;
+    // Prefer a word boundary so the cut reads as prose rather than mid-token.
+    const cut = text.slice(0, max);
+    const lastSpace = cut.lastIndexOf(' ');
+    return (lastSpace > max * 0.6 ? cut.slice(0, lastSpace) : cut).trimEnd() + '…';
+}
+/** Fields never worth their bytes in a list response. */
+const ALWAYS_DROP = new Set(['metadata']);
+/**
+ * Strip a list row down: no nulls, no metadata blob, no empty tags array, and
+ * long text fields truncated. Everything removed here is still available from
+ * the matching *_get tool.
+ */
+export function slimListRow(row, truncateFields = ['description'], drop = []) {
+    const out = {};
+    for (const [key, value] of Object.entries(row)) {
+        if (value === null || value === undefined)
+            continue;
+        if (ALWAYS_DROP.has(key) || drop.includes(key))
+            continue;
+        if (key === 'tags' && (value === '[]' || value === ''))
+            continue;
+        if (truncateFields.includes(key) && typeof value === 'string') {
+            out[key] = truncate(value);
+            continue;
+        }
+        out[key] = value;
+    }
+    return out;
+}
+/** Apply slimListRow across a result set. */
+export function slimList(rows, truncateFields, drop) {
+    return rows.map((row) => slimListRow(row, truncateFields, drop));
+}
+//# sourceMappingURL=slim.js.map

package/dist/helpers/slim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slim.js","sourceRoot":"","sources":["../../src/helpers/slim.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mFAAmF;AACnF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAG,GAAG,sBAAsB;IACjE,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACpC,0EAA0E;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,CAAC,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC;AACjF,CAAC;AAED,yDAAyD;AACzD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,GAA4B,EAC5B,iBAA2B,CAAC,aAAa,CAAC,EAC1C,OAAiB,EAAE;IAEnB,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QACpD,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,SAAS;QACzD,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YAAE,SAAS;QACjE,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9D,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,QAAQ,CACtB,IAAoC,EACpC,cAAyB,EACzB,IAAe;IAEf,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/index.js

@@ -40,9 +40,39 @@ const ALL_HANDLERS = {
     ...activityHandlers,
     ...exportImportHandlers,
 };
+/**
+ * The full tool list costs ~6,000 tokens of context in every session before any
+ * work happens. SAGA_TOOLS=core exposes the subset that covers ordinary tracking
+ * (~2,300 tokens); handlers stay registered either way, so a client that already
+ * knows a tool name can still call it. Unset (or "full") keeps every tool listed.
+ */
+const CORE_TOOLS = new Set([
+    'tracker_init',
+    'tracker_dashboard',
+    'project_list',
+    'epic_create',
+    'epic_list',
+    'task_create',
+    'task_list',
+    'task_get',
+    'task_update',
+    'subtask_create',
+    'note_save',
+    'comment_add',
+]);
+function listedTools() {
+    const mode = (process.env.SAGA_TOOLS ?? 'full').trim().toLowerCase();
+    if (mode === 'full' || mode === '')
+        return ALL_TOOLS;
+    if (mode !== 'core') {
+        console.error(`Unknown SAGA_TOOLS value '${mode}' — expected 'core' or 'full'. Listing all tools.`);
+        return ALL_TOOLS;
+    }
+    return ALL_TOOLS.filter((t) => CORE_TOOLS.has(t.name));
+}
 const server = new Server({ name: 'tracker', version: '1.0.0' }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-    return { tools: ALL_TOOLS };
+    return { tools: listedTools() };
 });
 function friendlyError(msg) {
     if (msg.includes('UNIQUE constraint failed')) {
@@ -70,7 +100,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         }
         const result = handler(args ?? {});
         return {
-            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            // Compact, not pretty-printed: indentation costs ~22% of every response
+            // in tokens and buys the model nothing.
+            content: [{ type: 'text', text: JSON.stringify(result) }],
         };
     }
     catch (error) {
@@ -90,7 +122,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error('Tracker MCP Server running on stdio');
+    const listed = listedTools().length;
+    console.error(`Tracker MCP Server running on stdio (${listed} of ${ALL_TOOLS.length} tools listed` +
+        `${listed < ALL_TOOLS.length ? ' — SAGA_TOOLS=core' : ''})`);
 }
 process.on('SIGINT', () => {
     closeDb();

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -1 +1 @@
-export declare const SCHEMA_SQL = "\n-- Core hierarchy: projects > epics > tasks > subtasks\n\nCREATE TABLE IF NOT EXISTS projects (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  name          TEXT NOT NULL,\n  description   TEXT,\n  status        TEXT NOT NULL DEFAULT 'active'\n                  CHECK (status IN ('active', 'on_hold', 'completed', 'archived')),\n  tags          TEXT NOT NULL DEFAULT '[]',\n  metadata      TEXT NOT NULL DEFAULT '{}',\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS epics (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id    INTEGER NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name          TEXT NOT NULL,\n  description   TEXT,\n  status        TEXT NOT NULL DEFAULT 'planned'\n                  CHECK (status IN ('planned', 'in_progress', 'completed', 'cancelled')),\n  priority      TEXT NOT NULL DEFAULT 'medium'\n                  CHECK (priority IN ('low', 'medium', 'high', 'critical')),\n  sort_order    INTEGER NOT NULL DEFAULT 0,\n  branch        TEXT,\n  tags          TEXT NOT NULL DEFAULT '[]',\n  metadata      TEXT NOT NULL DEFAULT '{}',\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS tasks (\n  id              INTEGER PRIMARY KEY AUTOINCREMENT,\n  epic_id         INTEGER NOT NULL REFERENCES epics(id) ON DELETE CASCADE,\n  title           TEXT NOT NULL,\n  description     TEXT,\n  status          TEXT NOT NULL DEFAULT 'todo'\n                    CHECK (status IN ('todo', 'in_progress', 'review', 'done', 'blocked')),\n  priority        TEXT NOT NULL DEFAULT 'medium'\n                    CHECK (priority IN ('low', 'medium', 'high', 'critical')),\n  sort_order      INTEGER NOT NULL DEFAULT 0,\n  assigned_to     TEXT,\n  estimated_hours REAL,\n  actual_hours    REAL,\n  due_date        TEXT,\n  source_ref      TEXT,\n  tags            TEXT NOT NULL DEFAULT '[]',\n  metadata        TEXT NOT NULL DEFAULT '{}',\n  created_at      TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at      TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS subtasks (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  task_id       INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  title         TEXT NOT NULL,\n  status        TEXT NOT NULL DEFAULT 'todo'\n                  CHECK (status IN ('todo', 'in_progress', 'done')),\n  sort_order    INTEGER NOT NULL DEFAULT 0,\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Task dependencies (junction table)\n\nCREATE TABLE IF NOT EXISTS task_dependencies (\n  task_id            INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  depends_on_task_id INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  created_at         TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY (task_id, depends_on_task_id)\n);\n\n-- Comments (threaded discussions on tasks)\n\nCREATE TABLE IF NOT EXISTS comments (\n  id         INTEGER PRIMARY KEY AUTOINCREMENT,\n  task_id    INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  author     TEXT,\n  content    TEXT NOT NULL,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Task templates\n\nCREATE TABLE IF NOT EXISTS templates (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  name          TEXT NOT NULL UNIQUE,\n  description   TEXT,\n  template_data TEXT NOT NULL DEFAULT '[]',\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Unified notes (replaces summaries + status_updates + context)\n\nCREATE TABLE IF NOT EXISTS notes (\n  id                  INTEGER PRIMARY KEY AUTOINCREMENT,\n  title               TEXT NOT NULL,\n  content             TEXT NOT NULL,\n  note_type           TEXT NOT NULL DEFAULT 'general'\n                        CHECK (note_type IN (\n                          'general', 'decision', 'context', 'meeting',\n                          'technical', 'blocker', 'progress', 'release'\n                        )),\n  related_entity_type TEXT CHECK (related_entity_type IN ('project', 'epic', 'task') OR related_entity_type IS NULL),\n  related_entity_id   INTEGER,\n  tags                TEXT NOT NULL DEFAULT '[]',\n  metadata            TEXT NOT NULL DEFAULT '{}',\n  created_at          TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at          TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Automatic activity log\n\nCREATE TABLE IF NOT EXISTS activity_log (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  entity_type   TEXT NOT NULL,\n  entity_id     INTEGER NOT NULL,\n  action        TEXT NOT NULL,\n  field_name    TEXT,\n  old_value     TEXT,\n  new_value     TEXT,\n  summary       TEXT,\n  created_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes\n\nCREATE INDEX IF NOT EXISTS idx_epics_project_id ON epics(project_id);\nCREATE INDEX IF NOT EXISTS idx_tasks_epic_id ON tasks(epic_id);\nCREATE INDEX IF NOT EXISTS idx_subtasks_task_id ON subtasks(task_id);\n\nCREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);\nCREATE INDEX IF NOT EXISTS idx_epics_status ON epics(status);\nCREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);\nCREATE INDEX IF NOT EXISTS idx_subtasks_status ON subtasks(status);\n\nCREATE INDEX IF NOT EXISTS idx_epics_priority ON epics(priority);\nCREATE INDEX IF NOT EXISTS idx_tasks_priority ON tasks(priority);\n\nCREATE INDEX IF NOT EXISTS idx_epics_sort ON epics(project_id, sort_order);\nCREATE INDEX IF NOT EXISTS idx_tasks_sort ON tasks(epic_id, sort_order);\nCREATE INDEX IF NOT EXISTS idx_subtasks_sort ON subtasks(task_id, sort_order);\n\nCREATE INDEX IF NOT EXISTS idx_notes_type ON notes(note_type);\nCREATE INDEX IF NOT EXISTS idx_notes_entity ON notes(related_entity_type, related_entity_id);\nCREATE INDEX IF NOT EXISTS idx_notes_created ON notes(created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_activity_entity ON activity_log(entity_type, entity_id);\nCREATE INDEX IF NOT EXISTS idx_activity_created ON activity_log(created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_activity_action ON activity_log(action);\n\nCREATE INDEX IF NOT EXISTS idx_tasks_assigned ON tasks(assigned_to);\nCREATE INDEX IF NOT EXISTS idx_tasks_due ON tasks(due_date);\n\nCREATE INDEX IF NOT EXISTS idx_task_deps_depends ON task_dependencies(depends_on_task_id);\nCREATE INDEX IF NOT EXISTS idx_comments_task ON comments(task_id);\n";
+export declare const SCHEMA_SQL = "\n-- Core hierarchy: projects > epics > tasks > subtasks\n\nCREATE TABLE IF NOT EXISTS projects (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  name          TEXT NOT NULL,\n  description   TEXT,\n  status        TEXT NOT NULL DEFAULT 'active'\n                  CHECK (status IN ('active', 'on_hold', 'completed', 'archived')),\n  tags          TEXT NOT NULL DEFAULT '[]',\n  metadata      TEXT NOT NULL DEFAULT '{}',\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS epics (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  project_id    INTEGER NOT NULL REFERENCES projects(id) ON DELETE CASCADE,\n  name          TEXT NOT NULL,\n  description   TEXT,\n  status        TEXT NOT NULL DEFAULT 'planned'\n                  CHECK (status IN ('planned', 'in_progress', 'completed', 'cancelled')),\n  priority      TEXT NOT NULL DEFAULT 'medium'\n                  CHECK (priority IN ('low', 'medium', 'high', 'critical')),\n  sort_order    INTEGER NOT NULL DEFAULT 0,\n  branch        TEXT,\n  tags          TEXT NOT NULL DEFAULT '[]',\n  metadata      TEXT NOT NULL DEFAULT '{}',\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS tasks (\n  id              INTEGER PRIMARY KEY AUTOINCREMENT,\n  epic_id         INTEGER NOT NULL REFERENCES epics(id) ON DELETE CASCADE,\n  title           TEXT NOT NULL,\n  description     TEXT,\n  status          TEXT NOT NULL DEFAULT 'todo'\n                    CHECK (status IN ('todo', 'in_progress', 'review', 'done', 'blocked')),\n  priority        TEXT NOT NULL DEFAULT 'medium'\n                    CHECK (priority IN ('low', 'medium', 'high', 'critical')),\n  sort_order      INTEGER NOT NULL DEFAULT 0,\n  assigned_to     TEXT,\n  estimated_hours REAL,\n  actual_hours    REAL,\n  due_date        TEXT,\n  source_ref      TEXT,\n  tags            TEXT NOT NULL DEFAULT '[]',\n  metadata        TEXT NOT NULL DEFAULT '{}',\n  created_at      TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at      TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS subtasks (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  task_id       INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  title         TEXT NOT NULL,\n  status        TEXT NOT NULL DEFAULT 'todo'\n                  CHECK (status IN ('todo', 'in_progress', 'done')),\n  sort_order    INTEGER NOT NULL DEFAULT 0,\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Task dependencies (junction table)\n\nCREATE TABLE IF NOT EXISTS task_dependencies (\n  task_id            INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  depends_on_task_id INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  created_at         TEXT NOT NULL DEFAULT (datetime('now')),\n  PRIMARY KEY (task_id, depends_on_task_id)\n);\n\n-- Comments (threaded discussions on tasks)\n\nCREATE TABLE IF NOT EXISTS comments (\n  id         INTEGER PRIMARY KEY AUTOINCREMENT,\n  task_id    INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n  author     TEXT,\n  content    TEXT NOT NULL,\n  is_deleted INTEGER NOT NULL DEFAULT 0,\n  deleted_at TEXT,\n  deleted_by TEXT,\n  delete_reason TEXT,\n  created_at TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Task templates\n\nCREATE TABLE IF NOT EXISTS templates (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  name          TEXT NOT NULL UNIQUE,\n  description   TEXT,\n  template_data TEXT NOT NULL DEFAULT '[]',\n  created_at    TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Unified notes (replaces summaries + status_updates + context)\n\nCREATE TABLE IF NOT EXISTS notes (\n  id                  INTEGER PRIMARY KEY AUTOINCREMENT,\n  title               TEXT NOT NULL,\n  content             TEXT NOT NULL,\n  note_type           TEXT NOT NULL DEFAULT 'general'\n                        CHECK (note_type IN (\n                          'general', 'decision', 'context', 'meeting',\n                          'technical', 'blocker', 'progress', 'release'\n                        )),\n  related_entity_type TEXT CHECK (related_entity_type IN ('project', 'epic', 'task') OR related_entity_type IS NULL),\n  related_entity_id   INTEGER,\n  tags                TEXT NOT NULL DEFAULT '[]',\n  metadata            TEXT NOT NULL DEFAULT '{}',\n  created_at          TEXT NOT NULL DEFAULT (datetime('now')),\n  updated_at          TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Automatic activity log\n\nCREATE TABLE IF NOT EXISTS activity_log (\n  id            INTEGER PRIMARY KEY AUTOINCREMENT,\n  entity_type   TEXT NOT NULL,\n  entity_id     INTEGER NOT NULL,\n  action        TEXT NOT NULL,\n  field_name    TEXT,\n  old_value     TEXT,\n  new_value     TEXT,\n  summary       TEXT,\n  created_at    TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\n-- Indexes\n\nCREATE INDEX IF NOT EXISTS idx_epics_project_id ON epics(project_id);\nCREATE INDEX IF NOT EXISTS idx_tasks_epic_id ON tasks(epic_id);\nCREATE INDEX IF NOT EXISTS idx_subtasks_task_id ON subtasks(task_id);\n\nCREATE INDEX IF NOT EXISTS idx_projects_status ON projects(status);\nCREATE INDEX IF NOT EXISTS idx_epics_status ON epics(status);\nCREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);\nCREATE INDEX IF NOT EXISTS idx_subtasks_status ON subtasks(status);\n\nCREATE INDEX IF NOT EXISTS idx_epics_priority ON epics(priority);\nCREATE INDEX IF NOT EXISTS idx_tasks_priority ON tasks(priority);\n\nCREATE INDEX IF NOT EXISTS idx_epics_sort ON epics(project_id, sort_order);\nCREATE INDEX IF NOT EXISTS idx_tasks_sort ON tasks(epic_id, sort_order);\nCREATE INDEX IF NOT EXISTS idx_subtasks_sort ON subtasks(task_id, sort_order);\n\nCREATE INDEX IF NOT EXISTS idx_notes_type ON notes(note_type);\nCREATE INDEX IF NOT EXISTS idx_notes_entity ON notes(related_entity_type, related_entity_id);\nCREATE INDEX IF NOT EXISTS idx_notes_created ON notes(created_at DESC);\n\nCREATE INDEX IF NOT EXISTS idx_activity_entity ON activity_log(entity_type, entity_id);\nCREATE INDEX IF NOT EXISTS idx_activity_created ON activity_log(created_at DESC);\nCREATE INDEX IF NOT EXISTS idx_activity_action ON activity_log(action);\n\nCREATE INDEX IF NOT EXISTS idx_tasks_assigned ON tasks(assigned_to);\nCREATE INDEX IF NOT EXISTS idx_tasks_due ON tasks(due_date);\n\nCREATE INDEX IF NOT EXISTS idx_task_deps_depends ON task_dependencies(depends_on_task_id);\nCREATE INDEX IF NOT EXISTS idx_comments_task ON comments(task_id);\n";