saga-mcp 1.7.0 → 1.7.1

package/README.md

@@ -2,6 +2,7 @@
 
 [![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)
 
 Your coding agent loses the plan between sessions. You come back tomorrow and
@@ -386,6 +387,7 @@ What you get:
 - **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

package/dist/web/ui.js

@@ -400,6 +400,39 @@ function modal(title, fields, submitLabel, onSubmit) {
 
 /* ---------- shell ---------- */
 
+/* ---------- url state ---------- */
+
+/**
+ * Project, tab and the open task live in the location hash. A browser refresh
+ * then puts you back exactly where you were instead of dumping you on the
+ * overview with the task drawer closed, and back/forward work.
+ */
+var applyingHash = false;
+
+function syncHash() {
+  if (applyingHash) return;
+  var parts = [];
+  if (S.projectId) parts.push('p=' + S.projectId);
+  if (S.tab && S.tab !== 'overview') parts.push('tab=' + S.tab);
+  if (S.task) parts.push('task=' + S.task.id);
+  var next = parts.length ? '#' + parts.join('&') : '#';
+  if (next !== location.hash) history.replaceState(null, '', next);
+}
+
+function readHash() {
+  var out = {};
+  var raw = location.hash.replace(/^#/, '');
+  if (!raw) return out;
+  raw.split('&').forEach(function (pair) {
+    var i = pair.indexOf('=');
+    if (i < 0) return;
+    var k = pair.slice(0, i), v = pair.slice(i + 1);
+    if (k === 'p' || k === 'task') { var n = Number(v); if (n > 0) out[k] = n; }
+    if (k === 'tab' && TABS.some(function (t) { return t[0] === v; })) out.tab = v;
+  });
+  return out;
+}
+
 function renderTabs() {
   el('tabs').innerHTML = TABS.map(function (t) {
     return '<button data-tab="' + t[0] + '" class="' + (S.tab === t[0] ? 'active' : '') + '">' + t[1] + '</button>';
@@ -447,6 +480,7 @@ function refresh() {
 
 function render() {
   renderTabs();
+  syncHash();
   el('roBadge').hidden = !S.readOnly;
   if (S.query) return renderSearch();
   var fns = { overview: viewOverview, board: viewBoard, epics: viewEpics,
@@ -680,11 +714,13 @@ function openTask(id) {
   return get('/api/tasks/' + id + (S.showDeleted ? '?include_deleted=1' : '')).then(function (t) {
     S.task = t;
     drawTask();
+    syncHash();
   }).catch(oops);
 }
 
 function closeDrawer() {
   S.task = null;
+  syncHash();
   var d = document.querySelector('.drawer');
   var b = document.querySelector('.drawer-backdrop');
   if (d) d.remove();
@@ -710,6 +746,7 @@ function drawTask() {
   d.className = 'drawer';
 
   var h = '<div class="row"><span class="grow"></span>' +
+    '<button class="btn" id="refreshTask" title="Re-read this task from the database">⟳ Refresh</button>' +
     (ed ? '<button class="btn" id="editTask">Edit task</button>' : '') +
     '<button class="btn" id="closeDrawer">Close ✕</button></div>';
   h += '<h2 style="margin:6px 0 8px;font-size:18px">' + esc(t.title) + '</h2>';
@@ -951,6 +988,12 @@ document.addEventListener('click', function (ev) {
   if (tabBtn) { S.tab = tabBtn.dataset.tab; S.query = ''; el('q').value = ''; render(); return; }
 
   if (target.id === 'closeDrawer') return closeDrawer();
+  if (target.id === 'refreshTask') {
+    var btn = target;
+    btn.disabled = true;
+    btn.textContent = '⟳ …';
+    return refresh().then(function () { toast('Refreshed'); }).catch(oops);
+  }
   if (target.id === 'clearSearch') { S.query = ''; el('q').value = ''; render(); return; }
   if (target.id === 'reload') { toast('Reloaded'); refresh(); return; }
   if (target.id === 'expandAll') { S.overview.epics.forEach(function (e) { S.epicOpen[e.id] = true; }); render(); return; }
@@ -1177,16 +1220,50 @@ document.addEventListener('drop', function (ev) {
 
 /* ---------- boot ---------- */
 
+// Back and forward move between tasks and tabs rather than leaving the page.
+// Registered before boot so it survives a failed first fetch.
+window.addEventListener('hashchange', function () {
+  var want = readHash();
+  var openId = S.task ? S.task.id : null;
+  if (want.task === openId && (want.tab || 'overview') === S.tab &&
+      (!want.p || want.p === S.projectId)) return;
+
+  applyingHash = true;
+  try {
+    if (want.p && want.p !== S.projectId && S.projects.some(function (p) { return p.id === want.p; })) {
+      S.projectId = want.p;
+      el('projectSel').value = String(want.p);
+      S.epicOpen = {};
+      loadProject();
+    }
+    S.tab = want.tab || 'overview';
+    render();
+    if (want.task) openTask(want.task);
+    else if (S.task) closeDrawer();
+  } finally {
+    applyingHash = false;
+  }
+});
+
 get('/api/projects').then(function (r) {
   S.projects = r.projects;
   S.readOnly = !!r.read_only;
   el('dbpath').textContent = r.db_path;
   el('roBadge').hidden = !S.readOnly;
   if (S.readOnly) el('newProject').hidden = true;
-  if (S.projects.length) S.projectId = S.projects[0].id;
+
+  var want = readHash();
+  var known = S.projects.some(function (p) { return p.id === want.p; });
+  S.projectId = known ? want.p : (S.projects.length ? S.projects[0].id : null);
+  if (want.tab) S.tab = want.tab;
+
   renderProjects();
-  loadProject();
+  loadProject().then(function () {
+    // Reopen whatever task the URL names, so a browser refresh keeps your place.
+    if (want.task) return openTask(want.task);
+  });
 }).catch(fail);
+
 </script>
 </body>
 </html>`;

package/dist/web/ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/web/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,IAAI,GAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8pCpB,CAAC"}
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/web/ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,IAAI,GAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA2uCpB,CAAC"}

package/manifest.json

@@ -2,7 +2,7 @@
   "manifest_version": "0.3",
   "name": "saga-mcp",
   "display_name": "Saga — Project Tracker for AI Agents",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "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.",
   "long_description": "Saga gives your AI assistant a structured SQLite database to track projects, epics, tasks, subtasks, notes, and decisions across sessions. No more scattered markdown files — one `tracker_dashboard` call gives full project context to resume work.\n\n**Key features:**\n- Full hierarchy: Projects > Epics > Tasks > Subtasks\n- Task dependencies: Express sequencing with auto-block/unblock\n- Comments: Threaded discussions on tasks for decision trails, with reversible soft-delete\n- Templates: Reusable task sets with variable substitution\n- Dashboard: One tool call gives full overview with natural language summary\n- SQLite: Self-contained `.tracker.db` file per project — zero setup\n- Activity log: Every mutation is automatically tracked\n- Notes system: Decisions, context, meeting notes, blockers\n- Batch operations: Create multiple subtasks or update multiple tasks in one call\n- 33 focused tools with safety annotations\n- Web UI: `saga-web` serves a local dashboard for browsing and editing the same database\n- Import/export: Full project backup and migration as JSON",
   "author": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "saga-mcp",
   "mcpName": "io.github.spranab/saga-mcp",
-  "version": "1.7.0",
+  "version": "1.7.1",
   "description": "A Jira-like project tracker MCP server for AI agents. SQLite-backed, per-project scoped, with full hierarchy (Projects > Epics > Tasks > Subtasks), activity logging, and a dashboard \u2014 so LLMs never lose track.",
   "type": "module",
   "main": "dist/index.js",