@hasna/todos 0.9.64 → 0.9.66

package/dist/cli/index.js

@@ -3030,6 +3030,12 @@ var init_audit = __esm(() => {
 });
 
 // src/lib/recurrence.ts
+var exports_recurrence = {};
+__export(exports_recurrence, {
+  parseRecurrenceRule: () => parseRecurrenceRule,
+  nextOccurrence: () => nextOccurrence,
+  isValidRecurrenceRule: () => isValidRecurrenceRule
+});
 function parseRecurrenceRule(rule) {
   const normalized = rule.trim().toLowerCase();
   if (normalized === "every weekday" || normalized === "every weekdays") {
@@ -3068,6 +3074,14 @@ function parseRecurrenceRule(rule) {
   }
   throw new Error(`Invalid recurrence rule: "${rule}". Supported formats: "every day", "every weekday", "every week", "every 2 weeks", "every month", "every N days/weeks/months", "every monday", "every mon,wed,fri"`);
 }
+function isValidRecurrenceRule(rule) {
+  try {
+    parseRecurrenceRule(rule);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function nextOccurrence(rule, from) {
   const parsed = parseRecurrenceRule(rule);
   const base = from || new Date;
@@ -9304,6 +9318,7 @@ var init_mcp = __esm(() => {
     "complete_task",
     "fail_task",
     "get_status",
+    "get_context",
     "get_task",
     "start_task",
     "add_comment",
@@ -10893,6 +10908,37 @@ No pending tasks available.`);
       }
     });
   }
+  if (shouldRegisterTool("get_context")) {
+    server.tool("get_context", "Get a compact task summary for agent prompt injection. Returns formatted text.", {
+      agent_id: exports_external.string().optional(),
+      project_id: exports_external.string().optional(),
+      format: exports_external.enum(["text", "compact"]).optional()
+    }, async ({ agent_id, project_id, format: _format }) => {
+      try {
+        const filters = {};
+        if (project_id)
+          filters.project_id = resolveId(project_id, "projects");
+        const status = getStatus(Object.keys(filters).length > 0 ? filters : undefined, agent_id);
+        const next = getNextTask(agent_id, Object.keys(filters).length > 0 ? filters : undefined);
+        const lines = [];
+        lines.push(`Tasks: ${status.pending} pending | ${status.in_progress} active | ${status.completed} done`);
+        if (status.stale_count > 0)
+          lines.push(`\u26A0 ${status.stale_count} stale tasks`);
+        if (status.overdue_recurring > 0)
+          lines.push(`\uD83D\uDD01 ${status.overdue_recurring} overdue recurring`);
+        if (status.active_work.length > 0) {
+          const active = status.active_work.slice(0, 3).map((w) => `${w.short_id || w.id.slice(0, 8)} (${w.assigned_to || "?"})`).join(", ");
+          lines.push(`Active: ${active}`);
+        }
+        if (next)
+          lines.push(`Next up: ${next.short_id || next.id.slice(0, 8)} [${next.priority}] ${next.title}`);
+        return { content: [{ type: "text", text: lines.join(`
+`) }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: formatError(e) }], isError: true };
+      }
+    });
+  }
   if (shouldRegisterTool("search_tools")) {
     server.tool("search_tools", "List all tool names, optionally filtered by substring.", { query: exports_external.string().optional() }, async ({ query }) => {
       const all = [
@@ -10954,6 +11000,7 @@ No pending tasks available.`);
         "get_tasks_changed_since",
         "get_stale_tasks",
         "get_status",
+        "get_context",
         "decompose_task",
         "set_task_status",
         "set_task_priority",
@@ -14995,6 +15042,48 @@ program2.command("summary").description("Generate a markdown summary of recent t
   console.log(lines.join(`
 `));
 });
+program2.command("doctor").description("Diagnose common task data issues").option("--fix", "Auto-fix recoverable issues where possible").option("--json", "Output as JSON").action(async (opts) => {
+  const globalOpts = program2.opts();
+  const db = getDatabase();
+  const issues = [];
+  const stale = listTasks({ status: "in_progress" }).filter((t) => new Date(t.updated_at).getTime() < Date.now() - 30 * 60 * 1000);
+  if (stale.length > 0)
+    issues.push({ severity: "warn", type: "stale_tasks", message: `${stale.length} tasks stuck in_progress >30min`, count: stale.length });
+  const { isValidRecurrenceRule: isValidRecurrenceRule2 } = (init_recurrence(), __toCommonJS(exports_recurrence));
+  const recurring = listTasks({ status: ["pending", "in_progress"] }).filter((t) => t.recurrence_rule);
+  const invalidRecurrence = recurring.filter((t) => !isValidRecurrenceRule2(t.recurrence_rule));
+  if (invalidRecurrence.length > 0)
+    issues.push({ severity: "error", type: "invalid_recurrence", message: `${invalidRecurrence.length} tasks with invalid recurrence_rule`, count: invalidRecurrence.length });
+  const nowStr = new Date().toISOString();
+  const overdueRecurring = recurring.filter((t) => t.due_at && t.due_at < nowStr);
+  if (overdueRecurring.length > 0)
+    issues.push({ severity: "warn", type: "overdue_recurring", message: `${overdueRecurring.length} recurring tasks past due date`, count: overdueRecurring.length });
+  const allIds = new Set(listTasks({}).map((t) => t.id));
+  const withParent = db.query("SELECT id, parent_id FROM tasks WHERE parent_id IS NOT NULL").all();
+  const orphaned = withParent.filter((t) => !allIds.has(t.parent_id));
+  if (orphaned.length > 0)
+    issues.push({ severity: "error", type: "orphaned_parents", message: `${orphaned.length} tasks reference non-existent parent IDs`, count: orphaned.length });
+  if (issues.length === 0)
+    issues.push({ severity: "info", type: "healthy", message: "No issues found" });
+  if (opts.json || globalOpts.json) {
+    console.log(JSON.stringify({ issues, ok: !issues.some((i) => i.severity === "error") }));
+    return;
+  }
+  console.log(chalk.bold(`todos doctor
+`));
+  for (const issue of issues) {
+    const icon = issue.severity === "error" ? chalk.red("\u2717") : issue.severity === "warn" ? chalk.yellow("\u26A0") : chalk.green("\u2713");
+    console.log(`  ${icon} ${issue.message}`);
+  }
+  const errors2 = issues.filter((i) => i.severity === "error").length;
+  const warns = issues.filter((i) => i.severity === "warn").length;
+  if (errors2 === 0 && warns === 0)
+    console.log(chalk.green(`
+  All clear.`));
+  else
+    console.log(chalk[errors2 > 0 ? "red" : "yellow"](`
+  ${errors2} error(s), ${warns} warning(s). Run with --fix to auto-resolve where possible.`));
+});
 program2.command("health").description("Check todos system health \u2014 database, config, connectivity").option("--json", "Output as JSON").action(async (opts) => {
   const globalOpts = program2.opts();
   const checks = [];

package/dist/mcp/index.js

@@ -6970,6 +6970,7 @@ var MINIMAL_TOOLS = new Set([
   "complete_task",
   "fail_task",
   "get_status",
+  "get_context",
   "get_task",
   "start_task",
   "add_comment",
@@ -8658,6 +8659,37 @@ if (shouldRegisterTool("set_task_priority")) {
     }
   });
 }
+if (shouldRegisterTool("get_context")) {
+  server.tool("get_context", "Get a compact task summary for agent prompt injection. Returns formatted text.", {
+    agent_id: exports_external.string().optional(),
+    project_id: exports_external.string().optional(),
+    format: exports_external.enum(["text", "compact"]).optional()
+  }, async ({ agent_id, project_id, format: _format }) => {
+    try {
+      const filters = {};
+      if (project_id)
+        filters.project_id = resolveId(project_id, "projects");
+      const status = getStatus(Object.keys(filters).length > 0 ? filters : undefined, agent_id);
+      const next = getNextTask(agent_id, Object.keys(filters).length > 0 ? filters : undefined);
+      const lines = [];
+      lines.push(`Tasks: ${status.pending} pending | ${status.in_progress} active | ${status.completed} done`);
+      if (status.stale_count > 0)
+        lines.push(`\u26A0 ${status.stale_count} stale tasks`);
+      if (status.overdue_recurring > 0)
+        lines.push(`\uD83D\uDD01 ${status.overdue_recurring} overdue recurring`);
+      if (status.active_work.length > 0) {
+        const active = status.active_work.slice(0, 3).map((w) => `${w.short_id || w.id.slice(0, 8)} (${w.assigned_to || "?"})`).join(", ");
+        lines.push(`Active: ${active}`);
+      }
+      if (next)
+        lines.push(`Next up: ${next.short_id || next.id.slice(0, 8)} [${next.priority}] ${next.title}`);
+      return { content: [{ type: "text", text: lines.join(`
+`) }] };
+    } catch (e) {
+      return { content: [{ type: "text", text: formatError(e) }], isError: true };
+    }
+  });
+}
 if (shouldRegisterTool("search_tools")) {
   server.tool("search_tools", "List all tool names, optionally filtered by substring.", { query: exports_external.string().optional() }, async ({ query }) => {
     const all = [
@@ -8719,6 +8751,7 @@ if (shouldRegisterTool("search_tools")) {
       "get_tasks_changed_since",
       "get_stale_tasks",
       "get_status",
+      "get_context",
       "decompose_task",
       "set_task_status",
       "set_task_priority",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/todos",
-  "version": "0.9.64",
+  "version": "0.9.66",
   "description": "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   "type": "module",
   "main": "dist/index.js",