@hasna/todos 0.15.29 → 0.15.32

package/dist/registry.js

@@ -7917,6 +7917,46 @@ function guardPlanRowsSqlite(planIds, db) {
   }
 }
 
+// src/lib/task-parent-integrity.ts
+function parentCycleError(taskId, parentId) {
+  return new ResourceConflictError("TASK_PARENT_CYCLE", `TASK_PARENT_CYCLE: assigning parent ${parentId} to task ${taskId} would create or retain a parent cycle`);
+}
+function assertTaskParentIntegrity(taskId, parentId, getTask) {
+  if (parentId === undefined || parentId === null)
+    return;
+  const visited = new Set;
+  let cursor = parentId;
+  while (cursor) {
+    if (cursor === taskId || visited.has(cursor)) {
+      throw parentCycleError(taskId, parentId);
+    }
+    visited.add(cursor);
+    const parent = getTask(cursor);
+    if (!parent)
+      throw new TaskNotFoundError(cursor);
+    cursor = parent.parent_id;
+  }
+}
+async function assertTaskParentIntegrityAsync(taskId, parentId, getTask) {
+  if (parentId === undefined || parentId === null)
+    return;
+  const visited = new Set;
+  let cursor = parentId;
+  while (cursor) {
+    if (cursor === taskId || visited.has(cursor)) {
+      throw parentCycleError(taskId, parentId);
+    }
+    visited.add(cursor);
+    const parent = await getTask(cursor);
+    if (!parent)
+      throw new TaskNotFoundError(cursor);
+    cursor = parent.parent_id;
+  }
+}
+var init_task_parent_integrity = __esm(() => {
+  init_types();
+});
+
 // src/lib/creator-identity.ts
 function canonicalAgentRef(value) {
   return value.trim().toLowerCase();
@@ -9440,6 +9480,7 @@ function createTaskStored(input, d) {
   let id = uuid();
   for (let attempt = 0;attempt < 3; attempt++) {
     try {
+      assertTaskParentIntegrity(id, input.parent_id, (candidateId) => getTask(candidateId, d));
       d.run(`INSERT INTO tasks (id, short_id, project_id, parent_id, plan_id, task_list_id, cycle_id, title, description, status, priority, agent_id, assigned_to, session_id, working_dir, tags, metadata, version, created_at, updated_at, due_at, estimated_minutes, sla_minutes, confidence, retry_count, max_retries, retry_after, requires_approval, approved_by, approved_at, recurrence_rule, recurrence_parent_id, spawns_template_id, reason, spawned_from_session, assigned_by, created_by, assigned_from_project, task_type, machine_id)
          VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
         id,
@@ -9818,6 +9859,7 @@ function updateTaskStored(id, input, db) {
     throw new VersionConflictError(id, input.version, task.version);
   }
   input = sanitizeUpdateTaskInput(input);
+  assertTaskParentIntegrity(id, input.parent_id, (candidateId) => getTask(candidateId, d));
   const effectivePlanId = input.plan_id !== undefined ? input.plan_id : task.plan_id;
   const linkedProjectId = linkedPlanProjectId(effectivePlanId, d);
   if (linkedProjectId) {
@@ -9871,6 +9913,10 @@ function updateTaskStored(id, input, db) {
     sets.push("project_id = ?");
     params.push(input.project_id);
   }
+  if (input.parent_id !== undefined) {
+    sets.push("parent_id = ?");
+    params.push(input.parent_id);
+  }
   if (input.assigned_to !== undefined) {
     sets.push("assigned_to = ?");
     params.push(input.assigned_to);
@@ -9986,6 +10032,8 @@ function updateTaskStored(id, input, db) {
     logTaskChange(id, "update", "priority", task.priority, input.priority, agentId, d);
   if (input.title !== undefined && input.title !== task.title)
     logTaskChange(id, "update", "title", task.title, input.title, agentId, d);
+  if (input.parent_id !== undefined && input.parent_id !== task.parent_id)
+    logTaskChange(id, "update", "parent_id", task.parent_id, input.parent_id, agentId, d);
   if (input.assigned_to !== undefined && input.assigned_to !== task.assigned_to)
     logTaskChange(id, "update", "assigned_to", task.assigned_to, input.assigned_to, agentId, d);
   if (input.working_dir !== undefined && input.working_dir !== task.working_dir)
@@ -10043,7 +10091,8 @@ function updateTask(id, input, db) {
   if (!before)
     throw new TaskNotFoundError(id);
   const guardedPlanIds = [before.plan_id, input.plan_id];
-  if (!guardedPlanIds.some(Boolean))
+  const needsSerializedWrite = input.parent_id !== undefined || guardedPlanIds.some(Boolean);
+  if (!needsSerializedWrite)
     return updateTaskStored(id, input, d);
   return d.transaction(() => {
     guardPlanRowsSqlite(guardedPlanIds, d);
@@ -10079,6 +10128,7 @@ var init_task_crud = __esm(() => {
   init_checklists();
   init_storage_tombstones();
   init_prewrite_secrets();
+  init_task_parent_integrity();
 });
 
 // src/db/task-status.ts
@@ -12670,7 +12720,7 @@ var init_tasks = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/todos",
-  version: "0.15.29",
+  version: "0.15.32",
   description: "Universal task management for AI coding agents - CLI + MCP server + interactive TUI",
   type: "module",
   main: "dist/index.js",

package/dist/release-provenance.json

@@ -1,9 +1,9 @@
 {
   "packageName": "@hasna/todos",
-  "packageVersion": "0.15.29",
+  "packageVersion": "0.15.32",
   "repository": "https://github.com/hasna/todos.git",
-  "gitCommit": "f83953cfacc6e5d584c34b49299a6ebc97842a47",
-  "gitTree": "c1eb2cec20d22100cb2207a89efdb5c1f72cc52b",
-  "sourceTreeSha256": "60993895f109cd5f3f073d753761f6354456793cc0f998517565b36e1126ae03",
-  "generatedAt": "2026-08-11T19:03:26.000Z"
+  "gitCommit": "1d458a0ef6acb9e821cba89b3b7cf1ae316781d7",
+  "gitTree": "c8bbdfbedab0c0af164640532aaaebc102441968",
+  "sourceTreeSha256": "defc279f0e698221d01999e646dfa52f5012c930cfa97fb20a596c936ad21060",
+  "generatedAt": "2026-08-12T17:50:57.000Z"
 }

package/dist/sdk/index.d.ts

@@ -10,7 +10,7 @@
 export { TodosClient, createClient } from "./client.js";
 export type { TodosClientOptions } from "./client.js";
 export { TodosV1Client, ApiError as TodosV1ApiError } from "./v1.generated.js";
-export type { TodosV1ClientOptions, Task as TodosV1Task, Project as TodosV1Project, TaskManifestBindingLookupRequest as TodosV1TaskManifestBindingLookupRequest, TaskManifestBindingLookupResult as TodosV1TaskManifestBindingLookupResult, TaskManifestBindingLookupResponse as TodosV1TaskManifestBindingLookupResponse, TaskComment as TodosV1TaskComment, CreateTaskInput as TodosV1CreateTaskInput, UpdateTaskInput as TodosV1UpdateTaskInput, FailTaskInput as TodosV1FailTaskInput, TaskFailureResult as TodosV1TaskFailureResult, CreateProjectInput as TodosV1CreateProjectInput, ProjectTaskListEnsureApplyInput as TodosV1ProjectTaskListEnsureApplyInput, ProjectTaskListRollbackInput as TodosV1ProjectTaskListRollbackInput, ProjectTaskListEnsureReceipt as TodosV1ProjectTaskListEnsureReceipt, ProjectTaskListEnsureResult as TodosV1ProjectTaskListEnsureResult, ProjectTaskListRollbackResult as TodosV1ProjectTaskListRollbackResult, CreateTaskCommentInput as TodosV1CreateTaskCommentInput, AdmitPrGroupInput as TodosV1AdmitPrGroupInput, RecoverPrGroupInput as TodosV1RecoverPrGroupInput, AppendPrGroupEventInput as TodosV1AppendPrGroupEventInput, PrGroupCiProof as TodosV1PrGroupCiProof, PrGroupCleanupProof as TodosV1PrGroupCleanupProof, PrGroupRecord as TodosV1PrGroupRecord, PrGroupAttemptRecord as TodosV1PrGroupAttemptRecord, PrGroupEventRecord as TodosV1PrGroupEventRecord, PrGroupStateView as TodosV1PrGroupStateView, PrGroupEventPage as TodosV1PrGroupEventPage, PrGroupMutationResult as TodosV1PrGroupMutationResult, } from "./v1.generated.js";
+export type { TodosV1ClientOptions, Task as TodosV1Task, Project as TodosV1Project, TaskManifestBindingLookupRequest as TodosV1TaskManifestBindingLookupRequest, TaskManifestBindingLookupResult as TodosV1TaskManifestBindingLookupResult, TaskManifestBindingLookupResponse as TodosV1TaskManifestBindingLookupResponse, ProjectRegistrationCapability as TodosV1ProjectRegistrationCapability, ProjectRegistrationReceipt as TodosV1ProjectRegistrationReceipt, ProjectRegistrationRequest as TodosV1ProjectRegistrationRequest, ProjectRegistrationLookupRequest as TodosV1ProjectRegistrationLookupRequest, ProjectResource as TodosV1ProjectResource, ProjectResourcePage as TodosV1ProjectResourcePage, TaskComment as TodosV1TaskComment, CreateTaskInput as TodosV1CreateTaskInput, UpdateTaskInput as TodosV1UpdateTaskInput, FailTaskInput as TodosV1FailTaskInput, TaskFailureResult as TodosV1TaskFailureResult, CreateProjectInput as TodosV1CreateProjectInput, ProjectTaskListEnsureApplyInput as TodosV1ProjectTaskListEnsureApplyInput, ProjectTaskListRollbackInput as TodosV1ProjectTaskListRollbackInput, ProjectTaskListEnsureReceipt as TodosV1ProjectTaskListEnsureReceipt, ProjectTaskListEnsureResult as TodosV1ProjectTaskListEnsureResult, ProjectTaskListRollbackResult as TodosV1ProjectTaskListRollbackResult, CreateTaskCommentInput as TodosV1CreateTaskCommentInput, AdmitPrGroupInput as TodosV1AdmitPrGroupInput, RecoverPrGroupInput as TodosV1RecoverPrGroupInput, AppendPrGroupEventInput as TodosV1AppendPrGroupEventInput, PrGroupCiProof as TodosV1PrGroupCiProof, PrGroupCleanupProof as TodosV1PrGroupCleanupProof, PrGroupRecord as TodosV1PrGroupRecord, PrGroupAttemptRecord as TodosV1PrGroupAttemptRecord, PrGroupEventRecord as TodosV1PrGroupEventRecord, PrGroupStateView as TodosV1PrGroupStateView, PrGroupEventPage as TodosV1PrGroupEventPage, PrGroupMutationResult as TodosV1PrGroupMutationResult, } from "./v1.generated.js";
 export type { AdmitPrGroupInput, AppendPrGroupEventInput, PrGroupAdapterViews, PrGroupAttemptRecord, PrGroupCiProof, PrGroupCleanupProof, PrGroupDecisionEnvelopeAdapter, PrGroupEventListOptions, PrGroupEventPage, PrGroupEventRecord, PrGroupEvidenceRefAdapter, PrGroupMutationResult, PrGroupProofBundleAdapter, PrGroupRecord, PrGroupStateView, PrGroupWorkRunAdapter, RecoverPrGroupInput, } from "../pr-groups/types.js";
 export { TodosAPIError, TodosNotFoundError, TodosConflictError, TodosUnauthorizedError, TodosRateLimitError, TodosTimeoutError, } from "./types.js";
 export type { SSEEvent, CursorPage, ListOptions, TaskListResponse, TaskStatusResponse, TaskNextResponse, TaskActiveResponse, TaskStaleResponse, TaskChangedResponse, TaskContextResponse, TaskProgressResponse, TaskAttachmentsResponse, TaskFailResponse, TaskBulkResponse, AgentMeResponse, AgentQueueResponse, OrgNode, PlanWithTasks, ReportResponse, DoctorResponse, DoctorIssue, } from "./types.js";

package/dist/sdk/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,EAAE,aAAa,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,oBAAoB,EACpB,IAAI,IAAI,WAAW,EACnB,OAAO,IAAI,cAAc,EACzB,gCAAgC,IAAI,uCAAuC,EAC3E,+BAA+B,IAAI,sCAAsC,EACzE,iCAAiC,IAAI,wCAAwC,EAC7E,WAAW,IAAI,kBAAkB,EACjC,eAAe,IAAI,sBAAsB,EACzC,eAAe,IAAI,sBAAsB,EACzC,aAAa,IAAI,oBAAoB,EACrC,iBAAiB,IAAI,wBAAwB,EAC7C,kBAAkB,IAAI,yBAAyB,EAC/C,+BAA+B,IAAI,sCAAsC,EACzE,4BAA4B,IAAI,mCAAmC,EACnE,4BAA4B,IAAI,mCAAmC,EACnE,2BAA2B,IAAI,kCAAkC,EACjE,6BAA6B,IAAI,oCAAoC,EACrE,sBAAsB,IAAI,6BAA6B,EACvD,iBAAiB,IAAI,wBAAwB,EAC7C,mBAAmB,IAAI,0BAA0B,EACjD,uBAAuB,IAAI,8BAA8B,EACzD,cAAc,IAAI,qBAAqB,EACvC,mBAAmB,IAAI,0BAA0B,EACjD,aAAa,IAAI,oBAAoB,EACrC,oBAAoB,IAAI,2BAA2B,EACnD,kBAAkB,IAAI,yBAAyB,EAC/C,gBAAgB,IAAI,uBAAuB,EAC3C,gBAAgB,IAAI,uBAAuB,EAC3C,qBAAqB,IAAI,4BAA4B,GACtD,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,OAAO,EAAE,aAAa,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EACV,oBAAoB,EACpB,IAAI,IAAI,WAAW,EACnB,OAAO,IAAI,cAAc,EACzB,gCAAgC,IAAI,uCAAuC,EAC3E,+BAA+B,IAAI,sCAAsC,EACzE,iCAAiC,IAAI,wCAAwC,EAC7E,6BAA6B,IAAI,oCAAoC,EACrE,0BAA0B,IAAI,iCAAiC,EAC/D,0BAA0B,IAAI,iCAAiC,EAC/D,gCAAgC,IAAI,uCAAuC,EAC3E,eAAe,IAAI,sBAAsB,EACzC,mBAAmB,IAAI,0BAA0B,EACjD,WAAW,IAAI,kBAAkB,EACjC,eAAe,IAAI,sBAAsB,EACzC,eAAe,IAAI,sBAAsB,EACzC,aAAa,IAAI,oBAAoB,EACrC,iBAAiB,IAAI,wBAAwB,EAC7C,kBAAkB,IAAI,yBAAyB,EAC/C,+BAA+B,IAAI,sCAAsC,EACzE,4BAA4B,IAAI,mCAAmC,EACnE,4BAA4B,IAAI,mCAAmC,EACnE,2BAA2B,IAAI,kCAAkC,EACjE,6BAA6B,IAAI,oCAAoC,EACrE,sBAAsB,IAAI,6BAA6B,EACvD,iBAAiB,IAAI,wBAAwB,EAC7C,mBAAmB,IAAI,0BAA0B,EACjD,uBAAuB,IAAI,8BAA8B,EACzD,cAAc,IAAI,qBAAqB,EACvC,mBAAmB,IAAI,0BAA0B,EACjD,aAAa,IAAI,oBAAoB,EACrC,oBAAoB,IAAI,2BAA2B,EACnD,kBAAkB,IAAI,yBAAyB,EAC/C,gBAAgB,IAAI,uBAAuB,EAC3C,gBAAgB,IAAI,uBAAuB,EAC3C,qBAAqB,IAAI,4BAA4B,GACtD,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,iBAAiB,EACjB,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,8BAA8B,EAC9B,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/sdk/index.js

@@ -652,6 +652,77 @@ class TodosClient {
 function createClient(options) {
   return new TodosClient(options);
 }
+// src/project-registration/types.ts
+class TodosProjectRegistrationError extends Error {
+  code;
+  details;
+  constructor(code, message, details = {}) {
+    super(message);
+    this.code = code;
+    this.details = details;
+    this.name = "TodosProjectRegistrationError";
+  }
+}
+
+// src/project-registration/adoption-validation.ts
+var VALIDATION_KEYS = [
+  "valid",
+  "resource_kind",
+  "target_id",
+  "source_receipt_id",
+  "accepted_receipt_id",
+  "source_outcome",
+  "created_at",
+  "current_revision",
+  "accepted_result_digest"
+];
+function isRecord(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function isNonEmptyString(value) {
+  return typeof value === "string" && value.length > 0;
+}
+function hasExactKeys(value, expected) {
+  const actual = Object.keys(value).sort();
+  const wanted = [...expected].sort();
+  return actual.length === wanted.length && actual.every((key, index) => key === wanted[index]);
+}
+function adoptionRejected(message) {
+  throw new TodosProjectRegistrationError("TODOS_PROJECT_REGISTRATION_ADOPTION_REJECTED", `TODOS_PROJECT_REGISTRATION_ADOPTION_REJECTED: ${message}`);
+}
+function assertTodosPriorRegistrationAdoptionValidationEnvelope(value, input) {
+  if (!isRecord(input) || !hasExactKeys(input, [
+    "source_request",
+    "source_receipt",
+    "current_record"
+  ])) {
+    adoptionRejected("prior-adoption validation input is incomplete");
+  }
+  const request = input["source_request"];
+  const receipt = input["source_receipt"];
+  const current = input["current_record"];
+  if (!isRecord(request) || !isRecord(receipt) || !isRecord(current)) {
+    adoptionRejected("prior-adoption validation input records are incomplete");
+  }
+  const resourceKind = request["resource_kind"];
+  const sourceOutcome = receipt["outcome"];
+  const acceptedReceiptId = sourceOutcome === "accepted" ? receipt["receipt_id"] : sourceOutcome === "duplicate_of_accepted" ? receipt["duplicate_of_receipt_id"] : null;
+  if (resourceKind !== "project" && resourceKind !== "task_list" || request["direction"] !== "forward" || sourceOutcome !== "accepted" && sourceOutcome !== "duplicate_of_accepted" || !isNonEmptyString(acceptedReceiptId) || !isNonEmptyString(receipt["receipt_id"]) || !isNonEmptyString(receipt["target_id"]) || !isNonEmptyString(receipt["result_revision"]) || !isNonEmptyString(receipt["result_digest"]) || !isNonEmptyString(current["id"]) || !isNonEmptyString(current["created_at"]) || !isNonEmptyString(current["updated_at"]) || receipt["authority"] !== "todos" || receipt["route"] !== request["authority_route"] || receipt["package_version"] !== request["package_version"] || receipt["authority_id"] !== request["authority_id"] || receipt["tenant_id"] !== request["tenant_id"] || receipt["corpus_id"] !== request["corpus_id"] || receipt["operation_id"] !== request["operation_id"] || receipt["step_id"] !== request["step_id"] || receipt["resource_kind"] !== resourceKind || receipt["direction"] !== "forward" || receipt["idempotency_key"] !== request["idempotency_key"] || receipt["request_digest"] !== request["request_digest"] || receipt["precondition_digest"] !== request["precondition_digest"] || receipt["accepted_receipt_id"] !== null || receipt["target_id"] !== current["id"] || receipt["result_revision"] !== current["created_at"]) {
+    adoptionRejected("prior-adoption validation input does not carry one complete accepted receipt and current target incarnation");
+  }
+  if (sourceOutcome === "accepted" && receipt["duplicate_of_receipt_id"] !== null || sourceOutcome === "duplicate_of_accepted" && receipt["duplicate_of_receipt_id"] !== acceptedReceiptId) {
+    adoptionRejected("prior-adoption validation source receipt lineage is incomplete");
+  }
+  if (!isRecord(value) || !hasExactKeys(value, ["validation"]) || !isRecord(value["validation"]) || !hasExactKeys(value["validation"], VALIDATION_KEYS)) {
+    adoptionRejected("prior-adoption validation response envelope is incomplete");
+  }
+  const validation = value["validation"];
+  if (validation["valid"] !== true || validation["resource_kind"] !== resourceKind || validation["target_id"] !== current["id"] || validation["source_receipt_id"] !== receipt["receipt_id"] || validation["accepted_receipt_id"] !== acceptedReceiptId || validation["source_outcome"] !== sourceOutcome || validation["created_at"] !== current["created_at"] || validation["current_revision"] !== current["updated_at"] || validation["accepted_result_digest"] !== receipt["result_digest"]) {
+    adoptionRejected("prior-adoption validation response does not prove the exact accepted receipt and current target");
+  }
+  return validation;
+}
+
 // src/sdk/v1.generated.ts
 class ApiError extends Error {
   status;
@@ -805,6 +876,65 @@ class TodosV1Client {
       init
     });
   }
+  async getProjectRegistrationCapability(init) {
+    return this.request("GET", `/v1/project-registration/capability`, {
+      body: undefined,
+      query: undefined,
+      init
+    });
+  }
+  async compensateProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/compensate`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async createProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/create`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async readExactProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/read-exact`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async lookupProjectRegistrationReceipt(body, init) {
+    return this.request("POST", `/v1/project-registration/receipts/lookup`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async listProjectRegistrationResources(query, init) {
+    return this.request("GET", `/v1/project-registration/resources`, {
+      body: undefined,
+      query,
+      init
+    });
+  }
+  async validatePriorRegistrationAdoption(body, init) {
+    const response = await this.request("POST", `/v1/project-registration/validate-prior-adoption`, {
+      body,
+      query: undefined,
+      init
+    });
+    return {
+      validation: assertTodosPriorRegistrationAdoptionValidationEnvelope(response, body)
+    };
+  }
+  async verifyInverseProjectRegistrationResource(body, init) {
+    return this.request("POST", `/v1/project-registration/verify-inverse`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
   async listProjects(init) {
     return this.request("GET", `/v1/projects`, {
       body: undefined,
@@ -917,6 +1047,13 @@ class TodosV1Client {
       init
     });
   }
+  async applyTaskManifest(body, init) {
+    return this.request("POST", `/v1/task-manifest/apply`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
   async lookupTaskManifestBinding(body, init) {
     return this.request("POST", `/v1/task-manifest/bindings/lookup`, {
       body,
@@ -931,6 +1068,20 @@ class TodosV1Client {
       init
     });
   }
+  async compensateTaskManifest(body, init) {
+    return this.request("POST", `/v1/task-manifest/compensate`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
+  async readExactTaskManifest(body, init) {
+    return this.request("POST", `/v1/task-manifest/read-exact`, {
+      body,
+      query: undefined,
+      init
+    });
+  }
   async listTasks(query, init) {
     return this.request("GET", `/v1/tasks`, {
       body: undefined,

package/dist/sdk/v1.generated.d.ts

@@ -46,6 +46,10 @@ export interface TaskManifestCapability {
     "tenant_id": string;
     "backend": "sqlite" | "postgresql" | "http";
     "deterministic_ids": true;
+    "operation_step_identity": true;
+    "deterministic_idempotency_keys": true;
+    "terminal_nonacceptance_receipts": true;
+    "plan_slug_provenance": "deterministic-v1";
     "immutable_receipts": true;
     "transactional_outbox": true;
     "idempotent_outbox_delivery": true;
@@ -57,6 +61,87 @@ export interface TaskManifestCapability {
 export interface TaskManifestCapabilityResponse {
     "capability": TaskManifestCapability;
 }
+export interface TaskManifest {
+    "version": 1;
+    "operation_id": string;
+    "step_id": string;
+    "idempotency_key": string;
+    "precondition_digest": string;
+    "project_id": string;
+    "task_list_id"?: string;
+    "if_binding_version"?: number;
+    "plan": {
+        "key": string;
+        "name": string;
+        "description"?: string;
+        "status"?: "active" | "completed" | "archived";
+    };
+    "tasks": Array<{
+        "key": string;
+        "title": string;
+        "description"?: string;
+        "status"?: "pending" | "in_progress" | "completed" | "failed" | "cancelled";
+        "priority"?: "low" | "medium" | "high" | "critical";
+        "assigned_to"?: string;
+        "created_by"?: string;
+        "tags"?: Array<string>;
+        "metadata"?: Record<string, unknown>;
+        "comments"?: Array<Record<string, unknown>>;
+        "verifications"?: Array<Record<string, unknown>>;
+    }>;
+    "dependencies"?: Array<Record<string, unknown>>;
+    "effects"?: Array<Record<string, unknown>>;
+}
+export interface TaskManifestReceipt {
+    "receipt_id": string;
+    "authority": "todos";
+    "route": "todos.task-manifest.v1";
+    "schema_version": 1;
+    "kind": "apply" | "compensate";
+    "operation_id": string;
+    "step_id": string;
+    "idempotency_key": string;
+    "request_digest": string;
+    "precondition_digest": string;
+    "result_digest": string;
+    "outcome": "accepted" | "duplicate_of_accepted" | "terminal_nonacceptance";
+    "reason": string | null;
+    "duplicate_of_receipt_id": string | null;
+    "binding_version": number;
+    "apply_receipt_id": string | null;
+    "created_at": string;
+}
+export interface TaskManifestApplyResult {
+    "duplicate": boolean;
+    "receipt": TaskManifestReceipt;
+    "graph": Record<string, unknown>;
+    "readback": Record<string, unknown>;
+    "outbox_ids": Array<string>;
+    "result_digest": string;
+}
+export interface TaskManifestApplyResponse {
+    "result": TaskManifestApplyResult;
+}
+export interface TaskManifestCompensateRequest {
+    "receipt_id": string;
+    "operation_id": string;
+    "step_id": string;
+    "idempotency_key": string;
+    "precondition_digest": string;
+    "if_binding_version": number;
+}
+export interface TaskManifestCompensationResult {
+    "duplicate": boolean;
+    "receipt": TaskManifestReceipt;
+    "absent": true;
+    "readback": Record<string, unknown>;
+}
+export interface TaskManifestCompensateResponse {
+    "result": TaskManifestCompensationResult;
+}
+export interface TaskManifestReadExactRequest {
+    "receipt_id": string;
+}
 export interface TaskManifestBindingLookupRequest {
     "authority": "todos";
     "route": "todos.task-manifest.v1";
@@ -71,6 +156,8 @@ export interface TaskManifestBindingLookupResult {
     "schema_version": 1;
     "tenant_id": string;
     "plan_id": string;
+    "operation_id": string;
+    "step_id": string;
     "apply_receipt_id": string;
     "binding_version": number;
     "state": "applied" | "compensated";
@@ -78,6 +165,131 @@ export interface TaskManifestBindingLookupResult {
 export interface TaskManifestBindingLookupResponse {
     "result": TaskManifestBindingLookupResult;
 }
+export interface ProjectRegistrationCapability {
+    "authority": "todos";
+    "route": "todos.project-registration.v1";
+    "package_version": string;
+    "authority_id": string;
+    "tenant_id": string;
+    "corpus_id": string;
+    "supported_resources": Array<"project" | "task_list">;
+    "conditional_create": true;
+    "immutable_receipts": true;
+    "exact_terminal_lookup": true;
+    "exact_readback": true;
+    "bind_existing_adoption": true;
+    "prior_registration_adoption_validation": true;
+    "project_resource_enumeration": true;
+    "project_resource_page_limit": number;
+    "conditional_inverse": true;
+    "ambiguous_outcome_reconciliation": true;
+}
+export interface ProjectRegistrationReceipt {
+    "receipt_id": string;
+    "authority": "todos";
+    "route": "todos.project-registration.v1";
+    "package_version": string;
+    "authority_id": string;
+    "tenant_id": string;
+    "corpus_id": string;
+    "operation_id": string;
+    "step_id": string;
+    "resource_kind": "project" | "task_list";
+    "direction": "forward" | "inverse";
+    "idempotency_key": string;
+    "request_digest": string;
+    "precondition_digest": string;
+    "outcome": "accepted" | "duplicate_of_accepted" | "terminal_nonacceptance";
+    "reason": string | null;
+    "target_id": string | null;
+    "result_revision": string | null;
+    "result_digest": string | null;
+    "duplicate_of_receipt_id": string | null;
+    "accepted_receipt_id": string | null;
+    "created_by_operation": boolean;
+    "created_at": string;
+}
+export interface ProjectRegistrationRequest {
+    "operation_id": string;
+    "step_id": string;
+    "resource_kind": "project" | "task_list";
+    "direction": "forward" | "inverse";
+    "authority_route": string;
+    "package_version": string;
+    "authority_id": string;
+    "tenant_id": string;
+    "corpus_id": string;
+    "target_selector": string;
+    "idempotency_key": string;
+    "request_digest": string;
+    "precondition_digest": string;
+    "project_id": string;
+    "project_slug": string;
+    "project_name": string;
+    "desired": Record<string, unknown>;
+    "bind_existing"?: boolean;
+    "accepted_receipt"?: ProjectRegistrationReceipt;
+    "response_byte_limit": number;
+    "time_budget_ms": number;
+}
+export interface ProjectRegistrationLookupRequest {
+    "operation_id": string;
+    "step_id": string;
+    "resource_kind": "project" | "task_list";
+    "direction": "forward" | "inverse";
+    "authority": "todos";
+    "authority_route": string;
+    "package_version": string;
+    "authority_id": string;
+    "tenant_id": string;
+    "corpus_id": string;
+    "target_selector": string;
+    "idempotency_key": string;
+    "target_id"?: string;
+    "max_items": 1;
+    "response_byte_limit": number;
+    "time_budget_ms": number;
+}
+export interface PriorRegistrationAdoptionValidation {
+    "valid": true;
+    "resource_kind": "project" | "task_list";
+    "target_id": string;
+    "source_receipt_id": string;
+    "accepted_receipt_id": string;
+    "source_outcome": "accepted" | "duplicate_of_accepted";
+    "created_at": string;
+    "current_revision": string;
+    "accepted_result_digest": string;
+}
+export interface ProjectResource {
+    "source_project_id": string;
+    "kind": "project" | "task_list" | "plan" | "task";
+    "scope": "collection" | "resource";
+    "target_id": string;
+    "parent_id": string | null;
+    "revision": string;
+    "digest": string;
+}
+export interface ProjectResourcePage {
+    "authority": "todos";
+    "route": "todos.project-registration.v1";
+    "package_version": string;
+    "authority_id": string;
+    "tenant_id": string;
+    "corpus_id": string;
+    "source_project_id": string;
+    "todos_project_id": string;
+    "task_list_id": string;
+    "include_anchors": boolean;
+    "collection_revision": string;
+    "limit": number;
+    "count": number;
+    "resources": Array<ProjectResource>;
+    "has_more": boolean;
+    "next_cursor": string | null;
+    "complete": boolean;
+    "truncated": false;
+}
 export interface TaskList {
     "id"?: string;
     "project_id"?: string | null;
@@ -277,6 +489,7 @@ export interface UpdateTaskInput {
     "priority"?: "low" | "medium" | "high" | "critical";
     "assigned_to"?: string;
     "project_id"?: string | null;
+    "parent_id"?: string | null;
     "plan_id"?: string | null;
     "task_list_id"?: string | null;
     "version"?: number;
@@ -774,6 +987,69 @@ export declare class TodosV1Client {
     appendPrGroupEvent(id: string, body: AppendPrGroupEventInput, init?: RequestInit): Promise<PrGroupMutationResult>;
     /** Fence the prior attempt and create or adopt a recovery generation */
     recoverPrGroup(id: string, body: RecoverPrGroupInput, init?: RequestInit): Promise<PrGroupMutationResult>;
+    /** Read the live package-owned Projects to Todos registration capability */
+    getProjectRegistrationCapability(init?: RequestInit): Promise<{
+        "capability": ProjectRegistrationCapability;
+    }>;
+    /** Conditionally remove an unchanged receipt-owned registration resource */
+    compensateProjectRegistrationResource(body: ProjectRegistrationRequest, init?: RequestInit): Promise<{
+        "receipt": ProjectRegistrationReceipt;
+    }>;
+    /** Create or deterministically bind one Projects to Todos resource */
+    createProjectRegistrationResource(body: ProjectRegistrationRequest, init?: RequestInit): Promise<{
+        "receipt": ProjectRegistrationReceipt;
+    }>;
+    /** Read one registered project or task list by exact full UUID */
+    readExactProjectRegistrationResource(body: {
+        "resource_kind": "project" | "task_list";
+        "target_id": string;
+        "response_byte_limit": number;
+        "time_budget_ms": number;
+    }, init?: RequestInit): Promise<{
+        "record": {
+            "target_id": string;
+            "revision": string;
+            "digest": string;
+        };
+    }>;
+    /** Recover one exact immutable terminal registration receipt */
+    lookupProjectRegistrationReceipt(body: ProjectRegistrationLookupRequest, init?: RequestInit): Promise<{
+        "receipt": ProjectRegistrationReceipt;
+        "response_control": {
+            "response_byte_limit": number;
+            "time_budget_ms": number;
+            "response_bytes": number;
+            "elapsed_ms": number;
+            "complete": true;
+            "truncated": false;
+        };
+    }>;
+    /** List one bounded page of stable Todos identities for an exact Projects workspace id */
+    listProjectRegistrationResources(query?: {
+        "source_project_id": string;
+        "include_anchors"?: boolean;
+        "limit"?: number;
+        "cursor"?: string;
+    }, init?: RequestInit): Promise<{
+        "page": ProjectResourcePage;
+    }>;
+    /** Fail closed unless one prior accepted registration still matches its exact current resource */
+    validatePriorRegistrationAdoption(body: {
+        "source_request": ProjectRegistrationRequest;
+        "source_receipt": ProjectRegistrationReceipt;
+        "current_record": Project | TaskList;
+    }, init?: RequestInit): Promise<{
+        "validation": PriorRegistrationAdoptionValidation;
+    }>;
+    /** Verify exact absence after conditional registration compensation */
+    verifyInverseProjectRegistrationResource(body: ProjectRegistrationRequest, init?: RequestInit): Promise<{
+        "verification": {
+            "target_id": string;
+            "accepted_receipt_id": string;
+            "absent": true;
+            "digest": string;
+        };
+    }>;
     /** List projects */
     listProjects(init?: RequestInit): Promise<{
         "projects"?: Array<Project>;
@@ -841,10 +1117,16 @@ export declare class TodosV1Client {
     updateTaskList(id: string, body: UpdateTaskListInput, init?: RequestInit): Promise<{
         "task_list"?: TaskList;
     }>;
+    /** Apply one exact task-manifest graph through the Todos authority */
+    applyTaskManifest(body: TaskManifest, init?: RequestInit): Promise<TaskManifestApplyResponse>;
     /** Recover one exact task-manifest apply receipt from its managed plan id */
     lookupTaskManifestBinding(body: TaskManifestBindingLookupRequest, init?: RequestInit): Promise<TaskManifestBindingLookupResponse>;
     /** Read the current task-manifest authority capability and tenant */
     getTaskManifestCapability(init?: RequestInit): Promise<TaskManifestCapabilityResponse>;
+    /** Compensate one exact untouched task-manifest graph with CAS protection */
+    compensateTaskManifest(body: TaskManifestCompensateRequest, init?: RequestInit): Promise<TaskManifestCompensateResponse>;
+    /** Read one exact immutable task-manifest apply receipt */
+    readExactTaskManifest(body: TaskManifestReadExactRequest, init?: RequestInit): Promise<TaskManifestApplyResponse>;
     /** List tasks */
     listTasks(query?: {
         "status"?: "pending" | "in_progress" | "completed" | "failed" | "cancelled" | Array<"pending" | "in_progress" | "completed" | "failed" | "cancelled">;