@hasna/todos 0.15.47 → 0.15.49

package/dist/cli/commands/query-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiPzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QA6sGrD"}
+{"version":3,"file":"query-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmPzC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAkwGrD"}

package/dist/cli/index.js

@@ -2123,7 +2123,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/todos",
-    version: "0.15.47",
+    version: "0.15.49",
     description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
     type: "module",
     main: "dist/index.js",
@@ -2187,6 +2187,7 @@ var init_package = __esm(() => {
     ],
     scripts: {
       build: "rm -rf dist dashboard/dist && cd dashboard && bun install --frozen-lockfile && bun run build && cd .. && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts src/project-registration.ts src/task-manifest.ts src/task-subtree-transfer.ts --outdir dist --root src --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
+      "build:js": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts src/project-registration.ts src/task-manifest.ts src/task-subtree-transfer.ts --outdir dist --root src --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && tsc --emitDeclarationOnly --outDir dist",
       "build:server": "rm -rf dist && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun --external '@hasna/contracts' --external '@hasna/contracts/*' && bun build src/index.ts src/mcp.ts src/registry.ts src/contracts.ts src/storage.ts src/testing.ts src/project-registration.ts src/task-manifest.ts src/task-subtree-transfer.ts --outdir dist --target bun --external '@hasna/contracts' --external '@hasna/contracts/*'",
       migrate: "bun run src/server/index.ts migrate",
       "backfill:comment-redaction": "bun run src/server/index.ts redact-comments",
@@ -2241,7 +2242,7 @@ var init_package = __esm(() => {
     author: "Andrei Hasna <andrei@hasna.com>",
     license: "Apache-2.0",
     dependencies: {
-      "@hasna/contracts": "0.13.4",
+      "@hasna/contracts": "0.14.0",
       "@hasna/events": "^0.1.11",
       "@modelcontextprotocol/sdk": "^1.12.1",
       chalk: "^5.4.1",
@@ -2851,13 +2852,15 @@ function upsertSecretSafetyConfig(input) {
   saveConfig({ ...config, secret_safety: next });
   return next;
 }
-var DEFAULT_SECRET_PATTERNS, DEFAULT_SECRET_KEY_PATTERN, NON_SECRET_USAGE_KEYS, REDACTION_PLACEHOLDER;
+var XAI_PREFIX, DEFAULT_SECRET_PATTERNS, DEFAULT_SECRET_KEY_PATTERN, NON_SECRET_USAGE_KEYS, REDACTION_PLACEHOLDER;
 var init_redaction = __esm(() => {
   init_config();
+  XAI_PREFIX = ["x", "ai", "-"].join("");
   DEFAULT_SECRET_PATTERNS = [
     { name: "aws-access-key", regex: /\b(AKIA|ASIA)[0-9A-Z]{16}\b/g, replacement: "[REDACTED_AWS_KEY]" },
     { name: "private-key", regex: /-----BEGIN (?:RSA |EC |OPENSSH |)PRIVATE KEY-----[\s\S]*?-----END (?:RSA |EC |OPENSSH |)PRIVATE KEY-----/g, replacement: "[REDACTED_PRIVATE_KEY]" },
     { name: "openai-token", regex: /\bsk-[A-Za-z0-9_-]{12,}\b/g, replacement: "[REDACTED_TOKEN]" },
+    { name: `${XAI_PREFIX}token`, regex: /\bxai[-][A-Za-z0-9]{20,80}\b/g, replacement: "[REDACTED_TOKEN]" },
     { name: "npm-token", regex: /\bnpm_[A-Za-z0-9]{20,}\b/g, replacement: "[REDACTED_NPM_TOKEN]" },
     { name: "github-fine-grained-token", regex: /\bgithub_pat_[A-Za-z0-9_]{20,}\b/g, replacement: "[REDACTED_GITHUB_TOKEN]" },
     { name: "github-token", regex: /\bgh[opsu]_[A-Za-z0-9]{20,}\b/g, replacement: "[REDACTED_GITHUB_TOKEN]" },
@@ -18314,6 +18317,12 @@ function listTasks(filter = {}, db) {
   const d = db || getDatabase();
   const { clearExpiredLocks: clearExpiredLocks2 } = (init_database(), __toCommonJS(exports_database));
   clearExpiredLocks2(d);
+  if (filter.limit !== undefined) {
+    const limit = filter.limit;
+    if (!Number.isSafeInteger(limit) || limit <= 0 || limit > MAX_TASK_LIST_LIMIT) {
+      throw new TypeError(`listTasks limit must be a positive integer between 1 and ${MAX_TASK_LIST_LIMIT}; got ${String(limit)}`);
+    }
+  }
   const conditions = [];
   const params = [];
   if (filter.project_id) {
@@ -18847,6 +18856,7 @@ function deleteTask(id, db) {
   }
   return result.changes > 0;
 }
+var MAX_TASK_LIST_LIMIT = 1e5;
 var init_task_crud = __esm(() => {
   init_types();
   init_database();
@@ -21798,7 +21808,8 @@ __export(exports_tasks, {
   buildTaskBoardSnapshot: () => buildTaskBoardSnapshot,
   archiveTasks: () => archiveTasks,
   archiveCompletedTasks: () => archiveCompletedTasks,
-  addDependency: () => addDependency
+  addDependency: () => addDependency,
+  MAX_TASK_LIST_LIMIT: () => MAX_TASK_LIST_LIMIT
 });
 var init_tasks = __esm(() => {
   init_task_crud();
@@ -32238,6 +32249,27 @@ var init_project_commands = __esm(() => {
   };
 });
 
+// src/storage/postgres-errors.ts
+function isPostgresUniqueViolation(error) {
+  if (typeof error !== "object" || error === null)
+    return false;
+  const candidate = error;
+  const states = [candidate.code, candidate.errno, candidate.sqlState, candidate.sqlstate];
+  if (typeof candidate.cause === "object" && candidate.cause !== null) {
+    const cause = candidate.cause;
+    states.push(cause.code, cause.errno, cause.sqlState, cause.sqlstate);
+  }
+  return states.some((state) => String(state) === "23505");
+}
+function postgresConstraintName(error) {
+  if (typeof error !== "object" || error === null)
+    return "";
+  const candidate = error;
+  const cause = typeof candidate.cause === "object" && candidate.cause !== null ? candidate.cause : undefined;
+  const constraint = candidate.constraint ?? candidate.constraint_name ?? cause?.constraint ?? cause?.constraint_name;
+  return typeof constraint === "string" ? constraint : "";
+}
+
 // src/storage/postgres-sync.ts
 function postgresTodosSyncSchemaSql(tableName = DEFAULT_TODOS_POSTGRES_SYNC_TABLE, cursorTableName = DEFAULT_TODOS_POSTGRES_CURSOR_TABLE) {
   assertSafeIdentifier(tableName);
@@ -32432,53 +32464,98 @@ class PostgresTodosSyncStore {
     if (routingErrors.length > 0) {
       throw new Error(`Invalid snapshot routing metadata: ${routingErrors.join("; ")}`);
     }
-    const existing = await this.client.query(`SELECT object_type, object_id, payload, updated_at, deleted_at, source_machine_id, version
-       FROM ${this.tableName}
-       WHERE service = $1 AND object_type IN ($2, $3) AND deleted_at IS NULL`, [this.service, "projects", "task_lists"]);
-    const existingProjects = [];
-    const existingTaskLists = [];
-    for (const row of existing.rows) {
-      const payload = payloadRecord(row.payload);
-      if (row.object_type === "projects")
-        existingProjects.push(payload);
-      if (row.object_type === "task_lists")
-        existingTaskLists.push(payload);
-    }
-    const destinationErrors = validateSnapshotRoutingDestinationConflicts(snapshot.projects, snapshot.taskLists, existingProjects, existingTaskLists);
-    if (destinationErrors.length > 0) {
-      throw new Error(`Snapshot routing conflicts with destination: ${destinationErrors.join("; ")}`);
-    }
-    const result = { records: 0, objectTypes: {} };
-    const sourceMachineId = context.requestId ?? this.sourceMachineId ?? null;
-    for (const entry of snapshotEntries(snapshot)) {
-      if (entry.deletedAt === null)
-        assertCanonicalScopedSlugEntry(entry);
-      await this.client.query(`INSERT INTO ${this.tableName} (
-          service, object_type, object_id, payload, updated_at,
-          deleted_at, source_machine_id, version
-        ) VALUES ($1, $2, $3, $4::jsonb, $5::timestamptz, $6::timestamptz, $7, $8)
-        ON CONFLICT (service, object_type, object_id) DO UPDATE SET
-          payload = EXCLUDED.payload,
-          updated_at = EXCLUDED.updated_at,
-          deleted_at = EXCLUDED.deleted_at,
-          source_machine_id = EXCLUDED.source_machine_id,
-          version = EXCLUDED.version
-        WHERE ${this.tableName}.updated_at < EXCLUDED.updated_at
-           OR (${this.tableName}.updated_at = EXCLUDED.updated_at
-               AND COALESCE(${this.tableName}.version, 0) <= COALESCE(EXCLUDED.version, 0))`, [
-        this.service,
-        entry.type,
-        entry.id,
-        entry.payload,
-        entry.updatedAt,
-        entry.deletedAt,
-        sourceMachineId,
-        entry.version
-      ]);
-      result.records += 1;
-      result.objectTypes[entry.type] = (result.objectTypes[entry.type] ?? 0) + 1;
+    const push = async (client) => {
+      const existing = await client.query(`SELECT object_type, object_id, payload, updated_at, deleted_at, source_machine_id, version
+         FROM ${this.tableName}
+         WHERE service = $1 AND object_type IN ($2, $3) AND deleted_at IS NULL`, [this.service, "projects", "task_lists"]);
+      const existingProjects = [];
+      const existingTaskLists = [];
+      for (const row of existing.rows) {
+        const payload = payloadRecord(row.payload);
+        if (row.object_type === "projects")
+          existingProjects.push(payload);
+        if (row.object_type === "task_lists")
+          existingTaskLists.push(payload);
+      }
+      const destinationErrors = validateSnapshotRoutingDestinationConflicts(snapshot.projects, snapshot.taskLists, existingProjects, existingTaskLists);
+      if (destinationErrors.length > 0) {
+        throw new ResourceConflictError("SNAPSHOT_DESTINATION_CONFLICT", `Snapshot routing conflicts with destination: ${destinationErrors.join("; ")}`);
+      }
+      const result = { records: 0, objectTypes: {} };
+      const sourceMachineId = context.requestId ?? this.sourceMachineId ?? null;
+      for (const entry of snapshotEntries(snapshot)) {
+        if (entry.deletedAt === null)
+          assertCanonicalScopedSlugEntry(entry);
+        try {
+          await client.query(`INSERT INTO ${this.tableName} (
+              service, object_type, object_id, payload, updated_at,
+              deleted_at, source_machine_id, version
+            ) VALUES ($1, $2, $3, $4::jsonb, $5::timestamptz, $6::timestamptz, $7, $8)
+            ON CONFLICT (service, object_type, object_id) DO UPDATE SET
+              payload = EXCLUDED.payload,
+              updated_at = EXCLUDED.updated_at,
+              deleted_at = EXCLUDED.deleted_at,
+              source_machine_id = EXCLUDED.source_machine_id,
+              version = EXCLUDED.version
+            WHERE ${this.tableName}.updated_at < EXCLUDED.updated_at
+               OR (${this.tableName}.updated_at = EXCLUDED.updated_at
+                   AND COALESCE(${this.tableName}.version, 0) <= COALESCE(EXCLUDED.version, 0))`, [
+            this.service,
+            entry.type,
+            entry.id,
+            entry.payload,
+            entry.updatedAt,
+            entry.deletedAt,
+            sourceMachineId,
+            entry.version
+          ]);
+        } catch (error) {
+          await this.classifySyncInsertConflict(error, entry);
+        }
+        result.records += 1;
+        result.objectTypes[entry.type] = (result.objectTypes[entry.type] ?? 0) + 1;
+      }
+      return result;
+    };
+    if (typeof this.client.transaction === "function") {
+      return this.client.transaction((client) => push(client));
     }
-    return result;
+    return push(this.client);
+  }
+  async classifySyncInsertConflict(error, entry) {
+    if (!isPostgresUniqueViolation(error))
+      throw error;
+    const payload = entry.payload;
+    const taskListSlug = String(payload["slug"] ?? "");
+    const projectSlug = String(payload["task_list_id"] ?? "");
+    const constraintName = postgresConstraintName(error);
+    if (entry.type === "projects" && constraintName.includes("project_task_list_slug_uidx")) {
+      throw new ResourceConflictError("PROJECT_SLUG_CONFLICT", `Project slug "${projectSlug}" already exists`);
+    }
+    if (entry.type === "task_lists" && constraintName.includes("task_list_scope_slug_uidx")) {
+      throw new ResourceConflictError("TASK_LIST_SLUG_CONFLICT", `Task list with slug "${taskListSlug}" already exists in this scope`);
+    }
+    if (entry.type === "task_lists") {
+      const scope = typeof payload["project_id"] === "string" ? payload["project_id"] : "";
+      const conflict = await this.client.query(`/* todos:classify-sync-task-list-conflict */ SELECT EXISTS (
+          SELECT 1 FROM ${this.tableName}
+          WHERE service = $1 AND object_type = 'task_lists' AND object_id <> $2
+            AND deleted_at IS NULL AND COALESCE(payload->>'project_id','') = $3 AND payload->>'slug' = $4
+        ) AS conflict`, [this.service, entry.id, scope, taskListSlug]);
+      if (conflict.rows[0]?.conflict) {
+        throw new ResourceConflictError("TASK_LIST_SLUG_CONFLICT", `Task list with slug "${taskListSlug}" already exists in this scope`);
+      }
+    } else if (entry.type === "projects") {
+      const conflict = await this.client.query(`/* todos:classify-sync-project-conflict */ SELECT EXISTS (
+          SELECT 1 FROM ${this.tableName}
+          WHERE service = $1 AND object_type = 'projects' AND object_id <> $2
+            AND deleted_at IS NULL AND payload->>'task_list_id' = $3
+        ) AS conflict`, [this.service, entry.id, projectSlug]);
+      if (conflict.rows[0]?.conflict) {
+        throw new ResourceConflictError("PROJECT_SLUG_CONFLICT", `Project slug "${projectSlug}" already exists`);
+      }
+    }
+    throw error;
   }
   async pullSnapshot(options = {}) {
     const params = [this.service];
@@ -32635,6 +32712,7 @@ function assertSafeIdentifier(value) {
 }
 var DEFAULT_TODOS_POSTGRES_SYNC_TABLE = "todos_sync_records", DEFAULT_TODOS_POSTGRES_CURSOR_TABLE = "todos_sync_cursors", PostgresScopedSlugMigrationConflictError, PostgresScopedSlugIndexBuildError;
 var init_postgres_sync = __esm(() => {
+  init_types();
   PostgresScopedSlugMigrationConflictError = class PostgresScopedSlugMigrationConflictError extends Error {
     conflicts;
     constructor(conflicts) {
@@ -35199,25 +35277,6 @@ async function retryOnTransientPostgresError(fn, attempts = 2, delayMs = 150) {
   }
   throw lastError;
 }
-function isPostgresUniqueViolation(error) {
-  if (typeof error !== "object" || error === null)
-    return false;
-  const candidate = error;
-  const states = [candidate.code, candidate.errno, candidate.sqlState, candidate.sqlstate];
-  if (typeof candidate.cause === "object" && candidate.cause !== null) {
-    const cause = candidate.cause;
-    states.push(cause.code, cause.errno, cause.sqlState, cause.sqlstate);
-  }
-  return states.some((state) => String(state) === "23505");
-}
-function postgresConstraintName(error) {
-  if (typeof error !== "object" || error === null)
-    return "";
-  const candidate = error;
-  const cause = typeof candidate.cause === "object" && candidate.cause !== null ? candidate.cause : undefined;
-  const constraint = candidate.constraint ?? candidate.constraint_name ?? cause?.constraint ?? cause?.constraint_name;
-  return typeof constraint === "string" ? constraint : "";
-}
 var CLOUD_LOCK_EXPIRY_MINUTES = 30, TASK_ORDER_TIEBREAK = "CASE payload->>'priority' WHEN 'critical' THEN 0 WHEN 'high' THEN 1 WHEN 'medium' THEN 2 WHEN 'low' THEN 3 ELSE 4 END ASC, payload->>'created_at' ASC, payload->>'id' ASC", TASK_ORDER_BY, TRANSIENT_POSTGRES_SQLSTATES, TRANSIENT_POSTGRES_MESSAGE_MARKERS;
 var init_postgres_adapter = __esm(() => {
   init_types();
@@ -52194,6 +52253,13 @@ function resolveSigningSecret(env = process.env) {
 function isPostgresBackendConfigured(env = process.env) {
   return Boolean(resolveCloudDatabaseUrl(env));
 }
+function schemaRetryMinIntervalMs(env = process.env) {
+  const raw = env.HASNA_TODOS_SCHEMA_RETRY_MIN_MS;
+  if (!raw)
+    return DEFAULT_SCHEMA_RETRY_MIN_MS;
+  const parsed = Number(raw);
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : DEFAULT_SCHEMA_RETRY_MIN_MS;
+}
 function getCloudTenantId() {
   return process.env.HASNA_TODOS_TENANT_ID ?? "default";
 }
@@ -52289,6 +52355,10 @@ function getCloudVerifier() {
 async function ensureCloudSchema() {
   if (schemaEnsured)
     return schemaEnsured;
+  if (lastSchemaFailure !== null && Date.now() - lastSchemaAttemptAtMs < schemaRetryMinIntervalMs()) {
+    throw lastSchemaFailure;
+  }
+  lastSchemaAttemptAtMs = Date.now();
   schemaEnsured = (async () => {
     const client = getClient();
     for (const sql of postgresTodosSyncSchemaSql()) {
@@ -52309,6 +52379,7 @@ async function ensureCloudSchema() {
     await getApiKeyStore().ensureSchema();
   })().catch((error) => {
     schemaEnsured = null;
+    lastSchemaFailure = error;
     throw error;
   });
   return schemaEnsured;
@@ -52356,8 +52427,10 @@ async function closeCloud() {
   cachedTaskManifestAuthority = null;
   cachedTaskSubtreeTransferAuthority = null;
   schemaEnsured = null;
+  lastSchemaAttemptAtMs = 0;
+  lastSchemaFailure = null;
 }
-var TODOS_APP_SLUG = "todos", cachedClient = null, cachedAdapter = null, cachedStore = null, cachedVerifier = null, cachedPrGroupLedger = null, cachedProjectRegistrationAuthority = null, cachedTaskManifestAuthority = null, cachedTaskSubtreeTransferAuthority = null, schemaEnsured = null;
+var TODOS_APP_SLUG = "todos", cachedClient = null, cachedAdapter = null, cachedStore = null, cachedVerifier = null, cachedPrGroupLedger = null, cachedProjectRegistrationAuthority = null, cachedTaskManifestAuthority = null, cachedTaskSubtreeTransferAuthority = null, schemaEnsured = null, lastSchemaAttemptAtMs = 0, lastSchemaFailure = null, DEFAULT_SCHEMA_RETRY_MIN_MS = 1e4;
 var init_cloud = __esm(() => {
   init_cloud_client();
   init_postgres_adapter();
@@ -53223,6 +53296,19 @@ function taskStatusQueryParam(url) {
     return { ok: false, message: result.message };
   return { ok: true, value: collapseEnumValues(result.values) };
 }
+function parsePaginationQueryParam(url, name) {
+  const raw = url.searchParams.get(name);
+  if (raw === null)
+    return { ok: true, value: undefined };
+  const min = name === "limit" ? 1 : 0;
+  const message = name === "limit" ? "limit must be a positive integer" : "offset must be a non-negative integer";
+  if (!/^\d+$/.test(raw))
+    return { ok: false, message };
+  const value = Number(raw);
+  if (!Number.isSafeInteger(value) || value < min)
+    return { ok: false, message };
+  return { ok: true, value };
+}
 async function handleListTasks(_req, url, _ctx, json5, taskToSummary2) {
   const statusParam = taskStatusQueryParam(url);
   if (!statusParam.ok)
@@ -53230,16 +53316,20 @@ async function handleListTasks(_req, url, _ctx, json5, taskToSummary2) {
   const projectId = url.searchParams.get("project_id") || undefined;
   const sessionId = url.searchParams.get("session_id") || undefined;
   const agentId = url.searchParams.get("agent_id") || undefined;
-  const limitParam = url.searchParams.get("limit");
-  const offsetParam = url.searchParams.get("offset");
+  const limitParam = parsePaginationQueryParam(url, "limit");
+  if (!limitParam.ok)
+    return json5({ error: limitParam.message }, 400);
+  const offsetParam = parsePaginationQueryParam(url, "offset");
+  if (!offsetParam.ok)
+    return json5({ error: offsetParam.message }, 400);
   const fields = parseFieldsParam(url);
   const tasks = listTasks({
     status: statusParam.value,
     project_id: projectId,
     session_id: sessionId,
     agent_id: agentId,
-    limit: limitParam ? parseInt(limitParam, 10) : undefined,
-    offset: offsetParam ? parseInt(offsetParam, 10) : undefined
+    limit: limitParam.value,
+    offset: offsetParam.value
   });
   return json5(tasks.map((t) => taskToSummary2(t, fields)));
 }
@@ -54031,6 +54121,12 @@ class TodosShadowOutbox {
       this.onEvent?.({ type: "mirrored", objectType: row.object_type, id: row.object_id, lagMs });
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
+      if (error instanceof ResourceConflictError) {
+        this.metrics.lastError = message;
+        this.db.run(`UPDATE shadow_outbox SET attempts=?, last_error=?, status='failed' WHERE seq=? AND revision=?`, [row.attempts + 1, message, row.seq, row.revision]);
+        this.onEvent?.({ type: "parked", objectType: row.object_type, id: row.object_id, error: message });
+        return;
+      }
       this.metrics.retries += 1;
       this.metrics.lastError = message;
       const attempts = row.attempts + 1;
@@ -54158,6 +54254,7 @@ function createTodosShadowOutbox(options) {
 }
 var MAX_BACKOFF_MS;
 var init_shadow_outbox = __esm(() => {
+  init_types();
   init_local_sqlite();
   init_postgres_sync();
   init_shadow_outbox_schema();
@@ -58132,6 +58229,26 @@ function parseSinceCursor(raw) {
   }
   return { ok: true, value: new Date(parsed).toISOString() };
 }
+function paginationQueryParam(url, name) {
+  const raw = url.searchParams.get(name);
+  if (raw === null)
+    return { ok: true, value: undefined };
+  const min = name === "limit" ? 1 : 0;
+  if (!/^\d+$/.test(raw)) {
+    return {
+      ok: false,
+      response: error(400, name === "limit" ? "limit must be a positive integer" : "offset must be a non-negative integer")
+    };
+  }
+  const value = Number(raw);
+  if (!Number.isSafeInteger(value) || value < min) {
+    return {
+      ok: false,
+      response: error(400, name === "limit" ? "limit must be a positive integer" : "offset must be a non-negative integer")
+    };
+  }
+  return { ok: true, value };
+}
 function validateTaskCompletion(value) {
   if (!value || typeof value !== "object" || Array.isArray(value))
     return { ok: false, message: "completion body must be an object" };
@@ -58660,6 +58777,12 @@ async function handleV1Request(req, url, dependencies = {}) {
           if (updatedAfter !== null && !updatedAfter.ok) {
             return error(400, updatedAfter.message);
           }
+          const limitParam = paginationQueryParam(url, "limit");
+          if (!limitParam.ok)
+            return limitParam.response;
+          const offsetParam = paginationQueryParam(url, "offset");
+          if (!offsetParam.ok)
+            return offsetParam.response;
           const filter = {
             ...updatedAfter !== null && updatedAfter.ok ? { updated_after: updatedAfter.value } : {},
             ...url.searchParams.get("q") ? { query: url.searchParams.get("q") } : {},
@@ -58676,8 +58799,8 @@ async function handleV1Request(req, url, dependencies = {}) {
             ...url.searchParams.get("tags") ? {
               tags: url.searchParams.get("tags").split(",").map((tag) => tag.trim()).filter(Boolean)
             } : {},
-            ...url.searchParams.get("limit") ? { limit: Number(url.searchParams.get("limit")) } : {},
-            ...url.searchParams.get("offset") ? { offset: Number(url.searchParams.get("offset")) } : {}
+            ...limitParam.value !== undefined ? { limit: limitParam.value } : {},
+            ...offsetParam.value !== undefined ? { offset: offsetParam.value } : {}
           };
           const tasks = await store.tasks.list(filter);
           const { limit: _l, offset: _o, ...countFilter } = filter;
@@ -60437,8 +60560,8 @@ function registerTaskCrudTools(server, ctx) {
       tags: exports_external.array(exports_external.string()).optional().describe("Filter by tags (AND logic)"),
       created_after: exports_external.string().optional().describe("ISO date \u2014 tasks created after this date"),
       created_before: exports_external.string().optional().describe("ISO date \u2014 tasks created before this date"),
-      limit: exports_external.number().optional().describe("Max results (default: 50, max 500)"),
-      offset: exports_external.number().optional().describe("Pagination offset"),
+      limit: exports_external.number().int().min(1).optional().describe("Max results (default: 50, max 500)"),
+      offset: exports_external.number().int().min(0).optional().describe("Pagination offset"),
       metadata: exports_external.record(exports_external.unknown()).optional().describe("Exact top-level metadata filters")
     }, async (params) => {
       try {
@@ -62400,6 +62523,48 @@ var init_task_relationships = __esm(() => {
   ];
 });
 
+// src/lib/dedupe-projection.ts
+function projectTasksForDedupe(tasks) {
+  return tasks.map((task2) => {
+    const metadata = {};
+    for (const key2 of DEDUPE_SOURCE_KEY_ALLOWLIST) {
+      if (key2 in task2.metadata) {
+        metadata[key2] = redactValue(task2.metadata[key2]);
+      }
+    }
+    return {
+      id: task2.id,
+      short_id: task2.short_id,
+      title: redactEvidenceText(task2.title),
+      description: task2.description === null || task2.description === undefined ? null : redactEvidenceText(task2.description),
+      status: task2.status,
+      created_at: task2.created_at,
+      updated_at: task2.updated_at,
+      project_id: task2.project_id,
+      task_list_id: task2.task_list_id,
+      assigned_to: task2.assigned_to,
+      priority: task2.priority,
+      metadata
+    };
+  });
+}
+var DEDUPE_SOURCE_KEY_ALLOWLIST;
+var init_dedupe_projection = __esm(() => {
+  init_redaction();
+  DEDUPE_SOURCE_KEY_ALLOWLIST = [
+    "github_url",
+    "github_issue_url",
+    "github_pr_url",
+    "source_url",
+    "url",
+    "external_url",
+    "issue_url",
+    "github_owner",
+    "github_repo",
+    "github_number"
+  ];
+});
+
 // src/lib/task-dedupe.ts
 function asObject(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : {};
@@ -62564,10 +62729,10 @@ function olderFirst(left, right) {
 function findDuplicateTasks(options = {}, db) {
   const d = db || getDatabase();
   const threshold = options.threshold ?? DEFAULT_THRESHOLD;
-  const fingerprints = listTasks({
+  const fingerprints = projectTasksForDedupe(listTasks({
     include_archived: Boolean(options.include_archived),
     limit: options.limit ?? 1000
-  }, d).map(fingerprint);
+  }, d)).map(fingerprint);
   const candidates = [];
   for (let i = 0;i < fingerprints.length; i++) {
     for (let j = i + 1;j < fingerprints.length; j++) {
@@ -62802,6 +62967,7 @@ var init_task_dedupe = __esm(() => {
   init_database();
   init_task_relationships();
   init_tasks();
+  init_dedupe_projection();
   STOP_WORDS = new Set([
     "a",
     "an",
@@ -87273,13 +87439,25 @@ Findings`));
       handleError(e);
     }
   });
+  function parseDedupeLimit(raw) {
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value <= 0 || value > MAX_TASK_LIST_LIMIT) {
+      return null;
+    }
+    return value;
+  }
   const dedupe2 = program2.command("dedupe").description("Find and merge likely duplicate local tasks");
   dedupe2.command("scan").description("Scan local tasks for likely duplicates").option("--threshold <n>", "Minimum duplicate score from 0 to 1", "0.74").option("--limit <n>", "Maximum tasks to compare", "1000").option("--include-archived", "Include archived tasks").option("-j, --json", "Output as JSON").action((opts) => {
     const globalOpts = program2.opts();
     try {
+      const limit = parseDedupeLimit(opts.limit);
+      if (limit === null) {
+        handleError(new Error(`--limit must be a positive integer between 1 and ${MAX_TASK_LIST_LIMIT} (got: ${opts.limit})`));
+        return;
+      }
       const candidates = findDuplicateTasks({
         threshold: Number(opts.threshold),
-        limit: Number(opts.limit),
+        limit,
         include_archived: Boolean(opts.includeArchived)
       });
       if (opts.json || globalOpts.json) {
@@ -87299,6 +87477,35 @@ Findings`));
       handleError(e);
     }
   });
+  dedupe2.command("project <ref>").description("Project a project's tasks into the bounded dedup projection (safe to emit: no free-form metadata, tags, comments, or run fields)").option("--limit <n>", "Maximum tasks to project", "1000").option("--include-archived", "Include archived tasks").option("-j, --json", "Output as JSON").action((ref, opts) => {
+    const globalOpts = program2.opts();
+    try {
+      const d = getDatabase();
+      const projectId = resolvePartialId(d, "projects", ref) || d.query("SELECT id FROM projects WHERE path = ? OR name = ? OR task_list_id = ?").get(ref, ref, ref)?.id;
+      if (!projectId) {
+        handleError(new Error(`Could not resolve project: ${ref}`));
+        return;
+      }
+      const limit = parseDedupeLimit(opts.limit);
+      if (limit === null) {
+        handleError(new Error(`--limit must be a positive integer between 1 and ${MAX_TASK_LIST_LIMIT} (got: ${opts.limit})`));
+        return;
+      }
+      const tasks = listTasks({
+        project_id: projectId,
+        include_archived: Boolean(opts.includeArchived),
+        limit
+      }, d);
+      const projected = projectTasksForDedupe(tasks);
+      if (opts.json || globalOpts.json) {
+        output({ project_id: projectId, count: projected.length, tasks: projected }, true);
+        return;
+      }
+      console.log(chalk9.dim(`${projected.length} task(s) projected for dedupe (bounded \u2014 no free-form metadata, tags, comments, or run fields).`));
+    } catch (e) {
+      handleError(e);
+    }
+  });
   dedupe2.command("merge <primary-task-id> <duplicate-task-id>").description("Merge a duplicate task into a primary task and archive the duplicate").option("--agent <agent>", "Agent ID recording the merge").option("--reason <reason>", "Human-readable merge reason").option("-j, --json", "Output as JSON").action((primaryTaskId, duplicateTaskId, opts) => {
     const globalOpts = program2.opts();
     try {
@@ -87603,6 +87810,7 @@ var init_query_commands = __esm(() => {
   init_audit();
   init_handoffs();
   init_task_dedupe();
+  init_dedupe_projection();
   init_local_fields();
   init_workflow_states();
   init_local_reports();
@@ -95508,6 +95716,12 @@ class TodosShadowMirror {
       const message = error2 instanceof Error ? error2.message : String(error2);
       const objectType2 = op.kind === "upsert" ? SNAPSHOT_TO_OBJECT_TYPE[op.key] : op.objectType;
       const id = op.kind === "upsert" ? String(op.record["id"]) : op.id;
+      if (error2 instanceof ResourceConflictError) {
+        this.metrics.failed += 1;
+        this.metrics.lastError = message;
+        this.onEvent?.({ type: "dropped", objectType: objectType2, id, error: message });
+        return;
+      }
       this.metrics.retries += 1;
       this.metrics.lastError = message;
       op.attempts += 1;
@@ -95755,6 +95969,7 @@ function isAgent(value) {
 }
 var SNAPSHOT_TO_OBJECT_TYPE;
 var init_shadow = __esm(() => {
+  init_types();
   init_local_sqlite();
   init_postgres_sync();
   SNAPSHOT_TO_OBJECT_TYPE = {