@tomkapa/tayto 0.3.1 → 0.3.2

package/dist/{chunk-FUNYPBWJ.js → chunk-STYT4TGJ.js}

@@ -131,6 +131,10 @@ var UIDependencyType = {
   BlockedBy: "blocked-by"
 };
 var RANK_GAP = 1e3;
+function midpoint(a, b) {
+  const m = (a + b) / 2;
+  return m > a && m < b ? m : null;
+}
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
   TaskStatus.Done,
   TaskStatus.Cancelled
@@ -149,7 +153,8 @@ export {
   DependencyType,
   UIDependencyType,
   RANK_GAP,
+  midpoint,
   TERMINAL_STATUSES,
   isTerminalStatus
 };
-//# sourceMappingURL=chunk-FUNYPBWJ.js.map
+//# sourceMappingURL=chunk-STYT4TGJ.js.map

package/dist/{chunk-FUNYPBWJ.js.map → chunk-STYT4TGJ.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/logging/logger.ts","../src/types/enums.ts"],"sourcesContent":["import { appendFileSync, readdirSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { trace, type Span, SpanStatusCode } from '@opentelemetry/api';\n\nconst tracer = trace.getTracer('task');\nconst LOG_RETENTION_DAYS = 7;\n\nexport interface LogAttributes {\n  [key: string]: string | number | boolean;\n}\n\ntype LogLevel = 'INFO' | 'WARN' | 'ERROR';\n\nfunction formatTimestamp(): string {\n  return new Date().toISOString();\n}\n\nfunction formatAttrs(attrs?: LogAttributes): string {\n  if (!attrs || Object.keys(attrs).length === 0) return '';\n  return ' ' + JSON.stringify(attrs);\n}\n\nclass Logger {\n  private logFilePath: string | null = null;\n\n  init(logDir: string): void {\n    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD\n    this.logFilePath = join(logDir, `task-${date}.log`);\n    this.pruneOldLogs(logDir);\n  }\n\n  info(message: string, attrs?: LogAttributes): void {\n    this.write('INFO', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(message, attrs);\n    }\n  }\n\n  warn(message: string, attrs?: LogAttributes): void {\n    this.write('WARN', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`WARN: ${message}`, attrs);\n    }\n  }\n\n  error(message: string, error?: unknown, attrs?: LogAttributes): void {\n    const errorDetail = error instanceof Error ? ` | ${error.stack ?? error.message}` : '';\n    this.write('ERROR', `${message}${errorDetail}`, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`ERROR: ${message}`, attrs);\n      if (error instanceof Error) {\n        span.recordException(error);\n      }\n      span.setStatus({ code: SpanStatusCode.ERROR, message });\n    }\n  }\n\n  startSpan<T>(name: string, fn: (span: Span) => T): T {\n    return tracer.startActiveSpan(name, (span) => {\n      try {\n        const result = fn(span);\n        span.end();\n        return result;\n      } catch (e) {\n        if (e instanceof Error) {\n          span.recordException(e);\n        }\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        span.end();\n        throw e;\n      }\n    });\n  }\n\n  private write(level: LogLevel, message: string, attrs?: LogAttributes): void {\n    if (!this.logFilePath) return;\n    const line = `${formatTimestamp()} [${level}] ${message}${formatAttrs(attrs)}\\n`;\n    try {\n      appendFileSync(this.logFilePath, line);\n    } catch {\n      // Swallowing here is intentional: logging must never crash the app.\n      // If the log file is unwritable, the OTel span still captures the event.\n    }\n  }\n\n  private pruneOldLogs(logDir: string): void {\n    try {\n      const cutoff = Date.now() - LOG_RETENTION_DAYS * 24 * 60 * 60 * 1000;\n      const files = readdirSync(logDir).filter((f) => f.startsWith('task-') && f.endsWith('.log'));\n      for (const file of files) {\n        const dateStr = file.slice('task-'.length, -'.log'.length);\n        const fileDate = new Date(dateStr).getTime();\n        if (!isNaN(fileDate) && fileDate < cutoff) {\n          unlinkSync(join(logDir, file));\n        }\n      }\n    } catch {\n      // Best-effort cleanup — don't crash if pruning fails\n    }\n  }\n}\n\nexport const logger = new Logger();\n","export const TaskStatus = {\n  Backlog: 'backlog',\n  Todo: 'todo',\n  InProgress: 'in-progress',\n  Review: 'review',\n  Done: 'done',\n  Cancelled: 'cancelled',\n} as const;\nexport type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];\n\nexport const TaskType = {\n  Epic: 'epic',\n  Story: 'story',\n  TechDebt: 'tech-debt',\n  Bug: 'bug',\n} as const;\nexport type TaskType = (typeof TaskType)[keyof typeof TaskType];\n\n/**\n * Task level derived from type.\n * Level 1: epics (grouping/planning layer)\n * Level 2: stories, tech-debt, bugs (execution layer)\n */\nexport const TaskLevel = {\n  Epic: 1,\n  Work: 2,\n} as const;\nexport type TaskLevel = (typeof TaskLevel)[keyof typeof TaskLevel];\n\nconst TYPE_TO_LEVEL: Record<string, TaskLevel> = {\n  [TaskType.Epic]: TaskLevel.Epic,\n  [TaskType.Story]: TaskLevel.Work,\n  [TaskType.TechDebt]: TaskLevel.Work,\n  [TaskType.Bug]: TaskLevel.Work,\n};\n\nexport function getTaskLevel(type: string): TaskLevel {\n  return TYPE_TO_LEVEL[type] ?? TaskLevel.Work;\n}\n\n/** Types that belong to the work (level 2) execution layer. */\nexport const WORK_TYPES: ReadonlySet<string> = new Set([\n  TaskType.Story,\n  TaskType.TechDebt,\n  TaskType.Bug,\n]);\n\n/** Types stored in the database. */\nexport const DependencyType = {\n  Blocks: 'blocks',\n  RelatesTo: 'relates-to',\n  Duplicates: 'duplicates',\n} as const;\nexport type DependencyType = (typeof DependencyType)[keyof typeof DependencyType];\n\n/**\n * UI-level dependency types — includes BlockedBy which is a reverse-Blocks\n * relationship resolved before persisting to the database.\n */\nexport const UIDependencyType = {\n  ...DependencyType,\n  BlockedBy: 'blocked-by',\n} as const;\nexport type UIDependencyType = (typeof UIDependencyType)[keyof typeof UIDependencyType];\n\n/** Gap between consecutive rank values, used for insertion between neighbors. */\nexport const RANK_GAP = 1000.0;\n\n/** Statuses that represent terminal/completed task states. */\nexport const TERMINAL_STATUSES: ReadonlySet<string> = new Set([\n  TaskStatus.Done,\n  TaskStatus.Cancelled,\n]);\n\nexport function isTerminalStatus(status: string): boolean {\n  return TERMINAL_STATUSES.has(status);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/logging/logger.ts","../src/types/enums.ts"],"sourcesContent":["import { appendFileSync, readdirSync, unlinkSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { trace, type Span, SpanStatusCode } from '@opentelemetry/api';\n\nconst tracer = trace.getTracer('task');\nconst LOG_RETENTION_DAYS = 7;\n\nexport interface LogAttributes {\n  [key: string]: string | number | boolean;\n}\n\ntype LogLevel = 'INFO' | 'WARN' | 'ERROR';\n\nfunction formatTimestamp(): string {\n  return new Date().toISOString();\n}\n\nfunction formatAttrs(attrs?: LogAttributes): string {\n  if (!attrs || Object.keys(attrs).length === 0) return '';\n  return ' ' + JSON.stringify(attrs);\n}\n\nclass Logger {\n  private logFilePath: string | null = null;\n\n  init(logDir: string): void {\n    const date = new Date().toISOString().slice(0, 10); // YYYY-MM-DD\n    this.logFilePath = join(logDir, `task-${date}.log`);\n    this.pruneOldLogs(logDir);\n  }\n\n  info(message: string, attrs?: LogAttributes): void {\n    this.write('INFO', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(message, attrs);\n    }\n  }\n\n  warn(message: string, attrs?: LogAttributes): void {\n    this.write('WARN', message, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`WARN: ${message}`, attrs);\n    }\n  }\n\n  error(message: string, error?: unknown, attrs?: LogAttributes): void {\n    const errorDetail = error instanceof Error ? ` | ${error.stack ?? error.message}` : '';\n    this.write('ERROR', `${message}${errorDetail}`, attrs);\n    const span = trace.getActiveSpan();\n    if (span) {\n      span.addEvent(`ERROR: ${message}`, attrs);\n      if (error instanceof Error) {\n        span.recordException(error);\n      }\n      span.setStatus({ code: SpanStatusCode.ERROR, message });\n    }\n  }\n\n  startSpan<T>(name: string, fn: (span: Span) => T): T {\n    return tracer.startActiveSpan(name, (span) => {\n      try {\n        const result = fn(span);\n        span.end();\n        return result;\n      } catch (e) {\n        if (e instanceof Error) {\n          span.recordException(e);\n        }\n        span.setStatus({ code: SpanStatusCode.ERROR });\n        span.end();\n        throw e;\n      }\n    });\n  }\n\n  private write(level: LogLevel, message: string, attrs?: LogAttributes): void {\n    if (!this.logFilePath) return;\n    const line = `${formatTimestamp()} [${level}] ${message}${formatAttrs(attrs)}\\n`;\n    try {\n      appendFileSync(this.logFilePath, line);\n    } catch {\n      // Swallowing here is intentional: logging must never crash the app.\n      // If the log file is unwritable, the OTel span still captures the event.\n    }\n  }\n\n  private pruneOldLogs(logDir: string): void {\n    try {\n      const cutoff = Date.now() - LOG_RETENTION_DAYS * 24 * 60 * 60 * 1000;\n      const files = readdirSync(logDir).filter((f) => f.startsWith('task-') && f.endsWith('.log'));\n      for (const file of files) {\n        const dateStr = file.slice('task-'.length, -'.log'.length);\n        const fileDate = new Date(dateStr).getTime();\n        if (!isNaN(fileDate) && fileDate < cutoff) {\n          unlinkSync(join(logDir, file));\n        }\n      }\n    } catch {\n      // Best-effort cleanup — don't crash if pruning fails\n    }\n  }\n}\n\nexport const logger = new Logger();\n","export const TaskStatus = {\n  Backlog: 'backlog',\n  Todo: 'todo',\n  InProgress: 'in-progress',\n  Review: 'review',\n  Done: 'done',\n  Cancelled: 'cancelled',\n} as const;\nexport type TaskStatus = (typeof TaskStatus)[keyof typeof TaskStatus];\n\nexport const TaskType = {\n  Epic: 'epic',\n  Story: 'story',\n  TechDebt: 'tech-debt',\n  Bug: 'bug',\n} as const;\nexport type TaskType = (typeof TaskType)[keyof typeof TaskType];\n\n/**\n * Task level derived from type.\n * Level 1: epics (grouping/planning layer)\n * Level 2: stories, tech-debt, bugs (execution layer)\n */\nexport const TaskLevel = {\n  Epic: 1,\n  Work: 2,\n} as const;\nexport type TaskLevel = (typeof TaskLevel)[keyof typeof TaskLevel];\n\nconst TYPE_TO_LEVEL: Record<string, TaskLevel> = {\n  [TaskType.Epic]: TaskLevel.Epic,\n  [TaskType.Story]: TaskLevel.Work,\n  [TaskType.TechDebt]: TaskLevel.Work,\n  [TaskType.Bug]: TaskLevel.Work,\n};\n\nexport function getTaskLevel(type: string): TaskLevel {\n  return TYPE_TO_LEVEL[type] ?? TaskLevel.Work;\n}\n\n/** Types that belong to the work (level 2) execution layer. */\nexport const WORK_TYPES: ReadonlySet<string> = new Set([\n  TaskType.Story,\n  TaskType.TechDebt,\n  TaskType.Bug,\n]);\n\n/** Types stored in the database. */\nexport const DependencyType = {\n  Blocks: 'blocks',\n  RelatesTo: 'relates-to',\n  Duplicates: 'duplicates',\n} as const;\nexport type DependencyType = (typeof DependencyType)[keyof typeof DependencyType];\n\n/**\n * UI-level dependency types — includes BlockedBy which is a reverse-Blocks\n * relationship resolved before persisting to the database.\n */\nexport const UIDependencyType = {\n  ...DependencyType,\n  BlockedBy: 'blocked-by',\n} as const;\nexport type UIDependencyType = (typeof UIDependencyType)[keyof typeof UIDependencyType];\n\n/** Gap between consecutive rank values, used for insertion between neighbors. */\nexport const RANK_GAP = 1000.0;\n\n/**\n * Collapse-safe midpoint between two rank values. Returns `null` when\n * IEEE 754 double precision cannot represent a strictly-between value —\n * callers use this as a signal to rebalance the rank grid and retry.\n * Returning a number unconditionally would silently collide with an\n * endpoint and corrupt the task ordering.\n */\nexport function midpoint(a: number, b: number): number | null {\n  const m = (a + b) / 2;\n  return m > a && m < b ? m : null;\n}\n\n/** Statuses that represent terminal/completed task states. */\nexport const TERMINAL_STATUSES: ReadonlySet<string> = new Set([\n  TaskStatus.Done,\n  TaskStatus.Cancelled,\n]);\n\nexport function isTerminalStatus(status: string): boolean {\n  return TERMINAL_STATUSES.has(status);\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -10,8 +10,9 @@ import {
   WORK_TYPES,
   getTaskLevel,
   isTerminalStatus,
-  logger
-} from "./chunk-FUNYPBWJ.js";
+  logger,
+  midpoint
+} from "./chunk-STYT4TGJ.js";
 
 // src/config/index.ts
 import { mkdirSync } from "fs";
@@ -332,18 +333,9 @@ var SqliteTaskRepository = class {
       try {
         const now = (/* @__PURE__ */ new Date()).toISOString();
         const level = getTaskLevel(input.type);
-        const maxActiveResult = this.getMaxActiveRankByLevel(input.projectId, level);
-        if (!maxActiveResult.ok) return maxActiveResult;
-        const maxActiveRank = maxActiveResult.value;
-        const minTerminalResult = this.getMinTerminalRankByLevel(input.projectId, level);
-        if (!minTerminalResult.ok) return minTerminalResult;
-        const minTerminalRank = minTerminalResult.value;
-        let rank;
-        if (minTerminalRank !== null && minTerminalRank > maxActiveRank) {
-          rank = maxActiveRank > 0 ? (maxActiveRank + minTerminalRank) / 2 : minTerminalRank - RANK_GAP;
-        } else {
-          rank = maxActiveRank + RANK_GAP;
-        }
+        const rankResult = this.computeInsertRank(input.projectId, level);
+        if (!rankResult.ok) return rankResult;
+        const rank = rankResult.value;
         this.db.prepare(
           `INSERT INTO tasks (id, project_id, parent_id, name, description, type, status, rank, technical_notes, additional_requirements, created_at, updated_at)
              VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
@@ -630,6 +622,104 @@ _${now}_
       return err(new AppError("DB_ERROR", "Failed to get ranked non-terminal tasks by level", e));
     }
   }
+  rebalanceByLevel(projectId, level) {
+    return logger.startSpan("TaskRepository.rebalanceByLevel", () => {
+      try {
+        const types = this.getTypesForLevel(level);
+        const typePlaceholders = types.map(() => "?").join(", ");
+        const rows = this.db.prepare(
+          `SELECT * FROM tasks
+             WHERE project_id = ? AND ${NOT_DELETED} AND type IN (${typePlaceholders})
+             ORDER BY
+               CASE WHEN status IN (${TERMINAL_PLACEHOLDERS}) THEN 1 ELSE 0 END ASC,
+               rank ASC,
+               id ASC`
+        ).all(projectId, ...types, ...TERMINAL_STATUS_ARRAY);
+        if (rows.length === 0) return ok(void 0);
+        const now = (/* @__PURE__ */ new Date()).toISOString();
+        const updateStmt = this.db.prepare(
+          "UPDATE tasks SET rank = ?, updated_at = ? WHERE id = ?"
+        );
+        this.db.exec("BEGIN");
+        try {
+          for (let i = 0; i < rows.length; i++) {
+            const row = rows[i];
+            if (!row) continue;
+            const newRank = (i + 1) * RANK_GAP;
+            if (row.rank === newRank) continue;
+            updateStmt.run(newRank, now, row.id);
+          }
+          this.db.exec("COMMIT");
+        } catch (inner) {
+          this.db.exec("ROLLBACK");
+          throw inner;
+        }
+        return ok(void 0);
+      } catch (e) {
+        return err(new AppError("DB_ERROR", "Failed to rebalance ranks by level", e));
+      }
+    });
+  }
+  /**
+   * Fetch `(maxActive, minTerminal)` for a level in a single SQL round-trip.
+   * Used by the insert hot path — faster than calling the two separate
+   * level accessors in sequence.
+   */
+  getRankBoundsByLevel(projectId, level) {
+    try {
+      const types = this.getTypesForLevel(level);
+      const typePlaceholders = types.map(() => "?").join(", ");
+      const row = this.db.prepare(
+        `SELECT
+             MAX(CASE WHEN status NOT IN (${TERMINAL_PLACEHOLDERS}) THEN rank END) AS max_active,
+             MIN(CASE WHEN status IN (${TERMINAL_PLACEHOLDERS}) THEN rank END) AS min_terminal
+           FROM tasks
+           WHERE project_id = ? AND ${NOT_DELETED} AND type IN (${typePlaceholders})`
+      ).get(...TERMINAL_STATUS_ARRAY, ...TERMINAL_STATUS_ARRAY, projectId, ...types);
+      return ok({
+        maxActive: row?.max_active ?? 0,
+        minTerminal: row?.min_terminal ?? null
+      });
+    } catch (e) {
+      return err(new AppError("DB_ERROR", "Failed to get rank bounds by level", e));
+    }
+  }
+  /**
+   * Compute a fresh rank for a new active task at the given level.
+   *
+   * Wedges the new task between the last active task and the first terminal
+   * task. If the midpoint collapses against either endpoint, or if the
+   * level is already in a corrupt interleaved state (terminal rank ≤
+   * active rank), rebalance the level once and recompute.
+   */
+  computeInsertRank(projectId, level) {
+    const attempt = () => {
+      const boundsResult = this.getRankBoundsByLevel(projectId, level);
+      if (!boundsResult.ok) return boundsResult;
+      const { maxActive, minTerminal } = boundsResult.value;
+      if (minTerminal === null) {
+        return ok(maxActive + RANK_GAP);
+      }
+      if (minTerminal <= maxActive) {
+        return ok(null);
+      }
+      if (maxActive <= 0) {
+        return ok(minTerminal - RANK_GAP);
+      }
+      return ok(midpoint(maxActive, minTerminal));
+    };
+    const first = attempt();
+    if (!first.ok) return first;
+    if (first.value !== null) return ok(first.value);
+    const rebalanceResult = this.rebalanceByLevel(projectId, level);
+    if (!rebalanceResult.ok) return rebalanceResult;
+    const second = attempt();
+    if (!second.ok) return second;
+    if (second.value === null) {
+      return err(new AppError("DB_ERROR", "Rank computation did not converge after rebalance"));
+    }
+    return ok(second.value);
+  }
   search(query, projectId) {
     return logger.startSpan("TaskRepository.search", () => {
       try {
@@ -1001,7 +1091,11 @@ var RerankTaskSchema = z2.object({
   taskId: z2.string().min(1, "Task id is required"),
   afterId: z2.string().optional(),
   beforeId: z2.string().optional(),
-  position: z2.number().int().min(1).optional()
+  position: z2.number().int().min(1).optional(),
+  /** Move to the top of active tasks (highest priority). */
+  top: z2.boolean().optional(),
+  /** Move to the bottom of active tasks, kept above terminal (done/cancelled) tasks. */
+  bottom: z2.boolean().optional()
 });
 
 // src/service/task.service.ts
@@ -1224,13 +1318,13 @@ var TaskServiceImpl = class {
       if (!parsed.success) {
         return err(new AppError("VALIDATION", parsed.error.message));
       }
-      const { taskId, afterId, beforeId, position } = parsed.data;
-      const specifiedCount = [afterId, beforeId, position].filter((v) => v !== void 0).length;
+      const { taskId, afterId, beforeId, position, top, bottom } = parsed.data;
+      const specifiedCount = [afterId, beforeId, position].filter((v) => v !== void 0).length + (top ? 1 : 0) + (bottom ? 1 : 0);
       if (specifiedCount !== 1) {
         return err(
           new AppError(
             "VALIDATION",
-            "Exactly one of --after, --before, or --position must be specified"
+            "Exactly one of --after, --before, --position, --top, or --bottom must be specified"
           )
         );
       }
@@ -1253,77 +1347,102 @@ var TaskServiceImpl = class {
       const projectResult = this.projectService.resolveProject(projectRef);
       if (!projectResult.ok) return projectResult;
       const projectId = projectResult.value.id;
-      const rankedResult = this.repo.getRankedNonTerminalTasksByLevel(projectId, taskLevel);
-      if (!rankedResult.ok) return rankedResult;
-      const ranked = rankedResult.value.filter((t) => t.id !== taskId);
-      let newRank;
-      if (afterId) {
-        const anchor = ranked.find((t) => t.id === afterId);
-        if (!anchor) {
-          return err(
-            new AppError("NOT_FOUND", `Anchor task not found among active tasks: ${afterId}`)
-          );
+      const depService = this.getDependencyService();
+      const blockersResult = depService.listBlockers(taskId);
+      if (!blockersResult.ok) return blockersResult;
+      const constrainingBlockers = blockersResult.value.filter(
+        (b) => !isTerminalStatus(b.status) && b.projectId === projectId
+      );
+      const dependentsResult = depService.listDependents(taskId);
+      if (!dependentsResult.ok) return dependentsResult;
+      const constrainingDependents = dependentsResult.value.filter(
+        (d) => !isTerminalStatus(d.status) && d.projectId === projectId
+      );
+      const attempt = () => {
+        const rankedResult = this.repo.getRankedNonTerminalTasksByLevel(projectId, taskLevel);
+        if (!rankedResult.ok) return rankedResult;
+        const ranked = rankedResult.value.filter((t) => t.id !== taskId);
+        if (top === true) {
+          return ok(this.computeTopRank(ranked, constrainingBlockers));
         }
-        const anchorIndex = ranked.indexOf(anchor);
-        const next = ranked[anchorIndex + 1];
-        newRank = next ? (anchor.rank + next.rank) / 2 : anchor.rank + RANK_GAP;
-      } else if (beforeId) {
-        const anchor = ranked.find((t) => t.id === beforeId);
-        if (!anchor) {
-          return err(
-            new AppError("NOT_FOUND", `Anchor task not found among active tasks: ${beforeId}`)
+        if (bottom === true) {
+          const minTerminalResult = this.repo.getMinTerminalRankByLevel(projectId, taskLevel);
+          if (!minTerminalResult.ok) return minTerminalResult;
+          return ok(
+            this.computeBottomRank(ranked, minTerminalResult.value, constrainingDependents)
           );
         }
-        const anchorIndex = ranked.indexOf(anchor);
-        const prev = ranked[anchorIndex - 1];
-        newRank = prev ? (prev.rank + anchor.rank) / 2 : anchor.rank - RANK_GAP;
-      } else {
+        if (afterId) {
+          const anchorIndex = ranked.findIndex((t) => t.id === afterId);
+          const anchor = ranked[anchorIndex];
+          if (!anchor) {
+            return err(
+              new AppError("NOT_FOUND", `Anchor task not found among active tasks: ${afterId}`)
+            );
+          }
+          const next = ranked[anchorIndex + 1];
+          return ok(next ? midpoint(anchor.rank, next.rank) : anchor.rank + RANK_GAP);
+        }
+        if (beforeId) {
+          const anchorIndex = ranked.findIndex((t) => t.id === beforeId);
+          const anchor = ranked[anchorIndex];
+          if (!anchor) {
+            return err(
+              new AppError("NOT_FOUND", `Anchor task not found among active tasks: ${beforeId}`)
+            );
+          }
+          const prev = ranked[anchorIndex - 1];
+          return ok(prev ? midpoint(prev.rank, anchor.rank) : anchor.rank - RANK_GAP);
+        }
         const pos = position;
         if (pos < 1) {
           return err(new AppError("VALIDATION", "Position must be >= 1"));
         }
         if (pos === 1) {
-          const first = ranked[0];
-          newRank = first ? first.rank - RANK_GAP : RANK_GAP;
-        } else if (pos > ranked.length) {
-          const last = ranked[ranked.length - 1];
-          newRank = last ? last.rank + RANK_GAP : RANK_GAP;
-        } else {
-          const above = ranked[pos - 2];
-          const below = ranked[pos - 1];
-          if (!above || !below) {
-            return err(new AppError("DB_ERROR", "Unexpected missing neighbor tasks"));
-          }
-          newRank = (above.rank + below.rank) / 2;
+          return ok(this.computeTopRank(ranked));
+        }
+        if (pos > ranked.length) {
+          const minTerminalResult = this.repo.getMinTerminalRankByLevel(projectId, taskLevel);
+          if (!minTerminalResult.ok) return minTerminalResult;
+          return ok(this.computeBottomRank(ranked, minTerminalResult.value));
+        }
+        const above = ranked[pos - 2];
+        const below = ranked[pos - 1];
+        if (!above || !below) {
+          return err(new AppError("DB_ERROR", "Unexpected missing neighbor tasks"));
+        }
+        return ok(midpoint(above.rank, below.rank));
+      };
+      let computed = attempt();
+      if (!computed.ok) return computed;
+      if (computed.value === null) {
+        const rb = this.repo.rebalanceByLevel(projectId, taskLevel);
+        if (!rb.ok) return rb;
+        computed = attempt();
+        if (!computed.ok) return computed;
+        if (computed.value === null) {
+          return err(new AppError("DB_ERROR", "Rank computation did not converge after rebalance"));
         }
       }
-      const depService = this.getDependencyService();
-      const blockersResult = depService.listBlockers(taskId);
-      if (blockersResult.ok) {
-        for (const blocker of blockersResult.value) {
-          if (isTerminalStatus(blocker.status)) continue;
-          if (blocker.projectId === projectId && newRank < blocker.rank) {
-            return err(
-              new AppError(
-                "VALIDATION",
-                `Cannot rank above blocker "${blocker.id}" (${blocker.name}). Complete or remove the dependency first.`
-              )
-            );
-          }
+      const newRank = computed.value;
+      for (const blocker of constrainingBlockers) {
+        if (newRank < blocker.rank) {
+          return err(
+            new AppError(
+              "VALIDATION",
+              `Cannot rank above blocker "${blocker.id}" (${blocker.name}). Complete or remove the dependency first.`
+            )
+          );
         }
       }
-      const dependentsResult = depService.listDependents(taskId);
-      if (dependentsResult.ok) {
-        for (const dep of dependentsResult.value) {
-          if (isTerminalStatus(dep.status)) continue;
-          if (dep.projectId === projectId && newRank > dep.rank) {
-            return err(
-              new AppError(
-                "VALIDATION",
-                `Cannot rank below dependent "${dep.id}" (${dep.name}). Complete or remove the dependency first.`
-              )
-            );
-          }
+      for (const dep of constrainingDependents) {
+        if (newRank > dep.rank) {
+          return err(
+            new AppError(
+              "VALIDATION",
+              `Cannot rank below dependent "${dep.id}" (${dep.name}). Complete or remove the dependency first.`
+            )
+          );
         }
       }
       return this.repo.rerank(taskId, newRank);
@@ -1343,6 +1462,48 @@ var TaskServiceImpl = class {
       return this.repo.search(query, projectId);
     });
   }
+  /**
+   * Rank for placing a task at the top of the active list. Clamps to
+   * "immediately after the highest-ranked blocker" when blockers exist
+   * rather than returning a value that would fail validation.
+   *
+   * Returns `null` to signal FP precision collapse (caller rebalances).
+   */
+  computeTopRank(ranked, constrainingBlockers = []) {
+    if (constrainingBlockers.length > 0) {
+      const highestBlocker = constrainingBlockers.reduce((a, b) => a.rank > b.rank ? a : b);
+      const idx = ranked.findIndex((t) => t.id === highestBlocker.id);
+      if (idx >= 0) {
+        const next = ranked[idx + 1];
+        return next ? midpoint(highestBlocker.rank, next.rank) : highestBlocker.rank + RANK_GAP;
+      }
+    }
+    const first = ranked[0];
+    return first ? first.rank - RANK_GAP : RANK_GAP;
+  }
+  /**
+   * Rank for placing a task at the bottom of the active list.
+   * - Stays above terminal tasks: terminal tasks live at `maxRank + RANK_GAP`
+   *   so a naive `last.rank + RANK_GAP` would collide with the most-recently
+   *   completed task.
+   * - Clamps above any dependents rather than failing validation.
+   *
+   * `minTerminal` is passed in so this helper stays pure (no DB access).
+   * Returns `null` to signal FP precision collapse.
+   */
+  computeBottomRank(ranked, minTerminal, constrainingDependents = []) {
+    if (constrainingDependents.length > 0) {
+      const lowestDependent = constrainingDependents.reduce((a, b) => a.rank < b.rank ? a : b);
+      const idx = ranked.findIndex((t) => t.id === lowestDependent.id);
+      if (idx >= 0) {
+        const prev = ranked[idx - 1];
+        return prev ? midpoint(prev.rank, lowestDependent.rank) : lowestDependent.rank - RANK_GAP;
+      }
+    }
+    const last = ranked[ranked.length - 1];
+    if (!last) return RANK_GAP;
+    return minTerminal !== null && minTerminal > last.rank ? midpoint(last.rank, minTerminal) : last.rank + RANK_GAP;
+  }
   /**
    * Auto-propagate status to the parent task after a child status change.
    * - If a child moves to in-progress and parent is backlog/todo → parent becomes in-progress.
@@ -2003,14 +2164,16 @@ function registerTaskBreakdown(parent, container) {
 
 // src/cli/commands/task/rank.ts
 function registerTaskRank(parent, container) {
-  parent.command("rank <id>").description("Re-rank a task in the backlog (Jira-style positioning)").option("--after <taskId>", "Place immediately after this task").option("--before <taskId>", "Place immediately before this task").option("--position <n>", "Place at 1-based position in backlog").option("-p, --project <project>", "Project id or name").action(
+  parent.command("rank <id>").description("Re-rank a task in the backlog (Jira-style positioning)").option("--after <taskId>", "Place immediately after this task").option("--before <taskId>", "Place immediately before this task").option("--position <n>", "Place at 1-based position in backlog").option("--top", "Move to the top of active tasks").option("--bottom", "Move to the bottom of active tasks (above done tasks)").option("-p, --project <project>", "Project id or name").action(
     (id, opts) => {
       const result = container.taskService.rerankTask(
         {
           taskId: id,
           afterId: opts.after,
           beforeId: opts.before,
-          position: opts.position ? parseInt(opts.position, 10) : void 0
+          position: opts.position ? parseInt(opts.position, 10) : void 0,
+          top: opts.top,
+          bottom: opts.bottom
         },
         opts.project
       );
@@ -2156,7 +2319,7 @@ function buildCLI(container) {
   registerDepList(dep, container);
   registerDepGraph(dep, container);
   program.command("tui").description("Launch interactive terminal UI").option("-p, --project <project>", "Start with specific project").action(async (opts) => {
-    const { launchTUI } = await import("./tui-5JJH67YY.js");
+    const { launchTUI } = await import("./tui-JEP3F4JS.js");
     await launchTUI(container, opts.project);
   });
   return program;
@@ -2172,7 +2335,7 @@ async function main() {
   const container = createContainer(db, config.dbPath);
   const args = process.argv.slice(2);
   if (args.length === 0) {
-    const { launchTUI } = await import("./tui-5JJH67YY.js");
+    const { launchTUI } = await import("./tui-JEP3F4JS.js");
     await launchTUI(container);
   } else {
     const program = buildCLI(container);